@barefootjs/client 0.21.3 → 0.23.0

package/dist/format-date.d.ts

@@ -0,0 +1,30 @@
+/**
+ * `formatDate` — format a `Date` (or ISO-8601 string) with an explicit pattern
+ * and an explicit UTC offset. The pure-function date formatter of #2324: every
+ * input is explicit, so the output is a deterministic function of its
+ * arguments — no host locale, no host timezone, no ICU/CLDR data. That is what
+ * lets the SSR adapters lower a `formatDate(...)` call to their native
+ * `format_date` runtime helper (spec/template-helpers.md) with byte-identical
+ * output on every backend.
+ *
+ * ```tsx
+ * <time>{formatDate(createdAt, 'YYYY/M/D', '+09:00')}</time>
+ * ```
+ *
+ * Pattern tokens (longest-match; any other character passes through
+ * literally): `YYYY` (4-digit zero-padded year, `-`-prefixed for negative
+ * years), `MM` / `M` (zero-padded / bare month `01`–`12` / `1`–`12`), `DD` /
+ * `D` (zero-padded / bare day of month). The v1 token set is date-only and
+ * numeric — locale-dependent fields (month names, weekday names) are a
+ * deliberate later stage of #2324, and per-locale *pattern selection* belongs
+ * to the app's i18n layer, not to this function.
+ *
+ * `timeZone` is `'UTC'` or a fixed offset `±HH:MM` (`'+09:00'`, `'-05:30'`).
+ * The function is total: any other value — including IANA zone names, which
+ * would drag host tzdata versions into the output — normalizes to `'UTC'`, so
+ * every backend degrades identically instead of diverging. An unset or
+ * unparseable `date` renders `''` (the same normative zero-value discipline as
+ * the `date` helper, spec/template-helpers.md).
+ */
+export declare function formatDate(date: Date | string, pattern: string, timeZone?: string): string;
+//# sourceMappingURL=format-date.d.ts.map

package/dist/format-date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-date.d.ts","sourceRoot":"","sources":["../src/format-date.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AASH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,SAAQ,GAAG,MAAM,CAkCzF"}

package/dist/index.d.ts

@@ -5,6 +5,7 @@ export { __slot, type SlotMarker } from './slot.ts';
 export { forwardProps } from './forward-props.ts';
 export { unwrap } from './unwrap.ts';
 export { queryHref, type QueryParams, type QueryParamValue } from './query-href.ts';
+export { formatDate } from './format-date.ts';
 export { createContext, type Context } from './context.ts';
 export { useContext, provideContext, createPortal, isSSRPortal, findSiblingSlot, cleanupPortalPlaceholder, type Portal, type PortalChildren, type PortalOptions, type Renderable, } from './shims.ts';
 export { Async, Region, type AsyncProps, type RegionProps, } from './builtins.ts';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,sBAAsB,EACtB,UAAU,EACV,cAAc,EACd,UAAU,EACV,SAAS,EACT,OAAO,EACP,OAAO,EACP,KAAK,EACL,eAAe,EACf,SAAS,EACT,OAAO,EACP,gBAAgB,EAMhB,kBAAkB,EAClB,KAAK,gBAAgB,EACrB,sBAAsB,EACtB,KAAK,QAAQ,EACb,KAAK,MAAM,EACX,KAAK,IAAI,EACT,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,iBAAiB,EACtB,KAAK,cAAc,GACpB,MAAM,6BAA6B,CAAA;AAEpC,OAAO,EACL,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,aAAa,GACnB,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAA;AAEnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,OAAO,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEnF,OAAO,EAAE,aAAa,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAA;AAE1D,OAAO,EACL,UAAU,EACV,cAAc,EACd,YAAY,EACZ,WAAW,EACX,eAAe,EACf,wBAAwB,EACxB,KAAK,MAAM,EACX,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,MAAM,YAAY,CAAA;AAKnB,OAAO,EACL,KAAK,EACL,MAAM,EACN,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,sBAAsB,EACtB,UAAU,EACV,cAAc,EACd,UAAU,EACV,SAAS,EACT,OAAO,EACP,OAAO,EACP,KAAK,EACL,eAAe,EACf,SAAS,EACT,OAAO,EACP,gBAAgB,EAMhB,kBAAkB,EAClB,KAAK,gBAAgB,EACrB,sBAAsB,EACtB,KAAK,QAAQ,EACb,KAAK,MAAM,EACX,KAAK,IAAI,EACT,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,iBAAiB,EACtB,KAAK,cAAc,GACpB,MAAM,6BAA6B,CAAA;AAEpC,OAAO,EACL,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,aAAa,GACnB,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAA;AAEnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,OAAO,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,EAAE,aAAa,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAA;AAE1D,OAAO,EACL,UAAU,EACV,cAAc,EACd,YAAY,EACZ,WAAW,EACX,eAAe,EACf,wBAAwB,EACxB,KAAK,MAAM,EACX,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,MAAM,YAAY,CAAA;AAKnB,OAAO,EACL,KAAK,EACL,MAAM,EACN,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,eAAe,CAAA"}

package/dist/index.js

@@ -162,6 +162,43 @@ function queryHref(base, params) {
   const qs = u.toString();
   return qs ? `${base}?${qs}` : base;
 }
+// src/format-date.ts
+var OFFSET_RE = /^([+-])(\d{2}):(\d{2})$/;
+var TOKEN_RE = /YYYY|MM|DD|M|D/g;
+function pad2(n) {
+  return String(n).padStart(2, "0");
+}
+function formatDate(date, pattern, timeZone = "UTC") {
+  if (date === null || date === undefined)
+    return "";
+  const d = date instanceof Date ? date : new Date(date);
+  const t = d.getTime();
+  if (Number.isNaN(t))
+    return "";
+  const m = OFFSET_RE.exec(timeZone);
+  const offsetMinutes = m ? (m[1] === "-" ? -1 : 1) * (Number(m[2]) * 60 + Number(m[3])) : 0;
+  const s = new Date(t + offsetMinutes * 60000);
+  const year = s.getUTCFullYear();
+  const yyyy = (year < 0 ? "-" : "") + String(Math.abs(year)).padStart(4, "0");
+  const month = s.getUTCMonth() + 1;
+  const day = s.getUTCDate();
+  return pattern.replace(TOKEN_RE, (token) => {
+    switch (token) {
+      case "YYYY":
+        return yyyy;
+      case "MM":
+        return pad2(month);
+      case "M":
+        return String(month);
+      case "DD":
+        return pad2(day);
+      case "D":
+        return String(day);
+      default:
+        return token;
+    }
+  });
+}
 // src/context.ts
 function createContext(defaultValue) {
   return {
@@ -216,6 +253,7 @@ export {
   onCleanup,
   isSSRPortal,
   forwardProps,
+  formatDate,
   findSiblingSlot,
   endTurn,
   createSignal,

package/dist/runtime/index.d.ts

@@ -5,6 +5,7 @@ export { __slot, type SlotMarker } from '../slot.ts';
 export { forwardProps } from '../forward-props.ts';
 export { unwrap } from '../unwrap.ts';
 export { queryHref, type QueryParams, type QueryParamValue } from '../query-href.ts';
+export { formatDate } from '../format-date.ts';
 export { createContext, useContext, provideContext, setCurrentScope, type Context, } from './context.ts';
 export { createPortal, isSSRPortal, findSiblingSlot, cleanupPortalPlaceholder, type Portal, type PortalOptions, type Renderable, type PortalChildren, } from './portal.ts';
 export { reconcileList, type RenderItemFn } from './list.ts';

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

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

package/dist/runtime/index.js

@@ -162,6 +162,43 @@ function queryHref(base, params) {
   const qs = u.toString();
   return qs ? `${base}?${qs}` : base;
 }
+// src/format-date.ts
+var OFFSET_RE = /^([+-])(\d{2}):(\d{2})$/;
+var TOKEN_RE = /YYYY|MM|DD|M|D/g;
+function pad2(n) {
+  return String(n).padStart(2, "0");
+}
+function formatDate(date, pattern, timeZone = "UTC") {
+  if (date === null || date === undefined)
+    return "";
+  const d = date instanceof Date ? date : new Date(date);
+  const t = d.getTime();
+  if (Number.isNaN(t))
+    return "";
+  const m = OFFSET_RE.exec(timeZone);
+  const offsetMinutes = m ? (m[1] === "-" ? -1 : 1) * (Number(m[2]) * 60 + Number(m[3])) : 0;
+  const s = new Date(t + offsetMinutes * 60000);
+  const year = s.getUTCFullYear();
+  const yyyy = (year < 0 ? "-" : "") + String(Math.abs(year)).padStart(4, "0");
+  const month = s.getUTCMonth() + 1;
+  const day = s.getUTCDate();
+  return pattern.replace(TOKEN_RE, (token) => {
+    switch (token) {
+      case "YYYY":
+        return yyyy;
+      case "MM":
+        return pad2(month);
+      case "M":
+        return String(month);
+      case "DD":
+        return pad2(day);
+      case "D":
+        return String(day);
+      default:
+        return token;
+    }
+  });
+}
 // ../shared/src/markers.ts
 var BF_SCOPE = "bf-s";
 var BF_SLOT = "bf";
@@ -656,6 +693,21 @@ function isInsideNestedCommentScope(element, scope) {
   }
   return false;
 }
+function isInsideNestedChildScope(element, root) {
+  let current = element;
+  while (current !== root) {
+    const parent = current.parentNode;
+    if (!parent)
+      return false;
+    if (parent !== root && parent.nodeType === Node.ELEMENT_NODE && parent.hasAttribute(BF_SCOPE)) {
+      return true;
+    }
+    if (isTopLevelCommentScopeNode(current))
+      return true;
+    current = parent;
+  }
+  return false;
+}
 function isTopLevelCommentScopeNode(node) {
   const parent = node.parentNode;
   if (!parent)
@@ -760,7 +812,14 @@ function qsa(el, selector) {
   }
   if (el.matches(selector))
     return el;
-  return el.querySelector(selector);
+  const first = el.querySelector(selector);
+  if (!first || !isInsideNestedChildScope(first, el))
+    return first;
+  for (const candidate of el.querySelectorAll(selector)) {
+    if (candidate !== first && !isInsideNestedChildScope(candidate, el))
+      return candidate;
+  }
+  return null;
 }
 function splitTopLevelCommas(selector) {
   const out = [];
@@ -2863,6 +2922,7 @@ export {
   getComponentProps,
   getComponentInit,
   forwardProps,
+  formatDate,
   flushHydration,
   findSiblingSlot,
   findScope,

package/dist/runtime/query.d.ts

@@ -61,6 +61,12 @@ export declare function findCondTarget(scope: Element, selector: string): Elemen
  * then its descendants. Unlike querySelector() which only searches descendants,
  * this also matches the root element.
  *
+ * Descendant candidates that fall inside a nested child component's own
+ * scope are skipped (`isInsideNestedChildScope`) — compiler slot IDs
+ * (`bf="sN"`) are assigned independently per component file, so a slot
+ * number can coincidentally collide between `el`'s own template and a
+ * child component mounted somewhere inside it (#2316).
+ *
  * Used by compiler-generated code for event binding and attribute updates
  * on loop items where the target may be the loop item's root element itself.
  */

package/dist/runtime/query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/runtime/query.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,sFAAsF;AACtF,eAAO,MAAM,SAAS,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAGJ,CAAA;AAqCnC;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,EACjC,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,GAAG,IAAI,CAoDhB;AAiLD;;;;;;;;;;GAUG;AACH,wBAAgB,IAAI,CAClB,KAAK,EAAE,OAAO,GAAG,IAAI,EACrB,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,OAAO,GACpB,OAAO,GAAG,IAAI,CAiChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAW/E;AAuBD;;;;;;;GAOG;AACH,wBAAgB,GAAG,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CA0BxE;AA+CD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAU9E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE,CAO1E;AAED;;;;;;;;GAQG;AACH,wBAAgB,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAO7E;AAED;;;;;GAKG;AACH,wBAAgB,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAE9E;AAkDD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,MAAM,EAAE,MAAM,GACb,OAAO,GAAG,IAAI,CAehB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAiB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,CAkBnE;AAyDD;;;;;;;GAOG;AACH,wBAAgB,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAkC3E;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAS3D;AAED,OAAO,EAAE,oBAAoB,IAAI,MAAM,EAAE,CAAA"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/runtime/query.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,sFAAsF;AACtF,eAAO,MAAM,SAAS,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAGJ,CAAA;AAqCnC;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,EACjC,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,GAAG,IAAI,CAoDhB;AA2ND;;;;;;;;;;GAUG;AACH,wBAAgB,IAAI,CAClB,KAAK,EAAE,OAAO,GAAG,IAAI,EACrB,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,OAAO,GACpB,OAAO,GAAG,IAAI,CAiChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAW/E;AAuBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,GAAG,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAsCxE;AA+CD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAU9E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE,CAO1E;AAED;;;;;;;;GAQG;AACH,wBAAgB,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAO7E;AAED;;;;;GAKG;AACH,wBAAgB,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAE9E;AAkDD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,MAAM,EAAE,MAAM,GACb,OAAO,GAAG,IAAI,CAehB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAiB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,CAkBnE;AAyDD;;;;;;;GAOG;AACH,wBAAgB,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAkC3E;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAS3D;AAED,OAAO,EAAE,oBAAoB,IAAI,MAAM,EAAE,CAAA"}

package/dist/runtime/standalone.js

@@ -815,6 +815,43 @@ function queryHref(base, params) {
   const qs = u.toString();
   return qs ? `${base}?${qs}` : base;
 }
+// src/format-date.ts
+var OFFSET_RE = /^([+-])(\d{2}):(\d{2})$/;
+var TOKEN_RE = /YYYY|MM|DD|M|D/g;
+function pad2(n) {
+  return String(n).padStart(2, "0");
+}
+function formatDate(date, pattern, timeZone = "UTC") {
+  if (date === null || date === undefined)
+    return "";
+  const d = date instanceof Date ? date : new Date(date);
+  const t = d.getTime();
+  if (Number.isNaN(t))
+    return "";
+  const m = OFFSET_RE.exec(timeZone);
+  const offsetMinutes = m ? (m[1] === "-" ? -1 : 1) * (Number(m[2]) * 60 + Number(m[3])) : 0;
+  const s = new Date(t + offsetMinutes * 60000);
+  const year = s.getUTCFullYear();
+  const yyyy = (year < 0 ? "-" : "") + String(Math.abs(year)).padStart(4, "0");
+  const month = s.getUTCMonth() + 1;
+  const day = s.getUTCDate();
+  return pattern.replace(TOKEN_RE, (token) => {
+    switch (token) {
+      case "YYYY":
+        return yyyy;
+      case "MM":
+        return pad2(month);
+      case "M":
+        return String(month);
+      case "DD":
+        return pad2(day);
+      case "D":
+        return String(day);
+      default:
+        return token;
+    }
+  });
+}
 // src/context.ts
 function createContext(defaultValue) {
   return {
@@ -1064,6 +1101,21 @@ function isInsideNestedCommentScope(element, scope) {
   }
   return false;
 }
+function isInsideNestedChildScope(element, root) {
+  let current = element;
+  while (current !== root) {
+    const parent = current.parentNode;
+    if (!parent)
+      return false;
+    if (parent !== root && parent.nodeType === Node.ELEMENT_NODE && parent.hasAttribute(BF_SCOPE)) {
+      return true;
+    }
+    if (isTopLevelCommentScopeNode(current))
+      return true;
+    current = parent;
+  }
+  return false;
+}
 function isTopLevelCommentScopeNode(node) {
   const parent = node.parentNode;
   if (!parent)
@@ -1168,7 +1220,14 @@ function qsa(el, selector) {
   }
   if (el.matches(selector))
     return el;
-  return el.querySelector(selector);
+  const first = el.querySelector(selector);
+  if (!first || !isInsideNestedChildScope(first, el))
+    return first;
+  for (const candidate of el.querySelectorAll(selector)) {
+    if (candidate !== first && !isInsideNestedChildScope(candidate, el))
+      return candidate;
+  }
+  return null;
 }
 function splitTopLevelCommas(selector) {
   const out = [];
@@ -3263,6 +3322,7 @@ export {
   getComponentProps,
   getComponentInit,
   forwardProps,
+  formatDate,
   flushHydration,
   findSiblingSlot,
   findScope,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@barefootjs/client",
-  "version": "0.21.3",
+  "version": "0.23.0",
   "description": "BarefootJS client package: reactive primitives (SSR-safe) plus browser runtime under the `/runtime` subpath (compiler target)",
   "type": "module",
   "main": "./dist/index.js",
@@ -55,7 +55,7 @@
     "directory": "packages/client"
   },
   "dependencies": {
-    "@barefootjs/shared": "0.21.3"
+    "@barefootjs/shared": "0.23.0"
   },
   "peerDependencies": {
     "@barefootjs/jsx": ">=0.2.0"

package/src/format-date.ts

@@ -0,0 +1,71 @@
+/**
+ * `formatDate` — format a `Date` (or ISO-8601 string) with an explicit pattern
+ * and an explicit UTC offset. The pure-function date formatter of #2324: every
+ * input is explicit, so the output is a deterministic function of its
+ * arguments — no host locale, no host timezone, no ICU/CLDR data. That is what
+ * lets the SSR adapters lower a `formatDate(...)` call to their native
+ * `format_date` runtime helper (spec/template-helpers.md) with byte-identical
+ * output on every backend.
+ *
+ * ```tsx
+ * <time>{formatDate(createdAt, 'YYYY/M/D', '+09:00')}</time>
+ * ```
+ *
+ * Pattern tokens (longest-match; any other character passes through
+ * literally): `YYYY` (4-digit zero-padded year, `-`-prefixed for negative
+ * years), `MM` / `M` (zero-padded / bare month `01`–`12` / `1`–`12`), `DD` /
+ * `D` (zero-padded / bare day of month). The v1 token set is date-only and
+ * numeric — locale-dependent fields (month names, weekday names) are a
+ * deliberate later stage of #2324, and per-locale *pattern selection* belongs
+ * to the app's i18n layer, not to this function.
+ *
+ * `timeZone` is `'UTC'` or a fixed offset `±HH:MM` (`'+09:00'`, `'-05:30'`).
+ * The function is total: any other value — including IANA zone names, which
+ * would drag host tzdata versions into the output — normalizes to `'UTC'`, so
+ * every backend degrades identically instead of diverging. An unset or
+ * unparseable `date` renders `''` (the same normative zero-value discipline as
+ * the `date` helper, spec/template-helpers.md).
+ */
+
+const OFFSET_RE = /^([+-])(\d{2}):(\d{2})$/
+const TOKEN_RE = /YYYY|MM|DD|M|D/g
+
+function pad2(n: number): string {
+  return String(n).padStart(2, '0')
+}
+
+export function formatDate(date: Date | string, pattern: string, timeZone = 'UTC'): string {
+  // Explicit nullish guard: `new Date(null)` is epoch 0, not Invalid Date,
+  // so without this a nil receiver would format 1970-01-01 instead of the
+  // contract's '' (spec/template-helpers.md "format_date", golden vector
+  // "nil receiver renders the empty string").
+  if (date === null || date === undefined) return ''
+  const d = date instanceof Date ? date : new Date(date)
+  const t = d.getTime()
+  if (Number.isNaN(t)) return ''
+  const m = OFFSET_RE.exec(timeZone)
+  const offsetMinutes = m ? (m[1] === '-' ? -1 : 1) * (Number(m[2]) * 60 + Number(m[3])) : 0
+  // Shift the instant by the offset, then read UTC fields: the shifted UTC
+  // clock face IS the local clock face at that offset.
+  const s = new Date(t + offsetMinutes * 60_000)
+  const year = s.getUTCFullYear()
+  const yyyy = (year < 0 ? '-' : '') + String(Math.abs(year)).padStart(4, '0')
+  const month = s.getUTCMonth() + 1
+  const day = s.getUTCDate()
+  return pattern.replace(TOKEN_RE, (token) => {
+    switch (token) {
+      case 'YYYY':
+        return yyyy
+      case 'MM':
+        return pad2(month)
+      case 'M':
+        return String(month)
+      case 'DD':
+        return pad2(day)
+      case 'D':
+        return String(day)
+      default:
+        return token
+    }
+  })
+}

package/src/index.ts

@@ -49,6 +49,7 @@ export { forwardProps } from './forward-props.ts'
 export { unwrap } from './unwrap.ts'
 
 export { queryHref, type QueryParams, type QueryParamValue } from './query-href.ts'
+export { formatDate } from './format-date.ts'
 
 export { createContext, type Context } from './context.ts'
 

package/src/runtime/index.ts

@@ -53,6 +53,7 @@ export { __slot, type SlotMarker } from '../slot.ts'
 export { forwardProps } from '../forward-props.ts'
 export { unwrap } from '../unwrap.ts'
 export { queryHref, type QueryParams, type QueryParamValue } from '../query-href.ts'
+export { formatDate } from '../format-date.ts'
 
 // Context API (real DOM-bound implementations; `createContext` is the
 // same pure function re-exported from `../context`).

package/src/runtime/query.ts

@@ -251,6 +251,48 @@ function isInsideNestedCommentScope(element: Element, scope: Element): boolean {
   return false
 }
 
+/**
+ * True if `element` sits inside a nested child component's own scope
+ * boundary somewhere on the path up to `root` — a plain `[bf-s]` element
+ * (a regular child component's root) or a fragment-rooted child's
+ * comment-scope range mounted as a sibling along that path.
+ *
+ * Generalizes `isInsideNestedCommentScope` (which only catches the
+ * comment-scope case) to also catch plain `bf-s` boundaries, for `qsa()`
+ * — the loose, unfiltered sibling of `find()`'s `belongsToScope`-gated
+ * search. Unlike `belongsToScope`, this walks up to `root` by object
+ * identity rather than requiring `root` itself to carry `bf-s`: `qsa()`'s
+ * roots include `insert()`'s whole-component branch scope (which does
+ * carry `bf-s`) but also loop-item template clones (which normally don't),
+ * so a `.closest('[bf-s]') === root` check can't be reused here.
+ *
+ * Without this, a slot number that happens to collide between a component
+ * and a nested child mounted earlier in its DOM (compiler slot IDs are
+ * assigned independently per component file, so collisions are expected)
+ * makes `qsa()` return the child's element instead of the component's own.
+ *
+ * Deliberately does NOT reject `element` itself for carrying `bf-s`
+ * (unlike `belongsToScope`'s own-scope check) — `qsa()` doubles as the
+ * lookup for a nested child component's *own* scope root (e.g. compiled
+ * `qsa(parentScope, '[bf-h="X"][bf-m="sN"], [bf-s$="_sN"]')` calls feeding
+ * `initChild()`), and that target legitimately carries `bf-s`. Only an
+ * *intermediate* `bf-s` between `element` and `root` — i.e. `element`
+ * nested inside some other, unrelated child scope — disqualifies it.
+ */
+function isInsideNestedChildScope(element: Element, root: Element): boolean {
+  let current: Node = element
+  while (current !== root) {
+    const parent: Node | null = current.parentNode
+    if (!parent) return false
+    if (parent !== root && parent.nodeType === Node.ELEMENT_NODE && (parent as Element).hasAttribute(BF_SCOPE)) {
+      return true
+    }
+    if (isTopLevelCommentScopeNode(current)) return true
+    current = parent
+  }
+  return false
+}
+
 /**
  * True if `node` falls inside a `<!--bf-scope:...-->` … `<!--bf-/scope:...-->`
  * range among its own siblings — i.e. `node` is (or is inside) a top-level
@@ -409,6 +451,12 @@ function findInPortals(scopeId: string, selector: string): Element | null {
  * then its descendants. Unlike querySelector() which only searches descendants,
  * this also matches the root element.
  *
+ * Descendant candidates that fall inside a nested child component's own
+ * scope are skipped (`isInsideNestedChildScope`) — compiler slot IDs
+ * (`bf="sN"`) are assigned independently per component file, so a slot
+ * number can coincidentally collide between `el`'s own template and a
+ * child component mounted somewhere inside it (#2316).
+ *
  * Used by compiler-generated code for event binding and attribute updates
  * on loop items where the target may be the loop item's root element itself.
  */
@@ -437,7 +485,19 @@ export function qsa(el: Element | null, selector: string): Element | null {
     return qsaChildScope(el, selector)
   }
   if (el.matches(selector)) return el
-  return el.querySelector(selector)
+
+  // Fast path: the overwhelmingly common case has no nested-child-scope
+  // collision, so a single querySelector() (matching the old behavior)
+  // resolves it without the cost of enumerating every match. Only fall
+  // back to the full querySelectorAll() scan — needed to skip past a
+  // rejected candidate to the next DOM-order match — when the first hit
+  // actually turns out to belong to a nested child scope.
+  const first = el.querySelector(selector)
+  if (!first || !isInsideNestedChildScope(first, el)) return first
+  for (const candidate of el.querySelectorAll(selector)) {
+    if (candidate !== first && !isInsideNestedChildScope(candidate, el)) return candidate
+  }
+  return null
 }
 
 /** Split a CSS selector list on top-level commas, ignoring commas inside