@mui/x-date-pickers 8.0.0-alpha.6 → 8.0.0-alpha.8

package/TimeField/TimeField.types.d.ts

@@ -1,14 +1,11 @@
-import * as React from 'react';
-import type { TextFieldProps } from '@mui/material/TextField';
-import { MakeOptional, SlotComponentPropsFromProps } from '@mui/x-internals/types';
+import { MakeOptional } from '@mui/x-internals/types';
 import { UseFieldInternalProps } from '../internals/hooks/useField';
-import { TimeValidationError, BuiltInFieldTextFieldProps, FieldOwnerState } from '../models';
-import { ExportedUseClearableFieldProps, UseClearableFieldSlots, UseClearableFieldSlotProps } from '../hooks/useClearableField';
+import { TimeValidationError, BuiltInFieldTextFieldProps } from '../models';
 import { ExportedValidateTimeProps } from '../validation/validateTime';
 import { AmPmProps } from '../internals/models/props/time';
 import { PickerValue } from '../internals/models';
-import { PickersTextFieldProps } from '../PickersTextField';
-export interface UseTimeFieldProps<TEnableAccessibleFieldDOMStructure extends boolean> extends MakeOptional<UseFieldInternalProps<PickerValue, TEnableAccessibleFieldDOMStructure, TimeValidationError>, 'format'>, ExportedValidateTimeProps, ExportedUseClearableFieldProps, AmPmProps {
+import { ExportedPickerFieldUIProps, PickerFieldUISlotProps, PickerFieldUISlots } from '../internals/components/PickerFieldUI';
+export interface UseTimeFieldProps<TEnableAccessibleFieldDOMStructure extends boolean> extends MakeOptional<UseFieldInternalProps<PickerValue, TEnableAccessibleFieldDOMStructure, TimeValidationError>, 'format'>, ExportedValidateTimeProps, ExportedPickerFieldUIProps, AmPmProps {
 }
 export type TimeFieldProps<TEnableAccessibleFieldDOMStructure extends boolean = true> = UseTimeFieldProps<TEnableAccessibleFieldDOMStructure> & Omit<BuiltInFieldTextFieldProps<TEnableAccessibleFieldDOMStructure>, keyof UseTimeFieldProps<TEnableAccessibleFieldDOMStructure>> & {
     /**
@@ -22,13 +19,7 @@ export type TimeFieldProps<TEnableAccessibleFieldDOMStructure extends boolean =
      */
     slotProps?: TimeFieldSlotProps;
 };
-export interface TimeFieldSlots extends UseClearableFieldSlots {
-    /**
-     * Form control with an input to render the value.
-     * @default <PickersTextField />, or <TextField /> from '@mui/material' if `enableAccessibleFieldDOMStructure` is `false`.
-     */
-    textField?: React.ElementType;
+export interface TimeFieldSlots extends PickerFieldUISlots {
 }
-export interface TimeFieldSlotProps extends UseClearableFieldSlotProps {
-    textField?: SlotComponentPropsFromProps<PickersTextFieldProps | TextFieldProps, {}, FieldOwnerState>;
+export interface TimeFieldSlotProps extends PickerFieldUISlotProps {
 }

package/TimeField/useTimeField.d.ts

@@ -1,2 +1,2 @@
 import { UseTimeFieldProps } from './TimeField.types';
-export declare const useTimeField: <TEnableAccessibleFieldDOMStructure extends boolean, TAllProps extends UseTimeFieldProps<TEnableAccessibleFieldDOMStructure>>(inProps: TAllProps) => import("../internals").UseFieldResponse<TEnableAccessibleFieldDOMStructure, Omit<TAllProps & Omit<UseTimeFieldProps<TEnableAccessibleFieldDOMStructure>, keyof import("../internals/hooks/defaultizedFieldProps").UseDefaultizedTimeFieldBaseProps> & Required<Pick<UseTimeFieldProps<TEnableAccessibleFieldDOMStructure>, keyof import("../internals/hooks/defaultizedFieldProps").UseDefaultizedTimeFieldBaseProps>>, "disabled" | "format" | "onChange" | "onError" | "defaultValue" | "value" | "readOnly" | "ampm" | "timezone" | "referenceDate" | "formatDensity" | "shouldRespectLeadingZeros" | "selectedSections" | "onSelectedSectionsChange" | "unstableFieldRef" | "enableAccessibleFieldDOMStructure" | keyof import("../internals").BaseTimeValidationProps | keyof import("../internals").TimeValidationProps | "dateSeparator">>;
+export declare const useTimeField: <TEnableAccessibleFieldDOMStructure extends boolean, TAllProps extends UseTimeFieldProps<TEnableAccessibleFieldDOMStructure>>(props: TAllProps) => import("../internals").UseFieldResponse<TEnableAccessibleFieldDOMStructure, Omit<TAllProps, "disabled" | "readOnly" | "value" | "defaultValue" | "autoFocus" | "onChange" | "onError" | "format" | "ampm" | "timezone" | keyof import("../internals").BaseTimeValidationProps | keyof import("../internals").TimeValidationProps | "referenceDate" | "formatDensity" | "shouldRespectLeadingZeros" | "selectedSections" | "onSelectedSectionsChange" | "unstableFieldRef" | "unstableStartFieldRef" | "unstableEndFieldRef" | "enableAccessibleFieldDOMStructure" | "dateSeparator">>;

package/TimeField/useTimeField.js

@@ -1,22 +1,25 @@
 'use client';
 
-import { singleItemFieldValueManager, singleItemValueManager } from "../internals/utils/valueManagers.js";
-import { useField } from "../internals/hooks/useField/index.js";
-import { validateTime } from "../validation/index.js";
+import { useField, useFieldInternalPropsWithDefaults } from "../internals/hooks/useField/index.js";
 import { useSplitFieldProps } from "../hooks/index.js";
-import { useDefaultizedTimeField } from "../internals/hooks/defaultizedFieldProps.js";
-export const useTimeField = inProps => {
-  const props = useDefaultizedTimeField(inProps);
+import { useTimeManager } from "../managers/index.js";
+export const useTimeField = props => {
+  const manager = useTimeManager(props);
   const {
     forwardedProps,
     internalProps
   } = useSplitFieldProps(props, 'time');
+  const internalPropsWithDefaults = useFieldInternalPropsWithDefaults({
+    manager,
+    internalProps
+  });
   return useField({
     forwardedProps,
-    internalProps,
-    valueManager: singleItemValueManager,
-    fieldValueManager: singleItemFieldValueManager,
-    validator: validateTime,
-    valueType: 'time'
+    internalProps: internalPropsWithDefaults,
+    valueManager: manager.internal_valueManager,
+    fieldValueManager: manager.internal_fieldValueManager,
+    validator: manager.validator,
+    valueType: manager.valueType,
+    getOpenPickerButtonAriaLabel: manager.internal_getOpenPickerButtonAriaLabel
   });
 };

package/TimePicker/TimePicker.js

@@ -69,8 +69,8 @@ process.env.NODE_ENV !== "production" ? TimePicker.propTypes = {
   autoFocus: PropTypes.bool,
   className: PropTypes.string,
   /**
-   * If `true`, the popover or modal will close after submitting the full date.
-   * @default `true` for desktop, `false` for mobile (based on the chosen wrapper and `desktopModeMediaQuery` prop).
+   * If `true`, the Picker will close after submitting the full date.
+   * @default false
    */
   closeOnSelect: PropTypes.bool,
   /**

package/TimePicker/TimePickerToolbar.d.ts

@@ -1,8 +1,7 @@
 import * as React from 'react';
 import { BaseToolbarProps, ExportedBaseToolbarProps } from '../internals/models/props/toolbar';
 import { TimePickerToolbarClasses } from './timePickerToolbarClasses';
-import { PickerValue } from '../internals/models';
-export interface TimePickerToolbarProps extends BaseToolbarProps<PickerValue>, ExportedTimePickerToolbarProps {
+export interface TimePickerToolbarProps extends BaseToolbarProps, ExportedTimePickerToolbarProps {
     ampm?: boolean;
     ampmInClock?: boolean;
 }

package/TimePicker/TimePickerToolbar.js

@@ -2,7 +2,7 @@
 
 import _extends from "@babel/runtime/helpers/esm/extends";
 import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
-const _excluded = ["ampm", "ampmInClock", "value", "isLandscape", "onChange", "className", "classes"];
+const _excluded = ["ampm", "ampmInClock", "className", "classes"];
 import * as React from 'react';
 import clsx from 'clsx';
 import PropTypes from 'prop-types';
@@ -122,9 +122,6 @@ function TimePickerToolbar(inProps) {
   const {
       ampm,
       ampmInClock,
-      value,
-      isLandscape,
-      onChange,
       className,
       classes: classesProp
     } = props,
@@ -134,18 +131,27 @@ function TimePickerToolbar(inProps) {
   const ownerState = useToolbarOwnerState();
   const classes = useUtilityClasses(classesProp, ownerState);
   const {
+    value,
+    setValue,
     disabled,
     readOnly,
     view,
-    onViewChange,
+    setView,
     views
   } = usePickerContext();
   const showAmPmControl = Boolean(ampm && !ampmInClock && views.includes('hours'));
   const {
     meridiemMode,
     handleMeridiemChange
-  } = useMeridiemMode(value, ampm, onChange);
-  const formatHours = time => ampm ? utils.format(time, 'hours12h') : utils.format(time, 'hours24h');
+  } = useMeridiemMode(value, ampm, newValue => setValue(newValue, {
+    changeImportance: 'set'
+  }));
+  const formatSection = format => {
+    if (!utils.isValid(value)) {
+      return '--';
+    }
+    return utils.format(value, format);
+  };
   const separator = /*#__PURE__*/_jsx(TimePickerToolbarSeparator, {
     tabIndex: -1,
     value: ":",
@@ -156,7 +162,6 @@ function TimePickerToolbar(inProps) {
   return /*#__PURE__*/_jsxs(TimePickerToolbarRoot, _extends({
     landscapeDirection: "row",
     toolbarTitle: translations.timePickerToolbarTitle,
-    isLandscape: isLandscape,
     ownerState: ownerState,
     className: clsx(classes.root, className)
   }, other, {
@@ -166,20 +171,20 @@ function TimePickerToolbar(inProps) {
       children: [arrayIncludes(views, 'hours') && /*#__PURE__*/_jsx(PickersToolbarButton, {
         tabIndex: -1,
         variant: "h3",
-        onClick: () => onViewChange('hours'),
+        onClick: () => setView('hours'),
         selected: view === 'hours',
-        value: value ? formatHours(value) : '--'
+        value: formatSection(ampm ? 'hours12h' : 'hours24h')
       }), arrayIncludes(views, ['hours', 'minutes']) && separator, arrayIncludes(views, 'minutes') && /*#__PURE__*/_jsx(PickersToolbarButton, {
         tabIndex: -1,
         variant: "h3",
-        onClick: () => onViewChange('minutes'),
+        onClick: () => setView('minutes'),
         selected: view === 'minutes',
-        value: value ? utils.format(value, 'minutes') : '--'
+        value: formatSection('minutes')
       }), arrayIncludes(views, ['minutes', 'seconds']) && separator, arrayIncludes(views, 'seconds') && /*#__PURE__*/_jsx(PickersToolbarButton, {
         variant: "h3",
-        onClick: () => onViewChange('seconds'),
+        onClick: () => setView('seconds'),
         selected: view === 'seconds',
-        value: value ? utils.format(value, 'seconds') : '--'
+        value: formatSection('seconds')
       })]
     }), showAmPmControl && /*#__PURE__*/_jsxs(TimePickerToolbarAmPmSelection, {
       className: classes.ampmSelection,
@@ -221,8 +226,6 @@ process.env.NODE_ENV !== "production" ? TimePickerToolbar.propTypes = {
    * @default `true` for Desktop, `false` for Mobile.
    */
   hidden: PropTypes.bool,
-  isLandscape: PropTypes.bool.isRequired,
-  onChange: PropTypes.func.isRequired,
   /**
    * The system prop that allows defining system overrides as well as additional CSS styles.
    */
@@ -236,7 +239,6 @@ process.env.NODE_ENV !== "production" ? TimePickerToolbar.propTypes = {
    * Toolbar value placeholder—it is displayed when the value is empty.
    * @default "––"
    */
-  toolbarPlaceholder: PropTypes.node,
-  value: PropTypes.object
+  toolbarPlaceholder: PropTypes.node
 } : void 0;
 export { TimePickerToolbar };

package/TimePicker/shared.d.ts

@@ -20,7 +20,7 @@ export interface BaseTimePickerSlots extends TimeClockSlots {
 export interface BaseTimePickerSlotProps extends TimeClockSlotProps {
     toolbar?: ExportedTimePickerToolbarProps;
 }
-export type TimePickerViewRenderers<TView extends TimeViewWithMeridiem, TAdditionalProps extends {} = {}> = PickerViewRendererLookup<PickerValue, TView, TimeViewRendererProps<TView, BaseClockProps<TView>>, TAdditionalProps>;
+export type TimePickerViewRenderers<TView extends TimeViewWithMeridiem> = PickerViewRendererLookup<PickerValue, TView, TimeViewRendererProps<TView, BaseClockProps<TView>>>;
 export interface BaseTimePickerProps<TView extends TimeViewWithMeridiem> extends BasePickerInputProps<PickerValue, TView, TimeValidationError>, ExportedBaseClockProps {
     /**
      * Display ampm controls under the clock (instead of in the toolbar).

package/hooks/index.d.ts

@@ -5,3 +5,4 @@ export { useSplitFieldProps } from './useSplitFieldProps';
 export { useParsedFormat } from './useParsedFormat';
 export { usePickerContext } from './usePickerContext';
 export { usePickerActionsContext } from './usePickerActionsContext';
+export { useIsValidValue } from './useIsValidValue';

package/hooks/index.js

@@ -3,4 +3,5 @@ export { usePickerTranslations } from "./usePickerTranslations.js";
 export { useSplitFieldProps } from "./useSplitFieldProps.js";
 export { useParsedFormat } from "./useParsedFormat.js";
 export { usePickerContext } from "./usePickerContext.js";
-export { usePickerActionsContext } from "./usePickerActionsContext.js";
+export { usePickerActionsContext } from "./usePickerActionsContext.js";
+export { useIsValidValue } from "./useIsValidValue.js";

package/hooks/useIsValidValue.d.ts

@@ -0,0 +1,7 @@
+import * as React from 'react';
+import { PickerValidValue } from '../internals/models';
+export declare const IsValidValueContext: React.Context<(value: any) => boolean>;
+/**
+ * Returns a function to check if a value is valid according to the validation props passed to the parent picker.
+ */
+export declare function useIsValidValue<TValue extends PickerValidValue>(): (value: TValue) => boolean;

package/hooks/useIsValidValue.js

@@ -0,0 +1,11 @@
+'use client';
+
+import * as React from 'react';
+export const IsValidValueContext = /*#__PURE__*/React.createContext(() => true);
+
+/**
+ * Returns a function to check if a value is valid according to the validation props passed to the parent picker.
+ */
+export function useIsValidValue() {
+  return React.useContext(IsValidValueContext);
+}

package/hooks/useParsedFormat.d.ts

@@ -1,14 +1,16 @@
-import type { UseFieldInternalProps } from '../internals/hooks/useField';
-interface UseParsedFormatParameters extends Pick<UseFieldInternalProps<any, any, any>, 'format' | 'formatDensity' | 'shouldRespectLeadingZeros'> {
+interface UseParsedFormatParameters {
+    /**
+     * Format to parse.
+     * @default the format provided by the picker.
+     */
+    format?: string;
 }
 /**
  * Returns the parsed format to be rendered in the field when there is no value or in other parts of the Picker.
  * This format is localized (for example `AAAA` for the year with the French locale) and cannot be parsed by your date library.
  * @param {object} The parameters needed to build the placeholder.
- * @param {string} params.format Format of the date to use.
- * @param {'dense' | 'spacious'} params.formatDensity Density of the format (setting `formatDensity` to `"spacious"` will add a space before and after each `/`, `-` and `.` character).
- * @param {boolean} params.shouldRespectLeadingZeros If `true`, the format will respect the leading zeroes, if `false`, the format will always add leading zeroes.
+ * @param {string} params.format Format to parse.
  * @returns
  */
-export declare const useParsedFormat: (parameters: UseParsedFormatParameters) => string;
+export declare const useParsedFormat: (parameters?: UseParsedFormatParameters) => string;
 export {};

package/hooks/useParsedFormat.js

@@ -6,32 +6,30 @@ import { useUtils } from "../internals/hooks/useUtils.js";
 import { buildSectionsFromFormat } from "../internals/hooks/useField/buildSectionsFromFormat.js";
 import { getLocalizedDigits } from "../internals/hooks/useField/useField.utils.js";
 import { usePickerTranslations } from "./usePickerTranslations.js";
+import { useNullablePickerContext } from "../internals/hooks/useNullablePickerContext.js";
 /**
  * Returns the parsed format to be rendered in the field when there is no value or in other parts of the Picker.
  * This format is localized (for example `AAAA` for the year with the French locale) and cannot be parsed by your date library.
  * @param {object} The parameters needed to build the placeholder.
- * @param {string} params.format Format of the date to use.
- * @param {'dense' | 'spacious'} params.formatDensity Density of the format (setting `formatDensity` to `"spacious"` will add a space before and after each `/`, `-` and `.` character).
- * @param {boolean} params.shouldRespectLeadingZeros If `true`, the format will respect the leading zeroes, if `false`, the format will always add leading zeroes.
+ * @param {string} params.format Format to parse.
  * @returns
  */
-export const useParsedFormat = parameters => {
-  const {
-    format,
-    formatDensity = 'dense',
-    shouldRespectLeadingZeros = false
-  } = parameters;
+export const useParsedFormat = (parameters = {}) => {
+  const pickerContext = useNullablePickerContext();
   const utils = useUtils();
   const isRtl = useRtl();
   const translations = usePickerTranslations();
   const localizedDigits = React.useMemo(() => getLocalizedDigits(utils), [utils]);
+  const {
+    format = pickerContext?.fieldFormat ?? utils.formats.fullDate
+  } = parameters;
   return React.useMemo(() => {
     const sections = buildSectionsFromFormat({
       utils,
       format,
-      formatDensity,
+      formatDensity: 'dense',
       isRtl,
-      shouldRespectLeadingZeros,
+      shouldRespectLeadingZeros: true,
       localeText: translations,
       localizedDigits,
       date: null,
@@ -39,5 +37,5 @@ export const useParsedFormat = parameters => {
       enableAccessibleFieldDOMStructure: false
     });
     return sections.map(section => `${section.startSeparator}${section.placeholder}${section.endSeparator}`).join('');
-  }, [utils, isRtl, translations, localizedDigits, format, formatDensity, shouldRespectLeadingZeros]);
+  }, [utils, isRtl, translations, localizedDigits, format]);
 };

package/hooks/usePickerActionsContext.d.ts

@@ -1,5 +1,7 @@
+import { PickerActionsContextValue } from '../internals/components/PickerProvider';
+import { DateOrTimeViewWithMeridiem, PickerValidValue, PickerValue } from '../internals/models';
 /**
  * Returns a subset of the context passed by the picker wrapping the current component.
  * It only contains the actions and never causes a re-render of the component using it.
  */
-export declare const usePickerActionsContext: () => import("../internals/components/PickerProvider").PickerActionsContextValue;
+export declare const usePickerActionsContext: <TValue extends PickerValidValue = PickerValue, TView extends DateOrTimeViewWithMeridiem = DateOrTimeViewWithMeridiem, TError = string | null>() => PickerActionsContextValue<TValue, TView, TError>;

package/hooks/usePickerActionsContext.js

@@ -2,7 +2,6 @@
 
 import * as React from 'react';
 import { PickerActionsContext } from "../internals/components/PickerProvider.js";
-
 /**
  * Returns a subset of the context passed by the picker wrapping the current component.
  * It only contains the actions and never causes a re-render of the component using it.

package/hooks/usePickerContext.d.ts

@@ -1,6 +1,8 @@
-import { PickerContextValue } from '../internals/components/PickerProvider';
-import { DateOrTimeViewWithMeridiem } from '../internals/models';
+import * as React from 'react';
+import type { PickerContextValue } from '../internals/components/PickerProvider';
+import { DateOrTimeViewWithMeridiem, PickerValidValue, PickerValue } from '../internals/models';
+export declare const PickerContext: React.Context<PickerContextValue<any, any, any> | null>;
 /**
  * Returns the context passed by the picker that wraps the current component.
  */
-export declare const usePickerContext: <TView extends DateOrTimeViewWithMeridiem = DateOrTimeViewWithMeridiem>() => PickerContextValue<TView>;
+export declare const usePickerContext: <TValue extends PickerValidValue = PickerValue, TView extends DateOrTimeViewWithMeridiem = DateOrTimeViewWithMeridiem, TError = string | null>() => PickerContextValue<TValue, TView, TError>;

package/hooks/usePickerContext.js

@@ -1,14 +1,15 @@
 'use client';
 
 import * as React from 'react';
-import { PickerContext } from "../internals/components/PickerProvider.js";
+export const PickerContext = /*#__PURE__*/React.createContext(null);
+
 /**
  * Returns the context passed by the picker that wraps the current component.
  */
 export const usePickerContext = () => {
   const value = React.useContext(PickerContext);
   if (value == null) {
-    throw new Error(['MUI X: The `usePickerContext` can only be called in fields that are used as a slot of a picker component'].join('\n'));
+    throw new Error('MUI X: The `usePickerContext` hook can only be called inside the context of a picker component');
   }
   return value;
 };

package/hooks/useSplitFieldProps.d.ts

@@ -1,19 +1,28 @@
 import { DATE_TIME_VALIDATION_PROP_NAMES, DATE_VALIDATION_PROP_NAMES, TIME_VALIDATION_PROP_NAMES } from '../validation/extractValidationProps';
 import { PickerValueType } from '../models/common';
-declare const SHARED_FIELD_INTERNAL_PROP_NAMES: readonly ["value", "defaultValue", "referenceDate", "format", "formatDensity", "onChange", "timezone", "onError", "shouldRespectLeadingZeros", "selectedSections", "onSelectedSectionsChange", "unstableFieldRef", "enableAccessibleFieldDOMStructure", "disabled", "readOnly", "dateSeparator"];
+declare const SHARED_FIELD_INTERNAL_PROP_NAMES: readonly ["value", "defaultValue", "referenceDate", "format", "formatDensity", "onChange", "timezone", "onError", "shouldRespectLeadingZeros", "selectedSections", "onSelectedSectionsChange", "unstableFieldRef", "unstableStartFieldRef", "unstableEndFieldRef", "enableAccessibleFieldDOMStructure", "disabled", "readOnly", "dateSeparator", "autoFocus"];
 type InternalPropNames<TValueType extends PickerValueType> = (typeof SHARED_FIELD_INTERNAL_PROP_NAMES)[number] | (TValueType extends 'date' | 'date-time' ? (typeof DATE_VALIDATION_PROP_NAMES)[number] : never) | (TValueType extends 'time' | 'date-time' ? (typeof TIME_VALIDATION_PROP_NAMES)[number] : never) | (TValueType extends 'date-time' ? (typeof DATE_TIME_VALIDATION_PROP_NAMES)[number] : never);
 /**
  * Split the props received by the field component into:
  * - `internalProps` which are used by the various hooks called by the field component.
  * - `forwardedProps` which are passed to the underlying component.
  * Note that some forwarded props might be used by the hooks as well.
- * For instance, hooks like `useDateField` need props like `autoFocus` to know how to behave.
+ * For instance, hooks like `useDateField` need props like `onKeyDown` to merge the default event handler and the one provided by the application.
  * @template TProps, TValueType
  * @param {TProps} props The props received by the field component.
  * @param {TValueType} valueType The type of the field value ('date', 'time', or 'date-time').
  */
 export declare const useSplitFieldProps: <TValueType extends PickerValueType, TProps extends { [key in InternalPropNames<TValueType>]?: any; }>(props: TProps, valueType: TValueType) => {
     forwardedProps: Omit<TProps, InternalPropNames<TValueType>>;
-    internalProps: Pick<TProps, InternalPropNames<TValueType>>;
+    internalProps: ExtractInternalProps<TValueType, TProps>;
+};
+/**
+ * Extract the internal props from the props received by the field component.
+ * This makes sure that the internal props not defined in the props are not present in the result.
+ */
+type ExtractInternalProps<TValueType extends PickerValueType, TProps extends {
+    [key in InternalPropNames<TValueType>]?: any;
+}> = {
+    [K in keyof TProps]: K extends InternalPropNames<TValueType> ? TProps[K] : never;
 };
 export {};

package/hooks/useSplitFieldProps.js

@@ -3,13 +3,13 @@
 import _extends from "@babel/runtime/helpers/esm/extends";
 import * as React from 'react';
 import { DATE_TIME_VALIDATION_PROP_NAMES, DATE_VALIDATION_PROP_NAMES, TIME_VALIDATION_PROP_NAMES } from "../validation/extractValidationProps.js";
-const SHARED_FIELD_INTERNAL_PROP_NAMES = ['value', 'defaultValue', 'referenceDate', 'format', 'formatDensity', 'onChange', 'timezone', 'onError', 'shouldRespectLeadingZeros', 'selectedSections', 'onSelectedSectionsChange', 'unstableFieldRef', 'enableAccessibleFieldDOMStructure', 'disabled', 'readOnly', 'dateSeparator'];
+const SHARED_FIELD_INTERNAL_PROP_NAMES = ['value', 'defaultValue', 'referenceDate', 'format', 'formatDensity', 'onChange', 'timezone', 'onError', 'shouldRespectLeadingZeros', 'selectedSections', 'onSelectedSectionsChange', 'unstableFieldRef', 'unstableStartFieldRef', 'unstableEndFieldRef', 'enableAccessibleFieldDOMStructure', 'disabled', 'readOnly', 'dateSeparator', 'autoFocus'];
 /**
  * Split the props received by the field component into:
  * - `internalProps` which are used by the various hooks called by the field component.
  * - `forwardedProps` which are passed to the underlying component.
  * Note that some forwarded props might be used by the hooks as well.
- * For instance, hooks like `useDateField` need props like `autoFocus` to know how to behave.
+ * For instance, hooks like `useDateField` need props like `onKeyDown` to merge the default event handler and the one provided by the application.
  * @template TProps, TValueType
  * @param {TProps} props The props received by the field component.
  * @param {TValueType} valueType The type of the field value ('date', 'time', or 'date-time').
@@ -40,4 +40,9 @@ export const useSplitFieldProps = (props, valueType) => {
       internalProps
     };
   }, [props, valueType]);
-};
+};
+
+/**
+ * Extract the internal props from the props received by the field component.
+ * This makes sure that the internal props not defined in the props are not present in the result.
+ */

package/index.d.ts

@@ -36,3 +36,4 @@ export * from './models';
 export * from './icons';
 export * from './hooks';
 export * from './validation';
+export * from './managers';

package/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/x-date-pickers v8.0.0-alpha.6
+ * @mui/x-date-pickers v8.0.0-alpha.8
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the
@@ -57,4 +57,5 @@ export { DEFAULT_DESKTOP_MODE_MEDIA_QUERY } from "./internals/utils/utils.js";
 export * from "./models/index.js";
 export * from "./icons/index.js";
 export * from "./hooks/index.js";
-export * from "./validation/index.js";
+export * from "./validation/index.js";
+export * from "./managers/index.js";

package/internals/components/PickerFieldUI.d.ts

@@ -0,0 +1,132 @@
+import * as React from 'react';
+import { TextFieldProps } from '@mui/material/TextField';
+import { IconButtonProps } from '@mui/material/IconButton';
+import { InputAdornmentProps } from '@mui/material/InputAdornment';
+import { SvgIconProps } from '@mui/material/SvgIcon';
+import { MakeOptional, SlotComponentPropsFromProps } from '@mui/x-internals/types';
+import { FieldOwnerState } from '../../models';
+import { UseFieldOwnerStateParameters } from '../hooks/useFieldOwnerState';
+import type { UseFieldResponse } from '../hooks/useField';
+import { PickersTextFieldProps } from '../../PickersTextField';
+export declare const cleanFieldResponse: <TFieldResponse extends MakeOptional<UseFieldResponse<any, ExportedPickerFieldUIProps & {
+    [key: string]: any;
+}>, "onClear" | "clearable">>({ enableAccessibleFieldDOMStructure, ...fieldResponse }: TFieldResponse) => ExportedPickerFieldUIProps & {
+    openPickerAriaLabel: string;
+    textFieldProps: TextFieldProps | PickersTextFieldProps;
+};
+/**
+ * Adds the button to open the picker and the button to clear the value of the field.
+ * @ignore - internal component.
+ */
+export declare function PickerFieldUI(props: PickerFieldUIProps): React.JSX.Element;
+export interface ExportedPickerFieldUIProps {
+    /**
+     * If `true`, a clear button will be shown in the field allowing value clearing.
+     * @default false
+     */
+    clearable?: boolean;
+    /**
+     * Callback fired when the clear button is clicked.
+     */
+    onClear?: React.MouseEventHandler;
+    /**
+     * The position at which the clear button is placed.
+     * If the field is not clearable, the button is not rendered.
+     * @default 'end'
+     */
+    clearButtonPosition?: 'start' | 'end';
+    /**
+     * The position at which the opening button is placed.
+     * If there is no picker to open, the button is not rendered
+     * @default 'end'
+     */
+    openPickerButtonPosition?: 'start' | 'end';
+}
+export interface PickerFieldUIProps {
+    /**
+     * Overridable component slots.
+     * @default {}
+     */
+    slots?: PickerFieldUISlots;
+    /**
+     * The props used for each component slot.
+     * @default {}
+     */
+    slotProps?: PickerFieldUISlotProps;
+    /**
+     * Object returned by the `useField` hook or one of its wrapper (for example `useDateField`).
+     */
+    fieldResponse: UseFieldResponse<any, any>;
+    /**
+     * The component to use to render the picker opening icon if none is provided in the picker's slots.
+     */
+    defaultOpenPickerIcon: React.ElementType;
+}
+export interface PickerFieldUISlots {
+    /**
+     * Form control with an input to render the value.
+     * @default <PickersTextField />, or <TextField /> from '@mui/material' if `enableAccessibleFieldDOMStructure` is `false`.
+     */
+    textField?: React.ElementType;
+    /**
+     * Component displayed on the start or end input adornment used to open the picker on desktop.
+     * @default InputAdornment
+     */
+    inputAdornment?: React.ElementType<InputAdornmentProps>;
+    /**
+     * Icon to display inside the clear button.
+     * @default ClearIcon
+     */
+    clearIcon?: React.ElementType;
+    /**
+     * Button to clear the value.
+     * @default IconButton
+     */
+    clearButton?: React.ElementType;
+}
+export interface PickerFieldUISlotsFromContext extends PickerFieldUISlots {
+    /**
+     * Button to open the picker on desktop.
+     * @default IconButton
+     */
+    openPickerButton?: React.ElementType<IconButtonProps>;
+    /**
+     * Icon displayed in the open picker button on desktop.
+     */
+    openPickerIcon?: React.ElementType;
+}
+export interface PickerFieldUISlotProps {
+    textField?: SlotComponentPropsFromProps<PickersTextFieldProps | TextFieldProps, {}, FieldOwnerState>;
+    inputAdornment?: SlotComponentPropsFromProps<InputAdornmentProps, {}, FieldInputAdornmentOwnerState>;
+    clearIcon?: SlotComponentPropsFromProps<SvgIconProps, {}, FieldOwnerState>;
+    clearButton?: SlotComponentPropsFromProps<IconButtonProps, {}, FieldOwnerState>;
+}
+export interface PickerFieldUISlotPropsFromContext extends PickerFieldUISlotProps {
+    openPickerButton?: SlotComponentPropsFromProps<IconButtonProps, {}, FieldOwnerState>;
+    openPickerIcon?: SlotComponentPropsFromProps<SvgIconProps, {}, FieldOwnerState>;
+}
+interface FieldInputAdornmentOwnerState extends FieldOwnerState {
+    position: 'start' | 'end';
+}
+/**
+ * The `textField` slot props cannot be handled inside `PickerFieldUI` because it would be a breaking change to not pass the enriched props to `useField`.
+ * Once the non-accessible DOM structure will be removed, we will be able to remove the `textField` slot and clean this logic.
+ */
+export declare function useFieldTextFieldProps<TProps extends UseFieldOwnerStateParameters & {
+    inputProps?: {};
+    InputProps?: {};
+}>(parameters: UseFieldTextFieldPropsParameters): TProps;
+interface UseFieldTextFieldPropsParameters {
+    slotProps: {
+        textField?: SlotComponentPropsFromProps<PickersTextFieldProps | TextFieldProps, {}, FieldOwnerState>;
+    } | undefined;
+    ref: React.Ref<HTMLDivElement>;
+    externalForwardedProps: any;
+}
+export declare function PickerFieldUIContextProvider(props: PickerFieldUIContextProviderProps): React.JSX.Element;
+interface PickerFieldUIContextProviderProps {
+    children: React.ReactNode;
+    slots: PickerFieldUISlotsFromContext | undefined;
+    slotProps: PickerFieldUISlotPropsFromContext | undefined;
+}
+export {};