@mui/utils 5.16.5 → 5.16.8

package/CHANGELOG.md

@@ -1,5 +1,99 @@
 # [Versions](https://mui.com/versions/)
 
+## 5.16.8
+
+<!-- generated comparing v5.16.7..v5.x -->
+
+_Nov 26, 2024_
+
+A big thanks to the 8 contributors who made this release possible.
+
+### `@mui/material@5.16.8`
+
+- Cherry pick ref accessing PRs (#44543) @DiegoAndai
+
+### `@mui/utils@5.16.8`
+
+- Skip deep clone React element (v5.x) (#44494) @jukkatupamaki
+
+### Docs
+
+- Keep sponsors up to date @oliviertassinari
+- Fix MUI Treasury Layout broken links (#43753) @oliviertassinari
+- Strengthen CSP rule @oliviertassinari
+- Give up on restoring search @oliviertassinari
+- Normalize next major message @oliviertassinari
+- Fix versions URL @oliviertassinari
+- Fix use of absolute URLs (#43567) @oliviertassinari
+- Restore search on v5 (#43566) @oliviertassinari
+- Fix link from v5 to v6 (#43585) @alexfauquette
+- Updated mui-x roadmap links with the new project URL (@michelengelen) (#43446) @michelengelen
+- Fix broken link to Next.js docs @oliviertassinari
+
+### Core
+
+- [blog] Polish Upcoming changes to MUI X pricing in 2024 (#43438) @oliviertassinari
+- [blog] Add video to the Pigment CSS blog post (#42500) @oliviertassinari
+- [blog] Announcing pricing changes Sep 2024 (#43272) @cherniavskii
+- Prepare for moving to v5.x branch (#43447) @siriwatknp
+- [core] Cherry pick #42346 to v5 (#44475) @DiegoAndai
+- [core] Fix CI on v5.x branch (#44487) @DiegoAndai
+- [core] Fix CI on v5.x branch (#43564) @oliviertassinari
+- [examples] Fix v5 clone example instructions (#43755) @oliviertassinari
+- [examples] Fix CLI download instructions @oliviertassinari
+- [examples] Fix CDN live preview example @oliviertassinari
+- [examples] Fix more examples to work with v5 @oliviertassinari
+- [examples] Freeze examples dependency range (#43435) @oliviertassinari
+
+All contributors of this release in alphabetical order: @alexfauquette, @cherniavskii, @DiegoAndai, @jukkatupamaki, @michelengelen, @oliviertassinari, @rluzists1, @siriwatknp
+
+## 5.16.7
+
+<!-- generated comparing v5.16.6..master -->
+
+_Aug 9, 2024_
+
+A big thanks to the 3 contributors who made this release possible.
+
+### `@mui/material@5.16.7`
+
+- &#8203;<!-- 3 -->[material-ui][mui-system] Add support for version runtime checks (#43233) @DiegoAndai
+
+### Docs
+
+- &#8203;<!-- 4 -->[docs] Fix 301 @oliviertassinari
+
+### Core
+
+- &#8203;<!-- 2 -->[website] Fix wrong link in pricing table (@zanivan) (#43143) @zanivan
+- &#8203;<!-- 1 -->[website] Add blog link to pricing table (@zanivan) (#43140) @zanivan
+
+All contributors of this release in alphabetical order: @DiegoAndai, @oliviertassinari, @zanivan
+
+## 5.16.6
+
+<!-- generated comparing v5.16.5..master -->
+
+_Jul 30, 2024_
+
+A big thanks to the 5 contributors who made this release possible.
+
+### `@mui/material@5.16.6`
+
+- [Divider] Enable borderStyle enhancement in divider with children (#43059) @anuujj
+
+### Docs
+
+- [material-ui][Card] Update CardMedia description (#43121) @shahzaibdev1
+- [material-ui] Replace deprecated `<ListItem button/>` with `ListItemButton` component in routing libraries list example (#43114) @aliharis99
+- [material-ui][Snackbar] Improve close `reason` type in demos (#43105) @sai6855
+
+### Core
+
+- [code-infra] Use the same CI names on master & next (#43064) @mnajdova
+
+All contributors of this release in alphabetical order: @aliharis99, @anuujj, @mnajdova, @sai6855, @shahzaibdev1
+
 ## 5.16.5
 
 <!-- generated comparing v5.16.4..master -->

package/deepmerge/deepmerge.js

@@ -7,6 +7,9 @@ Object.defineProperty(exports, "__esModule", {
 exports.default = deepmerge;
 exports.isPlainObject = isPlainObject;
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+var React = _interopRequireWildcard(require("react"));
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
 // https://github.com/sindresorhus/is-plain-obj/blob/main/index.js
 function isPlainObject(item) {
   if (typeof item !== 'object' || item === null) {
@@ -16,7 +19,7 @@ function isPlainObject(item) {
   return (prototype === null || prototype === Object.prototype || Object.getPrototypeOf(prototype) === null) && !(Symbol.toStringTag in item) && !(Symbol.iterator in item);
 }
 function deepClone(source) {
-  if (!isPlainObject(source)) {
+  if ( /*#__PURE__*/React.isValidElement(source) || !isPlainObject(source)) {
     return source;
   }
   const output = {};
@@ -31,7 +34,9 @@ function deepmerge(target, source, options = {
   const output = options.clone ? (0, _extends2.default)({}, target) : target;
   if (isPlainObject(target) && isPlainObject(source)) {
     Object.keys(source).forEach(key => {
-      if (isPlainObject(source[key]) &&
+      if ( /*#__PURE__*/React.isValidElement(source[key])) {
+        output[key] = source[key];
+      } else if (isPlainObject(source[key]) &&
       // Avoid prototype pollution
       Object.prototype.hasOwnProperty.call(target, key) && isPlainObject(target[key])) {
         // Since `output` is a clone of `target` and we have narrowed `target` in this block we can cast to the same type.

package/esm/deepmerge/deepmerge.js

@@ -1,4 +1,6 @@
 import _extends from "@babel/runtime/helpers/esm/extends";
+import * as React from 'react';
+
 // https://github.com/sindresorhus/is-plain-obj/blob/main/index.js
 export function isPlainObject(item) {
   if (typeof item !== 'object' || item === null) {
@@ -8,7 +10,7 @@ export function isPlainObject(item) {
   return (prototype === null || prototype === Object.prototype || Object.getPrototypeOf(prototype) === null) && !(Symbol.toStringTag in item) && !(Symbol.iterator in item);
 }
 function deepClone(source) {
-  if (!isPlainObject(source)) {
+  if ( /*#__PURE__*/React.isValidElement(source) || !isPlainObject(source)) {
     return source;
   }
   const output = {};
@@ -23,7 +25,9 @@ export default function deepmerge(target, source, options = {
   const output = options.clone ? _extends({}, target) : target;
   if (isPlainObject(target) && isPlainObject(source)) {
     Object.keys(source).forEach(key => {
-      if (isPlainObject(source[key]) &&
+      if ( /*#__PURE__*/React.isValidElement(source[key])) {
+        output[key] = source[key];
+      } else if (isPlainObject(source[key]) &&
       // Avoid prototype pollution
       Object.prototype.hasOwnProperty.call(target, key) && isPlainObject(target[key])) {
         // Since `output` is a clone of `target` and we have narrowed `target` in this block we can cast to the same type.

package/esm/getReactElementRef/getReactElementRef.js

@@ -0,0 +1,19 @@
+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
+ */
+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) {
+    var _element$props;
+    return (element == null || (_element$props = element.props) == null ? void 0 : _element$props.ref) || null;
+  }
+  // @ts-expect-error element.ref is not included in the ReactElement type
+  // https://github.com/DefinitelyTyped/DefinitelyTyped/discussions/70189
+  return (element == null ? void 0 : element.ref) || null;
+}

package/esm/getReactElementRef/index.js

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

package/esm/index.js

@@ -45,4 +45,5 @@ export { default as clamp } from './clamp';
 export { default as unstable_useSlotProps } from './useSlotProps';
 export { default as unstable_resolveComponentProps } from './resolveComponentProps';
 export { default as unstable_extractEventHandlers } from './extractEventHandlers';
+export { default as unstable_getReactElementRef } from './getReactElementRef';
 export * from './types';

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
+ */
+export default function getReactElementRef(element: React.ReactElement): React.Ref<any> | null;

package/getReactElementRef/getReactElementRef.js

@@ -0,0 +1,26 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = getReactElementRef;
+var React = _interopRequireWildcard(require("react"));
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+/**
+ * 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
+ */
+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) {
+    var _element$props;
+    return (element == null || (_element$props = element.props) == null ? void 0 : _element$props.ref) || null;
+  }
+  // @ts-expect-error element.ref is not included in the ReactElement type
+  // https://github.com/DefinitelyTyped/DefinitelyTyped/discussions/70189
+  return (element == null ? void 0 : element.ref) || null;
+}

package/getReactElementRef/index.d.ts

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

package/getReactElementRef/index.js

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

package/getReactElementRef/package.json

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

package/getValidReactChildren/getValidReactChildren.d.ts

@@ -5,4 +5,4 @@ import * as React from 'react';
  *
  * @param children the children
  */
-export default function getValidReactChildren(children: React.ReactNode): React.ReactElement<any, string | React.JSXElementConstructor<any>>[];
+export default function getValidReactChildren(children: React.ReactNode): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>[];

package/index.d.ts

@@ -46,4 +46,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_getReactElementRef } from './getReactElementRef';
 export * from './types';

package/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/utils v5.16.5
+ * @mui/utils v5.16.8
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the
@@ -59,7 +59,8 @@ var _exportNames = {
   clamp: true,
   unstable_useSlotProps: true,
   unstable_resolveComponentProps: true,
-  unstable_extractEventHandlers: true
+  unstable_extractEventHandlers: true,
+  unstable_getReactElementRef: true
 };
 Object.defineProperty(exports, "HTMLElementType", {
   enumerable: true,
@@ -223,6 +224,12 @@ Object.defineProperty(exports, "unstable_getNormalizedScrollLeft", {
     return _scrollLeft.getNormalizedScrollLeft;
   }
 });
+Object.defineProperty(exports, "unstable_getReactElementRef", {
+  enumerable: true,
+  get: function () {
+    return _getReactElementRef.default;
+  }
+});
 Object.defineProperty(exports, "unstable_getScrollbarSize", {
   enumerable: true,
   get: function () {
@@ -404,6 +411,7 @@ var _clamp = _interopRequireDefault(require("./clamp"));
 var _useSlotProps = _interopRequireDefault(require("./useSlotProps"));
 var _resolveComponentProps = _interopRequireDefault(require("./resolveComponentProps"));
 var _extractEventHandlers = _interopRequireDefault(require("./extractEventHandlers"));
+var _getReactElementRef = _interopRequireDefault(require("./getReactElementRef"));
 var _types = require("./types");
 Object.keys(_types).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;

package/legacy/deepmerge/deepmerge.js

@@ -1,5 +1,7 @@
 import _extends from "@babel/runtime/helpers/esm/extends";
 import _typeof from "@babel/runtime/helpers/esm/typeof";
+import * as React from 'react';
+
 // https://github.com/sindresorhus/is-plain-obj/blob/main/index.js
 export function isPlainObject(item) {
   if (_typeof(item) !== 'object' || item === null) {
@@ -9,7 +11,7 @@ export function isPlainObject(item) {
   return (prototype === null || prototype === Object.prototype || Object.getPrototypeOf(prototype) === null) && !(Symbol.toStringTag in item) && !(Symbol.iterator in item);
 }
 function deepClone(source) {
-  if (!isPlainObject(source)) {
+  if ( /*#__PURE__*/React.isValidElement(source) || !isPlainObject(source)) {
     return source;
   }
   var output = {};
@@ -25,7 +27,9 @@ export default function deepmerge(target, source) {
   var output = options.clone ? _extends({}, target) : target;
   if (isPlainObject(target) && isPlainObject(source)) {
     Object.keys(source).forEach(function (key) {
-      if (isPlainObject(source[key]) &&
+      if ( /*#__PURE__*/React.isValidElement(source[key])) {
+        output[key] = source[key];
+      } else if (isPlainObject(source[key]) &&
       // Avoid prototype pollution
       Object.prototype.hasOwnProperty.call(target, key) && isPlainObject(target[key])) {
         // Since `output` is a clone of `target` and we have narrowed `target` in this block we can cast to the same type.

package/legacy/getReactElementRef/getReactElementRef.js

@@ -0,0 +1,19 @@
+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
+ */
+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) {
+    var _element$props;
+    return (element == null || (_element$props = element.props) == null ? void 0 : _element$props.ref) || null;
+  }
+  // @ts-expect-error element.ref is not included in the ReactElement type
+  // https://github.com/DefinitelyTyped/DefinitelyTyped/discussions/70189
+  return (element == null ? void 0 : element.ref) || null;
+}

package/legacy/getReactElementRef/index.js

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

package/legacy/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/utils v5.16.5
+ * @mui/utils v5.16.8
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the
@@ -52,4 +52,5 @@ export { default as clamp } from './clamp';
 export { default as unstable_useSlotProps } from './useSlotProps';
 export { default as unstable_resolveComponentProps } from './resolveComponentProps';
 export { default as unstable_extractEventHandlers } from './extractEventHandlers';
+export { default as unstable_getReactElementRef } from './getReactElementRef';
 export * from './types';

package/modern/deepmerge/deepmerge.js

@@ -1,4 +1,6 @@
 import _extends from "@babel/runtime/helpers/esm/extends";
+import * as React from 'react';
+
 // https://github.com/sindresorhus/is-plain-obj/blob/main/index.js
 export function isPlainObject(item) {
   if (typeof item !== 'object' || item === null) {
@@ -8,7 +10,7 @@ export function isPlainObject(item) {
   return (prototype === null || prototype === Object.prototype || Object.getPrototypeOf(prototype) === null) && !(Symbol.toStringTag in item) && !(Symbol.iterator in item);
 }
 function deepClone(source) {
-  if (!isPlainObject(source)) {
+  if ( /*#__PURE__*/React.isValidElement(source) || !isPlainObject(source)) {
     return source;
   }
   const output = {};
@@ -23,7 +25,9 @@ export default function deepmerge(target, source, options = {
   const output = options.clone ? _extends({}, target) : target;
   if (isPlainObject(target) && isPlainObject(source)) {
     Object.keys(source).forEach(key => {
-      if (isPlainObject(source[key]) &&
+      if ( /*#__PURE__*/React.isValidElement(source[key])) {
+        output[key] = source[key];
+      } else if (isPlainObject(source[key]) &&
       // Avoid prototype pollution
       Object.prototype.hasOwnProperty.call(target, key) && isPlainObject(target[key])) {
         // Since `output` is a clone of `target` and we have narrowed `target` in this block we can cast to the same type.

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
+ */
+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 || null;
+  }
+  // @ts-expect-error element.ref is not included in the ReactElement type
+  // https://github.com/DefinitelyTyped/DefinitelyTyped/discussions/70189
+  return element?.ref || null;
+}

package/modern/getReactElementRef/index.js

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

package/modern/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/utils v5.16.5
+ * @mui/utils v5.16.8
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the
@@ -52,4 +52,5 @@ export { default as clamp } from './clamp';
 export { default as unstable_useSlotProps } from './useSlotProps';
 export { default as unstable_resolveComponentProps } from './resolveComponentProps';
 export { default as unstable_extractEventHandlers } from './extractEventHandlers';
+export { default as unstable_getReactElementRef } from './getReactElementRef';
 export * from './types';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/utils",
-  "version": "5.16.5",
+  "version": "5.16.8",
   "private": false,
   "author": "MUI Team",
   "description": "Utility functions for React components.",
@@ -34,8 +34,8 @@
     "@mui/types": "^7.2.15"
   },
   "peerDependencies": {
-    "@types/react": "^17.0.0 || ^18.0.0",
-    "react": "^17.0.0 || ^18.0.0"
+    "@types/react": "^17.0.0 || ^18.0.0 || ^19.0.0",
+    "react": "^17.0.0 || ^18.0.0 || ^19.0.0"
   },
   "peerDependenciesMeta": {
     "@types/react": {