@barefootjs/client 0.23.0 → 0.25.0

package/dist/format-date.d.ts

@@ -9,22 +9,29 @@
  *
  * ```tsx
  * <time>{formatDate(createdAt, 'YYYY/M/D', '+09:00')}</time>
+ * <time>{formatDate(createdAt, 'MMMM D, YYYY', 'UTC', names)}</time>
  * ```
  *
- * Pattern tokens (longest-match; any other character passes through
+ * Numeric 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.
+ * `D` (zero-padded / bare day of month).
+ *
+ * Name tokens (#2334) read the explicit `names` table — the caller owns the
+ * values (per-locale name selection is the i18n layer's or the compiler's
+ * job, never this function's): `MMMM` / `MMM` (wide / abbreviated month
+ * name), `dddd` / `ddd` (wide / abbreviated weekday name, Sunday-first).
+ * `names` is a flat array in fixed layout: `[0..11]` wide months, `[12..23]`
+ * abbreviated months, `[24..30]` wide weekdays, `[31..37]` abbreviated
+ * weekdays. A name token indexing a missing/short table renders `''` — the
+ * same normative zero-value discipline as an unparseable date, byte-identical
+ * on every backend.
  *
  * `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).
+ * unparseable `date` renders `''`.
  */
-export declare function formatDate(date: Date | string, pattern: string, timeZone?: string): string;
+export declare function formatDate(date: Date | string, pattern: string, timeZone?: string, names?: readonly string[]): string;
 //# sourceMappingURL=format-date.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"format-date.d.ts","sourceRoot":"","sources":["../src/format-date.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAeH,wBAAgB,UAAU,CACxB,IAAI,EAAE,IAAI,GAAG,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,QAAQ,SAAQ,EAChB,KAAK,GAAE,SAAS,MAAM,EAAO,GAC5B,MAAM,CA4CR"}

package/dist/index.js

@@ -164,11 +164,15 @@ function queryHref(base, params) {
 }
 // src/format-date.ts
 var OFFSET_RE = /^([+-])(\d{2}):(\d{2})$/;
-var TOKEN_RE = /YYYY|MM|DD|M|D/g;
+var TOKEN_RE = /YYYY|MMMM|MMM|MM|DD|dddd|ddd|M|D/g;
+var MONTHS_WIDE = 0;
+var MONTHS_ABBR = 12;
+var WEEKDAYS_WIDE = 24;
+var WEEKDAYS_ABBR = 31;
 function pad2(n) {
   return String(n).padStart(2, "0");
 }
-function formatDate(date, pattern, timeZone = "UTC") {
+function formatDate(date, pattern, timeZone = "UTC", names = []) {
   if (date === null || date === undefined)
     return "";
   const d = date instanceof Date ? date : new Date(date);
@@ -182,10 +186,16 @@ function formatDate(date, pattern, timeZone = "UTC") {
   const yyyy = (year < 0 ? "-" : "") + String(Math.abs(year)).padStart(4, "0");
   const month = s.getUTCMonth() + 1;
   const day = s.getUTCDate();
+  const weekday = s.getUTCDay();
+  const nameAt = (index) => names[index] ?? "";
   return pattern.replace(TOKEN_RE, (token) => {
     switch (token) {
       case "YYYY":
         return yyyy;
+      case "MMMM":
+        return nameAt(MONTHS_WIDE + month - 1);
+      case "MMM":
+        return nameAt(MONTHS_ABBR + month - 1);
       case "MM":
         return pad2(month);
       case "M":
@@ -194,6 +204,10 @@ function formatDate(date, pattern, timeZone = "UTC") {
         return pad2(day);
       case "D":
         return String(day);
+      case "dddd":
+        return nameAt(WEEKDAYS_WIDE + weekday);
+      case "ddd":
+        return nameAt(WEEKDAYS_ABBR + weekday);
       default:
         return token;
     }

package/dist/runtime/index.js

@@ -164,11 +164,15 @@ function queryHref(base, params) {
 }
 // src/format-date.ts
 var OFFSET_RE = /^([+-])(\d{2}):(\d{2})$/;
-var TOKEN_RE = /YYYY|MM|DD|M|D/g;
+var TOKEN_RE = /YYYY|MMMM|MMM|MM|DD|dddd|ddd|M|D/g;
+var MONTHS_WIDE = 0;
+var MONTHS_ABBR = 12;
+var WEEKDAYS_WIDE = 24;
+var WEEKDAYS_ABBR = 31;
 function pad2(n) {
   return String(n).padStart(2, "0");
 }
-function formatDate(date, pattern, timeZone = "UTC") {
+function formatDate(date, pattern, timeZone = "UTC", names = []) {
   if (date === null || date === undefined)
     return "";
   const d = date instanceof Date ? date : new Date(date);
@@ -182,10 +186,16 @@ function formatDate(date, pattern, timeZone = "UTC") {
   const yyyy = (year < 0 ? "-" : "") + String(Math.abs(year)).padStart(4, "0");
   const month = s.getUTCMonth() + 1;
   const day = s.getUTCDate();
+  const weekday = s.getUTCDay();
+  const nameAt = (index) => names[index] ?? "";
   return pattern.replace(TOKEN_RE, (token) => {
     switch (token) {
       case "YYYY":
         return yyyy;
+      case "MMMM":
+        return nameAt(MONTHS_WIDE + month - 1);
+      case "MMM":
+        return nameAt(MONTHS_ABBR + month - 1);
       case "MM":
         return pad2(month);
       case "M":
@@ -194,6 +204,10 @@ function formatDate(date, pattern, timeZone = "UTC") {
         return pad2(day);
       case "D":
         return String(day);
+      case "dddd":
+        return nameAt(WEEKDAYS_WIDE + weekday);
+      case "ddd":
+        return nameAt(WEEKDAYS_ABBR + weekday);
       default:
         return token;
     }

package/dist/runtime/standalone.js

@@ -817,11 +817,15 @@ function queryHref(base, params) {
 }
 // src/format-date.ts
 var OFFSET_RE = /^([+-])(\d{2}):(\d{2})$/;
-var TOKEN_RE = /YYYY|MM|DD|M|D/g;
+var TOKEN_RE = /YYYY|MMMM|MMM|MM|DD|dddd|ddd|M|D/g;
+var MONTHS_WIDE = 0;
+var MONTHS_ABBR = 12;
+var WEEKDAYS_WIDE = 24;
+var WEEKDAYS_ABBR = 31;
 function pad2(n) {
   return String(n).padStart(2, "0");
 }
-function formatDate(date, pattern, timeZone = "UTC") {
+function formatDate(date, pattern, timeZone = "UTC", names = []) {
   if (date === null || date === undefined)
     return "";
   const d = date instanceof Date ? date : new Date(date);
@@ -835,10 +839,16 @@ function formatDate(date, pattern, timeZone = "UTC") {
   const yyyy = (year < 0 ? "-" : "") + String(Math.abs(year)).padStart(4, "0");
   const month = s.getUTCMonth() + 1;
   const day = s.getUTCDate();
+  const weekday = s.getUTCDay();
+  const nameAt = (index) => names[index] ?? "";
   return pattern.replace(TOKEN_RE, (token) => {
     switch (token) {
       case "YYYY":
         return yyyy;
+      case "MMMM":
+        return nameAt(MONTHS_WIDE + month - 1);
+      case "MMM":
+        return nameAt(MONTHS_ABBR + month - 1);
       case "MM":
         return pad2(month);
       case "M":
@@ -847,6 +857,10 @@ function formatDate(date, pattern, timeZone = "UTC") {
         return pad2(day);
       case "D":
         return String(day);
+      case "dddd":
+        return nameAt(WEEKDAYS_WIDE + weekday);
+      case "ddd":
+        return nameAt(WEEKDAYS_ABBR + weekday);
       default:
         return token;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@barefootjs/client",
-  "version": "0.23.0",
+  "version": "0.25.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.23.0"
+    "@barefootjs/shared": "0.25.0"
   },
   "peerDependencies": {
     "@barefootjs/jsx": ">=0.2.0"

package/src/format-date.ts

@@ -9,32 +9,50 @@
  *
  * ```tsx
  * <time>{formatDate(createdAt, 'YYYY/M/D', '+09:00')}</time>
+ * <time>{formatDate(createdAt, 'MMMM D, YYYY', 'UTC', names)}</time>
  * ```
  *
- * Pattern tokens (longest-match; any other character passes through
+ * Numeric 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.
+ * `D` (zero-padded / bare day of month).
+ *
+ * Name tokens (#2334) read the explicit `names` table — the caller owns the
+ * values (per-locale name selection is the i18n layer's or the compiler's
+ * job, never this function's): `MMMM` / `MMM` (wide / abbreviated month
+ * name), `dddd` / `ddd` (wide / abbreviated weekday name, Sunday-first).
+ * `names` is a flat array in fixed layout: `[0..11]` wide months, `[12..23]`
+ * abbreviated months, `[24..30]` wide weekdays, `[31..37]` abbreviated
+ * weekdays. A name token indexing a missing/short table renders `''` — the
+ * same normative zero-value discipline as an unparseable date, byte-identical
+ * on every backend.
  *
  * `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).
+ * unparseable `date` renders `''`.
  */
 
 const OFFSET_RE = /^([+-])(\d{2}):(\d{2})$/
-const TOKEN_RE = /YYYY|MM|DD|M|D/g
+const TOKEN_RE = /YYYY|MMMM|MMM|MM|DD|dddd|ddd|M|D/g
+
+/** `names`-table section offsets (spec/template-helpers.md "format_date"). */
+const MONTHS_WIDE = 0
+const MONTHS_ABBR = 12
+const WEEKDAYS_WIDE = 24
+const WEEKDAYS_ABBR = 31
 
 function pad2(n: number): string {
   return String(n).padStart(2, '0')
 }
 
-export function formatDate(date: Date | string, pattern: string, timeZone = 'UTC'): string {
+export function formatDate(
+  date: Date | string,
+  pattern: string,
+  timeZone = 'UTC',
+  names: readonly string[] = [],
+): 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
@@ -52,10 +70,16 @@ export function formatDate(date: Date | string, pattern: string, timeZone = 'UTC
   const yyyy = (year < 0 ? '-' : '') + String(Math.abs(year)).padStart(4, '0')
   const month = s.getUTCMonth() + 1
   const day = s.getUTCDate()
+  const weekday = s.getUTCDay() // 0 = Sunday, matching the table's Sunday-first layout
+  const nameAt = (index: number): string => names[index] ?? ''
   return pattern.replace(TOKEN_RE, (token) => {
     switch (token) {
       case 'YYYY':
         return yyyy
+      case 'MMMM':
+        return nameAt(MONTHS_WIDE + month - 1)
+      case 'MMM':
+        return nameAt(MONTHS_ABBR + month - 1)
       case 'MM':
         return pad2(month)
       case 'M':
@@ -64,6 +88,10 @@ export function formatDate(date: Date | string, pattern: string, timeZone = 'UTC
         return pad2(day)
       case 'D':
         return String(day)
+      case 'dddd':
+        return nameAt(WEEKDAYS_WIDE + weekday)
+      case 'ddd':
+        return nameAt(WEEKDAYS_ABBR + weekday)
       default:
         return token
     }