# Louise v0: release notes At v0 the language was named tilcayo: the compiler was `tilc` and source files ended in `.til`. These notes use the current names ([ADR 0021](adr/0021-the-name-louise.md)). v0 is the first complete vertical slice of the language: a typed, effectful language with OTP actors and inline HTML. It compiles to C and has no garbage collector. **Its definition of done** is a supervised HTTP server that: - renders pages on the server; - hashes passwords with argon2, linked from C; - uses effect handlers for logging and data access; - is edited with a working language server. That is `examples/http_demo`, and it is tested end to end in CI. ## What is in v0 **Language:** - **Syntax:** braces, expression-oriented, Gleam's `use` and `|>`. - **Inline HTML literals:** typed, with components ([ADR 0009](adr/0009-html-literals.md)). - **Types** ([ADR 0007](adr/0007-type-inference-and-traits.md)): - Hindley–Milner inference, with required signatures on `pub` functions; - algebraic data types and records; - single-parameter traits with coherence, and `@derive`; - exhaustive pattern matching. - **Effects:** - typed algebraic effects with row polymorphism ([ADR 0008](adr/0008-effect-typing.md)); - `fn`, `ctl` (one-shot `resume`) and `final ctl` operations; - **lexically scoped handlers** ([ADR 0010](adr/0010-lexical-handlers.md)). - **Memory:** no GC. Perceus reference counting, and mutable references scoped to `region`s so cycles cannot leak ([ADR 0002](adr/0002-memory-model.md)). - **Tail calls:** guaranteed in constant stack. - **Tests:** `@test` and `@should_panic` next to the code. **Runtime and backends:** - **The reference interpreter** runs everything. - **The native backend** emits C with Perceus `dup`/`drop`: - `musttail` for every tail call; - exact unwinding for panics and `final ctl`; - `ctl` by stack switching. Every `tests/run` program prints the same thing on both backends and leaves 0 live blocks, also under ASan and UBSan. - **Actors** ([ADR 0004](adr/0004-actor-model.md)): - preemptive scheduling, typed subjects; - links, monitors, trapped exits; - gen_server-style actors and supervisors. - **Native dependencies** ([ADR 0005](adr/0005-ffi.md)): - C sources, static libraries, pkg-config, and Rust crates; - `blocking` externs on a thread pool; - resources with finalizers; - an argon2 binding package. - **Networking:** TCP on a reactor, an HTTP/1.1 server, and persistent maps. **Tooling:** - **`louise` commands:** `check`, `run` (`--native`), `build`, `test` (`--native`), `fmt`, `lsp`. - **Language server:** diagnostics, hover with effects, go to definition, references, document symbols, completion, inlay hints for inferred signatures, formatting, and a quick fix that inserts a signature. - **VS Code extension:** packaged with `npm run package`. ## Known limitations These are deliberate cuts for v0. Each is recorded where it was decided. - **One scheduler thread.** Actors are preemptive but share one OS thread, so messages are moved rather than copied. - The multi-threaded, work-stealing scheduler and move/share/copy sending of ADR 0004 Revision 1 are the next runtime milestone. - They need the runtime's own context switch in place of corosensei. - `blocking` externs already run on other threads. - **Unwinding in C uses yield checks**, not unwinding tables: one predicted branch after each call that may unwind. Zero-overhead unwinding conflicts with `musttail` in C ([ADR 0003, Revision 2](adr/0003-effect-lowering.md), proposed). - **Performance:** - Arithmetic through traits builds a dictionary at each use. There is no specialisation or monomorphisation yet. - Perceus has no borrow inference or reuse analysis yet. - Code is correct, not yet fast. - **No `Bytes` type.** Network reads replace invalid UTF-8, and HTTP has no keep-alive and no chunked encoding. - **Interpreter-only gaps:** - networking and native dependencies need the native backend; - escaped continuations (`resume` called after their handler finished) panic natively, while the interpreter accepts them. - **Effects:** a function that calls a callback inside its own handler needs the callback's type declared. Inference does not invent capability parameters (ADR 0010). - **No package registry:** dependencies are paths only. - **Not yet supported:** - `#line` directives in generated C; - higher-kinded types, traits with several parameters, user-defined derives; - a client-side HTML target; - callbacks from C into Louise. ## Decisions to review The project owner reviewed and accepted ADRs 0001–0009 and the runtime ABI (issue #2). **Still proposed:** - ADR 0010 (lexically scoped handlers); - ADR 0003 Revision 2 (unwinding in C); - ADR 0005 Revision 1 (the extern convention).