@flighthq/render-wgpu 0.1.0

package/dist/wgpuShader.js

@@ -0,0 +1,304 @@
+import { BlendMode } from '@flighthq/types';
+import { getWgpuRenderStateRuntime } from './wgpuRenderState';
+// ---- 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)
+//   offset 48    : f32 alpha
+//   offset 52    : u32 hasColorTransform
+//   offset 56–63 : 2× f32 padding
+//   offset 64–79 : vec4f colorMultiplier
+//   offset 80–95 : vec4f colorOffset
+//   offset 96–111: f32 x0, y0, x1, y1 (quad pixel-space corners)
+//   offset 112–127: f32 u0, v0, u1, v1 (texture coordinates)
+// Total used: 128 bytes; slot size: minUniformBufferOffsetAlignment (≥256)
+export const UNIFORM_BYTE_SIZE = 128;
+const BITMAP_SHADER_SRC = /* wgsl */ `
+struct Uniforms {
+  matrix : mat3x3f,
+  alpha : f32,
+  hasColorTransform : u32,
+  _pad0 : f32,
+  _pad1 : f32,
+  colorMultiplier : vec4f,
+  colorOffset : vec4f,
+  x0 : f32, y0 : f32, x1 : f32, y1 : f32,
+  u0 : f32, v0 : f32, u1 : f32, v1 : f32,
+}
+
+@group(0) @binding(0) var<uniform> uni : Uniforms;
+@group(1) @binding(0) var tex : texture_2d<f32>;
+@group(1) @binding(1) var smp : sampler;
+
+struct VertexOut {
+  @builtin(position) position : vec4f,
+  @location(0) uv : vec2f,
+}
+
+// Quad corner order matching index pattern [0,1,2, 0,2,3]:
+//   vi 0 → corner (x0,y0,u0,v0)
+//   vi 1 → corner (x1,y0,u1,v0)
+//   vi 2 → corner (x1,y1,u1,v1)
+//   vi 3 → corner (x0,y0,u0,v0)  [repeated]
+//   vi 4 → corner (x1,y1,u1,v1)  [repeated]
+//   vi 5 → corner (x0,y1,u0,v1)
+
+@vertex
+fn vs_main(@builtin(vertex_index) vi : u32) -> VertexOut {
+  let xi = (vi == 1u || vi == 2u || vi == 4u);
+  let yi = (vi == 2u || vi == 4u || vi == 5u);
+  let x = select(uni.x0, uni.x1, xi);
+  let y = select(uni.y0, uni.y1, yi);
+  let u = select(uni.u0, uni.u1, xi);
+  let v = select(uni.v0, uni.v1, yi);
+  let p = uni.matrix * vec3f(x, y, 1.0);
+  var out : VertexOut;
+  out.position = vec4f(p.x, p.y, 0.0, 1.0);
+  out.uv = vec2f(u, v);
+  return out;
+}
+
+@fragment
+fn fs_main(in : VertexOut) -> @location(0) vec4f {
+  var color = textureSample(tex, smp, in.uv);
+  if (color.a <= 0.0) { discard; }
+  if (uni.hasColorTransform != 0u && color.a > 0.0) {
+    // Unpremultiply, apply transform, repremultiply
+    color = vec4f(color.rgb / color.a, color.a);
+    color = clamp(color * uni.colorMultiplier + uni.colorOffset, vec4f(0.0), vec4f(1.0));
+    color = vec4f(color.rgb * color.a, color.a);
+  }
+  return color * clamp(uni.alpha, 0.0, 1.0);
+}
+`;
+// Stencil-write pipeline: only writes to stencil, not color.
+// Uses same vertex shader; fragment just discards to keep stencil logic in pipeline state.
+const MASK_FRAGMENT_SRC = /* wgsl */ `
+struct Uniforms {
+  matrix : mat3x3f,
+  alpha : f32,
+  hasColorTransform : u32,
+  _pad0 : f32,
+  _pad1 : f32,
+  colorMultiplier : vec4f,
+  colorOffset : vec4f,
+  x0 : f32, y0 : f32, x1 : f32, y1 : f32,
+  u0 : f32, v0 : f32, u1 : f32, v1 : f32,
+}
+
+@group(0) @binding(0) var<uniform> uni : Uniforms;
+@group(1) @binding(0) var tex : texture_2d<f32>;
+@group(1) @binding(1) var smp : sampler;
+
+struct VertexOut {
+  @builtin(position) position : vec4f,
+  @location(0) uv : vec2f,
+}
+
+@vertex
+fn vs_main(@builtin(vertex_index) vi : u32) -> VertexOut {
+  let xi = (vi == 1u || vi == 2u || vi == 4u);
+  let yi = (vi == 2u || vi == 4u || vi == 5u);
+  let x = select(uni.x0, uni.x1, xi);
+  let y = select(uni.y0, uni.y1, yi);
+  let u = select(uni.u0, uni.u1, xi);
+  let v = select(uni.v0, uni.v1, yi);
+  let p = uni.matrix * vec3f(x, y, 1.0);
+  var out : VertexOut;
+  out.position = vec4f(p.x, p.y, 0.0, 1.0);
+  out.uv = vec2f(u, v);
+  return out;
+}
+
+@fragment
+fn fs_main(in : VertexOut) -> @location(0) vec4f {
+  let s = textureSample(tex, smp, in.uv);
+  if (s.a <= 0.0) { discard; }
+  return vec4f(0.0);
+}
+`;
+const NORMAL_BLEND = {
+    color: { srcFactor: 'one', dstFactor: 'one-minus-src-alpha', operation: 'add' },
+    alpha: { srcFactor: 'one', dstFactor: 'one-minus-src-alpha', operation: 'add' },
+};
+const BLEND_MODES = {
+    [BlendMode.Add]: {
+        color: { srcFactor: 'one', dstFactor: 'one', operation: 'add' },
+        alpha: { srcFactor: 'one', dstFactor: 'one', operation: 'add' },
+    },
+    [BlendMode.Alpha]: null,
+    [BlendMode.Darken]: null,
+    [BlendMode.Difference]: null,
+    [BlendMode.Erase]: null,
+    [BlendMode.Hardlight]: null,
+    [BlendMode.Invert]: null,
+    [BlendMode.Layer]: NORMAL_BLEND,
+    [BlendMode.Lighten]: null,
+    [BlendMode.Multiply]: null,
+    [BlendMode.Normal]: NORMAL_BLEND,
+    [BlendMode.Overlay]: null,
+    [BlendMode.Screen]: null,
+    [BlendMode.Shader]: null,
+    [BlendMode.Subtract]: null,
+};
+// ---- Pipeline creation ----
+export function createWgpuBindGroupLayouts(device) {
+    const uniformBindGroupLayout = device.createBindGroupLayout({
+        entries: [
+            {
+                binding: 0,
+                visibility: GPUShaderStage.VERTEX | GPUShaderStage.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' } },
+        ],
+    });
+    return { uniformBindGroupLayout, textureBindGroupLayout };
+}
+export function createWgpuPipelineLayout(device, uniformBindGroupLayout, textureBindGroupLayout) {
+    return device.createPipelineLayout({
+        bindGroupLayouts: [uniformBindGroupLayout, textureBindGroupLayout],
+    });
+}
+function buildStencilFaceState(stencilMode) {
+    if (stencilMode === 'maskwrite') {
+        return { compare: 'always', passOp: 'replace', failOp: 'keep', depthFailOp: 'keep' };
+    }
+    if (stencilMode === 'masked') {
+        return { compare: 'equal', passOp: 'keep', failOp: 'keep', depthFailOp: 'keep' };
+    }
+    return { compare: 'always', passOp: 'keep', failOp: 'keep', depthFailOp: 'keep' };
+}
+export function getActiveWgpuPipeline(state) {
+    const runtime = getWgpuRenderStateRuntime(state);
+    const stencilMode = runtime.maskWriteMode
+        ? 'maskwrite'
+        : runtime.currentMaskDepth > 0
+            ? 'masked'
+            : 'normal';
+    return getWgpuPipeline(state, runtime.currentBlendMode, stencilMode);
+}
+export function getWgpuPipeline(state, blendMode, stencilMode) {
+    const runtime = getWgpuRenderStateRuntime(state);
+    // The pipeline bakes its color-attachment format, so key on the current target format too (rgba16float
+    // inside an HDR effect target vs the canvas format).
+    const format = runtime.currentColorFormat ?? state.format;
+    const key = `${blendMode ?? 'null'}-${stencilMode}-${format}`;
+    const cached = runtime.pipelineCache.get(key);
+    if (cached !== undefined)
+        return cached;
+    const blend = (blendMode !== null ? BLEND_MODES[blendMode] : null) ?? NORMAL_BLEND;
+    const isMaskWrite = stencilMode === 'maskwrite';
+    const stencilFace = buildStencilFaceState(stencilMode);
+    const { device } = state;
+    const shaderSrc = isMaskWrite ? MASK_FRAGMENT_SRC : BITMAP_SHADER_SRC;
+    const module = device.createShaderModule({ code: shaderSrc });
+    const layout = createWgpuPipelineLayout(device, runtime.uniformBindGroupLayout, runtime.textureBindGroupLayout);
+    const pipeline = device.createRenderPipeline({
+        layout,
+        vertex: { module, entryPoint: 'vs_main' },
+        fragment: {
+            module,
+            entryPoint: 'fs_main',
+            targets: [
+                {
+                    format,
+                    blend: isMaskWrite ? undefined : blend,
+                    writeMask: isMaskWrite ? 0 : GPUColorWrite.ALL,
+                },
+            ],
+        },
+        depthStencil: {
+            format: 'depth24plus-stencil8',
+            depthWriteEnabled: false,
+            depthCompare: 'always',
+            stencilFront: stencilFace,
+            stencilBack: stencilFace,
+            stencilReadMask: 0xff,
+            stencilWriteMask: isMaskWrite ? 0xff : 0x00,
+        },
+        primitive: { topology: 'triangle-list' },
+    });
+    runtime.pipelineCache.set(key, pipeline);
+    return pipeline;
+}
+// ---- Matrix helpers ----
+export function setWgpuMatrixFromTransform(matrixArray, t, viewport) {
+    const iw = 2 / viewport.width;
+    const ih = 2 / viewport.height;
+    // Column-major mat3x3 with vec3-to-16-byte padding:
+    // col0
+    matrixArray[0] = t.a * iw;
+    matrixArray[1] = -t.b * ih;
+    matrixArray[2] = 0;
+    // col1
+    matrixArray[3] = t.c * iw;
+    matrixArray[4] = -t.d * ih;
+    matrixArray[5] = 0;
+    // col2
+    matrixArray[6] = t.tx * iw - 1;
+    matrixArray[7] = -t.ty * ih + 1;
+    matrixArray[8] = 1;
+}
+// ---- Uniform slot writing ----
+export function writeWgpuMatrixOnlyUniforms(state, renderProxy, transform, x0, y0, x1, y1, u0, v0, u1, v1) {
+    return writeWgpuQuadUniforms(state, { alpha: renderProxy.alpha, transform2D: transform }, null, x0, y0, x1, y1, u0, v0, u1, v1);
+}
+// Writes the standard uniforms (matrix + alpha + color transform + quad coords) into
+// the ring buffer at the current uniformOffset, then advances the offset by uniformStride.
+// Returns the byte offset of the slot just written (for use as the dynamic offset in setBindGroup).
+export function writeWgpuQuadUniforms(state, renderProxy, colorTransform, x0, y0, x1, y1, u0, v0, u1, v1) {
+    const runtime = getWgpuRenderStateRuntime(state);
+    const byteOffset = runtime.uniformOffset;
+    const floatBase = byteOffset >> 2; // divide by 4
+    const { uniformData, uniformDataU32, matrixArray } = runtime;
+    const viewport = runtime.renderTargetViewport ?? state.canvas;
+    setWgpuMatrixFromTransform(matrixArray, renderProxy.transform2D, viewport);
+    // mat3x3 columns with per-column padding (4 floats each = 16 bytes):
+    uniformData[floatBase + 0] = matrixArray[0];
+    uniformData[floatBase + 1] = matrixArray[1];
+    uniformData[floatBase + 2] = matrixArray[2];
+    uniformData[floatBase + 3] = 0;
+    uniformData[floatBase + 4] = matrixArray[3];
+    uniformData[floatBase + 5] = matrixArray[4];
+    uniformData[floatBase + 6] = matrixArray[5];
+    uniformData[floatBase + 7] = 0;
+    uniformData[floatBase + 8] = matrixArray[6];
+    uniformData[floatBase + 9] = matrixArray[7];
+    uniformData[floatBase + 10] = matrixArray[8];
+    uniformData[floatBase + 11] = 0;
+    // alpha at float 12 (byte 48)
+    uniformData[floatBase + 12] = renderProxy.alpha;
+    // hasColorTransform at float 13 (byte 52) — written as u32. The color transform comes from the
+    // node's material (resolved by the caller); null → identity.
+    uniformDataU32[floatBase + 13] = colorTransform !== null ? 1 : 0;
+    // padding floats 14–15
+    uniformData[floatBase + 14] = 0;
+    uniformData[floatBase + 15] = 0;
+    // colorMultiplier at float 16–19 (byte 64–79)
+    uniformData[floatBase + 16] = colorTransform?.redMultiplier ?? 1;
+    uniformData[floatBase + 17] = colorTransform?.greenMultiplier ?? 1;
+    uniformData[floatBase + 18] = colorTransform?.blueMultiplier ?? 1;
+    uniformData[floatBase + 19] = colorTransform?.alphaMultiplier ?? 1;
+    // colorOffset at float 20–23 (byte 80–95)
+    uniformData[floatBase + 20] = (colorTransform?.redOffset ?? 0) / 255;
+    uniformData[floatBase + 21] = (colorTransform?.greenOffset ?? 0) / 255;
+    uniformData[floatBase + 22] = (colorTransform?.blueOffset ?? 0) / 255;
+    uniformData[floatBase + 23] = (colorTransform?.alphaOffset ?? 0) / 255;
+    // quad corners at float 24–31 (byte 96–127)
+    uniformData[floatBase + 24] = x0;
+    uniformData[floatBase + 25] = y0;
+    uniformData[floatBase + 26] = x1;
+    uniformData[floatBase + 27] = y1;
+    uniformData[floatBase + 28] = u0;
+    uniformData[floatBase + 29] = v0;
+    uniformData[floatBase + 30] = u1;
+    uniformData[floatBase + 31] = v1;
+    runtime.uniformOffset += runtime.uniformStride;
+    return byteOffset;
+}
+//# sourceMappingURL=wgpuShader.js.map

package/dist/wgpuShader.js.map

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

package/dist/wgpuShaderBinding.d.ts

@@ -0,0 +1,5 @@
+import type { DisplayObject, RenderProxy2D, WgpuBitmapShader, WgpuRenderState } from '@flighthq/types';
+export declare function getWgpuShader(renderProxy: RenderProxy2D): WgpuBitmapShader | undefined;
+export declare function resolveWgpuShader(state: WgpuRenderState, renderProxy: RenderProxy2D): WgpuBitmapShader | null;
+export declare function setWgpuShader(state: WgpuRenderState, node: DisplayObject, shader: WgpuBitmapShader | null): void;
+//# sourceMappingURL=wgpuShaderBinding.d.ts.map

package/dist/wgpuShaderBinding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wgpuShaderBinding.d.ts","sourceRoot":"","sources":["../src/wgpuShaderBinding.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAMvG,wBAAgB,aAAa,CAAC,WAAW,EAAE,aAAa,GAAG,gBAAgB,GAAG,SAAS,CAEtF;AAID,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,GAAG,gBAAgB,GAAG,IAAI,CAQ7G;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAQhH"}

package/dist/wgpuShaderBinding.js

@@ -0,0 +1,28 @@
+import { getOrCreateRenderProxy2D } from '@flighthq/render';
+import { getWgpuRenderStateRuntime } from './wgpuRenderState';
+const _shaderBindings = new WeakMap();
+export function getWgpuShader(renderProxy) {
+    return _shaderBindings.get(renderProxy);
+}
+// Returns the per-node shader binding, or null when none is bound. The lookup is reached only
+// through the installed resolver, so it and the binding map tree-shake until setWgpuShader is used.
+export function resolveWgpuShader(state, renderProxy) {
+    const runtime = getWgpuRenderStateRuntime(state);
+    const resolver = runtime.webgpuShaderBindingResolver;
+    if (resolver !== undefined) {
+        const shader = resolver(renderProxy);
+        if (shader !== undefined)
+            return shader;
+    }
+    return null;
+}
+export function setWgpuShader(state, node, shader) {
+    const renderProxy = getOrCreateRenderProxy2D(state, node);
+    if (shader === null) {
+        _shaderBindings.delete(renderProxy);
+        return;
+    }
+    _shaderBindings.set(renderProxy, shader);
+    getWgpuRenderStateRuntime(state).webgpuShaderBindingResolver = getWgpuShader;
+}
+//# sourceMappingURL=wgpuShaderBinding.js.map

package/dist/wgpuShaderBinding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wgpuShaderBinding.js","sourceRoot":"","sources":["../src/wgpuShaderBinding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAG5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,MAAM,eAAe,GAAG,IAAI,OAAO,EAAmC,CAAC;AAEvE,MAAM,UAAU,aAAa,CAAC,WAA0B;IACtD,OAAO,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AAC1C,CAAC;AAED,8FAA8F;AAC9F,oGAAoG;AACpG,MAAM,UAAU,iBAAiB,CAAC,KAAsB,EAAE,WAA0B;IAClF,MAAM,OAAO,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,OAAO,CAAC,2BAA2B,CAAC;IACrD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC;IAC1C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAsB,EAAE,IAAmB,EAAE,MAA+B;IACxG,MAAM,WAAW,GAAG,wBAAwB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC1D,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,eAAe,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACpC,OAAO;IACT,CAAC;IACD,eAAe,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACzC,yBAAyB,CAAC,KAAK,CAAC,CAAC,2BAA2B,GAAG,aAAa,CAAC;AAC/E,CAAC"}

package/dist/wgpuShaderRegistry.d.ts

@@ -0,0 +1,3 @@
+import type { WgpuBitmapShader, WgpuRenderState } from '@flighthq/types';
+export declare function registerWgpuBitmapShader(state: WgpuRenderState, shader: WgpuBitmapShader): void;
+//# sourceMappingURL=wgpuShaderRegistry.d.ts.map

package/dist/wgpuShaderRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wgpuShaderRegistry.d.ts","sourceRoot":"","sources":["../src/wgpuShaderRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAOzE,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAE/F"}

package/dist/wgpuShaderRegistry.js

@@ -0,0 +1,8 @@
+import { getWgpuRenderStateRuntime } from './wgpuRenderState';
+// Registers a custom bitmap shader as the state-wide default, replacing the built-in quad shader.
+// Use this to globally swap the render pipeline (for example a custom color-transform or tint
+// shader) on a render state without per-node setWgpuShader bindings.
+export function registerWgpuBitmapShader(state, shader) {
+    getWgpuRenderStateRuntime(state).defaultBitmapShader = shader;
+}
+//# sourceMappingURL=wgpuShaderRegistry.js.map

package/dist/wgpuShaderRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wgpuShaderRegistry.js","sourceRoot":"","sources":["../src/wgpuShaderRegistry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,kGAAkG;AAClG,8FAA8F;AAC9F,qEAAqE;AACrE,MAAM,UAAU,wBAAwB,CAAC,KAAsB,EAAE,MAAwB;IACvF,yBAAyB,CAAC,KAAK,CAAC,CAAC,mBAAmB,GAAG,MAAM,CAAC;AAChE,CAAC"}

package/dist/wgpuSurface.d.ts

@@ -0,0 +1,6 @@
+import type { Surface, WgpuRenderState } from '@flighthq/types';
+export declare function acquireWgpuFrameCaptureTexture(state: Readonly<WgpuRenderState>): GPUTexture | null;
+export declare function createSurfaceFromWgpuRenderState(state: Readonly<WgpuRenderState>): Promise<Surface>;
+export declare function enableWgpuFrameCapture(state: Readonly<WgpuRenderState>): void;
+export declare function encodeWgpuFrameCapture(state: Readonly<WgpuRenderState>, encoder: GPUCommandEncoder): void;
+//# sourceMappingURL=wgpuSurface.d.ts.map

package/dist/wgpuSurface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wgpuSurface.d.ts","sourceRoot":"","sources":["../src/wgpuSurface.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAchE,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,UAAU,GAAG,IAAI,CAmBlG;AAOD,wBAAsB,gCAAgC,CAAC,KAAK,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CA0CzG;AAMD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,IAAI,CAE7E;AAKD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI,CA2BzG"}

package/dist/wgpuSurface.js

@@ -0,0 +1,107 @@
+import { createSurface } from '@flighthq/surface';
+import { getWgpuRenderStateRuntime } from './wgpuRenderState';
+// Opt-in capture of the rendered frame to a CPU Surface. Two environment facts drive the design:
+// (1) headless/software adapters never present the swapchain, and its texture reads back as zeros, so
+// the frame is redirected into an offscreen COPY_SRC texture (acquireWgpuFrameCaptureTexture, used by
+// renderWgpuBackground); (2) GPU work queued in a later task than the frame is dropped on these
+// adapters, so submitWgpuRenderPass copies the capture texture into the retained capture buffer in the
+// same frame (encodeWgpuFrameCapture), and createSurfaceFromWgpuRenderState only maps that buffer.
+// Returns the offscreen texture the frame should render into when capture is enabled, creating/resizing
+// it to the canvas on demand, or null when capture is off (the caller then renders to the swapchain).
+// Internal: called by renderWgpuBackground to redirect the frame so its pixels stay readable.
+export function acquireWgpuFrameCaptureTexture(state) {
+    const runtime = getWgpuRenderStateRuntime(state);
+    if (!runtime.frameCaptureEnabled)
+        return null;
+    const width = Math.max(1, state.canvas.width);
+    const height = Math.max(1, state.canvas.height);
+    const existing = runtime.frameCaptureTexture;
+    if (existing !== null && existing !== undefined && existing.width === width && existing.height === height) {
+        return existing;
+    }
+    existing?.destroy();
+    const texture = state.device.createTexture({
+        size: [width, height, 1],
+        format: state.format,
+        usage: GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_SRC,
+    });
+    runtime.frameCaptureTexture = texture;
+    return texture;
+}
+// Reads the most recently captured frame into a CPU Surface. Requires enableWgpuFrameCapture(state)
+// before rendering and at least one submitWgpuRenderPass since (which fills the capture buffer);
+// throws otherwise (calling it without enabling capture is API misuse). Only maps the retained buffer —
+// no GPU work is queued here, since later-task GPU work is unreliable on the adapters this exists for.
+// Allocates the returned Surface; the capture buffer is retained and reused across frames.
+export async function createSurfaceFromWgpuRenderState(state) {
+    const runtime = getWgpuRenderStateRuntime(state);
+    const buffer = runtime.frameCaptureBuffer;
+    if (buffer === null || buffer === undefined) {
+        throw new Error('createSurfaceFromWgpuRenderState requires enableWgpuFrameCapture(state) before rendering, then a submitWgpuRenderPass.');
+    }
+    const width = runtime.frameCaptureWidth;
+    const height = runtime.frameCaptureHeight;
+    const bytesPerRow = runtime.frameCaptureBytesPerRow;
+    await buffer.mapAsync(GPUMapMode.READ);
+    const mapped = new Uint8Array(buffer.getMappedRange());
+    const surface = createSurface(width, height);
+    const out = surface.data;
+    // The preferred canvas format is BGRA on most platforms and RGBA on software adapters; normalize to
+    // the Surface'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 = state.format === 'bgra8unorm' || state.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 surface;
+}
+// Enables opt-in frame capture on a render state so createSurfaceFromWgpuRenderState can read it back.
+// The frame is then drawn into an offscreen texture instead of the swapchain (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 enableWgpuFrameCapture(state) {
+    getWgpuRenderStateRuntime(state).frameCaptureEnabled = true;
+}
+// Encodes the capture-texture → capture-buffer copy into the frame's command encoder, sizing/reallocating
+// the retained buffer to the canvas on demand. No-op unless capture is enabled. Internal: called by
+// submitWgpuRenderPass so the copy is queued in the render frame, not a later (dropped) task.
+export function encodeWgpuFrameCapture(state, encoder) {
+    const runtime = getWgpuRenderStateRuntime(state);
+    const texture = runtime.frameCaptureTexture;
+    if (!runtime.frameCaptureEnabled || texture === null || texture === undefined)
+        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 (runtime.frameCaptureBuffer === null ||
+        runtime.frameCaptureBuffer === undefined ||
+        runtime.frameCaptureWidth !== width ||
+        runtime.frameCaptureHeight !== height) {
+        runtime.frameCaptureBuffer?.destroy();
+        runtime.frameCaptureBuffer = state.device.createBuffer({
+            size: bytesPerRow * height,
+            usage: GPUBufferUsage.COPY_DST | GPUBufferUsage.MAP_READ,
+        });
+        runtime.frameCaptureBytesPerRow = bytesPerRow;
+        runtime.frameCaptureWidth = width;
+        runtime.frameCaptureHeight = height;
+    }
+    encoder.copyTextureToBuffer({ texture }, { buffer: runtime.frameCaptureBuffer, bytesPerRow }, [width, height, 1]);
+}
+//# sourceMappingURL=wgpuSurface.js.map

package/dist/wgpuSurface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wgpuSurface.js","sourceRoot":"","sources":["../src/wgpuSurface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGlD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,iGAAiG;AACjG,sGAAsG;AACtG,sGAAsG;AACtG,gGAAgG;AAChG,uGAAuG;AACvG,mGAAmG;AAEnG,wGAAwG;AACxG,sGAAsG;AACtG,8FAA8F;AAC9F,MAAM,UAAU,8BAA8B,CAAC,KAAgC;IAC7E,MAAM,OAAO,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IACjD,IAAI,CAAC,OAAO,CAAC,mBAAmB;QAAE,OAAO,IAAI,CAAC;IAE9C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAC7C,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,KAAK,KAAK,KAAK,IAAI,QAAQ,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC1G,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC;QACzC,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QACxB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,eAAe,CAAC,iBAAiB,GAAG,eAAe,CAAC,eAAe,GAAG,eAAe,CAAC,QAAQ;KACtG,CAAC,CAAC;IACH,OAAO,CAAC,mBAAmB,GAAG,OAAO,CAAC;IACtC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,oGAAoG;AACpG,iGAAiG;AACjG,wGAAwG;AACxG,uGAAuG;AACvG,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,gCAAgC,CAAC,KAAgC;IACrF,MAAM,OAAO,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAC1C,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CACb,wHAAwH,CACzH,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,iBAAiB,CAAC;IACxC,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAC1C,MAAM,WAAW,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAEpD,MAAM,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;IAEvD,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IACzB,oGAAoG;IACpG,oGAAoG;IACpG,uGAAuG;IACvG,uGAAuG;IACvG,uGAAuG;IACvG,uGAAuG;IACvG,qEAAqE;IACrE,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,KAAK,YAAY,IAAI,KAAK,CAAC,MAAM,KAAK,iBAAiB,CAAC;IACxF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,CAAC,GAAG,WAAW,CAAC;QAC/B,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;QAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC;YACzB,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC;YACzB,GAAG,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACjD,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3B,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACrD,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,0FAA0F;IAC1F,MAAM,CAAC,KAAK,EAAE,CAAC;IACf,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,uGAAuG;AACvG,gGAAgG;AAChG,uGAAuG;AACvG,8FAA8F;AAC9F,MAAM,UAAU,sBAAsB,CAAC,KAAgC;IACrE,yBAAyB,CAAC,KAAK,CAAC,CAAC,mBAAmB,GAAG,IAAI,CAAC;AAC9D,CAAC;AAED,0GAA0G;AAC1G,oGAAoG;AACpG,8FAA8F;AAC9F,MAAM,UAAU,sBAAsB,CAAC,KAAgC,EAAE,OAA0B;IACjG,MAAM,OAAO,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAC5C,IAAI,CAAC,OAAO,CAAC,mBAAmB,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO;IAEtF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9B,+FAA+F;IAC/F,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;IAEvD,IACE,OAAO,CAAC,kBAAkB,KAAK,IAAI;QACnC,OAAO,CAAC,kBAAkB,KAAK,SAAS;QACxC,OAAO,CAAC,iBAAiB,KAAK,KAAK;QACnC,OAAO,CAAC,kBAAkB,KAAK,MAAM,EACrC,CAAC;QACD,OAAO,CAAC,kBAAkB,EAAE,OAAO,EAAE,CAAC;QACtC,OAAO,CAAC,kBAAkB,GAAG,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC;YACrD,IAAI,EAAE,WAAW,GAAG,MAAM;YAC1B,KAAK,EAAE,cAAc,CAAC,QAAQ,GAAG,cAAc,CAAC,QAAQ;SACzD,CAAC,CAAC;QACH,OAAO,CAAC,uBAAuB,GAAG,WAAW,CAAC;QAC9C,OAAO,CAAC,iBAAiB,GAAG,KAAK,CAAC;QAClC,OAAO,CAAC,kBAAkB,GAAG,MAAM,CAAC;IACtC,CAAC;IAED,OAAO,CAAC,mBAAmB,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,kBAAkB,EAAE,WAAW,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;AACpH,CAAC"}

package/dist/wgpuTestHelper.d.ts

@@ -0,0 +1,4 @@
+import type { WgpuRenderState } from '@flighthq/types';
+export declare function createWgpuRenderStateForTest(): Promise<WgpuRenderState>;
+export declare function installWgpuMock(): void;
+//# sourceMappingURL=wgpuTestHelper.d.ts.map

package/dist/wgpuTestHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wgpuTestHelper.d.ts","sourceRoot":"","sources":["../src/wgpuTestHelper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAwHvD,wBAAsB,4BAA4B,IAAI,OAAO,CAAC,eAAe,CAAC,CAK7E;AAED,wBAAgB,eAAe,IAAI,IAAI,CAiCtC"}