@aura3d/rendering 3.0.1 → 4.0.2

package/dist/world/vegetation/WindCpu.js.map

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

package/dist/world/vegetation/WindField.d.ts

@@ -0,0 +1,42 @@
+/**
+ * PRD-10 T3.3 §8.2 — the `A3DWind` UBO host side (C-26), the 64² RG8 gust
+ * noise texture, and the C-02 `prd10.wind` feature registrations that splice
+ * `a3d_prd10_wind` into `vertex:deform` for scatter/foliage draws and into the
+ * depth variant (so shadows bend with the surface).
+ *
+ * The gust texture is generated procedurally here (deterministic value noise,
+ * RG8). The PRD names `engine/assets/world/noise/` — that asset directory is
+ * not yet admitted, so a generated twin keeps the contract honest; when the
+ * asset lands it can replace `gustNoiseData` without touching the pack layout.
+ */
+import { Texture } from "../../Texture.js";
+/** Structural twin of the frozen C-26 `AuraWindSpec` (engine contract). */
+export interface WindFieldSpec {
+    readonly direction: readonly [number, number, number];
+    readonly strength: number;
+    readonly gust: number;
+    readonly gustFrequency: number;
+    readonly turbulence: number;
+}
+export declare const WIND_GUST_SIZE = 64;
+/** Deterministic 64² RG8 gust field — value noise, 3 octaves, repeatable. */
+export declare function gustNoiseData(size?: number): Uint8Array;
+/**
+ * Pack the frozen C-26 `AuraWindSpec` into the A3DWind UBO layout
+ * (std140: two vec4s): [dir.x, dir.z, strength, time] + [gust, 1/gustScale,
+ * -, -]. `gustFrequency` in the spec is already 1/scale.
+ */
+export declare function packWindUbo(spec: WindFieldSpec, timeSeconds: number): Float32Array;
+export interface WindFieldBinding {
+    readonly ubo: Float32Array;
+    readonly gustTexture: Texture;
+    readonly dispose: () => void;
+}
+/** Create the gust texture (rgba8: R=gust, G=flutter); UBO packed per frame. */
+export declare function createWindField(spec: WindFieldSpec): WindFieldBinding;
+/** Refresh the UBO floats for a new frame time. */
+export declare function updateWindField(field: WindFieldBinding, spec: WindFieldSpec, timeSeconds: number): Float32Array;
+/** Publish the frame's wind for generated-path draws (C-26 spec, seconds, asset height in metres). */
+export declare function setPrd10WindState(spec: WindFieldSpec | null, timeSeconds: number, assetHeight?: number): void;
+export declare function registerPrd10WindFeatures(): () => void;
+//# sourceMappingURL=WindField.d.ts.map

package/dist/world/vegetation/WindField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WindField.d.ts","sourceRoot":"","sources":["../../../../../../packages/rendering/src/world/vegetation/WindField.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAM3C,2EAA2E;AAC3E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACtD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,IAAI,SAAiB,GAAG,UAAU,CAoC/D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,YAAY,CAKlF;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,gBAAgB,CA0BrE;AAED,mDAAmD;AACnD,wBAAgB,eAAe,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,YAAY,CAI/G;AAeD,sGAAsG;AACtG,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,SAAI,GAAG,IAAI,CAGxG;AAWD,wBAAgB,yBAAyB,IAAI,MAAM,IAAI,CA0BtD"}

package/dist/world/vegetation/WindField.js

@@ -0,0 +1,154 @@
+/**
+ * PRD-10 T3.3 §8.2 — the `A3DWind` UBO host side (C-26), the 64² RG8 gust
+ * noise texture, and the C-02 `prd10.wind` feature registrations that splice
+ * `a3d_prd10_wind` into `vertex:deform` for scatter/foliage draws and into the
+ * depth variant (so shadows bend with the surface).
+ *
+ * The gust texture is generated procedurally here (deterministic value noise,
+ * RG8). The PRD names `engine/assets/world/noise/` — that asset directory is
+ * not yet admitted, so a generated twin keeps the contract honest; when the
+ * asset lands it can replace `gustNoiseData` without touching the pack layout.
+ */
+import { Texture } from "../../Texture.js";
+import { Sampler } from "../../Sampler.js";
+import { TextureBinding } from "../../TextureBinding.js";
+import { registerShaderFeature } from "../../contracts/program.js";
+import { registerDepthVariantFeature } from "../../contracts/shadows.js";
+export const WIND_GUST_SIZE = 64;
+/** Deterministic 64² RG8 gust field — value noise, 3 octaves, repeatable. */
+export function gustNoiseData(size = WIND_GUST_SIZE) {
+    const hash = (x, y) => {
+        let h = (Math.imul(x | 0, 374761393) + Math.imul(y | 0, 668265263)) | 0;
+        h = Math.imul(h ^ (h >>> 13), 1274126177);
+        h ^= h >>> 16;
+        return (h >>> 0) / 4294967295;
+    };
+    const smooth = (t) => t * t * (3 - 2 * t);
+    const noise = (x, y) => {
+        const ix = Math.floor(x);
+        const iy = Math.floor(y);
+        const fx = smooth(x - ix);
+        const fy = smooth(y - iy);
+        const a = hash(ix & (size - 1), iy & (size - 1));
+        const b = hash((ix + 1) & (size - 1), iy & (size - 1));
+        const c = hash(ix & (size - 1), (iy + 1) & (size - 1));
+        const d = hash((ix + 1) & (size - 1), (iy + 1) & (size - 1));
+        return a + (b - a) * fx + (c + (d - c) * fx - a - (b - a) * fx) * fy;
+    };
+    const out = new Uint8Array(size * size * 2);
+    for (let y = 0; y < size; y += 1) {
+        for (let x = 0; x < size; x += 1) {
+            let n = 0;
+            let amp = 0.55;
+            let freq = 4;
+            for (let o = 0; o < 3; o += 1) {
+                n += amp * noise((x / size) * freq, (y / size) * freq);
+                amp *= 0.5;
+                freq *= 2;
+            }
+            const i = (y * size + x) * 2;
+            out[i] = Math.round(Math.min(1, Math.max(0, n)) * 255); // R: gust
+            out[i + 1] = Math.round(Math.min(1, Math.max(0, noise(x / size * 16 + 7.3, y / size * 16 + 2.1))) * 255); // G: fine flutter
+        }
+    }
+    return out;
+}
+/**
+ * Pack the frozen C-26 `AuraWindSpec` into the A3DWind UBO layout
+ * (std140: two vec4s): [dir.x, dir.z, strength, time] + [gust, 1/gustScale,
+ * -, -]. `gustFrequency` in the spec is already 1/scale.
+ */
+export function packWindUbo(spec, timeSeconds) {
+    return Float32Array.from([
+        spec.direction[0], spec.direction[2], spec.strength, timeSeconds,
+        spec.gust, spec.gustFrequency, 0, 0
+    ]);
+}
+/** Create the gust texture (rgba8: R=gust, G=flutter); UBO packed per frame. */
+export function createWindField(spec) {
+    const data = gustNoiseData();
+    const rgba = new Uint8Array(WIND_GUST_SIZE * WIND_GUST_SIZE * 4);
+    for (let i = 0; i < WIND_GUST_SIZE * WIND_GUST_SIZE; i += 1) {
+        rgba[i * 4] = data[i * 2];
+        rgba[i * 4 + 1] = data[i * 2 + 1];
+        rgba[i * 4 + 3] = 255;
+    }
+    const texture = new Texture({
+        width: WIND_GUST_SIZE,
+        height: WIND_GUST_SIZE,
+        format: "rgba8",
+        colorSpace: "linear",
+        label: "prd10-wind-gust",
+        data: rgba
+    });
+    let disposed = false;
+    return {
+        ubo: packWindUbo(spec, 0),
+        gustTexture: texture,
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            texture.dispose();
+        }
+    };
+}
+/** Refresh the UBO floats for a new frame time. */
+export function updateWindField(field, spec, timeSeconds) {
+    const packed = packWindUbo(spec, timeSeconds);
+    field.ubo.set(packed);
+    return field.ubo;
+}
+/**
+ * T3.3 registration — `prd10.wind` splices `a3d_prd10_wind` at `vertex:deform`
+ * for world draws flagged `wind:true` and in the depth/distance variants so
+ * the C-11 shadow pass bends identically.
+ */
+/**
+ * #1143 — generated-path wind state. `prd10.wind` binds these per draw as
+ * plain uniforms (`a3d_prd10_wind_deform`). Zero strength until the world
+ * runtime publishes a spec, so an unset wind leaves geometry in place.
+ */
+const windState = { ubo: new Float32Array(8), assetHeight: 1 };
+let gustBinding;
+/** Publish the frame's wind for generated-path draws (C-26 spec, seconds, asset height in metres). */
+export function setPrd10WindState(spec, timeSeconds, assetHeight = 1) {
+    windState.ubo.set(spec ? packWindUbo(spec, timeSeconds) : new Float32Array(8));
+    windState.assetHeight = assetHeight;
+}
+function windGustBinding() {
+    if (!gustBinding) {
+        const field = createWindField({ direction: [1, 0, 0], strength: 0, gust: 0, gustFrequency: 0, turbulence: 0 });
+        const sampler = new Sampler({ minFilter: "linear", magFilter: "linear", addressU: "repeat", addressV: "repeat" });
+        gustBinding = new TextureBinding({ name: "u_windNoise", texture: field.gustTexture, sampler });
+    }
+    return gustBinding;
+}
+export function registerPrd10WindFeatures() {
+    const feature = {
+        id: "prd10.wind",
+        owner: "prd10",
+        flag: "A3D_QR_WORLD",
+        // Path G contract: the lane labels wind-enabled draws "prd10.wind:<id>"
+        // (RenderItem has no feature map today; the label prefix is the signal).
+        select: (input) => (input.item.label?.startsWith("prd10.wind:") ? 1 : undefined),
+        defines: (v) => (v ? { A3D_PRD10_WIND: 1 } : {}),
+        // #1143: the generated-path chunk (plain uniforms + C-18 `a3dDeform`);
+        // `a3d_prd10_wind` (A3DWind UBO) stays the Path S chunk.
+        chunks: ["a3d_prd10_wind_deform"],
+        hooks: ["vertex:deform"],
+        bindUniforms: (_value, _item, set) => {
+            set("u_windDirStrength", windState.ubo.subarray(0, 4));
+            set("u_windGust", windState.ubo.subarray(4, 8));
+            set("u_windAssetHeight", windState.assetHeight);
+            set("u_windNoise", windGustBinding());
+        }
+    };
+    const unregShader = registerShaderFeature(feature);
+    const unregDepth = registerDepthVariantFeature({ ...feature, passes: ["depth", "distance"] });
+    return () => {
+        unregShader();
+        unregDepth();
+    };
+}
+//# sourceMappingURL=WindField.js.map

package/dist/world/vegetation/WindField.js.map

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

package/dist/world/vegetation/shaders/foliage.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `a3d_prd10_foliage` — PRD-10 §8.3 foliage fragment chunk: alpha cutoff /
+ * A2C-sharpened alpha, two-sided normals, sun translucency, per-instance
+ * colour variation and screen-door crossfade.
+ */
+import type { ShaderChunk } from "../../../contracts/program.js";
+export declare const a3d_prd10_foliage: ShaderChunk;
+//# sourceMappingURL=foliage.d.ts.map

package/dist/world/vegetation/shaders/foliage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"foliage.d.ts","sourceRoot":"","sources":["../../../../../../../packages/rendering/src/world/vegetation/shaders/foliage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAoGjE,eAAO,MAAM,iBAAiB,EAAE,WAM/B,CAAC"}

package/dist/world/vegetation/shaders/foliage.js

@@ -0,0 +1,104 @@
+const glsl = /* glsl */ `
+uniform sampler2D u_baseColor;
+uniform float u_alphaCutoff;          // default 0.5
+uniform float u_alphaToCoverage;      // C-15 alphaToCoverage active (MSAA on); float: no int upload (#491)
+
+// Alpha handling: A2C path sharpens for multisample resolve; otherwise a hard
+// alpha test (Path S, where the C-15 stub ignores alphaToCoverage).
+float a3dFoliageAlpha(vec2 uv) {
+  float alpha = texture(u_baseColor, uv).a;
+  if (u_alphaToCoverage < 0.5) {
+    if (alpha < u_alphaCutoff) discard;
+    return 1.0;
+  }
+  return clamp((alpha - u_alphaCutoff) / max(fwidth(alpha), 1e-4) + 0.5, 0.0, 1.0);
+}
+
+// Two-sided: flip the back-face normal.
+vec3 a3dFoliageNormal(vec3 n) {
+  return gl_FrontFacing ? n : -n;
+}
+
+// Sun-only translucency term added inside the shared direct-light loop:
+// translucencyColor * albedo * pow(saturate(dot(V, -L)), 4) * thickness * shadow * sunColor.
+vec3 a3dFoliageTranslucency(vec3 albedo, vec3 translucencyColor, float thickness, vec3 V, vec3 L, vec3 sunColor, float shadow) {
+  float t = pow(clamp(dot(V, -L), 0.0, 1.0), 4.0);
+  return translucencyColor * albedo * t * thickness * shadow * sunColor;
+}
+
+// Per-instance colour variation: albedo *= 1 + (variation - 0.5) * (0.08, 0.12, 0.04).
+vec3 a3dInstanceVariation(vec3 albedo, float variation) {
+  return albedo * (1.0 + (variation - 0.5) * vec3(0.08, 0.12, 0.04));
+}
+
+// 4x4 Bayer matrix for the screen-door LOD1<->impostor crossfade.
+float a3dBayer4x4(vec2 fragCoord) {
+  ivec2 p = ivec2(fragCoord) & 3;
+  const mat4 b = mat4(
+     0.0,  8.0,  2.0, 10.0,
+    12.0,  4.0, 14.0,  6.0,
+     3.0, 11.0,  1.0,  9.0,
+    15.0,  7.0, 13.0,  5.0
+  );
+  return (b[p.x][p.y] + 0.5) / 16.0;
+}
+
+// Dithered crossfade: discard when the Bayer threshold exceeds the per-instance
+// fade (written per band in the vertex stage from distance).
+void a3dFoliageCrossfade(vec2 fragCoord, float fade) {
+  if (a3dBayer4x4(fragCoord) > fade) discard;
+}
+`;
+const wgsl = /* wgsl */ `
+@group(0) @binding(0) var u_baseColor : texture_2d<f32>;
+@group(0) @binding(1) var u_samp : sampler;
+struct A3dFoliageUniforms {
+  alphaCutoff : f32,
+  alphaToCoverage : i32,
+  pad0 : f32,
+  pad1 : f32,
+};
+@group(0) @binding(2) var<uniform> u_foliage : A3dFoliageUniforms;
+
+fn a3dFoliageAlpha(uv : vec2f) -> f32 {
+  let alpha = textureSample(u_baseColor, u_samp, uv).a;
+  if (u_foliage.alphaToCoverage == 0) {
+    if (alpha < u_foliage.alphaCutoff) { discard; }
+    return 1.0;
+  }
+  return clamp((alpha - u_foliage.alphaCutoff) / max(fwidth(alpha), 1e-4) + 0.5, 0.0, 1.0);
+}
+
+fn a3dFoliageNormal(n : vec3f, frontFacing : bool) -> vec3f {
+  return select(-n, n, frontFacing);
+}
+
+fn a3dFoliageTranslucency(albedo : vec3f, translucencyColor : vec3f, thickness : f32, V : vec3f, L : vec3f, sunColor : vec3f, shadow : f32) -> vec3f {
+  let t = pow(clamp(dot(V, -L), 0.0, 1.0), 4.0);
+  return translucencyColor * albedo * t * thickness * shadow * sunColor;
+}
+
+fn a3dInstanceVariation(albedo : vec3f, variation : f32) -> vec3f {
+  return albedo * (1.0 + (variation - 0.5) * vec3f(0.08, 0.12, 0.04));
+}
+
+fn a3dBayer4x4(fragCoord : vec2f) -> f32 {
+  let x = i32(fragCoord.x) & 3;
+  let y = i32(fragCoord.y) & 3;
+  let b = array<array<f32, 4>, 4>(
+    array<f32, 4>(0.0, 8.0, 2.0, 10.0),
+    array<f32, 4>(12.0, 4.0, 14.0, 6.0),
+    array<f32, 4>(3.0, 11.0, 1.0, 9.0),
+    array<f32, 4>(15.0, 7.0, 13.0, 5.0)
+  );
+  return (b[y][x] + 0.5) / 16.0;
+}
+`;
+export const a3d_prd10_foliage = {
+    name: "a3d_prd10_foliage",
+    owner: "prd10",
+    stage: "fragment",
+    glsl,
+    wgsl
+};
+//# sourceMappingURL=foliage.js.map

package/dist/world/vegetation/shaders/foliage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"foliage.js","sourceRoot":"","sources":["../../../../../../../packages/rendering/src/world/vegetation/shaders/foliage.ts"],"names":[],"mappings":"AAOA,MAAM,IAAI,GAAG,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkDvB,CAAC;AAEF,MAAM,IAAI,GAAG,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4CvB,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAgB;IAC5C,IAAI,EAAE,mBAAmB;IACzB,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,UAAU;IACjB,IAAI;IACJ,IAAI;CACL,CAAC"}

package/dist/world/vegetation/shaders/grass.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `a3d_prd10_grass` — PRD-10 §8.5 grass chunk (vertex stage).
+ * Per-chunk uniform placement with a stratified-jitter hash per
+ * `gl_InstanceID`, quadratic-Bézier blade shape and density falloff.
+ * The fragment side (two-sided translucency + root->tip AO) lands with the
+ * `prd10.grass` feature wiring; Low tier draws alpha-tested cards instead.
+ */
+import type { ShaderChunk } from "../../../contracts/program.js";
+export declare const a3d_prd10_grass: ShaderChunk;
+//# sourceMappingURL=grass.d.ts.map

package/dist/world/vegetation/shaders/grass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grass.d.ts","sourceRoot":"","sources":["../../../../../../../packages/rendering/src/world/vegetation/shaders/grass.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AA2EjE,eAAO,MAAM,eAAe,EAAE,WAM7B,CAAC"}

package/dist/world/vegetation/shaders/grass.js

@@ -0,0 +1,79 @@
+const glsl = /* glsl */ `
+uniform vec4 u_grassChunk;   // chunkOriginXZ, chunkSize, seed
+uniform float u_grassBladeCount; // float: no int uniform upload (#491)
+uniform float u_grassRadius; // density falloff radius from the camera
+uniform float u_grassBladeHeight;
+uniform float u_grassBladeWidth;
+
+// Stratified jitter hash per (seed, instance): position, yaw, height, bend.
+vec4 a3dGrassHash(float seed, int instance) {
+  uint h = uint(seed * 1664525.0) ^ uint(instance * 1013904223.0) ^ uint(instance * 2654435761.0);
+  h ^= h >> 16u; h *= 2246822519u; h ^= h >> 13u;
+  uvec4 v = uvec4(h, h * 3266489917u + 1u, h ^ 668265263u, h * 374761393u);
+  return fract(vec4(v) * (1.0 / 4294967296.0));
+}
+
+// Quadratic Bézier blade vertex. t in [0,1] from root to tip; side in {-1,1}.
+vec3 a3dGrassBladeVertex(vec3 root, float yaw, float height, float bend, float t, float side) {
+  vec2 facing = vec2(cos(yaw), sin(yaw));
+  vec2 rightV = vec2(-facing.y, facing.x);
+  float width = mix(1.0, 0.05, t * t);            // taper to the tip
+  vec2 lean = facing * bend * t * t;              // quadratic lean forward
+  vec3 p = vec3(root.x + lean.x * height, root.y + t * height, root.z + lean.y * height);
+  p.xz += rightV * (u_grassBladeWidth * width * side);
+  return p;
+}
+
+// Per-instance placement inside the chunk (returns zero-height for culled blades).
+vec3 a3dGrassBladeRoot(int instance, out float yaw, out float height, out float bend, out float phase) {
+  vec4 h = a3dGrassHash(u_grassChunk.w, instance);
+  vec2 cell = vec2(instance % 32, instance / 32) / 32.0;
+  vec2 jitter = (h.xy * 0.9 + 0.05) / 32.0;
+  vec2 xz = u_grassChunk.xy + (cell + jitter) * u_grassChunk.z;
+  yaw = h.z * 6.2831853;
+  height = u_grassBladeHeight * (0.6 + 0.8 * h.w);
+  bend = 0.15 + 0.35 * h.y;
+  phase = h.x * 6.2831853;
+  // Density falloff: blades beyond radius*(0.5+0.5*h.w) collapse (zero height).
+  float d = distance(u_cameraPosition, vec3(xz.x, 0.0, xz.y));
+  float falloff = u_grassRadius * (0.5 + 0.5 * h.w);
+  if (d > falloff) height = 0.0;
+  return vec3(xz.x, 0.0, xz.y); // y filled by terrain heightBilinear at draw
+}
+`;
+const wgsl = /* wgsl */ `
+struct A3dGrassChunk {
+  chunk : vec4f,      // chunkOriginXZ, chunkSize, seed
+  bladeCount : i32,
+  radius : f32,
+  bladeHeight : f32,
+  bladeWidth : f32,
+};
+@group(0) @binding(0) var<uniform> u_grass : A3dGrassChunk;
+@group(0) @binding(1) var<uniform> u_camera : vec3f;
+
+fn a3dGrassHash(seed : f32, instance : i32) -> vec4f {
+  var h = u32(seed * 1664525.0) ^ u32(f32(instance) * 1013904223.0) ^ u32(f32(instance) * 2654435761.0);
+  h = h ^ (h >> 16u); h = h * 2246822519u; h = h ^ (h >> 13u);
+  let v = vec4u(h, h * 3266489917u + 1u, h ^ 668265263u, h * 374761393u);
+  return fract(vec4f(v) * (1.0 / 4294967296.0));
+}
+
+fn a3dGrassBladeVertex(root : vec3f, yaw : f32, height : f32, bend : f32, t : f32, side : f32, bladeWidth : f32) -> vec3f {
+  let facing = vec2f(cos(yaw), sin(yaw));
+  let rightV = vec2f(-facing.y, facing.x);
+  let width = mix(1.0, 0.05, t * t);
+  let lean = facing * bend * t * t;
+  var p = vec3f(root.x + lean.x * height, root.y + t * height, root.z + lean.y * height);
+  p = vec3f(p.x + rightV.x * (bladeWidth * width * side), p.y, p.z + rightV.y * (bladeWidth * width * side));
+  return p;
+}
+`;
+export const a3d_prd10_grass = {
+    name: "a3d_prd10_grass",
+    owner: "prd10",
+    stage: "vertex",
+    glsl,
+    wgsl
+};
+//# sourceMappingURL=grass.js.map

package/dist/world/vegetation/shaders/grass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grass.js","sourceRoot":"","sources":["../../../../../../../packages/rendering/src/world/vegetation/shaders/grass.ts"],"names":[],"mappings":"AASA,MAAM,IAAI,GAAG,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0CvB,CAAC;AAEF,MAAM,IAAI,GAAG,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BvB,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAgB;IAC1C,IAAI,EAAE,iBAAiB;IACvB,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,QAAQ;IACf,IAAI;IACJ,IAAI;CACL,CAAC"}

package/dist/world/vegetation/shaders/impostor.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `a3d_prd10_impostor` — PRD-10 §8.4 octahedral impostor fragment chunk.
+ * Hemi-octahedral 8x8 view mapping, 3-frame barycentric blend, per-frame
+ * parallax offset, alpha test and (High+) `gl_FragDepth` write. Vertex-side
+ * billboard math lands with the `prd10.impostor` feature wiring.
+ */
+import type { ShaderChunk } from "../../../contracts/program.js";
+export declare const a3d_prd10_impostor: ShaderChunk;
+//# sourceMappingURL=impostor.d.ts.map

package/dist/world/vegetation/shaders/impostor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"impostor.d.ts","sourceRoot":"","sources":["../../../../../../../packages/rendering/src/world/vegetation/shaders/impostor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AA6FjE,eAAO,MAAM,kBAAkB,EAAE,WAMhC,CAAC"}

package/dist/world/vegetation/shaders/impostor.js

@@ -0,0 +1,97 @@
+const glsl = /* glsl */ `
+uniform highp sampler2D u_impostorAlbedo;  // 8x8 atlas: albedo RGB + alpha A
+uniform highp sampler2D u_impostorNormalDepth; // 8x8 atlas: tile-space normal XY in RG, depth B, coverage A
+uniform float u_impostorGridDim;           // 8.0
+uniform float u_impostorParallax;          // parallax offset scale
+uniform float u_impostorAlphaCutoff;
+uniform float u_impostorWriteDepth;          // High+ only; Low skips for early-Z
+
+// World/view direction -> hemi-octahedral UV on the 8x8 grid.
+vec2 a3dOctahedralUV(vec3 dir) {
+  vec2 uv = dir.xz / (abs(dir.x) + abs(dir.z) + abs(dir.y));
+  if (dir.y < 0.0) {
+    vec2 s = vec2(uv.x >= 0.0 ? 1.0 : -1.0, uv.y >= 0.0 ? 1.0 : -1.0);
+    uv = (1.0 - abs(uv.yx)) * s;
+  }
+  return uv * 0.5 + 0.5; // [0,1]
+}
+
+// 3 nearest frames in grid space + barycentric weights for one view dir.
+// Frame (i, j) was baked from the direction at oct-UV ((i, j) + 0.5) / grid
+// (tools/impostor-bake impostorViewGrid), so the continuous frame coordinate
+// is octUv * grid - 0.5. The enclosing grid quad is split on its anti-diagonal
+// and the view is blended barycentrically across that triangle's 3 frames.
+void a3dImpostorFrames(vec2 octUv, out vec2 frameUV[3], out vec3 weights) {
+  float g = u_impostorGridDim;
+  vec2 grid = clamp(octUv * g - 0.5, vec2(0.0), vec2(g - 1.0));
+  vec2 cell = min(floor(grid), vec2(g - 2.0));
+  vec2 f = grid - cell;
+  if (f.x + f.y < 1.0) {
+    frameUV[0] = cell;
+    frameUV[1] = cell + vec2(1.0, 0.0);
+    frameUV[2] = cell + vec2(0.0, 1.0);
+    weights = vec3(1.0 - f.x - f.y, f.x, f.y);
+  } else {
+    frameUV[0] = cell + vec2(1.0, 1.0);
+    frameUV[1] = cell + vec2(0.0, 1.0);
+    frameUV[2] = cell + vec2(1.0, 0.0);
+    weights = vec3(f.x + f.y - 1.0, 1.0 - f.x, 1.0 - f.y);
+  }
+}
+
+// Atlas UV for frame f with local texel uv in [0,1].
+vec2 a3dImpostorAtlasUV(vec2 frame, vec2 uv) {
+  return (frame + uv) / u_impostorGridDim;
+}
+
+// Sample + blend the three frames; parallax per frame via the depth channel.
+vec4 a3dImpostorShade(vec2 octUv, vec2 localUv, vec2 frameViewDirXY[3], out vec3 outNormal, out float outDepth) {
+  vec2 frames[3]; vec3 w;
+  a3dImpostorFrames(octUv, frames, w);
+  vec4 albedo = vec4(0.0);
+  vec4 nd = vec4(0.0);
+  for (int i = 0; i < 3; i++) {
+    vec4 ndi = texture(u_impostorNormalDepth, a3dImpostorAtlasUV(frames[i], localUv));
+    vec2 parallaxUv = localUv + (ndi.z - 0.5) * frameViewDirXY[i] * u_impostorParallax;
+    albedo += w[i] * texture(u_impostorAlbedo, a3dImpostorAtlasUV(frames[i], parallaxUv));
+    nd += w[i] * ndi;
+  }
+  if (albedo.a < u_impostorAlphaCutoff) discard;
+  outNormal = vec3(nd.xy * 2.0 - 1.0, 0.0); // XY in impostor (tile) space; the caller reconstructs Z
+  outDepth = nd.z;
+  return albedo;
+}
+`;
+const wgsl = /* wgsl */ `
+@group(0) @binding(0) var u_impostorAlbedo : texture_2d<f32>;
+@group(0) @binding(1) var u_impostorNormalDepth : texture_2d<f32>;
+@group(0) @binding(2) var u_samp : sampler;
+struct A3dImpostorUniforms {
+  gridDim : f32,
+  parallax : f32,
+  alphaCutoff : f32,
+  writeDepth : i32,
+};
+@group(0) @binding(3) var<uniform> u_impostor : A3dImpostorUniforms;
+
+fn a3dOctahedralUV(dir : vec3f) -> vec2f {
+  var uv = dir.xz / (abs(dir.x) + abs(dir.z) + abs(dir.y));
+  if (dir.y < 0.0) {
+    let s = vec2f(sign(uv.x), sign(uv.y));
+    uv = (vec2f(1.0) - abs(uv.yx)) * s;
+  }
+  return uv * 0.5 + vec2f(0.5);
+}
+
+fn a3dImpostorAtlasUV(frame : vec2f, uv : vec2f) -> vec2f {
+  return (frame + uv) / u_impostor.gridDim;
+}
+`;
+export const a3d_prd10_impostor = {
+    name: "a3d_prd10_impostor",
+    owner: "prd10",
+    stage: "fragment",
+    glsl,
+    wgsl
+};
+//# sourceMappingURL=impostor.js.map

package/dist/world/vegetation/shaders/impostor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"impostor.js","sourceRoot":"","sources":["../../../../../../../packages/rendering/src/world/vegetation/shaders/impostor.ts"],"names":[],"mappings":"AAQA,MAAM,IAAI,GAAG,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+DvB,CAAC;AAEF,MAAM,IAAI,GAAG,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;CAwBvB,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAgB;IAC7C,IAAI,EAAE,oBAAoB;IAC1B,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,UAAU;IACjB,IAAI;IACJ,IAAI;CACL,CAAC"}

package/dist/world/vegetation/shaders/wind.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `a3d_prd10_wind` — PRD-10 §8.2 wind chunk (frozen C-26 `WIND_CHUNK`).
+ * Shared by foliage, grass and the depth pass (`prd10.wind` feature, hook
+ * `vertex:deform`). Length-preserving offset, quadratic-in-height bend.
+ */
+import type { ShaderChunk } from "../../../contracts/program.js";
+export declare const a3d_prd10_wind: ShaderChunk;
+export declare const a3d_prd10_wind_deform: ShaderChunk;
+//# sourceMappingURL=wind.d.ts.map

package/dist/world/vegetation/shaders/wind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wind.d.ts","sourceRoot":"","sources":["../../../../../../../packages/rendering/src/world/vegetation/shaders/wind.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAwDjE,eAAO,MAAM,cAAc,EAAE,WAM5B,CAAC;AAwCF,eAAO,MAAM,qBAAqB,EAAE,WAMnC,CAAC"}