@progress/kendo-react-dateinputs 12.0.2-develop.1 → 12.0.2-develop.2

package/index.d.ts

@@ -182,7 +182,9 @@ export declare interface CalendarHandle extends Pick<CalendarWithoutContext, key
  * The props which will be received by the custom header of the Calendar and the MultiViewCalendar.
  */
 export declare interface CalendarHeaderProps {
+    /** Properties passed to the header title component */
     headerTitleProps: CalendarHeaderTitleProps;
+    /** Navigation commands and buttons for the calendar header */
     commands: React.ReactNode;
 }
 
@@ -198,13 +200,21 @@ export declare const CalendarHeaderTitle: (props: CalendarHeaderTitleProps) => J
  * The props which will be received by the custom header title of the [Calendar]({% slug api_dateinputs_calendarprops %}#toc-headertitle) and the [MultiViewCalendar]({% slug api_dateinputs_multiviewcalendarprops %}#toc-headertitle).
  */
 export declare interface CalendarHeaderTitleProps {
+    /** CSS class name for styling the header title */
     className?: string;
+    /** Child elements to render inside the header title */
     children?: React_2.ReactNode;
+    /** Text value displayed in the header title */
     value?: string;
+    /** Unique identifier for the header title element */
     id?: string;
+    /** Current calendar view type */
     view?: CalendarViewEnum;
+    /** Inline styles applied to the header title */
     style?: React_2.CSSProperties;
+    /** Click event handler for the header title */
     onClick?: (event?: React_2.SyntheticEvent<any>) => void;
+    /** Whether the header title is disabled */
     disabled?: boolean;
 }
 
@@ -219,14 +229,23 @@ export declare const CalendarNavigationItem: (props: CalendarNavigationItemProps
  * The props which will be received by the custom navigation item of the [Calendar]({% slug api_dateinputs_calendarprops %}#toc-navigationitem).
  */
 export declare interface CalendarNavigationItemProps {
+    /** The text content displayed in the navigation item */
     text?: string;
+    /** The date value associated with this navigation item */
     value: Date;
+    /** Unique identifier for the navigation item element */
     id?: string;
+    /** CSS styles to apply to the navigation item */
     style?: React_2.CSSProperties;
+    /** The current view of the calendar (month, year, decade, century) */
     view?: CalendarViewEnum;
+    /** Callback function triggered when the navigation item is clicked */
     onClick?: (value: Date, event?: React_2.SyntheticEvent<any>) => void;
+    /** Child elements to render within the navigation item */
     children?: React_2.ReactNode;
+    /** CSS class name to apply to the navigation item */
     className?: string;
+    /** Indicates whether this item represents the start of a range selection */
     isRangeStart?: boolean;
 }
 
@@ -427,7 +446,6 @@ export declare interface CalendarSettings {
      * Specifies the possible format options for the displayed Calendar week days' names.
      *
      * @default short
-     *
      ** @example
      * ```jsx
      * <Calendar weekDaysFormat="short" />
@@ -535,13 +553,21 @@ export declare const CalendarWeekCell: (props: CalendarWeekCellProps) => JSX.Ele
  * The props which will be received by the custom week cell of the [Calendar]({% slug api_dateinputs_calendarprops %}#toc-weekcell) and the [MultiViewCalendar]({% slug api_dateinputs_multiviewcalendarprops %}#toc-weekcell).
  */
 export declare interface CalendarWeekCellProps {
+    /** Unique identifier for the week cell element */
     id?: string;
+    /** Week number value, null if not available */
     value?: number | null;
+    /** Inline styles applied to the week cell */
     style?: React_2.CSSProperties;
+    /** Child elements to render inside the week cell */
     children?: React_2.ReactNode;
+    /** CSS class name for styling the week cell */
     className?: string;
+    /** First date of the week represented by this cell */
     firstDate: Date;
+    /** Array of dates representing all days in the week */
     weekDays?: Date[];
+    /** Click event handler for the week cell */
     onClick?: (firstDate: Date, value: Date[], event: React_2.MouseEvent<HTMLTableCellElement>) => void;
     /**
      * @hidden
@@ -758,9 +784,13 @@ export declare type DateInput = DateInputHandle;
  * The arguments for the `change` event of the DateInput. The generic argument sets the target type of the event. Defaults to `DateInput`.
  */
 export declare interface DateInputChangeEvent<T = DateInputHandle> {
+    /** The native DOM event. */
     nativeEvent?: any;
+    /** The React synthetic event. */
     syntheticEvent: React_2.SyntheticEvent<any>;
+    /** The new `value`. */
     value: Date | null;
+    /** The component instance that fired the event. */
     target: T;
 }
 
@@ -873,31 +903,31 @@ export declare interface DateInputHandle {
      */
     updateOnPaste: (event: React_2.SyntheticEvent<HTMLInputElement>) => void;
     /**
-     * Represents the props of the DateInput component.
+     * Get the props object of the component.
      */
     props: Readonly<DateInputProps>;
     /**
-     * Represents the text of the DateInput component.
+     * Get the formatted text value.
      */
     text: string;
     /**
-     * Represents the options of the DateInput component.
+     * Get the resolved configuration `options`.
      */
     options: DateInputOptions;
     /**
-     * Returns the HTML element of the DateInput component.
+     * Get the root input DOM element.
      */
     element: HTMLInputElement | null;
     /**
-     * Gets the `name` property of the DateInput.
+     * Get the `name` property.
      */
     name: string | undefined;
     /**
-     * Returns the `value` of the DateInput component.
+     * Get the current `value`.
      */
     value: Date | null;
     /**
-     * Represents the validity state into which the DateInput is set.
+     * Get the current validity state.
      */
     validity: FormComponentValidity;
 }
@@ -906,11 +936,17 @@ export declare interface DateInputHandle {
  * The interface which defines all possible incremental steps in the DateInput.
  */
 export declare interface DateInputIncrementalSteps {
+    /** Controls the incremental step of the year value */
     year?: number;
+    /** Controls the incremental step of the month value */
     month?: number;
+    /** Controls the incremental step of the day value */
     day?: number;
+    /** Controls the incremental step of the hour value */
     hour?: number;
+    /** Controls the incremental step of the minute value */
     minute?: number;
+    /** Controls the incremental step of the second value */
     second?: number;
 }
 
@@ -992,6 +1028,11 @@ declare interface DateInputOptions {
      * @default `false`
      */
     autoFill: boolean;
+    /**
+     * Enables mouse wheel scrolling to increase or decrease date segment values.
+     *
+     * @default `true`
+     */
     enableMouseWheel: boolean;
     /**
      * Indicates whether the mouse scroll can be used to increase/decrease the date segments values.
@@ -1041,41 +1082,43 @@ export declare interface DateInputProps<T extends DateInputHandle = any> extends
      */
     disableSelection?: boolean;
     /**
-     * Sets a class of the DateInput DOM element.
+     * Set a custom CSS class on the DateInput DOM element.
      */
     className?: string;
     /**
-     * Specifies the value of the DateInput.
+     * Set the `value` of the DateInput.
      */
     value?: Date | null;
     /**
-     * Specifies the default value of the DateInput. If `value` is not set, this value will correspond to the initial value.
+     * Set the initial `value` when the component is uncontrolled.
+     * If `value` is not set, the component uses this as its starting value.
      */
     defaultValue?: Date | null;
     /**
-     * Indicates the availability of interactive popup element that can be triggered by an element. By default the property is set to `grid`.
+     * Define the interactive popup type for assistive tech.
+     * Use `grid` (default) or `dialog` based on context.
      *
      * @default `grid`
      */
     ariaHasPopup?: boolean | 'grid' | 'dialog';
     /**
-     * Indicates whether the element is currently expanded or collapsed.
+     * Indicate whether the popup content is expanded.
      */
     ariaExpanded?: boolean;
     /**
-     * Specifies the role of the DateInput.
+     * Set the ARIA role of the DateInput root element.
      */
     ariaRole?: string;
     /**
-     * Identifies the element whose contents or presence are controlled by the current element.
+     * Reference the id of the element that the DateInput controls via ARIA.
      */
     ariaControls?: string;
     /**
-     * Determines the event handler that will be fired when the user edits the value ([see example]({% slug dateranges_dateinput %})).
+     * Fires when the user edits the `value` ([see example]({% slug dateranges_dateinput %})).
      */
     onChange?: (event: DateInputChangeEvent<T>) => void;
     /**
-     * Configures the `size` of the DateInput.
+     * Control the `size` of the DateInput.
      *
      * The available options are:
      * - small
@@ -1087,7 +1130,7 @@ export declare interface DateInputProps<T extends DateInputHandle = any> extends
      */
     size?: null | 'small' | 'medium' | 'large';
     /**
-     * Configures the `roundness` of the DateInput.
+     * Control the corner `rounded` style of the DateInput.
      *
      * The available options are:
      * - small
@@ -1100,7 +1143,7 @@ export declare interface DateInputProps<T extends DateInputHandle = any> extends
      */
     rounded?: null | 'small' | 'medium' | 'large' | 'full';
     /**
-     * Configures the `fillMode` of the DateInput.
+     * Control the `fillMode` (background) of the DateInput.
      *
      * The available options are:
      * - solid
@@ -1112,21 +1155,21 @@ export declare interface DateInputProps<T extends DateInputHandle = any> extends
      */
     fillMode?: null | 'solid' | 'flat' | 'outline';
     /**
-     * Determines whether the DateInput is in its read-only state.
+     * Put the component in read-only mode.
      */
     readonly?: boolean;
     /**
-     * If `clearButton` is set to `true`, the DateInput renders a button next to the date value. Clicking this button resets the value of the date and triggers the `change` event.
+     * Show a clear button that sets `value` to `null` and fires `onChange`.
      */
     clearButton?: boolean;
     /**
-     * Represents the `autoFocus` HTML attribute that will be applied to the input element of the DateInput. (Defaults to `false`)
+     * Apply the `autoFocus` attribute to the internal input.
      *
      * @default `false`
      */
     autoFocus?: boolean;
     /**
-     * When enabled, the DateInput will autofill the rest of the date to the current date when the component loses focus.
+     * Autofill missing parts with the current date on blur.
      *
      * @default `false`
      */
@@ -1149,8 +1192,8 @@ export declare interface DateInputProps<T extends DateInputHandle = any> extends
      */
     unstyled?: DateInputsClassStructure;
     /**
-     * Sets the HTML attributes of the inner focusable input element.
-     * Attributes which are essential for certain component functionalities cannot be changed.
+     * Pass HTML attributes to the internal focusable input.
+     * Attributes required for core logic are ignored.
      */
     inputAttributes?: React_2.InputHTMLAttributes<HTMLInputElement>;
 }
@@ -1319,10 +1362,15 @@ export declare type DatePicker = DatePickerHandle;
  * The arguments for the `onChange` event of the DatePicker.
  */
 export declare interface DatePickerChangeEvent {
+    /** The native DOM event. */
     nativeEvent?: any;
+    /** The React synthetic event. */
     syntheticEvent: React_2.SyntheticEvent<any>;
+    /** The new `value`. */
     value: Date | null;
+    /** The current popup state. */
     show: boolean;
+    /** The component instance that fired the event. */
     target: DatePickerHandle;
 }
 
@@ -1330,6 +1378,7 @@ export declare interface DatePickerChangeEvent {
  * The arguments for the `onClose` event of the DatePicker.
  */
 export declare interface DatePickerCloseEvent {
+    /** The component instance that fired the event. */
     target: DatePickerHandle;
 }
 
@@ -1343,7 +1392,6 @@ export declare const datePickerDefaultProps: {
     calendar: React_2.ComponentType<CalendarProps<any>>;
     toggleButton: React_2.ComponentType<ToggleButtonProps>;
     popup: React_2.ComponentType<PopupProps>;
-    pickerWrap: React_2.ComponentType<PickerWrapProps>;
     disabled: boolean;
     format: string;
     max: Date;
@@ -1412,6 +1460,7 @@ export declare interface DatePickerHandle {
  * The arguments for the `onOpen` event of the DatePicker.
  */
 export declare interface DatePickerOpenEvent {
+    /** The component instance that fired the event. */
     target: DatePickerHandle;
 }
 
@@ -1420,29 +1469,28 @@ export declare interface DatePickerOpenEvent {
  */
 export declare interface DatePickerProps extends DatePickerSettings, FormComponentProps, DateInputCommonPackageProps, Omit<React_2.HTMLAttributes<HTMLElement>, 'defaultValue' | 'onChange' | 'onBlur' | 'onFocus' | 'placeholder'> {
     /**
-     * Sets the default value of the DatePicker ([see example]({% slug default_value_datepicker %})).
+     * Set the initial `value` when the component is uncontrolled ([see example]({% slug default_value_datepicker %})).
      */
     defaultValue?: Date | null;
     /**
-     * Fires each time the user selects a new value ([see example]({% slug controlled_datepicker %}#toc-controlling-the-date-value)).
+     * Fires when the user selects a new `value` ([see example]({% slug controlled_datepicker %}#toc-controlling-the-date-value)).
      */
     onChange?: (event: DatePickerChangeEvent) => void;
     /**
-     * Fires each time the popup is opened.
+     * Fires when the popup opens.
      */
     onOpen?: (event: DatePickerOpenEvent) => void;
     /**
-     * Fires each time the popup is closed.
+     * Fires when the popup closes.
      */
     onClose?: (event: DatePickerCloseEvent) => void;
     /**
-     * Specifies the value of the DatePicker ([see example]({% slug controlled_datepicker %}#toc-controlling-the-date-value)).
-     *
-     * > The `value` has to be a valid [JavaScript `Date`](https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Date) instance.
+     * Set the current `value` ([see example]({% slug controlled_datepicker %}#toc-controlling-the-date-value)).
+     * Provide a valid [JavaScript `Date`](https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Date) instance or `null`.
      */
     value?: Date | null;
     /**
-     * Configures the `size` of the DatePicker.
+     * Control the `size` of the DatePicker.
      *
      * The available options are:
      * - small
@@ -1454,7 +1502,7 @@ export declare interface DatePickerProps extends DatePickerSettings, FormCompone
      */
     size?: null | 'small' | 'medium' | 'large';
     /**
-     * Configures the `roundness` of the DatePicker.
+     * Control the corner `rounded` style of the DatePicker.
      *
      * The available options are:
      * - small
@@ -1467,7 +1515,7 @@ export declare interface DatePickerProps extends DatePickerSettings, FormCompone
      */
     rounded?: null | 'small' | 'medium' | 'large' | 'full';
     /**
-     * Configures the `fillMode` of the DatePicker.
+     * Control the `fillMode` (background) of the DatePicker.
      *
      * The available options are:
      * - solid
@@ -1479,24 +1527,24 @@ export declare interface DatePickerProps extends DatePickerSettings, FormCompone
      */
     fillMode?: null | 'solid' | 'flat' | 'outline';
     /**
-     * Providing different rendering of the popup element based on the screen dimensions.
+     * Enable adaptive rendering of the popup based on viewport width.
      *
      * @default `false`
      */
     adaptive?: boolean;
     /**
-     * Specifies the text that is rendered as title in the adaptive popup(action sheet).
-     * Applicable only when `adaptive` is set to `true`.
-     * If not provided, the title will be the same as the label.
+     * Set the title text in the adaptive popup (action sheet). Use only when `adaptive` is `true`.
+     * If not set, the title matches the `label`.
      */
     adaptiveTitle?: string;
     /**
-     * Specifies the text that is rendered as subtitle in the adaptive popup(action sheet).
-     * Applicable only when `adaptive` is set to `true`.
+     * Set the subtitle text in the adaptive popup (action sheet). Use only when `adaptive` is `true`.
      */
     adaptiveSubtitle?: string;
     /**
-     * Represents the `autoFocus` HTML attribute that will be applied to the input element of the DatePicker. (Defaults to `false`)
+     * Apply the `autoFocus` attribute to the internal input element.
+     *
+     * @default `false`
      */
     autoFocus?: boolean;
     /**
@@ -1512,27 +1560,29 @@ export declare interface DatePickerProps extends DatePickerSettings, FormCompone
      */
     modified?: boolean;
     /**
-     * When enabled, the DatePicker will autofill the rest of the date to the current date when the component loses focus.
+     * Autofill missing date parts with the current date on blur.
      *
      * @default `false`
      */
     autoFill?: boolean;
     /**
-     * The maximum year to assume to be from the current century when typing two-digit year value ([see example]({% slug formats_dateinput %}#toc-two---digit-year-max)).
-     * The default value of 68, indicating that typing any value less than 69 will be assumed to be 20xx, while 69 and larger will be assumed to be 19xx.
+     /**
+     * Set the upper threshold for interpreting a two-digit year as part of the current century ([see example]({% slug formats_dateinput %}#toc-two---digit-year-max)).
+     * Values smaller than (`twoDigitYearMax` + 1) map to 20xx. Larger map to 19xx.
      *
      * @default `68`
      */
     twoDigitYearMax?: number;
     /**
-     * Indicates whether the mouse scroll can be used to increase/decrease the date segments values.
+     /**
+     * Enable mouse wheel to increment or decrement segments.
      *
      * @default `true`
      */
     enableMouseWheel?: boolean;
     /**
-     * Sets the HTML attributes of the inner focusable input element.
-     * Attributes which are essential for certain component functionalities cannot be changed.
+     * Pass HTML attributes to the internal focusable input element.
+     * Attributes required for core logic are ignored.
      */
     inputAttributes?: React_2.InputHTMLAttributes<HTMLInputElement>;
     /**
@@ -1555,11 +1605,7 @@ export declare const DatePickerPropsContext: React_2.Context<(p: DatePickerProps
  */
 export declare interface DatePickerSettings {
     /**
-     * @deprecated The `DatePicker` no longer renders a `wrapper` around the DatePicker.
-     */
-    pickerWrap?: default_3.ComponentType<PickerWrapProps>;
-    /**
-     * Enables the customization or the override of the default Toggle button which is rendered by the DatePicker
+     * Allows you to customize or replace the default Toggle button rendered by DatePicker.
      * ([see example]({% slug custom_rendering_datepicker %}#toc-customizing-the-toggle-button)).
      * Example usage of the `toggleButton` property:
      * ```jsx
@@ -1568,7 +1614,7 @@ export declare interface DatePickerSettings {
      */
     toggleButton?: default_3.ComponentType<ToggleButtonProps>;
     /**
-     * Enables the customization or the override of the default Calendar which is rendered by the DatePicker
+     * Allows you to customize or replace the default Calendar rendered by DatePicker.
      * ([see example]({% slug custom_rendering_datepicker %}#toc-customizing-the-calendar)).
      * Example usage of the `calendar` property:
      * ```jsx
@@ -1577,7 +1623,7 @@ export declare interface DatePickerSettings {
      */
     calendar?: default_3.ComponentType<CalendarProps<any>> | default_3.ComponentType<MultiViewCalendarProps<any>>;
     /**
-     * Enables the customization or the override of the default Popup which is rendered by the DatePicker
+     * Allows you to customize or replace the default Popup rendered by DatePicker.
      * ([see example]({% slug custom_rendering_datepicker %}#toc-customizing-the-popup)).
      * Example usage of the `popup` property:
      * ```jsx
@@ -1586,7 +1632,7 @@ export declare interface DatePickerSettings {
      */
     popup?: default_3.ComponentType<PopupProps>;
     /**
-     * Enables the customization or the override of the default DateInput which is rendered by the DatePicker
+     * Allows you to customize or replace the default DateInput rendered by DatePicker.
      * ([see example]({% slug custom_rendering_datepicker %}#toc-customizing-the-dateinput)).
      * Example usage of the `dateInput` property:
      * ```jsx
@@ -1809,10 +1855,15 @@ export declare interface DateRangePickerCalendarSettings extends Omit<MultiViewC
  * The arguments for the `onChange` event of the DateRangePicker.
  */
 export declare interface DateRangePickerChangeEvent {
+    /** The React synthetic event. */
     syntheticEvent: React_2.SyntheticEvent<any>;
+    /** The native DOM event. */
     nativeEvent?: any;
+    /** The new selection `value`. */
     value: SelectionRange;
+    /** The current popup state. */
     show?: boolean;
+    /** The component instance that fired the event. */
     target: DateRangePicker;
 }
 
@@ -1820,6 +1871,7 @@ export declare interface DateRangePickerChangeEvent {
  * The arguments for the `onClose` event of the DateRangePicker.
  */
 export declare interface DateRangePickerCloseEvent {
+    /** The component instance that fired the event. */
     target: DateRangePicker;
 }
 
@@ -1845,6 +1897,18 @@ export declare interface DateRangePickerHandle extends Pick<DateRangePickerWitho
      * Gets the end DateInput component inside the DateRangePicker component.
      */
     endDateInput: DateInputHandle | null;
+    /**
+     * Returns a boolean value indicating whether the DateRangePicker is in mobile mode.
+     */
+    mobileMode: boolean;
+    /**
+     * The props of the DateRangePickerHandle component.
+     */
+    props: Readonly<DateRangePickerProps>;
+    /**
+     * Whether the popup of the DateRangePicker is currently open.
+     */
+    show: boolean;
     /**
      * Gets the start DateInput component inside the DateRangePicker component.
      */
@@ -1859,6 +1923,7 @@ export declare interface DateRangePickerHandle extends Pick<DateRangePickerWitho
  * The arguments for the `onOpen` event of the DateRangePicker.
  */
 export declare interface DateRangePickerOpenEvent {
+    /** The component instance that fired the event. */
     target: DateRangePicker;
 }
 
@@ -1873,61 +1938,66 @@ export declare interface DateRangePickerPopupSettings extends PopupProps {
  */
 export declare interface DateRangePickerProps extends DateRangePickerSettings {
     /**
-     * Overrides the validity state of the component.
-     * If `valid` is set, the `required` property will be ignored.
-     *
-     * This property is part of the [FormComponentProps]({% slug api_common_formcomponentprops %}) interface.
+     * Override the validity state.
+     * If `valid` is set, ignore `required`.
+     * Part of [FormComponentProps]({% slug api_common_formcomponentprops %}).
      */
     valid?: boolean;
     /**
-     * Sets the default value of the DateRangePicker ([see example]({% slug default_value_daterangepicker %})).
+     * Set the initial `value` when uncontrolled ([see example]({% slug default_value_daterangepicker %})).
      */
     defaultValue?: SelectionRange;
     /**
-     * Fires each time the user selects a part of a date range ([see example]({% slug controlled_daterangepicker %}#toc-controlling-the-value)).
+     * Fires when the user changes part of the range ([see example]({% slug controlled_daterangepicker %}#toc-controlling-the-value)).
      */
     onChange?: (event: DateRangePickerChangeEvent) => void;
     /**
-     * Fires each time the popup is opened.
+     * Fires when the popup opens.
      */
     onOpen?: (event: DateRangePickerOpenEvent) => void;
     /**
-     * Fires each time the popup is closed.
+     * Fires when the popup closes.
      */
     onClose?: (event: DateRangePickerCloseEvent) => void;
     /**
-     * Fires each time the popup of the DateRangePicker is about to cancel in ([adaptive mode]({% slug adaptive_rendering_daterangepicker %})).
+     * Fires when the popup is about to cancel in ([adaptive mode]({% slug adaptive_rendering_daterangepicker %})).
      */
     onCancel?: (event: React_2.MouseEvent<HTMLButtonElement>) => void;
     /**
-     * Specifies the selected date range of the DateRangePicker ([see example]({% slug controlled_daterangepicker %}#toc-controlling-the-value)).
-     *
-     * > The `value` has to be an object with `start` and `end` valid JavaScript [`Date`](https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Date) instances or `null`.
+     * Set the selected range ([see example]({% slug controlled_daterangepicker %}#toc-controlling-the-value)).
+     * Provide `start` and `end` valid `Date` values or `null`.
      */
     value?: SelectionRange;
     /**
-     * Providing different rendering of the popup element based on the screen dimensions.
+     /**
+     * Enable adaptive popup rendering based on viewport width.
      *
      * @default `false`
      */
     adaptive?: boolean;
     /**
-     * Specifies the text that is rendered as title in the adaptive popup(action sheet).
-     * Applicable only when `adaptive` is set to `true`.
-     * If not provided, the title will be the same as the label.
+     /**
+     * Set the title text in the adaptive popup (action sheet).
+     * Use only when `adaptive` is `true`.
+     * If not set, it matches the `label`.
      */
     adaptiveTitle?: string;
     /**
-     * Specifies the text that is rendered as subtitle in the adaptive popup(action sheet).
-     * Applicable only when `adaptive` is set to `true`.
+     /**
+     * Set the subtitle text in the adaptive popup (action sheet).
+     * Use only when `adaptive` is `true`.
      */
     adaptiveSubtitle?: string;
     /**
-     * If `clearButton` is set to `true`, the DateRangePicker renders a button next to the start and end date values. Clicking this button resets the value of the date and triggers the `change` event.
+     /**
+     * Show a clear button for start and end inputs. Clicking resets the range and fires `onChange`.
      */
     clearButton?: boolean;
     /**
-     * Represents the `autoFocus` HTML attribute that will be applied to the input element of the DateRangePicker. (Defaults to `false`)
+     /**
+     * Apply the `autoFocus` attribute to the first input.
+     *
+     * @default `false`
      */
     autoFocus?: boolean;
     /**
@@ -1935,8 +2005,8 @@ export declare interface DateRangePickerProps extends DateRangePickerSettings {
      */
     dir?: string;
     /**
-     * Sets the HTML attributes of the inner focusable input element.
-     * Attributes which are essential for certain component functionalities cannot be changed.
+     * Pass HTML attributes to the internal focusable input elements.
+     * Attributes required for core logic are ignored.
      */
     inputAttributes?: React_2.InputHTMLAttributes<HTMLInputElement>;
     /**
@@ -2187,6 +2257,9 @@ export declare class DateRangePickerWithoutContext extends React_2.Component<Dat
     /**
      * Gets the popup state of the DateRangePicker.
      */
+    /**
+     * Whether the popup of the DateRangePicker is currently open.
+     */
     get show(): boolean;
     protected get min(): Date;
     protected get max(): Date;
@@ -2256,10 +2329,15 @@ export declare const DateTimePicker: React_2.ForwardRefExoticComponent<DateTimeP
  * The arguments for the `onChange` event of the DateTimePicker.
  */
 export declare interface DateTimePickerChangeEvent {
+    /** The native DOM event. */
     nativeEvent: any;
+    /** The React synthetic event. */
     syntheticEvent: React_2.SyntheticEvent<any>;
+    /** The new `value`. */
     value: Date | null;
+    /** The current popup state. */
     show: boolean;
+    /** The component instance that fired the event. */
     target: DateTimePicker;
 }
 
@@ -2267,6 +2345,7 @@ export declare interface DateTimePickerChangeEvent {
  * The arguments for the `onClose` event of the DateTimePicker.
  */
 export declare interface DateTimePickerCloseEvent {
+    /** The component instance that fired the event. */
     target: DateTimePicker;
 }
 
@@ -2282,10 +2361,18 @@ export declare interface DateTimePickerHandle extends Pick<DateTimePickerWithout
      * Returns the HTML element of the DateTimePicker component.
      */
     element: HTMLSpanElement | null;
+    /**
+     * Returns a boolean value indicating whether the DateTimePicker is in mobile mode.
+     */
+    mobileMode: boolean;
     /**
      * Gets the `name` property of the DateTimePicker.
      */
     name: string | undefined;
+    /**
+     * The props of the DateTimePickerHandle component.
+     */
+    props: Readonly<DateTimePickerProps>;
     /**
      * Gets the popup state of the DateTimePicker.
      */
@@ -2304,6 +2391,7 @@ export declare interface DateTimePickerHandle extends Pick<DateTimePickerWithout
  * The arguments for the `onOpen` event of the DateTimePicker.
  */
 export declare interface DateTimePickerOpenEvent {
+    /** The component instance that fired the event. */
     target: DateTimePicker;
 }
 
@@ -2312,35 +2400,34 @@ export declare interface DateTimePickerOpenEvent {
  */
 export declare interface DateTimePickerProps extends DateTimePickerSettings, FormComponentProps, DateInputCommonPackageProps {
     /**
-     * Sets the default value of the DateTimePicker
-     * ([see example]({% slug default_value_datetimepicker %})).
-     *  For more information, refer to the article on
-     * [uncontrolled components in React](https://react.dev/learn/sharing-state-between-components#controlled-and-uncontrolled-components).
+     * Set the initial `value` when uncontrolled ([see example]({% slug default_value_datetimepicker %})).
+     * See also [uncontrolled components](https://react.dev/learn/sharing-state-between-components#controlled-and-uncontrolled-components).
      */
     defaultValue?: Date | null;
     /**
-     * Fires each time the user selects a new value
-     * ([see example]({% slug controlled_datetimepicker %}#toc-controlling-the-date-value)).
+     /**
+     * Fires when the user selects a new `value` ([see example]({% slug controlled_datetimepicker %}#toc-controlling-the-date-value)).
      */
     onChange?: (event: DateTimePickerChangeEvent) => void;
     /**
-     * Fires each time the popup is opened.
+     /**
+     * Fires when the popup opens.
      */
     onOpen?: (event: DateTimePickerOpenEvent) => void;
     /**
-     * Fires each time the popup is closed.
+     /**
+     * Fires when the popup closes.
      */
     onClose?: (event: DateTimePickerCloseEvent) => void;
     /**
-     * Specifies the value of the DateTimePicker
-     * ([see example]({% slug controlled_datetimepicker %}#toc-controlling-the-date-value)).
-     *
-     * > The `value` has to be a valid
-     * [JavaScript `Date`](https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Date) instance.
+     /**
+     * Set the current `value` ([see example]({% slug controlled_datetimepicker %}#toc-controlling-the-date-value)).
+     * Provide a valid `Date` or `null`.
      */
     value?: Date | null;
     /**
-     * Configures the `size` of the DateTimePicker.
+     /**
+     * Control the `size` of the DateTimePicker.
      *
      * The available options are:
      * - small
@@ -2352,7 +2439,7 @@ export declare interface DateTimePickerProps extends DateTimePickerSettings, For
      */
     size?: null | 'small' | 'medium' | 'large';
     /**
-     * Configures the `roundness` of the DateTimePicker.
+     * Control the corner `rounded` style of the DateTimePicker.
      *
      * The available options are:
      * - small
@@ -2365,7 +2452,7 @@ export declare interface DateTimePickerProps extends DateTimePickerSettings, For
      */
     rounded?: null | 'small' | 'medium' | 'large' | 'full';
     /**
-     * Configures the `fillMode` of the DateTimePicker.
+     * Control the `fillMode` (background) of the DateTimePicker.
      *
      * The available options are:
      * - solid
@@ -2377,24 +2464,24 @@ export declare interface DateTimePickerProps extends DateTimePickerSettings, For
      */
     fillMode?: null | 'solid' | 'flat' | 'outline';
     /**
-     * Providing different rendering of the popup element based on the screen dimensions.
+     * Enable adaptive popup rendering based on viewport width.
      *
      * @default `false`
      */
     adaptive?: boolean;
     /**
-     * Specifies the text that is rendered as title in the adaptive popup(action sheet).
-     * Applicable only when `adaptive` is set to `true`.
-     * If not provided, the title will be the same as the label.
+     * Set the title text in the adaptive popup (action sheet). Use only when `adaptive` is `true`.
+     * If not set, it matches the `label`.
      */
     adaptiveTitle?: string;
     /**
-     * Specifies the text that is rendered as subtitle in the adaptive popup(action sheet).
-     * Applicable only when `adaptive` is set to `true`.
+     * Set the subtitle text in the adaptive popup (action sheet). Use only when `adaptive` is `true`.
      */
     adaptiveSubtitle?: string;
     /**
-     * Represents the `autoFocus` HTML attribute that will be applied to the input element of the DateTimePicker. (Defaults to `false`)
+     * Apply the `autoFocus` attribute to the internal input.
+     *
+     * @default `false`
      */
     autoFocus?: boolean;
     /**
@@ -2402,27 +2489,27 @@ export declare interface DateTimePickerProps extends DateTimePickerSettings, For
      */
     unstyled?: DateInputsClassStructure;
     /**
-     * When enabled, the DateTimePicker will autofill the rest of the date/time to the current date/time when the component loses focus.
+     * Autofill missing date or time parts with the current date/time on blur.
      *
      * @default `false`
      */
     autoFill?: boolean;
     /**
-     * The maximum year to assume to be from the current century when typing two-digit year value ([see example]({% slug formats_dateinput %}#toc-two---digit-year-max)).
-     * The default value of 68, indicating that typing any value less than 69 will be assumed to be 20xx, while 69 and larger will be assumed to be 19xx.
+     * Set the upper threshold for interpreting a two-digit year as part of the current century ([see example]({% slug formats_dateinput %}#toc-two---digit-year-max)).
+     * Values smaller than (`twoDigitYearMax` + 1) map to 20xx. Larger map to 19xx.
      *
      * @default `68`
      */
     twoDigitYearMax?: number;
     /**
-     * Indicates whether the mouse scroll can be used to increase/decrease the datetime segments values.
+     * Enable mouse wheel to increment or decrement segments.
      *
      * @default `true`
      */
     enableMouseWheel?: boolean;
     /**
-     * Sets the HTML attributes of the inner focusable input element.
-     * Attributes which are essential for certain component functionalities cannot be changed.
+     * Pass HTML attributes to the internal focusable input.
+     * Attributes required for core logic are ignored.
      */
     inputAttributes?: React_2.InputHTMLAttributes<HTMLInputElement>;
     /**
@@ -2524,7 +2611,13 @@ export declare interface DateTimePickerSettings {
      * ([see example]({% slug dateranges_datetimepicker %})).
      */
     min?: Date;
+    /**
+     * Specifies the smallest valid time within the day ([see example]({% slug dateranges_datetimepicker %})).
+     */
     minTime?: Date;
+    /**
+     * Specifies the greatest valid time within the day ([see example]({% slug dateranges_datetimepicker %})).
+     */
     maxTime?: Date;
     /**
      * Specifies the `name` property of the `input` DOM element.
@@ -2712,7 +2805,7 @@ export declare class DateTimePickerWithoutContext extends React_2.Component<Date
      */
     get name(): string | undefined;
     /**
-     * The mobile mode of the DateTimePicker.
+     * Returns a boolean value indicating whether the DateTimePicker is in mobile mode.
      */
     get mobileMode(): boolean;
     protected get min(): Date;
@@ -3203,9 +3296,13 @@ export declare const MultiViewCalendar: React_2.ForwardRefExoticComponent<MultiV
  * The arguments for the `onChange` event of the MultiViewCalendar. * The generic argument sets the target type of the event. Defaults to `MultiViewCalendar`.
  */
 export declare interface MultiViewCalendarChangeEvent<T = MultiViewCalendar> {
+    /** The React synthetic event */
     syntheticEvent: React_2.SyntheticEvent<any>;
+    /** The native DOM event */
     nativeEvent?: any;
+    /** The new value of the MultiViewCalendar (can be a single Date, array of Dates, or SelectionRange) */
     value: Date | Date[] | SelectionRange | null;
+    /** The component instance that fired the event */
     target: T;
 }
 
@@ -3552,25 +3649,6 @@ declare class PageAction {
     constructor(skip: number);
 }
 
-/**
- * @hidden
- * @deprecated
- */
-export declare const PickerWrap: React_2.ForwardRefExoticComponent<PickerWrapProps & React_2.RefAttributes<HTMLSpanElement>>;
-
-/**
- * @hidden
- * @deprecated
- */
-export declare interface PickerWrapProps {
-    _ref?: React_2.Ref<HTMLSpanElement | null>;
-    id?: string;
-    tabIndex?: number;
-    className?: string;
-    children?: React_2.ReactNode;
-    style?: React_2.CSSProperties;
-}
-
 /**
  * @hidden
  */
@@ -3901,10 +3979,15 @@ export declare const TimePicker: React_2.ForwardRefExoticComponent<TimePickerPro
  * The arguments for the `onChange` event of the TimePicker.
  */
 export declare interface TimePickerChangeEvent {
+    /** The native DOM event. */
     nativeEvent?: any;
+    /** The React synthetic event. */
     syntheticEvent: React_2.SyntheticEvent<any>;
+    /** The new `value`. */
     value: Date | null;
+    /** The current popup state. */
     show: boolean;
+    /** The component instance that fired the event. */
     target: TimePicker;
 }
 
@@ -3912,6 +3995,7 @@ export declare interface TimePickerChangeEvent {
  * The arguments for the `onClose` event of the TimePicker.
  */
 export declare interface TimePickerCloseEvent {
+    /** The component instance that fired the event. */
     target: TimePicker;
 }
 
@@ -3927,10 +4011,18 @@ export declare interface TimePickerHandle extends Pick<TimePickerWithoutContext,
      * Returns the HTML element of the TimePicker component.
      */
     element: HTMLSpanElement | null;
+    /**
+     * Returns a boolean value indicating whether the TimePicker is in mobile mode.
+     */
+    mobileMode: boolean;
     /**
      * Gets the `name` property of the TimePicker.
      */
     name: string | undefined;
+    /**
+     * The props of the TimePickerHandle component.
+     */
+    props: Readonly<TimePickerProps>;
     /**
      * Gets the popup state of the TimeSelector.
      */
@@ -3953,8 +4045,11 @@ export declare interface TimePickerHandle extends Pick<TimePickerWithoutContext,
  * The interface which defines all possible incremental steps in the TimePicker.
  */
 declare interface TimePickerIncrementalSteps {
+    /** Controls the incremental step of the hour value */
     hour?: number;
+    /** Controls the incremental step of the minute value */
     minute?: number;
+    /** Controls the incremental step of the second value */
     second?: number;
 }
 
@@ -3962,6 +4057,7 @@ declare interface TimePickerIncrementalSteps {
  * The arguments for the `onOpen` event of the TimePicker.
  */
 export declare interface TimePickerOpenEvent {
+    /** The component instance that fired the event. */
     target: TimePicker;
 }
 
@@ -4347,7 +4443,7 @@ export declare class TimePickerWithoutContext extends React_2.Component<TimePick
      */
     get validity(): FormComponentValidity;
     /**
-     * The mobile mode of the ComboBox.
+     * Returns a boolean value indicating whether the TimePicker is in mobile mode.
      */
     get mobileMode(): boolean;
     /**
@@ -4528,12 +4624,18 @@ declare interface TimeSelectorState {
 export declare const today = "calendar.today";
 
 export declare class TodayCommand extends React_2.Component<TodayCommandProps> {
+    /**
+     * The prop types for the TodayCommand component.
+     */
     static propTypes: {
         max: default_2.Validator<Date>;
         min: default_2.Validator<Date>;
         onClick: default_2.Requireable<(...args: any[]) => any>;
         disabled: default_2.Requireable<boolean>;
     };
+    /**
+     * The default props for the TodayCommand component.
+     */
     static defaultProps: {
         min: Date;
         max: Date;