
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.
Unreleased after v0.18.0
- Breaking
std/file/std/neteffect-row migration (ADR 0084, Proposed): file operations now require/ <fs>; host resolution and socket opening require/ <net>, with real runtime roots and lexical fakes. Listener/socket accept/read/write/peer/close andstd/io.Streamremain handle-mediated/ <io>:http.serveon an existing listener and TLS over an existing connection do not demand unrelated resolver access.http.listenandtls.dialdo open, so they migrate (dial retains io too). Function names, arguments and Result shapes are unchanged; annotated callers and dependent actor/HTTP/SSE/web callback rows must migrate together.dist.start/connect, fetch worker internals and PostgreSQL opening/pool/cancel paths advertise net; pure helpers and existing-connection queries do not. - Runtime ABI stays at 12:
TL_ROOT_NET = 4andNET_OPS = [resolve, listen_at, connect_to]are appended without changing existing root/fs discriminants or old net primitive argument order. Every program actor currently receives the same five roots, not fine-grained per-actor grants; remote-provenance actors and descendants are denied real fs/net before path/DNS/socket work on both backends. TLS CA/cert/key reads, OS powers, FFI and distribution transport remain explicit exclusions, not sandboxed or transparently faked. Interpreter real net keeps its native-only error; only lexical negative/opening fakes are provided, never forged successful socket Resources. - This is one v0-series breaking change, not a scheduled v1/v2 defaulting transition. See capabilities. ADR 0084 remains Proposed and linked to the #44 engineering review.
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).