@mui/material 9.1.1 → 9.2.0

package/Avatar/Avatar.js

@@ -118,6 +118,8 @@ function useLoaded(src, srcSet, crossOrigin, referrerPolicy) {
     if (!src && !srcSet) {
       return undefined;
     }
+
+    // eslint-disable-next-line react-hooks/set-state-in-effect
     setLoaded(false);
     let active = true;
     const image = new Image();

package/Avatar/Avatar.mjs

@@ -111,6 +111,8 @@ function useLoaded(src, srcSet, crossOrigin, referrerPolicy) {
     if (!src && !srcSet) {
       return undefined;
     }
+
+    // eslint-disable-next-line react-hooks/set-state-in-effect
     setLoaded(false);
     let active = true;
     const image = new Image();

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,79 @@
 # [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 -->
+
+_Jun 23, 2026_
+
+A big thanks to the 5 contributors who made this release possible.
+
+### `@mui/material@9.1.2`
+
+- [autocomplete] Don't submit forms when committing `freeSolo` value with Enter key (#48679) @mj12albert
+- [transitions] Fix RTG import in ESM (#48645) @mj12albert
+
+### `@mui/system@9.1.2`
+
+- [InitColorSchemeScript] Fix script tag warning in Next.js 16 dev mode (#48671) @siriwatknp
+
+### Docs
+
+- Fix typos in release instructions (#48687) @brijeshb42
+- Update @mui/x-\* packages to latest (#48661) @Janpot
+
+### Core
+
+- [code-infra] Convert leaf @mui/system .js+.d.ts pairs to TypeScript (part 1) (#48578) @Janpot
+- [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
+- [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
 
 <!-- generated comparing v9.1.0..master -->

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

@@ -330,6 +330,7 @@ const InputBase = /*#__PURE__*/React.forwardRef(function InputBase(inProps, ref)
   // We need to book keep the focused state manually.
   React.useEffect(() => {
     if (!muiFormControl && disabled && focused) {
+      // eslint-disable-next-line react-hooks/set-state-in-effect
       setFocused(false);
       if (onBlur) {
         onBlur();

package/InputBase/InputBase.mjs

@@ -321,6 +321,7 @@ const InputBase = /*#__PURE__*/React.forwardRef(function InputBase(inProps, ref)
   // We need to book keep the focused state manually.
   React.useEffect(() => {
     if (!muiFormControl && disabled && focused) {
+      // eslint-disable-next-line react-hooks/set-state-in-effect
       setFocused(false);
       if (onBlur) {
         onBlur();

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

@@ -43,6 +43,7 @@ function NoSsr(props) {
   }, [defer]);
   React.useEffect(() => {
     if (defer) {
+      // eslint-disable-next-line react-hooks/set-state-in-effect
       setMountedState(true);
     }
   }, [defer]);

package/NoSsr/NoSsr.mjs

@@ -36,6 +36,7 @@ function NoSsr(props) {
   }, [defer]);
   React.useEffect(() => {
     if (defer) {
+      // eslint-disable-next-line react-hooks/set-state-in-effect
       setMountedState(true);
     }
   }, [defer]);

package/Popper/BasePopper.js

@@ -92,17 +92,12 @@ const PopperTooltip = /*#__PURE__*/React.forwardRef(function PopperTooltip(props
    * modifiers.flip is essentially a flip for controlled/uncontrolled behavior
    */
   const [placement, setPlacement] = React.useState(rtlPlacement);
-  const [resolvedAnchorElement, setResolvedAnchorElement] = React.useState(resolveAnchorEl(anchorEl));
+  const resolvedAnchorElement = React.useMemo(() => resolveAnchorEl(anchorEl), [anchorEl]);
   React.useEffect(() => {
     if (popperRef.current) {
       popperRef.current.forceUpdate();
     }
   });
-  React.useEffect(() => {
-    if (anchorEl) {
-      setResolvedAnchorElement(resolveAnchorEl(anchorEl));
-    }
-  }, [anchorEl]);
   (0, _useEnhancedEffect.default)(() => {
     if (!resolvedAnchorElement || !open) {
       return undefined;

package/Popper/BasePopper.mjs

@@ -85,17 +85,12 @@ const PopperTooltip = /*#__PURE__*/React.forwardRef(function PopperTooltip(props
    * modifiers.flip is essentially a flip for controlled/uncontrolled behavior
    */
   const [placement, setPlacement] = React.useState(rtlPlacement);
-  const [resolvedAnchorElement, setResolvedAnchorElement] = React.useState(resolveAnchorEl(anchorEl));
+  const resolvedAnchorElement = React.useMemo(() => resolveAnchorEl(anchorEl), [anchorEl]);
   React.useEffect(() => {
     if (popperRef.current) {
       popperRef.current.forceUpdate();
     }
   });
-  React.useEffect(() => {
-    if (anchorEl) {
-      setResolvedAnchorElement(resolveAnchorEl(anchorEl));
-    }
-  }, [anchorEl]);
   useEnhancedEffect(() => {
     if (!resolvedAnchorElement || !open) {
       return undefined;

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

@@ -615,6 +615,7 @@ const Tabs = /*#__PURE__*/React.forwardRef(function Tabs(inProps, ref) {
     return undefined;
   }, [scrollable, scrollButtons, updateScrollObserver, childrenProp?.length]);
   React.useEffect(() => {
+    // eslint-disable-next-line react-hooks/set-state-in-effect
     setMounted(true);
   }, []);
   React.useEffect(() => {

package/Tabs/Tabs.mjs

@@ -608,6 +608,7 @@ const Tabs = /*#__PURE__*/React.forwardRef(function Tabs(inProps, ref) {
     return undefined;
   }, [scrollable, scrollButtons, updateScrollObserver, childrenProp?.length]);
   React.useEffect(() => {
+    // eslint-disable-next-line react-hooks/set-state-in-effect
     setMounted(true);
   }, []);
   React.useEffect(() => {

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.1
+ * @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.1
+ * @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/internal/Transition.js

@@ -12,11 +12,14 @@ var React = _interopRequireWildcard(require("react"));
 var _propTypes = _interopRequireDefault(require("prop-types"));
 var _useEnhancedEffect = _interopRequireDefault(require("@mui/utils/useEnhancedEffect"));
 var _useValueAsRef = _interopRequireDefault(require("@mui/utils/useValueAsRef"));
-var _TransitionGroupContext = _interopRequireDefault(require("react-transition-group/TransitionGroupContext"));
+var _TransitionGroupContext = _interopRequireDefault(require("react-transition-group/cjs/TransitionGroupContext.js"));
 var _utils = require("../transitions/utils");
 var _jsxRuntime = require("react/jsx-runtime");
 // Material UI transitions must still work inside react-transition-group's TransitionGroup.
 // Import only its context module; do not import its Transition or TransitionGroup components.
+// Use RTG's explicit CJS file for Node ESM/SSR; package.json's `browser` field redirects
+// browser bundles to RTG's ESM file.
+// eslint-disable-next-line import/extensions -- Node ESM needs the explicit .js extension.
 
 function resolveTimeouts(timeout) {
   if (timeout == null) {

package/internal/Transition.mjs

@@ -7,7 +7,10 @@ import useEnhancedEffect from '@mui/utils/useEnhancedEffect';
 import useValueAsRef from '@mui/utils/useValueAsRef';
 // Material UI transitions must still work inside react-transition-group's TransitionGroup.
 // Import only its context module; do not import its Transition or TransitionGroup components.
-import TransitionGroupContext from 'react-transition-group/TransitionGroupContext';
+// Use RTG's explicit CJS file for Node ESM/SSR; package.json's `browser` field redirects
+// browser bundles to RTG's ESM file.
+// eslint-disable-next-line import/extensions -- Node ESM needs the explicit .js extension.
+import TransitionGroupContext from 'react-transition-group/cjs/TransitionGroupContext.js';
 import { reflow } from "../transitions/utils.mjs";
 import { jsx as _jsx } from "react/jsx-runtime";
 function resolveTimeouts(timeout) {

package/internal/react-transition-group.d.mts

@@ -5,4 +5,12 @@ declare module 'react-transition-group/TransitionGroupContext' {
   }
   const TransitionGroupContext: React.Context<TransitionGroupContextValue | null>;
   export default TransitionGroupContext;
+}
+declare module 'react-transition-group/cjs/TransitionGroupContext.js' {
+  import * as React from 'react';
+  interface TransitionGroupContextValue {
+    isMounting: boolean;
+  }
+  const TransitionGroupContext: React.Context<TransitionGroupContextValue | null>;
+  export default TransitionGroupContext;
 }

package/internal/react-transition-group.d.ts

@@ -5,4 +5,12 @@ declare module 'react-transition-group/TransitionGroupContext' {
   }
   const TransitionGroupContext: React.Context<TransitionGroupContextValue | null>;
   export default TransitionGroupContext;
+}
+declare module 'react-transition-group/cjs/TransitionGroupContext.js' {
+  import * as React from 'react';
+  interface TransitionGroupContextValue {
+    isMounting: boolean;
+  }
+  const TransitionGroupContext: React.Context<TransitionGroupContextValue | null>;
+  export default TransitionGroupContext;
 }

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.1",
+  "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/core-downloads-tracker": "^9.1.1",
-    "@mui/system": "^9.1.1",
+    "@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": {
@@ -67,6 +67,9 @@
   "engines": {
     "node": ">=14.0.0"
   },
+  "browser": {
+    "react-transition-group/cjs/TransitionGroupContext.js": "react-transition-group/esm/TransitionGroupContext.js"
+  },
   "pigment-css": {
     "vite": {
       "include": [

package/useAutocomplete/useAutocomplete.js

@@ -267,6 +267,7 @@ function useAutocomplete(props) {
   // Ensure the focusedItem is never inconsistent
   React.useEffect(() => {
     if (multiple && focusedItem > value.length - 1) {
+      // eslint-disable-next-line react-hooks/set-state-in-effect
       setFocusedItem(-1);
       focusItem(-1);
     }
@@ -853,13 +854,13 @@ function useAutocomplete(props) {
           break;
         case 'Enter':
           {
-            // In freeSolo, only select the highlighted option if the user hasn't
-            // typed new text (inputPristine) or explicitly interacted with an option
-            // (keyboard, mouse, or touch — any non-null reason). This lets typed
-            // text win over a programmatic highlight (reason=null, e.g. from
-            // syncHighlightedIndex matching a previous value) while still honoring
-            // deliberate user interactions like hovering a suggestion then pressing Enter.
-            const shouldSelectHighlighted = !freeSolo || inputPristine || highlightReasonRef.current !== null;
+            // In freeSolo, once the user has typed new text, Enter should commit that text instead
+            // of treating a programmatic highlight as an intentional selection. Programmatic
+            // highlights include autoHighlight and syncHighlightedIndex matching a previous value.
+            const hasProgrammaticHighlight = popupOpen && highlightedIndexRef.current !== -1 && highlightReasonRef.current === null;
+            const shouldCommitFreeSoloOverProgrammaticHighlight = freeSolo && !inputPristine && hasProgrammaticHighlight;
+            const shouldSelectHighlighted = !freeSolo || inputPristine || !hasProgrammaticHighlight;
+            const shouldPreventSubmitAfterFreeSoloCommit = shouldCommitFreeSoloOverProgrammaticHighlight && !touchScrolledRef.current;
             if (highlightedIndexRef.current !== -1 && popupOpen && shouldSelectHighlighted &&
             // After a touch-scroll the highlight is stale (the user scrolled
             // past it), so skip selection until the next deliberate interaction.
@@ -879,8 +880,8 @@ function useAutocomplete(props) {
                 inputRef.current.setSelectionRange(inputRef.current.value.length, inputRef.current.value.length);
               }
             } else if (freeSolo && inputValue !== '' && inputValueIsSelectedValue === false) {
-              if (multiple) {
-                // Allow people to add new values before they submit the form.
+              if (multiple || shouldPreventSubmitAfterFreeSoloCommit) {
+                // Allow people to commit the freeSolo value before they submit the form.
                 event.preventDefault();
               }
               selectNewValue(event, inputValue, 'createOption', 'freeSolo');

package/useAutocomplete/useAutocomplete.mjs

@@ -259,6 +259,7 @@ function useAutocomplete(props) {
   // Ensure the focusedItem is never inconsistent
   React.useEffect(() => {
     if (multiple && focusedItem > value.length - 1) {
+      // eslint-disable-next-line react-hooks/set-state-in-effect
       setFocusedItem(-1);
       focusItem(-1);
     }
@@ -845,13 +846,13 @@ function useAutocomplete(props) {
           break;
         case 'Enter':
           {
-            // In freeSolo, only select the highlighted option if the user hasn't
-            // typed new text (inputPristine) or explicitly interacted with an option
-            // (keyboard, mouse, or touch — any non-null reason). This lets typed
-            // text win over a programmatic highlight (reason=null, e.g. from
-            // syncHighlightedIndex matching a previous value) while still honoring
-            // deliberate user interactions like hovering a suggestion then pressing Enter.
-            const shouldSelectHighlighted = !freeSolo || inputPristine || highlightReasonRef.current !== null;
+            // In freeSolo, once the user has typed new text, Enter should commit that text instead
+            // of treating a programmatic highlight as an intentional selection. Programmatic
+            // highlights include autoHighlight and syncHighlightedIndex matching a previous value.
+            const hasProgrammaticHighlight = popupOpen && highlightedIndexRef.current !== -1 && highlightReasonRef.current === null;
+            const shouldCommitFreeSoloOverProgrammaticHighlight = freeSolo && !inputPristine && hasProgrammaticHighlight;
+            const shouldSelectHighlighted = !freeSolo || inputPristine || !hasProgrammaticHighlight;
+            const shouldPreventSubmitAfterFreeSoloCommit = shouldCommitFreeSoloOverProgrammaticHighlight && !touchScrolledRef.current;
             if (highlightedIndexRef.current !== -1 && popupOpen && shouldSelectHighlighted &&
             // After a touch-scroll the highlight is stale (the user scrolled
             // past it), so skip selection until the next deliberate interaction.
@@ -871,8 +872,8 @@ function useAutocomplete(props) {
                 inputRef.current.setSelectionRange(inputRef.current.value.length, inputRef.current.value.length);
               }
             } else if (freeSolo && inputValue !== '' && inputValueIsSelectedValue === false) {
-              if (multiple) {
-                // Allow people to add new values before they submit the form.
+              if (multiple || shouldPreventSubmitAfterFreeSoloCommit) {
+                // Allow people to commit the freeSolo value before they submit the form.
                 event.preventDefault();
               }
               selectNewValue(event, inputValue, 'createOption', 'freeSolo');

package/useScrollTrigger/useScrollTrigger.js

@@ -36,6 +36,7 @@ function useScrollTrigger(options = {}) {
   const [trigger, setTrigger] = React.useState(() => getTrigger(store, other));
   React.useEffect(() => {
     if (target === null) {
+      // eslint-disable-next-line react-hooks/set-state-in-effect
       return setTrigger(false);
     }
     const handleScroll = () => {
@@ -53,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

@@ -30,6 +30,7 @@ export default function useScrollTrigger(options = {}) {
   const [trigger, setTrigger] = React.useState(() => getTrigger(store, other));
   React.useEffect(() => {
     if (target === null) {
+      // eslint-disable-next-line react-hooks/set-state-in-effect
       return setTrigger(false);
     }
     const handleScroll = () => {
@@ -47,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.1";
+const version = exports.version = "9.2.0";
 const major = exports.major = Number("9");
-const minor = exports.minor = Number("1");
-const patch = exports.patch = Number("1");
+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.1";
+export const version = "9.2.0";
 export const major = Number("9");
-export const minor = Number("1");
-export const patch = Number("1");
+export const minor = Number("2");
+export const patch = Number("0");
 export const prerelease = undefined;
 export default version;