@mui/x-date-pickers 7.22.3 → 8.0.0-alpha.1

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

@@ -5,9 +5,9 @@ import { UsePickerParams } from '../usePicker';
 import { UsePickerViewsProps } from '../usePicker/usePickerViews';
 import { FieldSection, PickerValidDate } from '../../../models';
 import { DateOrTimeViewWithMeridiem } from '../../models';
-export interface UseStaticPickerSlots<TDate extends PickerValidDate, TView extends DateOrTimeViewWithMeridiem> extends ExportedPickersLayoutSlots<TDate | null, TDate, TView> {
+export interface UseStaticPickerSlots<TView extends DateOrTimeViewWithMeridiem> extends ExportedPickersLayoutSlots<PickerValidDate | null, TView> {
 }
-export interface UseStaticPickerSlotProps<TDate extends PickerValidDate, TView extends DateOrTimeViewWithMeridiem> extends ExportedPickersLayoutSlotProps<TDate | null, TDate, TView> {
+export interface UseStaticPickerSlotProps<TView extends DateOrTimeViewWithMeridiem> extends ExportedPickersLayoutSlotProps<PickerValidDate | null, TView> {
 }
 export interface StaticOnlyPickerProps {
     /**
@@ -27,19 +27,19 @@ export interface StaticOnlyPickerProps {
      */
     onClose?: () => void;
 }
-export interface UseStaticPickerProps<TDate extends PickerValidDate, TView extends DateOrTimeViewWithMeridiem, TError, TExternalProps extends UsePickerViewsProps<TDate | null, TDate, TView, any, any>> extends BasePickerProps<TDate | null, TDate, TView, TError, TExternalProps, {}>, StaticOnlyPickerProps {
+export interface UseStaticPickerProps<TView extends DateOrTimeViewWithMeridiem, TError, TExternalProps extends UsePickerViewsProps<PickerValidDate | null, TView, any, any>> extends BasePickerProps<PickerValidDate | null, TView, TError, TExternalProps, {}>, StaticOnlyPickerProps {
     /**
      * Overridable component slots.
      * @default {}
      */
-    slots?: UseStaticPickerSlots<TDate, TView>;
+    slots?: UseStaticPickerSlots<TView>;
     /**
      * The props used for each component slot.
      * @default {}
      */
-    slotProps?: UseStaticPickerSlotProps<TDate, TView>;
+    slotProps?: UseStaticPickerSlotProps<TView>;
 }
-export interface UseStaticPickerParams<TDate extends PickerValidDate, TView extends DateOrTimeViewWithMeridiem, TExternalProps extends UseStaticPickerProps<TDate, TView, any, TExternalProps>> extends Pick<UsePickerParams<TDate | null, TDate, TView, FieldSection, TExternalProps, {}>, 'valueManager' | 'valueType' | 'validator'> {
+export interface UseStaticPickerParams<TView extends DateOrTimeViewWithMeridiem, TExternalProps extends UseStaticPickerProps<TView, any, TExternalProps>> extends Pick<UsePickerParams<PickerValidDate | null, TView, FieldSection, TExternalProps, {}>, 'valueManager' | 'valueType' | 'validator'> {
     props: TExternalProps;
     /**
      * Ref to pass to the root element

package/internals/hooks/useUtils.d.ts

@@ -1,12 +1,12 @@
 import { MuiPickersAdapterContextValue } from '../../LocalizationProvider/LocalizationProvider';
 import { PickersLocaleText } from '../../locales/utils/pickersLocaleTextApi';
 import { PickersTimezone, PickerValidDate } from '../../models';
-export declare const useLocalizationContext: <TDate extends PickerValidDate>() => Omit<MuiPickersAdapterContextValue<TDate>, "localeText"> & {
-    localeText: PickersLocaleText<TDate>;
+export declare const useLocalizationContext: () => Omit<MuiPickersAdapterContextValue, "localeText"> & {
+    localeText: PickersLocaleText;
 };
-export declare const useUtils: <TDate extends PickerValidDate>() => import("@mui/x-date-pickers/models").MuiPickersAdapter<TDate, any>;
-export declare const useDefaultDates: <TDate extends PickerValidDate>() => {
-    minDate: TDate;
-    maxDate: TDate;
+export declare const useUtils: () => import("@mui/x-date-pickers/models").MuiPickersAdapter<any>;
+export declare const useDefaultDates: () => {
+    minDate: PickerValidDate;
+    maxDate: PickerValidDate;
 };
-export declare const useNow: <TDate extends PickerValidDate>(timezone: PickersTimezone) => TDate;
+export declare const useNow: (timezone: PickersTimezone) => PickerValidDate;

package/internals/hooks/useValueWithTimezone.d.ts

@@ -5,13 +5,7 @@ import { PickersTimezone, PickerValidDate } from '../../models';
  * - The value returned by `onChange` always have the timezone of `props.value` or `props.defaultValue` if defined
  * - The value rendered is always the one from `props.timezone` if defined
  */
-export declare const useValueWithTimezone: <TDate extends PickerValidDate, TValue, TChange extends (...params: any[]) => void>({ timezone: timezoneProp, value: valueProp, defaultValue, onChange, valueManager, }: {
-    timezone: PickersTimezone | undefined;
-    value: TValue | undefined;
-    defaultValue: TValue | undefined;
-    onChange: TChange | undefined;
-    valueManager: PickerValueManager<TValue, TDate, any>;
-}) => {
+export declare const useValueWithTimezone: <TValue, TChange extends (...params: any[]) => void>({ timezone: timezoneProp, value: valueProp, defaultValue, referenceDate, onChange, valueManager, }: UseValueWithTimezoneParameters<TValue, TChange>) => {
     value: TValue;
     handleValueChange: TChange;
     timezone: string;
@@ -19,15 +13,25 @@ export declare const useValueWithTimezone: <TDate extends PickerValidDate, TValu
 /**
  * Wrapper around `useControlled` and `useValueWithTimezone`
  */
-export declare const useControlledValueWithTimezone: <TDate extends PickerValidDate, TValue, TChange extends (...params: any[]) => void>({ name, timezone: timezoneProp, value: valueProp, defaultValue, onChange: onChangeProp, valueManager, }: {
-    name: string;
-    timezone: PickersTimezone | undefined;
-    value: TValue | undefined;
-    defaultValue: TValue | undefined;
-    onChange: TChange | undefined;
-    valueManager: PickerValueManager<TValue, TDate, any>;
-}) => {
+export declare const useControlledValueWithTimezone: <TValue, TChange extends (...params: any[]) => void>({ name, timezone: timezoneProp, value: valueProp, defaultValue, referenceDate, onChange: onChangeProp, valueManager, }: UseControlledValueWithTimezoneParameters<TValue, TChange>) => {
     value: TValue;
     handleValueChange: TChange;
     timezone: string;
 };
+interface UseValueWithTimezoneParameters<TValue, TChange extends (...params: any[]) => void> {
+    timezone: PickersTimezone | undefined;
+    value: TValue | undefined;
+    defaultValue: TValue | undefined;
+    /**
+     * The reference date as passed to `props.referenceDate`.
+     * It does not need to have its default value.
+     * This is only used to determine the timezone to use when `props.value` and `props.defaultValue` are not defined.
+     */
+    referenceDate: PickerValidDate | undefined;
+    onChange: TChange | undefined;
+    valueManager: PickerValueManager<TValue, any>;
+}
+interface UseControlledValueWithTimezoneParameters<TValue, TChange extends (...params: any[]) => void> extends UseValueWithTimezoneParameters<TValue, TChange> {
+    name: string;
+}
+export {};

package/internals/hooks/useValueWithTimezone.js

@@ -11,6 +11,7 @@ export const useValueWithTimezone = ({
   timezone: timezoneProp,
   value: valueProp,
   defaultValue,
+  referenceDate,
   onChange,
   valueManager
 }) => {
@@ -24,7 +25,16 @@ export const useValueWithTimezone = ({
     }
     return valueManager.setTimezone(utils, inputTimezone, newValue);
   });
-  const timezoneToRender = timezoneProp ?? inputTimezone ?? 'default';
+  let timezoneToRender;
+  if (timezoneProp) {
+    timezoneToRender = timezoneProp;
+  } else if (inputTimezone) {
+    timezoneToRender = inputTimezone;
+  } else if (referenceDate) {
+    timezoneToRender = utils.getTimezone(referenceDate);
+  } else {
+    timezoneToRender = 'default';
+  }
   const valueWithTimezoneToRender = React.useMemo(() => valueManager.setTimezone(utils, timezoneToRender, inputValue), [valueManager, utils, timezoneToRender, inputValue]);
   const handleValueChange = useEventCallback((newValue, ...otherParams) => {
     const newValueWithInputTimezone = setInputTimezone(newValue);
@@ -45,6 +55,7 @@ export const useControlledValueWithTimezone = ({
   timezone: timezoneProp,
   value: valueProp,
   defaultValue,
+  referenceDate,
   onChange: onChangeProp,
   valueManager
 }) => {
@@ -62,6 +73,7 @@ export const useControlledValueWithTimezone = ({
     timezone: timezoneProp,
     value: valueWithInputTimezone,
     defaultValue: undefined,
+    referenceDate,
     onChange,
     valueManager
   });

package/internals/hooks/useViews.d.ts

@@ -1,8 +1,8 @@
+import { MakeOptional } from '@mui/x-internals/types';
 import type { PickerSelectionState } from './usePicker';
-import { MakeOptional } from '../models/helpers';
 import { DateOrTimeViewWithMeridiem } from '../models';
 import { PickerValidDate } from '../../models';
-export type PickerOnChangeFn<TDate extends PickerValidDate> = (date: TDate | null, selectionState?: PickerSelectionState) => void;
+export type PickerOnChangeFn = (date: PickerValidDate | null, selectionState?: PickerSelectionState) => void;
 export interface UseViewsOptions<TValue, TView extends DateOrTimeViewWithMeridiem> {
     /**
      * Callback fired when the value changes.
@@ -54,7 +54,7 @@ export interface UseViewsOptions<TValue, TView extends DateOrTimeViewWithMeridie
      */
     onFocusedViewChange?: (view: TView, hasFocus: boolean) => void;
 }
-export interface ExportedUseViewsOptions<TView extends DateOrTimeViewWithMeridiem> extends MakeOptional<UseViewsOptions<any, TView>, 'onChange' | 'openTo' | 'views'> {
+export interface ExportedUseViewsOptions<TValue, TView extends DateOrTimeViewWithMeridiem> extends MakeOptional<UseViewsOptions<TValue, TView>, 'onChange' | 'openTo' | 'views'> {
 }
 interface UseViewsResponse<TValue, TView extends DateOrTimeViewWithMeridiem> {
     view: TView;

package/internals/hooks/useViews.js

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import useEventCallback from '@mui/utils/useEventCallback';
-import { unstable_useControlled as useControlled } from '@mui/utils';
+import useControlled from '@mui/utils/useControlled';
 let warnedOnceNotValidView = false;
 export function useViews({
   onChange,

package/internals/index.d.ts

@@ -1,6 +1,6 @@
 export { PickersArrowSwitcher } from './components/PickersArrowSwitcher/PickersArrowSwitcher';
 export type { ExportedPickersArrowSwitcherProps, PickersArrowSwitcherSlots, PickersArrowSwitcherSlotProps, } from './components/PickersArrowSwitcher';
-export { PickersProvider } from './components/PickersProvider';
+export { PickerProvider } from './components/PickerProvider';
 export { PickersModalDialog } from './components/PickersModalDialog';
 export type { PickersModalDialogSlots, PickersModalDialogSlotProps, } from './components/PickersModalDialog';
 export { PickersPopper } from './components/PickersPopper';
@@ -31,20 +31,22 @@ export { usePicker } from './hooks/usePicker';
 export type { UsePickerResponse, UsePickerParams, UsePickerProps, UsePickerValueFieldResponse, PickerViewsRendererProps, } from './hooks/usePicker';
 export type { UsePickerValueNonStaticProps, PickerValueManager, PickerSelectionState, } from './hooks/usePicker/usePickerValue.types';
 export type { UsePickerViewsNonStaticProps, PickerViewRendererLookup, PickerViewRenderer, UsePickerViewsProps, } from './hooks/usePicker/usePickerViews';
+export { usePickerPrivateContext } from './hooks/usePickerPrivateContext';
 export { useStaticPicker } from './hooks/useStaticPicker';
 export type { StaticOnlyPickerProps, UseStaticPickerSlots, UseStaticPickerSlotProps, } from './hooks/useStaticPicker';
 export { useLocalizationContext, useDefaultDates, useUtils, useNow } from './hooks/useUtils';
 export type { ExportedUseViewsOptions, UseViewsOptions } from './hooks/useViews';
 export { useViews } from './hooks/useViews';
 export { usePreviousMonthDisabled, useNextMonthDisabled } from './hooks/date-helpers-hooks';
-export type { BaseFieldProps } from './models/fields';
+export type { BaseSingleInputFieldProps } from './models/fields';
 export type { BasePickerProps, BasePickerInputProps, BaseNonStaticPickerProps, } from './models/props/basePickerProps';
-export type { BaseClockProps, DesktopOnlyTimePickerProps } from './models/props/clock';
+export type { BaseClockProps, DesktopOnlyTimePickerProps, AmPmProps } from './models/props/time';
 export type { BaseTabsProps, ExportedBaseTabsProps } from './models/props/tabs';
 export type { BaseToolbarProps, ExportedBaseToolbarProps } from './models/props/toolbar';
-export type { DefaultizedProps, MakeOptional, SlotComponentPropsFromProps } from './models/helpers';
-export type { WrapperVariant, TimeViewWithMeridiem, DateOrTimeViewWithMeridiem, } from './models/common';
+export type { FormProps } from './models/formProps';
+export type { PickerVariant, TimeViewWithMeridiem, DateOrTimeViewWithMeridiem, } from './models/common';
 export type { BaseDateValidationProps, BaseTimeValidationProps, TimeValidationProps, MonthValidationProps, YearValidationProps, DayValidationProps, DateTimeValidationProps, } from './models/validation';
+export type { PickerRangeValue } from './models/value';
 export { convertFieldResponseIntoMuiTextFieldProps } from './utils/convertFieldResponseIntoMuiTextFieldProps';
 export { applyDefaultDate, replaceInvalidDateByNull, areDatesEqual, getTodayDate, isDatePickerView, mergeDateAndTime, formatMeridiem, } from './utils/date-utils';
 export { resolveTimeViewsResponse, resolveDateTimeFormat } from './utils/date-time-utils';

package/internals/index.js

@@ -1,5 +1,5 @@
 export { PickersArrowSwitcher } from "./components/PickersArrowSwitcher/PickersArrowSwitcher.js";
-export { PickersProvider } from "./components/PickersProvider.js";
+export { PickerProvider } from "./components/PickerProvider.js";
 export { PickersModalDialog } from "./components/PickersModalDialog.js";
 export { PickersPopper } from "./components/PickersPopper.js";
 export { PickersToolbar } from "./components/PickersToolbar.js";
@@ -13,6 +13,7 @@ export { DAY_MARGIN, DIALOG_WIDTH, VIEW_HEIGHT } from "./constants/dimensions.js
 export { useControlledValueWithTimezone } from "./hooks/useValueWithTimezone.js";
 export { useField, createDateStrForV7HiddenInputFromSections, createDateStrForV6InputFromSections } from "./hooks/useField/index.js";
 export { usePicker } from "./hooks/usePicker/index.js";
+export { usePickerPrivateContext } from "./hooks/usePickerPrivateContext.js";
 export { useStaticPicker } from "./hooks/useStaticPicker/index.js";
 export { useLocalizationContext, useDefaultDates, useUtils, useNow } from "./hooks/useUtils.js";
 export { useViews } from "./hooks/useViews.js";

package/internals/models/common.d.ts

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

package/internals/models/fields.d.ts

@@ -1,10 +1,35 @@
-import * as React from 'react';
+import { SxProps } from '@mui/material/styles';
+import { MakeRequired } from '@mui/x-internals/types';
+import type { ExportedUseClearableFieldProps, UseClearableFieldSlotProps, UseClearableFieldSlots } from '../../hooks/useClearableField';
+import type { FieldSection, PickerOwnerState } from '../../models';
 import type { UseFieldInternalProps } from '../hooks/useField';
-import { FieldSection, PickerValidDate } from '../../models';
-import type { ExportedUseClearableFieldProps } from '../../hooks/useClearableField';
-export interface BaseFieldProps<TValue, TDate extends PickerValidDate, TSection extends FieldSection, TEnableAccessibleFieldDOMStructure extends boolean, TError> extends Omit<UseFieldInternalProps<TValue, TDate, TSection, TEnableAccessibleFieldDOMStructure, TError>, 'format'>, ExportedUseClearableFieldProps {
-    className?: string;
-    format?: string;
-    disabled?: boolean;
+export interface BaseForwardedSingleInputFieldProps extends ExportedUseClearableFieldProps {
+    className: string | undefined;
+    sx: SxProps<any> | undefined;
+    label: React.ReactNode | undefined;
+    name: string | undefined;
+    id?: string;
+    focused?: boolean;
+    onKeyDown?: React.KeyboardEventHandler;
+    onBlur?: React.FocusEventHandler;
     ref?: React.Ref<HTMLDivElement>;
+    inputRef?: React.Ref<HTMLInputElement>;
+    InputProps?: {
+        ref?: React.Ref<any>;
+        endAdornment?: React.ReactNode;
+        startAdornment?: React.ReactNode;
+    };
+    inputProps?: {
+        'aria-label'?: string;
+    };
+    slots?: UseClearableFieldSlots;
+    slotProps?: UseClearableFieldSlotProps & {
+        textField?: {};
+    };
+    ownerState: PickerOwnerState;
 }
+/**
+ * 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 type BaseSingleInputFieldProps<TValue, TSection extends FieldSection, TEnableAccessibleFieldDOMStructure extends boolean, TError> = MakeRequired<Pick<UseFieldInternalProps<TValue, TSection, TEnableAccessibleFieldDOMStructure, TError>, 'readOnly' | 'disabled' | 'format' | 'formatDensity' | 'enableAccessibleFieldDOMStructure' | 'selectedSections' | 'onSelectedSectionsChange' | 'timezone' | 'value' | 'onChange' | 'unstableFieldRef' | 'autoFocus'>, 'format' | 'value' | 'onChange' | 'timezone'> & BaseForwardedSingleInputFieldProps;

package/internals/models/formProps.d.ts

@@ -0,0 +1,14 @@
+export interface FormProps {
+    /**
+     * If `true`, the component is disabled.
+     * When disabled, the value cannot be changed and no interaction is possible.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * If `true`, the component is read-only.
+     * When read-only, the value cannot be changed but the user can interact with the interface.
+     * @default false
+     */
+    readOnly?: boolean;
+}

package/internals/models/helpers.d.ts

@@ -4,7 +4,3 @@
  * `style`.
  */
 export type ExtendMui<C, Removals extends keyof C = never> = Omit<C, 'classes' | 'theme' | Removals>;
-export type MakeOptional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
-export type MakeRequired<T, K extends keyof T> = Omit<T, K> & Required<Pick<T, K>>;
-export type DefaultizedProps<P extends {}, RequiredProps extends keyof P, AdditionalProps extends {} = {}> = Omit<P, RequiredProps | keyof AdditionalProps> & Required<Pick<P, RequiredProps>> & AdditionalProps;
-export type SlotComponentPropsFromProps<TProps extends {}, TOverrides extends {}, TOwnerState extends {}> = (Partial<TProps> & TOverrides) | ((ownerState: TOwnerState) => Partial<TProps> & TOverrides);

package/internals/models/index.d.ts

@@ -1,2 +1,4 @@
 export * from './fields';
 export * from './common';
+export * from './value';
+export * from './formProps';

package/internals/models/index.js

@@ -1,2 +1,4 @@
 export * from "./fields.js";
-export * from "./common.js";
+export * from "./common.js";
+export * from "./value.js";
+export * from "./formProps.js";

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

@@ -1,17 +1,16 @@
 import * as React from 'react';
 import { Theme } from '@mui/material/styles';
 import { SxProps } from '@mui/system';
+import { MakeOptional } from '@mui/x-internals/types';
 import { UsePickerBaseProps } from '../../hooks/usePicker';
 import { PickersInputComponentLocaleText } from '../../../locales/utils/pickersLocaleTextApi';
 import type { UsePickerViewsProps } from '../../hooks/usePicker/usePickerViews';
-import { MakeOptional } from '../helpers';
 import { DateOrTimeViewWithMeridiem } from '../common';
 import { UseFieldInternalProps } from '../../hooks/useField';
-import { PickerValidDate } from '../../../models';
 /**
  * Props common to all pickers after applying the default props on each picker.
  */
-export interface BasePickerProps<TValue, TDate extends PickerValidDate, TView extends DateOrTimeViewWithMeridiem, TError, TExternalProps extends UsePickerViewsProps<TValue, TDate, TView, any, any>, TAdditionalProps extends {}> extends UsePickerBaseProps<TValue, TDate, TView, TError, TExternalProps, TAdditionalProps> {
+export interface BasePickerProps<TValue, TView extends DateOrTimeViewWithMeridiem, TError, TExternalProps extends UsePickerViewsProps<TValue, TView, any, any>, TAdditionalProps extends {}> extends UsePickerBaseProps<TValue, TView, TError, TExternalProps, TAdditionalProps> {
     className?: string;
     /**
      * The system prop that allows defining system overrides as well as additional CSS styles.
@@ -21,18 +20,18 @@ export interface BasePickerProps<TValue, TDate extends PickerValidDate, TView ex
      * Locale for components texts.
      * Allows overriding texts coming from `LocalizationProvider` and `theme`.
      */
-    localeText?: PickersInputComponentLocaleText<TDate>;
+    localeText?: PickersInputComponentLocaleText;
 }
 /**
  * Props common to all pickers before applying the default props on each picker.
  */
-export interface BasePickerInputProps<TValue, TDate extends PickerValidDate, TView extends DateOrTimeViewWithMeridiem, TError> extends Omit<MakeOptional<BasePickerProps<TValue, TDate, TView, TError, any, any>, 'openTo' | 'views'>, 'viewRenderers'> {
+export interface BasePickerInputProps<TValue, TView extends DateOrTimeViewWithMeridiem, TError> extends Omit<MakeOptional<BasePickerProps<TValue, TView, TError, any, any>, 'openTo' | 'views'>, 'viewRenderers'> {
 }
 /**
  * Props common to all non-static pickers.
  * These props are handled by the headless wrappers.
  */
-export interface BaseNonStaticPickerProps extends Pick<UseFieldInternalProps<any, any, any, any, any>, 'formatDensity' | 'enableAccessibleFieldDOMStructure' | 'selectedSections' | 'onSelectedSectionsChange'> {
+export interface BaseNonStaticPickerProps extends Pick<UseFieldInternalProps<any, any, any, any>, 'formatDensity' | 'enableAccessibleFieldDOMStructure' | 'selectedSections' | 'onSelectedSectionsChange'> {
     /**
      * Format of the date when rendered in the input(s).
      * Defaults to localized format based on the used `views`.

package/internals/models/props/{clock.d.ts → time.d.ts}

@@ -1,18 +1,21 @@
 import { SxProps, Theme } from '@mui/material/styles';
-import { BaseTimeValidationProps, TimeValidationProps } from '../validation';
 import { PickerValidDate, TimeStepOptions, TimezoneProps } from '../../../models';
 import type { ExportedDigitalClockProps } from '../../../DigitalClock/DigitalClock.types';
 import type { ExportedMultiSectionDigitalClockProps } from '../../../MultiSectionDigitalClock/MultiSectionDigitalClock.types';
 import type { ExportedUseViewsOptions } from '../../hooks/useViews';
 import { TimeViewWithMeridiem } from '../common';
-export interface ExportedBaseClockProps<TDate extends PickerValidDate> extends TimeValidationProps<TDate>, BaseTimeValidationProps, TimezoneProps {
+import { ExportedValidateTimeProps } from '../../../validation/validateTime';
+import { FormProps } from '../formProps';
+export interface AmPmProps {
     /**
      * 12h/24h view for hour selection clock.
      * @default utils.is12HourCycleInCurrentLocale()
      */
     ampm?: boolean;
 }
-export interface BaseClockProps<TDate extends PickerValidDate, TView extends TimeViewWithMeridiem> extends ExportedUseViewsOptions<TView>, ExportedBaseClockProps<TDate> {
+export interface ExportedBaseClockProps extends ExportedValidateTimeProps, TimezoneProps, AmPmProps {
+}
+export interface BaseClockProps<TView extends TimeViewWithMeridiem> extends ExportedUseViewsOptions<PickerValidDate | null, TView>, ExportedBaseClockProps, FormProps {
     className?: string;
     /**
      * The system prop that allows defining system overrides as well as additional CSS styles.
@@ -22,29 +25,19 @@ export interface BaseClockProps<TDate extends PickerValidDate, TView extends Tim
      * The selected value.
      * Used when the component is controlled.
      */
-    value?: TDate | null;
+    value?: PickerValidDate | null;
     /**
      * The default selected value.
      * Used when the component is not controlled.
      */
-    defaultValue?: TDate | null;
-    /**
-     * If `true`, the picker views and text field are disabled.
-     * @default false
-     */
-    disabled?: boolean;
-    /**
-     * If `true`, the picker views and text field are read-only.
-     * @default false
-     */
-    readOnly?: boolean;
+    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?: TDate;
+    referenceDate?: PickerValidDate;
 }
-export interface DesktopOnlyTimePickerProps<TDate extends PickerValidDate> extends Omit<ExportedDigitalClockProps<TDate>, 'timeStep'>, Omit<ExportedMultiSectionDigitalClockProps<TDate>, 'timeSteps'> {
+export interface DesktopOnlyTimePickerProps 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/models/props/toolbar.d.ts

@@ -20,8 +20,6 @@ export interface BaseToolbarProps<TValue, TView extends DateOrTimeViewWithMeridi
      * Available views.
      */
     views: readonly TView[];
-    disabled?: boolean;
-    readOnly?: boolean;
     titleId?: string;
 }
 export interface ExportedBaseToolbarProps {

package/internals/models/validation.d.ts

@@ -1,4 +1,4 @@
-import { PickerValidDate, TimeView } from '../../models';
+import type { PickerValidDate, TimeView } from '../../models';
 interface FutureAndPastValidationProps {
     /**
      * If `true`, disable values before the current date for date components, time for time components and both for date time components.
@@ -20,17 +20,17 @@ export interface BaseTimeValidationProps extends FutureAndPastValidationProps {
 /**
  * Props used to validate a time value.
  */
-export interface TimeValidationProps<TDate extends PickerValidDate> {
+export interface TimeValidationProps {
     /**
      * Minimal selectable time.
      * The date part of the object will be ignored unless `props.disableIgnoringDatePartForTimeValidation === true`.
      */
-    minTime?: TDate;
+    minTime?: PickerValidDate;
     /**
      * Maximal selectable time.
      * The date part of the object will be ignored unless `props.disableIgnoringDatePartForTimeValidation === true`.
      */
-    maxTime?: TDate;
+    maxTime?: PickerValidDate;
     /**
      * Step over minutes.
      * @default 1
@@ -38,12 +38,11 @@ export interface TimeValidationProps<TDate extends PickerValidDate> {
     minutesStep?: number;
     /**
      * Disable specific time.
-     * @template TDate
-     * @param {TDate} value The value to check.
+     * @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: TDate, view: TimeView) => boolean;
+    shouldDisableTime?: (value: PickerValidDate, view: TimeView) => boolean;
     /**
      * Do not ignore date part when validating min/max time.
      * @default false
@@ -54,68 +53,65 @@ export interface TimeValidationProps<TDate extends PickerValidDate> {
  * 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<TDate extends PickerValidDate> extends FutureAndPastValidationProps {
+export interface BaseDateValidationProps extends FutureAndPastValidationProps {
     /**
      * Maximal selectable date.
      * @default 2099-12-31
      */
-    maxDate?: TDate;
+    maxDate?: PickerValidDate;
     /**
      * Minimal selectable date.
      * @default 1900-01-01
      */
-    minDate?: TDate;
+    minDate?: PickerValidDate;
 }
 /**
  * Props used to validate a date value (validates day + month + year).
  */
-export interface DayValidationProps<TDate extends PickerValidDate> {
+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.
      *
-     * @template TDate
-     * @param {TDate} day The date to test.
+     * @param {PickerValidDate} day The date to test.
      * @returns {boolean} If `true` the date will be disabled.
      */
-    shouldDisableDate?: (day: TDate) => boolean;
+    shouldDisableDate?: (day: PickerValidDate) => boolean;
 }
 /**
  * Props used to validate a month value
  */
-export interface MonthValidationProps<TDate extends PickerValidDate> {
+export interface MonthValidationProps {
     /**
      * Disable specific month.
-     * @template TDate
-     * @param {TDate} month The month to test.
+     * @param {PickerValidDate} month The month to test.
      * @returns {boolean} If `true`, the month will be disabled.
      */
-    shouldDisableMonth?: (month: TDate) => boolean;
+    shouldDisableMonth?: (month: PickerValidDate) => boolean;
 }
 /**
  * Props used to validate a year value
  */
-export interface YearValidationProps<TDate extends PickerValidDate> {
+export interface YearValidationProps {
     /**
      * Disable specific year.
-     * @template TDate
-     * @param {TDate} year The year to test.
+     * @param {PickerValidDate} year The year to test.
      * @returns {boolean} If `true`, the year will be disabled.
      */
-    shouldDisableYear?: (year: TDate) => boolean;
+    shouldDisableYear?: (year: PickerValidDate) => boolean;
 }
 /**
  * Props used to validate a date time value.
  */
-export interface DateTimeValidationProps<TDate extends PickerValidDate> {
+export interface DateTimeValidationProps {
     /**
      * Minimal selectable moment of time with binding to date, to set min time in each day use `minTime`.
      */
-    minDateTime?: TDate;
+    minDateTime?: PickerValidDate;
     /**
      * Maximal selectable moment of time with binding to date, to set max time in each day use `maxTime`.
      */
-    maxDateTime?: TDate;
+    maxDateTime?: PickerValidDate;
 }
 export {};

package/internals/models/value.d.ts

@@ -0,0 +1,3 @@
+import { PickerValidDate } from '../../models/pickers';
+export type PickerValue = PickerValidDate | null;
+export type PickerRangeValue = [PickerValidDate | null, PickerValidDate | null];

package/internals/models/value.js

@@ -0,0 +1 @@
+export {};

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

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