@aardworx/wombat.rendering 0.1.0 → 0.2.0

package/dist/runtime/scenePass.js

@@ -0,0 +1,255 @@
+// 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(token) {
+        // Resolve the current pipeline so the upstream sort comparator
+        // sees a stable identity for this frame's pipeline-influencing
+        // aval values.
+        this.prepared.update(token);
+    }
+    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

package/dist/window/canvas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas.d.ts","sourceRoot":"","sources":["../../src/window/canvas.ts"],"names":[],"mappings":"AAqBA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,oBAAoB,EAC1B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAIL,KAAK,IAAI,EAEV,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,mBAAmB;IAClC,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IACnC,4FAA4F;IAC5F,QAAQ,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC;IACxC,qEAAqE;IACrE,QAAQ,CAAC,SAAS,CAAC,EAAE,kBAAkB,CAAC;IACxC,4EAA4E;IAC5E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,wFAAwF;IACxF,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IACzC,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzE,qDAAqD;IACrD,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IACzC,+GAA+G;IAC/G,SAAS,IAAI,IAAI,CAAC;IAClB,6EAA6E;IAC7E,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,iBAAiB,GAAG,eAAe,EAC3C,IAAI,GAAE,mBAAwB,GAC7B,gBAAgB,CAqGlB"}

package/dist/window/canvas.js

@@ -0,0 +1,194 @@
+// attachCanvas — bind a `GPUDevice` to an `HTMLCanvasElement` /
+// `OffscreenCanvas` and expose the swap-chain as an
+// `aval<IFramebuffer>` so render tasks just plug it into a
+// `Render` command's `output`.
+//
+// Each call to `framebuffer.getValue(token)` returns a fresh
+// `IFramebuffer` whose color view is the current swap-chain
+// texture (`context.getCurrentTexture().createView()`). Inside
+// the render loop we mark the framebuffer aval outdated once per
+// rAF tick so the runtime samples the new texture.
+//
+// The size aval is fed by a `ResizeObserver`; on size change we
+// re-`configure()` the canvas context and bump a cval that the
+// framebuffer aval depends on.
+//
+// MSAA: when `sampleCount > 1`, we allocate a hidden multisample
+// color (and depth) texture sized to the canvas; the swap-chain
+// texture becomes the resolve target. The render-pass descriptor
+// builder in `@aardworx/wombat.rendering-commands` already wires
+// `resolveTarget` based on the framebuffer's `resolveColors`.
+import {} from "../core/index.js";
+import { HashMap, cval, transact, } from "@aardworx/wombat.adaptive";
+export function attachCanvas(device, canvas, opts = {}) {
+    const ctx = canvas.getContext("webgpu");
+    if (ctx === null)
+        throw new Error("attachCanvas: getContext('webgpu') returned null");
+    const colorName = opts.colorAttachmentName ?? "color";
+    const format = opts.format ?? navigator.gpu.getPreferredCanvasFormat();
+    const alphaMode = opts.alphaMode ?? "premultiplied";
+    const sampleCount = opts.sampleCount ?? 1;
+    const dpr = opts.devicePixelRatio ?? (typeof window !== "undefined" ? window.devicePixelRatio : 1);
+    // initial size from the canvas's CSS size (or its native dimensions for OffscreenCanvas).
+    const initial = currentSize(canvas, dpr);
+    const sizeC = cval({ width: initial.width, height: initial.height });
+    const frameC = cval(0);
+    // Apply the initial configure. We re-configure on every size change.
+    configure(ctx, device, format, alphaMode);
+    applySize(canvas, initial.width, initial.height);
+    // Hidden multisample color texture, present only when sampleCount > 1.
+    let msaaColor;
+    const ensureMsaaColor = (w, h) => {
+        if (sampleCount <= 1)
+            return undefined;
+        if (msaaColor !== undefined)
+            msaaColor.destroy();
+        msaaColor = device.createTexture({
+            size: { width: w, height: h, depthOrArrayLayers: 1 },
+            format,
+            sampleCount,
+            usage: GPUTextureUsage.RENDER_ATTACHMENT,
+            label: "canvas.color.msaa",
+        });
+        return msaaColor;
+    };
+    ensureMsaaColor(initial.width, initial.height);
+    // Optional shared depth texture re-allocated on size change.
+    let depthTexture;
+    const ensureDepth = (w, h) => {
+        if (opts.depthFormat === undefined)
+            return undefined;
+        if (depthTexture !== undefined)
+            depthTexture.destroy();
+        depthTexture = device.createTexture({
+            size: { width: w, height: h, depthOrArrayLayers: 1 },
+            format: opts.depthFormat,
+            sampleCount,
+            usage: GPUTextureUsage.RENDER_ATTACHMENT,
+            label: "canvas.depth",
+        });
+        return depthTexture;
+    };
+    ensureDepth(initial.width, initial.height);
+    // ResizeObserver — only meaningful for HTMLCanvasElement.
+    let observer;
+    if (typeof ResizeObserver !== "undefined" && canvas instanceof globalThis.HTMLCanvasElement) {
+        observer = new ResizeObserver((entries) => {
+            for (const e of entries) {
+                const cssWidth = e.contentBoxSize?.[0]?.inlineSize ?? canvas.clientWidth;
+                const cssHeight = e.contentBoxSize?.[0]?.blockSize ?? canvas.clientHeight;
+                const w = Math.max(1, Math.floor(cssWidth * dpr));
+                const h = Math.max(1, Math.floor(cssHeight * dpr));
+                if (w !== sizeC.value.width || h !== sizeC.value.height) {
+                    applySize(canvas, w, h);
+                    ensureMsaaColor(w, h);
+                    ensureDepth(w, h);
+                    transact(() => {
+                        sizeC.value = { width: w, height: h };
+                    });
+                }
+            }
+        });
+        observer.observe(canvas);
+    }
+    const signature = {
+        colors: HashMap.empty().add(colorName, format),
+        sampleCount,
+        ...(opts.depthFormat !== undefined
+            ? { depthStencil: depthAttachmentSig(opts.depthFormat) }
+            : {}),
+    };
+    // The framebuffer aval depends on (size, frame). Reading it pulls
+    // a fresh swap-chain texture; the frameC bump after each markFrame()
+    // is what re-fires the chain on the same size.
+    const framebuffer = sizeC.bind((sz) => frameC.map(() => makeFramebuffer(ctx, signature, sz, msaaColor, depthTexture, colorName)));
+    return {
+        framebuffer,
+        size: sizeC,
+        signature,
+        markFrame() {
+            transact(() => { frameC.value = frameC.value + 1; });
+        },
+        dispose() {
+            if (observer !== undefined)
+                observer.disconnect();
+            if (msaaColor !== undefined) {
+                msaaColor.destroy();
+                msaaColor = undefined;
+            }
+            if (depthTexture !== undefined) {
+                depthTexture.destroy();
+                depthTexture = undefined;
+            }
+            try {
+                ctx.unconfigure();
+            }
+            catch { /* already gone */ }
+        },
+    };
+}
+function configure(ctx, device, format, alphaMode) {
+    ctx.configure({
+        device, format, alphaMode,
+        usage: GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_SRC,
+    });
+}
+function currentSize(canvas, dpr) {
+    if (canvas.clientWidth !== undefined) {
+        const c = canvas;
+        return {
+            width: Math.max(1, Math.floor((c.clientWidth || c.width) * dpr)),
+            height: Math.max(1, Math.floor((c.clientHeight || c.height) * dpr)),
+        };
+    }
+    const c = canvas;
+    return { width: c.width, height: c.height };
+}
+function applySize(canvas, w, h) {
+    if (canvas.clientWidth !== undefined) {
+        const c = canvas;
+        c.width = w;
+        c.height = h;
+    }
+    else {
+        const c = canvas;
+        c.width = w;
+        c.height = h;
+    }
+}
+function makeFramebuffer(ctx, signature, size, msaaColor, depthTexture, colorName) {
+    const swap = ctx.getCurrentTexture();
+    const swapView = swap.createView();
+    const msaa = signature.sampleCount > 1;
+    // Pass attachment view: the multisample texture when MSAA is on,
+    // otherwise the swap-chain texture directly.
+    const passView = msaa
+        ? (msaaColor ?? swap).createView()
+        : swapView;
+    const colors = HashMap.empty().add(colorName, passView);
+    const resolveColors = msaa
+        ? HashMap.empty().add(colorName, swapView)
+        : undefined;
+    // `colorTextures` exposes the *sampleable* texture (always the
+    // swap-chain — multisample textures are not sampleable in the
+    // normal sense).
+    const colorTextures = HashMap.empty().add(colorName, swap);
+    const fb = {
+        signature,
+        colors,
+        colorTextures,
+        ...(resolveColors !== undefined ? { resolveColors } : {}),
+        width: size.width,
+        height: size.height,
+        ...(depthTexture !== undefined
+            ? { depthStencil: depthTexture.createView(), depthStencilTexture: depthTexture }
+            : {}),
+    };
+    return fb;
+}
+function depthAttachmentSig(format) {
+    const hasDepth = /^depth/.test(format) || format === "depth24plus-stencil8" || format === "depth32float-stencil8";
+    const hasStencil = /stencil/.test(format);
+    return { format, hasDepth, hasStencil };
+}
+//# sourceMappingURL=canvas.js.map

package/dist/window/canvas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas.js","sourceRoot":"","sources":["../../src/window/canvas.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,oDAAoD;AACpD,2DAA2D;AAC3D,+BAA+B;AAC/B,EAAE;AACF,6DAA6D;AAC7D,4DAA4D;AAC5D,+DAA+D;AAC/D,iEAAiE;AACjE,mDAAmD;AACnD,EAAE;AACF,gEAAgE;AAChE,+DAA+D;AAC/D,+BAA+B;AAC/B,EAAE;AACF,iEAAiE;AACjE,gEAAgE;AAChE,iEAAiE;AACjE,iEAAiE;AACjE,8DAA8D;AAE9D,OAAO,EAGN,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,OAAO,EACP,IAAI,EACJ,QAAQ,GAGT,MAAM,2BAA2B,CAAC;AAmCnC,MAAM,UAAU,YAAY,CAC1B,MAAiB,EACjB,MAA2C,EAC3C,OAA4B,EAAE;IAE9B,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAA4B,CAAC;IACnE,IAAI,GAAG,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtF,MAAM,SAAS,GAAG,IAAI,CAAC,mBAAmB,IAAI,OAAO,CAAC;IACtD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,SAAS,CAAC,GAAG,CAAC,wBAAwB,EAAE,CAAC;IACvE,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,eAAe,CAAC;IACpD,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC;IAE1C,MAAM,GAAG,GAAG,IAAI,CAAC,gBAAgB,IAAI,CAAC,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnG,0FAA0F;IAC1F,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACzC,MAAM,KAAK,GAAuD,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACzH,MAAM,MAAM,GAA4B,IAAI,CAAC,CAAC,CAAC,CAAC;IAEhD,qEAAqE;IACrE,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAC1C,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAEjD,uEAAuE;IACvE,IAAI,SAAiC,CAAC;IACtC,MAAM,eAAe,GAAG,CAAC,CAAS,EAAE,CAAS,EAA0B,EAAE;QACvE,IAAI,WAAW,IAAI,CAAC;YAAE,OAAO,SAAS,CAAC;QACvC,IAAI,SAAS,KAAK,SAAS;YAAE,SAAS,CAAC,OAAO,EAAE,CAAC;QACjD,SAAS,GAAG,MAAM,CAAC,aAAa,CAAC;YAC/B,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,kBAAkB,EAAE,CAAC,EAAE;YACpD,MAAM;YACN,WAAW;YACX,KAAK,EAAE,eAAe,CAAC,iBAAiB;YACxC,KAAK,EAAE,mBAAmB;SAC3B,CAAC,CAAC;QACH,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;IACF,eAAe,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAE/C,6DAA6D;IAC7D,IAAI,YAAoC,CAAC;IACzC,MAAM,WAAW,GAAG,CAAC,CAAS,EAAE,CAAS,EAA0B,EAAE;QACnE,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QACrD,IAAI,YAAY,KAAK,SAAS;YAAE,YAAY,CAAC,OAAO,EAAE,CAAC;QACvD,YAAY,GAAG,MAAM,CAAC,aAAa,CAAC;YAClC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,kBAAkB,EAAE,CAAC,EAAE;YACpD,MAAM,EAAE,IAAI,CAAC,WAAW;YACxB,WAAW;YACX,KAAK,EAAE,eAAe,CAAC,iBAAiB;YACxC,KAAK,EAAE,cAAc;SACtB,CAAC,CAAC;QACH,OAAO,YAAY,CAAC;IACtB,CAAC,CAAC;IACF,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAE3C,0DAA0D;IAC1D,IAAI,QAAoC,CAAC;IACzC,IAAI,OAAO,cAAc,KAAK,WAAW,IAAI,MAAM,YAAa,UAAyE,CAAC,iBAAiB,EAAE,CAAC;QAC5J,QAAQ,GAAG,IAAI,cAAc,CAAC,CAAC,OAAO,EAAE,EAAE;YACxC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,MAAM,QAAQ,GAAG,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,IAAI,MAAM,CAAC,WAAW,CAAC;gBACzE,MAAM,SAAS,GAAG,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,IAAI,MAAM,CAAC,YAAY,CAAC;gBAC1E,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC;gBAClD,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,CAAC;gBACnD,IAAI,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;oBACxD,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;oBACxB,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;oBACtB,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;oBAClB,QAAQ,CAAC,GAAG,EAAE;wBACZ,KAAK,CAAC,KAAK,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;oBACxC,CAAC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QACH,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,SAAS,GAAyB;QACtC,MAAM,EAAE,OAAO,CAAC,KAAK,EAA4B,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC;QACxE,WAAW;QACX,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS;YAChC,CAAC,CAAC,EAAE,YAAY,EAAE,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE;YACxD,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;IAEF,kEAAkE;IAClE,qEAAqE;IACrE,+CAA+C;IAC/C,MAAM,WAAW,GAAuB,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CACxD,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC,CAC1F,CAAC;IAEF,OAAO;QACL,WAAW;QACX,IAAI,EAAE,KAAK;QACX,SAAS;QACT,SAAS;YACP,QAAQ,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACvD,CAAC;QACD,OAAO;YACL,IAAI,QAAQ,KAAK,SAAS;gBAAE,QAAQ,CAAC,UAAU,EAAE,CAAC;YAClD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAAC,SAAS,CAAC,OAAO,EAAE,CAAC;gBAAC,SAAS,GAAG,SAAS,CAAC;YAAC,CAAC;YAC5E,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;gBAAC,YAAY,CAAC,OAAO,EAAE,CAAC;gBAAC,YAAY,GAAG,SAAS,CAAC;YAAC,CAAC;YACrF,IAAI,CAAC;gBAAC,GAAG,CAAC,WAAW,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;QACzD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAChB,GAAqB,EACrB,MAAiB,EACjB,MAAwB,EACxB,SAA6B;IAE7B,GAAG,CAAC,SAAS,CAAC;QACZ,MAAM,EAAE,MAAM,EAAE,SAAS;QACzB,KAAK,EAAE,eAAe,CAAC,iBAAiB,GAAG,eAAe,CAAC,eAAe,GAAG,eAAe,CAAC,QAAQ;KACtG,CAAC,CAAC;AACL,CAAC;AAED,SAAS,WAAW,CAAC,MAA2C,EAAE,GAAW;IAC3E,IAAK,MAA4B,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QAC5D,MAAM,CAAC,GAAG,MAA2B,CAAC;QACtC,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;YAChE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC;SACpE,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,GAAG,MAAyB,CAAC;IACpC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAC9C,CAAC;AAED,SAAS,SAAS,CAAC,MAA2C,EAAE,CAAS,EAAE,CAAS;IAClF,IAAK,MAA4B,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QAC5D,MAAM,CAAC,GAAG,MAA2B,CAAC;QACtC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;QACZ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IACf,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,GAAG,MAAyB,CAAC;QACpC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;QACZ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CACtB,GAAqB,EACrB,SAA+B,EAC/B,IAAuC,EACvC,SAAiC,EACjC,YAAoC,EACpC,SAAiB;IAEjB,MAAM,IAAI,GAAG,GAAG,CAAC,iBAAiB,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,GAAG,CAAC,CAAC;IACvC,iEAAiE;IACjE,6CAA6C;IAC7C,MAAM,QAAQ,GAAG,IAAI;QACnB,CAAC,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC,UAAU,EAAE;QAClC,CAAC,CAAC,QAAQ,CAAC;IACb,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,EAA0B,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAChF,MAAM,aAAa,GAAG,IAAI;QACxB,CAAC,CAAC,OAAO,CAAC,KAAK,EAA0B,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC;QAClE,CAAC,CAAC,SAAS,CAAC;IACd,+DAA+D;IAC/D,8DAA8D;IAC9D,iBAAiB;IACjB,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,EAAsB,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC/E,MAAM,EAAE,GAAiB;QACvB,SAAS;QACT,MAAM;QACN,aAAa;QACb,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,GAAG,CAAC,YAAY,KAAK,SAAS;YAC5B,CAAC,CAAC,EAAE,YAAY,EAAE,YAAY,CAAC,UAAU,EAAE,EAAE,mBAAmB,EAAE,YAAY,EAAE;YAChF,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;IACF,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAwB;IAClD,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,MAAM,KAAK,sBAAsB,IAAI,MAAM,KAAK,uBAAuB,CAAC;IAClH,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AAC1C,CAAC"}

package/dist/window/index.d.ts

@@ -0,0 +1,3 @@
+export { attachCanvas, type AttachCanvasOptions, type CanvasAttachment, } from "./canvas.js";
+export { runFrame, type FrameCallback, type FrameInfo, type RunFrameOptions, } from "./loop.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/window/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,QAAQ,EACR,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,eAAe,GACrB,MAAM,WAAW,CAAC"}

package/dist/window/index.js

@@ -0,0 +1,4 @@
+// Public API of @aardworx/wombat.rendering-window.
+export { attachCanvas, } from "./canvas.js";
+export { runFrame, } from "./loop.js";
+//# sourceMappingURL=index.js.map

package/dist/window/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/window/index.ts"],"names":[],"mappings":"AAAA,mDAAmD;AAEnD,OAAO,EACL,YAAY,GAGb,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,QAAQ,GAIT,MAAM,WAAW,CAAC"}

package/dist/window/loop.d.ts

@@ -0,0 +1,16 @@
+import type { AdaptiveToken } from "@aardworx/wombat.adaptive";
+import type { CanvasAttachment } from "./canvas.js";
+export interface RunFrameOptions {
+    /** Stop after N frames. Useful for tests + finite animations. */
+    readonly maxFrames?: number;
+}
+export type FrameCallback = (token: AdaptiveToken, info: FrameInfo) => void;
+export interface FrameInfo {
+    readonly frame: number;
+    readonly timestampMs: number;
+    readonly deltaMs: number;
+}
+export declare function runFrame(attachment: CanvasAttachment, frame: FrameCallback, opts?: RunFrameOptions): {
+    stop(): void;
+};
+//# sourceMappingURL=loop.d.ts.map

package/dist/window/loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../src/window/loop.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;AAE5E,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,QAAQ,CACtB,UAAU,EAAE,gBAAgB,EAC5B,KAAK,EAAE,aAAa,EACpB,IAAI,GAAE,eAAoB,GACzB;IAAE,IAAI,IAAI,IAAI,CAAA;CAAE,CA8BlB"}

package/dist/window/loop.js

@@ -0,0 +1,43 @@
+// runFrame — requestAnimationFrame-driven loop integrated with
+// wombat.adaptive transactions. Each tick:
+//   1. Bumps the canvas attachment's frame counter so its
+//      framebuffer aval invalidates and the next read returns the
+//      current swap-chain texture.
+//   2. Calls the user's `frame(token)` callback. The user runs
+//      their `IRenderTask` here.
+//
+// Returns a `stop()` to cancel the loop.
+import { AdaptiveToken as Tok } from "@aardworx/wombat.adaptive";
+export function runFrame(attachment, frame, opts = {}) {
+    let stopped = false;
+    let frameNo = 0;
+    let lastTime = performance.now();
+    let rafId = 0;
+    const tick = (now) => {
+        if (stopped)
+            return;
+        const delta = now - lastTime;
+        lastTime = now;
+        attachment.markFrame();
+        try {
+            frame(Tok.top, { frame: frameNo, timestampMs: now, deltaMs: delta });
+        }
+        catch (e) {
+            stopped = true;
+            console.error("runFrame: error in frame callback", e);
+            throw e;
+        }
+        frameNo++;
+        if (opts.maxFrames !== undefined && frameNo >= opts.maxFrames)
+            return;
+        rafId = requestAnimationFrame(tick);
+    };
+    rafId = requestAnimationFrame(tick);
+    return {
+        stop() {
+            stopped = true;
+            cancelAnimationFrame(rafId);
+        },
+    };
+}
+//# sourceMappingURL=loop.js.map

package/dist/window/loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.js","sourceRoot":"","sources":["../../src/window/loop.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,2CAA2C;AAC3C,0DAA0D;AAC1D,kEAAkE;AAClE,mCAAmC;AACnC,+DAA+D;AAC/D,iCAAiC;AACjC,EAAE;AACF,yCAAyC;AAGzC,OAAO,EAAE,aAAa,IAAI,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAgBjE,MAAM,UAAU,QAAQ,CACtB,UAA4B,EAC5B,KAAoB,EACpB,OAAwB,EAAE;IAE1B,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IACjC,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,EAAE;QAC3B,IAAI,OAAO;YAAE,OAAO;QACpB,MAAM,KAAK,GAAG,GAAG,GAAG,QAAQ,CAAC;QAC7B,QAAQ,GAAG,GAAG,CAAC;QACf,UAAU,CAAC,SAAS,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QACvE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,GAAG,IAAI,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,CAAC,CAAC,CAAC;YACtD,MAAM,CAAC,CAAC;QACV,CAAC;QACD,OAAO,EAAE,CAAC;QACV,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QACtE,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC,CAAC;IAEF,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACpC,OAAO;QACL,IAAI;YACF,OAAO,GAAG,IAAI,CAAC;YACf,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aardworx/wombat.rendering",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "WebGPU rendering layer for the Wombat TypeScript stack — RenderObject/RenderTask/runtime + window glue, port of Aardvark.Rendering's lower layers on top of WebGPU and wombat.shader.",
   "license": "MIT",
   "author": "krauthaufen",

package/src/core/index.ts

@@ -47,15 +47,24 @@ export type {
   BlendComponentState,
   BlendState,
   CullMode,
+  DepthBiasState,
   DepthState,
   FrontFace,
-  PipelineState,
+  PlainBlendComponentState,
+  PlainBlendState,
+  PlainDepthState,
+  PlainPipelineState,
+  PlainRasterizerState,
+  PlainStencilFaceState,
+  PlainStencilState,
   RasterizerState,
   StencilFaceState,
   StencilState,
   Topology,
 } from "./pipelineState.js";
 
+export { PipelineState } from "./pipelineState.js";
+
 export type {
   RenderObject,
 } from "./renderObject.js";