@aura3d/rendering 3.0.1 → 4.0.2

package/dist/world/vegetation/FoliageMaterial.js

@@ -0,0 +1,107 @@
+import { registerMaterialLobe } from "../../contracts/materialLobes.js";
+import { a3d_prd10_foliage } from "./shaders/foliage.js";
+import { a3d_prd10_wind } from "./shaders/wind.js";
+const FOLIAGE_VERT = /* glsl */ `#version 300 es
+precision highp float;
+in vec3 a_position;
+in vec3 a_normal;
+in vec2 a_uv;
+in vec4 a_colorWeights;          // vertex colour wind weights (r bend, g flutter, b phase, a -)
+// compact32 instance record (yaw arrives normalized 0..1 from u16, scale from
+// a HALF_FLOAT attribute — GL converts both before the VS sees them)
+in vec3 a_instancePosition;
+in float a_instanceYaw;          // u16 unorm -> 0..1
+in float a_instanceScale;        // f16 -> f32
+in vec4 a_instanceVariation;     // unorm8x4 -> 0..1 per channel
+in vec4 a_instanceExtra;
+uniform mat4 u_viewProjection;
+uniform vec3 u_cameraPosition;
+uniform vec4 u_terrain;          // not used for foliage; keeps std layout
+uniform float u_time;
+uniform float u_assetHeight;
+uniform float u_lodFade;         // distance fade 0..1 (screen-door discard vs bayer)
+${a3d_prd10_wind.glsl}
+out vec3 v_worldPosition;
+out vec3 v_normal;
+out vec2 v_uv;
+out vec4 v_weights;
+out float v_variation;
+out float v_fade;
+void main() {
+  float yaw = a_instanceYaw * 6.28318530718;
+  float scale = a_instanceScale;
+  float cs = cos(yaw); float sn = sin(yaw);
+  vec3 local = vec3(a_position.x * cs + a_position.z * sn, a_position.y, -a_position.x * sn + a_position.z * cs) * scale;
+  vec3 world = local + a_instancePosition;
+  vec3 wind = a3dWindOffset(local, a_instancePosition, a_colorWeights, u_assetHeight);
+  world += wind;
+  vec3 n = normalize(vec3(a_normal.x * cs + a_normal.z * sn, a_normal.y, -a_normal.x * sn + a_normal.z * cs));
+  v_worldPosition = world;
+  v_normal = n;
+  v_uv = a_uv;
+  v_weights = a_colorWeights;
+  v_variation = a_instanceVariation.x;
+  v_fade = a_instanceVariation.y * u_lodFade;
+  gl_Position = u_viewProjection * vec4(world, 1.0);
+}
+`;
+const FOLIAGE_FRAG = /* glsl */ `#version 300 es
+precision highp float;
+in vec3 v_worldPosition;
+in vec3 v_normal;
+in vec2 v_uv;
+in vec4 v_weights;
+in float v_variation;
+in float v_fade;
+out vec4 o_color;
+uniform vec3 u_cameraPosition;
+uniform vec3 u_ambient;
+uniform vec3 u_keyLightDir;
+uniform vec3 u_keyLightColor;
+uniform vec3 u_translucencyColor;
+uniform float u_thickness;
+uniform float u_lod1Fade;        // 1 = keep, 0 = discard all (band fade)
+${a3d_prd10_foliage.glsl}
+void main() {
+  if (a3dBayer4x4(gl_FragCoord.xy) > v_fade * u_lod1Fade + 0.001) discard;
+  float alpha = a3dFoliageAlpha(v_uv);
+  vec3 n = a3dFoliageNormal(normalize(v_normal));
+  vec3 albedo = a3dInstanceVariation(texture(u_baseColor, v_uv).rgb, v_variation);
+  vec3 V = normalize(u_cameraPosition - v_worldPosition);
+  float ndl = max(dot(n, -u_keyLightDir), 0.0);
+  vec3 direct = albedo * (u_ambient + u_keyLightColor * ndl);
+  direct += a3dFoliageTranslucency(albedo, u_translucencyColor, u_thickness, V, u_keyLightDir, u_keyLightColor, 1.0);
+  o_color = vec4(direct, alpha);
+}
+`;
+/** Full sources for the standalone Path S foliage program. */
+export function foliageShaderSources() {
+    return {
+        label: "prd10-foliage",
+        marker: "prd10-foliage",
+        vertex: FOLIAGE_VERT,
+        fragment: FOLIAGE_FRAG
+    };
+}
+/** T3.4 — the C-03 lobe that adds the sun translucency term on Path G. */
+export function registerPrd10FoliageLobe() {
+    return registerMaterialLobe({
+        id: "prd10.foliageTranslucency",
+        owner: "prd10",
+        flag: "A3D_QR_WORLD",
+        chunks: { pars: "a3d_prd10_foliage", fragment: "a3d_prd10_foliage" },
+        samplerSlots: [],
+        feature(material) {
+            const translucency = material.parameters["translucencyColor"];
+            return translucency === undefined ? undefined : { lobe: "prd10.foliageTranslucency", maps: [], bits: { "prd10.foliageTranslucency": 1 } };
+        },
+        bind(material, set) {
+            const t = material.parameters["translucencyColor"];
+            if (t)
+                set("u_translucencyColor", [t[0] ?? 0, t[1] ?? 0, t[2] ?? 0]);
+            set("u_thickness", material.parameters["translucencyThickness"] ?? 1);
+            set("u_alphaCutoff", material.parameters["alphaCutoff"] ?? 0.5);
+        }
+    });
+}
+//# sourceMappingURL=FoliageMaterial.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FoliageMaterial.js","sourceRoot":"","sources":["../../../../../../packages/rendering/src/world/vegetation/FoliageMaterial.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,YAAY,GAAG,UAAU,CAAC;;;;;;;;;;;;;;;;;;;EAmB9B,cAAc,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;;CAwBpB,CAAC;AAEF,MAAM,YAAY,GAAG,UAAU,CAAC;;;;;;;;;;;;;;;;EAgB9B,iBAAiB,CAAC,IAAI;;;;;;;;;;;;CAYvB,CAAC;AAEF,8DAA8D;AAC9D,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,KAAK,EAAE,eAAe;QACtB,MAAM,EAAE,eAAe;QACvB,MAAM,EAAE,YAAY;QACpB,QAAQ,EAAE,YAAY;KACvB,CAAC;AACJ,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,wBAAwB;IACtC,OAAO,oBAAoB,CAAC;QAC1B,EAAE,EAAE,2BAA2B;QAC/B,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,mBAAmB,EAAE;QACpE,YAAY,EAAE,EAAE;QAChB,OAAO,CAAC,QAAQ;YACd,MAAM,YAAY,GAAG,QAAQ,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;YAC9D,OAAO,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,2BAA2B,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,2BAA2B,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5I,CAAC;QACD,IAAI,CAAC,QAAQ,EAAE,GAAG;YAChB,MAAM,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,mBAAmB,CAAkC,CAAC;YACpF,IAAI,CAAC;gBAAE,GAAG,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACrE,GAAG,CAAC,aAAa,EAAG,QAAQ,CAAC,UAAU,CAAC,uBAAuB,CAAwB,IAAI,CAAC,CAAC,CAAC;YAC9F,GAAG,CAAC,eAAe,EAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAwB,IAAI,GAAG,CAAC,CAAC;QAC1F,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,43 @@
+/**
+ * PRD-10 T3.7 §8.5 — `GrassField`: the camera-following ring of 8 m grass
+ * chunks. Blades are generated entirely in the vertex stage (§8.5
+ * `a3d_prd10_grass` — stratified jitter hash per `gl_InstanceID`, quadratic
+ * Bézier blade, density falloff); this module only computes which chunk
+ * origins + seeds draw this frame, and the shared blade index/vertex data.
+ *
+ * Tier rules (§7.1.5 grass options + §17):
+ * - Medium+ draws 7-vertex blades; Low draws 2-triangle cards with the same
+ *   placement hash.
+ * - The chunk ring extends to `radius`; chunks whose centre is farther than
+ *   `radius` from the camera are dropped before upload.
+ */
+export declare const GRASS_CHUNK_SIZE = 8;
+export declare const GRASS_BLADE_VERTS = 7;
+export declare const GRASS_CARD_VERTS = 4;
+export interface GrassChunkDraw {
+    /** world XZ of the chunk's min corner */
+    readonly originX: number;
+    readonly originZ: number;
+    readonly size: number;
+    readonly seed: number;
+    readonly bladeCount: number;
+}
+/**
+ * The chunk ring centred on `cameraXZ`: all GRASS_CHUNK_SIZE cells whose
+ * centre falls within `radius`. Deterministic order (sorted by key) so draw
+ * order and seeds are stable across frames.
+ */
+export declare function grassChunkRing(cameraXZ: readonly [number, number], radius: number, cellSize?: number): readonly GrassChunkDraw[];
+/**
+ * Shared blade vertex buffer for the blades path (7 verts per blade, drawn
+ * `TRIANGLE_STRIP` per instance — the VS maps `gl_VertexID` inside a blade):
+ * per vertex: [t, side] pairs (t 0..1 root→tip; side −1/+1; final tip vertex
+ * has side 0). Per-instance data comes from the chunk uniform + instance id,
+ * not vertex attributes.
+ */
+export declare function grassBladeVertices(): Float32Array;
+/** Strip → triangles (device topologies are triangles/lines/points only). */
+export declare function grassBladeIndices(): Uint16Array;
+/** 2-triangle card for Low tier (quad in [-1,1] x [0,1]). */
+export declare function grassCardVertices(): Float32Array;
+//# sourceMappingURL=GrassField.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GrassField.d.ts","sourceRoot":"","sources":["../../../../../../packages/rendering/src/world/vegetation/GrassField.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAmB,GAAG,SAAS,cAAc,EAAE,CAwB1I;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CAGjD;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,IAAI,WAAW,CAE/C;AAED,6DAA6D;AAC7D,wBAAgB,iBAAiB,IAAI,YAAY,CAEhD"}

package/dist/world/vegetation/GrassField.js

@@ -0,0 +1,68 @@
+/**
+ * PRD-10 T3.7 §8.5 — `GrassField`: the camera-following ring of 8 m grass
+ * chunks. Blades are generated entirely in the vertex stage (§8.5
+ * `a3d_prd10_grass` — stratified jitter hash per `gl_InstanceID`, quadratic
+ * Bézier blade, density falloff); this module only computes which chunk
+ * origins + seeds draw this frame, and the shared blade index/vertex data.
+ *
+ * Tier rules (§7.1.5 grass options + §17):
+ * - Medium+ draws 7-vertex blades; Low draws 2-triangle cards with the same
+ *   placement hash.
+ * - The chunk ring extends to `radius`; chunks whose centre is farther than
+ *   `radius` from the camera are dropped before upload.
+ */
+export const GRASS_CHUNK_SIZE = 8;
+export const GRASS_BLADE_VERTS = 7; // quadratic Bézier strips: root L/R, mid L/R, tip L/R + tip
+export const GRASS_CARD_VERTS = 4;
+/**
+ * The chunk ring centred on `cameraXZ`: all GRASS_CHUNK_SIZE cells whose
+ * centre falls within `radius`. Deterministic order (sorted by key) so draw
+ * order and seeds are stable across frames.
+ */
+export function grassChunkRing(cameraXZ, radius, cellSize = GRASS_CHUNK_SIZE) {
+    if (radius <= 0)
+        return [];
+    const cx0 = Math.floor((cameraXZ[0] - radius) / cellSize);
+    const cx1 = Math.floor((cameraXZ[0] + radius) / cellSize);
+    const cz0 = Math.floor((cameraXZ[1] - radius) / cellSize);
+    const cz1 = Math.floor((cameraXZ[1] + radius) / cellSize);
+    const out = [];
+    for (let cz = cz0; cz <= cz1; cz += 1) {
+        for (let cx = cx0; cx <= cx1; cx += 1) {
+            const ox = cx * cellSize;
+            const oz = cz * cellSize;
+            const d = Math.hypot(ox + cellSize / 2 - cameraXZ[0], oz + cellSize / 2 - cameraXZ[1]);
+            if (d > radius)
+                continue;
+            out.push({
+                originX: ox,
+                originZ: oz,
+                size: cellSize,
+                seed: (((cx * 73856093) ^ (cz * 19349663)) >>> 0) % 4096,
+                bladeCount: Math.min(1024, Math.round(cellSize * cellSize)) // density applied by the caller via bladeCount scale
+            });
+        }
+    }
+    out.sort((a, b) => a.originZ - b.originZ || a.originX - b.originX);
+    return out;
+}
+/**
+ * Shared blade vertex buffer for the blades path (7 verts per blade, drawn
+ * `TRIANGLE_STRIP` per instance — the VS maps `gl_VertexID` inside a blade):
+ * per vertex: [t, side] pairs (t 0..1 root→tip; side −1/+1; final tip vertex
+ * has side 0). Per-instance data comes from the chunk uniform + instance id,
+ * not vertex attributes.
+ */
+export function grassBladeVertices() {
+    // 7 verts: [t, side] = (0,-1),(0,1),(0.5,-1),(0.5,1),(0.8,-1),(0.8,1),(1,0 tip)
+    return Float32Array.from([0, -1, 0, 1, 0.5, -1, 0.5, 1, 0.8, -1, 0.8, 1, 1, 0]);
+}
+/** Strip → triangles (device topologies are triangles/lines/points only). */
+export function grassBladeIndices() {
+    return Uint16Array.from([0, 1, 2, 2, 1, 3, 2, 3, 4, 4, 3, 5, 4, 5, 6]);
+}
+/** 2-triangle card for Low tier (quad in [-1,1] x [0,1]). */
+export function grassCardVertices() {
+    return Float32Array.from([-1, 0, 1, 0, -1, 1, 1, 1]);
+}
+//# sourceMappingURL=GrassField.js.map

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

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

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

@@ -0,0 +1,20 @@
+/**
+ * PRD-10 T3.5 §8.4 — octahedral-impostor program for the far LOD band. The
+ * vertex stage builds a camera-facing (Y-up cylindrical) billboard at the
+ * instance's bounding-sphere centre, maps the object-space view direction
+ * onto the hemi-octahedral grid (`v_octUv`) and passes the billboard-local UV.
+ * The fragment stage is the registered `a3d_prd10_impostor` chunk: it picks
+ * the 3 nearest baked frames, blends them barycentrically with per-frame
+ * parallax, alpha-tests, and (High+) writes `gl_FragDepth` from the depth
+ * channel. The far-band crossfade uses the `a3d_prd10_foliage` Bayer dither.
+ *
+ * Bake contract (tools/impostor-bake): frame (i, j) is an orthographic view
+ * from `impostorViewGrid` direction j*grid+i, basis right = normalize(cross(Y,
+ * horizontal view)), up = cross(view, right), clip x/y = dot(p - centre,
+ * right/up) / radius — the same basis this billboard spans, so tile UV (0..1)
+ * maps 1:1 onto `a_position * 0.5 + 0.5`.
+ */
+import type { ShaderSources } from "../../RenderDevice.js";
+/** Full sources for the standalone Path S impostor program. */
+export declare function impostorShaderSources(): ShaderSources;
+//# sourceMappingURL=ImpostorMaterial.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ImpostorMaterial.d.ts","sourceRoot":"","sources":["../../../../../../packages/rendering/src/world/vegetation/ImpostorMaterial.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AA0E3D,+DAA+D;AAC/D,wBAAgB,qBAAqB,IAAI,aAAa,CAOrD"}

package/dist/world/vegetation/ImpostorMaterial.js

@@ -0,0 +1,80 @@
+import { a3d_prd10_impostor } from "./shaders/impostor.js";
+import { a3d_prd10_foliage } from "./shaders/foliage.js"; // bayer4x4 crossfade
+const IMPOSTOR_VERT = /* glsl */ `#version 300 es
+precision highp float;
+// billboard quad in [-1,1]
+in vec2 a_position;
+in vec3 a_instancePosition;      // bounding-sphere centre (world)
+in float a_instanceScale;
+in float a_instanceYaw;          // unorm 0..1
+uniform mat4 u_viewProjection;
+uniform vec3 u_cameraPosition;
+uniform float u_impostorRadius;  // bounding-sphere radius at scale 1
+uniform vec3 u_lodDistances;     // lod1, impostor, cull
+out vec2 v_octUv;
+out vec2 v_localUv;
+out float v_fade;
+
+// hemi-octahedral encode (lower hemisphere folded up) — matches impostorViewGrid
+vec2 a3dImpostorOctUv(vec3 dirObj) {
+  dirObj.y = abs(dirObj.y);
+  return dirObj.xz / (abs(dirObj.x) + dirObj.y + abs(dirObj.z)) * 0.5 + 0.5;
+}
+
+void main() {
+  vec3 center = a_instancePosition;
+  float radius = u_impostorRadius * a_instanceScale;
+  // object-space view dir (undo yaw about +Y)
+  float yaw = a_instanceYaw * 6.28318530718;
+  float cy = cos(-yaw); float sy = sin(-yaw);
+  vec3 viewWorld = u_cameraPosition - center;
+  vec3 viewObj = vec3(viewWorld.x * cy + viewWorld.z * sy, viewWorld.y, -viewWorld.x * sy + viewWorld.z * cy);
+  v_octUv = a3dImpostorOctUv(normalize(viewObj));
+  v_localUv = a_position * 0.5 + 0.5;
+  // camera-facing cylindrical billboard (same right/up the bake used)
+  vec3 horiz = vec3(viewWorld.x, 0.0, viewWorld.z);
+  vec3 fwd = dot(horiz, horiz) > 1e-12 ? normalize(horiz) : vec3(0.0, 0.0, 1.0);
+  vec3 right = normalize(cross(vec3(0.0, 1.0, 0.0), fwd));
+  vec3 up = cross(fwd, right);
+  vec3 world = center + right * a_position.x * radius + up * a_position.y * radius;
+  float d = length(viewWorld);
+  v_fade = 1.0 - smoothstep(u_lodDistances.z * 0.9, u_lodDistances.z, d);
+  gl_Position = u_viewProjection * vec4(world, 1.0);
+}
+`;
+const IMPOSTOR_FRAG = /* glsl */ `#version 300 es
+precision highp float;
+in vec2 v_octUv;
+in vec2 v_localUv;
+in float v_fade;
+out vec4 o_color;
+${a3d_prd10_foliage.glsl}
+${a3d_prd10_impostor.glsl}
+void main() {
+  if (a3dBayer4x4(gl_FragCoord.xy) > v_fade) discard;
+  // per-frame parallax direction: the view's offset from each frame in grid space
+  vec2 frames[3]; vec3 w;
+  a3dImpostorFrames(v_octUv, frames, w);
+  vec2 g = v_octUv * u_impostorGridDim - 0.5;
+  vec2 parallax[3];
+  for (int i = 0; i < 3; i++) parallax[i] = (g - frames[i]) / u_impostorGridDim;
+  vec3 nXY; float depth;
+  vec4 albedo = a3dImpostorShade(v_octUv, v_localUv, parallax, nXY, depth);
+  vec3 n = vec3(nXY.xy, sqrt(max(1.0 - dot(nXY.xy, nXY.xy), 0.0)));
+  o_color = vec4(albedo.rgb * max(dot(n, normalize(vec3(0.4, 0.8, 0.3))), 0.2), 1.0);
+  // statically assigned on every path (GLSL ES 3.0): pass-through unless High+
+  gl_FragDepth = u_impostorWriteDepth > 0.5
+    ? clamp(gl_FragCoord.z - (depth - 0.5) * 0.02, 0.0, 1.0)
+    : gl_FragCoord.z;
+}
+`;
+/** Full sources for the standalone Path S impostor program. */
+export function impostorShaderSources() {
+    return {
+        label: "prd10-impostor",
+        marker: "prd10-impostor",
+        vertex: IMPOSTOR_VERT,
+        fragment: IMPOSTOR_FRAG
+    };
+}
+//# sourceMappingURL=ImpostorMaterial.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ImpostorMaterial.js","sourceRoot":"","sources":["../../../../../../packages/rendering/src/world/vegetation/ImpostorMaterial.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC,CAAC,qBAAqB;AAE/E,MAAM,aAAa,GAAG,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyChC,CAAC;AAEF,MAAM,aAAa,GAAG,UAAU,CAAC;;;;;;EAM/B,iBAAiB,CAAC,IAAI;EACtB,kBAAkB,CAAC,IAAI;;;;;;;;;;;;;;;;;;CAkBxB,CAAC;AAEF,+DAA+D;AAC/D,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,KAAK,EAAE,gBAAgB;QACvB,MAAM,EAAE,gBAAgB;QACxB,MAAM,EAAE,aAAa;QACrB,QAAQ,EAAE,aAAa;KACxB,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,67 @@
+/**
+ * PRD-10 T3.1 §9.3 — instanced-draw chunk grid for world content. Instances
+ * are grouped into `cellSize` (32 m) cells, packed once into ONE static vertex
+ * buffer (`createBuffer("vertex", …)` at load; kept until scene teardown —
+ * bypasses the per-frame allocation and VAO leak of the generic path, V5/V6),
+ * and each cell records its byte range so a draw can emulate `firstInstance`
+ * via attribute offset `rangeStart * stride`.
+ *
+ * Two layouts (§9.3):
+ * - `compact32` (32 B stride): vec3 position + f32 yawScalePacked + unorm8x4
+ *   variation (colorVariation, lodFade, windPhase, reserved) + vec4 extra
+ *   unorm8x4, tail-padded to 32 B. Yaw+uniform-scale rebuild the matrix in VS.
+ * - `matrix48` (48 B stride): row-major mat3x4 — kits and explicit placements.
+ *
+ * Per-cell AABB includes the placement extents plus `maxWindSway` when the
+ * instances wind-deform (C-26 `a3d_prd10_wind`).
+ */
+import type { RenderDevice, RenderBuffer } from "../../RenderDevice.js";
+export type InstanceChunkLayout = "compact32" | "matrix48";
+export declare const INSTANCE_STRIDE_COMPACT32 = 32;
+export declare const INSTANCE_STRIDE_MATRIX48 = 48;
+export interface CompactInstance {
+    readonly position: readonly [number, number, number];
+    readonly yawDeg: number;
+    readonly scale: number;
+    /** [colorVariation, lodFade, windPhase, reserved] each 0..1. */
+    readonly variation: readonly [number, number, number, number];
+    readonly extra?: readonly [number, number, number, number];
+}
+export interface InstanceChunkCell {
+    readonly cellX: number;
+    readonly cellZ: number;
+    /** First instance in the shared buffer (instances are tightly packed). */
+    readonly rangeStart: number;
+    readonly count: number;
+    /** Byte offset into the instance buffer = rangeStart * stride. */
+    readonly byteOffset: number;
+    /** World AABB, min/max, including wind sway + instance local bounds. */
+    readonly aabb: Float32Array;
+}
+export interface InstanceChunkGridSpec {
+    readonly layout: InstanceChunkLayout;
+    /** World-space cell side; §9.3 default 32 m. */
+    readonly cellSize?: number;
+    /** Per-instance local Y extent [minY, maxY] * max scale for the AABB. */
+    readonly localHeight?: readonly [number, number];
+    /** Extra radial/Y margin for wind-deformed instances (metres). */
+    readonly maxWindSway?: number;
+    readonly instances: readonly CompactInstance[] | readonly Float32Array[];
+}
+export declare class InstanceChunkGrid {
+    readonly layout: InstanceChunkLayout;
+    readonly cellSize: number;
+    readonly stride: number;
+    readonly cells: readonly InstanceChunkCell[];
+    /** Packed instance bytes (layout-dependent stride). */
+    readonly data: ArrayBuffer;
+    readonly instanceCount: number;
+    private buffer;
+    constructor(spec: InstanceChunkGridSpec);
+    /** Upload once per world item; the returned buffer lives until `dispose()`. */
+    upload(device: RenderDevice): RenderBuffer;
+    /** Cells whose AABB passes a frustum test (plane array: [nx,ny,nz,d]). */
+    cull(frustumPlanes: readonly (readonly [number, number, number, number])[]): InstanceChunkCell[];
+    dispose(): void;
+}
+//# sourceMappingURL=InstanceChunkGrid.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"InstanceChunkGrid.d.ts","sourceRoot":"","sources":["../../../../../../packages/rendering/src/world/vegetation/InstanceChunkGrid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AA4BxE,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,UAAU,CAAC;AAE3D,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAC5C,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACrD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9D,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,wEAAwE;IACxE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,yEAAyE;IACzE,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,kEAAkE;IAClE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,SAAS,eAAe,EAAE,GAAG,SAAS,YAAY,EAAE,CAAC;CAC1E;AAED,qBAAa,iBAAiB;IAC5B,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC7C,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,OAAO,CAAC,MAAM,CAA6B;gBAE/B,IAAI,EAAE,qBAAqB;IA0EvC,+EAA+E;IAC/E,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY;IAO1C,0EAA0E;IAC1E,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,GAAG,iBAAiB,EAAE;IAehG,OAAO,IAAI,IAAI;CAIhB"}

package/dist/world/vegetation/InstanceChunkGrid.js

@@ -0,0 +1,150 @@
+/** IEEE-754 half packer — DataView.setFloat16 is too new to assume on CI browsers. */
+function writeFloat16(dv, byteOffset, value) {
+    const f32 = new Float32Array(1);
+    f32[0] = value;
+    const b = new DataView(f32.buffer).getUint32(0, true);
+    const sign = (b >>> 31) & 1;
+    let exp = (b >>> 23) & 0xff;
+    let frac = b & 0x7fffff;
+    if (exp === 255) {
+        dv.setUint16(byteOffset, sign << 15 | (frac ? 0x7e00 : 0x7c00), true); // inf/nan
+        return;
+    }
+    exp = exp - 127 + 15;
+    if (exp >= 0x1f) {
+        dv.setUint16(byteOffset, sign << 15 | 0x7c00, true); // overflow -> inf
+        return;
+    }
+    if (exp <= 0) {
+        // subnormal/zero
+        frac = (frac | 0x800000) >> (1 - exp);
+        dv.setUint16(byteOffset, sign << 15 | (frac >> 13), true);
+        return;
+    }
+    dv.setUint16(byteOffset, sign << 15 | (exp << 10) | (frac >> 13), true);
+}
+export const INSTANCE_STRIDE_COMPACT32 = 32;
+export const INSTANCE_STRIDE_MATRIX48 = 48;
+export class InstanceChunkGrid {
+    layout;
+    cellSize;
+    stride;
+    cells;
+    /** Packed instance bytes (layout-dependent stride). */
+    data;
+    instanceCount;
+    buffer = null;
+    constructor(spec) {
+        this.layout = spec.layout;
+        this.cellSize = spec.cellSize ?? 32;
+        this.stride = spec.layout === "compact32" ? INSTANCE_STRIDE_COMPACT32 : INSTANCE_STRIDE_MATRIX48;
+        const sway = spec.maxWindSway ?? 0;
+        const localH = spec.localHeight ?? [0, 0];
+        const groups = new Map();
+        const list = spec.instances;
+        for (let i = 0; i < list.length; i += 1) {
+            const inst = list[i];
+            const [x, , z] = spec.layout === "compact32"
+                ? [inst.position[0], 0, inst.position[2]]
+                : [inst[3], 0, inst[11]]; // row-major mat3x4 translation
+            const key = `${Math.floor(x / this.cellSize)},${Math.floor(z / this.cellSize)}`;
+            let g = groups.get(key);
+            if (!g)
+                groups.set(key, (g = []));
+            g.push(i);
+        }
+        const keys = [...groups.keys()].sort();
+        this.data = new ArrayBuffer(list.length * this.stride);
+        const dv = new DataView(this.data);
+        const cells = [];
+        let cursor = 0;
+        for (const key of keys) {
+            const idx = groups.get(key);
+            const rangeStart = cursor;
+            let minX = Infinity;
+            let minY = Infinity;
+            let minZ = Infinity;
+            let maxX = -Infinity;
+            let maxY = -Infinity;
+            let maxZ = -Infinity;
+            for (const i of idx) {
+                let px;
+                let py;
+                let pz;
+                let scale = 1;
+                if (this.layout === "compact32") {
+                    const inst = list[i];
+                    [px, py, pz] = inst.position;
+                    scale = inst.scale;
+                    const off = cursor * this.stride;
+                    dv.setFloat32(off + 0, px, true);
+                    dv.setFloat32(off + 4, py, true);
+                    dv.setFloat32(off + 8, pz, true);
+                    // yaw packed as unorm16 [0..360) and scale as float16 in one u32.
+                    const yawU16 = Math.round((((inst.yawDeg % 360) + 360) % 360) / 360 * 65535) & 0xffff;
+                    dv.setUint16(off + 12, yawU16, true);
+                    writeFloat16(dv, off + 14, inst.scale);
+                    for (let k = 0; k < 4; k += 1) {
+                        dv.setUint8(off + 16 + k, Math.round(Math.min(1, Math.max(0, inst.variation[k] ?? 0)) * 255));
+                        dv.setUint8(off + 20 + k, Math.round(Math.min(1, Math.max(0, inst.extra?.[k] ?? 0)) * 255));
+                    }
+                }
+                else {
+                    const m = list[i]; // 12 floats, row-major 3x4
+                    px = m[3];
+                    py = m[7];
+                    pz = m[11];
+                    const off = cursor * this.stride;
+                    for (let k = 0; k < 12; k += 1)
+                        dv.setFloat32(off + k * 4, m[k], true);
+                }
+                minX = Math.min(minX, px - sway);
+                maxX = Math.max(maxX, px + sway);
+                minZ = Math.min(minZ, pz - sway);
+                maxZ = Math.max(maxZ, pz + sway);
+                minY = Math.min(minY, py + localH[0] * scale);
+                maxY = Math.max(maxY, py + localH[1] * scale);
+                cursor += 1;
+            }
+            const [cx, cz] = key.split(",").map(Number);
+            cells.push({
+                cellX: cx,
+                cellZ: cz,
+                rangeStart,
+                count: idx.length,
+                byteOffset: rangeStart * this.stride,
+                aabb: Float32Array.from([minX, minY, minZ, maxX, maxY, maxZ])
+            });
+        }
+        this.cells = cells;
+        this.instanceCount = list.length;
+    }
+    /** Upload once per world item; the returned buffer lives until `dispose()`. */
+    upload(device) {
+        if (!this.buffer) {
+            this.buffer = device.createBuffer("vertex", this.data.byteLength, new Uint8Array(this.data));
+        }
+        return this.buffer;
+    }
+    /** Cells whose AABB passes a frustum test (plane array: [nx,ny,nz,d]). */
+    cull(frustumPlanes) {
+        const out = [];
+        outer: for (const cell of this.cells) {
+            const a = cell.aabb;
+            for (const [nx, ny, nz, d] of frustumPlanes) {
+                const px = nx >= 0 ? a[3] : a[0];
+                const py = ny >= 0 ? a[4] : a[1];
+                const pz = nz >= 0 ? a[5] : a[2];
+                if (nx * px + ny * py + nz * pz + d < 0)
+                    continue outer;
+            }
+            out.push(cell);
+        }
+        return out;
+    }
+    dispose() {
+        this.buffer?.dispose();
+        this.buffer = null;
+    }
+}
+//# sourceMappingURL=InstanceChunkGrid.js.map

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

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

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

@@ -0,0 +1,19 @@
+/**
+ * PRD-10 S7 — CPU reference twin of the `a3d_prd10_wind` GLSL/WGSL chunk
+ * (`shaders/wind.ts`). Same formula, op for op, so the browser parity spec
+ * (`tests/browser/qr-prd10-wind-chunk.spec.ts`) can hold the GPU result to
+ * ≤ 1e-4 and CPU-side systems (picking, bounds) can predict the bend.
+ *
+ * `gustSample` is the value the shader reads from `u_windNoise` (.r, 0..1) at
+ * the instance's gust UV; the caller supplies it, so the twin stays
+ * independent of texture filtering.
+ */
+export type WindVec3 = readonly [number, number, number];
+export type WindVec4 = readonly [number, number, number, number];
+/**
+ * `ubo` is the packed A3DWind block from `packWindUbo`:
+ * [dir.x, dir.z, strength, time, gustStrength, 1/gustScale, -, -].
+ * Returns the length-preserving offset (bent − localPos).
+ */
+export declare function windOffsetCpu(ubo: ArrayLike<number>, localPos: WindVec3, instanceOrigin: WindVec3, weights: WindVec4, assetHeight: number, gustSample: number): [number, number, number];
+//# sourceMappingURL=WindCpu.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WindCpu.d.ts","sourceRoot":"","sources":["../../../../../../packages/rendering/src/world/vegetation/WindCpu.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AACzD,MAAM,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAIjE;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,SAAS,CAAC,MAAM,CAAC,EACtB,QAAQ,EAAE,QAAQ,EAClB,cAAc,EAAE,QAAQ,EACxB,OAAO,EAAE,QAAQ,EACjB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CA0B1B"}

package/dist/world/vegetation/WindCpu.js

@@ -0,0 +1,43 @@
+/**
+ * PRD-10 S7 — CPU reference twin of the `a3d_prd10_wind` GLSL/WGSL chunk
+ * (`shaders/wind.ts`). Same formula, op for op, so the browser parity spec
+ * (`tests/browser/qr-prd10-wind-chunk.spec.ts`) can hold the GPU result to
+ * ≤ 1e-4 and CPU-side systems (picking, bounds) can predict the bend.
+ *
+ * `gustSample` is the value the shader reads from `u_windNoise` (.r, 0..1) at
+ * the instance's gust UV; the caller supplies it, so the twin stays
+ * independent of texture filtering.
+ */
+const clamp01 = (v) => Math.min(1, Math.max(0, v));
+/**
+ * `ubo` is the packed A3DWind block from `packWindUbo`:
+ * [dir.x, dir.z, strength, time, gustStrength, 1/gustScale, -, -].
+ * Returns the length-preserving offset (bent − localPos).
+ */
+export function windOffsetCpu(ubo, localPos, instanceOrigin, weights, assetHeight, gustSample) {
+    const dirX = ubo[0];
+    const dirY = ubo[1];
+    const strength = ubo[2];
+    const t = ubo[3];
+    const gust = gustSample * ubo[4];
+    const h = clamp01(localPos[1] / Math.max(assetHeight, 0.01));
+    const bend = (strength + gust) * h * h * weights[0];
+    const sway = Math.sin(t * (1.1 + weights[2]) + (instanceOrigin[0] * 0.37 + instanceOrigin[2] * 0.71)) * 0.25 * strength * weights[0];
+    const k = (bend + sway) * 0.35 * assetHeight;
+    let ox = dirX * k;
+    let oy = 0;
+    let oz = dirY * k;
+    const flutter = Math.sin(t * 7.3 + weights[2] * 6.2831 + (localPos[0] * 2.1 + localPos[1] * 1.7 + localPos[2] * 2.9)) * 0.035 * (strength + gust) * weights[1];
+    ox += flutter;
+    oy += flutter * 0.4;
+    oz += -flutter;
+    const bx = localPos[0] + ox;
+    const by = localPos[1] + oy;
+    const bz = localPos[2] + oz;
+    const bentLen = Math.hypot(bx, by, bz);
+    const len = Math.hypot(localPos[0], localPos[1], localPos[2]);
+    // GLSL normalize(0) is undefined; the chunk is only fed non-root vertices.
+    const s = bentLen > 0 ? len / bentLen : 0;
+    return [bx * s - localPos[0], by * s - localPos[1], bz * s - localPos[2]];
+}
+//# sourceMappingURL=WindCpu.js.map