@nvl/tree-sitter-sveltex 0.2.0

package/queries/injections.scm

@@ -0,0 +1,97 @@
+; Language injections for the SvelTeX (`.sveltex`) grammar.
+;
+; The `.sveltex` grammar parses only the top-level structure; every embedded
+; language is delegated to an existing grammar through the injections below.
+; This is the whole point of the grammar — Markdown, Svelte and LaTeX are NOT
+; reimplemented here.
+;
+; Capture conventions (shared by tree-sitter, Zed, Neovim, Helix):
+;   * @injection.content  — the node whose text is reparsed,
+;   * @injection.language — a node whose *text* names the language, or
+;   * (#set! injection.language "name") — a fixed language name.
+; `injection.combined` joins several sibling content nodes into one virtual
+; document before parsing (used so all Markdown chunks form one document).
+
+; ── Markdown prose ───────────────────────────────────────────────────────
+;
+; Every `markdown_chunk` is delegated to the standard `markdown` grammar.
+; `injection.combined` stitches all chunks of a document back together, so the
+; embedded Markdown parser sees one continuous document and block constructs
+; (lists, tables, reference links, ...) that happen to straddle a `.sveltex`
+; construct still resolve correctly.
+;
+; The `markdown` grammar in turn injects `markdown_inline` for inline spans,
+; the fenced-code languages for ``` blocks, and `html`/`svelte` for embedded
+; markup — so Svelte `<script>`, logic blocks and mustache tags are handled by
+; that downstream grammar, exactly as they are in a plain `.svelte`/`.md`
+; setup.
+((markdown_chunk) @injection.content
+  (#set! injection.language "markdown")
+  (#set! injection.combined))
+
+; ── Frontmatter ──────────────────────────────────────────────────────────
+;
+; The fenced frontmatter block carries an optional language keyword
+; (`yaml`/`toml`/`json`); when present, the keyword node's text names the
+; embedded language directly.
+(frontmatter
+  language: (frontmatter_language) @injection.language
+  content: (frontmatter_content) @injection.content)
+
+; A `---`-fenced frontmatter block with no keyword defaults to YAML, matching
+; SvelTeX's own default. The `!language` constraint keeps this from also
+; matching the keyword form above; `#eq?` distinguishes it from the `+++`
+; form below.
+(frontmatter
+  open: (frontmatter_fence) @_fence
+  content: (frontmatter_content) @injection.content
+  !language
+  (#eq? @_fence "---")
+  (#set! injection.language "yaml"))
+
+; A `+++`-fenced frontmatter block is always TOML (the SvelTeX shorthand); it
+; never carries a language keyword.
+(frontmatter
+  open: (frontmatter_fence) @_fence
+  content: (frontmatter_content) @injection.content
+  (#eq? @_fence "+++")
+  (#set! injection.language "toml"))
+
+; ── Math ─────────────────────────────────────────────────────────────────
+;
+; All four delimiter styles carry LaTeX math. The `latex` grammar parses math
+; mode happily even without the surrounding `$`/`\(` delimiters.
+((math_content_display) @injection.content
+  (#set! injection.language "latex"))
+
+((math_content_inline) @injection.content
+  (#set! injection.language "latex"))
+
+((math_content_bracket) @injection.content
+  (#set! injection.language "latex"))
+
+((math_content_paren) @injection.content
+  (#set! injection.language "latex"))
+
+; ── Verbatim environments ────────────────────────────────────────────────
+;
+; A `<tex>`/`<latex>`/`<tikz>` environment holds a full LaTeX document
+; fragment; delegate it to the `latex` grammar.
+((tex_verbatim_body) @injection.content
+  (#set! injection.language "latex"))
+
+; The opening/closing tags of every verbatim environment are HTML-like Svelte
+; markup; hand them to the `svelte` grammar so attributes (which may contain
+; Svelte expressions) are highlighted consistently with the rest of the file.
+((verbatim_tex_open_tag) @injection.content
+  (#set! injection.language "svelte"))
+
+((verbatim_plain_open_tag) @injection.content
+  (#set! injection.language "svelte"))
+
+((verbatim_close_tag) @injection.content
+  (#set! injection.language "svelte"))
+
+; A `<verb>`/`<verbatim>` environment is intentionally opaque (SvelTeX escapes
+; its contents rather than rendering them), so `plain_verbatim_body` is left
+; un-injected — it is plain text.