tree-sitter-weir

A tree-sitter grammar for weir — a renderer, not a second parser. The one truth for what weir accepts is weir check's pipeline (the main repo's SEMANTICS.md); this grammar's only job is better-than-grey highlighting in tree-sitter consumers (Helix, Zed, code forges). It over-accepts freely, does not replicate the assembler's logical-line reconstruction (a continuation line may highlight as a fresh statement), and must never be cited as the language definition.

Generated src/ is committed (ABI 14 — the CLI churns generated boilerplate across versions but the last regenerations held ABI 14; a consumer pinning a rev gets what that rev says) so consumers (Helix --grammar build, Zed) need no Node.js.

Targeted weir version: the release in TARGET_WEIR_RELEASE (main until weir's first release — the checkout then follows weir main as it moves, so drift goes red at the next CI run rather than staying green against a pinned past). CI first asserts the target IS weir's releases/latest (a number, so lag is a comparison), then checks this grammar against the target's editors/grammar-manifest.json — the release ASSET when release-targeted — and parses the target's .weir corpus with the zero-ERROR bar. Bumping the target is the deliberate act of tracking a newer weir, and the currency step refuses to let it lag.

This repo split out of the main tree on 2026-08-09 with fresh history; the grammar's prior evolution lives in weir-shell/weir under editors/tree-sitter-weir (removed at the split).

Helix

# languages.toml
[[grammar]]
name = "weir"
source = { git = "https://github.com/weir-shell/tree-sitter-weir" }

then hx --grammar fetch && hx --grammar build, and copy queries/highlights.scm to ~/.config/helix/runtime/queries/weir/. Add grammar = "weir" (implied by the language name) to the [[language]] block from the main repo's docs/editors.md.

Regenerating

tree-sitter generate (needs the tree-sitter CLI and Node). The corpus acceptance: tree-sitter parse over every .weir in the targeted weir version's examples/ and tools/ must produce zero ERROR nodes (one recorded exception below).

Known nits

• $"... {{literal braces}} ..." — the interp rules mis-lex a {{-escape adjacent to a closing quote (ONE ERROR node, examples/showcase.weir, present since before the block-scalars session; verified pre-existing). The corpus-acceptance rule tolerates exactly this one until a coloring session takes it; the fix likely lives in the interp_text/interp_escape token ordering.