@aura3d/rendering 3.0.1 → 4.0.2

package/dist/shadows/ShadowSystem.js

@@ -0,0 +1,293 @@
+/**
+ * ShadowSystem — PRD-02 Phase 4 flag-path shadow orchestration: stable-fit
+ * CSM for the sun (DirectionalCascadeFitter) + a depth atlas of spot/point
+ * tiles (ShadowAtlas), rendered through DepthPass into one 2D depth target
+ * per cascade (depth-only targets via Q-01-5 when the device supports depth
+ * textures, 02-T1946). Produces the C-11
+ * `ShadowFrameUniforms` for the `prd02.shadowFrameUniforms` blackboard key;
+ * the flag-path forward binding reads the extra `cascadeTextures` /
+ * `localShadowMatrices` fields on the same object.
+ *
+ * Rasterization uses each fit/tile's *unbiased* draw VP (`drawViewProjection`);
+ * the sampling VP (`viewProjection`, biased to [0,1]³) is what the forward
+ * pass multiplies world positions by before comparing.
+ */
+import { DepthPass } from "../DepthPass.js";
+import { shadowCasterVariantId } from "../contracts/shadows.js";
+import { fitDirectionalCascades } from "./DirectionalCascadeFitter.js";
+import { planLocalShadowAtlas } from "./ShadowAtlas.js";
+import { activeDepthFeatures, depthDeformIncompatibility, ensurePrd02DepthFeatures, prd02DepthFeatures, resolvePrd02ShadowCasterVariant, precompilePrd02DepthVariants, registerPrd02DepthShader } from "./Prd02DepthShaderLibrary.js";
+import { createLeanCoreShaderLibrary } from "../ShaderLibraryCore.js";
+const ATLAS_SIZE = 1024;
+const MAX_CASCADE_TEXTURES = 4;
+const MAX_LOCAL_TILES = 6;
+export class Prd02ShadowSystem {
+    device;
+    config;
+    cascadeTargets = [];
+    atlasTarget = null;
+    lastFits = [];
+    lastTiles = [];
+    lastVariants = [];
+    lastDropped = [];
+    shaderLibrary;
+    depthFeatures;
+    precompiled = false;
+    constructor(device, config, shaderLibrary) {
+        this.device = device;
+        this.config = config;
+        ensurePrd02DepthFeatures();
+        this.shaderLibrary = shaderLibrary ?? createLeanCoreShaderLibrary();
+        registerPrd02DepthShader(this.shaderLibrary);
+        this.depthFeatures = prd02DepthFeatures();
+    }
+    update(frame) {
+        const { camera, casters } = frame;
+        const sun = frame.sun ?? null;
+        this.lastFits = sun
+            ? fitDirectionalCascades({
+                camera,
+                lightDirection: sun.direction,
+                casters,
+                mapSize: this.config.mapSize,
+                cascadeCount: this.config.cascades,
+                splitLambda: this.config.splitLambda,
+                maxDistance: this.config.maxDistance
+            })
+            : [];
+        const localRequests = (frame.localLights ?? []).map((light) => ({
+            lightIndex: light.shadowIndex,
+            kind: light.kind,
+            size: light.size ?? 256,
+            position: light.position,
+            direction: light.direction,
+            range: light.range,
+            outerAngleRadians: light.outerAngleRadians
+        }));
+        const plannedTiles = planLocalShadowAtlas(localRequests, ATLAS_SIZE).tiles;
+        this.lastTiles = plannedTiles.slice(0, MAX_LOCAL_TILES);
+        // C-31 droppedFeatures: report any local light whose tiles didn't fit.
+        this.lastDropped = [];
+        if (plannedTiles.length > this.lastTiles.length) {
+            const keptCounts = new Map();
+            for (const tile of this.lastTiles) {
+                keptCounts.set(tile.lightIndex, (keptCounts.get(tile.lightIndex) ?? 0) + 1);
+            }
+            for (const light of localRequests) {
+                const needed = light.kind === "point" ? 6 : 1;
+                if ((keptCounts.get(light.lightIndex) ?? 0) < needed) {
+                    this.lastDropped.push(`shadow.localLight:${light.lightIndex}`);
+                }
+            }
+        }
+        // 02-DEPTH: compose every active C-11 depth feature (all lanes), not only
+        // prd02's own; deform features without a C-18 entry point are reported.
+        this.depthFeatures = activeDepthFeatures(frame.flags);
+        for (const feature of this.depthFeatures) {
+            if (!feature.hooks.includes("vertex:deform"))
+                continue;
+            const reason = depthDeformIncompatibility(feature);
+            if (reason)
+                this.lastDropped.push(`depth.deform:${reason}`);
+        }
+        const variantKeys = new Map();
+        const resolve = (item) => resolvePrd02ShadowCasterVariant(item, frame.flags, frame.tier, this.depthFeatures);
+        for (const caster of casters) {
+            const key = resolve(caster);
+            variantKeys.set(shadowCasterVariantId(key), { key, features: this.depthFeatures });
+        }
+        this.lastVariants = [...variantKeys.keys()].sort();
+        this.renderCascades(casters, resolve);
+        this.renderAtlas(casters, resolve);
+        return this.frameUniforms();
+    }
+    /** One-time async warm-up so steady-state `programCompileCount` delta is 0. */
+    async precompile(frame) {
+        this.depthFeatures = activeDepthFeatures(frame.flags);
+        const variants = new Map();
+        for (const caster of frame.casters) {
+            const key = resolvePrd02ShadowCasterVariant(caster, frame.flags, frame.tier, this.depthFeatures);
+            variants.set(shadowCasterVariantId(key), { key, features: this.depthFeatures });
+        }
+        await precompilePrd02DepthVariants(this.device, this.shaderLibrary, variants);
+        this.precompiled = true;
+    }
+    get isPrecompiled() {
+        return this.precompiled;
+    }
+    /** T0-26: the sun cascade fits of the last `update` (bridge → legacy forward options). */
+    cascadeFits() {
+        return this.lastFits;
+    }
+    /** Diagnostics for the C-31 `shadows` section (observed values only). */
+    diagnostics() {
+        return {
+            cascadeCount: this.lastFits.length,
+            tiles: this.lastTiles.length,
+            localLights: new Set(this.lastTiles.map((tile) => tile.lightIndex)).size,
+            casterVariants: this.lastVariants,
+            droppedFeatures: this.lastDropped
+        };
+    }
+    /**
+     * GPU evidence probe (shadow-pixels investigation): min/max/mean of each
+     * rendered cascade's depth texture via `readDepthPixels`, plus the share of
+     * texels nearer than the cleared far plane. A healthy cascade over casters
+     * has `covered > 0` and `min < 1`; an all-1.0 map means casters never
+     * reached the depth surface. Call between frames (sets the render target).
+     */
+    readCascadeDepthStats() {
+        if (!this.device.readDepthPixels)
+            return [];
+        const prev = this.device.getRenderTarget?.() ?? null;
+        const out = [];
+        try {
+            for (const fit of this.lastFits) {
+                const target = this.cascadeTargets[fit.index];
+                if (!target || target.disposed || !target.depthTexture)
+                    continue;
+                this.device.setRenderTarget(target);
+                const depth = this.device.readDepthPixels(0, 0, target.width, target.height);
+                let min = Infinity;
+                let max = -Infinity;
+                let sum = 0;
+                let covered = 0;
+                for (const d of depth) {
+                    if (d < min)
+                        min = d;
+                    if (d > max)
+                        max = d;
+                    sum += d;
+                    if (d < 0.9999)
+                        covered += 1;
+                }
+                out.push({ index: fit.index, width: target.width, min, max, mean: sum / Math.max(1, depth.length), covered: covered / Math.max(1, depth.length) });
+            }
+        }
+        finally {
+            this.device.setRenderTarget(prev);
+        }
+        return out;
+    }
+    dispose() {
+        for (const target of this.cascadeTargets)
+            target?.dispose();
+        this.cascadeTargets = [];
+        this.atlasTarget?.dispose();
+        this.atlasTarget = null;
+    }
+    /**
+     * 02-T1946: shadow maps only need the sampled depth surface. With
+     * `depth-textures` the targets are depth-only (Q-01-5) — no rgba8 colour
+     * attachment, saving 4·size² bytes per target; otherwise keep the rgba8 +
+     * depth-texture target the device can always build.
+     */
+    depthTargetDescriptor(size, label) {
+        return this.device.info.capabilities?.includes("depth-textures")
+            ? { width: size, height: size, label, depthOnly: true }
+            : { width: size, height: size, label, format: "rgba8", depth: "texture" };
+    }
+    ensureCascadeTarget(index) {
+        const existing = this.cascadeTargets[index];
+        if (existing && !existing.disposed && existing.width === this.config.mapSize)
+            return existing;
+        existing?.dispose();
+        const target = this.device.createRenderTarget(this.depthTargetDescriptor(this.config.mapSize, `prd02-cascade-${index}`));
+        this.cascadeTargets[index] = target;
+        return target;
+    }
+    ensureAtlasTarget() {
+        if (this.atlasTarget && !this.atlasTarget.disposed)
+            return this.atlasTarget;
+        this.atlasTarget = this.device.createRenderTarget(this.depthTargetDescriptor(ATLAS_SIZE, "prd02-local-shadow-atlas"));
+        return this.atlasTarget;
+    }
+    depthPassOptions(casters, resolve, viewProjection, scissor) {
+        return {
+            casters,
+            shaderLibrary: this.shaderLibrary,
+            viewProjectionMatrix: viewProjection,
+            variantResolver: resolve,
+            depthVariantFeatures: this.depthFeatures,
+            ...(scissor ? { scissor } : {})
+        };
+    }
+    renderCascades(casters, resolve) {
+        if (casters.length === 0)
+            return;
+        const prevTarget = this.device.getRenderTarget?.() ?? null;
+        try {
+            for (const fit of this.lastFits) {
+                const target = this.ensureCascadeTarget(fit.index);
+                this.device.setRenderTarget(target);
+                this.device.clearRenderTarget?.([1, 1, 1, 1]);
+                new DepthPass(this.depthPassOptions(casters, resolve, fit.drawViewProjection))
+                    .execute({ device: this.device, width: this.config.mapSize, height: this.config.mapSize });
+            }
+        }
+        finally {
+            this.device.setRenderTarget(prevTarget);
+        }
+    }
+    renderAtlas(casters, resolve) {
+        if (this.lastTiles.length === 0 || casters.length === 0)
+            return;
+        const target = this.ensureAtlasTarget();
+        const prevTarget = this.device.getRenderTarget?.() ?? null;
+        try {
+            this.device.setRenderTarget(target);
+            this.device.clearRenderTarget?.([1, 1, 1, 1]);
+            for (const tile of this.lastTiles) {
+                new DepthPass(this.depthPassOptions(casters, resolve, tile.drawViewProjection, tile.scissor))
+                    .execute({ device: this.device, width: ATLAS_SIZE, height: ATLAS_SIZE });
+            }
+        }
+        finally {
+            this.device.setRenderTarget(prevTarget);
+        }
+    }
+    frameUniforms() {
+        const cascadeMatrices = new Float32Array(MAX_CASCADE_TEXTURES * 16);
+        const cascadeSplits = new Float32Array(4).fill(1);
+        const cascadeTexelWorld = new Float32Array(4);
+        for (const fit of this.lastFits.slice(0, MAX_CASCADE_TEXTURES)) {
+            cascadeMatrices.set(fit.viewProjection, fit.index * 16);
+            cascadeSplits[fit.index] = fit.splitFar;
+            cascadeTexelWorld[fit.index] = fit.texelWorld;
+        }
+        // localShadowData packs 6 slots × vec4: [u0, v0, du, dv] atlas rect (1-texel
+        // guard included) — the fragment shader offsets tile-space UVs by it.
+        const localShadowData = new Float32Array(MAX_LOCAL_TILES * 4);
+        const localShadowMatrices = new Float32Array(MAX_LOCAL_TILES * 16);
+        const localShadowIndexData = new Float32Array(MAX_LOCAL_TILES * 4);
+        const perLightShadowIndex = new Int32Array(this.lastTiles.length * 2);
+        for (const [i, tile] of this.lastTiles.entries()) {
+            const atlas = tile.allocation;
+            localShadowData.set([atlas.x / ATLAS_SIZE, atlas.y / ATLAS_SIZE, atlas.width / ATLAS_SIZE, atlas.height / ATLAS_SIZE], i * 4);
+            localShadowMatrices.set(tile.viewProjection, i * 16);
+            perLightShadowIndex.set([tile.lightIndex, i], i * 2);
+            localShadowIndexData.set([tile.lightIndex, i, 0, 0], i * 4);
+        }
+        const cascadeTextures = [];
+        for (let i = 0; i < MAX_CASCADE_TEXTURES; i += 1) {
+            cascadeTextures.push(this.cascadeTargets[i]?.depthTexture ?? null);
+        }
+        return {
+            cascadeTexture: cascadeTextures[0] ?? null,
+            cascadeTextures,
+            cascadeMatrices,
+            cascadeSplits,
+            cascadeTexelWorld,
+            atlasTexture: this.atlasTarget?.depthTexture ?? null,
+            localShadowData,
+            localShadowMatrices,
+            localShadowIndexData,
+            perLightShadowIndex,
+            mapSize: this.config.mapSize
+        };
+    }
+}
+export function createShadowSystem(device, config) {
+    return new Prd02ShadowSystem(device, config);
+}
+//# sourceMappingURL=ShadowSystem.js.map

package/dist/shadows/ShadowSystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShadowSystem.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/shadows/ShadowSystem.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAKzC,OAAO,EAAE,qBAAqB,EAA4B,MAAM,sBAAsB,CAAC;AAIvF,OAAO,EAAE,sBAAsB,EAAwD,MAAM,4BAA4B,CAAC;AAC1H,OAAO,EAAE,oBAAoB,EAAkB,MAAM,eAAe,CAAC;AACrE,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,wBAAwB,EACxB,kBAAkB,EAClB,+BAA+B,EAC/B,4BAA4B,EAC5B,wBAAwB,EACzB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAkDnE,MAAM,UAAU,GAAG,IAAI,CAAC;AACxB,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAC/B,MAAM,eAAe,GAAG,CAAC,CAAC;AAE1B,MAAM,OAAO,iBAAiB;IAYT;IACT;IAZF,cAAc,GAA4B,EAAE,CAAC;IAC7C,WAAW,GAAwB,IAAI,CAAC;IACxC,QAAQ,GAA4B,EAAE,CAAC;IACvC,SAAS,GAAgB,EAAE,CAAC;IAC5B,YAAY,GAAa,EAAE,CAAC;IAC5B,WAAW,GAAa,EAAE,CAAC;IAClB,aAAa,CAAgB;IACtC,aAAa,CAAiC;IAC9C,WAAW,GAAG,KAAK,CAAC;IAE5B,YACmB,MAAoB,EAC7B,MAA+B,EACvC,aAA6B;QAFZ,WAAM,GAAN,MAAM,CAAc;QAC7B,WAAM,GAAN,MAAM,CAAyB;QAGvC,wBAAwB,EAAE,CAAC;QAC3B,IAAI,CAAC,aAAa,GAAG,aAAa,IAAI,2BAA2B,EAAE,CAAC;QACpE,wBAAwB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC7C,IAAI,CAAC,aAAa,GAAG,kBAAkB,EAAE,CAAC;IAC5C,CAAC;IAED,MAAM,CAAC,KAAwB;QAC7B,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;QAClC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,GAAG;YACjB,CAAC,CAAC,sBAAsB,CAAC;gBACrB,MAAM;gBACN,cAAc,EAAE,GAAG,CAAC,SAAS;gBAC7B,OAAO;gBACP,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;gBAC5B,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;gBAClC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;gBACpC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;aACrC,CAAC;YACJ,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,aAAa,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC9D,UAAU,EAAE,KAAK,CAAC,WAAW;YAC7B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,GAAG;YACvB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;SAC3C,CAAC,CAAC,CAAC;QACJ,MAAM,YAAY,GAAG,oBAAoB,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC,KAAK,CAAC;QAC3E,IAAI,CAAC,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;QACxD,uEAAuE;QACvE,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;QACtB,IAAI,YAAY,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;YAChD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;YAC7C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBAClC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9E,CAAC;YACD,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;gBAClC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC9C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC;oBACrD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,qBAAqB,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;gBACjE,CAAC;YACH,CAAC;QACH,CAAC;QAED,0EAA0E;QAC1E,wEAAwE;QACxE,IAAI,CAAC,aAAa,GAAG,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACtD,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACzC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,eAAe,CAAC;gBAAE,SAAS;YACvD,MAAM,MAAM,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;YACnD,IAAI,MAAM;gBAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,gBAAgB,MAAM,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAqF,CAAC;QACjH,MAAM,OAAO,GAAG,CAAC,IAAgB,EAA0B,EAAE,CAC3D,+BAA+B,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;QACrF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;YAC5B,WAAW,CAAC,GAAG,CAAC,qBAAqB,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;QACrF,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,CAAC,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAEnD,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC,aAAa,EAAE,CAAC;IAC9B,CAAC;IAED,+EAA+E;IAC/E,KAAK,CAAC,UAAU,CAAC,KAAqD;QACpE,IAAI,CAAC,aAAa,GAAG,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACtD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAqF,CAAC;QAC9G,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YACnC,MAAM,GAAG,GAAG,+BAA+B,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;YACjG,QAAQ,CAAC,GAAG,CAAC,qBAAqB,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,MAAM,4BAA4B,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;QAC9E,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,0FAA0F;IAC1F,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,yEAAyE;IACzE,WAAW;QAOT,OAAO;YACL,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM;YAClC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM;YAC5B,WAAW,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI;YACxE,cAAc,EAAE,IAAI,CAAC,YAAY;YACjC,eAAe,EAAE,IAAI,CAAC,WAAW;SAClC,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,qBAAqB;QACnB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe;YAAE,OAAO,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,EAAE,IAAI,IAAI,CAAC;QACrD,MAAM,GAAG,GAAgG,EAAE,CAAC;QAC5G,IAAI,CAAC;YACH,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAChC,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBAC9C,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,YAAY;oBAAE,SAAS;gBACjE,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;gBACpC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC7E,IAAI,GAAG,GAAG,QAAQ,CAAC;gBACnB,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC;gBACpB,IAAI,GAAG,GAAG,CAAC,CAAC;gBACZ,IAAI,OAAO,GAAG,CAAC,CAAC;gBAChB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;oBACtB,IAAI,CAAC,GAAG,GAAG;wBAAE,GAAG,GAAG,CAAC,CAAC;oBACrB,IAAI,CAAC,GAAG,GAAG;wBAAE,GAAG,GAAG,CAAC,CAAC;oBACrB,GAAG,IAAI,CAAC,CAAC;oBACT,IAAI,CAAC,GAAG,MAAM;wBAAE,OAAO,IAAI,CAAC,CAAC;gBAC/B,CAAC;gBACD,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACrJ,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,OAAO;QACL,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,cAAc;YAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAC5D,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED;;;;;OAKG;IACK,qBAAqB,CAAC,IAAY,EAAE,KAAa;QACvD,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,gBAAgB,CAAC;YAC9D,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE;YACvD,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAC9E,CAAC;IAEO,mBAAmB,CAAC,KAAa;QACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC5C,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,KAAK,KAAK,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO,QAAQ,CAAC;QAC9F,QAAQ,EAAE,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,iBAAiB,KAAK,EAAE,CAAC,CAAC,CAAC;QACzH,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC;QACpC,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,iBAAiB;QACvB,IAAI,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC,WAAW,CAAC;QAC5E,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,IAAI,CAAC,qBAAqB,CAAC,UAAU,EAAE,0BAA0B,CAAC,CAAC,CAAC;QACtH,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAEO,gBAAgB,CACtB,OAA8B,EAC9B,OAAqD,EACrD,cAA4B,EAC5B,OAAiE;QAEjE,OAAO;YACL,OAAO;YACP,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,oBAAoB,EAAE,cAAc;YACpC,eAAe,EAAE,OAAO;YACxB,oBAAoB,EAAE,IAAI,CAAC,aAAa;YACxC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChC,CAAC;IACJ,CAAC;IAEO,cAAc,CAAC,OAA8B,EAAE,OAAqD;QAC1G,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACjC,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,EAAE,IAAI,IAAI,CAAC;QAC3D,IAAI,CAAC;YACH,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAChC,MAAM,MAAM,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBACnD,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;gBACpC,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;gBAC9C,IAAI,SAAS,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,kBAAkB,CAAC,CAAC;qBAC3E,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YAC/F,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,OAA8B,EAAE,OAAqD;QACvG,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAChE,MAAM,MAAM,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACxC,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,EAAE,IAAI,IAAI,CAAC;QAC3D,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;YACpC,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAC9C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBAClC,IAAI,SAAS,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;qBAC1F,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;YAC7E,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAEO,aAAa;QACnB,MAAM,eAAe,GAAG,IAAI,YAAY,CAAC,oBAAoB,GAAG,EAAE,CAAC,CAAC;QACpE,MAAM,aAAa,GAAG,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClD,MAAM,iBAAiB,GAAG,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC;QAC9C,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,oBAAoB,CAAC,EAAE,CAAC;YAC/D,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;YACxD,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC;YACxC,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC;QAChD,CAAC;QACD,6EAA6E;QAC7E,sEAAsE;QACtE,MAAM,eAAe,GAAG,IAAI,YAAY,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC;QAC9D,MAAM,mBAAmB,GAAG,IAAI,YAAY,CAAC,eAAe,GAAG,EAAE,CAAC,CAAC;QACnE,MAAM,oBAAoB,GAAG,IAAI,YAAY,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC;QACnE,MAAM,mBAAmB,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACtE,KAAK,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;YACjD,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC;YAC9B,eAAe,CAAC,GAAG,CACjB,CAAC,KAAK,CAAC,CAAC,GAAG,UAAU,EAAE,KAAK,CAAC,CAAC,GAAG,UAAU,EAAE,KAAK,CAAC,KAAK,GAAG,UAAU,EAAE,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC,EACjG,CAAC,GAAG,CAAC,CACN,CAAC;YACF,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;YACrD,mBAAmB,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YACrD,oBAAoB,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,eAAe,GAAuB,EAAE,CAAC;QAC/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,oBAAoB,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACjD,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,YAAY,IAAI,IAAI,CAAC,CAAC;QACrE,CAAC;QACD,OAAO;YACL,cAAc,EAAE,eAAe,CAAC,CAAC,CAAC,IAAI,IAAI;YAC1C,eAAe;YACf,eAAe;YACf,aAAa;YACb,iBAAiB;YACjB,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,YAAY,IAAI,IAAI;YACpD,eAAe;YACf,mBAAmB;YACnB,oBAAoB;YACpB,mBAAmB;YACnB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;SAC7B,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAoB,EAAE,MAA+B;IACtF,OAAO,IAAI,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC/C,CAAC"}

package/dist/textures/TextureBudget.d.ts

@@ -0,0 +1,42 @@
+/**
+ * TextureBudget.ts — R16 texture budgeting seam (PRD-04 §7.3, P1-7; seam host
+ * per CONTRACTS §3.4). Pure descriptor transforms plus a per-device ledger.
+ *
+ * Policy fields: the C-27 seam names (`textureBudgetBytes`, `maxTextureSize`)
+ * are authoritative; the §7.3 names (`maxBytes`, `maxDimension`) are accepted
+ * aliases so call sites written against the PRD work unchanged.
+ *
+ *   applyTextureBudget(desc, policy, device?)
+ *     - `maxDimension`: power-of-2 downscale — uncompressed `data`/`mipLevels`
+ *       get box-filtered mip levels; compressed mip chains (KTX2-uploaded)
+ *       drop leading levels until the base is ≤ maxDimension.
+ *     - `maxBytes`: per-device ledger (WeakMap<RenderDevice, Ledger>; a
+ *       shared "no-device" ledger covers callers without one). When the
+ *       ledger overflows, entries lose top mip levels largest-first until the
+ *       ledger fits; `textureBudgetReport` surfaces {id, from, to}.
+ */
+import type { RenderDevice } from "../RenderDevice.js";
+import { Texture, type TextureDescriptor } from "../Texture.js";
+export interface TextureBudgetPolicy {
+    /** C-27 name — alias of `maxBytes`. */
+    readonly textureBudgetBytes?: number;
+    /** C-27 name — alias of `maxDimension`. */
+    readonly maxTextureSize?: number;
+    /** §7.3 name — cap on total admitted texture bytes per device. */
+    readonly maxBytes?: number;
+    /** §7.3 name — cap on the texture's longest side. */
+    readonly maxDimension?: number;
+}
+export declare const DEFAULT_TEXTURE_BUDGET_POLICY: TextureBudgetPolicy;
+export declare function applyTextureBudget<T extends Texture | TextureDescriptor>(desc: T, policy?: TextureBudgetPolicy, device?: RenderDevice): T;
+export declare function textureBudgetReport(device?: RenderDevice): {
+    readonly textureBytes: number;
+    readonly downscaled: readonly {
+        id: string;
+        from: number;
+        to: number;
+    }[];
+};
+/** Test hook — clears a device's ledger (and the no-device ledger). */
+export declare function resetTextureBudgetLedger(device?: RenderDevice): void;
+//# sourceMappingURL=TextureBudget.d.ts.map

package/dist/textures/TextureBudget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextureBudget.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/textures/TextureBudget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAGL,OAAO,EACP,KAAK,iBAAiB,EAEvB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,mBAAmB;IAClC,uCAAuC;IACvC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,2CAA2C;IAC3C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,qDAAqD;IACrD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,eAAO,MAAM,6BAA6B,EAAE,mBAAwB,CAAC;AA4IrE,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,OAAO,GAAG,iBAAiB,EACtE,IAAI,EAAE,CAAC,EACP,MAAM,GAAE,mBAAmD,EAC3D,MAAM,CAAC,EAAE,YAAY,GACpB,CAAC,CAwCH;AAED,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG;IAC1D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC1E,CAGA;AAED,uEAAuE;AACvE,wBAAgB,wBAAwB,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAKpE"}

package/dist/textures/TextureBudget.js

@@ -0,0 +1,180 @@
+/**
+ * TextureBudget.ts — R16 texture budgeting seam (PRD-04 §7.3, P1-7; seam host
+ * per CONTRACTS §3.4). Pure descriptor transforms plus a per-device ledger.
+ *
+ * Policy fields: the C-27 seam names (`textureBudgetBytes`, `maxTextureSize`)
+ * are authoritative; the §7.3 names (`maxBytes`, `maxDimension`) are accepted
+ * aliases so call sites written against the PRD work unchanged.
+ *
+ *   applyTextureBudget(desc, policy, device?)
+ *     - `maxDimension`: power-of-2 downscale — uncompressed `data`/`mipLevels`
+ *       get box-filtered mip levels; compressed mip chains (KTX2-uploaded)
+ *       drop leading levels until the base is ≤ maxDimension.
+ *     - `maxBytes`: per-device ledger (WeakMap<RenderDevice, Ledger>; a
+ *       shared "no-device" ledger covers callers without one). When the
+ *       ledger overflows, entries lose top mip levels largest-first until the
+ *       ledger fits; `textureBudgetReport` surfaces {id, from, to}.
+ */
+import { compressedTextureByteLength, isCompressedTextureFormat, Texture } from "../Texture.js";
+export const DEFAULT_TEXTURE_BUDGET_POLICY = {};
+const DEVICE_LEDGERS = new WeakMap();
+const NO_DEVICE_LEDGER = { bytes: 0, entries: new Map(), downscaled: [] };
+let nextAnonId = 0;
+function ledgerFor(device) {
+    if (device === undefined || device === null)
+        return NO_DEVICE_LEDGER;
+    let ledger = DEVICE_LEDGERS.get(device);
+    if (!ledger) {
+        ledger = { bytes: 0, entries: new Map(), downscaled: [] };
+        DEVICE_LEDGERS.set(device, ledger);
+    }
+    return ledger;
+}
+function maxDimensionOf(policy) {
+    return policy.maxDimension ?? policy.maxTextureSize;
+}
+function maxBytesOf(policy) {
+    return policy.maxBytes ?? policy.textureBudgetBytes;
+}
+/** Floor at `max`, snapped down to a power of two. */
+function floorPow2(value, max) {
+    let target = Math.min(value, max);
+    let p = 1;
+    while (p * 2 <= target)
+        p *= 2;
+    return p;
+}
+function mipLevelBytes(desc, level) {
+    const format = desc.format ?? "rgba8";
+    if (isCompressedTextureFormat(format))
+        return compressedTextureByteLength(level.width, level.height, format);
+    const bpp = format === "rgba16f" ? 8 : format === "rgba32f" ? 16 : 4;
+    return level.width * level.height * bpp;
+}
+function descriptorByteLevels(desc) {
+    if (desc.mipLevels && desc.mipLevels.length > 0) {
+        return desc.mipLevels.map((level) => level.data.byteLength);
+    }
+    if (desc.cubeFaces && desc.cubeFaces.length > 0) {
+        const first = desc.cubeFaces[0];
+        return first.mipLevels.length > 0
+            ? first.mipLevels.map((level) => level.data.byteLength * desc.cubeFaces.length)
+            : [desc.width * desc.height * 4 * desc.cubeFaces.length];
+    }
+    return [desc.data?.byteLength ?? mipLevelBytes(desc, desc)];
+}
+/** Box-filter downscale of an uncompressed RGBA mip chain to `base` (power of two). */
+function downscaleMips(desc, baseWidth, baseHeight) {
+    const source = desc.mipLevels?.[0] ?? (desc.data ? { width: desc.width, height: desc.height, data: desc.data } : undefined);
+    if (!source || !(source.data instanceof Uint8Array || source.data instanceof Uint8ClampedArray))
+        return undefined;
+    const levels = [];
+    let data = new Uint8Array(source.data);
+    let w = source.width;
+    let h = source.height;
+    while (w > baseWidth || h > baseHeight) {
+        const nw = Math.max(baseWidth, w >> 1);
+        const nh = Math.max(baseHeight, h >> 1);
+        const sx = w / nw;
+        const sy = h / nh;
+        const out = new Uint8Array(nw * nh * 4);
+        for (let y = 0; y < nh; y++) {
+            for (let x = 0; x < nw; x++) {
+                let r = 0, g = 0, b = 0, a = 0, n = 0;
+                for (let dy = 0; dy < sy; dy++) {
+                    for (let dx = 0; dx < sx; dx++) {
+                        const i = ((Math.floor(y * sy + dy) % h) * w + (Math.floor(x * sx + dx) % w)) * 4;
+                        r += data[i];
+                        g += data[i + 1];
+                        b += data[i + 2];
+                        a += data[i + 3];
+                        n++;
+                    }
+                }
+                const o = (y * nw + x) * 4;
+                out[o] = r / n;
+                out[o + 1] = g / n;
+                out[o + 2] = b / n;
+                out[o + 3] = a / n;
+            }
+        }
+        levels.push({ width: nw, height: nh, data: out });
+        data = out;
+        w = nw;
+        h = nh;
+    }
+    return levels;
+}
+/**
+ * Drop leading mip levels on a compressed/explicit chain until the base is
+ * ≤ `maxDimension` — equivalent to starting the KTX2 upload at a later level.
+ */
+function dropLeadingMips(desc, maxDim) {
+    if (!desc.mipLevels || desc.mipLevels.length === 0)
+        return desc;
+    const drop = desc.mipLevels.findIndex((l) => l.width <= maxDim && l.height <= maxDim);
+    if (drop <= 0)
+        return desc;
+    const levels = desc.mipLevels.slice(drop);
+    const base = levels[0];
+    return { ...desc, width: base.width, height: base.height, mipLevels: levels, data: undefined };
+}
+function recordDownscale(ledger, entry) {
+    const from = entry.levels.reduce((a, b) => a + b, 0);
+    entry.levels.shift();
+    const to = entry.levels.reduce((a, b) => a + b, 0);
+    entry.canDrop = entry.levels.length > 1;
+    ledger.downscaled.push({ id: entry.id, from, to });
+    ledger.bytes -= from - to;
+}
+export function applyTextureBudget(desc, policy = DEFAULT_TEXTURE_BUDGET_POLICY, device) {
+    const maxDim = maxDimensionOf(policy);
+    let out;
+    if (maxDim !== undefined && (desc.width > maxDim || desc.height > maxDim)) {
+        const long = Math.max(desc.width, desc.height);
+        const scale = floorPow2(long, maxDim) / long;
+        const baseWidth = Math.max(1, Math.round(desc.width * scale));
+        const baseHeight = Math.max(1, Math.round(desc.height * scale));
+        if (desc.mipLevels && desc.mipLevels.length > 0) {
+            out = dropLeadingMips(desc, maxDim);
+        }
+        else {
+            const levels = downscaleMips(desc, baseWidth, baseHeight);
+            if (levels) {
+                out = { ...desc, width: baseWidth, height: baseHeight, data: undefined, mipLevels: levels };
+            }
+        }
+    }
+    const ledger = ledgerFor(device);
+    const id = desc.label ?? `texture-${nextAnonId++}`;
+    const levels = descriptorByteLevels(out ?? desc);
+    const entry = { id, levels: [...levels], canDrop: levels.length > 1 };
+    ledger.entries.set(id, entry);
+    ledger.bytes += levels.reduce((a, b) => a + b, 0);
+    const maxBytes = maxBytesOf(policy);
+    if (maxBytes !== undefined && ledger.bytes > maxBytes) {
+        // Largest-first: shrink the biggest entries' leading mip until we fit.
+        const shrinkable = () => [...ledger.entries.values()].filter((e) => e.canDrop);
+        while (ledger.bytes > maxBytes && shrinkable().length > 0) {
+            const biggest = shrinkable().reduce((a, b) => (a.levels[0] >= b.levels[0] ? a : b));
+            recordDownscale(ledger, biggest);
+        }
+    }
+    if (out === undefined)
+        return desc;
+    // Texture instances (the upload path) need a real Texture back so the
+    // caller keeps its runtime type; plain descriptors get the modified object.
+    return (desc instanceof Texture ? new Texture(out) : out);
+}
+export function textureBudgetReport(device) {
+    const ledger = ledgerFor(device);
+    return { textureBytes: ledger.bytes, downscaled: ledger.downscaled };
+}
+/** Test hook — clears a device's ledger (and the no-device ledger). */
+export function resetTextureBudgetLedger(device) {
+    const ledger = ledgerFor(device);
+    ledger.bytes = 0;
+    ledger.entries.clear();
+    ledger.downscaled.length = 0;
+}
+//# sourceMappingURL=TextureBudget.js.map

package/dist/textures/TextureBudget.js.map

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

package/dist/vfx/BeamPass.d.ts

@@ -0,0 +1,42 @@
+import type { RenderDevice } from "../RenderDevice.js";
+import type { FrameContributorContext, TransparentQueueItem } from "../contracts/frameGraph.js";
+export type AuraVec3 = readonly [number, number, number];
+export type AuraVec4 = readonly [number, number, number, number];
+/** A lowered beam-family node handed to the pass each frame. */
+export interface BeamDrawSpec {
+    readonly nodeId: string;
+    /** "light-beam" | "lightCone" | "auroraRibbon" */
+    readonly kind: string;
+    readonly color: AuraVec4;
+    readonly intensity: number;
+    readonly position?: AuraVec3;
+    readonly from?: AuraVec3;
+    readonly to?: AuraVec3;
+    readonly widthWorld?: number;
+    readonly segmentCount?: number;
+    readonly direction?: AuraVec3;
+    readonly length?: number;
+    readonly coneAngle?: number;
+    readonly softness?: number;
+    readonly width?: number;
+    readonly height?: number;
+    readonly segments?: number;
+    readonly sway?: number;
+    readonly shimmer?: number;
+    readonly colorTop?: AuraVec4;
+}
+export declare class BeamPass {
+    private readonly device;
+    private readonly programs;
+    private vertexBuffer;
+    private indexBuffer;
+    private vertexCapacity;
+    private indexCapacity;
+    constructor(device: RenderDevice);
+    /** C-01 transparent-phase items: one draw per beam-family node. */
+    transparentItems(specs: readonly BeamDrawSpec[], ctx: FrameContributorContext): TransparentQueueItem[];
+    private drawGeometry;
+    private ensureBuffer;
+    private program;
+}
+//# sourceMappingURL=BeamPass.d.ts.map

package/dist/vfx/BeamPass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BeamPass.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/vfx/BeamPass.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAgB,YAAY,EAAuB,MAAM,iBAAiB,CAAC;AACvF,OAAO,KAAK,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAO7F,MAAM,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AACzD,MAAM,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjE,gEAAgE;AAChE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CAC9B;AA8JD,qBAAa,QAAQ;IAOP,OAAO,CAAC,QAAQ,CAAC,MAAM;IANnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0C;IACnE,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,aAAa,CAAK;gBAEG,MAAM,EAAE,YAAY;IAEjD,mEAAmE;IACnE,gBAAgB,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,EAAE,GAAG,EAAE,uBAAuB,GAAG,oBAAoB,EAAE;IAYtG,OAAO,CAAC,YAAY;IAyCpB,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,OAAO;CAchB"}