@mui/x-date-pickers 7.7.0 → 7.7.1

package/internals/hooks/usePicker/usePickerValue.js

@@ -119,7 +119,7 @@ export const usePickerValue = ({
   const {
     onAccept,
     onChange,
-    value: inValue,
+    value: inValueWithoutRenderTimezone,
     defaultValue: inDefaultValue,
     closeOnSelect = wrapperVariant === 'desktop',
     timezone: timezoneProp
@@ -129,15 +129,15 @@ export const usePickerValue = ({
   } = React.useRef(inDefaultValue);
   const {
     current: isControlled
-  } = React.useRef(inValue !== undefined);
+  } = React.useRef(inValueWithoutRenderTimezone !== undefined);
 
   /* eslint-disable react-hooks/rules-of-hooks, react-hooks/exhaustive-deps */
   if (process.env.NODE_ENV !== 'production') {
     React.useEffect(() => {
-      if (isControlled !== (inValue !== undefined)) {
+      if (isControlled !== (inValueWithoutRenderTimezone !== undefined)) {
         console.error([`MUI X: A component is changing the ${isControlled ? '' : 'un'}controlled value of a picker to be ${isControlled ? 'un' : ''}controlled.`, 'Elements should not switch from uncontrolled to controlled (or vice versa).', `Decide between using a controlled or uncontrolled value` + 'for the lifetime of the component.', "The nature of the state is determined during the first render. It's considered controlled if the value is not `undefined`.", 'More info: https://fb.me/react-controlled-components'].join('\n'));
       }
-    }, [inValue]);
+    }, [inValueWithoutRenderTimezone]);
     React.useEffect(() => {
       if (!isControlled && defaultValue !== inDefaultValue) {
         console.error([`MUI X: A component is changing the defaultValue of an uncontrolled picker after being initialized. ` + `To suppress this warning opt to use a controlled value.`].join('\n'));
@@ -152,10 +152,21 @@ export const usePickerValue = ({
     isOpen,
     setIsOpen
   } = useOpenState(props);
+  const {
+    timezone,
+    value: inValueWithTimezoneToRender,
+    handleValueChange
+  } = useValueWithTimezone({
+    timezone: timezoneProp,
+    value: inValueWithoutRenderTimezone,
+    defaultValue,
+    onChange,
+    valueManager
+  });
   const [dateState, setDateState] = React.useState(() => {
     let initialValue;
-    if (inValue !== undefined) {
-      initialValue = inValue;
+    if (inValueWithTimezoneToRender !== undefined) {
+      initialValue = inValueWithTimezoneToRender;
     } else if (defaultValue !== undefined) {
       initialValue = defaultValue;
     } else {
@@ -165,20 +176,10 @@ export const usePickerValue = ({
       draft: initialValue,
       lastPublishedValue: initialValue,
       lastCommittedValue: initialValue,
-      lastControlledValue: inValue,
+      lastControlledValue: inValueWithTimezoneToRender,
       hasBeenModifiedSinceMount: false
     };
   });
-  const {
-    timezone,
-    handleValueChange
-  } = useValueWithTimezone({
-    timezone: timezoneProp,
-    value: inValue,
-    defaultValue,
-    onChange,
-    valueManager
-  });
   useValidation(_extends({}, props, {
     value: dateState.draft,
     timezone
@@ -200,38 +201,44 @@ export const usePickerValue = ({
       lastCommittedValue: shouldCommit ? action.value : prev.lastCommittedValue,
       hasBeenModifiedSinceMount: true
     }));
-    if (shouldPublish) {
-      const validationError = action.name === 'setValueFromField' ? action.context.validationError : validator({
-        adapter,
-        value: action.value,
-        props: _extends({}, props, {
+    let cachedContext = null;
+    const getContext = () => {
+      if (!cachedContext) {
+        const validationError = action.name === 'setValueFromField' ? action.context.validationError : validator({
+          adapter,
           value: action.value,
-          timezone
-        })
-      });
-      const context = {
-        validationError
-      };
-      if (action.name === 'setValueFromShortcut') {
-        context.shortcut = action.shortcut;
+          props: _extends({}, props, {
+            value: action.value,
+            timezone
+          })
+        });
+        cachedContext = {
+          validationError
+        };
+        if (action.name === 'setValueFromShortcut') {
+          cachedContext.shortcut = action.shortcut;
+        }
       }
-      handleValueChange(action.value, context);
+      return cachedContext;
+    };
+    if (shouldPublish) {
+      handleValueChange(action.value, getContext());
     }
     if (shouldCommit && onAccept) {
-      onAccept(action.value);
+      onAccept(action.value, getContext());
     }
     if (shouldClose) {
       setIsOpen(false);
     }
   });
-  if (inValue !== undefined && (dateState.lastControlledValue === undefined || !valueManager.areValuesEqual(utils, dateState.lastControlledValue, inValue))) {
-    const isUpdateComingFromPicker = valueManager.areValuesEqual(utils, dateState.draft, inValue);
+  if (inValueWithTimezoneToRender !== undefined && (dateState.lastControlledValue === undefined || !valueManager.areValuesEqual(utils, dateState.lastControlledValue, inValueWithTimezoneToRender))) {
+    const isUpdateComingFromPicker = valueManager.areValuesEqual(utils, dateState.draft, inValueWithTimezoneToRender);
     setDateState(prev => _extends({}, prev, {
-      lastControlledValue: inValue
+      lastControlledValue: inValueWithTimezoneToRender
     }, isUpdateComingFromPicker ? {} : {
-      lastCommittedValue: inValue,
-      lastPublishedValue: inValue,
-      draft: inValue,
+      lastCommittedValue: inValueWithTimezoneToRender,
+      lastPublishedValue: inValueWithTimezoneToRender,
+      draft: inValueWithTimezoneToRender,
       hasBeenModifiedSinceMount: true
     }));
   }

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

@@ -193,9 +193,11 @@ export interface UsePickerValueBaseProps<TValue, TError> {
     /**
      * Callback fired when the value is accepted.
      * @template TValue The value type. Will be either the same type as `value` or `null`. Can be in `[start, end]` format in case of range value.
+     * @template TError The validation error type. Will be either `string` or a `null`. Can be in `[start, end]` format in case of range value.
      * @param {TValue} value The value that was just accepted.
+     * @param {FieldChangeHandlerContext<TError>} context The context containing the validation result of the current value.
      */
-    onAccept?: (value: TValue) => void;
+    onAccept?: (value: TValue, context: PickerChangeHandlerContext<TError>) => void;
     /**
      * Callback fired when the error associated to the current value changes.
      * If the error has a non-null value, then the `TextField` will be rendered in `error` state.

package/internals/hooks/usePicker/usePickerViews.js

@@ -39,6 +39,7 @@ export const usePickerViews = ({
     onClose
   } = propsFromPickerValue;
   const {
+    view: inView,
     views,
     openTo,
     onViewChange,
@@ -54,7 +55,7 @@ export const usePickerViews = ({
     setFocusedView,
     setValueAndGoToNextView
   } = useViews({
-    view: undefined,
+    view: inView,
     views,
     openTo,
     onChange,

package/locales/daDK.js

@@ -17,11 +17,10 @@ const daDKPickers = {
   // DateRange labels
   start: 'Start',
   end: 'Slut',
-  // startDate: 'Start date',
-  // startTime: 'Start time',
-  // endDate: 'End date',
-  // endTime: 'End time',
-
+  startDate: 'Start dato',
+  startTime: 'Start tid',
+  endDate: 'Slut date',
+  endTime: 'Slut tid',
   // Action bar
   cancelButtonLabel: 'Annuller',
   clearButtonLabel: 'Ryd',
@@ -47,8 +46,7 @@ const daDKPickers = {
   // Open picker labels
   openDatePickerDialogue: (value, utils) => value !== null && utils.isValid(value) ? `Vælg dato, valgte dato er ${utils.format(value, 'fullDate')}` : 'Vælg dato',
   openTimePickerDialogue: (value, utils) => value !== null && utils.isValid(value) ? `Vælg tidspunkt, valgte tidspunkt er ${utils.format(value, 'fullTime')}` : 'Vælg tidspunkt',
-  // fieldClearLabel: 'Clear value',
-
+  fieldClearLabel: 'ryd felt',
   // Table labels
   timeTableLabel: 'vælg tidspunkt',
   dateTableLabel: 'vælg dato',
@@ -60,19 +58,17 @@ const daDKPickers = {
   fieldHoursPlaceholder: () => 'hh',
   fieldMinutesPlaceholder: () => 'mm',
   fieldSecondsPlaceholder: () => 'ss',
-  fieldMeridiemPlaceholder: () => 'aa'
-
+  fieldMeridiemPlaceholder: () => 'aa',
   // View names
-  // year: 'Year',
-  // month: 'Month',
-  // day: 'Day',
-  // weekDay: 'Week day',
-  // hours: 'Hours',
-  // minutes: 'Minutes',
-  // seconds: 'Seconds',
-  // meridiem: 'Meridiem',
-
+  year: 'år',
+  month: 'måned',
+  day: 'dag',
+  weekDay: 'ugedag',
+  hours: 'timer',
+  minutes: 'minutter',
+  seconds: 'sekunder',
+  meridiem: 'middag',
   // Common
-  // empty: 'Empty',
+  empty: 'tom'
 };
 export const daDK = getPickersLocalization(daDKPickers);

package/modern/AdapterDateFnsJalaliV3/AdapterDateFnsJalaliV3.js

@@ -130,6 +130,7 @@ export class AdapterDateFnsJalali extends AdapterDateFnsBase {
       longFormatters,
       lib: 'date-fns-jalali'
     });
+    // TODO: explicit return types can be removed once there is only one date-fns version supported
     this.parse = (value, format) => {
       if (value === '') {
         return null;

package/modern/AdapterDateFnsV3/AdapterDateFnsV3.js

@@ -90,6 +90,7 @@ export class AdapterDateFns extends AdapterDateFnsBase {
       formats,
       longFormatters
     });
+    // TODO: explicit return types can be removed once there is only one date-fns version supported
     this.parse = (value, format) => {
       if (value === '') {
         return null;

package/modern/DatePicker/DatePicker.js

@@ -167,7 +167,9 @@ process.env.NODE_ENV !== "production" ? DatePicker.propTypes = {
   /**
    * Callback fired when the value is accepted.
    * @template TValue The value type. Will be either the same type as `value` or `null`. Can be in `[start, end]` format in case of range value.
+   * @template TError The validation error type. Will be either `string` or a `null`. Can be in `[start, end]` format in case of range value.
    * @param {TValue} value The value that was just accepted.
+   * @param {FieldChangeHandlerContext<TError>} context The context containing the validation result of the current value.
    */
   onAccept: PropTypes.func,
   /**

package/modern/DateTimePicker/DateTimePicker.js

@@ -205,7 +205,9 @@ process.env.NODE_ENV !== "production" ? DateTimePicker.propTypes = {
   /**
    * Callback fired when the value is accepted.
    * @template TValue The value type. Will be either the same type as `value` or `null`. Can be in `[start, end]` format in case of range value.
+   * @template TError The validation error type. Will be either `string` or a `null`. Can be in `[start, end]` format in case of range value.
    * @param {TValue} value The value that was just accepted.
+   * @param {FieldChangeHandlerContext<TError>} context The context containing the validation result of the current value.
    */
   onAccept: PropTypes.func,
   /**

package/modern/DesktopDatePicker/DesktopDatePicker.js

@@ -182,7 +182,9 @@ DesktopDatePicker.propTypes = {
   /**
    * Callback fired when the value is accepted.
    * @template TValue The value type. Will be either the same type as `value` or `null`. Can be in `[start, end]` format in case of range value.
+   * @template TError The validation error type. Will be either `string` or a `null`. Can be in `[start, end]` format in case of range value.
    * @param {TValue} value The value that was just accepted.
+   * @param {FieldChangeHandlerContext<TError>} context The context containing the validation result of the current value.
    */
   onAccept: PropTypes.func,
   /**

package/modern/DesktopDateTimePicker/DesktopDateTimePicker.js

@@ -305,7 +305,9 @@ DesktopDateTimePicker.propTypes = {
   /**
    * Callback fired when the value is accepted.
    * @template TValue The value type. Will be either the same type as `value` or `null`. Can be in `[start, end]` format in case of range value.
+   * @template TError The validation error type. Will be either `string` or a `null`. Can be in `[start, end]` format in case of range value.
    * @param {TValue} value The value that was just accepted.
+   * @param {FieldChangeHandlerContext<TError>} context The context containing the validation result of the current value.
    */
   onAccept: PropTypes.func,
   /**

package/modern/DesktopTimePicker/DesktopTimePicker.js

@@ -193,7 +193,9 @@ DesktopTimePicker.propTypes = {
   /**
    * Callback fired when the value is accepted.
    * @template TValue The value type. Will be either the same type as `value` or `null`. Can be in `[start, end]` format in case of range value.
+   * @template TError The validation error type. Will be either `string` or a `null`. Can be in `[start, end]` format in case of range value.
    * @param {TValue} value The value that was just accepted.
+   * @param {FieldChangeHandlerContext<TError>} context The context containing the validation result of the current value.
    */
   onAccept: PropTypes.func,
   /**

package/modern/MobileDatePicker/MobileDatePicker.js

@@ -179,7 +179,9 @@ MobileDatePicker.propTypes = {
   /**
    * Callback fired when the value is accepted.
    * @template TValue The value type. Will be either the same type as `value` or `null`. Can be in `[start, end]` format in case of range value.
+   * @template TError The validation error type. Will be either `string` or a `null`. Can be in `[start, end]` format in case of range value.
    * @param {TValue} value The value that was just accepted.
+   * @param {FieldChangeHandlerContext<TError>} context The context containing the validation result of the current value.
    */
   onAccept: PropTypes.func,
   /**

package/modern/MobileDateTimePicker/MobileDateTimePicker.js

@@ -227,7 +227,9 @@ MobileDateTimePicker.propTypes = {
   /**
    * Callback fired when the value is accepted.
    * @template TValue The value type. Will be either the same type as `value` or `null`. Can be in `[start, end]` format in case of range value.
+   * @template TError The validation error type. Will be either `string` or a `null`. Can be in `[start, end]` format in case of range value.
    * @param {TValue} value The value that was just accepted.
+   * @param {FieldChangeHandlerContext<TError>} context The context containing the validation result of the current value.
    */
   onAccept: PropTypes.func,
   /**

package/modern/MobileTimePicker/MobileTimePicker.js

@@ -172,7 +172,9 @@ MobileTimePicker.propTypes = {
   /**
    * Callback fired when the value is accepted.
    * @template TValue The value type. Will be either the same type as `value` or `null`. Can be in `[start, end]` format in case of range value.
+   * @template TError The validation error type. Will be either `string` or a `null`. Can be in `[start, end]` format in case of range value.
    * @param {TValue} value The value that was just accepted.
+   * @param {FieldChangeHandlerContext<TError>} context The context containing the validation result of the current value.
    */
   onAccept: PropTypes.func,
   /**

package/modern/MultiSectionDigitalClock/MultiSectionDigitalClock.js

@@ -4,6 +4,7 @@ const _excluded = ["ampm", "timeSteps", "autoFocus", "slots", "slotProps", "valu
 import * as React from 'react';
 import clsx from 'clsx';
 import PropTypes from 'prop-types';
+import { useRtl } from '@mui/system/RtlProvider';
 import { styled, useThemeProps } from '@mui/material/styles';
 import useEventCallback from '@mui/utils/useEventCallback';
 import composeClasses from '@mui/utils/composeClasses';
@@ -53,6 +54,7 @@ const MultiSectionDigitalClockRoot = styled(PickerViewRoot, {
  */
 export const MultiSectionDigitalClock = /*#__PURE__*/React.forwardRef(function MultiSectionDigitalClock(inProps, ref) {
   const utils = useUtils();
+  const isRtl = useRtl();
   const props = useThemeProps({
     props: inProps,
     name: 'MuiMultiSectionDigitalClock'
@@ -295,6 +297,17 @@ export const MultiSectionDigitalClock = /*#__PURE__*/React.forwardRef(function M
         throw new Error(`Unknown view: ${viewToBuild} found.`);
     }
   }, [now, value, ampm, utils, timeSteps.hours, timeSteps.minutes, timeSteps.seconds, localeText.hoursClockNumberText, localeText.minutesClockNumberText, localeText.secondsClockNumberText, meridiemMode, setValueAndGoToNextView, valueOrReferenceDate, isTimeDisabled, handleMeridiemChange]);
+  const viewsToRender = React.useMemo(() => {
+    if (!isRtl) {
+      return views;
+    }
+    const digitViews = views.filter(v => v !== 'meridiem');
+    const result = digitViews.toReversed();
+    if (views.includes('meridiem')) {
+      result.push('meridiem');
+    }
+    return result;
+  }, [isRtl, views]);
   const viewTimeOptions = React.useMemo(() => {
     return views.reduce((result, currentView) => {
       return _extends({}, result, {
@@ -310,9 +323,9 @@ export const MultiSectionDigitalClock = /*#__PURE__*/React.forwardRef(function M
     ownerState: ownerState,
     role: "group"
   }, other, {
-    children: Object.entries(viewTimeOptions).map(([timeView, viewOptions]) => /*#__PURE__*/_jsx(MultiSectionDigitalClockSection, {
-      items: viewOptions.items,
-      onChange: viewOptions.onChange,
+    children: viewsToRender.map(timeView => /*#__PURE__*/_jsx(MultiSectionDigitalClockSection, {
+      items: viewTimeOptions[timeView].items,
+      onChange: viewTimeOptions[timeView].onChange,
       active: view === timeView,
       autoFocus: autoFocus ?? focusedView === timeView,
       disabled: disabled,

package/modern/PickersCalendarHeader/PickersCalendarHeader.js

@@ -243,6 +243,10 @@ process.env.NODE_ENV !== "production" ? PickersCalendarHeader.propTypes = {
    * @default `${adapter.formats.month} ${adapter.formats.year}`
    */
   format: PropTypes.string,
+  /**
+   * Id of the calendar text element.
+   * It is used to establish an `aria-labelledby` relationship with the calendar `grid` element.
+   */
   labelId: PropTypes.string,
   maxDate: PropTypes.object.isRequired,
   minDate: PropTypes.object.isRequired,

package/modern/PickersLayout/usePickerLayout.js

@@ -53,7 +53,6 @@ const usePickerLayout = props => {
   const classes = useUtilityClasses(props);
 
   // Action bar
-
   const ActionBar = slots?.actionBar ?? PickersActionBar;
   const actionBarProps = useSlotProps({
     elementType: ActionBar,
@@ -73,7 +72,6 @@ const usePickerLayout = props => {
   const actionBar = /*#__PURE__*/_jsx(ActionBar, _extends({}, actionBarProps));
 
   // Toolbar
-
   const Toolbar = slots?.toolbar;
   const toolbarProps = useSlotProps({
     elementType: Toolbar,
@@ -96,11 +94,9 @@ const usePickerLayout = props => {
   const toolbar = toolbarHasView(toolbarProps) && !!Toolbar ? /*#__PURE__*/_jsx(Toolbar, _extends({}, toolbarProps)) : null;
 
   // Content
-
   const content = children;
 
   // Tabs
-
   const Tabs = slots?.tabs;
   const tabs = view && Tabs ? /*#__PURE__*/_jsx(Tabs, _extends({
     view: view,
@@ -109,7 +105,6 @@ const usePickerLayout = props => {
   }, slotProps?.tabs)) : null;
 
   // Shortcuts
-
   const Shortcuts = slots?.shortcuts ?? PickersShortcuts;
   const shortcutsProps = useSlotProps({
     elementType: Shortcuts,

package/modern/StaticDatePicker/StaticDatePicker.js

@@ -133,7 +133,9 @@ StaticDatePicker.propTypes = {
   /**
    * Callback fired when the value is accepted.
    * @template TValue The value type. Will be either the same type as `value` or `null`. Can be in `[start, end]` format in case of range value.
+   * @template TError The validation error type. Will be either `string` or a `null`. Can be in `[start, end]` format in case of range value.
    * @param {TValue} value The value that was just accepted.
+   * @param {FieldChangeHandlerContext<TError>} context The context containing the validation result of the current value.
    */
   onAccept: PropTypes.func,
   /**

package/modern/StaticDateTimePicker/StaticDateTimePicker.js

@@ -181,7 +181,9 @@ StaticDateTimePicker.propTypes = {
   /**
    * Callback fired when the value is accepted.
    * @template TValue The value type. Will be either the same type as `value` or `null`. Can be in `[start, end]` format in case of range value.
+   * @template TError The validation error type. Will be either `string` or a `null`. Can be in `[start, end]` format in case of range value.
    * @param {TValue} value The value that was just accepted.
+   * @param {FieldChangeHandlerContext<TError>} context The context containing the validation result of the current value.
    */
   onAccept: PropTypes.func,
   /**

package/modern/StaticTimePicker/StaticTimePicker.js

@@ -125,7 +125,9 @@ StaticTimePicker.propTypes = {
   /**
    * Callback fired when the value is accepted.
    * @template TValue The value type. Will be either the same type as `value` or `null`. Can be in `[start, end]` format in case of range value.
+   * @template TError The validation error type. Will be either `string` or a `null`. Can be in `[start, end]` format in case of range value.
    * @param {TValue} value The value that was just accepted.
+   * @param {FieldChangeHandlerContext<TError>} context The context containing the validation result of the current value.
    */
   onAccept: PropTypes.func,
   /**

package/modern/TimePicker/TimePicker.js

@@ -157,7 +157,9 @@ process.env.NODE_ENV !== "production" ? TimePicker.propTypes = {
   /**
    * Callback fired when the value is accepted.
    * @template TValue The value type. Will be either the same type as `value` or `null`. Can be in `[start, end]` format in case of range value.
+   * @template TError The validation error type. Will be either `string` or a `null`. Can be in `[start, end]` format in case of range value.
    * @param {TValue} value The value that was just accepted.
+   * @param {FieldChangeHandlerContext<TError>} context The context containing the validation result of the current value.
    */
   onAccept: PropTypes.func,
   /**

package/modern/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/x-date-pickers v7.7.0
+ * @mui/x-date-pickers v7.7.1
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the

package/modern/internals/components/PickersArrowSwitcher/PickersArrowSwitcher.js

@@ -1,6 +1,6 @@
 import _extends from "@babel/runtime/helpers/esm/extends";
 import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
-const _excluded = ["children", "className", "slots", "slotProps", "isNextDisabled", "isNextHidden", "onGoToNext", "nextLabel", "isPreviousDisabled", "isPreviousHidden", "onGoToPrevious", "previousLabel"],
+const _excluded = ["children", "className", "slots", "slotProps", "isNextDisabled", "isNextHidden", "onGoToNext", "nextLabel", "isPreviousDisabled", "isPreviousHidden", "onGoToPrevious", "previousLabel", "labelId"],
   _excluded2 = ["ownerState"],
   _excluded3 = ["ownerState"];
 import * as React from 'react';
@@ -73,7 +73,8 @@ export const PickersArrowSwitcher = /*#__PURE__*/React.forwardRef(function Picke
       isPreviousDisabled,
       isPreviousHidden,
       onGoToPrevious,
-      previousLabel
+      previousLabel,
+      labelId
     } = props,
     other = _objectWithoutPropertiesLoose(props, _excluded);
   const ownerState = props;
@@ -156,6 +157,7 @@ export const PickersArrowSwitcher = /*#__PURE__*/React.forwardRef(function Picke
     })), children ? /*#__PURE__*/_jsx(Typography, {
       variant: "subtitle1",
       component: "span",
+      id: labelId,
       children: children
     }) : /*#__PURE__*/_jsx(PickersArrowSwitcherSpacer, {
       className: classes.spacer,

package/modern/internals/hooks/useField/useField.utils.js

@@ -103,7 +103,8 @@ export const applyLocalizedDigits = (valueStr, localizedDigits) => {
 };
 export const isStringNumber = (valueStr, localizedDigits) => {
   const nonLocalizedValueStr = removeLocalizedDigits(valueStr, localizedDigits);
-  return !Number.isNaN(Number(nonLocalizedValueStr));
+  // `Number(' ')` returns `0` even if ' ' is not a valid number.
+  return nonLocalizedValueStr !== ' ' && !Number.isNaN(Number(nonLocalizedValueStr));
 };
 
 /**