@barefootjs/go-template 0.31.6 → 0.31.7

package/dist/conformance-pins.d.ts

@@ -1,11 +1,10 @@
 /**
- * Per-fixture build-time contracts for shapes the Go template adapter
- * intentionally refuses to lower. Lives here (not on the shared fixtures)
- * so adding a new adapter doesn't require touching any cross-adapter
- * file — every adapter declares its own refusal set against the
- * canonical fixture corpus. Consumed by this package's own conformance
- * test (as `expectedDiagnostics`) and by `bf compat` (issue-URL
- * attribution).
+ * Per-fixture build-time contracts for shapes this adapter intentionally
+ * refuses to lower. Declared per adapter, not on the shared fixtures, so
+ * adding a new adapter never touches a cross-adapter file. Per-fixture
+ * rationale lives on each fixture's docstring
+ * (`packages/adapter-tests/fixtures/<id>.ts`) and spec/callback-fidelity.md;
+ * comments below only mark where this adapter's set diverges from siblings.
  */
 import type { ConformancePins } from '@barefootjs/jsx';
 export declare const conformancePins: ConformancePins;

package/dist/conformance-pins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conformance-pins.d.ts","sourceRoot":"","sources":["../src/conformance-pins.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEtD,eAAO,MAAM,eAAe,EAAE,eAgM7B,CAAA"}
+{"version":3,"file":"conformance-pins.d.ts","sourceRoot":"","sources":["../src/conformance-pins.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEtD,eAAO,MAAM,eAAe,EAAE,eA2C7B,CAAA"}

package/dist/index.js

@@ -6671,7 +6671,8 @@ var conformancePins = {
     { code: "BF101", severity: "error", issue: "https://github.com/piconic-ai/barefootjs/issues/2320" }
   ],
   "filter-nested-find-predicate": [{ code: "BF101", severity: "error", issue: "https://github.com/piconic-ai/barefootjs/issues/2320" }],
-  "date-method-uncatalogued": [{ code: "BF021", severity: "error", issue: "https://github.com/piconic-ai/barefootjs/issues/2356" }]
+  "date-method-uncatalogued": [{ code: "BF021", severity: "error", issue: "https://github.com/piconic-ai/barefootjs/issues/2356" }],
+  "rich-prop-client-read": [{ code: "BF049", severity: "error", issue: "https://github.com/piconic-ai/barefootjs/issues/2648" }]
 };
 // src/render-divergences.ts
 var renderDivergences = {

package/dist/render-divergences.d.ts

@@ -1,29 +1,10 @@
 /**
- * Render-level divergences against the shared conformance corpus
- * (Priority-12 edge-case sweep, #2168): fixtures that COMPILE clean on
- * this adapter but whose rendered output diverges from the Hono
- * reference on real Go — or whose generated Go fails `go run` outright
- * (marked "exit 1" below; those should eventually become loud BF101
- * refusals instead of broken codegen).
- *
- * Consumed by this package's conformance test (its `skipJsx` set is
- * derived from these keys, so the skip list and this declaration can't
- * drift) and by `packages/compat`, which publishes the entries in the
- * fixture-divergences section of `ui/compat.lock.json` — surfaced on
- * the docs compatibility-matrix page. Graduating an entry means fixing
- * the adapter (or the shared compiler layer) and deleting the line.
- *
- * Empty — the file's last live entry (`static-array-from-props-with-
- * component-client`, #2627) graduated: a clientOnly child-component loop
- * whose array is neither a signal/memo nor a direct prop reference (e.g.
- * `Object.entries(props.tags).filter(...)` feeding a `<Tag>` loop) is now
- * excluded entirely from the Input/Props/NewProps codegen instead of
- * colliding with the driving prop's own field — see
- * `GoTemplateAdapter.isOrphanedClientOnlyNested`. The caller-side composite
- * literal for the `tags` prop now type-checks against its own `interface{}`
- * field and `go run`s clean.
- * Keep the file (and this header) when the set is empty — the next
- * divergence lands here, not in a re-created file.
+ * Fixtures that compile clean on this adapter but render divergent from the
+ * Hono reference on real Go. The conformance `skipJsx` set and
+ * `packages/compat`'s published fixture-divergences both derive from this
+ * one object, so the skip list and the declaration can't drift. Keep the
+ * file even when the set is empty — the next divergence lands here, not in
+ * a re-created file.
  */
 import type { RenderDivergences } from '@barefootjs/jsx';
 export declare const renderDivergences: RenderDivergences;

package/dist/render-divergences.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-divergences.d.ts","sourceRoot":"","sources":["../src/render-divergences.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAExD,eAAO,MAAM,iBAAiB,EAAE,iBAiC/B,CAAA"}
+{"version":3,"file":"render-divergences.d.ts","sourceRoot":"","sources":["../src/render-divergences.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAExD,eAAO,MAAM,iBAAiB,EAAE,iBAM/B,CAAA"}

package/dist/vite.js

@@ -2328,6 +2328,7 @@ var ErrorCodes = {
   COMPONENT_REQUIRED_PROP_MISSING: "BF046",
   JSX_BRANCH_LOCAL_IN_CALLBACK: "BF047",
   SIBLING_COMPONENT_NOT_COMPILED: "BF048",
+  RICH_TYPE_PROP_NOT_HYDRATABLE: "BF049",
   SHARED_PROGRAM_REQUIRED: "BF050",
   WRONG_PACKAGE_IMPORT: "BF051",
   BUILTIN_REQUIRES_IMPORT: "BF054",
@@ -2358,6 +2359,7 @@ var errorMessages = {
   [ErrorCodes.COMPONENT_REQUIRED_PROP_MISSING]: "Built-in component is missing a required prop.",
   [ErrorCodes.JSX_BRANCH_LOCAL_IN_CALLBACK]: "JSX-typed local declared inside an `if`-block cannot be referenced from a callback body (ref / event handler). " + "Render it as a child instead: `<div ref={...}>{local}</div>`.",
   [ErrorCodes.SIBLING_COMPONENT_NOT_COMPILED]: "Referenced component did not compile to a template, so this reference would throw " + "`ReferenceError` at render time. Multi-return JSX dispatch (a `switch` or `if`/`else` " + "chain across multiple JSX-returning branches) cannot compile as a component in a " + `'use client' file. Extract it to a separate non-"use client" file (where it is preserved ` + "verbatim, see #932), or rewrite it as a single-return ternary/conditional chain so the " + "component pipeline can compile it.",
+  [ErrorCodes.RICH_TYPE_PROP_NOT_HYDRATABLE]: "Rich-typed prop cannot cross the bf-p hydration boundary as JSON.",
   [ErrorCodes.SHARED_PROGRAM_REQUIRED]: "Shared ts.Program required for type-based reactivity classification. This source imports a Reactive<T>-branded library (e.g. @barefootjs/form) whose getters cannot be classified by regex alone. Pass `options.program` (built via `createProgramForCorpus`) so the analyzer can resolve the brand through the TypeChecker.",
   [ErrorCodes.WRONG_PACKAGE_IMPORT]: "Import from wrong package.",
   [ErrorCodes.BUILTIN_REQUIRES_IMPORT]: "Built-in <Async> / <Region> must be imported from '@barefootjs/client'. " + "The compiler recognises these tags by their import (not by tag name), " + "so an unimported tag with this name is treated as an undeclared component.",
@@ -2391,6 +2393,8 @@ var HOST_RICH_TYPE_NAMES = new Set([
   "BigInt",
   "Function"
 ]);
+var JSON_REVIVABLE_RICH_TYPE_NAMES = new Set(["Date", "URL"]);
+var JSON_UNSAFE_RICH_TYPE_NAMES = new Set([...HOST_RICH_TYPE_NAMES].filter((n) => !JSON_REVIVABLE_RICH_TYPE_NAMES.has(n)));
 function baseTypeName(raw) {
   const idx = raw.indexOf("<");
   return (idx === -1 ? raw : raw.slice(0, idx)).trim();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@barefootjs/go-template",
-  "version": "0.31.6",
+  "version": "0.31.7",
   "description": "Go html/template adapter for BarefootJS - generates Go template files from IR",
   "type": "module",
   "main": "./dist/index.js",
@@ -49,7 +49,7 @@
     "directory": "packages/adapter-go-template"
   },
   "dependencies": {
-    "@barefootjs/shared": "0.31.6"
+    "@barefootjs/shared": "0.31.7"
   },
   "peerDependencies": {
     "@barefootjs/jsx": ">=0.2.0",
@@ -67,9 +67,9 @@
   },
   "devDependencies": {
     "@barefootjs/adapter-tests": "0.1.0",
-    "@barefootjs/client": "0.31.6",
-    "@barefootjs/jsx": "0.31.6",
-    "@barefootjs/vite": "0.31.6",
+    "@barefootjs/client": "0.31.7",
+    "@barefootjs/jsx": "0.31.7",
+    "@barefootjs/vite": "0.31.7",
     "vite": "^6.0.0"
   }
 }

package/src/conformance-pins.ts

@@ -1,87 +1,33 @@
 /**
- * Per-fixture build-time contracts for shapes the Go template adapter
- * intentionally refuses to lower. Lives here (not on the shared fixtures)
- * so adding a new adapter doesn't require touching any cross-adapter
- * file — every adapter declares its own refusal set against the
- * canonical fixture corpus. Consumed by this package's own conformance
- * test (as `expectedDiagnostics`) and by `bf compat` (issue-URL
- * attribution).
+ * Per-fixture build-time contracts for shapes this adapter intentionally
+ * refuses to lower. Declared per adapter, not on the shared fixtures, so
+ * adding a new adapter never touches a cross-adapter file. Per-fixture
+ * rationale lives on each fixture's docstring
+ * (`packages/adapter-tests/fixtures/<id>.ts`) and spec/callback-fidelity.md;
+ * comments below only mark where this adapter's set diverges from siblings.
  */
 
 import type { ConformancePins } from '@barefootjs/jsx'
 
 export const conformancePins: ConformancePins = {
-  // Off-subset filter predicate (`typeof`) the compiler can't lower; a
-  // JS-runtime target runs it, a DSL adapter surfaces BF021 + `/* @client */`.
-  // See spec/callback-fidelity.md.
   'filter-typeof-predicate': [{ code: 'BF021', severity: 'error' }],
-  // Array-builder `.map()` body (imperative `push`-into-array preamble):
-  // BF021, with a verified `/* @client */` escape — `map-array-builder-
-  // body-client` (#2613). See that fixture's docstring.
   'map-array-builder-body': [{ code: 'BF021', severity: 'error' }],
   'map-array-builder-escaping': [{ code: 'BF021', severity: 'error' }],
-  // `.fill(value)` mutates the receiver in place — no template lowering
-  // on any DSL adapter; a JS-runtime target runs it, a DSL adapter
-  // surfaces BF101 + `/* @client */`. See spec/callback-fidelity.md.
   'fill-unsupported': [{ code: 'BF101', severity: 'error' }],
-  // Off-subset `.find()` / `.some()` / `.every()` predicate (`typeof`) the
-  // compiler can't lower; a JS-runtime target runs it, a DSL adapter
-  // surfaces BF101 + `/* @client */`. See spec/callback-fidelity.md.
   'find-typeof-predicate': [{ code: 'BF101', severity: 'error' }],
   'some-typeof-predicate': [{ code: 'BF101', severity: 'error' }],
   'every-typeof-predicate': [{ code: 'BF101', severity: 'error' }],
-  // Off-subset `.reduce()` / `.reduceRight()` body / `.flatMap()`
-  // projection (`typeof`) the compiler can't lower; a JS-runtime target
-  // runs it, a DSL adapter surfaces BF101 + `/* @client */`.
-  // See spec/callback-fidelity.md.
   'reduce-typeof-body': [{ code: 'BF101', severity: 'error' }],
   'reduce-right-typeof-body': [{ code: 'BF101', severity: 'error' }],
   'flatmap-typeof-projection': [{ code: 'BF101', severity: 'error' }],
-  // JSX-returning `.flatMap()` body carried as structured segments — i.e.
-  // one with STATEMENTS (early returns, consts): a JS runtime executes it
-  // verbatim; a DSL template runtime can't, so it refuses with BF021 +
-  // `/* @client */` (pre-gate this emitted an empty loop body — silent
-  // divergence). A pure PROJECTION body (`flatMap(it => it.tags.map(...))`,
-  // e.g. the `flatmap-expression-body` fixture) is NOT pinned: it lowers to
-  // neutral nested-loop IR this adapter templatizes natively.
-  // See spec/callback-fidelity.md.
+  // A pure PROJECTION flatMap body (`flatmap-expression-body`) is NOT pinned —
+  // it lowers to neutral nested-loop IR this adapter templatizes natively;
+  // only the statement-carrying body refuses.
   'tag-cloud': [{ code: 'BF021', severity: 'error' }],
-  // A keyed `.map()` row body whose preamble builds a JSX leaf from item
-  // state (`cells.push(<td>{stateLabel}</td>)`) embedded as `{cells}` — the
-  // Stage 3 array-builder carrier, jsRuntime-only: a JS runtime runs it
-  // verbatim (and patches the region on same-key updates, #2389), a DSL
-  // adapter refuses with BF021 + `/* @client */`. See spec/callback-fidelity.md.
   'preamble-cells': [{ code: 'BF021', severity: 'error' }],
-  // `style-object-dynamic` / `style-3-signals` no longer pinned — a
-  // `style={{ … }}` object literal now lowers to a CSS string with dynamic
-  // values interpolated (`background-color:{{.Color}};padding:8px`) via
-  // `tryLowerStyleObject` (#1322).
-  // `todo-app` / `todo-app-ssr` no longer pinned (#2205) — the conformance
-  // harness now passes `siblingTemplatesRegistered: true` for fixtures with
-  // sibling `components`, matching `bf build`'s real semantics, so the
-  // BF103 loop-body cross-template check no longer fires spuriously.
-  // (`todo-app-ssr` is still skipped on this adapter via
-  // `render-divergences.ts` — #2209 — for an unrelated signal-seeding gap;
-  // `todo-app`'s pre-hydration empty render is unaffected.)
-  // `static-array-children` no longer pinned (#2208) — `items`'s
-  // array-literal initializer is now recognized as fully-static and its
-  // per-item ListItem props/data-key are baked directly into
-  // `NewStaticListProps`'s constructor (`analyzeBakeableStaticChildLoop`),
-  // since the loop body is a single child component with a plain-value
-  // prop set. See #2224 for the narrower remaining gap (a plain-ELEMENT
-  // loop body over a static array, or an inline/unnamed array literal —
-  // still refused).
-  // `([emoji, users]) => ...` is an array-index tuple destructure — #2087
-  // Phase B's widened gate now admits this shape (`destructure-array-index-in-map`
-  // exercises the same `segments`-based lowering). The remaining refusal here
-  // is orthogonal: `entries` is a function-scope local const with a computed
-  // initializer (`Object.entries(props.reactions ?? {}).filter(...)`) that
-  // the Go adapter has no binding for (only a STRING-derived local resolves
-  // to a generated struct field, via `computeDerivedConstFields`/`isStringExpr`)
-  // — left unchecked this would silently execute-time-fail instead of
-  // building loud, so `renderLoop` raises BF101 for a bare-identifier loop
-  // array bound to such a const. See the `renderLoop` comment at the check
-  // site; Jinja / ERB apply the same narrow check for the same reason.
+  // Refused for the COMPUTED loop array (`const entries = Object.entries(...)
+  // .filter(...)`), not the destructure param (that lowers, #2087) — loud
+  // BF101 instead of silently iterating an unbound name zero times.
   'static-array-from-props': [
     {
       code: 'BF101',
@@ -89,17 +35,7 @@ export const conformancePins: ConformancePins = {
       issue: 'https://github.com/piconic-ai/barefootjs/issues/2321',
     },
   ],
-  // Same computed-const array as above — the destructure param itself no
-  // longer contributes a diagnostic, and BF103 (sibling-imported child
-  // component in the loop body) no longer fires either now that the
-  // conformance harness passes `siblingTemplatesRegistered: true` (#2205).
-  // #2627 graduated: the `/* @client */` twin
-  // (`static-array-from-props-with-component-client`) now renders clean on
-  // real Go (its clientOnly nested `<Tag>` loop is excluded from the
-  // Input/Props/NewProps codegen instead of colliding with the `tags` prop's
-  // own field — see `GoTemplateAdapter.isOrphanedClientOnlyNested`), so this
-  // adapter has a verified escape for this fixture like every other one —
-  // no more `unescapable` line.
+  // No BF103 pin: the harness registers sibling templates (#2205).
   'static-array-from-props-with-component': [
     {
       code: 'BF101',
@@ -107,99 +43,13 @@ export const conformancePins: ConformancePins = {
       issue: 'https://github.com/piconic-ai/barefootjs/issues/2321',
     },
   ],
-  // (`style-3-signals` graduated alongside `style-object-dynamic` — see note
-  // above; the `style={{ … }}` object now lowers to a CSS string.)
-  // (`tagged-template-classname` graduated by #2092 — the tag resolves
-  // through the interleave-tag catalogue and desugars to an untagged
-  // template literal, so it lowers like any other className template.)
-  // #2038: a filter predicate whose body contains a NESTED callback call
-  // (`t => !picked().some(p => …)` / `t => picked().find(p => …)`). The
-  // evaluator refuses nested arrows and `renderFilterExpr` has no faithful
-  // Go form for the inner call (its `call` arm used to silently drop the
-  // arrow argument and render only the callee) — the compiler is loud
-  // instead of lossy. The `/* @client */` twin
-  // (`filter-nested-callback-predicate-client`) has no pin here: it must
-  // render clean on every adapter, which asserts the suppression contract.
-  // Faithful lowering tracked: https://github.com/piconic-ai/barefootjs/issues/2320 (successor to #2038)
+  // #2038: `renderFilterExpr`'s `call` arm has no faithful Go form for a
+  // nested arrow — loud BF101 instead of the old silent drop of the arrow
+  // argument.
   'filter-nested-callback-predicate': [
     { code: 'BF101', severity: 'error', issue: 'https://github.com/piconic-ai/barefootjs/issues/2320' },
   ],
   'filter-nested-find-predicate': [{ code: 'BF101', severity: 'error', issue: 'https://github.com/piconic-ai/barefootjs/issues/2320' }],
-  // #1310 / #2087: rest destructure in .map() callback. `isLowerableLoopDestructure`
-  // now admits every shape this fixture family exercises — each fixed/rest
-  // binding resolves via `buildSegmentAccessor`/`buildDestructureBindingMap`
-  // against a synthetic `$__bf_item0` range var (the reserved `__bf_item`
-  // name, depth-suffixed): a plain field → `$__bf_item0.Id`, an array-index
-  // step → `(index $__bf_item0 0)`, an array-rest → `(bf_slice $__bf_item0
-  // 1)` (composes under `.length` via `member()`'s generic `len <obj>` arm),
-  // and an object-rest member read (`rest.flag`) → `$__bf_item0.Flag`. A
-  // `{...rest}` SPREAD (`rest-destructure-object-spread-in-map`) routes
-  // through the new `bf_omit` runtime helper instead, so the residual omits
-  // exactly the sibling keys the pattern destructured out. No fixture in
-  // this family is pinned anymore — all six render to real Go / byte-exact
-  // HTML (`rest-destructure-object-in-map`, `rest-destructure-object-spread-in-map`,
-  // `rest-destructure-array-in-map`, `rest-destructure-nested-in-map`,
-  // `destructure-array-index-in-map`, `destructure-nested-object-in-map`).
-  // #1443: `[a, b].filter(Boolean).join(' ')` (registry Slot) now
-  // lowers to `bf_join (bf_filter_truthy (bf_arr ...)) " "`. No
-  // BF101 expected — pinned positively by the
-  // `branch-local-filter-join-go` template-output test below.
-  //
-  // #1448 Tier A — JS Array / String methods that the Go template
-  // adapter hasn't lowered yet. Each row drops once the
-  // corresponding method PR lands. Hono / CSR pass these out of
-  // the box (they evaluate JS at runtime) so the pin only applies
-  // here.
-  //
-  // `array-includes` / `string-includes` no longer pinned — both
-  // shapes lower via the shared `array-method` IR + the polymorphic
-  // `bf_includes` runtime helper that dispatches on
-  // `reflect.Kind()` (slice/array → element search, string →
-  // substring search). The condition-position lowering picks up
-  // the same emit through the `array-method` arm of
-  // `renderConditionExpr` (#1448 Tier A first PR).
-  //
-  // Remaining fixtures land at expression position and surface BF101
-  // via `convertExpressionToGo`. Distinct codes for the two paths is
-  // pre-existing adapter behaviour, not something this catalog
-  // should paper over — pinned literally here.
-  // `array-indexOf` / `array-lastIndexOf` no longer pinned —
-  // value-equality `bf_index_of` / `bf_last_index_of` Go runtime
-  // helpers handle the shape (#1448 Tier A second PR).
-  // `array-at` no longer pinned — the pre-existing `bf_at` runtime
-  // helper now lowers `.at(i)` (#1448 Tier A third PR).
-  // `array-concat` no longer pinned — the new `bf_concat` runtime
-  // helper merges two arrays into a single `[]any` (#1448 Tier A
-  // fourth PR).
-  // `array-slice` no longer pinned — the new `bf_slice` runtime
-  // helper carves out a sub-range with JS-compat clamping
-  // (#1448 Tier A fifth PR).
-  // `array-reverse` / `array-toReversed` no longer pinned —
-  // both share the `bf_reverse` helper since SSR templates
-  // render a snapshot and the JS mutate-vs-new distinction has
-  // no template-level meaning (#1448 Tier A sixth PR).
-  // `string-toLowerCase` / `string-toUpperCase` no longer pinned —
-  // pre-existing `bf_lower` / `bf_upper` runtime helpers wire to
-  // the JS method names at the adapter layer (#1448 Tier A
-  // seventh + eighth PRs).
-  // `string-trim` no longer pinned — pre-existing `bf_trim`
-  // (wraps `strings.TrimSpace`) handles the strip (#1448 Tier A
-  // ninth PR, closing out Tier A).
-  // `array-map-function-reference` no longer pinned — a bare-identifier
-  // `.map(format)` callback now resolves one hop to its declaration
-  // (`resolveCallbackMethodFunctionReferences`, #2206), the same mechanism
-  // #2090 established for `.sort(fnref)`.
-  // `dangerous-inner-html` no longer pinned — a compile-time string-literal
-  // `dangerouslySetInnerHTML={{ __html: '...' }}` is spliced directly into
-  // the template as trusted raw text (`resolveDangerousInnerHtml`, #2207).
-  // A dynamic/signal-derived value now lowers through the `bf_raw_html`
-  // runtime helper (a `template.HTML`-typed escape bypass, #2319) —
-  // `dangerous-inner-html-dynamic` is no longer pinned and renders to Hono
-  // parity, same as the static case.
-  // #2273: a method call on a prop typed as a built-in host rich type
-  // (Date, Map, …) has no catalogued lowering in any adapter — this is a
-  // compiler-level refusal (`checkRichTypeMethodCalls`, wired ahead of
-  // `adapter.generate()`), not an adapter-specific gap, so it is pinned
-  // identically across every adapter package including Hono.
   'date-method-uncatalogued': [{ code: 'BF021', severity: 'error', issue: 'https://github.com/piconic-ai/barefootjs/issues/2356' }],
+  'rich-prop-client-read': [{ code: 'BF049', severity: 'error', issue: 'https://github.com/piconic-ai/barefootjs/issues/2648' }],
 }

package/src/render-divergences.ts

@@ -1,64 +1,18 @@
 /**
- * Render-level divergences against the shared conformance corpus
- * (Priority-12 edge-case sweep, #2168): fixtures that COMPILE clean on
- * this adapter but whose rendered output diverges from the Hono
- * reference on real Go — or whose generated Go fails `go run` outright
- * (marked "exit 1" below; those should eventually become loud BF101
- * refusals instead of broken codegen).
- *
- * Consumed by this package's conformance test (its `skipJsx` set is
- * derived from these keys, so the skip list and this declaration can't
- * drift) and by `packages/compat`, which publishes the entries in the
- * fixture-divergences section of `ui/compat.lock.json` — surfaced on
- * the docs compatibility-matrix page. Graduating an entry means fixing
- * the adapter (or the shared compiler layer) and deleting the line.
- *
- * Empty — the file's last live entry (`static-array-from-props-with-
- * component-client`, #2627) graduated: a clientOnly child-component loop
- * whose array is neither a signal/memo nor a direct prop reference (e.g.
- * `Object.entries(props.tags).filter(...)` feeding a `<Tag>` loop) is now
- * excluded entirely from the Input/Props/NewProps codegen instead of
- * colliding with the driving prop's own field — see
- * `GoTemplateAdapter.isOrphanedClientOnlyNested`. The caller-side composite
- * literal for the `tags` prop now type-checks against its own `interface{}`
- * field and `go run`s clean.
- * Keep the file (and this header) when the set is empty — the next
- * divergence lands here, not in a re-created file.
+ * Fixtures that compile clean on this adapter but render divergent from the
+ * Hono reference on real Go. The conformance `skipJsx` set and
+ * `packages/compat`'s published fixture-divergences both derive from this
+ * one object, so the skip list and the declaration can't drift. Keep the
+ * file even when the set is empty — the next divergence lands here, not in
+ * a re-created file.
  */
 
 import type { RenderDivergences } from '@barefootjs/jsx'
 
 export const renderDivergences: RenderDivergences = {
-  // #2630: a prop-backed loop whose BODY is a child component renders the
-  // loop host empty — compiles clean, `go run`s clean, emits no children.
-  // Its sibling `static-array-from-props-precomputed` (same fixture,
-  // inline element body instead of a `<Tag>` child) renders correctly on
-  // every adapter, so this is specific to child-component bodies over a
-  // prop-backed array — plausibly the same missing server-side population
-  // path the `todo-app-ssr` note below describes, where
-  // `buildDynamicChildLoopSeeding` covers only the SIGNAL-backed dynamic
-  // case and a prop-backed static child loop has no analogue.
-  //
-  // This one costs a user something concrete: the BF101 diagnostic for
-  // #2321 lists pass-as-prop FIRST because it is the escape that keeps
-  // full server output, so a go-template user following that advice for a
-  // child-component loop gets an empty container at SSR with nothing
-  // reporting it. The fixture asserts the CORRECT (reference) output, so
-  // deleting this entry once the gap is fixed turns it into the
-  // regression test.
+  // #2630: the exact shape BF101's pass-as-prop suggestion (#2321) steers
+  // go-template users into — compiles clean, runs clean, silently renders the
+  // loop host empty. Full analysis in the issue.
   'static-array-from-props-with-component-precomputed':
     'prop-backed child-component loop renders the loop host empty at SSR (https://github.com/piconic-ai/barefootjs/issues/2630)',
-
-  // `todo-app-ssr` no longer diverges (#2209). Two parts: (1) `.Todos`
-  // (the loop's DATUM slice) is already seeded straight from the caller's
-  // Input — the constructor derives it from `initialTodos`, and `[]Todo`
-  // zero-fills `Editing: false`, so the `.map(t => ({ ...t, editing:
-  // false }))` transform in the signal initializer was never actually the
-  // gap on Go, unlike the 7 template-string adapters. (2) The real gap was
-  // `.TodoItems []TodoItemProps` — the loop-body CHILD COMPONENT slice the
-  // template actually ranges over — which has no server-side population
-  // path in this harness (documented as route-handler-populated in
-  // production). `buildDynamicChildLoopSeeding` (this package's
-  // `test-render.ts`) now replicates that documented contract for a
-  // signal-backed dynamic child-component loop.
 }