@gnsx/react-three-fiber 10.0.1 → 10.0.3

package/dist/webgpu/index.d.ts

@@ -59,1076 +59,1076 @@ var THREE = /*#__PURE__*/_mergeNamespaces({
   WebGLShadowMap: WebGLShadowMap
 }, [three_webgpu]);
 
-//* 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
+//* 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) ==============================
+
+
+
+// Public Options --------------------------------
+
+/**
+ * Options for useFrame hook
+ */
+interface UseFrameNextOptions {
+  /** Optional stable id for the job. Auto-generated if not provided */
+  id?: string
+  /** Named phase to run in. Default: 'update' */
+  phase?: string
+  /** Run before this phase or job id */
+  before?: string | string[]
+  /** Run after this phase or job id */
+  after?: string | string[]
+  /** Priority within phase. Higher runs first. Default: 0 */
+  priority?: number
+  /** Max frames per second for this job */
+  fps?: number
+  /** If true, skip frames when behind. If false, try to catch up. Default: true */
+  drop?: boolean
+  /** Enable/disable without unregistering. Default: true */
+  enabled?: boolean
+}
+
+/** Alias for UseFrameNextOptions */
+type UseFrameOptions = UseFrameNextOptions
+
+/**
+ * Options for addPhase
+ */
+interface AddPhaseOptions {
+  /** Insert this phase before the specified phase */
+  before?: string
+  /** Insert this phase after the specified phase */
+  after?: string
+}
+
+// Frame State --------------------------------
+
+/**
+ * Timing-only state for independent/outside mode (no RootState)
+ */
+interface FrameTimingState {
+  /** High-resolution timestamp from RAF (ms) */
+  time: number
+  /** Time since last frame in seconds (for legacy compatibility with THREE.Clock) */
+  delta: number
+  /** Elapsed time since first frame in seconds (for legacy compatibility with THREE.Clock) */
+  elapsed: number
+  /** Incrementing frame counter */
+  frame: number
+}
+
+/**
+ * State passed to useFrame callbacks (extends RootState with timing)
+ */
+interface FrameNextState extends RootState, FrameTimingState {}
+
+/** Alias for FrameNextState */
+type FrameState = FrameNextState
+
+// Root Options --------------------------------
+
+/**
+ * Options for registerRoot
+ */
+interface RootOptions {
+  /** State provider for callbacks. Optional in independent mode. */
+  getState?: () => any
+  /** Error handler for job errors. Falls back to console.error if not provided. */
+  onError?: (error: Error) => void
+}
+
+// Callback Types --------------------------------
+
+/**
+ * Callback function for useFrame
+ */
+type FrameNextCallback = (state: FrameNextState, delta: number) => void
+
+/** Alias for FrameNextCallback */
+type FrameCallback = FrameNextCallback
+
+// Controls returned from useFrame --------------------------------
+
+/**
+ * Controls object returned from useFrame hook
+ */
+interface FrameNextControls {
+  /** The job's unique ID */
+  id: string
+  /** Access to the global scheduler for frame loop control */
+  scheduler: SchedulerApi
+  /** Manually step this job only (bypasses FPS limiting) */
+  step(timestamp?: number): void
+  /** Manually step ALL jobs in the scheduler */
+  stepAll(timestamp?: number): void
+  /** Pause this job (set enabled=false) */
+  pause(): void
+  /** Resume this job (set enabled=true) */
+  resume(): void
+  /** Reactive paused state - automatically triggers re-render when changed */
+  isPaused: boolean
+}
+
+/** Alias for FrameNextControls */
+type FrameControls = FrameNextControls
+
+// Scheduler Interface --------------------------------
+
+/**
+ * Public interface for the global Scheduler
+ */
+interface SchedulerApi {
+  //* Phase Management --------------------------------
+
+  /** Add a named phase to the scheduler */
+  addPhase(name: string, options?: AddPhaseOptions): void
+  /** Get the ordered list of phase names */
+  readonly phases: string[]
+  /** Check if a phase exists */
+  hasPhase(name: string): boolean
+
+  //* Root Management --------------------------------
+
+  /** Register a root (Canvas) with the scheduler. Returns unsubscribe function. */
+  registerRoot(id: string, options?: RootOptions): () => void
+  /** Unregister a root */
+  unregisterRoot(id: string): void
+  /** Generate a unique root ID */
+  generateRootId(): string
+  /** Get the number of registered roots */
+  getRootCount(): number
+  /** Check if any root is registered and ready */
+  readonly isReady: boolean
+  /** Subscribe to root-ready event. Fires immediately if already ready. Returns unsubscribe. */
+  onRootReady(callback: () => void): () => void
+
+  //* Job Registration --------------------------------
+
+  /** Register a job with the scheduler (returns unsubscribe function) */
+  register(
+    callback: FrameNextCallback,
+    options?: {
+      id?: string
+      rootId?: string
+      phase?: string
+      before?: string | string[]
+      after?: string | string[]
+      priority?: number
+      fps?: number
+      drop?: boolean
+      enabled?: boolean
+    },
+  ): () => void
+  /** Update a job's options */
+  updateJob(
+    id: string,
+    options: {
+      priority?: number
+      fps?: number
+      drop?: boolean
+      enabled?: boolean
+      phase?: string
+      before?: string | string[]
+      after?: string | string[]
+    },
+  ): void
+  /** Unregister a job by ID */
+  unregister(id: string, rootId?: string): void
+  /** Get the number of registered jobs */
+  getJobCount(): number
+  /** Get all job IDs */
+  getJobIds(): string[]
+
+  //* Global Jobs (for legacy addEffect/addAfterEffect) --------------------------------
+
+  /** Register a global job (runs once per frame, not per-root). Returns unsubscribe function. */
+  registerGlobal(phase: 'before' | 'after', id: string, callback: (timestamp: number) => void): () => void
+
+  //* Idle Callbacks (for legacy addTail) --------------------------------
+
+  /** Register an idle callback (fires when loop stops). Returns unsubscribe function. */
+  onIdle(callback: (timestamp: number) => void): () => void
+
+  //* Frame Loop Control --------------------------------
+
+  /** Start the scheduler loop */
+  start(): void
+  /** Stop the scheduler loop */
+  stop(): void
+  /** Check if the scheduler is running */
+  readonly isRunning: boolean
+  /** Get/set the frameloop mode ('always', 'demand', 'never') */
+  frameloop: Frameloop
+  /** Independent mode - runs without Canvas, callbacks receive timing-only state */
+  independent: boolean
+
+  //* Manual Stepping --------------------------------
+
+  /** Manually step all jobs once (for frameloop='never' or testing) */
+  step(timestamp?: number): void
+  /** Manually step a single job by ID */
+  stepJob(id: string, timestamp?: number): void
+  /** Request frame(s) to be rendered (for frameloop='demand') */
+  invalidate(frames?: number): void
+
+  //* Per-Job Control --------------------------------
+
+  /** Check if a job is paused */
+  isJobPaused(id: string): boolean
+  /** Pause a job */
+  pauseJob(id: string): void
+  /** Resume a job */
+  resumeJob(id: string): void
+  /** Subscribe to job state changes (for reactive isPaused). Returns unsubscribe function. */
+  subscribeJobState(id: string, listener: () => void): () => void
+}
+
+//* 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
+  | 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>
+
+//* 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 // 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
 }
 
-//* 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
+/** 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[]
 }
 
-//* Scheduler Types (useFrame) ==============================
-
-
-
-// Public Options --------------------------------
-
-/**
- * Options for useFrame hook
- */
-interface UseFrameNextOptions {
-  /** Optional stable id for the job. Auto-generated if not provided */
-  id?: string
-  /** Named phase to run in. Default: 'update' */
-  phase?: string
-  /** Run before this phase or job id */
-  before?: string | string[]
-  /** Run after this phase or job id */
-  after?: string | string[]
-  /** Priority within phase. Higher runs first. Default: 0 */
-  priority?: number
-  /** Max frames per second for this job */
-  fps?: number
-  /** If true, skip frames when behind. If false, try to catch up. Default: true */
-  drop?: boolean
-  /** Enable/disable without unregistering. Default: true */
-  enabled?: boolean
-}
-
-/** Alias for UseFrameNextOptions */
-type UseFrameOptions = UseFrameNextOptions
-
-/**
- * Options for addPhase
- */
-interface AddPhaseOptions {
-  /** Insert this phase before the specified phase */
-  before?: string
-  /** Insert this phase after the specified phase */
-  after?: string
-}
-
-// Frame State --------------------------------
-
-/**
- * Timing-only state for independent/outside mode (no RootState)
- */
-interface FrameTimingState {
-  /** High-resolution timestamp from RAF (ms) */
-  time: number
-  /** Time since last frame in seconds (for legacy compatibility with THREE.Clock) */
-  delta: number
-  /** Elapsed time since first frame in seconds (for legacy compatibility with THREE.Clock) */
-  elapsed: number
-  /** Incrementing frame counter */
-  frame: number
-}
-
-/**
- * State passed to useFrame callbacks (extends RootState with timing)
- */
-interface FrameNextState extends RootState, FrameTimingState {}
-
-/** Alias for FrameNextState */
-type FrameState = FrameNextState
-
-// Root Options --------------------------------
-
-/**
- * Options for registerRoot
- */
-interface RootOptions {
-  /** State provider for callbacks. Optional in independent mode. */
-  getState?: () => any
-  /** Error handler for job errors. Falls back to console.error if not provided. */
-  onError?: (error: Error) => void
-}
-
-// Callback Types --------------------------------
-
-/**
- * Callback function for useFrame
- */
-type FrameNextCallback = (state: FrameNextState, delta: number) => void
-
-/** Alias for FrameNextCallback */
-type FrameCallback = FrameNextCallback
-
-// Controls returned from useFrame --------------------------------
-
-/**
- * Controls object returned from useFrame hook
- */
-interface FrameNextControls {
-  /** The job's unique ID */
-  id: string
-  /** Access to the global scheduler for frame loop control */
-  scheduler: SchedulerApi
-  /** Manually step this job only (bypasses FPS limiting) */
-  step(timestamp?: number): void
-  /** Manually step ALL jobs in the scheduler */
-  stepAll(timestamp?: number): void
-  /** Pause this job (set enabled=false) */
-  pause(): void
-  /** Resume this job (set enabled=true) */
-  resume(): void
-  /** Reactive paused state - automatically triggers re-render when changed */
-  isPaused: boolean
-}
-
-/** Alias for FrameNextControls */
-type FrameControls = FrameNextControls
-
-// Scheduler Interface --------------------------------
-
-/**
- * Public interface for the global Scheduler
- */
-interface SchedulerApi {
-  //* Phase Management --------------------------------
-
-  /** Add a named phase to the scheduler */
-  addPhase(name: string, options?: AddPhaseOptions): void
-  /** Get the ordered list of phase names */
-  readonly phases: string[]
-  /** Check if a phase exists */
-  hasPhase(name: string): boolean
-
-  //* Root Management --------------------------------
-
-  /** Register a root (Canvas) with the scheduler. Returns unsubscribe function. */
-  registerRoot(id: string, options?: RootOptions): () => void
-  /** Unregister a root */
-  unregisterRoot(id: string): void
-  /** Generate a unique root ID */
-  generateRootId(): string
-  /** Get the number of registered roots */
-  getRootCount(): number
-  /** Check if any root is registered and ready */
-  readonly isReady: boolean
-  /** Subscribe to root-ready event. Fires immediately if already ready. Returns unsubscribe. */
-  onRootReady(callback: () => void): () => void
-
-  //* Job Registration --------------------------------
-
-  /** Register a job with the scheduler (returns unsubscribe function) */
-  register(
-    callback: FrameNextCallback,
-    options?: {
-      id?: string
-      rootId?: string
-      phase?: string
-      before?: string | string[]
-      after?: string | string[]
-      priority?: number
-      fps?: number
-      drop?: boolean
-      enabled?: boolean
-    },
-  ): () => void
-  /** Update a job's options */
-  updateJob(
-    id: string,
-    options: {
-      priority?: number
-      fps?: number
-      drop?: boolean
-      enabled?: boolean
-      phase?: string
-      before?: string | string[]
-      after?: string | string[]
-    },
-  ): void
-  /** Unregister a job by ID */
-  unregister(id: string, rootId?: string): void
-  /** Get the number of registered jobs */
-  getJobCount(): number
-  /** Get all job IDs */
-  getJobIds(): string[]
-
-  //* Global Jobs (for legacy addEffect/addAfterEffect) --------------------------------
-
-  /** Register a global job (runs once per frame, not per-root). Returns unsubscribe function. */
-  registerGlobal(phase: 'before' | 'after', id: string, callback: (timestamp: number) => void): () => void
-
-  //* Idle Callbacks (for legacy addTail) --------------------------------
-
-  /** Register an idle callback (fires when loop stops). Returns unsubscribe function. */
-  onIdle(callback: (timestamp: number) => void): () => void
-
-  //* Frame Loop Control --------------------------------
-
-  /** Start the scheduler loop */
-  start(): void
-  /** Stop the scheduler loop */
-  stop(): void
-  /** Check if the scheduler is running */
-  readonly isRunning: boolean
-  /** Get/set the frameloop mode ('always', 'demand', 'never') */
-  frameloop: Frameloop
-  /** Independent mode - runs without Canvas, callbacks receive timing-only state */
-  independent: boolean
-
-  //* Manual Stepping --------------------------------
-
-  /** Manually step all jobs once (for frameloop='never' or testing) */
-  step(timestamp?: number): void
-  /** Manually step a single job by ID */
-  stepJob(id: string, timestamp?: number): void
-  /** Request frame(s) to be rendered (for frameloop='demand') */
-  invalidate(frames?: number): void
-
-  //* Per-Job Control --------------------------------
-
-  /** Check if a job is paused */
-  isJobPaused(id: string): boolean
-  /** Pause a job */
-  pauseJob(id: string): void
-  /** Resume a job */
-  resumeJob(id: string): void
-  /** Subscribe to job state changes (for reactive isPaused). Returns unsubscribe function. */
-  subscribeJobState(id: string, listener: () => void): () => void
+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
+  /** 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
+  /**
+   * CanvasTarget for multi-canvas WebGPU rendering.
+   * Created for all WebGPU canvases to support renderer sharing.
+   * @see https://threejs.org/docs/#api/en/renderers/common/CanvasTarget
+   */
+  canvasTarget?: CanvasTarget
+  /**
+   * Whether multi-canvas rendering is active.
+   * True when any canvas uses `target` prop 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 */
+  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: Record<string, any>
+  /** 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 TSL texture nodes - use useTextures() hook for operations */
+  textures: Map<string, any>
+  /** WebGPU RenderPipeline instance - use useRenderPipeline() hook */
+  renderPipeline: any | null // THREE.PostProcessing (will be THREE.RenderPipeline in future Three.js release)
+  /** Global TSL pass nodes for render pipeline - use useRenderPipeline() hook */
+  passes: Record<string, any>
+  /** 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
 }
 
-//* 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
-  | 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>
-
-//* 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 // 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
-  /** 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
-  /**
-   * CanvasTarget for multi-canvas WebGPU rendering.
-   * Created for all WebGPU canvases to support renderer sharing.
-   * @see https://threejs.org/docs/#api/en/renderers/common/CanvasTarget
-   */
-  canvasTarget?: CanvasTarget
-  /**
-   * Whether multi-canvas rendering is active.
-   * True when any canvas uses `target` prop 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 */
-  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: Record<string, any>
-  /** 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 TSL texture nodes - use useTextures() hook for operations */
-  textures: Map<string, any>
-  /** WebGPU RenderPipeline instance - use useRenderPipeline() hook */
-  renderPipeline: any | null // THREE.PostProcessing (will be THREE.RenderPipeline in future Three.js release)
-  /** Global TSL pass nodes for render pipeline - use useRenderPipeline() hook */
-  passes: Record<string, any>
-  /** 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>>
 
-//* Base Renderer Types =====================================
-
-// Shim for OffscreenCanvas since it was removed from DOM types
-interface OffscreenCanvas$1 extends EventTarget {}
-
-interface BaseRendererProps {
-  canvas: HTMLCanvasElement | OffscreenCanvas$1
-  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$1
-}
-
-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$1
-  [key: string]: any
-}
-
-/**
- * Canvas-level scheduler configuration.
- * Controls render timing relative to other canvases.
- */
-interface CanvasSchedulerConfig {
-  /**
-   * Render this canvas after another canvas completes.
-   * Pass the `id` of another canvas.
-   */
-  after?: string
-  /**
-   * Limit this canvas's render rate (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$1> {
-  /**
-   * 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 */
-  raycaster?: Partial<THREE$1.Raycaster>
-  /** 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<HTMLElement>
-  /** 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$1> {
-  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
-  }
+//* Base Renderer Types =====================================
+
+// Shim for OffscreenCanvas since it was removed from DOM types
+interface OffscreenCanvas$1 extends EventTarget {}
+
+interface BaseRendererProps {
+  canvas: HTMLCanvasElement | OffscreenCanvas$1
+  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$1
+}
+
+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$1
+  [key: string]: any
+}
+
+/**
+ * Canvas-level scheduler configuration.
+ * Controls render timing relative to other canvases.
+ */
+interface CanvasSchedulerConfig {
+  /**
+   * Render this canvas after another canvas completes.
+   * Pass the `id` of another canvas.
+   */
+  after?: string
+  /**
+   * Limit this canvas's render rate (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$1> {
+  /**
+   * 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 */
+  raycaster?: Partial<THREE$1.Raycaster>
+  /** 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<HTMLElement>
+  /** 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$1> {
+  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$1
-    ? [r: number, g: number, b: number] | [color: ColorRepresentation]
-    : 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>
-  onUpdate?: (self: T) => void
-}
-
-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
-  /** Deferred ref props to apply in commitMount */
-  deferredRefs?: Array<{ prop: string; ref: React$1.RefObject<any> }>
-  /** 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
+//* 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$1
+    ? [r: number, g: number, b: number] | [color: ColorRepresentation]
+    : 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>
+  onUpdate?: (self: T) => void
+}
+
+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
+  /** Deferred ref props to apply in commitMount */
+  deferredRefs?: Array<{ prop: string; ref: React$1.RefObject<any> }>
+  /** Set of props that have been applied via once() */
+  appliedOnce?: Set<string>
 }
 
-//* Loop Types ==============================
-
-type GlobalRenderCallback = (timestamp: number) => void
-
+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: {
@@ -1145,647 +1145,647 @@ declare const presetsObj: {
 };
 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$1 | [number, number, number]
-  backgroundBlurriness?: number
-  backgroundIntensity?: number
-  /** Separate files for scene.environment (PBR lighting/reflections) */
-  envMap?: string | string[]
-  environmentRotation?: Euler$1 | [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 // "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?: HTMLElement | React$1.RefObject<HTMLElement | 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
+//* 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$1 | [number, number, number]
+  backgroundBlurriness?: number
+  backgroundIntensity?: number
+  /** Separate files for scene.environment (PBR lighting/reflections) */
+  envMap?: string | string[]
+  environmentRotation?: Euler$1 | [number, number, number]
+  environmentIntensity?: number
+  path?: string
+  extensions?: (loader: Loader) => void
 }
 
-//* 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>,
+/**
+ * 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 // "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?: HTMLElement | React$1.RefObject<HTMLElement | 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
+//* 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>
 }
 
-//* RenderTarget Types ==============================
-
-
+//* 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 Types ==============================
-
-declare global {
-  /** Uniform node type - a Node with a value property (matches Three.js UniformNode) */
-  interface UniformNode<T = unknown> extends Node {
-    value: T
-  }
-
-  /**
-   * ShaderCallable - the return type of Fn()
-   * A callable shader function node that can be invoked with parameters.
-   * The function returns a ShaderNodeObject when called.
-   *
-   * @example
-   * ```tsx
-   * // Define a shader function
-   * const blendColorFn = Fn(([color1, color2, factor]) => {
-   *   return mix(color1, color2, factor)
-   * })
-   *
-   * // Type when retrieving from nodes store
-   * const { blendColorFn } = nodes as { blendColorFn: ShaderCallable }
-   *
-   * // Or with specific return type
-   * const { myFn } = nodes as { myFn: ShaderCallable<THREE.Node> }
-   * ```
-   */
-  type ShaderCallable<R extends Node = Node> = ((...params: unknown[]) => ShaderNodeObject<R>) & Node
-
-  /**
-   * ShaderNodeRef - a ShaderNodeObject wrapper around a Node
-   * This is the common return type for TSL operations (add, mul, sin, etc.)
-   *
-   * @example
-   * ```tsx
-   * const { wobble } = nodes as { wobble: ShaderNodeRef }
-   * ```
-   */
-  type ShaderNodeRef<T extends Node = Node> = ShaderNodeObject<T>
-
-  /**
-   * TSLNodeType - Union of all common TSL node types
-   * Used by ScopedStore to properly type node access from the store.
-   *
-   * Includes:
-   * - Node: base Three.js node type
-   * - ShaderCallable: function nodes created with Fn()
-   * - ShaderNodeObject: wrapped nodes from TSL operations (sin, mul, mix, etc.)
-   *
-   * @example
-   * ```tsx
-   * // In useLocalNodes, nodes are typed as TSLNodeType
-   * const { positionNode, blendColorFn } = useLocalNodes(({ nodes }) => ({
-   *   positionNode: nodes.myPosition,      // Works - Node is in union
-   *   blendColorFn: nodes.myFn,            // Works - ShaderCallable is in union
-   * }))
-   *
-   * // Can narrow with type guard or assertion when needed
-   * if (typeof blendColorFn === 'function') {
-   *   blendColorFn(someColor, 0.5)
-   * }
-   * ```
-   */
-  type TSLNodeType = Node | ShaderCallable<Node> | ShaderNodeObject<Node>
-
-  /** 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, Matrix3/4, Euler, Quaternion
-   * - 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.Matrix3
-    | three_webgpu.Matrix4
-    | three_webgpu.Euler
-    | three_webgpu.Quaternion
-    | { x: number; y?: number; z?: number; w?: number } // Plain objects converted to vectors
-    | { r: number; g: number; b: number; a?: number } // Plain objects converted to Color
-    | 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>
-}
-
-//* Module Augmentation ==============================
-
-declare module 'three/tsl' {
-  /**
-   * Fn with array parameter destructuring
-   * @example Fn(([uv, skew]) => { ... })
-   */
-  export function Fn<R extends Node = Node>(
-    jsFunc: (inputs: ShaderNodeObject<Node>[]) => ShaderNodeObject<R>,
-  ): ShaderCallable<R>
-
-  /**
-   * Fn with object parameter destructuring
-   * @example Fn(({ color, intensity }) => { ... })
-   */
-  export function Fn<T extends Record<string, unknown>, R extends Node = Node>(
-    jsFunc: (inputs: T) => ShaderNodeObject<R>,
-  ): ShaderCallable<R>
-
-  /**
-   * Fn with array params + layout
-   * @example Fn(([a, b]) => { ... }, { layout: [...] })
-   */
-  export function Fn<R extends Node = Node>(
-    jsFunc: (inputs: ShaderNodeObject<Node>[]) => ShaderNodeObject<R>,
-    layout: { layout?: unknown },
-  ): ShaderCallable<R>
-
-  /**
-   * Fn with object params + layout
-   */
-  export function Fn<T extends Record<string, unknown>, R extends Node = Node>(
-    jsFunc: (inputs: T) => ShaderNodeObject<R>,
-    layout: { layout?: unknown },
-  ): ShaderCallable<R>
+//* Global Types ==============================
+
+declare global {
+  /** Uniform node type - a Node with a value property (matches Three.js UniformNode) */
+  interface UniformNode<T = unknown> extends Node {
+    value: T
+  }
+
+  /**
+   * ShaderCallable - the return type of Fn()
+   * A callable shader function node that can be invoked with parameters.
+   * The function returns a ShaderNodeObject when called.
+   *
+   * @example
+   * ```tsx
+   * // Define a shader function
+   * const blendColorFn = Fn(([color1, color2, factor]) => {
+   *   return mix(color1, color2, factor)
+   * })
+   *
+   * // Type when retrieving from nodes store
+   * const { blendColorFn } = nodes as { blendColorFn: ShaderCallable }
+   *
+   * // Or with specific return type
+   * const { myFn } = nodes as { myFn: ShaderCallable<THREE.Node> }
+   * ```
+   */
+  type ShaderCallable<R extends Node = Node> = ((...params: unknown[]) => ShaderNodeObject<R>) & Node
+
+  /**
+   * ShaderNodeRef - a ShaderNodeObject wrapper around a Node
+   * This is the common return type for TSL operations (add, mul, sin, etc.)
+   *
+   * @example
+   * ```tsx
+   * const { wobble } = nodes as { wobble: ShaderNodeRef }
+   * ```
+   */
+  type ShaderNodeRef<T extends Node = Node> = ShaderNodeObject<T>
+
+  /**
+   * TSLNodeType - Union of all common TSL node types
+   * Used by ScopedStore to properly type node access from the store.
+   *
+   * Includes:
+   * - Node: base Three.js node type
+   * - ShaderCallable: function nodes created with Fn()
+   * - ShaderNodeObject: wrapped nodes from TSL operations (sin, mul, mix, etc.)
+   *
+   * @example
+   * ```tsx
+   * // In useLocalNodes, nodes are typed as TSLNodeType
+   * const { positionNode, blendColorFn } = useLocalNodes(({ nodes }) => ({
+   *   positionNode: nodes.myPosition,      // Works - Node is in union
+   *   blendColorFn: nodes.myFn,            // Works - ShaderCallable is in union
+   * }))
+   *
+   * // Can narrow with type guard or assertion when needed
+   * if (typeof blendColorFn === 'function') {
+   *   blendColorFn(someColor, 0.5)
+   * }
+   * ```
+   */
+  type TSLNodeType = Node | ShaderCallable<Node> | ShaderNodeObject<Node>
+
+  /** 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, Matrix3/4, Euler, Quaternion
+   * - 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.Matrix3
+    | three_webgpu.Matrix4
+    | three_webgpu.Euler
+    | three_webgpu.Quaternion
+    | { x: number; y?: number; z?: number; w?: number } // Plain objects converted to vectors
+    | { r: number; g: number; b: number; a?: number } // Plain objects converted to Color
+    | 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>
+}
+
+//* Module Augmentation ==============================
+
+declare module 'three/tsl' {
+  /**
+   * Fn with array parameter destructuring
+   * @example Fn(([uv, skew]) => { ... })
+   */
+  export function Fn<R extends Node = Node>(
+    jsFunc: (inputs: ShaderNodeObject<Node>[]) => ShaderNodeObject<R>,
+  ): ShaderCallable<R>
+
+  /**
+   * Fn with object parameter destructuring
+   * @example Fn(({ color, intensity }) => { ... })
+   */
+  export function Fn<T extends Record<string, unknown>, R extends Node = Node>(
+    jsFunc: (inputs: T) => ShaderNodeObject<R>,
+  ): ShaderCallable<R>
+
+  /**
+   * Fn with array params + layout
+   * @example Fn(([a, b]) => { ... }, { layout: [...] })
+   */
+  export function Fn<R extends Node = Node>(
+    jsFunc: (inputs: ShaderNodeObject<Node>[]) => ShaderNodeObject<R>,
+    layout: { layout?: unknown },
+  ): ShaderCallable<R>
+
+  /**
+   * Fn with object params + layout
+   */
+  export function Fn<T extends Record<string, unknown>, R extends Node = Node>(
+    jsFunc: (inputs: T) => ShaderNodeObject<R>,
+    layout: { layout?: unknown },
+  ): ShaderCallable<R>
+}
+
+/**
+ * RenderPipeline Types for useRenderPipeline hook (WebGPU only)
+ */
+
+
+
+declare global {
+  /** Pass record - stores TSL pass nodes for render pipeline */
+  type PassRecord = Record<string, any>
+
+  /** Setup callback - runs first to configure MRT, create additional passes */
+  type RenderPipelineSetupCallback = (state: RootState) => PassRecord | void
+
+  /** Main callback - runs second to configure outputNode, create effect passes */
+  type RenderPipelineMainCallback = (state: RootState) => PassRecord | void
+
+  /** Return type for useRenderPipeline hook */
+  interface UseRenderPipelineReturn {
+    /** Current passes from state */
+    passes: PassRecord
+    /** RenderPipeline instance (null if not initialized) */
+    renderPipeline: any | null // THREE.PostProcessing (will be THREE.RenderPipeline in future Three.js release)
+    /** 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
+    /** True when RenderPipeline is configured and ready */
+    isReady: boolean
+  }
+}
+
+//* useFrameNext Types ==============================
+
+
+
+//* Global Type Declarations ==============================
+
+declare global {
+  // Job --------------------------------
+
+  /**
+   * Internal job representation in the scheduler
+   */
+  interface Job {
+    /** Unique identifier */
+    id: string
+    /** The callback to execute */
+    callback: FrameNextCallback
+    /** Phase this job belongs to */
+    phase: string
+    /** Run before these phases/job ids */
+    before: Set<string>
+    /** Run after these phases/job ids */
+    after: Set<string>
+    /** Priority within phase (higher first) */
+    priority: number
+    /** Insertion order for deterministic tie-breaking */
+    index: number
+    /** Max FPS for this job (undefined = no limit) */
+    fps?: number
+    /** Drop frames when behind (true) or catch up (false) */
+    drop: boolean
+    /** Last run timestamp (ms) */
+    lastRun?: number
+    /** Whether job is enabled */
+    enabled: boolean
+    /** Internal flag: system jobs (like default render) don't block user render takeover */
+    system?: boolean
+  }
+
+  // Phase Graph --------------------------------
+
+  /**
+   * A node in the phase graph
+   */
+  interface PhaseNode {
+    /** Phase name */
+    name: string
+    /** Whether this was auto-generated from a before/after constraint */
+    isAutoGenerated: boolean
+  }
+
+  /**
+   * Options for creating a job from hook options
+   */
+  interface JobOptions {
+    id?: string
+    phase?: string
+    before?: string | string[]
+    after?: string | string[]
+    priority?: number
+    fps?: number
+    drop?: boolean
+    enabled?: boolean
+  }
+
+  // Frame Loop State --------------------------------
+
+  /**
+   * Internal frame loop state
+   */
+  interface FrameLoopState {
+    /** Whether the loop is running */
+    running: boolean
+    /** Current RAF handle */
+    rafHandle: number | null
+    /** Last frame timestamp in ms (null = uninitialized) */
+    lastTime: number | null
+    /** Frame counter */
+    frameCount: number
+    /** Elapsed time since first frame in ms */
+    elapsedTime: number
+    /** createdAt timestamp in ms */
+    createdAt: number
+  }
+
+  // Root Entry --------------------------------
+
+  /**
+   * Internal representation of a registered root (Canvas).
+   * Tracks jobs and manages rebuild state for this root.
+   * @internal
+   */
+  interface RootEntry {
+    /** Unique identifier for this root */
+    id: string
+    /** Function to get the root's current state. Returns any to support independent mode. */
+    getState: () => any
+    /** Map of job IDs to Job objects */
+    jobs: Map<string, Job>
+    /** Cached sorted job list for execution order */
+    sortedJobs: Job[]
+    /** Whether sortedJobs needs rebuilding */
+    needsRebuild: boolean
+  }
+
+  /**
+   * Internal representation of a global job (deprecated API).
+   * Global jobs run once per frame, not per-root.
+   * Used by legacy addEffect/addAfterEffect APIs.
+   * @internal
+   * @deprecated Use useFrame with phases instead
+   */
+  interface GlobalJob {
+    /** Unique identifier for this global job */
+    id: string
+    /** Callback invoked with RAF timestamp in ms */
+    callback: (timestamp: number) => void
+  }
+
+  // HMR Support --------------------------------
+
+  /**
+   * Hot Module Replacement data structure for preserving scheduler state
+   * @internal
+   */
+  interface HMRData {
+    /** Shared data object for storing values across reloads */
+    data: Record<string, any>
+    /** Optional function to accept HMR updates */
+    accept?: () => void
+  }
+
+  // Default Phases --------------------------------
+
+  /**
+   * Default phase names for the scheduler
+   */
+  type DefaultPhase = 'start' | 'input' | 'physics' | 'update' | 'render' | 'finish'
+}
+
+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$2 | Color$2
+
+type MathType<T extends MathTypes> = T extends Color$2
+  ? Args<typeof Color$2> | ColorRepresentation$1
+  : T extends VectorRepresentation | Layers$1 | Euler$2
+    ? 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$2>
+type Layers = MathType<Layers$1>
+type Quaternion = MathType<Quaternion$1>
+type Euler = MathType<Euler$2>
+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.
+ */
+type NodeProps<P> = {
+  [K in keyof P as P[K] extends Node | 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
+}
+
+type ThreeExports = typeof import('three/webgpu')
+type ThreeElementsImpl = ThreeToJSXElements<ThreeExports>
+
+interface ThreeElements extends Omit<ThreeElementsImpl, 'audio' | 'source' | 'line' | 'path'> {
+  primitive: Omit<ThreeElement<any>, 'args'> & { object: object }
+  // Conflicts with DOM types can be accessed through a three* prefix
+  threeAudio: ThreeElementsImpl['audio']
+  threeSource: ThreeElementsImpl['source']
+  threeLine: ThreeElementsImpl['line']
+  threePath: ThreeElementsImpl['path']
 }
 
-/**
- * RenderPipeline Types for useRenderPipeline hook (WebGPU only)
- */
-
-
-
-declare global {
-  /** Pass record - stores TSL pass nodes for render pipeline */
-  type PassRecord = Record<string, any>
-
-  /** Setup callback - runs first to configure MRT, create additional passes */
-  type RenderPipelineSetupCallback = (state: RootState) => PassRecord | void
-
-  /** Main callback - runs second to configure outputNode, create effect passes */
-  type RenderPipelineMainCallback = (state: RootState) => PassRecord | void
-
-  /** Return type for useRenderPipeline hook */
-  interface UseRenderPipelineReturn {
-    /** Current passes from state */
-    passes: PassRecord
-    /** RenderPipeline instance (null if not initialized) */
-    renderPipeline: any | null // THREE.PostProcessing (will be THREE.RenderPipeline in future Three.js release)
-    /** 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
-    /** True when RenderPipeline is configured and ready */
-    isReady: boolean
-  }
+declare module 'react' {
+  namespace JSX {
+    interface IntrinsicElements extends ThreeElements {}
+  }
 }
 
-//* useFrameNext Types ==============================
-
-
-
-//* Global Type Declarations ==============================
-
-declare global {
-  // Job --------------------------------
-
-  /**
-   * Internal job representation in the scheduler
-   */
-  interface Job {
-    /** Unique identifier */
-    id: string
-    /** The callback to execute */
-    callback: FrameNextCallback
-    /** Phase this job belongs to */
-    phase: string
-    /** Run before these phases/job ids */
-    before: Set<string>
-    /** Run after these phases/job ids */
-    after: Set<string>
-    /** Priority within phase (higher first) */
-    priority: number
-    /** Insertion order for deterministic tie-breaking */
-    index: number
-    /** Max FPS for this job (undefined = no limit) */
-    fps?: number
-    /** Drop frames when behind (true) or catch up (false) */
-    drop: boolean
-    /** Last run timestamp (ms) */
-    lastRun?: number
-    /** Whether job is enabled */
-    enabled: boolean
-    /** Internal flag: system jobs (like default render) don't block user render takeover */
-    system?: boolean
-  }
-
-  // Phase Graph --------------------------------
-
-  /**
-   * A node in the phase graph
-   */
-  interface PhaseNode {
-    /** Phase name */
-    name: string
-    /** Whether this was auto-generated from a before/after constraint */
-    isAutoGenerated: boolean
-  }
-
-  /**
-   * Options for creating a job from hook options
-   */
-  interface JobOptions {
-    id?: string
-    phase?: string
-    before?: string | string[]
-    after?: string | string[]
-    priority?: number
-    fps?: number
-    drop?: boolean
-    enabled?: boolean
-  }
-
-  // Frame Loop State --------------------------------
-
-  /**
-   * Internal frame loop state
-   */
-  interface FrameLoopState {
-    /** Whether the loop is running */
-    running: boolean
-    /** Current RAF handle */
-    rafHandle: number | null
-    /** Last frame timestamp in ms (null = uninitialized) */
-    lastTime: number | null
-    /** Frame counter */
-    frameCount: number
-    /** Elapsed time since first frame in ms */
-    elapsedTime: number
-    /** createdAt timestamp in ms */
-    createdAt: number
-  }
-
-  // Root Entry --------------------------------
-
-  /**
-   * Internal representation of a registered root (Canvas).
-   * Tracks jobs and manages rebuild state for this root.
-   * @internal
-   */
-  interface RootEntry {
-    /** Unique identifier for this root */
-    id: string
-    /** Function to get the root's current state. Returns any to support independent mode. */
-    getState: () => any
-    /** Map of job IDs to Job objects */
-    jobs: Map<string, Job>
-    /** Cached sorted job list for execution order */
-    sortedJobs: Job[]
-    /** Whether sortedJobs needs rebuilding */
-    needsRebuild: boolean
-  }
-
-  /**
-   * Internal representation of a global job (deprecated API).
-   * Global jobs run once per frame, not per-root.
-   * Used by legacy addEffect/addAfterEffect APIs.
-   * @internal
-   * @deprecated Use useFrame with phases instead
-   */
-  interface GlobalJob {
-    /** Unique identifier for this global job */
-    id: string
-    /** Callback invoked with RAF timestamp in ms */
-    callback: (timestamp: number) => void
-  }
-
-  // HMR Support --------------------------------
-
-  /**
-   * Hot Module Replacement data structure for preserving scheduler state
-   * @internal
-   */
-  interface HMRData {
-    /** Shared data object for storing values across reloads */
-    data: Record<string, any>
-    /** Optional function to accept HMR updates */
-    accept?: () => void
-  }
-
-  // Default Phases --------------------------------
-
-  /**
-   * Default phase names for the scheduler
-   */
-  type DefaultPhase = 'start' | 'input' | 'physics' | 'update' | 'render' | 'finish'
+declare module 'react/jsx-runtime' {
+  namespace JSX {
+    interface IntrinsicElements extends ThreeElements {}
+  }
 }
 
-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$2 | Color$2
-
-type MathType<T extends MathTypes> = T extends Color$2
-  ? Args<typeof Color$2> | ColorRepresentation$1
-  : T extends VectorRepresentation | Layers$1 | Euler$2
-    ? 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$2>
-type Layers = MathType<Layers$1>
-type Quaternion = MathType<Quaternion$1>
-type Euler = MathType<Euler$2>
-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.
- */
-type NodeProps<P> = {
-  [K in keyof P as P[K] extends Node | 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
-}
-
-type ThreeExports = typeof import('three/webgpu')
-type ThreeElementsImpl = ThreeToJSXElements<ThreeExports>
-
-interface ThreeElements extends Omit<ThreeElementsImpl, 'audio' | 'source' | 'line' | 'path'> {
-  primitive: Omit<ThreeElement<any>, 'args'> & { object: object }
-  // 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 {}
-  }
+declare module 'react/jsx-dev-runtime' {
+  namespace JSX {
+    interface IntrinsicElements extends ThreeElements {}
+  }
 }
 
 type three_d_Color = Color;
@@ -1895,7 +1895,7 @@ type EnvironmentLoaderProps = {
  * const texture = useEnvironment({ preset: 'sunset' })
  * ```
  */
-declare function useEnvironment({ files, path, preset, colorSpace, extensions, }?: Partial<EnvironmentLoaderProps>): Texture$1<unknown> | CubeTexture;
+declare function useEnvironment({ files, path, preset, colorSpace, extensions, }?: Partial<EnvironmentLoaderProps>): Texture$1<unknown, THREE$1.TextureEventMap> | CubeTexture<unknown>;
 declare namespace useEnvironment {
     var preload: (preloadOptions?: EnvironmentLoaderPreloadOptions) => void;
     var clear: (clearOptions?: EnvironmentLoaderClearOptions) => void;
@@ -4718,51 +4718,51 @@ declare function createTextureOperations(set: StoreApi<RootState>['setState']):
  */
 declare function useRenderPipeline(mainCB?: RenderPipelineMainCallback, setupCB?: RenderPipelineSetupCallback): UseRenderPipelineReturn;
 
-//* Renderer Props ========================================
-
-type WebGPUDefaultProps = Omit<WebGPURendererParameters, 'canvas'> & BaseRendererProps
-
-type WebGPUProps =
-  | RendererFactory<WebGPURenderer, WebGPUDefaultProps>
-  | Partial<Properties<WebGPURenderer> | WebGPURendererParameters>
-
-// WebGPU doesn't have shadow maps in the same way
-interface WebGPUShadowConfig {
-  shadows?: boolean // Simplified for WebGPU
-}
-
-//* WebGPU-specific Types ========================================
-
-/** WebGPU renderer type - re-exported as R3FRenderer from @react-three/fiber/webgpu */
-type WebGPUR3FRenderer = WebGPURenderer
-
-/** WebGPU internal state with narrowed renderer type */
-interface WebGPUInternalState extends Omit<InternalState, 'actualRenderer'> {
-  actualRenderer: WebGPURenderer
-}
-
-/**
- * WebGPU-specific RootState with narrowed renderer type.
- * Automatically used when importing from `@react-three/fiber/webgpu`.
- *
- * @example
- * ```tsx
- * import { useThree } from '@react-three/fiber/webgpu'
- *
- * function MyComponent() {
- *   const { renderer } = useThree()
- *   // renderer is typed as WebGPURenderer
- *   renderer.compute(computePass)
- * }
- * ```
- */
-interface WebGPURootState extends Omit<RootState, 'renderer' | 'gl' | 'internal'> {
-  /** @deprecated Use `renderer` instead */
-  gl: WebGPURenderer
-  /** The WebGPU renderer instance */
-  renderer: WebGPURenderer
-  /** Internals with WebGPU renderer */
-  internal: WebGPUInternalState
+//* Renderer Props ========================================
+
+type WebGPUDefaultProps = Omit<WebGPURendererParameters, 'canvas'> & BaseRendererProps
+
+type WebGPUProps =
+  | RendererFactory<WebGPURenderer, WebGPUDefaultProps>
+  | Partial<Properties<WebGPURenderer> | WebGPURendererParameters>
+
+// WebGPU doesn't have shadow maps in the same way
+interface WebGPUShadowConfig {
+  shadows?: boolean // Simplified for WebGPU
+}
+
+//* WebGPU-specific Types ========================================
+
+/** WebGPU renderer type - re-exported as R3FRenderer from @react-three/fiber/webgpu */
+type WebGPUR3FRenderer = WebGPURenderer
+
+/** WebGPU internal state with narrowed renderer type */
+interface WebGPUInternalState extends Omit<InternalState, 'actualRenderer'> {
+  actualRenderer: WebGPURenderer
+}
+
+/**
+ * WebGPU-specific RootState with narrowed renderer type.
+ * Automatically used when importing from `@react-three/fiber/webgpu`.
+ *
+ * @example
+ * ```tsx
+ * import { useThree } from '@react-three/fiber/webgpu'
+ *
+ * function MyComponent() {
+ *   const { renderer } = useThree()
+ *   // renderer is typed as WebGPURenderer
+ *   renderer.compute(computePass)
+ * }
+ * ```
+ */
+interface WebGPURootState extends Omit<RootState, 'renderer' | 'gl' | 'internal'> {
+  /** @deprecated Use `renderer` instead */
+  gl: WebGPURenderer
+  /** The WebGPU renderer instance */
+  renderer: WebGPURenderer
+  /** Internals with WebGPU renderer */
+  internal: WebGPUInternalState
 }
 
 export { Block, Canvas, Environment, EnvironmentCube, EnvironmentMap, EnvironmentPortal, ErrorBoundary, FROM_REF, IsObject, ONCE, Portal, R3F_BUILD_LEGACY, R3F_BUILD_WEBGPU, REACT_INTERNAL_PROPS, RESERVED_PROPS, three_d as ReactThreeFiber, Scheduler, Texture, _roots, act, addAfterEffect, addEffect, addTail, advance, applyProps, attach, buildGraph, calculateDpr, clearNodeScope, clearRootNodes, clearRootUniforms, clearScope, context, createEvents, createPointerEvents, createPortal, createRoot, createScopedStore, createStore, createTextureOperations, detach, diffProps, dispose, createPointerEvents as events, extend, findInitialRoot, flushSync, fromRef, getInstanceProps, getPrimary, getPrimaryIds, getRootState, getScheduler, getUuidPrefix, hasConstructor, hasPrimary, invalidate, invalidateInstance, is, isColorRepresentation, isCopyable, isFromRef, isObject3D, isOnce, isOrthographicCamera, isRef, isRenderer, isTexture, isVectorLike, once, prepare, presetsObj, rebuildAllBuffers, rebuildAllNodes, rebuildAllStorage, rebuildAllUniforms, reconciler, registerPrimary, removeInteractivity, removeNodes, removeUniforms, resolve, unmountComponentAtNode, unregisterPrimary, updateCamera, updateFrustum, useBridge, useBuffers, useEnvironment, useFrame, useGPUStorage, useGraph, useInstanceHandle, useIsomorphicLayoutEffect, useLoader, useLocalNodes, useMutableCallback, useNodes, useRenderPipeline, useRenderTarget, useStore, useTexture, useTextures, useThree, useUniform, useUniforms, waitForPrimary };