@mui/x-date-pickers 8.0.0-beta.2 → 8.0.0

package/modern/managers/useTimeManager.js

@@ -1,48 +0,0 @@
-'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";
-import { useUtils } from "../internals/hooks/useUtils.js";
-import { usePickerTranslations } from "../hooks/usePickerTranslations.js";
-export function useTimeManager(parameters = {}) {
-  const {
-    enableAccessibleFieldDOMStructure = true,
-    ampm
-  } = parameters;
-  return React.useMemo(() => ({
-    valueType: 'time',
-    validator: validateTime,
-    internal_valueManager: singleItemValueManager,
-    internal_fieldValueManager: singleItemFieldValueManager,
-    internal_enableAccessibleFieldDOMStructure: enableAccessibleFieldDOMStructure,
-    internal_useApplyDefaultValuesToFieldInternalProps: useApplyDefaultValuesToTimeFieldInternalProps,
-    internal_useOpenPickerButtonAriaLabel: createUseOpenPickerButtonAriaLabel(ampm)
-  }), [ampm, enableAccessibleFieldDOMStructure]);
-}
-function createUseOpenPickerButtonAriaLabel(ampm) {
-  return function useOpenPickerButtonAriaLabel(value) {
-    const utils = useUtils();
-    const translations = usePickerTranslations();
-    return React.useMemo(() => {
-      const formatKey = ampm ?? utils.is12HourCycleInCurrentLocale() ? 'fullTime12h' : 'fullTime24h';
-      const formattedValue = utils.isValid(value) ? utils.format(value, formatKey) : null;
-      return translations.openTimePickerDialogue(formattedValue);
-    }, [value, translations, utils]);
-  };
-}
-function useApplyDefaultValuesToTimeFieldInternalProps(internalProps) {
-  const utils = useUtils();
-  const validationProps = useApplyDefaultValuesToTimeValidationProps(internalProps);
-  const ampm = React.useMemo(() => internalProps.ampm ?? utils.is12HourCycleInCurrentLocale(), [internalProps.ampm, utils]);
-  return React.useMemo(() => _extends({}, internalProps, validationProps, {
-    format: internalProps.format ?? (ampm ? utils.formats.fullTime12h : utils.formats.fullTime24h)
-  }), [internalProps, validationProps, ampm, utils]);
-}
-export function useApplyDefaultValuesToTimeValidationProps(props) {
-  return React.useMemo(() => ({
-    disablePast: props.disablePast ?? false,
-    disableFuture: props.disableFuture ?? false
-  }), [props.disablePast, props.disableFuture]);
-}

package/modern/models/adapters.d.ts

@@ -1,542 +0,0 @@
-import { FieldSectionContentType, FieldSectionType } from "./fields.js";
-import { PickersTimezone } from "./timezone.js";
-import { PickerValidDate } from "./pickers.js";
-export interface AdapterFormats {
-  /**
-   * The 4-digit year.
-   * @example "2019"
-   */
-  year: string;
-  /**
-   * The full month name.
-   * @example "January"
-   */
-  month: string;
-  /**
-   * The abbreviated month name.
-   * @example "Jan"
-   */
-  monthShort: string;
-  /**
-   * The day of the month.
-   * @example "1"
-   */
-  dayOfMonth: string;
-  /**
-   * The day of the month with letters.
-   * @example "2nd"
-   */
-  dayOfMonthFull: string;
-  /**
-   * The name of the day of the week.
-   * @example "Wednesday"
-   */
-  weekday: string;
-  /**
-   * The abbreviated name of the day of the week.
-   * @example "Wed"
-   * */
-  weekdayShort: string;
-  /**
-   * The hours, 24-hour clock.
-   * @example "23"
-   */
-  hours24h: string;
-  /**
-   * The hours, 12-hour clock.
-   * @example "11"
-   */
-  hours12h: string;
-  /**
-   * The meridiem.
-   * @example "AM"
-   */
-  meridiem: string;
-  /**
-   * The minutes.
-   * @example "44"
-   */
-  minutes: string;
-  /**
-   * The seconds.
-   * @example "00"
-   */
-  seconds: string;
-  /** The localized full date.
-   * Used for the aria-label of the opening button of the `DatePicker`.
-   * @example "Jan 1, 2019"
-   */
-  fullDate: string;
-  /**
-   * A keyboard input friendly date format.
-   * Used in the date fields.
-   * @example "02/13/2020"
-   */
-  keyboardDate: string;
-  /**
-   * The abbreviated month name and the day of the month.
-   * Used in the `DateTimePicker` and `DateRangePicker` toolbars.
-   * @example "Jan 1"
-   */
-  shortDate: string;
-  /**
-   * The month name and the day of the month.
-   * Used in the `DatePicker` toolbar for non-english locales.
-   * @example "1 January"
-   */
-  normalDate: string;
-  /**
-   * The month name, the day of the week and the day of the month.
-   * Used in the `DatePicker` toolbar for english locales.
-   * @example "Sun, Jan 1"
-   */
-  normalDateWithWeekday: string;
-  /**
-   * The hours with the meridiem and minutes.
-   * @example "11:44 PM"
-   */
-  fullTime12h: string;
-  /**
-   * The hours without the meridiem and minutes.
-   * @example "23:44"
-   */
-  fullTime24h: string;
-  /**
-   * A keyboard input friendly time format for 12-hour clock.
-   * Used in the date-time fields.
-   * @example "02/13/2020 11:44 PM"
-   */
-  keyboardDateTime12h: string;
-  /**
-   * A keyboard input friendly time format for 24-hour clock.
-   * Used in the date-time fields.
-   * @example "02/13/2020 23:44"
-   */
-  keyboardDateTime24h: string;
-}
-export type FieldFormatTokenMap = {
-  [formatToken: string]: FieldSectionType | {
-    sectionType: FieldSectionType;
-    contentType: FieldSectionContentType;
-    maxLength?: number;
-  };
-};
-type PropertyIfNotNever<PName extends string, PType> = [PType] extends [never] ? {} : { [P in PName]?: PType };
-export type AdapterOptions<TLocale, TInstance> = {
-  formats?: Partial<AdapterFormats>;
-  locale?: TLocale;
-} & PropertyIfNotNever<'instance', TInstance>;
-export type DateBuilderReturnType<T extends string | null | undefined> = [T] extends [null] ? null : PickerValidDate;
-export interface MuiPickersAdapter<TLocale = any> {
-  /**
-   * A boolean confirming that the adapter used is an MUI adapter.
-   */
-  isMUIAdapter: boolean;
-  isTimezoneCompatible: boolean;
-  formats: AdapterFormats;
-  locale?: TLocale;
-  /**
-   * Name of the library that is used right now
-   */
-  lib: string;
-  /**
-   * The characters used to escape a string inside a format.
-   */
-  escapedCharacters: {
-    start: string;
-    end: string;
-  };
-  /**
-   * A map containing all the format that the field components can understand.
-   */
-  formatTokenMap: FieldFormatTokenMap;
-  /**
-   * Create a date in the date library format.
-   * If no `value` parameter is provided, creates a date with the current timestamp.
-   * If a `value` parameter is provided, pass it to the date library to try to parse it.
-   * @param {string | null | undefined} value The optional value to parse.
-   * @param {PickersTimezone} timezone The timezone of the date. Default: "default"
-   * @returns {PickerValidDate | null} The parsed date.
-   */
-  date<T extends string | null | undefined>(value?: T, timezone?: PickersTimezone): DateBuilderReturnType<T>;
-  /**
-   * Creates an invalid date in the date library format.
-   * @deprecated This method will be removed in the next major release (v9.0.0).
-   * @returns {PickerValidDate} The invalid date.
-   */
-  getInvalidDate(): PickerValidDate;
-  /**
-   * Extracts the timezone from a date.
-   * @param {PickerValidDate | null} value The date from which we want to get the timezone.
-   * @returns {PickerValidDate} The timezone of the date.
-   */
-  getTimezone(value: PickerValidDate | null): PickersTimezone;
-  /**
-   * Convert a date to another timezone.
-   * @param {PickerValidDate} value The date to convert.
-   * @param {PickersTimezone} timezone The timezone to convert the date to.
-   * @returns {PickerValidDate} The converted date.
-   */
-  setTimezone(value: PickerValidDate, timezone: PickersTimezone): PickerValidDate;
-  /**
-   * Convert a date in the library format into a JavaScript `Date` object.
-   * @param {PickerValidDate} value The value to convert.
-   * @returns {PickerValidDate} the JavaScript date.
-   */
-  toJsDate(value: PickerValidDate): Date;
-  /**
-   * Parse a string date in a specific format.
-   * @param {string} value The string date to parse.
-   * @param {string} format The format in which the string date is.
-   * @returns {PickerValidDate | null} The parsed date.
-   */
-  parse(value: string, format: string): PickerValidDate | null;
-  /**
-   * Get the code of the locale currently used by the adapter.
-   * @returns {string} The code of the locale.
-   */
-  getCurrentLocaleCode(): string;
-  /**
-   * Check if the current locale is using 12 hours cycle (i.e: time with meridiem).
-   * @returns {boolean} `true` if the current locale is using 12 hours cycle.
-   */
-  is12HourCycleInCurrentLocale(): boolean;
-  /**
-   * Create a format with no meta-token (for example: `LLL` or `PP`).
-   * @param {string} format The format to expand.
-   * @returns {string} The expanded format.
-   */
-  expandFormat(format: string): string;
-  /**
-   * Check if the date is valid.
-   * @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): value is PickerValidDate;
-  /**
-   * Format a date using an adapter format string (see the `AdapterFormats` interface)
-   * @param {PickerValidDate} value The date to format.
-   * @param {keyof AdapterFormats} formatKey The formatKey to use.
-   * @returns {string} The stringify date.
-   */
-  format(value: PickerValidDate, formatKey: keyof AdapterFormats): string;
-  /**
-   * Format a date using a format of the date library.
-   * @param {PickerValidDate} value The date to format.
-   * @param {string} formatString The format to use.
-   * @returns {string} The stringify date.
-   */
-  formatByString(value: PickerValidDate, formatString: string): string;
-  /**
-   * Format a number to be rendered in the clock.
-   * Is being used in hijri and jalali adapters.
-   * @param {string} numberToFormat The number to format.
-   * @returns {string} The formatted number.
-   */
-  formatNumber(numberToFormat: string): string;
-  /**
-   * 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.
-   */
-  isEqual(value: PickerValidDate | null, comparing: PickerValidDate | null): boolean;
-  /**
-   * Check if the two dates are in the same year (using the timezone of the reference date).
-   * @param {PickerValidDate} value The reference date.
-   * @param {PickerValidDate} comparing The date to compare with the reference date.
-   * @returns {boolean} `true` if the two dates are in the same year.
-   */
-  isSameYear(value: PickerValidDate, comparing: PickerValidDate): boolean;
-  /**
-   * Check if the two dates are in the same month (using the timezone of the reference date).
-   * @param {PickerValidDate} value The reference date.
-   * @param {PickerValidDate} comparing The date to compare with the reference date.
-   * @returns {boolean} `true` if the two dates are in the same month.
-   */
-  isSameMonth(value: PickerValidDate, comparing: PickerValidDate): boolean;
-  /**
-   * Check if the two dates are in the same day (using the timezone of the reference date).
-   * @param {PickerValidDate} value The reference date.
-   * @param {PickerValidDate} comparing The date to compare with the reference date.
-   * @returns {boolean} `true` if the two dates are in the same day.
-   */
-  isSameDay(value: PickerValidDate, comparing: PickerValidDate): boolean;
-  /**
-   * Check if the two dates are at the same hour (using the timezone of the reference date).
-   * @param {PickerValidDate} value The reference date.
-   * @param {PickerValidDate} comparing The date to compare with the reference date.
-   * @returns {boolean} `true` if the two dates are in the same hour.
-   */
-  isSameHour(value: PickerValidDate, comparing: PickerValidDate): boolean;
-  /**
-   * Check if the reference date is after the second date.
-   * @param {PickerValidDate} value The reference date.
-   * @param {PickerValidDate} comparing The date to compare with the reference date.
-   * @returns {boolean} `true` if the reference date is after the second date.
-   */
-  isAfter(value: PickerValidDate, comparing: PickerValidDate): boolean;
-  /**
-   * Check if the year of the reference date is after the year of the second date (using the timezone of the reference date).
-   * @param {PickerValidDate} value The reference date.
-   * @param {PickerValidDate} comparing The date to compare with the reference date.
-   * @returns {boolean} `true` if the year of the reference date is after the year of the second date.
-   */
-  isAfterYear(value: PickerValidDate, comparing: PickerValidDate): boolean;
-  /**
-   * Check if the day of the reference date is after the day of the second date (using the timezone of the reference date).
-   * @param {PickerValidDate} value The reference date.
-   * @param {PickerValidDate} comparing The date to compare with the reference date.
-   * @returns {boolean} `true` if the day of the reference date is after the day of the second date.
-   */
-  isAfterDay(value: PickerValidDate, comparing: PickerValidDate): boolean;
-  /**
-   * Check if the reference date is before the second date.
-   * @param {PickerValidDate} value The reference date.
-   * @param {PickerValidDate} comparing The date to compare with the reference date.
-   * @returns {boolean} `true` if the reference date is before the second date.
-   */
-  isBefore(value: PickerValidDate, comparing: PickerValidDate): boolean;
-  /**
-   * Check if the year of the reference date is before the year of the second date (using the timezone of the reference date).
-   * @param {PickerValidDate} value The reference date.
-   * @param {PickerValidDate} comparing The date to compare with the reference date.
-   * @returns {boolean} `true` if the year of the reference date is before the year of the second date.
-   */
-  isBeforeYear(value: PickerValidDate, comparing: PickerValidDate): boolean;
-  /**
-   * Check if the day of the reference date is before the day of the second date (using the timezone of the reference date).
-   * @param {PickerValidDate} value The reference date.
-   * @param {PickerValidDate} comparing The date to compare with the reference date.
-   * @returns {boolean} `true` if the day of the reference date is before the day of the second date.
-   */
-  isBeforeDay(value: PickerValidDate, comparing: PickerValidDate): boolean;
-  /**
-   * Check if the value is within the provided range.
-   * @param {PickerValidDate} value The value to test.
-   * @param {[PickerValidDate, PickerValidDate]} range The range in which the value should be.
-   * @returns {boolean} `true` if the value is within the provided range.
-   */
-  isWithinRange(value: PickerValidDate, range: [PickerValidDate, PickerValidDate]): boolean;
-  /**
-   * Return the start of the year for the given date.
-   * @param {PickerValidDate} value The original date.
-   * @returns {PickerValidDate} The start of the year of the given date.
-   */
-  startOfYear(value: PickerValidDate): PickerValidDate;
-  /**
-   * Return the start of the month for the given date.
-   * @param {PickerValidDate} value The original date.
-   * @returns {PickerValidDate} The start of the month of the given date.
-   */
-  startOfMonth(value: PickerValidDate): PickerValidDate;
-  /**
-   * Return the start of the week for the given date.
-   * @param {PickerValidDate} value The original date.
-   * @returns {PickerValidDate} The start of the week of the given date.
-   */
-  startOfWeek(value: PickerValidDate): PickerValidDate;
-  /**
-   * Return the start of the day for the given date.
-   * @param {PickerValidDate} value The original date.
-   * @returns {PickerValidDate} The start of the day of the given date.
-   */
-  startOfDay(value: PickerValidDate): PickerValidDate;
-  /**
-   * Return the end of the year for the given date.
-   * @param {PickerValidDate} value The original date.
-   * @returns {PickerValidDate} The end of the year of the given date.
-   */
-  endOfYear(value: PickerValidDate): PickerValidDate;
-  /**
-   * Return the end of the month for the given date.
-   * @param {PickerValidDate} value The original date.
-   * @returns {PickerValidDate} The end of the month of the given date.
-   */
-  endOfMonth(value: PickerValidDate): PickerValidDate;
-  /**
-   * Return the end of the week for the given date.
-   * @param {PickerValidDate} value The original date.
-   * @returns {PickerValidDate} The end of the week of the given date.
-   */
-  endOfWeek(value: PickerValidDate): PickerValidDate;
-  /**
-   * Return the end of the day for the given date.
-   * @param {PickerValidDate} value The original date.
-   * @returns {PickerValidDate} The end of the day of the given date.
-   */
-  endOfDay(value: PickerValidDate): PickerValidDate;
-  /**
-   * Add the specified number of years to the given date.
-   * @param {PickerValidDate} value The date to be changed.
-   * @param {number} amount The amount of years to be added.
-   * @returns {PickerValidDate} The new date with the years added.
-   */
-  addYears(value: PickerValidDate, amount: number): PickerValidDate;
-  /**
-   * Add the specified number of months to the given date.
-   * @param {PickerValidDate} value The date to be changed.
-   * @param {number} amount The amount of months to be added.
-   * @returns {PickerValidDate} The new date with the months added.
-   */
-  addMonths(value: PickerValidDate, amount: number): PickerValidDate;
-  /**
-   * Add the specified number of weeks to the given date.
-   * @param {PickerValidDate} value The date to be changed.
-   * @param {number} amount The amount of weeks to be added.
-   * @returns {PickerValidDate} The new date with the weeks added.
-   */
-  addWeeks(value: PickerValidDate, amount: number): PickerValidDate;
-  /**
-   * Add the specified number of days to the given date.
-   * @param {PickerValidDate} value The date to be changed.
-   * @param {number} amount The amount of days to be added.
-   * @returns {PickerValidDate} The new date with the days added.
-   */
-  addDays(value: PickerValidDate, amount: number): PickerValidDate;
-  /**
-   * Add the specified number of hours to the given date.
-   * @param {PickerValidDate} value The date to be changed.
-   * @param {number} amount The amount of hours to be added.
-   * @returns {PickerValidDate} The new date with the hours added.
-   */
-  addHours(value: PickerValidDate, amount: number): PickerValidDate;
-  /**
-   * Add the specified number of minutes to the given date.
-   * @param {PickerValidDate} value The date to be changed.
-   * @param {number} amount The amount of minutes to be added.
-   * @returns {PickerValidDate} The new date with the minutes added.
-   */
-  addMinutes(value: PickerValidDate, amount: number): PickerValidDate;
-  /**
-   * Add the specified number of seconds to the given date.
-   * @param {PickerValidDate} value The date to be changed.
-   * @param {number} amount The amount of seconds to be added.
-   * @returns {PickerValidDate} The new date with the seconds added.
-   */
-  addSeconds(value: PickerValidDate, amount: number): PickerValidDate;
-  /**
-   * Get the year of the given date.
-   * @param {PickerValidDate} value The given date.
-   * @returns {number} The year of the given date.
-   */
-  getYear(value: PickerValidDate): number;
-  /**
-   * Get the month of the given date.
-   * The value is 0-based, in the Gregorian calendar January = 0, February = 1, ...
-   * @param {PickerValidDate} value The given date.
-   * @returns {number} The month of the given date.
-   */
-  getMonth(value: PickerValidDate): number;
-  /**
-   * 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.
-   */
-  getDate(value: PickerValidDate): number;
-  /**
-   * Get the hours of the given date.
-   * @param {PickerValidDate} value The given date.
-   * @returns {number} The hours of the given date.
-   */
-  getHours(value: PickerValidDate): number;
-  /**
-   * Get the minutes of the given date.
-   * @param {PickerValidDate} value The given date.
-   * @returns {number} The minutes of the given date.
-   */
-  getMinutes(value: PickerValidDate): number;
-  /**
-   * Get the seconds of the given date.
-   * @param {PickerValidDate} value The given date.
-   * @returns {number} The seconds of the given date.
-   */
-  getSeconds(value: PickerValidDate): number;
-  /**
-   * Get the milliseconds of the given date.
-   * @param {PickerValidDate} value The given date.
-   * @returns {number} The milliseconds of the given date.
-   */
-  getMilliseconds(value: PickerValidDate): number;
-  /**
-   * Set the year to the given date.
-   * @param {PickerValidDate} value The date to be changed.
-   * @param {number} year The year of the new date.
-   * @returns {PickerValidDate} The new date with the year set.
-   */
-  setYear(value: PickerValidDate, year: number): PickerValidDate;
-  /**
-   * Set the month to the given date.
-   * @param {PickerValidDate} value The date to be changed.
-   * @param {number} month The month of the new date.
-   * @returns {PickerValidDate} The new date with the month set.
-   */
-  setMonth(value: PickerValidDate, month: number): PickerValidDate;
-  /**
-   * 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.
-   */
-  setDate(value: PickerValidDate, date: number): PickerValidDate;
-  /**
-   * Set the hours to the given date.
-   * @param {PickerValidDate} value The date to be changed.
-   * @param {number} hours The hours of the new date.
-   * @returns {PickerValidDate} The new date with the hours set.
-   */
-  setHours(value: PickerValidDate, hours: number): PickerValidDate;
-  /**
-   * Set the minutes to the given date.
-   * @param {PickerValidDate} value The date to be changed.
-   * @param {number} minutes The minutes of the new date.
-   * @returns {PickerValidDate} The new date with the minutes set.
-   */
-  setMinutes(value: PickerValidDate, minutes: number): PickerValidDate;
-  /**
-   * Set the seconds to the given date.
-   * @param {PickerValidDate} value The date to be changed.
-   * @param {number} seconds The seconds of the new date.
-   * @returns {PickerValidDate} The new date with the seconds set.
-   */
-  setSeconds(value: PickerValidDate, seconds: number): PickerValidDate;
-  /**
-   * Set the milliseconds to the given date.
-   * @param {PickerValidDate} value The date to be changed.
-   * @param {number} milliseconds The milliseconds of the new date.
-   * @returns {PickerValidDate} The new date with the milliseconds set.
-   */
-  setMilliseconds(value: PickerValidDate, milliseconds: number): PickerValidDate;
-  /**
-   * Get the number of days in a month of the given date.
-   * @param {PickerValidDate} value The given date.
-   * @returns {number} The number of days in the month
-   */
-  getDaysInMonth(value: PickerValidDate): number;
-  /**
-   * Create a nested list with all the days of the month of the given date grouped by week.
-   * @param {PickerValidDate} value The given date.
-   * @returns {PickerValidDate[][]} A nested list with all the days of the month grouped by week.
-   */
-  getWeekArray(value: PickerValidDate): PickerValidDate[][];
-  /**
-   * Get the number of the week of the given date.
-   * @param {PickerValidDate} value The given date.
-   * @returns {number} The number of the week of the given date.
-   */
-  getWeekNumber(value: PickerValidDate): number;
-  /**
-   * Get the number of the day of the week of the given date.
-   * The value is 1-based, 1 - first day of the week, 7 - last day of the week.
-   * @param {PickerValidDate} value The given date.
-   * @returns {number} The number of the day of the week of the given date.
-   */
-  getDayOfWeek(value: PickerValidDate): number;
-  /**
-   * Create a list with all the years between the start and the end date.
-   * @param {[PickerValidDate, PickerValidDate]} range The range of year to create.
-   * @returns {PickerValidDate[]} List of all the years between the start end the end date.
-   */
-  getYearRange(range: [PickerValidDate, PickerValidDate]): PickerValidDate[];
-}
-export {};

package/modern/models/adapters.js

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

package/modern/models/common.d.ts

@@ -1,6 +0,0 @@
-export interface TimeStepOptions {
-  hours?: number;
-  minutes?: number;
-  seconds?: number;
-}
-export type PickerValueType = 'date' | 'time' | 'date-time';

package/modern/models/common.js

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