@mui/x-date-pickers 7.0.0-beta.1 → 7.0.0-beta.4

package/models/fields.d.ts

@@ -1,5 +1,12 @@
 import * as React from 'react';
+import { TextFieldProps } from '@mui/material/TextField';
+import { SxProps } from '@mui/material/styles';
 import type { BaseFieldProps } from '../internals/models/fields';
+import type { ExportedUseClearableFieldProps, UseClearableFieldResponse, UseClearableFieldSlotProps, UseClearableFieldSlots } from '../hooks/useClearableField';
+import { ExportedPickersSectionListProps, PickersSectionListRef } from '../PickersSectionList';
+import type { UseFieldResponse } from '../internals/hooks/useField';
+import type { PickersTextFieldProps } from '../PickersTextField';
+import { PickerValidDate } from './pickers';
 export type FieldSectionType = 'year' | 'month' | 'day' | 'weekDay' | 'hours' | 'minutes' | 'seconds' | 'meridiem' | 'empty';
 export type FieldSectionContentType = 'digit' | 'digit-with-letter' | 'letter';
 export type FieldValueType = 'date' | 'time' | 'date-time';
@@ -52,24 +59,6 @@ export interface FieldSection {
      * To avoid losing that information, we transfer the values of the modified sections from the newly generated date to the original date.
      */
     modified: boolean;
-    /**
-     * Start index of the section in the format
-     */
-    start: number;
-    /**
-     * End index of the section in the format
-     */
-    end: number;
-    /**
-     * Start index of the section value in the input.
-     * Takes into account invisible unicode characters such as \u2069 but does not include them
-     */
-    startInInput: number;
-    /**
-     * End index of the section value in the input.
-     * Takes into account invisible unicode characters such as \u2069 but does not include them
-     */
-    endInInput: number;
     /**
      * Separator displayed before the value of the section in the input.
      * If it contains escaped characters, then it must not have the escaping characters.
@@ -100,20 +89,24 @@ export interface FieldRef<TSection extends FieldSection> {
      * @param {FieldSelectedSections} selectedSections The sections to select.
      */
     setSelectedSections: (selectedSections: FieldSelectedSections) => void;
+    /**
+     * Focuses the field.
+     * @param {FieldSelectedSections | FieldSectionType} newSelectedSection The section to select once focused.
+     */
+    focusField: (newSelectedSection?: number | FieldSectionType) => void;
+    /**
+     * Returns `true` if the focused is on the field input.
+     * @returns {boolean} `true` if the field is focused.
+     */
+    isFieldFocused: () => boolean;
 }
-export type FieldSelectedSections = number | FieldSectionType | null | 'all' | {
-    startIndex: number;
-    endIndex: number;
-};
-/**
- * Props the single input field can receive when used inside a picker.
- * Only contains what the MUI component are passing to the field, not what users can pass using the `props.slotProps.field`.
- */
-export interface BaseSingleInputFieldProps<TValue, TDate, TSection extends FieldSection, TError> extends BaseFieldProps<TValue, TDate, TSection, TError> {
+export type FieldSelectedSections = number | FieldSectionType | null | 'all';
+interface BaseForwardedCommonSingleInputFieldProps extends ExportedUseClearableFieldProps {
+    ref?: React.Ref<HTMLDivElement>;
+    sx?: SxProps<any>;
     label?: React.ReactNode;
     id?: string;
     name?: string;
-    inputRef?: React.Ref<HTMLInputElement>;
     onKeyDown?: React.KeyboardEventHandler;
     onBlur?: React.FocusEventHandler;
     focused?: boolean;
@@ -125,8 +118,31 @@ export interface BaseSingleInputFieldProps<TValue, TDate, TSection extends Field
     inputProps?: {
         'aria-label'?: string;
     };
-    slots?: {};
-    slotProps?: {};
-    clearable?: boolean;
-    onClear?: React.MouseEventHandler;
+    slots?: UseClearableFieldSlots;
+    slotProps?: UseClearableFieldSlotProps & {
+        textField?: {};
+    };
 }
+interface BaseForwardedV6SingleInputFieldProps {
+    inputRef?: React.Ref<HTMLInputElement>;
+}
+interface BaseForwardedV7SingleInputFieldProps {
+    sectionListRef?: React.Ref<PickersSectionListRef>;
+}
+type BaseForwardedSingleInputFieldProps<TEnableAccessibleFieldDOMStructure extends boolean> = BaseForwardedCommonSingleInputFieldProps & (TEnableAccessibleFieldDOMStructure extends false ? BaseForwardedV6SingleInputFieldProps : BaseForwardedV7SingleInputFieldProps);
+/**
+ * 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, TDate extends PickerValidDate, TSection extends FieldSection, TEnableAccessibleFieldDOMStructure extends boolean, TError> = BaseFieldProps<TValue, TDate, TSection, TEnableAccessibleFieldDOMStructure, TError> & BaseForwardedSingleInputFieldProps<TEnableAccessibleFieldDOMStructure>;
+/**
+ * Props the text field receives when used with a single input picker.
+ * Only contains what the MUI components are passing to the text field, not what users can pass using the `props.slotProps.field` and `props.slotProps.textField`.
+ */
+export type BaseSingleInputPickersTextFieldProps<TEnableAccessibleFieldDOMStructure extends boolean> = UseClearableFieldResponse<UseFieldResponse<TEnableAccessibleFieldDOMStructure, BaseForwardedSingleInputFieldProps<TEnableAccessibleFieldDOMStructure>>>;
+/**
+ * Props the built-in text field component can receive.
+ */
+export type BuiltInFieldTextFieldProps<TEnableAccessibleFieldDOMStructure extends boolean> = TEnableAccessibleFieldDOMStructure extends false ? Omit<TextFieldProps, 'autoComplete' | 'error' | 'maxRows' | 'minRows' | 'multiline' | 'placeholder' | 'rows' | 'select' | 'SelectProps' | 'type'> : Partial<Omit<PickersTextFieldProps, keyof ExportedPickersSectionListProps>>;
+export {};

package/models/pickers.d.ts

@@ -7,3 +7,6 @@ export interface PickerChangeHandlerContext<TError> {
      */
     shortcut?: PickersShortcutsItemContext;
 }
+export interface PickerValidDateLookup {
+}
+export type PickerValidDate = PickerValidDateLookup[keyof PickerValidDateLookup];

package/modern/AdapterDateFnsBase/AdapterDateFnsBase.js

@@ -171,6 +171,7 @@ const defaultFormats = {
   month: 'LLLL',
   monthShort: 'MMM',
   dayOfMonth: 'd',
+  dayOfMonthFull: 'do',
   weekday: 'EEEE',
   weekdayShort: 'EEEEEE',
   hours24h: 'HH',
@@ -278,6 +279,9 @@ export class AdapterDateFnsBase {
     this.formatNumber = numberToFormat => {
       return numberToFormat;
     };
+    this.getDayOfWeek = value => {
+      return value.getDay() + 1;
+    };
     const {
       locale,
       formats,

package/modern/AdapterDateFnsJalali/AdapterDateFnsJalali.js

@@ -215,6 +215,7 @@ const defaultFormats = {
   month: 'LLLL',
   monthShort: 'MMM',
   dayOfMonth: 'd',
+  dayOfMonthFull: 'do',
   weekday: 'EEEE',
   weekdayShort: 'EEEEEE',
   hours24h: 'HH',
@@ -246,7 +247,6 @@ const NUMBER_SYMBOL_MAP = {
   '9': '۹',
   '0': '۰'
 };
-
 /**
  * Based on `@date-io/date-fns-jalali`
  *
@@ -530,4 +530,7 @@ export class AdapterDateFnsJalali {
     this.locale = _locale;
     this.formats = _extends({}, defaultFormats, formats);
   }
+  getDayOfWeek(value) {
+    return value.getDay() + 1;
+  }
 }

package/modern/AdapterDayjs/AdapterDayjs.js

@@ -5,10 +5,12 @@ import weekOfYearPlugin from 'dayjs/plugin/weekOfYear';
 import customParseFormatPlugin from 'dayjs/plugin/customParseFormat';
 import localizedFormatPlugin from 'dayjs/plugin/localizedFormat';
 import isBetweenPlugin from 'dayjs/plugin/isBetween';
+import advancedFormatPlugin from 'dayjs/plugin/advancedFormat';
 import { buildWarning } from '../internals/utils/warning';
 defaultDayjs.extend(localizedFormatPlugin);
 defaultDayjs.extend(weekOfYearPlugin);
 defaultDayjs.extend(isBetweenPlugin);
+defaultDayjs.extend(advancedFormatPlugin);
 const localeNotFoundWarning = buildWarning(['Your locale has not been found.', 'Either the locale key is not a supported one. Locales supported by dayjs are available here: https://github.com/iamkun/dayjs/tree/dev/src/locale', "Or you forget to import the locale from 'dayjs/locale/{localeUsed}'", 'fallback on English locale']);
 const formatTokenMap = {
   // Year
@@ -98,6 +100,7 @@ const defaultFormats = {
   month: 'MMMM',
   monthShort: 'MMM',
   dayOfMonth: 'D',
+  dayOfMonthFull: 'Do',
   weekday: 'dddd',
   weekdayShort: 'dd',
   hours24h: 'HH',
@@ -120,7 +123,6 @@ const defaultFormats = {
 const MISSING_UTC_PLUGIN = ['Missing UTC plugin', 'To be able to use UTC or timezones, you have to enable the `utc` plugin', 'Find more information on https://mui.com/x/react-date-pickers/timezone/#day-js-and-utc'].join('\n');
 const MISSING_TIMEZONE_PLUGIN = ['Missing timezone plugin', 'To be able to use timezones, you have to enable both the `utc` and the `timezone` plugin', 'Find more information on https://mui.com/x/react-date-pickers/timezone/#day-js-and-timezone'].join('\n');
 const withLocale = (dayjs, locale) => !locale ? dayjs : (...args) => dayjs(...args).locale(locale);
-
 /**
  * Based on `@date-io/dayjs`
  *
@@ -540,4 +542,7 @@ export class AdapterDayjs {
     // for reference: https://github.com/mui/mui-x/pull/11151
     defaultDayjs.extend(customParseFormatPlugin);
   }
+  getDayOfWeek(value) {
+    return value.day() + 1;
+  }
 }

package/modern/AdapterLuxon/AdapterLuxon.js

@@ -112,6 +112,9 @@ const defaultFormats = {
   month: 'LLLL',
   monthShort: 'MMM',
   dayOfMonth: 'd',
+  // Full day of the month format (i.e. 3rd) is not supported
+  // Falling back to regular format
+  dayOfMonthFull: 'd',
   weekday: 'cccc',
   weekdayShort: 'ccccc',
   hours24h: 'HH',
@@ -131,7 +134,6 @@ const defaultFormats = {
   keyboardDateTime12h: 'D hh:mm a',
   keyboardDateTime24h: 'D T'
 };
-
 /**
  * Based on `@date-io/luxon`
  *
@@ -328,7 +330,7 @@ export class AdapterLuxon {
       return diff.days < 0;
     };
     this.isWithinRange = (value, [start, end]) => {
-      return value.equals(start) || value.equals(end) || this.isAfter(value, start) && this.isBefore(value, end);
+      return this.isEqual(value, start) || this.isEqual(value, end) || this.isAfter(value, start) && this.isBefore(value, end);
     };
     this.startOfYear = value => {
       return value.startOf('year');
@@ -475,6 +477,9 @@ export class AdapterLuxon {
     this.getWeekNumber = value => {
       return value.localWeekNumber ?? value.weekNumber;
     };
+    this.getDayOfWeek = value => {
+      return value.weekday;
+    };
     this.getYearRange = ([start, end]) => {
       const startDate = this.startOfYear(start);
       const endDate = this.endOfYear(end);

package/modern/AdapterMoment/AdapterMoment.js

@@ -101,6 +101,7 @@ const defaultFormats = {
   month: 'MMMM',
   monthShort: 'MMM',
   dayOfMonth: 'D',
+  dayOfMonthFull: 'Do',
   weekday: 'dddd',
   weekdayShort: 'ddd',
   hours24h: 'HH',
@@ -121,7 +122,6 @@ const defaultFormats = {
   keyboardDateTime24h: 'L HH:mm'
 };
 const MISSING_TIMEZONE_PLUGIN = ['Missing timezone plugin', 'To be able to use timezones, you have to pass the default export from `moment-timezone` to the `dateLibInstance` prop of `LocalizationProvider`', 'Find more information on https://mui.com/x/react-date-pickers/timezone/#moment-and-timezone'].join('\n');
-
 /**
  * Based on `@date-io/moment`
  *
@@ -443,6 +443,9 @@ export class AdapterMoment {
     this.getWeekNumber = value => {
       return value.week();
     };
+    this.getDayOfWeek = value => {
+      return value.day() + 1;
+    };
     this.moment = instance || defaultMoment;
     this.locale = locale;
     this.formats = _extends({}, defaultFormats, formats);

package/modern/AdapterMomentHijri/AdapterMomentHijri.js

@@ -71,6 +71,9 @@ const defaultFormats = {
   month: 'iMMMM',
   monthShort: 'iMMM',
   dayOfMonth: 'iD',
+  // Full day of the month format (i.e. 3rd) is not supported
+  // Falling back to regular format
+  dayOfMonthFull: 'iD',
   weekday: 'dddd',
   weekdayShort: 'ddd',
   hours24h: 'HH',
@@ -102,7 +105,6 @@ const NUMBER_SYMBOL_MAP = {
   '9': '٩',
   '0': '٠'
 };
-
 /**
  * Based on `@date-io/hijri`
  *

package/modern/AdapterMomentJalaali/AdapterMomentJalaali.js

@@ -69,6 +69,9 @@ const defaultFormats = {
   month: 'jMMMM',
   monthShort: 'jMMM',
   dayOfMonth: 'jD',
+  // Full day of the month format (i.e. 3rd) is not supported
+  // Falling back to regular format
+  dayOfMonthFull: 'jD',
   weekday: 'dddd',
   weekdayShort: 'ddd',
   hours24h: 'HH',
@@ -100,7 +103,6 @@ const NUMBER_SYMBOL_MAP = {
   '9': '۹',
   '0': '۰'
 };
-
 /**
  * Based on `@date-io/jalaali`
  *

package/modern/DateCalendar/DateCalendar.js

@@ -354,6 +354,9 @@ process.env.NODE_ENV !== "production" ? DateCalendar.propTypes = {
    * - the `input` element if there is a field rendered.
    */
   autoFocus: PropTypes.bool,
+  /**
+   * Override or extend the styles applied to the component.
+   */
   classes: PropTypes.object,
   className: PropTypes.string,
   /**
@@ -367,7 +370,7 @@ process.env.NODE_ENV !== "production" ? DateCalendar.propTypes = {
    * The default selected value.
    * Used when the component is not controlled.
    */
-  defaultValue: PropTypes.any,
+  defaultValue: PropTypes.object,
   /**
    * If `true`, the picker and text field are disabled.
    * @default false
@@ -395,7 +398,6 @@ process.env.NODE_ENV !== "production" ? DateCalendar.propTypes = {
   /**
    * The day view will show as many weeks as needed after the end of the current month to match this value.
    * Put it to 6 to have a fixed number of weeks in Gregorian calendars
-   * @default undefined
    */
   fixedWeekNumber: PropTypes.number,
   /**
@@ -411,11 +413,11 @@ process.env.NODE_ENV !== "production" ? DateCalendar.propTypes = {
   /**
    * Maximal selectable date.
    */
-  maxDate: PropTypes.any,
+  maxDate: PropTypes.object,
   /**
    * Minimal selectable date.
    */
-  minDate: PropTypes.any,
+  minDate: PropTypes.object,
   /**
    * Months rendered per row.
    * @default 3
@@ -475,7 +477,7 @@ process.env.NODE_ENV !== "production" ? DateCalendar.propTypes = {
    * The date used to generate the new value when both `value` and `defaultValue` are empty.
    * @default The closest valid date using the validation props, except callbacks such as `shouldDisableDate`.
    */
-  referenceDate: PropTypes.any,
+  referenceDate: PropTypes.object,
   /**
    * Component displaying when passed `loading` true.
    * @returns {React.ReactNode} The node to render when loading.
@@ -543,7 +545,7 @@ process.env.NODE_ENV !== "production" ? DateCalendar.propTypes = {
    * The selected value.
    * Used when the component is controlled.
    */
-  value: PropTypes.any,
+  value: PropTypes.object,
   /**
    * The visible view.
    * Used when the component view is controlled.

package/modern/DateCalendar/DayCalendar.js

@@ -355,7 +355,7 @@ export function DayCalendar(inProps) {
   const currentMonthNumber = utils.getMonth(currentMonth);
   const validSelectedDays = React.useMemo(() => selectedDays.filter(day => !!day).map(day => utils.startOfDay(day)), [utils, selectedDays]);
 
-  // need a new ref whenever the `key` of the transition changes: http://reactcommunity.org/react-transition-group/transition/#Transition-prop-nodeRef.
+  // need a new ref whenever the `key` of the transition changes: https://reactcommunity.org/react-transition-group/transition/#Transition-prop-nodeRef.
   const transitionKey = currentMonthNumber;
   // eslint-disable-next-line react-hooks/exhaustive-deps
   const slideNodeRef = React.useMemo(() => /*#__PURE__*/React.createRef(), [transitionKey]);

package/modern/DateField/DateField.js

@@ -9,6 +9,7 @@ import { useSlotProps } from '@mui/base/utils';
 import { refType } from '@mui/utils';
 import { useDateField } from './useDateField';
 import { useClearableField } from '../hooks';
+import { PickersTextField } from '../PickersTextField';
 import { convertFieldResponseIntoMuiTextFieldProps } from '../internals/utils/convertFieldResponseIntoMuiTextFieldProps';
 import { jsx as _jsx } from "react/jsx-runtime";
 /**
@@ -34,7 +35,7 @@ const DateField = /*#__PURE__*/React.forwardRef(function DateField(inProps, inRe
     } = themeProps,
     other = _objectWithoutPropertiesLoose(themeProps, _excluded);
   const ownerState = themeProps;
-  const TextField = slots?.textField ?? MuiTextField;
+  const TextField = slots?.textField ?? (inProps.enableAccessibleFieldDOMStructure ? PickersTextField : MuiTextField);
   const textFieldProps = useSlotProps({
     elementType: TextField,
     externalSlotProps: slotProps?.textField,
@@ -83,7 +84,7 @@ process.env.NODE_ENV !== "production" ? DateField.propTypes = {
   /**
    * The default value. Use when the component is not controlled.
    */
-  defaultValue: PropTypes.any,
+  defaultValue: PropTypes.object,
   /**
    * If `true`, the component is disabled.
    * @default false
@@ -99,6 +100,10 @@ process.env.NODE_ENV !== "production" ? DateField.propTypes = {
    * @default false
    */
   disablePast: PropTypes.bool,
+  /**
+   * @default false
+   */
+  enableAccessibleFieldDOMStructure: PropTypes.bool,
   /**
    * If `true`, the component is displayed in focused state.
    */
@@ -170,11 +175,11 @@ process.env.NODE_ENV !== "production" ? DateField.propTypes = {
   /**
    * Maximal selectable date.
    */
-  maxDate: PropTypes.any,
+  maxDate: PropTypes.object,
   /**
    * Minimal selectable date.
    */
-  minDate: PropTypes.any,
+  minDate: PropTypes.object,
   /**
    * Name attribute of the `input` element.
    */
@@ -217,7 +222,7 @@ process.env.NODE_ENV !== "production" ? DateField.propTypes = {
    * For example, on time fields it will be used to determine the date to set.
    * @default The closest valid date using the validation props, except callbacks such as `shouldDisableDate`. Value is rounded to the most granular section used.
    */
-  referenceDate: PropTypes.any,
+  referenceDate: PropTypes.object,
   /**
    * If `true`, the label is displayed as required and the `input` element is required.
    * @default false
@@ -225,17 +230,14 @@ process.env.NODE_ENV !== "production" ? DateField.propTypes = {
   required: PropTypes.bool,
   /**
    * The currently selected sections.
-   * This prop accept four formats:
+   * This prop accepts four formats:
    * 1. If a number is provided, the section at this index will be selected.
-   * 2. If an object with a `startIndex` and `endIndex` properties are provided, the sections between those two indexes will be selected.
-   * 3. If a string of type `FieldSectionType` is provided, the first section with that name will be selected.
-   * 4. If `null` is provided, no section will be selected
+   * 2. If a string of type `FieldSectionType` is provided, the first section with that name will be selected.
+   * 3. If `"all"` is provided, all the sections will be selected.
+   * 4. If `null` is provided, no section will be selected.
    * If not provided, the selected sections will be handled internally.
    */
-  selectedSections: PropTypes.oneOfType([PropTypes.oneOf(['all', 'day', 'empty', 'hours', 'meridiem', 'minutes', 'month', 'seconds', 'weekDay', 'year']), PropTypes.number, PropTypes.shape({
-    endIndex: PropTypes.number.isRequired,
-    startIndex: PropTypes.number.isRequired
-  })]),
+  selectedSections: PropTypes.oneOfType([PropTypes.oneOf(['all', 'day', 'empty', 'hours', 'meridiem', 'minutes', 'month', 'seconds', 'weekDay', 'year']), PropTypes.number]),
   /**
    * Disable specific date.
    *
@@ -310,7 +312,7 @@ process.env.NODE_ENV !== "production" ? DateField.propTypes = {
    * The selected value.
    * Used when the component is controlled.
    */
-  value: PropTypes.any,
+  value: PropTypes.object,
   /**
    * The variant to use.
    * @default 'outlined'

package/modern/DateField/useDateField.js

@@ -1,21 +1,8 @@
-import _extends from "@babel/runtime/helpers/esm/extends";
 import { singleItemFieldValueManager, singleItemValueManager } from '../internals/utils/valueManagers';
 import { useField } from '../internals/hooks/useField';
 import { validateDate } from '../internals/utils/validation/validateDate';
-import { applyDefaultDate } from '../internals/utils/date-utils';
-import { useUtils, useDefaultDates } from '../internals/hooks/useUtils';
 import { splitFieldInternalAndForwardedProps } from '../internals/utils/fields';
-const useDefaultizedDateField = props => {
-  const utils = useUtils();
-  const defaultDates = useDefaultDates();
-  return _extends({}, props, {
-    disablePast: props.disablePast ?? false,
-    disableFuture: props.disableFuture ?? false,
-    format: props.format ?? utils.formats.keyboardDate,
-    minDate: applyDefaultDate(utils, props.minDate, defaultDates.minDate),
-    maxDate: applyDefaultDate(utils, props.maxDate, defaultDates.maxDate)
-  });
-};
+import { useDefaultizedDateField } from '../internals/hooks/defaultizedFieldProps';
 export const useDateField = inProps => {
   const props = useDefaultizedDateField(inProps);
   const {

package/modern/DatePicker/DatePicker.js

@@ -72,7 +72,7 @@ process.env.NODE_ENV !== "production" ? DatePicker.propTypes = {
    * The default value.
    * Used when the component is not controlled.
    */
-  defaultValue: PropTypes.any,
+  defaultValue: PropTypes.object,
   /**
    * CSS media query when `Mobile` mode will be changed to `Desktop`.
    * @default '@media (pointer: fine)'
@@ -108,10 +108,13 @@ process.env.NODE_ENV !== "production" ? DatePicker.propTypes = {
    * If `true`, the week number will be display in the calendar.
    */
   displayWeekNumber: PropTypes.bool,
+  /**
+   * @default false
+   */
+  enableAccessibleFieldDOMStructure: PropTypes.any,
   /**
    * The day view will show as many weeks as needed after the end of the current month to match this value.
    * Put it to 6 to have a fixed number of weeks in Gregorian calendars
-   * @default undefined
    */
   fixedWeekNumber: PropTypes.number,
   /**
@@ -147,11 +150,11 @@ process.env.NODE_ENV !== "production" ? DatePicker.propTypes = {
   /**
    * Maximal selectable date.
    */
-  maxDate: PropTypes.any,
+  maxDate: PropTypes.object,
   /**
    * Minimal selectable date.
    */
-  minDate: PropTypes.any,
+  minDate: PropTypes.object,
   /**
    * Months rendered per row.
    * @default 3
@@ -243,7 +246,7 @@ process.env.NODE_ENV !== "production" ? DatePicker.propTypes = {
    * 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: PropTypes.any,
+  referenceDate: PropTypes.object,
   /**
    * Component displaying when passed `loading` true.
    * @returns {React.ReactNode} The node to render when loading.
@@ -252,17 +255,14 @@ process.env.NODE_ENV !== "production" ? DatePicker.propTypes = {
   renderLoading: PropTypes.func,
   /**
    * The currently selected sections.
-   * This prop accept four formats:
+   * This prop accepts four formats:
    * 1. If a number is provided, the section at this index will be selected.
-   * 2. If an object with a `startIndex` and `endIndex` properties are provided, the sections between those two indexes will be selected.
-   * 3. If a string of type `FieldSectionType` is provided, the first section with that name will be selected.
-   * 4. If `null` is provided, no section will be selected
+   * 2. If a string of type `FieldSectionType` is provided, the first section with that name will be selected.
+   * 3. If `"all"` is provided, all the sections will be selected.
+   * 4. If `null` is provided, no section will be selected.
    * If not provided, the selected sections will be handled internally.
    */
-  selectedSections: PropTypes.oneOfType([PropTypes.oneOf(['all', 'day', 'empty', 'hours', 'meridiem', 'minutes', 'month', 'seconds', 'weekDay', 'year']), PropTypes.number, PropTypes.shape({
-    endIndex: PropTypes.number.isRequired,
-    startIndex: PropTypes.number.isRequired
-  })]),
+  selectedSections: PropTypes.oneOfType([PropTypes.oneOf(['all', 'day', 'empty', 'hours', 'meridiem', 'minutes', 'month', 'seconds', 'weekDay', 'year']), PropTypes.number]),
   /**
    * Disable specific date.
    *
@@ -324,7 +324,7 @@ process.env.NODE_ENV !== "production" ? DatePicker.propTypes = {
    * The selected value.
    * Used when the component is controlled.
    */
-  value: PropTypes.any,
+  value: PropTypes.object,
   /**
    * The visible view.
    * Used when the component view is controlled.

package/modern/DatePicker/DatePickerToolbar.js

@@ -1,7 +1,8 @@
 import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
 import _extends from "@babel/runtime/helpers/esm/extends";
-const _excluded = ["value", "isLandscape", "onChange", "toolbarFormat", "toolbarPlaceholder", "views"];
+const _excluded = ["value", "isLandscape", "onChange", "toolbarFormat", "toolbarPlaceholder", "views", "className"];
 import * as React from 'react';
+import clsx from 'clsx';
 import PropTypes from 'prop-types';
 import Typography from '@mui/material/Typography';
 import { styled, useThemeProps } from '@mui/material/styles';
@@ -55,7 +56,8 @@ export const DatePickerToolbar = /*#__PURE__*/React.forwardRef(function DatePick
       isLandscape,
       toolbarFormat,
       toolbarPlaceholder = '––',
-      views
+      views,
+      className
     } = props,
     other = _objectWithoutPropertiesLoose(props, _excluded);
   const utils = useUtils();
@@ -76,7 +78,7 @@ export const DatePickerToolbar = /*#__PURE__*/React.forwardRef(function DatePick
     ref: ref,
     toolbarTitle: localeText.datePickerToolbarTitle,
     isLandscape: isLandscape,
-    className: classes.root
+    className: clsx(classes.root, className)
   }, other, {
     children: /*#__PURE__*/_jsx(DatePickerToolbarTitle, {
       variant: "h4",
@@ -92,6 +94,9 @@ process.env.NODE_ENV !== "production" ? DatePickerToolbar.propTypes = {
   // | These PropTypes are generated from the TypeScript type definitions |
   // | To update them edit the TypeScript types and run "yarn proptypes"  |
   // ----------------------------------------------------------------------
+  /**
+   * Override or extend the styles applied to the component.
+   */
   classes: PropTypes.object,
   className: PropTypes.string,
   disabled: PropTypes.bool,
@@ -109,6 +114,9 @@ process.env.NODE_ENV !== "production" ? DatePickerToolbar.propTypes = {
    */
   onViewChange: PropTypes.func.isRequired,
   readOnly: PropTypes.bool,
+  /**
+   * The system prop that allows defining system overrides as well as additional CSS styles.
+   */
   sx: PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.func, PropTypes.object, PropTypes.bool])), PropTypes.func, PropTypes.object]),
   titleId: PropTypes.string,
   /**
@@ -120,7 +128,7 @@ process.env.NODE_ENV !== "production" ? DatePickerToolbar.propTypes = {
    * @default "––"
    */
   toolbarPlaceholder: PropTypes.node,
-  value: PropTypes.any,
+  value: PropTypes.object,
   /**
    * Currently visible picker view.
    */