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

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

@@ -4,69 +4,68 @@ import { WrapperVariant } from '../../models/common';
 import { FieldSection, FieldValueType, TimezoneProps, MuiPickersAdapter, PickersTimezone, PickerChangeHandlerContext, PickerValidDate, OnErrorProps, InferError } from '../../../models';
 import { GetDefaultReferenceDateProps } from '../../utils/getDefaultReferenceDate';
 import { PickerShortcutChangeImportance, PickersShortcutsItemContext } from '../../../PickersShortcuts';
-import { PickersContextValue } from '../../components/PickersProvider';
-export interface PickerValueManager<TValue, TDate extends PickerValidDate, TError> {
+export interface PickerValueManager<TValue, TError> {
     /**
      * Determines if two values are equal.
-     * @template TDate, TValue
-     * @param {MuiPickersAdapter<TDate>} utils The adapter.
+     * @template TValue
+     * @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<TDate>, valueLeft: TValue, valueRight: TValue) => boolean;
+    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 TDate, TValue
-     * @param {MuiPickersAdapter<TDate>} utils The adapter.
+     * @template TValue
+     * @param {MuiPickersAdapter} utils The adapter.
      * @param {PickersTimezone} timezone The current timezone.
      * @param {FieldValueType} valueType The type of the value being edited.
      * @returns {TValue} The value to set when clicking the "Today" button.
      */
-    getTodayValue: (utils: MuiPickersAdapter<TDate>, timezone: PickersTimezone, valueType: FieldValueType) => TValue;
+    getTodayValue: (utils: MuiPickersAdapter, timezone: PickersTimezone, valueType: FieldValueType) => TValue;
     /**
-     * @template TDate, TValue
+     * @template TValue
      * Method returning the reference value to use when mounting the component.
      * @param {object} params The params of the method.
-     * @param {TDate | undefined} params.referenceDate The referenceDate provided by the user.
+     * @param {PickerValidDate | undefined} params.referenceDate The referenceDate provided by the user.
      * @param {TValue} params.value The value provided by the user.
-     * @param {GetDefaultReferenceDateProps<TDate>} params.props The validation props needed to compute the reference value.
-     * @param {MuiPickersAdapter<TDate>} params.utils The adapter.
+     * @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 {() => TDate} params.getTodayDate The reference date to use if no reference date is passed to the component.
+     * @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: TDate | undefined;
+        referenceDate: PickerValidDate | undefined;
         value: TValue;
-        props: GetDefaultReferenceDateProps<TDate>;
-        utils: MuiPickersAdapter<TDate>;
+        props: GetDefaultReferenceDateProps;
+        utils: MuiPickersAdapter;
         granularity: number;
         timezone: PickersTimezone;
-        getTodayDate?: () => TDate;
+        getTodayDate?: () => PickerValidDate;
     }) => TValue;
     /**
      * Method parsing the input value to replace all invalid dates by `null`.
-     * @template TDate, TValue
-     * @param {MuiPickersAdapter<TDate>} utils The adapter.
+     * @template TValue
+     * @param {MuiPickersAdapter} utils The adapter.
      * @param {TValue} value The value to parse.
      * @returns {TValue} The value without invalid date.
      */
-    cleanValue: (utils: MuiPickersAdapter<TDate>, value: TValue) => TValue;
+    cleanValue: (utils: MuiPickersAdapter, value: TValue) => TValue;
     /**
      * Generates the new value, given the previous value and the new proposed value.
-     * @template TDate, TValue
-     * @param {MuiPickersAdapter<TDate>} utils The adapter.
+     * @template TValue
+     * @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<TDate>, lastValidDateValue: TValue, value: TValue) => TValue;
+    valueReducer?: (utils: MuiPickersAdapter, lastValidDateValue: TValue, value: TValue) => TValue;
     /**
      * Compare two errors to know if they are equal.
      * @template TError
@@ -89,21 +88,21 @@ export interface PickerValueManager<TValue, TDate extends PickerValidDate, TErro
     /**
      * 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, TDate
-     @param {MuiPickersAdapter<TDate>} utils The utils to manipulate the date.
+     @template TValue
+     @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<TDate>, value: TValue) => string | null;
+    getTimezone: (utils: MuiPickersAdapter, value: TValue) => string | null;
     /**
      * Change the timezone of the dates inside a value.
-     @template TValue, TDate
-     @param {MuiPickersAdapter<TDate>} utils The utils to manipulate the date.
+     @template TValue
+     @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<TDate>, timezone: PickersTimezone, value: TValue) => TValue;
+    setTimezone: (utils: MuiPickersAdapter, timezone: PickersTimezone, value: TValue) => TValue;
 }
 export type PickerSelectionState = 'partial' | 'shallow' | 'finish';
 export interface UsePickerValueState<TValue> {
@@ -228,12 +227,12 @@ export interface UsePickerValueNonStaticProps {
  */
 export interface UsePickerValueProps<TValue, TError> extends UsePickerValueBaseProps<TValue, TError>, UsePickerValueNonStaticProps, TimezoneProps {
 }
-export interface UsePickerValueParams<TValue, TDate extends PickerValidDate, TExternalProps extends UsePickerValueProps<TValue, any>> {
+export interface UsePickerValueParams<TValue, TExternalProps extends UsePickerValueProps<TValue, any>> {
     props: TExternalProps;
-    valueManager: PickerValueManager<TValue, TDate, InferError<TExternalProps>>;
+    valueManager: PickerValueManager<TValue, InferError<TExternalProps>>;
     valueType: FieldValueType;
     wrapperVariant: WrapperVariant;
-    validator: Validator<TValue, TDate, InferError<TExternalProps>, TExternalProps>;
+    validator: Validator<TValue, InferError<TExternalProps>, TExternalProps>;
 }
 export interface UsePickerValueActions {
     onAccept: () => void;
@@ -244,7 +243,7 @@ export interface UsePickerValueActions {
     onOpen: (event: React.UIEvent) => void;
     onClose: (event?: React.UIEvent) => void;
 }
-export type UsePickerValueFieldResponse<TValue, TSection extends FieldSection, TError> = Required<Pick<UseFieldInternalProps<TValue, PickerValidDate, TSection, any, TError>, 'value' | 'onChange'>>;
+export type UsePickerValueFieldResponse<TValue, TSection extends FieldSection, TError> = Required<Pick<UseFieldInternalProps<TValue, TSection, any, TError>, 'value' | 'onChange'>>;
 /**
  * Props passed to `usePickerViews`.
  */
@@ -269,5 +268,4 @@ export interface UsePickerValueResponse<TValue, TSection extends FieldSection, T
     viewProps: UsePickerValueViewsResponse<TValue>;
     fieldProps: UsePickerValueFieldResponse<TValue, TSection, TError>;
     layoutProps: UsePickerValueLayoutResponse<TValue>;
-    contextValue: PickersContextValue;
 }

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

@@ -5,7 +5,7 @@ import { UseViewsOptions } from '../useViews';
 import type { UsePickerValueViewsResponse } from './usePickerValue.types';
 import { DateOrTimeViewWithMeridiem } from '../../models';
 import { FieldRef, FieldSection, PickerValidDate, TimezoneProps } from '../../../models';
-interface PickerViewsRendererBaseExternalProps<TView extends DateOrTimeViewWithMeridiem> extends Omit<UsePickerViewsProps<any, any, TView, any, any>, 'openTo' | 'viewRenderers'> {
+interface PickerViewsRendererBaseExternalProps<TView extends DateOrTimeViewWithMeridiem> extends Omit<UsePickerViewsProps<any, TView, any, any>, 'openTo' | 'viewRenderers'> {
 }
 export type PickerViewsRendererProps<TValue, TView extends DateOrTimeViewWithMeridiem, TExternalProps extends PickerViewsRendererBaseExternalProps<TView>, TAdditionalProps extends {}> = Omit<TExternalProps, 'className' | 'sx'> & TAdditionalProps & UsePickerValueViewsResponse<TValue> & {
     view: TView;
@@ -22,12 +22,7 @@ export type PickerViewRendererLookup<TValue, TView extends DateOrTimeViewWithMer
 /**
  * Props used to handle the views that are common to all pickers.
  */
-export interface UsePickerViewsBaseProps<TValue, TDate extends PickerValidDate, TView extends DateOrTimeViewWithMeridiem, TExternalProps extends UsePickerViewsProps<TValue, TDate, TView, any, any>, TAdditionalProps extends {}> extends Omit<UseViewsOptions<any, TView>, 'onChange' | 'onFocusedViewChange' | 'focusedView'>, TimezoneProps {
-    /**
-     * If `true`, the picker and text field are disabled.
-     * @default false
-     */
-    disabled?: boolean;
+export interface UsePickerViewsBaseProps<TValue, TView extends DateOrTimeViewWithMeridiem, TExternalProps extends UsePickerViewsProps<TValue, TView, any, any>, TAdditionalProps extends {}> extends Omit<UseViewsOptions<any, TView>, 'onChange' | 'onFocusedViewChange' | 'focusedView'>, TimezoneProps {
     /**
      * If `null`, the section will only have field editing.
      * If `undefined`, internally defined view will be used.
@@ -42,7 +37,7 @@ export interface UsePickerViewsBaseProps<TValue, TDate extends PickerValidDate,
      * 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?: TDate;
+    referenceDate?: PickerValidDate;
 }
 /**
  * Props used to handle the views of the pickers.
@@ -57,11 +52,11 @@ export interface UsePickerViewsNonStaticProps {
 /**
  * Props used to handle the value of the pickers.
  */
-export interface UsePickerViewsProps<TValue, TDate extends PickerValidDate, TView extends DateOrTimeViewWithMeridiem, TExternalProps extends UsePickerViewsProps<TValue, TDate, TView, any, any>, TAdditionalProps extends {}> extends UsePickerViewsBaseProps<TValue, TDate, TView, TExternalProps, TAdditionalProps> {
+export interface UsePickerViewsProps<TValue, TView extends DateOrTimeViewWithMeridiem, TExternalProps extends UsePickerViewsProps<TValue, TView, any, any>, TAdditionalProps extends {}> extends UsePickerViewsBaseProps<TValue, TView, TExternalProps, TAdditionalProps> {
     className?: string;
     sx?: SxProps<Theme>;
 }
-export interface UsePickerViewParams<TValue, TDate extends PickerValidDate, TView extends DateOrTimeViewWithMeridiem, TSection extends FieldSection, TExternalProps extends UsePickerViewsProps<TValue, TDate, TView, TExternalProps, TAdditionalProps>, TAdditionalProps extends {}> {
+export interface UsePickerViewParams<TValue, TView extends DateOrTimeViewWithMeridiem, TSection extends FieldSection, TExternalProps extends UsePickerViewsProps<TValue, TView, TExternalProps, TAdditionalProps>, TAdditionalProps extends {}> {
     props: TExternalProps;
     propsFromPickerValue: UsePickerValueViewsResponse<TValue>;
     additionalViewProps: TAdditionalProps;
@@ -97,5 +92,5 @@ export interface UsePickerViewsLayoutResponse<TView extends DateOrTimeViewWithMe
  * - Handles the switch between UI views and field views
  * - Handles the focus management when switching views
  */
-export declare const usePickerViews: <TValue, TDate extends PickerValidDate, TView extends DateOrTimeViewWithMeridiem, TSection extends FieldSection, TExternalProps extends UsePickerViewsProps<TValue, TDate, TView, any, any>, TAdditionalProps extends {}>({ props, propsFromPickerValue, additionalViewProps, autoFocusView, rendererInterceptor, fieldRef, }: UsePickerViewParams<TValue, TDate, TView, TSection, TExternalProps, TAdditionalProps>) => UsePickerViewsResponse<TView>;
+export declare const usePickerViews: <TValue, TView extends DateOrTimeViewWithMeridiem, TSection extends FieldSection, TExternalProps extends UsePickerViewsProps<TValue, TView, any, any>, TAdditionalProps extends {}>({ props, propsFromPickerValue, additionalViewProps, autoFocusView, rendererInterceptor, fieldRef, }: UsePickerViewParams<TValue, TView, TSection, TExternalProps, TAdditionalProps>) => UsePickerViewsResponse<TView>;
 export {};

package/internals/hooks/usePickerPrivateContext.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Returns the private context passed by the picker that wraps the current component.
+ */
+export declare const usePickerPrivateContext: () => import("../components/PickerProvider").PickerPrivateContextValue;

package/internals/hooks/usePickerPrivateContext.js

@@ -0,0 +1,9 @@
+'use client';
+
+import * as React from 'react';
+import { PickerPrivateContext } from "../components/PickerProvider.js";
+
+/**
+ * Returns the private context passed by the picker that wraps the current component.
+ */
+export const usePickerPrivateContext = () => React.useContext(PickerPrivateContext);

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

@@ -1,6 +1,5 @@
 import * as React from 'react';
 import { UseStaticPickerParams, UseStaticPickerProps } from './useStaticPicker.types';
-import { PickerValidDate } from '../../../models';
 import { DateOrTimeViewWithMeridiem } from '../../models';
 /**
  * Hook managing all the single-date static pickers:
@@ -8,6 +7,6 @@ import { DateOrTimeViewWithMeridiem } from '../../models';
  * - StaticDateTimePicker
  * - StaticTimePicker
  */
-export declare const useStaticPicker: <TDate extends PickerValidDate, TView extends DateOrTimeViewWithMeridiem, TExternalProps extends UseStaticPickerProps<TDate, TView, any, TExternalProps>>({ props, ref, ...pickerParams }: UseStaticPickerParams<TDate, TView, TExternalProps>) => {
+export declare const useStaticPicker: <TView extends DateOrTimeViewWithMeridiem, TExternalProps extends UseStaticPickerProps<TView, any, TExternalProps>>({ props, ref, ...pickerParams }: UseStaticPickerParams<TView, TExternalProps>) => {
     renderPicker: () => React.JSX.Element;
 };

package/internals/hooks/useStaticPicker/useStaticPicker.js

@@ -5,7 +5,7 @@ import * as React from 'react';
 import clsx from 'clsx';
 import { styled } from '@mui/material/styles';
 import { usePicker } from "../usePicker/index.js";
-import { LocalizationProvider } from "../../../LocalizationProvider/index.js";
+import { PickerProvider } from "../../components/PickerProvider.js";
 import { PickersLayout } from "../../../PickersLayout/index.js";
 import { DIALOG_WIDTH } from "../../constants/dimensions.js";
 import { jsx as _jsx } from "react/jsx-runtime";
@@ -40,17 +40,18 @@ export const useStaticPicker = _ref => {
   } = props;
   const {
     layoutProps,
+    providerProps,
     renderCurrentView
   } = usePicker(_extends({}, pickerParams, {
     props,
     autoFocusView: autoFocus ?? false,
     fieldRef: undefined,
+    localeText,
     additionalViewProps: {},
     wrapperVariant: displayStaticWrapperAs
   }));
   const Layout = slots?.layout ?? PickerStaticLayout;
-  const renderPicker = () => /*#__PURE__*/_jsx(LocalizationProvider, {
-    localeText: localeText,
+  const renderPicker = () => /*#__PURE__*/_jsx(PickerProvider, _extends({}, providerProps, {
     children: /*#__PURE__*/_jsx(Layout, _extends({}, layoutProps, slotProps?.layout, {
       slots: slots,
       slotProps: slotProps,
@@ -59,7 +60,7 @@ export const useStaticPicker = _ref => {
       ref: ref,
       children: renderCurrentView()
     }))
-  });
+  }));
   return {
     renderPicker
   };

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

@@ -1,16 +1,16 @@
 import type { PickerValueManager } from './usePicker';
-import { PickersTimezone, PickerValidDate } from '../../models';
+import { PickersTimezone } from '../../models';
 /**
  * Hooks making sure that:
  * - 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, }: {
+export declare const useValueWithTimezone: <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>;
+    valueManager: PickerValueManager<TValue, any>;
 }) => {
     value: TValue;
     handleValueChange: TChange;
@@ -19,13 +19,13 @@ 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, }: {
+export declare const useControlledValueWithTimezone: <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>;
+    valueManager: PickerValueManager<TValue, any>;
 }) => {
     value: TValue;
     handleValueChange: TChange;

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 { FormProps } from './models/formProps';
 export type { WrapperVariant, 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/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`.