@mui/x-date-pickers 5.0.0-alpha.0

package/modern/CalendarPicker/CalendarPicker.js

@@ -0,0 +1,390 @@
+import _extends from "@babel/runtime/helpers/esm/extends";
+import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
+const _excluded = ["autoFocus", "onViewChange", "date", "disableFuture", "disablePast", "defaultCalendarMonth", "loading", "maxDate", "minDate", "onChange", "onMonthChange", "reduceAnimations", "renderLoading", "shouldDisableDate", "shouldDisableYear", "view", "views", "openTo", "className"];
+import * as React from 'react';
+import PropTypes from 'prop-types';
+import clsx from 'clsx';
+import { styled, useThemeProps } from '@mui/material/styles';
+import { unstable_composeClasses as composeClasses } from '@mui/material';
+import { MonthPicker } from '../MonthPicker/MonthPicker';
+import { useCalendarState } from './useCalendarState';
+import { useDefaultDates, useUtils } from '../internals/hooks/useUtils';
+import { PickersFadeTransitionGroup } from './PickersFadeTransitionGroup';
+import { DayPicker } from './DayPicker';
+import { useViews } from '../internals/hooks/useViews';
+import { PickersCalendarHeader } from './PickersCalendarHeader';
+import { YearPicker } from '../YearPicker/YearPicker';
+import { findClosestEnabledDate } from '../internals/utils/date-utils';
+import { PickerViewRoot } from '../internals/components/PickerViewRoot';
+import { defaultReduceAnimations } from '../internals/utils/defaultReduceAnimations';
+import { getCalendarPickerUtilityClass } from './calendarPickerClasses';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+
+const useUtilityClasses = ownerState => {
+  const {
+    classes
+  } = ownerState;
+  const slots = {
+    root: ['root'],
+    viewTransitionContainer: ['viewTransitionContainer']
+  };
+  return composeClasses(slots, getCalendarPickerUtilityClass, classes);
+};
+
+const CalendarPickerRoot = styled(PickerViewRoot, {
+  name: 'MuiCalendarPicker',
+  slot: 'Root',
+  overridesResolver: (props, styles) => styles.root
+})({
+  display: 'flex',
+  flexDirection: 'column'
+});
+const CalendarPickerViewTransitionContainer = styled(PickersFadeTransitionGroup, {
+  name: 'MuiCalendarPicker',
+  slot: 'ViewTransitionContainer',
+  overridesResolver: (props, styles) => styles.viewTransitionContainer
+})({
+  overflowY: 'auto'
+});
+
+/**
+ *
+ * Demos:
+ *
+ * - [Date Picker](https://mui.com/components/x/react-date-pickers/date-picker/)
+ *
+ * API:
+ *
+ * - [CalendarPicker API](https://mui.com/api/calendar-picker/)
+ */
+const CalendarPicker = /*#__PURE__*/React.forwardRef(function CalendarPicker(inProps, ref) {
+  const props = useThemeProps({
+    props: inProps,
+    name: 'MuiCalendarPicker'
+  });
+
+  const {
+    autoFocus,
+    onViewChange,
+    date,
+    disableFuture = false,
+    disablePast = false,
+    defaultCalendarMonth,
+    loading = false,
+    maxDate: maxDateProp,
+    minDate: minDateProp,
+    onChange,
+    onMonthChange,
+    reduceAnimations = defaultReduceAnimations,
+    renderLoading = () => /*#__PURE__*/_jsx("span", {
+      children: "..."
+    }),
+    shouldDisableDate,
+    shouldDisableYear,
+    view,
+    views = ['year', 'day'],
+    openTo = 'day',
+    className
+  } = props,
+        other = _objectWithoutPropertiesLoose(props, _excluded);
+
+  const utils = useUtils();
+  const defaultDates = useDefaultDates();
+  const minDate = minDateProp ?? defaultDates.minDate;
+  const maxDate = maxDateProp ?? defaultDates.maxDate;
+  const {
+    openView,
+    setOpenView
+  } = useViews({
+    view,
+    views,
+    openTo,
+    onChange,
+    onViewChange
+  });
+  const {
+    calendarState,
+    changeFocusedDay,
+    changeMonth,
+    isDateDisabled,
+    handleChangeMonth,
+    onMonthSwitchingAnimationEnd
+  } = useCalendarState({
+    date,
+    defaultCalendarMonth,
+    reduceAnimations,
+    onMonthChange,
+    minDate,
+    maxDate,
+    shouldDisableDate,
+    disablePast,
+    disableFuture
+  });
+  React.useEffect(() => {
+    if (date && isDateDisabled(date)) {
+      const closestEnabledDate = findClosestEnabledDate({
+        utils,
+        date,
+        minDate,
+        maxDate,
+        disablePast,
+        disableFuture,
+        shouldDisableDate: isDateDisabled
+      });
+      onChange(closestEnabledDate, 'partial');
+    } // This call is too expensive to run it on each prop change.
+    // So just ensure that we are not rendering disabled as selected on mount.
+
+  }, []); // eslint-disable-line
+
+  React.useEffect(() => {
+    if (date) {
+      changeMonth(date);
+    }
+  }, [date]); // eslint-disable-line
+
+  const ownerState = props;
+  const classes = useUtilityClasses(ownerState);
+  const monthPickerProps = {
+    className,
+    date,
+    disabled: other.disabled,
+    disablePast,
+    disableFuture,
+    onChange,
+    minDate,
+    maxDate,
+    onMonthChange,
+    readOnly: other.readOnly
+  };
+  return /*#__PURE__*/_jsxs(CalendarPickerRoot, {
+    ref: ref,
+    className: clsx(classes.root, className),
+    ownerState: ownerState,
+    children: [/*#__PURE__*/_jsx(PickersCalendarHeader, _extends({}, other, {
+      views: views,
+      openView: openView,
+      currentMonth: calendarState.currentMonth,
+      onViewChange: setOpenView,
+      onMonthChange: (newMonth, direction) => handleChangeMonth({
+        newMonth,
+        direction
+      }),
+      minDate: minDate,
+      maxDate: maxDate,
+      disablePast: disablePast,
+      disableFuture: disableFuture,
+      reduceAnimations: reduceAnimations
+    })), /*#__PURE__*/_jsx(CalendarPickerViewTransitionContainer, {
+      reduceAnimations: reduceAnimations,
+      className: classes.viewTransitionContainer,
+      transKey: openView,
+      ownerState: ownerState,
+      children: /*#__PURE__*/_jsxs("div", {
+        children: [openView === 'year' && /*#__PURE__*/_jsx(YearPicker, _extends({}, other, {
+          autoFocus: autoFocus,
+          date: date,
+          onChange: onChange,
+          minDate: minDate,
+          maxDate: maxDate,
+          disableFuture: disableFuture,
+          disablePast: disablePast,
+          isDateDisabled: isDateDisabled,
+          shouldDisableYear: shouldDisableYear,
+          onFocusedDayChange: changeFocusedDay
+        })), openView === 'month' && /*#__PURE__*/_jsx(MonthPicker, _extends({}, monthPickerProps)), openView === 'day' && /*#__PURE__*/_jsx(DayPicker, _extends({}, other, calendarState, {
+          autoFocus: autoFocus,
+          onMonthSwitchingAnimationEnd: onMonthSwitchingAnimationEnd,
+          onFocusedDayChange: changeFocusedDay,
+          reduceAnimations: reduceAnimations,
+          date: date,
+          onChange: onChange,
+          isDateDisabled: isDateDisabled,
+          loading: loading,
+          renderLoading: renderLoading
+        }))]
+      })
+    })]
+  });
+});
+process.env.NODE_ENV !== "production" ? CalendarPicker.propTypes = {
+  // ----------------------------- Warning --------------------------------
+  // | These PropTypes are generated from the TypeScript type definitions |
+  // | To update them edit the TypeScript types and run "yarn proptypes"  |
+  // ----------------------------------------------------------------------
+
+  /**
+   * If `true`, `onChange` is fired on click even if the same date is selected.
+   * @default false
+   */
+  allowSameDateSelection: PropTypes.bool,
+  autoFocus: PropTypes.bool,
+  classes: PropTypes.object,
+  className: PropTypes.string,
+
+  /**
+   * The components used for each slot.
+   * Either a string to use a HTML element or a component.
+   * @default {}
+   */
+  components: PropTypes.object,
+
+  /**
+   * The props used for each slot inside.
+   * @default {}
+   */
+  componentsProps: PropTypes.object,
+  date: PropTypes.any,
+
+  /**
+   * Default calendar month displayed when `value={null}`.
+   */
+  defaultCalendarMonth: PropTypes.any,
+
+  /**
+   * If `true`, the picker and text field are disabled.
+   * @default false
+   */
+  disabled: PropTypes.bool,
+
+  /**
+   * @default false
+   */
+  disableFuture: PropTypes.bool,
+
+  /**
+   * If `true`, todays date is rendering without highlighting with circle.
+   * @default false
+   */
+  disableHighlightToday: PropTypes.bool,
+
+  /**
+   * @default false
+   */
+  disablePast: PropTypes.bool,
+
+  /**
+   * Get aria-label text for switching between views button.
+   * @param {CalendarPickerView} currentView The view from which we want to get the button text.
+   * @returns {string} The label of the view.
+   */
+  getViewSwitchingButtonText: PropTypes.func,
+
+  /**
+   * Left arrow icon aria-label text.
+   */
+  leftArrowButtonText: PropTypes.string,
+
+  /**
+   * If `true` renders `LoadingComponent` in calendar instead of calendar view.
+   * Can be used to preload information and show it in calendar.
+   * @default false
+   */
+  loading: PropTypes.bool,
+
+  /**
+   * Max selectable date. @DateIOType
+   */
+  maxDate: PropTypes.any,
+
+  /**
+   * Min selectable date. @DateIOType
+   */
+  minDate: PropTypes.any,
+
+  /**
+   * Callback fired on date change
+   */
+  onChange: PropTypes.func.isRequired,
+
+  /**
+   * Callback firing on month change. @DateIOType
+   * @param {TDate} month The new month.
+   */
+  onMonthChange: PropTypes.func,
+
+  /**
+   * Callback fired on view change.
+   * @param {CalendarPickerView} view The new view.
+   */
+  onViewChange: PropTypes.func,
+
+  /**
+   * Callback firing on year change @DateIOType.
+   * @param {TDate} year The new year.
+   */
+  onYearChange: PropTypes.func,
+
+  /**
+   * Initially open view.
+   * @default 'day'
+   */
+  openTo: PropTypes.oneOf(['day', 'month', 'year']),
+
+  /**
+   * Make picker read only.
+   * @default false
+   */
+  readOnly: PropTypes.bool,
+
+  /**
+   * Disable heavy animations.
+   * @default typeof navigator !== 'undefined' && /(android)/i.test(navigator.userAgent)
+   */
+  reduceAnimations: PropTypes.bool,
+
+  /**
+   * Custom renderer for day. Check the [PickersDay](https://mui.com/api/pickers-day/) component.
+   * @param {TDate} day The day to render.
+   * @param {Array<TDate | null>} selectedDates The dates currently selected.
+   * @param {PickersDayProps<TDate>} pickersDayProps The props of the day to render.
+   * @returns {JSX.Element} The element representing the day.
+   */
+  renderDay: PropTypes.func,
+
+  /**
+   * Component displaying when passed `loading` true.
+   * @returns {React.ReactNode} The node to render when loading.
+   * @default () => <span data-mui-test="loading-progress">...</span>
+   */
+  renderLoading: PropTypes.func,
+
+  /**
+   * Right arrow icon aria-label text.
+   */
+  rightArrowButtonText: PropTypes.string,
+
+  /**
+   * Disable specific date. @DateIOType
+   * @param {TDate} day The date to check.
+   * @returns {boolean} If `true` the day will be disabled.
+   */
+  shouldDisableDate: PropTypes.func,
+
+  /**
+   * Disable specific years dynamically.
+   * Works like `shouldDisableDate` but for year selection view @DateIOType.
+   * @param {TDate} year The year to test.
+   * @returns {boolean} Return `true` if the year should be disabled.
+   */
+  shouldDisableYear: PropTypes.func,
+
+  /**
+   * If `true`, days that have `outsideCurrentMonth={true}` are displayed.
+   * @default false
+   */
+  showDaysOutsideCurrentMonth: PropTypes.bool,
+
+  /**
+   * Controlled open view.
+   */
+  view: PropTypes.oneOf(['day', 'month', 'year']),
+
+  /**
+   * Views for calendar picker.
+   * @default ['year', 'day']
+   */
+  views: PropTypes.arrayOf(PropTypes.oneOf(['day', 'month', 'year']).isRequired)
+} : void 0;
+export { CalendarPicker };

package/modern/CalendarPicker/DayPicker.js

@@ -0,0 +1,140 @@
+import _extends from "@babel/runtime/helpers/esm/extends";
+import * as React from 'react';
+import Typography from '@mui/material/Typography';
+import { styled } from '@mui/material/styles';
+import { PickersDay } from '../PickersDay/PickersDay';
+import { useUtils, useNow } from '../internals/hooks/useUtils';
+import { DAY_SIZE, DAY_MARGIN } from '../internals/constants/dimensions';
+import { PickersSlideTransition } from './PickersSlideTransition';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+const weeksContainerHeight = (DAY_SIZE + DAY_MARGIN * 4) * 6;
+const PickersCalendarDayHeader = styled('div')({
+  display: 'flex',
+  justifyContent: 'center',
+  alignItems: 'center'
+});
+const PickersCalendarWeekDayLabel = styled(Typography)(({
+  theme
+}) => ({
+  width: 36,
+  height: 40,
+  margin: '0 2px',
+  textAlign: 'center',
+  display: 'flex',
+  justifyContent: 'center',
+  alignItems: 'center',
+  color: theme.palette.text.secondary
+}));
+const PickersCalendarLoadingContainer = styled('div')({
+  display: 'flex',
+  justifyContent: 'center',
+  alignItems: 'center',
+  minHeight: weeksContainerHeight
+});
+const PickersCalendarSlideTransition = styled(PickersSlideTransition)({
+  minHeight: weeksContainerHeight
+});
+const PickersCalendarWeekContainer = styled('div')({
+  overflow: 'hidden'
+});
+const PickersCalendarWeek = styled('div')({
+  margin: `${DAY_MARGIN}px 0`,
+  display: 'flex',
+  justifyContent: 'center'
+});
+/**
+ * @ignore - do not document.
+ */
+
+export function DayPicker(props) {
+  const {
+    allowSameDateSelection,
+    autoFocus,
+    onFocusedDayChange: changeFocusedDay,
+    className,
+    currentMonth,
+    date,
+    disabled,
+    disableHighlightToday,
+    focusedDay,
+    isDateDisabled,
+    isMonthSwitchingAnimating,
+    loading,
+    onChange,
+    onMonthSwitchingAnimationEnd,
+    readOnly,
+    reduceAnimations,
+    renderDay,
+    renderLoading = () => /*#__PURE__*/_jsx("span", {
+      children: "..."
+    }),
+    showDaysOutsideCurrentMonth,
+    slideDirection,
+    TransitionProps
+  } = props;
+  const now = useNow();
+  const utils = useUtils();
+  const handleDaySelect = React.useCallback((day, isFinish = 'finish') => {
+    if (readOnly) {
+      return;
+    } // TODO possibly buggy line figure out and add tests
+
+
+    const finalDate = Array.isArray(date) ? day : utils.mergeDateAndTime(day, date || now);
+    onChange(finalDate, isFinish);
+  }, [date, now, onChange, readOnly, utils]);
+  const currentMonthNumber = utils.getMonth(currentMonth);
+  const selectedDates = (Array.isArray(date) ? date : [date]).filter(Boolean).map(selectedDateItem => selectedDateItem && utils.startOfDay(selectedDateItem)); // need a new ref whenever the `key` of the transition changes: http://reactcommunity.org/react-transition-group/transition/#Transition-prop-nodeRef.
+
+  const transitionKey = currentMonthNumber; // eslint-disable-next-line react-hooks/exhaustive-deps
+
+  const slideNodeRef = React.useMemo(() => /*#__PURE__*/React.createRef(), [transitionKey]);
+  return /*#__PURE__*/_jsxs(React.Fragment, {
+    children: [/*#__PURE__*/_jsx(PickersCalendarDayHeader, {
+      children: utils.getWeekdays().map((day, i) => /*#__PURE__*/_jsx(PickersCalendarWeekDayLabel, {
+        "aria-hidden": true,
+        variant: "caption",
+        children: day.charAt(0).toUpperCase()
+      }, day + i.toString()))
+    }), loading ? /*#__PURE__*/_jsx(PickersCalendarLoadingContainer, {
+      children: renderLoading()
+    }) : /*#__PURE__*/_jsx(PickersCalendarSlideTransition, _extends({
+      transKey: transitionKey,
+      onExited: onMonthSwitchingAnimationEnd,
+      reduceAnimations: reduceAnimations,
+      slideDirection: slideDirection,
+      className: className
+    }, TransitionProps, {
+      nodeRef: slideNodeRef,
+      children: /*#__PURE__*/_jsx(PickersCalendarWeekContainer, {
+        ref: slideNodeRef,
+        role: "grid",
+        children: utils.getWeekArray(currentMonth).map(week => /*#__PURE__*/_jsx(PickersCalendarWeek, {
+          role: "row",
+          children: week.map(day => {
+            const pickersDayProps = {
+              key: day?.toString(),
+              day,
+              isAnimating: isMonthSwitchingAnimating,
+              disabled: disabled || isDateDisabled(day),
+              allowSameDateSelection,
+              autoFocus: autoFocus && focusedDay !== null && utils.isSameDay(day, focusedDay),
+              today: utils.isSameDay(day, now),
+              outsideCurrentMonth: utils.getMonth(day) !== currentMonthNumber,
+              selected: selectedDates.some(selectedDate => selectedDate && utils.isSameDay(selectedDate, day)),
+              disableHighlightToday,
+              showDaysOutsideCurrentMonth,
+              onDayFocus: changeFocusedDay,
+              onDaySelect: handleDaySelect
+            };
+            return renderDay ? renderDay(day, selectedDates, pickersDayProps) : /*#__PURE__*/_jsx("div", {
+              role: "cell",
+              children: /*#__PURE__*/_jsx(PickersDay, _extends({}, pickersDayProps))
+            }, pickersDayProps.key);
+          })
+        }, `week-${week[0]}`))
+      })
+    }))]
+  });
+}

package/modern/CalendarPicker/PickersCalendarHeader.js

@@ -0,0 +1,162 @@
+import _extends from "@babel/runtime/helpers/esm/extends";
+import * as React from 'react';
+import Fade from '@mui/material/Fade';
+import { styled } from '@mui/material/styles';
+import IconButton from '@mui/material/IconButton';
+import { useUtils } from '../internals/hooks/useUtils';
+import { PickersFadeTransitionGroup } from './PickersFadeTransitionGroup';
+import { ArrowDropDown } from '../internals/components/icons';
+import { PickersArrowSwitcher } from '../internals/components/PickersArrowSwitcher';
+import { usePreviousMonthDisabled, useNextMonthDisabled } from '../internals/hooks/date-helpers-hooks';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+const PickersCalendarHeaderRoot = styled('div')({
+  display: 'flex',
+  alignItems: 'center',
+  marginTop: 16,
+  marginBottom: 8,
+  paddingLeft: 24,
+  paddingRight: 12,
+  // prevent jumping in safari
+  maxHeight: 30,
+  minHeight: 30
+});
+const PickersCalendarHeaderLabel = styled('div')(({
+  theme
+}) => _extends({
+  display: 'flex',
+  maxHeight: 30,
+  overflow: 'hidden',
+  alignItems: 'center',
+  cursor: 'pointer',
+  marginRight: 'auto'
+}, theme.typography.body1, {
+  fontWeight: theme.typography.fontWeightMedium
+}));
+const PickersCalendarHeaderLabelItem = styled('div')({
+  marginRight: 6
+});
+const PickersCalendarHeaderSwitchViewButton = styled(IconButton)({
+  marginRight: 'auto'
+});
+const PickersCalendarHeaderSwitchView = styled(ArrowDropDown)(({
+  theme,
+  ownerState
+}) => _extends({
+  willChange: 'transform',
+  transition: theme.transitions.create('transform'),
+  transform: 'rotate(0deg)'
+}, ownerState.openView === 'year' && {
+  transform: 'rotate(180deg)'
+}));
+
+function getSwitchingViewAriaText(view) {
+  return view === 'year' ? 'year view is open, switch to calendar view' : 'calendar view is open, switch to year view';
+}
+/**
+ * @ignore - do not document.
+ */
+
+
+export function PickersCalendarHeader(props) {
+  const {
+    components = {},
+    componentsProps = {},
+    currentMonth: month,
+    disabled,
+    disableFuture,
+    disablePast,
+    getViewSwitchingButtonText = getSwitchingViewAriaText,
+    leftArrowButtonText = 'Previous month',
+    maxDate,
+    minDate,
+    onMonthChange,
+    onViewChange,
+    openView: currentView,
+    reduceAnimations,
+    rightArrowButtonText = 'Next month',
+    views
+  } = props;
+  const utils = useUtils();
+  const switchViewButtonProps = componentsProps.switchViewButton || {};
+
+  const selectNextMonth = () => onMonthChange(utils.getNextMonth(month), 'left');
+
+  const selectPreviousMonth = () => onMonthChange(utils.getPreviousMonth(month), 'right');
+
+  const isNextMonthDisabled = useNextMonthDisabled(month, {
+    disableFuture: disableFuture || disabled,
+    maxDate
+  });
+  const isPreviousMonthDisabled = usePreviousMonthDisabled(month, {
+    disablePast: disablePast || disabled,
+    minDate
+  });
+
+  const handleToggleView = () => {
+    if (views.length === 1 || !onViewChange || disabled) {
+      return;
+    }
+
+    if (views.length === 2) {
+      onViewChange(views.find(view => view !== currentView) || views[0]);
+    } else {
+      // switching only between first 2
+      const nextIndexToOpen = views.indexOf(currentView) !== 0 ? 0 : 1;
+      onViewChange(views[nextIndexToOpen]);
+    }
+  }; // No need to display more information
+
+
+  if (views.length === 1 && views[0] === 'year') {
+    return null;
+  }
+
+  const ownerState = props;
+  return /*#__PURE__*/_jsxs(PickersCalendarHeaderRoot, {
+    ownerState: ownerState,
+    children: [/*#__PURE__*/_jsxs(PickersCalendarHeaderLabel, {
+      role: "presentation",
+      onClick: handleToggleView,
+      ownerState: ownerState,
+      children: [/*#__PURE__*/_jsx(PickersFadeTransitionGroup, {
+        reduceAnimations: reduceAnimations,
+        transKey: utils.format(month, 'month'),
+        children: /*#__PURE__*/_jsx(PickersCalendarHeaderLabelItem, {
+          "aria-live": "polite",
+          ownerState: ownerState,
+          children: utils.format(month, 'month')
+        })
+      }), /*#__PURE__*/_jsx(PickersFadeTransitionGroup, {
+        reduceAnimations: reduceAnimations,
+        transKey: utils.format(month, 'year'),
+        children: /*#__PURE__*/_jsx(PickersCalendarHeaderLabelItem, {
+          "aria-live": "polite",
+          ownerState: ownerState,
+          children: utils.format(month, 'year')
+        })
+      }), views.length > 1 && !disabled && /*#__PURE__*/_jsx(PickersCalendarHeaderSwitchViewButton, _extends({
+        size: "small",
+        as: components.SwitchViewButton,
+        "aria-label": getViewSwitchingButtonText(currentView)
+      }, switchViewButtonProps, {
+        children: /*#__PURE__*/_jsx(PickersCalendarHeaderSwitchView, {
+          as: components.SwitchViewIcon,
+          ownerState: ownerState
+        })
+      }))]
+    }), /*#__PURE__*/_jsx(Fade, {
+      in: currentView === 'day',
+      children: /*#__PURE__*/_jsx(PickersArrowSwitcher, {
+        leftArrowButtonText: leftArrowButtonText,
+        rightArrowButtonText: rightArrowButtonText,
+        components: components,
+        componentsProps: componentsProps,
+        onLeftClick: selectPreviousMonth,
+        onRightClick: selectNextMonth,
+        isLeftDisabled: isPreviousMonthDisabled,
+        isRightDisabled: isNextMonthDisabled
+      })
+    })]
+  });
+}