@carbon-labs/wc-date-picker 0.2.0

package/lib/state-machine/guards.js

@@ -0,0 +1,147 @@
+'use strict';
+
+var states = require('./states.js');
+var temporalUtils = require('./temporal-utils.js');
+
+/**
+ * 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.
+ */
+/**
+ * Check if the component is interactive (not disabled or readonly)
+ *
+ * @param {DatePickerContext} context - The current context
+ * @returns {boolean} True if interactive
+ */
+const isInteractive = (context) => {
+    return !context.isDisabled && !context.isReadonly;
+};
+/**
+ * Check if component is in range mode
+ *
+ * @param {DatePickerContext} context - The current context
+ * @returns {boolean} True if in range mode
+ */
+const isRangeMode = (context) => {
+    return context.mode === 'range';
+};
+/**
+ * Guards for state transitions
+ */
+const guards = {
+    [states.DatePickerState.IDLE]: {},
+    [states.DatePickerState.FOCUSED]: {
+        INPUT_FOCUS: isInteractive,
+    },
+    [states.DatePickerState.CALENDAR_OPEN]: {
+        CALENDAR_OPEN: isInteractive,
+        CALENDAR_ICON_CLICK: isInteractive,
+        TAB_KEY: isInteractive,
+    },
+    [states.DatePickerState.SELECTING_START]: {
+        /**
+         * Guard for calendar open in range mode
+         *
+         * @param {DatePickerContext} context - The current context
+         * @returns {boolean} True if allowed
+         */
+        CALENDAR_OPEN: (context) => isInteractive(context) && isRangeMode(context),
+    },
+    [states.DatePickerState.SELECTING_END]: {
+        /**
+         * Guard for range start selection
+         *
+         * @param {DatePickerContext} context - The current context
+         * @param {DatePickerEvent} event - The event
+         * @returns {boolean} True if allowed
+         */
+        RANGE_START_SELECT: (context, event) => {
+            if (!isInteractive(context) || !isRangeMode(context)) {
+                return false;
+            }
+            const payload = event.payload;
+            if (!(payload === null || payload === void 0 ? void 0 : payload.date)) {
+                return false;
+            }
+            return temporalUtils.isDateInRange(payload.date, context.minDate, context.maxDate);
+        },
+    },
+    [states.DatePickerState.DATE_SELECTED]: {
+        /**
+         * Guard for date selection
+         *
+         * @param {DatePickerContext} context - The current context
+         * @param {DatePickerEvent} event - The event
+         * @returns {boolean} True if allowed
+         */
+        DATE_SELECT: (context, event) => {
+            if (!isInteractive(context)) {
+                return false;
+            }
+            const payload = event.payload;
+            if (!(payload === null || payload === void 0 ? void 0 : payload.date)) {
+                return false;
+            }
+            return temporalUtils.isDateInRange(payload.date, context.minDate, context.maxDate);
+        },
+        /**
+         * Guard for range end selection
+         *
+         * @param {DatePickerContext} context - The current context
+         * @param {DatePickerEvent} event - The event
+         * @returns {boolean} True if allowed
+         */
+        RANGE_END_SELECT: (context, event) => {
+            if (!isInteractive(context) || !isRangeMode(context)) {
+                return false;
+            }
+            const payload = event.payload;
+            if (!(payload === null || payload === void 0 ? void 0 : payload.date)) {
+                return false;
+            }
+            // Must have a start date selected
+            if (!context.startDate) {
+                return false;
+            }
+            return temporalUtils.isDateInRange(payload.date, context.minDate, context.maxDate);
+        },
+    },
+    [states.DatePickerState.DISABLED]: {},
+    [states.DatePickerState.READONLY]: {},
+    [states.DatePickerState.ERROR]: {},
+};
+/**
+ * Get guard for a specific state and event
+ *
+ * @param {DatePickerState} state - The current state
+ * @param {string} eventType - The event type
+ * @returns {StateGuard | undefined} The guard function or undefined
+ */
+function getGuard(state, eventType) {
+    var _a;
+    return (_a = guards[state]) === null || _a === void 0 ? void 0 : _a[eventType];
+}
+/**
+ * Check if a transition is guarded and allowed
+ *
+ * @param {DatePickerState} state - The current state
+ * @param {string} eventType - The event type
+ * @param {DatePickerContext} context - The current context
+ * @param {DatePickerEvent} event - The event
+ * @returns {boolean} True if guard passes
+ */
+function checkGuard(state, eventType, context, event) {
+    const guard = getGuard(state, eventType);
+    if (!guard) {
+        return true; // No guard means transition is allowed
+    }
+    return guard(context, event);
+}
+// Made with Bob
+
+exports.checkGuard = checkGuard;
+exports.getGuard = getGuard;
+exports.guards = guards;
+//# sourceMappingURL=guards.js.map

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

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

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

@@ -0,0 +1,12 @@
+/**
+ * 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.
+ */
+export { DatePickerStateMachine } from './machine';
+export { DatePickerState, DatePickerEvent } from './states';
+export { guards, getGuard, checkGuard } from './guards';
+export { actions, getAction, executeAction } from './actions';
+export { effects, getEffect, executeEffect } from './effects';
+export type { DatePickerContext, DatePickerMode, InputType, DateSelectPayload, InputFocusPayload, KeyboardPayload, ValueChangePayload, ValidationErrorPayload, DatePickerEvent as DatePickerEventType, StateTransition, StateGuard, StateAction, SideEffect, TransitionListener, StateConfig, TransitionMap, } from './types';

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

@@ -0,0 +1,92 @@
+/**
+ * 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.
+ */
+import { DatePickerState } from './states';
+import type { DatePickerContext, TransitionListener } from './types';
+/**
+ * Date picker state machine
+ * Manages state transitions and context updates for the date picker
+ */
+export declare class DatePickerStateMachine {
+    private currentState;
+    private context;
+    private listeners;
+    /**
+     * Create a new date picker state machine
+     *
+     * @param {Partial<DatePickerContext>} initialContext - Initial context values
+     */
+    constructor(initialContext?: Partial<DatePickerContext>);
+    /**
+     * Create initial context with defaults
+     *
+     * @param {Partial<DatePickerContext>} partial - Partial context to merge with defaults
+     * @returns Complete context object
+     */
+    private createInitialContext;
+    /**
+     * Send an event to the state machine
+     * This is the primary method for triggering state transitions
+     *
+     * @param {string} eventType - The type of event to send
+     * @param {any} payload - Optional event payload
+     * @returns The updated context
+     */
+    send(eventType: string, payload?: any): DatePickerContext;
+    /**
+     * Get the current state
+     *
+     * @returns The current state
+     */
+    getState(): DatePickerState;
+    /**
+     * Get the current context
+     *
+     * @returns A copy of the current context
+     */
+    getContext(): DatePickerContext;
+    /**
+     * Update context directly (use sparingly)
+     *
+     * @param {Partial<DatePickerContext>} updates - Partial context updates
+     * @returns The updated context
+     */
+    updateContext(updates: Partial<DatePickerContext>): DatePickerContext;
+    /**
+     * Subscribe to state transitions
+     *
+     * @param {TransitionListener} listener - Function to call on each transition
+     * @returns Unsubscribe function
+     */
+    subscribe(listener: TransitionListener): () => void;
+    /**
+     * Check if a transition is valid from the current state
+     *
+     * @param {string} eventType - The event type to check
+     * @returns True if the transition is valid
+     */
+    canTransition(eventType: string): boolean;
+    /**
+     * Get the next state for a given event
+     *
+     * @param {DatePickerState} from - Current state
+     * @param {DatePickerEvent} event - The event
+     * @returns Next state or null if no transition exists
+     */
+    private getNextState;
+    /**
+     * Notify all listeners of a state transition
+     *
+     * @param {StateTransition} transition - The state transition
+     */
+    private notifyListeners;
+    /**
+     * Reset the state machine to initial state
+     *
+     * @param {Partial<DatePickerContext>} initialContext - Optional new initial context
+     */
+    reset(initialContext?: Partial<DatePickerContext>): void;
+}

package/lib/state-machine/machine.js

@@ -0,0 +1,274 @@
+'use strict';
+
+var states = require('./states.js');
+var guards = require('./guards.js');
+var actions = require('./actions.js');
+var effects = require('./effects.js');
+
+/**
+ * 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.
+ */
+/**
+ * State transition configuration
+ * Maps the current state + event type to the next state
+ */
+const stateTransitions = {
+    [states.DatePickerState.IDLE]: {
+        [states.DatePickerEvent.INPUT_FOCUS]: states.DatePickerState.FOCUSED,
+        [states.DatePickerEvent.CALENDAR_ICON_CLICK]: states.DatePickerState.CALENDAR_OPEN,
+        [states.DatePickerEvent.DISABLE]: states.DatePickerState.DISABLED,
+        [states.DatePickerEvent.SET_READONLY]: states.DatePickerState.READONLY,
+    },
+    [states.DatePickerState.FOCUSED]: {
+        [states.DatePickerEvent.INPUT_BLUR]: states.DatePickerState.IDLE,
+        [states.DatePickerEvent.CALENDAR_OPEN]: states.DatePickerState.CALENDAR_OPEN,
+        [states.DatePickerEvent.DISABLE]: states.DatePickerState.DISABLED,
+    },
+    [states.DatePickerState.CALENDAR_OPEN]: {
+        [states.DatePickerEvent.DATE_SELECT]: states.DatePickerState.DATE_SELECTED,
+        [states.DatePickerEvent.RANGE_START_SELECT]: states.DatePickerState.SELECTING_END,
+        [states.DatePickerEvent.OUTSIDE_CLICK]: states.DatePickerState.IDLE,
+        [states.DatePickerEvent.ESCAPE_KEY]: states.DatePickerState.FOCUSED,
+        [states.DatePickerEvent.TAB_KEY]: states.DatePickerState.IDLE,
+        [states.DatePickerEvent.CALENDAR_CLOSE]: states.DatePickerState.FOCUSED,
+        [states.DatePickerEvent.PREV_MONTH]: states.DatePickerState.CALENDAR_OPEN,
+        [states.DatePickerEvent.NEXT_MONTH]: states.DatePickerState.CALENDAR_OPEN,
+        [states.DatePickerEvent.PREV_YEAR]: states.DatePickerState.CALENDAR_OPEN,
+        [states.DatePickerEvent.NEXT_YEAR]: states.DatePickerState.CALENDAR_OPEN,
+        [states.DatePickerEvent.GO_TO_TODAY]: states.DatePickerState.CALENDAR_OPEN,
+        // Keyboard navigation
+        [states.DatePickerEvent.ARROW_UP]: states.DatePickerState.CALENDAR_OPEN,
+        [states.DatePickerEvent.ARROW_DOWN]: states.DatePickerState.CALENDAR_OPEN,
+        [states.DatePickerEvent.ARROW_LEFT]: states.DatePickerState.CALENDAR_OPEN,
+        [states.DatePickerEvent.ARROW_RIGHT]: states.DatePickerState.CALENDAR_OPEN,
+        [states.DatePickerEvent.PAGE_UP]: states.DatePickerState.CALENDAR_OPEN,
+        [states.DatePickerEvent.PAGE_DOWN]: states.DatePickerState.CALENDAR_OPEN,
+        [states.DatePickerEvent.HOME_KEY]: states.DatePickerState.CALENDAR_OPEN,
+        [states.DatePickerEvent.END_KEY]: states.DatePickerState.CALENDAR_OPEN,
+        // ENTER_KEY is handled by guards - will dispatch DATE_SELECT or RANGE_START_SELECT
+    },
+    [states.DatePickerState.SELECTING_START]: {
+        [states.DatePickerEvent.RANGE_START_SELECT]: states.DatePickerState.SELECTING_END,
+        [states.DatePickerEvent.OUTSIDE_CLICK]: states.DatePickerState.IDLE,
+        [states.DatePickerEvent.ESCAPE_KEY]: states.DatePickerState.FOCUSED,
+    },
+    [states.DatePickerState.SELECTING_END]: {
+        [states.DatePickerEvent.RANGE_END_SELECT]: states.DatePickerState.DATE_SELECTED,
+        [states.DatePickerEvent.RANGE_START_SELECT]: states.DatePickerState.SELECTING_END,
+        [states.DatePickerEvent.OUTSIDE_CLICK]: states.DatePickerState.IDLE,
+        [states.DatePickerEvent.ESCAPE_KEY]: states.DatePickerState.FOCUSED,
+        [states.DatePickerEvent.TAB_KEY]: states.DatePickerState.IDLE,
+        // Keyboard navigation
+        [states.DatePickerEvent.ARROW_UP]: states.DatePickerState.SELECTING_END,
+        [states.DatePickerEvent.ARROW_DOWN]: states.DatePickerState.SELECTING_END,
+        [states.DatePickerEvent.ARROW_LEFT]: states.DatePickerState.SELECTING_END,
+        [states.DatePickerEvent.ARROW_RIGHT]: states.DatePickerState.SELECTING_END,
+        [states.DatePickerEvent.PAGE_UP]: states.DatePickerState.SELECTING_END,
+        [states.DatePickerEvent.PAGE_DOWN]: states.DatePickerState.SELECTING_END,
+        [states.DatePickerEvent.HOME_KEY]: states.DatePickerState.SELECTING_END,
+        [states.DatePickerEvent.END_KEY]: states.DatePickerState.SELECTING_END,
+        [states.DatePickerEvent.ENTER_KEY]: states.DatePickerState.DATE_SELECTED,
+        [states.DatePickerEvent.PREV_MONTH]: states.DatePickerState.SELECTING_END,
+        [states.DatePickerEvent.NEXT_MONTH]: states.DatePickerState.SELECTING_END,
+    },
+    [states.DatePickerState.DATE_SELECTED]: {
+        [states.DatePickerEvent.CALENDAR_CLOSE]: states.DatePickerState.IDLE,
+        [states.DatePickerEvent.INPUT_FOCUS]: states.DatePickerState.FOCUSED,
+    },
+    [states.DatePickerState.DISABLED]: {
+        [states.DatePickerEvent.ENABLE]: states.DatePickerState.IDLE,
+    },
+    [states.DatePickerState.READONLY]: {
+        [states.DatePickerEvent.UNSET_READONLY]: states.DatePickerState.IDLE,
+    },
+    [states.DatePickerState.ERROR]: {
+        [states.DatePickerEvent.VALUE_CHANGE]: states.DatePickerState.IDLE,
+        [states.DatePickerEvent.CLEAR_ERROR]: states.DatePickerState.IDLE,
+    },
+};
+/**
+ * Date picker state machine
+ * Manages state transitions and context updates for the date picker
+ */
+class DatePickerStateMachine {
+    /**
+     * Create a new date picker state machine
+     *
+     * @param {Partial<DatePickerContext>} initialContext - Initial context values
+     */
+    constructor(initialContext = {}) {
+        this.listeners = new Set();
+        this.currentState = states.DatePickerState.IDLE;
+        this.context = this.createInitialContext(initialContext);
+    }
+    /**
+     * Create initial context with defaults
+     *
+     * @param {Partial<DatePickerContext>} partial - Partial context to merge with defaults
+     * @returns Complete context object
+     */
+    createInitialContext(partial) {
+        return {
+            mode: 'single',
+            value: '',
+            startDate: null,
+            endDate: null,
+            isOpen: false,
+            isFocused: false,
+            isDisabled: false,
+            isReadonly: false,
+            isInvalid: false,
+            lastFocusedInput: null,
+            minDate: null,
+            maxDate: null,
+            dateFormat: 'm/d/Y',
+            allowInput: true,
+            closeOnSelect: true,
+            viewDate: null,
+            focusedDate: null,
+            ...partial,
+        };
+    }
+    /**
+     * Send an event to the state machine
+     * This is the primary method for triggering state transitions
+     *
+     * @param {string} eventType - The type of event to send
+     * @param {any} payload - Optional event payload
+     * @returns The updated context
+     */
+    send(eventType, payload) {
+        const event = {
+            type: eventType,
+            payload,
+            timestamp: Date.now(),
+        };
+        const nextState = this.getNextState(this.currentState, event);
+        if (!nextState) {
+            // No valid transition, return current context
+            return this.context;
+        }
+        // Check guards
+        if (!guards.checkGuard(nextState, event.type, this.context, event)) {
+            return this.context;
+        }
+        // Execute actions to update context
+        // Actions are defined for the current state, not the next state
+        const contextUpdates = actions.executeAction(this.currentState, event.type, this.context, event);
+        const newContext = {
+            ...this.context,
+            ...contextUpdates,
+        };
+        // Create a transition object
+        const stateTransition = {
+            from: this.currentState,
+            to: nextState,
+            event,
+            context: newContext,
+        };
+        // Update state
+        this.currentState;
+        this.currentState = nextState;
+        this.context = newContext;
+        // Execute side effects
+        effects.executeEffect(nextState, event.type, this.context, event);
+        // Notify listeners
+        this.notifyListeners(stateTransition);
+        return this.context;
+    }
+    /**
+     * Get the current state
+     *
+     * @returns The current state
+     */
+    getState() {
+        return this.currentState;
+    }
+    /**
+     * Get the current context
+     *
+     * @returns A copy of the current context
+     */
+    getContext() {
+        return { ...this.context };
+    }
+    /**
+     * Update context directly (use sparingly)
+     *
+     * @param {Partial<DatePickerContext>} updates - Partial context updates
+     * @returns The updated context
+     */
+    updateContext(updates) {
+        this.context = {
+            ...this.context,
+            ...updates,
+        };
+        return this.context;
+    }
+    /**
+     * Subscribe to state transitions
+     *
+     * @param {TransitionListener} listener - Function to call on each transition
+     * @returns Unsubscribe function
+     */
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    /**
+     * Check if a transition is valid from the current state
+     *
+     * @param {string} eventType - The event type to check
+     * @returns True if the transition is valid
+     */
+    canTransition(eventType) {
+        const event = { type: eventType, timestamp: Date.now() };
+        const nextState = this.getNextState(this.currentState, event);
+        if (!nextState) {
+            return false;
+        }
+        return guards.checkGuard(nextState, eventType, this.context, event);
+    }
+    /**
+     * Get the next state for a given event
+     *
+     * @param {DatePickerState} from - Current state
+     * @param {DatePickerEvent} event - The event
+     * @returns Next state or null if no transition exists
+     */
+    getNextState(from, event) {
+        const transitions = stateTransitions[from];
+        if (!transitions) {
+            return null;
+        }
+        const nextState = transitions[event.type];
+        if (!nextState) {
+            return null;
+        }
+        return nextState;
+    }
+    /**
+     * Notify all listeners of a state transition
+     *
+     * @param {StateTransition} transition - The state transition
+     */
+    notifyListeners(transition) {
+        this.listeners.forEach((listener) => listener(transition));
+    }
+    /**
+     * Reset the state machine to initial state
+     *
+     * @param {Partial<DatePickerContext>} initialContext - Optional new initial context
+     */
+    reset(initialContext) {
+        this.currentState = states.DatePickerState.IDLE;
+        this.context = this.createInitialContext(initialContext || {});
+    }
+}
+// Made with Bob
+
+exports.DatePickerStateMachine = DatePickerStateMachine;
+//# sourceMappingURL=machine.js.map

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

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

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

@@ -0,0 +1,89 @@
+/**
+ * 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
+ */
+export declare enum DatePickerState {
+    /**
+     * Initial state - calendar closed, no focus
+     */
+    IDLE = "idle",
+    /**
+     * Input has focus, calendar closed
+     */
+    FOCUSED = "focused",
+    /**
+     * Calendar dropdown is open
+     */
+    CALENDAR_OPEN = "calendar_open",
+    /**
+     * User is selecting the start date (range mode)
+     */
+    SELECTING_START = "selecting_start",
+    /**
+     * User is selecting the end date (range mode)
+     */
+    SELECTING_END = "selecting_end",
+    /**
+     * Date(s) have been selected
+     */
+    DATE_SELECTED = "date_selected",
+    /**
+     * Component is disabled
+     */
+    DISABLED = "disabled",
+    /**
+     * Component is read-only
+     */
+    READONLY = "readonly",
+    /**
+     * Component is in an error state
+     */
+    ERROR = "error"
+}
+/**
+ * Date picker events
+ */
+export declare enum DatePickerEvent {
+    INPUT_FOCUS = "INPUT_FOCUS",
+    INPUT_BLUR = "INPUT_BLUR",
+    INPUT_CHANGE = "INPUT_CHANGE",
+    CALENDAR_ICON_CLICK = "CALENDAR_ICON_CLICK",
+    CALENDAR_OPEN = "CALENDAR_OPEN",
+    CALENDAR_CLOSE = "CALENDAR_CLOSE",
+    PREV_MONTH = "PREV_MONTH",
+    NEXT_MONTH = "NEXT_MONTH",
+    PREV_YEAR = "PREV_YEAR",
+    NEXT_YEAR = "NEXT_YEAR",
+    GO_TO_TODAY = "GO_TO_TODAY",
+    DATE_SELECT = "DATE_SELECT",
+    RANGE_START_SELECT = "RANGE_START_SELECT",
+    RANGE_END_SELECT = "RANGE_END_SELECT",
+    OUTSIDE_CLICK = "OUTSIDE_CLICK",
+    ESCAPE_KEY = "ESCAPE_KEY",
+    TAB_KEY = "TAB_KEY",
+    SHIFT_TAB_KEY = "SHIFT_TAB_KEY",
+    ENTER_KEY = "ENTER_KEY",
+    ARROW_UP = "ARROW_UP",
+    ARROW_DOWN = "ARROW_DOWN",
+    ARROW_LEFT = "ARROW_LEFT",
+    ARROW_RIGHT = "ARROW_RIGHT",
+    PAGE_UP = "PAGE_UP",
+    PAGE_DOWN = "PAGE_DOWN",
+    HOME_KEY = "HOME_KEY",
+    END_KEY = "END_KEY",
+    DISABLE = "DISABLE",
+    ENABLE = "ENABLE",
+    SET_READONLY = "SET_READONLY",
+    UNSET_READONLY = "UNSET_READONLY",
+    VALUE_CHANGE = "VALUE_CHANGE",
+    VALIDATION_ERROR = "VALIDATION_ERROR",
+    CLEAR_ERROR = "CLEAR_ERROR",
+    SET_MIN_DATE = "SET_MIN_DATE",
+    SET_MAX_DATE = "SET_MAX_DATE",
+    SET_DATE_FORMAT = "SET_DATE_FORMAT"
+}