@barefootjs/hono 0.31.6 → 0.31.7

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

@@ -1 +1 @@
-{"version":3,"file":"hono-adapter.d.ts","sourceRoot":"","sources":["../../src/adapter/hono-adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,MAAM,EACX,KAAK,SAAS,EACd,KAAK,MAAM,EACX,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,MAAM,EACX,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,OAAO,EACZ,KAAK,MAAM,EAIX,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAElB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,UAAU,EAEf,UAAU,EAQX,MAAM,iBAAiB,CAAA;AAExB;;;;;GAKG;AACH,KAAK,aAAa,GAAG;IACnB,uBAAuB,CAAC,EAAE,OAAO,CAAA;IACjC,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB,CAAA;AAGD,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAEzB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAEzB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAuBD,qBAAa,WAAY,SAAQ,UAAW,YAAW,aAAa,CAAC,aAAa,CAAC;IACjF,IAAI,SAAS;IACb,SAAS,SAAS;IAClB,gBAAgB,SAAiC;IAmBjD,mBAAmB,QAAO,OAAO,CAAQ;IAEzC,SAAS,CAAC,SAAS,EAAE,gBAAgB,CAA0B;IAE/D,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,iBAAiB,CAAiB;IAC1C,OAAO,CAAC,sBAAsB,CAAiB;IAC/C,OAAO,CAAC,wBAAwB,CAAiB;IACjD;;;;;;;OAOG;IACH,OAAO,CAAC,qBAAqB,CAAC,CAAgC;IAC9D,uFAAuF;IACvF,OAAO,CAAC,YAAY,CAAmD;IACvE;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,YAAY,CAAC,CAAU;IAC/B;;;;;;OAMG;IACH,OAAO,CAAC,aAAa,CAAC,CAAU;IAEhC,YAAY,OAAO,GAAE,kBAAuB,EAQ3C;IAED,QAAQ,CAAC,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,aAAa,CAiEzE;IAED;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IAIvB;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,eAAe;IA4EvB;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAmB5C;IAED,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,iBAAiB;IA+QzB;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,aAAa,GAAG,MAAM,CAEpD;IAMD,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG,MAAM,CAEzF;IAED,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7B;IAED,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAEzC;IAED,eAAe,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG,MAAM,CAEjG;IAED,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG,MAAM,CAEpF;IAED,aAAa,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG,MAAM,CAE7F;IAED,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG,MAAM,CAE5F;IAED,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9B;IAED,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG,MAAM,CAKnG;IAED,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG,MAAM,CAwB5F;IAED,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG,MAAM,CAEtF;IAED,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,CA2C5E;IAED,OAAO,CAAC,UAAU;IAUlB,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CA2B3C;IAED,iBAAiB,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE,aAAa,GAAG,MAAM,CAOlE;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,OAAO,CAAC,qBAAqB;IAiC7B;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,kBAAkB;IAsC1B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiH/B;IAED,OAAO,CAAC,oBAAoB;IAI5B;;;OAGG;IACH,iBAAiB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE;QAAE,uBAAuB,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,CAkE5F;IAEQ,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAgB1C;IAED,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE;QAAE,uBAAuB,CAAC,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,CAkDhH;IAED,OAAO,CAAC,cAAc;IAQtB;;;;;;;;;OASG;IACH,OAAO,CAAC,oBAAoB;IAY5B;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAuBlC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAiBpC;IAED,OAAO,CAAC,gBAAgB;IAiCxB,OAAO,CAAC,oBAAoB;IAyB5B,OAAO,CAAC,iBAAiB;IAYzB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,0BAA0B;CAInC;AAGD,eAAO,MAAM,WAAW,aAAoB,CAAA"}
+{"version":3,"file":"hono-adapter.d.ts","sourceRoot":"","sources":["../../src/adapter/hono-adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,MAAM,EACX,KAAK,SAAS,EACd,KAAK,MAAM,EACX,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,MAAM,EACX,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,OAAO,EACZ,KAAK,MAAM,EAIX,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAElB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,UAAU,EAEf,UAAU,EAQX,MAAM,iBAAiB,CAAA;AAExB;;;;;GAKG;AACH,KAAK,aAAa,GAAG;IACnB,uBAAuB,CAAC,EAAE,OAAO,CAAA;IACjC,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB,CAAA;AAGD,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAEzB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAEzB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAuBD,qBAAa,WAAY,SAAQ,UAAW,YAAW,aAAa,CAAC,aAAa,CAAC;IACjF,IAAI,SAAS;IACb,SAAS,SAAS;IAClB,gBAAgB,SAAiC;IAmBjD,mBAAmB,QAAO,OAAO,CAAQ;IAEzC,SAAS,CAAC,SAAS,EAAE,gBAAgB,CAA0B;IAE/D,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,iBAAiB,CAAiB;IAC1C,OAAO,CAAC,sBAAsB,CAAiB;IAC/C,OAAO,CAAC,wBAAwB,CAAiB;IACjD;;;;;;;OAOG;IACH,OAAO,CAAC,qBAAqB,CAAC,CAAgC;IAC9D,uFAAuF;IACvF,OAAO,CAAC,YAAY,CAAmD;IACvE;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,YAAY,CAAC,CAAU;IAC/B;;;;;;OAMG;IACH,OAAO,CAAC,aAAa,CAAC,CAAU;IAEhC,YAAY,OAAO,GAAE,kBAAuB,EAQ3C;IAED,QAAQ,CAAC,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,aAAa,CAiEzE;IAED;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IAIvB;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,eAAe;IA6EvB;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAmB5C;IAED,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,iBAAiB;IA+QzB;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,aAAa,GAAG,MAAM,CAEpD;IAMD,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG,MAAM,CAEzF;IAED,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7B;IAED,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAEzC;IAED,eAAe,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG,MAAM,CAEjG;IAED,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG,MAAM,CAEpF;IAED,aAAa,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG,MAAM,CAE7F;IAED,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG,MAAM,CAE5F;IAED,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9B;IAED,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG,MAAM,CAKnG;IAED,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG,MAAM,CAwB5F;IAED,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG,MAAM,CAEtF;IAED,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,CA2C5E;IAED,OAAO,CAAC,UAAU;IAUlB,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CA2B3C;IAED,iBAAiB,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE,aAAa,GAAG,MAAM,CAOlE;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,OAAO,CAAC,qBAAqB;IAiC7B;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,kBAAkB;IAsC1B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiH/B;IAED,OAAO,CAAC,oBAAoB;IAI5B;;;OAGG;IACH,iBAAiB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE;QAAE,uBAAuB,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,CAkE5F;IAEQ,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAgB1C;IAED,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE;QAAE,uBAAuB,CAAC,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,CAkDhH;IAED,OAAO,CAAC,cAAc;IAQtB;;;;;;;;;OASG;IACH,OAAO,CAAC,oBAAoB;IAY5B;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAuBlC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAiBpC;IAED,OAAO,CAAC,gBAAgB;IAiCxB,OAAO,CAAC,oBAAoB;IAyB5B,OAAO,CAAC,iBAAiB;IAYzB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,0BAA0B;CAInC;AAGD,eAAO,MAAM,WAAW,aAAoB,CAAA"}

package/dist/adapter/index.js

@@ -95,7 +95,7 @@ export default ${this.componentName}` : "";
   generateImports(ir, componentCode) {
     const lines = [];
     const utilImports = [];
-    for (const util of ["bfComment", "bfText", "bfTextEnd"]) {
+    for (const util of ["bfComment", "bfText", "bfTextEnd", "serializeHydrationProps"]) {
       if (new RegExp(`\\b${util}\\b`).test(componentCode)) {
         utilImports.push(util);
       }
@@ -261,7 +261,7 @@ export default ${this.componentName}` : "";
         const callerKey = p.sourceName ?? p.name;
         lines.push(`  if (typeof ${propAccess} !== 'function' && !(typeof ${propAccess} === 'object' && ${propAccess} !== null && 'isEscaped' in ${propAccess})) __hydrateProps['${callerKey}'] = ${propAccess}`);
       }
-      lines.push(`  const __bfPropsJson = __bfParentProps || (Object.keys(__hydrateProps).length > 0 ? JSON.stringify(__hydrateProps) : undefined)`);
+      lines.push(`  const __bfPropsJson = __bfParentProps || serializeHydrationProps(__hydrateProps, '${name}')`);
     } else if (hasClientInteractivity && isRootComponent) {
       lines.push("");
       lines.push(`  const __bfPropsJson = __bfParentProps`);

package/dist/conformance-pins.d.ts

@@ -2,13 +2,11 @@
  * Per-fixture build-time contracts for shapes the Hono adapter
  * intentionally refuses to lower. Hono's SSR runtime is JS — its
  * `acceptsTemplateCall` is broad enough to cover every adapter-specific
- * lowering gap, so this package's only pin is the one refusal that is
- * NOT adapter-specific: a method call on a host rich-typed prop (Date,
- * Map, …) with no catalogued lowering refuses with BF021 at the
- * compiler layer (`checkRichTypeMethodCalls`), ahead of and independent
- * of `adapter.generate()` — even Hono's native JS evaluation never sees
- * the call (#2273). Consumed by this package's own conformance test (as
- * `expectedDiagnostics`) and by `bf compat` (issue-URL attribution).
+ * lowering gap, so the only pins here are compiler-level refusals that
+ * fire ahead of `adapter.generate()` and apply identically everywhere.
+ * `date-method-uncatalogued` stays pinned even here: hydrate-init
+ * re-evaluates the expression against a JSON-de-riched receiver, so a
+ * Hono-specific carve-out was evaluated and rejected (#2356).
  */
 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;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEtD,eAAO,MAAM,eAAe,EAAE,eAE7B,CAAA"}
+{"version":3,"file":"conformance-pins.d.ts","sourceRoot":"","sources":["../src/conformance-pins.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEtD,eAAO,MAAM,eAAe,EAAE,eAG7B,CAAA"}

package/dist/index.js

@@ -95,7 +95,7 @@ export default ${this.componentName}` : "";
   generateImports(ir, componentCode) {
     const lines = [];
     const utilImports = [];
-    for (const util of ["bfComment", "bfText", "bfTextEnd"]) {
+    for (const util of ["bfComment", "bfText", "bfTextEnd", "serializeHydrationProps"]) {
       if (new RegExp(`\\b${util}\\b`).test(componentCode)) {
         utilImports.push(util);
       }
@@ -261,7 +261,7 @@ export default ${this.componentName}` : "";
         const callerKey = p.sourceName ?? p.name;
         lines.push(`  if (typeof ${propAccess} !== 'function' && !(typeof ${propAccess} === 'object' && ${propAccess} !== null && 'isEscaped' in ${propAccess})) __hydrateProps['${callerKey}'] = ${propAccess}`);
       }
-      lines.push(`  const __bfPropsJson = __bfParentProps || (Object.keys(__hydrateProps).length > 0 ? JSON.stringify(__hydrateProps) : undefined)`);
+      lines.push(`  const __bfPropsJson = __bfParentProps || serializeHydrationProps(__hydrateProps, '${name}')`);
     } else if (hasClientInteractivity && isRootComponent) {
       lines.push("");
       lines.push(`  const __bfPropsJson = __bfParentProps`);
@@ -668,7 +668,8 @@ export default ${this.componentName}` : "";
 var honoAdapter = new HonoAdapter;
 // src/conformance-pins.ts
 var conformancePins = {
-  "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" }]
 };
 export {
   honoAdapter,

package/dist/utils.d.ts

@@ -13,4 +13,34 @@ export declare function bfText(slotId: string): import("hono/utils/html").HtmlEs
  * Renders <!--/-->
  */
 export declare function bfTextEnd(): import("hono/utils/html").HtmlEscapedString;
+/**
+ * Serialize a component's hydration props into the `bf-p` JSON payload,
+ * throwing a clear, actionable error instead of `JSON.stringify`'s opaque
+ * `TypeError` (for a `BigInt`) or silently succeeding with data loss (for a
+ * `Map`/`Set`/etc.) — the runtime backstop for #2643's compile-time check
+ * (`checkRichTypePropSerialization`, BF049), which can only catch a prop
+ * whose type is PROVABLE from `propsType`. An imported/aliased type
+ * (`type Timestamp = Map<…>`), or a prop typed too loosely to resolve
+ * statically, reaches this function uncaught by BF049, so it needs its own
+ * check here to avoid regressing to the pre-#2643 failure modes.
+ *
+ * Deliberately checks only TOP-LEVEL prop values, not nested shapes —
+ * `JSON.stringify`'s existing deep-degradation behavior for a nested rich
+ * value (e.g. a `RegExp` inside a plain object) is unchanged, matching a
+ * real, shipped, TOLERATED pattern in this repo (`site/ui`'s InputOTP demo
+ * passes a live `RegExp` `pattern` prop that degrades to `{}` today; the
+ * component's own design accounts for that). Widening this to a deep walk
+ * would turn that accepted degradation into a new SSR 500.
+ *
+ * The throw set is narrower than BF049's flag set, but NOT because
+ * `RegExp` / `Error` / `URLSearchParams` preserve more data than a `Map` or
+ * `Set` — `JSON.stringify` degrades `RegExp` and `Error` to `{}` exactly
+ * like a `Map`/`Set` (only `URLSearchParams` happens to round-trip its
+ * key/value pairs as a plain object). They're excluded from the runtime
+ * throw purely to avoid a breaking behavior change: `site/ui`'s InputOTP
+ * demo already ships a live `RegExp` `pattern` prop that degrades to `{}`
+ * today, and the component's own design tolerates that. They stay
+ * diagnosable at compile time (BF049) only, not a runtime hard-stop.
+ */
+export declare function serializeHydrationProps(props: Record<string, unknown>, componentName: string): string | undefined;
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,+CAEpC;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,+CAEpC;AAED;;;GAGG;AACH,wBAAgB,SAAS,gDAExB"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,+CAEpC;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,+CAEpC;AAED;;;GAGG;AACH,wBAAgB,SAAS,gDAExB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAsCjH"}

package/dist/utils.js

@@ -9,7 +9,22 @@ function bfText(slotId) {
 function bfTextEnd() {
   return raw("<!--/-->");
 }
+function serializeHydrationProps(props, componentName) {
+  const keys = Object.keys(props);
+  if (keys.length === 0)
+    return;
+  for (const key of keys) {
+    const value = props[key];
+    const offender = typeof value === "bigint" ? "BigInt" : typeof value === "symbol" ? "Symbol" : value instanceof Map ? "Map" : value instanceof Set ? "Set" : value instanceof WeakMap ? "WeakMap" : value instanceof WeakSet ? "WeakSet" : value instanceof Promise ? "Promise" : null;
+    if (offender !== null) {
+      const consequence = offender === "BigInt" ? "" : offender === "Symbol" ? " (the prop would be silently omitted from the payload entirely)" : offender === "Promise" ? " (its eventual value would be silently unreachable — JSON.stringify can't wait for a promise to settle)" : " (its entries would be silently dropped, serializing to {})";
+      throw new TypeError(`[barefootjs] Cannot serialize prop '${key}' of <${componentName}> for hydration: a ${offender} does not ` + `survive the bf-p JSON boundary${consequence}. Pre-compute a JSON-safe value (string/number/array/plain ` + `object) server-side and pass that instead. See BF049 (https://github.com/piconic-ai/barefootjs/issues/2643).`);
+    }
+  }
+  return JSON.stringify(props);
+}
 export {
+  serializeHydrationProps,
   bfTextEnd,
   bfText,
   bfComment

package/dist/vite.js

@@ -433,6 +433,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",
@@ -463,6 +464,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.",
@@ -496,6 +498,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();
@@ -2449,7 +2453,7 @@ export default ${this.componentName}` : "";
   generateImports(ir, componentCode) {
     const lines = [];
     const utilImports = [];
-    for (const util of ["bfComment", "bfText", "bfTextEnd"]) {
+    for (const util of ["bfComment", "bfText", "bfTextEnd", "serializeHydrationProps"]) {
       if (new RegExp(`\\b${util}\\b`).test(componentCode)) {
         utilImports.push(util);
       }
@@ -2615,7 +2619,7 @@ export default ${this.componentName}` : "";
         const callerKey = p.sourceName ?? p.name;
         lines.push(`  if (typeof ${propAccess} !== 'function' && !(typeof ${propAccess} === 'object' && ${propAccess} !== null && 'isEscaped' in ${propAccess})) __hydrateProps['${callerKey}'] = ${propAccess}`);
       }
-      lines.push(`  const __bfPropsJson = __bfParentProps || (Object.keys(__hydrateProps).length > 0 ? JSON.stringify(__hydrateProps) : undefined)`);
+      lines.push(`  const __bfPropsJson = __bfParentProps || serializeHydrationProps(__hydrateProps, '${name}')`);
     } else if (hasClientInteractivity && isRootComponent) {
       lines.push("");
       lines.push(`  const __bfPropsJson = __bfParentProps`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@barefootjs/hono",
-  "version": "0.31.6",
+  "version": "0.31.7",
   "description": "Hono integration for BarefootJS",
   "type": "module",
   "main": "./dist/index.js",
@@ -122,7 +122,7 @@
   },
   "devDependencies": {
     "@barefootjs/adapter-tests": "0.1.0",
-    "@barefootjs/vite": "0.31.6",
+    "@barefootjs/vite": "0.31.7",
     "@types/jsdom": "^27.0.0",
     "hono": "^4.6.0",
     "jsdom": "^27.3.0",

package/src/__tests__/serialize-hydration-props.test.ts

@@ -0,0 +1,103 @@
+/**
+ * `serializeHydrationProps` (#2643) — the Hono-only runtime backstop for
+ * BF049 (`packages/jsx/src/rich-type-refusal.ts`'s
+ * `checkRichTypePropSerialization`). BF049 can only catch a prop whose type
+ * is PROVABLE from `propsType`; an imported/aliased type or a loosely-typed
+ * prop reaches Hono's serialization step uncaught, so this helper is the
+ * actual floor: it throws a clear, actionable error for a value that cannot
+ * survive the `bf-p` JSON boundary, instead of `JSON.stringify`'s opaque
+ * `TypeError` (BigInt) or silent data loss (Map/Set/…).
+ */
+
+import { describe, test, expect } from 'bun:test'
+import { serializeHydrationProps } from '../utils'
+import { renderHonoComponent } from '../test-render'
+import { HonoAdapter } from '../adapter/hono-adapter'
+
+describe('serializeHydrationProps — unit', () => {
+  test('empty props return undefined', () => {
+    expect(serializeHydrationProps({}, 'Foo')).toBeUndefined()
+  })
+
+  test('a plain JSON-safe props object serializes normally', () => {
+    expect(serializeHydrationProps({ a: 1, b: 'x', c: [1, 2], d: null }, 'Foo')).toBe(
+      JSON.stringify({ a: 1, b: 'x', c: [1, 2], d: null }),
+    )
+  })
+
+  test('a Date prop passes through untouched (handled by JSON.stringify’s own toJSON)', () => {
+    const d = new Date('2024-01-01T00:00:00.000Z')
+    expect(serializeHydrationProps({ createdAt: d }, 'Foo')).toBe(JSON.stringify({ createdAt: d }))
+  })
+
+  test.each([
+    ['BigInt', { n: 123n }, 'n', 'BigInt'],
+    ['Symbol', { s: Symbol('x') }, 's', 'Symbol'],
+    ['Map', { data: new Map([['x', 1]]) }, 'data', 'Map'],
+    ['Set', { tags: new Set(['x']) }, 'tags', 'Set'],
+    ['WeakMap', { wm: new WeakMap() }, 'wm', 'WeakMap'],
+    ['WeakSet', { ws: new WeakSet() }, 'ws', 'WeakSet'],
+    ['Promise', { p: Promise.resolve(1) }, 'p', 'Promise'],
+  ] as const)('%s prop throws a clear TypeError naming the prop, component, and #2643', (_label, props, propName, offender) => {
+    expect(() => serializeHydrationProps(props, 'Foo')).toThrow(TypeError)
+    try {
+      serializeHydrationProps(props, 'Foo')
+      throw new Error('expected a throw')
+    } catch (e) {
+      expect((e as Error).message).toContain(`prop '${propName}'`)
+      expect((e as Error).message).toContain('<Foo>')
+      expect((e as Error).message).toContain(offender)
+      expect((e as Error).message).toContain('2643')
+    }
+  })
+
+  test('a nested RegExp (inside a plain object) does not throw — only top-level values are checked', () => {
+    // Matches the existing, shipped, TOLERATED degradation the InputOTP demo
+    // relies on: JSON.stringify's own deep behavior for a nested rich value
+    // is unchanged by this helper.
+    const value = { wrapper: { pattern: /^[0-9]+$/ } }
+    expect(() => serializeHydrationProps(value, 'Foo')).not.toThrow()
+  })
+
+  test('a top-level RegExp/Error/URLSearchParams degrades like JSON.stringify already did — not in the throw set', () => {
+    expect(() => serializeHydrationProps({ pattern: /x/ }, 'Foo')).not.toThrow()
+    expect(() => serializeHydrationProps({ err: new Error('x') }, 'Foo')).not.toThrow()
+    expect(() => serializeHydrationProps({ q: new URLSearchParams('a=1') }, 'Foo')).not.toThrow()
+  })
+})
+
+describe('serializeHydrationProps — integration via real Hono SSR render', () => {
+  // Prop typed `unknown` so BF049 has no static evidence to fire on —
+  // exercises the runtime backstop specifically, independent of the
+  // compile-time check.
+  const SOURCE = `
+    'use client'
+    export function Foo({ data }: { data: unknown }) {
+      return <button onClick={() => console.log(data)}>go</button>
+    }
+  `
+
+  // `renderHonoComponent` routes through Hono's own default error handler
+  // (`app.request()`, no custom `app.onError`), which swallows a thrown
+  // error's message into a generic 500 body — so these integration tests
+  // only prove the WIRING actually fails the request end-to-end (the
+  // `serializeHydrationProps` call is really reached from real generated
+  // component code, via the real `@barefootjs/hono/utils` import). The
+  // exact thrown message is already pinned by the direct unit tests above.
+  test('a Map prop causes SSR to fail (the runtime backstop is really wired into generated code)', async () => {
+    await expect(
+      renderHonoComponent({ adapter: new HonoAdapter(), source: SOURCE, props: { data: new Map([['x', 1]]) } }),
+    ).rejects.toThrow(/Render failed with status 500/)
+  })
+
+  test('a BigInt prop causes SSR to fail (previously an opaque JSON.stringify TypeError; behavior unchanged, now via the clearer helper)', async () => {
+    await expect(
+      renderHonoComponent({ adapter: new HonoAdapter(), source: SOURCE, props: { data: 123n } }),
+    ).rejects.toThrow(/Render failed with status 500/)
+  })
+
+  test('an array prop (JSON-safe) renders successfully', async () => {
+    const html = await renderHonoComponent({ adapter: new HonoAdapter(), source: SOURCE, props: { data: [1, 2, 3] } })
+    expect(html).toContain('bf-p=')
+  })
+})

package/src/adapter/hono-adapter.ts

@@ -270,9 +270,10 @@ export class HonoAdapter extends JsxAdapter implements IRNodeEmitter<HonoRenderC
   private generateImports(ir: ComponentIR, componentCode: string): string {
     const lines: string[] = []
 
-    // Only import bfComment/bfText/bfTextEnd utilities that are actually used
+    // Only import bfComment/bfText/bfTextEnd/serializeHydrationProps utilities
+    // that are actually used
     const utilImports: string[] = []
-    for (const util of ['bfComment', 'bfText', 'bfTextEnd']) {
+    for (const util of ['bfComment', 'bfText', 'bfTextEnd', 'serializeHydrationProps']) {
       if (new RegExp(`\\b${util}\\b`).test(componentCode)) {
         utilImports.push(util)
       }
@@ -618,7 +619,7 @@ export class HonoAdapter extends JsxAdapter implements IRNodeEmitter<HonoRenderC
         const callerKey = p.sourceName ?? p.name
         lines.push(`  if (typeof ${propAccess} !== 'function' && !(typeof ${propAccess} === 'object' && ${propAccess} !== null && 'isEscaped' in ${propAccess})) __hydrateProps['${callerKey}'] = ${propAccess}`)
       }
-      lines.push(`  const __bfPropsJson = __bfParentProps || (Object.keys(__hydrateProps).length > 0 ? JSON.stringify(__hydrateProps) : undefined)`)
+      lines.push(`  const __bfPropsJson = __bfParentProps || serializeHydrationProps(__hydrateProps, '${name}')`)
     } else if (hasClientInteractivity && isRootComponent) {
       // No own props, but root is a component — pass through parent's props
       lines.push('')

package/src/conformance-pins.ts

@@ -2,17 +2,16 @@
  * Per-fixture build-time contracts for shapes the Hono adapter
  * intentionally refuses to lower. Hono's SSR runtime is JS — its
  * `acceptsTemplateCall` is broad enough to cover every adapter-specific
- * lowering gap, so this package's only pin is the one refusal that is
- * NOT adapter-specific: a method call on a host rich-typed prop (Date,
- * Map, …) with no catalogued lowering refuses with BF021 at the
- * compiler layer (`checkRichTypeMethodCalls`), ahead of and independent
- * of `adapter.generate()` — even Hono's native JS evaluation never sees
- * the call (#2273). Consumed by this package's own conformance test (as
- * `expectedDiagnostics`) and by `bf compat` (issue-URL attribution).
+ * lowering gap, so the only pins here are compiler-level refusals that
+ * fire ahead of `adapter.generate()` and apply identically everywhere.
+ * `date-method-uncatalogued` stays pinned even here: hydrate-init
+ * re-evaluates the expression against a JSON-de-riched receiver, so a
+ * Hono-specific carve-out was evaluated and rejected (#2356).
  */
 
 import type { ConformancePins } from '@barefootjs/jsx'
 
 export const conformancePins: ConformancePins = {
   '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/utils.ts

@@ -24,3 +24,72 @@ export function bfTextEnd() {
   return raw('<!--/-->')
 }
 
+/**
+ * Serialize a component's hydration props into the `bf-p` JSON payload,
+ * throwing a clear, actionable error instead of `JSON.stringify`'s opaque
+ * `TypeError` (for a `BigInt`) or silently succeeding with data loss (for a
+ * `Map`/`Set`/etc.) — the runtime backstop for #2643's compile-time check
+ * (`checkRichTypePropSerialization`, BF049), which can only catch a prop
+ * whose type is PROVABLE from `propsType`. An imported/aliased type
+ * (`type Timestamp = Map<…>`), or a prop typed too loosely to resolve
+ * statically, reaches this function uncaught by BF049, so it needs its own
+ * check here to avoid regressing to the pre-#2643 failure modes.
+ *
+ * Deliberately checks only TOP-LEVEL prop values, not nested shapes —
+ * `JSON.stringify`'s existing deep-degradation behavior for a nested rich
+ * value (e.g. a `RegExp` inside a plain object) is unchanged, matching a
+ * real, shipped, TOLERATED pattern in this repo (`site/ui`'s InputOTP demo
+ * passes a live `RegExp` `pattern` prop that degrades to `{}` today; the
+ * component's own design accounts for that). Widening this to a deep walk
+ * would turn that accepted degradation into a new SSR 500.
+ *
+ * The throw set is narrower than BF049's flag set, but NOT because
+ * `RegExp` / `Error` / `URLSearchParams` preserve more data than a `Map` or
+ * `Set` — `JSON.stringify` degrades `RegExp` and `Error` to `{}` exactly
+ * like a `Map`/`Set` (only `URLSearchParams` happens to round-trip its
+ * key/value pairs as a plain object). They're excluded from the runtime
+ * throw purely to avoid a breaking behavior change: `site/ui`'s InputOTP
+ * demo already ships a live `RegExp` `pattern` prop that degrades to `{}`
+ * today, and the component's own design tolerates that. They stay
+ * diagnosable at compile time (BF049) only, not a runtime hard-stop.
+ */
+export function serializeHydrationProps(props: Record<string, unknown>, componentName: string): string | undefined {
+  const keys = Object.keys(props)
+  if (keys.length === 0) return undefined
+  for (const key of keys) {
+    const value = props[key]
+    const offender =
+      typeof value === 'bigint'
+        ? 'BigInt'
+        : typeof value === 'symbol'
+          ? 'Symbol'
+          : value instanceof Map
+            ? 'Map'
+            : value instanceof Set
+              ? 'Set'
+              : value instanceof WeakMap
+                ? 'WeakMap'
+                : value instanceof WeakSet
+                  ? 'WeakSet'
+                  : value instanceof Promise
+                    ? 'Promise'
+                    : null
+    if (offender !== null) {
+      const consequence =
+        offender === 'BigInt'
+          ? ''
+          : offender === 'Symbol'
+            ? ' (the prop would be silently omitted from the payload entirely)'
+            : offender === 'Promise'
+              ? " (its eventual value would be silently unreachable — JSON.stringify can't wait for a promise to settle)"
+              : ' (its entries would be silently dropped, serializing to {})'
+      throw new TypeError(
+        `[barefootjs] Cannot serialize prop '${key}' of <${componentName}> for hydration: a ${offender} does not ` +
+          `survive the bf-p JSON boundary${consequence}. Pre-compute a JSON-safe value (string/number/array/plain ` +
+          `object) server-side and pass that instead. See BF049 (https://github.com/piconic-ai/barefootjs/issues/2643).`,
+      )
+    }
+  }
+  return JSON.stringify(props)
+}
+