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

package/managers/useTimeManager.js

@@ -0,0 +1,51 @@
+'use client';
+
+import _extends from "@babel/runtime/helpers/esm/extends";
+import * as React from 'react';
+import { singleItemFieldValueManager, singleItemValueManager } from "../internals/utils/valueManagers.js";
+import { validateTime } from "../validation/index.js";
+export function useTimeManager(parameters = {}) {
+  const {
+    enableAccessibleFieldDOMStructure = true
+  } = parameters;
+  return React.useMemo(() => ({
+    valueType: 'time',
+    validator: validateTime,
+    internal_valueManager: singleItemValueManager,
+    internal_fieldValueManager: singleItemFieldValueManager,
+    internal_enableAccessibleFieldDOMStructure: enableAccessibleFieldDOMStructure,
+    internal_applyDefaultsToFieldInternalProps: ({
+      internalProps,
+      utils
+    }) => _extends({}, internalProps, getTimeFieldInternalPropsDefaults({
+      utils,
+      internalProps
+    })),
+    internal_getOpenPickerButtonAriaLabel: ({
+      value,
+      utils,
+      localeText
+    }) => {
+      const formattedValue = utils.isValid(value) ? utils.format(value, 'fullTime') : null;
+      return localeText.openTimePickerDialogue(formattedValue);
+    }
+  }), [enableAccessibleFieldDOMStructure]);
+}
+
+/**
+ * Private utility function to get the default internal props for the fields with time editing.
+ * Is used by the `useTimeManager` and `useTimeRangeManager` hooks.
+ */
+export function getTimeFieldInternalPropsDefaults(parameters) {
+  const {
+    utils,
+    internalProps
+  } = parameters;
+  const ampm = internalProps.ampm ?? utils.is12HourCycleInCurrentLocale();
+  const defaultFormat = ampm ? utils.formats.fullTime12h : utils.formats.fullTime24h;
+  return {
+    disablePast: internalProps.disablePast ?? false,
+    disableFuture: internalProps.disableFuture ?? false,
+    format: internalProps.format ?? defaultFormat
+  };
+}

package/models/adapters.d.ts

@@ -215,7 +215,7 @@ export interface MuiPickersAdapter<TLocale = any> {
      */
     is12HourCycleInCurrentLocale(): boolean;
     /**
-     * Create a format with no meta-token (e.g: `LLL` or `PP`).
+     * Create a format with no meta-token (for example: `LLL` or `PP`).
      * @param {string} format The format to expand.
      * @returns {string} The expanded format.
      */
@@ -225,7 +225,7 @@ export interface MuiPickersAdapter<TLocale = any> {
      * @param {PickerValidDate | null} value The value to test.
      * @returns {boolean} `true` if the value is a valid date according to the date library.
      */
-    isValid(value: PickerValidDate | null): boolean;
+    isValid(value: PickerValidDate | null): value is PickerValidDate;
     /**
      * Format a date using an adapter format string (see the `AdapterFormats` interface)
      * @param {PickerValidDate} value The date to format.
@@ -248,7 +248,7 @@ export interface MuiPickersAdapter<TLocale = any> {
      */
     formatNumber(numberToFormat: string): string;
     /**
-     * Check if the two dates are equal (e.g: they represent the same timestamp).
+     * Check if the two dates are equal (which means they represent the same timestamp).
      * @param {PickerValidDate | null} value The reference date.
      * @param {PickerValidDate | null} comparing The date to compare with the reference date.
      * @returns {boolean} `true` if the two dates are equal.
@@ -442,7 +442,7 @@ export interface MuiPickersAdapter<TLocale = any> {
      */
     getMonth(value: PickerValidDate): number;
     /**
-     * Get the date (e.g: the day in the month) of the given date.
+     * Get the date (day in the month) of the given date.
      * @param {PickerValidDate} value The given date.
      * @returns {number} The date of the given date.
      */
@@ -486,7 +486,7 @@ export interface MuiPickersAdapter<TLocale = any> {
      */
     setMonth(value: PickerValidDate, month: number): PickerValidDate;
     /**
-     * Set the date (e.g: the day in the month) to the given date.
+     * Set the date (day in the month) to the given date.
      * @param {PickerValidDate} value The date to be changed.
      * @param {number} date The date of the new date.
      * @returns {PickerValidDate} The new date with the date set.

package/models/fields.d.ts

@@ -1,10 +1,11 @@
 import * as React from 'react';
 import { TextFieldProps } from '@mui/material/TextField';
-import type { ExportedUseClearableFieldProps, UseClearableFieldResponse } from '../hooks/useClearableField';
-import { ExportedPickersSectionListProps } from '../PickersSectionList';
+import type { ExportedPickersSectionListProps } from '../PickersSectionList';
 import type { UseFieldInternalProps, UseFieldResponse } from '../internals/hooks/useField';
 import type { PickersTextFieldProps } from '../PickersTextField';
-import { BaseForwardedSingleInputFieldProps } from '../internals/models';
+import { BaseForwardedSingleInputFieldProps, FieldRangeSection, PickerRangeValue, PickerValidValue } from '../internals/models';
+import { PickerOwnerState } from './pickers';
+import type { ExportedPickerFieldUIProps } from '../internals/components/PickerFieldUI';
 export type FieldSectionType = 'year' | 'month' | 'day' | 'weekDay' | 'hours' | 'minutes' | 'seconds' | 'meridiem' | 'empty';
 export type FieldSectionContentType = 'digit' | 'digit-with-letter' | 'letter';
 export interface FieldSection {
@@ -69,12 +70,14 @@ export interface FieldSection {
      */
     endSeparator: string;
 }
-export interface FieldRef<TSection extends FieldSection> {
+type IsAny<T> = boolean extends (T extends never ? true : false) ? true : false;
+export type InferFieldSection<TValue extends PickerValidValue> = IsAny<TValue> extends true ? FieldSection : TValue extends PickerRangeValue ? FieldRangeSection : FieldSection;
+export interface FieldRef<TValue extends PickerValidValue> {
     /**
      * Returns the sections of the current value.
-     * @returns {TSection[]} The sections of the current value.
+     * @returns {InferFieldSection<TValue>[]} The sections of the current value.
      */
-    getSections: () => TSection[];
+    getSections: () => InferFieldSection<TValue>[];
     /**
      * Returns the index of the active section (the first focused section).
      * If no section is active, returns `null`.
@@ -98,18 +101,39 @@ export interface FieldRef<TSection extends FieldSection> {
     isFieldFocused: () => boolean;
 }
 export type FieldSelectedSections = number | FieldSectionType | null | 'all';
+export interface FieldOwnerState extends PickerOwnerState {
+    /**
+     * `true` if the field is disabled, `false` otherwise.
+     */
+    isFieldDisabled: boolean;
+    /**
+     * `true` if the field is read-only, `false` otherwise.
+     */
+    isFieldReadOnly: boolean;
+    /**
+     * `true` if the field is required, `false` otherwise.
+     */
+    isFieldRequired: boolean;
+    /**
+     * The direction of the field.
+     * Is equal to "ltr" when the field is in left-to-right direction.
+     * Is equal to "rtl" when the field is in right-to-left direction.
+     */
+    fieldDirection: 'ltr' | 'rtl';
+}
 /**
  * Props the prop `slotProps.field` of a picker can receive.
  */
-export type PickerFieldSlotProps<TValue, TSection extends FieldSection, TEnableAccessibleFieldDOMStructure extends boolean> = ExportedUseClearableFieldProps & Pick<UseFieldInternalProps<TValue, TSection, TEnableAccessibleFieldDOMStructure, unknown>, 'shouldRespectLeadingZeros' | 'readOnly'> & React.HTMLAttributes<HTMLDivElement> & {
+export type PickerFieldSlotProps<TValue extends PickerValidValue, TEnableAccessibleFieldDOMStructure extends boolean> = ExportedPickerFieldUIProps & Pick<UseFieldInternalProps<TValue, TEnableAccessibleFieldDOMStructure, unknown>, 'shouldRespectLeadingZeros' | 'readOnly'> & React.HTMLAttributes<HTMLDivElement> & {
     ref?: React.Ref<HTMLDivElement>;
 };
 /**
- * Props the text field receives when used with a single input picker.
+ * Props the text field receives when used inside 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>>;
+export type BaseSingleInputPickersTextFieldProps<TEnableAccessibleFieldDOMStructure extends boolean> = Omit<UseFieldResponse<TEnableAccessibleFieldDOMStructure, BaseForwardedSingleInputFieldProps>, 'slots' | 'slotProps' | 'clearable' | 'onClear' | 'openPickerButtonPosition' | 'clearButtonPosition' | 'openPickerAriaLabel'>;
 /**
  * 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/index.d.ts

@@ -5,4 +5,5 @@ export * from './views';
 export * from './adapters';
 export * from './common';
 export * from './pickers';
+export * from './manager';
 export type { PropsFromSlot } from '@mui/x-internals/slots';

package/models/index.js

@@ -5,6 +5,7 @@ export * from "./views.js";
 export * from "./adapters.js";
 export * from "./common.js";
 export * from "./pickers.js";
+export * from "./manager.js";
 
 // Utils shared across the X packages
 export {};

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;