'use client' import React from 'react' export interface ClientOnlyProps { /** * The children to render when the JS is loaded. */ children: React.ReactNode /** * The fallback component to render if the JS is not yet loaded. */ fallback?: React.ReactNode } /** * Render the children only after the JS has loaded client-side. Use an optional * fallback component if the JS is not yet loaded. * * @example * Render a Chart component if JS loads, renders a simple FakeChart * component server-side or if there is no JS. The FakeChart can have only the * UI without the behavior or be a loading spinner or skeleton. * * ```tsx * return ( * }> * * * ) * ``` */ export function ClientOnly({ children, fallback = null }: ClientOnlyProps) { return useHydrated() ? ( {children} ) : ( {fallback} ) } /** * Return a boolean indicating if the JS has been hydrated already. * When doing Server-Side Rendering, the result will always be false. * When doing Client-Side Rendering, the result will always be false on the * first render and true from then on. Even if a new component renders it will * always start with true. * * @example * ```tsx * // Disable a button that needs JS to work. * let hydrated = useHydrated() * return ( * * ) * ``` * @returns True if the JS has been hydrated already, false otherwise. */ export function useHydrated(): boolean { return React.useSyncExternalStore( subscribe, () => true, () => false, ) } function subscribe() { return () => {} }