'use client'; import * as React from 'react'; import { getReactElementRef, useMergedRefs } from '@fluentui/react-utilities'; const CHILD_ERROR_MESSAGE = [ '@fluentui/react-motion: Invalid child element.', '\n', 'Motion factories require a single child element to be passed. ', 'That element element should support ref forwarding i.e. it should be either an intrinsic element (e.g. div) or a component that uses React.forwardRef().' ].join(''); /** * Validates the child and returns a cloned child element with a ref. * * Throws an error if the child is not a valid React element, similar to "React.Children.only". * Logs a warning in development mode if the ref is not set as the component remains functional. */ export function useChildElement(children, mounted = true) { const childRef = React.useRef(null); React.useEffect(()=>{ if (process.env.NODE_ENV !== 'production') { if (mounted && !childRef.current) { // eslint-disable-next-line no-console console.error(CHILD_ERROR_MESSAGE); } } }, [ mounted ]); try { const child = React.Children.only(children); if (React.isValidElement(child)) { return [ React.cloneElement(child, { ref: useMergedRefs(childRef, getReactElementRef(child)) }), childRef ]; } } catch { /* empty */ } throw new Error(CHILD_ERROR_MESSAGE); }