# takashiidobe/slate architecture

> Architecture diagram of the GitHub repository takashiidobe/slate, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/takashiidobe/slate
- Repository: https://github.com/takashiidobe/slate

## Overview

Slate is a C23-to-Rust transpiler. Its principal workflow takes compiler arguments and a C translation unit, preprocesses and parses the source, produces typed IR, lowers that representation to Rust, then applies Rust refinement passes and emits formatted output. Separate capabilities include target sysroot management and project translation from compilation databases. The README documents the end-to-end workflow; source excerpts are partial, so internal links not directly established by those excerpts are marked unverified or omitted.

Main entry points: [`crates/slate/src/main.rs`](https://github.com/takashiidobe/slate/blob/main/crates/slate/src/main.rs) (Slate CLI), [`crates/slate-parser/src/pp/mod.rs`](https://github.com/takashiidobe/slate/blob/main/crates/slate-parser/src/pp/mod.rs) (Preprocessor), [`crates/slate-sysroots/src/lib.rs`](https://github.com/takashiidobe/slate/blob/main/crates/slate-sysroots/src/lib.rs) (Sysroot Manager), [`crates/slate-parser/src/compiler_args.rs`](https://github.com/takashiidobe/slate/blob/main/crates/slate-parser/src/compiler_args.rs) (Compiler Arguments)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_parse["C Frontend"]
  node_compiler_args["Compiler Arguments<br/>[compiler_args.rs]"]
  node_dialect["C Dialect<br/>[dialect.rs]"]
  node_lexer["C Lexer<br/>[lexer.rs]"]
  node_preprocessor["Preprocessor<br/>[mod.rs]"]
  node_ast["C Syntax Tree<br/>[ast.rs]"]
  node_constants["Constant Expressions<br/>[const_expr.rs]"]
  node_typed_ir["Typed Parser IR<br/>[mod.rs]"]
  node_semantics["Semantic Analysis<br/>[mod.rs]"]
end

subgraph group_target["Targets And Headers"]
  node_targets["Target Configuration<br/>[target_info.rs]"]
  node_isa["ISA Support<br/>[x86_isa.rs]"]
  node_sysroot_cli["Sysroot Commands<br/>[sysroot.rs]"]
  node_sysroot_manager["Sysroot Manager<br/>[lib.rs]"]
  node_header_sets["Compiler Headers"]
  node_download["Header Downloads<br/>[download.rs]"]
end

subgraph group_translate["Rust Translation"]
  node_cli["Slate CLI<br/>[main.rs]"]
  node_compile_commands["Project Commands"]
  node_lowerer["Rust Lowering<br/>[lowerer.rs]"]
  node_rust_ast["Rust AST<br/>[rust_ast.rs]"]
  node_codegen["Rust Code Generation<br/>[codegen.rs]"]
  node_rust_output["Rust Output<br/>[format.rs]"]
end

subgraph group_refine["Rust Refinement"]
  node_rewrite_engine["Rewrite Passes<br/>[mod.rs]"]
  node_interproc["Interprocedural Analysis<br/>[length_lattice.rs]"]
end

node_developer(("C Project Developer"))
node_compile_db["Compilation Database"]
node_sysroot_service(("Header Sources"))

node_developer -->|"runs translation"| node_cli
node_compile_db -->|"provides commands"| node_cli
node_cli -.->|"translates project"| node_compile_commands
node_cli -.->|"passes compiler args"| node_compiler_args
node_compiler_args -->|"configures language"| node_dialect
node_compiler_args -->|"configures target"| node_targets
node_cli -->|"uses built-in frontend"| node_preprocessor
node_preprocessor -->|"expands tokens"| node_lexer
node_preprocessor -->|"prepares C input"| node_ast
node_ast -->|"uses expressions"| node_constants
node_ast -.->|"lowers to IR"| node_typed_ir
node_typed_ir -.->|"analyzes types"| node_semantics
node_targets -.->|"selects ISA"| node_isa
node_sysroot_cli -->|"installs target"| node_sysroot_manager
node_sysroot_manager -->|"resolves headers"| node_header_sets
node_sysroot_manager -->|"uses downloads"| node_download
node_sysroot_service -.->|"supplies headers"| node_download
node_preprocessor -.->|"reads include paths"| node_sysroot_manager
node_typed_ir -->|"lowers to Rust"| node_lowerer
node_lowerer -.->|"builds Rust AST"| node_rust_ast
node_rust_ast -->|"generates Rust"| node_codegen
node_codegen -.->|"refines output"| node_rewrite_engine
node_rewrite_engine -.->|"runs analyses"| node_interproc
node_rewrite_engine -->|"formats Rust"| node_rust_output
node_codegen -.->|"emits Rust"| node_rust_output

click node_cli "https://github.com/takashiidobe/slate/blob/main/crates/slate/src/main.rs"
click node_compile_commands "https://github.com/takashiidobe/slate/blob/main/crates/slate/src/compile_commands.rs"
click node_compiler_args "https://github.com/takashiidobe/slate/blob/main/crates/slate-parser/src/compiler_args.rs"
click node_dialect "https://github.com/takashiidobe/slate/blob/main/crates/slate-parser/src/dialect.rs"
click node_lexer "https://github.com/takashiidobe/slate/blob/main/crates/slate-parser/src/lexer.rs"
click node_preprocessor "https://github.com/takashiidobe/slate/blob/main/crates/slate-parser/src/pp/mod.rs"
click node_ast "https://github.com/takashiidobe/slate/blob/main/crates/slate-parser/src/ast.rs"
click node_constants "https://github.com/takashiidobe/slate/blob/main/crates/slate-parser/src/const_expr.rs"
click node_typed_ir "https://github.com/takashiidobe/slate/blob/main/crates/slate-parser/src/ir/mod.rs"
click node_semantics "https://github.com/takashiidobe/slate/blob/main/crates/slate-parser/src/sema/ctype/mod.rs"
click node_targets "https://github.com/takashiidobe/slate/blob/main/crates/slate-parser/src/target_info.rs"
click node_isa "https://github.com/takashiidobe/slate/blob/main/crates/slate-parser/src/target/x86_isa.rs"
click node_sysroot_cli "https://github.com/takashiidobe/slate/blob/main/crates/slate/src/sysroot.rs"
click node_sysroot_manager "https://github.com/takashiidobe/slate/blob/main/crates/slate-sysroots/src/lib.rs"
click node_header_sets "https://github.com/takashiidobe/slate/blob/main/crates/slate-sysroots/src/compiler_headers.rs"
click node_download "https://github.com/takashiidobe/slate/blob/main/crates/slate-sysroots/src/download.rs"
click node_lowerer "https://github.com/takashiidobe/slate/blob/main/crates/slate/src/frontend/lowerer.rs"
click node_rust_ast "https://github.com/takashiidobe/slate/blob/main/crates/slate/src/backend/rust_ast.rs"
click node_codegen "https://github.com/takashiidobe/slate/blob/main/crates/slate/src/backend/codegen.rs"
click node_rewrite_engine "https://github.com/takashiidobe/slate/blob/main/crates/slate/src/backend/engine/mod.rs"
click node_interproc "https://github.com/takashiidobe/slate/blob/main/crates/slate/src/backend/interproc/length_lattice.rs"
click node_rust_output "https://github.com/takashiidobe/slate/blob/main/crates/slate/src/backend/format.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_compiler_args,node_dialect,node_lexer,node_preprocessor,node_ast,node_constants,node_typed_ir,node_semantics toneBlue
class node_targets,node_isa,node_sysroot_cli,node_sysroot_manager,node_header_sets,node_download,node_compile_db toneAmber
class node_cli,node_compile_commands,node_lowerer,node_rust_ast,node_codegen,node_rust_output toneMint
class node_rewrite_engine,node_interproc toneRose
class node_developer,node_sysroot_service toneIndigo
```

## Components

### C Frontend

- [Compiler Arguments](https://github.com/takashiidobe/slate/blob/main/crates/slate-parser/src/compiler_args.rs): `crates/slate-parser/src/compiler_args.rs`
- [C Dialect](https://github.com/takashiidobe/slate/blob/main/crates/slate-parser/src/dialect.rs): `crates/slate-parser/src/dialect.rs`
- [C Lexer](https://github.com/takashiidobe/slate/blob/main/crates/slate-parser/src/lexer.rs): `crates/slate-parser/src/lexer.rs`
- [Preprocessor](https://github.com/takashiidobe/slate/blob/main/crates/slate-parser/src/pp/mod.rs): `crates/slate-parser/src/pp/mod.rs`
- [C Syntax Tree](https://github.com/takashiidobe/slate/blob/main/crates/slate-parser/src/ast.rs): `crates/slate-parser/src/ast.rs`
- [Constant Expressions](https://github.com/takashiidobe/slate/blob/main/crates/slate-parser/src/const_expr.rs): `crates/slate-parser/src/const_expr.rs`
- [Typed Parser IR](https://github.com/takashiidobe/slate/blob/main/crates/slate-parser/src/ir/mod.rs): `crates/slate-parser/src/ir/mod.rs`
- [Semantic Analysis](https://github.com/takashiidobe/slate/blob/main/crates/slate-parser/src/sema/ctype/mod.rs): `crates/slate-parser/src/sema/ctype/mod.rs`

### Targets And Headers

- [Target Configuration](https://github.com/takashiidobe/slate/blob/main/crates/slate-parser/src/target_info.rs): `crates/slate-parser/src/target_info.rs`
- [ISA Support](https://github.com/takashiidobe/slate/blob/main/crates/slate-parser/src/target/x86_isa.rs): `crates/slate-parser/src/target/x86_isa.rs`
- [Sysroot Commands](https://github.com/takashiidobe/slate/blob/main/crates/slate/src/sysroot.rs): `crates/slate/src/sysroot.rs`
- [Sysroot Manager](https://github.com/takashiidobe/slate/blob/main/crates/slate-sysroots/src/lib.rs): `crates/slate-sysroots/src/lib.rs`
- [Compiler Headers](https://github.com/takashiidobe/slate/blob/main/crates/slate-sysroots/src/compiler_headers.rs): `crates/slate-sysroots/src/compiler_headers.rs`
- [Header Downloads](https://github.com/takashiidobe/slate/blob/main/crates/slate-sysroots/src/download.rs): `crates/slate-sysroots/src/download.rs`

### Rust Translation

- [Slate CLI](https://github.com/takashiidobe/slate/blob/main/crates/slate/src/main.rs): `crates/slate/src/main.rs`
- [Project Commands](https://github.com/takashiidobe/slate/blob/main/crates/slate/src/compile_commands.rs): `crates/slate/src/compile_commands.rs`
- [Rust Lowering](https://github.com/takashiidobe/slate/blob/main/crates/slate/src/frontend/lowerer.rs): `crates/slate/src/frontend/lowerer.rs`
- [Rust AST](https://github.com/takashiidobe/slate/blob/main/crates/slate/src/backend/rust_ast.rs): `crates/slate/src/backend/rust_ast.rs`
- [Rust Code Generation](https://github.com/takashiidobe/slate/blob/main/crates/slate/src/backend/codegen.rs): `crates/slate/src/backend/codegen.rs`
- [Rust Output](https://github.com/takashiidobe/slate/blob/main/crates/slate/src/backend/format.rs): `crates/slate/src/backend/format.rs`

### Rust Refinement

- [Rewrite Passes](https://github.com/takashiidobe/slate/blob/main/crates/slate/src/backend/engine/mod.rs): `crates/slate/src/backend/engine/mod.rs`
- [Interprocedural Analysis](https://github.com/takashiidobe/slate/blob/main/crates/slate/src/backend/interproc/length_lattice.rs): `crates/slate/src/backend/interproc/length_lattice.rs`

### Other components

- **C Project Developer**
- **Compilation Database**
- **Header Sources**

## Connections

- C Project Developer → Slate CLI: runs translation (evidence: `README.md`)
- Compilation Database → Slate CLI: provides commands (evidence: `README.md`)
- Slate CLI → Project Commands: translates project
- Slate CLI → Compiler Arguments: passes compiler args
- Compiler Arguments → C Dialect: configures language (evidence: `crates/slate-parser/src/dialect.rs`)
- Compiler Arguments → Target Configuration: configures target (evidence: `crates/slate-parser/src/compiler_args.rs`)
- Slate CLI → Preprocessor: uses built-in frontend (evidence: `README.md`)
- Preprocessor → C Lexer: expands tokens (evidence: `crates/slate-parser/src/pp/mod.rs`)
- Preprocessor → C Syntax Tree: prepares C input (evidence: `crates/slate-parser/src/pp/mod.rs`)
- C Syntax Tree → Constant Expressions: uses expressions (evidence: `crates/slate-parser/src/ast.rs`)
- C Syntax Tree → Typed Parser IR: lowers to IR (evidence: `crates/slate-parser/src/ir/mod.rs`)
- Typed Parser IR → Semantic Analysis: analyzes types
- Target Configuration → ISA Support: selects ISA
- Sysroot Commands → Sysroot Manager: installs target
- Sysroot Manager → Compiler Headers: resolves headers (evidence: `crates/slate-sysroots/src/lib.rs`)
- Sysroot Manager → Header Downloads: uses downloads (evidence: `crates/slate-sysroots/src/lib.rs`)
- Header Sources → Header Downloads: supplies headers
- Preprocessor → Sysroot Manager: reads include paths
- Typed Parser IR → Rust Lowering: lowers to Rust (evidence: `README.md`)
- Rust Lowering → Rust AST: builds Rust AST
- Rust AST → Rust Code Generation: generates Rust (evidence: `crates/slate/src/backend/rust_ast.rs`)
- Rust Code Generation → Rewrite Passes: refines output
- Rewrite Passes → Interprocedural Analysis: runs analyses
- Rewrite Passes → Rust Output: formats Rust (evidence: `README.md`)
- Rust Code Generation → Rust Output: emits Rust
