@cdx-ui/formatters 0.0.1-beta.132

package/lib/module/dates/calendar/formatMonthCalendarYear.js

@@ -0,0 +1,12 @@
+"use strict";
+
+/**
+ * Formats a year label for month-calendar decade/year pickers.
+ *
+ * @param year - Four-digit year.
+ * @returns Year as a string.
+ */
+export function formatMonthCalendarYear(year) {
+  return String(year);
+}
+//# sourceMappingURL=formatMonthCalendarYear.js.map

package/lib/module/dates/calendar/formatMonthCalendarYear.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["formatMonthCalendarYear","year","String"],"sourceRoot":"../../../../src","sources":["dates/calendar/formatMonthCalendarYear.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASA,uBAAuBA,CAACC,IAAY,EAAU;EAC5D,OAAOC,MAAM,CAACD,IAAI,CAAC;AACrB","ignoreList":[]}

package/lib/module/dates/calendar/getCalendarWeekdayLabels.js

@@ -0,0 +1,19 @@
+"use strict";
+
+import { formatCalendarWeekday } from '../internal/calendarHelpers';
+/**
+ * Returns ordered weekday labels for a calendar week header.
+ *
+ * @param options - Locale, first day of week, and weekday width.
+ * @returns Array of seven weekday label strings.
+ */
+export function getCalendarWeekdayLabels(options) {
+  const firstDayOfWeek = options?.firstDayOfWeek ?? 0;
+  const labels = [];
+  for (let i = 0; i < 7; i += 1) {
+    const index = (firstDayOfWeek + i) % 7;
+    labels.push(formatCalendarWeekday(index, options));
+  }
+  return labels;
+}
+//# sourceMappingURL=getCalendarWeekdayLabels.js.map

package/lib/module/dates/calendar/getCalendarWeekdayLabels.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["formatCalendarWeekday","getCalendarWeekdayLabels","options","firstDayOfWeek","labels","i","index","push"],"sourceRoot":"../../../../src","sources":["dates/calendar/getCalendarWeekdayLabels.ts"],"mappings":";;AAAA,SAASA,qBAAqB,QAAQ,6BAA6B;AAGnE;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,wBAAwBA,CACtCC,OAGC,EACS;EACV,MAAMC,cAAc,GAAGD,OAAO,EAAEC,cAAc,IAAI,CAAC;EACnD,MAAMC,MAAgB,GAAG,EAAE;EAC3B,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAG,CAAC,EAAEA,CAAC,IAAI,CAAC,EAAE;IAC7B,MAAMC,KAAK,GAAG,CAACH,cAAc,GAAGE,CAAC,IAAI,CAAC;IACtCD,MAAM,CAACG,IAAI,CAACP,qBAAqB,CAACM,KAAK,EAAEJ,OAAO,CAAC,CAAC;EACpD;EACA,OAAOE,MAAM;AACf","ignoreList":[]}

package/lib/module/dates/datetime/clampDateTimeId.js

@@ -0,0 +1,24 @@
+"use strict";
+
+import { compareDateTimeIds } from './compareDateTimeIds';
+
+/**
+ * Clamps a wire date-time into the inclusive `[min, max]` range.
+ *
+ * Returns `min` when `value` is earlier than `min`, `max` when later than `max`,
+ * otherwise `value` unchanged. Omitted bounds are ignored.
+ *
+ * @param value - Wire date-time to clamp.
+ * @param bounds - Optional inclusive `min` / `max` wire date-times.
+ * @returns The clamped `DateTimeId`.
+ */
+export function clampDateTimeId(value, bounds) {
+  if (bounds.min && compareDateTimeIds(value, bounds.min) < 0) {
+    return bounds.min;
+  }
+  if (bounds.max && compareDateTimeIds(value, bounds.max) > 0) {
+    return bounds.max;
+  }
+  return value;
+}
+//# sourceMappingURL=clampDateTimeId.js.map

package/lib/module/dates/datetime/clampDateTimeId.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["compareDateTimeIds","clampDateTimeId","value","bounds","min","max"],"sourceRoot":"../../../../src","sources":["dates/datetime/clampDateTimeId.ts"],"mappings":";;AACA,SAASA,kBAAkB,QAAQ,sBAAsB;;AAEzD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,eAAeA,CAC7BC,KAAiB,EACjBC,MAA8C,EAClC;EACZ,IAAIA,MAAM,CAACC,GAAG,IAAIJ,kBAAkB,CAACE,KAAK,EAAEC,MAAM,CAACC,GAAG,CAAC,GAAG,CAAC,EAAE;IAC3D,OAAOD,MAAM,CAACC,GAAG;EACnB;EACA,IAAID,MAAM,CAACE,GAAG,IAAIL,kBAAkB,CAACE,KAAK,EAAEC,MAAM,CAACE,GAAG,CAAC,GAAG,CAAC,EAAE;IAC3D,OAAOF,MAAM,CAACE,GAAG;EACnB;EACA,OAAOH,KAAK;AACd","ignoreList":[]}

package/lib/module/dates/datetime/compareDateTimeIds.js

@@ -0,0 +1,24 @@
+"use strict";
+
+import { compareAsc, parseISO } from 'date-fns';
+/**
+ * Compares two wire date-times chronologically.
+ *
+ * Handles local (`YYYY-MM-DDTHH:MM`) and UTC (`…Z`) forms alike by parsing each
+ * to an absolute instant before comparing.
+ *
+ * @param a - First wire date-time.
+ * @param b - Second wire date-time.
+ * @returns `-1` if `a` is earlier, `1` if later, `0` if equal.
+ */
+export function compareDateTimeIds(a, b) {
+  const result = compareAsc(parseISO(a), parseISO(b));
+  if (result < 0) {
+    return -1;
+  }
+  if (result > 0) {
+    return 1;
+  }
+  return 0;
+}
+//# sourceMappingURL=compareDateTimeIds.js.map

package/lib/module/dates/datetime/compareDateTimeIds.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["compareAsc","parseISO","compareDateTimeIds","a","b","result"],"sourceRoot":"../../../../src","sources":["dates/datetime/compareDateTimeIds.ts"],"mappings":";;AAAA,SAASA,UAAU,EAAEC,QAAQ,QAAQ,UAAU;AAG/C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,kBAAkBA,CAACC,CAAa,EAAEC,CAAa,EAAc;EAC3E,MAAMC,MAAM,GAAGL,UAAU,CAACC,QAAQ,CAACE,CAAC,CAAC,EAAEF,QAAQ,CAACG,CAAC,CAAC,CAAC;EACnD,IAAIC,MAAM,GAAG,CAAC,EAAE;IACd,OAAO,CAAC,CAAC;EACX;EACA,IAAIA,MAAM,GAAG,CAAC,EAAE;IACd,OAAO,CAAC;EACV;EACA,OAAO,CAAC;AACV","ignoreList":[]}

package/lib/module/dates/datetime/dateTimeId.js

@@ -0,0 +1,35 @@
+"use strict";
+
+import { asDateTimeId } from '../internal/brand';
+import { formatDateTimeId } from './formatDateTimeId';
+import { isValidDateTimeId } from './isValidDateTimeId';
+
+/**
+ * Validating smart constructor for a wire {@link DateTimeId} (local ISO-like,
+ * e.g. `YYYY-MM-DDTHH:mm`).
+ *
+ * Accepts either a wire string or {@link DateTimeParts}. Throws `RangeError` on
+ * input that does not parse to a valid date-time.
+ *
+ * @param input - A wire date-time string or {@link DateTimeParts}.
+ * @returns The branded `DateTimeId`.
+ * @throws RangeError when the input is not a valid `DateTimeId`.
+ *
+ * @example
+ * dateTimeId('2026-08-07T14:30'); // DateTimeId
+ * dateTimeId({ year: 2026, month: 8, day: 7, hour: 14, minute: 30 }); // DateTimeId
+ */
+export function dateTimeId(input) {
+  if (typeof input === 'string') {
+    if (!isValidDateTimeId(input)) {
+      throw new RangeError(`Invalid DateTimeId: "${input}". Expected a wire date-time such as "YYYY-MM-DDTHH:mm".`);
+    }
+    return input;
+  }
+  const built = formatDateTimeId(input);
+  if (!isValidDateTimeId(built)) {
+    throw new RangeError(`Invalid DateTimeId parts: ${JSON.stringify(input)}.`);
+  }
+  return asDateTimeId(built);
+}
+//# sourceMappingURL=dateTimeId.js.map

package/lib/module/dates/datetime/dateTimeId.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["asDateTimeId","formatDateTimeId","isValidDateTimeId","dateTimeId","input","RangeError","built","JSON","stringify"],"sourceRoot":"../../../../src","sources":["dates/datetime/dateTimeId.ts"],"mappings":";;AAAA,SAASA,YAAY,QAAQ,mBAAmB;AAEhD,SAASC,gBAAgB,QAAQ,oBAAoB;AACrD,SAASC,iBAAiB,QAAQ,qBAAqB;;AAEvD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CAACC,KAA6B,EAAc;EACpE,IAAI,OAAOA,KAAK,KAAK,QAAQ,EAAE;IAC7B,IAAI,CAACF,iBAAiB,CAACE,KAAK,CAAC,EAAE;MAC7B,MAAM,IAAIC,UAAU,CAClB,wBAAwBD,KAAK,0DAC/B,CAAC;IACH;IACA,OAAOA,KAAK;EACd;EAEA,MAAME,KAAK,GAAGL,gBAAgB,CAACG,KAAK,CAAC;EACrC,IAAI,CAACF,iBAAiB,CAACI,KAAK,CAAC,EAAE;IAC7B,MAAM,IAAID,UAAU,CAAC,6BAA6BE,IAAI,CAACC,SAAS,CAACJ,KAAK,CAAC,GAAG,CAAC;EAC7E;EACA,OAAOJ,YAAY,CAACM,KAAK,CAAC;AAC5B","ignoreList":[]}

package/lib/module/dates/datetime/formatDateTimeId.js

@@ -0,0 +1,23 @@
+"use strict";
+
+import { asDateTimeId } from '../internal/brand';
+import { formatDateId } from '../wire/formatDateId';
+/**
+ * Builds a wire `DateTimeId` from parts. Local by default; pass `{ utc: true }` for ISO UTC.
+ *
+ * @param parts - Date and time parts.
+ * @param options - When `utc` is true, returns an ISO UTC string ending in `Z`.
+ * @returns Wire `DateTimeId` string.
+ */
+export function formatDateTimeId(parts, options) {
+  const date = options?.utc ? new Date(Date.UTC(parts.year, parts.month - 1, parts.day, parts.hour, parts.minute, parts.second ?? 0)) : new Date(parts.year, parts.month - 1, parts.day, parts.hour, parts.minute, parts.second ?? 0);
+  if (options?.utc) {
+    return asDateTimeId(date.toISOString());
+  }
+  const datePart = formatDateId(parts);
+  const hour = String(parts.hour).padStart(2, '0');
+  const minute = String(parts.minute).padStart(2, '0');
+  const second = parts.second != null ? `:${String(parts.second).padStart(2, '0')}` : '';
+  return asDateTimeId(`${datePart}T${hour}:${minute}${second}`);
+}
+//# sourceMappingURL=formatDateTimeId.js.map

package/lib/module/dates/datetime/formatDateTimeId.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["asDateTimeId","formatDateId","formatDateTimeId","parts","options","date","utc","Date","UTC","year","month","day","hour","minute","second","toISOString","datePart","String","padStart"],"sourceRoot":"../../../../src","sources":["dates/datetime/formatDateTimeId.ts"],"mappings":";;AAAA,SAASA,YAAY,QAAQ,mBAAmB;AAChD,SAASC,YAAY,QAAQ,sBAAsB;AAGnD;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAACC,KAAoB,EAAEC,OAA2B,EAAc;EAC9F,MAAMC,IAAI,GAAGD,OAAO,EAAEE,GAAG,GACrB,IAAIC,IAAI,CACNA,IAAI,CAACC,GAAG,CACNL,KAAK,CAACM,IAAI,EACVN,KAAK,CAACO,KAAK,GAAG,CAAC,EACfP,KAAK,CAACQ,GAAG,EACTR,KAAK,CAACS,IAAI,EACVT,KAAK,CAACU,MAAM,EACZV,KAAK,CAACW,MAAM,IAAI,CAClB,CACF,CAAC,GACD,IAAIP,IAAI,CAACJ,KAAK,CAACM,IAAI,EAAEN,KAAK,CAACO,KAAK,GAAG,CAAC,EAAEP,KAAK,CAACQ,GAAG,EAAER,KAAK,CAACS,IAAI,EAAET,KAAK,CAACU,MAAM,EAAEV,KAAK,CAACW,MAAM,IAAI,CAAC,CAAC;EAEjG,IAAIV,OAAO,EAAEE,GAAG,EAAE;IAChB,OAAON,YAAY,CAACK,IAAI,CAACU,WAAW,CAAC,CAAC,CAAC;EACzC;EAEA,MAAMC,QAAQ,GAAGf,YAAY,CAACE,KAAK,CAAC;EACpC,MAAMS,IAAI,GAAGK,MAAM,CAACd,KAAK,CAACS,IAAI,CAAC,CAACM,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;EAChD,MAAML,MAAM,GAAGI,MAAM,CAACd,KAAK,CAACU,MAAM,CAAC,CAACK,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;EACpD,MAAMJ,MAAM,GAAGX,KAAK,CAACW,MAAM,IAAI,IAAI,GAAG,IAAIG,MAAM,CAACd,KAAK,CAACW,MAAM,CAAC,CAACI,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE;EACtF,OAAOlB,YAAY,CAAC,GAAGgB,QAAQ,IAAIJ,IAAI,IAAIC,MAAM,GAAGC,MAAM,EAAE,CAAC;AAC/D","ignoreList":[]}

package/lib/module/dates/datetime/formatDateTimeListHour.js

@@ -0,0 +1,17 @@
+"use strict";
+
+/**
+ * Formats the hour label for a date-time list column.
+ *
+ * @param hour - Hour value (0–23).
+ * @param options - When `hour12` is true, returns 1–12 without leading zero.
+ * @returns Hour label string.
+ */
+export function formatDateTimeListHour(hour, options) {
+  if (options?.hour12) {
+    const h = hour % 12 || 12;
+    return String(h);
+  }
+  return String(hour).padStart(2, '0');
+}
+//# sourceMappingURL=formatDateTimeListHour.js.map

package/lib/module/dates/datetime/formatDateTimeListHour.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["formatDateTimeListHour","hour","options","hour12","h","String","padStart"],"sourceRoot":"../../../../src","sources":["dates/datetime/formatDateTimeListHour.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASA,sBAAsBA,CAACC,IAAY,EAAEC,OAA8B,EAAU;EAC3F,IAAIA,OAAO,EAAEC,MAAM,EAAE;IACnB,MAAMC,CAAC,GAAGH,IAAI,GAAG,EAAE,IAAI,EAAE;IACzB,OAAOI,MAAM,CAACD,CAAC,CAAC;EAClB;EACA,OAAOC,MAAM,CAACJ,IAAI,CAAC,CAACK,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;AACtC","ignoreList":[]}

package/lib/module/dates/datetime/formatDateTimeListMinute.js

@@ -0,0 +1,12 @@
+"use strict";
+
+/**
+ * Formats a zero-padded minute label for a date-time list column.
+ *
+ * @param minute - Minute value (0–59).
+ * @returns Two-digit minute string.
+ */
+export function formatDateTimeListMinute(minute) {
+  return String(minute).padStart(2, '0');
+}
+//# sourceMappingURL=formatDateTimeListMinute.js.map

package/lib/module/dates/datetime/formatDateTimeListMinute.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["formatDateTimeListMinute","minute","String","padStart"],"sourceRoot":"../../../../src","sources":["dates/datetime/formatDateTimeListMinute.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASA,wBAAwBA,CAACC,MAAc,EAAU;EAC/D,OAAOC,MAAM,CAACD,MAAM,CAAC,CAACE,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;AACxC","ignoreList":[]}

package/lib/module/dates/datetime/formatDateTimeListPeriod.js

@@ -0,0 +1,13 @@
+"use strict";
+
+import { formatDayPeriodFromHour } from '../internal/intlCopy';
+/**
+ * Returns the day-period label (AM/PM or locale equivalent) derived from a 0–23 hour value.
+ *
+ * @param hour - Hour value (0–23).
+ * @param options - Locale for the day-period label.
+ */
+export function formatDateTimeListPeriod(hour, options) {
+  return formatDayPeriodFromHour(hour, options?.locale);
+}
+//# sourceMappingURL=formatDateTimeListPeriod.js.map

package/lib/module/dates/datetime/formatDateTimeListPeriod.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["formatDayPeriodFromHour","formatDateTimeListPeriod","hour","options","locale"],"sourceRoot":"../../../../src","sources":["dates/datetime/formatDateTimeListPeriod.ts"],"mappings":";;AAAA,SAASA,uBAAuB,QAAQ,sBAAsB;AAG9D;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,wBAAwBA,CAACC,IAAY,EAAEC,OAA2B,EAAU;EAC1F,OAAOH,uBAAuB,CAACE,IAAI,EAAEC,OAAO,EAAEC,MAAM,CAAC;AACvD","ignoreList":[]}

package/lib/module/dates/datetime/isLocaleHour12.js

@@ -0,0 +1,26 @@
+"use strict";
+
+/**
+ * Whether the given locale conventionally uses a 12-hour clock (AM/PM).
+ *
+ * Derived from the locale's resolved hour cycle so date-time components can
+ * default their clock to the locale instead of hardcoding 12-hour. Pass an
+ * explicit `hour12` to override.
+ *
+ * @param locale - BCP-47 locale. Defaults to `en-US`.
+ * @returns `true` when the locale uses a 12-hour clock.
+ */
+export function isLocaleHour12(locale) {
+  try {
+    const resolved = new Intl.DateTimeFormat(locale ?? 'en-US', {
+      hour: 'numeric'
+    }).resolvedOptions();
+    if (typeof resolved.hour12 === 'boolean') {
+      return resolved.hour12;
+    }
+    return resolved.hourCycle === 'h11' || resolved.hourCycle === 'h12';
+  } catch {
+    return true;
+  }
+}
+//# sourceMappingURL=isLocaleHour12.js.map

package/lib/module/dates/datetime/isLocaleHour12.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isLocaleHour12","locale","resolved","Intl","DateTimeFormat","hour","resolvedOptions","hour12","hourCycle"],"sourceRoot":"../../../../src","sources":["dates/datetime/isLocaleHour12.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASA,cAAcA,CAACC,MAAe,EAAW;EACvD,IAAI;IACF,MAAMC,QAAQ,GAAG,IAAIC,IAAI,CAACC,cAAc,CAACH,MAAM,IAAI,OAAO,EAAE;MAC1DI,IAAI,EAAE;IACR,CAAC,CAAC,CAACC,eAAe,CAAC,CAA6C;IAChE,IAAI,OAAOJ,QAAQ,CAACK,MAAM,KAAK,SAAS,EAAE;MACxC,OAAOL,QAAQ,CAACK,MAAM;IACxB;IACA,OAAOL,QAAQ,CAACM,SAAS,KAAK,KAAK,IAAIN,QAAQ,CAACM,SAAS,KAAK,KAAK;EACrE,CAAC,CAAC,MAAM;IACN,OAAO,IAAI;EACb;AACF","ignoreList":[]}

package/lib/module/dates/datetime/isValidDateTimeId.js

@@ -0,0 +1,19 @@
+"use strict";
+
+import { isValid, parseISO } from 'date-fns';
+const LOCAL_DATE_TIME_PATTERN = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2})?$/;
+
+/**
+ * Type guard for local `DateTimeId` (`YYYY-MM-DDTHH:mm` or with seconds) and UTC `…Z` strings.
+ *
+ * @param dateTimeId - Candidate wire date-time string.
+ * @returns `true` when `dateTimeId` is a valid `DateTimeId`.
+ */
+export function isValidDateTimeId(dateTimeId) {
+  if (!LOCAL_DATE_TIME_PATTERN.test(dateTimeId) && !dateTimeId.endsWith('Z')) {
+    return false;
+  }
+  const parsed = parseISO(dateTimeId);
+  return isValid(parsed);
+}
+//# sourceMappingURL=isValidDateTimeId.js.map

package/lib/module/dates/datetime/isValidDateTimeId.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isValid","parseISO","LOCAL_DATE_TIME_PATTERN","isValidDateTimeId","dateTimeId","test","endsWith","parsed"],"sourceRoot":"../../../../src","sources":["dates/datetime/isValidDateTimeId.ts"],"mappings":";;AAAA,SAASA,OAAO,EAAEC,QAAQ,QAAQ,UAAU;AAG5C,MAAMC,uBAAuB,GAAG,0CAA0C;;AAE1E;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,iBAAiBA,CAACC,UAAkB,EAA4B;EAC9E,IAAI,CAACF,uBAAuB,CAACG,IAAI,CAACD,UAAU,CAAC,IAAI,CAACA,UAAU,CAACE,QAAQ,CAAC,GAAG,CAAC,EAAE;IAC1E,OAAO,KAAK;EACd;EACA,MAAMC,MAAM,GAAGN,QAAQ,CAACG,UAAU,CAAC;EACnC,OAAOJ,OAAO,CAACO,MAAM,CAAC;AACxB","ignoreList":[]}

package/lib/module/dates/datetime/nowDateTimeId.js

@@ -0,0 +1,54 @@
+"use strict";
+
+import { formatDateTimeId } from './formatDateTimeId';
+
+/**
+ * Returns the local device date/time as a `DateTimeId`, truncated to the requested granularity.
+ *
+ * @param options - Optional granularity; defaults to `'minute'`.
+ * @returns Wire `DateTimeId` for the current local time.
+ *
+ * @example
+ * nowDateTimeId({ granularity: 'minute' }) // '2026-07-28T14:30'
+ */
+export function nowDateTimeId(options) {
+  const now = new Date();
+  const parts = {
+    year: now.getFullYear(),
+    month: now.getMonth() + 1,
+    day: now.getDate(),
+    hour: now.getHours(),
+    minute: now.getMinutes(),
+    second: now.getSeconds()
+  };
+  switch (options?.granularity ?? 'minute') {
+    case 'day':
+      return formatDateTimeId({
+        year: parts.year,
+        month: parts.month,
+        day: parts.day,
+        hour: 0,
+        minute: 0
+      });
+    case 'hour':
+      return formatDateTimeId({
+        year: parts.year,
+        month: parts.month,
+        day: parts.day,
+        hour: parts.hour,
+        minute: 0
+      });
+    case 'minute':
+      return formatDateTimeId({
+        year: parts.year,
+        month: parts.month,
+        day: parts.day,
+        hour: parts.hour,
+        minute: parts.minute
+      });
+    case 'second':
+    default:
+      return formatDateTimeId(parts);
+  }
+}
+//# sourceMappingURL=nowDateTimeId.js.map

package/lib/module/dates/datetime/nowDateTimeId.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["formatDateTimeId","nowDateTimeId","options","now","Date","parts","year","getFullYear","month","getMonth","day","getDate","hour","getHours","minute","getMinutes","second","getSeconds","granularity"],"sourceRoot":"../../../../src","sources":["dates/datetime/nowDateTimeId.ts"],"mappings":";;AACA,SAASA,gBAAgB,QAAQ,oBAAoB;;AAErD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAACC,OAA+C,EAAc;EACzF,MAAMC,GAAG,GAAG,IAAIC,IAAI,CAAC,CAAC;EACtB,MAAMC,KAAoB,GAAG;IAC3BC,IAAI,EAAEH,GAAG,CAACI,WAAW,CAAC,CAAC;IACvBC,KAAK,EAAEL,GAAG,CAACM,QAAQ,CAAC,CAAC,GAAG,CAAC;IACzBC,GAAG,EAAEP,GAAG,CAACQ,OAAO,CAAC,CAAC;IAClBC,IAAI,EAAET,GAAG,CAACU,QAAQ,CAAC,CAAC;IACpBC,MAAM,EAAEX,GAAG,CAACY,UAAU,CAAC,CAAC;IACxBC,MAAM,EAAEb,GAAG,CAACc,UAAU,CAAC;EACzB,CAAC;EAED,QAAQf,OAAO,EAAEgB,WAAW,IAAI,QAAQ;IACtC,KAAK,KAAK;MACR,OAAOlB,gBAAgB,CAAC;QACtBM,IAAI,EAAED,KAAK,CAACC,IAAI;QAChBE,KAAK,EAAEH,KAAK,CAACG,KAAK;QAClBE,GAAG,EAAEL,KAAK,CAACK,GAAG;QACdE,IAAI,EAAE,CAAC;QACPE,MAAM,EAAE;MACV,CAAC,CAAC;IACJ,KAAK,MAAM;MACT,OAAOd,gBAAgB,CAAC;QACtBM,IAAI,EAAED,KAAK,CAACC,IAAI;QAChBE,KAAK,EAAEH,KAAK,CAACG,KAAK;QAClBE,GAAG,EAAEL,KAAK,CAACK,GAAG;QACdE,IAAI,EAAEP,KAAK,CAACO,IAAI;QAChBE,MAAM,EAAE;MACV,CAAC,CAAC;IACJ,KAAK,QAAQ;MACX,OAAOd,gBAAgB,CAAC;QACtBM,IAAI,EAAED,KAAK,CAACC,IAAI;QAChBE,KAAK,EAAEH,KAAK,CAACG,KAAK;QAClBE,GAAG,EAAEL,KAAK,CAACK,GAAG;QACdE,IAAI,EAAEP,KAAK,CAACO,IAAI;QAChBE,MAAM,EAAET,KAAK,CAACS;MAChB,CAAC,CAAC;IACJ,KAAK,QAAQ;IACb;MACE,OAAOd,gBAAgB,CAACK,KAAK,CAAC;EAClC;AACF","ignoreList":[]}

package/lib/module/dates/datetime/parseDateTimeId.js

@@ -0,0 +1,26 @@
+"use strict";
+
+import { parseISO } from 'date-fns';
+import { isValidDateTimeId } from './isValidDateTimeId';
+
+/**
+ * Parses a wire `DateTimeId` into numeric parts, or `null` when invalid.
+ *
+ * @param dateTimeId - Wire date-time string.
+ * @returns Parsed parts, or `null` when `dateTimeId` is invalid.
+ */
+export function parseDateTimeId(dateTimeId) {
+  if (!isValidDateTimeId(dateTimeId)) {
+    return null;
+  }
+  const date = parseISO(dateTimeId);
+  return {
+    year: date.getFullYear(),
+    month: date.getMonth() + 1,
+    day: date.getDate(),
+    hour: date.getHours(),
+    minute: date.getMinutes(),
+    second: date.getSeconds()
+  };
+}
+//# sourceMappingURL=parseDateTimeId.js.map

package/lib/module/dates/datetime/parseDateTimeId.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["parseISO","isValidDateTimeId","parseDateTimeId","dateTimeId","date","year","getFullYear","month","getMonth","day","getDate","hour","getHours","minute","getMinutes","second","getSeconds"],"sourceRoot":"../../../../src","sources":["dates/datetime/parseDateTimeId.ts"],"mappings":";;AAAA,SAASA,QAAQ,QAAQ,UAAU;AAEnC,SAASC,iBAAiB,QAAQ,qBAAqB;;AAEvD;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,eAAeA,CAACC,UAAsB,EAAwB;EAC5E,IAAI,CAACF,iBAAiB,CAACE,UAAU,CAAC,EAAE;IAClC,OAAO,IAAI;EACb;EACA,MAAMC,IAAI,GAAGJ,QAAQ,CAACG,UAAU,CAAC;EACjC,OAAO;IACLE,IAAI,EAAED,IAAI,CAACE,WAAW,CAAC,CAAC;IACxBC,KAAK,EAAEH,IAAI,CAACI,QAAQ,CAAC,CAAC,GAAG,CAAC;IAC1BC,GAAG,EAAEL,IAAI,CAACM,OAAO,CAAC,CAAC;IACnBC,IAAI,EAAEP,IAAI,CAACQ,QAAQ,CAAC,CAAC;IACrBC,MAAM,EAAET,IAAI,CAACU,UAAU,CAAC,CAAC;IACzBC,MAAM,EAAEX,IAAI,CAACY,UAAU,CAAC;EAC1B,CAAC;AACH","ignoreList":[]}

package/lib/module/dates/display/formatDateForDisplay.js

@@ -0,0 +1,24 @@
+"use strict";
+
+import { dateIdToNativeDate } from '../internal/dateIdToNativeDate';
+import { getCachedDateFormatter } from '../internal/intlCache';
+/**
+ * Formats a locale-aware date string for UI labels (never store the result in form state).
+ *
+ * @param dateId - Wire date string (`YYYY-MM-DD`).
+ * @param options - Locale, date style, and optional time zone.
+ * @returns Locale-formatted date string.
+ *
+ * @example
+ * formatDateForDisplay('2026-07-28', { locale: 'en-US' }) // e.g. '7/28/26'
+ */
+export function formatDateForDisplay(dateId, options) {
+  const formatter = getCachedDateFormatter(options?.locale ?? 'en-US', {
+    dateStyle: options?.dateStyle ?? 'short',
+    ...(options?.timeZone ? {
+      timeZone: options.timeZone
+    } : {})
+  });
+  return formatter.format(dateIdToNativeDate(dateId));
+}
+//# sourceMappingURL=formatDateForDisplay.js.map

package/lib/module/dates/display/formatDateForDisplay.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["dateIdToNativeDate","getCachedDateFormatter","formatDateForDisplay","dateId","options","formatter","locale","dateStyle","timeZone","format"],"sourceRoot":"../../../../src","sources":["dates/display/formatDateForDisplay.ts"],"mappings":";;AAAA,SAASA,kBAAkB,QAAQ,gCAAgC;AACnE,SAASC,sBAAsB,QAAQ,uBAAuB;AAG9D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,oBAAoBA,CAACC,MAAc,EAAEC,OAAkC,EAAU;EAC/F,MAAMC,SAAS,GAAGJ,sBAAsB,CAACG,OAAO,EAAEE,MAAM,IAAI,OAAO,EAAE;IACnEC,SAAS,EAAEH,OAAO,EAAEG,SAAS,IAAI,OAAO;IACxC,IAAIH,OAAO,EAAEI,QAAQ,GAAG;MAAEA,QAAQ,EAAEJ,OAAO,CAACI;IAAS,CAAC,GAAG,CAAC,CAAC;EAC7D,CAAC,CAAC;EACF,OAAOH,SAAS,CAACI,MAAM,CAACT,kBAAkB,CAACG,MAAM,CAAC,CAAC;AACrD","ignoreList":[]}

package/lib/module/dates/display/formatDateRangeForDisplay.js

@@ -0,0 +1,22 @@
+"use strict";
+
+import { getDateRangeSeparator } from '../internal/intlCopy';
+import { formatDateForDisplay } from './formatDateForDisplay';
+
+/**
+ * Formats an inclusive date range for display.
+ *
+ * @param range - Start and end wire date ids.
+ * @param options - Locale, separator, and display options passed to `formatDateForDisplay`.
+ * @returns Formatted range string.
+ *
+ * @example
+ * formatDateRangeForDisplay({ startId: '2026-07-01', endId: '2026-07-28' })
+ */
+export function formatDateRangeForDisplay(range, options) {
+  const separator = options?.rangeSeparator ?? getDateRangeSeparator(options?.locale);
+  const start = formatDateForDisplay(range.startId, options);
+  const end = formatDateForDisplay(range.endId, options);
+  return `${start}${separator}${end}`;
+}
+//# sourceMappingURL=formatDateRangeForDisplay.js.map

package/lib/module/dates/display/formatDateRangeForDisplay.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["getDateRangeSeparator","formatDateForDisplay","formatDateRangeForDisplay","range","options","separator","rangeSeparator","locale","start","startId","end","endId"],"sourceRoot":"../../../../src","sources":["dates/display/formatDateRangeForDisplay.ts"],"mappings":";;AAAA,SAASA,qBAAqB,QAAQ,sBAAsB;AAE5D,SAASC,oBAAoB,QAAQ,wBAAwB;;AAE7D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,yBAAyBA,CACvCC,KAAyC,EACzCC,OAAiC,EACzB;EACR,MAAMC,SAAS,GAAGD,OAAO,EAAEE,cAAc,IAAIN,qBAAqB,CAACI,OAAO,EAAEG,MAAM,CAAC;EACnF,MAAMC,KAAK,GAAGP,oBAAoB,CAACE,KAAK,CAACM,OAAO,EAAEL,OAAO,CAAC;EAC1D,MAAMM,GAAG,GAAGT,oBAAoB,CAACE,KAAK,CAACQ,KAAK,EAAEP,OAAO,CAAC;EACtD,OAAO,GAAGI,KAAK,GAAGH,SAAS,GAAGK,GAAG,EAAE;AACrC","ignoreList":[]}

package/lib/module/dates/display/formatDateTimeForDisplay.js

@@ -0,0 +1,30 @@
+"use strict";
+
+import { getCachedDateFormatter } from '../internal/intlCache';
+import { parseDateTimeId } from '../datetime/parseDateTimeId';
+/**
+ * Formats a locale-aware date-time string for UI labels.
+ *
+ * @param dateTimeId - Wire date-time string.
+ * @param options - Locale, date/time styles, and optional time zone.
+ * @returns Locale-formatted date-time string, or `''` when invalid.
+ *
+ * @example
+ * formatDateTimeForDisplay('2026-07-28T10:01', { locale: 'en-US' })
+ */
+export function formatDateTimeForDisplay(dateTimeId, options) {
+  const parts = parseDateTimeId(dateTimeId);
+  if (!parts) {
+    return '';
+  }
+  const date = new Date(parts.year, parts.month - 1, parts.day, parts.hour, parts.minute, parts.second ?? 0);
+  const formatter = getCachedDateFormatter(options?.locale ?? 'en-US', {
+    dateStyle: options?.dateStyle ?? 'medium',
+    timeStyle: options?.timeStyle ?? 'short',
+    ...(options?.timeZone ? {
+      timeZone: options.timeZone
+    } : {})
+  });
+  return formatter.format(date);
+}
+//# sourceMappingURL=formatDateTimeForDisplay.js.map

package/lib/module/dates/display/formatDateTimeForDisplay.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["getCachedDateFormatter","parseDateTimeId","formatDateTimeForDisplay","dateTimeId","options","parts","date","Date","year","month","day","hour","minute","second","formatter","locale","dateStyle","timeStyle","timeZone","format"],"sourceRoot":"../../../../src","sources":["dates/display/formatDateTimeForDisplay.ts"],"mappings":";;AAAA,SAASA,sBAAsB,QAAQ,uBAAuB;AAC9D,SAASC,eAAe,QAAQ,6BAA6B;AAG7D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,wBAAwBA,CACtCC,UAAsB,EACtBC,OAAsC,EAC9B;EACR,MAAMC,KAAK,GAAGJ,eAAe,CAACE,UAAU,CAAC;EACzC,IAAI,CAACE,KAAK,EAAE;IACV,OAAO,EAAE;EACX;EACA,MAAMC,IAAI,GAAG,IAAIC,IAAI,CACnBF,KAAK,CAACG,IAAI,EACVH,KAAK,CAACI,KAAK,GAAG,CAAC,EACfJ,KAAK,CAACK,GAAG,EACTL,KAAK,CAACM,IAAI,EACVN,KAAK,CAACO,MAAM,EACZP,KAAK,CAACQ,MAAM,IAAI,CAClB,CAAC;EACD,MAAMC,SAAS,GAAGd,sBAAsB,CAACI,OAAO,EAAEW,MAAM,IAAI,OAAO,EAAE;IACnEC,SAAS,EAAEZ,OAAO,EAAEY,SAAS,IAAI,QAAQ;IACzCC,SAAS,EAAEb,OAAO,EAAEa,SAAS,IAAI,OAAO;IACxC,IAAIb,OAAO,EAAEc,QAAQ,GAAG;MAAEA,QAAQ,EAAEd,OAAO,CAACc;IAAS,CAAC,GAAG,CAAC,CAAC;EAC7D,CAAC,CAAC;EACF,OAAOJ,SAAS,CAACK,MAAM,CAACb,IAAI,CAAC;AAC/B","ignoreList":[]}

package/lib/module/dates/display/formatMonthForDisplay.js

@@ -0,0 +1,29 @@
+"use strict";
+
+import { dateIdToNativeDate } from '../internal/dateIdToNativeDate';
+import { getCachedDateFormatter } from '../internal/intlCache';
+/**
+ * Formats a locale-aware month/year string for UI labels.
+ *
+ * @param monthId - Wire month string (`YYYY-MM-01`).
+ * @param options - Locale, date style, and optional time zone.
+ * @returns Locale-formatted month/year string.
+ *
+ * @example
+ * formatMonthForDisplay('2026-07-01', { locale: 'en-US' }) // e.g. '07/2026'
+ */
+export function formatMonthForDisplay(monthId, options) {
+  const formatter = getCachedDateFormatter(options?.locale ?? 'en-US', {
+    month: '2-digit',
+    year: 'numeric',
+    ...(options?.dateStyle === 'long' ? {
+      month: 'long',
+      year: 'numeric'
+    } : {}),
+    ...(options?.timeZone ? {
+      timeZone: options.timeZone
+    } : {})
+  });
+  return formatter.format(dateIdToNativeDate(monthId));
+}
+//# sourceMappingURL=formatMonthForDisplay.js.map

package/lib/module/dates/display/formatMonthForDisplay.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["dateIdToNativeDate","getCachedDateFormatter","formatMonthForDisplay","monthId","options","formatter","locale","month","year","dateStyle","timeZone","format"],"sourceRoot":"../../../../src","sources":["dates/display/formatMonthForDisplay.ts"],"mappings":";;AAAA,SAASA,kBAAkB,QAAQ,gCAAgC;AACnE,SAASC,sBAAsB,QAAQ,uBAAuB;AAG9D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,qBAAqBA,CACnCC,OAAgB,EAChBC,OAAkC,EAC1B;EACR,MAAMC,SAAS,GAAGJ,sBAAsB,CAACG,OAAO,EAAEE,MAAM,IAAI,OAAO,EAAE;IACnEC,KAAK,EAAE,SAAS;IAChBC,IAAI,EAAE,SAAS;IACf,IAAIJ,OAAO,EAAEK,SAAS,KAAK,MAAM,GAAG;MAAEF,KAAK,EAAE,MAAM;MAAEC,IAAI,EAAE;IAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5E,IAAIJ,OAAO,EAAEM,QAAQ,GAAG;MAAEA,QAAQ,EAAEN,OAAO,CAACM;IAAS,CAAC,GAAG,CAAC,CAAC;EAC7D,CAAC,CAAC;EACF,OAAOL,SAAS,CAACM,MAAM,CAACX,kBAAkB,CAACG,OAAO,CAAC,CAAC;AACtD","ignoreList":[]}

package/lib/module/dates/index.js

@@ -0,0 +1,59 @@
+"use strict";
+
+/**
+ * Date / date-time formatters.
+ *
+ * Wire ids (`DateId`, `MonthId`, `DateTimeId`) are fixed-format strings for state and APIs.
+ * Display helpers return locale-dependent strings for UI labels — never store those in form state.
+ */
+
+export { clampDateParts } from './wire/clampDateParts';
+export { clampMonthParts } from './wire/clampMonthParts';
+export { dateId } from './wire/dateId';
+export { monthId } from './wire/monthId';
+export { formatDateId } from './wire/formatDateId';
+export { formatMonthId } from './wire/formatMonthId';
+export { isValidDateId } from './wire/isValidDateId';
+export { isValidDateParts } from './wire/isValidDateParts';
+export { isValidMonthId } from './wire/isValidMonthId';
+export { isValidMonthParts } from './wire/isValidMonthParts';
+export { parseDateId } from './wire/parseDateId';
+export { parseMonthId } from './wire/parseMonthId';
+export { toMonthId } from './wire/toMonthId';
+export { todayDateId } from './wire/todayDateId';
+export { todayMonthId } from './wire/todayMonthId';
+export { clampDateTimeId } from './datetime/clampDateTimeId';
+export { compareDateTimeIds } from './datetime/compareDateTimeIds';
+export { dateTimeId } from './datetime/dateTimeId';
+export { formatDateTimeId } from './datetime/formatDateTimeId';
+export { isLocaleHour12 } from './datetime/isLocaleHour12';
+export { formatDateTimeListHour } from './datetime/formatDateTimeListHour';
+export { formatDateTimeListMinute } from './datetime/formatDateTimeListMinute';
+export { formatDateTimeListPeriod } from './datetime/formatDateTimeListPeriod';
+export { isValidDateTimeId } from './datetime/isValidDateTimeId';
+export { nowDateTimeId } from './datetime/nowDateTimeId';
+export { parseDateTimeId } from './datetime/parseDateTimeId';
+export { formatDateForDisplay } from './display/formatDateForDisplay';
+export { formatDateRangeForDisplay } from './display/formatDateRangeForDisplay';
+export { formatDateTimeForDisplay } from './display/formatDateTimeForDisplay';
+export { formatMonthForDisplay } from './display/formatMonthForDisplay';
+export { compareDateIds } from './ranges/compareDateIds';
+export { compareMonthIds } from './ranges/compareMonthIds';
+export { dateRangeAroundDay } from './ranges/dateRangeAroundDay';
+export { dateRangeFromLastNDays } from './ranges/dateRangeFromLastNDays';
+export { eachDateIdInRange } from './ranges/eachDateIdInRange';
+export { normalizeDateRange } from './ranges/normalizeDateRange';
+export { applyDateSegmentChange } from './segments/applyDateSegmentChange';
+export { formatDateSegment } from './segments/formatDateSegment';
+export { getDateFieldSegments } from './segments/getDateFieldSegments';
+export { getDateTimeFieldSegments } from './segments/getDateTimeFieldSegments';
+export { getDateTimeSegmentVisibility } from './segments/getDateTimeSegmentVisibility';
+export { getEmptyDateSegmentText } from './segments/getEmptyDateSegmentText';
+export { parseDateSegment } from './segments/parseDateSegment';
+export { formatCalendarMonthYear } from './calendar/formatCalendarMonthYear';
+export { formatDateTimeListDateRow } from './calendar/formatDateTimeListDateRow';
+export { formatMonthCalendarMonth } from './calendar/formatMonthCalendarMonth';
+export { formatMonthCalendarYear } from './calendar/formatMonthCalendarYear';
+export { getCalendarWeekdayLabels } from './calendar/getCalendarWeekdayLabels';
+export { DEFAULT_DATE_COMPONENT_LABELS, formatSelectYear, getDateSegmentAccessibilityLabel, resolveDateComponentLabels } from './labels/dateComponentLabels';
+//# sourceMappingURL=index.js.map

package/lib/module/dates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["clampDateParts","clampMonthParts","dateId","monthId","formatDateId","formatMonthId","isValidDateId","isValidDateParts","isValidMonthId","isValidMonthParts","parseDateId","parseMonthId","toMonthId","todayDateId","todayMonthId","clampDateTimeId","compareDateTimeIds","dateTimeId","formatDateTimeId","isLocaleHour12","formatDateTimeListHour","formatDateTimeListMinute","formatDateTimeListPeriod","isValidDateTimeId","nowDateTimeId","parseDateTimeId","formatDateForDisplay","formatDateRangeForDisplay","formatDateTimeForDisplay","formatMonthForDisplay","compareDateIds","compareMonthIds","dateRangeAroundDay","dateRangeFromLastNDays","eachDateIdInRange","normalizeDateRange","applyDateSegmentChange","formatDateSegment","getDateFieldSegments","getDateTimeFieldSegments","getDateTimeSegmentVisibility","getEmptyDateSegmentText","parseDateSegment","formatCalendarMonthYear","formatDateTimeListDateRow","formatMonthCalendarMonth","formatMonthCalendarYear","getCalendarWeekdayLabels","DEFAULT_DATE_COMPONENT_LABELS","formatSelectYear","getDateSegmentAccessibilityLabel","resolveDateComponentLabels"],"sourceRoot":"../../../src","sources":["dates/index.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;;AAoBA,SAASA,cAAc,QAAQ,uBAAuB;AACtD,SAASC,eAAe,QAAQ,wBAAwB;AACxD,SAASC,MAAM,QAAQ,eAAe;AACtC,SAASC,OAAO,QAAQ,gBAAgB;AACxC,SAASC,YAAY,QAAQ,qBAAqB;AAClD,SAASC,aAAa,QAAQ,sBAAsB;AACpD,SAASC,aAAa,QAAQ,sBAAsB;AACpD,SAASC,gBAAgB,QAAQ,yBAAyB;AAC1D,SAASC,cAAc,QAAQ,uBAAuB;AACtD,SAASC,iBAAiB,QAAQ,0BAA0B;AAC5D,SAASC,WAAW,QAAQ,oBAAoB;AAChD,SAASC,YAAY,QAAQ,qBAAqB;AAClD,SAASC,SAAS,QAAQ,kBAAkB;AAC5C,SAASC,WAAW,QAAQ,oBAAoB;AAChD,SAASC,YAAY,QAAQ,qBAAqB;AAElD,SAASC,eAAe,QAAQ,4BAA4B;AAC5D,SAASC,kBAAkB,QAAQ,+BAA+B;AAClE,SAASC,UAAU,QAAQ,uBAAuB;AAClD,SAASC,gBAAgB,QAAQ,6BAA6B;AAC9D,SAASC,cAAc,QAAQ,2BAA2B;AAC1D,SAASC,sBAAsB,QAAQ,mCAAmC;AAC1E,SAASC,wBAAwB,QAAQ,qCAAqC;AAC9E,SAASC,wBAAwB,QAAQ,qCAAqC;AAC9E,SAASC,iBAAiB,QAAQ,8BAA8B;AAChE,SAASC,aAAa,QAAQ,0BAA0B;AACxD,SAASC,eAAe,QAAQ,4BAA4B;AAE5D,SAASC,oBAAoB,QAAQ,gCAAgC;AACrE,SAASC,yBAAyB,QAAQ,qCAAqC;AAC/E,SAASC,wBAAwB,QAAQ,oCAAoC;AAC7E,SAASC,qBAAqB,QAAQ,iCAAiC;AAEvE,SAASC,cAAc,QAAQ,yBAAyB;AACxD,SAASC,eAAe,QAAQ,0BAA0B;AAC1D,SAASC,kBAAkB,QAAQ,6BAA6B;AAChE,SAASC,sBAAsB,QAAQ,iCAAiC;AACxE,SAASC,iBAAiB,QAAQ,4BAA4B;AAC9D,SAASC,kBAAkB,QAAQ,6BAA6B;AAEhE,SAASC,sBAAsB,QAAQ,mCAAmC;AAC1E,SAASC,iBAAiB,QAAQ,8BAA8B;AAChE,SAASC,oBAAoB,QAAQ,iCAAiC;AACtE,SAASC,wBAAwB,QAAQ,qCAAqC;AAC9E,SAASC,4BAA4B,QAAQ,yCAAyC;AACtF,SAASC,uBAAuB,QAAQ,oCAAoC;AAC5E,SAASC,gBAAgB,QAAQ,6BAA6B;AAE9D,SAASC,uBAAuB,QAAQ,oCAAoC;AAC5E,SAASC,yBAAyB,QAAQ,sCAAsC;AAChF,SAASC,wBAAwB,QAAQ,qCAAqC;AAC9E,SAASC,uBAAuB,QAAQ,oCAAoC;AAC5E,SAASC,wBAAwB,QAAQ,qCAAqC;AAG9E,SACEC,6BAA6B,EAC7BC,gBAAgB,EAChBC,gCAAgC,EAChCC,0BAA0B,QACrB,8BAA8B","ignoreList":[]}

package/lib/module/dates/internal/brand.js

@@ -0,0 +1,12 @@
+"use strict";
+
+/**
+ * @internal
+ * Unchecked brand casts for wire producers that have already guaranteed a
+ * well-formed wire string. Callers outside `@cdx-ui/formatters` must go through
+ * the validating smart constructors (`dateId`, `monthId`, `dateTimeId`) instead.
+ */
+export const asDateId = value => value;
+export const asMonthId = value => value;
+export const asDateTimeId = value => value;
+//# sourceMappingURL=brand.js.map

package/lib/module/dates/internal/brand.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["asDateId","value","asMonthId","asDateTimeId"],"sourceRoot":"../../../../src","sources":["dates/internal/brand.ts"],"mappings":";;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMA,QAAQ,GAAIC,KAAa,IAAaA,KAAe;AAClE,OAAO,MAAMC,SAAS,GAAID,KAAa,IAAcA,KAAgB;AACrE,OAAO,MAAME,YAAY,GAAIF,KAAa,IAAiBA,KAAmB","ignoreList":[]}

package/lib/module/dates/internal/calendarHelpers.js

@@ -0,0 +1,19 @@
+"use strict";
+
+import { getCachedDateFormatter } from './intlCache';
+
+/**
+ * @internal
+ */
+export function formatCalendarWeekday(weekdayIndex, options) {
+  // 2023-01-01 was a Sunday — index 0..6 maps Sun..Sat regardless of locale week start.
+  const ref = new Date(2023, 0, 1 + weekdayIndex);
+  const formatter = getCachedDateFormatter(options?.locale ?? 'en-US', {
+    weekday: options?.weekday ?? 'short',
+    ...(options?.timeZone ? {
+      timeZone: options.timeZone
+    } : {})
+  });
+  return formatter.format(ref);
+}
+//# sourceMappingURL=calendarHelpers.js.map

package/lib/module/dates/internal/calendarHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["getCachedDateFormatter","formatCalendarWeekday","weekdayIndex","options","ref","Date","formatter","locale","weekday","timeZone","format"],"sourceRoot":"../../../../src","sources":["dates/internal/calendarHelpers.ts"],"mappings":";;AACA,SAASA,sBAAsB,QAAQ,aAAa;;AAEpD;AACA;AACA;AACA,OAAO,SAASC,qBAAqBA,CACnCC,YAAoB,EACpBC,OAAuE,EAC/D;EACR;EACA,MAAMC,GAAG,GAAG,IAAIC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,GAAGH,YAAY,CAAC;EAC/C,MAAMI,SAAS,GAAGN,sBAAsB,CAACG,OAAO,EAAEI,MAAM,IAAI,OAAO,EAAE;IACnEC,OAAO,EAAEL,OAAO,EAAEK,OAAO,IAAI,OAAO;IACpC,IAAIL,OAAO,EAAEM,QAAQ,GAAG;MAAEA,QAAQ,EAAEN,OAAO,CAACM;IAAS,CAAC,GAAG,CAAC,CAAC;EAC7D,CAAC,CAAC;EACF,OAAOH,SAAS,CAACI,MAAM,CAACN,GAAG,CAAC;AAC9B","ignoreList":[]}