@mui/x-date-pickers 9.0.0-alpha.1 → 9.0.0-alpha.2

package/PickersSectionList/PickersSectionList.mjs

@@ -0,0 +1,268 @@
+'use client';
+
+import _formatErrorMessage from "@mui/x-internals/formatErrorMessage";
+import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
+import _extends from "@babel/runtime/helpers/esm/extends";
+const _excluded = ["slots", "slotProps", "elements", "sectionListRef", "classes"];
+import * as React from 'react';
+import PropTypes from 'prop-types';
+import useSlotProps from '@mui/utils/useSlotProps';
+import composeClasses from '@mui/utils/composeClasses';
+import useForkRef from '@mui/utils/useForkRef';
+import { styled, useThemeProps } from '@mui/material/styles';
+import { getPickersSectionListUtilityClass, pickersSectionListClasses } from "./pickersSectionListClasses.mjs";
+import { usePickerPrivateContext } from "../internals/hooks/usePickerPrivateContext.mjs";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export const PickersSectionListRoot = styled('div', {
+  name: 'MuiPickersSectionList',
+  slot: 'Root'
+})({
+  direction: 'ltr /*! @noflip */',
+  outline: 'none'
+});
+export const PickersSectionListSection = styled('span', {
+  name: 'MuiPickersSectionList',
+  slot: 'Section'
+})({});
+export const PickersSectionListSectionSeparator = styled('span', {
+  name: 'MuiPickersSectionList',
+  slot: 'SectionSeparator'
+})({
+  whiteSpace: 'pre'
+});
+export const PickersSectionListSectionContent = styled('span', {
+  name: 'MuiPickersSectionList',
+  slot: 'SectionContent'
+})({
+  outline: 'none'
+});
+const useUtilityClasses = classes => {
+  const slots = {
+    root: ['root'],
+    section: ['section'],
+    sectionContent: ['sectionContent']
+  };
+  return composeClasses(slots, getPickersSectionListUtilityClass, classes);
+};
+function PickersSection(props) {
+  const {
+    slots,
+    slotProps,
+    element,
+    classes
+  } = props;
+  const {
+    ownerState
+  } = usePickerPrivateContext();
+  const Section = slots?.section ?? PickersSectionListSection;
+  const sectionProps = useSlotProps({
+    elementType: Section,
+    externalSlotProps: slotProps?.section,
+    externalForwardedProps: element.container,
+    className: classes.section,
+    ownerState
+  });
+  const SectionContent = slots?.sectionContent ?? PickersSectionListSectionContent;
+  const sectionContentProps = useSlotProps({
+    elementType: SectionContent,
+    externalSlotProps: slotProps?.sectionContent,
+    externalForwardedProps: element.content,
+    additionalProps: {
+      suppressContentEditableWarning: true
+    },
+    className: classes.sectionContent,
+    ownerState
+  });
+  const SectionSeparator = slots?.sectionSeparator ?? PickersSectionListSectionSeparator;
+  const sectionSeparatorBeforeProps = useSlotProps({
+    elementType: SectionSeparator,
+    externalSlotProps: slotProps?.sectionSeparator,
+    externalForwardedProps: element.before,
+    ownerState: _extends({}, ownerState, {
+      separatorPosition: 'before'
+    })
+  });
+  const sectionSeparatorAfterProps = useSlotProps({
+    elementType: SectionSeparator,
+    externalSlotProps: slotProps?.sectionSeparator,
+    externalForwardedProps: element.after,
+    ownerState: _extends({}, ownerState, {
+      separatorPosition: 'after'
+    })
+  });
+
+  // Only propagate blur when focus leaves the SectionContent entirely.
+  const sectionContentRef = React.useRef(null);
+  const handleSectionContentRef = useForkRef(sectionContentProps.ref, sectionContentRef);
+  const handleContentBlur = event => {
+    const next = event.relatedTarget;
+    // If the next focused element stays within the whole field (root),
+    // do not propagate blur. We only want blur when leaving the field entirely.
+    const root = event.currentTarget.closest(`.${pickersSectionListClasses.root}`);
+    if (root && next instanceof Node && root.contains(next)) {
+      event.stopPropagation();
+      return;
+    }
+    // Otherwise, focus left the whole field; allow propagation.
+  };
+  return /*#__PURE__*/_jsxs(Section, _extends({}, sectionProps, {
+    children: [/*#__PURE__*/_jsx(SectionSeparator, _extends({}, sectionSeparatorBeforeProps)), /*#__PURE__*/_jsx(SectionContent, _extends({}, sectionContentProps, {
+      ref: handleSectionContentRef,
+      onBlur: handleContentBlur
+    })), /*#__PURE__*/_jsx(SectionSeparator, _extends({}, sectionSeparatorAfterProps))]
+  }));
+}
+process.env.NODE_ENV !== "production" ? PickersSection.propTypes = {
+  // ----------------------------- Warning --------------------------------
+  // | These PropTypes are generated from the TypeScript type definitions |
+  // | To update them edit the TypeScript types and run "pnpm proptypes"  |
+  // ----------------------------------------------------------------------
+  classes: PropTypes.object.isRequired,
+  element: PropTypes.shape({
+    after: PropTypes.object.isRequired,
+    before: PropTypes.object.isRequired,
+    container: PropTypes.object.isRequired,
+    content: PropTypes.object.isRequired
+  }).isRequired,
+  /**
+   * The props used for each component slot.
+   */
+  slotProps: PropTypes.object,
+  /**
+   * Overridable component slots.
+   */
+  slots: PropTypes.object
+} : void 0;
+/**
+ * Demos:
+ *
+ * - [Custom field](https://mui.com/x/react-date-pickers/custom-field/)
+ *
+ * API:
+ *
+ * - [PickersSectionList API](https://mui.com/x/api/date-pickers/pickers-section-list/)
+ */
+const PickersSectionList = /*#__PURE__*/React.forwardRef(function PickersSectionList(inProps, ref) {
+  const props = useThemeProps({
+    props: inProps,
+    name: 'MuiPickersSectionList'
+  });
+  const {
+      slots,
+      slotProps,
+      elements,
+      sectionListRef,
+      classes: classesProp
+    } = props,
+    other = _objectWithoutPropertiesLoose(props, _excluded);
+  const classes = useUtilityClasses(classesProp);
+  const {
+    ownerState
+  } = usePickerPrivateContext();
+  const rootRef = React.useRef(null);
+  const handleRootRef = useForkRef(ref, rootRef);
+  const getRoot = methodName => {
+    if (!rootRef.current) {
+      throw new Error(process.env.NODE_ENV !== "production" ? `MUI X: Cannot call sectionListRef.${methodName} before the mount of the component.` : _formatErrorMessage(145, methodName));
+    }
+    return rootRef.current;
+  };
+  React.useImperativeHandle(sectionListRef, () => ({
+    getRoot() {
+      return getRoot('getRoot');
+    },
+    getSectionContainer(index) {
+      const root = getRoot('getSectionContainer');
+      return root.querySelector(`.${pickersSectionListClasses.section}[data-sectionindex="${index}"]`);
+    },
+    getSectionContent(index) {
+      const root = getRoot('getSectionContent');
+      return root.querySelector(`.${pickersSectionListClasses.section}[data-sectionindex="${index}"] .${pickersSectionListClasses.sectionContent}`);
+    },
+    getSectionIndexFromDOMElement(element) {
+      const root = getRoot('getSectionIndexFromDOMElement');
+      if (element == null || !root.contains(element)) {
+        return null;
+      }
+      let sectionContainer = null;
+      if (element.classList.contains(pickersSectionListClasses.section)) {
+        sectionContainer = element;
+      } else if (element.classList.contains(pickersSectionListClasses.sectionContent)) {
+        sectionContainer = element.parentElement;
+      }
+      if (sectionContainer == null) {
+        return null;
+      }
+      return Number(sectionContainer.dataset.sectionindex);
+    }
+  }));
+  const Root = slots?.root ?? PickersSectionListRoot;
+  const rootProps = useSlotProps({
+    elementType: Root,
+    externalSlotProps: slotProps?.root,
+    externalForwardedProps: other,
+    additionalProps: {
+      ref: handleRootRef,
+      suppressContentEditableWarning: true
+    },
+    className: classes.root,
+    ownerState
+  });
+  return /*#__PURE__*/_jsx(Root, _extends({}, rootProps, {
+    children: rootProps.contentEditable ? elements.map(({
+      content,
+      before,
+      after
+    }) => `${before.children}${content.children}${after.children}`).join('') : /*#__PURE__*/_jsx(React.Fragment, {
+      children: elements.map((element, elementIndex) => /*#__PURE__*/_jsx(PickersSection, {
+        slots: slots,
+        slotProps: slotProps,
+        element: element,
+        classes: classes
+      }, elementIndex))
+    })
+  }));
+});
+if (process.env.NODE_ENV !== "production") PickersSectionList.displayName = "PickersSectionList";
+process.env.NODE_ENV !== "production" ? PickersSectionList.propTypes = {
+  // ----------------------------- Warning --------------------------------
+  // | These PropTypes are generated from the TypeScript type definitions |
+  // | To update them edit the TypeScript types and run "pnpm proptypes"  |
+  // ----------------------------------------------------------------------
+  /**
+   * Override or extend the styles applied to the component.
+   */
+  classes: PropTypes.object,
+  /**
+   * If true, the whole element is editable.
+   * Useful when all the sections are selected.
+   */
+  contentEditable: PropTypes.bool.isRequired,
+  /**
+   * The elements to render.
+   * Each element contains the prop to edit a section of the value.
+   */
+  elements: PropTypes.arrayOf(PropTypes.shape({
+    after: PropTypes.object.isRequired,
+    before: PropTypes.object.isRequired,
+    container: PropTypes.object.isRequired,
+    content: PropTypes.object.isRequired
+  })).isRequired,
+  sectionListRef: PropTypes.oneOfType([PropTypes.func, PropTypes.shape({
+    current: PropTypes.shape({
+      getRoot: PropTypes.func.isRequired,
+      getSectionContainer: PropTypes.func.isRequired,
+      getSectionContent: PropTypes.func.isRequired,
+      getSectionIndexFromDOMElement: PropTypes.func.isRequired
+    })
+  })]),
+  /**
+   * The props used for each component slot.
+   */
+  slotProps: PropTypes.object,
+  /**
+   * Overridable component slots.
+   */
+  slots: PropTypes.object
+} : void 0;
+export { PickersSectionList };

package/PickersSectionList/PickersSectionList.types.d.mts

@@ -0,0 +1,61 @@
+import * as React from 'react';
+import { SlotComponentProps } from '@mui/utils/types';
+import { PickersSectionListClasses } from "./pickersSectionListClasses.mjs";
+import { PickerOwnerState } from "../models/index.mjs";
+import type { UseFieldDOMGetters } from "../internals/hooks/useField/useField.types.mjs";
+export interface PickersSectionListSlots {
+  root: React.ElementType;
+  section: React.ElementType;
+  sectionSeparator: React.ElementType;
+  sectionContent: React.ElementType;
+}
+export interface PickerSectionSeparatorOwnerState extends PickerOwnerState {
+  /**
+   * The position of the separator.
+   * `before` if the separator is rendered before the section content.
+   * `after` if the separator is rendered after the section content.
+   */
+  separatorPosition: 'before' | 'after';
+}
+export interface PickersSectionListSlotProps {
+  root?: SlotComponentProps<'div', {}, PickerOwnerState>;
+  section?: SlotComponentProps<'span', {}, PickerOwnerState>;
+  sectionSeparator?: SlotComponentProps<'span', {}, PickerSectionSeparatorOwnerState>;
+  sectionContent?: SlotComponentProps<'span', {}, PickerOwnerState>;
+}
+export interface PickersSectionElement {
+  container: React.HTMLAttributes<HTMLSpanElement>;
+  content: React.HTMLAttributes<HTMLSpanElement> & {
+    'data-range-position': string | undefined;
+  };
+  before: React.HTMLAttributes<HTMLSpanElement>;
+  after: React.HTMLAttributes<HTMLSpanElement>;
+}
+export interface PickersSectionListRef extends Omit<UseFieldDOMGetters, 'isReady'> {}
+export interface ExportedPickersSectionListProps extends Pick<React.HTMLAttributes<HTMLDivElement>, 'tabIndex'> {
+  /**
+   * The elements to render.
+   * Each element contains the prop to edit a section of the value.
+   */
+  elements: PickersSectionElement[];
+  sectionListRef: React.Ref<PickersSectionListRef>;
+  /**
+   * If true, the whole element is editable.
+   * Useful when all the sections are selected.
+   */
+  contentEditable: boolean;
+}
+export interface PickersSectionListProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'contentEditable'>, ExportedPickersSectionListProps {
+  /**
+   * Overridable component slots.
+   */
+  slots?: PickersSectionListSlots;
+  /**
+   * The props used for each component slot.
+   */
+  slotProps?: PickersSectionListSlotProps;
+  /**
+   * Override or extend the styles applied to the component.
+   */
+  classes?: Partial<PickersSectionListClasses>;
+}

package/PickersSectionList/index.d.mts

@@ -0,0 +1,4 @@
+export { PickersSectionList as Unstable_PickersSectionList, PickersSectionListRoot as Unstable_PickersSectionListRoot, PickersSectionListSection as Unstable_PickersSectionListSection, PickersSectionListSectionSeparator as Unstable_PickersSectionListSectionSeparator, PickersSectionListSectionContent as Unstable_PickersSectionListSectionContent } from "./PickersSectionList.mjs";
+export type { PickersSectionListProps, PickersSectionElement, PickersSectionListRef, PickersSectionListSlots, PickersSectionListSlotProps, ExportedPickersSectionListProps } from "./PickersSectionList.types.mjs";
+export { getPickersSectionListUtilityClass, pickersSectionListClasses } from "./pickersSectionListClasses.mjs";
+export type { PickersSectionListClasses, PickersSectionListClassKey } from "./pickersSectionListClasses.mjs";

package/PickersSectionList/index.mjs

@@ -0,0 +1,2 @@
+export { PickersSectionList as Unstable_PickersSectionList, PickersSectionListRoot as Unstable_PickersSectionListRoot, PickersSectionListSection as Unstable_PickersSectionListSection, PickersSectionListSectionSeparator as Unstable_PickersSectionListSectionSeparator, PickersSectionListSectionContent as Unstable_PickersSectionListSectionContent } from "./PickersSectionList.mjs";
+export { getPickersSectionListUtilityClass, pickersSectionListClasses } from "./pickersSectionListClasses.mjs";

package/PickersShortcuts/PickersShortcuts.d.mts

@@ -0,0 +1,46 @@
+import { ListProps } from '@mui/material/List';
+import { PickerValidValue } from "../internals/models/index.mjs";
+import { PickerChangeImportance } from "../models/pickers.mjs";
+interface PickersShortcutsItemGetValueParams<TValue extends PickerValidValue> {
+  isValid: (value: TValue) => boolean;
+}
+export interface PickersShortcutsItem<TValue extends PickerValidValue> {
+  label: string;
+  getValue: (params: PickersShortcutsItemGetValueParams<TValue>) => TValue;
+  /**
+   * Identifier of the shortcut.
+   * If provided, it will be used as the key of the shortcut.
+   */
+  id?: string;
+}
+export type PickersShortcutsItemContext = Omit<PickersShortcutsItem<PickerValidValue>, 'getValue'>;
+export interface ExportedPickersShortcutProps<TValue extends PickerValidValue> extends Omit<ListProps, 'onChange'> {
+  /**
+   * Ordered array of shortcuts to display.
+   * If empty, does not display the shortcuts.
+   * @default []
+   */
+  items?: PickersShortcutsItem<TValue>[];
+  /**
+   * Importance of the change when picking a shortcut:
+   * - "accept": fires `onChange`, fires `onAccept` and closes the Picker.
+   * - "set": fires `onChange` but do not fire `onAccept` and does not close the Picker.
+   * @default "accept"
+   */
+  changeImportance?: PickerChangeImportance;
+}
+export interface PickersShortcutsProps<TValue extends PickerValidValue> extends ExportedPickersShortcutProps<TValue> {}
+/**
+ * Demos:
+ *
+ * - [Shortcuts](https://mui.com/x/react-date-pickers/shortcuts/)
+ *
+ * API:
+ *
+ * - [PickersShortcuts API](https://mui.com/x/api/date-pickers/pickers-shortcuts/)
+ */
+declare function PickersShortcuts<TValue extends PickerValidValue>(props: PickersShortcutsProps<TValue>): import("react/jsx-runtime").JSX.Element | null;
+declare namespace PickersShortcuts {
+  var propTypes: any;
+}
+export { PickersShortcuts };

package/PickersShortcuts/PickersShortcuts.mjs

@@ -0,0 +1,123 @@
+'use client';
+
+import _extends from "@babel/runtime/helpers/esm/extends";
+import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
+const _excluded = ["items", "changeImportance"],
+  _excluded2 = ["getValue"];
+import { styled } from '@mui/material/styles';
+import PropTypes from 'prop-types';
+import List from '@mui/material/List';
+import ListItem from '@mui/material/ListItem';
+import Chip from '@mui/material/Chip';
+import { VIEW_HEIGHT } from "../internals/constants/dimensions.mjs";
+import { useIsValidValue, usePickerActionsContext } from "../hooks/index.mjs";
+import { jsx as _jsx } from "react/jsx-runtime";
+const PickersShortcutsRoot = styled(List, {
+  name: 'MuiPickersLayout',
+  slot: 'Shortcuts'
+})({});
+
+/**
+ * Demos:
+ *
+ * - [Shortcuts](https://mui.com/x/react-date-pickers/shortcuts/)
+ *
+ * API:
+ *
+ * - [PickersShortcuts API](https://mui.com/x/api/date-pickers/pickers-shortcuts/)
+ */
+function PickersShortcuts(props) {
+  const {
+      items,
+      changeImportance = 'accept'
+    } = props,
+    other = _objectWithoutPropertiesLoose(props, _excluded);
+  const {
+    setValue
+  } = usePickerActionsContext();
+  const isValidValue = useIsValidValue();
+  if (items == null || items.length === 0) {
+    return null;
+  }
+  const resolvedItems = items.map(_ref => {
+    let {
+        getValue
+      } = _ref,
+      item = _objectWithoutPropertiesLoose(_ref, _excluded2);
+    const newValue = getValue({
+      isValid: isValidValue
+    });
+    return _extends({}, item, {
+      label: item.label,
+      onClick: () => {
+        setValue(newValue, {
+          changeImportance,
+          shortcut: item,
+          source: 'view'
+        });
+      },
+      disabled: !isValidValue(newValue)
+    });
+  });
+  return /*#__PURE__*/_jsx(PickersShortcutsRoot, _extends({
+    dense: true,
+    sx: [{
+      maxHeight: VIEW_HEIGHT,
+      maxWidth: 200,
+      overflow: 'auto'
+    }, ...(Array.isArray(other.sx) ? other.sx : [other.sx])]
+  }, other, {
+    children: resolvedItems.map(item => {
+      return /*#__PURE__*/_jsx(ListItem, {
+        children: /*#__PURE__*/_jsx(Chip, _extends({}, item))
+      }, item.id ?? item.label);
+    })
+  }));
+}
+process.env.NODE_ENV !== "production" ? PickersShortcuts.propTypes = {
+  // ----------------------------- Warning --------------------------------
+  // | These PropTypes are generated from the TypeScript type definitions |
+  // | To update them edit the TypeScript types and run "pnpm proptypes"  |
+  // ----------------------------------------------------------------------
+  /**
+   * Importance of the change when picking a shortcut:
+   * - "accept": fires `onChange`, fires `onAccept` and closes the Picker.
+   * - "set": fires `onChange` but do not fire `onAccept` and does not close the Picker.
+   * @default "accept"
+   */
+  changeImportance: PropTypes.oneOf(['accept', 'set']),
+  className: PropTypes.string,
+  component: PropTypes.elementType,
+  /**
+   * If `true`, compact vertical padding designed for keyboard and mouse input is used for
+   * the list and list items.
+   * The prop is available to descendant components as the `dense` context.
+   * @default false
+   */
+  dense: PropTypes.bool,
+  /**
+   * If `true`, vertical padding is removed from the list.
+   * @default false
+   */
+  disablePadding: PropTypes.bool,
+  /**
+   * Ordered array of shortcuts to display.
+   * If empty, does not display the shortcuts.
+   * @default []
+   */
+  items: PropTypes.arrayOf(PropTypes.shape({
+    getValue: PropTypes.func.isRequired,
+    id: PropTypes.string,
+    label: PropTypes.string.isRequired
+  })),
+  style: PropTypes.object,
+  /**
+   * The content of the subheader, normally `ListSubheader`.
+   */
+  subheader: PropTypes.node,
+  /**
+   * 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])
+} : void 0;
+export { PickersShortcuts };

package/PickersShortcuts/index.d.mts

@@ -0,0 +1,2 @@
+export { PickersShortcuts } from "./PickersShortcuts.mjs";
+export type { PickersShortcutsProps, PickersShortcutsItem, PickersShortcutsItemContext } from "./PickersShortcuts.mjs";

package/PickersShortcuts/index.mjs

@@ -0,0 +1 @@
+export { PickersShortcuts } from "./PickersShortcuts.mjs";

package/PickersTextField/PickersFilledInput/PickersFilledInput.d.mts

@@ -0,0 +1,19 @@
+import * as React from 'react';
+import { PickersInputBaseProps } from "../PickersInputBase/index.mjs";
+import { PickerTextFieldOwnerState } from "../../models/fields.mjs";
+export interface PickersFilledInputProps extends PickersInputBaseProps {
+  disableUnderline?: boolean;
+  hiddenLabel?: boolean;
+}
+export interface PickerFilledInputOwnerState extends PickerTextFieldOwnerState {
+  /**
+   * `true` if the input  has an underline, `false` otherwise.
+   */
+  inputHasUnderline: boolean;
+  hiddenLabel?: boolean;
+}
+/**
+ * @ignore - internal component.
+ */
+declare const PickersFilledInput: React.ForwardRefExoticComponent<Omit<PickersFilledInputProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export { PickersFilledInput };