How tcode-motion/techscript works
TechScript is a human-readable language and integrated development toolchain. The principal workflow starts with a developer invoking tsc on source or a project, proceeds through compilation and a selected execution target, and produces program output or a native executable. The repository also provides project/package workflows, language tooling, and a broad standard library. The README documents the major compiler stages; sampled sources confirm CLI pipeline and optimization orchestration. Some connections for unsampled subsystems are shown only where the README documents them.
Main entry points: pipeline.rs Compiler Pipeline · main.rs tsc Driver · build.rs Build and Check · context.rs Runtime Services
Components 31
CLI and Projects
- tsc Driver
cli/src/main.rs - Project Management
cli/src/project.rs - Build Configuration
cli/src/config.rs - Build and Check
cli/src/commands/build.rs - Compiler Pipeline
cli/src/pipeline.rs - Incremental Cache
cli/src/cache.rs - Artifact Manager
cli/src/artifacts.rs - Diagnostics
cli/src/diagnostics.rs - Compilation Events
cli/src/events.rs - Build Support
cli/src/scheduler.rs
Language Frontend
- Lexer
compiler/lexer/src/lib.rs - Parser and AST
compiler/parser/src/parser.rs - Semantic Analysis
compiler/semantic/src/pipeline.rs - Module Resolver
compiler/module_resolver/src/lib.rs
Compilation Backends
- IR Optimization
compiler/optimizer/src/pipeline.rs - IR Lowering
compiler/ir/src/lowering.rs - Bytecode Backend
compiler/bytecode/src/lowering.rs - LLVM Backend
compiler/llvm_backend/src/codegen.rs
Runtime
- Bytecode VM
runtime/vm/src/executor.rs - Tree Interpreter
runtime/interpreter/src/interpreter.rs - Runtime Services
runtime/runtime/src/context.rs - Standard Library
stdlib/src/lib.rs
Developer Tools
- Formatter
tools/formatter/src/lib.rs - Linter and Migrator
tools/linter/src/lib.rs - Language Server
tools/lsp/src/lib.rs - Package Manager
tools/package-manager/src/lib.rs - VS Code Extension
editors/vscode/extension.js
Other components
- Developer
- TechScript Source
- Project Manifest
- Program Output
Connections 33
- Developer → tsc Driver: invokes
README.md - TechScript Source → tsc Driver: provides source
README.md - Project Manifest → tsc Driver: provides project
README.md - tsc Driver → Build and Check: dispatches commands
cli/src/main.rs - Build and Check → Build Configuration: loads settings
cli/src/commands/build.rs - Build and Check → Project Management: loads project
cli/src/commands/build.rs - Build and Check → Compiler Pipeline: compiles through
cli/src/commands/build.rs - Compiler Pipeline → Lexer: tokenizes
README.md - Compiler Pipeline → Parser and AST: parses
README.md - Compiler Pipeline → Semantic Analysis: validates
README.md - Compiler Pipeline → Module Resolver: resolves modules
README.md - Compiler Pipeline → IR Lowering: lowers to IR
README.md - Compiler Pipeline → IR Optimization: optimizes
cli/src/pipeline.rs - Compiler Pipeline → Bytecode Backend: generates bytecode
README.md - Compiler Pipeline → LLVM Backend: selects native backend
README.md - Build and Check → Incremental Cache: uses cache
cli/src/commands/build.rs - Build and Check → Artifact Manager: writes artifacts
cli/src/commands/build.rs - Compiler Pipeline → Compilation Events: emits events
cli/src/pipeline.rs - Compiler Pipeline → Diagnostics: reports errors
cli/src/pipeline.rs - Project Management → Build Support: schedules builds
cli/src/scheduler.rs - Bytecode Backend → Artifact Manager: writes bytecode
README.md - Artifact Manager → Bytecode VM: loads artifact
README.md - Bytecode VM → Runtime Services: uses services
README.md - LLVM Backend → Runtime Services: uses services
README.md - Runtime Services → Standard Library: exposes modules
stdlib/src/lib.rs - Bytecode VM → Program Output: executes program
README.md - Runtime Services → Program Output: provides effects
README.md - tsc Driver → Tree Interpreter: selects interpreter
- tsc Driver → Formatter: offers formatting
README.md - tsc Driver → Linter and Migrator: offers lint and migration
README.md - tsc Driver → Language Server: offers language server
README.md - tsc Driver → Package Manager: offers package commands
README.md - VS Code Extension → Language Server: editor integration