# alexkowalenko/axc architecture

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

- Interactive diagram: https://gitdiagram.com/alexkowalenko/axc
- Repository: https://github.com/alexkowalenko/axc

## Overview

AXC is a C compiler whose CLI can stop after lexing, parsing, semantic validation, TAC generation, or code generation. The main workflow turns source text into tokens, an AST, semantically checked program state, TAC, then target assembly and an output file. The README documents x86-64 support through functions and file-scope variables, while AArch64 support is more limited. The graph follows relationships visible in the CLI excerpt, source index, and README; unsampled implementation details are not inferred.

Main entry points: [`cmd/main.cpp`](https://github.com/alexkowalenko/axc/blob/main/cmd/main.cpp) (CLI driver), [`src/codeGen.h`](https://github.com/alexkowalenko/axc/blob/main/src/codeGen.h) (Codegen interface), [`src/machine/x86_64/x86_64CodeGen.cpp`](https://github.com/alexkowalenko/axc/blob/main/src/machine/x86_64/x86_64CodeGen.cpp) (x86-64 codegen), [`src/machine/arm64/arm64CodeGen.cpp`](https://github.com/alexkowalenko/axc/blob/main/src/machine/arm64/arm64CodeGen.cpp) (AArch64 codegen)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_front["Front end"]
  node_cli["CLI driver<br/>[main.cpp]"]
  node_lexer["Lexer<br/>[lexer.cpp]"]
  node_tokens["Tokens<br/>[token.h]"]
  node_parser["Parser<br/>[parser.cpp]"]
  node_ast["AST<br/>[base.h]"]
  node_semantic["Semantic analysis"]
  node_symbols["Symbol table<br/>[symbolTable.cpp]"]
  node_astprint["AST printer<br/>[printerAST.cpp]"]
end

subgraph group_middle["Intermediate representation"]
  node_tacgen["TAC generation<br/>[tacGen.cpp]"]
  node_tac["TAC<br/>[base.h]"]
  node_tacprint["TAC printer<br/>[printerTAC.cpp]"]
  node_codegen["Codegen interface<br/>[codeGen.h]"]
end

subgraph group_x86["x86-64 backend"]
  node_x86driver["x86-64 codegen<br/>[x86_64CodeGen.cpp]"]
  node_x86asmgen["x86 assembly generation<br/>[assemblyGen.cpp]"]
  node_x86passes["Pseudo and fix passes<br/>[fixInstructX86.cpp]"]
  node_x86print["x86 assembly output<br/>[printerX86.cpp]"]
end

subgraph group_arm["AArch64 backend"]
  node_armdriver["AArch64 codegen<br/>[arm64CodeGen.cpp]"]
  node_armasmgen["ARM assembly generation<br/>[armAssemblyGen.cpp]"]
  node_armfilters["ARM pseudo pass"]
  node_armprint["ARM assembly output<br/>[printerARM64.cpp]"]
end

node_user(("Compiler user"))
node_output["Assembly file"]

node_user -->|"invokes"| node_cli
node_cli -->|"starts"| node_lexer
node_lexer -->|"produces"| node_tokens
node_cli -->|"runs"| node_parser
node_parser -->|"reads tokens"| node_lexer
node_parser -->|"builds"| node_ast
node_cli -->|"runs"| node_semantic
node_cli -->|"uses"| node_symbols
node_cli -->|"prints AST"| node_astprint
node_cli -->|"runs"| node_tacgen
node_tacgen -->|"produces"| node_tac
node_cli -->|"prints TAC"| node_tacprint
node_cli -->|"selects backend"| node_codegen
node_codegen -->|"consumes"| node_tac
node_codegen -->|"creates"| node_x86driver
node_x86driver -->|"generates instructions"| node_x86asmgen
node_x86driver -->|"runs passes"| node_x86passes
node_x86driver -->|"prints assembly"| node_x86print
node_cli -->|"writes file"| node_output
node_codegen -->|"creates"| node_armdriver
node_armdriver -->|"generates assembly"| node_armasmgen
node_armdriver -->|"runs pseudo pass"| node_armfilters
node_armdriver -->|"prints assembly"| node_armprint

click node_cli "https://github.com/alexkowalenko/axc/blob/main/cmd/main.cpp"
click node_lexer "https://github.com/alexkowalenko/axc/blob/main/src/lexer.cpp"
click node_tokens "https://github.com/alexkowalenko/axc/blob/main/src/token.h"
click node_parser "https://github.com/alexkowalenko/axc/blob/main/src/parser.cpp"
click node_ast "https://github.com/alexkowalenko/axc/blob/main/src/ast/base.h"
click node_semantic "https://github.com/alexkowalenko/axc/blob/main/src/semanticAnalyser.cpp"
click node_symbols "https://github.com/alexkowalenko/axc/blob/main/src/symbolTable.cpp"
click node_astprint "https://github.com/alexkowalenko/axc/blob/main/src/printerAST.cpp"
click node_tacgen "https://github.com/alexkowalenko/axc/blob/main/src/tacGen.cpp"
click node_tac "https://github.com/alexkowalenko/axc/blob/main/src/tac/base.h"
click node_tacprint "https://github.com/alexkowalenko/axc/blob/main/src/printerTAC.cpp"
click node_codegen "https://github.com/alexkowalenko/axc/blob/main/src/codeGen.h"
click node_x86driver "https://github.com/alexkowalenko/axc/blob/main/src/machine/x86_64/x86_64CodeGen.cpp"
click node_x86asmgen "https://github.com/alexkowalenko/axc/blob/main/src/machine/x86_64/assemblyGen.cpp"
click node_x86passes "https://github.com/alexkowalenko/axc/blob/main/src/machine/x86_64/fixInstructX86.cpp"
click node_x86print "https://github.com/alexkowalenko/axc/blob/main/src/machine/x86_64/printerX86.cpp"
click node_armdriver "https://github.com/alexkowalenko/axc/blob/main/src/machine/arm64/arm64CodeGen.cpp"
click node_armasmgen "https://github.com/alexkowalenko/axc/blob/main/src/machine/arm64/armAssemblyGen.cpp"
click node_armfilters "https://github.com/alexkowalenko/axc/blob/main/src/machine/arm64/filterPseudoARM.cpp"
click node_armprint "https://github.com/alexkowalenko/axc/blob/main/src/machine/arm64/printerARM64.cpp"

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_cli,node_lexer,node_tokens,node_parser,node_ast,node_semantic,node_symbols,node_astprint,node_user toneBlue
class node_tacgen,node_tac,node_tacprint,node_codegen toneAmber
class node_x86driver,node_x86asmgen,node_x86passes,node_x86print toneMint
class node_armdriver,node_armasmgen,node_armfilters,node_armprint toneRose
class node_output toneIndigo
```

## Components

### Front end

- [CLI driver](https://github.com/alexkowalenko/axc/blob/main/cmd/main.cpp): `cmd/main.cpp`
- [Lexer](https://github.com/alexkowalenko/axc/blob/main/src/lexer.cpp): `src/lexer.cpp`
- [Tokens](https://github.com/alexkowalenko/axc/blob/main/src/token.h): `src/token.h`
- [Parser](https://github.com/alexkowalenko/axc/blob/main/src/parser.cpp): `src/parser.cpp`
- [AST](https://github.com/alexkowalenko/axc/blob/main/src/ast/base.h): `src/ast/base.h`
- [Semantic analysis](https://github.com/alexkowalenko/axc/blob/main/src/semanticAnalyser.cpp): `src/semanticAnalyser.cpp`
- [Symbol table](https://github.com/alexkowalenko/axc/blob/main/src/symbolTable.cpp): `src/symbolTable.cpp`
- [AST printer](https://github.com/alexkowalenko/axc/blob/main/src/printerAST.cpp): `src/printerAST.cpp`

### Intermediate representation

- [TAC generation](https://github.com/alexkowalenko/axc/blob/main/src/tacGen.cpp): `src/tacGen.cpp`
- [TAC](https://github.com/alexkowalenko/axc/blob/main/src/tac/base.h): `src/tac/base.h`
- [TAC printer](https://github.com/alexkowalenko/axc/blob/main/src/printerTAC.cpp): `src/printerTAC.cpp`
- [Codegen interface](https://github.com/alexkowalenko/axc/blob/main/src/codeGen.h): `src/codeGen.h`

### x86-64 backend

- [x86-64 codegen](https://github.com/alexkowalenko/axc/blob/main/src/machine/x86_64/x86_64CodeGen.cpp): `src/machine/x86_64/x86_64CodeGen.cpp`
- [x86 assembly generation](https://github.com/alexkowalenko/axc/blob/main/src/machine/x86_64/assemblyGen.cpp): `src/machine/x86_64/assemblyGen.cpp`
- [Pseudo and fix passes](https://github.com/alexkowalenko/axc/blob/main/src/machine/x86_64/fixInstructX86.cpp): `src/machine/x86_64/fixInstructX86.cpp`
- [x86 assembly output](https://github.com/alexkowalenko/axc/blob/main/src/machine/x86_64/printerX86.cpp): `src/machine/x86_64/printerX86.cpp`

### AArch64 backend

- [AArch64 codegen](https://github.com/alexkowalenko/axc/blob/main/src/machine/arm64/arm64CodeGen.cpp): `src/machine/arm64/arm64CodeGen.cpp`
- [ARM assembly generation](https://github.com/alexkowalenko/axc/blob/main/src/machine/arm64/armAssemblyGen.cpp): `src/machine/arm64/armAssemblyGen.cpp`
- [ARM pseudo pass](https://github.com/alexkowalenko/axc/blob/main/src/machine/arm64/filterPseudoARM.cpp): `src/machine/arm64/filterPseudoARM.cpp`
- [ARM assembly output](https://github.com/alexkowalenko/axc/blob/main/src/machine/arm64/printerARM64.cpp): `src/machine/arm64/printerARM64.cpp`

### Other components

- **Compiler user**
- **Assembly file**

## Connections

- Compiler user → CLI driver: invokes (evidence: `cmd/main.cpp`)
- CLI driver → Lexer: starts (evidence: `cmd/main.cpp`)
- Lexer → Tokens: produces (evidence: `src/lexer.cpp`)
- CLI driver → Parser: runs (evidence: `cmd/main.cpp`)
- Parser → Lexer: reads tokens (evidence: `src/parser.cpp`)
- Parser → AST: builds (evidence: `src/parser.cpp`)
- CLI driver → Semantic analysis: runs (evidence: `cmd/main.cpp`)
- CLI driver → Symbol table: uses (evidence: `cmd/main.cpp`)
- CLI driver → AST printer: prints AST (evidence: `cmd/main.cpp`)
- CLI driver → TAC generation: runs (evidence: `cmd/main.cpp`)
- TAC generation → TAC: produces (evidence: `src/tacGen.cpp`)
- CLI driver → TAC printer: prints TAC (evidence: `cmd/main.cpp`)
- CLI driver → Codegen interface: selects backend (evidence: `cmd/main.cpp`)
- Codegen interface → TAC: consumes (evidence: `src/codeGen.h`)
- Codegen interface → x86-64 codegen: creates (evidence: `src/codeGen.h`)
- x86-64 codegen → x86 assembly generation: generates instructions (evidence: `src/machine/x86_64/x86_64CodeGen.cpp`)
- x86-64 codegen → Pseudo and fix passes: runs passes (evidence: `src/machine/x86_64/x86_64CodeGen.cpp`)
- x86-64 codegen → x86 assembly output: prints assembly (evidence: `src/machine/x86_64/x86_64CodeGen.cpp`)
- CLI driver → Assembly file: writes file (evidence: `cmd/main.cpp`)
- Codegen interface → AArch64 codegen: creates (evidence: `src/codeGen.h`)
- AArch64 codegen → ARM assembly generation: generates assembly (evidence: `src/machine/arm64/arm64CodeGen.cpp`)
- AArch64 codegen → ARM pseudo pass: runs pseudo pass (evidence: `src/machine/arm64/arm64CodeGen.cpp`)
- AArch64 codegen → ARM assembly output: prints assembly (evidence: `src/machine/arm64/arm64CodeGen.cpp`)
