@mui/x-date-pickers 8.0.0-alpha.0 → 8.0.0-alpha.10

package/internals/hooks/usePicker/usePickerValue.types.d.ts

@@ -1,13 +1,14 @@
-import { FieldChangeHandlerContext, UseFieldInternalProps } from '../useField';
+import * as React from 'react';
+import { UseFieldInternalProps } from '../useField';
 import { Validator } from '../../../validation';
-import { WrapperVariant } from '../../models/common';
-import { FieldSection, FieldValueType, TimezoneProps, MuiPickersAdapter, PickersTimezone, PickerChangeHandlerContext, PickerValidDate, OnErrorProps, InferError } from '../../../models';
+import { TimezoneProps, MuiPickersAdapter, PickersTimezone, PickerChangeHandlerContext, PickerValidDate, OnErrorProps, InferError, PickerValueType, PickerChangeImportance } from '../../../models';
 import { GetDefaultReferenceDateProps } from '../../utils/getDefaultReferenceDate';
-import { PickerShortcutChangeImportance, PickersShortcutsItemContext } from '../../../PickersShortcuts';
-export interface PickerValueManager<TValue, TError> {
+import type { PickersShortcutsItemContext } from '../../../PickersShortcuts';
+import { InferNonNullablePickerValue, PickerValidValue } from '../../models';
+export interface PickerValueManager<TValue extends PickerValidValue, TError> {
     /**
      * Determines if two values are equal.
-     * @template TValue
+     * @template TValue The value type. It will be the same type as `value` or `null`. It can be in `[start, end]` format in case of range value.
      * @param {MuiPickersAdapter} utils The adapter.
      * @param {TValue} valueLeft The first value to compare.
      * @param {TValue} valueRight The second value to compare.
@@ -20,15 +21,15 @@ export interface PickerValueManager<TValue, TError> {
     emptyValue: TValue;
     /**
      * Method returning the value to set when clicking the "Today" button
-     * @template TValue
+     * @template TValue The value type. It will be the same type as `value` or `null`. It can be in `[start, end]` format in case of range value.
      * @param {MuiPickersAdapter} utils The adapter.
      * @param {PickersTimezone} timezone The current timezone.
-     * @param {FieldValueType} valueType The type of the value being edited.
+     * @param {PickerValueType} valueType The type of the value being edited.
      * @returns {TValue} The value to set when clicking the "Today" button.
      */
-    getTodayValue: (utils: MuiPickersAdapter, timezone: PickersTimezone, valueType: FieldValueType) => TValue;
+    getTodayValue: (utils: MuiPickersAdapter, timezone: PickersTimezone, valueType: PickerValueType) => TValue;
     /**
-     * @template TValue
+     * @template TValue The value type. It will be the same type as `value` or `null`. It can be in `[start, end]` format in case of range value.
      * Method returning the reference value to use when mounting the component.
      * @param {object} params The params of the method.
      * @param {PickerValidDate | undefined} params.referenceDate The referenceDate provided by the user.
@@ -48,10 +49,10 @@ export interface PickerValueManager<TValue, TError> {
         granularity: number;
         timezone: PickersTimezone;
         getTodayDate?: () => PickerValidDate;
-    }) => TValue;
+    }) => InferNonNullablePickerValue<TValue>;
     /**
      * Method parsing the input value to replace all invalid dates by `null`.
-     * @template TValue
+     * @template TValue The value type. It will be the same type as `value` or `null`. It can be in `[start, end]` format in case of range value.
      * @param {MuiPickersAdapter} utils The adapter.
      * @param {TValue} value The value to parse.
      * @returns {TValue} The value without invalid date.
@@ -59,7 +60,7 @@ export interface PickerValueManager<TValue, TError> {
     cleanValue: (utils: MuiPickersAdapter, value: TValue) => TValue;
     /**
      * Generates the new value, given the previous value and the new proposed value.
-     * @template TValue
+     * @template TValue The value type. It will be the same type as `value` or `null`. It can be in `[start, end]` format in case of range value.
      * @param {MuiPickersAdapter} utils The adapter.
      * @param {TValue} lastValidDateValue The last valid value.
      * @param {TValue} value The proposed value.
@@ -88,7 +89,7 @@ export interface PickerValueManager<TValue, TError> {
     /**
      * Return the timezone of the date inside a value.
      * Throw an error on range picker if both values don't have the same timezone.
-     @template TValue
+     * @template TValue The value type. It will be the same type as `value` or `null`. It can be in `[start, end]` format in case of range value.
      @param {MuiPickersAdapter} utils The utils to manipulate the date.
      @param {TValue} value The current value.
      @returns {string | null} The timezone of the current value.
@@ -96,7 +97,7 @@ export interface PickerValueManager<TValue, TError> {
     getTimezone: (utils: MuiPickersAdapter, value: TValue) => string | null;
     /**
      * Change the timezone of the dates inside a value.
-     @template TValue
+     * @template TValue The value type. It will be the same type as `value` or `null`. It can be in `[start, end]` format in case of range value.
      @param {MuiPickersAdapter} utils The utils to manipulate the date.
      @param {PickersTimezone} timezone The current timezone.
      @param {TValue} value The value to convert.
@@ -105,24 +106,24 @@ export interface PickerValueManager<TValue, TError> {
     setTimezone: (utils: MuiPickersAdapter, timezone: PickersTimezone, value: TValue) => TValue;
 }
 export type PickerSelectionState = 'partial' | 'shallow' | 'finish';
-export interface UsePickerValueState<TValue> {
+export interface UsePickerValueState<TValue extends PickerValidValue> {
     /**
      * Date displayed on the views and the field.
      * It is updated whenever the user modifies something.
      */
     draft: TValue;
     /**
-     * Last value published (e.g: the last value for which `shouldPublishValue` returned `true`).
+     * Last value published (the last value for which `shouldPublishValue` returned `true`).
      * If `onChange` is defined, it's the value that was passed on the last call to this callback.
      */
     lastPublishedValue: TValue;
     /**
-     * Last value committed (e.g: the last value for which `shouldCommitValue` returned `true`).
+     * Last value committed (the last value for which `shouldCommitValue` returned `true`).
      * If `onAccept` is defined, it's the value that was passed on the last call to this callback.
      */
     lastCommittedValue: TValue;
     /**
-     * Last value passed with `props.value`.
+     * Last value passed to `props.value`.
      * Used to update the `draft` value whenever the `value` prop changes.
      */
     lastControlledValue: TValue | undefined;
@@ -135,41 +136,10 @@ export interface UsePickerValueState<TValue> {
      */
     hasBeenModifiedSinceMount: boolean;
 }
-export interface PickerValueUpdaterParams<TValue, TError> {
-    action: PickerValueUpdateAction<TValue, TError>;
-    dateState: UsePickerValueState<TValue>;
-    /**
-     * Check if the new draft value has changed compared to some given value.
-     * @template TValue
-     * @param {TValue} comparisonValue The value to compare the new draft value with.
-     * @returns {boolean} `true` if the new draft value is equal to the comparison value.
-     */
-    hasChanged: (comparisonValue: TValue) => boolean;
-    isControlled: boolean;
-    closeOnSelect: boolean;
-}
-export type PickerValueUpdateAction<TValue, TError> = {
-    name: 'setValueFromView';
-    value: TValue;
-    selectionState: PickerSelectionState;
-} | {
-    name: 'setValueFromField';
-    value: TValue;
-    context: FieldChangeHandlerContext<TError>;
-} | {
-    name: 'setValueFromAction';
-    value: TValue;
-    pickerAction: 'accept' | 'today' | 'cancel' | 'dismiss' | 'clear';
-} | {
-    name: 'setValueFromShortcut';
-    value: TValue;
-    changeImportance: PickerShortcutChangeImportance;
-    shortcut: PickersShortcutsItemContext;
-};
 /**
  * Props used to handle the value that are common to all pickers.
  */
-export interface UsePickerValueBaseProps<TValue, TError> extends OnErrorProps<TValue, TError> {
+export interface UsePickerValueBaseProps<TValue extends PickerValidValue, TError> extends OnErrorProps<TValue, TError> {
     /**
      * The selected value.
      * Used when the component is controlled.
@@ -202,8 +172,8 @@ export interface UsePickerValueBaseProps<TValue, TError> extends OnErrorProps<TV
  */
 export interface UsePickerValueNonStaticProps {
     /**
-     * If `true`, the popover or modal will close after submitting the full date.
-     * @default `true` for desktop, `false` for mobile (based on the chosen wrapper and `desktopModeMediaQuery` prop).
+     * If `true`, the Picker will close after submitting the full date.
+     * @default false
      */
     closeOnSelect?: boolean;
     /**
@@ -225,47 +195,133 @@ export interface UsePickerValueNonStaticProps {
 /**
  * Props used to handle the value of the pickers.
  */
-export interface UsePickerValueProps<TValue, TError> extends UsePickerValueBaseProps<TValue, TError>, UsePickerValueNonStaticProps, TimezoneProps {
+export interface UsePickerValueProps<TValue extends PickerValidValue, TError> extends UsePickerValueBaseProps<TValue, TError>, UsePickerValueNonStaticProps, TimezoneProps {
+    referenceDate?: PickerValidDate;
 }
-export interface UsePickerValueParams<TValue, TExternalProps extends UsePickerValueProps<TValue, any>> {
+export interface UsePickerValueParams<TValue extends PickerValidValue, TExternalProps extends UsePickerValueProps<TValue, any>> {
     props: TExternalProps;
     valueManager: PickerValueManager<TValue, InferError<TExternalProps>>;
-    valueType: FieldValueType;
-    wrapperVariant: WrapperVariant;
+    valueType: PickerValueType;
     validator: Validator<TValue, InferError<TExternalProps>, TExternalProps>;
 }
-export interface UsePickerValueActions {
-    onAccept: () => void;
-    onClear: () => void;
-    onDismiss: () => void;
-    onCancel: () => void;
-    onSetToday: () => void;
-    onOpen: (event: React.UIEvent) => void;
-    onClose: (event?: React.UIEvent) => void;
-}
-export type UsePickerValueFieldResponse<TValue, TSection extends FieldSection, TError> = Required<Pick<UseFieldInternalProps<TValue, TSection, any, TError>, 'value' | 'onChange'>>;
+export type UsePickerValueFieldResponse<TValue extends PickerValidValue, TError> = Required<Pick<UseFieldInternalProps<TValue, any, TError>, 'value' | 'onChange'>>;
 /**
  * Props passed to `usePickerViews`.
  */
-export interface UsePickerValueViewsResponse<TValue> {
+export interface UsePickerValueViewsResponse<TValue extends PickerValidValue> {
     value: TValue;
     onChange: (value: TValue, selectionState?: PickerSelectionState) => void;
     open: boolean;
-    onClose: (event?: React.MouseEvent) => void;
+    setOpen: React.Dispatch<React.SetStateAction<boolean>>;
 }
 /**
- * Props passed to `usePickerLayoutProps`.
+ * Params passed to `usePickerProvider`.
  */
-export interface UsePickerValueLayoutResponse<TValue> extends UsePickerValueActions {
+export interface UsePickerValueProviderParams<TValue extends PickerValidValue, TError> {
     value: TValue;
-    onChange: (newValue: TValue) => void;
-    onSelectShortcut: (newValue: TValue, changeImportance: PickerShortcutChangeImportance, shortcut: PickersShortcutsItemContext) => void;
-    isValid: (value: TValue) => boolean;
+    contextValue: UsePickerValueContextValue<TValue, TError>;
+    actionsContextValue: UsePickerValueActionsContextValue<TValue, TError>;
+    privateContextValue: UsePickerValuePrivateContextValue;
+    isValidContextValue: (value: TValue) => boolean;
 }
-export interface UsePickerValueResponse<TValue, TSection extends FieldSection, TError> {
-    open: boolean;
-    actions: UsePickerValueActions;
+export interface UsePickerValueResponse<TValue extends PickerValidValue, TError> {
     viewProps: UsePickerValueViewsResponse<TValue>;
-    fieldProps: UsePickerValueFieldResponse<TValue, TSection, TError>;
-    layoutProps: UsePickerValueLayoutResponse<TValue>;
+    provider: UsePickerValueProviderParams<TValue, TError>;
+}
+export interface UsePickerValueContextValue<TValue extends PickerValidValue, TError> extends UsePickerValueActionsContextValue<TValue, TError> {
+    /**
+     * The current value of the picker.
+     */
+    value: TValue;
+    /**
+     * The timezone to use when rendering the dates.
+     * If a `timezone` prop is provided, it will be used.
+     * If the `value` prop contains a valid date, its timezone will be used.
+     * If no `value` prop is provided, but the `defaultValue` contains a valid date, its timezone will be used.
+     * If no `value` or `defaultValue` is provided, but the `referenceDate` is provided, its timezone will be used.
+     * Otherwise, the timezone will be the default one of your date library.
+     */
+    timezone: PickersTimezone;
+    /**
+     * Whether the picker is open.
+     */
+    open: boolean;
+}
+export interface UsePickerValueActionsContextValue<TValue extends PickerValidValue, TError> {
+    /**
+     * Set the current value of the picker.
+     * @param {TValue} value The new value of the picker.
+     * @param {SetValueActionOptions<TError>} options The options to customize the behavior of this update.
+     */
+    setValue: (value: TValue, options?: SetValueActionOptions<TError>) => void;
+    /**
+     * Set the current open state of the Picker.
+     * ```ts
+     * setOpen(true); // Opens the picker.
+     * setOpen(false); // Closes the picker.
+     * setOpen((prevOpen) => !prevOpen); // Toggles the open state.
+     * ```
+     * @param {React.SetStateAction<boolean>} action The new open state of the Picker.
+     * It can be a function that will receive the current open state.
+     */
+    setOpen: React.Dispatch<React.SetStateAction<boolean>>;
+    /**
+     * Set the current value of the picker to be empty.
+     * The value will be `null` on single pickers and `[null, null]` on range pickers.
+     */
+    clearValue: () => void;
+    /**
+     * Set the current value of the picker to be the current date.
+     * The value will be `today` on single pickers and `[today, today]` on range pickers.
+     * With `today` being the current date, with its time set to `00:00:00` on Date Pickers and its time set to the current time on Time and Date Pickers.
+     */
+    setValueToToday: () => void;
+    /**
+     * Accept the current value of the picker.
+     * Will call `onAccept` if defined.
+     * If the picker is re-opened, this value will be the one used to initialize the views.
+     */
+    acceptValueChanges: () => void;
+    /**
+     * Cancel the changes made to the current value of the picker.
+     * The value will be reset to the last accepted value.
+     */
+    cancelValueChanges: () => void;
+}
+export interface UsePickerValuePrivateContextValue {
+    /**
+     * Close the picker and accepts the current value if it is not equal to the last accepted value.
+     */
+    dismissViews: () => void;
+}
+export interface SetValueActionOptions<TError = string | null> {
+    /**
+     * The importance of the change when picking a value:
+     * - "accept": fires `onChange`, fires `onAccept` and closes the picker.
+     * - "set": fires `onChange` but do not fire `onAccept` and does not close the picker.
+     * @default "accept"
+     */
+    changeImportance?: PickerChangeImportance;
+    /**
+     * The validation error associated to the current value.
+     * If not defined, the validation will be computed by the picker.
+     */
+    validationError?: TError;
+    /**
+     * The shortcut that triggered this change.
+     * It should not be defined if the change does not come from a shortcut.
+     */
+    shortcut?: PickersShortcutsItemContext;
+    /**
+     * Whether the value should call `onChange` and `onAccept` when the value is not controlled and has never been modified.
+     * If `true`, the `onChange` and `onAccept` callback will only be fired if the value has been modified (and is not equal to the last published value).
+     * If `false`, the `onChange` and `onAccept` callback will be fired when the value has never been modified (`onAccept` only if `changeImportance` is set to "accept").
+     * @default false
+     */
+    skipPublicationIfPristine?: boolean;
+    /**
+     * Whether the picker should close.
+     * @default changeImportance === "accept"
+     */
+    shouldClose?: boolean;
 }

package/internals/hooks/usePicker/usePickerViews.d.ts

@@ -3,11 +3,11 @@ import { SxProps } from '@mui/system';
 import { Theme } from '@mui/material/styles';
 import { UseViewsOptions } from '../useViews';
 import type { UsePickerValueViewsResponse } from './usePickerValue.types';
-import { DateOrTimeViewWithMeridiem } from '../../models';
-import { FieldRef, FieldSection, PickerValidDate, TimezoneProps } from '../../../models';
-interface PickerViewsRendererBaseExternalProps<TView extends DateOrTimeViewWithMeridiem> extends Omit<UsePickerViewsProps<any, TView, any, any>, 'openTo' | 'viewRenderers'> {
+import { DateOrTimeViewWithMeridiem, PickerRangeValue, PickerValidValue, PickerValue } from '../../models';
+import { FieldRef, PickerValidDate, TimezoneProps } from '../../../models';
+export interface PickerViewsRendererBaseExternalProps extends Omit<UsePickerViewsProps<any, any, any>, 'openTo' | 'viewRenderers'> {
 }
-export type PickerViewsRendererProps<TValue, TView extends DateOrTimeViewWithMeridiem, TExternalProps extends PickerViewsRendererBaseExternalProps<TView>, TAdditionalProps extends {}> = Omit<TExternalProps, 'className' | 'sx'> & TAdditionalProps & UsePickerValueViewsResponse<TValue> & {
+export type PickerViewsRendererProps<TValue extends PickerValidValue, TView extends DateOrTimeViewWithMeridiem, TExternalProps extends PickerViewsRendererBaseExternalProps> = Omit<TExternalProps, 'className' | 'sx'> & Pick<UsePickerValueViewsResponse<TValue>, 'value' | 'onChange'> & {
     view: TView;
     views: readonly TView[];
     focusedView: TView | null;
@@ -15,76 +15,96 @@ export type PickerViewsRendererProps<TValue, TView extends DateOrTimeViewWithMer
     showViewSwitcher: boolean;
     timeViewsCount: number;
 };
-export type PickerViewRenderer<TValue, TView extends DateOrTimeViewWithMeridiem, TExternalProps extends PickerViewsRendererBaseExternalProps<TView>, TAdditionalProps extends {}> = (props: PickerViewsRendererProps<TValue, TView, TExternalProps, TAdditionalProps>) => React.ReactNode;
-export type PickerViewRendererLookup<TValue, TView extends DateOrTimeViewWithMeridiem, TExternalProps extends PickerViewsRendererBaseExternalProps<any>, TAdditionalProps extends {}> = {
-    [K in TView]: PickerViewRenderer<TValue, K, TExternalProps, TAdditionalProps> | null;
-};
+export type PickerViewRenderer<TValue extends PickerValidValue, TExternalProps extends PickerViewsRendererBaseExternalProps> = (props: PickerViewsRendererProps<TValue, any, TExternalProps>) => React.ReactNode;
+export type PickerViewRendererLookup<TValue extends PickerValidValue, TView extends DateOrTimeViewWithMeridiem, TExternalProps extends PickerViewsRendererBaseExternalProps> = Record<TView, PickerViewRenderer<TValue, TExternalProps> | null>;
 /**
  * Props used to handle the views that are common to all pickers.
  */
-export interface UsePickerViewsBaseProps<TValue, TView extends DateOrTimeViewWithMeridiem, TExternalProps extends UsePickerViewsProps<TValue, TView, any, any>, TAdditionalProps extends {}> extends Omit<UseViewsOptions<any, TView>, 'onChange' | 'onFocusedViewChange' | 'focusedView'>, TimezoneProps {
+export interface UsePickerViewsBaseProps<TValue extends PickerValidValue, TView extends DateOrTimeViewWithMeridiem, TExternalProps extends UsePickerViewsProps<TValue, TView, any>> extends Omit<UseViewsOptions<any, TView>, 'onChange' | 'onFocusedViewChange' | 'focusedView'>, TimezoneProps {
     /**
      * If `null`, the section will only have field editing.
      * If `undefined`, internally defined view will be used.
      */
-    viewRenderers: PickerViewRendererLookup<TValue, TView, TExternalProps, TAdditionalProps>;
-    /**
-     * If `true`, disable heavy animations.
-     * @default `@media(prefers-reduced-motion: reduce)` || `navigator.userAgent` matches Android <10 or iOS <13
-     */
-    reduceAnimations?: boolean;
+    viewRenderers: PickerViewRendererLookup<TValue, TView, TExternalProps>;
     /**
      * The date used to generate the new value when both `value` and `defaultValue` are empty.
      * @default The closest valid date-time using the validation props, except callbacks like `shouldDisable<...>`.
      */
     referenceDate?: PickerValidDate;
 }
-/**
- * Props used to handle the views of the pickers.
- */
-export interface UsePickerViewsNonStaticProps {
-    /**
-     * If `true`, the open picker button will not be rendered (renders only the field).
-     * @default false
-     */
-    disableOpenPicker?: boolean;
-}
 /**
  * Props used to handle the value of the pickers.
  */
-export interface UsePickerViewsProps<TValue, TView extends DateOrTimeViewWithMeridiem, TExternalProps extends UsePickerViewsProps<TValue, TView, any, any>, TAdditionalProps extends {}> extends UsePickerViewsBaseProps<TValue, TView, TExternalProps, TAdditionalProps> {
+export interface UsePickerViewsProps<TValue extends PickerValidValue, TView extends DateOrTimeViewWithMeridiem, TExternalProps extends UsePickerViewsProps<TValue, TView, any>> extends UsePickerViewsBaseProps<TValue, TView, TExternalProps> {
     className?: string;
     sx?: SxProps<Theme>;
 }
-export interface UsePickerViewParams<TValue, TView extends DateOrTimeViewWithMeridiem, TSection extends FieldSection, TExternalProps extends UsePickerViewsProps<TValue, TView, TExternalProps, TAdditionalProps>, TAdditionalProps extends {}> {
+export interface UsePickerViewParams<TValue extends PickerValidValue, TView extends DateOrTimeViewWithMeridiem, TExternalProps extends UsePickerViewsProps<TValue, TView, TExternalProps>> {
     props: TExternalProps;
     propsFromPickerValue: UsePickerValueViewsResponse<TValue>;
-    additionalViewProps: TAdditionalProps;
     autoFocusView: boolean;
-    fieldRef: React.RefObject<FieldRef<TSection>> | undefined;
+    fieldRef?: React.RefObject<FieldRef<PickerValue> | FieldRef<PickerRangeValue> | null>;
     /**
      * A function that intercepts the regular picker rendering.
      * Can be used to consume the provided `viewRenderers` and render a custom component wrapping them.
-     * @param {PickerViewRendererLookup<TValue, TView, TExternalProps, TAdditionalProps>} viewRenderers The `viewRenderers` that were provided to the picker component.
+     * @param {PickerViewRendererLookup<TValue, TView, TExternalProps>} viewRenderers The `viewRenderers` that were provided to the picker component.
      * @param {TView} popperView The current picker view.
      * @param {any} rendererProps All the props that are being passed down to the renderer.
      * @returns {React.ReactNode} A React node that will be rendered instead of the default renderer.
      */
-    rendererInterceptor?: (viewRenderers: PickerViewRendererLookup<TValue, TView, TExternalProps, TAdditionalProps>, popperView: TView, rendererProps: PickerViewsRendererProps<TValue, TView, TExternalProps, TAdditionalProps>) => React.ReactNode;
+    rendererInterceptor?: React.JSXElementConstructor<PickerRendererInterceptorProps<TValue, TView, TExternalProps>>;
+}
+export interface PickerRendererInterceptorProps<TValue extends PickerValidValue, TView extends DateOrTimeViewWithMeridiem, TExternalProps extends UsePickerViewsProps<TValue, TView, TExternalProps>> {
+    viewRenderers: PickerViewRendererLookup<TValue, TView, TExternalProps>;
+    popperView: TView;
+    rendererProps: PickerViewsRendererProps<TValue, TView, TExternalProps>;
 }
 export interface UsePickerViewsResponse<TView extends DateOrTimeViewWithMeridiem> {
+    renderCurrentView: () => React.ReactNode;
+    provider: UsePickerViewsProviderParams<TView>;
+}
+export interface UsePickerViewsActionsContextValue<TView extends DateOrTimeViewWithMeridiem> {
     /**
-     * Indicates if the the picker has at least one view that should be rendered in UI.
+     * Set the current view.
+     * @template TView
+     * @param {TView} view The view to render
      */
-    hasUIView: boolean;
-    renderCurrentView: () => React.ReactNode;
-    shouldRestoreFocus: () => boolean;
-    layoutProps: UsePickerViewsLayoutResponse<TView>;
+    setView: (view: TView) => void;
 }
-export interface UsePickerViewsLayoutResponse<TView extends DateOrTimeViewWithMeridiem> {
+export interface UsePickerViewsContextValue<TView extends DateOrTimeViewWithMeridiem> extends UsePickerViewsActionsContextValue<TView> {
+    /**
+     * The views that the picker must render.
+     * It is equal to the picker `views` prop if defined.
+     * Otherwise, a default set of views is provided based on the component you are using:
+     * - Date Pickers: ['year', 'day']
+     * - Time Pickers: ['hours', 'minutes']
+     * - Date Time Pickers: ['year', 'day', 'hours', 'minutes']
+     * - Date Range Pickers: ['day']
+     * - Date Time Range Pickers: ['day', 'hours', 'minutes']
+     */
+    views: readonly TView[];
+    /**
+     * The view currently rendered.
+     */
     view: TView | null;
-    onViewChange: (view: TView) => void;
+}
+export interface UsePickerViewsPrivateContextValue {
+    /**
+     * Whether one of the view has an UI (it has a view renderer associated).
+     */
+    hasUIView: boolean;
+    /**
+     * Check whether the current view has an UI.
+     * @returns {boolean} Whether the current view has an UI.
+     */
+    doesTheCurrentViewHasAnUI: () => boolean;
+}
+export interface UsePickerViewsProviderParams<TView extends DateOrTimeViewWithMeridiem> {
+    hasUIView: boolean;
     views: readonly TView[];
+    contextValue: UsePickerViewsContextValue<TView>;
+    actionsContextValue: UsePickerViewsActionsContextValue<TView>;
+    privateContextValue: UsePickerViewsPrivateContextValue;
 }
 /**
  * Manage the views of all the pickers:
@@ -92,5 +112,4 @@ export interface UsePickerViewsLayoutResponse<TView extends DateOrTimeViewWithMe
  * - Handles the switch between UI views and field views
  * - Handles the focus management when switching views
  */
-export declare const usePickerViews: <TValue, TView extends DateOrTimeViewWithMeridiem, TSection extends FieldSection, TExternalProps extends UsePickerViewsProps<TValue, TView, any, any>, TAdditionalProps extends {}>({ props, propsFromPickerValue, additionalViewProps, autoFocusView, rendererInterceptor, fieldRef, }: UsePickerViewParams<TValue, TView, TSection, TExternalProps, TAdditionalProps>) => UsePickerViewsResponse<TView>;
-export {};
+export declare const usePickerViews: <TValue extends PickerValidValue, TView extends DateOrTimeViewWithMeridiem, TExternalProps extends UsePickerViewsProps<TValue, TView, any>>({ props, propsFromPickerValue, autoFocusView, rendererInterceptor: RendererInterceptor, fieldRef, }: UsePickerViewParams<TValue, TView, TExternalProps>) => UsePickerViewsResponse<TView>;

package/internals/hooks/usePicker/usePickerViews.js

@@ -11,14 +11,10 @@ import { isTimeView } from "../../utils/time-utils.js";
  * Props used to handle the views that are common to all pickers.
  */
 
-/**
- * Props used to handle the views of the pickers.
- */
-
 /**
  * Props used to handle the value of the pickers.
  */
-
+import { jsx as _jsx } from "react/jsx-runtime";
 /**
  * Manage the views of all the pickers:
  * - Handles the view switch
@@ -28,15 +24,15 @@ import { isTimeView } from "../../utils/time-utils.js";
 export const usePickerViews = ({
   props,
   propsFromPickerValue,
-  additionalViewProps,
   autoFocusView,
-  rendererInterceptor,
+  rendererInterceptor: RendererInterceptor,
   fieldRef
 }) => {
   const {
     onChange,
+    value,
     open,
-    onClose
+    setOpen
   } = propsFromPickerValue;
   const {
     view: inView,
@@ -88,7 +84,7 @@ export const usePickerViews = ({
     return acc;
   }, 0), [viewRenderers, views]);
   const currentViewMode = viewModeLookup[view];
-  const shouldRestoreFocus = useEventCallback(() => currentViewMode === 'UI');
+  const doesTheCurrentViewHasAnUI = useEventCallback(() => currentViewMode === 'UI');
   const [popperView, setPopperView] = React.useState(currentViewMode === 'UI' ? view : null);
   if (popperView !== view && viewModeLookup[view] === 'UI') {
     setPopperView(view);
@@ -96,7 +92,7 @@ export const usePickerViews = ({
   useEnhancedEffect(() => {
     // Handle case of `DateTimePicker` without time renderers
     if (currentViewMode === 'field' && open) {
-      onClose();
+      setOpen(false);
       setTimeout(() => {
         fieldRef?.current?.setSelectedSections(view);
         // focusing the input before the range selection is done
@@ -127,15 +123,26 @@ export const usePickerViews = ({
     setFocusedView(newView, true);
   }, [open]); // eslint-disable-line react-hooks/exhaustive-deps
 
-  const layoutProps = {
+  const actionsContextValue = React.useMemo(() => ({
+    setView
+  }), [setView]);
+  const contextValue = React.useMemo(() => _extends({}, actionsContextValue, {
     views,
-    view: popperView,
-    onViewChange: setView
+    view: popperView
+  }), [actionsContextValue, views, popperView]);
+  const privateContextValue = React.useMemo(() => ({
+    hasUIView,
+    doesTheCurrentViewHasAnUI
+  }), [hasUIView, doesTheCurrentViewHasAnUI]);
+  const providerParams = {
+    hasUIView,
+    views,
+    contextValue,
+    actionsContextValue,
+    privateContextValue
   };
   return {
-    hasUIView,
-    shouldRestoreFocus,
-    layoutProps,
+    provider: providerParams,
     renderCurrentView: () => {
       if (popperView == null) {
         return null;
@@ -144,9 +151,10 @@ export const usePickerViews = ({
       if (renderer == null) {
         return null;
       }
-      const rendererProps = _extends({}, propsToForwardToView, additionalViewProps, propsFromPickerValue, {
+      const rendererProps = _extends({}, propsToForwardToView, {
         views,
         timezone,
+        value,
         onChange: setValueAndGoToNextView,
         view: popperView,
         onViewChange: setView,
@@ -155,8 +163,12 @@ export const usePickerViews = ({
         showViewSwitcher: timeViewsCount > 1,
         timeViewsCount
       });
-      if (rendererInterceptor) {
-        return rendererInterceptor(viewRenderers, popperView, rendererProps);
+      if (RendererInterceptor) {
+        return /*#__PURE__*/_jsx(RendererInterceptor, {
+          viewRenderers: viewRenderers,
+          popperView: popperView,
+          rendererProps: rendererProps
+        });
       }
       return renderer(rendererProps);
     }

package/internals/hooks/useReduceAnimations.d.ts

@@ -0,0 +1,2 @@
+export declare const slowAnimationDevices: boolean;
+export declare function useReduceAnimations(customReduceAnimations: boolean | undefined): boolean;

package/internals/hooks/{useDefaultReduceAnimations.js → useReduceAnimations.js}

@@ -6,9 +6,12 @@ const mobileVersionMatches = typeof navigator !== 'undefined' && navigator.userA
 const androidVersion = mobileVersionMatches && mobileVersionMatches[1] ? parseInt(mobileVersionMatches[1], 10) : null;
 const iOSVersion = mobileVersionMatches && mobileVersionMatches[2] ? parseInt(mobileVersionMatches[2], 10) : null;
 export const slowAnimationDevices = androidVersion && androidVersion < 10 || iOSVersion && iOSVersion < 13 || false;
-export const useDefaultReduceAnimations = () => {
+export function useReduceAnimations(customReduceAnimations) {
   const prefersReduced = useMediaQuery(PREFERS_REDUCED_MOTION, {
     defaultMatches: false
   });
+  if (customReduceAnimations != null) {
+    return customReduceAnimations;
+  }
   return prefersReduced || slowAnimationDevices;
-};
+}

package/internals/hooks/useStaticPicker/useStaticPicker.d.ts

@@ -7,6 +7,6 @@ import { DateOrTimeViewWithMeridiem } from '../../models';
  * - StaticDateTimePicker
  * - StaticTimePicker
  */
-export declare const useStaticPicker: <TView extends DateOrTimeViewWithMeridiem, TExternalProps extends UseStaticPickerProps<TView, any, TExternalProps>>({ props, ref, ...pickerParams }: UseStaticPickerParams<TView, TExternalProps>) => {
+export declare const useStaticPicker: <TView extends DateOrTimeViewWithMeridiem, TExternalProps extends UseStaticPickerProps<TView, any, TExternalProps>>({ props, ...pickerParams }: UseStaticPickerParams<TView, TExternalProps>) => {
     renderPicker: () => React.JSX.Element;
 };