@mui/material 6.4.6 → 6.4.7

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # [Versions](https://mui.com/versions/)
 
+## 6.4.7
+
+<!-- generated comparing v6.4.6..v6.x -->
+
+_Mar 5, 2025_
+
+A big thanks to the 3 contributors who made this release possible.
+
+### `@mui/material@6.4.7`
+
+- [ThemeProvider] Add `storageManager` prop to `ThemeProvider` (@siriwatknp) (#45437) @siriwatknp
+- [Rating] Deprecate \*Props and complete slots, slotProps (#45295) (#45398) @DiegoAndai
+- [Radio] Fix `inputProps` not forwarded (@siriwatknp) (#45475) @siriwatknp
+
+### Core
+
+- [blog] React 19 migration for MUI X (#45440) @arminmeh
+
+All contributors of this release in alphabetical order: @arminmeh, @DiegoAndai, @siriwatknp
+
 ## 6.4.6
 
 <!-- generated comparing v6.4.5..v6.x -->

package/Radio/Radio.js

@@ -128,6 +128,7 @@ const Radio = /*#__PURE__*/React.forwardRef(function Radio(inProps, ref) {
     disableRipple = false,
     slots = {},
     slotProps = {},
+    inputProps,
     ...other
   } = props;
   const muiFormControl = useFormControl();
@@ -158,6 +159,7 @@ const Radio = /*#__PURE__*/React.forwardRef(function Radio(inProps, ref) {
       name = radioGroup.name;
     }
   }
+  const externalInputProps = slotProps.input ?? inputProps;
   const [RootSlot, rootSlotProps] = useSlot('root', {
     ref,
     elementType: RadioRoot,
@@ -190,7 +192,7 @@ const Radio = /*#__PURE__*/React.forwardRef(function Radio(inProps, ref) {
       slots,
       slotProps: {
         // Do not forward `slotProps.root` again because it's already handled by the `RootSlot` in this file.
-        input: typeof slotProps.input === 'function' ? slotProps.input(ownerState) : slotProps.input
+        input: typeof externalInputProps === 'function' ? externalInputProps(ownerState) : externalInputProps
       }
     }
   });

package/Rating/Rating.d.ts

@@ -4,6 +4,7 @@ import { OverridableStringUnion } from '@mui/types';
 import { Theme } from '..';
 import { RatingClasses } from './ratingClasses';
 import { OverridableComponent, OverrideProps } from '../OverridableComponent';
+import { CreateSlotsAndSlotProps, SlotProps } from '../utils/types';
 
 export interface IconContainerProps extends React.HTMLAttributes<HTMLSpanElement> {
   value: number;
@@ -11,7 +12,61 @@ export interface IconContainerProps extends React.HTMLAttributes<HTMLSpanElement
 
 export interface RatingPropsSizeOverrides {}
 
-export interface RatingOwnProps {
+export interface RatingRootSlotPropsOverrides {}
+export interface RatingLabelSlotPropsOverrides {}
+export interface RatingIconSlotPropsOverrides {}
+export interface RatingDecimalSlotPropsOverrides {}
+
+export interface RatingSlots {
+  /**
+   * The component used for the root slot.
+   * @default 'span'
+   */
+  root: React.ElementType;
+  /**
+   * The component used for the label slot.
+   * @default 'label'
+   */
+  label: React.ElementType;
+  /**
+   * The component used for the icon slot.
+   * @default 'span'
+   */
+  icon: React.ElementType;
+  /**
+   * The component used fo r the decimal slot.
+   * @default 'span'
+   */
+  decimal: React.ElementType;
+}
+
+export type RatingSlotsAndSlotProps = CreateSlotsAndSlotProps<
+  RatingSlots,
+  {
+    /**
+     * Props forwarded to the root slot.
+     * By default, the avaible props are based on the span element.
+     */
+    root: SlotProps<'span', RatingRootSlotPropsOverrides, RatingOwnerState>;
+    /**
+     * Props forwarded to the label slot.
+     * By default, the avaible props are based on the label element.
+     */
+    label: SlotProps<'label', RatingLabelSlotPropsOverrides, RatingOwnerState>;
+    /**
+     * Props forwarded to the icon slot.
+     * By default, the avaible props are based on the span element.
+     */
+    icon: SlotProps<'span', RatingIconSlotPropsOverrides, RatingOwnerState>;
+    /**
+     * Props forwarded to the decimal slot.
+     * By default, the avaible props are based on the span element.
+     */
+    decimal: SlotProps<'span', RatingDecimalSlotPropsOverrides, RatingOwnerState>;
+  }
+>;
+
+export interface RatingOwnProps extends RatingSlotsAndSlotProps {
   /**
    * Override or extend the styles applied to the component.
    */
@@ -60,6 +115,7 @@ export interface RatingOwnProps {
   icon?: React.ReactNode;
   /**
    * 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} />;
@@ -114,6 +170,8 @@ export interface RatingOwnProps {
   value?: number | null;
 }
 
+export interface RatingOwnerState extends Omit<RatingProps, 'slots' | 'slotProps'> {}
+
 export type RatingTypeMap<
   AdditionalProps = {},
   RootComponent extends React.ElementType = 'span',

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/index.js

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

package/modern/Radio/Radio.js

@@ -128,6 +128,7 @@ const Radio = /*#__PURE__*/React.forwardRef(function Radio(inProps, ref) {
     disableRipple = false,
     slots = {},
     slotProps = {},
+    inputProps,
     ...other
   } = props;
   const muiFormControl = useFormControl();
@@ -158,6 +159,7 @@ const Radio = /*#__PURE__*/React.forwardRef(function Radio(inProps, ref) {
       name = radioGroup.name;
     }
   }
+  const externalInputProps = slotProps.input ?? inputProps;
   const [RootSlot, rootSlotProps] = useSlot('root', {
     ref,
     elementType: RadioRoot,
@@ -190,7 +192,7 @@ const Radio = /*#__PURE__*/React.forwardRef(function Radio(inProps, ref) {
       slots,
       slotProps: {
         // Do not forward `slotProps.root` again because it's already handled by the `RootSlot` in this file.
-        input: typeof slotProps.input === 'function' ? slotProps.input(ownerState) : slotProps.input
+        input: typeof externalInputProps === 'function' ? externalInputProps(ownerState) : externalInputProps
       }
     }
   });

package/modern/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/modern/index.js

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

package/modern/version/index.js

@@ -1,6 +1,6 @@
-export const version = "6.4.6";
+export const version = "6.4.7";
 export const major = Number("6");
 export const minor = Number("4");
-export const patch = Number("6");
+export const patch = Number("7");
 export const prerelease = undefined;
 export default version;

package/node/Radio/Radio.js

@@ -135,6 +135,7 @@ const Radio = /*#__PURE__*/React.forwardRef(function Radio(inProps, ref) {
     disableRipple = false,
     slots = {},
     slotProps = {},
+    inputProps,
     ...other
   } = props;
   const muiFormControl = (0, _useFormControl.default)();
@@ -165,6 +166,7 @@ const Radio = /*#__PURE__*/React.forwardRef(function Radio(inProps, ref) {
       name = radioGroup.name;
     }
   }
+  const externalInputProps = slotProps.input ?? inputProps;
   const [RootSlot, rootSlotProps] = (0, _useSlot.default)('root', {
     ref,
     elementType: RadioRoot,
@@ -197,7 +199,7 @@ const Radio = /*#__PURE__*/React.forwardRef(function Radio(inProps, ref) {
       slots,
       slotProps: {
         // Do not forward `slotProps.root` again because it's already handled by the `RootSlot` in this file.
-        input: typeof slotProps.input === 'function' ? slotProps.input(ownerState) : slotProps.input
+        input: typeof externalInputProps === 'function' ? externalInputProps(ownerState) : externalInputProps
       }
     }
   });

package/node/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/node/index.js

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

package/node/version/index.js

@@ -4,9 +4,9 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.version = exports.prerelease = exports.patch = exports.minor = exports.major = exports.default = void 0;
-const version = exports.version = "6.4.6";
+const version = exports.version = "6.4.7";
 const major = exports.major = Number("6");
 const minor = exports.minor = Number("4");
-const patch = exports.patch = Number("6");
+const patch = exports.patch = Number("7");
 const prerelease = exports.prerelease = undefined;
 var _default = exports.default = version;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/material",
-  "version": "6.4.6",
+  "version": "6.4.7",
   "private": false,
   "author": "MUI Team",
   "description": "Material UI is an open-source React component library that implements Google's Material Design. It's comprehensive and can be used in production out of the box.",
@@ -35,10 +35,10 @@
     "prop-types": "^15.8.1",
     "react-is": "^19.0.0",
     "react-transition-group": "^4.4.5",
-    "@mui/core-downloads-tracker": "^6.4.6",
-    "@mui/system": "^6.4.6",
     "@mui/utils": "^6.4.6",
-    "@mui/types": "^7.2.21"
+    "@mui/system": "^6.4.7",
+    "@mui/types": "^7.2.21",
+    "@mui/core-downloads-tracker": "^6.4.7"
   },
   "peerDependencies": {
     "@emotion/react": "^11.5.0",
@@ -46,7 +46,7 @@
     "@types/react": "^17.0.0 || ^18.0.0 || ^19.0.0",
     "react": "^17.0.0 || ^18.0.0 || ^19.0.0",
     "react-dom": "^17.0.0 || ^18.0.0 || ^19.0.0",
-    "@mui/material-pigment-css": "^6.4.6"
+    "@mui/material-pigment-css": "^6.4.7"
   },
   "peerDependenciesMeta": {
     "@types/react": {

package/styles/ThemeProvider.d.ts

@@ -1,5 +1,6 @@
 import * as React from 'react';
 import { DefaultTheme } from '@mui/system';
+import { StorageManager } from '@mui/system/cssVars';
 import { CssThemeVariables } from './createThemeNoVars';
 type ThemeProviderCssVariablesProps = CssThemeVariables extends {
     enabled: true;
@@ -40,6 +41,11 @@ export interface ThemeProviderProps<Theme = DefaultTheme> extends ThemeProviderC
      * @default window
      */
     storageWindow?: Window | null;
+    /**
+     * The storage manager to be used for storing the mode and color scheme
+     * @default using `window.localStorage`
+     */
+    storageManager?: StorageManager | null;
     /**
      * localStorage key used to store application `mode`
      * @default 'mui-mode'

package/styles/ThemeProviderWithVars.d.ts

@@ -43,6 +43,7 @@ export declare const CssVarsProvider: (props: React.PropsWithChildren<Partial<im
     defaultMode?: "light" | "dark" | "system";
     documentNode?: Document | null;
     colorSchemeNode?: Element | null;
+    storageManager?: import("@mui/system").StorageManager | null;
     storageWindow?: Window | null;
     disableNestedContext?: boolean;
     disableStyleSheetGeneration?: boolean;

package/styles/index.d.ts

@@ -103,6 +103,7 @@ export { default as withStyles } from './withStyles';
 export { default as withTheme } from './withTheme';
 
 export * from './ThemeProviderWithVars';
+export type { StorageManager } from '@mui/system/cssVars';
 
 export { default as extendTheme } from './createThemeWithVars';
 

package/version/index.js

@@ -1,6 +1,6 @@
-export const version = "6.4.6";
+export const version = "6.4.7";
 export const major = Number("6");
 export const minor = Number("4");
-export const patch = Number("6");
+export const patch = Number("7");
 export const prerelease = undefined;
 export default version;