@yali-engine/water 0.0.0-stage → 0.11.0

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { cascadeBands, donelanBanner, h0Table, jonswap, jonswapPeak, type SeaState, significantHeight } from './spectrum.ts';
+export { water, Water, type WaterOptions } from './water.ts';
+export { WaterWaves, type WaterWavesOptions } from './waves.ts';

package/dist/index.js

@@ -0,0 +1,5 @@
+// `@yali-engine/water` (ADR-0198, docs/research/water.md): an ocean's FFT cascades and its surface, as a render feature.
+export { cascadeBands, donelanBanner, h0Table, jonswap, jonswapPeak, significantHeight } from "./spectrum.js";
+export { water, Water } from "./water.js";
+export { WaterWaves } from "./waves.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yHAAyH;AACzH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAiB,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC7H,OAAO,EAAE,KAAK,EAAE,KAAK,EAAqB,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,UAAU,EAA0B,MAAM,YAAY,CAAC"}

package/dist/spectrum.d.ts

@@ -0,0 +1,35 @@
+/** The sea a spectrum describes. */
+export interface SeaState {
+    /** Wind speed 10 m above the water, m/s (default 10). */
+    readonly wind?: number;
+    /** The direction the wind blows towards, radians from +x towards +z (default 0). */
+    readonly direction?: number;
+    /** Fetch: how far the wind has blown over open water, metres (default 100 km). */
+    readonly fetch?: number;
+    /** JONSWAP's peak enhancement γ (default 3.3). */
+    readonly gamma?: number;
+    /** The generator's seed (default 1). */
+    readonly seed?: number;
+}
+/** JONSWAP's peak angular frequency (rad/s) and Phillips constant for a wind and fetch. */
+export declare function jonswapPeak(wind: number, fetch: number): {
+    omega: number;
+    alpha: number;
+};
+/** JONSWAP's spectral density at angular frequency ω, m²·s. */
+export declare function jonswap(omega: number, peak: {
+    omega: number;
+    alpha: number;
+}, gamma?: number): number;
+/** Donelan–Banner spreading at angle θ from the wind for ω / ωp; integrates to 1 over θ ∈ (−π, π]. */
+export declare function donelanBanner(theta: number, ratio: number): number;
+/** A cascade's band of wavenumber magnitudes, rad/m: [lo, hi). */
+export declare function cascadeBands(sizes: readonly number[], n: number): [number, number][];
+/**
+ * One cascade's h0 table, `n × n` texels of four floats: h0(k) and conj(h0(−k)) (what `evolve` reads), k on the grid
+ * centred on n / 2, zero outside the band. E|h0(k)|² is half the directional spectrum times the grid cell's area in
+ * wavenumber, so the heights' variance (h(k) holds h0(k) and h0(−k)) is the band's share of the sea's m0.
+ */
+export declare function h0Table(n: number, size: number, band: readonly [number, number], sea?: SeaState, cascade?: number): Float32Array<ArrayBuffer>;
+/** The sea's significant wave height (4 √m0, m) from JONSWAP integrated over frequency: what the cascades together carry. */
+export declare function significantHeight(sea?: SeaState): number;

package/dist/spectrum.js

@@ -0,0 +1,112 @@
+// The ocean's spectrum on the CPU (ADR-0198, docs/research/water.md §4): JONSWAP for a fetch-limited sea (Hasselmann et al.
+// 1973) with Donelan–Banner directional spreading (Donelan, Hamilton and Hui 1985), in deep water (ω² = g k), sampled on
+// each cascade's grid of wavenumbers, its band only (the cascades' bands are disjoint, so no wave is counted twice), and
+// drawn as Tessendorf's h0: a complex Gaussian with the spectrum's variance, from a seeded generator (the same seed, the same
+// sea on every machine).
+const G = 9.81;
+/** JONSWAP's peak angular frequency (rad/s) and Phillips constant for a wind and fetch. */
+export function jonswapPeak(wind, fetch) {
+    const x = (G * fetch) / (wind * wind);
+    return { omega: 22 * (G / wind) * Math.pow(x, -1 / 3), alpha: 0.076 * Math.pow(x, -0.22) };
+}
+/** JONSWAP's spectral density at angular frequency ω, m²·s. */
+export function jonswap(omega, peak, gamma = 3.3) {
+    if (omega <= 0)
+        return 0;
+    const wp = peak.omega;
+    const sigma = omega <= wp ? 0.07 : 0.09;
+    const r = Math.exp(-((omega - wp) ** 2) / (2 * sigma * sigma * wp * wp));
+    return ((peak.alpha * G * G) / omega ** 5) * Math.exp(-1.25 * (wp / omega) ** 4) * Math.pow(gamma, r);
+}
+/** Donelan–Banner spreading at angle θ from the wind for ω / ωp; integrates to 1 over θ ∈ (−π, π]. */
+export function donelanBanner(theta, ratio) {
+    const beta = ratio < 0.95 ? 2.61 * ratio ** 1.3 : ratio < 1.6 ? 2.28 * ratio ** -1.3 : 10 ** (-0.4 + 0.8393 * Math.exp(-0.567 * Math.log(ratio * ratio)));
+    const c = Math.cosh(beta * theta);
+    return beta / (2 * Math.tanh(beta * Math.PI)) / (c * c);
+}
+/** A cascade's band of wavenumber magnitudes, rad/m: [lo, hi). */
+export function cascadeBands(sizes, n) {
+    // Each cascade starts at 4 of its tile's fundamentals (its longest waves would tile visibly); the one before ends there.
+    const lo = sizes.map((l, i) => (i === 0 ? 0 : (4 * 2 * Math.PI) / l));
+    return sizes.map((l, i) => [lo[i], i + 1 < sizes.length ? lo[i + 1] : (Math.PI * n) / l * Math.SQRT2]);
+}
+/** A seeded uniform generator (mulberry32). */
+function uniform(seed) {
+    let s = seed >>> 0;
+    return () => {
+        s = (s + 0x6d2b79f5) >>> 0;
+        let t = s;
+        t = Math.imul(t ^ (t >>> 15), t | 1);
+        t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+/**
+ * One cascade's h0 table, `n × n` texels of four floats: h0(k) and conj(h0(−k)) (what `evolve` reads), k on the grid
+ * centred on n / 2, zero outside the band. E|h0(k)|² is half the directional spectrum times the grid cell's area in
+ * wavenumber, so the heights' variance (h(k) holds h0(k) and h0(−k)) is the band's share of the sea's m0.
+ */
+export function h0Table(n, size, band, sea = {}, cascade = 0) {
+    const wind = sea.wind ?? 10;
+    const dir = sea.direction ?? 0;
+    const peak = jonswapPeak(wind, sea.fetch ?? 100_000);
+    const gamma = sea.gamma ?? 3.3;
+    const dk = (2 * Math.PI) / size;
+    const rand = uniform(((sea.seed ?? 1) * 0x9e3779b1 + cascade * 0x85ebca6b) >>> 0);
+    // Two Gaussians per texel (Box–Muller), drawn for every texel in order: the table is the same for the same seed.
+    const xi = new Float32Array(n * n * 2);
+    for (let i = 0; i < n * n; i++) {
+        const u1 = Math.max(rand(), 1e-12);
+        const u2 = rand();
+        const r = Math.sqrt(-2 * Math.log(u1));
+        xi[i * 2] = r * Math.cos(2 * Math.PI * u2);
+        xi[i * 2 + 1] = r * Math.sin(2 * Math.PI * u2);
+    }
+    const amp = new Float32Array(n * n);
+    for (let z = 0; z < n; z++) {
+        for (let x = 0; x < n; x++) {
+            const kx = (x - n / 2) * dk;
+            const kz = (z - n / 2) * dk;
+            const k = Math.hypot(kx, kz);
+            // The Nyquist row and column (index 0: −n/2) have no mirror on the grid: their h(k) is not Hermitian, and two real
+            // fields packed in one complex FFT would leak into each other there. Left empty.
+            if (x === 0 || z === 0 || k < band[0] || k >= band[1] || k === 0)
+                continue;
+            const omega = Math.sqrt(G * k);
+            // S(k) = S(ω) D(θ) dω/dk / k (polar to Cartesian), dω/dk = g / (2ω) in deep water.
+            let theta = Math.atan2(kz, kx) - dir;
+            theta = Math.atan2(Math.sin(theta), Math.cos(theta));
+            const s = (jonswap(omega, peak, gamma) * donelanBanner(theta, omega / peak.omega) * (G / (2 * omega))) / k;
+            // h(k) = h0(k) + conj(h0(−k)) carries the variance of both: each half of S Δk².
+            amp[z * n + x] = Math.sqrt((s * dk * dk) / 2);
+        }
+    }
+    const out = new Float32Array(n * n * 4);
+    for (let z = 0; z < n; z++) {
+        for (let x = 0; x < n; x++) {
+            const i = z * n + x;
+            // −k on the grid: (n − x, n − z) mod n about the centre.
+            const j = ((n - z) % n) * n + ((n - x) % n);
+            const a = amp[i] / Math.SQRT2;
+            const b = amp[j] / Math.SQRT2;
+            out[i * 4] = a * xi[i * 2];
+            out[i * 4 + 1] = a * xi[i * 2 + 1];
+            out[i * 4 + 2] = b * xi[j * 2];
+            out[i * 4 + 3] = -b * xi[j * 2 + 1];
+        }
+    }
+    return out;
+}
+/** The sea's significant wave height (4 √m0, m) from JONSWAP integrated over frequency: what the cascades together carry. */
+export function significantHeight(sea = {}) {
+    const peak = jonswapPeak(sea.wind ?? 10, sea.fetch ?? 100_000);
+    let m0 = 0;
+    const steps = 20000;
+    const top = peak.omega * 20;
+    for (let i = 1; i <= steps; i++) {
+        const w = (i - 0.5) * (top / steps);
+        m0 += jonswap(w, peak, sea.gamma ?? 3.3) * (top / steps);
+    }
+    return 4 * Math.sqrt(m0);
+}
+//# sourceMappingURL=spectrum.js.map

package/dist/spectrum.js.map

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

package/dist/water-shaders.gen.d.ts

@@ -0,0 +1,10 @@
+/** Linked from shaders/water/waves.wesl. */
+export declare const waterWaves: {
+    readonly hash: "851c72a24f5654c5";
+    readonly wgsl: "override N: u32 = 128u;\noverride HALF: u32 = 64u;\nconst PI = 3.14159265358979;\nconst G = 9.81;\nstruct WaveParams {\nt: vec4f,\nv: vec4u,\n}\n@group(0) @binding(0) var<storage, read> h0: array<vec4f>;\n@group(0) @binding(1) var<storage, read_write> a: array<vec2f>;\n@group(0) @binding(2) var<storage, read_write> b: array<vec2f>;\n@group(0) @binding(3) var<uniform> wp: WaveParams;\n@group(0) @binding(4) var displacement: texture_storage_2d_array<rgba16float, write>;\n@group(0) @binding(5) var slopes: texture_storage_2d_array<rgba16float, write>;\nfn cmul(x: vec2f, y: vec2f) -> vec2f {\nreturn vec2f(x.x * y.x - x.y * y.y, x.x * y.y + x.y * y.x);\n}\nfn ci(x: vec2f) -> vec2f {\nreturn vec2f(-x.y, x.x);\n}\n@compute @workgroup_size(8, 8) fn evolve(@builtin(global_invocation_id) id: vec3u) {\nif (id.x >= N || id.y >= N) {\nreturn;\n}\nlet i = id.y * N + id.x;\nlet size = wp.t.y;\nlet kx = 2.0 * PI * (f32(id.x) - f32(HALF)) / size;\nlet kz = 2.0 * PI * (f32(id.y) - f32(HALF)) / size;\nlet kl = sqrt(kx * kx + kz * kz);\nlet inv = select(0.0, 1.0 / kl, kl > 1e-6);\nlet w = sqrt(G * kl);\nlet e = vec2f(cos(w * wp.t.x), sin(w * wp.t.x));\nlet s = h0[i];\nlet h = cmul(s.xy, e) + cmul(s.zw, vec2f(e.x, -e.y));\nlet dx = -ci(h) * (kx * inv);\nlet dz = -ci(h) * (kz * inv);\nlet sx = ci(h) * kx;\nlet sz = ci(h) * kz;\nlet dxx = h * (kx * kx * inv);\nlet dzz = h * (kz * kz * inv);\nlet dxz = h * (kx * kz * inv);\nlet nn = N * N;\na[i] = h + ci(dx);\na[nn + i] = dz + ci(sx);\na[2u * nn + i] = sz + ci(dxx);\na[3u * nn + i] = dzz + ci(dxz);\n}\nvar<workgroup> line: array<vec2f, 2u * N>;\n@compute @workgroup_size(HALF) fn fft(@builtin(workgroup_id) wg: vec3u, @builtin(local_invocation_index) t: u32) {\nlet field = wg.y * N * N;\nlet l = wg.x;\nlet rows = wp.v.x == 0u;\nlet i0 = select(t * N + l, l * N + t, rows) + field;\nlet i1 = select((t + HALF) * N + l, l * N + t + HALF, rows) + field;\nif (rows) {\nline[t] = a[i0];\nline[t + HALF] = a[i1];\n} else {\nline[t] = b[i0];\nline[t + HALF] = b[i1];\n}\nworkgroupBarrier();\nvar src = 0u;\nfor (var q = 1u; q < N; q <<= 1u) {\nlet k = t & (q - 1u);\nlet x = line[src * N + t];\nlet y = line[src * N + t + HALF];\nlet ang = PI * f32(k) / f32(q);\nlet yw = cmul(y, vec2f(cos(ang), sin(ang)));\nlet j = ((t - k) << 1u) + k;\nline[(1u - src) * N + j] = x + yw;\nline[(1u - src) * N + j + q] = x - yw;\nsrc = 1u - src;\nworkgroupBarrier();\n}\nif (rows) {\nb[i0] = line[src * N + t];\nb[i1] = line[src * N + t + HALF];\n} else {\na[i0] = line[src * N + t];\na[i1] = line[src * N + t + HALF];\n}\n}\n@compute @workgroup_size(8, 8) fn pack(@builtin(global_invocation_id) id: vec3u) {\nif (id.x >= N || id.y >= N) {\nreturn;\n}\nlet i = id.y * N + id.x;\nlet nn = N * N;\nlet sign = select(1.0, -1.0, ((id.x + id.y) & 1u) == 1u);\nlet f0 = a[i] * sign;\nlet f1 = a[nn + i] * sign;\nlet f2 = a[2u * nn + i] * sign;\nlet f3 = a[3u * nn + i] * sign;\nlet lambda = wp.t.z;\nlet h = f0.x;\nlet dx = f0.y * lambda;\nlet dz = f1.x * lambda;\nlet jx = 1.0 + lambda * f2.y;\nlet jz = 1.0 + lambda * f3.x;\nlet jxz = lambda * f3.y;\nlet det = jx * jz - jxz * jxz;\nlet layer = i32(wp.v.y);\ntextureStore(displacement, vec2i(id.xy), layer, vec4f(dx, h, dz, det));\ntextureStore(slopes, vec2i(id.xy), layer, vec4f(f1.y, f2.x, det, 0.0));\n}";
+};
+/** Linked from shaders/water/surface.wesl. */
+export declare const waterSurface: {
+    readonly hash: "b15f2cb4cff18a4e";
+    readonly wgsl: "const PI = 3.14159265;\nconst EARTH_RADIUS = 6371000.0;\nconst MAX_CASCADES = 4u;\nstruct SurfaceParams {\ncascade: array<vec4f, MAX_CASCADES>,\ngrid: vec4f,\nsea: vec4f,\nbody: vec4f,\nsss: vec4f,\nsize: vec4f,\noptics: vec4f,\nshore: vec4f,\nmirror: vec4f,\n}\n@group(0) @binding(0) var<uniform> camera: Camera;\n@group(0) @binding(1) var<uniform> lighting: Lighting;\n@group(0) @binding(2) var<uniform> sp: SurfaceParams;\n@group(0) @binding(3) var displacement: texture_2d_array<f32>;\n@group(0) @binding(4) var slopes: texture_2d_array<f32>;\n@group(0) @binding(5) var wrap: sampler;\n@group(0) @binding(6) var env_cube: texture_cube<f32>;\n@group(0) @binding(7) var under: texture_2d<f32>;\n@group(0) @binding(8) var under_depth: texture_2d<f32>;\n@group(0) @binding(9) var clamp_smp: sampler;\n@group(0) @binding(10) var scene_depth: texture_depth_2d;\n@group(0) @binding(11) var depth_out: texture_storage_2d<r32float, write>;\nstruct VsOut {\n@builtin(position) clip: vec4f,\n@location(0) p: vec3f,\n@location(1) rest: vec2f,\n@location(2) height: f32,\n}\nfn ring_radius(i: f32) -> f32 {\nlet k = sp.grid.y;\nreturn sp.grid.x * (pow(1.0 + k, i) - 1.0) / k;\n}\n@vertex fn vs(@builtin(vertex_index) vi: u32) -> VsOut {\nlet segs = u32(sp.grid.w);\nlet quad = vi / 6u;\nlet corner = vi % 6u;\nlet dr = select(select(0u, 1u, corner == 1u || corner == 2u || corner == 4u), 0u, corner == 0u || corner == 3u);\nlet ds = select(0u, 1u, corner == 2u || corner == 4u || corner == 5u);\nlet ring = f32(quad / segs + dr);\nlet seg = f32(quad % segs + ds);\nlet r = ring_radius(ring);\nlet a = 2.0 * PI * seg / f32(segs);\nlet rest = vec2f(cos(a), sin(a)) * r;\nlet spacing = max(ring_radius(ring + 1.0) - r, 2.0 * PI * r / f32(segs));\nvar d = vec3f(0.0);\nfor (var c = 0u; c < u32(sp.sea.y); c++) {\nlet cc = sp.cascade[c];\nlet texel = 1.0 / (cc.z * sp.size.x);\nlet w = 1.0 - smoothstep(1.0, 4.0, spacing / texel);\nif (w <= 0.0) {\ncontinue;\n}\nd += textureSampleLevel(displacement, wrap, cc.xy + rest * cc.z, c, 0.0).xyz * w;\n}\nlet drop = dot(rest, rest) / (2.0 * EARTH_RADIUS);\nlet p = vec3f(rest.x + d.x, sp.sea.x + d.y - drop, rest.y + d.z);\nvar o: VsOut;\no.clip = camera.view_proj * vec4f(p, 1.0);\no.p = p;\no.rest = rest;\no.height = d.y;\nreturn o;\n}\nfn sh_irradiance(n: vec3f) -> vec3f {\nreturn max(lighting.sh[0].rgb * 0.282095 + lighting.sh[1].rgb * (0.488603 * n.y) + lighting.sh[2].rgb * (0.488603 * n.z) + lighting.sh[3].rgb * (0.488603 * n.x) + lighting.sh[4].rgb * (1.092548 * n.x * n.y) + lighting.sh[5].rgb * (1.092548 * n.y * n.z) + lighting.sh[6].rgb * (0.315392 * (3.0 * n.z * n.z - 1.0)) + lighting.sh[7].rgb * (1.092548 * n.x * n.z) + lighting.sh[8].rgb * (0.546274 * (n.x * n.x - n.y * n.y)), vec3f(0.0));\n}\n@compute @workgroup_size(8, 8) fn copy_depth(@builtin(global_invocation_id) id: vec3u) {\nlet size = textureDimensions(scene_depth);\nif (id.x >= size.x || id.y >= size.y) {\nreturn;\n}\ntextureStore(depth_out, vec2i(id.xy), vec4f(textureLoad(scene_depth, vec2i(id.xy), 0), 0.0, 0.0, 0.0));\n}\nfn thickness(dist: f32, ds: f32, dop: f32) -> f32 {\nreturn select(1.0e9, dist * max(ds / dop - 1.0, 0.0), dop > 0.0);\n}\nfn mirror_scene(p: vec3f, r: vec3f, size: vec2f) -> vec4f {\nlet len = sp.mirror.x;\nlet steps = u32(sp.mirror.y);\nif (len <= 0.0 || steps == 0u || sp.shore.y < 0.5 || r.y <= 0.0) {\nreturn vec4f(0.0);\n}\nfor (var i = 1u; i <= steps; i++) {\nlet f = f32(i) / f32(steps);\nlet q = p + r * (len * f * f);\nlet c = camera.view_proj * vec4f(q, 1.0);\nif (c.w <= 0.0) {\nbreak;\n}\nlet ndc = c.xyz / c.w;\nlet uv = vec2f(ndc.x * 0.5 + 0.5, 0.5 - ndc.y * 0.5);\nif (any(uv < vec2f(0.0)) || any(uv > vec2f(1.0))) {\nbreak;\n}\nlet d = textureLoad(under_depth, vec2i(uv * size), 0).x;\nif (d > ndc.z && d > 0.0) {\nlet gap = c.w * (1.0 - ndc.z / d);\nif (gap < sp.mirror.z + 0.03 * c.w) {\nlet edge = min(min(uv.x, 1.0 - uv.x), min(uv.y, 1.0 - uv.y));\nlet fade = saturate(edge * 12.0) * (1.0 - f * f);\nreturn vec4f(textureSampleLevel(under, clamp_smp, uv, 0.0).rgb * sp.shore.z, fade);\n}\n}\n}\nreturn vec4f(0.0);\n}\n@fragment fn fs(in: VsOut) -> @location(0) vec4f {\nlet frag = in.clip;\nvar sx = 0.0;\nvar sz = 0.0;\nvar lost = 0.0;\nvar fold = 0.0;\nfor (var c = 0u; c < u32(sp.sea.y); c++) {\nlet cc = sp.cascade[c];\nlet uv = cc.xy + in.rest * cc.z;\nlet texels = length(fwidth(uv)) * sp.size.x;\nlet w = 1.0 - smoothstep(0.5, 2.0, texels);\nlet s = textureSampleLevel(slopes, wrap, uv, c, 0.0);\nsx += s.x * w;\nsz += s.y * w;\nlost += cc.w * (1.0 - w);\nfold = max(fold, saturate((sp.sea.z - s.z) * 2.0) * w);\n}\nlet n = normalize(vec3f(-sx, 1.0, -sz));\nlet v = normalize(-in.p);\nlet l = camera.light_dir.xyz;\nlet nv = max(dot(n, v), 1e-3);\nlet nl = max(dot(n, l), 0.0);\nlet a2 = max(sp.body.w * sp.body.w + 2.0 * lost, 1e-4);\nlet f0 = 0.02;\nlet fresnel = f0 + (1.0 - f0) * pow(1.0 - nv, 5.0);\nvar r = reflect(-v, n);\nr.y = abs(r.y);\nlet lod = clamp(sqrt(sqrt(a2)) * (lighting.env.x - 1.0), 0.0, lighting.env.x - 1.0);\nvar sky = textureSampleLevel(env_cube, wrap, r, lod).rgb * lighting.view.rgb;\nlet seen = mirror_scene(in.p, reflect(-v, n), vec2f(textureDimensions(under)));\nsky = mix(sky, seen.rgb, seen.a);\nif (sp.mirror.w > 0.5) {\nreturn vec4f(select(vec3f(seen.a * 0.2, 0.0, 0.0) + seen.rgb * seen.a, vec3f(0.3, 0.0, 0.0), seen.a <= 0.0) * lighting.env.z, 1.0);\n}\nlet h = normalize(v + l);\nlet nh = max(dot(n, h), 0.0);\nlet dd = nh * nh * (a2 - 1.0) + 1.0;\nlet ggx = a2 / (PI * dd * dd);\nlet vis = 0.5 / (nl * sqrt(nv * nv * (1.0 - a2) + a2) + nv * sqrt(nl * nl * (1.0 - a2) + a2) + 1e-5);\nlet fh = f0 + (1.0 - f0) * pow(1.0 - max(dot(v, h), 0.0), 5.0);\nlet sun = lighting.sun_color.rgb;\nlet spec = sun * (ggx * vis * fh * nl);\nlet up = sh_irradiance(vec3f(0.0, 1.0, 0.0));\nlet body = sp.body.rgb * (up + sun * (max(l.y, 0.0) / PI) * 0.5);\nlet behind = pow(saturate(dot(-v, l)), 8.0);\nlet crest = saturate(in.height * 0.5) * saturate(1.0 - n.y * 0.9 + 0.2);\nlet sss = sp.sss.rgb * sun * (behind * crest * sp.sss.w);\nvar below = body;\nvar shore_foam = 0.0;\nif (sp.shore.y > 0.5) {\nlet px = vec2i(frag.xy);\nlet size = vec2f(textureDimensions(under));\nlet dist = length(in.p);\nlet t0 = thickness(dist, frag.z, textureLoad(under_depth, px, 0).x);\nlet bend = n.xz * sp.optics.w * min(t0, 1.0);\nvar uv = (frag.xy + bend) / size;\nvar t = thickness(dist, frag.z, textureLoad(under_depth, vec2i(uv * size), 0).x);\nif (textureLoad(under_depth, vec2i(uv * size), 0).x > frag.z) {\nuv = frag.xy / size;\nt = t0;\n}\nlet behind_light = textureSampleLevel(under, clamp_smp, uv, 0.0).rgb * sp.shore.z;\nlet trans = exp(-sp.optics.rgb * t);\nbelow = behind_light * trans + body * (vec3f(1.0) - trans);\nlet ripple = textureSampleLevel(displacement, wrap, sp.cascade[u32(sp.sea.y) - 1u].xy + in.rest * sp.cascade[u32(sp.sea.y) - 1u].z, u32(sp.sea.y) - 1u, 0.0).y;\nshore_foam = saturate((1.0 - t0 / sp.shore.x) * 1.4 + ripple * 2.0) * saturate(t0 * 8.0);\n}\nlet water = sky * fresnel + (below + sss) * (1.0 - fresnel) + spec;\nlet foam_light = (sh_irradiance(n) + sun * (nl / PI)) * 0.85;\nlet foam = saturate(fold * sp.sea.w + shore_foam);\nlet lit = mix(water, foam_light, foam);\nlet fogged = apply_fog(lit, in.p, lighting.fog, lighting.fog2, lighting.fog_air.rgb, sh_irradiance(normalize(in.p)), sun, l);\nreturn vec4f(fogged * lighting.env.z, 1.0);\n}\nstruct Camera {\nview_proj: mat4x4f,\nfrustum: array<vec4f, 6>,\nlight_dir: vec4f,\norigin: vec4f,\n}\nstruct Lighting {\nsun_color: vec4f,\nenv: vec4f,\nsh: array<vec4f, 9>,\nscreen: vec4f,\nview: vec4f,\nao_reproject: mat4x4f,\nao: vec4f,\nfog: vec4f,\nfog2: vec4f,\nfog_air: vec4f,\ngi_grid: vec4f,\ngi_counts: vec4f,\nssr: vec4f,\ngi_cascades: array<vec4f, 3>,\n}\nfn apply_fog(color: vec3f, p: vec3f, fog: vec4f, fog2: vec4f, air: vec3f, ambient: vec3f, sun: vec3f, sun_dir: vec3f) -> vec3f {\nlet dist = length(p);\nif (dist <= 0.0 || (fog.x <= 0.0 && fog2.x <= 0.0)) {\nreturn color;\n}\nlet dir = p / dist;\nlet t = exp(-(air * (fog2.x * dist) + vec3f(height_fog_depth(fog, dir, dist))));\nreturn color * t + fog_inscatter(fog2, dir, ambient, sun, sun_dir) * (vec3f(1.0) - t);\n}\nfn height_fog_depth(fog: vec4f, dir: vec3f, dist: f32) -> f32 {\nif (fog.x <= 0.0) {\nreturn 0.0;\n}\nlet falloff = max(fog.y, 1e-5);\nlet len = max(dist - fog.w, 0.0);\nlet h0 = fog.z + dir.y * min(dist, fog.w);\nlet k = falloff * dir.y * len;\nlet shape = select((1.0 - exp(-k)) / k, 1.0 - 0.5 * k, abs(k) < 1e-3);\nreturn fog.x * exp(-falloff * h0) * len * shape;\n}\nfn fog_inscatter(fog2: vec4f, dir: vec3f, ambient: vec3f, sun: vec3f, sun_dir: vec3f) -> vec3f {\nlet g = fog2.z;\nlet c = dot(dir, sun_dir);\nlet phase = (1.0 - g * g) / (FOUR_PI * pow(max(1.0 + g * g - 2.0 * g * c, 1e-4), 1.5));\nreturn ambient + sun * (phase * fog2.y);\n}\nconst FOUR_PI = 12.5663706;";
+};

package/dist/water-shaders.gen.js

@@ -0,0 +1,13 @@
+// GENERATED by tools/shaders-gen.mjs from shaders/**/*.wesl. Do not edit.
+// Regenerate with `node tools/shaders-gen.mjs`; CI runs it with --check.
+/** Linked from shaders/water/waves.wesl. */
+export const waterWaves = {
+    hash: '851c72a24f5654c5',
+    wgsl: "override N: u32 = 128u;\noverride HALF: u32 = 64u;\nconst PI = 3.14159265358979;\nconst G = 9.81;\nstruct WaveParams {\nt: vec4f,\nv: vec4u,\n}\n@group(0) @binding(0) var<storage, read> h0: array<vec4f>;\n@group(0) @binding(1) var<storage, read_write> a: array<vec2f>;\n@group(0) @binding(2) var<storage, read_write> b: array<vec2f>;\n@group(0) @binding(3) var<uniform> wp: WaveParams;\n@group(0) @binding(4) var displacement: texture_storage_2d_array<rgba16float, write>;\n@group(0) @binding(5) var slopes: texture_storage_2d_array<rgba16float, write>;\nfn cmul(x: vec2f, y: vec2f) -> vec2f {\nreturn vec2f(x.x * y.x - x.y * y.y, x.x * y.y + x.y * y.x);\n}\nfn ci(x: vec2f) -> vec2f {\nreturn vec2f(-x.y, x.x);\n}\n@compute @workgroup_size(8, 8) fn evolve(@builtin(global_invocation_id) id: vec3u) {\nif (id.x >= N || id.y >= N) {\nreturn;\n}\nlet i = id.y * N + id.x;\nlet size = wp.t.y;\nlet kx = 2.0 * PI * (f32(id.x) - f32(HALF)) / size;\nlet kz = 2.0 * PI * (f32(id.y) - f32(HALF)) / size;\nlet kl = sqrt(kx * kx + kz * kz);\nlet inv = select(0.0, 1.0 / kl, kl > 1e-6);\nlet w = sqrt(G * kl);\nlet e = vec2f(cos(w * wp.t.x), sin(w * wp.t.x));\nlet s = h0[i];\nlet h = cmul(s.xy, e) + cmul(s.zw, vec2f(e.x, -e.y));\nlet dx = -ci(h) * (kx * inv);\nlet dz = -ci(h) * (kz * inv);\nlet sx = ci(h) * kx;\nlet sz = ci(h) * kz;\nlet dxx = h * (kx * kx * inv);\nlet dzz = h * (kz * kz * inv);\nlet dxz = h * (kx * kz * inv);\nlet nn = N * N;\na[i] = h + ci(dx);\na[nn + i] = dz + ci(sx);\na[2u * nn + i] = sz + ci(dxx);\na[3u * nn + i] = dzz + ci(dxz);\n}\nvar<workgroup> line: array<vec2f, 2u * N>;\n@compute @workgroup_size(HALF) fn fft(@builtin(workgroup_id) wg: vec3u, @builtin(local_invocation_index) t: u32) {\nlet field = wg.y * N * N;\nlet l = wg.x;\nlet rows = wp.v.x == 0u;\nlet i0 = select(t * N + l, l * N + t, rows) + field;\nlet i1 = select((t + HALF) * N + l, l * N + t + HALF, rows) + field;\nif (rows) {\nline[t] = a[i0];\nline[t + HALF] = a[i1];\n} else {\nline[t] = b[i0];\nline[t + HALF] = b[i1];\n}\nworkgroupBarrier();\nvar src = 0u;\nfor (var q = 1u; q < N; q <<= 1u) {\nlet k = t & (q - 1u);\nlet x = line[src * N + t];\nlet y = line[src * N + t + HALF];\nlet ang = PI * f32(k) / f32(q);\nlet yw = cmul(y, vec2f(cos(ang), sin(ang)));\nlet j = ((t - k) << 1u) + k;\nline[(1u - src) * N + j] = x + yw;\nline[(1u - src) * N + j + q] = x - yw;\nsrc = 1u - src;\nworkgroupBarrier();\n}\nif (rows) {\nb[i0] = line[src * N + t];\nb[i1] = line[src * N + t + HALF];\n} else {\na[i0] = line[src * N + t];\na[i1] = line[src * N + t + HALF];\n}\n}\n@compute @workgroup_size(8, 8) fn pack(@builtin(global_invocation_id) id: vec3u) {\nif (id.x >= N || id.y >= N) {\nreturn;\n}\nlet i = id.y * N + id.x;\nlet nn = N * N;\nlet sign = select(1.0, -1.0, ((id.x + id.y) & 1u) == 1u);\nlet f0 = a[i] * sign;\nlet f1 = a[nn + i] * sign;\nlet f2 = a[2u * nn + i] * sign;\nlet f3 = a[3u * nn + i] * sign;\nlet lambda = wp.t.z;\nlet h = f0.x;\nlet dx = f0.y * lambda;\nlet dz = f1.x * lambda;\nlet jx = 1.0 + lambda * f2.y;\nlet jz = 1.0 + lambda * f3.x;\nlet jxz = lambda * f3.y;\nlet det = jx * jz - jxz * jxz;\nlet layer = i32(wp.v.y);\ntextureStore(displacement, vec2i(id.xy), layer, vec4f(dx, h, dz, det));\ntextureStore(slopes, vec2i(id.xy), layer, vec4f(f1.y, f2.x, det, 0.0));\n}",
+};
+/** Linked from shaders/water/surface.wesl. */
+export const waterSurface = {
+    hash: 'b15f2cb4cff18a4e',
+    wgsl: "const PI = 3.14159265;\nconst EARTH_RADIUS = 6371000.0;\nconst MAX_CASCADES = 4u;\nstruct SurfaceParams {\ncascade: array<vec4f, MAX_CASCADES>,\ngrid: vec4f,\nsea: vec4f,\nbody: vec4f,\nsss: vec4f,\nsize: vec4f,\noptics: vec4f,\nshore: vec4f,\nmirror: vec4f,\n}\n@group(0) @binding(0) var<uniform> camera: Camera;\n@group(0) @binding(1) var<uniform> lighting: Lighting;\n@group(0) @binding(2) var<uniform> sp: SurfaceParams;\n@group(0) @binding(3) var displacement: texture_2d_array<f32>;\n@group(0) @binding(4) var slopes: texture_2d_array<f32>;\n@group(0) @binding(5) var wrap: sampler;\n@group(0) @binding(6) var env_cube: texture_cube<f32>;\n@group(0) @binding(7) var under: texture_2d<f32>;\n@group(0) @binding(8) var under_depth: texture_2d<f32>;\n@group(0) @binding(9) var clamp_smp: sampler;\n@group(0) @binding(10) var scene_depth: texture_depth_2d;\n@group(0) @binding(11) var depth_out: texture_storage_2d<r32float, write>;\nstruct VsOut {\n@builtin(position) clip: vec4f,\n@location(0) p: vec3f,\n@location(1) rest: vec2f,\n@location(2) height: f32,\n}\nfn ring_radius(i: f32) -> f32 {\nlet k = sp.grid.y;\nreturn sp.grid.x * (pow(1.0 + k, i) - 1.0) / k;\n}\n@vertex fn vs(@builtin(vertex_index) vi: u32) -> VsOut {\nlet segs = u32(sp.grid.w);\nlet quad = vi / 6u;\nlet corner = vi % 6u;\nlet dr = select(select(0u, 1u, corner == 1u || corner == 2u || corner == 4u), 0u, corner == 0u || corner == 3u);\nlet ds = select(0u, 1u, corner == 2u || corner == 4u || corner == 5u);\nlet ring = f32(quad / segs + dr);\nlet seg = f32(quad % segs + ds);\nlet r = ring_radius(ring);\nlet a = 2.0 * PI * seg / f32(segs);\nlet rest = vec2f(cos(a), sin(a)) * r;\nlet spacing = max(ring_radius(ring + 1.0) - r, 2.0 * PI * r / f32(segs));\nvar d = vec3f(0.0);\nfor (var c = 0u; c < u32(sp.sea.y); c++) {\nlet cc = sp.cascade[c];\nlet texel = 1.0 / (cc.z * sp.size.x);\nlet w = 1.0 - smoothstep(1.0, 4.0, spacing / texel);\nif (w <= 0.0) {\ncontinue;\n}\nd += textureSampleLevel(displacement, wrap, cc.xy + rest * cc.z, c, 0.0).xyz * w;\n}\nlet drop = dot(rest, rest) / (2.0 * EARTH_RADIUS);\nlet p = vec3f(rest.x + d.x, sp.sea.x + d.y - drop, rest.y + d.z);\nvar o: VsOut;\no.clip = camera.view_proj * vec4f(p, 1.0);\no.p = p;\no.rest = rest;\no.height = d.y;\nreturn o;\n}\nfn sh_irradiance(n: vec3f) -> vec3f {\nreturn max(lighting.sh[0].rgb * 0.282095 + lighting.sh[1].rgb * (0.488603 * n.y) + lighting.sh[2].rgb * (0.488603 * n.z) + lighting.sh[3].rgb * (0.488603 * n.x) + lighting.sh[4].rgb * (1.092548 * n.x * n.y) + lighting.sh[5].rgb * (1.092548 * n.y * n.z) + lighting.sh[6].rgb * (0.315392 * (3.0 * n.z * n.z - 1.0)) + lighting.sh[7].rgb * (1.092548 * n.x * n.z) + lighting.sh[8].rgb * (0.546274 * (n.x * n.x - n.y * n.y)), vec3f(0.0));\n}\n@compute @workgroup_size(8, 8) fn copy_depth(@builtin(global_invocation_id) id: vec3u) {\nlet size = textureDimensions(scene_depth);\nif (id.x >= size.x || id.y >= size.y) {\nreturn;\n}\ntextureStore(depth_out, vec2i(id.xy), vec4f(textureLoad(scene_depth, vec2i(id.xy), 0), 0.0, 0.0, 0.0));\n}\nfn thickness(dist: f32, ds: f32, dop: f32) -> f32 {\nreturn select(1.0e9, dist * max(ds / dop - 1.0, 0.0), dop > 0.0);\n}\nfn mirror_scene(p: vec3f, r: vec3f, size: vec2f) -> vec4f {\nlet len = sp.mirror.x;\nlet steps = u32(sp.mirror.y);\nif (len <= 0.0 || steps == 0u || sp.shore.y < 0.5 || r.y <= 0.0) {\nreturn vec4f(0.0);\n}\nfor (var i = 1u; i <= steps; i++) {\nlet f = f32(i) / f32(steps);\nlet q = p + r * (len * f * f);\nlet c = camera.view_proj * vec4f(q, 1.0);\nif (c.w <= 0.0) {\nbreak;\n}\nlet ndc = c.xyz / c.w;\nlet uv = vec2f(ndc.x * 0.5 + 0.5, 0.5 - ndc.y * 0.5);\nif (any(uv < vec2f(0.0)) || any(uv > vec2f(1.0))) {\nbreak;\n}\nlet d = textureLoad(under_depth, vec2i(uv * size), 0).x;\nif (d > ndc.z && d > 0.0) {\nlet gap = c.w * (1.0 - ndc.z / d);\nif (gap < sp.mirror.z + 0.03 * c.w) {\nlet edge = min(min(uv.x, 1.0 - uv.x), min(uv.y, 1.0 - uv.y));\nlet fade = saturate(edge * 12.0) * (1.0 - f * f);\nreturn vec4f(textureSampleLevel(under, clamp_smp, uv, 0.0).rgb * sp.shore.z, fade);\n}\n}\n}\nreturn vec4f(0.0);\n}\n@fragment fn fs(in: VsOut) -> @location(0) vec4f {\nlet frag = in.clip;\nvar sx = 0.0;\nvar sz = 0.0;\nvar lost = 0.0;\nvar fold = 0.0;\nfor (var c = 0u; c < u32(sp.sea.y); c++) {\nlet cc = sp.cascade[c];\nlet uv = cc.xy + in.rest * cc.z;\nlet texels = length(fwidth(uv)) * sp.size.x;\nlet w = 1.0 - smoothstep(0.5, 2.0, texels);\nlet s = textureSampleLevel(slopes, wrap, uv, c, 0.0);\nsx += s.x * w;\nsz += s.y * w;\nlost += cc.w * (1.0 - w);\nfold = max(fold, saturate((sp.sea.z - s.z) * 2.0) * w);\n}\nlet n = normalize(vec3f(-sx, 1.0, -sz));\nlet v = normalize(-in.p);\nlet l = camera.light_dir.xyz;\nlet nv = max(dot(n, v), 1e-3);\nlet nl = max(dot(n, l), 0.0);\nlet a2 = max(sp.body.w * sp.body.w + 2.0 * lost, 1e-4);\nlet f0 = 0.02;\nlet fresnel = f0 + (1.0 - f0) * pow(1.0 - nv, 5.0);\nvar r = reflect(-v, n);\nr.y = abs(r.y);\nlet lod = clamp(sqrt(sqrt(a2)) * (lighting.env.x - 1.0), 0.0, lighting.env.x - 1.0);\nvar sky = textureSampleLevel(env_cube, wrap, r, lod).rgb * lighting.view.rgb;\nlet seen = mirror_scene(in.p, reflect(-v, n), vec2f(textureDimensions(under)));\nsky = mix(sky, seen.rgb, seen.a);\nif (sp.mirror.w > 0.5) {\nreturn vec4f(select(vec3f(seen.a * 0.2, 0.0, 0.0) + seen.rgb * seen.a, vec3f(0.3, 0.0, 0.0), seen.a <= 0.0) * lighting.env.z, 1.0);\n}\nlet h = normalize(v + l);\nlet nh = max(dot(n, h), 0.0);\nlet dd = nh * nh * (a2 - 1.0) + 1.0;\nlet ggx = a2 / (PI * dd * dd);\nlet vis = 0.5 / (nl * sqrt(nv * nv * (1.0 - a2) + a2) + nv * sqrt(nl * nl * (1.0 - a2) + a2) + 1e-5);\nlet fh = f0 + (1.0 - f0) * pow(1.0 - max(dot(v, h), 0.0), 5.0);\nlet sun = lighting.sun_color.rgb;\nlet spec = sun * (ggx * vis * fh * nl);\nlet up = sh_irradiance(vec3f(0.0, 1.0, 0.0));\nlet body = sp.body.rgb * (up + sun * (max(l.y, 0.0) / PI) * 0.5);\nlet behind = pow(saturate(dot(-v, l)), 8.0);\nlet crest = saturate(in.height * 0.5) * saturate(1.0 - n.y * 0.9 + 0.2);\nlet sss = sp.sss.rgb * sun * (behind * crest * sp.sss.w);\nvar below = body;\nvar shore_foam = 0.0;\nif (sp.shore.y > 0.5) {\nlet px = vec2i(frag.xy);\nlet size = vec2f(textureDimensions(under));\nlet dist = length(in.p);\nlet t0 = thickness(dist, frag.z, textureLoad(under_depth, px, 0).x);\nlet bend = n.xz * sp.optics.w * min(t0, 1.0);\nvar uv = (frag.xy + bend) / size;\nvar t = thickness(dist, frag.z, textureLoad(under_depth, vec2i(uv * size), 0).x);\nif (textureLoad(under_depth, vec2i(uv * size), 0).x > frag.z) {\nuv = frag.xy / size;\nt = t0;\n}\nlet behind_light = textureSampleLevel(under, clamp_smp, uv, 0.0).rgb * sp.shore.z;\nlet trans = exp(-sp.optics.rgb * t);\nbelow = behind_light * trans + body * (vec3f(1.0) - trans);\nlet ripple = textureSampleLevel(displacement, wrap, sp.cascade[u32(sp.sea.y) - 1u].xy + in.rest * sp.cascade[u32(sp.sea.y) - 1u].z, u32(sp.sea.y) - 1u, 0.0).y;\nshore_foam = saturate((1.0 - t0 / sp.shore.x) * 1.4 + ripple * 2.0) * saturate(t0 * 8.0);\n}\nlet water = sky * fresnel + (below + sss) * (1.0 - fresnel) + spec;\nlet foam_light = (sh_irradiance(n) + sun * (nl / PI)) * 0.85;\nlet foam = saturate(fold * sp.sea.w + shore_foam);\nlet lit = mix(water, foam_light, foam);\nlet fogged = apply_fog(lit, in.p, lighting.fog, lighting.fog2, lighting.fog_air.rgb, sh_irradiance(normalize(in.p)), sun, l);\nreturn vec4f(fogged * lighting.env.z, 1.0);\n}\nstruct Camera {\nview_proj: mat4x4f,\nfrustum: array<vec4f, 6>,\nlight_dir: vec4f,\norigin: vec4f,\n}\nstruct Lighting {\nsun_color: vec4f,\nenv: vec4f,\nsh: array<vec4f, 9>,\nscreen: vec4f,\nview: vec4f,\nao_reproject: mat4x4f,\nao: vec4f,\nfog: vec4f,\nfog2: vec4f,\nfog_air: vec4f,\ngi_grid: vec4f,\ngi_counts: vec4f,\nssr: vec4f,\ngi_cascades: array<vec4f, 3>,\n}\nfn apply_fog(color: vec3f, p: vec3f, fog: vec4f, fog2: vec4f, air: vec3f, ambient: vec3f, sun: vec3f, sun_dir: vec3f) -> vec3f {\nlet dist = length(p);\nif (dist <= 0.0 || (fog.x <= 0.0 && fog2.x <= 0.0)) {\nreturn color;\n}\nlet dir = p / dist;\nlet t = exp(-(air * (fog2.x * dist) + vec3f(height_fog_depth(fog, dir, dist))));\nreturn color * t + fog_inscatter(fog2, dir, ambient, sun, sun_dir) * (vec3f(1.0) - t);\n}\nfn height_fog_depth(fog: vec4f, dir: vec3f, dist: f32) -> f32 {\nif (fog.x <= 0.0) {\nreturn 0.0;\n}\nlet falloff = max(fog.y, 1e-5);\nlet len = max(dist - fog.w, 0.0);\nlet h0 = fog.z + dir.y * min(dist, fog.w);\nlet k = falloff * dir.y * len;\nlet shape = select((1.0 - exp(-k)) / k, 1.0 - 0.5 * k, abs(k) < 1e-3);\nreturn fog.x * exp(-falloff * h0) * len * shape;\n}\nfn fog_inscatter(fog2: vec4f, dir: vec3f, ambient: vec3f, sun: vec3f, sun_dir: vec3f) -> vec3f {\nlet g = fog2.z;\nlet c = dot(dir, sun_dir);\nlet phase = (1.0 - g * g) / (FOUR_PI * pow(max(1.0 + g * g - 2.0 * g * c, 1e-4), 1.5));\nreturn ambient + sun * (phase * fog2.y);\n}\nconst FOUR_PI = 12.5663706;",
+};
+//# sourceMappingURL=water-shaders.gen.js.map

package/dist/water-shaders.gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"water-shaders.gen.js","sourceRoot":"","sources":["../src/water-shaders.gen.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,yEAAyE;AAEzE,4CAA4C;AAC5C,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,IAAI,EAAE,kBAAkB;IACxB,IAAI,EAAE,stGAAstG;CACptG,CAAC;AAEX,8CAA8C;AAC9C,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,kBAAkB;IACxB,IAAI,EAAE,ynRAAynR;CACvnR,CAAC"}

package/dist/water.d.ts

@@ -0,0 +1,71 @@
+import type { FrameGraph, PipelineCache, RenderFeature, RenderFeatureFactory, RenderFeatureFrame, SceneRenderer } from '@yali-engine/render';
+import { WaterWaves, type WaterWavesOptions } from './waves.ts';
+/** The ocean's knobs. */
+export interface WaterOptions extends WaterWavesOptions {
+    /** The sea's mean level, world metres (default 0). */
+    readonly level?: number;
+    /** Rings and segments of the surface's grid (defaults 240 × 384: 184,320 triangles out to ~9 km). */
+    readonly rings?: number;
+    readonly segments?: number;
+    /** The Jacobian below which foam starts (default 0.6; lower: less foam), and foam's strength (default 1). */
+    readonly foamThreshold?: number;
+    readonly foam?: number;
+    /** The water body's scattering colour (linear; default a deep teal-blue) and calm water's roughness (default 0.04). */
+    readonly bodyColor?: readonly [number, number, number];
+    readonly roughness?: number;
+    /** The colour of light through a crest (linear) and its strength (defaults a green-cyan, 0.5). */
+    readonly subsurfaceColor?: readonly [number, number, number];
+    readonly subsurface?: number;
+    /** The water's absorption per metre, red green blue (default coastal seawater: red gone in ~2 m, blue in ~20). */
+    readonly absorption?: readonly [number, number, number];
+    /** How far the refraction bends the view, pixels at a metre of water (default 60). */
+    readonly refraction?: number;
+    /** Water shallower than this foams at a shore, metres (default 0.12). */
+    readonly shoreFoam?: number;
+    /** How far the mirror ray is marched for reflections of the scene, metres (default 40; 0: the sky only), and its steps (24). */
+    readonly reflections?: number;
+    readonly reflectionSteps?: number;
+}
+/**
+ * An ocean (ADR-0198): FFT waves (JONSWAP, Donelan–Banner) on a radial grid to the horizon, lit by the scene's sky, sun and
+ * fog. WebGPU with HDR only.
+ *
+ * @example
+ * import { water } from '@yali-engine/water';
+ * renderPlugin({ canvas, sky: { model: 'atmosphere' }, post: { passes: postPasses, taa: true }, features: [water({ wind: 12 })] });
+ */
+export declare function water(o?: WaterOptions): RenderFeatureFactory;
+export declare class Water implements RenderFeature {
+    #private;
+    readonly name = "water";
+    readonly device: GPUDevice;
+    readonly waves: WaterWaves;
+    /** Live knobs. */
+    level: number;
+    foamThreshold: number;
+    foam: number;
+    bodyColor: [number, number, number];
+    roughness: number;
+    subsurfaceColor: [number, number, number];
+    subsurface: number;
+    absorption: [number, number, number];
+    refraction: number;
+    shoreFoam: number;
+    reflections: number;
+    reflectionSteps: number;
+    /** Holds the waves at this time, seconds (live; null: they follow the app's clock). For stills and A/B checks. */
+    frozenAt: number | null;
+    /** A debug view: only the scene the reflections found (red where none). */
+    debugMirror: boolean;
+    /** Off: nothing is drawn or computed (live). */
+    enabled: boolean;
+    readonly rings: number;
+    readonly segments: number;
+    constructor(device: GPUDevice, o: WaterOptions);
+    init(cache: PipelineCache, format: GPUTextureFormat): Promise<void>;
+    prepare(f: RenderFeatureFrame): void;
+    addPasses(graph: FrameGraph, color: string, depth: string, scene: SceneRenderer): void;
+    /** What the sea holds on the GPU (its waves; the surface has no buffers). */
+    get gpuBytes(): number;
+    destroy(): void;
+}

package/dist/water.js

@@ -0,0 +1,209 @@
+import { waterSurface } from "./water-shaders.gen.js";
+import { WaterWaves } from "./waves.js";
+/** Bytes of `SurfaceParams` (`shaders/water/surface.wesl`): 4 cascades + 8 vectors. */
+const PARAMS_BYTES = (4 + 8) * 16;
+/** The first ring's spacing (m) and how much wider each next ring is. */
+const FIRST_RING = 0.12;
+const RING_GROWTH = 0.036;
+/**
+ * An ocean (ADR-0198): FFT waves (JONSWAP, Donelan–Banner) on a radial grid to the horizon, lit by the scene's sky, sun and
+ * fog. WebGPU with HDR only.
+ *
+ * @example
+ * import { water } from '@yali-engine/water';
+ * renderPlugin({ canvas, sky: { model: 'atmosphere' }, post: { passes: postPasses, taa: true }, features: [water({ wind: 12 })] });
+ */
+export function water(o = {}) {
+    return (device) => new Water(device, o);
+}
+export class Water {
+    name = 'water';
+    device;
+    waves;
+    /** Live knobs. */
+    level;
+    foamThreshold;
+    foam;
+    bodyColor;
+    roughness;
+    subsurfaceColor;
+    subsurface;
+    absorption;
+    refraction;
+    shoreFoam;
+    reflections;
+    reflectionSteps;
+    /** Holds the waves at this time, seconds (live; null: they follow the app's clock). For stills and A/B checks. */
+    frozenAt = null;
+    /** A debug view: only the scene the reflections found (red where none). */
+    debugMirror = false;
+    /** Off: nothing is drawn or computed (live). */
+    enabled = true;
+    rings;
+    segments;
+    #pipeline;
+    #copyDepth;
+    #depthGroup = null;
+    #under = false;
+    #inv = 1;
+    #params;
+    #data = new Float32Array(PARAMS_BYTES / 4);
+    #sampler;
+    #clamp;
+    #group = null;
+    #groupKey = '';
+    #depthKey = -1;
+    #seconds = 0;
+    #env = null;
+    constructor(device, o) {
+        this.device = device;
+        this.waves = new WaterWaves(device, o);
+        this.level = o.level ?? 0;
+        this.foamThreshold = o.foamThreshold ?? 0.6;
+        this.foam = o.foam ?? 1;
+        this.bodyColor = [...(o.bodyColor ?? [0.012, 0.045, 0.06])];
+        this.roughness = o.roughness ?? 0.04;
+        this.subsurfaceColor = [...(o.subsurfaceColor ?? [0.04, 0.26, 0.22])];
+        this.subsurface = o.subsurface ?? 0.5;
+        this.absorption = [...(o.absorption ?? [0.35, 0.1, 0.07])];
+        this.refraction = o.refraction ?? 60;
+        this.shoreFoam = o.shoreFoam ?? 0.12;
+        this.reflections = o.reflections ?? 40;
+        this.reflectionSteps = o.reflectionSteps ?? 24;
+        this.rings = o.rings ?? 240;
+        this.segments = o.segments ?? 384;
+        this.#params = device.createBuffer({ label: 'yali:water:surface', size: PARAMS_BYTES, usage: 0x40 | 0x08 });
+        this.#clamp = device.createSampler({ label: 'yali:water:clamp', magFilter: 'linear', minFilter: 'linear' });
+        this.#sampler = device.createSampler({ label: 'yali:water:wrap', addressModeU: 'repeat', addressModeV: 'repeat', magFilter: 'linear', minFilter: 'linear', mipmapFilter: 'linear' });
+    }
+    async init(cache, format) {
+        const [pipeline] = await Promise.all([
+            cache.render({
+                label: 'yali:water:surface',
+                vertex: { shader: waterSurface, entryPoint: 'vs' },
+                fragment: { shader: waterSurface, entryPoint: 'fs', targets: [{ format }] },
+                // Both faces: from under a crest the camera sees the surface's back.
+                primitive: { topology: 'triangle-list', cullMode: 'none' },
+                depthStencil: { format: 'depth32float', depthWriteEnabled: true, depthCompare: 'greater' },
+            }),
+            this.waves.init(cache),
+            cache.compute({ label: 'yali:water:copy-depth', compute: { shader: waterSurface, entryPoint: 'copy_depth' } }).then((p) => (this.#copyDepth = p)),
+        ]);
+        this.#pipeline = pipeline;
+    }
+    prepare(f) {
+        this.#seconds = this.frozenAt ?? f.seconds;
+        this.#env = f.environment;
+        const d = this.#data;
+        const eye = f.camera.eye;
+        const n = this.waves.tiles.length;
+        for (let c = 0; c < 4; c++) {
+            if (c >= n) {
+                d.fill(0, c * 4, c * 4 + 4);
+                continue;
+            }
+            const tile = this.waves.tiles[c];
+            // The eye on the tile in f64, then small (the waves' phase stays exact far from the origin, ADR-0008).
+            const mod = (v) => (((v % tile) + tile) % tile) / tile;
+            d.set([mod(eye[0]), mod(eye[2]), 1 / tile, this.waves.slopeVariance[c]], c * 4);
+        }
+        d.set([FIRST_RING, RING_GROWTH, this.rings, this.segments], 16);
+        d.set([this.level - eye[1], n, this.foamThreshold, this.foam], 20);
+        d.set([...this.bodyColor, this.roughness], 24);
+        d.set([...this.subsurfaceColor, this.subsurface], 28);
+        d.set([this.waves.size, 0, 0, 0], 32);
+        d.set([...this.absorption, this.refraction], 36);
+        // The scene behind is read at the pre-exposure it was written with (this frame's).
+        this.#inv = 1 / Math.max(1e-6, f.scene.preExposure);
+        d.set([this.shoreFoam, this.#under ? 1 : 0, this.#inv, 0], 40);
+        d.set([this.reflections, this.reflectionSteps, 0.6, this.debugMirror ? 1 : 0], 44);
+        this.device.queue.writeBuffer(this.#params, 0, d);
+    }
+    addPasses(graph, color, depth, scene) {
+        // What the surface looks through (ADR-0199): the opaque scene's colour and depth, copied before it draws.
+        this.#under = true;
+        graph.transientTexture('water.under', { format: 'rgba16float', usage: 0x02 | 0x04 });
+        graph.transientTexture('water.depth', { format: 'r32float', usage: 0x08 | 0x04 });
+        graph.addPass({
+            name: 'water.under',
+            kind: 'encoder',
+            reads: [],
+            writes: ['water.under'],
+            execute: (encoder, ctx) => {
+                if (this.enabled)
+                    encoder.copyTextureToTexture({ texture: ctx.texture(color) }, { texture: ctx.texture('water.under') }, [ctx.width, ctx.height]);
+            },
+        });
+        graph.addPass({
+            name: 'water.depth',
+            kind: 'compute',
+            reads: [depth],
+            writes: ['water.depth'],
+            execute: (pass, ctx) => {
+                if (!this.enabled)
+                    return;
+                if (!this.#depthGroup || this.#depthKey !== ctx.generation) {
+                    this.#depthKey = ctx.generation;
+                    this.#depthGroup = this.device.createBindGroup({ label: 'yali:water:copy-depth', layout: this.#copyDepth.getBindGroupLayout(0), entries: [{ binding: 10, resource: ctx.view(depth) }, { binding: 11, resource: ctx.view('water.depth') }] });
+                }
+                pass.setPipeline(this.#copyDepth);
+                pass.setBindGroup(0, this.#depthGroup);
+                pass.dispatchWorkgroups(Math.ceil(ctx.width / 8), Math.ceil(ctx.height / 8));
+            },
+        });
+        graph.addPass({
+            name: 'water.waves',
+            kind: 'compute',
+            reads: [],
+            writes: ['water.waves'],
+            execute: (pass) => {
+                if (this.enabled)
+                    this.waves.encode(pass, this.#seconds);
+            },
+        });
+        graph.addPass({
+            name: 'water.surface',
+            kind: 'render',
+            reads: ['water.waves', 'water.under', 'water.depth'],
+            color: { target: color, clear: { r: 0, g: 0, b: 0, a: 0 }, load: true },
+            depth: { target: depth, clear: 0, load: true, store: true },
+            execute: (pass, ctx) => {
+                const env = this.#env;
+                if (!this.enabled || !env)
+                    return;
+                const key = `${env.version}:${ctx.generation}`;
+                if (!this.#group || key !== this.#groupKey) {
+                    this.#groupKey = key;
+                    this.#group = this.device.createBindGroup({
+                        label: 'yali:water:surface',
+                        layout: this.#pipeline.getBindGroupLayout(0),
+                        entries: [
+                            { binding: 0, resource: { buffer: scene.cameraBuffer } },
+                            { binding: 1, resource: { buffer: scene.lightingBuffer } },
+                            { binding: 2, resource: { buffer: this.#params } },
+                            { binding: 3, resource: this.waves.displacement.createView({ dimension: '2d-array' }) },
+                            { binding: 4, resource: this.waves.slopes.createView({ dimension: '2d-array' }) },
+                            { binding: 5, resource: this.#sampler },
+                            { binding: 6, resource: env.prefiltered.createView({ dimension: 'cube' }) },
+                            { binding: 7, resource: ctx.view('water.under') },
+                            { binding: 8, resource: ctx.view('water.depth') },
+                            { binding: 9, resource: this.#clamp },
+                        ],
+                    });
+                }
+                pass.setPipeline(this.#pipeline);
+                pass.setBindGroup(0, this.#group);
+                pass.draw(this.rings * this.segments * 6);
+            },
+        });
+    }
+    /** What the sea holds on the GPU (its waves; the surface has no buffers). */
+    get gpuBytes() {
+        return this.waves.gpuBytes;
+    }
+    destroy() {
+        this.waves.destroy();
+        this.#params.destroy();
+    }
+}
+//# sourceMappingURL=water.js.map

package/dist/water.js.map

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

package/dist/waves.d.ts

@@ -0,0 +1,48 @@
+import type { PipelineCache } from '@yali-engine/render';
+import { type SeaState } from './spectrum.ts';
+/** What `WaterWaves` takes. */
+export interface WaterWavesOptions extends SeaState {
+    /** Texels a side of every cascade (a power of two, 32–256; default 128: the Medium tier's). */
+    readonly size?: number;
+    /** Each cascade's tile, metres (default [250, 37, 7]: the research's three disjoint bands). */
+    readonly tiles?: readonly number[];
+    /** How far the horizontal displacement goes, 0–1 (choppy waves; default 0.8). */
+    readonly choppiness?: number;
+}
+/**
+ * The FFT cascades of one sea. `encode` each frame (any compute pass); read `displacement` and `slopes` (texture arrays, a
+ * layer per cascade) after it.
+ *
+ * @example
+ * const waves = new WaterWaves(device, { wind: 12, direction: 0.3 });
+ * await waves.init();
+ * // each frame:
+ * waves.encode(pass, timeSeconds);
+ */
+export declare class WaterWaves {
+    #private;
+    readonly device: GPUDevice;
+    readonly size: number;
+    readonly tiles: readonly number[];
+    choppiness: number;
+    /**
+     * Each cascade's slope variance (per axis, its expected ∂h/∂x²): what the surface folds into roughness where a pixel
+     * cannot resolve the cascade.
+     */
+    readonly slopeVariance: number[];
+    readonly displacement: GPUTexture;
+    readonly slopes: GPUTexture;
+    constructor(device: GPUDevice, o?: WaterWavesOptions);
+    /**
+     * A new sea on the same cascades (ADR-0198): the spectra rebuilt for `sea`'s wind, fetch and direction and uploaded;
+     * the waves change at the next `encode` (no pipeline or texture is remade).
+     */
+    reseed(sea: SeaState): void;
+    /** Builds the pipelines, through the render plugin's cache when given (`size` sets their override constants). */
+    init(cache?: PipelineCache): Promise<void>;
+    /** Every cascade at time `seconds`: evolve, the FFT along rows then columns, pack into its layer. */
+    encode(pass: GPUComputePassEncoder, seconds: number): void;
+    /** The bytes this sea holds on the GPU: spectra, the FFT's two buffers, and the two texture arrays. */
+    get gpuBytes(): number;
+    destroy(): void;
+}

package/dist/waves.js

@@ -0,0 +1,161 @@
+import { cascadeBands, h0Table } from "./spectrum.js";
+import { waterWaves } from "./water-shaders.gen.js";
+/** Fields the FFT carries (eight real ones, two to a complex field). */
+const FIELDS = 4;
+/** STORAGE | COPY_DST | COPY_SRC (to read a cascade back for checking). */
+const STORAGE = 0x80 | 0x08 | 0x04;
+/** UNIFORM | COPY_DST. */
+const UNIFORM = 0x40 | 0x08;
+/** STORAGE_BINDING | TEXTURE_BINDING | COPY_SRC. */
+const TEXTURE = 0x08 | 0x04 | 0x01;
+/** One pass's parameters in their own 256-byte slot: per cascade, rows and columns. */
+const SLOT = 256;
+/**
+ * The FFT cascades of one sea. `encode` each frame (any compute pass); read `displacement` and `slopes` (texture arrays, a
+ * layer per cascade) after it.
+ *
+ * @example
+ * const waves = new WaterWaves(device, { wind: 12, direction: 0.3 });
+ * await waves.init();
+ * // each frame:
+ * waves.encode(pass, timeSeconds);
+ */
+export class WaterWaves {
+    device;
+    size;
+    tiles;
+    choppiness;
+    /**
+     * Each cascade's slope variance (per axis, its expected ∂h/∂x²): what the surface folds into roughness where a pixel
+     * cannot resolve the cascade.
+     */
+    slopeVariance = [];
+    displacement;
+    slopes;
+    #cascades;
+    #bands = [];
+    #params;
+    #data = new ArrayBuffer(SLOT);
+    #evolve;
+    #fft;
+    #pack;
+    #groups = [];
+    constructor(device, o = {}) {
+        const size = o.size ?? 128;
+        if (!(size >= 32 && size <= 256 && (size & (size - 1)) === 0)) {
+            throw Object.assign(new Error(`WATER_SIZE: ${size} texels a side is not a power of two from 32 to 256.`), { code: 'WATER_SIZE', path: 'size' });
+        }
+        const tiles = o.tiles ?? [250, 37, 7];
+        if (tiles.length < 1 || tiles.some((t) => !(t > 0)))
+            throw Object.assign(new Error('WATER_TILES: every cascade needs a tile size above 0 m.'), { code: 'WATER_TILES', path: 'tiles' });
+        this.device = device;
+        this.size = size;
+        this.tiles = tiles;
+        this.choppiness = o.choppiness ?? 0.8;
+        const bands = cascadeBands(tiles, size);
+        this.#cascades = tiles.map((tile, c) => {
+            const h0 = device.createBuffer({ label: `yali:water:h0-${c}`, size: size * size * 16, usage: STORAGE });
+            return {
+                tile,
+                h0,
+                a: device.createBuffer({ label: `yali:water:a-${c}`, size: FIELDS * size * size * 8, usage: STORAGE }),
+                b: device.createBuffer({ label: `yali:water:b-${c}`, size: FIELDS * size * size * 8, usage: STORAGE }),
+            };
+        });
+        this.#bands = bands;
+        this.reseed(o);
+        // Per cascade three slots: evolve and rows (axis 0), columns (axis 1), pack (axis 0).
+        this.#params = device.createBuffer({ label: 'yali:water:params', size: SLOT * 3 * tiles.length, usage: UNIFORM });
+        const layers = { width: size, height: size, depthOrArrayLayers: tiles.length };
+        this.displacement = device.createTexture({ label: 'yali:water:displacement', size: layers, format: 'rgba16float', usage: TEXTURE });
+        this.slopes = device.createTexture({ label: 'yali:water:slopes', size: layers, format: 'rgba16float', usage: TEXTURE });
+    }
+    /**
+     * A new sea on the same cascades (ADR-0198): the spectra rebuilt for `sea`'s wind, fetch and direction and uploaded;
+     * the waves change at the next `encode` (no pipeline or texture is remade).
+     */
+    reseed(sea) {
+        const size = this.size;
+        this.slopeVariance.length = 0;
+        this.#cascades.forEach((c, ci) => {
+            const table = h0Table(size, c.tile, this.#bands[ci], sea, ci);
+            this.device.queue.writeBuffer(c.h0, 0, table);
+            // Σ k² |h(k)|² / 2: the variance of one axis's slope (h(k) carries h0(k) and h0(−k)).
+            const dk = (2 * Math.PI) / c.tile;
+            let v = 0;
+            for (let z = 0; z < size; z++) {
+                for (let x = 0; x < size; x++) {
+                    const i = (z * size + x) * 4;
+                    const k2 = ((x - size / 2) * dk) ** 2 + ((z - size / 2) * dk) ** 2;
+                    v += k2 * (table[i] ** 2 + table[i + 1] ** 2 + table[i + 2] ** 2 + table[i + 3] ** 2);
+                }
+            }
+            this.slopeVariance.push(v / 2);
+        });
+    }
+    /** Builds the pipelines, through the render plugin's cache when given (`size` sets their override constants). */
+    async init(cache) {
+        const d = this.device;
+        const constants = { N: this.size, HALF: this.size / 2 };
+        const module = cache ? null : d.createShaderModule({ label: 'yali:water:waves', code: waterWaves.wgsl });
+        [this.#evolve, this.#fft, this.#pack] = await Promise.all(['evolve', 'fft', 'pack'].map((entryPoint) => cache ? cache.compute({ label: `yali:water:${entryPoint}`, compute: { shader: waterWaves, entryPoint, constants } }) : d.createComputePipelineAsync({ label: `yali:water:${entryPoint}`, layout: 'auto', compute: { module: module, entryPoint, constants } })));
+        const dv = this.displacement.createView({ dimension: '2d-array' });
+        const sv = this.slopes.createView({ dimension: '2d-array' });
+        this.#groups = this.#cascades.map((c, ci) => {
+            const slot = (k) => ({ binding: 3, resource: { buffer: this.#params, offset: (ci * 3 + k) * SLOT, size: 32 } });
+            return [
+                d.createBindGroup({ label: `yali:water:evolve-${ci}`, layout: this.#evolve.getBindGroupLayout(0), entries: [{ binding: 0, resource: { buffer: c.h0 } }, { binding: 1, resource: { buffer: c.a } }, slot(0)] }),
+                d.createBindGroup({ label: `yali:water:rows-${ci}`, layout: this.#fft.getBindGroupLayout(0), entries: [{ binding: 1, resource: { buffer: c.a } }, { binding: 2, resource: { buffer: c.b } }, slot(0)] }),
+                d.createBindGroup({ label: `yali:water:columns-${ci}`, layout: this.#fft.getBindGroupLayout(0), entries: [{ binding: 1, resource: { buffer: c.a } }, { binding: 2, resource: { buffer: c.b } }, slot(1)] }),
+                d.createBindGroup({ label: `yali:water:pack-${ci}`, layout: this.#pack.getBindGroupLayout(0), entries: [{ binding: 1, resource: { buffer: c.a } }, slot(2), { binding: 4, resource: dv }, { binding: 5, resource: sv }] }),
+            ];
+        });
+    }
+    /** Every cascade at time `seconds`: evolve, the FFT along rows then columns, pack into its layer. */
+    encode(pass, seconds) {
+        if (this.#groups.length === 0)
+            return;
+        const f = new Float32Array(this.#data);
+        const u = new Uint32Array(this.#data);
+        this.#cascades.forEach((c, ci) => {
+            for (let k = 0; k < 3; k++) {
+                f[0] = seconds;
+                f[1] = c.tile;
+                f[2] = this.choppiness;
+                f[3] = 0;
+                u[4] = k === 1 ? 1 : 0;
+                u[5] = ci;
+                this.device.queue.writeBuffer(this.#params, (ci * 3 + k) * SLOT, this.#data, 0, 32);
+            }
+        });
+        const n = this.size;
+        this.#cascades.forEach((_, ci) => {
+            const [evolve, rows, columns, pack] = this.#groups[ci];
+            pass.setPipeline(this.#evolve);
+            pass.setBindGroup(0, evolve);
+            pass.dispatchWorkgroups(n / 8, n / 8);
+            pass.setPipeline(this.#fft);
+            pass.setBindGroup(0, rows);
+            pass.dispatchWorkgroups(n, FIELDS);
+            pass.setBindGroup(0, columns);
+            pass.dispatchWorkgroups(n, FIELDS);
+            pass.setPipeline(this.#pack);
+            pass.setBindGroup(0, pack);
+            pass.dispatchWorkgroups(n / 8, n / 8);
+        });
+    }
+    /** The bytes this sea holds on the GPU: spectra, the FFT's two buffers, and the two texture arrays. */
+    get gpuBytes() {
+        const n = this.size * this.size;
+        return this.tiles.length * (n * 16 + 2 * FIELDS * n * 8 + 2 * n * 8);
+    }
+    destroy() {
+        for (const c of this.#cascades)
+            for (const b of [c.h0, c.a, c.b])
+                b.destroy();
+        this.#params.destroy();
+        this.displacement.destroy();
+        this.slopes.destroy();
+    }
+}
+//# sourceMappingURL=waves.js.map

package/dist/waves.js.map

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

package/package.json

@@ -1,6 +1,27 @@
 {
   "name": "@yali-engine/water",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.11.0",
+  "description": "Yali water: an ocean's FFT cascades (JONSWAP, Donelan–Banner) and its surface, a render feature (ADR-0198).",
+  "license": "MIT OR Apache-2.0",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@yali-engine/render": "0.11.0"
+  },
+  "scripts": {
+    "typecheck": "tsc -p tsconfig.json",
+    "test": "node --experimental-strip-types --no-warnings --test \"test/*.test.ts\""
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.