
louise
Clone avec HTTPS, un jeton personnel en mot de passe, ou avec SSH, une clé ajoutée dans vos paramètres.
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).
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
useand|>. - Inline HTML literals: typed, with components (ADR 0009).
- Types (ADR 0007):
- Hindley–Milner inference, with required signatures on
pubfunctions; - algebraic data types and records;
- single-parameter traits with coherence, and
@derive; - exhaustive pattern matching.
- Hindley–Milner inference, with required signatures on
- Effects:
- Memory: no GC. Perceus reference counting, and mutable references scoped to
regions so cycles cannot leak (ADR 0002). - Tail calls: guaranteed in constant stack.
- Tests:
@testand@should_panicnext to the code.
Runtime and backends:
The reference interpreter runs everything.
The native backend emits C with Perceus
dup/drop:musttailfor every tail call;- exact unwinding for panics and
final ctl; ctlby stack switching.
Every
tests/runprogram prints the same thing on both backends and leaves 0 live blocks, also under ASan and UBSan.Actors (ADR 0004):
- preemptive scheduling, typed subjects;
- links, monitors, trapped exits;
- gen_server-style actors and supervisors.
Native dependencies (ADR 0005):
- C sources, static libraries, pkg-config, and Rust crates;
blockingexterns 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:
louisecommands: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.
blockingexterns 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
musttailin C (ADR 0003, Revision 2, 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
Bytestype. 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 (
resumecalled 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:
#linedirectives 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).