@aura3d/engine 3.0.0 → 4.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"StarField.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/atmosphere/StarField.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAErD,MAAM,WAAW,QAAQ;IACvB,iFAAiF;IACjF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,+EAA+E;AAC/E,eAAO,MAAM,eAAe,QAAY,CAAC;AAEzC,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAG5E;AAED,gEAAgE;AAChE,wBAAgB,4BAA4B,CAAC,YAAY,EAAE,IAAI,GAAG,MAAM,CAEvE;AAED,2EAA2E;AAC3E,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,CAGjD"}

package/dist/rendering/atmosphere/StarField.js

@@ -0,0 +1,31 @@
+// PRD-07 P3-T2 — star field: equirect cell hash (one star per cell below a
+// density threshold) on the GPU; the CPU helpers below are the same law for
+// tests and for the frame packer (stars fade out as the sun clears 6°).
+/** Sky dome cells: 512×512 equirect grid (matches the shader's `uv * 512`). */
+export const STAR_GRID_CELLS = 512 * 512;
+/** Occupancy fraction per cell — the shader's `density * 0.01` threshold. */
+export function starCellOccupancy(density) {
+    return Math.max(0, density) * 0.01;
+}
+/** Expected lit cells on the dome — linear in `density` (test-visible). */
+export function expectedStarCount(density) {
+    return Math.round(STAR_GRID_CELLS * starCellOccupancy(density));
+}
+/**
+ * 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 function starVisibilityAtSunElevation(sunElevationDeg) {
+    const t = Math.max(0, Math.min(1, (6 - sunElevationDeg) / 6));
+    return t * t * (3 - 2 * t);
+}
+/** Same fade for a sun direction vector (y = sin elevation). */
+export function starVisibilityAtSunDirection(sunDirection) {
+    return starVisibilityAtSunElevation((Math.asin(Math.max(-1, Math.min(1, sunDirection[1]))) * 180) / Math.PI);
+}
+/** Resolve the optional `stars` spec field (unknown/absent → disabled). */
+export function starFrame(raw) {
+    const o = (raw ?? {});
+    return { density: o.density ?? 0, intensity: o.intensity ?? 1 };
+}
+//# sourceMappingURL=StarField.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StarField.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/atmosphere/StarField.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,4EAA4E;AAC5E,wEAAwE;AAexE,+EAA+E;AAC/E,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,GAAG,GAAG,CAAC;AAEzC,6EAA6E;AAC7E,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;AACrC,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;AAClE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,eAAuB;IAClE,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,4BAA4B,CAAC,YAAkB;IAC7D,OAAO,4BAA4B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;AAC/G,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,SAAS,CAAC,GAAY;IACpC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAa,CAAC;IAClC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,CAAC,EAAE,CAAC;AAClE,CAAC"}

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

@@ -0,0 +1,69 @@
+import type { RenderDevice, RenderTarget } from "../RenderDevice.js";
+import type { FrameContributorContext } from "../contracts/frameGraph.js";
+import type { Texture } from "../Texture.js";
+import { type Prd07FogVolume } from "./FogVolumes.js";
+import type { PackedFogUniforms } from "./HeightFog.js";
+export interface FroxelGridSpec {
+    readonly tileWidth: number;
+    readonly tileHeight: number;
+    readonly slices: number;
+    readonly tilesX: number;
+    readonly tilesY: number;
+    readonly atlasWidth: number;
+    readonly atlasHeight: number;
+    readonly near: number;
+    readonly far: number;
+    readonly temporal: boolean;
+    /** Diagnostics note when the Ultra grid was reduced under the memory check. */
+    readonly note: "VOLUMETRIC_GRID_REDUCED" | null;
+}
+/**
+ * C-27 tier mapping (frozen table): `"analytic"` → null (analytic fog only);
+ * `"froxel-medium"` → 160×90×64, far 64; `"froxel-high"` → 240×135×128, far
+ * 96, temporal. `memoryOk: false` drops Ultra to 240×135×96 + reports
+ * VOLUMETRIC_GRID_REDUCED (R10).
+ */
+export declare function froxelGridFor(mode: "analytic" | "froxel-medium" | "froxel-high" | null, memoryOk?: boolean): FroxelGridSpec | null;
+export interface VolumetricFogPassInput {
+    /** Packed §8.4 fog uniforms (fogA = σd,σh,b,h0 reused as volume density;
+        fogB.w = anisotropy). Null → uniform σ + ambient only. */
+    readonly fog: PackedFogUniforms | null;
+    readonly fogColor: readonly [number, number, number];
+    readonly volumes: readonly Prd07FogVolume[];
+    readonly sunDirection: readonly [number, number, number];
+    readonly sunColor: readonly [number, number, number];
+    readonly ambientColor: readonly [number, number, number];
+    readonly noiseScale?: number;
+    readonly noiseSpeed?: number;
+    readonly noiseStrength?: number;
+    /** Scene depth texture for the apply pass. */
+    readonly sceneDepth: Texture | null;
+    readonly depthLinearize: readonly [number, number, number, number];
+}
+export declare class VolumetricFogPass {
+    private readonly device;
+    readonly grid: FroxelGridSpec;
+    private injectProgram;
+    private integrateProgram;
+    private applyProgram;
+    private injectAtlas;
+    private integrateAtlas;
+    private temporalPrev;
+    constructor(device: RenderDevice, grid: FroxelGridSpec);
+    /** Readback handles for browser specs (froxel-transmittance.spec.ts). */
+    get debugTargets(): {
+        inject: RenderTarget | null;
+        integrate: RenderTarget | null;
+    };
+    private ensureTargets;
+    private program;
+    /** Per-frame froxel update: inject → integrate. Returns the apply draw. */
+    update(input: VolumetricFogPassInput, ctx: FrameContributorContext): {
+        readonly apply: (target: RenderTarget | null) => void;
+        readonly notes: readonly string[];
+    };
+    dispose(): void;
+}
+/** Invert a rigid-body (rotation+translation) view matrix column-major. */
+export declare function invertRigid(m: Float32Array): Float32Array;
+//# sourceMappingURL=VolumetricFogPass.d.ts.map

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

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

package/dist/rendering/atmosphere/VolumetricFogPass.js

@@ -0,0 +1,265 @@
+// PRD-07 P5-T6 — §6.7/§8.7 froxel volumetric fog pass. The volume lives in a
+// 2D tiled rgba16f atlas (C-27 froxelGrid: High 160×90×64 in 8×8 tiles =
+// 1280×720; Ultra 240×135×128 in 16×8 tiles = 3840×1080; reduced Ultra
+// 240×135×96, reported VOLUMETRIC_GRID_REDUCED). WebGL2 has no compute, so:
+//   inject   — one scissored fullscreen draw per slice → (L, σ) atlas
+//   integrate— one whole-atlas draw; each fragment prefix-sums its slice
+//   apply    — fullscreen premultiplied-alpha-over: (S, 1−T) ≡ color·T + S
+// The pass only runs when `resolveSceneDepth(ctx).available`; without it the
+// analytic fog path covers every tier (VOLUMETRIC_DEPTH_PENDING). Temporal
+// reprojection (Ultra) waits on C-01 previousViewProjectionMatrix — null →
+// VOLUMETRIC_TEMPORAL_PENDING and the injected atlas is used directly.
+import { Geometry } from "../Geometry.js";
+import { VertexBuffer } from "../VertexBuffer.js";
+import { VertexFormat } from "../VertexFormat.js";
+import { TextureBinding } from "../TextureBinding.js";
+import { PRD07_DEPTH_SAMPLER } from "../vfx/depthSampler.js";
+import { volumetricInjectFragmentSource, volumetricInjectVertexSource, PRD07_VOLUMETRIC_MARKER } from "./shaders/volumetric-inject.glsl.js";
+import { volumetricIntegrateFragmentSource, volumetricIntegrateVertexSource } from "./shaders/volumetric-integrate.glsl.js";
+import { volumetricApplyFragmentSource, volumetricApplyVertexSource } from "./shaders/volumetric-apply.glsl.js";
+import { packFogVolumes } from "./FogVolumes.js";
+const froxel = (tileWidth, tileHeight, slices, tilesX, far, temporal, note = null) => ({
+    tileWidth, tileHeight, slices, tilesX,
+    tilesY: Math.ceil(slices / tilesX),
+    atlasWidth: tileWidth * tilesX,
+    atlasHeight: tileHeight * Math.ceil(slices / tilesX),
+    near: 0.5, far, temporal, note
+});
+/**
+ * C-27 tier mapping (frozen table): `"analytic"` → null (analytic fog only);
+ * `"froxel-medium"` → 160×90×64, far 64; `"froxel-high"` → 240×135×128, far
+ * 96, temporal. `memoryOk: false` drops Ultra to 240×135×96 + reports
+ * VOLUMETRIC_GRID_REDUCED (R10).
+ */
+export function froxelGridFor(mode, memoryOk = true) {
+    switch (mode) {
+        case "froxel-medium": return froxel(160, 90, 64, 8, 64, false);
+        case "froxel-high":
+            return memoryOk ? froxel(240, 135, 128, 16, 96, true) : froxel(240, 135, 96, 16, 96, true, "VOLUMETRIC_GRID_REDUCED");
+        default: return null;
+    }
+}
+let tri = null;
+function fullscreenTriangle() {
+    if (tri)
+        return tri;
+    const v = new VertexBuffer(VertexFormat.P3, 3);
+    v.setAttribute(0, "position", [-1, -1, 0]);
+    v.setAttribute(1, "position", [3, -1, 0]);
+    v.setAttribute(2, "position", [-1, 3, 0]);
+    tri = new Geometry(v, null, "triangles", { min: [-1, -1, 0], max: [3, 3, 0] });
+    return tri;
+}
+const FULL_SCREEN = { depthTest: false, depthWrite: false, cullMode: "none", blend: false, depthCompare: "always" };
+export class VolumetricFogPass {
+    device;
+    grid;
+    injectProgram = null;
+    integrateProgram = null;
+    applyProgram = null;
+    injectAtlas = null;
+    integrateAtlas = null;
+    temporalPrev = null;
+    constructor(device, grid) {
+        this.device = device;
+        this.grid = grid;
+    }
+    /** Readback handles for browser specs (froxel-transmittance.spec.ts). */
+    get debugTargets() {
+        return { inject: this.injectAtlas, integrate: this.integrateAtlas };
+    }
+    ensureTargets() {
+        const desc = { width: this.grid.atlasWidth, height: this.grid.atlasHeight, format: "rgba16f" };
+        this.injectAtlas ??= this.device.createRenderTarget({ ...desc, label: "prd07.froxel.inject" });
+        this.integrateAtlas ??= this.device.createRenderTarget({ ...desc, label: "prd07.froxel.integrate" });
+        if (this.grid.temporal) {
+            this.temporalPrev ??= this.device.createRenderTarget({ ...desc, label: "prd07.froxel.temporal" });
+        }
+    }
+    program(kind) {
+        const cached = kind === "inject" ? this.injectProgram : kind === "integrate" ? this.integrateProgram : this.applyProgram;
+        if (cached)
+            return cached;
+        const program = this.device.createShaderProgram({
+            label: `prd07.volumetric.${kind}`,
+            vertex: kind === "inject" ? volumetricInjectVertexSource()
+                : kind === "integrate" ? volumetricIntegrateVertexSource()
+                    : volumetricApplyVertexSource(),
+            fragment: kind === "inject" ? volumetricInjectFragmentSource()
+                : kind === "integrate" ? volumetricIntegrateFragmentSource()
+                    : volumetricApplyFragmentSource(),
+            marker: PRD07_VOLUMETRIC_MARKER
+        });
+        if (kind === "inject")
+            this.injectProgram = program;
+        else if (kind === "integrate")
+            this.integrateProgram = program;
+        else
+            this.applyProgram = program;
+        return program;
+    }
+    /** Per-frame froxel update: inject → integrate. Returns the apply draw. */
+    update(input, ctx) {
+        // T0-34: remember the caller's bound target — this pass must leave it
+        // bound on exit, never null (canvas), or later draws hit the framebuffer
+        // and OutputPass overwrites them.
+        const callerRt = this.device.getRenderTarget?.() ?? null;
+        this.ensureTargets();
+        const notes = [];
+        if (this.grid.note)
+            notes.push(this.grid.note);
+        const camera = ctx.camera;
+        const invView = camera ? invertRigid(camera.viewMatrix) : IDENTITY_MAT4;
+        // tan(half-fov) from the renderer's view-projection (rows 0/1 of its 3×3
+        // are P[0]·R and P[5]·R with R orthonormal). FrameCamera.projectionMatrix
+        // is identity whenever the renderer resolved a non-Camera CameraLike,
+        // which reconstructed every froxel along a 90° frustum.
+        const vp = camera?.viewProjectionMatrix;
+        const rowLen = (r) => (vp ? Math.hypot(vp[r] ?? 0, vp[r + 4] ?? 0, vp[r + 8] ?? 0) : 0);
+        const tanY = camera ? 1 / Math.max(rowLen(1) || (camera.projectionMatrix[5] ?? 1), 1e-6) : 1;
+        const tanX = camera ? 1 / Math.max(rowLen(0) || (camera.projectionMatrix[0] ?? 1), 1e-6) : 1;
+        const packed = input.fog;
+        const noiseScale = input.noiseScale ?? 0;
+        const noiseSpeed = input.noiseSpeed ?? 0;
+        const noiseStrength = input.noiseStrength ?? 0;
+        // §8.7 Ultra jitter: (frameIndex mod 8 + 0.5)/8 of a slice.
+        const jitter = this.grid.temporal ? ((ctx.frameIndex % 8) + 0.5) / 8 : 0;
+        if (this.grid.temporal && camera?.previousViewProjectionMatrix == null) {
+            notes.push("VOLUMETRIC_TEMPORAL_PENDING");
+        }
+        const geometry = fullscreenTriangle();
+        const vertexBuffer = geometry.vertexBuffer.upload(this.device);
+        // 1) inject — one scissored draw per slice into its tile. Temporal grids
+        // amortize the inject over 8 frames (a slice budget, not a full pass per
+        // frame): slices rotate through the grid so per-frame cost stays bounded
+        // while the temporal accumulation hides the staggered update.
+        const volumes = packFogVolumes(input.volumes);
+        const inject = this.program("inject");
+        const sliceBudget = this.grid.temporal ? Math.ceil(this.grid.slices / 8) : this.grid.slices;
+        const sliceBase = this.grid.temporal ? ((ctx.frameIndex % 8) * sliceBudget) % this.grid.slices : 0;
+        for (let i = 0; i < sliceBudget; i += 1) {
+            const slice = (sliceBase + i) % this.grid.slices;
+            const tx = slice % this.grid.tilesX;
+            const ty = Math.floor(slice / this.grid.tilesX);
+            const u = new Map();
+            u.set("u_tileSize", [this.grid.tileWidth, this.grid.tileHeight]);
+            u.set("u_projTan", [tanX, tanY]);
+            u.set("u_invView", invView);
+            u.set("u_cameraPosition", [...(camera?.position ?? [0, 0, 0])]);
+            u.set("u_near", this.grid.near);
+            u.set("u_far", this.grid.far);
+            u.set("u_slice", slice);
+            u.set("u_slices", this.grid.slices);
+            u.set("u_jitter", jitter);
+            u.set("u_fogDensity", packed ? packed.fogA : [0, 0, 0, 0]);
+            u.set("u_fogVolumes", volumes);
+            u.set("u_noiseScale", noiseScale);
+            u.set("u_noiseSpeed", noiseSpeed);
+            u.set("u_noiseStrength", noiseStrength);
+            u.set("u_time", ctx.timeSeconds);
+            u.set("u_sunDirection", [...input.sunDirection]);
+            u.set("u_sunColor", [...input.sunColor]);
+            u.set("u_anisotropy", packed ? packed.fogB[3] : 0.6);
+            u.set("u_ambientColor", [...input.ambientColor]);
+            u.set("u_localLights", new Float32Array(32));
+            this.device.setRenderTarget(this.injectAtlas);
+            this.device.draw({
+                label: `prd07.volumetric.inject.${slice}`,
+                topology: "triangles",
+                vertexBuffer,
+                vertexFormat: geometry.vertexBuffer.format,
+                vertexCount: 3,
+                shader: inject,
+                uniforms: u,
+                renderState: {
+                    ...FULL_SCREEN,
+                    scissor: { x: tx * this.grid.tileWidth, y: ty * this.grid.tileHeight, width: this.grid.tileWidth, height: this.grid.tileHeight }
+                }
+            });
+        }
+        // 2) integrate — one whole-atlas draw, per-fragment prefix sum.
+        const integrate = this.program("integrate");
+        const iu = new Map();
+        iu.set("u_injectAtlas", new TextureBinding({ name: "u_injectAtlas", texture: this.injectAtlas.colorTexture }));
+        iu.set("u_atlasSize", [this.grid.atlasWidth, this.grid.atlasHeight]);
+        iu.set("u_tileSize", [this.grid.tileWidth, this.grid.tileHeight]);
+        iu.set("u_tilesX", this.grid.tilesX);
+        iu.set("u_near", this.grid.near);
+        iu.set("u_far", this.grid.far);
+        iu.set("u_slices", this.grid.slices);
+        this.device.setRenderTarget(this.integrateAtlas);
+        this.device.draw({
+            label: "prd07.volumetric.integrate",
+            topology: "triangles",
+            vertexBuffer,
+            vertexFormat: geometry.vertexBuffer.format,
+            vertexCount: 3,
+            shader: integrate,
+            uniforms: iu,
+            renderState: FULL_SCREEN
+        });
+        this.device.setRenderTarget(callerRt);
+        // 3) apply draw closure (premultiplied-over into the caller's target).
+        const integrateAtlas = this.integrateAtlas;
+        const sceneDepth = input.sceneDepth;
+        const depthLinearize = input.depthLinearize;
+        const apply = (target) => {
+            const au = new Map();
+            au.set("u_integrateAtlas", new TextureBinding({ name: "u_integrateAtlas", texture: integrateAtlas.colorTexture }));
+            au.set("u_sceneDepth", new TextureBinding({ name: "u_sceneDepth", texture: sceneDepth, sampler: PRD07_DEPTH_SAMPLER, required: true }));
+            au.set("u_depthLinearize", [...depthLinearize]);
+            au.set("u_atlasSize", [this.grid.atlasWidth, this.grid.atlasHeight]);
+            au.set("u_tileSize", [this.grid.tileWidth, this.grid.tileHeight]);
+            au.set("u_tilesX", this.grid.tilesX);
+            au.set("u_near", this.grid.near);
+            au.set("u_far", this.grid.far);
+            au.set("u_slices", this.grid.slices);
+            const prev = this.device.getRenderTarget?.() ?? null;
+            this.device.setRenderTarget(target);
+            this.device.draw({
+                label: "prd07.volumetric.apply",
+                topology: "triangles",
+                vertexBuffer,
+                vertexFormat: geometry.vertexBuffer.format,
+                vertexCount: 3,
+                shader: this.program("apply"),
+                uniforms: au,
+                renderState: { ...FULL_SCREEN, blendMode: "premultiplied", blend: true }
+            });
+            this.device.setRenderTarget(prev);
+        };
+        return { apply, notes };
+    }
+    dispose() {
+        for (const t of [this.injectAtlas, this.integrateAtlas, this.temporalPrev])
+            t?.dispose();
+        this.injectAtlas = null;
+        this.integrateAtlas = null;
+        this.temporalPrev = null;
+    }
+}
+const IDENTITY_MAT4 = new Float32Array([1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1]);
+/** Invert a rigid-body (rotation+translation) view matrix column-major. */
+export function invertRigid(m) {
+    // Rigid inverse: Rᵀ + -Rᵀt (column-major mat4).
+    const r00 = m[0], r10 = m[1], r20 = m[2];
+    const r01 = m[4], r11 = m[5], r21 = m[6];
+    const r02 = m[8], r12 = m[9], r22 = m[10];
+    const tx = m[12], ty = m[13], tz = m[14];
+    const out = new Float32Array(16);
+    out[0] = r00;
+    out[4] = r10;
+    out[8] = r20;
+    out[1] = r01;
+    out[5] = r11;
+    out[9] = r21;
+    out[2] = r02;
+    out[6] = r12;
+    out[10] = r22;
+    out[12] = -(r00 * tx + r10 * ty + r20 * tz); // -Rᵀt component 0 (R column 0 · t)
+    out[13] = -(r01 * tx + r11 * ty + r21 * tz);
+    out[14] = -(r02 * tx + r12 * ty + r22 * tz);
+    out[15] = 1;
+    return out;
+}
+//# sourceMappingURL=VolumetricFogPass.js.map

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

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

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

@@ -0,0 +1,8 @@
+export declare const FOG_CHUNK_NAME: "a3d_prd07_fog";
+export declare const WETNESS_CHUNK_NAME: "a3d_prd07_wetness";
+/** #880 / T0-05 call chunks (statements only) for the C-02 body hooks. */
+export declare const FOG_APPLY_CHUNK_NAME: "a3d_prd07_fog_apply";
+export declare const WETNESS_APPLY_CHUNK_NAME: "a3d_prd07_wetness_apply";
+/** Idempotent chunk registration (P1-T1). */
+export declare function registerPrd07Chunks(): void;
+//# sourceMappingURL=fogChunks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fogChunks.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/atmosphere/fogChunks.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,cAAc,EAAG,eAAwB,CAAC;AACvD,eAAO,MAAM,kBAAkB,EAAG,mBAA4B,CAAC;AAC/D,0EAA0E;AAC1E,eAAO,MAAM,oBAAoB,EAAG,qBAA8B,CAAC;AACnE,eAAO,MAAM,wBAAwB,EAAG,yBAAkC,CAAC;AAc3E,6CAA6C;AAC7C,wBAAgB,mBAAmB,IAAI,IAAI,CAgB1C"}

package/dist/rendering/atmosphere/fogChunks.js

@@ -0,0 +1,39 @@
+// PRD-07 P4-T4 — C-02 chunks: "a3d_prd07_fog" and "a3d_prd07_wetness".
+// Registered now so programs can `requires` them; the fog uniforms land with
+// P4-T5's FOG_PROGRAM_DEFINES material hook-up.
+import { registerShaderChunk } from "../contracts/program.js";
+export const FOG_CHUNK_NAME = "a3d_prd07_fog";
+export const WETNESS_CHUNK_NAME = "a3d_prd07_wetness";
+/** #880 / T0-05 call chunks (statements only) for the C-02 body hooks. */
+export const FOG_APPLY_CHUNK_NAME = "a3d_prd07_fog_apply";
+export const WETNESS_APPLY_CHUNK_NAME = "a3d_prd07_wetness_apply";
+import { PRD07_FOG_APPLY_CHUNK_GLSL, PRD07_FOG_CHUNK_GLSL } from "./shaders/fog.glsl.js";
+import { PRD07_WETNESS_APPLY_CHUNK_GLSL, PRD07_WETNESS_CHUNK_GLSL } from "./shaders/wetness.glsl.js";
+// §8.4 uniform-block chunk (u_fogA/u_fogB/u_fogColor/u_fogAbsorption/u_fogMode/
+// u_fogNear/u_fogFar/u_fogVolumes + env uniforms u_cameraPosition/u_sunDirection/
+// u_sunColor). Packed by HeightFog.packV2; modes 0-6 incl. legacy-parity 6.
+const FOG_GLSL = PRD07_FOG_CHUNK_GLSL;
+// §6.8 wetness chunk (u_wetness/u_puddleThreshold/u_rainRipples/u_snowCover +
+// u_puddleNoise). Real §6.8 formulas live in shaders/wetness.glsl.ts.
+const WETNESS_GLSL = PRD07_WETNESS_CHUNK_GLSL;
+/** Idempotent chunk registration (P1-T1). */
+export function registerPrd07Chunks() {
+    const chunks = [
+        { name: FOG_CHUNK_NAME, owner: "prd07", stage: "fragment", glsl: FOG_GLSL },
+        { name: WETNESS_CHUNK_NAME, owner: "prd07", stage: "fragment", glsl: WETNESS_GLSL },
+        // Pars/call split (#880): the declaration chunks above go to
+        // `fragment:pars`; these run inside main() and require them.
+        { name: FOG_APPLY_CHUNK_NAME, owner: "prd07", stage: "fragment", glsl: PRD07_FOG_APPLY_CHUNK_GLSL, requires: [FOG_CHUNK_NAME] },
+        { name: WETNESS_APPLY_CHUNK_NAME, owner: "prd07", stage: "fragment", glsl: PRD07_WETNESS_APPLY_CHUNK_GLSL, requires: [WETNESS_CHUNK_NAME] }
+    ];
+    for (const chunk of chunks) {
+        try {
+            registerShaderChunk(chunk);
+        }
+        catch (error) {
+            if (!(error instanceof Error && error.message.startsWith("SHADER_CHUNK_DUPLICATE")))
+                throw error;
+        }
+    }
+}
+//# sourceMappingURL=fogChunks.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fogChunks.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/atmosphere/fogChunks.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,6EAA6E;AAC7E,gDAAgD;AAEhD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,CAAC,MAAM,cAAc,GAAG,eAAwB,CAAC;AACvD,MAAM,CAAC,MAAM,kBAAkB,GAAG,mBAA4B,CAAC;AAC/D,0EAA0E;AAC1E,MAAM,CAAC,MAAM,oBAAoB,GAAG,qBAA8B,CAAC;AACnE,MAAM,CAAC,MAAM,wBAAwB,GAAG,yBAAkC,CAAC;AAE3E,OAAO,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,EAAE,8BAA8B,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAElG,gFAAgF;AAChF,kFAAkF;AAClF,4EAA4E;AAC5E,MAAM,QAAQ,GAAG,oBAAoB,CAAC;AAEtC,8EAA8E;AAC9E,sEAAsE;AACtE,MAAM,YAAY,GAAG,wBAAwB,CAAC;AAE9C,6CAA6C;AAC7C,MAAM,UAAU,mBAAmB;IACjC,MAAM,MAAM,GAAG;QACb,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,OAAgB,EAAE,KAAK,EAAE,UAAmB,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC7F,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,OAAgB,EAAE,KAAK,EAAE,UAAmB,EAAE,IAAI,EAAE,YAAY,EAAE;QACrG,6DAA6D;QAC7D,6DAA6D;QAC7D,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,OAAgB,EAAE,KAAK,EAAE,UAAmB,EAAE,IAAI,EAAE,0BAA0B,EAAE,QAAQ,EAAE,CAAC,cAAc,CAAC,EAAE;QACjJ,EAAE,IAAI,EAAE,wBAAwB,EAAE,KAAK,EAAE,OAAgB,EAAE,KAAK,EAAE,UAAmB,EAAE,IAAI,EAAE,8BAA8B,EAAE,QAAQ,EAAE,CAAC,kBAAkB,CAAC,EAAE;KAC9J,CAAC;IACF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,wBAAwB,CAAC,CAAC;gBAAE,MAAM,KAAK,CAAC;QACnG,CAAC;IACH,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,20 @@
+import type { UniformValue } from "../RenderDevice.js";
+import type { PackedFogUniforms, Vec3 } from "./HeightFog.js";
+import { type Prd07FogVolume } from "./FogVolumes.js";
+export interface Prd07ForwardFogState {
+    readonly uniforms: PackedFogUniforms;
+    readonly volumes: readonly Prd07FogVolume[];
+    readonly sunDirection: Vec3;
+    readonly sunColor: Vec3;
+    readonly cameraPosition: Vec3;
+}
+/** Called by the prd07.fog contributor each frame; `null` = no live fog node (IC-0: mode 0). */
+export declare function setPrd07ForwardFog(state: Prd07ForwardFogState | null): void;
+export declare function prd07ForwardFog(): Prd07ForwardFogState | null;
+/**
+ * `prd07.fog` ShaderFeature.bindUniforms body. Always writes `u_fogMode` so a
+ * program that selected the feature never reads a stale mode from a previous
+ * draw's uniform packet; the remaining slots are written only while fog is live.
+ */
+export declare function bindPrd07FogUniforms(set: (name: string, value: UniformValue) => void): void;
+//# sourceMappingURL=fogUniformStore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fogUniformStore.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/atmosphere/fogUniformStore.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IAC5C,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC;CAC/B;AAID,gGAAgG;AAChG,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,GAAG,IAAI,CAE3E;AAED,wBAAgB,eAAe,IAAI,oBAAoB,GAAG,IAAI,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI,CAkB3F"}

package/dist/rendering/atmosphere/fogUniformStore.js

@@ -0,0 +1,45 @@
+// PRD-07 P4-T4 / #187 / #82 — forward-geometry binding for the C-21 fog chunk.
+//
+// The `prd07.fog` ShaderFeature splices `a3d_prd07_fog` into C-02 generated
+// forward programs (pars at fragment:pars, call at fragment:fog — #880), but a
+// per-draw `bindUniforms` sees no frame blackboard. The prd07.fog contributor
+// therefore publishes the frame's packed §8.4 uniforms here during collect, and
+// the feature's `bindUniforms` reads them per draw (same module-store pattern
+// as wetness). Without this binding every u_fog* uniform stays 0 → mode 0 →
+// forward geometry is never fogged, so `setFog({ mode: "absorption" })` only
+// reached the sky and decals. With it, mode 5 (Beer-Lambert per-channel
+// T = exp(-σ·d)) shades forward geometry on the real C-02 path.
+import { packFogVolumes } from "./FogVolumes.js";
+let forwardFog = null;
+/** Called by the prd07.fog contributor each frame; `null` = no live fog node (IC-0: mode 0). */
+export function setPrd07ForwardFog(state) {
+    forwardFog = state;
+}
+export function prd07ForwardFog() {
+    return forwardFog;
+}
+/**
+ * `prd07.fog` ShaderFeature.bindUniforms body. Always writes `u_fogMode` so a
+ * program that selected the feature never reads a stale mode from a previous
+ * draw's uniform packet; the remaining slots are written only while fog is live.
+ */
+export function bindPrd07FogUniforms(set) {
+    const state = forwardFog;
+    if (!state) {
+        set("u_fogMode", 0);
+        return;
+    }
+    const f = state.uniforms;
+    set("u_fogA", [...f.fogA]);
+    set("u_fogB", [...f.fogB]);
+    set("u_fogColor", [...f.fogColor]);
+    set("u_fogAbsorption", [...f.fogAbsorption]);
+    set("u_fogMode", f.fogMode);
+    set("u_fogNear", f.fogNear);
+    set("u_fogFar", f.fogFar);
+    set("u_fogVolumes", packFogVolumes(state.volumes));
+    set("u_cameraPosition", [...state.cameraPosition]);
+    set("u_sunDirection", [...state.sunDirection]);
+    set("u_sunColor", [...state.sunColor]);
+}
+//# sourceMappingURL=fogUniformStore.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fogUniformStore.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/atmosphere/fogUniformStore.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,EAAE;AACF,4EAA4E;AAC5E,+EAA+E;AAC/E,8EAA8E;AAC9E,gFAAgF;AAChF,8EAA8E;AAC9E,4EAA4E;AAC5E,6EAA6E;AAC7E,wEAAwE;AACxE,gEAAgE;AAIhE,OAAO,EAAE,cAAc,EAAuB,MAAM,cAAc,CAAC;AAUnE,IAAI,UAAU,GAAgC,IAAI,CAAC;AAEnD,gGAAgG;AAChG,MAAM,UAAU,kBAAkB,CAAC,KAAkC;IACnE,UAAU,GAAG,KAAK,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAgD;IACnF,MAAM,KAAK,GAAG,UAAU,CAAC;IACzB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACpB,OAAO;IACT,CAAC;IACD,MAAM,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC;IACzB,GAAG,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3B,GAAG,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3B,GAAG,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnC,GAAG,CAAC,iBAAiB,EAAE,CAAC,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;IAC7C,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IAC5B,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IAC5B,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IAC1B,GAAG,CAAC,cAAc,EAAE,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACnD,GAAG,CAAC,kBAAkB,EAAE,CAAC,GAAG,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;IACnD,GAAG,CAAC,gBAAgB,EAAE,CAAC,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;IAC/C,GAAG,CAAC,YAAY,EAAE,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/dist/rendering/atmosphere/shaders/fog.glsl.d.ts

@@ -0,0 +1,10 @@
+export declare const PRD07_FOG_CHUNK_GLSL = "\n#ifndef A3D_PRD07_FOG_CHUNK\n#define A3D_PRD07_FOG_CHUNK\n#ifndef A3D_MAX_FOG_VOLUMES\n#define A3D_MAX_FOG_VOLUMES 8\n#endif\nuniform vec4 u_fogA;   // \u03C3_d, \u03C3_h, b, h0 \u2014 mode 6: density, heightFalloff, heightReference, legacyMode\nuniform vec4 u_fogB;   // start, maxOpacity, sunInscatter, anisotropy g \u2014 mode 6: near, far, maxOpacity, 0\n// #880: the C-02 generator's fog_default chunk already declares u_fogColor\n// (same meaning) under FOG_LINEAR / FOG_EXP2 / FOG_HEIGHT and is emitted\n// before feature declarations, so share it instead of redeclaring.\n#if !defined(FOG_LINEAR) && !defined(FOG_EXP2) && !defined(FOG_HEIGHT)\nuniform vec3 u_fogColor;\n#endif\nuniform vec3 u_fogAbsorption; uniform float u_fogMode;  // 0 off,1 height,2 exp,3 exp2,4 linear,5 absorption,6 legacy-parity\nuniform float u_fogNear; uniform float u_fogFar;                               // linear (mode 4) + legacy-parity distances\nuniform vec4 u_fogVolumes[2 * A3D_MAX_FOG_VOLUMES];             // centre.xyz+shape, halfSize.xyz+density\n#ifndef A3D_PRD07_FOG_ENV_UNIFORMS\n#define A3D_PRD07_FOG_ENV_UNIFORMS\nuniform vec3 u_cameraPosition;\nuniform vec3 u_sunDirection;\nuniform vec3 u_sunColor;\n#endif\n\nfloat a3dHeightFogTau(vec3 c, vec3 v, float d) {\n  float dd = max(d - u_fogB.x, 0.0);\n  float tau = u_fogA.x * dd;\n  float k = u_fogA.z * v.y * dd;\n  float line = abs(k) < 1e-4 ? 1.0 : (1.0 - exp(-k)) / k;\n  tau += u_fogA.y * exp(-u_fogA.z * (c.y - u_fogA.w)) * dd * line;\n  return tau;\n}\n\nfloat a3dFogVolumesTau(vec3 c, vec3 v, float d) {\n  float tau = 0.0;\n  for (int i = 0; i < A3D_MAX_FOG_VOLUMES; i++) {\n    vec4 a = u_fogVolumes[i * 2];\n    vec4 b = u_fogVolumes[i * 2 + 1];\n    if (b.w <= 0.0) continue;\n    vec3 lo = a.xyz - b.xyz;\n    vec3 hi = a.xyz + b.xyz;\n    float t0 = 0.0;\n    float t1 = d;\n    bool hit = true;\n    for (int axis = 0; axis < 3; axis++) {\n      float o = c[axis] - a.xyz[axis];\n      float dv = v[axis];\n      float half_ = b.xyz[axis];\n      if (abs(dv) < 1e-9) {\n        if (abs(o) > half_) { hit = false; }\n        continue;\n      }\n      float ta = (-half_ - o) / dv;\n      float tb = (half_ - o) / dv;\n      t0 = max(t0, min(ta, tb));\n      t1 = min(t1, max(ta, tb));\n    }\n    if (a.w > 0.5) {\n      // ellipsoid \u2192 unit-sphere quadratic\n      vec3 os = (c - a.xyz) / max(b.xyz, vec3(1e-9));\n      vec3 vs = v / max(b.xyz, vec3(1e-9));\n      float qa = dot(vs, vs);\n      if (qa < 1e-12) { hit = false; }\n      float qb = dot(os, vs);\n      float qc = dot(os, os) - 1.0;\n      float qd = qb * qb - qa * qc;\n      if (qd < 0.0 || !hit) { hit = false; }\n      else {\n        float qr = sqrt(qd);\n        t0 = max((-qb - qr) / qa, 0.0);\n        t1 = min((-qb + qr) / qa, d);\n      }\n    } else {\n      t0 = max(t0, 0.0);\n      t1 = min(t1, d);\n    }\n    if (hit && t1 > t0) tau += (t1 - t0) * b.w;\n  }\n  return tau;\n}\n\nfloat a3dLegacyFogFactor(vec3 worldPosition) {\n  // u_fogMode == 6.0 \u2014 verbatim a3dEnvironmentFogFactor over the aliased slots.\n  float distanceToCamera = length(u_cameraPosition - worldPosition);\n  float factor = 0.0;\n  float legacyMode = u_fogA.w;\n  if (legacyMode < 1.5) {\n    factor = (distanceToCamera - u_fogB.x) / max(u_fogB.y - u_fogB.x, 0.000001);\n  } else if (legacyMode < 2.5) {\n    factor = 1.0 - exp(-max(u_fogA.x, 0.0) * distanceToCamera);\n  } else {\n    float scaledDensity = max(u_fogA.x, 0.0) * distanceToCamera;\n    factor = 1.0 - exp(-(scaledDensity * scaledDensity));\n  }\n  float heightMultiplier = u_fogA.y > 0.0\n    ? exp(-max(0.0, worldPosition.y - u_fogA.z) * u_fogA.y)\n    : 1.0;\n  return clamp(factor * heightMultiplier, 0.0, 1.0) * clamp(u_fogB.z, 0.0, 1.0);\n}\n\nfloat a3dFogAmount(vec3 worldPos) {\n  if (u_fogMode == 6.0) return a3dLegacyFogFactor(worldPos);\n  vec3 r = worldPos - u_cameraPosition; float d = length(r); vec3 v = r / max(d, 1e-5);\n  float tau = (u_fogMode == 1.0) ? a3dHeightFogTau(u_cameraPosition, v, d)\n            : (u_fogMode == 2.0) ? u_fogA.x * d\n            : (u_fogMode == 3.0) ? (u_fogA.x * d) * (u_fogA.x * d) : 0.0;\n  tau += a3dFogVolumesTau(u_cameraPosition, v, d);\n  float f = (u_fogMode == 4.0) ? clamp((d - u_fogNear) / (u_fogFar - u_fogNear), 0.0, 1.0) : 1.0 - exp(-tau);\n  return min(f, u_fogB.y);\n}\n\nvec3 a3dFogInscatter(vec3 v) {\n  float g = u_fogB.w; float mu = dot(v, u_sunDirection);\n  float hg = (1.0 - g * g) / (12.5663706 * pow(1.0 + g * g - 2.0 * g * mu, 1.5));\n  return u_fogColor + u_sunColor * hg * u_fogB.z;\n}\n\nvec3 a3dApplyFog(vec3 color, vec3 worldPos) {                  // stable entry point (PRD 10)\n  if (u_fogMode == 0.0) return color;\n  vec3 r = worldPos - u_cameraPosition; vec3 v = normalize(r);\n  if (u_fogMode == 5.0) { vec3 T = exp(-u_fogAbsorption * length(r)); return color * T + u_fogColor * (1.0 - T); }\n#if defined(FOG_VOLUMETRIC)\n  // Consumer contract: a FOG_VOLUMETRIC program defines a3dSampleFroxel()\n  // before this chunk. Forward programs never set FOG_VOLUMETRIC; the froxel\n  // volume is composited there by VolumetricFogPass apply (\u00A78.7).\n  vec4 s = a3dSampleFroxel(worldPos);                          // rgb inscatter, a transmittance\n  color = color * s.a + s.rgb;                                 // near part from the volume\n#endif\n  float f = a3dFogAmount(worldPos);\n  // Mode 6 (legacy parity): the legacy formula has no sun inscatter \u2014 u_fogB.z\n  // is maxOpacity, NOT sunInscatter. Blend to the plain fog colour.\n  vec3 fogged = (u_fogMode == 6.0) ? u_fogColor : a3dFogInscatter(v);\n  return mix(color, fogged, f);\n}\n#endif // A3D_PRD07_FOG_CHUNK\n";
+export declare const PRD07_FOG_SHADER_MARKER = "a3d_prd07_fog_v2";
+/**
+ * #880 / T0-05 — `fragment:fog` call chunk (statements only, inside `main()`).
+ * The declarations above are the pars chunk at `fragment:pars`; this replaces
+ * the generator's default fog body (`a3dColor`, `v_worldPosition` are the
+ * C-02 forward fragment's names).
+ */
+export declare const PRD07_FOG_APPLY_CHUNK_GLSL = "\n#ifdef A3D_FOG\n  a3dColor = a3dApplyFog(a3dColor, v_worldPosition);\n#endif\n";
+//# sourceMappingURL=fog.glsl.d.ts.map

package/dist/rendering/atmosphere/shaders/fog.glsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fog.glsl.d.ts","sourceRoot":"","sources":["../../../../../../packages/rendering/src/atmosphere/shaders/fog.glsl.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,oBAAoB,+hLAuIhC,CAAC;AAEF,eAAO,MAAM,uBAAuB,qBAAqB,CAAC;AAE1D;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,qFAItC,CAAC"}