@cdx-ui/formatters 0.2.0 → 0.2.1

package/coverage.svg

@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="108" height="20" role="img" aria-label="coverage: 95.3%"><title>coverage: 95.3%</title><filter id="blur"><feGaussianBlur stdDeviation="16"/></filter><linearGradient id="s" x2="0" y2="100%"><stop offset="0" stop-color="#bbb" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient><clipPath id="r"><rect width="108" height="20" rx="3"/></clipPath><g clip-path="url(#r)"><rect width="61" height="20" fill="#555"/><rect x="61" width="47" height="20" fill="#4b0"/><rect width="108" height="20" fill="url(#s)"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><g transform="scale(.1)"><g aria-hidden="true" fill="#010101"><text x="315" y="150" fill-opacity=".8" filter="url(#blur)" textLength="510">coverage</text><text x="315" y="150" fill-opacity=".3" textLength="510">coverage</text></g><text x="315" y="140" textLength="510">coverage</text></g><g transform="scale(.1)"><g aria-hidden="true" fill="#010101"><text x="835" y="150" fill-opacity=".8" filter="url(#blur)" textLength="370">95.3%</text><text x="835" y="150" fill-opacity=".3" textLength="370">95.3%</text></g><text x="835" y="140" textLength="370">95.3%</text></g></g></svg>
+<svg xmlns="http://www.w3.org/2000/svg" width="108" height="20" role="img" aria-label="coverage: 95.7%"><title>coverage: 95.7%</title><filter id="blur"><feGaussianBlur stdDeviation="16"/></filter><linearGradient id="s" x2="0" y2="100%"><stop offset="0" stop-color="#bbb" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient><clipPath id="r"><rect width="108" height="20" rx="3"/></clipPath><g clip-path="url(#r)"><rect width="61" height="20" fill="#555"/><rect x="61" width="47" height="20" fill="#4b0"/><rect width="108" height="20" fill="url(#s)"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><g transform="scale(.1)"><g aria-hidden="true" fill="#010101"><text x="315" y="150" fill-opacity=".8" filter="url(#blur)" textLength="510">coverage</text><text x="315" y="150" fill-opacity=".3" textLength="510">coverage</text></g><text x="315" y="140" textLength="510">coverage</text></g><g transform="scale(.1)"><g aria-hidden="true" fill="#010101"><text x="835" y="150" fill-opacity=".8" filter="url(#blur)" textLength="370">95.7%</text><text x="835" y="150" fill-opacity=".3" textLength="370">95.7%</text></g><text x="835" y="140" textLength="370">95.7%</text></g></g></svg>

package/lib/commonjs/dates/index.js

@@ -147,6 +147,12 @@ Object.defineProperty(exports, "formatDateTimeListPeriod", {
     return _formatDateTimeListPeriod.formatDateTimeListPeriod;
   }
 });
+Object.defineProperty(exports, "formatDateValidationMessage", {
+  enumerable: true,
+  get: function () {
+    return _dateComponentLabels.formatDateValidationMessage;
+  }
+});
 Object.defineProperty(exports, "formatMonthCalendarMonth", {
   enumerable: true,
   get: function () {
@@ -207,6 +213,12 @@ Object.defineProperty(exports, "getDateTimeSegmentVisibility", {
     return _getDateTimeSegmentVisibility.getDateTimeSegmentVisibility;
   }
 });
+Object.defineProperty(exports, "getDateValidationReason", {
+  enumerable: true,
+  get: function () {
+    return _getDateValidationReason.getDateValidationReason;
+  }
+});
 Object.defineProperty(exports, "getEmptyDateSegmentText", {
   enumerable: true,
   get: function () {
@@ -358,6 +370,7 @@ var _getDateTimeFieldSegments = require("./segments/getDateTimeFieldSegments");
 var _getDateTimeSegmentVisibility = require("./segments/getDateTimeSegmentVisibility");
 var _getEmptyDateSegmentText = require("./segments/getEmptyDateSegmentText");
 var _parseDateSegment = require("./segments/parseDateSegment");
+var _getDateValidationReason = require("./validation/getDateValidationReason");
 var _formatCalendarMonthYear = require("./calendar/formatCalendarMonthYear");
 var _formatDateTimeListDateRow = require("./calendar/formatDateTimeListDateRow");
 var _formatMonthCalendarMonth = require("./calendar/formatMonthCalendarMonth");

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

@@ -1 +1 @@
-{"version":3,"names":["_clampDateParts","require","_clampMonthParts","_dateId","_monthId","_formatDateId","_formatMonthId","_isValidDateId","_isValidDateParts","_isValidMonthId","_isValidMonthParts","_parseDateId","_parseMonthId","_toMonthId","_todayDateId","_todayMonthId","_clampDateTimeId","_compareDateTimeIds","_dateTimeId","_formatDateTimeId","_isLocaleHour","_formatDateTimeListHour","_formatDateTimeListMinute","_formatDateTimeListPeriod","_isValidDateTimeId","_nowDateTimeId","_parseDateTimeId","_formatDateForDisplay","_formatDateRangeForDisplay","_formatDateTimeForDisplay","_formatMonthForDisplay","_compareDateIds","_compareMonthIds","_dateRangeAroundDay","_dateRangeFromLastNDays","_eachDateIdInRange","_normalizeDateRange","_applyDateSegmentChange","_formatDateSegment","_getDateFieldSegments","_getDateTimeFieldSegments","_getDateTimeSegmentVisibility","_getEmptyDateSegmentText","_parseDateSegment","_formatCalendarMonthYear","_formatDateTimeListDateRow","_formatMonthCalendarMonth","_formatMonthCalendarYear","_getCalendarWeekdayLabels","_dateComponentLabels"],"sourceRoot":"../../../src","sources":["dates/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,IAAAA,eAAA,GAAAC,OAAA;AACA,IAAAC,gBAAA,GAAAD,OAAA;AACA,IAAAE,OAAA,GAAAF,OAAA;AACA,IAAAG,QAAA,GAAAH,OAAA;AACA,IAAAI,aAAA,GAAAJ,OAAA;AACA,IAAAK,cAAA,GAAAL,OAAA;AACA,IAAAM,cAAA,GAAAN,OAAA;AACA,IAAAO,iBAAA,GAAAP,OAAA;AACA,IAAAQ,eAAA,GAAAR,OAAA;AACA,IAAAS,kBAAA,GAAAT,OAAA;AACA,IAAAU,YAAA,GAAAV,OAAA;AACA,IAAAW,aAAA,GAAAX,OAAA;AACA,IAAAY,UAAA,GAAAZ,OAAA;AACA,IAAAa,YAAA,GAAAb,OAAA;AACA,IAAAc,aAAA,GAAAd,OAAA;AAEA,IAAAe,gBAAA,GAAAf,OAAA;AACA,IAAAgB,mBAAA,GAAAhB,OAAA;AACA,IAAAiB,WAAA,GAAAjB,OAAA;AACA,IAAAkB,iBAAA,GAAAlB,OAAA;AACA,IAAAmB,aAAA,GAAAnB,OAAA;AACA,IAAAoB,uBAAA,GAAApB,OAAA;AACA,IAAAqB,yBAAA,GAAArB,OAAA;AACA,IAAAsB,yBAAA,GAAAtB,OAAA;AACA,IAAAuB,kBAAA,GAAAvB,OAAA;AACA,IAAAwB,cAAA,GAAAxB,OAAA;AACA,IAAAyB,gBAAA,GAAAzB,OAAA;AAEA,IAAA0B,qBAAA,GAAA1B,OAAA;AACA,IAAA2B,0BAAA,GAAA3B,OAAA;AACA,IAAA4B,yBAAA,GAAA5B,OAAA;AACA,IAAA6B,sBAAA,GAAA7B,OAAA;AAEA,IAAA8B,eAAA,GAAA9B,OAAA;AACA,IAAA+B,gBAAA,GAAA/B,OAAA;AACA,IAAAgC,mBAAA,GAAAhC,OAAA;AACA,IAAAiC,uBAAA,GAAAjC,OAAA;AACA,IAAAkC,kBAAA,GAAAlC,OAAA;AACA,IAAAmC,mBAAA,GAAAnC,OAAA;AAEA,IAAAoC,uBAAA,GAAApC,OAAA;AACA,IAAAqC,kBAAA,GAAArC,OAAA;AACA,IAAAsC,qBAAA,GAAAtC,OAAA;AACA,IAAAuC,yBAAA,GAAAvC,OAAA;AACA,IAAAwC,6BAAA,GAAAxC,OAAA;AACA,IAAAyC,wBAAA,GAAAzC,OAAA;AACA,IAAA0C,iBAAA,GAAA1C,OAAA;AAEA,IAAA2C,wBAAA,GAAA3C,OAAA;AACA,IAAA4C,0BAAA,GAAA5C,OAAA;AACA,IAAA6C,yBAAA,GAAA7C,OAAA;AACA,IAAA8C,wBAAA,GAAA9C,OAAA;AACA,IAAA+C,yBAAA,GAAA/C,OAAA;AAGA,IAAAgD,oBAAA,GAAAhD,OAAA","ignoreList":[]}
+{"version":3,"names":["_clampDateParts","require","_clampMonthParts","_dateId","_monthId","_formatDateId","_formatMonthId","_isValidDateId","_isValidDateParts","_isValidMonthId","_isValidMonthParts","_parseDateId","_parseMonthId","_toMonthId","_todayDateId","_todayMonthId","_clampDateTimeId","_compareDateTimeIds","_dateTimeId","_formatDateTimeId","_isLocaleHour","_formatDateTimeListHour","_formatDateTimeListMinute","_formatDateTimeListPeriod","_isValidDateTimeId","_nowDateTimeId","_parseDateTimeId","_formatDateForDisplay","_formatDateRangeForDisplay","_formatDateTimeForDisplay","_formatMonthForDisplay","_compareDateIds","_compareMonthIds","_dateRangeAroundDay","_dateRangeFromLastNDays","_eachDateIdInRange","_normalizeDateRange","_applyDateSegmentChange","_formatDateSegment","_getDateFieldSegments","_getDateTimeFieldSegments","_getDateTimeSegmentVisibility","_getEmptyDateSegmentText","_parseDateSegment","_getDateValidationReason","_formatCalendarMonthYear","_formatDateTimeListDateRow","_formatMonthCalendarMonth","_formatMonthCalendarYear","_getCalendarWeekdayLabels","_dateComponentLabels"],"sourceRoot":"../../../src","sources":["dates/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,IAAAA,eAAA,GAAAC,OAAA;AACA,IAAAC,gBAAA,GAAAD,OAAA;AACA,IAAAE,OAAA,GAAAF,OAAA;AACA,IAAAG,QAAA,GAAAH,OAAA;AACA,IAAAI,aAAA,GAAAJ,OAAA;AACA,IAAAK,cAAA,GAAAL,OAAA;AACA,IAAAM,cAAA,GAAAN,OAAA;AACA,IAAAO,iBAAA,GAAAP,OAAA;AACA,IAAAQ,eAAA,GAAAR,OAAA;AACA,IAAAS,kBAAA,GAAAT,OAAA;AACA,IAAAU,YAAA,GAAAV,OAAA;AACA,IAAAW,aAAA,GAAAX,OAAA;AACA,IAAAY,UAAA,GAAAZ,OAAA;AACA,IAAAa,YAAA,GAAAb,OAAA;AACA,IAAAc,aAAA,GAAAd,OAAA;AAEA,IAAAe,gBAAA,GAAAf,OAAA;AACA,IAAAgB,mBAAA,GAAAhB,OAAA;AACA,IAAAiB,WAAA,GAAAjB,OAAA;AACA,IAAAkB,iBAAA,GAAAlB,OAAA;AACA,IAAAmB,aAAA,GAAAnB,OAAA;AACA,IAAAoB,uBAAA,GAAApB,OAAA;AACA,IAAAqB,yBAAA,GAAArB,OAAA;AACA,IAAAsB,yBAAA,GAAAtB,OAAA;AACA,IAAAuB,kBAAA,GAAAvB,OAAA;AACA,IAAAwB,cAAA,GAAAxB,OAAA;AACA,IAAAyB,gBAAA,GAAAzB,OAAA;AAEA,IAAA0B,qBAAA,GAAA1B,OAAA;AACA,IAAA2B,0BAAA,GAAA3B,OAAA;AACA,IAAA4B,yBAAA,GAAA5B,OAAA;AACA,IAAA6B,sBAAA,GAAA7B,OAAA;AAEA,IAAA8B,eAAA,GAAA9B,OAAA;AACA,IAAA+B,gBAAA,GAAA/B,OAAA;AACA,IAAAgC,mBAAA,GAAAhC,OAAA;AACA,IAAAiC,uBAAA,GAAAjC,OAAA;AACA,IAAAkC,kBAAA,GAAAlC,OAAA;AACA,IAAAmC,mBAAA,GAAAnC,OAAA;AAEA,IAAAoC,uBAAA,GAAApC,OAAA;AACA,IAAAqC,kBAAA,GAAArC,OAAA;AACA,IAAAsC,qBAAA,GAAAtC,OAAA;AACA,IAAAuC,yBAAA,GAAAvC,OAAA;AACA,IAAAwC,6BAAA,GAAAxC,OAAA;AACA,IAAAyC,wBAAA,GAAAzC,OAAA;AACA,IAAA0C,iBAAA,GAAA1C,OAAA;AAEA,IAAA2C,wBAAA,GAAA3C,OAAA;AAEA,IAAA4C,wBAAA,GAAA5C,OAAA;AACA,IAAA6C,0BAAA,GAAA7C,OAAA;AACA,IAAA8C,yBAAA,GAAA9C,OAAA;AACA,IAAA+C,wBAAA,GAAA/C,OAAA;AACA,IAAAgD,yBAAA,GAAAhD,OAAA;AAGA,IAAAiD,oBAAA,GAAAjD,OAAA","ignoreList":[]}

package/lib/commonjs/dates/labels/dateComponentLabels.js

@@ -4,9 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.DEFAULT_DATE_COMPONENT_LABELS = void 0;
+exports.formatDateValidationMessage = formatDateValidationMessage;
 exports.formatSelectYear = formatSelectYear;
 exports.getDateSegmentAccessibilityLabel = getDateSegmentAccessibilityLabel;
 exports.resolveDateComponentLabels = resolveDateComponentLabels;
+var _formatDateForDisplay = require("../display/formatDateForDisplay");
 /** Overridable UI copy for date pickers, calendars, and segmented date fields. */
 
 const DEFAULT_DATE_COMPONENT_LABELS = exports.DEFAULT_DATE_COMPONENT_LABELS = {
@@ -30,7 +32,11 @@ const DEFAULT_DATE_COMPONENT_LABELS = exports.DEFAULT_DATE_COMPONENT_LABELS = {
   segmentMinute: 'Minute',
   segmentSecond: 'Second',
   segmentDayPeriod: 'AM/PM',
-  rangeSeparator: '–'
+  segmentInvalid: '{segment}, invalid',
+  rangeSeparator: '–',
+  validationBeforeMin: 'Select a date on or after {date}',
+  validationAfterMax: 'Select a date on or before {date}',
+  validationUnavailable: 'This date is unavailable'
 };
 function resolveDateComponentLabels(partial) {
   return {
@@ -41,6 +47,37 @@ function resolveDateComponentLabels(partial) {
 function formatSelectYear(labels, year) {
   return labels.selectYear.replace('{year}', String(year));
 }
+const VALIDATION_LABEL_KEYS = {
+  beforeMin: 'validationBeforeMin',
+  afterMax: 'validationAfterMax',
+  unavailable: 'validationUnavailable'
+};
+
+/**
+ * Resolves the user-facing message for a {@link DateValidationReason}.
+ *
+ * `{date}` in the min / max messages is replaced with the bound, formatted for display
+ * with `options.locale` and `options.dateStyle` (defaults: `en-US`, `medium`). `DatePicker`
+ * already formats this message with its own `labels` and `locale` (see `onValidationChange`
+ * and `Field.Error`); call this directly only outside a picker, and pass the same `locale`.
+ *
+ * @param labels - Resolved labels (see `resolveDateComponentLabels`).
+ * @param reason - Reason returned by `getDateValidationReason` or `onValidationChange`.
+ * @param rules - The bounds the reason was computed against.
+ * @param options - Display options for the `{date}` placeholder.
+ * @returns The message to render in `Field.Error`.
+ */
+function formatDateValidationMessage(labels, reason, rules, options) {
+  const message = labels[VALIDATION_LABEL_KEYS[reason]];
+  const bound = reason === 'beforeMin' ? rules.minValue : reason === 'afterMax' ? rules.maxValue : undefined;
+  if (bound === undefined) {
+    return message;
+  }
+  return message.replace('{date}', (0, _formatDateForDisplay.formatDateForDisplay)(bound, {
+    dateStyle: 'medium',
+    ...options
+  }));
+}
 const SEGMENT_LABEL_KEYS = {
   year: 'segmentYear',
   month: 'segmentMonth',
@@ -50,8 +87,16 @@ const SEGMENT_LABEL_KEYS = {
   second: 'segmentSecond',
   dayPeriod: 'segmentDayPeriod'
 };
-function getDateSegmentAccessibilityLabel(type, labels) {
+
+/**
+ * @param invalid - Wraps the label in `labels.segmentInvalid`, for native platforms where
+ *   `aria-invalid` is not announced.
+ */
+function getDateSegmentAccessibilityLabel(type, labels, invalid = false) {
   const key = SEGMENT_LABEL_KEYS[type];
-  return key ? labels[key] : undefined;
+  if (!key) {
+    return undefined;
+  }
+  return invalid ? labels.segmentInvalid.replace('{segment}', labels[key]) : labels[key];
 }
 //# sourceMappingURL=dateComponentLabels.js.map

package/lib/commonjs/dates/labels/dateComponentLabels.js.map

@@ -1 +1 @@
-{"version":3,"names":["DEFAULT_DATE_COMPONENT_LABELS","exports","openDatePicker","openDateTimePicker","openDateRangePicker","openMonthPicker","showCalendar","showYearPicker","showMonths","previousMonth","nextMonth","previousYear","nextYear","selectYear","dateFieldKeyboardInput","segmentYear","segmentMonth","segmentDay","segmentHour","segmentMinute","segmentSecond","segmentDayPeriod","rangeSeparator","resolveDateComponentLabels","partial","formatSelectYear","labels","year","replace","String","SEGMENT_LABEL_KEYS","month","day","hour","minute","second","dayPeriod","getDateSegmentAccessibilityLabel","type","key","undefined"],"sourceRoot":"../../../../src","sources":["dates/labels/dateComponentLabels.ts"],"mappings":";;;;;;;;;AAEA;;AA0BO,MAAMA,6BAAkD,GAAAC,OAAA,CAAAD,6BAAA,GAAG;EAChEE,cAAc,EAAE,kBAAkB;EAClCC,kBAAkB,EAAE,uBAAuB;EAC3CC,mBAAmB,EAAE,wBAAwB;EAC7CC,eAAe,EAAE,mBAAmB;EACpCC,YAAY,EAAE,eAAe;EAC7BC,cAAc,EAAE,kBAAkB;EAClCC,UAAU,EAAE,aAAa;EACzBC,aAAa,EAAE,gBAAgB;EAC/BC,SAAS,EAAE,YAAY;EACvBC,YAAY,EAAE,eAAe;EAC7BC,QAAQ,EAAE,WAAW;EACrBC,UAAU,EAAE,oBAAoB;EAChCC,sBAAsB,EAAE,2BAA2B;EACnDC,WAAW,EAAE,MAAM;EACnBC,YAAY,EAAE,OAAO;EACrBC,UAAU,EAAE,KAAK;EACjBC,WAAW,EAAE,MAAM;EACnBC,aAAa,EAAE,QAAQ;EACvBC,aAAa,EAAE,QAAQ;EACvBC,gBAAgB,EAAE,OAAO;EACzBC,cAAc,EAAE;AAClB,CAAC;AAEM,SAASC,0BAA0BA,CACxCC,OAAsC,EACjB;EACrB,OAAO;IAAE,GAAGxB,6BAA6B;IAAE,GAAGwB;EAAQ,CAAC;AACzD;AAEO,SAASC,gBAAgBA,CAACC,MAA2B,EAAEC,IAAY,EAAU;EAClF,OAAOD,MAAM,CAACb,UAAU,CAACe,OAAO,CAAC,QAAQ,EAAEC,MAAM,CAACF,IAAI,CAAC,CAAC;AAC1D;AAEA,MAAMG,kBAA+E,GAAG;EACtFH,IAAI,EAAE,aAAa;EACnBI,KAAK,EAAE,cAAc;EACrBC,GAAG,EAAE,YAAY;EACjBC,IAAI,EAAE,aAAa;EACnBC,MAAM,EAAE,eAAe;EACvBC,MAAM,EAAE,eAAe;EACvBC,SAAS,EAAE;AACb,CAAC;AAEM,SAASC,gCAAgCA,CAC9CC,IAAqB,EACrBZ,MAA2B,EACP;EACpB,MAAMa,GAAG,GAAGT,kBAAkB,CAACQ,IAAI,CAAC;EACpC,OAAOC,GAAG,GAAGb,MAAM,CAACa,GAAG,CAAC,GAAGC,SAAS;AACtC","ignoreList":[]}
+{"version":3,"names":["_formatDateForDisplay","require","DEFAULT_DATE_COMPONENT_LABELS","exports","openDatePicker","openDateTimePicker","openDateRangePicker","openMonthPicker","showCalendar","showYearPicker","showMonths","previousMonth","nextMonth","previousYear","nextYear","selectYear","dateFieldKeyboardInput","segmentYear","segmentMonth","segmentDay","segmentHour","segmentMinute","segmentSecond","segmentDayPeriod","segmentInvalid","rangeSeparator","validationBeforeMin","validationAfterMax","validationUnavailable","resolveDateComponentLabels","partial","formatSelectYear","labels","year","replace","String","VALIDATION_LABEL_KEYS","beforeMin","afterMax","unavailable","formatDateValidationMessage","reason","rules","options","message","bound","minValue","maxValue","undefined","formatDateForDisplay","dateStyle","SEGMENT_LABEL_KEYS","month","day","hour","minute","second","dayPeriod","getDateSegmentAccessibilityLabel","type","invalid","key"],"sourceRoot":"../../../../src","sources":["dates/labels/dateComponentLabels.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/dates/validation/getDateValidationReason.js

@@ -0,0 +1,33 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getDateValidationReason = getDateValidationReason;
+var _compareDateIds = require("../ranges/compareDateIds");
+/**
+ * Checks a complete wire date against `minValue`, `maxValue`, and `isDateUnavailable`.
+ *
+ * Bounds are inclusive and are checked before the predicate, so a date outside
+ * the range reports `beforeMin` / `afterMax` even when it is also unavailable.
+ *
+ * @param date - Wire date to check.
+ * @param rules - Bounds and unavailable-date predicate.
+ * @returns The first rule the date violates, or `undefined` when it is selectable.
+ *
+ * @example
+ * getDateValidationReason(dateId('2026-08-01'), { minValue: dateId('2026-08-10') }) // 'beforeMin'
+ */
+function getDateValidationReason(date, rules) {
+  if (rules.minValue !== undefined && (0, _compareDateIds.compareDateIds)(date, rules.minValue) < 0) {
+    return 'beforeMin';
+  }
+  if (rules.maxValue !== undefined && (0, _compareDateIds.compareDateIds)(date, rules.maxValue) > 0) {
+    return 'afterMax';
+  }
+  if (rules.isDateUnavailable?.(date)) {
+    return 'unavailable';
+  }
+  return undefined;
+}
+//# sourceMappingURL=getDateValidationReason.js.map

package/lib/commonjs/dates/validation/getDateValidationReason.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_compareDateIds","require","getDateValidationReason","date","rules","minValue","undefined","compareDateIds","maxValue","isDateUnavailable"],"sourceRoot":"../../../../src","sources":["dates/validation/getDateValidationReason.ts"],"mappings":";;;;;;AAAA,IAAAA,eAAA,GAAAC,OAAA;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,uBAAuBA,CACrCC,IAAY,EACZC,KAA0B,EACQ;EAClC,IAAIA,KAAK,CAACC,QAAQ,KAAKC,SAAS,IAAI,IAAAC,8BAAc,EAACJ,IAAI,EAAEC,KAAK,CAACC,QAAQ,CAAC,GAAG,CAAC,EAAE;IAC5E,OAAO,WAAW;EACpB;EACA,IAAID,KAAK,CAACI,QAAQ,KAAKF,SAAS,IAAI,IAAAC,8BAAc,EAACJ,IAAI,EAAEC,KAAK,CAACI,QAAQ,CAAC,GAAG,CAAC,EAAE;IAC5E,OAAO,UAAU;EACnB;EACA,IAAIJ,KAAK,CAACK,iBAAiB,GAAGN,IAAI,CAAC,EAAE;IACnC,OAAO,aAAa;EACtB;EACA,OAAOG,SAAS;AAClB","ignoreList":[]}

package/lib/commonjs/index.js

@@ -147,6 +147,12 @@ Object.defineProperty(exports, "formatDateTimeListPeriod", {
     return _dates.formatDateTimeListPeriod;
   }
 });
+Object.defineProperty(exports, "formatDateValidationMessage", {
+  enumerable: true,
+  get: function () {
+    return _dates.formatDateValidationMessage;
+  }
+});
 Object.defineProperty(exports, "formatMonthCalendarMonth", {
   enumerable: true,
   get: function () {
@@ -213,6 +219,12 @@ Object.defineProperty(exports, "getDateTimeSegmentVisibility", {
     return _dates.getDateTimeSegmentVisibility;
   }
 });
+Object.defineProperty(exports, "getDateValidationReason", {
+  enumerable: true,
+  get: function () {
+    return _dates.getDateValidationReason;
+  }
+});
 Object.defineProperty(exports, "getEmptyDateSegmentText", {
   enumerable: true,
   get: function () {

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_formatNumber","require","_dates"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,aAAA,GAAAC,OAAA;AAoBA,IAAAC,MAAA,GAAAD,OAAA","ignoreList":[]}
+{"version":3,"names":["_formatNumber","require","_dates"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,aAAA,GAAAC,OAAA;AAsBA,IAAAC,MAAA,GAAAD,OAAA","ignoreList":[]}

package/lib/module/dates/index.js

@@ -50,10 +50,11 @@ export { getDateTimeFieldSegments } from './segments/getDateTimeFieldSegments';
 export { getDateTimeSegmentVisibility } from './segments/getDateTimeSegmentVisibility';
 export { getEmptyDateSegmentText } from './segments/getEmptyDateSegmentText';
 export { parseDateSegment } from './segments/parseDateSegment';
+export { getDateValidationReason } from './validation/getDateValidationReason';
 export { formatCalendarMonthYear } from './calendar/formatCalendarMonthYear';
 export { formatDateTimeListDateRow } from './calendar/formatDateTimeListDateRow';
 export { formatMonthCalendarMonth } from './calendar/formatMonthCalendarMonth';
 export { formatMonthCalendarYear } from './calendar/formatMonthCalendarYear';
 export { getCalendarWeekdayLabels } from './calendar/getCalendarWeekdayLabels';
-export { DEFAULT_DATE_COMPONENT_LABELS, formatSelectYear, getDateSegmentAccessibilityLabel, resolveDateComponentLabels } from './labels/dateComponentLabels';
+export { DEFAULT_DATE_COMPONENT_LABELS, formatDateValidationMessage, formatSelectYear, getDateSegmentAccessibilityLabel, resolveDateComponentLabels } from './labels/dateComponentLabels';
 //# sourceMappingURL=index.js.map

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

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

package/lib/module/dates/labels/dateComponentLabels.js

@@ -1,5 +1,7 @@
 "use strict";
 
+import { formatDateForDisplay } from '../display/formatDateForDisplay';
+
 /** Overridable UI copy for date pickers, calendars, and segmented date fields. */
 
 export const DEFAULT_DATE_COMPONENT_LABELS = {
@@ -23,7 +25,11 @@ export const DEFAULT_DATE_COMPONENT_LABELS = {
   segmentMinute: 'Minute',
   segmentSecond: 'Second',
   segmentDayPeriod: 'AM/PM',
-  rangeSeparator: '–'
+  segmentInvalid: '{segment}, invalid',
+  rangeSeparator: '–',
+  validationBeforeMin: 'Select a date on or after {date}',
+  validationAfterMax: 'Select a date on or before {date}',
+  validationUnavailable: 'This date is unavailable'
 };
 export function resolveDateComponentLabels(partial) {
   return {
@@ -34,6 +40,37 @@ export function resolveDateComponentLabels(partial) {
 export function formatSelectYear(labels, year) {
   return labels.selectYear.replace('{year}', String(year));
 }
+const VALIDATION_LABEL_KEYS = {
+  beforeMin: 'validationBeforeMin',
+  afterMax: 'validationAfterMax',
+  unavailable: 'validationUnavailable'
+};
+
+/**
+ * Resolves the user-facing message for a {@link DateValidationReason}.
+ *
+ * `{date}` in the min / max messages is replaced with the bound, formatted for display
+ * with `options.locale` and `options.dateStyle` (defaults: `en-US`, `medium`). `DatePicker`
+ * already formats this message with its own `labels` and `locale` (see `onValidationChange`
+ * and `Field.Error`); call this directly only outside a picker, and pass the same `locale`.
+ *
+ * @param labels - Resolved labels (see `resolveDateComponentLabels`).
+ * @param reason - Reason returned by `getDateValidationReason` or `onValidationChange`.
+ * @param rules - The bounds the reason was computed against.
+ * @param options - Display options for the `{date}` placeholder.
+ * @returns The message to render in `Field.Error`.
+ */
+export function formatDateValidationMessage(labels, reason, rules, options) {
+  const message = labels[VALIDATION_LABEL_KEYS[reason]];
+  const bound = reason === 'beforeMin' ? rules.minValue : reason === 'afterMax' ? rules.maxValue : undefined;
+  if (bound === undefined) {
+    return message;
+  }
+  return message.replace('{date}', formatDateForDisplay(bound, {
+    dateStyle: 'medium',
+    ...options
+  }));
+}
 const SEGMENT_LABEL_KEYS = {
   year: 'segmentYear',
   month: 'segmentMonth',
@@ -43,8 +80,16 @@ const SEGMENT_LABEL_KEYS = {
   second: 'segmentSecond',
   dayPeriod: 'segmentDayPeriod'
 };
-export function getDateSegmentAccessibilityLabel(type, labels) {
+
+/**
+ * @param invalid - Wraps the label in `labels.segmentInvalid`, for native platforms where
+ *   `aria-invalid` is not announced.
+ */
+export function getDateSegmentAccessibilityLabel(type, labels, invalid = false) {
   const key = SEGMENT_LABEL_KEYS[type];
-  return key ? labels[key] : undefined;
+  if (!key) {
+    return undefined;
+  }
+  return invalid ? labels.segmentInvalid.replace('{segment}', labels[key]) : labels[key];
 }
 //# sourceMappingURL=dateComponentLabels.js.map

package/lib/module/dates/labels/dateComponentLabels.js.map

@@ -1 +1 @@
-{"version":3,"names":["DEFAULT_DATE_COMPONENT_LABELS","openDatePicker","openDateTimePicker","openDateRangePicker","openMonthPicker","showCalendar","showYearPicker","showMonths","previousMonth","nextMonth","previousYear","nextYear","selectYear","dateFieldKeyboardInput","segmentYear","segmentMonth","segmentDay","segmentHour","segmentMinute","segmentSecond","segmentDayPeriod","rangeSeparator","resolveDateComponentLabels","partial","formatSelectYear","labels","year","replace","String","SEGMENT_LABEL_KEYS","month","day","hour","minute","second","dayPeriod","getDateSegmentAccessibilityLabel","type","key","undefined"],"sourceRoot":"../../../../src","sources":["dates/labels/dateComponentLabels.ts"],"mappings":";;AAEA;;AA0BA,OAAO,MAAMA,6BAAkD,GAAG;EAChEC,cAAc,EAAE,kBAAkB;EAClCC,kBAAkB,EAAE,uBAAuB;EAC3CC,mBAAmB,EAAE,wBAAwB;EAC7CC,eAAe,EAAE,mBAAmB;EACpCC,YAAY,EAAE,eAAe;EAC7BC,cAAc,EAAE,kBAAkB;EAClCC,UAAU,EAAE,aAAa;EACzBC,aAAa,EAAE,gBAAgB;EAC/BC,SAAS,EAAE,YAAY;EACvBC,YAAY,EAAE,eAAe;EAC7BC,QAAQ,EAAE,WAAW;EACrBC,UAAU,EAAE,oBAAoB;EAChCC,sBAAsB,EAAE,2BAA2B;EACnDC,WAAW,EAAE,MAAM;EACnBC,YAAY,EAAE,OAAO;EACrBC,UAAU,EAAE,KAAK;EACjBC,WAAW,EAAE,MAAM;EACnBC,aAAa,EAAE,QAAQ;EACvBC,aAAa,EAAE,QAAQ;EACvBC,gBAAgB,EAAE,OAAO;EACzBC,cAAc,EAAE;AAClB,CAAC;AAED,OAAO,SAASC,0BAA0BA,CACxCC,OAAsC,EACjB;EACrB,OAAO;IAAE,GAAGvB,6BAA6B;IAAE,GAAGuB;EAAQ,CAAC;AACzD;AAEA,OAAO,SAASC,gBAAgBA,CAACC,MAA2B,EAAEC,IAAY,EAAU;EAClF,OAAOD,MAAM,CAACb,UAAU,CAACe,OAAO,CAAC,QAAQ,EAAEC,MAAM,CAACF,IAAI,CAAC,CAAC;AAC1D;AAEA,MAAMG,kBAA+E,GAAG;EACtFH,IAAI,EAAE,aAAa;EACnBI,KAAK,EAAE,cAAc;EACrBC,GAAG,EAAE,YAAY;EACjBC,IAAI,EAAE,aAAa;EACnBC,MAAM,EAAE,eAAe;EACvBC,MAAM,EAAE,eAAe;EACvBC,SAAS,EAAE;AACb,CAAC;AAED,OAAO,SAASC,gCAAgCA,CAC9CC,IAAqB,EACrBZ,MAA2B,EACP;EACpB,MAAMa,GAAG,GAAGT,kBAAkB,CAACQ,IAAI,CAAC;EACpC,OAAOC,GAAG,GAAGb,MAAM,CAACa,GAAG,CAAC,GAAGC,SAAS;AACtC","ignoreList":[]}
+{"version":3,"names":["formatDateForDisplay","DEFAULT_DATE_COMPONENT_LABELS","openDatePicker","openDateTimePicker","openDateRangePicker","openMonthPicker","showCalendar","showYearPicker","showMonths","previousMonth","nextMonth","previousYear","nextYear","selectYear","dateFieldKeyboardInput","segmentYear","segmentMonth","segmentDay","segmentHour","segmentMinute","segmentSecond","segmentDayPeriod","segmentInvalid","rangeSeparator","validationBeforeMin","validationAfterMax","validationUnavailable","resolveDateComponentLabels","partial","formatSelectYear","labels","year","replace","String","VALIDATION_LABEL_KEYS","beforeMin","afterMax","unavailable","formatDateValidationMessage","reason","rules","options","message","bound","minValue","maxValue","undefined","dateStyle","SEGMENT_LABEL_KEYS","month","day","hour","minute","second","dayPeriod","getDateSegmentAccessibilityLabel","type","invalid","key"],"sourceRoot":"../../../../src","sources":["dates/labels/dateComponentLabels.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/dates/validation/getDateValidationReason.js

@@ -0,0 +1,29 @@
+"use strict";
+
+import { compareDateIds } from '../ranges/compareDateIds';
+/**
+ * Checks a complete wire date against `minValue`, `maxValue`, and `isDateUnavailable`.
+ *
+ * Bounds are inclusive and are checked before the predicate, so a date outside
+ * the range reports `beforeMin` / `afterMax` even when it is also unavailable.
+ *
+ * @param date - Wire date to check.
+ * @param rules - Bounds and unavailable-date predicate.
+ * @returns The first rule the date violates, or `undefined` when it is selectable.
+ *
+ * @example
+ * getDateValidationReason(dateId('2026-08-01'), { minValue: dateId('2026-08-10') }) // 'beforeMin'
+ */
+export function getDateValidationReason(date, rules) {
+  if (rules.minValue !== undefined && compareDateIds(date, rules.minValue) < 0) {
+    return 'beforeMin';
+  }
+  if (rules.maxValue !== undefined && compareDateIds(date, rules.maxValue) > 0) {
+    return 'afterMax';
+  }
+  if (rules.isDateUnavailable?.(date)) {
+    return 'unavailable';
+  }
+  return undefined;
+}
+//# sourceMappingURL=getDateValidationReason.js.map

package/lib/module/dates/validation/getDateValidationReason.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["compareDateIds","getDateValidationReason","date","rules","minValue","undefined","maxValue","isDateUnavailable"],"sourceRoot":"../../../../src","sources":["dates/validation/getDateValidationReason.ts"],"mappings":";;AAAA,SAASA,cAAc,QAAQ,0BAA0B;AAGzD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,uBAAuBA,CACrCC,IAAY,EACZC,KAA0B,EACQ;EAClC,IAAIA,KAAK,CAACC,QAAQ,KAAKC,SAAS,IAAIL,cAAc,CAACE,IAAI,EAAEC,KAAK,CAACC,QAAQ,CAAC,GAAG,CAAC,EAAE;IAC5E,OAAO,WAAW;EACpB;EACA,IAAID,KAAK,CAACG,QAAQ,KAAKD,SAAS,IAAIL,cAAc,CAACE,IAAI,EAAEC,KAAK,CAACG,QAAQ,CAAC,GAAG,CAAC,EAAE;IAC5E,OAAO,UAAU;EACnB;EACA,IAAIH,KAAK,CAACI,iBAAiB,GAAGL,IAAI,CAAC,EAAE;IACnC,OAAO,aAAa;EACtB;EACA,OAAOG,SAAS;AAClB","ignoreList":[]}

package/lib/module/index.js

@@ -12,6 +12,8 @@ formatDateForDisplay, formatDateRangeForDisplay, formatDateTimeForDisplay, forma
 compareDateIds, compareMonthIds, dateRangeAroundDay, dateRangeFromLastNDays, eachDateIdInRange, normalizeDateRange,
 // Segmented field helpers
 applyDateSegmentChange, formatDateSegment, getDateFieldSegments, getDateTimeFieldSegments, getDateTimeSegmentVisibility, getEmptyDateSegmentText, parseDateSegment,
+// Validation
+getDateValidationReason,
 // Calendar / list copy
-formatCalendarMonthYear, formatDateTimeListDateRow, formatDateTimeListHour, formatDateTimeListMinute, formatDateTimeListPeriod, formatMonthCalendarMonth, formatMonthCalendarYear, getCalendarWeekdayLabels, DEFAULT_DATE_COMPONENT_LABELS, formatSelectYear, getDateSegmentAccessibilityLabel, resolveDateComponentLabels } from './dates';
+formatCalendarMonthYear, formatDateTimeListDateRow, formatDateTimeListHour, formatDateTimeListMinute, formatDateTimeListPeriod, formatMonthCalendarMonth, formatMonthCalendarYear, getCalendarWeekdayLabels, DEFAULT_DATE_COMPONENT_LABELS, formatDateValidationMessage, formatSelectYear, getDateSegmentAccessibilityLabel, resolveDateComponentLabels } from './dates';
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["formatNumber","clampDateParts","clampMonthParts","dateId","monthId","formatDateId","formatMonthId","isValidDateId","isValidDateParts","isValidMonthId","isValidMonthParts","parseDateId","parseMonthId","toMonthId","todayDateId","todayMonthId","clampDateTimeId","compareDateTimeIds","dateTimeId","formatDateTimeId","isLocaleHour12","isValidDateTimeId","nowDateTimeId","parseDateTimeId","formatDateForDisplay","formatDateRangeForDisplay","formatDateTimeForDisplay","formatMonthForDisplay","compareDateIds","compareMonthIds","dateRangeAroundDay","dateRangeFromLastNDays","eachDateIdInRange","normalizeDateRange","applyDateSegmentChange","formatDateSegment","getDateFieldSegments","getDateTimeFieldSegments","getDateTimeSegmentVisibility","getEmptyDateSegmentText","parseDateSegment","formatCalendarMonthYear","formatDateTimeListDateRow","formatDateTimeListHour","formatDateTimeListMinute","formatDateTimeListPeriod","formatMonthCalendarMonth","formatMonthCalendarYear","getCalendarWeekdayLabels","DEFAULT_DATE_COMPONENT_LABELS","formatSelectYear","getDateSegmentAccessibilityLabel","resolveDateComponentLabels"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,SAASA,YAAY,QAAkC,gBAAgB;AAoBvE;AACE;AACAC,cAAc,EACdC,eAAe,EACfC,MAAM,EACNC,OAAO,EACPC,YAAY,EACZC,aAAa,EACbC,aAAa,EACbC,gBAAgB,EAChBC,cAAc,EACdC,iBAAiB,EACjBC,WAAW,EACXC,YAAY,EACZC,SAAS,EACTC,WAAW,EACXC,YAAY;AACZ;AACAC,eAAe,EACfC,kBAAkB,EAClBC,UAAU,EACVC,gBAAgB,EAChBC,cAAc,EACdC,iBAAiB,EACjBC,aAAa,EACbC,eAAe;AACf;AACAC,oBAAoB,EACpBC,yBAAyB,EACzBC,wBAAwB,EACxBC,qBAAqB;AACrB;AACAC,cAAc,EACdC,eAAe,EACfC,kBAAkB,EAClBC,sBAAsB,EACtBC,iBAAiB,EACjBC,kBAAkB;AAClB;AACAC,sBAAsB,EACtBC,iBAAiB,EACjBC,oBAAoB,EACpBC,wBAAwB,EACxBC,4BAA4B,EAC5BC,uBAAuB,EACvBC,gBAAgB;AAChB;AACAC,uBAAuB,EACvBC,yBAAyB,EACzBC,sBAAsB,EACtBC,wBAAwB,EACxBC,wBAAwB,EACxBC,wBAAwB,EACxBC,uBAAuB,EACvBC,wBAAwB,EACxBC,6BAA6B,EAC7BC,gBAAgB,EAChBC,gCAAgC,EAChCC,0BAA0B,QACrB,SAAS","ignoreList":[]}
+{"version":3,"names":["formatNumber","clampDateParts","clampMonthParts","dateId","monthId","formatDateId","formatMonthId","isValidDateId","isValidDateParts","isValidMonthId","isValidMonthParts","parseDateId","parseMonthId","toMonthId","todayDateId","todayMonthId","clampDateTimeId","compareDateTimeIds","dateTimeId","formatDateTimeId","isLocaleHour12","isValidDateTimeId","nowDateTimeId","parseDateTimeId","formatDateForDisplay","formatDateRangeForDisplay","formatDateTimeForDisplay","formatMonthForDisplay","compareDateIds","compareMonthIds","dateRangeAroundDay","dateRangeFromLastNDays","eachDateIdInRange","normalizeDateRange","applyDateSegmentChange","formatDateSegment","getDateFieldSegments","getDateTimeFieldSegments","getDateTimeSegmentVisibility","getEmptyDateSegmentText","parseDateSegment","getDateValidationReason","formatCalendarMonthYear","formatDateTimeListDateRow","formatDateTimeListHour","formatDateTimeListMinute","formatDateTimeListPeriod","formatMonthCalendarMonth","formatMonthCalendarYear","getCalendarWeekdayLabels","DEFAULT_DATE_COMPONENT_LABELS","formatDateValidationMessage","formatSelectYear","getDateSegmentAccessibilityLabel","resolveDateComponentLabels"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,SAASA,YAAY,QAAkC,gBAAgB;AAsBvE;AACE;AACAC,cAAc,EACdC,eAAe,EACfC,MAAM,EACNC,OAAO,EACPC,YAAY,EACZC,aAAa,EACbC,aAAa,EACbC,gBAAgB,EAChBC,cAAc,EACdC,iBAAiB,EACjBC,WAAW,EACXC,YAAY,EACZC,SAAS,EACTC,WAAW,EACXC,YAAY;AACZ;AACAC,eAAe,EACfC,kBAAkB,EAClBC,UAAU,EACVC,gBAAgB,EAChBC,cAAc,EACdC,iBAAiB,EACjBC,aAAa,EACbC,eAAe;AACf;AACAC,oBAAoB,EACpBC,yBAAyB,EACzBC,wBAAwB,EACxBC,qBAAqB;AACrB;AACAC,cAAc,EACdC,eAAe,EACfC,kBAAkB,EAClBC,sBAAsB,EACtBC,iBAAiB,EACjBC,kBAAkB;AAClB;AACAC,sBAAsB,EACtBC,iBAAiB,EACjBC,oBAAoB,EACpBC,wBAAwB,EACxBC,4BAA4B,EAC5BC,uBAAuB,EACvBC,gBAAgB;AAChB;AACAC,uBAAuB;AACvB;AACAC,uBAAuB,EACvBC,yBAAyB,EACzBC,sBAAsB,EACtBC,wBAAwB,EACxBC,wBAAwB,EACxBC,wBAAwB,EACxBC,uBAAuB,EACvBC,wBAAwB,EACxBC,6BAA6B,EAC7BC,2BAA2B,EAC3BC,gBAAgB,EAChBC,gCAAgC,EAChCC,0BAA0B,QACrB,SAAS","ignoreList":[]}

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

@@ -4,7 +4,7 @@
  * Wire ids (`DateId`, `MonthId`, `DateTimeId`) are fixed-format strings for state and APIs.
  * Display helpers return locale-dependent strings for UI labels — never store those in form state.
  */
-export type { DateFieldMode, DateFormatOptions, DateId, DateParts, DateRangeDisplayOptions, DateSegment, DateSegmentType, DateTimeGranularity, DateTimeId, DateTimeParts, FormatDateDisplayOptions, FormatDateTimeDisplayOptions, MonthId, MonthParts, TimeParts, } from './types';
+export type { DateFieldMode, DateFormatOptions, DateId, DateParts, DateRangeDisplayOptions, DateSegment, DateSegmentType, DateTimeGranularity, DateTimeId, DateTimeParts, DateValidationReason, DateValidationRules, FormatDateDisplayOptions, FormatDateTimeDisplayOptions, MonthId, MonthParts, TimeParts, } from './types';
 export { clampDateParts } from './wire/clampDateParts';
 export { clampMonthParts } from './wire/clampMonthParts';
 export { dateId } from './wire/dateId';
@@ -48,11 +48,12 @@ export { getDateTimeFieldSegments } from './segments/getDateTimeFieldSegments';
 export { getDateTimeSegmentVisibility } from './segments/getDateTimeSegmentVisibility';
 export { getEmptyDateSegmentText } from './segments/getEmptyDateSegmentText';
 export { parseDateSegment } from './segments/parseDateSegment';
+export { getDateValidationReason } from './validation/getDateValidationReason';
 export { formatCalendarMonthYear } from './calendar/formatCalendarMonthYear';
 export { formatDateTimeListDateRow } from './calendar/formatDateTimeListDateRow';
 export { formatMonthCalendarMonth } from './calendar/formatMonthCalendarMonth';
 export { formatMonthCalendarYear } from './calendar/formatMonthCalendarYear';
 export { getCalendarWeekdayLabels } from './calendar/getCalendarWeekdayLabels';
 export type { DateComponentLabels } from './labels/dateComponentLabels';
-export { DEFAULT_DATE_COMPONENT_LABELS, formatSelectYear, getDateSegmentAccessibilityLabel, resolveDateComponentLabels, } from './labels/dateComponentLabels';
+export { DEFAULT_DATE_COMPONENT_LABELS, formatDateValidationMessage, formatSelectYear, getDateSegmentAccessibilityLabel, resolveDateComponentLabels, } from './labels/dateComponentLabels';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/dates/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/dates/index.ts"],"names":[],"mappings":"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"}

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

@@ -1,4 +1,4 @@
-import type { DateSegmentType } from '../types';
+import type { DateSegmentType, DateValidationReason, DateValidationRules, FormatDateDisplayOptions } from '../types';
 /** Overridable UI copy for date pickers, calendars, and segmented date fields. */
 export interface DateComponentLabels {
     openDatePicker: string;
@@ -22,10 +22,39 @@ export interface DateComponentLabels {
     segmentMinute: string;
     segmentSecond: string;
     segmentDayPeriod: string;
+    /**
+     * Native accessible name of a segment while the field is invalid — iOS and Android have no
+     * equivalent of `aria-invalid`. Use `{segment}` as the segment label placeholder.
+     */
+    segmentInvalid: string;
     rangeSeparator: string;
+    /** Use `{date}` as the `minValue` placeholder. */
+    validationBeforeMin: string;
+    /** Use `{date}` as the `maxValue` placeholder. */
+    validationAfterMax: string;
+    validationUnavailable: 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;
+/**
+ * Resolves the user-facing message for a {@link DateValidationReason}.
+ *
+ * `{date}` in the min / max messages is replaced with the bound, formatted for display
+ * with `options.locale` and `options.dateStyle` (defaults: `en-US`, `medium`). `DatePicker`
+ * already formats this message with its own `labels` and `locale` (see `onValidationChange`
+ * and `Field.Error`); call this directly only outside a picker, and pass the same `locale`.
+ *
+ * @param labels - Resolved labels (see `resolveDateComponentLabels`).
+ * @param reason - Reason returned by `getDateValidationReason` or `onValidationChange`.
+ * @param rules - The bounds the reason was computed against.
+ * @param options - Display options for the `{date}` placeholder.
+ * @returns The message to render in `Field.Error`.
+ */
+export declare function formatDateValidationMessage(labels: DateComponentLabels, reason: DateValidationReason, rules: Pick<DateValidationRules, 'minValue' | 'maxValue'>, options?: FormatDateDisplayOptions): string;
+/**
+ * @param invalid - Wraps the label in `labels.segmentInvalid`, for native platforms where
+ *   `aria-invalid` is not announced.
+ */
+export declare function getDateSegmentAccessibilityLabel(type: DateSegmentType, labels: DateComponentLabels, invalid?: boolean): string | undefined;
 //# sourceMappingURL=dateComponentLabels.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"dateComponentLabels.d.ts","sourceRoot":"","sources":["../../../../src/dates/labels/dateComponentLabels.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACzB,MAAM,UAAU,CAAC;AAElB,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;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,kDAAkD;IAClD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kDAAkD;IAClD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,eAAO,MAAM,6BAA6B,EAAE,mBA0B3C,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;AAQD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,oBAAoB,EAC5B,KAAK,EAAE,IAAI,CAAC,mBAAmB,EAAE,UAAU,GAAG,UAAU,CAAC,EACzD,OAAO,CAAC,EAAE,wBAAwB,GACjC,MAAM,CAWR;AAYD;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,mBAAmB,EAC3B,OAAO,UAAQ,GACd,MAAM,GAAG,SAAS,CAMpB"}

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

@@ -39,6 +39,17 @@ export interface TimeParts {
 export interface DateTimeParts extends DateParts, TimeParts {
 }
 export type DateFieldMode = 'date' | 'month';
+/** Why a complete date fails its selection rules. */
+export type DateValidationReason = 'beforeMin' | 'afterMax' | 'unavailable';
+/** Selection rules shared by `Calendar`, `DatePicker`, and `getDateValidationReason`. */
+export interface DateValidationRules {
+    /** Earliest valid date (inclusive). */
+    minValue?: DateId;
+    /** Latest valid date (inclusive). */
+    maxValue?: DateId;
+    /** Returns `true` for dates that cannot be selected, such as weekends or holidays. */
+    isDateUnavailable?: (date: DateId) => boolean;
+}
 export type DateTimeGranularity = 'day' | 'hour' | 'minute' | 'second';
 export type DateSegmentType = 'era' | 'year' | 'month' | 'day' | 'hour' | 'minute' | 'second' | 'dayPeriod' | 'literal';
 export interface DateSegment {

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

@@ -1 +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"}
+{"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,qDAAqD;AACrD,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,UAAU,GAAG,aAAa,CAAC;AAE5E,yFAAyF;AACzF,MAAM,WAAW,mBAAmB;IAClC,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sFAAsF;IACtF,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CAC/C;AAED,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/validation/getDateValidationReason.d.ts

@@ -0,0 +1,16 @@
+import type { DateId, DateValidationReason, DateValidationRules } from '../types';
+/**
+ * Checks a complete wire date against `minValue`, `maxValue`, and `isDateUnavailable`.
+ *
+ * Bounds are inclusive and are checked before the predicate, so a date outside
+ * the range reports `beforeMin` / `afterMax` even when it is also unavailable.
+ *
+ * @param date - Wire date to check.
+ * @param rules - Bounds and unavailable-date predicate.
+ * @returns The first rule the date violates, or `undefined` when it is selectable.
+ *
+ * @example
+ * getDateValidationReason(dateId('2026-08-01'), { minValue: dateId('2026-08-10') }) // 'beforeMin'
+ */
+export declare function getDateValidationReason(date: DateId, rules: DateValidationRules): DateValidationReason | undefined;
+//# sourceMappingURL=getDateValidationReason.d.ts.map

package/lib/typescript/dates/validation/getDateValidationReason.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDateValidationReason.d.ts","sourceRoot":"","sources":["../../../../src/dates/validation/getDateValidationReason.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAElF;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,mBAAmB,GACzB,oBAAoB,GAAG,SAAS,CAWlC"}

package/lib/typescript/index.d.ts

@@ -1,5 +1,5 @@
 export { formatNumber, type FormatNumberOptions } from './formatNumber';
-export type { DateFieldMode, DateFormatOptions, DateId, DateParts, DateRangeDisplayOptions, DateSegment, DateSegmentType, DateTimeGranularity, DateTimeId, DateTimeParts, FormatDateDisplayOptions, FormatDateTimeDisplayOptions, MonthId, MonthParts, TimeParts, } from './dates/types';
-export { clampDateParts, clampMonthParts, dateId, monthId, formatDateId, formatMonthId, isValidDateId, isValidDateParts, isValidMonthId, isValidMonthParts, parseDateId, parseMonthId, toMonthId, todayDateId, todayMonthId, clampDateTimeId, compareDateTimeIds, dateTimeId, formatDateTimeId, isLocaleHour12, isValidDateTimeId, nowDateTimeId, parseDateTimeId, formatDateForDisplay, formatDateRangeForDisplay, formatDateTimeForDisplay, formatMonthForDisplay, compareDateIds, compareMonthIds, dateRangeAroundDay, dateRangeFromLastNDays, eachDateIdInRange, normalizeDateRange, applyDateSegmentChange, formatDateSegment, getDateFieldSegments, getDateTimeFieldSegments, getDateTimeSegmentVisibility, getEmptyDateSegmentText, parseDateSegment, formatCalendarMonthYear, formatDateTimeListDateRow, formatDateTimeListHour, formatDateTimeListMinute, formatDateTimeListPeriod, formatMonthCalendarMonth, formatMonthCalendarYear, getCalendarWeekdayLabels, DEFAULT_DATE_COMPONENT_LABELS, formatSelectYear, getDateSegmentAccessibilityLabel, resolveDateComponentLabels, } from './dates';
+export type { DateFieldMode, DateFormatOptions, DateId, DateParts, DateRangeDisplayOptions, DateSegment, DateSegmentType, DateTimeGranularity, DateTimeId, DateTimeParts, DateValidationReason, DateValidationRules, FormatDateDisplayOptions, FormatDateTimeDisplayOptions, MonthId, MonthParts, TimeParts, } from './dates/types';
+export { clampDateParts, clampMonthParts, dateId, monthId, formatDateId, formatMonthId, isValidDateId, isValidDateParts, isValidMonthId, isValidMonthParts, parseDateId, parseMonthId, toMonthId, todayDateId, todayMonthId, clampDateTimeId, compareDateTimeIds, dateTimeId, formatDateTimeId, isLocaleHour12, isValidDateTimeId, nowDateTimeId, parseDateTimeId, formatDateForDisplay, formatDateRangeForDisplay, formatDateTimeForDisplay, formatMonthForDisplay, compareDateIds, compareMonthIds, dateRangeAroundDay, dateRangeFromLastNDays, eachDateIdInRange, normalizeDateRange, applyDateSegmentChange, formatDateSegment, getDateFieldSegments, getDateTimeFieldSegments, getDateTimeSegmentVisibility, getEmptyDateSegmentText, parseDateSegment, getDateValidationReason, formatCalendarMonthYear, formatDateTimeListDateRow, formatDateTimeListHour, formatDateTimeListMinute, formatDateTimeListPeriod, formatMonthCalendarMonth, formatMonthCalendarYear, getCalendarWeekdayLabels, DEFAULT_DATE_COMPONENT_LABELS, formatDateValidationMessage, formatSelectYear, getDateSegmentAccessibilityLabel, resolveDateComponentLabels, } from './dates';
 export type { DateComponentLabels } from './dates';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAExE,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,MAAM,EACN,SAAS,EACT,uBAAuB,EACvB,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,aAAa,EACb,wBAAwB,EACxB,4BAA4B,EAC5B,OAAO,EACP,UAAU,EACV,SAAS,GACV,MAAM,eAAe,CAAC;AAEvB,OAAO,EAEL,cAAc,EACd,eAAe,EACf,MAAM,EACN,OAAO,EACP,YAAY,EACZ,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,SAAS,EACT,WAAW,EACX,YAAY,EAEZ,eAAe,EACf,kBAAkB,EAClB,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,eAAe,EAEf,oBAAoB,EACpB,yBAAyB,EACzB,wBAAwB,EACxB,qBAAqB,EAErB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAElB,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,wBAAwB,EACxB,4BAA4B,EAC5B,uBAAuB,EACvB,gBAAgB,EAEhB,uBAAuB,EACvB,yBAAyB,EACzB,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,6BAA6B,EAC7B,gBAAgB,EAChB,gCAAgC,EAChC,0BAA0B,GAC3B,MAAM,SAAS,CAAC;AAEjB,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAExE,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,MAAM,EACN,SAAS,EACT,uBAAuB,EACvB,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,4BAA4B,EAC5B,OAAO,EACP,UAAU,EACV,SAAS,GACV,MAAM,eAAe,CAAC;AAEvB,OAAO,EAEL,cAAc,EACd,eAAe,EACf,MAAM,EACN,OAAO,EACP,YAAY,EACZ,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,SAAS,EACT,WAAW,EACX,YAAY,EAEZ,eAAe,EACf,kBAAkB,EAClB,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,eAAe,EAEf,oBAAoB,EACpB,yBAAyB,EACzB,wBAAwB,EACxB,qBAAqB,EAErB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAElB,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,wBAAwB,EACxB,4BAA4B,EAC5B,uBAAuB,EACvB,gBAAgB,EAEhB,uBAAuB,EAEvB,uBAAuB,EACvB,yBAAyB,EACzB,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,6BAA6B,EAC7B,2BAA2B,EAC3B,gBAAgB,EAChB,gCAAgC,EAChC,0BAA0B,GAC3B,MAAM,SAAS,CAAC;AAEjB,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cdx-ui/formatters",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "license": "MIT",
   "repository": {
     "type": "git",

package/src/__tests__/dateComponentLabels.test.ts

@@ -1,5 +1,7 @@
+import type { DateId } from '../dates/types';
 import {
   DEFAULT_DATE_COMPONENT_LABELS,
+  formatDateValidationMessage,
   formatSelectYear,
   getDateSegmentAccessibilityLabel,
   resolveDateComponentLabels,
@@ -22,4 +24,57 @@ describe('dateComponentLabels', () => {
     expect(getDateSegmentAccessibilityLabel('month', labels)).toBe('Month');
     expect(getDateSegmentAccessibilityLabel('literal', labels)).toBeUndefined();
   });
+
+  it('wraps segment labels in segmentInvalid when invalid', () => {
+    expect(getDateSegmentAccessibilityLabel('day', resolveDateComponentLabels(), true)).toBe(
+      'Day, invalid',
+    );
+    const labels = resolveDateComponentLabels({
+      segmentDay: 'Jour',
+      segmentInvalid: '{segment} invalide',
+    });
+    expect(getDateSegmentAccessibilityLabel('day', labels, true)).toBe('Jour invalide');
+    expect(getDateSegmentAccessibilityLabel('literal', labels, true)).toBeUndefined();
+  });
+
+  describe('formatDateValidationMessage', () => {
+    const rules = { minValue: '2026-08-10' as DateId, maxValue: '2026-08-20' as DateId };
+
+    it('fills the {date} placeholder with the formatted bound', () => {
+      const labels = resolveDateComponentLabels();
+      expect(formatDateValidationMessage(labels, 'beforeMin', rules)).toBe(
+        'Select a date on or after Aug 10, 2026',
+      );
+      expect(formatDateValidationMessage(labels, 'afterMax', rules)).toBe(
+        'Select a date on or before Aug 20, 2026',
+      );
+    });
+
+    it('formats the bound in options.locale', () => {
+      const labels = resolveDateComponentLabels({ validationBeforeMin: 'À partir du {date}' });
+      expect(formatDateValidationMessage(labels, 'beforeMin', rules, { locale: 'fr-FR' })).toBe(
+        'À partir du 10 août 2026',
+      );
+    });
+
+    it('returns the unavailable message as-is', () => {
+      const labels = resolveDateComponentLabels();
+      expect(formatDateValidationMessage(labels, 'unavailable', rules)).toBe(
+        'This date is unavailable',
+      );
+    });
+
+    it('uses label overrides and display options', () => {
+      const labels = resolveDateComponentLabels({
+        validationBeforeMin: 'Pick {date} or later',
+        validationUnavailable: 'Payments do not process on this date',
+      });
+      expect(formatDateValidationMessage(labels, 'beforeMin', rules, { dateStyle: 'short' })).toBe(
+        'Pick 8/10/26 or later',
+      );
+      expect(formatDateValidationMessage(labels, 'unavailable', rules)).toBe(
+        'Payments do not process on this date',
+      );
+    });
+  });
 });

package/src/__tests__/getDateValidationReason.test.ts

@@ -0,0 +1,45 @@
+import { getDateValidationReason } from '../dates/validation/getDateValidationReason';
+import type { DateId } from '../dates/types';
+
+const isWeekend = (date: DateId) => {
+  const day = new Date(`${date}T00:00:00`).getDay();
+  return day === 0 || day === 6;
+};
+
+describe('getDateValidationReason', () => {
+  const rules = {
+    minValue: '2026-08-10' as DateId,
+    maxValue: '2026-08-20' as DateId,
+    isDateUnavailable: isWeekend,
+  };
+
+  it('returns beforeMin for a date before minValue', () => {
+    expect(getDateValidationReason('2026-08-03' as DateId, rules)).toBe('beforeMin');
+  });
+
+  it('returns afterMax for a date after maxValue', () => {
+    expect(getDateValidationReason('2026-08-24' as DateId, rules)).toBe('afterMax');
+  });
+
+  it('returns unavailable when the predicate returns true', () => {
+    expect(getDateValidationReason('2026-08-15' as DateId, rules)).toBe('unavailable');
+  });
+
+  it('returns undefined for a selectable date', () => {
+    expect(getDateValidationReason('2026-08-14' as DateId, rules)).toBeUndefined();
+  });
+
+  it('treats bounds as inclusive', () => {
+    expect(getDateValidationReason('2026-08-10' as DateId, rules)).toBeUndefined();
+    expect(getDateValidationReason('2026-08-20' as DateId, rules)).toBeUndefined();
+  });
+
+  it('reports bounds before the predicate when both apply', () => {
+    expect(getDateValidationReason('2026-08-08' as DateId, rules)).toBe('beforeMin');
+    expect(getDateValidationReason('2026-08-22' as DateId, rules)).toBe('afterMax');
+  });
+
+  it('returns undefined when no rules are set', () => {
+    expect(getDateValidationReason('2026-08-15' as DateId, {})).toBeUndefined();
+  });
+});

package/src/dates/index.ts

@@ -16,6 +16,8 @@ export type {
   DateTimeGranularity,
   DateTimeId,
   DateTimeParts,
+  DateValidationReason,
+  DateValidationRules,
   FormatDateDisplayOptions,
   FormatDateTimeDisplayOptions,
   MonthId,
@@ -71,6 +73,8 @@ export { getDateTimeSegmentVisibility } from './segments/getDateTimeSegmentVisib
 export { getEmptyDateSegmentText } from './segments/getEmptyDateSegmentText';
 export { parseDateSegment } from './segments/parseDateSegment';
 
+export { getDateValidationReason } from './validation/getDateValidationReason';
+
 export { formatCalendarMonthYear } from './calendar/formatCalendarMonthYear';
 export { formatDateTimeListDateRow } from './calendar/formatDateTimeListDateRow';
 export { formatMonthCalendarMonth } from './calendar/formatMonthCalendarMonth';
@@ -80,6 +84,7 @@ export { getCalendarWeekdayLabels } from './calendar/getCalendarWeekdayLabels';
 export type { DateComponentLabels } from './labels/dateComponentLabels';
 export {
   DEFAULT_DATE_COMPONENT_LABELS,
+  formatDateValidationMessage,
   formatSelectYear,
   getDateSegmentAccessibilityLabel,
   resolveDateComponentLabels,

package/src/dates/labels/dateComponentLabels.ts

@@ -1,4 +1,10 @@
-import type { DateSegmentType } from '../types';
+import { formatDateForDisplay } from '../display/formatDateForDisplay';
+import type {
+  DateSegmentType,
+  DateValidationReason,
+  DateValidationRules,
+  FormatDateDisplayOptions,
+} from '../types';
 
 /** Overridable UI copy for date pickers, calendars, and segmented date fields. */
 export interface DateComponentLabels {
@@ -23,7 +29,17 @@ export interface DateComponentLabels {
   segmentMinute: string;
   segmentSecond: string;
   segmentDayPeriod: string;
+  /**
+   * Native accessible name of a segment while the field is invalid — iOS and Android have no
+   * equivalent of `aria-invalid`. Use `{segment}` as the segment label placeholder.
+   */
+  segmentInvalid: string;
   rangeSeparator: string;
+  /** Use `{date}` as the `minValue` placeholder. */
+  validationBeforeMin: string;
+  /** Use `{date}` as the `maxValue` placeholder. */
+  validationAfterMax: string;
+  validationUnavailable: string;
 }
 
 export const DEFAULT_DATE_COMPONENT_LABELS: DateComponentLabels = {
@@ -47,7 +63,11 @@ export const DEFAULT_DATE_COMPONENT_LABELS: DateComponentLabels = {
   segmentMinute: 'Minute',
   segmentSecond: 'Second',
   segmentDayPeriod: 'AM/PM',
+  segmentInvalid: '{segment}, invalid',
   rangeSeparator: '–',
+  validationBeforeMin: 'Select a date on or after {date}',
+  validationAfterMax: 'Select a date on or before {date}',
+  validationUnavailable: 'This date is unavailable',
 };
 
 export function resolveDateComponentLabels(
@@ -60,6 +80,44 @@ export function formatSelectYear(labels: DateComponentLabels, year: number): str
   return labels.selectYear.replace('{year}', String(year));
 }
 
+const VALIDATION_LABEL_KEYS: Record<DateValidationReason, keyof DateComponentLabels> = {
+  beforeMin: 'validationBeforeMin',
+  afterMax: 'validationAfterMax',
+  unavailable: 'validationUnavailable',
+};
+
+/**
+ * Resolves the user-facing message for a {@link DateValidationReason}.
+ *
+ * `{date}` in the min / max messages is replaced with the bound, formatted for display
+ * with `options.locale` and `options.dateStyle` (defaults: `en-US`, `medium`). `DatePicker`
+ * already formats this message with its own `labels` and `locale` (see `onValidationChange`
+ * and `Field.Error`); call this directly only outside a picker, and pass the same `locale`.
+ *
+ * @param labels - Resolved labels (see `resolveDateComponentLabels`).
+ * @param reason - Reason returned by `getDateValidationReason` or `onValidationChange`.
+ * @param rules - The bounds the reason was computed against.
+ * @param options - Display options for the `{date}` placeholder.
+ * @returns The message to render in `Field.Error`.
+ */
+export function formatDateValidationMessage(
+  labels: DateComponentLabels,
+  reason: DateValidationReason,
+  rules: Pick<DateValidationRules, 'minValue' | 'maxValue'>,
+  options?: FormatDateDisplayOptions,
+): string {
+  const message = labels[VALIDATION_LABEL_KEYS[reason]];
+  const bound =
+    reason === 'beforeMin' ? rules.minValue : reason === 'afterMax' ? rules.maxValue : undefined;
+  if (bound === undefined) {
+    return message;
+  }
+  return message.replace(
+    '{date}',
+    formatDateForDisplay(bound, { dateStyle: 'medium', ...options }),
+  );
+}
+
 const SEGMENT_LABEL_KEYS: Partial<Record<DateSegmentType, keyof DateComponentLabels>> = {
   year: 'segmentYear',
   month: 'segmentMonth',
@@ -70,10 +128,18 @@ const SEGMENT_LABEL_KEYS: Partial<Record<DateSegmentType, keyof DateComponentLab
   dayPeriod: 'segmentDayPeriod',
 };
 
+/**
+ * @param invalid - Wraps the label in `labels.segmentInvalid`, for native platforms where
+ *   `aria-invalid` is not announced.
+ */
 export function getDateSegmentAccessibilityLabel(
   type: DateSegmentType,
   labels: DateComponentLabels,
+  invalid = false,
 ): string | undefined {
   const key = SEGMENT_LABEL_KEYS[type];
-  return key ? labels[key] : undefined;
+  if (!key) {
+    return undefined;
+  }
+  return invalid ? labels.segmentInvalid.replace('{segment}', labels[key]) : labels[key];
 }

package/src/dates/types.ts

@@ -39,6 +39,19 @@ export interface DateTimeParts extends DateParts, TimeParts {}
 
 export type DateFieldMode = 'date' | 'month';
 
+/** Why a complete date fails its selection rules. */
+export type DateValidationReason = 'beforeMin' | 'afterMax' | 'unavailable';
+
+/** Selection rules shared by `Calendar`, `DatePicker`, and `getDateValidationReason`. */
+export interface DateValidationRules {
+  /** Earliest valid date (inclusive). */
+  minValue?: DateId;
+  /** Latest valid date (inclusive). */
+  maxValue?: DateId;
+  /** Returns `true` for dates that cannot be selected, such as weekends or holidays. */
+  isDateUnavailable?: (date: DateId) => boolean;
+}
+
 export type DateTimeGranularity = 'day' | 'hour' | 'minute' | 'second';
 
 export type DateSegmentType =

package/src/dates/validation/getDateValidationReason.ts

@@ -0,0 +1,31 @@
+import { compareDateIds } from '../ranges/compareDateIds';
+import type { DateId, DateValidationReason, DateValidationRules } from '../types';
+
+/**
+ * Checks a complete wire date against `minValue`, `maxValue`, and `isDateUnavailable`.
+ *
+ * Bounds are inclusive and are checked before the predicate, so a date outside
+ * the range reports `beforeMin` / `afterMax` even when it is also unavailable.
+ *
+ * @param date - Wire date to check.
+ * @param rules - Bounds and unavailable-date predicate.
+ * @returns The first rule the date violates, or `undefined` when it is selectable.
+ *
+ * @example
+ * getDateValidationReason(dateId('2026-08-01'), { minValue: dateId('2026-08-10') }) // 'beforeMin'
+ */
+export function getDateValidationReason(
+  date: DateId,
+  rules: DateValidationRules,
+): DateValidationReason | undefined {
+  if (rules.minValue !== undefined && compareDateIds(date, rules.minValue) < 0) {
+    return 'beforeMin';
+  }
+  if (rules.maxValue !== undefined && compareDateIds(date, rules.maxValue) > 0) {
+    return 'afterMax';
+  }
+  if (rules.isDateUnavailable?.(date)) {
+    return 'unavailable';
+  }
+  return undefined;
+}

package/src/index.ts

@@ -11,6 +11,8 @@ export type {
   DateTimeGranularity,
   DateTimeId,
   DateTimeParts,
+  DateValidationReason,
+  DateValidationRules,
   FormatDateDisplayOptions,
   FormatDateTimeDisplayOptions,
   MonthId,
@@ -64,6 +66,8 @@ export {
   getDateTimeSegmentVisibility,
   getEmptyDateSegmentText,
   parseDateSegment,
+  // Validation
+  getDateValidationReason,
   // Calendar / list copy
   formatCalendarMonthYear,
   formatDateTimeListDateRow,
@@ -74,6 +78,7 @@ export {
   formatMonthCalendarYear,
   getCalendarWeekdayLabels,
   DEFAULT_DATE_COMPONENT_LABELS,
+  formatDateValidationMessage,
   formatSelectYear,
   getDateSegmentAccessibilityLabel,
   resolveDateComponentLabels,