@aura3d/engine 3.0.0 → 4.0.0

package/dist/rendering/world/terrain/TerrainHeightTexture.js

@@ -0,0 +1,173 @@
+/**
+ * PRD-10 T2.1 — terrain height grid (R32F upload) + the CPU twin of the
+ * `a3dTerrainHeightBilinear` GLSL in `shaders/terrainCdlod.ts`.
+ *
+ * The CPU twin is bit-compatible with the shader (§8.1): same `(size-1)` uv
+ * mapping, same clamped-texel fetch at the border. `AuraTerrainHandle.heightAt`
+ * is implemented on top of it so shader and CPU agree within 1e-4 m.
+ *
+ * `terrainGpuHeightReadback` is a TEST-ONLY path (§15.2 `terrain-gpu-cpu`):
+ * it draws one fragment per sample point into an R32F target, never runs in
+ * the frame loop.
+ */
+/**
+ * CPU twin of `a3dTerrainHeightBilinear` (§8.1). `uv` is terrain-normalized;
+ * border texels clamp exactly like the shader's `clamp(i, 0, size-1)`.
+ */
+export function terrainHeightBilinear(grid, uv, heightScale = 1) {
+    const { columns, rows, heights } = grid;
+    const px = uv[0] * (columns - 1);
+    const py = uv[1] * (rows - 1);
+    const ix = Math.floor(px);
+    const iy = Math.floor(py);
+    const fx = px - ix;
+    const fy = py - iy;
+    const hiX = columns - 1;
+    const hiY = rows - 1;
+    const clamp = (v, hi) => (v < 0 ? 0 : v > hi ? hi : v);
+    const i00 = clamp(iy, hiY) * columns + clamp(ix, hiX);
+    const i10 = clamp(iy, hiY) * columns + clamp(ix + 1, hiX);
+    const i01 = clamp(iy + 1, hiY) * columns + clamp(ix, hiX);
+    const i11 = clamp(iy + 1, hiY) * columns + clamp(ix + 1, hiX);
+    const h00 = heights[i00];
+    const h10 = heights[i10];
+    const h01 = heights[i01];
+    const h11 = heights[i11];
+    return ((h00 + (h10 - h00) * fx) * (1 - fy) + (h01 + (h11 - h01) * fx) * fy) * heightScale;
+}
+/**
+ * CPU twin of the §8.1 fragment macro normal:
+ * `n = normalize(vec3(hL - hR, 2*texel, hD - hU))`, `texel` = world metres per
+ * texel. Returns world-space up vector.
+ */
+export function terrainMacroNormal(grid, uv, texelWorld, heightScale = 1) {
+    const { columns, rows } = grid;
+    const du = 1 / Math.max(1, columns - 1);
+    const dv = 1 / Math.max(1, rows - 1);
+    const hL = terrainHeightBilinear(grid, [uv[0] - du, uv[1]], 1);
+    const hR = terrainHeightBilinear(grid, [uv[0] + du, uv[1]], 1);
+    const hD = terrainHeightBilinear(grid, [uv[0], uv[1] - dv], 1);
+    const hU = terrainHeightBilinear(grid, [uv[0], uv[1] + dv], 1);
+    const nx = (hL - hR) * heightScale;
+    const ny = 2 * texelWorld;
+    const nz = (hD - hU) * heightScale;
+    const len = Math.hypot(nx, ny, nz) || 1;
+    return [nx / len, ny / len, nz / len];
+}
+/** Upload the grid as R32F (texelFetch only — no float filtering required, §8.1). */
+export function createTerrainHeightTexture(gl, grid) {
+    const texture = gl.createTexture();
+    if (!texture)
+        throw new Error("prd10: failed to create terrain height texture");
+    gl.bindTexture(gl.TEXTURE_2D, texture);
+    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.NEAREST);
+    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.NEAREST);
+    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, gl.CLAMP_TO_EDGE);
+    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE);
+    gl.texImage2D(gl.TEXTURE_2D, 0, gl.R32F, grid.columns, grid.rows, 0, gl.RED, gl.FLOAT, grid.heights);
+    gl.bindTexture(gl.TEXTURE_2D, null);
+    return {
+        texture,
+        columns: grid.columns,
+        rows: grid.rows,
+        dispose() {
+            gl.deleteTexture(texture);
+        }
+    };
+}
+/**
+ * TEST-ONLY GPU readback (§15.2): renders `uvs.length` pixels (N×1 framebuffer)
+ * running the same clamped bilinear as `a3dTerrainHeightBilinear` and reads the
+ * R32F target back. Never call this from a frame path.
+ */
+export function terrainGpuHeightReadback(gl, grid, uvs, heightScale = 1) {
+    const heightTex = createTerrainHeightTexture(gl, grid);
+    const vsSrc = `#version 300 es
+    void main() { gl_Position = vec4(0.0, 0.0, 0.0, 1.0); gl_PointSize = 1.0; }`;
+    const fsSrc = `#version 300 es
+    precision highp float;
+    uniform highp sampler2D u_height;
+    uniform vec2 u_heightTexSize;
+    uniform float u_heightScale;
+    uniform vec2 u_uvs[${Math.max(1, Math.min(uvs.length, 1024))}];
+    uniform int u_index;
+    out float o_height;
+    void main() {
+      vec2 uv = u_uvs[u_index];
+      vec2 p = uv * (u_heightTexSize - 1.0);
+      ivec2 i = ivec2(floor(p));
+      ivec2 hi = ivec2(u_heightTexSize) - ivec2(1);
+      vec2 f = fract(p);
+      float h00 = texelFetch(u_height, clamp(i,               ivec2(0), hi), 0).r;
+      float h10 = texelFetch(u_height, clamp(i + ivec2(1, 0), ivec2(0), hi), 0).r;
+      float h01 = texelFetch(u_height, clamp(i + ivec2(0, 1), ivec2(0), hi), 0).r;
+      float h11 = texelFetch(u_height, clamp(i + ivec2(1, 1), ivec2(0), hi), 0).r;
+      o_height = mix(mix(h00, h10, f.x), mix(h01, h11, f.x), f.y) * u_heightScale;
+    }`;
+    const compile = (type, src) => {
+        const sh = gl.createShader(type);
+        gl.shaderSource(sh, src);
+        gl.compileShader(sh);
+        if (!gl.getShaderParameter(sh, gl.COMPILE_STATUS)) {
+            const log = gl.getShaderInfoLog(sh);
+            gl.deleteShader(sh);
+            throw new Error(`prd10 readback shader: ${log}`);
+        }
+        return sh;
+    };
+    const program = gl.createProgram();
+    gl.attachShader(program, compile(gl.VERTEX_SHADER, vsSrc));
+    gl.attachShader(program, compile(gl.FRAGMENT_SHADER, fsSrc));
+    gl.linkProgram(program);
+    if (!gl.getProgramParameter(program, gl.LINK_STATUS)) {
+        throw new Error(`prd10 readback link: ${gl.getProgramInfoLog(program)}`);
+    }
+    gl.useProgram(program);
+    const emptyVao = gl.createVertexArray();
+    gl.bindVertexArray(emptyVao);
+    gl.activeTexture(gl.TEXTURE0);
+    gl.bindTexture(gl.TEXTURE_2D, heightTex.texture);
+    gl.uniform1i(gl.getUniformLocation(program, "u_height"), 0);
+    gl.uniform2f(gl.getUniformLocation(program, "u_heightTexSize"), grid.columns, grid.rows);
+    gl.uniform1f(gl.getUniformLocation(program, "u_heightScale"), heightScale);
+    const uvsLoc = gl.getUniformLocation(program, "u_uvs");
+    const indexLoc = gl.getUniformLocation(program, "u_index");
+    const fboTex = gl.createTexture();
+    gl.bindTexture(gl.TEXTURE_2D, fboTex);
+    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.NEAREST);
+    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.NEAREST);
+    gl.texImage2D(gl.TEXTURE_2D, 0, gl.R32F, 1, 1, 0, gl.RED, gl.FLOAT, null);
+    const fbo = gl.createFramebuffer();
+    gl.bindFramebuffer(gl.FRAMEBUFFER, fbo);
+    gl.framebufferTexture2D(gl.FRAMEBUFFER, gl.COLOR_ATTACHMENT0, gl.TEXTURE_2D, fboTex, 0);
+    if (gl.checkFramebufferStatus(gl.FRAMEBUFFER) !== gl.FRAMEBUFFER_COMPLETE) {
+        throw new Error("prd10 readback: R32F framebuffer incomplete (extension WEBGL_color_buffer_float missing)");
+    }
+    gl.viewport(0, 0, 1, 1);
+    const batch = 1024;
+    const out = new Float32Array(uvs.length);
+    const px = new Float32Array(4);
+    for (let base = 0; base < uvs.length; base += batch) {
+        const n = Math.min(batch, uvs.length - base);
+        const flat = new Float32Array(n * 2);
+        for (let i = 0; i < n; i += 1) {
+            flat[i * 2] = uvs[base + i][0];
+            flat[i * 2 + 1] = uvs[base + i][1];
+        }
+        gl.uniform2fv(uvsLoc, flat);
+        for (let i = 0; i < n; i += 1) {
+            gl.uniform1i(indexLoc, i);
+            gl.drawArrays(gl.POINTS, 0, 1);
+            gl.readPixels(0, 0, 1, 1, gl.RGBA, gl.FLOAT, px);
+            out[base + i] = px[0];
+        }
+    }
+    gl.bindFramebuffer(gl.FRAMEBUFFER, null);
+    gl.deleteFramebuffer(fbo);
+    gl.deleteTexture(fboTex);
+    gl.deleteVertexArray(emptyVao);
+    gl.deleteProgram(program);
+    heightTex.dispose();
+    return out;
+}
+//# sourceMappingURL=TerrainHeightTexture.js.map

package/dist/rendering/world/terrain/TerrainHeightTexture.js.map

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

package/dist/rendering/world/terrain/TerrainPatchGeometry.d.ts

@@ -0,0 +1,18 @@
+/**
+ * PRD-10 T2.3 — shared CDLOD patch geometry: one `(N+1)²`-vertex grid in
+ * patch-local [0,1]² (`a_grid`), drawn once per selected node via
+ * instanced-by-attribute `a_node` records. `N` comes from the §17 tier table
+ * (`TERRAIN_TIER_LOD.patchSize`).
+ */
+import { type TerrainTierLod } from "./TerrainCdlod.js";
+export type AuraTerrainTier = keyof TerrainTierLod["patchSize"];
+export interface TerrainPatchGeometry {
+    /** `(N+1)² × 2` patch-local uv pairs for attribute `a_grid`. */
+    readonly vertices: Float32Array;
+    readonly indices: Uint16Array | Uint32Array;
+    readonly n: number;
+    readonly vertexCount: number;
+}
+export declare function terrainPatchSizeForTier(tier: AuraTerrainTier): number;
+export declare function createTerrainPatchGeometry(n: number): TerrainPatchGeometry;
+//# sourceMappingURL=TerrainPatchGeometry.d.ts.map

package/dist/rendering/world/terrain/TerrainPatchGeometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TerrainPatchGeometry.d.ts","sourceRoot":"","sources":["../../../../../../packages/rendering/src/world/terrain/TerrainPatchGeometry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEvE,MAAM,MAAM,eAAe,GAAG,MAAM,cAAc,CAAC,WAAW,CAAC,CAAC;AAEhE,MAAM,WAAW,oBAAoB;IACnC,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,CAAC;IAC5C,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAErE;AAED,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,MAAM,GAAG,oBAAoB,CA4B1E"}

package/dist/rendering/world/terrain/TerrainPatchGeometry.js

@@ -0,0 +1,40 @@
+/**
+ * PRD-10 T2.3 — shared CDLOD patch geometry: one `(N+1)²`-vertex grid in
+ * patch-local [0,1]² (`a_grid`), drawn once per selected node via
+ * instanced-by-attribute `a_node` records. `N` comes from the §17 tier table
+ * (`TERRAIN_TIER_LOD.patchSize`).
+ */
+import { TERRAIN_TIER_LOD } from "./TerrainCdlod.js";
+export function terrainPatchSizeForTier(tier) {
+    return TERRAIN_TIER_LOD.patchSize[tier];
+}
+export function createTerrainPatchGeometry(n) {
+    const verts = (n + 1) * (n + 1);
+    const vertices = new Float32Array(verts * 2);
+    let o = 0;
+    for (let j = 0; j <= n; j += 1) {
+        for (let i = 0; i <= n; i += 1) {
+            vertices[o++] = i / n;
+            vertices[o++] = j / n;
+        }
+    }
+    const quads = n * n * 6;
+    const indices = verts <= 65535 ? new Uint16Array(quads) : new Uint32Array(quads);
+    let k = 0;
+    for (let j = 0; j < n; j += 1) {
+        for (let i = 0; i < n; i += 1) {
+            const a = j * (n + 1) + i;
+            const b = a + 1;
+            const c = a + (n + 1);
+            const d = c + 1;
+            indices[k++] = a;
+            indices[k++] = c;
+            indices[k++] = b;
+            indices[k++] = b;
+            indices[k++] = c;
+            indices[k++] = d;
+        }
+    }
+    return { vertices, indices, n, vertexCount: verts };
+}
+//# sourceMappingURL=TerrainPatchGeometry.js.map

package/dist/rendering/world/terrain/TerrainPatchGeometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TerrainPatchGeometry.js","sourceRoot":"","sources":["../../../../../../packages/rendering/src/world/terrain/TerrainPatchGeometry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAuB,MAAM,gBAAgB,CAAC;AAYvE,MAAM,UAAU,uBAAuB,CAAC,IAAqB;IAC3D,OAAO,gBAAgB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,CAAS;IAClD,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAC7C,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACtB,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,MAAM,OAAO,GAAG,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC;IACjF,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;YAC1B,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACtB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChB,OAAO,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;YACjB,OAAO,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;YACjB,OAAO,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;YACjB,OAAO,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;YACjB,OAAO,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;YACjB,OAAO,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AACtD,CAAC"}

package/dist/rendering/world/terrain/shaders/terrain.vert.glsl.d.ts

@@ -0,0 +1,19 @@
+export declare const TERRAIN_VERT_GLSL = "#version 300 es\n// prd10.terrain \u2014 RenderDevice shader marker (both stages; the device rejects a program without it)\nprecision highp float;\nin vec2 a_grid;\nin vec4 a_node;\nuniform vec3 u_cameraPosition;\nuniform mat4 u_viewProjection;\n\n\nuniform highp sampler2D u_height;       // R32F (or RGBA32F-packed), texelFetch only\nuniform float u_heightScale;\nuniform vec2 u_heightTexSize;\n\n// Must match AuraTerrainHandle.heightAt bit-for-bit within 1e-4 m: border\n// texels clamp so the CPU and GPU kernels agree at the last texel.\nfloat a3dTerrainHeightBilinear(vec2 uv) {\n  vec2 p = uv * (u_heightTexSize - 1.0);\n  ivec2 i = ivec2(floor(p));\n  ivec2 hi = ivec2(u_heightTexSize) - ivec2(1);\n  vec2 f = fract(p);\n  float h00 = texelFetch(u_height, clamp(i,                 ivec2(0), hi), 0).r;\n  float h10 = texelFetch(u_height, clamp(i + ivec2(1, 0),   ivec2(0), hi), 0).r;\n  float h01 = texelFetch(u_height, clamp(i + ivec2(0, 1),   ivec2(0), hi), 0).r;\n  float h11 = texelFetch(u_height, clamp(i + ivec2(1, 1),   ivec2(0), hi), 0).r;\n  return mix(mix(h00, h10, f.x), mix(h01, h11, f.x), f.y) * u_heightScale;\n}\n\nuniform vec4 u_terrain;                 // originX, originZ, sizeX, sizeZ\nuniform vec4 u_morph[8];                // per LOD: x morphStart, y morphEnd (distance); vec4 so the\n                                        // 32-float upload is a vec4 array, not a 16-float \"mat4\"\nuniform float u_gridDim;                // patch quads per side (32 or 64)\n\nout vec3 v_worldPosition;\nout vec2 v_terrainUv;\n\n// Full patch displacement for one vertex. a_grid: patch-local [0,1];\n// a_node: per-instance {offsetX, offsetZ, nodeSize, lod}.\nvec3 a3dTerrainCdlod(vec2 a_grid, vec4 a_node, out vec2 outTerrainUv) {\n  vec2 world = a_node.xy + a_grid * a_node.z;\n  float h = a3dTerrainHeightBilinear((world - u_terrain.xy) / u_terrain.zw);\n  float d = distance(u_cameraPosition, vec3(world.x, h, world.y));\n  int lod = int(a_node.w);\n  float morph = clamp((d - u_morph[lod].x) / (u_morph[lod].y - u_morph[lod].x), 0.0, 1.0);\n  vec2 fracPart = fract(a_grid * u_gridDim * 0.5) * 2.0 / u_gridDim; // odd vertices\n  world -= fracPart * a_node.z * morph;                              // snap toward parent grid\n  vec2 uv = (world - u_terrain.xy) / u_terrain.zw;\n  h = a3dTerrainHeightBilinear(uv);\n  outTerrainUv = uv;\n  return vec3(world.x, h, world.y);\n}\n\nvoid main() {\n  vec2 uv;\n  vec3 pos = a3dTerrainCdlod(a_grid, a_node, uv);\n  v_worldPosition = pos;\n  v_terrainUv = uv;\n  gl_Position = u_viewProjection * vec4(pos, 1.0);\n}\n";
+/** Textured terrain program (layer albedo/height + ORM texture arrays bound). */
+export declare const TERRAIN_FRAG_GLSL = "#version 300 es\n// prd10.terrain \u2014 RenderDevice shader marker\nprecision highp float;\nin vec3 v_worldPosition;\nin vec2 v_terrainUv;\nout vec4 o_color;\n// float, not int: the device uploads JS numbers with uniform1f, which is\n// INVALID_OPERATION on an int uniform (the count stayed 0 \u2192 black terrain).\nuniform float u_layerCount;\nuniform vec3 u_cameraPosition;\nuniform vec3 u_ambient;\nuniform vec3 u_keyLightDir;      // direction light travels (e.g. sun \u2192 scene)\nuniform vec3 u_keyLightColor;\n\nuniform highp sampler2D u_height;       // shared with the vertex stage\nuniform highp sampler2D u_splat0;       // layers 0..3 weights in RGBA\nuniform highp sampler2D u_splat1;       // layers 4..7 weights (optional)\nuniform highp sampler2D u_holes;        // 1-bit hole mask\n// A3D_TERRAIN_SOLID (tint-only Path S program): no layer texture arrays are\n// declared. An unbound sampler2DArray defaults to texture unit 0 next to the\n// sampler2D u_height, and two sampler types on one unit make every draw fail\n// with INVALID_OPERATION \u2014 the terrain never reached the frame.\n#ifndef A3D_TERRAIN_SOLID\nuniform highp sampler2DArray u_layerAlbedoHeight; // per layer: albedo RGB + height A\nuniform highp sampler2DArray u_layerNormal;       // per layer: tangent normal RG\nuniform highp sampler2DArray u_layerOrm;          // per layer: occlusion/roughness/metalness\n#endif\nuniform sampler2D u_macroVariation;     // macro anti-tiling noise\nuniform vec4 u_layerParams[8];          // x: uvScale, y: triplanar flag, z: heightBlendContrast, w: layer count\nuniform vec4 u_layerTintOrm[8];         // rgb: tint, a: roughness bias\nuniform float u_terrainWorldSize;       // world size per heightmap edge (for macro normal texel)\nuniform float u_terrainHeightScale;\n\n// Macro normal: central differences on 4 texelFetch of u_height (\u00A78.1).\nvec3 a3dTerrainMacroNormal(vec2 uv) {\n  ivec2 ts = textureSize(u_height, 0);\n  ivec2 i = ivec2(clamp(uv, vec2(0.0), vec2(1.0)) * vec2(ts - 1));\n  float texel = u_terrainWorldSize / float(ts.x);\n  float hL = texelFetch(u_height, clamp(i - ivec2(1, 0), ivec2(0), ts - 1), 0).r;\n  float hR = texelFetch(u_height, clamp(i + ivec2(1, 0), ivec2(0), ts - 1), 0).r;\n  float hD = texelFetch(u_height, clamp(i - ivec2(0, 1), ivec2(0), ts - 1), 0).r;\n  float hU = texelFetch(u_height, clamp(i + ivec2(0, 1), ivec2(0), ts - 1), 0).r;\n  return normalize(vec3((hL - hR) * u_terrainHeightScale, 2.0 * texel, (hD - hU) * u_terrainHeightScale));\n}\n\n// Splat weights w[0..7] from the two splat maps (w[4..7] zero without u_splat1).\nvoid a3dTerrainSplatWeights(vec2 uv, int layerCount, out float w[8]) {\n  vec4 s0 = texture(u_splat0, uv);\n  w[0] = s0.r; w[1] = s0.g; w[2] = s0.b; w[3] = s0.a;\n  if (layerCount > 4) {\n    vec4 s1 = texture(u_splat1, uv);\n    w[4] = s1.r; w[5] = s1.g; w[6] = s1.b; w[7] = s1.a;\n  } else {\n    w[4] = 0.0; w[5] = 0.0; w[6] = 0.0; w[7] = 0.0;\n  }\n}\n\n// Height-blend (\"height lerp\"): hb_i = w_i + height_i * contrast; renormalize\n// above (max(hb) - 0.2). Mutates w in place.\nvoid a3dTerrainHeightBlend(inout float w[8], vec2 worldXZ, float viewDist, int layerCount) {\n  float macro = texture(u_macroVariation, worldXZ / 256.0).r;\n  float t = smoothstep(20.0, 80.0, viewDist);\n  float hbMax = 0.0;\n  for (int i = 0; i < 8; i++) {\n    if (i >= layerCount) break;\n    vec4 params = u_layerParams[i];\n    vec2 uvA = worldXZ / max(params.x, 1e-3);\n#ifdef A3D_TERRAIN_SOLID\n    float heightA = 0.0 * uvA.x; // tint-only: no per-layer height maps\n#else\n    float heightA = texture(u_layerAlbedoHeight, vec3(uvA, float(i))).a;\n#endif\n    w[i] += heightA * params.z + macro * t * 0.05;\n    hbMax = max(hbMax, w[i]);\n  }\n  float m = hbMax - 0.2;\n  float sum = 0.0;\n  for (int i = 0; i < 8; i++) { w[i] = max(w[i] - m, 0.0); sum += w[i]; }\n  if (sum > 1e-6) {\n    for (int i = 0; i < 8; i++) w[i] /= sum;\n  }\n}\n\n// Holes: fragments under mask 0.5 are discarded (also feeds collider holes).\nbool a3dTerrainDiscardHole(vec2 uv) {\n  return texture(u_holes, uv).r < 0.5;\n}\n\nvoid main() {\n  if (a3dTerrainDiscardHole(v_terrainUv)) discard;\n  int layerCount = int(u_layerCount + 0.5);\n  vec3 n = a3dTerrainMacroNormal(v_terrainUv);\n  float w[8];\n  a3dTerrainSplatWeights(v_terrainUv, layerCount, w);\n  float viewDist = distance(u_cameraPosition, v_worldPosition);\n  a3dTerrainHeightBlend(w, v_worldPosition.xz, viewDist, layerCount);\n  float macro = texture(u_macroVariation, v_worldPosition.xz / 256.0).r;\n  vec3 albedo = vec3(0.0);\n  float roughness = 0.0;\n  for (int i = 0; i < 8; i++) {\n    if (i >= layerCount) break;\n    vec4 params = u_layerParams[i];\n    vec3 tint = u_layerTintOrm[i].rgb;\n#ifdef A3D_TERRAIN_SOLID\n    albedo += tint * (0.85 + 0.3 * macro) * w[i];\n    roughness += 0.85 * w[i];\n#else\n    vec2 uvA = v_worldPosition.xz / max(params.x, 1e-3);\n    vec2 uvB = mat2(0.80902, 0.58779, -0.58779, 0.80902) * uvA; // rot(0.62) second-scale anti-tiling\n    vec4 ah = mix(texture(u_layerAlbedoHeight, vec3(uvA, float(i))),\n                  texture(u_layerAlbedoHeight, vec3(uvB, float(i))),\n                  clamp(macro * 2.0, 0.0, 1.0));\n    albedo += ah.rgb * tint * w[i];\n    roughness += texture(u_layerOrm, vec3(uvA, float(i))).g * w[i];\n#endif\n    roughness += u_layerTintOrm[i].a * w[i];\n  }\n  float ndl = max(dot(n, -u_keyLightDir), 0.0);\n  vec3 col = albedo * (u_ambient + u_keyLightColor * ndl);\n  o_color = vec4(col, 1.0);\n}\n";
+/** Tint-only terrain program for Path S: declares no sampler2DArray (see the splat chunk). */
+export declare const TERRAIN_FRAG_SOLID_GLSL = "#version 300 es\n#define A3D_TERRAIN_SOLID 1\n// prd10.terrain \u2014 RenderDevice shader marker\nprecision highp float;\nin vec3 v_worldPosition;\nin vec2 v_terrainUv;\nout vec4 o_color;\n// float, not int: the device uploads JS numbers with uniform1f, which is\n// INVALID_OPERATION on an int uniform (the count stayed 0 \u2192 black terrain).\nuniform float u_layerCount;\nuniform vec3 u_cameraPosition;\nuniform vec3 u_ambient;\nuniform vec3 u_keyLightDir;      // direction light travels (e.g. sun \u2192 scene)\nuniform vec3 u_keyLightColor;\n\nuniform highp sampler2D u_height;       // shared with the vertex stage\nuniform highp sampler2D u_splat0;       // layers 0..3 weights in RGBA\nuniform highp sampler2D u_splat1;       // layers 4..7 weights (optional)\nuniform highp sampler2D u_holes;        // 1-bit hole mask\n// A3D_TERRAIN_SOLID (tint-only Path S program): no layer texture arrays are\n// declared. An unbound sampler2DArray defaults to texture unit 0 next to the\n// sampler2D u_height, and two sampler types on one unit make every draw fail\n// with INVALID_OPERATION \u2014 the terrain never reached the frame.\n#ifndef A3D_TERRAIN_SOLID\nuniform highp sampler2DArray u_layerAlbedoHeight; // per layer: albedo RGB + height A\nuniform highp sampler2DArray u_layerNormal;       // per layer: tangent normal RG\nuniform highp sampler2DArray u_layerOrm;          // per layer: occlusion/roughness/metalness\n#endif\nuniform sampler2D u_macroVariation;     // macro anti-tiling noise\nuniform vec4 u_layerParams[8];          // x: uvScale, y: triplanar flag, z: heightBlendContrast, w: layer count\nuniform vec4 u_layerTintOrm[8];         // rgb: tint, a: roughness bias\nuniform float u_terrainWorldSize;       // world size per heightmap edge (for macro normal texel)\nuniform float u_terrainHeightScale;\n\n// Macro normal: central differences on 4 texelFetch of u_height (\u00A78.1).\nvec3 a3dTerrainMacroNormal(vec2 uv) {\n  ivec2 ts = textureSize(u_height, 0);\n  ivec2 i = ivec2(clamp(uv, vec2(0.0), vec2(1.0)) * vec2(ts - 1));\n  float texel = u_terrainWorldSize / float(ts.x);\n  float hL = texelFetch(u_height, clamp(i - ivec2(1, 0), ivec2(0), ts - 1), 0).r;\n  float hR = texelFetch(u_height, clamp(i + ivec2(1, 0), ivec2(0), ts - 1), 0).r;\n  float hD = texelFetch(u_height, clamp(i - ivec2(0, 1), ivec2(0), ts - 1), 0).r;\n  float hU = texelFetch(u_height, clamp(i + ivec2(0, 1), ivec2(0), ts - 1), 0).r;\n  return normalize(vec3((hL - hR) * u_terrainHeightScale, 2.0 * texel, (hD - hU) * u_terrainHeightScale));\n}\n\n// Splat weights w[0..7] from the two splat maps (w[4..7] zero without u_splat1).\nvoid a3dTerrainSplatWeights(vec2 uv, int layerCount, out float w[8]) {\n  vec4 s0 = texture(u_splat0, uv);\n  w[0] = s0.r; w[1] = s0.g; w[2] = s0.b; w[3] = s0.a;\n  if (layerCount > 4) {\n    vec4 s1 = texture(u_splat1, uv);\n    w[4] = s1.r; w[5] = s1.g; w[6] = s1.b; w[7] = s1.a;\n  } else {\n    w[4] = 0.0; w[5] = 0.0; w[6] = 0.0; w[7] = 0.0;\n  }\n}\n\n// Height-blend (\"height lerp\"): hb_i = w_i + height_i * contrast; renormalize\n// above (max(hb) - 0.2). Mutates w in place.\nvoid a3dTerrainHeightBlend(inout float w[8], vec2 worldXZ, float viewDist, int layerCount) {\n  float macro = texture(u_macroVariation, worldXZ / 256.0).r;\n  float t = smoothstep(20.0, 80.0, viewDist);\n  float hbMax = 0.0;\n  for (int i = 0; i < 8; i++) {\n    if (i >= layerCount) break;\n    vec4 params = u_layerParams[i];\n    vec2 uvA = worldXZ / max(params.x, 1e-3);\n#ifdef A3D_TERRAIN_SOLID\n    float heightA = 0.0 * uvA.x; // tint-only: no per-layer height maps\n#else\n    float heightA = texture(u_layerAlbedoHeight, vec3(uvA, float(i))).a;\n#endif\n    w[i] += heightA * params.z + macro * t * 0.05;\n    hbMax = max(hbMax, w[i]);\n  }\n  float m = hbMax - 0.2;\n  float sum = 0.0;\n  for (int i = 0; i < 8; i++) { w[i] = max(w[i] - m, 0.0); sum += w[i]; }\n  if (sum > 1e-6) {\n    for (int i = 0; i < 8; i++) w[i] /= sum;\n  }\n}\n\n// Holes: fragments under mask 0.5 are discarded (also feeds collider holes).\nbool a3dTerrainDiscardHole(vec2 uv) {\n  return texture(u_holes, uv).r < 0.5;\n}\n\nvoid main() {\n  if (a3dTerrainDiscardHole(v_terrainUv)) discard;\n  int layerCount = int(u_layerCount + 0.5);\n  vec3 n = a3dTerrainMacroNormal(v_terrainUv);\n  float w[8];\n  a3dTerrainSplatWeights(v_terrainUv, layerCount, w);\n  float viewDist = distance(u_cameraPosition, v_worldPosition);\n  a3dTerrainHeightBlend(w, v_worldPosition.xz, viewDist, layerCount);\n  float macro = texture(u_macroVariation, v_worldPosition.xz / 256.0).r;\n  vec3 albedo = vec3(0.0);\n  float roughness = 0.0;\n  for (int i = 0; i < 8; i++) {\n    if (i >= layerCount) break;\n    vec4 params = u_layerParams[i];\n    vec3 tint = u_layerTintOrm[i].rgb;\n#ifdef A3D_TERRAIN_SOLID\n    albedo += tint * (0.85 + 0.3 * macro) * w[i];\n    roughness += 0.85 * w[i];\n#else\n    vec2 uvA = v_worldPosition.xz / max(params.x, 1e-3);\n    vec2 uvB = mat2(0.80902, 0.58779, -0.58779, 0.80902) * uvA; // rot(0.62) second-scale anti-tiling\n    vec4 ah = mix(texture(u_layerAlbedoHeight, vec3(uvA, float(i))),\n                  texture(u_layerAlbedoHeight, vec3(uvB, float(i))),\n                  clamp(macro * 2.0, 0.0, 1.0));\n    albedo += ah.rgb * tint * w[i];\n    roughness += texture(u_layerOrm, vec3(uvA, float(i))).g * w[i];\n#endif\n    roughness += u_layerTintOrm[i].a * w[i];\n  }\n  float ndl = max(dot(n, -u_keyLightDir), 0.0);\n  vec3 col = albedo * (u_ambient + u_keyLightColor * ndl);\n  o_color = vec4(col, 1.0);\n}\n";
+/**
+ * T2.4 — WGSL twin of the Path S terrain program (TERRAIN_VERT_GLSL +
+ * TERRAIN_FRAG_GLSL), composed from the same chunk function bodies.
+ *
+ * Bind layout (one module, no collisions):
+ *   @group(0): 0 `u_terrain` (CDLOD), 1 `u_height`, 2 `u_camera`, 3 `u_view`
+ *   @group(1): 0..6 splat/hole/layer/macro textures, 7 `u_samp`, 8 `u_terrainFrag`
+ * The fragment entry takes every derivative first, in uniform control flow,
+ * and defers `discard` to the end, so the layer loop uses explicit-gradient
+ * fetches (`textureSampleGrad`) exactly like the GLSL implicit-derivative path.
+ * Validated by naga in `qr-prd10-wgsl.yml`; WebGPU consumption needs #260.
+ */
+export declare const TERRAIN_WGSL = "\n\nstruct A3dTerrainUniforms {\n  terrain : vec4f,            // originX, originZ, sizeX, sizeZ\n  heightScale : f32,\n  gridDim : f32,\n  heightTexSize : vec2f,\n  morph : array<vec4f, 8>,    // per LOD: xy = morphStart, morphEnd (distance)\n};\n\n\nstruct A3dTerrainFragUniforms {\n  layerParams : array<vec4f, 8>,   // x: uvScale, y: triplanar flag, z: heightBlendContrast, w: layer count\n  layerTintOrm : array<vec4f, 8>,  // rgb: tint, a: roughness bias\n  terrainWorldSize : f32,\n  terrainHeightScale : f32,\n  layerCount : i32,\n  solidMode : i32,                 // 1 = no layer texture arrays bound (tint-only fallback)\n};\n\nstruct A3dTerrainView {\n  viewProjection : mat4x4f,\n  ambient : vec3f,\n  keyLightDir : vec3f,        // direction light travels (e.g. sun -> scene)\n  keyLightColor : vec3f,\n};\n\n@group(0) @binding(0) var<uniform> u_terrain : A3dTerrainUniforms;\n@group(0) @binding(1) var u_height : texture_2d<f32>;\n@group(0) @binding(2) var<uniform> u_camera : vec3f;\n\n@group(0) @binding(3) var<uniform> u_view : A3dTerrainView;\n\n@group(1) @binding(0) var u_splat0 : texture_2d<f32>;\n@group(1) @binding(1) var u_splat1 : texture_2d<f32>;\n@group(1) @binding(2) var u_holes : texture_2d<f32>;\n@group(1) @binding(3) var u_layerAlbedoHeight : texture_2d_array<f32>;\n@group(1) @binding(4) var u_layerNormal : texture_2d_array<f32>;\n@group(1) @binding(5) var u_layerOrm : texture_2d_array<f32>;\n@group(1) @binding(6) var u_macroVariation : texture_2d<f32>;\n@group(1) @binding(7) var u_samp : sampler;\n@group(1) @binding(8) var<uniform> u_terrainFrag : A3dTerrainFragUniforms;\n\n\nfn a3dTerrainHeightBilinear(uv : vec2f) -> f32 {\n  let p = uv * (u_terrain.heightTexSize - vec2f(1.0));\n  let i = vec2i(floor(p));\n  let hi = vec2i(u_terrain.heightTexSize) - vec2i(1);\n  let f = fract(p);\n  let h00 = textureLoad(u_height, clamp(i,                    vec2i(0), hi), 0).r;\n  let h10 = textureLoad(u_height, clamp(i + vec2i(1, 0),      vec2i(0), hi), 0).r;\n  let h01 = textureLoad(u_height, clamp(i + vec2i(0, 1),      vec2i(0), hi), 0).r;\n  let h11 = textureLoad(u_height, clamp(i + vec2i(1, 1),      vec2i(0), hi), 0).r;\n  return mix(mix(h00, h10, f.x), mix(h01, h11, f.x), f.y) * u_terrain.heightScale;\n}\n\nstruct A3dTerrainVertex {\n  world : vec3f,\n  uv : vec2f,\n};\n\n// Full patch displacement for one vertex (mirrors the GLSL a3dTerrainCdlod,\n// returning the terrain UV the GLSL passes through its out parameter).\nfn a3dTerrainCdlod(aGrid : vec2f, aNode : vec4f) -> A3dTerrainVertex {\n  var world = aNode.xy + aGrid * aNode.z;\n  var h = a3dTerrainHeightBilinear((world - u_terrain.terrain.xy) / u_terrain.terrain.zw);\n  let d = distance(u_camera, vec3f(world.x, h, world.y));\n  let lod = clamp(i32(aNode.w), 0, 7);\n  let m = u_terrain.morph[lod];\n  let morph = clamp((d - m.x) / (m.y - m.x), 0.0, 1.0);\n  let fracPart = fract(aGrid * u_terrain.gridDim * 0.5) * 2.0 / u_terrain.gridDim;\n  world = world - fracPart * aNode.z * morph;\n  let uv = (world - u_terrain.terrain.xy) / u_terrain.terrain.zw;\n  h = a3dTerrainHeightBilinear(uv);\n  return A3dTerrainVertex(vec3f(world.x, h, world.y), uv);\n}\n\n\n// Macro normal: central differences on 4 textureLoad of u_height (\u00A78.1).\nfn a3dTerrainMacroNormal(uv : vec2f) -> vec3f {\n  let ts = vec2i(textureDimensions(u_height, 0));\n  let hi = ts - vec2i(1);\n  let i = vec2i(clamp(uv, vec2f(0.0), vec2f(1.0)) * vec2f(hi));\n  let texel = u_terrainFrag.terrainWorldSize / f32(ts.x);\n  let hL = textureLoad(u_height, clamp(i - vec2i(1, 0), vec2i(0), hi), 0).r;\n  let hR = textureLoad(u_height, clamp(i + vec2i(1, 0), vec2i(0), hi), 0).r;\n  let hD = textureLoad(u_height, clamp(i - vec2i(0, 1), vec2i(0), hi), 0).r;\n  let hU = textureLoad(u_height, clamp(i + vec2i(0, 1), vec2i(0), hi), 0).r;\n  let s = u_terrainFrag.terrainHeightScale;\n  return normalize(vec3f((hL - hR) * s, 2.0 * texel, (hD - hU) * s));\n}\n\n// Splat weights w[0..7] from the two splat maps (w[4..7] zero without u_splat1).\nfn a3dTerrainSplatWeights(uv : vec2f, dUvDx : vec2f, dUvDy : vec2f, layerCount : i32) -> array<f32, 8> {\n  var w : array<f32, 8>;\n  let s0 = textureSampleGrad(u_splat0, u_samp, uv, dUvDx, dUvDy);\n  w[0] = s0.r; w[1] = s0.g; w[2] = s0.b; w[3] = s0.a;\n  if (layerCount > 4) {\n    let s1 = textureSampleGrad(u_splat1, u_samp, uv, dUvDx, dUvDy);\n    w[4] = s1.r; w[5] = s1.g; w[6] = s1.b; w[7] = s1.a;\n  }\n  return w;\n}\n\n// Height-blend (\"height lerp\"): hb_i = w_i + height_i * contrast; renormalize\n// above (max(hb) - 0.2). Mirrors the GLSL a3dTerrainHeightBlend; WGSL has no\n// inout arrays, so the blended weights are returned.\nfn a3dTerrainHeightBlend(wIn : array<f32, 8>, worldXZ : vec2f, dXZDx : vec2f, dXZDy : vec2f,\n                         viewDist : f32, layerCount : i32) -> array<f32, 8> {\n  var w = wIn;\n  let macroN = textureSampleGrad(u_macroVariation, u_samp, worldXZ / 256.0, dXZDx / 256.0, dXZDy / 256.0).r; // \"macro\" is a WGSL reserved word\n  let t = smoothstep(20.0, 80.0, viewDist);\n  var hbMax = 0.0;\n  for (var i = 0; i < 8; i = i + 1) {\n    if (i >= layerCount) { break; }\n    let params = u_terrainFrag.layerParams[i];\n    let inv = 1.0 / max(params.x, 1e-3);\n    var heightA = 0.0;\n    if (u_terrainFrag.solidMode == 0) {\n      heightA = textureSampleGrad(u_layerAlbedoHeight, u_samp, worldXZ * inv, i, dXZDx * inv, dXZDy * inv).a;\n    }\n    w[i] = w[i] + heightA * params.z + macroN * t * 0.05;\n    hbMax = max(hbMax, w[i]);\n  }\n  let m = hbMax - 0.2;\n  var sum = 0.0;\n  for (var i = 0; i < 8; i = i + 1) { w[i] = max(w[i] - m, 0.0); sum = sum + w[i]; }\n  if (sum > 1e-6) {\n    for (var i = 0; i < 8; i = i + 1) { w[i] = w[i] / sum; }\n  }\n  return w;\n}\n\n// Holes: fragments under mask 0.5 are discarded (also feeds collider holes).\n// Level 0 keeps the 1-bit mask crisp, exactly like the collider reads it.\nfn a3dTerrainDiscardHole(uv : vec2f) -> bool {\n  return textureSampleLevel(u_holes, u_samp, uv, 0.0).r < 0.5;\n}\n\nstruct TerrainVsOut {\n  @builtin(position) position : vec4f,\n  @location(0) terrainUv : vec2f,\n  @location(1) worldPosition : vec3f,\n};\n\n@vertex\nfn terrainVs(@location(0) a_grid : vec2f, @location(1) a_node : vec4f) -> TerrainVsOut {\n  let v = a3dTerrainCdlod(a_grid, a_node);\n  var o : TerrainVsOut;\n  o.position = u_view.viewProjection * vec4f(v.world, 1.0);\n  o.terrainUv = v.uv;\n  o.worldPosition = v.world;\n  return o;\n}\n\n@fragment\nfn terrainFs(in_ : TerrainVsOut) -> @location(0) vec4f {\n  let uv = in_.terrainUv;\n  let xz = in_.worldPosition.xz;\n  // Uniform control flow: all derivatives before any branch, loop or discard.\n  let dUvDx = dpdx(uv);\n  let dUvDy = dpdy(uv);\n  let dXZDx = dpdx(xz);\n  let dXZDy = dpdy(xz);\n  let hole = a3dTerrainDiscardHole(uv);\n  let n = a3dTerrainMacroNormal(uv);\n  let layerCount = u_terrainFrag.layerCount;\n  var w = a3dTerrainSplatWeights(uv, dUvDx, dUvDy, layerCount);\n  let viewDist = distance(u_camera, in_.worldPosition);\n  w = a3dTerrainHeightBlend(w, xz, dXZDx, dXZDy, viewDist, layerCount);\n  let macroN = textureSampleGrad(u_macroVariation, u_samp, xz / 256.0, dXZDx / 256.0, dXZDy / 256.0).r;\n  let rot = mat2x2f(0.80902, 0.58779, -0.58779, 0.80902); // rot(0.62) second-scale anti-tiling\n  var albedo = vec3f(0.0);\n  var roughness = 0.0;\n  for (var i = 0; i < 8; i = i + 1) {\n    if (i >= layerCount) { break; }\n    let params = u_terrainFrag.layerParams[i];\n    let tint = u_terrainFrag.layerTintOrm[i].rgb;\n    if (u_terrainFrag.solidMode == 0) {\n      let inv = 1.0 / max(params.x, 1e-3);\n      let uvA = xz * inv;\n      let gAx = dXZDx * inv;\n      let gAy = dXZDy * inv;\n      let ah = mix(textureSampleGrad(u_layerAlbedoHeight, u_samp, uvA, i, gAx, gAy),\n                   textureSampleGrad(u_layerAlbedoHeight, u_samp, rot * uvA, i, rot * gAx, rot * gAy),\n                   clamp(macroN * 2.0, 0.0, 1.0));\n      albedo = albedo + ah.rgb * tint * w[i];\n      roughness = roughness + textureSampleGrad(u_layerOrm, u_samp, uvA, i, gAx, gAy).g * w[i];\n    } else {\n      albedo = albedo + tint * (0.85 + 0.3 * macroN) * w[i];\n      roughness = roughness + 0.85 * w[i];\n    }\n    roughness = roughness + u_terrainFrag.layerTintOrm[i].a * w[i];\n  }\n  if (hole) { discard; }\n  let ndl = max(dot(n, -u_view.keyLightDir), 0.0);\n  let col = albedo * (u_view.ambient + u_view.keyLightColor * ndl);\n  return vec4f(col, 1.0);\n}\n";
+//# sourceMappingURL=terrain.vert.glsl.d.ts.map

package/dist/rendering/world/terrain/shaders/terrain.vert.glsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terrain.vert.glsl.d.ts","sourceRoot":"","sources":["../../../../../../../packages/rendering/src/world/terrain/shaders/terrain.vert.glsl.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,iBAAiB,yhFAe7B,CAAC;AAkDF,iFAAiF;AACjF,eAAO,MAAM,iBAAiB,i5KAAwC,CAAC;AAEvE,8FAA8F;AAC9F,eAAO,MAAM,uBAAuB,86KAAqE,CAAC;AAE1G;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,YAAY,qwQA0ExB,CAAC"}

package/dist/rendering/world/terrain/shaders/terrain.vert.glsl.js

@@ -0,0 +1,162 @@
+/**
+ * PRD-10 T2.4 — the standalone Path S terrain program sources, composed from
+ * the `a3d_prd10_terrain_cdlod` / `a3d_prd10_terrain_splat` chunk bodies so the
+ * vertex displacement is bit-identical to the harnessed chunk.
+ */
+import { terrainCdlodGlsl, terrainCdlodWgslBindings, terrainCdlodWgslFunctions, terrainCdlodWgslUniformStruct } from "./terrainCdlod.js";
+import { terrainSplatGlsl, terrainSplatWgslBindings, terrainSplatWgslFunctions, terrainSplatWgslUniformStruct } from "./terrainSplat.js";
+export const TERRAIN_VERT_GLSL = /* glsl */ `#version 300 es
+// prd10.terrain — RenderDevice shader marker (both stages; the device rejects a program without it)
+precision highp float;
+in vec2 a_grid;
+in vec4 a_node;
+uniform vec3 u_cameraPosition;
+uniform mat4 u_viewProjection;
+${terrainCdlodGlsl}
+void main() {
+  vec2 uv;
+  vec3 pos = a3dTerrainCdlod(a_grid, a_node, uv);
+  v_worldPosition = pos;
+  v_terrainUv = uv;
+  gl_Position = u_viewProjection * vec4(pos, 1.0);
+}
+`;
+const terrainFragBody = /* glsl */ `// prd10.terrain — RenderDevice shader marker
+precision highp float;
+in vec3 v_worldPosition;
+in vec2 v_terrainUv;
+out vec4 o_color;
+// float, not int: the device uploads JS numbers with uniform1f, which is
+// INVALID_OPERATION on an int uniform (the count stayed 0 → black terrain).
+uniform float u_layerCount;
+uniform vec3 u_cameraPosition;
+uniform vec3 u_ambient;
+uniform vec3 u_keyLightDir;      // direction light travels (e.g. sun → scene)
+uniform vec3 u_keyLightColor;
+${terrainSplatGlsl}
+void main() {
+  if (a3dTerrainDiscardHole(v_terrainUv)) discard;
+  int layerCount = int(u_layerCount + 0.5);
+  vec3 n = a3dTerrainMacroNormal(v_terrainUv);
+  float w[8];
+  a3dTerrainSplatWeights(v_terrainUv, layerCount, w);
+  float viewDist = distance(u_cameraPosition, v_worldPosition);
+  a3dTerrainHeightBlend(w, v_worldPosition.xz, viewDist, layerCount);
+  float macro = texture(u_macroVariation, v_worldPosition.xz / 256.0).r;
+  vec3 albedo = vec3(0.0);
+  float roughness = 0.0;
+  for (int i = 0; i < 8; i++) {
+    if (i >= layerCount) break;
+    vec4 params = u_layerParams[i];
+    vec3 tint = u_layerTintOrm[i].rgb;
+#ifdef A3D_TERRAIN_SOLID
+    albedo += tint * (0.85 + 0.3 * macro) * w[i];
+    roughness += 0.85 * w[i];
+#else
+    vec2 uvA = v_worldPosition.xz / max(params.x, 1e-3);
+    vec2 uvB = mat2(0.80902, 0.58779, -0.58779, 0.80902) * uvA; // rot(0.62) second-scale anti-tiling
+    vec4 ah = mix(texture(u_layerAlbedoHeight, vec3(uvA, float(i))),
+                  texture(u_layerAlbedoHeight, vec3(uvB, float(i))),
+                  clamp(macro * 2.0, 0.0, 1.0));
+    albedo += ah.rgb * tint * w[i];
+    roughness += texture(u_layerOrm, vec3(uvA, float(i))).g * w[i];
+#endif
+    roughness += u_layerTintOrm[i].a * w[i];
+  }
+  float ndl = max(dot(n, -u_keyLightDir), 0.0);
+  vec3 col = albedo * (u_ambient + u_keyLightColor * ndl);
+  o_color = vec4(col, 1.0);
+}
+`;
+/** Textured terrain program (layer albedo/height + ORM texture arrays bound). */
+export const TERRAIN_FRAG_GLSL = `#version 300 es\n${terrainFragBody}`;
+/** Tint-only terrain program for Path S: declares no sampler2DArray (see the splat chunk). */
+export const TERRAIN_FRAG_SOLID_GLSL = `#version 300 es\n#define A3D_TERRAIN_SOLID 1\n${terrainFragBody}`;
+/**
+ * T2.4 — WGSL twin of the Path S terrain program (TERRAIN_VERT_GLSL +
+ * TERRAIN_FRAG_GLSL), composed from the same chunk function bodies.
+ *
+ * Bind layout (one module, no collisions):
+ *   @group(0): 0 `u_terrain` (CDLOD), 1 `u_height`, 2 `u_camera`, 3 `u_view`
+ *   @group(1): 0..6 splat/hole/layer/macro textures, 7 `u_samp`, 8 `u_terrainFrag`
+ * The fragment entry takes every derivative first, in uniform control flow,
+ * and defers `discard` to the end, so the layer loop uses explicit-gradient
+ * fetches (`textureSampleGrad`) exactly like the GLSL implicit-derivative path.
+ * Validated by naga in `qr-prd10-wgsl.yml`; WebGPU consumption needs #260.
+ */
+export const TERRAIN_WGSL = /* wgsl */ `
+${terrainCdlodWgslUniformStruct}
+${terrainSplatWgslUniformStruct}
+struct A3dTerrainView {
+  viewProjection : mat4x4f,
+  ambient : vec3f,
+  keyLightDir : vec3f,        // direction light travels (e.g. sun -> scene)
+  keyLightColor : vec3f,
+};
+${terrainCdlodWgslBindings}
+@group(0) @binding(3) var<uniform> u_view : A3dTerrainView;
+${terrainSplatWgslBindings}
+${terrainCdlodWgslFunctions}
+${terrainSplatWgslFunctions}
+struct TerrainVsOut {
+  @builtin(position) position : vec4f,
+  @location(0) terrainUv : vec2f,
+  @location(1) worldPosition : vec3f,
+};
+
+@vertex
+fn terrainVs(@location(0) a_grid : vec2f, @location(1) a_node : vec4f) -> TerrainVsOut {
+  let v = a3dTerrainCdlod(a_grid, a_node);
+  var o : TerrainVsOut;
+  o.position = u_view.viewProjection * vec4f(v.world, 1.0);
+  o.terrainUv = v.uv;
+  o.worldPosition = v.world;
+  return o;
+}
+
+@fragment
+fn terrainFs(in_ : TerrainVsOut) -> @location(0) vec4f {
+  let uv = in_.terrainUv;
+  let xz = in_.worldPosition.xz;
+  // Uniform control flow: all derivatives before any branch, loop or discard.
+  let dUvDx = dpdx(uv);
+  let dUvDy = dpdy(uv);
+  let dXZDx = dpdx(xz);
+  let dXZDy = dpdy(xz);
+  let hole = a3dTerrainDiscardHole(uv);
+  let n = a3dTerrainMacroNormal(uv);
+  let layerCount = u_terrainFrag.layerCount;
+  var w = a3dTerrainSplatWeights(uv, dUvDx, dUvDy, layerCount);
+  let viewDist = distance(u_camera, in_.worldPosition);
+  w = a3dTerrainHeightBlend(w, xz, dXZDx, dXZDy, viewDist, layerCount);
+  let macroN = textureSampleGrad(u_macroVariation, u_samp, xz / 256.0, dXZDx / 256.0, dXZDy / 256.0).r;
+  let rot = mat2x2f(0.80902, 0.58779, -0.58779, 0.80902); // rot(0.62) second-scale anti-tiling
+  var albedo = vec3f(0.0);
+  var roughness = 0.0;
+  for (var i = 0; i < 8; i = i + 1) {
+    if (i >= layerCount) { break; }
+    let params = u_terrainFrag.layerParams[i];
+    let tint = u_terrainFrag.layerTintOrm[i].rgb;
+    if (u_terrainFrag.solidMode == 0) {
+      let inv = 1.0 / max(params.x, 1e-3);
+      let uvA = xz * inv;
+      let gAx = dXZDx * inv;
+      let gAy = dXZDy * inv;
+      let ah = mix(textureSampleGrad(u_layerAlbedoHeight, u_samp, uvA, i, gAx, gAy),
+                   textureSampleGrad(u_layerAlbedoHeight, u_samp, rot * uvA, i, rot * gAx, rot * gAy),
+                   clamp(macroN * 2.0, 0.0, 1.0));
+      albedo = albedo + ah.rgb * tint * w[i];
+      roughness = roughness + textureSampleGrad(u_layerOrm, u_samp, uvA, i, gAx, gAy).g * w[i];
+    } else {
+      albedo = albedo + tint * (0.85 + 0.3 * macroN) * w[i];
+      roughness = roughness + 0.85 * w[i];
+    }
+    roughness = roughness + u_terrainFrag.layerTintOrm[i].a * w[i];
+  }
+  if (hole) { discard; }
+  let ndl = max(dot(n, -u_view.keyLightDir), 0.0);
+  let col = albedo * (u_view.ambient + u_view.keyLightColor * ndl);
+  return vec4f(col, 1.0);
+}
+`;
+//# sourceMappingURL=terrain.vert.glsl.js.map

package/dist/rendering/world/terrain/shaders/terrain.vert.glsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terrain.vert.glsl.js","sourceRoot":"","sources":["../../../../../../../packages/rendering/src/world/terrain/shaders/terrain.vert.glsl.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,yBAAyB,EACzB,6BAA6B,EAC9B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,yBAAyB,EACzB,6BAA6B,EAC9B,MAAM,mBAAmB,CAAC;AAE3B,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC;;;;;;;EAO1C,gBAAgB;;;;;;;;CAQjB,CAAC;AAEF,MAAM,eAAe,GAAG,UAAU,CAAC;;;;;;;;;;;;EAYjC,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCjB,CAAC;AAEF,iFAAiF;AACjF,MAAM,CAAC,MAAM,iBAAiB,GAAG,oBAAoB,eAAe,EAAE,CAAC;AAEvE,8FAA8F;AAC9F,MAAM,CAAC,MAAM,uBAAuB,GAAG,iDAAiD,eAAe,EAAE,CAAC;AAE1G;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAC;EACrC,6BAA6B;EAC7B,6BAA6B;;;;;;;EAO7B,wBAAwB;;EAExB,wBAAwB;EACxB,yBAAyB;EACzB,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6D1B,CAAC"}

package/dist/rendering/world/terrain/shaders/terrainCdlod.d.ts

@@ -0,0 +1,23 @@
+/**
+ * `a3d_prd10_terrain_cdlod` — PRD-10 §8.1 terrain CDLOD vertex chunk.
+ * Patch-instanced heightfield: manual bilinear height fetch (matches the CPU
+ * `heightAt` within 1e-4 m) + geometric morph toward the parent grid.
+ * Path S links this body; Path G consumes it through the `prd10.terrain` feature.
+ */
+import type { ShaderChunk } from "../../../contracts/program.js";
+/** Shared by the terrain program and the SplatBake pass so both run the §8.1 kernel verbatim. */
+export declare const a3dTerrainHeightBilinearGlsl = "\nuniform highp sampler2D u_height;       // R32F (or RGBA32F-packed), texelFetch only\nuniform float u_heightScale;\nuniform vec2 u_heightTexSize;\n\n// Must match AuraTerrainHandle.heightAt bit-for-bit within 1e-4 m: border\n// texels clamp so the CPU and GPU kernels agree at the last texel.\nfloat a3dTerrainHeightBilinear(vec2 uv) {\n  vec2 p = uv * (u_heightTexSize - 1.0);\n  ivec2 i = ivec2(floor(p));\n  ivec2 hi = ivec2(u_heightTexSize) - ivec2(1);\n  vec2 f = fract(p);\n  float h00 = texelFetch(u_height, clamp(i,                 ivec2(0), hi), 0).r;\n  float h10 = texelFetch(u_height, clamp(i + ivec2(1, 0),   ivec2(0), hi), 0).r;\n  float h01 = texelFetch(u_height, clamp(i + ivec2(0, 1),   ivec2(0), hi), 0).r;\n  float h11 = texelFetch(u_height, clamp(i + ivec2(1, 1),   ivec2(0), hi), 0).r;\n  return mix(mix(h00, h10, f.x), mix(h01, h11, f.x), f.y) * u_heightScale;\n}\n";
+export declare const terrainCdlodGlsl = "\n\nuniform highp sampler2D u_height;       // R32F (or RGBA32F-packed), texelFetch only\nuniform float u_heightScale;\nuniform vec2 u_heightTexSize;\n\n// Must match AuraTerrainHandle.heightAt bit-for-bit within 1e-4 m: border\n// texels clamp so the CPU and GPU kernels agree at the last texel.\nfloat a3dTerrainHeightBilinear(vec2 uv) {\n  vec2 p = uv * (u_heightTexSize - 1.0);\n  ivec2 i = ivec2(floor(p));\n  ivec2 hi = ivec2(u_heightTexSize) - ivec2(1);\n  vec2 f = fract(p);\n  float h00 = texelFetch(u_height, clamp(i,                 ivec2(0), hi), 0).r;\n  float h10 = texelFetch(u_height, clamp(i + ivec2(1, 0),   ivec2(0), hi), 0).r;\n  float h01 = texelFetch(u_height, clamp(i + ivec2(0, 1),   ivec2(0), hi), 0).r;\n  float h11 = texelFetch(u_height, clamp(i + ivec2(1, 1),   ivec2(0), hi), 0).r;\n  return mix(mix(h00, h10, f.x), mix(h01, h11, f.x), f.y) * u_heightScale;\n}\n\nuniform vec4 u_terrain;                 // originX, originZ, sizeX, sizeZ\nuniform vec4 u_morph[8];                // per LOD: x morphStart, y morphEnd (distance); vec4 so the\n                                        // 32-float upload is a vec4 array, not a 16-float \"mat4\"\nuniform float u_gridDim;                // patch quads per side (32 or 64)\n\nout vec3 v_worldPosition;\nout vec2 v_terrainUv;\n\n// Full patch displacement for one vertex. a_grid: patch-local [0,1];\n// a_node: per-instance {offsetX, offsetZ, nodeSize, lod}.\nvec3 a3dTerrainCdlod(vec2 a_grid, vec4 a_node, out vec2 outTerrainUv) {\n  vec2 world = a_node.xy + a_grid * a_node.z;\n  float h = a3dTerrainHeightBilinear((world - u_terrain.xy) / u_terrain.zw);\n  float d = distance(u_cameraPosition, vec3(world.x, h, world.y));\n  int lod = int(a_node.w);\n  float morph = clamp((d - u_morph[lod].x) / (u_morph[lod].y - u_morph[lod].x), 0.0, 1.0);\n  vec2 fracPart = fract(a_grid * u_gridDim * 0.5) * 2.0 / u_gridDim; // odd vertices\n  world -= fracPart * a_node.z * morph;                              // snap toward parent grid\n  vec2 uv = (world - u_terrain.xy) / u_terrain.zw;\n  h = a3dTerrainHeightBilinear(uv);\n  outTerrainUv = uv;\n  return vec3(world.x, h, world.y);\n}\n";
+/**
+ * WGSL twin, split into binding declarations and function bodies so the
+ * standalone chunk twin and the composed `TERRAIN_WGSL` program share the
+ * function text verbatim while the program owns one non-colliding layout.
+ * `morph` is `array<vec4f, 8>` (xy used): uniform-space arrays need a
+ * 16-byte stride, matching the std140 layout of the GLSL `u_morph[8]`.
+ */
+export declare const terrainCdlodWgslUniformStruct = "\nstruct A3dTerrainUniforms {\n  terrain : vec4f,            // originX, originZ, sizeX, sizeZ\n  heightScale : f32,\n  gridDim : f32,\n  heightTexSize : vec2f,\n  morph : array<vec4f, 8>,    // per LOD: xy = morphStart, morphEnd (distance)\n};\n";
+export declare const terrainCdlodWgslBindings = "\n@group(0) @binding(0) var<uniform> u_terrain : A3dTerrainUniforms;\n@group(0) @binding(1) var u_height : texture_2d<f32>;\n@group(0) @binding(2) var<uniform> u_camera : vec3f;\n";
+export declare const terrainCdlodWgslFunctions = "\nfn a3dTerrainHeightBilinear(uv : vec2f) -> f32 {\n  let p = uv * (u_terrain.heightTexSize - vec2f(1.0));\n  let i = vec2i(floor(p));\n  let hi = vec2i(u_terrain.heightTexSize) - vec2i(1);\n  let f = fract(p);\n  let h00 = textureLoad(u_height, clamp(i,                    vec2i(0), hi), 0).r;\n  let h10 = textureLoad(u_height, clamp(i + vec2i(1, 0),      vec2i(0), hi), 0).r;\n  let h01 = textureLoad(u_height, clamp(i + vec2i(0, 1),      vec2i(0), hi), 0).r;\n  let h11 = textureLoad(u_height, clamp(i + vec2i(1, 1),      vec2i(0), hi), 0).r;\n  return mix(mix(h00, h10, f.x), mix(h01, h11, f.x), f.y) * u_terrain.heightScale;\n}\n\nstruct A3dTerrainVertex {\n  world : vec3f,\n  uv : vec2f,\n};\n\n// Full patch displacement for one vertex (mirrors the GLSL a3dTerrainCdlod,\n// returning the terrain UV the GLSL passes through its out parameter).\nfn a3dTerrainCdlod(aGrid : vec2f, aNode : vec4f) -> A3dTerrainVertex {\n  var world = aNode.xy + aGrid * aNode.z;\n  var h = a3dTerrainHeightBilinear((world - u_terrain.terrain.xy) / u_terrain.terrain.zw);\n  let d = distance(u_camera, vec3f(world.x, h, world.y));\n  let lod = clamp(i32(aNode.w), 0, 7);\n  let m = u_terrain.morph[lod];\n  let morph = clamp((d - m.x) / (m.y - m.x), 0.0, 1.0);\n  let fracPart = fract(aGrid * u_terrain.gridDim * 0.5) * 2.0 / u_terrain.gridDim;\n  world = world - fracPart * aNode.z * morph;\n  let uv = (world - u_terrain.terrain.xy) / u_terrain.terrain.zw;\n  h = a3dTerrainHeightBilinear(uv);\n  return A3dTerrainVertex(vec3f(world.x, h, world.y), uv);\n}\n";
+export declare const terrainCdlodWgsl: string;
+export declare const a3d_prd10_terrain_cdlod: ShaderChunk;
+//# sourceMappingURL=terrainCdlod.d.ts.map

package/dist/rendering/world/terrain/shaders/terrainCdlod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terrainCdlod.d.ts","sourceRoot":"","sources":["../../../../../../../packages/rendering/src/world/terrain/shaders/terrainCdlod.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,iGAAiG;AACjG,eAAO,MAAM,4BAA4B,83BAkBxC,CAAC;AAEF,eAAO,MAAM,gBAAgB,6mEAyB5B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,2PAQzC,CAAC;AAEF,eAAO,MAAM,wBAAwB,wLAIpC,CAAC;AAEF,eAAO,MAAM,yBAAyB,ihDAiCrC,CAAC;AAEF,eAAO,MAAM,gBAAgB,QAAuF,CAAC;AAErH,eAAO,MAAM,uBAAuB,EAAE,WAMrC,CAAC"}