3d-tiles-renderer/src/r3f/components/CanvasDOMOverlay.jsx

https://github.com/AnalyticalGraphicsInc/3d-tiles/tree/master/specification

/** @import { ReactNode } from 'react' */
import { useMemo, useEffect, StrictMode, forwardRef, useState } from 'react';
import { createRoot } from 'react-dom/client';
import { useThree } from '@react-three/fiber';

/**
 * Creates a DOM overlay positioned absolutely over the canvas. Children are rendered into a
 * separate React root. Remaining props are passed to the root div element.
 * @component
 * @param {Object} props
 * @param {ReactNode} [props.children] - DOM content to render in the overlay.
 */
// Utility class for overlaying dom elements on top of the canvas
export const CanvasDOMOverlay = forwardRef( function CanvasDOMOverlay( { children, ...rest }, ref ) {

	// create the dom element and react root
	const [ gl ] = useThree( state => [ state.gl ] );
	const [ root, setRoot ] = useState( null );
	const container = useMemo( () => document.createElement( 'div' ), [] );

	// position the container
	useEffect( () => {

		container.style.pointerEvents = 'none';
		container.style.position = 'absolute';
		container.style.width = '100%';
		container.style.height = '100%';
		container.style.left = 0;
		container.style.top = 0;
		gl.domElement.parentNode.appendChild( container );

		return () => {

			container.remove();

		};

	}, [ container, gl.domElement.parentNode ] );

	// create the react render root
	useEffect( () => {

		const root = createRoot( container );
		setRoot( root );
		return () => {

			root.unmount();

		};

	}, [ container ] );

	// render the children into the container
	if ( root !== null ) {

		root.render(
			<StrictMode>
				<div { ...rest } ref={ ref }>
					{ children }
				</div>
			</StrictMode>
		);

	}

} );