@aura3d/rendering 3.0.1 → 4.0.2

package/dist/vfx/contributors.js

@@ -0,0 +1,615 @@
+// PRD-07 P1-T1/P1-T8 — frame contributors and the per-device pass registry.
+// The engine reaches contributors through `ctx.source` (the RenderSource the
+// Renderer was handed, populated via attachRootRenderSource): the engine's
+// ProductionEffectSystem publishes a `vfx` feed + atmosphere state there.
+import { registerFrameContributor } from "../contracts/frameGraph.js";
+import { frameStatsSlot } from "../contracts/device.js";
+import { ParticleBatchPass } from "./ParticleBatchPass.js";
+import { BeamPass } from "./BeamPass.js";
+import { MeshParticlePass } from "./MeshParticlePass.js";
+import { RibbonBatch } from "./RibbonBatch.js";
+import { PRD07_FOG_DEFAULTS, packV2, parseFogColor, resolvePrd07FogSpec, skyHorizonRadiance } from "../atmosphere/HeightFog.js";
+import { packFogVolumes } from "../atmosphere/FogVolumes.js";
+import { setPrd07ForwardFog } from "../atmosphere/fogUniformStore.js";
+import { evaluateSky, skyFrame } from "../atmosphere/SkyEval.js";
+import { RibbonPass } from "./RibbonPass.js";
+import { DecalPass } from "./DecalPass.js";
+import { resolveDecalLighting } from "./decalLighting.js";
+import { resolveSceneDepth } from "./SceneDepthAdapter.js";
+import { contextViewProjection, skyDrawPassFor } from "../atmosphere/SkyBackgroundPass.js";
+import { VolumetricFogPass, froxelGridFor } from "../atmosphere/VolumetricFogPass.js";
+import { SkyCaptureAdapter } from "../atmosphere/SkyCaptureAdapter.js";
+import { ParticleGpuSim, particleGpuSimAvailable } from "./ParticleGpuSim.js";
+const particlePasses = new WeakMap();
+const ribbonPasses = new WeakMap();
+const beamPasses = new WeakMap();
+const meshPasses = new WeakMap();
+const decalPasses = new WeakMap();
+export function particlePassFor(device) {
+    let pass = particlePasses.get(device);
+    if (!pass) {
+        pass = new ParticleBatchPass(device);
+        particlePasses.set(device, pass);
+    }
+    return pass;
+}
+export function ribbonPassFor(device) {
+    let pass = ribbonPasses.get(device);
+    if (!pass) {
+        pass = new RibbonPass(device);
+        ribbonPasses.set(device, pass);
+    }
+    return pass;
+}
+export function beamPassFor(device) {
+    let pass = beamPasses.get(device);
+    if (!pass) {
+        pass = new BeamPass(device);
+        beamPasses.set(device, pass);
+    }
+    return pass;
+}
+export function meshPassFor(device) {
+    let pass = meshPasses.get(device);
+    if (!pass) {
+        pass = new MeshParticlePass(device);
+        meshPasses.set(device, pass);
+    }
+    return pass;
+}
+/** C-20: particle update+draw measured under the "particles" FrameStats
+ *  scope (Q-07-2). One monitor per process; a frame is opened lazily by the
+ *  first wrapped call and closed when the next collect begins. */
+let particleStats;
+let particleStatsOpen = false;
+let lastParticleScopeMs = null;
+function particleStatsMonitor() {
+    if (particleStats === undefined) {
+        try {
+            particleStats = frameStatsSlot.get({ values: {}, on: () => false })(240);
+        }
+        catch {
+            particleStats = null;
+        }
+    }
+    return particleStats;
+}
+function particleScope(fn) {
+    const mon = particleStatsMonitor();
+    if (!mon)
+        return fn();
+    if (!particleStatsOpen) {
+        mon.begin(typeof performance !== "undefined" ? performance.now() : Date.now());
+        particleStatsOpen = true;
+    }
+    return mon.scope("particles", fn);
+}
+/** Close the open monitor frame and capture the last "particles" scope ms. */
+function closeParticleScopeFrame() {
+    const mon = particleStatsMonitor();
+    if (mon && particleStatsOpen) {
+        const sample = mon.end();
+        lastParticleScopeMs = sample.scopes["particles"] ?? null;
+    }
+    particleStatsOpen = false;
+}
+/** Last measured "particles" scope ms (feed + draws); null until a frame ran. */
+export function lastParticleUpdateMs() {
+    return lastParticleScopeMs;
+}
+const particlesContributor = {
+    id: "prd07.particles",
+    owner: "prd07",
+    flag: "A3D_QR_VFX",
+    phases: ["collect", "transparent"],
+    collect(items, ctx) {
+        closeParticleScopeFrame();
+        const vfx = ctx.source.vfx;
+        if (vfx)
+            particleScope(() => vfx.feed(particlePassFor(ctx.device)));
+        return items;
+    },
+    transparentItems(ctx) {
+        const vfx = ctx.source.vfx;
+        if (!vfx)
+            return [];
+        const pass = particlePassFor(ctx.device);
+        const items = pass.transparentItems(ctx).map((it) => ({ ...it, draw: (c) => particleScope(() => it.draw(c)) }));
+        vfx.afterDraw?.(pass.diagnostics);
+        return items;
+    }
+};
+/** P2-T7: transient pool lights — collected in the C-01 collect phase. */
+const lightsContributor = {
+    id: "prd07.lights",
+    owner: "prd07",
+    flag: "A3D_QR_VFX",
+    phases: ["collect"],
+    collect(items, ctx) {
+        const vfx = ctx.source.vfx;
+        const lights = vfx?.lightsFeed?.() ?? [];
+        // CollectedLights ride `source.collectedLights` into the forward light
+        // merge (collectRenderLights); the blackboard copy keeps them visible to
+        // sibling contributors in the same phase.
+        ctx.blackboard.set("prd07.lights", lights);
+        return items;
+    }
+};
+/** §6.2.9 trails — RibbonPass submits one draw per orientation group. */
+const ribbonContributor = {
+    id: "prd07.ribbons",
+    owner: "prd07",
+    flag: "A3D_QR_VFX",
+    phases: ["transparent"],
+    transparentItems(ctx) {
+        const vfx = ctx.source.vfx;
+        const batch = vfx?.ribbonFeed?.();
+        if (!batch)
+            return [];
+        return ribbonPassFor(ctx.device).transparentItems(batch, ctx);
+    }
+};
+/** §6.2.10 beams, light cones, aurora curtains — one draw per beam node. */
+const beamContributor = {
+    id: "prd07.beams",
+    owner: "prd07",
+    flag: "A3D_QR_VFX",
+    phases: ["transparent"],
+    transparentItems(ctx) {
+        const vfx = ctx.source.vfx;
+        const specs = vfx?.beamFeed?.() ?? [];
+        if (specs.length === 0)
+            return [];
+        return beamPassFor(ctx.device).transparentItems(specs, ctx);
+    }
+};
+/** §6.2.11 instanced mesh particles — one instanced draw per batch. */
+const meshContributor = {
+    id: "prd07.mesh",
+    owner: "prd07",
+    flag: "A3D_QR_VFX",
+    phases: ["transparent"],
+    transparentItems(ctx) {
+        const vfx = ctx.source.vfx;
+        const feeds = vfx?.meshFeed?.() ?? [];
+        if (feeds.length === 0)
+            return [];
+        return meshPassFor(ctx.device).transparentItems(feeds, ctx);
+    }
+};
+/**
+ * The Renderer runs the `background` phase only when the frame has an
+ * environment background (HDRI or a lane-02 probe). A sky node over a colour
+ * background therefore never drew. The contributor marks the frame's
+ * blackboard when it drew in `background`; otherwise it draws in
+ * `after-opaque`, depth-tested against the forward depth so the sky fills
+ * only uncovered pixels (lane-07 S4/S5).
+ */
+const SKY_DRAWN_KEY = "prd07.sky.drawnInBackground";
+const skyContributor = {
+    id: "prd07.sky",
+    owner: "prd07",
+    flag: "A3D_QR_VFX_SKY",
+    phases: ["background", "after-opaque"],
+    passes: (phase, ctx) => {
+        const atmosphere = ctx.source.atmosphere;
+        if (!atmosphere?.sky)
+            return [];
+        if (phase === "after-opaque" && ctx.blackboard.get(SKY_DRAWN_KEY) === true)
+            return [];
+        if (phase === "background")
+            ctx.blackboard.set(SKY_DRAWN_KEY, true);
+        const pass = skyDrawPassFor(ctx.device);
+        pass.setSpec(atmosphere.sky, ctx.timeSeconds);
+        pass.setViewProjection(contextViewProjection(ctx));
+        // P4-T7 — the prd07.fog contributor's collect ran first this frame; when the
+        // spec affects the background, bind its packed §8.4 uniforms (mode, colour,
+        // volumes) + camera/sun so a3dApplyFog shades the sky at backgroundDistance.
+        const fogEntry = ctx.flags.on("A3D_QR_VFX_FOG")
+            ? ctx.blackboard.get("prd07.fog")
+            : undefined;
+        pass.setFog(fogEntry && fogEntry.affectsBackground
+            ? {
+                uniforms: fogEntry.uniforms,
+                volumes: packFogVolumes(fogEntry.volumes),
+                sunColor: fogEntry.sunColor,
+                cameraPosition: ctx.camera?.position ?? [0, 0, 0],
+                backgroundDistance: fogEntry.backgroundDistance
+            }
+            : null);
+        if (phase === "background")
+            return [pass];
+        return [{
+                name: "prd07.sky.late",
+                reads: [prd07OpaqueColorResource(ctx)],
+                writes: ["prd07.sky.late.color"],
+                execute: () => pass.executeDepthTested()
+            }];
+    }
+};
+/**
+ * P4-T4 — prd07.fog: notes the camera pose on LiveAtmosphere (the compiler's
+ * packLegacy path reads it) and publishes the packed §8.4 uniforms +
+ * fog-volume segments on the blackboard for the prd07.sky pass and any
+ * C-02 generator material that binds `a3d_prd07_fog`.
+ */
+const fogContributor = {
+    id: "prd07.fog",
+    owner: "prd07",
+    flag: "A3D_QR_VFX_FOG",
+    // `collect`, not "background": FrameGraph only calls `collect()` on
+    // contributors listing that phase. Under "background" the fog store was
+    // never written, so forward geometry, the sky and the volumetric pass all
+    // saw "no fog" and A3D_QR_VFX_FOG frames matched flags-off byte for byte.
+    phases: ["collect"],
+    collect: (items, ctx) => {
+        const atmosphere = ctx.source.atmosphere;
+        if (!atmosphere) {
+            setPrd07ForwardFog(null);
+            return items;
+        }
+        const cam = ctx.camera;
+        const forward = cam
+            ? [-cam.viewMatrix[2], -cam.viewMatrix[6], -cam.viewMatrix[10]]
+            : [0, 0, -1];
+        if (cam)
+            atmosphere.noteCamera?.(cam.position, forward);
+        const spec = atmosphere.resolveFog?.(atmosphere.clockNow?.() ?? ctx.timeSeconds) ?? null;
+        const resolved = resolvePrd07FogSpec(spec);
+        const sky = atmosphere.sky ?? null;
+        const azimuth = Math.atan2(forward[0], forward[2]);
+        const fogColor = resolved.color === "sky"
+            ? skyHorizonRadiance(sky, azimuth) ?? PRD07_FOG_DEFAULTS.fallbackColor
+            : parseFogColor(resolved.color, PRD07_FOG_DEFAULTS.fallbackColor);
+        // Legacy generator (C-04 stub) → parity-mode slots; real C-02 → v2 slots.
+        // #187: keyed on the same gate ForwardPass uses for generated programs
+        // (qrCoreGeneratorOn: A3D_QR_CORE_GENERATOR, else A3D_QR_CORE — `true` or "v2"), so an
+        // absorption spec reaches forward geometry as mode 5, not the legacy
+        // luminance-weighted exp collapse.
+        // Inlined (renderer/qrSubFlags pulls OutputPass into the vfx chunk).
+        const generatorOn = ctx.flags.values["A3D_QR_CORE_GENERATOR"] !== undefined
+            ? ctx.flags.on("A3D_QR_CORE_GENERATOR")
+            : ctx.flags.on("A3D_QR_CORE");
+        const parity = !generatorOn;
+        const resolvedPacked = packV2(resolved, {
+            fogColor,
+            cameraY: cam?.position[1] ?? 0,
+            parity
+        });
+        // No live fog node → fog off for the sky pass and the froxel density too,
+        // matching forward geometry (IC-0, setPrd07ForwardFog(null) below). The
+        // C-21 default height fog used to leak into the background pass and the
+        // froxel inject from `resolvePrd07FogSpec(null)`, fogging scenes that
+        // author none (prd07-volumetric-shafts: windows/background at 254).
+        // Fog volumes still inject into the froxel grid.
+        const packed = spec
+            ? resolvedPacked
+            : { ...resolvedPacked, fogA: [0, 0, 0, 0], fogMode: 0 };
+        // §6.6 sun inscatter colour — sky radiance at the sun direction (clamped);
+        // only multiplied by sunInscatter (default 0) so the approximation is inert.
+        let sunColor = [1, 1, 1];
+        let sunDirection = [0, 1, 0];
+        if (sky) {
+            try {
+                const frame = skyFrame(sky);
+                const sunDir = frame.preetham?.sunDirection ?? frame.gradient?.sunDirection ?? [0, 1, 0];
+                sunDirection = sunDir;
+                const e = evaluateSky(frame, sunDir);
+                sunColor = [Math.min(e[0], 8), Math.min(e[1], 8), Math.min(e[2], 8)];
+            }
+            catch {
+                // keep the unit fallback
+            }
+        }
+        const volumes = (atmosphere.fogVolumes?.() ?? []);
+        // #187/#82 — forward geometry on the C-02 path binds these per draw via the
+        // prd07.fog feature's bindUniforms (absorption = mode 5, Beer-Lambert).
+        // No live fog node → mode 0 on forward geometry (IC-0), not default height fog.
+        setPrd07ForwardFog(spec
+            ? { uniforms: packed, volumes, sunDirection, sunColor, cameraPosition: cam ? [cam.position[0], cam.position[1], cam.position[2]] : [0, 0, 0] }
+            : null);
+        ctx.blackboard.set("prd07.fog", {
+            uniforms: packed,
+            volumes,
+            sunColor,
+            affectsBackground: resolved.affectsBackground !== false,
+            backgroundDistance: resolved.backgroundDistance ?? cam?.far ?? 1000
+        });
+        return items;
+    },
+    passes: () => []
+};
+/**
+ * P3-T6 — prd07.environmentProbe: when the source carries a live atmosphere
+ * (state + onSkyChanged) and no explicit environment, a per-device
+ * SkyCaptureAdapter captures the visible sky into a C-09 probe on mount and
+ * re-captures on every sky change. The probe lands on the blackboard for the
+ * lighting contributors; GPU-side renderFace capture only — no main-thread
+ * CPU prefilter (T0-25).
+ */
+const skyCaptureAdapters = new WeakMap();
+const skyCaptureContributor = {
+    id: "prd07.environmentProbe",
+    owner: "prd07",
+    flag: "A3D_QR_VFX",
+    phases: ["collect"],
+    collect: (items, ctx) => {
+        const src = ctx.source;
+        const atmosphere = src.atmosphere;
+        if (!atmosphere || typeof atmosphere.state !== "function" || typeof atmosphere.onSkyChanged !== "function") {
+            return items;
+        }
+        const environment = src.environmentLighting ?? src.environmentBackground ?? null;
+        let entry = skyCaptureAdapters.get(ctx.device);
+        if (!entry || entry.source !== ctx.source) {
+            entry?.adapter.dispose();
+            entry = {
+                source: ctx.source,
+                adapter: new SkyCaptureAdapter({ atmosphere: atmosphere, environment }, ctx.device, ctx.flags)
+            };
+            skyCaptureAdapters.set(ctx.device, entry);
+        }
+        ctx.blackboard.set("prd07.environmentProbe", entry.adapter.current());
+        return items;
+    },
+    passes: () => []
+};
+/**
+ * P5-T1 — prd07.gpuSim: steps each ParticleGpuSim published on the blackboard
+ * under "prd07.gpuSims" (engine producers push {sim, emitCount}) during the
+ * collect phase — before shadows — so draws read frame N-1 state (§6.2.3).
+ * Requires floatColorBuffer; producers gate on `ParticleGpuSim.isAvailable`
+ * and keep the CPU emitter otherwise (PARTICLE_GPU_UNAVAILABLE).
+ */
+/** Per-device ParticleGpuSim instances, keyed by emitter nodeId (P5-T1). */
+const gpuSims = new WeakMap();
+const gpuSimContributor = {
+    id: "prd07.gpuSim",
+    owner: "prd07",
+    flag: "A3D_QR_VFX",
+    phases: ["collect"],
+    collect: (items, ctx) => {
+        const vfx = ctx.source.vfx;
+        const requests = vfx?.gpuSimFeed?.() ?? [];
+        if (requests.length > 0 && particleGpuSimAvailable(ctx.device)) {
+            const map = new Map();
+            const entries = [];
+            for (const r of requests) {
+                const sim = gpuSims.get(ctx.device)?.get(r.nodeId) ?? new ParticleGpuSim(ctx.device, r.spec);
+                map.set(r.nodeId, sim);
+                entries.push({ sim, emitCount: r.emitCount });
+            }
+            gpuSims.set(ctx.device, map);
+            ctx.blackboard.set("prd07.gpuSims", entries);
+        }
+        else {
+            // floatColorBuffer absent (PARTICLE_GPU_UNAVAILABLE) or no gpu emitters:
+            // CPU emitter stays the only sim (§8.3 fallback).
+            ctx.blackboard.set("prd07.gpuSims", []);
+            gpuSims.delete(ctx.device);
+        }
+        const sims = ctx.blackboard.get("prd07.gpuSims");
+        if (!sims)
+            return items;
+        for (const entry of sims)
+            entry.sim.step(1 / 60, entry.emitCount, ctx.timeSeconds);
+        return items;
+    },
+    passes: () => []
+};
+/**
+ * P6-T1 — prd07.decals (§6.9): merged page×blend draws after opaque, before
+ * transparents. Decal nodes (hidden `prd07.legacyDecal.*` primitives under
+ * the flag) are published by the engine on `vfx.decalFeed()`; one draw per
+ * page×blend group replaces E46's one-draw-per-decal.
+ */
+function decalPassFor(device) {
+    let pass = decalPasses.get(device);
+    if (!pass) {
+        pass = new DecalPass(device, {
+            // §8.8 / I3: shade with the scene's own lights so marks match the surface.
+            lighting: resolveDecalLighting,
+            fog: true,
+            fogUniforms: (ctx) => {
+                const entry = ctx.blackboard.get("prd07.fog");
+                if (!entry)
+                    return null;
+                const f = entry.uniforms;
+                return new Map([
+                    ["u_fogA", f.fogA],
+                    ["u_fogB", f.fogB],
+                    ["u_fogColor", f.fogColor],
+                    ["u_fogAbsorption", f.fogAbsorption],
+                    ["u_fogMode", f.fogMode],
+                    ["u_fogNear", f.fogNear],
+                    ["u_fogFar", f.fogFar],
+                    ["u_fogVolumes", packFogVolumes(entry.volumes)],
+                    ["u_cameraPosition", [...(ctx.camera?.position ?? [0, 0, 0])]],
+                    ["u_sunColor", [...entry.sunColor]]
+                ]);
+            },
+            onNote: (code, message) => console.warn(`[${code}] ${message}`)
+        });
+        decalPasses.set(device, pass);
+    }
+    return pass;
+}
+export const decalsContributor = {
+    id: "prd07.decals",
+    owner: "prd07",
+    flag: "A3D_QR_VFX_DECALS",
+    phases: ["after-opaque"],
+    passes: (phase, ctx) => {
+        if (phase !== "after-opaque")
+            return [];
+        const vfx = ctx.source.vfx;
+        const batch = vfx?.decalFeed?.();
+        if (!batch || batch.size === 0)
+            return [];
+        const pass = decalPassFor(ctx.device);
+        const now = ctx.timeSeconds;
+        return [{
+                name: "prd07.decals",
+                // Ordered after the opaque pass; depth-tests against the bound forward
+                // depth attachment (no sampled scene depth).
+                reads: [prd07OpaqueColorResource(ctx)],
+                writes: ["prd07.decals.color"],
+                execute: () => pass.draw(batch, ctx, now)
+            }];
+    }
+};
+/**
+ * T0-34 / #1111 — render-graph resources the after-opaque lane passes may
+ * declare. Only resources a pass in `Renderer.render()` actually writes:
+ * the opaque forward pass writes `aura.scene.color.opaque` on the v2 output
+ * path (A3D_QR_CORE_OUTPUT, else A3D_QR_CORE) and `color` on the legacy
+ * path; `aura.scene.depth.copy` exists only on the v2 path (SceneDepthCopyPass).
+ * Nothing writes `aura.scene.depth`, and `aura.scene.color` is written once,
+ * by the final transparent pass — declaring either made `compilePlan` throw.
+ * Each lane pass writes its own namespaced resource (single-producer rule).
+ * Inlined (renderer/qrSubFlags pulls OutputPass into the vfx chunk).
+ */
+function v2OutputOn(ctx) {
+    return ctx.flags.values["A3D_QR_CORE_OUTPUT"] !== undefined
+        ? ctx.flags.on("A3D_QR_CORE_OUTPUT")
+        : ctx.flags.on("A3D_QR_CORE");
+}
+export function prd07OpaqueColorResource(ctx) {
+    return v2OutputOn(ctx) ? "aura.scene.color.opaque" : "color";
+}
+/** Reads for a pass that samples the scene-depth copy (v2 path only). */
+export function prd07DepthCopyReads(ctx) {
+    return v2OutputOn(ctx) ? [prd07OpaqueColorResource(ctx), "aura.scene.depth.copy"] : [prd07OpaqueColorResource(ctx)];
+}
+/** Per-device froxel pass cache — the grid spec selects the atlas layout. */
+const volumetricPasses = new WeakMap();
+const volumetricCost = new WeakMap();
+/** Feed one measured volumetric-GPU-ms sample for `device`. */
+export function notePrd07VolumetricGpuMs(device, ms) {
+    const s = volumetricCost.get(device) ?? { ewma: 0, frames: 0, fallback: false };
+    s.ewma = s.frames === 0 ? ms : s.ewma * 0.8 + ms * 0.2;
+    s.frames += 1;
+    volumetricCost.set(device, s);
+}
+const WEBDRIVER = globalThis.navigator?.webdriver === true;
+/** C-31 atmosphere scope of the §18 tier envelope: 1.2ms medium / 2.0ms high;
+ *  WebDriver (software GL) pins the tight 0.6ms cap. */
+export function froxelBudgetMs(tier) {
+    if (WEBDRIVER)
+        return 0.6;
+    return tier.volumetricFog === "froxel-high" ? 2.0 : 1.2;
+}
+/** EWMA-with-hysteresis gate — true while the measured cost exceeds `budgetMs`. */
+export function prd07VolumetricCostFallback(device, budgetMs) {
+    const s = volumetricCost.get(device);
+    if (!s || s.frames < 8)
+        return s?.fallback ?? false;
+    s.fallback = s.fallback ? s.ewma > budgetMs * 0.75 : s.ewma > budgetMs;
+    return s.fallback;
+}
+function volumetricPassFor(device, grid) {
+    const key = `${grid.tileWidth}x${grid.tileHeight}x${grid.slices}`;
+    let map = volumetricPasses.get(device);
+    if (!map)
+        volumetricPasses.set(device, (map = new Map()));
+    let pass = map.get(key);
+    if (!pass)
+        map.set(key, (pass = new VolumetricFogPass(device, grid)));
+    return pass;
+}
+/**
+ * P5-T6 — prd07.volumetric: froxel volumetrics (§6.7). Runs only when the
+ * C-27 tier maps to a froxel grid AND `resolveSceneDepth(ctx).available`
+ * (the stub reports false → VOLUMETRIC_DEPTH_PENDING, analytic fog covers
+ * every tier instead). Temporal reprojection (Ultra) needs C-01
+ * previousViewProjectionMatrix — null → VOLUMETRIC_TEMPORAL_PENDING.
+ */
+const volumetricContributor = {
+    id: "prd07.volumetric",
+    owner: "prd07",
+    flag: "A3D_QR_VFX_VOLUMETRIC",
+    phases: ["after-opaque"],
+    passes: (phase, ctx) => {
+        if (phase !== "after-opaque")
+            return [];
+        const depth = resolveSceneDepth(ctx);
+        const grid = froxelGridFor(ctx.tier.volumetricFog);
+        if (!grid || !depth.available || !ctx.camera)
+            return [];
+        if (prd07VolumetricCostFallback(ctx.device, froxelBudgetMs(ctx.tier))) {
+            ctx.blackboard.set("prd07.volumetric.costFallback", "VOLUMETRIC_COST_FALLBACK");
+            return [];
+        }
+        const pass = volumetricPassFor(ctx.device, grid);
+        // Fog spec comes from the prd07.fog blackboard entry (written in collect).
+        const fogEntry = ctx.flags.on("A3D_QR_VFX_FOG")
+            ? ctx.blackboard.get("prd07.fog")
+            : undefined;
+        const sky = ctx.source.atmosphere?.sky ?? null;
+        let sunDirection = [0, 1, 0];
+        let sunColor = (fogEntry?.sunColor ?? [1, 1, 1]);
+        // Without a sky, light the froxels with the scene's own key light and
+        // ambient (the same lights the surfaces get). A fixed +Y unit sun and a
+        // hard-coded [0.2, 0.22, 0.26] ambient washed the dark hangar of
+        // prd07-volumetric-shafts to grey (promote run 38198732843).
+        const sceneLighting = resolveDecalLighting(ctx);
+        const key = sceneLighting?.lights.find((light) => light.kind === "directional");
+        if (sky) {
+            try {
+                const frame = skyFrame(sky);
+                sunDirection = frame.preetham?.sunDirection ?? frame.gradient?.sunDirection ?? sunDirection;
+            }
+            catch { /* keep default */ }
+        }
+        else if (key) {
+            sunDirection = [key.vector[0], key.vector[1], key.vector[2]];
+            sunColor = [key.radiance[0], key.radiance[1], key.radiance[2]];
+        }
+        const input = {
+            fog: fogEntry?.uniforms ?? null,
+            fogColor: [0.663, 0.737, 0.812],
+            volumes: fogEntry?.volumes ?? [],
+            sunDirection,
+            sunColor,
+            // Ambient irradiance E (colour × intensity) → uniform radiance E/π, the
+            // same 1/π convention as the forward ambient (BRDF_Lambert).
+            ambientColor: sceneLighting
+                ? [sceneLighting.ambient[0] / Math.PI, sceneLighting.ambient[1] / Math.PI, sceneLighting.ambient[2] / Math.PI]
+                : [0.2, 0.22, 0.26],
+            sceneDepth: depth.source.texture,
+            depthLinearize: [depth.source.linearize.near, depth.source.linearize.far, depth.source.linearize.orthographic ? 1 : 0, 0]
+        };
+        return [{
+                name: "prd07.volumetric",
+                // Samples the scene-depth copy (resolveSceneDepth), applies into the
+                // forward target after opaque.
+                reads: prd07DepthCopyReads(ctx),
+                writes: ["prd07.volumetric.color"],
+                execute: () => {
+                    const { apply } = pass.update(input, ctx);
+                    // T0-34: apply into the live forward target (prd01.forwardTarget), not
+                    // the canvas — and verify the pass leaves the bound target untouched.
+                    const boundBefore = ctx.device.getRenderTarget?.() ?? null;
+                    const forward = ctx.blackboard.get("prd01.forwardTarget");
+                    apply(forward ?? boundBefore);
+                    if ((ctx.device.getRenderTarget?.() ?? null) !== boundBefore) {
+                        console.warn("prd07.volumetric: bound render target changed inside contributor");
+                        ctx.device.setRenderTarget(boundBefore);
+                    }
+                }
+            }];
+    }
+};
+/** Idempotent lane registration (P1-T1): safe on repeated barrel imports. */
+export function registerPrd07Contributors() {
+    for (const contributor of [particlesContributor, lightsContributor, ribbonContributor, beamContributor, meshContributor, gpuSimContributor, skyCaptureContributor, fogContributor, skyContributor, decalsContributor, volumetricContributor]) {
+        try {
+            registerFrameContributor(contributor);
+        }
+        catch (error) {
+            if (!(error instanceof Error && error.message.includes(contributor.id)))
+                throw error;
+        }
+    }
+}
+//# sourceMappingURL=contributors.js.map

package/dist/vfx/contributors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contributors.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/vfx/contributors.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,6EAA6E;AAC7E,2EAA2E;AAC3E,0EAA0E;AAG1E,OAAO,EACL,wBAAwB,EAIzB,MAAM,yBAAyB,CAAC;AAKjC,OAAO,EAAE,cAAc,EAAuB,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAgC,MAAM,qBAAqB,CAAC;AACtF,OAAO,EAAE,QAAQ,EAAqB,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAyB,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EACL,kBAAkB,EAClB,MAAM,EACN,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAEnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,cAAc,EAAuB,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAoD,MAAM,iCAAiC,CAAC;AAErI,OAAO,EAAE,iBAAiB,EAA0B,MAAM,iCAAiC,CAAC;AAC5F,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAmB,MAAM,kBAAkB,CAAC;AA2C5F,MAAM,cAAc,GAAG,IAAI,OAAO,EAAmC,CAAC;AACtE,MAAM,YAAY,GAAG,IAAI,OAAO,EAA4B,CAAC;AAC7D,MAAM,UAAU,GAAG,IAAI,OAAO,EAA0B,CAAC;AACzD,MAAM,UAAU,GAAG,IAAI,OAAO,EAAkC,CAAC;AACjE,MAAM,WAAW,GAAG,IAAI,OAAO,EAA2B,CAAC;AAE3D,MAAM,UAAU,eAAe,CAAC,MAAoB;IAClD,IAAI,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACrC,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAoB;IAChD,IAAI,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;QAC9B,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAoB;IAC9C,IAAI,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC5B,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAoB;IAC9C,IAAI,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACpC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;kEAEkE;AAClE,IAAI,aAAgD,CAAC;AACrD,IAAI,iBAAiB,GAAG,KAAK,CAAC;AAC9B,IAAI,mBAAmB,GAAkB,IAAI,CAAC;AAE9C,SAAS,oBAAoB;IAC3B,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,aAAa,GAAG,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;QAC3E,CAAC;QAAC,MAAM,CAAC;YACP,aAAa,GAAG,IAAI,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,SAAS,aAAa,CAAI,EAAW;IACnC,MAAM,GAAG,GAAG,oBAAoB,EAAE,CAAC;IACnC,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,EAAE,CAAC;IACtB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,GAAG,CAAC,KAAK,CAAC,OAAO,WAAW,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAC/E,iBAAiB,GAAG,IAAI,CAAC;IAC3B,CAAC;IACD,OAAO,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AACpC,CAAC;AAED,8EAA8E;AAC9E,SAAS,uBAAuB;IAC9B,MAAM,GAAG,GAAG,oBAAoB,EAAE,CAAC;IACnC,IAAI,GAAG,IAAI,iBAAiB,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC;QACzB,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC;IAC3D,CAAC;IACD,iBAAiB,GAAG,KAAK,CAAC;AAC5B,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,oBAAoB;IAClC,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED,MAAM,oBAAoB,GAAqB;IAC7C,EAAE,EAAE,iBAAiB;IACrB,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,OAAO,CAAC,KAAmB,EAAE,GAA4B;QACvD,uBAAuB,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAI,GAAG,CAAC,MAA2B,CAAC,GAAG,CAAC;QACjD,IAAI,GAAG;YAAE,aAAa,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACpE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,gBAAgB,CAAC,GAA4B;QAC3C,MAAM,GAAG,GAAI,GAAG,CAAC,MAA2B,CAAC,GAAG,CAAC;QACjD,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAA0B,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACzI,GAAG,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAClC,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAC;AAEF,0EAA0E;AAC1E,MAAM,iBAAiB,GAAqB;IAC1C,EAAE,EAAE,cAAc;IAClB,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE,CAAC,SAAS,CAAC;IACnB,OAAO,CAAC,KAAmB,EAAE,GAA4B;QACvD,MAAM,GAAG,GAAI,GAAG,CAAC,MAA2B,CAAC,GAAG,CAAC;QACjD,MAAM,MAAM,GAAG,GAAG,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC;QACzC,uEAAuE;QACvE,yEAAyE;QACzE,0CAA0C;QAC1C,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QAC3C,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAC;AAEF,yEAAyE;AACzE,MAAM,iBAAiB,GAAqB;IAC1C,EAAE,EAAE,eAAe;IACnB,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE,CAAC,aAAa,CAAC;IACvB,gBAAgB,CAAC,GAA4B;QAC3C,MAAM,GAAG,GAAI,GAAG,CAAC,MAA2B,CAAC,GAAG,CAAC;QACjD,MAAM,KAAK,GAAG,GAAG,EAAE,UAAU,EAAE,EAAE,CAAC;QAClC,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,CAAC;QACtB,OAAO,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,gBAAgB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAChE,CAAC;CACF,CAAC;AAEF,4EAA4E;AAC5E,MAAM,eAAe,GAAqB;IACxC,EAAE,EAAE,aAAa;IACjB,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE,CAAC,aAAa,CAAC;IACvB,gBAAgB,CAAC,GAA4B;QAC3C,MAAM,GAAG,GAAI,GAAG,CAAC,MAA2B,CAAC,GAAG,CAAC;QACjD,MAAM,KAAK,GAAG,GAAG,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC;QACtC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAClC,OAAO,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,gBAAgB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC9D,CAAC;CACF,CAAC;AAEF,uEAAuE;AACvE,MAAM,eAAe,GAAqB;IACxC,EAAE,EAAE,YAAY;IAChB,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE,CAAC,aAAa,CAAC;IACvB,gBAAgB,CAAC,GAA4B;QAC3C,MAAM,GAAG,GAAI,GAAG,CAAC,MAA2B,CAAC,GAAG,CAAC;QACjD,MAAM,KAAK,GAAG,GAAG,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC;QACtC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAClC,OAAO,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,gBAAgB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC9D,CAAC;CACF,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,aAAa,GAAG,6BAA6B,CAAC;AAEpD,MAAM,cAAc,GAAqB;IACvC,EAAE,EAAE,WAAW;IACf,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,gBAAgB;IACtB,MAAM,EAAE,CAAC,YAAY,EAAE,cAAc,CAAC;IACtC,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACrB,MAAM,UAAU,GAAI,GAAG,CAAC,MAA2B,CAAC,UAAU,CAAC;QAC/D,IAAI,CAAC,UAAU,EAAE,GAAG;YAAE,OAAO,EAAE,CAAC;QAChC,IAAI,KAAK,KAAK,cAAc,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,aAAa,CAAC,KAAK,IAAI;YAAE,OAAO,EAAE,CAAC;QACtF,IAAI,KAAK,KAAK,YAAY;YAAE,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QACpE,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;QAC9C,IAAI,CAAC,iBAAiB,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC;QACnD,6EAA6E;QAC7E,4EAA4E;QAC5E,6EAA6E;QAC7E,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,gBAAgB,CAAC;YAC7C,CAAC,CAAE,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAQjB;YAChB,CAAC,CAAC,SAAS,CAAC;QACd,IAAI,CAAC,MAAM,CACT,QAAQ,IAAI,QAAQ,CAAC,iBAAiB;YACpC,CAAC,CAAC;gBACE,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,OAAO,EAAE,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC;gBACzC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;gBACjD,kBAAkB,EAAE,QAAQ,CAAC,kBAAkB;aAChD;YACH,CAAC,CAAC,IAAI,CACT,CAAC;QACF,IAAI,KAAK,KAAK,YAAY;YAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1C,OAAO,CAAC;gBACN,IAAI,EAAE,gBAAgB;gBACtB,KAAK,EAAE,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAAC;gBACtC,MAAM,EAAE,CAAC,sBAAsB,CAAC;gBAChC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE;aACzC,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,cAAc,GAAqB;IACvC,EAAE,EAAE,WAAW;IACf,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,gBAAgB;IACtB,oEAAoE;IACpE,wEAAwE;IACxE,0EAA0E;IAC1E,0EAA0E;IAC1E,MAAM,EAAE,CAAC,SAAS,CAAC;IACnB,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACtB,MAAM,UAAU,GAAI,GAAG,CAAC,MAA2B,CAAC,UAMvC,CAAC;QACd,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,kBAAkB,CAAC,IAAI,CAAC,CAAC;YACzB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC;QACvB,MAAM,OAAO,GAAsC,GAAG;YACpD,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YAC/D,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACf,IAAI,GAAG;YAAE,UAAU,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACxD,MAAM,IAAI,GAAG,UAAU,CAAC,UAAU,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,IAAI,GAAG,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC;QACzF,MAAM,QAAQ,GAAG,mBAAmB,CAAC,IAAiD,CAAC,CAAC;QACxF,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,IAAI,IAAI,CAAC;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,KAAK,KAAK;YACvC,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,kBAAkB,CAAC,aAAa;YACtE,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC,aAAa,CAAC,CAAC;QACpE,0EAA0E;QAC1E,uEAAuE;QACvE,uFAAuF;QACvF,qEAAqE;QACrE,mCAAmC;QACnC,qEAAqE;QACrE,MAAM,WAAW,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,uBAAuB,CAAC,KAAK,SAAS;YACzE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAAC;YACvC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC;QAChC,MAAM,MAAM,GAAG,CAAC,WAAW,CAAC;QAC5B,MAAM,cAAc,GAAG,MAAM,CAAC,QAAQ,EAAE;YACtC,QAAQ;YACR,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;YAC9B,MAAM;SACP,CAAC,CAAC;QACH,0EAA0E;QAC1E,wEAAwE;QACxE,wEAAwE;QACxE,sEAAsE;QACtE,oEAAoE;QACpE,iDAAiD;QACjD,MAAM,MAAM,GAAsB,IAAI;YACpC,CAAC,CAAC,cAAc;YAChB,CAAC,CAAC,EAAE,GAAG,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;QAC1D,2EAA2E;QAC3E,6EAA6E;QAC7E,IAAI,QAAQ,GAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/B,IAAI,YAAY,GAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACnC,IAAI,GAAG,EAAE,CAAC;YACR,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAqC,CAAC,CAAC;gBAC9D,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,YAAY,IAAI,KAAK,CAAC,QAAQ,EAAE,YAAY,IAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAU,CAAC;gBACnG,YAAY,GAAG,MAAM,CAAC;gBACtB,MAAM,CAAC,GAAG,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;gBACrC,QAAQ,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACvE,CAAC;YAAC,MAAM,CAAC;gBACP,yBAAyB;YAC3B,CAAC;QACH,CAAC;QACD,MAAM,OAAO,GAAG,CAAC,UAAU,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,CAA8B,CAAC;QAC/E,4EAA4E;QAC5E,wEAAwE;QACxE,gFAAgF;QAChF,kBAAkB,CAChB,IAAI;YACF,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;YAC9I,CAAC,CAAC,IAAI,CACT,CAAC;QACF,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,EAAE;YAC9B,QAAQ,EAAE,MAAM;YAChB,OAAO;YACP,QAAQ;YACR,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB,KAAK,KAAK;YACvD,kBAAkB,EAAE,QAAQ,CAAC,kBAAkB,IAAI,GAAG,EAAE,GAAG,IAAI,IAAI;SACpE,CAAC,CAAC;QACH,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE;CACjB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,kBAAkB,GAAG,IAAI,OAAO,EAAiE,CAAC;AAExG,MAAM,qBAAqB,GAAqB;IAC9C,EAAE,EAAE,wBAAwB;IAC5B,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE,CAAC,SAAS,CAAC;IACnB,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACtB,MAAM,GAAG,GAAG,GAAG,CAAC,MAA0B,CAAC;QAC3C,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,CAAC,KAAK,KAAK,UAAU,IAAI,OAAO,UAAU,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;YAC3G,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,WAAW,GAAG,GAAG,CAAC,mBAAmB,IAAI,GAAG,CAAC,qBAAqB,IAAI,IAAI,CAAC;QACjF,IAAI,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,CAAC;YAC1C,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;YACzB,KAAK,GAAG;gBACN,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,OAAO,EAAE,IAAI,iBAAiB,CAC5B,EAAE,UAAU,EAAE,UAA6C,EAAE,WAAW,EAAE,EAC1E,GAAG,CAAC,MAAM,EACV,GAAG,CAAC,KAAK,CACV;aACF,CAAC;YACF,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC5C,CAAC;QACD,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,wBAAwB,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QACtE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE;CACjB,CAAC;AAEF;;;;;;GAMG;AACH,4EAA4E;AAC5E,MAAM,OAAO,GAAG,IAAI,OAAO,EAA6C,CAAC;AAEzE,MAAM,iBAAiB,GAAqB;IAC1C,EAAE,EAAE,cAAc;IAClB,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE,CAAC,SAAS,CAAC;IACnB,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACtB,MAAM,GAAG,GAAI,GAAG,CAAC,MAA2B,CAAC,GAAG,CAAC;QACjD,MAAM,QAAQ,GAAG,GAAG,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC;QAC3C,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,uBAAuB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/D,MAAM,GAAG,GAAG,IAAI,GAAG,EAA0B,CAAC;YAC9C,MAAM,OAAO,GAAiD,EAAE,CAAC;YACjE,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;gBACzB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,IAAI,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC7F,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;gBACvB,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;YAChD,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YAC7B,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,yEAAyE;YACzE,kDAAkD;YAClD,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;YACxC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QACD,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,eAAe,CAAsH,CAAC;QACtK,IAAI,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QACxB,KAAK,MAAM,KAAK,IAAI,IAAI;YAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,SAAS,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;QACnF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE;CACjB,CAAC;AAEF;;;;;GAKG;AACH,SAAS,YAAY,CAAC,MAAoB;IACxC,IAAI,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,GAAG,IAAI,SAAS,CAAC,MAAM,EAAE;YAC3B,2EAA2E;YAC3E,QAAQ,EAAE,oBAAoB;YAC9B,GAAG,EAAE,IAAI;YACT,WAAW,EAAE,CAAC,GAAG,EAAE,EAAE;gBACnB,MAAM,KAAK,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAE/B,CAAC;gBACd,IAAI,CAAC,KAAK;oBAAE,OAAO,IAAI,CAAC;gBACxB,MAAM,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC;gBACzB,OAAO,IAAI,GAAG,CAAiD;oBAC7D,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC;oBAClB,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC;oBAClB,CAAC,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC;oBAC1B,CAAC,iBAAiB,EAAE,CAAC,CAAC,aAAa,CAAC;oBACpC,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC;oBACxB,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC;oBACxB,CAAC,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;oBACtB,CAAC,cAAc,EAAE,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;oBAC/C,CAAC,kBAAkB,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;oBAC9D,CAAC,YAAY,EAAE,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;iBACpC,CAAC,CAAC;YACL,CAAC;YACD,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;SAChE,CAAC,CAAC;QACH,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAqB;IACjD,EAAE,EAAE,cAAc;IAClB,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,mBAAmB;IACzB,MAAM,EAAE,CAAC,cAAc,CAAC;IACxB,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACrB,IAAI,KAAK,KAAK,cAAc;YAAE,OAAO,EAAE,CAAC;QACxC,MAAM,GAAG,GAAI,GAAG,CAAC,MAA2B,CAAC,GAAG,CAAC;QACjD,MAAM,KAAK,GAAG,GAAG,EAAE,SAAS,EAAE,EAAE,CAAC;QACjC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,CAAC;QAC5B,OAAO,CAAC;gBACN,IAAI,EAAE,cAAc;gBACpB,uEAAuE;gBACvE,6CAA6C;gBAC7C,KAAK,EAAE,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAAC;gBACtC,MAAM,EAAE,CAAC,oBAAoB,CAAC;gBAC9B,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC;aAC1C,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF;;;;;;;;;;GAUG;AACH,SAAS,UAAU,CAAC,GAA4B;IAC9C,OAAO,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,oBAAoB,CAAC,KAAK,SAAS;QACzD,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAAC;QACpC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,GAA4B;IACnE,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,OAAO,CAAC;AAC/D,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,mBAAmB,CAAC,GAA4B;IAC9D,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,wBAAwB,CAAC,GAAG,CAAC,EAAE,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAAC,CAAC;AACtH,CAAC;AAED,6EAA6E;AAC7E,MAAM,gBAAgB,GAAG,IAAI,OAAO,EAA0E,CAAC;AAO/G,MAAM,cAAc,GAAG,IAAI,OAAO,EAAqC,CAAC;AAExE,+DAA+D;AAC/D,MAAM,UAAU,wBAAwB,CAAC,MAAoB,EAAE,EAAU;IACvE,MAAM,CAAC,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAChF,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,GAAG,EAAE,GAAG,GAAG,CAAC;IACvD,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;IACd,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,SAAS,GAAI,UAAsD,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;AACxG;wDACwD;AACxD,MAAM,UAAU,cAAc,CAAC,IAAgD;IAC7E,IAAI,SAAS;QAAE,OAAO,GAAG,CAAC;IAC1B,OAAO,IAAI,CAAC,aAAa,KAAK,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;AAC1D,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,2BAA2B,CAAC,MAAoB,EAAE,QAAgB;IAChF,MAAM,CAAC,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,EAAE,QAAQ,IAAI,KAAK,CAAC;IACpD,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,QAAQ,CAAC;IACvE,OAAO,CAAC,CAAC,QAAQ,CAAC;AACpB,CAAC;AAED,SAAS,iBAAiB,CAAC,MAA8C,EAAE,IAAoB;IAC7F,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;IAClE,IAAI,GAAG,GAAG,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,CAAC,GAAG;QAAE,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC;IAC1D,IAAI,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,IAAI,CAAC,IAAI;QAAE,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,GAAG,IAAI,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACtE,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,qBAAqB,GAAqB;IAC9C,EAAE,EAAE,kBAAkB;IACtB,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,uBAAuB;IAC7B,MAAM,EAAE,CAAC,cAAc,CAAC;IACxB,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACrB,IAAI,KAAK,KAAK,cAAc;YAAE,OAAO,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,GAAG,CAAC,MAAM;YAAE,OAAO,EAAE,CAAC;QACxD,IAAI,2BAA2B,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACtE,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,+BAA+B,EAAE,0BAA0B,CAAC,CAAC;YAChF,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,IAAI,GAAG,iBAAiB,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACjD,2EAA2E;QAC3E,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,gBAAgB,CAAC;YAC7C,CAAC,CAAE,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAwG;YACzI,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,GAAG,GAAK,GAAG,CAAC,MAA2B,CAAC,UAAmE,EAAE,GAAG,IAAI,IAAI,CAAC;QAC/H,IAAI,YAAY,GAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACnC,IAAI,QAAQ,GAAS,CAAC,QAAQ,EAAE,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAS,CAAC;QAC/D,sEAAsE;QACtE,wEAAwE;QACxE,iEAAiE;QACjE,6DAA6D;QAC7D,MAAM,aAAa,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC;QAChF,IAAI,GAAG,EAAE,CAAC;YACR,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAqC,CAAC,CAAC;gBAC9D,YAAY,GAAG,KAAK,CAAC,QAAQ,EAAE,YAAY,IAAI,KAAK,CAAC,QAAQ,EAAE,YAAY,IAAI,YAAY,CAAC;YAC9F,CAAC;YAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;QAChC,CAAC;aAAM,IAAI,GAAG,EAAE,CAAC;YACf,YAAY,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7D,QAAQ,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACjE,CAAC;QACD,MAAM,KAAK,GAA2B;YACpC,GAAG,EAAE,QAAQ,EAAE,QAAQ,IAAI,IAAI;YAC/B,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;YAC/B,OAAO,EAAE,QAAQ,EAAE,OAAO,IAAI,EAAE;YAChC,YAAY;YACZ,QAAQ;YACR,wEAAwE;YACxE,6DAA6D;YAC7D,YAAY,EAAE,aAAa;gBACzB,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;gBAC9G,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC;YACrB,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO;YAChC,cAAc,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SAC1H,CAAC;QACF,OAAO,CAAC;gBACN,IAAI,EAAE,kBAAkB;gBACxB,qEAAqE;gBACrE,+BAA+B;gBAC/B,KAAK,EAAE,mBAAmB,CAAC,GAAG,CAAC;gBAC/B,MAAM,EAAE,CAAC,wBAAwB,CAAC;gBAClC,OAAO,EAAE,GAAG,EAAE;oBACZ,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;oBAC1C,uEAAuE;oBACvE,sEAAsE;oBACtE,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,eAAe,EAAE,EAAE,IAAI,IAAI,CAAC;oBAC3D,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,qBAAqB,CAA6B,CAAC;oBACtF,KAAK,CAAC,OAAO,IAAI,WAAW,CAAC,CAAC;oBAC9B,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,eAAe,EAAE,EAAE,IAAI,IAAI,CAAC,KAAK,WAAW,EAAE,CAAC;wBAC7D,OAAO,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;wBACjF,GAAG,CAAC,MAAM,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;oBAC1C,CAAC;gBACH,CAAC;aACF,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,6EAA6E;AAC7E,MAAM,UAAU,yBAAyB;IACvC,KAAK,MAAM,WAAW,IAAI,CAAC,oBAAoB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,cAAc,EAAE,cAAc,EAAE,iBAAiB,EAAE,qBAAqB,CAAC,EAAE,CAAC;QAC7O,IAAI,CAAC;YACH,wBAAwB,CAAC,WAAW,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;gBAAE,MAAM,KAAK,CAAC;QACvF,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/vfx/decalLighting.d.ts

@@ -0,0 +1,8 @@
+import type { CollectedLight } from "../LightCollector.js";
+import type { FrameContributorContext } from "../contracts/frameGraph.js";
+import type { DecalLight, DecalLighting } from "./DecalPass.js";
+/** Collected lights → decal lights (directional + point/spot as point), brightest first. */
+export declare function decalLightsFrom(collected: Iterable<CollectedLight>): DecalLight[];
+/** Per-frame decal lighting from the render source; null when nothing is published. */
+export declare function resolveDecalLighting(ctx: FrameContributorContext): DecalLighting | null;
+//# sourceMappingURL=decalLighting.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decalLighting.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/vfx/decalLighting.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAEvE,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAc7D,4FAA4F;AAC5F,wBAAgB,eAAe,CAAC,SAAS,EAAE,QAAQ,CAAC,cAAc,CAAC,GAAG,UAAU,EAAE,CAkBjF;AAED,uFAAuF;AACvF,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,uBAAuB,GAAG,aAAa,GAAG,IAAI,CAWvF"}