@aura3d/rendering 3.0.1 → 4.0.2

package/dist/world/terrain/TerrainCdlod.js

@@ -0,0 +1,115 @@
+/**
+ * PRD-10 T2.2 — CDLOD quadtree (Strugar 2009) over a height grid.
+ *
+ * Node layout: quadtree depth `levels`; depth 0 is the root covering the whole
+ * footprint, leaves sit at depth `levels - 1`. `lod` = `levels - 1 - depth`
+ * (0 = finest). Distance ranges `range_l = range_0 · 2^l` with
+ * `range_0 = patchWorldSize · 1.5 · lodBias` (§6.1, targets ≤ 1.5 px geometry
+ * error); the morph band is the last `morphRatio` of each range.
+ */
+/** §17 tier table. */
+export const TERRAIN_TIER_LOD = {
+    patchSize: { low: 32, medium: 64, high: 64, ultra: 64 },
+    levels: { low: 4, medium: 6, high: 6, ultra: 7 },
+    layers: { low: 4, medium: 4, high: 8, ultra: 8 }
+};
+/** Per-LOD morph ranges (§8.1 `u_morph`): {start,end} in metres. */
+export function cdlodRanges(levels, patchWorldSize, lodBias = 1, morphRatio = 0.33) {
+    const range0 = patchWorldSize * 1.5 * lodBias;
+    const out = [];
+    for (let lod = 0; lod < levels; lod += 1) {
+        const morphEnd = range0 * 2 ** lod;
+        out.push({ lod, morphStart: morphEnd * (1 - morphRatio), morphEnd });
+    }
+    return out;
+}
+/** Build the quadtree + per-node min/max height (subsampled interior nodes). */
+export function buildCdlodTree(grid, worldSize, worldOrigin, levels) {
+    const size = Math.min(worldSize[0], worldSize[1]);
+    const leafSize = size / 2 ** (levels - 1);
+    const all = [];
+    function heightRange(minU, minV, uvSpan) {
+        // Sampled min/max over the node's uv span (clamped to grid).
+        const c0 = Math.max(0, Math.floor(minU * (grid.columns - 1)));
+        const c1 = Math.min(grid.columns - 1, Math.ceil((minU + uvSpan) * (grid.columns - 1)));
+        const r0 = Math.max(0, Math.floor(minV * (grid.rows - 1)));
+        const r1 = Math.min(grid.rows - 1, Math.ceil((minV + uvSpan) * (grid.rows - 1)));
+        let lo = Infinity;
+        let hi = -Infinity;
+        for (let r = r0; r <= r1; r += 1) {
+            for (let c = c0; c <= c1; c += 1) {
+                const h = grid.heights[r * grid.columns + c];
+                if (h < lo)
+                    lo = h;
+                if (h > hi)
+                    hi = h;
+            }
+        }
+        if (!Number.isFinite(lo)) {
+            lo = 0;
+            hi = 0;
+        }
+        return [lo, hi];
+    }
+    function build(origin, nodeSize, depth) {
+        const lod = levels - 1 - depth;
+        const [minHeight, maxHeight] = heightRange((origin[0] - worldOrigin[0]) / worldSize[0], (origin[1] - worldOrigin[1]) / worldSize[1], nodeSize / size);
+        const children = [];
+        if (depth < levels - 1) {
+            const half = nodeSize / 2;
+            children.push(build(origin, half, depth + 1), build([origin[0] + half, origin[1]], half, depth + 1), build([origin[0], origin[1] + half], half, depth + 1), build([origin[0] + half, origin[1] + half], half, depth + 1));
+        }
+        const node = { level: lod, origin, size: nodeSize, minHeight, maxHeight, children };
+        all.push(node);
+        return node;
+    }
+    const root = build(worldOrigin, size, 0);
+    return { root, levels, leafSize, all };
+}
+function aabbDistance(node, p) {
+    const dx = Math.max(node.origin[0] - p[0], 0, p[0] - (node.origin[0] + node.size));
+    const dz = Math.max(node.origin[1] - p[2], 0, p[2] - (node.origin[1] + node.size));
+    const dy = Math.max(node.minHeight - p[1], 0, p[1] - node.maxHeight);
+    return Math.hypot(dx, dy, dz);
+}
+function aabbInFrustum(node, planes) {
+    // Positive-vertex AABB test.
+    for (const [nx, ny, nz, d] of planes) {
+        const x = nx >= 0 ? node.origin[0] + node.size : node.origin[0];
+        const z = nz >= 0 ? node.origin[1] + node.size : node.origin[1];
+        const y = ny >= 0 ? node.maxHeight : node.minHeight;
+        if (nx * x + ny * y + nz * z + d < 0)
+            return false;
+    }
+    return true;
+}
+/**
+ * Select the CDLOD node set for a camera position: descend while the camera is
+ * inside the finer level's range; emit the node otherwise. Returns the drawn
+ * nodes (one instanced patch draw per node at its `level`).
+ */
+export function selectCdlodNodes(tree, cameraPosition, ranges, options = {}) {
+    const out = [];
+    const visit = (node) => {
+        if (options.frustumPlanes && !aabbInFrustum(node, options.frustumPlanes))
+            return;
+        const dist = aabbDistance(node, cameraPosition);
+        const lod = node.level;
+        if (lod === 0) {
+            out.push(node);
+            return;
+        }
+        // Descend into children when the camera is closer than the finer level's
+        // morph end (range_{lod-1}); this node covers the annulus otherwise.
+        if (dist <= ranges[lod - 1].morphEnd) {
+            for (const child of node.children)
+                visit(child);
+        }
+        else {
+            out.push(node);
+        }
+    };
+    visit(tree.root);
+    return out;
+}
+//# sourceMappingURL=TerrainCdlod.js.map

package/dist/world/terrain/TerrainCdlod.js.map

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

package/dist/world/terrain/TerrainHeightTexture.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 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.
+ */
+export interface TerrainHeightGrid {
+    readonly columns: number;
+    readonly rows: number;
+    /** Row-major `z * columns + x`, normalized 0..1 unless caller pre-scales. */
+    readonly heights: Float32Array;
+}
+export interface TerrainHeightTexture {
+    readonly texture: WebGLTexture;
+    readonly columns: number;
+    readonly rows: number;
+    dispose(): void;
+}
+/**
+ * CPU twin of `a3dTerrainHeightBilinear` (§8.1). `uv` is terrain-normalized;
+ * border texels clamp exactly like the shader's `clamp(i, 0, size-1)`.
+ */
+export declare function terrainHeightBilinear(grid: TerrainHeightGrid, uv: readonly [number, number], heightScale?: number): number;
+/**
+ * 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 declare function terrainMacroNormal(grid: TerrainHeightGrid, uv: readonly [number, number], texelWorld: number, heightScale?: number): readonly [number, number, number];
+/** Upload the grid as R32F (texelFetch only — no float filtering required, §8.1). */
+export declare function createTerrainHeightTexture(gl: WebGL2RenderingContext, grid: TerrainHeightGrid): TerrainHeightTexture;
+/**
+ * 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 declare function terrainGpuHeightReadback(gl: WebGL2RenderingContext, grid: TerrainHeightGrid, uvs: readonly (readonly [number, number])[], heightScale?: number): Float32Array;
+//# sourceMappingURL=TerrainHeightTexture.d.ts.map

package/dist/world/terrain/TerrainHeightTexture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TerrainHeightTexture.d.ts","sourceRoot":"","sources":["../../../../../../packages/rendering/src/world/terrain/TerrainHeightTexture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;CAChC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,iBAAiB,EACvB,EAAE,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,WAAW,SAAI,GACd,MAAM,CAoBR;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,iBAAiB,EACvB,EAAE,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,UAAU,EAAE,MAAM,EAClB,WAAW,SAAI,GACd,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAanC;AAED,qFAAqF;AACrF,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,sBAAsB,EAAE,IAAI,EAAE,iBAAiB,GAAG,oBAAoB,CAkBpH;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,sBAAsB,EAC1B,IAAI,EAAE,iBAAiB,EACvB,GAAG,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,EAC3C,WAAW,SAAI,GACd,YAAY,CAyFd"}

package/dist/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/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/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/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/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/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/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/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"}