//! the Qala compiler and bytecode VM, as a single crate.
//!
//! the pipeline is lexer -> parser -> type and effect checker -> codegen -> VM.
//! this file declares the modules in dependency order. the `wasm-bindgen`
//! bridge that exposes the pipeline to JavaScript lives in `wasm.rs`.
// constant-pool value enum -- shared by chunk, codegen, vm
// bytecode opcode enum -- consumed by chunk, codegen, optimizer, vm
// instruction stream + constant pool + source map + disassembler.
// typed AST -> bytecode; constant folding, DCE, defer compilation, comptime.
// typed AST -> AArch64 assembly text; the CPSC 355 hosted-Linux dialect.
// peephole optimizer -- single-pass bytecode rewrites.
// stack-based bytecode interpreter -- call frames, heap, single-step.
// native standard library -- the 15 built-in functions the VM dispatches.
// wasm-bindgen bridge -- the browser-facing Qala session API.