@flighthq/render-wgpu 0.5.1-next.1069.554a2ac → 0.5.1-next.1201.9b49dee

package/dist/wgpuHost.d.ts

@@ -1,8 +1,8 @@
-import type { EntityConstruction, WgpuHostBackend } from '@flighthq/types/contract';
-export declare function createWebWgpuHostBackend(): WgpuHostBackend;
-export declare function getWgpuHostBackend(): WgpuHostBackend;
-export declare function initializeWebWgpuHostBackend(out: EntityConstruction<WgpuHostBackend>): void;
-export declare function installWgpuHostBackend(backend: WgpuHostBackend): void;
+import type { EntityConstruction, HostWgpuProvider } from '@flighthq/types/contract';
+export declare function createWebWgpuHostBackend(): HostWgpuProvider;
+export declare function getWgpuHostBackend(): HostWgpuProvider;
+export declare function initializeWebWgpuHostBackend(out: EntityConstruction<HostWgpuProvider>): void;
+export declare function installWgpuHostBackend(backend: HostWgpuProvider): void;
 export declare function resetWgpuHostBackendForTest(): void;
-export declare function setWgpuHostBackend(backend: WgpuHostBackend | null): void;
+export declare function setWgpuHostBackend(backend: HostWgpuProvider | null): void;
 //# sourceMappingURL=wgpuHost.d.ts.map

package/dist/wgpuHost.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wgpuHost.d.ts","sourceRoot":"","sources":["../src/wgpuHost.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAuB,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAIzG,wBAAgB,wBAAwB,IAAI,eAAe,CAI1D;AAED,wBAAgB,kBAAkB,IAAI,eAAe,CAEpD;AAED,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,kBAAkB,CAAC,eAAe,CAAC,GAAG,IAAI,CA+C3F;AAGD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAErE;AAED,wBAAgB,2BAA2B,IAAI,IAAI,CAGlD;AAID,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI,CAExE"}
+{"version":3,"file":"wgpuHost.d.ts","sourceRoot":"","sources":["../src/wgpuHost.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAuB,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAI1G,wBAAgB,wBAAwB,IAAI,gBAAgB,CAI3D;AAED,wBAAgB,kBAAkB,IAAI,gBAAgB,CAErD;AAED,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,kBAAkB,CAAC,gBAAgB,CAAC,GAAG,IAAI,CA4D5F;AAGD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAEtE;AAED,wBAAgB,2BAA2B,IAAI,IAAI,CAGlD;AAID,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAEzE"}

package/dist/wgpuHost.js

@@ -10,7 +10,7 @@ export function getWgpuHostBackend() {
     return _custom ?? _host ?? _web;
 }
 export function initializeWebWgpuHostBackend(out) {
-    out.acquire = async (canvas, options) => {
+    out.acquire = async (surface, options) => {
         const gpu = getWebWgpu();
         if (gpu === null)
             throw new Error('WebGPU is not supported in this browser.');
@@ -33,7 +33,7 @@ export function initializeWebWgpuHostBackend(out) {
         const device = await adapter.requestDevice(descriptor);
         try {
             const format = options.format ?? gpu.getPreferredCanvasFormat();
-            const context = canvas.getContext('webgpu');
+            const context = surface.getContext('webgpu');
             if (context === null)
                 throw new Error('Failed to get WebGPU canvas context.');
             const acquisition = allocateEntity();
@@ -41,7 +41,7 @@ export function initializeWebWgpuHostBackend(out) {
             acquisition.device = device;
             acquisition.format = format;
             acquisition.ownership = 'flight';
-            acquisition.surface = canvas;
+            acquisition.surface = surface;
             return finishEntity(acquisition);
         }
         catch (error) {
@@ -49,6 +49,20 @@ export function initializeWebWgpuHostBackend(out) {
             throw error;
         }
     };
+    out.attachSurface = (surface, attachment) => {
+        const context = surface.getContext('webgpu');
+        if (context === null)
+            return null;
+        // COPY_SRC lets the swap-chain texture be read back with copyTextureToBuffer. It is the only reliable
+        // way to read a Wgpu frame in headless/software contexts, and it also backs user-facing screenshots.
+        context.configure({
+            device: attachment.device,
+            format: attachment.format,
+            alphaMode: attachment.alphaMode,
+            usage: GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.COPY_SRC,
+        });
+        return context;
+    };
     out.isSupported = () => {
         return getWebWgpu() !== null;
     };

package/dist/wgpuHost.js.map

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

package/dist/wgpuRenderPass.d.ts

@@ -0,0 +1,9 @@
+import type { Matrix, RenderTargetClear, WgpuRenderPass, WgpuRenderPassViewport, WgpuRenderState, WgpuRenderTarget } from '@flighthq/types/contract';
+export declare function beginWgpuRenderPass(state: WgpuRenderState, target: WgpuRenderTarget, clear?: Readonly<RenderTargetClear>): WgpuRenderPass;
+export declare function endWgpuRenderPass(pass: WgpuRenderPass): void;
+export declare function getWgpuActiveRenderPass(state: WgpuRenderState): WgpuRenderPass | null;
+export declare function getWgpuRenderPassViewport(state: WgpuRenderState): Readonly<WgpuRenderPassViewport>;
+export declare function resumeWgpuRenderPass(pass: WgpuRenderPass): void;
+export declare function setWgpuRenderTransform2D(pass: WgpuRenderPass, transform: Readonly<Matrix>): void;
+export declare function suspendWgpuRenderPass(pass: WgpuRenderPass): void;
+//# sourceMappingURL=wgpuRenderPass.d.ts.map

package/dist/wgpuRenderPass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wgpuRenderPass.d.ts","sourceRoot":"","sources":["../src/wgpuRenderPass.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,MAAM,EACN,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,eAAe,EACf,gBAAgB,EAIjB,MAAM,0BAA0B,CAAC;AAwBlC,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,gBAAgB,EACxB,KAAK,CAAC,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GAClC,cAAc,CAgDhB;AAOD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CA+B5D;AAKD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,eAAe,GAAG,cAAc,GAAG,IAAI,CAErF;AAMD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,eAAe,GAAG,QAAQ,CAAC,sBAAsB,CAAC,CAIlG;AAID,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAK/D;AAMD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,CAIhG;AAID,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAKhE"}

package/dist/wgpuRenderPass.js

@@ -0,0 +1,222 @@
+import { allocateEntity, finishEntity } from '@flighthq/entity/contract';
+import { copyMatrix, createMatrix } from '@flighthq/geometry/contract';
+import { beginWgpuFrame, submitWgpuFrame } from './wgpuFrame';
+import { getWgpuRenderStateRuntime } from './wgpuRenderState';
+import { getWgpuRenderTargetSupersampleScale } from './wgpuRenderTarget';
+import { bindWgpuScreenRenderTarget, isWgpuScreenRenderTarget } from './wgpuScreenRenderTarget';
+// Opens a render pass into `target` and returns the handle to draw through. Aspects named in `clear` are
+// overwritten with the given values; omitted aspects are preserved (loadOp 'load'). Color values are
+// linear float RGBA, in the space the target holds.
+//
+// The pass — not the state — is what a draw entry point takes, because "which target is being drawn
+// into" is a property of the pass and of nothing else:
+//
+//   const pass = beginWgpuRenderPass(state, screen, { color: [0.1, 0.1, 0.18, 1.0], depth: 1.0 });
+//   renderWgpuScene2D(pass, root);
+//   endWgpuRenderPass(pass);
+//
+// Passes nest across targets: an offscreen pass opened inside a screen pass suspends it, and ending the
+// inner one resumes the outer with loadOp 'load'. A pass carries no 2D transform — a 2D pass that needs a
+// specific root device transform calls setWgpuRenderTransform2D after begin, and the bracket restores it.
+//
+// The handle is pooled: begin claims one, end returns it. Using a handle after its end is a bug, the same
+// contract as every other acquire/release bracket.
+export function beginWgpuRenderPass(state, target, clear) {
+    const runtime = getWgpuRenderStateRuntime(state);
+    // A WebGPU pass encoder cannot be suspended, only ended; the enclosing pass is re-recorded from its
+    // saved attachments when this one ends. The live encoder is read from the runtime rather than from the
+    // enclosing handle, because a frame borrower shares the owner's encoder before it shares its stack.
+    if (runtime.renderPass !== null) {
+        runtime.renderPass.end();
+        runtime.renderPass = null;
+    }
+    const enclosing = runtime.passStack.at(-1);
+    if (enclosing !== undefined)
+        enclosing.encoder = null;
+    const ownsFrame = runtime.commandEncoder === null;
+    beginWgpuFrame(state);
+    const saved = {
+        clipForms: runtime.clipForms,
+        colorFormat: runtime.currentColorFormat,
+        currentMaskDepth: runtime.currentMaskDepth,
+        currentScissorRect: runtime.currentScissorRect,
+        maskWriteMode: runtime.maskWriteMode,
+        renderTarget: runtime.currentRenderTarget,
+        renderTargetViewport: runtime.renderTargetViewport,
+        renderTransform2D: state.renderTransform2D,
+        scissorStack: runtime.scissorStack,
+    };
+    const colorView = bindWgpuRenderPassTarget(state, target);
+    const pass = acquireWgpuRenderPassHandle(state, target, colorView, saved, ownsFrame);
+    const scale = getWgpuRenderTargetSupersampleScale(target);
+    pass.viewport = { height: target.height / scale, width: target.width / scale };
+    runtime.passStack.push(pass);
+    runtime.currentRenderTarget = target;
+    runtime.currentColorFormat = target.format;
+    runtime.renderTargetViewport = pass.viewport;
+    // A pass owns its logical clip unwind state. Inheriting the enclosing entries would let a nested pass
+    // pop clips it never pushed, desynchronizing the logical and hardware stacks once the outer resumes.
+    runtime.clipForms = [];
+    runtime.currentMaskDepth = 0;
+    runtime.maskWriteMode = false;
+    runtime.currentScissorRect = null;
+    runtime.scissorStack = [];
+    pass.encoder = recordWgpuRenderPassEncoder(state, target, colorView, clear);
+    runtime.renderPass = pass.encoder;
+    return pass;
+}
+// Ends the pass: closes its encoder, restores the enclosing pass state, and resumes the enclosing pass
+// (re-recorded with loadOp 'load') if there is one. When this pass opened the frame, its end also submits
+// it — a caller that opened the frame itself with beginWgpuFrame submits it itself, which is how a
+// multi-pass recipe still costs one submit. Ending a pass twice, or out of order, throws: an unbalanced
+// bracket is a programmer error, and accepting it silently hides a leaked pass.
+export function endWgpuRenderPass(pass) {
+    const state = pass.state;
+    const runtime = getWgpuRenderStateRuntime(state);
+    if (runtime.passStack.at(-1) !== pass) {
+        throw new Error('endWgpuRenderPass: this pass is not the innermost open pass');
+    }
+    runtime.passStack.pop();
+    if (pass.encoder !== null) {
+        pass.encoder.end();
+        pass.encoder = null;
+    }
+    runtime.renderPass = null;
+    const saved = pass.saved;
+    runtime.currentRenderTarget = saved.renderTarget;
+    runtime.currentColorFormat = saved.colorFormat;
+    runtime.renderTargetViewport = saved.renderTargetViewport;
+    runtime.clipForms = saved.clipForms;
+    runtime.currentMaskDepth = saved.currentMaskDepth;
+    runtime.maskWriteMode = saved.maskWriteMode;
+    runtime.currentScissorRect = saved.currentScissorRect;
+    runtime.scissorStack = saved.scissorStack;
+    state.renderTransform2D = saved.renderTransform2D;
+    const enclosing = runtime.passStack.at(-1);
+    if (enclosing !== undefined)
+        resumeWgpuRenderPass(enclosing);
+    const ownsFrame = pass.ownsFrame;
+    releaseWgpuRenderPassHandle(pass);
+    if (ownsFrame)
+        submitWgpuFrame(state);
+}
+// The pass a draw entered through, when a caller holds the state rather than the handle: a registered
+// renderer is dispatched with the state, and the active pass is what tells it where its draw lands.
+// Null outside any pass.
+export function getWgpuActiveRenderPass(state) {
+    return getWgpuRenderStateRuntime(state).passStack.at(-1) ?? null;
+}
+// The logical extent of the innermost open pass — the space 2D transforms, projections, and scissor
+// rectangles are expressed in, whether the pass is supersampled or not. Throws outside a pass: a draw
+// with no target bound is API misuse, and inventing a canvas-sized default hides it until the picture
+// comes out the wrong size.
+export function getWgpuRenderPassViewport(state) {
+    const viewport = getWgpuRenderStateRuntime(state).renderTargetViewport;
+    if (viewport === null)
+        throw new Error('No Wgpu render pass is open — call beginWgpuRenderPass first');
+    return viewport;
+}
+// Re-records the pass's GPU encoder over the same attachments with loadOp 'load', after a suspend or an
+// inner pass. Pixels already drawn are preserved; a suspended pass is resumed exactly once.
+export function resumeWgpuRenderPass(pass) {
+    const runtime = getWgpuRenderStateRuntime(pass.state);
+    pass.colorView = bindWgpuRenderPassTarget(pass.state, pass.target);
+    pass.encoder = recordWgpuRenderPassEncoder(pass.state, pass.target, pass.colorView, undefined);
+    runtime.renderPass = pass.encoder;
+}
+// Sets the 2D root device transform the display-object update pass reads to place nodes with no scene
+// parent. Call after beginWgpuRenderPass when a 2D pass renders into a target with its own coordinate
+// system (the render cache); the matching endWgpuRenderPass restores the previous value. A fresh matrix
+// is allocated rather than mutated in place, because the bracket saved the previous reference.
+export function setWgpuRenderTransform2D(pass, transform) {
+    const next = createMatrix();
+    copyMatrix(next, transform);
+    pass.state.renderTransform2D = next;
+}
+// Ends the pass's GPU encoder while leaving the pass open, so a caller can record its own render passes
+// into the same frame (the effect pipeline's fullscreen passes). Pair with resumeWgpuRenderPass.
+export function suspendWgpuRenderPass(pass) {
+    if (pass.encoder === null)
+        return;
+    pass.encoder.end();
+    pass.encoder = null;
+    getWgpuRenderStateRuntime(pass.state).renderPass = null;
+}
+function acquireWgpuRenderPassHandle(state, target, colorView, saved, ownsFrame) {
+    const pooled = _passPool.pop();
+    if (pooled !== undefined) {
+        pooled.colorView = colorView;
+        pooled.encoder = null;
+        pooled.ownsFrame = ownsFrame;
+        pooled.saved = saved;
+        pooled.state = state;
+        pooled.target = target;
+        return pooled;
+    }
+    const out = allocateEntity();
+    out.colorView = colorView;
+    out.encoder = null;
+    out.ownsFrame = ownsFrame;
+    out.saved = saved;
+    out.state = state;
+    out.target = target;
+    out.viewport = { height: 0, width: 0 };
+    return finishEntity(out);
+}
+// Resolves the color view to attach: the swap-chain (or supersample) view for a screen target, the
+// target's own view for a texture target. Screen storage is sized to its surface here, which is why a
+// caller never announces a canvas resize.
+function bindWgpuRenderPassTarget(state, target) {
+    if (isWgpuScreenRenderTarget(target)) {
+        const view = bindWgpuScreenRenderTarget(state, target);
+        getWgpuRenderStateRuntime(state).frameScreenTarget = target;
+        return view;
+    }
+    return target.view;
+}
+function recordWgpuRenderPassEncoder(state, target, colorView, clear) {
+    const runtime = getWgpuRenderStateRuntime(state);
+    const hasColor = clear !== undefined && (clear.color !== undefined || clear.colors !== undefined);
+    const encoder = runtime.commandEncoder.beginRenderPass({
+        colorAttachments: [
+            {
+                view: colorView,
+                clearValue: resolveWgpuClearColor(clear),
+                loadOp: hasColor ? 'clear' : 'load',
+                storeOp: 'store',
+            },
+        ],
+        depthStencilAttachment: {
+            view: target.depthStencilView,
+            depthClearValue: clear?.depth ?? 1.0,
+            depthLoadOp: clear?.depth !== undefined ? 'clear' : 'load',
+            depthStoreOp: 'discard',
+            stencilClearValue: clear?.stencil ?? 0,
+            stencilLoadOp: 'clear',
+            stencilStoreOp: 'discard',
+        },
+    });
+    encoder.setViewport(0, 0, target.width, target.height, 0, 1);
+    return encoder;
+}
+// A released handle keeps its state/target references until the next acquire overwrites them: they are
+// plain references to objects the caller still owns, and nulling them would cost the non-null field types
+// that make a live handle safe to read.
+function releaseWgpuRenderPassHandle(pass) {
+    pass.encoder = null;
+    _passPool.push(pass);
+}
+// One color value broadcasts to every attachment; `colors` selects per attachment. WebGPU takes the
+// clear through the attachment's load operation, so only attachment 0 is expressible today — the
+// broadcast and the first per-attachment entry resolve to the same thing here.
+function resolveWgpuClearColor(clear) {
+    const rgba = clear?.colors?.[0] ?? clear?.color;
+    if (rgba === undefined)
+        return { r: 0, g: 0, b: 0, a: 0 };
+    return { r: rgba[0], g: rgba[1], b: rgba[2], a: rgba[3] };
+}
+// Pass handles are per-frame scaffolding, so a render loop must not allocate one per frame. The pool is
+// module-scoped rather than per-state: a handle carries no device resource, only references cleared on
+// release, so two states on one thread can share the free list.
+const _passPool = [];
+//# sourceMappingURL=wgpuRenderPass.js.map

package/dist/wgpuRenderPass.js.map

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

package/dist/wgpuRenderState.d.ts

@@ -1,5 +1,5 @@
-import type { EntityConstruction, TextureWrap, WgpuColorAdjustmentMaterialFeature, WgpuColorAdjustmentMaterialFeatureGuard, WgpuDeviceRuntime, WgpuDeviceRuntimeResources, WgpuDeviceState, WgpuHostAcquisition, WgpuHostAcquisitionOptions, WgpuOffscreenRenderStateResult, WgpuPipeline, WgpuPresentationRenderState, WgpuRenderOptions, WgpuRenderState, WgpuRenderStateRuntime } from '@flighthq/types/contract';
-export declare function createWgpuAcquisitionFromCanvasElement(canvas: HTMLCanvasElement, options?: Readonly<WgpuHostAcquisitionOptions>): Promise<WgpuHostAcquisition | null>;
+import type { EntityConstruction, TextureWrap, WgpuColorAdjustmentMaterialFeature, WgpuColorAdjustmentMaterialFeatureGuard, WgpuDeviceRuntime, WgpuDeviceRuntimeResources, WgpuDeviceState, WgpuHostAcquisition, WgpuHostAcquisitionOptions, WgpuOffscreenRenderStateResult, WgpuPipeline, WgpuRenderOptions, WgpuRenderState, WgpuRenderStateRuntime, WgpuScreenSurface } from '@flighthq/types/contract';
+export declare function createWgpuAcquisition(surface: WgpuScreenSurface, options?: Readonly<WgpuHostAcquisitionOptions>): Promise<WgpuHostAcquisition | null>;
 export declare function createWgpuDeviceState(device: GPUDevice): WgpuDeviceState;
 /**
  * Creates a device-only render state with its own frame-local resources.
@@ -10,8 +10,7 @@ export declare function createWgpuDeviceState(device: GPUDevice): WgpuDeviceStat
  */
 export declare function createWgpuOffscreenRenderState(source: WgpuRenderState): WgpuOffscreenRenderStateResult;
 export declare function createWgpuOffscreenRenderState(deviceState: Readonly<WgpuDeviceState>, pipeline: Readonly<WgpuPipeline>, options?: Readonly<WgpuRenderOptions>): WgpuRenderState;
-export declare function createWgpuRenderState(acquisition: Readonly<WgpuHostAcquisition>, pipeline: Readonly<WgpuPipeline>, options?: Readonly<WgpuRenderOptions>): WgpuPresentationRenderState;
-export declare function createWgpuRenderStateFromCanvasElement(canvas: HTMLCanvasElement, pipeline: Readonly<WgpuPipeline>, options?: Readonly<WgpuRenderOptions & WgpuHostAcquisitionOptions>): Promise<WgpuPresentationRenderState>;
+export declare function createWgpuRenderState(device: GPUDevice, pipeline: Readonly<WgpuPipeline>, options?: Readonly<WgpuRenderOptions>): WgpuRenderState;
 export declare function createWgpuRenderStateRuntime(deviceStateOrRuntime: Readonly<WgpuDeviceState> | WgpuRenderStateRuntime, pipeline?: Readonly<WgpuPipeline>): WgpuRenderStateRuntime;
 export declare function destroyWgpuRenderState(state: WgpuRenderState): void;
 export declare function getWgpuColorAdjustmentMaterialFeature(state: WgpuRenderState): Readonly<WgpuColorAdjustmentMaterialFeature> | null;

package/dist/wgpuRenderState.d.ts.map

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

package/dist/wgpuRenderState.js

@@ -1,6 +1,6 @@
 import { allocateEntity, finishEntity } from '@flighthq/entity/contract';
 import { createMatrix } from '@flighthq/geometry/contract';
-import { createRenderState as _createRenderState, createRenderStateRuntime, destroyRenderState, setRenderStateBackgroundColor, } from '@flighthq/render/contract';
+import { createRenderState as _createRenderState, createRenderStateRuntime, destroyRenderState, } from '@flighthq/render/contract';
 import { EntityRuntimeKey, RegistryEntryState } from '@flighthq/types/contract';
 import { observeWgpuDeviceLoss } from './wgpuDeviceLoss';
 import { warmWgpuPipelines } from './wgpuDraw';
@@ -13,9 +13,9 @@ const RING_SLOT_COUNT = 4096;
 // ends their life with `releaseWgpuAcquisition`, and a state built on them leaves them intact when it is
 // destroyed. Returns `null` rather than throwing, because "this environment has no WebGPU" is an expected
 // outcome and not a programmer error.
-export async function createWgpuAcquisitionFromCanvasElement(canvas, options = {}) {
+export async function createWgpuAcquisition(surface, options = {}) {
     try {
-        const acquired = await getWgpuHostBackend().acquire(canvas, options);
+        const acquired = await getWgpuHostBackend().acquire(surface, options);
         const out = allocateEntity();
         initializeWgpuHostAcquisition(out, acquired, 'caller');
         return finishEntity(out);
@@ -45,7 +45,6 @@ export function createWgpuOffscreenRenderState(sourceOrDeviceState, pipeline, op
         })();
     const derivedPipeline = createWgpuPipeline(sourceRuntime.registries);
     const state = initializeWgpuDeviceRenderState(source.deviceState, derivedPipeline, {
-        backgroundColor: source.backgroundColor,
         format: source.format,
         imageSmoothingEnabled: source.allowSmoothing,
         pixelRatio: source.pixelRatio,
@@ -63,30 +62,16 @@ export function createWgpuOffscreenRenderState(sourceOrDeviceState, pipeline, op
     initializeWgpuOffscreenRenderStateOkResult(out, state);
     return finishEntity(out);
 }
-// Synchronous: with the handles already in hand there is nothing left to await. Everything asynchronous
-// lives in acquisition.
-export function createWgpuRenderState(acquisition, pipeline, options = {}) {
-    const hostBackend = getWgpuHostBackend();
-    try {
-        return initializeWgpuPresentationRenderState(options, acquisition, pipeline, hostBackend);
-    }
-    catch (error) {
-        // ★ NEVER release what the caller owns, not even while unwinding a failure. This is the path where
-        // borrowed handles were previously destroyed on the way out, and it was safe only because the shipped
-        // backend happened to check. The policy belongs here, where it holds for every backend.
-        if (acquisition.ownership !== 'caller')
-            hostBackend.release(acquisition);
-        throw error;
-    }
-}
-// The canvas convenience: acquire, then build. The handles are `flight`-owned, so destroying the state
-// releases them — the behavior every existing caller had when it passed a canvas.
-export async function createWgpuRenderStateFromCanvasElement(canvas, pipeline, options = {}) {
-    const acquisition = await getWgpuHostBackend().acquire(canvas, {
-        format: options.format,
-        powerPreference: options.powerPreference,
-    });
-    return createWgpuRenderState(acquisition, pipeline, options);
+// Takes the driver handle directly: the device is how a state talks to the GPU — shader compilation,
+// texture upload, renderer registration — and none of that needs a target. Which surface a frame lands on
+// is a per-pass decision, so the screen target is created separately and flows in at beginWgpuRenderPass.
+//
+// Synchronous, because everything asynchronous (adapter and device discovery) happens before this call:
+//   const acquisition = await createWgpuAcquisition(canvas);
+//   const screen = createWgpuScreenRenderTarget(acquisition.device, canvas, { format: acquisition.format });
+//   const state = createWgpuRenderState(acquisition.device, pipeline, { format: acquisition.format });
+export function createWgpuRenderState(device, pipeline, options = {}) {
+    return initializeWgpuDeviceRenderState(createWgpuDeviceState(device), pipeline, options);
 }
 export function createWgpuRenderStateRuntime(deviceStateOrRuntime, pipeline) {
     const deviceRuntime = EntityRuntimeKey in deviceStateOrRuntime
@@ -98,25 +83,6 @@ export function createWgpuRenderStateRuntime(deviceStateOrRuntime, pipeline) {
             : deviceStateOrRuntime.registries);
     return createWgpuRenderStateRuntimeInternal(deviceRuntime, resolvedPipeline);
 }
-function initializeWgpuPresentationRenderState(options, acquisition, pipeline, hostBackend) {
-    const { context, device, format } = acquisition;
-    // COPY_SRC lets the canvas texture be read back via copyTextureToBuffer (createBitmapFromWgpuRenderState).
-    // It is the only reliable way to read a Wgpu frame in headless/software contexts, where canvas
-    // presentation does not surface the swapchain; it also backs user-facing screenshot/save-pixels needs.
-    context.configure({
-        device,
-        format,
-        alphaMode: 'premultiplied',
-        usage: GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.COPY_SRC,
-    });
-    const deviceState = createWgpuDeviceState(device);
-    const ownership = { acquisition, hostBackend, references: 0 };
-    _acquisitionByDeviceRuntime.set(getWgpuDeviceRuntime(deviceState), ownership);
-    const state = initializeWgpuDeviceRenderState(deviceState, pipeline, { ...options, format });
-    Object.assign(state, { context, surface: acquisition.surface });
-    getWgpuRenderStateRuntime(state).surfaceAntialiasEnabled = options.antialias ?? false;
-    return state;
-}
 function initializeWgpuDeviceRenderState(deviceState, pipeline, options) {
     const device = deviceState.device;
     const format = options.format ?? 'bgra8unorm';
@@ -141,13 +107,10 @@ function initializeWgpuDeviceRenderState(deviceState, pipeline, options) {
         roundPixels: options.roundPixels ?? false,
         sceneGraphSyncPolicy: options.sceneGraphSyncPolicy,
     });
-    if (options.backgroundColor != null)
-        setRenderStateBackgroundColor(state, options.backgroundColor);
     state.applyBlendMode = null;
     Object.assign(state, { deviceState, device, format, pipeline });
     const runtime = createWgpuRenderStateRuntime(deviceState, pipeline);
     state[EntityRuntimeKey] = runtime;
-    runtime.surfaceAntialiasEnabled = false;
     runtime.currentBlendMode = null;
     runtime.currentRenderTarget = null;
     runtime.uniformBuffer = uniformBuffer;
@@ -177,18 +140,7 @@ function initializeWgpuDeviceRenderState(deviceState, pipeline, options) {
     runtime.quadBatchWriterBufferCursor = 0;
     runtime.commandEncoder = null;
     runtime.renderPass = null;
-    runtime.canvasTextureView = null;
-    runtime.canvasViewCleared = false;
-    runtime.frameCaptureEnabled = false;
-    runtime.frameCaptureTexture = null;
-    runtime.frameCaptureBuffer = null;
-    runtime.frameCaptureBytesPerRow = 0;
-    runtime.frameCaptureWidth = 0;
-    runtime.frameCaptureHeight = 0;
-    runtime.depthStencilTexture = null;
-    runtime.depthStencilView = null;
-    runtime.depthStencilWidth = 0;
-    runtime.depthStencilHeight = 0;
+    runtime.frameScreenTarget = null;
     runtime.currentMaskDepth = 0;
     runtime.maskWriteMode = false;
     runtime.clipContourPipelines = undefined;
@@ -198,7 +150,7 @@ function initializeWgpuDeviceRenderState(deviceState, pipeline, options) {
     runtime.scissorStack = [];
     runtime.currentScissorRect = null;
     runtime.renderTargetViewport = null;
-    runtime.renderTargetStack = [];
+    runtime.passStack = [];
     warmWgpuPipelines(state);
     return state;
 }
@@ -209,8 +161,8 @@ function initializeWgpuDeviceRenderState(deviceState, pipeline, options) {
 //
 // GC-managed Wgpu objects with no destroy() (pipelines, bind groups, layouts, samplers, shader
 // modules, texture views) are not touched. textureCache is a WeakMap and cannot be enumerated; its
-// entries' textures are freed per-node by the dispose* paths. The shared device tier routes its
-// acquisition through the originating host backend when its last state is destroyed.
+// entries' textures are freed per-node by the dispose* paths. Surface storage belongs to the screen
+// render target, not to a state, so destroyWgpuScreenRenderTarget frees that side.
 export function destroyWgpuRenderState(state) {
     if (_destroyedStates.has(state))
         return;
@@ -222,8 +174,6 @@ export function destroyWgpuRenderState(state) {
     destroyRenderState(state);
     runtime.uniformBuffer?.destroy();
     runtime.particleInstanceBuffer?.destroy();
-    runtime.depthStencilTexture?.destroy();
-    runtime.surfaceAntialiasTexture?.destroy();
     for (const slot of runtime.quadBatchWriterBufferPool) {
         slot.instanceBuffer?.destroy();
         slot.materialBuffer?.destroy();
@@ -239,13 +189,6 @@ export function destroyWgpuRenderState(state) {
             teardown(device);
         ctx.teardowns.length = 0;
     }
-    const ownership = _acquisitionByStateRuntime.get(runtime);
-    if (ownership !== undefined) {
-        ownership.references--;
-        if (ownership.references === 0 && ownership.acquisition.ownership !== 'caller') {
-            ownership.hostBackend.release(ownership.acquisition);
-        }
-    }
 }
 function createWgpuRenderStateRuntimeInternal(deviceRuntime, pipeline) {
     const runtime = createRenderStateRuntime();
@@ -254,23 +197,11 @@ function createWgpuRenderStateRuntimeInternal(deviceRuntime, pipeline) {
     // reaches an instanced draw — presentation, offscreen, or a test helper's — has the pool to claim from.
     runtime.meshInstanceBufferPool = [];
     runtime.meshInstanceBufferCursor = 0;
-    runtime.surfaceAntialiasEnabled = false;
-    runtime.surfaceAntialiasTexture = null;
-    runtime.surfaceAntialiasView = null;
-    runtime.surfaceAntialiasWidth = 0;
-    runtime.surfaceAntialiasHeight = 0;
     runtime.surfaceAntialiasResolveBindGroupLayout = null;
     runtime.surfaceAntialiasResolvePipeline = null;
-    runtime.surfaceAntialiasResolveBindGroup = null;
-    runtime.surfacePresentationView = null;
     runtime.registries = { ...pipeline.registries };
     runtime.teardowns = [];
     runtime.borrowedSurfaceExtent = null;
-    const ownership = _acquisitionByDeviceRuntime.get(deviceRuntime);
-    if (ownership !== undefined) {
-        ownership.references++;
-        _acquisitionByStateRuntime.set(runtime, ownership);
-    }
     deviceRuntime.references++;
     runtime.context = deviceRuntime;
     return runtime;
@@ -413,8 +344,6 @@ function createMinimalDeviceRuntime(device) {
     observeWgpuDeviceLoss(runtime);
     return runtime;
 }
-const _acquisitionByStateRuntime = new WeakMap();
-const _acquisitionByDeviceRuntime = new WeakMap();
 const _destroyedStates = new WeakSet();
 // Resolve the blend hook at the draw seam rather than hiding derived-state delegation behind an
 // entity accessor. A locally installed hook wins; otherwise walk toward the screen pipeline so