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

package/legacy/DateTimePicker/DateTimePickerToolbar.js

@@ -0,0 +1,147 @@
+import _extends from "@babel/runtime/helpers/esm/extends";
+import _objectWithoutProperties from "@babel/runtime/helpers/esm/objectWithoutProperties";
+import _defineProperty from "@babel/runtime/helpers/esm/defineProperty";
+var _excluded = ["ampm", "date", "dateRangeIcon", "hideTabs", "isMobileKeyboardViewOpen", "onChange", "openView", "setOpenView", "timeIcon", "toggleMobileKeyboardView", "toolbarFormat", "toolbarPlaceholder", "toolbarTitle", "views"];
+import * as React from 'react';
+import { styled } from '@mui/material/styles';
+import { generateUtilityClasses } from '@mui/material';
+import { PickersToolbarText } from '../internals/components/PickersToolbarText';
+import { PickersToolbar } from '../internals/components/PickersToolbar';
+import { PickersToolbarButton } from '../internals/components/PickersToolbarButton';
+import { DateTimePickerTabs } from './DateTimePickerTabs';
+import { useUtils } from '../internals/hooks/useUtils';
+import { WrapperVariantContext } from '../internals/components/wrappers/WrapperVariantContext';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+var classes = generateUtilityClasses('PrivateDateTimePickerToolbar', ['penIcon']);
+var DateTimePickerToolbarRoot = styled(PickersToolbar)(_defineProperty({
+  paddingLeft: 16,
+  paddingRight: 16,
+  justifyContent: 'space-around'
+}, "& .".concat(classes.penIcon), {
+  position: 'absolute',
+  top: 8,
+  right: 8
+}));
+var DateTimePickerToolbarDateContainer = styled('div')({
+  display: 'flex',
+  flexDirection: 'column',
+  alignItems: 'flex-start'
+});
+var DateTimePickerToolbarTimeContainer = styled('div')({
+  display: 'flex'
+});
+var DateTimePickerToolbarSeparator = styled(PickersToolbarText)({
+  margin: '0 4px 0 2px',
+  cursor: 'default'
+});
+/**
+ * @ignore - internal component.
+ */
+
+export var DateTimePickerToolbar = function DateTimePickerToolbar(props) {
+  var ampm = props.ampm,
+      date = props.date,
+      dateRangeIcon = props.dateRangeIcon,
+      hideTabs = props.hideTabs,
+      isMobileKeyboardViewOpen = props.isMobileKeyboardViewOpen,
+      onChange = props.onChange,
+      openView = props.openView,
+      setOpenView = props.setOpenView,
+      timeIcon = props.timeIcon,
+      toggleMobileKeyboardView = props.toggleMobileKeyboardView,
+      toolbarFormat = props.toolbarFormat,
+      _props$toolbarPlaceho = props.toolbarPlaceholder,
+      toolbarPlaceholder = _props$toolbarPlaceho === void 0 ? '––' : _props$toolbarPlaceho,
+      _props$toolbarTitle = props.toolbarTitle,
+      toolbarTitle = _props$toolbarTitle === void 0 ? 'Select date & time' : _props$toolbarTitle,
+      views = props.views,
+      other = _objectWithoutProperties(props, _excluded);
+
+  var utils = useUtils();
+  var wrapperVariant = React.useContext(WrapperVariantContext);
+  var showTabs = wrapperVariant === 'desktop' ? true : !hideTabs && typeof window !== 'undefined' && window.innerHeight > 667;
+
+  var formatHours = function formatHours(time) {
+    return ampm ? utils.format(time, 'hours12h') : utils.format(time, 'hours24h');
+  };
+
+  var dateText = React.useMemo(function () {
+    if (!date) {
+      return toolbarPlaceholder;
+    }
+
+    if (toolbarFormat) {
+      return utils.formatByString(date, toolbarFormat);
+    }
+
+    return utils.format(date, 'shortDate');
+  }, [date, toolbarFormat, toolbarPlaceholder, utils]);
+  return /*#__PURE__*/_jsxs(React.Fragment, {
+    children: [wrapperVariant !== 'desktop' && /*#__PURE__*/_jsxs(DateTimePickerToolbarRoot, _extends({
+      toolbarTitle: toolbarTitle,
+      penIconClassName: classes.penIcon,
+      isMobileKeyboardViewOpen: isMobileKeyboardViewOpen,
+      toggleMobileKeyboardView: toggleMobileKeyboardView
+    }, other, {
+      isLandscape: false,
+      children: [/*#__PURE__*/_jsxs(DateTimePickerToolbarDateContainer, {
+        children: [views.includes('year') && /*#__PURE__*/_jsx(PickersToolbarButton, {
+          tabIndex: -1,
+          variant: "subtitle1",
+          onClick: function onClick() {
+            return setOpenView('year');
+          },
+          selected: openView === 'year',
+          value: date ? utils.format(date, 'year') : '–'
+        }), views.includes('day') && /*#__PURE__*/_jsx(PickersToolbarButton, {
+          tabIndex: -1,
+          variant: "h4",
+          onClick: function onClick() {
+            return setOpenView('day');
+          },
+          selected: openView === 'day',
+          value: dateText
+        })]
+      }), /*#__PURE__*/_jsxs(DateTimePickerToolbarTimeContainer, {
+        children: [views.includes('hours') && /*#__PURE__*/_jsx(PickersToolbarButton, {
+          variant: "h3",
+          onClick: function onClick() {
+            return setOpenView('hours');
+          },
+          selected: openView === 'hours',
+          value: date ? formatHours(date) : '--'
+        }), views.includes('minutes') && /*#__PURE__*/_jsxs(React.Fragment, {
+          children: [/*#__PURE__*/_jsx(DateTimePickerToolbarSeparator, {
+            variant: "h3",
+            value: ":"
+          }), /*#__PURE__*/_jsx(PickersToolbarButton, {
+            variant: "h3",
+            onClick: function onClick() {
+              return setOpenView('minutes');
+            },
+            selected: openView === 'minutes',
+            value: date ? utils.format(date, 'minutes') : '--'
+          })]
+        }), views.includes('seconds') && /*#__PURE__*/_jsxs(React.Fragment, {
+          children: [/*#__PURE__*/_jsx(DateTimePickerToolbarSeparator, {
+            variant: "h3",
+            value: ":"
+          }), /*#__PURE__*/_jsx(PickersToolbarButton, {
+            variant: "h3",
+            onClick: function onClick() {
+              return setOpenView('seconds');
+            },
+            selected: openView === 'seconds',
+            value: date ? utils.format(date, 'seconds') : '--'
+          })]
+        })]
+      })]
+    })), showTabs && /*#__PURE__*/_jsx(DateTimePickerTabs, {
+      dateRangeIcon: dateRangeIcon,
+      timeIcon: timeIcon,
+      view: openView,
+      onChange: setOpenView
+    })]
+  });
+};

package/legacy/DateTimePicker/index.js

@@ -0,0 +1 @@
+export { DateTimePicker } from './DateTimePicker';

package/legacy/DateTimePicker/shared.js

@@ -0,0 +1,59 @@
+import _extends from "@babel/runtime/helpers/esm/extends";
+import _objectWithoutProperties from "@babel/runtime/helpers/esm/objectWithoutProperties";
+var _excluded = ["ampm", "inputFormat", "maxDate", "maxDateTime", "maxTime", "minDate", "minDateTime", "minTime", "openTo", "orientation", "views"];
+import { useThemeProps } from '@mui/material/styles';
+import { useDefaultDates, useUtils } from '../internals/hooks/useUtils';
+import { pick12hOr24hFormat } from '../internals/utils/text-field-helper';
+export function useDateTimePickerDefaultizedProps(_ref, name) {
+  var ampm = _ref.ampm,
+      inputFormat = _ref.inputFormat,
+      maxDateProp = _ref.maxDate,
+      maxDateTime = _ref.maxDateTime,
+      maxTime = _ref.maxTime,
+      minDateProp = _ref.minDate,
+      minDateTime = _ref.minDateTime,
+      minTime = _ref.minTime,
+      _ref$openTo = _ref.openTo,
+      openTo = _ref$openTo === void 0 ? 'day' : _ref$openTo,
+      _ref$orientation = _ref.orientation,
+      orientation = _ref$orientation === void 0 ? 'portrait' : _ref$orientation,
+      _ref$views = _ref.views,
+      views = _ref$views === void 0 ? ['year', 'day', 'hours', 'minutes'] : _ref$views,
+      other = _objectWithoutProperties(_ref, _excluded);
+
+  var utils = useUtils();
+  var defaultDates = useDefaultDates();
+  var minDate = minDateProp != null ? minDateProp : defaultDates.minDate;
+  var maxDate = maxDateProp != null ? maxDateProp : defaultDates.maxDate;
+  var willUseAmPm = ampm != null ? ampm : utils.is12HourCycleInCurrentLocale();
+
+  if (orientation !== 'portrait') {
+    throw new Error('We are not supporting custom orientation for DateTimePicker yet :(');
+  }
+
+  return useThemeProps({
+    props: _extends({
+      openTo: openTo,
+      views: views,
+      ampm: willUseAmPm,
+      ampmInClock: true,
+      orientation: orientation,
+      showToolbar: true,
+      allowSameDateSelection: true,
+      minDate: minDateTime != null ? minDateTime : minDate,
+      minTime: minDateTime != null ? minDateTime : minTime,
+      maxDate: maxDateTime != null ? maxDateTime : maxDate,
+      maxTime: maxDateTime != null ? maxDateTime : maxTime,
+      disableIgnoringDatePartForTimeValidation: Boolean(minDateTime || maxDateTime),
+      acceptRegex: willUseAmPm ? /[\dap]/gi : /\d/gi,
+      mask: '__/__/____ __:__',
+      disableMaskedInput: willUseAmPm,
+      inputFormat: pick12hOr24hFormat(inputFormat, willUseAmPm, {
+        localized: utils.formats.keyboardDateTime,
+        '12h': utils.formats.keyboardDateTime12h,
+        '24h': utils.formats.keyboardDateTime24h
+      })
+    }, other),
+    name: name
+  });
+}

package/legacy/DesktopDatePicker/DesktopDatePicker.js

@@ -0,0 +1,434 @@
+import _extends from "@babel/runtime/helpers/esm/extends";
+import _objectWithoutProperties from "@babel/runtime/helpers/esm/objectWithoutProperties";
+var _excluded = ["onChange", "PopperProps", "PaperProps", "ToolbarComponent", "TransitionComponent", "value", "clearText", "clearable"];
+import * as React from 'react';
+import PropTypes from 'prop-types';
+import { useDatePickerDefaultizedProps } from '../DatePicker/shared';
+import { DatePickerToolbar } from '../DatePicker/DatePickerToolbar';
+import { DesktopWrapper } from '../internals/components/wrappers/DesktopWrapper';
+import { CalendarOrClockPicker } from '../internals/components/CalendarOrClockPicker';
+import { useDateValidation } from '../internals/hooks/validation/useDateValidation';
+import { parsePickerInputValue } from '../internals/utils/date-utils';
+import { KeyboardDateInput } from '../internals/components/KeyboardDateInput';
+import { usePickerState } from '../internals/hooks/usePickerState';
+import { jsx as _jsx } from "react/jsx-runtime";
+var valueManager = {
+  emptyValue: null,
+  parseInput: parsePickerInputValue,
+  areValuesEqual: function areValuesEqual(utils, a, b) {
+    return utils.isEqual(a, b);
+  }
+};
+
+/**
+ *
+ * Demos:
+ *
+ * - [Date Picker](https://mui.com/components/x/react-date-pickers/date-picker/)
+ *
+ * API:
+ *
+ * - [DesktopDatePicker API](https://mui.com/api/desktop-date-picker/)
+ */
+export var DesktopDatePicker = /*#__PURE__*/React.forwardRef(function DesktopDatePicker(inProps, ref) {
+  // TODO: TDate needs to be instantiated at every usage.
+  var props = useDatePickerDefaultizedProps(inProps, 'MuiDesktopDatePicker');
+  var validationError = useDateValidation(props) !== null;
+
+  var _usePickerState = usePickerState(props, valueManager),
+      pickerProps = _usePickerState.pickerProps,
+      inputProps = _usePickerState.inputProps,
+      wrapperProps = _usePickerState.wrapperProps;
+
+  var onChange = props.onChange,
+      PopperProps = props.PopperProps,
+      PaperProps = props.PaperProps,
+      _props$ToolbarCompone = props.ToolbarComponent,
+      ToolbarComponent = _props$ToolbarCompone === void 0 ? DatePickerToolbar : _props$ToolbarCompone,
+      TransitionComponent = props.TransitionComponent,
+      value = props.value,
+      clearText = props.clearText,
+      clearable = props.clearable,
+      other = _objectWithoutProperties(props, _excluded);
+
+  var AllDateInputProps = _extends({}, inputProps, other, {
+    ref: ref,
+    validationError: validationError
+  });
+
+  return /*#__PURE__*/_jsx(DesktopWrapper, _extends({}, wrapperProps, {
+    DateInputProps: AllDateInputProps,
+    KeyboardDateInputComponent: KeyboardDateInput,
+    PopperProps: PopperProps,
+    PaperProps: PaperProps,
+    TransitionComponent: TransitionComponent,
+    clearText: clearText,
+    clearable: clearable,
+    children: /*#__PURE__*/_jsx(CalendarOrClockPicker, _extends({}, pickerProps, {
+      autoFocus: true,
+      toolbarTitle: props.label || props.toolbarTitle,
+      ToolbarComponent: ToolbarComponent,
+      DateInputProps: AllDateInputProps
+    }, other))
+  }));
+});
+process.env.NODE_ENV !== "production" ? DesktopDatePicker.propTypes = {
+  // ----------------------------- Warning --------------------------------
+  // | These PropTypes are generated from the TypeScript type definitions |
+  // | To update them edit the TypeScript types and run "yarn proptypes"  |
+  // ----------------------------------------------------------------------
+
+  /**
+   * Regular expression to detect "accepted" symbols.
+   * @default /\dap/gi
+   */
+  acceptRegex: PropTypes.instanceOf(RegExp),
+
+  /**
+   * If `true`, `onChange` is fired on click even if the same date is selected.
+   * @default false
+   */
+  allowSameDateSelection: PropTypes.bool,
+  autoFocus: PropTypes.bool,
+  children: PropTypes.node,
+
+  /**
+   * className applied to the root component.
+   */
+  className: PropTypes.string,
+
+  /**
+   * If `true`, it shows the clear action in the picker dialog.
+   * @default false
+   */
+  clearable: PropTypes.bool,
+
+  /**
+   * Clear text message.
+   * @default 'Clear'
+   */
+  clearText: PropTypes.node,
+
+  /**
+   * 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,
+
+  /**
+   * Default calendar month displayed when `value={null}`.
+   */
+  defaultCalendarMonth: PropTypes.any,
+
+  /**
+   * If `true` the popup or dialog will immediately close after submitting full date.
+   * @default `true` for Desktop, `false` for Mobile (based on the chosen wrapper and `desktopModeMediaQuery` prop).
+   */
+  disableCloseOnSelect: PropTypes.bool,
+
+  /**
+   * 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,
+
+  /**
+   * Disable mask on the keyboard, this should be used rarely. Consider passing proper mask for your format.
+   * @default false
+   */
+  disableMaskedInput: PropTypes.bool,
+
+  /**
+   * Do not render open picker button (renders only text field with validation).
+   * @default false
+   */
+  disableOpenPicker: PropTypes.bool,
+
+  /**
+   * @default false
+   */
+  disablePast: PropTypes.bool,
+
+  /**
+   * Get aria-label text for control that opens picker dialog. Aria-label text must include selected date. @DateIOType
+   * @default (value, utils) => `Choose date, selected date is ${utils.format(utils.date(value), 'fullDate')}`
+   * @param {ParseableDate<TDateValue>} value The date from which we want to add an aria-text.
+   * @param {MuiPickersAdapter<TDateValue>} utils The utils to manipulate the date.
+   * @returns {string} The aria-text to render inside the dialog.
+   */
+  getOpenDialogAriaText: PropTypes.func,
+
+  /**
+   * 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,
+  ignoreInvalidInputs: PropTypes.bool,
+
+  /**
+   * Props to pass to keyboard input adornment.
+   */
+  InputAdornmentProps: PropTypes.object,
+
+  /**
+   * Format string.
+   */
+  inputFormat: PropTypes.string,
+  InputProps: PropTypes.object,
+
+  /**
+   * Pass a ref to the `input` element.
+   */
+  inputRef: PropTypes.oneOfType([PropTypes.func, PropTypes.shape({
+    current: PropTypes.object
+  })]),
+  label: PropTypes.node,
+
+  /**
+   * 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,
+
+  /**
+   * Custom mask. Can be used to override generate from format. (e.g. `__/__/____ __:__` or `__/__/____ __:__ _M`).
+   */
+  mask: PropTypes.string,
+
+  /**
+   * Max selectable date. @DateIOType
+   */
+  maxDate: PropTypes.any,
+
+  /**
+   * Min selectable date. @DateIOType
+   */
+  minDate: PropTypes.any,
+
+  /**
+   * Callback fired when date is accepted @DateIOType.
+   * @param {TDateValue} date The date that was just accepted.
+   */
+  onAccept: PropTypes.func,
+
+  /**
+   * Callback fired when the value (the selected date) changes @DateIOType.
+   * @param {DateRange<TDate>} date The new parsed date.
+   * @param {string} keyboardInputValue The current value of the keyboard input.
+   */
+  onChange: PropTypes.func.isRequired,
+
+  /**
+   * Callback fired when the popup requests to be closed.
+   * Use in controlled mode (see open).
+   */
+  onClose: PropTypes.func,
+
+  /**
+   * Callback that fired when input value or new `value` prop validation returns **new** validation error (or value is valid after error).
+   * In case of validation error detected `reason` prop return non-null value and `TextField` must be displayed in `error` state.
+   * This can be used to render appropriate form error.
+   *
+   * [Read the guide](https://next.material-ui-pickers.dev/guides/forms) about form integration and error displaying.
+   * @DateIOType
+   *
+   * @param {TError} reason The reason why the current value is not valid.
+   * @param {TDateValue} value The invalid value.
+   */
+  onError: PropTypes.func,
+
+  /**
+   * Callback firing on month change. @DateIOType
+   * @param {TDate} month The new month.
+   */
+  onMonthChange: PropTypes.func,
+
+  /**
+   * Callback fired when the popup requests to be opened.
+   * Use in controlled mode (see open).
+   */
+  onOpen: 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,
+
+  /**
+   * Control the popup or dialog open state.
+   */
+  open: PropTypes.bool,
+
+  /**
+   * Props to pass to keyboard adornment button.
+   */
+  OpenPickerButtonProps: PropTypes.object,
+
+  /**
+   * First view to show.
+   */
+  openTo: PropTypes.oneOf(['day', 'month', 'year']),
+
+  /**
+   * Force rendering in particular orientation.
+   */
+  orientation: PropTypes.oneOf(['landscape', 'portrait']),
+
+  /**
+   * Paper props passed down to [Paper](https://mui.com/api/paper/) component.
+   */
+  PaperProps: PropTypes.object,
+
+  /**
+   * Popper props passed down to [Popper](https://mui.com/api/popper/) component.
+   */
+  PopperProps: PropTypes.object,
+
+  /**
+   * 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,
+
+  /**
+   * The `renderInput` prop allows you to customize the rendered input.
+   * The `props` argument of this render prop contains props of [TextField](https://mui.com/api/text-field/#textfield-api) that you need to forward.
+   * Pay specific attention to the `ref` and `inputProps` keys.
+   * @example ```jsx
+   * renderInput={props => <TextField {...props} />}
+   * ````
+   * @param {MuiTextFieldPropsType} props The props of the input.
+   * @returns {React.ReactNode} The node to render as the input.
+   */
+  renderInput: PropTypes.func.isRequired,
+
+  /**
+   * 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,
+
+  /**
+   * Custom formatter to be passed into Rifm component.
+   * @param {string} str The un-formatted string.
+   * @returns {string} The formatted string.
+   */
+  rifmFormatter: 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,
+
+  /**
+   * If `true`, show the toolbar even in desktop mode.
+   */
+  showToolbar: PropTypes.bool,
+
+  /**
+   * Component that will replace default toolbar renderer.
+   * @default DatePickerToolbar
+   */
+  ToolbarComponent: PropTypes.elementType,
+
+  /**
+   * Date format, that is displaying in toolbar.
+   */
+  toolbarFormat: PropTypes.string,
+
+  /**
+   * Mobile picker date value placeholder, displaying if `value` === `null`.
+   * @default '–'
+   */
+  toolbarPlaceholder: PropTypes.node,
+
+  /**
+   * Mobile picker title, displaying in the toolbar.
+   * @default 'Select date'
+   */
+  toolbarTitle: PropTypes.node,
+
+  /**
+   * Custom component for popper [Transition](https://mui.com/components/transitions/#transitioncomponent-prop).
+   */
+  TransitionComponent: PropTypes.elementType,
+
+  /**
+   * The value of the picker.
+   */
+  value: PropTypes.oneOfType([PropTypes.any, PropTypes.instanceOf(Date), PropTypes.number, PropTypes.string]),
+
+  /**
+   * Array of views to show.
+   */
+  views: PropTypes.arrayOf(PropTypes.oneOf(['day', 'month', 'year']).isRequired)
+} : void 0;

package/legacy/DesktopDatePicker/index.js

@@ -0,0 +1 @@
+export { DesktopDatePicker } from './DesktopDatePicker';