@aardworx/wombat.rendering 0.1.0 → 0.2.0

package/dist/resources/renderPipeline.js

@@ -0,0 +1,102 @@
+// compileRenderPipeline — produce a `GPURenderPipeline` from a
+// description and memoize per-device. Pipeline state is treated
+// as static (not adaptive); when the user wants pipeline switching
+// at runtime they should construct multiple PreparedRenderObjects
+// and pick between them at the RenderTree level.
+//
+// The descriptor is intentionally low-level: all the hard work of
+// turning a `CompiledEffect` + `ProgramInterface` + `PipelineState`
+// + `FramebufferSignature` into a GPUVertexBufferLayout[] /
+// GPUBindGroupLayout[] / GPUColorTargetState[] etc. lives in
+// `prepareRenderObject`. This function is just the caching layer
+// over `device.createRenderPipeline`.
+import { installShaderDiagnostics } from "./shaderDiagnostics.js";
+const caches = new WeakMap();
+function cacheFor(device) {
+    let c = caches.get(device);
+    if (c === undefined) {
+        c = { modules: new Map(), pipelines: new Map() };
+        caches.set(device, c);
+    }
+    return c;
+}
+function moduleFor(device, source, label, sourceMap) {
+    const cache = cacheFor(device);
+    let m = cache.modules.get(source);
+    if (m === undefined) {
+        m = device.createShaderModule({ code: source, ...(label !== undefined ? { label } : {}) });
+        cache.modules.set(source, m);
+        installShaderDiagnostics(m, source, {
+            ...(label !== undefined ? { label } : {}),
+            ...(sourceMap !== undefined && sourceMap !== null ? { sourceMap } : {}),
+        });
+    }
+    return m;
+}
+export function compileRenderPipeline(device, desc) {
+    const cache = cacheFor(device);
+    const k = pipelineKey(desc);
+    let p = cache.pipelines.get(k);
+    if (p !== undefined)
+        return p;
+    const vsModule = moduleFor(device, desc.vertexShaderSource, desc.label ? `${desc.label}.vs` : undefined, desc.vertexSourceMap);
+    const fsModule = desc.vertexShaderSource === desc.fragmentShaderSource
+        ? vsModule
+        : moduleFor(device, desc.fragmentShaderSource, desc.label ? `${desc.label}.fs` : undefined, desc.fragmentSourceMap);
+    const layout = device.createPipelineLayout({
+        bindGroupLayouts: desc.bindGroupLayouts,
+        ...(desc.label !== undefined ? { label: `${desc.label}.layout` } : {}),
+    });
+    const pdesc = {
+        layout,
+        vertex: {
+            module: vsModule,
+            entryPoint: desc.vertexEntryPoint,
+            buffers: desc.vertexBufferLayouts,
+        },
+        fragment: {
+            module: fsModule,
+            entryPoint: desc.fragmentEntryPoint,
+            targets: desc.colorTargets,
+        },
+        primitive: desc.primitive,
+        ...(desc.depthStencil !== undefined ? { depthStencil: desc.depthStencil } : {}),
+        ...(desc.multisample !== undefined ? { multisample: desc.multisample } : {}),
+        ...(desc.label !== undefined ? { label: desc.label } : {}),
+    };
+    p = device.createRenderPipeline(pdesc);
+    cache.pipelines.set(k, p);
+    return p;
+}
+function pipelineKey(d) {
+    // Strong identity component: prefer `effectId` (wombat.shader's
+    // build-time stable hash); fall back to FNV-hashing the shader
+    // source for hand-built effects. The rest of the descriptor is
+    // small enough to JSON-stringify.
+    const ident = d.effectId !== undefined
+        ? d.effectId
+        : `${hashString(d.vertexShaderSource)}/${hashString(d.fragmentShaderSource)}`;
+    const slim = {
+        id: ident,
+        vEntry: d.vertexEntryPoint,
+        fEntry: d.fragmentEntryPoint,
+        vb: d.vertexBufferLayouts,
+        bgl: d.bindGroupLayouts.length,
+        ct: d.colorTargets,
+        ds: d.depthStencil,
+        pr: d.primitive,
+        ms: d.multisample,
+    };
+    return JSON.stringify(slim);
+}
+function hashString(s) {
+    // FNV-1a 32-bit; collision risk is negligible for our purposes
+    // and the cost is one call per uncached pipeline.
+    let h = 0x811c9dc5;
+    for (let i = 0; i < s.length; i++) {
+        h ^= s.charCodeAt(i);
+        h = Math.imul(h, 0x01000193);
+    }
+    return h >>> 0;
+}
+//# sourceMappingURL=renderPipeline.js.map

package/dist/resources/renderPipeline.js.map

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

package/dist/resources/shaderDiagnostics.d.ts

@@ -0,0 +1,14 @@
+import type { SourceMap } from "@aardworx/wombat.shader/ir";
+export interface ShaderDiagnosticsOptions {
+    /** Human-friendly tag prefixed to log messages. */
+    readonly label?: string;
+    /** Source map produced by wombat.shader for this stage. */
+    readonly sourceMap?: SourceMap | null;
+    /** Optional override for the logger. Default: console. */
+    readonly logger?: {
+        error(...args: unknown[]): void;
+        warn(...args: unknown[]): void;
+    };
+}
+export declare function installShaderDiagnostics(module: GPUShaderModule, source: string, opts?: ShaderDiagnosticsOptions): void;
+//# sourceMappingURL=shaderDiagnostics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shaderDiagnostics.d.ts","sourceRoot":"","sources":["../../src/resources/shaderDiagnostics.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAG5D,MAAM,WAAW,wBAAwB;IACvC,mDAAmD;IACnD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IACtC,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAAC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;KAAE,CAAC;CACvF;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,wBAA6B,GAClC,IAAI,CA4BN"}

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":"AAAA,kEAAkE;AAClE,+DAA+D;AAC/D,2CAA2C;AAC3C,EAAE;AACF,kEAAkE;AAClE,+DAA+D;AAC/D,mEAAmE;AACnE,kBAAkB;AAClB,EAAE;AACF,0BAA0B;AAC1B,+CAA+C;AAC/C,2CAA2C;AAC3C,6EAA6E;AAC7E,uEAAuE;AACvE,2EAA2E;AAC3E,EAAE;AACF,gEAAgE;AAChE,4DAA4D;AAC5D,8DAA8D;AAC9D,wBAAwB;AAExB,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,UAAU,GAEX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAIN,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAS/C,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClD,OAAO;QACL,KAAK;QACL,GAAG,EAAE,IAAI,YAAY,CAAC,KAAK,CAAC;QAC5B,GAAG,EAAE,IAAI,UAAU,CAAC,KAAK,CAAC;QAC1B,GAAG,EAAE,IAAI,WAAW,CAAC,KAAK,CAAC;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,qBAAsB,SAAQ,gBAA2B;IAK1C;IACA;IACA;IACA;IAPX,IAAI,CAAwB;IACnB,QAAQ,CAAa;IAEtC,YACmB,MAAiB,EACjB,MAAwB,EACxB,MAAsC,EACtC,KAAyB;QAE1C,KAAK,EAAE,CAAC;QALS,WAAM,GAAN,MAAM,CAAW;QACjB,WAAM,GAAN,MAAM,CAAkB;QACxB,WAAM,GAAN,MAAM,CAAgC;QACtC,UAAK,GAAL,KAAK,CAAoB;QAG1C,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACrD,IAAI,CAAC,QAAQ,GAAG;YACd,KAAK;YACL,GAAG,EAAE,IAAI,YAAY,CAAC,KAAK,CAAC;YAC5B,GAAG,EAAE,IAAI,UAAU,CAAC,KAAK,CAAC;YAC1B,GAAG,EAAE,IAAI,WAAW,CAAC,KAAK,CAAC;SAC5B,CAAC;IACJ,CAAC;IAES,MAAM;QACd,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,EAAE,KAAK,SAAS;gBAAE,UAAU,CAAC,EAAE,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAES,OAAO;QACf,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5B,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACpB,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QACxB,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,EAAE,KAAK,SAAS;gBAAE,UAAU,CAAC,EAAE,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAEQ,OAAO,CAAC,KAAoB;QACnC,gBAAgB;QAChB,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACvC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3C,IAAI,EAAE,KAAK,SAAS;gBAAE,SAAS;YAC/B,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAwB;gBAChC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU;gBACpC,KAAK,EAAE,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,QAAQ;gBACjD,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC3D,CAAC;YACF,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAC7C,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACjE,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CACxB,IAAgB,EAChB,MAAc,EACd,KAAc,EACd,SAA+D;IAE/D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,SAAS,EAAE,IAAI,KAAK,KAAK,EAAE,CAAC;YAC9B,IAAI,SAAS,CAAC,MAAM;gBAAE,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC;;gBAC/C,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC;QACrC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC;QAChC,CAAC;QACD,OAAO;IACT,CAAC;IACD,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;QAClC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;QACjC,OAAO;IACT,CAAC;IACD,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;QACjC,OAAO;IACT,CAAC;IACD,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;QACjC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;QACjC,OAAO;IACT,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,IAAK,KAAgB,EAAE,CAAC;QAChF,MAAM,IAAI,GAAI,KAA4B,CAAC,KAAK,CAAC;QACjD,IAAI,IAAI,YAAY,YAAY,EAAE,CAAC;YAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;YAAC,OAAO;QAAC,CAAC;QAC9E,IAAI,IAAI,YAAY,UAAU,EAAI,CAAC;YAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;YAAC,OAAO;QAAC,CAAC;QAC9E,IAAI,IAAI,YAAY,WAAW,EAAG,CAAC;YAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;YAAC,OAAO;QAAC,CAAC;IAChF,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,6DAA6D,MAAM,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAC3G,CAAC;AAED,SAAS,QAAQ,CAAC,CAAS;IACzB,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACtB,CAAC;AAMD,MAAM,UAAU,oBAAoB,CAClC,MAAiB,EACjB,MAAwB,EACxB,MAAsC,EACtC,OAAoC,EAAE;IAEtC,OAAO,IAAI,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;AACvE,CAAC"}

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