How harsh-programming-language/harsh-lang works
Harsh is a Rust-oriented language toolchain: it transforms indentation-based .hrs source into Rust, then relies on Cargo and rustc for compilation. The main workflow runs through the hrs CLI and build driver; the driver coordinates tokenization, layout and syntax rewrites, Rust emission, and source maps. Separate tools convert Rust back to Harsh and remap compiler diagnostics. The README also documents formatting, project commands, linear-algebra runtime support, a language server, and editor integrations. Internal links follow excerpts, source-index references, or README statements; unsampled details are not inferred.
Main entry points: driver.rs Build driver · layout.rs Layout pass · emit.rs Rust emitter · lex.rs Lexer
Components 21
Transpilation
- Lexer
src/lex.rs - Layout pass
src/layout.rs - Juxtaposed calls
src/juxt.rs - Harsh macros
src/mac.rs - Rust macro zones
src/rawzone.rs - DSL macro holes
src/dslzone.rs - Rust emitter
src/emit.rs
Project Tooling
- hrs CLI
src/main.rs - Build driver
src/driver.rs - Formatter
src/fmt.rs - Source maps
src/dist.rs - Diagnostic remapper
src/remap.rs - Rust converter
src/unbrace.rs
Language Runtime
- Matrix runtime
hrs_std/src/lib.rs - Matrix slicing
hrs_std/src/slicing.rs
Editor Support
- Language server
src/bin/hrs-lsp.rs - Harsh grammar
editors/tree-sitter-harsh/grammar.js - VS Code extension
editors/vscode-harsh/client/extension.js - Zed extension
editors/zed-harsh/src/lib.rs
Other components
- Developer
- Cargo / rustc
Connections 23
- Developer → hrs CLI: invokes
README.md - hrs CLI → Build driver: runs
- Build driver → Lexer: uses
src/driver.rs - Build driver → Layout pass: uses
src/driver.rs - Build driver → Juxtaposed calls: uses
src/driver.rs - Build driver → Harsh macros: expands
src/driver.rs - Build driver → Rust macro zones: preserves
src/driver.rs - Build driver → DSL macro holes: processes
src/driver.rs - Build driver → Rust emitter: emits with
src/driver.rs - Build driver → Source maps: writes
src/driver.rs - Build driver → Formatter: uses
src/driver.rs - Build driver → Diagnostic remapper: uses
src/driver.rs - Lexer → Layout pass: tokenizes for
src/layout.rs - Layout pass → Rust emitter: structures for
src/emit.rs - Rust emitter → Cargo / rustc: generates Rust for
README.md - Cargo / rustc → Diagnostic remapper: diagnostics remapped by
README.md - Developer → Rust converter: converts Rust with
README.md - Developer → Formatter: formats with
README.md - Developer → Language server: requests on-type formatting
README.md - VS Code extension → Harsh grammar: integrates grammar
- Developer → Matrix runtime: uses matrix operations
README.md - Matrix runtime → Matrix slicing: provides slicing
hrs_std/src/lib.rs - Developer → Zed extension: uses Harsh support