@barefootjs/cli 0.8.0 → 0.9.1

package/dist/index.js

@@ -10,9 +10,9 @@ var __export = (target, all) => {
 };
 
 // src/lib/config-loader.ts
-import { existsSync, unlinkSync } from "fs";
-import { dirname, resolve } from "path";
-import { pathToFileURL } from "url";
+import { existsSync, unlinkSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
 function findBuildConfig(startDir) {
   const candidate = resolve(startDir, CONFIG_FILENAME);
   return existsSync(candidate) ? candidate : null;
@@ -75,10 +75,10 @@ var init_config_loader = __esm({
 });
 
 // src/lib/pm.ts
-import { existsSync as existsSync3 } from "fs";
-import path2 from "path";
+import { existsSync as existsSync3 } from "node:fs";
+import path2 from "node:path";
 function detectPackageManager(dir, env = process.env, versions = process.versions) {
-  for (const pm of ["bun", "pnpm", "yarn", "npm"]) {
+  for (const pm of ["bun", "pnpm", "yarn", "npm", "deno"]) {
     for (const file of LOCKFILES[pm]) {
       if (existsSync3(path2.join(dir, file))) return pm;
     }
@@ -94,8 +94,10 @@ function detectInvokingPackageManager(env = process.env, versions = process.vers
     if (ua.startsWith("pnpm/")) return "pnpm";
     if (ua.startsWith("yarn/")) return "yarn";
     if (ua.startsWith("npm/")) return "npm";
+    if (ua.startsWith("deno/")) return "deno";
   }
   if (versions.bun) return "bun";
+  if (versions.deno) return "deno";
   return null;
 }
 function commandsFor(pm) {
@@ -121,6 +123,24 @@ function commandsFor(pm) {
         exec: (c) => `yarn dlx ${c}`,
         test: (p) => p ? `yarn test ${p}` : "yarn test"
       };
+    case "deno":
+      return {
+        // Deno 2 reads `package.json` (and `deno.json` tasks), so
+        // `deno install` materialises the same dependency tree the
+        // other PMs produce — no separate `deno cache` step needed.
+        install: "deno install",
+        // package.json scripts surface as Deno tasks, so `deno task
+        // <script>` mirrors `bun run <script>` / `pnpm <script>`.
+        run: (s) => `deno task ${s}`,
+        // One-shot binaries run straight from npm via the `npm:`
+        // specifier; `-A` grants the filesystem/network access `bf`
+        // needs to download and write components.
+        exec: (c) => `deno run -A npm:${c}`,
+        // The scaffold's `test` task forwards extra args without a `--`
+        // separator (like bun/pnpm/yarn), so the targeted form just
+        // appends the path.
+        test: (p) => p ? `deno task test ${p}` : "deno task test"
+      };
     case "npm":
     default:
       return {
@@ -156,7 +176,8 @@ var init_pm = __esm({
       bun: ["bun.lock", "bun.lockb"],
       pnpm: ["pnpm-lock.yaml"],
       yarn: ["yarn.lock"],
-      npm: ["package-lock.json"]
+      npm: ["package-lock.json"],
+      deno: ["deno.lock", "deno.json", "deno.jsonc"]
     };
   }
 });
@@ -2665,7 +2686,7 @@ var init_analyzer_context = __esm({
 });
 
 // ../jsx/src/errors.ts
-import path3 from "path";
+import path3 from "node:path";
 function createError(code, loc, options) {
   if (code === void 0 || !(code in errorMessages)) {
     throw new Error(
@@ -2848,8 +2869,8 @@ var init_errors = __esm({
 
 // ../jsx/src/analyzer.ts
 import ts7 from "typescript";
-import path4 from "path";
-import fs from "fs";
+import path4 from "node:path";
+import fs from "node:fs";
 function needsTypeBasedDetection(source) {
   if (REACTIVE_BRAND_PACKAGES.some((pkg) => source.includes(pkg))) return true;
   if (/\.map\s*\(/.test(source)) return true;
@@ -8196,11 +8217,11 @@ function extractLoopParamBindings(pattern) {
           });
           return;
         }
-        const path23 = `${prefix}[${index}]`;
+        const path24 = `${prefix}[${index}]`;
         if (ts11.isIdentifier(el.name)) {
-          bindings.push({ name: el.name.text, path: path23 });
+          bindings.push({ name: el.name.text, path: path24 });
         } else {
-          walk(el.name, path23);
+          walk(el.name, path24);
         }
       }
       return;
@@ -8243,11 +8264,11 @@ function extractLoopParamBindings(pattern) {
         return;
       }
       collectedKeys.push({ key: keyText, isIdent: isIdent(keyText) });
-      const path23 = appendDotAccess(prefix, keyText);
+      const path24 = appendDotAccess(prefix, keyText);
       if (ts11.isIdentifier(el.name)) {
-        bindings.push({ name: el.name.text, path: path23 });
+        bindings.push({ name: el.name.text, path: path24 });
       } else {
-        walk(el.name, path23);
+        walk(el.name, path24);
       }
     }
   };
@@ -8701,11 +8722,11 @@ function transformMapCall(node, ctx2, isClientOnly = false, method = "map") {
           if (stmt === returnStmt) break;
           const js = ctx2.getJS(stmt);
           const tjs = ctx2.getTemplateJS(stmt);
-          const ts21 = stmt.getText(ctx2.sourceFile);
+          const ts22 = stmt.getText(ctx2.sourceFile);
           preambleStmts.push(js.endsWith(";") ? js : js + ";");
           templatePreambleStmts.push(tjs.endsWith(";") ? tjs : tjs + ";");
-          typedPreambleStmts.push(ts21.endsWith(";") ? ts21 : ts21 + ";");
-          if (js !== ts21) hasTypeDiff = true;
+          typedPreambleStmts.push(ts22.endsWith(";") ? ts22 : ts22 + ";");
+          if (js !== ts22) hasTypeDiff = true;
           if (js !== tjs) hasTemplateDiff = true;
         }
         if (preambleStmts.length > 0) {
@@ -16934,6 +16955,12 @@ function extractSsrDefaults(metadata) {
     out[metadata.restPropsName] = { isRestProps: true, value: {} };
   }
   const bindings = {};
+  for (const c of metadata.localConstants ?? []) {
+    if (!c.isModule || c.value === void 0) continue;
+    if (c.name in bindings) continue;
+    const v = tryStaticEval(c.value, { bindings, propsLike });
+    if (v !== UNRESOLVED) bindings[c.name] = v;
+  }
   for (const sig of metadata.signals) {
     if (!sig.getter || sig.isModule) continue;
     const value = tryStaticEval(sig.initialValue, { bindings, propsLike });
@@ -16979,8 +17006,22 @@ function evalNode(node, ctx2) {
   if (ts16.isTypeAssertionExpression(node)) return evalNode(node.expression, ctx2);
   if (ts16.isNonNullExpression(node)) return evalNode(node.expression, ctx2);
   if (ts16.isArrowFunction(node)) {
-    if (node.parameters.length === 0 && !ts16.isBlock(node.body)) {
-      return evalNode(node.body, ctx2);
+    if (node.parameters.length !== 0) return UNRESOLVED;
+    if (!ts16.isBlock(node.body)) return evalNode(node.body, ctx2);
+    const localBindings = { ...ctx2.bindings };
+    const localCtx = { ...ctx2, bindings: localBindings };
+    for (const stmt of node.body.statements) {
+      if (ts16.isVariableStatement(stmt)) {
+        for (const d of stmt.declarationList.declarations) {
+          if (!ts16.isIdentifier(d.name) || !d.initializer) continue;
+          const v = evalNode(d.initializer, localCtx);
+          if (v !== UNRESOLVED) localBindings[d.name.text] = v;
+        }
+      } else if (ts16.isReturnStatement(stmt)) {
+        return stmt.expression ? evalNode(stmt.expression, localCtx) : UNRESOLVED;
+      } else {
+        return UNRESOLVED;
+      }
     }
     return UNRESOLVED;
   }
@@ -17036,7 +17077,17 @@ function evalNode(node, ctx2) {
     }
     return arr;
   }
-  if (ts16.isPropertyAccessExpression(node) || ts16.isElementAccessExpression(node)) {
+  if (ts16.isElementAccessExpression(node)) {
+    const base = evalNode(node.expression, ctx2);
+    if (base === void 0) return void 0;
+    if (base === UNRESOLVED || base === null || typeof base !== "object") return UNRESOLVED;
+    if (!node.argumentExpression) return UNRESOLVED;
+    const key = evalNode(node.argumentExpression, ctx2);
+    if (key === UNRESOLVED || key === void 0 || key === null) return UNRESOLVED;
+    const k = String(key);
+    return Object.prototype.hasOwnProperty.call(base, k) ? base[k] : void 0;
+  }
+  if (ts16.isPropertyAccessExpression(node)) {
     const baseResult = evalNode(node.expression, ctx2);
     if (baseResult === void 0) return void 0;
     return UNRESOLVED;
@@ -17045,6 +17096,19 @@ function evalNode(node, ctx2) {
     if (node.arguments.length === 0 && ts16.isIdentifier(node.expression) && node.expression.text in ctx2.bindings) {
       return ctx2.bindings[node.expression.text];
     }
+    if (ts16.isPropertyAccessExpression(node.expression) && node.expression.name.text === "join") {
+      const recv = evalNode(node.expression.expression, ctx2);
+      if (Array.isArray(recv)) {
+        let sep = ",";
+        if (node.arguments.length >= 1) {
+          const sepVal = evalNode(node.arguments[0], ctx2);
+          if (typeof sepVal !== "string") return UNRESOLVED;
+          sep = sepVal;
+        }
+        return recv.map((x) => x === null || x === void 0 ? "" : `${x}`).join(sep);
+      }
+      return UNRESOLVED;
+    }
     return UNRESOLVED;
   }
   if (ts16.isConditionalExpression(node)) {
@@ -17117,6 +17181,39 @@ var init_ssr_defaults = __esm({
 });
 
 // ../jsx/src/compiler.ts
+function mergeTemplateImports(lines) {
+  const result = [];
+  const valueIdx = /* @__PURE__ */ new Map();
+  const valueNames = /* @__PURE__ */ new Map();
+  const typeIdx = /* @__PURE__ */ new Map();
+  const typeNames = /* @__PURE__ */ new Map();
+  const seenOther = /* @__PURE__ */ new Set();
+  const fold = (src, rawNames, idx, names, render) => {
+    if (!idx.has(src)) {
+      idx.set(src, result.length);
+      names.set(src, /* @__PURE__ */ new Set());
+      result.push("");
+    }
+    const set = names.get(src);
+    for (const n of rawNames.split(",").map((s) => s.trim()).filter(Boolean)) set.add(n);
+    result[idx.get(src)] = render(src, set);
+  };
+  for (const raw of lines) {
+    const line = raw.trim();
+    if (!line) continue;
+    const typeMatch = line.match(/^import\s+type\s*\{([^}]+)\}\s*from\s*['"]([^'"]+)['"]\s*;?$/);
+    const valueMatch = line.match(/^import\s*\{([^}]+)\}\s*from\s*['"]([^'"]+)['"]\s*;?$/);
+    if (valueMatch) {
+      fold(valueMatch[2], valueMatch[1], valueIdx, valueNames, (s, n) => `import { ${[...n].join(", ")} } from '${s}'`);
+    } else if (typeMatch) {
+      fold(typeMatch[2], typeMatch[1], typeIdx, typeNames, (s, n) => `import type { ${[...n].join(", ")} } from '${s}'`);
+    } else if (!seenOther.has(line)) {
+      seenOther.add(line);
+      result.push(line);
+    }
+  }
+  return result.filter(Boolean).join("\n");
+}
 function compileMultipleComponents(source, filePath, componentNames, options) {
   const files = [];
   const errors = [];
@@ -17279,19 +17376,9 @@ function compileMultipleComponents(source, filePath, componentNames, options) {
     }
     return { files, errors };
   }
-  const seenImportLines = /* @__PURE__ */ new Set();
-  const uniqueImports = [];
-  for (const output of allOutputs) {
-    if (output.imports) {
-      for (const line of output.imports.split("\n")) {
-        if (line.trim() && !seenImportLines.has(line)) {
-          seenImportLines.add(line);
-          uniqueImports.push(line);
-        }
-      }
-    }
-  }
-  const mergedImports = uniqueImports.join("\n");
+  const mergedImports = mergeTemplateImports(
+    allOutputs.flatMap((o) => o.imports ? o.imports.split("\n") : [])
+  );
   const seenTypes = /* @__PURE__ */ new Set();
   const uniqueTypes = [];
   for (const output of allOutputs) {
@@ -17605,7 +17692,7 @@ var init_compiler = __esm({
 
 // ../jsx/src/shared-program.ts
 import ts17 from "typescript";
-import path5 from "path";
+import path5 from "node:path";
 function commonParent(paths) {
   if (paths.length === 0) return process.cwd();
   if (paths.length === 1) return path5.dirname(paths[0]);
@@ -18460,9 +18547,9 @@ function formatEventSummary(summary, graph) {
     if (updatedSignals.size > 0) {
       const targets = [];
       for (const sig of updatedSignals) {
-        const path23 = traceUpdatePath(graph, sig);
-        if (path23 && path23.dependents.length > 0) {
-          const downstream = flattenUpdateTargets(path23.dependents);
+        const path24 = traceUpdatePath(graph, sig);
+        if (path24 && path24.dependents.length > 0) {
+          const downstream = flattenUpdateTargets(path24.dependents);
           targets.push(`${sig} -> ${downstream.join(", ")}`);
         }
       }
@@ -18872,10 +18959,10 @@ function formatComponentGraph(graph) {
   }
   return lines.join("\n");
 }
-function formatUpdatePath(path23) {
+function formatUpdatePath(path24) {
   const lines = [];
-  lines.push(`${path23.target} (${path23.kind})`);
-  for (const entry of path23.dependents) {
+  lines.push(`${path24.target} (${path24.kind})`);
+  for (const entry of path24.dependents) {
     formatEntry(entry, lines, "  ");
   }
   return lines.join("\n");
@@ -19352,6 +19439,207 @@ var init_debug = __esm({
   }
 });
 
+// ../jsx/src/augment-inherited-props.ts
+import ts19 from "typescript";
+function collectContextConsumers(metadata) {
+  const constants = metadata.localConstants ?? [];
+  const contextDefaults = /* @__PURE__ */ new Map();
+  for (const c of constants) {
+    if (c.systemConstructKind !== "createContext" || c.value === void 0) continue;
+    contextDefaults.set(c.name, parseCreateContextDefault(c.value));
+  }
+  if (contextDefaults.size === 0) return [];
+  const consumers = [];
+  for (const c of constants) {
+    if (c.value === void 0) continue;
+    const ctxName = parseUseContextArg(c.value);
+    if (ctxName === null || !contextDefaults.has(ctxName)) continue;
+    consumers.push({
+      localName: c.name,
+      contextName: ctxName,
+      defaultValue: contextDefaults.get(ctxName) ?? null
+    });
+  }
+  return consumers;
+}
+function parseUseContextArg(source) {
+  const expr = parseSingleExpression(source);
+  if (!expr || !ts19.isCallExpression(expr)) return null;
+  if (!ts19.isIdentifier(expr.expression) || expr.expression.text !== "useContext") return null;
+  if (expr.arguments.length !== 1) return null;
+  const arg = expr.arguments[0];
+  return ts19.isIdentifier(arg) ? arg.text : null;
+}
+function parseCreateContextDefault(source) {
+  const expr = parseSingleExpression(source);
+  if (!expr || !ts19.isCallExpression(expr)) return null;
+  if (expr.arguments.length === 0) return null;
+  const arg = expr.arguments[0];
+  if (ts19.isStringLiteral(arg) || ts19.isNoSubstitutionTemplateLiteral(arg)) return arg.text;
+  if (ts19.isNumericLiteral(arg)) return Number(arg.text);
+  if (arg.kind === ts19.SyntaxKind.TrueKeyword) return true;
+  if (arg.kind === ts19.SyntaxKind.FalseKeyword) return false;
+  return null;
+}
+function parseSingleExpression(source) {
+  const sf = ts19.createSourceFile("__ctx.ts", `(${source})`, ts19.ScriptTarget.Latest, false);
+  const stmt = sf.statements[0];
+  if (!stmt || !ts19.isExpressionStatement(stmt)) return null;
+  let e = stmt.expression;
+  while (ts19.isParenthesizedExpression(e)) e = e.expression;
+  return e;
+}
+function augmentInheritedPropAccesses(ir) {
+  const propsObj = ir.metadata.propsObjectName;
+  if (!propsObj) return;
+  const existing = new Set(ir.metadata.propsParams.map((p) => p.name));
+  const bareRefProps = /* @__PURE__ */ new Set();
+  const booleanAttrProps = /* @__PURE__ */ new Set();
+  const accessed = /* @__PURE__ */ new Set();
+  const accessRe = new RegExp(`(?:^|[^\\w$.])${propsObj}\\.([A-Za-z_$][\\w$]*)`, "g");
+  const scan = (s) => {
+    if (!s) return;
+    for (const m of s.matchAll(accessRe)) accessed.add(m[1]);
+  };
+  for (const memo of ir.metadata.memos) scan(memo.computation);
+  for (const signal of ir.metadata.signals) scan(signal.initialValue);
+  for (const stmt of ir.metadata.initStatements ?? []) scan(stmt.body);
+  for (const eff of ir.metadata.effects ?? []) scan(eff.body);
+  for (const c of ir.metadata.localConstants ?? []) {
+    if (c.isModule) continue;
+    scan(c.value);
+  }
+  const walk = (node) => {
+    if (!node) return;
+    const el = node;
+    for (const attr of el.attrs ?? []) {
+      const v = attr.value;
+      if (v?.kind === "expression" && typeof v.expr === "string") {
+        scan(v.expr);
+        const expr = v.expr.trim();
+        const prefix = `${propsObj}.`;
+        if (isBooleanAttr(attr.name) || v.presenceOrUndefined) {
+          const m = expr.match(new RegExp(`^${propsObj}\\.([A-Za-z_$][\\w$]*)`));
+          if (m) booleanAttrProps.add(m[1]);
+        } else if (expr.startsWith(prefix)) {
+          const rest2 = expr.slice(prefix.length);
+          if (/^[A-Za-z_$][\w$]*$/.test(rest2)) bareRefProps.add(rest2);
+        }
+      }
+    }
+    for (const child of el.children ?? []) {
+      const c = child;
+      walk(c.element ?? child);
+    }
+  };
+  walk(ir.root);
+  for (const name of accessed) {
+    if (existing.has(name)) continue;
+    let raw;
+    if (booleanAttrProps.has(name)) raw = "boolean";
+    else if (bareRefProps.has(name)) raw = "unknown";
+    else raw = "string";
+    const type = raw === "boolean" ? { kind: "primitive", raw: "boolean", primitive: "boolean" } : raw === "string" ? { kind: "primitive", raw: "string", primitive: "string" } : { kind: "unknown", raw: "unknown" };
+    ir.metadata.propsParams.push({ name, type, optional: true });
+    existing.add(name);
+  }
+}
+function evalStringArrayJoin(source) {
+  const sf = ts19.createSourceFile(
+    "__join.ts",
+    `const __x = (${source});`,
+    ts19.ScriptTarget.Latest,
+    /*setParentNodes*/
+    false
+  );
+  const stmt = sf.statements[0];
+  if (!stmt || !ts19.isVariableStatement(stmt)) return null;
+  let node = stmt.declarationList.declarations[0]?.initializer;
+  while (node && ts19.isParenthesizedExpression(node)) node = node.expression;
+  if (!node || !ts19.isCallExpression(node)) return null;
+  const callee = node.expression;
+  if (!ts19.isPropertyAccessExpression(callee)) return null;
+  if (callee.name.text !== "join") return null;
+  let recv = callee.expression;
+  while (ts19.isParenthesizedExpression(recv)) recv = recv.expression;
+  if (!ts19.isArrayLiteralExpression(recv)) return null;
+  const parts = [];
+  for (const el of recv.elements) {
+    if (ts19.isStringLiteral(el) || ts19.isNoSubstitutionTemplateLiteral(el)) {
+      parts.push(el.text);
+    } else {
+      return null;
+    }
+  }
+  let sep = ",";
+  if (node.arguments.length >= 1) {
+    const arg = node.arguments[0];
+    if (ts19.isStringLiteral(arg) || ts19.isNoSubstitutionTemplateLiteral(arg)) sep = arg.text;
+    else return null;
+  }
+  return parts.join(sep);
+}
+function parseRecordIndexAccess(val, localConstants, propsParams, resolveKey) {
+  if (!ts19.isElementAccessExpression(val)) return null;
+  const obj = val.expression;
+  const arg = val.argumentExpression;
+  if (!ts19.isIdentifier(obj) || !ts19.isIdentifier(arg)) return null;
+  let indexPropName;
+  let defaultKey;
+  const resolved = resolveKey?.(arg.text);
+  if (resolved) {
+    indexPropName = resolved.propName;
+    defaultKey = resolved.defaultLiteral;
+  } else if (propsParams.some((p) => p.name === arg.text)) {
+    indexPropName = arg.text;
+  } else {
+    return null;
+  }
+  const constInfo = localConstants.find((c) => c.name === obj.text && c.isModule);
+  if (constInfo?.value === void 0) return null;
+  const sf = ts19.createSourceFile(
+    "__rec.ts",
+    `(${constInfo.value})`,
+    ts19.ScriptTarget.Latest,
+    /* setParentNodes */
+    true
+  );
+  if (sf.statements.length !== 1) return null;
+  const stmt = sf.statements[0];
+  if (!ts19.isExpressionStatement(stmt)) return null;
+  let parsed = stmt.expression;
+  while (ts19.isParenthesizedExpression(parsed)) parsed = parsed.expression;
+  if (!ts19.isObjectLiteralExpression(parsed)) return null;
+  const entries = [];
+  for (const prop of parsed.properties) {
+    if (!ts19.isPropertyAssignment(prop)) return null;
+    let key;
+    if (ts19.isIdentifier(prop.name)) {
+      key = prop.name.text;
+    } else if (ts19.isStringLiteral(prop.name) || ts19.isNoSubstitutionTemplateLiteral(prop.name)) {
+      key = prop.name.text;
+    } else {
+      return null;
+    }
+    let v = prop.initializer;
+    while (ts19.isParenthesizedExpression(v)) v = v.expression;
+    if (ts19.isNumericLiteral(v)) {
+      entries.push({ key, value: { kind: "number", text: v.text } });
+    } else if (ts19.isStringLiteral(v) || ts19.isNoSubstitutionTemplateLiteral(v)) {
+      entries.push({ key, value: { kind: "string", text: v.text } });
+    } else {
+      return null;
+    }
+  }
+  return { indexPropName, entries, defaultKey };
+}
+var init_augment_inherited_props = __esm({
+  "../jsx/src/augment-inherited-props.ts"() {
+    "use strict";
+    init_html_constants();
+  }
+});
+
 // ../jsx/src/index.ts
 var src_exports = {};
 __export(src_exports, {
@@ -19366,6 +19654,7 @@ __export(src_exports, {
   analyzeClientNeeds: () => analyzeClientNeeds,
   analyzeComponent: () => analyzeComponent,
   applyCssLayerPrefix: () => applyCssLayerPrefix,
+  augmentInheritedPropAccesses: () => augmentInheritedPropAccesses,
   buildComponentAnalysis: () => buildComponentAnalysis,
   buildComponentGraph: () => buildComponentGraph,
   buildComponentSummary: () => buildComponentSummary,
@@ -19377,6 +19666,7 @@ __export(src_exports, {
   buildMetadata: () => buildMetadata,
   buildSourceMapFromIR: () => buildSourceMapFromIR,
   buildWhyUpdate: () => buildWhyUpdate,
+  collectContextConsumers: () => collectContextConsumers,
   combineParentChildClientJs: () => combineParentChildClientJs,
   compileJSX: () => compileJSX,
   containsHigherOrder: () => containsHigherOrder,
@@ -19389,6 +19679,7 @@ __export(src_exports, {
   emitIRNode: () => emitIRNode,
   emitParsedExpr: () => emitParsedExpr,
   enableCompilerInstrumentation: () => enableCompilerInstrumentation,
+  evalStringArrayJoin: () => evalStringArrayJoin,
   exprToString: () => exprToString,
   extractFunctionParams: () => extractFunctionParams,
   extractSsrDefaults: () => extractSsrDefaults,
@@ -19420,6 +19711,7 @@ __export(src_exports, {
   needsTypeBasedDetection: () => needsTypeBasedDetection,
   parseBlockBody: () => parseBlockBody,
   parseExpression: () => parseExpression,
+  parseRecordIndexAccess: () => parseRecordIndexAccess,
   renderImportMapHtml: () => renderImportMapHtml,
   resetCompilerCounters: () => resetCompilerCounters,
   resolveSetters: () => resolveSetters,
@@ -19454,6 +19746,7 @@ var init_src2 = __esm({
     init_loop_chain();
     init_debug();
     init_html_constants();
+    init_augment_inherited_props();
   }
 });
 
@@ -19462,23 +19755,23 @@ import { createHash } from "node:crypto";
 import { access, readFile, writeFile, glob as fsGlob } from "node:fs/promises";
 import { constants as fsConstants } from "node:fs";
 import { transformSync } from "esbuild";
-async function readText(path23) {
-  return readFile(path23, "utf8");
+async function readText(path24) {
+  return readFile(path24, "utf8");
 }
-async function readBytes(path23) {
-  const buf = await readFile(path23);
+async function readBytes(path24) {
+  const buf = await readFile(path24);
   return new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);
 }
-async function writeText(path23, content) {
-  await writeFile(path23, content, "utf8");
+async function writeText(path24, content) {
+  await writeFile(path24, content, "utf8");
 }
-async function writeBytes(path23, content) {
+async function writeBytes(path24, content) {
   const bytes = content instanceof ArrayBuffer ? new Uint8Array(content) : content;
-  await writeFile(path23, bytes);
+  await writeFile(path24, bytes);
 }
-async function fileExists(path23) {
+async function fileExists(path24) {
   try {
-    await access(path23, fsConstants.F_OK);
+    await access(path24, fsConstants.F_OK);
     return true;
   } catch {
     return false;
@@ -19518,7 +19811,7 @@ var init_runtime = __esm({
 
 // src/lib/resolve-imports.ts
 import { dirname as dirname2, resolve as resolve2 } from "node:path";
-import ts19 from "typescript";
+import ts20 from "typescript";
 function shapeFromDecl(decl) {
   const clause = decl.importClause;
   if (!clause) return null;
@@ -19528,7 +19821,7 @@ function shapeFromDecl(decl) {
   }
   const bindings = clause.namedBindings;
   if (bindings) {
-    if (ts19.isNamespaceImport(bindings)) {
+    if (ts20.isNamespaceImport(bindings)) {
       shape.namespace = bindings.name.text;
     } else {
       for (const el of bindings.elements) {
@@ -19542,38 +19835,38 @@ function shapeFromDecl(decl) {
 }
 function collectExportedNames(source) {
   const names = /* @__PURE__ */ new Set();
-  const sourceFile = ts19.createSourceFile(
+  const sourceFile = ts20.createSourceFile(
     "mod.ts",
     source,
-    ts19.ScriptTarget.Latest,
+    ts20.ScriptTarget.Latest,
     /*setParents*/
     false,
-    ts19.ScriptKind.TS
+    ts20.ScriptKind.TS
   );
   function hasExport(node) {
-    if (!ts19.canHaveModifiers(node)) return false;
-    const mods = ts19.getModifiers(node);
-    return mods?.some((m) => m.kind === ts19.SyntaxKind.ExportKeyword) ?? false;
+    if (!ts20.canHaveModifiers(node)) return false;
+    const mods = ts20.getModifiers(node);
+    return mods?.some((m) => m.kind === ts20.SyntaxKind.ExportKeyword) ?? false;
   }
   function collectFromBindingName(name) {
-    if (ts19.isIdentifier(name)) {
+    if (ts20.isIdentifier(name)) {
       names.add(name.text);
       return;
     }
     for (const el of name.elements) {
-      if (ts19.isBindingElement(el)) collectFromBindingName(el.name);
+      if (ts20.isBindingElement(el)) collectFromBindingName(el.name);
     }
   }
   for (const stmt of sourceFile.statements) {
-    if (ts19.isVariableStatement(stmt) && hasExport(stmt)) {
+    if (ts20.isVariableStatement(stmt) && hasExport(stmt)) {
       for (const d of stmt.declarationList.declarations) {
         collectFromBindingName(d.name);
       }
-    } else if (ts19.isFunctionDeclaration(stmt) && hasExport(stmt) && stmt.name) {
+    } else if (ts20.isFunctionDeclaration(stmt) && hasExport(stmt) && stmt.name) {
       names.add(stmt.name.text);
-    } else if (ts19.isClassDeclaration(stmt) && hasExport(stmt) && stmt.name) {
+    } else if (ts20.isClassDeclaration(stmt) && hasExport(stmt) && stmt.name) {
       names.add(stmt.name.text);
-    } else if (ts19.isExportDeclaration(stmt) && !stmt.moduleSpecifier && stmt.exportClause && ts19.isNamedExports(stmt.exportClause)) {
+    } else if (ts20.isExportDeclaration(stmt) && !stmt.moduleSpecifier && stmt.exportClause && ts20.isNamedExports(stmt.exportClause)) {
       if (stmt.isTypeOnly) continue;
       for (const el of stmt.exportClause.elements) {
         if (el.isTypeOnly) continue;
@@ -19584,16 +19877,16 @@ function collectExportedNames(source) {
   return [...names];
 }
 function hasUseClientDirective(source) {
-  const sourceFile = ts19.createSourceFile(
+  const sourceFile = ts20.createSourceFile(
     "check.tsx",
     source,
-    ts19.ScriptTarget.Latest,
+    ts20.ScriptTarget.Latest,
     /*setParents*/
     false,
-    ts19.ScriptKind.TSX
+    ts20.ScriptKind.TSX
   );
   for (const stmt of sourceFile.statements) {
-    if (!ts19.isExpressionStatement(stmt) || !ts19.isStringLiteral(stmt.expression)) {
+    if (!ts20.isExpressionStatement(stmt) || !ts20.isStringLiteral(stmt.expression)) {
       return false;
     }
     if (stmt.expression.text === "use client") return true;
@@ -19602,55 +19895,55 @@ function hasUseClientDirective(source) {
 }
 function collectTopLevelBindings(source) {
   const names = /* @__PURE__ */ new Set();
-  const sourceFile = ts19.createSourceFile(
+  const sourceFile = ts20.createSourceFile(
     "bundle.ts",
     source,
-    ts19.ScriptTarget.Latest,
+    ts20.ScriptTarget.Latest,
     /*setParents*/
     false,
-    ts19.ScriptKind.TS
+    ts20.ScriptKind.TS
   );
   function collectFromBindingName(name) {
-    if (ts19.isIdentifier(name)) {
+    if (ts20.isIdentifier(name)) {
       names.add(name.text);
       return;
     }
     for (const el of name.elements) {
-      if (ts19.isBindingElement(el)) collectFromBindingName(el.name);
+      if (ts20.isBindingElement(el)) collectFromBindingName(el.name);
     }
   }
   for (const stmt of sourceFile.statements) {
-    if (ts19.isVariableStatement(stmt)) {
+    if (ts20.isVariableStatement(stmt)) {
       for (const d of stmt.declarationList.declarations) {
         collectFromBindingName(d.name);
       }
-    } else if (ts19.isFunctionDeclaration(stmt) && stmt.name) {
+    } else if (ts20.isFunctionDeclaration(stmt) && stmt.name) {
       names.add(stmt.name.text);
-    } else if (ts19.isClassDeclaration(stmt) && stmt.name) {
+    } else if (ts20.isClassDeclaration(stmt) && stmt.name) {
       names.add(stmt.name.text);
     }
   }
   return names;
 }
 function stripImportsAndExports(body) {
-  const sourceFile = ts19.createSourceFile(
+  const sourceFile = ts20.createSourceFile(
     "body.ts",
     body,
-    ts19.ScriptTarget.Latest,
+    ts20.ScriptTarget.Latest,
     /*setParents*/
     false,
-    ts19.ScriptKind.TS
+    ts20.ScriptKind.TS
   );
   const spans = [];
   const hoistedImports = [];
   for (const stmt of sourceFile.statements) {
-    if (ts19.isImportDeclaration(stmt)) {
+    if (ts20.isImportDeclaration(stmt)) {
       const start = stmt.getStart(sourceFile);
       const end = stmt.getEnd();
       const specifier = stmt.moduleSpecifier;
-      if (ts19.isStringLiteral(specifier)) {
-        const path23 = specifier.text;
-        const isRelative = path23.startsWith("./") || path23.startsWith("../");
+      if (ts20.isStringLiteral(specifier)) {
+        const path24 = specifier.text;
+        const isRelative = path24.startsWith("./") || path24.startsWith("../");
         if (!isRelative) {
           hoistedImports.push(body.slice(start, end));
         }
@@ -19658,24 +19951,24 @@ function stripImportsAndExports(body) {
       spans.push([start, end]);
       continue;
     }
-    if (ts19.isExportDeclaration(stmt)) {
+    if (ts20.isExportDeclaration(stmt)) {
       spans.push([stmt.getStart(sourceFile), stmt.getEnd()]);
       continue;
     }
-    if (ts19.isExportAssignment(stmt)) {
-      const exportKw = stmt.getChildren(sourceFile).find((c) => c.kind === ts19.SyntaxKind.ExportKeyword);
-      const defaultKw = stmt.getChildren(sourceFile).find((c) => c.kind === ts19.SyntaxKind.DefaultKeyword);
-      const equalsKw = stmt.getChildren(sourceFile).find((c) => c.kind === ts19.SyntaxKind.EqualsToken);
+    if (ts20.isExportAssignment(stmt)) {
+      const exportKw = stmt.getChildren(sourceFile).find((c) => c.kind === ts20.SyntaxKind.ExportKeyword);
+      const defaultKw = stmt.getChildren(sourceFile).find((c) => c.kind === ts20.SyntaxKind.DefaultKeyword);
+      const equalsKw = stmt.getChildren(sourceFile).find((c) => c.kind === ts20.SyntaxKind.EqualsToken);
       const start = exportKw?.getStart(sourceFile) ?? stmt.getStart(sourceFile);
       const end = (defaultKw ?? equalsKw)?.getEnd() ?? exportKw?.getEnd() ?? stmt.getStart(sourceFile);
       if (end > start) spans.push([start, end]);
       continue;
     }
-    if (ts19.canHaveModifiers(stmt)) {
-      const mods = ts19.getModifiers(stmt);
+    if (ts20.canHaveModifiers(stmt)) {
+      const mods = ts20.getModifiers(stmt);
       if (!mods) continue;
       for (const mod of mods) {
-        if (mod.kind === ts19.SyntaxKind.ExportKeyword) {
+        if (mod.kind === ts20.SyntaxKind.ExportKeyword) {
           const start = mod.getStart(sourceFile);
           let end = mod.getEnd();
           while (end < body.length && /\s/.test(body[end])) end++;
@@ -19784,48 +20077,48 @@ function buildDanglingReferenceMessage(binding, s) {
 function isValueReference(id) {
   const parent = id.parent;
   if (!parent) return false;
-  if (ts19.isPropertyAccessExpression(parent) && parent.name === id) return false;
-  if (ts19.isPropertyAssignment(parent) && parent.name === id) return false;
-  if ((ts19.isMethodDeclaration(parent) || ts19.isGetAccessorDeclaration(parent) || ts19.isSetAccessorDeclaration(parent)) && parent.name === id) {
+  if (ts20.isPropertyAccessExpression(parent) && parent.name === id) return false;
+  if (ts20.isPropertyAssignment(parent) && parent.name === id) return false;
+  if ((ts20.isMethodDeclaration(parent) || ts20.isGetAccessorDeclaration(parent) || ts20.isSetAccessorDeclaration(parent)) && parent.name === id) {
     return false;
   }
-  if (ts19.isVariableDeclaration(parent) && parent.name === id) return false;
-  if (ts19.isFunctionDeclaration(parent) && parent.name === id) return false;
-  if (ts19.isFunctionExpression(parent) && parent.name === id) return false;
-  if (ts19.isClassDeclaration(parent) && parent.name === id) return false;
-  if (ts19.isClassExpression(parent) && parent.name === id) return false;
-  if (ts19.isParameter(parent) && parent.name === id) return false;
-  if (ts19.isBindingElement(parent) && (parent.name === id || parent.propertyName === id)) return false;
-  if (ts19.isLabeledStatement(parent) && parent.label === id) return false;
-  if (ts19.isBreakOrContinueStatement(parent) && parent.label === id) return false;
-  if (ts19.isImportSpecifier(parent) && (parent.name === id || parent.propertyName === id)) return false;
-  if (ts19.isExportSpecifier(parent) && (parent.name === id || parent.propertyName === id)) return false;
-  if (ts19.isImportClause(parent) && parent.name === id) return false;
-  if (ts19.isNamespaceImport(parent) && parent.name === id) return false;
-  if (ts19.isQualifiedName(parent) && parent.right === id) return false;
+  if (ts20.isVariableDeclaration(parent) && parent.name === id) return false;
+  if (ts20.isFunctionDeclaration(parent) && parent.name === id) return false;
+  if (ts20.isFunctionExpression(parent) && parent.name === id) return false;
+  if (ts20.isClassDeclaration(parent) && parent.name === id) return false;
+  if (ts20.isClassExpression(parent) && parent.name === id) return false;
+  if (ts20.isParameter(parent) && parent.name === id) return false;
+  if (ts20.isBindingElement(parent) && (parent.name === id || parent.propertyName === id)) return false;
+  if (ts20.isLabeledStatement(parent) && parent.label === id) return false;
+  if (ts20.isBreakOrContinueStatement(parent) && parent.label === id) return false;
+  if (ts20.isImportSpecifier(parent) && (parent.name === id || parent.propertyName === id)) return false;
+  if (ts20.isExportSpecifier(parent) && (parent.name === id || parent.propertyName === id)) return false;
+  if (ts20.isImportClause(parent) && parent.name === id) return false;
+  if (ts20.isNamespaceImport(parent) && parent.name === id) return false;
+  if (ts20.isQualifiedName(parent) && parent.right === id) return false;
   return true;
 }
 function detectStrippedReferences(bundleSource, stripped) {
   if (stripped.length === 0) return [];
   let sf;
   try {
-    sf = ts19.createSourceFile(
+    sf = ts20.createSourceFile(
       "bundle.js",
       bundleSource,
-      ts19.ScriptTarget.Latest,
+      ts20.ScriptTarget.Latest,
       /*setParents*/
       true,
-      ts19.ScriptKind.JS
+      ts20.ScriptKind.JS
     );
   } catch {
     return [];
   }
   const firstReference = /* @__PURE__ */ new Map();
   function visit3(node) {
-    if (ts19.isIdentifier(node) && isValueReference(node)) {
+    if (ts20.isIdentifier(node) && isValueReference(node)) {
       if (!firstReference.has(node.text)) firstReference.set(node.text, node);
     }
-    ts19.forEachChild(node, visit3);
+    ts20.forEachChild(node, visit3);
   }
   visit3(sf);
   const errors = [];
@@ -19855,18 +20148,18 @@ function detectStrippedReferences(bundleSource, stripped) {
   return errors;
 }
 async function walkAndCollect(content, searchDirs, modules, visiting, loggingPath, stripped, stubDeps, nextId) {
-  const sourceFile = ts19.createSourceFile(
+  const sourceFile = ts20.createSourceFile(
     "walk.js",
     content,
-    ts19.ScriptTarget.Latest,
+    ts20.ScriptTarget.Latest,
     /*setParents*/
     false,
-    ts19.ScriptKind.JS
+    ts20.ScriptKind.JS
   );
   const sites = [];
   for (const stmt of sourceFile.statements) {
-    if (!ts19.isImportDeclaration(stmt)) continue;
-    if (!ts19.isStringLiteral(stmt.moduleSpecifier)) continue;
+    if (!ts20.isImportDeclaration(stmt)) continue;
+    if (!ts20.isStringLiteral(stmt.moduleSpecifier)) continue;
     const spec = stmt.moduleSpecifier.text;
     if (!spec.startsWith("./") && !spec.startsWith("../")) continue;
     const start = stmt.getStart(sourceFile);
@@ -19976,15 +20269,15 @@ async function walkAndCollect(content, searchDirs, modules, visiting, loggingPat
 function topoSort(modules) {
   const visited = /* @__PURE__ */ new Set();
   const order = [];
-  function visit3(path23) {
-    if (visited.has(path23)) return;
-    visited.add(path23);
-    const mod = modules.get(path23);
+  function visit3(path24) {
+    if (visited.has(path24)) return;
+    visited.add(path24);
+    const mod = modules.get(path24);
     if (!mod) return;
     for (const dep of mod.imports) visit3(dep);
     order.push(mod);
   }
-  for (const path23 of modules.keys()) visit3(path23);
+  for (const path24 of modules.keys()) visit3(path24);
   return order;
 }
 async function inlineRelativeImports(content, searchDirs, loggingPath, hoistedAcc, errorAcc, stubDeps) {
@@ -20089,10 +20382,10 @@ function emptyCache(globalHash) {
   return { globalHash, entries: {} };
 }
 async function loadCache(outDir) {
-  const path23 = resolve3(outDir, CACHE_FILENAME);
-  if (!await fileExists(path23)) return null;
+  const path24 = resolve3(outDir, CACHE_FILENAME);
+  if (!await fileExists(path24)) return null;
   try {
-    const parsed = JSON.parse(await readText(path23));
+    const parsed = JSON.parse(await readText(path24));
     if (typeof parsed.globalHash !== "string" || typeof parsed.entries !== "object") {
       return null;
     }
@@ -20102,8 +20395,8 @@ async function loadCache(outDir) {
   }
 }
 async function saveCache(outDir, cache) {
-  const path23 = resolve3(outDir, CACHE_FILENAME);
-  await writeText(path23, JSON.stringify(cache, null, 2));
+  const path24 = resolve3(outDir, CACHE_FILENAME);
+  await writeText(path24, JSON.stringify(cache, null, 2));
 }
 function isEntryFresh(entry, currentSourceHash, depHash) {
   if (entry.hash !== currentSourceHash) return false;
@@ -20123,24 +20416,24 @@ var init_build_cache = __esm({
 });
 
 // src/lib/fs-utils.ts
-async function writeIfChanged(path23, content) {
-  if (await fileExists(path23)) {
+async function writeIfChanged(path24, content) {
+  if (await fileExists(path24)) {
     if (typeof content === "string") {
-      const prev2 = await readText(path23);
+      const prev2 = await readText(path24);
       if (prev2 === content) return false;
-      await writeText(path23, content);
+      await writeText(path24, content);
       return true;
     }
-    const prev = await readBytes(path23);
+    const prev = await readBytes(path24);
     const next = toUint8Array(content);
     if (equalBytes(prev, next)) return false;
-    await writeBytes(path23, next);
+    await writeBytes(path24, next);
     return true;
   }
   if (typeof content === "string") {
-    await writeText(path23, content);
+    await writeText(path24, content);
   } else {
-    await writeBytes(path23, toUint8Array(content));
+    await writeBytes(path24, toUint8Array(content));
   }
   return true;
 }
@@ -20195,10 +20488,10 @@ function denormalizeKey(diskKey, projectDir) {
   return resolve4(projectDir, diskKey);
 }
 async function loadEmitLedger(outDir, projectDir) {
-  const path23 = resolve4(outDir, EMIT_LEDGER_FILENAME);
-  if (!await fileExists(path23)) return null;
+  const path24 = resolve4(outDir, EMIT_LEDGER_FILENAME);
+  if (!await fileExists(path24)) return null;
   try {
-    const parsed = JSON.parse(await readText(path23));
+    const parsed = JSON.parse(await readText(path24));
     if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed) || parsed.version !== EMIT_LEDGER_VERSION || typeof parsed.entries !== "object" || parsed.entries === null || Array.isArray(parsed.entries)) {
       return null;
     }
@@ -20215,13 +20508,13 @@ async function loadEmitLedger(outDir, projectDir) {
   }
 }
 async function saveEmitLedger(outDir, projectDir, ledger) {
-  const path23 = resolve4(outDir, EMIT_LEDGER_FILENAME);
+  const path24 = resolve4(outDir, EMIT_LEDGER_FILENAME);
   const serialized = {};
   for (const [absKey, outputs] of Object.entries(ledger.entries)) {
     serialized[normalizeKey(absKey, projectDir)] = outputs;
   }
   const onDisk = { version: ledger.version, entries: serialized };
-  await writeIfChanged(path23, JSON.stringify(onDisk, null, 2));
+  await writeIfChanged(path24, JSON.stringify(onDisk, null, 2));
 }
 function extractLedgerFromCache(cache) {
   if (!cache) return {};
@@ -20291,8 +20584,8 @@ function buildManagedBlock(entries) {
   ].join("\n");
 }
 async function writeAssetsIgnore(outDir, entries) {
-  const path23 = resolve5(outDir, ASSETS_IGNORE_FILENAME);
-  const existing = await fileExists(path23) ? await readText(path23) : "";
+  const path24 = resolve5(outDir, ASSETS_IGNORE_FILENAME);
+  const existing = await fileExists(path24) ? await readText(path24) : "";
   const userContent = stripManagedBlock(existing);
   const block = buildManagedBlock(entries);
   const merged = userContent.length > 0 ? `${userContent}
@@ -20300,7 +20593,7 @@ async function writeAssetsIgnore(outDir, entries) {
 ${block}
 ` : `${block}
 `;
-  return writeIfChanged(path23, merged);
+  return writeIfChanged(path24, merged);
 }
 var ASSETS_IGNORE_FILENAME, BLOCK_BEGIN, BLOCK_END, WRANGLER_CONFIG_NAMES;
 var init_assets_ignore = __esm({
@@ -20318,7 +20611,7 @@ var init_assets_ignore = __esm({
 });
 
 // src/lib/build.ts
-import ts20 from "typescript";
+import ts21 from "typescript";
 import { mkdir, readdir, stat, unlink } from "node:fs/promises";
 import { resolve as resolve6, basename, relative as relative2, dirname as dirname3, isAbsolute as isAbsolute2 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
@@ -20355,7 +20648,9 @@ async function discoverComponentFiles(dir, options) {
   const skipDirs = options?.skipDirs ? new Set(options.skipDirs) : null;
   let entries;
   try {
-    entries = await readdir(dir, { withFileTypes: true });
+    entries = (await readdir(dir, { withFileTypes: true })).sort(
+      (a, b) => String(a.name).localeCompare(String(b.name))
+    );
   } catch {
     return results;
   }
@@ -20864,7 +21159,7 @@ async function build(config, options = {}) {
   };
 }
 function extractBareImports(code) {
-  const { importedFiles } = ts20.preProcessFile(code, true, true);
+  const { importedFiles } = ts21.preProcessFile(code, true, true);
   const specifiers = /* @__PURE__ */ new Set();
   for (const { fileName } of importedFiles) {
     if (!fileName.startsWith(".") && !fileName.startsWith("/") && !fileName.includes("://")) {
@@ -20931,16 +21226,16 @@ function effectiveOutName(tplPath, entryBaseNoExt) {
 }
 function topLevelImportLines(content) {
   const lines = /* @__PURE__ */ new Set();
-  const sourceFile = ts20.createSourceFile(
+  const sourceFile = ts21.createSourceFile(
     "merge.js",
     content,
-    ts20.ScriptTarget.Latest,
+    ts21.ScriptTarget.Latest,
     /*setParentNodes*/
     true,
-    ts20.ScriptKind.JS
+    ts21.ScriptKind.JS
   );
   for (const stmt of sourceFile.statements) {
-    if (ts20.isImportDeclaration(stmt)) {
+    if (ts21.isImportDeclaration(stmt)) {
       const { line } = sourceFile.getLineAndCharacterOfPosition(stmt.getStart(sourceFile));
       lines.add(line);
     }
@@ -20949,29 +21244,29 @@ function topLevelImportLines(content) {
 }
 function rewriteBarefootClientSpecifiers(content, rel) {
   if (!content.includes("@barefootjs/client")) return content;
-  const sourceFile = ts20.createSourceFile(
+  const sourceFile = ts21.createSourceFile(
     "client.js",
     content,
-    ts20.ScriptTarget.Latest,
+    ts21.ScriptTarget.Latest,
     /*setParentNodes*/
     true,
-    ts20.ScriptKind.JS
+    ts21.ScriptKind.JS
   );
   const isBarefootClient = (s) => s === "@barefootjs/client" || s.startsWith("@barefootjs/client/");
   const spans = [];
   const visit3 = (node) => {
-    if (ts20.isImportDeclaration(node) || ts20.isExportDeclaration(node)) {
+    if (ts21.isImportDeclaration(node) || ts21.isExportDeclaration(node)) {
       const ms = node.moduleSpecifier;
-      if (ms && ts20.isStringLiteral(ms) && isBarefootClient(ms.text)) {
+      if (ms && ts21.isStringLiteral(ms) && isBarefootClient(ms.text)) {
         spans.push([ms.getStart(sourceFile), ms.getEnd()]);
       }
-    } else if (ts20.isCallExpression(node) && node.expression.kind === ts20.SyntaxKind.ImportKeyword) {
+    } else if (ts21.isCallExpression(node) && node.expression.kind === ts21.SyntaxKind.ImportKeyword) {
       const arg = node.arguments[0];
-      if (arg && ts20.isStringLiteral(arg) && isBarefootClient(arg.text)) {
+      if (arg && ts21.isStringLiteral(arg) && isBarefootClient(arg.text)) {
         spans.push([arg.getStart(sourceFile), arg.getEnd()]);
       }
     }
-    ts20.forEachChild(node, visit3);
+    ts21.forEachChild(node, visit3);
   };
   visit3(sourceFile);
   if (spans.length === 0) return content;
@@ -21384,8 +21679,8 @@ async function writeBuildId(outDir, result) {
   if (!result.changed) return;
   const devDir = resolve6(outDir, DEV_SENTINEL_SUBDIR);
   await mkdir(devDir, { recursive: true });
-  const path23 = resolve6(devDir, DEV_SENTINEL_FILENAME);
-  await writeIfChanged(path23, String(Date.now()));
+  const path24 = resolve6(devDir, DEV_SENTINEL_FILENAME);
+  await writeIfChanged(path24, String(Date.now()));
 }
 async function watch(config, options = {}) {
   const { debounceMs = 100, signal } = options;
@@ -21610,8 +21905,8 @@ var init_build2 = __esm({
 });
 
 // src/lib/dependency-resolver.ts
-import { existsSync as existsSync4, readFileSync } from "fs";
-import path6 from "path";
+import { existsSync as existsSync4, readFileSync } from "node:fs";
+import path6 from "node:path";
 function resolveDependenciesFromSource(requested, srcComponentsDir) {
   const visited = /* @__PURE__ */ new Set();
   const queue = [...requested];
@@ -21916,8 +22211,8 @@ var init_mdx = __esm({
 });
 
 // src/lib/docs-loader.ts
-import { readFileSync as readFileSync2, existsSync as existsSync5, readdirSync, statSync } from "fs";
-import path7 from "path";
+import { readFileSync as readFileSync2, existsSync as existsSync5, readdirSync, statSync } from "node:fs";
+import path7 from "node:path";
 function parseFrontmatter2(content) {
   if (content.startsWith("---\n") || content.startsWith("---\r\n")) {
     const endIdx = content.indexOf("\n---", 3);
@@ -22203,8 +22498,8 @@ __export(meta_extract_exports, {
   pickGeneratedAt: () => pickGeneratedAt,
   run: () => run2
 });
-import { readFileSync as readFileSync3, writeFileSync, mkdirSync, existsSync as existsSync6 } from "fs";
-import path8 from "path";
+import { readFileSync as readFileSync3, writeFileSync, mkdirSync, existsSync as existsSync6 } from "node:fs";
+import path8 from "node:path";
 function pickGeneratedAt(previousIndexJson, nextEntries, now = () => (/* @__PURE__ */ new Date()).toISOString()) {
   if (previousIndexJson === null) return now();
   try {
@@ -22484,8 +22779,8 @@ __export(add_exports, {
   run: () => run3,
   toRegistryName: () => toRegistryName
 });
-import { existsSync as existsSync7, mkdirSync as mkdirSync2, copyFileSync, writeFileSync as writeFileSync2, readFileSync as readFileSync4, readdirSync as readdirSync2 } from "fs";
-import path9 from "path";
+import { existsSync as existsSync7, mkdirSync as mkdirSync2, copyFileSync, writeFileSync as writeFileSync2, readFileSync as readFileSync4, readdirSync as readdirSync2 } from "node:fs";
+import path9 from "node:path";
 async function run3(args2, ctx2) {
   const force = args2.includes("--force");
   let registryUrl;
@@ -23251,11 +23546,11 @@ func StreamingFuncMap() template.FuncMap {
 }
 `;
     bfdevGoSource = '// Package bfdev provides a dev-only browser auto-reload handler.\n//\n// It watches `<distDir>/.dev/build-id` (produced by `bf build --watch`\n// in the @barefootjs/cli package) and streams SSE `event: reload` whenever\n// the sentinel changes. Combined with the inline client snippet returned by\n// Snippet, editing a .tsx component triggers a browser reload automatically.\n//\n// The handler is framework-agnostic (net/http.Handler). Echo users can mount\n// it via echo.WrapHandler; other routers use it as-is.\n//\n// Example (Echo):\n//\n//	if bfdev.IsDevDefault() {\n//	    e.GET("/_bf/reload", echo.WrapHandler(bfdev.NewReloadHandler(bfdev.Config{\n//	        DistDir: "./dist",\n//	    })))\n//	}\n//\n// Example (net/http):\n//\n//	http.Handle("/_bf/reload", bfdev.NewReloadHandler(bfdev.Config{DistDir: "./dist"}))\npackage bfdev\n\nimport (\n	"fmt"\n	"html/template"\n	"net/http"\n	"os"\n	"path/filepath"\n	"strings"\n	"time"\n)\n\n// Sentinel path contract with `@barefootjs/cli`\n// (`packages/cli/src/lib/build.ts`, DEV_SENTINEL_SUBDIR / DEV_SENTINEL_FILENAME).\n// Duplicated here so the Go runtime avoids a dependency on the CLI. If the\n// CLI changes these values, update this package in the same PR.\nconst (\n	devSubdir        = ".dev"\n	buildIDFile      = "build-id"\n	scrollStorageKey = "__bf_devreload_scroll"\n\n	// heartbeatInterval keeps the SSE stream under the framework\'s idle\n	// timeout (Bun.serve defaults to 10s; Go/Echo defaults are more forgiving\n	// but middleware-level timeouts exist in the wild). 5s leaves comfortable\n	// headroom.\n	heartbeatInterval = 5 * time.Second\n\n	// pollInterval is how often the handler checks `.dev/build-id`. Uses\n	// polling instead of fsnotify to keep the runtime dependency-free \u2014 dev\n	// latency of ~500ms is imperceptible next to the browser\'s reload time.\n	pollInterval = 500 * time.Millisecond\n)\n\n// Config configures a dev reload handler or snippet.\ntype Config struct {\n	// DistDir is the directory that `bf build` writes output into\n	// (contains `.dev/build-id`). Required for the handler; ignored by\n	// Snippet.\n	DistDir string\n\n	// Endpoint is the public SSE URL the client will connect to. Used only by\n	// Snippet to populate the EventSource URL. Defaults to "/_bf/reload" when\n	// empty.\n	Endpoint string\n\n	// Disabled, when true, makes NewReloadHandler return a 404 handler and\n	// Snippet return an empty fragment. Intended for production builds.\n	Disabled bool\n}\n\n// IsDevDefault reports whether the process is running in a development\n// environment using the common Go convention of APP_ENV=development.\n// Callers can use this to populate Config.Disabled:\n//\n//	cfg := bfdev.Config{DistDir: "./dist", Disabled: !bfdev.IsDevDefault()}\nfunc IsDevDefault() bool {\n	return os.Getenv("APP_ENV") == "development"\n}\n\n// NewReloadHandler returns an http.Handler that streams Server-Sent Events\n// and emits `event: reload` whenever `<DistDir>/.dev/build-id` changes. When\n// cfg.Disabled is true, the handler responds 404 and never opens a stream.\nfunc NewReloadHandler(cfg Config) http.Handler {\n	if cfg.Disabled {\n		return http.HandlerFunc(http.NotFound)\n	}\n	devDir := filepath.Join(cfg.DistDir, devSubdir)\n	buildIDPath := filepath.Join(devDir, buildIDFile)\n	// Ensure the directory exists so the first read does not race with the\n	// initial build. Ignore the error: subsequent reads simply return "".\n	_ = os.MkdirAll(devDir, 0o755)\n\n	return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {\n		flusher, ok := w.(http.Flusher)\n		if !ok {\n			http.Error(w, "streaming unsupported", http.StatusInternalServerError)\n			return\n		}\n		h := w.Header()\n		h.Set("Content-Type", "text/event-stream")\n		h.Set("Cache-Control", "no-cache, no-transform")\n		h.Set("Connection", "keep-alive")\n		h.Set("X-Accel-Buffering", "no")\n\n		send := func(chunk string) bool {\n			if _, err := fmt.Fprint(w, chunk); err != nil {\n				return false\n			}\n			flusher.Flush()\n			return true\n		}\n\n		if !send("retry: 1000\\n\\n") {\n			return\n		}\n\n		lastEventID := strings.TrimSpace(r.Header.Get("Last-Event-ID"))\n		initialID := readBuildID(buildIDPath)\n		lastSent := ""\n		if initialID != "" {\n			lastSent = initialID\n			// When the client reconnects with a stale Last-Event-ID, a build\n			// happened during its disconnected window \u2014 fire `reload`\n			// immediately so the missed rebuild does not silently stay\n			// unpainted until the next change.\n			event := "hello"\n			if lastEventID != "" && lastEventID != initialID {\n				event = "reload"\n			}\n			if !send(fmt.Sprintf("event: %s\\nid: %s\\ndata: %s\\n\\n", event, initialID, initialID)) {\n				return\n			}\n		}\n\n		ctx := r.Context()\n		hbTicker := time.NewTicker(heartbeatInterval)\n		defer hbTicker.Stop()\n		pollTicker := time.NewTicker(pollInterval)\n		defer pollTicker.Stop()\n\n		for {\n			select {\n			case <-ctx.Done():\n				return\n			case <-hbTicker.C:\n				if !send(": hb\\n\\n") {\n					return\n				}\n			case <-pollTicker.C:\n				id := readBuildID(buildIDPath)\n				if id == "" || id == lastSent {\n					continue\n				}\n				lastSent = id\n				if !send(fmt.Sprintf("event: reload\\nid: %s\\ndata: %s\\n\\n", id, id)) {\n					return\n				}\n			}\n		}\n	})\n}\n\nfunc readBuildID(path string) string {\n	b, err := os.ReadFile(path)\n	if err != nil {\n		return ""\n	}\n	return strings.TrimSpace(string(b))\n}\n\n// Snippet returns an inline <script> that subscribes to the SSE endpoint,\n// reloads on `reload`, and preserves window.scrollY across reloads via\n// sessionStorage. Returns an empty fragment when cfg.Disabled is true.\n//\n// Place it before </body>, typically just after the rendered scripts.\nfunc Snippet(cfg Config) template.HTML {\n	if cfg.Disabled {\n		return ""\n	}\n	endpoint := cfg.Endpoint\n	if endpoint == "" {\n		endpoint = "/_bf/reload"\n	}\n	// Small IIFE: EventSource subscriber + scrollY preservation. Idempotent\n	// across duplicate mounts (guarded by window.__bfDevReload).\n	js := fmt.Sprintf(\n		`(function(){if(window.__bfDevReload)return;window.__bfDevReload=1;`+\n			`try{var s=sessionStorage.getItem(%q);if(s){sessionStorage.removeItem(%q);`+\n			`var y=parseInt(s,10);if(!isNaN(y)){var restore=function(){window.scrollTo(0,y)};`+\n			`if(document.readyState===\'loading\'){addEventListener(\'DOMContentLoaded\',restore,{once:true})}else{restore()}}}}catch(e){}`+\n			`var es=new EventSource(%q);`+\n			`es.addEventListener(\'reload\',function(){try{sessionStorage.setItem(%q,String(window.scrollY))}catch(e){}location.reload()});`+\n			`es.addEventListener(\'error\',function(){})})();`,\n		scrollStorageKey, scrollStorageKey, endpoint, scrollStorageKey,\n	)\n	// Safe: `js` is assembled from package-internal literals plus `endpoint`\n	// escaped by %q (Go-syntax quoting == valid JS string literal for the\n	// ASCII endpoint paths this accepts).\n	return template.HTML("<script>" + js + "</script>") //nolint:gosec\n}\n';
-    barefootPmSource = "package BarefootJS;\nour $VERSION = \"0.01\";\nuse strict;\nuse warnings;\nuse utf8;\nuse feature 'signatures';\nno warnings 'experimental::signatures';\n\nuse POSIX ();\nuse Scalar::Util qw(looks_like_number weaken);\n\n# NOTE: This runtime is template-engine-agnostic AND framework-agnostic by\n# design, so it can ship as a standalone CPAN distribution. It depends only on\n# core Perl (subroutine signatures + the hand-rolled minimal accessor base\n# below \u2014 no Mojo::Base, no Class::Tiny). Every operation that depends on *how*\n# a template is rendered \u2014 JSON marshalling, raw-string marking, JSX-children\n# materialisation, and named-template rendering \u2014 is delegated to a pluggable\n# `backend` (see BarefootJS::Backend::Mojo for the reference Mojolicious\n# implementation), which is the only component that pulls in the Mojo\n# distribution, and only when it is actually used.\n\n# ---------------------------------------------------------------------------\n# Minimal accessor base (no Mojo::Base / Class::Tiny dependency)\n# ---------------------------------------------------------------------------\n#\n# Generates read/write accessors with optional lazy defaults so the runtime\n# stays free of any non-core OO base. Semantics mirror the Mojo::Base `has`\n# this class used to inherit: a getter returns the stored value (building it\n# from the default on first access if unset); a setter stores the value and\n# returns $self for chaining. A default is either a plain scalar or a coderef\n# invoked as `$default->($self)` (for per-instance refs like `[]` / `{}` and\n# the lazily-required Mojo backend).\nmy %ATTR_DEFAULT = (\n    _scripts         => sub { [] },\n    _script_seen     => sub { {} },\n    _child_renderers => sub { {} },\n    _is_child        => 0,\n    # Lazily fall back to the Mojo reference backend so a bare-blessed\n    # instance (the pure-function unit tests) and the historical\n    # `BarefootJS->new($c, ...)` callers keep working unchanged. A non-Mojo\n    # host injects its own backend via `BarefootJS->new($c, { backend => $b })`\n    # and never triggers this require \u2014 keeping the core load Mojo-free.\n    backend          => sub {\n        require BarefootJS::Backend::Mojo;\n        return BarefootJS::Backend::Mojo->new;\n    },\n);\n\n# c            \u2014 Mojolicious controller (kept for back-compat accessors)\n# config       \u2014 plugin / instance config\n# backend      \u2014 the template-engine seam (#engine-abstraction)\n# _scope_id    \u2014 addressable scope id\n# _bf_parent / _bf_mount \u2014 slot identity when this scope is slot-attached\n# _props       \u2014 props serialised into bf-p / the scope comment\nfor my $attr (qw(\n    c config backend\n    _scripts _script_seen _scope_id _is_child _bf_parent _bf_mount _props\n    _child_renderers\n)) {\n    no strict 'refs';\n    *{\"BarefootJS::$attr\"} = sub {\n        my $self = shift;\n        if (@_) { $self->{$attr} = shift; return $self; }\n        if (!exists $self->{$attr} && exists $ATTR_DEFAULT{$attr}) {\n            my $d = $ATTR_DEFAULT{$attr};\n            $self->{$attr} = ref($d) eq 'CODE' ? $d->($self) : $d;\n        }\n        return $self->{$attr};\n    };\n}\n\nsub new ($class, $c, $config = {}) {\n    # Build (or accept an injected) rendering backend. The default Mojo\n    # backend wraps the controller and honours an optional `json_encoder`\n    # override so a host can swap in a faster XS JSON implementation\n    # without subclassing. A caller targeting another template engine\n    # passes its own backend via `$config->{backend}`.\n    my $backend = $config->{backend};\n    unless ($backend) {\n        require BarefootJS::Backend::Mojo;\n        $backend = BarefootJS::Backend::Mojo->new(\n            c => $c,\n            ($config->{json_encoder}\n                ? (json_encoder => $config->{json_encoder})\n                : ()),\n        );\n    }\n    my $self = bless {\n        c       => $c,\n        config  => $config,\n        backend => $backend,\n    }, $class;\n    # Hold the controller weakly. Mojolicious stashes this bf instance under\n    # `$c->stash->{'bf.instance'}`, so a strong bf -> controller back-reference\n    # closes a per-request cycle ($c -> stash -> bf -> $c) that Perl's\n    # refcount GC cannot reclaim, leaking one controller + bf + child-renderer\n    # closures per request. The controller owns (outlives) the per-request bf,\n    # so the weak ref stays valid for the whole render. Callers that need the\n    # controller to outlive the bf instance independently must keep their own\n    # strong reference (the normal Mojo request scope already does).\n    weaken($self->{c}) if defined $c;\n    return $self;\n}\n\n# ---------------------------------------------------------------------------\n# Scope & Props\n# ---------------------------------------------------------------------------\n\nsub scope_attr ($self) {\n    # bf-s is the addressable scope id only (#1249).\n    return $self->_scope_id // '';\n}\n\n# Emits `bf-h=\"<host>\" bf-m=\"<slot>\" bf-r=\"\"` conditionally.\n# See spec/compiler.md \"Slot identity\".\nsub hydration_attrs ($self) {\n    my @parts;\n    my $host  = $self->_bf_parent;\n    my $mount = $self->_bf_mount;\n    if (defined $host && length $host) {\n        my $h = $host =~ s/\"/&quot;/gr;\n        push @parts, qq{bf-h=\"$h\"};\n    }\n    if (defined $mount && length $mount) {\n        my $m = $mount =~ s/\"/&quot;/gr;\n        push @parts, qq{bf-m=\"$m\"};\n    }\n    unless ($self->_is_child) {\n        push @parts, q{bf-r=\"\"};\n    }\n    return join(' ', @parts);\n}\n\nsub props_attr ($self) {\n    my $props = $self->_props;\n    return '' unless $props && %$props;\n    # encode_json returns a character string (not bytes) for safe embedding\n    # in templates (the Mojo backend uses Mojo::JSON::to_json).\n    my $json = $self->backend->encode_json($props);\n    return qq{ bf-p='$json'};\n}\n\n# ---------------------------------------------------------------------------\n# Comment Markers\n# ---------------------------------------------------------------------------\n\nsub comment ($self, $text) {\n    return \"<!--bf-$text-->\";\n}\n\n# ---------------------------------------------------------------------------\n# JS-equivalent value stringification\n# ---------------------------------------------------------------------------\n\n# Map a Perl boolean-shaped value to the JS `String(bool)` form.\n# Used by the Mojo adapter when emitting reactive attribute bindings\n# whose JS source `isBooleanResultExpr` classified as boolean \u2014\n# a comparison (`count() > 0`), a logical negation (`!ok()`), or a\n# literal `true` / `false`. Perl's auto-stringification of those\n# expressions yields `''` / `1`; Hono and Go emit `'false'` / `'true'`.\n# Centralising the bool \u2192 string mapping here keeps the contract\n# testable and the template-emit syntax tidy\n# (`<%= bf->bool_str(...) %>` vs an inline ternary).\n#\n# Contract is boolean-only: callers must have classified the\n# expression as boolean-result before routing through this helper.\n# Non-boolean values reaching here will be Perl-truthy-coerced to\n# 'true' / 'false', which is generally wrong \u2014 non-boolean attribute\n# bindings stay on the plain `<%= expr %>` emit path and never reach\n# this function.\nsub bool_str ($self, $value) {\n    return $value ? 'true' : 'false';\n}\n\nsub text_start ($self, $slot_id) {\n    return \"<!--bf:$slot_id-->\";\n}\n\nsub text_end ($self) {\n    return \"<!--/-->\";\n}\n\n# See spec/compiler.md \"Slot identity\" for the comment-scope wire format.\nsub scope_comment ($self) {\n    my $scope_id = $self->_scope_id // '';\n    my $host_segment = '';\n    my $host  = $self->_bf_parent;\n    my $mount = $self->_bf_mount;\n    if (defined $host && length $host) {\n        $host_segment = \"|h=$host|m=\" . ($mount // '');\n    }\n    my $props_json = '';\n    if ($self->_props && %{$self->_props}) {\n        $props_json = '|' . $self->backend->encode_json($self->_props);\n    }\n    return \"<!--bf-scope:$scope_id$host_segment$props_json-->\";\n}\n\n# ---------------------------------------------------------------------------\n# Script Registration\n# ---------------------------------------------------------------------------\n\nsub register_script ($self, $path) {\n    return if $self->_script_seen->{$path};\n    $self->_script_seen->{$path} = 1;\n    push @{$self->_scripts}, $path;\n}\n\n# ---------------------------------------------------------------------------\n# Child Component Rendering\n# ---------------------------------------------------------------------------\n# (`_child_renderers` accessor is generated by the minimal accessor base above.)\n\nsub register_child_renderer ($self, $name, $renderer) {\n    $self->_child_renderers->{$name} = $renderer;\n}\n\nsub render_child ($self, $name, @args) {\n    my $renderer = $self->_child_renderers->{$name};\n    die \"No renderer registered for child component '$name'\" unless $renderer;\n    # Accept both the Mojo list form \u2014 `bf->render_child($name, k => v, ...)`\n    # \u2014 and the single-hashref form \u2014 `$bf.render_child($name, { k => v })`.\n    # Template languages whose method calls can't splat a hash into positional\n    # args (Text::Xslate Kolon, Template Toolkit) pass one hashref instead.\n    my %props = (@args == 1 && ref $args[0] eq 'HASH') ? %{ $args[0] } : @args;\n    # JSX children come in via the engine's children-capture mechanism\n    # (Mojo's `begin %>...<% end`, which produces a CODE ref returning a\n    # Mojo::ByteStream). Materialize it through the backend before handing\n    # the props to the child renderer so the child template sees\n    # `$children` as already-rendered HTML. Guard on `exists` so a\n    # childless invocation (`bf->render_child('counter')`) doesn't gain a\n    # spurious `children => undef` key \u2014 preserving the historical \"only\n    # touch children when present\" behaviour.\n    $props{children} = $self->backend->materialize($props{children})\n        if exists $props{children};\n    return $renderer->(\\%props);\n}\n\n# ---------------------------------------------------------------------------\n# Bulk registration from build manifest\n# ---------------------------------------------------------------------------\n#\n# `bf build` emits dist/templates/manifest.json describing every\n# component the page might invoke (Counter, ui/button/index, ...).\n# This helper walks that manifest and registers one child renderer per\n# UI registry entry \u2014 the path shape `ui/<name>/index` maps to the\n# `<name>` slot key Counter.html.ep and friends use via\n# `<%= bf->render_child('<name>', ...) %>`.\n#\n# Each manifest entry carries an `ssrDefaults` hash derived statically\n# from the component's JSX (prop destructure defaults + signal /\n# memo initial values, see packages/jsx/src/ssr-defaults.ts). The\n# child renderer seeds every template variable from that hash,\n# preferring the caller's matching prop where one exists. This\n# replaces the per-component `signal_init` callback that every\n# scaffold's `app.pl` used to hand-roll for items 1/3 of issue #1416.\n#\n# `signal_init` remains as an opt-in override for cases the static\n# extractor can't see through (e.g. signal initial values that\n# reference imported helpers). When supplied for a given slot key\n# it takes precedence over the manifest's `ssrDefaults` for that\n# child, allowing callers to mix manual overrides with auto-derived\n# defaults for siblings.\nsub register_components_from_manifest ($self, $manifest, %opts) {\n    my $signal_inits = $opts{signal_init} // {};\n    my $parent_scope = $self->_scope_id;\n    # Weaken the parent capture so the child-renderer closures stored on\n    # `$self->_child_renderers` don't keep `$self` alive (the direct\n    # closure <-> parent cycle). The controller is reached through `$parent`\n    # at call time rather than captured strongly here, so the closures hold\n    # no strong reference to `$c` either \u2014 see the controller-cycle note in\n    # `new`. `$parent` is always live whenever a closure runs (the closure is\n    # stored on `$parent`, so `$parent` outlives every invocation).\n    weaken(my $parent = $self);\n\n    for my $entry_name (keys %$manifest) {\n        # `__barefoot__` is the runtime entry, not a component.\n        next if $entry_name eq '__barefoot__';\n        # Only UI registry components (path shape `ui/<name>/index`)\n        # become child renderers; top-level page components are the\n        # render target rather than a child.\n        next unless $entry_name =~ m{^ui/([^/]+)/index$};\n        my $slot_key = $1;\n        my $marked = $manifest->{$entry_name}{markedTemplate} // '';\n        next unless $marked;\n        # `templates/ui/button/index.html.ep` \u2192 `ui/button/index`\n        my $template_name = $marked;\n        $template_name =~ s{^templates/}{};\n        $template_name =~ s{\\.html\\.ep$}{};\n\n        my $signal_init = $signal_inits->{$slot_key};\n        my $manifest_defaults = $manifest->{$entry_name}{ssrDefaults};\n        $self->register_child_renderer($slot_key, sub {\n            my ($props) = @_;\n            # Child shares the parent's backend so nested renders go\n            # through the same engine + controller (and inherit any\n            # injected json_encoder). The controller is fetched via the weak\n            # `$parent` at call time \u2014 never captured strongly \u2014 so the\n            # closure adds no edge to the per-request reference cycle.\n            my $child_bf = BarefootJS->new($parent->c, { backend => $parent->backend });\n            my $slot_id = delete $props->{_bf_slot};\n            $child_bf->_scope_id(\n                $slot_id ? $parent_scope . '_' . $slot_id\n                         : $template_name . '_' . substr(rand() =~ s/^0\\.//r, 0, 6)\n            );\n            $child_bf->_is_child(1);\n            # (#1249) Slot identity: host scope + slot id. Emitted as\n            # bf-h / bf-m attributes by hydration_attrs.\n            if ($slot_id) {\n                $child_bf->_bf_parent($parent_scope);\n                $child_bf->_bf_mount($slot_id);\n            }\n            $child_bf->_scripts($parent->_scripts);\n            $child_bf->_script_seen($parent->_script_seen);\n\n            my %extra;\n            if ($signal_init) {\n                %extra = $signal_init->($props);\n            } elsif ($manifest_defaults) {\n                %extra = _derive_stash_from_defaults($manifest_defaults, $props);\n            }\n\n            # Render the child template with $child_bf bound as the active\n            # instance for the nested render. The backend owns the\n            # engine-specific binding + restore (stash juggle for Mojo).\n            my $html = $parent->backend->render_named(\n                $template_name, $child_bf, { %$props, %extra },\n            );\n            chomp $html;\n            return $html;\n        });\n    }\n}\n\n# Derive template-stash kvs from a manifest entry's `ssrDefaults`\n# section. Each entry shape:\n#   { value => <static-fallback>, propName => <prop>, isRestProps => bool }\n# For `isRestProps`, the rest bag passes through unchanged (or the\n# static `{}` if the caller didn't supply one). For ordinary entries\n# the caller's `$props->{propName}` wins when defined, otherwise the\n# static `value` does. `propName`-less entries (signal / memo locals)\n# always use the static value \u2014 the caller cannot override them.\nsub _derive_stash_from_defaults ($defaults, $props) {\n    my %extra;\n    for my $name (keys %$defaults) {\n        my $d = $defaults->{$name};\n        if (ref($d) ne 'HASH') {\n            $extra{$name} = $d;\n            next;\n        }\n        if ($d->{isRestProps}) {\n            $extra{$name} = exists $props->{$name} ? $props->{$name} : $d->{value};\n            next;\n        }\n        my $prop_name = $d->{propName};\n        if (defined $prop_name && exists $props->{$prop_name} && defined $props->{$prop_name}) {\n            $extra{$name} = $props->{$prop_name};\n        } else {\n            $extra{$name} = $d->{value};\n        }\n    }\n    return %extra;\n}\n\n# ---------------------------------------------------------------------------\n# Script Output\n# ---------------------------------------------------------------------------\n\nsub scripts ($self) {\n    my @tags;\n    for my $path (@{$self->_scripts}) {\n        push @tags, qq{<script type=\"module\" src=\"$path\"></script>};\n    }\n    return join(\"\\n\", @tags);\n}\n\n# ---------------------------------------------------------------------------\n# Streaming SSR (Out-of-Order)\n# ---------------------------------------------------------------------------\n\nsub streaming_bootstrap ($self) {\n    return q{<script>(function(){function s(id){var a=document.querySelector('[bf-async=\"'+id+'\"]');var t=document.querySelector('template[bf-async-resolve=\"'+id+'\"]');if(!a||!t)return;a.replaceChildren(t.content.cloneNode(true));a.removeAttribute('bf-async');t.remove();requestAnimationFrame(function(){if(window.__bf_hydrate)window.__bf_hydrate()})};window.__bf_swap=s})()</script>};\n}\n\nsub async_boundary ($self, $id, $fallback_html) {\n    # The fallback comes in via Mojo `begin %>...<% end` capture (see\n    # MojoAdapter::renderAsync), which produces a CODE ref returning a\n    # Mojo::ByteStream. Materialize it through the backend so the rendered\n    # HTML embeds in the placeholder rather than the CODE ref's\n    # stringification.\n    $fallback_html = $self->backend->materialize($fallback_html);\n    return qq{<div bf-async=\"$id\">$fallback_html</div>};\n}\n\nsub async_resolve ($self, $id, $content_html) {\n    return qq{<template bf-async-resolve=\"$id\">$content_html</template><script>__bf_swap(\"$id\")</script>};\n}\n\n# ---------------------------------------------------------------------------\n# JS-compat callees (#1189) \u2014 invoked from generated Mojo templates as\n# <%= bf->json($val) %>, <%= bf->floor($val) %>, etc. The MojoAdapter's\n# `templatePrimitives` registry emits these helper calls in place of the\n# corresponding JS callees (`JSON.stringify`, `Math.floor`, \u2026) so the SSR\n# template can render value-equivalent output without a JS engine.\n#\n# Failure policy mirrors the Go adapter (#1188): user-data marshalling\n# (json) bubbles errors so Mojolicious aborts loudly on cycles /\n# unsupported values rather than silently producing an empty payload.\n# Numeric coercion follows JS semantics (NaN propagates as the special\n# string 'NaN'; non-numeric input returns 'NaN' rather than 0). Strings\n# always coerce to a string representation.\n# ---------------------------------------------------------------------------\n\nsub json ($self, $value) {\n    # Mojo::JSON::to_json returns a character string (not bytes), suitable\n    # for embedding in HTML output via Mojo::ByteStream / `<%==`.\n    #\n    # Documented divergence from JS: JS distinguishes `null` (renders as\n    # \"null\") from `undefined` (`JSON.stringify(undefined)` returns the\n    # JS value `undefined`, not a string). Perl has no such distinction\n    # \u2014 both map to `undef`. We choose the `null` rendering for SSR\n    # ergonomics: an unset prop becomes the string \"null\" rather than\n    # the literal text \"undefined\" or an empty attribute. Matches the\n    # `null` case of JS exactly; diverges from the `undefined` case.\n    return $self->backend->encode_json($value);\n}\n\nsub string ($self, $value) {\n    # JS `String(v)` mirror. `undef` renders as the empty string here so\n    # an unset prop doesn't surface as a literal \"undefined\" / \"null\"\n    # in user-facing HTML \u2014 same divergence the Go adapter documents\n    # for `bf_string`.\n    return defined $value ? \"$value\" : '';\n}\n\nsub number ($self, $value) {\n    # JS `Number(v)` mirror. Numeric coerces via Perl's implicit\n    # numeric context; non-numeric / undef yield real numeric NaN\n    # (`'nan' + 0`) so downstream arithmetic propagates correctly\n    # (`Math.floor(NaN) === NaN`). Returning the literal string\n    # \"NaN\" would conflate the user-passing-the-string-\"NaN\" case\n    # with the parse-failure case, and break NaN detection in\n    # downstream helpers.\n    return 0 + 'nan' unless defined $value;\n    return $value + 0 if looks_like_number($value);\n    return 0 + 'nan';\n}\n\n# NaN is the only float for which `$x != $x` holds. Used as the\n# portable sentinel check in floor/ceil/round.\nsub _is_nan { my $n = shift; return $n != $n }\n\nsub floor ($self, $value) {\n    my $n = $self->number($value);\n    return $n if _is_nan($n);\n    return POSIX::floor($n);\n}\n\nsub ceil ($self, $value) {\n    my $n = $self->number($value);\n    return $n if _is_nan($n);\n    return POSIX::ceil($n);\n}\n\nsub round ($self, $value) {\n    my $n = $self->number($value);\n    return $n if _is_nan($n);\n    # POSIX has no `round`. JS `Math.round` rounds half toward\n    # +Infinity (so `Math.round(-1.5) === -1`, not -2). `floor(n\n    # + 0.5)` reproduces that for both signs.\n    return POSIX::floor($n + 0.5);\n}\n\n# ---------------------------------------------------------------------------\n# Array / String method helpers (#1448 Tier A)\n# ---------------------------------------------------------------------------\n#\n# `Array.prototype.includes(x)` and `String.prototype.includes(sub)`\n# share a method name in JS; the JSX parser can't tell the two\n# receiver shapes apart without TS type inference, so both lower to\n# the same IR node (`array-method` / method `includes`). This helper\n# dispatches at the Perl level via `ref()`:\n#   - ARRAY ref:  scan elements with `eq`; one defined-vs-undef\n#                 hop matches JS's `===` for null/undefined.\n#   - scalar:     `index($recv, $sub) != -1`, with both args\n#                 coerced through `// ''` so an undef receiver /\n#                 needle doesn't trip Perl's substr warning.\n# Anything else (HASH ref, code ref) returns false \u2014 matches the\n# JS semantic where `.includes` is only defined on Array /\n# TypedArray / String.\n\nsub includes ($self, $recv, $elem) {\n    if (ref($recv) eq 'ARRAY') {\n        for my $item (@$recv) {\n            if (!defined $item) {\n                return 1 if !defined $elem;\n                next;\n            }\n            return 1 if defined $elem && $item eq $elem;\n        }\n        return 0;\n    }\n    return 0 if ref($recv);\n    return index($recv // '', $elem // '') != -1 ? 1 : 0;\n}\n\n# `Array.prototype.indexOf(x)` / `Array.prototype.lastIndexOf(x)`\n# value-equality search (#1448 Tier A). Returns the 0-based position\n# of the first / last matching element, or -1 if not found.\n# Non-array receivers return -1 \u2014 matches the JS semantic that\n# `.indexOf` / `.lastIndexOf` are only defined on Array / TypedArray.\n# (The string-position `indexOf` form isn't in Tier A; if it lands\n# later the helper can grow a ref()-dispatch branch like `includes`.)\n\nsub _array_index_of ($recv, $elem, $reverse) {\n    return -1 unless ref($recv) eq 'ARRAY';\n    my @indices = $reverse ? (reverse 0 .. $#{$recv}) : (0 .. $#{$recv});\n    for my $i (@indices) {\n        my $item = $recv->[$i];\n        if (!defined $item) {\n            return $i if !defined $elem;\n            next;\n        }\n        return $i if defined $elem && $item eq $elem;\n    }\n    return -1;\n}\n\nsub index_of ($self, $recv, $elem) {\n    return _array_index_of($recv, $elem, 0);\n}\n\nsub last_index_of ($self, $recv, $elem) {\n    return _array_index_of($recv, $elem, 1);\n}\n\n# `Array.prototype.at(i)` \u2014 supports negative indices (`.at(-1)` is\n# the last element); out-of-bounds returns undef (which Mojo's\n# auto-escape renders as the empty string, matching JS's `undefined`).\n# Non-array receivers return undef. Matches the Go `bf_at` arithmetic\n# (`length + i` for i < 0) so adapter output stays symmetric.\n\nsub at ($self, $recv, $i) {\n    return undef unless ref($recv) eq 'ARRAY';\n    return undef if !defined $i;\n    my $len = scalar @$recv;\n    return undef if $len == 0;\n    my $idx = $i < 0 ? $len + $i : $i;\n    return undef if $idx < 0 || $idx >= $len;\n    return $recv->[$idx];\n}\n\n# `Array.prototype.concat(other)` \u2014 merges two arrays in order\n# into a new ARRAY ref. Non-array operands collapse to empty\n# (matches the Go `bf_concat` semantic so cross-adapter output\n# stays symmetric; differs from JS where a non-Array argument\n# with `Symbol.isConcatSpreadable` would be spread, a behaviour\n# the template-language path never observes).\n\nsub concat ($self, $a, $b) {\n    my @out;\n    push @out, @$a if ref($a) eq 'ARRAY';\n    push @out, @$b if ref($b) eq 'ARRAY';\n    return \\@out;\n}\n\n# `Array.prototype.slice(start, end?)` \u2014 carves out a sub-range\n# into a new ARRAY ref. Mirrors the Go `bf_slice` arithmetic so\n# adapter output stays symmetric:\n#   - start < 0          \u2192 length + start  (e.g. -1 = last index)\n#   - end < 0            \u2192 length + end\n#   - start < 0 after clamp \u2192 0\n#   - end > length       \u2192 length\n#   - start >= end       \u2192 empty\n#   - end undef          \u2192 \"to length\"\n# Non-array receivers return an empty ARRAY ref.\n\nsub slice ($self, $recv, $start, $end) {\n    return [] unless ref($recv) eq 'ARRAY';\n    my $len = scalar @$recv;\n    return [] if $len == 0;\n\n    my $s = $start // 0;\n    $s = $len + $s if $s < 0;\n    $s = 0    if $s < 0;\n    $s = $len if $s > $len;\n\n    my $e = defined $end ? $end : $len;\n    $e = $len + $e if $e < 0;\n    $e = 0    if $e < 0;\n    $e = $len if $e > $len;\n\n    return [] if $s >= $e;\n    return [ @{$recv}[$s .. $e - 1] ];\n}\n\n# `Array.prototype.reverse()` / `Array.prototype.toReversed()` \u2014\n# both shapes share this lowering. SSR templates render a snapshot\n# of state, so JS's mutate-receiver (`reverse`) vs\n# return-new-array (`toReversed`) distinction has no template-\n# level meaning. Always returns a new ARRAY ref to keep callers\n# safe from accidental aliasing. Non-array receivers return an\n# empty ARRAY ref.\n\nsub reverse ($self, $recv) {\n    return [] unless ref($recv) eq 'ARRAY';\n    return [ reverse @$recv ];\n}\n\n# `Array.prototype.flat(depth?)` (#1448 Tier C) \u2014 flatten nested ARRAY\n# refs `$depth` levels deep. A `$depth` of -1 is the `Infinity` sentinel\n# (flatten fully); 0 returns a shallow copy. Non-ARRAY elements are kept\n# as-is (JS only flattens nested arrays). Non-ARRAY receiver \u2192 [].\nsub flat ($self, $recv, $depth = 1) {\n    return [] unless ref($recv) eq 'ARRAY';\n    my @out;\n    for my $el (@$recv) {\n        if ($depth != 0 && ref($el) eq 'ARRAY') {\n            my $next = $depth > 0 ? $depth - 1 : $depth;\n            push @out, @{ $self->flat($el, $next) };\n        }\n        else {\n            push @out, $el;\n        }\n    }\n    return \\@out;\n}\n\n# `Array.prototype.flatMap(fn)` value-returning field projection\n# (#1448 Tier C) \u2014 map each element through a self / field projection,\n# then flatten one level. `field` reads a HASH-ref key (the raw JS prop\n# name, as `bf->reduce` does); a projected non-ARRAY value is kept as-is\n# (flatMap = map + flat(1)). Non-ARRAY receiver \u2192 [].\nsub flat_map ($self, $recv, $key_kind, $key) {\n    return [] unless ref($recv) eq 'ARRAY';\n    my @projected;\n    for my $el (@$recv) {\n        if ($key_kind eq 'field') {\n            # JS `i => i.field` on a non-object yields `undefined`, not the\n            # element itself \u2014 push `undef` so a scalar element doesn't leak\n            # into the output (matches Go's `getFieldValue` returning nil).\n            push @projected, ref($el) eq 'HASH' ? $el->{$key} : undef;\n        }\n        else {\n            push @projected, $el;\n        }\n    }\n    return $self->flat(\\@projected, 1);\n}\n\n# `Array.prototype.flatMap(i => [i.a, i.b])` \u2014 array-literal tuple\n# projection (#1448 Tier C). Each `@specs` entry is a [kind, key] arrayref\n# (['self', ''] or ['field', 'a']). For each element, every leaf's value\n# is appended in order. flat(1) removes only the literal wrapper, so an\n# array-valued leaf is appended verbatim (no spread) \u2014 i.e. just append\n# each leaf. A non-HASH element under a `field` leaf yields undef (JS\n# `i.field` on a non-object). Non-ARRAY receiver \u2192 [].\nsub flat_map_tuple ($self, $recv, @specs) {\n    return [] unless ref($recv) eq 'ARRAY';\n    my @out;\n    for my $el (@$recv) {\n        for my $spec (@specs) {\n            my ($kind, $key) = @$spec;\n            if ($kind eq 'field') {\n                push @out, ref($el) eq 'HASH' ? $el->{$key} : undef;\n            }\n            else {\n                push @out, $el;\n            }\n        }\n    }\n    return \\@out;\n}\n\n# `String.prototype.trim()` \u2014 strip leading + trailing whitespace.\n# JS's `String.prototype.trim` matches `\\s` in the Unicode sense\n# (any whitespace including non-breaking space U+00A0); Perl's `\\s`\n# inside a regex with `/u` flag is the same. Undef receivers return\n# the empty string (matches JS's `String(undefined).trim()` which\n# would be \"undefined\" \u2192 \"undefined\", but in our template context\n# undef commonly means \"missing prop\"; rendering the empty string\n# is the safer choice and mirrors the JS-compat divergence we\n# already document for `bf->string(undef) === \"\"`).\n\nsub trim ($self, $recv) {\n    return '' unless defined $recv;\n    return '' if ref($recv);\n    my $s = \"$recv\";\n    $s =~ s/^\\s+|\\s+$//gu;\n    return $s;\n}\n\n# `String.prototype.split(sep)` (#1448 Tier B) \u2014 string \u2192 ARRAY ref.\n#\n# Two JS-parity wrinkles drive the helper (a bare `split` emit would\n# diverge from both JS and Go):\n#\n#   * Perl's `split` treats its first argument as a *regex*, so a\n#     separator like '.' or '|' would match far too much. We\n#     `quotemeta` it to force literal-string matching, mirroring JS's\n#     string-separator semantics (the regex-separator form stays\n#     refused upstream \u2014 see the parser arm).\n#   * Perl's `split` drops trailing empty fields by default; JS keeps\n#     them (`\"a,\".split(\",\")` is `[\"a\", \"\"]`). Passing the `-1` limit\n#     preserves them, matching JS and Go's `strings.Split`.\n#\n# An empty separator splits into individual characters (JS + Go agree).\n# Undef receiver renders as the single-element `['']` \u2014 the same\n# \"missing prop \u2192 empty string\" convention `bf->trim` uses.\n\nsub split ($self, $recv, $sep = undef, $limit = undef) {\n    my $s = defined $recv && !ref($recv) ? \"$recv\" : '';\n\n    my @parts;\n    if (!defined $sep) {\n        # No separator \u2192 the whole string in a single-element array\n        # (matches JS `\"x\".split()` / `.split(undefined)`).\n        @parts = ($s);\n    }\n    elsif (\"$sep\" eq '') {\n        # Empty separator \u2192 individual characters. No `-1` limit here:\n        # on an empty pattern Perl's `split` with `-1` appends a spurious\n        # trailing empty field (\"abc\" \u2192 'a','b','c',''), which JS/Go don't.\n        @parts = split //, $s;\n    }\n    elsif ($s eq '') {\n        # Empty input with a non-empty separator: JS `\"\".split(\",\")` is\n        # `[\"\"]` and Go's `strings.Split(\"\", \",\")` is `[\"\"]`, but Perl's\n        # `split /,/, ''` returns the empty list \u2014 special-case for parity.\n        @parts = ('');\n    }\n    else {\n        # `quotemeta` forces literal-string matching (JS string-separator\n        # semantics); the `-1` keeps trailing empty fields (JS keeps them,\n        # Perl's bare `split` drops them).\n        my $q = quotemeta(\"$sep\");\n        @parts = split /$q/, $s, -1;\n    }\n\n    # Optional `limit` caps the number of pieces (JS `split(sep, limit)`).\n    # 0 \u2192 empty; a negative limit keeps all (JS ToUint32 wrap makes it\n    # effectively unbounded) \u2014 both match Go's `bf_split`.\n    if (defined $limit) {\n        my $n = int($limit);\n        if ($n == 0) { @parts = () }\n        elsif ($n > 0 && $n < scalar @parts) { @parts = @parts[0 .. $n - 1] }\n    }\n\n    return [@parts];\n}\n\n# `String.prototype.startsWith(prefix, position?)` (#1448 Tier B) \u2014\n# string \u2192 boolean (1 / 0). `substr`-anchored literal comparison mirrors\n# Go's `strings.HasPrefix`. An empty prefix is always true (JS parity);\n# undef / non-string receivers coerce to the empty string first. The\n# optional `position` re-anchors the test (clamped to `[0, length]`),\n# matching JS `\"abc\".startsWith(\"b\", 1)`.\n\nsub starts_with ($self, $recv, $prefix, $position = undef) {\n    my $s = defined $recv && !ref($recv) ? \"$recv\" : '';\n    my $p = defined $prefix ? \"$prefix\" : '';\n    if (defined $position) {\n        my $n = int($position);\n        $n = 0 if $n < 0;\n        $n = length($s) if $n > length($s);\n        $s = substr($s, $n);\n    }\n    return substr($s, 0, length $p) eq $p ? 1 : 0;\n}\n\n# `String.prototype.endsWith(suffix, endPosition?)` (#1448 Tier B) \u2014\n# string \u2192 boolean (1 / 0). Mirrors Go's `strings.HasSuffix`. An empty\n# suffix is always true (JS parity); a suffix longer than the string is\n# false. `substr($s, -length $x)` would mis-read the whole string when\n# `length $x == 0`, so that case short-circuits. The optional\n# `endPosition` treats the string as if it were only that many chars\n# long (clamped to `[0, length]`), matching JS `\"abc\".endsWith(\"b\", 2)`.\n\nsub ends_with ($self, $recv, $suffix, $end_position = undef) {\n    my $s = defined $recv && !ref($recv) ? \"$recv\" : '';\n    my $x = defined $suffix ? \"$suffix\" : '';\n    if (defined $end_position) {\n        my $e = int($end_position);\n        $e = 0 if $e < 0;\n        $e = length($s) if $e > length($s);\n        $s = substr($s, 0, $e);\n    }\n    return 1 if $x eq '';\n    return 0 if length($s) < length($x);\n    return substr($s, -length $x) eq $x ? 1 : 0;\n}\n\n# `String.prototype.replace(pattern, replacement)` \u2014 string-pattern\n# form only (#1448 Tier B), replacing the FIRST occurrence (JS string-\n# pattern semantics). Spliced via index/substr rather than `s///` so\n# BOTH the pattern and the replacement are literal: no Perl regex\n# metacharacters in the pattern and no `$1` / `$&` interpolation in the\n# replacement. Go's `bf_replace` (strings.Replace, n=1) treats the\n# replacement literally too, so the two adapters stay byte-equal \u2014 this\n# diverges from JS only for replacement strings containing `$`-patterns\n# (rare in template position). An empty pattern inserts the replacement\n# at the front (`\"abc\".replace(\"\", \"X\")` \u2192 \"Xabc\"), matching JS + Go.\n\nsub replace ($self, $recv, $pattern, $replacement) {\n    my $s = defined $recv && !ref($recv) ? \"$recv\" : '';\n    my $o = defined $pattern ? \"$pattern\" : '';\n    my $n = defined $replacement ? \"$replacement\" : '';\n    return $n . $s if $o eq '';\n    my $i = index($s, $o);\n    return $s if $i < 0;\n    return substr($s, 0, $i) . $n . substr($s, $i + length($o));\n}\n\n# `String.prototype.repeat(n)` \u2014 the receiver concatenated n times\n# (#1448 Tier B), via Perl's `x` operator. JS throws RangeError for a\n# negative count, but SSR templates degrade to the empty string rather\n# than dying mid-render, so a count <= 0 returns \"\" (Go's `bf_repeat`\n# applies the same clamp). The count is truncated toward zero\n# (`int`), matching JS's ToIntegerOrInfinity on `\"a\".repeat(3.7)`.\n\nsub repeat ($self, $recv, $count) {\n    my $s = defined $recv && !ref($recv) ? \"$recv\" : '';\n    my $n = defined $count ? int($count) : 0;\n    return $n <= 0 ? '' : $s x $n;\n}\n\n# `String.prototype.padStart` / `padEnd` (#1448 Tier B) \u2014 pad the\n# receiver to `$target` characters with `$pad` (default a single space)\n# repeated and truncated to fill, prepended or appended. Length is\n# measured in characters (Perl `length`), matching Go's rune-based\n# `bf_pad_*` \u2014 diverges from JS's UTF-16-unit length only for\n# astral-plane input. An empty pad, or a receiver already >= `$target`,\n# returns the receiver unchanged (JS parity). The `$target` is\n# truncated toward zero (JS ToLength on the first arg).\n\nsub _pad ($s, $target, $pad, $at_start) {\n    $pad = ' ' unless defined $pad;\n    $pad = \"$pad\";\n    return $s if $pad eq '';\n    my $len = length $s;\n    my $t   = int($target // 0);\n    return $s if $len >= $t;\n    my $need = $t - $len;\n    # Repeat enough copies to cover $need, then trim to exactly $need.\n    my $fill = substr($pad x (int($need / length($pad)) + 1), 0, $need);\n    return $at_start ? $fill . $s : $s . $fill;\n}\n\nsub pad_start ($self, $recv, $target, $pad = undef) {\n    my $s = defined $recv && !ref($recv) ? \"$recv\" : '';\n    return _pad($s, $target, $pad, 1);\n}\n\nsub pad_end ($self, $recv, $target, $pad = undef) {\n    my $s = defined $recv && !ref($recv) ? \"$recv\" : '';\n    return _pad($s, $target, $pad, 0);\n}\n\n# `Array.prototype.sort(cmp)` / `Array.prototype.toSorted(cmp)`\n# lowering (#1448 Tier B). Non-mutating \u2014 JS's mutate-vs-new\n# distinction is moot in SSR template context.\n#\n# Opts hash-ref. The compiler emits a `keys` list of per-key hashes\n# in priority order; each hash carries:\n#\n#   key_kind     => 'self' | 'field'\n#   key          => '' when key_kind eq 'self'; field name verbatim\n#                   from the comparator AST (e.g. 'price', 'createdAt')\n#                   when key_kind eq 'field' \u2014 no case normalisation\n#                   applied. Perl hash lookups are case-sensitive so\n#                   the key here must match the actual hash key the\n#                   user populated.\n#   compare_type => 'numeric' | 'string' | 'auto'\n#   direction    => 'asc' | 'desc'\n#\n# Accepted comparator catalogue (gated upstream at parse time \u2014\n# anything outside refuses with BF101 before reaching this helper):\n#\n#   (a,b) => a.f - b.f                       \u2192 field, numeric\n#   (a,b) => a - b                           \u2192 self,  numeric\n#   (a,b) => a[.f].localeCompare(b[.f])      \u2192 field|self, string\n#   (a,b) => a.f > b.f ? 1 : -1              \u2192 field|self, auto\n#   any of the above ||-chained              \u2192 multi-key tie-breaks\n#   (and reversed-operand variants for `desc`).\n#\n# `auto` (relational-ternary lowering) compares numerically when both\n# keys `looks_like_number`, else lexically \u2014 Go's `bf_sort` applies the\n# same rule so the two template adapters stay byte-equal.\n#\n# A future `nulls => 'first' | 'last'` knob can land per key without\n# churn \u2014 the opts hash is the right place to grow.\n\nsub sort ($self, $recv, $opts = {}) {\n    return [] unless ref($recv) eq 'ARRAY';\n\n    # Normalise the per-key specs (priority order, length >= 1).\n    my @spec = map {\n        {\n            key_kind     => $_->{key_kind}     // 'self',\n            key          => $_->{key}          // '',\n            compare_type => $_->{compare_type} // 'numeric',\n            direction    => $_->{direction}    // 'asc',\n        }\n    } @{ $opts->{keys} // [] };\n    return [ @$recv ] unless @spec;\n\n    # Schwartzian transform: project each item to all its sort keys\n    # once, then compare projected keys. Cheaper than re-resolving the\n    # field accessors inside every comparison for non-trivial arrays.\n    my @keyed = map {\n        my $item = $_;\n        my @ks = map {\n            $_->{key_kind} eq 'field' && ref($item) eq 'HASH' ? $item->{ $_->{key} } : $item;\n        } @spec;\n        [ \\@ks, $item ];\n    } @$recv;\n\n    my $cmp = sub {\n        for my $i (0 .. $#spec) {\n            my $sp = $spec[$i];\n            my $c  = _compare_sort_key($a->[0][$i], $b->[0][$i], $sp->{compare_type});\n            next if $c == 0;            # tie on this key \u2014 try the next\n            return $sp->{direction} eq 'desc' ? -$c : $c;\n        }\n        return 0;\n    };\n\n    my @sorted = sort $cmp @keyed;\n    return [ map { $_->[1] } @sorted ];\n}\n\n# Compare two projected keys, ascending orientation (-1 / 0 / 1); the\n# caller negates for 'desc'. 'auto' compares numerically when both\n# keys look like numbers, else lexically (matches Go's `bf_sort`).\n# undef coalesces to '' / 0 so the order stays total without warnings.\nsub _compare_sort_key ($av, $bv, $compare_type) {\n    if ($compare_type eq 'string') {\n        return ($av // '') cmp ($bv // '');\n    }\n    if ($compare_type eq 'auto') {\n        if (looks_like_number($av // '') && looks_like_number($bv // '')) {\n            return ($av // 0) <=> ($bv // 0);\n        }\n        return ($av // '') cmp ($bv // '');\n    }\n    return ($av // 0) <=> ($bv // 0);    # numeric\n}\n\n# Fold an array into a scalar via the arithmetic-fold catalogue\n# (#1448 Tier C). Mirrors Go's `bf_reduce` and JS `reduce(fn, init)` /\n# `reduceRight(fn, init)` for the shapes `(acc, x) => acc <op> x` /\n# `(acc, x) => acc <op> x.field`:\n#\n#   bf->reduce($recv, {\n#     op        => '+' | '*',\n#     key_kind  => 'self' | 'field',\n#     key       => '<field>',         # when key_kind eq 'field'\n#     type      => 'numeric' | 'string',\n#     init      => <seed>,            # number, or string for concat\n#     direction => 'left' | 'right',  # 'right' = reduceRight (default 'left')\n#   })\n#\n# Numeric folds accumulate with `+` / `*` (non-numeric keys coalesce to\n# 0); string folds concatenate via `bf->string` (undef \u2192 ''). The init\n# seeds the accumulator, so an empty array returns it unchanged \u2014 exactly\n# like JS. `direction => 'right'` folds right-to-left (reduceRight); only\n# observable for string concat, since numeric sum / product commute.\n# Float stringification can diverge from Go's for inexact binary\n# fractions (e.g. 0.1 + 0.2); integer sums \u2014 the common case \u2014 agree.\nsub reduce ($self, $recv, $opts = {}) {\n    my $op        = $opts->{op}        // '+';\n    my $key_kind  = $opts->{key_kind}  // 'self';\n    my $key       = $opts->{key}       // '';\n    my $type      = $opts->{type}      // 'numeric';\n    my $direction = $opts->{direction} // 'left';\n\n    my @items = ref($recv) eq 'ARRAY' ? @$recv : ();\n    # reduceRight folds right-to-left; reversing the snapshot keeps the\n    # single forward loop below. Only observable for string concat \u2014\n    # numeric sum / product commute. Qualify as CORE::reverse \u2014 this\n    # package defines `sub reverse` (the `.reverse()` helper), so a bare\n    # `reverse` is ambiguous under `use warnings`.\n    @items = CORE::reverse(@items) if $direction eq 'right';\n    my $project = sub ($item) {\n        $key_kind eq 'field' && ref($item) eq 'HASH' ? $item->{$key} : $item;\n    };\n\n    if ($type eq 'string') {\n        my $acc = $opts->{init} // '';\n        $acc .= $self->string($project->($_)) for @items;\n        return $acc;\n    }\n\n    my $acc = $opts->{init} // 0;\n    for my $item (@items) {\n        my $n = $project->($item);\n        # Guard `defined` before `looks_like_number` so a missing field\n        # (undef) folds as 0 without an \"uninitialized value\" warning\n        # under `use warnings` \u2014 matching the `$av // ''` style `sort` uses.\n        $n = 0 unless defined $n && looks_like_number($n);\n        $op eq '*' ? ($acc *= $n) : ($acc += $n);\n    }\n    return $acc;\n}\n\n# ---------------------------------------------------------------------------\n# JSX intrinsic-element spread (#1407)\n# ---------------------------------------------------------------------------\n#\n# Mirrors the JS `spreadAttrs` runtime\n# (`packages/client/src/runtime/spread-attrs.ts`) and the Go adapter's\n# `bf.SpreadAttrs` so SSR output stays byte-equal across the three\n# adapters. Generated Mojo templates invoke this as\n# `<%== bf->spread_attrs($bag) %>`.\n#\n# Skip rules: nil/false values, event handlers (`on[A-Z]\u2026` shape\n# matching JS `key[2] === key[2].toUpperCase()` \u2014 true for any\n# character whose uppercase is itself, including digits and\n# underscore), `children`. `ref` is intentionally NOT filtered,\n# matching the JS reference.\n#\n# Key remap: className \u2192 class, htmlFor \u2192 for; SVG camelCase\n# attrs preserved (case-sensitive XML spec); other camelCase keys\n# lowered to kebab-case with a leading `-` for an initial\n# uppercase letter (mirrors JS `key.replace(/([A-Z])/g, '-$1')`).\n#\n# `style` is routed through `_style_to_css` so object literals\n# serialise to a real CSS string instead of Perl's default\n# `HASH(0x...)` form.\n#\n# Output is deterministic: keys are sorted alphabetically before\n# emission, matching the Go adapter's `sort.Strings(keys)` policy\n# and Mojo::JSON's marshal order.\n#\n# The return value is a Mojo::ByteStream so the calling template's\n# `<%==` raw-emit skips re-escaping (the helper has already\n# HTML-escaped each value).\n\nmy %SVG_CAMEL_CASE_ATTRS = map { $_ => 1 } qw(\n    allowReorder attributeName attributeType autoReverse\n    baseFrequency baseProfile calcMode clipPathUnits\n    contentScriptType contentStyleType diffuseConstant edgeMode\n    externalResourcesRequired filterRes filterUnits glyphRef\n    gradientTransform gradientUnits kernelMatrix kernelUnitLength\n    keyPoints keySplines keyTimes lengthAdjust limitingConeAngle\n    markerHeight markerUnits markerWidth maskContentUnits\n    maskUnits numOctaves pathLength patternContentUnits\n    patternTransform patternUnits pointsAtX pointsAtY pointsAtZ\n    preserveAlpha preserveAspectRatio primitiveUnits refX refY\n    repeatCount repeatDur requiredExtensions requiredFeatures\n    specularConstant specularExponent spreadMethod startOffset\n    stdDeviation stitchTiles surfaceScale systemLanguage\n    tableValues targetX targetY textLength viewBox viewTarget\n    xChannelSelector yChannelSelector zoomAndPan\n);\n\nsub _to_attr_name ($key) {\n    return 'class' if $key eq 'className';\n    return 'for'   if $key eq 'htmlFor';\n    return $key    if $SVG_CAMEL_CASE_ATTRS{$key};\n    # camelCase \u2192 kebab-case, with a leading `-` for an initial\n    # uppercase letter (JS-reference parity, even though that case\n    # produces an HTML-invalid attribute name \u2014 same documented\n    # behaviour as the Go adapter's `toAttrName`).\n    my $out = $key;\n    $out =~ s/([A-Z])/-\\L$1/g;\n    return $out;\n}\n\nsub _html_escape ($value) {\n    # HTML attribute-value escape for SSR string emission. The\n    # spread bag's values reach the browser as part of a generated\n    # `key=\"...\"` substring inside the rendered HTML, so the\n    # escape set has to cover everything that could break either\n    # the surrounding double-quoted attribute or the enclosing\n    # tag: `&`, `<`, `>`, `\"`, and `'`. Matches Go's\n    # `template.HTMLEscapeString` semantics byte-for-byte (using\n    # `&#34;` / `&#39;` for quotes rather than the named entities)\n    # so the SSR output is identical across the Go and Mojo\n    # adapters (#1407, #1413 review). The CSR-side\n    # `applyRestAttrs` calls `el.setAttribute(name, String(value))`\n    # \u2014 which does its own DOM-level escaping in the browser \u2014\n    # so JS doesn't need an explicit escape pass; Perl/Go emit a\n    # string, so we do.\n    my $s = defined $value ? \"$value\" : '';\n    $s =~ s/&/&amp;/g;\n    $s =~ s/</&lt;/g;\n    $s =~ s/>/&gt;/g;\n    $s =~ s/\"/&#34;/g;\n    $s =~ s/'/&#39;/g;\n    return $s;\n}\n\nsub _style_to_css ($value) {\n    return undef unless defined $value;\n    # Non-hashref values pass through stringified \u2014 matches the JS\n    # `typeof value !== 'object'` branch in `styleToCss`.\n    if (ref($value) ne 'HASH') {\n        my $s = \"$value\";\n        return length $s ? $s : undef;\n    }\n    my @parts;\n    for my $key (sort keys %$value) {\n        my $v = $value->{$key};\n        next unless defined $v;\n        my $prop = $key;\n        $prop =~ s/([A-Z])/-\\L$1/g;\n        push @parts, \"$prop:$v\";\n    }\n    return @parts ? join(';', @parts) : undef;\n}\n\nsub spread_attrs ($self, $bag) {\n    return '' unless defined $bag && ref($bag) eq 'HASH';\n    my @parts;\n    for my $key (sort keys %$bag) {\n        # Event handlers: skip when key starts `on` and the third\n        # character is its own uppercase form (uppercase letter,\n        # digit, underscore, \u2026). Mirrors the JS predicate.\n        if (length($key) > 2 && substr($key, 0, 2) eq 'on') {\n            my $c = substr($key, 2, 1);\n            next if uc($c) eq $c;\n        }\n        next if $key eq 'children';\n        my $val = $bag->{$key};\n        # null / undef \u2192 drop.\n        next unless defined $val;\n        # Boolean values arrive as Mojo::JSON sentinel objects\n        # (`Mojo::JSON::true` / `false`) \u2014 both from JSON-deserialised\n        # props and from the test harness's `toPerlLiteral`\n        # (which emits the sentinels rather than plain 0/1 to avoid\n        # conflating booleans with numeric attribute values like\n        # `tabindex=\"0\"`). The contract is: callers MUST use the\n        # sentinels for boolean values; plain Perl scalars 0/1\n        # render as numeric attribute values, matching how JS\n        # `spreadAttrs` treats a `0`/`1` JS number.\n        if (ref($val) eq 'JSON::PP::Boolean' || ref($val) eq 'Mojo::JSON::_Bool') {\n            next unless $val;\n            push @parts, _to_attr_name($key);\n            next;\n        }\n        # `style` routes through `_style_to_css` so object literals\n        # serialise to a real CSS string.\n        if ($key eq 'style') {\n            my $css = _style_to_css($val);\n            next unless defined $css && length $css;\n            push @parts, qq{style=\"} . _html_escape($css) . qq{\"};\n            next;\n        }\n        my $name = _to_attr_name($key);\n        push @parts, $name . qq{=\"} . _html_escape($val) . qq{\"};\n    }\n    return '' unless @parts;\n    # Mark the result raw so the calling template's `<%==` raw-emit\n    # doesn't re-escape the already-escaped values (the Mojo backend\n    # returns a Mojo::ByteStream).\n    return $self->backend->mark_raw(join(' ', @parts));\n}\n\n1;\n__END__\n\n=encoding utf8\n\n=head1 NAME\n\nBarefootJS - Engine- and framework-agnostic server runtime for BarefootJS marked templates\n\n=head1 SYNOPSIS\n\n    use BarefootJS;\n\n    # A host injects a rendering backend (see BarefootJS::Backend::Xslate or\n    # Mojolicious::Plugin::BarefootJS for shipping backends).\n    my $bf = BarefootJS->new($context, { backend => $backend });\n\n    # The compiled marked template calls the runtime as a `bf` object:\n    #   <: $bf.scope_attr() :>  <: $bf.json($data) :>  <: $bf.spread_attrs($h) :>\n\n=head1 DESCRIPTION\n\nBarefootJS compiles JSX/TSX into a marked template plus client JS. This module\nis the server-side runtime the marked templates call into at render time. It is\ndeliberately template-engine- and web-framework-agnostic: every operation that\ndepends on I<how> a template is rendered \u2014 JSON marshalling, raw-string marking,\nJSX-children materialisation, and named-template rendering \u2014 is delegated to a\npluggable C<backend>.\n\nThat design lets the one runtime drive any backend. Shipping backends:\n\n=over 4\n\n=item * L<BarefootJS::Backend::Xslate> \u2014 Text::Xslate (Kolon); runs under any PSGI/Plack app.\n\n=item * L<BarefootJS::Backend::Mojo> \u2014 Mojolicious (via L<Mojolicious::Plugin::BarefootJS>).\n\n=back\n\nThe core itself pulls in only core Perl modules (C<POSIX>, C<Scalar::Util>);\nno template engine or web framework is loaded unless a backend that needs one\nis used.\n\n=head1 SEE ALSO\n\nL<BarefootJS::Backend::Xslate>, L<Mojolicious::Plugin::BarefootJS>,\nL<https://github.com/piconic-ai/barefootjs>\n\n=head1 AUTHOR\n\nkobaken E<lt>kentafly88@gmail.comE<gt>\n\n=head1 LICENSE\n\nCopyright (c) 2025-present BarefootJS Contributors.\n\nThis library is free software; you can redistribute it and/or modify it under\nthe MIT License. See the F<LICENSE> file in the distribution for the full text.\n\n=cut\n";
-    barefootBackendMojoPmSource = "package BarefootJS::Backend::Mojo;\nour $VERSION = \"0.01\";\nuse Mojo::Base -base, -signatures;\n\nuse Mojo::ByteStream qw(b);\nuse Mojo::JSON qw(to_json);\nuse Scalar::Util qw(weaken);\n\n# ---------------------------------------------------------------------------\n# Reference rendering backend (Mojolicious / Mojo::Template).\n# ---------------------------------------------------------------------------\n#\n# BarefootJS.pm holds all the template-engine-agnostic logic (the JS-compat\n# value helpers, array/string methods, hydration markers). Everything that is\n# specific to *how a template is rendered* \u2014 JSON marshalling, raw-string\n# marking, JSX-children materialisation, and named-template rendering \u2014 lives\n# behind this backend object so the same runtime can drive a different Perl\n# template engine (Text::Xslate, Template Toolkit, \u2026) without rewriting the\n# helper surface.\n#\n# A backend MUST implement:\n#   - encode_json($data)            -> string\n#   - mark_raw($str)                -> value the engine emits without escaping\n#   - materialize($value)           -> string (resolve a captured-children ref)\n#   - render_named($name, $bf, \\%vars) -> string\n#\n# This Mojo implementation is the reference. To target another engine, write a\n# sibling backend (BarefootJS::Backend::Xslate, \u2026) implementing the same four\n# methods and pass it via `BarefootJS->new($c, { backend => $b })`.\n\n# The Mojolicious controller. Optional: the value-marshalling helpers\n# (`encode_json` / `mark_raw` / `materialize`) work without it; only\n# `render_named` reaches into the controller's renderer + stash.\nhas 'c';\n\n# Pluggable JSON encoder (#engine-abstraction). Defaults to\n# `Mojo::JSON::to_json`, which returns a *character* string (not bytes)\n# suitable for embedding in HTML output via `<%==` / Mojo::ByteStream.\n#\n# Override with any `sub ($data) { ... }` to swap in a faster XS encoder \u2014\n# e.g. `json_encoder => sub { Cpanel::JSON::XS->new->canonical->encode($_[0]) }`.\n# The pure-Perl JSON::PP fallback Mojo::JSON uses can be a hot spot for large\n# props payloads; the seam lets a host pick its own implementation without\n# touching the runtime.\nhas 'json_encoder' => sub { \\&to_json };\n\n# Hold the controller weakly for the same reason BarefootJS does: the\n# controller owns the bf instance (which owns this backend) via its stash,\n# so a strong back-reference would close a per-request cycle the refcount GC\n# can't reclaim. `render_named` only touches `$self->c` mid-render, while the\n# controller is still alive on the request stack.\nsub new ($class, %args) {\n    my $self = $class->SUPER::new(%args);\n    weaken($self->{c}) if $self->{c};\n    return $self;\n}\n\nsub encode_json ($self, $data) {\n    return $self->json_encoder->($data);\n}\n\n# Mark a string as already-safe so the template engine emits it verbatim\n# (no re-escaping). In Mojo this is a Mojo::ByteStream, which the calling\n# template's `<%==` raw-emit passes through unescaped.\nsub mark_raw ($self, $str) {\n    return b($str);\n}\n\n# JSX children / async fallbacks arrive via Mojo's `begin %>...<% end`\n# capture, which produces a CODE ref returning a Mojo::ByteStream. Resolve\n# it to a string before embedding. Plain (already-rendered) strings pass\n# through unchanged.\nsub materialize ($self, $value) {\n    return ref($value) eq 'CODE' ? $value->() : $value;\n}\n\n# Render a named template with `$child_bf` bound as the active runtime\n# instance for that render. The Mojo `bf` helper resolves the current\n# instance off `$c->stash->{'bf.instance'}`; swap it for the duration of\n# the nested render and restore it afterwards so sibling renders are\n# unaffected.\nsub render_named ($self, $template_name, $child_bf, $vars) {\n    my $c = $self->c;\n    my $prev = $c->stash->{'bf.instance'};\n    $c->stash->{'bf.instance'} = $child_bf;\n    my $html = $c->render_to_string(template => $template_name, %$vars);\n    $c->stash->{'bf.instance'} = $prev;\n    return $html;\n}\n\n1;\n";
-    barefootPluginPmSource = "package Mojolicious::Plugin::BarefootJS;\nour $VERSION = \"0.01\";\nuse Mojo::Base 'Mojolicious::Plugin', -signatures;\n\nuse Mojo::File qw(path);\nuse Mojo::JSON qw(decode_json);\n\nuse BarefootJS;\n\n# Plugin entry point. Wires up:\n#\n#   1. The `bf` controller helper. Lazily instantiates one\n#      BarefootJS object per request and stashes it under\n#      `bf.instance`.\n#\n#   2. A `before_render` hook that, when the rendered template name\n#      matches a top-level component in the build manifest, fills the\n#      heavy boilerplate the user previously hand-rolled in `app.pl`:\n#      generates the scope id, registers every UI-registry child\n#      renderer from the manifest, and seeds the stash with each\n#      template variable's static default (issue #1416).\n#\n# Configuration (all optional):\n#   - manifest_path: absolute path to the `bf build`-emitted\n#     `manifest.json`. Defaults to `<app->home>/dist/templates/manifest.json`.\n#     Pass `undef` to disable manifest-driven auto-init entirely; the\n#     bf helper is still installed and callers can drive everything\n#     manually as before.\nsub register ($self, $app, $config = {}) {\n    $app->helper(bf => sub ($c) {\n        $c->stash->{'bf.instance'} //= BarefootJS->new($c, $config);\n    });\n\n    my $manifest = _load_manifest($app, $config);\n    return unless $manifest;\n\n    # Cache the set of UI-registry slot keys so we can answer\n    # \"is this template name a child or a top-level page?\" with a\n    # single hash lookup at render time. Top-level entries are\n    # everything that isn't `__barefoot__` and doesn't match\n    # `ui/<name>/index` \u2014 the same partition `register_components_from_manifest`\n    # applies internally.\n    my %is_child_entry;\n    for my $entry_name (keys %$manifest) {\n        next if $entry_name eq '__barefoot__';\n        next unless $entry_name =~ m{^ui/[^/]+/index$};\n        $is_child_entry{$entry_name} = 1;\n    }\n\n    $app->hook(before_render => sub ($c, $args) {\n        my $template = $args->{template};\n        return unless defined $template && length $template;\n        my $entry = $manifest->{$template};\n        return unless $entry;\n        return if $is_child_entry{$template};\n        # Idempotency guard for nested renders. A controller might\n        # call `render_to_string` inside an action and then `render`\n        # \u2014 without this we'd re-init `bf` on the second pass and\n        # wipe the script registrations the first pass collected.\n        return if $c->stash->{'bf.auto_init_done'};\n\n        # Escape hatch for callers that wire `bf` up by hand (the\n        # existing `render_component` helper in the showcase app does\n        # this). If `_scope_id` is already set we treat the request as\n        # \"manually managed\" and leave it alone \u2014 same outcome as\n        # before the plugin gained auto-init.\n        my $bf = $c->bf;\n        if (defined $bf->_scope_id && length $bf->_scope_id) {\n            $c->stash->{'bf.auto_init_done'} = 1;\n            return;\n        }\n        $c->stash->{'bf.auto_init_done'} = 1;\n\n        $bf->_scope_id($template . '_' . substr(rand() =~ s/^0\\.//r, 0, 6));\n        $bf->register_components_from_manifest($manifest);\n\n        # Seed each ssrDefault into the stash unless the caller has\n        # already supplied a value for that key \u2014 callers always win.\n        my $defaults = $entry->{ssrDefaults};\n        if (ref($defaults) eq 'HASH') {\n            for my $name (keys %$defaults) {\n                next if exists $c->stash->{$name};\n                my $d = $defaults->{$name};\n                my $value = ref($d) eq 'HASH' ? $d->{value} : $d;\n                $c->stash->{$name} = $value;\n            }\n        }\n    });\n}\n\nsub _load_manifest ($app, $config) {\n    return undef if exists $config->{manifest_path} && !defined $config->{manifest_path};\n    my $manifest_path = $config->{manifest_path}\n        // $app->home->child('dist/templates/manifest.json');\n    my $file = path($manifest_path);\n    return undef unless -r $file;\n    my $manifest = eval { decode_json($file->slurp) };\n    if ($@ || ref($manifest) ne 'HASH') {\n        $app->log->warn(\"BarefootJS: cannot parse manifest at $file: $@\") if $@;\n        return undef;\n    }\n    return $manifest;\n}\n\n1;\n__END__\n\n=encoding utf8\n\n=head1 NAME\n\nMojolicious::Plugin::BarefootJS - Mojolicious integration for BarefootJS\n\n=head1 SYNOPSIS\n\n    # Mojolicious application\n    $self->plugin('BarefootJS');\n\n    # In a controller / template, the `bf` helper exposes a per-request\n    # BarefootJS runtime backed by BarefootJS::Backend::Mojo.\n\n=head1 DESCRIPTION\n\nWires the L<BarefootJS> server runtime into L<Mojolicious>. It registers a\nC<bf> controller helper that lazily instantiates one BarefootJS object per\nrequest (rendering via L<BarefootJS::Backend::Mojo>), and supports rendering\ncompiled marked templates as Mojolicious templates.\n\nFor non-Mojolicious / PSGI hosts, see L<BarefootJS::Backend::Xslate>, which\ndrives the same runtime with Text::Xslate and no web framework.\n\n=head1 METHODS\n\nL<Mojolicious::Plugin::BarefootJS> inherits all methods from\nL<Mojolicious::Plugin> and implements the following new one.\n\n=head2 register\n\n    $plugin->register(Mojolicious->new, \\%conf);\n\nRegisters the plugin (the C<bf> helper and supporting hooks) in a Mojolicious\napplication.\n\n=head1 SEE ALSO\n\nL<BarefootJS>, L<BarefootJS::Backend::Mojo>, L<BarefootJS::Backend::Xslate>,\nL<Mojolicious>, L<https://github.com/piconic-ai/barefootjs>\n\n=head1 AUTHOR\n\nkobaken E<lt>kentafly88@gmail.comE<gt>\n\n=head1 LICENSE\n\nCopyright (c) 2025-present BarefootJS Contributors.\n\nThis library is free software; you can redistribute it and/or modify it under\nthe MIT License. See the F<LICENSE> file in the distribution for the full text.\n\n=cut\n";
+    barefootPmSource = "package BarefootJS;\nour $VERSION = \"0.8.0\";\nuse strict;\nuse warnings;\nuse utf8;\nuse feature 'signatures';\nno warnings 'experimental::signatures';\n\nuse POSIX ();\nuse Scalar::Util qw(looks_like_number weaken);\n\n# NOTE: This runtime is template-engine-agnostic AND framework-agnostic by\n# design, so it can ship as a standalone CPAN distribution. It depends only on\n# core Perl (subroutine signatures + the hand-rolled minimal accessor base\n# below \u2014 no Mojo::Base, no Class::Tiny). Every operation that depends on *how*\n# a template is rendered \u2014 JSON marshalling, raw-string marking, JSX-children\n# materialisation, and named-template rendering \u2014 is delegated to a pluggable\n# `backend` (see BarefootJS::Backend::Mojo for the reference Mojolicious\n# implementation), which is the only component that pulls in the Mojo\n# distribution, and only when it is actually used.\n\n# ---------------------------------------------------------------------------\n# Minimal accessor base (no Mojo::Base / Class::Tiny dependency)\n# ---------------------------------------------------------------------------\n#\n# Generates read/write accessors with optional lazy defaults so the runtime\n# stays free of any non-core OO base. Semantics mirror the Mojo::Base `has`\n# this class used to inherit: a getter returns the stored value (building it\n# from the default on first access if unset); a setter stores the value and\n# returns $self for chaining. A default is either a plain scalar or a coderef\n# invoked as `$default->($self)` (for per-instance refs like `[]` / `{}` and\n# the lazily-required Mojo backend).\nmy %ATTR_DEFAULT = (\n    _scripts         => sub { [] },\n    _script_seen     => sub { {} },\n    _child_renderers => sub { {} },\n    _is_child        => 0,\n    # Lazily fall back to the Mojo reference backend so a bare-blessed\n    # instance (the pure-function unit tests) and the historical\n    # `BarefootJS->new($c, ...)` callers keep working unchanged. A non-Mojo\n    # host injects its own backend via `BarefootJS->new($c, { backend => $b })`\n    # and never triggers this require \u2014 keeping the core load Mojo-free.\n    backend          => sub {\n        require BarefootJS::Backend::Mojo;\n        return BarefootJS::Backend::Mojo->new;\n    },\n);\n\n# c            \u2014 Mojolicious controller (kept for back-compat accessors)\n# config       \u2014 plugin / instance config\n# backend      \u2014 the template-engine seam (#engine-abstraction)\n# _scope_id    \u2014 addressable scope id\n# _bf_parent / _bf_mount \u2014 slot identity when this scope is slot-attached\n# _props       \u2014 props serialised into bf-p / the scope comment\nfor my $attr (qw(\n    c config backend\n    _scripts _script_seen _scope_id _is_child _bf_parent _bf_mount _props\n    _child_renderers\n)) {\n    no strict 'refs';\n    *{\"BarefootJS::$attr\"} = sub {\n        my $self = shift;\n        if (@_) { $self->{$attr} = shift; return $self; }\n        if (!exists $self->{$attr} && exists $ATTR_DEFAULT{$attr}) {\n            my $d = $ATTR_DEFAULT{$attr};\n            $self->{$attr} = ref($d) eq 'CODE' ? $d->($self) : $d;\n        }\n        return $self->{$attr};\n    };\n}\n\nsub new ($class, $c, $config = {}) {\n    # Build (or accept an injected) rendering backend. The default Mojo\n    # backend wraps the controller and honours an optional `json_encoder`\n    # override so a host can swap in a faster XS JSON implementation\n    # without subclassing. A caller targeting another template engine\n    # passes its own backend via `$config->{backend}`.\n    my $backend = $config->{backend};\n    unless ($backend) {\n        require BarefootJS::Backend::Mojo;\n        $backend = BarefootJS::Backend::Mojo->new(\n            c => $c,\n            ($config->{json_encoder}\n                ? (json_encoder => $config->{json_encoder})\n                : ()),\n        );\n    }\n    my $self = bless {\n        c       => $c,\n        config  => $config,\n        backend => $backend,\n    }, $class;\n    # Hold the controller weakly. Mojolicious stashes this bf instance under\n    # `$c->stash->{'bf.instance'}`, so a strong bf -> controller back-reference\n    # closes a per-request cycle ($c -> stash -> bf -> $c) that Perl's\n    # refcount GC cannot reclaim, leaking one controller + bf + child-renderer\n    # closures per request. The controller owns (outlives) the per-request bf,\n    # so the weak ref stays valid for the whole render. Callers that need the\n    # controller to outlive the bf instance independently must keep their own\n    # strong reference (the normal Mojo request scope already does).\n    weaken($self->{c}) if defined $c;\n    return $self;\n}\n\n# ---------------------------------------------------------------------------\n# Scope & Props\n# ---------------------------------------------------------------------------\n\nsub scope_attr ($self) {\n    # bf-s is the addressable scope id only (#1249).\n    return $self->_scope_id // '';\n}\n\n# Emits `bf-h=\"<host>\" bf-m=\"<slot>\" bf-r=\"\"` conditionally.\n# See spec/compiler.md \"Slot identity\".\nsub hydration_attrs ($self) {\n    my @parts;\n    my $host  = $self->_bf_parent;\n    my $mount = $self->_bf_mount;\n    if (defined $host && length $host) {\n        my $h = $host =~ s/\"/&quot;/gr;\n        push @parts, qq{bf-h=\"$h\"};\n    }\n    if (defined $mount && length $mount) {\n        my $m = $mount =~ s/\"/&quot;/gr;\n        push @parts, qq{bf-m=\"$m\"};\n    }\n    unless ($self->_is_child) {\n        push @parts, q{bf-r=\"\"};\n    }\n    return join(' ', @parts);\n}\n\nsub props_attr ($self) {\n    my $props = $self->_props;\n    return '' unless $props && %$props;\n    # encode_json returns a character string (not bytes) for safe embedding\n    # in templates (the Mojo backend uses Mojo::JSON::to_json).\n    my $json = $self->backend->encode_json($props);\n    return qq{ bf-p='$json'};\n}\n\n# ---------------------------------------------------------------------------\n# Comment Markers\n# ---------------------------------------------------------------------------\n\nsub comment ($self, $text) {\n    return \"<!--bf-$text-->\";\n}\n\n# ---------------------------------------------------------------------------\n# JS-equivalent value stringification\n# ---------------------------------------------------------------------------\n\n# Map a Perl boolean-shaped value to the JS `String(bool)` form.\n# Used by the Mojo adapter when emitting reactive attribute bindings\n# whose JS source `isBooleanResultExpr` classified as boolean \u2014\n# a comparison (`count() > 0`), a logical negation (`!ok()`), or a\n# literal `true` / `false`. Perl's auto-stringification of those\n# expressions yields `''` / `1`; Hono and Go emit `'false'` / `'true'`.\n# Centralising the bool \u2192 string mapping here keeps the contract\n# testable and the template-emit syntax tidy\n# (`<%= bf->bool_str(...) %>` vs an inline ternary).\n#\n# Contract is boolean-only: callers must have classified the\n# expression as boolean-result before routing through this helper.\n# Non-boolean values reaching here will be Perl-truthy-coerced to\n# 'true' / 'false', which is generally wrong \u2014 non-boolean attribute\n# bindings stay on the plain `<%= expr %>` emit path and never reach\n# this function.\nsub bool_str ($self, $value) {\n    return $value ? 'true' : 'false';\n}\n\nsub text_start ($self, $slot_id) {\n    return \"<!--bf:$slot_id-->\";\n}\n\nsub text_end ($self) {\n    return \"<!--/-->\";\n}\n\n# See spec/compiler.md \"Slot identity\" for the comment-scope wire format.\nsub scope_comment ($self) {\n    my $scope_id = $self->_scope_id // '';\n    my $host_segment = '';\n    my $host  = $self->_bf_parent;\n    my $mount = $self->_bf_mount;\n    if (defined $host && length $host) {\n        $host_segment = \"|h=$host|m=\" . ($mount // '');\n    }\n    my $props_json = '';\n    if ($self->_props && %{$self->_props}) {\n        $props_json = '|' . $self->backend->encode_json($self->_props);\n    }\n    return \"<!--bf-scope:$scope_id$host_segment$props_json-->\";\n}\n\n# ---------------------------------------------------------------------------\n# Script Registration\n# ---------------------------------------------------------------------------\n\nsub register_script ($self, $path) {\n    return if $self->_script_seen->{$path};\n    $self->_script_seen->{$path} = 1;\n    push @{$self->_scripts}, $path;\n}\n\n# ---------------------------------------------------------------------------\n# Child Component Rendering\n# ---------------------------------------------------------------------------\n# (`_child_renderers` accessor is generated by the minimal accessor base above.)\n\nsub register_child_renderer ($self, $name, $renderer) {\n    $self->_child_renderers->{$name} = $renderer;\n}\n\nsub render_child ($self, $name, @args) {\n    my $renderer = $self->_child_renderers->{$name};\n    die \"No renderer registered for child component '$name'\" unless $renderer;\n    # Accept both the Mojo list form \u2014 `bf->render_child($name, k => v, ...)`\n    # \u2014 and the single-hashref form \u2014 `$bf.render_child($name, { k => v })`.\n    # Template languages whose method calls can't splat a hash into positional\n    # args (Text::Xslate Kolon, Template Toolkit) pass one hashref instead.\n    my %props = (@args == 1 && ref $args[0] eq 'HASH') ? %{ $args[0] } : @args;\n    # JSX children come in via the engine's children-capture mechanism\n    # (Mojo's `begin %>...<% end`, which produces a CODE ref returning a\n    # Mojo::ByteStream). Materialize it through the backend before handing\n    # the props to the child renderer so the child template sees\n    # `$children` as already-rendered HTML. Guard on `exists` so a\n    # childless invocation (`bf->render_child('counter')`) doesn't gain a\n    # spurious `children => undef` key \u2014 preserving the historical \"only\n    # touch children when present\" behaviour.\n    $props{children} = $self->backend->materialize($props{children})\n        if exists $props{children};\n    return $renderer->(\\%props);\n}\n\n# ---------------------------------------------------------------------------\n# Bulk registration from build manifest\n# ---------------------------------------------------------------------------\n#\n# `bf build` emits dist/templates/manifest.json describing every\n# component the page might invoke (Counter, ui/button/index, ...).\n# This helper walks that manifest and registers one child renderer per\n# UI registry entry \u2014 the path shape `ui/<name>/index` maps to the\n# `<name>` slot key Counter.html.ep and friends use via\n# `<%= bf->render_child('<name>', ...) %>`.\n#\n# Each manifest entry carries an `ssrDefaults` hash derived statically\n# from the component's JSX (prop destructure defaults + signal /\n# memo initial values, see packages/jsx/src/ssr-defaults.ts). The\n# child renderer seeds every template variable from that hash,\n# preferring the caller's matching prop where one exists. This\n# replaces the per-component `signal_init` callback that every\n# scaffold's `app.pl` used to hand-roll for items 1/3 of issue #1416.\n#\n# `signal_init` remains as an opt-in override for cases the static\n# extractor can't see through (e.g. signal initial values that\n# reference imported helpers). When supplied for a given slot key\n# it takes precedence over the manifest's `ssrDefaults` for that\n# child, allowing callers to mix manual overrides with auto-derived\n# defaults for siblings.\nsub register_components_from_manifest ($self, $manifest, %opts) {\n    my $signal_inits = $opts{signal_init} // {};\n    my $parent_scope = $self->_scope_id;\n    # Weaken the parent capture so the child-renderer closures stored on\n    # `$self->_child_renderers` don't keep `$self` alive (the direct\n    # closure <-> parent cycle). The controller is reached through `$parent`\n    # at call time rather than captured strongly here, so the closures hold\n    # no strong reference to `$c` either \u2014 see the controller-cycle note in\n    # `new`. `$parent` is always live whenever a closure runs (the closure is\n    # stored on `$parent`, so `$parent` outlives every invocation).\n    weaken(my $parent = $self);\n\n    for my $entry_name (keys %$manifest) {\n        # `__barefoot__` is the runtime entry, not a component.\n        next if $entry_name eq '__barefoot__';\n        # Only UI registry components (path shape `ui/<name>/index`)\n        # become child renderers; top-level page components are the\n        # render target rather than a child.\n        next unless $entry_name =~ m{^ui/([^/]+)/index$};\n        my $slot_key = $1;\n        my $marked = $manifest->{$entry_name}{markedTemplate} // '';\n        next unless $marked;\n        # `templates/ui/button/index.html.ep` \u2192 `ui/button/index`\n        my $template_name = $marked;\n        $template_name =~ s{^templates/}{};\n        $template_name =~ s{\\.html\\.ep$}{};\n\n        my $signal_init = $signal_inits->{$slot_key};\n        my $manifest_defaults = $manifest->{$entry_name}{ssrDefaults};\n        $self->register_child_renderer($slot_key, sub {\n            my ($props) = @_;\n            # Child shares the parent's backend so nested renders go\n            # through the same engine + controller (and inherit any\n            # injected json_encoder). The controller is fetched via the weak\n            # `$parent` at call time \u2014 never captured strongly \u2014 so the\n            # closure adds no edge to the per-request reference cycle.\n            my $child_bf = BarefootJS->new($parent->c, { backend => $parent->backend });\n            my $slot_id = delete $props->{_bf_slot};\n            $child_bf->_scope_id(\n                $slot_id ? $parent_scope . '_' . $slot_id\n                         : $template_name . '_' . substr(rand() =~ s/^0\\.//r, 0, 6)\n            );\n            $child_bf->_is_child(1);\n            # (#1249) Slot identity: host scope + slot id. Emitted as\n            # bf-h / bf-m attributes by hydration_attrs.\n            if ($slot_id) {\n                $child_bf->_bf_parent($parent_scope);\n                $child_bf->_bf_mount($slot_id);\n            }\n            $child_bf->_scripts($parent->_scripts);\n            $child_bf->_script_seen($parent->_script_seen);\n\n            my %extra;\n            if ($signal_init) {\n                %extra = $signal_init->($props);\n            } elsif ($manifest_defaults) {\n                %extra = _derive_stash_from_defaults($manifest_defaults, $props);\n            }\n\n            # Render the child template with $child_bf bound as the active\n            # instance for the nested render. The backend owns the\n            # engine-specific binding + restore (stash juggle for Mojo).\n            my $html = $parent->backend->render_named(\n                $template_name, $child_bf, { %$props, %extra },\n            );\n            chomp $html;\n            return $html;\n        });\n    }\n}\n\n# Derive template-stash kvs from a manifest entry's `ssrDefaults`\n# section. Each entry shape:\n#   { value => <static-fallback>, propName => <prop>, isRestProps => bool }\n# For `isRestProps`, the rest bag passes through unchanged (or the\n# static `{}` if the caller didn't supply one). For ordinary entries\n# the caller's `$props->{propName}` wins when defined, otherwise the\n# static `value` does. `propName`-less entries (signal / memo locals)\n# always use the static value \u2014 the caller cannot override them.\nsub _derive_stash_from_defaults ($defaults, $props) {\n    my %extra;\n    for my $name (keys %$defaults) {\n        my $d = $defaults->{$name};\n        if (ref($d) ne 'HASH') {\n            $extra{$name} = $d;\n            next;\n        }\n        if ($d->{isRestProps}) {\n            $extra{$name} = exists $props->{$name} ? $props->{$name} : $d->{value};\n            next;\n        }\n        my $prop_name = $d->{propName};\n        if (defined $prop_name && exists $props->{$prop_name} && defined $props->{$prop_name}) {\n            $extra{$name} = $props->{$prop_name};\n        } else {\n            $extra{$name} = $d->{value};\n        }\n    }\n    return %extra;\n}\n\n# ---------------------------------------------------------------------------\n# Script Output\n# ---------------------------------------------------------------------------\n\nsub scripts ($self) {\n    my @tags;\n    for my $path (@{$self->_scripts}) {\n        push @tags, qq{<script type=\"module\" src=\"$path\"></script>};\n    }\n    return join(\"\\n\", @tags);\n}\n\n# ---------------------------------------------------------------------------\n# Streaming SSR (Out-of-Order)\n# ---------------------------------------------------------------------------\n\nsub streaming_bootstrap ($self) {\n    return q{<script>(function(){function s(id){var a=document.querySelector('[bf-async=\"'+id+'\"]');var t=document.querySelector('template[bf-async-resolve=\"'+id+'\"]');if(!a||!t)return;a.replaceChildren(t.content.cloneNode(true));a.removeAttribute('bf-async');t.remove();requestAnimationFrame(function(){if(window.__bf_hydrate)window.__bf_hydrate()})};window.__bf_swap=s})()</script>};\n}\n\nsub async_boundary ($self, $id, $fallback_html) {\n    # The fallback comes in via Mojo `begin %>...<% end` capture (see\n    # MojoAdapter::renderAsync), which produces a CODE ref returning a\n    # Mojo::ByteStream. Materialize it through the backend so the rendered\n    # HTML embeds in the placeholder rather than the CODE ref's\n    # stringification.\n    $fallback_html = $self->backend->materialize($fallback_html);\n    return qq{<div bf-async=\"$id\">$fallback_html</div>};\n}\n\nsub async_resolve ($self, $id, $content_html) {\n    return qq{<template bf-async-resolve=\"$id\">$content_html</template><script>__bf_swap(\"$id\")</script>};\n}\n\n# ---------------------------------------------------------------------------\n# JS-compat callees (#1189) \u2014 invoked from generated Mojo templates as\n# <%= bf->json($val) %>, <%= bf->floor($val) %>, etc. The MojoAdapter's\n# `templatePrimitives` registry emits these helper calls in place of the\n# corresponding JS callees (`JSON.stringify`, `Math.floor`, \u2026) so the SSR\n# template can render value-equivalent output without a JS engine.\n#\n# Failure policy mirrors the Go adapter (#1188): user-data marshalling\n# (json) bubbles errors so Mojolicious aborts loudly on cycles /\n# unsupported values rather than silently producing an empty payload.\n# Numeric coercion follows JS semantics (NaN propagates as the special\n# string 'NaN'; non-numeric input returns 'NaN' rather than 0). Strings\n# always coerce to a string representation.\n# ---------------------------------------------------------------------------\n\nsub json ($self, $value) {\n    # Mojo::JSON::to_json returns a character string (not bytes), suitable\n    # for embedding in HTML output via Mojo::ByteStream / `<%==`.\n    #\n    # Documented divergence from JS: JS distinguishes `null` (renders as\n    # \"null\") from `undefined` (`JSON.stringify(undefined)` returns the\n    # JS value `undefined`, not a string). Perl has no such distinction\n    # \u2014 both map to `undef`. We choose the `null` rendering for SSR\n    # ergonomics: an unset prop becomes the string \"null\" rather than\n    # the literal text \"undefined\" or an empty attribute. Matches the\n    # `null` case of JS exactly; diverges from the `undefined` case.\n    return $self->backend->encode_json($value);\n}\n\nsub string ($self, $value) {\n    # JS `String(v)` mirror. `undef` renders as the empty string here so\n    # an unset prop doesn't surface as a literal \"undefined\" / \"null\"\n    # in user-facing HTML \u2014 same divergence the Go adapter documents\n    # for `bf_string`.\n    return defined $value ? \"$value\" : '';\n}\n\nsub number ($self, $value) {\n    # JS `Number(v)` mirror. Numeric coerces via Perl's implicit\n    # numeric context; non-numeric / undef yield real numeric NaN\n    # (`'nan' + 0`) so downstream arithmetic propagates correctly\n    # (`Math.floor(NaN) === NaN`). Returning the literal string\n    # \"NaN\" would conflate the user-passing-the-string-\"NaN\" case\n    # with the parse-failure case, and break NaN detection in\n    # downstream helpers.\n    return 0 + 'nan' unless defined $value;\n    return $value + 0 if looks_like_number($value);\n    return 0 + 'nan';\n}\n\n# NaN is the only float for which `$x != $x` holds. Used as the\n# portable sentinel check in floor/ceil/round.\nsub _is_nan { my $n = shift; return $n != $n }\n\nsub floor ($self, $value) {\n    my $n = $self->number($value);\n    return $n if _is_nan($n);\n    return POSIX::floor($n);\n}\n\nsub ceil ($self, $value) {\n    my $n = $self->number($value);\n    return $n if _is_nan($n);\n    return POSIX::ceil($n);\n}\n\nsub round ($self, $value) {\n    my $n = $self->number($value);\n    return $n if _is_nan($n);\n    # POSIX has no `round`. JS `Math.round` rounds half toward\n    # +Infinity (so `Math.round(-1.5) === -1`, not -2). `floor(n\n    # + 0.5)` reproduces that for both signs.\n    return POSIX::floor($n + 0.5);\n}\n\n# ---------------------------------------------------------------------------\n# Array / String method helpers (#1448 Tier A)\n# ---------------------------------------------------------------------------\n#\n# `Array.prototype.includes(x)` and `String.prototype.includes(sub)`\n# share a method name in JS; the JSX parser can't tell the two\n# receiver shapes apart without TS type inference, so both lower to\n# the same IR node (`array-method` / method `includes`). This helper\n# dispatches at the Perl level via `ref()`:\n#   - ARRAY ref:  scan elements with `eq`; one defined-vs-undef\n#                 hop matches JS's `===` for null/undefined.\n#   - scalar:     `index($recv, $sub) != -1`, with both args\n#                 coerced through `// ''` so an undef receiver /\n#                 needle doesn't trip Perl's substr warning.\n# Anything else (HASH ref, code ref) returns false \u2014 matches the\n# JS semantic where `.includes` is only defined on Array /\n# TypedArray / String.\n\nsub includes ($self, $recv, $elem) {\n    if (ref($recv) eq 'ARRAY') {\n        for my $item (@$recv) {\n            if (!defined $item) {\n                return 1 if !defined $elem;\n                next;\n            }\n            return 1 if defined $elem && $item eq $elem;\n        }\n        return 0;\n    }\n    return 0 if ref($recv);\n    return index($recv // '', $elem // '') != -1 ? 1 : 0;\n}\n\n# `Array.prototype.filter(fn)` / `.every(fn)` / `.some(fn)`. The Xslate adapter\n# lowers a JS arrow predicate to a Kolon lambda (`-> $x { ... }`), which is\n# callable from Perl as a code ref, and emits `$bf.filter($arr, <lambda>)`.\n# `filter` returns a new arrayref; `every` / `some` return 1/0. Non-array /\n# empty receivers follow JS (`filter` \u2192 [], `every` \u2192 true, `some` \u2192 false).\n# (The Mojo adapter lowers these shapes inline and never reaches these methods.)\nsub filter ($self, $recv, $pred) {\n    return [] unless ref($recv) eq 'ARRAY';\n    return [ grep { $pred->($_) } @$recv ];\n}\n\nsub every ($self, $recv, $pred) {\n    return 1 unless ref($recv) eq 'ARRAY';\n    for my $item (@$recv) { return 0 unless $pred->($item) }\n    return 1;\n}\n\nsub some ($self, $recv, $pred) {\n    return 0 unless ref($recv) eq 'ARRAY';\n    for my $item (@$recv) { return 1 if $pred->($item) }\n    return 0;\n}\n\n# `Array.prototype.find(fn)` / `.findIndex(fn)` / `.findLast(fn)` /\n# `.findLastIndex(fn)` \u2014 same Kolon-lambda predicate mechanism as filter. The\n# camelCase JS names lower to these snake_case methods (like index_of /\n# last_index_of). `find` / `find_last` return the matching element (or undef \u2192\n# JS `undefined`); the index forms return the 0-based position (or -1).\nsub find ($self, $recv, $pred) {\n    return undef unless ref($recv) eq 'ARRAY';\n    for my $item (@$recv) { return $item if $pred->($item) }\n    return undef;\n}\n\nsub find_index ($self, $recv, $pred) {\n    return -1 unless ref($recv) eq 'ARRAY';\n    for my $i (0 .. $#$recv) { return $i if $pred->($recv->[$i]) }\n    return -1;\n}\n\nsub find_last ($self, $recv, $pred) {\n    return undef unless ref($recv) eq 'ARRAY';\n    for my $i (reverse 0 .. $#$recv) { return $recv->[$i] if $pred->($recv->[$i]) }\n    return undef;\n}\n\nsub find_last_index ($self, $recv, $pred) {\n    return -1 unless ref($recv) eq 'ARRAY';\n    for my $i (reverse 0 .. $#$recv) { return $i if $pred->($recv->[$i]) }\n    return -1;\n}\n\n# `String.prototype.toLowerCase()` / `.toUpperCase()`. Kolon has a builtin\n# `.join` array method (so the adapter uses that directly) but no builtin\n# `lc` / `uc`, so these live on the runtime object. `CORE::` avoids recursing\n# into these methods.\nsub lc ($self, $s) { return defined $s ? CORE::lc($s) : '' }\nsub uc ($self, $s) { return defined $s ? CORE::uc($s) : '' }\n\n# `Array.prototype.join(sep)` with JS semantics: separator defaults to \",\",\n# and undefined / null elements render as empty (`[1,,2].join(\",\")` \u2192 \"1,,2\").\n# Kolon has a builtin `.join`, but routing through the runtime keeps the\n# JS-compat element handling in one place. `CORE::join` avoids recursing.\nsub join ($self, $recv, $sep = undef) {\n    return '' unless ref($recv) eq 'ARRAY';\n    $sep //= ',';\n    return CORE::join($sep, map { defined $_ ? $_ : '' } @$recv);\n}\n\n# `.length` \u2014 JS works on BOTH arrays (element count) and strings (character\n# count); Kolon's builtin `.size()` is array-only and faults on a string. So\n# dispatch on ref type here. `CORE::length` avoids recursing into this method.\nsub length ($self, $recv) {\n    return scalar @$recv if ref($recv) eq 'ARRAY';\n    return 0 if ref($recv);\n    return CORE::length($recv // '');\n}\n\n# `Array.prototype.indexOf(x)` / `Array.prototype.lastIndexOf(x)`\n# value-equality search (#1448 Tier A). Returns the 0-based position\n# of the first / last matching element, or -1 if not found.\n# Non-array receivers return -1 \u2014 matches the JS semantic that\n# `.indexOf` / `.lastIndexOf` are only defined on Array / TypedArray.\n# (The string-position `indexOf` form isn't in Tier A; if it lands\n# later the helper can grow a ref()-dispatch branch like `includes`.)\n\nsub _array_index_of ($recv, $elem, $reverse) {\n    return -1 unless ref($recv) eq 'ARRAY';\n    my @indices = $reverse ? (reverse 0 .. $#{$recv}) : (0 .. $#{$recv});\n    for my $i (@indices) {\n        my $item = $recv->[$i];\n        if (!defined $item) {\n            return $i if !defined $elem;\n            next;\n        }\n        return $i if defined $elem && $item eq $elem;\n    }\n    return -1;\n}\n\nsub index_of ($self, $recv, $elem) {\n    return _array_index_of($recv, $elem, 0);\n}\n\nsub last_index_of ($self, $recv, $elem) {\n    return _array_index_of($recv, $elem, 1);\n}\n\n# `Array.prototype.at(i)` \u2014 supports negative indices (`.at(-1)` is\n# the last element); out-of-bounds returns undef (which Mojo's\n# auto-escape renders as the empty string, matching JS's `undefined`).\n# Non-array receivers return undef. Matches the Go `bf_at` arithmetic\n# (`length + i` for i < 0) so adapter output stays symmetric.\n\nsub at ($self, $recv, $i) {\n    return undef unless ref($recv) eq 'ARRAY';\n    return undef if !defined $i;\n    my $len = scalar @$recv;\n    return undef if $len == 0;\n    my $idx = $i < 0 ? $len + $i : $i;\n    return undef if $idx < 0 || $idx >= $len;\n    return $recv->[$idx];\n}\n\n# `Array.prototype.concat(other)` \u2014 merges two arrays in order\n# into a new ARRAY ref. Non-array operands collapse to empty\n# (matches the Go `bf_concat` semantic so cross-adapter output\n# stays symmetric; differs from JS where a non-Array argument\n# with `Symbol.isConcatSpreadable` would be spread, a behaviour\n# the template-language path never observes).\n\nsub concat ($self, $a, $b) {\n    my @out;\n    push @out, @$a if ref($a) eq 'ARRAY';\n    push @out, @$b if ref($b) eq 'ARRAY';\n    return \\@out;\n}\n\n# `Array.prototype.slice(start, end?)` \u2014 carves out a sub-range\n# into a new ARRAY ref. Mirrors the Go `bf_slice` arithmetic so\n# adapter output stays symmetric:\n#   - start < 0          \u2192 length + start  (e.g. -1 = last index)\n#   - end < 0            \u2192 length + end\n#   - start < 0 after clamp \u2192 0\n#   - end > length       \u2192 length\n#   - start >= end       \u2192 empty\n#   - end undef          \u2192 \"to length\"\n# Non-array receivers return an empty ARRAY ref.\n\nsub slice ($self, $recv, $start, $end) {\n    return [] unless ref($recv) eq 'ARRAY';\n    my $len = scalar @$recv;\n    return [] if $len == 0;\n\n    my $s = $start // 0;\n    $s = $len + $s if $s < 0;\n    $s = 0    if $s < 0;\n    $s = $len if $s > $len;\n\n    my $e = defined $end ? $end : $len;\n    $e = $len + $e if $e < 0;\n    $e = 0    if $e < 0;\n    $e = $len if $e > $len;\n\n    return [] if $s >= $e;\n    return [ @{$recv}[$s .. $e - 1] ];\n}\n\n# `Array.prototype.reverse()` / `Array.prototype.toReversed()` \u2014\n# both shapes share this lowering. SSR templates render a snapshot\n# of state, so JS's mutate-receiver (`reverse`) vs\n# return-new-array (`toReversed`) distinction has no template-\n# level meaning. Always returns a new ARRAY ref to keep callers\n# safe from accidental aliasing. Non-array receivers return an\n# empty ARRAY ref.\n\nsub reverse ($self, $recv) {\n    return [] unless ref($recv) eq 'ARRAY';\n    return [ reverse @$recv ];\n}\n\n# `Array.prototype.flat(depth?)` (#1448 Tier C) \u2014 flatten nested ARRAY\n# refs `$depth` levels deep. A `$depth` of -1 is the `Infinity` sentinel\n# (flatten fully); 0 returns a shallow copy. Non-ARRAY elements are kept\n# as-is (JS only flattens nested arrays). Non-ARRAY receiver \u2192 [].\nsub flat ($self, $recv, $depth = 1) {\n    return [] unless ref($recv) eq 'ARRAY';\n    my @out;\n    for my $el (@$recv) {\n        if ($depth != 0 && ref($el) eq 'ARRAY') {\n            my $next = $depth > 0 ? $depth - 1 : $depth;\n            push @out, @{ $self->flat($el, $next) };\n        }\n        else {\n            push @out, $el;\n        }\n    }\n    return \\@out;\n}\n\n# `Array.prototype.flatMap(fn)` value-returning field projection\n# (#1448 Tier C) \u2014 map each element through a self / field projection,\n# then flatten one level. `field` reads a HASH-ref key (the raw JS prop\n# name, as `bf->reduce` does); a projected non-ARRAY value is kept as-is\n# (flatMap = map + flat(1)). Non-ARRAY receiver \u2192 [].\nsub flat_map ($self, $recv, $key_kind, $key) {\n    return [] unless ref($recv) eq 'ARRAY';\n    my @projected;\n    for my $el (@$recv) {\n        if ($key_kind eq 'field') {\n            # JS `i => i.field` on a non-object yields `undefined`, not the\n            # element itself \u2014 push `undef` so a scalar element doesn't leak\n            # into the output (matches Go's `getFieldValue` returning nil).\n            push @projected, ref($el) eq 'HASH' ? $el->{$key} : undef;\n        }\n        else {\n            push @projected, $el;\n        }\n    }\n    return $self->flat(\\@projected, 1);\n}\n\n# `Array.prototype.flatMap(i => [i.a, i.b])` \u2014 array-literal tuple\n# projection (#1448 Tier C). Each `@specs` entry is a [kind, key] arrayref\n# (['self', ''] or ['field', 'a']). For each element, every leaf's value\n# is appended in order. flat(1) removes only the literal wrapper, so an\n# array-valued leaf is appended verbatim (no spread) \u2014 i.e. just append\n# each leaf. A non-HASH element under a `field` leaf yields undef (JS\n# `i.field` on a non-object). Non-ARRAY receiver \u2192 [].\nsub flat_map_tuple ($self, $recv, @specs) {\n    return [] unless ref($recv) eq 'ARRAY';\n    my @out;\n    for my $el (@$recv) {\n        for my $spec (@specs) {\n            my ($kind, $key) = @$spec;\n            if ($kind eq 'field') {\n                push @out, ref($el) eq 'HASH' ? $el->{$key} : undef;\n            }\n            else {\n                push @out, $el;\n            }\n        }\n    }\n    return \\@out;\n}\n\n# `String.prototype.trim()` \u2014 strip leading + trailing whitespace.\n# JS's `String.prototype.trim` matches `\\s` in the Unicode sense\n# (any whitespace including non-breaking space U+00A0); Perl's `\\s`\n# inside a regex with `/u` flag is the same. Undef receivers return\n# the empty string (matches JS's `String(undefined).trim()` which\n# would be \"undefined\" \u2192 \"undefined\", but in our template context\n# undef commonly means \"missing prop\"; rendering the empty string\n# is the safer choice and mirrors the JS-compat divergence we\n# already document for `bf->string(undef) === \"\"`).\n\nsub trim ($self, $recv) {\n    return '' unless defined $recv;\n    return '' if ref($recv);\n    my $s = \"$recv\";\n    $s =~ s/^\\s+|\\s+$//gu;\n    return $s;\n}\n\n# `String.prototype.split(sep)` (#1448 Tier B) \u2014 string \u2192 ARRAY ref.\n#\n# Two JS-parity wrinkles drive the helper (a bare `split` emit would\n# diverge from both JS and Go):\n#\n#   * Perl's `split` treats its first argument as a *regex*, so a\n#     separator like '.' or '|' would match far too much. We\n#     `quotemeta` it to force literal-string matching, mirroring JS's\n#     string-separator semantics (the regex-separator form stays\n#     refused upstream \u2014 see the parser arm).\n#   * Perl's `split` drops trailing empty fields by default; JS keeps\n#     them (`\"a,\".split(\",\")` is `[\"a\", \"\"]`). Passing the `-1` limit\n#     preserves them, matching JS and Go's `strings.Split`.\n#\n# An empty separator splits into individual characters (JS + Go agree).\n# Undef receiver renders as the single-element `['']` \u2014 the same\n# \"missing prop \u2192 empty string\" convention `bf->trim` uses.\n\nsub split ($self, $recv, $sep = undef, $limit = undef) {\n    my $s = defined $recv && !ref($recv) ? \"$recv\" : '';\n\n    my @parts;\n    if (!defined $sep) {\n        # No separator \u2192 the whole string in a single-element array\n        # (matches JS `\"x\".split()` / `.split(undefined)`).\n        @parts = ($s);\n    }\n    elsif (\"$sep\" eq '') {\n        # Empty separator \u2192 individual characters. No `-1` limit here:\n        # on an empty pattern Perl's `split` with `-1` appends a spurious\n        # trailing empty field (\"abc\" \u2192 'a','b','c',''), which JS/Go don't.\n        @parts = split //, $s;\n    }\n    elsif ($s eq '') {\n        # Empty input with a non-empty separator: JS `\"\".split(\",\")` is\n        # `[\"\"]` and Go's `strings.Split(\"\", \",\")` is `[\"\"]`, but Perl's\n        # `split /,/, ''` returns the empty list \u2014 special-case for parity.\n        @parts = ('');\n    }\n    else {\n        # `quotemeta` forces literal-string matching (JS string-separator\n        # semantics); the `-1` keeps trailing empty fields (JS keeps them,\n        # Perl's bare `split` drops them).\n        my $q = quotemeta(\"$sep\");\n        @parts = split /$q/, $s, -1;\n    }\n\n    # Optional `limit` caps the number of pieces (JS `split(sep, limit)`).\n    # 0 \u2192 empty; a negative limit keeps all (JS ToUint32 wrap makes it\n    # effectively unbounded) \u2014 both match Go's `bf_split`.\n    if (defined $limit) {\n        my $n = int($limit);\n        if ($n == 0) { @parts = () }\n        elsif ($n > 0 && $n < scalar @parts) { @parts = @parts[0 .. $n - 1] }\n    }\n\n    return [@parts];\n}\n\n# `String.prototype.startsWith(prefix, position?)` (#1448 Tier B) \u2014\n# string \u2192 boolean (1 / 0). `substr`-anchored literal comparison mirrors\n# Go's `strings.HasPrefix`. An empty prefix is always true (JS parity);\n# undef / non-string receivers coerce to the empty string first. The\n# optional `position` re-anchors the test (clamped to `[0, length]`),\n# matching JS `\"abc\".startsWith(\"b\", 1)`.\n\nsub starts_with ($self, $recv, $prefix, $position = undef) {\n    my $s = defined $recv && !ref($recv) ? \"$recv\" : '';\n    my $p = defined $prefix ? \"$prefix\" : '';\n    if (defined $position) {\n        my $n = int($position);\n        $n = 0 if $n < 0;\n        $n = CORE::length($s) if $n > CORE::length($s);\n        $s = substr($s, $n);\n    }\n    return substr($s, 0, CORE::length $p) eq $p ? 1 : 0;\n}\n\n# `String.prototype.endsWith(suffix, endPosition?)` (#1448 Tier B) \u2014\n# string \u2192 boolean (1 / 0). Mirrors Go's `strings.HasSuffix`. An empty\n# suffix is always true (JS parity); a suffix longer than the string is\n# false. `substr($s, -length $x)` would mis-read the whole string when\n# `length $x == 0`, so that case short-circuits. The optional\n# `endPosition` treats the string as if it were only that many chars\n# long (clamped to `[0, length]`), matching JS `\"abc\".endsWith(\"b\", 2)`.\n\nsub ends_with ($self, $recv, $suffix, $end_position = undef) {\n    my $s = defined $recv && !ref($recv) ? \"$recv\" : '';\n    my $x = defined $suffix ? \"$suffix\" : '';\n    if (defined $end_position) {\n        my $e = int($end_position);\n        $e = 0 if $e < 0;\n        $e = CORE::length($s) if $e > CORE::length($s);\n        $s = substr($s, 0, $e);\n    }\n    return 1 if $x eq '';\n    return 0 if CORE::length($s) < CORE::length($x);\n    return substr($s, -CORE::length $x) eq $x ? 1 : 0;\n}\n\n# `String.prototype.replace(pattern, replacement)` \u2014 string-pattern\n# form only (#1448 Tier B), replacing the FIRST occurrence (JS string-\n# pattern semantics). Spliced via index/substr rather than `s///` so\n# BOTH the pattern and the replacement are literal: no Perl regex\n# metacharacters in the pattern and no `$1` / `$&` interpolation in the\n# replacement. Go's `bf_replace` (strings.Replace, n=1) treats the\n# replacement literally too, so the two adapters stay byte-equal \u2014 this\n# diverges from JS only for replacement strings containing `$`-patterns\n# (rare in template position). An empty pattern inserts the replacement\n# at the front (`\"abc\".replace(\"\", \"X\")` \u2192 \"Xabc\"), matching JS + Go.\n\nsub replace ($self, $recv, $pattern, $replacement) {\n    my $s = defined $recv && !ref($recv) ? \"$recv\" : '';\n    my $o = defined $pattern ? \"$pattern\" : '';\n    my $n = defined $replacement ? \"$replacement\" : '';\n    return $n . $s if $o eq '';\n    my $i = index($s, $o);\n    return $s if $i < 0;\n    return substr($s, 0, $i) . $n . substr($s, $i + CORE::length($o));\n}\n\n# `String.prototype.repeat(n)` \u2014 the receiver concatenated n times\n# (#1448 Tier B), via Perl's `x` operator. JS throws RangeError for a\n# negative count, but SSR templates degrade to the empty string rather\n# than dying mid-render, so a count <= 0 returns \"\" (Go's `bf_repeat`\n# applies the same clamp). The count is truncated toward zero\n# (`int`), matching JS's ToIntegerOrInfinity on `\"a\".repeat(3.7)`.\n\nsub repeat ($self, $recv, $count) {\n    my $s = defined $recv && !ref($recv) ? \"$recv\" : '';\n    my $n = defined $count ? int($count) : 0;\n    return $n <= 0 ? '' : $s x $n;\n}\n\n# `String.prototype.padStart` / `padEnd` (#1448 Tier B) \u2014 pad the\n# receiver to `$target` characters with `$pad` (default a single space)\n# repeated and truncated to fill, prepended or appended. Length is\n# measured in characters (Perl `length`), matching Go's rune-based\n# `bf_pad_*` \u2014 diverges from JS's UTF-16-unit length only for\n# astral-plane input. An empty pad, or a receiver already >= `$target`,\n# returns the receiver unchanged (JS parity). The `$target` is\n# truncated toward zero (JS ToLength on the first arg).\n\nsub _pad ($s, $target, $pad, $at_start) {\n    $pad = ' ' unless defined $pad;\n    $pad = \"$pad\";\n    return $s if $pad eq '';\n    my $len = CORE::length $s;\n    my $t   = int($target // 0);\n    return $s if $len >= $t;\n    my $need = $t - $len;\n    # Repeat enough copies to cover $need, then trim to exactly $need.\n    my $fill = substr($pad x (int($need / CORE::length($pad)) + 1), 0, $need);\n    return $at_start ? $fill . $s : $s . $fill;\n}\n\nsub pad_start ($self, $recv, $target, $pad = undef) {\n    my $s = defined $recv && !ref($recv) ? \"$recv\" : '';\n    return _pad($s, $target, $pad, 1);\n}\n\nsub pad_end ($self, $recv, $target, $pad = undef) {\n    my $s = defined $recv && !ref($recv) ? \"$recv\" : '';\n    return _pad($s, $target, $pad, 0);\n}\n\n# `Array.prototype.sort(cmp)` / `Array.prototype.toSorted(cmp)`\n# lowering (#1448 Tier B). Non-mutating \u2014 JS's mutate-vs-new\n# distinction is moot in SSR template context.\n#\n# Opts hash-ref. The compiler emits a `keys` list of per-key hashes\n# in priority order; each hash carries:\n#\n#   key_kind     => 'self' | 'field'\n#   key          => '' when key_kind eq 'self'; field name verbatim\n#                   from the comparator AST (e.g. 'price', 'createdAt')\n#                   when key_kind eq 'field' \u2014 no case normalisation\n#                   applied. Perl hash lookups are case-sensitive so\n#                   the key here must match the actual hash key the\n#                   user populated.\n#   compare_type => 'numeric' | 'string' | 'auto'\n#   direction    => 'asc' | 'desc'\n#\n# Accepted comparator catalogue (gated upstream at parse time \u2014\n# anything outside refuses with BF101 before reaching this helper):\n#\n#   (a,b) => a.f - b.f                       \u2192 field, numeric\n#   (a,b) => a - b                           \u2192 self,  numeric\n#   (a,b) => a[.f].localeCompare(b[.f])      \u2192 field|self, string\n#   (a,b) => a.f > b.f ? 1 : -1              \u2192 field|self, auto\n#   any of the above ||-chained              \u2192 multi-key tie-breaks\n#   (and reversed-operand variants for `desc`).\n#\n# `auto` (relational-ternary lowering) compares numerically when both\n# keys `looks_like_number`, else lexically \u2014 Go's `bf_sort` applies the\n# same rule so the two template adapters stay byte-equal.\n#\n# A future `nulls => 'first' | 'last'` knob can land per key without\n# churn \u2014 the opts hash is the right place to grow.\n\nsub sort ($self, $recv, $opts = {}) {\n    return [] unless ref($recv) eq 'ARRAY';\n\n    # Normalise the per-key specs (priority order, length >= 1).\n    my @spec = map {\n        {\n            key_kind     => $_->{key_kind}     // 'self',\n            key          => $_->{key}          // '',\n            compare_type => $_->{compare_type} // 'numeric',\n            direction    => $_->{direction}    // 'asc',\n        }\n    } @{ $opts->{keys} // [] };\n    return [ @$recv ] unless @spec;\n\n    # Schwartzian transform: project each item to all its sort keys\n    # once, then compare projected keys. Cheaper than re-resolving the\n    # field accessors inside every comparison for non-trivial arrays.\n    my @keyed = map {\n        my $item = $_;\n        my @ks = map {\n            $_->{key_kind} eq 'field' && ref($item) eq 'HASH' ? $item->{ $_->{key} } : $item;\n        } @spec;\n        [ \\@ks, $item ];\n    } @$recv;\n\n    my $cmp = sub {\n        for my $i (0 .. $#spec) {\n            my $sp = $spec[$i];\n            my $c  = _compare_sort_key($a->[0][$i], $b->[0][$i], $sp->{compare_type});\n            next if $c == 0;            # tie on this key \u2014 try the next\n            return $sp->{direction} eq 'desc' ? -$c : $c;\n        }\n        return 0;\n    };\n\n    my @sorted = sort $cmp @keyed;\n    return [ map { $_->[1] } @sorted ];\n}\n\n# Compare two projected keys, ascending orientation (-1 / 0 / 1); the\n# caller negates for 'desc'. 'auto' compares numerically when both\n# keys look like numbers, else lexically (matches Go's `bf_sort`).\n# undef coalesces to '' / 0 so the order stays total without warnings.\nsub _compare_sort_key ($av, $bv, $compare_type) {\n    if ($compare_type eq 'string') {\n        return ($av // '') cmp ($bv // '');\n    }\n    if ($compare_type eq 'auto') {\n        if (looks_like_number($av // '') && looks_like_number($bv // '')) {\n            return ($av // 0) <=> ($bv // 0);\n        }\n        return ($av // '') cmp ($bv // '');\n    }\n    return ($av // 0) <=> ($bv // 0);    # numeric\n}\n\n# Fold an array into a scalar via the arithmetic-fold catalogue\n# (#1448 Tier C). Mirrors Go's `bf_reduce` and JS `reduce(fn, init)` /\n# `reduceRight(fn, init)` for the shapes `(acc, x) => acc <op> x` /\n# `(acc, x) => acc <op> x.field`:\n#\n#   bf->reduce($recv, {\n#     op        => '+' | '*',\n#     key_kind  => 'self' | 'field',\n#     key       => '<field>',         # when key_kind eq 'field'\n#     type      => 'numeric' | 'string',\n#     init      => <seed>,            # number, or string for concat\n#     direction => 'left' | 'right',  # 'right' = reduceRight (default 'left')\n#   })\n#\n# Numeric folds accumulate with `+` / `*` (non-numeric keys coalesce to\n# 0); string folds concatenate via `bf->string` (undef \u2192 ''). The init\n# seeds the accumulator, so an empty array returns it unchanged \u2014 exactly\n# like JS. `direction => 'right'` folds right-to-left (reduceRight); only\n# observable for string concat, since numeric sum / product commute.\n# Float stringification can diverge from Go's for inexact binary\n# fractions (e.g. 0.1 + 0.2); integer sums \u2014 the common case \u2014 agree.\nsub reduce ($self, $recv, $opts = {}) {\n    my $op        = $opts->{op}        // '+';\n    my $key_kind  = $opts->{key_kind}  // 'self';\n    my $key       = $opts->{key}       // '';\n    my $type      = $opts->{type}      // 'numeric';\n    my $direction = $opts->{direction} // 'left';\n\n    my @items = ref($recv) eq 'ARRAY' ? @$recv : ();\n    # reduceRight folds right-to-left; reversing the snapshot keeps the\n    # single forward loop below. Only observable for string concat \u2014\n    # numeric sum / product commute. Qualify as CORE::reverse \u2014 this\n    # package defines `sub reverse` (the `.reverse()` helper), so a bare\n    # `reverse` is ambiguous under `use warnings`.\n    @items = CORE::reverse(@items) if $direction eq 'right';\n    my $project = sub ($item) {\n        $key_kind eq 'field' && ref($item) eq 'HASH' ? $item->{$key} : $item;\n    };\n\n    if ($type eq 'string') {\n        my $acc = $opts->{init} // '';\n        $acc .= $self->string($project->($_)) for @items;\n        return $acc;\n    }\n\n    my $acc = $opts->{init} // 0;\n    for my $item (@items) {\n        my $n = $project->($item);\n        # Guard `defined` before `looks_like_number` so a missing field\n        # (undef) folds as 0 without an \"uninitialized value\" warning\n        # under `use warnings` \u2014 matching the `$av // ''` style `sort` uses.\n        $n = 0 unless defined $n && looks_like_number($n);\n        $op eq '*' ? ($acc *= $n) : ($acc += $n);\n    }\n    return $acc;\n}\n\n# ---------------------------------------------------------------------------\n# JSX intrinsic-element spread (#1407)\n# ---------------------------------------------------------------------------\n#\n# Mirrors the JS `spreadAttrs` runtime\n# (`packages/client/src/runtime/spread-attrs.ts`) and the Go adapter's\n# `bf.SpreadAttrs` so SSR output stays byte-equal across the three\n# adapters. Generated Mojo templates invoke this as\n# `<%== bf->spread_attrs($bag) %>`.\n#\n# Skip rules: nil/false values, event handlers (`on[A-Z]\u2026` shape\n# matching JS `key[2] === key[2].toUpperCase()` \u2014 true for any\n# character whose uppercase is itself, including digits and\n# underscore), `children`. `ref` is intentionally NOT filtered,\n# matching the JS reference.\n#\n# Key remap: className \u2192 class, htmlFor \u2192 for; SVG camelCase\n# attrs preserved (case-sensitive XML spec); other camelCase keys\n# lowered to kebab-case with a leading `-` for an initial\n# uppercase letter (mirrors JS `key.replace(/([A-Z])/g, '-$1')`).\n#\n# `style` is routed through `_style_to_css` so object literals\n# serialise to a real CSS string instead of Perl's default\n# `HASH(0x...)` form.\n#\n# Output is deterministic: keys are sorted alphabetically before\n# emission, matching the Go adapter's `sort.Strings(keys)` policy\n# and Mojo::JSON's marshal order.\n#\n# The return value is a Mojo::ByteStream so the calling template's\n# `<%==` raw-emit skips re-escaping (the helper has already\n# HTML-escaped each value).\n\nmy %SVG_CAMEL_CASE_ATTRS = map { $_ => 1 } qw(\n    allowReorder attributeName attributeType autoReverse\n    baseFrequency baseProfile calcMode clipPathUnits\n    contentScriptType contentStyleType diffuseConstant edgeMode\n    externalResourcesRequired filterRes filterUnits glyphRef\n    gradientTransform gradientUnits kernelMatrix kernelUnitLength\n    keyPoints keySplines keyTimes lengthAdjust limitingConeAngle\n    markerHeight markerUnits markerWidth maskContentUnits\n    maskUnits numOctaves pathLength patternContentUnits\n    patternTransform patternUnits pointsAtX pointsAtY pointsAtZ\n    preserveAlpha preserveAspectRatio primitiveUnits refX refY\n    repeatCount repeatDur requiredExtensions requiredFeatures\n    specularConstant specularExponent spreadMethod startOffset\n    stdDeviation stitchTiles surfaceScale systemLanguage\n    tableValues targetX targetY textLength viewBox viewTarget\n    xChannelSelector yChannelSelector zoomAndPan\n);\n\nsub _to_attr_name ($key) {\n    return 'class' if $key eq 'className';\n    return 'for'   if $key eq 'htmlFor';\n    return $key    if $SVG_CAMEL_CASE_ATTRS{$key};\n    # camelCase \u2192 kebab-case, with a leading `-` for an initial\n    # uppercase letter (JS-reference parity, even though that case\n    # produces an HTML-invalid attribute name \u2014 same documented\n    # behaviour as the Go adapter's `toAttrName`).\n    my $out = $key;\n    $out =~ s/([A-Z])/-\\L$1/g;\n    return $out;\n}\n\nsub _html_escape ($value) {\n    # HTML attribute-value escape for SSR string emission. The\n    # spread bag's values reach the browser as part of a generated\n    # `key=\"...\"` substring inside the rendered HTML, so the\n    # escape set has to cover everything that could break either\n    # the surrounding double-quoted attribute or the enclosing\n    # tag: `&`, `<`, `>`, `\"`, and `'`. Matches Go's\n    # `template.HTMLEscapeString` semantics byte-for-byte (using\n    # `&#34;` / `&#39;` for quotes rather than the named entities)\n    # so the SSR output is identical across the Go and Mojo\n    # adapters (#1407, #1413 review). The CSR-side\n    # `applyRestAttrs` calls `el.setAttribute(name, String(value))`\n    # \u2014 which does its own DOM-level escaping in the browser \u2014\n    # so JS doesn't need an explicit escape pass; Perl/Go emit a\n    # string, so we do.\n    my $s = defined $value ? \"$value\" : '';\n    $s =~ s/&/&amp;/g;\n    $s =~ s/</&lt;/g;\n    $s =~ s/>/&gt;/g;\n    $s =~ s/\"/&#34;/g;\n    $s =~ s/'/&#39;/g;\n    return $s;\n}\n\nsub _style_to_css ($value) {\n    return undef unless defined $value;\n    # Non-hashref values pass through stringified \u2014 matches the JS\n    # `typeof value !== 'object'` branch in `styleToCss`.\n    if (ref($value) ne 'HASH') {\n        my $s = \"$value\";\n        return CORE::length $s ? $s : undef;\n    }\n    my @parts;\n    for my $key (sort keys %$value) {\n        my $v = $value->{$key};\n        next unless defined $v;\n        my $prop = $key;\n        $prop =~ s/([A-Z])/-\\L$1/g;\n        push @parts, \"$prop:$v\";\n    }\n    return @parts ? CORE::join(';', @parts) : undef;\n}\n\nsub spread_attrs ($self, $bag) {\n    return '' unless defined $bag && ref($bag) eq 'HASH';\n    my @parts;\n    for my $key (sort keys %$bag) {\n        # Event handlers: skip when key starts `on` and the third\n        # character is its own uppercase form (uppercase letter,\n        # digit, underscore, \u2026). Mirrors the JS predicate.\n        if (CORE::length($key) > 2 && substr($key, 0, 2) eq 'on') {\n            my $c = substr($key, 2, 1);\n            next if CORE::uc($c) eq $c;\n        }\n        next if $key eq 'children';\n        my $val = $bag->{$key};\n        # null / undef \u2192 drop.\n        next unless defined $val;\n        # Boolean values arrive as Mojo::JSON sentinel objects\n        # (`Mojo::JSON::true` / `false`) \u2014 both from JSON-deserialised\n        # props and from the test harness's `toPerlLiteral`\n        # (which emits the sentinels rather than plain 0/1 to avoid\n        # conflating booleans with numeric attribute values like\n        # `tabindex=\"0\"`). The contract is: callers MUST use the\n        # sentinels for boolean values; plain Perl scalars 0/1\n        # render as numeric attribute values, matching how JS\n        # `spreadAttrs` treats a `0`/`1` JS number.\n        if (ref($val) eq 'JSON::PP::Boolean' || ref($val) eq 'Mojo::JSON::_Bool') {\n            next unless $val;\n            push @parts, _to_attr_name($key);\n            next;\n        }\n        # `style` routes through `_style_to_css` so object literals\n        # serialise to a real CSS string.\n        if ($key eq 'style') {\n            my $css = _style_to_css($val);\n            next unless defined $css && CORE::length $css;\n            push @parts, qq{style=\"} . _html_escape($css) . qq{\"};\n            next;\n        }\n        my $name = _to_attr_name($key);\n        push @parts, $name . qq{=\"} . _html_escape($val) . qq{\"};\n    }\n    return '' unless @parts;\n    # Mark the result raw so the calling template's `<%==` raw-emit\n    # doesn't re-escape the already-escaped values (the Mojo backend\n    # returns a Mojo::ByteStream).\n    return $self->backend->mark_raw(CORE::join(' ', @parts));\n}\n\n1;\n__END__\n\n=encoding utf8\n\n=head1 NAME\n\nBarefootJS - Engine- and framework-agnostic server runtime for BarefootJS marked templates\n\n=head1 SYNOPSIS\n\n    use BarefootJS;\n\n    # A host injects a rendering backend (see BarefootJS::Backend::Xslate or\n    # Mojolicious::Plugin::BarefootJS for shipping backends).\n    my $bf = BarefootJS->new($context, { backend => $backend });\n\n    # The compiled marked template calls the runtime as a `bf` object:\n    #   <: $bf.scope_attr() :>  <: $bf.json($data) :>  <: $bf.spread_attrs($h) :>\n\n=head1 DESCRIPTION\n\nBarefootJS compiles JSX/TSX into a marked template plus client JS. This module\nis the server-side runtime the marked templates call into at render time. It is\ndeliberately template-engine- and web-framework-agnostic: every operation that\ndepends on I<how> a template is rendered \u2014 JSON marshalling, raw-string marking,\nJSX-children materialisation, and named-template rendering \u2014 is delegated to a\npluggable C<backend>.\n\nThat design lets the one runtime drive any backend. Shipping backends:\n\n=over 4\n\n=item * L<BarefootJS::Backend::Xslate> \u2014 Text::Xslate (Kolon); runs under any PSGI/Plack app.\n\n=item * L<BarefootJS::Backend::Mojo> \u2014 Mojolicious (via L<Mojolicious::Plugin::BarefootJS>).\n\n=back\n\nThe core itself pulls in only core Perl modules (C<POSIX>, C<Scalar::Util>);\nno template engine or web framework is loaded unless a backend that needs one\nis used.\n\n=head1 SEE ALSO\n\nL<BarefootJS::Backend::Xslate>, L<Mojolicious::Plugin::BarefootJS>,\nL<https://github.com/piconic-ai/barefootjs>\n\n=head1 AUTHOR\n\nkobaken E<lt>kentafly88@gmail.comE<gt>\n\n=head1 LICENSE\n\nCopyright (c) 2025-present BarefootJS Contributors.\n\nThis library is free software; you can redistribute it and/or modify it under\nthe MIT License. See the F<LICENSE> file in the distribution for the full text.\n\n=cut\n";
+    barefootBackendMojoPmSource = "package BarefootJS::Backend::Mojo;\nour $VERSION = \"0.8.0\";\nuse Mojo::Base -base, -signatures;\n\nuse Mojo::ByteStream qw(b);\nuse Mojo::JSON qw(to_json);\nuse Scalar::Util qw(weaken);\n\n# ---------------------------------------------------------------------------\n# Reference rendering backend (Mojolicious / Mojo::Template).\n# ---------------------------------------------------------------------------\n#\n# BarefootJS.pm holds all the template-engine-agnostic logic (the JS-compat\n# value helpers, array/string methods, hydration markers). Everything that is\n# specific to *how a template is rendered* \u2014 JSON marshalling, raw-string\n# marking, JSX-children materialisation, and named-template rendering \u2014 lives\n# behind this backend object so the same runtime can drive a different Perl\n# template engine (Text::Xslate, Template Toolkit, \u2026) without rewriting the\n# helper surface.\n#\n# A backend MUST implement:\n#   - encode_json($data)            -> string\n#   - mark_raw($str)                -> value the engine emits without escaping\n#   - materialize($value)           -> string (resolve a captured-children ref)\n#   - render_named($name, $bf, \\%vars) -> string\n#\n# This Mojo implementation is the reference. To target another engine, write a\n# sibling backend (BarefootJS::Backend::Xslate, \u2026) implementing the same four\n# methods and pass it via `BarefootJS->new($c, { backend => $b })`.\n\n# The Mojolicious controller. Optional: the value-marshalling helpers\n# (`encode_json` / `mark_raw` / `materialize`) work without it; only\n# `render_named` reaches into the controller's renderer + stash.\nhas 'c';\n\n# Pluggable JSON encoder (#engine-abstraction). Defaults to\n# `Mojo::JSON::to_json`, which returns a *character* string (not bytes)\n# suitable for embedding in HTML output via `<%==` / Mojo::ByteStream.\n#\n# Override with any `sub ($data) { ... }` to swap in a faster XS encoder \u2014\n# e.g. `json_encoder => sub { Cpanel::JSON::XS->new->canonical->encode($_[0]) }`.\n# The pure-Perl JSON::PP fallback Mojo::JSON uses can be a hot spot for large\n# props payloads; the seam lets a host pick its own implementation without\n# touching the runtime.\nhas 'json_encoder' => sub { \\&to_json };\n\n# Hold the controller weakly for the same reason BarefootJS does: the\n# controller owns the bf instance (which owns this backend) via its stash,\n# so a strong back-reference would close a per-request cycle the refcount GC\n# can't reclaim. `render_named` only touches `$self->c` mid-render, while the\n# controller is still alive on the request stack.\nsub new ($class, %args) {\n    my $self = $class->SUPER::new(%args);\n    weaken($self->{c}) if $self->{c};\n    return $self;\n}\n\nsub encode_json ($self, $data) {\n    return $self->json_encoder->($data);\n}\n\n# Mark a string as already-safe so the template engine emits it verbatim\n# (no re-escaping). In Mojo this is a Mojo::ByteStream, which the calling\n# template's `<%==` raw-emit passes through unescaped.\nsub mark_raw ($self, $str) {\n    return b($str);\n}\n\n# JSX children / async fallbacks arrive via Mojo's `begin %>...<% end`\n# capture, which produces a CODE ref returning a Mojo::ByteStream. Resolve\n# it to a string before embedding. Plain (already-rendered) strings pass\n# through unchanged.\nsub materialize ($self, $value) {\n    return ref($value) eq 'CODE' ? $value->() : $value;\n}\n\n# Render a named template with `$child_bf` bound as the active runtime\n# instance for that render. The Mojo `bf` helper resolves the current\n# instance off `$c->stash->{'bf.instance'}`; swap it for the duration of\n# the nested render and restore it afterwards so sibling renders are\n# unaffected.\nsub render_named ($self, $template_name, $child_bf, $vars) {\n    my $c = $self->c;\n    my $prev = $c->stash->{'bf.instance'};\n    $c->stash->{'bf.instance'} = $child_bf;\n    my $html = $c->render_to_string(template => $template_name, %$vars);\n    $c->stash->{'bf.instance'} = $prev;\n    return $html;\n}\n\n1;\n";
+    barefootPluginPmSource = "package Mojolicious::Plugin::BarefootJS;\nour $VERSION = \"0.8.0\";\nuse Mojo::Base 'Mojolicious::Plugin', -signatures;\n\nuse Mojo::File qw(path);\nuse Mojo::JSON qw(decode_json);\n\nuse BarefootJS;\n\n# Plugin entry point. Wires up:\n#\n#   1. The `bf` controller helper. Lazily instantiates one\n#      BarefootJS object per request and stashes it under\n#      `bf.instance`.\n#\n#   2. A `before_render` hook that, when the rendered template name\n#      matches a top-level component in the build manifest, fills the\n#      heavy boilerplate the user previously hand-rolled in `app.pl`:\n#      generates the scope id, registers every UI-registry child\n#      renderer from the manifest, and seeds the stash with each\n#      template variable's static default (issue #1416).\n#\n# Configuration (all optional):\n#   - manifest_path: absolute path to the `bf build`-emitted\n#     `manifest.json`. Defaults to `<app->home>/dist/templates/manifest.json`.\n#     Pass `undef` to disable manifest-driven auto-init entirely; the\n#     bf helper is still installed and callers can drive everything\n#     manually as before.\nsub register ($self, $app, $config = {}) {\n    $app->helper(bf => sub ($c) {\n        $c->stash->{'bf.instance'} //= BarefootJS->new($c, $config);\n    });\n\n    my $manifest = _load_manifest($app, $config);\n    return unless $manifest;\n\n    # Cache the set of UI-registry slot keys so we can answer\n    # \"is this template name a child or a top-level page?\" with a\n    # single hash lookup at render time. Top-level entries are\n    # everything that isn't `__barefoot__` and doesn't match\n    # `ui/<name>/index` \u2014 the same partition `register_components_from_manifest`\n    # applies internally.\n    my %is_child_entry;\n    for my $entry_name (keys %$manifest) {\n        next if $entry_name eq '__barefoot__';\n        next unless $entry_name =~ m{^ui/[^/]+/index$};\n        $is_child_entry{$entry_name} = 1;\n    }\n\n    $app->hook(before_render => sub ($c, $args) {\n        my $template = $args->{template};\n        return unless defined $template && length $template;\n        my $entry = $manifest->{$template};\n        return unless $entry;\n        return if $is_child_entry{$template};\n        # Idempotency guard for nested renders. A controller might\n        # call `render_to_string` inside an action and then `render`\n        # \u2014 without this we'd re-init `bf` on the second pass and\n        # wipe the script registrations the first pass collected.\n        return if $c->stash->{'bf.auto_init_done'};\n\n        # Escape hatch for callers that wire `bf` up by hand (the\n        # existing `render_component` helper in the showcase app does\n        # this). If `_scope_id` is already set we treat the request as\n        # \"manually managed\" and leave it alone \u2014 same outcome as\n        # before the plugin gained auto-init.\n        my $bf = $c->bf;\n        if (defined $bf->_scope_id && length $bf->_scope_id) {\n            $c->stash->{'bf.auto_init_done'} = 1;\n            return;\n        }\n        $c->stash->{'bf.auto_init_done'} = 1;\n\n        $bf->_scope_id($template . '_' . substr(rand() =~ s/^0\\.//r, 0, 6));\n        $bf->register_components_from_manifest($manifest);\n\n        # Seed each ssrDefault into the stash unless the caller has\n        # already supplied a value for that key \u2014 callers always win.\n        my $defaults = $entry->{ssrDefaults};\n        if (ref($defaults) eq 'HASH') {\n            for my $name (keys %$defaults) {\n                next if exists $c->stash->{$name};\n                my $d = $defaults->{$name};\n                my $value = ref($d) eq 'HASH' ? $d->{value} : $d;\n                $c->stash->{$name} = $value;\n            }\n        }\n    });\n}\n\nsub _load_manifest ($app, $config) {\n    return undef if exists $config->{manifest_path} && !defined $config->{manifest_path};\n    my $manifest_path = $config->{manifest_path}\n        // $app->home->child('dist/templates/manifest.json');\n    my $file = path($manifest_path);\n    return undef unless -r $file;\n    my $manifest = eval { decode_json($file->slurp) };\n    if ($@ || ref($manifest) ne 'HASH') {\n        $app->log->warn(\"BarefootJS: cannot parse manifest at $file: $@\") if $@;\n        return undef;\n    }\n    return $manifest;\n}\n\n1;\n__END__\n\n=encoding utf8\n\n=head1 NAME\n\nMojolicious::Plugin::BarefootJS - Mojolicious integration for BarefootJS\n\n=head1 SYNOPSIS\n\n    # Mojolicious application\n    $self->plugin('BarefootJS');\n\n    # In a controller / template, the `bf` helper exposes a per-request\n    # BarefootJS runtime backed by BarefootJS::Backend::Mojo.\n\n=head1 DESCRIPTION\n\nWires the L<BarefootJS> server runtime into L<Mojolicious>. It registers a\nC<bf> controller helper that lazily instantiates one BarefootJS object per\nrequest (rendering via L<BarefootJS::Backend::Mojo>), and supports rendering\ncompiled marked templates as Mojolicious templates.\n\nFor non-Mojolicious / PSGI hosts, see L<BarefootJS::Backend::Xslate>, which\ndrives the same runtime with Text::Xslate and no web framework.\n\n=head1 METHODS\n\nL<Mojolicious::Plugin::BarefootJS> inherits all methods from\nL<Mojolicious::Plugin> and implements the following new one.\n\n=head2 register\n\n    $plugin->register(Mojolicious->new, \\%conf);\n\nRegisters the plugin (the C<bf> helper and supporting hooks) in a Mojolicious\napplication.\n\n=head1 SEE ALSO\n\nL<BarefootJS>, L<BarefootJS::Backend::Mojo>, L<BarefootJS::Backend::Xslate>,\nL<Mojolicious>, L<https://github.com/piconic-ai/barefootjs>\n\n=head1 AUTHOR\n\nkobaken E<lt>kentafly88@gmail.comE<gt>\n\n=head1 LICENSE\n\nCopyright (c) 2025-present BarefootJS Contributors.\n\nThis library is free software; you can redistribute it and/or modify it under\nthe MIT License. See the F<LICENSE> file in the distribution for the full text.\n\n=cut\n";
     barefootDevReloadPmSource = `package Mojolicious::Plugin::BarefootJS::DevReload;
-our $VERSION = "0.01";
+our $VERSION = "0.8.0";
 use Mojo::Base 'Mojolicious::Plugin', -signatures;
 
 =head1 NAME
@@ -24626,7 +24921,7 @@ export default app
     HONO_RENDERER_TSX = `import { jsxRenderer } from 'hono/jsx-renderer'
 import { BfImportMap } from '@barefootjs/hono/app'
 import { BfScripts } from '@barefootjs/hono/scripts'
-import manifest from './public/components/manifest.json'
+import manifest from './public/components/manifest.json' with { type: 'json' }
 
 declare module 'hono' {
   interface ContextRenderer {
@@ -24897,7 +25192,7 @@ import { BfImportMap, BfDevReload } from '@barefootjs/hono/app'
 import { BfScripts } from '@barefootjs/hono/scripts'
 import { readFileSync } from 'node:fs'
 import { resolve } from 'node:path'
-import staticManifest from './dist/components/manifest.json'
+import staticManifest from './dist/components/manifest.json' with { type: 'json' }
 import { isDev } from './env'
 
 declare module 'hono' {
@@ -25588,8 +25883,8 @@ var init_exports = {};
 __export(init_exports, {
   run: () => run4
 });
-import { existsSync as existsSync8, mkdirSync as mkdirSync3, writeFileSync as writeFileSync3 } from "fs";
-import path10 from "path";
+import { existsSync as existsSync8, mkdirSync as mkdirSync3, writeFileSync as writeFileSync3 } from "node:fs";
+import path10 from "node:path";
 function parseFlags(args2) {
   const flags = {};
   for (let i = 0; i < args2.length; i++) {
@@ -25828,8 +26123,8 @@ var init_init = __esm({
 });
 
 // src/lib/resolve-source.ts
-import { existsSync as existsSync9, readdirSync as readdirSync3 } from "fs";
-import path11 from "path";
+import { existsSync as existsSync9, readdirSync as readdirSync3 } from "node:fs";
+import path11 from "node:path";
 function tryCandidate(candidate, searched) {
   searched.push(candidate);
   return existsSync9(candidate) ? candidate : null;
@@ -25915,8 +26210,8 @@ var init_resolve_source = __esm({
 });
 
 // src/lib/meta-loader.ts
-import { readFileSync as readFileSync5, existsSync as existsSync10, readdirSync as readdirSync4 } from "fs";
-import path12 from "path";
+import { readFileSync as readFileSync5, existsSync as existsSync10, readdirSync as readdirSync4 } from "node:fs";
+import path12 from "node:path";
 function loadIndex(metaDir) {
   const indexPath = path12.join(metaDir, "index.json");
   if (!existsSync10(indexPath)) {
@@ -26039,7 +26334,7 @@ __export(search_exports, {
   run: () => run5,
   search: () => search
 });
-import path13 from "path";
+import path13 from "node:path";
 function search(query, index, source, coreDocs) {
   const q = query.toLowerCase();
   const aliasCategories = categoryAliases[q] || [];
@@ -26184,7 +26479,7 @@ var docs_exports = {};
 __export(docs_exports, {
   run: () => run6
 });
-import path14 from "path";
+import path14 from "node:path";
 function printComponent(meta, jsonFlag2, banner) {
   if (jsonFlag2) {
     console.log(JSON.stringify(meta, null, 2));
@@ -26304,8 +26599,8 @@ var guide_exports = {};
 __export(guide_exports, {
   run: () => run7
 });
-import path15 from "path";
-import { existsSync as existsSync11 } from "fs";
+import path15 from "node:path";
+import { existsSync as existsSync11 } from "node:fs";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 function findDocsDir(ctx2) {
   const monorepoDocs = path15.join(ctx2.root, "docs/core");
@@ -27239,8 +27534,8 @@ var preview_exports = {};
 __export(preview_exports, {
   run: () => run8
 });
-import { existsSync as existsSync17, readdirSync as readdirSync5, watch as fsWatch } from "fs";
-import path16 from "path";
+import { existsSync as existsSync17, readdirSync as readdirSync5, watch as fsWatch } from "node:fs";
+import path16 from "node:path";
 function parseArgs(args2) {
   const out = { serve: false, watch: false, help: false, port: DEFAULT_PORT };
   for (let i = 0; i < args2.length; i++) {
@@ -27402,8 +27697,8 @@ __export(tokens_apply_exports, {
   resolveTokensCss: () => resolveTokensCss,
   run: () => run9
 });
-import { existsSync as existsSync18, readFileSync as readFileSync7, writeFileSync as writeFileSync5 } from "fs";
-import path17 from "path";
+import { existsSync as existsSync18, readFileSync as readFileSync7, writeFileSync as writeFileSync5 } from "node:fs";
+import path17 from "node:path";
 async function run9(args2, ctx2) {
   const url = args2[0];
   if (!url) {
@@ -27718,8 +28013,8 @@ var init_tokens2 = __esm({
 });
 
 // src/lib/scaffold.ts
-import { readFileSync as readFileSync8, existsSync as existsSync19 } from "fs";
-import path18 from "path";
+import { readFileSync as readFileSync8, existsSync as existsSync19 } from "node:fs";
+import path18 from "node:path";
 function loadMeta(metaDir, name) {
   const filePath = path18.join(metaDir, `${name}.json`);
   if (!existsSync19(filePath)) return null;
@@ -27874,8 +28169,8 @@ var gen_component_exports = {};
 __export(gen_component_exports, {
   run: () => run11
 });
-import { writeFileSync as writeFileSync6, mkdirSync as mkdirSync4, existsSync as existsSync20 } from "fs";
-import path19 from "path";
+import { writeFileSync as writeFileSync6, mkdirSync as mkdirSync4, existsSync as existsSync20 } from "node:fs";
+import path19 from "node:path";
 function run11(args2, ctx2) {
   if (args2.length < 1) {
     console.error("Usage: bf gen component <component-name> [use-component1] [use-component2] ...");
@@ -28139,8 +28434,8 @@ var init_parse_component = __esm({
 });
 
 // src/lib/test-template.ts
-import { readFileSync as readFileSync9 } from "fs";
-import path20 from "path";
+import { readFileSync as readFileSync9 } from "node:fs";
+import path20 from "node:path";
 function generateTestTemplate(componentPath, options = {}) {
   const importSource = options.importSource ?? "bun:test";
   const source = readFileSync9(componentPath, "utf-8");
@@ -28389,8 +28684,8 @@ var gen_test_exports = {};
 __export(gen_test_exports, {
   run: () => run12
 });
-import { existsSync as existsSync21, writeFileSync as writeFileSync7 } from "fs";
-import path21 from "path";
+import { existsSync as existsSync21, writeFileSync as writeFileSync7 } from "node:fs";
+import path21 from "node:path";
 function run12(args2, ctx2) {
   const positional = args2.filter((a) => !a.startsWith("-"));
   const flagSet = new Set(args2.filter((a) => a.startsWith("-")));
@@ -28444,8 +28739,8 @@ var gen_preview_exports = {};
 __export(gen_preview_exports, {
   run: () => run13
 });
-import { existsSync as existsSync22, writeFileSync as writeFileSync8, mkdirSync as mkdirSync5 } from "fs";
-import path22 from "path";
+import { existsSync as existsSync22, writeFileSync as writeFileSync8, mkdirSync as mkdirSync5 } from "node:fs";
+import path22 from "node:path";
 async function run13(args2, ctx2) {
   const force = args2.includes("--force");
   const name = args2.find((a) => !a.startsWith("--"));
@@ -28483,7 +28778,8 @@ var debug_graph_exports = {};
 __export(debug_graph_exports, {
   run: () => run14
 });
-import { readFileSync as readFileSync10 } from "fs";
+import { readFileSync as readFileSync10 } from "node:fs";
+import "node:path";
 async function run14(args2, ctx2) {
   const componentName = args2[0];
   if (!componentName) {
@@ -28520,7 +28816,7 @@ var debug_trace_exports = {};
 __export(debug_trace_exports, {
   run: () => run15
 });
-import { readFileSync as readFileSync11 } from "fs";
+import { readFileSync as readFileSync11 } from "node:fs";
 async function run15(args2, ctx2) {
   const componentName = args2[0];
   const targetName = args2[1];
@@ -28540,8 +28836,8 @@ async function run15(args2, ctx2) {
   }
   const source = readFileSync11(resolved.filePath, "utf-8");
   const graph = buildComponentGraph2(source, resolved.filePath, resolved.componentName);
-  const path23 = traceUpdatePath2(graph, targetName);
-  if (!path23) {
+  const path24 = traceUpdatePath2(graph, targetName);
+  if (!path24) {
     console.error(`Error: Signal or memo "${targetName}" not found in ${graph.componentName}.`);
     const available = [
       ...graph.signals.map((s) => s.name),
@@ -28553,9 +28849,9 @@ async function run15(args2, ctx2) {
     process.exit(1);
   }
   if (ctx2.jsonFlag) {
-    console.log(JSON.stringify(path23, null, 2));
+    console.log(JSON.stringify(path24, null, 2));
   } else {
-    console.log(formatUpdatePath2(path23));
+    console.log(formatUpdatePath2(path24));
   }
 }
 var init_debug_trace = __esm({
@@ -28570,7 +28866,7 @@ var debug_fallbacks_exports = {};
 __export(debug_fallbacks_exports, {
   run: () => run16
 });
-import { readFileSync as readFileSync12 } from "fs";
+import { readFileSync as readFileSync12 } from "node:fs";
 async function run16(args2, ctx2) {
   const componentName = args2[0];
   if (!componentName) {
@@ -28629,7 +28925,7 @@ var debug_signals_exports = {};
 __export(debug_signals_exports, {
   run: () => run17
 });
-import { readFileSync as readFileSync13 } from "fs";
+import { readFileSync as readFileSync13 } from "node:fs";
 async function run17(args2, ctx2) {
   const componentName = args2[0];
   if (!componentName) {
@@ -28669,7 +28965,7 @@ var debug_events_exports = {};
 __export(debug_events_exports, {
   run: () => run18
 });
-import { readFileSync as readFileSync14 } from "fs";
+import { readFileSync as readFileSync14 } from "node:fs";
 async function run18(args2, ctx2) {
   const componentName = args2[0];
   if (!componentName) {
@@ -28706,7 +29002,7 @@ var debug_loops_exports = {};
 __export(debug_loops_exports, {
   run: () => run19
 });
-import { readFileSync as readFileSync15 } from "fs";
+import { readFileSync as readFileSync15 } from "node:fs";
 async function run19(args2, ctx2) {
   const componentName = args2[0];
   if (!componentName) {
@@ -28743,7 +29039,7 @@ var debug_why_update_exports = {};
 __export(debug_why_update_exports, {
   run: () => run20
 });
-import { readFileSync as readFileSync16 } from "fs";
+import { readFileSync as readFileSync16 } from "node:fs";
 async function run20(args2, ctx2) {
   const componentName = args2[0];
   const bindingLabel = args2[1];
@@ -28801,7 +29097,7 @@ var debug_summary_exports = {};
 __export(debug_summary_exports, {
   run: () => run21
 });
-import { readFileSync as readFileSync17 } from "fs";
+import { readFileSync as readFileSync17 } from "node:fs";
 async function run21(args2, ctx2) {
   const componentName = args2[0];
   if (!componentName) {
@@ -28834,8 +29130,8 @@ var init_debug_summary = __esm({
 });
 
 // src/context.ts
-import { existsSync as existsSync2 } from "fs";
-import path from "path";
+import { existsSync as existsSync2 } from "node:fs";
+import path from "node:path";
 import { fileURLToPath } from "node:url";
 
 // src/config.ts
@@ -28852,9 +29148,9 @@ function findProjectConfig(startDir) {
   let dir = path.resolve(startDir);
   const { root: fsRoot } = path.parse(dir);
   while (true) {
-    const ts21 = path.join(dir, "barefoot.config.ts");
-    if (existsSync2(ts21)) {
-      return { dir, tsConfigPath: ts21 };
+    const ts22 = path.join(dir, "barefoot.config.ts");
+    if (existsSync2(ts22)) {
+      return { dir, tsConfigPath: ts22 };
     }
     if (dir === fsRoot) return null;
     dir = path.dirname(dir);