@mui/utils 9.0.0-beta.0 → 9.0.0

package/CHANGELOG.md

@@ -1,5 +1,81 @@
 # [Versions](https://mui.com/versions/)
 
+## 9.0.0
+
+<!-- generated comparing v9.0.0-beta.1..master -->
+
+_Apr 7, 2026_
+
+A big thanks to the 7 contributors who made this release possible.
+
+🥳 We're excited to announce the stable release of Material UI v9! This major release focus on accessibility improvements, sx prop performance, and cleanup of deprecated APIs.
+
+For more details, check out the [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9/).
+
+### `@mui/material@9.0.0`
+
+- [slider] Use pointer events instead of mouse events (#48164) @mj12albert
+- [switch] Add border to make it visible in high contrast mode (#48180) @silviuaavram
+- [transitions] Performance improvements & misc fixes (#48151) @mj12albert
+- Remove unnecessary overridesResolvers from styled components (#48204) @sai6855
+
+### Core
+
+- [code-infra] Setup workflow to publish internal packages (#47952) @brijeshb42
+- [core-docs] Add `x-scheduler` to `MuiProductId` type (#48185) @rita-codes
+- [docs-infra] Add scheduler to product switcher (#48208) @rita-codes
+- [internal] Prepare libraries for v9 stable release (#48206) @siriwatknp
+
+All contributors of this release in alphabetical order: @brijeshb42, @mj12albert, @noraleonte, @rita-codes, @sai6855, @silviuaavram, @siriwatknp
+
+## 9.0.0-beta.1
+
+<!-- generated comparing v9.0.0-beta.0..master -->
+
+_Apr 2, 2026_
+
+A big thanks to the 11 contributors who made this release possible.
+
+### `@mui/material@9.0.0-beta.1`
+
+#### Breaking Changes
+
+- [grid] Remove 'column' and 'column-reverse' options from `direction` prop (#47564) @sai6855
+- [icons] Remove legacy `*Outline` icons (#48116) @mj12albert
+- [list-item-icon] Use theme spacing instead of hardcoded minWidth (#46597) @adiitxa
+
+#### Changes
+
+- [all components] Fix `slotProps.transition` types (#48153) @mj12albert
+- [alert][dialog] Accessibility improvements (#48113) @silviuaavram
+- [autocomplete] Fix helper text focusing input when clicked (#48156) @mj12albert
+- [button-base] Add `nativeButton` prop (#47989) @mj12albert
+- [input] Fix high contrast cutoff on first character (#48150) @silviuaavram
+- [menu] Fix empty roving focus container (#48114) @mj12albert
+- [utils] Explicitly register roving tab items with parent (#48122) @mj12albert
+
+### Docs
+
+- Fix HTML validation errors (#48107) @Janpot
+- Fix duplicate IDs and HTML validation issues (#48095) @Janpot
+- Fix the dark mode footer row shadow for the Data Grid on the advanced components page (#48149) @arminmeh
+- Improve jsdom section (#48098) @oliviertassinari
+- Update "Deprecated APIs removed" section to h2 in "Upgrade to v9" docs (#48115) @ZeeshanTamboli
+- [docs][progress] Label all demo components (#48143) @mj12albert
+- [docs-infra] Add x-scheduler to component API URL resolver (#48097) @rita-codes
+- [docs-infra] Resolve some redirects (#48165) @Janpot
+- [docs-infra] Update v9 Search Index (#48028) @dav-is
+
+### Core
+
+- [code-infra] Discover exports for bundle size report (#48170) @Janpot
+- [internal] Fix use of ellipsis (#48096) @oliviertassinari
+- [test] Add screenshot test for Virtualized Table (#47947) @mnajdova
+- [test] Remove `componentsProp` from `describeConformance` tests (#48142) @ZeeshanTamboli
+- [theme] Do not create channel tokens for custom colors when `nativeColor` is used (#47765) @ZeeshanTamboli
+
+All contributors of this release in alphabetical order: @adiitxa, @arminmeh, @dav-is, @Janpot, @mj12albert, @mnajdova, @oliviertassinari, @rita-codes, @sai6855, @silviuaavram, @ZeeshanTamboli
+
 ## 9.0.0-beta.0
 
 <!-- generated comparing v9.0.0-alpha.4..master -->

package/fastObjectShallowCompare/fastObjectShallowCompare.d.mts

@@ -0,0 +1,6 @@
+/**
+ * Fast shallow compare for plain objects.
+ * Returns `true` when both objects have the same own enumerable keys and each value is equal
+ * according to `Object.is()`.
+ */
+export default function fastObjectShallowCompare<T extends Record<string, any> | null>(a: T, b: T): boolean;

package/fastObjectShallowCompare/fastObjectShallowCompare.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Fast shallow compare for plain objects.
+ * Returns `true` when both objects have the same own enumerable keys and each value is equal
+ * according to `Object.is()`.
+ */
+export default function fastObjectShallowCompare<T extends Record<string, any> | null>(a: T, b: T): boolean;

package/fastObjectShallowCompare/fastObjectShallowCompare.js

@@ -0,0 +1,41 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = fastObjectShallowCompare;
+// From mui-x: https://github.com/mui/mui-x/blob/bb92fb0adac6764461adea9a9d7d43f1095f49e5/packages/x-internals/src/fastObjectShallowCompare/fastObjectShallowCompare.ts
+/* eslint-disable guard-for-in */
+
+const is = Object.is;
+
+/**
+ * Fast shallow compare for plain objects.
+ * Returns `true` when both objects have the same own enumerable keys and each value is equal
+ * according to `Object.is()`.
+ */
+function fastObjectShallowCompare(a, b) {
+  if (a === b) {
+    return true;
+  }
+  if (!(a instanceof Object) || !(b instanceof Object)) {
+    return false;
+  }
+  let aLength = 0;
+  let bLength = 0;
+  for (const key in a) {
+    aLength += 1;
+    if (!is(a[key], b[key])) {
+      return false;
+    }
+    if (!(key in b)) {
+      return false;
+    }
+  }
+
+  // eslint-disable-next-line @typescript-eslint/naming-convention, @typescript-eslint/no-unused-vars
+  for (const _ in b) {
+    bLength += 1;
+  }
+  return aLength === bLength;
+}

package/fastObjectShallowCompare/fastObjectShallowCompare.mjs

@@ -0,0 +1,35 @@
+// From mui-x: https://github.com/mui/mui-x/blob/bb92fb0adac6764461adea9a9d7d43f1095f49e5/packages/x-internals/src/fastObjectShallowCompare/fastObjectShallowCompare.ts
+/* eslint-disable guard-for-in */
+
+const is = Object.is;
+
+/**
+ * Fast shallow compare for plain objects.
+ * Returns `true` when both objects have the same own enumerable keys and each value is equal
+ * according to `Object.is()`.
+ */
+export default function fastObjectShallowCompare(a, b) {
+  if (a === b) {
+    return true;
+  }
+  if (!(a instanceof Object) || !(b instanceof Object)) {
+    return false;
+  }
+  let aLength = 0;
+  let bLength = 0;
+  for (const key in a) {
+    aLength += 1;
+    if (!is(a[key], b[key])) {
+      return false;
+    }
+    if (!(key in b)) {
+      return false;
+    }
+  }
+
+  // eslint-disable-next-line @typescript-eslint/naming-convention, @typescript-eslint/no-unused-vars
+  for (const _ in b) {
+    bLength += 1;
+  }
+  return aLength === bLength;
+}

package/fastObjectShallowCompare/index.d.mts

@@ -0,0 +1 @@
+export { default } from "./fastObjectShallowCompare.mjs";

package/fastObjectShallowCompare/index.d.ts

@@ -0,0 +1 @@
+export { default } from "./fastObjectShallowCompare.js";

package/fastObjectShallowCompare/index.js

@@ -0,0 +1,13 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "default", {
+  enumerable: true,
+  get: function () {
+    return _fastObjectShallowCompare.default;
+  }
+});
+var _fastObjectShallowCompare = _interopRequireDefault(require("./fastObjectShallowCompare"));

package/fastObjectShallowCompare/index.mjs

@@ -0,0 +1 @@
+export { default } from "./fastObjectShallowCompare.mjs";

package/index.d.mts

@@ -15,6 +15,7 @@ export { default as unstable_createChainedFunction } from "./createChainedFuncti
 export { default as unstable_debounce } from "./debounce/index.mjs";
 export { default as unstable_deprecatedPropType } from "./deprecatedPropType/index.mjs";
 export { default as unstable_fastDeepAssign } from "./fastDeepAssign/index.mjs";
+export { default as unstable_fastObjectShallowCompare } from "./fastObjectShallowCompare/index.mjs";
 export { default as unstable_isObjectEmpty } from "./isObjectEmpty/index.mjs";
 export { default as unstable_isMuiElement } from "./isMuiElement/index.mjs";
 export { default as unstable_ownerDocument } from "./ownerDocument/index.mjs";
@@ -51,5 +52,4 @@ export { default as unstable_resolveComponentProps } from "./resolveComponentPro
 export { default as unstable_extractEventHandlers } from "./extractEventHandlers/index.mjs";
 export { default as unstable_getReactNodeRef } from "./getReactNodeRef/index.mjs";
 export { default as unstable_getReactElementRef } from "./getReactElementRef/index.mjs";
-export { default as unstable_useRovingTabIndex } from "./useRovingTabIndex/index.mjs";
 export * from "./types/index.mjs";

package/index.d.ts

@@ -15,6 +15,7 @@ export { default as unstable_createChainedFunction } from "./createChainedFuncti
 export { default as unstable_debounce } from "./debounce/index.js";
 export { default as unstable_deprecatedPropType } from "./deprecatedPropType/index.js";
 export { default as unstable_fastDeepAssign } from "./fastDeepAssign/index.js";
+export { default as unstable_fastObjectShallowCompare } from "./fastObjectShallowCompare/index.js";
 export { default as unstable_isObjectEmpty } from "./isObjectEmpty/index.js";
 export { default as unstable_isMuiElement } from "./isMuiElement/index.js";
 export { default as unstable_ownerDocument } from "./ownerDocument/index.js";
@@ -51,5 +52,4 @@ export { default as unstable_resolveComponentProps } from "./resolveComponentPro
 export { default as unstable_extractEventHandlers } from "./extractEventHandlers/index.js";
 export { default as unstable_getReactNodeRef } from "./getReactNodeRef/index.js";
 export { default as unstable_getReactElementRef } from "./getReactElementRef/index.js";
-export { default as unstable_useRovingTabIndex } from "./useRovingTabIndex/index.js";
 export * from "./types/index.js";

package/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/utils v9.0.0-beta.0
+ * @mui/utils v9.0.0
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the
@@ -30,6 +30,7 @@ var _exportNames = {
   unstable_debounce: true,
   unstable_deprecatedPropType: true,
   unstable_fastDeepAssign: true,
+  unstable_fastObjectShallowCompare: true,
   unstable_isObjectEmpty: true,
   unstable_isMuiElement: true,
   unstable_ownerDocument: true,
@@ -64,8 +65,7 @@ var _exportNames = {
   unstable_resolveComponentProps: true,
   unstable_extractEventHandlers: true,
   unstable_getReactNodeRef: true,
-  unstable_getReactElementRef: true,
-  unstable_useRovingTabIndex: true
+  unstable_getReactElementRef: true
 };
 Object.defineProperty(exports, "HTMLElementType", {
   enumerable: true,
@@ -211,6 +211,12 @@ Object.defineProperty(exports, "unstable_fastDeepAssign", {
     return _fastDeepAssign.default;
   }
 });
+Object.defineProperty(exports, "unstable_fastObjectShallowCompare", {
+  enumerable: true,
+  get: function () {
+    return _fastObjectShallowCompare.default;
+  }
+});
 Object.defineProperty(exports, "unstable_generateUtilityClass", {
   enumerable: true,
   get: function () {
@@ -355,12 +361,6 @@ Object.defineProperty(exports, "unstable_useOnMount", {
     return _useOnMount.default;
   }
 });
-Object.defineProperty(exports, "unstable_useRovingTabIndex", {
-  enumerable: true,
-  get: function () {
-    return _useRovingTabIndex.default;
-  }
-});
 Object.defineProperty(exports, "unstable_useSlotProps", {
   enumerable: true,
   get: function () {
@@ -401,6 +401,7 @@ var _createChainedFunction = _interopRequireDefault(require("./createChainedFunc
 var _debounce = _interopRequireDefault(require("./debounce"));
 var _deprecatedPropType = _interopRequireDefault(require("./deprecatedPropType"));
 var _fastDeepAssign = _interopRequireDefault(require("./fastDeepAssign"));
+var _fastObjectShallowCompare = _interopRequireDefault(require("./fastObjectShallowCompare"));
 var _isObjectEmpty = _interopRequireDefault(require("./isObjectEmpty"));
 var _isMuiElement = _interopRequireDefault(require("./isMuiElement"));
 var _ownerDocument = _interopRequireDefault(require("./ownerDocument"));
@@ -445,7 +446,6 @@ var _resolveComponentProps = _interopRequireDefault(require("./resolveComponentP
 var _extractEventHandlers = _interopRequireDefault(require("./extractEventHandlers"));
 var _getReactNodeRef = _interopRequireDefault(require("./getReactNodeRef"));
 var _getReactElementRef = _interopRequireDefault(require("./getReactElementRef"));
-var _useRovingTabIndex = _interopRequireDefault(require("./useRovingTabIndex"));
 var _types = require("./types");
 Object.keys(_types).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;

package/index.mjs

@@ -1,5 +1,5 @@
 /**
- * @mui/utils v9.0.0-beta.0
+ * @mui/utils v9.0.0
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the
@@ -22,6 +22,7 @@ export { default as unstable_createChainedFunction } from "./createChainedFuncti
 export { default as unstable_debounce } from "./debounce/index.mjs";
 export { default as unstable_deprecatedPropType } from "./deprecatedPropType/index.mjs";
 export { default as unstable_fastDeepAssign } from "./fastDeepAssign/index.mjs";
+export { default as unstable_fastObjectShallowCompare } from "./fastObjectShallowCompare/index.mjs";
 export { default as unstable_isObjectEmpty } from "./isObjectEmpty/index.mjs";
 export { default as unstable_isMuiElement } from "./isMuiElement/index.mjs";
 export { default as unstable_ownerDocument } from "./ownerDocument/index.mjs";
@@ -57,5 +58,4 @@ export { default as unstable_resolveComponentProps } from "./resolveComponentPro
 export { default as unstable_extractEventHandlers } from "./extractEventHandlers/index.mjs";
 export { default as unstable_getReactNodeRef } from "./getReactNodeRef/index.mjs";
 export { default as unstable_getReactElementRef } from "./getReactElementRef/index.mjs";
-export { default as unstable_useRovingTabIndex } from "./useRovingTabIndex/index.mjs";
 export * from "./types/index.mjs";

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@mui/utils",
-  "version": "9.0.0-beta.0",
+  "version": "9.0.0",
   "author": "MUI Team",
   "description": "Utility functions for React components.",
+  "license": "MIT",
   "keywords": [
     "react",
     "react-component",
@@ -14,7 +15,6 @@
     "url": "git+https://github.com/mui/material-ui.git",
     "directory": "packages/mui-utils"
   },
-  "license": "MIT",
   "bugs": {
     "url": "https://github.com/mui/material-ui/issues"
   },
@@ -29,7 +29,7 @@
     "clsx": "^2.1.1",
     "prop-types": "^15.8.1",
     "react-is": "^19.2.4",
-    "@mui/types": "^9.0.0-beta.0"
+    "@mui/types": "^9.0.0"
   },
   "peerDependencies": {
     "@types/react": "^17.0.0 || ^18.0.0 || ^19.0.0",
@@ -288,6 +288,20 @@
         "default": "./fastDeepAssign/index.mjs"
       }
     },
+    "./fastObjectShallowCompare": {
+      "import": {
+        "types": "./fastObjectShallowCompare/index.d.mts",
+        "default": "./fastObjectShallowCompare/index.mjs"
+      },
+      "require": {
+        "types": "./fastObjectShallowCompare/index.d.ts",
+        "default": "./fastObjectShallowCompare/index.js"
+      },
+      "default": {
+        "types": "./fastObjectShallowCompare/index.d.mts",
+        "default": "./fastObjectShallowCompare/index.mjs"
+      }
+    },
     "./formatMuiErrorMessage": {
       "import": {
         "types": "./formatMuiErrorMessage/index.d.mts",

package/useRovingTabIndex/RovingTabIndexContext.d.mts

@@ -0,0 +1,6 @@
+import * as React from 'react';
+import type { UseRovingTabIndexReturnValue } from "./useRovingTabIndex.mjs";
+type RovingTabIndexContextValue = UseRovingTabIndexReturnValue<unknown>;
+export declare const RovingTabIndexContext: React.Context<RovingTabIndexContextValue | undefined>;
+export declare function useRovingTabIndexContext(): RovingTabIndexContextValue;
+export {};

package/useRovingTabIndex/RovingTabIndexContext.d.ts

@@ -0,0 +1,6 @@
+import * as React from 'react';
+import type { UseRovingTabIndexReturnValue } from "./useRovingTabIndex.js";
+type RovingTabIndexContextValue = UseRovingTabIndexReturnValue<unknown>;
+export declare const RovingTabIndexContext: React.Context<RovingTabIndexContextValue | undefined>;
+export declare function useRovingTabIndexContext(): RovingTabIndexContextValue;
+export {};

package/useRovingTabIndex/RovingTabIndexContext.js

@@ -0,0 +1,21 @@
+"use strict";
+'use client';
+
+var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.RovingTabIndexContext = void 0;
+exports.useRovingTabIndexContext = useRovingTabIndexContext;
+var React = _interopRequireWildcard(require("react"));
+const RovingTabIndexContext = exports.RovingTabIndexContext = /*#__PURE__*/React.createContext(undefined);
+if (process.env.NODE_ENV !== 'production') {
+  RovingTabIndexContext.displayName = 'RovingTabIndexContext';
+}
+function useRovingTabIndexContext() {
+  const context = React.useContext(RovingTabIndexContext);
+  if (context === undefined) {
+    throw new Error('MUI: RovingTabIndexContext is missing. Roving tab index items must be placed within a roving tab index provider.');
+  }
+  return context;
+}

package/useRovingTabIndex/RovingTabIndexContext.mjs

@@ -0,0 +1,14 @@
+'use client';
+
+import * as React from 'react';
+export const RovingTabIndexContext = /*#__PURE__*/React.createContext(undefined);
+if (process.env.NODE_ENV !== 'production') {
+  RovingTabIndexContext.displayName = 'RovingTabIndexContext';
+}
+export function useRovingTabIndexContext() {
+  const context = React.useContext(RovingTabIndexContext);
+  if (context === undefined) {
+    throw new Error('MUI: RovingTabIndexContext is missing. Roving tab index items must be placed within a roving tab index provider.');
+  }
+  return context;
+}

package/useRovingTabIndex/index.d.mts

@@ -1 +1,2 @@
-export { default } from "./useRovingTabIndex.mjs";
+export * from "./RovingTabIndexContext.mjs";
+export * from "./useRovingTabIndex.mjs";

package/useRovingTabIndex/index.d.ts

@@ -1 +1,2 @@
-export { default } from "./useRovingTabIndex.js";
+export * from "./RovingTabIndexContext.js";
+export * from "./useRovingTabIndex.js";

package/useRovingTabIndex/index.js

@@ -1,13 +1,27 @@
 "use strict";
 
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-Object.defineProperty(exports, "default", {
-  enumerable: true,
-  get: function () {
-    return _useRovingTabIndex.default;
-  }
+var _RovingTabIndexContext = require("./RovingTabIndexContext");
+Object.keys(_RovingTabIndexContext).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _RovingTabIndexContext[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _RovingTabIndexContext[key];
+    }
+  });
 });
-var _useRovingTabIndex = _interopRequireDefault(require("./useRovingTabIndex"));
+var _useRovingTabIndex = require("./useRovingTabIndex");
+Object.keys(_useRovingTabIndex).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _useRovingTabIndex[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _useRovingTabIndex[key];
+    }
+  });
+});

package/useRovingTabIndex/index.mjs

@@ -1 +1,2 @@
-export { default } from "./useRovingTabIndex.mjs";
+export * from "./RovingTabIndexContext.mjs";
+export * from "./useRovingTabIndex.mjs";