@carbon-labs/wc-date-picker 0.2.0 → 0.4.0

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

@@ -1,203 +0,0 @@
-/**
- * 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

@@ -1,136 +0,0 @@
-'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

@@ -1 +0,0 @@
-{"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

@@ -1,163 +0,0 @@
-/**
- * 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>>>;