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

package/dist/wgpuMaterialRegistry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"wgpuMaterialRegistry.js","sourceRoot":"","sources":["../src/wgpuMaterialRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEpG,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,MAAM,UAAU,uBAAuB,CAAC,KAAsB,EAAE,IAAU;IACxE,MAAM,KAAK,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,iBAAiB,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9F,OAAO,KAAK,EAAE,KAAK,KAAK,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,KAAsB,EAAE,IAAU,EAAE,QAA8B;IAC7G,MAAM,OAAO,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IACjD,OAAO,CAAC,UAAU,CAAC,iBAAiB,GAAG,sBAAsB,CAAC,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;AACtH,CAAC;AAED,mGAAmG;AACnG,sGAAsG;AACtG,+FAA+F;AAC/F,wFAAwF;AACxF,MAAM,UAAU,2BAA2B,CACzC,KAAsB,EACtB,QAAyB;IAEzB,MAAM,OAAO,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,OAAO,CAAC;IAC7D,MAAM,IAAI,GAAG,QAAQ,EAAE,IAAI,IAAI,oBAAoB,CAAC;IACpD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,KAAK,EAAE,KAAK,KAAK,kBAAkB,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC;IAElE,qGAAqG;IACrG,oGAAoG;IACpG,oFAAoF;IACpF,OAAO,CAAC,YAAY,EAAE,CAAC,cAAc,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;IAC9D,IAAI,IAAI,KAAK,oBAAoB;QAAE,OAAO,IAAI,CAAC;IAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACnD,OAAO,QAAQ,EAAE,KAAK,KAAK,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9E,CAAC"}

package/dist/wgpuPipeline.d.ts

@@ -1,6 +0,0 @@
-import type { WgpuPipeline, WgpuRenderRegistries, EntityConstruction } from '@flighthq/types/contract';
-export declare function createEmptyWgpuRegistries(): WgpuRenderRegistries;
-export declare function createWgpuPipeline(registries: Readonly<WgpuRenderRegistries>): WgpuPipeline;
-export declare function getWgpuPipelineRegistries(pipeline: Readonly<WgpuPipeline>): Readonly<WgpuRenderRegistries>;
-export declare function initializeEmptyWgpuRegistries(out: EntityConstruction<WgpuRenderRegistries>): void;
-//# sourceMappingURL=wgpuPipeline.d.ts.map

package/dist/wgpuPipeline.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"wgpuPipeline.d.ts","sourceRoot":"","sources":["../src/wgpuPipeline.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAGvG,wBAAgB,yBAAyB,IAAI,oBAAoB,CAIhE;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,YAAY,CAK3F;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,QAAQ,CAAC,oBAAoB,CAAC,CAE1G;AAED,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,kBAAkB,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAcjG"}

package/dist/wgpuPipeline.js

@@ -1,33 +0,0 @@
-import { allocateEntity, finishEntity } from '@flighthq/entity/contract';
-import { createKeyedTable, createSlotTable } from '@flighthq/registry/contract';
-import { EntityRuntimeKey } from '@flighthq/types/contract';
-export function createEmptyWgpuRegistries() {
-    const out = allocateEntity();
-    initializeEmptyWgpuRegistries(out);
-    return finishEntity(out);
-}
-export function createWgpuPipeline(registries) {
-    const pipeline = allocateEntity();
-    pipeline.registries = registries;
-    pipeline[EntityRuntimeKey] = { binding: null };
-    return pipeline;
-}
-export function getWgpuPipelineRegistries(pipeline) {
-    return pipeline.registries;
-}
-export function initializeEmptyWgpuRegistries(out) {
-    out.compressedTextureDecoder = createSlotTable('WgpuCompressedTextureDecoder', 'Unregistered');
-    out.compressedTextureUpload = createSlotTable('WgpuCompressedTextureUpload', 'Unregistered');
-    out.customMaterialShaders = createKeyedTable('WgpuCustomMaterialShader', 'Unregistered');
-    out.materialRenderers = createKeyedTable('WgpuMaterialRenderer', 'StandardMaterial');
-    out.meshMaterialRenderers = createKeyedTable('WgpuMeshMaterialRenderer', 'StandardMaterial');
-    out.modifierSnippets = createKeyedTable('WgpuModifierSnippet', 'Unregistered');
-    out.modifierSnippetRevision = 0;
-    out.renderEffects = createKeyedTable('WgpuRenderEffect', 'Unregistered');
-    out.renderers = createKeyedTable('NodeRenderer', 'Unregistered');
-    out.shapeRasterizer = createSlotTable('WgpuShapeRasterizer', 'Unregistered');
-    out.strokeTessellator = createSlotTable('StrokeTessellator', 'Rasterize');
-    out.textureResolvers = createKeyedTable('WgpuTextureResolver', 'Unregistered');
-    out.velocityWriters = createKeyedTable('WgpuVelocityWriter', 'Unregistered');
-}
-//# sourceMappingURL=wgpuPipeline.js.map

package/dist/wgpuPipeline.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"wgpuPipeline.js","sourceRoot":"","sources":["../src/wgpuPipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEhF,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,MAAM,UAAU,yBAAyB;IACvC,MAAM,GAAG,GAAG,cAAc,EAAwB,CAAC;IACnD,6BAA6B,CAAC,GAAG,CAAC,CAAC;IACnC,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,UAA0C;IAC3E,MAAM,QAAQ,GAAG,cAAc,EAAgB,CAAC;IAChD,QAAQ,CAAC,UAAU,GAAG,UAAU,CAAC;IACjC,QAAQ,CAAC,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC/C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,QAAgC;IACxE,OAAO,QAAQ,CAAC,UAAU,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,GAA6C;IACzF,GAAG,CAAC,wBAAwB,GAAG,eAAe,CAAC,8BAA8B,EAAE,cAAc,CAAC,CAAC;IAC/F,GAAG,CAAC,uBAAuB,GAAG,eAAe,CAAC,6BAA6B,EAAE,cAAc,CAAC,CAAC;IAC7F,GAAG,CAAC,qBAAqB,GAAG,gBAAgB,CAAC,0BAA0B,EAAE,cAAc,CAAC,CAAC;IACzF,GAAG,CAAC,iBAAiB,GAAG,gBAAgB,CAAC,sBAAsB,EAAE,kBAAkB,CAAC,CAAC;IACrF,GAAG,CAAC,qBAAqB,GAAG,gBAAgB,CAAC,0BAA0B,EAAE,kBAAkB,CAAC,CAAC;IAC7F,GAAG,CAAC,gBAAgB,GAAG,gBAAgB,CAAC,qBAAqB,EAAE,cAAc,CAAC,CAAC;IAC/E,GAAG,CAAC,uBAAuB,GAAG,CAAC,CAAC;IAChC,GAAG,CAAC,aAAa,GAAG,gBAAgB,CAAC,kBAAkB,EAAE,cAAc,CAAC,CAAC;IACzE,GAAG,CAAC,SAAS,GAAG,gBAAgB,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;IACjE,GAAG,CAAC,eAAe,GAAG,eAAe,CAAC,qBAAqB,EAAE,cAAc,CAAC,CAAC;IAC7E,GAAG,CAAC,iBAAiB,GAAG,eAAe,CAAC,mBAAmB,EAAE,WAAW,CAAC,CAAC;IAC1E,GAAG,CAAC,gBAAgB,GAAG,gBAAgB,CAAC,qBAAqB,EAAE,cAAc,CAAC,CAAC;IAC/E,GAAG,CAAC,eAAe,GAAG,gBAAgB,CAAC,oBAAoB,EAAE,cAAc,CAAC,CAAC;AAC/E,CAAC"}

package/dist/wgpuSurface.d.ts

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

package/dist/wgpuSurface.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"wgpuSurface.d.ts","sourceRoot":"","sources":["../src/wgpuSurface.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAmBpF,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,QAAQ,CAAC,2BAA2B,CAAC,GAAG,UAAU,GAAG,IAAI,CAmB9G;AAWD,wBAAsB,+BAA+B,CACnD,KAAK,EAAE,QAAQ,CAAC,2BAA2B,CAAC,EAC5C,SAAS,SAAyB,GACjC,OAAO,CAAC,MAAM,CAAC,CA0CjB;AAMD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,QAAQ,CAAC,2BAA2B,CAAC,GAAG,IAAI,CAEzF;AAKD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,QAAQ,CAAC,2BAA2B,CAAC,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAsCrH"}

package/dist/wgpuSurface.js

@@ -1,155 +0,0 @@
-import { createBitmap } from '@flighthq/bitmap/contract';
-import { getWgpuRenderStateRuntime } from './wgpuRenderState';
-// Opt-in capture of the rendered frame to a CPU Bitmap. 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 createBitmapFromWgpuRenderState only maps that 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.
-// 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.surface.width);
-    const height = Math.max(1, state.surface.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 Bitmap. 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 Bitmap; the capture buffer is retained and reused across frames.
-//
-// `timeoutMs` bounds the buffer map (pass 0 to wait indefinitely, the pre-bound behaviour). The default
-// is deliberately generous: a readback that takes seconds is a loaded machine, while one that never
-// settles is the failure this bounds, and only the caller knows which budget it is working inside.
-export async function createBitmapFromWgpuRenderState(state, timeoutMs = DEFAULT_MAP_TIMEOUT_MS) {
-    const runtime = getWgpuRenderStateRuntime(state);
-    const buffer = runtime.frameCaptureBuffer;
-    if (buffer === null || buffer === undefined) {
-        throw new Error('createBitmapFromWgpuRenderState requires enableWgpuFrameCapture(state) before rendering, then a submitWgpuRenderPass.');
-    }
-    const width = runtime.frameCaptureWidth;
-    const height = runtime.frameCaptureHeight;
-    const bytesPerRow = runtime.frameCaptureBytesPerRow;
-    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 = 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 bitmap;
-}
-// Enables opt-in frame capture on a render state so createBitmapFromWgpuRenderState 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;
-    // 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 = runtime.frameCaptureBuffer?.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 (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]);
-}
-// 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(GPUMapMode.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(`createBitmapFromWgpuRenderState: frame 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=wgpuSurface.js.map

package/dist/wgpuSurface.js.map

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

package/src/wgpuAntialias.test.ts

@@ -1,239 +0,0 @@
-import type { WgpuRenderTarget } from '@flighthq/types/contract';
-
-import {
-  acquireWgpuSurfaceAntialiasView,
-  clearWgpuSurfacePresentation,
-  encodeWgpuSurfaceAntialiasResolve,
-  getWgpuSurfaceLogicalExtent,
-  getWgpuSurfaceRenderExtent,
-  getWgpuSurfaceRenderScale,
-} from './wgpuAntialias';
-import { renderWgpuBackground, submitWgpuRenderPass } from './wgpuBackground';
-import { createEmptyWgpuRegistries, createWgpuPipeline } from './wgpuPipeline';
-import { createWgpuRenderStateFromCanvasElement, getWgpuRenderStateRuntime } from './wgpuRenderState';
-import { setWgpuRenderPassScissorRect } from './wgpuScissor';
-import { enableWgpuFrameCapture } from './wgpuSurface';
-import { createWgpuRenderStateForTest, installWgpuMock } from './wgpuTestHelper';
-
-beforeAll(() => {
-  installWgpuMock();
-});
-
-const _pipeline = createWgpuPipeline(createEmptyWgpuRegistries());
-
-describe('acquireWgpuSurfaceAntialiasView', () => {
-  it('returns and retains a 2x render view when the option is enabled', async () => {
-    const state = await createWgpuRenderStateForTest({ antialias: true });
-    const presentationView = state.context.getCurrentTexture().createView();
-
-    const view = acquireWgpuSurfaceAntialiasView(state, presentationView);
-
-    expect(view).toBe(getWgpuRenderStateRuntime(state).surfaceAntialiasView);
-    expect(getWgpuRenderStateRuntime(state).surfacePresentationView).toBe(presentationView);
-  });
-});
-
-describe('clearWgpuSurfacePresentation', () => {
-  it('drops the per-frame presentation view without destroying reusable resolve resources', async () => {
-    const state = await createWgpuRenderStateForTest({ antialias: true });
-    acquireWgpuSurfaceAntialiasView(state, state.context.getCurrentTexture().createView());
-    const runtime = getWgpuRenderStateRuntime(state);
-    const texture = runtime.surfaceAntialiasTexture;
-
-    clearWgpuSurfacePresentation(state);
-
-    expect(runtime.surfacePresentationView).toBeNull();
-    expect(runtime.surfaceAntialiasTexture).toBe(texture);
-  });
-});
-
-describe('encodeWgpuSurfaceAntialiasResolve', () => {
-  it('draws one fullscreen triangle into the retained presentation view', async () => {
-    const state = await createWgpuRenderStateForTest({ antialias: true });
-    acquireWgpuSurfaceAntialiasView(state, state.context.getCurrentTexture().createView());
-    const draw = vi.fn();
-    const beginRenderPass = vi.fn(() => ({
-      draw,
-      end: () => {},
-      setBindGroup: () => {},
-      setPipeline: () => {},
-    }));
-
-    encodeWgpuSurfaceAntialiasResolve(state, { beginRenderPass } as unknown as GPUCommandEncoder);
-
-    expect(beginRenderPass).toHaveBeenCalledOnce();
-    expect(draw).toHaveBeenCalledWith(3);
-  });
-});
-
-describe('getWgpuSurfaceLogicalExtent', () => {
-  it('keeps presentation coordinates logical while the render extent is supersampled', async () => {
-    const state = await createWgpuRenderStateForTest({ antialias: true });
-    acquireWgpuSurfaceAntialiasView(state, state.context.getCurrentTexture().createView());
-
-    expect(getWgpuSurfaceLogicalExtent(state)).toEqual({ height: 600, width: 800 });
-    expect(getWgpuSurfaceRenderExtent(state)).toEqual({ height: 1200, width: 1600 });
-  });
-});
-
-describe('getWgpuSurfaceRenderExtent', () => {
-  it('switches from the logical canvas extent to the acquired supersample extent', async () => {
-    const state = await createWgpuRenderStateForTest({ antialias: true });
-    expect(getWgpuSurfaceRenderExtent(state)).toEqual({ width: 800, height: 600 });
-
-    acquireWgpuSurfaceAntialiasView(state, state.context.getCurrentTexture().createView());
-
-    expect(getWgpuSurfaceRenderExtent(state)).toEqual({ width: 1600, height: 1200 });
-  });
-});
-
-describe('getWgpuSurfaceRenderScale', () => {
-  it('scales only the acquired main surface', async () => {
-    const state = await createWgpuRenderStateForTest({ antialias: true });
-    acquireWgpuSurfaceAntialiasView(state, state.context.getCurrentTexture().createView());
-    const runtime = getWgpuRenderStateRuntime(state);
-
-    expect(getWgpuSurfaceRenderScale(state)).toBe(2);
-    runtime.currentRenderTarget = {} as WgpuRenderTarget;
-    expect(getWgpuSurfaceRenderScale(state)).toBe(1);
-  });
-});
-
-describe('WgpuRenderOptions.antialias', () => {
-  it('leaves the direct presentation path and all resolve resources off by default', async () => {
-    const state = await createWgpuRenderStateForTest();
-    const runtime = getWgpuRenderStateRuntime(state);
-    const { encoder, setViewport } = installRecordingEncoder(state);
-
-    renderWgpuBackground(state);
-
-    expect(runtime.surfaceAntialiasEnabled).toBe(false);
-    expect(runtime.surfaceAntialiasTexture).toBeNull();
-    expect(runtime.surfaceAntialiasResolvePipeline).toBeNull();
-    expect(runtime.surfacePresentationView).toBeNull();
-    expect(setViewport).toHaveBeenCalledWith(0, 0, 800, 600, 0, 1);
-    expect(encoder.beginRenderPass).toHaveBeenCalledTimes(1);
-  });
-
-  it('renders the main pass into a 2x surface while preserving logical canvas coordinates', async () => {
-    const state = await createWgpuRenderStateForTest({ antialias: true });
-    const runtime = getWgpuRenderStateRuntime(state);
-    const { setViewport } = installRecordingEncoder(state);
-
-    renderWgpuBackground(state);
-
-    expect(runtime.surfaceAntialiasTexture?.width).toBe(1600);
-    expect(runtime.surfaceAntialiasTexture?.height).toBe(1200);
-    expect(runtime.depthStencilWidth).toBe(1600);
-    expect(runtime.depthStencilHeight).toBe(1200);
-    expect(runtime.renderTargetViewport).toBeNull();
-    expect(runtime.surfacePresentationView).not.toBeNull();
-    expect(setViewport).toHaveBeenCalledWith(0, 0, 1600, 1200, 0, 1);
-  });
-
-  it('encodes one fullscreen resolve before frame-capture readback', async () => {
-    const state = await createWgpuRenderStateForTest({ antialias: true });
-    const events: string[] = [];
-    let passIndex = 0;
-    const encoder = {
-      beginRenderPass: vi.fn(() => {
-        const name = passIndex++ === 0 ? 'main' : 'resolve';
-        events.push(`${name}:begin`);
-        return {
-          draw: (vertices: number) => events.push(`${name}:draw:${vertices}`),
-          end: () => events.push(`${name}:end`),
-          setBindGroup: () => {},
-          setPipeline: () => {},
-          setScissorRect: () => {},
-          setStencilReference: () => {},
-          setViewport: () => {},
-        } as unknown as GPURenderPassEncoder;
-      }),
-      copyTextureToBuffer: () => events.push('capture:copy'),
-      finish: () => {
-        events.push('encoder:finish');
-        return {} as GPUCommandBuffer;
-      },
-    } as unknown as GPUCommandEncoder;
-    vi.spyOn(state.device, 'createCommandEncoder').mockReturnValue(encoder);
-    enableWgpuFrameCapture(state);
-
-    renderWgpuBackground(state);
-    submitWgpuRenderPass(state);
-
-    expect(events).toEqual([
-      'main:begin',
-      'main:end',
-      'resolve:begin',
-      'resolve:draw:3',
-      'resolve:end',
-      'capture:copy',
-      'encoder:finish',
-    ]);
-    expect(getWgpuRenderStateRuntime(state).surfacePresentationView).toBeNull();
-  });
-
-  // C1b: the size is LIVE. The state's `surface` is readonly to the consumer, so the resize happens on the
-  // PROVIDER — the canvas — and the state must observe the new value. A provider that snapshotted its size
-  // at acquisition would leave this reading 800x600 forever and still pass every test that never resizes.
-  it('reallocates the supersample surface when the canvas size changes', async () => {
-    const canvas = document.createElement('canvas');
-    canvas.width = 800;
-    canvas.height = 600;
-    const state = await createWgpuRenderStateFromCanvasElement(canvas, _pipeline, { antialias: true });
-    renderWgpuBackground(state);
-    const runtime = getWgpuRenderStateRuntime(state);
-    const first = runtime.surfaceAntialiasTexture!;
-    const destroy = vi.spyOn(first, 'destroy');
-    submitWgpuRenderPass(state);
-
-    canvas.width = 400;
-    canvas.height = 300;
-    expect(state.surface.width).toBe(400);
-    expect(state.surface.height).toBe(300);
-    renderWgpuBackground(state);
-
-    expect(destroy).toHaveBeenCalledOnce();
-    expect(runtime.surfaceAntialiasTexture).not.toBe(first);
-    expect(runtime.surfaceAntialiasTexture?.width).toBe(800);
-    expect(runtime.surfaceAntialiasTexture?.height).toBe(600);
-  });
-
-  it('scales main-surface scissors but leaves offscreen-target scissors unchanged', async () => {
-    const state = await createWgpuRenderStateForTest({ antialias: true });
-    renderWgpuBackground(state);
-    const runtime = getWgpuRenderStateRuntime(state);
-    const setScissorRect = vi.fn();
-    const pass = { setScissorRect } as unknown as GPURenderPassEncoder;
-
-    setWgpuRenderPassScissorRect(state, pass, 3, 5, 7, 11);
-    expect(setScissorRect).toHaveBeenLastCalledWith(6, 10, 14, 22);
-
-    runtime.currentRenderTarget = {} as WgpuRenderTarget;
-    setWgpuRenderPassScissorRect(state, pass, 3, 5, 7, 11);
-    expect(setScissorRect).toHaveBeenLastCalledWith(3, 5, 7, 11);
-  });
-});
-
-function installRecordingEncoder(state: { device: GPUDevice }): {
-  encoder: GPUCommandEncoder & { beginRenderPass: ReturnType<typeof vi.fn> };
-  setViewport: ReturnType<typeof vi.fn>;
-} {
-  const setViewport = vi.fn();
-  const pass = {
-    draw: () => {},
-    end: () => {},
-    setBindGroup: () => {},
-    setPipeline: () => {},
-    setScissorRect: () => {},
-    setStencilReference: () => {},
-    setViewport,
-  } as unknown as GPURenderPassEncoder;
-  const beginRenderPass = vi.fn(() => pass);
-  const encoder = {
-    beginRenderPass,
-    finish: () => ({}) as GPUCommandBuffer,
-  } as unknown as GPUCommandEncoder & { beginRenderPass: ReturnType<typeof vi.fn> };
-  vi.spyOn(state.device, 'createCommandEncoder').mockReturnValue(encoder);
-  return { encoder, setViewport };
-}

package/src/wgpuElement.test.ts

@@ -1,145 +0,0 @@
-import {
-  createWgpuCanvasElement,
-  createWgpuRenderSurface,
-  getWgpuRenderSurfaceProvider,
-  resetWgpuRenderSurfaceProviderForTest,
-  setWgpuRenderSurfaceProvider,
-} from './wgpuElement';
-
-function entityProvider(fields: Omit<WgpuRenderSurfaceProvider, keyof Entity>): WgpuRenderSurfaceProvider {
-  return (() => {
-    const out = allocateEntity<any>();
-    Object.assign(out, fields);
-    return finishEntity(out);
-  })();
-}
-
-describe('createWgpuCanvasElement', () => {
-  afterEach(() => resetWgpuRenderSurfaceProviderForTest());
-
-  it('preserves the canonical provider result identity', () => {
-    const surface = {} as HTMLCanvasElement;
-    setWgpuRenderSurfaceProvider(entityProvider({ createRenderSurface: () => surface }));
-    expect(createWgpuCanvasElement(100, 200, 2)).toBe(surface);
-  });
-
-  it('throws an actionable Web-only setup error when the provider is absent', () => {
-    expect(() => createWgpuCanvasElement(100, 200)).toThrowError(
-      /enableHostWebWgpuRenderSurface\(\).*inject a WgpuRenderSurfaceProvider/,
-    );
-  });
-
-  it('throws the same setup error when the provider refuses', () => {
-    setWgpuRenderSurfaceProvider(entityProvider({ createRenderSurface: () => null }));
-    expect(() => createWgpuCanvasElement(100, 200)).toThrowError(/enableHostWebWgpuRenderSurface\(\)/);
-  });
-});
-
-describe('createWgpuRenderSurface', () => {
-  afterEach(() => resetWgpuRenderSurfaceProviderForTest());
-
-  it('returns null when no provider is selected', () => {
-    expect(createWgpuRenderSurface(100, 200)).toBeNull();
-  });
-
-  it('passes exact dimensions and the default pixel ratio to the selected provider', () => {
-    const surface = {} as HTMLCanvasElement;
-    const createRenderSurface = vi.fn(() => surface);
-    setWgpuRenderSurfaceProvider(entityProvider({ createRenderSurface }));
-    expect(createWgpuRenderSurface(100, 200)).toBe(surface);
-    expect(createRenderSurface).toHaveBeenCalledOnce();
-    expect(createRenderSurface).toHaveBeenCalledWith(100, 200, 1);
-  });
-
-  it('passes an explicit pixel ratio and preserves the provider result identity', () => {
-    const surface = {} as HTMLCanvasElement;
-    const createRenderSurface = vi.fn(() => surface);
-    setWgpuRenderSurfaceProvider(entityProvider({ createRenderSurface }));
-    expect(createWgpuRenderSurface(300, 150, 2.5)).toBe(surface);
-    expect(createRenderSurface).toHaveBeenCalledWith(300, 150, 2.5);
-  });
-
-  it('selects replacements and reset restores omission', () => {
-    const first = {} as HTMLCanvasElement;
-    const second = {} as HTMLCanvasElement;
-    const firstProvider = entityProvider({ createRenderSurface: vi.fn(() => first) });
-    const secondProvider = entityProvider({ createRenderSurface: vi.fn(() => second) });
-    setWgpuRenderSurfaceProvider(firstProvider);
-    expect(getWgpuRenderSurfaceProvider()).toBe(firstProvider);
-    expect(createWgpuRenderSurface(1, 2)).toBe(first);
-    setWgpuRenderSurfaceProvider(secondProvider);
-    expect(getWgpuRenderSurfaceProvider()).toBe(secondProvider);
-    expect(createWgpuRenderSurface(3, 4)).toBe(second);
-    resetWgpuRenderSurfaceProviderForTest();
-    expect(getWgpuRenderSurfaceProvider()).toBeNull();
-    expect(createWgpuRenderSurface(5, 6)).toBeNull();
-  });
-
-  it('preserves provider refusal as null', () => {
-    setWgpuRenderSurfaceProvider(entityProvider({ createRenderSurface: () => null }));
-    expect(createWgpuRenderSurface(100, 200)).toBeNull();
-  });
-
-  it('lets a native host provide a surface without reading document', () => {
-    const surface = {} as HTMLCanvasElement;
-    setWgpuRenderSurfaceProvider(entityProvider({ createRenderSurface: () => surface }));
-    withThrowingDocument(() => expect(createWgpuRenderSurface(100, 200)).toBe(surface));
-  });
-
-  it('returns null for omission and refusal without reading document', () => {
-    withThrowingDocument(() => {
-      expect(createWgpuRenderSurface(100, 200)).toBeNull();
-      setWgpuRenderSurfaceProvider(entityProvider({ createRenderSurface: () => null }));
-      expect(createWgpuRenderSurface(100, 200)).toBeNull();
-    });
-  });
-});
-
-describe('getWgpuRenderSurfaceProvider', () => {
-  afterEach(() => resetWgpuRenderSurfaceProviderForTest());
-
-  it('returns the exact selected provider', () => {
-    const provider = entityProvider({ createRenderSurface: () => ({}) as HTMLCanvasElement });
-    setWgpuRenderSurfaceProvider(provider);
-    expect(getWgpuRenderSurfaceProvider()).toBe(provider);
-  });
-});
-
-describe('resetWgpuRenderSurfaceProviderForTest', () => {
-  it('restores provider omission', () => {
-    setWgpuRenderSurfaceProvider(entityProvider({ createRenderSurface: () => ({}) as HTMLCanvasElement }));
-    resetWgpuRenderSurfaceProviderForTest();
-    expect(getWgpuRenderSurfaceProvider()).toBeNull();
-    expect(createWgpuRenderSurface(1, 1)).toBeNull();
-  });
-});
-
-describe('setWgpuRenderSurfaceProvider', () => {
-  afterEach(() => resetWgpuRenderSurfaceProviderForTest());
-
-  it('replaces the selected provider', () => {
-    const first = entityProvider({ createRenderSurface: () => ({}) as HTMLCanvasElement });
-    const second = entityProvider({ createRenderSurface: () => ({}) as HTMLCanvasElement });
-    setWgpuRenderSurfaceProvider(first);
-    setWgpuRenderSurfaceProvider(second);
-    expect(getWgpuRenderSurfaceProvider()).toBe(second);
-  });
-});
-
-function withThrowingDocument(run: () => void): void {
-  const descriptor = Object.getOwnPropertyDescriptor(globalThis, 'document');
-  Object.defineProperty(globalThis, 'document', {
-    configurable: true,
-    get(): never {
-      throw new Error('portable WGPU code read document');
-    },
-  });
-  try {
-    run();
-  } finally {
-    if (descriptor === undefined) delete (globalThis as { document?: Document }).document;
-    else Object.defineProperty(globalThis, 'document', descriptor);
-  }
-}
-import { allocateEntity, finishEntity } from '@flighthq/entity/contract';
-import type { Entity, WgpuRenderSurfaceProvider } from '@flighthq/types/contract';