@hology/webgpu-renderer 0.1.24 → 0.1.25

package/dist/index.d.ts

@@ -280,6 +280,8 @@ interface RendererOptions {
     invokeObjectRenderCallbacks?: boolean;
 }
 interface StaticDrawSetOptions {
+    /** Retain source instance IDs for explicit transform/visibility refreshes. Topology stays fixed. */
+    mutableTransforms?: boolean;
     /** Defaults inherited by objects without overrides. Frozen at registration. */
     detailCulling?: DetailCullingSettings;
     label?: string;
@@ -296,6 +298,8 @@ interface StaticDrawSet {
     readonly drawCount: number;
     readonly instanceCount: number;
     enabled: boolean;
+    /** Refresh resident transforms/instance visibility. Requires mutableTransforms; topology stays fixed. */
+    updateTransforms(): void;
     dispose(): void;
 }
 interface RendererGraphBuilderContext {
@@ -384,10 +388,15 @@ interface RendererSceneCapturePostProcessContext {
 }
 /** Non-temporal, unshadowed scene view sharing the renderer's GPU resources. */
 interface RendererSceneCapture {
+    /** Display-space output format, for preparing a custom postProcess pipeline. */
+    readonly format: GPUTextureFormat;
     /** Triangles submitted by the most recent capture, before raster clipping. */
     readonly triangleCount: number;
     /** Persistent display-space output when created without a canvas. Owned by the capture. */
     readonly textureView?: GPUTextureView;
+    /** Prepare this view's material variants without blocking on synchronous pipeline creation.
+     * Does not submit a capture or prepare a custom postProcess callback. */
+    prepareAsync(scene: three.Scene, camera: PerspectiveCamera | OrthographicCamera, options?: RendererSceneCaptureOptions): Promise<void>;
     capture(scene: three.Scene, camera: PerspectiveCamera | OrthographicCamera, options?: RendererSceneCaptureOptions): void;
     dispose(): void;
 }
@@ -893,7 +902,8 @@ declare class SDFGI {
     /** Capture one all-layer projection per frame, before main-view extraction. */
     prepare(scene: Scene, camera: Camera): void;
     private updateLights;
-    addPasses(graph: FrameGraphBuilder): void;
+    /** Returns whether the update pass was added, for dependent material passes. */
+    addPasses(graph: FrameGraphBuilder): boolean;
     /** Records the same production path used by the renderer; useful to GPU checks. */
     encode(encoder: GPUCommandEncoder, timeSeconds?: number): void;
     private encodeVolume;
@@ -1266,8 +1276,10 @@ declare class WebGpuRenderer {
      * upload buffers, but never advances gameplay motion/visibility history.
      */
     createSceneCapture(canvas: HTMLCanvasElement | null, width?: number, height?: number): RendererSceneCapture;
+    private prepareSceneCaptureAsync;
     compile(scene: Scene, camera: PerspectiveCamera | OrthographicCamera): void;
     compileAsync(scene: Scene, camera: PerspectiveCamera | OrthographicCamera): Promise<void>;
+    prepareSceneGeometryAsync(scene: Scene, camera: Camera): Promise<void>;
     /**
      * Creates a Three-compatible CubeUV PMREM generator. Its output is a
      * HalfFloat Texture and can be assigned directly to a graph material's
@@ -1288,6 +1300,8 @@ declare class WebGpuRenderer {
     private disposeStaticDrawSetResource;
     private renderFrame;
     private recordPresentationOverlay;
+    /** Present application UI without changing scene extraction, pipelines or temporal history. */
+    renderPresentationOnly(): void;
     destroy(): void;
     private createStaticPipelines;
     private ensureTransmissionSnapshot;