@react-three/fiber 10.0.0-canary.8f5b4d3 → 10.0.0-canary.ac30da2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,3 +1,4 @@
1
+ import * as three_examples_jsm_inspector_Inspector_js from 'three/examples/jsm/inspector/Inspector.js';
1
2
  import * as three_webgpu from 'three/webgpu';
2
3
  import { CubeRenderTarget, 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';
3
4
  import { Inspector } from 'three/addons/inspector/Inspector.js';
@@ -40,6 +41,8 @@ function _mergeNamespaces(n, m) {
40
41
  declare const R3F_BUILD_LEGACY = false;
41
42
  declare const R3F_BUILD_WEBGPU = true;
42
43
 
44
+ /** Lazily load the three Inspector. Keeps it out of the eager module graph — see note above. */
45
+ declare function loadInspector(): Promise<typeof three_examples_jsm_inspector_Inspector_js.Inspector>;
43
46
  declare const WebGLRenderer: {
44
47
  new (): {};
45
48
  };
@@ -61,7 +64,8 @@ var THREE = /*#__PURE__*/_mergeNamespaces({
61
64
  WebGLRenderTarget: WebGLRenderTarget,
62
65
  WebGLRenderer: WebGLRenderer,
63
66
  WebGLRendererParameters: WebGLRendererParameters,
64
- WebGLShadowMap: WebGLShadowMap
67
+ WebGLShadowMap: WebGLShadowMap,
68
+ loadInspector: loadInspector
65
69
  }, [three_webgpu]);
66
70
 
67
71
  //* Utility Types ==============================
@@ -499,6 +503,18 @@ interface InternalState {
499
503
  * @see https://threejs.org/docs/#api/en/renderers/common/CanvasTarget
500
504
  */
501
505
  canvasTarget?: CanvasTarget
506
+ /**
507
+ * Set when this root's canvas target has been resized and the backend's cached render pass
508
+ * descriptor (which holds a depth-stencil view built once per canvas) is therefore stale.
509
+ *
510
+ * Flushed by the canvas-target job in the `start` phase, which is the only place this root's
511
+ * target is guaranteed to be the renderer's active one — `backend.updateSize()` operates on
512
+ * whatever `getCanvasTarget()` returns, so calling it from the resize subscription would
513
+ * invalidate some other canvas's descriptor instead.
514
+ *
515
+ * @see https://github.com/pmndrs/react-three-fiber/issues/3847
516
+ */
517
+ canvasTargetSizeDirty?: boolean
502
518
  /**
503
519
  * Whether multi-canvas rendering is active.
504
520
  * True when any canvas uses `renderer={{ primaryCanvas: 'id' }}` to share a renderer.
@@ -1868,50 +1884,6 @@ declare namespace useLoader {
1868
1884
  var loader: typeof getLoader;
1869
1885
  }
1870
1886
 
1871
- /**
1872
- * Frame hook with phase-based ordering, priority, and FPS throttling.
1873
- *
1874
- * Always delivers full RootState — works both inside and outside Canvas context:
1875
- * - Inside Canvas: Full RootState (renderer, scene, camera, etc.)
1876
- * - Outside Canvas: The job registers immediately but the callback is held until a
1877
- * Canvas adopts it, then runs with full RootState. For hostless / standalone
1878
- * frame loops with no Canvas, use `@pmndrs/scheduler` directly.
1879
- *
1880
- * Returns a controls object for manual stepping, pausing, and resuming.
1881
- *
1882
- * @param callback - Function called each frame with (state, delta). Optional if you only need scheduler access.
1883
- * @param priorityOrOptions - Either a priority number (backwards compat) or options object
1884
- * @returns Controls object with step(), stepAll(), pause(), resume(), isPaused, id, scheduler
1885
- *
1886
- * @example
1887
- * // Simple priority (backwards compat)
1888
- * useFrame((state, delta) => { ... }, 5)
1889
- *
1890
- * @example
1891
- * // With phase-based ordering
1892
- * useFrame((state, delta) => { ... }, { phase: 'physics' })
1893
- *
1894
- * @example
1895
- * // Outside Canvas - callback waits for a Canvas, then always has full state
1896
- * function UI() {
1897
- * useFrame((state, delta) => { syncUI(state.camera) });
1898
- * return <button>...</button>;
1899
- * }
1900
- *
1901
- * @example
1902
- * // Hostless / standalone loop (no Canvas) - use @pmndrs/scheduler directly
1903
- * import { getScheduler } from '@pmndrs/scheduler'
1904
- * getScheduler().register((state, delta) => { updateGame(delta) })
1905
- *
1906
- * @example
1907
- * // Scheduler-only access (no callback)
1908
- * const { scheduler } = useFrame()
1909
- * scheduler.pauseJob('some-job-id')
1910
- *
1911
- * @see https://docs.pmnd.rs/react-three-fiber/api/hooks#useframe
1912
- */
1913
- declare function useFrame(callback?: FrameNextCallback, priorityOrOptions?: number | UseFrameNextOptions): FrameNextControls;
1914
-
1915
1887
  declare const IsObject: (url: unknown) => url is Record<string, string>;
1916
1888
  type TextureArray<T> = T extends string[] ? Texture$1[] : never;
1917
1889
  type TextureRecord<T> = T extends Record<string, string> ? {
@@ -2097,11 +2069,6 @@ declare function useRenderTarget(width: number, height: number, options?: Render
2097
2069
  * @see https://docs.pmnd.rs/react-three-fiber/api/hooks#usestore
2098
2070
  */
2099
2071
  declare function useStore(): RootStore;
2100
- /**
2101
- * Accesses R3F's internal state, containing renderer, canvas, scene, etc.
2102
- * @see https://docs.pmnd.rs/react-three-fiber/api/hooks#usethree
2103
- */
2104
- declare function useThree<T = RootState>(selector?: (state: RootState) => T, equalityFn?: <T>(state: T, newState: T) => boolean): T;
2105
2072
  /**
2106
2073
  * Exposes an object's {@link Instance}.
2107
2074
  * @see https://docs.pmnd.rs/react-three-fiber/api/additional-exports#useInstanceHandle
@@ -4086,6 +4053,10 @@ declare function createTextureOperations(set: StoreApi<RootState>['setState']):
4086
4053
  * - Callbacks receive full RootState for flexibility
4087
4054
  * - No auto-cleanup on unmount - use reset() for explicit cleanup
4088
4055
  * - Scene/camera changes trigger scenePass recreation
4056
+ * - A replaced scenePass is disposed once the new graph is installed, so rebuild() does not
4057
+ * strand its render target (and MRT attachments) on the GPU
4058
+ * - Any run that changes the output node sets RenderPipeline.needsUpdate, so rebuild() actually
4059
+ * recompiles instead of silently keeping the first compiled graph
4089
4060
  *
4090
4061
  * @param mainCB - Main callback to configure outputNode and create effect passes
4091
4062
  * @param setupCB - Optional setup callback to configure MRT on scenePass
@@ -4163,5 +4134,23 @@ interface WebGPURootState extends Omit<RootState, 'renderer' | 'gl' | 'internal'
4163
4134
  internal: WebGPUInternalState
4164
4135
  }
4165
4136
 
4137
+ /**
4138
+ * @fileoverview WebGPU entry point - WebGPU only, no legacy WebGL
4139
+ *
4140
+ * This entry point is for apps that want to use ONLY WebGPURenderer.
4141
+ * Includes WebGPU-specific hooks (useUniforms, useNodes, useTextures).
4142
+ * Auto-extends THREE with WebGPU node materials (MeshBasicNodeMaterial, etc.)
4143
+ *
4144
+ * Usage:
4145
+ * import { Canvas, useFrame, useUniforms } from '@react-three/fiber/webgpu'
4146
+ */
4147
+
4148
+ /** `useThree` narrowed to WebGPU state — `state.renderer` is a `WebGPURenderer`. */
4149
+ type UseThreeWebGPU = <T = WebGPURootState>(selector?: (state: WebGPURootState) => T, equalityFn?: <U>(state: U, newState: U) => boolean) => T;
4150
+ /** `useFrame` narrowed to WebGPU state — the callback's `state.renderer` is a `WebGPURenderer`. */
4151
+ type UseFrameWebGPU = (callback?: FrameCallback$1<WebGPURootState>, priorityOrOptions?: number | UseFrameNextOptions) => FrameNextControls;
4152
+ declare const useThree: UseThreeWebGPU;
4153
+ declare const useFrame: UseFrameWebGPU;
4154
+
4166
4155
  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, Texture, _roots, 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, 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, swapInteractivity, 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 };
4167
- export type { Act, 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, DisposeOptions, DisposeStorageFn, DomEvent, Dpr, ElementProps, EnvironmentLoaderProps, EnvironmentProps, 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, 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, WebGPURootState as RootState, RootStore, ScopedStoreType, SetBlock, Size, StorageCreator, StorageLike, StorageRecord, StorageStore, StorageWithUtils, Subscription, TSLNode, TSLNodeInput, TextureEntry, TextureInput, TextureNode, TextureOperations, TextureResult, ThreeCamera, ThreeElement, ThreeElements, ThreeElementsImpl, ThreeEvent, ThreeExports, ThreeToJSXElements, UnblockProps, UniformCreator, UniformValue, UniformsWithUtils, UseTextureOptions, UseTexturesReturn, Vector2, Vector3, Vector4, VectorRepresentation, Viewport, VisibilityEntry, WebGLDefaultProps, WebGLProps, WebGLShadowConfig, WebGPUDefaultProps, WebGPUProps, WebGPUShadowConfig, XRManager, XRPointerConfig };
4156
+ export type { Act, 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, DisposeOptions, DisposeStorageFn, DomEvent, Dpr, ElementProps, EnvironmentLoaderProps, EnvironmentProps, 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, 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, WebGPURootState as RootState, RootStore, ScopedStoreType, SetBlock, Size, StorageCreator, StorageLike, StorageRecord, StorageStore, StorageWithUtils, Subscription, TSLNode, TSLNodeInput, TextureEntry, TextureInput, TextureNode, TextureOperations, TextureResult, ThreeCamera, ThreeElement, ThreeElements, ThreeElementsImpl, ThreeEvent, ThreeExports, ThreeToJSXElements, UnblockProps, UniformCreator, UniformValue, UniformsWithUtils, UseFrameWebGPU, UseTextureOptions, UseTexturesReturn, UseThreeWebGPU, Vector2, Vector3, Vector4, VectorRepresentation, Viewport, VisibilityEntry, WebGLDefaultProps, WebGLProps, WebGLShadowConfig, WebGPUDefaultProps, WebGPUProps, WebGPUShadowConfig, XRManager, XRPointerConfig };
@@ -1,3 +1,4 @@
1
+ import * as three_examples_jsm_inspector_Inspector_js from 'three/examples/jsm/inspector/Inspector.js';
1
2
  import * as three_webgpu from 'three/webgpu';
2
3
  import { CubeRenderTarget, 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';
3
4
  import { Inspector } from 'three/addons/inspector/Inspector.js';
@@ -40,6 +41,8 @@ function _mergeNamespaces(n, m) {
40
41
  declare const R3F_BUILD_LEGACY = false;
41
42
  declare const R3F_BUILD_WEBGPU = true;
42
43
 
44
+ /** Lazily load the three Inspector. Keeps it out of the eager module graph — see note above. */
45
+ declare function loadInspector(): Promise<typeof three_examples_jsm_inspector_Inspector_js.Inspector>;
43
46
  declare const WebGLRenderer: {
44
47
  new (): {};
45
48
  };
@@ -61,7 +64,8 @@ var THREE = /*#__PURE__*/_mergeNamespaces({
61
64
  WebGLRenderTarget: WebGLRenderTarget,
62
65
  WebGLRenderer: WebGLRenderer,
63
66
  WebGLRendererParameters: WebGLRendererParameters,
64
- WebGLShadowMap: WebGLShadowMap
67
+ WebGLShadowMap: WebGLShadowMap,
68
+ loadInspector: loadInspector
65
69
  }, [three_webgpu]);
66
70
 
67
71
  //* Utility Types ==============================
@@ -499,6 +503,18 @@ interface InternalState {
499
503
  * @see https://threejs.org/docs/#api/en/renderers/common/CanvasTarget
500
504
  */
501
505
  canvasTarget?: CanvasTarget
506
+ /**
507
+ * Set when this root's canvas target has been resized and the backend's cached render pass
508
+ * descriptor (which holds a depth-stencil view built once per canvas) is therefore stale.
509
+ *
510
+ * Flushed by the canvas-target job in the `start` phase, which is the only place this root's
511
+ * target is guaranteed to be the renderer's active one — `backend.updateSize()` operates on
512
+ * whatever `getCanvasTarget()` returns, so calling it from the resize subscription would
513
+ * invalidate some other canvas's descriptor instead.
514
+ *
515
+ * @see https://github.com/pmndrs/react-three-fiber/issues/3847
516
+ */
517
+ canvasTargetSizeDirty?: boolean
502
518
  /**
503
519
  * Whether multi-canvas rendering is active.
504
520
  * True when any canvas uses `renderer={{ primaryCanvas: 'id' }}` to share a renderer.
@@ -1868,50 +1884,6 @@ declare namespace useLoader {
1868
1884
  var loader: typeof getLoader;
1869
1885
  }
1870
1886
 
1871
- /**
1872
- * Frame hook with phase-based ordering, priority, and FPS throttling.
1873
- *
1874
- * Always delivers full RootState — works both inside and outside Canvas context:
1875
- * - Inside Canvas: Full RootState (renderer, scene, camera, etc.)
1876
- * - Outside Canvas: The job registers immediately but the callback is held until a
1877
- * Canvas adopts it, then runs with full RootState. For hostless / standalone
1878
- * frame loops with no Canvas, use `@pmndrs/scheduler` directly.
1879
- *
1880
- * Returns a controls object for manual stepping, pausing, and resuming.
1881
- *
1882
- * @param callback - Function called each frame with (state, delta). Optional if you only need scheduler access.
1883
- * @param priorityOrOptions - Either a priority number (backwards compat) or options object
1884
- * @returns Controls object with step(), stepAll(), pause(), resume(), isPaused, id, scheduler
1885
- *
1886
- * @example
1887
- * // Simple priority (backwards compat)
1888
- * useFrame((state, delta) => { ... }, 5)
1889
- *
1890
- * @example
1891
- * // With phase-based ordering
1892
- * useFrame((state, delta) => { ... }, { phase: 'physics' })
1893
- *
1894
- * @example
1895
- * // Outside Canvas - callback waits for a Canvas, then always has full state
1896
- * function UI() {
1897
- * useFrame((state, delta) => { syncUI(state.camera) });
1898
- * return <button>...</button>;
1899
- * }
1900
- *
1901
- * @example
1902
- * // Hostless / standalone loop (no Canvas) - use @pmndrs/scheduler directly
1903
- * import { getScheduler } from '@pmndrs/scheduler'
1904
- * getScheduler().register((state, delta) => { updateGame(delta) })
1905
- *
1906
- * @example
1907
- * // Scheduler-only access (no callback)
1908
- * const { scheduler } = useFrame()
1909
- * scheduler.pauseJob('some-job-id')
1910
- *
1911
- * @see https://docs.pmnd.rs/react-three-fiber/api/hooks#useframe
1912
- */
1913
- declare function useFrame(callback?: FrameNextCallback, priorityOrOptions?: number | UseFrameNextOptions): FrameNextControls;
1914
-
1915
1887
  declare const IsObject: (url: unknown) => url is Record<string, string>;
1916
1888
  type TextureArray<T> = T extends string[] ? Texture$1[] : never;
1917
1889
  type TextureRecord<T> = T extends Record<string, string> ? {
@@ -2097,11 +2069,6 @@ declare function useRenderTarget(width: number, height: number, options?: Render
2097
2069
  * @see https://docs.pmnd.rs/react-three-fiber/api/hooks#usestore
2098
2070
  */
2099
2071
  declare function useStore(): RootStore;
2100
- /**
2101
- * Accesses R3F's internal state, containing renderer, canvas, scene, etc.
2102
- * @see https://docs.pmnd.rs/react-three-fiber/api/hooks#usethree
2103
- */
2104
- declare function useThree<T = RootState>(selector?: (state: RootState) => T, equalityFn?: <T>(state: T, newState: T) => boolean): T;
2105
2072
  /**
2106
2073
  * Exposes an object's {@link Instance}.
2107
2074
  * @see https://docs.pmnd.rs/react-three-fiber/api/additional-exports#useInstanceHandle
@@ -4086,6 +4053,10 @@ declare function createTextureOperations(set: StoreApi<RootState>['setState']):
4086
4053
  * - Callbacks receive full RootState for flexibility
4087
4054
  * - No auto-cleanup on unmount - use reset() for explicit cleanup
4088
4055
  * - Scene/camera changes trigger scenePass recreation
4056
+ * - A replaced scenePass is disposed once the new graph is installed, so rebuild() does not
4057
+ * strand its render target (and MRT attachments) on the GPU
4058
+ * - Any run that changes the output node sets RenderPipeline.needsUpdate, so rebuild() actually
4059
+ * recompiles instead of silently keeping the first compiled graph
4089
4060
  *
4090
4061
  * @param mainCB - Main callback to configure outputNode and create effect passes
4091
4062
  * @param setupCB - Optional setup callback to configure MRT on scenePass
@@ -4163,5 +4134,23 @@ interface WebGPURootState extends Omit<RootState, 'renderer' | 'gl' | 'internal'
4163
4134
  internal: WebGPUInternalState
4164
4135
  }
4165
4136
 
4137
+ /**
4138
+ * @fileoverview WebGPU entry point - WebGPU only, no legacy WebGL
4139
+ *
4140
+ * This entry point is for apps that want to use ONLY WebGPURenderer.
4141
+ * Includes WebGPU-specific hooks (useUniforms, useNodes, useTextures).
4142
+ * Auto-extends THREE with WebGPU node materials (MeshBasicNodeMaterial, etc.)
4143
+ *
4144
+ * Usage:
4145
+ * import { Canvas, useFrame, useUniforms } from '@react-three/fiber/webgpu'
4146
+ */
4147
+
4148
+ /** `useThree` narrowed to WebGPU state — `state.renderer` is a `WebGPURenderer`. */
4149
+ type UseThreeWebGPU = <T = WebGPURootState>(selector?: (state: WebGPURootState) => T, equalityFn?: <U>(state: U, newState: U) => boolean) => T;
4150
+ /** `useFrame` narrowed to WebGPU state — the callback's `state.renderer` is a `WebGPURenderer`. */
4151
+ type UseFrameWebGPU = (callback?: FrameCallback$1<WebGPURootState>, priorityOrOptions?: number | UseFrameNextOptions) => FrameNextControls;
4152
+ declare const useThree: UseThreeWebGPU;
4153
+ declare const useFrame: UseFrameWebGPU;
4154
+
4166
4155
  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, Texture, _roots, 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, 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, swapInteractivity, 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 };
4167
- export type { Act, 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, DisposeOptions, DisposeStorageFn, DomEvent, Dpr, ElementProps, EnvironmentLoaderProps, EnvironmentProps, 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, 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, WebGPURootState as RootState, RootStore, ScopedStoreType, SetBlock, Size, StorageCreator, StorageLike, StorageRecord, StorageStore, StorageWithUtils, Subscription, TSLNode, TSLNodeInput, TextureEntry, TextureInput, TextureNode, TextureOperations, TextureResult, ThreeCamera, ThreeElement, ThreeElements, ThreeElementsImpl, ThreeEvent, ThreeExports, ThreeToJSXElements, UnblockProps, UniformCreator, UniformValue, UniformsWithUtils, UseTextureOptions, UseTexturesReturn, Vector2, Vector3, Vector4, VectorRepresentation, Viewport, VisibilityEntry, WebGLDefaultProps, WebGLProps, WebGLShadowConfig, WebGPUDefaultProps, WebGPUProps, WebGPUShadowConfig, XRManager, XRPointerConfig };
4156
+ export type { Act, 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, DisposeOptions, DisposeStorageFn, DomEvent, Dpr, ElementProps, EnvironmentLoaderProps, EnvironmentProps, 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, 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, WebGPURootState as RootState, RootStore, ScopedStoreType, SetBlock, Size, StorageCreator, StorageLike, StorageRecord, StorageStore, StorageWithUtils, Subscription, TSLNode, TSLNodeInput, TextureEntry, TextureInput, TextureNode, TextureOperations, TextureResult, ThreeCamera, ThreeElement, ThreeElements, ThreeElementsImpl, ThreeEvent, ThreeExports, ThreeToJSXElements, UnblockProps, UniformCreator, UniformValue, UniformsWithUtils, UseFrameWebGPU, UseTextureOptions, UseTexturesReturn, UseThreeWebGPU, Vector2, Vector3, Vector4, VectorRepresentation, Viewport, VisibilityEntry, WebGLDefaultProps, WebGLProps, WebGLShadowConfig, WebGPUDefaultProps, WebGPUProps, WebGPUShadowConfig, XRManager, XRPointerConfig };