@mui/utils 6.0.0-beta.4 → 6.0.0-beta.4-dev.20240805-092432-9f940a61d6

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/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.4
+ * @mui/utils v6.0.0-beta.4-dev.20240805-092432-9f940a61d6
  *
  * @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.4
+ * @mui/utils v6.0.0-beta.4-dev.20240805-092432-9f940a61d6
  *
  * @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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/utils",
-  "version": "6.0.0-beta.4",
+  "version": "6.0.0-beta.4-dev.20240805-092432-9f940a61d6",
   "private": false,
   "author": "MUI Team",
   "description": "Utility functions for React components.",