@flighthq/render-wgpu 0.5.1-next.920.da8f530 → 0.6.0

package/dist/{wgpuBackground.js → wgpuFrame.js}

@@ -1,30 +1,12 @@
-import { acquireWgpuSurfaceAntialiasView, clearWgpuSurfacePresentation, encodeWgpuSurfaceAntialiasResolve, } from './wgpuAntialias';
-import { getWgpuRenderStateRuntime } from './wgpuRenderState';
-import { acquireWgpuFrameCaptureTexture, encodeWgpuFrameCapture } from './wgpuSurface';
-function ensureWgpuDepthStencil(state, width, height) {
-    const runtime = getWgpuRenderStateRuntime(state);
-    if (runtime.depthStencilTexture !== null &&
-        runtime.depthStencilWidth === width &&
-        runtime.depthStencilHeight === height) {
-        return;
-    }
-    runtime.depthStencilTexture?.destroy();
-    const texture = state.device.createTexture({
-        size: [Math.max(1, width), Math.max(1, height), 1],
-        format: 'depth24plus-stencil8',
-        usage: GPUTextureUsage.RENDER_ATTACHMENT,
-    });
-    runtime.depthStencilTexture = texture;
-    runtime.depthStencilView = texture.createView();
-    runtime.depthStencilWidth = width;
-    runtime.depthStencilHeight = height;
-}
+import { getWgpuRenderStateRuntime } from './wgpuRenderState.js';
+import { endWgpuScreenRenderTargetFrame } from './wgpuScreenRenderTarget.js';
 /**
- * Opens the command encoder for a WebGPU frame without opening the canvas render pass.
+ * Opens the command encoder a frame records into, without opening any render pass.
  *
- * Recipes with prerequisite GPU work (for example a directional-shadow depth pass) call this first,
- * record that work, then call renderWgpuBackground to open the forward canvas pass on the same encoder.
- * Ordinary render loops can keep calling renderWgpuBackground directly; it begins a frame lazily.
+ * beginWgpuRenderPass calls this itself, and the pass that opened the frame submits it at end — so an
+ * ordinary render loop never names either function. Call it explicitly when several passes must land in
+ * ONE submit (a shadow depth pass before the screen pass): the frame is then yours, and you finish it
+ * with submitWgpuFrame.
  */
 export function beginWgpuFrame(state) {
     const runtime = getWgpuRenderStateRuntime(state);
@@ -37,64 +19,7 @@ export function beginWgpuFrame(state) {
     runtime.quadBatchWriterBufferCursor = 0;
     runtime.meshInstanceBufferCursor = 0;
     runtime.currentBlendMode = null;
-    runtime.currentRenderTarget = null;
-    runtime.currentMaskDepth = 0;
-    runtime.maskWriteMode = false;
-    runtime.currentScissorRect = null;
-    runtime.scissorStack = [];
-}
-export function renderWgpuBackground(state) {
-    const runtime = getWgpuRenderStateRuntime(state);
-    // End any previous open pass (safety guard).
-    if (runtime.renderPass !== null) {
-        runtime.renderPass.end();
-        runtime.renderPass = null;
-    }
-    // Preserve prerequisite work and its uniform-ring allocations when a recipe opened the frame
-    // explicitly. The common path still creates and resets the frame here.
-    beginWgpuFrame(state);
-    const surface = state.surface;
-    const context = state.context;
-    const width = surface.width;
-    const height = surface.height;
-    // With frame capture on, render into an offscreen COPY_SRC texture instead of the swapchain: software/
-    // headless adapters never present the swapchain and its texture reads back as zeros, so the readable
-    // copy must be the render target itself.
-    const presentationTexture = acquireWgpuFrameCaptureTexture(state) ?? context.getCurrentTexture();
-    const presentationView = presentationTexture.createView();
-    const antialiasView = acquireWgpuSurfaceAntialiasView(state, presentationView);
-    const renderWidth = antialiasView === null ? width : width * 2;
-    const renderHeight = antialiasView === null ? height : height * 2;
-    ensureWgpuDepthStencil(state, renderWidth, renderHeight);
-    const canvasView = antialiasView ?? presentationView;
-    runtime.canvasTextureView = canvasView;
-    runtime.canvasViewCleared = true;
-    // The canvas (and the capture texture, when capture is on) is the canvas format; scene pipelines key on this.
-    runtime.currentColorFormat = state.format;
-    runtime.renderTargetViewport = null;
-    const rgba = state.backgroundColorRgba;
-    const clearValue = rgba.length >= 4 && rgba[3] > 0 ? { r: rgba[0], g: rgba[1], b: rgba[2], a: rgba[3] } : { r: 0, g: 0, b: 0, a: 0 };
-    const renderPass = runtime.commandEncoder.beginRenderPass({
-        colorAttachments: [
-            {
-                view: canvasView,
-                clearValue,
-                loadOp: 'clear',
-                storeOp: 'store',
-            },
-        ],
-        depthStencilAttachment: {
-            view: runtime.depthStencilView,
-            depthClearValue: 1.0,
-            depthLoadOp: 'clear',
-            depthStoreOp: 'discard',
-            stencilClearValue: 0,
-            stencilLoadOp: 'clear',
-            stencilStoreOp: 'discard',
-        },
-    });
-    renderPass.setViewport(0, 0, renderWidth, renderHeight, 0, 1);
-    runtime.renderPass = renderPass;
+    runtime.frameScreenTarget = null;
 }
 // Hands a buffer to the post-submit retirement list instead of destroying it now — the buffer sibling of
 // retireWgpuTexture below, and subject to the same rule for the same reason: a frame records into one
@@ -112,34 +37,38 @@ export function retireWgpuBuffer(state, buffer) {
 // submit, and the symptom is an ENTIRELY BLANK FRAME with a console warning naming a texture rather than
 // a call site — a cost-to-diagnose far out of proportion to the one line that causes it. Callers that
 // replace a texture during recording (a grown palette arena, a resized rasterization cache, a cache entry
-// rewritten on a payload version bump) retire it here; submitWgpuRenderPass frees it once the frame is
+// rewritten on a payload version bump) retire it here; submitWgpuFrame frees it once the frame is
 // safely on the queue.
 export function retireWgpuTexture(state, texture) {
     const runtime = getWgpuRenderStateRuntime(state);
     (runtime.retiredTextures ?? (runtime.retiredTextures = [])).push(texture);
 }
-export function submitWgpuRenderPass(state) {
+// Finishes the frame: uploads the used part of the uniform ring, resolves a supersampled screen target,
+// encodes its capture copy, and submits the command buffer. The pass that opened the frame calls this at
+// its end, so an ordinary render loop never names it; a caller that opened the frame with beginWgpuFrame
+// finishes it here.
+export function submitWgpuFrame(state) {
     const runtime = getWgpuRenderStateRuntime(state);
-    const { renderPass, commandEncoder, uniformBuffer, uniformData, uniformOffset } = runtime;
+    const { commandEncoder, uniformBuffer, uniformData, uniformOffset } = runtime;
     const device = state.device;
-    if (renderPass !== null) {
-        renderPass.end();
-        runtime.renderPass = null;
-    }
+    endWgpuFramePasses(state);
+    const screen = runtime.frameScreenTarget;
     if (commandEncoder !== null) {
         // Upload used portion of the uniform ring buffer before submission.
         // writeBuffer is a queue operation that completes before the subsequent submit.
         if (uniformOffset > 0) {
             device.queue.writeBuffer(uniformBuffer, 0, uniformData.buffer, 0, uniformOffset);
         }
-        // Resolve the optional 2× main surface into the presentation target before capture reads it back.
-        encodeWgpuSurfaceAntialiasResolve(state, commandEncoder);
-        // Copy the offscreen capture texture into the readback buffer within this frame's encoder; on the
-        // adapters capture exists for, GPU work queued in a later task does not land.
-        // A standalone offscreen frame (for example a render-cache bake) has no canvas view and must not
+        // A frame that only drew into texture targets has no screen to resolve or capture, and must not
         // overwrite the capture buffer with the previous visible frame's retained capture texture.
-        if (runtime.canvasTextureView !== null)
-            encodeWgpuFrameCapture(state, commandEncoder);
+        if (screen !== null) {
+            // Resolve the optional 2x supersample into the presentation view before capture reads it back, then
+            // copy the capture texture into the readback buffer within this frame's encoder — on the adapters
+            // capture exists for, GPU work queued in a later task does not land. Both arrive as slots the
+            // opt-in modules install, so a frame that uses neither pulls in neither.
+            screen.encodeAntialiasResolve?.(state, screen, commandEncoder);
+            screen.encodeCapture?.(screen, commandEncoder);
+        }
         device.queue.submit([commandEncoder.finish()]);
         runtime.commandEncoder = null;
         // Now that the frame is submitted, free the buffers retired mid-frame (clip pops, grown particle
@@ -157,14 +86,17 @@ export function submitWgpuRenderPass(state) {
             retiredTextures.length = 0;
         }
     }
-    runtime.canvasTextureView = null;
-    runtime.canvasViewCleared = false;
-    clearWgpuSurfacePresentation(state);
+    if (screen !== null)
+        endWgpuScreenRenderTargetFrame(screen);
+    runtime.frameScreenTarget = null;
 }
 /**
- * Temporarily records an offscreen state's work into a presentation state's live command encoder.
+ * Temporarily records an offscreen state's work into another state's live command encoder.
  * The borrower keeps its own uniform ring, batch buffers, traversal counters, and GPU resources; only
  * the frame encoder/pass boundary is borrowed, and this callback bracket always returns it.
+ *
+ * The open pass stack is borrowed by reference, so a pass the borrower opens suspends and resumes the
+ * owner's innermost pass exactly as one opened on the owner would.
  */
 export function withWgpuFrameBorrow(ownerState, borrowerState, callback) {
     if (borrowerState.device !== ownerState.device) {
@@ -180,16 +112,12 @@ export function withWgpuFrameBorrow(ownerState, borrowerState, callback) {
     const saved = captureBorrowerFrameState(borrower);
     borrower.commandEncoder = owner.commandEncoder;
     borrower.renderPass = owner.renderPass;
-    borrower.canvasTextureView = owner.canvasTextureView;
-    borrower.canvasViewCleared = owner.canvasViewCleared;
-    borrower.depthStencilTexture = owner.depthStencilTexture;
-    borrower.depthStencilView = owner.depthStencilView;
-    borrower.depthStencilWidth = owner.depthStencilWidth;
-    borrower.depthStencilHeight = owner.depthStencilHeight;
+    borrower.frameScreenTarget = owner.frameScreenTarget;
+    borrower.passStack = owner.passStack;
     borrower.currentColorFormat = owner.currentColorFormat;
     borrower.currentRenderTarget = owner.currentRenderTarget;
     borrower.renderTargetViewport = owner.renderTargetViewport;
-    borrower.borrowedSurfaceExtent = { height: ownerState.surface.height, width: ownerState.surface.width };
+    borrower.borrowedSurfaceExtent = owner.renderTargetViewport;
     borrower.uniformOffset = 0;
     borrower.quadBatchWriterBufferCursor = 0;
     borrower.meshInstanceBufferCursor = 0;
@@ -202,33 +130,50 @@ export function withWgpuFrameBorrow(ownerState, borrowerState, callback) {
         }
         owner.commandEncoder = borrower.commandEncoder;
         owner.renderPass = borrower.renderPass;
-        owner.canvasTextureView = borrower.canvasTextureView;
-        owner.canvasViewCleared = borrower.canvasViewCleared;
-        owner.depthStencilTexture = borrower.depthStencilTexture;
-        owner.depthStencilView = borrower.depthStencilView;
-        owner.depthStencilWidth = borrower.depthStencilWidth;
-        owner.depthStencilHeight = borrower.depthStencilHeight;
+        owner.frameScreenTarget = borrower.frameScreenTarget;
         owner.currentColorFormat = borrower.currentColorFormat;
         owner.currentRenderTarget = borrower.currentRenderTarget;
         owner.renderTargetViewport = borrower.renderTargetViewport;
         transferRetiredWgpuResources(borrower, owner);
         restoreBorrowerFrameState(borrower, saved);
         if (ownsFrame)
-            submitWgpuRenderPass(ownerState);
+            submitWgpuFrame(ownerState);
+    }
+}
+// A frame submit closes everything the frame recorded. A pass still open here is a caller that never
+// ended its bracket — the encoder cannot survive into the next frame, so the stack is unwound to the
+// state the outermost begin saved. Those handles are dropped rather than pooled: this is the abnormal
+// path, and returning a handle the caller may still be holding is worse than letting one be collected.
+function endWgpuFramePasses(state) {
+    const runtime = getWgpuRenderStateRuntime(state);
+    const stack = runtime.passStack;
+    if (runtime.renderPass !== null) {
+        runtime.renderPass.end();
+        runtime.renderPass = null;
     }
+    if (stack.length === 0)
+        return;
+    for (let i = stack.length - 1; i >= 0; i--)
+        stack[i].encoder = null;
+    const saved = stack[0].saved;
+    runtime.currentRenderTarget = saved.renderTarget;
+    runtime.currentColorFormat = saved.colorFormat;
+    runtime.renderTargetViewport = saved.renderTargetViewport;
+    runtime.clipForms = saved.clipForms;
+    runtime.currentMaskDepth = saved.currentMaskDepth;
+    runtime.maskWriteMode = saved.maskWriteMode;
+    runtime.currentScissorRect = saved.currentScissorRect;
+    runtime.scissorStack = saved.scissorStack;
+    stack.length = 0;
 }
 function captureBorrowerFrameState(runtime) {
     return {
-        canvasTextureView: runtime.canvasTextureView,
-        canvasViewCleared: runtime.canvasViewCleared,
         borrowedSurfaceExtent: runtime.borrowedSurfaceExtent,
         commandEncoder: runtime.commandEncoder,
         currentColorFormat: runtime.currentColorFormat,
         currentRenderTarget: runtime.currentRenderTarget,
-        depthStencilHeight: runtime.depthStencilHeight,
-        depthStencilTexture: runtime.depthStencilTexture,
-        depthStencilView: runtime.depthStencilView,
-        depthStencilWidth: runtime.depthStencilWidth,
+        frameScreenTarget: runtime.frameScreenTarget,
+        passStack: runtime.passStack,
         renderPass: runtime.renderPass,
         renderTargetViewport: runtime.renderTargetViewport,
     };
@@ -246,4 +191,4 @@ function transferRetiredWgpuResources(borrower, owner) {
         borrower.retiredTextures.length = 0;
     }
 }
-//# sourceMappingURL=wgpuBackground.js.map
+//# sourceMappingURL=wgpuFrame.js.map

package/dist/wgpuFrame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wgpuFrame.js","sourceRoot":"","sources":["../src/wgpuFrame.ts"],"names":[],"mappings":"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"}

package/dist/wgpuFullscreenPass.d.ts

@@ -1,6 +1,7 @@
-import type { EntityConstruction, WgpuFullscreenPipeline, WgpuRenderState, WgpuRenderTarget } from '@flighthq/types/contract';
-export declare function createWgpuFullscreenPipeline(state: WgpuRenderState, fragmentWgsl: string, textureInputCount?: number, format?: GPUTextureFormat): WgpuFullscreenPipeline;
+import type { EntityConstruction } from '@flighthq/entity/contract';
+import type { WgpuBindGroup, WgpuBindGroupLayout, WgpuFullscreenPipeline, WgpuRenderState, WgpuTextureFormat, WgpuTextureRenderTarget } from './contract.render-wgpu-types.ts';
+export declare function createWgpuFullscreenPipeline(state: WgpuRenderState, fragmentWgsl: string, textureInputCount?: number, format?: WgpuTextureFormat): WgpuFullscreenPipeline;
 export declare function destroyWgpuFullscreenPipeline(_state: WgpuRenderState, _pipeline: WgpuFullscreenPipeline): void;
-export declare function drawWgpuFullscreenPass(state: WgpuRenderState, wgpuPipeline: Readonly<WgpuFullscreenPipeline>, inputs: ReadonlyArray<Readonly<WgpuRenderTarget>>, dest: Readonly<WgpuRenderTarget> | null, setUniforms: ((state: WgpuRenderState, uniformBindGroupLayout: GPUBindGroupLayout) => GPUBindGroup) | null): void;
-export declare function initializeWgpuFullscreenPipeline(out: EntityConstruction<WgpuFullscreenPipeline>, state: WgpuRenderState, fragmentWgsl: string, textureInputCount?: number, format?: GPUTextureFormat): void;
+export declare function drawWgpuFullscreenPass(state: WgpuRenderState, wgpuPipeline: Readonly<WgpuFullscreenPipeline>, inputs: ReadonlyArray<Readonly<WgpuTextureRenderTarget>>, setUniforms: ((state: WgpuRenderState, uniformBindGroupLayout: WgpuBindGroupLayout) => WgpuBindGroup) | null): void;
+export declare function initializeWgpuFullscreenPipeline(out: EntityConstruction<WgpuFullscreenPipeline>, state: WgpuRenderState, fragmentWgsl: string, textureInputCount?: number, format?: WgpuTextureFormat): void;
 //# sourceMappingURL=wgpuFullscreenPass.d.ts.map

package/dist/wgpuFullscreenPass.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wgpuFullscreenPass.d.ts","sourceRoot":"","sources":["../src/wgpuFullscreenPass.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,EACf,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAIlC,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,eAAe,EACtB,YAAY,EAAE,MAAM,EACpB,iBAAiB,SAAI,EACrB,MAAM,GAAE,gBAA+B,GACtC,sBAAsB,CAIxB;AAKD,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,sBAAsB,GAAG,IAAI,CAG9G;AASD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,eAAe,EACtB,YAAY,EAAE,QAAQ,CAAC,sBAAsB,CAAC,EAC9C,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,EACjD,IAAI,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,IAAI,EACvC,WAAW,EAAE,CAAC,CAAC,KAAK,EAAE,eAAe,EAAE,sBAAsB,EAAE,kBAAkB,KAAK,YAAY,CAAC,GAAG,IAAI,GACzG,IAAI,CAyBN;AAOD,wBAAgB,gCAAgC,CAC9C,GAAG,EAAE,kBAAkB,CAAC,sBAAsB,CAAC,EAC/C,KAAK,EAAE,eAAe,EACtB,YAAY,EAAE,MAAM,EACpB,iBAAiB,SAAI,EACrB,MAAM,GAAE,gBAA+B,GACtC,IAAI,CAyCN"}
+{"version":3,"file":"wgpuFullscreenPass.d.ts","sourceRoot":"","sources":["../src/wgpuFullscreenPass.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EACxB,MAAM,iCAAiC,CAAC;AAIzC,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,eAAe,EACtB,YAAY,EAAE,MAAM,EACpB,iBAAiB,SAAI,EACrB,MAAM,GAAE,iBAAgC,GACvC,sBAAsB,CAIxB;AAKD,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,sBAAsB,GAAG,IAAI,CAG9G;AAOD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,eAAe,EACtB,YAAY,EAAE,QAAQ,CAAC,sBAAsB,CAAC,EAC9C,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC,EACxD,WAAW,EAAE,CAAC,CAAC,KAAK,EAAE,eAAe,EAAE,sBAAsB,EAAE,mBAAmB,KAAK,aAAa,CAAC,GAAG,IAAI,GAC3G,IAAI,CA2BN;AAOD,wBAAgB,gCAAgC,CAC9C,GAAG,EAAE,kBAAkB,CAAC,sBAAsB,CAAC,EAC/C,KAAK,EAAE,eAAe,EACtB,YAAY,EAAE,MAAM,EACpB,iBAAiB,SAAI,EACrB,MAAM,GAAE,iBAAgC,GACvC,IAAI,CAoDN"}

package/dist/wgpuFullscreenPass.js

@@ -1,9 +1,10 @@
-import { allocateEntity, finishEntity } from '@flighthq/entity/contract';
-import { getWgpuRenderStateDeviceResources, getWgpuRenderStateRuntime } from './wgpuRenderState';
+import { allocateEntity } from '@flighthq/entity/contract';
+import { WgpuBufferUsage, WgpuShaderStage } from './contract.render-wgpu-types.js';
+import { getWgpuRenderStateRuntime } from './wgpuRenderState.js';
 export function createWgpuFullscreenPipeline(state, fragmentWgsl, textureInputCount = 1, format = state.format) {
     const out = allocateEntity();
     initializeWgpuFullscreenPipeline(out, state, fragmentWgsl, textureInputCount, format);
-    return finishEntity(out);
+    return out;
 }
 // Destroys a fullscreen pipeline's GPU resources. The pipeline and layouts are GC-managed in
 // WebGPU and have no explicit destroy(); this function is a no-op but kept for API symmetry with
@@ -12,24 +13,25 @@ export function destroyWgpuFullscreenPipeline(_state, _pipeline) {
     // WebGPU pipelines and layouts have no destroy() — they are GC-managed. Drop the reference
     // on the caller's side to allow collection.
 }
-// Draws a fullscreen pass into the current render target (or a provided explicit target).
-// Binds `inputs[i]` as texture @group(1+i) @binding(0), calls `setUniforms` for per-pass
-// uploads (pass null if the shader declares no uniforms), then draws 3 vertices.
+// Draws a fullscreen pass into the current render target. Binds `inputs[i]` as texture
+// @group(1+i) @binding(0), calls `setUniforms` for per-pass uploads (pass null if the shader
+// declares no uniforms), then draws 3 vertices.
 //
-// Requires an open render pass (renderWgpuBackground or beginWgpuRenderPass must have been
-// called first). When `dest` is null the current open pass is used as-is; when `dest` is
-// provided, its bind group is set via the caller's render pass.
-export function drawWgpuFullscreenPass(state, wgpuPipeline, inputs, dest, setUniforms) {
+// Requires an open render pass: beginWgpuRenderPass fixes the destination, and this draws into it.
+export function drawWgpuFullscreenPass(state, wgpuPipeline, inputs, setUniforms) {
     const runtime = getWgpuRenderStateRuntime(state);
-    const pass = dest !== null ? runtime.renderPass : runtime.renderPass;
-    if (pass === null)
+    const pass = runtime.renderPass;
+    const resources = runtime.context.resources;
+    if (pass === null || resources === null)
         return;
     pass.setPipeline(wgpuPipeline.pipeline);
     if (setUniforms !== null) {
         const uniformBindGroup = setUniforms(state, wgpuPipeline.uniformBindGroupLayout);
         pass.setBindGroup(0, uniformBindGroup);
     }
-    const resources = getWgpuRenderStateDeviceResources(state);
+    else {
+        pass.setBindGroup(0, wgpuPipeline.emptyUniformBindGroup);
+    }
     for (let i = 0; i < inputs.length; i++) {
         const input = inputs[i];
         const layout = wgpuPipeline.textureBindGroupLayouts[i];
@@ -58,7 +60,7 @@ export function initializeWgpuFullscreenPipeline(out, state, fragmentWgsl, textu
         entries: [
             {
                 binding: 0,
-                visibility: GPUShaderStage.FRAGMENT,
+                visibility: WgpuShaderStage.FRAGMENT,
                 buffer: { type: 'uniform' },
             },
         ],
@@ -67,8 +69,8 @@ export function initializeWgpuFullscreenPipeline(out, state, fragmentWgsl, textu
     for (let i = 0; i < textureInputCount; i++) {
         textureBindGroupLayouts.push(device.createBindGroupLayout({
             entries: [
-                { binding: 0, visibility: GPUShaderStage.FRAGMENT, texture: { sampleType: 'float' } },
-                { binding: 1, visibility: GPUShaderStage.FRAGMENT, sampler: { type: 'filtering' } },
+                { binding: 0, visibility: WgpuShaderStage.FRAGMENT, texture: { sampleType: 'float' } },
+                { binding: 1, visibility: WgpuShaderStage.FRAGMENT, sampler: { type: 'filtering' } },
             ],
         }));
     }
@@ -86,11 +88,22 @@ export function initializeWgpuFullscreenPipeline(out, state, fragmentWgsl, textu
             targets: [{ format }],
         },
         primitive: { topology: 'triangle-list' },
+        depthStencil: {
+            format: 'depth24plus-stencil8',
+            depthWriteEnabled: false,
+            depthCompare: 'always',
+            stencilWriteMask: 0,
+        },
+    });
+    const emptyUniformBindGroup = device.createBindGroup({
+        layout: uniformBindGroupLayout,
+        entries: [{ binding: 0, resource: { buffer: device.createBuffer({ size: 16, usage: WgpuBufferUsage.UNIFORM }) } }],
     });
     out.pipeline = pipeline;
     out.pipelineLayout = pipelineLayout;
     out.uniformBindGroupLayout = uniformBindGroupLayout;
     out.textureBindGroupLayouts = textureBindGroupLayouts;
+    out.emptyUniformBindGroup = emptyUniformBindGroup;
 }
 // The substrate-level WebGPU fullscreen-pass primitive. Filter and effect leaf packages draw
 // through this; it is not filter-specific.

package/dist/wgpuFullscreenPass.js.map

@@ -1 +1 @@
-{"version":3,"file":"wgpuFullscreenPass.js","sourceRoot":"","sources":["../src/wgpuFullscreenPass.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"wgpuFullscreenPass.js","sourceRoot":"","sources":["../src/wgpuFullscreenPass.ts"],"names":[],"mappings":"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"}

package/dist/wgpuHost.d.ts

@@ -1,8 +1,5 @@
-import type { EntityConstruction, WgpuHostBackend } from '@flighthq/types/contract';
-export declare function createWebWgpuHostBackend(): WgpuHostBackend;
-export declare function getWgpuHostBackend(): WgpuHostBackend;
-export declare function initializeWebWgpuHostBackend(out: EntityConstruction<WgpuHostBackend>): void;
-export declare function installWgpuHostBackend(backend: WgpuHostBackend): void;
-export declare function resetWgpuHostBackendForTest(): void;
-export declare function setWgpuHostBackend(backend: WgpuHostBackend | null): void;
+import type { Surface } from '@flighthq/surface/contract';
+import type { HostWgpuCapability } from './contract.render-wgpu-types.ts';
+export declare function createTestWgpuSurface(canvas: HTMLCanvasElement): Surface;
+export declare const testWgpuHost: HostWgpuCapability;
 //# sourceMappingURL=wgpuHost.d.ts.map

package/dist/wgpuHost.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wgpuHost.d.ts","sourceRoot":"","sources":["../src/wgpuHost.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAuB,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAIzG,wBAAgB,wBAAwB,IAAI,eAAe,CAI1D;AAED,wBAAgB,kBAAkB,IAAI,eAAe,CAEpD;AAED,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,kBAAkB,CAAC,eAAe,CAAC,GAAG,IAAI,CA+C3F;AAGD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAErE;AAED,wBAAgB,2BAA2B,IAAI,IAAI,CAGlD;AAID,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI,CAExE"}
+{"version":3,"file":"wgpuHost.d.ts","sourceRoot":"","sources":["../src/wgpuHost.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAuB,OAAO,EAAkB,MAAM,4BAA4B,CAAC;AAE/F,OAAO,KAAK,EACV,kBAAkB,EAOnB,MAAM,iCAAiC,CAAC;AAKzC,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAMxE;AAED,eAAO,MAAM,YAAY,EAAE,kBAA6C,CAAC"}

package/dist/wgpuHost.js

@@ -1,75 +1,89 @@
-import { allocateEntity, finishEntity } from '@flighthq/entity/contract';
-// The explicit browser adapter. All WebGPU discovery and host-handle acquisition stays in this
-// function's call graph so render-state creation can also consume native caller-provided handles.
-export function createWebWgpuHostBackend() {
-    const out = allocateEntity();
-    initializeWebWgpuHostBackend(out);
-    return finishEntity(out);
+import { allocateEntity, createEntityRuntime } from '@flighthq/entity/contract';
+import { EntityRuntimeKey } from '@flighthq/entity/contract';
+import { WgpuTextureUsage } from './contract.render-wgpu-types.js';
+// Builds a Surface around an existing canvas, the way a host's create lane would. Reads the runtime slot
+// directly rather than through @flighthq/surface so this test double adds no package dependency.
+export function createTestWgpuSurface(canvas) {
+    const surface = allocateEntity();
+    const runtime = createEntityRuntime();
+    runtime.handle = canvas;
+    surface[EntityRuntimeKey] = runtime;
+    return surface;
 }
-export function getWgpuHostBackend() {
-    return _custom ?? _host ?? _web;
-}
-export function initializeWebWgpuHostBackend(out) {
-    out.acquire = async (canvas, options) => {
-        const gpu = getWebWgpu();
-        if (gpu === null)
-            throw new Error('WebGPU is not supported in this browser.');
-        const adapter = await gpu.requestAdapter(options.powerPreference !== undefined ? { powerPreference: options.powerPreference } : undefined);
-        if (adapter === null)
-            throw new Error('Failed to get WebGPU adapter.');
-        // The forward-lit 3D pipeline binds 5 groups (Frame, Draw, Material, Shadow, Ibl); request 5
-        // only when the adapter advertises it so baseline-4 adapters retain the portable paths.
-        const requiredLimits = {};
-        if (adapter.limits.maxBindGroups >= 5)
-            requiredLimits.maxBindGroups = 5;
-        // Compression features have to be enabled when the device is created. Unsupported families
-        // retain their CPU decode fallback.
-        const requiredFeatures = ['texture-compression-bc', 'texture-compression-etc2', 'texture-compression-astc'].filter((feature) => adapter.features.has(feature));
-        const descriptor = {};
-        if (Object.keys(requiredLimits).length > 0)
-            descriptor.requiredLimits = requiredLimits;
-        if (requiredFeatures.length > 0)
-            descriptor.requiredFeatures = requiredFeatures;
-        const device = await adapter.requestDevice(descriptor);
-        try {
-            const format = options.format ?? gpu.getPreferredCanvasFormat();
+export const testWgpuHost = initializeTestWgpuHost();
+function initializeTestWgpuHost() {
+    return {
+        create: (_window, width, height) => {
+            const canvas = document.createElement('canvas');
+            canvas.width = width;
+            canvas.height = height;
+            return canvas;
+        },
+        acquire: async (surface, options) => {
+            const canvas = testCanvas(surface);
+            if (canvas === null)
+                throw new Error('Test surface is not backed by a canvas.');
+            const gpu = getWebWgpu();
+            if (gpu === null)
+                throw new Error('WebGPU is not supported in this browser.');
+            const adapter = await gpu.requestAdapter(options.powerPreference !== undefined ? { powerPreference: options.powerPreference } : undefined);
+            if (adapter === null)
+                throw new Error('Failed to get WebGPU adapter.');
+            const requiredLimits = {};
+            if (adapter.limits.maxBindGroups >= 5)
+                requiredLimits.maxBindGroups = 5;
+            const requiredFeatures = ['texture-compression-bc', 'texture-compression-etc2', 'texture-compression-astc'].filter((feature) => adapter.features.has(feature));
+            const descriptor = {};
+            if (Object.keys(requiredLimits).length > 0)
+                descriptor.requiredLimits = requiredLimits;
+            if (requiredFeatures.length > 0)
+                descriptor.requiredFeatures = requiredFeatures;
+            const device = await adapter.requestDevice(descriptor);
+            try {
+                const format = options.format ?? gpu.getPreferredCanvasFormat();
+                const context = canvas.getContext('webgpu');
+                if (context === null)
+                    throw new Error('Failed to get WebGPU canvas context.');
+                const acquisition = allocateEntity();
+                acquisition.context = context;
+                acquisition.device = device;
+                acquisition.format = format;
+                acquisition.ownership = 'flight';
+                acquisition.surface = canvas;
+                return acquisition;
+            }
+            catch (error) {
+                device.destroy();
+                throw error;
+            }
+        },
+        attachSurface: (surface, attachment) => {
+            const canvas = testCanvas(surface);
+            if (canvas === null)
+                return null;
             const context = canvas.getContext('webgpu');
             if (context === null)
-                throw new Error('Failed to get WebGPU canvas context.');
-            const acquisition = allocateEntity();
-            acquisition.context = context;
-            acquisition.device = device;
-            acquisition.format = format;
-            acquisition.ownership = 'flight';
-            acquisition.surface = canvas;
-            return finishEntity(acquisition);
-        }
-        catch (error) {
-            device.destroy();
-            throw error;
-        }
-    };
-    out.isSupported = () => {
-        return getWebWgpu() !== null;
-    };
-    out.release = (acquisition) => {
-        acquisition.context.unconfigure();
-        acquisition.device.destroy();
+                return null;
+            context.configure({
+                device: attachment.device,
+                format: attachment.format,
+                alphaMode: attachment.alphaMode,
+                usage: WgpuTextureUsage.RENDER_ATTACHMENT | WgpuTextureUsage.COPY_SRC,
+            });
+            return { context, surface: canvas };
+        },
+        isSupported: () => {
+            return getWebWgpu() !== null;
+        },
+        release: (acquisition) => {
+            acquisition.context.unconfigure();
+            acquisition.device.destroy();
+        },
     };
 }
-// First host wins and a custom backend installed through setWgpuHostBackend always takes precedence.
-export function installWgpuHostBackend(backend) {
-    if (_host === null)
-        _host = backend;
-}
-export function resetWgpuHostBackendForTest() {
-    _custom = null;
-    _host = null;
-}
-// Installs a process-wide custom backend. Clearing it reveals the first installed host, or the
-// built-in explicit web adapter when no host has been installed.
-export function setWgpuHostBackend(backend) {
-    _custom = backend;
+function testCanvas(surface) {
+    const handle = surface[EntityRuntimeKey].handle;
+    return handle instanceof HTMLCanvasElement ? handle : null;
 }
 function getWebWgpu() {
     if (typeof navigator === 'undefined')
@@ -81,7 +95,4 @@ function getWebWgpu() {
         return null;
     }
 }
-const _web = createWebWgpuHostBackend();
-let _custom = null;
-let _host = null;
 //# sourceMappingURL=wgpuHost.js.map