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

package/modern/AdapterMoment/AdapterMoment.d.ts

@@ -0,0 +1,114 @@
+import defaultMoment, { Moment } from 'moment';
+import { AdapterFormats, AdapterOptions, DateBuilderReturnType, FieldFormatTokenMap, MuiPickersAdapter, PickersTimezone } from "../models/index.js";
+declare module '@mui/x-date-pickers/models' {
+  interface PickerValidDateLookup {
+    moment: Moment;
+  }
+}
+/**
+ * Based on `@date-io/moment`
+ *
+ * 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 AdapterMoment implements MuiPickersAdapter<string> {
+  isMUIAdapter: boolean;
+  isTimezoneCompatible: boolean;
+  lib: string;
+  moment: typeof defaultMoment;
+  locale?: string;
+  formats: AdapterFormats;
+  escapedCharacters: {
+    start: string;
+    end: string;
+  };
+  formatTokenMap: FieldFormatTokenMap;
+  constructor({
+    locale,
+    formats,
+    instance
+  }?: AdapterOptions<string, typeof defaultMoment>);
+  private setLocaleToValue;
+  private hasTimezonePlugin;
+  private createSystemDate;
+  private createUTCDate;
+  private createTZDate;
+  date: <T extends string | null | undefined>(value?: T, timezone?: PickersTimezone) => DateBuilderReturnType<T>;
+  getInvalidDate: () => defaultMoment.Moment;
+  getTimezone: (value: Moment) => string;
+  setTimezone: (value: Moment, timezone: PickersTimezone) => Moment;
+  toJsDate: (value: Moment) => Date;
+  parse: (value: string, format: string) => defaultMoment.Moment | null;
+  getCurrentLocaleCode: () => string;
+  is12HourCycleInCurrentLocale: () => boolean;
+  expandFormat: (format: string) => string;
+  isValid: (value: Moment | null) => value is Moment;
+  format: (value: Moment, formatKey: keyof AdapterFormats) => string;
+  formatByString: (value: Moment, formatString: string) => string;
+  formatNumber: (numberToFormat: string) => string;
+  isEqual: (value: Moment | null, comparing: Moment | null) => boolean;
+  isSameYear: (value: Moment, comparing: Moment) => boolean;
+  isSameMonth: (value: Moment, comparing: Moment) => boolean;
+  isSameDay: (value: Moment, comparing: Moment) => boolean;
+  isSameHour: (value: Moment, comparing: Moment) => boolean;
+  isAfter: (value: Moment, comparing: Moment) => boolean;
+  isAfterYear: (value: Moment, comparing: Moment) => boolean;
+  isAfterDay: (value: Moment, comparing: Moment) => boolean;
+  isBefore: (value: Moment, comparing: Moment) => boolean;
+  isBeforeYear: (value: Moment, comparing: Moment) => boolean;
+  isBeforeDay: (value: Moment, comparing: Moment) => boolean;
+  isWithinRange: (value: Moment, [start, end]: [Moment, Moment]) => boolean;
+  startOfYear: (value: Moment) => defaultMoment.Moment;
+  startOfMonth: (value: Moment) => defaultMoment.Moment;
+  startOfWeek: (value: Moment) => defaultMoment.Moment;
+  startOfDay: (value: Moment) => defaultMoment.Moment;
+  endOfYear: (value: Moment) => defaultMoment.Moment;
+  endOfMonth: (value: Moment) => defaultMoment.Moment;
+  endOfWeek: (value: Moment) => defaultMoment.Moment;
+  endOfDay: (value: Moment) => defaultMoment.Moment;
+  addYears: (value: Moment, amount: number) => defaultMoment.Moment;
+  addMonths: (value: Moment, amount: number) => defaultMoment.Moment;
+  addWeeks: (value: Moment, amount: number) => defaultMoment.Moment;
+  addDays: (value: Moment, amount: number) => defaultMoment.Moment;
+  addHours: (value: Moment, amount: number) => defaultMoment.Moment;
+  addMinutes: (value: Moment, amount: number) => defaultMoment.Moment;
+  addSeconds: (value: Moment, amount: number) => defaultMoment.Moment;
+  getYear: (value: Moment) => number;
+  getMonth: (value: Moment) => number;
+  getDate: (value: Moment) => number;
+  getHours: (value: Moment) => number;
+  getMinutes: (value: Moment) => number;
+  getSeconds: (value: Moment) => number;
+  getMilliseconds: (value: Moment) => number;
+  setYear: (value: Moment, year: number) => defaultMoment.Moment;
+  setMonth: (value: Moment, month: number) => defaultMoment.Moment;
+  setDate: (value: Moment, date: number) => defaultMoment.Moment;
+  setHours: (value: Moment, hours: number) => defaultMoment.Moment;
+  setMinutes: (value: Moment, minutes: number) => defaultMoment.Moment;
+  setSeconds: (value: Moment, seconds: number) => defaultMoment.Moment;
+  setMilliseconds: (value: Moment, milliseconds: number) => defaultMoment.Moment;
+  getDaysInMonth: (value: Moment) => number;
+  getWeekArray: (value: Moment) => defaultMoment.Moment[][];
+  getWeekNumber: (value: Moment) => number;
+  getDayOfWeek: (value: Moment) => number;
+  getYearRange([start, end]: [Moment, Moment]): defaultMoment.Moment[];
+}

package/modern/AdapterMoment/AdapterMoment.js

@@ -115,10 +115,8 @@ const defaultFormats = {
   shortDate: 'MMM D',
   normalDate: 'D MMMM',
   normalDateWithWeekday: 'ddd, MMM D',
-  fullTime: 'LT',
   fullTime12h: 'hh:mm A',
   fullTime24h: 'HH:mm',
-  keyboardDateTime: 'L LT',
   keyboardDateTime12h: 'L hh:mm A',
   keyboardDateTime24h: 'L HH:mm'
 };

package/modern/AdapterMoment/index.d.ts

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

package/modern/AdapterMomentHijri/AdapterMomentHijri.d.ts

@@ -0,0 +1,62 @@
+import defaultHMoment, { Moment } from 'moment-hijri';
+import { AdapterMoment } from "../AdapterMoment/index.js";
+import { AdapterOptions, DateBuilderReturnType, FieldFormatTokenMap, MuiPickersAdapter } from "../models/index.js";
+declare module '@mui/x-date-pickers/models' {
+  interface PickerValidDateLookup {
+    'moment-hijri': Moment;
+  }
+}
+/**
+ * Based on `@date-io/hijri`
+ *
+ * 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 AdapterMomentHijri extends AdapterMoment implements MuiPickersAdapter<string> {
+  lib: string;
+  moment: typeof defaultHMoment;
+  isTimezoneCompatible: boolean;
+  formatTokenMap: FieldFormatTokenMap;
+  constructor({
+    formats,
+    instance
+  }?: AdapterOptions<string, typeof defaultHMoment>);
+  date: <T extends string | null | undefined>(value?: T) => DateBuilderReturnType<T>;
+  getTimezone: () => string;
+  setTimezone: (value: Moment) => Moment;
+  parse: (value: string, format: string) => defaultHMoment.Moment | null;
+  formatNumber: (numberToFormat: string) => string;
+  startOfYear: (value: Moment) => defaultHMoment.Moment;
+  startOfMonth: (value: Moment) => defaultHMoment.Moment;
+  endOfYear: (value: Moment) => defaultHMoment.Moment;
+  endOfMonth: (value: Moment) => defaultHMoment.Moment;
+  addYears: (value: Moment, amount: number) => defaultHMoment.Moment;
+  addMonths: (value: Moment, amount: number) => defaultHMoment.Moment;
+  getYear: (value: Moment) => number;
+  getMonth: (value: Moment) => number;
+  getDate: (value: Moment) => number;
+  setYear: (value: Moment, year: number) => defaultHMoment.Moment;
+  setMonth: (value: Moment, month: number) => defaultHMoment.Moment;
+  setDate: (value: Moment, date: number) => defaultHMoment.Moment;
+  getWeekNumber: (value: Moment) => number;
+  getYearRange: ([start, end]: [Moment, Moment]) => defaultHMoment.Moment[];
+}

package/modern/AdapterMomentHijri/AdapterMomentHijri.js

@@ -82,11 +82,9 @@ const defaultFormats = {
   minutes: 'mm',
   seconds: 'ss',
   fullDate: 'iYYYY, iMMMM Do',
-  keyboardDateTime: 'iYYYY/iMM/iDD LT',
   shortDate: 'iD iMMM',
   normalDate: 'dddd, iD iMMM',
   normalDateWithWeekday: 'DD iMMMM',
-  fullTime: 'LT',
   fullTime12h: 'hh:mm A',
   fullTime24h: 'HH:mm',
   keyboardDate: 'iYYYY/iMM/iDD',

package/modern/AdapterMomentHijri/index.d.ts

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

package/modern/AdapterMomentJalaali/AdapterMomentJalaali.d.ts

@@ -0,0 +1,66 @@
+import defaultJMoment, { Moment } from 'moment-jalaali';
+import { AdapterMoment } from "../AdapterMoment/index.js";
+import { AdapterOptions, DateBuilderReturnType, FieldFormatTokenMap, MuiPickersAdapter } from "../models/index.js";
+declare module '@mui/x-date-pickers/models' {
+  interface PickerValidDateLookup {
+    'moment-jalaali': Moment;
+  }
+}
+/**
+ * Based on `@date-io/jalaali`
+ *
+ * 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 AdapterMomentJalaali extends AdapterMoment implements MuiPickersAdapter<string> {
+  isTimezoneCompatible: boolean;
+  lib: string;
+  moment: typeof defaultJMoment;
+  formatTokenMap: FieldFormatTokenMap;
+  constructor({
+    formats,
+    instance
+  }?: AdapterOptions<string, typeof defaultJMoment>);
+  date: <T extends string | null | undefined>(value?: T) => DateBuilderReturnType<T>;
+  getTimezone: () => string;
+  setTimezone: (value: Moment) => Moment;
+  parse: (value: string, format: string) => defaultJMoment.Moment | null;
+  formatNumber: (numberToFormat: string) => string;
+  isSameYear: (value: Moment, comparing: Moment) => boolean;
+  isSameMonth: (value: Moment, comparing: Moment) => boolean;
+  isAfterYear: (value: Moment, comparing: Moment) => boolean;
+  isBeforeYear: (value: Moment, comparing: Moment) => boolean;
+  startOfYear: (value: Moment) => defaultJMoment.Moment;
+  startOfMonth: (value: Moment) => defaultJMoment.Moment;
+  endOfYear: (value: Moment) => defaultJMoment.Moment;
+  endOfMonth: (value: Moment) => defaultJMoment.Moment;
+  addYears: (value: Moment, amount: number) => defaultJMoment.Moment;
+  addMonths: (value: Moment, amount: number) => defaultJMoment.Moment;
+  getYear: (value: Moment) => number;
+  getMonth: (value: Moment) => number;
+  getDate: (value: Moment) => number;
+  getDaysInMonth: (value: Moment) => number;
+  setYear: (value: Moment, year: number) => defaultJMoment.Moment;
+  setMonth: (value: Moment, month: number) => defaultJMoment.Moment;
+  setDate: (value: Moment, date: number) => defaultJMoment.Moment;
+  getWeekNumber: (value: Moment) => number;
+}

package/modern/AdapterMomentJalaali/AdapterMomentJalaali.js

@@ -84,10 +84,8 @@ const defaultFormats = {
   shortDate: 'jD jMMM',
   normalDate: 'dddd, jD jMMM',
   normalDateWithWeekday: 'DD MMMM',
-  fullTime: 'LT',
   fullTime12h: 'hh:mm A',
   fullTime24h: 'HH:mm',
-  keyboardDateTime: 'jYYYY/jMM/jDD LT',
   keyboardDateTime12h: 'jYYYY/jMM/jDD hh:mm A',
   keyboardDateTime24h: 'jYYYY/jMM/jDD HH:mm'
 };

package/modern/AdapterMomentJalaali/index.d.ts

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

package/modern/DateCalendar/DateCalendar.d.ts

@@ -0,0 +1,18 @@
+import * as React from 'react';
+import { DateCalendarProps } from "./DateCalendar.types.js";
+type DateCalendarComponent = ((props: DateCalendarProps & React.RefAttributes<HTMLDivElement>) => React.JSX.Element) & {
+  propTypes?: any;
+};
+/**
+ * Demos:
+ *
+ * - [DatePicker](https://mui.com/x/react-date-pickers/date-picker/)
+ * - [DateCalendar](https://mui.com/x/react-date-pickers/date-calendar/)
+ * - [Validation](https://mui.com/x/react-date-pickers/validation/)
+ *
+ * API:
+ *
+ * - [DateCalendar API](https://mui.com/x/api/date-pickers/date-calendar/)
+ */
+export declare const DateCalendar: DateCalendarComponent;
+export {};

package/modern/DateCalendar/DateCalendar.js

@@ -19,9 +19,9 @@ import { useViews } from "../internals/hooks/useViews.js";
 import { PickersCalendarHeader } from "../PickersCalendarHeader/index.js";
 import { findClosestEnabledDate, applyDefaultDate, mergeDateAndTime } from "../internals/utils/date-utils.js";
 import { PickerViewRoot } from "../internals/components/PickerViewRoot/index.js";
-import { useDefaultReduceAnimations } from "../internals/hooks/useDefaultReduceAnimations.js";
+import { useReduceAnimations } from "../internals/hooks/useReduceAnimations.js";
 import { getDateCalendarUtilityClass } from "./dateCalendarClasses.js";
-import { useControlledValueWithTimezone } from "../internals/hooks/useValueWithTimezone.js";
+import { useControlledValue } from "../internals/hooks/useControlledValue.js";
 import { singleItemValueManager } from "../internals/utils/valueManagers.js";
 import { VIEW_HEIGHT } from "../internals/constants/dimensions.js";
 import { usePickerPrivateContext } from "../internals/hooks/usePickerPrivateContext.js";
@@ -36,18 +36,18 @@ const useUtilityClasses = classes => {
 function useDateCalendarDefaultizedProps(props, name) {
   const utils = useUtils();
   const defaultDates = useDefaultDates();
-  const defaultReduceAnimations = useDefaultReduceAnimations();
   const themeProps = useThemeProps({
     props,
     name
   });
+  const reduceAnimations = useReduceAnimations(themeProps.reduceAnimations);
   return _extends({}, themeProps, {
     loading: themeProps.loading ?? false,
     disablePast: themeProps.disablePast ?? false,
     disableFuture: themeProps.disableFuture ?? false,
     openTo: themeProps.openTo ?? 'day',
     views: themeProps.views ?? ['year', 'day'],
-    reduceAnimations: themeProps.reduceAnimations ?? defaultReduceAnimations,
+    reduceAnimations,
     renderLoading: themeProps.renderLoading ?? (() => /*#__PURE__*/_jsx("span", {
       children: "..."
     })),
@@ -96,7 +96,6 @@ export const DateCalendar = /*#__PURE__*/React.forwardRef(function DateCalendar(
       disableFuture,
       disablePast,
       onChange,
-      onYearChange,
       onMonthChange,
       reduceAnimations,
       shouldDisableDate,
@@ -112,7 +111,7 @@ export const DateCalendar = /*#__PURE__*/React.forwardRef(function DateCalendar(
       minDate,
       maxDate,
       disableHighlightToday,
-      focusedView: inFocusedView,
+      focusedView: focusedViewProp,
       onFocusedViewChange,
       showDaysOutsideCurrentMonth,
       fixedWeekNumber,
@@ -132,7 +131,7 @@ export const DateCalendar = /*#__PURE__*/React.forwardRef(function DateCalendar(
     value,
     handleValueChange,
     timezone
-  } = useControlledValueWithTimezone({
+  } = useControlledValue({
     name: 'DateCalendar',
     timezone: timezoneProp,
     value: valueProp,
@@ -155,15 +154,13 @@ export const DateCalendar = /*#__PURE__*/React.forwardRef(function DateCalendar(
     onChange: handleValueChange,
     onViewChange,
     autoFocus,
-    focusedView: inFocusedView,
+    focusedView: focusedViewProp,
     onFocusedViewChange
   });
   const {
     referenceDate,
     calendarState,
-    changeFocusedDay,
-    changeMonth,
-    handleChangeMonth,
+    setVisibleDate,
     isDateDisabled,
     onMonthSwitchingAnimationEnd
   } = useCalendarState({
@@ -176,7 +173,13 @@ export const DateCalendar = /*#__PURE__*/React.forwardRef(function DateCalendar(
     shouldDisableDate,
     disablePast,
     disableFuture,
-    timezone
+    timezone,
+    getCurrentMonthFromVisibleDate: (visibleDate, prevMonth) => {
+      if (utils.isSameMonth(visibleDate, prevMonth)) {
+        return prevMonth;
+      }
+      return utils.startOfMonth(visibleDate);
+    }
   });
 
   // When disabled, limit the view to the selected date
@@ -193,9 +196,9 @@ export const DateCalendar = /*#__PURE__*/React.forwardRef(function DateCalendar(
       view,
       currentMonth: calendarState.currentMonth,
       onViewChange: setView,
-      onMonthChange: (newMonth, direction) => handleChangeMonth({
-        newMonth,
-        direction
+      onMonthChange: month => setVisibleDate({
+        target: month,
+        reason: 'header-navigation'
       }),
       minDate: minDateWithDisabled,
       maxDate: maxDateWithDisabled,
@@ -223,12 +226,17 @@ export const DateCalendar = /*#__PURE__*/React.forwardRef(function DateCalendar(
     }) : newDate;
     if (closestEnabledDate) {
       setValueAndGoToNextView(closestEnabledDate, 'finish');
-      onMonthChange?.(startOfMonth);
+      setVisibleDate({
+        target: closestEnabledDate,
+        reason: 'cell-interaction'
+      });
     } else {
       goToNextView();
-      changeMonth(startOfMonth);
+      setVisibleDate({
+        target: startOfMonth,
+        reason: 'cell-interaction'
+      });
     }
-    changeFocusedDay(closestEnabledDate, true);
   });
   const handleDateYearChange = useEventCallback(newDate => {
     const startOfYear = utils.startOfYear(newDate);
@@ -245,12 +253,17 @@ export const DateCalendar = /*#__PURE__*/React.forwardRef(function DateCalendar(
     }) : newDate;
     if (closestEnabledDate) {
       setValueAndGoToNextView(closestEnabledDate, 'finish');
-      onYearChange?.(closestEnabledDate);
+      setVisibleDate({
+        target: closestEnabledDate,
+        reason: 'cell-interaction'
+      });
     } else {
       goToNextView();
-      changeMonth(startOfYear);
+      setVisibleDate({
+        target: startOfYear,
+        reason: 'cell-interaction'
+      });
     }
-    changeFocusedDay(closestEnabledDate, true);
   });
   const handleSelectedDayChange = useEventCallback(day => {
     if (day) {
@@ -261,7 +274,10 @@ export const DateCalendar = /*#__PURE__*/React.forwardRef(function DateCalendar(
   });
   React.useEffect(() => {
     if (utils.isValid(value)) {
-      changeMonth(value);
+      setVisibleDate({
+        target: value,
+        reason: 'controlled-value-change'
+      });
     }
   }, [value]); // eslint-disable-line
 
@@ -328,14 +344,17 @@ export const DateCalendar = /*#__PURE__*/React.forwardRef(function DateCalendar(
           referenceDate: referenceDate
         })), view === 'day' && /*#__PURE__*/_jsx(DayCalendar, _extends({}, calendarState, baseDateValidationProps, commonViewProps, {
           onMonthSwitchingAnimationEnd: onMonthSwitchingAnimationEnd,
-          onFocusedDayChange: changeFocusedDay,
+          hasFocus: hasFocus,
+          onFocusedDayChange: focusedDate => setVisibleDate({
+            target: focusedDate,
+            reason: 'cell-interaction'
+          }),
           reduceAnimations: reduceAnimations,
           selectedDays: selectedDays,
           onSelectedDaysChange: handleSelectedDayChange,
           shouldDisableDate: shouldDisableDate,
           shouldDisableMonth: shouldDisableMonth,
           shouldDisableYear: shouldDisableYear,
-          hasFocus: hasFocus,
           onFocusedViewChange: isViewFocused => setFocusedView('day', isViewFocused),
           showDaysOutsideCurrentMonth: showDaysOutsideCurrentMonth,
           fixedWeekNumber: fixedWeekNumber,

package/modern/DateCalendar/DateCalendar.types.d.ts

@@ -0,0 +1,87 @@
+import * as React from 'react';
+import { SxProps } from '@mui/system';
+import { Theme } from '@mui/material/styles';
+import { SlotComponentProps } from '@mui/utils';
+import { DefaultizedProps } from '@mui/x-internals/types';
+import { PickersCalendarHeader, PickersCalendarHeaderProps, PickersCalendarHeaderSlots, PickersCalendarHeaderSlotProps } from "../PickersCalendarHeader/index.js";
+import { DayCalendarSlots, DayCalendarSlotProps, ExportedDayCalendarProps } from "./DayCalendar.js";
+import { DateCalendarClasses } from "./dateCalendarClasses.js";
+import { BaseDateValidationProps } from "../internals/models/validation.js";
+import { ExportedUseViewsOptions } from "../internals/hooks/useViews.js";
+import { DateView, PickerOwnerState, PickerValidDate, TimezoneProps } from "../models/index.js";
+import { ExportedYearCalendarProps, YearCalendarSlots, YearCalendarSlotProps } from "../YearCalendar/YearCalendar.types.js";
+import { ExportedMonthCalendarProps, MonthCalendarSlots, MonthCalendarSlotProps } from "../MonthCalendar/MonthCalendar.types.js";
+import { ExportedValidateDateProps } from "../validation/validateDate.js";
+import { FormProps } from "../internals/models/formProps.js";
+import { PickerValue } from "../internals/models/index.js";
+export interface DateCalendarSlots extends PickersCalendarHeaderSlots, DayCalendarSlots, MonthCalendarSlots, YearCalendarSlots {
+  /**
+   * Custom component for calendar header.
+   * Check the [PickersCalendarHeader](https://mui.com/x/api/date-pickers/pickers-calendar-header/) component.
+   * @default PickersCalendarHeader
+   */
+  calendarHeader?: React.ElementType<PickersCalendarHeaderProps>;
+}
+export interface DateCalendarSlotProps extends PickersCalendarHeaderSlotProps, DayCalendarSlotProps, MonthCalendarSlotProps, YearCalendarSlotProps {
+  calendarHeader?: SlotComponentProps<typeof PickersCalendarHeader, {}, PickerOwnerState>;
+}
+export interface ExportedDateCalendarProps extends ExportedDayCalendarProps, ExportedMonthCalendarProps, ExportedYearCalendarProps, ExportedValidateDateProps, TimezoneProps, FormProps {
+  /**
+   * If `true`, disable heavy animations.
+   * @default `@media(prefers-reduced-motion: reduce)` || `navigator.userAgent` matches Android <10 or iOS <13
+   */
+  reduceAnimations?: boolean;
+  /**
+   * Component displaying when passed `loading` true.
+   * @returns {React.ReactNode} The node to render when loading.
+   * @default () => <span>...</span>
+   */
+  renderLoading?: () => React.ReactNode;
+  /**
+   * Callback fired on year change.
+   * @param {PickerValidDate} year The new year.
+   */
+  onYearChange?: (year: PickerValidDate) => void;
+  /**
+   * Callback fired on month change.
+   * @param {PickerValidDate} month The new month.
+   */
+  onMonthChange?: (month: PickerValidDate) => void;
+}
+export interface DateCalendarProps extends ExportedDateCalendarProps, ExportedUseViewsOptions<PickerValue, DateView> {
+  /**
+   * The selected value.
+   * Used when the component is controlled.
+   */
+  value?: PickerValidDate | null;
+  /**
+   * The default selected value.
+   * Used when the component is not controlled.
+   */
+  defaultValue?: PickerValidDate | null;
+  /**
+   * The date used to generate the new value when both `value` and `defaultValue` are empty.
+   * @default The closest valid date using the validation props, except callbacks such as `shouldDisableDate`.
+   */
+  referenceDate?: PickerValidDate;
+  className?: string;
+  /**
+   * Override or extend the styles applied to the component.
+   */
+  classes?: Partial<DateCalendarClasses>;
+  /**
+   * The system prop that allows defining system overrides as well as additional CSS styles.
+   */
+  sx?: SxProps<Theme>;
+  /**
+   * Overridable component slots.
+   * @default {}
+   */
+  slots?: DateCalendarSlots;
+  /**
+   * The props used for each component slot.
+   * @default {}
+   */
+  slotProps?: DateCalendarSlotProps;
+}
+export type DateCalendarDefaultizedProps = DefaultizedProps<DateCalendarProps, 'views' | 'openTo' | 'loading' | 'reduceAnimations' | 'renderLoading' | keyof BaseDateValidationProps>;

package/modern/DateCalendar/DayCalendar.d.ts

@@ -0,0 +1,85 @@
+import * as React from 'react';
+import { DefaultizedProps, SlotComponentPropsFromProps } from '@mui/x-internals/types';
+import { PickerDayOwnerState, PickersDayProps } from "../PickersDay/index.js";
+import { ExportedPickersDayProps } from "../PickersDay/PickersDay.types.js";
+import { PickerOnChangeFn } from "../internals/hooks/useViews.js";
+import { SlideDirection, SlideTransitionProps } from "./PickersSlideTransition.js";
+import { BaseDateValidationProps, DayValidationProps, MonthValidationProps, YearValidationProps } from "../internals/models/validation.js";
+import { DayCalendarClasses } from "./dayCalendarClasses.js";
+import { PickerValidDate, TimezoneProps } from "../models/index.js";
+import { FormProps } from "../internals/models/formProps.js";
+export interface DayCalendarSlots {
+  /**
+   * Custom component for day.
+   * Check the [PickersDay](https://mui.com/x/api/date-pickers/pickers-day/) component.
+   * @default PickersDay
+   */
+  day?: React.ElementType<PickersDayProps>;
+}
+export interface DayCalendarSlotProps {
+  day?: SlotComponentPropsFromProps<PickersDayProps, {}, PickerDayOwnerState>;
+}
+export interface ExportedDayCalendarProps extends ExportedPickersDayProps {
+  /**
+   * If `true`, calls `renderLoading` instead of rendering the day calendar.
+   * Can be used to preload information and show it in calendar.
+   * @default false
+   */
+  loading?: boolean;
+  /**
+   * Component rendered on the "day" view when `props.loading` is true.
+   * @returns {React.ReactNode} The node to render when loading.
+   * @default () => "..."
+   */
+  renderLoading?: () => React.ReactNode;
+  /**
+   * Formats the day of week displayed in the calendar header.
+   * @param {PickerValidDate} date The date of the day of week provided by the adapter.
+   * @returns {string} The name to display.
+   * @default (date: PickerValidDate) => adapter.format(date, 'weekdayShort').charAt(0).toUpperCase()
+   */
+  dayOfWeekFormatter?: (date: PickerValidDate) => string;
+  /**
+   * If `true`, the week number will be display in the calendar.
+   */
+  displayWeekNumber?: boolean;
+  /**
+   * The day view will show as many weeks as needed after the end of the current month to match this value.
+   * Put it to 6 to have a fixed number of weeks in Gregorian calendars
+   */
+  fixedWeekNumber?: number;
+}
+export interface DayCalendarProps extends ExportedDayCalendarProps, DayValidationProps, MonthValidationProps, YearValidationProps, Required<BaseDateValidationProps>, DefaultizedProps<TimezoneProps, 'timezone'>, FormProps {
+  className?: string;
+  currentMonth: PickerValidDate;
+  selectedDays: (PickerValidDate | null)[];
+  onSelectedDaysChange: PickerOnChangeFn;
+  focusedDay: PickerValidDate | null;
+  isMonthSwitchingAnimating: boolean;
+  onFocusedDayChange: (newFocusedDay: PickerValidDate) => void;
+  onMonthSwitchingAnimationEnd: () => void;
+  reduceAnimations: boolean;
+  slideDirection: SlideDirection;
+  TransitionProps?: Partial<SlideTransitionProps>;
+  hasFocus: boolean;
+  onFocusedViewChange?: (newHasFocus: boolean) => void;
+  gridLabelId?: string;
+  /**
+   * Override or extend the styles applied to the component.
+   */
+  classes?: Partial<DayCalendarClasses>;
+  /**
+   * Overridable component slots.
+   * @default {}
+   */
+  slots?: DayCalendarSlots;
+  /**
+   * The props used for each component slot.
+   * @default {}
+   */
+  slotProps?: DayCalendarSlotProps;
+}
+/**
+ * @ignore - do not document.
+ */
+export declare function DayCalendar(inProps: DayCalendarProps): React.JSX.Element;