@flighthq/render-wgpu 0.5.1-next.973.788d3d7 → 0.6.0

package/dist/wgpuScissor.d.ts

@@ -1,6 +1,6 @@
-import type { WgpuRenderState, WgpuScissorRect } from '@flighthq/types/contract';
-export declare function applyWgpuScissorRect(state: WgpuRenderState, pass: GPURenderPassEncoder): void;
+import type { WgpuRenderPassEncoder, WgpuRenderState, WgpuScissorRect } from './contract.render-wgpu-types.ts';
+export declare function applyWgpuScissorRect(state: WgpuRenderState, pass: WgpuRenderPassEncoder): void;
 export declare function popWgpuScissorRect(state: WgpuRenderState): void;
 export declare function pushWgpuScissorRect(state: WgpuRenderState, rect: Readonly<WgpuScissorRect>): void;
-export declare function setWgpuRenderPassScissorRect(state: Readonly<WgpuRenderState>, pass: GPURenderPassEncoder, x: number, y: number, width: number, height: number): void;
+export declare function setWgpuRenderPassScissorRect(state: WgpuRenderState, pass: WgpuRenderPassEncoder, x: number, y: number, width: number, height: number): void;
 //# sourceMappingURL=wgpuScissor.d.ts.map

package/dist/wgpuScissor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wgpuScissor.d.ts","sourceRoot":"","sources":["../src/wgpuScissor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAQjF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,oBAAoB,GAAG,IAAI,CAW7F;AAKD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAI/D;AAMD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,IAAI,CAMjG;AAID,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,QAAQ,CAAC,eAAe,CAAC,EAChC,IAAI,EAAE,oBAAoB,EAC1B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,IAAI,CAGN"}
+{"version":3,"file":"wgpuScissor.d.ts","sourceRoot":"","sources":["../src/wgpuScissor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAO/G,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,qBAAqB,GAAG,IAAI,CAW9F;AAKD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAI/D;AAMD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,IAAI,CAMjG;AAMD,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE,qBAAqB,EAC3B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,IAAI,CAIN"}

package/dist/wgpuScissor.js

@@ -1,5 +1,5 @@
-import { getWgpuSurfaceRenderScale } from './wgpuAntialias';
-import { getWgpuRenderStateRuntime } from './wgpuRenderState';
+import { getWgpuRenderStateRuntime } from './wgpuRenderState.js';
+import { getWgpuRenderTargetSupersampleScale } from './wgpuRenderTarget.js';
 // Applies the current scissor rectangle to the active render pass. No-op when there is no active
 // scissor or no open render pass. Call after each draw call or once per pass when the active
 // scissor changes.
@@ -35,10 +35,13 @@ export function pushWgpuScissorRect(state, rect) {
     }
     runtime.currentScissorRect = { x: rect.x, y: rect.y, width: rect.width, height: rect.height };
 }
-// Converts a logical main-surface scissor to the physical supersample surface. Offscreen render-target
-// scissors pass through unchanged because their viewport and texture already share one coordinate space.
+// Converts a logical scissor rect to the target's physical extent. Logical is the space every 2D
+// coordinate is in — the pass viewport, the projection, and these rects — so a supersampled target
+// (a screen with antialias, or an effect target at sampleCount 4) scales them by the same factor its
+// storage was grown by, and a target with no supersample scales by 1.
 export function setWgpuRenderPassScissorRect(state, pass, x, y, width, height) {
-    const scale = getWgpuSurfaceRenderScale(state);
+    const target = getWgpuRenderStateRuntime(state).currentRenderTarget;
+    const scale = target === null ? 1 : getWgpuRenderTargetSupersampleScale(target);
     pass.setScissorRect(x * scale, y * scale, width * scale, height * scale);
 }
 //# sourceMappingURL=wgpuScissor.js.map

package/dist/wgpuScissor.js.map

@@ -1 +1 @@
-{"version":3,"file":"wgpuScissor.js","sourceRoot":"","sources":["../src/wgpuScissor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,iGAAiG;AACjG,6FAA6F;AAC7F,mBAAmB;AACnB,MAAM,UAAU,oBAAoB,CAAC,KAAsB,EAAE,IAA0B;IACrF,MAAM,OAAO,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,OAAO,CAAC,kBAAkB,CAAC;IACxC,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO;IAC1B,kGAAkG;IAClG,yEAAyE;IACzE,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7C,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9C,4BAA4B,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,6FAA6F;AAC7F,iGAAiG;AACjG,wDAAwD;AACxD,MAAM,UAAU,kBAAkB,CAAC,KAAsB;IACvD,MAAM,OAAO,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC;IACxC,OAAO,CAAC,kBAAkB,GAAG,IAAI,IAAI,IAAI,CAAC;AAC5C,CAAC;AAED,2FAA2F;AAC3F,kGAAkG;AAClG,gGAAgG;AAChG,qEAAqE;AACrE,MAAM,UAAU,mBAAmB,CAAC,KAAsB,EAAE,IAA+B;IACzF,MAAM,OAAO,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IACjD,IAAI,OAAO,CAAC,kBAAkB,KAAK,IAAI,EAAE,CAAC;QACxC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,CAAC,kBAAkB,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;AAChG,CAAC;AAED,uGAAuG;AACvG,yGAAyG;AACzG,MAAM,UAAU,4BAA4B,CAC1C,KAAgC,EAChC,IAA0B,EAC1B,CAAS,EACT,CAAS,EACT,KAAa,EACb,MAAc;IAEd,MAAM,KAAK,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IAC/C,IAAI,CAAC,cAAc,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,KAAK,EAAE,KAAK,GAAG,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC;AAC3E,CAAC"}
+{"version":3,"file":"wgpuScissor.js","sourceRoot":"","sources":["../src/wgpuScissor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,mCAAmC,EAAE,MAAM,uBAAuB,CAAC;AAE5E,iGAAiG;AACjG,6FAA6F;AAC7F,mBAAmB;AACnB,MAAM,UAAU,oBAAoB,CAAC,KAAsB,EAAE,IAA2B;IACtF,MAAM,OAAO,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,OAAO,CAAC,kBAAkB,CAAC;IACxC,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO;IAC1B,kGAAkG;IAClG,yEAAyE;IACzE,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7C,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9C,4BAA4B,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,6FAA6F;AAC7F,iGAAiG;AACjG,wDAAwD;AACxD,MAAM,UAAU,kBAAkB,CAAC,KAAsB;IACvD,MAAM,OAAO,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC;IACxC,OAAO,CAAC,kBAAkB,GAAG,IAAI,IAAI,IAAI,CAAC;AAC5C,CAAC;AAED,2FAA2F;AAC3F,kGAAkG;AAClG,gGAAgG;AAChG,qEAAqE;AACrE,MAAM,UAAU,mBAAmB,CAAC,KAAsB,EAAE,IAA+B;IACzF,MAAM,OAAO,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IACjD,IAAI,OAAO,CAAC,kBAAkB,KAAK,IAAI,EAAE,CAAC;QACxC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,CAAC,kBAAkB,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;AAChG,CAAC;AAED,iGAAiG;AACjG,mGAAmG;AACnG,qGAAqG;AACrG,sEAAsE;AACtE,MAAM,UAAU,4BAA4B,CAC1C,KAAsB,EACtB,IAA2B,EAC3B,CAAS,EACT,CAAS,EACT,KAAa,EACb,MAAc;IAEd,MAAM,MAAM,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC,mBAAmB,CAAC;IACpE,MAAM,KAAK,GAAG,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,mCAAmC,CAAC,MAAM,CAAC,CAAC;IAChF,IAAI,CAAC,cAAc,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,KAAK,EAAE,KAAK,GAAG,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC;AAC3E,CAAC"}

package/dist/wgpuScreenAntialias.d.ts

@@ -0,0 +1,3 @@
+import type { WgpuScreenRenderTarget } from './contract.render-wgpu-types.ts';
+export declare function enableWgpuScreenRenderTargetAntialias(target: WgpuScreenRenderTarget): void;
+//# sourceMappingURL=wgpuScreenAntialias.d.ts.map

package/dist/wgpuScreenAntialias.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wgpuScreenAntialias.d.ts","sourceRoot":"","sources":["../src/wgpuScreenAntialias.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,sBAAsB,EAEvB,MAAM,iCAAiC,CAAC;AAazC,wBAAgB,qCAAqC,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAO1F"}

package/dist/wgpuScreenAntialias.js

@@ -0,0 +1,120 @@
+import { WgpuShaderStage, WgpuTextureUsage } from './contract.render-wgpu-types.js';
+import { getWgpuRenderStateDeviceResources, getWgpuRenderStateRuntime } from './wgpuRenderState.js';
+import { syncWgpuScreenRenderTargetExtent } from './wgpuScreenRenderTarget.js';
+// Turns on 2x-per-axis supersampling for a screen target: the frame draws into a 2x texture and one
+// fullscreen linear-sampling pass resolves it into the swap chain immediately before submit. Each
+// destination pixel center averages the corresponding 2x2 source texels, so this is a real resolve and
+// not a post-hoc image filter, and every scene pipeline stays single-sampled — the seam is the surface,
+// not the pipeline.
+//
+// Separately importable on purpose: a frame loop that never calls this pulls in neither the resolve
+// pipeline nor its shader, which is most of what a screen target would otherwise cost.
+export function enableWgpuScreenRenderTargetAntialias(target) {
+    target.antialias = true;
+    target.acquireAntialiasView = acquireWgpuScreenRenderTargetAntialiasView;
+    target.encodeAntialiasResolve = encodeWgpuScreenRenderTargetResolve;
+    // The extent is physical storage, and the factor it is measured in just changed: re-sync now rather
+    // than leaving width/height a frame behind the flag that scales them.
+    syncWgpuScreenRenderTargetExtent(target);
+}
+function acquireWgpuScreenRenderTargetAntialiasView(state, target) {
+    const width = target.width;
+    const height = target.height;
+    const maxDimension = target.device.limits.maxTextureDimension2D;
+    if (width > maxDimension || height > maxDimension) {
+        throw new Error(`enableWgpuScreenRenderTargetAntialias requires a ${width}x${height} supersample surface, exceeding maxTextureDimension2D ${maxDimension}.`);
+    }
+    const existing = target.antialiasTexture;
+    if (existing !== null && existing.width === width && existing.height === height)
+        return target.antialiasView;
+    existing?.destroy();
+    const texture = target.device.createTexture({
+        size: [width, height, 1],
+        format: target.format,
+        usage: WgpuTextureUsage.RENDER_ATTACHMENT | WgpuTextureUsage.TEXTURE_BINDING,
+    });
+    target.antialiasTexture = texture;
+    target.antialiasView = texture.createView();
+    target.antialiasResolveBindGroup = target.device.createBindGroup({
+        layout: ensureWgpuScreenAntialiasPipeline(state, target),
+        entries: [
+            { binding: 0, resource: target.antialiasView },
+            { binding: 1, resource: getWgpuRenderStateDeviceResources(state).linearSampler },
+        ],
+    });
+    return target.antialiasView;
+}
+function encodeWgpuScreenRenderTargetResolve(state, target, encoder) {
+    const presentationView = target.presentationView;
+    const bindGroup = target.antialiasResolveBindGroup;
+    const pipeline = getWgpuRenderStateRuntime(state).surfaceAntialiasResolvePipeline;
+    if (presentationView === null || pipeline === null || bindGroup === null)
+        return;
+    const pass = encoder.beginRenderPass({
+        colorAttachments: [
+            {
+                view: presentationView,
+                loadOp: 'clear',
+                storeOp: 'store',
+                clearValue: { r: 0, g: 0, b: 0, a: 0 },
+            },
+        ],
+    });
+    pass.setPipeline(pipeline);
+    pass.setBindGroup(0, bindGroup);
+    pass.draw(3);
+    pass.end();
+}
+// The resolve pipeline is device-tier: every screen target on one device compiles it once and shares it.
+// Returns the bind-group layout the caller's per-target bind group is built against.
+function ensureWgpuScreenAntialiasPipeline(state, target) {
+    const runtime = getWgpuRenderStateRuntime(state);
+    const existing = runtime.surfaceAntialiasResolveBindGroupLayout;
+    if (existing !== null && runtime.surfaceAntialiasResolvePipeline !== null)
+        return existing;
+    const bindGroupLayout = target.device.createBindGroupLayout({
+        entries: [
+            { binding: 0, visibility: WgpuShaderStage.FRAGMENT, texture: { sampleType: 'float' } },
+            { binding: 1, visibility: WgpuShaderStage.FRAGMENT, sampler: { type: 'filtering' } },
+        ],
+    });
+    const layout = target.device.createPipelineLayout({ bindGroupLayouts: [bindGroupLayout] });
+    const module = target.device.createShaderModule({ code: SCREEN_ANTIALIAS_WGSL });
+    runtime.surfaceAntialiasResolveBindGroupLayout = bindGroupLayout;
+    runtime.surfaceAntialiasResolvePipeline = target.device.createRenderPipeline({
+        layout,
+        vertex: { module, entryPoint: 'vs_main' },
+        fragment: { module, entryPoint: 'fs_main', targets: [{ format: target.format }] },
+        primitive: { topology: 'triangle-list' },
+    });
+    return bindGroupLayout;
+}
+const SCREEN_ANTIALIAS_WGSL = /* wgsl */ `
+struct VertexOutput {
+  @builtin(position) position: vec4f,
+  @location(0) uv: vec2f,
+};
+
+@vertex
+fn vs_main(@builtin(vertex_index) index: u32) -> VertexOutput {
+  let positions = array<vec2f, 3>(
+    vec2f(-1.0, -1.0),
+    vec2f(3.0, -1.0),
+    vec2f(-1.0, 3.0),
+  );
+  let position = positions[index];
+  var output: VertexOutput;
+  output.position = vec4f(position, 0.0, 1.0);
+  output.uv = position * vec2f(0.5, -0.5) + vec2f(0.5);
+  return output;
+}
+
+@group(0) @binding(0) var source_texture: texture_2d<f32>;
+@group(0) @binding(1) var source_sampler: sampler;
+
+@fragment
+fn fs_main(input: VertexOutput) -> @location(0) vec4f {
+  return textureSample(source_texture, source_sampler, input.uv);
+}
+`;
+//# sourceMappingURL=wgpuScreenAntialias.js.map

package/dist/wgpuScreenAntialias.js.map

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

package/dist/wgpuScreenCapture.d.ts

@@ -0,0 +1,6 @@
+import type { Bitmap } from '@flighthq/bitmap/contract';
+import type { WgpuCommandEncoder, WgpuScreenRenderTarget } from './contract.render-wgpu-types.ts';
+export declare function createBitmapFromWgpuScreenRenderTarget(target: Readonly<WgpuScreenRenderTarget>, timeoutMs?: number): Promise<Bitmap>;
+export declare function enableWgpuScreenRenderTargetCapture(target: WgpuScreenRenderTarget): void;
+export declare function encodeWgpuScreenRenderTargetCapture(target: WgpuScreenRenderTarget, encoder: WgpuCommandEncoder): void;
+//# sourceMappingURL=wgpuScreenCapture.d.ts.map

package/dist/wgpuScreenCapture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wgpuScreenCapture.d.ts","sourceRoot":"","sources":["../src/wgpuScreenCapture.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAExD,OAAO,KAAK,EAEV,kBAAkB,EAClB,sBAAsB,EAEvB,MAAM,iCAAiC,CAAC;AAczC,wBAAsB,sCAAsC,CAC1D,MAAM,EAAE,QAAQ,CAAC,sBAAsB,CAAC,EACxC,SAAS,SAAyB,GACjC,OAAO,CAAC,MAAM,CAAC,CAyCjB;AAMD,wBAAgB,mCAAmC,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAIxF;AAwBD,wBAAgB,mCAAmC,CAAC,MAAM,EAAE,sBAAsB,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAgCrH"}

package/dist/wgpuScreenCapture.js

@@ -0,0 +1,138 @@
+import { createBitmap } from '@flighthq/bitmap/contract';
+import { WgpuBufferUsage, WgpuMapMode, WgpuTextureUsage } from './contract.render-wgpu-types.js';
+// Opt-in capture of a screen target's frame to a CPU Bitmap. Two environment facts drive the design:
+// (1) headless/software adapters never present the swap chain, and its texture reads back as zeros, so
+// the frame is redirected into an offscreen COPY_SRC texture the screen target owns; (2) GPU work queued
+// in a later task than the frame is dropped on these adapters, so the frame's own submit copies that
+// texture into the retained capture buffer, and the readback below only maps the buffer.
+//
+// One buffer serves both sides, so they take turns: the writer skips its copy while the reader holds a
+// map (or has one in flight), and resumes on the next frame. Without that turn-taking a continuously
+// animating scene re-enqueues a copy every frame into the buffer a readback is waiting on — which the
+// queue may not touch while it is mapped, and which pushes the pending map behind ever more GPU work.
+export async function createBitmapFromWgpuScreenRenderTarget(target, timeoutMs = DEFAULT_MAP_TIMEOUT_MS) {
+    const buffer = target.captureBuffer;
+    if (buffer === null) {
+        throw new Error('createBitmapFromWgpuScreenRenderTarget requires enableWgpuScreenRenderTargetCapture(target) before rendering, then a submitted frame.');
+    }
+    const width = target.captureWidth;
+    const height = target.captureHeight;
+    const bytesPerRow = target.captureBytesPerRow;
+    await mapWgpuCaptureBuffer(buffer, timeoutMs);
+    const mapped = new Uint8Array(buffer.getMappedRange());
+    const bitmap = createBitmap(width, height);
+    const out = bitmap.data;
+    // The preferred canvas format is BGRA on most platforms and RGBA on software adapters; normalize to
+    // the Bitmap's RGBA byte order so coverage/fingerprint and saved pixels read correctly either way.
+    // Pixels are left premultiplied (the texture's stored form): functional content renders over an opaque
+    // background, so alpha is 255 and premultiplied == straight; do NOT un-premultiply here — dividing RGB
+    // by an 8-bit alpha amplifies quantization and clamps, blowing out exactly the semi-transparent pixels
+    // a colour comparison cares about. If straight-alpha output is ever needed, convert at the consumer in
+    // higher precision, or compare in premultiplied space on both sides.
+    const swizzleBGRA = target.format === 'bgra8unorm' || target.format === 'bgra8unorm-srgb';
+    for (let y = 0; y < height; y++) {
+        const srcRow = y * bytesPerRow;
+        const dstRow = y * width * 4;
+        for (let x = 0; x < width; x++) {
+            const s = srcRow + x * 4;
+            const d = dstRow + x * 4;
+            out[d] = swizzleBGRA ? mapped[s + 2] : mapped[s];
+            out[d + 1] = mapped[s + 1];
+            out[d + 2] = swizzleBGRA ? mapped[s] : mapped[s + 2];
+            out[d + 3] = mapped[s + 3];
+        }
+    }
+    // Unmap (not destroy) so the next frame's submit can copy into the retained buffer again.
+    buffer.unmap();
+    return bitmap;
+}
+// Enables opt-in capture on a screen target so createBitmapFromWgpuScreenRenderTarget can read it back.
+// The frame is then drawn into an offscreen texture instead of the swap chain (the only reliably readable
+// path on headless/software adapters); the canvas is not presented while capture is on. Leave it off for
+// normal on-screen rendering. The capture texture and buffer are allocated lazily.
+export function enableWgpuScreenRenderTargetCapture(target) {
+    target.captureEnabled = true;
+    target.acquireCaptureTexture = acquireWgpuScreenRenderTargetCaptureTexture;
+    target.encodeCapture = encodeWgpuScreenRenderTargetCapture;
+}
+// The offscreen texture a captured frame renders into, sized to the surface's logical extent (a
+// supersampled frame resolves down into it). Installed as the target's capture slot by the enable above.
+function acquireWgpuScreenRenderTargetCaptureTexture(target) {
+    const scale = target.antialias ? 2 : 1;
+    const width = Math.max(1, Math.floor(target.width / scale));
+    const height = Math.max(1, Math.floor(target.height / scale));
+    const existing = target.captureTexture;
+    if (existing !== null && existing.width === width && existing.height === height)
+        return existing;
+    existing?.destroy();
+    const texture = target.device.createTexture({
+        size: [width, height, 1],
+        format: target.format,
+        usage: WgpuTextureUsage.RENDER_ATTACHMENT | WgpuTextureUsage.TEXTURE_BINDING | WgpuTextureUsage.COPY_SRC,
+    });
+    target.captureTexture = texture;
+    return texture;
+}
+// Encodes the capture-texture → capture-buffer copy into the frame's command encoder, sizing and
+// reallocating the retained buffer to the surface on demand. No-op unless capture is enabled. Internal:
+// called by submitWgpuFrame so the copy is queued in the render frame, not a later (dropped) task.
+export function encodeWgpuScreenRenderTargetCapture(target, encoder) {
+    const texture = target.captureTexture;
+    if (!target.captureEnabled || texture === null)
+        return;
+    // The reader owns the buffer while it holds a map. One retained buffer serves both sides, and the
+    // queue may not touch a buffer that is mapped or has a map in flight — so a frame encoded during a
+    // readback both invalidates the copy and stacks more GPU work in front of the map it is waiting on.
+    // Skipping the frame is the handshake: the reader is already taking a snapshot, and the next frame
+    // resumes copying once it lets go.
+    //
+    // Deliberately written as "is it busy" rather than "is it not unmapped": an implementation without
+    // `mapState` reports undefined, and the inverted test would then skip every copy for the whole run
+    // and capture nothing. Unknown state falls through to the copy, which is the pre-existing behaviour.
+    const mapState = target.captureBuffer?.mapState;
+    if (mapState === 'pending' || mapState === 'mapped')
+        return;
+    const width = texture.width;
+    const height = texture.height;
+    // Wgpu requires copyTextureToBuffer rows to be 256-byte aligned; the buffer is padded per row.
+    const bytesPerRow = Math.ceil((width * 4) / 256) * 256;
+    if (target.captureBuffer === null || target.captureWidth !== width || target.captureHeight !== height) {
+        target.captureBuffer?.destroy();
+        target.captureBuffer = target.device.createBuffer({
+            size: bytesPerRow * height,
+            usage: WgpuBufferUsage.COPY_DST | WgpuBufferUsage.MAP_READ,
+        });
+        target.captureBytesPerRow = bytesPerRow;
+        target.captureWidth = width;
+        target.captureHeight = height;
+    }
+    encoder.copyTextureToBuffer({ texture }, { buffer: target.captureBuffer, bytesPerRow }, [width, height, 1]);
+}
+// Maps the retained capture buffer, giving up by name after `timeoutMs` (0 waits indefinitely).
+// `mapAsync` carries no timeout and no reject path of its own: on the contended software adapters this
+// capture path exists for, the promise can simply never settle, and an unbounded await is indistinguishable
+// from a caller that stopped running. A late resolution after the deadline leaves the buffer mapped, which
+// is why the timeout is a hard end for this capture and not something to retry against the same buffer.
+async function mapWgpuCaptureBuffer(buffer, timeoutMs) {
+    const mapping = buffer.mapAsync(WgpuMapMode.READ);
+    if (timeoutMs <= 0)
+        return mapping;
+    // The race abandons `mapping` on timeout; adopt its eventual rejection here so it is never unhandled.
+    mapping.catch(() => { });
+    let timer;
+    const expiry = new Promise((_resolve, reject) => {
+        timer = setTimeout(() => {
+            reject(new Error(`createBitmapFromWgpuScreenRenderTarget: capture buffer did not map within ${timeoutMs}ms`));
+        }, timeoutMs);
+    });
+    try {
+        await Promise.race([mapping, expiry]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+// Generous by design: this bounds a driver that has stopped answering, not a slow one. Callers working
+// inside a tighter budget (the capture harness) pass their own.
+const DEFAULT_MAP_TIMEOUT_MS = 10_000;
+//# sourceMappingURL=wgpuScreenCapture.js.map

package/dist/wgpuScreenCapture.js.map

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

package/dist/wgpuScreenRenderTarget.d.ts

@@ -0,0 +1,11 @@
+import type { EntityConstruction } from '@flighthq/entity/contract';
+import type { Surface } from '@flighthq/surface/contract';
+import type { HostWgpuCapability, WgpuDevice, WgpuRenderState, WgpuRenderTarget, WgpuScreenRenderTarget, WgpuScreenRenderTargetOptions, WgpuTextureView } from './contract.render-wgpu-types.ts';
+export declare function bindWgpuScreenRenderTarget(state: WgpuRenderState, target: WgpuScreenRenderTarget): WgpuTextureView;
+export declare function createWgpuScreenRenderTarget(wgpuHost: Readonly<HostWgpuCapability>, device: WgpuDevice, drawable: Readonly<Surface>, options?: Readonly<WgpuScreenRenderTargetOptions>): WgpuScreenRenderTarget;
+export declare function destroyWgpuScreenRenderTarget(target: WgpuScreenRenderTarget): void;
+export declare function endWgpuScreenRenderTargetFrame(target: WgpuScreenRenderTarget): void;
+export declare function initializeWgpuScreenRenderTarget(out: EntityConstruction<WgpuScreenRenderTarget>, wgpuHost: Readonly<HostWgpuCapability>, device: WgpuDevice, drawable: Readonly<Surface>, options?: Readonly<WgpuScreenRenderTargetOptions>): void;
+export declare function isWgpuScreenRenderTarget(target: Readonly<WgpuRenderTarget>): target is WgpuScreenRenderTarget;
+export declare function syncWgpuScreenRenderTargetExtent(target: WgpuScreenRenderTarget): void;
+//# sourceMappingURL=wgpuScreenRenderTarget.d.ts.map

package/dist/wgpuScreenRenderTarget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wgpuScreenRenderTarget.d.ts","sourceRoot":"","sources":["../src/wgpuScreenRenderTarget.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAE1D,OAAO,KAAK,EACV,kBAAkB,EAClB,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,6BAA6B,EAE7B,eAAe,EAChB,MAAM,iCAAiC,CAAC;AAOzC,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,sBAAsB,GAAG,eAAe,CAYlH;AAID,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EACtC,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,EAC3B,OAAO,GAAE,QAAQ,CAAC,6BAA6B,CAAM,GACpD,sBAAsB,CAIxB;AAKD,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAYlF;AAID,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAEnF;AAED,wBAAgB,gCAAgC,CAC9C,GAAG,EAAE,kBAAkB,CAAC,sBAAsB,CAAC,EAC/C,QAAQ,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EACtC,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,EAC3B,OAAO,GAAE,QAAQ,CAAC,6BAA6B,CAAM,GACpD,IAAI,CAwCN;AAKD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,MAAM,IAAI,sBAAsB,CAE7G;AAED,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAIrF"}

package/dist/wgpuScreenRenderTarget.js

@@ -0,0 +1,121 @@
+import { allocateEntity } from '@flighthq/entity/contract';
+import { WgpuTextureUsage } from './contract.render-wgpu-types.js';
+// Acquires the color view a screen pass attaches to, sizing the target's storage to the surface first.
+// The returned view is the supersample texture when antialiasing is enabled and the presentation view
+// otherwise; either way `presentationView` names where the frame ultimately lands, so the submit can
+// resolve and capture it. Internal: called by beginWgpuRenderPass.
+export function bindWgpuScreenRenderTarget(state, target) {
+    syncWgpuScreenRenderTargetExtent(target);
+    ensureWgpuScreenRenderTargetDepthStencil(target);
+    if (target.presentationView === null) {
+        // With capture on, render into an offscreen COPY_SRC texture instead of the swap chain: software and
+        // headless adapters never present the swap chain and its texture reads back as zeros, so the readable
+        // copy must be the render target itself.
+        const presentationTexture = target.acquireCaptureTexture?.(target) ?? target.context.getCurrentTexture();
+        target.presentationView = presentationTexture.createView();
+    }
+    return target.acquireAntialiasView?.(state, target) ?? target.presentationView;
+}
+// A screen target's whole point is that it presents; a texture target's is that it can be sampled. Both
+// creations are Entity allocations, so a factory is the only place either capability is decided.
+export function createWgpuScreenRenderTarget(wgpuHost, device, drawable, options = {}) {
+    const out = allocateEntity();
+    initializeWgpuScreenRenderTarget(out, wgpuHost, device, drawable, options);
+    return out;
+}
+// Frees the GPU storage this target owns — depth-stencil, supersample, and capture — and unconfigures
+// its canvas context. The target is invalid afterward. The storage is freed here even though the code
+// that filled it lives in the opt-in modules: a target owns its allocations whoever wrote to them.
+export function destroyWgpuScreenRenderTarget(target) {
+    target.depthStencilTexture.destroy();
+    target.antialiasTexture?.destroy();
+    target.antialiasTexture = null;
+    target.antialiasView = null;
+    target.antialiasResolveBindGroup = null;
+    target.captureTexture?.destroy();
+    target.captureTexture = null;
+    target.captureBuffer?.destroy();
+    target.captureBuffer = null;
+    target.presentationView = null;
+    target.context.unconfigure();
+}
+// Releases the per-frame swap-chain view. The next frame acquires a fresh one, which is the whole reason
+// a screen target is not sampleable: nothing may hold this across frames.
+export function endWgpuScreenRenderTargetFrame(target) {
+    target.presentationView = null;
+}
+export function initializeWgpuScreenRenderTarget(out, wgpuHost, device, drawable, options = {}) {
+    const format = options.format ?? 'bgra8unorm';
+    const result = wgpuHost.attachSurface(drawable, {
+        alphaMode: options.alphaMode ?? 'premultiplied',
+        device,
+        format,
+    });
+    if (result === null)
+        throw new Error('createWgpuScreenRenderTarget: the target cannot present WebGPU.');
+    const { context, surface } = result;
+    const width = Math.max(1, surface.width);
+    const height = Math.max(1, surface.height);
+    const depthStencilTexture = createWgpuScreenDepthStencilTexture(device, width, height);
+    out.acquireAntialiasView = null;
+    out.acquireCaptureTexture = null;
+    out.antialias = false;
+    out.antialiasResolveBindGroup = null;
+    out.antialiasTexture = null;
+    out.antialiasView = null;
+    out.captureBuffer = null;
+    out.captureBytesPerRow = 0;
+    out.captureEnabled = false;
+    out.captureHeight = 0;
+    out.captureTexture = null;
+    out.captureWidth = 0;
+    out.colorAttachments = 1;
+    out.colorSpace = options.colorSpace ?? 'srgb';
+    out.context = context;
+    out.depthStencilTexture = depthStencilTexture;
+    out.depthStencilView = depthStencilTexture.createView();
+    out.device = device;
+    out.encodeAntialiasResolve = null;
+    out.encodeCapture = null;
+    out.format = format;
+    out.height = height;
+    out.presentationView = null;
+    out.sampleCount = 1;
+    out.surface = surface;
+    out.width = width;
+}
+// The base type says which storage a target names through `context`; this is the narrowing that reads it.
+// Sampling, present, and effect-input APIs take WgpuTextureRenderTarget precisely so they never have to
+// ask — the swap chain has no sampleable texture handle to give them.
+export function isWgpuScreenRenderTarget(target) {
+    return target.context !== null;
+}
+export function syncWgpuScreenRenderTargetExtent(target) {
+    const scale = target.antialias ? WGPU_SCREEN_SUPERSAMPLE_SCALE : 1;
+    target.width = Math.max(1, target.surface.width) * scale;
+    target.height = Math.max(1, target.surface.height) * scale;
+}
+function createWgpuScreenDepthStencilTexture(device, width, height) {
+    return device.createTexture({
+        size: [Math.max(1, width), Math.max(1, height), 1],
+        format: 'depth24plus-stencil8',
+        usage: WgpuTextureUsage.RENDER_ATTACHMENT,
+    });
+}
+function ensureWgpuScreenRenderTargetDepthStencil(target) {
+    const texture = target.depthStencilTexture;
+    if (texture.width === target.width && texture.height === target.height)
+        return;
+    texture.destroy();
+    const replacement = createWgpuScreenDepthStencilTexture(target.device, target.width, target.height);
+    target.depthStencilTexture = replacement;
+    target.depthStencilView = replacement.createView();
+}
+// Brings the target's extent back in line with its surface — the surface is the authority on its own
+// size, and it can be resized between any two frames. Every pass calls this, so a caller never has to
+// announce a resize; enabling supersampling calls it too, because the factor it multiplies by changed.
+// One place decides how much bigger a supersampled surface is than its logical extent.
+// wgpuTextureRenderTarget.ts carries the same number for offscreen storage; they are the same concept
+// applied to two surfaces.
+const WGPU_SCREEN_SUPERSAMPLE_SCALE = 2;
+//# sourceMappingURL=wgpuScreenRenderTarget.js.map

package/dist/wgpuScreenRenderTarget.js.map

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

package/dist/wgpuShader.d.ts

@@ -1,13 +1,16 @@
-import type { ColorScaleBias, EntityConstruction, RenderProxy, WgpuBindGroupLayouts, WgpuRenderState } from '@flighthq/types/contract';
-import { BlendMode } from '@flighthq/types/contract';
+import type { ColorScaleBias } from '@flighthq/adjustments/contract';
+import type { EntityConstruction } from '@flighthq/entity/contract';
+import { BlendMode } from '@flighthq/materials/contract';
+import type { RenderProxy } from '@flighthq/render/contract';
+import type { WgpuBindGroupLayout, WgpuBindGroupLayouts, WgpuBlendState, WgpuDevice, WgpuPipelineLayout, WgpuRenderPipeline, WgpuRenderState } from './contract.render-wgpu-types.ts';
 export declare const UNIFORM_BYTE_SIZE = 128;
 type StencilMode = 'normal' | 'masked' | 'maskwrite';
-export declare function createWgpuBindGroupLayouts(device: GPUDevice): WgpuBindGroupLayouts;
-export declare function createWgpuPipelineLayout(device: GPUDevice, uniformBindGroupLayout: GPUBindGroupLayout, textureBindGroupLayout: GPUBindGroupLayout): GPUPipelineLayout;
-export declare function getActiveWgpuPipeline(state: WgpuRenderState): GPURenderPipeline;
-export declare function getWgpuBlendState(blendMode: BlendMode | null): GPUBlendState;
-export declare function getWgpuPipeline(state: WgpuRenderState, blendMode: BlendMode | null, stencilMode: StencilMode): GPURenderPipeline;
-export declare function initializeWgpuBindGroupLayouts(out: EntityConstruction<WgpuBindGroupLayouts>, device: GPUDevice): void;
+export declare function createWgpuBindGroupLayouts(device: WgpuDevice): WgpuBindGroupLayouts;
+export declare function createWgpuPipelineLayout(device: WgpuDevice, uniformBindGroupLayout: WgpuBindGroupLayout, textureBindGroupLayout: WgpuBindGroupLayout): WgpuPipelineLayout;
+export declare function getActiveWgpuPipeline(state: WgpuRenderState): WgpuRenderPipeline;
+export declare function getWgpuBlendState(blendMode: BlendMode | null): WgpuBlendState;
+export declare function getWgpuPipeline(state: WgpuRenderState, blendMode: BlendMode | null, stencilMode: StencilMode): WgpuRenderPipeline;
+export declare function initializeWgpuBindGroupLayouts(out: EntityConstruction<WgpuBindGroupLayouts>, device: WgpuDevice): void;
 export declare function setWgpuMatrixFromTransform(matrixArray: Float32Array, t: {
     a: number;
     b: number;

package/dist/wgpuShader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wgpuShader.d.ts","sourceRoot":"","sources":["../src/wgpuShader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,oBAAoB,EACpB,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAkBrD,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAiHrC,KAAK,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;AAyBrD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,oBAAoB,CAIlF;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,EACjB,sBAAsB,EAAE,kBAAkB,EAC1C,sBAAsB,EAAE,kBAAkB,GACzC,iBAAiB,CAInB;AAID,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,eAAe,GAAG,iBAAiB,CAQ/E;AAKD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,GAAG,aAAa,CAE5E;AAYD,wBAAgB,eAAe,CAC7B,KAAK,EAAE,eAAe,EACtB,SAAS,EAAE,SAAS,GAAG,IAAI,EAC3B,WAAW,EAAE,WAAW,GACvB,iBAAiB,CAgDnB;AAED,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,kBAAkB,CAAC,oBAAoB,CAAC,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAkBrH;AAID,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,YAAY,EACzB,CAAC,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,EACzE,QAAQ,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1C,IAAI,CAgBN;AAID,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,eAAe,EACtB,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,EACjF,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACT,MAAM,CAcR;AAKD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,eAAe,EACtB,WAAW,EAAE;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CACrF,EACD,cAAc,EAAE,cAAc,GAAG,IAAI,EACrC,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,oBAAoB,UAAQ,GAC3B,MAAM,CAsDR"}
+{"version":3,"file":"wgpuShader.d.ts","sourceRoot":"","sources":["../src/wgpuShader.ts"],"names":[],"mappings":"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"}

package/dist/wgpuShader.js

@@ -1,7 +1,8 @@
-import { allocateEntity, finishEntity } from '@flighthq/entity/contract';
-import { BlendMode } from '@flighthq/types/contract';
-import { getWgpuSurfaceRenderExtent } from './wgpuAntialias';
-import { getWgpuRenderStateDeviceResources, getWgpuRenderStateRuntime } from './wgpuRenderState';
+import { allocateEntity } from '@flighthq/entity/contract';
+import { BlendMode } from '@flighthq/materials/contract';
+import { WgpuColorWrite, WgpuShaderStage } from './contract.render-wgpu-types.js';
+import { getWgpuRenderPassViewport } from './wgpuRenderPass.js';
+import { getWgpuRenderStateDeviceResources, getWgpuRenderStateRuntime } from './wgpuRenderState.js';
 // ---- WGSL source ----
 // Uniform buffer layout (per-draw slot in the ring, 256-byte aligned):
 //   offset  0–47 : mat3x3f matrix (3 columns × 16 bytes each due to vec3 padding)
@@ -146,7 +147,7 @@ const BLEND_MODES = {
 export function createWgpuBindGroupLayouts(device) {
     const out = allocateEntity();
     initializeWgpuBindGroupLayouts(out, device);
-    return finishEntity(out);
+    return out;
 }
 export function createWgpuPipelineLayout(device, uniformBindGroupLayout, textureBindGroupLayout) {
     return device.createPipelineLayout({
@@ -206,7 +207,7 @@ export function getWgpuPipeline(state, blendMode, stencilMode) {
                 {
                     format,
                     blend: isMaskWrite ? undefined : blend,
-                    writeMask: isMaskWrite ? 0 : GPUColorWrite.ALL,
+                    writeMask: isMaskWrite ? 0 : WgpuColorWrite.ALL,
                 },
             ],
         },
@@ -229,15 +230,15 @@ export function initializeWgpuBindGroupLayouts(out, device) {
         entries: [
             {
                 binding: 0,
-                visibility: GPUShaderStage.VERTEX | GPUShaderStage.FRAGMENT,
+                visibility: WgpuShaderStage.VERTEX | WgpuShaderStage.FRAGMENT,
                 buffer: { type: 'uniform', hasDynamicOffset: true, minBindingSize: UNIFORM_BYTE_SIZE },
             },
         ],
     });
     const textureBindGroupLayout = 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' } },
         ],
     });
     out.uniformBindGroupLayout = uniformBindGroupLayout;
@@ -273,7 +274,7 @@ export function writeWgpuQuadUniforms(state, renderProxy, colorScaleBias, x0, y0
     const byteOffset = runtime.uniformOffset;
     const floatBase = byteOffset >> 2; // divide by 4
     const { uniformData, uniformDataU32, matrixArray } = runtime;
-    const viewport = runtime.renderTargetViewport ?? getWgpuSurfaceRenderExtent(state);
+    const viewport = getWgpuRenderPassViewport(state);
     setWgpuMatrixFromTransform(matrixArray, renderProxy.transform2D, viewport);
     // mat3x3 columns with per-column padding (4 floats each = 16 bytes):
     uniformData[floatBase + 0] = matrixArray[0];