How cesaroliva/tyscript works
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: App.tsx Playground App · compile.ts CLI Compiler · compilerStepEngine.ts Step Engine · compiler.ts Compiler Front End
Components 23
Playground
- Playground App
src/App.tsx - Code Editor
src/components/CodeEditor.tsx - Terminal Panel
src/components/TerminalPanel.tsx - Step Debugger
src/components/StepDebugger.tsx - AST Explorer
src/components/AstExplorer.tsx - AST Tree
src/components/AstTree.tsx
Language Analysis
- Lexer
src/Analyzer/lexer.ts - Parser
src/Analyzer/parser.ts - AST Model
src/Analyzer/ast.ts - Semantic Analyzer
src/Analyzer/semanticAnalyzer.ts - Symbol Table
src/Analyzer/symbolTable.ts - Editor Analysis
src/Analyzer/compiler.ts - Step Engine
src/Analyzer/compilerStepEngine.ts - Compiler Front End
src/compiler/compiler.ts
Intermediate Code
- Quad Generator
src/compiler/intermediateGenerator.ts - Quad Model
src/compiler/ir.ts - Flow Graph
src/compiler/flowGraph.ts - Optimizer
src/compiler/optimizer.ts - IR Formatter
src/compiler/irFormatter.ts
Code Generation
- JavaScript Generator
src/compiler/javascriptGenerator.ts
CLI Execution
- CLI Compiler
src/compiler/compile.ts - Node Runner
Other components
- Programmer
Connections 38
- Programmer → Playground App: edits source
README.md - Playground App → Code Editor: hosts editor
src/App.tsx - Playground App → Editor Analysis: analyzes edits
src/App.tsx - Playground App → Step Engine: builds steps
src/App.tsx - Playground App → Compiler Front End: compiles source
src/App.tsx - Playground App → Quad Generator: generates quads
src/App.tsx - Playground App → Optimizer: optimizes quads
src/App.tsx - Playground App → JavaScript Generator: generates JavaScript
src/App.tsx - Playground App → Terminal Panel: shows output
README.md - Step Debugger → Step Engine: requests steps
src/components/StepDebugger.tsx - Step Debugger → AST Explorer: shows AST
src/components/StepDebugger.tsx - AST Explorer → AST Tree: renders tree
src/components/AstExplorer.tsx - Editor Analysis → Lexer: tokenizes
src/Analyzer/compiler.ts - Editor Analysis → Parser: parses tokens
src/Analyzer/compiler.ts - Editor Analysis → Semantic Analyzer: checks semantics
src/Analyzer/compiler.ts - Parser → AST Model: builds AST
src/Analyzer/parser.ts - Semantic Analyzer → AST Model: checks AST
src/Analyzer/semanticAnalyzer.ts - Semantic Analyzer → Symbol Table: uses scopes
src/Analyzer/semanticAnalyzer.ts - Step Engine → Lexer: tokenizes
src/Analyzer/compilerStepEngine.ts - Step Engine → Parser: parses tokens
src/Analyzer/compilerStepEngine.ts - Step Engine → Semantic Analyzer: checks semantics
src/Analyzer/compilerStepEngine.ts - Compiler Front End → Lexer: tokenizes
src/compiler/compiler.ts - Compiler Front End → Parser: parses tokens
src/compiler/compiler.ts - Compiler Front End → Semantic Analyzer: checks semantics
src/compiler/compiler.ts - Quad Generator → AST Model: reads AST
src/compiler/intermediateGenerator.ts - Quad Generator → Quad Model: emits quads
src/compiler/intermediateGenerator.ts - Optimizer → Flow Graph: builds graph
src/compiler/optimizer.ts - Optimizer → Quad Model: rewrites quads
src/compiler/optimizer.ts - IR Formatter → Quad Model: formats quads
src/compiler/irFormatter.ts - JavaScript Generator → Quad Model: consumes quads
src/compiler/javascriptGenerator.ts - JavaScript Generator → IR Formatter: formats IR
src/compiler/javascriptGenerator.ts - CLI Compiler → Compiler Front End: compiles source
src/compiler/compile.ts - CLI Compiler → Quad Generator: generates quads
src/compiler/compile.ts - CLI Compiler → Optimizer: optimizes quads
src/compiler/compile.ts - CLI Compiler → JavaScript Generator: generates output
src/compiler/compile.ts - CLI Compiler → IR Formatter: writes IR
src/compiler/compile.ts - CLI Compiler → Node Runner: runs program
README.md - Programmer → CLI Compiler: invokes compile
README.md