@cdx-ui/formatters 0.0.1-beta.132

package/lib/typescript/dates/internal/intlCache.d.ts

@@ -0,0 +1,12 @@
+import type { DateFormatOptions } from '../types';
+/**
+ * Cached `Intl.DateTimeFormat` factory for display helpers.
+ *
+ * @internal Not part of the public package API — prefer `formatDateForDisplay` and related helpers.
+ */
+export declare function createDateFormatter(options: Intl.DateTimeFormatOptions & DateFormatOptions): Intl.DateTimeFormat;
+/**
+ * @internal
+ */
+export declare function getCachedDateFormatter(locale: string, options: Intl.DateTimeFormatOptions & DateFormatOptions): Intl.DateTimeFormat;
+//# sourceMappingURL=intlCache.d.ts.map

package/lib/typescript/dates/internal/intlCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intlCache.d.ts","sourceRoot":"","sources":["../../../../src/dates/internal/intlCache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAQlD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,IAAI,CAAC,qBAAqB,GAAG,iBAAiB,GACtD,IAAI,CAAC,cAAc,CAOrB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,IAAI,CAAC,qBAAqB,GAAG,iBAAiB,GACtD,IAAI,CAAC,cAAc,CASrB"}

package/lib/typescript/dates/internal/intlCopy.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Locale-aware relative "today" label (e.g. `Today`, `aujourd'hui`).
+ * Falls back when `Intl.RelativeTimeFormat` is missing (Hermes / incomplete Intl).
+ */
+export declare function formatRelativeToday(locale?: string): string;
+/** Locale-aware day-period label (AM/PM or locale equivalent) for a 0–23 hour value. */
+export declare function formatDayPeriodFromHour(hour: number, locale?: string): string;
+/** Locale-aware separator between two formatted dates in a range label. */
+export declare function getDateRangeSeparator(locale?: string): string;
+//# sourceMappingURL=intlCopy.d.ts.map

package/lib/typescript/dates/internal/intlCopy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intlCopy.d.ts","sourceRoot":"","sources":["../../../../src/dates/internal/intlCopy.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,SAAiB,GAAG,MAAM,CAanE;AAED,wFAAwF;AACxF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,SAAiB,GAAG,MAAM,CAgBrF;AAED,2EAA2E;AAC3E,wBAAgB,qBAAqB,CAAC,MAAM,SAAiB,GAAG,MAAM,CAiCrE"}

package/lib/typescript/dates/internal/segmentBuilders.d.ts

@@ -0,0 +1,12 @@
+import type { DateFieldMode, DateSegment, DateSegmentType } from '../types';
+export declare const DATE_FIELD_FORMAT_OPTIONS: Record<DateFieldMode, Intl.DateTimeFormatOptions>;
+export declare const EMPTY_DATE_SEGMENT_TEXT: Partial<Record<DateSegmentType, string>>;
+export declare const EMPTY_TIME_SEGMENT_TEXT: Record<'hour' | 'minute' | 'second' | 'dayPeriod', string>;
+export declare function padSegment(type: DateSegmentType, value: number): string;
+export declare function buildEmptyDateFieldSegments(mode: DateFieldMode, locale: string): DateSegment[];
+export declare function buildDateFieldSegments(values: {
+    year: number;
+    month: number;
+    day: number;
+}, mode: DateFieldMode, locale: string): DateSegment[];
+//# sourceMappingURL=segmentBuilders.d.ts.map

package/lib/typescript/dates/internal/segmentBuilders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"segmentBuilders.d.ts","sourceRoot":"","sources":["../../../../src/dates/internal/segmentBuilders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAG5E,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,aAAa,EAAE,IAAI,CAAC,qBAAqB,CAGvF,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAQ5E,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,EAAE,MAAM,CAK9F,CAAC;AAEF,wBAAgB,UAAU,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAWvE;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAqB9F;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EACpD,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,MAAM,GACb,WAAW,EAAE,CA4Bf"}

package/lib/typescript/dates/labels/dateComponentLabels.d.ts

@@ -0,0 +1,31 @@
+import type { DateSegmentType } from '../types';
+/** Overridable UI copy for date pickers, calendars, and segmented date fields. */
+export interface DateComponentLabels {
+    openDatePicker: string;
+    openDateTimePicker: string;
+    openDateRangePicker: string;
+    openMonthPicker: string;
+    showCalendar: string;
+    showYearPicker: string;
+    showMonths: string;
+    previousMonth: string;
+    nextMonth: string;
+    previousYear: string;
+    nextYear: string;
+    /** Use `{year}` as the year placeholder. */
+    selectYear: string;
+    dateFieldKeyboardInput: string;
+    segmentYear: string;
+    segmentMonth: string;
+    segmentDay: string;
+    segmentHour: string;
+    segmentMinute: string;
+    segmentSecond: string;
+    segmentDayPeriod: string;
+    rangeSeparator: string;
+}
+export declare const DEFAULT_DATE_COMPONENT_LABELS: DateComponentLabels;
+export declare function resolveDateComponentLabels(partial?: Partial<DateComponentLabels>): DateComponentLabels;
+export declare function formatSelectYear(labels: DateComponentLabels, year: number): string;
+export declare function getDateSegmentAccessibilityLabel(type: DateSegmentType, labels: DateComponentLabels): string | undefined;
+//# sourceMappingURL=dateComponentLabels.d.ts.map

package/lib/typescript/dates/labels/dateComponentLabels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dateComponentLabels.d.ts","sourceRoot":"","sources":["../../../../src/dates/labels/dateComponentLabels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,kFAAkF;AAClF,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,6BAA6B,EAAE,mBAsB3C,CAAC;AAEF,wBAAgB,0BAA0B,CACxC,OAAO,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GACrC,mBAAmB,CAErB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAElF;AAYD,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,mBAAmB,GAC1B,MAAM,GAAG,SAAS,CAGpB"}

package/lib/typescript/dates/ranges/compareDateIds.d.ts

@@ -0,0 +1,10 @@
+import type { DateId } from '../types';
+/**
+ * Compares two wire dates.
+ *
+ * @param a - First wire date.
+ * @param b - Second wire date.
+ * @returns `-1` if `a` is earlier, `1` if later, `0` if equal.
+ */
+export declare function compareDateIds(a: DateId, b: DateId): -1 | 0 | 1;
+//# sourceMappingURL=compareDateIds.d.ts.map

package/lib/typescript/dates/ranges/compareDateIds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compareDateIds.d.ts","sourceRoot":"","sources":["../../../../src/dates/ranges/compareDateIds.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAS/D"}

package/lib/typescript/dates/ranges/compareMonthIds.d.ts

@@ -0,0 +1,10 @@
+import type { MonthId } from '../types';
+/**
+ * Compares two wire months chronologically.
+ *
+ * @param a - First wire month (`YYYY-MM-01`).
+ * @param b - Second wire month (`YYYY-MM-01`).
+ * @returns `-1` if `a` is earlier, `1` if later, `0` if equal or either is invalid.
+ */
+export declare function compareMonthIds(a: MonthId, b: MonthId): -1 | 0 | 1;
+//# sourceMappingURL=compareMonthIds.d.ts.map

package/lib/typescript/dates/ranges/compareMonthIds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compareMonthIds.d.ts","sourceRoot":"","sources":["../../../../src/dates/ranges/compareMonthIds.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAelE"}

package/lib/typescript/dates/ranges/dateRangeAroundDay.d.ts

@@ -0,0 +1,14 @@
+import type { DateId } from '../types';
+/**
+ * Builds an inclusive window of dates around an anchor (default: today).
+ *
+ * @param daysBefore - Number of days before the anchor (inclusive).
+ * @param daysAfter - Number of days after the anchor (inclusive).
+ * @param anchorDate - Optional anchor wire date; defaults to today.
+ * @returns Start and end wire date ids for the window.
+ */
+export declare function dateRangeAroundDay(daysBefore: number, daysAfter: number, anchorDate?: DateId): {
+    startId: DateId;
+    endId: DateId;
+};
+//# sourceMappingURL=dateRangeAroundDay.d.ts.map

package/lib/typescript/dates/ranges/dateRangeAroundDay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dateRangeAroundDay.d.ts","sourceRoot":"","sources":["../../../../src/dates/ranges/dateRangeAroundDay.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,GAClB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAMpC"}

package/lib/typescript/dates/ranges/dateRangeFromLastNDays.d.ts

@@ -0,0 +1,16 @@
+import type { DateId } from '../types';
+/**
+ * Builds an inclusive "last N days" preset ending on `endDate` (default: today).
+ *
+ * @param days - Number of calendar days in the range (inclusive of end).
+ * @param endDate - Optional end wire date; defaults to today.
+ * @returns Normalized start/end wire date ids.
+ *
+ * @example
+ * dateRangeFromLastNDays(30) // { startId, endId } spanning 30 calendar days
+ */
+export declare function dateRangeFromLastNDays(days: number, endDate?: DateId): {
+    startId: DateId;
+    endId: DateId;
+};
+//# sourceMappingURL=dateRangeFromLastNDays.d.ts.map

package/lib/typescript/dates/ranges/dateRangeFromLastNDays.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dateRangeFromLastNDays.d.ts","sourceRoot":"","sources":["../../../../src/dates/ranges/dateRangeFromLastNDays.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,GACf;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAOpC"}

package/lib/typescript/dates/ranges/eachDateIdInRange.d.ts

@@ -0,0 +1,10 @@
+import type { DateId } from '../types';
+/**
+ * Returns an inclusive list of every `DateId` between start and end (order-normalized).
+ *
+ * @param startId - Range start wire date.
+ * @param endId - Range end wire date.
+ * @returns Array of wire `DateId` strings for each day in the range.
+ */
+export declare function eachDateIdInRange(startId: DateId, endId: DateId): DateId[];
+//# sourceMappingURL=eachDateIdInRange.d.ts.map

package/lib/typescript/dates/ranges/eachDateIdInRange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eachDateIdInRange.d.ts","sourceRoot":"","sources":["../../../../src/dates/ranges/eachDateIdInRange.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGvC;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAO1E"}

package/lib/typescript/dates/ranges/normalizeDateRange.d.ts

@@ -0,0 +1,15 @@
+import type { DateId } from '../types';
+/**
+ * Ensures `startId` ≤ `endId` by swapping when the range is inverted.
+ *
+ * @param range - Start and end wire date ids.
+ * @returns Normalized range with `startId` on or before `endId`.
+ */
+export declare function normalizeDateRange(range: {
+    startId: DateId;
+    endId: DateId;
+}): {
+    startId: DateId;
+    endId: DateId;
+};
+//# sourceMappingURL=normalizeDateRange.d.ts.map

package/lib/typescript/dates/ranges/normalizeDateRange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeDateRange.d.ts","sourceRoot":"","sources":["../../../../src/dates/ranges/normalizeDateRange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGvC;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf,CAKA"}

package/lib/typescript/dates/segments/applyDateSegmentChange.d.ts

@@ -0,0 +1,21 @@
+import type { DateFieldMode, DateParts, DateSegmentType, MonthParts } from '../types';
+/**
+ * Applies a single segment edit to complete date/month parts, clamping invalid days/months.
+ *
+ * Prefer this when updating a fully known value. Segmented `DateField` mid-entry uses
+ * partial parts internally and does not call this helper.
+ *
+ * @param current - Current parts, or `null` for defaults.
+ * @param segment - Segment type being edited.
+ * @param value - New numeric value for the segment.
+ * @param options - Field mode (`date` or `month`).
+ * @returns Updated parts, or `null` when input cannot be applied.
+ *
+ * @example
+ * applyDateSegmentChange(parseDateId('2026-01-31'), 'month', 2, { mode: 'date' })
+ * // → { year: 2026, month: 2, day: 28 }
+ */
+export declare function applyDateSegmentChange(current: DateParts | MonthParts | null, segment: DateSegmentType, value: number, options: {
+    mode: DateFieldMode;
+}): DateParts | MonthParts | null;
+//# sourceMappingURL=applyDateSegmentChange.d.ts.map

package/lib/typescript/dates/segments/applyDateSegmentChange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applyDateSegmentChange.d.ts","sourceRoot":"","sources":["../../../../src/dates/segments/applyDateSegmentChange.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,SAAS,GAAG,UAAU,GAAG,IAAI,EACtC,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GAC/B,SAAS,GAAG,UAAU,GAAG,IAAI,CA+B/B"}

package/lib/typescript/dates/segments/formatDateSegment.d.ts

@@ -0,0 +1,13 @@
+import type { DateSegmentType } from '../types';
+/**
+ * Formats a numeric segment value for display in a segmented date field.
+ *
+ * @param type - Segment type (year, month, day, etc.).
+ * @param value - Numeric segment value.
+ * @param _options - Reserved for future locale-aware formatting.
+ * @returns Padded segment text.
+ */
+export declare function formatDateSegment(type: DateSegmentType, value: number, _options?: {
+    locale?: string;
+}): string;
+//# sourceMappingURL=formatDateSegment.d.ts.map

package/lib/typescript/dates/segments/formatDateSegment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatDateSegment.d.ts","sourceRoot":"","sources":["../../../../src/dates/segments/formatDateSegment.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7B,MAAM,CAER"}

package/lib/typescript/dates/segments/getDateFieldSegments.d.ts

@@ -0,0 +1,13 @@
+import type { DateFieldMode, DateId, DateSegment, MonthId } from '../types';
+/**
+ * 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.
+ */
+export declare function getDateFieldSegments(value: DateId | MonthId | null | undefined, options: {
+    mode: DateFieldMode;
+    locale?: string;
+}): DateSegment[];
+//# sourceMappingURL=getDateFieldSegments.d.ts.map

package/lib/typescript/dates/segments/getDateFieldSegments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDateFieldSegments.d.ts","sourceRoot":"","sources":["../../../../src/dates/segments/getDateFieldSegments.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAE5E;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EAC1C,OAAO,EAAE;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD,WAAW,EAAE,CA4Bf"}

package/lib/typescript/dates/segments/getDateTimeFieldSegments.d.ts

@@ -0,0 +1,14 @@
+import type { DateSegment, DateTimeGranularity, DateTimeId } from '../types';
+/**
+ * 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 declare function getDateTimeFieldSegments(value: DateTimeId | null | undefined, options: {
+    granularity: DateTimeGranularity;
+    locale?: string;
+    hour12?: boolean;
+}): DateSegment[];
+//# sourceMappingURL=getDateTimeFieldSegments.d.ts.map

package/lib/typescript/dates/segments/getDateTimeFieldSegments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDateTimeFieldSegments.d.ts","sourceRoot":"","sources":["../../../../src/dates/segments/getDateTimeFieldSegments.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAI7E;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,EACpC,OAAO,EAAE;IAAE,WAAW,EAAE,mBAAmB,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/E,WAAW,EAAE,CA0Gf"}

package/lib/typescript/dates/segments/getDateTimeSegmentVisibility.d.ts

@@ -0,0 +1,8 @@
+import type { DateTimeGranularity } from '../types';
+/** Which time segments/columns are visible for a given `DateTimeGranularity`. */
+export declare function getDateTimeSegmentVisibility(granularity: DateTimeGranularity): {
+    showTime: boolean;
+    showMinute: boolean;
+    showSecond: boolean;
+};
+//# sourceMappingURL=getDateTimeSegmentVisibility.d.ts.map

package/lib/typescript/dates/segments/getDateTimeSegmentVisibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDateTimeSegmentVisibility.d.ts","sourceRoot":"","sources":["../../../../src/dates/segments/getDateTimeSegmentVisibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEpD,iFAAiF;AACjF,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,mBAAmB,GAAG;IAC9E,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;CACrB,CAMA"}

package/lib/typescript/dates/segments/getEmptyDateSegmentText.d.ts

@@ -0,0 +1,9 @@
+import type { DateSegmentType } from '../types';
+/**
+ * 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 declare function getEmptyDateSegmentText(type: DateSegmentType): string;
+//# sourceMappingURL=getEmptyDateSegmentText.d.ts.map

package/lib/typescript/dates/segments/getEmptyDateSegmentText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getEmptyDateSegmentText.d.ts","sourceRoot":"","sources":["../../../../src/dates/segments/getEmptyDateSegmentText.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAErE"}

package/lib/typescript/dates/segments/parseDateSegment.d.ts

@@ -0,0 +1,13 @@
+import type { DateSegmentType } from '../types';
+/**
+ * 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 declare function parseDateSegment(type: DateSegmentType, text: string, _options?: {
+    locale?: string;
+}): number | null;
+//# sourceMappingURL=parseDateSegment.d.ts.map

package/lib/typescript/dates/segments/parseDateSegment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseDateSegment.d.ts","sourceRoot":"","sources":["../../../../src/dates/segments/parseDateSegment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7B,MAAM,GAAG,IAAI,CAUf"}

package/lib/typescript/dates/types.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Shared option / parts types for date wire and display helpers.
+ *
+ * Wire brands: `DateId` (`YYYY-MM-DD`), `MonthId` (`YYYY-MM-01`), `DateTimeId` (local ISO-like).
+ *
+ * These are branded string types: a bare `string` no longer assigns to a `DateId`
+ * (etc.) prop. Produce values through the validating smart constructors
+ * (`dateId(...)`, `monthId(...)`, `dateTimeId(...)`) or the wire producers
+ * (`todayDateId()`, `parseDateId(...)`, `formatDateId(...)`, …), all exported from
+ * `@cdx-ui/formatters`. The brand is a compile-time-only tag — at runtime these are
+ * ordinary strings safe to serialize, store, and send over the wire.
+ */
+/** Wire date id (`YYYY-MM-DD`). Construct via `dateId(...)`, never a bare string. */
+export type DateId = string & {
+    readonly __brand: 'DateId';
+};
+/** Wire month id (`YYYY-MM-01`). Construct via `monthId(...)`, never a bare string. */
+export type MonthId = string & {
+    readonly __brand: 'MonthId';
+};
+/** Wire date-time id (local ISO-like, e.g. `YYYY-MM-DDTHH:mm`). Construct via `dateTimeId(...)`. */
+export type DateTimeId = string & {
+    readonly __brand: 'DateTimeId';
+};
+export interface DateParts {
+    year: number;
+    month: number;
+    day: number;
+}
+export interface MonthParts {
+    year: number;
+    month: number;
+}
+export interface TimeParts {
+    hour: number;
+    minute: number;
+    second?: number;
+}
+export interface DateTimeParts extends DateParts, TimeParts {
+}
+export type DateFieldMode = 'date' | 'month';
+export type DateTimeGranularity = 'day' | 'hour' | 'minute' | 'second';
+export type DateSegmentType = 'era' | 'year' | 'month' | 'day' | 'hour' | 'minute' | 'second' | 'dayPeriod' | 'literal';
+export interface DateSegment {
+    type: DateSegmentType;
+    text: string;
+    value?: number;
+    isEditable: boolean;
+}
+export interface DateFormatOptions {
+    locale?: string;
+    timeZone?: string;
+    calendar?: string;
+}
+export interface FormatDateDisplayOptions extends DateFormatOptions {
+    dateStyle?: 'short' | 'medium' | 'long';
+}
+export interface FormatDateTimeDisplayOptions extends DateFormatOptions {
+    dateStyle?: 'short' | 'medium' | 'long';
+    timeStyle?: 'short' | 'medium';
+    granularity?: DateTimeGranularity;
+}
+export interface DateRangeDisplayOptions extends FormatDateDisplayOptions {
+    rangeSeparator?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/dates/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/dates/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,qFAAqF;AACrF,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAA;CAAE,CAAC;AAC7D,uFAAuF;AACvF,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAA;CAAE,CAAC;AAC/D,oGAAoG;AACpG,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC;AAErE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAc,SAAQ,SAAS,EAAE,SAAS;CAAG;AAE9D,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,CAAC;AAE7C,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEvE,MAAM,MAAM,eAAe,GACvB,KAAK,GACL,MAAM,GACN,OAAO,GACP,KAAK,GACL,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,SAAS,CAAC;AAEd,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAyB,SAAQ,iBAAiB;IACjE,SAAS,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;CACzC;AAED,MAAM,WAAW,4BAA6B,SAAQ,iBAAiB;IACrE,SAAS,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IACxC,SAAS,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC/B,WAAW,CAAC,EAAE,mBAAmB,CAAC;CACnC;AAED,MAAM,WAAW,uBAAwB,SAAQ,wBAAwB;IACvE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/lib/typescript/dates/wire/clampDateParts.d.ts

@@ -0,0 +1,12 @@
+import type { DateParts } from '../types';
+/**
+ * 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 declare function clampDateParts(parts: DateParts): DateParts;
+//# sourceMappingURL=clampDateParts.d.ts.map

package/lib/typescript/dates/wire/clampDateParts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clampDateParts.d.ts","sourceRoot":"","sources":["../../../../src/dates/wire/clampDateParts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAI1D"}

package/lib/typescript/dates/wire/clampMonthParts.d.ts

@@ -0,0 +1,12 @@
+import type { MonthParts } from '../types';
+/**
+ * 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 declare function clampMonthParts(parts: MonthParts): MonthParts;
+//# sourceMappingURL=clampMonthParts.d.ts.map

package/lib/typescript/dates/wire/clampMonthParts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clampMonthParts.d.ts","sourceRoot":"","sources":["../../../../src/dates/wire/clampMonthParts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAE7D"}

package/lib/typescript/dates/wire/dateId.d.ts

@@ -0,0 +1,24 @@
+import type { DateId } from '../types';
+/**
+ * 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
+ */
+export declare function dateId(iso: string): DateId;
+/**
+ * @param year - Full year (e.g. `2026`).
+ * @param month - Month `1`–`12`.
+ * @param day - Day of month `1`–`31`.
+ */
+export declare function dateId(year: number, month: number, day: number): DateId;
+//# sourceMappingURL=dateId.d.ts.map

package/lib/typescript/dates/wire/dateId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dateId.d.ts","sourceRoot":"","sources":["../../../../src/dates/wire/dateId.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAKvC;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;AAC5C;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC"}

package/lib/typescript/dates/wire/formatDateId.d.ts

@@ -0,0 +1,12 @@
+import type { DateId, DateParts } from '../types';
+/**
+ * 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 declare function formatDateId(parts: DateParts): DateId;
+//# sourceMappingURL=formatDateId.d.ts.map

package/lib/typescript/dates/wire/formatDateId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatDateId.d.ts","sourceRoot":"","sources":["../../../../src/dates/wire/formatDateId.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAGlD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAMrD"}

package/lib/typescript/dates/wire/formatMonthId.d.ts

@@ -0,0 +1,12 @@
+import type { MonthId, MonthParts } from '../types';
+/**
+ * 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 declare function formatMonthId(parts: MonthParts): MonthId;
+//# sourceMappingURL=formatMonthId.d.ts.map

package/lib/typescript/dates/wire/formatMonthId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatMonthId.d.ts","sourceRoot":"","sources":["../../../../src/dates/wire/formatMonthId.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEpD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAExD"}

package/lib/typescript/dates/wire/isValidDateId.d.ts

@@ -0,0 +1,13 @@
+import type { DateId } from '../types';
+/**
+ * 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 declare function isValidDateId(dateId: string): dateId is DateId;
+//# sourceMappingURL=isValidDateId.d.ts.map

package/lib/typescript/dates/wire/isValidDateId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isValidDateId.d.ts","sourceRoot":"","sources":["../../../../src/dates/wire/isValidDateId.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAIvC;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,MAAM,CAM9D"}

package/lib/typescript/dates/wire/isValidDateParts.d.ts

@@ -0,0 +1,9 @@
+import type { DateParts } from '../types';
+/**
+ * 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 declare function isValidDateParts(parts: DateParts): boolean;
+//# sourceMappingURL=isValidDateParts.d.ts.map

package/lib/typescript/dates/wire/isValidDateParts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isValidDateParts.d.ts","sourceRoot":"","sources":["../../../../src/dates/wire/isValidDateParts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAO1D"}

package/lib/typescript/dates/wire/isValidMonthId.d.ts

@@ -0,0 +1,13 @@
+import type { MonthId } from '../types';
+/**
+ * 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 declare function isValidMonthId(monthId: string): monthId is MonthId;
+//# sourceMappingURL=isValidMonthId.d.ts.map

package/lib/typescript/dates/wire/isValidMonthId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isValidMonthId.d.ts","sourceRoot":"","sources":["../../../../src/dates/wire/isValidMonthId.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAIxC;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,IAAI,OAAO,CAMlE"}

package/lib/typescript/dates/wire/isValidMonthParts.d.ts

@@ -0,0 +1,9 @@
+import type { MonthParts } from '../types';
+/**
+ * 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 declare function isValidMonthParts(parts: MonthParts): boolean;
+//# sourceMappingURL=isValidMonthParts.d.ts.map

package/lib/typescript/dates/wire/isValidMonthParts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isValidMonthParts.d.ts","sourceRoot":"","sources":["../../../../src/dates/wire/isValidMonthParts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAE5D"}

package/lib/typescript/dates/wire/monthId.d.ts

@@ -0,0 +1,22 @@
+import type { MonthId } from '../types';
+/**
+ * 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
+ */
+export declare function monthId(iso: string): MonthId;
+/**
+ * @param year - Full year (e.g. `2026`).
+ * @param month - Month `1`–`12`.
+ */
+export declare function monthId(year: number, month: number): MonthId;
+//# sourceMappingURL=monthId.d.ts.map

package/lib/typescript/dates/wire/monthId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monthId.d.ts","sourceRoot":"","sources":["../../../../src/dates/wire/monthId.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAKxC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;AAC9C;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC"}

package/lib/typescript/dates/wire/parseDateId.d.ts

@@ -0,0 +1,12 @@
+import type { DateId, DateParts } from '../types';
+/**
+ * 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 declare function parseDateId(dateId: DateId): DateParts | null;
+//# sourceMappingURL=parseDateId.d.ts.map

package/lib/typescript/dates/wire/parseDateId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseDateId.d.ts","sourceRoot":"","sources":["../../../../src/dates/wire/parseDateId.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAGlD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAM5D"}