@mui/x-date-pickers 8.0.0-alpha.13 → 8.0.0-alpha.14

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

@@ -1,18 +1,190 @@
-import { UsePickerValueParams, UsePickerValueProps, UsePickerValueBaseProps } from "./usePickerValue.types.js";
-import { UsePickerViewsProps, UsePickerViewParams, UsePickerViewsBaseProps } from "./usePickerViews.js";
-import { InferError, PickerOwnerState } from "../../../models/index.js";
-import { DateOrTimeViewWithMeridiem, PickerValidValue } from "../../models/index.js";
-import { UsePickerProviderParameters, UsePickerProviderProps, UsePickerProviderReturnValue } from "./usePickerProvider.js";
+import { SxProps } from '@mui/system';
+import { Theme } from '@mui/material/styles';
+import { InferError, OnErrorProps, PickerChangeHandlerContext, PickerOwnerState, PickerValidDate, PickerValueType, TimezoneProps } from "../../../models/index.js";
+import { DateOrTimeViewWithMeridiem, FormProps, PickerOrientation, PickerValidValue, PickerValueManager, PickerVariant } from "../../models/index.js";
+import { Validator } from "../../../validation/index.js";
+import { UseViewsOptions } from "../useViews.js";
+import { PickerProviderProps } from "../../components/PickerProvider.js";
+import { PickersInputLocaleText } from "../../../locales/index.js";
+import { PickerFieldPrivateContextValue } from "../useNullableFieldPrivateContext.js";
 /**
  * Props common to all picker headless implementations.
+ * Those props are exposed on all the pickers.
  */
-export interface UsePickerBaseProps<TValue extends PickerValidValue, TView extends DateOrTimeViewWithMeridiem, TError, TExternalProps extends UsePickerViewsProps<TValue, TView, any>> extends UsePickerValueBaseProps<TValue, TError>, UsePickerViewsBaseProps<TValue, TView, TExternalProps>, UsePickerProviderProps {}
-export interface UsePickerProps<TValue extends PickerValidValue, TView extends DateOrTimeViewWithMeridiem, TError, TExternalProps extends UsePickerViewsProps<TValue, TView, any>> extends UsePickerValueProps<TValue, TError>, UsePickerViewsProps<TValue, TView, TExternalProps>, UsePickerProviderProps {}
-export interface UsePickerParams<TValue extends PickerValidValue, TView extends DateOrTimeViewWithMeridiem, TExternalProps extends UsePickerProps<TValue, TView, any, any>> extends Pick<UsePickerValueParams<TValue, TExternalProps>, 'valueManager' | 'valueType' | 'validator'>, Pick<UsePickerViewParams<TValue, TView, TExternalProps>, 'autoFocusView' | 'viewContainerRole' | 'rendererInterceptor'>, Pick<UsePickerProviderParameters<TValue, TView, InferError<TExternalProps>>, 'localeText' | 'variant' | 'ref'> {
+export interface UsePickerBaseProps<TValue extends PickerValidValue, TView extends DateOrTimeViewWithMeridiem, TError, TExternalProps extends UsePickerProps<TValue, TView, TError, any>> extends OnErrorProps<TValue, TError>, Omit<UseViewsOptions<any, TView>, 'onChange' | 'onFocusedViewChange' | 'focusedView'>, TimezoneProps, FormProps {
+  /**
+   * The selected value.
+   * Used when the component is controlled.
+   */
+  value?: TValue;
+  /**
+   * The default value.
+   * Used when the component is not controlled.
+   */
+  defaultValue?: TValue;
+  /**
+   * Callback fired when the value changes.
+   * @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.
+   * @template TError The validation error type. It will be either `string` or a `null`. It can be in `[start, end]` format in case of range value.
+   * @param {TValue} value The new value.
+   * @param {FieldChangeHandlerContext<TError>} context The context containing the validation result of the current value.
+   */
+  onChange?: (value: TValue, context: PickerChangeHandlerContext<TError>) => void;
+  /**
+   * Callback fired when the value is accepted.
+   * @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.
+   * @template TError The validation error type. It will be either `string` or a `null`. It can be in `[start, end]` format in case of range value.
+   * @param {TValue} value The value that was just accepted.
+   * @param {FieldChangeHandlerContext<TError>} context The context containing the validation result of the current value.
+   */
+  onAccept?: (value: TValue, context: PickerChangeHandlerContext<TError>) => void;
+  /**
+   * If `null`, the section will only have field editing.
+   * If `undefined`, internally defined view will be used.
+   */
+  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;
+  /**
+   * Force rendering in particular orientation.
+   */
+  orientation?: PickerOrientation;
+  /**
+   * If `true`, disable heavy animations.
+   * @default `@media(prefers-reduced-motion: reduce)` || `navigator.userAgent` matches Android <10 or iOS <13
+   */
+  reduceAnimations?: boolean;
+}
+/**
+ * Props used to handle the value of non-static pickers.
+ */
+export interface UsePickerNonStaticProps extends Omit<PickerFieldPrivateContextValue, 'fieldRef'> {
+  /**
+   * If `true`, the Picker will close after submitting the full date.
+   * @default false
+   */
+  closeOnSelect?: boolean;
+  /**
+   * Control the popup or dialog open state.
+   * @default false
+   */
+  open?: boolean;
+  /**
+   * Callback fired when the popup requests to be closed.
+   * Use in controlled mode (see `open`).
+   */
+  onClose?: () => void;
+  /**
+   * Callback fired when the popup requests to be opened.
+   * Use in controlled mode (see `open`).
+   */
+  onOpen?: () => void;
+  /**
+   * Format of the date when rendered in the input(s).
+   * Defaults to localized format based on the used `views`.
+   */
+  format?: string;
+  /**
+   * If `true`, the open picker button will not be rendered (renders only the field).
+   * @default false
+   */
+  disableOpenPicker?: boolean;
+  /**
+   * The label content.
+   */
+  label?: React.ReactNode;
+  /**
+   * Pass a ref to the `input` element.
+   */
+  inputRef?: React.Ref<HTMLInputElement>;
+  /**
+   * Name attribute used by the `input` element in the Field.
+   */
+  name?: string;
+}
+export interface UsePickerProps<TValue extends PickerValidValue, TView extends DateOrTimeViewWithMeridiem, TError, TExternalProps extends UsePickerProps<TValue, TView, TError, any>> extends UsePickerBaseProps<TValue, TView, TError, TExternalProps>, UsePickerNonStaticProps {
+  referenceDate?: PickerValidDate;
+  className?: string;
+  sx?: SxProps<Theme>;
+}
+export interface UsePickerParameters<TValue extends PickerValidValue, TView extends DateOrTimeViewWithMeridiem, TExternalProps extends UsePickerProps<TValue, TView, any, any>> {
+  ref: React.ForwardedRef<HTMLDivElement> | undefined;
+  localeText: PickersInputLocaleText | undefined;
+  variant: PickerVariant;
+  valueManager: PickerValueManager<TValue, InferError<TExternalProps>>;
+  valueType: PickerValueType;
+  validator: Validator<TValue, InferError<TExternalProps>, TExternalProps>;
+  autoFocusView: boolean;
+  viewContainerRole: 'dialog' | 'tooltip' | 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>} 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?: React.JSXElementConstructor<PickerRendererInterceptorProps<TValue, TView, TExternalProps>>;
   props: TExternalProps;
 }
 export interface UsePickerReturnValue<TValue extends PickerValidValue> {
   ownerState: PickerOwnerState;
   renderCurrentView: () => React.ReactNode;
-  providerProps: UsePickerProviderReturnValue<TValue>;
+  providerProps: Omit<PickerProviderProps<TValue>, 'children'>;
+}
+export type PickerSelectionState = 'partial' | 'shallow' | 'finish';
+export interface UsePickerState<TValue extends PickerValidValue> {
+  /**
+   * Whether the picker is open.
+   */
+  open: boolean;
+  /**
+   * Date displayed on the views and the field.
+   * It is updated whenever the user modifies something.
+   */
+  draft: TValue;
+  /**
+   * 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 (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 to `props.value`.
+   * Used to update the `draft` value whenever the `value` prop changes.
+   */
+  lastControlledValue: TValue | undefined;
+  /**
+   * If we never modified the value since the mount of the component,
+   * Then we might want to apply some custom logic.
+   *
+   * For example, when the component is not controlled and `defaultValue` is defined.
+   * Then clicking on "Accept", "Today" or "Clear" should fire `onAccept` with `defaultValue`, but clicking on "Cancel" or dismissing the picker should not.
+   */
+  hasBeenModifiedSinceMount: boolean;
+}
+export interface PickerViewsRendererBaseExternalProps extends Omit<UsePickerProps<any, any, any, any>, 'openTo' | 'viewRenderers' | 'onChange'> {}
+export type PickerViewsRendererProps<TValue extends PickerValidValue, TView extends DateOrTimeViewWithMeridiem, TExternalProps extends PickerViewsRendererBaseExternalProps> = Omit<TExternalProps, 'className' | 'sx'> & {
+  value: TValue;
+  onChange: (value: TValue, selectionState?: PickerSelectionState) => void;
+  view: TView;
+  views: readonly TView[];
+  focusedView: TView | null;
+  onFocusedViewChange: (viewToFocus: TView, hasFocus: boolean) => void;
+  showViewSwitcher: boolean;
+  timeViewsCount: number;
+};
+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>;
+export interface PickerRendererInterceptorProps<TValue extends PickerValidValue, TView extends DateOrTimeViewWithMeridiem, TExternalProps extends UsePickerProps<TValue, TView, any, TExternalProps>> {
+  viewRenderers: PickerViewRendererLookup<TValue, TView, TExternalProps>;
+  popperView: TView;
+  rendererProps: PickerViewsRendererProps<TValue, TView, TExternalProps>;
 }

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

@@ -1,7 +1,6 @@
 import { ExportedPickersLayoutSlots, ExportedPickersLayoutSlotProps } from "../../../PickersLayout/PickersLayout.types.js";
 import { BasePickerProps } from "../../models/props/basePickerProps.js";
-import { UsePickerParams } from "../usePicker/index.js";
-import { UsePickerViewsProps } from "../usePicker/usePickerViews.js";
+import { UsePickerParameters, UsePickerProps } from "../usePicker/index.js";
 import { DateOrTimeViewWithMeridiem, PickerValue } from "../../models/index.js";
 export interface UseStaticPickerSlots extends ExportedPickersLayoutSlots<PickerValue> {}
 export interface UseStaticPickerSlotProps extends ExportedPickersLayoutSlotProps<PickerValue> {}
@@ -23,7 +22,7 @@ export interface StaticOnlyPickerProps {
    */
   onClose?: () => void;
 }
-export interface UseStaticPickerProps<TView extends DateOrTimeViewWithMeridiem, TError, TExternalProps extends UsePickerViewsProps<PickerValue, TView, any>> extends BasePickerProps<PickerValue, TView, TError, TExternalProps>, StaticOnlyPickerProps {
+export interface UseStaticPickerProps<TView extends DateOrTimeViewWithMeridiem, TError, TExternalProps extends UsePickerProps<PickerValue, TView, TError, any>> extends BasePickerProps<PickerValue, TView, TError, TExternalProps>, StaticOnlyPickerProps {
   /**
    * Overridable component slots.
    * @default {}
@@ -35,6 +34,6 @@ export interface UseStaticPickerProps<TView extends DateOrTimeViewWithMeridiem,
    */
   slotProps?: UseStaticPickerSlotProps;
 }
-export interface UseStaticPickerParams<TView extends DateOrTimeViewWithMeridiem, TExternalProps extends UseStaticPickerProps<TView, any, TExternalProps>> extends Pick<UsePickerParams<PickerValue, TView, TExternalProps>, 'valueManager' | 'valueType' | 'validator' | 'ref'> {
+export interface UseStaticPickerParams<TView extends DateOrTimeViewWithMeridiem, TExternalProps extends UseStaticPickerProps<TView, any, TExternalProps>> extends Pick<UsePickerParameters<PickerValue, TView, TExternalProps>, 'valueManager' | 'valueType' | 'validator' | 'ref'> {
   props: TExternalProps;
 }

package/internals/hooks/useValueWithTimezone.d.ts

@@ -1,4 +1,4 @@
-import type { PickerValueManager } from './usePicker';
+import type { PickerValueManager } from '../models';
 import { PickersTimezone, PickerValidDate } from "../../models/index.js";
 import { PickerValidValue } from "../models/index.js";
 /**

package/internals/index.d.ts

@@ -31,10 +31,7 @@ export type { MobileOnlyPickerProps } from './hooks/useMobilePicker';
 export { useNullableFieldPrivateContext } from "./hooks/useNullableFieldPrivateContext.js";
 export { useNullablePickerContext } from "./hooks/useNullablePickerContext.js";
 export { usePicker } from "./hooks/usePicker/index.js";
-export type { UsePickerParams, UsePickerProps, UsePickerValueFieldResponse, PickerViewsRendererProps } from './hooks/usePicker';
-export type { UsePickerValueContextValue, UsePickerValueNonStaticProps, PickerValueManager, PickerSelectionState } from './hooks/usePicker/usePickerValue.types';
-export type { PickerViewRendererLookup, PickerRendererInterceptorProps, PickerViewRenderer, UsePickerViewsProps } from './hooks/usePicker/usePickerViews';
-export type { UsePickerProviderNonStaticProps } from './hooks/usePicker/usePickerProvider';
+export type { UsePickerParameters, UsePickerProps, PickerViewsRendererProps, PickerSelectionState, PickerViewRendererLookup, PickerRendererInterceptorProps, PickerViewRenderer, UsePickerNonStaticProps } from './hooks/usePicker';
 export { usePickerPrivateContext } from "./hooks/usePickerPrivateContext.js";
 export { useStaticPicker } from "./hooks/useStaticPicker/index.js";
 export type { StaticOnlyPickerProps, UseStaticPickerSlots, UseStaticPickerSlotProps } from './hooks/useStaticPicker';
@@ -44,11 +41,11 @@ export { useLocalizationContext, useDefaultDates, useUtils, useNow } from "./hoo
 export type { ExportedUseViewsOptions, UseViewsOptions } from './hooks/useViews';
 export { useViews } from "./hooks/useViews.js";
 export { usePreviousMonthDisabled, useNextMonthDisabled } from "./hooks/date-helpers-hooks.js";
-export type { PickerAnyManager, PickerManagerFieldInternalProps, PickerManagerEnableAccessibleFieldDOMStructure, PickerManagerError } from './models/manager';
+export type { PickerAnyManager, PickerManagerFieldInternalProps, PickerManagerEnableAccessibleFieldDOMStructure, PickerManagerError, PickerValueManager } from './models/manager';
 export type { RangePosition } from './models/pickers';
 export type { BaseSingleInputFieldProps, FieldRangeSection } from './models/fields';
 export type { BasePickerProps, BasePickerInputProps } from './models/props/basePickerProps';
-export type { BaseClockProps, DesktopOnlyTimePickerProps, AmPmProps } from './models/props/time';
+export type { BaseClockProps, DigitalTimePickerProps, AmPmProps } from './models/props/time';
 export type { ExportedBaseTabsProps } from './models/props/tabs';
 export type { BaseToolbarProps, ExportedBaseToolbarProps } from './models/props/toolbar';
 export type { FormProps } from './models/formProps';

package/internals/models/manager.d.ts

@@ -1,15 +1,119 @@
-import type { PickerManager } from '../../models';
+import type { MuiPickersAdapter, PickerManager, PickersTimezone, PickerValidDate, PickerValueType } from '../../models';
+import type { GetDefaultReferenceDateProps } from '../utils/getDefaultReferenceDate';
+import { InferNonNullablePickerValue, PickerValidValue } from "./value.js";
+import type { UseFieldInternalProps } from '../hooks/useField';
 export type PickerAnyManager = PickerManager<any, any, any, any, any>;
-type PickerManagerProperties<TManager extends PickerAnyManager> = TManager extends PickerManager<infer TValue, infer TEnableAccessibleFieldDOMStructure, infer TError, infer TFieldInternalProps, infer TFieldInternalPropsWithDefaults> ? {
+type PickerManagerProperties<TManager extends PickerAnyManager> = TManager extends PickerManager<infer TValue, infer TEnableAccessibleFieldDOMStructure, infer TError, infer TValidationProps, infer TFieldInternalProps> ? {
   value: TValue;
   enableAccessibleFieldDOMStructure: TEnableAccessibleFieldDOMStructure;
   error: TError;
+  validationProps: TValidationProps;
   fieldInternalProps: TFieldInternalProps;
-  fieldInternalPropsWithDefaults: TFieldInternalPropsWithDefaults;
 } : never;
 export type PickerManagerValue<TManager extends PickerAnyManager> = PickerManagerProperties<TManager>['value'];
 export type PickerManagerError<TManager extends PickerAnyManager> = PickerManagerProperties<TManager>['error'];
 export type PickerManagerFieldInternalProps<TManager extends PickerAnyManager> = PickerManagerProperties<TManager>['fieldInternalProps'];
-export type PickerManagerFieldInternalPropsWithDefaults<TManager extends PickerAnyManager> = PickerManagerProperties<TManager>['fieldInternalPropsWithDefaults'];
+export type PickerManagerValidationProps<TManager extends PickerAnyManager> = PickerManagerProperties<TManager>['validationProps'];
+export type PickerManagerFieldInternalPropsWithDefaults<TManager extends PickerAnyManager> = UseFieldInternalProps<PickerManagerValue<TManager>, PickerManagerEnableAccessibleFieldDOMStructure<TManager>, PickerManagerError<TManager>> & PickerManagerValidationProps<TManager>;
 export type PickerManagerEnableAccessibleFieldDOMStructure<TManager extends PickerAnyManager> = PickerManagerProperties<TManager>['enableAccessibleFieldDOMStructure'];
+export interface PickerValueManager<TValue extends PickerValidValue, TError> {
+  /**
+   * Determines if two values are equal.
+   * @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.
+   * @returns {boolean} A boolean indicating if the two values are equal.
+   */
+  areValuesEqual: (utils: MuiPickersAdapter, valueLeft: TValue, valueRight: TValue) => boolean;
+  /**
+   * Value to set when clicking the "Clear" button.
+   */
+  emptyValue: TValue;
+  /**
+   * Method returning the value to set when clicking the "Today" button
+   * @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 {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: PickerValueType) => 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.
+   * @param {TValue} params.value The value provided by the user.
+   * @param {GetDefaultReferenceDateProps} params.props The validation props needed to compute the reference value.
+   * @param {MuiPickersAdapter} params.utils The adapter.
+   * @param {number} params.granularity The granularity of the selection possible on this component.
+   * @param {PickersTimezone} params.timezone The current timezone.
+   * @param {() => PickerValidDate} params.getTodayDate The reference date to use if no reference date is passed to the component.
+   * @returns {TValue} The reference value to use for non-provided dates.
+   */
+  getInitialReferenceValue: (params: {
+    referenceDate: PickerValidDate | undefined;
+    value: TValue;
+    props: GetDefaultReferenceDateProps;
+    utils: MuiPickersAdapter;
+    granularity: number;
+    timezone: PickersTimezone;
+    getTodayDate?: () => PickerValidDate;
+  }) => InferNonNullablePickerValue<TValue>;
+  /**
+   * Method parsing the input value to replace all invalid dates by `null`.
+   * @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.
+   */
+  cleanValue: (utils: MuiPickersAdapter, value: TValue) => TValue;
+  /**
+   * Generates the new value, given the previous value and the new proposed value.
+   * @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.
+   * @returns {TValue} The new value.
+   */
+  valueReducer?: (utils: MuiPickersAdapter, lastValidDateValue: TValue, value: TValue) => TValue;
+  /**
+   * Compare two errors to know if they are equal.
+   * @template TError
+   * @param {TError} error The new error
+   * @param {TError | null} prevError The previous error
+   * @returns {boolean} `true` if the new error is different from the previous one.
+   */
+  isSameError: (error: TError, prevError: TError | null) => boolean;
+  /**
+   * Checks if the current error is empty or not.
+   * @template TError
+   * @param {TError} error The current error.
+   * @returns {boolean} `true` if the current error is not empty.
+   */
+  hasError: (error: TError) => boolean;
+  /**
+   * The value identifying no error, used to initialise the error state.
+   */
+  defaultErrorState: 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 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.
+     */
+  getTimezone: (utils: MuiPickersAdapter, value: TValue) => string | null;
+  /**
+     * Change the timezone of the dates inside a value.
+     * @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.
+     @returns {TValue} The value with the new dates in the new timezone.
+     */
+  setTimezone: (utils: MuiPickersAdapter, timezone: PickersTimezone, value: TValue) => TValue;
+}
 export {};

package/internals/models/props/basePickerProps.d.ts

@@ -3,13 +3,13 @@ import { SxProps } from '@mui/system';
 import { MakeOptional } from '@mui/x-internals/types';
 import { UsePickerBaseProps } from "../../hooks/usePicker/index.js";
 import { PickersInputComponentLocaleText } from "../../../locales/utils/pickersLocaleTextApi.js";
-import type { UsePickerViewsProps } from '../../hooks/usePicker/usePickerViews';
+import type { UsePickerProps } from '../../hooks/usePicker';
 import { DateOrTimeViewWithMeridiem } from "../common.js";
 import { PickerValidValue } from "../value.js";
 /**
  * Props common to all pickers after applying the default props on each picker.
  */
-export interface BasePickerProps<TValue extends PickerValidValue, TView extends DateOrTimeViewWithMeridiem, TError, TExternalProps extends UsePickerViewsProps<TValue, TView, any>> extends UsePickerBaseProps<TValue, TView, TError, TExternalProps> {
+export interface BasePickerProps<TValue extends PickerValidValue, TView extends DateOrTimeViewWithMeridiem, TError, TExternalProps extends UsePickerProps<TValue, TView, TError, any>> extends UsePickerBaseProps<TValue, TView, TError, TExternalProps> {
   className?: string;
   /**
    * The system prop that allows defining system overrides as well as additional CSS styles.

package/internals/models/props/time.d.ts

@@ -37,7 +37,7 @@ export interface BaseClockProps<TView extends TimeViewWithMeridiem> extends Expo
    */
   referenceDate?: PickerValidDate;
 }
-export interface DesktopOnlyTimePickerProps extends Omit<ExportedDigitalClockProps, 'timeStep'>, Omit<ExportedMultiSectionDigitalClockProps, 'timeSteps'> {
+export interface DigitalTimePickerProps extends Omit<ExportedDigitalClockProps, 'timeStep'>, Omit<ExportedMultiSectionDigitalClockProps, 'timeSteps'> {
   /**
    * Amount of time options below or at which the single column time renderer is used.
    * @default 24

package/internals/utils/date-time-utils.d.ts

@@ -1,7 +1,7 @@
 import { DefaultizedProps } from '@mui/x-internals/types';
 import { DateOrTimeView, MuiPickersAdapter } from "../../models/index.js";
 import { DateOrTimeViewWithMeridiem } from "../models/index.js";
-import { DesktopOnlyTimePickerProps } from "../models/props/time.js";
+import { DigitalTimePickerProps } from "../models/props/time.js";
 export declare const resolveDateTimeFormat: (utils: MuiPickersAdapter, {
   views,
   format,
@@ -11,7 +11,7 @@ export declare const resolveDateTimeFormat: (utils: MuiPickersAdapter, {
   views: readonly DateOrTimeViewWithMeridiem[];
   ampm: boolean;
 }, ignoreDateResolving?: boolean) => string;
-interface DefaultizedTimeViewsProps<TView = DateOrTimeView> extends DefaultizedProps<DesktopOnlyTimePickerProps, 'ampm'> {
+interface DefaultizedTimeViewsProps<TView = DateOrTimeView> extends DefaultizedProps<DigitalTimePickerProps, 'ampm'> {
   views: readonly TView[];
 }
 interface DefaultizedTimeViewsResponse<TView = DateOrTimeViewWithMeridiem> extends Required<Pick<DefaultizedTimeViewsProps<TView>, 'thresholdToRenderTimeInASingleColumn' | 'timeSteps' | 'views'>> {

package/internals/utils/valueManagers.d.ts

@@ -1,4 +1,4 @@
-import type { PickerValueManager } from '../hooks/usePicker';
+import type { PickerValueManager } from '../models';
 import { DateValidationError, TimeValidationError, DateTimeValidationError } from "../../models/index.js";
 import type { FieldValueManager } from '../hooks/useField';
 import { PickerValue } from "../models/index.js";

package/internals/utils/valueManagers.js

@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.singleItemValueManager = exports.singleItemFieldValueManager = void 0;
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
 var _objectWithoutPropertiesLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutPropertiesLoose"));
 var _dateUtils = require("./date-utils");
 var _getDefaultReferenceDate = require("./getDefaultReferenceDate");
@@ -36,24 +37,15 @@ const singleItemValueManager = exports.singleItemValueManager = {
   setTimezone: (utils, timezone, value) => value == null ? null : utils.setTimezone(value, timezone)
 };
 const singleItemFieldValueManager = exports.singleItemFieldValueManager = {
-  updateReferenceValue: (utils, value, prevReferenceValue) => !utils.isValid(value) ? prevReferenceValue : value,
-  getSectionsFromValue: (utils, date, prevSections, getSectionsFromDate) => {
-    const shouldReUsePrevDateSections = !utils.isValid(date) && !!prevSections;
-    if (shouldReUsePrevDateSections) {
-      return prevSections;
-    }
-    return getSectionsFromDate(date);
-  },
+  updateReferenceValue: (utils, value, prevReferenceValue) => utils.isValid(value) ? value : prevReferenceValue,
+  getSectionsFromValue: (date, getSectionsFromDate) => getSectionsFromDate(date),
   getV7HiddenInputValueFromSections: _useField.createDateStrForV7HiddenInputFromSections,
   getV6InputValueFromSections: _useField.createDateStrForV6InputFromSections,
-  getActiveDateManager: (utils, state) => ({
-    date: state.value,
-    referenceDate: state.referenceValue,
-    getSections: sections => sections,
-    getNewValuesFromNewActiveDate: newActiveDate => ({
-      value: newActiveDate,
-      referenceValue: utils.isValid(newActiveDate) ? newActiveDate : state.referenceValue
-    })
-  }),
-  parseValueStr: (valueStr, referenceValue, parseDate) => parseDate(valueStr.trim(), referenceValue)
+  parseValueStr: (valueStr, referenceValue, parseDate) => parseDate(valueStr.trim(), referenceValue),
+  getDateFromSection: value => value,
+  getDateSectionsFromValue: sections => sections,
+  updateDateInValue: (value, activeSection, activeDate) => activeDate,
+  clearDateSections: sections => sections.map(section => (0, _extends2.default)({}, section, {
+    value: ''
+  }))
 };

package/managers/useDateManager.d.ts

@@ -3,7 +3,7 @@ import { PickerManager, DateValidationError } from "../models/index.js";
 import { UseFieldInternalProps } from "../internals/hooks/useField/index.js";
 import { MuiPickersAdapterContextValue } from "../LocalizationProvider/LocalizationProvider.js";
 import { ExportedValidateDateProps, ValidateDatePropsToDefault, ValidateDateProps } from "../validation/validateDate.js";
-import { PickerValue } from "../internals/models/index.js";
+import { PickerManagerFieldInternalPropsWithDefaults, PickerValue } from "../internals/models/index.js";
 export declare function useDateManager<TEnableAccessibleFieldDOMStructure extends boolean = true>(parameters?: UseDateManagerParameters<TEnableAccessibleFieldDOMStructure>): UseDateManagerReturnValue<TEnableAccessibleFieldDOMStructure>;
 /**
  * Private utility function to get the default internal props for the fields with date editing.
@@ -13,12 +13,11 @@ export declare function getDateFieldInternalPropsDefaults(parameters: GetDateFie
 export interface UseDateManagerParameters<TEnableAccessibleFieldDOMStructure extends boolean> {
   enableAccessibleFieldDOMStructure?: TEnableAccessibleFieldDOMStructure;
 }
-export type UseDateManagerReturnValue<TEnableAccessibleFieldDOMStructure extends boolean> = PickerManager<PickerValue, TEnableAccessibleFieldDOMStructure, DateValidationError, DateManagerFieldInternalProps<TEnableAccessibleFieldDOMStructure>, DateManagerFieldInternalPropsWithDefaults<TEnableAccessibleFieldDOMStructure>>;
+export type UseDateManagerReturnValue<TEnableAccessibleFieldDOMStructure extends boolean> = PickerManager<PickerValue, TEnableAccessibleFieldDOMStructure, DateValidationError, ValidateDateProps, DateManagerFieldInternalProps<TEnableAccessibleFieldDOMStructure>>;
 export interface DateManagerFieldInternalProps<TEnableAccessibleFieldDOMStructure extends boolean> extends MakeOptional<UseFieldInternalProps<PickerValue, TEnableAccessibleFieldDOMStructure, DateValidationError>, 'format'>, ExportedValidateDateProps {}
-interface DateManagerFieldInternalPropsWithDefaults<TEnableAccessibleFieldDOMStructure extends boolean> extends UseFieldInternalProps<PickerValue, TEnableAccessibleFieldDOMStructure, DateValidationError>, ValidateDateProps {}
 type DateManagerFieldPropsToDefault = 'format' | ValidateDatePropsToDefault;
 interface GetDateFieldInternalPropsDefaultsParameters extends Pick<MuiPickersAdapterContextValue, 'defaultDates' | 'utils'> {
   internalProps: Pick<DateManagerFieldInternalProps<true>, DateManagerFieldPropsToDefault>;
 }
-interface GetDateFieldInternalPropsDefaultsReturnValue extends Pick<DateManagerFieldInternalPropsWithDefaults<true>, DateManagerFieldPropsToDefault> {}
+interface GetDateFieldInternalPropsDefaultsReturnValue extends Pick<PickerManagerFieldInternalPropsWithDefaults<UseDateManagerReturnValue<true>>, DateManagerFieldPropsToDefault> {}
 export {};

package/managers/useDateTimeManager.d.ts

@@ -4,7 +4,7 @@ import { UseFieldInternalProps } from "../internals/hooks/useField/index.js";
 import { MuiPickersAdapterContextValue } from "../LocalizationProvider/LocalizationProvider.js";
 import { AmPmProps } from "../internals/models/props/time.js";
 import { ExportedValidateDateTimeProps, ValidateDateTimeProps, ValidateDateTimePropsToDefault } from "../validation/validateDateTime.js";
-import { PickerValue } from "../internals/models/index.js";
+import { PickerManagerFieldInternalPropsWithDefaults, PickerValue } from "../internals/models/index.js";
 export declare function useDateTimeManager<TEnableAccessibleFieldDOMStructure extends boolean = true>(parameters?: UseDateTimeManagerParameters<TEnableAccessibleFieldDOMStructure>): UseDateTimeManagerReturnValue<TEnableAccessibleFieldDOMStructure>;
 /**
  * Private utility function to get the default internal props for the field with date time editing.
@@ -14,12 +14,11 @@ export declare function getDateTimeFieldInternalPropsDefaults(parameters: GetDat
 export interface UseDateTimeManagerParameters<TEnableAccessibleFieldDOMStructure extends boolean> {
   enableAccessibleFieldDOMStructure?: TEnableAccessibleFieldDOMStructure;
 }
-export type UseDateTimeManagerReturnValue<TEnableAccessibleFieldDOMStructure extends boolean> = PickerManager<PickerValue, TEnableAccessibleFieldDOMStructure, DateTimeValidationError, DateTimeManagerFieldInternalProps<TEnableAccessibleFieldDOMStructure>, DateTimeManagerFieldInternalPropsWithDefaults<TEnableAccessibleFieldDOMStructure>>;
+export type UseDateTimeManagerReturnValue<TEnableAccessibleFieldDOMStructure extends boolean> = PickerManager<PickerValue, TEnableAccessibleFieldDOMStructure, DateTimeValidationError, ValidateDateTimeProps, DateTimeManagerFieldInternalProps<TEnableAccessibleFieldDOMStructure>>;
 export interface DateTimeManagerFieldInternalProps<TEnableAccessibleFieldDOMStructure extends boolean> extends MakeOptional<UseFieldInternalProps<PickerValue, TEnableAccessibleFieldDOMStructure, DateTimeValidationError>, 'format'>, ExportedValidateDateTimeProps, AmPmProps {}
-interface DateTimeManagerFieldInternalPropsWithDefaults<TEnableAccessibleFieldDOMStructure extends boolean> extends UseFieldInternalProps<PickerValue, TEnableAccessibleFieldDOMStructure, DateTimeValidationError>, ValidateDateTimeProps {}
 type DateTimeManagerFieldPropsToDefault = 'format' | 'minTime' | 'maxTime' | ValidateDateTimePropsToDefault;
 interface GetDateTimeFieldInternalPropsDefaultsParameters extends Pick<MuiPickersAdapterContextValue, 'defaultDates' | 'utils'> {
   internalProps: Pick<DateTimeManagerFieldInternalProps<true>, DateTimeManagerFieldPropsToDefault | 'minDateTime' | 'maxDateTime' | 'ampm'>;
 }
-interface GetDateTimeFieldInternalPropsDefaultsReturnValue extends Pick<DateTimeManagerFieldInternalPropsWithDefaults<true>, DateTimeManagerFieldPropsToDefault | 'disableIgnoringDatePartForTimeValidation'> {}
+interface GetDateTimeFieldInternalPropsDefaultsReturnValue extends Pick<PickerManagerFieldInternalPropsWithDefaults<UseDateTimeManagerReturnValue<true>>, DateTimeManagerFieldPropsToDefault | 'disableIgnoringDatePartForTimeValidation'> {}
 export {};

package/managers/useTimeManager.d.ts

@@ -4,7 +4,7 @@ import { UseFieldInternalProps } from "../internals/hooks/useField/index.js";
 import { MuiPickersAdapterContextValue } from "../LocalizationProvider/LocalizationProvider.js";
 import { AmPmProps } from "../internals/models/props/time.js";
 import { ExportedValidateTimeProps, ValidateTimeProps, ValidateTimePropsToDefault } from "../validation/validateTime.js";
-import { PickerValue } from "../internals/models/index.js";
+import { PickerManagerFieldInternalPropsWithDefaults, PickerValue } from "../internals/models/index.js";
 export declare function useTimeManager<TEnableAccessibleFieldDOMStructure extends boolean = true>(parameters?: UseTimeManagerParameters<TEnableAccessibleFieldDOMStructure>): UseTimeManagerReturnValue<TEnableAccessibleFieldDOMStructure>;
 /**
  * Private utility function to get the default internal props for the fields with time editing.
@@ -14,12 +14,11 @@ export declare function getTimeFieldInternalPropsDefaults(parameters: GetTimeFie
 export interface UseTimeManagerParameters<TEnableAccessibleFieldDOMStructure extends boolean> extends AmPmProps {
   enableAccessibleFieldDOMStructure?: TEnableAccessibleFieldDOMStructure;
 }
-export type UseTimeManagerReturnValue<TEnableAccessibleFieldDOMStructure extends boolean> = PickerManager<PickerValue, TEnableAccessibleFieldDOMStructure, TimeValidationError, TimeManagerFieldInternalProps<TEnableAccessibleFieldDOMStructure>, TimeManagerFieldInternalPropsWithDefaults<TEnableAccessibleFieldDOMStructure>>;
+export type UseTimeManagerReturnValue<TEnableAccessibleFieldDOMStructure extends boolean> = PickerManager<PickerValue, TEnableAccessibleFieldDOMStructure, TimeValidationError, ValidateTimeProps, TimeManagerFieldInternalProps<TEnableAccessibleFieldDOMStructure>>;
 export interface TimeManagerFieldInternalProps<TEnableAccessibleFieldDOMStructure extends boolean> extends MakeOptional<UseFieldInternalProps<PickerValue, TEnableAccessibleFieldDOMStructure, TimeValidationError>, 'format'>, ExportedValidateTimeProps, AmPmProps {}
-interface TimeManagerFieldInternalPropsWithDefaults<TEnableAccessibleFieldDOMStructure extends boolean> extends UseFieldInternalProps<PickerValue, TEnableAccessibleFieldDOMStructure, TimeValidationError>, ValidateTimeProps {}
 type TimeManagerFieldPropsToDefault = 'format' | ValidateTimePropsToDefault;
 interface GetTimeFieldInternalPropsDefaultsParameters extends Pick<MuiPickersAdapterContextValue, 'utils'> {
   internalProps: Pick<TimeManagerFieldInternalProps<true>, TimeManagerFieldPropsToDefault | 'ampm'>;
 }
-interface GetTimeFieldInternalPropsDefaultsReturnValue extends Pick<TimeManagerFieldInternalPropsWithDefaults<true>, TimeManagerFieldPropsToDefault> {}
+interface GetTimeFieldInternalPropsDefaultsReturnValue extends Pick<PickerManagerFieldInternalPropsWithDefaults<UseTimeManagerReturnValue<true>>, TimeManagerFieldPropsToDefault> {}
 export {};

package/models/adapters.d.ts

@@ -70,7 +70,7 @@ export interface AdapterFormats {
   /**
    * A keyboard input friendly date format.
    * Used in the date fields.
-   * @example "02/13/2020
+   * @example "02/13/2020"
    */
   keyboardDate: string;
   /**
@@ -161,6 +161,7 @@ export interface MuiPickersAdapter<TLocale = any> {
   date<T extends string | null | undefined>(value?: T, timezone?: PickersTimezone): DateBuilderReturnType<T>;
   /**
    * Creates an invalid date in the date library format.
+   * @deprecated This method will be removed in the next major release (v9.0.0).
    * @returns {PickerValidDate} The invalid date.
    */
   getInvalidDate(): PickerValidDate;

package/models/manager.d.ts

@@ -1,7 +1,6 @@
 import type { FieldValueManager, UseFieldInternalProps } from '../internals/hooks/useField';
-import type { PickerValueManager } from '../internals/hooks/usePicker';
 import type { UseLocalizationContextReturnValue } from '../internals/hooks/useUtils';
-import type { PickerValidValue } from '../internals/models';
+import type { PickerValidValue, PickerValueManager } from '../internals/models';
 import type { Validator } from '../validation';
 import type { PickerValueType } from './common';
 /**
@@ -22,7 +21,7 @@ import type { PickerValueType } from './common';
  * });
  * ```
  */
-export interface PickerManager<TValue extends PickerValidValue, TEnableAccessibleFieldDOMStructure extends boolean, TError, TFieldInternalProps extends {}, TFieldInternalPropsWithDefaults extends UseFieldInternalProps<TValue, TEnableAccessibleFieldDOMStructure, TError>> {
+export interface PickerManager<TValue extends PickerValidValue, TEnableAccessibleFieldDOMStructure extends boolean, TError, TValidationProps extends {}, TFieldInternalProps extends {}> {
   /**
    * The type of the value (e.g. 'date', 'date-time', 'time').
    */
@@ -44,7 +43,7 @@ export interface PickerManager<TValue extends PickerValidValue, TEnableAccessibl
    * });
    * ```
    */
-  validator: Validator<TValue, TError, TFieldInternalPropsWithDefaults>;
+  validator: Validator<TValue, TError, TValidationProps>;
   /**
    * Object containing basic methods to interact with the value of the picker or field.
    * This property is not part of the public API and should not be used directly.
@@ -70,7 +69,7 @@ export interface PickerManager<TValue extends PickerValidValue, TEnableAccessibl
    * @param {ApplyDefaultsToFieldInternalPropsParameters<TFieldInternalProps>} parameters The parameters to apply the defaults.
    * @returns {TFieldInternalPropsWithDefaults} The field internal props with the defaults applied.
    */
-  internal_applyDefaultsToFieldInternalProps: (parameters: ApplyDefaultsToFieldInternalPropsParameters<TFieldInternalProps>) => TFieldInternalPropsWithDefaults;
+  internal_applyDefaultsToFieldInternalProps: (parameters: ApplyDefaultsToFieldInternalPropsParameters<TFieldInternalProps>) => UseFieldInternalProps<TValue, TEnableAccessibleFieldDOMStructure, TError> & TValidationProps;
   /**
    * Returns the aria-label to apply on the button that opens the picker.
    * @param {GetOpenPickerButtonAriaLabelParameters<TValue>} params The parameters to get the aria-label.

package/modern/DatePicker/shared.d.ts

@@ -5,7 +5,7 @@ import { DateValidationError, DateView } from "../models/index.js";
 import { BasePickerInputProps } from "../internals/models/props/basePickerProps.js";
 import { LocalizedComponent } from "../locales/utils/pickersLocaleTextApi.js";
 import { DatePickerToolbarProps, ExportedDatePickerToolbarProps } from "./DatePickerToolbar.js";
-import { PickerViewRendererLookup } from "../internals/hooks/usePicker/usePickerViews.js";
+import { PickerViewRendererLookup } from "../internals/hooks/usePicker/index.js";
 import { DateViewRendererProps } from "../dateViewRenderers/index.js";
 import { PickerValue } from "../internals/models/index.js";
 import { ValidateDatePropsToDefault } from "../validation/validateDate.js";