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

package/YearCalendar/YearCalendar.js

@@ -7,9 +7,10 @@ import * as React from 'react';
 import PropTypes from 'prop-types';
 import clsx from 'clsx';
 import { useRtl } from '@mui/system/RtlProvider';
+import { shouldForwardProp } from '@mui/system/createStyled';
 import { styled, useThemeProps } from '@mui/material/styles';
 import { unstable_useForkRef as useForkRef, unstable_composeClasses as composeClasses, unstable_useControlled as useControlled, unstable_useEventCallback as useEventCallback } from '@mui/utils';
-import { PickersYear } from "./PickersYear.js";
+import { YearCalendarButton } from "./YearCalendarButton.js";
 import { useUtils, useNow, useDefaultDates } from "../internals/hooks/useUtils.js";
 import { getYearCalendarUtilityClass } from "./yearCalendarClasses.js";
 import { applyDefaultDate } from "../internals/utils/date-utils.js";
@@ -18,7 +19,7 @@ import { SECTION_TYPE_GRANULARITY } from "../internals/utils/getDefaultReference
 import { useControlledValueWithTimezone } from "../internals/hooks/useValueWithTimezone.js";
 import { DIALOG_WIDTH, MAX_CALENDAR_HEIGHT } from "../internals/constants/dimensions.js";
 import { usePickerPrivateContext } from "../internals/hooks/usePickerPrivateContext.js";
-import { jsx as _jsx } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 const useUtilityClasses = classes => {
   const slots = {
     root: ['root']
@@ -37,6 +38,7 @@ function useYearCalendarDefaultizedProps(props, name) {
     disableFuture: false
   }, themeProps, {
     yearsPerRow: themeProps.yearsPerRow ?? 3,
+    yearsOrder: themeProps.yearsOrder ?? 'asc',
     minDate: applyDefaultDate(utils, themeProps.minDate, defaultDates.minDate),
     maxDate: applyDefaultDate(utils, themeProps.maxDate, defaultDates.maxDate)
   });
@@ -44,19 +46,43 @@ function useYearCalendarDefaultizedProps(props, name) {
 const YearCalendarRoot = styled('div', {
   name: 'MuiYearCalendar',
   slot: 'Root',
-  overridesResolver: (props, styles) => styles.root
+  shouldForwardProp: prop => shouldForwardProp(prop) && prop !== 'yearsPerRow'
 })({
   display: 'flex',
-  flexDirection: 'row',
   flexWrap: 'wrap',
+  justifyContent: 'space-evenly',
+  rowGap: 12,
+  padding: '6px 0',
   overflowY: 'auto',
   height: '100%',
-  padding: '0 4px',
   width: DIALOG_WIDTH,
   maxHeight: MAX_CALENDAR_HEIGHT,
   // avoid padding increasing width over defined
   boxSizing: 'border-box',
-  position: 'relative'
+  position: 'relative',
+  variants: [{
+    props: {
+      yearsPerRow: 3
+    },
+    style: {
+      columnGap: 24
+    }
+  }, {
+    props: {
+      yearsPerRow: 4
+    },
+    style: {
+      columnGap: 0,
+      padding: '0 2px'
+    }
+  }]
+});
+const YearCalendarButtonFiller = styled('div', {
+  name: 'MuiYearCalendar',
+  slot: 'ButtonFiller'
+})({
+  height: 36,
+  width: 72
 });
 /**
  * Demos:
@@ -87,7 +113,7 @@ export const YearCalendar = /*#__PURE__*/React.forwardRef(function YearCalendar(
       onYearFocus,
       hasFocus,
       onFocusedViewChange,
-      yearsOrder = 'asc',
+      yearsOrder,
       yearsPerRow,
       timezone: timezoneProp,
       gridLabelId,
@@ -239,18 +265,23 @@ export const YearCalendar = /*#__PURE__*/React.forwardRef(function YearCalendar(
   if (yearsOrder === 'desc') {
     yearRange.reverse();
   }
-  return /*#__PURE__*/_jsx(YearCalendarRoot, _extends({
+  let fillerAmount = yearsPerRow - yearRange.length % yearsPerRow;
+  if (fillerAmount === yearsPerRow) {
+    fillerAmount = 0;
+  }
+  return /*#__PURE__*/_jsxs(YearCalendarRoot, _extends({
     ref: handleRef,
     className: clsx(classes.root, className),
     ownerState: ownerState,
     role: "radiogroup",
-    "aria-labelledby": gridLabelId
+    "aria-labelledby": gridLabelId,
+    yearsPerRow: yearsPerRow
   }, other, {
-    children: yearRange.map(year => {
+    children: [yearRange.map(year => {
       const yearNumber = utils.getYear(year);
       const isSelected = yearNumber === selectedYear;
       const isDisabled = disabled || isYearDisabled(year);
-      return /*#__PURE__*/_jsx(PickersYear, {
+      return /*#__PURE__*/_jsx(YearCalendarButton, {
         selected: isSelected,
         value: yearNumber,
         onClick: handleYearSelection,
@@ -261,12 +292,14 @@ export const YearCalendar = /*#__PURE__*/React.forwardRef(function YearCalendar(
         onFocus: handleYearFocus,
         onBlur: handleYearBlur,
         "aria-current": todayYear === yearNumber ? 'date' : undefined,
-        yearsPerRow: yearsPerRow,
         slots: slots,
         slotProps: slotProps,
+        classes: classesProp,
         children: utils.format(year, 'year')
       }, utils.format(year, 'year'));
-    })
+    }), Array.from({
+      length: fillerAmount
+    }, (_, index) => /*#__PURE__*/_jsx(YearCalendarButtonFiller, {}, index))]
   }));
 });
 process.env.NODE_ENV !== "production" ? YearCalendar.propTypes = {

package/YearCalendar/YearCalendar.types.d.ts

@@ -6,7 +6,7 @@ import { YearCalendarClasses } from './yearCalendarClasses';
 import { BaseDateValidationProps, YearValidationProps } from '../internals/models/validation';
 import { PickerOwnerState, PickerValidDate, TimezoneProps } from '../models';
 import { FormProps } from '../internals/models/formProps';
-export interface PickerYearOwnerState extends PickerOwnerState {
+export interface YearButtonOwnerState extends PickerOwnerState {
     isYearSelected: boolean;
     isYearDisabled: boolean;
 }
@@ -20,7 +20,7 @@ export interface YearCalendarSlots {
 export interface YearCalendarSlotProps {
     yearButton?: SlotComponentPropsFromProps<React.HTMLAttributes<HTMLButtonElement> & {
         sx: SxProps;
-    }, {}, PickerYearOwnerState>;
+    }, {}, YearButtonOwnerState>;
 }
 export interface ExportedYearCalendarProps {
     /**

package/YearCalendar/YearCalendarButton.d.ts

@@ -0,0 +1,23 @@
+import * as React from 'react';
+import { YearCalendarSlotProps, YearCalendarSlots } from './YearCalendar.types';
+import { YearCalendarClasses } from './yearCalendarClasses';
+export interface YearCalendarButtonProps {
+    value: number;
+    tabIndex: number;
+    selected: boolean;
+    disabled: boolean;
+    autoFocus: boolean;
+    classes: Partial<YearCalendarClasses> | undefined;
+    slots: YearCalendarSlots | undefined;
+    slotProps: YearCalendarSlotProps | undefined;
+    'aria-current': React.AriaAttributes['aria-current'];
+    children: React.ReactNode;
+    onClick: (event: React.MouseEvent, year: number) => void;
+    onKeyDown: (event: React.KeyboardEvent, year: number) => void;
+    onFocus: (event: React.FocusEvent, year: number) => void;
+    onBlur: (event: React.FocusEvent, year: number) => void;
+}
+/**
+ * @ignore - internal component.
+ */
+export declare const YearCalendarButton: React.NamedExoticComponent<YearCalendarButtonProps>;

package/{modern/YearCalendar/PickersYear.js → YearCalendar/YearCalendarButton.js}

@@ -1,47 +1,27 @@
 import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
 import _extends from "@babel/runtime/helpers/esm/extends";
-const _excluded = ["autoFocus", "className", "classes", "children", "disabled", "selected", "value", "tabIndex", "onClick", "onKeyDown", "onFocus", "onBlur", "aria-current", "yearsPerRow", "slots", "slotProps"];
+const _excluded = ["autoFocus", "classes", "disabled", "selected", "value", "onClick", "onKeyDown", "onFocus", "onBlur", "slots", "slotProps"];
 import * as React from 'react';
-import clsx from 'clsx';
-import { styled, alpha, useThemeProps } from '@mui/material/styles';
+import { styled, alpha } from '@mui/material/styles';
 import useSlotProps from '@mui/utils/useSlotProps';
 import composeClasses from '@mui/utils/composeClasses';
 import useEnhancedEffect from '@mui/utils/useEnhancedEffect';
-import { getPickersYearUtilityClass, pickersYearClasses } from "./pickersYearClasses.js";
 import { usePickerPrivateContext } from "../internals/hooks/usePickerPrivateContext.js";
+import { getYearCalendarUtilityClass, yearCalendarClasses } from "./yearCalendarClasses.js";
 import { jsx as _jsx } from "react/jsx-runtime";
 const useUtilityClasses = (classes, ownerState) => {
   const slots = {
-    root: ['root'],
-    yearButton: ['yearButton', ownerState.isYearDisabled && 'disabled', ownerState.isYearSelected && 'selected']
+    button: ['button', ownerState.isYearDisabled && 'disabled', ownerState.isYearSelected && 'selected']
   };
-  return composeClasses(slots, getPickersYearUtilityClass, classes);
+  return composeClasses(slots, getYearCalendarUtilityClass, classes);
 };
-const PickersYearRoot = styled('div', {
-  name: 'MuiPickersYear',
-  slot: 'Root',
-  overridesResolver: (_, styles) => [styles.root]
-})({
-  display: 'flex',
-  alignItems: 'center',
-  justifyContent: 'center',
-  flexBasis: '33.3%',
-  variants: [{
-    props: {
-      yearsPerRow: 4
-    },
-    style: {
-      flexBasis: '25%'
-    }
-  }]
-});
-const YearCalendarButton = styled('button', {
-  name: 'MuiPickersYear',
-  slot: 'YearButton',
-  overridesResolver: (_, styles) => [styles.yearButton, {
-    [`&.${pickersYearClasses.disabled}`]: styles.disabled
+const DefaultYearButton = styled('button', {
+  name: 'MuiYearCalendar',
+  slot: 'Button',
+  overridesResolver: (_, styles) => [styles.button, {
+    [`&.${yearCalendarClasses.disabled}`]: styles.disabled
   }, {
-    [`&.${pickersYearClasses.selected}`]: styles.selected
+    [`&.${yearCalendarClasses.selected}`]: styles.selected
   }]
 })(({
   theme
@@ -51,7 +31,6 @@ const YearCalendarButton = styled('button', {
   border: 0,
   outline: 0
 }, theme.typography.subtitle1, {
-  margin: '6px 0',
   height: 36,
   width: 72,
   borderRadius: 18,
@@ -66,10 +45,10 @@ const YearCalendarButton = styled('button', {
     cursor: 'auto',
     pointerEvents: 'none'
   },
-  [`&.${pickersYearClasses.disabled}`]: {
+  [`&.${yearCalendarClasses.disabled}`]: {
     color: (theme.vars || theme).palette.text.secondary
   },
-  [`&.${pickersYearClasses.selected}`]: {
+  [`&.${yearCalendarClasses.selected}`]: {
     color: (theme.vars || theme).palette.primary.contrastText,
     backgroundColor: (theme.vars || theme).palette.primary.main,
     '&:focus, &:hover': {
@@ -81,28 +60,17 @@ const YearCalendarButton = styled('button', {
 /**
  * @ignore - internal component.
  */
-export const PickersYear = /*#__PURE__*/React.memo(function PickersYear(inProps) {
-  const props = useThemeProps({
-    props: inProps,
-    name: 'MuiPickersYear'
-  });
+export const YearCalendarButton = /*#__PURE__*/React.memo(function YearCalendarButton(props) {
   const {
       autoFocus,
-      className,
       classes: classesProp,
-      children,
-      disabled = false,
-      selected = false,
+      disabled,
+      selected,
       value,
-      tabIndex,
       onClick,
       onKeyDown,
       onFocus,
       onBlur,
-      'aria-current': ariaCurrent
-      // We don't want to forward this prop to the root element
-      ,
-
       slots,
       slotProps
     } = props,
@@ -124,18 +92,16 @@ export const PickersYear = /*#__PURE__*/React.memo(function PickersYear(inProps)
       ref.current?.focus();
     }
   }, [autoFocus]);
-  const YearButton = slots?.yearButton ?? YearCalendarButton;
+  const YearButton = slots?.yearButton ?? DefaultYearButton;
   const yearButtonProps = useSlotProps({
     elementType: YearButton,
     externalSlotProps: slotProps?.yearButton,
+    externalForwardedProps: other,
     additionalProps: {
-      children,
       disabled,
-      tabIndex,
       ref,
       type: 'button',
       role: 'radio',
-      'aria-current': ariaCurrent,
       'aria-checked': selected,
       onClick: event => onClick(event, value),
       onKeyDown: event => onKeyDown(event, value),
@@ -143,12 +109,7 @@ export const PickersYear = /*#__PURE__*/React.memo(function PickersYear(inProps)
       onBlur: event => onBlur(event, value)
     },
     ownerState,
-    className: classes.yearButton
+    className: classes.button
   });
-  return /*#__PURE__*/_jsx(PickersYearRoot, _extends({
-    className: clsx(classes.root, className),
-    ownerState: ownerState
-  }, other, {
-    children: /*#__PURE__*/_jsx(YearButton, _extends({}, yearButtonProps))
-  }));
+  return /*#__PURE__*/_jsx(YearButton, _extends({}, yearButtonProps));
 });

package/YearCalendar/index.d.ts

@@ -2,6 +2,3 @@ export { YearCalendar } from './YearCalendar';
 export type { YearCalendarProps, YearCalendarSlots, YearCalendarSlotProps, } from './YearCalendar.types';
 export { yearCalendarClasses, getYearCalendarUtilityClass } from './yearCalendarClasses';
 export type { YearCalendarClasses, YearCalendarClassKey } from './yearCalendarClasses';
-export { pickersYearClasses } from './pickersYearClasses';
-export type { PickersYearClasses, PickersYearClassKey } from './pickersYearClasses';
-export type { ExportedPickersYearProps } from './PickersYear';

package/YearCalendar/index.js

@@ -1,3 +1,2 @@
 export { YearCalendar } from "./YearCalendar.js";
-export { yearCalendarClasses, getYearCalendarUtilityClass } from "./yearCalendarClasses.js";
-export { pickersYearClasses } from "./pickersYearClasses.js";
+export { yearCalendarClasses, getYearCalendarUtilityClass } from "./yearCalendarClasses.js";

package/YearCalendar/yearCalendarClasses.d.ts

@@ -1,7 +1,13 @@
 export interface YearCalendarClasses {
     /** Styles applied to the root element. */
     root: string;
+    /** Styles applied to the button element that represents a single year */
+    button: string;
+    /** Styles applied to a disabled button element. */
+    disabled: string;
+    /** Styles applied to a selected button element. */
+    selected: string;
 }
 export type YearCalendarClassKey = keyof YearCalendarClasses;
 export declare function getYearCalendarUtilityClass(slot: string): string;
-export declare const yearCalendarClasses: Record<"root", string>;
+export declare const yearCalendarClasses: Record<"button" | "disabled" | "selected" | "root", string>;

package/YearCalendar/yearCalendarClasses.js

@@ -2,4 +2,4 @@ import { unstable_generateUtilityClass as generateUtilityClass, unstable_generat
 export function getYearCalendarUtilityClass(slot) {
   return generateUtilityClass('MuiYearCalendar', slot);
 }
-export const yearCalendarClasses = generateUtilityClasses('MuiYearCalendar', ['root']);
+export const yearCalendarClasses = generateUtilityClasses('MuiYearCalendar', ['root', 'button', 'disabled', 'selected']);

package/hooks/index.d.ts

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

package/hooks/index.js

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

package/hooks/useClearableField.d.ts

@@ -3,6 +3,8 @@ import { SlotComponentProps } from '@mui/utils';
 import MuiIconButton from '@mui/material/IconButton';
 import { SxProps } from '@mui/system';
 import { ClearIcon } from '../icons';
+import { FieldOwnerState } from '../models/fields';
+import { FormProps } from '../internals/models';
 export interface ExportedUseClearableFieldProps {
     /**
      * If `true`, a clear button will be shown in the field allowing value clearing.
@@ -27,10 +29,10 @@ export interface UseClearableFieldSlots {
     clearButton?: React.ElementType;
 }
 export interface UseClearableFieldSlotProps {
-    clearIcon?: SlotComponentProps<typeof ClearIcon, {}, {}>;
-    clearButton?: SlotComponentProps<typeof MuiIconButton, {}, {}>;
+    clearIcon?: SlotComponentProps<typeof ClearIcon, {}, FieldOwnerState>;
+    clearButton?: SlotComponentProps<typeof MuiIconButton, {}, FieldOwnerState>;
 }
-interface UseClearableFieldProps extends ExportedUseClearableFieldProps {
+interface UseClearableFieldProps extends ExportedUseClearableFieldProps, FormProps {
     InputProps?: {
         endAdornment?: React.ReactNode;
     };

package/hooks/useClearableField.js

@@ -10,9 +10,11 @@ import MuiIconButton from '@mui/material/IconButton';
 import InputAdornment from '@mui/material/InputAdornment';
 import { ClearIcon } from "../icons/index.js";
 import { usePickerTranslations } from "./usePickerTranslations.js";
+import { useFieldOwnerState } from "../internals/hooks/useFieldOwnerState.js";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 export const useClearableField = props => {
   const translations = usePickerTranslations();
+  const ownerState = useFieldOwnerState(props);
   const {
       clearable,
       onClear,
@@ -27,7 +29,7 @@ export const useClearableField = props => {
   const _useSlotProps = useSlotProps({
       elementType: IconButton,
       externalSlotProps: slotProps?.clearButton,
-      ownerState: {},
+      ownerState,
       className: 'clearButton',
       additionalProps: {
         title: translations.fieldClearLabel,
@@ -39,7 +41,7 @@ export const useClearableField = props => {
   const endClearIconProps = useSlotProps({
     elementType: EndClearIcon,
     externalSlotProps: slotProps?.clearIcon,
-    ownerState: {}
+    ownerState
   });
   return _extends({}, other, {
     InputProps: _extends({}, InputProps, {

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, 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 (e.g: `AAAA` for the year with the French locale) and cannot be parsed by your date library.
+ * 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 (e.g: `AAAA` for the year with the French locale) and cannot be parsed by your date library.
+ * 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

@@ -0,0 +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: <TValue extends PickerValidValue = PickerValue, TView extends DateOrTimeViewWithMeridiem = DateOrTimeViewWithMeridiem, TError = string | null>() => PickerActionsContextValue<TValue, TView, TError>;

package/hooks/usePickerActionsContext.js

@@ -0,0 +1,15 @@
+'use client';
+
+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.
+ */
+export const usePickerActionsContext = () => {
+  const value = React.useContext(PickerActionsContext);
+  if (value == null) {
+    throw new Error(['MUI X: The `usePickerActionsContext` can only be called in fields that are used as a slot of a picker component'].join('\n'));
+  }
+  return value;
+};

package/hooks/usePickerContext.d.ts

@@ -1,4 +1,8 @@
+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: () => import("../internals/components/PickerProvider").PickerContextValue;
+export declare const usePickerContext: <TValue extends PickerValidValue = PickerValue, TView extends DateOrTimeViewWithMeridiem = DateOrTimeViewWithMeridiem, TError = string | null>() => PickerContextValue<TValue, TView, TError>;

package/hooks/usePickerContext.js

@@ -1,7 +1,7 @@
 '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.
@@ -9,7 +9,7 @@ import { PickerContext } from "../internals/components/PickerProvider.js";
 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.
+ */