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

package/models/manager.d.ts

@@ -0,0 +1,87 @@
+import type { FieldValueManager, UseFieldInternalProps } from '../internals/hooks/useField';
+import type { PickerValueManager } from '../internals/hooks/usePicker';
+import type { UseLocalizationContextReturnValue } from '../internals/hooks/useUtils';
+import type { PickerValidValue } from '../internals/models';
+import type { Validator } from '../validation';
+import type { PickerValueType } from './common';
+/**
+ * Object that contains all the necessary methods and properties to adapter a picker or a field for a given value type.
+ * You should never create your own manager.
+ * Instead, use the hooks exported from '@mui/x-date-pickers/managers' and '@mui/x-date-pickers-pro/managers'.
+ *
+ * ```tsx
+ * import { useDateManager } from '@mui/x-date-pickers/managers';
+ * import { useValidation } from '@mui/x-date-pickers/validation';
+ *
+ * const manager = useDateManager();
+ * const { hasValidationError } = useValidation({
+ *   validator: manager.validator,
+ *   value,
+ *   timezone,
+ *   props,
+ * });
+ * ```
+ */
+export interface PickerManager<TValue extends PickerValidValue, TEnableAccessibleFieldDOMStructure extends boolean, TError, TFieldInternalProps extends {}, TFieldInternalPropsWithDefaults extends UseFieldInternalProps<TValue, TEnableAccessibleFieldDOMStructure, TError>> {
+    /**
+     * The type of the value (e.g. 'date', 'date-time', 'time').
+     */
+    valueType: PickerValueType;
+    /**
+     * Checks if a value is valid and returns an error code otherwise.
+     * It can be passed to the `useValidation` hook to validate a value:
+     *
+     * ```tsx
+     * import { useDateManager } from '@mui/x-date-pickers/managers';
+     * import { useValidation } from '@mui/x-date-pickers/validation';
+     *
+     * const manager = useDateManager();
+     * const { hasValidationError } = useValidation({
+     *   validator: manager.validator,
+     *   value,
+     *   timezone,
+     *   props,
+     * });
+     * ```
+     */
+    validator: Validator<TValue, TError, TFieldInternalPropsWithDefaults>;
+    /**
+     * Object containing basic methods to interact with the value of the picker or field.
+     * This property is not part of the public API and should not be used directly.
+     */
+    internal_valueManager: PickerValueManager<TValue, TError>;
+    /**
+     * Object containing all the necessary methods to interact with the value of the field.
+     * This property is not part of the public API and should not be used directly.
+     */
+    internal_fieldValueManager: FieldValueManager<TValue>;
+    /**
+     * `true` if the field is using the accessible DOM structure.
+     * `false` if the field is using the non-accessible DOM structure.
+     * This property is not part of the public API and should not be used directly.
+     */
+    internal_enableAccessibleFieldDOMStructure: TEnableAccessibleFieldDOMStructure;
+    /**
+     * Applies the default values to the field internal props.
+     * This usually includes:
+     * - a default format to display the value in the field
+     * - some default validation props that are needed to validate the value (e.g: minDate, maxDate)
+     * This property is not part of the public API and should not be used directly.
+     * @param {ApplyDefaultsToFieldInternalPropsParameters<TFieldInternalProps>} parameters The parameters to apply the defaults.
+     * @returns {TFieldInternalPropsWithDefaults} The field internal props with the defaults applied.
+     */
+    internal_applyDefaultsToFieldInternalProps: (parameters: ApplyDefaultsToFieldInternalPropsParameters<TFieldInternalProps>) => TFieldInternalPropsWithDefaults;
+    /**
+     * Returns the aria-label to apply on the button that opens the picker.
+     * @param {GetOpenPickerButtonAriaLabelParameters<TValue>} params The parameters to get the aria-label.
+     * @returns {string} The aria-label to apply on the button that opens the picker.
+     */
+    internal_getOpenPickerButtonAriaLabel: (params: GetOpenPickerButtonAriaLabelParameters<TValue>) => string;
+}
+interface ApplyDefaultsToFieldInternalPropsParameters<TFieldInternalProps extends {}> extends UseLocalizationContextReturnValue {
+    internalProps: TFieldInternalProps;
+}
+interface GetOpenPickerButtonAriaLabelParameters<TValue extends PickerValidValue> extends UseLocalizationContextReturnValue {
+    value: TValue;
+}
+export {};

package/models/manager.js

@@ -0,0 +1 @@
+export {};

package/models/pickers.d.ts

@@ -11,6 +11,13 @@ export interface PickerChangeHandlerContext<TError> {
 export interface PickerValidDateLookup {
 }
 export type PickerValidDate = keyof PickerValidDateLookup extends never ? any : PickerValidDateLookup[keyof PickerValidDateLookup];
+/**
+ * Importance of the change when picking a value:
+ * - "accept": fires `onChange`, fires `onAccept` and closes the picker.
+ * - "set": fires `onChange` but do not fire `onAccept` and does not close the picker.
+ * @default "accept"
+ */
+export type PickerChangeImportance = 'set' | 'accept';
 export interface PickerOwnerState {
     /**
      * `true` if the value of the picker is currently empty.

package/models/validation.d.ts

@@ -1,3 +1,4 @@
+import type { PickerValidValue } from '../internals/models';
 /**
  * Validation error types applicable to both date and time validation
  */
@@ -5,7 +6,7 @@ type CommonDateTimeValidationError = 'invalidDate' | 'disableFuture' | 'disableP
 export type DateValidationError = CommonDateTimeValidationError | 'shouldDisableDate' | 'shouldDisableMonth' | 'shouldDisableYear' | 'minDate' | 'maxDate';
 export type TimeValidationError = CommonDateTimeValidationError | 'minutesStep' | 'minTime' | 'maxTime' | 'shouldDisableTime-hours' | 'shouldDisableTime-minutes' | 'shouldDisableTime-seconds';
 export type DateTimeValidationError = DateValidationError | TimeValidationError;
-export interface OnErrorProps<TValue, TError> {
+export interface OnErrorProps<TValue extends PickerValidValue, TError> {
     /**
      * Callback fired when the error associated with the current value changes.
      * When a validation error is detected, the `error` parameter contains a non-null value.

package/modern/AdapterDateFns/AdapterDateFns.js

@@ -1,49 +1,47 @@
 /* eslint-disable class-methods-use-this */
-import addDays from 'date-fns/addDays';
-import addSeconds from 'date-fns/addSeconds';
-import addMinutes from 'date-fns/addMinutes';
-import addHours from 'date-fns/addHours';
-import addWeeks from 'date-fns/addWeeks';
-import addMonths from 'date-fns/addMonths';
-import addYears from 'date-fns/addYears';
-import endOfDay from 'date-fns/endOfDay';
-import endOfWeek from 'date-fns/endOfWeek';
-import endOfYear from 'date-fns/endOfYear';
-import dateFnsFormat from 'date-fns/format';
-import getDate from 'date-fns/getDate';
-import getDaysInMonth from 'date-fns/getDaysInMonth';
-import getHours from 'date-fns/getHours';
-import getMinutes from 'date-fns/getMinutes';
-import getMonth from 'date-fns/getMonth';
-import getSeconds from 'date-fns/getSeconds';
-import getMilliseconds from 'date-fns/getMilliseconds';
-import getWeek from 'date-fns/getWeek';
-import getYear from 'date-fns/getYear';
-import isAfter from 'date-fns/isAfter';
-import isBefore from 'date-fns/isBefore';
-import isEqual from 'date-fns/isEqual';
-import isSameDay from 'date-fns/isSameDay';
-import isSameYear from 'date-fns/isSameYear';
-import isSameMonth from 'date-fns/isSameMonth';
-import isSameHour from 'date-fns/isSameHour';
-import isValid from 'date-fns/isValid';
-import dateFnsParse from 'date-fns/parse';
-import setDate from 'date-fns/setDate';
-import setHours from 'date-fns/setHours';
-import setMinutes from 'date-fns/setMinutes';
-import setMonth from 'date-fns/setMonth';
-import setSeconds from 'date-fns/setSeconds';
-import setMilliseconds from 'date-fns/setMilliseconds';
-import setYear from 'date-fns/setYear';
-import startOfDay from 'date-fns/startOfDay';
-import startOfMonth from 'date-fns/startOfMonth';
-import endOfMonth from 'date-fns/endOfMonth';
-import startOfWeek from 'date-fns/startOfWeek';
-import startOfYear from 'date-fns/startOfYear';
-import isWithinInterval from 'date-fns/isWithinInterval';
-import defaultLocale from 'date-fns/locale/en-US';
-// @ts-ignore
-import longFormatters from 'date-fns/_lib/format/longFormatters';
+import { addDays } from 'date-fns/addDays';
+import { addSeconds } from 'date-fns/addSeconds';
+import { addMinutes } from 'date-fns/addMinutes';
+import { addHours } from 'date-fns/addHours';
+import { addWeeks } from 'date-fns/addWeeks';
+import { addMonths } from 'date-fns/addMonths';
+import { addYears } from 'date-fns/addYears';
+import { endOfDay } from 'date-fns/endOfDay';
+import { endOfWeek } from 'date-fns/endOfWeek';
+import { endOfYear } from 'date-fns/endOfYear';
+import { format as dateFnsFormat, longFormatters } from 'date-fns/format';
+import { getDate } from 'date-fns/getDate';
+import { getDaysInMonth } from 'date-fns/getDaysInMonth';
+import { getHours } from 'date-fns/getHours';
+import { getMinutes } from 'date-fns/getMinutes';
+import { getMonth } from 'date-fns/getMonth';
+import { getSeconds } from 'date-fns/getSeconds';
+import { getMilliseconds } from 'date-fns/getMilliseconds';
+import { getWeek } from 'date-fns/getWeek';
+import { getYear } from 'date-fns/getYear';
+import { isAfter } from 'date-fns/isAfter';
+import { isBefore } from 'date-fns/isBefore';
+import { isEqual } from 'date-fns/isEqual';
+import { isSameDay } from 'date-fns/isSameDay';
+import { isSameYear } from 'date-fns/isSameYear';
+import { isSameMonth } from 'date-fns/isSameMonth';
+import { isSameHour } from 'date-fns/isSameHour';
+import { isValid } from 'date-fns/isValid';
+import { parse as dateFnsParse } from 'date-fns/parse';
+import { setDate } from 'date-fns/setDate';
+import { setHours } from 'date-fns/setHours';
+import { setMinutes } from 'date-fns/setMinutes';
+import { setMonth } from 'date-fns/setMonth';
+import { setSeconds } from 'date-fns/setSeconds';
+import { setMilliseconds } from 'date-fns/setMilliseconds';
+import { setYear } from 'date-fns/setYear';
+import { startOfDay } from 'date-fns/startOfDay';
+import { startOfMonth } from 'date-fns/startOfMonth';
+import { endOfMonth } from 'date-fns/endOfMonth';
+import { startOfWeek } from 'date-fns/startOfWeek';
+import { startOfYear } from 'date-fns/startOfYear';
+import { isWithinInterval } from 'date-fns/isWithinInterval';
+import { enUS } from 'date-fns/locale/en-US';
 import { AdapterDateFnsBase } from "../AdapterDateFnsBase/index.js";
 /**
  * Based on `@date-io/date-fns`
@@ -78,14 +76,18 @@ export class AdapterDateFns extends AdapterDateFnsBase {
     /* istanbul ignore next */
     if (process.env.NODE_ENV !== 'production') {
       if (typeof addDays !== 'function') {
-        throw new Error(['MUI: This adapter is only compatible with `date-fns` v2.x package versions.', 'Please, install v2.x of the package or use the `AdapterDateFnsV3` instead.'].join('\n'));
+        throw new Error(['MUI: The `date-fns` package v2.x is not compatible with this adapter.', 'Please, install v3.x or v4.x of the package or use the `AdapterDateFnsV2` instead.'].join('\n'));
+      }
+      if (!longFormatters) {
+        throw new Error('MUI: The minimum supported `date-fns` package version compatible with this adapter is `3.2.x`.');
       }
     }
     super({
-      locale: locale ?? defaultLocale,
+      locale: locale ?? enUS,
       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/AdapterDateFnsJalali/AdapterDateFnsJalali.js

@@ -1,50 +1,48 @@
 import _extends from "@babel/runtime/helpers/esm/extends";
 /* eslint-disable class-methods-use-this */
-import addSeconds from 'date-fns-jalali/addSeconds';
-import addMinutes from 'date-fns-jalali/addMinutes';
-import addHours from 'date-fns-jalali/addHours';
-import addDays from 'date-fns-jalali/addDays';
-import addWeeks from 'date-fns-jalali/addWeeks';
-import addMonths from 'date-fns-jalali/addMonths';
-import addYears from 'date-fns-jalali/addYears';
-import endOfDay from 'date-fns-jalali/endOfDay';
-import endOfWeek from 'date-fns-jalali/endOfWeek';
-import endOfYear from 'date-fns-jalali/endOfYear';
-import dateFnsFormat from 'date-fns-jalali/format';
-import getHours from 'date-fns-jalali/getHours';
-import getSeconds from 'date-fns-jalali/getSeconds';
-import getMilliseconds from 'date-fns-jalali/getMilliseconds';
-import getWeek from 'date-fns-jalali/getWeek';
-import getYear from 'date-fns-jalali/getYear';
-import getMonth from 'date-fns-jalali/getMonth';
-import getDate from 'date-fns-jalali/getDate';
-import getDaysInMonth from 'date-fns-jalali/getDaysInMonth';
-import getMinutes from 'date-fns-jalali/getMinutes';
-import isAfter from 'date-fns-jalali/isAfter';
-import isBefore from 'date-fns-jalali/isBefore';
-import isEqual from 'date-fns-jalali/isEqual';
-import isSameDay from 'date-fns-jalali/isSameDay';
-import isSameYear from 'date-fns-jalali/isSameYear';
-import isSameMonth from 'date-fns-jalali/isSameMonth';
-import isSameHour from 'date-fns-jalali/isSameHour';
-import isValid from 'date-fns-jalali/isValid';
-import dateFnsParse from 'date-fns-jalali/parse';
-import setDate from 'date-fns-jalali/setDate';
-import setHours from 'date-fns-jalali/setHours';
-import setMinutes from 'date-fns-jalali/setMinutes';
-import setMonth from 'date-fns-jalali/setMonth';
-import setSeconds from 'date-fns-jalali/setSeconds';
-import setMilliseconds from 'date-fns-jalali/setMilliseconds';
-import setYear from 'date-fns-jalali/setYear';
-import startOfDay from 'date-fns-jalali/startOfDay';
-import startOfMonth from 'date-fns-jalali/startOfMonth';
-import endOfMonth from 'date-fns-jalali/endOfMonth';
-import startOfWeek from 'date-fns-jalali/startOfWeek';
-import startOfYear from 'date-fns-jalali/startOfYear';
-import isWithinInterval from 'date-fns-jalali/isWithinInterval';
-import defaultLocale from 'date-fns-jalali/locale/fa-IR';
-// @ts-ignore
-import longFormatters from 'date-fns-jalali/_lib/format/longFormatters';
+import { addSeconds } from 'date-fns-jalali/addSeconds';
+import { addMinutes } from 'date-fns-jalali/addMinutes';
+import { addHours } from 'date-fns-jalali/addHours';
+import { addDays } from 'date-fns-jalali/addDays';
+import { addWeeks } from 'date-fns-jalali/addWeeks';
+import { addMonths } from 'date-fns-jalali/addMonths';
+import { addYears } from 'date-fns-jalali/addYears';
+import { endOfDay } from 'date-fns-jalali/endOfDay';
+import { endOfWeek } from 'date-fns-jalali/endOfWeek';
+import { endOfYear } from 'date-fns-jalali/endOfYear';
+import { format as dateFnsFormat, longFormatters } from 'date-fns-jalali/format';
+import { getHours } from 'date-fns-jalali/getHours';
+import { getSeconds } from 'date-fns-jalali/getSeconds';
+import { getMilliseconds } from 'date-fns-jalali/getMilliseconds';
+import { getWeek } from 'date-fns-jalali/getWeek';
+import { getYear } from 'date-fns-jalali/getYear';
+import { getMonth } from 'date-fns-jalali/getMonth';
+import { getDate } from 'date-fns-jalali/getDate';
+import { getDaysInMonth } from 'date-fns-jalali/getDaysInMonth';
+import { getMinutes } from 'date-fns-jalali/getMinutes';
+import { isAfter } from 'date-fns-jalali/isAfter';
+import { isBefore } from 'date-fns-jalali/isBefore';
+import { isEqual } from 'date-fns-jalali/isEqual';
+import { isSameDay } from 'date-fns-jalali/isSameDay';
+import { isSameYear } from 'date-fns-jalali/isSameYear';
+import { isSameMonth } from 'date-fns-jalali/isSameMonth';
+import { isSameHour } from 'date-fns-jalali/isSameHour';
+import { isValid } from 'date-fns-jalali/isValid';
+import { parse as dateFnsParse } from 'date-fns-jalali/parse';
+import { setDate } from 'date-fns-jalali/setDate';
+import { setHours } from 'date-fns-jalali/setHours';
+import { setMinutes } from 'date-fns-jalali/setMinutes';
+import { setMonth } from 'date-fns-jalali/setMonth';
+import { setSeconds } from 'date-fns-jalali/setSeconds';
+import { setMilliseconds } from 'date-fns-jalali/setMilliseconds';
+import { setYear } from 'date-fns-jalali/setYear';
+import { startOfDay } from 'date-fns-jalali/startOfDay';
+import { startOfMonth } from 'date-fns-jalali/startOfMonth';
+import { endOfMonth } from 'date-fns-jalali/endOfMonth';
+import { startOfWeek } from 'date-fns-jalali/startOfWeek';
+import { startOfYear } from 'date-fns-jalali/startOfYear';
+import { isWithinInterval } from 'date-fns-jalali/isWithinInterval';
+import { faIR as defaultLocale } from 'date-fns-jalali/locale/fa-IR';
 import { AdapterDateFnsBase } from "../AdapterDateFnsBase/index.js";
 const defaultFormats = {
   year: 'yyyy',
@@ -116,7 +114,10 @@ export class AdapterDateFnsJalali extends AdapterDateFnsBase {
     /* istanbul ignore next */
     if (process.env.NODE_ENV !== 'production') {
       if (typeof addDays !== 'function') {
-        throw new Error(['MUI: The `date-fns-jalali` package v3.x is not compatible with this adapter.', 'Please, install v2.x of the package or use the `AdapterDateFnsJalaliV3` instead.'].join('\n'));
+        throw new Error(['MUI: The `date-fns-jalali` package v2.x is not compatible with this adapter.', 'Please, install v3.x or v4.x of the package or use the `AdapterDateFnsJalaliV2` instead.'].join('\n'));
+      }
+      if (!longFormatters) {
+        throw new Error('MUI: The minimum supported `date-fns-jalali` package version compatible with this adapter is `3.2.x`.');
       }
     }
     super({
@@ -127,6 +128,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/{AdapterDateFnsJalaliV3/AdapterDateFnsJalaliV3.js → AdapterDateFnsJalaliV2/AdapterDateFnsJalaliV2.js}

@@ -1,53 +1,50 @@
 import _extends from "@babel/runtime/helpers/esm/extends";
 /* eslint-disable class-methods-use-this */
-// TODO remove when date-fns-jalali-v3 is the default
 // @ts-nocheck
-import { addSeconds } from 'date-fns-jalali/addSeconds';
-import { addMinutes } from 'date-fns-jalali/addMinutes';
-import { addHours } from 'date-fns-jalali/addHours';
-import { addDays } from 'date-fns-jalali/addDays';
-import { addWeeks } from 'date-fns-jalali/addWeeks';
-import { addMonths } from 'date-fns-jalali/addMonths';
-import { addYears } from 'date-fns-jalali/addYears';
-import { endOfDay } from 'date-fns-jalali/endOfDay';
-import { endOfWeek } from 'date-fns-jalali/endOfWeek';
-import { endOfYear } from 'date-fns-jalali/endOfYear';
-import { format as dateFnsFormat, longFormatters } from 'date-fns-jalali/format';
-import { getHours } from 'date-fns-jalali/getHours';
-import { getSeconds } from 'date-fns-jalali/getSeconds';
-import { getMilliseconds } from 'date-fns-jalali/getMilliseconds';
-import { getWeek } from 'date-fns-jalali/getWeek';
-import { getYear } from 'date-fns-jalali/getYear';
-import { getMonth } from 'date-fns-jalali/getMonth';
-import { getDate } from 'date-fns-jalali/getDate';
-import { getDaysInMonth } from 'date-fns-jalali/getDaysInMonth';
-import { getMinutes } from 'date-fns-jalali/getMinutes';
-import { isAfter } from 'date-fns-jalali/isAfter';
-import { isBefore } from 'date-fns-jalali/isBefore';
-import { isEqual } from 'date-fns-jalali/isEqual';
-import { isSameDay } from 'date-fns-jalali/isSameDay';
-import { isSameYear } from 'date-fns-jalali/isSameYear';
-import { isSameMonth } from 'date-fns-jalali/isSameMonth';
-import { isSameHour } from 'date-fns-jalali/isSameHour';
-import { isValid } from 'date-fns-jalali/isValid';
-import { parse as dateFnsParse } from 'date-fns-jalali/parse';
-import { setDate } from 'date-fns-jalali/setDate';
-import { setHours } from 'date-fns-jalali/setHours';
-import { setMinutes } from 'date-fns-jalali/setMinutes';
-import { setMonth } from 'date-fns-jalali/setMonth';
-import { setSeconds } from 'date-fns-jalali/setSeconds';
-import { setMilliseconds } from 'date-fns-jalali/setMilliseconds';
-import { setYear } from 'date-fns-jalali/setYear';
-import { startOfDay } from 'date-fns-jalali/startOfDay';
-import { startOfMonth } from 'date-fns-jalali/startOfMonth';
-import { endOfMonth } from 'date-fns-jalali/endOfMonth';
-import { startOfWeek } from 'date-fns-jalali/startOfWeek';
-import { startOfYear } from 'date-fns-jalali/startOfYear';
-import { isWithinInterval } from 'date-fns-jalali/isWithinInterval';
-import { faIR as defaultLocale } from 'date-fns-jalali/locale/fa-IR';
-// date-fns-jalali v2 does not export types
-// @ts-ignore TODO remove when date-fns-jalali-v3 is the default
-
+import addSeconds from 'date-fns-jalali/addSeconds';
+import addMinutes from 'date-fns-jalali/addMinutes';
+import addHours from 'date-fns-jalali/addHours';
+import addDays from 'date-fns-jalali/addDays';
+import addWeeks from 'date-fns-jalali/addWeeks';
+import addMonths from 'date-fns-jalali/addMonths';
+import addYears from 'date-fns-jalali/addYears';
+import endOfDay from 'date-fns-jalali/endOfDay';
+import endOfWeek from 'date-fns-jalali/endOfWeek';
+import endOfYear from 'date-fns-jalali/endOfYear';
+import dateFnsFormat from 'date-fns-jalali/format';
+import getHours from 'date-fns-jalali/getHours';
+import getSeconds from 'date-fns-jalali/getSeconds';
+import getMilliseconds from 'date-fns-jalali/getMilliseconds';
+import getWeek from 'date-fns-jalali/getWeek';
+import getYear from 'date-fns-jalali/getYear';
+import getMonth from 'date-fns-jalali/getMonth';
+import getDate from 'date-fns-jalali/getDate';
+import getDaysInMonth from 'date-fns-jalali/getDaysInMonth';
+import getMinutes from 'date-fns-jalali/getMinutes';
+import isAfter from 'date-fns-jalali/isAfter';
+import isBefore from 'date-fns-jalali/isBefore';
+import isEqual from 'date-fns-jalali/isEqual';
+import isSameDay from 'date-fns-jalali/isSameDay';
+import isSameYear from 'date-fns-jalali/isSameYear';
+import isSameMonth from 'date-fns-jalali/isSameMonth';
+import isSameHour from 'date-fns-jalali/isSameHour';
+import isValid from 'date-fns-jalali/isValid';
+import dateFnsParse from 'date-fns-jalali/parse';
+import setDate from 'date-fns-jalali/setDate';
+import setHours from 'date-fns-jalali/setHours';
+import setMinutes from 'date-fns-jalali/setMinutes';
+import setMonth from 'date-fns-jalali/setMonth';
+import setSeconds from 'date-fns-jalali/setSeconds';
+import setMilliseconds from 'date-fns-jalali/setMilliseconds';
+import setYear from 'date-fns-jalali/setYear';
+import startOfDay from 'date-fns-jalali/startOfDay';
+import startOfMonth from 'date-fns-jalali/startOfMonth';
+import endOfMonth from 'date-fns-jalali/endOfMonth';
+import startOfWeek from 'date-fns-jalali/startOfWeek';
+import startOfYear from 'date-fns-jalali/startOfYear';
+import isWithinInterval from 'date-fns-jalali/isWithinInterval';
+import defaultLocale from 'date-fns-jalali/locale/fa-IR';
+import longFormatters from 'date-fns-jalali/_lib/format/longFormatters';
 import { AdapterDateFnsBase } from "../AdapterDateFnsBase/index.js";
 const defaultFormats = {
   year: 'yyyy',
@@ -119,10 +116,7 @@ export class AdapterDateFnsJalali extends AdapterDateFnsBase {
     /* istanbul ignore next */
     if (process.env.NODE_ENV !== 'production') {
       if (typeof addDays !== 'function') {
-        throw new Error([`MUI: The \`date-fns-jalali\` package v2.x is not compatible with this adapter.`, 'Please, install v3.x of the package or use the `AdapterDateFnsJalali` instead.'].join('\n'));
-      }
-      if (!longFormatters) {
-        throw new Error('MUI: The minimum supported `date-fns-jalali` package version compatible with this adapter is `3.2.x`.');
+        throw new Error(['MUI: This adapter is only compatible with `date-fns-jalali` v2.x package versions.', 'Please, install v2.x of the package or use the `AdapterDateFnsJalali` instead.'].join('\n'));
       }
     }
     super({
@@ -133,7 +127,6 @@ 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/AdapterDateFnsJalaliV2/index.js

@@ -0,0 +1 @@
+export { AdapterDateFnsJalali } from "./AdapterDateFnsJalaliV2.js";

package/modern/{AdapterDateFnsV3/AdapterDateFnsV3.js → AdapterDateFnsV2/AdapterDateFnsV2.js}

@@ -1,53 +1,49 @@
 /* eslint-disable class-methods-use-this */
-// TODO remove when date-fns-v3 is the default
 // @ts-nocheck
-import { addDays } from 'date-fns/addDays';
-import { addSeconds } from 'date-fns/addSeconds';
-import { addMinutes } from 'date-fns/addMinutes';
-import { addHours } from 'date-fns/addHours';
-import { addWeeks } from 'date-fns/addWeeks';
-import { addMonths } from 'date-fns/addMonths';
-import { addYears } from 'date-fns/addYears';
-import { endOfDay } from 'date-fns/endOfDay';
-import { endOfWeek } from 'date-fns/endOfWeek';
-import { endOfYear } from 'date-fns/endOfYear';
-// @ts-ignore TODO remove when date-fns-v3 is the default
-import { format as dateFnsFormat, longFormatters } from 'date-fns/format';
-import { getDate } from 'date-fns/getDate';
-import { getDaysInMonth } from 'date-fns/getDaysInMonth';
-import { getHours } from 'date-fns/getHours';
-import { getMinutes } from 'date-fns/getMinutes';
-import { getMonth } from 'date-fns/getMonth';
-import { getSeconds } from 'date-fns/getSeconds';
-import { getMilliseconds } from 'date-fns/getMilliseconds';
-import { getWeek } from 'date-fns/getWeek';
-import { getYear } from 'date-fns/getYear';
-import { isAfter } from 'date-fns/isAfter';
-import { isBefore } from 'date-fns/isBefore';
-import { isEqual } from 'date-fns/isEqual';
-import { isSameDay } from 'date-fns/isSameDay';
-import { isSameYear } from 'date-fns/isSameYear';
-import { isSameMonth } from 'date-fns/isSameMonth';
-import { isSameHour } from 'date-fns/isSameHour';
-import { isValid } from 'date-fns/isValid';
-import { parse as dateFnsParse } from 'date-fns/parse';
-import { setDate } from 'date-fns/setDate';
-import { setHours } from 'date-fns/setHours';
-import { setMinutes } from 'date-fns/setMinutes';
-import { setMonth } from 'date-fns/setMonth';
-import { setSeconds } from 'date-fns/setSeconds';
-import { setMilliseconds } from 'date-fns/setMilliseconds';
-import { setYear } from 'date-fns/setYear';
-import { startOfDay } from 'date-fns/startOfDay';
-import { startOfMonth } from 'date-fns/startOfMonth';
-import { endOfMonth } from 'date-fns/endOfMonth';
-import { startOfWeek } from 'date-fns/startOfWeek';
-import { startOfYear } from 'date-fns/startOfYear';
-import { isWithinInterval } from 'date-fns/isWithinInterval';
-import { enUS } from 'date-fns/locale/en-US';
-// date-fns v2 does not export types
-// @ts-ignore TODO remove when date-fns-v3 is the default
-
+import addDays from 'date-fns/addDays';
+import addSeconds from 'date-fns/addSeconds';
+import addMinutes from 'date-fns/addMinutes';
+import addHours from 'date-fns/addHours';
+import addWeeks from 'date-fns/addWeeks';
+import addMonths from 'date-fns/addMonths';
+import addYears from 'date-fns/addYears';
+import endOfDay from 'date-fns/endOfDay';
+import endOfWeek from 'date-fns/endOfWeek';
+import endOfYear from 'date-fns/endOfYear';
+import dateFnsFormat from 'date-fns/format';
+import getDate from 'date-fns/getDate';
+import getDaysInMonth from 'date-fns/getDaysInMonth';
+import getHours from 'date-fns/getHours';
+import getMinutes from 'date-fns/getMinutes';
+import getMonth from 'date-fns/getMonth';
+import getSeconds from 'date-fns/getSeconds';
+import getMilliseconds from 'date-fns/getMilliseconds';
+import getWeek from 'date-fns/getWeek';
+import getYear from 'date-fns/getYear';
+import isAfter from 'date-fns/isAfter';
+import isBefore from 'date-fns/isBefore';
+import isEqual from 'date-fns/isEqual';
+import isSameDay from 'date-fns/isSameDay';
+import isSameYear from 'date-fns/isSameYear';
+import isSameMonth from 'date-fns/isSameMonth';
+import isSameHour from 'date-fns/isSameHour';
+import isValid from 'date-fns/isValid';
+import dateFnsParse from 'date-fns/parse';
+import setDate from 'date-fns/setDate';
+import setHours from 'date-fns/setHours';
+import setMinutes from 'date-fns/setMinutes';
+import setMonth from 'date-fns/setMonth';
+import setSeconds from 'date-fns/setSeconds';
+import setMilliseconds from 'date-fns/setMilliseconds';
+import setYear from 'date-fns/setYear';
+import startOfDay from 'date-fns/startOfDay';
+import startOfMonth from 'date-fns/startOfMonth';
+import endOfMonth from 'date-fns/endOfMonth';
+import startOfWeek from 'date-fns/startOfWeek';
+import startOfYear from 'date-fns/startOfYear';
+import isWithinInterval from 'date-fns/isWithinInterval';
+import defaultLocale from 'date-fns/locale/en-US';
+import longFormatters from 'date-fns/_lib/format/longFormatters';
 import { AdapterDateFnsBase } from "../AdapterDateFnsBase/index.js";
 /**
  * Based on `@date-io/date-fns`
@@ -82,18 +78,14 @@ export class AdapterDateFns extends AdapterDateFnsBase {
     /* istanbul ignore next */
     if (process.env.NODE_ENV !== 'production') {
       if (typeof addDays !== 'function') {
-        throw new Error([`MUI: The \`date-fns\` package v2.x is not compatible with this adapter.`, 'Please, install v3.x or v4.x of the package or use the `AdapterDateFns` instead.'].join('\n'));
-      }
-      if (!longFormatters) {
-        throw new Error('MUI: The minimum supported `date-fns` package version compatible with this adapter is `3.2.x`.');
+        throw new Error(['MUI: This adapter is only compatible with `date-fns` v2.x package versions.', 'Please, install v2.x of the package or use the `AdapterDateFns` instead.'].join('\n'));
       }
     }
     super({
-      locale: locale ?? enUS,
+      locale: locale ?? defaultLocale,
       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/AdapterDateFnsV2/index.js

@@ -0,0 +1 @@
+export { AdapterDateFns } from "./AdapterDateFnsV2.js";

package/modern/AdapterMoment/AdapterMoment.js

@@ -430,12 +430,22 @@ export class AdapterMoment {
       const end = this.endOfWeek(this.endOfMonth(value));
       let count = 0;
       let current = start;
+      let currentDayOfYear = current.get('dayOfYear');
       const nestedWeeks = [];
       while (current.isBefore(end)) {
         const weekNumber = Math.floor(count / 7);
         nestedWeeks[weekNumber] = nestedWeeks[weekNumber] || [];
         nestedWeeks[weekNumber].push(current);
+        const prevDayOfYear = currentDayOfYear;
         current = this.addDays(current, 1);
+        currentDayOfYear = current.get('dayOfYear');
+
+        // If there is a TZ change at midnight, adding 1 day may only increase the date by 23 hours to 11pm
+        // To fix, bump the date into the next day (add 12 hours) and then revert to the start of the day
+        // See https://github.com/moment/moment/issues/4743#issuecomment-811306874 for context.
+        if (prevDayOfYear === currentDayOfYear) {
+          current = current.add(12, 'h').startOf('day');
+        }
         count += 1;
       }
       return nestedWeeks;