# Docs


- **Introduction**
- [Get Started](/docs): This guide will walk you through installing the Mist CLI, setting up your development environment, and compiling your very first program.
- [Philosophy](/docs/philosophy): The mindset, ergonomics, and feeling of writing Mist.
- [Status & Limitations](/docs/limitations): Understanding the Alpha state of Mist and our technical roadmap.

- **Language Guide**
- [Syntax Overview](/docs/guide/syntax-overview): Comments, literals, identifiers, and keywords in Mist.
- [Variables](/docs/guide/variables): Variable declarations, mutability, type annotations, and destructuring.
- [Types](/docs/guide/types): The Mist type system including references, pointers, tuples, function types, and trait objects.
- [Functions](/docs/guide/functions): Function declarations, self parameters, return types, and unsafe functions.
- [Control Flow](/docs/guide/control-flow): If/else, while, for, c-style for, loop, match, break, continue, and return.
- [Structs & Enums](/docs/guide/structs-enums): Defining structs and enums with named, tuple, and struct variants.
- [Classes](/docs/guide/classes): Class declarations, constructors, inheritance, virtual dispatch, and the override keyword.
- [Traits & Impls](/docs/guide/traits-impls): Defining traits, trait bounds, and implementation blocks.
- [Generics](/docs/guide/generics): Generic functions, structs, enums, trait bounds, and lifetimes.
- [Modules & Imports](/docs/guide/modules): Module declarations, imports, re-exports, include directives, and module resolution rules.
- [Patterns](/docs/guide/patterns): Pattern matching with literals, tuples, structs, named tuples, wildcards, and mutable bindings.
- [Operators, Macros & Closures](/docs/guide/operators): Binary, prefix, and postfix operators, macro calls, and closure expressions.
- [Attributes](/docs/guide/attributes): Inner and outer attributes for modules, items, and metadata.

- **Compiler Internals**
- [Parsing](/docs/internals/parsing): PEG grammar structure, AST design, and how Mist source code is parsed.
- [Semantic Analysis](/docs/internals/semantic-analysis): Class field initialization verification and the GetMutability analysis system.
- [Class Internals](/docs/internals/classes): How classes are compiled under the hood — vtable layout, code generation, and safety verification.
- [Code Generation](/docs/internals/codegen): How the Mist AST is translated into Rust source code, including class vtables and position mapping.
- [Transpilation Pipeline](/docs/internals/transpiler): How Mist source files are discovered, transpiled to Rust, and cached.
- [Builder & Error Remapping](/docs/internals/builder): How Mist invokes cargo and remaps Rust compiler errors back to Mist source locations.
- [LSP Support](/docs/internals/lsp): How the Mist Language Server bridges editor requests through rust-analyzer.
- [Position Mapping](/docs/internals/position-mapping): Bidirectional mapping between Mist source positions and Rust output positions for error remapping and LSP features.