@mui/material 6.4.6 → 6.4.8

package/Rating/Rating.js

@@ -17,7 +17,9 @@ import memoTheme from "../utils/memoTheme.js";
 import { useDefaultProps } from "../DefaultPropsProvider/index.js";
 import slotShouldForwardProp from "../styles/slotShouldForwardProp.js";
 import ratingClasses, { getRatingUtilityClass } from "./ratingClasses.js";
+import useSlot from "../utils/useSlot.js";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { createElement as _createElement } from "react";
 function getDecimalPrecision(num) {
   const decimalPart = num.toString().split('.')[1];
   return decimalPart ? decimalPart.length : 0;
@@ -220,7 +222,9 @@ function RatingItem(props) {
     readOnly,
     ownerState,
     ratingValue,
-    ratingValueRounded
+    ratingValueRounded,
+    slots = {},
+    slotProps = {}
   } = props;
   const isFilled = highlightSelectedOnly ? itemValue === ratingValue : itemValue <= ratingValue;
   const isHovered = itemValue <= hover;
@@ -232,10 +236,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}-${useId()}`;
-  const container = /*#__PURE__*/_jsx(RatingIcon, {
-    as: IconContainerComponent,
-    value: itemValue,
+  const externalForwardedProps = {
+    slots,
+    slotProps
+  };
+  const [IconSlot, iconSlotProps] = useSlot('icon', {
+    elementType: RatingIcon,
     className: clsx(classes.icon, isFilled ? classes.iconFilled : classes.iconEmpty, isHovered && classes.iconHover, isFocused && classes.iconFocus, isActive && classes.iconActive),
+    externalForwardedProps,
     ownerState: {
       ...ownerState,
       iconEmpty: !isFilled,
@@ -244,6 +252,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] = useSlot('label', {
+    elementType: RatingLabel,
+    externalForwardedProps,
+    ownerState: {
+      ...ownerState,
+      emptyValueFocused: undefined
+    },
+    additionalProps: {
+      style: labelProps?.style,
+      htmlFor: id
+    }
+  });
+  const container = /*#__PURE__*/_jsx(IconSlot, {
+    ...iconSlotProps,
     children: emptyIcon && !isFilled ? emptyIcon : icon
   });
   if (readOnly) {
@@ -253,13 +284,8 @@ function RatingItem(props) {
     });
   }
   return /*#__PURE__*/_jsxs(React.Fragment, {
-    children: [/*#__PURE__*/_jsxs(RatingLabel, {
-      ownerState: {
-        ...ownerState,
-        emptyValueFocused: undefined
-      },
-      htmlFor: id,
-      ...labelProps,
+    children: [/*#__PURE__*/_jsxs(LabelSlot, {
+      ...labelSlotProps,
       children: [container, /*#__PURE__*/_jsx("span", {
         className: classes.visuallyHidden,
         children: getLabelText(itemValue)
@@ -300,7 +326,9 @@ process.env.NODE_ENV !== "production" ? RatingItem.propTypes = {
   ownerState: PropTypes.object.isRequired,
   ratingValue: PropTypes.number,
   ratingValueRounded: PropTypes.number,
-  readOnly: PropTypes.bool.isRequired
+  readOnly: PropTypes.bool.isRequired,
+  slotProps: PropTypes.object,
+  slots: PropTypes.object
 } : void 0;
 const defaultIcon = /*#__PURE__*/_jsx(Star, {
   fontSize: "inherit"
@@ -337,6 +365,8 @@ const Rating = /*#__PURE__*/React.forwardRef(function Rating(inProps, ref) {
     readOnly = false,
     size = 'medium',
     value: valueProp,
+    slots = {},
+    slotProps = {},
     ...other
   } = props;
   const name = useId(nameProp);
@@ -474,16 +504,50 @@ const Rating = /*#__PURE__*/React.forwardRef(function Rating(inProps, ref) {
     size
   };
   const classes = useUtilityClasses(ownerState);
-  return /*#__PURE__*/_jsxs(RatingRoot, {
-    as: component,
+  const externalForwardedProps = {
+    slots,
+    slotProps
+  };
+  const [RootSlot, rootSlotProps] = useSlot('root', {
     ref: handleRef,
-    onMouseMove: handleMouseMove,
-    onMouseLeave: handleMouseLeave,
-    className: clsx(classes.root, className, readOnly && 'MuiRating-readOnly'),
-    ownerState: ownerState,
-    role: readOnly ? 'img' : null,
-    "aria-label": readOnly ? getLabelText(value) : null,
-    ...other,
+    className: clsx(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] = useSlot('label', {
+    className: clsx(classes.label, classes.labelEmptyValue),
+    elementType: RatingLabel,
+    externalForwardedProps,
+    ownerState
+  });
+  const [DecimalSlot, decimalSlotProps] = useSlot('decimal', {
+    className: classes.decimal,
+    elementType: RatingDecimal,
+    externalForwardedProps,
+    ownerState
+  });
+  return /*#__PURE__*/_jsxs(RootSlot, {
+    ...rootSlotProps,
     children: [Array.from(new Array(max)).map((_, index) => {
       const itemValue = index + 1;
       const ratingItemProps = {
@@ -504,41 +568,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__*/_jsx(RatingDecimal, {
-          className: clsx(classes.decimal, isActive && classes.iconActive),
-          ownerState: ownerState,
-          iconActive: isActive,
-          children: items.map(($, indexDecimal) => {
-            const itemDecimalValue = roundValueToPrecision(itemValue - 1 + (indexDecimal + 1) * precision, precision);
-            return /*#__PURE__*/_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__*/_createElement(DecimalSlot, {
+          ...decimalSlotProps,
+          key: itemValue,
+          className: clsx(decimalSlotProps.className, isActive && classes.iconActive),
+          iconActive: isActive
+        }, items.map(($, indexDecimal) => {
+          const itemDecimalValue = roundValueToPrecision(itemValue - 1 + (indexDecimal + 1) * precision, precision);
+          return /*#__PURE__*/_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__*/_jsx(RatingItem, {
         ...ratingItemProps,
         isActive: isActive,
         itemValue: itemValue
       }, itemValue);
-    }), !readOnly && !disabled && /*#__PURE__*/_jsxs(RatingLabel, {
-      className: clsx(classes.label, classes.labelEmptyValue),
-      ownerState: ownerState,
+    }), !readOnly && !disabled && /*#__PURE__*/_jsxs(LabelSlot, {
+      ...labelSlotProps,
       children: [/*#__PURE__*/_jsx("input", {
         className: classes.visuallyHidden,
         value: "",
@@ -622,6 +687,7 @@ process.env.NODE_ENV !== "production" ? Rating.propTypes /* remove-proptypes */
   icon: PropTypes.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} />;
@@ -679,6 +745,26 @@ process.env.NODE_ENV !== "production" ? Rating.propTypes /* remove-proptypes */
    * @default 'medium'
    */
   size: PropTypes /* @typescript-to-proptypes-ignore */.oneOfType([PropTypes.oneOf(['small', 'medium', 'large']), PropTypes.string]),
+  /**
+   * The props used for each slot inside.
+   * @default {}
+   */
+  slotProps: PropTypes.shape({
+    decimal: PropTypes.oneOfType([PropTypes.func, PropTypes.object]),
+    icon: PropTypes.oneOfType([PropTypes.func, PropTypes.object]),
+    label: PropTypes.oneOfType([PropTypes.func, PropTypes.object]),
+    root: PropTypes.oneOfType([PropTypes.func, PropTypes.object])
+  }),
+  /**
+   * The components used for each slot inside.
+   * @default {}
+   */
+  slots: PropTypes.shape({
+    decimal: PropTypes.elementType,
+    icon: PropTypes.elementType,
+    label: PropTypes.elementType,
+    root: PropTypes.elementType
+  }),
   /**
    * The system prop that allows defining system overrides as well as additional CSS styles.
    */

package/Snackbar/Snackbar.js

@@ -196,7 +196,10 @@ const Snackbar = /*#__PURE__*/React.forwardRef(function Snackbar(inProps, ref) {
     },
     ownerState
   });
-  const [ClickAwaySlot, clickAwayListenerProps] = useSlot('clickAwayListener', {
+  const [ClickAwaySlot, {
+    ownerState: clickAwayOwnerStateProp,
+    ...clickAwayListenerProps
+  }] = useSlot('clickAwayListener', {
     elementType: ClickAwayListener,
     externalForwardedProps,
     getSlotProps: handlers => ({
@@ -245,6 +248,9 @@ const Snackbar = /*#__PURE__*/React.forwardRef(function Snackbar(inProps, ref) {
   }
   return /*#__PURE__*/_jsx(ClickAwaySlot, {
     ...clickAwayListenerProps,
+    ...(slots.clickAwayListener && {
+      ownerState: clickAwayOwnerStateProp
+    }),
     children: /*#__PURE__*/_jsx(Root, {
       ...rootProps,
       children: /*#__PURE__*/_jsx(TransitionSlot, {

package/SpeedDial/SpeedDial.d.ts

@@ -11,6 +11,11 @@ export type CloseReason = 'toggle' | 'blur' | 'mouseLeave' | 'escapeKeyDown';
 export type OpenReason = 'toggle' | 'focus' | 'mouseEnter';
 
 export interface SpeedDialSlots {
+  /**
+   * The component that renders the root slot.
+   * @default 'div'
+   */
+  root: React.ElementType;
   /**
    * The component that renders the transition.
    * [Follow this guide](https://mui.com/material-ui/transitions/#transitioncomponent-prop) to learn more about the requirements for this component.
@@ -22,6 +27,11 @@ export interface SpeedDialSlots {
 export type SpeedDialSlotsAndSlotProps = CreateSlotsAndSlotProps<
   SpeedDialSlots,
   {
+    /**
+     * Props forwarded to the root slot.
+     * By default, the avaible props are based on div element.
+     */
+    root: SlotComponentProps<'div', React.HTMLAttributes<HTMLDivElement>, SpeedDialOwnerState>;
     /**
      * Props forwarded to the transition slot.
      * By default, the avaible props are based on the [Zoom](https://mui.com/material-ui/api/zoom/#props) component.

package/SpeedDial/SpeedDial.js

@@ -372,22 +372,49 @@ const SpeedDial = /*#__PURE__*/React.forwardRef(function SpeedDial(inProps, ref)
     slots: backwardCompatibleSlots,
     slotProps: backwardCompatibleSlotProps
   };
+  const [RootSlot, rootSlotProps] = useSlot('root', {
+    elementType: SpeedDialRoot,
+    externalForwardedProps: {
+      ...externalForwardedProps,
+      ...other
+    },
+    ownerState,
+    ref,
+    className: clsx(classes.root, className),
+    additionalProps: {
+      role: 'presentation'
+    },
+    getSlotProps: handlers => ({
+      ...handlers,
+      onKeyDown: event => {
+        handlers.onKeyDown?.(event);
+        handleKeyDown(event);
+      },
+      onBlur: event => {
+        handlers.onBlur?.(event);
+        handleClose(event);
+      },
+      onFocus: event => {
+        handlers.onFocus?.(event);
+        handleOpen(event);
+      },
+      onMouseEnter: event => {
+        handlers.onMouseEnter?.(event);
+        handleOpen(event);
+      },
+      onMouseLeave: event => {
+        handlers.onMouseLeave?.(event);
+        handleClose(event);
+      }
+    })
+  });
   const [TransitionSlot, transitionProps] = useSlot('transition', {
     elementType: Zoom,
     externalForwardedProps,
     ownerState
   });
-  return /*#__PURE__*/_jsxs(SpeedDialRoot, {
-    className: clsx(classes.root, className),
-    ref: ref,
-    role: "presentation",
-    onKeyDown: handleKeyDown,
-    onBlur: handleClose,
-    onFocus: handleOpen,
-    onMouseEnter: handleOpen,
-    onMouseLeave: handleClose,
-    ownerState: ownerState,
-    ...other,
+  return /*#__PURE__*/_jsxs(RootSlot, {
+    ...rootSlotProps,
     children: [/*#__PURE__*/_jsx(TransitionSlot, {
       in: !hidden,
       timeout: transitionDuration,
@@ -507,6 +534,7 @@ process.env.NODE_ENV !== "production" ? SpeedDial.propTypes /* remove-proptypes
    * @default {}
    */
   slotProps: PropTypes.shape({
+    root: PropTypes.oneOfType([PropTypes.func, PropTypes.object]),
     transition: PropTypes.oneOfType([PropTypes.func, PropTypes.object])
   }),
   /**
@@ -514,6 +542,7 @@ process.env.NODE_ENV !== "production" ? SpeedDial.propTypes /* remove-proptypes
    * @default {}
    */
   slots: PropTypes.shape({
+    root: PropTypes.elementType,
     transition: PropTypes.elementType
   }),
   /**

package/SpeedDialAction/SpeedDialAction.js

@@ -341,7 +341,7 @@ process.env.NODE_ENV !== "production" ? SpeedDialAction.propTypes /* remove-prop
    * @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']),
+  tooltipPlacement: PropTypes.oneOf(['auto-end', 'auto-start', 'auto', '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.

package/TextareaAutosize/TextareaAutosize.js

@@ -2,7 +2,7 @@
 
 import * as React from 'react';
 import PropTypes from 'prop-types';
-import { unstable_debounce as debounce, unstable_useForkRef as useForkRef, unstable_useEnhancedEffect as useEnhancedEffect, unstable_ownerWindow as ownerWindow } from '@mui/utils';
+import { unstable_debounce as debounce, unstable_useForkRef as useForkRef, unstable_useEnhancedEffect as useEnhancedEffect, unstable_useEventCallback as useEventCallback, unstable_ownerWindow as ownerWindow } from '@mui/utils';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 function getStyleValue(value) {
   return parseInt(value, 10) || 0;
@@ -112,6 +112,15 @@ const TextareaAutosize = /*#__PURE__*/React.forwardRef(function TextareaAutosize
       overflowing
     };
   }, [maxRows, minRows, props.placeholder]);
+  const didHeightChange = useEventCallback(() => {
+    const textarea = textareaRef.current;
+    const textareaStyles = calculateTextareaStyles();
+    if (!textarea || !textareaStyles || isEmpty(textareaStyles)) {
+      return false;
+    }
+    const outerHeightStyle = textareaStyles.outerHeightStyle;
+    return heightRef.current != null && heightRef.current !== outerHeightStyle;
+  });
   const syncHeight = React.useCallback(() => {
     const textarea = textareaRef.current;
     const textareaStyles = calculateTextareaStyles();
@@ -127,37 +136,39 @@ const TextareaAutosize = /*#__PURE__*/React.forwardRef(function TextareaAutosize
   }, [calculateTextareaStyles]);
   const frameRef = React.useRef(-1);
   useEnhancedEffect(() => {
-    const debounceHandleResize = debounce(() => syncHeight());
+    const debouncedHandleResize = debounce(syncHeight);
     const textarea = textareaRef?.current;
     if (!textarea) {
       return undefined;
     }
     const containerWindow = ownerWindow(textarea);
-    containerWindow.addEventListener('resize', debounceHandleResize);
+    containerWindow.addEventListener('resize', debouncedHandleResize);
     let resizeObserver;
     if (typeof ResizeObserver !== 'undefined') {
       resizeObserver = new ResizeObserver(() => {
-        // avoid "ResizeObserver loop completed with undelivered notifications" error
-        // by temporarily unobserving the textarea element while manipulating the height
-        // and reobserving one frame later
-        resizeObserver.unobserve(textarea);
-        cancelAnimationFrame(frameRef.current);
-        syncHeight();
-        frameRef.current = requestAnimationFrame(() => {
-          resizeObserver.observe(textarea);
-        });
+        if (didHeightChange()) {
+          // avoid "ResizeObserver loop completed with undelivered notifications" error
+          // by temporarily unobserving the textarea element while manipulating the height
+          // and reobserving one frame later
+          resizeObserver.unobserve(textarea);
+          cancelAnimationFrame(frameRef.current);
+          syncHeight();
+          frameRef.current = requestAnimationFrame(() => {
+            resizeObserver.observe(textarea);
+          });
+        }
       });
       resizeObserver.observe(textarea);
     }
     return () => {
-      debounceHandleResize.clear();
+      debouncedHandleResize.clear();
       cancelAnimationFrame(frameRef.current);
-      containerWindow.removeEventListener('resize', debounceHandleResize);
+      containerWindow.removeEventListener('resize', debouncedHandleResize);
       if (resizeObserver) {
         resizeObserver.disconnect();
       }
     };
-  }, [calculateTextareaStyles, syncHeight]);
+  }, [calculateTextareaStyles, syncHeight, didHeightChange]);
   useEnhancedEffect(() => {
     syncHeight();
   });

package/Tooltip/Tooltip.d.ts

@@ -203,19 +203,7 @@ export interface TooltipProps
    * Tooltip placement.
    * @default 'bottom'
    */
-  placement?:
-    | 'bottom-end'
-    | 'bottom-start'
-    | 'bottom'
-    | 'left-end'
-    | 'left-start'
-    | 'left'
-    | 'right-end'
-    | 'right-start'
-    | 'right'
-    | 'top-end'
-    | 'top-start'
-    | 'top';
+  placement?: PopperProps['placement'];
   /**
    * The component used for the popper.
    * @deprecated use the `slots.popper` 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.

package/Tooltip/Tooltip.js

@@ -841,7 +841,7 @@ process.env.NODE_ENV !== "production" ? Tooltip.propTypes /* remove-proptypes */
    * Tooltip placement.
    * @default 'bottom'
    */
-  placement: PropTypes.oneOf(['bottom-end', 'bottom-start', 'bottom', 'left-end', 'left-start', 'left', 'right-end', 'right-start', 'right', 'top-end', 'top-start', 'top']),
+  placement: PropTypes.oneOf(['auto-end', 'auto-start', 'auto', 'bottom-end', 'bottom-start', 'bottom', 'left-end', 'left-start', 'left', 'right-end', 'right-start', 'right', 'top-end', 'top-start', 'top']),
   /**
    * The component used for the popper.
    * @deprecated use the `slots.popper` 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.

package/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/material v6.4.6
+ * @mui/material v6.4.8
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the

package/modern/Accordion/Accordion.js

@@ -185,6 +185,20 @@ const Accordion = /*#__PURE__*/React.forwardRef(function Accordion(inProps, ref)
     slots: backwardCompatibleSlots,
     slotProps: backwardCompatibleSlotProps
   };
+  const [RootSlot, rootProps] = useSlot('root', {
+    elementType: AccordionRoot,
+    externalForwardedProps: {
+      ...externalForwardedProps,
+      ...other
+    },
+    className: clsx(classes.root, className),
+    shouldForwardComponentProp: true,
+    ownerState,
+    ref,
+    additionalProps: {
+      square
+    }
+  });
   const [AccordionHeadingSlot, accordionProps] = useSlot('heading', {
     elementType: AccordionHeading,
     externalForwardedProps,
@@ -196,12 +210,8 @@ const Accordion = /*#__PURE__*/React.forwardRef(function Accordion(inProps, ref)
     externalForwardedProps,
     ownerState
   });
-  return /*#__PURE__*/_jsxs(AccordionRoot, {
-    className: clsx(classes.root, className),
-    ref: ref,
-    ownerState: ownerState,
-    square: square,
-    ...other,
+  return /*#__PURE__*/_jsxs(RootSlot, {
+    ...rootProps,
     children: [/*#__PURE__*/_jsx(AccordionHeadingSlot, {
       ...accordionProps,
       children: /*#__PURE__*/_jsx(AccordionContext.Provider, {
@@ -281,6 +291,7 @@ process.env.NODE_ENV !== "production" ? Accordion.propTypes /* remove-proptypes
    */
   slotProps: PropTypes.shape({
     heading: PropTypes.oneOfType([PropTypes.func, PropTypes.object]),
+    root: PropTypes.oneOfType([PropTypes.func, PropTypes.object]),
     transition: PropTypes.oneOfType([PropTypes.func, PropTypes.object])
   }),
   /**
@@ -289,6 +300,7 @@ process.env.NODE_ENV !== "production" ? Accordion.propTypes /* remove-proptypes
    */
   slots: PropTypes.shape({
     heading: PropTypes.elementType,
+    root: PropTypes.elementType,
     transition: PropTypes.elementType
   }),
   /**