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

package/esm/AdapterDateFns/AdapterDateFns.js

@@ -0,0 +1,284 @@
+/* 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 { 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`
+ *
+ * MIT License
+ *
+ * Copyright (c) 2017 Dmitriy Kovalenko
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+export class AdapterDateFns extends AdapterDateFnsBase {
+  constructor({
+    locale,
+    formats
+  } = {}) {
+    /* istanbul ignore next */
+    if (process.env.NODE_ENV !== 'production') {
+      if (typeof addDays !== 'function') {
+        throw new Error(['MUI: The `date-fns` package v2.x is not compatible with this adapter.', 'Please, install v3.x or v4.x of the package or use the `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 ?? 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;
+      }
+      return dateFnsParse(value, format, new Date(), {
+        locale: this.locale
+      });
+    };
+    this.isValid = value => {
+      if (value == null) {
+        return false;
+      }
+      return isValid(value);
+    };
+    this.format = (value, formatKey) => {
+      return this.formatByString(value, this.formats[formatKey]);
+    };
+    this.formatByString = (value, formatString) => {
+      return dateFnsFormat(value, formatString, {
+        locale: this.locale
+      });
+    };
+    this.isEqual = (value, comparing) => {
+      if (value === null && comparing === null) {
+        return true;
+      }
+      if (value === null || comparing === null) {
+        return false;
+      }
+      return isEqual(value, comparing);
+    };
+    this.isSameYear = (value, comparing) => {
+      return isSameYear(value, comparing);
+    };
+    this.isSameMonth = (value, comparing) => {
+      return isSameMonth(value, comparing);
+    };
+    this.isSameDay = (value, comparing) => {
+      return isSameDay(value, comparing);
+    };
+    this.isSameHour = (value, comparing) => {
+      return isSameHour(value, comparing);
+    };
+    this.isAfter = (value, comparing) => {
+      return isAfter(value, comparing);
+    };
+    this.isAfterYear = (value, comparing) => {
+      return isAfter(value, endOfYear(comparing));
+    };
+    this.isAfterDay = (value, comparing) => {
+      return isAfter(value, endOfDay(comparing));
+    };
+    this.isBefore = (value, comparing) => {
+      return isBefore(value, comparing);
+    };
+    this.isBeforeYear = (value, comparing) => {
+      return isBefore(value, this.startOfYear(comparing));
+    };
+    this.isBeforeDay = (value, comparing) => {
+      return isBefore(value, this.startOfDay(comparing));
+    };
+    this.isWithinRange = (value, [start, end]) => {
+      return isWithinInterval(value, {
+        start,
+        end
+      });
+    };
+    this.startOfYear = value => {
+      return startOfYear(value);
+    };
+    this.startOfMonth = value => {
+      return startOfMonth(value);
+    };
+    this.startOfWeek = value => {
+      return startOfWeek(value, {
+        locale: this.locale
+      });
+    };
+    this.startOfDay = value => {
+      return startOfDay(value);
+    };
+    this.endOfYear = value => {
+      return endOfYear(value);
+    };
+    this.endOfMonth = value => {
+      return endOfMonth(value);
+    };
+    this.endOfWeek = value => {
+      return endOfWeek(value, {
+        locale: this.locale
+      });
+    };
+    this.endOfDay = value => {
+      return endOfDay(value);
+    };
+    this.addYears = (value, amount) => {
+      return addYears(value, amount);
+    };
+    this.addMonths = (value, amount) => {
+      return addMonths(value, amount);
+    };
+    this.addWeeks = (value, amount) => {
+      return addWeeks(value, amount);
+    };
+    this.addDays = (value, amount) => {
+      return addDays(value, amount);
+    };
+    this.addHours = (value, amount) => {
+      return addHours(value, amount);
+    };
+    this.addMinutes = (value, amount) => {
+      return addMinutes(value, amount);
+    };
+    this.addSeconds = (value, amount) => {
+      return addSeconds(value, amount);
+    };
+    this.getYear = value => {
+      return getYear(value);
+    };
+    this.getMonth = value => {
+      return getMonth(value);
+    };
+    this.getDate = value => {
+      return getDate(value);
+    };
+    this.getHours = value => {
+      return getHours(value);
+    };
+    this.getMinutes = value => {
+      return getMinutes(value);
+    };
+    this.getSeconds = value => {
+      return getSeconds(value);
+    };
+    this.getMilliseconds = value => {
+      return getMilliseconds(value);
+    };
+    this.setYear = (value, year) => {
+      return setYear(value, year);
+    };
+    this.setMonth = (value, month) => {
+      return setMonth(value, month);
+    };
+    this.setDate = (value, date) => {
+      return setDate(value, date);
+    };
+    this.setHours = (value, hours) => {
+      return setHours(value, hours);
+    };
+    this.setMinutes = (value, minutes) => {
+      return setMinutes(value, minutes);
+    };
+    this.setSeconds = (value, seconds) => {
+      return setSeconds(value, seconds);
+    };
+    this.setMilliseconds = (value, milliseconds) => {
+      return setMilliseconds(value, milliseconds);
+    };
+    this.getDaysInMonth = value => {
+      return getDaysInMonth(value);
+    };
+    this.getWeekArray = value => {
+      const start = this.startOfWeek(this.startOfMonth(value));
+      const end = this.endOfWeek(this.endOfMonth(value));
+      let count = 0;
+      let current = start;
+      const nestedWeeks = [];
+      while (this.isBefore(current, end)) {
+        const weekNumber = Math.floor(count / 7);
+        nestedWeeks[weekNumber] = nestedWeeks[weekNumber] || [];
+        nestedWeeks[weekNumber].push(current);
+        current = this.addDays(current, 1);
+        count += 1;
+      }
+      return nestedWeeks;
+    };
+    this.getWeekNumber = value => {
+      return getWeek(value, {
+        locale: this.locale
+      });
+    };
+    this.getYearRange = ([start, end]) => {
+      const startDate = this.startOfYear(start);
+      const endDate = this.endOfYear(end);
+      const years = [];
+      let current = startDate;
+      while (this.isBefore(current, endDate)) {
+        years.push(current);
+        current = this.addYears(current, 1);
+      }
+      return years;
+    };
+  }
+}

package/esm/AdapterDateFns/index.d.ts

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

package/esm/AdapterDateFns/index.js

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

package/esm/AdapterDateFnsBase/AdapterDateFnsBase.d.ts

@@ -0,0 +1,64 @@
+import { MakeRequired } from '@mui/x-internals/types';
+import { AdapterFormats, AdapterOptions, DateBuilderReturnType, FieldFormatTokenMap, MuiPickersAdapter } from "../models/index.js";
+type DateFnsLocaleBase = {
+  formatLong: {
+    date: (...args: Array<any>) => any;
+    time: (...args: Array<any>) => any;
+    dateTime: (...args: Array<any>) => any;
+  };
+  code?: string;
+};
+type DateFnsAdapterBaseOptions<DateFnsLocale extends DateFnsLocaleBase> = MakeRequired<AdapterOptions<DateFnsLocale, never>, 'locale'> & {
+  longFormatters: Record<'p' | 'P', (token: string, formatLong: DateFnsLocaleBase['formatLong']) => string>;
+  lib?: string;
+};
+/**
+ * Based on `@date-io/date-fns`
+ *
+ * MIT License
+ *
+ * Copyright (c) 2017 Dmitriy Kovalenko
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+export declare class AdapterDateFnsBase<DateFnsLocale extends DateFnsLocaleBase> implements Pick<MuiPickersAdapter<DateFnsLocale>, 'date' | 'getInvalidDate' | 'getTimezone' | 'setTimezone' | 'toJsDate' | 'getCurrentLocaleCode' | 'is12HourCycleInCurrentLocale' | 'expandFormat' | 'formatNumber'> {
+  isMUIAdapter: boolean;
+  isTimezoneCompatible: boolean;
+  lib: string;
+  locale: DateFnsLocale;
+  formats: AdapterFormats;
+  formatTokenMap: FieldFormatTokenMap;
+  escapedCharacters: {
+    start: string;
+    end: string;
+  };
+  longFormatters: DateFnsAdapterBaseOptions<DateFnsLocale>['longFormatters'];
+  constructor(props: DateFnsAdapterBaseOptions<DateFnsLocale>);
+  date: <T extends string | null | undefined>(value?: T) => DateBuilderReturnType<T>;
+  getInvalidDate: () => Date;
+  getTimezone: () => string;
+  setTimezone: (value: Date) => Date;
+  toJsDate: (value: Date) => Date;
+  getCurrentLocaleCode: () => string;
+  is12HourCycleInCurrentLocale: () => boolean;
+  expandFormat: (format: string) => string;
+  formatNumber: (numberToFormat: string) => string;
+  getDayOfWeek: (value: Date) => number;
+}
+export {};

package/esm/AdapterDateFnsBase/AdapterDateFnsBase.js

@@ -0,0 +1,291 @@
+import _extends from "@babel/runtime/helpers/esm/extends";
+/* eslint-disable class-methods-use-this */
+
+const formatTokenMap = {
+  // Year
+  y: {
+    sectionType: 'year',
+    contentType: 'digit',
+    maxLength: 4
+  },
+  yy: 'year',
+  yyy: {
+    sectionType: 'year',
+    contentType: 'digit',
+    maxLength: 4
+  },
+  yyyy: 'year',
+  // Month
+  M: {
+    sectionType: 'month',
+    contentType: 'digit',
+    maxLength: 2
+  },
+  MM: 'month',
+  MMMM: {
+    sectionType: 'month',
+    contentType: 'letter'
+  },
+  MMM: {
+    sectionType: 'month',
+    contentType: 'letter'
+  },
+  L: {
+    sectionType: 'month',
+    contentType: 'digit',
+    maxLength: 2
+  },
+  LL: 'month',
+  LLL: {
+    sectionType: 'month',
+    contentType: 'letter'
+  },
+  LLLL: {
+    sectionType: 'month',
+    contentType: 'letter'
+  },
+  // Day of the month
+  d: {
+    sectionType: 'day',
+    contentType: 'digit',
+    maxLength: 2
+  },
+  dd: 'day',
+  do: {
+    sectionType: 'day',
+    contentType: 'digit-with-letter'
+  },
+  // Day of the week
+  E: {
+    sectionType: 'weekDay',
+    contentType: 'letter'
+  },
+  EE: {
+    sectionType: 'weekDay',
+    contentType: 'letter'
+  },
+  EEE: {
+    sectionType: 'weekDay',
+    contentType: 'letter'
+  },
+  EEEE: {
+    sectionType: 'weekDay',
+    contentType: 'letter'
+  },
+  EEEEE: {
+    sectionType: 'weekDay',
+    contentType: 'letter'
+  },
+  i: {
+    sectionType: 'weekDay',
+    contentType: 'digit',
+    maxLength: 1
+  },
+  ii: 'weekDay',
+  iii: {
+    sectionType: 'weekDay',
+    contentType: 'letter'
+  },
+  iiii: {
+    sectionType: 'weekDay',
+    contentType: 'letter'
+  },
+  // eslint-disable-next-line id-denylist
+  e: {
+    sectionType: 'weekDay',
+    contentType: 'digit',
+    maxLength: 1
+  },
+  ee: 'weekDay',
+  eee: {
+    sectionType: 'weekDay',
+    contentType: 'letter'
+  },
+  eeee: {
+    sectionType: 'weekDay',
+    contentType: 'letter'
+  },
+  eeeee: {
+    sectionType: 'weekDay',
+    contentType: 'letter'
+  },
+  eeeeee: {
+    sectionType: 'weekDay',
+    contentType: 'letter'
+  },
+  c: {
+    sectionType: 'weekDay',
+    contentType: 'digit',
+    maxLength: 1
+  },
+  cc: 'weekDay',
+  ccc: {
+    sectionType: 'weekDay',
+    contentType: 'letter'
+  },
+  cccc: {
+    sectionType: 'weekDay',
+    contentType: 'letter'
+  },
+  ccccc: {
+    sectionType: 'weekDay',
+    contentType: 'letter'
+  },
+  cccccc: {
+    sectionType: 'weekDay',
+    contentType: 'letter'
+  },
+  // Meridiem
+  a: 'meridiem',
+  aa: 'meridiem',
+  aaa: 'meridiem',
+  // Hours
+  H: {
+    sectionType: 'hours',
+    contentType: 'digit',
+    maxLength: 2
+  },
+  HH: 'hours',
+  h: {
+    sectionType: 'hours',
+    contentType: 'digit',
+    maxLength: 2
+  },
+  hh: 'hours',
+  // Minutes
+  m: {
+    sectionType: 'minutes',
+    contentType: 'digit',
+    maxLength: 2
+  },
+  mm: 'minutes',
+  // Seconds
+  s: {
+    sectionType: 'seconds',
+    contentType: 'digit',
+    maxLength: 2
+  },
+  ss: 'seconds'
+};
+const defaultFormats = {
+  year: 'yyyy',
+  month: 'LLLL',
+  monthShort: 'MMM',
+  dayOfMonth: 'd',
+  dayOfMonthFull: 'do',
+  weekday: 'EEEE',
+  weekdayShort: 'EEEEEE',
+  hours24h: 'HH',
+  hours12h: 'hh',
+  meridiem: 'aa',
+  minutes: 'mm',
+  seconds: 'ss',
+  fullDate: 'PP',
+  keyboardDate: 'P',
+  shortDate: 'MMM d',
+  normalDate: 'd MMMM',
+  normalDateWithWeekday: 'EEE, MMM d',
+  fullTime12h: 'hh:mm aa',
+  fullTime24h: 'HH:mm',
+  keyboardDateTime12h: 'P hh:mm aa',
+  keyboardDateTime24h: 'P HH:mm'
+};
+/**
+ * Based on `@date-io/date-fns`
+ *
+ * MIT License
+ *
+ * Copyright (c) 2017 Dmitriy Kovalenko
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+export class AdapterDateFnsBase {
+  constructor(props) {
+    this.isMUIAdapter = true;
+    this.isTimezoneCompatible = false;
+    this.lib = void 0;
+    this.locale = void 0;
+    this.formats = void 0;
+    this.formatTokenMap = formatTokenMap;
+    this.escapedCharacters = {
+      start: "'",
+      end: "'"
+    };
+    this.longFormatters = void 0;
+    this.date = value => {
+      if (typeof value === 'undefined') {
+        return new Date();
+      }
+      if (value === null) {
+        return null;
+      }
+      return new Date(value);
+    };
+    this.getInvalidDate = () => new Date('Invalid Date');
+    this.getTimezone = () => {
+      return 'default';
+    };
+    this.setTimezone = value => {
+      return value;
+    };
+    this.toJsDate = value => {
+      return value;
+    };
+    this.getCurrentLocaleCode = () => {
+      // `code` is undefined only in `date-fns` types, but all locales have it
+      return this.locale.code;
+    };
+    // Note: date-fns input types are more lenient than this adapter, so we need to expose our more
+    // strict signature and delegate to the more lenient signature. Otherwise, we have downstream type errors upon usage.
+    this.is12HourCycleInCurrentLocale = () => {
+      return /a/.test(this.locale.formatLong.time({
+        width: 'short'
+      }));
+    };
+    this.expandFormat = format => {
+      const longFormatRegexp = /P+p+|P+|p+|''|'(''|[^'])+('|$)|./g;
+
+      // @see https://github.com/date-fns/date-fns/blob/master/src/format/index.js#L31
+      return format.match(longFormatRegexp).map(token => {
+        const firstCharacter = token[0];
+        if (firstCharacter === 'p' || firstCharacter === 'P') {
+          const longFormatter = this.longFormatters[firstCharacter];
+          return longFormatter(token, this.locale.formatLong);
+        }
+        return token;
+      }).join('');
+    };
+    this.formatNumber = numberToFormat => {
+      return numberToFormat;
+    };
+    this.getDayOfWeek = value => {
+      return value.getDay() + 1;
+    };
+    const {
+      locale,
+      formats,
+      longFormatters,
+      lib
+    } = props;
+    this.locale = locale;
+    this.formats = _extends({}, defaultFormats, formats);
+    this.longFormatters = longFormatters;
+    this.lib = lib || 'date-fns';
+  }
+}

package/esm/AdapterDateFnsBase/index.d.ts

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

package/esm/AdapterDateFnsBase/index.js

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