Skip to main content

Reference

The reference is for readers who already know the basics — if you have not yet, the Learn track is the front door. Reference pages are short, dense, and assume the rest of the language is already familiar.

The reference has four sections.

Language reference​

The grammar, types, operators, and built-in primitives, exactly as the implementation accepts them.

Compiler internals​

The shape of the implementation: the stages, what each one does, and where you would look in the source tree.

Specification​

The semi-formal description of what the language means. Implementation-independent in intent; written in service of a future second implementation.

Planned features​

Features in the spec or the roadmap that are not yet fully implemented. Each page describes the design intent, what (if anything) has already shipped, and where it sits on the roadmap. A few of these pages — @io effects and string literals — describe machinery that has already landed in part; they remain here because their full surface is still ahead.