@aura3d/engine 3.0.1 → 4.0.0

package/dist/rendering/world/vegetation/shaders/wind.js

@@ -0,0 +1,103 @@
+/** `a3dWindOffset` body, shared by the Path S UBO chunk and the Path G deform chunk. */
+const WIND_OFFSET_FN_GLSL = /* glsl */ `
+vec3 a3dWindOffset(vec3 localPos, vec3 instanceOrigin, vec4 weights /* vertex colour */, float assetHeight) {
+  vec2 dir = u_windDirStrength.xy; float strength = u_windDirStrength.z; float t = u_windDirStrength.w;
+  vec2 gustUv = instanceOrigin.xz * u_windGust.y - dir * t * 0.08;
+  float gust = texture(u_windNoise, gustUv).r * u_windGust.x;
+  float h = clamp(localPos.y / max(assetHeight, 0.01), 0.0, 1.0);
+  float bend = (strength + gust) * h * h * weights.r;                  // trunk/branch bend, quadratic in height
+  float sway = sin(t * (1.1 + weights.b) + dot(instanceOrigin.xz, vec2(0.37, 0.71))) * 0.25 * strength * weights.r;
+  vec3 offset = vec3(dir.x, 0.0, dir.y) * (bend + sway) * 0.35 * assetHeight;
+  float flutter = sin(t * 7.3 + weights.b * 6.2831 + dot(localPos, vec3(2.1, 1.7, 2.9))) * 0.035 * (strength + gust) * weights.g;
+  offset += vec3(flutter, flutter * 0.4, -flutter);
+  // length preservation: keep the vertex on a sphere around the root to avoid stretching
+  vec3 bent = localPos + offset;
+  float len = length(localPos);
+  if (len < 1e-5) return vec3(0.0);                                    // root vertex (WindCpu parity)
+  return normalize(bent) * len - localPos;                             // length-preserving offset
+}
+`;
+const glsl = /* glsl */ `
+layout(std140) uniform A3DWind {
+  vec4 u_windDirStrength;   // dir.xz, strength, time
+  vec4 u_windGust;          // gustStrength, 1/gustScale, -, -
+};
+uniform sampler2D u_windNoise; // 64² RG8, repeat
+${WIND_OFFSET_FN_GLSL}`;
+const wgsl = /* wgsl */ `
+struct A3DWind {
+  dirStrength : vec4f,   // dir.xz, strength, time
+  gust : vec4f,          // gustStrength, 1/gustScale, -, -
+};
+@group(0) @binding(0) var<uniform> u_wind : A3DWind;
+@group(0) @binding(1) var u_windNoise : texture_2d<f32>;
+@group(0) @binding(2) var u_windNoiseSampler : sampler;
+
+fn a3dWindOffset(localPos : vec3f, instanceOrigin : vec3f, weights : vec4f, assetHeight : f32) -> vec3f {
+  let dir = u_wind.dirStrength.xy;
+  let strength = u_wind.dirStrength.z;
+  let t = u_wind.dirStrength.w;
+  let gustUv = instanceOrigin.xz * u_wind.gust.y - dir * t * 0.08;
+  let gust = textureSample(u_windNoise, u_windNoiseSampler, gustUv).r * u_wind.gust.x;
+  let h = clamp(localPos.y / max(assetHeight, 0.01), 0.0, 1.0);
+  let bend = (strength + gust) * h * h * weights.r;
+  let sway = sin(t * (1.1 + weights.b) + dot(instanceOrigin.xz, vec2f(0.37, 0.71))) * 0.25 * strength * weights.r;
+  var offset = vec3f(dir.x, 0.0, dir.y) * (bend + sway) * 0.35 * assetHeight;
+  let flutter = sin(t * 7.3 + weights.b * 6.2831 + dot(localPos, vec3f(2.1, 1.7, 2.9))) * 0.035 * (strength + gust) * weights.g;
+  offset = offset + vec3f(flutter, flutter * 0.4, -flutter);
+  let bent = localPos + offset;
+  return normalize(bent) * length(localPos) - localPos;
+}
+`;
+export const a3d_prd10_wind = {
+    name: "a3d_prd10_wind",
+    owner: "prd10",
+    stage: "vertex",
+    glsl,
+    wgsl
+};
+/**
+ * #1143 — `a3d_prd10_wind_deform`: the generated-program (C-02, Path G) form
+ * of the wind chunk at `vertex:deform`. The generated path binds per-draw
+ * uniforms by name and only assigns binding points for AuraFrame/AuraLights,
+ * so an `A3DWind` block there would alias binding 0 (AuraFrame). This chunk
+ * declares the same two vec4s as plain uniforms (bound by the `prd10.wind`
+ * feature's `bindUniforms`) and defines the canonical C-18 entry
+ * `a3dDeform(inout vec4, inout vec3, inout vec4)` that the generator and the
+ * PRD-02 depth library call.
+ *
+ * Instance origin: the attribute-instancing translation column when present.
+ * Weights: vertex colour when present, else a trunk-bend default. A program
+ * that already defines a C-18 entry (prd06.deform, emitted first by id
+ * order) sets `A3D_DEFORM_ENTRY` and exports `a3dDeformBeforeWind`, so wind
+ * composes after morph/skin instead of silently suppressing either effect.
+ */
+const deformGlsl = /* glsl */ `
+uniform vec4 u_windDirStrength;   // dir.xz, strength, time
+uniform vec4 u_windGust;          // gustStrength, 1/gustScale, -, -
+uniform sampler2D u_windNoise;    // 64² RG8, repeat
+uniform float u_windAssetHeight;  // metres, asset bounds height
+${WIND_OFFSET_FN_GLSL}
+void a3dDeform(inout vec4 localPos, inout vec3 localNormal, inout vec4 localTangent) {
+#ifdef A3D_DEFORM_ENTRY
+  a3dDeformBeforeWind(localPos, localNormal, localTangent);
+#endif
+  vec3 origin = vec3(0.0);
+#if defined(USE_INSTANCING) && defined(A3D_STAGE_VERTEX)
+  origin = a_instanceMatrix3.xyz;
+#endif
+  vec4 weights = vec4(1.0, 1.0, 0.5, 1.0);
+#if defined(VERTEX_COLORS) && defined(A3D_STAGE_VERTEX)
+  weights = a_color;
+#endif
+  localPos.xyz += a3dWindOffset(localPos.xyz, origin, weights, max(u_windAssetHeight, 0.01));
+}
+`;
+export const a3d_prd10_wind_deform = {
+    name: "a3d_prd10_wind_deform",
+    owner: "prd10",
+    stage: "vertex",
+    glsl: deformGlsl,
+    wgsl
+};
+//# sourceMappingURL=wind.js.map

package/dist/rendering/world/vegetation/shaders/wind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wind.js","sourceRoot":"","sources":["../../../../../../../packages/rendering/src/world/vegetation/shaders/wind.ts"],"names":[],"mappings":"AAOA,wFAAwF;AACxF,MAAM,mBAAmB,GAAG,UAAU,CAAC;;;;;;;;;;;;;;;;;CAiBtC,CAAC;AAEF,MAAM,IAAI,GAAG,UAAU,CAAC;;;;;;EAMtB,mBAAmB,EAAE,CAAC;AAExB,MAAM,IAAI,GAAG,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;CAwBvB,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,IAAI,EAAE,gBAAgB;IACtB,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,QAAQ;IACf,IAAI;IACJ,IAAI;CACL,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,GAAG,UAAU,CAAC;;;;;EAK5B,mBAAmB;;;;;;;;;;;;;;;CAepB,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAgB;IAChD,IAAI,EAAE,uBAAuB;IAC7B,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,QAAQ;IACf,IAAI,EAAE,UAAU;IAChB,IAAI;CACL,CAAC"}

package/dist/rendering/world/water/GerstnerWaves.d.ts

@@ -0,0 +1,65 @@
+/**
+ * PRD-10 §8.6 / T4.1 — Gerstner waves: the shared CPU/GPU source of truth.
+ *
+ * Two layers:
+ *
+ * 1. Spec layer (`GerstnerWaveSpec` → `packGerstnerWaves` → `gerstnerEvaluate`)
+ *    mirrors the `a3d_prd10_gerstner` shader chunk exactly: `k = 2π/λ`,
+ *    `c = sqrt(9.81/k) * speed`, `f = k·(d·xz − c·t)`, `a = steepness/k`.
+ *    The CPU clamps Σ steepness ≤ 1 per the spec's loop-prevention rule.
+ *    `water.surface`/`app.world.water(id)` heightAt/normalAt run through
+ *    `gerstnerEvaluate`, so physics and pixels share one formula (§"one
+ *    source for physics and pixels").
+ *
+ * 2. Fixture layer (`oceanPresetWaves`, `evaluateWaves`, `waveCompression`)
+ *    is the T4.1 move out of `OceanSurface.ts` — the external-parity ocean
+ *    fixture consumes them; `OceanSurface.ts` re-exports to keep its public
+ *    surface unchanged until T4.7 retires the capture path.
+ */
+import type { OceanFixturePreset, OceanWaveDescriptor } from "../../OceanSurface.js";
+/** §7.1.6 `AuraGerstnerWave` — authored wave descriptor (metres/degrees). */
+export interface GerstnerWaveSpec {
+    readonly directionDeg: number;
+    readonly wavelength: number;
+    readonly steepness: number;
+    readonly speed?: number;
+}
+/** Flat uniform layout matching `a3d_prd10_gerstner` (§8.6). */
+export interface GerstnerWaveUniforms {
+    /** vec4[8]: dir.x, dir.y, steepness, wavelength — zeros beyond waveCount. */
+    readonly waves: Float32Array;
+    /** float[8]: speed multiplier per wave — zeros beyond waveCount. */
+    readonly waveSpeed: Float32Array;
+    readonly waveCount: number;
+    /** Steepness values that were rescaled to satisfy Σ ≤ 1 (0 when no clamp). */
+    readonly steepnessClamped: number;
+}
+export declare const GERSTNER_MAX_WAVES = 8;
+/** `waves` presets (§7.1.6): calm/moderate resolve to 4 waves, rough to 8. */
+export declare const GERSTNER_PRESETS: Record<"calm" | "moderate" | "rough", readonly GerstnerWaveSpec[]>;
+export declare function resolveGerstnerWaves(waves: readonly GerstnerWaveSpec[] | "calm" | "moderate" | "rough" | undefined): readonly GerstnerWaveSpec[];
+/**
+ * Pack specs into the shader's flat uniform layout. Steepness is rescaled
+ * uniformly when Σ steepness > 1 (§8.6 loop prevention). `maxWaves` is the
+ * tier cap (4 Low / 8 High — §4.5 counts down by tier).
+ */
+export declare function packGerstnerWaves(specs: readonly GerstnerWaveSpec[], maxWaves?: number): GerstnerWaveUniforms;
+export interface GerstnerEvaluation {
+    /** Displaced surface point (x, y, z) — xz is displaced by the wave field. */
+    readonly position: readonly [number, number, number];
+    readonly normal: readonly [number, number, number];
+    /** Jacobian proxy `1 − Σ steepness·sin(f)` — crest foam input. */
+    readonly crest: number;
+}
+/** CPU twin of the `a3d_prd10_gerstner` GLSL — keep the two in lockstep. */
+export declare function gerstnerEvaluate(packed: GerstnerWaveUniforms, x: number, z: number, timeSeconds: number): GerstnerEvaluation;
+/** Convenience: surface height only (the `AuraWaterHandle.heightAt` path). */
+export declare function gerstnerHeightAt(packed: GerstnerWaveUniforms, x: number, z: number, timeSeconds: number): number;
+export declare function oceanPresetWaves(preset: OceanFixturePreset): readonly OceanWaveDescriptor[];
+export declare function evaluateWaves(waves: readonly OceanWaveDescriptor[], x: number, z: number, time: number): {
+    readonly height: number;
+    readonly horizontalDisplacement: readonly [number, number];
+    readonly normal: readonly [number, number, number];
+};
+export declare function waveCompression(waves: readonly OceanWaveDescriptor[], x: number, z: number, time: number): number;
+//# sourceMappingURL=GerstnerWaves.d.ts.map

package/dist/rendering/world/water/GerstnerWaves.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GerstnerWaves.d.ts","sourceRoot":"","sources":["../../../../../../packages/rendering/src/world/water/GerstnerWaves.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAIrF,6EAA6E;AAC7E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,gEAAgE;AAChE,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,8EAA8E;IAC9E,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,GAAG,UAAU,GAAG,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAuBtF,CAAC;AAEX,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,gBAAgB,EAAE,CAIhJ;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,EAAE,QAAQ,GAAE,MAA2B,GAAG,oBAAoB,CAYjI;AAED,MAAM,WAAW,kBAAkB;IACjC,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACrD,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,oBAAoB,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,kBAAkB,CAwC5H;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,oBAAoB,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAEhH;AAKD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,GAAG,SAAS,mBAAmB,EAAE,CA6B3F;AAaD,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG;IACxG,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,sBAAsB,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3D,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACpD,CA4BA;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CASjH"}

package/dist/rendering/world/water/GerstnerWaves.js

@@ -0,0 +1,182 @@
+export const GERSTNER_MAX_WAVES = 8;
+/** `waves` presets (§7.1.6): calm/moderate resolve to 4 waves, rough to 8. */
+export const GERSTNER_PRESETS = {
+    calm: [
+        { directionDeg: 0, wavelength: 8.0, steepness: 0.18, speed: 1 },
+        { directionDeg: 35, wavelength: 4.2, steepness: 0.14, speed: 1 },
+        { directionDeg: 110, wavelength: 2.3, steepness: 0.1, speed: 1 },
+        { directionDeg: 220, wavelength: 1.4, steepness: 0.08, speed: 1 }
+    ],
+    moderate: [
+        { directionDeg: 0, wavelength: 12.0, steepness: 0.26, speed: 1 },
+        { directionDeg: 28, wavelength: 7.5, steepness: 0.2, speed: 1 },
+        { directionDeg: 96, wavelength: 4.1, steepness: 0.16, speed: 1 },
+        { directionDeg: 205, wavelength: 2.2, steepness: 0.12, speed: 1 }
+    ],
+    rough: [
+        { directionDeg: 0, wavelength: 16.0, steepness: 0.32, speed: 1.05 },
+        { directionDeg: 24, wavelength: 11.0, steepness: 0.26, speed: 1 },
+        { directionDeg: 78, wavelength: 7.0, steepness: 0.22, speed: 1 },
+        { directionDeg: 150, wavelength: 4.6, steepness: 0.18, speed: 1 },
+        { directionDeg: 200, wavelength: 3.2, steepness: 0.15, speed: 1 },
+        { directionDeg: 255, wavelength: 2.4, steepness: 0.12, speed: 1 },
+        { directionDeg: 315, wavelength: 1.8, steepness: 0.1, speed: 1 },
+        { directionDeg: 45, wavelength: 1.2, steepness: 0.08, speed: 1 }
+    ]
+};
+export function resolveGerstnerWaves(waves) {
+    if (waves === undefined || waves === "moderate")
+        return GERSTNER_PRESETS.moderate;
+    if (waves === "calm" || waves === "rough")
+        return GERSTNER_PRESETS[waves];
+    return waves;
+}
+/**
+ * Pack specs into the shader's flat uniform layout. Steepness is rescaled
+ * uniformly when Σ steepness > 1 (§8.6 loop prevention). `maxWaves` is the
+ * tier cap (4 Low / 8 High — §4.5 counts down by tier).
+ */
+export function packGerstnerWaves(specs, maxWaves = GERSTNER_MAX_WAVES) {
+    const capped = specs.slice(0, Math.min(maxWaves, GERSTNER_MAX_WAVES));
+    const sum = capped.reduce((s, w) => s + w.steepness, 0);
+    const scale = sum > 1 ? 1 / sum : 1;
+    const waves = new Float32Array(GERSTNER_MAX_WAVES * 4);
+    const waveSpeed = new Float32Array(GERSTNER_MAX_WAVES);
+    capped.forEach((w, i) => {
+        const rad = (w.directionDeg * Math.PI) / 180;
+        waves.set([Math.cos(rad), Math.sin(rad), w.steepness * scale, w.wavelength], i * 4);
+        waveSpeed[i] = w.speed ?? 1;
+    });
+    return { waves, waveSpeed, waveCount: capped.length, steepnessClamped: sum > 1 ? sum - 1 : 0 };
+}
+/** CPU twin of the `a3d_prd10_gerstner` GLSL — keep the two in lockstep. */
+export function gerstnerEvaluate(packed, x, z, timeSeconds) {
+    let px = x;
+    let py = 0;
+    let pz = z;
+    let tx = 1, ty = 0, tz = 0;
+    let bx = 0, by = 0, bz = 1;
+    let jacobian = 0;
+    const { waves, waveSpeed, waveCount } = packed;
+    for (let i = 0; i < waveCount; i += 1) {
+        const dx = waves[i * 4];
+        const dz = waves[i * 4 + 1];
+        const s = waves[i * 4 + 2];
+        const wavelength = waves[i * 4 + 3];
+        const k = 6.2831853 / wavelength;
+        const c = Math.sqrt(9.81 / k) * waveSpeed[i];
+        const f = k * (dx * x + dz * z - c * timeSeconds);
+        const a = s / k;
+        const sinF = Math.sin(f);
+        const cosF = Math.cos(f);
+        px += dx * a * cosF;
+        py += a * sinF;
+        pz += dz * a * cosF;
+        tx += -dx * dx * s * sinF;
+        ty += dx * s * cosF;
+        tz += -dx * dz * s * sinF;
+        bx += -dx * dz * s * sinF;
+        by += dz * s * cosF;
+        bz += -dz * dz * s * sinF;
+        jacobian += s * sinF;
+    }
+    // normal = normalize(cross(binormal, tangent))
+    const nx = by * tz - bz * ty;
+    const ny = bz * tx - bx * tz;
+    const nz = bx * ty - by * tx;
+    const len = Math.hypot(nx, ny, nz) || 1;
+    return {
+        position: [px, py, pz],
+        normal: [nx / len, ny / len, nz / len],
+        crest: 1 - jacobian
+    };
+}
+/** Convenience: surface height only (the `AuraWaterHandle.heightAt` path). */
+export function gerstnerHeightAt(packed, x, z, timeSeconds) {
+    return gerstnerEvaluate(packed, x, z, timeSeconds).position[1];
+}
+// ---------------------------------------------------------- fixture layer --
+// Moved verbatim from OceanSurface.ts (T4.1); OceanSurface re-exports them.
+export function oceanPresetWaves(preset) {
+    if (preset === "calm") {
+        return [
+            wave(0.045, 0.9, 0.55, [1, 0.12], 0.2),
+            wave(0.026, 0.48, 0.42, [0.58, 0.82], 0.18)
+        ];
+    }
+    if (preset === "rough") {
+        return [
+            wave(0.13, 1.4, 0.86, [1, 0.08], 0.58),
+            wave(0.09, 0.82, 0.72, [0.86, 0.5], 0.48),
+            wave(0.052, 0.46, 0.58, [0.54, 0.84], 0.42),
+            wave(0.032, 0.28, 0.48, [0.35, 0.94], 0.36)
+        ];
+    }
+    if (preset === "storm") {
+        return [
+            wave(0.18, 1.75, 1.02, [1, 0.06], 0.72),
+            wave(0.13, 1.08, 0.88, [0.92, 0.39], 0.62),
+            wave(0.082, 0.62, 0.75, [0.76, 0.65], 0.54),
+            wave(0.052, 0.36, 0.62, [0.48, 0.88], 0.48),
+            wave(0.034, 0.22, 0.52, [0.28, 0.96], 0.42)
+        ];
+    }
+    return [
+        wave(0.08, 1.1, 0.72, [1, 0.1], 0.38),
+        wave(0.055, 0.68, 0.58, [0.8, 0.6], 0.32),
+        wave(0.036, 0.38, 0.46, [0.6, 0.8], 0.28)
+    ];
+}
+function wave(amplitude, wavelength, speed, direction, steepness) {
+    const length = Math.hypot(direction[0], direction[1]) || 1;
+    return {
+        amplitude,
+        wavelength,
+        speed,
+        direction: [round3(direction[0] / length), round3(direction[1] / length)],
+        steepness: Math.min(1, steepness)
+    };
+}
+export function evaluateWaves(waves, x, z, time) {
+    let height = 0;
+    let dx = 0;
+    let dz = 0;
+    let nx = 0;
+    let ny = 1;
+    let nz = 0;
+    for (const descriptor of waves) {
+        const k = (2 * Math.PI) / descriptor.wavelength;
+        const omega = descriptor.speed * k;
+        const phase = k * (descriptor.direction[0] * x + descriptor.direction[1] * z) - omega * time;
+        const sin = Math.sin(phase);
+        const cos = Math.cos(phase);
+        const q = descriptor.steepness / Math.max(0.0001, descriptor.amplitude * k * waves.length);
+        const waveAmplitude = k * descriptor.amplitude;
+        height += descriptor.amplitude * sin;
+        dx += q * descriptor.amplitude * descriptor.direction[0] * cos;
+        dz += q * descriptor.amplitude * descriptor.direction[1] * cos;
+        nx -= descriptor.direction[0] * waveAmplitude * cos;
+        ny -= q * waveAmplitude * sin;
+        nz -= descriptor.direction[1] * waveAmplitude * cos;
+    }
+    const normalLength = Math.hypot(nx, ny, nz) || 1;
+    return {
+        height: round3(height),
+        horizontalDisplacement: [round3(dx), round3(dz)],
+        normal: [round3(nx / normalLength), round3(ny / normalLength), round3(nz / normalLength)]
+    };
+}
+export function waveCompression(waves, x, z, time) {
+    let compression = 1;
+    for (const descriptor of waves) {
+        const k = (2 * Math.PI) / descriptor.wavelength;
+        const omega = descriptor.speed * k;
+        const phase = k * (descriptor.direction[0] * x + descriptor.direction[1] * z) - omega * time;
+        compression -= descriptor.steepness * descriptor.amplitude * k * Math.sin(phase) * 0.35;
+    }
+    return round3(compression);
+}
+function round3(value) {
+    return Math.round(value * 1_000) / 1_000;
+}
+//# sourceMappingURL=GerstnerWaves.js.map

package/dist/rendering/world/water/GerstnerWaves.js.map

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

package/dist/rendering/world/water/ReflectionViewPass.d.ts

@@ -0,0 +1,46 @@
+/**
+ * PRD-10 §9.1 step 2 / T4.4 — `ReflectionViewPass`. For a water node whose
+ * `reflection` tier resolves to `"planar"` (High+), it reflects the camera
+ * about the water plane (C-08 `computePlanarMirrorCamera`), applies the
+ * Lengyel oblique near clip, and renders the reflection-tagged world items
+ * into a half-res RGBA16F target bound by the water fragment as
+ * `u_planarReflection`.
+ *
+ * Skip rules (§9.1): the pass is skipped when the plane is off-screen or the
+ * mirror's screen coverage is under 2%, and it never runs on Low.
+ */
+import type { RenderDevice } from "../../RenderDevice.js";
+import type { RenderPass } from "../../RenderPass.js";
+import type { FrameContributorContext } from "../../contracts/frameGraph.js";
+export declare const PLANAR_REFLECTION_KEY = "prd10.water.reflection";
+export interface ReflectionRequest {
+    /** Water node id + plane height for diagnostics and the shader bind. */
+    readonly waterId: string;
+    readonly planeY: number;
+    /** Approximate water surface half-extent (m) — drives the coverage skip. */
+    readonly extent: number;
+    readonly layers: readonly string[];
+}
+export interface ReflectionPlan {
+    readonly mirrorViewProjection: Float32Array;
+    /** Mirror camera eye — CDLOD selects against this during the re-draw. */
+    readonly mirrorEye: readonly [number, number, number];
+    readonly coverage: number;
+    /** Pass runs only when this is true (§9.1: < 2 % coverage skips). */
+    readonly run: boolean;
+}
+/**
+ * Mirror-camera + oblique-clip plan for one frame. Coverage is the ratio of
+ * the water plane's projected half-extent to the frustum's far-plane half
+ * width — a cheap upper bound; the spec's skip is about the water being a
+ * trivial fraction of the frame.
+ */
+export declare function planReflection(ctx: FrameContributorContext, request: ReflectionRequest): ReflectionPlan | null;
+/**
+ * The `background` phase pass (order −10 relative to world opaque). Executes
+ * `renderWorld` — supplied by `WaterRuntime`, which re-draws the
+ * `reflectionLayers`-tagged items through the mirror matrices — into the
+ * half-res target and publishes it on the blackboard for the water pass.
+ */
+export declare function reflectionViewPass(ctx: FrameContributorContext, request: ReflectionRequest, renderWorld: (device: RenderDevice, mirrorViewProjection: Float32Array, mirrorEye: readonly [number, number, number]) => void): RenderPass;
+//# sourceMappingURL=ReflectionViewPass.d.ts.map

package/dist/rendering/world/water/ReflectionViewPass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReflectionViewPass.d.ts","sourceRoot":"","sources":["../../../../../../packages/rendering/src/world/water/ReflectionViewPass.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,YAAY,EAAqC,MAAM,uBAAuB,CAAC;AAC7F,OAAO,KAAK,EAAE,UAAU,EAAqB,MAAM,qBAAqB,CAAC;AACzE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAU7E,eAAO,MAAM,qBAAqB,2BAA2B,CAAC;AAE9D,MAAM,WAAW,iBAAiB;IAChC,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,oBAAoB,EAAE,YAAY,CAAC;IAC5C,yEAAyE;IACzE,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACtD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,qEAAqE;IACrE,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CACvB;AAID;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,uBAAuB,EAAE,OAAO,EAAE,iBAAiB,GAAG,cAAc,GAAG,IAAI,CAqB9G;AAkBD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,uBAAuB,EAC5B,OAAO,EAAE,iBAAiB,EAC1B,WAAW,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,GAC5H,UAAU,CAmCZ"}

package/dist/rendering/world/water/ReflectionViewPass.js

@@ -0,0 +1,85 @@
+import { computeObliqueClipProjection, computePlanarMirrorCamera, computePlanarViewMatrix, multiplyPlanarMatrices } from "../../PlanarReflection.js";
+export const PLANAR_REFLECTION_KEY = "prd10.water.reflection";
+const MIN_COVERAGE = 0.02;
+/**
+ * Mirror-camera + oblique-clip plan for one frame. Coverage is the ratio of
+ * the water plane's projected half-extent to the frustum's far-plane half
+ * width — a cheap upper bound; the spec's skip is about the water being a
+ * trivial fraction of the frame.
+ */
+export function planReflection(ctx, request) {
+    const camera = ctx.camera;
+    if (!camera)
+        return null;
+    const eye = [camera.position[0], camera.position[1], camera.position[2]];
+    // Camera basis: view matrix inverse columns give right/up/forward; the look
+    // target sits one unit along forward (view-space -z).
+    const v = camera.viewMatrix;
+    const fwd = [-v[2], -v[6], -v[10]];
+    const up = [v[1], v[5], v[9]];
+    const target = [eye[0] + fwd[0], eye[1] + fwd[1], eye[2] + fwd[2]];
+    const mirror = computePlanarMirrorCamera(eye, target, up, request.planeY);
+    const oblique = computeObliqueClipProjection(camera.projectionMatrix, mirror.clipPlane, 0);
+    const view = computePlanarViewMatrix(mirror.eye, mirror.target, mirror.up);
+    const mirrorViewProjection = multiplyPlanarMatrices(Float32Array.from(oblique.projectionMatrix), view);
+    // Screen-space coverage proxy: water half-extent over view half-extent at the
+    // plane's distance along the camera forward axis.
+    const dist = Math.max(1, Math.abs(eye[1] - request.planeY));
+    const tanHalfFov = 1 / Math.max(0.05, Math.abs(camera.projectionMatrix[5] ?? 1));
+    const viewHalf = dist * tanHalfFov;
+    const coverage = Math.min(1, request.extent / Math.max(viewHalf, 0.01));
+    return { mirrorViewProjection, mirrorEye: mirror.eye, coverage, run: coverage >= MIN_COVERAGE };
+}
+const states = new WeakMap();
+function stateFor(device) {
+    let s = states.get(device);
+    if (!s) {
+        s = { target: null, programCache: new Map() };
+        states.set(device, s);
+    }
+    return s;
+}
+/**
+ * The `background` phase pass (order −10 relative to world opaque). Executes
+ * `renderWorld` — supplied by `WaterRuntime`, which re-draws the
+ * `reflectionLayers`-tagged items through the mirror matrices — into the
+ * half-res target and publishes it on the blackboard for the water pass.
+ */
+export function reflectionViewPass(ctx, request, renderWorld) {
+    return {
+        name: `prd10.reflection.${request.waterId}`,
+        reads: [],
+        writes: [PLANAR_REFLECTION_KEY],
+        execute(rp) {
+            const device = rp.device;
+            const plan = planReflection(ctx, request);
+            if (!plan || !plan.run) {
+                ctx.blackboard.delete(PLANAR_REFLECTION_KEY);
+                return;
+            }
+            const s = stateFor(device);
+            const w = Math.max(1, (rp.width / 2) | 0);
+            const h = Math.max(1, (rp.height / 2) | 0);
+            const t = s.target;
+            if (!t || t.width !== w || t.height !== h) {
+                s.target?.dispose();
+                s.target = device.createRenderTarget({
+                    width: w, height: h,
+                    label: PLANAR_REFLECTION_KEY,
+                    format: "rgba16f",
+                    depth: "renderbuffer",
+                    sampleCount: 1
+                });
+            }
+            const target = s.target;
+            if (!target)
+                return;
+            device.setRenderTarget(target);
+            device.clear([0, 0, 0, 1]);
+            renderWorld(device, plan.mirrorViewProjection, plan.mirrorEye);
+            device.setRenderTarget(null);
+            ctx.blackboard.set(PLANAR_REFLECTION_KEY, target.colorTexture);
+        }
+    };
+}
+//# sourceMappingURL=ReflectionViewPass.js.map

package/dist/rendering/world/water/ReflectionViewPass.js.map

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

package/dist/rendering/world/water/SceneCopyFallback.d.ts

@@ -0,0 +1,21 @@
+import type { RenderPass } from "../../RenderPass.js";
+import type { Texture } from "../../Texture.js";
+import { type FrameContributorContext } from "../../contracts/frameGraph.js";
+export declare const SCENE_COPY_COLOR_KEY = "prd10.scene.color.copy";
+export declare const SCENE_COPY_DEPTH_KEY = "prd10.scene.depth.copy";
+/** Textures the water shader binds; null when this frame had no copy. */
+export interface SceneCopyResult {
+    readonly color: Texture | null;
+    readonly depth: Texture | null;
+    /** True when the shared FRAME_RESOURCES copies exist (published elsewhere). */
+    readonly shared: boolean;
+}
+/** Resolve the scene copies the water pass should bind this frame. */
+export declare function sceneCopyTextures(ctx: FrameContributorContext): SceneCopyResult;
+/**
+ * The `after-opaque` pass. Reads the live scene color/depth when the device
+ * exposes them (`ctx.sceneDepth.texture`, blackboard `aura.scene.color`),
+ * draws the fullscreen copies, and publishes them under `prd10.scene.*`.
+ */
+export declare function sceneCopyFallbackPass(ctx: FrameContributorContext): RenderPass;
+//# sourceMappingURL=SceneCopyFallback.d.ts.map

package/dist/rendering/world/water/SceneCopyFallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneCopyFallback.d.ts","sourceRoot":"","sources":["../../../../../../packages/rendering/src/world/water/SceneCopyFallback.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,UAAU,EAAqB,MAAM,qBAAqB,CAAC;AAKzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAmB,KAAK,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAE9F,eAAO,MAAM,oBAAoB,2BAA2B,CAAC;AAC7D,eAAO,MAAM,oBAAoB,2BAA2B,CAAC;AA2D7D,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/B,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,uBAAuB,GAAG,eAAe,CAS/E;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,uBAAuB,GAAG,UAAU,CA8E9E"}