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

package/MonthPicker/monthPickerClasses.js

@@ -0,0 +1,5 @@
+import { generateUtilityClass, generateUtilityClasses } from '@mui/material';
+export function getMonthPickerUtilityClass(slot) {
+  return generateUtilityClass('MuiMonthPicker', slot);
+}
+export const monthPickerClasses = generateUtilityClasses('MuiMonthPicker', ['root']);

package/MonthPicker/package.json

@@ -0,0 +1,6 @@
+{
+  "sideEffects": false,
+  "module": "./index.js",
+  "main": "../node/MonthPicker/index.js",
+  "types": "./index.d.ts"
+}

package/PickersDay/PickersDay.d.ts

@@ -0,0 +1,79 @@
+import * as React from 'react';
+import { SxProps } from '@mui/system';
+import { ButtonBaseProps } from '@mui/material/ButtonBase';
+import { Theme } from '@mui/material/styles';
+import { ExtendMui } from '../internals/models/helpers';
+import { PickerSelectionState } from '../internals/hooks/usePickerState';
+import { PickersDayClasses } from './pickersDayClasses';
+export interface PickersDayProps<TDate> extends ExtendMui<ButtonBaseProps> {
+    /**
+     * If `true`, `onChange` is fired on click even if the same date is selected.
+     * @default false
+     */
+    allowSameDateSelection?: boolean;
+    /**
+     * Override or extend the styles applied to the component.
+     */
+    classes?: Partial<PickersDayClasses>;
+    /**
+     * The date to show.
+     */
+    day: TDate;
+    /**
+     * If `true`, renders as disabled.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * If `true`, todays date is rendering without highlighting with circle.
+     * @default false
+     */
+    disableHighlightToday?: boolean;
+    /**
+     * If `true`, days are rendering without margin. Useful for displaying linked range of days.
+     * @default false
+     */
+    disableMargin?: boolean;
+    isAnimating?: boolean;
+    onDayFocus?: (day: TDate) => void;
+    onDaySelect: (day: TDate, isFinish: PickerSelectionState) => void;
+    /**
+     * If `true`, day is outside of month and will be hidden.
+     */
+    outsideCurrentMonth: boolean;
+    /**
+     * If `true`, renders as selected.
+     * @default false
+     */
+    selected?: boolean;
+    /**
+     * If `true`, days that have `outsideCurrentMonth={true}` are displayed.
+     * @default false
+     */
+    showDaysOutsideCurrentMonth?: boolean;
+    /**
+     * If `true`, renders as today date.
+     * @default false
+     */
+    today?: boolean;
+    /**
+     * The system prop that allows defining system overrides as well as additional CSS styles.
+     */
+    sx?: SxProps<Theme>;
+}
+declare type PickersDayComponent = (<TDate>(props: PickersDayProps<TDate> & React.RefAttributes<HTMLButtonElement>) => JSX.Element) & {
+    propTypes?: any;
+};
+export declare const areDayPropsEqual: (prevProps: PickersDayProps<any>, nextProps: PickersDayProps<any>) => boolean;
+/**
+ *
+ * Demos:
+ *
+ * - [Date Picker](https://mui.com/components/x/react-date-pickers/date-picker/)
+ *
+ * API:
+ *
+ * - [PickersDay API](https://mui.com/api/pickers-day/)
+ */
+export declare const PickersDay: PickersDayComponent;
+export {};

package/PickersDay/PickersDay.js

@@ -0,0 +1,344 @@
+import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
+import _extends from "@babel/runtime/helpers/esm/extends";
+const _excluded = ["allowSameDateSelection", "autoFocus", "className", "day", "disabled", "disableHighlightToday", "disableMargin", "hidden", "isAnimating", "onClick", "onDayFocus", "onDaySelect", "onFocus", "onKeyDown", "outsideCurrentMonth", "selected", "showDaysOutsideCurrentMonth", "children", "today"];
+import * as React from 'react';
+import PropTypes from 'prop-types';
+import clsx from 'clsx';
+import ButtonBase from '@mui/material/ButtonBase';
+import { unstable_useEnhancedEffect as useEnhancedEffect } from '@mui/utils';
+import { unstable_composeClasses as composeClasses } from '@mui/material';
+import { useTheme, alpha, styled, useThemeProps } from '@mui/material/styles';
+import { useForkRef } from '@mui/material/utils';
+import { useUtils } from '../internals/hooks/useUtils';
+import { DAY_SIZE, DAY_MARGIN } from '../internals/constants/dimensions';
+import { getPickersDayUtilityClass, pickersDayClasses } from './pickersDayClasses';
+import { jsx as _jsx } from "react/jsx-runtime";
+
+const useUtilityClasses = ownerState => {
+  const {
+    selected,
+    disableMargin,
+    disableHighlightToday,
+    today,
+    outsideCurrentMonth,
+    showDaysOutsideCurrentMonth,
+    classes
+  } = ownerState;
+  const slots = {
+    root: ['root', selected && 'selected', !disableMargin && 'dayWithMargin', !disableHighlightToday && today && 'today', outsideCurrentMonth && showDaysOutsideCurrentMonth && 'dayOutsideMonth'],
+    hiddenDaySpacingFiller: ['hiddenDaySpacingFiller']
+  };
+  return composeClasses(slots, getPickersDayUtilityClass, classes);
+};
+
+const styleArg = ({
+  theme,
+  ownerState
+}) => _extends({}, theme.typography.caption, {
+  width: DAY_SIZE,
+  height: DAY_SIZE,
+  borderRadius: '50%',
+  padding: 0,
+  // background required here to prevent collides with the other days when animating with transition group
+  backgroundColor: theme.palette.background.paper,
+  color: theme.palette.text.primary,
+  '&:hover': {
+    backgroundColor: alpha(theme.palette.action.active, theme.palette.action.hoverOpacity)
+  },
+  '&:focus': {
+    backgroundColor: alpha(theme.palette.action.active, theme.palette.action.hoverOpacity),
+    [`&.${pickersDayClasses.selected}`]: {
+      willChange: 'background-color',
+      backgroundColor: theme.palette.primary.dark
+    }
+  },
+  [`&.${pickersDayClasses.selected}`]: {
+    color: theme.palette.primary.contrastText,
+    backgroundColor: theme.palette.primary.main,
+    fontWeight: theme.typography.fontWeightMedium,
+    transition: theme.transitions.create('background-color', {
+      duration: theme.transitions.duration.short
+    }),
+    '&:hover': {
+      willChange: 'background-color',
+      backgroundColor: theme.palette.primary.dark
+    }
+  },
+  [`&.${pickersDayClasses.disabled}`]: {
+    color: theme.palette.text.disabled
+  }
+}, !ownerState.disableMargin && {
+  margin: `0 ${DAY_MARGIN}px`
+}, ownerState.outsideCurrentMonth && ownerState.showDaysOutsideCurrentMonth && {
+  color: theme.palette.text.secondary
+}, !ownerState.disableHighlightToday && ownerState.today && {
+  [`&:not(.${pickersDayClasses.selected})`]: {
+    border: `1px solid ${theme.palette.text.secondary}`
+  }
+});
+
+const overridesResolver = (props, styles) => {
+  const {
+    ownerState
+  } = props;
+  return [styles.root, !ownerState.disableMargin && styles.dayWithMargin, !ownerState.disableHighlightToday && ownerState.today && styles.today, !ownerState.outsideCurrentMonth && ownerState.showDaysOutsideCurrentMonth && styles.dayOutsideMonth, ownerState.outsideCurrentMonth && !ownerState.showDaysOutsideCurrentMonth && styles.hiddenDaySpacingFiller];
+};
+
+const PickersDayRoot = styled(ButtonBase, {
+  name: 'MuiPickersDay',
+  slot: 'Root',
+  overridesResolver
+})(styleArg);
+const PickersDayFiller = styled('div', {
+  name: 'MuiPickersDay',
+  slot: 'Root',
+  overridesResolver
+})(({
+  theme,
+  ownerState
+}) => _extends({}, styleArg({
+  theme,
+  ownerState
+}), {
+  visibility: 'hidden'
+}));
+
+const noop = () => {};
+
+const PickersDayRaw = /*#__PURE__*/React.forwardRef(function PickersDay(inProps, forwardedRef) {
+  const props = useThemeProps({
+    props: inProps,
+    name: 'MuiPickersDay'
+  });
+
+  const {
+    allowSameDateSelection = false,
+    autoFocus = false,
+    className,
+    day,
+    disabled = false,
+    disableHighlightToday = false,
+    disableMargin = false,
+    isAnimating,
+    onClick,
+    onDayFocus = noop,
+    onDaySelect,
+    onFocus,
+    onKeyDown,
+    outsideCurrentMonth,
+    selected = false,
+    showDaysOutsideCurrentMonth = false,
+    children,
+    today: isToday = false
+  } = props,
+        other = _objectWithoutPropertiesLoose(props, _excluded);
+
+  const ownerState = _extends({}, props, {
+    allowSameDateSelection,
+    autoFocus,
+    disabled,
+    disableHighlightToday,
+    disableMargin,
+    selected,
+    showDaysOutsideCurrentMonth,
+    today: isToday
+  });
+
+  const classes = useUtilityClasses(ownerState);
+  const utils = useUtils();
+  const ref = React.useRef(null);
+  const handleRef = useForkRef(ref, forwardedRef); // Since this is rendered when a Popper is opened we can't use passive effects.
+  // Focusing in passive effects in Popper causes scroll jump.
+
+  useEnhancedEffect(() => {
+    if (autoFocus && !disabled && !isAnimating && !outsideCurrentMonth) {
+      // ref.current being null would be a bug in MUI
+      ref.current.focus();
+    }
+  }, [autoFocus, disabled, isAnimating, outsideCurrentMonth]);
+
+  const handleFocus = event => {
+    if (onDayFocus) {
+      onDayFocus(day);
+    }
+
+    if (onFocus) {
+      onFocus(event);
+    }
+  };
+
+  const handleClick = event => {
+    if (!allowSameDateSelection && selected) {
+      return;
+    }
+
+    if (!disabled) {
+      onDaySelect(day, 'finish');
+    }
+
+    if (onClick) {
+      onClick(event);
+    }
+  };
+
+  const theme = useTheme();
+
+  function handleKeyDown(event) {
+    if (onKeyDown !== undefined) {
+      onKeyDown(event);
+    }
+
+    switch (event.key) {
+      case 'ArrowUp':
+        onDayFocus(utils.addDays(day, -7));
+        event.preventDefault();
+        break;
+
+      case 'ArrowDown':
+        onDayFocus(utils.addDays(day, 7));
+        event.preventDefault();
+        break;
+
+      case 'ArrowLeft':
+        onDayFocus(utils.addDays(day, theme.direction === 'ltr' ? -1 : 1));
+        event.preventDefault();
+        break;
+
+      case 'ArrowRight':
+        onDayFocus(utils.addDays(day, theme.direction === 'ltr' ? 1 : -1));
+        event.preventDefault();
+        break;
+
+      case 'Home':
+        onDayFocus(utils.startOfWeek(day));
+        event.preventDefault();
+        break;
+
+      case 'End':
+        onDayFocus(utils.endOfWeek(day));
+        event.preventDefault();
+        break;
+
+      case 'PageUp':
+        onDayFocus(utils.getNextMonth(day));
+        event.preventDefault();
+        break;
+
+      case 'PageDown':
+        onDayFocus(utils.getPreviousMonth(day));
+        event.preventDefault();
+        break;
+
+      default:
+        break;
+    }
+  }
+
+  if (outsideCurrentMonth && !showDaysOutsideCurrentMonth) {
+    return /*#__PURE__*/_jsx(PickersDayFiller, {
+      className: clsx(classes.root, classes.hiddenDaySpacingFiller, className),
+      ownerState: ownerState
+    });
+  }
+
+  return /*#__PURE__*/_jsx(PickersDayRoot, _extends({
+    className: clsx(classes.root, className),
+    ownerState: ownerState,
+    ref: handleRef,
+    centerRipple: true,
+    disabled: disabled,
+    "aria-label": !children ? utils.format(day, 'fullDate') : undefined,
+    tabIndex: selected ? 0 : -1,
+    onFocus: handleFocus,
+    onKeyDown: handleKeyDown,
+    onClick: handleClick
+  }, other, {
+    children: !children ? utils.format(day, 'dayOfMonth') : children
+  }));
+});
+export const areDayPropsEqual = (prevProps, nextProps) => {
+  return prevProps.autoFocus === nextProps.autoFocus && prevProps.isAnimating === nextProps.isAnimating && prevProps.today === nextProps.today && prevProps.disabled === nextProps.disabled && prevProps.selected === nextProps.selected && prevProps.disableMargin === nextProps.disableMargin && prevProps.showDaysOutsideCurrentMonth === nextProps.showDaysOutsideCurrentMonth && prevProps.disableHighlightToday === nextProps.disableHighlightToday && prevProps.className === nextProps.className && prevProps.outsideCurrentMonth === nextProps.outsideCurrentMonth && prevProps.onDayFocus === nextProps.onDayFocus && prevProps.onDaySelect === nextProps.onDaySelect;
+};
+process.env.NODE_ENV !== "production" ? PickersDayRaw.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,
+
+  /**
+   * Override or extend the styles applied to the component.
+   */
+  classes: PropTypes.object,
+
+  /**
+   * The date to show.
+   */
+  day: PropTypes.any.isRequired,
+
+  /**
+   * If `true`, renders as disabled.
+   * @default false
+   */
+  disabled: PropTypes.bool,
+
+  /**
+   * If `true`, todays date is rendering without highlighting with circle.
+   * @default false
+   */
+  disableHighlightToday: PropTypes.bool,
+
+  /**
+   * If `true`, days are rendering without margin. Useful for displaying linked range of days.
+   * @default false
+   */
+  disableMargin: PropTypes.bool,
+  isAnimating: PropTypes.bool,
+  onDayFocus: PropTypes.func,
+  onDaySelect: PropTypes.func.isRequired,
+
+  /**
+   * If `true`, day is outside of month and will be hidden.
+   */
+  outsideCurrentMonth: PropTypes.bool.isRequired,
+
+  /**
+   * If `true`, renders as selected.
+   * @default false
+   */
+  selected: PropTypes.bool,
+
+  /**
+   * If `true`, days that have `outsideCurrentMonth={true}` are displayed.
+   * @default false
+   */
+  showDaysOutsideCurrentMonth: PropTypes.bool,
+
+  /**
+   * The system prop that allows defining system overrides as well as additional CSS styles.
+   */
+  sx: PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.func, PropTypes.object, PropTypes.bool])), PropTypes.func, PropTypes.object]),
+
+  /**
+   * If `true`, renders as today date.
+   * @default false
+   */
+  today: PropTypes.bool
+} : void 0;
+/**
+ *
+ * Demos:
+ *
+ * - [Date Picker](https://mui.com/components/x/react-date-pickers/date-picker/)
+ *
+ * API:
+ *
+ * - [PickersDay API](https://mui.com/api/pickers-day/)
+ */
+
+export const PickersDay = /*#__PURE__*/React.memo(PickersDayRaw, areDayPropsEqual);

package/PickersDay/index.d.ts

@@ -0,0 +1,4 @@
+export { PickersDay } from './PickersDay';
+export type { PickersDayProps } from './PickersDay';
+export { pickersDayClasses, getPickersDayUtilityClass } from './pickersDayClasses';
+export type { PickersDayClasses, PickersDayClassKey } from './pickersDayClasses';

package/PickersDay/index.js

@@ -0,0 +1,2 @@
+export { PickersDay } from './PickersDay';
+export { pickersDayClasses, getPickersDayUtilityClass } from './pickersDayClasses';

package/PickersDay/package.json

@@ -0,0 +1,6 @@
+{
+  "sideEffects": false,
+  "module": "./index.js",
+  "main": "../node/PickersDay/index.js",
+  "types": "./index.d.ts"
+}

package/PickersDay/pickersDayClasses.d.ts

@@ -0,0 +1,19 @@
+export interface PickersDayClasses {
+    /** Styles applied to the root element. */
+    root: string;
+    /** Styles applied to the root element if `disableMargin=false`. */
+    dayWithMargin: string;
+    /** Styles applied to the root element if `outsideCurrentMonth=true` and `showDaysOutsideCurrentMonth=true`. */
+    dayOutsideMonth: string;
+    /** Styles applied to the root element if `outsideCurrentMonth=true` and `showDaysOutsideCurrentMonth=false`. */
+    hiddenDaySpacingFiller: string;
+    /** Styles applied to the root element if `disableHighlightToday=false` and `today=true`. */
+    today: string;
+    /** State class applied to the root element if `selected=true`. */
+    selected: string;
+    /** State class applied to the root element if `disabled=true`. */
+    disabled: string;
+}
+export declare type PickersDayClassKey = keyof PickersDayClasses;
+export declare function getPickersDayUtilityClass(slot: string): string;
+export declare const pickersDayClasses: Record<keyof PickersDayClasses, string>;

package/PickersDay/pickersDayClasses.js

@@ -0,0 +1,5 @@
+import { generateUtilityClass, generateUtilityClasses } from '@mui/material';
+export function getPickersDayUtilityClass(slot) {
+  return generateUtilityClass('MuiPickersDay', slot);
+}
+export const pickersDayClasses = generateUtilityClasses('MuiPickersDay', ['root', 'dayWithMargin', 'dayOutsideMonth', 'hiddenDaySpacingFiller', 'today', 'selected', 'disabled']);

package/README.md

@@ -0,0 +1,29 @@
+# @mui/x-date-pickers
+
+This package is the community edition of the date picker component.
+It's part of MUI X, an open core extension of MUI, with advanced components.
+
+## Installation
+
+Install the package in your project directory with:
+
+```sh
+// with npm
+npm install @mui/x-date-pickers
+
+// with yarn
+yarn add @mui/x-date-pickers
+```
+
+This component has three peer dependencies that you will need to install as well.
+
+```json
+"peerDependencies": {
+  "@mui/material": "^5.0.0",
+  "react": "^17.0.0"
+},
+```
+
+## Documentation
+
+[The documentation](https://mui.com/components/x/react-date-pickers/date-picker/)

package/StaticDatePicker/StaticDatePicker.d.ts

@@ -0,0 +1,25 @@
+import * as React from 'react';
+import { BaseDatePickerProps } from '../DatePicker/shared';
+import { PickerStaticWrapperProps } from '../internals/components/PickerStaticWrapper/PickerStaticWrapper';
+export interface StaticDatePickerProps<TDate = unknown> extends BaseDatePickerProps<TDate> {
+    /**
+     * Force static wrapper inner components to be rendered in mobile or desktop mode.
+     * @default 'mobile'
+     */
+    displayStaticWrapperAs?: PickerStaticWrapperProps['displayStaticWrapperAs'];
+}
+declare type StaticDatePickerComponent = (<TDate>(props: StaticDatePickerProps<TDate> & React.RefAttributes<HTMLDivElement>) => JSX.Element) & {
+    propTypes?: any;
+};
+/**
+ *
+ * Demos:
+ *
+ * - [Date Picker](https://mui.com/components/x/react-date-pickers/date-picker/)
+ *
+ * API:
+ *
+ * - [StaticDatePicker API](https://mui.com/api/static-date-picker/)
+ */
+export declare const StaticDatePicker: StaticDatePickerComponent;
+export {};