@mui/utils 6.1.1 → 6.1.2

package/CHANGELOG.md

@@ -1,5 +1,67 @@
 # [Versions](https://mui.com/versions/)
 
+## v6.1.2
+
+<!-- generated comparing v6.1.1..master -->
+
+_Oct 2, 2024_
+
+A big thanks to the 13 contributors who made this release possible.
+
+### `@mui/material@6.1.2`
+
+- [Modal] Remove unnecessary `manager` prop handling (#43867) @ZeeshanTamboli
+- [Autocomplete] Fix listbox opens and closes on click when used with `limitTags` (#42494) @appleSimple
+- [Button] Ignore `dark` and `contrastText` if not provided in the theme (#43861) @siriwatknp
+- [Button] Fix regression for color `inherit` (#43862) @siriwatknp
+- [LinearProgress] Fix background color (#43949) @sai6855
+- Support CSS variables with shadow DOM (#43948) @siriwatknp
+- Improve getReactElementRef() utils (#43022) @sai6855
+- [Modal] Replace `show` parameter name with `hide` in modal manager (#43868) @ZeeshanTamboli
+- [Rating] Use Rating `name` as prefix of input element ids (#43829) @yash49
+- [Drawer] Refactor getScrollbarSize usages (#43828) @BrianWoolfolk
+- [Drawer] Fix issue with main window being used instead of iframe's window (#43818) @albarv340
+- [ThemeProvider] Support setting default mode (#43951) @siriwatknp
+
+### Docs
+
+- Update theme toggle demo (#43956) @Janpot
+- Add note about minimum required webpack version (#43864) @Janpot
+- Format Pigment CSS docs (#43812) @oliviertassinari
+- Fix visual bug on dashboard template (#43836) @oliviertassinari
+- Fix pigment-css.md syntax error (#43837) @kdichev
+- Fix Sign-in template form experience (#43838) @oliviertassinari
+- Remove "To be continued" section from v0 –> v1 migration guide (#43832) @samuelsycamore
+- Fix 301 to chromium (#43809) @oliviertassinari
+- [joy-ui] Add missing ComponentLinkHeader components (#43865) @samuelsycamore
+- [Modal] Remove unnecessary type assertion (#43825) @ZeeshanTamboli
+- [Table] Stabilize random series in virtualized table demo (#43744) @Janpot
+- [system] Add migration guide link to `@mui/styles` pages (#43833) @samuelsycamore
+
+### Core
+
+- [code-infra] Fix flaky dashboard screenshot - take 2 (#43937) @Janpot
+- [code-infra] Replace all instances of `e` with `event` and add eslint rule (#43866) @samuelsycamore
+- [code-infra] Fix and update bundling fixtures (#43709) @Janpot
+- [code-infra] Update transitive dependencies with vulnerabilties (#43895) @Janpot
+- [code-infra] Optimize regression tests (#43889) @Janpot
+- [code-infra] Remove custom playwright installation steps (#43881) @Janpot
+- [code-infra] Fix flaky dashboard screenshot (#43890) @Janpot
+- [code-infra] Add new instanceof proptypes for toolpad (#43814) @Janpot
+- Fix eslint-plugin-react-compiler issues in usePagination tests (#43946) @wilhelmlofsten
+- Uniformity in version range @oliviertassinari
+- Replace `toBeAriaHidden` matcher with `toBeInaccessible` in tests (#43870) @ZeeshanTamboli
+- [docs-infra] Strengthen CSP (#43711) @oliviertassinari
+- [docs-infra] Open Codesandbox demo with fontsize=12 (#43860) @siriwatknp
+- [icons] Reduce Material Icon page size (#43911) @oliviertassinari
+- [test] Point Istanbul to correct URL (#43935) @sai6855
+- [test] Sync React.version parse logic with codebase (#43820) @oliviertassinari
+- [website] Add 'Row spanning' (#43831) @oliviertassinari
+- [website] Improve Next roles section (#43822) @oliviertassinari
+- [website] Open the xCharts, eXplore and X general react engineer roles (#43805) @DanailH
+
+All contributors of this release in alphabetical order: @albarv340, @appleSimple, @BrianWoolfolk, @DanailH, @Janpot, @kdichev, @oliviertassinari, @sai6855, @samuelsycamore, @siriwatknp, @wilhelmlofsten, @yash49, @ZeeshanTamboli
+
 ## v6.1.1
 
 <!-- generated comparing v6.1.0..master -->

package/esm/getReactElementRef/getReactElementRef.js

@@ -0,0 +1,18 @@
+import * as React from 'react';
+
+/**
+ * Returns the ref of a React element handling differences between React 19 and older versions.
+ * It will throw runtime error if the element is not a valid React element.
+ *
+ * @param element React.ReactElement
+ * @returns React.Ref<any> | null | undefined
+ */
+export default function getReactElementRef(element) {
+  // 'ref' is passed as prop in React 19, whereas 'ref' is directly attached to children in older versions
+  if (parseInt(React.version, 10) >= 19) {
+    return element.props?.ref;
+  }
+  // @ts-expect-error element.ref is not included in the ReactElement type
+  // https://github.com/DefinitelyTyped/DefinitelyTyped/discussions/70189
+  return element?.ref;
+}

package/esm/getReactElementRef/index.js

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

package/esm/getScrollbarSize/getScrollbarSize.js

@@ -1,7 +1,7 @@
 // A change of the browser zoom change the scrollbar size.
 // Credit https://github.com/twbs/bootstrap/blob/488fd8afc535ca3a6ad4dc581f5e89217b6a36ac/js/src/util/scrollbar.js#L14-L18
-export default function getScrollbarSize(doc) {
+export default function getScrollbarSize(win = window) {
   // https://developer.mozilla.org/en-US/docs/Web/API/Window/innerWidth#usage_notes
-  const documentWidth = doc.documentElement.clientWidth;
-  return Math.abs(window.innerWidth - documentWidth);
+  const documentWidth = win.document.documentElement.clientWidth;
+  return win.innerWidth - documentWidth;
 }

package/esm/index.js

@@ -44,5 +44,5 @@ export { default as clamp } from "./clamp/index.js";
 export { default as unstable_useSlotProps } from "./useSlotProps/index.js";
 export { default as unstable_resolveComponentProps } from "./resolveComponentProps/index.js";
 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 * from "./types.js";

package/getReactElementRef/getReactElementRef.d.ts

@@ -0,0 +1,9 @@
+import * as React from 'react';
+/**
+ * Returns the ref of a React element handling differences between React 19 and older versions.
+ * It will throw runtime error if the element is not a valid React element.
+ *
+ * @param element React.ReactElement
+ * @returns React.Ref<any> | null | undefined
+ */
+export default function getReactElementRef(element: React.ReactElement): React.Ref<any> | null | undefined;

package/getReactElementRef/getReactElementRef.js

@@ -0,0 +1,24 @@
+"use strict";
+
+var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = getReactElementRef;
+var React = _interopRequireWildcard(require("react"));
+/**
+ * Returns the ref of a React element handling differences between React 19 and older versions.
+ * It will throw runtime error if the element is not a valid React element.
+ *
+ * @param element React.ReactElement
+ * @returns React.Ref<any> | null | undefined
+ */
+function getReactElementRef(element) {
+  // 'ref' is passed as prop in React 19, whereas 'ref' is directly attached to children in older versions
+  if (parseInt(React.version, 10) >= 19) {
+    return element.props?.ref;
+  }
+  // @ts-expect-error element.ref is not included in the ReactElement type
+  // https://github.com/DefinitelyTyped/DefinitelyTyped/discussions/70189
+  return element?.ref;
+}

package/getReactElementRef/index.d.ts

@@ -0,0 +1 @@
+export { default } from './getReactElementRef';

package/{getReactNodeRef → getReactElementRef}/index.js

@@ -7,7 +7,7 @@ Object.defineProperty(exports, "__esModule", {
 Object.defineProperty(exports, "default", {
   enumerable: true,
   get: function () {
-    return _getReactNodeRef.default;
+    return _getReactElementRef.default;
   }
 });
-var _getReactNodeRef = _interopRequireDefault(require("./getReactNodeRef"));
+var _getReactElementRef = _interopRequireDefault(require("./getReactElementRef"));

package/{getReactNodeRef → getReactElementRef}/package.json

@@ -1,6 +1,6 @@
 {
   "sideEffects": false,
-  "module": "../esm/getReactNodeRef/index.js",
+  "module": "../esm/getReactElementRef/index.js",
   "main": "./index.js",
   "types": "./index.d.ts"
 }

package/getScrollbarSize/getScrollbarSize.d.ts

@@ -1 +1 @@
-export default function getScrollbarSize(doc: Document): number;
+export default function getScrollbarSize(win?: Window): number;

package/getScrollbarSize/getScrollbarSize.js

@@ -6,8 +6,8 @@ Object.defineProperty(exports, "__esModule", {
 exports.default = getScrollbarSize;
 // A change of the browser zoom change the scrollbar size.
 // Credit https://github.com/twbs/bootstrap/blob/488fd8afc535ca3a6ad4dc581f5e89217b6a36ac/js/src/util/scrollbar.js#L14-L18
-function getScrollbarSize(doc) {
+function getScrollbarSize(win = window) {
   // https://developer.mozilla.org/en-US/docs/Web/API/Window/innerWidth#usage_notes
-  const documentWidth = doc.documentElement.clientWidth;
-  return Math.abs(window.innerWidth - documentWidth);
+  const documentWidth = win.document.documentElement.clientWidth;
+  return win.innerWidth - documentWidth;
 }

package/index.d.ts

@@ -45,5 +45,5 @@ export { default as unstable_useSlotProps } from './useSlotProps';
 export type { UseSlotPropsParameters, UseSlotPropsResult } from './useSlotProps';
 export { default as unstable_resolveComponentProps } from './resolveComponentProps';
 export { default as unstable_extractEventHandlers } from './extractEventHandlers';
-export { default as unstable_getReactNodeRef } from './getReactNodeRef';
+export { default as unstable_getReactElementRef } from './getReactElementRef';
 export * from './types';

package/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/utils v6.1.1
+ * @mui/utils v6.1.2
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the
@@ -59,7 +59,7 @@ var _exportNames = {
   unstable_useSlotProps: true,
   unstable_resolveComponentProps: true,
   unstable_extractEventHandlers: true,
-  unstable_getReactNodeRef: true
+  unstable_getReactElementRef: true
 };
 Object.defineProperty(exports, "HTMLElementType", {
   enumerable: true,
@@ -211,10 +211,10 @@ Object.defineProperty(exports, "unstable_generateUtilityClasses", {
     return _generateUtilityClasses.default;
   }
 });
-Object.defineProperty(exports, "unstable_getReactNodeRef", {
+Object.defineProperty(exports, "unstable_getReactElementRef", {
   enumerable: true,
   get: function () {
-    return _getReactNodeRef.default;
+    return _getReactElementRef.default;
   }
 });
 Object.defineProperty(exports, "unstable_getScrollbarSize", {
@@ -397,7 +397,7 @@ var _clamp = _interopRequireDefault(require("./clamp"));
 var _useSlotProps = _interopRequireDefault(require("./useSlotProps"));
 var _resolveComponentProps = _interopRequireDefault(require("./resolveComponentProps"));
 var _extractEventHandlers = _interopRequireDefault(require("./extractEventHandlers"));
-var _getReactNodeRef = _interopRequireDefault(require("./getReactNodeRef"));
+var _getReactElementRef = _interopRequireDefault(require("./getReactElementRef"));
 var _types = require("./types");
 Object.keys(_types).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;

package/modern/getReactElementRef/getReactElementRef.js

@@ -0,0 +1,18 @@
+import * as React from 'react';
+
+/**
+ * Returns the ref of a React element handling differences between React 19 and older versions.
+ * It will throw runtime error if the element is not a valid React element.
+ *
+ * @param element React.ReactElement
+ * @returns React.Ref<any> | null | undefined
+ */
+export default function getReactElementRef(element) {
+  // 'ref' is passed as prop in React 19, whereas 'ref' is directly attached to children in older versions
+  if (parseInt(React.version, 10) >= 19) {
+    return element.props?.ref;
+  }
+  // @ts-expect-error element.ref is not included in the ReactElement type
+  // https://github.com/DefinitelyTyped/DefinitelyTyped/discussions/70189
+  return element?.ref;
+}

package/modern/getReactElementRef/index.js

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

package/modern/getScrollbarSize/getScrollbarSize.js

@@ -1,7 +1,7 @@
 // A change of the browser zoom change the scrollbar size.
 // Credit https://github.com/twbs/bootstrap/blob/488fd8afc535ca3a6ad4dc581f5e89217b6a36ac/js/src/util/scrollbar.js#L14-L18
-export default function getScrollbarSize(doc) {
+export default function getScrollbarSize(win = window) {
   // https://developer.mozilla.org/en-US/docs/Web/API/Window/innerWidth#usage_notes
-  const documentWidth = doc.documentElement.clientWidth;
-  return Math.abs(window.innerWidth - documentWidth);
+  const documentWidth = win.document.documentElement.clientWidth;
+  return win.innerWidth - documentWidth;
 }

package/modern/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/utils v6.1.1
+ * @mui/utils v6.1.2
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the
@@ -51,5 +51,5 @@ export { default as clamp } from "./clamp/index.js";
 export { default as unstable_useSlotProps } from "./useSlotProps/index.js";
 export { default as unstable_resolveComponentProps } from "./resolveComponentProps/index.js";
 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 * from "./types.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/utils",
-  "version": "6.1.1",
+  "version": "6.1.2",
   "private": false,
   "author": "MUI Team",
   "description": "Utility functions for React components.",
@@ -27,7 +27,7 @@
   },
   "dependencies": {
     "@babel/runtime": "^7.25.6",
-    "@types/prop-types": "^15.7.12",
+    "@types/prop-types": "^15.7.13",
     "clsx": "^2.1.1",
     "prop-types": "^15.8.1",
     "react-is": "^18.3.1",

package/esm/getReactNodeRef/getReactNodeRef.js

@@ -1,21 +0,0 @@
-import * as React from 'react';
-
-/**
- * Returns the ref of a React node handling differences between React 19 and older versions.
- * It will return null if the node is not a valid React element.
- *
- * @param element React.ReactNode
- * @returns React.Ref<any> | null
- */
-export default function getReactNodeRef(element) {
-  if (!element || ! /*#__PURE__*/React.isValidElement(element)) {
-    return null;
-  }
-
-  // 'ref' is passed as prop in React 19, whereas 'ref' is directly attached to children in older versions
-  return element.props.propertyIsEnumerable('ref') ? element.props.ref :
-  // @ts-expect-error element.ref is not included in the ReactElement type
-  // We cannot check for it, but isValidElement is true at this point
-  // https://github.com/DefinitelyTyped/DefinitelyTyped/discussions/70189
-  element.ref;
-}

package/esm/getReactNodeRef/index.js

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

package/getReactNodeRef/getReactNodeRef.d.ts

@@ -1,9 +0,0 @@
-import * as React from 'react';
-/**
- * Returns the ref of a React node handling differences between React 19 and older versions.
- * It will return null if the node is not a valid React element.
- *
- * @param element React.ReactNode
- * @returns React.Ref<any> | null
- */
-export default function getReactNodeRef(element: React.ReactNode): React.Ref<any> | null;

package/getReactNodeRef/getReactNodeRef.js

@@ -1,27 +0,0 @@
-"use strict";
-
-var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard").default;
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = getReactNodeRef;
-var React = _interopRequireWildcard(require("react"));
-/**
- * Returns the ref of a React node handling differences between React 19 and older versions.
- * It will return null if the node is not a valid React element.
- *
- * @param element React.ReactNode
- * @returns React.Ref<any> | null
- */
-function getReactNodeRef(element) {
-  if (!element || ! /*#__PURE__*/React.isValidElement(element)) {
-    return null;
-  }
-
-  // 'ref' is passed as prop in React 19, whereas 'ref' is directly attached to children in older versions
-  return element.props.propertyIsEnumerable('ref') ? element.props.ref :
-  // @ts-expect-error element.ref is not included in the ReactElement type
-  // We cannot check for it, but isValidElement is true at this point
-  // https://github.com/DefinitelyTyped/DefinitelyTyped/discussions/70189
-  element.ref;
-}

package/getReactNodeRef/index.d.ts

@@ -1 +0,0 @@
-export { default } from './getReactNodeRef';

package/modern/getReactNodeRef/getReactNodeRef.js

@@ -1,21 +0,0 @@
-import * as React from 'react';
-
-/**
- * Returns the ref of a React node handling differences between React 19 and older versions.
- * It will return null if the node is not a valid React element.
- *
- * @param element React.ReactNode
- * @returns React.Ref<any> | null
- */
-export default function getReactNodeRef(element) {
-  if (!element || ! /*#__PURE__*/React.isValidElement(element)) {
-    return null;
-  }
-
-  // 'ref' is passed as prop in React 19, whereas 'ref' is directly attached to children in older versions
-  return element.props.propertyIsEnumerable('ref') ? element.props.ref :
-  // @ts-expect-error element.ref is not included in the ReactElement type
-  // We cannot check for it, but isValidElement is true at this point
-  // https://github.com/DefinitelyTyped/DefinitelyTyped/discussions/70189
-  element.ref;
-}

package/modern/getReactNodeRef/index.js

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