@cdx-ui/formatters 0.0.1-beta.132

package/lib/commonjs/dates/segments/getDateFieldSegments.js

@@ -0,0 +1,44 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getDateFieldSegments = getDateFieldSegments;
+var _brand = require("../internal/brand");
+var _segmentBuilders = require("../internal/segmentBuilders");
+var _parseDateId = require("../wire/parseDateId");
+var _parseMonthId = require("../wire/parseMonthId");
+/**
+ * Builds ordered editable and literal segments for a date or month field from a wire value.
+ *
+ * @param value - Wire `DateId` or `MonthId`, or empty for placeholder segments.
+ * @param options - Field mode and optional locale.
+ * @returns Ordered `DateSegment` array matching locale field order.
+ */
+function getDateFieldSegments(value, options) {
+  const locale = options.locale ?? 'en-US';
+  if (!value) {
+    return (0, _segmentBuilders.buildEmptyDateFieldSegments)(options.mode, locale);
+  }
+  if (options.mode === 'month') {
+    const parts = (0, _parseMonthId.parseMonthId)((0, _brand.asMonthId)(value));
+    if (!parts) {
+      return (0, _segmentBuilders.buildEmptyDateFieldSegments)('month', locale);
+    }
+    return (0, _segmentBuilders.buildDateFieldSegments)({
+      year: parts.year,
+      month: parts.month,
+      day: 1
+    }, 'month', locale);
+  }
+  const parts = (0, _parseDateId.parseDateId)((0, _brand.asDateId)(value));
+  if (!parts) {
+    return (0, _segmentBuilders.buildEmptyDateFieldSegments)('date', locale);
+  }
+  return (0, _segmentBuilders.buildDateFieldSegments)({
+    year: parts.year,
+    month: parts.month,
+    day: parts.day
+  }, 'date', locale);
+}
+//# sourceMappingURL=getDateFieldSegments.js.map

package/lib/commonjs/dates/segments/getDateFieldSegments.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_brand","require","_segmentBuilders","_parseDateId","_parseMonthId","getDateFieldSegments","value","options","locale","buildEmptyDateFieldSegments","mode","parts","parseMonthId","asMonthId","buildDateFieldSegments","year","month","day","parseDateId","asDateId"],"sourceRoot":"../../../../src","sources":["dates/segments/getDateFieldSegments.ts"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AACA,IAAAC,gBAAA,GAAAD,OAAA;AACA,IAAAE,YAAA,GAAAF,OAAA;AACA,IAAAG,aAAA,GAAAH,OAAA;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASI,oBAAoBA,CAClCC,KAA0C,EAC1CC,OAAiD,EAClC;EACf,MAAMC,MAAM,GAAGD,OAAO,CAACC,MAAM,IAAI,OAAO;EAExC,IAAI,CAACF,KAAK,EAAE;IACV,OAAO,IAAAG,4CAA2B,EAACF,OAAO,CAACG,IAAI,EAAEF,MAAM,CAAC;EAC1D;EAEA,IAAID,OAAO,CAACG,IAAI,KAAK,OAAO,EAAE;IAC5B,MAAMC,KAAK,GAAG,IAAAC,0BAAY,EAAC,IAAAC,gBAAS,EAACP,KAAK,CAAC,CAAC;IAC5C,IAAI,CAACK,KAAK,EAAE;MACV,OAAO,IAAAF,4CAA2B,EAAC,OAAO,EAAED,MAAM,CAAC;IACrD;IACA,OAAO,IAAAM,uCAAsB,EAC3B;MAAEC,IAAI,EAAEJ,KAAK,CAACI,IAAI;MAAEC,KAAK,EAAEL,KAAK,CAACK,KAAK;MAAEC,GAAG,EAAE;IAAE,CAAC,EAChD,OAAO,EACPT,MACF,CAAC;EACH;EAEA,MAAMG,KAAK,GAAG,IAAAO,wBAAW,EAAC,IAAAC,eAAQ,EAACb,KAAK,CAAC,CAAC;EAC1C,IAAI,CAACK,KAAK,EAAE;IACV,OAAO,IAAAF,4CAA2B,EAAC,MAAM,EAAED,MAAM,CAAC;EACpD;EACA,OAAO,IAAAM,uCAAsB,EAC3B;IAAEC,IAAI,EAAEJ,KAAK,CAACI,IAAI;IAAEC,KAAK,EAAEL,KAAK,CAACK,KAAK;IAAEC,GAAG,EAAEN,KAAK,CAACM;EAAI,CAAC,EACxD,MAAM,EACNT,MACF,CAAC;AACH","ignoreList":[]}

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

@@ -0,0 +1,150 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getDateTimeFieldSegments = getDateTimeFieldSegments;
+var _intlCopy = require("../internal/intlCopy");
+var _segmentBuilders = require("../internal/segmentBuilders");
+var _formatDateId = require("../wire/formatDateId");
+var _isLocaleHour = require("../datetime/isLocaleHour12");
+var _parseDateTimeId = require("../datetime/parseDateTimeId");
+var _getDateFieldSegments = require("./getDateFieldSegments");
+var _getDateTimeSegmentVisibility = require("./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.
+ */
+function getDateTimeFieldSegments(value, options) {
+  const parts = value ? (0, _parseDateTimeId.parseDateTimeId)(value) : null;
+  const locale = options.locale ?? 'en-US';
+  const hour12 = options.hour12 ?? (0, _isLocaleHour.isLocaleHour12)(locale);
+  const segments = (0, _getDateFieldSegments.getDateFieldSegments)(parts ? (0, _formatDateId.formatDateId)(parts) : undefined, {
+    mode: 'date',
+    locale: options.locale
+  });
+  if (options.granularity === 'day') {
+    return segments;
+  }
+  const {
+    showMinute,
+    showSecond
+  } = (0, _getDateTimeSegmentVisibility.getDateTimeSegmentVisibility)(options.granularity);
+  if (!parts) {
+    segments.push({
+      type: 'literal',
+      text: ' ',
+      isEditable: false
+    });
+    segments.push({
+      type: 'hour',
+      text: hour12 ? _segmentBuilders.EMPTY_TIME_SEGMENT_TEXT.hour : 'HH',
+      isEditable: true
+    });
+    if (showMinute) {
+      segments.push({
+        type: 'literal',
+        text: ':',
+        isEditable: false
+      });
+      segments.push({
+        type: 'minute',
+        text: _segmentBuilders.EMPTY_TIME_SEGMENT_TEXT.minute,
+        isEditable: true
+      });
+    }
+    if (showSecond) {
+      segments.push({
+        type: 'literal',
+        text: ':',
+        isEditable: false
+      });
+      segments.push({
+        type: 'second',
+        text: _segmentBuilders.EMPTY_TIME_SEGMENT_TEXT.second,
+        isEditable: true
+      });
+    }
+    if (hour12) {
+      segments.push({
+        type: 'literal',
+        text: ' ',
+        isEditable: false
+      });
+      segments.push({
+        type: 'dayPeriod',
+        text: _segmentBuilders.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: (0, _segmentBuilders.padSegment)('hour', hour),
+      value: hour,
+      isEditable: true
+    });
+  }
+  if (showMinute) {
+    segments.push({
+      type: 'literal',
+      text: ':',
+      isEditable: false
+    });
+    segments.push({
+      type: 'minute',
+      text: (0, _segmentBuilders.padSegment)('minute', minute),
+      value: minute,
+      isEditable: true
+    });
+  }
+  if (showSecond) {
+    segments.push({
+      type: 'literal',
+      text: ':',
+      isEditable: false
+    });
+    segments.push({
+      type: 'second',
+      text: (0, _segmentBuilders.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: (0, _intlCopy.formatDayPeriodFromHour)(isPm ? 13 : 9, locale),
+      value: isPm ? 1 : 0,
+      isEditable: true
+    });
+  }
+  return segments;
+}
+//# sourceMappingURL=getDateTimeFieldSegments.js.map

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

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

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

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

package/lib/commonjs/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;AACO,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/commonjs/dates/segments/getEmptyDateSegmentText.js

@@ -0,0 +1,17 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getEmptyDateSegmentText = getEmptyDateSegmentText;
+var _segmentBuilders = require("../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.
+ */
+function getEmptyDateSegmentText(type) {
+  return _segmentBuilders.EMPTY_DATE_SEGMENT_TEXT[type] ?? '';
+}
+//# sourceMappingURL=getEmptyDateSegmentText.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_segmentBuilders","require","getEmptyDateSegmentText","type","EMPTY_DATE_SEGMENT_TEXT"],"sourceRoot":"../../../../src","sources":["dates/segments/getEmptyDateSegmentText.ts"],"mappings":";;;;;;AAAA,IAAAA,gBAAA,GAAAC,OAAA;AAGA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,uBAAuBA,CAACC,IAAqB,EAAU;EACrE,OAAOC,wCAAuB,CAACD,IAAI,CAAC,IAAI,EAAE;AAC5C","ignoreList":[]}

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

@@ -0,0 +1,26 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.parseDateSegment = parseDateSegment;
+/**
+ * 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.
+ */
+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/commonjs/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;AACO,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/commonjs/dates/types.js

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

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

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

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

@@ -0,0 +1,26 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.clampDateParts = clampDateParts;
+var _clampHelpers = require("../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 }
+ */
+function clampDateParts(parts) {
+  const month = (0, _clampHelpers.clampMonth)(parts.month);
+  const day = (0, _clampHelpers.clampDay)(parts.year, month, parts.day);
+  return {
+    year: parts.year,
+    month,
+    day
+  };
+}
+//# sourceMappingURL=clampDateParts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_clampHelpers","require","clampDateParts","parts","month","clampMonth","day","clampDay","year"],"sourceRoot":"../../../../src","sources":["dates/wire/clampDateParts.ts"],"mappings":";;;;;;AAAA,IAAAA,aAAA,GAAAC,OAAA;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,cAAcA,CAACC,KAAgB,EAAa;EAC1D,MAAMC,KAAK,GAAG,IAAAC,wBAAU,EAACF,KAAK,CAACC,KAAK,CAAC;EACrC,MAAME,GAAG,GAAG,IAAAC,sBAAQ,EAACJ,KAAK,CAACK,IAAI,EAAEJ,KAAK,EAAED,KAAK,CAACG,GAAG,CAAC;EAClD,OAAO;IAAEE,IAAI,EAAEL,KAAK,CAACK,IAAI;IAAEJ,KAAK;IAAEE;EAAI,CAAC;AACzC","ignoreList":[]}

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

@@ -0,0 +1,23 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.clampMonthParts = clampMonthParts;
+var _clampHelpers = require("../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 }
+ */
+function clampMonthParts(parts) {
+  return {
+    year: parts.year,
+    month: (0, _clampHelpers.clampMonth)(parts.month)
+  };
+}
+//# sourceMappingURL=clampMonthParts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_clampHelpers","require","clampMonthParts","parts","year","month","clampMonth"],"sourceRoot":"../../../../src","sources":["dates/wire/clampMonthParts.ts"],"mappings":";;;;;;AAAA,IAAAA,aAAA,GAAAC,OAAA;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,eAAeA,CAACC,KAAiB,EAAc;EAC7D,OAAO;IAAEC,IAAI,EAAED,KAAK,CAACC,IAAI;IAAEC,KAAK,EAAE,IAAAC,wBAAU,EAACH,KAAK,CAACE,KAAK;EAAE,CAAC;AAC7D","ignoreList":[]}

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

@@ -0,0 +1,50 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.dateId = dateId;
+var _brand = require("../internal/brand");
+var _formatDateId = require("./formatDateId");
+var _isValidDateId = require("./isValidDateId");
+var _isValidDateParts = require("./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`.
+ */
+
+function dateId(yearOrIso, month, day) {
+  if (typeof yearOrIso === 'string') {
+    if (!(0, _isValidDateId.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 (!(0, _isValidDateParts.isValidDateParts)(parts)) {
+    throw new RangeError(`Invalid DateId parts: ${JSON.stringify(parts)}.`);
+  }
+  return (0, _brand.asDateId)((0, _formatDateId.formatDateId)(parts));
+}
+//# sourceMappingURL=dateId.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_brand","require","_formatDateId","_isValidDateId","_isValidDateParts","dateId","yearOrIso","month","day","isValidDateId","RangeError","parts","year","NaN","isValidDateParts","JSON","stringify","asDateId","formatDateId"],"sourceRoot":"../../../../src","sources":["dates/wire/dateId.ts"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AAEA,IAAAC,aAAA,GAAAD,OAAA;AACA,IAAAE,cAAA,GAAAF,OAAA;AACA,IAAAG,iBAAA,GAAAH,OAAA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;;AAEO,SAASI,MAAMA,CAACC,SAA0B,EAAEC,KAAc,EAAEC,GAAY,EAAU;EACvF,IAAI,OAAOF,SAAS,KAAK,QAAQ,EAAE;IACjC,IAAI,CAAC,IAAAG,4BAAa,EAACH,SAAS,CAAC,EAAE;MAC7B,MAAM,IAAII,UAAU,CAClB,oBAAoBJ,SAAS,mDAC/B,CAAC;IACH;IACA,OAAOA,SAAS;EAClB;EAEA,MAAMK,KAAK,GAAG;IAAEC,IAAI,EAAEN,SAAS;IAAEC,KAAK,EAAEA,KAAK,IAAIM,GAAG;IAAEL,GAAG,EAAEA,GAAG,IAAIK;EAAI,CAAC;EACvE,IAAI,CAAC,IAAAC,kCAAgB,EAACH,KAAK,CAAC,EAAE;IAC5B,MAAM,IAAID,UAAU,CAAC,yBAAyBK,IAAI,CAACC,SAAS,CAACL,KAAK,CAAC,GAAG,CAAC;EACzE;EACA,OAAO,IAAAM,eAAQ,EAAC,IAAAC,0BAAY,EAACP,KAAK,CAAC,CAAC;AACtC","ignoreList":[]}

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

@@ -0,0 +1,25 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.formatDateId = formatDateId;
+var _brand = require("../internal/brand");
+var _clampDateParts = require("./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'
+ */
+function formatDateId(parts) {
+  const clamped = (0, _clampDateParts.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 (0, _brand.asDateId)(`${year}-${month}-${day}`);
+}
+//# sourceMappingURL=formatDateId.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_brand","require","_clampDateParts","formatDateId","parts","clamped","clampDateParts","year","String","padStart","month","day","asDateId"],"sourceRoot":"../../../../src","sources":["dates/wire/formatDateId.ts"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AAEA,IAAAC,eAAA,GAAAD,OAAA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASE,YAAYA,CAACC,KAAgB,EAAU;EACrD,MAAMC,OAAO,GAAG,IAAAC,8BAAc,EAACF,KAAK,CAAC;EACrC,MAAMG,IAAI,GAAGC,MAAM,CAACH,OAAO,CAACE,IAAI,CAAC,CAACE,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;EAClD,MAAMC,KAAK,GAAGF,MAAM,CAACH,OAAO,CAACK,KAAK,CAAC,CAACD,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;EACpD,MAAME,GAAG,GAAGH,MAAM,CAACH,OAAO,CAACM,GAAG,CAAC,CAACF,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;EAChD,OAAO,IAAAG,eAAQ,EAAC,GAAGL,IAAI,IAAIG,KAAK,IAAIC,GAAG,EAAE,CAAC;AAC5C","ignoreList":[]}

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

@@ -0,0 +1,21 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.formatMonthId = formatMonthId;
+var _dateFns = require("date-fns");
+var _brand = require("../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'
+ */
+function formatMonthId(parts) {
+  return (0, _brand.asMonthId)((0, _dateFns.format)(new Date(parts.year, parts.month - 1, 1), 'yyyy-MM-dd'));
+}
+//# sourceMappingURL=formatMonthId.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_dateFns","require","_brand","formatMonthId","parts","asMonthId","format","Date","year","month"],"sourceRoot":"../../../../src","sources":["dates/wire/formatMonthId.ts"],"mappings":";;;;;;AAAA,IAAAA,QAAA,GAAAC,OAAA;AACA,IAAAC,MAAA,GAAAD,OAAA;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASE,aAAaA,CAACC,KAAiB,EAAW;EACxD,OAAO,IAAAC,gBAAS,EAAC,IAAAC,eAAM,EAAC,IAAIC,IAAI,CAACH,KAAK,CAACI,IAAI,EAAEJ,KAAK,CAACK,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;AAClF","ignoreList":[]}

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

@@ -0,0 +1,27 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isValidDateId = isValidDateId;
+var _dateFns = require("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
+ */
+function isValidDateId(dateId) {
+  if (!DATE_ID_PATTERN.test(dateId)) {
+    return false;
+  }
+  const parsed = (0, _dateFns.parse)(dateId, 'yyyy-MM-dd', new Date());
+  return (0, _dateFns.isValid)(parsed) && (0, _dateFns.format)(parsed, 'yyyy-MM-dd') === dateId;
+}
+//# sourceMappingURL=isValidDateId.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_dateFns","require","DATE_ID_PATTERN","isValidDateId","dateId","test","parsed","parse","Date","isValid","format"],"sourceRoot":"../../../../src","sources":["dates/wire/isValidDateId.ts"],"mappings":";;;;;;AAAA,IAAAA,QAAA,GAAAC,OAAA;AAGA,MAAMC,eAAe,GAAG,qBAAqB;;AAE7C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,aAAaA,CAACC,MAAc,EAAoB;EAC9D,IAAI,CAACF,eAAe,CAACG,IAAI,CAACD,MAAM,CAAC,EAAE;IACjC,OAAO,KAAK;EACd;EACA,MAAME,MAAM,GAAG,IAAAC,cAAK,EAACH,MAAM,EAAE,YAAY,EAAE,IAAII,IAAI,CAAC,CAAC,CAAC;EACtD,OAAO,IAAAC,gBAAO,EAACH,MAAM,CAAC,IAAI,IAAAI,eAAM,EAACJ,MAAM,EAAE,YAAY,CAAC,KAAKF,MAAM;AACnE","ignoreList":[]}

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

@@ -0,0 +1,18 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isValidDateParts = isValidDateParts;
+var _clampHelpers = require("../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.
+ */
+function isValidDateParts(parts) {
+  const date = (0, _clampHelpers.partsToDate)(parts);
+  return date.getFullYear() === parts.year && date.getMonth() === parts.month - 1 && date.getDate() === parts.day;
+}
+//# sourceMappingURL=isValidDateParts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_clampHelpers","require","isValidDateParts","parts","date","partsToDate","getFullYear","year","getMonth","month","getDate","day"],"sourceRoot":"../../../../src","sources":["dates/wire/isValidDateParts.ts"],"mappings":";;;;;;AAAA,IAAAA,aAAA,GAAAC,OAAA;AAGA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,gBAAgBA,CAACC,KAAgB,EAAW;EAC1D,MAAMC,IAAI,GAAG,IAAAC,yBAAW,EAACF,KAAK,CAAC;EAC/B,OACEC,IAAI,CAACE,WAAW,CAAC,CAAC,KAAKH,KAAK,CAACI,IAAI,IACjCH,IAAI,CAACI,QAAQ,CAAC,CAAC,KAAKL,KAAK,CAACM,KAAK,GAAG,CAAC,IACnCL,IAAI,CAACM,OAAO,CAAC,CAAC,KAAKP,KAAK,CAACQ,GAAG;AAEhC","ignoreList":[]}

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

@@ -0,0 +1,27 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isValidMonthId = isValidMonthId;
+var _dateFns = require("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
+ */
+function isValidMonthId(monthId) {
+  if (!MONTH_ID_PATTERN.test(monthId)) {
+    return false;
+  }
+  const parsed = (0, _dateFns.parse)(monthId, 'yyyy-MM-dd', new Date());
+  return (0, _dateFns.isValid)(parsed) && (0, _dateFns.format)(parsed, 'yyyy-MM-dd') === monthId;
+}
+//# sourceMappingURL=isValidMonthId.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_dateFns","require","MONTH_ID_PATTERN","isValidMonthId","monthId","test","parsed","parse","Date","isValid","format"],"sourceRoot":"../../../../src","sources":["dates/wire/isValidMonthId.ts"],"mappings":";;;;;;AAAA,IAAAA,QAAA,GAAAC,OAAA;AAGA,MAAMC,gBAAgB,GAAG,kBAAkB;;AAE3C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,cAAcA,CAACC,OAAe,EAAsB;EAClE,IAAI,CAACF,gBAAgB,CAACG,IAAI,CAACD,OAAO,CAAC,EAAE;IACnC,OAAO,KAAK;EACd;EACA,MAAME,MAAM,GAAG,IAAAC,cAAK,EAACH,OAAO,EAAE,YAAY,EAAE,IAAII,IAAI,CAAC,CAAC,CAAC;EACvD,OAAO,IAAAC,gBAAO,EAACH,MAAM,CAAC,IAAI,IAAAI,eAAM,EAACJ,MAAM,EAAE,YAAY,CAAC,KAAKF,OAAO;AACpE","ignoreList":[]}

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

@@ -0,0 +1,16 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isValidMonthParts = isValidMonthParts;
+/**
+ * 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.
+ */
+function isValidMonthParts(parts) {
+  return parts.month >= 1 && parts.month <= 12;
+}
+//# sourceMappingURL=isValidMonthParts.js.map

package/lib/commonjs/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;AACO,SAASA,iBAAiBA,CAACC,KAAiB,EAAW;EAC5D,OAAOA,KAAK,CAACC,KAAK,IAAI,CAAC,IAAID,KAAK,CAACC,KAAK,IAAI,EAAE;AAC9C","ignoreList":[]}

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

@@ -0,0 +1,47 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.monthId = monthId;
+var _brand = require("../internal/brand");
+var _formatMonthId = require("./formatMonthId");
+var _isValidMonthId = require("./isValidMonthId");
+var _isValidMonthParts = require("./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`.
+ */
+
+function monthId(yearOrIso, month) {
+  if (typeof yearOrIso === 'string') {
+    if (!(0, _isValidMonthId.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 (!(0, _isValidMonthParts.isValidMonthParts)(parts)) {
+    throw new RangeError(`Invalid MonthId parts: ${JSON.stringify(parts)}. Month must be 1–12.`);
+  }
+  return (0, _brand.asMonthId)((0, _formatMonthId.formatMonthId)(parts));
+}
+//# sourceMappingURL=monthId.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_brand","require","_formatMonthId","_isValidMonthId","_isValidMonthParts","monthId","yearOrIso","month","isValidMonthId","RangeError","parts","year","NaN","isValidMonthParts","JSON","stringify","asMonthId","formatMonthId"],"sourceRoot":"../../../../src","sources":["dates/wire/monthId.ts"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AAEA,IAAAC,cAAA,GAAAD,OAAA;AACA,IAAAE,eAAA,GAAAF,OAAA;AACA,IAAAG,kBAAA,GAAAH,OAAA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;;AAEO,SAASI,OAAOA,CAACC,SAA0B,EAAEC,KAAc,EAAW;EAC3E,IAAI,OAAOD,SAAS,KAAK,QAAQ,EAAE;IACjC,IAAI,CAAC,IAAAE,8BAAc,EAACF,SAAS,CAAC,EAAE;MAC9B,MAAM,IAAIG,UAAU,CAClB,qBAAqBH,SAAS,mDAChC,CAAC;IACH;IACA,OAAOA,SAAS;EAClB;EAEA,MAAMI,KAAK,GAAG;IAAEC,IAAI,EAAEL,SAAS;IAAEC,KAAK,EAAEA,KAAK,IAAIK;EAAI,CAAC;EACtD,IAAI,CAAC,IAAAC,oCAAiB,EAACH,KAAK,CAAC,EAAE;IAC7B,MAAM,IAAID,UAAU,CAAC,0BAA0BK,IAAI,CAACC,SAAS,CAACL,KAAK,CAAC,uBAAuB,CAAC;EAC9F;EACA,OAAO,IAAAM,gBAAS,EAAC,IAAAC,4BAAa,EAACP,KAAK,CAAC,CAAC;AACxC","ignoreList":[]}