import { SparkRenderer as SparkRendererClass } from '@sparkjsdev/spark';
/**
 * Global hook to get or create a SparkRenderer instance.
 *
 * This hook ensures only one SparkRenderer exists in the scene:
 * 1. First checks the global cache for an existing instance
 * 2. If not cached, traverses the scene to find an existing SparkRenderer
 * 3. If not found, creates a new SparkRenderer and adds it to the scene
 * 4. Caches the instance for fast subsequent access
 *
 * SparkRenderer has minimal overhead even without 3DGS content in the scene,
 * so it's safe to always create one when any virtual camera is added.
 *
 * @returns The SparkRenderer instance (always non-null)
 *
 * @example
 * // In any virtual camera component
 * const sparkRenderer = useSparkRenderer();
 */
export declare function useSparkRenderer(): SparkRendererClass;
/**
 * Get the cached SparkRenderer without searching the scene.
 * This is the fastest way to check if SparkRenderer exists.
 *
 * @returns The cached SparkRenderer instance, or null if none cached
 */
export declare function getSparkRenderer(): SparkRendererClass | null;