@react-three/fiber 10.0.0-canary.b0fafc8 → 10.0.0-canary.c3fa45d

package/dist/webgpu/index.d.cts

@@ -1,5 +1,5 @@
 import * as three_webgpu from 'three/webgpu';
-import { RenderTarget, WebGPURenderer, CanvasTarget, Node, ShaderNodeObject, Euler as Euler$2, Color as Color$2, ColorRepresentation as ColorRepresentation$1, Layers as Layers$1, Raycaster, Intersection as Intersection$1, BufferGeometry, Matrix4 as Matrix4$1, Quaternion as Quaternion$1, Vector2 as Vector2$1, Vector3 as Vector3$1, Vector4 as Vector4$1, Matrix3 as Matrix3$1, Loader as Loader$1, ColorSpace, Texture as Texture$1, CubeTexture, Scene, Object3D, Frustum, OrthographicCamera, WebGPURendererParameters } from 'three/webgpu';
+import { RenderTarget, WebGPURenderer, Node, StorageTexture, Data3DTexture, CanvasTarget, ShaderNodeObject, Euler as Euler$2, Color as Color$2, ColorRepresentation as ColorRepresentation$1, Layers as Layers$1, Raycaster, Intersection as Intersection$1, BufferGeometry, Matrix4 as Matrix4$1, Quaternion as Quaternion$1, Vector2 as Vector2$1, Vector3 as Vector3$1, Vector4 as Vector4$1, Matrix3 as Matrix3$1, Loader as Loader$1, ColorSpace, Texture as Texture$1, CubeTexture, Scene, Object3D, Frustum, OrthographicCamera, WebGPURendererParameters } from 'three/webgpu';
 import { Inspector } from 'three/addons/inspector/Inspector.js';
 import * as THREE$1 from 'three';
 import { Color as Color$1, ColorRepresentation, Euler as Euler$1, Loader, RenderTargetOptions as RenderTargetOptions$1 } from 'three';
@@ -151,6 +151,8 @@ interface IntersectionEvent<TSourceEvent> extends Intersection {
   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 */
@@ -227,6 +229,18 @@ interface EventHandlers {
 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
@@ -246,8 +260,21 @@ interface EventManager<TTarget> {
   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?: () => void
+  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 {
@@ -489,6 +516,68 @@ interface SchedulerApi {
   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 */
@@ -502,6 +591,18 @@ type Subscription = {
   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 {
@@ -543,12 +644,21 @@ interface Performance {
 
 interface InternalState {
   interaction: THREE$1.Object3D[]
-  hovered: Map<string, ThreeEvent<DomEvent>>
   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[]
-  lastEvent: React$1.RefObject<DomEvent | null>
   /** Visibility event registry (onFramed, onOccluded, onVisible) */
   visibilityRegistry: Map<string, VisibilityEntry>
   /** Whether occlusion queries are enabled (WebGPU only) */
@@ -689,11 +799,15 @@ interface RootState {
   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 PostProcessing instance - use usePostProcessing() hook */
-  postProcessing: any | null // THREE.PostProcessing when available
-  /** Global TSL pass nodes for post-processing - use usePostProcessing() hook */
+  /** 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
@@ -743,6 +857,20 @@ 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'> & {
@@ -753,7 +881,7 @@ type GLProps =
   | Renderer
   | ((defaultProps: DefaultGLProps) => Renderer)
   | ((defaultProps: DefaultGLProps) => Promise<Renderer>)
-  | Partial<Properties<THREE$1.WebGLRenderer> | THREE$1.WebGLRendererParameters>
+  | (Partial<Properties<THREE$1.WebGLRenderer> | THREE$1.WebGLRendererParameters> & ColorManagementConfig)
 
 //* WebGPU Renderer Props ==============================
 
@@ -779,9 +907,9 @@ interface CanvasSchedulerConfig {
 }
 
 /**
- * Extended renderer configuration for multi-canvas support.
+ * Extended renderer configuration for multi-canvas support and color management.
  */
-interface RendererConfigExtended {
+interface RendererConfigExtended extends ColorManagementConfig {
   /** Share renderer from another canvas (WebGPU only) */
   primaryCanvas?: string
   /** Canvas-level scheduler options */
@@ -846,8 +974,6 @@ interface RenderProps<TCanvas extends HTMLCanvasElement | OffscreenCanvas$1> {
    * @see https://threejs.org/docs/#api/en/renderers/WebGLRenderer.shadowMap
    */
   shadows?: boolean | 'basic' | 'percentage' | 'soft' | 'variance' | Partial<THREE$1.WebGLShadowMap>
-  /** Color space assigned to 8-bit input textures (color maps). Defaults to sRGB. Most textures are authored in sRGB. */
-  textureColorSpace?: THREE$1.ColorSpace
   /** Creates an orthographic camera */
   orthographic?: boolean
   /**
@@ -1100,7 +1226,7 @@ interface CanvasProps
    */
   resize?: Options
   /** The target where events are being subscribed to, default: the div that wraps canvas */
-  eventSource?: HTMLElement | React$1.RefObject<HTMLElement>
+  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 */
@@ -1314,6 +1440,7 @@ declare global {
     | 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
 
@@ -1359,34 +1486,34 @@ declare module 'three/tsl' {
 }
 
 /**
- * PostProcessing Types for usePostProcessing hook (WebGPU only)
+ * RenderPipeline Types for useRenderPipeline hook (WebGPU only)
  */
 
 
 
 declare global {
-  /** Pass record - stores TSL pass nodes for post-processing */
+  /** 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 PostProcessingSetupCallback = (state: RootState) => PassRecord | void
+  type RenderPipelineSetupCallback = (state: RootState) => PassRecord | void
 
   /** Main callback - runs second to configure outputNode, create effect passes */
-  type PostProcessingMainCallback = (state: RootState) => PassRecord | void
+  type RenderPipelineMainCallback = (state: RootState) => PassRecord | void
 
-  /** Return type for usePostProcessing hook */
-  interface UsePostProcessingReturn {
+  /** Return type for useRenderPipeline hook */
+  interface UseRenderPipelineReturn {
     /** Current passes from state */
     passes: PassRecord
-    /** PostProcessing instance (null if not initialized) */
-    postProcessing: any | null // THREE.PostProcessing
+    /** 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 PostProcessing entirely (clears PP + passes) */
+    /** Reset RenderPipeline entirely (clears PP + passes) */
     reset: () => void
     /** Re-run setup/main callbacks with current closure values */
     rebuild: () => void
-    /** True when PostProcessing is configured and ready */
+    /** True when RenderPipeline is configured and ready */
     isReady: boolean
   }
 }
@@ -2006,6 +2133,8 @@ declare function Environment(props: EnvironmentProps): react_jsx_runtime.JSX.Ele
 declare function removeInteractivity(store: RootStore, object: Object3D): void;
 declare function createEvents(store: RootStore): {
     handlePointer: (name: string) => (event: DomEvent) => void;
+    flushDeferredPointers: () => void;
+    processDeferredPointer: (event: DomEvent, pointerId: number) => void;
 };
 /** Default R3F event manager for web */
 declare function createPointerEvents(store: RootStore): EventManager<HTMLElement>;
@@ -2585,9 +2714,9 @@ declare function useTextures(): UseTexturesReturn;
  * const fbo = useRenderTarget(512, 256, { samples: 4 })
  * ```
  */
-declare function useRenderTarget(options?: RenderTargetOptions): RenderTarget | WebGLRenderTarget;
-declare function useRenderTarget(size: number, options?: RenderTargetOptions): RenderTarget | WebGLRenderTarget;
-declare function useRenderTarget(width: number, height: number, options?: RenderTargetOptions): RenderTarget | WebGLRenderTarget;
+declare function useRenderTarget(options?: RenderTargetOptions): RenderTarget;
+declare function useRenderTarget(size: number, options?: RenderTargetOptions): RenderTarget;
+declare function useRenderTarget(width: number, height: number, options?: RenderTargetOptions): RenderTarget;
 
 /**
  * Returns the R3F Canvas' Zustand store. Useful for [transient updates](https://github.com/pmndrs/zustand#transient-updates-for-often-occurring-state-changes).
@@ -4300,13 +4429,17 @@ type ScopedStoreType<T> = {
 declare function createScopedStore<T>(data: Record<string, any>): ScopedStoreType<T>;
 /**
  * State type passed to creator functions with ScopedStore wrappers.
- * Provides type-safe access to uniforms and nodes without manual casting.
+ * Provides type-safe access to uniforms, nodes, buffers, and gpuStorage without manual casting.
  */
-type CreatorState = Omit<RootState, 'uniforms' | 'nodes'> & {
+type CreatorState = Omit<RootState, 'uniforms' | 'nodes' | 'buffers' | 'gpuStorage'> & {
     /** Type-safe uniform access - property access returns UniformNode */
     uniforms: ScopedStoreType<UniformNode>;
     /** Type-safe node access - property access returns TSLNodeType (Node | ShaderCallable | ShaderNodeObject) */
     nodes: ScopedStoreType<TSLNodeType>;
+    /** Type-safe buffer access - property access returns BufferLike (TypedArrays, BufferAttributes, TSL nodes) */
+    buffers: ScopedStoreType<BufferLike>;
+    /** Type-safe GPU storage access - property access returns StorageLike (StorageTexture, TSL nodes) */
+    gpuStorage: ScopedStoreType<StorageLike>;
 };
 
 /** Creator function that returns uniform inputs (can be raw values or UniformNodes) */
@@ -4470,6 +4603,74 @@ type LocalNodeCreator<T extends Record<string, unknown>> = (state: CreatorState)
  */
 declare function useLocalNodes<T extends Record<string, unknown>>(creator: LocalNodeCreator<T>): T;
 
+/**
+ * Creator function that returns a record of buffers.
+ * Receives CreatorState with access to existing buffers, gpuStorage, uniforms, nodes, etc.
+ */
+type BufferCreator<T extends Record<string, BufferLike>> = (state: CreatorState) => T;
+/** Function signature for removeBuffers util */
+type RemoveBuffersFn = (names: string | string[], scope?: string) => void;
+/** Function signature for clearBuffers util */
+type ClearBuffersFn = (scope?: string) => void;
+/** Function signature for rebuildBuffers util */
+type RebuildBuffersFn = (scope?: string) => void;
+/** Function signature for disposeBuffers util - releases GPU resources */
+type DisposeBuffersFn = (names: string | string[], scope?: string) => void;
+/** Return type with utils included */
+type BuffersWithUtils<T extends Record<string, BufferLike> = Record<string, BufferLike>> = T & {
+    removeBuffers: RemoveBuffersFn;
+    clearBuffers: ClearBuffersFn;
+    rebuildBuffers: RebuildBuffersFn;
+    disposeBuffers: DisposeBuffersFn;
+};
+declare function useBuffers(): BuffersWithUtils<Record<string, BufferLike> & Record<string, Record<string, BufferLike>>>;
+declare function useBuffers(scope: string): BuffersWithUtils<Record<string, BufferLike>>;
+declare function useBuffers<T extends Record<string, BufferLike>>(creator: BufferCreator<T>): BuffersWithUtils<T>;
+declare function useBuffers<T extends Record<string, BufferLike>>(creator: BufferCreator<T>, scope: string): BuffersWithUtils<T>;
+/**
+ * Global rebuildBuffers function for HMR integration.
+ * Clears cached buffers and increments _hmrVersion to trigger re-creation.
+ * Call this when HMR is detected to refresh all buffer creators.
+ *
+ * @param store - The R3F store (from useStore or context)
+ * @param scope - Optional scope to rebuild ('root' for root only, string for specific scope, undefined for all)
+ */
+declare function rebuildAllBuffers(store: ReturnType<typeof useStore>, scope?: string): void;
+
+/**
+ * Creator function that returns a record of GPU storage objects.
+ * Receives CreatorState with access to existing buffers, gpuStorage, uniforms, nodes, etc.
+ */
+type StorageCreator<T extends Record<string, StorageLike>> = (state: CreatorState) => T;
+/** Function signature for removeStorage util */
+type RemoveStorageFn = (names: string | string[], scope?: string) => void;
+/** Function signature for clearStorage util */
+type ClearStorageFn = (scope?: string) => void;
+/** Function signature for rebuildStorage util */
+type RebuildStorageFn = (scope?: string) => void;
+/** Function signature for disposeStorage util - releases GPU resources */
+type DisposeStorageFn = (names: string | string[], scope?: string) => void;
+/** Return type with utils included */
+type StorageWithUtils<T extends Record<string, StorageLike> = Record<string, StorageLike>> = T & {
+    removeStorage: RemoveStorageFn;
+    clearStorage: ClearStorageFn;
+    rebuildStorage: RebuildStorageFn;
+    disposeStorage: DisposeStorageFn;
+};
+declare function useGPUStorage(): StorageWithUtils<Record<string, StorageLike> & Record<string, Record<string, StorageLike>>>;
+declare function useGPUStorage(scope: string): StorageWithUtils<Record<string, StorageLike>>;
+declare function useGPUStorage<T extends Record<string, StorageLike>>(creator: StorageCreator<T>): StorageWithUtils<T>;
+declare function useGPUStorage<T extends Record<string, StorageLike>>(creator: StorageCreator<T>, scope: string): StorageWithUtils<T>;
+/**
+ * Global rebuildStorage function for HMR integration.
+ * Clears cached storage and increments _hmrVersion to trigger re-creation.
+ * Call this when HMR is detected to refresh all storage creators.
+ *
+ * @param store - The R3F store (from useStore or context)
+ * @param scope - Optional scope to rebuild ('root' for root only, string for specific scope, undefined for all)
+ */
+declare function rebuildAllStorage(store: ReturnType<typeof useStore>, scope?: string): void;
+
 interface TextureOperations {
     add: (key: string, value: any) => void;
     addMultiple: (items: Map<string, any> | Record<string, any>) => void;
@@ -4479,10 +4680,10 @@ interface TextureOperations {
 declare function createTextureOperations(set: StoreApi<RootState>['setState']): TextureOperations;
 
 /**
- * Hook for managing WebGPU PostProcessing with automatic scenePass setup.
+ * Hook for managing WebGPU RenderPipeline with automatic scenePass setup.
  *
  * Features:
- * - Creates PostProcessing instance if not exists
+ * - Creates RenderPipeline instance if not exists
  * - Creates default scenePass (no MRT) automatically
  * - Callbacks receive full RootState for flexibility
  * - No auto-cleanup on unmount - use reset() for explicit cleanup
@@ -4490,21 +4691,21 @@ declare function createTextureOperations(set: StoreApi<RootState>['setState']):
  *
  * @param mainCB - Main callback to configure outputNode and create effect passes
  * @param setupCB - Optional setup callback to configure MRT on scenePass
- * @returns { passes, postProcessing, clearPasses, reset, rebuild }
+ * @returns { passes, renderPipeline, clearPasses, reset, rebuild }
  *
  * @example
  * ```tsx
  * // Simple effect
- * usePostProcessing(({ postProcessing, passes }) => {
- *   postProcessing.outputNode = bloom(passes.scenePass.getTextureNode())
+ * useRenderPipeline(({ renderPipeline, passes }) => {
+ *   renderPipeline.outputNode = bloom(passes.scenePass.getTextureNode())
  * })
  *
  * // With MRT setup
- * usePostProcessing(
- *   ({ postProcessing, passes }) => {
+ * useRenderPipeline(
+ *   ({ renderPipeline, passes }) => {
  *     const beauty = passes.scenePass.getTextureNode().toInspector('Color')
  *     const vel = passes.scenePass.getTextureNode('velocity')
- *     postProcessing.outputNode = motionBlur(beauty, vel)
+ *     renderPipeline.outputNode = motionBlur(beauty, vel)
  *   },
  *   ({ passes }) => {
  *     passes.scenePass.setMRT(mrt({ output, velocity }))
@@ -4512,10 +4713,10 @@ declare function createTextureOperations(set: StoreApi<RootState>['setState']):
  * )
  *
  * // Read-only access
- * const { postProcessing, passes } = usePostProcessing()
+ * const { renderPipeline, passes } = useRenderPipeline()
  * ```
  */
-declare function usePostProcessing(mainCB?: PostProcessingMainCallback, setupCB?: PostProcessingSetupCallback): UsePostProcessingReturn;
+declare function useRenderPipeline(mainCB?: RenderPipelineMainCallback, setupCB?: RenderPipelineSetupCallback): UseRenderPipelineReturn;
 
 //* Renderer Props ========================================
 
@@ -4564,5 +4765,5 @@ interface WebGPURootState extends Omit<RootState, 'renderer' | 'gl' | 'internal'
   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, rebuildAllNodes, rebuildAllUniforms, reconciler, registerPrimary, removeInteractivity, removeNodes, removeUniforms, resolve, unmountComponentAtNode, unregisterPrimary, updateCamera, updateFrustum, useBridge, useEnvironment, useFrame, useGraph, useInstanceHandle, useIsomorphicLayoutEffect, useLoader, useLocalNodes, useMutableCallback, useNodes, usePostProcessing, useRenderTarget, useStore, useTexture, useTextures, useThree, useUniform, useUniforms, waitForPrimary };
-export type { Act, AddPhaseOptions, Args, ArgsProp, AttachFnType, AttachType, BackgroundConfig, BackgroundProp, BaseRendererProps, Bridge, Camera, CameraProps, CanvasProps, CanvasSchedulerConfig, Catalogue, ClearNodesFn, ClearUniformsFn, Color, ComputeFunction, ConstructorRepresentation, CreatorState, DefaultGLProps, DefaultRendererProps, Disposable, DomEvent, Dpr, ElementProps, EnvironmentLoaderProps, EnvironmentProps, EquConfig, Euler, EventHandlers, EventManager, EventProps, Events, Extensions, FiberRoot, FilterFunction, FrameCallback, FrameControls, FrameNextCallback, FrameNextControls, FrameNextState, FrameState, FrameTimingState, Frameloop, GLProps, GLTFLike, GeometryProps, GeometryTransformProps, GlobalEffectType, GlobalRenderCallback, HostConfig, InferLoadResult, InjectState, InputLike, Instance, InstanceProps, WebGPUInternalState as InternalState, Intersection, IntersectionEvent, IsAllOptional, IsOptional, Layers, LegacyInternalState, LegacyRenderer, LegacyRootState, LoaderInstance, LoaderLike, LoaderResult, LocalNodeCreator, MappedTextureType, MathProps, MathRepresentation, MathType, MathTypes, Matrix3, Matrix4, Mutable, MutableOrReadonlyParameters, NodeCreator, NodeProps, NodeRecord, NodesWithUtils, NonFunctionKeys, ObjectMap, OffscreenCanvas$1 as OffscreenCanvas, Overwrite, Performance, PointerCaptureTarget, PresetsType, PrimaryCanvasEntry, Properties, Quaternion, WebGPUR3FRenderer as R3FRenderer, RaycastableRepresentation, ReactProps, RebuildNodesFn, RebuildUniformsFn, ReconcilerRoot, RemoveNodesFn, RemoveUniformsFn, RenderCallback, RenderProps, RenderTargetOptions, Renderer, RendererConfigExtended, RendererFactory, RendererProps, Root, RootOptions, WebGPURootState as RootState, RootStore, SchedulerApi, ScopedStoreType, SetBlock, Size, Subscription, TSLNode, TSLNodeInput, TextureEntry, TextureOperations, ThreeCamera, ThreeElement, ThreeElements, ThreeElementsImpl, ThreeEvent, ThreeExports, ThreeToJSXElements, UnblockProps, UniformCreator, UniformValue, UniformsWithUtils, UseFrameNextOptions, UseFrameOptions, UseTextureOptions, UseTexturesReturn, Vector2, Vector3, Vector4, VectorRepresentation, Viewport, VisibilityEntry, WebGLDefaultProps, WebGLProps, WebGLShadowConfig, WebGPUDefaultProps, WebGPUProps, WebGPUShadowConfig, XRManager };
+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 };
+export type { Act, AddPhaseOptions, Args, ArgsProp, AttachFnType, AttachType, BackgroundConfig, BackgroundProp, BaseRendererProps, Bridge, BufferCreator, BufferLike, BufferRecord, BufferStore, BuffersWithUtils, Camera, CameraProps, CanvasProps, CanvasSchedulerConfig, Catalogue, ClearBuffersFn, ClearNodesFn, ClearStorageFn, ClearUniformsFn, Color, ColorManagementConfig, ComputeFunction, ConstructorRepresentation, CreatorState, DefaultGLProps, DefaultRendererProps, Disposable, DisposeBuffersFn, DisposeStorageFn, DomEvent, Dpr, ElementProps, EnvironmentLoaderProps, EnvironmentProps, EquConfig, Euler, EventHandlers, EventManager, EventProps, Events, Extensions, FiberRoot, FilterFunction, FrameCallback, FrameControls, FrameNextCallback, FrameNextControls, FrameNextState, FrameState, FrameTimingState, Frameloop, GLProps, GLTFLike, GeometryProps, GeometryTransformProps, GlobalEffectType, GlobalRenderCallback, HostConfig, InferLoadResult, InjectState, InputLike, Instance, InstanceProps, WebGPUInternalState as InternalState, Intersection, IntersectionEvent, IsAllOptional, IsOptional, Layers, LegacyInternalState, LegacyRenderer, LegacyRootState, LoaderInstance, LoaderLike, LoaderResult, LocalNodeCreator, MappedTextureType, MathProps, MathRepresentation, MathType, MathTypes, Matrix3, Matrix4, Mutable, MutableOrReadonlyParameters, NodeCreator, NodeProps, NodeRecord, NodesWithUtils, NonFunctionKeys, ObjectMap, OffscreenCanvas$1 as OffscreenCanvas, Overwrite, Performance, PointerCaptureTarget, PointerState, PresetsType, PrimaryCanvasEntry, Properties, Quaternion, WebGPUR3FRenderer as R3FRenderer, RaycastableRepresentation, ReactProps, RebuildBuffersFn, RebuildNodesFn, RebuildStorageFn, RebuildUniformsFn, ReconcilerRoot, RemoveBuffersFn, RemoveNodesFn, RemoveStorageFn, RemoveUniformsFn, RenderCallback, RenderProps, RenderTargetOptions, Renderer, RendererConfigExtended, RendererFactory, RendererProps, Root, RootOptions, WebGPURootState as RootState, RootStore, SchedulerApi, ScopedStoreType, SetBlock, Size, StorageCreator, StorageLike, StorageRecord, StorageStore, StorageWithUtils, Subscription, TSLNode, TSLNodeInput, TextureEntry, TextureOperations, ThreeCamera, ThreeElement, ThreeElements, ThreeElementsImpl, ThreeEvent, ThreeExports, ThreeToJSXElements, UnblockProps, UniformCreator, UniformValue, UniformsWithUtils, UseFrameNextOptions, UseFrameOptions, UseTextureOptions, UseTexturesReturn, Vector2, Vector3, Vector4, VectorRepresentation, Viewport, VisibilityEntry, WebGLDefaultProps, WebGLProps, WebGLShadowConfig, WebGPUDefaultProps, WebGPUProps, WebGPUShadowConfig, XRManager, XRPointerConfig };