@mui/utils 9.2.0 → 9.4.0

package/CHANGELOG.md

@@ -1,21 +1,175 @@
 # [Versions](https://mui.com/material-ui/getting-started/versions/)
 
+## 9.4.0
+
+<!-- generated comparing v9.3.1..master -->
+
+_Aug 27, 2026_
+
+A big thanks to the 19 contributors who made this release possible. Here are some highlights ✨:
+
+- ♿️ Opt in to a consistent [keyboard focus ring](https://mui.com/material-ui/customization/focus-visible/) across components with the new `theme.focusVisible`.
+- ♿️ The [Tooltip](https://mui.com/material-ui/react-tooltip/) now supports disabled button triggers without an extra wrapper element.
+
+### `@mui/material@9.4.0`
+
+- [theme] Add `theme.focusVisible` opt-in keyboard focus ring (#48743) @siriwatknp
+- [buttongroup] Prevent sticky hover border on touch devices (#48993) @petr-kratochvil
+- [l10n] Complete Traditional Chinese localization (#48946) @nrps9909
+- [menulist] Preserve custom list padding when adjusting for the scrollbar (#48707) @creazyfrog
+- [pagination] Manage focus whenever first / last / next / previous buttons become disabled (#48877) @silviuaavram
+- [tooltip] Improve support for disabled button triggers (#48622) @mayank99
+
+### `@mui/utils@9.4.0`
+
+- Fix resolveProps to correctly merge slotProps defined as functions (#48955) @mnajdova
+- Replace deprecated `clip` CSS property with `clip-path` (#48966) @ZeeshanTamboli
+
+### `@mui/styled-engine-sc@9.4.0`
+
+- Fix types for components extended with styled (#45988) @megos
+
+### Docs
+
+- Bump @docsearch/react to ^4.7.0 (#48886) @LukasTy
+- Fix broken links reported by Ahrefs (#48949) @brijeshb42
+- Manage focus on Open in Chat button click (#48942) @silviuaavram
+- Move focus to the main content with the skip link (#48944) @lazerg
+- Use relative link for LICENSE in README (#49040) @loulanyue
+- [autocomplete] Remove the "aria-owns" reference (#48958) @silviuaavram
+- [table] Fix wrong number of rows reported to screen readers (#47653) @seomsoo
+- [table] Reference DataGrid link in the row header section (#48988) @silviuaavram
+- [table] Use and document the row header cells (#48965) @silviuaavram
+- [tabs] Make tab panel focusable and show keep mounted examples (#48939) @silviuaavram
+- [templates] Remove focusable links from hidden carousel slides (#49003) @gonzoblasco
+
+### Core
+
+- [code-infra] Fix team sync review requests (#48914) @brijeshb42
+- [code-infra] Import the test globals from vitest (#49033) @JCQuintas
+- [code-infra] Point the support validator link at frontend-public (#49041) @Janpot
+- [code-infra] Update CircleCI orb (#49030) @Janpot
+- [code-infra] Use ESM current directory syntax for Vitest config (#49032) @ZeeshanTamboli
+- [core] Use @typescript/typescript6 for the docs tooling (#49025) @Janpot
+- [core-docs] Remove the `globalSelector` stylis middleware (#49029) @Janpot
+- [test] Add an `assertions` mode to the axe regression harness (#48915) @michelengelen
+- [test] Automate the CSS-dependent WCAG criteria (#48936) @michelengelen
+- [test] Fail the regression run when a webfont does not load (#48948) @LukasTy
+- [test] Fix typo 'overriden' -> 'overridden' in Alert test comment (#48987) @FirmaSpring
+- [test] Replace webfontloader with the CSS Font Loading API (#48995) @LukasTy
+- [test] Skip the CrudDashboard VRT on React 18 (#49027) @Janpot
+- [test] Use the shared loadFonts from @mui/internal-test-utils (#49007) @LukasTy
+- [test] Use the Vitest global expect instead of importing chai (#48996) @JCQuintas
+- [test][tooltip] Keep the disabled trigger away from the real pointer (#48947) @LukasTy
+
+All contributors of this release in alphabetical order: @brijeshb42, @creazyfrog, @FirmaSpring, @gonzoblasco, @Janpot, @JCQuintas, @lazerg, @loulanyue, @LukasTy, @mayank99, @megos, @michelengelen, @mnajdova, @nrps9909, @petr-kratochvil, @seomsoo, @silviuaavram, @siriwatknp, @ZeeshanTamboli
+
+## 9.3.1
+
+<!-- generated comparing v9.3.0..master -->
+
+_Aug 6, 2026_
+
+A big thanks to the 4 contributors who made this release possible.
+
+### `@mui/material@9.3.1`
+
+- [transitions] Prevent exit transitions from getting stuck (#48881) @ZeeshanTamboli
+
+### `@mui/codemod@9.3.1`
+
+- Include transforms in published package (#48934) @brijeshb42
+
+### Core
+
+- [blog] Clarify early bird renewal discount scope (#48906) @DanailH
+- [test][pagination] Add more unit tests (#48927) @silviuaavram
+
+All contributors of this release in alphabetical order: @brijeshb42, @DanailH, @silviuaavram, @ZeeshanTamboli
+
+## 9.3.0
+
+<!-- generated comparing v9.2.0..master -->
+
+_Aug 4, 2026_
+
+A big thanks to the 18 contributors who made this release possible. Here are some highlights ✨:
+
+- ♿️ Keyboard navigation in the [Toggle Button Group](https://mui.com/material-ui/react-toggle-button/) now follows the roving tabindex pattern.
+- ♿️ The [Autocomplete](https://mui.com/material-ui/react-autocomplete/) announces its loading and no options messages through a new `status` slot.
+
+### `@mui/material@9.3.0`
+
+- [autocomplete] Wrap the no results and loading messages in an aria live region (#48690) @silviuaavram
+- [buttongroup] Respect global disableRipple / disableFocusRipple in grouped buttons (#48762) @siriwatknp
+- [checkbox][radio] Respect global disableRipple from MuiButtonBase defaultProps (#48795) @siriwatknp
+- [formcontrollabel] Add missing `labelPlacementEnd` class (#48843) @siriwatknp
+- [listitembutton] Fix typos in component code (#48868) @ZeeshanTamboli
+- [menuitem] Add `aria-checked` for checkbox and radio menu items (#48651) @siriwatknp
+- [modal] Replace custom findIndexOf with findIndex (#48827) @ZeeshanTamboli
+- [modal][dialog] Fix scrollbar compensation in Shadow DOM (#48826) @ZeeshanTamboli
+- [select] Fix endAdornment overlapping the open indicator (#48723) @siriwatknp
+- [tablepagination] Add focus style to default InputBase used in Select (#48871) @silviuaavram
+- [togglebuttongroup] Add roving tabindex keyboard navigation (#48849) @silviuaavram
+
+### `@mui/system@9.3.0`
+
+- Prevent prototype pollution in cssVarsParser (#48822) @Janpot
+
+### `@mui/codemod@9.3.0`
+
+- Don't leak state between files in v5.0.0/path-imports (#48797) @manbearwiz
+- Remove use of eval() (#48701) @oliviertassinari
+- Transform all style exports in `v5.0.0/path-imports` codemod (#48800) @manbearwiz
+
+### Docs
+
+- Clarify `container` prop inheritance for Shadow DOM (#48670) @Juan-C-Ceballos
+- Clarify third-party script risk in CSP unsafe-inline note (#48787) @Janpot
+- Document `box-sx-prop` codemod (#48888) @SR0725
+- Document Grid direction column removal in v9 upgrade guide (#48880) @kalayciburak
+- Fix color contrast in GitHub labels example (#48844) @silviuaavram
+- Fix per-page canonical URL and stale SEO link (#48789) @brijeshb42
+- Fix redirect loop on the Design Kits page (#48869) @Janpot
+- Fix typo 'overriden' -> 'overridden' in CHANGELOG (#48785) @ZhouYinLong-lab
+- Improve TransferList examples (#48845) @silviuaavram
+- Link a new theme generator tool (#48847) @mansourcodes
+- Remove broken learning resource links (#48598) @morning-verlu
+- Update the 9.2.0 changelog (#48763) @silviuaavram
+- [autocomplete] Clarify how to render custom start and end adornments (#48883) @DebadityaHait
+- [drawer] Clarify clipped AppBar spacing (#48887) @rushijagani-dev
+- [menu] Fix stale `selected` prop reference in Selected menu section (#48879) @LukasTy
+- [skeleton] Document preserving typography sizing with custom border radius (#48596) @meaqua9420
+
+### Core
+
+- [blog] Fix caret annotation broken by Prettier wrapping (#48884) @bernardobelchior
+- [code-infra] Automate team sync on about page (#48794) @brijeshb42
+- [code-infra] Bump @mui/internal-code-infra to 0.0.4-canary.101 (#48878) @Janpot
+- [code-infra] Fix Dependabot alerts (#48756) @Janpot
+- [code-infra] Fix team sync PR creation (#48911) @brijeshb42
+- [code-infra] Pin node version in publish CI (#48799) @brijeshb42
+- [core-docs] Tighten service worker host check (#48581) @Janpot
+- [docs-infra] Change branch name to the allowed one (#48910) @brijeshb42
+
+All contributors of this release in alphabetical order: @bernardobelchior, @brijeshb42, @DebadityaHait, @Janpot, @Juan-C-Ceballos, @kalayciburak, @LukasTy, @manbearwiz, @mansourcodes, @meaqua9420, @morning-verlu, @oliviertassinari, @rushijagani-dev, @silviuaavram, @siriwatknp, @SR0725, @ZeeshanTamboli, @ZhouYinLong-lab
+
 ## 9.2.0
 
 <!-- generated comparing v9.1.2..master -->
 
-_Jul 2, 2026_
+_Jul 3, 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`
+### `@mui/material@9.2.0`
 
 - [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`
+### `@mui/utils@9.2.0`
 
 - [utils] Add opt-in `DataAttributesOverrides` augmentation for slot props (#48554) @LukasTy
 

package/ClassNameGenerator/ClassNameGenerator.d.mts

@@ -1,5 +1,6 @@
+declare const defaultGenerator: (componentName: string) => string;
 declare const ClassNameGenerator: {
-  configure(generator: (componentName: string) => string): void;
+  configure(generator: typeof defaultGenerator): void;
   generate(componentName: string): string;
   reset(): void;
 };

package/ClassNameGenerator/ClassNameGenerator.d.ts

@@ -1,5 +1,6 @@
+declare const defaultGenerator: (componentName: string) => string;
 declare const ClassNameGenerator: {
-  configure(generator: (componentName: string) => string): void;
+  configure(generator: typeof defaultGenerator): void;
   generate(componentName: string): string;
   reset(): void;
 };

package/index.js

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

package/index.mjs

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/utils",
-  "version": "9.2.0",
+  "version": "9.4.0",
   "author": "MUI Team",
   "description": "Utility functions for React components.",
   "license": "MIT",
@@ -24,12 +24,12 @@
     "url": "https://opencollective.com/mui-org"
   },
   "dependencies": {
-    "@babel/runtime": "^7.29.2",
+    "@babel/runtime": "^7.29.7",
     "@types/prop-types": "^15.7.15",
     "clsx": "^2.1.1",
     "prop-types": "^15.8.1",
-    "react-is": "^19.2.6",
-    "@mui/types": "^9.1.1"
+    "react-is": "^19.2.8",
+    "@mui/types": "^9.4.0"
   },
   "peerDependencies": {
     "@types/react": "^17.0.0 || ^18.0.0 || ^19.0.0",

package/resolveProps/resolveProps.js

@@ -41,7 +41,15 @@ function resolveProps(defaultProps, props, mergeClassNameAndStyle = false) {
           for (const slotKey in defaultSlotProps) {
             if (Object.prototype.hasOwnProperty.call(defaultSlotProps, slotKey)) {
               const slotPropName = slotKey;
-              output[propName][slotPropName] = resolveProps(defaultSlotProps[slotPropName], slotProps[slotPropName], mergeClassNameAndStyle);
+              const defaultSlotPropValue = defaultSlotProps[slotPropName];
+              const slotPropValue = slotProps[slotPropName];
+              if (typeof defaultSlotPropValue === 'function' || typeof slotPropValue === 'function') {
+                // Function slot props are resolved later (with `ownerState`), so defer
+                // the merge until then to avoid dropping either side.
+                output[propName][slotPropName] = (...args) => resolveProps((typeof defaultSlotPropValue === 'function' ? defaultSlotPropValue(...args) : defaultSlotPropValue) ?? {}, (typeof slotPropValue === 'function' ? slotPropValue(...args) : slotPropValue) ?? {}, mergeClassNameAndStyle);
+              } else {
+                output[propName][slotPropName] = resolveProps(defaultSlotPropValue ?? {}, slotPropValue ?? {}, mergeClassNameAndStyle);
+              }
             }
           }
         }

package/resolveProps/resolveProps.mjs

@@ -35,7 +35,15 @@ export default function resolveProps(defaultProps, props, mergeClassNameAndStyle
           for (const slotKey in defaultSlotProps) {
             if (Object.prototype.hasOwnProperty.call(defaultSlotProps, slotKey)) {
               const slotPropName = slotKey;
-              output[propName][slotPropName] = resolveProps(defaultSlotProps[slotPropName], slotProps[slotPropName], mergeClassNameAndStyle);
+              const defaultSlotPropValue = defaultSlotProps[slotPropName];
+              const slotPropValue = slotProps[slotPropName];
+              if (typeof defaultSlotPropValue === 'function' || typeof slotPropValue === 'function') {
+                // Function slot props are resolved later (with `ownerState`), so defer
+                // the merge until then to avoid dropping either side.
+                output[propName][slotPropName] = (...args) => resolveProps((typeof defaultSlotPropValue === 'function' ? defaultSlotPropValue(...args) : defaultSlotPropValue) ?? {}, (typeof slotPropValue === 'function' ? slotPropValue(...args) : slotPropValue) ?? {}, mergeClassNameAndStyle);
+              } else {
+                output[propName][slotPropName] = resolveProps(defaultSlotPropValue ?? {}, slotPropValue ?? {}, mergeClassNameAndStyle);
+              }
             }
           }
         }

package/useRovingTabIndex/useRovingTabIndex.d.mts

@@ -91,7 +91,7 @@ export interface UseRovingTabIndexReturnValue<Key = unknown> {
    * Spread these props onto the list or composite root element that should listen for focus
    * and keyboard events.
    */
-  getContainerProps: (ref?: React.Ref<HTMLElement>) => {
+  getContainerProps: (ref?: React.Ref<HTMLElement> | undefined, onFocus?: ((event: React.FocusEvent<HTMLElement>) => void) | undefined, onKeyDown?: ((event: React.KeyboardEvent<HTMLElement>) => void) | undefined) => {
     /**
      * Keeps the active item in sync when focus moves onto one of the registered items.
      */

package/useRovingTabIndex/useRovingTabIndex.d.ts

@@ -91,7 +91,7 @@ export interface UseRovingTabIndexReturnValue<Key = unknown> {
    * Spread these props onto the list or composite root element that should listen for focus
    * and keyboard events.
    */
-  getContainerProps: (ref?: React.Ref<HTMLElement>) => {
+  getContainerProps: (ref?: React.Ref<HTMLElement> | undefined, onFocus?: ((event: React.FocusEvent<HTMLElement>) => void) | undefined, onKeyDown?: ((event: React.KeyboardEvent<HTMLElement>) => void) | undefined) => {
     /**
      * Keeps the active item in sync when focus moves onto one of the registered items.
      */

package/useRovingTabIndex/useRovingTabIndex.js

@@ -97,8 +97,9 @@ function useRovingTabIndexRoot(params) {
     setActiveItemIdState(nextItem.id);
     return nextItem;
   }, [itemFilter]);
-  const getContainerProps = React.useCallback(ref => {
+  const getContainerProps = React.useCallback((ref, onFocusProp, onKeyDownProp) => {
     const onFocus = event => {
+      onFocusProp?.(event);
       const snapshot = getNavigableItemsSnapshot(itemMapRef.current);
       const focusedIndex = findItemIndexByElement(snapshot, event.target);
       if (focusedIndex !== -1) {
@@ -106,7 +107,8 @@ function useRovingTabIndexRoot(params) {
       }
     };
     const onKeyDown = event => {
-      if (event.altKey || event.shiftKey || event.ctrlKey || event.metaKey) {
+      onKeyDownProp?.(event);
+      if (event.defaultPrevented || event.altKey || event.shiftKey || event.ctrlKey || event.metaKey) {
         return;
       }
       if (!SUPPORTED_KEYS.includes(event.key)) {

package/useRovingTabIndex/useRovingTabIndex.mjs

@@ -88,8 +88,9 @@ export function useRovingTabIndexRoot(params) {
     setActiveItemIdState(nextItem.id);
     return nextItem;
   }, [itemFilter]);
-  const getContainerProps = React.useCallback(ref => {
+  const getContainerProps = React.useCallback((ref, onFocusProp, onKeyDownProp) => {
     const onFocus = event => {
+      onFocusProp?.(event);
       const snapshot = getNavigableItemsSnapshot(itemMapRef.current);
       const focusedIndex = findItemIndexByElement(snapshot, event.target);
       if (focusedIndex !== -1) {
@@ -97,7 +98,8 @@ export function useRovingTabIndexRoot(params) {
       }
     };
     const onKeyDown = event => {
-      if (event.altKey || event.shiftKey || event.ctrlKey || event.metaKey) {
+      onKeyDownProp?.(event);
+      if (event.defaultPrevented || event.altKey || event.shiftKey || event.ctrlKey || event.metaKey) {
         return;
       }
       if (!SUPPORTED_KEYS.includes(event.key)) {

package/visuallyHidden/visuallyHidden.js

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.default = void 0;
 const visuallyHidden = {
   border: 0,
-  clip: 'rect(0 0 0 0)',
+  clipPath: 'inset(50%)',
   height: '1px',
   margin: '-1px',
   overflow: 'hidden',

package/visuallyHidden/visuallyHidden.mjs

@@ -1,6 +1,6 @@
 const visuallyHidden = {
   border: 0,
-  clip: 'rect(0 0 0 0)',
+  clipPath: 'inset(50%)',
   height: '1px',
   margin: '-1px',
   overflow: 'hidden',