@reteps/tree-sitter-htmlmustache 0.8.0 → 0.9.0

package/README.md

@@ -11,7 +11,7 @@
 <p align="center">
   <a href="https://github.com/reteps/tree-sitter-htmlmustache/actions/workflows/lint.yml"><img src="https://img.shields.io/github/actions/workflow/status/reteps/tree-sitter-htmlmustache/lint.yml?logo=github&label=Lint" alt="Lint"></a>
   <a href="https://github.com/reteps/tree-sitter-htmlmustache/actions/workflows/lsp.yml"><img src="https://img.shields.io/github/actions/workflow/status/reteps/tree-sitter-htmlmustache/lsp.yml?logo=github&label=LSP" alt="LSP"></a>
-  <a href="https://marketplace.visualstudio.com/items?itemName=reteps.htmlmustache-lsp"><img src="https://img.shields.io/visual-studio-marketplace/v/reteps.htmlmustache-lsp?logo=visualstudiocode&label=VS%20Code" alt="VS Code Marketplace"></a>
+  <a href="https://open-vsx.org/extension/reteps/htmlmustache-lsp"><img src="https://img.shields.io/open-vsx/v/reteps/htmlmustache-lsp?logo=visualstudiocode&label=VS%20Code" alt="Open VSX"></a>
 </p>
 
 ---
@@ -294,41 +294,57 @@ Each custom rule requires an `id`, `selector`, and `message`. The `severity` def
 
 **Selector syntax:**
 
-| Selector                                  | Matches                                       |
-| ----------------------------------------- | --------------------------------------------- |
-| `div`                                     | HTML elements by tag name                     |
-| `*`                                       | Any HTML element                              |
-| `#main`                                   | ID (shorthand for `[id="main"]`)              |
-| `.panel`                                  | Class (shorthand for `[class~="panel"]`)      |
-| `div span`                                | Descendant (span anywhere inside div)         |
-| `div > span`                              | Direct child                                  |
-| `[style]`                                 | Attribute presence                            |
-| `input[type=hidden]`                      | Attribute value (exact)                       |
-| `[src^="prefix/"]`                        | Attribute starts with                         |
-| `[href*="substring"]`                     | Attribute contains                            |
-| `[src$=".png"]`                           | Attribute ends with                           |
-| `[class~="warning"]`                      | Attribute contains whitespace-token           |
-| `img:not([alt])`                          | Negated attribute / class / id                |
-| `{{foo}}`                                 | Escaped variable `{{foo}}`                    |
-| `{{data.foo}}`                            | Variable with a dotted path                   |
-| `{{{foo}}}`                               | Triple / unescaped variable                   |
-| `{{options.*}}`                           | Variable path prefix match                    |
-| `{{*.deprecated}}`                        | Variable path suffix match                    |
-| `{{*}}`                                   | Any escaped variable                          |
-| `{{{*}}}`                                 | Any triple                                    |
-| `{{#items}}`                              | Section `{{#items}}...{{/items}}`             |
-| `{{^items}}`                              | Inverted section `{{^items}}...{{/items}}`    |
-| `{{#items}} > li`                         | Direct child inside a section                 |
-| `{{!TODO}}`                               | Comment with exact content                    |
-| `{{!*TODO*}}`                             | Comment containing "TODO"                     |
-| `{{>header}}`                             | Partial invocation                            |
-| `{{>legacy_*}}`                           | Partial name prefix                           |
-| `pl-multiple-choice:has({{foo}})`         | Element containing a given variable           |
-| `pl-multiple-choice:not(:has(pl-answer))` | Element missing a required descendant         |
-| `div, span`                               | Comma-separated alternatives                  |
+| Selector                                  | Matches                                    |
+| ----------------------------------------- | ------------------------------------------ |
+| `div`                                     | HTML elements by tag name                  |
+| `*`                                       | Any HTML element                           |
+| `#main`                                   | ID (shorthand for `[id="main"]`)           |
+| `.panel`                                  | Class (shorthand for `[class~="panel"]`)   |
+| `div span`                                | Descendant (span anywhere inside div)      |
+| `div > span`                              | Direct child                               |
+| `[style]`                                 | Attribute presence                         |
+| `input[type=hidden]`                      | Attribute value (exact)                    |
+| `[src^="prefix/"]`                        | Attribute starts with                      |
+| `[href*="substring"]`                     | Attribute contains                         |
+| `[src$=".png"]`                           | Attribute ends with                        |
+| `[class~="warning"]`                      | Attribute contains whitespace-token        |
+| `img:not([alt])`                          | Negated attribute / class / id             |
+| `{{foo}}`                                 | Escaped variable `{{foo}}`                 |
+| `{{data.foo}}`                            | Variable with a dotted path                |
+| `{{{foo}}}`                               | Triple / unescaped variable                |
+| `{{options.*}}`                           | Variable path prefix match                 |
+| `{{*.deprecated}}`                        | Variable path suffix match                 |
+| `{{*}}`                                   | Any escaped variable                       |
+| `{{{*}}}`                                 | Any triple                                 |
+| `{{#items}}`                              | Section `{{#items}}...{{/items}}`          |
+| `{{^items}}`                              | Inverted section `{{^items}}...{{/items}}` |
+| `{{#items}} > li`                         | Direct child inside a section              |
+| `{{!TODO}}`                               | Comment with exact content                 |
+| `{{!*TODO*}}`                             | Comment containing "TODO"                  |
+| `{{>header}}`                             | Partial invocation                         |
+| `{{>legacy_*}}`                           | Partial name prefix                        |
+| `pl-multiple-choice:has({{foo}})`         | Element containing a given variable        |
+| `pl-multiple-choice:not(:has(pl-answer))` | Element missing a required descendant      |
+| `div, span`                               | Comma-separated alternatives               |
+| `:root`                                   | The document root (the whole parse tree)   |
+| `:root:has(pl-answer-panel)`              | Document contains a descendant anywhere    |
+| `:root:not(:has(pl-answer-panel))`        | Document is missing a descendant anywhere  |
+| `:root > section`                         | Top-level element (direct child of root)   |
 
 The `>` (child) combinator is kind-transparent: `div > span` matches even if a Mustache section sits between them (e.g. `<div>{{#show}}<span>{{/show}}</div>`), and `{{#a}} > {{#b}}` matches across intervening HTML elements. `{{#foo}}` matches only positive sections — to target inverted sections use `{{^foo}}`.
 
+**Document-scoped conditional rules.** Use `:root` with `:has(...)` / `:not(:has(...))` to express rules that depend on the overall document. Chained `:has(...)` acts as AND, so you can combine "contains X" and "missing Y" in one selector:
+
+```jsonc
+{
+  "id": "question-needs-answer-panel",
+  "selector": ":root:has(pl-question-panel):not(:has(pl-answer-panel))",
+  "message": "A question-panel document must also declare a pl-answer-panel.",
+}
+```
+
+When `:root` matches, the diagnostic is reported at the start of the document (row 0, column 0) so the squiggle doesn't span the whole file. `:root` here is the tree-sitter fragment root, so it works on partial templates and fragments — unlike browser CSS, which anchors `:root` on `<html>`. Inside `:has(...)`, `:root` refers to the element being has-checked, not the document.
+
 ### Disabling Lint Rules
 
 Disable a lint rule for an entire file with an inline comment:

package/browser/out/browser/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Browser entry point for `@reteps/tree-sitter-htmlmustache`.
+ *
+ * Exposes `createLinter({ locateWasm, prettier? })` returning a handle with
+ * `lint(source, config)` and `format(source, config, opts)`. Internally reuses
+ * the shared rule engine and formatter in `src/core/` — browser-safe, no fs.
+ */
+import type { PrettierLike } from '../core/formatting/embedded.js';
+import type { Diagnostic } from '../core/diagnostic.js';
+import type { HtmlMustacheConfig, RulesConfig, RuleSeverity, CustomRule as CustomRuleType } from '../core/configSchema.js';
+import type { CustomCodeTagConfig } from '../core/customCodeTags.js';
+export type Config = Omit<HtmlMustacheConfig, 'include' | 'exclude'>;
+export type CustomRule = CustomRuleType;
+export type CustomTag = CustomCodeTagConfig;
+export type { RulesConfig, RuleSeverity, PrettierLike, Diagnostic };
+export type LocateWasm = string | ((filename: string) => string);
+export interface CreateLinterOptions {
+    /**
+     * Locates the grammar WASM (`tree-sitter-htmlmustache.wasm`). If a string,
+     * treated as the URL for the grammar — web-tree-sitter's own
+     * `tree-sitter.wasm` will resolve via its default `locateFile`. Pass a
+     * callback to resolve both names explicitly.
+     */
+    locateWasm: LocateWasm;
+    /** Default prettier used for embedded-region formatting. */
+    prettier?: PrettierLike;
+}
+export interface FormatOptions {
+    /** Override the factory-level prettier for this call. */
+    prettier?: PrettierLike;
+}
+export interface Linter {
+    lint(source: string, config?: Config): Diagnostic[];
+    format(source: string, config?: Config, opts?: FormatOptions): Promise<string>;
+}
+/** Default severities for every built-in rule. */
+export declare const DEFAULT_CONFIG: Config;
+/**
+ * Create a linter/formatter handle. Consumers should cache the result — each
+ * call reloads the grammar WASM.
+ */
+export declare function createLinter(opts: CreateLinterOptions): Promise<Linter>;
+//# sourceMappingURL=index.d.ts.map

package/browser/out/browser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAGnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,KAAK,EACV,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,UAAU,IAAI,cAAc,EAC7B,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE,MAAM,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,EAAE,SAAS,GAAG,SAAS,CAAC,CAAC;AACrE,MAAM,MAAM,UAAU,GAAG,cAAc,CAAC;AACxC,MAAM,MAAM,SAAS,GAAG,mBAAmB,CAAC;AAC5C,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;AAEpE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;AAEjE,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,UAAU,EAAE,UAAU,CAAC;IACvB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE,CAAC;IACpD,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAChF;AAED,kDAAkD;AAClD,eAAO,MAAM,cAAc,EAAE,MAAgD,CAAC;AAc9E;;;GAGG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiD7E"}