@aura3d/engine 3.0.0 → 4.0.0

package/dist/rendering/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/rendering/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/rendering/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 "../../scene/index.js";
+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/rendering/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/rendering/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/rendering/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/rendering/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/rendering/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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"}

package/dist/rendering/atmosphere/SkyEval.d.ts

@@ -0,0 +1,56 @@
+import type { AuraSkySpecLike } from "../contracts/atmosphere.js";
+import { type PreethamFrame, type Vec3 } from "./PreethamSky.js";
+import { type GradientFrame } from "./GradientSky.js";
+import { type StarFrame } from "./StarField.js";
+import { type CloudFrame } from "./CloudLayer.js";
+export type { StarSpec } from "./StarField.js";
+export type { CloudSpec } from "./CloudLayer.js";
+export type SkyModel = "preetham" | "gradient" | "hdri" | "cubemap" | "color" | "none";
+/** §8.5 moon spec (elevation/azimuth degrees + phase 0..1 illumination). */
+export interface MoonSpec {
+    readonly elevationDeg?: number;
+    readonly azimuthDeg?: number;
+    /** Lunar phase 0..1: 0 = new, 0.5 = full, 1 = new. */
+    readonly phase?: number;
+    readonly color?: string | Vec3;
+    readonly intensity?: number;
+    readonly size?: number;
+}
+export interface MoonFrame {
+    readonly direction: Vec3;
+    readonly phase: number;
+    readonly color: Vec3;
+    readonly intensity: number;
+    readonly size: number;
+}
+export interface SkyFrame {
+    readonly model: SkyModel;
+    readonly preetham?: PreethamFrame;
+    readonly gradient?: GradientFrame;
+    readonly color: Vec3;
+    readonly intensity: number;
+    readonly stars: StarFrame;
+    readonly clouds: CloudFrame;
+    readonly moon: MoonFrame | null;
+    readonly showStars: boolean;
+}
+/** Resolve the optional `moon` spec field; null disables the disc. */
+export declare function moonFrame(raw: unknown): MoonFrame | null;
+export declare function skyFrame(spec: AuraSkySpecLike | null | undefined): SkyFrame;
+/** CPU radiance along `dir` for horizonRadiance + tests. */
+export declare function evaluateSky(frame: SkyFrame, dir: Vec3): Vec3;
+/** GPU sky program defines — one program per (model, stars, clouds, moon) combo. */
+export interface SkyProgramDefines {
+    readonly model: "PREETHAM" | "GRADIENT" | "COLOR" | "NONE";
+    readonly stars: boolean;
+    readonly clouds: boolean;
+    readonly sunDisc: boolean;
+    readonly moon: boolean;
+    /** P4-T7 — background fog: apply a3dApplyFog at backgroundDistance. */
+    readonly fog: boolean;
+}
+export declare function skyProgramDefines(frame: SkyFrame, extra?: {
+    readonly fog?: boolean;
+}): SkyProgramDefines;
+export declare function skyProgramKey(d: SkyProgramDefines): string;
+//# sourceMappingURL=SkyEval.d.ts.map

package/dist/rendering/atmosphere/SkyEval.d.ts.map

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

package/dist/rendering/atmosphere/SkyEval.js

@@ -0,0 +1,99 @@
+// PRD-07 — unified sky evaluation: picks the model, evaluates on CPU, packs
+// the uniform block the GPU sky program consumes.
+import { preethamEvaluate, preethamFrame, sunDirection } from "./PreethamSky.js";
+import { gradientEvaluate, gradientFrame } from "./GradientSky.js";
+import { starFrame, starVisibilityAtSunElevation } from "./StarField.js";
+import { cloudFrame } from "./CloudLayer.js";
+function hexToLinear(c) {
+    if (c.startsWith("#") && c.length === 7) {
+        const lin = (v) => Math.pow(v / 255, 2.2);
+        return [lin(parseInt(c.slice(1, 3), 16)), lin(parseInt(c.slice(3, 5), 16)), lin(parseInt(c.slice(5, 7), 16))];
+    }
+    return [1, 1, 1];
+}
+/** Resolve the optional `moon` spec field; null disables the disc. */
+export function moonFrame(raw) {
+    if (!raw || typeof raw !== "object")
+        return null;
+    const o = raw;
+    const elevationDeg = o.elevationDeg ?? 0;
+    const azimuthDeg = o.azimuthDeg ?? 0;
+    const direction = sunDirection({ elevationDeg, azimuthDeg });
+    const phase = Math.max(0, Math.min(1, o.phase ?? 0.5));
+    const color = Array.isArray(o.color)
+        ? [Number(o.color[0] ?? 1), Number(o.color[1] ?? 1), Number(o.color[2] ?? 1)]
+        : hexToLinear(o.color ?? "#dbeafe");
+    return {
+        direction,
+        phase,
+        color,
+        intensity: o.intensity ?? 0.8,
+        size: o.size ?? 0.042 // radians — legacy moon disc angular radius
+    };
+}
+export function skyFrame(spec) {
+    const s = spec ?? {};
+    const model = s.model ?? "none";
+    const stars = starFrame(s.stars);
+    const clouds = cloudFrame(s.clouds);
+    const moon = moonFrame(s.moon);
+    const base = {
+        model,
+        color: [0, 0, 0],
+        intensity: s.intensity ?? 1,
+        stars,
+        clouds,
+        moon,
+        showStars: stars.density > 0
+    };
+    switch (model) {
+        case "preetham": {
+            const preetham = preethamFrame(s);
+            const sunElevationDeg = (Math.asin(Math.max(-1, Math.min(1, preetham.sunDirection[1]))) * 180) / Math.PI;
+            // Stars dim as the sun approaches — fade law from StarField (0 above 6°).
+            const visibility = starVisibilityAtSunElevation(sunElevationDeg);
+            return { ...base, preetham, stars: { ...stars, intensity: stars.intensity * Math.max(0.0001, visibility) }, showStars: true };
+        }
+        case "gradient": {
+            const gradient = gradientFrame(s);
+            const sunElevationDeg = gradient.sunDirection
+                ? (Math.asin(Math.max(-1, Math.min(1, gradient.sunDirection[1]))) * 180) / Math.PI
+                : -90;
+            const visibility = starVisibilityAtSunElevation(sunElevationDeg);
+            return { ...base, gradient, stars: { ...stars, intensity: stars.intensity * Math.max(0.0001, visibility) }, showStars: stars.density > 0 };
+        }
+        case "color":
+            return { ...base, color: (s.color ?? s.value ?? [0, 0, 0]) };
+        default:
+            return base;
+    }
+}
+/** CPU radiance along `dir` for horizonRadiance + tests. */
+export function evaluateSky(frame, dir) {
+    switch (frame.model) {
+        case "preetham":
+            return frame.preetham ? preethamEvaluate(frame.preetham, dir) : [0, 0, 0];
+        case "gradient":
+            return frame.gradient ? gradientEvaluate(frame.gradient, dir) : [0, 0, 0];
+        case "color":
+            return frame.color;
+        default:
+            return [0, 0, 0];
+    }
+}
+export function skyProgramDefines(frame, extra) {
+    return {
+        model: frame.model === "preetham" ? "PREETHAM" :
+            frame.model === "gradient" ? "GRADIENT" :
+                frame.model === "color" ? "COLOR" : "NONE",
+        stars: frame.showStars,
+        clouds: frame.clouds.coverage > 0,
+        sunDisc: true,
+        moon: frame.moon !== null,
+        fog: extra?.fog === true
+    };
+}
+export function skyProgramKey(d) {
+    return `prd07.sky.${d.model}${d.stars ? ".stars" : ""}${d.clouds ? ".clouds" : ""}${d.sunDisc ? ".disc" : ""}${d.moon ? ".moon" : ""}${d.fog ? ".fog" : ""}`;
+}
+//# sourceMappingURL=SkyEval.js.map

package/dist/rendering/atmosphere/SkyEval.js.map

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

package/dist/rendering/atmosphere/StarField.d.ts

@@ -0,0 +1,26 @@
+export type Vec3 = readonly [number, number, number];
+export interface StarSpec {
+    /** Cell occupancy scale — a cell holds a star when hash(cell) < density*0.01. */
+    readonly density?: number;
+    readonly intensity?: number;
+}
+export interface StarFrame {
+    readonly density: number;
+    readonly intensity: number;
+}
+/** Sky dome cells: 512×512 equirect grid (matches the shader's `uv * 512`). */
+export declare const STAR_GRID_CELLS: number;
+/** Occupancy fraction per cell — the shader's `density * 0.01` threshold. */
+export declare function starCellOccupancy(density: number): number;
+/** Expected lit cells on the dome — linear in `density` (test-visible). */
+export declare function expectedStarCount(density: number): number;
+/**
+ * Stars fade to 0 once the sun's elevation exceeds 6 degrees (twilight curve):
+ * 1 at/below the horizon, smoothstep to 0 at +6°.
+ */
+export declare function starVisibilityAtSunElevation(sunElevationDeg: number): number;
+/** Same fade for a sun direction vector (y = sin elevation). */
+export declare function starVisibilityAtSunDirection(sunDirection: Vec3): number;
+/** Resolve the optional `stars` spec field (unknown/absent → disabled). */
+export declare function starFrame(raw: unknown): StarFrame;
+//# sourceMappingURL=StarField.d.ts.map