How takashiidobe/nassau works
Nassau is a work-in-progress Standard ML implementation offering native Cranelift compilation, a portable interpreter, persistent REPLs, and a browser playground. The main workflow accepts SML through the CLI or REPL, lexes and parses it, performs static checks and type inference, lowers typed syntax to core IR, then executes it through the interpreter or compiles it to native code. Structures, signatures, and functors are handled during inference and lowering. Edges are limited to README statements and source-index references; unsampled implementation details are not asserted.
Main entry points: main.rs CLI · session.rs Session orchestration · parser.rs SML parser · lower.rs Core lowering
Components 19
User interfaces
- CLI
src/main.rs - Persistent REPL
src/repl.rs - Browser playground
www/frontend/worker.js - Web session adapter
src/web.rs - Session orchestration
src/session.rs
Language front end
- Lexer
src/lexer.rs - SML parser
src/parser.rs - Syntax utilities
src/constructors.rs
Static semantics
- Scope and match checks
src/matching.rs - Type inference
src/infer.rs - Module inference
src/infer/modules.rs - Core lowering
src/lower.rs - Pattern decision lowering
src/lower/decision.rs
Execution backends
- Core IR
src/core.rs - Cranelift codegen
src/codegen.rs - Portable interpreter
src/interpreter.rs - Native runtime
src/runtime.rs - Value representation
src/value.rs
Other components
- SML user
Connections 32
- SML user → CLI: submits SML
README.md - SML user → Persistent REPL: enters programs
README.md - SML user → Browser playground: uses playground
README.md - CLI → Lexer: parses input
src/main.rs - SML parser → Lexer: reads tokens
src/parser.rs - CLI → SML parser: parses input
src/main.rs - SML parser → Syntax utilities: builds syntax
src/constructors.rs - CLI → Scope and match checks: checks matches
src/main.rs - CLI → Type inference: checks types
src/main.rs - Type inference → SML parser: consumes syntax
src/infer.rs - Type inference → Module inference: delegates modules
src/infer/modules.rs - Core lowering → Type inference: uses inferred types
src/lower.rs - Core lowering → SML parser: lowers syntax
src/lower.rs - Core lowering → Pattern decision lowering: delegates decisions
src/lower.rs - Core lowering → Core IR: produces IR
src/lower.rs - CLI → Cranelift codegen: compiles natively
src/main.rs - Cranelift codegen → Core IR: compiles IR
src/codegen.rs - Cranelift codegen → Native runtime: uses runtime
src/codegen.rs - Cranelift codegen → Value representation: uses representation
src/codegen.rs - CLI → Portable interpreter: runs portable backend
README.md - Portable interpreter → Core IR: executes IR
src/interpreter.rs - Portable interpreter → Value representation: represents values
src/interpreter.rs - Persistent REPL → Cranelift codegen: uses native backend
src/repl.rs - Persistent REPL → Native runtime: uses runtime
src/repl.rs - Persistent REPL → Session orchestration: maintains session
- Session orchestration → SML parser: parses chunks
src/session.rs - Session orchestration → Type inference: checks types
src/session.rs - Session orchestration → Core lowering: lowers program
src/session.rs - Session orchestration → Core IR: executes module
src/session.rs - Session orchestration → Portable interpreter: supports backend
src/session.rs - Web session adapter → Session orchestration: wraps session
src/web.rs - Browser playground → Web session adapter: connects playground