@salt-ds/lab 1.0.0-alpha.55 → 1.0.0-alpha.57

package/dist-types/date-picker/DatePickerContext.d.ts

@@ -1,10 +1,11 @@
-import type { DateValue } from "@internationalized/date";
+import type { DateFrameworkType } from "@salt-ds/date-adapters";
+import { type Context, type Ref, type SyntheticEvent } from "react";
 import type { DateRangeSelection, SingleDateSelection } from "../calendar";
-import type { DateInputRangeError, DateInputSingleError } from "../date-input";
+import type { DateInputRangeDetails, DateInputSingleDetails } from "../date-input";
 /**
  * Interface representing the base state for a DatePicker.
  */
-interface DatePickerBaseState {
+interface DatePickerBaseState<TDate extends DateFrameworkType> {
     /**
      * The state properties of the DatePicker.
      */
@@ -28,23 +29,15 @@ interface DatePickerBaseState {
         /**
          * The minimum selectable date.
          */
-        minDate?: DateValue;
+        minDate?: TDate;
         /**
          * The maximum selectable date.
          */
-        maxDate?: DateValue;
+        maxDate?: TDate;
         /**
          * Reference to the container element.
          */
-        containerRef: React.Ref<HTMLDivElement>;
-        /**
-         * The locale used for date formatting.
-         */
-        locale?: string;
-        /**
-         * The time zone used for date formatting.
-         */
-        timeZone?: string;
+        containerRef: Ref<HTMLDivElement>;
     };
     /**
      * Helper functions for managing the DatePicker state.
@@ -61,99 +54,89 @@ interface DatePickerBaseState {
         setEnableApply: (newEnableApply: boolean) => void;
     };
 }
-/**
- * Type representing a single date picker error.
- */
-export declare type SingleDatePickerError = DateInputSingleError;
-/**
- * Type representing a range date picker error.
- */
-export declare type RangeDatePickerError = DateInputRangeError;
 /**
  * Interface representing the state for a single date picker.
  */
-export interface SingleDatePickerState extends DatePickerBaseState {
+export interface SingleDatePickerState<TDate extends DateFrameworkType> extends DatePickerBaseState<TDate> {
     /**
      * The state properties of the single date picker.
      */
-    state: DatePickerBaseState["state"] & {
+    state: DatePickerBaseState<TDate>["state"] & {
         /**
          * The selected date.
          */
-        selectedDate: SingleDateSelection | null;
+        selectedDate: SingleDateSelection<TDate> | null;
         /**
          * The default selected date.
          */
-        defaultSelectedDate?: SingleDateSelection;
+        defaultSelectedDate?: SingleDateSelection<TDate>;
     };
     /**
      * Helper functions for managing the single date picker state.
      */
-    helpers: DatePickerBaseState["helpers"] & {
+    helpers: DatePickerBaseState<TDate>["helpers"] & {
         /**
-         * Applies the selected date.
-         * @param newDate - The new selected date.
-         * @param error - The error encountered during selection, if any.
+         * Apply the selected single date.
+         * @param event - The synthetic event.
+         * @param date - The new applied date.
          */
-        apply: (newDate: SingleDateSelection | null, error: SingleDatePickerError) => void;
+        apply: (event: SyntheticEvent, date: SingleDateSelection<TDate> | null) => void;
         /**
-         * Sets the selected date.
-         * @param newDate - The new selected date.
-         * @param error - The error encountered during selection, if any.
+         * Select a single date.
+         * @param event - The synthetic event.
+         * @param date - The selected date or null.
+         * @param details - Details of selection, such as errors and original value.
          */
-        setSelectedDate: (newDate: SingleDateSelection | null, error: string | false) => void;
+        select: (event: SyntheticEvent, date: SingleDateSelection<TDate> | null, details?: DateInputSingleDetails) => void;
     };
 }
 /**
  * Interface representing the state for a range date picker.
  */
-export interface RangeDatePickerState extends DatePickerBaseState {
+export interface RangeDatePickerState<TDate extends DateFrameworkType> extends DatePickerBaseState<TDate> {
     /**
      * The state properties of the range date picker.
      */
-    state: DatePickerBaseState["state"] & {
+    state: DatePickerBaseState<TDate>["state"] & {
         /**
          * The selected date range.
          */
-        selectedDate: DateRangeSelection | null;
+        selectedDate: DateRangeSelection<TDate> | null;
         /**
          * The default selected date range.
          */
-        defaultSelectedDate?: DateRangeSelection;
+        defaultSelectedDate?: DateRangeSelection<TDate>;
     };
     /**
      * Helper functions for managing the range date picker state.
      */
-    helpers: DatePickerBaseState["helpers"] & {
+    helpers: DatePickerBaseState<TDate>["helpers"] & {
         /**
-         * Applies the selected date range.
-         * @param newDate - The new selected date range.
-         * @param error - The error encountered during selection, if any.
+         * Apply the selected date range.
+         * @param event - The synthetic event.
+         * @param date - The new applied date range
          */
-        apply: (newDate: DateRangeSelection | null, error: RangeDatePickerError) => void;
+        apply: (event: SyntheticEvent, date: DateRangeSelection<TDate> | null) => void;
         /**
-         * Sets the selected date range.
-         * @param newDate - The new selected date range.
-         * @param error - The error encountered during selection, if any.
-         */
-        setSelectedDate: (newDate: DateRangeSelection | null, error: {
-            startDate: string | false;
-            endDate: string | false;
-        }) => void;
+         * Select a date range.
+         * @param event - The synthetic event.
+         * @param date - The selected date.
+         * @param details - Details of selection, such as errors and original value.     */
+        select: (event: SyntheticEvent, date: DateRangeSelection<TDate> | null, details?: DateInputRangeDetails) => void;
     };
 }
 /**
  * Type representing the state of a date picker, either single or range.
  */
-export declare type DatePickerState = SingleDatePickerState | RangeDatePickerState;
+export declare type DatePickerState<TDate extends DateFrameworkType> = SingleDatePickerState<TDate> | RangeDatePickerState<TDate>;
 /**
  * Context for single date selection.
  */
-export declare const SingleDateSelectionContext: import("react").Context<SingleDatePickerState | undefined>;
+export declare const SingleDateSelectionContext: Context<SingleDatePickerState<any> | undefined>;
 /**
  * Context for date range selection.
  */
-export declare const DateRangeSelectionContext: import("react").Context<RangeDatePickerState | undefined>;
+export declare const DateRangeSelectionContext: Context<RangeDatePickerState<any> | undefined>;
 /**
  * Props for using the date picker context.
  */
@@ -168,15 +151,15 @@ export interface UseDatePickerContextProps {
  * @param props - The props for the hook.
  * @returns The state of the single date picker.
  */
-export declare function useDatePickerContext(props: {
+export declare function useDatePickerContext<TDate extends DateFrameworkType>(props: {
     selectionVariant: "single";
-}): SingleDatePickerState;
+}): SingleDatePickerState<TDate>;
 /**
  * Hook to use the date picker context for range date selection.
  * @param props - The props for the hook.
  * @returns The state of the range date picker.
  */
-export declare function useDatePickerContext(props: {
+export declare function useDatePickerContext<TDate extends DateFrameworkType>(props: {
     selectionVariant: "range";
-}): RangeDatePickerState;
+}): RangeDatePickerState<TDate>;
 export {};

package/dist-types/date-picker/DatePickerOverlayProvider.d.ts

@@ -31,6 +31,11 @@ interface DatePickerOverlayHelpers {
      * @param newOpen - The new value for the open state.
      */
     setOpen: (newOpen: boolean) => void;
+    /**~
+     * Register a callback for when onDismiss is called
+     * @param onDismissCallback
+     */
+    setOnDismiss: (onDismissCallback: () => void) => void;
 }
 /**
  * Interface representing the context type for a DatePicker overlay.
@@ -53,6 +58,11 @@ interface DatePickerOverlayProviderProps {
      * If `true`, the overlay is open.
      */
     open?: boolean;
+    /**
+     * Handler for when open state changes
+     * @param newOpen - true when opened
+     */
+    onOpen?: (newOpen: boolean) => void;
     /**
      * The default open state of the overlay.
      */

package/dist-types/date-picker/DatePickerRangeInput.d.ts

@@ -1,7 +1,17 @@
-import { type DateInputRangeProps } from "../date-input";
+import { type DateFrameworkType, type SaltDateAdapter } from "@salt-ds/date-adapters";
+import type { DateRangeSelection } from "../calendar";
+import { type DateInputRangeDetails, type DateInputRangeProps } from "../date-input";
 /**
  * Props for the DatePickerRangeInput component.
  */
-export interface DatePickerRangeInputProps extends DateInputRangeProps {
+export interface DatePickerRangeInputProps<TDate extends DateFrameworkType> extends DateInputRangeProps<TDate> {
+    /**
+     * Function to validate the entered date
+     * @param date - The selected date
+     * @param details - The details of date selection, either a valid date or error
+     * @returns updated DateInputRangeDetails details
+     */
+    validate?: (date: DateRangeSelection<TDate> | null, details: DateInputRangeDetails) => DateInputRangeDetails;
 }
-export declare const DatePickerRangeInput: import("react").ForwardRefExoticComponent<DatePickerRangeInputProps & import("react").RefAttributes<HTMLDivElement>>;
+export declare function defaultRangeValidator<TDate extends DateFrameworkType>(dateAdapter: SaltDateAdapter<TDate>, date: DateRangeSelection<TDate> | null, details: DateInputRangeDetails, minDate: TDate | undefined, maxDate: TDate | undefined): DateInputRangeDetails;
+export declare const DatePickerRangeInput: import("react").ForwardRefExoticComponent<DatePickerRangeInputProps<Date | import("dayjs").Dayjs | import("luxon").DateTime<boolean> | import("moment").Moment> & import("react").RefAttributes<HTMLDivElement>>;

package/dist-types/date-picker/DatePickerRangePanel.d.ts

@@ -1,17 +1,17 @@
-import { type DateValue } from "@internationalized/date";
+import type { DateFrameworkType } from "@salt-ds/date-adapters";
 import { type ComponentPropsWithoutRef, type SyntheticEvent } from "react";
-import { type CalendarDateGridProps, type CalendarNavigationProps, type CalendarOffsetProps, type CalendarRangeProps, type CalendarWeekHeaderProps, type DateRangeSelection } from "../calendar";
+import { type CalendarGridProps, type CalendarNavigationProps, type CalendarOffsetProps, type CalendarRangeProps, type CalendarWeekHeaderProps, type DateRangeSelection } from "../calendar";
 /**
  * Props for the DatePickerRangePanel component.
  * @template T - The type of the selected date range.
  */
-export interface DatePickerRangePanelProps<T> extends ComponentPropsWithoutRef<"div"> {
+export interface DatePickerRangePanelProps<TDate extends DateFrameworkType> extends ComponentPropsWithoutRef<"div"> {
     /**
      * Callback fired when a date range is selected.
      * @param event - The synthetic event.
      * @param selectedDate - The selected date range or null.
      */
-    onSelect?: (event: SyntheticEvent, selectedDate?: T | null) => void;
+    onSelectionChange?: (event: SyntheticEvent, selectedDate?: DateRangeSelection<TDate> | null) => void;
     /**
      * Helper text to be displayed below the date picker.
      */
@@ -19,39 +19,39 @@ export interface DatePickerRangePanelProps<T> extends ComponentPropsWithoutRef<"
     /**
      * The currently visible month for the start date.
      */
-    startVisibleMonth?: DateValue;
+    startVisibleMonth?: TDate;
     /**
      * The default visible month for the start date.
      */
-    defaultStartVisibleMonth?: DateValue;
+    defaultStartVisibleMonth?: TDate;
     /**
      * Callback fired when the visible month for the start date changes.
      * @param event - The synthetic event.
      * @param visibleMonth - The new visible month for the start date.
      */
-    onStartVisibleMonthChange?: (event: SyntheticEvent, visibleMonth: DateValue) => void;
+    onStartVisibleMonthChange?: (event: SyntheticEvent, visibleMonth: TDate) => void;
     /**
      * The currently visible month for the end date.
      */
-    endVisibleMonth?: DateValue;
+    endVisibleMonth?: TDate;
     /**
      * The default visible month for the end date.
      */
-    defaultEndVisibleMonth?: DateValue;
+    defaultEndVisibleMonth?: TDate;
     /**
      * Callback fired when the visible month for the end date changes.
      * @param event - The synthetic event.
      * @param visibleMonth - The new visible month for the end date.
      */
-    onEndVisibleMonthChange?: (event: SyntheticEvent, visibleMonth: DateValue) => void;
+    onEndVisibleMonthChange?: (event: SyntheticEvent, visibleMonth: TDate) => void;
     /**
      * Props to be passed to the start date CalendarNavigation component.
      */
-    StartCalendarNavigationProps?: CalendarNavigationProps;
+    StartCalendarNavigationProps?: CalendarNavigationProps<TDate>;
     /**
      * Props to be passed to the start date calendar component.
      */
-    StartCalendarProps?: Partial<Omit<CalendarRangeProps | CalendarOffsetProps, "selectedDate" | "defaultSelectedDate" | "onSelectedDateChange" | "onVisibleMonthChange">>;
+    StartCalendarProps?: Partial<Omit<CalendarRangeProps<TDate> | CalendarOffsetProps<TDate>, "selectedDate" | "defaultSelectedDate" | "onSelectionChange" | "onVisibleMonthChange">>;
     /**
      * Props to be passed to the start date CalendarWeekHeader component.
      */
@@ -59,15 +59,15 @@ export interface DatePickerRangePanelProps<T> extends ComponentPropsWithoutRef<"
     /**
      * Props to be passed to the start date CalendarDataGrid component.
      */
-    StartCalendarDataGridProps?: CalendarDateGridProps;
+    StartCalendarDataGridProps?: CalendarGridProps<TDate>;
     /**
      * Props to be passed to the end date CalendarNavigation component.
      */
-    EndCalendarProps?: Partial<Omit<CalendarRangeProps, "selectedDate" | "defaultSelectedDate" | "onSelectedDateChange" | "onVisibleMonthChange">>;
+    EndCalendarProps?: Partial<Omit<CalendarRangeProps<TDate>, "selectedDate" | "defaultSelectedDate" | "onSelectionChange" | "onVisibleMonthChange">>;
     /**
      * Props to be passed to the end date CalendarNavigation component.
      */
-    EndCalendarNavigationProps?: CalendarNavigationProps;
+    EndCalendarNavigationProps?: CalendarNavigationProps<TDate>;
     /**
      * Props to be passed to the end date CalendarWeekHeader component.
      */
@@ -75,6 +75,6 @@ export interface DatePickerRangePanelProps<T> extends ComponentPropsWithoutRef<"
     /**
      * Props to be passed to the end date CalendarDataGrid component.
      */
-    EndCalendarDataGridProps?: CalendarDateGridProps;
+    EndCalendarDataGridProps?: CalendarGridProps<TDate>;
 }
-export declare const DatePickerRangePanel: import("react").ForwardRefExoticComponent<DatePickerRangePanelProps<DateRangeSelection> & import("react").RefAttributes<HTMLDivElement>>;
+export declare const DatePickerRangePanel: import("react").ForwardRefExoticComponent<DatePickerRangePanelProps<Date | import("dayjs").Dayjs | import("luxon").DateTime<boolean> | import("moment").Moment> & import("react").RefAttributes<HTMLDivElement>>;

package/dist-types/date-picker/DatePickerSingleInput.d.ts

@@ -1,7 +1,16 @@
-import { type DateInputSingleProps } from "../date-input";
+import { type DateFrameworkType } from "@salt-ds/date-adapters";
+import type { SingleDateSelection } from "../calendar";
+import { type DateInputSingleDetails, type DateInputSingleProps } from "../date-input";
 /**
  * Props for the DatePickerSingleInput component.
  */
-export interface DatePickerSingleInputProps extends DateInputSingleProps {
+export interface DatePickerSingleInputProps<TDate extends DateFrameworkType> extends DateInputSingleProps<TDate> {
+    /**
+     * Function to validate the entered date
+     * @param date - The selected date
+     * @param details - The details of date selection, either a valid date or error
+     * @returns updated DateInputSingleDetails details
+     */
+    validate?: (date: SingleDateSelection<TDate>, details: DateInputSingleDetails) => DateInputSingleDetails;
 }
-export declare const DatePickerSingleInput: import("react").ForwardRefExoticComponent<DatePickerSingleInputProps & import("react").RefAttributes<HTMLDivElement>>;
+export declare const DatePickerSingleInput: import("react").ForwardRefExoticComponent<DatePickerSingleInputProps<any> & import("react").RefAttributes<HTMLDivElement>>;

package/dist-types/date-picker/DatePickerSinglePanel.d.ts

@@ -1,17 +1,17 @@
-import { type DateValue } from "@internationalized/date";
+import type { DateFrameworkType } from "@salt-ds/date-adapters";
 import { type ComponentPropsWithoutRef, type SyntheticEvent } from "react";
-import { type CalendarDateGridProps, type CalendarNavigationProps, type CalendarSingleProps, type CalendarWeekHeaderProps } from "../calendar";
+import { type CalendarGridProps, type CalendarNavigationProps, type CalendarSingleProps, type CalendarWeekHeaderProps } from "../calendar";
 /**
  * Props for the DatePickerSinglePanel component.
  * @template T - The type of the selected date.
  */
-export interface DatePickerSinglePanelProps<T> extends ComponentPropsWithoutRef<"div"> {
+export interface DatePickerSinglePanelProps<TDate extends DateFrameworkType> extends ComponentPropsWithoutRef<"div"> {
     /**
      * Callback fired when a date is selected.
      * @param event - The synthetic event.
      * @param selectedDate - The selected date or null.
      */
-    onSelect?: (event: SyntheticEvent, selectedDate?: T | null) => void;
+    onSelectionChange?: (event: SyntheticEvent, selectedDate?: TDate | null) => void;
     /**
      * Helper text to be displayed below the date picker.
      */
@@ -19,25 +19,25 @@ export interface DatePickerSinglePanelProps<T> extends ComponentPropsWithoutRef<
     /**
      * The currently visible month.
      */
-    visibleMonth?: DateValue;
+    visibleMonth?: TDate;
     /**
      * The default visible month.
      */
-    defaultVisibleMonth?: DateValue;
+    defaultVisibleMonth?: TDate;
     /**
      * Callback fired when the visible month changes.
      * @param event - The synthetic event.
      * @param visibleMonth - The new visible month.
      */
-    onVisibleMonthChange?: (event: SyntheticEvent, visibleMonth: DateValue) => void;
+    onVisibleMonthChange?: (event: SyntheticEvent, visibleMonth: TDate) => void;
     /**
      * Props to be passed to the Calendar component.
      */
-    CalendarProps?: Partial<Omit<CalendarSingleProps, "selectionVariant" | "selectedDate" | "defaultSelectedDate" | "onSelectedDateChange" | "onVisibleMonthChange">>;
+    CalendarProps?: Partial<Omit<CalendarSingleProps<TDate>, "selectionVariant" | "selectedDate" | "defaultSelectedDate" | "onSelectionChange" | "onVisibleMonthChange">>;
     /**
      * Props to be passed to the CalendarNavigation component.
      */
-    CalendarNavigationProps?: CalendarNavigationProps;
+    CalendarNavigationProps?: CalendarNavigationProps<TDate>;
     /**
      * Props to be passed to the CalendarWeekHeader component.
      */
@@ -45,6 +45,6 @@ export interface DatePickerSinglePanelProps<T> extends ComponentPropsWithoutRef<
     /**
      * Props to be passed to the CalendarDataGrid component.
      */
-    CalendarDataGridProps?: CalendarDateGridProps;
+    CalendarDataGridProps?: CalendarGridProps<TDate>;
 }
-export declare const DatePickerSinglePanel: import("react").ForwardRefExoticComponent<DatePickerSinglePanelProps<DateValue> & import("react").RefAttributes<HTMLDivElement>>;
+export declare const DatePickerSinglePanel: import("react").ForwardRefExoticComponent<DatePickerSinglePanelProps<Date | import("dayjs").Dayjs | import("luxon").DateTime<boolean> | import("moment").Moment> & import("react").RefAttributes<HTMLDivElement>>;

package/dist-types/date-picker/DatePickerTrigger.d.ts

@@ -0,0 +1,9 @@
+import { type ReactNode } from "react";
+/**
+ * Props for the DatePickerTrigger component.
+ */
+export interface DatePickerTriggerProps {
+    className?: string;
+    children?: ReactNode;
+}
+export declare const DatePickerTrigger: import("react").ForwardRefExoticComponent<DatePickerTriggerProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist-types/date-picker/index.d.ts

@@ -2,7 +2,8 @@ export * from "./DatePicker";
 export * from "./DatePickerActions";
 export * from "./DatePickerContext";
 export * from "./DatePickerOverlay";
-export * from "./DatePickerSingleInput";
-export * from "./DatePickerSinglePanel";
 export * from "./DatePickerRangeInput";
 export * from "./DatePickerRangePanel";
+export * from "./DatePickerSingleInput";
+export * from "./DatePickerSinglePanel";
+export * from "./DatePickerTrigger";

package/dist-types/date-picker/useDatePicker.d.ts

@@ -1,112 +1,105 @@
-import { type DateValue } from "@internationalized/date";
-import { type DateRangeSelection, type SingleDateSelection } from "../calendar";
+import type { DateFrameworkType } from "@salt-ds/date-adapters";
+import { type SyntheticEvent } from "react";
+import type { DateRangeSelection, SingleDateSelection } from "../calendar";
+import type { DateInputRangeDetails, DateInputSingleDetails } from "../date-input";
 import type { RangeDatePickerState, SingleDatePickerState } from "./DatePickerContext";
-interface UseDatePickerBaseProps<T> {
+interface UseDatePickerBaseProps<TDate> {
     /** If `true`, the component is disabled. */
     disabled?: boolean;
     /** If `true`, the component is read-only. */
     readOnly?: boolean;
-    /**
-     * The selected date. The selected date will be controlled when this prop is provided.
-     */
-    selectedDate?: T | null;
-    /**
-     * The initial selected date, when the selected date is uncontrolled.
-     */
-    defaultSelectedDate?: UseDatePickerBaseProps<T>["selectedDate"];
     /**
      * The minimum date for the range, default is 1900.
      */
-    minDate?: DateValue;
+    minDate?: TDate;
     /**
      * The maximum date for the range, default is 2100.
      */
-    maxDate?: DateValue;
+    maxDate?: TDate;
     /**
      * Handler for when the date selection is cancelled.
      */
     onCancel?: () => void;
-    /**
-     * Time zone of the date selection, defaults to the current time zone of the user.
-     */
-    timeZone?: string;
-    /**
-     * Locale of the date selection, defaults to the current locale of the user.
-     */
-    locale?: string;
 }
 /**
  * Props for single date selection.
  *
- * @typedef {UseDatePickerBaseProps<SingleDateSelection>} UseDatePickerSingleProps
- * @property {"single"} selectionVariant - Single date selection.
- * @property {(selectedSingleDate: SingleDateSelection | null, singleError: string | false) => void} [onSelectedDateChange] - Handler called when the selected date changes.
- * @property {(appliedSingleDate: SingleDateSelection | null, singleError: string | false) => void} [onApply] - Handler called when the selected date is confirmed/applied.
+ * @template TDate - The type of the date framework.
  */
-export interface UseDatePickerSingleProps extends UseDatePickerBaseProps<SingleDateSelection> {
+export interface UseDatePickerSingleProps<TDate extends DateFrameworkType> extends UseDatePickerBaseProps<TDate> {
     /**
      * Single date selection.
      */
     selectionVariant: "single";
+    /**
+     * The selected date. The selected date will be controlled when this prop is provided.
+     */
+    selectedDate?: SingleDateSelection<TDate> | null;
+    /**
+     * The initial selected date, when the selected date is uncontrolled.
+     */
+    defaultSelectedDate?: SingleDateSelection<TDate> | null;
     /**
      * Handler called when the selected date changes.
-     * @param {SingleDateSelection | null} selectedSingleDate - The selected date.
-     * @param {string | false} singleError - Error returned by the parser or `false`.
+     * @param event - The synthetic event.
+     * @param date - The selected date or null.
+     * @param details - The selected date details.
      */
-    onSelectedDateChange?: (selectedSingleDate: SingleDateSelection | null, singleError: string | false) => void;
+    onSelectionChange?: (event: SyntheticEvent, date: SingleDateSelection<TDate> | null, details?: DateInputSingleDetails) => void;
     /**
      * Handler called when the selected date is confirmed/applied.
-     * @param {SingleDateSelection | null} appliedSingleDate - The selected date.
-     * @param {string | false} singleError - Error returned by the parser or `false`.
+     * @param event - The synthetic event.
+     * @param date - The selected date or null.
      */
-    onApply?: (appliedSingleDate: SingleDateSelection | null, singleError: string | false) => void;
+    onApply?: (event: SyntheticEvent, date: SingleDateSelection<TDate> | null) => void;
 }
 /**
  * Props for date range selection.
  *
- * @typedef {UseDatePickerBaseProps<DateRangeSelection>} UseDatePickerRangeProps
- * @property {"range"} selectionVariant - Date range selection.
- * @property {(selectedRangeDate: DateRangeSelection | null, rangeError: { startDate: string | false; endDate: string | false }) => void} [onSelectedDateChange] - Handler called when the selected date changes.
- * @property {(appliedRangeDate: DateRangeSelection | null, rangeError: { startDate: string | false; endDate: string | false }) => void} [onApply] - Handler called when the selected date is confirmed/applied.
+ * @template TDate - The type of the date framework.
  */
-export interface UseDatePickerRangeProps extends UseDatePickerBaseProps<DateRangeSelection> {
+export interface UseDatePickerRangeProps<TDate extends DateFrameworkType> extends UseDatePickerBaseProps<TDate> {
     /**
      * Date range selection.
      */
     selectionVariant: "range";
     /**
-     * Handler called when the selected date changes.
-     * @param {DateRangeSelection | null} selectedRangeDate - The selected date.
-     * @param {{ startDate: string | false; endDate: string | false }} rangeError - Error returned by the parser or `false`.
+     * The selected date range. The selected date will be controlled when this prop is provided.
      */
-    onSelectedDateChange?: (selectedRangeDate: DateRangeSelection | null, rangeError: {
-        startDate: string | false;
-        endDate: string | false;
-    }) => void;
+    selectedDate?: DateRangeSelection<TDate> | null;
     /**
-     * Handler called when the selected date is confirmed/applied.
-     * @param {DateRangeSelection | null} appliedRangeDate - The selected date.
-     * @param {{ startDate: string | false; endDate: string | false }} rangeError - Error returned by the parser or `false`.
+     * The initial selected date range, when the selected date is uncontrolled.
+     */
+    defaultSelectedDate?: DateRangeSelection<TDate> | null;
+    /**
+     * Handler called when the selected date range changes.
+     * @param event - The synthetic event.
+     * @param date - The selected date range or null.
+     * @param details - The selected date range details.
+     */
+    onSelectionChange?: (event: SyntheticEvent, date: DateRangeSelection<TDate> | null, details?: DateInputRangeDetails) => void;
+    /**
+     * Handler called when the selected date range is confirmed/applied.
+     * @param event - The synthetic event.
+     * @param date - The selected date range.
      */
-    onApply?: (appliedRangeDate: DateRangeSelection | null, rangeError: {
-        startDate: string | false;
-        endDate: string | false;
-    }) => void;
+    onApply?: (event: SyntheticEvent, date: DateRangeSelection<TDate> | null) => void;
 }
 /**
  * Props for the useDatePicker hook.
  *
- * @template SelectionVariant
- * @typedef {SelectionVariant extends "single" ? UseDatePickerSingleProps : SelectionVariant extends "range" ? UseDatePickerRangeProps : never} UseDatePickerProps
+ * @template TDate - The type of the date framework.
+ * @template SelectionVariant - The selection variant, either "single" or "range".
  */
-export declare type UseDatePickerProps<SelectionVariant> = SelectionVariant extends "single" ? UseDatePickerSingleProps : SelectionVariant extends "range" ? UseDatePickerRangeProps : never;
+export declare type UseDatePickerProps<TDate extends DateFrameworkType, SelectionVariant> = SelectionVariant extends "single" ? UseDatePickerSingleProps<TDate> : SelectionVariant extends "range" ? UseDatePickerRangeProps<TDate> : never;
 /**
  * Custom hook for managing date picker state.
  *
- * @template SelectionVariant
- * @param {UseDatePickerProps<SelectionVariant>} props - The props for the date picker.
- * @param {React.ForwardedRef<HTMLDivElement>} ref - The ref for the date picker container.
- * @returns {DatePickerState<SelectionVariant extends "single" ? SingleDateSelection : DateRangeSelection>} The date picker state and helpers.
+ * @template TDate - The type of the date framework.
+ * @template SelectionVariant - The selection variant, either "single" or "range".
+ * @param props - The props for the date picker.
+ * @param ref - The ref for the date picker container.
+ * @returns The date picker state and helpers.
  */
-export declare function useDatePicker<SelectionVariant extends "single" | "range">(props: UseDatePickerProps<SelectionVariant>, ref: React.ForwardedRef<HTMLDivElement>): SingleDatePickerState | RangeDatePickerState;
+export declare function useDatePicker<TDate extends DateFrameworkType, SelectionVariant extends "single" | "range">(props: UseDatePickerProps<TDate, SelectionVariant>, ref: React.ForwardedRef<HTMLDivElement>): SingleDatePickerState<TDate> | RangeDatePickerState<TDate>;
 export {};

package/dist-types/index.d.ts

@@ -27,9 +27,11 @@ export { InputLegacy as Input, type InputLegacyProps as InputProps, StaticInputA
 export * from "./layer-layout";
 export * from "./list";
 export * from "./list-next";
+export * from "./localization-provider";
 export * from "./logo";
 export * from "./menu-button";
 export * from "./metric";
+export * from "./overlay";
 export * from "./portal";
 export * from "./query-input";
 export * from "./responsive";