@fluixi/template-parser 0.1.0-alpha.4 → 1.0.0-alpha.99

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Fluixi
+Copyright (c) 2026 Ibrahima Touré
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dist/a11y.cjs

@@ -1 +1,100 @@
-"use strict";var c=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var m=Object.prototype.hasOwnProperty;var b=(e,t)=>{for(var n in t)c(e,n,{get:t[n],enumerable:!0})},h=(e,t,n,a)=>{if(t&&typeof t=="object"||typeof t=="function")for(let i of f(t))!m.call(e,i)&&i!==n&&c(e,i,{get:()=>t[i],enumerable:!(a=u(t,i))||a.enumerable});return e};var g=e=>h(c({},"__esModule",{value:!0}),e);var A={};b(A,{checkAccessibility:()=>v});module.exports=g(A);var N=new Set(["a","button","input","select","textarea","summary","details","option","label"]),k=new Set(["keydown","keyup","keypress"]);function r(e,t){return e.attributes.find(n=>"name"in n&&n.name===t)}function E(e){return e.attributes.some(t=>t.kind==="Spread")}function d(e,t){let n=r(e,t);if(!n||n.kind!=="Attribute"||!n.value)return;let a=n.value;return a.kind==="static"?a.value:void 0}function y(e){let t=d(e,"role");return t==="presentation"||t==="none"?!0:d(e,"aria-hidden")==="true"}function l(e,t){return e.attributes.some(n=>n.kind==="EventBinding"&&t(n.name))}function v(e){let t=[],n=(i,o,s)=>{t.push({code:o,message:s,severity:"warning",loc:i.loc})},a=i=>{for(let o of i){o.kind==="Element"&&p(o,n);let s="children"in o?o.children:void 0;s&&a(s)}};return a(e.children),t}function p(e,t){if(E(e))return;let n=e.tag.toLowerCase();n==="img"&&!r(e,"alt")&&!y(e)&&t(e,"a11y-img-alt",'An `img` needs an `alt`. Use `alt=""` when the image is decorative.'),n==="a"&&!r(e,"href")&&!r(e,"role")&&t(e,"a11y-anchor-href","An `a` without `href` is not a link. Use a `button` for an action."),n==="iframe"&&!r(e,"title")&&t(e,"a11y-iframe-title","An `iframe` needs a `title` describing its content.");let a=d(e,"tabindex")??d(e,"tabIndex");a!==void 0&&Number(a)>0&&t(e,"a11y-positive-tabindex","A positive `tabindex` reorders tab navigation for the entire page. Use `0`, or restructure the markup."),!N.has(n)&&l(e,i=>i==="click")&&!r(e,"role")&&!l(e,i=>k.has(i))&&t(e,"a11y-click-without-keyboard",`A click handler on \`${n}\` is unreachable by keyboard. Use a \`button\`, or add a \`role\` and a key handler.`)}
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/a11y.ts
+var a11y_exports = {};
+__export(a11y_exports, {
+  checkAccessibility: () => checkAccessibility
+});
+module.exports = __toCommonJS(a11y_exports);
+var INTERACTIVE = /* @__PURE__ */ new Set([
+  "a",
+  "button",
+  "input",
+  "select",
+  "textarea",
+  "summary",
+  "details",
+  "option",
+  "label"
+]);
+var KEY_EVENTS = /* @__PURE__ */ new Set(["keydown", "keyup", "keypress"]);
+function attributeNamed(node, name) {
+  return node.attributes.find((a) => "name" in a && a.name === name);
+}
+function hasSpread(node) {
+  return node.attributes.some((a) => a.kind === "Spread");
+}
+function staticValue(node, name) {
+  const attribute = attributeNamed(node, name);
+  if (!attribute || attribute.kind !== "Attribute" || !attribute.value) return void 0;
+  const value = attribute.value;
+  return value.kind === "static" ? value.value : void 0;
+}
+function isPresentational(node) {
+  const role = staticValue(node, "role");
+  if (role === "presentation" || role === "none") return true;
+  return staticValue(node, "aria-hidden") === "true";
+}
+function hasEvent(node, predicate) {
+  return node.attributes.some((a) => a.kind === "EventBinding" && predicate(a.name));
+}
+function checkAccessibility(root) {
+  const out = [];
+  const report = (node, code, message) => {
+    out.push({ code, message, severity: "warning", loc: node.loc });
+  };
+  const visit = (nodes) => {
+    for (const node of nodes) {
+      if (node.kind === "Element") check(node, report);
+      const children = "children" in node ? node.children : void 0;
+      if (children) visit(children);
+    }
+  };
+  visit(root.children);
+  return out;
+}
+function check(node, report) {
+  if (hasSpread(node)) return;
+  const tag = node.tag.toLowerCase();
+  if (tag === "img" && !attributeNamed(node, "alt") && !isPresentational(node)) {
+    report(node, "a11y-img-alt", 'An `img` needs an `alt`. Use `alt=""` when the image is decorative.');
+  }
+  if (tag === "a" && !attributeNamed(node, "href") && !attributeNamed(node, "role")) {
+    report(node, "a11y-anchor-href", "An `a` without `href` is not a link. Use a `button` for an action.");
+  }
+  if (tag === "iframe" && !attributeNamed(node, "title")) {
+    report(node, "a11y-iframe-title", "An `iframe` needs a `title` describing its content.");
+  }
+  const tabindex = staticValue(node, "tabindex") ?? staticValue(node, "tabIndex");
+  if (tabindex !== void 0 && Number(tabindex) > 0) {
+    report(
+      node,
+      "a11y-positive-tabindex",
+      "A positive `tabindex` reorders tab navigation for the entire page. Use `0`, or restructure the markup."
+    );
+  }
+  if (!INTERACTIVE.has(tag) && hasEvent(node, (name) => name === "click") && !attributeNamed(node, "role") && !hasEvent(node, (name) => KEY_EVENTS.has(name))) {
+    report(
+      node,
+      "a11y-click-without-keyboard",
+      `A click handler on \`${tag}\` is unreachable by keyboard. Use a \`button\`, or add a \`role\` and a key handler.`
+    );
+  }
+}

package/dist/a11y.d.cts

@@ -0,0 +1,21 @@
+/**
+ * Accessibility rules over the template AST.
+ *
+ * These live in the parser, not in a consumer, because both the language service
+ * and the compiler already parse templates: a rule written here reaches the
+ * editor and the build from one implementation.
+ *
+ * Every rule is structural: no types, no scope analysis, no guessing. A rule that
+ * cannot be certain stays silent, because an accessibility warning that cries wolf
+ * gets switched off and then the real ones are lost too. That is why anything
+ * carrying a spread is skipped: the spread may supply the very attribute the rule
+ * is looking for, and there is no way to know from the template alone.
+ */
+import type { Diagnostic, RootNode } from './ast.cjs';
+/**
+ * Collect accessibility diagnostics for a parsed template.
+ *
+ * Reported as warnings: they describe a real barrier, but none of them make the
+ * template invalid, and failing a build on them would be the wrong trade.
+ */
+export declare function checkAccessibility(root: RootNode): Diagnostic[];

package/dist/a11y.d.ts

@@ -2,13 +2,13 @@
  * Accessibility rules over the template AST.
  *
  * These live in the parser, not in a consumer, because both the language service
- * and the compiler already parse templates — a rule written here reaches the
+ * and the compiler already parse templates: a rule written here reaches the
  * editor and the build from one implementation.
  *
  * Every rule is structural: no types, no scope analysis, no guessing. A rule that
  * cannot be certain stays silent, because an accessibility warning that cries wolf
  * gets switched off and then the real ones are lost too. That is why anything
- * carrying a spread is skipped — the spread may supply the very attribute the rule
+ * carrying a spread is skipped: the spread may supply the very attribute the rule
  * is looking for, and there is no way to know from the template alone.
  */
 import type { Diagnostic, RootNode } from './ast.js';

package/dist/a11y.js

@@ -70,7 +70,7 @@ function check(node, report) {
         report(node, 'a11y-iframe-title', 'An `iframe` needs a `title` describing its content.');
     }
     // A positive tabindex overrides document order for the whole page, not just
-    // this element — the classic way to make keyboard navigation unpredictable.
+    // this element: the classic way to make keyboard navigation unpredictable.
     const tabindex = staticValue(node, 'tabindex') ?? staticValue(node, 'tabIndex');
     if (tabindex !== undefined && Number(tabindex) > 0) {
         report(node, 'a11y-positive-tabindex', 'A positive `tabindex` reorders tab navigation for the entire page. Use `0`, or restructure the markup.');

package/dist/a11y.mjs

@@ -1 +1,79 @@
-var l=new Set(["a","button","input","select","textarea","summary","details","option","label"]),u=new Set(["keydown","keyup","keypress"]);function r(e,t){return e.attributes.find(n=>"name"in n&&n.name===t)}function f(e){return e.attributes.some(t=>t.kind==="Spread")}function d(e,t){let n=r(e,t);if(!n||n.kind!=="Attribute"||!n.value)return;let i=n.value;return i.kind==="static"?i.value:void 0}function m(e){let t=d(e,"role");return t==="presentation"||t==="none"?!0:d(e,"aria-hidden")==="true"}function c(e,t){return e.attributes.some(n=>n.kind==="EventBinding"&&t(n.name))}function h(e){let t=[],n=(a,o,s)=>{t.push({code:o,message:s,severity:"warning",loc:a.loc})},i=a=>{for(let o of a){o.kind==="Element"&&b(o,n);let s="children"in o?o.children:void 0;s&&i(s)}};return i(e.children),t}function b(e,t){if(f(e))return;let n=e.tag.toLowerCase();n==="img"&&!r(e,"alt")&&!m(e)&&t(e,"a11y-img-alt",'An `img` needs an `alt`. Use `alt=""` when the image is decorative.'),n==="a"&&!r(e,"href")&&!r(e,"role")&&t(e,"a11y-anchor-href","An `a` without `href` is not a link. Use a `button` for an action."),n==="iframe"&&!r(e,"title")&&t(e,"a11y-iframe-title","An `iframe` needs a `title` describing its content.");let i=d(e,"tabindex")??d(e,"tabIndex");i!==void 0&&Number(i)>0&&t(e,"a11y-positive-tabindex","A positive `tabindex` reorders tab navigation for the entire page. Use `0`, or restructure the markup."),!l.has(n)&&c(e,a=>a==="click")&&!r(e,"role")&&!c(e,a=>u.has(a))&&t(e,"a11y-click-without-keyboard",`A click handler on \`${n}\` is unreachable by keyboard. Use a \`button\`, or add a \`role\` and a key handler.`)}export{h as checkAccessibility};
+// src/a11y.ts
+var INTERACTIVE = /* @__PURE__ */ new Set([
+  "a",
+  "button",
+  "input",
+  "select",
+  "textarea",
+  "summary",
+  "details",
+  "option",
+  "label"
+]);
+var KEY_EVENTS = /* @__PURE__ */ new Set(["keydown", "keyup", "keypress"]);
+function attributeNamed(node, name) {
+  return node.attributes.find((a) => "name" in a && a.name === name);
+}
+function hasSpread(node) {
+  return node.attributes.some((a) => a.kind === "Spread");
+}
+function staticValue(node, name) {
+  const attribute = attributeNamed(node, name);
+  if (!attribute || attribute.kind !== "Attribute" || !attribute.value) return void 0;
+  const value = attribute.value;
+  return value.kind === "static" ? value.value : void 0;
+}
+function isPresentational(node) {
+  const role = staticValue(node, "role");
+  if (role === "presentation" || role === "none") return true;
+  return staticValue(node, "aria-hidden") === "true";
+}
+function hasEvent(node, predicate) {
+  return node.attributes.some((a) => a.kind === "EventBinding" && predicate(a.name));
+}
+function checkAccessibility(root) {
+  const out = [];
+  const report = (node, code, message) => {
+    out.push({ code, message, severity: "warning", loc: node.loc });
+  };
+  const visit = (nodes) => {
+    for (const node of nodes) {
+      if (node.kind === "Element") check(node, report);
+      const children = "children" in node ? node.children : void 0;
+      if (children) visit(children);
+    }
+  };
+  visit(root.children);
+  return out;
+}
+function check(node, report) {
+  if (hasSpread(node)) return;
+  const tag = node.tag.toLowerCase();
+  if (tag === "img" && !attributeNamed(node, "alt") && !isPresentational(node)) {
+    report(node, "a11y-img-alt", 'An `img` needs an `alt`. Use `alt=""` when the image is decorative.');
+  }
+  if (tag === "a" && !attributeNamed(node, "href") && !attributeNamed(node, "role")) {
+    report(node, "a11y-anchor-href", "An `a` without `href` is not a link. Use a `button` for an action.");
+  }
+  if (tag === "iframe" && !attributeNamed(node, "title")) {
+    report(node, "a11y-iframe-title", "An `iframe` needs a `title` describing its content.");
+  }
+  const tabindex = staticValue(node, "tabindex") ?? staticValue(node, "tabIndex");
+  if (tabindex !== void 0 && Number(tabindex) > 0) {
+    report(
+      node,
+      "a11y-positive-tabindex",
+      "A positive `tabindex` reorders tab navigation for the entire page. Use `0`, or restructure the markup."
+    );
+  }
+  if (!INTERACTIVE.has(tag) && hasEvent(node, (name) => name === "click") && !attributeNamed(node, "role") && !hasEvent(node, (name) => KEY_EVENTS.has(name))) {
+    report(
+      node,
+      "a11y-click-without-keyboard",
+      `A click handler on \`${tag}\` is unreachable by keyboard. Use a \`button\`, or add a \`role\` and a key handler.`
+    );
+  }
+}
+export {
+  checkAccessibility
+};

package/dist/ast.cjs

@@ -1 +1,46 @@
-"use strict";var r=Object.defineProperty;var s=Object.getOwnPropertyDescriptor;var l=Object.getOwnPropertyNames;var c=Object.prototype.hasOwnProperty;var p=(e,t)=>{for(var n in t)r(e,n,{get:t[n],enumerable:!0})},N=(e,t,n,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let i of l(t))!c.call(e,i)&&i!==n&&r(e,i,{get:()=>t[i],enumerable:!(o=s(t,i))||o.enumerable});return e};var m=e=>N(r({},"__esModule",{value:!0}),e);var u={};p(u,{childrenOf:()=>d,setParents:()=>x});module.exports=m(u);function x(e){let t=(n,o)=>{n.parent=o;let i=d(n);for(let a of i)t(a,n)};return t(e,null),e}function d(e){switch(e.kind){case"Root":case"Element":case"Component":case"Fragment":return e.children;default:return[]}}
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/ast.ts
+var ast_exports = {};
+__export(ast_exports, {
+  childrenOf: () => childrenOf,
+  setParents: () => setParents
+});
+module.exports = __toCommonJS(ast_exports);
+function setParents(root) {
+  const visit = (node, parent) => {
+    node.parent = parent;
+    const kids = childrenOf(node);
+    for (const child of kids) visit(child, node);
+  };
+  visit(root, null);
+  return root;
+}
+function childrenOf(node) {
+  switch (node.kind) {
+    case "Root":
+    case "Element":
+    case "Component":
+    case "Fragment":
+      return node.children;
+    default:
+      return [];
+  }
+}

package/dist/ast.d.cts

@@ -0,0 +1,223 @@
+/**
+ * The Template AST: the stable, host-agnostic contract this package exists to
+ * produce. It is deliberately NOT the compiler's codegen IR: it models the
+ * template *as written* (every directive is an explicit node, every node keeps
+ * a source span, whitespace is preserved) so it can power the compiler AND the
+ * language server, TypeScript plugin, and Biome/formatter alike.
+ *
+ * Design rules baked into these types:
+ *  - Expression holes (`${…}`) are OPAQUE SLOTS. A node stores the hole's
+ *    integer `index` (its position in the template's `expressions[]`) and its
+ *    source span: never resolved JS. Each consumer binds a slot to its own
+ *    representation afterward (a Babel node in the compiler, a `ts.Expression`
+ *    in the LSP, raw text in Biome). This single seam is what lets one parser
+ *    serve every downstream tool.
+ *  - Directives are explicit node kinds, never stringly-typed attributes.
+ *  - Every node carries `loc`, `kind`, and (via the tree walk) a `parent`.
+ */
+/** A half-open source span `[start, end)` in template-coordinate space. */
+export interface SourceSpan {
+    start: number;
+    end: number;
+}
+/** Namespaces the parser tracks so SVG (and foreign content) lower correctly. */
+export type Namespace = 'html' | 'svg' | 'mathml';
+export type NodeKind = 'Root' | 'Element' | 'Component' | 'Fragment' | 'Text' | 'Comment' | 'Expression';
+export type AttrKind = 'Attribute' | 'PropertyBinding' | 'EventBinding' | 'RefBinding' | 'Spread' | 'IfDirective' | 'ElseDirective' | 'EachDirective' | 'BindDirective' | 'ClassDirective' | 'StyleDirective' | 'UseDirective' | 'LoadDirective' | 'Slot';
+/** Fields shared by every node. `parent` is wired by {@link setParents}. */
+export interface NodeBase {
+    loc: SourceSpan;
+    parent?: TemplateNode | null;
+    /** Free-form bag for downstream passes (binding results, type info, etc.). */
+    metadata?: Record<string, unknown>;
+}
+export type TemplateNode = RootNode | ElementNode | ComponentNode | FragmentNode | TextNode | CommentNode | ExpressionNode;
+/** Anything that can attach to an element/component opening tag. */
+export type AttributeLikeNode = AttributeNode | PropertyBindingNode | EventBindingNode | RefBindingNode | SpreadNode | IfDirectiveNode | ElseDirectiveNode | EachDirectiveNode | BindDirectiveNode | ClassDirectiveNode | StyleDirectiveNode | UseDirectiveNode | LoadDirectiveNode | SlotNode;
+export interface RootNode extends NodeBase {
+    kind: 'Root';
+    children: TemplateNode[];
+}
+export interface ElementNode extends NodeBase {
+    kind: 'Element';
+    tag: string;
+    namespace: Namespace;
+    attributes: AttributeLikeNode[];
+    children: TemplateNode[];
+    selfClosing: boolean;
+    /** Raw-text element (`script`/`style`/`textarea`/`title`), children kept verbatim. */
+    rawText: boolean;
+}
+export interface ComponentNode extends NodeBase {
+    kind: 'Component';
+    /** Capitalized name or member path (`Ctx.Provider`) as written; '' for a dynamic tag. */
+    tag: string;
+    /**
+     * Dynamic tag `<${Comp} />`: the hole index of the component expression. When
+     * set, `tag` is '' and the component identity comes from this hole, which
+     * also means the referenced binding is visible to TypeScript (no "unused").
+     */
+    tagHole: number | null;
+    attributes: AttributeLikeNode[];
+    children: TemplateNode[];
+    selfClosing: boolean;
+}
+export interface FragmentNode extends NodeBase {
+    kind: 'Fragment';
+    children: TemplateNode[];
+}
+/** Preserved verbatim (raw); whitespace normalization is a lowering concern. */
+export interface TextNode extends NodeBase {
+    kind: 'Text';
+    value: string;
+    /** Inside a raw-text element: do not whitespace-normalize when lowering. */
+    raw: boolean;
+}
+export interface CommentNode extends NodeBase {
+    kind: 'Comment';
+    value: string;
+}
+/** A `${…}` in child/text position. */
+export interface ExpressionNode extends NodeBase {
+    kind: 'Expression';
+    hole: number;
+}
+/** A single interpolation part of an attribute value. */
+export type ValuePart = {
+    text: string;
+} | {
+    hole: number;
+};
+/**
+ * `name`, `name="static"`, `name=${x}`, `name="a ${x} b"`, `?bool`, `?bool=${x}`.
+ * `value === null` is a valueless attribute (boolean true). `boolean` marks the
+ * lit `?name` prefix.
+ */
+export interface AttributeNode extends NodeBase {
+    kind: 'Attribute';
+    name: string;
+    value: AttrValue | null;
+    boolean: boolean;
+}
+export type AttrValue = {
+    kind: 'static';
+    value: string;
+} | {
+    kind: 'hole';
+    hole: number;
+} | {
+    kind: 'mixed';
+    parts: ValuePart[];
+};
+/** `.prop=${x}`: DOM property binding. */
+export interface PropertyBindingNode extends NodeBase {
+    kind: 'PropertyBinding';
+    name: string;
+    hole: number;
+}
+/**
+ * `@click=${h}`, `onClick=${h}`, or `on:click=${h}`, with optional dotted
+ * modifiers (`@click.capture.once`, `on:input.passive`). `syntax` is `'colon'`
+ * for the `on:name` form (a native listener), `'at'` for `@name`, `'on'` for the
+ * `onName` camelCase form.
+ */
+export interface EventBindingNode extends NodeBase {
+    kind: 'EventBinding';
+    /** Lowercased DOM event name (`click`). */
+    name: string;
+    syntax: 'at' | 'on' | 'colon';
+    /** Dotted modifiers: capture/once/passive (listener options) + prevent/stop/self. */
+    modifiers: string[];
+    hole: number;
+}
+/** `ref=${el}`. */
+export interface RefBindingNode extends NodeBase {
+    kind: 'RefBinding';
+    hole: number;
+}
+/** `...${props}`. */
+export interface SpreadNode extends NodeBase {
+    kind: 'Spread';
+    hole: number;
+}
+/** `if=${cond}`. */
+export interface IfDirectiveNode extends NodeBase {
+    kind: 'IfDirective';
+    hole: number;
+}
+/** `else` (valueless). */
+export interface ElseDirectiveNode extends NodeBase {
+    kind: 'ElseDirective';
+}
+/** `each=${items}` with optional `key="id"` / `key=${…}`. */
+export interface EachDirectiveNode extends NodeBase {
+    kind: 'EachDirective';
+    hole: number;
+    key: {
+        static: string;
+    } | {
+        hole: number;
+    } | null;
+}
+/** `bind:value=${signal}`. */
+export interface BindDirectiveNode extends NodeBase {
+    kind: 'BindDirective';
+    name: string;
+    hole: number;
+}
+/** `class:active=${flag}`. */
+export interface ClassDirectiveNode extends NodeBase {
+    kind: 'ClassDirective';
+    name: string;
+    hole: number;
+}
+/** `style:color=${c}`. */
+export interface StyleDirectiveNode extends NodeBase {
+    kind: 'StyleDirective';
+    name: string;
+    hole: number;
+}
+/**
+ * `load:visible`, `load:interaction="click"`, …: when the component's module is
+ * fetched.
+ *
+ * The node carries the strategy and its literal modifier as written; turning that into
+ * a load plan is the compiler's job, so the parser stays free of module semantics ,
+ * the same reason resolution has no syntax here either.
+ */
+export interface LoadDirectiveNode extends NodeBase {
+    kind: 'LoadDirective';
+    /** The part after `load:`, unvalidated: the compiler reports unknown strategies. */
+    strategy: string;
+    /** `load:visible="200px"` → `'200px'`. Null for a bare directive. */
+    modifier: string | null;
+}
+/** `use=${directive}` or `use:tooltip` (optionally `use:tooltip=${opts}`). */
+export interface UseDirectiveNode extends NodeBase {
+    kind: 'UseDirective';
+    /** Named form `use:tooltip` carries the name; bare `use=${d}` leaves it null. */
+    name: string | null;
+    hole: number | null;
+}
+/** `<slot>` element or `slot="name"` marker (reserved; wired in a later phase). */
+export interface SlotNode extends NodeBase {
+    kind: 'Slot';
+    name: string | null;
+}
+export type Severity = 'error' | 'warning';
+export interface Diagnostic {
+    code: DiagnosticCode;
+    message: string;
+    severity: Severity;
+    loc: SourceSpan;
+}
+export type DiagnosticCode = 'unclosed-tag' | 'mismatched-close-tag' | 'stray-close-tag' | 'unclosed-comment' | 'duplicate-directive' | 'else-without-if' | 'invalid-directive' | 'invalid-binding' | 'unsupported-combination' | 'a11y-img-alt' | 'a11y-anchor-href' | 'a11y-iframe-title' | 'a11y-positive-tabindex' | 'a11y-click-without-keyboard';
+/** The full result of a parse: the tree plus any recovered-from problems. */
+export interface ParseResult {
+    root: RootNode;
+    diagnostics: Diagnostic[];
+}
+/** Wire every node's `parent` pointer by walking the tree once. */
+export declare function setParents(root: RootNode): RootNode;
+/** The content children of a node (attributes are not content children). */
+export declare function childrenOf(node: TemplateNode): TemplateNode[];

package/dist/ast.d.ts

@@ -1,5 +1,5 @@
 /**
- * The Template AST — the stable, host-agnostic contract this package exists to
+ * The Template AST: the stable, host-agnostic contract this package exists to
  * produce. It is deliberately NOT the compiler's codegen IR: it models the
  * template *as written* (every directive is an explicit node, every node keeps
  * a source span, whitespace is preserved) so it can power the compiler AND the
@@ -8,7 +8,7 @@
  * Design rules baked into these types:
  *  - Expression holes (`${…}`) are OPAQUE SLOTS. A node stores the hole's
  *    integer `index` (its position in the template's `expressions[]`) and its
- *    source span — never resolved JS. Each consumer binds a slot to its own
+ *    source span: never resolved JS. Each consumer binds a slot to its own
  *    representation afterward (a Babel node in the compiler, a `ts.Expression`
  *    in the LSP, raw text in Biome). This single seam is what lets one parser
  *    serve every downstream tool.
@@ -45,7 +45,7 @@ export interface ElementNode extends NodeBase {
     attributes: AttributeLikeNode[];
     children: TemplateNode[];
     selfClosing: boolean;
-    /** Raw-text element (`script`/`style`/`textarea`/`title`) — children kept verbatim. */
+    /** Raw-text element (`script`/`style`/`textarea`/`title`), children kept verbatim. */
     rawText: boolean;
 }
 export interface ComponentNode extends NodeBase {
@@ -54,7 +54,7 @@ export interface ComponentNode extends NodeBase {
     tag: string;
     /**
      * Dynamic tag `<${Comp} />`: the hole index of the component expression. When
-     * set, `tag` is '' and the component identity comes from this hole — which
+     * set, `tag` is '' and the component identity comes from this hole, which
      * also means the referenced binding is visible to TypeScript (no "unused").
      */
     tagHole: number | null;
@@ -70,7 +70,7 @@ export interface FragmentNode extends NodeBase {
 export interface TextNode extends NodeBase {
     kind: 'Text';
     value: string;
-    /** Inside a raw-text element — do not whitespace-normalize when lowering. */
+    /** Inside a raw-text element: do not whitespace-normalize when lowering. */
     raw: boolean;
 }
 export interface CommentNode extends NodeBase {
@@ -109,7 +109,7 @@ export type AttrValue = {
     kind: 'mixed';
     parts: ValuePart[];
 };
-/** `.prop=${x}` — DOM property binding. */
+/** `.prop=${x}`: DOM property binding. */
 export interface PropertyBindingNode extends NodeBase {
     kind: 'PropertyBinding';
     name: string;
@@ -178,16 +178,16 @@ export interface StyleDirectiveNode extends NodeBase {
     hole: number;
 }
 /**
- * `load:visible`, `load:interaction="click"`, … — when the component's module is
+ * `load:visible`, `load:interaction="click"`, …: when the component's module is
  * fetched.
  *
  * The node carries the strategy and its literal modifier as written; turning that into
- * a load plan is the compiler's job, so the parser stays free of module semantics —
+ * a load plan is the compiler's job, so the parser stays free of module semantics ,
  * the same reason resolution has no syntax here either.
  */
 export interface LoadDirectiveNode extends NodeBase {
     kind: 'LoadDirective';
-    /** The part after `load:`, unvalidated — the compiler reports unknown strategies. */
+    /** The part after `load:`, unvalidated: the compiler reports unknown strategies. */
     strategy: string;
     /** `load:visible="200px"` → `'200px'`. Null for a bare directive. */
     modifier: string | null;

package/dist/ast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ast.d.ts","sourceRoot":"","sources":["../src/ast.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ast.d.ts","sourceRoot":"","sources":["../src/ast.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,2EAA2E;AAC3E,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,iFAAiF;AACjF,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;AAMlD,MAAM,MAAM,QAAQ,GAChB,MAAM,GACN,SAAS,GACT,WAAW,GACX,UAAU,GACV,MAAM,GACN,SAAS,GACT,YAAY,CAAC;AAEjB,MAAM,MAAM,QAAQ,GAChB,WAAW,GACX,iBAAiB,GACjB,cAAc,GACd,YAAY,GACZ,QAAQ,GACR,aAAa,GACb,eAAe,GACf,eAAe,GACf,eAAe,GACf,gBAAgB,GAChB,gBAAgB,GAChB,cAAc,GACd,eAAe,GACf,MAAM,CAAC;AAEX,4EAA4E;AAC5E,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,UAAU,CAAC;IAChB,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,WAAW,GACX,aAAa,GACb,YAAY,GACZ,QAAQ,GACR,WAAW,GACX,cAAc,CAAC;AAEnB,oEAAoE;AACpE,MAAM,MAAM,iBAAiB,GACzB,aAAa,GACb,mBAAmB,GACnB,gBAAgB,GAChB,cAAc,GACd,UAAU,GACV,eAAe,GACf,iBAAiB,GACjB,iBAAiB,GACjB,iBAAiB,GACjB,kBAAkB,GAClB,kBAAkB,GAClB,gBAAgB,GAChB,iBAAiB,GACjB,QAAQ,CAAC;AAMb,MAAM,WAAW,QAAS,SAAQ,QAAQ;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,WAAY,SAAQ,QAAQ;IAC3C,IAAI,EAAE,SAAS,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,sFAAsF;IACtF,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAc,SAAQ,QAAQ;IAC7C,IAAI,EAAE,WAAW,CAAC;IAClB,yFAAyF;IACzF,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,YAAa,SAAQ,QAAQ;IAC5C,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,gFAAgF;AAChF,MAAM,WAAW,QAAS,SAAQ,QAAQ;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,WAAY,SAAQ,QAAQ;IAC3C,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,uCAAuC;AACvC,MAAM,WAAW,cAAe,SAAQ,QAAQ;IAC9C,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAMD,yDAAyD;AACzD,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5D;;;;GAIG;AACH,MAAM,WAAW,aAAc,SAAQ,QAAQ;IAC7C,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,SAAS,EAAE,CAAA;CAAE,CAAC;AAE1C,0CAA0C;AAC1C,MAAM,WAAW,mBAAoB,SAAQ,QAAQ;IACnD,IAAI,EAAE,iBAAiB,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAiB,SAAQ,QAAQ;IAChD,IAAI,EAAE,cAAc,CAAC;IACrB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,IAAI,GAAG,IAAI,GAAG,OAAO,CAAC;IAC9B,qFAAqF;IACrF,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,mBAAmB;AACnB,MAAM,WAAW,cAAe,SAAQ,QAAQ;IAC9C,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAqB;AACrB,MAAM,WAAW,UAAW,SAAQ,QAAQ;IAC1C,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,oBAAoB;AACpB,MAAM,WAAW,eAAgB,SAAQ,QAAQ;IAC/C,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,0BAA0B;AAC1B,MAAM,WAAW,iBAAkB,SAAQ,QAAQ;IACjD,IAAI,EAAE,eAAe,CAAC;CACvB;AAED,6DAA6D;AAC7D,MAAM,WAAW,iBAAkB,SAAQ,QAAQ;IACjD,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACnD;AAED,8BAA8B;AAC9B,MAAM,WAAW,iBAAkB,SAAQ,QAAQ;IACjD,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,8BAA8B;AAC9B,MAAM,WAAW,kBAAmB,SAAQ,QAAQ;IAClD,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,0BAA0B;AAC1B,MAAM,WAAW,kBAAmB,SAAQ,QAAQ;IAClD,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAkB,SAAQ,QAAQ;IACjD,IAAI,EAAE,eAAe,CAAC;IACtB,oFAAoF;IACpF,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,8EAA8E;AAC9E,MAAM,WAAW,gBAAiB,SAAQ,QAAQ;IAChD,IAAI,EAAE,cAAc,CAAC;IACrB,iFAAiF;IACjF,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,mFAAmF;AACnF,MAAM,WAAW,QAAS,SAAQ,QAAQ;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAMD,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAE3C,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;IACnB,GAAG,EAAE,UAAU,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GACtB,cAAc,GACd,sBAAsB,GACtB,iBAAiB,GACjB,kBAAkB,GAClB,qBAAqB,GACrB,iBAAiB,GACjB,mBAAmB,GACnB,iBAAiB,GACjB,yBAAyB,GAGzB,cAAc,GACd,kBAAkB,GAClB,mBAAmB,GACnB,wBAAwB,GACxB,6BAA6B,CAAC;AAElC,6EAA6E;AAC7E,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAMD,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAQnD;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,EAAE,CAU7D"}

package/dist/ast.js

@@ -1,5 +1,5 @@
 /**
- * The Template AST — the stable, host-agnostic contract this package exists to
+ * The Template AST: the stable, host-agnostic contract this package exists to
  * produce. It is deliberately NOT the compiler's codegen IR: it models the
  * template *as written* (every directive is an explicit node, every node keeps
  * a source span, whitespace is preserved) so it can power the compiler AND the
@@ -8,7 +8,7 @@
  * Design rules baked into these types:
  *  - Expression holes (`${…}`) are OPAQUE SLOTS. A node stores the hole's
  *    integer `index` (its position in the template's `expressions[]`) and its
- *    source span — never resolved JS. Each consumer binds a slot to its own
+ *    source span: never resolved JS. Each consumer binds a slot to its own
  *    representation afterward (a Babel node in the compiler, a `ts.Expression`
  *    in the LSP, raw text in Biome). This single seam is what lets one parser
  *    serve every downstream tool.

package/dist/ast.mjs

@@ -1 +1,25 @@
-function a(e){let n=(t,i)=>{t.parent=i;let o=d(t);for(let r of o)n(r,t)};return n(e,null),e}function d(e){switch(e.kind){case"Root":case"Element":case"Component":case"Fragment":return e.children;default:return[]}}export{d as childrenOf,a as setParents};
+// src/ast.ts
+function setParents(root) {
+  const visit = (node, parent) => {
+    node.parent = parent;
+    const kids = childrenOf(node);
+    for (const child of kids) visit(child, node);
+  };
+  visit(root, null);
+  return root;
+}
+function childrenOf(node) {
+  switch (node.kind) {
+    case "Root":
+    case "Element":
+    case "Component":
+    case "Fragment":
+      return node.children;
+    default:
+      return [];
+  }
+}
+export {
+  childrenOf,
+  setParents
+};