@mui/utils 6.4.6 → 6.4.9

package/CHANGELOG.md

@@ -1,5 +1,122 @@
 # [Versions](https://mui.com/versions/)
 
+## 6.4.10
+
+<!-- generated comparing v6.4.9..v6.x -->
+
+_Mar 31, 2025_
+
+A big thanks to the 4 contributors who made this release possible.
+
+### `@mui/material@6.4.10`
+
+- [Autocomplete] Prevent shrink animation in controlled Autocomplete when initial `value` is provided (#45735) @imadx
+- [Popover] Allow `null` in `anchorEl` function return type (#45723) @eduter
+
+### Docs
+
+- Fix new React project link, CRA deprecated (#45669) @oliviertassinari
+
+### Core
+
+- [utils] Support cleanup callbacks in useForkRef (#45733) @DiegoAndai
+
+All contributors of this release in alphabetical order: @DiegoAndai, @eduter, @imadx, @oliviertassinari
+
+## 6.4.9
+
+<!-- generated comparing v6.4.8..v6.x -->
+
+_Mar 25, 2025_
+
+A big thanks to the 7 contributors who made this release possible.
+
+### `@mui/material@6.4.9`
+
+- [Autocomplete] Fix when `onHighlightChange` is called (@ZeeshanTamboli) (#45635) @ZeeshanTamboli
+- [StepLabel] Add missing root slot (#45607) @sai6855
+- [Switch] Add slots and slotProps (#45628) @siriwatknp
+- [TextField] Add `root` slot (#45616) @sai6855
+- [Tabs] Fix modifier keys + Left/Right Arrow key from being consumed by tab navigation (#45620) @mushfiqbh
+
+### `@mui/codemon@6.4.9`
+
+- Add missing deprecations in deprecations-all file (#45508) @sai6855
+
+### Docs
+
+- [docs] Fix grammatical errors in support.md (#45636) @letianpailove
+- [docs] Restore utility component docs from MUI Base to Material UI (#45240) @mapache-salvaje
+
+### Core
+
+- [core] Prepare v6 branch for v7 stable release (#45668) @DiegoAndai
+
+All contributors of this release in alphabetical order: @DiegoAndai, @letianpailove, @mapache-salvaje, @mushfiqbh, @sai6855, @siriwatknp, @ZeeshanTamboli
+
+## 6.4.8
+
+<!-- generated comparing v6.4.7..v6.x -->
+
+_Mar 14, 2025_
+
+A big thanks to the 9 contributors who made this release possible.
+
+### `@mui/material@6.4.8`
+
+- [ListItemText] Add missing `root` slot (#45552) @sai6855
+- [SpeedDial] Add missing `root` slot (#45551) @sai6855
+- [Tooltip] Allow auto placement on tooltip (#45536) @Jtaks
+- [useScrollTrigger] Do nothing if target is null (#45553) @vipierozan99
+- [Accordion] Add missing `root` slot (#45534) @sai6855
+- [AccordionSummary] Add slots and slotProps (#45560) @sai6855
+- [TextareaAutosize] Fix ResizeObserver causing infinite `selectionchange` loop (#45351) (#45498) @mj12albert
+
+### `@mui/styled-engine@6.4.8`
+
+- Add `enableCssLayer` prop to StyledEngineProvider (#45563) @siriwatknp
+
+### `@mui/system@6.4.8`
+
+- [system] Prevent nested non-vars theme inheritance (#45564) @siriwatknp
+
+### `@mui/utils@6.4.8`
+
+- Use correct iri-reference homepage format (#45511) @dahiro
+
+### Core
+
+- [test] Fix React 18 tests (#45161) (#45496) @DiegoAndai
+
+### Docs
+
+- [Backdrop] Fix component name in migration guide (#45507) @sai6855
+- Fix broken links to MUI X docs (cherry-pick of #45145) (#45481) @mapache-salvaje
+- [examples] Fix the invalid argument to extract examples (#45493) @ovtn
+- Add `overriding-component-structure` doc to Material UI (#45570) @siriwatknp
+
+All contributors of this release in alphabetical order: @dahiro, @DiegoAndai, @Jtaks, @mapache-salvaje, @mj12albert, @ovtn, @sai6855, @siriwatknp, @vipierozan99
+
+## 6.4.7
+
+<!-- generated comparing v6.4.6..v6.x -->
+
+_Mar 5, 2025_
+
+A big thanks to the 3 contributors who made this release possible.
+
+### `@mui/material@6.4.7`
+
+- [ThemeProvider] Add `storageManager` prop to `ThemeProvider` (@siriwatknp) (#45437) @siriwatknp
+- [Rating] Deprecate \*Props and complete slots, slotProps (#45295) (#45398) @DiegoAndai
+- [Radio] Fix `inputProps` not forwarded (@siriwatknp) (#45475) @siriwatknp
+
+### Core
+
+- [blog] React 19 migration for MUI X (#45440) @arminmeh
+
+All contributors of this release in alphabetical order: @arminmeh, @DiegoAndai, @siriwatknp
+
 ## 6.4.6
 
 <!-- generated comparing v6.4.5..v6.x -->
@@ -11,21 +128,21 @@ A big thanks to the 4 contributors who made this release possible.
 ### `@mui/material@6.4.6`
 
 - [Checkbox] Add slots and slotProps (#45361) @siriwatknp
-- [Drawer] Deprecate *Props and complete `slots`, `slotProps` (#45377) @siriwatknp
+- [Drawer] Deprecate \*Props and complete `slots`, `slotProps` (#45377) @siriwatknp
 - [Grid] Improve Grid2 upgrade experience (#45372) @DiegoAndai
 - [InputBase] Deprecate composed classes (#45366) @siriwatknp
 - Fix `slotProps.transition` types (#45367) @siriwatknp
 - Allow nested theme creation with `vars` (#45368) @siriwatknp
 - Fix wrong slotProps of DetailsHTMLAttributes types (#45356) @siriwatknp
-- [Popover] Deprecate *Props and complete `slots`, `slotProps` (#45337) @siriwatknp
+- [Popover] Deprecate \*Props and complete `slots`, `slotProps` (#45337) @siriwatknp
 - [Radio] Add slots and slotProps (#45364) @siriwatknp
 - [Slider] Fix css class selector in migration guide (#45409) @sai6855
 - [Slider] Fix spacings in .md files (#45393) @sai6855
 - [Snackbar] Add Slots and SlotProps (#45103) (#45352) @siriwatknp
 - [SpeedDialAction] Add slots and slotProps (#45365) @siriwatknp
 - [SwitchBase] Deprecate `inputProps` and complete slots, slotProps (#45338) @siriwatknp
-- [Tabs] Deprecate *Props and complete slots, slotProps (#45012) (#45355) @siriwatknp
-- [Menu] Deprecate *Props and complete `slots`, `slotProps`  (#45369) @siriwatknp
+- [Tabs] Deprecate \*Props and complete slots, slotProps (#45012) (#45355) @siriwatknp
+- [Menu] Deprecate \*Props and complete `slots`, `slotProps` (#45369) @siriwatknp
 
 ### Docs
 

package/esm/useForkRef/useForkRef.js

@@ -1,11 +1,9 @@
 'use client';
 
 import * as React from 'react';
-import setRef from "../setRef/index.js";
 
 /**
- * Takes an array of refs and returns a new ref which will apply any modification to all of the refs.
- * This is useful when you want to have the ref used in multiple places.
+ * Merges refs into a single memoized callback ref or `null`.
  *
  * ```tsx
  * const rootRef = React.useRef<Instance>(null);
@@ -20,19 +18,41 @@ import setRef from "../setRef/index.js";
  * @returns {React.RefCallback<Instance> | null} The new ref callback.
  */
 export default function useForkRef(...refs) {
-  /**
-   * This will create a new function if the refs passed to this hook change and are all defined.
-   * This means react will call the old forkRef with `null` and the new forkRef
-   * with the ref. Cleanup naturally emerges from this behavior.
-   */
+  const cleanupRef = React.useRef(undefined);
+  const refEffect = React.useCallback(instance => {
+    const cleanups = refs.map(ref => {
+      if (ref == null) {
+        return null;
+      }
+      if (typeof ref === 'function') {
+        const refCallback = ref;
+        const refCleanup = refCallback(instance);
+        return typeof refCleanup === 'function' ? refCleanup : () => {
+          refCallback(null);
+        };
+      }
+      ref.current = instance;
+      return () => {
+        ref.current = null;
+      };
+    });
+    return () => {
+      cleanups.forEach(refCleanup => refCleanup?.());
+    };
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, refs);
   return React.useMemo(() => {
     if (refs.every(ref => ref == null)) {
       return null;
     }
-    return instance => {
-      refs.forEach(ref => {
-        setRef(ref, instance);
-      });
+    return value => {
+      if (cleanupRef.current) {
+        cleanupRef.current();
+        cleanupRef.current = undefined;
+      }
+      if (value != null) {
+        cleanupRef.current = refEffect(value);
+      }
     };
     // TODO: uncomment once we enable eslint-plugin-react-compiler // eslint-disable-next-line react-compiler/react-compiler -- intentionally ignoring that the dependency array must be an array literal
     // eslint-disable-next-line react-hooks/exhaustive-deps

package/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/utils v6.4.6
+ * @mui/utils v6.4.9
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the

package/modern/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/utils v6.4.6
+ * @mui/utils v6.4.9
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the

package/modern/useForkRef/useForkRef.js

@@ -1,11 +1,9 @@
 'use client';
 
 import * as React from 'react';
-import setRef from "../setRef/index.js";
 
 /**
- * Takes an array of refs and returns a new ref which will apply any modification to all of the refs.
- * This is useful when you want to have the ref used in multiple places.
+ * Merges refs into a single memoized callback ref or `null`.
  *
  * ```tsx
  * const rootRef = React.useRef<Instance>(null);
@@ -20,19 +18,41 @@ import setRef from "../setRef/index.js";
  * @returns {React.RefCallback<Instance> | null} The new ref callback.
  */
 export default function useForkRef(...refs) {
-  /**
-   * This will create a new function if the refs passed to this hook change and are all defined.
-   * This means react will call the old forkRef with `null` and the new forkRef
-   * with the ref. Cleanup naturally emerges from this behavior.
-   */
+  const cleanupRef = React.useRef(undefined);
+  const refEffect = React.useCallback(instance => {
+    const cleanups = refs.map(ref => {
+      if (ref == null) {
+        return null;
+      }
+      if (typeof ref === 'function') {
+        const refCallback = ref;
+        const refCleanup = refCallback(instance);
+        return typeof refCleanup === 'function' ? refCleanup : () => {
+          refCallback(null);
+        };
+      }
+      ref.current = instance;
+      return () => {
+        ref.current = null;
+      };
+    });
+    return () => {
+      cleanups.forEach(refCleanup => refCleanup?.());
+    };
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, refs);
   return React.useMemo(() => {
     if (refs.every(ref => ref == null)) {
       return null;
     }
-    return instance => {
-      refs.forEach(ref => {
-        setRef(ref, instance);
-      });
+    return value => {
+      if (cleanupRef.current) {
+        cleanupRef.current();
+        cleanupRef.current = undefined;
+      }
+      if (value != null) {
+        cleanupRef.current = refEffect(value);
+      }
     };
     // TODO: uncomment once we enable eslint-plugin-react-compiler // eslint-disable-next-line react-compiler/react-compiler -- intentionally ignoring that the dependency array must be an array literal
     // eslint-disable-next-line react-hooks/exhaustive-deps

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/utils",
-  "version": "6.4.6",
+  "version": "6.4.9",
   "private": false,
   "author": "MUI Team",
   "description": "Utility functions for React components.",
@@ -20,7 +20,7 @@
   "bugs": {
     "url": "https://github.com/mui/material-ui/issues"
   },
-  "homepage": "private package",
+  "homepage": "https://github.com/mui/material-ui/tree/master/packages/mui-utils",
   "funding": {
     "type": "opencollective",
     "url": "https://opencollective.com/mui-org"
@@ -31,7 +31,7 @@
     "clsx": "^2.1.1",
     "prop-types": "^15.8.1",
     "react-is": "^19.0.0",
-    "@mui/types": "^7.2.21"
+    "@mui/types": "~7.2.24"
   },
   "peerDependencies": {
     "@types/react": "^17.0.0 || ^18.0.0 || ^19.0.0",

package/useForkRef/useForkRef.d.ts

@@ -1,7 +1,6 @@
 import * as React from 'react';
 /**
- * Takes an array of refs and returns a new ref which will apply any modification to all of the refs.
- * This is useful when you want to have the ref used in multiple places.
+ * Merges refs into a single memoized callback ref or `null`.
  *
  * ```tsx
  * const rootRef = React.useRef<Instance>(null);

package/useForkRef/useForkRef.js

@@ -1,17 +1,14 @@
 "use strict";
 'use client';
 
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
 var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard").default;
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = useForkRef;
 var React = _interopRequireWildcard(require("react"));
-var _setRef = _interopRequireDefault(require("../setRef"));
 /**
- * Takes an array of refs and returns a new ref which will apply any modification to all of the refs.
- * This is useful when you want to have the ref used in multiple places.
+ * Merges refs into a single memoized callback ref or `null`.
  *
  * ```tsx
  * const rootRef = React.useRef<Instance>(null);
@@ -26,19 +23,41 @@ var _setRef = _interopRequireDefault(require("../setRef"));
  * @returns {React.RefCallback<Instance> | null} The new ref callback.
  */
 function useForkRef(...refs) {
-  /**
-   * This will create a new function if the refs passed to this hook change and are all defined.
-   * This means react will call the old forkRef with `null` and the new forkRef
-   * with the ref. Cleanup naturally emerges from this behavior.
-   */
+  const cleanupRef = React.useRef(undefined);
+  const refEffect = React.useCallback(instance => {
+    const cleanups = refs.map(ref => {
+      if (ref == null) {
+        return null;
+      }
+      if (typeof ref === 'function') {
+        const refCallback = ref;
+        const refCleanup = refCallback(instance);
+        return typeof refCleanup === 'function' ? refCleanup : () => {
+          refCallback(null);
+        };
+      }
+      ref.current = instance;
+      return () => {
+        ref.current = null;
+      };
+    });
+    return () => {
+      cleanups.forEach(refCleanup => refCleanup?.());
+    };
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, refs);
   return React.useMemo(() => {
     if (refs.every(ref => ref == null)) {
       return null;
     }
-    return instance => {
-      refs.forEach(ref => {
-        (0, _setRef.default)(ref, instance);
-      });
+    return value => {
+      if (cleanupRef.current) {
+        cleanupRef.current();
+        cleanupRef.current = undefined;
+      }
+      if (value != null) {
+        cleanupRef.current = refEffect(value);
+      }
     };
     // TODO: uncomment once we enable eslint-plugin-react-compiler // eslint-disable-next-line react-compiler/react-compiler -- intentionally ignoring that the dependency array must be an array literal
     // eslint-disable-next-line react-hooks/exhaustive-deps