@cdx-ui/formatters 0.0.1-beta.132

package/lib/module/dates/segments/getDateTimeFieldSegments.js

@@ -0,0 +1,147 @@
+"use strict";
+
+import { formatDayPeriodFromHour } from '../internal/intlCopy';
+import { EMPTY_TIME_SEGMENT_TEXT, padSegment } from '../internal/segmentBuilders';
+import { formatDateId } from '../wire/formatDateId';
+import { isLocaleHour12 } from '../datetime/isLocaleHour12';
+import { parseDateTimeId } from '../datetime/parseDateTimeId';
+import { getDateFieldSegments } from './getDateFieldSegments';
+import { getDateTimeSegmentVisibility } from './getDateTimeSegmentVisibility';
+
+/**
+ * Builds ordered segments for a date-time field for the given granularity.
+ *
+ * @param value - Wire `DateTimeId`, or empty for placeholder segments.
+ * @param options - Granularity, locale, and 12/24-hour preference.
+ * @returns Ordered `DateSegment` array including date and time parts.
+ */
+export function getDateTimeFieldSegments(value, options) {
+  const parts = value ? parseDateTimeId(value) : null;
+  const locale = options.locale ?? 'en-US';
+  const hour12 = options.hour12 ?? isLocaleHour12(locale);
+  const segments = getDateFieldSegments(parts ? formatDateId(parts) : undefined, {
+    mode: 'date',
+    locale: options.locale
+  });
+  if (options.granularity === 'day') {
+    return segments;
+  }
+  const {
+    showMinute,
+    showSecond
+  } = getDateTimeSegmentVisibility(options.granularity);
+  if (!parts) {
+    segments.push({
+      type: 'literal',
+      text: ' ',
+      isEditable: false
+    });
+    segments.push({
+      type: 'hour',
+      text: hour12 ? EMPTY_TIME_SEGMENT_TEXT.hour : 'HH',
+      isEditable: true
+    });
+    if (showMinute) {
+      segments.push({
+        type: 'literal',
+        text: ':',
+        isEditable: false
+      });
+      segments.push({
+        type: 'minute',
+        text: EMPTY_TIME_SEGMENT_TEXT.minute,
+        isEditable: true
+      });
+    }
+    if (showSecond) {
+      segments.push({
+        type: 'literal',
+        text: ':',
+        isEditable: false
+      });
+      segments.push({
+        type: 'second',
+        text: EMPTY_TIME_SEGMENT_TEXT.second,
+        isEditable: true
+      });
+    }
+    if (hour12) {
+      segments.push({
+        type: 'literal',
+        text: ' ',
+        isEditable: false
+      });
+      segments.push({
+        type: 'dayPeriod',
+        text: EMPTY_TIME_SEGMENT_TEXT.dayPeriod,
+        isEditable: true
+      });
+    }
+    return segments;
+  }
+  const hour = parts.hour;
+  const minute = parts.minute;
+  segments.push({
+    type: 'literal',
+    text: ' ',
+    isEditable: false
+  });
+  if (hour12) {
+    const hour12Value = hour % 12 || 12;
+    segments.push({
+      type: 'hour',
+      text: String(hour12Value),
+      value: hour12Value,
+      isEditable: true
+    });
+  } else {
+    segments.push({
+      type: 'hour',
+      text: padSegment('hour', hour),
+      value: hour,
+      isEditable: true
+    });
+  }
+  if (showMinute) {
+    segments.push({
+      type: 'literal',
+      text: ':',
+      isEditable: false
+    });
+    segments.push({
+      type: 'minute',
+      text: padSegment('minute', minute),
+      value: minute,
+      isEditable: true
+    });
+  }
+  if (showSecond) {
+    segments.push({
+      type: 'literal',
+      text: ':',
+      isEditable: false
+    });
+    segments.push({
+      type: 'second',
+      text: padSegment('second', parts.second ?? 0),
+      value: parts.second ?? 0,
+      isEditable: true
+    });
+  }
+  if (hour12) {
+    const isPm = hour >= 12;
+    segments.push({
+      type: 'literal',
+      text: ' ',
+      isEditable: false
+    });
+    segments.push({
+      type: 'dayPeriod',
+      text: formatDayPeriodFromHour(isPm ? 13 : 9, locale),
+      value: isPm ? 1 : 0,
+      isEditable: true
+    });
+  }
+  return segments;
+}
+//# sourceMappingURL=getDateTimeFieldSegments.js.map

package/lib/module/dates/segments/getDateTimeFieldSegments.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["formatDayPeriodFromHour","EMPTY_TIME_SEGMENT_TEXT","padSegment","formatDateId","isLocaleHour12","parseDateTimeId","getDateFieldSegments","getDateTimeSegmentVisibility","getDateTimeFieldSegments","value","options","parts","locale","hour12","segments","undefined","mode","granularity","showMinute","showSecond","push","type","text","isEditable","hour","minute","second","dayPeriod","hour12Value","String","isPm"],"sourceRoot":"../../../../src","sources":["dates/segments/getDateTimeFieldSegments.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/dates/segments/getDateTimeSegmentVisibility.js

@@ -0,0 +1,11 @@
+"use strict";
+
+/** Which time segments/columns are visible for a given `DateTimeGranularity`. */
+export function getDateTimeSegmentVisibility(granularity) {
+  return {
+    showTime: granularity !== 'day',
+    showMinute: granularity === 'minute' || granularity === 'second',
+    showSecond: granularity === 'second'
+  };
+}
+//# sourceMappingURL=getDateTimeSegmentVisibility.js.map

package/lib/module/dates/segments/getDateTimeSegmentVisibility.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["getDateTimeSegmentVisibility","granularity","showTime","showMinute","showSecond"],"sourceRoot":"../../../../src","sources":["dates/segments/getDateTimeSegmentVisibility.ts"],"mappings":";;AAEA;AACA,OAAO,SAASA,4BAA4BA,CAACC,WAAgC,EAI3E;EACA,OAAO;IACLC,QAAQ,EAAED,WAAW,KAAK,KAAK;IAC/BE,UAAU,EAAEF,WAAW,KAAK,QAAQ,IAAIA,WAAW,KAAK,QAAQ;IAChEG,UAAU,EAAEH,WAAW,KAAK;EAC9B,CAAC;AACH","ignoreList":[]}

package/lib/module/dates/segments/getEmptyDateSegmentText.js

@@ -0,0 +1,13 @@
+"use strict";
+
+import { EMPTY_DATE_SEGMENT_TEXT } from '../internal/segmentBuilders';
+/**
+ * Returns placeholder text for an empty editable segment (e.g. `MM`, `DD`, `YYYY`).
+ *
+ * @param type - Segment type.
+ * @returns Placeholder string, or `''` for types without a placeholder.
+ */
+export function getEmptyDateSegmentText(type) {
+  return EMPTY_DATE_SEGMENT_TEXT[type] ?? '';
+}
+//# sourceMappingURL=getEmptyDateSegmentText.js.map

package/lib/module/dates/segments/getEmptyDateSegmentText.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["EMPTY_DATE_SEGMENT_TEXT","getEmptyDateSegmentText","type"],"sourceRoot":"../../../../src","sources":["dates/segments/getEmptyDateSegmentText.ts"],"mappings":";;AAAA,SAASA,uBAAuB,QAAQ,6BAA6B;AAGrE;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,uBAAuBA,CAACC,IAAqB,EAAU;EACrE,OAAOF,uBAAuB,CAACE,IAAI,CAAC,IAAI,EAAE;AAC5C","ignoreList":[]}

package/lib/module/dates/segments/parseDateSegment.js

@@ -0,0 +1,22 @@
+"use strict";
+
+/**
+ * Parses user-entered segment text into a number, or `null` when not parseable.
+ *
+ * @param type - Segment type being edited.
+ * @param text - Raw segment text from the field.
+ * @param _options - Reserved for future locale-aware parsing.
+ * @returns Parsed number, or `null` for empty or non-numeric input.
+ */
+export function parseDateSegment(type, text, _options) {
+  const trimmed = text.trim();
+  if (!trimmed || type === 'literal' || type === 'dayPeriod') {
+    return null;
+  }
+  const parsed = Number(trimmed);
+  if (Number.isNaN(parsed)) {
+    return null;
+  }
+  return parsed;
+}
+//# sourceMappingURL=parseDateSegment.js.map

package/lib/module/dates/segments/parseDateSegment.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["parseDateSegment","type","text","_options","trimmed","trim","parsed","Number","isNaN"],"sourceRoot":"../../../../src","sources":["dates/segments/parseDateSegment.ts"],"mappings":";;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASA,gBAAgBA,CAC9BC,IAAqB,EACrBC,IAAY,EACZC,QAA8B,EACf;EACf,MAAMC,OAAO,GAAGF,IAAI,CAACG,IAAI,CAAC,CAAC;EAC3B,IAAI,CAACD,OAAO,IAAIH,IAAI,KAAK,SAAS,IAAIA,IAAI,KAAK,WAAW,EAAE;IAC1D,OAAO,IAAI;EACb;EACA,MAAMK,MAAM,GAAGC,MAAM,CAACH,OAAO,CAAC;EAC9B,IAAIG,MAAM,CAACC,KAAK,CAACF,MAAM,CAAC,EAAE;IACxB,OAAO,IAAI;EACb;EACA,OAAOA,MAAM;AACf","ignoreList":[]}

package/lib/module/dates/types.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["dates/types.ts"],"mappings":"","ignoreList":[]}

package/lib/module/dates/wire/clampDateParts.js

@@ -0,0 +1,22 @@
+"use strict";
+
+import { clampDay, clampMonth } from '../internal/clampHelpers';
+/**
+ * Clamps date parts so month is 1–12 and day fits the month length (no `Date` rollover).
+ *
+ * @param parts - Year, month, and day values to clamp.
+ * @returns Clamped `DateParts` with a valid calendar day for the given month.
+ *
+ * @example
+ * clampDateParts({ year: 2026, month: 2, day: 31 }) // { year: 2026, month: 2, day: 28 }
+ */
+export function clampDateParts(parts) {
+  const month = clampMonth(parts.month);
+  const day = clampDay(parts.year, month, parts.day);
+  return {
+    year: parts.year,
+    month,
+    day
+  };
+}
+//# sourceMappingURL=clampDateParts.js.map

package/lib/module/dates/wire/clampDateParts.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["clampDay","clampMonth","clampDateParts","parts","month","day","year"],"sourceRoot":"../../../../src","sources":["dates/wire/clampDateParts.ts"],"mappings":";;AAAA,SAASA,QAAQ,EAAEC,UAAU,QAAQ,0BAA0B;AAG/D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAACC,KAAgB,EAAa;EAC1D,MAAMC,KAAK,GAAGH,UAAU,CAACE,KAAK,CAACC,KAAK,CAAC;EACrC,MAAMC,GAAG,GAAGL,QAAQ,CAACG,KAAK,CAACG,IAAI,EAAEF,KAAK,EAAED,KAAK,CAACE,GAAG,CAAC;EAClD,OAAO;IAAEC,IAAI,EAAEH,KAAK,CAACG,IAAI;IAAEF,KAAK;IAAEC;EAAI,CAAC;AACzC","ignoreList":[]}

package/lib/module/dates/wire/clampMonthParts.js

@@ -0,0 +1,19 @@
+"use strict";
+
+import { clampMonth } from '../internal/clampHelpers';
+/**
+ * Clamps month parts so month is between 1 and 12.
+ *
+ * @param parts - Year and month values to clamp.
+ * @returns Clamped `MonthParts`.
+ *
+ * @example
+ * clampMonthParts({ year: 2026, month: 13 }) // { year: 2026, month: 12 }
+ */
+export function clampMonthParts(parts) {
+  return {
+    year: parts.year,
+    month: clampMonth(parts.month)
+  };
+}
+//# sourceMappingURL=clampMonthParts.js.map

package/lib/module/dates/wire/clampMonthParts.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["clampMonth","clampMonthParts","parts","year","month"],"sourceRoot":"../../../../src","sources":["dates/wire/clampMonthParts.ts"],"mappings":";;AAAA,SAASA,UAAU,QAAQ,0BAA0B;AAGrD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,eAAeA,CAACC,KAAiB,EAAc;EAC7D,OAAO;IAAEC,IAAI,EAAED,KAAK,CAACC,IAAI;IAAEC,KAAK,EAAEJ,UAAU,CAACE,KAAK,CAACE,KAAK;EAAE,CAAC;AAC7D","ignoreList":[]}

package/lib/module/dates/wire/dateId.js

@@ -0,0 +1,47 @@
+"use strict";
+
+import { asDateId } from '../internal/brand';
+import { formatDateId } from './formatDateId';
+import { isValidDateId } from './isValidDateId';
+import { isValidDateParts } from './isValidDateParts';
+
+/**
+ * Validating smart constructor for a wire {@link DateId} (`YYYY-MM-DD`).
+ *
+ * Accepts either a wire string or numeric parts. Throws `RangeError` on input
+ * that is not a real calendar date — use this at the boundary where you first
+ * introduce a date value so a bad id never enters your form state.
+ *
+ * @param iso - A wire date string (`YYYY-MM-DD`).
+ * @returns The branded `DateId`.
+ * @throws RangeError when the string is not a valid `DateId`.
+ *
+ * @example
+ * dateId('2026-08-07'); // DateId
+ * dateId(2026, 8, 7);   // DateId
+ */
+
+/**
+ * @param year - Full year (e.g. `2026`).
+ * @param month - Month `1`–`12`.
+ * @param day - Day of month `1`–`31`.
+ */
+
+export function dateId(yearOrIso, month, day) {
+  if (typeof yearOrIso === 'string') {
+    if (!isValidDateId(yearOrIso)) {
+      throw new RangeError(`Invalid DateId: "${yearOrIso}". Expected a real calendar date as "YYYY-MM-DD".`);
+    }
+    return yearOrIso;
+  }
+  const parts = {
+    year: yearOrIso,
+    month: month ?? NaN,
+    day: day ?? NaN
+  };
+  if (!isValidDateParts(parts)) {
+    throw new RangeError(`Invalid DateId parts: ${JSON.stringify(parts)}.`);
+  }
+  return asDateId(formatDateId(parts));
+}
+//# sourceMappingURL=dateId.js.map

package/lib/module/dates/wire/dateId.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["asDateId","formatDateId","isValidDateId","isValidDateParts","dateId","yearOrIso","month","day","RangeError","parts","year","NaN","JSON","stringify"],"sourceRoot":"../../../../src","sources":["dates/wire/dateId.ts"],"mappings":";;AAAA,SAASA,QAAQ,QAAQ,mBAAmB;AAE5C,SAASC,YAAY,QAAQ,gBAAgB;AAC7C,SAASC,aAAa,QAAQ,iBAAiB;AAC/C,SAASC,gBAAgB,QAAQ,oBAAoB;;AAErD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;;AAEA,OAAO,SAASC,MAAMA,CAACC,SAA0B,EAAEC,KAAc,EAAEC,GAAY,EAAU;EACvF,IAAI,OAAOF,SAAS,KAAK,QAAQ,EAAE;IACjC,IAAI,CAACH,aAAa,CAACG,SAAS,CAAC,EAAE;MAC7B,MAAM,IAAIG,UAAU,CAClB,oBAAoBH,SAAS,mDAC/B,CAAC;IACH;IACA,OAAOA,SAAS;EAClB;EAEA,MAAMI,KAAK,GAAG;IAAEC,IAAI,EAAEL,SAAS;IAAEC,KAAK,EAAEA,KAAK,IAAIK,GAAG;IAAEJ,GAAG,EAAEA,GAAG,IAAII;EAAI,CAAC;EACvE,IAAI,CAACR,gBAAgB,CAACM,KAAK,CAAC,EAAE;IAC5B,MAAM,IAAID,UAAU,CAAC,yBAAyBI,IAAI,CAACC,SAAS,CAACJ,KAAK,CAAC,GAAG,CAAC;EACzE;EACA,OAAOT,QAAQ,CAACC,YAAY,CAACQ,KAAK,CAAC,CAAC;AACtC","ignoreList":[]}

package/lib/module/dates/wire/formatDateId.js

@@ -0,0 +1,22 @@
+"use strict";
+
+import { asDateId } from '../internal/brand';
+import { clampDateParts } from './clampDateParts';
+
+/**
+ * Builds a wire `DateId`, clamping day to the month length (no `Date` rollover).
+ *
+ * @param parts - Year, month, and day values.
+ * @returns Wire `DateId` string (`YYYY-MM-DD`).
+ *
+ * @example
+ * formatDateId({ year: 2026, month: 7, day: 28 }) // '2026-07-28'
+ */
+export function formatDateId(parts) {
+  const clamped = clampDateParts(parts);
+  const year = String(clamped.year).padStart(4, '0');
+  const month = String(clamped.month).padStart(2, '0');
+  const day = String(clamped.day).padStart(2, '0');
+  return asDateId(`${year}-${month}-${day}`);
+}
+//# sourceMappingURL=formatDateId.js.map

package/lib/module/dates/wire/formatDateId.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["asDateId","clampDateParts","formatDateId","parts","clamped","year","String","padStart","month","day"],"sourceRoot":"../../../../src","sources":["dates/wire/formatDateId.ts"],"mappings":";;AAAA,SAASA,QAAQ,QAAQ,mBAAmB;AAE5C,SAASC,cAAc,QAAQ,kBAAkB;;AAEjD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,YAAYA,CAACC,KAAgB,EAAU;EACrD,MAAMC,OAAO,GAAGH,cAAc,CAACE,KAAK,CAAC;EACrC,MAAME,IAAI,GAAGC,MAAM,CAACF,OAAO,CAACC,IAAI,CAAC,CAACE,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;EAClD,MAAMC,KAAK,GAAGF,MAAM,CAACF,OAAO,CAACI,KAAK,CAAC,CAACD,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;EACpD,MAAME,GAAG,GAAGH,MAAM,CAACF,OAAO,CAACK,GAAG,CAAC,CAACF,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;EAChD,OAAOP,QAAQ,CAAC,GAAGK,IAAI,IAAIG,KAAK,IAAIC,GAAG,EAAE,CAAC;AAC5C","ignoreList":[]}

package/lib/module/dates/wire/formatMonthId.js

@@ -0,0 +1,17 @@
+"use strict";
+
+import { format } from 'date-fns';
+import { asMonthId } from '../internal/brand';
+/**
+ * Builds a wire `MonthId` (`YYYY-MM-01`).
+ *
+ * @param parts - Year and month values.
+ * @returns Wire `MonthId` string.
+ *
+ * @example
+ * formatMonthId({ year: 2026, month: 7 }) // '2026-07-01'
+ */
+export function formatMonthId(parts) {
+  return asMonthId(format(new Date(parts.year, parts.month - 1, 1), 'yyyy-MM-dd'));
+}
+//# sourceMappingURL=formatMonthId.js.map

package/lib/module/dates/wire/formatMonthId.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["format","asMonthId","formatMonthId","parts","Date","year","month"],"sourceRoot":"../../../../src","sources":["dates/wire/formatMonthId.ts"],"mappings":";;AAAA,SAASA,MAAM,QAAQ,UAAU;AACjC,SAASC,SAAS,QAAQ,mBAAmB;AAG7C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAACC,KAAiB,EAAW;EACxD,OAAOF,SAAS,CAACD,MAAM,CAAC,IAAII,IAAI,CAACD,KAAK,CAACE,IAAI,EAAEF,KAAK,CAACG,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;AAClF","ignoreList":[]}

package/lib/module/dates/wire/isValidDateId.js

@@ -0,0 +1,23 @@
+"use strict";
+
+import { format, isValid, parse } from 'date-fns';
+const DATE_ID_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+
+/**
+ * Type guard for wire `DateId` strings (`YYYY-MM-DD`).
+ *
+ * @param dateId - Candidate wire date string.
+ * @returns `true` when `dateId` is a valid `DateId`.
+ *
+ * @example
+ * isValidDateId('2026-07-28') // true
+ * isValidDateId('07/28/2026') // false
+ */
+export function isValidDateId(dateId) {
+  if (!DATE_ID_PATTERN.test(dateId)) {
+    return false;
+  }
+  const parsed = parse(dateId, 'yyyy-MM-dd', new Date());
+  return isValid(parsed) && format(parsed, 'yyyy-MM-dd') === dateId;
+}
+//# sourceMappingURL=isValidDateId.js.map

package/lib/module/dates/wire/isValidDateId.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["format","isValid","parse","DATE_ID_PATTERN","isValidDateId","dateId","test","parsed","Date"],"sourceRoot":"../../../../src","sources":["dates/wire/isValidDateId.ts"],"mappings":";;AAAA,SAASA,MAAM,EAAEC,OAAO,EAAEC,KAAK,QAAQ,UAAU;AAGjD,MAAMC,eAAe,GAAG,qBAAqB;;AAE7C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAACC,MAAc,EAAoB;EAC9D,IAAI,CAACF,eAAe,CAACG,IAAI,CAACD,MAAM,CAAC,EAAE;IACjC,OAAO,KAAK;EACd;EACA,MAAME,MAAM,GAAGL,KAAK,CAACG,MAAM,EAAE,YAAY,EAAE,IAAIG,IAAI,CAAC,CAAC,CAAC;EACtD,OAAOP,OAAO,CAACM,MAAM,CAAC,IAAIP,MAAM,CAACO,MAAM,EAAE,YAAY,CAAC,KAAKF,MAAM;AACnE","ignoreList":[]}

package/lib/module/dates/wire/isValidDateParts.js

@@ -0,0 +1,14 @@
+"use strict";
+
+import { partsToDate } from '../internal/clampHelpers';
+/**
+ * Returns whether the given parts form a valid calendar date.
+ *
+ * @param parts - Year, month, and day values to validate.
+ * @returns `true` when the parts match a real calendar date.
+ */
+export function isValidDateParts(parts) {
+  const date = partsToDate(parts);
+  return date.getFullYear() === parts.year && date.getMonth() === parts.month - 1 && date.getDate() === parts.day;
+}
+//# sourceMappingURL=isValidDateParts.js.map

package/lib/module/dates/wire/isValidDateParts.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["partsToDate","isValidDateParts","parts","date","getFullYear","year","getMonth","month","getDate","day"],"sourceRoot":"../../../../src","sources":["dates/wire/isValidDateParts.ts"],"mappings":";;AAAA,SAASA,WAAW,QAAQ,0BAA0B;AAGtD;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAACC,KAAgB,EAAW;EAC1D,MAAMC,IAAI,GAAGH,WAAW,CAACE,KAAK,CAAC;EAC/B,OACEC,IAAI,CAACC,WAAW,CAAC,CAAC,KAAKF,KAAK,CAACG,IAAI,IACjCF,IAAI,CAACG,QAAQ,CAAC,CAAC,KAAKJ,KAAK,CAACK,KAAK,GAAG,CAAC,IACnCJ,IAAI,CAACK,OAAO,CAAC,CAAC,KAAKN,KAAK,CAACO,GAAG;AAEhC","ignoreList":[]}

package/lib/module/dates/wire/isValidMonthId.js

@@ -0,0 +1,23 @@
+"use strict";
+
+import { format, isValid, parse } from 'date-fns';
+const MONTH_ID_PATTERN = /^\d{4}-\d{2}-01$/;
+
+/**
+ * Type guard for wire `MonthId` strings (`YYYY-MM-01`).
+ *
+ * @param monthId - Candidate wire month string.
+ * @returns `true` when `monthId` is a valid `MonthId`.
+ *
+ * @example
+ * isValidMonthId('2026-07-01') // true
+ * isValidMonthId('2026-07-15') // false
+ */
+export function isValidMonthId(monthId) {
+  if (!MONTH_ID_PATTERN.test(monthId)) {
+    return false;
+  }
+  const parsed = parse(monthId, 'yyyy-MM-dd', new Date());
+  return isValid(parsed) && format(parsed, 'yyyy-MM-dd') === monthId;
+}
+//# sourceMappingURL=isValidMonthId.js.map

package/lib/module/dates/wire/isValidMonthId.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["format","isValid","parse","MONTH_ID_PATTERN","isValidMonthId","monthId","test","parsed","Date"],"sourceRoot":"../../../../src","sources":["dates/wire/isValidMonthId.ts"],"mappings":";;AAAA,SAASA,MAAM,EAAEC,OAAO,EAAEC,KAAK,QAAQ,UAAU;AAGjD,MAAMC,gBAAgB,GAAG,kBAAkB;;AAE3C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAACC,OAAe,EAAsB;EAClE,IAAI,CAACF,gBAAgB,CAACG,IAAI,CAACD,OAAO,CAAC,EAAE;IACnC,OAAO,KAAK;EACd;EACA,MAAME,MAAM,GAAGL,KAAK,CAACG,OAAO,EAAE,YAAY,EAAE,IAAIG,IAAI,CAAC,CAAC,CAAC;EACvD,OAAOP,OAAO,CAACM,MAAM,CAAC,IAAIP,MAAM,CAACO,MAAM,EAAE,YAAY,CAAC,KAAKF,OAAO;AACpE","ignoreList":[]}

package/lib/module/dates/wire/isValidMonthParts.js

@@ -0,0 +1,12 @@
+"use strict";
+
+/**
+ * Returns whether the given parts form a valid month (1–12).
+ *
+ * @param parts - Year and month values to validate.
+ * @returns `true` when month is between 1 and 12.
+ */
+export function isValidMonthParts(parts) {
+  return parts.month >= 1 && parts.month <= 12;
+}
+//# sourceMappingURL=isValidMonthParts.js.map

package/lib/module/dates/wire/isValidMonthParts.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isValidMonthParts","parts","month"],"sourceRoot":"../../../../src","sources":["dates/wire/isValidMonthParts.ts"],"mappings":";;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASA,iBAAiBA,CAACC,KAAiB,EAAW;EAC5D,OAAOA,KAAK,CAACC,KAAK,IAAI,CAAC,IAAID,KAAK,CAACC,KAAK,IAAI,EAAE;AAC9C","ignoreList":[]}

package/lib/module/dates/wire/monthId.js

@@ -0,0 +1,44 @@
+"use strict";
+
+import { asMonthId } from '../internal/brand';
+import { formatMonthId } from './formatMonthId';
+import { isValidMonthId } from './isValidMonthId';
+import { isValidMonthParts } from './isValidMonthParts';
+
+/**
+ * Validating smart constructor for a wire {@link MonthId} (`YYYY-MM-01`).
+ *
+ * Accepts either a wire string or numeric parts. Throws `RangeError` on input
+ * that is not a valid month.
+ *
+ * @param iso - A wire month string (`YYYY-MM-01`).
+ * @returns The branded `MonthId`.
+ * @throws RangeError when the string is not a valid `MonthId`.
+ *
+ * @example
+ * monthId('2026-08-01'); // MonthId
+ * monthId(2026, 8);      // MonthId
+ */
+
+/**
+ * @param year - Full year (e.g. `2026`).
+ * @param month - Month `1`–`12`.
+ */
+
+export function monthId(yearOrIso, month) {
+  if (typeof yearOrIso === 'string') {
+    if (!isValidMonthId(yearOrIso)) {
+      throw new RangeError(`Invalid MonthId: "${yearOrIso}". Expected the first of a month as "YYYY-MM-01".`);
+    }
+    return yearOrIso;
+  }
+  const parts = {
+    year: yearOrIso,
+    month: month ?? NaN
+  };
+  if (!isValidMonthParts(parts)) {
+    throw new RangeError(`Invalid MonthId parts: ${JSON.stringify(parts)}. Month must be 1–12.`);
+  }
+  return asMonthId(formatMonthId(parts));
+}
+//# sourceMappingURL=monthId.js.map

package/lib/module/dates/wire/monthId.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["asMonthId","formatMonthId","isValidMonthId","isValidMonthParts","monthId","yearOrIso","month","RangeError","parts","year","NaN","JSON","stringify"],"sourceRoot":"../../../../src","sources":["dates/wire/monthId.ts"],"mappings":";;AAAA,SAASA,SAAS,QAAQ,mBAAmB;AAE7C,SAASC,aAAa,QAAQ,iBAAiB;AAC/C,SAASC,cAAc,QAAQ,kBAAkB;AACjD,SAASC,iBAAiB,QAAQ,qBAAqB;;AAEvD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;;AAEA,OAAO,SAASC,OAAOA,CAACC,SAA0B,EAAEC,KAAc,EAAW;EAC3E,IAAI,OAAOD,SAAS,KAAK,QAAQ,EAAE;IACjC,IAAI,CAACH,cAAc,CAACG,SAAS,CAAC,EAAE;MAC9B,MAAM,IAAIE,UAAU,CAClB,qBAAqBF,SAAS,mDAChC,CAAC;IACH;IACA,OAAOA,SAAS;EAClB;EAEA,MAAMG,KAAK,GAAG;IAAEC,IAAI,EAAEJ,SAAS;IAAEC,KAAK,EAAEA,KAAK,IAAII;EAAI,CAAC;EACtD,IAAI,CAACP,iBAAiB,CAACK,KAAK,CAAC,EAAE;IAC7B,MAAM,IAAID,UAAU,CAAC,0BAA0BI,IAAI,CAACC,SAAS,CAACJ,KAAK,CAAC,uBAAuB,CAAC;EAC9F;EACA,OAAOR,SAAS,CAACC,aAAa,CAACO,KAAK,CAAC,CAAC;AACxC","ignoreList":[]}

package/lib/module/dates/wire/parseDateId.js

@@ -0,0 +1,26 @@
+"use strict";
+
+import { dateIdToNativeDate } from '../internal/dateIdToNativeDate';
+import { isValidDateId } from './isValidDateId';
+
+/**
+ * Parses a wire `DateId` into numeric parts, or `null` when invalid.
+ *
+ * @param dateId - Wire date string (`YYYY-MM-DD`).
+ * @returns Parsed parts, or `null` when `dateId` is invalid.
+ *
+ * @example
+ * parseDateId('2026-07-28') // { year: 2026, month: 7, day: 28 }
+ */
+export function parseDateId(dateId) {
+  if (!isValidDateId(dateId)) {
+    return null;
+  }
+  const date = dateIdToNativeDate(dateId);
+  return {
+    year: date.getFullYear(),
+    month: date.getMonth() + 1,
+    day: date.getDate()
+  };
+}
+//# sourceMappingURL=parseDateId.js.map

package/lib/module/dates/wire/parseDateId.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["dateIdToNativeDate","isValidDateId","parseDateId","dateId","date","year","getFullYear","month","getMonth","day","getDate"],"sourceRoot":"../../../../src","sources":["dates/wire/parseDateId.ts"],"mappings":";;AAAA,SAASA,kBAAkB,QAAQ,gCAAgC;AAEnE,SAASC,aAAa,QAAQ,iBAAiB;;AAE/C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,WAAWA,CAACC,MAAc,EAAoB;EAC5D,IAAI,CAACF,aAAa,CAACE,MAAM,CAAC,EAAE;IAC1B,OAAO,IAAI;EACb;EACA,MAAMC,IAAI,GAAGJ,kBAAkB,CAACG,MAAM,CAAC;EACvC,OAAO;IAAEE,IAAI,EAAED,IAAI,CAACE,WAAW,CAAC,CAAC;IAAEC,KAAK,EAAEH,IAAI,CAACI,QAAQ,CAAC,CAAC,GAAG,CAAC;IAAEC,GAAG,EAAEL,IAAI,CAACM,OAAO,CAAC;EAAE,CAAC;AACtF","ignoreList":[]}

package/lib/module/dates/wire/parseMonthId.js

@@ -0,0 +1,25 @@
+"use strict";
+
+import { dateIdToNativeDate } from '../internal/dateIdToNativeDate';
+import { isValidMonthId } from './isValidMonthId';
+
+/**
+ * Parses a wire `MonthId` into numeric parts, or `null` when invalid.
+ *
+ * @param monthId - Wire month string (`YYYY-MM-01`).
+ * @returns Parsed parts, or `null` when `monthId` is invalid.
+ *
+ * @example
+ * parseMonthId('2026-07-01') // { year: 2026, month: 7 }
+ */
+export function parseMonthId(monthId) {
+  if (!isValidMonthId(monthId)) {
+    return null;
+  }
+  const date = dateIdToNativeDate(monthId);
+  return {
+    year: date.getFullYear(),
+    month: date.getMonth() + 1
+  };
+}
+//# sourceMappingURL=parseMonthId.js.map

package/lib/module/dates/wire/parseMonthId.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["dateIdToNativeDate","isValidMonthId","parseMonthId","monthId","date","year","getFullYear","month","getMonth"],"sourceRoot":"../../../../src","sources":["dates/wire/parseMonthId.ts"],"mappings":";;AAAA,SAASA,kBAAkB,QAAQ,gCAAgC;AAEnE,SAASC,cAAc,QAAQ,kBAAkB;;AAEjD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,YAAYA,CAACC,OAAgB,EAAqB;EAChE,IAAI,CAACF,cAAc,CAACE,OAAO,CAAC,EAAE;IAC5B,OAAO,IAAI;EACb;EACA,MAAMC,IAAI,GAAGJ,kBAAkB,CAACG,OAAO,CAAC;EACxC,OAAO;IAAEE,IAAI,EAAED,IAAI,CAACE,WAAW,CAAC,CAAC;IAAEC,KAAK,EAAEH,IAAI,CAACI,QAAQ,CAAC,CAAC,GAAG;EAAE,CAAC;AACjE","ignoreList":[]}

package/lib/module/dates/wire/toMonthId.js

@@ -0,0 +1,18 @@
+"use strict";
+
+import { format, startOfMonth } from 'date-fns';
+import { asMonthId } from '../internal/brand';
+import { dateIdToNativeDate } from '../internal/dateIdToNativeDate';
+/**
+ * Truncates a `DateId` to its month wire id.
+ *
+ * @param dateId - Wire date string.
+ * @returns Wire `MonthId` for the same calendar month.
+ *
+ * @example
+ * toMonthId('2026-07-28') // '2026-07-01'
+ */
+export function toMonthId(dateId) {
+  return asMonthId(format(startOfMonth(dateIdToNativeDate(dateId)), 'yyyy-MM-dd'));
+}
+//# sourceMappingURL=toMonthId.js.map

package/lib/module/dates/wire/toMonthId.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["format","startOfMonth","asMonthId","dateIdToNativeDate","toMonthId","dateId"],"sourceRoot":"../../../../src","sources":["dates/wire/toMonthId.ts"],"mappings":";;AAAA,SAASA,MAAM,EAAEC,YAAY,QAAQ,UAAU;AAC/C,SAASC,SAAS,QAAQ,mBAAmB;AAC7C,SAASC,kBAAkB,QAAQ,gCAAgC;AAGnE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,SAASA,CAACC,MAAc,EAAW;EACjD,OAAOH,SAAS,CAACF,MAAM,CAACC,YAAY,CAACE,kBAAkB,CAACE,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;AAClF","ignoreList":[]}

package/lib/module/dates/wire/todayDateId.js

@@ -0,0 +1,13 @@
+"use strict";
+
+import { format } from 'date-fns';
+import { asDateId } from '../internal/brand';
+/**
+ * Returns the device-local calendar date as a wire `DateId`.
+ *
+ * @returns Today's date as `YYYY-MM-DD`.
+ */
+export function todayDateId() {
+  return asDateId(format(new Date(), 'yyyy-MM-dd'));
+}
+//# sourceMappingURL=todayDateId.js.map

package/lib/module/dates/wire/todayDateId.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["format","asDateId","todayDateId","Date"],"sourceRoot":"../../../../src","sources":["dates/wire/todayDateId.ts"],"mappings":";;AAAA,SAASA,MAAM,QAAQ,UAAU;AACjC,SAASC,QAAQ,QAAQ,mBAAmB;AAG5C;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,WAAWA,CAAA,EAAW;EACpC,OAAOD,QAAQ,CAACD,MAAM,CAAC,IAAIG,IAAI,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;AACnD","ignoreList":[]}

package/lib/module/dates/wire/todayMonthId.js

@@ -0,0 +1,13 @@
+"use strict";
+
+import { format, startOfMonth } from 'date-fns';
+import { asMonthId } from '../internal/brand';
+/**
+ * Returns the device-local calendar month as a wire `MonthId`.
+ *
+ * @returns Current month as `YYYY-MM-01`.
+ */
+export function todayMonthId() {
+  return asMonthId(format(startOfMonth(new Date()), 'yyyy-MM-dd'));
+}
+//# sourceMappingURL=todayMonthId.js.map