Decision D032 · accepted
Repository layout and file size
A record of the language's design, as it stood on 2026-11-18: written for the people who build Diaspar, and kept as it was written. Its code is a sketch, not a program of the site, and an older record may show syntax that a later one changed. It names files of the language's source, which is not public yet.
Status: accepted (2026-11-16)
Amended 2026-11-18 by D037: a package may have examples/ and scripts/.
Amended 2026-11-18: the bootstrap interpreter, bootstrap/, is deleted (stage C, tag last-rust-interpreter); seed/ holds the compiler's own C, generated, which builds it with a C compiler alone.
Layout
std/ the standard library of the language (was bootstrap/std/)
lang/ the language's own tools: reader, syntax objects, indentation, formatter
tests/ tests of the language, run compiled and by the compiler's harness (was bootstrap/tests/cases …)
examples/ programs written in Diaspar, such as jt (was bootstrap/examples/)
compiler/ the compiler package, split by pipeline layer: front/, middle/, back/, eval/, tools/, cli/
runtime/ the C runtime, split by concern
seed/ the compiler's own C, generated (docs/design/self-hosting.md 5)
docs/ reports/ research_notes/
std/belongs to the language, not the interpreter. The interpreter was deleted at stage C (D003, D012); the standard library stays.std.langholds the language's tools that programs may use: the reader and syntax objects (already reached throughread-stringandstd.meta.read-syntax), the indentation rule shared by the formatter and the REPL's editor, and the formatter (D031). Go keepsgo/parser,go/astandgo/formatin its standard library the same way, and Pythonastandtokenize. The expander, analysis, passes and code generation are the compiler's internals and stay in its package, as Go'scmd/compile.- The language's tests are shared: the cases that the differential harness runs through both tools (D003) are not the interpreter's.
File size
- Soft limit 1,500 lines, hard limit 2,000, for every source file (Diaspar, C, shell). Past the soft limit
mise run checkwarns; past the hard limit it fails. A file that grows past the limit is split into submodules.