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

package/node/MobileDateTimePicker/MobileDateTimePicker.js

@@ -0,0 +1,549 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.MobileDateTimePicker = void 0;
+
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+
+var _objectWithoutPropertiesLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutPropertiesLoose"));
+
+var React = _interopRequireWildcard(require("react"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _shared = require("../DateTimePicker/shared");
+
+var _DateTimePickerToolbar = require("../DateTimePicker/DateTimePickerToolbar");
+
+var _MobileWrapper = require("../internals/components/wrappers/MobileWrapper");
+
+var _CalendarOrClockPicker = require("../internals/components/CalendarOrClockPicker");
+
+var _useDateTimeValidation = require("../internals/hooks/validation/useDateTimeValidation");
+
+var _dateUtils = require("../internals/utils/date-utils");
+
+var _PureDateInput = require("../internals/components/PureDateInput");
+
+var _usePickerState = require("../internals/hooks/usePickerState");
+
+var _jsxRuntime = require("react/jsx-runtime");
+
+const _excluded = ["ToolbarComponent", "value", "onChange"];
+
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+
+const valueManager = {
+  emptyValue: null,
+  parseInput: _dateUtils.parsePickerInputValue,
+  areValuesEqual: (utils, a, b) => utils.isEqual(a, b)
+};
+
+/**
+ *
+ * Demos:
+ *
+ * - [Date Time Picker](https://mui.com/components/x/react-date-pickers/date-time-picker/)
+ *
+ * API:
+ *
+ * - [MobileDateTimePicker API](https://mui.com/api/mobile-date-time-picker/)
+ */
+const MobileDateTimePicker = /*#__PURE__*/React.forwardRef(function MobileDateTimePicker(inProps, ref) {
+  // TODO: TDate needs to be instantiated at every usage.
+  const props = (0, _shared.useDateTimePickerDefaultizedProps)(inProps, 'MuiMobileDateTimePicker');
+  const validationError = (0, _useDateTimeValidation.useDateTimeValidation)(props) !== null;
+  const {
+    pickerProps,
+    inputProps,
+    wrapperProps
+  } = (0, _usePickerState.usePickerState)(props, valueManager); // Note that we are passing down all the value without spread.
+  // It saves us >1kb gzip and make any prop available automatically on any level down.
+
+  const {
+    ToolbarComponent = _DateTimePickerToolbar.DateTimePickerToolbar
+  } = props,
+        other = (0, _objectWithoutPropertiesLoose2.default)(props, _excluded);
+  const DateInputProps = (0, _extends2.default)({}, inputProps, other, {
+    ref,
+    validationError
+  });
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_MobileWrapper.MobileWrapper, (0, _extends2.default)({}, other, wrapperProps, {
+    DateInputProps: DateInputProps,
+    PureDateInputComponent: _PureDateInput.PureDateInput,
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_CalendarOrClockPicker.CalendarOrClockPicker, (0, _extends2.default)({}, pickerProps, {
+      autoFocus: true,
+      toolbarTitle: props.label || props.toolbarTitle,
+      ToolbarComponent: ToolbarComponent,
+      DateInputProps: DateInputProps
+    }, other))
+  }));
+});
+exports.MobileDateTimePicker = MobileDateTimePicker;
+process.env.NODE_ENV !== "production" ? MobileDateTimePicker.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.default.instanceOf(RegExp),
+
+  /**
+   * If `true`, `onChange` is fired on click even if the same date is selected.
+   * @default false
+   */
+  allowSameDateSelection: _propTypes.default.bool,
+
+  /**
+   * 12h/24h view for hour selection clock.
+   * @default false
+   */
+  ampm: _propTypes.default.bool,
+
+  /**
+   * Display ampm controls under the clock (instead of in the toolbar).
+   * @default false
+   */
+  ampmInClock: _propTypes.default.bool,
+  autoFocus: _propTypes.default.bool,
+
+  /**
+   * Cancel text message.
+   * @default 'Cancel'
+   */
+  cancelText: _propTypes.default.node,
+  children: _propTypes.default.node,
+
+  /**
+   * className applied to the root component.
+   */
+  className: _propTypes.default.string,
+
+  /**
+   * If `true`, it shows the clear action in the picker dialog.
+   * @default false
+   */
+  clearable: _propTypes.default.bool,
+
+  /**
+   * Clear text message.
+   * @default 'Clear'
+   */
+  clearText: _propTypes.default.node,
+
+  /**
+   * The components used for each slot.
+   * Either a string to use a HTML element or a component.
+   * @default {}
+   */
+  components: _propTypes.default.object,
+
+  /**
+   * The props used for each slot inside.
+   * @default {}
+   */
+  componentsProps: _propTypes.default.object,
+
+  /**
+   * Date tab icon.
+   */
+  dateRangeIcon: _propTypes.default.node,
+
+  /**
+   * Default calendar month displayed when `value={null}`.
+   */
+  defaultCalendarMonth: _propTypes.default.any,
+
+  /**
+   * Props applied to the [`Dialog`](/api/dialog/) element.
+   */
+  DialogProps: _propTypes.default.object,
+
+  /**
+   * 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.default.bool,
+
+  /**
+   * If `true`, the picker and text field are disabled.
+   * @default false
+   */
+  disabled: _propTypes.default.bool,
+
+  /**
+   * @default false
+   */
+  disableFuture: _propTypes.default.bool,
+
+  /**
+   * If `true`, todays date is rendering without highlighting with circle.
+   * @default false
+   */
+  disableHighlightToday: _propTypes.default.bool,
+
+  /**
+   * Do not ignore date part when validating min/max time.
+   * @default false
+   */
+  disableIgnoringDatePartForTimeValidation: _propTypes.default.bool,
+
+  /**
+   * Disable mask on the keyboard, this should be used rarely. Consider passing proper mask for your format.
+   * @default false
+   */
+  disableMaskedInput: _propTypes.default.bool,
+
+  /**
+   * Do not render open picker button (renders only text field with validation).
+   * @default false
+   */
+  disableOpenPicker: _propTypes.default.bool,
+
+  /**
+   * @default false
+   */
+  disablePast: _propTypes.default.bool,
+
+  /**
+   * Accessible text that helps user to understand which time and view is selected.
+   * @param {ClockPickerView} view The current view rendered.
+   * @param {TDate | null} time The current time.
+   * @param {MuiPickersAdapter<TDate>} adapter The current date adapter.
+   * @returns {string} The clock label.
+   * @default <TDate extends any>(
+   *   view: ClockView,
+   *   time: TDate | null,
+   *   adapter: MuiPickersAdapter<TDate>,
+   * ) =>
+   *   `Select ${view}. ${
+   *     time === null ? 'No time selected' : `Selected time is ${adapter.format(time, 'fullTime')}`
+   *   }`
+   */
+  getClockLabelText: _propTypes.default.func,
+
+  /**
+   * 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.default.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.default.func,
+
+  /**
+   * To show tabs.
+   */
+  hideTabs: _propTypes.default.bool,
+  ignoreInvalidInputs: _propTypes.default.bool,
+
+  /**
+   * Props to pass to keyboard input adornment.
+   */
+  InputAdornmentProps: _propTypes.default.object,
+
+  /**
+   * Format string.
+   */
+  inputFormat: _propTypes.default.string,
+  InputProps: _propTypes.default.object,
+
+  /**
+   * Pass a ref to the `input` element.
+   */
+  inputRef: _propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.shape({
+    current: _propTypes.default.object
+  })]),
+  label: _propTypes.default.node,
+
+  /**
+   * Left arrow icon aria-label text.
+   */
+  leftArrowButtonText: _propTypes.default.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.default.bool,
+
+  /**
+   * Custom mask. Can be used to override generate from format. (e.g. `__/__/____ __:__` or `__/__/____ __:__ _M`).
+   */
+  mask: _propTypes.default.string,
+
+  /**
+   * Max selectable date. @DateIOType
+   */
+  maxDate: _propTypes.default.any,
+
+  /**
+   * Minimal selectable moment of time with binding to date, to set max time in each day use `maxTime`.
+   */
+  maxDateTime: _propTypes.default.any,
+
+  /**
+   * Max time acceptable time.
+   * For input validation date part of passed object will be ignored if `disableIgnoringDatePartForTimeValidation` not specified.
+   */
+  maxTime: _propTypes.default.any,
+
+  /**
+   * Min selectable date. @DateIOType
+   */
+  minDate: _propTypes.default.any,
+
+  /**
+   * Minimal selectable moment of time with binding to date, to set min time in each day use `minTime`.
+   */
+  minDateTime: _propTypes.default.any,
+
+  /**
+   * Min time acceptable time.
+   * For input validation date part of passed object will be ignored if `disableIgnoringDatePartForTimeValidation` not specified.
+   */
+  minTime: _propTypes.default.any,
+
+  /**
+   * Step over minutes.
+   * @default 1
+   */
+  minutesStep: _propTypes.default.number,
+
+  /**
+   * Ok button text.
+   * @default 'OK'
+   */
+  okText: _propTypes.default.node,
+
+  /**
+   * Callback fired when date is accepted @DateIOType.
+   * @param {TDateValue} date The date that was just accepted.
+   */
+  onAccept: _propTypes.default.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.default.func.isRequired,
+
+  /**
+   * Callback fired when the popup requests to be closed.
+   * Use in controlled mode (see open).
+   */
+  onClose: _propTypes.default.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.default.func,
+
+  /**
+   * Callback firing on month change. @DateIOType
+   * @param {TDate} month The new month.
+   */
+  onMonthChange: _propTypes.default.func,
+
+  /**
+   * Callback fired when the popup requests to be opened.
+   * Use in controlled mode (see open).
+   */
+  onOpen: _propTypes.default.func,
+
+  /**
+   * Callback fired on view change.
+   * @param {CalendarOrClockPickerView} view The new view.
+   */
+  onViewChange: _propTypes.default.func,
+
+  /**
+   * Callback firing on year change @DateIOType.
+   * @param {TDate} year The new year.
+   */
+  onYearChange: _propTypes.default.func,
+
+  /**
+   * Control the popup or dialog open state.
+   */
+  open: _propTypes.default.bool,
+
+  /**
+   * Props to pass to keyboard adornment button.
+   */
+  OpenPickerButtonProps: _propTypes.default.object,
+
+  /**
+   * First view to show.
+   */
+  openTo: _propTypes.default.oneOf(['day', 'hours', 'minutes', 'month', 'seconds', 'year']),
+
+  /**
+   * Force rendering in particular orientation.
+   */
+  orientation: _propTypes.default.oneOf(['landscape', 'portrait']),
+
+  /**
+   * Make picker read only.
+   * @default false
+   */
+  readOnly: _propTypes.default.bool,
+
+  /**
+   * Disable heavy animations.
+   * @default typeof navigator !== 'undefined' && /(android)/i.test(navigator.userAgent)
+   */
+  reduceAnimations: _propTypes.default.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.default.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.default.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.default.func,
+
+  /**
+   * Custom formatter to be passed into Rifm component.
+   * @param {string} str The un-formatted string.
+   * @returns {string} The formatted string.
+   */
+  rifmFormatter: _propTypes.default.func,
+
+  /**
+   * Right arrow icon aria-label text.
+   */
+  rightArrowButtonText: _propTypes.default.string,
+
+  /**
+   * Disable specific date. @DateIOType
+   * @param {TDate} day The date to check.
+   * @returns {boolean} If `true` the day will be disabled.
+   */
+  shouldDisableDate: _propTypes.default.func,
+
+  /**
+   * Dynamically check if time is disabled or not.
+   * If returns `false` appropriate time point will ot be acceptable.
+   * @param {number} timeValue The value to check.
+   * @param {ClockPickerView} clockType The clock type of the timeValue.
+   * @returns {boolean} Returns `true` if the time should be disabled
+   */
+  shouldDisableTime: _propTypes.default.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.default.func,
+
+  /**
+   * If `true`, days that have `outsideCurrentMonth={true}` are displayed.
+   * @default false
+   */
+  showDaysOutsideCurrentMonth: _propTypes.default.bool,
+
+  /**
+   * If `true`, the today button is displayed. **Note** that `showClearButton` has a higher priority.
+   * @default false
+   */
+  showTodayButton: _propTypes.default.bool,
+
+  /**
+   * If `true`, show the toolbar even in desktop mode.
+   */
+  showToolbar: _propTypes.default.bool,
+
+  /**
+   * Time tab icon.
+   */
+  timeIcon: _propTypes.default.node,
+
+  /**
+   * Today text message.
+   * @default 'Today'
+   */
+  todayText: _propTypes.default.node,
+
+  /**
+   * Component that will replace default toolbar renderer.
+   * @default DateTimePickerToolbar
+   */
+  ToolbarComponent: _propTypes.default.elementType,
+
+  /**
+   * Date format, that is displaying in toolbar.
+   */
+  toolbarFormat: _propTypes.default.string,
+
+  /**
+   * Mobile picker date value placeholder, displaying if `value` === `null`.
+   * @default '–'
+   */
+  toolbarPlaceholder: _propTypes.default.node,
+
+  /**
+   * Mobile picker title, displaying in the toolbar.
+   * @default 'Select date & time'
+   */
+  toolbarTitle: _propTypes.default.node,
+
+  /**
+   * The value of the picker.
+   */
+  value: _propTypes.default.oneOfType([_propTypes.default.any, _propTypes.default.instanceOf(Date), _propTypes.default.number, _propTypes.default.string]),
+
+  /**
+   * Array of views to show.
+   */
+  views: _propTypes.default.arrayOf(_propTypes.default.oneOf(['day', 'hours', 'minutes', 'month', 'seconds', 'year']).isRequired)
+} : void 0;

package/node/MobileDateTimePicker/index.js

@@ -0,0 +1,13 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "MobileDateTimePicker", {
+  enumerable: true,
+  get: function () {
+    return _MobileDateTimePicker.MobileDateTimePicker;
+  }
+});
+
+var _MobileDateTimePicker = require("./MobileDateTimePicker");