[utils] Bring back getReactNodeRef (mui#44248)

packages/mui-utils/src/getReactNodeRef/getReactNodeRef.ts

@@ -0,0 +1,24 @@
+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
+ *
+ * @deprecated Use getReactElementRef instead
+ */
+export default function getReactNodeRef(element: React.ReactNode): React.Ref<any> | null {
+  if (!element || !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 as any).propertyIsEnumerable('ref')
+    ? (element.props as any).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;
+}

packages/mui-utils/src/getReactNodeRef/index.ts

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

packages/mui-utils/src/index.ts

@@ -45,5 +45,6 @@ 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';