@aura3d/engine 3.0.0 → 4.0.0

package/dist/rendering/batching/ContentKeys.js

@@ -0,0 +1,220 @@
+/**
+ * PRD 11 Phase 3 (§6.6 layer 1) — content-keyed dedupe keys the renderer can
+ * trust. The engine compiler creates a unique `Geometry` and `Material` per
+ * primitive node (lane 15, `compiler/primitives.ts`); identical primitive
+ * instances therefore miss every identity-based merge. These keys recover
+ * value equality:
+ *
+ * - `geometryContentKey(geometry)` — the C-07 primitive/tessellation
+ *   descriptor when one was stamped on the geometry, else a hash of vertex
+ *   count, index count and a strided sample of the position/normal/uv data,
+ *   memoised per `Geometry` in a `WeakMap` and verified by a full-array
+ *   compare on the first collision (a collision between unequal arrays yields
+ *   different keys).
+ * - `materialSpecKey(material)` — stable key over every scalar field and
+ *   texture identity, excluding `baseColor`, `emissive`/`emissiveIntensity`
+ *   and `opacity` (when ≥ 0.999): per-node colour and emissive ride
+ *   `RenderItem.instanceColors`/`instanceEmissive` instead, so materials that
+ *   differ only there still merge.
+ *
+ * Both are pure functions; no GPU work happens here.
+ */
+import { Material } from "../Material.js";
+import { MaterialInstance } from "../MaterialInstance.js";
+import { isTextureBinding } from "../TextureBinding.js";
+const geometryMemo = new WeakMap();
+/** Registration order per key, for the full-array collision check. */
+const geometryKeyOwners = new Map();
+const textureIds = new WeakMap();
+const materialMemo = new WeakMap();
+let nextTextureId = 1;
+let nextCollisionSuffix = 0;
+function textureIdentity(texture) {
+    if (!texture)
+        return 0;
+    let id = textureIds.get(texture);
+    if (id === undefined) {
+        id = nextTextureId;
+        nextTextureId += 1;
+        textureIds.set(texture, id);
+    }
+    return id;
+}
+function stableValue(value) {
+    if (value === null || value === undefined)
+        return "null";
+    if (typeof value === "number")
+        return Number.isFinite(value) ? String(value) : "nonfinite";
+    if (typeof value === "string" || typeof value === "boolean")
+        return JSON.stringify(value);
+    if (Array.isArray(value) || ArrayBuffer.isView(value)) {
+        return `[${Array.from(value, (entry) => stableValue(entry)).join(",")}]`;
+    }
+    if (typeof value === "object") {
+        const entries = Object.entries(value)
+            .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
+            .map(([k, v]) => `${JSON.stringify(k)}:${stableValue(v)}`);
+        return `{${entries.join(",")}}`;
+    }
+    return typeof value;
+}
+function uniformKeyValue(name, value) {
+    if (typeof value === "number")
+        return `n:${value}`;
+    if (isTextureBinding(value)) {
+        const binding = value;
+        return `t:${textureIdentity(binding.texture)}:${stableValue({
+            minFilter: binding.sampler.minFilter, magFilter: binding.sampler.magFilter,
+            addressU: binding.sampler.addressU, addressV: binding.sampler.addressV,
+            maxAnisotropy: binding.sampler.maxAnisotropy
+        })}:${binding.offset.join(",")}:${binding.scale.join(",")}:${binding.rotation}`;
+    }
+    return `a:${Array.from(value, (v) => stableValue(v)).join(",")}`;
+}
+/**
+ * Parameter names whose per-node value is carried by the merged draw, not by
+ * the material key. `u_`-prefixed uniforms and engine-level names both match.
+ */
+const COLOR_PARAMS = new Set(["baseColor"]);
+const EMISSIVE_PARAMS = new Set(["emissive", "emissiveColor", "emissiveStrength", "emissiveIntensity"]);
+const OPACITY_PARAMS = new Set(["opacity"]);
+function bareParamName(name) {
+    return name.startsWith("u_") ? name.slice(2) : name;
+}
+function opacityOf(parameters) {
+    for (const [name, value] of parameters) {
+        if (OPACITY_PARAMS.has(bareParamName(name)) && typeof value === "number")
+            return value;
+    }
+    return null;
+}
+/** True when `name` is a colour/emissive slot or an opacity slot equal to 1. */
+export function materialKeyExcludesParameter(name, parameters) {
+    const bare = bareParamName(name);
+    if (COLOR_PARAMS.has(bare) || EMISSIVE_PARAMS.has(bare))
+        return true;
+    if (OPACITY_PARAMS.has(bare)) {
+        const value = parameters.get(name);
+        return typeof value === "number" ? value >= 0.999 : true;
+    }
+    return false;
+}
+export function materialSpecKey(material) {
+    const base = material instanceof MaterialInstance ? material.baseMaterial : material;
+    const parameters = material.getParameters();
+    const memoized = materialMemo.get(material);
+    if (memoized && memoized.revision === base.getRevision())
+        return memoized.key;
+    const parts = [
+        `shader:${base.shaderKey}`,
+        `variant:${base.shaderVariant ?? ""}`,
+        `rs:${stableValue(base.renderState)}`
+    ];
+    const opacity = opacityOf(parameters);
+    for (const name of [...parameters.keys()].sort()) {
+        if (materialKeyExcludesParameter(name, parameters))
+            continue;
+        parts.push(`${name}=${uniformKeyValue(name, parameters.get(name))}`);
+    }
+    // Opacity below the exclusion threshold still batches: alpha rides baseColor.
+    if (opacity !== null && opacity < 0.999)
+        parts.push(`opacity<0.999:${opacity}`);
+    const key = parts.join("|");
+    materialMemo.set(material, { key, revision: base.getRevision() });
+    return key;
+}
+function geometryDescriptor(geometry) {
+    const descriptor = geometry.__a3dPrimitiveDescriptor;
+    return descriptor ? `prim:${stableValue(descriptor)}` : null;
+}
+/**
+ * 64-bit FNV-1a over a strided sample of the interleaved vertex data plus the
+ * whole index buffer. Vertex samples stay cheap for large buffers; the
+ * collision-verification pass below is what makes equal keys trustworthy.
+ */
+function geometryHash(geometry) {
+    const vertex = geometry.vertexBuffer;
+    const floats = vertex.floats;
+    const indices = geometry.indexBuffer?.data ?? null;
+    const strideFloats = Math.max(1, vertex.format.stride >> 2);
+    const maxSampledVertices = 64;
+    const step = Math.max(1, Math.floor(vertex.vertexCount / maxSampledVertices));
+    let h1 = 0x811c9dc5 ^ 0x9e3779b9;
+    let h2 = 0x811c9dc5 ^ 0xc4ceb9fe;
+    const mix = (value) => {
+        const bits = Math.fround(value) * 2654435761;
+        h1 = Math.imul(h1 ^ bits, 16777619);
+        h2 = Math.imul(h2 + bits, 16777619 + 0x9e3779b9);
+    };
+    for (let i = 0; i < vertex.vertexCount; i += step) {
+        const base = i * strideFloats;
+        for (let c = 0; c < strideFloats; c += 1)
+            mix(floats[base + c] ?? 0);
+    }
+    if (indices) {
+        for (let i = 0; i < indices.length; i += 1)
+            mix(indices[i]);
+    }
+    return `${(h1 >>> 0).toString(36)}${(h2 >>> 0).toString(36)}`;
+}
+function vertexDataEquals(a, b) {
+    const fa = a.vertexBuffer.floats;
+    const fb = b.vertexBuffer.floats;
+    if (fa.length !== fb.length)
+        return false;
+    for (let i = 0; i < fa.length; i += 1)
+        if (fa[i] !== fb[i])
+            return false;
+    const ia = a.indexBuffer?.data ?? null;
+    const ib = b.indexBuffer?.data ?? null;
+    if ((ia === null) !== (ib === null))
+        return false;
+    if (ia && ib) {
+        if (ia.length !== ib.length)
+            return false;
+        for (let i = 0; i < ia.length; i += 1)
+            if (ia[i] !== ib[i])
+                return false;
+    }
+    return true;
+}
+export function geometryContentKey(geometry) {
+    const memoized = geometryMemo.get(geometry);
+    if (memoized)
+        return memoized;
+    const descriptor = geometryDescriptor(geometry);
+    let key = descriptor ?? [
+        "hash",
+        geometry.topology,
+        geometry.vertexBuffer.vertexCount,
+        geometry.indexBuffer?.count ?? 0,
+        geometry.vertexBuffer.format.attributes.map((a) => `${a.semantic}:${a.components}`).join(","),
+        geometryHash(geometry)
+    ].join(":");
+    // Full-array compare on first collision: equal data keeps the shared key,
+    // unequal data gets a disambiguating suffix (deterministic in registration
+    // order, memoised per Geometry forever after).
+    if (!descriptor) {
+        const owners = geometryKeyOwners.get(key);
+        if (owners) {
+            let verified = false;
+            for (const other of owners) {
+                if (vertexDataEquals(geometry, other)) {
+                    verified = true;
+                    break;
+                }
+            }
+            if (!verified) {
+                key = `${key}#c${nextCollisionSuffix}`;
+                nextCollisionSuffix += 1;
+            }
+            owners.push(geometry);
+        }
+        else {
+            geometryKeyOwners.set(key, [geometry]);
+        }
+    }
+    geometryMemo.set(geometry, key);
+    return key;
+}
+//# sourceMappingURL=ContentKeys.js.map

package/dist/rendering/batching/ContentKeys.js.map

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

package/dist/rendering/batching/DrawDataTexture.d.ts

@@ -0,0 +1,51 @@
+/**
+ * PRD 11 Phase 3 (§6.6 layer 3) — `DrawDataTexture` is the per-draw data
+ * source the `a3d_prd11_draw_id` chunk fetches. Each draw occupies
+ * `TEXELS_PER_DRAW` RGBA32F texels in a single-row texture:
+ *
+ *   [0..3]  model matrix columns 0..3 (mat4)
+ *   [4]     base colour (linear RGBA; multiplies the shared material)
+ *   [5]     meta — (firstIndex, baseVertex, indexCount, flags)
+ *
+ * `gl_DrawID` (with `WEBGL_multi_draw`) or the `u_drawId` uniform (loop
+ * fallback) selects the row offset `drawIndex * TEXELS_PER_DRAW`.
+ */
+import { Texture, type TextureDescriptor } from "../Texture.js";
+import type { UniformValue } from "../RenderDevice.js";
+export declare const DRAW_DATA_TEXELS_PER_DRAW = 6;
+export interface DrawDataEntry {
+    /** Column-major mat4. */
+    readonly model: ArrayLike<number>;
+    readonly baseColor?: ArrayLike<number>;
+    /** Packed meta texel; defaults to firstIndex=baseVertex=indexCount=flags=0. */
+    readonly meta?: ArrayLike<number>;
+}
+export declare class DrawDataTexture {
+    readonly maxDraws: number;
+    private readonly data;
+    private texture;
+    private dirty;
+    private restoreRegistered;
+    constructor(maxDraws: number);
+    setDraw(drawIndex: number, entry: DrawDataEntry): void;
+    /** Uniform snapshot for tests and the `u_drawId` loop path. */
+    drawTexels(drawIndex: number): Float32Array;
+    descriptor(): TextureDescriptor;
+    /** Materializes/re-uploads only when marked dirty; the Texture itself is CPU data until the device binds it. */
+    upload(): Texture;
+    /**
+     * PRD 11 Phase 5 (§6.9): register with the C-29 `ResourceRegistry` once.
+     * The CPU-side `data` array IS the retained source — the restore rebuild
+     * marks the texture dirty and re-uploads it.
+     */
+    registerForRestore(registry: {
+        register<T extends object>(handle: T, descriptor: {
+            kind: string;
+            rebuild: () => Promise<void> | void;
+        }): T;
+    }): void;
+    /** `sampler2D` binding ready for `uniforms.set("u_a3dDrawData", ...)`. */
+    asUniform(): UniformValue;
+    dispose(): void;
+}
+//# sourceMappingURL=DrawDataTexture.d.ts.map

package/dist/rendering/batching/DrawDataTexture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DrawDataTexture.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/batching/DrawDataTexture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACvC,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;CACnC;AAED,qBAAa,eAAe;IAMd,QAAQ,CAAC,QAAQ,EAAE,MAAM;IALrC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;IACpC,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,iBAAiB,CAAS;gBAEb,QAAQ,EAAE,MAAM;IAOrC,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI;IAmBtD,+DAA+D;IAC/D,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY;IAK3C,UAAU,IAAI,iBAAiB;IAW/B,gHAAgH;IAChH,MAAM,IAAI,OAAO;IASjB;;;;OAIG;IACH,kBAAkB,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;SAAE,GAAG,CAAC,CAAA;KAAE,GAAG,IAAI;IAanJ,0EAA0E;IAC1E,SAAS,IAAI,YAAY;IAIzB,OAAO,IAAI,IAAI;CAIhB"}

package/dist/rendering/batching/DrawDataTexture.js

@@ -0,0 +1,99 @@
+/**
+ * PRD 11 Phase 3 (§6.6 layer 3) — `DrawDataTexture` is the per-draw data
+ * source the `a3d_prd11_draw_id` chunk fetches. Each draw occupies
+ * `TEXELS_PER_DRAW` RGBA32F texels in a single-row texture:
+ *
+ *   [0..3]  model matrix columns 0..3 (mat4)
+ *   [4]     base colour (linear RGBA; multiplies the shared material)
+ *   [5]     meta — (firstIndex, baseVertex, indexCount, flags)
+ *
+ * `gl_DrawID` (with `WEBGL_multi_draw`) or the `u_drawId` uniform (loop
+ * fallback) selects the row offset `drawIndex * TEXELS_PER_DRAW`.
+ */
+import { Texture } from "../Texture.js";
+import { TextureBinding } from "../TextureBinding.js";
+export const DRAW_DATA_TEXELS_PER_DRAW = 6;
+export class DrawDataTexture {
+    maxDraws;
+    data;
+    texture = null;
+    dirty = true;
+    restoreRegistered = false;
+    constructor(maxDraws) {
+        this.maxDraws = maxDraws;
+        if (!Number.isInteger(maxDraws) || maxDraws <= 0) {
+            throw new RangeError("DrawDataTexture maxDraws must be a positive integer");
+        }
+        this.data = new Float32Array(maxDraws * DRAW_DATA_TEXELS_PER_DRAW * 4);
+    }
+    setDraw(drawIndex, entry) {
+        if (drawIndex < 0 || drawIndex >= this.maxDraws) {
+            throw new RangeError(`Draw index ${drawIndex} outside DrawDataTexture capacity ${this.maxDraws}`);
+        }
+        const base = drawIndex * DRAW_DATA_TEXELS_PER_DRAW * 4;
+        for (let i = 0; i < 16; i += 1)
+            this.data[base + i] = entry.model[i] ?? (i % 5 === 0 ? 1 : 0);
+        const color = entry.baseColor;
+        this.data[base + 16] = color?.[0] ?? 1;
+        this.data[base + 17] = color?.[1] ?? 1;
+        this.data[base + 18] = color?.[2] ?? 1;
+        this.data[base + 19] = color?.[3] ?? 1;
+        const meta = entry.meta;
+        this.data[base + 20] = meta?.[0] ?? 0;
+        this.data[base + 21] = meta?.[1] ?? 0;
+        this.data[base + 22] = meta?.[2] ?? 0;
+        this.data[base + 23] = meta?.[3] ?? 0;
+        this.dirty = true;
+    }
+    /** Uniform snapshot for tests and the `u_drawId` loop path. */
+    drawTexels(drawIndex) {
+        const base = drawIndex * DRAW_DATA_TEXELS_PER_DRAW * 4;
+        return this.data.subarray(base, base + DRAW_DATA_TEXELS_PER_DRAW * 4);
+    }
+    descriptor() {
+        return {
+            width: this.maxDraws * DRAW_DATA_TEXELS_PER_DRAW,
+            height: 1,
+            format: "rgba32f",
+            colorSpace: "linear",
+            label: "a3d-prd11-draw-data",
+            data: this.data
+        };
+    }
+    /** Materializes/re-uploads only when marked dirty; the Texture itself is CPU data until the device binds it. */
+    upload() {
+        if (!this.texture || this.dirty) {
+            this.texture?.dispose();
+            this.texture = new Texture(this.descriptor());
+            this.dirty = false;
+        }
+        return this.texture;
+    }
+    /**
+     * PRD 11 Phase 5 (§6.9): register with the C-29 `ResourceRegistry` once.
+     * The CPU-side `data` array IS the retained source — the restore rebuild
+     * marks the texture dirty and re-uploads it.
+     */
+    registerForRestore(registry) {
+        if (this.restoreRegistered)
+            return;
+        this.restoreRegistered = true;
+        registry.register(this, {
+            kind: "a3d-prd11-draw-data",
+            rebuild: () => {
+                this.texture?.dispose();
+                this.texture = null;
+                this.upload();
+            }
+        });
+    }
+    /** `sampler2D` binding ready for `uniforms.set("u_a3dDrawData", ...)`. */
+    asUniform() {
+        return new TextureBinding({ name: "u_a3dDrawData", texture: this.upload(), required: false });
+    }
+    dispose() {
+        this.texture?.dispose();
+        this.texture = null;
+    }
+}
+//# sourceMappingURL=DrawDataTexture.js.map

package/dist/rendering/batching/DrawDataTexture.js.map

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

package/dist/rendering/batching/MultiDrawBatch.d.ts

@@ -0,0 +1,64 @@
+/**
+ * PRD 11 Phase 3 (§6.6 layer 3) — `MultiDrawBatch` is the device-facing side of
+ * a `MultiDrawGroup`: it packs every member into a `BatchedGeometryPool`,
+ * records each member's transform/colour/meta into a `DrawDataTexture`, and
+ * materializes the `DrawCommand[]` the submit path hands to
+ * `device.multiDrawElementsInstanced` (extension path) or issues one-by-one
+ * with `u_drawId` bound (loop fallback).
+ *
+ * While the C-02 program generator is a stub the planner marks leftover
+ * members `multi-draw-generator-pending` and this builder stays test-side;
+ * its shapes are exactly what the generated `prd11.drawId` program consumes.
+ */
+import type { PrimitiveTopology, RenderBuffer, RenderDevice, RenderShaderProgram, UniformValue } from "../RenderDevice.js";
+import type { VertexFormat } from "../VertexFormat.js";
+import type { RenderCommandState } from "../RenderDevice.js";
+import { BatchedGeometryPool, type PackedGeometryEntry } from "./BatchedGeometryPool.js";
+import { DrawDataTexture } from "./DrawDataTexture.js";
+import type { MultiDrawGroup } from "./StaticMergePlanner.js";
+import type { RenderItem } from "../contracts/renderItem.js";
+export interface MultiDrawBatch {
+    readonly group: MultiDrawGroup;
+    readonly entries: readonly PackedGeometryEntry[];
+    readonly drawData: DrawDataTexture;
+    readonly pool: BatchedGeometryPool;
+}
+export interface PackedDrawCommand {
+    readonly label?: string;
+    readonly topology: PrimitiveTopology;
+    readonly renderState?: RenderCommandState;
+    readonly vertexBuffer: RenderBuffer;
+    readonly vertexFormat: VertexFormat;
+    readonly vertexCount: number;
+    readonly indexBuffer?: RenderBuffer;
+    readonly indexType?: "uint16" | "uint32";
+    readonly indexCount?: number;
+    readonly firstIndex?: number;
+    readonly firstVertex?: number;
+    readonly drawIndex: number;
+    readonly shader?: RenderShaderProgram;
+    readonly uniforms?: ReadonlyMap<string, UniformValue>;
+    readonly item: RenderItem;
+}
+/**
+ * Packs `group` into `pool` (or a fresh one) and writes the draw-data rows.
+ * All members share `vertexLayoutKey`, so one pool per group is the norm.
+ */
+export declare function buildMultiDrawBatch(group: MultiDrawGroup, pool?: BatchedGeometryPool): MultiDrawBatch;
+/**
+ * One `DrawCommand`-shaped entry per member against the shared arenas. The
+ * `u_drawId` uniform loop binds `drawIndex` itself; the extension path reads
+ * `gl_DrawID` in-shader. `u_a3dDrawData` is bound on every command either way
+ * so the same program source works for both.
+ */
+export declare function multiDrawCommands(device: RenderDevice, batch: MultiDrawBatch, shared?: {
+    shader?: RenderShaderProgram;
+    uniforms?: ReadonlyMap<string, UniformValue>;
+}): PackedDrawCommand[];
+/**
+ * Issues the batch. Extension present → one `multiDrawElementsInstanced` call;
+ * absent → the same commands go through `device.draw` (identical pixels via
+ * the `u_drawId` uniform fallback) so the loop path is correct everywhere.
+ */
+export declare function submitMultiDrawBatch(device: RenderDevice, batch: MultiDrawBatch, commands: readonly PackedDrawCommand[], multiDrawExtension: boolean): void;
+//# sourceMappingURL=MultiDrawBatch.d.ts.map

package/dist/rendering/batching/MultiDrawBatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultiDrawBatch.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/batching/MultiDrawBatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAe,iBAAiB,EAAE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACrI,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAI1D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;CACpC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACtD,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC3B;AAoBD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,cAAc,EAAE,IAAI,sBAA4B,GAAG,cAAc,CAiB3G;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;CAAE,GAAG,iBAAiB,EAAE,CA2B3L;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,iBAAiB,EAAE,EAAE,kBAAkB,EAAE,OAAO,GAAG,IAAI,CAQ3J"}

package/dist/rendering/batching/MultiDrawBatch.js

@@ -0,0 +1,103 @@
+/**
+ * PRD 11 Phase 3 (§6.6 layer 3) — `MultiDrawBatch` is the device-facing side of
+ * a `MultiDrawGroup`: it packs every member into a `BatchedGeometryPool`,
+ * records each member's transform/colour/meta into a `DrawDataTexture`, and
+ * materializes the `DrawCommand[]` the submit path hands to
+ * `device.multiDrawElementsInstanced` (extension path) or issues one-by-one
+ * with `u_drawId` bound (loop fallback).
+ *
+ * While the C-02 program generator is a stub the planner marks leftover
+ * members `multi-draw-generator-pending` and this builder stays test-side;
+ * its shapes are exactly what the generated `prd11.drawId` program consumes.
+ */
+import { BatchedGeometryPool } from "./BatchedGeometryPool.js";
+import { DrawDataTexture } from "./DrawDataTexture.js";
+import { MaterialInstance } from "../MaterialInstance.js";
+import { sharedResourceRegistry } from "../resources/ResourceRegistry.js";
+const identityModel = [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1];
+function renderStateOf(item) {
+    const material = item.material;
+    if (!material)
+        return undefined;
+    const base = material instanceof MaterialInstance ? material.baseMaterial : material;
+    return base.renderState;
+}
+function modelOf(item) {
+    return item.modelMatrix ?? identityModel;
+}
+function colorOf(item) {
+    const value = item.material?.getParameters().get("u_baseColor");
+    return value && typeof value !== "number" ? value : undefined;
+}
+/**
+ * Packs `group` into `pool` (or a fresh one) and writes the draw-data rows.
+ * All members share `vertexLayoutKey`, so one pool per group is the norm.
+ */
+export function buildMultiDrawBatch(group, pool = new BatchedGeometryPool()) {
+    const drawData = new DrawDataTexture(Math.max(group.members.length, 1));
+    // Phase 5 (§6.9): CPU arrays are retained sources — register both so the
+    // C-29 registry rebuilds the arenas and data texture after context restore.
+    pool.registerForRestore(sharedResourceRegistry());
+    drawData.registerForRestore(sharedResourceRegistry());
+    const entries = [];
+    group.members.forEach((item, drawIndex) => {
+        const entry = pool.pack(item.geometry);
+        entries.push(entry);
+        drawData.setDraw(drawIndex, {
+            model: modelOf(item),
+            baseColor: colorOf(item),
+            meta: [entry.firstIndex, entry.baseVertex, entry.indexCount, 0]
+        });
+    });
+    return { group, entries, drawData, pool };
+}
+/**
+ * One `DrawCommand`-shaped entry per member against the shared arenas. The
+ * `u_drawId` uniform loop binds `drawIndex` itself; the extension path reads
+ * `gl_DrawID` in-shader. `u_a3dDrawData` is bound on every command either way
+ * so the same program source works for both.
+ */
+export function multiDrawCommands(device, batch, shared) {
+    const { vertexBuffer, indexBuffer, indexType } = batch.pool.upload(device);
+    const vertexFormat = batch.pool.vertexFormat;
+    if (!vertexFormat)
+        throw new Error("MultiDrawBatch has no packed geometry");
+    const dataBinding = batch.drawData.asUniform();
+    return batch.entries.map((entry, drawIndex) => {
+        const uniforms = new Map(shared?.uniforms ?? []);
+        uniforms.set("u_drawId", drawIndex);
+        uniforms.set("u_a3dDrawData", dataBinding);
+        return {
+            label: batch.group.members[drawIndex].label,
+            topology: batch.group.members[drawIndex].geometry.topology,
+            renderState: renderStateOf(batch.group.members[drawIndex]),
+            vertexBuffer,
+            vertexFormat,
+            vertexCount: entry.vertexCount,
+            firstVertex: entry.firstIndex >= 0 ? undefined : entry.baseVertex,
+            indexBuffer: indexBuffer ?? undefined,
+            indexType: indexBuffer ? indexType : undefined,
+            indexCount: entry.firstIndex >= 0 ? entry.indexCount : undefined,
+            firstIndex: entry.firstIndex >= 0 ? entry.firstIndex : undefined,
+            drawIndex,
+            shader: shared?.shader,
+            uniforms,
+            item: batch.group.members[drawIndex]
+        };
+    });
+}
+/**
+ * Issues the batch. Extension present → one `multiDrawElementsInstanced` call;
+ * absent → the same commands go through `device.draw` (identical pixels via
+ * the `u_drawId` uniform fallback) so the loop path is correct everywhere.
+ */
+export function submitMultiDrawBatch(device, batch, commands, multiDrawExtension) {
+    if (multiDrawExtension && typeof device.multiDrawElementsInstanced === "function") {
+        device.multiDrawElementsInstanced(commands);
+        return;
+    }
+    for (const command of commands) {
+        device.draw(command);
+    }
+}
+//# sourceMappingURL=MultiDrawBatch.js.map

package/dist/rendering/batching/MultiDrawBatch.js.map

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