diff options
| author | Gabriel Schneider <[email protected]> | 2026-11-17 07:51:24 -0300 |
|---|---|---|
| committer | Gabriel Schneider <[email protected]> | 2026-11-17 12:15:01 -0300 |
| commit | f37732448a2a374281c9610d05a10315e97dcbbf (patch) | |
| tree | 8778dba261ce8dcddcfea894d838e0b51b0255cb /examples/live/grammar/grammar.js | |
| parent | fad609ddb13cbc0f33150fc3a9dfc25051641cd8 (diff) | |
| download | sketchbook-f37732448a2a374281c9610d05a10315e97dcbbf.tar.gz sketchbook-f37732448a2a374281c9610d05a10315e97dcbbf.zip | |
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 <[email protected]>
Claude-Session: https://claude.ai/code/session_016Y9MNBECMWcJD5pdS4SR6T
Diffstat (limited to 'examples/live/grammar/grammar.js')
| -rw-r--r-- | examples/live/grammar/grammar.js | 24 |
1 files changed, 24 insertions, 0 deletions
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]*/, + }, +}); |
