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

package/dist/directives.cjs

@@ -1 +1,206 @@
-"use strict";var c=Object.defineProperty;var v=Object.getOwnPropertyDescriptor;var m=Object.getOwnPropertyNames;var h=Object.prototype.hasOwnProperty;var b=(e,i)=>{for(var t in i)c(e,t,{get:i[t],enumerable:!0})},p=(e,i,t,n)=>{if(i&&typeof i=="object"||typeof i=="function")for(let o of m(i))!h.call(e,o)&&o!==t&&c(e,o,{get:()=>i[o],enumerable:!(n=v(i,o))||n.enumerable});return e};var f=e=>p(c({},"__esModule",{value:!0}),e);var g={};b(g,{CORE_DIRECTIVES:()=>a,EVENT_MODIFIERS:()=>d,resolveAttribute:()=>D});module.exports=f(g);var d=new Set(["capture","once","passive","prevent","stop","self"]);function l(e,i){return e.value&&e.value.kind==="hole"?e.value.hole:(e.report("invalid-binding",`${i} requires an expression value: ${e.name}=\${…}`),-1)}var s=(e,i)=>({kind:"Attribute",name:i?e.name.slice(1):e.name,value:e.value,boolean:i,loc:e.loc}),a=[{id:"event",match:e=>e[0]==="@"||e.startsWith("on:")||/^on[A-Z]/.test(e),build:e=>{let i,t;e.name[0]==="@"?(i="at",t=e.name.slice(1)):e.name.startsWith("on:")?(i="colon",t=e.name.slice(3)):(i="on",t=e.name.slice(2));let[n,...o]=t.split("."),u=n.toLowerCase();for(let r of o)d.has(r)||e.report("invalid-directive",`Unknown event modifier ".${r}" — expected one of ${[...d].join(", ")}`);return{kind:"EventBinding",name:u,syntax:i,modifiers:o,hole:l(e,"event binding"),loc:e.loc}}},{id:"bind",elementOnly:!0,match:e=>e.startsWith("bind:"),build:e=>({kind:"BindDirective",name:e.name.slice(5),hole:l(e,"two-way binding"),loc:e.loc})},{id:"class-directive",elementOnly:!0,match:e=>e.startsWith("class:"),build:e=>({kind:"ClassDirective",name:e.name.slice(6),hole:l(e,"class directive"),loc:e.loc})},{id:"style-directive",elementOnly:!0,match:e=>e.startsWith("style:"),build:e=>({kind:"StyleDirective",name:e.name.slice(6),hole:l(e,"style directive"),loc:e.loc})},{id:"load",match:e=>e.startsWith("load:"),build:e=>({kind:"LoadDirective",strategy:e.name.slice(5),modifier:e.value&&e.value.kind==="static"?e.value.value:null,loc:e.loc})},{id:"use",match:e=>e==="use"||e.startsWith("use:"),build:e=>({kind:"UseDirective",name:e.name.startsWith("use:")?e.name.slice(4):null,hole:e.value&&e.value.kind==="hole"?e.value.hole:null,loc:e.loc})},{id:"if",elementOnly:!0,match:e=>e==="if",build:e=>({kind:"IfDirective",hole:l(e,"if directive"),loc:e.loc})},{id:"each",elementOnly:!0,match:e=>e==="each",build:e=>({kind:"EachDirective",hole:l(e,"each directive"),key:null,loc:e.loc})},{id:"else",elementOnly:!0,match:e=>e==="else",build:e=>(e.value!==null&&e.report("invalid-directive","`else` takes no value"),{kind:"ElseDirective",loc:e.loc})},{id:"ref",match:e=>e==="ref",build:e=>({kind:"RefBinding",hole:l(e,"ref binding"),loc:e.loc})},{id:"property",match:e=>e[0]===".",build:e=>({kind:"PropertyBinding",name:e.name.slice(1),hole:l(e,"property binding"),loc:e.loc})},{id:"boolean",match:e=>e[0]==="?",build:e=>s(e,!0)}];function D(e,i=a,t={component:!1}){for(let n of i)if(!(n.elementOnly&&t.component)&&n.match(e.name))return n.build(e);return s(e,!1)}
+"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/directives.ts
+var directives_exports = {};
+__export(directives_exports, {
+  CORE_DIRECTIVES: () => CORE_DIRECTIVES,
+  EVENT_MODIFIERS: () => EVENT_MODIFIERS,
+  resolveAttribute: () => resolveAttribute
+});
+module.exports = __toCommonJS(directives_exports);
+var EVENT_MODIFIERS = /* @__PURE__ */ new Set(["capture", "once", "passive", "prevent", "stop", "self"]);
+function requireHole(raw, what) {
+  if (raw.value && raw.value.kind === "hole") return raw.value.hole;
+  raw.report("invalid-binding", `${what} requires an expression value: ${raw.name}=\${…}`);
+  return -1;
+}
+var attribute = (raw, boolean) => ({
+  kind: "Attribute",
+  name: boolean ? raw.name.slice(1) : raw.name,
+  value: raw.value,
+  boolean,
+  loc: raw.loc
+});
+var CORE_DIRECTIVES = [
+  // Events: `@click=${h}`, `on:click=${h}` (native), `onClick=${h}`, each with
+  // optional dotted modifiers (`@click.capture.once`, `on:input.passive`).
+  {
+    id: "event",
+    match: (n) => n[0] === "@" || n.startsWith("on:") || /^on[A-Z]/.test(n),
+    build: (raw) => {
+      let syntax;
+      let rest;
+      if (raw.name[0] === "@") {
+        syntax = "at";
+        rest = raw.name.slice(1);
+      } else if (raw.name.startsWith("on:")) {
+        syntax = "colon";
+        rest = raw.name.slice(3);
+      } else {
+        syntax = "on";
+        rest = raw.name.slice(2);
+      }
+      const [raw_name, ...modifiers] = rest.split(".");
+      const name = raw_name.toLowerCase();
+      for (const m of modifiers) {
+        if (!EVENT_MODIFIERS.has(m)) {
+          raw.report("invalid-directive", `Unknown event modifier ".${m}" — expected one of ${[...EVENT_MODIFIERS].join(", ")}`);
+        }
+      }
+      return {
+        kind: "EventBinding",
+        name,
+        syntax,
+        modifiers,
+        hole: requireHole(raw, "event binding"),
+        loc: raw.loc
+      };
+    }
+  },
+  // Two-way binding: `bind:value=${signal}`.
+  {
+    id: "bind",
+    elementOnly: true,
+    match: (n) => n.startsWith("bind:"),
+    build: (raw) => ({
+      kind: "BindDirective",
+      name: raw.name.slice("bind:".length),
+      hole: requireHole(raw, "two-way binding"),
+      loc: raw.loc
+    })
+  },
+  // Dynamic class toggle: `class:active=${flag}`.
+  {
+    id: "class-directive",
+    elementOnly: true,
+    match: (n) => n.startsWith("class:"),
+    build: (raw) => ({
+      kind: "ClassDirective",
+      name: raw.name.slice("class:".length),
+      hole: requireHole(raw, "class directive"),
+      loc: raw.loc
+    })
+  },
+  // Dynamic style: `style:color=${c}`.
+  {
+    id: "style-directive",
+    elementOnly: true,
+    match: (n) => n.startsWith("style:"),
+    build: (raw) => ({
+      kind: "StyleDirective",
+      name: raw.name.slice("style:".length),
+      hole: requireHole(raw, "style directive"),
+      loc: raw.loc
+    })
+  },
+  // Load strategy: `load:visible[="200px"]`. Components only, an intrinsic element
+  // has no module to defer.
+  {
+    id: "load",
+    match: (n) => n.startsWith("load:"),
+    build: (raw) => ({
+      kind: "LoadDirective",
+      strategy: raw.name.slice("load:".length),
+      modifier: raw.value && raw.value.kind === "static" ? raw.value.value : null,
+      loc: raw.loc
+    })
+  },
+  // Custom directive: `use=${d}` or `use:tooltip[=${opts}]`.
+  {
+    id: "use",
+    match: (n) => n === "use" || n.startsWith("use:"),
+    build: (raw) => {
+      const named = raw.name.startsWith("use:");
+      return {
+        kind: "UseDirective",
+        name: named ? raw.name.slice("use:".length) : null,
+        hole: raw.value && raw.value.kind === "hole" ? raw.value.hole : null,
+        loc: raw.loc
+      };
+    }
+  },
+  // Conditional rendering: `if=${cond}`.
+  {
+    id: "if",
+    elementOnly: true,
+    match: (n) => n === "if",
+    build: (raw) => ({
+      kind: "IfDirective",
+      hole: requireHole(raw, "if directive"),
+      loc: raw.loc
+    })
+  },
+  // Loop rendering: `each=${items}` (a sibling `key` folds in at parse time).
+  {
+    id: "each",
+    elementOnly: true,
+    match: (n) => n === "each",
+    build: (raw) => ({
+      kind: "EachDirective",
+      hole: requireHole(raw, "each directive"),
+      key: null,
+      loc: raw.loc
+    })
+  },
+  // `else` (valueless).
+  {
+    id: "else",
+    elementOnly: true,
+    match: (n) => n === "else",
+    build: (raw) => {
+      if (raw.value !== null) raw.report("invalid-directive", "`else` takes no value");
+      return { kind: "ElseDirective", loc: raw.loc };
+    }
+  },
+  // Ref binding: `ref=${el}`.
+  {
+    id: "ref",
+    match: (n) => n === "ref",
+    build: (raw) => ({
+      kind: "RefBinding",
+      hole: requireHole(raw, "ref binding"),
+      loc: raw.loc
+    })
+  },
+  // Property binding: `.currentTime=${t}`.
+  {
+    id: "property",
+    match: (n) => n[0] === ".",
+    build: (raw) => ({
+      kind: "PropertyBinding",
+      name: raw.name.slice(1),
+      hole: requireHole(raw, "property binding"),
+      loc: raw.loc
+    })
+  },
+  // Boolean attribute (lit `?disabled`): a plain attribute flagged boolean.
+  {
+    id: "boolean",
+    match: (n) => n[0] === "?",
+    build: (raw) => attribute(raw, true)
+  }
+];
+function resolveAttribute(raw, directives = CORE_DIRECTIVES, ctx = { component: false }) {
+  for (const d of directives) {
+    if (d.elementOnly && ctx.component) continue;
+    if (d.match(raw.name)) return d.build(raw);
+  }
+  return attribute(raw, false);
+}

package/dist/directives.d.cts

@@ -0,0 +1,49 @@
+/**
+ * The directive registry: the extensibility seam.
+ *
+ * The core parser never hard-codes what `if`, `each`, `bind:value`, `@click`,
+ * `.prop` etc. mean. It parses a raw `name[=value]` pair, then asks the registry
+ * to turn it into a typed node. Adding future syntax is therefore a new
+ * descriptor here (or registered by a downstream tool), never a change to the
+ * parser's control flow. Descriptors are tried in order; the first whose
+ * `match` returns true owns the attribute. Anything unmatched falls back to a
+ * plain {@link AttributeNode}.
+ */
+import type { AttributeLikeNode, AttrValue, Diagnostic, DiagnosticCode, SourceSpan } from './ast.cjs';
+/** Recognized event modifiers (`@click.capture.once`, `on:input.passive`, …). */
+export declare const EVENT_MODIFIERS: Set<string>;
+/** A parsed-but-unclassified attribute handed to the registry. */
+export interface RawAttribute {
+    /** Name exactly as written (`class`, `@click`, `bind:value`, `?disabled`). */
+    name: string;
+    nameLoc: SourceSpan;
+    /** null = valueless attribute. */
+    value: AttrValue | null;
+    loc: SourceSpan;
+    /** Emit a located diagnostic from inside a descriptor. */
+    report(code: DiagnosticCode, message: string): void;
+}
+export interface DirectiveDescriptor {
+    /** Stable id (for docs/debugging). */
+    id: string;
+    /** DOM-only sugar (`if`/`each`/`class:`…) is ignored on component tags. */
+    elementOnly?: boolean;
+    match(name: string): boolean;
+    build(raw: RawAttribute): AttributeLikeNode;
+}
+/** Where an attribute sits: a native element or a component tag. */
+export interface AttrContext {
+    component: boolean;
+}
+/**
+ * The built-in directives. Order matters: prefix forms are matched before the
+ * plain-attribute fallback. Downstream tools can prepend their own.
+ */
+export declare const CORE_DIRECTIVES: DirectiveDescriptor[];
+/**
+ * Resolve a raw attribute to a typed node using `directives` (defaults to the
+ * core set). `each`/`key` are handled by the parser afterward because `key` is
+ * a sibling attribute that folds into the preceding `each` node.
+ */
+export declare function resolveAttribute(raw: RawAttribute, directives?: DirectiveDescriptor[], ctx?: AttrContext): AttributeLikeNode;
+export type { Diagnostic };

package/dist/directives.d.ts

@@ -1,5 +1,5 @@
 /**
- * The directive registry — the extensibility seam.
+ * The directive registry: the extensibility seam.
  *
  * The core parser never hard-codes what `if`, `each`, `bind:value`, `@click`,
  * `.prop` etc. mean. It parses a raw `name[=value]` pair, then asks the registry
@@ -31,7 +31,7 @@ export interface DirectiveDescriptor {
     match(name: string): boolean;
     build(raw: RawAttribute): AttributeLikeNode;
 }
-/** Where an attribute sits — a native element or a component tag. */
+/** Where an attribute sits: a native element or a component tag. */
 export interface AttrContext {
     component: boolean;
 }

package/dist/directives.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"directives.d.ts","sourceRoot":"","sources":["../src/directives.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EACV,iBAAiB,EAEjB,SAAS,EAGT,UAAU,EACV,cAAc,EAOd,UAAU,EAIX,MAAM,UAAU,CAAC;AAElB,iFAAiF;AACjF,eAAO,MAAM,eAAe,aAAqE,CAAC;AAElG,kEAAkE;AAClE,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,UAAU,CAAC;IACpB,kCAAkC;IAClC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACxB,GAAG,EAAE,UAAU,CAAC;IAChB,0DAA0D;IAC1D,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACrD;AAED,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,2EAA2E;IAC3E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,iBAAiB,CAAC;CAC7C;AAED,qEAAqE;AACrE,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,OAAO,CAAC;CACpB;AAkBD;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,mBAAmB,EA4JhD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,YAAY,EACjB,UAAU,GAAE,mBAAmB,EAAoB,EACnD,GAAG,GAAE,WAAkC,GACtC,iBAAiB,CAMnB;AAED,YAAY,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"directives.d.ts","sourceRoot":"","sources":["../src/directives.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EACV,iBAAiB,EAEjB,SAAS,EAGT,UAAU,EACV,cAAc,EAOd,UAAU,EAIX,MAAM,UAAU,CAAC;AAElB,iFAAiF;AACjF,eAAO,MAAM,eAAe,aAAqE,CAAC;AAElG,kEAAkE;AAClE,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,UAAU,CAAC;IACpB,kCAAkC;IAClC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACxB,GAAG,EAAE,UAAU,CAAC;IAChB,0DAA0D;IAC1D,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACrD;AAED,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,2EAA2E;IAC3E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,iBAAiB,CAAC;CAC7C;AAED,oEAAoE;AACpE,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,OAAO,CAAC;CACpB;AAkBD;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,mBAAmB,EA4JhD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,YAAY,EACjB,UAAU,GAAE,mBAAmB,EAAoB,EACnD,GAAG,GAAE,WAAkC,GACtC,iBAAiB,CAMnB;AAED,YAAY,EAAE,UAAU,EAAE,CAAC"}

package/dist/directives.js

@@ -42,7 +42,7 @@ export const CORE_DIRECTIVES = [
             }
             // Dotted modifiers apply to the @/on: forms; the camelCase name has no dots.
             // Lowercase the name so `onClick`, `@click` and `on:click` all yield `click`
-            // — the AST documents this field as the DOM event name, and a consumer that
+            //: the AST documents this field as the DOM event name, and a consumer that
             // trusts that shouldn't have to know which spelling was written. (`syntax`
             // still records the spelling; the ts-plugin reads the written form from source.)
             const [raw_name, ...modifiers] = rest.split('.');
@@ -98,7 +98,7 @@ export const CORE_DIRECTIVES = [
             loc: raw.loc,
         }),
     },
-    // Load strategy: `load:visible[="200px"]`. Components only — an intrinsic element
+    // Load strategy: `load:visible[="200px"]`. Components only, an intrinsic element
     // has no module to defer.
     {
         id: 'load',

package/dist/directives.mjs

@@ -1 +1,185 @@
-var d=new Set(["capture","once","passive","prevent","stop","self"]);function t(e,i){return e.value&&e.value.kind==="hole"?e.value.hole:(e.report("invalid-binding",`${i} requires an expression value: ${e.name}=\${…}`),-1)}var r=(e,i)=>({kind:"Attribute",name:i?e.name.slice(1):e.name,value:e.value,boolean:i,loc:e.loc}),a=[{id:"event",match:e=>e[0]==="@"||e.startsWith("on:")||/^on[A-Z]/.test(e),build:e=>{let i,n;e.name[0]==="@"?(i="at",n=e.name.slice(1)):e.name.startsWith("on:")?(i="colon",n=e.name.slice(3)):(i="on",n=e.name.slice(2));let[o,...l]=n.split("."),s=o.toLowerCase();for(let c of l)d.has(c)||e.report("invalid-directive",`Unknown event modifier ".${c}" — expected one of ${[...d].join(", ")}`);return{kind:"EventBinding",name:s,syntax:i,modifiers:l,hole:t(e,"event binding"),loc:e.loc}}},{id:"bind",elementOnly:!0,match:e=>e.startsWith("bind:"),build:e=>({kind:"BindDirective",name:e.name.slice(5),hole:t(e,"two-way binding"),loc:e.loc})},{id:"class-directive",elementOnly:!0,match:e=>e.startsWith("class:"),build:e=>({kind:"ClassDirective",name:e.name.slice(6),hole:t(e,"class directive"),loc:e.loc})},{id:"style-directive",elementOnly:!0,match:e=>e.startsWith("style:"),build:e=>({kind:"StyleDirective",name:e.name.slice(6),hole:t(e,"style directive"),loc:e.loc})},{id:"load",match:e=>e.startsWith("load:"),build:e=>({kind:"LoadDirective",strategy:e.name.slice(5),modifier:e.value&&e.value.kind==="static"?e.value.value:null,loc:e.loc})},{id:"use",match:e=>e==="use"||e.startsWith("use:"),build:e=>({kind:"UseDirective",name:e.name.startsWith("use:")?e.name.slice(4):null,hole:e.value&&e.value.kind==="hole"?e.value.hole:null,loc:e.loc})},{id:"if",elementOnly:!0,match:e=>e==="if",build:e=>({kind:"IfDirective",hole:t(e,"if directive"),loc:e.loc})},{id:"each",elementOnly:!0,match:e=>e==="each",build:e=>({kind:"EachDirective",hole:t(e,"each directive"),key:null,loc:e.loc})},{id:"else",elementOnly:!0,match:e=>e==="else",build:e=>(e.value!==null&&e.report("invalid-directive","`else` takes no value"),{kind:"ElseDirective",loc:e.loc})},{id:"ref",match:e=>e==="ref",build:e=>({kind:"RefBinding",hole:t(e,"ref binding"),loc:e.loc})},{id:"property",match:e=>e[0]===".",build:e=>({kind:"PropertyBinding",name:e.name.slice(1),hole:t(e,"property binding"),loc:e.loc})},{id:"boolean",match:e=>e[0]==="?",build:e=>r(e,!0)}];function u(e,i=a,n={component:!1}){for(let o of i)if(!(o.elementOnly&&n.component)&&o.match(e.name))return o.build(e);return r(e,!1)}export{a as CORE_DIRECTIVES,d as EVENT_MODIFIERS,u as resolveAttribute};
+// src/directives.ts
+var EVENT_MODIFIERS = /* @__PURE__ */ new Set(["capture", "once", "passive", "prevent", "stop", "self"]);
+function requireHole(raw, what) {
+  if (raw.value && raw.value.kind === "hole") return raw.value.hole;
+  raw.report("invalid-binding", `${what} requires an expression value: ${raw.name}=\${…}`);
+  return -1;
+}
+var attribute = (raw, boolean) => ({
+  kind: "Attribute",
+  name: boolean ? raw.name.slice(1) : raw.name,
+  value: raw.value,
+  boolean,
+  loc: raw.loc
+});
+var CORE_DIRECTIVES = [
+  // Events: `@click=${h}`, `on:click=${h}` (native), `onClick=${h}`, each with
+  // optional dotted modifiers (`@click.capture.once`, `on:input.passive`).
+  {
+    id: "event",
+    match: (n) => n[0] === "@" || n.startsWith("on:") || /^on[A-Z]/.test(n),
+    build: (raw) => {
+      let syntax;
+      let rest;
+      if (raw.name[0] === "@") {
+        syntax = "at";
+        rest = raw.name.slice(1);
+      } else if (raw.name.startsWith("on:")) {
+        syntax = "colon";
+        rest = raw.name.slice(3);
+      } else {
+        syntax = "on";
+        rest = raw.name.slice(2);
+      }
+      const [raw_name, ...modifiers] = rest.split(".");
+      const name = raw_name.toLowerCase();
+      for (const m of modifiers) {
+        if (!EVENT_MODIFIERS.has(m)) {
+          raw.report("invalid-directive", `Unknown event modifier ".${m}" — expected one of ${[...EVENT_MODIFIERS].join(", ")}`);
+        }
+      }
+      return {
+        kind: "EventBinding",
+        name,
+        syntax,
+        modifiers,
+        hole: requireHole(raw, "event binding"),
+        loc: raw.loc
+      };
+    }
+  },
+  // Two-way binding: `bind:value=${signal}`.
+  {
+    id: "bind",
+    elementOnly: true,
+    match: (n) => n.startsWith("bind:"),
+    build: (raw) => ({
+      kind: "BindDirective",
+      name: raw.name.slice("bind:".length),
+      hole: requireHole(raw, "two-way binding"),
+      loc: raw.loc
+    })
+  },
+  // Dynamic class toggle: `class:active=${flag}`.
+  {
+    id: "class-directive",
+    elementOnly: true,
+    match: (n) => n.startsWith("class:"),
+    build: (raw) => ({
+      kind: "ClassDirective",
+      name: raw.name.slice("class:".length),
+      hole: requireHole(raw, "class directive"),
+      loc: raw.loc
+    })
+  },
+  // Dynamic style: `style:color=${c}`.
+  {
+    id: "style-directive",
+    elementOnly: true,
+    match: (n) => n.startsWith("style:"),
+    build: (raw) => ({
+      kind: "StyleDirective",
+      name: raw.name.slice("style:".length),
+      hole: requireHole(raw, "style directive"),
+      loc: raw.loc
+    })
+  },
+  // Load strategy: `load:visible[="200px"]`. Components only, an intrinsic element
+  // has no module to defer.
+  {
+    id: "load",
+    match: (n) => n.startsWith("load:"),
+    build: (raw) => ({
+      kind: "LoadDirective",
+      strategy: raw.name.slice("load:".length),
+      modifier: raw.value && raw.value.kind === "static" ? raw.value.value : null,
+      loc: raw.loc
+    })
+  },
+  // Custom directive: `use=${d}` or `use:tooltip[=${opts}]`.
+  {
+    id: "use",
+    match: (n) => n === "use" || n.startsWith("use:"),
+    build: (raw) => {
+      const named = raw.name.startsWith("use:");
+      return {
+        kind: "UseDirective",
+        name: named ? raw.name.slice("use:".length) : null,
+        hole: raw.value && raw.value.kind === "hole" ? raw.value.hole : null,
+        loc: raw.loc
+      };
+    }
+  },
+  // Conditional rendering: `if=${cond}`.
+  {
+    id: "if",
+    elementOnly: true,
+    match: (n) => n === "if",
+    build: (raw) => ({
+      kind: "IfDirective",
+      hole: requireHole(raw, "if directive"),
+      loc: raw.loc
+    })
+  },
+  // Loop rendering: `each=${items}` (a sibling `key` folds in at parse time).
+  {
+    id: "each",
+    elementOnly: true,
+    match: (n) => n === "each",
+    build: (raw) => ({
+      kind: "EachDirective",
+      hole: requireHole(raw, "each directive"),
+      key: null,
+      loc: raw.loc
+    })
+  },
+  // `else` (valueless).
+  {
+    id: "else",
+    elementOnly: true,
+    match: (n) => n === "else",
+    build: (raw) => {
+      if (raw.value !== null) raw.report("invalid-directive", "`else` takes no value");
+      return { kind: "ElseDirective", loc: raw.loc };
+    }
+  },
+  // Ref binding: `ref=${el}`.
+  {
+    id: "ref",
+    match: (n) => n === "ref",
+    build: (raw) => ({
+      kind: "RefBinding",
+      hole: requireHole(raw, "ref binding"),
+      loc: raw.loc
+    })
+  },
+  // Property binding: `.currentTime=${t}`.
+  {
+    id: "property",
+    match: (n) => n[0] === ".",
+    build: (raw) => ({
+      kind: "PropertyBinding",
+      name: raw.name.slice(1),
+      hole: requireHole(raw, "property binding"),
+      loc: raw.loc
+    })
+  },
+  // Boolean attribute (lit `?disabled`): a plain attribute flagged boolean.
+  {
+    id: "boolean",
+    match: (n) => n[0] === "?",
+    build: (raw) => attribute(raw, true)
+  }
+];
+function resolveAttribute(raw, directives = CORE_DIRECTIVES, ctx = { component: false }) {
+  for (const d of directives) {
+    if (d.elementOnly && ctx.component) continue;
+    if (d.match(raw.name)) return d.build(raw);
+  }
+  return attribute(raw, false);
+}
+export {
+  CORE_DIRECTIVES,
+  EVENT_MODIFIERS,
+  resolveAttribute
+};