@mui/material 6.4.5 → 6.4.6

package/modern/Snackbar/Snackbar.js

@@ -3,7 +3,6 @@
 import * as React from 'react';
 import PropTypes from 'prop-types';
 import composeClasses from '@mui/utils/composeClasses';
-import useSlotProps from '@mui/utils/useSlotProps';
 import useSnackbar from "./useSnackbar.js";
 import ClickAwayListener from "../ClickAwayListener/index.js";
 import { styled, useTheme } from "../zero-styled/index.js";
@@ -13,6 +12,7 @@ import capitalize from "../utils/capitalize.js";
 import Grow from "../Grow/index.js";
 import SnackbarContent from "../SnackbarContent/index.js";
 import { getSnackbarUtilityClass } from "./snackbarClasses.js";
+import useSlot from "../utils/useSlot.js";
 import { jsx as _jsx } from "react/jsx-runtime";
 const useUtilityClasses = ownerState => {
   const {
@@ -120,8 +120,8 @@ const Snackbar = /*#__PURE__*/React.forwardRef(function Snackbar(inProps, ref) {
     autoHideDuration = null,
     children,
     className,
-    ClickAwayListenerProps,
-    ContentProps,
+    ClickAwayListenerProps: ClickAwayListenerPropsProp,
+    ContentProps: ContentPropsProp,
     disableWindowBlurListener = false,
     message,
     onBlur,
@@ -131,12 +131,14 @@ const Snackbar = /*#__PURE__*/React.forwardRef(function Snackbar(inProps, ref) {
     onMouseLeave,
     open,
     resumeHideDuration,
-    TransitionComponent = Grow,
+    slots = {},
+    slotProps = {},
+    TransitionComponent: TransitionComponentProp,
     transitionDuration = defaultTransitionDuration,
     TransitionProps: {
       onEnter,
       onExited,
-      ...TransitionProps
+      ...TransitionPropsProp
     } = {},
     ...other
   } = props;
@@ -148,7 +150,7 @@ const Snackbar = /*#__PURE__*/React.forwardRef(function Snackbar(inProps, ref) {
     },
     autoHideDuration,
     disableWindowBlurListener,
-    TransitionComponent,
+    TransitionComponent: TransitionComponentProp,
     transitionDuration
   };
   const classes = useUtilityClasses(ownerState);
@@ -159,16 +161,6 @@ const Snackbar = /*#__PURE__*/React.forwardRef(function Snackbar(inProps, ref) {
     ...ownerState
   });
   const [exited, setExited] = React.useState(true);
-  const rootProps = useSlotProps({
-    elementType: SnackbarRoot,
-    getSlotProps: getRootProps,
-    externalForwardedProps: other,
-    ownerState,
-    additionalProps: {
-      ref
-    },
-    className: [classes.root, className]
-  });
   const handleExited = node => {
     setExited(true);
     if (onExited) {
@@ -181,28 +173,84 @@ const Snackbar = /*#__PURE__*/React.forwardRef(function Snackbar(inProps, ref) {
       onEnter(node, isAppearing);
     }
   };
+  const externalForwardedProps = {
+    slots: {
+      transition: TransitionComponentProp,
+      ...slots
+    },
+    slotProps: {
+      content: ContentPropsProp,
+      clickAwayListener: ClickAwayListenerPropsProp,
+      transition: TransitionPropsProp,
+      ...slotProps
+    }
+  };
+  const [Root, rootProps] = useSlot('root', {
+    ref,
+    className: [classes.root, className],
+    elementType: SnackbarRoot,
+    getSlotProps: getRootProps,
+    externalForwardedProps: {
+      ...externalForwardedProps,
+      ...other
+    },
+    ownerState
+  });
+  const [ClickAwaySlot, clickAwayListenerProps] = useSlot('clickAwayListener', {
+    elementType: ClickAwayListener,
+    externalForwardedProps,
+    getSlotProps: handlers => ({
+      onClickAway: (...params) => {
+        handlers.onClickAway?.(...params);
+        onClickAway(...params);
+      }
+    }),
+    ownerState
+  });
+  const [ContentSlot, contentSlotProps] = useSlot('content', {
+    elementType: SnackbarContent,
+    shouldForwardComponentProp: true,
+    externalForwardedProps,
+    additionalProps: {
+      message,
+      action
+    },
+    ownerState
+  });
+  const [TransitionSlot, transitionProps] = useSlot('transition', {
+    elementType: Grow,
+    externalForwardedProps,
+    getSlotProps: handlers => ({
+      onEnter: (...params) => {
+        handlers.onEnter?.(...params);
+        handleEnter(...params);
+      },
+      onExited: (...params) => {
+        handlers.onExited?.(...params);
+        handleExited(...params);
+      }
+    }),
+    additionalProps: {
+      appear: true,
+      in: open,
+      timeout: transitionDuration,
+      direction: vertical === 'top' ? 'down' : 'up'
+    },
+    ownerState
+  });
 
   // So we only render active snackbars.
   if (!open && exited) {
     return null;
   }
-  return /*#__PURE__*/_jsx(ClickAwayListener, {
-    onClickAway: onClickAway,
-    ...ClickAwayListenerProps,
-    children: /*#__PURE__*/_jsx(SnackbarRoot, {
+  return /*#__PURE__*/_jsx(ClickAwaySlot, {
+    ...clickAwayListenerProps,
+    children: /*#__PURE__*/_jsx(Root, {
       ...rootProps,
-      children: /*#__PURE__*/_jsx(TransitionComponent, {
-        appear: true,
-        in: open,
-        timeout: transitionDuration,
-        direction: vertical === 'top' ? 'down' : 'up',
-        onEnter: handleEnter,
-        onExited: handleExited,
-        ...TransitionProps,
-        children: children || /*#__PURE__*/_jsx(SnackbarContent, {
-          message: message,
-          action: action,
-          ...ContentProps
+      children: /*#__PURE__*/_jsx(TransitionSlot, {
+        ...transitionProps,
+        children: children || /*#__PURE__*/_jsx(ContentSlot, {
+          ...contentSlotProps
         })
       })
     })
@@ -249,10 +297,12 @@ process.env.NODE_ENV !== "production" ? Snackbar.propTypes /* remove-proptypes *
   className: PropTypes.string,
   /**
    * Props applied to the `ClickAwayListener` element.
+   * @deprecated Use `slotProps.clickAwayListener` instead. This prop will be removed in v7. See [Migrating from deprecated APIs](/material-ui/migration/migrating-from-deprecated-apis/) for more details.
    */
   ClickAwayListenerProps: PropTypes.object,
   /**
    * Props applied to the [`SnackbarContent`](https://mui.com/material-ui/api/snackbar-content/) element.
+   * @deprecated Use `slotProps.content` instead. This prop will be removed in v7. See [Migrating from deprecated APIs](/material-ui/migration/migrating-from-deprecated-apis/) for more details.
    */
   ContentProps: PropTypes.object,
   /**
@@ -309,6 +359,32 @@ process.env.NODE_ENV !== "production" ? Snackbar.propTypes /* remove-proptypes *
    * we default to `autoHideDuration / 2` ms.
    */
   resumeHideDuration: PropTypes.number,
+  /**
+   * The props used for each slot inside.
+   * @default {}
+   */
+  slotProps: PropTypes.shape({
+    clickAwayListener: PropTypes.oneOfType([PropTypes.func, PropTypes.shape({
+      children: PropTypes.element.isRequired,
+      disableReactTree: PropTypes.bool,
+      mouseEvent: PropTypes.oneOf(['onClick', 'onMouseDown', 'onMouseUp', 'onPointerDown', 'onPointerUp', false]),
+      onClickAway: PropTypes.func,
+      touchEvent: PropTypes.oneOf(['onTouchEnd', 'onTouchStart', false])
+    })]),
+    content: PropTypes.oneOfType([PropTypes.func, PropTypes.object]),
+    root: PropTypes.oneOfType([PropTypes.func, PropTypes.object]),
+    transition: PropTypes.oneOfType([PropTypes.func, PropTypes.object])
+  }),
+  /**
+   * The components used for each slot inside.
+   * @default {}
+   */
+  slots: PropTypes.shape({
+    clickAwayListener: PropTypes.elementType,
+    content: PropTypes.elementType,
+    root: PropTypes.elementType,
+    transition: PropTypes.elementType
+  }),
   /**
    * The system prop that allows defining system overrides as well as additional CSS styles.
    */
@@ -316,6 +392,7 @@ process.env.NODE_ENV !== "production" ? Snackbar.propTypes /* remove-proptypes *
   /**
    * The component used for the transition.
    * [Follow this guide](https://mui.com/material-ui/transitions/#transitioncomponent-prop) to learn more about the requirements for this component.
+   * @deprecated Use `slots.transition` instead. This prop will be removed in v7. See [Migrating from deprecated APIs](/material-ui/migration/migrating-from-deprecated-apis/) for more details.
    * @default Grow
    */
   TransitionComponent: PropTypes.elementType,
@@ -335,6 +412,7 @@ process.env.NODE_ENV !== "production" ? Snackbar.propTypes /* remove-proptypes *
   /**
    * Props applied to the transition element.
    * By default, the element is based on this [`Transition`](https://reactcommunity.org/react-transition-group/transition/) component.
+   * @deprecated Use `slotProps.transition` instead. This prop will be removed in v7. See [Migrating from deprecated APIs](/material-ui/migration/migrating-from-deprecated-apis/) for more details.
    * @default {}
    */
   TransitionProps: PropTypes.object

package/modern/SpeedDialAction/SpeedDialAction.js

@@ -13,6 +13,8 @@ import Fab from "../Fab/index.js";
 import Tooltip from "../Tooltip/index.js";
 import capitalize from "../utils/capitalize.js";
 import speedDialActionClasses, { getSpeedDialActionUtilityClass } from "./speedDialActionClasses.js";
+import useSlot from "../utils/useSlot.js";
+import { mergeSlotProps } from "../utils/index.js";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 const useUtilityClasses = ownerState => {
   const {
@@ -147,6 +149,8 @@ const SpeedDialAction = /*#__PURE__*/React.forwardRef(function SpeedDialAction(i
     tooltipOpen: tooltipOpenProp = false,
     tooltipPlacement = 'left',
     tooltipTitle,
+    slots = {},
+    slotProps = {},
     ...other
   } = props;
   const ownerState = {
@@ -154,7 +158,20 @@ const SpeedDialAction = /*#__PURE__*/React.forwardRef(function SpeedDialAction(i
     tooltipPlacement
   };
   const classes = useUtilityClasses(ownerState);
-  const [tooltipOpen, setTooltipOpen] = React.useState(tooltipOpenProp);
+  const externalForwardedProps = {
+    slots,
+    slotProps: {
+      fab: FabProps,
+      ...slotProps,
+      tooltip: mergeSlotProps(typeof slotProps.tooltip === 'function' ? slotProps.tooltip(ownerState) : slotProps.tooltip, {
+        title: tooltipTitle,
+        open: tooltipOpenProp,
+        placement: tooltipPlacement,
+        classes: TooltipClasses
+      })
+    }
+  };
+  const [tooltipOpen, setTooltipOpen] = React.useState(externalForwardedProps.slotProps.tooltip?.open);
   const handleTooltipClose = () => {
     setTooltipOpen(false);
   };
@@ -164,32 +181,71 @@ const SpeedDialAction = /*#__PURE__*/React.forwardRef(function SpeedDialAction(i
   const transitionStyle = {
     transitionDelay: `${delay}ms`
   };
-  const fab = /*#__PURE__*/_jsx(SpeedDialActionFab, {
-    size: "small",
+  const [FabSlot, fabSlotProps] = useSlot('fab', {
+    elementType: SpeedDialActionFab,
+    externalForwardedProps,
+    ownerState,
+    shouldForwardComponentProp: true,
     className: clsx(classes.fab, className),
-    tabIndex: -1,
-    role: "menuitem",
-    ownerState: ownerState,
-    ...FabProps,
-    style: {
-      ...transitionStyle,
-      ...FabProps.style
+    additionalProps: {
+      style: transitionStyle,
+      tabIndex: -1,
+      role: 'menuitem',
+      size: 'small'
+    }
+  });
+  const [TooltipSlot, tooltipSlotProps] = useSlot('tooltip', {
+    elementType: Tooltip,
+    externalForwardedProps,
+    shouldForwardComponentProp: true,
+    ref,
+    additionalProps: {
+      id
     },
+    ownerState,
+    getSlotProps: handlers => ({
+      ...handlers,
+      onClose: event => {
+        handlers.onClose?.(event);
+        handleTooltipClose();
+      },
+      onOpen: event => {
+        handlers.onOpen?.(event);
+        handleTooltipOpen();
+      }
+    })
+  });
+  const [StaticTooltipSlot, staticTooltipSlotProps] = useSlot('staticTooltip', {
+    elementType: SpeedDialActionStaticTooltip,
+    externalForwardedProps,
+    ownerState,
+    ref,
+    className: classes.staticTooltip,
+    additionalProps: {
+      id
+    }
+  });
+  const [StaticTooltipLabelSlot, staticTooltipLabelSlotProps] = useSlot('staticTooltipLabel', {
+    elementType: SpeedDialActionStaticTooltipLabel,
+    externalForwardedProps,
+    ownerState,
+    className: classes.staticTooltipLabel,
+    additionalProps: {
+      style: transitionStyle,
+      id: `${id}-label`
+    }
+  });
+  const fab = /*#__PURE__*/_jsx(FabSlot, {
+    ...fabSlotProps,
     children: icon
   });
-  if (tooltipOpenProp) {
-    return /*#__PURE__*/_jsxs(SpeedDialActionStaticTooltip, {
-      id: id,
-      ref: ref,
-      className: classes.staticTooltip,
-      ownerState: ownerState,
+  if (tooltipSlotProps.open) {
+    return /*#__PURE__*/_jsxs(StaticTooltipSlot, {
+      ...staticTooltipSlotProps,
       ...other,
-      children: [/*#__PURE__*/_jsx(SpeedDialActionStaticTooltipLabel, {
-        style: transitionStyle,
-        id: `${id}-label`,
-        className: classes.staticTooltipLabel,
-        ownerState: ownerState,
-        children: tooltipTitle
+      children: [/*#__PURE__*/_jsx(StaticTooltipLabelSlot, {
+        ...staticTooltipLabelSlotProps,
+        children: tooltipSlotProps.title
       }), /*#__PURE__*/React.cloneElement(fab, {
         'aria-labelledby': `${id}-label`
       })]
@@ -198,15 +254,12 @@ const SpeedDialAction = /*#__PURE__*/React.forwardRef(function SpeedDialAction(i
   if (!open && tooltipOpen) {
     setTooltipOpen(false);
   }
-  return /*#__PURE__*/_jsx(Tooltip, {
-    id: id,
-    ref: ref,
-    title: tooltipTitle,
-    placement: tooltipPlacement,
-    onClose: handleTooltipClose,
-    onOpen: handleTooltipOpen,
+  return /*#__PURE__*/_jsx(TooltipSlot, {
+    ...tooltipSlotProps,
+    title: tooltipSlotProps.title,
     open: open && tooltipOpen,
-    classes: TooltipClasses,
+    placement: tooltipSlotProps.placement,
+    classes: tooltipSlotProps.classes,
     ...other,
     children: fab
   });
@@ -232,6 +285,7 @@ process.env.NODE_ENV !== "production" ? SpeedDialAction.propTypes /* remove-prop
   /**
    * Props applied to the [`Fab`](https://mui.com/material-ui/api/fab/) component.
    * @default {}
+   * @deprecated Use `slotProps.fab` instead. This prop will be removed in v7. See [Migrating from deprecated APIs](/material-ui/migration/migrating-from-deprecated-apis/) for more details.
    */
   FabProps: PropTypes.object,
   /**
@@ -247,26 +301,50 @@ process.env.NODE_ENV !== "production" ? SpeedDialAction.propTypes /* remove-prop
    * If `true`, the component is shown.
    */
   open: PropTypes.bool,
+  /**
+   * The props used for each slot inside.
+   * @default {}
+   */
+  slotProps: PropTypes.shape({
+    fab: PropTypes.oneOfType([PropTypes.func, PropTypes.object]),
+    staticTooltip: PropTypes.oneOfType([PropTypes.func, PropTypes.object]),
+    staticTooltipLabel: PropTypes.oneOfType([PropTypes.func, PropTypes.object]),
+    tooltip: PropTypes.oneOfType([PropTypes.func, PropTypes.object])
+  }),
+  /**
+   * The components used for each slot inside.
+   * @default {}
+   */
+  slots: PropTypes.shape({
+    fab: PropTypes.elementType,
+    staticTooltip: PropTypes.elementType,
+    staticTooltipLabel: PropTypes.elementType,
+    tooltip: PropTypes.elementType
+  }),
   /**
    * 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]),
   /**
    * `classes` prop applied to the [`Tooltip`](https://mui.com/material-ui/api/tooltip/) element.
+   * @deprecated Use `slotProps.tooltip.classes` instead. This prop will be removed in v7. See [Migrating from deprecated APIs](/material-ui/migration/migrating-from-deprecated-apis/) for more details.
    */
   TooltipClasses: PropTypes.object,
   /**
    * Make the tooltip always visible when the SpeedDial is open.
    * @default false
+   * @deprecated Use `slotProps.tooltip.open` instead. This prop will be removed in v7. See [Migrating from deprecated APIs](/material-ui/migration/migrating-from-deprecated-apis/) for more details.
    */
   tooltipOpen: PropTypes.bool,
   /**
    * Placement of the tooltip.
    * @default 'left'
+   * @deprecated Use `slotProps.tooltip.placement` instead. This prop will be removed in v7. See [Migrating from deprecated APIs](/material-ui/migration/migrating-from-deprecated-apis/) for more details.
    */
   tooltipPlacement: PropTypes.oneOf(['bottom-end', 'bottom-start', 'bottom', 'left-end', 'left-start', 'left', 'right-end', 'right-start', 'right', 'top-end', 'top-start', 'top']),
   /**
    * Label to display in the tooltip.
+   * @deprecated Use `slotProps.tooltip.title` instead. This prop will be removed in v7. See [Migrating from deprecated APIs](/material-ui/migration/migrating-from-deprecated-apis/) for more details.
    */
   tooltipTitle: PropTypes.node
 } : void 0;

package/modern/SwipeableDrawer/SwipeableDrawer.js

@@ -14,6 +14,8 @@ import useEnhancedEffect from "../utils/useEnhancedEffect.js";
 import { useTheme } from "../zero-styled/index.js";
 import { useDefaultProps } from "../DefaultPropsProvider/index.js";
 import { getTransitionProps } from "../transitions/utils.js";
+import { mergeSlotProps } from "../utils/index.js";
+import useSlot from "../utils/useSlot.js";
 import SwipeArea from "./SwipeArea.js";
 
 // This value is closed to what browsers are using internally to
@@ -145,6 +147,8 @@ const SwipeableDrawer = /*#__PURE__*/React.forwardRef(function SwipeableDrawer(i
     transitionDuration = transitionDurationDefault,
     variant = 'temporary',
     // Mobile first.
+    slots = {},
+    slotProps = {},
     ...other
   } = props;
   const [maybeSwiping, setMaybeSwiping] = React.useState(false);
@@ -450,6 +454,22 @@ const SwipeableDrawer = /*#__PURE__*/React.forwardRef(function SwipeableDrawer(i
       setMaybeSwiping(false);
     }
   }, [open]);
+  const [SwipeAreaSlot, swipeAreaSlotProps] = useSlot('swipeArea', {
+    ref: swipeAreaRef,
+    elementType: SwipeArea,
+    ownerState: props,
+    externalForwardedProps: {
+      slots,
+      slotProps: {
+        swipeArea: SwipeAreaProps,
+        ...slotProps
+      }
+    },
+    additionalProps: {
+      width: swipeAreaWidth,
+      anchor
+    }
+  });
   return /*#__PURE__*/_jsxs(React.Fragment, {
     children: [/*#__PURE__*/_jsx(Drawer, {
       open: variant === 'temporary' && maybeSwiping ? true : open,
@@ -467,25 +487,27 @@ const SwipeableDrawer = /*#__PURE__*/React.forwardRef(function SwipeableDrawer(i
         ...ModalPropsProp
       },
       hideBackdrop: hideBackdrop,
-      PaperProps: {
-        ...PaperProps,
-        style: {
-          pointerEvents: variant === 'temporary' && !open && !allowSwipeInChildren ? 'none' : '',
-          ...PaperProps.style
-        },
-        ref: handleRef
-      },
       anchor: anchor,
       transitionDuration: calculatedDurationRef.current || transitionDuration,
       onClose: onClose,
       ref: ref,
+      slots: slots,
+      slotProps: {
+        ...slotProps,
+        backdrop: mergeSlotProps(slotProps.backdrop ?? BackdropProps, {
+          ref: backdropRef
+        }),
+        paper: mergeSlotProps(slotProps.paper ?? PaperProps, {
+          style: {
+            pointerEvents: variant === 'temporary' && !open && !allowSwipeInChildren ? 'none' : ''
+          },
+          ref: handleRef
+        })
+      },
       ...other
     }), !disableSwipeToOpen && variant === 'temporary' && /*#__PURE__*/_jsx(NoSsr, {
-      children: /*#__PURE__*/_jsx(SwipeArea, {
-        anchor: anchor,
-        ref: swipeAreaRef,
-        width: swipeAreaWidth,
-        ...SwipeAreaProps
+      children: /*#__PURE__*/_jsx(SwipeAreaSlot, {
+        ...swipeAreaSlotProps
       })
     })]
   });
@@ -583,8 +605,33 @@ process.env.NODE_ENV !== "production" ? SwipeableDrawer.propTypes /* remove-prop
     component: elementTypeAcceptingRef,
     style: PropTypes.object
   }),
+  /**
+   * The props used for each slot inside.
+   * @default {}
+   */
+  slotProps: PropTypes.shape({
+    backdrop: PropTypes.oneOfType([PropTypes.func, PropTypes.object]),
+    docked: PropTypes.oneOfType([PropTypes.func, PropTypes.object]),
+    paper: PropTypes.oneOfType([PropTypes.func, PropTypes.object]),
+    root: PropTypes.oneOfType([PropTypes.func, PropTypes.object]),
+    swipeArea: PropTypes.oneOfType([PropTypes.func, PropTypes.object]),
+    transition: PropTypes.oneOfType([PropTypes.func, PropTypes.object])
+  }),
+  /**
+   * The components used for each slot inside.
+   * @default {}
+   */
+  slots: PropTypes.shape({
+    backdrop: PropTypes.elementType,
+    docked: PropTypes.elementType,
+    paper: PropTypes.elementType,
+    root: PropTypes.elementType,
+    swipeArea: PropTypes.elementType,
+    transition: PropTypes.elementType
+  }),
   /**
    * The element is used to intercept the touch events on the edge.
+   * @deprecated use the `slotProps.swipeArea` prop instead. This prop will be removed in v7. See [Migrating from deprecated APIs](https://mui.com/material-ui/migration/migrating-from-deprecated-apis/) for more details.
    */
   SwipeAreaProps: PropTypes.object,
   /**

package/modern/Switch/Switch.js

@@ -305,10 +305,12 @@ process.env.NODE_ENV !== "production" ? Switch.propTypes /* remove-proptypes */
   id: PropTypes.string,
   /**
    * [Attributes](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#Attributes) applied to the `input` element.
+   * @deprecated Use `slotProps.input` instead. This prop will be removed in v7. See [Migrating from deprecated APIs](/material-ui/migration/migrating-from-deprecated-apis/) for more details.
    */
   inputProps: PropTypes.object,
   /**
    * Pass a ref to the `input` element.
+   * @deprecated Use `slotProps.input.ref` instead. This prop will be removed in v7. See [Migrating from deprecated APIs](/material-ui/migration/migrating-from-deprecated-apis/) for more details.
    */
   inputRef: refType,
   /**