@react-three/fiber 10.0.0-canary.07c4f9d → 10.0.0-canary.0ea97c0
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.
- package/dist/index.cjs +19 -15
- package/dist/index.d.cts +137 -17
- package/dist/index.d.mts +137 -17
- package/dist/index.d.ts +137 -17
- package/dist/index.mjs +19 -15
- package/dist/legacy.cjs +16 -11
- package/dist/legacy.d.cts +137 -17
- package/dist/legacy.d.mts +137 -17
- package/dist/legacy.d.ts +137 -17
- package/dist/legacy.mjs +16 -11
- package/dist/webgpu/index.cjs +33 -28
- package/dist/webgpu/index.d.cts +141 -33
- package/dist/webgpu/index.d.mts +141 -33
- package/dist/webgpu/index.d.ts +141 -33
- package/dist/webgpu/index.mjs +33 -28
- package/package.json +1 -1
package/dist/webgpu/index.cjs
CHANGED
|
@@ -632,7 +632,12 @@ function diffProps(instance, newProps) {
|
|
|
632
632
|
const changedProps = {};
|
|
633
633
|
for (const prop in newProps) {
|
|
634
634
|
if (RESERVED_PROPS.includes(prop)) continue;
|
|
635
|
-
if (is.equ(newProps[prop], instance.props[prop]))
|
|
635
|
+
if (is.equ(newProps[prop], instance.props[prop])) {
|
|
636
|
+
const value = newProps[prop];
|
|
637
|
+
if (!isCopyable(value)) continue;
|
|
638
|
+
const { target } = resolve(instance.object, prop);
|
|
639
|
+
if (!isCopyable(target) || target.constructor !== value.constructor) continue;
|
|
640
|
+
}
|
|
636
641
|
changedProps[prop] = newProps[prop];
|
|
637
642
|
for (const other in newProps) {
|
|
638
643
|
if (other.startsWith(`${prop}-`)) changedProps[other] = newProps[other];
|
|
@@ -1078,7 +1083,8 @@ const createStore = (invalidate, advance) => {
|
|
|
1078
1083
|
const resizeTarget = canvasTarget ?? actualRenderer;
|
|
1079
1084
|
if (viewport.dpr > 0) resizeTarget.setPixelRatio(viewport.dpr);
|
|
1080
1085
|
resizeTarget.setSize(size.width, size.height, false);
|
|
1081
|
-
|
|
1086
|
+
const activeTarget = actualRenderer.getCanvasTarget?.();
|
|
1087
|
+
if (!canvasTarget || activeTarget !== canvasTarget) internal.canvasTargetSizeDirty = true;
|
|
1082
1088
|
}
|
|
1083
1089
|
if (camera !== oldCamera) {
|
|
1084
1090
|
oldCamera = camera;
|
|
@@ -14240,9 +14246,8 @@ function createRoot(canvas) {
|
|
|
14240
14246
|
if (!renderer.hasInitialized?.()) {
|
|
14241
14247
|
const size2 = computeInitialSize(canvas, propsSize);
|
|
14242
14248
|
if (size2.width > 0 && size2.height > 0) {
|
|
14243
|
-
|
|
14244
|
-
|
|
14245
|
-
canvas.height = size2.height * pixelRatio;
|
|
14249
|
+
renderer.setPixelRatio(calculateDpr(dpr));
|
|
14250
|
+
renderer.setSize(size2.width, size2.height, false);
|
|
14246
14251
|
}
|
|
14247
14252
|
await renderer.init();
|
|
14248
14253
|
}
|
|
@@ -14251,7 +14256,7 @@ function createRoot(canvas) {
|
|
|
14251
14256
|
state.internal.actualRenderer = renderer;
|
|
14252
14257
|
state.set({ webGPUSupported: isWebGPUBackend, renderer, primaryStore: store });
|
|
14253
14258
|
if (canvasId && !state.internal.isSecondary) {
|
|
14254
|
-
const canvasTarget =
|
|
14259
|
+
const canvasTarget = renderer.getCanvasTarget?.();
|
|
14255
14260
|
const unregisterPrimary = registerPrimary(canvasId, renderer, store);
|
|
14256
14261
|
state.set((prev) => ({
|
|
14257
14262
|
internal: {
|
|
@@ -14464,9 +14469,10 @@ function createRoot(canvas) {
|
|
|
14464
14469
|
const unregisterCanvasTarget = scheduler$1.register(
|
|
14465
14470
|
() => {
|
|
14466
14471
|
const state2 = store.getState();
|
|
14467
|
-
|
|
14472
|
+
const canvasTarget = state2.internal.canvasTarget;
|
|
14473
|
+
if (canvasTarget) {
|
|
14468
14474
|
const renderer2 = state2.internal.actualRenderer;
|
|
14469
|
-
renderer2.setCanvasTarget(
|
|
14475
|
+
if (renderer2.getCanvasTarget() !== canvasTarget) renderer2.setCanvasTarget(canvasTarget);
|
|
14470
14476
|
if (state2.internal.canvasTargetSizeDirty) {
|
|
14471
14477
|
state2.internal.canvasTargetSizeDirty = false;
|
|
14472
14478
|
renderer2.backend?.updateSize?.();
|
|
@@ -14630,7 +14636,7 @@ function unmountComponentAtNode(canvas, callback) {
|
|
|
14630
14636
|
const unregisterPrimary = state.internal.unregisterPrimary;
|
|
14631
14637
|
if (unregisterPrimary) unregisterPrimary();
|
|
14632
14638
|
const canvasTarget = state.internal.canvasTarget;
|
|
14633
|
-
if (canvasTarget?.dispose) canvasTarget.dispose();
|
|
14639
|
+
if (state.internal.isSecondary && canvasTarget?.dispose) canvasTarget.dispose();
|
|
14634
14640
|
state.events.disconnect?.();
|
|
14635
14641
|
cleanupHelperGroup(root.store);
|
|
14636
14642
|
if (state.isLegacy && renderer) {
|
|
@@ -15171,9 +15177,9 @@ function CanvasImpl({
|
|
|
15171
15177
|
React__namespace.useMemo(() => extend(THREE), []);
|
|
15172
15178
|
const Bridge = useBridge();
|
|
15173
15179
|
const backgroundProps = React__namespace.useMemo(() => parseBackground(background), [background]);
|
|
15174
|
-
const
|
|
15180
|
+
const [hasInitialSize, setHasInitialSize] = React__namespace.useState(false);
|
|
15175
15181
|
const measureConfig = React__namespace.useMemo(() => {
|
|
15176
|
-
if (!
|
|
15182
|
+
if (!hasInitialSize) {
|
|
15177
15183
|
return {
|
|
15178
15184
|
...resize,
|
|
15179
15185
|
scroll: resize?.scroll ?? true,
|
|
@@ -15185,7 +15191,7 @@ function CanvasImpl({
|
|
|
15185
15191
|
debounce: { scroll: 50, resize: 0 },
|
|
15186
15192
|
...resize
|
|
15187
15193
|
};
|
|
15188
|
-
}, [
|
|
15194
|
+
}, [hasInitialSize, resize]);
|
|
15189
15195
|
const [containerRef, containerRect] = useMeasure__default(measureConfig);
|
|
15190
15196
|
const effectiveSize = React__namespace.useMemo(() => {
|
|
15191
15197
|
let w = width ?? containerRect.width;
|
|
@@ -15201,9 +15207,7 @@ function CanvasImpl({
|
|
|
15201
15207
|
left: containerRect.left
|
|
15202
15208
|
};
|
|
15203
15209
|
}, [width, height, containerRect, forceEven]);
|
|
15204
|
-
if (!
|
|
15205
|
-
hasInitialSizeRef.current = true;
|
|
15206
|
-
}
|
|
15210
|
+
if (!hasInitialSize && effectiveSize.width > 0 && effectiveSize.height > 0) setHasInitialSize(true);
|
|
15207
15211
|
const canvasRef = React__namespace.useRef(null);
|
|
15208
15212
|
const divRef = React__namespace.useRef(null);
|
|
15209
15213
|
React__namespace.useImperativeHandle(ref, () => canvasRef.current);
|
|
@@ -16062,7 +16066,7 @@ function useRenderPipeline(mainCB, setupCB) {
|
|
|
16062
16066
|
renderPipeline: null,
|
|
16063
16067
|
passes: {}
|
|
16064
16068
|
});
|
|
16065
|
-
scenePassCacheRef.current?.scenePass
|
|
16069
|
+
scenePassCacheRef.current?.scenePass.dispose();
|
|
16066
16070
|
callbacksRanRef.current = false;
|
|
16067
16071
|
scenePassCacheRef.current = null;
|
|
16068
16072
|
forceScenePassRebuildRef.current = false;
|
|
@@ -16077,6 +16081,9 @@ function useRenderPipeline(mainCB, setupCB) {
|
|
|
16077
16081
|
throw new Error("useRenderPipeline is only available with WebGPU renderer. Set renderer prop on Canvas.");
|
|
16078
16082
|
}
|
|
16079
16083
|
if (!renderer || !scene || !camera) return;
|
|
16084
|
+
if (!("isWebGPURenderer" in renderer)) {
|
|
16085
|
+
throw new Error("useRenderPipeline: renderer is not a WebGPURenderer but isLegacy is false.");
|
|
16086
|
+
}
|
|
16080
16087
|
const state = store.getState();
|
|
16081
16088
|
const set = store.setState;
|
|
16082
16089
|
try {
|
|
@@ -16110,7 +16117,9 @@ function useRenderPipeline(mainCB, setupCB) {
|
|
|
16110
16117
|
if (setupCBRef.current) {
|
|
16111
16118
|
const freshState = Object.assign({}, store.getState(), {
|
|
16112
16119
|
renderPipeline: pipeline,
|
|
16113
|
-
passes: currentPasses
|
|
16120
|
+
passes: { ...currentPasses, scenePass },
|
|
16121
|
+
renderer,
|
|
16122
|
+
isLegacy: false
|
|
16114
16123
|
});
|
|
16115
16124
|
const setupResult = setupCBRef.current(freshState);
|
|
16116
16125
|
if (setupResult && typeof setupResult === "object") {
|
|
@@ -16121,7 +16130,9 @@ function useRenderPipeline(mainCB, setupCB) {
|
|
|
16121
16130
|
if (mainCBRef.current) {
|
|
16122
16131
|
const freshState = Object.assign({}, store.getState(), {
|
|
16123
16132
|
renderPipeline: pipeline,
|
|
16124
|
-
passes: currentPasses
|
|
16133
|
+
passes: { ...currentPasses, scenePass },
|
|
16134
|
+
renderer,
|
|
16135
|
+
isLegacy: false
|
|
16125
16136
|
});
|
|
16126
16137
|
const mainResult = mainCBRef.current(freshState);
|
|
16127
16138
|
if (mainResult && typeof mainResult === "object") {
|
|
@@ -16133,22 +16144,16 @@ function useRenderPipeline(mainCB, setupCB) {
|
|
|
16133
16144
|
callbacksRanRef.current = true;
|
|
16134
16145
|
}
|
|
16135
16146
|
if (outputNodeChanged) pipeline.needsUpdate = true;
|
|
16136
|
-
if (outgoingScenePass && outgoingScenePass !== scenePass) outgoingScenePass.dispose
|
|
16147
|
+
if (outgoingScenePass && outgoingScenePass !== scenePass) outgoingScenePass.dispose();
|
|
16137
16148
|
} catch (error) {
|
|
16138
16149
|
console.warn("[useRenderPipeline] Setup failed; the render pipeline was not configured:", error);
|
|
16139
16150
|
}
|
|
16140
16151
|
}, [store, renderer, scene, camera, isLegacy, rebuildVersion]);
|
|
16141
16152
|
const passes = useThree$1((s) => s.passes);
|
|
16142
16153
|
const renderPipeline = useThree$1((s) => s.renderPipeline);
|
|
16143
|
-
|
|
16144
|
-
|
|
16145
|
-
|
|
16146
|
-
clearPasses,
|
|
16147
|
-
reset,
|
|
16148
|
-
rebuild,
|
|
16149
|
-
// isReady indicates if RenderPipeline is configured and ready for rendering
|
|
16150
|
-
isReady: renderPipeline !== null
|
|
16151
|
-
};
|
|
16154
|
+
const actions = { passes, clearPasses, reset, rebuild };
|
|
16155
|
+
if (renderPipeline) return { ...actions, isReady: true, renderPipeline };
|
|
16156
|
+
return { ...actions, isReady: false, renderPipeline: null };
|
|
16152
16157
|
}
|
|
16153
16158
|
|
|
16154
16159
|
extend(THREE);
|
package/dist/webgpu/index.d.cts
CHANGED
|
@@ -365,6 +365,33 @@ type BufferRecord = Record<string, BufferLike>
|
|
|
365
365
|
*/
|
|
366
366
|
type BufferStore = Record<string, BufferLike | BufferRecord>
|
|
367
367
|
|
|
368
|
+
//* Node Types (useNodes) ========================================
|
|
369
|
+
|
|
370
|
+
/**
|
|
371
|
+
* Structural shape of a TSL node as stored on `state.nodes`.
|
|
372
|
+
*
|
|
373
|
+
* Deliberately minimal rather than three's nominal `Node`: in @types/three several node classes
|
|
374
|
+
* TSL hands back (OperatorNode, ConstNode, ...) do not extend `Node` cleanly, so a `Node` bound
|
|
375
|
+
* would reject values `useNodes` creators legitimately return. This is the same shape
|
|
376
|
+
* `useNodes` already constrains creators to (`TSLNodeLike`).
|
|
377
|
+
*/
|
|
378
|
+
interface NodeLike {
|
|
379
|
+
uuid?: string
|
|
380
|
+
nodeType?: string | null
|
|
381
|
+
/** label method for chaining - sets the node's label and returns self */
|
|
382
|
+
label?: ((label: string) => NodeLike) | string
|
|
383
|
+
setName?: (name: string) => this
|
|
384
|
+
}
|
|
385
|
+
|
|
386
|
+
/** Flat record of TSL nodes (no nested scopes) */
|
|
387
|
+
type NodeRecord = Record<string, NodeLike>
|
|
388
|
+
|
|
389
|
+
/**
|
|
390
|
+
* Node store that can contain both root-level nodes and scoped node objects.
|
|
391
|
+
* Structure: { wobble: OperatorNode, fx: { blur: ShaderCallable } }
|
|
392
|
+
*/
|
|
393
|
+
type NodeStore = Record<string, NodeLike | NodeRecord>
|
|
394
|
+
|
|
368
395
|
//* Storage Types (useGPUStorage) ========================================
|
|
369
396
|
|
|
370
397
|
/**
|
|
@@ -498,8 +525,13 @@ interface InternalState {
|
|
|
498
525
|
/** Container for child attachment (scene for root, original container for portals) */
|
|
499
526
|
container?: THREE$1.Object3D
|
|
500
527
|
/**
|
|
501
|
-
* CanvasTarget
|
|
502
|
-
*
|
|
528
|
+
* The CanvasTarget this root sizes and renders through.
|
|
529
|
+
*
|
|
530
|
+
* A primary (`<Canvas id>`) owns the renderer's default target -- the one three itself built
|
|
531
|
+
* around the canvas element -- so sizing it is sizing the renderer. A secondary owns a target
|
|
532
|
+
* R3F created for its own element. Either way there is exactly one target per canvas element,
|
|
533
|
+
* and the canvas-target job makes it the renderer's active one before this root renders.
|
|
534
|
+
* Absent on WebGL and on an id-less WebGPU canvas, where the renderer is sized directly.
|
|
503
535
|
* @see https://threejs.org/docs/#api/en/renderers/common/CanvasTarget
|
|
504
536
|
*/
|
|
505
537
|
canvasTarget?: CanvasTarget
|
|
@@ -624,7 +656,7 @@ interface RootState {
|
|
|
624
656
|
/** Global TSL uniform nodes - root-level uniforms + scoped sub-objects. Use useUniforms() hook */
|
|
625
657
|
uniforms: UniformStore
|
|
626
658
|
/** Global TSL nodes - root-level nodes + scoped sub-objects. Use useNodes() hook */
|
|
627
|
-
nodes:
|
|
659
|
+
nodes: NodeStore
|
|
628
660
|
/** Global TSL buffer nodes - root-level buffers + scoped sub-objects. Use useBuffers() hook */
|
|
629
661
|
buffers: BufferStore
|
|
630
662
|
/** Global GPU storage (textures, etc.) - root-level storage + scoped sub-objects. Use useGPUStorage() hook */
|
|
@@ -636,7 +668,7 @@ interface RootState {
|
|
|
636
668
|
/** WebGPU RenderPipeline instance - use useRenderPipeline() hook */
|
|
637
669
|
renderPipeline: ThreeRenderPipeline | null
|
|
638
670
|
/** Global TSL pass nodes for render pipeline - use useRenderPipeline() hook */
|
|
639
|
-
passes:
|
|
671
|
+
passes: PassRecord
|
|
640
672
|
/** Internal version counter for HMR - incremented by rebuildNodes/rebuildUniforms to bust memoization */
|
|
641
673
|
_hmrVersion: number
|
|
642
674
|
/** Internal: whether setSize() has taken ownership of canvas dimensions */
|
|
@@ -1184,7 +1216,33 @@ declare global {
|
|
|
1184
1216
|
* ergonomics. The result is three's structural type, so members stay in sync with the
|
|
1185
1217
|
* installed three instead of needing to be mirrored by hand.
|
|
1186
1218
|
*/
|
|
1187
|
-
type UniformNode<T = unknown> = three_webgpu.UniformNode<
|
|
1219
|
+
type UniformNode<T = unknown> = three_webgpu.UniformNode<UniformNodeTypeFor<T>, T>
|
|
1220
|
+
|
|
1221
|
+
/**
|
|
1222
|
+
* three's node type name for a uniform value type, mirroring the `uniform()` overloads.
|
|
1223
|
+
* A `UniformNode<number>` is a `Node<'float'>`, so TSL math (`.mul`, `.add`, ...) accepts it.
|
|
1224
|
+
* Unknown or unlisted value types resolve to `unknown`, which TSL math rejects: narrow with
|
|
1225
|
+
* `as UniformNode<number>` (or the matching value type) at the call site.
|
|
1226
|
+
*/
|
|
1227
|
+
type UniformNodeTypeFor<T> = T extends number
|
|
1228
|
+
? 'float'
|
|
1229
|
+
: T extends boolean
|
|
1230
|
+
? 'bool'
|
|
1231
|
+
: T extends three_webgpu.Color
|
|
1232
|
+
? 'color'
|
|
1233
|
+
: T extends three_webgpu.Vector2
|
|
1234
|
+
? 'vec2'
|
|
1235
|
+
: T extends three_webgpu.Vector3
|
|
1236
|
+
? 'vec3'
|
|
1237
|
+
: T extends three_webgpu.Vector4
|
|
1238
|
+
? 'vec4'
|
|
1239
|
+
: T extends three_webgpu.Matrix2
|
|
1240
|
+
? 'mat2'
|
|
1241
|
+
: T extends three_webgpu.Matrix3
|
|
1242
|
+
? 'mat3'
|
|
1243
|
+
: T extends three_webgpu.Matrix4
|
|
1244
|
+
? 'mat4'
|
|
1245
|
+
: unknown
|
|
1188
1246
|
|
|
1189
1247
|
/**
|
|
1190
1248
|
* ShaderCallable - the return type of Fn()
|
|
@@ -1337,35 +1395,97 @@ declare global {
|
|
|
1337
1395
|
*/
|
|
1338
1396
|
type ThreeRenderPipeline = three_webgpu.RenderPipeline
|
|
1339
1397
|
|
|
1340
|
-
/**
|
|
1341
|
-
|
|
1398
|
+
/**
|
|
1399
|
+
* The pass `useRenderPipeline` creates for you: three's own `PassNode`, as returned by
|
|
1400
|
+
* `pass(scene, camera)` from `three/tsl`. Referenced from three so members like
|
|
1401
|
+
* `getTextureNode`, `setMRT` and `dispose` track the installed version.
|
|
1402
|
+
*/
|
|
1403
|
+
type ScenePassNode = three_webgpu.PassNode
|
|
1342
1404
|
|
|
1343
|
-
/**
|
|
1405
|
+
/**
|
|
1406
|
+
* Pass record - stores TSL pass nodes for render pipeline.
|
|
1407
|
+
*
|
|
1408
|
+
* `scenePass` is the only key the library owns. It is optional here because this is also the
|
|
1409
|
+
* shape of `state.passes`, which is `{}` before the pipeline exists and again after `reset()`
|
|
1410
|
+
* or `clearPasses()`. Inside the callbacks it is always present; see
|
|
1411
|
+
* {@link RenderPipelineCallbackState}.
|
|
1412
|
+
*
|
|
1413
|
+
* Every other key is user-registered, via a callback's return value. Those are TSL nodes of
|
|
1414
|
+
* any kind, not only passes: texture reads of an MRT attachment, effect nodes, extra
|
|
1415
|
+
* `pass()` instances. `Node` is the common base, so that is the bound. Narrow at the call
|
|
1416
|
+
* site when you need a member, e.g. `passes.velocity as TextureNode`.
|
|
1417
|
+
*/
|
|
1418
|
+
interface PassRecord {
|
|
1419
|
+
scenePass?: ScenePassNode
|
|
1420
|
+
[key: string]: three_webgpu.Node
|
|
1421
|
+
}
|
|
1422
|
+
|
|
1423
|
+
/**
|
|
1424
|
+
* State passed to pipeline callbacks after the active pipeline has been created.
|
|
1425
|
+
*
|
|
1426
|
+
* `passes.scenePass` is required here: the hook installs the default scene pass before either
|
|
1427
|
+
* callback runs, so callbacks can use it without a guard or a cast.
|
|
1428
|
+
*
|
|
1429
|
+
* `renderer` is narrowed to `WebGPURenderer` and `isLegacy` to `false`: the hook throws under
|
|
1430
|
+
* the legacy renderer before either callback can run, so a callback never sees WebGL.
|
|
1431
|
+
*/
|
|
1344
1432
|
type RenderPipelineCallbackState = RootState & {
|
|
1345
1433
|
renderPipeline: ThreeRenderPipeline
|
|
1434
|
+
passes: PassRecord & { scenePass: ScenePassNode }
|
|
1435
|
+
renderer: three_webgpu.WebGPURenderer
|
|
1436
|
+
isLegacy: false
|
|
1346
1437
|
}
|
|
1347
1438
|
|
|
1439
|
+
/**
|
|
1440
|
+
* What a callback may return to register entries into `state.passes`.
|
|
1441
|
+
*
|
|
1442
|
+
* `scenePass` is reserved. The hook owns that entry and its lifecycle: it caches the pass it
|
|
1443
|
+
* created, and `rebuild()` / `reset()` dispose that cached pass. A callback overwriting the
|
|
1444
|
+
* store entry would leave the store pointing at a node the hook never disposes, and the hook
|
|
1445
|
+
* disposing a pass nothing references. So returning it is a type error.
|
|
1446
|
+
*/
|
|
1447
|
+
type RegisteredPasses = Record<string, three_webgpu.Node> & { scenePass?: never }
|
|
1448
|
+
|
|
1348
1449
|
/** Setup callback - runs first to configure MRT, create additional passes */
|
|
1349
|
-
type RenderPipelineSetupCallback = (state: RenderPipelineCallbackState) =>
|
|
1450
|
+
type RenderPipelineSetupCallback = (state: RenderPipelineCallbackState) => RegisteredPasses | void
|
|
1350
1451
|
|
|
1351
1452
|
/** Main callback - runs second to configure outputNode, create effect passes */
|
|
1352
|
-
type RenderPipelineMainCallback = (state: RenderPipelineCallbackState) =>
|
|
1453
|
+
type RenderPipelineMainCallback = (state: RenderPipelineCallbackState) => RegisteredPasses | void
|
|
1353
1454
|
|
|
1354
|
-
/**
|
|
1355
|
-
interface
|
|
1455
|
+
/** The imperative half of useRenderPipeline's return value, present in every state */
|
|
1456
|
+
interface UseRenderPipelineActions {
|
|
1356
1457
|
/** Current passes from state */
|
|
1357
1458
|
passes: PassRecord
|
|
1358
|
-
/** RenderPipeline instance (null if not initialized) */
|
|
1359
|
-
renderPipeline: ThreeRenderPipeline | null
|
|
1360
1459
|
/** Clear all passes from state */
|
|
1361
1460
|
clearPasses: () => void
|
|
1362
1461
|
/** Reset RenderPipeline entirely (clears PP + passes) */
|
|
1363
1462
|
reset: () => void
|
|
1364
1463
|
/** Re-run setup/main callbacks with current closure values */
|
|
1365
1464
|
rebuild: () => void
|
|
1366
|
-
/** True when RenderPipeline is configured and ready */
|
|
1367
|
-
isReady: boolean
|
|
1368
1465
|
}
|
|
1466
|
+
|
|
1467
|
+
/**
|
|
1468
|
+
* Return type for useRenderPipeline hook, discriminated on `isReady`.
|
|
1469
|
+
*
|
|
1470
|
+
* `if (isReady)` narrows `renderPipeline` to non-null, which is what the docs already tell
|
|
1471
|
+
* callers to check. `passes.scenePass` deliberately stays optional in the ready branch:
|
|
1472
|
+
* `clearPasses()` empties the record while leaving the pipeline in place.
|
|
1473
|
+
*/
|
|
1474
|
+
type UseRenderPipelineReturn = UseRenderPipelineActions &
|
|
1475
|
+
(
|
|
1476
|
+
| {
|
|
1477
|
+
/** True when RenderPipeline is configured and ready */
|
|
1478
|
+
isReady: true
|
|
1479
|
+
/** RenderPipeline instance */
|
|
1480
|
+
renderPipeline: ThreeRenderPipeline
|
|
1481
|
+
}
|
|
1482
|
+
| {
|
|
1483
|
+
/** False until the pipeline has been created */
|
|
1484
|
+
isReady: false
|
|
1485
|
+
/** Not initialized yet, or torn down by reset() */
|
|
1486
|
+
renderPipeline: null
|
|
1487
|
+
}
|
|
1488
|
+
)
|
|
1369
1489
|
}
|
|
1370
1490
|
|
|
1371
1491
|
type MutableOrReadonlyParameters<T extends (...args: any) => any> = Parameters<T> | Readonly<Parameters<T>>
|
|
@@ -3863,25 +3983,13 @@ declare function useUniform<T extends UniformValue>(name: string): UniformNode<T
|
|
|
3863
3983
|
declare function useUniform<T extends UniformValue>(name: string, value: T): UniformNode<Widen<T>>;
|
|
3864
3984
|
|
|
3865
3985
|
/**
|
|
3866
|
-
* Minimal interface for TSL nodes.
|
|
3867
|
-
*
|
|
3868
|
-
*
|
|
3869
|
-
* extend Node with all required properties.
|
|
3986
|
+
* Minimal interface for TSL nodes. The definition lives with the store types as `NodeLike`, so
|
|
3987
|
+
* the shape creators may return and the shape `state.nodes` holds are the same type by
|
|
3988
|
+
* construction. See `NodeLike` for why this is structural rather than three's `Node`.
|
|
3870
3989
|
*/
|
|
3871
|
-
|
|
3872
|
-
uuid?: string;
|
|
3873
|
-
nodeType?: string | null;
|
|
3874
|
-
/** label method for chaining - sets the node's label and returns self */
|
|
3875
|
-
label?: ((label: string) => TSLNodeLike) | string;
|
|
3876
|
-
setName?: (name: string) => this;
|
|
3877
|
-
}
|
|
3990
|
+
type TSLNodeLike = NodeLike;
|
|
3878
3991
|
/** TSL node type - alias for compatibility */
|
|
3879
3992
|
type TSLNode = TSLNodeLike;
|
|
3880
|
-
/**
|
|
3881
|
-
* A record of TSL nodes - allows mixed node types (OperatorNode, ConstNode, etc.)
|
|
3882
|
-
* Uses TSLNodeLike for broader compatibility with Three.js's TSL type definitions.
|
|
3883
|
-
*/
|
|
3884
|
-
type NodeRecord<T extends TSLNodeLike = TSLNodeLike> = Record<string, T>;
|
|
3885
3993
|
/**
|
|
3886
3994
|
* Creator function that returns a record of nodes.
|
|
3887
3995
|
* Uses TSLNodeLike constraint to allow mixed node types
|
|
@@ -4170,4 +4278,4 @@ declare const useThree: UseThreeWebGPU;
|
|
|
4170
4278
|
declare const useFrame: UseFrameWebGPU;
|
|
4171
4279
|
|
|
4172
4280
|
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 };
|
|
4173
|
-
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,
|
|
4281
|
+
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, NodeLike, NodeProps, NodeStore, 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 };
|