@fluixi/compiler 1.0.0-alpha.104 → 1.0.0-alpha.106

package/dist/codegen/partial-template.mjs

@@ -77,10 +77,64 @@ function isHole(node) {
 function isTemplateChild(node) {
   return node.kind === "text" || node.kind === "element" && isTemplateElement(node);
 }
+var PROPERTY_BINDS = /* @__PURE__ */ new Set(["indeterminate"]);
+function disposition(prop) {
+  if (prop.kind === "spread") return null;
+  if (prop.name === "ref") return "ref";
+  if (prop.name === "use") return "use";
+  if (prop.kind === "event") return prop.event ? "event" : null;
+  if (prop.kind === "prop") return "property";
+  if (prop.kind !== "attr") return null;
+  const name = prop.name;
+  if (name.startsWith("on:")) return "nativeEvent";
+  if (name.startsWith("prop:")) return "property";
+  if (name.startsWith("attr:")) return "attr";
+  if (name.startsWith("bool:")) return "boolAttr";
+  if (name === "className" || name === "class") {
+    return isPlainLiteralAttr(prop) ? "serialize" : "class";
+  }
+  if (name === "classList") {
+    if (isPlainLiteralAttr(prop)) return "serialize";
+    return prop.reactive ? "classListDynamic" : "classList";
+  }
+  if (name === "style") {
+    if (isPlainLiteralAttr(prop)) return "serialize";
+    return prop.reactive ? "styleDynamic" : "style";
+  }
+  if (name.includes(":")) return null;
+  if (PROPERTY_ONLY.has(name)) return null;
+  if (PROPERTY_BINDS.has(name)) return "property";
+  if (prop.expr === void 0) return isPlainLiteralAttr(prop) ? "serialize" : null;
+  return "attr";
+}
+function effectiveProps(el) {
+  const order = [];
+  const byName = /* @__PURE__ */ new Map();
+  for (const prop of el.props) {
+    if (!byName.has(prop.name)) order.push(prop.name);
+    byName.set(prop.name, prop);
+  }
+  return order.map((name) => byName.get(name));
+}
+function propPlan(el) {
+  const custom = el.tag.includes("-");
+  const plan = { serialize: [], bindings: [] };
+  for (const prop of effectiveProps(el)) {
+    const kind = disposition(prop);
+    if (kind === null) return null;
+    if (kind === "serialize") {
+      plan.serialize.push(prop);
+      continue;
+    }
+    if (custom) return null;
+    plan.bindings.push({ prop, kind });
+  }
+  return plan;
+}
 function isTemplateElement(node) {
   if (node.svg) return false;
   if (isRawTextElement(node.tag)) return false;
-  if (!node.props.every((p) => isPlainLiteralAttr(p))) return false;
+  if (!propPlan(node)) return false;
   return node.children.every((c) => isTemplateChild(c) || isHole(c));
 }
 function containsHole(node) {
@@ -88,6 +142,15 @@ function containsHole(node) {
   const children = node.children;
   return children ? children.some(containsHole) : false;
 }
+function containsBinding(node) {
+  if (node.kind !== "element") return false;
+  const plan = propPlan(node);
+  if (plan && plan.bindings.length > 0) return true;
+  return node.children.some(containsBinding);
+}
+function interesting(node) {
+  return containsHole(node) || containsBinding(node);
+}
 function addressable(el) {
   for (let i = 0; i < el.children.length; i++) {
     const child = el.children[i];
@@ -101,9 +164,10 @@ function addressable(el) {
 function planPartialTemplate(root) {
   if (!isTemplateElement(root)) return null;
   if (!addressable(root)) return null;
-  if (!root.children.some(containsHole)) return null;
+  if (!interesting(root)) return null;
   const steps = [];
   const holes = [];
+  const bindings = [];
   let refCount = 0;
   const declare = (expr) => {
     const ref = `_n$${refCount++}`;
@@ -111,11 +175,17 @@ function planPartialTemplate(root) {
     return ref;
   };
   walk(root, "_el$");
-  return { html: serializeWithMarkers(root), tag: root.tag, steps, holes };
+  return { html: serializeWithMarkers(root), tag: root.tag, steps, holes, bindings };
   function walk(el, elementRef) {
+    const plan = propPlan(el);
+    if (plan) {
+      for (const binding of plan.bindings) {
+        bindings.push({ ref: elementRef, prop: binding.prop, kind: binding.kind });
+      }
+    }
     let last = -1;
     el.children.forEach((child, i) => {
-      if (containsHole(child)) last = i;
+      if (interesting(child)) last = i;
     });
     let previous = null;
     for (let i = 0; i <= last; i++) {
@@ -129,19 +199,21 @@ function planPartialTemplate(root) {
         continue;
       }
       const ref = declare(expr);
-      if (child.kind === "element" && containsHole(child)) walk(child, ref);
+      if (child.kind === "element" && interesting(child)) walk(child, ref);
       previous = ref;
     }
   }
 }
 function serializeWithMarkers(el) {
-  return serializeStatic(withSentinels(el)).split(SENTINEL).join(HOLE_START + HOLE_END);
+  return serializeStatic(templateTree(el)).split(SENTINEL).join(HOLE_START + HOLE_END);
 }
-function withSentinels(el) {
+function templateTree(el) {
+  const plan = propPlan(el);
   return {
     ...el,
+    props: plan ? plan.serialize : [],
     children: el.children.map(
-      (child) => isHole(child) ? { kind: "text", value: SENTINEL } : child.kind === "element" ? withSentinels(child) : child
+      (child) => isHole(child) ? { kind: "text", value: SENTINEL } : child.kind === "element" ? templateTree(child) : child
     )
   };
 }

package/dist/codegen/serialize-static.cjs

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/codegen/serialize-static.ts
 var serialize_static_exports = {};
 __export(serialize_static_exports, {
+  PROPERTY_ONLY: () => PROPERTY_ONLY,
   htmlAttrName: () => htmlAttrName,
   isPlainLiteralAttr: () => isPlainLiteralAttr,
   isRawTextElement: () => isRawTextElement,

package/dist/codegen/serialize-static.d.cts

@@ -7,6 +7,14 @@
  * guess, and anything it cannot represent is a bug in the analysis, not a fallback.
  */
 import type { IRElement, IRProp } from '../ir/nodes.cjs';
+/**
+ * Names the runtime assigns as DOM properties, whatever they look like.
+ *
+ * `innerHTML="<b>x</b>"` in a template would be escaped into visible text, and `value`
+ * as an attribute sets the *default* value rather than the current one. Serializing any
+ * of these changes what the code means, so they stay on the imperative path.
+ */
+export declare const PROPERTY_ONLY: Set<string>;
 /** True when this element's content must not be entity-escaped. */
 export declare function isRawTextElement(tag: string): boolean;
 /** The HTML spelling of an IR prop name. */

package/dist/codegen/serialize-static.d.ts

@@ -7,6 +7,14 @@
  * guess, and anything it cannot represent is a bug in the analysis, not a fallback.
  */
 import type { IRElement, IRProp } from '../ir/nodes.js';
+/**
+ * Names the runtime assigns as DOM properties, whatever they look like.
+ *
+ * `innerHTML="<b>x</b>"` in a template would be escaped into visible text, and `value`
+ * as an attribute sets the *default* value rather than the current one. Serializing any
+ * of these changes what the code means, so they stay on the imperative path.
+ */
+export declare const PROPERTY_ONLY: Set<string>;
 /** True when this element's content must not be entity-escaped. */
 export declare function isRawTextElement(tag: string): boolean;
 /** The HTML spelling of an IR prop name. */

package/dist/codegen/serialize-static.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serialize-static.d.ts","sourceRoot":"","sources":["../../src/codegen/serialize-static.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,SAAS,EAAU,MAAM,EAAE,MAAM,gBAAgB,CAAC;AA6DhE,mEAAmE;AACnE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,4CAA4C;AAC5C,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKxD;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAgBvD;AAED,2BAA2B;AAC3B,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAKvD;AAmCD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,SAAS,CAU9F"}
+{"version":3,"file":"serialize-static.d.ts","sourceRoot":"","sources":["../../src/codegen/serialize-static.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,SAAS,EAAU,MAAM,EAAE,MAAM,gBAAgB,CAAC;AA8BhE;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,aAaxB,CAAC;AAWH,mEAAmE;AACnE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,4CAA4C;AAC5C,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKxD;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAgBvD;AAED,2BAA2B;AAC3B,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAKvD;AAmCD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,SAAS,CAU9F"}

package/dist/codegen/serialize-static.js

@@ -31,7 +31,7 @@ const HTML_NAME = {
  * as an attribute sets the *default* value rather than the current one. Serializing any
  * of these changes what the code means, so they stay on the imperative path.
  */
-const PROPERTY_ONLY = new Set([
+export const PROPERTY_ONLY = new Set([
     'innerHTML',
     'outerHTML',
     'innerText',

package/dist/codegen/serialize-static.mjs

@@ -95,6 +95,7 @@ function templatePositions(root) {
   return file && pos.some((n) => n !== 0) ? { file, pos } : void 0;
 }
 export {
+  PROPERTY_ONLY,
   htmlAttrName,
   isPlainLiteralAttr,
   isRawTextElement,

package/dist/frontend/babel/build-ir-html.cjs

@@ -196,10 +196,64 @@ function isHole(node) {
 function isTemplateChild(node) {
   return node.kind === "text" || node.kind === "element" && isTemplateElement(node);
 }
+var PROPERTY_BINDS = /* @__PURE__ */ new Set(["indeterminate"]);
+function disposition(prop) {
+  if (prop.kind === "spread") return null;
+  if (prop.name === "ref") return "ref";
+  if (prop.name === "use") return "use";
+  if (prop.kind === "event") return prop.event ? "event" : null;
+  if (prop.kind === "prop") return "property";
+  if (prop.kind !== "attr") return null;
+  const name = prop.name;
+  if (name.startsWith("on:")) return "nativeEvent";
+  if (name.startsWith("prop:")) return "property";
+  if (name.startsWith("attr:")) return "attr";
+  if (name.startsWith("bool:")) return "boolAttr";
+  if (name === "className" || name === "class") {
+    return isPlainLiteralAttr(prop) ? "serialize" : "class";
+  }
+  if (name === "classList") {
+    if (isPlainLiteralAttr(prop)) return "serialize";
+    return prop.reactive ? "classListDynamic" : "classList";
+  }
+  if (name === "style") {
+    if (isPlainLiteralAttr(prop)) return "serialize";
+    return prop.reactive ? "styleDynamic" : "style";
+  }
+  if (name.includes(":")) return null;
+  if (PROPERTY_ONLY.has(name)) return null;
+  if (PROPERTY_BINDS.has(name)) return "property";
+  if (prop.expr === void 0) return isPlainLiteralAttr(prop) ? "serialize" : null;
+  return "attr";
+}
+function effectiveProps(el) {
+  const order = [];
+  const byName = /* @__PURE__ */ new Map();
+  for (const prop of el.props) {
+    if (!byName.has(prop.name)) order.push(prop.name);
+    byName.set(prop.name, prop);
+  }
+  return order.map((name) => byName.get(name));
+}
+function propPlan(el) {
+  const custom = el.tag.includes("-");
+  const plan = { serialize: [], bindings: [] };
+  for (const prop of effectiveProps(el)) {
+    const kind = disposition(prop);
+    if (kind === null) return null;
+    if (kind === "serialize") {
+      plan.serialize.push(prop);
+      continue;
+    }
+    if (custom) return null;
+    plan.bindings.push({ prop, kind });
+  }
+  return plan;
+}
 function isTemplateElement(node) {
   if (node.svg) return false;
   if (isRawTextElement(node.tag)) return false;
-  if (!node.props.every((p) => isPlainLiteralAttr(p))) return false;
+  if (!propPlan(node)) return false;
   return node.children.every((c) => isTemplateChild(c) || isHole(c));
 }
 function containsHole(node) {
@@ -207,6 +261,15 @@ function containsHole(node) {
   const children = node.children;
   return children ? children.some(containsHole) : false;
 }
+function containsBinding(node) {
+  if (node.kind !== "element") return false;
+  const plan = propPlan(node);
+  if (plan && plan.bindings.length > 0) return true;
+  return node.children.some(containsBinding);
+}
+function interesting(node) {
+  return containsHole(node) || containsBinding(node);
+}
 function addressable(el) {
   for (let i = 0; i < el.children.length; i++) {
     const child = el.children[i];
@@ -220,9 +283,10 @@ function addressable(el) {
 function planPartialTemplate(root) {
   if (!isTemplateElement(root)) return null;
   if (!addressable(root)) return null;
-  if (!root.children.some(containsHole)) return null;
+  if (!interesting(root)) return null;
   const steps = [];
   const holes = [];
+  const bindings = [];
   let refCount = 0;
   const declare = (expr) => {
     const ref = `_n$${refCount++}`;
@@ -230,11 +294,17 @@ function planPartialTemplate(root) {
     return ref;
   };
   walk(root, "_el$");
-  return { html: serializeWithMarkers(root), tag: root.tag, steps, holes };
+  return { html: serializeWithMarkers(root), tag: root.tag, steps, holes, bindings };
   function walk(el, elementRef) {
+    const plan = propPlan(el);
+    if (plan) {
+      for (const binding of plan.bindings) {
+        bindings.push({ ref: elementRef, prop: binding.prop, kind: binding.kind });
+      }
+    }
     let last = -1;
     el.children.forEach((child, i) => {
-      if (containsHole(child)) last = i;
+      if (interesting(child)) last = i;
     });
     let previous = null;
     for (let i = 0; i <= last; i++) {
@@ -248,19 +318,21 @@ function planPartialTemplate(root) {
         continue;
       }
       const ref = declare(expr);
-      if (child.kind === "element" && containsHole(child)) walk(child, ref);
+      if (child.kind === "element" && interesting(child)) walk(child, ref);
       previous = ref;
     }
   }
 }
 function serializeWithMarkers(el) {
-  return serializeStatic(withSentinels(el)).split(SENTINEL).join(HOLE_START + HOLE_END);
+  return serializeStatic(templateTree(el)).split(SENTINEL).join(HOLE_START + HOLE_END);
 }
-function withSentinels(el) {
+function templateTree(el) {
+  const plan = propPlan(el);
   return {
     ...el,
+    props: plan ? plan.serialize : [],
     children: el.children.map(
-      (child) => isHole(child) ? { kind: "text", value: SENTINEL } : child.kind === "element" ? withSentinels(child) : child
+      (child) => isHole(child) ? { kind: "text", value: SENTINEL } : child.kind === "element" ? templateTree(child) : child
     )
   };
 }
@@ -533,6 +605,55 @@ function emitComponent(name, props, children, used, templates, at) {
   const mark = at ? `globalThis.${SOURCE_MARKER}?.(${JSON.stringify(at.file)},${at.line},${at.column},${JSON.stringify(name)}), ` : "";
   return `createMemo(${paren(`${mark}() => createComponent(${name}, ${obj})`, "value")})`;
 }
+function bindingTarget(binding) {
+  const name = binding.prop.name;
+  if (binding.kind === "boolAttr") return name.slice("bool:".length);
+  if (name.startsWith("prop:")) return name.slice("prop:".length);
+  if (name.startsWith("attr:")) return name.slice("attr:".length);
+  return htmlAttrName(name);
+}
+function bindingStatement(binding, used) {
+  const { ref, prop, kind } = binding;
+  const value = propValue(prop);
+  switch (kind) {
+    case "class":
+      used.add("setClassName");
+      return `setClassName(${ref}, ${value});`;
+    case "classList":
+      used.add("setClassList");
+      return `setClassList(${ref}, ${value}, []);`;
+    case "classListDynamic":
+      used.add("setDynamicClassList");
+      return `setDynamicClassList(${ref}, ${value});`;
+    case "style":
+      used.add("setStyle");
+      return `setStyle(${ref}, ${value}, []);`;
+    case "styleDynamic":
+      used.add("setDynamicStyle");
+      return `setDynamicStyle(${ref}, ${value});`;
+    case "attr":
+      used.add("setDynamicAttribute");
+      return `setDynamicAttribute(${ref}, ${JSON.stringify(bindingTarget(binding))}, ${value});`;
+    case "property":
+      used.add("setDynamicProperty");
+      return `setDynamicProperty(${ref}, ${JSON.stringify(bindingTarget(binding))}, ${value});`;
+    case "boolAttr":
+      used.add("setDynamicBoolAttribute");
+      return `setDynamicBoolAttribute(${ref}, ${JSON.stringify(bindingTarget(binding))}, ${value});`;
+    case "event":
+      used.add("addDelegatedEventListener");
+      return `addDelegatedEventListener(${ref}, ${JSON.stringify(prop.event.name)}, ${value});`;
+    case "nativeEvent":
+      used.add("addNativeEventListener");
+      return `addNativeEventListener(${ref}, ${JSON.stringify(prop.name.slice(3))}, ${value});`;
+    case "ref":
+      used.add("handleRef");
+      return `handleRef(${value}, ${ref});`;
+    case "use":
+      used.add("applyUse");
+      return `applyUse(${ref}, ${value});`;
+  }
+}
 function staticAttrAssignment(el, prop) {
   const name = htmlAttrName(prop.name);
   const value = prop.literal;
@@ -583,6 +704,7 @@ function emitNode(node, used, templates) {
             `const _el$ = templateNode(${id}, ${JSON.stringify(plan.tag)}, true${at ? `, false, ${JSON.stringify(at)}` : ""});`
           ];
           for (const step of plan.steps) lines.push(`const ${step.ref} = ${step.expr};`);
+          for (const binding of plan.bindings) lines.push(bindingStatement(binding, used));
           for (const hole of plan.holes) {
             lines.push(
               `insert(${hole.parentRef}, holeScope(${hole.startRef}, () => ${paren(emitNode(hole.node, used, templates), "arrowBody")}), ${hole.endRef}, holeContent(${hole.startRef}, ${hole.endRef}));`
@@ -1841,7 +1963,7 @@ var generate = import_generator.default.default ?? import_generator.default;
 function gen(node) {
   return generate(node, { concise: true }).code;
 }
-function transformNestedJSX(node, used, onNested) {
+function transformNestedJSX(node, used, onNested, emit) {
   const clone = import_core.types.cloneNode(node, true);
   const file = import_core.types.file(import_core.types.program([import_core.types.expressionStatement(clone)]));
   let changed = false;
@@ -1854,9 +1976,12 @@ function transformNestedJSX(node, used, onNested) {
   (0, import_core.traverse)(file, {
     "JSXElement|JSXFragment"(path) {
       const jsx = path.node;
-      const nestedIR = buildIR(jsx, used, onNested);
+      const nestedIR = buildIR(jsx, used, onNested, emit);
       onNested?.(nestedIR);
-      const { code, imports, templates } = imperativeBackend.emit(nestedIR, {});
+      const { code, imports, templates } = imperativeBackend.emit(nestedIR, {
+        templateClone: emit?.templateClone,
+        partialTemplates: emit?.partialTemplates ?? true
+      });
       emitInto(path, inlineTemplates(code, templates), imports);
     },
     // Nested html templates compose: ${cond ? html`...` : html`...`},
@@ -1864,26 +1989,29 @@ function transformNestedJSX(node, used, onNested) {
     TaggedTemplateExpression(path) {
       const tag = path.node.tag;
       if (!import_core.types.isIdentifier(tag) || tag.name !== "html" && tag.name !== "svg") return;
-      const ir = buildIRFromHtml(path.node, used, { svg: tag.name === "svg", onNested });
+      const ir = buildIRFromHtml(path.node, used, { svg: tag.name === "svg", onNested, emit });
       onNested?.(ir);
-      const { code, imports, templates } = imperativeBackend.emit(ir, {});
+      const { code, imports, templates } = imperativeBackend.emit(ir, {
+        templateClone: emit?.templateClone,
+        partialTemplates: emit?.partialTemplates ?? true
+      });
       emitInto(path, inlineTemplates(code, templates), imports);
     }
   });
   return changed ? file.program.body[0].expression : node;
 }
-function genExpr(node, used, onNested) {
-  return gen(transformNestedJSX(node, used, onNested));
+function genExpr(node, used, onNested, emit) {
+  return gen(transformNestedJSX(node, used, onNested, emit));
 }
 function isReactiveExpr(node) {
   return isReactiveShape(shapeOf(node));
 }
-function buildIR(node, used = /* @__PURE__ */ new Set(), onNested) {
+function buildIR(node, used = /* @__PURE__ */ new Set(), onNested, emit) {
   const ir = buildJsxIR(node, {
     code: (n) => (
       // A member-expression tag (`<ns.Foo/>`) is not an Expression, so it cannot go
       // through the nested-JSX compile: it only ever needs printing.
-      n.type === "JSXMemberExpression" ? gen(n) : genExpr(n, used, onNested)
+      n.type === "JSXMemberExpression" ? gen(n) : genExpr(n, used, onNested, emit)
     ),
     used
   });
@@ -1895,16 +2023,16 @@ var generate2 = import_generator2.default.default ?? import_generator2.default;
 function gen2(node) {
   return generate2(node, { concise: true }).code;
 }
-function bindHole(expr, used, onNested) {
+function bindHole(expr, used, onNested, emit) {
   const hole = {
-    code: genExpr(expr, used, onNested),
+    code: genExpr(expr, used, onNested, emit),
     reactive: isReactiveExpr(expr)
   };
   if (import_core2.types.isArrowFunctionExpression(expr) && !import_core2.types.isBlockStatement(expr.body)) {
     const body = expr.body;
     hole.arrow = {
       params: expr.params.map((p) => gen2(p)),
-      body: genExpr(body, used, onNested),
+      body: genExpr(body, used, onNested, emit),
       bodyReactive: isReactiveExpr(body)
     };
   }
@@ -1913,7 +2041,7 @@ function bindHole(expr, used, onNested) {
 }
 function lowerHtmlTemplate(node, used, opts = {}) {
   const quasi = node.quasi;
-  const holes = quasi.expressions.map((e) => bindHole(e, used, opts.onNested));
+  const holes = quasi.expressions.map((e) => bindHole(e, used, opts.onNested, opts.emit));
   return lowerTemplate(buildPieces(quasi), holes, used, opts);
 }
 function buildPieces(quasi) {

package/dist/frontend/babel/build-ir-html.d.cts

@@ -15,6 +15,7 @@
  */
 import type { types as t } from '@babel/core';
 import type { IRNode } from '../../ir/nodes.cjs';
+import type { NestedEmitOptions, NestedHook } from './build-ir.cjs';
 /**
  * Build IR from an `` html`...` `` (or `` svg`...` ``) TaggedTemplateExpression.
  * `used` collects runtime symbols emitted for anything nested inside a hole.
@@ -22,5 +23,6 @@ import type { IRNode } from '../../ir/nodes.cjs';
  */
 export declare function buildIRFromHtml(node: t.TaggedTemplateExpression, used?: Set<string>, opts?: {
     svg?: boolean;
-    onNested?: (ir: IRNode) => void;
+    onNested?: NestedHook;
+    emit?: NestedEmitOptions;
 }): IRNode;

package/dist/frontend/babel/build-ir-html.d.ts

@@ -15,6 +15,7 @@
  */
 import type { types as t } from '@babel/core';
 import type { IRNode } from '../../ir/nodes.js';
+import type { NestedEmitOptions, NestedHook } from './build-ir.js';
 /**
  * Build IR from an `` html`...` `` (or `` svg`...` ``) TaggedTemplateExpression.
  * `used` collects runtime symbols emitted for anything nested inside a hole.
@@ -22,6 +23,7 @@ import type { IRNode } from '../../ir/nodes.js';
  */
 export declare function buildIRFromHtml(node: t.TaggedTemplateExpression, used?: Set<string>, opts?: {
     svg?: boolean;
-    onNested?: (ir: IRNode) => void;
+    onNested?: NestedHook;
+    emit?: NestedEmitOptions;
 }): IRNode;
 //# sourceMappingURL=build-ir-html.d.ts.map

package/dist/frontend/babel/build-ir-html.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-ir-html.d.ts","sourceRoot":"","sources":["../../../src/frontend/babel/build-ir-html.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,KAAK,IAAI,CAAC,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAIhD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,CAAC,CAAC,wBAAwB,EAChC,IAAI,GAAE,GAAG,CAAC,MAAM,CAAa,EAC7B,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;CAAO,GAC5D,MAAM,CAKR"}
+{"version":3,"file":"build-ir-html.d.ts","sourceRoot":"","sources":["../../../src/frontend/babel/build-ir-html.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,KAAK,IAAI,CAAC,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEnE;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,CAAC,CAAC,wBAAwB,EAChC,IAAI,GAAE,GAAG,CAAC,MAAM,CAAa,EAC7B,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;IAAC,IAAI,CAAC,EAAE,iBAAiB,CAAA;CAAO,GAC5E,MAAM,CAKR"}