@mui/utils 7.3.10 → 7.3.11

package/CHANGELOG.md

@@ -1,5 +1,40 @@
 # [Versions](https://mui.com/versions/)
 
+## 7.3.11
+
+<!-- generated comparing v7.3.10..v7.x -->
+
+_May 6, 2026_
+
+A big thanks to the 5 contributors who made this release possible.
+
+### `@mui/material@7.3.11`
+
+- [autocomplete] Fix highlight sync and scroll preservation (#48350) @mj12albert
+- [autocomplete] Fix popper rendering issues (#48343) @mj12albert
+- [autocomplete] Improve highlight tracking and selection state (#48318) @mj12albert
+- [button] Fix `startIcon` alignment (#48339) @mj12albert
+- [button] Remove duplicated className entries (#48284) @silviuaavram
+- [checkbox] Set `aria-checked=mixed` when indeterminate (#48286) @mj12albert
+- [dialog][drawer][focus trap] Fix initial focus target (#48324) @mj12albert
+- [drawer] Fix transition jump (#48340) @mj12albert
+- [input] Fix layout shift with display: flex (#48359) @oliviertassinari
+- [inputs] Fix autofocus in SSR environment (#48307) @mj12albert
+- [popper] Persist positioning styles when popperOptions changes reference (#48302) @mj12albert
+- [switch] Fix incorrect `role` with `slotProps.input` (#48472) @mj12albert
+- [utils] Add shadow dom utils (#48309) @mj12albert
+
+### Docs
+
+- [docs] Update banner to announce v9 (#48299) @siriwatknp
+- [docs] Add v9 in the versions select in v7.mui.com (#48233) @alexfauquette
+
+### Core
+
+- [internal] Update some host-reference entries (#48225) @silviuaavram
+
+All contributors of this release in alphabetical order: @alexfauquette, @mj12albert, @oliviertassinari, @silviuaavram, @siriwatknp
+
 ## 7.3.10
 
 <!-- generated comparing v7.3.9..v7.x -->

package/contains/contains.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Copied from @base-ui/utils
+ *
+ * Shadow DOM-aware containment check.
+ *
+ * Native `parent.contains(child)` returns `false` when the child is inside a
+ * shadow root that is a descendant of the parent. This function handles that
+ * case by traversing up through shadow root hosts.
+ *
+ * @param parent - The potential ancestor element.
+ * @param child - The potential descendant element.
+ * @returns Whether `parent` contains `child`, even across shadow root boundaries.
+ */
+export default function contains(parent: Element | null | undefined, child: Element | null | undefined): boolean;

package/contains/contains.js

@@ -0,0 +1,42 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = contains;
+/**
+ * Copied from @base-ui/utils
+ *
+ * Shadow DOM-aware containment check.
+ *
+ * Native `parent.contains(child)` returns `false` when the child is inside a
+ * shadow root that is a descendant of the parent. This function handles that
+ * case by traversing up through shadow root hosts.
+ *
+ * @param parent - The potential ancestor element.
+ * @param child - The potential descendant element.
+ * @returns Whether `parent` contains `child`, even across shadow root boundaries.
+ */
+function contains(parent, child) {
+  if (!parent || !child) {
+    return false;
+  }
+
+  // First, attempt with the faster native method.
+  if (parent.contains(child)) {
+    return true;
+  }
+
+  // Then fall back to traversing out of shadow roots when needed.
+  const rootNode = child.getRootNode?.();
+  if (rootNode && rootNode instanceof ShadowRoot) {
+    let next = child;
+    while (next) {
+      if (parent === next) {
+        return true;
+      }
+      next = next.parentNode ?? next.host ?? null;
+    }
+  }
+  return false;
+}

package/contains/index.d.ts

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

package/contains/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 _contains.default;
+  }
+});
+var _contains = _interopRequireDefault(require("./contains"));

package/elementTypeAcceptingRef/elementTypeAcceptingRef.js

@@ -44,8 +44,10 @@ function elementTypeAcceptingRef(props, propName, componentName, location, propF
   if (propValue === React.Fragment) {
     warningHint = 'Did you accidentally provide a React.Fragment instead?';
   }
+
+  // #host-reference
   if (warningHint !== undefined) {
-    return new Error(`Invalid ${location} \`${safePropName}\` supplied to \`${componentName}\`. ` + `Expected an element type that can hold a ref. ${warningHint} ` + 'For more information see https://mui.com/r/caveat-with-refs-guide');
+    return new Error(`Invalid ${location} \`${safePropName}\` supplied to \`${componentName}\`. ` + `Expected an element type that can hold a ref. ${warningHint} ` + 'For more information see https://v7.mui.com/r/caveat-with-refs-guide');
   }
   return null;
 }

package/esm/contains/contains.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Copied from @base-ui/utils
+ *
+ * Shadow DOM-aware containment check.
+ *
+ * Native `parent.contains(child)` returns `false` when the child is inside a
+ * shadow root that is a descendant of the parent. This function handles that
+ * case by traversing up through shadow root hosts.
+ *
+ * @param parent - The potential ancestor element.
+ * @param child - The potential descendant element.
+ * @returns Whether `parent` contains `child`, even across shadow root boundaries.
+ */
+export default function contains(parent: Element | null | undefined, child: Element | null | undefined): boolean;

package/esm/contains/contains.js

@@ -0,0 +1,36 @@
+/**
+ * Copied from @base-ui/utils
+ *
+ * Shadow DOM-aware containment check.
+ *
+ * Native `parent.contains(child)` returns `false` when the child is inside a
+ * shadow root that is a descendant of the parent. This function handles that
+ * case by traversing up through shadow root hosts.
+ *
+ * @param parent - The potential ancestor element.
+ * @param child - The potential descendant element.
+ * @returns Whether `parent` contains `child`, even across shadow root boundaries.
+ */
+export default function contains(parent, child) {
+  if (!parent || !child) {
+    return false;
+  }
+
+  // First, attempt with the faster native method.
+  if (parent.contains(child)) {
+    return true;
+  }
+
+  // Then fall back to traversing out of shadow roots when needed.
+  const rootNode = child.getRootNode?.();
+  if (rootNode && rootNode instanceof ShadowRoot) {
+    let next = child;
+    while (next) {
+      if (parent === next) {
+        return true;
+      }
+      next = next.parentNode ?? next.host ?? null;
+    }
+  }
+  return false;
+}

package/esm/contains/index.d.ts

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

package/esm/contains/index.js

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

package/esm/elementTypeAcceptingRef/elementTypeAcceptingRef.js

@@ -36,8 +36,10 @@ function elementTypeAcceptingRef(props, propName, componentName, location, propF
   if (propValue === React.Fragment) {
     warningHint = 'Did you accidentally provide a React.Fragment instead?';
   }
+
+  // #host-reference
   if (warningHint !== undefined) {
-    return new Error(`Invalid ${location} \`${safePropName}\` supplied to \`${componentName}\`. ` + `Expected an element type that can hold a ref. ${warningHint} ` + 'For more information see https://mui.com/r/caveat-with-refs-guide');
+    return new Error(`Invalid ${location} \`${safePropName}\` supplied to \`${componentName}\`. ` + `Expected an element type that can hold a ref. ${warningHint} ` + 'For more information see https://v7.mui.com/r/caveat-with-refs-guide');
   }
   return null;
 }

package/esm/getEventTarget/getEventTarget.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Copied from @base-ui/utils
+ *
+ * Gets the actual target of an event, using `composedPath()` to traverse
+ * shadow DOM boundaries.
+ *
+ * In shadow DOM, `event.target` may return the shadow host rather than the
+ * actual element that triggered the event. `composedPath()[0]` returns the
+ * true originating element.
+ *
+ * @param event - The event to get the target from.
+ * @returns The actual event target, or `null` if not available.
+ */
+export default function getEventTarget(event: Event): EventTarget | null;

package/esm/getEventTarget/getEventTarget.js

@@ -0,0 +1,16 @@
+/**
+ * Copied from @base-ui/utils
+ *
+ * Gets the actual target of an event, using `composedPath()` to traverse
+ * shadow DOM boundaries.
+ *
+ * In shadow DOM, `event.target` may return the shadow host rather than the
+ * actual element that triggered the event. `composedPath()[0]` returns the
+ * true originating element.
+ *
+ * @param event - The event to get the target from.
+ * @returns The actual event target, or `null` if not available.
+ */
+export default function getEventTarget(event) {
+  return event.composedPath?.()[0] ?? event.target;
+}

package/esm/getEventTarget/index.d.ts

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

package/esm/getEventTarget/index.js

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

package/esm/index.d.ts

@@ -5,7 +5,9 @@ export { default as elementAcceptingRef } from "./elementAcceptingRef/index.js";
 export { default as elementTypeAcceptingRef } from "./elementTypeAcceptingRef/index.js";
 export { default as exactProp } from "./exactProp/index.js";
 export { default as formatMuiErrorMessage } from "./formatMuiErrorMessage/index.js";
+export { default as unstable_contains } from "./contains/index.js";
 export { default as unstable_getActiveElement } from "./getActiveElement/index.js";
+export { default as unstable_getEventTarget } from "./getEventTarget/index.js";
 export { default as getDisplayName } from "./getDisplayName/index.js";
 export { default as HTMLElementType } from "./HTMLElementType/index.js";
 export { default as ponyfillGlobal } from "./ponyfillGlobal/index.js";
@@ -29,6 +31,7 @@ export { default as unstable_useLazyRef } from "./useLazyRef/index.js";
 export { default as unstable_useTimeout, Timeout as unstable_Timeout } from "./useTimeout/index.js";
 export { default as unstable_useOnMount } from "./useOnMount/index.js";
 export { default as unstable_useIsFocusVisible } from "./useIsFocusVisible/index.js";
+export { default as unstable_useForcedRerendering } from "./useForcedRerendering/index.js";
 export { default as unstable_isFocusVisible } from "./isFocusVisible/index.js";
 export { default as unstable_getScrollbarSize } from "./getScrollbarSize/index.js";
 export { default as usePreviousProps } from "./usePreviousProps/index.js";

package/esm/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/utils v7.3.10
+ * @mui/utils v7.3.11
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the
@@ -12,7 +12,9 @@ export { default as elementAcceptingRef } from "./elementAcceptingRef/index.js";
 export { default as elementTypeAcceptingRef } from "./elementTypeAcceptingRef/index.js";
 export { default as exactProp } from "./exactProp/index.js";
 export { default as formatMuiErrorMessage } from "./formatMuiErrorMessage/index.js";
+export { default as unstable_contains } from "./contains/index.js";
 export { default as unstable_getActiveElement } from "./getActiveElement/index.js";
+export { default as unstable_getEventTarget } from "./getEventTarget/index.js";
 export { default as getDisplayName } from "./getDisplayName/index.js";
 export { default as HTMLElementType } from "./HTMLElementType/index.js";
 export { default as ponyfillGlobal } from "./ponyfillGlobal/index.js";
@@ -36,6 +38,7 @@ export { default as unstable_useLazyRef } from "./useLazyRef/index.js";
 export { default as unstable_useTimeout, Timeout as unstable_Timeout } from "./useTimeout/index.js";
 export { default as unstable_useOnMount } from "./useOnMount/index.js";
 export { default as unstable_useIsFocusVisible } from "./useIsFocusVisible/index.js";
+export { default as unstable_useForcedRerendering } from "./useForcedRerendering/index.js";
 export { default as unstable_isFocusVisible } from "./isFocusVisible/index.js";
 export { default as unstable_getScrollbarSize } from "./getScrollbarSize/index.js";
 export { default as usePreviousProps } from "./usePreviousProps/index.js";

package/esm/useForcedRerendering/index.d.ts

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

package/esm/useForcedRerendering/index.js

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

package/esm/useForcedRerendering/useForcedRerendering.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Copied from @base-ui/utils
+ *
+ * Returns a function that forces a rerender.
+ */
+export default function useForcedRerendering(): () => void;

package/esm/useForcedRerendering/useForcedRerendering.js

@@ -0,0 +1,15 @@
+'use client';
+
+import * as React from 'react';
+
+/**
+ * Copied from @base-ui/utils
+ *
+ * Returns a function that forces a rerender.
+ */
+export default function useForcedRerendering() {
+  const [, setState] = React.useState({});
+  return React.useCallback(() => {
+    setState({});
+  }, []);
+}

package/getEventTarget/getEventTarget.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Copied from @base-ui/utils
+ *
+ * Gets the actual target of an event, using `composedPath()` to traverse
+ * shadow DOM boundaries.
+ *
+ * In shadow DOM, `event.target` may return the shadow host rather than the
+ * actual element that triggered the event. `composedPath()[0]` returns the
+ * true originating element.
+ *
+ * @param event - The event to get the target from.
+ * @returns The actual event target, or `null` if not available.
+ */
+export default function getEventTarget(event: Event): EventTarget | null;

package/getEventTarget/getEventTarget.js

@@ -0,0 +1,22 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = getEventTarget;
+/**
+ * Copied from @base-ui/utils
+ *
+ * Gets the actual target of an event, using `composedPath()` to traverse
+ * shadow DOM boundaries.
+ *
+ * In shadow DOM, `event.target` may return the shadow host rather than the
+ * actual element that triggered the event. `composedPath()[0]` returns the
+ * true originating element.
+ *
+ * @param event - The event to get the target from.
+ * @returns The actual event target, or `null` if not available.
+ */
+function getEventTarget(event) {
+  return event.composedPath?.()[0] ?? event.target;
+}

package/getEventTarget/index.d.ts

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

package/getEventTarget/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 _getEventTarget.default;
+  }
+});
+var _getEventTarget = _interopRequireDefault(require("./getEventTarget"));

package/index.d.ts

@@ -5,7 +5,9 @@ export { default as elementAcceptingRef } from "./elementAcceptingRef/index.js";
 export { default as elementTypeAcceptingRef } from "./elementTypeAcceptingRef/index.js";
 export { default as exactProp } from "./exactProp/index.js";
 export { default as formatMuiErrorMessage } from "./formatMuiErrorMessage/index.js";
+export { default as unstable_contains } from "./contains/index.js";
 export { default as unstable_getActiveElement } from "./getActiveElement/index.js";
+export { default as unstable_getEventTarget } from "./getEventTarget/index.js";
 export { default as getDisplayName } from "./getDisplayName/index.js";
 export { default as HTMLElementType } from "./HTMLElementType/index.js";
 export { default as ponyfillGlobal } from "./ponyfillGlobal/index.js";
@@ -29,6 +31,7 @@ export { default as unstable_useLazyRef } from "./useLazyRef/index.js";
 export { default as unstable_useTimeout, Timeout as unstable_Timeout } from "./useTimeout/index.js";
 export { default as unstable_useOnMount } from "./useOnMount/index.js";
 export { default as unstable_useIsFocusVisible } from "./useIsFocusVisible/index.js";
+export { default as unstable_useForcedRerendering } from "./useForcedRerendering/index.js";
 export { default as unstable_isFocusVisible } from "./isFocusVisible/index.js";
 export { default as unstable_getScrollbarSize } from "./getScrollbarSize/index.js";
 export { default as usePreviousProps } from "./usePreviousProps/index.js";

package/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/utils v7.3.10
+ * @mui/utils v7.3.11
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the
@@ -20,7 +20,9 @@ var _exportNames = {
   elementTypeAcceptingRef: true,
   exactProp: true,
   formatMuiErrorMessage: true,
+  unstable_contains: true,
   unstable_getActiveElement: true,
+  unstable_getEventTarget: true,
   getDisplayName: true,
   HTMLElementType: true,
   ponyfillGlobal: true,
@@ -45,6 +47,7 @@ var _exportNames = {
   unstable_Timeout: true,
   unstable_useOnMount: true,
   unstable_useIsFocusVisible: true,
+  unstable_useForcedRerendering: true,
   unstable_isFocusVisible: true,
   unstable_getScrollbarSize: true,
   usePreviousProps: true,
@@ -178,6 +181,12 @@ Object.defineProperty(exports, "unstable_composeClasses", {
     return _composeClasses.default;
   }
 });
+Object.defineProperty(exports, "unstable_contains", {
+  enumerable: true,
+  get: function () {
+    return _contains.default;
+  }
+});
 Object.defineProperty(exports, "unstable_createChainedFunction", {
   enumerable: true,
   get: function () {
@@ -220,6 +229,12 @@ Object.defineProperty(exports, "unstable_getActiveElement", {
     return _getActiveElement.default;
   }
 });
+Object.defineProperty(exports, "unstable_getEventTarget", {
+  enumerable: true,
+  get: function () {
+    return _getEventTarget.default;
+  }
+});
 Object.defineProperty(exports, "unstable_getReactElementRef", {
   enumerable: true,
   get: function () {
@@ -310,6 +325,12 @@ Object.defineProperty(exports, "unstable_useEventCallback", {
     return _useEventCallback.default;
   }
 });
+Object.defineProperty(exports, "unstable_useForcedRerendering", {
+  enumerable: true,
+  get: function () {
+    return _useForcedRerendering.default;
+  }
+});
 Object.defineProperty(exports, "unstable_useForkRef", {
   enumerable: true,
   get: function () {
@@ -370,7 +391,9 @@ var _elementAcceptingRef = _interopRequireDefault(require("./elementAcceptingRef
 var _elementTypeAcceptingRef = _interopRequireDefault(require("./elementTypeAcceptingRef"));
 var _exactProp = _interopRequireDefault(require("./exactProp"));
 var _formatMuiErrorMessage = _interopRequireDefault(require("./formatMuiErrorMessage"));
+var _contains = _interopRequireDefault(require("./contains"));
 var _getActiveElement = _interopRequireDefault(require("./getActiveElement"));
+var _getEventTarget = _interopRequireDefault(require("./getEventTarget"));
 var _getDisplayName = _interopRequireDefault(require("./getDisplayName"));
 var _HTMLElementType = _interopRequireDefault(require("./HTMLElementType"));
 var _ponyfillGlobal = _interopRequireDefault(require("./ponyfillGlobal"));
@@ -394,6 +417,7 @@ var _useLazyRef = _interopRequireDefault(require("./useLazyRef"));
 var _useTimeout = _interopRequireWildcard(require("./useTimeout"));
 var _useOnMount = _interopRequireDefault(require("./useOnMount"));
 var _useIsFocusVisible = _interopRequireDefault(require("./useIsFocusVisible"));
+var _useForcedRerendering = _interopRequireDefault(require("./useForcedRerendering"));
 var _isFocusVisible = _interopRequireDefault(require("./isFocusVisible"));
 var _getScrollbarSize = _interopRequireDefault(require("./getScrollbarSize"));
 var _usePreviousProps = _interopRequireDefault(require("./usePreviousProps"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/utils",
-  "version": "7.3.10",
+  "version": "7.3.11",
   "author": "MUI Team",
   "description": "Utility functions for React components.",
   "keywords": [

package/useForcedRerendering/index.d.ts

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

package/useForcedRerendering/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 _useForcedRerendering.default;
+  }
+});
+var _useForcedRerendering = _interopRequireDefault(require("./useForcedRerendering"));

package/useForcedRerendering/useForcedRerendering.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Copied from @base-ui/utils
+ *
+ * Returns a function that forces a rerender.
+ */
+export default function useForcedRerendering(): () => void;

package/useForcedRerendering/useForcedRerendering.js

@@ -0,0 +1,20 @@
+"use strict";
+'use client';
+
+var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = useForcedRerendering;
+var React = _interopRequireWildcard(require("react"));
+/**
+ * Copied from @base-ui/utils
+ *
+ * Returns a function that forces a rerender.
+ */
+function useForcedRerendering() {
+  const [, setState] = React.useState({});
+  return React.useCallback(() => {
+    setState({});
+  }, []);
+}