@barefootjs/xslate 0.9.2 → 0.9.3

package/dist/adapter/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * Text::Xslate (Kolon) Template Adapter Exports
  */
-export { XslateAdapter, xslateAdapter } from './xslate-adapter';
-export type { XslateAdapterOptions } from './xslate-adapter';
+export { XslateAdapter, xslateAdapter } from './xslate-adapter.ts';
+export type { XslateAdapterOptions } from './xslate-adapter.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/adapter/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapter/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAC/D,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapter/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAClE,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/adapter/index.js

@@ -187299,7 +187299,10 @@ import {
   emitAttrValue,
   augmentInheritedPropAccesses,
   parseRecordIndexAccess,
-  evalStringArrayJoin
+  evalStringArrayJoin,
+  extractArrowBodyExpression,
+  collectContextConsumers,
+  extractSsrDefaults
 } from "@barefootjs/jsx";
 
 // src/adapter/boolean-result.ts
@@ -187379,6 +187382,36 @@ function resolveJsxChildrenProp(props) {
     return [];
   return prop.value.children;
 }
+function collectRootScopeNodes(node) {
+  const out = new Set;
+  const visit = (n) => {
+    if (!n)
+      return;
+    if (n.type === "element") {
+      out.add(n);
+      return;
+    }
+    if (n.type === "if-statement") {
+      const s = n;
+      visit(s.consequent);
+      visit(s.alternate);
+      return;
+    }
+    if (n.type === "fragment") {
+      for (const c of n.children)
+        visit(c);
+    }
+  };
+  visit(node);
+  return out;
+}
+function referencedVarsAreAvailable(expr, available) {
+  for (const m of expr.matchAll(/\$([A-Za-z_]\w*)/g)) {
+    if (!available.has(m[1]))
+      return false;
+  }
+  return true;
+}
 
 class XslateAdapter extends BaseAdapter {
   name = "xslate";
@@ -187387,6 +187420,7 @@ class XslateAdapter extends BaseAdapter {
   importMapInjection = "html-snippet";
   templatePrimitives = XSLATE_PRIMITIVE_EMIT_MAP;
   componentName = "";
+  rootScopeNodes = new Set;
   options;
   errors = [];
   inLoop = false;
@@ -187426,9 +187460,12 @@ class XslateAdapter extends BaseAdapter {
     if (!options?.siblingTemplatesRegistered) {
       this.checkImportedLoopChildComponents(ir);
     }
+    this.rootScopeNodes = collectRootScopeNodes(ir.root);
     const templateBody = ir.root.type === "if-statement" ? this.renderIfStatement(ir.root) : this.renderNode(ir.root);
     const scriptReg = options?.skipScriptRegistration ? "" : this.generateScriptRegistrations(ir, options?.scriptBaseName);
-    const template = `${scriptReg}${templateBody}
+    const ctxSeed = this.generateContextConsumerSeed(ir);
+    const memoSeed = this.generateDerivedMemoSeed(ir);
+    const template = `${scriptReg}${ctxSeed}${memoSeed}${templateBody}
 `;
     if (this.errors.length > 0) {
       ir.errors.push(...this.errors);
@@ -187493,7 +187530,84 @@ class XslateAdapter extends BaseAdapter {
     return this.renderIfStatement(node);
   }
   emitProvider(node, _ctx, _emit) {
-    return this.renderChildren(node.children);
+    const value = this.providerValueKolon(node.valueProp);
+    const children = this.renderChildren(node.children);
+    const name = node.contextName;
+    return `<: $bf.provide_context('${name}', ${value}) :>` + children + `<: $bf.revoke_context('${name}') :>`;
+  }
+  providerValueKolon(valueProp) {
+    const v = valueProp.value;
+    if (v.kind === "literal") {
+      return typeof v.value === "string" ? `'${v.value.replace(/[\\']/g, (m) => `\\${m}`)}'` : String(v.value);
+    }
+    if (v.kind === "expression")
+      return this.convertExpressionToKolon(v.expr);
+    if (v.kind === "template")
+      return this.convertTemplateLiteralPartsToKolon(v.parts);
+    return "nil";
+  }
+  contextDefaultKolon(c) {
+    const d = c.defaultValue;
+    if (d === null || d === undefined)
+      return "nil";
+    if (typeof d === "string")
+      return `'${d.replace(/[\\']/g, (m) => `\\${m}`)}'`;
+    if (typeof d === "boolean")
+      return d ? "1" : "0";
+    return String(d);
+  }
+  generateContextConsumerSeed(ir) {
+    const consumers = collectContextConsumers(ir.metadata);
+    if (consumers.length === 0)
+      return "";
+    return consumers.map((c) => `: my $${c.localName} = $bf.use_context('${c.contextName}', ${this.contextDefaultKolon(c)});`).join(`
+`) + `
+`;
+  }
+  generateDerivedMemoSeed(ir) {
+    const memos = ir.metadata.memos ?? [];
+    const signals = ir.metadata.signals ?? [];
+    if (memos.length === 0 && signals.length === 0)
+      return "";
+    const ssrDefaults = extractSsrDefaults(ir.metadata) ?? {};
+    const available = new Set(ir.metadata.propsParams.map((p) => p.name));
+    const lines = [];
+    for (const signal of signals) {
+      const kolon = this.tryLowerToKolon(signal.initialValue, available);
+      const refsSelf = kolon !== null && new RegExp(`\\$${signal.getter}\\b`).test(kolon);
+      if (kolon !== null && !refsSelf)
+        lines.push(`: my $${signal.getter} = ${kolon};`);
+      available.add(signal.getter);
+    }
+    for (const memo of memos) {
+      const def = ssrDefaults[memo.name];
+      const isNull2 = !def || typeof def === "object" && "value" in def && def.value === null;
+      if (!isNull2) {
+        available.add(memo.name);
+        continue;
+      }
+      const body = extractArrowBodyExpression(memo.computation);
+      if (body === null)
+        continue;
+      const kolon = this.tryLowerToKolon(body, available);
+      if (kolon !== null)
+        lines.push(`: my $${memo.name} = ${kolon};`);
+      available.add(memo.name);
+    }
+    return lines.length > 0 ? lines.join(`
+`) + `
+` : "";
+  }
+  tryLowerToKolon(expr, available) {
+    const trimmed = expr.trim();
+    if (!trimmed)
+      return null;
+    if (!isSupported(parseExpression2(trimmed)).supported)
+      return null;
+    const kolon = this.convertExpressionToKolon(trimmed);
+    if (kolon === "" || !/\$[A-Za-z_]\w*/.test(kolon))
+      return null;
+    return referencedVarsAreAvailable(kolon, available) ? kolon : null;
   }
   emitAsync(node, _ctx, _emit) {
     return this.renderAsync(node);
@@ -187506,6 +187620,9 @@ class XslateAdapter extends BaseAdapter {
     if (element.needsScope) {
       hydrationAttrs += ` ${this.renderScopeMarker("")}`;
     }
+    if (this.rootScopeNodes.has(element) && element.needsScope) {
+      hydrationAttrs += ` <: $bf.data_key_attr() | mark_raw :>`;
+    }
     if (element.slotId) {
       hydrationAttrs += ` ${this.renderSlotMarker(element.slotId)}`;
     }

package/dist/adapter/xslate-adapter.d.ts

@@ -48,6 +48,11 @@ export declare class XslateAdapter extends BaseAdapter implements IRNodeEmitter<
      */
     templatePrimitives: TemplatePrimitiveRegistry;
     private componentName;
+    /** Component root scope element(s) — each carries `data-key` for a keyed loop
+     *  item (set by the child renderer from the JSX `key` prop). A plain element
+     *  root is one node; an `if-statement` (early-return) root contributes the
+     *  top element of every branch. */
+    private rootScopeNodes;
     private options;
     private errors;
     private inLoop;
@@ -110,6 +115,33 @@ export declare class XslateAdapter extends BaseAdapter implements IRNodeEmitter<
     emitSlot(node: IRSlot): string;
     emitIfStatement(node: IRIfStatement, _ctx: XslateRenderCtx, _emit: EmitIRNode<XslateRenderCtx>): string;
     emitProvider(node: IRProvider, _ctx: XslateRenderCtx, _emit: EmitIRNode<XslateRenderCtx>): string;
+    /** Lower a `<Ctx.Provider value>` value prop to a Kolon expression. */
+    private providerValueKolon;
+    /** Kolon literal for a context-consumer's `createContext` default. */
+    private contextDefaultKolon;
+    /**
+     * Emit one `: my $<local> = $bf.use_context(...)` line-statement per
+     * context consumer so the body's bare `$<local>` resolves to the active
+     * provider value (or the `createContext` default). (#1297)
+     */
+    private generateContextConsumerSeed;
+    /**
+     * Seed memos whose SSR default is `null` (not statically evaluable) by
+     * computing them in-template from the already-seeded prop / signal vars
+     * (`createMemo(() => props.value * 10)` → `: my $x = $value * 10;`). Without
+     * this the memo's `$x` renders empty — the reason
+     * `props-reactivity-comparison` was skipped. Only emitted when every var the
+     * lowering references is already in scope. (#1297)
+     */
+    private generateDerivedMemoSeed;
+    /**
+     * Lower a signal init / memo body to Kolon for an in-template SSR seed, or
+     * `null` when it shouldn't be seeded this way: not a supported shape
+     * (`isSupported` pre-check, so object/array literals don't fail the build),
+     * references no in-scope var (a constant — keep ssr-defaults seeding), or
+     * references an out-of-scope binding. (#1297)
+     */
+    private tryLowerToKolon;
     emitAsync(node: IRAsync, _ctx: XslateRenderCtx, _emit: EmitIRNode<XslateRenderCtx>): string;
     renderElement(element: IRElement): string;
     renderExpression(expr: IRExpression): string;

package/dist/adapter/xslate-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"xslate-adapter.d.ts","sourceRoot":"","sources":["../../src/adapter/xslate-adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"xslate-adapter.d.ts","sourceRoot":"","sources":["../../src/adapter/xslate-adapter.ts"],"names":[],"mappings":"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"}

package/dist/build.d.ts

@@ -1,6 +1,6 @@
 import type { BuildOptions } from '@barefootjs/jsx';
-import { XslateAdapter } from './adapter';
-import type { XslateAdapterOptions } from './adapter';
+import { XslateAdapter } from './adapter/index.ts';
+import type { XslateAdapterOptions } from './adapter/index.ts';
 export interface XslateBuildOptions extends BuildOptions {
     /** Adapter-specific options passed to XslateAdapter */
     adapterOptions?: XslateAdapterOptions;

package/dist/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAErD,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACtD,uDAAuD;IACvD,cAAc,CAAC,EAAE,oBAAoB,CAAA;CACtC;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,kBAAuB;IAEzD,OAAO;IACP,KAAK;IACL,UAAU;IACV,MAAM;IACN,MAAM;IACN,WAAW;IACX,SAAS;IACT,iBAAiB;IACjB,aAAa;IACb,mBAAmB;IACnB,YAAY;IAKZ,SAAS;EAEZ"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAE9D,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACtD,uDAAuD;IACvD,cAAc,CAAC,EAAE,oBAAoB,CAAA;CACtC;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,kBAAuB;IAEzD,OAAO;IACP,KAAK;IACL,UAAU;IACV,MAAM;IACN,MAAM;IACN,WAAW;IACX,SAAS;IACT,iBAAiB;IACjB,aAAa;IACb,mBAAmB;IACnB,YAAY;IAKZ,SAAS;EAEZ"}

package/dist/build.js

@@ -187299,7 +187299,10 @@ import {
   emitAttrValue,
   augmentInheritedPropAccesses,
   parseRecordIndexAccess,
-  evalStringArrayJoin
+  evalStringArrayJoin,
+  extractArrowBodyExpression,
+  collectContextConsumers,
+  extractSsrDefaults
 } from "@barefootjs/jsx";
 
 // src/adapter/boolean-result.ts
@@ -187379,6 +187382,36 @@ function resolveJsxChildrenProp(props) {
     return [];
   return prop.value.children;
 }
+function collectRootScopeNodes(node) {
+  const out = new Set;
+  const visit = (n) => {
+    if (!n)
+      return;
+    if (n.type === "element") {
+      out.add(n);
+      return;
+    }
+    if (n.type === "if-statement") {
+      const s = n;
+      visit(s.consequent);
+      visit(s.alternate);
+      return;
+    }
+    if (n.type === "fragment") {
+      for (const c of n.children)
+        visit(c);
+    }
+  };
+  visit(node);
+  return out;
+}
+function referencedVarsAreAvailable(expr, available) {
+  for (const m of expr.matchAll(/\$([A-Za-z_]\w*)/g)) {
+    if (!available.has(m[1]))
+      return false;
+  }
+  return true;
+}
 
 class XslateAdapter extends BaseAdapter {
   name = "xslate";
@@ -187387,6 +187420,7 @@ class XslateAdapter extends BaseAdapter {
   importMapInjection = "html-snippet";
   templatePrimitives = XSLATE_PRIMITIVE_EMIT_MAP;
   componentName = "";
+  rootScopeNodes = new Set;
   options;
   errors = [];
   inLoop = false;
@@ -187426,9 +187460,12 @@ class XslateAdapter extends BaseAdapter {
     if (!options?.siblingTemplatesRegistered) {
       this.checkImportedLoopChildComponents(ir);
     }
+    this.rootScopeNodes = collectRootScopeNodes(ir.root);
     const templateBody = ir.root.type === "if-statement" ? this.renderIfStatement(ir.root) : this.renderNode(ir.root);
     const scriptReg = options?.skipScriptRegistration ? "" : this.generateScriptRegistrations(ir, options?.scriptBaseName);
-    const template = `${scriptReg}${templateBody}
+    const ctxSeed = this.generateContextConsumerSeed(ir);
+    const memoSeed = this.generateDerivedMemoSeed(ir);
+    const template = `${scriptReg}${ctxSeed}${memoSeed}${templateBody}
 `;
     if (this.errors.length > 0) {
       ir.errors.push(...this.errors);
@@ -187493,7 +187530,84 @@ class XslateAdapter extends BaseAdapter {
     return this.renderIfStatement(node);
   }
   emitProvider(node, _ctx, _emit) {
-    return this.renderChildren(node.children);
+    const value = this.providerValueKolon(node.valueProp);
+    const children = this.renderChildren(node.children);
+    const name = node.contextName;
+    return `<: $bf.provide_context('${name}', ${value}) :>` + children + `<: $bf.revoke_context('${name}') :>`;
+  }
+  providerValueKolon(valueProp) {
+    const v = valueProp.value;
+    if (v.kind === "literal") {
+      return typeof v.value === "string" ? `'${v.value.replace(/[\\']/g, (m) => `\\${m}`)}'` : String(v.value);
+    }
+    if (v.kind === "expression")
+      return this.convertExpressionToKolon(v.expr);
+    if (v.kind === "template")
+      return this.convertTemplateLiteralPartsToKolon(v.parts);
+    return "nil";
+  }
+  contextDefaultKolon(c) {
+    const d = c.defaultValue;
+    if (d === null || d === undefined)
+      return "nil";
+    if (typeof d === "string")
+      return `'${d.replace(/[\\']/g, (m) => `\\${m}`)}'`;
+    if (typeof d === "boolean")
+      return d ? "1" : "0";
+    return String(d);
+  }
+  generateContextConsumerSeed(ir) {
+    const consumers = collectContextConsumers(ir.metadata);
+    if (consumers.length === 0)
+      return "";
+    return consumers.map((c) => `: my $${c.localName} = $bf.use_context('${c.contextName}', ${this.contextDefaultKolon(c)});`).join(`
+`) + `
+`;
+  }
+  generateDerivedMemoSeed(ir) {
+    const memos = ir.metadata.memos ?? [];
+    const signals = ir.metadata.signals ?? [];
+    if (memos.length === 0 && signals.length === 0)
+      return "";
+    const ssrDefaults = extractSsrDefaults(ir.metadata) ?? {};
+    const available = new Set(ir.metadata.propsParams.map((p) => p.name));
+    const lines = [];
+    for (const signal of signals) {
+      const kolon = this.tryLowerToKolon(signal.initialValue, available);
+      const refsSelf = kolon !== null && new RegExp(`\\$${signal.getter}\\b`).test(kolon);
+      if (kolon !== null && !refsSelf)
+        lines.push(`: my $${signal.getter} = ${kolon};`);
+      available.add(signal.getter);
+    }
+    for (const memo of memos) {
+      const def = ssrDefaults[memo.name];
+      const isNull2 = !def || typeof def === "object" && "value" in def && def.value === null;
+      if (!isNull2) {
+        available.add(memo.name);
+        continue;
+      }
+      const body = extractArrowBodyExpression(memo.computation);
+      if (body === null)
+        continue;
+      const kolon = this.tryLowerToKolon(body, available);
+      if (kolon !== null)
+        lines.push(`: my $${memo.name} = ${kolon};`);
+      available.add(memo.name);
+    }
+    return lines.length > 0 ? lines.join(`
+`) + `
+` : "";
+  }
+  tryLowerToKolon(expr, available) {
+    const trimmed = expr.trim();
+    if (!trimmed)
+      return null;
+    if (!isSupported(parseExpression2(trimmed)).supported)
+      return null;
+    const kolon = this.convertExpressionToKolon(trimmed);
+    if (kolon === "" || !/\$[A-Za-z_]\w*/.test(kolon))
+      return null;
+    return referencedVarsAreAvailable(kolon, available) ? kolon : null;
   }
   emitAsync(node, _ctx, _emit) {
     return this.renderAsync(node);
@@ -187506,6 +187620,9 @@ class XslateAdapter extends BaseAdapter {
     if (element.needsScope) {
       hydrationAttrs += ` ${this.renderScopeMarker("")}`;
     }
+    if (this.rootScopeNodes.has(element) && element.needsScope) {
+      hydrationAttrs += ` <: $bf.data_key_attr() | mark_raw :>`;
+    }
     if (element.slotId) {
       hydrationAttrs += ` ${this.renderSlotMarker(element.slotId)}`;
     }

package/dist/index.d.ts

@@ -3,6 +3,6 @@
  *
  * Generates Text::Xslate Kolon template files (.tx) from BarefootJS IR.
  */
-export { XslateAdapter, xslateAdapter } from './adapter';
-export type { XslateAdapterOptions } from './adapter';
+export { XslateAdapter, xslateAdapter } from './adapter/index.ts';
+export type { XslateAdapterOptions } from './adapter/index.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACxD,YAAY,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACjE,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/index.js

@@ -187299,7 +187299,10 @@ import {
   emitAttrValue,
   augmentInheritedPropAccesses,
   parseRecordIndexAccess,
-  evalStringArrayJoin
+  evalStringArrayJoin,
+  extractArrowBodyExpression,
+  collectContextConsumers,
+  extractSsrDefaults
 } from "@barefootjs/jsx";
 
 // src/adapter/boolean-result.ts
@@ -187379,6 +187382,36 @@ function resolveJsxChildrenProp(props) {
     return [];
   return prop.value.children;
 }
+function collectRootScopeNodes(node) {
+  const out = new Set;
+  const visit = (n) => {
+    if (!n)
+      return;
+    if (n.type === "element") {
+      out.add(n);
+      return;
+    }
+    if (n.type === "if-statement") {
+      const s = n;
+      visit(s.consequent);
+      visit(s.alternate);
+      return;
+    }
+    if (n.type === "fragment") {
+      for (const c of n.children)
+        visit(c);
+    }
+  };
+  visit(node);
+  return out;
+}
+function referencedVarsAreAvailable(expr, available) {
+  for (const m of expr.matchAll(/\$([A-Za-z_]\w*)/g)) {
+    if (!available.has(m[1]))
+      return false;
+  }
+  return true;
+}
 
 class XslateAdapter extends BaseAdapter {
   name = "xslate";
@@ -187387,6 +187420,7 @@ class XslateAdapter extends BaseAdapter {
   importMapInjection = "html-snippet";
   templatePrimitives = XSLATE_PRIMITIVE_EMIT_MAP;
   componentName = "";
+  rootScopeNodes = new Set;
   options;
   errors = [];
   inLoop = false;
@@ -187426,9 +187460,12 @@ class XslateAdapter extends BaseAdapter {
     if (!options?.siblingTemplatesRegistered) {
       this.checkImportedLoopChildComponents(ir);
     }
+    this.rootScopeNodes = collectRootScopeNodes(ir.root);
     const templateBody = ir.root.type === "if-statement" ? this.renderIfStatement(ir.root) : this.renderNode(ir.root);
     const scriptReg = options?.skipScriptRegistration ? "" : this.generateScriptRegistrations(ir, options?.scriptBaseName);
-    const template = `${scriptReg}${templateBody}
+    const ctxSeed = this.generateContextConsumerSeed(ir);
+    const memoSeed = this.generateDerivedMemoSeed(ir);
+    const template = `${scriptReg}${ctxSeed}${memoSeed}${templateBody}
 `;
     if (this.errors.length > 0) {
       ir.errors.push(...this.errors);
@@ -187493,7 +187530,84 @@ class XslateAdapter extends BaseAdapter {
     return this.renderIfStatement(node);
   }
   emitProvider(node, _ctx, _emit) {
-    return this.renderChildren(node.children);
+    const value = this.providerValueKolon(node.valueProp);
+    const children = this.renderChildren(node.children);
+    const name = node.contextName;
+    return `<: $bf.provide_context('${name}', ${value}) :>` + children + `<: $bf.revoke_context('${name}') :>`;
+  }
+  providerValueKolon(valueProp) {
+    const v = valueProp.value;
+    if (v.kind === "literal") {
+      return typeof v.value === "string" ? `'${v.value.replace(/[\\']/g, (m) => `\\${m}`)}'` : String(v.value);
+    }
+    if (v.kind === "expression")
+      return this.convertExpressionToKolon(v.expr);
+    if (v.kind === "template")
+      return this.convertTemplateLiteralPartsToKolon(v.parts);
+    return "nil";
+  }
+  contextDefaultKolon(c) {
+    const d = c.defaultValue;
+    if (d === null || d === undefined)
+      return "nil";
+    if (typeof d === "string")
+      return `'${d.replace(/[\\']/g, (m) => `\\${m}`)}'`;
+    if (typeof d === "boolean")
+      return d ? "1" : "0";
+    return String(d);
+  }
+  generateContextConsumerSeed(ir) {
+    const consumers = collectContextConsumers(ir.metadata);
+    if (consumers.length === 0)
+      return "";
+    return consumers.map((c) => `: my $${c.localName} = $bf.use_context('${c.contextName}', ${this.contextDefaultKolon(c)});`).join(`
+`) + `
+`;
+  }
+  generateDerivedMemoSeed(ir) {
+    const memos = ir.metadata.memos ?? [];
+    const signals = ir.metadata.signals ?? [];
+    if (memos.length === 0 && signals.length === 0)
+      return "";
+    const ssrDefaults = extractSsrDefaults(ir.metadata) ?? {};
+    const available = new Set(ir.metadata.propsParams.map((p) => p.name));
+    const lines = [];
+    for (const signal of signals) {
+      const kolon = this.tryLowerToKolon(signal.initialValue, available);
+      const refsSelf = kolon !== null && new RegExp(`\\$${signal.getter}\\b`).test(kolon);
+      if (kolon !== null && !refsSelf)
+        lines.push(`: my $${signal.getter} = ${kolon};`);
+      available.add(signal.getter);
+    }
+    for (const memo of memos) {
+      const def = ssrDefaults[memo.name];
+      const isNull2 = !def || typeof def === "object" && "value" in def && def.value === null;
+      if (!isNull2) {
+        available.add(memo.name);
+        continue;
+      }
+      const body = extractArrowBodyExpression(memo.computation);
+      if (body === null)
+        continue;
+      const kolon = this.tryLowerToKolon(body, available);
+      if (kolon !== null)
+        lines.push(`: my $${memo.name} = ${kolon};`);
+      available.add(memo.name);
+    }
+    return lines.length > 0 ? lines.join(`
+`) + `
+` : "";
+  }
+  tryLowerToKolon(expr, available) {
+    const trimmed = expr.trim();
+    if (!trimmed)
+      return null;
+    if (!isSupported(parseExpression2(trimmed)).supported)
+      return null;
+    const kolon = this.convertExpressionToKolon(trimmed);
+    if (kolon === "" || !/\$[A-Za-z_]\w*/.test(kolon))
+      return null;
+    return referencedVarsAreAvailable(kolon, available) ? kolon : null;
   }
   emitAsync(node, _ctx, _emit) {
     return this.renderAsync(node);
@@ -187506,6 +187620,9 @@ class XslateAdapter extends BaseAdapter {
     if (element.needsScope) {
       hydrationAttrs += ` ${this.renderScopeMarker("")}`;
     }
+    if (this.rootScopeNodes.has(element) && element.needsScope) {
+      hydrationAttrs += ` <: $bf.data_key_attr() | mark_raw :>`;
+    }
     if (element.slotId) {
       hydrationAttrs += ` ${this.renderSlotMarker(element.slotId)}`;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@barefootjs/xslate",
-  "version": "0.9.2",
+  "version": "0.9.3",
   "description": "Text::Xslate (Kolon) adapter for BarefootJS — compiles IR to .tx templates and ships the Xslate rendering backend; runs under any PSGI/Plack app",
   "type": "module",
   "main": "./dist/index.js",
@@ -55,14 +55,14 @@
     "directory": "packages/adapter-xslate"
   },
   "dependencies": {
-    "@barefootjs/shared": "0.9.2"
+    "@barefootjs/shared": "0.9.3"
   },
   "peerDependencies": {
     "@barefootjs/jsx": ">=0.2.0"
   },
   "devDependencies": {
     "@barefootjs/adapter-tests": "0.1.0",
-    "@barefootjs/jsx": "0.9.2",
+    "@barefootjs/jsx": "0.9.3",
     "typescript": "^5.0.0"
   }
 }

package/src/__tests__/xslate-adapter.test.ts

@@ -12,56 +12,23 @@
  * genuinely differs. Every divergence carries a one-line rationale.
  */
 
+import { describe, test, expect } from 'bun:test'
 import {
   runAdapterConformanceTests,
   TemplatePrimitiveCaseId,
 } from '@barefootjs/adapter-tests'
 import { XslateAdapter } from '../adapter'
 import { renderXslateComponent, XslateNotAvailableError } from '../test-render'
+import { compileJSX, type ComponentIR } from '@barefootjs/jsx'
 
 runAdapterConformanceTests({
   name: 'xslate',
   factory: () => new XslateAdapter(),
   render: renderXslateComponent,
-  // Skips here are VERIFIED, not inherited from mojo. Notably, the six
-  // fixtures mojo skips for Perl-EP scoping faults — `logical-or-jsx`,
-  // `nullish-coalescing-jsx`, `branch-map`, `return-logical-or`,
-  // `return-nullish-coalescing`, `return-map` (bare `$label` / `$items`
-  // without a `my` binding) — all PASS on Xslate, because Kolon resolves
-  // `$label` from the per-render vars rather than a Perl lexical, so there
-  // is no undefined-symbol fault. Xslate therefore skips strictly fewer
-  // fixtures than mojo. Each entry below was confirmed to fail with
-  // skipJsx emptied.
-  skipJsx: [
-    // SSR context propagation (`<Ctx.Provider value>` → `useContext`): the
-    // template reads a stash key that's never seeded. Implemented on Go; the
-    // Perl stash-seed path is a follow-up port, so Xslate stays skipped (#1297).
-    'context-provider',
-    // `toggle-shared`: the parent maps a `ToggleItemProps[]` prop into
-    // sibling `ToggleItem` children inside a keyed `.map`. Three gaps
-    // remain (same as mojo): the loop-child `on = props.defaultOn ??
-    // false` signal isn't seeded server-side (so every item renders OFF
-    // instead of honouring per-item `defaultOn`), the child scope id is
-    // the snake-case `toggle_item_<rand>` rather than the `ToggleItem_*`
-    // PascalCase the reference pins, and `key=` → `data-key` isn't
-    // emitted. Kolon resolves the unseeded vars to nil rather than
-    // aborting, so this surfaces as a render mismatch (not a hard error).
-    // Separate follow-up.
-    'toggle-shared',
-    // `props-reactivity-comparison` (the `PropsReactivityComparison`
-    // export of `ReactiveProps.tsx`): componentName selection is now
-    // honoured, but the child `PropsStyleChild`'s `displayValue =
-    // props.value * 10` memo has no static SSR default
-    // (`extractSsrDefaults` → `null` for a prop-derived expression) and
-    // the Perl SSR model seeds child memos from static defaults. Kolon
-    // renders the unseeded `$displayValue` as empty, so `child-computed-
-    // value` is blank where Hono / Go emit `10` (Go computes it in a
-    // generated child constructor — the Perl static path has no
-    // equivalent). (Same reason mojo skips.)
-    'props-reactivity-comparison',
-    // (`kbd` is not skipped here — it's a BF101 refusal pinned in
-    // `expectedDiagnostics` below, not a render-mismatch.)
-  ],
+  // No JSX-render skips: every shared conformance fixture renders to Hono
+  // parity on real Text::Xslate. Shapes the adapter intentionally refuses at
+  // build time are pinned in `expectedDiagnostics` below (e.g. `kbd`, `button`).
+  skipJsx: [],
   // Per-fixture build-time contracts for shapes the Xslate adapter
   // intentionally refuses to lower. Mirrors mojo's set — the lowering
   // gates are shared code paths in the ported adapter.
@@ -143,3 +110,131 @@ runAdapterConformanceTests({
     return false
   },
 })
+
+// =============================================================================
+// Helpers
+// =============================================================================
+
+function compileToIR(source: string): ComponentIR {
+  const result = compileJSX(source.trimStart(), 'test.tsx', {
+    adapter: new XslateAdapter(),
+    outputIR: true,
+  })
+  const irFile = result.files.find(f => f.type === 'ir')
+  if (!irFile) throw new Error('No IR output')
+  return JSON.parse(irFile.content) as ComponentIR
+}
+
+function compileAndGenerate(source: string) {
+  return new XslateAdapter().generate(compileToIR(source))
+}
+
+// =============================================================================
+// Xslate-Specific Tests
+// =============================================================================
+
+describe('XslateAdapter - SSR context propagation (#1297)', () => {
+  // `<Ctx.Provider value>` brackets its children with inline provide/revoke
+  // calls (both return '' so the `<: … :>` discards them); descendant
+  // `useContext` consumers read the value during the same render.
+  test('provider brackets children with provide_context / revoke_context', () => {
+    const { template } = compileAndGenerate(`
+'use client'
+import { createContext, useContext } from '@barefootjs/client'
+const ThemeContext = createContext('light')
+export function ThemeRoot() {
+  return <div><ThemeContext.Provider value="dark"><ThemeLabel /></ThemeContext.Provider></div>
+}
+function ThemeLabel() { const theme = useContext(ThemeContext); return <span>{theme}</span> }
+`)
+    expect(template).toContain("$bf.provide_context('ThemeContext', 'dark')")
+    expect(template).toContain("$bf.revoke_context('ThemeContext')")
+    expect(template.indexOf('provide_context')).toBeLessThan(template.indexOf('render_child'))
+    expect(template.indexOf('render_child')).toBeLessThan(template.indexOf('revoke_context'))
+  })
+
+  test('consumer seeds its local from use_context with the createContext default', () => {
+    const { template } = compileAndGenerate(`
+'use client'
+import { createContext, useContext } from '@barefootjs/client'
+const ThemeContext = createContext('light')
+export function ThemeLabel() { const theme = useContext(ThemeContext); return <span>{theme}</span> }
+`)
+    expect(template).toContain(": my $theme = $bf.use_context('ThemeContext', 'light');")
+  })
+})
+
+describe('XslateAdapter - prop-derived memo SSR seeding (#1297)', () => {
+  // A memo whose body can't be statically folded (`props.value * 10`) gets a
+  // `null` SSR default; the adapter computes it in-template from the seeded
+  // prop var so the child renders the value instead of empty.
+  test('seeds a prop-derived memo from the prop var', () => {
+    const { template } = compileAndGenerate(`
+'use client'
+import { createMemo } from '@barefootjs/client'
+export function Child(props: { value: number }) {
+  const displayValue = createMemo(() => props.value * 10)
+  return <span>{displayValue()}</span>
+}
+`)
+    expect(template).toContain(': my $displayValue = $value * 10;')
+  })
+
+  test('seeds a memo over a destructured prop', () => {
+    const { template } = compileAndGenerate(`
+'use client'
+import { createMemo } from '@barefootjs/client'
+export function Child({ value }: { value: number }) {
+  const displayValue = createMemo(() => value * 10)
+  return <span>{displayValue()}</span>
+}
+`)
+    expect(template).toContain(': my $displayValue = $value * 10;')
+  })
+})
+
+describe('XslateAdapter - prop-derived signal SSR seeding + data-key (#1297, toggle-shared)', () => {
+  test('seeds a prop-derived (different-name) signal from the prop var', () => {
+    const { template } = compileAndGenerate(`
+'use client'
+import { createSignal } from '@barefootjs/client'
+export function Item(props: { defaultOn?: boolean }) {
+  const [on, setOn] = createSignal(props.defaultOn ?? false)
+  return <button>{on() ? 'ON' : 'OFF'}</button>
+}
+`)
+    expect(template).toContain(': my $on = ($defaultOn // 0);')
+  })
+
+  // Kolon can't `: my $x = … $x …`; a same-name signal stays on the existing
+  // (harness/manifest) seeding rather than an in-template seed.
+  test('does NOT in-template-seed a same-name signal', () => {
+    const { template } = compileAndGenerate(`
+'use client'
+import { createSignal } from '@barefootjs/client'
+export function C(props: { x?: number }) {
+  const [x, setX] = createSignal(props.x ?? 7)
+  return <span>{x()}</span>
+}
+`)
+    expect(template).not.toContain(': my $x =')
+  })
+
+  test('emits data_key_attr on the component root', () => {
+    const { template } = compileAndGenerate(`
+export function Item() { return <div class="x">hi</div> }
+`)
+    expect(template).toContain('$bf.data_key_attr()')
+  })
+
+  test('emits data_key_attr on each branch root of an if-statement root', () => {
+    const { template } = compileAndGenerate(`
+export function Item({ on }: { on?: boolean }) {
+  if (on) return <div class="a">A</div>
+  return <div class="b">B</div>
+}
+`)
+    const count = (template.match(/\$bf\.data_key_attr\(\)/g) ?? []).length
+    expect(count).toBe(2)
+  })
+})

package/src/__tests__/xslate-counter.test.ts

@@ -96,7 +96,10 @@ my $bf = BarefootJS->new(undef, { backend => $backend });
 $bf->_scope_id('Counter_test');
 
 binmode(STDOUT, ':utf8');
-my \$html = \$backend->render_named('counter', \$bf, { count => 3, doubled => 6 });
+# The count signal is seeded in-template from the prop it derives from (#1297),
+# so the host seeds initial (not the count signal value directly); doubled is a
+# memo with a non-null static default and stays a directly-seeded stash var.
+my \$html = \$backend->render_named('counter', \$bf, { initial => 3, doubled => 6 });
 print \$html;
 # The template's register_script calls populated \$bf's script list during
 # render; emit the resulting <script> tags so the test can assert them.

package/src/adapter/index.ts

@@ -2,5 +2,5 @@
  * Text::Xslate (Kolon) Template Adapter Exports
  */
 
-export { XslateAdapter, xslateAdapter } from './xslate-adapter'
-export type { XslateAdapterOptions } from './xslate-adapter'
+export { XslateAdapter, xslateAdapter } from './xslate-adapter.ts'
+export type { XslateAdapterOptions } from './xslate-adapter.ts'

package/src/adapter/xslate-adapter.ts

@@ -63,8 +63,12 @@ import {
   augmentInheritedPropAccesses,
   parseRecordIndexAccess,
   evalStringArrayJoin,
+  extractArrowBodyExpression,
+  collectContextConsumers,
+  type ContextConsumer,
+  extractSsrDefaults,
 } from '@barefootjs/jsx'
-import { isAriaBooleanAttr, isBooleanResultExpr } from './boolean-result'
+import { isAriaBooleanAttr, isBooleanResultExpr } from './boolean-result.ts'
 import ts from 'typescript'
 
 /**
@@ -139,6 +143,43 @@ function resolveJsxChildrenProp(props: readonly IRProp[]): IRNode[] {
   return prop.value.children
 }
 
+/**
+ * Collect the component's root scope element node(s) — the elements that
+ * become the rendered root and so carry `data-key` for a keyed loop item. A
+ * plain element root is itself; an `if-statement` (early-return) root
+ * contributes the top element of each branch, since exactly one renders at
+ * runtime. (#1297)
+ */
+function collectRootScopeNodes(node: IRNode): Set<IRNode> {
+  const out = new Set<IRNode>()
+  const visit = (n: IRNode | null): void => {
+    if (!n) return
+    if (n.type === 'element') { out.add(n); return }
+    if (n.type === 'if-statement') {
+      const s = n as IRIfStatement
+      visit(s.consequent)
+      visit(s.alternate)
+      return
+    }
+    if (n.type === 'fragment') {
+      for (const c of (n as IRFragment).children) visit(c)
+    }
+  }
+  visit(node)
+  return out
+}
+
+/**
+ * True when every `$var` the lowered Kolon expression references is already in
+ * scope — guards in-template memo seeding against an out-of-scope binding. (#1297)
+ */
+function referencedVarsAreAvailable(expr: string, available: ReadonlySet<string>): boolean {
+  for (const m of expr.matchAll(/\$([A-Za-z_]\w*)/g)) {
+    if (!available.has(m[1])) return false
+  }
+  return true
+}
+
 export interface XslateAdapterOptions {
   /** Base path for client JS files (default: '/static/components/') */
   clientJsBasePath?: string
@@ -164,6 +205,11 @@ export class XslateAdapter extends BaseAdapter implements IRNodeEmitter<XslateRe
   templatePrimitives: TemplatePrimitiveRegistry = XSLATE_PRIMITIVE_EMIT_MAP
 
   private componentName: string = ''
+  /** Component root scope element(s) — each carries `data-key` for a keyed loop
+   *  item (set by the child renderer from the JSX `key` prop). A plain element
+   *  root is one node; an `if-statement` (early-return) root contributes the
+   *  top element of every branch. */
+  private rootScopeNodes: Set<IRNode> = new Set()
   private options: Required<XslateAdapterOptions>
   private errors: CompilerError[] = []
   private inLoop: boolean = false
@@ -267,6 +313,7 @@ export class XslateAdapter extends BaseAdapter implements IRNodeEmitter<XslateRe
       this.checkImportedLoopChildComponents(ir)
     }
 
+    this.rootScopeNodes = collectRootScopeNodes(ir.root)
     const templateBody = ir.root.type === 'if-statement'
       ? this.renderIfStatement(ir.root as IRIfStatement)
       : this.renderNode(ir.root)
@@ -276,7 +323,18 @@ export class XslateAdapter extends BaseAdapter implements IRNodeEmitter<XslateRe
       ? ''
       : this.generateScriptRegistrations(ir, options?.scriptBaseName)
 
-    const template = `${scriptReg}${templateBody}\n`
+    // SSR context consumers (`const x = useContext(Ctx)`): seed each local
+    // from the active provider value (or the `createContext` default). The
+    // provider side pushes the value via `emitProvider`. (#1297)
+    const ctxSeed = this.generateContextConsumerSeed(ir)
+
+    // Prop/signal-derived memos with a `null` static SSR default (e.g.
+    // `createMemo(() => props.value * 10)`) are computed in-template from the
+    // already-seeded prop/signal vars — mirroring Go's generated child
+    // constructor. (#1297)
+    const memoSeed = this.generateDerivedMemoSeed(ir)
+
+    const template = `${scriptReg}${ctxSeed}${memoSeed}${templateBody}\n`
 
     // Merge collected errors into IR errors
     if (this.errors.length > 0) {
@@ -389,7 +447,128 @@ export class XslateAdapter extends BaseAdapter implements IRNodeEmitter<XslateRe
   }
 
   emitProvider(node: IRProvider, _ctx: XslateRenderCtx, _emit: EmitIRNode<XslateRenderCtx>): string {
-    return this.renderChildren(node.children)
+    // SSR context propagation (#1297): bracket the children with a
+    // provide/revoke pair on the shared controller-stash context stack so a
+    // descendant `useContext` consumer reads the value during the same
+    // render. Both helpers return '' (empty), so the inline `<: … :>`
+    // expression form discards their output cleanly — no extra whitespace,
+    // no line-statement needed inside the element body.
+    const value = this.providerValueKolon(node.valueProp)
+    const children = this.renderChildren(node.children)
+    const name = node.contextName
+    return (
+      `<: $bf.provide_context('${name}', ${value}) :>` +
+      children +
+      `<: $bf.revoke_context('${name}') :>`
+    )
+  }
+
+  /** Lower a `<Ctx.Provider value>` value prop to a Kolon expression. */
+  private providerValueKolon(valueProp: IRProvider['valueProp']): string {
+    const v = valueProp.value
+    if (v.kind === 'literal') {
+      return typeof v.value === 'string'
+        ? `'${v.value.replace(/[\\']/g, m => `\\${m}`)}'`
+        : String(v.value)
+    }
+    if (v.kind === 'expression') return this.convertExpressionToKolon(v.expr)
+    if (v.kind === 'template') return this.convertTemplateLiteralPartsToKolon(v.parts)
+    // Out-of-shape value (spread / jsx-children) — nil; consumer defaults.
+    return 'nil'
+  }
+
+  /** Kolon literal for a context-consumer's `createContext` default. */
+  private contextDefaultKolon(c: ContextConsumer): string {
+    const d = c.defaultValue
+    if (d === null || d === undefined) return 'nil'
+    if (typeof d === 'string') return `'${d.replace(/[\\']/g, m => `\\${m}`)}'`
+    if (typeof d === 'boolean') return d ? '1' : '0'
+    return String(d)
+  }
+
+  /**
+   * Emit one `: my $<local> = $bf.use_context(...)` line-statement per
+   * context consumer so the body's bare `$<local>` resolves to the active
+   * provider value (or the `createContext` default). (#1297)
+   */
+  private generateContextConsumerSeed(ir: ComponentIR): string {
+    const consumers = collectContextConsumers(ir.metadata)
+    if (consumers.length === 0) return ''
+    return (
+      consumers
+        .map(
+          c =>
+            `: my $${c.localName} = $bf.use_context('${c.contextName}', ${this.contextDefaultKolon(c)});`,
+        )
+        .join('\n') + '\n'
+    )
+  }
+
+  /**
+   * Seed memos whose SSR default is `null` (not statically evaluable) by
+   * computing them in-template from the already-seeded prop / signal vars
+   * (`createMemo(() => props.value * 10)` → `: my $x = $value * 10;`). Without
+   * this the memo's `$x` renders empty — the reason
+   * `props-reactivity-comparison` was skipped. Only emitted when every var the
+   * lowering references is already in scope. (#1297)
+   */
+  private generateDerivedMemoSeed(ir: ComponentIR): string {
+    const memos = ir.metadata.memos ?? []
+    const signals = ir.metadata.signals ?? []
+    if (memos.length === 0 && signals.length === 0) return ''
+    const ssrDefaults = extractSsrDefaults(ir.metadata) ?? {}
+    // Props seed first; each signal/memo adds its own name as it lands.
+    const available = new Set<string>(ir.metadata.propsParams.map(p => p.name))
+    const lines: string[] = []
+
+    // Prop/signal-derived signals (`createSignal(props.defaultOn ?? false)`):
+    // a loop-child render gets no stash seed, so its `$on` would render nil;
+    // and the static default can't capture the per-call prop. Seed it
+    // in-template when the init lowers cleanly AND references an in-scope var.
+    // Object/array/constant inits keep the existing ssr-defaults seeding.
+    for (const signal of signals) {
+      const kolon = this.tryLowerToKolon(signal.initialValue, available)
+      // Kolon can't express `: my $x = … $x …` — declaring `my $x` makes the
+      // RHS `$x` an undefined lexical rather than the render var. A same-name
+      // signal (`createSignal(props.x ?? d)`, getter == prop) is just the prop
+      // with a default, which the harness already seeds correctly from the
+      // passed prop — skip the in-template seed for it. (Different-name
+      // prop-derived signals like toggle's `on` from `defaultOn` are unaffected.)
+      const refsSelf = kolon !== null && new RegExp(`\\$${signal.getter}\\b`).test(kolon)
+      if (kolon !== null && !refsSelf) lines.push(`: my $${signal.getter} = ${kolon};`)
+      available.add(signal.getter)
+    }
+
+    for (const memo of memos) {
+      const def = ssrDefaults[memo.name]
+      const isNull = !def || (typeof def === 'object' && 'value' in def && def.value === null)
+      if (!isNull) {
+        available.add(memo.name)
+        continue
+      }
+      const body = extractArrowBodyExpression(memo.computation)
+      if (body === null) continue
+      const kolon = this.tryLowerToKolon(body, available)
+      if (kolon !== null) lines.push(`: my $${memo.name} = ${kolon};`)
+      available.add(memo.name)
+    }
+    return lines.length > 0 ? lines.join('\n') + '\n' : ''
+  }
+
+  /**
+   * Lower a signal init / memo body to Kolon for an in-template SSR seed, or
+   * `null` when it shouldn't be seeded this way: not a supported shape
+   * (`isSupported` pre-check, so object/array literals don't fail the build),
+   * references no in-scope var (a constant — keep ssr-defaults seeding), or
+   * references an out-of-scope binding. (#1297)
+   */
+  private tryLowerToKolon(expr: string, available: ReadonlySet<string>): string | null {
+    const trimmed = expr.trim()
+    if (!trimmed) return null
+    if (!isSupported(parseExpression(trimmed)).supported) return null
+    const kolon = this.convertExpressionToKolon(trimmed)
+    if (kolon === '' || !/\$[A-Za-z_]\w*/.test(kolon)) return null
+    return referencedVarsAreAvailable(kolon, available) ? kolon : null
   }
 
   emitAsync(node: IRAsync, _ctx: XslateRenderCtx, _emit: EmitIRNode<XslateRenderCtx>): string {
@@ -409,6 +588,13 @@ export class XslateAdapter extends BaseAdapter implements IRNodeEmitter<XslateRe
     if (element.needsScope) {
       hydrationAttrs += ` ${this.renderScopeMarker('')}`
     }
+    // A root scope element carries `data-key` for a keyed loop item (set on the
+    // bf instance by the child renderer from the JSX `key` prop); non-keyed
+    // renders add nothing. Mirrors Hono stamping data-key on each loop item's
+    // root, including early-return (if-statement) roots. (#1297)
+    if (this.rootScopeNodes.has(element) && element.needsScope) {
+      hydrationAttrs += ` <: $bf.data_key_attr() | mark_raw :>`
+    }
     if (element.slotId) {
       hydrationAttrs += ` ${this.renderSlotMarker(element.slotId)}`
     }
@@ -868,7 +1054,7 @@ export class XslateAdapter extends BaseAdapter implements IRNodeEmitter<XslateRe
     return `<: $children | mark_raw :>`
   }
 
-  renderAsync(node: IRAsync): string {
+  override renderAsync(node: IRAsync): string {
     const fallback = this.renderNode(node.fallback)
     const children = this.renderChildren(node.children)
     // Capture the fallback into a Kolon macro and pass its rendered HTML to

package/src/build.ts

@@ -1,8 +1,8 @@
 // Text::Xslate build config factory for barefoot.config.ts
 
 import type { BuildOptions } from '@barefootjs/jsx'
-import { XslateAdapter } from './adapter'
-import type { XslateAdapterOptions } from './adapter'
+import { XslateAdapter } from './adapter/index.ts'
+import type { XslateAdapterOptions } from './adapter/index.ts'
 
 export interface XslateBuildOptions extends BuildOptions {
   /** Adapter-specific options passed to XslateAdapter */

package/src/index.ts

@@ -4,5 +4,5 @@
  * Generates Text::Xslate Kolon template files (.tx) from BarefootJS IR.
  */
 
-export { XslateAdapter, xslateAdapter } from './adapter'
-export type { XslateAdapterOptions } from './adapter'
+export { XslateAdapter, xslateAdapter } from './adapter/index.ts'
+export type { XslateAdapterOptions } from './adapter/index.ts'

package/src/test-render.ts

@@ -367,7 +367,14 @@ function buildChildRenderers(
     }
     lines.push(`    my $slot_id = delete $child_props->{_bf_slot};`)
     lines.push(`    my $child_bf = BarefootJS->new(undef, { backend => $backend });`)
-    lines.push(`    $child_bf->_scope_id($slot_id ? '${rootChildScopePrefix(snakeName)}' . '_' . $slot_id : '${snakeName}_' . substr(rand() =~ s/^0\\.//r, 0, 6));`)
+    // JSX `key` (reserved prop) → data-key on the child scope root, for keyed
+    // loop reconciliation parity with Hono.
+    lines.push(`    my $data_key = delete $child_props->{key};`)
+    lines.push(`    $child_bf->_data_key($data_key) if defined $data_key;`)
+    // A loop child (no slot) gets a fresh `<ComponentName>_<rand>` id per
+    // iteration — the PascalCase name is what `normalizeHTML` canonicalises to
+    // `<ComponentName>_*`; a slotted child derives from the parent scope.
+    lines.push(`    $child_bf->_scope_id($slot_id ? '${rootChildScopePrefix(snakeName)}' . '_' . $slot_id : '${componentName}_' . substr(rand() =~ s/^0\\.//r, 0, 6));`)
     lines.push(`    $child_bf->_is_child(1);`)
     lines.push(`    if ($slot_id) { $child_bf->_bf_parent('${rootChildScopePrefix(snakeName)}'); $child_bf->_bf_mount($slot_id); }`)
     lines.push(`    $child_bf->_scripts($bf->_scripts);`)