@nodetool-ai/gpu 0.8.1

package/dist/compositor/compositor.js

@@ -0,0 +1,353 @@
+/**
+ * WebGPULayerCompositor — the shared layer-compositing engine.
+ *
+ * Owns the blend + blit render pipelines, the ping-pong accumulation
+ * textures, and the sampler. Both the sketch editor and the timeline
+ * preview drive it: they upload their own source textures (canvas layers /
+ * video frames), seed the background into the read texture, then call
+ * {@link renderBlendPass} once per layer and {@link blit} to present.
+ *
+ * The engine is source-agnostic — it composites `GPUTexture`s addressed by a
+ * 2×3 inverse-affine matrix (screen px → layer texel). Sketch supplies
+ * `nearest` filtering (pixel-exact paint); the timeline supplies `linear`
+ * (smooth scaled video) plus an optional rounded-rect mask.
+ */
+import tgpu from "typegpu";
+import * as d from "typegpu/data";
+import { BLEND_COMPOSITE_FRAGMENT, BLIT_FRAGMENT, FULLSCREEN_QUAD_VERTEX } from "./shaders.js";
+/**
+ * Blend-pass uniform schema (4 × vec4f = 64 bytes). The single source of
+ * truth for both the WGSL `BlendUniforms` struct (see `shaders.ts`) and the
+ * host-side packed buffer. Field order mirrors the WGSL struct exactly.
+ */
+const BlendUniforms = d.struct({
+    params0: d.vec4f, // opacity, blendMode, canvasW, canvasH
+    invRow0: d.vec4f, // inverse-affine row 0: a, b, tx, _
+    invRow1: d.vec4f, // inverse-affine row 1: c, d, ty, _
+    invRow2: d.vec4f, // projective denominator row: p, q, r, _
+    params1: d.vec4f, // borderRadius, smoothness, filterMode, irisSoftness
+    params2: d.vec4f // wipeEdge (0 = off), wipeProgress, wipeSoftness, irisProgress (-1 = off)
+});
+/** Typed bind group layout for the blend pass. Binding order = WGSL order. */
+const blendLayout = tgpu.bindGroupLayout({
+    u: { uniform: BlendUniforms },
+    srcTexture: { texture: "float" },
+    dstTexture: { texture: "float" },
+    srcSampler: { sampler: "filtering" }
+});
+/** Typed bind group layout for the blit pass (single sampled texture). */
+const blitLayout = tgpu.bindGroupLayout({
+    blitTexture: { texture: "float" }
+});
+const IDENTITY_INVERSE_AFFINE = {
+    a: 1,
+    b: 0,
+    tx: 0,
+    c: 0,
+    d: 1,
+    ty: 0
+};
+/**
+ * Convert a column-major 4×4 clip-space placement matrix (mapping a quad
+ * with local coords in [-1,1]² to clip space, as produced by the timeline's
+ * `buildTransformMatrix`) into the inverse-affine matrix (screen px → layer
+ * texel) the compositor shader expects.
+ *
+ * The composed screen→texel map is affine, so it is reconstructed exactly by
+ * evaluating three points and differencing — no hand-derived trigonometry,
+ * which keeps placement faithful to the matrix the caller already trusts.
+ */
+export function forwardClipMatrixToInverseAffine(m, sourceWidth, sourceHeight, canvasWidth, canvasHeight) {
+    return (invertClipPlacement(m, sourceWidth, sourceHeight, canvasWidth, canvasHeight) ?? {
+        ...IDENTITY_INVERSE_AFFINE
+    });
+}
+/**
+ * {@link forwardClipMatrixToInverseAffine} without the identity fallback: null
+ * when the placement covers no area, such as a layer scaled to zero on either
+ * axis. A caller that draws layers must skip a null placement. The identity
+ * would draw the source 1:1 from the frame's top-left corner.
+ */
+export function invertClipPlacement(m, sourceWidth, sourceHeight, canvasWidth, canvasHeight) {
+    if (sourceWidth <= 0 ||
+        sourceHeight <= 0 ||
+        canvasWidth <= 0 ||
+        canvasHeight <= 0) {
+        return null;
+    }
+    if (m[3] !== 0 || m[7] !== 0 || m[15] !== 1) {
+        const a = (canvasWidth / 2) * (m[0] + m[3]);
+        const b = (canvasWidth / 2) * (m[4] + m[7]);
+        const c = (canvasWidth / 2) * (m[12] + m[15]);
+        const d = (canvasHeight / 2) * (m[3] - m[1]);
+        const e = (canvasHeight / 2) * (m[7] - m[5]);
+        const f = (canvasHeight / 2) * (m[15] - m[13]);
+        const g = m[3];
+        const h = m[7];
+        const i = m[15];
+        const det = a * (e * i - f * h) - b * (d * i - f * g) + c * (d * h - e * g);
+        if (Math.abs(det) < 1e-12)
+            return null;
+        const n00 = (e * i - f * h) / det;
+        const n01 = (c * h - b * i) / det;
+        const n02 = (b * f - c * e) / det;
+        const n10 = (f * g - d * i) / det;
+        const n11 = (a * i - c * g) / det;
+        const n12 = (c * d - a * f) / det;
+        const n20 = (d * h - e * g) / det;
+        const n21 = (b * g - a * h) / det;
+        const n22 = (a * e - b * d) / det;
+        return {
+            a: (sourceWidth / 2) * (n00 + n20),
+            b: (sourceWidth / 2) * (n01 + n21),
+            tx: (sourceWidth / 2) * (n02 + n22),
+            c: (sourceHeight / 2) * (n20 - n10),
+            d: (sourceHeight / 2) * (n21 - n11),
+            ty: (sourceHeight / 2) * (n22 - n12),
+            p: n20,
+            q: n21,
+            r: n22
+        };
+    }
+    // local → clip: clip = A·local + t (A is the xy 2×2 block, t the xy translation).
+    const a00 = m[0];
+    const a01 = m[4];
+    const a10 = m[1];
+    const a11 = m[5];
+    const tX = m[12];
+    const tY = m[13];
+    const det = a00 * a11 - a01 * a10;
+    if (Math.abs(det) < 1e-12) {
+        return null;
+    }
+    const inv00 = a11 / det;
+    const inv01 = -a01 / det;
+    const inv10 = -a10 / det;
+    const inv11 = a00 / det;
+    // screen px → layer texel, evaluated at one point.
+    const texelAt = (X, Y) => {
+        // screen px → clip
+        const clipX = (X * 2) / canvasWidth - 1;
+        const clipY = 1 - (Y * 2) / canvasHeight;
+        // clip → local (A⁻¹ · (clip - t))
+        const cx = clipX - tX;
+        const cy = clipY - tY;
+        const localX = inv00 * cx + inv01 * cy;
+        const localY = inv10 * cx + inv11 * cy;
+        // local [-1,1] → texel [0,dims]. V is flipped: the quad maps local.y = -1
+        // (clip-space bottom) to texture row 0 (top), matching the source UVs.
+        return {
+            x: ((localX + 1) * sourceWidth) / 2,
+            y: ((1 - localY) * sourceHeight) / 2
+        };
+    };
+    const p00 = texelAt(0, 0);
+    const p10 = texelAt(1, 0);
+    const p01 = texelAt(0, 1);
+    return {
+        a: p10.x - p00.x,
+        b: p01.x - p00.x,
+        tx: p00.x,
+        c: p10.y - p00.y,
+        d: p01.y - p00.y,
+        ty: p00.y
+    };
+}
+/** SDF antialias band (layer-local units) when a border radius is active. */
+const BORDER_RADIUS_SMOOTHNESS = 0.01;
+export class WebGPULayerCompositor {
+    device;
+    format;
+    root;
+    blendBindGroupLayout;
+    blendPipeline;
+    blitBindGroupLayout;
+    blitPipeline;
+    sampler;
+    filterMode;
+    pingPongA = null;
+    pingPongB = null;
+    widthPx = 0;
+    heightPx = 0;
+    // Per-frame uniform buffers, reused across frames. One distinct buffer per
+    // blend pass within a frame: every pass in a frame is encoded into the same
+    // submit, so they cannot share a buffer (a write would alias to the last
+    // value). `beginFrame` resets the ring index each frame.
+    uniformBuffers = [];
+    passIndex = 0;
+    constructor(device, format, filter = "nearest", label = "layer-compositor") {
+        this.device = device;
+        this.format = format;
+        this.filterMode = filter === "linear" ? 1 : 0;
+        this.root = tgpu.initFromDevice({ device });
+        this.sampler = device.createSampler({
+            label: `${label}-sampler`,
+            magFilter: filter,
+            minFilter: filter,
+            addressModeU: "clamp-to-edge",
+            addressModeV: "clamp-to-edge"
+        });
+        // TypeGPU owns the bind group layouts: `root.unwrap(layout)` returns the
+        // GPUBindGroupLayout the WGSL in shaders.ts is authored against, so the
+        // host and the shader can never drift apart.
+        this.blendBindGroupLayout = this.root.unwrap(blendLayout);
+        const blendModule = device.createShaderModule({
+            label: `${label}-blend-frag`,
+            code: FULLSCREEN_QUAD_VERTEX + BLEND_COMPOSITE_FRAGMENT
+        });
+        this.blendPipeline = device.createRenderPipeline({
+            label: `${label}-blend-pipeline`,
+            layout: device.createPipelineLayout({
+                bindGroupLayouts: [this.blendBindGroupLayout]
+            }),
+            vertex: { module: blendModule, entryPoint: "vs_main" },
+            fragment: {
+                module: blendModule,
+                entryPoint: "fs_blend",
+                targets: [{ format }]
+            },
+            primitive: { topology: "triangle-strip" }
+        });
+        this.blitBindGroupLayout = this.root.unwrap(blitLayout);
+        const blitModule = device.createShaderModule({
+            label: `${label}-blit-frag`,
+            code: FULLSCREEN_QUAD_VERTEX + BLIT_FRAGMENT
+        });
+        this.blitPipeline = device.createRenderPipeline({
+            label: `${label}-blit-pipeline`,
+            layout: device.createPipelineLayout({
+                bindGroupLayouts: [this.blitBindGroupLayout]
+            }),
+            vertex: { module: blitModule, entryPoint: "vs_main" },
+            fragment: {
+                module: blitModule,
+                entryPoint: "fs_blit",
+                targets: [{ format }]
+            },
+            primitive: { topology: "triangle-strip" }
+        });
+    }
+    get width() {
+        return this.widthPx;
+    }
+    get height() {
+        return this.heightPx;
+    }
+    /** The ping-pong accumulation textures. Seed the background into A. */
+    get textureA() {
+        return this.pingPongA;
+    }
+    get textureB() {
+        return this.pingPongB;
+    }
+    /** (Re)allocate the ping-pong textures when the canvas size changes. */
+    ensureSize(width, height) {
+        if (this.pingPongA && this.widthPx === width && this.heightPx === height) {
+            return;
+        }
+        const safeW = Math.max(1, width);
+        const safeH = Math.max(1, height);
+        const usage = GPUTextureUsage.RENDER_ATTACHMENT |
+            GPUTextureUsage.TEXTURE_BINDING |
+            GPUTextureUsage.COPY_SRC |
+            GPUTextureUsage.COPY_DST;
+        this.pingPongA?.destroy();
+        this.pingPongB?.destroy();
+        this.pingPongA = this.device.createTexture({
+            label: "layer-compositor-ping-A",
+            size: { width: safeW, height: safeH },
+            format: this.format,
+            usage
+        });
+        this.pingPongB = this.device.createTexture({
+            label: "layer-compositor-ping-B",
+            size: { width: safeW, height: safeH },
+            format: this.format,
+            usage
+        });
+        this.widthPx = width;
+        this.heightPx = height;
+    }
+    /**
+     * Reset the per-frame uniform-buffer ring. Call once before the frame's
+     * sequence of {@link renderBlendPass} calls.
+     */
+    beginFrame() {
+        this.passIndex = 0;
+    }
+    /**
+     * Composite one layer: reads `readTex` (current accumulation) and the
+     * layer source, writes the blended result to `writeTex` (full-screen).
+     */
+    renderBlendPass(encoder, readTex, writeTex, params) {
+        const { invAffine } = params;
+        const borderRadius = params.borderRadius ?? 0;
+        const smoothness = borderRadius > 0 ? BORDER_RADIUS_SMOOTHNESS : 0;
+        const idx = this.passIndex++;
+        let uniformBuffer = this.uniformBuffers[idx];
+        if (!uniformBuffer) {
+            uniformBuffer = this.root
+                .createBuffer(BlendUniforms)
+                .$usage("uniform")
+                .$name(`layer-compositor-uniform-${idx}`);
+            this.uniformBuffers[idx] = uniformBuffer;
+        }
+        const wipe = params.wipe;
+        uniformBuffer.write({
+            params0: d.vec4f(params.opacity, params.blendModeId, params.canvasW, params.canvasH),
+            invRow0: d.vec4f(invAffine.a, invAffine.b, invAffine.tx, 0),
+            invRow1: d.vec4f(invAffine.c, invAffine.d, invAffine.ty, 0),
+            invRow2: d.vec4f(invAffine.p ?? 0, invAffine.q ?? 0, invAffine.r ?? 1, 0),
+            params1: d.vec4f(borderRadius, smoothness, this.filterMode, params.iris?.softness ?? 0),
+            params2: wipe
+                ? d.vec4f(wipe.edge, wipe.progress, wipe.softness, params.iris?.progress ?? -1)
+                : d.vec4f(0, 0, 0, params.iris?.progress ?? -1)
+        });
+        const bindGroup = this.device.createBindGroup({
+            layout: this.blendBindGroupLayout,
+            entries: [
+                { binding: 0, resource: { buffer: uniformBuffer.buffer } },
+                { binding: 1, resource: params.source.createView() },
+                { binding: 2, resource: readTex.createView() },
+                { binding: 3, resource: this.sampler }
+            ]
+        });
+        const pass = encoder.beginRenderPass({
+            colorAttachments: [
+                { view: writeTex.createView(), loadOp: "clear", storeOp: "store" }
+            ]
+        });
+        pass.setPipeline(this.blendPipeline);
+        pass.setBindGroup(0, bindGroup);
+        pass.draw(4);
+        pass.end();
+    }
+    /** Present `srcTex` to a target view (swap chain or other attachment). */
+    blit(encoder, srcTex, targetView) {
+        const bindGroup = this.device.createBindGroup({
+            layout: this.blitBindGroupLayout,
+            entries: [{ binding: 0, resource: srcTex.createView() }]
+        });
+        const pass = encoder.beginRenderPass({
+            colorAttachments: [
+                { view: targetView, loadOp: "clear", storeOp: "store" }
+            ]
+        });
+        pass.setPipeline(this.blitPipeline);
+        pass.setBindGroup(0, bindGroup);
+        pass.draw(4);
+        pass.end();
+    }
+    dispose() {
+        this.pingPongA?.destroy();
+        this.pingPongB?.destroy();
+        this.pingPongA = null;
+        this.pingPongB = null;
+        // The uniform buffers were created through the root, so destroying the
+        // root frees them. The GPUDevice itself is caller-owned and survives
+        // (root was created via initFromDevice).
+        this.uniformBuffers = [];
+        this.root.destroy();
+    }
+}
+//# sourceMappingURL=compositor.js.map

package/dist/compositor/compositor.js.map

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

package/dist/compositor/headless.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Headless layer compositing — the host-agnostic "composite N layers, read
+ * back pixels" path used by server-side / Node.js callers.
+ *
+ * It drives the same {@link WebGPULayerCompositor} the sketch editor and the
+ * timeline preview use, so the blend math is identical across browser and
+ * Node. The only thing that differs is the boundary: instead of presenting to
+ * a canvas, this acquires the final accumulation texture and copies it back to
+ * a CPU buffer. Decode (bytes → RGBA) and encode (RGBA → PNG/JPEG) are the
+ * caller's job — they stay in the codec layer, not here.
+ *
+ * Layers are stacked at (0, 0) at their native size against a canvas of the
+ * given dimensions (identity screen→texel map). The shader bounds-checks each
+ * layer, so layers smaller than the canvas leave the surrounding pixels
+ * untouched, and layers larger than the canvas are cropped to the top-left —
+ * matching a `top: 0, left: 0` paste.
+ */
+import { type LayerTransform2D } from "./transform.js";
+/** One input layer: straight-alpha RGBA8 pixels plus per-layer state. */
+export interface HeadlessLayer {
+    /** Straight (non-premultiplied) RGBA8, row-major, length = width*height*4. */
+    rgba: Uint8Array;
+    width: number;
+    height: number;
+    /** Layer opacity in [0, 1]. */
+    opacity: number;
+    /** Canonical blend-mode gpuId (see blendModes.ts). */
+    blendModeId: number;
+    /**
+     * Placement on the canvas. Omitted → the layer's top-left sits at the canvas
+     * origin at native size (an untransformed top-left paste).
+     */
+    transform?: LayerTransform2D;
+}
+/** Composited output: straight-alpha RGBA8 at the requested canvas size. */
+export interface HeadlessCompositeResult {
+    rgba: Uint8Array;
+    width: number;
+    height: number;
+}
+/**
+ * Composite `layers` (bottom-first) onto a transparent canvas and read the
+ * result back to a CPU buffer. Pure WebGPU given a `device`; works against a
+ * browser, Electron, or Node.js Dawn device alike.
+ */
+export declare function compositeLayersHeadless(device: GPUDevice, layers: HeadlessLayer[], canvasWidth: number, canvasHeight: number): Promise<HeadlessCompositeResult>;
+//# sourceMappingURL=headless.d.ts.map

package/dist/compositor/headless.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless.d.ts","sourceRoot":"","sources":["../../src/compositor/headless.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AAExB,yEAAyE;AACzE,MAAM,WAAW,aAAa;IAC5B,8EAA8E;IAC9E,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,4EAA4E;AAC5E,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAKD;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,aAAa,EAAE,EACvB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,uBAAuB,CAAC,CA8JlC"}

package/dist/compositor/headless.js

@@ -0,0 +1,158 @@
+/**
+ * Headless layer compositing — the host-agnostic "composite N layers, read
+ * back pixels" path used by server-side / Node.js callers.
+ *
+ * It drives the same {@link WebGPULayerCompositor} the sketch editor and the
+ * timeline preview use, so the blend math is identical across browser and
+ * Node. The only thing that differs is the boundary: instead of presenting to
+ * a canvas, this acquires the final accumulation texture and copies it back to
+ * a CPU buffer. Decode (bytes → RGBA) and encode (RGBA → PNG/JPEG) are the
+ * caller's job — they stay in the codec layer, not here.
+ *
+ * Layers are stacked at (0, 0) at their native size against a canvas of the
+ * given dimensions (identity screen→texel map). The shader bounds-checks each
+ * layer, so layers smaller than the canvas leave the surrounding pixels
+ * untouched, and layers larger than the canvas are cropped to the top-left —
+ * matching a `top: 0, left: 0` paste.
+ */
+import { WebGPULayerCompositor } from "./compositor.js";
+import { FULLSCREEN_QUAD_VERTEX, UNPREMULTIPLY_FRAGMENT } from "./shaders.js";
+import { defaultLayerTransform, layerTransformToInverseAffine } from "./transform.js";
+/** `copyTextureToBuffer` requires a 256-byte-aligned `bytesPerRow`. */
+const ROW_ALIGNMENT = 256;
+/**
+ * Composite `layers` (bottom-first) onto a transparent canvas and read the
+ * result back to a CPU buffer. Pure WebGPU given a `device`; works against a
+ * browser, Electron, or Node.js Dawn device alike.
+ */
+export async function compositeLayersHeadless(device, layers, canvasWidth, canvasHeight) {
+    const width = Math.max(1, Math.floor(canvasWidth));
+    const height = Math.max(1, Math.floor(canvasHeight));
+    const format = "rgba8unorm";
+    const compositor = new WebGPULayerCompositor(device, format, "nearest");
+    compositor.ensureSize(width, height);
+    const texA = compositor.textureA;
+    const texB = compositor.textureB;
+    if (!texA || !texB) {
+        compositor.dispose();
+        throw new Error("Compositor failed to allocate accumulation textures");
+    }
+    const sources = [];
+    const encoder = device.createCommandEncoder({ label: "headless-composite" });
+    // Seed the read texture transparent so the first blend pass composites
+    // layer 0 over nothing.
+    const clear = encoder.beginRenderPass({
+        colorAttachments: [
+            {
+                view: texA.createView(),
+                loadOp: "clear",
+                clearValue: { r: 0, g: 0, b: 0, a: 0 },
+                storeOp: "store"
+            }
+        ]
+    });
+    clear.end();
+    compositor.beginFrame();
+    let read = texA;
+    let write = texB;
+    for (const layer of layers) {
+        const lw = Math.max(1, Math.floor(layer.width));
+        const lh = Math.max(1, Math.floor(layer.height));
+        const source = device.createTexture({
+            label: "headless-composite-layer",
+            size: { width: lw, height: lh },
+            format,
+            usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_DST
+        });
+        // Re-wrap as an ArrayBuffer-backed view: `writeTexture` rejects
+        // SharedArrayBuffer-backed sources under the DOM WebGPU typings.
+        // SAFETY: narrows `ArrayBufferLike` to `ArrayBuffer` for the typings only.
+        // The wrap is a view over the same bytes and `writeTexture` copies out of
+        // it identically whichever buffer kind actually backs `layer.rgba`, and
+        // the explicit byteOffset/byteLength below keep the view's bounds.
+        const data = new Uint8Array(layer.rgba.buffer, layer.rgba.byteOffset, layer.rgba.byteLength);
+        device.queue.writeTexture({ texture: source }, data, { bytesPerRow: lw * 4, rowsPerImage: lh }, { width: lw, height: lh });
+        sources.push(source);
+        const transform = layer.transform ?? defaultLayerTransform(lw, lh, width, height);
+        compositor.renderBlendPass(encoder, read, write, {
+            source,
+            opacity: layer.opacity,
+            blendModeId: layer.blendModeId,
+            canvasW: width,
+            canvasH: height,
+            invAffine: layerTransformToInverseAffine(transform, lw, lh)
+        });
+        // Swap: the texture we just wrote becomes the next pass's read.
+        const next = read;
+        read = write;
+        write = next;
+    }
+    // `read` now holds the final composite (premultiplied). Resolve it to
+    // straight alpha on the GPU instead of un-premultiplying per pixel on the
+    // CPU: a full-screen pass that divides RGB by alpha, into its own texture.
+    const final = read;
+    const resolved = device.createTexture({
+        label: "headless-composite-resolved",
+        size: { width, height },
+        format,
+        usage: GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.COPY_SRC
+    });
+    const resolveModule = device.createShaderModule({
+        label: "headless-composite-unpremultiply",
+        code: `${FULLSCREEN_QUAD_VERTEX}\n${UNPREMULTIPLY_FRAGMENT}`
+    });
+    const resolvePipeline = device.createRenderPipeline({
+        label: "headless-composite-unpremultiply",
+        layout: "auto",
+        vertex: { module: resolveModule, entryPoint: "vs_main" },
+        fragment: {
+            module: resolveModule,
+            entryPoint: "fs_unpremultiply",
+            targets: [{ format }]
+        },
+        primitive: { topology: "triangle-strip" }
+    });
+    const resolvePass = encoder.beginRenderPass({
+        colorAttachments: [
+            {
+                view: resolved.createView(),
+                loadOp: "clear",
+                clearValue: { r: 0, g: 0, b: 0, a: 0 },
+                storeOp: "store"
+            }
+        ]
+    });
+    resolvePass.setPipeline(resolvePipeline);
+    resolvePass.setBindGroup(0, device.createBindGroup({
+        layout: resolvePipeline.getBindGroupLayout(0),
+        entries: [{ binding: 0, resource: final.createView() }]
+    }));
+    resolvePass.draw(4);
+    resolvePass.end();
+    const bytesPerRow = Math.ceil((width * 4) / ROW_ALIGNMENT) * ROW_ALIGNMENT;
+    const readback = device.createBuffer({
+        label: "headless-composite-readback",
+        size: bytesPerRow * height,
+        usage: GPUBufferUsage.COPY_DST | GPUBufferUsage.MAP_READ
+    });
+    encoder.copyTextureToBuffer({ texture: resolved }, { buffer: readback, bytesPerRow, rowsPerImage: height }, { width, height });
+    device.queue.submit([encoder.finish()]);
+    await readback.mapAsync(GPUMapMode.READ);
+    const mapped = new Uint8Array(readback.getMappedRange());
+    // Pixels are already straight-alpha; just drop the 256-byte row padding
+    // `copyTextureToBuffer` requires (a per-row memcpy, no per-pixel math).
+    const rgba = new Uint8Array(width * height * 4);
+    const rowBytes = width * 4;
+    for (let row = 0; row < height; row++) {
+        rgba.set(mapped.subarray(row * bytesPerRow, row * bytesPerRow + rowBytes), row * rowBytes);
+    }
+    readback.unmap();
+    readback.destroy();
+    resolved.destroy();
+    for (const source of sources) {
+        source.destroy();
+    }
+    compositor.dispose();
+    return { rgba, width, height };
+}
+//# sourceMappingURL=headless.js.map

package/dist/compositor/headless.js.map

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

package/dist/compositor/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shared WebGPU layer-compositing engine. Browser/WebGPU-only.
+ */
+export * from "./compositor.js";
+export * from "./shaders.js";
+export * from "./headless.js";
+export * from "./transform.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/compositor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/compositor/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC"}

package/dist/compositor/index.js

@@ -0,0 +1,8 @@
+/**
+ * Shared WebGPU layer-compositing engine. Browser/WebGPU-only.
+ */
+export * from "./compositor.js";
+export * from "./shaders.js";
+export * from "./headless.js";
+export * from "./transform.js";
+//# sourceMappingURL=index.js.map

package/dist/compositor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/compositor/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC"}