@aura3d/rendering 3.0.1 → 4.0.2

package/dist/atmosphere/PreethamSky.js

@@ -0,0 +1,150 @@
+// PRD-07 P3-T1 — analytic Preetham sky evaluator.
+// Faithful CPU port of three.js r185 `examples/jsm/objects/Sky.js` (MIT) so the
+// CPU reference tests (P3-T2) and the GPU fragment shader share the same math.
+// Numbers are linear HDR radiance, pre-exposure — same as r185's `texColor`.
+// --- r185 constants -------------------------------------------------------
+const E = 2.71828182845904523536028747135266249775724709369995957;
+const PI = 3.141592653589793238462643383279502884197169;
+const TOTAL_RAYLEIGH = [5.804542996261093e-6, 1.3562911419845635e-5, 3.0265902468824876e-5];
+const MIE_CONST = [1.8399918514433978e14, 2.7798023919660528e14, 4.0790479543861094e14];
+const CUTOFF_ANGLE = 1.6110731556870734;
+const STEEPNESS = 1.5;
+const EE = 1000.0;
+const RAYLEIGH_ZENITH = 8.4e3;
+const MIE_ZENITH = 1.25e3;
+const SUN_ANGULAR_DIAMETER_COS = 0.999956676946448443553574619906976478926848692873900859324;
+const THREE_OVER_SIXTEEN_PI = 0.05968310365946075;
+const ONE_OVER_FOUR_PI = 0.07957747154594767;
+function sunIntensity(zenithAngleCos) {
+    const c = Math.max(-1, Math.min(1, zenithAngleCos));
+    return EE * Math.max(0, 1 - Math.pow(E, -((CUTOFF_ANGLE - Math.acos(c)) / STEEPNESS)));
+}
+function totalMie(turbidity) {
+    const c = 0.2 * turbidity * 10e-18;
+    return [0.434 * c * MIE_CONST[0], 0.434 * c * MIE_CONST[1], 0.434 * c * MIE_CONST[2]];
+}
+function rayleighPhase(cosTheta) {
+    return THREE_OVER_SIXTEEN_PI * (1 + cosTheta * cosTheta);
+}
+function hgPhase(cosTheta, g) {
+    const g2 = g * g;
+    return ONE_OVER_FOUR_PI * ((1 - g2) / Math.pow(1 - 2 * g * cosTheta + g2, 1.5));
+}
+/** Sun direction from elevation/azimuth degrees (x=east-ish, y=up, z=north-ish). */
+export function sunDirection(sun) {
+    const phi = (sun.azimuthDeg * Math.PI) / 180;
+    const theta = (sun.elevationDeg * Math.PI) / 180;
+    const y = Math.sin(theta);
+    const r = Math.cos(theta);
+    return [r * Math.sin(phi), y, r * Math.cos(phi)];
+}
+/** Per-frame constants — identical inputs to the GPU sky program's uniforms. */
+export function preethamFrame(spec) {
+    const sun = sunDirection(spec.sun);
+    const turbidity = spec.turbidity ?? 10;
+    const rayleigh = spec.rayleigh ?? 3;
+    const mieCoefficient = spec.mieCoefficient ?? 0.005;
+    const mieDirectionalG = spec.mieDirectionalG ?? 0.8;
+    const sunE = sunIntensity(sun[1]);
+    // r185: 1 - clamp(1 - exp(sunPosition.y / 450000)). Aura's sun is a unit
+    // direction, so sun.y × 2 plays the 450000-scale role: fade ≈ 1 by day,
+    // → ~0.13 at sun.y = -0.5 (deep night).
+    const sunfade = 1 - Math.max(0, Math.min(1, 1 - Math.exp(sun[1] * 2)));
+    const rayleighCoefficient = rayleigh - (1 * (1 - sunfade));
+    const betaR = [
+        TOTAL_RAYLEIGH[0] * rayleighCoefficient,
+        TOTAL_RAYLEIGH[1] * rayleighCoefficient,
+        TOTAL_RAYLEIGH[2] * rayleighCoefficient
+    ];
+    const mie = totalMie(turbidity);
+    const betaM = [mie[0] * mieCoefficient, mie[1] * mieCoefficient, mie[2] * mieCoefficient];
+    const ground = (spec.groundColor ?? [0.11, 0.115, 0.12]);
+    return {
+        sunDirection: sun,
+        sunE,
+        sunfade,
+        betaR,
+        betaM,
+        mieDirectionalG,
+        exposure: spec.exposure ?? 1,
+        showSunDisc: 1,
+        groundColor: [ground[0] ?? 0.11, ground[1] ?? 0.115, ground[2] ?? 0.12]
+    };
+}
+/** Linear HDR radiance along `dir` — the CPU mirror of the fragment shader. */
+export function preethamEvaluate(frame, dir) {
+    const up = [0, 1, 0];
+    const direction = normalize3(dir);
+    const zenithAngle = Math.acos(Math.max(0, dot3(up, direction)));
+    const inverse = 1 / (Math.cos(zenithAngle) + 0.15 * Math.pow(93.885 - (zenithAngle * 180) / PI, -1.253));
+    const sR = RAYLEIGH_ZENITH * inverse;
+    const sM = MIE_ZENITH * inverse;
+    const fex = [
+        Math.exp(-(frame.betaR[0] * sR + frame.betaM[0] * sM)),
+        Math.exp(-(frame.betaR[1] * sR + frame.betaM[1] * sM)),
+        Math.exp(-(frame.betaR[2] * sR + frame.betaM[2] * sM))
+    ];
+    const cosTheta = dot3(direction, frame.sunDirection);
+    const rP = rayleighPhase(cosTheta * 0.5 + 0.5);
+    const mP = hgPhase(cosTheta, frame.mieDirectionalG);
+    const betaRTheta = scale3(frame.betaR, rP);
+    const betaMTheta = scale3(frame.betaM, mP);
+    const ratio = [
+        (betaRTheta[0] + betaMTheta[0]) / (frame.betaR[0] + frame.betaM[0]),
+        (betaRTheta[1] + betaMTheta[1]) / (frame.betaR[1] + frame.betaM[1]),
+        (betaRTheta[2] + betaMTheta[2]) / (frame.betaR[2] + frame.betaM[2])
+    ];
+    const lin0 = [
+        Math.pow(Math.max(0, frame.sunE * ratio[0] * (1 - fex[0])), 1.5),
+        Math.pow(Math.max(0, frame.sunE * ratio[1] * (1 - fex[1])), 1.5),
+        Math.pow(Math.max(0, frame.sunE * ratio[2] * (1 - fex[2])), 1.5)
+    ];
+    const mixT = Math.max(0, Math.min(1, Math.pow(1 - dot3(up, frame.sunDirection), 5)));
+    const lin1 = [
+        Math.pow(Math.max(0, frame.sunE * ratio[0] * fex[0]), 0.5),
+        Math.pow(Math.max(0, frame.sunE * ratio[1] * fex[1]), 0.5),
+        Math.pow(Math.max(0, frame.sunE * ratio[2] * fex[2]), 0.5)
+    ];
+    const lin = [
+        lin0[0] * mix3(1, lin1[0], mixT),
+        lin0[1] * mix3(1, lin1[1], mixT),
+        lin0[2] * mix3(1, lin1[2], mixT)
+    ];
+    const sundisc = smoothstep(SUN_ANGULAR_DIAMETER_COS, SUN_ANGULAR_DIAMETER_COS + 0.00002, cosTheta) * frame.showSunDisc;
+    const l0 = [0.1 * fex[0], 0.1 * fex[1], 0.1 * fex[2]];
+    const disc = [
+        frame.sunE * 19000 * fex[0] * sundisc,
+        frame.sunE * 19000 * fex[1] * sundisc,
+        frame.sunE * 19000 * fex[2] * sundisc
+    ];
+    const sky = [
+        (lin[0] + l0[0] + disc[0]) * 0.04,
+        (lin[1] + l0[1] + disc[1]) * 0.04,
+        (lin[2] + l0[2] + disc[2]) * 0.04
+    ];
+    const base = [sky[0] + 0, sky[1] + 0.0003, sky[2] + 0.00075];
+    if (direction[1] < 0) {
+        // Ground hemisphere: blend to the spec's ground colour below the horizon.
+        const t = Math.max(0, Math.min(1, -direction[1] * 4));
+        return [mix3(base[0], frame.groundColor[0] * 0.04, t), mix3(base[1], frame.groundColor[1] * 0.04, t), mix3(base[2], frame.groundColor[2] * 0.04, t)];
+    }
+    return base;
+}
+export function normalize3(v) {
+    const l = Math.hypot(v[0], v[1], v[2]) || 1;
+    return [v[0] / l, v[1] / l, v[2] / l];
+}
+export function dot3(a, b) {
+    return a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
+}
+function scale3(v, s) {
+    return [v[0] * s, v[1] * s, v[2] * s];
+}
+function mix3(a, b, t) {
+    return a + (b - a) * t;
+}
+export function smoothstep(e0, e1, x) {
+    const t = Math.max(0, Math.min(1, (x - e0) / (e1 - e0)));
+    return t * t * (3 - 2 * t);
+}
+//# sourceMappingURL=PreethamSky.js.map

package/dist/atmosphere/PreethamSky.js.map

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

package/dist/atmosphere/SkyBackgroundPass.d.ts

@@ -0,0 +1,63 @@
+import type { RenderDevice, RenderTarget } from "../RenderDevice.js";
+import type { AuraSkySpecLike } from "../contracts/atmosphere.js";
+import type { FrameContributorContext } from "../contracts/frameGraph.js";
+import { BaseRenderPass, type RenderPassContext } from "../RenderPass.js";
+import { type SkyFrame } from "./SkyEval.js";
+import type { PackedFogUniforms } from "./HeightFog.js";
+/** P4-T7 — packed §8.4 fog state the sky fragment consumes when SKY_FOG=1. */
+export interface SkyFogState {
+    readonly uniforms: PackedFogUniforms;
+    readonly volumes: Float32Array;
+    readonly sunColor: readonly [number, number, number];
+    readonly cameraPosition: readonly [number, number, number];
+    readonly backgroundDistance: number;
+}
+/** C-21 real: holds the sky spec, draws to the color target / cube faces. */
+export declare class SkyBackgroundPass {
+    private readonly device;
+    private frame;
+    private spec;
+    private time;
+    private fog;
+    private readonly programs;
+    constructor(device: RenderDevice);
+    setSpec(spec: AuraSkySpecLike, time: number): void;
+    /** P4-T7 — affectsBackground fog, null clears (plain sky program variant). */
+    setFog(fog: SkyFogState | null): void;
+    get skyFrame(): SkyFrame;
+    /** 8-azimuth horizon radiance (linear HDR), elevation 0. */
+    horizonRadiance(_azimuthSamples: 8): Float32Array;
+    /** Draw the sky into `target` using `viewProjection` (forward VP). */
+    renderToCubeFace(_face: 0 | 1 | 2 | 3 | 4 | 5, target: RenderTarget, viewProjection: Float32Array): void;
+    /**
+     * Fullscreen draw into the current target with the given VP matrix.
+     * `depthTested` (after-opaque sky): the far-plane triangle (z = 0.999999)
+     * depth-tests less-equal against the bound forward depth, so it fills only
+     * pixels no opaque geometry covered.
+     */
+    drawSky(viewProjection: Float32Array, depthTested?: boolean): void;
+    private program;
+    dispose(): void;
+}
+/** Background-phase pass handed to the frame graph each frame. */
+export declare class SkyDrawPass extends BaseRenderPass {
+    private readonly device;
+    private spec;
+    private time;
+    private viewProjection;
+    constructor(device: RenderDevice);
+    setSpec(spec: AuraSkySpecLike, time: number): void;
+    /** P4-T7 — fog applied at backgroundDistance when the spec affects the background. */
+    setFog(fog: SkyFogState | null): void;
+    setViewProjection(vp: Float32Array): void;
+    execute(_context: RenderPassContext): void;
+    /** After-opaque fallback draw (no environment background this frame). */
+    executeDepthTested(): void;
+}
+export declare function skyPassFor(device: RenderDevice): SkyBackgroundPass;
+export declare function skyDrawPassFor(device: RenderDevice): SkyDrawPass;
+/** Pack the SkyFrame into the sky program's uniforms. */
+export declare function skyUniforms(frame: SkyFrame, invViewProj: Float32Array, time: number): Map<string, import("../RenderDevice.js").UniformValue>;
+/** View-projection for the current context's camera (identity when absent). */
+export declare function contextViewProjection(ctx: FrameContributorContext): Float32Array;
+//# sourceMappingURL=SkyBackgroundPass.d.ts.map

package/dist/atmosphere/SkyBackgroundPass.d.ts.map

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

package/dist/atmosphere/SkyBackgroundPass.js

@@ -0,0 +1,233 @@
+// PRD-07 P3-T1/T2 — C-21 SkyBackgroundPassLike + the background-phase draw.
+// The fragment program mirrors the CPU evaluators; horizonRadiance uses the
+// CPU path so cube captures and fog inscatter share the same values.
+import { BaseRenderPass } from "../RenderPass.js";
+import { Geometry } from "../Geometry.js";
+import { VertexBuffer } from "../VertexBuffer.js";
+import { VertexFormat } from "../VertexFormat.js";
+import { invertMat4, identityMat4 } from "@aura3d/scene";
+import { evaluateSky, skyFrame, skyProgramDefines, skyProgramKey } from "./SkyEval.js";
+import { SKY_SHADER_MARKER, skyFragmentSource, skyVertexSource } from "./sky.glsl.js";
+let fullscreen = null;
+function fullscreenTriangle() {
+    if (fullscreen)
+        return fullscreen;
+    const vertices = new VertexBuffer(VertexFormat.P3, 3);
+    vertices.setAttribute(0, "position", [-1, -1, 0]);
+    vertices.setAttribute(1, "position", [3, -1, 0]);
+    vertices.setAttribute(2, "position", [-1, 3, 0]);
+    fullscreen = new Geometry(vertices, null, "triangles", { min: [-1, -1, 0], max: [3, 3, 0] });
+    return fullscreen;
+}
+/** C-21 real: holds the sky spec, draws to the color target / cube faces. */
+export class SkyBackgroundPass {
+    device;
+    frame = skyFrame(null);
+    spec = null;
+    time = 0;
+    fog = null;
+    programs = new Map();
+    constructor(device) {
+        this.device = device;
+    }
+    setSpec(spec, time) {
+        this.spec = spec;
+        this.time = time;
+        this.frame = skyFrame(spec);
+    }
+    /** P4-T7 — affectsBackground fog, null clears (plain sky program variant). */
+    setFog(fog) {
+        this.fog = fog;
+    }
+    get skyFrame() {
+        return this.frame;
+    }
+    /** 8-azimuth horizon radiance (linear HDR), elevation 0. */
+    horizonRadiance(_azimuthSamples) {
+        const out = new Float32Array(8 * 3);
+        for (let i = 0; i < 8; i++) {
+            const phi = (i / 8) * Math.PI * 2;
+            const rgb = evaluateSky(this.frame, [Math.sin(phi), 0, Math.cos(phi)]);
+            out[i * 3] = rgb[0];
+            out[i * 3 + 1] = rgb[1];
+            out[i * 3 + 2] = rgb[2];
+        }
+        return out;
+    }
+    /** Draw the sky into `target` using `viewProjection` (forward VP). */
+    renderToCubeFace(_face, target, viewProjection) {
+        // T0-34: restore the caller's target, never clobber to null.
+        const prev = this.device.getRenderTarget?.() ?? null;
+        this.device.setRenderTarget(target);
+        try {
+            this.drawSky(viewProjection);
+        }
+        finally {
+            this.device.setRenderTarget(prev);
+        }
+    }
+    /**
+     * Fullscreen draw into the current target with the given VP matrix.
+     * `depthTested` (after-opaque sky): the far-plane triangle (z = 0.999999)
+     * depth-tests less-equal against the bound forward depth, so it fills only
+     * pixels no opaque geometry covered.
+     */
+    drawSky(viewProjection, depthTested = false) {
+        const defines = skyProgramDefines(this.frame, { fog: this.fog !== null });
+        const program = this.program(defines);
+        const geometry = fullscreenTriangle();
+        const invVp = invert(viewProjection);
+        const uniforms = skyUniforms(this.frame, invVp, this.time);
+        if (this.fog) {
+            const f = this.fog.uniforms;
+            uniforms.set("u_fogA", f.fogA);
+            uniforms.set("u_fogB", f.fogB);
+            uniforms.set("u_fogColor", f.fogColor);
+            uniforms.set("u_fogAbsorption", f.fogAbsorption);
+            uniforms.set("u_fogMode", f.fogMode);
+            uniforms.set("u_fogNear", f.fogNear);
+            uniforms.set("u_fogFar", f.fogFar);
+            uniforms.set("u_fogVolumes", this.fog.volumes);
+            uniforms.set("u_cameraPosition", this.fog.cameraPosition);
+            uniforms.set("u_sunColor", this.fog.sunColor);
+            uniforms.set("u_fogBackgroundDistance", this.fog.backgroundDistance);
+        }
+        this.device.draw({
+            label: "prd07.sky",
+            topology: "triangles",
+            vertexBuffer: geometry.vertexBuffer.upload(this.device),
+            vertexFormat: geometry.vertexBuffer.format,
+            vertexCount: 3,
+            shader: program,
+            uniforms,
+            renderState: depthTested
+                ? { depthTest: true, depthWrite: false, cullMode: "none", blend: false, depthCompare: "less-equal" }
+                : { depthTest: false, depthWrite: false, cullMode: "none", blend: false, depthCompare: "always" }
+        });
+    }
+    program(defines) {
+        const key = skyProgramKey(defines);
+        let p = this.programs.get(key);
+        if (!p) {
+            p = this.device.createShaderProgram({
+                label: key,
+                vertex: skyVertexSource(),
+                fragment: skyFragmentSource(defines),
+                marker: SKY_SHADER_MARKER
+            });
+            this.programs.set(key, p);
+        }
+        return p;
+    }
+    dispose() {
+        for (const p of this.programs.values())
+            p.dispose?.();
+        this.programs.clear();
+    }
+}
+/** Background-phase pass handed to the frame graph each frame. */
+export class SkyDrawPass extends BaseRenderPass {
+    device;
+    spec = null;
+    time = 0;
+    viewProjection = IDENTITY;
+    constructor(device) {
+        // T0-34 / #1111: the background phase runs only after
+        // EnvironmentBackgroundPass, which writes "environment-background-color"
+        // (ENVIRONMENT_BACKGROUND_COLOR_RESOURCE, literal to keep that module out
+        // of the vfx chunk). Writing `aura.scene.color` collided with the final
+        // transparent pass on the v2 output path ("written by both" throw).
+        super("prd07.sky.background", ["environment-background-color"], ["prd07.sky.background.color"]);
+        this.device = device;
+    }
+    setSpec(spec, time) {
+        this.spec = spec;
+        this.time = time;
+        skyPassFor(this.device).setSpec(spec, time);
+    }
+    /** P4-T7 — fog applied at backgroundDistance when the spec affects the background. */
+    setFog(fog) {
+        skyPassFor(this.device).setFog(fog);
+    }
+    setViewProjection(vp) {
+        this.viewProjection = vp;
+    }
+    execute(_context) {
+        if (!this.spec)
+            return;
+        skyPassFor(this.device).drawSky(this.viewProjection);
+    }
+    /** After-opaque fallback draw (no environment background this frame). */
+    executeDepthTested() {
+        if (!this.spec)
+            return;
+        skyPassFor(this.device).drawSky(this.viewProjection, true);
+    }
+}
+const passes = new WeakMap();
+export function skyPassFor(device) {
+    let pass = passes.get(device);
+    if (!pass) {
+        pass = new SkyBackgroundPass(device);
+        passes.set(device, pass);
+    }
+    return pass;
+}
+const drawPasses = new WeakMap();
+export function skyDrawPassFor(device) {
+    let pass = drawPasses.get(device);
+    if (!pass) {
+        pass = new SkyDrawPass(device);
+        drawPasses.set(device, pass);
+    }
+    return pass;
+}
+const IDENTITY = new Float32Array([1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1]);
+function invert(m) {
+    if (!m || m.length < 16)
+        return IDENTITY;
+    return new Float32Array(invertMat4(m));
+}
+/** Pack the SkyFrame into the sky program's uniforms. */
+export function skyUniforms(frame, invViewProj, time) {
+    const pre = frame.preetham;
+    const grad = frame.gradient;
+    const uniforms = new Map();
+    uniforms.set("u_invViewProj", invViewProj);
+    uniforms.set("u_sunDirection", pre?.sunDirection ?? grad?.sunDirection ?? [0, 1, 0]);
+    uniforms.set("u_sunE", pre?.sunE ?? 0);
+    uniforms.set("u_sunfade", pre?.sunfade ?? 1);
+    uniforms.set("u_betaR", pre?.betaR ?? [0, 0, 0]);
+    uniforms.set("u_betaM", pre?.betaM ?? [0, 0, 0]);
+    uniforms.set("u_mieDirectionalG", pre?.mieDirectionalG ?? 0.8);
+    uniforms.set("u_zenith", grad?.zenith ?? frame.color);
+    uniforms.set("u_horizon", grad?.horizon ?? frame.color);
+    uniforms.set("u_ground", grad?.ground ?? [0.12, 0.12, 0.13]);
+    uniforms.set("u_exponent", grad?.exponent ?? 1.6);
+    uniforms.set("u_horizonGlow", grad?.horizonGlow ?? 0.35);
+    const bands = grad?.bands ?? [];
+    uniforms.set("u_bandCount", bands.length);
+    uniforms.set("u_bandParams", bands.flatMap((b) => [b.elevationDeg, b.widthDeg, b.intensity, 0]));
+    uniforms.set("u_bandColors", bands.flatMap((b) => [b.color[0], b.color[1], b.color[2]]));
+    uniforms.set("u_intensity", frame.intensity);
+    uniforms.set("u_showSunDisc", pre?.showSunDisc ?? 1);
+    uniforms.set("u_time", time);
+    uniforms.set("u_starDensity", frame.stars.density);
+    uniforms.set("u_starIntensity", frame.stars.intensity);
+    uniforms.set("u_cloudCoverage", frame.clouds.coverage);
+    uniforms.set("u_cloudDensity", frame.clouds.density);
+    uniforms.set("u_cloudElevation", frame.clouds.elevation);
+    uniforms.set("u_cloudScaleSpeed", [frame.clouds.scale, frame.clouds.speed]);
+    const moon = frame.moon;
+    uniforms.set("u_moonDirection", moon?.direction ?? [0, -1, 0]);
+    uniforms.set("u_moonColor", moon?.color ?? [0, 0, 0]);
+    uniforms.set("u_moonPhase", moon?.phase ?? 0);
+    uniforms.set("u_moonIntensity", moon?.intensity ?? 0);
+    uniforms.set("u_moonAngularCos", moon ? Math.cos(moon.size) : 1);
+    return uniforms;
+}
+/** View-projection for the current context's camera (identity when absent). */
+export function contextViewProjection(ctx) {
+    return ctx.camera?.viewProjectionMatrix ?? IDENTITY;
+}
+//# sourceMappingURL=SkyBackgroundPass.js.map

package/dist/atmosphere/SkyBackgroundPass.js.map

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

package/dist/atmosphere/SkyCaptureAdapter.d.ts

@@ -0,0 +1,45 @@
+import type { RenderDevice } from "../RenderDevice.js";
+import type { QrFlags } from "../contracts/core.js";
+import { type EnvironmentProbe } from "../contracts/environment.js";
+/** Resolved outcome when capture is not permitted/available yet. */
+export declare const SKY_CAPTURE_PENDING: "SKY_CAPTURE_PENDING";
+export interface SkyCaptureAppLike {
+    /** App diagnostics surface — atmosphere state + listener. */
+    readonly atmosphere: {
+        state(): {
+            readonly sky: unknown | null;
+        };
+        onSkyChanged?(listener: () => void): (() => void) | void;
+    };
+    /** Explicit environment field on the render source (undefined = none). */
+    readonly environment?: unknown | null;
+}
+export interface SkyCaptureResult {
+    readonly status: "captured" | typeof SKY_CAPTURE_PENDING;
+    readonly probe: EnvironmentProbe | null;
+}
+/**
+ * Evaluate + run the capture once. Pure policy — the caller owns when to call
+ * it (mount + re-capture listeners).
+ */
+export declare function captureSkyEnvironment(app: SkyCaptureAppLike, device: RenderDevice, flags: QrFlags, o?: {
+    readonly resolution?: 64 | 128 | 256;
+}): SkyCaptureResult;
+/**
+ * SkyCaptureAdapter: captures once at mount (when allowed) and re-captures
+ * every `onSkyChanged` the LiveAtmosphere emits (sky spec change ⇒ new probe).
+ * `dispose()` detaches the listener.
+ */
+export declare class SkyCaptureAdapter {
+    private readonly app;
+    private readonly device;
+    private readonly flags;
+    private probe;
+    private offSkyChanged;
+    constructor(app: SkyCaptureAppLike, device: RenderDevice, flags: QrFlags);
+    /** Latest probe, or null while capture is pending. */
+    current(): EnvironmentProbe | null;
+    private recapture;
+    dispose(): void;
+}
+//# sourceMappingURL=SkyCaptureAdapter.d.ts.map

package/dist/atmosphere/SkyCaptureAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkyCaptureAdapter.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/atmosphere/SkyCaptureAdapter.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAA+B,KAAK,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAG9F,oEAAoE;AACpE,eAAO,MAAM,mBAAmB,EAAG,qBAA8B,CAAC;AAElE,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,EAAE;QACnB,KAAK,IAAI;YAAE,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAA;SAAE,CAAC;QAC1C,YAAY,CAAC,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;KAC1D,CAAC;IACF,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,mBAAmB,CAAC;IACzD,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACzC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,OAAO,EACd,CAAC,GAAE;IAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,EAAE,GAAG,GAAG,GAAG,GAAG,CAAA;CAAO,GAC/C,gBAAgB,CAelB;AAED;;;;GAIG;AACH,qBAAa,iBAAiB;IAK1B,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IANxB,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,aAAa,CAA6B;gBAG/B,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,OAAO;IAOjC,sDAAsD;IACtD,OAAO,IAAI,gBAAgB,GAAG,IAAI;IAIlC,OAAO,CAAC,SAAS;IAKjB,OAAO,IAAI,IAAI;CAIhB"}

package/dist/atmosphere/SkyCaptureAdapter.js

@@ -0,0 +1,65 @@
+// PRD-07 P3-T6 (§6.4 + C-09 integration) — captures the visible sky into an
+// environment probe when the scene has no explicit environment.
+//
+// Capture runs ONLY when all of these hold:
+//   1. the atmosphere reports a visible sky (`background: "sky-*"`);
+//   2. the scene has no explicit environment (`environment` absent/null);
+//   3. the C-09 factory slot has a real provider (prd02);
+//   4. `A3D_QR_LIGHTING` is on (the slot's own flag).
+// Otherwise the adapter resolves to `SKY_CAPTURE_PENDING` and captures
+// nothing. Re-capture is driven by the atmosphere's `onSkyChanged` listener.
+import { environmentProbeFactorySlot } from "../contracts/environment.js";
+import { skyPassFor } from "./SkyBackgroundPass.js";
+/** Resolved outcome when capture is not permitted/available yet. */
+export const SKY_CAPTURE_PENDING = "SKY_CAPTURE_PENDING";
+/**
+ * Evaluate + run the capture once. Pure policy — the caller owns when to call
+ * it (mount + re-capture listeners).
+ */
+export function captureSkyEnvironment(app, device, flags, o = {}) {
+    const state = app.atmosphere.state();
+    const hasSky = state.sky != null;
+    const hasExplicitEnvironment = app.environment != null;
+    if (!hasSky || hasExplicitEnvironment || !environmentProbeFactorySlot.provided || !flags.on("A3D_QR_LIGHTING")) {
+        return { status: SKY_CAPTURE_PENDING, probe: null };
+    }
+    const factory = environmentProbeFactorySlot.get(flags)(device);
+    const sky = skyPassFor(device);
+    sky.setSpec(state.sky, 0);
+    const probe = factory.fromScene({ renderFace: (face, target, viewProjection) => sky.renderToCubeFace(face, target, viewProjection), resolution: o.resolution ?? 128 }, { faceSize: 128 });
+    return { status: "captured", probe };
+}
+/**
+ * SkyCaptureAdapter: captures once at mount (when allowed) and re-captures
+ * every `onSkyChanged` the LiveAtmosphere emits (sky spec change ⇒ new probe).
+ * `dispose()` detaches the listener.
+ */
+export class SkyCaptureAdapter {
+    app;
+    device;
+    flags;
+    probe = null;
+    offSkyChanged = null;
+    constructor(app, device, flags) {
+        this.app = app;
+        this.device = device;
+        this.flags = flags;
+        this.recapture();
+        const off = this.app.atmosphere.onSkyChanged?.(() => this.recapture());
+        this.offSkyChanged = typeof off === "function" ? off : null;
+    }
+    /** Latest probe, or null while capture is pending. */
+    current() {
+        return this.probe;
+    }
+    recapture() {
+        const result = captureSkyEnvironment(this.app, this.device, this.flags);
+        if (result.probe)
+            this.probe = result.probe;
+    }
+    dispose() {
+        this.offSkyChanged?.();
+        this.offSkyChanged = null;
+    }
+}
+//# sourceMappingURL=SkyCaptureAdapter.js.map

package/dist/atmosphere/SkyCaptureAdapter.js.map

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