@mui/x-date-pickers 9.0.0-alpha.1 → 9.0.0-alpha.2

package/internals/index.d.mts

@@ -0,0 +1,75 @@
+export { PickersArrowSwitcher } from "./components/PickersArrowSwitcher/PickersArrowSwitcher.mjs";
+export type { ExportedPickersArrowSwitcherProps, PickersArrowSwitcherSlots, PickersArrowSwitcherSlotProps } from "./components/PickersArrowSwitcher/index.mjs";
+export { PickerFieldUI, PickerFieldUIContextProvider, cleanFieldResponse, useFieldTextFieldProps, PickerFieldUIContext, mergeSlotProps } from "./components/PickerFieldUI.mjs";
+export type { ExportedPickerFieldUIProps, PickerFieldUISlots, PickerFieldUISlotProps, PickerFieldUISlotsFromContext, PickerFieldUISlotPropsFromContext } from "./components/PickerFieldUI.mjs";
+export { PickerProvider } from "./components/PickerProvider.mjs";
+export type { PickerContextValue } from "./components/PickerProvider.mjs";
+export { PickersModalDialog } from "./components/PickersModalDialog.mjs";
+export type { PickersModalDialogSlots, PickersModalDialogSlotProps } from "./components/PickersModalDialog.mjs";
+export { PickerPopper } from "./components/PickerPopper/PickerPopper.mjs";
+export type { PickerPopperSlots, PickerPopperSlotProps } from "./components/PickerPopper/PickerPopper.mjs";
+export { pickerPopperClasses } from "./components/PickerPopper/pickerPopperClasses.mjs";
+export { PickersToolbar } from "./components/PickersToolbar.mjs";
+export type { PickersToolbarProps } from "./components/PickersToolbar.mjs";
+export { pickersToolbarClasses } from "./components/pickersToolbarClasses.mjs";
+export type { PickersToolbarClassKey, PickersToolbarClasses } from "./components/pickersToolbarClasses.mjs";
+export type { PickersToolbarButtonProps } from "./components/PickersToolbarButton.mjs";
+export { pickersToolbarButtonClasses } from "./components/pickersToolbarButtonClasses.mjs";
+export type { PickersToolbarButtonClassKey, PickersToolbarButtonClasses } from "./components/pickersToolbarButtonClasses.mjs";
+export { PickersToolbarText } from "./components/PickersToolbarText.mjs";
+export type { PickersToolbarTextProps, ExportedPickersToolbarTextProps } from "./components/PickersToolbarText.mjs";
+export { pickersToolbarTextClasses } from "./components/pickersToolbarTextClasses.mjs";
+export type { PickersToolbarTextClassKey, PickersToolbarTextClasses } from "./components/pickersToolbarTextClasses.mjs";
+export { pickersArrowSwitcherClasses } from "./components/PickersArrowSwitcher/pickersArrowSwitcherClasses.mjs";
+export type { PickersArrowSwitcherClassKey, PickersArrowSwitcherClasses } from "./components/PickersArrowSwitcher/pickersArrowSwitcherClasses.mjs";
+export { PickersToolbarButton } from "./components/PickersToolbarButton.mjs";
+export { DAY_MARGIN, DIALOG_WIDTH, VIEW_HEIGHT, MULTI_SECTION_CLOCK_SECTION_WIDTH } from "./constants/dimensions.mjs";
+export { useControlledValue } from "./hooks/useControlledValue.mjs";
+export type { DesktopOnlyPickerProps } from "./hooks/useDesktopPicker/index.mjs";
+export { useField, useFieldInternalPropsWithDefaults, createDateStrForV7HiddenInputFromSections, createDateStrForV6InputFromSections } from "./hooks/useField/index.mjs";
+export type { UseFieldInternalProps, UseFieldParameters, UseFieldReturnValue, FieldValueManager, FieldChangeHandler, FieldChangeHandlerContext } from "./hooks/useField/index.mjs";
+export { useFieldOwnerState } from "./hooks/useFieldOwnerState.mjs";
+export type { MobileOnlyPickerProps } from "./hooks/useMobilePicker/index.mjs";
+export { useNullableFieldPrivateContext } from "./hooks/useNullableFieldPrivateContext.mjs";
+export { useNullablePickerContext } from "./hooks/useNullablePickerContext.mjs";
+export { usePicker } from "./hooks/usePicker/index.mjs";
+export type { UsePickerParameters, UsePickerProps, PickerViewsRendererProps, PickerSelectionState, PickerViewRendererLookup, PickerRendererInterceptorProps, PickerViewRenderer, UsePickerNonStaticProps } from "./hooks/usePicker/index.mjs";
+export { usePickerPrivateContext } from "./hooks/usePickerPrivateContext.mjs";
+export { useStaticPicker } from "./hooks/useStaticPicker/index.mjs";
+export type { StaticOnlyPickerProps, UseStaticPickerSlots, UseStaticPickerSlotProps } from "./hooks/useStaticPicker/index.mjs";
+export { useToolbarOwnerState } from "./hooks/useToolbarOwnerState.mjs";
+export type { PickerToolbarOwnerState } from "./hooks/useToolbarOwnerState.mjs";
+export { useDefaultDates, useNow } from "./hooks/useUtils.mjs";
+export { useLocalizationContext } from "../hooks/usePickerAdapter.mjs";
+export type { ExportedUseViewsOptions, UseViewsOptions } from "./hooks/useViews.mjs";
+export { useViews } from "./hooks/useViews.mjs";
+export { usePreviousMonthDisabled, useNextMonthDisabled } from "./hooks/date-helpers-hooks.mjs";
+export type { PickerAnyManager, PickerManagerFieldInternalProps, PickerManagerFieldInternalPropsWithDefaults, PickerManagerEnableAccessibleFieldDOMStructure, PickerManagerError, PickerValueManager } from "./models/manager.mjs";
+export type { RangePosition } from "./models/pickers.mjs";
+export type { BaseSingleInputFieldProps, FieldRangeSection } from "./models/fields.mjs";
+export type { BasePickerProps, BasePickerInputProps } from "./models/props/basePickerProps.mjs";
+export type { BaseClockProps, ExportedBaseClockProps, DigitalTimePickerProps, AmPmProps } from "./models/props/time.mjs";
+export type { ExportedBaseTabsProps } from "./models/props/tabs.mjs";
+export type { BaseToolbarProps, ExportedBaseToolbarProps } from "./models/props/toolbar.mjs";
+export type { FormProps } from "./models/formProps.mjs";
+export type { PickerVariant, TimeViewWithMeridiem, DateOrTimeViewWithMeridiem } from "./models/common.mjs";
+export type { BaseDateValidationProps, BaseTimeValidationProps, TimeValidationProps, MonthValidationProps, YearValidationProps, DayValidationProps, DateTimeValidationProps } from "./models/validation.mjs";
+export type { PickerValue, PickerRangeValue, PickerNonNullableRangeValue, InferNonNullablePickerValue, PickerValidValue } from "./models/value.mjs";
+export type { ComponentsOverrides } from "./models/helpers.mjs";
+export { createStepNavigation } from "./utils/createStepNavigation.mjs";
+export { applyDefaultDate, replaceInvalidDateByNull, areDatesEqual, getTodayDate, isDatePickerView, mergeDateAndTime, formatMeridiem, DATE_VIEWS } from "./utils/date-utils.mjs";
+export { getDefaultReferenceDate } from "./utils/getDefaultReferenceDate.mjs";
+export { isTimeView, isInternalTimeView, resolveTimeFormat, getMeridiem, TIME_VIEWS } from "./utils/time-utils.mjs";
+export { resolveTimeViewsResponse, resolveDateTimeFormat } from "./utils/date-time-utils.mjs";
+export { executeInTheNextEventLoopTick, getActiveElement, onSpaceOrEnter, mergeSx, DEFAULT_DESKTOP_MODE_MEDIA_QUERY } from "./utils/utils.mjs";
+export { useReduceAnimations } from "./hooks/useReduceAnimations.mjs";
+export { applyDefaultViewProps } from "./utils/views.mjs";
+export { DayCalendar } from "../DateCalendar/DayCalendar.mjs";
+export type { DayCalendarProps, DayCalendarSlots, DayCalendarSlotProps, ExportedDayCalendarProps } from "../DateCalendar/DayCalendar.mjs";
+export type { ExportedDateCalendarProps } from "../DateCalendar/DateCalendar.types.mjs";
+export { useCalendarState } from "../DateCalendar/useCalendarState.mjs";
+export { DateTimePickerToolbarOverrideContext } from "../DateTimePicker/DateTimePickerToolbar.mjs";
+export { usePickerDayOwnerState } from "../PickersDay/usePickerDayOwnerState.mjs";
+export { useApplyDefaultValuesToDateValidationProps } from "../managers/useDateManager.mjs";
+export { useApplyDefaultValuesToTimeValidationProps } from "../managers/useTimeManager.mjs";
+export { useApplyDefaultValuesToDateTimeValidationProps } from "../managers/useDateTimeManager.mjs";

package/internals/index.mjs

@@ -0,0 +1,42 @@
+export { PickersArrowSwitcher } from "./components/PickersArrowSwitcher/PickersArrowSwitcher.mjs";
+export { PickerFieldUI, PickerFieldUIContextProvider, cleanFieldResponse, useFieldTextFieldProps, PickerFieldUIContext, mergeSlotProps } from "./components/PickerFieldUI.mjs";
+export { PickerProvider } from "./components/PickerProvider.mjs";
+export { PickersModalDialog } from "./components/PickersModalDialog.mjs";
+export { PickerPopper } from "./components/PickerPopper/PickerPopper.mjs";
+export { pickerPopperClasses } from "./components/PickerPopper/pickerPopperClasses.mjs";
+export { PickersToolbar } from "./components/PickersToolbar.mjs";
+export { pickersToolbarClasses } from "./components/pickersToolbarClasses.mjs";
+export { pickersToolbarButtonClasses } from "./components/pickersToolbarButtonClasses.mjs";
+export { PickersToolbarText } from "./components/PickersToolbarText.mjs";
+export { pickersToolbarTextClasses } from "./components/pickersToolbarTextClasses.mjs";
+export { pickersArrowSwitcherClasses } from "./components/PickersArrowSwitcher/pickersArrowSwitcherClasses.mjs";
+export { PickersToolbarButton } from "./components/PickersToolbarButton.mjs";
+export { DAY_MARGIN, DIALOG_WIDTH, VIEW_HEIGHT, MULTI_SECTION_CLOCK_SECTION_WIDTH } from "./constants/dimensions.mjs";
+export { useControlledValue } from "./hooks/useControlledValue.mjs";
+export { useField, useFieldInternalPropsWithDefaults, createDateStrForV7HiddenInputFromSections, createDateStrForV6InputFromSections } from "./hooks/useField/index.mjs";
+export { useFieldOwnerState } from "./hooks/useFieldOwnerState.mjs";
+export { useNullableFieldPrivateContext } from "./hooks/useNullableFieldPrivateContext.mjs";
+export { useNullablePickerContext } from "./hooks/useNullablePickerContext.mjs";
+export { usePicker } from "./hooks/usePicker/index.mjs";
+export { usePickerPrivateContext } from "./hooks/usePickerPrivateContext.mjs";
+export { useStaticPicker } from "./hooks/useStaticPicker/index.mjs";
+export { useToolbarOwnerState } from "./hooks/useToolbarOwnerState.mjs";
+export { useDefaultDates, useNow } from "./hooks/useUtils.mjs";
+export { useLocalizationContext } from "../hooks/usePickerAdapter.mjs";
+export { useViews } from "./hooks/useViews.mjs";
+export { usePreviousMonthDisabled, useNextMonthDisabled } from "./hooks/date-helpers-hooks.mjs";
+export { createStepNavigation } from "./utils/createStepNavigation.mjs";
+export { applyDefaultDate, replaceInvalidDateByNull, areDatesEqual, getTodayDate, isDatePickerView, mergeDateAndTime, formatMeridiem, DATE_VIEWS } from "./utils/date-utils.mjs";
+export { getDefaultReferenceDate } from "./utils/getDefaultReferenceDate.mjs";
+export { isTimeView, isInternalTimeView, resolveTimeFormat, getMeridiem, TIME_VIEWS } from "./utils/time-utils.mjs";
+export { resolveTimeViewsResponse, resolveDateTimeFormat } from "./utils/date-time-utils.mjs";
+export { executeInTheNextEventLoopTick, getActiveElement, onSpaceOrEnter, mergeSx, DEFAULT_DESKTOP_MODE_MEDIA_QUERY } from "./utils/utils.mjs";
+export { useReduceAnimations } from "./hooks/useReduceAnimations.mjs";
+export { applyDefaultViewProps } from "./utils/views.mjs";
+export { DayCalendar } from "../DateCalendar/DayCalendar.mjs";
+export { useCalendarState } from "../DateCalendar/useCalendarState.mjs";
+export { DateTimePickerToolbarOverrideContext } from "../DateTimePicker/DateTimePickerToolbar.mjs";
+export { usePickerDayOwnerState } from "../PickersDay/usePickerDayOwnerState.mjs";
+export { useApplyDefaultValuesToDateValidationProps } from "../managers/useDateManager.mjs";
+export { useApplyDefaultValuesToTimeValidationProps } from "../managers/useTimeManager.mjs";
+export { useApplyDefaultValuesToDateTimeValidationProps } from "../managers/useDateTimeManager.mjs";

package/internals/models/common.d.mts

@@ -0,0 +1,5 @@
+import { DateView, TimeView } from "../../models/views.mjs";
+export type PickerOrientation = 'portrait' | 'landscape';
+export type PickerVariant = 'mobile' | 'desktop';
+export type TimeViewWithMeridiem = TimeView | 'meridiem';
+export type DateOrTimeViewWithMeridiem = DateView | TimeViewWithMeridiem;

package/internals/models/fields.d.mts

@@ -0,0 +1,12 @@
+import type { FieldSection } from "../../models/index.mjs";
+import { RangePosition } from "./pickers.mjs";
+export interface FieldRangeSection extends FieldSection {
+  dateName: RangePosition;
+}
+/**
+ * Props the single input field can receive when used inside a Picker.
+ * Only contains what the MUI components are passing to the field, not what users can pass using the `props.slotProps.field`.
+ */
+export interface BaseSingleInputFieldProps {
+  id?: string;
+}

package/internals/models/index.d.mts

@@ -0,0 +1,5 @@
+export * from "./fields.mjs";
+export * from "./common.mjs";
+export * from "./value.mjs";
+export * from "./formProps.mjs";
+export * from "./manager.mjs";

package/internals/models/index.mjs

@@ -0,0 +1,5 @@
+export * from "./fields.mjs";
+export * from "./common.mjs";
+export * from "./value.mjs";
+export * from "./formProps.mjs";
+export * from "./manager.mjs";

package/internals/models/manager.d.mts

@@ -0,0 +1,119 @@
+import type { MuiPickersAdapter, PickerManager, PickersTimezone, PickerValidDate, PickerValueType } from "../../models/index.mjs";
+import type { GetDefaultReferenceDateProps } from "../utils/getDefaultReferenceDate.mjs";
+import { InferNonNullablePickerValue, PickerRangeValue, PickerValidValue } from "./value.mjs";
+import type { UseFieldInternalProps } from "../hooks/useField/index.mjs";
+export type PickerAnyManager = PickerManager<any, any, any, any, any>;
+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;
+} : 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 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} adapter The Picker date adapter instance.
+   * @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: (adapter: 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} adapter The Picker date adapter instance.
+   * @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: (adapter: 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 | 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.adapter The Picker date adapter instance.
+   * @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?: TValue extends PickerRangeValue ? TValue | PickerValidDate : PickerValidDate;
+    value: TValue;
+    props: GetDefaultReferenceDateProps;
+    adapter: 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} adapter The Picker date adapter instance.
+   * @param {TValue} value The value to parse.
+   * @returns {TValue} The value without invalid date.
+   */
+  cleanValue: (adapter: 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} adapter The Picker date adapter instance.
+   * @param {TValue} lastValidDateValue The last valid value.
+   * @param {TValue} value The proposed value.
+   * @returns {TValue} The new value.
+   */
+  valueReducer?: (adapter: 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 initialize the error state.
+   */
+  defaultErrorState: TError;
+  /**
+     * Return the timezone of the date inside a value.
+     * When used on a range Picker, throw an error 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} adapter The Picker date adapter instance.
+     @param {TValue} value The current value.
+     @returns {string | null} The timezone of the current value.
+     */
+  getTimezone: (adapter: 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} adapter The Picker date adapter instance.
+     @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: (adapter: MuiPickersAdapter, timezone: PickersTimezone, value: TValue) => TValue;
+}
+export {};

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

@@ -0,0 +1,27 @@
+import { Theme } from '@mui/material/styles';
+import { SxProps } from '@mui/system';
+import { MakeOptional } from '@mui/x-internals/types';
+import { UsePickerBaseProps } from "../../hooks/usePicker/index.mjs";
+import { PickersInputComponentLocaleText } from "../../../locales/utils/pickersLocaleTextApi.mjs";
+import type { UsePickerProps } from "../../hooks/usePicker/index.mjs";
+import { DateOrTimeViewWithMeridiem } from "../common.mjs";
+import { PickerValidValue } from "../value.mjs";
+/**
+ * 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 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.
+   */
+  sx?: SxProps<Theme>;
+  /**
+   * Locale for components texts.
+   * Allows overriding texts coming from `LocalizationProvider` and `theme`.
+   */
+  localeText?: PickersInputComponentLocaleText;
+}
+/**
+ * Props common to all pickers before applying the default props on each Picker.
+ */
+export interface BasePickerInputProps<TValue extends PickerValidValue, TView extends DateOrTimeViewWithMeridiem, TError> extends Omit<MakeOptional<BasePickerProps<TValue, TView, TError, any>, 'openTo' | 'views'>, 'viewRenderers'> {}

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

@@ -0,0 +1,77 @@
+import { SxProps, Theme } from '@mui/material/styles';
+import { PickerValidDate, TimeStepOptions, TimezoneProps } from "../../../models/index.mjs";
+import type { ExportedDigitalClockProps } from "../../../DigitalClock/DigitalClock.types.mjs";
+import type { ExportedMultiSectionDigitalClockProps } from "../../../MultiSectionDigitalClock/MultiSectionDigitalClock.types.mjs";
+import type { ExportedUseViewsOptions } from "../../hooks/useViews.mjs";
+import { TimeViewWithMeridiem } from "../common.mjs";
+import { ExportedValidateTimeProps } from "../../../validation/validateTime.mjs";
+import { FormProps } from "../formProps.mjs";
+import { PickerValue } from "../value.mjs";
+export interface AmPmProps {
+  /**
+   * 12h/24h view for hour selection clock.
+   * @default adapter.is12HourCycleInCurrentLocale()
+   */
+  ampm?: boolean;
+}
+export interface ExportedBaseClockProps extends ExportedValidateTimeProps, TimezoneProps, AmPmProps {}
+export interface BaseClockProps<TView extends TimeViewWithMeridiem> extends ExportedUseViewsOptions<PickerValue, TView>, ExportedBaseClockProps, FormProps {
+  className?: string;
+  /**
+   * The system prop that allows defining system overrides as well as additional CSS styles.
+   */
+  sx?: SxProps<Theme>;
+  /**
+   * The selected value.
+   * Used when the component is controlled.
+   */
+  value?: PickerValidDate | null;
+  /**
+   * The default selected value.
+   * Used when the component is not controlled.
+   */
+  defaultValue?: PickerValidDate | null;
+  /**
+   * The date used to generate the new value when both `value` and `defaultValue` are empty.
+   * @default The closest valid time using the validation props, except callbacks such as `shouldDisableTime`.
+   */
+  referenceDate?: PickerValidDate;
+}
+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
+   */
+  thresholdToRenderTimeInASingleColumn?: number;
+  /**
+   * The time steps between two time unit options.
+   * For example, if `timeSteps.minutes = 8`, then the available minute options will be `[0, 8, 16, 24, 32, 40, 48, 56]`.
+   * When single column time renderer is used, only `timeSteps.minutes` will be used.
+   * @default{ hours: 1, minutes: 5, seconds: 5 }
+   */
+  timeSteps?: TimeStepOptions;
+}
+interface DigitalClockOnlyBaseProps {
+  /**
+   * If `true`, disabled digital clock items will not be rendered.
+   * @default false
+   */
+  skipDisabled?: boolean;
+}
+export interface DigitalClockOnlyProps extends DigitalClockOnlyBaseProps {
+  /**
+   * The time steps between two time options.
+   * For example, if `timeStep = 45`, then the available time options will be `[00:00, 00:45, 01:30, 02:15, 03:00, etc.]`.
+   * @default 30
+   */
+  timeStep?: number;
+}
+export interface MultiSectionDigitalClockOnlyProps extends DigitalClockOnlyBaseProps {
+  /**
+   * The time steps between two time unit options.
+   * For example, if `timeSteps.minutes = 8`, then the available minute options will be `[0, 8, 16, 24, 32, 40, 48, 56]`.
+   * @default{ hours: 1, minutes: 5, seconds: 5 }
+   */
+  timeSteps?: TimeStepOptions;
+}
+export {};

package/internals/models/validation.d.mts

@@ -0,0 +1,116 @@
+import type { PickerValidDate, TimeView } from "../../models/index.mjs";
+interface FutureAndPastValidationProps {
+  /**
+   * If `true`, disable values before the current date for date components, time for time components and both for date time components.
+   * @default false
+   */
+  disablePast?: boolean;
+  /**
+   * If `true`, disable values after the current date for date components, time for time components and both for date time components.
+   * @default false
+   */
+  disableFuture?: boolean;
+}
+/**
+ * Validation props common to all the time views.
+ * All these props have a default value when used inside a Field / Picker / Clock.
+ */
+export interface BaseTimeValidationProps extends FutureAndPastValidationProps {}
+/**
+ * Props used to validate a time value.
+ */
+export interface TimeValidationProps {
+  /**
+   * Minimal selectable time.
+   * The date part of the object will be ignored unless `props.disableIgnoringDatePartForTimeValidation === true`.
+   */
+  minTime?: PickerValidDate;
+  /**
+   * Maximal selectable time.
+   * The date part of the object will be ignored unless `props.disableIgnoringDatePartForTimeValidation === true`.
+   */
+  maxTime?: PickerValidDate;
+  /**
+   * Step over minutes.
+   * @default 1
+   */
+  minutesStep?: number;
+  /**
+   * Disable specific time.
+   * @param {PickerValidDate} value The value to check.
+   * @param {TimeView} view The clock type of the timeValue.
+   * @returns {boolean} If `true` the time will be disabled.
+   */
+  shouldDisableTime?: (value: PickerValidDate, view: TimeView) => boolean;
+  /**
+   * Do not ignore date part when validating min/max time.
+   * @default false
+   */
+  disableIgnoringDatePartForTimeValidation?: boolean;
+}
+/**
+ * Validation props common to all the date views.
+ * All these props have a default value when used inside a Field / Picker / Calendar.
+ */
+export interface BaseDateValidationProps extends FutureAndPastValidationProps {
+  /**
+   * Maximal selectable date.
+   * @default 2099-12-31
+   */
+  maxDate?: PickerValidDate;
+  /**
+   * Minimal selectable date.
+   * @default 1900-01-01
+   */
+  minDate?: PickerValidDate;
+}
+/**
+ * Props used to validate a date value (validates day + month + year).
+ */
+export interface DayValidationProps {
+  /**
+   * Disable specific date.
+   *
+   * Warning: This function can be called multiple times (for example when rendering date calendar, checking if focus can be moved to a certain date, etc.). Expensive computations can impact performance.
+   *
+   * @param {PickerValidDate} day The date to test.
+   * @returns {boolean} If `true` the date will be disabled.
+   */
+  shouldDisableDate?: (day: PickerValidDate) => boolean;
+}
+/**
+ * Props used to validate a month value
+ */
+export interface MonthValidationProps {
+  /**
+   * Disable specific month.
+   * @param {PickerValidDate} month The month to test.
+   * @returns {boolean} If `true`, the month will be disabled.
+   */
+  shouldDisableMonth?: (month: PickerValidDate) => boolean;
+}
+/**
+ * Props used to validate a year value
+ */
+export interface YearValidationProps {
+  /**
+   * Disable specific year.
+   * @param {PickerValidDate} year The year to test.
+   * @returns {boolean} If `true`, the year will be disabled.
+   */
+  shouldDisableYear?: (year: PickerValidDate) => boolean;
+}
+/**
+ * Props used to validate a date time value.
+ */
+export interface DateTimeValidationProps {
+  /**
+   * Minimal selectable moment of time with binding to date, to set min time in each day use `minTime`.
+   */
+  minDateTime?: PickerValidDate;
+  /**
+   * Maximal selectable moment of time with binding to date, to set max time in each day use `maxTime`.
+   */
+  maxDateTime?: PickerValidDate;
+}
+export {};

package/internals/models/value.d.mts

@@ -0,0 +1,12 @@
+import { PickerValidDate } from "../../models/pickers.mjs";
+/**
+ * The type that the `value` and `defaultValue` props can receive on non-range components (date, time and date-time).
+ */
+export type PickerValue = PickerValidDate | null;
+/**
+ * The type that the `value` and `defaultValue` props can receive on range components (date-range, time-range and date-time-range).
+ */
+export type PickerRangeValue = [PickerValidDate | null, PickerValidDate | null];
+export type PickerNonNullableRangeValue = [PickerValidDate, PickerValidDate];
+export type PickerValidValue = PickerValue | PickerRangeValue;
+export type InferNonNullablePickerValue<TValue extends PickerValidValue> = TValue extends PickerRangeValue ? TValue extends PickerValue ? PickerValidDate | PickerNonNullableRangeValue : PickerNonNullableRangeValue : PickerValidDate;

package/internals/utils/createNonRangePickerStepNavigation.d.mts

@@ -0,0 +1,13 @@
+import { DateOrTimeViewWithMeridiem } from "../models/common.mjs";
+export declare function createNonRangePickerStepNavigation(parameters: CreateNonRangePickerStepNavigationParameters): import("./createStepNavigation.mjs").CreateStepNavigationReturnValue;
+export interface PickerStep {
+  /**
+   * The views that are handled inside this step.
+   * If null, all views are handled by this step.
+   */
+  views: readonly DateOrTimeViewWithMeridiem[] | null;
+}
+interface CreateNonRangePickerStepNavigationParameters {
+  steps: PickerStep[] | null;
+}
+export {};

package/internals/utils/createNonRangePickerStepNavigation.mjs

@@ -0,0 +1,24 @@
+import { createStepNavigation } from "./createStepNavigation.mjs";
+export function createNonRangePickerStepNavigation(parameters) {
+  const {
+    steps
+  } = parameters;
+  return createStepNavigation({
+    steps,
+    isViewMatchingStep: (view, step) => {
+      return step.views == null || step.views.includes(view);
+    },
+    onStepChange: ({
+      step,
+      defaultView,
+      setView,
+      view,
+      views
+    }) => {
+      const targetView = step.views == null ? defaultView : step.views.find(viewBis => views.includes(viewBis));
+      if (targetView !== view) {
+        setView(targetView);
+      }
+    }
+  });
+}

package/internals/utils/createStepNavigation.d.mts

@@ -0,0 +1,49 @@
+import { DateOrTimeViewWithMeridiem } from "../models/index.mjs";
+export declare const DEFAULT_STEP_NAVIGATION: {
+  hasNextStep: boolean;
+  hasSeveralSteps: boolean;
+  goToNextStep: () => void;
+  areViewsInSameStep: () => boolean;
+};
+/**
+ * Create an object that determines whether there is a next step and allows to go to the next step.
+ * @param {CreateStepNavigationParameters<TStep>} parameters The parameters of the createStepNavigation function
+ * @returns {CreateStepNavigationReturnValue} The return value of the createStepNavigation function
+ */
+export declare function createStepNavigation<TStep extends {}>(parameters: CreateStepNavigationParameters<TStep>): CreateStepNavigationReturnValue;
+interface CreateStepNavigationParameters<TStep extends {}> {
+  steps: TStep[] | null;
+  isViewMatchingStep: (view: DateOrTimeViewWithMeridiem, step: TStep) => boolean;
+  onStepChange: (parameters: UseRangePickerStepNavigationOnStepChangeParameters<TStep>) => void;
+}
+export type CreateStepNavigationReturnValue = (parameters: CreateStepNavigationReturnValueParameters) => {
+  /**
+   * Whether there is a next step.
+   */
+  hasNextStep: boolean;
+  /**
+   * Whether there are several steps.
+   */
+  hasSeveralSteps: boolean;
+  /**
+   * Go to the next step if any.
+   */
+  goToNextStep: () => void;
+  /**
+   * Whether the two views are in the same step.
+   * @param {DateOrTimeViewWithMeridiem} viewA The first view to compare.
+   * @param {DateOrTimeViewWithMeridiem} viewB The second view to compare.
+   * @returns {boolean} Whether the two views are in the same step.
+   */
+  areViewsInSameStep: (viewA: DateOrTimeViewWithMeridiem, viewB: DateOrTimeViewWithMeridiem) => boolean;
+};
+export interface CreateStepNavigationReturnValueParameters {
+  defaultView: DateOrTimeViewWithMeridiem;
+  view: DateOrTimeViewWithMeridiem;
+  views: readonly DateOrTimeViewWithMeridiem[];
+  setView: (view: any) => void;
+}
+interface UseRangePickerStepNavigationOnStepChangeParameters<TStep extends {}> extends CreateStepNavigationReturnValueParameters {
+  step: TStep;
+}
+export {};

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

@@ -0,0 +1,26 @@
+import { DefaultizedProps } from '@mui/x-internals/types';
+import { DateOrTimeView, MuiPickersAdapter } from "../../models/index.mjs";
+import { DateOrTimeViewWithMeridiem } from "../models/index.mjs";
+import { DigitalTimePickerProps } from "../models/props/time.mjs";
+export declare const resolveDateTimeFormat: (adapter: MuiPickersAdapter, {
+  views,
+  format,
+  ...other
+}: {
+  format?: string;
+  views: readonly DateOrTimeViewWithMeridiem[];
+  ampm: boolean;
+}, ignoreDateResolving?: boolean) => string;
+interface DefaultizedTimeViewsProps<TView = DateOrTimeView> extends DefaultizedProps<DigitalTimePickerProps, 'ampm'> {
+  views: readonly TView[];
+}
+interface DefaultizedTimeViewsResponse<TView = DateOrTimeViewWithMeridiem> extends Required<Pick<DefaultizedTimeViewsProps<TView>, 'thresholdToRenderTimeInASingleColumn' | 'timeSteps' | 'views'>> {
+  shouldRenderTimeInASingleColumn: boolean;
+}
+export declare function resolveTimeViewsResponse<InTView extends DateOrTimeView = DateOrTimeView, OutTView extends DateOrTimeViewWithMeridiem = DateOrTimeViewWithMeridiem>({
+  thresholdToRenderTimeInASingleColumn: inThreshold,
+  ampm,
+  timeSteps: inTimeSteps,
+  views
+}: DefaultizedTimeViewsProps<InTView>): DefaultizedTimeViewsResponse<OutTView>;
+export {};