@aardworx/wombat.rendering 0.1.0 → 0.1.1

package/dist/runtime/renderTask.js.map

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

package/dist/runtime/renderTo.d.ts

@@ -0,0 +1,40 @@
+import { AdaptiveResource, ITexture, type ClearValues, type FramebufferSignature, type IFramebuffer, type RenderTree } from "../core/index.js";
+import { type FramebufferSize } from "../resources/index.js";
+import { HashMap, type aval } from "@aardworx/wombat.adaptive";
+import type { RuntimeContext } from "./renderTask.js";
+export interface RenderToOptions {
+    readonly size: aval<FramebufferSize>;
+    readonly signature: FramebufferSignature;
+    /** What to clear the FBO with each frame. Omit to skip the clear pass. */
+    readonly clear?: ClearValues;
+    readonly label?: string;
+    /**
+     * Extra GPU texture usage flags for every color attachment.
+     * `RENDER_ATTACHMENT | TEXTURE_BINDING` are always set; pass
+     * `COPY_SRC` here to enable readback, `STORAGE_BINDING` for
+     * compute writes, etc.
+     */
+    readonly extraUsage?: GPUTextureUsageFlags;
+}
+export interface RenderToResult {
+    /** The full framebuffer resource. Acquire/release for explicit lifetime control. */
+    readonly framebuffer: AdaptiveResource<IFramebuffer>;
+    /**
+     * Returns an `aval<ITexture>` for the named color attachment.
+     * The aval is itself an AdaptiveResource — acquiring it
+     * activates the render-to pipeline.
+     */
+    color(name: string): AdaptiveResource<ITexture>;
+    /**
+     * Convenience for multi-target render passes: returns a
+     * `HashMap<string, aval<ITexture>>` covering every color
+     * attachment in the signature. Each entry shares the underlying
+     * lifetime — acquiring any (or the whole map's entries) activates
+     * the render-to pipeline.
+     */
+    colors(): HashMap<string, AdaptiveResource<ITexture>>;
+    /** Returns the depth-stencil attachment as an `ITexture` (if the signature has one). */
+    depthStencil(): AdaptiveResource<ITexture>;
+}
+export declare function renderTo(ctx: RuntimeContext, scene: RenderTree, opts: RenderToOptions): RenderToResult;
+//# sourceMappingURL=renderTo.d.ts.map

package/dist/runtime/renderTo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderTo.d.ts","sourceRoot":"","sources":["../../src/runtime/renderTo.ts"],"names":[],"mappings":"AAmBA,OAAO,EACL,gBAAgB,EAChB,QAAQ,EAER,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,UAAU,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,OAAO,EAAsB,KAAK,IAAI,EAAE,MAAM,2BAA2B,CAAC;AAEnF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IACzC,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,oBAAoB,CAAC;CAC5C;AAED,MAAM,WAAW,cAAc;IAC7B,oFAAoF;IACpF,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;IACrD;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAChD;;;;;;OAMG;IACH,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC;IACtD,wFAAwF;IACxF,YAAY,IAAI,gBAAgB,CAAC,QAAQ,CAAC,CAAC;CAC5C;AAyCD,wBAAgB,QAAQ,CACtB,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,eAAe,GACpB,cAAc,CAqChB"}

package/dist/runtime/renderTo.js

@@ -0,0 +1,97 @@
+// renderTo — Aardvark `RenderTask.renderTo` ported.
+//
+// Usage:
+//   const result = renderTo(ctx, scene, { size, signature, clear });
+//   const colorAval: aval<ITexture> = result.color("color");
+//   // bind colorAval as a texture on a downstream RenderObject
+//
+// `result.framebuffer` is an `AdaptiveResource<IFramebuffer>` that:
+//   - Allocates the FBO on first acquire.
+//   - On `compute(token)`: reads `size`, encodes a clear pass +
+//     scene render into the active `RenderContext.encoder`, returns
+//     the FBO. Encoding only runs when an outer encoder is active;
+//     when read outside a frame the FBO is returned untouched.
+//   - On last release: disposes the inner cache and frees the FBO.
+//
+// Each `result.color(name)` is a derived `aval<ITexture>` whose
+// lifetime forwards to `framebuffer`, so consuming any attachment
+// keeps the whole pipeline alive.
+import { AdaptiveResource, ITexture, RenderContext, } from "../core/index.js";
+import { allocateFramebuffer, } from "../resources/index.js";
+import { beginPassDescriptor } from "../commands/index.js";
+import { HashMap } from "@aardworx/wombat.adaptive";
+import { ScenePass } from "./scenePass.js";
+class RenderToFramebuffer extends AdaptiveResource {
+    ctx;
+    fbo;
+    scene;
+    clearValues;
+    signature;
+    scenePass;
+    constructor(ctx, fbo, scene, clearValues, signature) {
+        super();
+        this.ctx = ctx;
+        this.fbo = fbo;
+        this.scene = scene;
+        this.clearValues = clearValues;
+        this.signature = signature;
+    }
+    create() {
+        this.fbo.acquire();
+        this.scenePass = new ScenePass(this.ctx.device, this.signature, this.scene, this.ctx.compileEffect);
+    }
+    destroy() {
+        this.scenePass?.dispose();
+        this.scenePass = undefined;
+        this.fbo.release();
+    }
+    compute(token) {
+        const fb = this.fbo.getValue(token);
+        const enc = RenderContext.encoder;
+        if (enc !== null && this.scenePass !== undefined) {
+            const leaves = this.scenePass.resolve(token);
+            if (leaves.length > 0 || this.clearValues !== undefined) {
+                const pass = enc.beginRenderPass(beginPassDescriptor(fb, this.clearValues));
+                for (const leaf of leaves)
+                    leaf.record(pass, token);
+                pass.end();
+            }
+        }
+        return fb;
+    }
+}
+export function renderTo(ctx, scene, opts) {
+    const fbo = allocateFramebuffer(ctx.device, opts.signature, opts.size, {
+        ...(opts.label !== undefined ? { labelPrefix: opts.label } : {}),
+        ...(opts.extraUsage !== undefined ? { extraUsage: opts.extraUsage } : {}),
+    });
+    const renderToFbo = new RenderToFramebuffer(ctx, fbo, scene, opts.clear, opts.signature);
+    return {
+        framebuffer: renderToFbo,
+        color(name) {
+            return renderToFbo.derive(fb => {
+                const tex = fb.colorTextures?.tryFind(name);
+                if (tex === undefined) {
+                    throw new Error(`renderTo.color: framebuffer has no color attachment "${name}"`);
+                }
+                return ITexture.fromGPU(tex);
+            });
+        },
+        colors() {
+            let out = HashMap.empty();
+            for (const [name] of opts.signature.colors) {
+                out = out.add(name, this.color(name));
+            }
+            return out;
+        },
+        depthStencil() {
+            return renderToFbo.derive(fb => {
+                if (fb.depthStencilTexture === undefined) {
+                    throw new Error("renderTo.depthStencil: framebuffer has no depth-stencil attachment");
+                }
+                return ITexture.fromGPU(fb.depthStencilTexture);
+            });
+        },
+    };
+}
+//# sourceMappingURL=renderTo.js.map

package/dist/runtime/renderTo.js.map

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

package/dist/runtime/runtime.d.ts

@@ -0,0 +1,48 @@
+import type { Command, CompiledEffect, Effect, IRenderTask, RenderTree } from "../core/index.js";
+import type { alist } from "@aardworx/wombat.adaptive";
+import { type RenderToOptions, type RenderToResult } from "./renderTo.js";
+export interface RuntimeOptions {
+    readonly device: GPUDevice;
+    /**
+     * Optional override for `Effect → CompiledEffect`. Defaults to
+     * `effect.compile({ target: "wgsl" })`. Override when tests want
+     * a hand-built CompiledEffect or when the caller needs custom
+     * `CompileOptions` (`skipMatrixReversal`, source-file labelling,
+     * …).
+     */
+    readonly compileEffect?: (effect: Effect) => CompiledEffect;
+}
+export declare class Runtime {
+    private readonly ctx;
+    private readonly _tasks;
+    private _disposed;
+    private _deviceLost;
+    /**
+     * Resolves to the lost-info when the device is reported lost.
+     * Stays pending while the device is alive.
+     */
+    readonly deviceLost: Promise<GPUDeviceLostInfo>;
+    constructor(opts: RuntimeOptions);
+    get device(): GPUDevice;
+    get isDeviceLost(): boolean;
+    /** Compile an `alist<Command>` into a runnable `IRenderTask`. */
+    compile(commands: alist<Command>): IRenderTask;
+    /**
+     * Render `scene` into a freshly-allocated framebuffer, returning
+     * lazy `aval<ITexture>` handles for each color/depth attachment.
+     * The framebuffer + inner render task come live when any
+     * returned aval is acquired (transitively, e.g. by binding it
+     * to a downstream RenderObject), and shut down on last release.
+     */
+    renderTo(scene: RenderTree, opts: RenderToOptions): RenderToResult;
+    /**
+     * Tear down every IRenderTask compiled through this Runtime.
+     * After calling this, `compile()` and `renderTo()` throw.
+     * Idempotent. Intended for page-unload + fatal error paths.
+     *
+     * Note: doesn't destroy the GPUDevice itself — the user still
+     * owns its lifecycle.
+     */
+    disposeAll(): void;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/runtime/runtime.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACjG,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAEvD,OAAO,EAAY,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B;;;;;;OAMG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,cAAc,CAAC;CAC7D;AAED,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAiB;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;gBAEpC,IAAI,EAAE,cAAc;IAoBhC,IAAI,MAAM,IAAI,SAAS,CAA4B;IACnD,IAAI,YAAY,IAAI,OAAO,CAA6B;IAqBxD,iEAAiE;IACjE,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,WAAW;IAS9C;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,GAAG,cAAc;IAKlE;;;;;;;OAOG;IACH,UAAU,IAAI,IAAI;CAQnB"}

package/dist/runtime/runtime.js

@@ -0,0 +1,100 @@
+// Runtime — the user-facing entry point. Holds the device +
+// effect-compilation hook, exposes `compile(commands)` and
+// (eventually) `renderTo(...)`.
+import { compileRenderTask } from "./renderTask.js";
+import { renderTo } from "./renderTo.js";
+export class Runtime {
+    ctx;
+    _tasks = new Set();
+    _disposed = false;
+    _deviceLost = false;
+    /**
+     * Resolves to the lost-info when the device is reported lost.
+     * Stays pending while the device is alive.
+     */
+    deviceLost;
+    constructor(opts) {
+        this.ctx = {
+            device: opts.device,
+            compileEffect: opts.compileEffect ?? ((e) => e.compile({ target: "wgsl" })),
+        };
+        // `device.lost` is a real-WebGPU promise; mock devices may not
+        // expose it. Treat as "never lost" in that case.
+        const lost = opts.device.lost;
+        this.deviceLost = lost !== undefined
+            ? lost.then((info) => {
+                this._deviceLost = true;
+                // Best-effort: dispose all outstanding tasks so user code
+                // that still holds them stops trying to encode against a
+                // dead device.
+                this.disposeAll();
+                return info;
+            })
+            : new Promise(() => { });
+    }
+    get device() { return this.ctx.device; }
+    get isDeviceLost() { return this._deviceLost; }
+    // Recovery story (after `device.lost`):
+    //
+    // 1. The `lost`-handler above fires `disposeAll()`, releasing all
+    //    `IRenderTask`s and the `PreparedRenderObject`s they hold.
+    //    User-level avals (`cval`, `clist`, `cset`) survive — they're
+    //    device-agnostic.
+    // 2. Caller re-requests an adapter + device, constructs a new
+    //    `Runtime` from it, and re-`compile()`s their original
+    //    `alist<Command>`. The new Runtime builds fresh
+    //    PreparedRenderObjects + a fresh ScenePass tree from the same
+    //    user data; the per-device caches inside compile-pipeline /
+    //    sampler / mip-gen are keyed on `WeakMap<GPUDevice, ...>` so
+    //    they re-populate naturally for the new device.
+    //
+    // We don't expose a single-call `replaceDevice()` because every
+    // prepared object's GPU handles are baked in at construction; the
+    // cleanest path is to discard the old Runtime and construct a new
+    // one from the same source `alist<Command>`.
+    /** Compile an `alist<Command>` into a runnable `IRenderTask`. */
+    compile(commands) {
+        if (this._disposed)
+            throw new Error("Runtime: compile after disposeAll");
+        const task = compileRenderTask(this.ctx, commands);
+        this._tasks.add(task);
+        const origDispose = task.dispose.bind(task);
+        task.dispose = () => { origDispose(); this._tasks.delete(task); };
+        return task;
+    }
+    /**
+     * Render `scene` into a freshly-allocated framebuffer, returning
+     * lazy `aval<ITexture>` handles for each color/depth attachment.
+     * The framebuffer + inner render task come live when any
+     * returned aval is acquired (transitively, e.g. by binding it
+     * to a downstream RenderObject), and shut down on last release.
+     */
+    renderTo(scene, opts) {
+        if (this._disposed)
+            throw new Error("Runtime: renderTo after disposeAll");
+        return renderTo(this.ctx, scene, opts);
+    }
+    /**
+     * Tear down every IRenderTask compiled through this Runtime.
+     * After calling this, `compile()` and `renderTo()` throw.
+     * Idempotent. Intended for page-unload + fatal error paths.
+     *
+     * Note: doesn't destroy the GPUDevice itself — the user still
+     * owns its lifecycle.
+     */
+    disposeAll() {
+        if (this._disposed)
+            return;
+        this._disposed = true;
+        for (const t of [...this._tasks]) {
+            try {
+                t.dispose();
+            }
+            catch (e) {
+                console.error("Runtime.disposeAll: task.dispose threw", e);
+            }
+        }
+        this._tasks.clear();
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime/runtime.js.map

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

package/dist/runtime/scenePass.d.ts

@@ -0,0 +1,25 @@
+import { type AdaptiveToken } from "@aardworx/wombat.adaptive";
+import { type CompiledEffect, type Effect, type FramebufferSignature, type RenderTree } from "../core/index.js";
+import { type PreparedRenderObject } from "../resources/index.js";
+/**
+ * Counters surfaced for tests. `prepareCount` only goes up when
+ * `prepareRenderObject` is called for a fresh RenderObject; it
+ * does not increment per frame on an unchanged scene.
+ */
+export interface WalkerStats {
+    prepareCount: number;
+}
+export declare class ScenePass {
+    private readonly root;
+    /** Bumped on `prepareRenderObject`. Tests use this to confirm O(deltas) prep cost. */
+    readonly stats: WalkerStats;
+    constructor(device: GPUDevice, signature: FramebufferSignature, tree: RenderTree, compileEffect: (e: Effect) => CompiledEffect);
+    /**
+     * Pull deltas from every dynamic subtree, splice the affected
+     * walkers, and produce the current ordered list of leaves.
+     * Idempotent on a clean adaptive graph (no readers fire).
+     */
+    resolve(token: AdaptiveToken): PreparedRenderObject[];
+    dispose(): void;
+}
+//# sourceMappingURL=scenePass.d.ts.map

package/dist/runtime/scenePass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenePass.d.ts","sourceRoot":"","sources":["../../src/runtime/scenePass.ts"],"names":[],"mappings":"AAiBA,OAAO,EACL,KAAK,aAAa,EAQnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,MAAM,EACX,KAAK,oBAAoB,EAEzB,KAAK,UAAU,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,uBAAuB,CAAC;AAS/B;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB;AA6LD,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,sFAAsF;IACtF,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAuB;gBAGhD,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,oBAAoB,EAC/B,IAAI,EAAE,UAAU,EAChB,aAAa,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,cAAc;IAM9C;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,oBAAoB,EAAE;IAOrD,OAAO,IAAI,IAAI;CAGhB"}

package/dist/runtime/scenePass.js

@@ -0,0 +1,250 @@
+// ScenePass — delta-driven walker for one `Render` command's
+// `RenderTree`. Built once at task-compile time; subscribes to the
+// dynamic subtrees (`Adaptive` / `OrderedFromList` /
+// `UnorderedFromSet`); incrementally maintains its set of
+// PreparedRenderObjects.
+//
+// Per-frame cost = O(deltas) + O(leaves) for emission. The static
+// recursion through Empty / Leaf / Ordered / Unordered nodes that
+// the previous walker did each frame is gone — those are folded
+// into a stable NodeWalker tree at construction.
+//
+// Lifted from Aardvark.Rendering's CommandTask delta handling.
+// We keep the *adaptive bookkeeping* pattern (per-RO AdaptiveObject,
+// reader-driven splice) and drop the native command-stream linked-
+// list — that was a .NET↔native amortisation in the F# build with
+// no analogue in WebGPU/JS.
+import { MapExt, } from "@aardworx/wombat.adaptive";
+import {} from "../core/index.js";
+import { prepareRenderObject, } from "../resources/index.js";
+class NodeWalker {
+}
+class EmptyWalker extends NodeWalker {
+    update() { }
+    emit() { }
+    dispose() { }
+}
+class LeafWalker extends NodeWalker {
+    prepared;
+    constructor(ctx, obj) {
+        super();
+        const eff = ctx.compileEffect(obj.effect);
+        this.prepared = prepareRenderObject(ctx.device, obj, eff, ctx.signature, {
+            effectId: obj.effect.id,
+        });
+        this.prepared.acquire();
+        ctx.stats.prepareCount++;
+    }
+    update() { }
+    emit(out) { out.push(this.prepared); }
+    dispose() { this.prepared.release(); }
+}
+class OrderedWalker extends NodeWalker {
+    children;
+    constructor(children) {
+        super();
+        this.children = children;
+    }
+    update(token) { for (const c of this.children)
+        c.update(token); }
+    emit(out) { for (const c of this.children)
+        c.emit(out); }
+    dispose() { for (const c of this.children)
+        c.dispose(); }
+}
+// Same identity-rank counter used by the previous walker. Sorting
+// Unordered subtrees by pipeline-then-group0-layout to minimise
+// state changes inside the render pass.
+const sortRanks = new WeakMap();
+let nextSortRank = 1;
+function rankOf(o) {
+    let r = sortRanks.get(o);
+    if (r === undefined) {
+        r = nextSortRank++;
+        sortRanks.set(o, r);
+    }
+    return r;
+}
+function compareLeaves(a, b) {
+    const pa = rankOf(a.pipeline);
+    const pb = rankOf(b.pipeline);
+    if (pa !== pb)
+        return pa - pb;
+    const la = a.groups[0]?.layout;
+    const lb = b.groups[0]?.layout;
+    if (la !== undefined && lb !== undefined && la !== lb)
+        return rankOf(la) - rankOf(lb);
+    return 0;
+}
+class UnorderedWalker extends NodeWalker {
+    children;
+    constructor(children) {
+        super();
+        this.children = children;
+    }
+    update(token) { for (const c of this.children)
+        c.update(token); }
+    emit(out) {
+        const start = out.length;
+        for (const c of this.children)
+            c.emit(out);
+        // Sort just our slice in-place.
+        const slice = out.splice(start);
+        slice.sort(compareLeaves);
+        for (const p of slice)
+            out.push(p);
+    }
+    dispose() { for (const c of this.children)
+        c.dispose(); }
+}
+class AdaptiveWalker extends NodeWalker {
+    source;
+    ctx;
+    current;
+    currentTree;
+    constructor(source, ctx) {
+        super();
+        this.source = source;
+        this.ctx = ctx;
+    }
+    update(token) {
+        const t = this.source.getValue(token);
+        if (t !== this.currentTree) {
+            this.current?.dispose();
+            this.current = build(t, this.ctx);
+            this.currentTree = t;
+        }
+        this.current.update(token);
+    }
+    emit(out) { this.current?.emit(out); }
+    dispose() { this.current?.dispose(); this.current = undefined; }
+}
+class OrderedFromListWalker extends NodeWalker {
+    ctx;
+    reader;
+    // Sorted-by-Index map. Reassigned (immutable persistent) on every delta.
+    map = MapExt.empty(indexCompare);
+    constructor(source, ctx) {
+        super();
+        this.ctx = ctx;
+        this.reader = source.getReader();
+    }
+    update(token) {
+        const deltas = this.reader.getChanges(token);
+        for (const [idx, op] of deltas) {
+            if (op.tag === "Set") {
+                const old = this.map.tryFind(idx);
+                if (old !== undefined)
+                    old.dispose();
+                const w = build(op.value, this.ctx);
+                // Update the new child immediately so its initial state
+                // is consistent before the next emit.
+                w.update(token);
+                this.map = this.map.add(idx, w);
+            }
+            else {
+                const old = this.map.tryFind(idx);
+                if (old !== undefined) {
+                    old.dispose();
+                    this.map = this.map.remove(idx);
+                }
+            }
+        }
+        // Existing children may have dirty sub-readers — update them too.
+        for (const [, w] of this.map)
+            w.update(token);
+    }
+    emit(out) {
+        for (const [, w] of this.map)
+            w.emit(out);
+    }
+    dispose() {
+        for (const [, w] of this.map)
+            w.dispose();
+        this.map = MapExt.empty(indexCompare);
+    }
+}
+class UnorderedFromSetWalker extends NodeWalker {
+    ctx;
+    reader;
+    map = new Map();
+    constructor(source, ctx) {
+        super();
+        this.ctx = ctx;
+        this.reader = source.getReader();
+    }
+    update(token) {
+        const deltas = this.reader.getChanges(token);
+        for (const op of deltas) {
+            if (op.count > 0) {
+                if (!this.map.has(op.value)) {
+                    const w = build(op.value, this.ctx);
+                    w.update(token);
+                    this.map.set(op.value, w);
+                }
+            }
+            else if (op.count < 0) {
+                const old = this.map.get(op.value);
+                if (old !== undefined) {
+                    old.dispose();
+                    this.map.delete(op.value);
+                }
+            }
+        }
+        for (const w of this.map.values())
+            w.update(token);
+    }
+    emit(out) {
+        const start = out.length;
+        for (const w of this.map.values())
+            w.emit(out);
+        const slice = out.splice(start);
+        slice.sort(compareLeaves);
+        for (const p of slice)
+            out.push(p);
+    }
+    dispose() {
+        for (const w of this.map.values())
+            w.dispose();
+        this.map.clear();
+    }
+}
+function indexCompare(a, b) { return a.compareTo(b); }
+function build(tree, ctx) {
+    switch (tree.kind) {
+        case "Empty": return new EmptyWalker();
+        case "Leaf": return new LeafWalker(ctx, tree.object);
+        case "Ordered": return new OrderedWalker(tree.children.map(c => build(c, ctx)));
+        case "Unordered": return new UnorderedWalker(tree.children.map(c => build(c, ctx)));
+        case "Adaptive": return new AdaptiveWalker(tree.tree, ctx);
+        case "OrderedFromList": return new OrderedFromListWalker(tree.children, ctx);
+        case "UnorderedFromSet": return new UnorderedFromSetWalker(tree.children, ctx);
+    }
+}
+// ---------------------------------------------------------------------------
+// ScenePass — public entry
+// ---------------------------------------------------------------------------
+export class ScenePass {
+    root;
+    /** Bumped on `prepareRenderObject`. Tests use this to confirm O(deltas) prep cost. */
+    stats = { prepareCount: 0 };
+    constructor(device, signature, tree, compileEffect) {
+        const ctx = { device, signature, compileEffect, stats: this.stats };
+        this.root = build(tree, ctx);
+    }
+    /**
+     * Pull deltas from every dynamic subtree, splice the affected
+     * walkers, and produce the current ordered list of leaves.
+     * Idempotent on a clean adaptive graph (no readers fire).
+     */
+    resolve(token) {
+        this.root.update(token);
+        const out = [];
+        this.root.emit(out);
+        return out;
+    }
+    dispose() {
+        this.root.dispose();
+    }
+}
+//# sourceMappingURL=scenePass.js.map

package/dist/runtime/scenePass.js.map

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

package/dist/window/canvas.d.ts

@@ -0,0 +1,38 @@
+import { type IFramebuffer, type FramebufferSignature } from "../core/index.js";
+import { type aval } from "@aardworx/wombat.adaptive";
+export interface AttachCanvasOptions {
+    /** Texture format for the swap-chain. Default: device's preferred format. */
+    readonly format?: GPUTextureFormat;
+    /** Optional depth/stencil format. When set, an off-screen depth texture is co-allocated. */
+    readonly depthFormat?: GPUTextureFormat;
+    /** Pre-multiplied / opaque alpha mode. Default `"premultiplied"`. */
+    readonly alphaMode?: GPUCanvasAlphaMode;
+    /** Logical → physical pixel scaling. Default: `window.devicePixelRatio`. */
+    readonly devicePixelRatio?: number;
+    /** Color attachment name in the resulting `FramebufferSignature`. Default `"color"`. */
+    readonly colorAttachmentName?: string;
+    /**
+     * MSAA sample count. Default 1. With `> 1`, a hidden multisample
+     * color texture (and depth, if `depthFormat` is set) is allocated
+     * sized to the canvas; the swap-chain texture becomes the resolve
+     * target. Common values: 1 (off), 4 (fast MSAA).
+     */
+    readonly sampleCount?: number;
+}
+export interface CanvasAttachment {
+    /** Reactive framebuffer; bump per frame via `markFrame()`. */
+    readonly framebuffer: aval<IFramebuffer>;
+    /** Reactive `{ width, height }` driven by ResizeObserver. */
+    readonly size: aval<{
+        readonly width: number;
+        readonly height: number;
+    }>;
+    /** The signature derived from the chosen formats. */
+    readonly signature: FramebufferSignature;
+    /** Mark a new frame: invalidates the framebuffer aval so its next read produces a fresh swap-chain texture. */
+    markFrame(): void;
+    /** Disconnect the resize observer + clear the canvas context. Idempotent. */
+    dispose(): void;
+}
+export declare function attachCanvas(device: GPUDevice, canvas: HTMLCanvasElement | OffscreenCanvas, opts?: AttachCanvasOptions): CanvasAttachment;
+//# sourceMappingURL=canvas.d.ts.map