The specification, the guide, the grammar, and the formal semantics. Start with the Guide if you want to write your first score today. Start with the Spec if you want to understand the theory.
/ DOC-01
The document you read when you sit down to write. No theory, no proofs — just the twelve chapters that take you from zero to a running score. Includes the workflow, approval loop, and visual debugger.
Read the Guide →
/ DOC-02
1040 lines. Design principles, execution model, all primitive types, operators, the intent layer, error model, and a complete worked example. The authoritative reference for the language.
Read the Spec →
/ DOC-03
The formal surface syntax in EBNF. Two layers: a top-level indentation-aware declaration layer and a brace/paren-based expression layer. The authoritative reference for parser implementors.
Read the Grammar →
/ DOC-04
The locked runtime meaning of v1.0. What 𝕎 is (and is not). How processes own τ. Exact semantics of the three compiler modes, the cache key, and the approval workflow. When things disagree, this file wins.
Read the Semantics →The mathematical foundation New Code is built on. Formal definitions of the waveform number, the drift operator, entanglement, and all nine operators. Required reading for compiler implementors and language theorists.
Download PDF →
The main interface. Load a .nc score, call functions, inspect provenance, accept or reject compiled bodies. Commands: :src · :intent · :accept · :debug
python -m newcode.repl examples/demo.nc
Start with :debug in the REPL. A browser tab opens; every process becomes a horizontal band with τ on the x-axis and the realisation on y. Watch entangled pairs flash when transformations propagate.
nc> :debug → http://127.0.0.1:54321/
A stdlib-only language server for any editor. Diagnostics, completion over the stdlib, hover tooltips showing intent blocks, and document symbols over fn / process / let / module.
python -m newcode.lsp
Install from vscode-newcode/. Syntax highlighting for all keywords, types, intent clauses, the ?? hole, and expression-layer keywords. Red squiggles on parse errors. Hover on compiled functions to see intent blocks.
Extensions: vscode-newcode/