@mui/utils 6.0.0-beta.3 → 6.0.0-beta.4-dev.20240802-144226-85a3b55d22

package/CHANGELOG.md

@@ -1,5 +1,46 @@
 # [Versions](https://mui.com/versions/)
 
+## 6.0.0-beta.4
+
+<!-- generated comparing v6.0.0-beta.3..next -->
+
+_Jul 30, 2024_
+
+A big thanks to the 12 contributors who made this release possible.
+
+### `@mui/material@6.0.0-beta.4`
+
+- [Accordion] Render a heading wrapping `AccordionSummary` button per W3C Accordion Pattern standards (#42914) @ZeeshanTamboli
+- [Divider] Enable borderStyle enhancement in divider with children (#42715) @anuujj
+- [ImageListItemBar] Deprecate composed classes (#42905) @sai6855
+- Attach selector for default color scheme (#43035) @siriwatknp
+- Stabilize Grid v2 and deprecate Grid v1 (#43054) @DiegoAndai
+
+### `@mui/system@6.0.0-beta.4`
+
+- Make `createBreakpoints` independent for stringify theme (#43048) @siriwatknp
+
+### `@mui/utils@6.0.0-beta.4`
+
+- Fix issues reported by the React Compiler (#43051) @markliu2013
+
+### Docs
+
+- [material-ui] Replace deprecated `<ListItem button/>` with `ListItemButton` component in routing libraries list example (#43110) @aliharis99
+- [material-ui][Card] Update CardMedia description (#43067) @shahzaibdev1
+- [material-ui] Polish out data table demo (#43072) @zanivan
+- [material-ui][Snackbar] Improve reason type in demos (#43077) @sai6855
+- [pigment-css] Fix syntax in migrating-to-pigment-css guide (#43107) @KevinVandy
+- Fix page description line break @oliviertassinari
+
+### Core
+
+- Fix event naming convention @oliviertassinari
+- [docs-infra] Move ads to the `@mui/docs` package (#42944) @alexfauquette
+- [website] Fine-tune button styles on the branding theme (#43082) @zanivan
+
+All contributors of this release in alphabetical order: @alexfauquette, @aliharis99, @anuujj, @DiegoAndai, @KevinVandy, @markliu2013, @oliviertassinari, @sai6855, @shahzaibdev1, @siriwatknp, @zanivan, @ZeeshanTamboli
+
 ## 6.0.0-beta.3
 
 <!-- generated comparing v6.0.0-beta.2..next -->

package/esm/getReactNodeRef/getReactNodeRef.js

@@ -0,0 +1,21 @@
+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

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

package/esm/index.js

@@ -44,4 +44,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_getReactNodeRef } from './getReactNodeRef';
 export * from './types';

package/esm/useControlled/useControlled.js

@@ -1,5 +1,6 @@
 'use client';
 
+// TODO: uncomment once we enable eslint-plugin-react-compiler // eslint-disable-next-line react-compiler/react-compiler -- process.env never changes, dependency arrays are intentionally ignored
 /* eslint-disable react-hooks/rules-of-hooks, react-hooks/exhaustive-deps */
 import * as React from 'react';
 export default function useControlled({

package/esm/useForkRef/useForkRef.js

@@ -17,6 +17,7 @@ export default function useForkRef(...refs) {
         setRef(ref, instance);
       });
     };
+    // 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
   }, refs);
 }

package/esm/useId/useId.js

@@ -31,6 +31,7 @@ export default function useId(idOverride) {
     const reactId = maybeReactUseId();
     return idOverride ?? reactId;
   }
+  // TODO: uncomment once we enable eslint-plugin-react-compiler // eslint-disable-next-line react-compiler/react-compiler
   // eslint-disable-next-line react-hooks/rules-of-hooks -- `React.useId` is invariant at runtime.
   return useGlobalId(idOverride);
 }

package/esm/useOnMount/useOnMount.js

@@ -7,6 +7,7 @@ const EMPTY = [];
  * A React.useEffect equivalent that runs once, when the component is mounted.
  */
 export default function useOnMount(fn) {
+  // TODO: uncomment once we enable eslint-plugin-react-compiler // eslint-disable-next-line react-compiler/react-compiler -- no need to put `fn` in the dependency array
   /* eslint-disable react-hooks/exhaustive-deps */
   React.useEffect(fn, EMPTY);
   /* eslint-enable react-hooks/exhaustive-deps */

package/getReactNodeRef/getReactNodeRef.d.ts

@@ -0,0 +1,9 @@
+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

@@ -0,0 +1,28 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = getReactNodeRef;
+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 && {}.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 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

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

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

package/getReactNodeRef/package.json

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

package/index.d.ts

@@ -45,4 +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 * from './types';

package/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/utils v6.0.0-beta.3
+ * @mui/utils v6.0.0-beta.4-dev.20240802-144226-85a3b55d22
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the
@@ -57,7 +57,8 @@ var _exportNames = {
   clamp: true,
   unstable_useSlotProps: true,
   unstable_resolveComponentProps: true,
-  unstable_extractEventHandlers: true
+  unstable_extractEventHandlers: true,
+  unstable_getReactNodeRef: true
 };
 Object.defineProperty(exports, "HTMLElementType", {
   enumerable: true,
@@ -209,6 +210,12 @@ Object.defineProperty(exports, "unstable_generateUtilityClasses", {
     return _generateUtilityClasses.default;
   }
 });
+Object.defineProperty(exports, "unstable_getReactNodeRef", {
+  enumerable: true,
+  get: function () {
+    return _getReactNodeRef.default;
+  }
+});
 Object.defineProperty(exports, "unstable_getScrollbarSize", {
   enumerable: true,
   get: function () {
@@ -389,6 +396,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 _types = require("./types");
 Object.keys(_types).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;

package/modern/getReactNodeRef/getReactNodeRef.js

@@ -0,0 +1,21 @@
+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

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

package/modern/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/utils v6.0.0-beta.3
+ * @mui/utils v6.0.0-beta.4-dev.20240802-144226-85a3b55d22
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the
@@ -51,4 +51,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_getReactNodeRef } from './getReactNodeRef';
 export * from './types';

package/modern/useControlled/useControlled.js

@@ -1,5 +1,6 @@
 'use client';
 
+// TODO: uncomment once we enable eslint-plugin-react-compiler // eslint-disable-next-line react-compiler/react-compiler -- process.env never changes, dependency arrays are intentionally ignored
 /* eslint-disable react-hooks/rules-of-hooks, react-hooks/exhaustive-deps */
 import * as React from 'react';
 export default function useControlled({

package/modern/useForkRef/useForkRef.js

@@ -17,6 +17,7 @@ export default function useForkRef(...refs) {
         setRef(ref, instance);
       });
     };
+    // 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
   }, refs);
 }

package/modern/useId/useId.js

@@ -31,6 +31,7 @@ export default function useId(idOverride) {
     const reactId = maybeReactUseId();
     return idOverride ?? reactId;
   }
+  // TODO: uncomment once we enable eslint-plugin-react-compiler // eslint-disable-next-line react-compiler/react-compiler
   // eslint-disable-next-line react-hooks/rules-of-hooks -- `React.useId` is invariant at runtime.
   return useGlobalId(idOverride);
 }

package/modern/useOnMount/useOnMount.js

@@ -7,6 +7,7 @@ const EMPTY = [];
  * A React.useEffect equivalent that runs once, when the component is mounted.
  */
 export default function useOnMount(fn) {
+  // TODO: uncomment once we enable eslint-plugin-react-compiler // eslint-disable-next-line react-compiler/react-compiler -- no need to put `fn` in the dependency array
   /* eslint-disable react-hooks/exhaustive-deps */
   React.useEffect(fn, EMPTY);
   /* eslint-enable react-hooks/exhaustive-deps */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/utils",
-  "version": "6.0.0-beta.3",
+  "version": "6.0.0-beta.4-dev.20240802-144226-85a3b55d22",
   "private": false,
   "author": "MUI Team",
   "description": "Utility functions for React components.",
@@ -26,7 +26,7 @@
     "url": "https://opencollective.com/mui-org"
   },
   "dependencies": {
-    "@babel/runtime": "^7.24.8",
+    "@babel/runtime": "^7.25.0",
     "@types/prop-types": "^15.7.12",
     "clsx": "^2.1.1",
     "prop-types": "^15.8.1",

package/useControlled/useControlled.js

@@ -1,6 +1,7 @@
 "use strict";
 'use client';
 
+// TODO: uncomment once we enable eslint-plugin-react-compiler // eslint-disable-next-line react-compiler/react-compiler -- process.env never changes, dependency arrays are intentionally ignored
 /* eslint-disable react-hooks/rules-of-hooks, react-hooks/exhaustive-deps */
 Object.defineProperty(exports, "__esModule", {
   value: true

package/useForkRef/useForkRef.js

@@ -25,6 +25,7 @@ function useForkRef(...refs) {
         (0, _setRef.default)(ref, instance);
       });
     };
+    // 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
   }, refs);
 }

package/useId/useId.js

@@ -38,6 +38,7 @@ function useId(idOverride) {
     const reactId = maybeReactUseId();
     return idOverride != null ? idOverride : reactId;
   }
+  // TODO: uncomment once we enable eslint-plugin-react-compiler // eslint-disable-next-line react-compiler/react-compiler
   // eslint-disable-next-line react-hooks/rules-of-hooks -- `React.useId` is invariant at runtime.
   return useGlobalId(idOverride);
 }

package/useOnMount/useOnMount.js

@@ -14,6 +14,7 @@ const EMPTY = [];
  * A React.useEffect equivalent that runs once, when the component is mounted.
  */
 function useOnMount(fn) {
+  // TODO: uncomment once we enable eslint-plugin-react-compiler // eslint-disable-next-line react-compiler/react-compiler -- no need to put `fn` in the dependency array
   /* eslint-disable react-hooks/exhaustive-deps */
   React.useEffect(fn, EMPTY);
   /* eslint-enable react-hooks/exhaustive-deps */