@aura3d/rendering 3.0.1 → 4.0.2

package/dist/WebGPUSkinningLimits.d.ts

@@ -21,12 +21,19 @@ export type SkinningCpuFallbackReason =
 "none-uniform-array"
 /** Joint count exceeds the uniform array but fits the data-texture palette path. */
  | "none-data-texture"
+/** T1.12 — the program includes `a3d_prd06_skinning_common`; the bone texture carries the palette. */
+ | "none-bone-texture"
+/** T1.12 — a bone-texture program whose joint count exceeds even the cache ceiling. */
+ | "joint-count-exceeds-bone-texture-limit"
 /** Joint count exceeds even the data-texture ceiling — CPU skinning is the only option. */
  | "joint-count-exceeds-data-texture-limit"
 /** The shader has no data-texture palette uniforms, so palettes above the uniform cap fall back. */
  | "shader-lacks-data-texture-palette"
 /** No joint-palette uniforms at all on this shader — CPU skinning is the only option. */
- | "shader-lacks-skinning-uniforms";
+ | "shader-lacks-skinning-uniforms"
+/** The skinning geometry contract failed (unweighted/non-normalized weights, bad
+ *  joint indices): the item draws unskinned rather than aborting the pass. */
+ | "skinning-geometry-contract";
 export interface SkinningPaletteDecision {
     readonly jointCount: number;
     /** `"uniform-array"` | `"data-texture"` — the GPU upload path, or `"cpu"` when neither fits. */
@@ -50,5 +57,7 @@ export declare function decideSkinningPalettePath(options: {
     readonly maxDataTextureJoints?: number;
     readonly shaderHasDataTexturePalette?: boolean;
     readonly shaderHasSkinningUniforms?: boolean;
+    /** T1.12 — program includes `a3d_prd06_skinning_common` (`u_boneTexture`). */
+    readonly shaderHasBoneTexture?: boolean;
 }): SkinningPaletteDecision;
 //# sourceMappingURL=WebGPUSkinningLimits.d.ts.map

package/dist/WebGPUSkinningLimits.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WebGPUSkinningLimits.d.ts","sourceRoot":"","sources":["../../../../packages/rendering/src/WebGPUSkinningLimits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,yGAAyG;AACzG,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAE7C;;;;GAIG;AACH,MAAM,MAAM,yBAAyB;AACnC,gEAAgE;AAC9D,oBAAoB;AACtB,oFAAoF;GAClF,mBAAmB;AACrB,2FAA2F;GACzF,wCAAwC;AAC1C,oGAAoG;GAClG,mCAAmC;AACrC,yFAAyF;GACvF,gCAAgC,CAAC;AAErC,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,gGAAgG;IAChG,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,cAAc,GAAG,KAAK,CAAC;IACxD,QAAQ,CAAC,MAAM,EAAE,yBAAyB,CAAC;IAC3C,oFAAoF;IACpF,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,2BAA2B,CAAC,EAAE,OAAO,CAAC;IAC/C,QAAQ,CAAC,yBAAyB,CAAC,EAAE,OAAO,CAAC;CAC9C,GAAG,uBAAuB,CAsB1B"}
+{"version":3,"file":"WebGPUSkinningLimits.d.ts","sourceRoot":"","sources":["../../../../packages/rendering/src/WebGPUSkinningLimits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,yGAAyG;AACzG,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAI7C;;;;GAIG;AACH,MAAM,MAAM,yBAAyB;AACnC,gEAAgE;AAC9D,oBAAoB;AACtB,oFAAoF;GAClF,mBAAmB;AACrB,sGAAsG;GACpG,mBAAmB;AACrB,uFAAuF;GACrF,wCAAwC;AAC1C,2FAA2F;GACzF,wCAAwC;AAC1C,oGAAoG;GAClG,mCAAmC;AACrC,yFAAyF;GACvF,gCAAgC;AAClC;8EAC8E;GAC5E,4BAA4B,CAAC;AAEjC,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,gGAAgG;IAChG,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,cAAc,GAAG,KAAK,CAAC;IACxD,QAAQ,CAAC,MAAM,EAAE,yBAAyB,CAAC;IAC3C,oFAAoF;IACpF,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,2BAA2B,CAAC,EAAE,OAAO,CAAC;IAC/C,QAAQ,CAAC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IAC7C,8EAA8E;IAC9E,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;CACzC,GAAG,uBAAuB,CAmC1B"}

package/dist/WebGPUSkinningLimits.js

@@ -11,6 +11,7 @@
  */
 /** Joint-palette capacity of the WebGPU skinning path — parity with the WebGL2 `u_jointMatrices[96]`. */
 export const MAX_WEBGPU_SKINNING_JOINTS = 96;
+import { MAX_SKINNING_JOINTS } from "./ForwardPass.js";
 /**
  * Decide the joint-palette upload path for a skinned mesh without touching the GPU.
  * Pure and deterministic: same inputs always produce the same decision, so diagnostics
@@ -26,9 +27,22 @@ export function decideSkinningPalettePath(options) {
         throw new Error("decideSkinningPalettePath jointCount must be a non-negative integer.");
     }
     const maxUniformJoints = options.maxUniformJoints ?? MAX_WEBGPU_SKINNING_JOINTS;
-    const maxDataTextureJoints = options.maxDataTextureJoints ?? MAX_WEBGPU_SKINNING_JOINTS;
+    // T2.7 (PRD-06): the data-texture/storage palette ceiling defaults to the
+    // renderer-wide `MAX_SKINNING_JOINTS` (1024) — the 06 bone-texture/storage
+    // path carries every rig up to the cache ceiling, not the 96-joint uniform
+    // parity bound. Callers may still pin a smaller device cap explicitly.
+    const maxDataTextureJoints = options.maxDataTextureJoints ?? MAX_SKINNING_JOINTS;
     const shaderHasSkinningUniforms = options.shaderHasSkinningUniforms ?? true;
     const shaderHasDataTexturePalette = options.shaderHasDataTexturePalette ?? true;
+    const shaderHasBoneTexture = options.shaderHasBoneTexture ?? false;
+    // T1.12: the `a3d_prd06_skinning_common` program has no u_jointMatrices/
+    // u_jointPaletteMode — the cached bone texture carries the palette for every
+    // joint count up to the data-texture limit.
+    if (shaderHasBoneTexture) {
+        return jointCount <= maxDataTextureJoints
+            ? { jointCount, path: "data-texture", reason: "none-bone-texture", cpuFallback: false }
+            : { jointCount, path: "cpu", reason: "joint-count-exceeds-bone-texture-limit", cpuFallback: true };
+    }
     if (jointCount <= maxUniformJoints && shaderHasSkinningUniforms) {
         return { jointCount, path: "uniform-array", reason: "none-uniform-array", cpuFallback: false };
     }

package/dist/WebGPUSkinningLimits.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebGPUSkinningLimits.js","sourceRoot":"","sources":["../../../../packages/rendering/src/WebGPUSkinningLimits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,yGAAyG;AACzG,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,CAAC;AA4B7C;;;;;;;;GAQG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAMzC;IACC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACtC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;IAC1F,CAAC;IACD,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,0BAA0B,CAAC;IAChF,MAAM,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,IAAI,0BAA0B,CAAC;IACxF,MAAM,yBAAyB,GAAG,OAAO,CAAC,yBAAyB,IAAI,IAAI,CAAC;IAC5E,MAAM,2BAA2B,GAAG,OAAO,CAAC,2BAA2B,IAAI,IAAI,CAAC;IAChF,IAAI,UAAU,IAAI,gBAAgB,IAAI,yBAAyB,EAAE,CAAC;QAChE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,oBAAoB,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IACjG,CAAC;IACD,IAAI,CAAC,yBAAyB,EAAE,CAAC;QAC/B,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,gCAAgC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAClG,CAAC;IACD,IAAI,UAAU,IAAI,oBAAoB,IAAI,2BAA2B,EAAE,CAAC;QACtE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,mBAAmB,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAC/F,CAAC;IACD,IAAI,CAAC,2BAA2B,EAAE,CAAC;QACjC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,mCAAmC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IACrG,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,wCAAwC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;AAC1G,CAAC"}
+{"version":3,"file":"WebGPUSkinningLimits.js","sourceRoot":"","sources":["../../../../packages/rendering/src/WebGPUSkinningLimits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,yGAAyG;AACzG,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,CAAC;AAE7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAmCvD;;;;;;;;GAQG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAQzC;IACC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACtC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;IAC1F,CAAC;IACD,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,0BAA0B,CAAC;IAChF,0EAA0E;IAC1E,2EAA2E;IAC3E,2EAA2E;IAC3E,uEAAuE;IACvE,MAAM,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,IAAI,mBAAmB,CAAC;IACjF,MAAM,yBAAyB,GAAG,OAAO,CAAC,yBAAyB,IAAI,IAAI,CAAC;IAC5E,MAAM,2BAA2B,GAAG,OAAO,CAAC,2BAA2B,IAAI,IAAI,CAAC;IAChF,MAAM,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,IAAI,KAAK,CAAC;IACnE,yEAAyE;IACzE,6EAA6E;IAC7E,4CAA4C;IAC5C,IAAI,oBAAoB,EAAE,CAAC;QACzB,OAAO,UAAU,IAAI,oBAAoB;YACvC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,cAAuB,EAAE,MAAM,EAAE,mBAA4B,EAAE,WAAW,EAAE,KAAK,EAAE;YACzG,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,KAAc,EAAE,MAAM,EAAE,wCAAiD,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IACzH,CAAC;IACD,IAAI,UAAU,IAAI,gBAAgB,IAAI,yBAAyB,EAAE,CAAC;QAChE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,oBAAoB,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IACjG,CAAC;IACD,IAAI,CAAC,yBAAyB,EAAE,CAAC;QAC/B,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,gCAAgC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAClG,CAAC;IACD,IAAI,UAAU,IAAI,oBAAoB,IAAI,2BAA2B,EAAE,CAAC;QACtE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,mBAAmB,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAC/F,CAAC;IACD,IAAI,CAAC,2BAA2B,EAAE,CAAC;QACjC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,mCAAmC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IACrG,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,wCAAwC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;AAC1G,CAAC"}

package/dist/advanced-runtime/index.d.ts

@@ -1,5 +1,9 @@
-export { AdvancedRenderer } from "./AdvancedRenderer.js";
-export type { AdvancedRendererOptions, AdvancedRendererSource } from "./AdvancedRenderer.js";
+export type { RendererInput, CameraLike, RenderSource } from "../Renderer.js";
+import type { RendererInput } from "../Renderer.js";
+import type { RenderSource } from "../Renderer.js";
+import type { RenderItem } from "../ForwardPass.js";
+import type { Scene } from "@aura3d/scene";
+export type AdvancedRendererSource = RendererInput | RenderSource | Iterable<RenderItem> | Scene;
 export * from "../Renderer.js";
 export * from "../RenderDevice.js";
 export * from "../Geometry.js";

package/dist/advanced-runtime/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/advanced-runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC1F,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/advanced-runtime/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC3C,MAAM,MAAM,sBAAsB,GAAG,aAAa,GAAG,YAAY,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC;AACjG,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC"}

package/dist/advanced-runtime/index.js

@@ -1,4 +1,3 @@
-export { AdvancedRenderer } from "./AdvancedRenderer.js";
 export * from "../Renderer.js";
 export * from "../RenderDevice.js";
 export * from "../Geometry.js";

package/dist/advanced-runtime/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/advanced-runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/advanced-runtime/index.ts"],"names":[],"mappings":"AAMA,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC"}

package/dist/animation/AnimationRenderPreset.d.ts

@@ -1,4 +1,4 @@
-import { type AnimationMaterialStyle, type AnimationMaterialStyleOptions } from "./AnimationMaterialStyle.js";
+import { type AnimationMaterialStyle, type AnimationMaterialStyleOptions } from "../MaterialPresets.js";
 export interface AnimationRenderPresetOptions {
     readonly name?: string | undefined;
     readonly resolution?: {

package/dist/animation/AnimationRenderPreset.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AnimationRenderPreset.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/animation/AnimationRenderPreset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,sBAAsB,EAAE,KAAK,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AAE5I,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IACtF,QAAQ,CAAC,aAAa,CAAC,EAAE,6BAA6B,GAAG,SAAS,CAAC;IACnE,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC7C;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,EAAE,kCAAkC,CAAC;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACzE,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IACxE,QAAQ,CAAC,WAAW,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7G,QAAQ,CAAC,aAAa,EAAE,sBAAsB,CAAC;IAC/C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,4BAA4B,EAAE,KAAK,CAAC;IAC7C,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC;AAED,wBAAgB,2BAA2B,CAAC,OAAO,GAAE,4BAAiC,GAAG,6BAA6B,CAoBrH"}
+{"version":3,"file":"AnimationRenderPreset.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/animation/AnimationRenderPreset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,sBAAsB,EAAE,KAAK,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAEtI,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IACtF,QAAQ,CAAC,aAAa,CAAC,EAAE,6BAA6B,GAAG,SAAS,CAAC;IACnE,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC7C;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,EAAE,kCAAkC,CAAC;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACzE,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IACxE,QAAQ,CAAC,WAAW,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7G,QAAQ,CAAC,aAAa,EAAE,sBAAsB,CAAC;IAC/C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,4BAA4B,EAAE,KAAK,CAAC;IAC7C,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC;AAED,wBAAgB,2BAA2B,CAAC,OAAO,GAAE,4BAAiC,GAAG,6BAA6B,CAoBrH"}

package/dist/animation/AnimationRenderPreset.js

@@ -1,4 +1,4 @@
-import { createAnimationMaterialStyle } from "./AnimationMaterialStyle.js";
+import { createAnimationMaterialStyle } from "../MaterialPresets.js";
 export function createAnimationRenderPreset(options = {}) {
     const reducedMotion = options.reducedMotion ?? false;
     const reducedFlash = options.reducedFlash ?? false;

package/dist/animation/AnimationRenderPreset.js.map

@@ -1 +1 @@
-{"version":3,"file":"AnimationRenderPreset.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/animation/AnimationRenderPreset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAmE,MAAM,6BAA6B,CAAC;AAwB5I,MAAM,UAAU,2BAA2B,CAAC,UAAwC,EAAE;IACpF,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,KAAK,CAAC;IACrD,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,KAAK,CAAC;IACnD,OAAO;QACL,IAAI,EAAE,kCAAkC;QACxC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,uBAAuB;QAC7C,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;QAC9D,MAAM,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,qBAAqB,CAAC;QACnE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;QACtC,WAAW,EAAE;YACX,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;YACjC,UAAU,EAAE,iBAAiB;YAC7B,WAAW,EAAE,IAAI;SAClB;QACD,aAAa,EAAE,4BAA4B,CAAC,OAAO,CAAC,aAAa,CAAC;QAClE,aAAa,EAAE,IAAI;QACnB,4BAA4B,EAAE,KAAK;QACnC,aAAa;QACb,YAAY;KACb,CAAC;AACJ,CAAC"}
+{"version":3,"file":"AnimationRenderPreset.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/animation/AnimationRenderPreset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAmE,MAAM,uBAAuB,CAAC;AAwBtI,MAAM,UAAU,2BAA2B,CAAC,UAAwC,EAAE;IACpF,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,KAAK,CAAC;IACrD,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,KAAK,CAAC;IACnD,OAAO;QACL,IAAI,EAAE,kCAAkC;QACxC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,uBAAuB;QAC7C,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;QAC9D,MAAM,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,qBAAqB,CAAC;QACnE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;QACtC,WAAW,EAAE;YACX,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;YACjC,UAAU,EAAE,iBAAiB;YAC7B,WAAW,EAAE,IAAI;SAClB;QACD,aAAa,EAAE,4BAA4B,CAAC,OAAO,CAAC,aAAa,CAAC;QAClE,aAAa,EAAE,IAAI;QACnB,4BAA4B,EAAE,KAAK;QACnC,aAAa;QACb,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/animation/applyAnimationRenderPreset.d.ts

@@ -1,6 +1,6 @@
 import { AnimationToonMaterial, type AnimationToonMaterialOptions } from "./AnimationToonMaterial.js";
 import type { AnimationRenderPresetEvidence } from "./AnimationRenderPreset.js";
-import type { AnimationMaterialStyle } from "./AnimationMaterialStyle.js";
+import type { AnimationMaterialStyle } from "../MaterialPresets.js";
 import { type ColorGradeResult, type OutlineResult } from "../PostProcessPass.js";
 /**
  * applyAnimationRenderPreset — turns a (metadata) AnimationRenderPreset into the

package/dist/animation/applyAnimationRenderPreset.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"applyAnimationRenderPreset.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/animation/applyAnimationRenderPreset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,KAAK,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AACtG,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAChF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAmC,KAAK,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEnH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,MAAM,WAAW,+BAA+B;IAC9C,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,uCAAuC;IACtD,QAAQ,CAAC,iBAAiB,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9D,QAAQ,CAAC,aAAa,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1D,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,+FAA+F;IAC/F,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,iCAAiC;IAChD,mEAAmE;IACnE,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAC3E,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,4BAA4B,CAAC,GAAG,SAAS,CAAC;IACtE,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,CAAC,EAAE,+BAA+B,GAAG,SAAS,CAAC;CAC9D;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,IAAI,EAAE,qCAAqC,CAAC;IACrD,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;IACzC,QAAQ,CAAC,aAAa,EAAE,sBAAsB,CAAC;IAC/C,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,EAAE,uCAAuC,CAAC;IAC3D,mEAAmE;IACnE,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,6FAA6F;IAC7F,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC7C,oEAAoE;IACpE,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACnD,sDAAsD;IACtD,QAAQ,CAAC,eAAe,EAAE;QACxB,QAAQ,CAAC,YAAY,EAAE,gCAAgC,CAAC;QACxD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAC1B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;KAC9B,CAAC;CACH;AAsBD,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,6BAA6B,EACrC,OAAO,GAAE,iCAAsC,GAC9C,gCAAgC,CAyElC"}
+{"version":3,"file":"applyAnimationRenderPreset.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/animation/applyAnimationRenderPreset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,KAAK,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AACtG,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAChF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAmC,KAAK,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEnH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,MAAM,WAAW,+BAA+B;IAC9C,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,uCAAuC;IACtD,QAAQ,CAAC,iBAAiB,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9D,QAAQ,CAAC,aAAa,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1D,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,+FAA+F;IAC/F,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,iCAAiC;IAChD,mEAAmE;IACnE,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAC3E,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,4BAA4B,CAAC,GAAG,SAAS,CAAC;IACtE,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,CAAC,EAAE,+BAA+B,GAAG,SAAS,CAAC;CAC9D;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,IAAI,EAAE,qCAAqC,CAAC;IACrD,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;IACzC,QAAQ,CAAC,aAAa,EAAE,sBAAsB,CAAC;IAC/C,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,EAAE,uCAAuC,CAAC;IAC3D,mEAAmE;IACnE,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,6FAA6F;IAC7F,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC7C,oEAAoE;IACpE,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACnD,sDAAsD;IACtD,QAAQ,CAAC,eAAe,EAAE;QACxB,QAAQ,CAAC,YAAY,EAAE,gCAAgC,CAAC;QACxD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAC1B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;KAC9B,CAAC;CACH;AAsBD,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,6BAA6B,EACrC,OAAO,GAAE,iCAAsC,GAC9C,gCAAgC,CAyElC"}

package/dist/animation/index.d.ts

@@ -1,4 +1,5 @@
-export * from "./AnimationMaterialStyle.js";
+export { createAnimationMaterialStyle } from "../MaterialPresets.js";
+export type { AnimationMaterialStyle, AnimationMaterialStyleOptions, AnimationMaterialTreatment } from "../MaterialPresets.js";
 export * from "./AnimationRenderPreset.js";
 export * from "./AnimationVisualQuality.js";
 export * from "./AnimationToonMaterial.js";

package/dist/animation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/animation/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/animation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AACrE,YAAY,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAC/H,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC"}

package/dist/animation/index.js

@@ -1,4 +1,4 @@
-export * from "./AnimationMaterialStyle.js";
+export { createAnimationMaterialStyle } from "../MaterialPresets.js";
 export * from "./AnimationRenderPreset.js";
 export * from "./AnimationVisualQuality.js";
 export * from "./AnimationToonMaterial.js";

package/dist/animation/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/animation/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/animation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAErE,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC"}

package/dist/atmosphere/CloudLayer.d.ts

@@ -0,0 +1,24 @@
+export interface CloudSpec {
+    readonly scale?: number;
+    readonly speed?: number;
+    readonly coverage?: number;
+    readonly density?: number;
+    readonly elevation?: number;
+}
+export interface CloudFrame {
+    readonly scale: number;
+    readonly speed: number;
+    readonly coverage: number;
+    readonly density: number;
+    readonly elevation: number;
+}
+export declare function cloudFrame(raw: unknown): CloudFrame;
+/** Smoothstep edge the mask opens at (shader: `1 - coverage`). */
+export declare function cloudMaskEdge(coverage: number): number;
+/** Smoothstep width of the mask edge (r185 block constant). */
+export declare const CLOUD_MASK_SOFTNESS = 0.3;
+/** Projection plane factor — `mix(1, 0.1, elevation)` in the shader. */
+export declare function cloudElevationScale(elevation: number): number;
+/** Horizon fade the shader applies (`smoothstep(0, 0.1+0.2*e, dir.y)`). */
+export declare function cloudHorizonFade(directionY: number, elevation: number): number;
+//# sourceMappingURL=CloudLayer.d.ts.map

package/dist/atmosphere/CloudLayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CloudLayer.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/atmosphere/CloudLayer.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CASnD;AAED,kEAAkE;AAClE,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,+DAA+D;AAC/D,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,wEAAwE;AACxE,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAI9E"}

package/dist/atmosphere/CloudLayer.js

@@ -0,0 +1,30 @@
+// PRD-07 P3-T2 — cloud layer (r185 cloud block): a smoothstep mask over fbm
+// noise projected onto a plane at `elevation`, drifting with `speed`. The CPU
+// helpers mirror the shader math for tests and horizon-fade checks.
+export function cloudFrame(raw) {
+    const o = (raw ?? {});
+    return {
+        scale: o.scale ?? 0.0002,
+        speed: o.speed ?? 0.0001,
+        coverage: o.coverage ?? 0,
+        density: o.density ?? 0.4,
+        elevation: o.elevation ?? 0.5
+    };
+}
+/** Smoothstep edge the mask opens at (shader: `1 - coverage`). */
+export function cloudMaskEdge(coverage) {
+    return 1 - coverage;
+}
+/** Smoothstep width of the mask edge (r185 block constant). */
+export const CLOUD_MASK_SOFTNESS = 0.3;
+/** Projection plane factor — `mix(1, 0.1, elevation)` in the shader. */
+export function cloudElevationScale(elevation) {
+    return 1 - 0.9 * elevation;
+}
+/** Horizon fade the shader applies (`smoothstep(0, 0.1+0.2*e, dir.y)`). */
+export function cloudHorizonFade(directionY, elevation) {
+    const hi = 0.1 + 0.2 * elevation;
+    const t = Math.max(0, Math.min(1, directionY / hi));
+    return t * t * (3 - 2 * t);
+}
+//# sourceMappingURL=CloudLayer.js.map

package/dist/atmosphere/CloudLayer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CloudLayer.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/atmosphere/CloudLayer.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,8EAA8E;AAC9E,oEAAoE;AAkBpE,MAAM,UAAU,UAAU,CAAC,GAAY;IACrC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAc,CAAC;IACnC,OAAO;QACL,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,MAAM;QACxB,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,MAAM;QACxB,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,CAAC;QACzB,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,GAAG;QACzB,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,GAAG;KAC9B,CAAC;AACJ,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,OAAO,CAAC,GAAG,QAAQ,CAAC;AACtB,CAAC;AAED,+DAA+D;AAC/D,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEvC,wEAAwE;AACxE,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IACnD,OAAO,CAAC,GAAG,GAAG,GAAG,SAAS,CAAC;AAC7B,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,gBAAgB,CAAC,UAAkB,EAAE,SAAiB;IACpE,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,SAAS,CAAC;IACjC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,EAAE,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7B,CAAC"}

package/dist/atmosphere/FogVolumes.d.ts

@@ -0,0 +1,30 @@
+import type { Vec3 } from "./HeightFog.js";
+/** ≤ 4 on Low/Medium, ≤ 8 on High+ (§6.6). */
+export declare const A3D_MAX_FOG_VOLUMES = 8;
+export interface Prd07FogVolume {
+    readonly shape: "box" | "ellipsoid";
+    readonly center: Vec3;
+    readonly halfSize: Vec3;
+    readonly density: number;
+}
+/**
+ * Ray ∩ axis-aligned box (slab test). Returns the [tEnter, tExit] interval of
+ * `o + t·v` inside the box, or null when the ray misses.
+ */
+export declare function rayBoxSegment(origin: Vec3, dir: Vec3, center: Vec3, halfSize: Vec3): readonly [number, number] | null;
+/**
+ * Ray ∩ ellipsoid: map to unit-sphere space (`x' = (x - c) / h`) and use the
+ * quadratic ray/sphere solution. Returns [tEnter, tExit] in ray units.
+ */
+export declare function rayEllipsoidSegment(origin: Vec3, dir: Vec3, center: Vec3, halfSize: Vec3): readonly [number, number] | null;
+/** Ray ∩ volume segment length clipped to [0, maxT] (§6.6). */
+export declare function rayVolumeSegmentLength(origin: Vec3, dir: Vec3, maxT: number, volume: Prd07FogVolume): number;
+/** Σ segment·density over volumes — the additive τ term in `a3dFogAmount`. */
+export declare function fogVolumesTau(origin: Vec3, dir: Vec3, distance: number, volumes: readonly Prd07FogVolume[]): number;
+/**
+ * Pack volumes into the `u_fogVolumes[2 * A3D_MAX_FOG_VOLUMES]` layout:
+ * slot i   = (center.xyz, shape)   shape: 0 box, 1 ellipsoid
+ * slot i+1 = (halfSize.xyz, density)
+ */
+export declare function packFogVolumes(volumes: readonly Prd07FogVolume[]): Float32Array;
+//# sourceMappingURL=FogVolumes.d.ts.map

package/dist/atmosphere/FogVolumes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FogVolumes.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/atmosphere/FogVolumes.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC,8CAA8C;AAC9C,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,WAAW,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAID;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAkBrH;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAgB3H;AAED,+DAA+D;AAC/D,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,MAAM,CAQ5G;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,CAMnH;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,YAAY,CAgB/E"}

package/dist/atmosphere/FogVolumes.js

@@ -0,0 +1,96 @@
+// PRD-07 P4-T5 — analytic ray/volume segment lengths for `effects.fogVolume`
+// (§6.6): constant-density box or ellipsoid; the length of ray ∩ volume
+// clipped to [0, d] is added to τ. Used by `a3dFogVolumesTau` in the chunk and
+// by PRD 07 programs' CPU mirrors.
+/** ≤ 4 on Low/Medium, ≤ 8 on High+ (§6.6). */
+export const A3D_MAX_FOG_VOLUMES = 8;
+/**
+ * Ray ∩ axis-aligned box (slab test). Returns the [tEnter, tExit] interval of
+ * `o + t·v` inside the box, or null when the ray misses.
+ */
+export function rayBoxSegment(origin, dir, center, halfSize) {
+    let tMin = -Infinity;
+    let tMax = Infinity;
+    for (let i = 0; i < 3; i++) {
+        const o = origin[i] - center[i];
+        const v = dir[i];
+        const h = halfSize[i] || 1e-9;
+        if (Math.abs(v) < 1e-9) {
+            if (Math.abs(o) > h)
+                return null;
+            continue;
+        }
+        const t1 = (-h - o) / v;
+        const t2 = (h - o) / v;
+        tMin = Math.max(tMin, Math.min(t1, t2));
+        tMax = Math.min(tMax, Math.max(t1, t2));
+    }
+    if (tMax < tMin)
+        return null;
+    return [tMin, tMax];
+}
+/**
+ * Ray ∩ ellipsoid: map to unit-sphere space (`x' = (x - c) / h`) and use the
+ * quadratic ray/sphere solution. Returns [tEnter, tExit] in ray units.
+ */
+export function rayEllipsoidSegment(origin, dir, center, halfSize) {
+    const o = [0, 0, 0];
+    const v = [0, 0, 0];
+    for (let i = 0; i < 3; i++) {
+        const h = halfSize[i] || 1e-9;
+        o[i] = (origin[i] - center[i]) / h;
+        v[i] = dir[i] / h;
+    }
+    const a = v[0] * v[0] + v[1] * v[1] + v[2] * v[2];
+    if (a < 1e-12)
+        return null;
+    const b = o[0] * v[0] + o[1] * v[1] + o[2] * v[2];
+    const c = o[0] * o[0] + o[1] * o[1] + o[2] * o[2] - 1;
+    const disc = b * b - a * c;
+    if (disc < 0)
+        return null;
+    const root = Math.sqrt(disc);
+    return [(-b - root) / a, (-b + root) / a];
+}
+/** Ray ∩ volume segment length clipped to [0, maxT] (§6.6). */
+export function rayVolumeSegmentLength(origin, dir, maxT, volume) {
+    const seg = volume.shape === "box"
+        ? rayBoxSegment(origin, dir, volume.center, volume.halfSize)
+        : rayEllipsoidSegment(origin, dir, volume.center, volume.halfSize);
+    if (!seg)
+        return 0;
+    const enter = Math.max(seg[0], 0);
+    const exit = Math.min(seg[1], maxT);
+    return Math.max(0, exit - enter);
+}
+/** Σ segment·density over volumes — the additive τ term in `a3dFogAmount`. */
+export function fogVolumesTau(origin, dir, distance, volumes) {
+    let tau = 0;
+    for (const volume of volumes) {
+        tau += rayVolumeSegmentLength(origin, dir, distance, volume) * volume.density;
+    }
+    return tau;
+}
+/**
+ * Pack volumes into the `u_fogVolumes[2 * A3D_MAX_FOG_VOLUMES]` layout:
+ * slot i   = (center.xyz, shape)   shape: 0 box, 1 ellipsoid
+ * slot i+1 = (halfSize.xyz, density)
+ */
+export function packFogVolumes(volumes) {
+    const out = new Float32Array(2 * A3D_MAX_FOG_VOLUMES * 4);
+    const count = Math.min(volumes.length, A3D_MAX_FOG_VOLUMES);
+    for (let i = 0; i < count; i++) {
+        const v = volumes[i];
+        const a = i * 8;
+        out[a] = v.center[0];
+        out[a + 1] = v.center[1];
+        out[a + 2] = v.center[2];
+        out[a + 3] = v.shape === "ellipsoid" ? 1 : 0;
+        out[a + 4] = v.halfSize[0];
+        out[a + 5] = v.halfSize[1];
+        out[a + 6] = v.halfSize[2];
+        out[a + 7] = v.density;
+    }
+    return out;
+}
+//# sourceMappingURL=FogVolumes.js.map

package/dist/atmosphere/FogVolumes.js.map

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

package/dist/atmosphere/GradientSky.d.ts

@@ -0,0 +1,40 @@
+import { type Vec3, type AuraSkySunSpecLike } from "./PreethamSky.js";
+/** Ordered additive emission band (aurora, city glow) on a gradient sky. */
+export interface AuraSkyBand {
+    readonly elevationDeg: number;
+    readonly widthDeg: number;
+    readonly color: string | readonly number[];
+    readonly intensity: number;
+}
+/** Band count carried to the shader — u_bandParams/u_bandColors are [4]. */
+export declare const SKY_BAND_CAPACITY = 4;
+export interface GradientSpec {
+    readonly model: "gradient";
+    readonly zenith: Vec3 | readonly number[];
+    readonly horizon: Vec3 | readonly number[];
+    readonly ground?: Vec3 | readonly number[];
+    readonly exponent?: number;
+    readonly horizonGlow?: number;
+    readonly sun?: AuraSkySunSpecLike;
+    readonly bands?: readonly AuraSkyBand[];
+    readonly intensity?: number;
+}
+export interface GradientFrame {
+    readonly zenith: Vec3;
+    readonly horizon: Vec3;
+    readonly ground: Vec3;
+    readonly exponent: number;
+    readonly horizonGlow: number;
+    readonly sunDirection: Vec3 | null;
+    readonly bands: readonly {
+        readonly elevationDeg: number;
+        readonly widthDeg: number;
+        readonly color: Vec3;
+        readonly intensity: number;
+    }[];
+    readonly intensity: number;
+}
+export declare function gradientFrame(spec: GradientSpec): GradientFrame;
+/** Linear radiance along `dir` (CPU mirror of the GLSL gradient path). */
+export declare function gradientEvaluate(frame: GradientFrame, dir: Vec3): Vec3;
+//# sourceMappingURL=GradientSky.d.ts.map

package/dist/atmosphere/GradientSky.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GradientSky.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/atmosphere/GradientSky.ts"],"names":[],"mappings":"AACA,OAAO,EAA8C,KAAK,IAAI,EAAE,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAE/G,4EAA4E;AAC5E,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,IAAI,GAAG,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,GAAG,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,GAAG,CAAC,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,IAAI,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS;QAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1I,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,aAAa,CAgB/D;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,IAAI,GAAG,IAAI,CAiCtE"}

package/dist/atmosphere/GradientSky.js

@@ -0,0 +1,75 @@
+// PRD-07 P3-T1 — gradient sky evaluator (zenith/horizon/ground + sun halo).
+import { dot3, normalize3, smoothstep, sunDirection } from "./PreethamSky.js";
+/** Band count carried to the shader — u_bandParams/u_bandColors are [4]. */
+export const SKY_BAND_CAPACITY = 4;
+export function gradientFrame(spec) {
+    return {
+        zenith: toVec3(spec.zenith, [0.08, 0.16, 0.38]),
+        horizon: toVec3(spec.horizon, [0.55, 0.65, 0.8]),
+        ground: toVec3(spec.ground ?? [0.12, 0.12, 0.13], [0.12, 0.12, 0.13]),
+        exponent: spec.exponent ?? 1.6,
+        horizonGlow: spec.horizonGlow ?? 0.35,
+        sunDirection: spec.sun ? sunDirection(spec.sun) : null,
+        bands: (spec.bands ?? []).slice(0, SKY_BAND_CAPACITY).map((b) => ({
+            elevationDeg: b.elevationDeg,
+            widthDeg: Math.max(0.5, b.widthDeg),
+            color: bandColor(b.color),
+            intensity: Math.max(0, b.intensity)
+        })),
+        intensity: spec.intensity ?? 1
+    };
+}
+/** Linear radiance along `dir` (CPU mirror of the GLSL gradient path). */
+export function gradientEvaluate(frame, dir) {
+    const d = normalize3(dir);
+    const y = d[1];
+    if (y >= 0) {
+        const t = Math.pow(Math.max(0, Math.min(1, y)), 1 / frame.exponent);
+        const glow = frame.horizonGlow * smoothstep(0.25, 0, Math.abs(y));
+        let out = [
+            lerp(frame.horizon[0], frame.zenith[0], t) + glow * frame.horizon[0],
+            lerp(frame.horizon[1], frame.zenith[1], t) + glow * frame.horizon[1],
+            lerp(frame.horizon[2], frame.zenith[2], t) + glow * frame.horizon[2]
+        ];
+        if (frame.sunDirection) {
+            const c = dot3(d, frame.sunDirection);
+            const disc = smoothstep(0.9995, 0.9999, c);
+            const halo = Math.pow(Math.max(0, c), 350) * 0.6;
+            out = [out[0] + disc * 40 + halo, out[1] + disc * 36 + halo * 0.9, out[2] + disc * 30 + halo * 0.7];
+        }
+        if (frame.bands.length > 0) {
+            const elev = (Math.asin(Math.max(-1, Math.min(1, y))) * 180) / Math.PI;
+            for (const band of frame.bands) {
+                const dy = elev - band.elevationDeg;
+                const w = Math.exp(-(dy * dy) / (band.widthDeg * band.widthDeg * 0.5)) * band.intensity;
+                out = [out[0] + band.color[0] * w, out[1] + band.color[1] * w, out[2] + band.color[2] * w];
+            }
+        }
+        return scale(out, frame.intensity);
+    }
+    const t = Math.min(1, -y * 3);
+    return scale([
+        lerp(frame.horizon[0], frame.ground[0], t),
+        lerp(frame.horizon[1], frame.ground[1], t),
+        lerp(frame.horizon[2], frame.ground[2], t)
+    ], frame.intensity);
+}
+function bandColor(c) {
+    if (typeof c === "string" && c.startsWith("#") && c.length === 7) {
+        const srgb = (h) => Math.pow(parseInt(h, 16) / 255, 2.2);
+        return [srgb(c.slice(1, 3)), srgb(c.slice(3, 5)), c.length === 7 ? srgb(c.slice(5, 7)) : 0];
+    }
+    if (Array.isArray(c) && c.length >= 3)
+        return [Number(c[0]), Number(c[1]), Number(c[2])];
+    return [0, 0, 0];
+}
+function toVec3(v, fallback) {
+    return v && v.length >= 3 ? [v[0] ?? fallback[0], v[1] ?? fallback[1], v[2] ?? fallback[2]] : fallback;
+}
+function lerp(a, b, t) {
+    return a + (b - a) * t;
+}
+function scale(v, s) {
+    return [v[0] * s, v[1] * s, v[2] * s];
+}
+//# sourceMappingURL=GradientSky.js.map

package/dist/atmosphere/GradientSky.js.map

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