@react-three/fiber 10.0.0-canary.dc0ec15 → 10.0.0-canary.e53bd54

package/dist/extension.d.ts

@@ -1,1573 +1,13 @@
-import * as React$1 from 'react';
-import { ReactNode } from 'react';
-import * as THREE$1 from 'three';
-import { WebGLCubeRenderTarget, WebGLRenderTarget, WebGLRenderer, Color as Color$2, ColorRepresentation as ColorRepresentation$1, Euler as Euler$2, Loader, RenderTargetOptions as RenderTargetOptions$1 } from 'three';
-import * as three_webgpu from 'three/webgpu';
-import { WebGPURenderer, Node, StorageTexture, Storage3DTexture, StorageArrayTexture, Data3DTexture, CanvasTarget, CubeRenderTarget, RenderTarget, Euler as Euler$1, Color as Color$1, ColorRepresentation, Layers as Layers$1, Raycaster, Intersection as Intersection$1, BufferGeometry, Matrix4 as Matrix4$1, Quaternion as Quaternion$1, Object3D, Vector2 as Vector2$1, Vector3 as Vector3$1, Vector4 as Vector4$1, Matrix3 as Matrix3$1 } from 'three/webgpu';
-import { StoreApi } from 'zustand';
-import { UseBoundStoreWithEqualityFn } from 'zustand/traditional';
-import { FrameCallback as FrameCallback$1, FrameTimingState, SchedulerApi, UseFrameNextOptions, FrameNextControls } from '@pmndrs/scheduler';
+import { z as FrameNextCallback } from './shared/fiber.Bw8YnGg5.js';
+export { A as Act, B as Bridge, C as Camera, i as ComputeFunction, w as Disposable, f as DomEvent, D as Dpr, v as EquConfig, g as EventHandlers, k as EventManager, E as Events, h as FilterFunction, G as FrameCallback, x as FrameNextState, y as FrameState, F as Frameloop, a5 as InternalState, I as Intersection, e as IntersectionEvent, p as IsAllOptional, o as IsOptional, M as Mutable, N as NonFunctionKeys, u as ObjectMap, O as Overwrite, c as Performance, l as PointerCaptureTarget, P as PointerState, n as Properties, a4 as R3FRenderer, b as RenderCallback, R as RootExtension, a6 as RootState, d as RootStore, t as SetBlock, a as Size, S as Subscription, q as ThreeCamera, T as ThreeEvent, U as UnblockProps, V as Viewport, m as VisibilityEntry, X as XRManager, j as XRPointerConfig, a3 as context, r as registerRootExtension, s as setRenderOverride, a2 as useStore, a7 as useThree } from './shared/fiber.Bw8YnGg5.js';
+import { UseFrameNextOptions, FrameNextControls } from '@pmndrs/scheduler';
 export { AddPhaseOptions, FrameControls, FrameNextControls, FrameTimingState, RootOptions, SchedulerApi, UseFrameNextOptions, UseFrameOptions } from '@pmndrs/scheduler';
-import * as three_examples_jsm_inspector_Inspector_js from 'three/examples/jsm/inspector/Inspector.js';
-import { WebGLRendererParameters } from 'three/src/renderers/WebGLRenderer.js';
-import { Inspector } from 'three/addons/inspector/Inspector.js';
-import { Options } from 'react-use-measure';
-
-
-//* Utility Types ==============================
-
-type NonFunctionKeys<P> = { [K in keyof P]-?: P[K] extends Function ? never : K }[keyof P]
-type Overwrite<P, O> = Omit<P, NonFunctionKeys<O>> & O
-type Properties<T> = Pick<T, NonFunctionKeys<T>>
-type Mutable<P> = { -readonly [K in keyof P]: P[K] }
-type IsOptional<T> = undefined extends T ? true : false
-type IsAllOptional<T extends any[]> = T extends [infer First, ...infer Rest]
-  ? IsOptional<First> extends true
-    ? IsAllOptional<Rest>
-    : false
-  : true
-
-//* Camera Types ==============================
-
-type ThreeCamera = (THREE$1.OrthographicCamera | THREE$1.PerspectiveCamera) & { manual?: boolean }
-
-//* Act Type ==============================
-
-type Act = <T = any>(cb: () => Promise<T>) => Promise<T>
-
-//* Bridge & Block Types ==============================
-
-type Bridge = React$1.FC<{ children?: React$1.ReactNode }>
-
-type SetBlock = false | Promise<null> | null
-type UnblockProps = { set: React$1.Dispatch<React$1.SetStateAction<SetBlock>>; children: React$1.ReactNode }
-
-//* Object Map Type ==============================
-
-/* Original version
-export interface ObjectMap {
-  nodes: { [name: string]: THREE.Object3D }
-  materials: { [name: string]: THREE.Material }
-  meshes: { [name: string]: THREE.Mesh }
-}
-*/
-/* This version is an expansion found in a PR by itsdouges that seems abandoned but looks useful.
-It allows expansion but falls back to the original shape. (deleted due to stale, but If it doesnt conflict
-I will keep the use here)
-https://github.com/pmndrs/react-three-fiber/commits/generic-object-map/
-His description is:
-The object map type is now generic and can optionally declare the available properties for nodes, materials, and meshes.
-*/
-interface ObjectMap<
-  T extends { nodes?: string; materials?: string; meshes?: string } = {
-    nodes: string
-    materials: string
-    meshes: string
-  },
-> {
-  nodes: Record<T['nodes'] extends string ? T['nodes'] : string, THREE$1.Object3D>
-  materials: Record<T['materials'] extends string ? T['materials'] : string, THREE$1.Material>
-  meshes: Record<T['meshes'] extends string ? T['meshes'] : string, THREE$1.Mesh>
-}
-
-//* Equality Config ==============================
-
-interface EquConfig {
-  /** Compare arrays by reference equality a === b (default), or by shallow equality */
-  arrays?: 'reference' | 'shallow'
-  /** Compare objects by reference equality a === b (default), or by shallow equality */
-  objects?: 'reference' | 'shallow'
-  /** If true the keys in both a and b must match 1:1 (default), if false a's keys must intersect b's */
-  strict?: boolean
-}
-
-//* Disposable Type ==============================
-
-interface Disposable {
-  type?: string
-  dispose?: () => void
-}
-
-//* Event-related Types =====================================
-
-interface Intersection extends THREE$1.Intersection {
-  /** The event source (the object which registered the handler) */
-  eventObject: THREE$1.Object3D
-}
-
-type Camera = THREE$1.OrthographicCamera | THREE$1.PerspectiveCamera
-
-interface IntersectionEvent<TSourceEvent> extends Intersection {
-  /** The event source (the object which registered the handler) */
-  eventObject: THREE$1.Object3D
-  /** An array of intersections */
-  intersections: Intersection[]
-  /** vec3.set(pointer.x, pointer.y, 0).unproject(camera) */
-  unprojectedPoint: THREE$1.Vector3
-  /** Normalized event coordinates */
-  pointer: THREE$1.Vector2
-  /** pointerId of the original event for multiple pointer events */
-  pointerId: number
-  /** Delta between first click and this event */
-  delta: number
-  /** The ray that pierced it */
-  ray: THREE$1.Ray
-  /** The camera that was used by the raycaster */
-  camera: Camera
-  /** stopPropagation will stop underlying handlers from firing */
-  stopPropagation: () => void
-  /** The original host event */
-  nativeEvent: TSourceEvent
-  /** If the event was stopped by calling stopPropagation */
-  stopped: boolean
-}
-
-type ThreeEvent<TEvent> = IntersectionEvent<TEvent> & Properties<TEvent>
-type DomEvent = PointerEvent | MouseEvent | WheelEvent
-
-/** DOM event handlers registered on the canvas element */
-interface Events {
-  onClick: EventListener
-  onContextMenu: EventListener
-  onDoubleClick: EventListener
-  onWheel: EventListener
-  onPointerDown: EventListener
-  onPointerUp: EventListener
-  onPointerLeave: EventListener
-  onPointerMove: EventListener
-  onPointerCancel: EventListener
-  onLostPointerCapture: EventListener
-  onDragEnter: EventListener
-  onDragLeave: EventListener
-  onDragOver: EventListener
-  onDrop: EventListener
-}
-
-/** Event handlers that can be attached to R3F objects (meshes, groups, etc.) */
-interface EventHandlers {
-  onClick?: (event: ThreeEvent<MouseEvent>) => void
-  onContextMenu?: (event: ThreeEvent<MouseEvent>) => void
-  onDoubleClick?: (event: ThreeEvent<MouseEvent>) => void
-  /** Fires continuously while dragging over the object */
-  onDragOver?: (event: ThreeEvent<DragEvent>) => void
-  /** Fires once when drag enters the object */
-  onDragOverEnter?: (event: ThreeEvent<DragEvent>) => void
-  /** Fires once when drag leaves the object */
-  onDragOverLeave?: (event: ThreeEvent<DragEvent>) => void
-  /** Fires when drag misses this object (for objects that have drag handlers) */
-  onDragOverMissed?: (event: DragEvent) => void
-  /** Fires when a drop occurs on this object */
-  onDrop?: (event: ThreeEvent<DragEvent>) => void
-  /** Fires when a drop misses this object (for objects that have drop handlers) */
-  onDropMissed?: (event: DragEvent) => void
-  onPointerUp?: (event: ThreeEvent<PointerEvent>) => void
-  onPointerDown?: (event: ThreeEvent<PointerEvent>) => void
-  onPointerOver?: (event: ThreeEvent<PointerEvent>) => void
-  onPointerOut?: (event: ThreeEvent<PointerEvent>) => void
-  onPointerEnter?: (event: ThreeEvent<PointerEvent>) => void
-  onPointerLeave?: (event: ThreeEvent<PointerEvent>) => void
-  onPointerMove?: (event: ThreeEvent<PointerEvent>) => void
-  onPointerMissed?: (event: MouseEvent) => void
-  onPointerCancel?: (event: ThreeEvent<PointerEvent>) => void
-  onWheel?: (event: ThreeEvent<WheelEvent>) => void
-  onLostPointerCapture?: (event: ThreeEvent<PointerEvent>) => void
-
-  //* Visibility Events --------------------------------
-  /** Fires when object enters/exits camera frustum. Receives true when in view, false when out. */
-  onFramed?: (inView: boolean) => void
-  /** Fires when object occlusion state changes (WebGPU only, requires occlusionTest=true on object) */
-  onOccluded?: (occluded: boolean) => void
-  /** Fires when combined visibility changes (frustum + occlusion + visible prop) */
-  onVisible?: (visible: boolean) => void
-}
-
-type FilterFunction = (items: THREE$1.Intersection[], state: RootState) => THREE$1.Intersection[]
-type ComputeFunction = (event: DomEvent, root: RootState, previous?: RootState) => void
-
-/** Configuration for XR pointer registration (controllers/hands) */
-interface XRPointerConfig {
-  /** Ray origin (updated each frame by XR system) */
-  ray: THREE$1.Ray
-  /** Optional: custom compute function for this pointer */
-  compute?: (state: RootState) => void
-  /** Pointer type identifier */
-  type: 'controller' | 'hand' | 'gaze'
-  /** Which hand (for controller/hand types) */
-  handedness?: 'left' | 'right'
-}
-
-interface EventManager<TTarget> {
-  /** Determines if the event layer is active */
-  enabled: boolean
-  /** Event layer priority, higher prioritized layers come first and may stop(-propagate) lower layer  */
-  priority: number
-  /** The compute function needs to set up the raycaster and an xy- pointer  */
-  compute?: ComputeFunction
-  /** The filter can re-order or re-structure the intersections  */
-  filter?: FilterFunction
-  /** The target node the event layer is tied to */
-  connected?: TTarget
-  /** All the pointer event handlers through which the host forwards native events */
-  handlers?: Events
-  /** Allows re-connecting to another target */
-  connect?: (target: TTarget) => void
-  /** Removes all existing events handlers from the target */
-  disconnect?: () => void
-  /** Triggers a onPointerMove with the last known event. This can be useful to enable raycasting without
-   *  explicit user interaction, for instance when the camera moves a hoverable object underneath the cursor.
-   *  @param pointerId - Optional pointer ID to update specific pointer only
-   */
-  update?: (pointerId?: number) => void
-  /** Defer pointer move raycasting to frame start (default: true) */
-  frameTimedRaycasts?: boolean
-  /** Always fire raycaster immediately on scroll events (default: true) */
-  alwaysFireOnScroll?: boolean
-  /** Automatically re-raycast every frame to detect hover changes from moving objects/camera (default: false) */
-  updateOnFrame?: boolean
-  /** Flush deferred pointer raycasts. Called by scheduler at frame start (input phase). */
-  flush?: () => void
-  /** Register an XR pointer (controller/hand). Returns assigned pointerId */
-  registerPointer?: (config: XRPointerConfig) => number
-  /** Unregister an XR pointer */
-  unregisterPointer?: (pointerId: number) => void
-}
-
-interface PointerCaptureTarget {
-  intersection: Intersection
-  target: Element
-}
-
-//* Visibility System Types =====================================
-
-/** Entry in the visibility registry for tracking object visibility state */
-interface VisibilityEntry {
-  object: THREE$1.Object3D
-  handlers: Pick<EventHandlers, 'onFramed' | 'onOccluded' | 'onVisible'>
-  lastFramedState: boolean | null
-  lastOccludedState: boolean | null
-  lastVisibleState: boolean | null
-}
-
-//* Scheduler Types (useFrame) ==============================
-//
-// The generic, framework-agnostic scheduler types now live in @pmndrs/scheduler.
-// This file re-exports them and layers r3f's RootState-aware frame state on top,
-// so existing `#types` imports across the codebase keep resolving unchanged.
-
-
-
-// Frame State (r3f-specific) --------------------------------
-
-/**
- * State passed to useFrame callbacks (extends RootState with timing).
- */
-interface FrameNextState extends RootState, FrameTimingState {}
-
-/** Alias for FrameNextState */
-type FrameState = FrameNextState
-
-// Callback Types (r3f-specific) --------------------------------
-
-/**
- * Callback function for useFrame. Receives the full r3f RootState plus timing.
- */
-type FrameNextCallback = FrameCallback$1<RootState>
-
-/** Alias for FrameNextCallback */
-type FrameCallback = FrameNextCallback
-
-//* Buffer Types (useBuffers) ========================================
-
-/**
- * Buffer-like types for GPU compute and storage operations.
- * Includes raw CPU arrays, Three.js buffer attributes, and TSL buffer nodes.
- *
- * @example
- * ```tsx
- * const { positions, velocities } = useBuffers(() => ({
- *   positions: instancedArray(count, 'vec3'),       // StorageBufferNode
- *   velocities: new Float32Array(count * 3),        // TypedArray
- * }), 'particles')
- * ```
- */
-type BufferLike =
-  | Float32Array
-  | Uint32Array
-  | Int32Array
-  | Float64Array
-  | Uint8Array
-  | Int8Array
-  | Uint16Array
-  | Int16Array
-  | THREE$1.BufferAttribute // Base class for all buffer attributes
-  | THREE$1.InterleavedBufferAttribute
-  | Node // TSL buffer nodes (instancedArray, storage)
-
-/** Flat record of buffer-like values (no nested scopes) */
-type BufferRecord = Record<string, BufferLike>
-
-/**
- * Buffer store that can contain both root-level buffers and scoped buffer objects.
- * Structure: { positions: Float32Array, particles: { vel: StorageBufferNode } }
- */
-type BufferStore = Record<string, BufferLike | BufferRecord>
-
-//* Node Types (useNodes) ========================================
-
-/**
- * Every node representation `useNodes` accepts and `state.nodes` holds: three's real `Node`,
- * the callable proxy `Fn()` returns, and the legacy structural shape (`uuid`/`nodeType`) older
- * code passes through. Creators are constrained to this same type, so the shape a creator returns
- * and the shape the store holds are one type by construction.
- */
-type NodeLike = TSLNodeType | LegacyTSLNodeLike
-
-/** Flat record of TSL nodes (no nested scopes) */
-type NodeRecord<T extends NodeLike = NodeLike> = Record<string, T>
-
-/**
- * Node store that can contain both root-level nodes and scoped node objects.
- * Structure: { wobble: OperatorNode, fx: { blur: ShaderCallable } }
- */
-type NodeStore = Record<string, NodeLike | NodeRecord>
-
-//* Storage Types (useGPUStorage) ========================================
-
-/**
- * GPU storage types for texture-based storage operations.
- * Includes Three.js storage textures and TSL storage texture nodes.
- *
- * @example
- * ```tsx
- * const { heightMap } = useGPUStorage(() => ({
- *   heightMap: new StorageTexture(512, 512),
- * }), 'terrain')
- * ```
- */
-type StorageLike =
-  | StorageTexture // 2D GPU storage texture
-  | Storage3DTexture // 3D GPU storage texture (volumes, fluid grids)
-  | StorageArrayTexture // 2D-array GPU storage texture
-  | Data3DTexture // 3D texture (can be used as storage)
-  | Node // TSL storage texture nodes (storageTexture)
-
-/** Flat record of storage-like values (no nested scopes) */
-type StorageRecord = Record<string, StorageLike>
-
-/**
- * Storage store that can contain both root-level storage and scoped storage objects.
- * Structure: { heightMap: StorageTexture, terrain: { normal: StorageTextureNode } }
- */
-type StorageStore = Record<string, StorageLike | StorageRecord>
-
-//* Renderer Types ========================================
-
-/** Default renderer type - union of WebGL and WebGPU renderers */
-type R3FRenderer = THREE$1.WebGLRenderer | WebGPURenderer
-
-//* Core Store Types ========================================
-
-type Subscription = {
-  ref: React$1.RefObject<RenderCallback>
-  priority: number
-  store: RootStore
-}
-
-/** Per-pointer state for multi-touch and XR support */
-type PointerState = {
-  /** Objects currently hovered by this pointer */
-  hovered: Map<string, ThreeEvent<DomEvent>>
-  /** Objects capturing this pointer */
-  captured: Map<THREE$1.Object3D, PointerCaptureTarget>
-  /** Initial click position [x, y] */
-  initialClick: [x: number, y: number]
-  /** Objects hit on initial click */
-  initialHits: THREE$1.Object3D[]
-}
-
-type Dpr = number | [min: number, max: number]
-
-interface Size {
-  width: number
-  height: number
-  top: number
-  left: number
-}
-
-type Frameloop = 'always' | 'demand' | 'never'
-
-interface Viewport extends Size {
-  /** The initial pixel ratio */
-  initialDpr: number
-  /** Current pixel ratio */
-  dpr: number
-  /** size.width / viewport.width */
-  factor: number
-  /** Camera distance */
-  distance: number
-  /** Camera aspect ratio: width / height */
-  aspect: number
-}
-
-type RenderCallback = (state: RootState, delta: number, frame?: XRFrame) => void
-
-interface Performance {
-  /** Current performance normal, between min and max */
-  current: number
-  /** How low the performance can go, between 0 and max */
-  min: number
-  /** How high the performance can go, between min and max */
-  max: number
-  /** Time until current returns to max in ms */
-  debounce: number
-  /** Sets current to min, puts the system in regression */
-  regress: () => void
-}
-
-interface InternalState {
-  interaction: THREE$1.Object3D[]
-  subscribers: Subscription[]
-  /** Per-pointer state (hover, capture, click tracking) - replaces hovered, capturedMap, initialClick, initialHits */
-  pointerMap: Map<number, PointerState>
-  /** Pointers needing raycast this frame (used with frameTimedRaycasts) */
-  pointerDirty: Map<number, DomEvent>
-  /** Last event received (for events.update() compatibility) */
-  lastEvent: React$1.RefObject<DomEvent | null>
-  /** @deprecated Use pointerMap.get(pointerId).hovered instead */
-  hovered: Map<string, ThreeEvent<DomEvent>>
-  /** @deprecated Use pointerMap.get(pointerId).captured instead */
-  capturedMap: Map<number, Map<THREE$1.Object3D, PointerCaptureTarget>>
-  /** @deprecated Use pointerMap.get(pointerId).initialClick instead */
-  initialClick: [x: number, y: number]
-  /** @deprecated Use pointerMap.get(pointerId).initialHits instead */
-  initialHits: THREE$1.Object3D[]
-  /** Visibility event registry (onFramed, onOccluded, onVisible) */
-  visibilityRegistry: Map<string, VisibilityEntry>
-  /** Whether occlusion queries are enabled (WebGPU only) */
-  occlusionEnabled: boolean
-  /** Reference to the invisible occlusion observer mesh */
-  occlusionObserver: THREE$1.Mesh | null
-  /** Cached occlusion results from render pass - keyed by Object3D */
-  occlusionCache: Map<THREE$1.Object3D, boolean | null>
-  /** Internal helper group for R3F system objects (occlusion observer, etc.) */
-  helperGroup: THREE$1.Group | null
-  active: boolean
-  priority: number
-  frames: number
-  subscribe: (callback: React$1.RefObject<RenderCallback>, priority: number, store: RootStore) => () => void
-  /** Internal renderer storage - use state.renderer or state.gl to access */
-  actualRenderer: R3FRenderer
-  /** Global scheduler reference (for useFrame hook) */
-  scheduler: SchedulerApi | null
-  /**
-   * Replaces `renderer.render(scene, camera)` in the default render job when set. Set it with
-   * `setRenderOverride(store, fn)`; the job keeps its fps throttle, error handling and user
-   * render-phase takeover. Used by `useRenderPipeline`.
-   */
-  renderOverride?: (() => void) | null
-  /** This root's unique ID in the global scheduler */
-  rootId?: string
-  /** Function to unregister this root from the global scheduler */
-  unregisterRoot?: () => void
-  /** Container for child attachment (scene for root, original container for portals) */
-  container?: THREE$1.Object3D
-  /**
-   * The CanvasTarget this root sizes and renders through.
-   *
-   * A primary (`<Canvas id>`) owns the renderer's default target -- the one three itself built
-   * around the canvas element -- so sizing it is sizing the renderer. A secondary owns a target
-   * R3F created for its own element. Either way there is exactly one target per canvas element,
-   * and the canvas-target job makes it the renderer's active one before this root renders.
-   * Absent on WebGL and on an id-less WebGPU canvas, where the renderer is sized directly.
-   * @see https://threejs.org/docs/#api/en/renderers/common/CanvasTarget
-   */
-  canvasTarget?: CanvasTarget
-  /**
-   * Set when this root's canvas target has been resized and the backend's cached render pass
-   * descriptor (which holds a depth-stencil view built once per canvas) is therefore stale.
-   *
-   * Flushed by the canvas-target job in the `start` phase, which is the only place this root's
-   * target is guaranteed to be the renderer's active one — `backend.updateSize()` operates on
-   * whatever `getCanvasTarget()` returns, so calling it from the resize subscription would
-   * invalidate some other canvas's descriptor instead.
-   *
-   * @see https://github.com/pmndrs/react-three-fiber/issues/3847
-   */
-  canvasTargetSizeDirty?: boolean
-  /**
-   * Whether multi-canvas rendering is active.
-   * True when any canvas uses `renderer={{ primaryCanvas: 'id' }}` to share a renderer.
-   * When true, setCanvasTarget is called before each render.
-   */
-  isMultiCanvas?: boolean
-  /**
-   * Whether this canvas is a secondary canvas sharing another's renderer.
-   * True when `target` prop is used.
-   */
-  isSecondary?: boolean
-  /**
-   * The id of the primary canvas this secondary canvas targets.
-   * Only set when isSecondary is true.
-   */
-  targetId?: string
-  /**
-   * Function to unregister this primary canvas from the registry.
-   * Only set when this canvas has an `id` prop.
-   */
-  unregisterPrimary?: () => void
-  /** Whether canvas dimensions are forced to even numbers */
-  forceEven?: boolean
-}
-
-interface XRManager {
-  connect: () => void
-  disconnect: () => void
-}
-
-//* Root State Interface ====================================
-
-interface RootState {
-  /** Set current state */
-  set: StoreApi<RootState>['setState']
-  /** Get current state */
-  get: StoreApi<RootState>['getState']
-  /**
-   * Reference to the authoritative store for shared TSL resources (uniforms, nodes, etc).
-   * - For primary/independent canvases: points to its own store (self-reference)
-   * - For secondary canvases: points to the primary canvas's store
-   *
-   * Hooks like useNodes/useUniforms should read from primaryStore to ensure
-   * consistent shared state across all canvases sharing a renderer.
-   */
-  primaryStore: RootStore
-  /** @deprecated Use `renderer` instead. The instance of the renderer (typed as WebGLRenderer for backwards compat) */
-  gl: THREE$1.WebGLRenderer
-  /** The renderer instance - type depends on entry point (WebGPU, Legacy, or union for default) */
-  renderer: R3FRenderer
-  /** Inspector of the webGPU Renderer. Init in the canvas */
-  inspector: any // Inspector type from three/webgpu
-
-  /** Default camera */
-  camera: ThreeCamera
-  /** Camera frustum for visibility checks - auto-updated each frame when autoUpdateFrustum is true */
-  frustum: THREE$1.Frustum
-  /** Whether to automatically update the frustum each frame (default: true) */
-  autoUpdateFrustum: boolean
-  /** Default scene (may be overridden in portals to point to the portal container) */
-  scene: THREE$1.Scene
-  /** The actual root THREE.Scene - always points to the true scene, even inside portals */
-  rootScene: THREE$1.Scene
-  /** Default raycaster */
-  raycaster: THREE$1.Raycaster
-  /** Event layer interface, contains the event handler and the node they're connected to */
-  events: EventManager<any>
-  /** XR interface */
-  xr: XRManager
-  /** Currently used controls */
-  controls: THREE$1.EventDispatcher | null
-  /** Normalized event coordinates */
-  pointer: THREE$1.Vector2
-  /** @deprecated Normalized event coordinates, use "pointer" instead! */
-  mouse: THREE$1.Vector2
-  /** Color space assigned to 8-bit input textures (color maps). Most textures are authored in sRGB. */
-  textureColorSpace: THREE$1.ColorSpace
-  /** Render loop flags */
-  frameloop: Frameloop
-  performance: Performance
-  /** Reactive pixel-size of the canvas */
-  size: Size
-  /** Reactive size of the viewport in threejs units */
-  viewport: Viewport & {
-    getCurrentViewport: (
-      camera?: ThreeCamera,
-      target?: THREE$1.Vector3 | Parameters<THREE$1.Vector3['set']>,
-      size?: Size,
-    ) => Omit<Viewport, 'dpr' | 'initialDpr'>
-  }
-  /** Flags the canvas for render, but doesn't render in itself */
-  invalidate: (frames?: number, stackFrames?: boolean) => void
-  /** Advance (render) one step */
-  advance: (timestamp: number, runGlobalEffects?: boolean) => void
-  /** Shortcut to setting the event layer */
-  setEvents: (events: Partial<EventManager<any>>) => void
-  /** Shortcut to manual sizing. No args resets to props/container. Single arg creates square. */
-  setSize: (width?: number, height?: number, top?: number, left?: number) => void
-  /** Shortcut to manual setting the pixel ratio */
-  setDpr: (dpr: Dpr) => void
-  /** Shortcut to setting frameloop flags. No args resets to 'always'. */
-  setFrameloop: (frameloop?: Frameloop) => void
-  /** Set error state to propagate to error boundary */
-  setError: (error: Error | null) => void
-  /** Current error state (null when no error) */
-  error: Error | null
-  /** Global TSL uniform nodes - root-level uniforms + scoped sub-objects. Use useUniforms() hook */
-  uniforms: UniformStore
-  /** Global TSL nodes - root-level nodes + scoped sub-objects. Use useNodes() hook */
-  nodes: NodeStore
-  /** Global TSL buffer nodes - root-level buffers + scoped sub-objects. Use useBuffers() hook */
-  buffers: BufferStore
-  /** Global GPU storage (textures, etc.) - root-level storage + scoped sub-objects. Use useGPUStorage() hook */
-  gpuStorage: StorageStore
-  /** Global Texture registry (key → Texture, usually keyed by URL) - use useTextures() hook for access + lifecycle */
-  textures: Map<string, THREE$1.Texture>
-  /** Internal: refcount per texture key, driven by mounted useTexture consumers (registry enrollment is on by default) */
-  _textureRefs: Map<string, number>
-  /** WebGPU RenderPipeline instance - use useRenderPipeline() hook */
-  renderPipeline: ThreeRenderPipeline | null
-  /** Global TSL pass nodes for render pipeline - use useRenderPipeline() hook */
-  passes: PassRecord
-  /** Internal version counter for HMR - incremented by rebuildNodes/rebuildUniforms to bust memoization */
-  _hmrVersion: number
-  /** Internal: whether setSize() has taken ownership of canvas dimensions */
-  _sizeImperative: boolean
-  /** Internal: stored size props from Canvas for reset functionality */
-  _sizeProps: { width?: number; height?: number } | null
-  /** When the canvas was clicked but nothing was hit */
-  onPointerMissed?: (event: MouseEvent) => void
-  /** When a dragover event has missed any target */
-  onDragOverMissed?: (event: DragEvent) => void
-  /** When a drop event has missed any target */
-  onDropMissed?: (event: DragEvent) => void
-  /** If this state model is layered (via createPortal) then this contains the previous layer */
-  previousRoot?: RootStore
-  /** Internals */
-  internal: InternalState
-  // flags for triggers
-  // if we are using the webGl renderer, this will be true
-  isLegacy: boolean
-  // regardless of renderer, if the system supports webGpu, this will be true
-  webGPUSupported: boolean
-  //if we are on native
-  isNative: boolean
-}
-
-type RootStore = UseBoundStoreWithEqualityFn<StoreApi<RootState>>
-
-/**
- * @fileoverview Internal Three.js re-exports - DEFAULT ENTRY
- *
- * This is the single source of truth for Three.js imports within R3F.
- * All internal code should import from '#three' (or '../three' relative).
- *
- * DEFAULT behavior (root import):
- * - Exports from three/webgpu (the new standard)
- * - Also exports WebGLRenderer for backwards compatibility (with deprecation)
- * - Both renderer types available, runtime decides which to use
- *
- * For explicit legacy or webgpu-only builds, use:
- * - #three/legacy - WebGL only, no WebGPU
- * - #three/webgpu - WebGPU only, no WebGL legacy
- */
-declare const R3F_BUILD_LEGACY = true;
-declare const R3F_BUILD_WEBGPU = true;
-
-/** Lazily load the three Inspector. Keeps it out of the eager module graph — see note above. */
-declare function loadInspector(): Promise<typeof three_examples_jsm_inspector_Inspector_js.Inspector>;
-
-
-type MutableOrReadonlyParameters<T extends (...args: any) => any> = Parameters<T> | Readonly<Parameters<T>>
-
-interface MathRepresentation {
-  set(...args: number[]): any
-}
-interface VectorRepresentation extends MathRepresentation {
-  setScalar(value: number): any
-}
-type MathTypes = MathRepresentation | Euler$1 | Color$1
-
-type MathType<T extends MathTypes> = T extends Color$1
-  ? Args<typeof Color$1> | ColorRepresentation
-  : T extends VectorRepresentation | Layers$1 | Euler$1
-    ? T | MutableOrReadonlyParameters<T['set']> | number
-    : T | MutableOrReadonlyParameters<T['set']>
-
-type MathProps<P> = {
-  [K in keyof P as P[K] extends MathTypes ? K : never]: P[K] extends MathTypes ? MathType<P[K]> : never
-}
-
-type Vector2 = MathType<Vector2$1>
-type Vector3 = MathType<Vector3$1>
-type Vector4 = MathType<Vector4$1>
-type Color = MathType<Color$1>
-type Layers = MathType<Layers$1>
-type Quaternion = MathType<Quaternion$1>
-type Euler = MathType<Euler$1>
-type Matrix3 = MathType<Matrix3$1>
-type Matrix4 = MathType<Matrix4$1>
-
-interface RaycastableRepresentation {
-  raycast(raycaster: Raycaster, intersects: Intersection$1[]): void
-}
-type EventProps<P> = P extends RaycastableRepresentation ? Partial<EventHandlers> : {}
-
-/**
- * Props for geometry transform methods that can be called with `once()`.
- * These methods modify the geometry in-place and only make sense to call once on mount.
- *
- * @example
- * import { once } from '@react-three/fiber'
- *
- * <boxGeometry args={[1, 1, 1]} rotateX={once(Math.PI / 2)} />
- * <planeGeometry args={[10, 10]} translate={once(0, 0, 5)} />
- * <bufferGeometry applyMatrix4={once(matrix)} center={once()} />
- */
-interface GeometryTransformProps {
-  /** Rotate the geometry about the X axis (radians). Use with once(). */
-  rotateX?: number
-  /** Rotate the geometry about the Y axis (radians). Use with once(). */
-  rotateY?: number
-  /** Rotate the geometry about the Z axis (radians). Use with once(). */
-  rotateZ?: number
-  /** Translate the geometry (x, y, z). Use with once(). */
-  translate?: [x: number, y: number, z: number]
-  /** Scale the geometry (x, y, z). Use with once(). */
-  scale?: [x: number, y: number, z: number]
-  /** Center the geometry based on bounding box. Use with once(). */
-  center?: true
-  /** Apply a Matrix4 transformation. Use with once(). */
-  applyMatrix4?: Matrix4$1
-  /** Apply a Quaternion rotation. Use with once(). */
-  applyQuaternion?: Quaternion$1
-}
-
-type GeometryProps<P> = P extends BufferGeometry ? GeometryTransformProps : {}
-
-/**
- * Workaround for @types/three TSL node type issues.
- * The Node base class has properties that subclasses (OperatorNode, ConstNode, etc.) don't inherit.
- * This transforms `Node | null` properties to accept any object with node-like shape.
- */
-type TSLNodeInput = { nodeType?: string | null; uuid?: string } | null
-
-/**
- * For node material properties (colorNode, positionNode, etc.), accept broader types
- * since @types/three has broken inheritance for TSL node subclasses. NodeClass requires
- * `nodeType`, so this structural key test remains neutral to the selected Three entry.
- */
-type NodeProps<P> = {
-  [K in keyof P as NonNullable<P[K]> extends { nodeType: string | null } ? K : never]?: TSLNodeInput
-}
-
-interface ReactProps<P> {
-  children?: React.ReactNode
-  ref?: React.Ref<P>
-  key?: React.Key
-}
-
-type ElementProps<T extends ConstructorRepresentation, P = InstanceType<T>> = Partial<
-  Overwrite<P, MathProps<P> & ReactProps<P> & EventProps<P> & GeometryProps<P> & NodeProps<P>>
->
-
-type ThreeElement<T extends ConstructorRepresentation> = Mutable<
-  Overwrite<ElementProps<T>, Omit<InstanceProps<InstanceType<T>, T>, 'object'>>
->
-
-type ThreeToJSXElements<T extends Record<string, any>> = {
-  [K in keyof T & string as Uncapitalize<K>]: T[K] extends ConstructorRepresentation ? ThreeElement<T[K]> : never
-}
-
-/** Method names of Object3D, excluded from the `primitive` element's typed props. */
-type Object3DMethod = NonNullable<
-  {
-    [K in keyof Object3D]-?: Object3D[K] extends (...args: any[]) => any ? K : never
-  }[keyof Object3D]
->
-
-type ThreeExports = typeof import('three') & typeof import('three/webgpu')
-type ThreeElementsImpl = ThreeToJSXElements<ThreeExports>
-
-interface ThreeElements extends Omit<ThreeElementsImpl, 'audio' | 'source' | 'line' | 'path'> {
-  /**
-   * `primitive` wraps a pre-existing object, so its props cannot be derived from one class.
-   * Events are typed from `EventHandlers` (`onClick={(e) => ...}` infers `e`), the ref is
-   * untyped, and any other prop is accepted and applied to the object by name. Object3D's own
-   * methods are left out of the typed surface: they return `this`, so a subclass element's
-   * props (`ThreeElements['group']`) could not be spread onto a primitive otherwise.
-   */
-  primitive: Omit<ThreeElement<typeof Object3D>, 'args' | 'object' | 'ref' | Object3DMethod> & {
-    object: object
-    ref?: React.Ref<any>
-    [prop: string]: unknown
-  }
-  // Conflicts with DOM types can be accessed through a three* prefix
-  threeAudio: ThreeElementsImpl['audio']
-  threeSource: ThreeElementsImpl['source']
-  threeLine: ThreeElementsImpl['line']
-  threePath: ThreeElementsImpl['path']
-}
-
-declare module 'react' {
-  namespace JSX {
-    interface IntrinsicElements extends ThreeElements {}
-  }
-}
-
-declare module 'react/jsx-runtime' {
-  namespace JSX {
-    interface IntrinsicElements extends ThreeElements {}
-  }
-}
-
-declare module 'react/jsx-dev-runtime' {
-  namespace JSX {
-    interface IntrinsicElements extends ThreeElements {}
-  }
-}
-
-//* Base Renderer Types =====================================
-
-// Shim for OffscreenCanvas since it was removed from DOM types
-interface OffscreenCanvas extends EventTarget {}
-
-interface BaseRendererProps {
-  canvas: HTMLCanvasElement | OffscreenCanvas
-  powerPreference?: 'high-performance' | 'low-power' | 'default'
-  antialias?: boolean
-  alpha?: boolean
-}
-
-type RendererFactory<TRenderer, TParams> =
-  | TRenderer
-  | ((defaultProps: TParams) => TRenderer)
-  | ((defaultProps: TParams) => Promise<TRenderer>)
-
-interface Renderer {
-  render: (scene: THREE$1.Scene, camera: THREE$1.Camera) => any
-}
-
-//* Color Management Config ==============================
-
-/**
- * Color management configuration shared by both WebGL and WebGPU renderers.
- */
-interface ColorManagementConfig {
-  /**
-   * Color space assigned to 8-bit input textures (color maps).
-   * Defaults to sRGB. Most textures are authored in sRGB.
-   * @default THREE.SRGBColorSpace
-   */
-  textureColorSpace?: THREE$1.ColorSpace
-}
-
-//* WebGL Renderer Props ==============================
-
-type DefaultGLProps = Omit<THREE$1.WebGLRendererParameters, 'canvas'> & {
-  canvas: HTMLCanvasElement | OffscreenCanvas
-}
-
-type GLProps =
-  | Renderer
-  | ((defaultProps: DefaultGLProps) => Renderer)
-  | ((defaultProps: DefaultGLProps) => Promise<Renderer>)
-  | (Partial<Properties<THREE$1.WebGLRenderer> | THREE$1.WebGLRendererParameters> & ColorManagementConfig)
-
-//* WebGPU Renderer Props ==============================
-
-type DefaultRendererProps = {
-  canvas: HTMLCanvasElement | OffscreenCanvas
-  [key: string]: any
-}
-
-/**
- * Canvas-level scheduler configuration.
- * Controls render timing relative to other canvases.
- */
-interface CanvasSchedulerConfig {
-  /**
-   * Run this Canvas root before the referenced Canvas root id(s).
-   */
-  before?: string | string[]
-  /**
-   * Run this Canvas root after the referenced Canvas root id(s).
-   */
-  after?: string | string[]
-  /**
-   * Numeric root order. Lower values run first.
-   */
-  order?: number
-  /**
-   * Limit this Canvas's default render job (frames per second).
-   */
-  fps?: number
-}
-
-/**
- * Extended renderer configuration for multi-canvas support and color management.
- */
-interface RendererConfigExtended extends ColorManagementConfig {
-  /** Share renderer from another canvas (WebGPU only) */
-  primaryCanvas?: string
-  /** Canvas-level scheduler options */
-  scheduler?: CanvasSchedulerConfig
-}
-
-type RendererProps =
-  | any // WebGPURenderer
-  | ((defaultProps: DefaultRendererProps) => any)
-  | ((defaultProps: DefaultRendererProps) => Promise<any>)
-  | (Partial<Properties<any> | Record<string, any>> & RendererConfigExtended)
-
-//* Camera Props ==============================
-
-type CameraProps = (
-  | THREE$1.Camera
-  | Partial<
-      ThreeElement<typeof THREE$1.Camera> &
-        ThreeElement<typeof THREE$1.PerspectiveCamera> &
-        ThreeElement<typeof THREE$1.OrthographicCamera>
-    >
-) & {
-  /** Flags the camera as manual, putting projection into your own hands */
-  manual?: boolean
-}
-
-//* Render Props ==============================
-
-interface RenderProps<TCanvas extends HTMLCanvasElement | OffscreenCanvas> {
-  /**
-   * Unique identifier for multi-canvas renderer sharing.
-   * Makes this canvas targetable by other canvases using the `primaryCanvas` prop.
-   * Also sets the HTML `id` attribute on the canvas element.
-   * @example <Canvas id="main-viewer">...</Canvas>
-   */
-  id?: string
-  /**
-   * Share the renderer from another canvas instead of creating a new one.
-   * Pass the `id` of the primary canvas to share its WebGPURenderer.
-   * Only available with WebGPU (not legacy WebGL).
-   *
-   * Note: This is extracted from `renderer={{ primaryCanvas: "id" }}` by Canvas.
-   * @internal
-   */
-  primaryCanvas?: string
-  /**
-   * Canvas-level scheduler options. Controls render timing relative to other canvases.
-   *
-   * Note: This is extracted from `renderer={{ scheduler: {...} }}` by Canvas.
-   * @internal
-   */
-  scheduler?: CanvasSchedulerConfig
-  /** A threejs renderer instance or props that go into the default renderer */
-  gl?: GLProps
-  /** A WebGPU renderer instance or props that go into the default renderer */
-  renderer?: RendererProps
-  /** Dimensions to fit the renderer to. Will measure canvas dimensions if omitted */
-  size?: Size
-  /**
-   * Enables shadows (by default PCFsoft). Can accept `gl.shadowMap` options for fine-tuning,
-   * but also strings: 'basic' | 'percentage' | 'soft' | 'variance'.
-   * @see https://threejs.org/docs/#api/en/renderers/WebGLRenderer.shadowMap
-   */
-  shadows?: boolean | 'basic' | 'percentage' | 'soft' | 'variance' | Partial<THREE$1.WebGLShadowMap>
-  /** Creates an orthographic camera */
-  orthographic?: boolean
-  /**
-   * R3F's render mode. Set to `demand` to only render on state change or `never` to take control.
-   * @see https://docs.pmnd.rs/react-three-fiber/advanced/scaling-performance#on-demand-rendering
-   */
-  frameloop?: Frameloop
-  /**
-   * R3F performance options for adaptive performance.
-   * @see https://docs.pmnd.rs/react-three-fiber/advanced/scaling-performance#movement-regression
-   */
-  performance?: Partial<Omit<Performance, 'regress'>>
-  /** Target pixel ratio. Can clamp between a range: `[min, max]` */
-  dpr?: Dpr
-  /**
-   * Props that go into the default raycaster. `params` is merged into the raycaster's defaults,
-   * so a single threshold can be set: `raycaster={{ params: { Points: { threshold: 0.2 } } }}`.
-   */
-  raycaster?: Partial<Omit<THREE$1.Raycaster, 'params'>> & { params?: Partial<THREE$1.RaycasterParameters> }
-  /** A `THREE.Scene` instance or props that go into the default scene */
-  scene?: THREE$1.Scene | Partial<THREE$1.Scene>
-  /** A `THREE.Camera` instance or props that go into the default camera */
-  camera?: CameraProps
-  /** An R3F event manager to manage elements' pointer events */
-  events?: (store: RootStore) => EventManager<Element>
-  /** Callback after the canvas has rendered (but not yet committed) */
-  onCreated?: (state: RootState) => void
-  /** Response for pointer clicks that have missed any target */
-  onPointerMissed?: (event: MouseEvent) => void
-  /** Response for dragover events that have missed any target */
-  onDragOverMissed?: (event: DragEvent) => void
-  /** Response for drop events that have missed any target */
-  onDropMissed?: (event: DragEvent) => void
-  /** Whether to automatically update the frustum each frame (default: true) */
-  autoUpdateFrustum?: boolean
-  /**
-   * Enable WebGPU occlusion queries for onOccluded/onVisible events.
-   * Auto-enabled when any object uses onOccluded or onVisible handlers.
-   * Only works with WebGPU renderer - WebGL will log a warning.
-   */
-  occlusion?: boolean
-  /** Internal: stored size props from Canvas for reset functionality */
-  _sizeProps?: { width?: number; height?: number } | null
-  /** Force canvas dimensions to even numbers (fixes Safari rendering issues with odd/fractional sizes) */
-  forceEven?: boolean
-}
-
-//* Reconciler Root ==============================
-
-interface ReconcilerRoot<TCanvas extends HTMLCanvasElement | OffscreenCanvas> {
-  configure: (config?: RenderProps<TCanvas>) => Promise<ReconcilerRoot<TCanvas>>
-  render: (element: ReactNode) => RootStore
-  unmount: () => void
-}
-
-//* Inject State ==============================
-
-type InjectState = Partial<
-  Omit<RootState, 'events'> & {
-    events?: {
-      enabled?: boolean
-      priority?: number
-      compute?: ComputeFunction
-      connected?: any
-    }
-    /**
-     * When true (default), injects a THREE.Scene between container and children if container isn't already a Scene.
-     * This ensures state.scene is always a real THREE.Scene with proper properties (background, environment, fog).
-     * Set to false to use the container directly as scene (anti-pattern, but supported for edge cases).
-     */
-    injectScene?: boolean
-  }
->
-
-//* Reconciler Types ==============================
-
-// FiberRoot is an opaque internal React type - we define it locally
-// to avoid bundling @types/react-reconciler which causes absolute path issues
-type FiberRoot = any
-
-interface Root {
-  fiber: FiberRoot
-  store: RootStore
-}
-
-type AttachFnType<O = any> = (parent: any, self: O) => () => void
-type AttachType<O = any> = string | AttachFnType<O>
-
-type ConstructorRepresentation<T = any> = new (...args: any[]) => T
-
-interface Catalogue {
-  [name: string]: ConstructorRepresentation
-}
-
-// TODO: handle constructor overloads
-// https://github.com/pmndrs/react-three-fiber/pull/2931
-// https://github.com/microsoft/TypeScript/issues/37079
-type Args<T> = T extends ConstructorRepresentation
-  ? T extends typeof Color$2
-    ? [r: number, g: number, b: number] | [color: ColorRepresentation$1]
-    : ConstructorParameters<T>
-  : any[]
-
-type ArgsProp<P> = P extends ConstructorRepresentation
-  ? IsAllOptional<ConstructorParameters<P>> extends true
-    ? { args?: Args<P> }
-    : { args: Args<P> }
-  : { args: unknown[] }
-
-type InstanceProps<T = any, P = any> = ArgsProp<P> & {
-  object?: T
-  dispose?: null
-  attach?: AttachType<T>
-}
-
-interface Instance<O = any> {
-  root: RootStore
-  type: string
-  parent: Instance | null
-  children: Instance[]
-  props: InstanceProps<O> & Record<string, unknown>
-  object: O & { __r3f?: Instance<O> }
-  eventCount: number
-  handlers: Partial<EventHandlers>
-  attach?: AttachType<O>
-  previousAttach?: any
-  isHidden: boolean
-  /** Set of props that have been applied via once() */
-  appliedOnce?: Set<string>
-}
-
-interface HostConfig {
-  type: string
-  props: Instance['props']
-  container: RootStore
-  instance: Instance
-  textInstance: void
-  suspenseInstance: Instance
-  hydratableInstance: never
-  formInstance: never
-  publicInstance: Instance['object']
-  hostContext: {}
-  childSet: never
-  timeoutHandle: number | undefined
-  noTimeout: -1
-  TransitionStatus: null
-}
-declare global {
-  var IS_REACT_ACT_ENVIRONMENT: boolean | undefined
-}
-
-//* Loop Types ==============================
-
-type GlobalRenderCallback = (timestamp: number) => void
-
-type GlobalEffectType = 'before' | 'after' | 'tail'
-
-declare const presetsObj: {
-    apartment: string;
-    city: string;
-    dawn: string;
-    forest: string;
-    lobby: string;
-    night: string;
-    park: string;
-    studio: string;
-    sunset: string;
-    warehouse: string;
-};
-type PresetsType = keyof typeof presetsObj;
-
-//* Background Types ==============================
-
-/**
- * Expanded object form for background configuration.
- * Allows separate textures for background (visual backdrop) and environment (PBR lighting).
- */
-interface BackgroundConfig {
-  /** HDRI preset name: 'apartment', 'city', 'dawn', 'forest', 'lobby', 'night', 'park', 'studio', 'sunset', 'warehouse' */
-  preset?: PresetsType
-  /** Files for cube texture (6 faces) or single HDR/EXR */
-  files?: string | string[]
-  /** Separate files for scene.background (visual backdrop) */
-  backgroundMap?: string | string[]
-  backgroundRotation?: Euler$2 | [number, number, number]
-  backgroundBlurriness?: number
-  backgroundIntensity?: number
-  /** Separate files for scene.environment (PBR lighting/reflections) */
-  envMap?: string | string[]
-  environmentRotation?: Euler$2 | [number, number, number]
-  environmentIntensity?: number
-  path?: string
-  extensions?: (loader: Loader) => void
-}
-
-/**
- * Background prop type for Canvas.
- *
- * String detection priority:
- * 1. Preset - exact match against known presets (apartment, city, dawn, forest, lobby, night, park, studio, sunset, warehouse)
- * 2. URL - starts with /, ./, ../, http://, https://, OR has image extension
- * 3. Color - default fallback (CSS color names, hex values, rgb(), etc.)
- *
- * @example Color
- * ```tsx
- * <Canvas background="red" />
- * <Canvas background="#ff0000" />
- * <Canvas background={0xff0000} />
- * ```
- *
- * @example Preset
- * ```tsx
- * <Canvas background="city" />
- * ```
- *
- * @example URL
- * ```tsx
- * <Canvas background="/path/to/env.hdr" />
- * <Canvas background="./sky.jpg" />
- * ```
- *
- * @example Object form
- * ```tsx
- * <Canvas background={{
- *   files: ['px.png', 'nx.png', 'py.png', 'ny.png', 'pz.png', 'nz.png'],
- *   backgroundMap: 'path/to/sky.jpg',
- *   envMap: 'path/to/lighting.hdr',
- *   backgroundBlurriness: 0.5,
- * }} />
- * ```
- */
-type BackgroundProp =
-  | ColorRepresentation$1 // "red", "#ff0000", 0xff0000
-  | string // URL or preset
-  | BackgroundConfig // Expanded object form
-
-//* Canvas Types ==============================
-
-interface CanvasProps
-  extends
-    Omit<RenderProps<HTMLCanvasElement>, 'size' | 'primaryCanvas' | 'scheduler'>,
-    React$1.HTMLAttributes<HTMLDivElement> {
-  children?: React$1.ReactNode
-  ref?: React$1.Ref<HTMLCanvasElement>
-  /** Canvas fallback content, similar to img's alt prop */
-  fallback?: React$1.ReactNode
-  /**
-   * Options to pass to useMeasure.
-   * @see https://github.com/pmndrs/react-use-measure#api
-   */
-  resize?: Options
-  /** The target where events are being subscribed to, default: the div that wraps canvas */
-  eventSource?: Element | React$1.RefObject<Element | null>
-  /** The event prefix that is cast into canvas pointer x/y events, default: "offset" */
-  eventPrefix?: 'offset' | 'client' | 'page' | 'layer' | 'screen'
-  /** Enable/disable automatic HMR refresh for TSL nodes and uniforms, default: true in dev */
-  hmr?: boolean
-  /** Canvas resolution width in pixels. If omitted, uses container width. */
-  width?: number
-  /** Canvas resolution height in pixels. If omitted, uses container height. */
-  height?: number
-  /** Force canvas dimensions to even numbers (fixes Safari rendering issues with odd/fractional sizes) */
-  forceEven?: boolean
-  /**
-   * Scene background configuration.
-   * Accepts colors, URLs, presets, or an expanded object for separate background/environment.
-   * @see BackgroundProp for full documentation and examples
-   */
-  background?: BackgroundProp
-}
-
-//* Loader Types ==============================
-
-type InputLike = string | string[] | string[][] | Readonly<string | string[] | string[][]>
-
-// Define a loader-like interface that matches THREE.Loader's load signature
-// This works for both generic and non-generic THREE.Loader instances
-interface LoaderLike {
-  load(
-    url: InputLike,
-    onLoad?: (result: any) => void,
-    onProgress?: (event: ProgressEvent<EventTarget>) => void,
-    onError?: (error: unknown) => void,
-  ): any
-}
-
-type GLTFLike = { scene: THREE$1.Object3D }
-
-type LoaderInstance<T extends LoaderLike | ConstructorRepresentation<LoaderLike>> =
-  T extends ConstructorRepresentation<LoaderLike> ? InstanceType<T> : T
-
-// Infer result type from the load method's callback parameter
-type InferLoadResult<T> = T extends {
-  load(url: any, onLoad?: (result: infer R) => void, ...args: any[]): any
-}
-  ? R
-  : T extends ConstructorRepresentation<any>
-    ? InstanceType<T> extends {
-        load(url: any, onLoad?: (result: infer R) => void, ...args: any[]): any
-      }
-      ? R
-      : any
-    : any
-
-type LoaderResult<T extends LoaderLike | ConstructorRepresentation<LoaderLike>> =
-  InferLoadResult<LoaderInstance<T>> extends infer R ? (R extends GLTFLike ? R & ObjectMap : R) : never
-
-type Extensions<T extends LoaderLike | ConstructorRepresentation<LoaderLike>> = (
-  loader: LoaderInstance<T>,
-) => void
-
-//* Renderer Props ========================================
-
-type WebGLDefaultProps = Omit<THREE$1.WebGLRendererParameters, 'canvas'> & BaseRendererProps
-
-type WebGLProps =
-  | RendererFactory<THREE$1.WebGLRenderer, WebGLDefaultProps>
-  | Partial<Properties<THREE$1.WebGLRenderer> | THREE$1.WebGLRendererParameters>
-
-interface WebGLShadowConfig {
-  shadows?: boolean | 'basic' | 'percentage' | 'soft' | 'variance' | Partial<THREE$1.WebGLShadowMap>
-}
-
-//* Legacy-specific Types ========================================
-
-/** Legacy (WebGL) renderer type - re-exported as R3FRenderer from @react-three/fiber/legacy */
-type LegacyRenderer = THREE$1.WebGLRenderer
-
-/** Legacy internal state with narrowed renderer type */
-interface LegacyInternalState extends Omit<InternalState, 'actualRenderer'> {
-  actualRenderer: THREE$1.WebGLRenderer
-}
-
-/**
- * Legacy-specific RootState with narrowed renderer type.
- * Automatically used when importing from `@react-three/fiber/legacy`.
- *
- * @example
- * ```tsx
- * import { useThree } from '@react-three/fiber/legacy'
- *
- * function MyComponent() {
- *   const { renderer } = useThree()
- *   // renderer is typed as THREE.WebGLRenderer
- *   renderer.shadowMap.enabled = true
- * }
- * ```
- */
-interface LegacyRootState extends Omit<RootState, 'renderer' | 'internal'> {
-  /** The WebGL renderer instance */
-  renderer: THREE$1.WebGLRenderer
-  /** Internals with WebGL renderer */
-  internal: LegacyInternalState
-}
-
-//* RenderTarget Types ==============================
-
-
-type RenderTargetOptions = RenderTargetOptions$1
-
-//* Global TSL Types ==============================
-
-declare global {
-  /**
-   * Broad callable-node fallback for dynamic store readers.
-   * Creator hooks preserve the exact function signatures inferred from Three's `Fn`.
-   */
-  type CallableTSLNode = ((...params: never[]) => unknown) & {
-    readonly shaderNode: unknown
-    readonly id: number
-  }
-
-  /** Legacy structural node accepted when at least one historical marker exists. */
-  type LegacyTSLNodeLike = {
-    label?: ((label: string) => unknown) | string
-    setName?: (name: string) => unknown
-  } & ({ uuid: string | undefined; nodeType?: string | null } | { uuid?: string; nodeType: string | null | undefined })
-
-  /** Node type accepted by broad dynamic node-store readers. */
-  type TSLNodeType = three_webgpu.Node | CallableTSLNode
-
-  /**
-   * Derive Three's shader node type from an existing node or a supported raw input.
-   * Existing InputNode generics take precedence over structural value normalization.
-   * Both generics must be inferred because Three's UniformNode intersects an unknown-typed
-   * InputNode base with its concrete InputNode specialization.
-   */
-  type UniformNodeType<T> = T extends three_webgpu.UniformNode<infer TNodeType, infer _TValue>
-    ? TNodeType
-    : T extends three_webgpu.InputNode<infer TNodeType, infer _TValue>
-      ? TNodeType
-      : T extends number
-        ? 'float'
-        : T extends boolean
-          ? 'bool'
-          : T extends string | three_webgpu.Color | { r: number; g: number; b: number }
-            ? 'color'
-            : T extends three_webgpu.Vector4 | { x: number; y: number; z: number; w: number }
-              ? 'vec4'
-              : T extends three_webgpu.Vector3 | { x: number; y: number; z: number }
-                ? 'vec3'
-                : T extends three_webgpu.Vector2 | { x: number; y: number }
-                  ? 'vec2'
-                  : T extends three_webgpu.Matrix4
-                    ? 'mat4'
-                    : T extends three_webgpu.Matrix3
-                      ? 'mat3'
-                      : T extends three_webgpu.Matrix2
-                        ? 'mat2'
-                        : unknown
-
-  /** Derive the normalized JavaScript value stored by a uniform node. */
-  type UniformNodeValue<T> = T extends three_webgpu.UniformNode<infer _TNodeType, infer TValue>
-    ? TValue
-    : T extends three_webgpu.InputNode<infer _TNodeType, infer TValue>
-      ? TValue
-      : T extends string | { r: number; g: number; b: number }
-        ? three_webgpu.Color
-        : T extends { x: number; y: number; z: number; w: number }
-          ? three_webgpu.Vector4
-          : T extends { x: number; y: number; z: number }
-            ? three_webgpu.Vector3
-            : T extends { x: number; y: number }
-              ? three_webgpu.Vector2
-              : T extends number
-                ? number
-                : T extends boolean
-                  ? boolean
-                  : T
-
-  /** Three's exact UniformNode with shader and value generics derived from an input. */
-  type UniformNodeFor<T> = three_webgpu.UniformNode<UniformNodeType<T>, UniformNodeValue<T>>
-
-  /** Preserve every input key while mapping values to exact Three uniform nodes. */
-  type UniformNodesFor<T extends UniformInputRecord> = {
-    [K in keyof T]: UniformNodeFor<T[K]>
-  }
-
-  /** Backward-compatible single-parameter uniform alias. */
-  type UniformNode<T = unknown> = UniformNodeFor<T>
-
-  /** Flat record of uniform nodes (no nested scopes) */
-  type UniformRecord<T extends UniformNode = UniformNode> = Record<string, T>
-
-  /**
-   * Uniform store that can contain both root-level uniforms and scoped uniform objects
-   * Used by state.uniforms which has structure like:
-   * { uTime: UniformNode, player: { uHealth: UniformNode }, enemy: { uHealth: UniformNode } }
-   */
-  type UniformStore = Record<string, UniformNode | UniformRecord>
-
-  /**
-   * Helper to safely access a uniform node from the store.
-   * Use this when accessing state.uniforms to get proper typing.
-   * @example
-   * const uTime = uniforms.uTime as UniformNode<number>
-   * const uColor = uniforms.uColor as UniformNode<import('three/webgpu').Color>
-   */
-  type GetUniform<T = unknown> = UniformNode<T>
-
-  /**
-   * Acceptable input values for useUniforms - raw values that get converted to UniformNodes
-   * Supports:
-   * - Primitives: number, string (color), boolean
-   * - Three.js types: Color, Vector2/3/4, Matrix2/3/4
-   * - Plain objects: { x, y, z, w } converted to vectors
-   * - TSL nodes: color(), vec3(), float() for type casting
-   * - UniformNode: existing uniforms (reused as-is)
-   */
-  type UniformValue =
-    | number
-    | string
-    | boolean
-    | three_webgpu.Color
-    | three_webgpu.Vector2
-    | three_webgpu.Vector3
-    | three_webgpu.Vector4
-    | three_webgpu.Matrix2
-    | three_webgpu.Matrix3
-    | three_webgpu.Matrix4
-    | { x: number; y: number }
-    | { x: number; y: number; z: number }
-    | { x: number; y: number; z: number; w: number }
-    | { r: number; g: number; b: number; a?: number } // Plain objects converted to Color
-    | three_webgpu.Node // TSL nodes like color(), vec3(), float() for type casting
-    | UniformNode
-
-  /** Input record for useUniforms - accepts raw values or UniformNodes */
-  type UniformInputRecord = Record<string, UniformValue>
-}
-
-declare global {
-  /**
-   * three's own render pipeline type. Named here so the rest of R3F refers to three's shape
-   * rather than `any`. three r183 renamed `PostProcessing` to `RenderPipeline`; our peer floor
-   * is r185, so the new name is the only one.
-   */
-  type ThreeRenderPipeline = three_webgpu.RenderPipeline
-
-  /**
-   * The pass `useRenderPipeline` creates for you: three's own `PassNode`, as returned by
-   * `pass(scene, camera)` from `three/tsl`. Referenced from three so members like
-   * `getTextureNode`, `setMRT` and `dispose` track the installed version.
-   */
-  type ScenePassNode = three_webgpu.PassNode
-
-  /**
-   * Pass record - stores TSL pass nodes for render pipeline.
-   *
-   * `scenePass` is the only key the library owns. It is optional here because this is also the
-   * shape of `state.passes`, which is `{}` before the pipeline exists and again after `reset()`
-   * or `clearPasses()`. Inside the callbacks it is always present; see
-   * {@link RenderPipelineCallbackState}.
-   *
-   * Every other key is user-registered, via a callback's return value. Those are TSL nodes of
-   * any kind, not only passes: texture reads of an MRT attachment, effect nodes, extra
-   * `pass()` instances. `Node` is the common base, so that is the bound. Narrow at the call
-   * site when you need a member, e.g. `passes.velocity as TextureNode`.
-   *
-   * The index signature admits `undefined` because a key may simply not be registered, and
-   * because the optional `scenePass` must be assignable to it: under `skipLibCheck: false` an
-   * optional property whose type excludes `undefined` from the index signature is an error
-   * (TS2411) for every consumer compiling these declarations.
-   */
-  interface PassRecord {
-    scenePass?: ScenePassNode
-    [key: string]: three_webgpu.Node | undefined
-  }
-
-  /**
-   * State passed to pipeline callbacks after the active pipeline has been created.
-   *
-   * `passes.scenePass` is required here: the hook installs the default scene pass before either
-   * callback runs, so callbacks can use it without a guard or a cast.
-   *
-   * `renderer` is narrowed to `WebGPURenderer` and `isLegacy` to `false`: the hook throws under
-   * the legacy renderer before either callback can run, so a callback never sees WebGL.
-   */
-  type RenderPipelineCallbackState = RootState & {
-    renderPipeline: ThreeRenderPipeline
-    passes: PassRecord & { scenePass: ScenePassNode }
-    renderer: three_webgpu.WebGPURenderer
-    isLegacy: false
-  }
-
-  /**
-   * What a callback may return to register entries into `state.passes`.
-   *
-   * `scenePass` is reserved. The hook owns that entry and its lifecycle: it caches the pass it
-   * created, and `rebuild()` / `reset()` dispose that cached pass. A callback overwriting the
-   * store entry would leave the store pointing at a node the hook never disposes, and the hook
-   * disposing a pass nothing references. So returning it is a type error.
-   */
-  type RegisteredPasses = Record<string, three_webgpu.Node> & { scenePass?: never }
-
-  /** Setup callback - runs first to configure MRT, create additional passes */
-  type RenderPipelineSetupCallback = (state: RenderPipelineCallbackState) => RegisteredPasses | void
-
-  /** Main callback - runs second to configure outputNode, create effect passes */
-  type RenderPipelineMainCallback = (state: RenderPipelineCallbackState) => RegisteredPasses | void
-
-  /** The imperative half of useRenderPipeline's return value, present in every state */
-  interface UseRenderPipelineActions {
-    /** Current passes from state */
-    passes: PassRecord
-    /** Clear all passes from state */
-    clearPasses: () => void
-    /** Reset RenderPipeline entirely (clears PP + passes) */
-    reset: () => void
-    /** Re-run setup/main callbacks with current closure values */
-    rebuild: () => void
-  }
-
-  /**
-   * Return type for useRenderPipeline hook, discriminated on `isReady`.
-   *
-   * `if (isReady)` narrows `renderPipeline` to non-null, which is what the docs already tell
-   * callers to check. `passes.scenePass` deliberately stays optional in the ready branch:
-   * `clearPasses()` empties the record while leaving the pipeline in place.
-   */
-  type UseRenderPipelineReturn = UseRenderPipelineActions &
-    (
-      | {
-          /** True when RenderPipeline is configured and ready */
-          isReady: true
-          /** RenderPipeline instance */
-          renderPipeline: ThreeRenderPipeline
-        }
-      | {
-          /** False until the pipeline has been created */
-          isReady: false
-          /** Not initialized yet, or torn down by reset() */
-          renderPipeline: null
-        }
-    )
-}
-
-declare const context: React$1.Context<RootStore>;
-
-/**
- * Returns the R3F Canvas' Zustand store. Useful for [transient updates](https://github.com/pmndrs/zustand#transient-updates-for-often-occurring-state-changes).
- * @see https://docs.pmnd.rs/react-three-fiber/api/hooks#usestore
- */
-declare function useStore(): RootStore;
-/**
- * Accesses R3F's internal state, containing renderer, canvas, scene, etc.
- * @see https://docs.pmnd.rs/react-three-fiber/api/hooks#usethree
- */
-declare function useThree<T = RootState>(selector?: (state: RootState) => T, equalityFn?: <T>(state: T, newState: T) => boolean): T;
+import 'react';
+import 'three';
+import 'three/webgpu';
+import 'zustand';
+import 'zustand/traditional';
+import 'three/tsl';
 
 /**
  * Frame hook with phase-based ordering, priority, and FPS throttling.
@@ -1613,35 +53,4 @@ declare function useThree<T = RootState>(selector?: (state: RootState) => T, equ
  */
 declare function useFrame(callback?: FrameNextCallback, priorityOrOptions?: number | UseFrameNextOptions): FrameNextControls;
 
-interface RootExtension {
-    /** Unique name. Registering the same name again replaces the entry (HMR-safe); roots it already
-     *  set up are not set up a second time, but get the new entry's dispose and hmr. */
-    name: string;
-    /**
-     * Called once per root, after its renderer exists and before `onCreated` and the first frame.
-     * `isLegacy` and `primaryStore` are known by then, so an extension can skip WebGL roots or defer
-     * to the primary canvas. Return fields to merge into the root's state, or nothing.
-     */
-    setup?(store: RootStore): Partial<RootState> | void;
-    /** Called when a root this extension set up unmounts. */
-    dispose?(store: RootStore): void;
-    /** Called when `<Canvas>` detects hot module replacement (skipped with `hmr={false}`). */
-    hmr?(store: RootStore): void;
-}
-/**
- * Register an extension. It is set up on every live root immediately, and on every root created
- * afterwards. Returns a function that unregisters it: new roots are no longer set up, while roots
- * it already set up keep its state and still get its dispose when they unmount.
- */
-declare function registerRootExtension(extension: RootExtension): () => void;
-/**
- * Point a root's default render job at a different render function, or back at
- * `renderer.render(scene, camera)` with `null`.
- *
- * The default job keeps everything else: the Canvas `fps` throttle, error propagation to the error
- * boundary, and backing off when a user `useFrame(..., { phase: 'render' })` job takes over.
- */
-declare function setRenderOverride(store: RootStore, render: (() => void) | null): void;
-
-export { context, registerRootExtension, setRenderOverride, useFrame, useStore, useThree };
-export type { Act, Args, ArgsProp, AttachFnType, AttachType, BackgroundConfig, BackgroundProp, BaseRendererProps, Bridge, BufferLike, BufferRecord, BufferStore, Camera, CameraProps, CanvasProps, CanvasSchedulerConfig, Catalogue, Color, ColorManagementConfig, ComputeFunction, ConstructorRepresentation, DefaultGLProps, DefaultRendererProps, Disposable, DomEvent, Dpr, ElementProps, EquConfig, Euler, EventHandlers, EventManager, EventProps, Events, Extensions, FiberRoot, FilterFunction, FrameCallback, FrameNextCallback, FrameNextState, FrameState, Frameloop, GLProps, GLTFLike, GeometryProps, GeometryTransformProps, GlobalEffectType, GlobalRenderCallback, HostConfig, InferLoadResult, InjectState, InputLike, Instance, InstanceProps, InternalState, Intersection, IntersectionEvent, IsAllOptional, IsOptional, Layers, LegacyInternalState, LegacyRenderer, LegacyRootState, LoaderInstance, LoaderLike, LoaderResult, MathProps, MathRepresentation, MathType, MathTypes, Matrix3, Matrix4, Mutable, MutableOrReadonlyParameters, NodeLike, NodeProps, NodeRecord, NodeStore, NonFunctionKeys, Object3DMethod, ObjectMap, OffscreenCanvas, Overwrite, Performance, PointerCaptureTarget, PointerState, Properties, Quaternion, R3FRenderer, RaycastableRepresentation, ReactProps, ReconcilerRoot, RenderCallback, RenderProps, RenderTargetOptions, Renderer, RendererConfigExtended, RendererFactory, RendererProps, Root, RootExtension, RootState, RootStore, SetBlock, Size, StorageLike, StorageRecord, StorageStore, Subscription, TSLNodeInput, ThreeCamera, ThreeElement, ThreeElements, ThreeElementsImpl, ThreeEvent, ThreeExports, ThreeToJSXElements, UnblockProps, Vector2, Vector3, Vector4, VectorRepresentation, Viewport, VisibilityEntry, WebGLDefaultProps, WebGLProps, WebGLShadowConfig, XRManager, XRPointerConfig };
+export { FrameNextCallback, useFrame };