@aardworx/wombat.rendering 0.9.14 → 0.9.16

package/dist/runtime/derivedModes/slotTable.js

@@ -0,0 +1,130 @@
+// SlotTable — per-bucket (or per-scene-scope) registry that maps a
+// per-RO modeKey to a fixed slot index. Each slot owns one
+// `GPURenderPipeline` and one offset into a shared indirect-args
+// buffer. The partition kernel reads `modeKeyToSlot` to atomic-add a
+// record's counts into the right slot; encode iterates the slots and
+// emits one `drawIndirect` per slot (zero-record slots draw zero).
+//
+// Lifecycle:
+//
+//   - addRO(modeKey, descriptor) → ensures the slot exists.
+//     - On miss, allocates a new slot, fires `precompile` for the
+//       missing descriptor (or `getOrCreateSync` if `sync=true`).
+//   - removeRO(modeKey) → drops a refcount on the slot. v1 keeps the
+//     slot around even at refcount=0 (pipelines are cheap to retain
+//     and the future case is "RO reappears next frame").
+//   - ready(): Promise<void> → resolves when every registered slot
+//     has a linked pipeline.
+//   - syncLookup(modeKey) → slot index or -1 (used by partition kernel
+//     setup; missing slot is a logical error post-ready()).
+//
+// This module does NOT touch heapScene. It's a generic data structure
+// that the heap integration drives. Tests use a mock builder.
+import { PipelineCache, encodeModeKey as encodeMK, } from "../pipelineCache/index.js";
+/**
+ * One SlotTable per `(effect, textureSet)` bucket. The cache may be
+ * shared across buckets — pipelines that happen to share a descriptor
+ * (rare across distinct effects, since pipeline objects bake the
+ * shader / layout) still dedupe at the cache level if a builder
+ * legitimately produces the same GPURenderPipeline for the same
+ * descriptor key.
+ */
+export class SlotTable {
+    cache;
+    builder;
+    entries = [];
+    byKey = new Map();
+    /** Tracks pending precompile promises so ready() waits for the union. */
+    pending = new Set();
+    version = 0;
+    constructor(cache, builder) {
+        this.cache = cache;
+        this.builder = builder;
+    }
+    /** Total slot count (linked or pending). */
+    get slotCount() { return this.entries.length; }
+    /**
+     * Bumps whenever a new slot is appended. Consumers (partition setup,
+     * indirect-args resize, GPU lookup-table upload) compare against
+     * their last-seen value to know when to re-upload.
+     */
+    get layoutVersion() { return this.version; }
+    /** Iterate all slots in slot-index order. */
+    *all() { yield* this.entries; }
+    /**
+     * Add (or reference-bump) the slot for `descriptor`. Returns the
+     * existing slot if it already exists, otherwise creates one and
+     * kicks off compilation via `builder` (async by default).
+     *
+     * Pass `sync: true` on the runtime-mutation path to use
+     * `builder.createSync` instead — the returned slot's `pipeline` will
+     * be populated immediately.
+     */
+    addRO(descriptor, options = {}) {
+        const modeKey = encodeMK(descriptor);
+        const existing = this.byKey.get(modeKey);
+        if (existing !== undefined) {
+            existing.refCount += 1;
+            return existing;
+        }
+        const slotIndex = this.entries.length;
+        const entry = {
+            slotIndex, modeKey, descriptor, refCount: 1, pipeline: null,
+        };
+        this.entries.push(entry);
+        this.byKey.set(modeKey, entry);
+        this.version += 1;
+        if (options.sync === true) {
+            entry.pipeline = this.cache.getOrCreateSync(this.builder, descriptor);
+        }
+        else {
+            // Use the cache's precompile path so concurrent requests
+            // deduplicate. Tracks promise so `ready()` blocks until done.
+            const p = this.cache.precompile(this.builder, [descriptor]).then(() => {
+                const got = this.cache.lookup(modeKey);
+                if (got !== null)
+                    entry.pipeline = got;
+            });
+            this.pending.add(p);
+            // Auto-clean once settled.
+            p.finally(() => this.pending.delete(p));
+        }
+        return entry;
+    }
+    /** Drop one reference from the slot. Pipelines stay resident. */
+    removeRO(modeKey) {
+        const e = this.byKey.get(modeKey);
+        if (e === undefined)
+            return;
+        if (e.refCount > 0)
+            e.refCount -= 1;
+    }
+    /**
+     * Move an RO from one slot to another (reactive aval mutation
+     * caused its modeKey to change). Returns the new (possibly newly
+     * allocated) slot.
+     */
+    rebindRO(fromModeKey, toDescriptor, options = {}) {
+        this.removeRO(fromModeKey);
+        return this.addRO(toDescriptor, options);
+    }
+    /** Sync slot lookup by modeKey. Returns the entry or null. */
+    lookup(modeKey) {
+        return this.byKey.get(modeKey) ?? null;
+    }
+    /**
+     * Resolves when every currently-registered slot has a linked
+     * pipeline. Subsequent `addRO` calls after this resolves with
+     * `sync: false` will produce fresh pending work; call `ready()`
+     * again to wait.
+     */
+    async ready() {
+        if (this.pending.size === 0)
+            return;
+        // Snapshot current pending set; new ones added during await
+        // resolve on their own callers' awaits if needed.
+        const snap = [...this.pending];
+        await Promise.all(snap);
+    }
+}
+//# sourceMappingURL=slotTable.js.map

package/dist/runtime/derivedModes/slotTable.js.map

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

package/dist/runtime/heapScene/growBuffer.d.ts

@@ -0,0 +1,33 @@
+import type { IDisposable } from "@aardworx/wombat.adaptive";
+export declare const MIN_BUFFER_BYTES: number;
+export declare const POW2: (n: number) => number;
+export declare const ALIGN16: (n: number) => number;
+/**
+ * A GPUBuffer that can grow to next power-of-two on demand. On grow,
+ * a fresh buffer is created at the new size, the live tail copied
+ * over via copyBufferToBuffer, and dependents (bind groups, mostly)
+ * are notified to rebuild via the `onResize` callback.
+ *
+ * `usedBytes` is the high-water mark — the runtime advances this as
+ * it allocates, and `ensureCapacity` grows when required. This
+ * separates allocation policy from grow policy.
+ */
+export declare class GrowBuffer {
+    private readonly device;
+    private readonly label;
+    private readonly usage;
+    private buf;
+    private cap;
+    private used;
+    private readonly listeners;
+    constructor(device: GPUDevice, label: string, usage: GPUBufferUsageFlags, initialBytes: number);
+    get buffer(): GPUBuffer;
+    get capacity(): number;
+    get usedBytes(): number;
+    setUsed(n: number): void;
+    onResize(cb: () => void): IDisposable;
+    /** Ensure the buffer is at least `bytes` capacity. Grows by pow2 + copies live tail. */
+    ensureCapacity(bytes: number): void;
+    destroy(): void;
+}
+//# sourceMappingURL=growBuffer.d.ts.map

package/dist/runtime/heapScene/growBuffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"growBuffer.d.ts","sourceRoot":"","sources":["../../../src/runtime/heapScene/growBuffer.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,eAAO,MAAM,gBAAgB,QAAY,CAAC;AAE1C,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,KAAG,MAEhC,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,GAAG,MAAM,WAAmB,CAAC;AAErD;;;;;;;;;GASG;AACH,qBAAa,UAAU;IAMnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAPxB,OAAO,CAAC,GAAG,CAAY;IACvB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;gBAEhC,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,mBAAmB,EAC3C,YAAY,EAAE,MAAM;IAStB,IAAI,MAAM,IAAI,SAAS,CAAqB;IAC5C,IAAI,QAAQ,IAAI,MAAM,CAAqB;IAC3C,IAAI,SAAS,IAAI,MAAM,CAAsB;IAC7C,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,WAAW;IAIrC,wFAAwF;IACxF,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAkBnC,OAAO,IAAI,IAAI;CAChB"}

package/dist/runtime/heapScene/growBuffer.js

@@ -0,0 +1,76 @@
+// GrowBuffer — pow2-grown GPUBuffer with a high-water mark and
+// resize-listener machinery for dependents (bind groups, mostly).
+//
+// On grow, a fresh buffer is created at the next pow2 capacity, the
+// live tail is copied over via copyBufferToBuffer, and the listeners
+// (registered via `onResize`) are invoked. The old buffer is
+// destroyed.
+export const MIN_BUFFER_BYTES = 64 * 1024;
+export const POW2 = (n) => {
+    let p = 1;
+    while (p < n)
+        p <<= 1;
+    return p;
+};
+export const ALIGN16 = (n) => (n + 15) & ~15;
+/**
+ * A GPUBuffer that can grow to next power-of-two on demand. On grow,
+ * a fresh buffer is created at the new size, the live tail copied
+ * over via copyBufferToBuffer, and dependents (bind groups, mostly)
+ * are notified to rebuild via the `onResize` callback.
+ *
+ * `usedBytes` is the high-water mark — the runtime advances this as
+ * it allocates, and `ensureCapacity` grows when required. This
+ * separates allocation policy from grow policy.
+ */
+export class GrowBuffer {
+    device;
+    label;
+    usage;
+    buf;
+    cap;
+    used = 0;
+    listeners = new Set();
+    constructor(device, label, usage, initialBytes) {
+        this.device = device;
+        this.label = label;
+        this.usage = usage;
+        this.cap = Math.max(MIN_BUFFER_BYTES, POW2(initialBytes));
+        this.buf = device.createBuffer({
+            size: this.cap,
+            usage: usage | GPUBufferUsage.COPY_DST | GPUBufferUsage.COPY_SRC,
+            label,
+        });
+    }
+    get buffer() { return this.buf; }
+    get capacity() { return this.cap; }
+    get usedBytes() { return this.used; }
+    setUsed(n) { this.used = n; }
+    onResize(cb) {
+        this.listeners.add(cb);
+        return { dispose: () => { this.listeners.delete(cb); } };
+    }
+    /** Ensure the buffer is at least `bytes` capacity. Grows by pow2 + copies live tail. */
+    ensureCapacity(bytes) {
+        if (bytes <= this.cap)
+            return;
+        const newCap = POW2(bytes);
+        const newBuf = this.device.createBuffer({
+            size: newCap,
+            usage: this.usage | GPUBufferUsage.COPY_DST | GPUBufferUsage.COPY_SRC,
+            label: this.label,
+        });
+        if (this.used > 0) {
+            const enc = this.device.createCommandEncoder({ label: `${this.label}: grow-copy` });
+            enc.copyBufferToBuffer(this.buf, 0, newBuf, 0, ALIGN16(this.used));
+            this.device.queue.submit([enc.finish()]);
+        }
+        this.buf.destroy();
+        this.buf = newBuf;
+        this.cap = newCap;
+        for (const cb of this.listeners)
+            cb();
+    }
+    destroy() { this.buf.destroy(); }
+}
+//# sourceMappingURL=growBuffer.js.map

package/dist/runtime/heapScene/growBuffer.js.map

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

package/dist/runtime/heapScene/packers.d.ts

@@ -0,0 +1,25 @@
+export interface WgslPacker {
+    /** Tightly-packed size in bytes of one value (mat4 = 64, vec3 = 12, …). */
+    readonly dataBytes: number;
+    readonly typeId: number;
+    /**
+     * Pack `val` (the aval's `.getValue(tok)` result) into `dst` at
+     * float offset `off`.
+     */
+    readonly pack: (val: unknown, dst: Float32Array, off: number) => void;
+}
+export declare const PACKER_MAT4: WgslPacker;
+export declare const PACKER_VEC4: WgslPacker;
+export declare const PACKER_VEC3: WgslPacker;
+export declare const PACKER_VEC2: WgslPacker;
+export declare const PACKER_F32: WgslPacker;
+export declare const PACKER_U32: WgslPacker;
+export declare const PACKER_UVEC2: WgslPacker;
+export declare const PACKER_UVEC3: WgslPacker;
+export declare const PACKER_UVEC4: WgslPacker;
+export declare const PACKER_I32: WgslPacker;
+export declare const PACKER_IVEC2: WgslPacker;
+export declare const PACKER_IVEC3: WgslPacker;
+export declare const PACKER_IVEC4: WgslPacker;
+export declare function packerForWgslType(wgslType: string): WgslPacker;
+//# sourceMappingURL=packers.d.ts.map

package/dist/runtime/heapScene/packers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packers.d.ts","sourceRoot":"","sources":["../../../src/runtime/heapScene/packers.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,UAAU;IACzB,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACvE;AASD,eAAO,MAAM,WAAW,EAAE,UASzB,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,UAOzB,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,UAOzB,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,UAMzB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,UAGxB,CAAC;AA2BF,eAAO,MAAM,UAAU,YAAoC,CAAC;AAC5D,eAAO,MAAM,YAAY,YAAkC,CAAC;AAC5D,eAAO,MAAM,YAAY,YAAkC,CAAC;AAC5D,eAAO,MAAM,YAAY,YAAkC,CAAC;AAC5D,eAAO,MAAM,UAAU,YAAmC,CAAC;AAC3D,eAAO,MAAM,YAAY,YAAiC,CAAC;AAC3D,eAAO,MAAM,YAAY,YAAiC,CAAC;AAC3D,eAAO,MAAM,YAAY,YAAiC,CAAC;AAE3D,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAkB9D"}

package/dist/runtime/heapScene/packers.js

@@ -0,0 +1,111 @@
+// WGSL-type → JS-value packers used by heapScene to write per-draw
+// uniforms into the arena's Float32Array staging mirror.
+//
+// One packer per supported WGSL type. The `pack` callback takes the
+// aval's `.getValue(tok)` result and writes its bytes to `dst` at
+// float offset `off`. Coerces between Trafo3d / M44d / V4f / V3d /
+// V3f / number as needed.
+//
+// Integer scalar / vector packers go through a same-buffer Uint32/
+// Int32 view to avoid the lossy i32 → f32 coercion you'd get from a
+// direct `dst[off] = ...` assignment.
+function packMat44(m, dst, off) {
+    // Zero-alloc flat copy (row-major) straight into the f32 staging
+    // buffer — `copyTo` does `dst.set(m._data, off)` which narrows f64→f32
+    // on store, no throwaway `number[]` per call.
+    m.copyTo(dst, off);
+}
+export const PACKER_MAT4 = {
+    dataBytes: 64, typeId: 0,
+    pack: (val, dst, off) => {
+        // Accept Trafo3d (uses .forward) or M44d directly.
+        const m = val.forward !== undefined
+            ? val.forward
+            : val;
+        packMat44(m, dst, off);
+    },
+};
+export const PACKER_VEC4 = {
+    dataBytes: 16, typeId: 0,
+    pack: (val, dst, off) => {
+        const v = val;
+        dst[off + 0] = v.x;
+        dst[off + 1] = v.y;
+        dst[off + 2] = v.z;
+        dst[off + 3] = v.w;
+    },
+};
+export const PACKER_VEC3 = {
+    dataBytes: 12, typeId: 0,
+    pack: (val, dst, off) => {
+        // V3f or V3d both expose .x/.y/.z; cast through a common shape.
+        const v = val;
+        dst[off + 0] = v.x;
+        dst[off + 1] = v.y;
+        dst[off + 2] = v.z;
+    },
+};
+export const PACKER_VEC2 = {
+    dataBytes: 8, typeId: 0,
+    pack: (val, dst, off) => {
+        const v = val;
+        dst[off + 0] = v.x;
+        dst[off + 1] = v.y;
+    },
+};
+export const PACKER_F32 = {
+    dataBytes: 4, typeId: 0,
+    pack: (val, dst, off) => { dst[off] = val; },
+};
+function makeIntPacker(ctor, dim) {
+    const bytes = dim * 4;
+    if (dim === 1) {
+        return {
+            dataBytes: bytes, typeId: 0,
+            pack: (val, dst, off) => {
+                new ctor(dst.buffer, dst.byteOffset + off * 4, 1)[0] = val;
+            },
+        };
+    }
+    return {
+        dataBytes: bytes, typeId: 0,
+        pack: (val, dst, off) => {
+            const view = new ctor(dst.buffer, dst.byteOffset + off * 4, dim);
+            const v = val;
+            view[0] = v.x;
+            view[1] = v.y;
+            if (dim >= 3)
+                view[2] = v.z;
+            if (dim >= 4)
+                view[3] = v.w;
+        },
+    };
+}
+export const PACKER_U32 = makeIntPacker(Uint32Array, 1);
+export const PACKER_UVEC2 = makeIntPacker(Uint32Array, 2);
+export const PACKER_UVEC3 = makeIntPacker(Uint32Array, 3);
+export const PACKER_UVEC4 = makeIntPacker(Uint32Array, 4);
+export const PACKER_I32 = makeIntPacker(Int32Array, 1);
+export const PACKER_IVEC2 = makeIntPacker(Int32Array, 2);
+export const PACKER_IVEC3 = makeIntPacker(Int32Array, 3);
+export const PACKER_IVEC4 = makeIntPacker(Int32Array, 4);
+export function packerForWgslType(wgslType) {
+    switch (wgslType) {
+        case "mat4x4<f32>": return PACKER_MAT4;
+        case "vec4<f32>": return PACKER_VEC4;
+        case "vec3<f32>": return PACKER_VEC3;
+        case "vec2<f32>": return PACKER_VEC2;
+        case "f32": return PACKER_F32;
+        case "u32": return PACKER_U32;
+        case "vec2<u32>": return PACKER_UVEC2;
+        case "vec3<u32>": return PACKER_UVEC3;
+        case "vec4<u32>": return PACKER_UVEC4;
+        case "i32": return PACKER_I32;
+        case "vec2<i32>": return PACKER_IVEC2;
+        case "vec3<i32>": return PACKER_IVEC3;
+        case "vec4<i32>": return PACKER_IVEC4;
+        default:
+            throw new Error(`heapScene: no JS-side packer for WGSL type '${wgslType}'`);
+    }
+}
+//# sourceMappingURL=packers.js.map

package/dist/runtime/heapScene/packers.js.map

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

package/dist/runtime/heapScene/pools.d.ts

@@ -0,0 +1,181 @@
+import type { aval, IDisposable } from "@aardworx/wombat.adaptive";
+import type { BufferView } from "../../core/bufferView.js";
+import type { HostBufferSource } from "../../core/buffer.js";
+import { GrowBuffer } from "./growBuffer.js";
+/** Per-allocation header: (u32 typeId, u32 length). Data follows
+ *  the header aligned up to 16 bytes (so positions/normals/etc. line
+ *  up for future vec4 reads). */
+export declare const ALLOC_HEADER_BYTES = 8;
+export declare const ALLOC_HEADER_PAD_TO = 16;
+/** Encoding-tag enum (low 16 bits of typeId). */
+export declare const ENC_V3F_TIGHT = 1;
+/** Semantic-tag enum (high 16 bits of typeId). Optional metadata —
+ *  the shader doesn't branch on this. */
+export declare const SEM_POSITIONS = 1;
+export declare const SEM_NORMALS = 2;
+interface PoolEntry {
+    /** Byte offset into the arena. Data starts at ref + ALLOC_HEADER_PAD_TO. */
+    readonly ref: number;
+    readonly dataBytes: number;
+    readonly typeId: number;
+    /** Packer used to refresh the data region on aval marks. */
+    readonly pack: (val: unknown, dst: Float32Array, off: number) => void;
+    refcount: number;
+}
+/**
+ * Aval-keyed pool of arena allocations. One allocation per unique
+ * aval (object identity). Two draws referencing the same aval share
+ * the allocation; their DrawHeaders carry the same u32 ref. Holds
+ * uniforms (fixed-size scalars/vectors/matrices) AND attribute arrays
+ * (variable-size). The caller decides `dataBytes` + `length` per
+ * acquisition — the pool just keys on aval identity and refcounts.
+ *
+ * Sharing emerges from aval identity — no separate "frequency"
+ * declaration needed. A `cval` shared by all draws → 1 alloc.
+ * A static positions array shared across instanced draws → 1 alloc.
+ * Same code path either way.
+ */
+export declare class UniformPool {
+    private readonly byAval;
+    has(av: aval<unknown>): boolean;
+    entry(av: aval<unknown>): PoolEntry | undefined;
+    /**
+     * Acquire (or share) an allocation for `aval`. Caller passes the
+     * pre-read `value` (so the pool doesn't need a token) plus the
+     * (`dataBytes`, `typeId`, `length`, `pack`) describing how to lay
+     * it out. If a new allocation is made, the value is packed and
+     * uploaded immediately.
+     */
+    acquire(device: GPUDevice, arena: AttributeArena, av: aval<unknown>, value: unknown, dataBytes: number, typeId: number, length: number, pack: (val: unknown, dst: Float32Array, off: number) => void): number;
+    /** Decrement refcount; if zero, free the arena allocation. */
+    release(arena: AttributeArena, av: aval<unknown>): void;
+    /** Re-pack one entry's data region into the arena's CPU shadow. */
+    repack(device: GPUDevice, arena: AttributeArena, av: aval<unknown>, val: unknown): void;
+}
+/**
+ * Aval-keyed pool over the `IndexAllocator`. Two draws referencing
+ * the same `Uint32Array` (or aval thereof) share an index range —
+ * 19K instanced clones of the same mesh share one allocation, one
+ * upload.
+ *
+ * **Value-equality dedup for constant avals (§5b):** when an
+ * incoming aval has `isConstant === true`, the pool also keys by
+ * the underlying `ArrayBuffer` tuple `(buffer, byteOffset,
+ * byteLength)`. Two distinct constant avals wrapping the same
+ * `Uint32Array` view collapse to one allocation.
+ */
+export declare class IndexPool {
+    private readonly byAval;
+    private readonly byValueKey;
+    private readonly bufferIds;
+    private nextBufferId;
+    private bufferIdOf;
+    acquire(device: GPUDevice, indices: IndexAllocator, av: aval<Uint32Array>, arr: Uint32Array): {
+        firstIndex: number;
+        count: number;
+    };
+    release(indices: IndexAllocator, av: aval<Uint32Array>): void;
+}
+/**
+ * Slot-indexed allocator over a GrowBuffer. `slotBytes` is set per-
+ * instance — each bucket sizes its DrawHeader from its effect's
+ * schema, so a bucket whose layout is e.g. 96 B / slot uses a
+ * DrawHeap with `slotBytes=96`.
+ */
+export declare class DrawHeap {
+    private readonly buf;
+    private readonly slotBytes;
+    private free;
+    private nextSlot;
+    constructor(buf: GrowBuffer, slotBytes: number);
+    get buffer(): GPUBuffer;
+    /** Bytes per slot — caller multiplies by slot index for byte offsets. */
+    get bytesPerSlot(): number;
+    /** High-water mark in bytes (used to size bind-group entry on rebuild). */
+    get usedBytes(): number;
+    alloc(): number;
+    release(slot: number): void;
+    onResize(cb: () => void): IDisposable;
+    destroy(): void;
+}
+/**
+ * Byte-bump allocator over a GrowBuffer for variable-size attribute
+ * allocations. Each allocation gets a 16-byte aligned start (8-byte
+ * (typeId, length) header at the start, data 16 bytes in). Frees go
+ * onto a sorted free list with coalesce on insert.
+ */
+export declare class AttributeArena {
+    private readonly buf;
+    private cursor;
+    private freeList;
+    /** CPU shadow of the entire GPU buffer; writes go here first then
+     *  flush() emits one writeBuffer per dirty contiguous range. */
+    private shadow;
+    private dirtyMin;
+    private dirtyMax;
+    constructor(buf: GrowBuffer);
+    get buffer(): GPUBuffer;
+    get capacity(): number;
+    get usedBytes(): number;
+    write(dst: number, data: Uint8Array): void;
+    flush(device: GPUDevice): void;
+    /**
+     * Allocate space for one attribute. Returns the byte ref (offset
+     * to the header — data lives at ref + 16).
+     */
+    alloc(dataBytes: number): number;
+    release(ref: number, dataBytes: number): void;
+    onResize(cb: () => void): IDisposable;
+    destroy(): void;
+}
+/**
+ * Insert `{off, size}` into a free-list kept sorted by `off`, then
+ * coalesce with the two immediate neighbours.
+ */
+export declare function insertSortedFreeBlock(freeList: {
+    off: number;
+    size: number;
+}[], off: number, size: number): void;
+/**
+ * Element-bump allocator over an index GrowBuffer (units = u32). Each
+ * draw's index range is allocated as one block; on release the block
+ * is returned to a free list and can be reused first-fit.
+ */
+export declare class IndexAllocator {
+    private readonly buf;
+    private cursor;
+    private freeList;
+    private shadow;
+    private dirtyMin;
+    private dirtyMax;
+    constructor(buf: GrowBuffer);
+    get buffer(): GPUBuffer;
+    get usedElements(): number;
+    write(dstByteOffset: number, data: Uint8Array): void;
+    flush(device: GPUDevice): void;
+    alloc(elements: number): number;
+    release(off: number, elements: number): void;
+    onResize(cb: () => void): IDisposable;
+    destroy(): void;
+}
+/**
+ * Global arena state: attribute / uniform data lives in `attrs`
+ * (multi-typed-view storage); indices live in `indices` (separate
+ * INDEX-usage buffer).
+ */
+export interface ArenaState {
+    readonly attrs: AttributeArena;
+    readonly indices: IndexAllocator;
+}
+export declare function buildArenaState(device: GPUDevice, attrBytesHint: number, idxBytesHint: number, label: string, idxExtraUsage?: GPUBufferUsageFlags): ArenaState;
+export declare function arenaBytes(arena: ArenaState): number;
+/** Upload a single attribute — header (typeId, length) + data — into the arena at byte offset `ref`. */
+export declare function writeAttribute(device: GPUDevice, buf: GPUBuffer, ref: number, typeId: number, length: number, data: Float32Array): void;
+export declare function asAval<T>(v: aval<T> | T): aval<T>;
+/** Heuristic predicate — BufferView has `buffer: aval<IBuffer>` + elementType. */
+export declare function isBufferView(v: unknown): v is BufferView;
+/** Float32 view over a host-side buffer source. Used by the BufferView
+ *  packer to hand the pool a typed array it can `set()` from. */
+export declare function asFloat32(data: HostBufferSource): Float32Array;
+export {};
+//# sourceMappingURL=pools.d.ts.map

package/dist/runtime/heapScene/pools.d.ts.map

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