@carbon/utilities 0.25.0-rc.0 → 0.25.0

package/es/date-picker/index.d.ts

@@ -147,7 +147,14 @@ declare global {
       }): PlainYearMonth;
       compare(one: PlainYearMonth, two: PlainYearMonth): number;
     }
-    const PlainYearMonth: PlainYearMonthConstructor;
+    /**
+     * Usages of `var` and `namespace`, instead of const, are intentional. TS 6
+     * ships built-in types for the Temporal API in `lib.esnext.temporal.d.ts`
+     * using these forms. Declaration merging only works when the shapes match.
+     * Matching them prevents collisions and tsc errors for TS 6 consumers,
+     * and for TS 5 consumers nothing changes, they still get these types
+     */
+    var PlainYearMonth: PlainYearMonthConstructor;
     interface PlainDateConstructor {
       from(item: string | {
         year: number;
@@ -156,11 +163,10 @@ declare global {
       }): PlainDate;
       compare(one: PlainDate, two: PlainDate): number;
     }
-    const PlainDate: PlainDateConstructor;
-    interface Now {
-      plainDateISO(): PlainDate;
+    var PlainDate: PlainDateConstructor;
+    namespace Now {
+      function plainDateISO(): PlainDate;
     }
-    const Now: Now;
   }
 }
 /**
@@ -946,48 +952,5 @@ declare function parseDateString(dateString: string, format: string): Temporal.P
  * @returns True if Temporal API is available
  */
 declare function isTemporalAvailable(): boolean;
-/**
- * Get a fallback date handler if Temporal is not available
- * This provides a migration path for browsers without Temporal support
- */
-declare function getDateHandler(): {
-  type: "temporal";
-  toISOString: typeof plainDateToISOString;
-  fromISOString: typeof parseISOToPlainDate;
-  compare: typeof comparePlainDates;
-  format: typeof formatPlainDate;
-  isInRange: typeof isDateInRange;
-} | {
-  type: "date";
-  /**
-   *
-   * @param {Temporal.PlainDate} date - The date to convert
-   */
-  toISOString: (date: Date) => string;
-  /**
-   *
-   * @param {string} str - The ISO string to parse
-   */
-  fromISOString: (str: string) => Date | null;
-  /**
-   *
-   * @param {Temporal.PlainDate} d1 - First date
-   * @param {Temporal.PlainDate} d2 - Second date
-   */
-  compare: (d1: Date, d2: Date) => number;
-  /**
-   *
-   * @param {Temporal.PlainDate} date - The date to format
-   * @param {string} format - The format string
-   */
-  format: (date: Date, format: string) => string;
-  /**
-   *
-   * @param {Temporal.PlainDate} date - The date to check
-   * @param {Temporal.PlainDate | null} min - Minimum date
-   * @param {Temporal.PlainDate | null} max - Maximum date
-   */
-  isInRange: (date: Date, min: Date | null, max: Date | null) => boolean;
-};
 //#endregion
-export { type CalendarDay, type ClickOutsideConfig, ClickOutsideHandler, type DatePickerContext, DatePickerEvent, type DatePickerEvent$1 as DatePickerEventType, type DatePickerMode, DatePickerState, DatePickerStateMachine, type DateSelectPayload, type FocusRestoreTarget, type InputFocusPayload, type InputType, type KeyboardEventInfo, type KeyboardEventResult, type KeyboardPayload, type SideEffect, type StateAction, type StateConfig, type StateGuard, type StateTransition, type TransitionListener, type TransitionMap, type ValidationErrorPayload, type ValueChangePayload, actions, addDays, addMonths, areDatesEqual, checkGuard, comparePlainDates, dateToPlainDate, daysBetween, effects, executeAction, executeEffect, formatPlainDate, generateCalendarGrid, getAction, getDateHandler, getEffect, getFullDateLabel, getGuard, getMonthEnd, getMonthStart, getMonthYearLabel, getToday, getWeekdayLabels, guards, isDateInRange, isFuture, isPast, isSingleMode, isTemporalAvailable, isToday, mapKeyboardToStateMachineEvent, parseDateString, parseDateToPlainDate, parseISOToPlainDate, plainDateToDate, plainDateToISOString };
+export { type CalendarDay, type ClickOutsideConfig, ClickOutsideHandler, type DatePickerContext, DatePickerEvent, type DatePickerEvent$1 as DatePickerEventType, type DatePickerMode, DatePickerState, DatePickerStateMachine, type DateSelectPayload, type FocusRestoreTarget, type InputFocusPayload, type InputType, type KeyboardEventInfo, type KeyboardEventResult, type KeyboardPayload, type SideEffect, type StateAction, type StateConfig, type StateGuard, type StateTransition, type TransitionListener, type TransitionMap, type ValidationErrorPayload, type ValueChangePayload, actions, addDays, addMonths, areDatesEqual, checkGuard, comparePlainDates, dateToPlainDate, daysBetween, effects, executeAction, executeEffect, formatPlainDate, generateCalendarGrid, getAction, getEffect, getFullDateLabel, getGuard, getMonthEnd, getMonthStart, getMonthYearLabel, getToday, getWeekdayLabels, guards, isDateInRange, isFuture, isPast, isSingleMode, isTemporalAvailable, isToday, mapKeyboardToStateMachineEvent, parseDateString, parseDateToPlainDate, parseISOToPlainDate, plainDateToDate, plainDateToISOString };

package/es/date-picker/index.js

@@ -1,3 +1,4 @@
+import "temporal-polyfill/global";
 //#region src/date-picker/primitives/states.ts
 /**
 * Copyright IBM Corp. 2026
@@ -357,64 +358,6 @@ function parseDateString(dateString, format) {
 function isTemporalAvailable() {
 	return typeof Temporal !== "undefined" && typeof Temporal.PlainDate !== "undefined";
 }
-/**
-* Get a fallback date handler if Temporal is not available
-* This provides a migration path for browsers without Temporal support
-*/
-function getDateHandler() {
-	if (isTemporalAvailable()) return {
-		type: "temporal",
-		toISOString: plainDateToISOString,
-		fromISOString: parseISOToPlainDate,
-		compare: comparePlainDates,
-		format: formatPlainDate,
-		isInRange: isDateInRange
-	};
-	return {
-		type: "date",
-		/**
-		*
-		* @param {Temporal.PlainDate} date - The date to convert
-		*/
-		toISOString: (date) => date.toISOString().split("T")[0],
-		/**
-		*
-		* @param {string} str - The ISO string to parse
-		*/
-		fromISOString: (str) => {
-			const date = new Date(str);
-			return isNaN(date.getTime()) ? null : date;
-		},
-		/**
-		*
-		* @param {Temporal.PlainDate} d1 - First date
-		* @param {Temporal.PlainDate} d2 - Second date
-		*/
-		compare: (d1, d2) => d1.getTime() - d2.getTime(),
-		/**
-		*
-		* @param {Temporal.PlainDate} date - The date to format
-		* @param {string} format - The format string
-		*/
-		format: (date, format) => {
-			const year = date.getFullYear().toString();
-			const month = (date.getMonth() + 1).toString().padStart(2, "0");
-			const day = date.getDate().toString().padStart(2, "0");
-			return format.replace("Y", year).replace("m", month).replace("d", day);
-		},
-		/**
-		*
-		* @param {Temporal.PlainDate} date - The date to check
-		* @param {Temporal.PlainDate | null} min - Minimum date
-		* @param {Temporal.PlainDate | null} max - Maximum date
-		*/
-		isInRange: (date, min, max) => {
-			if (min && date < min) return false;
-			if (max && date > max) return false;
-			return true;
-		}
-	};
-}
 //#endregion
 //#region src/date-picker/primitives/guards.ts
 /**
@@ -2012,4 +1955,4 @@ function getWeekdayLabels(locale = "en", weekStartsOn = 0) {
 	return labels;
 }
 //#endregion
-export { ClickOutsideHandler, DatePickerEvent, DatePickerState, DatePickerStateMachine, actions, addDays, addMonths, areDatesEqual, checkGuard, comparePlainDates, dateToPlainDate, daysBetween, effects, executeAction, executeEffect, formatPlainDate, generateCalendarGrid, getAction, getDateHandler, getEffect, getFullDateLabel, getGuard, getMonthEnd, getMonthStart, getMonthYearLabel, getToday, getWeekdayLabels, guards, isDateInRange, isFuture, isPast, isSingleMode, isTemporalAvailable, isToday, mapKeyboardToStateMachineEvent, parseDateString, parseDateToPlainDate, parseISOToPlainDate, plainDateToDate, plainDateToISOString };
+export { ClickOutsideHandler, DatePickerEvent, DatePickerState, DatePickerStateMachine, actions, addDays, addMonths, areDatesEqual, checkGuard, comparePlainDates, dateToPlainDate, daysBetween, effects, executeAction, executeEffect, formatPlainDate, generateCalendarGrid, getAction, getEffect, getFullDateLabel, getGuard, getMonthEnd, getMonthStart, getMonthYearLabel, getToday, getWeekdayLabels, guards, isDateInRange, isFuture, isPast, isSingleMode, isTemporalAvailable, isToday, mapKeyboardToStateMachineEvent, parseDateString, parseDateToPlainDate, parseISOToPlainDate, plainDateToDate, plainDateToISOString };

package/lib/date-picker/index.js

@@ -1,4 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("temporal-polyfill/global");
 //#region src/date-picker/primitives/states.ts
 /**
 * Copyright IBM Corp. 2026
@@ -358,64 +359,6 @@ function parseDateString(dateString, format) {
 function isTemporalAvailable() {
 	return typeof Temporal !== "undefined" && typeof Temporal.PlainDate !== "undefined";
 }
-/**
-* Get a fallback date handler if Temporal is not available
-* This provides a migration path for browsers without Temporal support
-*/
-function getDateHandler() {
-	if (isTemporalAvailable()) return {
-		type: "temporal",
-		toISOString: plainDateToISOString,
-		fromISOString: parseISOToPlainDate,
-		compare: comparePlainDates,
-		format: formatPlainDate,
-		isInRange: isDateInRange
-	};
-	return {
-		type: "date",
-		/**
-		*
-		* @param {Temporal.PlainDate} date - The date to convert
-		*/
-		toISOString: (date) => date.toISOString().split("T")[0],
-		/**
-		*
-		* @param {string} str - The ISO string to parse
-		*/
-		fromISOString: (str) => {
-			const date = new Date(str);
-			return isNaN(date.getTime()) ? null : date;
-		},
-		/**
-		*
-		* @param {Temporal.PlainDate} d1 - First date
-		* @param {Temporal.PlainDate} d2 - Second date
-		*/
-		compare: (d1, d2) => d1.getTime() - d2.getTime(),
-		/**
-		*
-		* @param {Temporal.PlainDate} date - The date to format
-		* @param {string} format - The format string
-		*/
-		format: (date, format) => {
-			const year = date.getFullYear().toString();
-			const month = (date.getMonth() + 1).toString().padStart(2, "0");
-			const day = date.getDate().toString().padStart(2, "0");
-			return format.replace("Y", year).replace("m", month).replace("d", day);
-		},
-		/**
-		*
-		* @param {Temporal.PlainDate} date - The date to check
-		* @param {Temporal.PlainDate | null} min - Minimum date
-		* @param {Temporal.PlainDate | null} max - Maximum date
-		*/
-		isInRange: (date, min, max) => {
-			if (min && date < min) return false;
-			if (max && date > max) return false;
-			return true;
-		}
-	};
-}
 //#endregion
 //#region src/date-picker/primitives/guards.ts
 /**
@@ -2013,6 +1956,33 @@ function getWeekdayLabels(locale = "en", weekStartsOn = 0) {
 	return labels;
 }
 //#endregion
+//#region src/date-picker/index.ts
+/**
+* Copyright IBM Corp. 2026
+*
+* This source code is licensed under the Apache-2.0 license found in the
+* LICENSE file in the root directory of this source tree.
+*/
+/**
+* @internal
+* This module is for internal use by @carbon/react and @carbon/web-components only.
+* It is not part of the public @carbon/utilities API.
+*
+* Import from source path:
+* import { ... } from '@carbon/utilities/src/date-picker';
+*/
+/**
+* The primitives below are built on Temporal, which is still unevenly shipped:
+* no version of Safari implements it, and Chrome/Edge only gained it in 144.
+* Every `Temporal.*` reference in this module tree is a bare global, so on those engines
+* the first access — `Temporal.Now.plainDateISO()` on the calendar-open transition
+* throws a ReferenceError and the calendar never opens.
+
+* `temporal-polyfill/global` installs `globalThis.Temporal` only when the engine
+* does not already provide it, so a native implementation always wins. It is
+* imported first so the global exists before any primitive can reach for it.
+*/
+//#endregion
 exports.ClickOutsideHandler = ClickOutsideHandler;
 exports.DatePickerEvent = DatePickerEvent;
 exports.DatePickerState = DatePickerState;
@@ -2031,7 +2001,6 @@ exports.executeEffect = executeEffect;
 exports.formatPlainDate = formatPlainDate;
 exports.generateCalendarGrid = generateCalendarGrid;
 exports.getAction = getAction;
-exports.getDateHandler = getDateHandler;
 exports.getEffect = getEffect;
 exports.getFullDateLabel = getFullDateLabel;
 exports.getGuard = getGuard;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@carbon/utilities",
   "description": "Utilities and helpers to drive consistency across software products using the Carbon Design System",
-  "version": "0.25.0-rc.0",
+  "version": "0.25.0",
   "license": "Apache-2.0",
   "main": "lib/index.js",
   "module": "es/index.js",
@@ -22,7 +22,9 @@
   "sideEffects": [
     "*.scss",
     "./index.scss",
-    "./scss/**"
+    "./scss/**",
+    "./es/date-picker/index.js",
+    "./lib/date-picker/index.js"
   ],
   "exports": {
     ".": {
@@ -64,7 +66,8 @@
   },
   "dependencies": {
     "@ibm/telemetry-js": "^1.6.1",
-    "@internationalized/number": "^3.6.1"
+    "@internationalized/number": "^3.6.1",
+    "temporal-polyfill": "^1.0.4"
   },
-  "gitHead": "e848b98936051ac0026fb83551c91bfe603c589c"
+  "gitHead": "7518c84ffd00f22434fe19d83119692c12fccb2f"
 }