@carbon-labs/wc-date-picker 0.2.0

package/lib/state-machine/states.js

@@ -0,0 +1,105 @@
+'use strict';
+
+/**
+ * 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.
+ */
+/**
+ * Date picker state machine states
+ */
+exports.DatePickerState = void 0;
+(function (DatePickerState) {
+    /**
+     * Initial state - calendar closed, no focus
+     */
+    DatePickerState["IDLE"] = "idle";
+    /**
+     * Input has focus, calendar closed
+     */
+    DatePickerState["FOCUSED"] = "focused";
+    /**
+     * Calendar dropdown is open
+     */
+    DatePickerState["CALENDAR_OPEN"] = "calendar_open";
+    /**
+     * User is selecting the start date (range mode)
+     */
+    DatePickerState["SELECTING_START"] = "selecting_start";
+    /**
+     * User is selecting the end date (range mode)
+     */
+    DatePickerState["SELECTING_END"] = "selecting_end";
+    /**
+     * Date(s) have been selected
+     */
+    DatePickerState["DATE_SELECTED"] = "date_selected";
+    /**
+     * Component is disabled
+     */
+    DatePickerState["DISABLED"] = "disabled";
+    /**
+     * Component is read-only
+     */
+    DatePickerState["READONLY"] = "readonly";
+    /**
+     * Component is in an error state
+     */
+    DatePickerState["ERROR"] = "error";
+})(exports.DatePickerState || (exports.DatePickerState = {}));
+/**
+ * Date picker events
+ */
+exports.DatePickerEvent = void 0;
+(function (DatePickerEvent) {
+    // Input events
+    DatePickerEvent["INPUT_FOCUS"] = "INPUT_FOCUS";
+    DatePickerEvent["INPUT_BLUR"] = "INPUT_BLUR";
+    DatePickerEvent["INPUT_CHANGE"] = "INPUT_CHANGE";
+    // Calendar events
+    DatePickerEvent["CALENDAR_ICON_CLICK"] = "CALENDAR_ICON_CLICK";
+    DatePickerEvent["CALENDAR_OPEN"] = "CALENDAR_OPEN";
+    DatePickerEvent["CALENDAR_CLOSE"] = "CALENDAR_CLOSE";
+    // Calendar navigation events
+    DatePickerEvent["PREV_MONTH"] = "PREV_MONTH";
+    DatePickerEvent["NEXT_MONTH"] = "NEXT_MONTH";
+    DatePickerEvent["PREV_YEAR"] = "PREV_YEAR";
+    DatePickerEvent["NEXT_YEAR"] = "NEXT_YEAR";
+    DatePickerEvent["GO_TO_TODAY"] = "GO_TO_TODAY";
+    // Date selection events
+    DatePickerEvent["DATE_SELECT"] = "DATE_SELECT";
+    DatePickerEvent["RANGE_START_SELECT"] = "RANGE_START_SELECT";
+    DatePickerEvent["RANGE_END_SELECT"] = "RANGE_END_SELECT";
+    // User interaction events
+    DatePickerEvent["OUTSIDE_CLICK"] = "OUTSIDE_CLICK";
+    DatePickerEvent["ESCAPE_KEY"] = "ESCAPE_KEY";
+    DatePickerEvent["TAB_KEY"] = "TAB_KEY";
+    DatePickerEvent["SHIFT_TAB_KEY"] = "SHIFT_TAB_KEY";
+    DatePickerEvent["ENTER_KEY"] = "ENTER_KEY";
+    // Arrow key navigation
+    DatePickerEvent["ARROW_UP"] = "ARROW_UP";
+    DatePickerEvent["ARROW_DOWN"] = "ARROW_DOWN";
+    DatePickerEvent["ARROW_LEFT"] = "ARROW_LEFT";
+    DatePickerEvent["ARROW_RIGHT"] = "ARROW_RIGHT";
+    // Page navigation
+    DatePickerEvent["PAGE_UP"] = "PAGE_UP";
+    DatePickerEvent["PAGE_DOWN"] = "PAGE_DOWN";
+    // Week navigation
+    DatePickerEvent["HOME_KEY"] = "HOME_KEY";
+    DatePickerEvent["END_KEY"] = "END_KEY";
+    // State change events
+    DatePickerEvent["DISABLE"] = "DISABLE";
+    DatePickerEvent["ENABLE"] = "ENABLE";
+    DatePickerEvent["SET_READONLY"] = "SET_READONLY";
+    DatePickerEvent["UNSET_READONLY"] = "UNSET_READONLY";
+    DatePickerEvent["VALUE_CHANGE"] = "VALUE_CHANGE";
+    DatePickerEvent["VALIDATION_ERROR"] = "VALIDATION_ERROR";
+    DatePickerEvent["CLEAR_ERROR"] = "CLEAR_ERROR";
+    // Configuration events
+    DatePickerEvent["SET_MIN_DATE"] = "SET_MIN_DATE";
+    DatePickerEvent["SET_MAX_DATE"] = "SET_MAX_DATE";
+    DatePickerEvent["SET_DATE_FORMAT"] = "SET_DATE_FORMAT";
+})(exports.DatePickerEvent || (exports.DatePickerEvent = {}));
+// Made with Bob
+//# sourceMappingURL=states.js.map

package/lib/state-machine/states.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"states.js","sources":["../../../state-machine/states.ts"],"sourcesContent":[null],"names":["DatePickerState","DatePickerEvent"],"mappings":"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"}

package/lib/state-machine/temporal-utils.d.ts

@@ -0,0 +1,203 @@
+/**
+ * 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.
+ */
+/**
+ * Temporal API utilities for date picker
+ * Uses the modern Temporal API for robust date handling
+ */
+/**
+ * Convert a Date object to Temporal.PlainDate
+ *
+ * @param {Date} date - JavaScript Date object
+ * @returns Temporal.PlainDate
+ */
+export declare function dateToPlainDate(date: Date): Temporal.PlainDate;
+/**
+ * Convert Temporal.PlainDate to Date object
+ *
+ * @param {Temporal.PlainDate} plainDate - Temporal.PlainDate
+ * @returns JavaScript Date object
+ */
+export declare function plainDateToDate(plainDate: Temporal.PlainDate): Date;
+/**
+ * Convert Temporal.PlainDate to ISO date string (YYYY-MM-DD)
+ *
+ * @param {Temporal.PlainDate} plainDate - Temporal.PlainDate
+ * @returns ISO date string
+ */
+export declare function plainDateToISOString(plainDate: Temporal.PlainDate): string;
+/**
+ * Parse ISO date string to Temporal.PlainDate
+ *
+ * @param {string} isoString - ISO date string (YYYY-MM-DD)
+ * @returns Temporal.PlainDate or null if invalid
+ */
+export declare function parseISOToPlainDate(isoString: string): Temporal.PlainDate | null;
+/**
+ * Parse a date string in various formats to Temporal.PlainDate
+ * Supports: ISO (YYYY-MM-DD), US (MM/DD/YYYY), and JavaScript Date objects
+ *
+ * @param {string | Date} dateInput - Date string or Date object
+ * @returns Temporal.PlainDate or null if invalid
+ */
+export declare function parseDateToPlainDate(dateInput: string | Date | null | undefined): Temporal.PlainDate | null;
+/**
+ * Compare two Temporal.PlainDate objects
+ *
+ * @param {Temporal.PlainDate} date1 - First date
+ * @param {Temporal.PlainDate} date2 - Second date
+ * @returns -1 if date1 < date2, 0 if equal, 1 if date1 > date2
+ */
+export declare function comparePlainDates(date1: Temporal.PlainDate, date2: Temporal.PlainDate): number;
+/**
+ * Check if a date is within a range
+ *
+ * @param {Temporal.PlainDate} date - Date to check
+ * @param {Temporal.PlainDate | null} minDate - Minimum date (inclusive)
+ * @param {Temporal.PlainDate | null} maxDate - Maximum date (inclusive)
+ * @returns True if date is within range
+ */
+export declare function isDateInRange(date: Temporal.PlainDate, minDate: Temporal.PlainDate | null, maxDate: Temporal.PlainDate | null): boolean;
+/**
+ * Format a Temporal.PlainDate according to a format string
+ * Supports common format tokens: Y, m, d
+ *
+ * @param {Temporal.PlainDate} date - Date to format
+ * @param {string} format - Format string (e.g., 'm/d/Y', 'Y-m-d')
+ * @returns Formatted date string
+ */
+export declare function formatPlainDate(date: Temporal.PlainDate, format: string): string;
+/**
+ * Get today's date as Temporal.PlainDate
+ *
+ * @returns Today's date
+ */
+export declare function getToday(): Temporal.PlainDate;
+/**
+ * Add days to a date
+ *
+ * @param {Temporal.PlainDate} date - Starting date
+ * @param {number} days - Number of days to add (can be negative)
+ * @returns New date
+ */
+export declare function addDays(date: Temporal.PlainDate, days: number): Temporal.PlainDate;
+/**
+ * Add months to a date
+ *
+ * @param {Temporal.PlainDate} date - Starting date
+ * @param {number} months - Number of months to add (can be negative)
+ * @returns New date
+ */
+export declare function addMonths(date: Temporal.PlainDate, months: number): Temporal.PlainDate;
+/**
+ * Get the number of days between two dates
+ *
+ * @param {Temporal.PlainDate} date1 - First date
+ * @param {Temporal.PlainDate} date2 - Second date
+ * @returns Number of days (positive if date2 is after date1)
+ */
+export declare function daysBetween(date1: Temporal.PlainDate, date2: Temporal.PlainDate): number;
+/**
+ * Check if two dates are equal
+ *
+ * @param {Temporal.PlainDate} date1 - First date
+ * @param {Temporal.PlainDate} date2 - Second date
+ * @returns True if dates are equal
+ */
+export declare function areDatesEqual(date1: Temporal.PlainDate | null, date2: Temporal.PlainDate | null): boolean;
+/**
+ * Get the start of the month for a given date
+ *
+ * @param {Temporal.PlainDate} date - Input date
+ * @returns First day of the month
+ */
+export declare function getMonthStart(date: Temporal.PlainDate): Temporal.PlainDate;
+/**
+ * Get the end of the month for a given date
+ *
+ * @param {Temporal.PlainDate} date - Input date
+ * @returns Last day of the month
+ */
+export declare function getMonthEnd(date: Temporal.PlainDate): Temporal.PlainDate;
+/**
+ * Check if a date is today
+ *
+ * @param {Temporal.PlainDate} date - Date to check
+ * @returns True if date is today
+ */
+export declare function isToday(date: Temporal.PlainDate): boolean;
+/**
+ * Check if a date is in the past
+ *
+ * @param {Temporal.PlainDate} date - Date to check
+ * @returns True if date is before today
+ */
+export declare function isPast(date: Temporal.PlainDate): boolean;
+/**
+ * Check if a date is in the future
+ *
+ * @param {Temporal.PlainDate} date - Date to check
+ * @returns True if date is after today
+ */
+export declare function isFuture(date: Temporal.PlainDate): boolean;
+/**
+ * Parse a date string with a specific format
+ * Supports common format tokens: Y, m, d
+ *
+ * @param {string} dateString - Date string to parse
+ * @param {string} format - Format string (e.g., 'm/d/Y', 'Y-m-d')
+ * @returns Temporal.PlainDate or null if invalid
+ */
+export declare function parseDateString(dateString: string, format: string): Temporal.PlainDate | null;
+/**
+ * Polyfill check for Temporal API
+ *
+ * @returns True if Temporal API is available
+ */
+export declare function isTemporalAvailable(): boolean;
+/**
+ * Get a fallback date handler if Temporal is not available
+ * This provides a migration path for browsers without Temporal support
+ */
+export 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;
+};

package/lib/state-machine/temporal-utils.js

@@ -0,0 +1,136 @@
+'use strict';
+
+/**
+ * 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.
+ */
+/**
+ * Temporal API utilities for date picker
+ * Uses the modern Temporal API for robust date handling
+ */
+/**
+ * Convert a Date object to Temporal.PlainDate
+ *
+ * @param {Date} date - JavaScript Date object
+ * @returns Temporal.PlainDate
+ */
+function dateToPlainDate(date) {
+    return Temporal.PlainDate.from({
+        year: date.getFullYear(),
+        month: date.getMonth() + 1,
+        day: date.getDate(),
+    });
+}
+/**
+ * Convert Temporal.PlainDate to Date object
+ *
+ * @param {Temporal.PlainDate} plainDate - Temporal.PlainDate
+ * @returns JavaScript Date object
+ */
+function plainDateToDate(plainDate) {
+    return new Date(plainDate.year, plainDate.month - 1, plainDate.day);
+}
+/**
+ * Convert Temporal.PlainDate to ISO date string (YYYY-MM-DD)
+ *
+ * @param {Temporal.PlainDate} plainDate - Temporal.PlainDate
+ * @returns ISO date string
+ */
+function plainDateToISOString(plainDate) {
+    return plainDate.toString();
+}
+/**
+ * Parse ISO date string to Temporal.PlainDate
+ *
+ * @param {string} isoString - ISO date string (YYYY-MM-DD)
+ * @returns Temporal.PlainDate or null if invalid
+ */
+function parseISOToPlainDate(isoString) {
+    try {
+        return Temporal.PlainDate.from(isoString);
+    }
+    catch (_a) {
+        return null;
+    }
+}
+/**
+ * Parse a date string in various formats to Temporal.PlainDate
+ * Supports: ISO (YYYY-MM-DD), US (MM/DD/YYYY), and JavaScript Date objects
+ *
+ * @param {string | Date} dateInput - Date string or Date object
+ * @returns Temporal.PlainDate or null if invalid
+ */
+function parseDateToPlainDate(dateInput) {
+    if (!dateInput) {
+        return null;
+    }
+    // Handle Date objects
+    if (dateInput instanceof Date) {
+        return dateToPlainDate(dateInput);
+    }
+    // Try ISO format first (YYYY-MM-DD)
+    try {
+        return Temporal.PlainDate.from(dateInput);
+    }
+    catch (_a) {
+        // Not ISO format, try parsing MM/DD/YYYY or M/D/YYYY
+        const parts = dateInput.split('/');
+        if (parts.length === 3) {
+            const month = parseInt(parts[0], 10);
+            const day = parseInt(parts[1], 10);
+            const year = parseInt(parts[2], 10);
+            if (!isNaN(month) && !isNaN(day) && !isNaN(year)) {
+                try {
+                    return Temporal.PlainDate.from({
+                        year,
+                        month,
+                        day,
+                    });
+                }
+                catch (_b) {
+                    return null;
+                }
+            }
+        }
+        return null;
+    }
+}
+/**
+ * Compare two Temporal.PlainDate objects
+ *
+ * @param {Temporal.PlainDate} date1 - First date
+ * @param {Temporal.PlainDate} date2 - Second date
+ * @returns -1 if date1 < date2, 0 if equal, 1 if date1 > date2
+ */
+function comparePlainDates(date1, date2) {
+    return Temporal.PlainDate.compare(date1, date2);
+}
+/**
+ * Check if a date is within a range
+ *
+ * @param {Temporal.PlainDate} date - Date to check
+ * @param {Temporal.PlainDate | null} minDate - Minimum date (inclusive)
+ * @param {Temporal.PlainDate | null} maxDate - Maximum date (inclusive)
+ * @returns True if date is within range
+ */
+function isDateInRange(date, minDate, maxDate) {
+    if (minDate && comparePlainDates(date, minDate) < 0) {
+        return false;
+    }
+    if (maxDate && comparePlainDates(date, maxDate) > 0) {
+        return false;
+    }
+    return true;
+}
+// Made with Bob
+
+exports.comparePlainDates = comparePlainDates;
+exports.dateToPlainDate = dateToPlainDate;
+exports.isDateInRange = isDateInRange;
+exports.parseDateToPlainDate = parseDateToPlainDate;
+exports.parseISOToPlainDate = parseISOToPlainDate;
+exports.plainDateToDate = plainDateToDate;
+exports.plainDateToISOString = plainDateToISOString;
+//# sourceMappingURL=temporal-utils.js.map

package/lib/state-machine/temporal-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal-utils.js","sources":["../../../state-machine/temporal-utils.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;;AAKG;AAEH;;;AAGG;AAEH;;;;;AAKG;AACG,SAAU,eAAe,CAAC,IAAU,EAAA;AACxC,IAAA,OAAO,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC;AAC7B,QAAA,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE;AACxB,QAAA,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC;AAC1B,QAAA,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE;AACpB,KAAA,CAAC;AACJ;AAEA;;;;;AAKG;AACG,SAAU,eAAe,CAAC,SAA6B,EAAA;AAC3D,IAAA,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,KAAK,GAAG,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC;AACrE;AAEA;;;;;AAKG;AACG,SAAU,oBAAoB,CAAC,SAA6B,EAAA;AAChE,IAAA,OAAO,SAAS,CAAC,QAAQ,EAAE;AAC7B;AAEA;;;;;AAKG;AACG,SAAU,mBAAmB,CACjC,SAAiB,EAAA;AAEjB,IAAA,IAAI;QACF,OAAO,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC;IAC3C;AAAE,IAAA,OAAA,EAAA,EAAM;AACN,QAAA,OAAO,IAAI;IACb;AACF;AAEA;;;;;;AAMG;AACG,SAAU,oBAAoB,CAClC,SAA2C,EAAA;IAE3C,IAAI,CAAC,SAAS,EAAE;AACd,QAAA,OAAO,IAAI;IACb;;AAGA,IAAA,IAAI,SAAS,YAAY,IAAI,EAAE;AAC7B,QAAA,OAAO,eAAe,CAAC,SAAS,CAAC;IACnC;;AAGA,IAAA,IAAI;QACF,OAAO,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC;IAC3C;AAAE,IAAA,OAAA,EAAA,EAAM;;QAEN,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC;AAClC,QAAA,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE;YACtB,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YACpC,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAEnC,YAAA,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE;AAChD,gBAAA,IAAI;AACF,oBAAA,OAAO,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC;wBAC7B,IAAI;wBACJ,KAAK;wBACL,GAAG;AACJ,qBAAA,CAAC;gBACJ;AAAE,gBAAA,OAAA,EAAA,EAAM;AACN,oBAAA,OAAO,IAAI;gBACb;YACF;QACF;AACA,QAAA,OAAO,IAAI;IACb;AACF;AAEA;;;;;;AAMG;AACG,SAAU,iBAAiB,CAC/B,KAAyB,EACzB,KAAyB,EAAA;IAEzB,OAAO,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;AACjD;AAEA;;;;;;;AAOG;SACa,aAAa,CAC3B,IAAwB,EACxB,OAAkC,EAClC,OAAkC,EAAA;IAElC,IAAI,OAAO,IAAI,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE;AACnD,QAAA,OAAO,KAAK;IACd;IACA,IAAI,OAAO,IAAI,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE;AACnD,QAAA,OAAO,KAAK;IACd;AACA,IAAA,OAAO,IAAI;AACb;AAuQA;;;;;;;;;;"}

package/lib/state-machine/types.d.ts

@@ -0,0 +1,163 @@
+/**
+ * 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.
+ */
+/**
+ * Temporal API type declarations
+ * Using Temporal for modern date handling
+ */
+declare global {
+    namespace Temporal {
+        interface PlainDate {
+            readonly year: number;
+            readonly month: number;
+            readonly day: number;
+            readonly daysInMonth: number;
+            toString(): string;
+            with(dateLike: {
+                year?: number;
+                month?: number;
+                day?: number;
+            }): PlainDate;
+            add(duration: {
+                days?: number;
+                months?: number;
+                years?: number;
+            }): PlainDate;
+            until(other: PlainDate): {
+                days: number;
+            };
+        }
+        interface PlainDateConstructor {
+            from(item: string | {
+                year: number;
+                month: number;
+                day: number;
+            }): PlainDate;
+            compare(one: PlainDate, two: PlainDate): number;
+        }
+        const PlainDate: PlainDateConstructor;
+        interface Now {
+            plainDateISO(): PlainDate;
+        }
+        const Now: Now;
+    }
+}
+/**
+ * Date picker modes
+ */
+export type DatePickerMode = 'simple' | 'single' | 'range';
+/**
+ * Input type for range mode
+ */
+export type InputType = 'from' | 'to';
+/**
+ * Date picker state machine context
+ * Contains all the state needed to manage the datepicker
+ * Uses Temporal.PlainDate for robust date handling
+ */
+export interface DatePickerContext {
+    /** The mode of the date picker */
+    mode: DatePickerMode;
+    /** The current value as ISO date string(s) */
+    value: string;
+    /** The selected start date (using Temporal API) */
+    startDate: Temporal.PlainDate | null;
+    /** The selected end date (range mode only, using Temporal API) */
+    endDate: Temporal.PlainDate | null;
+    /** Whether the calendar dropdown is open */
+    isOpen: boolean;
+    /** Whether an input has focus */
+    isFocused: boolean;
+    /** Whether the component is disabled */
+    isDisabled: boolean;
+    /** Whether the component is readonly */
+    isReadonly: boolean;
+    /** Whether the component is in an invalid state */
+    isInvalid: boolean;
+    /** The last focused input (for range mode) */
+    lastFocusedInput: InputType | null;
+    /** Minimum selectable date (using Temporal API) */
+    minDate: Temporal.PlainDate | null;
+    /** Maximum selectable date (using Temporal API) */
+    maxDate: Temporal.PlainDate | null;
+    /** Date format string */
+    dateFormat: string;
+    /** Whether to allow manual input */
+    allowInput: boolean;
+    /** Whether to close calendar on date selection */
+    closeOnSelect: boolean;
+    /** Error message if any */
+    errorMessage?: string;
+    /** The currently viewed month in the calendar (using Temporal API) */
+    viewDate: Temporal.PlainDate | null;
+    /** The date that currently has keyboard focus in the calendar */
+    focusedDate: Temporal.PlainDate | null;
+}
+/**
+ * Event payload types
+ */
+export interface DateSelectPayload {
+    date: Temporal.PlainDate;
+    inputType?: InputType;
+}
+export interface InputFocusPayload {
+    inputType: InputType;
+}
+export interface KeyboardPayload {
+    key: string;
+    shiftKey?: boolean;
+}
+export interface ValueChangePayload {
+    value: string;
+}
+export interface ValidationErrorPayload {
+    message: string;
+}
+/**
+ * Date picker event
+ */
+export interface DatePickerEvent<T = any> {
+    type: string;
+    payload?: T;
+    timestamp: number;
+}
+/**
+ * State transition information
+ */
+export interface StateTransition {
+    from: string;
+    to: string;
+    event: DatePickerEvent;
+    context: DatePickerContext;
+}
+/**
+ * Guard function type - determines if a transition is allowed
+ */
+export type StateGuard = (context: DatePickerContext, event: DatePickerEvent) => boolean;
+/**
+ * Action function type - updates context during transition
+ */
+export type StateAction = (context: DatePickerContext, event: DatePickerEvent) => Partial<DatePickerContext>;
+/**
+ * Side effect function type - performs side effects after transition
+ */
+export type SideEffect = (context: DatePickerContext, event: DatePickerEvent) => void;
+/**
+ * Transition listener function type
+ */
+export type TransitionListener = (transition: StateTransition) => void;
+/**
+ * State configuration
+ */
+export interface StateConfig {
+    guards?: Record<string, StateGuard>;
+    actions?: Record<string, StateAction>;
+    effects?: Record<string, SideEffect>;
+}
+/**
+ * Transition map type
+ */
+export type TransitionMap = Record<string, Partial<Record<string, string>>>;

package/lib/temp-imports/.storybook/templates/with-layer.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Copyright IBM Corp. 2019, 2025
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { LitElement } from 'lit';
+import '@carbon/web-components/es/components/layer/index.js';
+/**
+ * Storybook template layer component, strictly for presentation purposes
+ *
+ * @element sb-template-layers
+ * @slot The elements contained within the component.
+ */
+declare class CDSLayer extends LitElement {
+    content: any;
+    private _observer;
+    private _layer1;
+    private _layer2;
+    private _handleSlotChange;
+    updated(): void;
+    disconnectedCallback(): void;
+    render(): import("lit-html").TemplateResult<1>;
+    static styles: any;
+}
+export default CDSLayer;

package/lib/temp-imports/globals/decorators/carbon-element.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Copyright IBM Corp. 2019, 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.
+ */
+export declare type Constructor<T> = {
+    new (...args: any[]): T;
+};
+type Finisher = (<T>(clazz: Constructor<T>) => Constructor<T>) | (<T>(clazz: Constructor<T>) => void);
+export interface ClassDescriptor {
+    kind: 'class';
+    elements: ClassElement[];
+    finisher?: Finisher;
+}
+export interface ClassElement {
+    kind: 'field' | 'method';
+    key: PropertyKey;
+    placement: 'static' | 'prototype' | 'own';
+    initializer?: () => unknown;
+    extras?: ClassElement[];
+    finisher?: Finisher;
+    descriptor?: PropertyDescriptor;
+}
+/**
+ * Allow for custom element classes with private constructors
+ */
+type CustomElementClass = Omit<typeof HTMLElement, 'new'>;
+/**
+ * Class decorator factory that defines the decorated class as a custom element.
+ *
+ * ```js
+ * @customElement('my-element')
+ * class MyElement extends LitElement {
+ *   render() {
+ *     return html``;
+ *   }
+ * }
+ * ```
+ *
+ * @category Decorator
+ * @param tagName The tag name of the custom element to define.
+ */
+export declare const carbonElement: (tagName: string) => (classOrDescriptor: CustomElementClass | ClassDescriptor) => any;
+export {};