From f37732448a2a374281c9610d05a10315e97dcbbf Mon Sep 17 00:00:00 2001 From: Gabriel Schneider Date: Tue, 17 Nov 2026 07:51:24 -0300 Subject: examples/live: the language's grammar, its colours and a new line's indent grammar/grammar.js is the language as src/Lang.zig parses it, for tree-sitter (24 lines): lines of `name = expression` parted by newlines, `+ -` below `* /` below unary `-`, calls, parentheses, numbers (Lang's digits, point and `e`), names, `#` comments as extras. `tree-sitter generate` (tree-sitter 0.26.9; ABI 14, the CLI's without a tree-sitter.json) wrote grammar/src/parser.c (918 lines) and its tree_sitter/ headers, committed: the build compiles them into the sketch as a static library and never runs the generator. The `Language` is handed to the editor at run time (`tree_sitter_live`, queries/highlights.scm and queries/indents.scm embedded). The parse is a module's `Syntax`, kept between calls so Alt-i goes back the way Alt-o came, handed to every key, forgotten at a jump (in `draw`, `in.jumped`) and started again by a reload (the tree a reload leaves is leaked: marked ponytail). `code` colours each run of bytes by `Syntax.colors` in pardes's own theme (orchard, the first): a defined name as a keyword, a called builtin as a string, numbers and comments as theirs, the rest in the theme's ink. indents.scm gives a new line no indent outside an open call or parenthesis: pardes's plain indent is a level more after `)`, so every line of this language that ends in a call pushed the next one in. The library now reads a handed-in language's indent query (pardes, its own change). Test: test/grammar.zig parses with the grammar and compiles with Lang.zig 22 texts: the survey's program and two others both take; eleven broken lines both refuse (an unclosed or extra parenthesis, a missing operand or `=`, two numbers, `1.2.3`, a stray `$`); eight both parse but only Lang.zig refuses, as only it knows names, builtins, arities and where a colour may stand (a name used before it is defined or defined twice, a builtin redefined or called with too few arguments, an unknown call, a colour outside the color line, a name called). Lang.zig's survey is public for it. zig build test: 85 of 85 steps. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_016Y9MNBECMWcJD5pdS4SR6T --- examples/live/grammar/grammar.js | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 examples/live/grammar/grammar.js (limited to 'examples/live/grammar/grammar.js') diff --git a/examples/live/grammar/grammar.js b/examples/live/grammar/grammar.js new file mode 100644 index 0000000..31f50b1 --- /dev/null +++ b/examples/live/grammar/grammar.js @@ -0,0 +1,24 @@ +// The language as src/Lang.zig parses it, for tree-sitter: lines of +// `name = expression`, `+ -` below `* /` below unary `-`, calls, numbers, +// names, `#` comments. `tree-sitter generate` here writes src/parser.c, +// which is committed: the build compiles it and never runs the generator. +module.exports = grammar({ + name: 'live', + extras: $ => [/[ \t\r]/, $.comment], + word: $ => $.name, + rules: { + source_file: $ => seq(optional($.definition), repeat(seq('\n', optional($.definition)))), + definition: $ => seq(field('name', $.name), '=', field('value', $._expression)), + _expression: $ => choice($.binary, $.unary, $.call, $.parenthesized, $.number, $.name), + binary: $ => choice( + prec.left(1, seq(field('left', $._expression), field('operator', choice('+', '-')), field('right', $._expression))), + prec.left(2, seq(field('left', $._expression), field('operator', choice('*', '/')), field('right', $._expression))), + ), + unary: $ => prec(3, seq('-', field('operand', $._expression))), + call: $ => seq(field('function', $.name), '(', optional(seq($._expression, repeat(seq(',', $._expression)))), ')'), + parenthesized: $ => seq('(', $._expression, ')'), + number: $ => /(\d+(\.\d*)?|\.\d+)(e[+-]?\d+)?/, + name: $ => /[a-zA-Z_][a-zA-Z0-9_]*/, + comment: $ => /#[^\n]*/, + }, +}); -- cgit v1.3