# leuat/tripe architecture

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

- Interactive diagram: https://gitdiagram.com/leuat/tripe
- Repository: https://github.com/leuat/tripe

## Overview

Tripe is an intermediate-language compiler and optimizer for retro-computing targets, currently focused on 6502 output. A compiler or user supplies Tripe assembly; the runtime optimizes it, encodes it as a .trp binary, translates that binary into target assembly, then applies native-assembly optimization. The parser dispatches decoding to the selected CPU backend, while shared opcode handling and 6502 code generation provide the internal execution layer. The README documents the staged workflow and TRSE integration; unsampled implementation details are represented only where the index or documentation supports them.

Main entry points: [`src/parser.cpp`](https://github.com/leuat/tripe/blob/main/src/parser.cpp) (Parser), [`src/cpu6502.cpp`](https://github.com/leuat/tripe/blob/main/src/cpu6502.cpp) (6502 generator), [`src/abstractcpu.cpp`](https://github.com/leuat/tripe/blob/main/src/abstractcpu.cpp) (CPU abstraction), [`src/opts/phopt6502.cpp`](https://github.com/leuat/tripe/blob/main/src/opts/phopt6502.cpp) (6502 optimizer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Compiler workflow"]
  node_tripe["Tripe CLI<br/>[main.cpp]"]
  node_pipeline["Pipeline API<br/>[tripe.cpp]"]
end

subgraph group_encoding["Intermediate encoding"]
  node_parser["Parser<br/>[parser.cpp]"]
  node_opcode_codec["Opcode codec<br/>[opcodes.cpp]"]
  node_opcode_table["Opcode definitions<br/>[opcodes_data.h]"]
  node_util["File and data utilities<br/>[util.cpp]"]
end

subgraph group_backend["6502 backend"]
  node_cpu_base["CPU abstraction<br/>[abstractcpu.cpp]"]
  node_cpu6502["6502 generator<br/>[cpu6502.cpp]"]
  node_cpu_resources["6502 arithmetic routines"]
end

subgraph group_optimization["Optimization"]
  node_tripe_optimizer["IR optimizer<br/>[tropt.cpp]"]
  node_native_optimizer["6502 optimizer<br/>[phopt6502.cpp]"]
  node_optimizer_base["Optimizer base<br/>[phopt.h]"]
end

node_compiler(("Compiler / TRSE"))
node_tripe_input["Tripe assembly input"]
node_binary_output[".trp binary"]
node_assembly_output["6502 assembly"]

node_compiler -->|"produces"| node_tripe_input
node_tripe_input -->|"submits"| node_tripe
node_tripe -->|"invokes"| node_pipeline
node_pipeline -->|"uses"| node_parser
node_parser -->|"reads files"| node_util
node_parser -->|"optimizes IR"| node_tripe_optimizer
node_parser -->|"encodes text"| node_opcode_codec
node_parser -->|"decodes binary"| node_cpu_base
node_parser -->|"dispatches target"| node_cpu6502
node_parser -->|"optimizes assembly"| node_native_optimizer
node_cpu_base -->|"initializes from"| node_opcode_table
node_cpu6502 -->|"extends"| node_cpu_base
node_cpu6502 -->|"uses routines"| node_cpu_resources
node_native_optimizer -->|"extends"| node_optimizer_base
node_parser -->|"creates"| node_binary_output
node_binary_output -->|"feeds translation"| node_parser
node_parser -->|"emits"| node_assembly_output
node_assembly_output -->|"feeds optimization"| node_native_optimizer

click node_tripe "https://github.com/leuat/tripe/blob/main/src/main.cpp"
click node_pipeline "https://github.com/leuat/tripe/blob/main/src/tripe.cpp"
click node_parser "https://github.com/leuat/tripe/blob/main/src/parser.cpp"
click node_opcode_codec "https://github.com/leuat/tripe/blob/main/src/opcodes.cpp"
click node_opcode_table "https://github.com/leuat/tripe/blob/main/src/resources/opcodes_data.h"
click node_cpu_base "https://github.com/leuat/tripe/blob/main/src/abstractcpu.cpp"
click node_cpu6502 "https://github.com/leuat/tripe/blob/main/src/cpu6502.cpp"
click node_cpu_resources "https://github.com/leuat/tripe/tree/main/src/resources"
click node_tripe_optimizer "https://github.com/leuat/tripe/blob/main/src/opts/tropt.cpp"
click node_native_optimizer "https://github.com/leuat/tripe/blob/main/src/opts/phopt6502.cpp"
click node_optimizer_base "https://github.com/leuat/tripe/blob/main/src/opts/phopt.h"
click node_util "https://github.com/leuat/tripe/blob/main/src/util.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_tripe,node_pipeline toneBlue
class node_parser,node_opcode_codec,node_opcode_table,node_util toneAmber
class node_cpu_base,node_cpu6502,node_cpu_resources toneMint
class node_tripe_optimizer,node_native_optimizer,node_optimizer_base toneRose
class node_compiler,node_tripe_input,node_binary_output,node_assembly_output toneIndigo
```

## Components

### Compiler workflow

- [Tripe CLI](https://github.com/leuat/tripe/blob/main/src/main.cpp): `src/main.cpp`
- [Pipeline API](https://github.com/leuat/tripe/blob/main/src/tripe.cpp): `src/tripe.cpp`

### Intermediate encoding

- [Parser](https://github.com/leuat/tripe/blob/main/src/parser.cpp): `src/parser.cpp`
- [Opcode codec](https://github.com/leuat/tripe/blob/main/src/opcodes.cpp): `src/opcodes.cpp`
- [Opcode definitions](https://github.com/leuat/tripe/blob/main/src/resources/opcodes_data.h): `src/resources/opcodes_data.h`
- [File and data utilities](https://github.com/leuat/tripe/blob/main/src/util.cpp): `src/util.cpp`

### 6502 backend

- [CPU abstraction](https://github.com/leuat/tripe/blob/main/src/abstractcpu.cpp): `src/abstractcpu.cpp`
- [6502 generator](https://github.com/leuat/tripe/blob/main/src/cpu6502.cpp): `src/cpu6502.cpp`
- [6502 arithmetic routines](https://github.com/leuat/tripe/tree/main/src/resources): `src/resources`

### Optimization

- [IR optimizer](https://github.com/leuat/tripe/blob/main/src/opts/tropt.cpp): `src/opts/tropt.cpp`
- [6502 optimizer](https://github.com/leuat/tripe/blob/main/src/opts/phopt6502.cpp): `src/opts/phopt6502.cpp`
- [Optimizer base](https://github.com/leuat/tripe/blob/main/src/opts/phopt.h): `src/opts/phopt.h`

### Other components

- **Compiler / TRSE**
- **Tripe assembly input**
- **.trp binary**
- **6502 assembly**

## Connections

- Compiler / TRSE → Tripe assembly input: produces (evidence: `README.md`)
- Tripe assembly input → Tripe CLI: submits (evidence: `README.md`)
- Tripe CLI → Pipeline API: invokes (evidence: `src/main.cpp`)
- Pipeline API → Parser: uses (evidence: `src/tripe.cpp`)
- Parser → File and data utilities: reads files (evidence: `src/parser.cpp`)
- Parser → IR optimizer: optimizes IR (evidence: `src/parser.cpp`)
- Parser → Opcode codec: encodes text (evidence: `src/parser.cpp`)
- Parser → CPU abstraction: decodes binary (evidence: `src/parser.cpp`)
- Parser → 6502 generator: dispatches target (evidence: `src/parser.cpp`)
- Parser → 6502 optimizer: optimizes assembly (evidence: `src/parser.cpp`)
- CPU abstraction → Opcode definitions: initializes from (evidence: `src/abstractcpu.cpp`)
- 6502 generator → CPU abstraction: extends
- 6502 generator → 6502 arithmetic routines: uses routines (evidence: `src/cpu6502.cpp`)
- 6502 optimizer → Optimizer base: extends
- Parser → .trp binary: creates (evidence: `README.md`)
- .trp binary → Parser: feeds translation (evidence: `README.md`)
- Parser → 6502 assembly: emits (evidence: `README.md`)
- 6502 assembly → 6502 optimizer: feeds optimization (evidence: `README.md`)
