@salt-ds/lab 1.0.0-alpha.54 → 1.0.0-alpha.56

package/dist-types/date-input/DateInputRange.d.ts

@@ -1,12 +1,7 @@
-import { type DateValue } from "@internationalized/date";
 import { type InputProps } from "@salt-ds/core";
+import type { DateDetail, DateFrameworkType, ParserResult } from "@salt-ds/date-adapters";
 import { type ChangeEvent, type ComponentPropsWithoutRef, type InputHTMLAttributes, type ReactNode, type Ref, type SyntheticEvent } from "react";
-import { type DateRangeSelection } from "../calendar";
-import type { DateInputSingleParserError } from "./DateInputSingle";
-/**
- * Date error produced by DateInputRange parser.
- */
-export declare type DateInputRangeParserError = string | false;
+import type { DateRangeSelection } from "../calendar";
 /**
  * DateInputRange raw value or null if no date is defined.
  */
@@ -15,37 +10,26 @@ export declare type DateInputRangeValue = {
     endDate?: string | null;
 };
 /**
- * Return value of DateInputRange parser.
- * @template T
+ * Details of parsing the date range
  */
-export interface DateInputRangeParserResult<T = DateValue | null> {
-    /**
-     * The parsed date value.
-     */
-    date: T;
-    /**
-     * The error encountered during parsing, if any.
-     */
-    error: DateInputRangeParserError;
-}
+export declare type DateInputRangeDetails = {
+    /** Details of parsing the start date and applying any validation */
+    startDate?: DateDetail;
+    /** Details of parsing the end date and applying any validation */
+    endDate?: DateDetail;
+};
 /**
- * Date Range error returned with selected date to indicate invalid dates.
+ * Enum to identify the field being parsed
  */
-export declare type DateInputRangeError = {
-    /**
-     * The error for the start date.
-     */
-    startDate: DateInputSingleParserError;
-    /**
-     * The error for the end date.
-     */
-    endDate: DateInputSingleParserError;
-};
+export declare enum DateParserField {
+    START = "start",
+    END = "end"
+}
 /**
  * Props for the DateInputRange component.
  * @template T
  */
-export interface DateInputRangeProps<T = DateRangeSelection> extends Omit<ComponentPropsWithoutRef<"div">, "defaultValue" | "onChange">, Omit<InputProps, "defaultValue" | "inputRef" | "value" | "onChange"> {
+export interface DateInputRangeProps<TDate extends DateFrameworkType> extends Omit<ComponentPropsWithoutRef<"div">, "defaultValue" | "onChange">, Omit<InputProps, "defaultValue" | "inputRef" | "value" | "onChange"> {
     /**
      * The aria-label for accessibility.
      */
@@ -86,9 +70,9 @@ export interface DateInputRangeProps<T = DateRangeSelection> extends Omit<Compon
      */
     variant?: "primary" | "secondary";
     /**
-     * Function to format the input value.
+     * Format string for date.
      */
-    format?: (date: DateValue | null) => string;
+    format?: string;
     /**
      * Optional ref for the start input component.
      */
@@ -97,6 +81,18 @@ export interface DateInputRangeProps<T = DateRangeSelection> extends Omit<Compon
      * Optional ref for the end input component.
      */
     endInputRef?: Ref<HTMLInputElement>;
+    /**
+     * Locale for date formatting and parsing
+     */
+    locale?: any;
+    /**
+     * Parser callback, if not using the adapter's parser
+     * @param value - date string to parse
+     * @param field: DateParserField to identify value,
+     * @param format - format required
+     * @param locale - locale required
+     */
+    parse?: (value: string, field: DateParserField, format: string, locale?: any) => ParserResult<TDate>;
     /**
      * Input value. Use when the input value is controlled.
      */
@@ -108,43 +104,29 @@ export interface DateInputRangeProps<T = DateRangeSelection> extends Omit<Compon
     /**
      * The date value. Use when the component is controlled.
      */
-    date?: T | null;
+    date?: DateRangeSelection<TDate> | null;
     /**
      * The initial selected date value. Use when the component is uncontrolled.
      */
-    defaultDate?: T | null;
+    defaultDate?: DateRangeSelection<TDate> | null;
     /**
      * Callback fired when the input value changes.
      * @param event - The change event.
      * @param date - The new date input range value.
      */
-    onChange?: (event: ChangeEvent<HTMLInputElement>, date: DateInputRangeValue) => void;
+    onChange?: (event: ChangeEvent<HTMLInputElement>) => void;
     /**
      * Callback fired when the selected date changes.
      * @param event - The synthetic event.
-     * @param date - The new date value.
-     * @param error - The date input range error.
+     * @param date - the selected date, invalid date if not a valid date or undefined (uncontrolled) or null (controlled) if not defined
+     * @param details - The details of date selection, either a valid date or error
      */
-    onDateChange?: (event: SyntheticEvent, date: T | null, error: DateInputRangeError) => void;
+    onDateChange?: (event: SyntheticEvent, date: DateRangeSelection<TDate> | null, details: DateInputRangeDetails) => void;
     /**
      * Called when input values change, either due to user interaction or programmatic formatting of valid dates.
+     * @param event - The synthetic event or null if a programmatic change.
      * @param newValue - The new date input range value.
-     * @param isFormatted - Whether the value is formatted.
-     */
-    onDateValueChange?: (newValue: DateInputRangeValue, isFormatted: boolean) => void;
-    /**
-     * Function to parse date string to valid `DateValue` or null, if invalid.
-     * @param inputDate - The input date string.
-     * @returns The result of the date input range parser.
-     */
-    parse?: (inputDate: string) => DateInputRangeParserResult;
-    /**
-     * Locale of the entered date.
-     */
-    locale?: string;
-    /**
-     * Timezone of the entered date.
      */
-    timeZone?: string;
+    onDateValueChange?: (event: SyntheticEvent | null, newValue: DateInputRangeValue) => void;
 }
-export declare const DateInputRange: import("react").ForwardRefExoticComponent<DateInputRangeProps<DateRangeSelection> & import("react").RefAttributes<HTMLDivElement>>;
+export declare const DateInputRange: import("react").ForwardRefExoticComponent<DateInputRangeProps<any> & import("react").RefAttributes<HTMLDivElement>>;

package/dist-types/date-input/DateInputSingle.d.ts

@@ -1,33 +1,15 @@
-import { type DateValue } from "@internationalized/date";
-import { type ComponentPropsWithoutRef, type InputHTMLAttributes, type ReactNode, type RefObject, type SyntheticEvent } from "react";
-import { type SingleDateSelection } from "../calendar";
+import type { DateDetail, DateFrameworkType, ParserResult } from "@salt-ds/date-adapters";
+import { type ComponentPropsWithoutRef, type InputHTMLAttributes, type ReactNode, type Ref, type SyntheticEvent } from "react";
+import type { SingleDateSelection } from "../calendar";
 /**
- * Date error produced by DateInputSingle parser.
+ * Details of parsing the date
  */
-export declare type DateInputSingleParserError = string | false;
-/**
- * Date error produced by DateInputSingle parser.
- */
-export declare type DateInputSingleError = DateInputSingleParserError;
-/**
- * Return value of DateInputSingle parser.
- * @template T
- */
-export interface DateInputSingleParserResult<T = DateValue | null> {
-    /**
-     * The parsed date value.
-     */
-    date: T;
-    /**
-     * The error encountered during parsing, if any.
-     */
-    error: DateInputSingleParserError;
-}
+export declare type DateInputSingleDetails = DateDetail;
 /**
  * Props for the DateInputSingle component.
  * @template T
  */
-export interface DateInputSingleProps<T = SingleDateSelection> extends Omit<ComponentPropsWithoutRef<"div">, "defaultValue">, Pick<ComponentPropsWithoutRef<"input">, "disabled" | "value" | "defaultValue" | "placeholder"> {
+export interface DateInputSingleProps<TDate extends DateFrameworkType> extends Omit<ComponentPropsWithoutRef<"div">, "defaultValue">, Pick<ComponentPropsWithoutRef<"input">, "disabled" | "value" | "defaultValue" | "placeholder"> {
     /**
      * The aria-label for accessibility.
      */
@@ -54,6 +36,10 @@ export interface DateInputSingleProps<T = SingleDateSelection> extends Omit<Comp
      * If `true`, the component is read-only.
      */
     readOnly?: boolean;
+    /**
+     * Start adornment component
+     */
+    startAdornment?: ReactNode;
     /**
      * Validation status.
      */
@@ -63,13 +49,24 @@ export interface DateInputSingleProps<T = SingleDateSelection> extends Omit<Comp
      */
     variant?: "primary" | "secondary";
     /**
-     * Function to format the input value.
+     * Format string for date.
      */
-    format?: (date: DateValue | null) => string;
+    format?: string;
     /**
      * Reference for the input.
      */
-    inputRef?: RefObject<HTMLInputElement>;
+    inputRef?: Ref<HTMLInputElement>;
+    /**
+     * Locale for date formatting and parsing
+     */
+    locale?: any;
+    /**
+     * Parser callback, if not using the adapter's parser
+     * @param value - date string to parse
+     * @param format - format required
+     * @param locale - locale required
+     */
+    parse?: (value: string, format: string, locale?: any) => ParserResult<TDate>;
     /**
      * Input value. Use when the input value is controlled.
      */
@@ -81,37 +78,23 @@ export interface DateInputSingleProps<T = SingleDateSelection> extends Omit<Comp
     /**
      * The date value. Use when the component is controlled.
      */
-    date?: T | null;
+    date?: TDate | null;
     /**
      * The initial selected date value. Use when the component is uncontrolled.
      */
-    defaultDate?: T | null;
+    defaultDate?: TDate | null;
     /**
      * Callback fired when the selected date changes.
      * @param event - The synthetic event.
-     * @param date - The new date value.
-     * @param error - The date input single error.
+     * @param date - the selected date, invalid date if not a valid date or undefined (uncontrolled) or null (controlled) if not defined
+     * @param details - The details of date selection, either a valid date or error
      */
-    onDateChange?: (event: SyntheticEvent, date: T | null, error: DateInputSingleError) => void;
-    /**
-     * Function to parse date string to valid `DateValue` or null, if invalid or empty.
-     * @param inputDate - The input date string.
-     * @returns The result of the date input single parser.
-     */
-    parse?: (inputDate: string) => DateInputSingleParserResult;
+    onDateChange?: (event: SyntheticEvent, date: SingleDateSelection<TDate> | null | undefined, details: DateInputSingleDetails) => void;
     /**
      * Called when input value changes, either due to user interaction or programmatic formatting of valid dates.
+     * @param event - The synthetic event or null if a programmatic change.
      * @param newValue - The new date input value.
-     * @param isFormatted - Whether the value is formatted.
-     */
-    onDateValueChange?: (newValue: string, isFormatted: boolean) => void;
-    /**
-     * Locale of the entered date.
-     */
-    locale?: string;
-    /**
-     * Timezone of the entered date.
      */
-    timeZone?: string;
+    onDateValueChange?: (event: SyntheticEvent | null, newValue: string) => void;
 }
-export declare const DateInputSingle: import("react").ForwardRefExoticComponent<DateInputSingleProps<DateValue> & import("react").RefAttributes<HTMLDivElement>>;
+export declare const DateInputSingle: import("react").ForwardRefExoticComponent<DateInputSingleProps<any> & import("react").RefAttributes<HTMLDivElement>>;

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

@@ -1,3 +1,2 @@
 export * from "./DateInputSingle";
 export * from "./DateInputRange";
-export * from "./utils";

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

@@ -1,3 +1,4 @@
+import type { DateFrameworkType } from "@salt-ds/date-adapters";
 import { type ReactNode } from "react";
 import { type UseDatePickerRangeProps, type UseDatePickerSingleProps } from "./useDatePicker";
 /**
@@ -8,17 +9,34 @@ export interface DatePickerBaseProps {
     children?: ReactNode;
     /** the open/close state of the overlay. The open/close state will be controlled when this prop is provided. */
     open?: boolean;
+    /**
+     * Handler for when open state changes
+     * @param newOpen - true when opened
+     */
+    onOpen?: (newOpen: boolean) => void;
     /**
      * the initial open/close state of the overlay, when the open/close state is un-controlled.
      */
     defaultOpen?: DatePickerBaseProps["open"];
 }
-export interface DatePickerSingleProps extends DatePickerBaseProps, UseDatePickerSingleProps {
+/**
+ * Props for the DatePicker component, when `selectionVariant` is `single`.
+ * @template T
+ */
+export interface DatePickerSingleProps<TDate extends DateFrameworkType> extends DatePickerBaseProps, UseDatePickerSingleProps<TDate> {
     selectionVariant: "single";
 }
-export interface DatePickerRangeProps extends DatePickerBaseProps, UseDatePickerRangeProps {
+/**
+ * Props for the DatePicker component, when `selectionVariant` is `range`.
+ * @template T
+ */
+export interface DatePickerRangeProps<TDate extends DateFrameworkType> extends DatePickerBaseProps, UseDatePickerRangeProps<TDate> {
     selectionVariant: "range";
 }
-export declare type DatePickerProps = DatePickerSingleProps | DatePickerRangeProps;
-export declare const DatePickerMain: import("react").ForwardRefExoticComponent<DatePickerProps & import("react").RefAttributes<HTMLDivElement>>;
-export declare const DatePicker: import("react").ForwardRefExoticComponent<DatePickerProps & import("react").RefAttributes<HTMLDivElement>>;
+/**
+ * Props for the DatePicker component.
+ * @template T
+ */
+export declare type DatePickerProps<TDate extends DateFrameworkType> = DatePickerSingleProps<TDate> | DatePickerRangeProps<TDate>;
+export declare const DatePickerMain: import("react").ForwardRefExoticComponent<DatePickerProps<any> & import("react").RefAttributes<HTMLDivElement>>;
+export declare const DatePicker: import("react").ForwardRefExoticComponent<DatePickerProps<Date | import("dayjs").Dayjs | import("luxon").DateTime<boolean> | import("moment").Moment> & import("react").RefAttributes<HTMLDivElement>>;

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

@@ -1,9 +1,10 @@
 import { type ButtonProps } from "@salt-ds/core";
-import React, { type ComponentPropsWithoutRef, type SyntheticEvent, type Ref } from "react";
+import { type ComponentPropsWithoutRef, type Ref, type SyntheticEvent } from "react";
 import type { DateRangeSelection, SingleDateSelection } from "../calendar";
 import "./DatePickerActions.css";
+import type { DateFrameworkType } from "@salt-ds/date-adapters";
 /**
- * Base props for DatePicker actions.
+ * Base props for DatePicker actions component.
  */
 export interface DatePickerActionsBaseProps extends ComponentPropsWithoutRef<"div"> {
     /**
@@ -32,7 +33,7 @@ export interface DatePickerActionsBaseProps extends ComponentPropsWithoutRef<"di
  * Props for the DatePicker actions component.
  * @template SelectionVariant - The selection variant, either "single" or "range".
  */
-export declare type DatePickerActionsProps<SelectionVariant extends "single" | "range"> = SelectionVariant extends "single" ? DatePickerActionsBaseProps & {
+export declare type DatePickerActionsProps<TDate extends DateFrameworkType, SelectionVariant extends "single" | "range"> = SelectionVariant extends "single" ? DatePickerActionsBaseProps & {
     /**
      * The selection variant, set to "single".
      */
@@ -42,7 +43,7 @@ export declare type DatePickerActionsProps<SelectionVariant extends "single" | "
      * @param _event - The synthetic event.
      * @param date - The selected single date or null.
      */
-    onApply?: (_event: SyntheticEvent, date: SingleDateSelection | null) => void;
+    onApply?: (_event: SyntheticEvent, date: SingleDateSelection<TDate> | null) => void;
 } : DatePickerActionsBaseProps & {
     /**
      * The selection variant, set to "range".
@@ -53,28 +54,28 @@ export declare type DatePickerActionsProps<SelectionVariant extends "single" | "
      * @param _event - The synthetic event.
      * @param date - The selected date range or null.
      */
-    onApply?: (_event: SyntheticEvent, date: DateRangeSelection | null) => void;
+    onApply?: (_event: SyntheticEvent, date: DateRangeSelection<TDate> | null) => void;
 };
-export declare const DatePickerActions: React.ForwardRefExoticComponent<((DatePickerActionsBaseProps & {
+export declare const DatePickerActions: import("react").ForwardRefExoticComponent<((DatePickerActionsBaseProps & {
     /**
-     * The selection variant, set to "single".
+     * The selection variant, set to "range".
      */
-    selectionVariant: "single";
+    selectionVariant: "range";
     /**
      * Callback fired when the apply action is triggered.
      * @param _event - The synthetic event.
-     * @param date - The selected single date or null.
+     * @param date - The selected date range or null.
      */
-    onApply?: ((_event: SyntheticEvent, date: SingleDateSelection | null) => void) | undefined;
+    onApply?: ((_event: SyntheticEvent, date: DateRangeSelection<Date | import("dayjs").Dayjs | import("luxon").DateTime<boolean> | import("moment").Moment> | null) => void) | undefined;
 }) | (DatePickerActionsBaseProps & {
     /**
-     * The selection variant, set to "range".
+     * The selection variant, set to "single".
      */
-    selectionVariant: "range";
+    selectionVariant: "single";
     /**
      * Callback fired when the apply action is triggered.
      * @param _event - The synthetic event.
-     * @param date - The selected date range or null.
+     * @param date - The selected single date or null.
      */
-    onApply?: ((_event: SyntheticEvent, date: DateRangeSelection | null) => void) | undefined;
-})) & React.RefAttributes<HTMLDivElement>>;
+    onApply?: ((_event: SyntheticEvent, date: Date | import("dayjs").Dayjs | import("luxon").DateTime<boolean> | import("moment").Moment | null) => void) | undefined;
+})) & import("react").RefAttributes<HTMLDivElement>>;

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>>;