@aura3d/rendering 3.0.1 → 4.0.2

package/dist/performance/BVH.js

@@ -1,2 +1,214 @@
 export { buildStaticBoundsBvh, queryStaticBoundsBvh, raycastStaticBoundsBvh, updateStaticBoundsBvh } from "../SceneOptimization.js";
+/** Union of `bounds` (the merged bounds a BatchPlan group is culled against). */
+export function mergeBatchBounds(bounds) {
+    if (bounds.length === 0)
+        throw new Error("mergeBatchBounds: empty group");
+    const min = [Infinity, Infinity, Infinity];
+    const max = [-Infinity, -Infinity, -Infinity];
+    for (const box of bounds) {
+        for (let axis = 0; axis < 3; axis += 1) {
+            min[axis] = Math.min(min[axis], box.min[axis]);
+            max[axis] = Math.max(max[axis], box.max[axis]);
+        }
+    }
+    return { min, max };
+}
+/** Drop BatchPlan members from the per-item BVH input; their group hint culls them instead. */
+export function excludeBatchedBvhItems(items, hints) {
+    const batched = new Set();
+    for (const hint of hints)
+        for (const id of hint.memberIds)
+            batched.add(id);
+    return items.filter((item) => !batched.has(item.id));
+}
+/**
+ * Cull each group once against its merged bounds: `isVisible` runs one test
+ * per hint (not per member). Returns the visible member ids and the number
+ * of bounds tests issued.
+ */
+export function cullBatchHints(hints, isVisible) {
+    const visibleMemberIds = [];
+    const visibleHints = [];
+    let tests = 0;
+    for (const hint of hints) {
+        tests += 1;
+        if (!isVisible(hint.bounds))
+            continue;
+        visibleHints.push(hint.id);
+        visibleMemberIds.push(...hint.memberIds);
+    }
+    return { visibleMemberIds, visibleHints, tests };
+}
+const MISS = { hit: false, distance: Number.POSITIVE_INFINITY, nodeId: -1, item: null, point: null };
+/**
+ * Ray entry/exit against `bounds` grown by `radius` on every side; `null` when
+ * the ray misses or the entry is past `maxT`. The grown box contains the
+ * rounded box (bounds ⊕ sphere), so this is a conservative pre-test.
+ */
+function slab(origin, dir, bounds, radius, maxT) {
+    let tMin = 0;
+    let tMax = maxT;
+    for (let axis = 0; axis < 3; axis += 1) {
+        const lo = bounds.min[axis] - radius;
+        const hi = bounds.max[axis] + radius;
+        const o = origin[axis];
+        const d = dir[axis];
+        if (Math.abs(d) < 1e-12) {
+            if (o < lo || o > hi)
+                return null;
+            continue;
+        }
+        let t0 = (lo - o) / d;
+        let t1 = (hi - o) / d;
+        if (t0 > t1) {
+            const swap = t0;
+            t0 = t1;
+            t1 = swap;
+        }
+        if (t0 > tMin)
+            tMin = t0;
+        if (t1 < tMax)
+            tMax = t1;
+        if (tMin > tMax)
+            return null;
+    }
+    return [tMin, tMax];
+}
+/** Exact Euclidean distance from point `(x, y, z)` to the box (0 inside). */
+function boxDistance(x, y, z, bounds) {
+    const dx = Math.max(bounds.min[0] - x, 0, x - bounds.max[0]);
+    const dy = Math.max(bounds.min[1] - y, 0, y - bounds.max[1]);
+    const dz = Math.max(bounds.min[2] - z, 0, z - bounds.max[2]);
+    return Math.hypot(dx, dy, dz);
+}
+/** Smallest root t >= 0 of a·t² + 2b·t + c = 0, or null. Callers ensure the start is outside. */
+function firstRoot(a, b, c) {
+    if (a <= 0)
+        return null;
+    const disc = b * b - a * c;
+    if (disc < 0)
+        return null;
+    const t = (-b - Math.sqrt(disc)) / a;
+    return t >= 0 ? t : null;
+}
+/**
+ * First contact of a sphere of `radius` moving from `origin` along unit `dir`
+ * with the box, as a distance in `[0, maxT]`, or `null`. Analytic ray test
+ * against the rounded box (bounds ⊕ sphere), which is exactly the union of the
+ * box grown along one axis at a time (faces), 12 edge cylinders and 8 corner
+ * spheres. Solved from the grown-box entry point so long sweeps stay precise;
+ * tangent contacts resolve exactly (no iteration).
+ */
+function sweepBox(origin, dir, bounds, radius, maxT) {
+    if (boxDistance(origin[0], origin[1], origin[2], bounds) <= radius)
+        return 0;
+    const range = slab(origin, dir, bounds, radius, maxT);
+    if (!range)
+        return null;
+    const t0 = range[0];
+    // Local frame: start at the grown-box entry, coordinates relative to the box minimum.
+    const o = [0, 0, 0];
+    const size = [0, 0, 0];
+    for (let axis = 0; axis < 3; axis += 1) {
+        o[axis] = origin[axis] + dir[axis] * t0 - bounds.min[axis];
+        size[axis] = bounds.max[axis] - bounds.min[axis];
+    }
+    let best = Number.POSITIVE_INFINITY;
+    // Faces: the box grown by `radius` along one axis only.
+    for (let axis = 0; axis < 3; axis += 1) {
+        const grown = {
+            min: [axis === 0 ? -radius : 0, axis === 1 ? -radius : 0, axis === 2 ? -radius : 0],
+            max: [size[0] + (axis === 0 ? radius : 0), size[1] + (axis === 1 ? radius : 0), size[2] + (axis === 2 ? radius : 0)]
+        };
+        const hit = slab(o, dir, grown, 0, best);
+        if (hit)
+            best = Math.min(best, hit[0]);
+    }
+    const r2 = radius * radius;
+    // Edges: cylinders of `radius` along each axis, at the 4 corners of the other two axes.
+    for (let axis = 0; axis < 3; axis += 1) {
+        const u = (axis + 1) % 3;
+        const v = (axis + 2) % 3;
+        for (const cu of [0, size[u]]) {
+            for (const cv of [0, size[v]]) {
+                const pu = o[u] - cu;
+                const pv = o[v] - cv;
+                const t = firstRoot(dir[u] * dir[u] + dir[v] * dir[v], pu * dir[u] + pv * dir[v], pu * pu + pv * pv - r2);
+                if (t === null || t >= best)
+                    continue;
+                const along = o[axis] + dir[axis] * t;
+                if (along >= 0 && along <= size[axis])
+                    best = t;
+            }
+        }
+    }
+    // Corners: spheres of `radius` at the 8 box corners.
+    for (const cx of [0, size[0]]) {
+        for (const cy of [0, size[1]]) {
+            for (const cz of [0, size[2]]) {
+                const px = o[0] - cx;
+                const py = o[1] - cy;
+                const pz = o[2] - cz;
+                const t = firstRoot(1, px * dir[0] + py * dir[1] + pz * dir[2], px * px + py * py + pz * pz - r2);
+                if (t !== null && t < best)
+                    best = t;
+            }
+        }
+    }
+    if (!Number.isFinite(best))
+        return null;
+    const distance = t0 + best;
+    return distance <= maxT ? distance : null;
+}
+/**
+ * #215: sweep a sphere from `from` to `to` through a static-bounds BVH and
+ * return the first item it touches. A sphere already touching an item at
+ * `from` hits at distance 0. Traversal visits children nearest-first and
+ * prunes nodes whose grown-box entry is beyond the best hit.
+ */
+export function sphereSweep(bvh, from, to, radius) {
+    if (!Number.isFinite(radius) || radius < 0) {
+        throw new RangeError("sphereSweep radius must be a finite non-negative number.");
+    }
+    const delta = [to[0] - from[0], to[1] - from[1], to[2] - from[2]];
+    const length = Math.hypot(delta[0], delta[1], delta[2]);
+    const dir = length > 0 ? [delta[0] / length, delta[1] / length, delta[2] / length] : [0, 0, 0];
+    let bestDistance = Number.POSITIVE_INFINITY;
+    let bestIndex = -1;
+    let bestNode = -1;
+    const visit = (node) => {
+        const limit = Math.min(length, bestDistance);
+        if (!slab(from, dir, node.bounds, radius, limit))
+            return;
+        if (node.itemIndices) {
+            for (const index of node.itemIndices) {
+                const distance = sweepBox(from, dir, bvh.items[index].bounds, radius, Math.min(length, bestDistance));
+                if (distance !== null && distance < bestDistance) {
+                    bestDistance = distance;
+                    bestIndex = index;
+                    bestNode = node.id;
+                }
+            }
+            return;
+        }
+        const children = [node.left, node.right].filter((child) => child !== undefined);
+        const entries = children.map((child) => slab(from, dir, child.bounds, radius, Math.min(length, bestDistance))?.[0] ?? Number.POSITIVE_INFINITY);
+        const order = entries[1] !== undefined && entries[1] < entries[0] ? [1, 0] : [0, 1];
+        for (const position of order) {
+            const child = children[position];
+            if (child && entries[position] <= bestDistance)
+                visit(child);
+        }
+    };
+    visit(bvh.root);
+    if (bestIndex < 0)
+        return MISS;
+    return {
+        hit: true,
+        distance: bestDistance,
+        nodeId: bestNode,
+        item: bvh.items[bestIndex],
+        point: [from[0] + dir[0] * bestDistance, from[1] + dir[1] * bestDistance, from[2] + dir[2] * bestDistance]
+    };
+}
 //# sourceMappingURL=BVH.js.map

package/dist/performance/BVH.js.map

@@ -1 +1 @@
-{"version":3,"file":"BVH.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/performance/BVH.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"BVH.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/performance/BVH.ts"],"names":[],"mappings":"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"}

package/dist/performance/Batcher.d.ts

@@ -1,3 +1,14 @@
+/**
+ * @deprecated PRD-11 Wave D: `performance/Batcher` is a forwarding shim kept so
+ * existing deep imports keep working unchanged. Static batching lives in
+ * `batching/StaticMergePlanner` (`planBatches`); the legacy
+ * `batchStaticRenderItems` helper lives in `SceneOptimization`. Import from
+ * those modules directly — this file will be removed with the PRD-11 flag.
+ */
+/** @deprecated Import `planBatches` from `batching/StaticMergePlanner`. */
+export { planBatches } from "../batching/StaticMergePlanner.js";
+export type { BatchPlan, PlanBatchesOptions } from "../batching/StaticMergePlanner.js";
+/** @deprecated Import `batchStaticRenderItems` from `SceneOptimization`. */
 export { batchStaticRenderItems } from "../SceneOptimization.js";
 export type { StaticBatchInput, StaticBatchOptions, StaticBatchResult } from "../SceneOptimization.js";
 //# sourceMappingURL=Batcher.d.ts.map

package/dist/performance/Batcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Batcher.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/performance/Batcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"Batcher.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/performance/Batcher.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,2EAA2E;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,YAAY,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpF,4EAA4E;AAC5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/performance/Batcher.js

@@ -1,2 +1,12 @@
+/**
+ * @deprecated PRD-11 Wave D: `performance/Batcher` is a forwarding shim kept so
+ * existing deep imports keep working unchanged. Static batching lives in
+ * `batching/StaticMergePlanner` (`planBatches`); the legacy
+ * `batchStaticRenderItems` helper lives in `SceneOptimization`. Import from
+ * those modules directly — this file will be removed with the PRD-11 flag.
+ */
+/** @deprecated Import `planBatches` from `batching/StaticMergePlanner`. */
+export { planBatches } from "../batching/StaticMergePlanner.js";
+/** @deprecated Import `batchStaticRenderItems` from `SceneOptimization`. */
 export { batchStaticRenderItems } from "../SceneOptimization.js";
 //# sourceMappingURL=Batcher.js.map

package/dist/performance/Batcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"Batcher.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/performance/Batcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"Batcher.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/performance/Batcher.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,2EAA2E;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAE7D,4EAA4E;AAC5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/performance/FrustumCuller.d.ts

@@ -1,3 +1,32 @@
 import type { StaticBoundsIntersector, StaticSpatialItem } from "../SceneOptimization.js";
+/**
+ * PRD-11 11-S5 culler — allocation-free frustum culling over packed bounds.
+ *
+ * `bounds` (Float32Array or Float64Array) packs `count` AABBs as `[minX, minY, minZ, maxX, maxY, maxZ]` per
+ * item; `planes` packs 6 planes as `[nx, ny, nz, d]` (inside when
+ * `n·p + d >= 0`, the `@aura3d/math` `Plane` convention). `out[i]` is set to
+ * 1 when item `i` is inside or intersecting, 0 when culled. Returns the
+ * visible count. Uses the positive-vertex test, so it is conservative
+ * (never culls a visible box). No allocation per call or per item.
+ */
+type PackedFloats = Float32Array | Float64Array;
+export declare function cull(bounds: PackedFloats, count: number, planes: PackedFloats, out: Uint8Array): number;
+interface PlaneLike {
+    readonly normal: {
+        readonly x: number;
+        readonly y: number;
+        readonly z: number;
+    };
+    readonly constant: number;
+}
+/** Packs `@aura3d/math` `Frustum.planes` (or any `{normal, constant}` list) into `out` for `cull`. */
+export declare function packFrustumPlanes<O extends PackedFloats = Float64Array>(planes: readonly PlaneLike[], out?: O): O;
+/**
+ * Culls static items against a frustum. When the intersector exposes
+ * `planes` (the `@aura3d/math` `Frustum`), this runs the allocation-free
+ * plane test with no per-item `Box3`/`Vector3`; other intersectors keep the
+ * `intersectsBox(Box3)` contract.
+ */
 export declare function cullStaticItems<T>(items: readonly StaticSpatialItem<T>[], frustum: StaticBoundsIntersector): readonly StaticSpatialItem<T>[];
+export {};
 //# sourceMappingURL=FrustumCuller.d.ts.map

package/dist/performance/FrustumCuller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FrustumCuller.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/performance/FrustumCuller.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEvF,wBAAgB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,iBAAiB,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,uBAAuB,GAAG,SAAS,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAK5I"}
+{"version":3,"file":"FrustumCuller.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/performance/FrustumCuller.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEvF;;;;;;;;;GASG;AACH,KAAK,YAAY,GAAG,YAAY,GAAG,YAAY,CAAC;AAEhD,wBAAgB,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,UAAU,GAAG,MAAM,CA+BvG;AAED,UAAU,SAAS;IACjB,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,sGAAsG;AACtG,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,EAAE,MAAM,EAAE,SAAS,SAAS,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAUjH;AAYD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,iBAAiB,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,uBAAuB,GAAG,SAAS,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAmB5I"}

package/dist/performance/FrustumCuller.js

@@ -1,5 +1,82 @@
 import { Box3, Vector3 } from "@aura3d/math";
+export function cull(bounds, count, planes, out) {
+    if (bounds.length < count * 6) {
+        throw new RangeError(`cull: bounds holds ${Math.floor(bounds.length / 6)} boxes, count is ${count}.`);
+    }
+    if (out.length < count) {
+        throw new RangeError(`cull: out holds ${out.length} entries, count is ${count}.`);
+    }
+    const planeCount = Math.floor(planes.length / 4);
+    let visible = 0;
+    for (let item = 0; item < count; item += 1) {
+        const base = item * 6;
+        const minX = bounds[base];
+        const minY = bounds[base + 1];
+        const minZ = bounds[base + 2];
+        const maxX = bounds[base + 3];
+        const maxY = bounds[base + 4];
+        const maxZ = bounds[base + 5];
+        // Same emptiness rule as Box3.isEmpty (`max < min` on any axis), so NaN bounds stay visible like before.
+        let inside = !(maxX < minX || maxY < minY || maxZ < minZ);
+        for (let plane = 0; inside && plane < planeCount; plane += 1) {
+            const p = plane * 4;
+            const nx = planes[p];
+            const ny = planes[p + 1];
+            const nz = planes[p + 2];
+            const distance = nx * (nx >= 0 ? maxX : minX) + ny * (ny >= 0 ? maxY : minY) + nz * (nz >= 0 ? maxZ : minZ) + planes[p + 3];
+            if (distance < 0)
+                inside = false;
+        }
+        out[item] = inside ? 1 : 0;
+        if (inside)
+            visible += 1;
+    }
+    return visible;
+}
+/** Packs `@aura3d/math` `Frustum.planes` (or any `{normal, constant}` list) into `out` for `cull`. */
+export function packFrustumPlanes(planes, out) {
+    const target = (out ?? new Float64Array(planes.length * 4));
+    for (let index = 0; index < planes.length; index += 1) {
+        const plane = planes[index];
+        target[index * 4] = plane.normal.x;
+        target[index * 4 + 1] = plane.normal.y;
+        target[index * 4 + 2] = plane.normal.z;
+        target[index * 4 + 3] = plane.constant;
+    }
+    return target;
+}
+function frustumPlanes(frustum) {
+    const planes = frustum.planes;
+    if (!Array.isArray(planes) || planes.length === 0)
+        return null;
+    for (const plane of planes) {
+        const candidate = plane;
+        if (!candidate || typeof candidate.constant !== "number" || !candidate.normal)
+            return null;
+    }
+    return planes;
+}
+/**
+ * Culls static items against a frustum. When the intersector exposes
+ * `planes` (the `@aura3d/math` `Frustum`), this runs the allocation-free
+ * plane test with no per-item `Box3`/`Vector3`; other intersectors keep the
+ * `intersectsBox(Box3)` contract.
+ */
 export function cullStaticItems(items, frustum) {
-    return items.filter((item) => frustum.intersectsBox(new Box3(new Vector3(item.bounds.min[0], item.bounds.min[1], item.bounds.min[2]), new Vector3(item.bounds.max[0], item.bounds.max[1], item.bounds.max[2]))));
+    const planes = frustumPlanes(frustum);
+    if (!planes) {
+        return items.filter((item) => frustum.intersectsBox(new Box3(new Vector3(item.bounds.min[0], item.bounds.min[1], item.bounds.min[2]), new Vector3(item.bounds.max[0], item.bounds.max[1], item.bounds.max[2]))));
+    }
+    const packedPlanes = packFrustumPlanes(planes);
+    // Float64 keeps the old Box3 path's exact boundary behaviour.
+    const bounds = new Float64Array(items.length * 6);
+    for (let index = 0; index < items.length; index += 1) {
+        const { min, max } = items[index].bounds;
+        bounds.set(min, index * 6);
+        bounds.set(max, index * 6 + 3);
+    }
+    const mask = new Uint8Array(items.length);
+    cull(bounds, items.length, packedPlanes, mask);
+    return items.filter((_, index) => mask[index] === 1);
 }
 //# sourceMappingURL=FrustumCuller.js.map

package/dist/performance/FrustumCuller.js.map

@@ -1 +1 @@
-{"version":3,"file":"FrustumCuller.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/performance/FrustumCuller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG7C,MAAM,UAAU,eAAe,CAAI,KAAsC,EAAE,OAAgC;IACzG,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,IAAI,CAC1D,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EACvE,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CACxE,CAAC,CAAC,CAAC;AACN,CAAC"}
+{"version":3,"file":"FrustumCuller.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/performance/FrustumCuller.ts"],"names":[],"mappings":"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"}

package/dist/performance/LOD.d.ts

@@ -4,5 +4,11 @@ export interface PerformanceLodLevel {
     readonly triangleBudget: number;
 }
 export declare function selectPerformanceLodLevel(levels: readonly PerformanceLodLevel[], distance: number): PerformanceLodLevel;
+/**
+ * @deprecated PRD-05 §6.3 — fixed-distance budget tiers are superseded by the
+ * `MSFT_lod`/`MSFT_screencoverage` chain written by `assets optimize` and
+ * selected by `LodSelector` (`A3D_QR_ASSETS_LOD`). Retained for pre-rebuild
+ * scenes only; do not use for new work.
+ */
 export declare function createDefaultPerformanceLodLevels(baseTriangles: number): readonly PerformanceLodLevel[];
 //# sourceMappingURL=LOD.d.ts.map

package/dist/performance/LOD.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LOD.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/performance/LOD.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,mBAAmB,CAIvH;AAED,wBAAgB,iCAAiC,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,mBAAmB,EAAE,CAOvG"}
+{"version":3,"file":"LOD.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/performance/LOD.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,mBAAmB,CAIvH;AAID;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,mBAAmB,EAAE,CAcvG"}

package/dist/performance/LOD.js

@@ -4,7 +4,19 @@ export function selectPerformanceLodLevel(levels, distance) {
     const sorted = [...levels].sort((a, b) => a.maxDistance - b.maxDistance);
     return sorted.find((level) => distance <= level.maxDistance) ?? sorted[sorted.length - 1];
 }
+let warnedDeprecatedLodLevels = false;
+/**
+ * @deprecated PRD-05 §6.3 — fixed-distance budget tiers are superseded by the
+ * `MSFT_lod`/`MSFT_screencoverage` chain written by `assets optimize` and
+ * selected by `LodSelector` (`A3D_QR_ASSETS_LOD`). Retained for pre-rebuild
+ * scenes only; do not use for new work.
+ */
 export function createDefaultPerformanceLodLevels(baseTriangles) {
+    if (!warnedDeprecatedLodLevels) {
+        warnedDeprecatedLodLevels = true;
+        console.warn("createDefaultPerformanceLodLevels is deprecated (PRD-05 §6.3): use the " +
+            "MSFT_lod chain from `assets optimize` + LodSelector under A3D_QR_ASSETS_LOD.");
+    }
     const triangles = Math.max(1, Math.floor(baseTriangles));
     return [
         { id: "lod0", maxDistance: 8, triangleBudget: triangles },

package/dist/performance/LOD.js.map

@@ -1 +1 @@
-{"version":3,"file":"LOD.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/performance/LOD.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,yBAAyB,CAAC,MAAsC,EAAE,QAAgB;IAChG,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IACvG,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;IACzE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,IAAI,KAAK,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;AAC7F,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,aAAqB;IACrE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;IACzD,OAAO;QACL,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,EAAE,cAAc,EAAE,SAAS,EAAE;QACzD,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,EAAE;QAC1F,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,iBAAiB,EAAE,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,EAAE;KACjH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"LOD.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/performance/LOD.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,yBAAyB,CAAC,MAAsC,EAAE,QAAgB;IAChG,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IACvG,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;IACzE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,IAAI,KAAK,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;AAC7F,CAAC;AAED,IAAI,yBAAyB,GAAG,KAAK,CAAC;AAEtC;;;;;GAKG;AACH,MAAM,UAAU,iCAAiC,CAAC,aAAqB;IACrE,IAAI,CAAC,yBAAyB,EAAE,CAAC;QAC/B,yBAAyB,GAAG,IAAI,CAAC;QACjC,OAAO,CAAC,IAAI,CACV,yEAAyE;YACzE,8EAA8E,CAC/E,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;IACzD,OAAO;QACL,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,EAAE,cAAc,EAAE,SAAS,EAAE;QACzD,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,EAAE;QAC1F,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,iBAAiB,EAAE,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,EAAE;KACjH,CAAC;AACJ,CAAC"}

package/dist/performance/RenderItemSorting.d.ts

@@ -7,6 +7,8 @@ export interface RenderQueueSortItem<T = unknown> {
     readonly batchKey?: string;
     readonly instanceCount?: number;
     readonly renderOrder?: number;
+    /** C-04 (§6.8): sub-order inside the transparent bucket — 0 = sorted back-to-front group (alpha/premultiplied/custom), 1 = unordered group drawn after it (additive/multiply). */
+    readonly blendRank?: number;
 }
 export interface RenderQueueSortOptions {
     readonly transparentBackToFront?: boolean;

package/dist/performance/RenderItemSorting.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RenderItemSorting.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/performance/RenderItemSorting.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,cAAc,GAAG,MAAM,GAAG,aAAa,CAAC;AAEnF,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,OAAO;IAC9C,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAC1C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;CAC1C;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,0BAA0B,CAAC;CAClD;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC;CAC1C;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,KAAK,EAAE,SAAS,mBAAmB,CAAC,CAAC,CAAC,EAAE,EACxC,OAAO,GAAE,sBAA2B,GACnC,eAAe,CAAC,CAAC,CAAC,CA8CpB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,cAAc,EAAE,iBAAiB,CAAC;IAC3C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,kBAAkB,EAAE,GAAG,kBAAkB,EAAE,CAO1F"}
+{"version":3,"file":"RenderItemSorting.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/performance/RenderItemSorting.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,cAAc,GAAG,MAAM,GAAG,aAAa,CAAC;AAEnF,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,OAAO;IAC9C,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,kLAAkL;IAClL,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAC1C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;CAC1C;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,0BAA0B,CAAC;CAClD;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC;CAC1C;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,KAAK,EAAE,SAAS,mBAAmB,CAAC,CAAC,CAAC,EAAE,EACxC,OAAO,GAAE,sBAA2B,GACnC,eAAe,CAAC,CAAC,CAAC,CAiDpB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,cAAc,EAAE,iBAAiB,CAAC;IAC3C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,kBAAkB,EAAE,GAAG,kBAAkB,EAAE,CAO1F"}

package/dist/performance/RenderItemSorting.js

@@ -14,7 +14,11 @@ export function sortRenderQueueItems(items, options = {}) {
         if (bucketDelta !== 0)
             return bucketDelta;
         if (left.bucket === "transparent" || right.bucket === "transparent") {
-            if (transparentBackToFront) {
+            // C-04: additive/multiply draw after the back-to-front alpha group.
+            const rankDelta = (left.blendRank ?? 0) - (right.blendRank ?? 0);
+            if (rankDelta !== 0)
+                return rankDelta;
+            if (transparentBackToFront && (left.blendRank ?? 0) === 0) {
                 const depthDelta = right.depth - left.depth;
                 if (Math.abs(depthDelta) > 1e-6)
                     return depthDelta;

package/dist/performance/RenderItemSorting.js.map

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

package/dist/post/CubeLut.d.ts

@@ -0,0 +1,15 @@
+/**
+ * PRD-03 Phase 2 — `.cube` LUT parser (display domain, sRGB-encoded).
+ *
+ * Parses the Adobe/Resolve `.cube` text format into `LutTexture3D`
+ * (size³×4 Float32Array) for the S10b display-grade bake. Supported:
+ * `TITLE`, `LUT_3D_SIZE`, `DOMAIN_MIN`, `DOMAIN_MAX`, `#` comments and blank
+ * lines. 1-D LUTs (`LUT_1D_SIZE`) are rejected — the display grade is a
+ * 3-D transform; a 1-D cube would silently per-channel-map. Sizes above 65
+ * are rejected (unrealistic for a display LUT and almost certainly a corrupt
+ * file). Data rows are in red-fastest order (`index = r + g·size + b·size²`)
+ * and are remapped through `DOMAIN_MIN/MAX` — the default domain is [0,1].
+ */
+import type { LutTexture3D } from "./PostGraph.js";
+export declare function parseCubeLut(text: string): LutTexture3D;
+//# sourceMappingURL=CubeLut.d.ts.map

package/dist/post/CubeLut.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeLut.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/post/CubeLut.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAWhD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAiEvD"}

package/dist/post/CubeLut.js

@@ -0,0 +1,86 @@
+/**
+ * PRD-03 Phase 2 — `.cube` LUT parser (display domain, sRGB-encoded).
+ *
+ * Parses the Adobe/Resolve `.cube` text format into `LutTexture3D`
+ * (size³×4 Float32Array) for the S10b display-grade bake. Supported:
+ * `TITLE`, `LUT_3D_SIZE`, `DOMAIN_MIN`, `DOMAIN_MAX`, `#` comments and blank
+ * lines. 1-D LUTs (`LUT_1D_SIZE`) are rejected — the display grade is a
+ * 3-D transform; a 1-D cube would silently per-channel-map. Sizes above 65
+ * are rejected (unrealistic for a display LUT and almost certainly a corrupt
+ * file). Data rows are in red-fastest order (`index = r + g·size + b·size²`)
+ * and are remapped through `DOMAIN_MIN/MAX` — the default domain is [0,1].
+ */
+const MAX_LUT_SIZE = 65;
+function parseVec3(line) {
+    const parts = line.trim().split(/\s+/);
+    if (parts.length < 3)
+        return null;
+    const v = [Number(parts[0]), Number(parts[1]), Number(parts[2])];
+    return v.every((n) => Number.isFinite(n)) ? v : null;
+}
+export function parseCubeLut(text) {
+    let size = null;
+    let domainMin = [0, 0, 0];
+    let domainMax = [1, 1, 1];
+    const rows = [];
+    for (const rawLine of text.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        if (line.length === 0 || line.startsWith("#"))
+            continue;
+        const keyword = line.split(/\s+/)[0];
+        const rest = line.slice(keyword.length).trim();
+        if (keyword === "LUT_1D_SIZE") {
+            throw new Error(`CUBE_LUT_1D_UNSUPPORTED: 1-D LUTs cannot bake into the display-grade TEXTURE_3D (size ${rest}).`);
+        }
+        if (keyword === "LUT_3D_SIZE") {
+            const parsed = Number(rest);
+            if (!Number.isInteger(parsed) || parsed <= 0) {
+                throw new Error(`CUBE_LUT_SIZE_INVALID: ${rest}`);
+            }
+            if (parsed > MAX_LUT_SIZE) {
+                throw new Error(`CUBE_LUT_SIZE_INVALID: 3-D size ${parsed} exceeds ${MAX_LUT_SIZE}.`);
+            }
+            size = parsed;
+            continue;
+        }
+        if (keyword === "DOMAIN_MIN") {
+            const v = parseVec3(rest);
+            if (v)
+                domainMin = v;
+            continue;
+        }
+        if (keyword === "DOMAIN_MAX") {
+            const v = parseVec3(rest);
+            if (v)
+                domainMax = v;
+            continue;
+        }
+        if (keyword === "TITLE" || keyword === "LUT_1D_INPUT_RANGE" || keyword === "LUT_3D_INPUT_RANGE") {
+            continue;
+        }
+        // Anything else must be a data row — or the file is malformed.
+        const v = parseVec3(line);
+        if (!v) {
+            throw new Error(`CUBE_LUT_MALFORMED: unrecognised line "${line.slice(0, 48)}".`);
+        }
+        rows.push(v);
+    }
+    if (size === null) {
+        throw new Error("CUBE_LUT_MALFORMED: missing LUT_3D_SIZE.");
+    }
+    if (rows.length !== size * size * size) {
+        throw new Error(`CUBE_LUT_MALFORMED: expected ${size * size * size} data rows for size ${size}, found ${rows.length}.`);
+    }
+    const data = new Float32Array(size * size * size * 4);
+    for (let i = 0; i < rows.length; i += 1) {
+        const [r, g, b] = rows[i];
+        const base = i * 4;
+        // .cube rows are authored in the file's input domain; remap to [0,1].
+        data[base] = (r - domainMin[0]) / (domainMax[0] - domainMin[0]);
+        data[base + 1] = (g - domainMin[1]) / (domainMax[1] - domainMin[1]);
+        data[base + 2] = (b - domainMin[2]) / (domainMax[2] - domainMin[2]);
+        data[base + 3] = 1;
+    }
+    return { size, data };
+}
+//# sourceMappingURL=CubeLut.js.map