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

package/dist/extension.d.cts

@@ -1,32 +1,10 @@
-import * as React$1 from 'react';
-import { ReactNode } from 'react';
-import * as THREE$1 from 'three';
-import { WebGLCubeRenderTarget, WebGLRenderTarget, WebGLRenderer, Color as Color$2, ColorRepresentation as ColorRepresentation$1, Euler as Euler$2, Loader, RenderTargetOptions as RenderTargetOptions$1 } from 'three';
-import * as three_webgpu from 'three/webgpu';
-import { WebGPURenderer, Node, StorageTexture, Storage3DTexture, StorageArrayTexture, Data3DTexture, CanvasTarget, CubeRenderTarget, RenderTarget, Euler as Euler$1, Color as Color$1, ColorRepresentation, Layers as Layers$1, Raycaster, Intersection as Intersection$1, BufferGeometry, Matrix4 as Matrix4$1, Quaternion as Quaternion$1, Object3D, Vector2 as Vector2$1, Vector3 as Vector3$1, Vector4 as Vector4$1, Matrix3 as Matrix3$1 } from 'three/webgpu';
+import * as React from 'react';
+import * as THREE from 'three';
+import { WebGPURenderer, CanvasTarget } from 'three/webgpu';
 import { StoreApi } from 'zustand';
 import { UseBoundStoreWithEqualityFn } from 'zustand/traditional';
 import { FrameCallback as FrameCallback$1, FrameTimingState, SchedulerApi, UseFrameNextOptions, FrameNextControls } from '@pmndrs/scheduler';
 export { AddPhaseOptions, FrameControls, FrameNextControls, FrameTimingState, RootOptions, SchedulerApi, UseFrameNextOptions, UseFrameOptions } from '@pmndrs/scheduler';
-import * as three_examples_jsm_inspector_Inspector_js from 'three/examples/jsm/inspector/Inspector.js';
-import { WebGLRendererParameters } from 'three/src/renderers/WebGLRenderer.js';
-import { Inspector } from 'three/addons/inspector/Inspector.js';
-import { Options } from 'react-use-measure';
-
-function _mergeNamespaces(n, m) {
-  m.forEach(function (e) {
-    e && typeof e !== 'string' && !Array.isArray(e) && Object.keys(e).forEach(function (k) {
-      if (k !== 'default' && !(k in n)) {
-        var d = Object.getOwnPropertyDescriptor(e, k);
-        Object.defineProperty(n, k, d.get ? d : {
-          enumerable: true,
-          get: function () { return e[k]; }
-        });
-      }
-    });
-  });
-  return Object.freeze(n);
-}
 
 //* Utility Types ==============================
 
@@ -43,7 +21,7 @@ type IsAllOptional<T extends any[]> = T extends [infer First, ...infer Rest]
 
 //* Camera Types ==============================
 
-type ThreeCamera = (THREE$1.OrthographicCamera | THREE$1.PerspectiveCamera) & { manual?: boolean }
+type ThreeCamera = (THREE.OrthographicCamera | THREE.PerspectiveCamera) & { manual?: boolean }
 
 //* Act Type ==============================
 
@@ -51,10 +29,10 @@ type Act = <T = any>(cb: () => Promise<T>) => Promise<T>
 
 //* Bridge & Block Types ==============================
 
-type Bridge = React$1.FC<{ children?: React$1.ReactNode }>
+type Bridge = React.FC<{ children?: React.ReactNode }>
 
 type SetBlock = false | Promise<null> | null
-type UnblockProps = { set: React$1.Dispatch<React$1.SetStateAction<SetBlock>>; children: React$1.ReactNode }
+type UnblockProps = { set: React.Dispatch<React.SetStateAction<SetBlock>>; children: React.ReactNode }
 
 //* Object Map Type ==============================
 
@@ -79,9 +57,9 @@ interface ObjectMap<
     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>
+  nodes: Record<T['nodes'] extends string ? T['nodes'] : string, THREE.Object3D>
+  materials: Record<T['materials'] extends string ? T['materials'] : string, THREE.Material>
+  meshes: Record<T['meshes'] extends string ? T['meshes'] : string, THREE.Mesh>
 }
 
 //* Equality Config ==============================
@@ -104,28 +82,28 @@ interface Disposable {
 
 //* Event-related Types =====================================
 
-interface Intersection extends THREE$1.Intersection {
+interface Intersection extends THREE.Intersection {
   /** The event source (the object which registered the handler) */
-  eventObject: THREE$1.Object3D
+  eventObject: THREE.Object3D
 }
 
-type Camera = THREE$1.OrthographicCamera | THREE$1.PerspectiveCamera
+type Camera = THREE.OrthographicCamera | THREE.PerspectiveCamera
 
 interface IntersectionEvent<TSourceEvent> extends Intersection {
   /** The event source (the object which registered the handler) */
-  eventObject: THREE$1.Object3D
+  eventObject: THREE.Object3D
   /** An array of intersections */
   intersections: Intersection[]
   /** vec3.set(pointer.x, pointer.y, 0).unproject(camera) */
-  unprojectedPoint: THREE$1.Vector3
+  unprojectedPoint: THREE.Vector3
   /** Normalized event coordinates */
-  pointer: THREE$1.Vector2
+  pointer: THREE.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
+  ray: THREE.Ray
   /** The camera that was used by the raycaster */
   camera: Camera
   /** stopPropagation will stop underlying handlers from firing */
@@ -195,13 +173,13 @@ interface EventHandlers {
   onVisible?: (visible: boolean) => void
 }
 
-type FilterFunction = (items: THREE$1.Intersection[], state: RootState) => THREE$1.Intersection[]
+type FilterFunction = (items: THREE.Intersection[], state: RootState) => THREE.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
+  ray: THREE.Ray
   /** Optional: custom compute function for this pointer */
   compute?: (state: RootState) => void
   /** Pointer type identifier */
@@ -255,7 +233,7 @@ interface PointerCaptureTarget {
 
 /** Entry in the visibility registry for tracking object visibility state */
 interface VisibilityEntry {
-  object: THREE$1.Object3D
+  object: THREE.Object3D
   handlers: Pick<EventHandlers, 'onFramed' | 'onOccluded' | 'onVisible'>
   lastFramedState: boolean | null
   lastOccludedState: boolean | null
@@ -290,99 +268,15 @@ type FrameNextCallback = FrameCallback$1<RootState>
 /** Alias for FrameNextCallback */
 type FrameCallback = FrameNextCallback
 
-//* Buffer Types (useBuffers) ========================================
-
-/**
- * Buffer-like types for GPU compute and storage operations.
- * Includes raw CPU arrays, Three.js buffer attributes, and TSL buffer nodes.
- *
- * @example
- * ```tsx
- * const { positions, velocities } = useBuffers(() => ({
- *   positions: instancedArray(count, 'vec3'),       // StorageBufferNode
- *   velocities: new Float32Array(count * 3),        // TypedArray
- * }), 'particles')
- * ```
- */
-type BufferLike =
-  | Float32Array
-  | Uint32Array
-  | Int32Array
-  | Float64Array
-  | Uint8Array
-  | Int8Array
-  | Uint16Array
-  | Int16Array
-  | THREE$1.BufferAttribute // Base class for all buffer attributes
-  | THREE$1.InterleavedBufferAttribute
-  | Node // TSL buffer nodes (instancedArray, storage)
-
-/** Flat record of buffer-like values (no nested scopes) */
-type BufferRecord = Record<string, BufferLike>
-
-/**
- * Buffer store that can contain both root-level buffers and scoped buffer objects.
- * Structure: { positions: Float32Array, particles: { vel: StorageBufferNode } }
- */
-type BufferStore = Record<string, BufferLike | BufferRecord>
-
-//* Node Types (useNodes) ========================================
-
-/**
- * Every node representation `useNodes` accepts and `state.nodes` holds: three's real `Node`,
- * the callable proxy `Fn()` returns, and the legacy structural shape (`uuid`/`nodeType`) older
- * code passes through. Creators are constrained to this same type, so the shape a creator returns
- * and the shape the store holds are one type by construction.
- */
-type NodeLike = TSLNodeType | LegacyTSLNodeLike
-
-/** Flat record of TSL nodes (no nested scopes) */
-type NodeRecord<T extends NodeLike = NodeLike> = Record<string, T>
-
-/**
- * Node store that can contain both root-level nodes and scoped node objects.
- * Structure: { wobble: OperatorNode, fx: { blur: ShaderCallable } }
- */
-type NodeStore = Record<string, NodeLike | NodeRecord>
-
-//* Storage Types (useGPUStorage) ========================================
-
-/**
- * GPU storage types for texture-based storage operations.
- * Includes Three.js storage textures and TSL storage texture nodes.
- *
- * @example
- * ```tsx
- * const { heightMap } = useGPUStorage(() => ({
- *   heightMap: new StorageTexture(512, 512),
- * }), 'terrain')
- * ```
- */
-type StorageLike =
-  | StorageTexture // 2D GPU storage texture
-  | Storage3DTexture // 3D GPU storage texture (volumes, fluid grids)
-  | StorageArrayTexture // 2D-array GPU storage texture
-  | Data3DTexture // 3D texture (can be used as storage)
-  | Node // TSL storage texture nodes (storageTexture)
-
-/** Flat record of storage-like values (no nested scopes) */
-type StorageRecord = Record<string, StorageLike>
-
-/**
- * Storage store that can contain both root-level storage and scoped storage objects.
- * Structure: { heightMap: StorageTexture, terrain: { normal: StorageTextureNode } }
- */
-type StorageStore = Record<string, StorageLike | StorageRecord>
-
 //* Renderer Types ========================================
 
 /** Default renderer type - union of WebGL and WebGPU renderers */
-type R3FRenderer = THREE$1.WebGLRenderer | WebGPURenderer
+type R3FRenderer = THREE.WebGLRenderer | WebGPURenderer
 
 //* Core Store Types ========================================
 
 type Subscription = {
-  ref: React$1.RefObject<RenderCallback>
+  ref: React.RefObject<RenderCallback>
   priority: number
   store: RootStore
 }
@@ -392,11 +286,11 @@ type PointerState = {
   /** Objects currently hovered by this pointer */
   hovered: Map<string, ThreeEvent<DomEvent>>
   /** Objects capturing this pointer */
-  captured: Map<THREE$1.Object3D, PointerCaptureTarget>
+  captured: Map<THREE.Object3D, PointerCaptureTarget>
   /** Initial click position [x, y] */
   initialClick: [x: number, y: number]
   /** Objects hit on initial click */
-  initialHits: THREE$1.Object3D[]
+  initialHits: THREE.Object3D[]
 }
 
 type Dpr = number | [min: number, max: number]
@@ -439,36 +333,36 @@ interface Performance {
 }
 
 interface InternalState {
-  interaction: THREE$1.Object3D[]
+  interaction: THREE.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>
+  lastEvent: React.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>>
+  capturedMap: Map<number, Map<THREE.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[]
+  initialHits: THREE.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
+  occlusionObserver: THREE.Mesh | null
   /** Cached occlusion results from render pass - keyed by Object3D */
-  occlusionCache: Map<THREE$1.Object3D, boolean | null>
+  occlusionCache: Map<THREE.Object3D, boolean | null>
   /** Internal helper group for R3F system objects (occlusion observer, etc.) */
-  helperGroup: THREE$1.Group | null
+  helperGroup: THREE.Group | null
   active: boolean
   priority: number
   frames: number
-  subscribe: (callback: React$1.RefObject<RenderCallback>, priority: number, store: RootStore) => () => void
+  subscribe: (callback: React.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) */
@@ -484,7 +378,7 @@ interface InternalState {
   /** 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
+  container?: THREE.Object3D
   /**
    * The CanvasTarget this root sizes and renders through.
    *
@@ -546,16 +440,17 @@ interface RootState {
   /** Get current state */
   get: StoreApi<RootState>['getState']
   /**
-   * Reference to the authoritative store for shared TSL resources (uniforms, nodes, etc).
+   * The store of the canvas that owns this root's renderer.
    * - For primary/independent canvases: points to its own store (self-reference)
    * - For secondary canvases: points to the primary canvas's store
+   * - Portals copy it from their parent
    *
-   * Hooks like useNodes/useUniforms should read from primaryStore to ensure
-   * consistent shared state across all canvases sharing a renderer.
+   * Anything shared per renderer rather than per canvas (e.g. @react-three/tsl's resources)
+   * resolves through it.
    */
   primaryStore: RootStore
   /** @deprecated Use `renderer` instead. The instance of the renderer (typed as WebGLRenderer for backwards compat) */
-  gl: THREE$1.WebGLRenderer
+  gl: THREE.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 */
@@ -564,27 +459,27 @@ interface RootState {
   /** Default camera */
   camera: ThreeCamera
   /** Camera frustum for visibility checks - auto-updated each frame when autoUpdateFrustum is true */
-  frustum: THREE$1.Frustum
+  frustum: THREE.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
+  scene: THREE.Scene
   /** The actual root THREE.Scene - always points to the true scene, even inside portals */
-  rootScene: THREE$1.Scene
+  rootScene: THREE.Scene
   /** Default raycaster */
-  raycaster: THREE$1.Raycaster
+  raycaster: THREE.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
+  controls: THREE.EventDispatcher | null
   /** Normalized event coordinates */
-  pointer: THREE$1.Vector2
+  pointer: THREE.Vector2
   /** @deprecated Normalized event coordinates, use "pointer" instead! */
-  mouse: THREE$1.Vector2
+  mouse: THREE.Vector2
   /** Color space assigned to 8-bit input textures (color maps). Most textures are authored in sRGB. */
-  textureColorSpace: THREE$1.ColorSpace
+  textureColorSpace: THREE.ColorSpace
   /** Render loop flags */
   frameloop: Frameloop
   performance: Performance
@@ -594,7 +489,7 @@ interface RootState {
   viewport: Viewport & {
     getCurrentViewport: (
       camera?: ThreeCamera,
-      target?: THREE$1.Vector3 | Parameters<THREE$1.Vector3['set']>,
+      target?: THREE.Vector3 | Parameters<THREE.Vector3['set']>,
       size?: Size,
     ) => Omit<Viewport, 'dpr' | 'initialDpr'>
   }
@@ -614,24 +509,10 @@ interface RootState {
   setError: (error: Error | null) => void
   /** Current error state (null when no error) */
   error: Error | null
-  /** Global TSL uniform nodes - root-level uniforms + scoped sub-objects. Use useUniforms() hook */
-  uniforms: UniformStore
-  /** Global TSL nodes - root-level nodes + scoped sub-objects. Use useNodes() hook */
-  nodes: NodeStore
-  /** Global TSL buffer nodes - root-level buffers + scoped sub-objects. Use useBuffers() hook */
-  buffers: BufferStore
-  /** Global GPU storage (textures, etc.) - root-level storage + scoped sub-objects. Use useGPUStorage() hook */
-  gpuStorage: StorageStore
   /** Global Texture registry (key → Texture, usually keyed by URL) - use useTextures() hook for access + lifecycle */
-  textures: Map<string, THREE$1.Texture>
+  textures: Map<string, THREE.Texture>
   /** Internal: refcount per texture key, driven by mounted useTexture consumers (registry enrollment is on by default) */
   _textureRefs: Map<string, number>
-  /** WebGPU RenderPipeline instance - use useRenderPipeline() hook */
-  renderPipeline: ThreeRenderPipeline | null
-  /** Global TSL pass nodes for render pipeline - use useRenderPipeline() hook */
-  passes: PassRecord
-  /** Internal version counter for HMR - incremented by rebuildNodes/rebuildUniforms to bust memoization */
-  _hmrVersion: number
   /** Internal: whether setSize() has taken ownership of canvas dimensions */
   _sizeImperative: boolean
   /** Internal: stored size props from Canvas for reset functionality */
@@ -657,934 +538,7 @@ interface RootState {
 
 type RootStore = UseBoundStoreWithEqualityFn<StoreApi<RootState>>
 
-/**
- * @fileoverview Internal Three.js re-exports - DEFAULT ENTRY
- *
- * This is the single source of truth for Three.js imports within R3F.
- * All internal code should import from '#three' (or '../three' relative).
- *
- * DEFAULT behavior (root import):
- * - Exports from three/webgpu (the new standard)
- * - Also exports WebGLRenderer for backwards compatibility (with deprecation)
- * - Both renderer types available, runtime decides which to use
- *
- * For explicit legacy or webgpu-only builds, use:
- * - #three/legacy - WebGL only, no WebGPU
- * - #three/webgpu - WebGPU only, no WebGL legacy
- */
-declare const R3F_BUILD_LEGACY = true;
-declare const R3F_BUILD_WEBGPU = true;
-
-/** Lazily load the three Inspector. Keeps it out of the eager module graph — see note above. */
-declare function loadInspector(): Promise<typeof three_examples_jsm_inspector_Inspector_js.Inspector>;
-
-var THREE = /*#__PURE__*/_mergeNamespaces({
-  __proto__: null,
-  CubeRenderTarget: CubeRenderTarget,
-  CubeRenderTargetCompat: CubeRenderTarget,
-  Inspector: Inspector,
-  R3F_BUILD_LEGACY: R3F_BUILD_LEGACY,
-  R3F_BUILD_WEBGPU: R3F_BUILD_WEBGPU,
-  RenderTargetCompat: RenderTarget,
-  WebGLCubeRenderTarget: WebGLCubeRenderTarget,
-  WebGLRenderTarget: WebGLRenderTarget,
-  WebGLRenderer: WebGLRenderer,
-  WebGLRendererParameters: WebGLRendererParameters,
-  loadInspector: loadInspector
-}, [three_webgpu]);
-
-type MutableOrReadonlyParameters<T extends (...args: any) => any> = Parameters<T> | Readonly<Parameters<T>>
-
-interface MathRepresentation {
-  set(...args: number[]): any
-}
-interface VectorRepresentation extends MathRepresentation {
-  setScalar(value: number): any
-}
-type MathTypes = MathRepresentation | Euler$1 | Color$1
-
-type MathType<T extends MathTypes> = T extends Color$1
-  ? Args<typeof Color$1> | ColorRepresentation
-  : T extends VectorRepresentation | Layers$1 | Euler$1
-    ? T | MutableOrReadonlyParameters<T['set']> | number
-    : T | MutableOrReadonlyParameters<T['set']>
-
-type MathProps<P> = {
-  [K in keyof P as P[K] extends MathTypes ? K : never]: P[K] extends MathTypes ? MathType<P[K]> : never
-}
-
-type Vector2 = MathType<Vector2$1>
-type Vector3 = MathType<Vector3$1>
-type Vector4 = MathType<Vector4$1>
-type Color = MathType<Color$1>
-type Layers = MathType<Layers$1>
-type Quaternion = MathType<Quaternion$1>
-type Euler = MathType<Euler$1>
-type Matrix3 = MathType<Matrix3$1>
-type Matrix4 = MathType<Matrix4$1>
-
-interface RaycastableRepresentation {
-  raycast(raycaster: Raycaster, intersects: Intersection$1[]): void
-}
-type EventProps<P> = P extends RaycastableRepresentation ? Partial<EventHandlers> : {}
-
-/**
- * Props for geometry transform methods that can be called with `once()`.
- * These methods modify the geometry in-place and only make sense to call once on mount.
- *
- * @example
- * import { once } from '@react-three/fiber'
- *
- * <boxGeometry args={[1, 1, 1]} rotateX={once(Math.PI / 2)} />
- * <planeGeometry args={[10, 10]} translate={once(0, 0, 5)} />
- * <bufferGeometry applyMatrix4={once(matrix)} center={once()} />
- */
-interface GeometryTransformProps {
-  /** Rotate the geometry about the X axis (radians). Use with once(). */
-  rotateX?: number
-  /** Rotate the geometry about the Y axis (radians). Use with once(). */
-  rotateY?: number
-  /** Rotate the geometry about the Z axis (radians). Use with once(). */
-  rotateZ?: number
-  /** Translate the geometry (x, y, z). Use with once(). */
-  translate?: [x: number, y: number, z: number]
-  /** Scale the geometry (x, y, z). Use with once(). */
-  scale?: [x: number, y: number, z: number]
-  /** Center the geometry based on bounding box. Use with once(). */
-  center?: true
-  /** Apply a Matrix4 transformation. Use with once(). */
-  applyMatrix4?: Matrix4$1
-  /** Apply a Quaternion rotation. Use with once(). */
-  applyQuaternion?: Quaternion$1
-}
-
-type GeometryProps<P> = P extends BufferGeometry ? GeometryTransformProps : {}
-
-/**
- * Workaround for @types/three TSL node type issues.
- * The Node base class has properties that subclasses (OperatorNode, ConstNode, etc.) don't inherit.
- * This transforms `Node | null` properties to accept any object with node-like shape.
- */
-type TSLNodeInput = { nodeType?: string | null; uuid?: string } | null
-
-/**
- * For node material properties (colorNode, positionNode, etc.), accept broader types
- * since @types/three has broken inheritance for TSL node subclasses. NodeClass requires
- * `nodeType`, so this structural key test remains neutral to the selected Three entry.
- */
-type NodeProps<P> = {
-  [K in keyof P as NonNullable<P[K]> extends { nodeType: string | null } ? K : never]?: TSLNodeInput
-}
-
-interface ReactProps<P> {
-  children?: React.ReactNode
-  ref?: React.Ref<P>
-  key?: React.Key
-}
-
-type ElementProps<T extends ConstructorRepresentation, P = InstanceType<T>> = Partial<
-  Overwrite<P, MathProps<P> & ReactProps<P> & EventProps<P> & GeometryProps<P> & NodeProps<P>>
->
-
-type ThreeElement<T extends ConstructorRepresentation> = Mutable<
-  Overwrite<ElementProps<T>, Omit<InstanceProps<InstanceType<T>, T>, 'object'>>
->
-
-type ThreeToJSXElements<T extends Record<string, any>> = {
-  [K in keyof T & string as Uncapitalize<K>]: T[K] extends ConstructorRepresentation ? ThreeElement<T[K]> : never
-}
-
-/** Method names of Object3D, excluded from the `primitive` element's typed props. */
-type Object3DMethod = NonNullable<
-  {
-    [K in keyof Object3D]-?: Object3D[K] extends (...args: any[]) => any ? K : never
-  }[keyof Object3D]
->
-
-type ThreeExports = typeof THREE
-type ThreeElementsImpl = ThreeToJSXElements<ThreeExports>
-
-interface ThreeElements extends Omit<ThreeElementsImpl, 'audio' | 'source' | 'line' | 'path'> {
-  /**
-   * `primitive` wraps a pre-existing object, so its props cannot be derived from one class.
-   * Events are typed from `EventHandlers` (`onClick={(e) => ...}` infers `e`), the ref is
-   * untyped, and any other prop is accepted and applied to the object by name. Object3D's own
-   * methods are left out of the typed surface: they return `this`, so a subclass element's
-   * props (`ThreeElements['group']`) could not be spread onto a primitive otherwise.
-   */
-  primitive: Omit<ThreeElement<typeof Object3D>, 'args' | 'object' | 'ref' | Object3DMethod> & {
-    object: object
-    ref?: React.Ref<any>
-    [prop: string]: unknown
-  }
-  // Conflicts with DOM types can be accessed through a three* prefix
-  threeAudio: ThreeElementsImpl['audio']
-  threeSource: ThreeElementsImpl['source']
-  threeLine: ThreeElementsImpl['line']
-  threePath: ThreeElementsImpl['path']
-}
-
-declare module 'react' {
-  namespace JSX {
-    interface IntrinsicElements extends ThreeElements {}
-  }
-}
-
-declare module 'react/jsx-runtime' {
-  namespace JSX {
-    interface IntrinsicElements extends ThreeElements {}
-  }
-}
-
-declare module 'react/jsx-dev-runtime' {
-  namespace JSX {
-    interface IntrinsicElements extends ThreeElements {}
-  }
-}
-
-//* Base Renderer Types =====================================
-
-// Shim for OffscreenCanvas since it was removed from DOM types
-interface OffscreenCanvas extends EventTarget {}
-
-interface BaseRendererProps {
-  canvas: HTMLCanvasElement | OffscreenCanvas
-  powerPreference?: 'high-performance' | 'low-power' | 'default'
-  antialias?: boolean
-  alpha?: boolean
-}
-
-type RendererFactory<TRenderer, TParams> =
-  | TRenderer
-  | ((defaultProps: TParams) => TRenderer)
-  | ((defaultProps: TParams) => Promise<TRenderer>)
-
-interface Renderer {
-  render: (scene: THREE$1.Scene, camera: THREE$1.Camera) => any
-}
-
-//* Color Management Config ==============================
-
-/**
- * Color management configuration shared by both WebGL and WebGPU renderers.
- */
-interface ColorManagementConfig {
-  /**
-   * Color space assigned to 8-bit input textures (color maps).
-   * Defaults to sRGB. Most textures are authored in sRGB.
-   * @default THREE.SRGBColorSpace
-   */
-  textureColorSpace?: THREE$1.ColorSpace
-}
-
-//* WebGL Renderer Props ==============================
-
-type DefaultGLProps = Omit<THREE$1.WebGLRendererParameters, 'canvas'> & {
-  canvas: HTMLCanvasElement | OffscreenCanvas
-}
-
-type GLProps =
-  | Renderer
-  | ((defaultProps: DefaultGLProps) => Renderer)
-  | ((defaultProps: DefaultGLProps) => Promise<Renderer>)
-  | (Partial<Properties<THREE$1.WebGLRenderer> | THREE$1.WebGLRendererParameters> & ColorManagementConfig)
-
-//* WebGPU Renderer Props ==============================
-
-type DefaultRendererProps = {
-  canvas: HTMLCanvasElement | OffscreenCanvas
-  [key: string]: any
-}
-
-/**
- * Canvas-level scheduler configuration.
- * Controls render timing relative to other canvases.
- */
-interface CanvasSchedulerConfig {
-  /**
-   * Run this Canvas root before the referenced Canvas root id(s).
-   */
-  before?: string | string[]
-  /**
-   * Run this Canvas root after the referenced Canvas root id(s).
-   */
-  after?: string | string[]
-  /**
-   * Numeric root order. Lower values run first.
-   */
-  order?: number
-  /**
-   * Limit this Canvas's default render job (frames per second).
-   */
-  fps?: number
-}
-
-/**
- * Extended renderer configuration for multi-canvas support and color management.
- */
-interface RendererConfigExtended extends ColorManagementConfig {
-  /** Share renderer from another canvas (WebGPU only) */
-  primaryCanvas?: string
-  /** Canvas-level scheduler options */
-  scheduler?: CanvasSchedulerConfig
-}
-
-type RendererProps =
-  | any // WebGPURenderer
-  | ((defaultProps: DefaultRendererProps) => any)
-  | ((defaultProps: DefaultRendererProps) => Promise<any>)
-  | (Partial<Properties<any> | Record<string, any>> & RendererConfigExtended)
-
-//* Camera Props ==============================
-
-type CameraProps = (
-  | THREE$1.Camera
-  | Partial<
-      ThreeElement<typeof THREE$1.Camera> &
-        ThreeElement<typeof THREE$1.PerspectiveCamera> &
-        ThreeElement<typeof THREE$1.OrthographicCamera>
-    >
-) & {
-  /** Flags the camera as manual, putting projection into your own hands */
-  manual?: boolean
-}
-
-//* Render Props ==============================
-
-interface RenderProps<TCanvas extends HTMLCanvasElement | OffscreenCanvas> {
-  /**
-   * Unique identifier for multi-canvas renderer sharing.
-   * Makes this canvas targetable by other canvases using the `primaryCanvas` prop.
-   * Also sets the HTML `id` attribute on the canvas element.
-   * @example <Canvas id="main-viewer">...</Canvas>
-   */
-  id?: string
-  /**
-   * Share the renderer from another canvas instead of creating a new one.
-   * Pass the `id` of the primary canvas to share its WebGPURenderer.
-   * Only available with WebGPU (not legacy WebGL).
-   *
-   * Note: This is extracted from `renderer={{ primaryCanvas: "id" }}` by Canvas.
-   * @internal
-   */
-  primaryCanvas?: string
-  /**
-   * Canvas-level scheduler options. Controls render timing relative to other canvases.
-   *
-   * Note: This is extracted from `renderer={{ scheduler: {...} }}` by Canvas.
-   * @internal
-   */
-  scheduler?: CanvasSchedulerConfig
-  /** A threejs renderer instance or props that go into the default renderer */
-  gl?: GLProps
-  /** A WebGPU renderer instance or props that go into the default renderer */
-  renderer?: RendererProps
-  /** Dimensions to fit the renderer to. Will measure canvas dimensions if omitted */
-  size?: Size
-  /**
-   * Enables shadows (by default PCFsoft). Can accept `gl.shadowMap` options for fine-tuning,
-   * but also strings: 'basic' | 'percentage' | 'soft' | 'variance'.
-   * @see https://threejs.org/docs/#api/en/renderers/WebGLRenderer.shadowMap
-   */
-  shadows?: boolean | 'basic' | 'percentage' | 'soft' | 'variance' | Partial<THREE$1.WebGLShadowMap>
-  /** Creates an orthographic camera */
-  orthographic?: boolean
-  /**
-   * R3F's render mode. Set to `demand` to only render on state change or `never` to take control.
-   * @see https://docs.pmnd.rs/react-three-fiber/advanced/scaling-performance#on-demand-rendering
-   */
-  frameloop?: Frameloop
-  /**
-   * R3F performance options for adaptive performance.
-   * @see https://docs.pmnd.rs/react-three-fiber/advanced/scaling-performance#movement-regression
-   */
-  performance?: Partial<Omit<Performance, 'regress'>>
-  /** Target pixel ratio. Can clamp between a range: `[min, max]` */
-  dpr?: Dpr
-  /**
-   * Props that go into the default raycaster. `params` is merged into the raycaster's defaults,
-   * so a single threshold can be set: `raycaster={{ params: { Points: { threshold: 0.2 } } }}`.
-   */
-  raycaster?: Partial<Omit<THREE$1.Raycaster, 'params'>> & { params?: Partial<THREE$1.RaycasterParameters> }
-  /** A `THREE.Scene` instance or props that go into the default scene */
-  scene?: THREE$1.Scene | Partial<THREE$1.Scene>
-  /** A `THREE.Camera` instance or props that go into the default camera */
-  camera?: CameraProps
-  /** An R3F event manager to manage elements' pointer events */
-  events?: (store: RootStore) => EventManager<Element>
-  /** Callback after the canvas has rendered (but not yet committed) */
-  onCreated?: (state: RootState) => void
-  /** Response for pointer clicks that have missed any target */
-  onPointerMissed?: (event: MouseEvent) => void
-  /** Response for dragover events that have missed any target */
-  onDragOverMissed?: (event: DragEvent) => void
-  /** Response for drop events that have missed any target */
-  onDropMissed?: (event: DragEvent) => void
-  /** Whether to automatically update the frustum each frame (default: true) */
-  autoUpdateFrustum?: boolean
-  /**
-   * Enable WebGPU occlusion queries for onOccluded/onVisible events.
-   * Auto-enabled when any object uses onOccluded or onVisible handlers.
-   * Only works with WebGPU renderer - WebGL will log a warning.
-   */
-  occlusion?: boolean
-  /** Internal: stored size props from Canvas for reset functionality */
-  _sizeProps?: { width?: number; height?: number } | null
-  /** Force canvas dimensions to even numbers (fixes Safari rendering issues with odd/fractional sizes) */
-  forceEven?: boolean
-}
-
-//* Reconciler Root ==============================
-
-interface ReconcilerRoot<TCanvas extends HTMLCanvasElement | OffscreenCanvas> {
-  configure: (config?: RenderProps<TCanvas>) => Promise<ReconcilerRoot<TCanvas>>
-  render: (element: ReactNode) => RootStore
-  unmount: () => void
-}
-
-//* Inject State ==============================
-
-type InjectState = Partial<
-  Omit<RootState, 'events'> & {
-    events?: {
-      enabled?: boolean
-      priority?: number
-      compute?: ComputeFunction
-      connected?: any
-    }
-    /**
-     * When true (default), injects a THREE.Scene between container and children if container isn't already a Scene.
-     * This ensures state.scene is always a real THREE.Scene with proper properties (background, environment, fog).
-     * Set to false to use the container directly as scene (anti-pattern, but supported for edge cases).
-     */
-    injectScene?: boolean
-  }
->
-
-//* Reconciler Types ==============================
-
-// FiberRoot is an opaque internal React type - we define it locally
-// to avoid bundling @types/react-reconciler which causes absolute path issues
-type FiberRoot = any
-
-interface Root {
-  fiber: FiberRoot
-  store: RootStore
-}
-
-type AttachFnType<O = any> = (parent: any, self: O) => () => void
-type AttachType<O = any> = string | AttachFnType<O>
-
-type ConstructorRepresentation<T = any> = new (...args: any[]) => T
-
-interface Catalogue {
-  [name: string]: ConstructorRepresentation
-}
-
-// TODO: handle constructor overloads
-// https://github.com/pmndrs/react-three-fiber/pull/2931
-// https://github.com/microsoft/TypeScript/issues/37079
-type Args<T> = T extends ConstructorRepresentation
-  ? T extends typeof Color$2
-    ? [r: number, g: number, b: number] | [color: ColorRepresentation$1]
-    : ConstructorParameters<T>
-  : any[]
-
-type ArgsProp<P> = P extends ConstructorRepresentation
-  ? IsAllOptional<ConstructorParameters<P>> extends true
-    ? { args?: Args<P> }
-    : { args: Args<P> }
-  : { args: unknown[] }
-
-type InstanceProps<T = any, P = any> = ArgsProp<P> & {
-  object?: T
-  dispose?: null
-  attach?: AttachType<T>
-}
-
-interface Instance<O = any> {
-  root: RootStore
-  type: string
-  parent: Instance | null
-  children: Instance[]
-  props: InstanceProps<O> & Record<string, unknown>
-  object: O & { __r3f?: Instance<O> }
-  eventCount: number
-  handlers: Partial<EventHandlers>
-  attach?: AttachType<O>
-  previousAttach?: any
-  isHidden: boolean
-  /** Set of props that have been applied via once() */
-  appliedOnce?: Set<string>
-}
-
-interface HostConfig {
-  type: string
-  props: Instance['props']
-  container: RootStore
-  instance: Instance
-  textInstance: void
-  suspenseInstance: Instance
-  hydratableInstance: never
-  formInstance: never
-  publicInstance: Instance['object']
-  hostContext: {}
-  childSet: never
-  timeoutHandle: number | undefined
-  noTimeout: -1
-  TransitionStatus: null
-}
-declare global {
-  var IS_REACT_ACT_ENVIRONMENT: boolean | undefined
-}
-
-//* Loop Types ==============================
-
-type GlobalRenderCallback = (timestamp: number) => void
-
-type GlobalEffectType = 'before' | 'after' | 'tail'
-
-declare const presetsObj: {
-    apartment: string;
-    city: string;
-    dawn: string;
-    forest: string;
-    lobby: string;
-    night: string;
-    park: string;
-    studio: string;
-    sunset: string;
-    warehouse: string;
-};
-type PresetsType = keyof typeof presetsObj;
-
-//* Background Types ==============================
-
-/**
- * Expanded object form for background configuration.
- * Allows separate textures for background (visual backdrop) and environment (PBR lighting).
- */
-interface BackgroundConfig {
-  /** HDRI preset name: 'apartment', 'city', 'dawn', 'forest', 'lobby', 'night', 'park', 'studio', 'sunset', 'warehouse' */
-  preset?: PresetsType
-  /** Files for cube texture (6 faces) or single HDR/EXR */
-  files?: string | string[]
-  /** Separate files for scene.background (visual backdrop) */
-  backgroundMap?: string | string[]
-  backgroundRotation?: Euler$2 | [number, number, number]
-  backgroundBlurriness?: number
-  backgroundIntensity?: number
-  /** Separate files for scene.environment (PBR lighting/reflections) */
-  envMap?: string | string[]
-  environmentRotation?: Euler$2 | [number, number, number]
-  environmentIntensity?: number
-  path?: string
-  extensions?: (loader: Loader) => void
-}
-
-/**
- * Background prop type for Canvas.
- *
- * String detection priority:
- * 1. Preset - exact match against known presets (apartment, city, dawn, forest, lobby, night, park, studio, sunset, warehouse)
- * 2. URL - starts with /, ./, ../, http://, https://, OR has image extension
- * 3. Color - default fallback (CSS color names, hex values, rgb(), etc.)
- *
- * @example Color
- * ```tsx
- * <Canvas background="red" />
- * <Canvas background="#ff0000" />
- * <Canvas background={0xff0000} />
- * ```
- *
- * @example Preset
- * ```tsx
- * <Canvas background="city" />
- * ```
- *
- * @example URL
- * ```tsx
- * <Canvas background="/path/to/env.hdr" />
- * <Canvas background="./sky.jpg" />
- * ```
- *
- * @example Object form
- * ```tsx
- * <Canvas background={{
- *   files: ['px.png', 'nx.png', 'py.png', 'ny.png', 'pz.png', 'nz.png'],
- *   backgroundMap: 'path/to/sky.jpg',
- *   envMap: 'path/to/lighting.hdr',
- *   backgroundBlurriness: 0.5,
- * }} />
- * ```
- */
-type BackgroundProp =
-  | ColorRepresentation$1 // "red", "#ff0000", 0xff0000
-  | string // URL or preset
-  | BackgroundConfig // Expanded object form
-
-//* Canvas Types ==============================
-
-interface CanvasProps
-  extends
-    Omit<RenderProps<HTMLCanvasElement>, 'size' | 'primaryCanvas' | 'scheduler'>,
-    React$1.HTMLAttributes<HTMLDivElement> {
-  children?: React$1.ReactNode
-  ref?: React$1.Ref<HTMLCanvasElement>
-  /** Canvas fallback content, similar to img's alt prop */
-  fallback?: React$1.ReactNode
-  /**
-   * Options to pass to useMeasure.
-   * @see https://github.com/pmndrs/react-use-measure#api
-   */
-  resize?: Options
-  /** The target where events are being subscribed to, default: the div that wraps canvas */
-  eventSource?: Element | React$1.RefObject<Element | null>
-  /** The event prefix that is cast into canvas pointer x/y events, default: "offset" */
-  eventPrefix?: 'offset' | 'client' | 'page' | 'layer' | 'screen'
-  /** Enable/disable automatic HMR refresh for TSL nodes and uniforms, default: true in dev */
-  hmr?: boolean
-  /** Canvas resolution width in pixels. If omitted, uses container width. */
-  width?: number
-  /** Canvas resolution height in pixels. If omitted, uses container height. */
-  height?: number
-  /** Force canvas dimensions to even numbers (fixes Safari rendering issues with odd/fractional sizes) */
-  forceEven?: boolean
-  /**
-   * Scene background configuration.
-   * Accepts colors, URLs, presets, or an expanded object for separate background/environment.
-   * @see BackgroundProp for full documentation and examples
-   */
-  background?: BackgroundProp
-}
-
-//* Loader Types ==============================
-
-type InputLike = string | string[] | string[][] | Readonly<string | string[] | string[][]>
-
-// Define a loader-like interface that matches THREE.Loader's load signature
-// This works for both generic and non-generic THREE.Loader instances
-interface LoaderLike {
-  load(
-    url: InputLike,
-    onLoad?: (result: any) => void,
-    onProgress?: (event: ProgressEvent<EventTarget>) => void,
-    onError?: (error: unknown) => void,
-  ): any
-}
-
-type GLTFLike = { scene: THREE$1.Object3D }
-
-type LoaderInstance<T extends LoaderLike | ConstructorRepresentation<LoaderLike>> =
-  T extends ConstructorRepresentation<LoaderLike> ? InstanceType<T> : T
-
-// Infer result type from the load method's callback parameter
-type InferLoadResult<T> = T extends {
-  load(url: any, onLoad?: (result: infer R) => void, ...args: any[]): any
-}
-  ? R
-  : T extends ConstructorRepresentation<any>
-    ? InstanceType<T> extends {
-        load(url: any, onLoad?: (result: infer R) => void, ...args: any[]): any
-      }
-      ? R
-      : any
-    : any
-
-type LoaderResult<T extends LoaderLike | ConstructorRepresentation<LoaderLike>> =
-  InferLoadResult<LoaderInstance<T>> extends infer R ? (R extends GLTFLike ? R & ObjectMap : R) : never
-
-type Extensions<T extends LoaderLike | ConstructorRepresentation<LoaderLike>> = (
-  loader: LoaderInstance<T>,
-) => void
-
-//* Renderer Props ========================================
-
-type WebGLDefaultProps = Omit<THREE$1.WebGLRendererParameters, 'canvas'> & BaseRendererProps
-
-type WebGLProps =
-  | RendererFactory<THREE$1.WebGLRenderer, WebGLDefaultProps>
-  | Partial<Properties<THREE$1.WebGLRenderer> | THREE$1.WebGLRendererParameters>
-
-interface WebGLShadowConfig {
-  shadows?: boolean | 'basic' | 'percentage' | 'soft' | 'variance' | Partial<THREE$1.WebGLShadowMap>
-}
-
-//* Legacy-specific Types ========================================
-
-/** Legacy (WebGL) renderer type - re-exported as R3FRenderer from @react-three/fiber/legacy */
-type LegacyRenderer = THREE$1.WebGLRenderer
-
-/** Legacy internal state with narrowed renderer type */
-interface LegacyInternalState extends Omit<InternalState, 'actualRenderer'> {
-  actualRenderer: THREE$1.WebGLRenderer
-}
-
-/**
- * Legacy-specific RootState with narrowed renderer type.
- * Automatically used when importing from `@react-three/fiber/legacy`.
- *
- * @example
- * ```tsx
- * import { useThree } from '@react-three/fiber/legacy'
- *
- * function MyComponent() {
- *   const { renderer } = useThree()
- *   // renderer is typed as THREE.WebGLRenderer
- *   renderer.shadowMap.enabled = true
- * }
- * ```
- */
-interface LegacyRootState extends Omit<RootState, 'renderer' | 'internal'> {
-  /** The WebGL renderer instance */
-  renderer: THREE$1.WebGLRenderer
-  /** Internals with WebGL renderer */
-  internal: LegacyInternalState
-}
-
-//* RenderTarget Types ==============================
-
-
-type RenderTargetOptions = RenderTargetOptions$1
-
-//* Global TSL Types ==============================
-
-declare global {
-  /**
-   * Broad callable-node fallback for dynamic store readers.
-   * Creator hooks preserve the exact function signatures inferred from Three's `Fn`.
-   */
-  type CallableTSLNode = ((...params: never[]) => unknown) & {
-    readonly shaderNode: unknown
-    readonly id: number
-  }
-
-  /** Legacy structural node accepted when at least one historical marker exists. */
-  type LegacyTSLNodeLike = {
-    label?: ((label: string) => unknown) | string
-    setName?: (name: string) => unknown
-  } & ({ uuid: string | undefined; nodeType?: string | null } | { uuid?: string; nodeType: string | null | undefined })
-
-  /** Node type accepted by broad dynamic node-store readers. */
-  type TSLNodeType = three_webgpu.Node | CallableTSLNode
-
-  /**
-   * Derive Three's shader node type from an existing node or a supported raw input.
-   * Existing InputNode generics take precedence over structural value normalization.
-   * Both generics must be inferred because Three's UniformNode intersects an unknown-typed
-   * InputNode base with its concrete InputNode specialization.
-   */
-  type UniformNodeType<T> = T extends three_webgpu.UniformNode<infer TNodeType, infer _TValue>
-    ? TNodeType
-    : T extends three_webgpu.InputNode<infer TNodeType, infer _TValue>
-      ? TNodeType
-      : T extends number
-        ? 'float'
-        : T extends boolean
-          ? 'bool'
-          : T extends string | three_webgpu.Color | { r: number; g: number; b: number }
-            ? 'color'
-            : T extends three_webgpu.Vector4 | { x: number; y: number; z: number; w: number }
-              ? 'vec4'
-              : T extends three_webgpu.Vector3 | { x: number; y: number; z: number }
-                ? 'vec3'
-                : T extends three_webgpu.Vector2 | { x: number; y: number }
-                  ? 'vec2'
-                  : T extends three_webgpu.Matrix4
-                    ? 'mat4'
-                    : T extends three_webgpu.Matrix3
-                      ? 'mat3'
-                      : T extends three_webgpu.Matrix2
-                        ? 'mat2'
-                        : unknown
-
-  /** Derive the normalized JavaScript value stored by a uniform node. */
-  type UniformNodeValue<T> = T extends three_webgpu.UniformNode<infer _TNodeType, infer TValue>
-    ? TValue
-    : T extends three_webgpu.InputNode<infer _TNodeType, infer TValue>
-      ? TValue
-      : T extends string | { r: number; g: number; b: number }
-        ? three_webgpu.Color
-        : T extends { x: number; y: number; z: number; w: number }
-          ? three_webgpu.Vector4
-          : T extends { x: number; y: number; z: number }
-            ? three_webgpu.Vector3
-            : T extends { x: number; y: number }
-              ? three_webgpu.Vector2
-              : T extends number
-                ? number
-                : T extends boolean
-                  ? boolean
-                  : T
-
-  /** Three's exact UniformNode with shader and value generics derived from an input. */
-  type UniformNodeFor<T> = three_webgpu.UniformNode<UniformNodeType<T>, UniformNodeValue<T>>
-
-  /** Preserve every input key while mapping values to exact Three uniform nodes. */
-  type UniformNodesFor<T extends UniformInputRecord> = {
-    [K in keyof T]: UniformNodeFor<T[K]>
-  }
-
-  /** Backward-compatible single-parameter uniform alias. */
-  type UniformNode<T = unknown> = UniformNodeFor<T>
-
-  /** Flat record of uniform nodes (no nested scopes) */
-  type UniformRecord<T extends UniformNode = UniformNode> = Record<string, T>
-
-  /**
-   * Uniform store that can contain both root-level uniforms and scoped uniform objects
-   * Used by state.uniforms which has structure like:
-   * { uTime: UniformNode, player: { uHealth: UniformNode }, enemy: { uHealth: UniformNode } }
-   */
-  type UniformStore = Record<string, UniformNode | UniformRecord>
-
-  /**
-   * Helper to safely access a uniform node from the store.
-   * Use this when accessing state.uniforms to get proper typing.
-   * @example
-   * const uTime = uniforms.uTime as UniformNode<number>
-   * const uColor = uniforms.uColor as UniformNode<import('three/webgpu').Color>
-   */
-  type GetUniform<T = unknown> = UniformNode<T>
-
-  /**
-   * Acceptable input values for useUniforms - raw values that get converted to UniformNodes
-   * Supports:
-   * - Primitives: number, string (color), boolean
-   * - Three.js types: Color, Vector2/3/4, Matrix2/3/4
-   * - Plain objects: { x, y, z, w } converted to vectors
-   * - TSL nodes: color(), vec3(), float() for type casting
-   * - UniformNode: existing uniforms (reused as-is)
-   */
-  type UniformValue =
-    | number
-    | string
-    | boolean
-    | three_webgpu.Color
-    | three_webgpu.Vector2
-    | three_webgpu.Vector3
-    | three_webgpu.Vector4
-    | three_webgpu.Matrix2
-    | three_webgpu.Matrix3
-    | three_webgpu.Matrix4
-    | { x: number; y: number }
-    | { x: number; y: number; z: number }
-    | { x: number; y: number; z: number; w: number }
-    | { r: number; g: number; b: number; a?: number } // Plain objects converted to Color
-    | three_webgpu.Node // TSL nodes like color(), vec3(), float() for type casting
-    | UniformNode
-
-  /** Input record for useUniforms - accepts raw values or UniformNodes */
-  type UniformInputRecord = Record<string, UniformValue>
-}
-
-declare global {
-  /**
-   * three's own render pipeline type. Named here so the rest of R3F refers to three's shape
-   * rather than `any`. three r183 renamed `PostProcessing` to `RenderPipeline`; our peer floor
-   * is r185, so the new name is the only one.
-   */
-  type ThreeRenderPipeline = three_webgpu.RenderPipeline
-
-  /**
-   * The pass `useRenderPipeline` creates for you: three's own `PassNode`, as returned by
-   * `pass(scene, camera)` from `three/tsl`. Referenced from three so members like
-   * `getTextureNode`, `setMRT` and `dispose` track the installed version.
-   */
-  type ScenePassNode = three_webgpu.PassNode
-
-  /**
-   * Pass record - stores TSL pass nodes for render pipeline.
-   *
-   * `scenePass` is the only key the library owns. It is optional here because this is also the
-   * shape of `state.passes`, which is `{}` before the pipeline exists and again after `reset()`
-   * or `clearPasses()`. Inside the callbacks it is always present; see
-   * {@link RenderPipelineCallbackState}.
-   *
-   * Every other key is user-registered, via a callback's return value. Those are TSL nodes of
-   * any kind, not only passes: texture reads of an MRT attachment, effect nodes, extra
-   * `pass()` instances. `Node` is the common base, so that is the bound. Narrow at the call
-   * site when you need a member, e.g. `passes.velocity as TextureNode`.
-   *
-   * The index signature admits `undefined` because a key may simply not be registered, and
-   * because the optional `scenePass` must be assignable to it: under `skipLibCheck: false` an
-   * optional property whose type excludes `undefined` from the index signature is an error
-   * (TS2411) for every consumer compiling these declarations.
-   */
-  interface PassRecord {
-    scenePass?: ScenePassNode
-    [key: string]: three_webgpu.Node | undefined
-  }
-
-  /**
-   * State passed to pipeline callbacks after the active pipeline has been created.
-   *
-   * `passes.scenePass` is required here: the hook installs the default scene pass before either
-   * callback runs, so callbacks can use it without a guard or a cast.
-   *
-   * `renderer` is narrowed to `WebGPURenderer` and `isLegacy` to `false`: the hook throws under
-   * the legacy renderer before either callback can run, so a callback never sees WebGL.
-   */
-  type RenderPipelineCallbackState = RootState & {
-    renderPipeline: ThreeRenderPipeline
-    passes: PassRecord & { scenePass: ScenePassNode }
-    renderer: three_webgpu.WebGPURenderer
-    isLegacy: false
-  }
-
-  /**
-   * What a callback may return to register entries into `state.passes`.
-   *
-   * `scenePass` is reserved. The hook owns that entry and its lifecycle: it caches the pass it
-   * created, and `rebuild()` / `reset()` dispose that cached pass. A callback overwriting the
-   * store entry would leave the store pointing at a node the hook never disposes, and the hook
-   * disposing a pass nothing references. So returning it is a type error.
-   */
-  type RegisteredPasses = Record<string, three_webgpu.Node> & { scenePass?: never }
-
-  /** Setup callback - runs first to configure MRT, create additional passes */
-  type RenderPipelineSetupCallback = (state: RenderPipelineCallbackState) => RegisteredPasses | void
-
-  /** Main callback - runs second to configure outputNode, create effect passes */
-  type RenderPipelineMainCallback = (state: RenderPipelineCallbackState) => RegisteredPasses | void
-
-  /** The imperative half of useRenderPipeline's return value, present in every state */
-  interface UseRenderPipelineActions {
-    /** Current passes from state */
-    passes: PassRecord
-    /** Clear all passes from state */
-    clearPasses: () => void
-    /** Reset RenderPipeline entirely (clears PP + passes) */
-    reset: () => void
-    /** Re-run setup/main callbacks with current closure values */
-    rebuild: () => void
-  }
-
-  /**
-   * Return type for useRenderPipeline hook, discriminated on `isReady`.
-   *
-   * `if (isReady)` narrows `renderPipeline` to non-null, which is what the docs already tell
-   * callers to check. `passes.scenePass` deliberately stays optional in the ready branch:
-   * `clearPasses()` empties the record while leaving the pipeline in place.
-   */
-  type UseRenderPipelineReturn = UseRenderPipelineActions &
-    (
-      | {
-          /** True when RenderPipeline is configured and ready */
-          isReady: true
-          /** RenderPipeline instance */
-          renderPipeline: ThreeRenderPipeline
-        }
-      | {
-          /** False until the pipeline has been created */
-          isReady: false
-          /** Not initialized yet, or torn down by reset() */
-          renderPipeline: null
-        }
-    )
-}
-
-declare const context: React$1.Context<RootStore>;
+declare const context: React.Context<RootStore>;
 
 /**
  * Returns the R3F Canvas' Zustand store. Useful for [transient updates](https://github.com/pmndrs/zustand#transient-updates-for-often-occurring-state-changes).
@@ -1672,4 +626,4 @@ declare function registerRootExtension(extension: RootExtension): () => void;
 declare function setRenderOverride(store: RootStore, render: (() => void) | null): void;
 
 export { context, registerRootExtension, setRenderOverride, useFrame, useStore, useThree };
-export type { Act, Args, ArgsProp, AttachFnType, AttachType, BackgroundConfig, BackgroundProp, BaseRendererProps, Bridge, BufferLike, BufferRecord, BufferStore, Camera, CameraProps, CanvasProps, CanvasSchedulerConfig, Catalogue, Color, ColorManagementConfig, ComputeFunction, ConstructorRepresentation, DefaultGLProps, DefaultRendererProps, Disposable, DomEvent, Dpr, ElementProps, EquConfig, Euler, EventHandlers, EventManager, EventProps, Events, Extensions, FiberRoot, FilterFunction, FrameCallback, FrameNextCallback, FrameNextState, FrameState, Frameloop, GLProps, GLTFLike, GeometryProps, GeometryTransformProps, GlobalEffectType, GlobalRenderCallback, HostConfig, InferLoadResult, InjectState, InputLike, Instance, InstanceProps, InternalState, Intersection, IntersectionEvent, IsAllOptional, IsOptional, Layers, LegacyInternalState, LegacyRenderer, LegacyRootState, LoaderInstance, LoaderLike, LoaderResult, MathProps, MathRepresentation, MathType, MathTypes, Matrix3, Matrix4, Mutable, MutableOrReadonlyParameters, NodeLike, NodeProps, NodeRecord, NodeStore, NonFunctionKeys, Object3DMethod, ObjectMap, OffscreenCanvas, Overwrite, Performance, PointerCaptureTarget, PointerState, Properties, Quaternion, R3FRenderer, RaycastableRepresentation, ReactProps, ReconcilerRoot, RenderCallback, RenderProps, RenderTargetOptions, Renderer, RendererConfigExtended, RendererFactory, RendererProps, Root, RootExtension, RootState, RootStore, SetBlock, Size, StorageLike, StorageRecord, StorageStore, Subscription, TSLNodeInput, ThreeCamera, ThreeElement, ThreeElements, ThreeElementsImpl, ThreeEvent, ThreeExports, ThreeToJSXElements, UnblockProps, Vector2, Vector3, Vector4, VectorRepresentation, Viewport, VisibilityEntry, WebGLDefaultProps, WebGLProps, WebGLShadowConfig, XRManager, XRPointerConfig };
+export type { Act, Bridge, Camera, ComputeFunction, Disposable, DomEvent, Dpr, EquConfig, EventHandlers, EventManager, Events, FilterFunction, FrameCallback, FrameNextCallback, FrameNextState, FrameState, Frameloop, InternalState, Intersection, IntersectionEvent, IsAllOptional, IsOptional, Mutable, NonFunctionKeys, ObjectMap, Overwrite, Performance, PointerCaptureTarget, PointerState, Properties, R3FRenderer, RenderCallback, RootExtension, RootState, RootStore, SetBlock, Size, Subscription, ThreeCamera, ThreeEvent, UnblockProps, Viewport, VisibilityEntry, XRManager, XRPointerConfig };