@mui/material 7.0.0-alpha.2 → 7.0.0-beta.1

package/Rating/Rating.js

@@ -7,7 +7,8 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = void 0;
-var React = _interopRequireWildcard(require("react"));
+var _react = _interopRequireWildcard(require("react"));
+var React = _react;
 var _propTypes = _interopRequireDefault(require("prop-types"));
 var _clsx = _interopRequireDefault(require("clsx"));
 var _clamp = _interopRequireDefault(require("@mui/utils/clamp"));
@@ -24,6 +25,7 @@ var _memoTheme = _interopRequireDefault(require("../utils/memoTheme"));
 var _DefaultPropsProvider = require("../DefaultPropsProvider");
 var _slotShouldForwardProp = _interopRequireDefault(require("../styles/slotShouldForwardProp"));
 var _ratingClasses = _interopRequireWildcard(require("./ratingClasses"));
+var _useSlot = _interopRequireDefault(require("../utils/useSlot"));
 var _jsxRuntime = require("react/jsx-runtime");
 function getDecimalPrecision(num) {
   const decimalPart = num.toString().split('.')[1];
@@ -227,7 +229,9 @@ function RatingItem(props) {
     readOnly,
     ownerState,
     ratingValue,
-    ratingValueRounded
+    ratingValueRounded,
+    slots = {},
+    slotProps = {}
   } = props;
   const isFilled = highlightSelectedOnly ? itemValue === ratingValue : itemValue <= ratingValue;
   const isHovered = itemValue <= hover;
@@ -239,10 +243,14 @@ function RatingItem(props) {
   // Update to const id = useId(); when React 17 support is dropped.
   // More details: https://github.com/mui/material-ui/issues/40997
   const id = `${name}-${(0, _utils.unstable_useId)()}`;
-  const container = /*#__PURE__*/(0, _jsxRuntime.jsx)(RatingIcon, {
-    as: IconContainerComponent,
-    value: itemValue,
+  const externalForwardedProps = {
+    slots,
+    slotProps
+  };
+  const [IconSlot, iconSlotProps] = (0, _useSlot.default)('icon', {
+    elementType: RatingIcon,
     className: (0, _clsx.default)(classes.icon, isFilled ? classes.iconFilled : classes.iconEmpty, isHovered && classes.iconHover, isFocused && classes.iconFocus, isActive && classes.iconActive),
+    externalForwardedProps,
     ownerState: {
       ...ownerState,
       iconEmpty: !isFilled,
@@ -251,6 +259,29 @@ function RatingItem(props) {
       iconFocus: isFocused,
       iconActive: isActive
     },
+    additionalProps: {
+      value: itemValue
+    },
+    internalForwardedProps: {
+      // TODO: remove this in v7 because `IconContainerComponent` is deprecated
+      // only forward if `slots.icon` is NOT provided
+      as: IconContainerComponent
+    }
+  });
+  const [LabelSlot, labelSlotProps] = (0, _useSlot.default)('label', {
+    elementType: RatingLabel,
+    externalForwardedProps,
+    ownerState: {
+      ...ownerState,
+      emptyValueFocused: undefined
+    },
+    additionalProps: {
+      style: labelProps?.style,
+      htmlFor: id
+    }
+  });
+  const container = /*#__PURE__*/(0, _jsxRuntime.jsx)(IconSlot, {
+    ...iconSlotProps,
     children: emptyIcon && !isFilled ? emptyIcon : icon
   });
   if (readOnly) {
@@ -260,13 +291,8 @@ function RatingItem(props) {
     });
   }
   return /*#__PURE__*/(0, _jsxRuntime.jsxs)(React.Fragment, {
-    children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)(RatingLabel, {
-      ownerState: {
-        ...ownerState,
-        emptyValueFocused: undefined
-      },
-      htmlFor: id,
-      ...labelProps,
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)(LabelSlot, {
+      ...labelSlotProps,
       children: [container, /*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
         className: classes.visuallyHidden,
         children: getLabelText(itemValue)
@@ -307,7 +333,9 @@ process.env.NODE_ENV !== "production" ? RatingItem.propTypes = {
   ownerState: _propTypes.default.object.isRequired,
   ratingValue: _propTypes.default.number,
   ratingValueRounded: _propTypes.default.number,
-  readOnly: _propTypes.default.bool.isRequired
+  readOnly: _propTypes.default.bool.isRequired,
+  slotProps: _propTypes.default.object,
+  slots: _propTypes.default.object
 } : void 0;
 const defaultIcon = /*#__PURE__*/(0, _jsxRuntime.jsx)(_Star.default, {
   fontSize: "inherit"
@@ -344,6 +372,8 @@ const Rating = /*#__PURE__*/React.forwardRef(function Rating(inProps, ref) {
     readOnly = false,
     size = 'medium',
     value: valueProp,
+    slots = {},
+    slotProps = {},
     ...other
   } = props;
   const name = (0, _utils.unstable_useId)(nameProp);
@@ -481,16 +511,50 @@ const Rating = /*#__PURE__*/React.forwardRef(function Rating(inProps, ref) {
     size
   };
   const classes = useUtilityClasses(ownerState);
-  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(RatingRoot, {
-    as: component,
+  const externalForwardedProps = {
+    slots,
+    slotProps
+  };
+  const [RootSlot, rootSlotProps] = (0, _useSlot.default)('root', {
     ref: handleRef,
-    onMouseMove: handleMouseMove,
-    onMouseLeave: handleMouseLeave,
-    className: (0, _clsx.default)(classes.root, className, readOnly && 'MuiRating-readOnly'),
-    ownerState: ownerState,
-    role: readOnly ? 'img' : null,
-    "aria-label": readOnly ? getLabelText(value) : null,
-    ...other,
+    className: (0, _clsx.default)(classes.root, className),
+    elementType: RatingRoot,
+    externalForwardedProps: {
+      ...externalForwardedProps,
+      ...other,
+      component
+    },
+    getSlotProps: handlers => ({
+      ...handlers,
+      onMouseMove: event => {
+        handleMouseMove(event);
+        handlers.onMouseMove?.(event);
+      },
+      onMouseLeave: event => {
+        handleMouseLeave(event);
+        handlers.onMouseLeave?.(event);
+      }
+    }),
+    ownerState,
+    additionalProps: {
+      role: readOnly ? 'img' : null,
+      'aria-label': readOnly ? getLabelText(value) : null
+    }
+  });
+  const [LabelSlot, labelSlotProps] = (0, _useSlot.default)('label', {
+    className: (0, _clsx.default)(classes.label, classes.labelEmptyValue),
+    elementType: RatingLabel,
+    externalForwardedProps,
+    ownerState
+  });
+  const [DecimalSlot, decimalSlotProps] = (0, _useSlot.default)('decimal', {
+    className: classes.decimal,
+    elementType: RatingDecimal,
+    externalForwardedProps,
+    ownerState
+  });
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(RootSlot, {
+    ...rootSlotProps,
     children: [Array.from(new Array(max)).map((_, index) => {
       const itemValue = index + 1;
       const ratingItemProps = {
@@ -511,41 +575,42 @@ const Rating = /*#__PURE__*/React.forwardRef(function Rating(inProps, ref) {
         ratingValue: value,
         ratingValueRounded: valueRounded,
         readOnly,
-        ownerState
+        ownerState,
+        slots,
+        slotProps
       };
       const isActive = itemValue === Math.ceil(value) && (hover !== -1 || focus !== -1);
       if (precision < 1) {
         const items = Array.from(new Array(1 / precision));
-        return /*#__PURE__*/(0, _jsxRuntime.jsx)(RatingDecimal, {
-          className: (0, _clsx.default)(classes.decimal, isActive && classes.iconActive),
-          ownerState: ownerState,
-          iconActive: isActive,
-          children: items.map(($, indexDecimal) => {
-            const itemDecimalValue = roundValueToPrecision(itemValue - 1 + (indexDecimal + 1) * precision, precision);
-            return /*#__PURE__*/(0, _jsxRuntime.jsx)(RatingItem, {
-              ...ratingItemProps,
-              // The icon is already displayed as active
-              isActive: false,
-              itemValue: itemDecimalValue,
-              labelProps: {
-                style: items.length - 1 === indexDecimal ? {} : {
-                  width: itemDecimalValue === value ? `${(indexDecimal + 1) * precision * 100}%` : '0%',
-                  overflow: 'hidden',
-                  position: 'absolute'
-                }
+        return /*#__PURE__*/(0, _react.createElement)(DecimalSlot, {
+          ...decimalSlotProps,
+          key: itemValue,
+          className: (0, _clsx.default)(decimalSlotProps.className, isActive && classes.iconActive),
+          iconActive: isActive
+        }, items.map(($, indexDecimal) => {
+          const itemDecimalValue = roundValueToPrecision(itemValue - 1 + (indexDecimal + 1) * precision, precision);
+          return /*#__PURE__*/(0, _jsxRuntime.jsx)(RatingItem, {
+            ...ratingItemProps,
+            // The icon is already displayed as active
+            isActive: false,
+            itemValue: itemDecimalValue,
+            labelProps: {
+              style: items.length - 1 === indexDecimal ? {} : {
+                width: itemDecimalValue === value ? `${(indexDecimal + 1) * precision * 100}%` : '0%',
+                overflow: 'hidden',
+                position: 'absolute'
               }
-            }, itemDecimalValue);
-          })
-        }, itemValue);
+            }
+          }, itemDecimalValue);
+        }));
       }
       return /*#__PURE__*/(0, _jsxRuntime.jsx)(RatingItem, {
         ...ratingItemProps,
         isActive: isActive,
         itemValue: itemValue
       }, itemValue);
-    }), !readOnly && !disabled && /*#__PURE__*/(0, _jsxRuntime.jsxs)(RatingLabel, {
-      className: (0, _clsx.default)(classes.label, classes.labelEmptyValue),
-      ownerState: ownerState,
+    }), !readOnly && !disabled && /*#__PURE__*/(0, _jsxRuntime.jsxs)(LabelSlot, {
+      ...labelSlotProps,
       children: [/*#__PURE__*/(0, _jsxRuntime.jsx)("input", {
         className: classes.visuallyHidden,
         value: "",
@@ -629,6 +694,7 @@ process.env.NODE_ENV !== "production" ? Rating.propTypes /* remove-proptypes */
   icon: _propTypes.default.node,
   /**
    * The component containing the icon.
+   * @deprecated Use `slotProps.icon.component` instead. This prop will be removed in v7. See [Migrating from deprecated APIs](/material-ui/migration/migrating-from-deprecated-apis/) for more details.
    * @default function IconContainer(props) {
    *   const { value, ...other } = props;
    *   return <span {...other} />;
@@ -686,6 +752,26 @@ process.env.NODE_ENV !== "production" ? Rating.propTypes /* remove-proptypes */
    * @default 'medium'
    */
   size: _propTypes.default /* @typescript-to-proptypes-ignore */.oneOfType([_propTypes.default.oneOf(['small', 'medium', 'large']), _propTypes.default.string]),
+  /**
+   * The props used for each slot inside.
+   * @default {}
+   */
+  slotProps: _propTypes.default.shape({
+    decimal: _propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.object]),
+    icon: _propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.object]),
+    label: _propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.object]),
+    root: _propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.object])
+  }),
+  /**
+   * The components used for each slot inside.
+   * @default {}
+   */
+  slots: _propTypes.default.shape({
+    decimal: _propTypes.default.elementType,
+    icon: _propTypes.default.elementType,
+    label: _propTypes.default.elementType,
+    root: _propTypes.default.elementType
+  }),
   /**
    * The system prop that allows defining system overrides as well as additional CSS styles.
    */

package/Select/SelectInput.js

@@ -507,16 +507,16 @@ const SelectInput = /*#__PURE__*/React.forwardRef(function SelectInput(props, re
         horizontal: 'center'
       },
       ...MenuProps,
-      MenuListProps: {
-        'aria-labelledby': labelId,
-        role: 'listbox',
-        'aria-multiselectable': multiple ? 'true' : undefined,
-        disableListWrap: true,
-        id: listboxId,
-        ...MenuProps.MenuListProps
-      },
       slotProps: {
         ...MenuProps.slotProps,
+        list: {
+          'aria-labelledby': labelId,
+          role: 'listbox',
+          'aria-multiselectable': multiple ? 'true' : undefined,
+          disableListWrap: true,
+          id: listboxId,
+          ...MenuProps.MenuListProps
+        },
         paper: {
           ...paperProps,
           style: {

package/StepButton/StepButton.d.ts

@@ -4,11 +4,6 @@ import { ButtonBaseTypeMap, ExtendButtonBase, ExtendButtonBaseTypeMap } from "..
 import { OverrideProps } from "../OverridableComponent/index.js";
 import { Theme } from "../styles/index.js";
 import { StepButtonClasses } from "./stepButtonClasses.js";
-
-/**
- * @deprecated use `StepButtonProps['icon']` instead.
- */
-export type StepButtonIcon = React.ReactNode;
 export interface StepButtonOwnProps {
   /**
    * Can be a `StepLabel` or a node to place inside `StepLabel` as children.

package/esm/Dialog/Dialog.d.ts

@@ -111,11 +111,6 @@ export interface DialogProps extends Omit<StandardProps<ModalProps, 'children'>,
    * @default 'sm'
    */
   maxWidth?: Breakpoint | false;
-  /**
-   * Callback fired when the backdrop is clicked.
-   * @deprecated Use the `onClose` prop with the `reason` argument to handle the `backdropClick` events.
-   */
-  onBackdropClick?: ModalProps['onBackdropClick'];
   /**
    * Callback fired when the component requests to be closed.
    *

package/esm/Dialog/Dialog.js

@@ -212,7 +212,6 @@ const Dialog = /*#__PURE__*/React.forwardRef(function Dialog(inProps, ref) {
     fullScreen = false,
     fullWidth = false,
     maxWidth = 'sm',
-    onBackdropClick,
     onClick,
     onClose,
     open,
@@ -251,9 +250,6 @@ const Dialog = /*#__PURE__*/React.forwardRef(function Dialog(inProps, ref) {
       return;
     }
     backdropClick.current = null;
-    if (onBackdropClick) {
-      onBackdropClick(event);
-    }
     if (onClose) {
       onClose(event, 'backdropClick');
     }
@@ -430,11 +426,6 @@ process.env.NODE_ENV !== "production" ? Dialog.propTypes /* remove-proptypes */
    * @default 'sm'
    */
   maxWidth: PropTypes /* @typescript-to-proptypes-ignore */.oneOfType([PropTypes.oneOf(['xs', 'sm', 'md', 'lg', 'xl', false]), PropTypes.string]),
-  /**
-   * Callback fired when the backdrop is clicked.
-   * @deprecated Use the `onClose` prop with the `reason` argument to handle the `backdropClick` events.
-   */
-  onBackdropClick: PropTypes.func,
   /**
    * @ignore
    */

package/esm/Grid/Grid.d.ts

@@ -1,77 +1,17 @@
-import * as React from 'react';
-import { ResponsiveStyleValue, SxProps, SystemProps, Breakpoint, BreakpointOverrides } from '@mui/system';
-import { IfEquals } from '@mui/types';
-import { Theme } from "../styles/index.js";
-import { OverridableComponent, OverrideProps } from "../OverridableComponent/index.js";
-import { GridClasses } from "./gridClasses.js";
+import { SxProps, SystemProps } from '@mui/system';
+import { OverridableComponent, OverrideProps } from '@mui/types';
+import { Theme, Breakpoint } from "../styles/index.js";
+type ResponsiveStyleValue<T> = T | Array<T | null> | { [key in Breakpoint]?: T | null };
 export type GridDirection = 'row' | 'row-reverse' | 'column' | 'column-reverse';
 export type GridSpacing = number | string;
 export type GridWrap = 'nowrap' | 'wrap' | 'wrap-reverse';
-export type GridSize = 'auto' | number;
-export interface RegularBreakpoints {
-  /**
-   * If a number, it sets the number of columns the grid item uses.
-   * It can't be greater than the total number of columns of the container (12 by default).
-   * If 'auto', the grid item's width matches its content.
-   * If false, the prop is ignored.
-   * If true, the grid item's width grows to use the space available in the grid container.
-   * The value is applied for the `lg` breakpoint and wider screens if not overridden.
-   * @default false
-   */
-  lg?: boolean | GridSize;
-  /**
-   * If a number, it sets the number of columns the grid item uses.
-   * It can't be greater than the total number of columns of the container (12 by default).
-   * If 'auto', the grid item's width matches its content.
-   * If false, the prop is ignored.
-   * If true, the grid item's width grows to use the space available in the grid container.
-   * The value is applied for the `md` breakpoint and wider screens if not overridden.
-   * @default false
-   */
-  md?: boolean | GridSize;
-  /**
-   * If a number, it sets the number of columns the grid item uses.
-   * It can't be greater than the total number of columns of the container (12 by default).
-   * If 'auto', the grid item's width matches its content.
-   * If false, the prop is ignored.
-   * If true, the grid item's width grows to use the space available in the grid container.
-   * The value is applied for the `sm` breakpoint and wider screens if not overridden.
-   * @default false
-   */
-  sm?: boolean | GridSize;
-  /**
-   * If a number, it sets the number of columns the grid item uses.
-   * It can't be greater than the total number of columns of the container (12 by default).
-   * If 'auto', the grid item's width matches its content.
-   * If false, the prop is ignored.
-   * If true, the grid item's width grows to use the space available in the grid container.
-   * The value is applied for the `xl` breakpoint and wider screens if not overridden.
-   * @default false
-   */
-  xl?: boolean | GridSize;
-  /**
-   * If a number, it sets the number of columns the grid item uses.
-   * It can't be greater than the total number of columns of the container (12 by default).
-   * If 'auto', the grid item's width matches its content.
-   * If false, the prop is ignored.
-   * If true, the grid item's width grows to use the space available in the grid container.
-   * The value is applied for all the screen sizes with the lowest priority.
-   * @default false
-   */
-  xs?: boolean | GridSize;
-}
-type CustomBreakpoints = Partial<Record<Breakpoint, boolean | GridSize>>;
-interface BreakpointOverridesEmpty {}
-type Breakpoints = IfEquals<BreakpointOverrides, BreakpointOverridesEmpty, RegularBreakpoints, CustomBreakpoints>;
-export interface GridOwnProps extends SystemProps<Theme>, Breakpoints {
+export type GridSize = 'auto' | 'grow' | number | false;
+export type GridOffset = 'auto' | number;
+export interface GridBaseProps {
   /**
    * The content of the component.
    */
   children?: React.ReactNode;
-  /**
-   * Override or extend the styles applied to the component.
-   */
-  classes?: Partial<GridClasses>;
   /**
    * The number of columns.
    * @default 12
@@ -95,48 +35,68 @@ export interface GridOwnProps extends SystemProps<Theme>, Breakpoints {
    */
   direction?: ResponsiveStyleValue<GridDirection>;
   /**
-   * If `true`, the component will have the flex *item* behavior.
-   * You should be wrapping *items* with a *container*.
-   * @default false
-   */
-  item?: boolean;
+   * Defines the offset value for the type `item` components.
+   */
+  offset?: ResponsiveStyleValue<GridOffset>;
+  /**
+   * @internal
+   * The level of the grid starts from `0` and increases when the grid nests
+   * inside another grid. Nesting is defined as a container Grid being a direct
+   * child of a container Grid.
+   *
+   * ```js
+   * <Grid container> // level 0
+   *   <Grid container> // level 1
+   *     <Grid container> // level 2
+   * ```
+   *
+   * Only consecutive grid is considered nesting. A grid container will start at
+   * `0` if there are non-Grid container element above it.
+   *
+   * ```js
+   * <Grid container> // level 0
+   *   <div>
+   *     <Grid container> // level 0
+   * ```
+   *
+   * ```js
+   * <Grid container> // level 0
+   *   <Grid>
+   *     <Grid container> // level 0
+   * ```
+   */
+  unstable_level?: number;
   /**
    * Defines the vertical space between the type `item` components.
    * It overrides the value of the `spacing` prop.
    */
   rowSpacing?: ResponsiveStyleValue<GridSpacing>;
+  /**
+   * Defines the size of the the type `item` components.
+   */
+  size?: ResponsiveStyleValue<GridSize>;
   /**
    * Defines the space between the type `item` components.
    * It can only be used on a type `container` component.
    * @default 0
    */
-  spacing?: ResponsiveStyleValue<GridSpacing>;
-  /**
-   * The system prop that allows defining system overrides as well as additional CSS styles.
-   */
-  sx?: SxProps<Theme>;
+  spacing?: ResponsiveStyleValue<GridSpacing> | undefined;
   /**
    * Defines the `flex-wrap` style property.
    * It's applied for all screen sizes.
    * @default 'wrap'
    */
   wrap?: GridWrap;
-  /**
-   * If `true`, it sets `min-width: 0` on the item.
-   * Refer to the limitations section of the documentation to better understand the use case.
-   * @default false
-   */
-  zeroMinWidth?: boolean;
 }
-
-/**
- * @deprecated Use the [`Grid2`](https://mui.com/material-ui/react-grid2/) component instead.
- */
-export interface GridTypeMap<AdditionalProps = {}, RootComponent extends React.ElementType = 'div'> {
-  props: AdditionalProps & GridOwnProps;
-  defaultComponent: RootComponent;
+export interface GridTypeMap<P = {}, D extends React.ElementType = 'div'> {
+  props: P & GridBaseProps & {
+    sx?: SxProps<Theme>;
+  } & SystemProps<Theme>;
+  defaultComponent: D;
 }
-
+export type GridProps<D extends React.ElementType = GridTypeMap['defaultComponent'], P = {
+  component?: React.ElementType;
+}> = OverrideProps<GridTypeMap<P, D>, D>;
 /**
  *
  * Demos:
@@ -146,15 +106,6 @@ export interface GridTypeMap<AdditionalProps = {}, RootComponent extends React.E
  * API:
  *
  * - [Grid API](https://next.mui.com/material-ui/api/grid/)
- *
- * @deprecated Use the [`Grid2`](https://mui.com/material-ui/react-grid2/) component instead.
  */
 declare const Grid: OverridableComponent<GridTypeMap>;
-
-/**
- * @deprecated Use the [`Grid2`](https://mui.com/material-ui/react-grid2/) component instead.
- */
-export type GridProps<RootComponent extends React.ElementType = GridTypeMap['defaultComponent'], AdditionalProps = {}> = OverrideProps<GridTypeMap<AdditionalProps, RootComponent>, RootComponent> & {
-  component?: React.ElementType;
-};
 export default Grid;