@mui/x-date-pickers 8.0.0-alpha.9 → 8.0.0-beta.0

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

@@ -0,0 +1,638 @@
+import { getMonthsInYear } from "../../utils/date-utils.js";
+export const getDateSectionConfigFromFormatToken = (utils, formatToken) => {
+  const config = utils.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'));
+  }
+  if (typeof config === 'string') {
+    return {
+      type: config,
+      contentType: config === 'meridiem' ? 'letter' : 'digit',
+      maxLength: undefined
+    };
+  }
+  return {
+    type: config.sectionType,
+    contentType: config.contentType,
+    maxLength: config.maxLength
+  };
+};
+const getDeltaFromKeyCode = keyCode => {
+  switch (keyCode) {
+    case 'ArrowUp':
+      return 1;
+    case 'ArrowDown':
+      return -1;
+    case 'PageUp':
+      return 5;
+    case 'PageDown':
+      return -5;
+    default:
+      return 0;
+  }
+};
+export const getDaysInWeekStr = (utils, format) => {
+  const elements = [];
+  const now = utils.date(undefined, 'default');
+  const startDate = utils.startOfWeek(now);
+  const endDate = utils.endOfWeek(now);
+  let current = startDate;
+  while (utils.isBefore(current, endDate)) {
+    elements.push(current);
+    current = utils.addDays(current, 1);
+  }
+  return elements.map(weekDay => utils.formatByString(weekDay, format));
+};
+export const getLetterEditingOptions = (utils, timezone, sectionType, format) => {
+  switch (sectionType) {
+    case 'month':
+      {
+        return getMonthsInYear(utils, utils.date(undefined, timezone)).map(month => utils.formatByString(month, format));
+      }
+    case 'weekDay':
+      {
+        return getDaysInWeekStr(utils, format);
+      }
+    case 'meridiem':
+      {
+        const now = utils.date(undefined, timezone);
+        return [utils.startOfDay(now), utils.endOfDay(now)].map(date => utils.formatByString(date, format));
+      }
+    default:
+      {
+        return [];
+      }
+  }
+};
+
+// This format should be the same on all the adapters
+// If some adapter does not respect this convention, then we will need to hardcode the format on each adapter.
+export const FORMAT_SECONDS_NO_LEADING_ZEROS = 's';
+const NON_LOCALIZED_DIGITS = ['0', '1', '2', '3', '4', '5', '6', '7', '8', '9'];
+export const getLocalizedDigits = utils => {
+  const today = utils.date(undefined);
+  const formattedZero = utils.formatByString(utils.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));
+};
+export const removeLocalizedDigits = (valueStr, localizedDigits) => {
+  if (localizedDigits[0] === '0') {
+    return valueStr;
+  }
+  const digits = [];
+  let currentFormattedDigit = '';
+  for (let i = 0; i < valueStr.length; i += 1) {
+    currentFormattedDigit += valueStr[i];
+    const matchingDigitIndex = localizedDigits.indexOf(currentFormattedDigit);
+    if (matchingDigitIndex > -1) {
+      digits.push(matchingDigitIndex.toString());
+      currentFormattedDigit = '';
+    }
+  }
+  return digits.join('');
+};
+export const applyLocalizedDigits = (valueStr, localizedDigits) => {
+  if (localizedDigits[0] === '0') {
+    return valueStr;
+  }
+  return valueStr.split('').map(char => localizedDigits[Number(char)]).join('');
+};
+export const isStringNumber = (valueStr, localizedDigits) => {
+  const nonLocalizedValueStr = removeLocalizedDigits(valueStr, localizedDigits);
+  // `Number(' ')` returns `0` even if ' ' is not a valid number.
+  return nonLocalizedValueStr !== ' ' && !Number.isNaN(Number(nonLocalizedValueStr));
+};
+
+/**
+ * Remove the leading zeroes to a digit section value.
+ * E.g.: `03` => `3`
+ * Warning: Should only be called with non-localized digits. Call `removeLocalizedDigits` with your value if needed.
+ */
+export const cleanLeadingZeros = (valueStr, size) => {
+  let cleanValueStr = valueStr;
+
+  // Remove the leading zeros
+  cleanValueStr = Number(cleanValueStr).toString();
+
+  // Add enough leading zeros to fill the section
+  while (cleanValueStr.length < size) {
+    cleanValueStr = `0${cleanValueStr}`;
+  }
+  return cleanValueStr;
+};
+export const cleanDigitSectionValue = (utils, 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.'
+             This type of format is only supported for 'day' sections`].join('\n'));
+    }
+  }
+  if (section.type === 'day' && section.contentType === 'digit-with-letter') {
+    const date = utils.setDate(sectionBoundaries.longestMonth, value);
+    return utils.formatByString(date, section.format);
+  }
+
+  // queryValue without leading `0` (`01` => `1`)
+  let valueStr = value.toString();
+  if (section.hasLeadingZerosInInput) {
+    valueStr = cleanLeadingZeros(valueStr, section.maxLength);
+  }
+  return applyLocalizedDigits(valueStr, localizedDigits);
+};
+export const adjustSectionValue = (utils, timezone, section, keyCode, sectionsValueBoundaries, localizedDigits, activeDate, stepsAttributes) => {
+  const delta = getDeltaFromKeyCode(keyCode);
+  const isStart = keyCode === 'Home';
+  const isEnd = keyCode === 'End';
+  const shouldSetAbsolute = section.value === '' || isStart || isEnd;
+  const adjustDigitSection = () => {
+    const sectionBoundaries = sectionsValueBoundaries[section.type]({
+      currentDate: activeDate,
+      format: section.format,
+      contentType: section.contentType
+    });
+    const getCleanValue = value => cleanDigitSectionValue(utils, value, sectionBoundaries, localizedDigits, section);
+    const step = section.type === 'minutes' && stepsAttributes?.minutesStep ? stepsAttributes.minutesStep : 1;
+    const currentSectionValue = parseInt(removeLocalizedDigits(section.value, localizedDigits), 10);
+    let newSectionValueNumber = currentSectionValue + delta * step;
+    if (shouldSetAbsolute) {
+      if (section.type === 'year' && !isEnd && !isStart) {
+        return utils.formatByString(utils.date(undefined, timezone), section.format);
+      }
+      if (delta > 0 || isStart) {
+        newSectionValueNumber = sectionBoundaries.minimum;
+      } else {
+        newSectionValueNumber = sectionBoundaries.maximum;
+      }
+    }
+    if (newSectionValueNumber % step !== 0) {
+      if (delta < 0 || isStart) {
+        newSectionValueNumber += step - (step + newSectionValueNumber) % step; // for JS -3 % 5 = -3 (should be 2)
+      }
+      if (delta > 0 || isEnd) {
+        newSectionValueNumber -= newSectionValueNumber % step;
+      }
+    }
+    if (newSectionValueNumber > sectionBoundaries.maximum) {
+      return getCleanValue(sectionBoundaries.minimum + (newSectionValueNumber - sectionBoundaries.maximum - 1) % (sectionBoundaries.maximum - sectionBoundaries.minimum + 1));
+    }
+    if (newSectionValueNumber < sectionBoundaries.minimum) {
+      return getCleanValue(sectionBoundaries.maximum - (sectionBoundaries.minimum - newSectionValueNumber - 1) % (sectionBoundaries.maximum - sectionBoundaries.minimum + 1));
+    }
+    return getCleanValue(newSectionValueNumber);
+  };
+  const adjustLetterSection = () => {
+    const options = getLetterEditingOptions(utils, timezone, section.type, section.format);
+    if (options.length === 0) {
+      return section.value;
+    }
+    if (shouldSetAbsolute) {
+      if (delta > 0 || isStart) {
+        return options[0];
+      }
+      return options[options.length - 1];
+    }
+    const currentOptionIndex = options.indexOf(section.value);
+    const newOptionIndex = (currentOptionIndex + delta) % options.length;
+    const clampedIndex = (newOptionIndex + options.length) % options.length;
+    return options[clampedIndex];
+  };
+  if (section.contentType === 'digit' || section.contentType === 'digit-with-letter') {
+    return adjustDigitSection();
+  }
+  return adjustLetterSection();
+};
+export const getSectionVisibleValue = (section, target, localizedDigits) => {
+  let value = section.value || section.placeholder;
+  const hasLeadingZeros = target === 'non-input' ? section.hasLeadingZerosInFormat : section.hasLeadingZerosInInput;
+  if (target === 'non-input' && section.hasLeadingZerosInInput && !section.hasLeadingZerosInFormat) {
+    value = Number(removeLocalizedDigits(value, localizedDigits)).toString();
+  }
+
+  // In the input, we add an empty character at the end of each section without leading zeros.
+  // This makes sure that `onChange` will always be fired.
+  // Otherwise, when your input value equals `1/dd/yyyy` (format `M/DD/YYYY` on DayJs),
+  // If you press `1`, on the first section, the new value is also `1/dd/yyyy`,
+  // So the browser will not fire the input `onChange`.
+  const shouldAddInvisibleSpace = ['input-rtl', 'input-ltr'].includes(target) && section.contentType === 'digit' && !hasLeadingZeros && value.length === 1;
+  if (shouldAddInvisibleSpace) {
+    value = `${value}\u200e`;
+  }
+  if (target === 'input-rtl') {
+    value = `\u2068${value}\u2069`;
+  }
+  return value;
+};
+export const changeSectionValueFormat = (utils, valueStr, currentFormat, newFormat) => {
+  if (process.env.NODE_ENV !== 'production') {
+    if (getDateSectionConfigFromFormatToken(utils, currentFormat).type === 'weekDay') {
+      throw new Error("changeSectionValueFormat doesn't support week day formats");
+    }
+  }
+  return utils.formatByString(utils.parse(valueStr, currentFormat), newFormat);
+};
+const isFourDigitYearFormat = (utils, format) => utils.formatByString(utils.date(undefined, 'system'), format).length === 4;
+export const doesSectionFormatHaveLeadingZeros = (utils, contentType, sectionType, format) => {
+  if (contentType !== 'digit') {
+    return false;
+  }
+  const now = utils.date(undefined, 'default');
+  switch (sectionType) {
+    // We can't use `changeSectionValueFormat`, because  `utils.parse('1', 'YYYY')` returns `1971` instead of `1`.
+    case 'year':
+      {
+        if (isFourDigitYearFormat(utils, format)) {
+          const formatted0001 = utils.formatByString(utils.setYear(now, 1), format);
+          return formatted0001 === '0001';
+        }
+        const formatted2001 = utils.formatByString(utils.setYear(now, 2001), format);
+        return formatted2001 === '01';
+      }
+    case 'month':
+      {
+        return utils.formatByString(utils.startOfYear(now), format).length > 1;
+      }
+    case 'day':
+      {
+        return utils.formatByString(utils.startOfMonth(now), format).length > 1;
+      }
+    case 'weekDay':
+      {
+        return utils.formatByString(utils.startOfWeek(now), format).length > 1;
+      }
+    case 'hours':
+      {
+        return utils.formatByString(utils.setHours(now, 1), format).length > 1;
+      }
+    case 'minutes':
+      {
+        return utils.formatByString(utils.setMinutes(now, 1), format).length > 1;
+      }
+    case 'seconds':
+      {
+        return utils.formatByString(utils.setSeconds(now, 1), format).length > 1;
+      }
+    default:
+      {
+        throw new Error('Invalid section type');
+      }
+  }
+};
+
+/**
+ * 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 const getDateFromDateSections = (utils, 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.
+  const shouldSkipWeekDays = sections.some(section => section.type === 'day');
+  const sectionFormats = [];
+  const sectionValues = [];
+  for (let i = 0; i < sections.length; i += 1) {
+    const section = sections[i];
+    const shouldSkip = shouldSkipWeekDays && section.type === 'weekDay';
+    if (!shouldSkip) {
+      sectionFormats.push(section.format);
+      sectionValues.push(getSectionVisibleValue(section, 'non-input', localizedDigits));
+    }
+  }
+  const formatWithoutSeparator = sectionFormats.join(' ');
+  const dateWithoutSeparatorStr = sectionValues.join(' ');
+  return utils.parse(dateWithoutSeparatorStr, formatWithoutSeparator);
+};
+export const createDateStrForV7HiddenInputFromSections = sections => sections.map(section => {
+  return `${section.startSeparator}${section.value || section.placeholder}${section.endSeparator}`;
+}).join('');
+export const createDateStrForV6InputFromSections = (sections, localizedDigits, isRtl) => {
+  const formattedSections = sections.map(section => {
+    const dateValue = getSectionVisibleValue(section, isRtl ? 'input-rtl' : 'input-ltr', localizedDigits);
+    return `${section.startSeparator}${dateValue}${section.endSeparator}`;
+  });
+  const dateStr = formattedSections.join('');
+  if (!isRtl) {
+    return dateStr;
+  }
+
+  // \u2066: start left-to-right isolation
+  // \u2067: start right-to-left isolation
+  // \u2068: start first strong character isolation
+  // \u2069: pop isolation
+  // wrap into an isolated group such that separators can split the string in smaller ones by adding \u2069\u2068
+  return `\u2066${dateStr}\u2069`;
+};
+export const getSectionsBoundaries = (utils, localizedDigits, timezone) => {
+  const today = utils.date(undefined, timezone);
+  const endOfYear = utils.endOfYear(today);
+  const endOfDay = utils.endOfDay(today);
+  const {
+    maxDaysInMonth,
+    longestMonth
+  } = getMonthsInYear(utils, today).reduce((acc, month) => {
+    const daysInMonth = utils.getDaysInMonth(month);
+    if (daysInMonth > acc.maxDaysInMonth) {
+      return {
+        maxDaysInMonth: daysInMonth,
+        longestMonth: month
+      };
+    }
+    return acc;
+  }, {
+    maxDaysInMonth: 0,
+    longestMonth: null
+  });
+  return {
+    year: ({
+      format
+    }) => ({
+      minimum: 0,
+      maximum: isFourDigitYearFormat(utils, format) ? 9999 : 99
+    }),
+    month: () => ({
+      minimum: 1,
+      // Assumption: All years have the same amount of months
+      maximum: utils.getMonth(endOfYear) + 1
+    }),
+    day: ({
+      currentDate
+    }) => ({
+      minimum: 1,
+      maximum: utils.isValid(currentDate) ? utils.getDaysInMonth(currentDate) : maxDaysInMonth,
+      longestMonth: longestMonth
+    }),
+    weekDay: ({
+      format,
+      contentType
+    }) => {
+      if (contentType === 'digit') {
+        const daysInWeek = getDaysInWeekStr(utils, format).map(Number);
+        return {
+          minimum: Math.min(...daysInWeek),
+          maximum: Math.max(...daysInWeek)
+        };
+      }
+      return {
+        minimum: 1,
+        maximum: 7
+      };
+    },
+    hours: ({
+      format
+    }) => {
+      const lastHourInDay = utils.getHours(endOfDay);
+      const hasMeridiem = removeLocalizedDigits(utils.formatByString(utils.endOfDay(today), format), localizedDigits) !== lastHourInDay.toString();
+      if (hasMeridiem) {
+        return {
+          minimum: 1,
+          maximum: Number(removeLocalizedDigits(utils.formatByString(utils.startOfDay(today), format), localizedDigits))
+        };
+      }
+      return {
+        minimum: 0,
+        maximum: lastHourInDay
+      };
+    },
+    minutes: () => ({
+      minimum: 0,
+      // Assumption: All years have the same amount of minutes
+      maximum: utils.getMinutes(endOfDay)
+    }),
+    seconds: () => ({
+      minimum: 0,
+      // Assumption: All years have the same amount of seconds
+      maximum: utils.getSeconds(endOfDay)
+    }),
+    meridiem: () => ({
+      minimum: 0,
+      maximum: 1
+    }),
+    empty: () => ({
+      minimum: 0,
+      maximum: 0
+    })
+  };
+};
+let warnedOnceInvalidSection = false;
+export const validateSections = (sections, valueType) => {
+  if (process.env.NODE_ENV !== 'production') {
+    if (!warnedOnceInvalidSection) {
+      const supportedSections = ['empty'];
+      if (['date', 'date-time'].includes(valueType)) {
+        supportedSections.push('weekDay', 'day', 'month', 'year');
+      }
+      if (['time', 'date-time'].includes(valueType)) {
+        supportedSections.push('hours', 'minutes', 'seconds', 'meridiem');
+      }
+      const invalidSection = sections.find(section => !supportedSections.includes(section.type));
+      if (invalidSection) {
+        console.warn(`MUI X: The field component you are using is not compatible with the "${invalidSection.type}" date section.`, `The supported date sections are ["${supportedSections.join('", "')}"]\`.`);
+        warnedOnceInvalidSection = true;
+      }
+    }
+  }
+};
+const transferDateSectionValue = (utils, section, dateToTransferFrom, dateToTransferTo) => {
+  switch (section.type) {
+    case 'year':
+      {
+        return utils.setYear(dateToTransferTo, utils.getYear(dateToTransferFrom));
+      }
+    case 'month':
+      {
+        return utils.setMonth(dateToTransferTo, utils.getMonth(dateToTransferFrom));
+      }
+    case 'weekDay':
+      {
+        let dayInWeekStrOfActiveDate = utils.formatByString(dateToTransferFrom, section.format);
+        if (section.hasLeadingZerosInInput) {
+          dayInWeekStrOfActiveDate = cleanLeadingZeros(dayInWeekStrOfActiveDate, section.maxLength);
+        }
+        const formattedDaysInWeek = getDaysInWeekStr(utils, section.format);
+        const dayInWeekOfActiveDate = formattedDaysInWeek.indexOf(dayInWeekStrOfActiveDate);
+        const dayInWeekOfNewSectionValue = formattedDaysInWeek.indexOf(section.value);
+        const diff = dayInWeekOfNewSectionValue - dayInWeekOfActiveDate;
+        return utils.addDays(dateToTransferFrom, diff);
+      }
+    case 'day':
+      {
+        return utils.setDate(dateToTransferTo, utils.getDate(dateToTransferFrom));
+      }
+    case 'meridiem':
+      {
+        const isAM = utils.getHours(dateToTransferFrom) < 12;
+        const mergedDateHours = utils.getHours(dateToTransferTo);
+        if (isAM && mergedDateHours >= 12) {
+          return utils.addHours(dateToTransferTo, -12);
+        }
+        if (!isAM && mergedDateHours < 12) {
+          return utils.addHours(dateToTransferTo, 12);
+        }
+        return dateToTransferTo;
+      }
+    case 'hours':
+      {
+        return utils.setHours(dateToTransferTo, utils.getHours(dateToTransferFrom));
+      }
+    case 'minutes':
+      {
+        return utils.setMinutes(dateToTransferTo, utils.getMinutes(dateToTransferFrom));
+      }
+    case 'seconds':
+      {
+        return utils.setSeconds(dateToTransferTo, utils.getSeconds(dateToTransferFrom));
+      }
+    default:
+      {
+        return dateToTransferTo;
+      }
+  }
+};
+const reliableSectionModificationOrder = {
+  year: 1,
+  month: 2,
+  day: 3,
+  weekDay: 4,
+  hours: 5,
+  minutes: 6,
+  seconds: 7,
+  meridiem: 8,
+  empty: 9
+};
+export const mergeDateIntoReferenceDate = (utils, 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 mergedDate;
+}, referenceDate);
+export const isAndroid = () => navigator.userAgent.toLowerCase().includes('android');
+
+// TODO v9: Remove
+export const getSectionOrder = (sections, shouldApplyRTL) => {
+  const neighbors = {};
+  if (!shouldApplyRTL) {
+    sections.forEach((_, index) => {
+      const leftIndex = index === 0 ? null : index - 1;
+      const rightIndex = index === sections.length - 1 ? null : index + 1;
+      neighbors[index] = {
+        leftIndex,
+        rightIndex
+      };
+    });
+    return {
+      neighbors,
+      startIndex: 0,
+      endIndex: sections.length - 1
+    };
+  }
+  const rtl2ltr = {};
+  const ltr2rtl = {};
+  let groupedSectionsStart = 0;
+  let groupedSectionsEnd = 0;
+  let RTLIndex = sections.length - 1;
+  while (RTLIndex >= 0) {
+    groupedSectionsEnd = sections.findIndex(
+    // eslint-disable-next-line @typescript-eslint/no-loop-func
+    (section, index) => index >= groupedSectionsStart && section.endSeparator?.includes(' ') &&
+    // Special case where the spaces were not there in the initial input
+    section.endSeparator !== ' / ');
+    if (groupedSectionsEnd === -1) {
+      groupedSectionsEnd = sections.length - 1;
+    }
+    for (let i = groupedSectionsEnd; i >= groupedSectionsStart; i -= 1) {
+      ltr2rtl[i] = RTLIndex;
+      rtl2ltr[RTLIndex] = i;
+      RTLIndex -= 1;
+    }
+    groupedSectionsStart = groupedSectionsEnd + 1;
+  }
+  sections.forEach((_, index) => {
+    const rtlIndex = ltr2rtl[index];
+    const leftIndex = rtlIndex === 0 ? null : rtl2ltr[rtlIndex - 1];
+    const rightIndex = rtlIndex === sections.length - 1 ? null : rtl2ltr[rtlIndex + 1];
+    neighbors[index] = {
+      leftIndex,
+      rightIndex
+    };
+  });
+  return {
+    neighbors,
+    startIndex: rtl2ltr[0],
+    endIndex: rtl2ltr[sections.length - 1]
+  };
+};
+export const parseSelectedSections = (selectedSections, sections) => {
+  if (selectedSections == null) {
+    return null;
+  }
+  if (selectedSections === 'all') {
+    return 'all';
+  }
+  if (typeof selectedSections === 'string') {
+    const index = sections.findIndex(section => section.type === selectedSections);
+    return index === -1 ? null : index;
+  }
+  return selectedSections;
+};
+export const getSectionValueText = (section, utils) => {
+  if (!section.value) {
+    return undefined;
+  }
+  switch (section.type) {
+    case 'month':
+      {
+        if (section.contentType === 'digit') {
+          return utils.format(utils.setMonth(utils.date(), Number(section.value) - 1), 'month');
+        }
+        const parsedDate = utils.parse(section.value, section.format);
+        return parsedDate ? utils.format(parsedDate, 'month') : undefined;
+      }
+    case 'day':
+      return section.contentType === 'digit' ? utils.format(utils.setDate(utils.startOfYear(utils.date()), Number(section.value)), 'dayOfMonthFull') : section.value;
+    case 'weekDay':
+      // TODO: improve by providing the label of the week day
+      return undefined;
+    default:
+      return undefined;
+  }
+};
+export const getSectionValueNow = (section, utils) => {
+  if (!section.value) {
+    return undefined;
+  }
+  switch (section.type) {
+    case 'weekDay':
+      {
+        if (section.contentType === 'letter') {
+          // TODO: improve by resolving the week day number from a letter week day
+          return undefined;
+        }
+        return Number(section.value);
+      }
+    case 'meridiem':
+      {
+        const parsedDate = utils.parse(`01:00 ${section.value}`, `${utils.formats.hours12h}:${utils.formats.minutes} ${section.format}`);
+        if (parsedDate) {
+          return utils.getHours(parsedDate) >= 12 ? 1 : 0;
+        }
+        return undefined;
+      }
+    case 'day':
+      return section.contentType === 'digit-with-letter' ? parseInt(section.value, 10) : Number(section.value);
+    case 'month':
+      {
+        if (section.contentType === 'digit') {
+          return Number(section.value);
+        }
+        const parsedDate = utils.parse(section.value, section.format);
+        return parsedDate ? utils.getMonth(parsedDate) + 1 : undefined;
+      }
+    default:
+      return section.contentType !== 'letter' ? Number(section.value) : undefined;
+  }
+};

package/esm/internals/hooks/useField/useFieldCharacterEditing.d.ts

@@ -0,0 +1,36 @@
+import { PickersTimezone, InferFieldSection } from "../../../models/index.js";
+import { FieldSectionsValueBoundaries } from "./useField.types.js";
+import { UpdateSectionValueParams } from "./useFieldState.js";
+import { PickerValidValue } from "../../models/index.js";
+export interface ApplyCharacterEditingParams {
+  keyPressed: string;
+  sectionIndex: number;
+}
+interface UseFieldCharacterEditingParams<TValue extends PickerValidValue> {
+  sections: InferFieldSection<TValue>[];
+  updateSectionValue: (params: UpdateSectionValueParams<TValue>) => void;
+  sectionsValueBoundaries: FieldSectionsValueBoundaries;
+  localizedDigits: string[];
+  setTempAndroidValueStr: (newValue: string | null) => void;
+  timezone: PickersTimezone;
+}
+export interface UseFieldCharacterEditingResponse {
+  applyCharacterEditing: (params: ApplyCharacterEditingParams) => void;
+  resetCharacterQuery: () => void;
+}
+/**
+ * Update the active section value when the user pressed a key that is not a navigation key (arrow key for example).
+ * This hook has two main editing behaviors
+ *
+ * 1. The numeric editing when the user presses a digit
+ * 2. The letter editing when the user presses another key
+ */
+export declare const useFieldCharacterEditing: <TValue extends PickerValidValue>({
+  sections,
+  updateSectionValue,
+  sectionsValueBoundaries,
+  localizedDigits,
+  setTempAndroidValueStr,
+  timezone
+}: UseFieldCharacterEditingParams<TValue>) => UseFieldCharacterEditingResponse;
+export {};