@aardworx/wombat.rendering 0.8.1 → 0.9.1

package/dist/runtime/derivedUniforms/dispatch.js

@@ -0,0 +1,355 @@
+// §7 single-dispatch leaf dispatcher.
+//
+// Each bucket holds a static-ish records buffer (only edited on RO
+// add/remove). Per frame the caller:
+//   1. Drains dirty constituent avals and uploads the changed byte
+//      range to the shared constituents buffer.
+//   2. Builds a dirty bitmask (one bit per constituent slot) and
+//      uploads it to the shared dirty buffer.
+//   3. For each bucket, calls `dispatcher.encode(enc)` — one
+//      compute pass with one dispatch per bucket. The kernel
+//      early-returns on records whose inputs are all clean.
+//
+// No worklist building, no atomicAdd compaction, no per-frame record
+// encoding. The records buffer changes only when ROs come and go.
+import { ConstituentSlots, DF32_MAT4_BYTES, } from "./slots.js";
+import { RECORD_STRIDE_BYTES, RECORD_STRIDE_U32, RECORD_FIELD, DERIVED_UBER_KERNEL_WGSL, } from "./uberKernel.wgsl.js";
+/** Per-bucket records buffer. Records are added/removed when ROs
+ *  enter/leave the bucket. Uses swap-remove to keep the buffer dense.
+ *  CPU mirror is kept up-to-date; the dirty range is uploaded once
+ *  per `flush()`. */
+export class RecordsBuffer {
+    device;
+    cpu;
+    cap = 0; // record slots (capacity, in records)
+    count = 0; // live records
+    nextId = 0;
+    slotById = new Map();
+    idBySlot = [];
+    /** Dirty CPU-mirror byte range that must be uploaded next flush. */
+    dirtyMinByte = Infinity;
+    dirtyMaxByte = -1;
+    gpu;
+    gpuCap = 0; // record slots in `gpu`
+    constructor(device, initialCapacity = 64) {
+        this.device = device;
+        this.cap = initialCapacity;
+        this.cpu = new Uint32Array(this.cap * RECORD_STRIDE_U32);
+    }
+    /** Add a record. Returns a stable handle for later removal. */
+    add(rec) {
+        if (this.count === this.cap)
+            this.growCpu();
+        const slot = this.count++;
+        const id = this.nextId++;
+        this.slotById.set(id, slot);
+        this.idBySlot[slot] = id;
+        this.writeAt(slot, rec);
+        return id;
+    }
+    /** Swap-remove. The last record moves into the freed slot. */
+    remove(id) {
+        const slot = this.slotById.get(id);
+        if (slot === undefined) {
+            throw new Error("RecordsBuffer.remove: unknown id");
+        }
+        const last = this.count - 1;
+        if (slot !== last) {
+            // Move last → slot.
+            const srcOff = last * RECORD_STRIDE_U32;
+            const dstOff = slot * RECORD_STRIDE_U32;
+            for (let i = 0; i < RECORD_STRIDE_U32; i++) {
+                this.cpu[dstOff + i] = this.cpu[srcOff + i];
+            }
+            const movedId = this.idBySlot[last];
+            this.slotById.set(movedId, slot);
+            this.idBySlot[slot] = movedId;
+            this.markDirty(slot, slot + 1);
+        }
+        this.slotById.delete(id);
+        this.idBySlot.length = last;
+        this.count = last;
+    }
+    /** Live record count. */
+    get recordCount() { return this.count; }
+    /** Ensure GPU buffer matches cap and upload dirty CPU range. Call
+     *  before `encode`. */
+    flush() {
+        if (this.gpu === undefined || this.gpuCap < this.cap) {
+            if (this.gpu !== undefined)
+                this.gpu.destroy();
+            this.gpu = this.device.createBuffer({
+                label: "derivedUniforms.records",
+                size: this.cap * RECORD_STRIDE_BYTES,
+                usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST,
+            });
+            this.gpuCap = this.cap;
+            // Whole CPU mirror needs re-upload.
+            this.dirtyMinByte = 0;
+            this.dirtyMaxByte = this.count * RECORD_STRIDE_BYTES;
+        }
+        if (this.dirtyMaxByte > this.dirtyMinByte) {
+            const start = this.dirtyMinByte;
+            const end = Math.min(this.dirtyMaxByte, this.count * RECORD_STRIDE_BYTES);
+            if (end > start) {
+                this.device.queue.writeBuffer(this.gpu, start, this.cpu.buffer, this.cpu.byteOffset + start, end - start);
+            }
+            this.dirtyMinByte = Infinity;
+            this.dirtyMaxByte = -1;
+        }
+    }
+    buffer() {
+        if (this.gpu === undefined) {
+            // Empty bucket — make a tiny stub so binding always has something.
+            this.gpu = this.device.createBuffer({
+                label: "derivedUniforms.records.stub",
+                size: RECORD_STRIDE_BYTES,
+                usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST,
+            });
+            this.gpuCap = 1;
+        }
+        return this.gpu;
+    }
+    dispose() {
+        if (this.gpu !== undefined) {
+            this.gpu.destroy();
+            this.gpu = undefined;
+        }
+    }
+    // ── Internals ─────────────────────────────────────────────────────
+    writeAt(slot, rec) {
+        const off = slot * RECORD_STRIDE_U32;
+        this.cpu[off + RECORD_FIELD.recipe_id] = rec.recipe;
+        this.cpu[off + RECORD_FIELD.in0] = rec.in0;
+        this.cpu[off + RECORD_FIELD.in1] = rec.in1;
+        this.cpu[off + RECORD_FIELD.in2] = rec.in2;
+        this.cpu[off + RECORD_FIELD.out_byte] = rec.outByte;
+        this.markDirty(slot, slot + 1);
+    }
+    markDirty(startSlot, endSlot) {
+        const startByte = startSlot * RECORD_STRIDE_BYTES;
+        const endByte = endSlot * RECORD_STRIDE_BYTES;
+        if (startByte < this.dirtyMinByte)
+            this.dirtyMinByte = startByte;
+        if (endByte > this.dirtyMaxByte)
+            this.dirtyMaxByte = endByte;
+    }
+    growCpu() {
+        const newCap = this.cap * 2;
+        const grown = new Uint32Array(newCap * RECORD_STRIDE_U32);
+        grown.set(this.cpu);
+        this.cpu = grown;
+        this.cap = newCap;
+    }
+}
+/** One compute pipeline shared across buckets — created once per scene. */
+export class DerivedUniformsPipeline {
+    pipeline;
+    bgl;
+    constructor(device) {
+        const module = device.createShaderModule({ code: DERIVED_UBER_KERNEL_WGSL });
+        this.bgl = device.createBindGroupLayout({
+            entries: [
+                { binding: 0, visibility: GPUShaderStage.COMPUTE, buffer: { type: "read-only-storage" } },
+                { binding: 1, visibility: GPUShaderStage.COMPUTE, buffer: { type: "storage" } },
+                { binding: 2, visibility: GPUShaderStage.COMPUTE, buffer: { type: "read-only-storage" } },
+                { binding: 3, visibility: GPUShaderStage.COMPUTE, buffer: { type: "uniform" } },
+            ],
+        });
+        this.pipeline = device.createComputePipeline({
+            layout: device.createPipelineLayout({ bindGroupLayouts: [this.bgl] }),
+            compute: { module, entryPoint: "main" },
+        });
+    }
+}
+/** Per-bucket dispatcher. One bind group cached, rebuilt only when a
+ *  bound buffer reference changes (constituents or main heap grew, or
+ *  records buffer was re-created). */
+export class DerivedUniformsDispatcher {
+    device;
+    pipe;
+    resources;
+    records;
+    cachedBg;
+    bgKeyConsts;
+    bgKeyHeap;
+    bgKeyRecs;
+    /** Tiny uniform holding the live record count — gates threads past
+     *  the live range from reading stale swap-removed records. */
+    countBuf;
+    countCpu = new Uint32Array(1);
+    lastCountUploaded = -1;
+    constructor(device, pipe, resources, initialRecordCapacity = 64) {
+        this.device = device;
+        this.pipe = pipe;
+        this.resources = resources;
+        this.records = new RecordsBuffer(device, initialRecordCapacity);
+        this.countBuf = device.createBuffer({
+            label: "derivedUniforms.recordCount",
+            size: 16, // uniform min size
+            usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
+        });
+    }
+    /** Dispatch into an open compute pass. Caller is responsible for
+     *  beginning/ending the pass and setting the pipeline once across
+     *  all dispatchers (the pipeline is shared). */
+    dispatchInto(pass) {
+        const count = this.records.recordCount;
+        if (count === 0)
+            return false;
+        this.records.flush();
+        if (count !== this.lastCountUploaded) {
+            this.countCpu[0] = count;
+            this.device.queue.writeBuffer(this.countBuf, 0, this.countCpu.buffer, this.countCpu.byteOffset, 4);
+            this.lastCountUploaded = count;
+        }
+        pass.setBindGroup(0, this.bindGroup());
+        pass.dispatchWorkgroups(Math.ceil(count / 64));
+        return true;
+    }
+    /** Convenience: open/close a pass and dispatch. Use only when this
+     *  is the sole dispatcher in the pass; otherwise use `dispatchInto`
+     *  inside a caller-managed pass. */
+    encode(enc) {
+        if (this.records.recordCount === 0)
+            return false;
+        const pass = enc.beginComputePass({ label: "derivedUniforms.uber" });
+        pass.setPipeline(this.pipe.pipeline);
+        const ran = this.dispatchInto(pass);
+        pass.end();
+        return ran;
+    }
+    dispose() {
+        this.records.dispose();
+        this.countBuf.destroy();
+    }
+    bindGroup() {
+        const consts = this.resources.constituentsBuf();
+        const heap = this.resources.mainHeapBuf();
+        const recs = this.records.buffer();
+        if (this.cachedBg !== undefined &&
+            this.bgKeyConsts === consts && this.bgKeyHeap === heap &&
+            this.bgKeyRecs === recs) {
+            return this.cachedBg;
+        }
+        this.cachedBg = this.device.createBindGroup({
+            layout: this.pipe.bgl,
+            entries: [
+                { binding: 0, resource: { buffer: consts } },
+                { binding: 1, resource: { buffer: heap } },
+                { binding: 2, resource: { buffer: recs } },
+                { binding: 3, resource: { buffer: this.countBuf } },
+            ],
+        });
+        this.bgKeyConsts = consts;
+        this.bgKeyHeap = heap;
+        this.bgKeyRecs = recs;
+        return this.cachedBg;
+    }
+}
+/** Scene-side helper: O(changed) maintenance of a GPU dirty bitmask.
+ *
+ *  Steady state (clean frame): zero work. The CPU mirror reflects the
+ *  GPU buffer, so we only ever touch bits that actually flip.
+ *
+ *  Each `upload(dirty)` call:
+ *    1. Clears the bits set last frame (O(prev_dirty)).
+ *    2. Sets the bits dirty this frame (O(dirty)).
+ *    3. Writes only the affected u32 range to the GPU (one writeBuffer).
+ *  If both sets are empty, returns immediately. */
+export class DirtyMaskUploader {
+    device;
+    cpu;
+    gpu;
+    gpuCapU32 = 0;
+    /** Bits set on the previous upload — must be cleared next time. */
+    prevDirty = [];
+    constructor(device, initialU32 = 8) {
+        this.device = device;
+        this.cpu = new Uint32Array(Math.max(1, initialU32));
+    }
+    /** Resize CPU + GPU mirrors so they cover `slotCount` bits. */
+    ensureCapacity(slotCount) {
+        const need = Math.max(1, Math.ceil(slotCount / 32));
+        if (need > this.cpu.length) {
+            let cap = Math.max(this.cpu.length, 1);
+            while (cap < need)
+                cap *= 2;
+            const grown = new Uint32Array(cap);
+            grown.set(this.cpu);
+            this.cpu = grown;
+        }
+        if (this.gpu === undefined || this.gpuCapU32 < need) {
+            if (this.gpu !== undefined)
+                this.gpu.destroy();
+            const cap = this.cpu.length;
+            this.gpu = this.device.createBuffer({
+                label: "derivedUniforms.dirtyMask",
+                size: cap * 4,
+                usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST,
+            });
+            this.gpuCapU32 = cap;
+            // GPU buffer is fresh-zero; CPU mirror should match. Wipe any
+            // prevDirty (those bits live in the destroyed buffer).
+            this.prevDirty.length = 0;
+        }
+    }
+    /** Apply the new dirty set. O(prev_dirty + dirty), no O(slotCount). */
+    upload(dirty) {
+        let minU32 = Infinity;
+        let maxU32 = -Infinity;
+        for (const s of this.prevDirty) {
+            const i = s >>> 5;
+            const b = s & 31;
+            this.cpu[i] = (this.cpu[i] & ~(1 << b)) >>> 0;
+            if (i < minU32)
+                minU32 = i;
+            if (i > maxU32)
+                maxU32 = i;
+        }
+        this.prevDirty.length = 0;
+        for (const s of dirty) {
+            const i = s >>> 5;
+            const b = s & 31;
+            this.cpu[i] = (this.cpu[i] | (1 << b)) >>> 0;
+            if (i < minU32)
+                minU32 = i;
+            if (i > maxU32)
+                maxU32 = i;
+            this.prevDirty.push(s);
+        }
+        if (maxU32 < 0 || maxU32 === -Infinity)
+            return;
+        const startByte = minU32 * 4;
+        const endByte = (maxU32 + 1) * 4;
+        this.device.queue.writeBuffer(this.gpu, startByte, this.cpu.buffer, this.cpu.byteOffset + startByte, endByte - startByte);
+    }
+    buffer() {
+        if (this.gpu === undefined)
+            this.ensureCapacity(1);
+        return this.gpu;
+    }
+    dispose() {
+        if (this.gpu !== undefined) {
+            this.gpu.destroy();
+            this.gpu = undefined;
+        }
+    }
+}
+/** Upload the dirty constituent value range to the constituents GPU
+ *  buffer. Helper used by the scene each frame after draining. */
+export function uploadConstituentsRange(device, buf, mirror, dirty) {
+    let minSlot = Infinity, maxSlot = -1;
+    for (const s of dirty) {
+        if (s < minSlot)
+            minSlot = s;
+        if (s > maxSlot)
+            maxSlot = s;
+    }
+    if (maxSlot < 0)
+        return;
+    const startByte = minSlot * DF32_MAT4_BYTES;
+    const endByte = (maxSlot + 1) * DF32_MAT4_BYTES;
+    device.queue.writeBuffer(buf, startByte, mirror.buffer, mirror.byteOffset + startByte, endByte - startByte);
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/runtime/derivedUniforms/dispatch.js.map

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

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

@@ -0,0 +1,6 @@
+export { RecipeId, ALL_RECIPES, DERIVED_UNIFORM_NAMES, recipeIdByName, recipeName, recipeInputs, recipeInputCount, recipeOutput, type ConstituentRef, type RecipeOutput, } from "./recipes.js";
+export { ConstituentSlots, DF32_MAT4_BYTES, type SlotIndex, type PairedSlots, type DerivationRecord, type SubscribeFn, } from "./slots.js";
+export { DerivedUniformsDispatcher, DerivedUniformsPipeline, RecordsBuffer, uploadConstituentsRange, type DerivedUniformsResources, } from "./dispatch.js";
+export { DerivedUniformsScene, registerRoDerivations, deregisterRoDerivations, isDerivedUniformName, type RoTrafoInputs, type RoDerivedRequest, type RoRegistration, } from "./sceneIntegration.js";
+export { DERIVED_UBER_KERNEL_WGSL, } from "./uberKernel.wgsl.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/derivedUniforms/index.ts"],"names":[],"mappings":"AAqBA,OAAO,EACL,QAAQ,EACR,WAAW,EAAE,qBAAqB,EAClC,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EACxE,KAAK,cAAc,EAAE,KAAK,YAAY,GACvC,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,gBAAgB,EAAE,eAAe,EACjC,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,WAAW,GAC1E,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,yBAAyB,EAAE,uBAAuB,EAClD,aAAa,EAAE,uBAAuB,EACtC,KAAK,wBAAwB,GAC9B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,wBAAwB,GACzB,MAAM,sBAAsB,CAAC"}

package/dist/runtime/derivedUniforms/index.js

@@ -0,0 +1,26 @@
+// §7 derived-uniforms module — public surface.
+//
+// Caller responsibilities (typically heapScene.ts):
+//
+//   1. Construct one DerivedUniformsScene per heap scene, one
+//      DerivedUniformsBucket per render bucket. The scene owns the
+//      shared constituents storage buffer + dirty bitmask + pipeline.
+//   2. In the parent scene-object's `inputChanged(t, o)` router, call
+//      `scene.routeInputChanged(o)`. Returns true iff o matched.
+//   3. In each RO's add path: `registerRoDerivations(scene, bucket, req)`
+//      allocates constituent slots and pushes records into the bucket's
+//      records buffer. In remove path: `deregisterRoDerivations(...)`.
+//   4. In the per-frame compute prep, inside the parent sceneObj's
+//      `evaluateAlways(token, ...)` scope:
+//        const dirty = scene.constituents.pullDirty(token);
+//        scene.uploadDirty(dirty);
+//        for each bucket: bucket.dispatcher.encode(enc);
+//      All steps are O(changed); on clean frames they no-op.
+//
+// Identifying which uniform names are §7-owned: DERIVED_UNIFORM_NAMES.
+export { RecipeId, ALL_RECIPES, DERIVED_UNIFORM_NAMES, recipeIdByName, recipeName, recipeInputs, recipeInputCount, recipeOutput, } from "./recipes.js";
+export { ConstituentSlots, DF32_MAT4_BYTES, } from "./slots.js";
+export { DerivedUniformsDispatcher, DerivedUniformsPipeline, RecordsBuffer, uploadConstituentsRange, } from "./dispatch.js";
+export { DerivedUniformsScene, registerRoDerivations, deregisterRoDerivations, isDerivedUniformName, } from "./sceneIntegration.js";
+export { DERIVED_UBER_KERNEL_WGSL, } from "./uberKernel.wgsl.js";
+//# sourceMappingURL=index.js.map

package/dist/runtime/derivedUniforms/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/derivedUniforms/index.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,EAAE;AACF,oDAAoD;AACpD,EAAE;AACF,8DAA8D;AAC9D,mEAAmE;AACnE,sEAAsE;AACtE,sEAAsE;AACtE,iEAAiE;AACjE,0EAA0E;AAC1E,wEAAwE;AACxE,uEAAuE;AACvE,mEAAmE;AACnE,2CAA2C;AAC3C,4DAA4D;AAC5D,mCAAmC;AACnC,yDAAyD;AACzD,6DAA6D;AAC7D,EAAE;AACF,uEAAuE;AAEvE,OAAO,EACL,QAAQ,EACR,WAAW,EAAE,qBAAqB,EAClC,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,GAEzE,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,gBAAgB,EAAE,eAAe,GAElC,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,yBAAyB,EAAE,uBAAuB,EAClD,aAAa,EAAE,uBAAuB,GAEvC,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,GAIrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,wBAAwB,GACzB,MAAM,sBAAsB,CAAC"}

package/dist/runtime/derivedUniforms/recipes.d.ts

@@ -0,0 +1,42 @@
+/** Recipe IDs. Numeric values are stable — the kernel switches on them. */
+export declare const enum RecipeId {
+    /** Model.fwd → f32 mat4. */
+    ModelTrafo = 0,
+    /** Model.bwd → f32 mat4. */
+    ModelTrafoInv = 1,
+    /** (Model.bwd)ᵀ upper-3×3 → f32 mat3. */
+    NormalMatrix = 2,
+    /** View.fwd · Model.fwd → f32 mat4. */
+    ModelViewTrafo = 3,
+    /** Model.bwd · View.bwd → f32 mat4. */
+    ModelViewTrafoInv = 4,
+    /** Proj.fwd · View.fwd · Model.fwd → f32 mat4. */
+    ModelViewProjTrafo = 5,
+    /** Model.bwd · View.bwd · Proj.bwd → f32 mat4. */
+    ModelViewProjTrafoInv = 6,
+    /** View.fwd → f32 mat4. */
+    ViewTrafo = 7,
+    /** View.bwd → f32 mat4. */
+    ViewTrafoInv = 8,
+    /** Proj.fwd · View.fwd → f32 mat4. */
+    ViewProjTrafo = 9,
+    /** View.bwd · Proj.bwd → f32 mat4. */
+    ViewProjTrafoInv = 10,
+    /** Proj.fwd → f32 mat4. */
+    ProjTrafo = 11,
+    /** Proj.bwd → f32 mat4. */
+    ProjTrafoInv = 12
+}
+export declare function recipeInputCount(id: RecipeId): 1 | 2 | 3;
+/** Output shape — drives drawHeader byte allocation. */
+export type RecipeOutput = "mat4" | "mat3";
+export declare function recipeOutput(id: RecipeId): RecipeOutput;
+/** Which side (forward/backward) of which Trafo3d each input slot draws from. */
+export type ConstituentRef = "Model.fwd" | "Model.bwd" | "View.fwd" | "View.bwd" | "Proj.fwd" | "Proj.bwd";
+export declare function recipeInputs(id: RecipeId): readonly ConstituentRef[];
+/** All recipe IDs in switch order. */
+export declare const ALL_RECIPES: readonly RecipeId[];
+export declare const DERIVED_UNIFORM_NAMES: ReadonlySet<string>;
+export declare function recipeIdByName(name: string): RecipeId | undefined;
+export declare function recipeName(id: RecipeId): string;
+//# sourceMappingURL=recipes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recipes.d.ts","sourceRoot":"","sources":["../../../src/runtime/derivedUniforms/recipes.ts"],"names":[],"mappings":"AAcA,2EAA2E;AAC3E,0BAAkB,QAAQ;IACxB,4BAA4B;IAC5B,UAAU,IAAe;IACzB,4BAA4B;IAC5B,aAAa,IAAY;IACzB,yCAAyC;IACzC,YAAY,IAAa;IAEzB,uCAAuC;IACvC,cAAc,IAAW;IACzB,uCAAuC;IACvC,iBAAiB,IAAQ;IACzB,kDAAkD;IAClD,kBAAkB,IAAO;IACzB,kDAAkD;IAClD,qBAAqB,IAAI;IAEzB,2BAA2B;IAC3B,SAAS,IAAgB;IACzB,2BAA2B;IAC3B,YAAY,IAAa;IACzB,sCAAsC;IACtC,aAAa,IAAY;IACzB,sCAAsC;IACtC,gBAAgB,KAAU;IAC1B,2BAA2B;IAC3B,SAAS,KAAiB;IAC1B,2BAA2B;IAC3B,YAAY,KAAc;CAC3B;AAmBD,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAExD;AAED,wDAAwD;AACxD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAkB3C,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,GAAG,YAAY,CAEvD;AAED,iFAAiF;AACjF,MAAM,MAAM,cAAc,GACtB,WAAW,GAAG,WAAW,GACzB,UAAU,GAAI,UAAU,GACxB,UAAU,GAAI,UAAU,CAAC;AAoB7B,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,GAAG,SAAS,cAAc,EAAE,CAEpE;AAmBD,sCAAsC;AACtC,eAAO,MAAM,WAAW,EAAE,SAAS,QAAQ,EAO1C,CAAC;AAMF,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,CACZ,CAAC;AAE3C,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAEjE;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,CAE/C"}

package/dist/runtime/derivedUniforms/recipes.js

@@ -0,0 +1,134 @@
+// §7 derived-uniform recipe table — leaf-only flavour.
+//
+// Every recipe is a self-contained leaf: reads constituents directly,
+// computes inline (one or two df32 muls + collapse), writes the final
+// f32 mat4/mat3 to the main heap drawHeader. No intermediates, no
+// layering, no dependents graph.
+//
+// Two consumers of the same df32 product (e.g. ModelViewTrafo and
+// ModelViewProjTrafo for the same RO) recompute Model·View twice —
+// trivial vs the encode-time savings of one flat dispatch.
+//
+// All df32 math runs through the verified primitives in
+// uberKernel.wgsl.ts; the final consumer-facing values are f32.
+/** Recipe IDs. Numeric values are stable — the kernel switches on them. */
+export var RecipeId;
+(function (RecipeId) {
+    /** Model.fwd → f32 mat4. */
+    RecipeId[RecipeId["ModelTrafo"] = 0] = "ModelTrafo";
+    /** Model.bwd → f32 mat4. */
+    RecipeId[RecipeId["ModelTrafoInv"] = 1] = "ModelTrafoInv";
+    /** (Model.bwd)ᵀ upper-3×3 → f32 mat3. */
+    RecipeId[RecipeId["NormalMatrix"] = 2] = "NormalMatrix";
+    /** View.fwd · Model.fwd → f32 mat4. */
+    RecipeId[RecipeId["ModelViewTrafo"] = 3] = "ModelViewTrafo";
+    /** Model.bwd · View.bwd → f32 mat4. */
+    RecipeId[RecipeId["ModelViewTrafoInv"] = 4] = "ModelViewTrafoInv";
+    /** Proj.fwd · View.fwd · Model.fwd → f32 mat4. */
+    RecipeId[RecipeId["ModelViewProjTrafo"] = 5] = "ModelViewProjTrafo";
+    /** Model.bwd · View.bwd · Proj.bwd → f32 mat4. */
+    RecipeId[RecipeId["ModelViewProjTrafoInv"] = 6] = "ModelViewProjTrafoInv";
+    /** View.fwd → f32 mat4. */
+    RecipeId[RecipeId["ViewTrafo"] = 7] = "ViewTrafo";
+    /** View.bwd → f32 mat4. */
+    RecipeId[RecipeId["ViewTrafoInv"] = 8] = "ViewTrafoInv";
+    /** Proj.fwd · View.fwd → f32 mat4. */
+    RecipeId[RecipeId["ViewProjTrafo"] = 9] = "ViewProjTrafo";
+    /** View.bwd · Proj.bwd → f32 mat4. */
+    RecipeId[RecipeId["ViewProjTrafoInv"] = 10] = "ViewProjTrafoInv";
+    /** Proj.fwd → f32 mat4. */
+    RecipeId[RecipeId["ProjTrafo"] = 11] = "ProjTrafo";
+    /** Proj.bwd → f32 mat4. */
+    RecipeId[RecipeId["ProjTrafoInv"] = 12] = "ProjTrafoInv";
+})(RecipeId || (RecipeId = {}));
+/** Number of constituent inputs each recipe consumes (1, 2, or 3). */
+const INPUT_COUNT = {
+    [RecipeId.ModelTrafo]: 1,
+    [RecipeId.ModelTrafoInv]: 1,
+    [RecipeId.NormalMatrix]: 1,
+    [RecipeId.ModelViewTrafo]: 2,
+    [RecipeId.ModelViewTrafoInv]: 2,
+    [RecipeId.ModelViewProjTrafo]: 3,
+    [RecipeId.ModelViewProjTrafoInv]: 3,
+    [RecipeId.ViewTrafo]: 1,
+    [RecipeId.ViewTrafoInv]: 1,
+    [RecipeId.ViewProjTrafo]: 2,
+    [RecipeId.ViewProjTrafoInv]: 2,
+    [RecipeId.ProjTrafo]: 1,
+    [RecipeId.ProjTrafoInv]: 1,
+};
+export function recipeInputCount(id) {
+    return INPUT_COUNT[id];
+}
+const OUTPUT = {
+    [RecipeId.ModelTrafo]: "mat4",
+    [RecipeId.ModelTrafoInv]: "mat4",
+    [RecipeId.NormalMatrix]: "mat3",
+    [RecipeId.ModelViewTrafo]: "mat4",
+    [RecipeId.ModelViewTrafoInv]: "mat4",
+    [RecipeId.ModelViewProjTrafo]: "mat4",
+    [RecipeId.ModelViewProjTrafoInv]: "mat4",
+    [RecipeId.ViewTrafo]: "mat4",
+    [RecipeId.ViewTrafoInv]: "mat4",
+    [RecipeId.ViewProjTrafo]: "mat4",
+    [RecipeId.ViewProjTrafoInv]: "mat4",
+    [RecipeId.ProjTrafo]: "mat4",
+    [RecipeId.ProjTrafoInv]: "mat4",
+};
+export function recipeOutput(id) {
+    return OUTPUT[id];
+}
+const INPUTS = {
+    [RecipeId.ModelTrafo]: ["Model.fwd"],
+    [RecipeId.ModelTrafoInv]: ["Model.bwd"],
+    [RecipeId.NormalMatrix]: ["Model.bwd"],
+    // df_mul args are ordered (outer, inner) so the math product
+    // matches Aardvark's `View.mul(Model).forward = View.fwd · Model.fwd`.
+    [RecipeId.ModelViewTrafo]: ["View.fwd", "Model.fwd"],
+    [RecipeId.ModelViewTrafoInv]: ["Model.bwd", "View.bwd"],
+    [RecipeId.ModelViewProjTrafo]: ["Proj.fwd", "View.fwd", "Model.fwd"],
+    [RecipeId.ModelViewProjTrafoInv]: ["Model.bwd", "View.bwd", "Proj.bwd"],
+    [RecipeId.ViewTrafo]: ["View.fwd"],
+    [RecipeId.ViewTrafoInv]: ["View.bwd"],
+    [RecipeId.ViewProjTrafo]: ["Proj.fwd", "View.fwd"],
+    [RecipeId.ViewProjTrafoInv]: ["View.bwd", "Proj.bwd"],
+    [RecipeId.ProjTrafo]: ["Proj.fwd"],
+    [RecipeId.ProjTrafoInv]: ["Proj.bwd"],
+};
+export function recipeInputs(id) {
+    return INPUTS[id];
+}
+/** Public uniform name (one per recipe). */
+const NAME = {
+    [RecipeId.ModelTrafo]: "ModelTrafo",
+    [RecipeId.ModelTrafoInv]: "ModelTrafoInv",
+    [RecipeId.NormalMatrix]: "NormalMatrix",
+    [RecipeId.ModelViewTrafo]: "ModelViewTrafo",
+    [RecipeId.ModelViewTrafoInv]: "ModelViewTrafoInv",
+    [RecipeId.ModelViewProjTrafo]: "ModelViewProjTrafo",
+    [RecipeId.ModelViewProjTrafoInv]: "ModelViewProjTrafoInv",
+    [RecipeId.ViewTrafo]: "ViewTrafo",
+    [RecipeId.ViewTrafoInv]: "ViewTrafoInv",
+    [RecipeId.ViewProjTrafo]: "ViewProjTrafo",
+    [RecipeId.ViewProjTrafoInv]: "ViewProjTrafoInv",
+    [RecipeId.ProjTrafo]: "ProjTrafo",
+    [RecipeId.ProjTrafoInv]: "ProjTrafoInv",
+};
+/** All recipe IDs in switch order. */
+export const ALL_RECIPES = [
+    RecipeId.ModelTrafo, RecipeId.ModelTrafoInv, RecipeId.NormalMatrix,
+    RecipeId.ModelViewTrafo, RecipeId.ModelViewTrafoInv,
+    RecipeId.ModelViewProjTrafo, RecipeId.ModelViewProjTrafoInv,
+    RecipeId.ViewTrafo, RecipeId.ViewTrafoInv,
+    RecipeId.ViewProjTrafo, RecipeId.ViewProjTrafoInv,
+    RecipeId.ProjTrafo, RecipeId.ProjTrafoInv,
+];
+const BY_NAME = new Map(ALL_RECIPES.map(id => [NAME[id], id]));
+export const DERIVED_UNIFORM_NAMES = new Set(ALL_RECIPES.map(id => NAME[id]));
+export function recipeIdByName(name) {
+    return BY_NAME.get(name);
+}
+export function recipeName(id) {
+    return NAME[id];
+}
+//# sourceMappingURL=recipes.js.map

package/dist/runtime/derivedUniforms/recipes.js.map

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