# metedinler/uxbasic architecture

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

- Interactive diagram: https://gitdiagram.com/metedinler/uxbasic
- Repository: https://github.com/metedinler/uxbasic

## Overview

The README describes a Python runner that executes 45 modular test sources through three output lanes: JSON/log, x64, and web. The JSON/log lane covers tokens, preprocessing, AST, semantics, MIR, and interpreter output; the other lanes produce native and browser artifacts. The runner and its referenced test and report paths do not appear in the supplied tree, so those components have no source path. Relationships shown below reflect README documentation only; no runner implementation was inspected.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Pipeline orchestration"]
  node_test_sources["45 test sources"]
  node_runner["Pipeline runner"]
  node_uxb["uxb executable"]
  node_reports["Run reports"]
end

subgraph group_jsonlane["JSON/log lane"]
  node_json_stages["Front end stages"]
  node_interpreter["Interpreter run"]
  node_json_outputs["JSON/log artifacts"]
end

subgraph group_x64lane["x64 lane"]
  node_x64_codegen["x64 generation"]
  node_x64_build["x64 build attempt"]
  node_x64_outputs["x64 artifacts"]
end

subgraph group_weblane["Web lane"]
  node_web_codegen["Web generation"]
  node_browser_outputs["Browser artifacts"]
end

node_operator(("Engineer"))

node_operator -->|"runs"| node_runner
node_test_sources -->|"provides tests"| node_runner
node_runner -->|"invokes"| node_uxb
node_runner -->|"runs lane"| node_json_stages
node_json_stages -->|"feeds"| node_interpreter
node_interpreter -->|"produces"| node_json_outputs
node_runner -->|"runs lane"| node_x64_codegen
node_x64_codegen -->|"generates for"| node_x64_build
node_x64_build -->|"produces"| node_x64_outputs
node_runner -->|"runs lane"| node_web_codegen
node_web_codegen -->|"produces"| node_browser_outputs
node_runner -->|"writes reports"| node_reports

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_test_sources,node_runner,node_uxb,node_reports toneBlue
class node_json_stages,node_interpreter,node_json_outputs toneAmber
class node_x64_codegen,node_x64_build,node_x64_outputs toneMint
class node_web_codegen,node_browser_outputs toneRose
class node_operator toneIndigo
```

## Components

### Pipeline orchestration

- **45 test sources**
- **Pipeline runner**
- **uxb executable**
- **Run reports**

### JSON/log lane

- **Front end stages**
- **Interpreter run**
- **JSON/log artifacts**

### x64 lane

- **x64 generation**
- **x64 build attempt**
- **x64 artifacts**

### Web lane

- **Web generation**
- **Browser artifacts**

### Other components

- **Engineer**

## Connections

- Engineer → Pipeline runner: runs
- 45 test sources → Pipeline runner: provides tests
- Pipeline runner → uxb executable: invokes
- Pipeline runner → Front end stages: runs lane
- Front end stages → Interpreter run: feeds
- Interpreter run → JSON/log artifacts: produces
- Pipeline runner → x64 generation: runs lane
- x64 generation → x64 build attempt: generates for
- x64 build attempt → x64 artifacts: produces
- Pipeline runner → Web generation: runs lane
- Web generation → Browser artifacts: produces
- Pipeline runner → Run reports: writes reports