@aardworx/wombat.rendering 0.1.0 → 0.2.0

package/dist/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,oDAAoD;AAEpD,OAAO,EACL,OAAO,GAER,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,iBAAiB,GAElB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EACL,QAAQ,GAGT,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,SAAS,GAEV,MAAM,gBAAgB,CAAC"}

package/dist/runtime/renderTask.d.ts

@@ -0,0 +1,10 @@
+import { type Command, type CompiledEffect, type Effect, type IRenderTask } from "../core/index.js";
+import { AdaptiveToken, type alist } from "@aardworx/wombat.adaptive";
+export interface RuntimeContext {
+    readonly device: GPUDevice;
+    readonly compileEffect: (effect: Effect) => CompiledEffect;
+}
+export declare function compileRenderTask(ctx: RuntimeContext, commands: alist<Command>): IRenderTask & {
+    encode(enc: GPUCommandEncoder, token: AdaptiveToken): void;
+};
+//# sourceMappingURL=renderTask.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"renderTask.d.ts","sourceRoot":"","sources":["../../src/runtime/renderTask.ts"],"names":[],"mappings":"AAcA,OAAO,EAGL,KAAK,OAAO,EACZ,KAAK,cAAc,EACnB,KAAK,MAAM,EAEX,KAAK,WAAW,EAEjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,aAAa,EAAE,KAAK,KAAK,EAAa,MAAM,2BAA2B,CAAC;AAIjF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,cAAc,CAAC;CAC5D;AA+FD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,cAAc,EAAE,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,WAAW,GAAG;IAC9F,MAAM,CAAC,GAAG,EAAE,iBAAiB,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;CAC5D,CAEA"}

package/dist/runtime/renderTask.js

@@ -0,0 +1,119 @@
+// RenderTask — compile an `alist<Command>` into a runnable
+// IRenderTask.
+//
+// Per `Render` command we lazily build a `ScenePass` that holds a
+// stateful tree-walker subscribed to the dynamic subtrees
+// (`Adaptive` / `OrderedFromList` / `UnorderedFromSet`). Each frame:
+//   - The walker pulls deltas from its readers (O(deltas) work).
+//   - It produces the ordered list of `PreparedRenderObject`s.
+//   - We open the render pass and call `record(pass, token)` per leaf.
+//
+// The previous per-frame `collectLeaves` recursion through the tree
+// is gone. Static subtrees prep their leaves once at construction;
+// dynamic subtrees splice on delta — see scenePass.ts.
+import { RenderContext, } from "../core/index.js";
+import { beginPassDescriptor, clear } from "../commands/index.js";
+import { AdaptiveToken } from "@aardworx/wombat.adaptive";
+import { copy } from "./copy.js";
+import { ScenePass } from "./scenePass.js";
+class RenderTask {
+    ctx;
+    commands;
+    /**
+     * Cache of `ScenePass`es keyed on the `Render` command itself.
+     * Holding ScenePass per command means the same `RenderTree`
+     * reused across frames keeps its incrementally-maintained
+     * walker state.
+     */
+    _scenes = new Map();
+    _disposed = false;
+    constructor(ctx, commands) {
+        this.ctx = ctx;
+        this.commands = commands;
+    }
+    run(token) {
+        if (this._disposed)
+            throw new Error("RenderTask: run after dispose");
+        const enc = this.ctx.device.createCommandEncoder();
+        this.encode(enc, token);
+        this.ctx.device.queue.submit([enc.finish()]);
+    }
+    encode(enc, token) {
+        if (this._disposed)
+            throw new Error("RenderTask: encode after dispose");
+        RenderContext.withEncoder(enc, () => {
+            const arr = [];
+            for (const c of this.commands.content.getValue(token))
+                arr.push(c);
+            for (let i = 0; i < arr.length; i++) {
+                const c = arr[i];
+                if (c.kind === "Clear") {
+                    const next = arr[i + 1];
+                    if (next !== undefined && next.kind === "Render" && next.output === c.output) {
+                        this.encodeRenderCommand(enc, next, token, c.values);
+                        i++;
+                        continue;
+                    }
+                }
+                this.encodeCommand(enc, c, token);
+            }
+        });
+    }
+    dispose() {
+        if (this._disposed)
+            return;
+        for (const s of this._scenes.values())
+            s.dispose();
+        this._scenes.clear();
+        this._disposed = true;
+    }
+    encodeCommand(enc, c, token) {
+        switch (c.kind) {
+            case "Clear":
+                clear(enc, c.output.getValue(token), c.values);
+                return;
+            case "Copy":
+                copy(enc, c.copy);
+                return;
+            case "Custom":
+                c.encode(enc);
+                return;
+            case "Render":
+                this.encodeRenderCommand(enc, c, token);
+                return;
+        }
+    }
+    encodeRenderCommand(enc, cmd, token, clearValues) {
+        const output = cmd.output.getValue(token);
+        const scene = this.sceneFor(cmd, output, cmd.tree);
+        const leaves = scene.resolve(token);
+        if (leaves.length === 0 && clearValues === undefined)
+            return;
+        // Either we have draws or we need to clear — open a single pass.
+        const pass = enc.beginRenderPass(beginPassDescriptor(output, clearValues));
+        for (const leaf of leaves)
+            leaf.record(pass, token);
+        pass.end();
+    }
+    sceneFor(cmd, output, tree) {
+        let s = this._scenes.get(cmd);
+        if (s === undefined) {
+            s = new ScenePass(this.ctx.device, output.signature, tree, this.ctx.compileEffect);
+            this._scenes.set(cmd, s);
+        }
+        return s;
+        // Note: `output.signature` is read here only to seed the
+        // ScenePass; subsequent frames continue to use this signature
+        // even if the framebuffer aval emits a different sig. That
+        // matches the `(RenderObject, signature)` cache invariant —
+        // changing signature requires a fresh Render command.
+    }
+}
+export function compileRenderTask(ctx, commands) {
+    return new RenderTask(ctx, commands);
+}
+// `RenderTree` carries an `aval<RenderTree>` inside its `Adaptive`
+// variant; this `void` reference keeps the `aval` import live.
+const _avalGuard = undefined;
+void _avalGuard;
+//# sourceMappingURL=renderTask.js.map

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;AAkMD,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"}