@mui/material 9.1.2 → 9.2.0

package/ButtonBase/ButtonBase.js

@@ -227,7 +227,7 @@ const ButtonBase = /*#__PURE__*/React.forwardRef(function ButtonBase(inProps, re
     }
   }, false);
   const handleFocus = (0, _useEventCallback.default)(event => {
-    // Fix for https://github.com/facebook/react/issues/7769
+    // Fix for https://github.com/react/react/issues/7769
     if (!buttonRef.current) {
       buttonRef.current = event.currentTarget;
     }

package/ButtonBase/ButtonBase.mjs

@@ -220,7 +220,7 @@ const ButtonBase = /*#__PURE__*/React.forwardRef(function ButtonBase(inProps, re
     }
   }, false);
   const handleFocus = useEventCallback(event => {
-    // Fix for https://github.com/facebook/react/issues/7769
+    // Fix for https://github.com/react/react/issues/7769
     if (!buttonRef.current) {
       buttonRef.current = event.currentTarget;
     }

package/CHANGELOG.md

@@ -1,5 +1,44 @@
 # [Versions](https://mui.com/material-ui/getting-started/versions/)
 
+## 9.2.0
+
+<!-- generated comparing v9.1.2..master -->
+
+_Jul 2, 2026_
+
+A big thanks to the 9 contributors who made this release possible.
+
+- ⚙️ Add support for [`data-*` attributes on `slotProps`](https://mui.com/material-ui/guides/typescript/#allowing-data-attributes-on-slotprops).
+
+### `@mui/material@9.1.3`
+
+- [l10n] Add missing MuiPagination localization to zh-CN locale (#48741) @greymoth-jp
+- [select] Guard display ref during mouse down (#48744) @michelengelen
+
+### `@mui/utils@9.1.3`
+
+- [utils] Add opt-in `DataAttributesOverrides` augmentation for slot props (#48554) @LukasTy
+
+### Docs
+
+- [docs] Improve Icon Dialog responsiveness on small screens (#48639) @Prakash1185
+- [docs] Fix invalid UTF-8 in skill references (#48739) @mturac
+
+### Core
+
+- [code-infra] Resolve Renovate dashboard warnings (#48700) @Sushantplive
+- [code-infra] Validate npm publishing through dry run (#48691) @brijeshb42
+- [code-infra] Run prettier after renovate update (#48754) @Janpot
+- [code-infra] Fix 'A11y results committed?' check on react-pinned nightly jobs (#48740) @Janpot
+- [core] Remove leftover Joy UI references (#48719) @siriwatknp
+- [code-infra] Bump react-router to 7.15.1 (#48725) @Janpot
+- [docs-infra] Drive docs analytics IDs via ANALYTICS_ENV (#48694) @Janpot
+- [docs-infra] Pre-render API page descriptions (#48693) @brijeshb42
+- [code-infra][icons-material] Build lib/package.json with code-infra --no-expand (#48689) @Janpot
+- [code-infra] Fix react@18/next nightly workflow (#48635) @Janpot
+
+All contributors of this release in alphabetical order: @brijeshb42, @greymoth-jp, @Janpot, @LukasTy, @michelengelen, @mturac, @Prakash1185, @siriwatknp, @Sushantplive
+
 ## 9.1.2
 
 <!-- generated comparing v9.1.1..master -->
@@ -20,7 +59,7 @@ A big thanks to the 5 contributors who made this release possible.
 ### Docs
 
 - Fix typos in release instructions (#48687) @brijeshb42
-- Update @mui/x-* packages to latest (#48661) @Janpot
+- Update @mui/x-\* packages to latest (#48661) @Janpot
 
 ### Core
 
@@ -28,12 +67,11 @@ A big thanks to the 5 contributors who made this release possible.
 - [code-infra] Bump to latest code-infra packages (#48672) @brijeshb42
 - [code-infra] Resolve remaining minimatch advisory (#48662) @Janpot
 - [code-infra] Bump nx to resolve minimatch advisory (#48658) @Janpot
-- [core] Drop @babel/* pnpm overrides (#48710) @Janpot
+- [core] Drop @babel/\* pnpm overrides (#48710) @Janpot
 - [docs-infra] Revert "Pin StackBlitz demo vite to v7 and plugin-react to v5" (#48709) @Janpot
 - [docs-infra] Fix code-block copy button broken on direct page load (#48653) @brijeshb42
 - [test] Stabilize Data Grid demo data in Argos screenshots (#48654) @LukasTy
 
-
 All contributors of this release in alphabetical order: @brijeshb42, @Janpot, @LukasTy, @mj12albert, @siriwatknp
 
 ## 9.1.1

package/ClickAwayListener/ClickAwayListener.js

@@ -50,7 +50,7 @@ function ClickAwayListener(props) {
   const syntheticEventRef = React.useRef(false);
   React.useEffect(() => {
     // Ensure that this component is not "activated" synchronously.
-    // https://github.com/facebook/react/issues/20074
+    // https://github.com/react/react/issues/20074
     setTimeout(() => {
       activatedRef.current = true;
     }, 0);

package/ClickAwayListener/ClickAwayListener.mjs

@@ -44,7 +44,7 @@ function ClickAwayListener(props) {
   const syntheticEventRef = React.useRef(false);
   React.useEffect(() => {
     // Ensure that this component is not "activated" synchronously.
-    // https://github.com/facebook/react/issues/20074
+    // https://github.com/react/react/issues/20074
     setTimeout(() => {
       activatedRef.current = true;
     }, 0);

package/ListItem/ListItem.d.mts

@@ -4,6 +4,7 @@ import { Theme } from "../styles/index.mjs";
 import { OverridableComponent, OverrideProps } from "../OverridableComponent/index.mjs";
 import { ListItemClasses } from "./listItemClasses.mjs";
 import { SlotProps } from "../utils/types.mjs";
+export interface ListItemRootSlotPropsOverrides {}
 export interface ListItemSecondaryActionSlotPropsOverrides {}
 
 /**
@@ -62,7 +63,7 @@ export interface ListItemOwnProps extends ListItemBaseProps {
    * @default {}
    */
   slotProps?: {
-    root?: React.HTMLAttributes<HTMLDivElement> | undefined;
+    root?: SlotProps<React.ElementType<React.HTMLAttributes<HTMLDivElement>>, ListItemRootSlotPropsOverrides, ListItemOwnerState> | undefined;
     secondaryAction?: SlotProps<React.ElementType<React.HTMLAttributes<HTMLDivElement>>, ListItemSecondaryActionSlotPropsOverrides, ListItemOwnerState> | undefined;
   } | undefined;
   /**

package/ListItem/ListItem.d.ts

@@ -4,6 +4,7 @@ import { Theme } from "../styles/index.js";
 import { OverridableComponent, OverrideProps } from "../OverridableComponent/index.js";
 import { ListItemClasses } from "./listItemClasses.js";
 import { SlotProps } from "../utils/types.js";
+export interface ListItemRootSlotPropsOverrides {}
 export interface ListItemSecondaryActionSlotPropsOverrides {}
 
 /**
@@ -62,7 +63,7 @@ export interface ListItemOwnProps extends ListItemBaseProps {
    * @default {}
    */
   slotProps?: {
-    root?: React.HTMLAttributes<HTMLDivElement> | undefined;
+    root?: SlotProps<React.ElementType<React.HTMLAttributes<HTMLDivElement>>, ListItemRootSlotPropsOverrides, ListItemOwnerState> | undefined;
     secondaryAction?: SlotProps<React.ElementType<React.HTMLAttributes<HTMLDivElement>>, ListItemSecondaryActionSlotPropsOverrides, ListItemOwnerState> | undefined;
   } | undefined;
   /**

package/ListItem/ListItem.js

@@ -265,7 +265,7 @@ process.env.NODE_ENV !== "production" ? ListItem.propTypes /* remove-proptypes *
    * @default {}
    */
   slotProps: _propTypes.default.shape({
-    root: _propTypes.default.object,
+    root: _propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.object]),
     secondaryAction: _propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.object])
   }),
   /**

package/ListItem/ListItem.mjs

@@ -257,7 +257,7 @@ process.env.NODE_ENV !== "production" ? ListItem.propTypes /* remove-proptypes *
    * @default {}
    */
   slotProps: PropTypes.shape({
-    root: PropTypes.object,
+    root: PropTypes.oneOfType([PropTypes.func, PropTypes.object]),
     secondaryAction: PropTypes.oneOfType([PropTypes.func, PropTypes.object])
   }),
   /**

package/Rating/Rating.js

@@ -157,7 +157,7 @@ const RatingIcon = (0, _zeroStyled.styled)('span', {
     duration: theme.transitions.duration.shortest
   }),
   // Fix mouseLeave issue.
-  // https://github.com/facebook/react/issues/4492
+  // https://github.com/react/react/issues/4492
   pointerEvents: 'none',
   variants: [{
     props: ({
@@ -452,7 +452,7 @@ const Rating = /*#__PURE__*/React.forwardRef(function Rating(inProps, ref) {
   };
   const handleClear = event => {
     // Ignore keyboard events
-    // https://github.com/facebook/react/issues/7407
+    // https://github.com/react/react/issues/7407
     if (event.clientX === 0 && event.clientY === 0) {
       return;
     }

package/Rating/Rating.mjs

@@ -150,7 +150,7 @@ const RatingIcon = styled('span', {
     duration: theme.transitions.duration.shortest
   }),
   // Fix mouseLeave issue.
-  // https://github.com/facebook/react/issues/4492
+  // https://github.com/react/react/issues/4492
   pointerEvents: 'none',
   variants: [{
     props: ({
@@ -445,7 +445,7 @@ const Rating = /*#__PURE__*/React.forwardRef(function Rating(inProps, ref) {
   };
   const handleClear = event => {
     // Ignore keyboard events
-    // https://github.com/facebook/react/issues/7407
+    // https://github.com/react/react/issues/7407
     if (event.clientX === 0 && event.clientY === 0) {
       return;
     }

package/Select/SelectInput.js

@@ -383,6 +383,9 @@ const SelectInput = /*#__PURE__*/React.forwardRef(function SelectInput(props, re
     }
     // Hijack the default focus behavior.
     event.preventDefault();
+    if (!displayRef.current) {
+      return;
+    }
     displayRef.current.focus();
     const doc = (0, _ownerDocument.default)(event.currentTarget);
     scheduleMouseUpSelection();

package/Select/SelectInput.mjs

@@ -376,6 +376,9 @@ const SelectInput = /*#__PURE__*/React.forwardRef(function SelectInput(props, re
     }
     // Hijack the default focus behavior.
     event.preventDefault();
+    if (!displayRef.current) {
+      return;
+    }
     displayRef.current.focus();
     const doc = ownerDocument(event.currentTarget);
     scheduleMouseUpSelection();

package/Stack/Stack.d.mts

@@ -25,7 +25,7 @@ export interface StackOwnProps {
   /**
    * If `true`, the CSS flexbox `gap` is used instead of applying `margin` to children.
    *
-   * While CSS `gap` removes the [known limitations](https://mui.com/joy-ui/react-stack/#limitations),
+   * While CSS `gap` removes the known limitations,
    * it is not fully supported in some browsers. We recommend checking https://caniuse.com/?search=flex%20gap before using this flag.
    *
    * To enable this flag globally, follow the [theme's default props](https://mui.com/material-ui/customization/theme-components/#default-props) configuration.

package/Stack/Stack.d.ts

@@ -25,7 +25,7 @@ export interface StackOwnProps {
   /**
    * If `true`, the CSS flexbox `gap` is used instead of applying `margin` to children.
    *
-   * While CSS `gap` removes the [known limitations](https://mui.com/joy-ui/react-stack/#limitations),
+   * While CSS `gap` removes the known limitations,
    * it is not fully supported in some browsers. We recommend checking https://caniuse.com/?search=flex%20gap before using this flag.
    *
    * To enable this flag globally, follow the [theme's default props](https://mui.com/material-ui/customization/theme-components/#default-props) configuration.

package/Stack/Stack.js

@@ -56,7 +56,7 @@ process.env.NODE_ENV !== "production" ? Stack.propTypes /* remove-proptypes */ =
   /**
    * If `true`, the CSS flexbox `gap` is used instead of applying `margin` to children.
    *
-   * While CSS `gap` removes the [known limitations](https://mui.com/joy-ui/react-stack/#limitations),
+   * While CSS `gap` removes the known limitations,
    * it is not fully supported in some browsers. We recommend checking https://caniuse.com/?search=flex%20gap before using this flag.
    *
    * To enable this flag globally, follow the [theme's default props](https://mui.com/material-ui/customization/theme-components/#default-props) configuration.

package/Stack/Stack.mjs

@@ -50,7 +50,7 @@ process.env.NODE_ENV !== "production" ? Stack.propTypes /* remove-proptypes */ =
   /**
    * If `true`, the CSS flexbox `gap` is used instead of applying `margin` to children.
    *
-   * While CSS `gap` removes the [known limitations](https://mui.com/joy-ui/react-stack/#limitations),
+   * While CSS `gap` removes the known limitations,
    * it is not fully supported in some browsers. We recommend checking https://caniuse.com/?search=flex%20gap before using this flag.
    *
    * To enable this flag globally, follow the [theme's default props](https://mui.com/material-ui/customization/theme-components/#default-props) configuration.

package/Tooltip/Tooltip.js

@@ -384,14 +384,14 @@ const Tooltip = /*#__PURE__*/React.forwardRef(function Tooltip(inProps, ref) {
     }
   };
   const handleFocus = event => {
-    // Workaround for https://github.com/facebook/react/issues/7769
+    // Workaround for https://github.com/react/react/issues/7769
     // The autoFocus of React might trigger the event before the componentDidMount.
     // We need to account for this eventuality.
     if (!childNode) {
       setChildNode(event.currentTarget);
     }
     if ((0, _isFocusVisible.default)(event.target)) {
-      // Workaround for https://github.com/facebook/react/issues/9142.
+      // Workaround for https://github.com/react/react/issues/9142.
       // React does not fire blur when a focused element becomes disabled.
       const handleNativeBlur = blurEvent => {
         if (blurEvent.target.disabled) {

package/Tooltip/Tooltip.mjs

@@ -376,14 +376,14 @@ const Tooltip = /*#__PURE__*/React.forwardRef(function Tooltip(inProps, ref) {
     }
   };
   const handleFocus = event => {
-    // Workaround for https://github.com/facebook/react/issues/7769
+    // Workaround for https://github.com/react/react/issues/7769
     // The autoFocus of React might trigger the event before the componentDidMount.
     // We need to account for this eventuality.
     if (!childNode) {
       setChildNode(event.currentTarget);
     }
     if (isFocusVisible(event.target)) {
-      // Workaround for https://github.com/facebook/react/issues/9142.
+      // Workaround for https://github.com/react/react/issues/9142.
       // React does not fire blur when a focused element becomes disabled.
       const handleNativeBlur = blurEvent => {
         if (blurEvent.target.disabled) {

package/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/material v9.1.2
+ * @mui/material v9.2.0
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the

package/index.mjs

@@ -1,5 +1,5 @@
 /**
- * @mui/material v9.1.2
+ * @mui/material v9.2.0
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the

package/internal/SwitchBase.js

@@ -142,7 +142,7 @@ const SwitchBase = /*#__PURE__*/React.forwardRef(function SwitchBase(props, ref)
     }
   };
   const handleInputChange = event => {
-    // Workaround for https://github.com/facebook/react/issues/9023
+    // Workaround for https://github.com/react/react/issues/9023
     if (event.nativeEvent.defaultPrevented || readOnly) {
       return;
     }

package/internal/SwitchBase.mjs

@@ -135,7 +135,7 @@ const SwitchBase = /*#__PURE__*/React.forwardRef(function SwitchBase(props, ref)
     }
   };
   const handleInputChange = event => {
-    // Workaround for https://github.com/facebook/react/issues/9023
+    // Workaround for https://github.com/react/react/issues/9023
     if (event.nativeEvent.defaultPrevented || readOnly) {
       return;
     }

package/locale/zhCN.js

@@ -55,6 +55,27 @@ const zhCN = exports.zhCN = {
       defaultProps: {
         closeText: '关闭'
       }
+    },
+    MuiPagination: {
+      defaultProps: {
+        'aria-label': '分页导航',
+        getItemAriaLabel: (type, page, selected) => {
+          if (type === 'page') {
+            return `${selected ? '' : '转到'}第 ${page} 页`;
+          }
+          if (type === 'first') {
+            return '转到第一页';
+          }
+          if (type === 'last') {
+            return '转到最后一页';
+          }
+          if (type === 'next') {
+            return '转到下一页';
+          }
+          // if (type === 'previous')
+          return '转到上一页';
+        }
+      }
     }
   }
 };

package/locale/zhCN.mjs

@@ -48,6 +48,27 @@ export const zhCN = {
       defaultProps: {
         closeText: '关闭'
       }
+    },
+    MuiPagination: {
+      defaultProps: {
+        'aria-label': '分页导航',
+        getItemAriaLabel: (type, page, selected) => {
+          if (type === 'page') {
+            return `${selected ? '' : '转到'}第 ${page} 页`;
+          }
+          if (type === 'first') {
+            return '转到第一页';
+          }
+          if (type === 'last') {
+            return '转到最后一页';
+          }
+          if (type === 'next') {
+            return '转到下一页';
+          }
+          // if (type === 'previous')
+          return '转到上一页';
+        }
+      }
     }
   }
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/material",
-  "version": "9.1.2",
+  "version": "9.2.0",
   "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.",
   "license": "MIT",
@@ -33,10 +33,10 @@
     "prop-types": "^15.8.1",
     "react-is": "^19.2.6",
     "react-transition-group": "^4.4.5",
-    "@mui/system": "^9.1.2",
-    "@mui/core-downloads-tracker": "^9.1.2",
+    "@mui/core-downloads-tracker": "^9.2.0",
     "@mui/types": "^9.1.1",
-    "@mui/utils": "^9.1.1"
+    "@mui/system": "^9.2.0",
+    "@mui/utils": "^9.2.0"
   },
   "peerDependencies": {
     "@emotion/react": "^11.5.0",
@@ -44,7 +44,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": "^9.1.1"
+    "@mui/material-pigment-css": "^9.2.0"
   },
   "peerDependenciesMeta": {
     "@types/react": {

package/useScrollTrigger/useScrollTrigger.js

@@ -54,7 +54,7 @@ function useScrollTrigger(options = {}) {
         passive: true
       });
     };
-    // See Option 3. https://github.com/facebook/react/issues/14476#issuecomment-471199055
+    // See Option 3. https://github.com/react/react/issues/14476#issuecomment-471199055
     // TODO: uncomment once we enable eslint-plugin-react-compiler // eslint-disable-next-line react-compiler/react-compiler
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [target, getTrigger, JSON.stringify(other)]);

package/useScrollTrigger/useScrollTrigger.mjs

@@ -48,7 +48,7 @@ export default function useScrollTrigger(options = {}) {
         passive: true
       });
     };
-    // See Option 3. https://github.com/facebook/react/issues/14476#issuecomment-471199055
+    // See Option 3. https://github.com/react/react/issues/14476#issuecomment-471199055
     // TODO: uncomment once we enable eslint-plugin-react-compiler // eslint-disable-next-line react-compiler/react-compiler
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [target, getTrigger, JSON.stringify(other)]);

package/utils/types.d.mts

@@ -1,7 +1,7 @@
 import { SxProps } from '@mui/system';
 import { SlotComponentProps } from '@mui/utils/types';
 import { Theme } from "../styles/index.mjs";
-export type { EventHandlers, WithOptionalOwnerState, SlotComponentProps, SlotComponentPropsWithSlotState } from '@mui/utils/types';
+export type { EventHandlers, WithOptionalOwnerState, SlotComponentProps, SlotComponentPropsWithSlotState, DataAttributesOverrides, WithDataAttributes } from '@mui/utils/types';
 export type SlotCommonProps = {
   component?: React.ElementType | undefined;
   sx?: SxProps<Theme> | undefined;

package/utils/types.d.ts

@@ -1,7 +1,7 @@
 import { SxProps } from '@mui/system';
 import { SlotComponentProps } from '@mui/utils/types';
 import { Theme } from "../styles/index.js";
-export type { EventHandlers, WithOptionalOwnerState, SlotComponentProps, SlotComponentPropsWithSlotState } from '@mui/utils/types';
+export type { EventHandlers, WithOptionalOwnerState, SlotComponentProps, SlotComponentPropsWithSlotState, DataAttributesOverrides, WithDataAttributes } from '@mui/utils/types';
 export type SlotCommonProps = {
   component?: React.ElementType | undefined;
   sx?: SxProps<Theme> | undefined;

package/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 = "9.1.2";
+const version = exports.version = "9.2.0";
 const major = exports.major = Number("9");
-const minor = exports.minor = Number("1");
-const patch = exports.patch = Number("2");
+const minor = exports.minor = Number("2");
+const patch = exports.patch = Number("0");
 const prerelease = exports.prerelease = undefined;
 var _default = exports.default = version;

package/version/index.mjs

@@ -1,6 +1,6 @@
-export const version = "9.1.2";
+export const version = "9.2.0";
 export const major = Number("9");
-export const minor = Number("1");
-export const patch = Number("2");
+export const minor = Number("2");
+export const patch = Number("0");
 export const prerelease = undefined;
 export default version;