# cesaroliva/tyscript architecture

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

- Interactive diagram: https://gitdiagram.com/cesaroliva/tyscript
- Repository: https://github.com/cesaroliva/tyscript

## Overview

TyScript is both an academic TypeScript-to-JavaScript compiler and a browser playground. The principal workflow accepts TyScript source, lexes and parses it, checks semantics, generates and optimizes quad-based intermediate code, then emits JavaScript for execution. The React app also exposes a step-by-step lexer/parser/semantic view and AST exploration. The README documents CLI output, optimization and interactive input; sampled sources support the app’s in-browser execution path. Some UI wiring is established by imports and documented capabilities, while unsampled implementation details are not inferred.

Main entry points: [`src/App.tsx`](https://github.com/cesaroliva/tyscript/blob/main/src/App.tsx) (Playground App), [`src/compiler/compile.ts`](https://github.com/cesaroliva/tyscript/blob/main/src/compiler/compile.ts) (CLI Compiler), [`src/Analyzer/compilerStepEngine.ts`](https://github.com/cesaroliva/tyscript/blob/main/src/Analyzer/compilerStepEngine.ts) (Step Engine), [`src/compiler/compiler.ts`](https://github.com/cesaroliva/tyscript/blob/main/src/compiler/compiler.ts) (Compiler Front End)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Playground"]
  node_app["Playground App<br/>[App.tsx]"]
  node_editor["Code Editor<br/>[CodeEditor.tsx]"]
  node_terminal["Terminal Panel<br/>[TerminalPanel.tsx]"]
  node_stepdebug["Step Debugger<br/>[StepDebugger.tsx]"]
  node_astview["AST Explorer<br/>[AstExplorer.tsx]"]
  node_asttree["AST Tree<br/>[AstTree.tsx]"]
end

subgraph group_analysis["Language Analysis"]
  node_lexer["Lexer<br/>[lexer.ts]"]
  node_parser["Parser<br/>[parser.ts]"]
  node_ast["AST Model<br/>[ast.ts]"]
  node_semantic["Semantic Analyzer"]
  node_symbols["Symbol Table<br/>[symbolTable.ts]"]
  node_analysiscompile["Editor Analysis<br/>[compiler.ts]"]
  node_stepengine["Step Engine"]
  node_compiler["Compiler Front End<br/>[compiler.ts]"]
end

subgraph group_ir["Intermediate Code"]
  node_quadgen["Quad Generator"]
  node_quadmodel["Quad Model<br/>[ir.ts]"]
  node_flow["Flow Graph<br/>[flowGraph.ts]"]
  node_optimizer["Optimizer<br/>[optimizer.ts]"]
  node_formatter["IR Formatter<br/>[irFormatter.ts]"]
end

subgraph group_runtime["Code Generation"]
  node_jsgen["JavaScript Generator"]
end

subgraph group_cli["CLI Execution"]
  node_cli["CLI Compiler<br/>[compile.ts]"]
  node_node(("Node Runner"))
end

node_user(("Programmer"))

node_user -->|"edits source"| node_app
node_app -->|"hosts editor"| node_editor
node_app -->|"analyzes edits"| node_analysiscompile
node_app -->|"builds steps"| node_stepengine
node_app -->|"compiles source"| node_compiler
node_app -->|"generates quads"| node_quadgen
node_app -->|"optimizes quads"| node_optimizer
node_app -->|"generates JavaScript"| node_jsgen
node_app -->|"shows output"| node_terminal
node_stepdebug -->|"requests steps"| node_stepengine
node_stepdebug -->|"shows AST"| node_astview
node_astview -->|"renders tree"| node_asttree
node_analysiscompile -->|"tokenizes"| node_lexer
node_analysiscompile -->|"parses tokens"| node_parser
node_analysiscompile -->|"checks semantics"| node_semantic
node_parser -->|"builds AST"| node_ast
node_semantic -->|"checks AST"| node_ast
node_semantic -->|"uses scopes"| node_symbols
node_stepengine -->|"tokenizes"| node_lexer
node_stepengine -->|"parses tokens"| node_parser
node_stepengine -->|"checks semantics"| node_semantic
node_compiler -->|"tokenizes"| node_lexer
node_compiler -->|"parses tokens"| node_parser
node_compiler -->|"checks semantics"| node_semantic
node_quadgen -->|"reads AST"| node_ast
node_quadgen -->|"emits quads"| node_quadmodel
node_optimizer -->|"builds graph"| node_flow
node_optimizer -->|"rewrites quads"| node_quadmodel
node_formatter -->|"formats quads"| node_quadmodel
node_jsgen -->|"consumes quads"| node_quadmodel
node_jsgen -->|"formats IR"| node_formatter
node_cli -->|"compiles source"| node_compiler
node_cli -->|"generates quads"| node_quadgen
node_cli -->|"optimizes quads"| node_optimizer
node_cli -->|"generates output"| node_jsgen
node_cli -->|"writes IR"| node_formatter
node_cli -->|"runs program"| node_node
node_user -->|"invokes compile"| node_cli

click node_app "https://github.com/cesaroliva/tyscript/blob/main/src/App.tsx"
click node_editor "https://github.com/cesaroliva/tyscript/blob/main/src/components/CodeEditor.tsx"
click node_terminal "https://github.com/cesaroliva/tyscript/blob/main/src/components/TerminalPanel.tsx"
click node_stepdebug "https://github.com/cesaroliva/tyscript/blob/main/src/components/StepDebugger.tsx"
click node_astview "https://github.com/cesaroliva/tyscript/blob/main/src/components/AstExplorer.tsx"
click node_asttree "https://github.com/cesaroliva/tyscript/blob/main/src/components/AstTree.tsx"
click node_lexer "https://github.com/cesaroliva/tyscript/blob/main/src/Analyzer/lexer.ts"
click node_parser "https://github.com/cesaroliva/tyscript/blob/main/src/Analyzer/parser.ts"
click node_ast "https://github.com/cesaroliva/tyscript/blob/main/src/Analyzer/ast.ts"
click node_semantic "https://github.com/cesaroliva/tyscript/blob/main/src/Analyzer/semanticAnalyzer.ts"
click node_symbols "https://github.com/cesaroliva/tyscript/blob/main/src/Analyzer/symbolTable.ts"
click node_analysiscompile "https://github.com/cesaroliva/tyscript/blob/main/src/Analyzer/compiler.ts"
click node_stepengine "https://github.com/cesaroliva/tyscript/blob/main/src/Analyzer/compilerStepEngine.ts"
click node_compiler "https://github.com/cesaroliva/tyscript/blob/main/src/compiler/compiler.ts"
click node_quadgen "https://github.com/cesaroliva/tyscript/blob/main/src/compiler/intermediateGenerator.ts"
click node_quadmodel "https://github.com/cesaroliva/tyscript/blob/main/src/compiler/ir.ts"
click node_flow "https://github.com/cesaroliva/tyscript/blob/main/src/compiler/flowGraph.ts"
click node_optimizer "https://github.com/cesaroliva/tyscript/blob/main/src/compiler/optimizer.ts"
click node_formatter "https://github.com/cesaroliva/tyscript/blob/main/src/compiler/irFormatter.ts"
click node_jsgen "https://github.com/cesaroliva/tyscript/blob/main/src/compiler/javascriptGenerator.ts"
click node_cli "https://github.com/cesaroliva/tyscript/blob/main/src/compiler/compile.ts"

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_app,node_editor,node_terminal,node_stepdebug,node_astview,node_asttree toneBlue
class node_lexer,node_parser,node_ast,node_semantic,node_symbols,node_analysiscompile,node_stepengine,node_compiler toneAmber
class node_quadgen,node_quadmodel,node_flow,node_optimizer,node_formatter toneMint
class node_jsgen toneRose
class node_cli,node_node,node_user toneIndigo
```

## Components

### Playground

- [Playground App](https://github.com/cesaroliva/tyscript/blob/main/src/App.tsx): `src/App.tsx`
- [Code Editor](https://github.com/cesaroliva/tyscript/blob/main/src/components/CodeEditor.tsx): `src/components/CodeEditor.tsx`
- [Terminal Panel](https://github.com/cesaroliva/tyscript/blob/main/src/components/TerminalPanel.tsx): `src/components/TerminalPanel.tsx`
- [Step Debugger](https://github.com/cesaroliva/tyscript/blob/main/src/components/StepDebugger.tsx): `src/components/StepDebugger.tsx`
- [AST Explorer](https://github.com/cesaroliva/tyscript/blob/main/src/components/AstExplorer.tsx): `src/components/AstExplorer.tsx`
- [AST Tree](https://github.com/cesaroliva/tyscript/blob/main/src/components/AstTree.tsx): `src/components/AstTree.tsx`

### Language Analysis

- [Lexer](https://github.com/cesaroliva/tyscript/blob/main/src/Analyzer/lexer.ts): `src/Analyzer/lexer.ts`
- [Parser](https://github.com/cesaroliva/tyscript/blob/main/src/Analyzer/parser.ts): `src/Analyzer/parser.ts`
- [AST Model](https://github.com/cesaroliva/tyscript/blob/main/src/Analyzer/ast.ts): `src/Analyzer/ast.ts`
- [Semantic Analyzer](https://github.com/cesaroliva/tyscript/blob/main/src/Analyzer/semanticAnalyzer.ts): `src/Analyzer/semanticAnalyzer.ts`
- [Symbol Table](https://github.com/cesaroliva/tyscript/blob/main/src/Analyzer/symbolTable.ts): `src/Analyzer/symbolTable.ts`
- [Editor Analysis](https://github.com/cesaroliva/tyscript/blob/main/src/Analyzer/compiler.ts): `src/Analyzer/compiler.ts`
- [Step Engine](https://github.com/cesaroliva/tyscript/blob/main/src/Analyzer/compilerStepEngine.ts): `src/Analyzer/compilerStepEngine.ts`
- [Compiler Front End](https://github.com/cesaroliva/tyscript/blob/main/src/compiler/compiler.ts): `src/compiler/compiler.ts`

### Intermediate Code

- [Quad Generator](https://github.com/cesaroliva/tyscript/blob/main/src/compiler/intermediateGenerator.ts): `src/compiler/intermediateGenerator.ts`
- [Quad Model](https://github.com/cesaroliva/tyscript/blob/main/src/compiler/ir.ts): `src/compiler/ir.ts`
- [Flow Graph](https://github.com/cesaroliva/tyscript/blob/main/src/compiler/flowGraph.ts): `src/compiler/flowGraph.ts`
- [Optimizer](https://github.com/cesaroliva/tyscript/blob/main/src/compiler/optimizer.ts): `src/compiler/optimizer.ts`
- [IR Formatter](https://github.com/cesaroliva/tyscript/blob/main/src/compiler/irFormatter.ts): `src/compiler/irFormatter.ts`

### Code Generation

- [JavaScript Generator](https://github.com/cesaroliva/tyscript/blob/main/src/compiler/javascriptGenerator.ts): `src/compiler/javascriptGenerator.ts`

### CLI Execution

- [CLI Compiler](https://github.com/cesaroliva/tyscript/blob/main/src/compiler/compile.ts): `src/compiler/compile.ts`
- **Node Runner**

### Other components

- **Programmer**

## Connections

- Programmer → Playground App: edits source (evidence: `README.md`)
- Playground App → Code Editor: hosts editor (evidence: `src/App.tsx`)
- Playground App → Editor Analysis: analyzes edits (evidence: `src/App.tsx`)
- Playground App → Step Engine: builds steps (evidence: `src/App.tsx`)
- Playground App → Compiler Front End: compiles source (evidence: `src/App.tsx`)
- Playground App → Quad Generator: generates quads (evidence: `src/App.tsx`)
- Playground App → Optimizer: optimizes quads (evidence: `src/App.tsx`)
- Playground App → JavaScript Generator: generates JavaScript (evidence: `src/App.tsx`)
- Playground App → Terminal Panel: shows output (evidence: `README.md`)
- Step Debugger → Step Engine: requests steps (evidence: `src/components/StepDebugger.tsx`)
- Step Debugger → AST Explorer: shows AST (evidence: `src/components/StepDebugger.tsx`)
- AST Explorer → AST Tree: renders tree (evidence: `src/components/AstExplorer.tsx`)
- Editor Analysis → Lexer: tokenizes (evidence: `src/Analyzer/compiler.ts`)
- Editor Analysis → Parser: parses tokens (evidence: `src/Analyzer/compiler.ts`)
- Editor Analysis → Semantic Analyzer: checks semantics (evidence: `src/Analyzer/compiler.ts`)
- Parser → AST Model: builds AST (evidence: `src/Analyzer/parser.ts`)
- Semantic Analyzer → AST Model: checks AST (evidence: `src/Analyzer/semanticAnalyzer.ts`)
- Semantic Analyzer → Symbol Table: uses scopes (evidence: `src/Analyzer/semanticAnalyzer.ts`)
- Step Engine → Lexer: tokenizes (evidence: `src/Analyzer/compilerStepEngine.ts`)
- Step Engine → Parser: parses tokens (evidence: `src/Analyzer/compilerStepEngine.ts`)
- Step Engine → Semantic Analyzer: checks semantics (evidence: `src/Analyzer/compilerStepEngine.ts`)
- Compiler Front End → Lexer: tokenizes (evidence: `src/compiler/compiler.ts`)
- Compiler Front End → Parser: parses tokens (evidence: `src/compiler/compiler.ts`)
- Compiler Front End → Semantic Analyzer: checks semantics (evidence: `src/compiler/compiler.ts`)
- Quad Generator → AST Model: reads AST (evidence: `src/compiler/intermediateGenerator.ts`)
- Quad Generator → Quad Model: emits quads (evidence: `src/compiler/intermediateGenerator.ts`)
- Optimizer → Flow Graph: builds graph (evidence: `src/compiler/optimizer.ts`)
- Optimizer → Quad Model: rewrites quads (evidence: `src/compiler/optimizer.ts`)
- IR Formatter → Quad Model: formats quads (evidence: `src/compiler/irFormatter.ts`)
- JavaScript Generator → Quad Model: consumes quads (evidence: `src/compiler/javascriptGenerator.ts`)
- JavaScript Generator → IR Formatter: formats IR (evidence: `src/compiler/javascriptGenerator.ts`)
- CLI Compiler → Compiler Front End: compiles source (evidence: `src/compiler/compile.ts`)
- CLI Compiler → Quad Generator: generates quads (evidence: `src/compiler/compile.ts`)
- CLI Compiler → Optimizer: optimizes quads (evidence: `src/compiler/compile.ts`)
- CLI Compiler → JavaScript Generator: generates output (evidence: `src/compiler/compile.ts`)
- CLI Compiler → IR Formatter: writes IR (evidence: `src/compiler/compile.ts`)
- CLI Compiler → Node Runner: runs program (evidence: `README.md`)
- Programmer → CLI Compiler: invokes compile (evidence: `README.md`)
