@aardworx/wombat.rendering 0.1.0 → 0.1.1

package/dist/resources/shaderDiagnostics.js

@@ -0,0 +1,40 @@
+// Shader-compile error reporting. WebGPU's `createShaderModule`
+// is synchronous and never throws on parse errors; the errors
+// surface only via `module.getCompilationInfo()`, which is async.
+// We fire-and-forget that call after creation and log structured
+// messages including the originating TS source location decoded
+// from the supplied source map.
+import { decodeLine } from "./sourceMapDecoder.js";
+export function installShaderDiagnostics(module, source, opts = {}) {
+    // getCompilationInfo is part of the WebGPU spec; some test mocks
+    // may not implement it. Detect and skip silently.
+    const info = module.getCompilationInfo;
+    if (typeof info !== "function")
+        return;
+    const log = opts.logger ?? console;
+    const tag = opts.label ?? "shader";
+    info.call(module).then((compInfo) => {
+        if (compInfo.messages.length === 0)
+            return;
+        const map = opts.sourceMap ?? null;
+        for (const m of compInfo.messages) {
+            const lineText = source.split("\n")[Math.max(0, m.lineNum - 1)] ?? "";
+            const head = `[${tag}] ${m.type} ${m.lineNum}:${m.linePos}: ${m.message}`;
+            const body = lineText.length > 0 ? `\n  ${lineText.trim()}` : "";
+            const decoded = map ? decodeLine(map, m.lineNum) : null;
+            const origin = decoded
+                ? `\n  → ${decoded.file}:${decoded.line}:${decoded.column}`
+                : (map && map.sources.length > 0
+                    ? `\n  (originated in ${map.sources.join(", ")})`
+                    : "");
+            const line = `${head}${body}${origin}`;
+            if (m.type === "error")
+                log.error(line);
+            else
+                log.warn(line);
+        }
+    }).catch(() => {
+        // Mock environments / older browsers may reject; silent swallow.
+    });
+}
+//# sourceMappingURL=shaderDiagnostics.js.map

package/dist/resources/shaderDiagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shaderDiagnostics.js","sourceRoot":"","sources":["../../src/resources/shaderDiagnostics.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,8DAA8D;AAC9D,kEAAkE;AAClE,iEAAiE;AACjE,gEAAgE;AAChE,gCAAgC;AAGhC,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAWnD,MAAM,UAAU,wBAAwB,CACtC,MAAuB,EACvB,MAAc,EACd,OAAiC,EAAE;IAEnC,iEAAiE;IACjE,kDAAkD;IAClD,MAAM,IAAI,GAAI,MAAqE,CAAC,kBAAkB,CAAC;IACvG,IAAI,OAAO,IAAI,KAAK,UAAU;QAAE,OAAO;IACvC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC;IACnC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC;IAEnC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;QAClC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC;QACnC,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YAClC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACtE,MAAM,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;YAC1E,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjE,MAAM,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACxD,MAAM,MAAM,GAAG,OAAO;gBACpB,CAAC,CAAC,SAAS,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE;gBAC3D,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;oBAC9B,CAAC,CAAC,sBAAsB,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;oBACjD,CAAC,CAAC,EAAE,CAAC,CAAC;YACV,MAAM,IAAI,GAAG,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,EAAE,CAAC;YACvC,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO;gBAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;;gBACnC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;IACH,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;QACZ,iEAAiE;IACnE,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/resources/sourceMapDecoder.d.ts

@@ -0,0 +1,23 @@
+import type { SourceMap } from "@aardworx/wombat.shader/ir";
+export interface DecodedPosition {
+    /** Source file as listed in `SourceMap.sources`. */
+    readonly file: string;
+    /** 1-based line in the original source. */
+    readonly line: number;
+    /** 1-based column in the original source. */
+    readonly column: number;
+}
+/**
+ * Closest-preceding-segment lookup. Given a 1-based generated
+ * `line` + 0-based generated `col`, returns the originating source
+ * position. Falls back to the last segment on a previous mapped
+ * line if `line` itself has no segments.
+ */
+export declare function decodePosition(map: SourceMap, generatedLine: number, generatedCol?: number): DecodedPosition | null;
+/**
+ * Backwards-compatible line-only decoder: returns the *first*
+ * segment of `generatedLine`, or the most recent mapped line for
+ * unmapped lines. Equivalent to `decodePosition(map, line, 0)`.
+ */
+export declare function decodeLine(map: SourceMap, generatedLine: number): DecodedPosition | null;
+//# sourceMappingURL=sourceMapDecoder.d.ts.map

package/dist/resources/sourceMapDecoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceMapDecoder.d.ts","sourceRoot":"","sources":["../../src/resources/sourceMapDecoder.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AA+B5D,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAyCD;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,SAAS,EACd,aAAa,EAAE,MAAM,EACrB,YAAY,SAAI,GACf,eAAe,GAAG,IAAI,CAqBxB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAExF"}

package/dist/resources/sourceMapDecoder.js

@@ -0,0 +1,116 @@
+// Decoder for v3 source maps. Supports both line-granular maps
+// (one segment per generated line at col 0) and multi-segment
+// lines (per-Expr granularity). Segments encode
+// (genColDelta, sourceIdxDelta, sourceLineDelta, sourceColDelta)
+// as base64-VLQ, with deltas accumulating across the whole map
+// except for genCol which resets at every `;` line boundary.
+//
+// `decodeLine(map, line)` returns the position for the *first*
+// segment on the line; `decodePosition(map, line, col)` picks the
+// closest preceding segment. Both fall back to the most recent
+// mapped line if the queried line is unmapped, which is what
+// `installShaderDiagnostics` wants for "go to source" navigation.
+const VLQ_INDEX = new Map();
+{
+    const a = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+    for (let i = 0; i < a.length; i++)
+        VLQ_INDEX.set(a.charAt(i), i);
+}
+function vlqDecode(s) {
+    const out = [];
+    let value = 0;
+    let shift = 0;
+    for (let i = 0; i < s.length; i++) {
+        const ch = s.charAt(i);
+        const digit = VLQ_INDEX.get(ch);
+        if (digit === undefined)
+            throw new Error(`bad VLQ char: ${ch}`);
+        const cont = (digit & 0b100000) !== 0;
+        value |= (digit & 0b11111) << shift;
+        if (cont) {
+            shift += 5;
+        }
+        else {
+            const negative = (value & 1) === 1;
+            const magnitude = value >>> 1;
+            out.push(negative ? -magnitude : magnitude);
+            value = 0;
+            shift = 0;
+        }
+    }
+    return out;
+}
+/** Walk the map up to (and including) `targetLine`, returning each line's segments. */
+function segmentsUpTo(map, targetLine) {
+    const lines = map.mappings.split(";");
+    const out = [];
+    let srcIdx = 0;
+    let srcLine = 0;
+    let srcCol = 0;
+    for (let i = 0; i <= targetLine && i < lines.length; i++) {
+        const segs = (lines[i] ?? "").split(",").filter(s => s.length > 0);
+        let prevGenCol = 0;
+        const lineOut = [];
+        for (const sStr of segs) {
+            const fields = vlqDecode(sStr);
+            if (fields.length < 4)
+                continue;
+            const genCol = prevGenCol + fields[0];
+            srcIdx += fields[1];
+            srcLine += fields[2];
+            srcCol += fields[3];
+            lineOut.push({ genCol, idx: srcIdx, line: srcLine, col: srcCol });
+            prevGenCol = genCol;
+        }
+        out.push(lineOut);
+    }
+    return out;
+}
+function makePosition(map, s) {
+    const file = map.sources[s.idx];
+    if (file === undefined)
+        return null;
+    return { file, line: s.line + 1, column: s.col + 1 };
+}
+/**
+ * Closest-preceding-segment lookup. Given a 1-based generated
+ * `line` + 0-based generated `col`, returns the originating source
+ * position. Falls back to the last segment on a previous mapped
+ * line if `line` itself has no segments.
+ */
+export function decodePosition(map, generatedLine, generatedCol = 0) {
+    const target = generatedLine - 1;
+    if (target < 0)
+        return null;
+    const allLines = segmentsUpTo(map, target);
+    // Prefer a segment on the target line at or before generatedCol.
+    const onTarget = allLines[target];
+    if (onTarget && onTarget.length > 0) {
+        let pick;
+        for (const s of onTarget) {
+            if (s.genCol <= generatedCol)
+                pick = s;
+            else
+                break;
+        }
+        if (pick)
+            return makePosition(map, pick);
+        return makePosition(map, onTarget[0]);
+    }
+    // Fallback: last segment on the most recent mapped line.
+    for (let i = target - 1; i >= 0; i--) {
+        const segs = allLines[i];
+        if (segs && segs.length > 0)
+            return makePosition(map, segs[segs.length - 1]);
+    }
+    return null;
+}
+/**
+ * Backwards-compatible line-only decoder: returns the *first*
+ * segment of `generatedLine`, or the most recent mapped line for
+ * unmapped lines. Equivalent to `decodePosition(map, line, 0)`.
+ */
+export function decodeLine(map, generatedLine) {
+    return decodePosition(map, generatedLine, 0);
+}
+//# sourceMappingURL=sourceMapDecoder.js.map

package/dist/resources/sourceMapDecoder.js.map

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

package/dist/resources/uniformBuffer.d.ts

@@ -0,0 +1,23 @@
+import { AdaptiveResource, type UniformBlockInfo } from "../core/index.js";
+import { type aval, type HashMap } from "@aardworx/wombat.adaptive";
+export interface PackedView {
+    readonly bytes: ArrayBuffer;
+    readonly f32: Float32Array;
+    readonly i32: Int32Array;
+    readonly u32: Uint32Array;
+}
+export declare function makePackedView(byteSize: number): PackedView;
+/**
+ * Write a value into a UBO scratch buffer at the given byte offset.
+ * `fieldType`, when supplied, disambiguates a bare `number`:
+ *   - Int (signed)    → i32
+ *   - Int (unsigned)  → u32
+ *   - Float (default) → f32
+ * Without it, numbers are assumed to be f32.
+ */
+export declare function writeField(view: PackedView, offset: number, value: unknown, fieldType?: import("../core/index.js").UniformFieldInfo["type"]): void;
+export interface PrepareUniformBufferOptions {
+    readonly label?: string;
+}
+export declare function prepareUniformBuffer(device: GPUDevice, layout: UniformBlockInfo, inputs: HashMap<string, aval<unknown>>, opts?: PrepareUniformBufferOptions): AdaptiveResource<GPUBuffer>;
+//# sourceMappingURL=uniformBuffer.d.ts.map

package/dist/resources/uniformBuffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniformBuffer.d.ts","sourceRoot":"","sources":["../../src/resources/uniformBuffer.ts"],"names":[],"mappings":"AAqBA,OAAO,EACL,gBAAgB,EAGhB,KAAK,gBAAgB,EACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAEL,KAAK,IAAI,EACT,KAAK,OAAO,EACb,MAAM,2BAA2B,CAAC;AAGnC,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;CAC3B;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAQ3D;AA6DD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,EACd,SAAS,CAAC,EAAE,OAAO,kBAAkB,EAAE,gBAAgB,CAAC,MAAM,CAAC,GAC9D,IAAI,CA6BN;AAMD,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,EACtC,IAAI,GAAE,2BAAgC,GACrC,gBAAgB,CAAC,SAAS,CAAC,CAE7B"}

package/dist/resources/uniformBuffer.js

@@ -0,0 +1,149 @@
+// prepareUniformBuffer — pack a name-keyed bag of `aval<unknown>`
+// uniforms into a single UBO described by a `UniformBlockInfo`
+// (from wombat.shader's ProgramInterface).
+//
+// The layout dictates byte offsets + sizes per field; this packer
+// trusts those numbers and just encodes values into a Float32-
+// addressable scratch buffer, then uploads via `queue.writeBuffer`
+// on each change.
+//
+// Value encoding by type:
+//   - `number`             → 1 × f32 at offset
+//   - `Float32Array`       → memcpy floats
+//   - `Int32Array`/`Uint32Array` → memcpy as-is (also valid for f32 storage)
+//   - any object with `_data: Float32Array | Int32Array | Uint32Array`
+//     (V2f/V3f/V4f/M44f/M33f/M22f, etc. from wombat.base) → memcpy `_data`
+//
+// Missing inputs (a layout field with no corresponding entry in
+// the bag) are left zero-initialised. Extras in the bag are
+// silently ignored — same "pull, don't push" semantics as the
+// rest of the renderer.
+import { AdaptiveResource, tryAcquire, tryRelease, } from "../core/index.js";
+import {} from "@aardworx/wombat.adaptive";
+import { BufferUsage } from "./webgpuFlags.js";
+export function makePackedView(byteSize) {
+    const bytes = new ArrayBuffer(roundUp4(byteSize));
+    return {
+        bytes,
+        f32: new Float32Array(bytes),
+        i32: new Int32Array(bytes),
+        u32: new Uint32Array(bytes),
+    };
+}
+class UniformBufferResource extends AdaptiveResource {
+    device;
+    layout;
+    inputs;
+    label;
+    _gpu;
+    _scratch;
+    constructor(device, layout, inputs, label) {
+        super();
+        this.device = device;
+        this.layout = layout;
+        this.inputs = inputs;
+        this.label = label;
+        const bytes = new ArrayBuffer(roundUp4(layout.size));
+        this._scratch = {
+            bytes,
+            f32: new Float32Array(bytes),
+            i32: new Int32Array(bytes),
+            u32: new Uint32Array(bytes),
+        };
+    }
+    create() {
+        for (const f of this.layout.fields) {
+            const av = this.inputs.tryFind(f.name);
+            if (av !== undefined)
+                tryAcquire(av);
+        }
+    }
+    destroy() {
+        if (this._gpu !== undefined) {
+            this._gpu.destroy();
+            this._gpu = undefined;
+        }
+        for (const f of this.layout.fields) {
+            const av = this.inputs.tryFind(f.name);
+            if (av !== undefined)
+                tryRelease(av);
+        }
+    }
+    compute(token) {
+        // Pack scratch.
+        new Uint8Array(this._scratch.bytes).fill(0);
+        for (const field of this.layout.fields) {
+            const av = this.inputs.tryFind(field.name);
+            if (av === undefined)
+                continue;
+            writeField(this._scratch, field.offset, av.getValue(token));
+        }
+        if (this._gpu === undefined) {
+            const desc = {
+                size: this._scratch.bytes.byteLength,
+                usage: BufferUsage.UNIFORM | BufferUsage.COPY_DST,
+                ...(this.label !== undefined ? { label: this.label } : {}),
+            };
+            this._gpu = this.device.createBuffer(desc);
+        }
+        this.device.queue.writeBuffer(this._gpu, 0, this._scratch.bytes);
+        return this._gpu;
+    }
+}
+/**
+ * Write a value into a UBO scratch buffer at the given byte offset.
+ * `fieldType`, when supplied, disambiguates a bare `number`:
+ *   - Int (signed)    → i32
+ *   - Int (unsigned)  → u32
+ *   - Float (default) → f32
+ * Without it, numbers are assumed to be f32.
+ */
+export function writeField(view, offset, value, fieldType) {
+    if (typeof value === "number") {
+        if (fieldType?.kind === "Int") {
+            if (fieldType.signed)
+                view.i32[offset >> 2] = value;
+            else
+                view.u32[offset >> 2] = value;
+        }
+        else {
+            view.f32[offset >> 2] = value;
+        }
+        return;
+    }
+    if (value instanceof Float32Array) {
+        view.f32.set(value, offset >> 2);
+        return;
+    }
+    if (value instanceof Int32Array) {
+        view.i32.set(value, offset >> 2);
+        return;
+    }
+    if (value instanceof Uint32Array) {
+        view.u32.set(value, offset >> 2);
+        return;
+    }
+    if (value !== null && typeof value === "object" && "_data" in value) {
+        const data = value._data;
+        if (data instanceof Float32Array) {
+            view.f32.set(data, offset >> 2);
+            return;
+        }
+        if (data instanceof Int32Array) {
+            view.i32.set(data, offset >> 2);
+            return;
+        }
+        if (data instanceof Uint32Array) {
+            view.u32.set(data, offset >> 2);
+            return;
+        }
+    }
+    throw new Error(`prepareUniformBuffer: unsupported uniform value at offset ${offset}: ${String(value)}`);
+}
+function roundUp4(n) {
+    return (n + 3) & ~3;
+}
+export function prepareUniformBuffer(device, layout, inputs, opts = {}) {
+    return new UniformBufferResource(device, layout, inputs, opts.label);
+}
+//# sourceMappingURL=uniformBuffer.js.map

package/dist/resources/uniformBuffer.js.map

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

package/dist/resources/webgpuFlags.d.ts

@@ -0,0 +1,32 @@
+export declare const BufferUsage: {
+    readonly MAP_READ: 1;
+    readonly MAP_WRITE: 2;
+    readonly COPY_SRC: 4;
+    readonly COPY_DST: 8;
+    readonly INDEX: 16;
+    readonly VERTEX: 32;
+    readonly UNIFORM: 64;
+    readonly STORAGE: 128;
+    readonly INDIRECT: 256;
+    readonly QUERY_RESOLVE: 512;
+};
+export declare const TextureUsage: {
+    readonly COPY_SRC: 1;
+    readonly COPY_DST: 2;
+    readonly TEXTURE_BINDING: 4;
+    readonly STORAGE_BINDING: 8;
+    readonly RENDER_ATTACHMENT: 16;
+};
+export declare const ShaderStage: {
+    readonly VERTEX: 1;
+    readonly FRAGMENT: 2;
+    readonly COMPUTE: 4;
+};
+export declare const ColorWrite: {
+    readonly RED: 1;
+    readonly GREEN: 2;
+    readonly BLUE: 4;
+    readonly ALPHA: 8;
+    readonly ALL: 15;
+};
+//# sourceMappingURL=webgpuFlags.d.ts.map

package/dist/resources/webgpuFlags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webgpuFlags.d.ts","sourceRoot":"","sources":["../../src/resources/webgpuFlags.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,WAAW;;;;;;;;;;;CAWd,CAAC;AAEX,eAAO,MAAM,YAAY;;;;;;CAMf,CAAC;AAEX,eAAO,MAAM,WAAW;;;;CAId,CAAC;AAEX,eAAO,MAAM,UAAU;;;;;;CAMb,CAAC"}

package/dist/resources/webgpuFlags.js

@@ -0,0 +1,40 @@
+// `GPUBufferUsage` / `GPUTextureUsage` / `GPUMapMode` etc. are
+// runtime-provided in the browser and Dawn-Node, but `@webgpu/types`
+// is a types-only package — the constants don't exist when running
+// under plain Node (vitest). Vendor the flag values here so the
+// resource layer can compose usage flags portably.
+//
+// Numbers are taken from the WebGPU spec. They are part of the
+// stable API surface.
+export const BufferUsage = {
+    MAP_READ: 0x0001,
+    MAP_WRITE: 0x0002,
+    COPY_SRC: 0x0004,
+    COPY_DST: 0x0008,
+    INDEX: 0x0010,
+    VERTEX: 0x0020,
+    UNIFORM: 0x0040,
+    STORAGE: 0x0080,
+    INDIRECT: 0x0100,
+    QUERY_RESOLVE: 0x0200,
+};
+export const TextureUsage = {
+    COPY_SRC: 0x01,
+    COPY_DST: 0x02,
+    TEXTURE_BINDING: 0x04,
+    STORAGE_BINDING: 0x08,
+    RENDER_ATTACHMENT: 0x10,
+};
+export const ShaderStage = {
+    VERTEX: 0x1,
+    FRAGMENT: 0x2,
+    COMPUTE: 0x4,
+};
+export const ColorWrite = {
+    RED: 0x1,
+    GREEN: 0x2,
+    BLUE: 0x4,
+    ALPHA: 0x8,
+    ALL: 0xf,
+};
+//# sourceMappingURL=webgpuFlags.js.map

package/dist/resources/webgpuFlags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webgpuFlags.js","sourceRoot":"","sources":["../../src/resources/webgpuFlags.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,qEAAqE;AACrE,mEAAmE;AACnE,gEAAgE;AAChE,mDAAmD;AACnD,EAAE;AACF,+DAA+D;AAC/D,sBAAsB;AAEtB,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,QAAQ,EAAE,MAAM;IAChB,SAAS,EAAE,MAAM;IACjB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,OAAO,EAAE,MAAM;IACf,OAAO,EAAE,MAAM;IACf,QAAQ,EAAE,MAAM;IAChB,aAAa,EAAE,MAAM;CACb,CAAC;AAEX,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,QAAQ,EAAE,IAAI;IACd,QAAQ,EAAE,IAAI;IACd,eAAe,EAAE,IAAI;IACrB,eAAe,EAAE,IAAI;IACrB,iBAAiB,EAAE,IAAI;CACf,CAAC;AAEX,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,MAAM,EAAE,GAAG;IACX,QAAQ,EAAE,GAAG;IACb,OAAO,EAAE,GAAG;CACJ,CAAC;AAEX,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,GAAG,EAAE,GAAG;IACR,KAAK,EAAE,GAAG;IACV,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,GAAG;IACV,GAAG,EAAE,GAAG;CACA,CAAC"}

package/dist/runtime/copy.d.ts

@@ -0,0 +1,3 @@
+import type { CopySpec } from "../core/index.js";
+export declare function copy(cmd: GPUCommandEncoder, spec: CopySpec): void;
+//# sourceMappingURL=copy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"copy.d.ts","sourceRoot":"","sources":["../../src/runtime/copy.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,wBAAgB,IAAI,CAAC,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,CAOjE"}

package/dist/runtime/copy.js

@@ -0,0 +1,12 @@
+// copy(cmd, spec) — encode a buffer↔buffer or texture↔texture
+// transfer described by a `CopySpec`.
+export function copy(cmd, spec) {
+    if (spec.kind === "buffer") {
+        const range = spec.range ?? { srcOffset: 0, dstOffset: 0, size: spec.src.size };
+        cmd.copyBufferToBuffer(spec.src, range.srcOffset, spec.dst, range.dstOffset, range.size);
+    }
+    else {
+        cmd.copyTextureToTexture(spec.src, spec.dst, spec.size);
+    }
+}
+//# sourceMappingURL=copy.js.map

package/dist/runtime/copy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy.js","sourceRoot":"","sources":["../../src/runtime/copy.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,sCAAsC;AAItC,MAAM,UAAU,IAAI,CAAC,GAAsB,EAAE,IAAc;IACzD,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAChF,GAAG,CAAC,kBAAkB,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3F,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,oBAAoB,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC"}

package/dist/runtime/index.d.ts

@@ -0,0 +1,6 @@
+export { Runtime, type RuntimeOptions, } from "./runtime.js";
+export { compileRenderTask, type RuntimeContext, } from "./renderTask.js";
+export { copy } from "./copy.js";
+export { renderTo, type RenderToOptions, type RenderToResult, } from "./renderTo.js";
+export { ScenePass, type WalkerStats, } from "./scenePass.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,OAAO,EACP,KAAK,cAAc,GACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,iBAAiB,EACjB,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EACL,QAAQ,EACR,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,SAAS,EACT,KAAK,WAAW,GACjB,MAAM,gBAAgB,CAAC"}

package/dist/runtime/index.js

@@ -0,0 +1,7 @@
+// Public API of @aardworx/wombat.rendering-runtime.
+export { Runtime, } from "./runtime.js";
+export { compileRenderTask, } from "./renderTask.js";
+export { copy } from "./copy.js";
+export { renderTo, } from "./renderTo.js";
+export { ScenePass, } from "./scenePass.js";
+//# sourceMappingURL=index.js.map

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