@barefootjs/client 0.21.4 → 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";
@@ -2885,6 +2922,7 @@ export {
   getComponentProps,
   getComponentInit,
   forwardProps,
+  formatDate,
   flushHydration,
   findSiblingSlot,
   findScope,

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 {
@@ -3285,6 +3322,7 @@ export {
   getComponentProps,
   getComponentInit,
   forwardProps,
+  formatDate,
   flushHydration,
   findSiblingSlot,
   findScope,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@barefootjs/client",
-  "version": "0.21.4",
+  "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.4"
+    "@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`).