@mui/utils 9.2.0 → 9.3.0

package/CHANGELOG.md

@@ -1,21 +1,88 @@
 # [Versions](https://mui.com/material-ui/getting-started/versions/)
 
+## 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.3.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.3.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.3.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.3.0"
   },
   "peerDependencies": {
     "@types/react": "^17.0.0 || ^18.0.0 || ^19.0.0",

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)) {