summaryrefslogtreecommitdiff
path: root/examples/live/grammar/grammar.js
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-11-17 07:51:24 -0300
committerGabriel Schneider <[email protected]>2026-11-17 12:15:01 -0300
commitf37732448a2a374281c9610d05a10315e97dcbbf (patch)
tree8778dba261ce8dcddcfea894d838e0b51b0255cb /examples/live/grammar/grammar.js
parentfad609ddb13cbc0f33150fc3a9dfc25051641cd8 (diff)
downloadsketchbook-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.js24
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]*/,
+ },
+});