@mui/x-date-pickers 8.5.2 → 8.6.0

package/internals/hooks/useField/useField.utils.d.ts

@@ -1,13 +1,13 @@
 import { FieldSectionsValueBoundaries, SectionOrdering, FieldSectionValueBoundaries, FieldParsedSelectedSections } from "./useField.types.js";
 import { FieldSectionType, FieldSection, MuiPickersAdapter, FieldSectionContentType, PickersTimezone, PickerValidDate, FieldSelectedSections, PickerValueType, InferFieldSection } from "../../../models/index.js";
 import { PickerValidValue } from "../../models/index.js";
-export declare const getDateSectionConfigFromFormatToken: (utils: MuiPickersAdapter, formatToken: string) => Pick<FieldSection, "type" | "contentType"> & {
+export declare const getDateSectionConfigFromFormatToken: (adapter: MuiPickersAdapter, formatToken: string) => Pick<FieldSection, "type" | "contentType"> & {
   maxLength: number | undefined;
 };
-export declare const getDaysInWeekStr: (utils: MuiPickersAdapter, format: string) => string[];
-export declare const getLetterEditingOptions: (utils: MuiPickersAdapter, timezone: PickersTimezone, sectionType: FieldSectionType, format: string) => string[];
+export declare const getDaysInWeekStr: (adapter: MuiPickersAdapter, format: string) => string[];
+export declare const getLetterEditingOptions: (adapter: MuiPickersAdapter, timezone: PickersTimezone, sectionType: FieldSectionType, format: string) => string[];
 export declare const FORMAT_SECONDS_NO_LEADING_ZEROS = "s";
-export declare const getLocalizedDigits: (utils: MuiPickersAdapter) => string[];
+export declare const getLocalizedDigits: (adapter: MuiPickersAdapter) => string[];
 export declare const removeLocalizedDigits: (valueStr: string, localizedDigits: string[]) => string;
 export declare const applyLocalizedDigits: (valueStr: string, localizedDigits: string[]) => string;
 export declare const isStringNumber: (valueStr: string, localizedDigits: string[]) => boolean;
@@ -17,20 +17,20 @@ export declare const isStringNumber: (valueStr: string, localizedDigits: string[
  * Warning: Should only be called with non-localized digits. Call `removeLocalizedDigits` with your value if needed.
  */
 export declare const cleanLeadingZeros: (valueStr: string, size: number) => string;
-export declare const cleanDigitSectionValue: (utils: MuiPickersAdapter, value: number, sectionBoundaries: FieldSectionValueBoundaries<any>, localizedDigits: string[], section: Pick<FieldSection, "format" | "type" | "contentType" | "hasLeadingZerosInFormat" | "hasLeadingZerosInInput" | "maxLength">) => string;
+export declare const cleanDigitSectionValue: (adapter: MuiPickersAdapter, value: number, sectionBoundaries: FieldSectionValueBoundaries<any>, localizedDigits: string[], section: Pick<FieldSection, "format" | "type" | "contentType" | "hasLeadingZerosInFormat" | "hasLeadingZerosInInput" | "maxLength">) => string;
 export declare const getSectionVisibleValue: (section: FieldSection, target: "input-rtl" | "input-ltr" | "non-input", localizedDigits: string[]) => string;
-export declare const changeSectionValueFormat: (utils: MuiPickersAdapter, valueStr: string, currentFormat: string, newFormat: string) => string;
-export declare const doesSectionFormatHaveLeadingZeros: (utils: MuiPickersAdapter, contentType: FieldSectionContentType, sectionType: FieldSectionType, format: string) => boolean;
+export declare const changeSectionValueFormat: (adapter: MuiPickersAdapter, valueStr: string, currentFormat: string, newFormat: string) => string;
+export declare const doesSectionFormatHaveLeadingZeros: (adapter: MuiPickersAdapter, contentType: FieldSectionContentType, sectionType: FieldSectionType, format: string) => boolean;
 /**
  * Some date libraries like `dayjs` don't support parsing from date with escaped characters.
  * To make sure that the parsing works, we are building a format and a date without any separator.
  */
-export declare const getDateFromDateSections: (utils: MuiPickersAdapter, sections: FieldSection[], localizedDigits: string[]) => PickerValidDate;
+export declare const getDateFromDateSections: (adapter: MuiPickersAdapter, sections: FieldSection[], localizedDigits: string[]) => PickerValidDate;
 export declare const createDateStrForV7HiddenInputFromSections: (sections: FieldSection[]) => string;
 export declare const createDateStrForV6InputFromSections: (sections: FieldSection[], localizedDigits: string[], isRtl: boolean) => string;
-export declare const getSectionsBoundaries: (utils: MuiPickersAdapter, localizedDigits: string[], timezone: PickersTimezone) => FieldSectionsValueBoundaries;
+export declare const getSectionsBoundaries: (adapter: MuiPickersAdapter, localizedDigits: string[], timezone: PickersTimezone) => FieldSectionsValueBoundaries;
 export declare const validateSections: <TValue extends PickerValidValue>(sections: InferFieldSection<TValue>[], valueType: PickerValueType) => void;
-export declare const mergeDateIntoReferenceDate: (utils: MuiPickersAdapter, dateToTransferFrom: PickerValidDate, sections: FieldSection[], referenceDate: PickerValidDate, shouldLimitToEditedSections: boolean) => PickerValidDate;
+export declare const mergeDateIntoReferenceDate: (adapter: MuiPickersAdapter, dateToTransferFrom: PickerValidDate, sections: FieldSection[], referenceDate: PickerValidDate, shouldLimitToEditedSections: boolean) => PickerValidDate;
 export declare const isAndroid: () => boolean;
 export declare const getSectionOrder: (sections: FieldSection[], shouldApplyRTL: boolean) => SectionOrdering;
 export declare const parseSelectedSections: (selectedSections: FieldSelectedSections, sections: FieldSection[]) => FieldParsedSelectedSections;

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

@@ -5,8 +5,8 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.validateSections = exports.removeLocalizedDigits = exports.parseSelectedSections = exports.mergeDateIntoReferenceDate = exports.isStringNumber = exports.isAndroid = exports.getSectionsBoundaries = exports.getSectionVisibleValue = exports.getSectionOrder = exports.getLocalizedDigits = exports.getLetterEditingOptions = exports.getDaysInWeekStr = exports.getDateSectionConfigFromFormatToken = exports.getDateFromDateSections = exports.doesSectionFormatHaveLeadingZeros = exports.createDateStrForV7HiddenInputFromSections = exports.createDateStrForV6InputFromSections = exports.cleanLeadingZeros = exports.cleanDigitSectionValue = exports.changeSectionValueFormat = exports.applyLocalizedDigits = exports.FORMAT_SECONDS_NO_LEADING_ZEROS = void 0;
 var _dateUtils = require("../../utils/date-utils");
-const getDateSectionConfigFromFormatToken = (utils, formatToken) => {
-  const config = utils.formatTokenMap[formatToken];
+const getDateSectionConfigFromFormatToken = (adapter, formatToken) => {
+  const config = adapter.formatTokenMap[formatToken];
   if (config == null) {
     throw new Error([`MUI X: The token "${formatToken}" is not supported by the Date and Time Pickers.`, 'Please try using another token or open an issue on https://github.com/mui/mui-x/issues/new/choose if you think it should be supported.'].join('\n'));
   }
@@ -24,33 +24,33 @@ const getDateSectionConfigFromFormatToken = (utils, formatToken) => {
   };
 };
 exports.getDateSectionConfigFromFormatToken = getDateSectionConfigFromFormatToken;
-const getDaysInWeekStr = (utils, format) => {
+const getDaysInWeekStr = (adapter, format) => {
   const elements = [];
-  const now = utils.date(undefined, 'default');
-  const startDate = utils.startOfWeek(now);
-  const endDate = utils.endOfWeek(now);
+  const now = adapter.date(undefined, 'default');
+  const startDate = adapter.startOfWeek(now);
+  const endDate = adapter.endOfWeek(now);
   let current = startDate;
-  while (utils.isBefore(current, endDate)) {
+  while (adapter.isBefore(current, endDate)) {
     elements.push(current);
-    current = utils.addDays(current, 1);
+    current = adapter.addDays(current, 1);
   }
-  return elements.map(weekDay => utils.formatByString(weekDay, format));
+  return elements.map(weekDay => adapter.formatByString(weekDay, format));
 };
 exports.getDaysInWeekStr = getDaysInWeekStr;
-const getLetterEditingOptions = (utils, timezone, sectionType, format) => {
+const getLetterEditingOptions = (adapter, timezone, sectionType, format) => {
   switch (sectionType) {
     case 'month':
       {
-        return (0, _dateUtils.getMonthsInYear)(utils, utils.date(undefined, timezone)).map(month => utils.formatByString(month, format));
+        return (0, _dateUtils.getMonthsInYear)(adapter, adapter.date(undefined, timezone)).map(month => adapter.formatByString(month, format));
       }
     case 'weekDay':
       {
-        return getDaysInWeekStr(utils, format);
+        return getDaysInWeekStr(adapter, format);
       }
     case 'meridiem':
       {
-        const now = utils.date(undefined, timezone);
-        return [utils.startOfDay(now), utils.endOfDay(now)].map(date => utils.formatByString(date, format));
+        const now = adapter.date(undefined, timezone);
+        return [adapter.startOfDay(now), adapter.endOfDay(now)].map(date => adapter.formatByString(date, format));
       }
     default:
       {
@@ -64,15 +64,15 @@ const getLetterEditingOptions = (utils, timezone, sectionType, format) => {
 exports.getLetterEditingOptions = getLetterEditingOptions;
 const FORMAT_SECONDS_NO_LEADING_ZEROS = exports.FORMAT_SECONDS_NO_LEADING_ZEROS = 's';
 const NON_LOCALIZED_DIGITS = ['0', '1', '2', '3', '4', '5', '6', '7', '8', '9'];
-const getLocalizedDigits = utils => {
-  const today = utils.date(undefined);
-  const formattedZero = utils.formatByString(utils.setSeconds(today, 0), FORMAT_SECONDS_NO_LEADING_ZEROS);
+const getLocalizedDigits = adapter => {
+  const today = adapter.date(undefined);
+  const formattedZero = adapter.formatByString(adapter.setSeconds(today, 0), FORMAT_SECONDS_NO_LEADING_ZEROS);
   if (formattedZero === '0') {
     return NON_LOCALIZED_DIGITS;
   }
   return Array.from({
     length: 10
-  }).map((_, index) => utils.formatByString(utils.setSeconds(today, index), FORMAT_SECONDS_NO_LEADING_ZEROS));
+  }).map((_, index) => adapter.formatByString(adapter.setSeconds(today, index), FORMAT_SECONDS_NO_LEADING_ZEROS));
 };
 exports.getLocalizedDigits = getLocalizedDigits;
 const removeLocalizedDigits = (valueStr, localizedDigits) => {
@@ -116,7 +116,7 @@ const cleanLeadingZeros = (valueStr, size) => {
   return Number(valueStr).toString().padStart(size, '0');
 };
 exports.cleanLeadingZeros = cleanLeadingZeros;
-const cleanDigitSectionValue = (utils, value, sectionBoundaries, localizedDigits, section) => {
+const cleanDigitSectionValue = (adapter, value, sectionBoundaries, localizedDigits, section) => {
   if (process.env.NODE_ENV !== 'production') {
     if (section.type !== 'day' && section.contentType === 'digit-with-letter') {
       throw new Error([`MUI X: The token "${section.format}" is a digit format with letter in it.'
@@ -124,8 +124,8 @@ const cleanDigitSectionValue = (utils, value, sectionBoundaries, localizedDigits
     }
   }
   if (section.type === 'day' && section.contentType === 'digit-with-letter') {
-    const date = utils.setDate(sectionBoundaries.longestMonth, value);
-    return utils.formatByString(date, section.format);
+    const date = adapter.setDate(sectionBoundaries.longestMonth, value);
+    return adapter.formatByString(date, section.format);
   }
 
   // queryValue without leading `0` (`01` => `1`)
@@ -158,54 +158,54 @@ const getSectionVisibleValue = (section, target, localizedDigits) => {
   return value;
 };
 exports.getSectionVisibleValue = getSectionVisibleValue;
-const changeSectionValueFormat = (utils, valueStr, currentFormat, newFormat) => {
+const changeSectionValueFormat = (adapter, valueStr, currentFormat, newFormat) => {
   if (process.env.NODE_ENV !== 'production') {
-    if (getDateSectionConfigFromFormatToken(utils, currentFormat).type === 'weekDay') {
+    if (getDateSectionConfigFromFormatToken(adapter, currentFormat).type === 'weekDay') {
       throw new Error("changeSectionValueFormat doesn't support week day formats");
     }
   }
-  return utils.formatByString(utils.parse(valueStr, currentFormat), newFormat);
+  return adapter.formatByString(adapter.parse(valueStr, currentFormat), newFormat);
 };
 exports.changeSectionValueFormat = changeSectionValueFormat;
-const isFourDigitYearFormat = (utils, format) => utils.formatByString(utils.date(undefined, 'system'), format).length === 4;
-const doesSectionFormatHaveLeadingZeros = (utils, contentType, sectionType, format) => {
+const isFourDigitYearFormat = (adapter, format) => adapter.formatByString(adapter.date(undefined, 'system'), format).length === 4;
+const doesSectionFormatHaveLeadingZeros = (adapter, contentType, sectionType, format) => {
   if (contentType !== 'digit') {
     return false;
   }
-  const now = utils.date(undefined, 'default');
+  const now = adapter.date(undefined, 'default');
   switch (sectionType) {
-    // We can't use `changeSectionValueFormat`, because  `utils.parse('1', 'YYYY')` returns `1971` instead of `1`.
+    // We can't use `changeSectionValueFormat`, because  `adapter.parse('1', 'YYYY')` returns `1971` instead of `1`.
     case 'year':
       {
         // Remove once https://github.com/iamkun/dayjs/pull/2847 is merged and bump dayjs version
-        if (utils.lib === 'dayjs' && format === 'YY') {
+        if (adapter.lib === 'dayjs' && format === 'YY') {
           return true;
         }
-        return utils.formatByString(utils.setYear(now, 1), format).startsWith('0');
+        return adapter.formatByString(adapter.setYear(now, 1), format).startsWith('0');
       }
     case 'month':
       {
-        return utils.formatByString(utils.startOfYear(now), format).length > 1;
+        return adapter.formatByString(adapter.startOfYear(now), format).length > 1;
       }
     case 'day':
       {
-        return utils.formatByString(utils.startOfMonth(now), format).length > 1;
+        return adapter.formatByString(adapter.startOfMonth(now), format).length > 1;
       }
     case 'weekDay':
       {
-        return utils.formatByString(utils.startOfWeek(now), format).length > 1;
+        return adapter.formatByString(adapter.startOfWeek(now), format).length > 1;
       }
     case 'hours':
       {
-        return utils.formatByString(utils.setHours(now, 1), format).length > 1;
+        return adapter.formatByString(adapter.setHours(now, 1), format).length > 1;
       }
     case 'minutes':
       {
-        return utils.formatByString(utils.setMinutes(now, 1), format).length > 1;
+        return adapter.formatByString(adapter.setMinutes(now, 1), format).length > 1;
       }
     case 'seconds':
       {
-        return utils.formatByString(utils.setSeconds(now, 1), format).length > 1;
+        return adapter.formatByString(adapter.setSeconds(now, 1), format).length > 1;
       }
     default:
       {
@@ -219,7 +219,7 @@ const doesSectionFormatHaveLeadingZeros = (utils, contentType, sectionType, form
  * To make sure that the parsing works, we are building a format and a date without any separator.
  */
 exports.doesSectionFormatHaveLeadingZeros = doesSectionFormatHaveLeadingZeros;
-const getDateFromDateSections = (utils, sections, localizedDigits) => {
+const getDateFromDateSections = (adapter, sections, localizedDigits) => {
   // If we have both a day and a weekDay section,
   // Then we skip the weekDay in the parsing because libraries like dayjs can't parse complicated formats containing a weekDay.
   // dayjs(dayjs().format('dddd MMMM D YYYY'), 'dddd MMMM D YYYY')) // returns `Invalid Date` even if the format is valid.
@@ -236,7 +236,7 @@ const getDateFromDateSections = (utils, sections, localizedDigits) => {
   }
   const formatWithoutSeparator = sectionFormats.join(' ');
   const dateWithoutSeparatorStr = sectionValues.join(' ');
-  return utils.parse(dateWithoutSeparatorStr, formatWithoutSeparator);
+  return adapter.parse(dateWithoutSeparatorStr, formatWithoutSeparator);
 };
 exports.getDateFromDateSections = getDateFromDateSections;
 const createDateStrForV7HiddenInputFromSections = sections => sections.map(section => {
@@ -261,15 +261,15 @@ const createDateStrForV6InputFromSections = (sections, localizedDigits, isRtl) =
   return `\u2066${dateStr}\u2069`;
 };
 exports.createDateStrForV6InputFromSections = createDateStrForV6InputFromSections;
-const getSectionsBoundaries = (utils, localizedDigits, timezone) => {
-  const today = utils.date(undefined, timezone);
-  const endOfYear = utils.endOfYear(today);
-  const endOfDay = utils.endOfDay(today);
+const getSectionsBoundaries = (adapter, localizedDigits, timezone) => {
+  const today = adapter.date(undefined, timezone);
+  const endOfYear = adapter.endOfYear(today);
+  const endOfDay = adapter.endOfDay(today);
   const {
     maxDaysInMonth,
     longestMonth
-  } = (0, _dateUtils.getMonthsInYear)(utils, today).reduce((acc, month) => {
-    const daysInMonth = utils.getDaysInMonth(month);
+  } = (0, _dateUtils.getMonthsInYear)(adapter, today).reduce((acc, month) => {
+    const daysInMonth = adapter.getDaysInMonth(month);
     if (daysInMonth > acc.maxDaysInMonth) {
       return {
         maxDaysInMonth: daysInMonth,
@@ -286,18 +286,18 @@ const getSectionsBoundaries = (utils, localizedDigits, timezone) => {
       format
     }) => ({
       minimum: 0,
-      maximum: isFourDigitYearFormat(utils, format) ? 9999 : 99
+      maximum: isFourDigitYearFormat(adapter, format) ? 9999 : 99
     }),
     month: () => ({
       minimum: 1,
       // Assumption: All years have the same amount of months
-      maximum: utils.getMonth(endOfYear) + 1
+      maximum: adapter.getMonth(endOfYear) + 1
     }),
     day: ({
       currentDate
     }) => ({
       minimum: 1,
-      maximum: utils.isValid(currentDate) ? utils.getDaysInMonth(currentDate) : maxDaysInMonth,
+      maximum: adapter.isValid(currentDate) ? adapter.getDaysInMonth(currentDate) : maxDaysInMonth,
       longestMonth: longestMonth
     }),
     weekDay: ({
@@ -305,7 +305,7 @@ const getSectionsBoundaries = (utils, localizedDigits, timezone) => {
       contentType
     }) => {
       if (contentType === 'digit') {
-        const daysInWeek = getDaysInWeekStr(utils, format).map(Number);
+        const daysInWeek = getDaysInWeekStr(adapter, format).map(Number);
         return {
           minimum: Math.min(...daysInWeek),
           maximum: Math.max(...daysInWeek)
@@ -319,12 +319,12 @@ const getSectionsBoundaries = (utils, localizedDigits, timezone) => {
     hours: ({
       format
     }) => {
-      const lastHourInDay = utils.getHours(endOfDay);
-      const hasMeridiem = removeLocalizedDigits(utils.formatByString(utils.endOfDay(today), format), localizedDigits) !== lastHourInDay.toString();
+      const lastHourInDay = adapter.getHours(endOfDay);
+      const hasMeridiem = removeLocalizedDigits(adapter.formatByString(adapter.endOfDay(today), format), localizedDigits) !== lastHourInDay.toString();
       if (hasMeridiem) {
         return {
           minimum: 1,
-          maximum: Number(removeLocalizedDigits(utils.formatByString(utils.startOfDay(today), format), localizedDigits))
+          maximum: Number(removeLocalizedDigits(adapter.formatByString(adapter.startOfDay(today), format), localizedDigits))
         };
       }
       return {
@@ -335,12 +335,12 @@ const getSectionsBoundaries = (utils, localizedDigits, timezone) => {
     minutes: () => ({
       minimum: 0,
       // Assumption: All years have the same amount of minutes
-      maximum: utils.getMinutes(endOfDay)
+      maximum: adapter.getMinutes(endOfDay)
     }),
     seconds: () => ({
       minimum: 0,
       // Assumption: All years have the same amount of seconds
-      maximum: utils.getSeconds(endOfDay)
+      maximum: adapter.getSeconds(endOfDay)
     }),
     meridiem: () => ({
       minimum: 0,
@@ -373,55 +373,55 @@ const validateSections = (sections, valueType) => {
   }
 };
 exports.validateSections = validateSections;
-const transferDateSectionValue = (utils, section, dateToTransferFrom, dateToTransferTo) => {
+const transferDateSectionValue = (adapter, section, dateToTransferFrom, dateToTransferTo) => {
   switch (section.type) {
     case 'year':
       {
-        return utils.setYear(dateToTransferTo, utils.getYear(dateToTransferFrom));
+        return adapter.setYear(dateToTransferTo, adapter.getYear(dateToTransferFrom));
       }
     case 'month':
       {
-        return utils.setMonth(dateToTransferTo, utils.getMonth(dateToTransferFrom));
+        return adapter.setMonth(dateToTransferTo, adapter.getMonth(dateToTransferFrom));
       }
     case 'weekDay':
       {
-        let dayInWeekStrOfActiveDate = utils.formatByString(dateToTransferFrom, section.format);
+        let dayInWeekStrOfActiveDate = adapter.formatByString(dateToTransferFrom, section.format);
         if (section.hasLeadingZerosInInput) {
           dayInWeekStrOfActiveDate = cleanLeadingZeros(dayInWeekStrOfActiveDate, section.maxLength);
         }
-        const formattedDaysInWeek = getDaysInWeekStr(utils, section.format);
+        const formattedDaysInWeek = getDaysInWeekStr(adapter, section.format);
         const dayInWeekOfActiveDate = formattedDaysInWeek.indexOf(dayInWeekStrOfActiveDate);
         const dayInWeekOfNewSectionValue = formattedDaysInWeek.indexOf(section.value);
         const diff = dayInWeekOfNewSectionValue - dayInWeekOfActiveDate;
-        return utils.addDays(dateToTransferFrom, diff);
+        return adapter.addDays(dateToTransferFrom, diff);
       }
     case 'day':
       {
-        return utils.setDate(dateToTransferTo, utils.getDate(dateToTransferFrom));
+        return adapter.setDate(dateToTransferTo, adapter.getDate(dateToTransferFrom));
       }
     case 'meridiem':
       {
-        const isAM = utils.getHours(dateToTransferFrom) < 12;
-        const mergedDateHours = utils.getHours(dateToTransferTo);
+        const isAM = adapter.getHours(dateToTransferFrom) < 12;
+        const mergedDateHours = adapter.getHours(dateToTransferTo);
         if (isAM && mergedDateHours >= 12) {
-          return utils.addHours(dateToTransferTo, -12);
+          return adapter.addHours(dateToTransferTo, -12);
         }
         if (!isAM && mergedDateHours < 12) {
-          return utils.addHours(dateToTransferTo, 12);
+          return adapter.addHours(dateToTransferTo, 12);
         }
         return dateToTransferTo;
       }
     case 'hours':
       {
-        return utils.setHours(dateToTransferTo, utils.getHours(dateToTransferFrom));
+        return adapter.setHours(dateToTransferTo, adapter.getHours(dateToTransferFrom));
       }
     case 'minutes':
       {
-        return utils.setMinutes(dateToTransferTo, utils.getMinutes(dateToTransferFrom));
+        return adapter.setMinutes(dateToTransferTo, adapter.getMinutes(dateToTransferFrom));
       }
     case 'seconds':
       {
-        return utils.setSeconds(dateToTransferTo, utils.getSeconds(dateToTransferFrom));
+        return adapter.setSeconds(dateToTransferTo, adapter.getSeconds(dateToTransferFrom));
       }
     default:
       {
@@ -440,11 +440,11 @@ const reliableSectionModificationOrder = {
   meridiem: 8,
   empty: 9
 };
-const mergeDateIntoReferenceDate = (utils, dateToTransferFrom, sections, referenceDate, shouldLimitToEditedSections) =>
+const mergeDateIntoReferenceDate = (adapter, dateToTransferFrom, sections, referenceDate, shouldLimitToEditedSections) =>
 // cloning sections before sort to avoid mutating it
 [...sections].sort((a, b) => reliableSectionModificationOrder[a.type] - reliableSectionModificationOrder[b.type]).reduce((mergedDate, section) => {
   if (!shouldLimitToEditedSections || section.modified) {
-    return transferDateSectionValue(utils, section, dateToTransferFrom, mergedDate);
+    return transferDateSectionValue(adapter, section, dateToTransferFrom, mergedDate);
   }
   return mergedDate;
 }, referenceDate);

package/internals/hooks/useField/useFieldCharacterEditing.js

@@ -7,8 +7,8 @@ Object.defineProperty(exports, "__esModule", {
 exports.useFieldCharacterEditing = void 0;
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
 var _useEventCallback = _interopRequireDefault(require("@mui/utils/useEventCallback"));
-var _useUtils = require("../useUtils");
 var _useField = require("./useField.utils");
+var _usePickerAdapter = require("../../../hooks/usePickerAdapter");
 const isQueryResponseWithoutValue = response => response.saveQuery != null;
 
 /**
@@ -31,7 +31,7 @@ const useFieldCharacterEditing = ({
     updateSectionValue
   }
 }) => {
-  const utils = (0, _useUtils.useUtils)();
+  const adapter = (0, _usePickerAdapter.usePickerAdapter)();
   const applyQuery = ({
     keyPressed,
     sectionIndex
@@ -82,7 +82,7 @@ const useFieldCharacterEditing = ({
       };
     };
     const testQueryOnFormatAndFallbackFormat = (queryValue, activeSection, fallbackFormat, formatFallbackValue) => {
-      const getOptions = format => (0, _useField.getLetterEditingOptions)(utils, timezone, activeSection.type, format);
+      const getOptions = format => (0, _useField.getLetterEditingOptions)(adapter, timezone, activeSection.type, format);
       if (activeSection.contentType === 'letter') {
         return findMatchingOptions(activeSection.format, getOptions(activeSection.format), queryValue);
       }
@@ -90,7 +90,7 @@ const useFieldCharacterEditing = ({
       // When editing a digit-format month / weekDay and the user presses a letter,
       // We can support the letter editing by using the letter-format month / weekDay and re-formatting the result.
       // We just have to make sure that the default month / weekDay format is a letter format,
-      if (fallbackFormat && formatFallbackValue != null && (0, _useField.getDateSectionConfigFromFormatToken)(utils, fallbackFormat).contentType === 'letter') {
+      if (fallbackFormat && formatFallbackValue != null && (0, _useField.getDateSectionConfigFromFormatToken)(adapter, fallbackFormat).contentType === 'letter') {
         const fallbackOptions = getOptions(fallbackFormat);
         const response = findMatchingOptions(fallbackFormat, fallbackOptions, queryValue);
         if (isQueryResponseWithoutValue(response)) {
@@ -110,13 +110,13 @@ const useFieldCharacterEditing = ({
       switch (activeSection.type) {
         case 'month':
           {
-            const formatFallbackValue = fallbackValue => (0, _useField.changeSectionValueFormat)(utils, fallbackValue, utils.formats.month, activeSection.format);
-            return testQueryOnFormatAndFallbackFormat(queryValue, activeSection, utils.formats.month, formatFallbackValue);
+            const formatFallbackValue = fallbackValue => (0, _useField.changeSectionValueFormat)(adapter, fallbackValue, adapter.formats.month, activeSection.format);
+            return testQueryOnFormatAndFallbackFormat(queryValue, activeSection, adapter.formats.month, formatFallbackValue);
           }
         case 'weekDay':
           {
             const formatFallbackValue = (fallbackValue, fallbackOptions) => fallbackOptions.indexOf(fallbackValue).toString();
-            return testQueryOnFormatAndFallbackFormat(queryValue, activeSection, utils.formats.weekday, formatFallbackValue);
+            return testQueryOnFormatAndFallbackFormat(queryValue, activeSection, adapter.formats.weekday, formatFallbackValue);
           }
         case 'meridiem':
           {
@@ -160,7 +160,7 @@ const useFieldCharacterEditing = ({
         };
       }
       const shouldGoToNextSection = queryValueNumber * 10 > sectionBoundaries.maximum || cleanQueryValue.length === sectionBoundaries.maximum.toString().length;
-      const newSectionValue = (0, _useField.cleanDigitSectionValue)(utils, queryValueNumber, sectionBoundaries, localizedDigits, section);
+      const newSectionValue = (0, _useField.cleanDigitSectionValue)(adapter, queryValueNumber, sectionBoundaries, localizedDigits, section);
       return {
         sectionValue: newSectionValue,
         shouldGoToNextSection
@@ -178,7 +178,7 @@ const useFieldCharacterEditing = ({
       // When editing a letter-format month and the user presses a digit,
       // We can support the numeric editing by using the digit-format month and re-formatting the result.
       if (activeSection.type === 'month') {
-        const hasLeadingZerosInFormat = (0, _useField.doesSectionFormatHaveLeadingZeros)(utils, 'digit', 'month', 'MM');
+        const hasLeadingZerosInFormat = (0, _useField.doesSectionFormatHaveLeadingZeros)(adapter, 'digit', 'month', 'MM');
         const response = getNewSectionValue({
           queryValue,
           skipIfBelowMinimum: true,
@@ -194,7 +194,7 @@ const useFieldCharacterEditing = ({
         if (isQueryResponseWithoutValue(response)) {
           return response;
         }
-        const formattedValue = (0, _useField.changeSectionValueFormat)(utils, response.sectionValue, 'MM', activeSection.format);
+        const formattedValue = (0, _useField.changeSectionValueFormat)(adapter, response.sectionValue, 'MM', activeSection.format);
         return (0, _extends2.default)({}, response, {
           sectionValue: formattedValue
         });
@@ -211,7 +211,7 @@ const useFieldCharacterEditing = ({
         if (isQueryResponseWithoutValue(response)) {
           return response;
         }
-        const formattedValue = (0, _useField.getDaysInWeekStr)(utils, activeSection.format)[Number(response.sectionValue) - 1];
+        const formattedValue = (0, _useField.getDaysInWeekStr)(adapter, activeSection.format)[Number(response.sectionValue) - 1];
         return (0, _extends2.default)({}, response, {
           sectionValue: formattedValue
         });

package/internals/hooks/useField/useFieldRootHandleKeyDown.js

@@ -6,13 +6,13 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.useFieldRootHandleKeyDown = useFieldRootHandleKeyDown;
 var _useEventCallback = _interopRequireDefault(require("@mui/utils/useEventCallback"));
-var _useUtils = require("../useUtils");
 var _useField = require("./useField.utils");
+var _usePickerAdapter = require("../../../hooks/usePickerAdapter");
 /**
  * Returns the `onKeyDown` handler to pass to the root element of the field.
  */
 function useFieldRootHandleKeyDown(parameters) {
-  const utils = (0, _useUtils.useUtils)();
+  const adapter = (0, _usePickerAdapter.usePickerAdapter)();
   const {
     manager: {
       internal_fieldValueManager: fieldValueManager
@@ -118,7 +118,7 @@ function useFieldRootHandleKeyDown(parameters) {
             setSelectedSections(activeSectionIndex);
           }
           const activeSection = state.sections[activeSectionIndex];
-          const newSectionValue = adjustSectionValue(utils, timezone, activeSection, event.key, sectionsValueBoundaries, localizedDigits, fieldValueManager.getDateFromSection(value, activeSection), {
+          const newSectionValue = adjustSectionValue(adapter, timezone, activeSection, event.key, sectionsValueBoundaries, localizedDigits, fieldValueManager.getDateFromSection(value, activeSection), {
             minutesStep
           });
           updateSectionValue({
@@ -145,7 +145,7 @@ function getDeltaFromKeyCode(keyCode) {
       return 0;
   }
 }
-function adjustSectionValue(utils, timezone, section, keyCode, sectionsValueBoundaries, localizedDigits, activeDate, stepsAttributes) {
+function adjustSectionValue(adapter, timezone, section, keyCode, sectionsValueBoundaries, localizedDigits, activeDate, stepsAttributes) {
   const delta = getDeltaFromKeyCode(keyCode);
   const isStart = keyCode === 'Home';
   const isEnd = keyCode === 'End';
@@ -156,12 +156,12 @@ function adjustSectionValue(utils, timezone, section, keyCode, sectionsValueBoun
       format: section.format,
       contentType: section.contentType
     });
-    const getCleanValue = value => (0, _useField.cleanDigitSectionValue)(utils, value, sectionBoundaries, localizedDigits, section);
+    const getCleanValue = value => (0, _useField.cleanDigitSectionValue)(adapter, value, sectionBoundaries, localizedDigits, section);
     const step = section.type === 'minutes' && stepsAttributes?.minutesStep ? stepsAttributes.minutesStep : 1;
     let newSectionValueNumber;
     if (shouldSetAbsolute) {
       if (section.type === 'year' && !isEnd && !isStart) {
-        return utils.formatByString(utils.date(undefined, timezone), section.format);
+        return adapter.formatByString(adapter.date(undefined, timezone), section.format);
       }
       if (delta > 0 || isStart) {
         newSectionValueNumber = sectionBoundaries.minimum;
@@ -189,7 +189,7 @@ function adjustSectionValue(utils, timezone, section, keyCode, sectionsValueBoun
     return getCleanValue(newSectionValueNumber);
   };
   const adjustLetterSection = () => {
-    const options = (0, _useField.getLetterEditingOptions)(utils, timezone, section.type, section.format);
+    const options = (0, _useField.getLetterEditingOptions)(adapter, timezone, section.type, section.format);
     if (options.length === 0) {
       return section.value;
     }

package/internals/hooks/useField/useFieldSectionContentProps.js

@@ -9,7 +9,6 @@ exports.useFieldSectionContentProps = useFieldSectionContentProps;
 var React = _interopRequireWildcard(require("react"));
 var _useEventCallback = _interopRequireDefault(require("@mui/utils/useEventCallback"));
 var _useId = _interopRequireDefault(require("@mui/utils/useId"));
-var _useUtils = require("../useUtils");
 var _hooks = require("../../../hooks");
 var _syncSelectionToDOM = require("./syncSelectionToDOM");
 /**
@@ -20,7 +19,7 @@ var _syncSelectionToDOM = require("./syncSelectionToDOM");
  * @returns {UseFieldRootPropsReturnValue} The props to forward to the content element of each section of the field.
  */
 function useFieldSectionContentProps(parameters) {
-  const utils = (0, _useUtils.useUtils)();
+  const adapter = (0, _hooks.usePickerAdapter)();
   const translations = (0, _hooks.usePickerTranslations)();
   const id = (0, _useId.default)();
   const {
@@ -158,10 +157,10 @@ function useFieldSectionContentProps(parameters) {
       // Aria attributes
       'aria-labelledby': `${id}-${section.type}`,
       'aria-readonly': readOnly,
-      'aria-valuenow': getSectionValueNow(section, utils),
+      'aria-valuenow': getSectionValueNow(section, adapter),
       'aria-valuemin': sectionBoundaries.minimum,
       'aria-valuemax': sectionBoundaries.maximum,
-      'aria-valuetext': section.value ? getSectionValueText(section, utils) : translations.empty,
+      'aria-valuetext': section.value ? getSectionValueText(section, adapter) : translations.empty,
       'aria-label': translations[section.type],
       'aria-disabled': disabled,
       // Other
@@ -176,9 +175,9 @@ function useFieldSectionContentProps(parameters) {
       children: section.value || section.placeholder,
       inputMode: section.contentType === 'letter' ? 'text' : 'numeric'
     };
-  }, [sectionsValueBoundaries, id, isContainerEditable, disabled, readOnly, isEditable, translations, utils, handleInput, handlePaste, handleMouseUp, handleDragOver, createFocusHandler, fieldValueManager, value]);
+  }, [sectionsValueBoundaries, id, isContainerEditable, disabled, readOnly, isEditable, translations, adapter, handleInput, handlePaste, handleMouseUp, handleDragOver, createFocusHandler, fieldValueManager, value]);
 }
-function getSectionValueText(section, utils) {
+function getSectionValueText(section, adapter) {
   if (!section.value) {
     return undefined;
   }
@@ -186,13 +185,13 @@ function getSectionValueText(section, utils) {
     case 'month':
       {
         if (section.contentType === 'digit') {
-          return utils.format(utils.setMonth(utils.date(), Number(section.value) - 1), 'month');
+          return adapter.format(adapter.setMonth(adapter.date(), Number(section.value) - 1), 'month');
         }
-        const parsedDate = utils.parse(section.value, section.format);
-        return parsedDate ? utils.format(parsedDate, 'month') : undefined;
+        const parsedDate = adapter.parse(section.value, section.format);
+        return parsedDate ? adapter.format(parsedDate, 'month') : undefined;
       }
     case 'day':
-      return section.contentType === 'digit' ? utils.format(utils.setDate(utils.startOfYear(utils.date()), Number(section.value)), 'dayOfMonthFull') : section.value;
+      return section.contentType === 'digit' ? adapter.format(adapter.setDate(adapter.startOfYear(adapter.date()), Number(section.value)), 'dayOfMonthFull') : section.value;
     case 'weekDay':
       // TODO: improve by providing the label of the week day
       return undefined;
@@ -200,7 +199,7 @@ function getSectionValueText(section, utils) {
       return undefined;
   }
 }
-function getSectionValueNow(section, utils) {
+function getSectionValueNow(section, adapter) {
   if (!section.value) {
     return undefined;
   }
@@ -215,9 +214,9 @@ function getSectionValueNow(section, utils) {
       }
     case 'meridiem':
       {
-        const parsedDate = utils.parse(`01:00 ${section.value}`, `${utils.formats.hours12h}:${utils.formats.minutes} ${section.format}`);
+        const parsedDate = adapter.parse(`01:00 ${section.value}`, `${adapter.formats.hours12h}:${adapter.formats.minutes} ${section.format}`);
         if (parsedDate) {
-          return utils.getHours(parsedDate) >= 12 ? 1 : 0;
+          return adapter.getHours(parsedDate) >= 12 ? 1 : 0;
         }
         return undefined;
       }
@@ -228,8 +227,8 @@ function getSectionValueNow(section, utils) {
         if (section.contentType === 'digit') {
           return Number(section.value);
         }
-        const parsedDate = utils.parse(section.value, section.format);
-        return parsedDate ? utils.getMonth(parsedDate) + 1 : undefined;
+        const parsedDate = adapter.parse(section.value, section.format);
+        return parsedDate ? adapter.getMonth(parsedDate) + 1 : undefined;
       }
     default:
       return section.contentType !== 'letter' ? Number(section.value) : undefined;