@3driseai/3drise-viewer 0.1.9 → 0.1.11

package/dist/shaders/glsl/cloudCore.glsl.js

@@ -80,6 +80,12 @@ precision highp float;
 precision highp sampler3D;
 precision highp sampler2D;
 
+/** Extinction. Declared with the density uniforms rather than the scattering ones
+ *  because cloudField — the subset exported for surface materials that want cloud
+ *  shadows — needs it to turn accumulated density into transmittance, and does not
+ *  compile on its own without it. */
+uniform float u_sigmaT;
+
 uniform sampler3D u_base;
 uniform sampler3D u_detail;
 uniform sampler2D u_weather;
@@ -135,14 +141,28 @@ float heightGradient(float h, float ty){
 }
 
 /**
- * @param detail 0..1 — fades high-frequency erosion out with distance. Without it the
- *        finest worley octave beats against the step size and the far field speckles.
+ * The weather-derived terms, separated from the rest of the density evaluation.
+ *
+ * These are a function of horizontal position only, and the weather map's smallest
+ * feature is a ~7 km cell (weatherCellSize / 2.17). A sun ray inside the cloud travels
+ * a few hundred metres for a stratocumulus deck; over that distance these values do not
+ * meaningfully change. Sampling them once per shaded point and reusing them for the
+ * light march removes two texture fetches and a sin() from every one of its taps —
+ * which is most of the frame, since lighting is roughly 80% of the sample cost.
+ *
+ * This is the standard separation (Schneider does the same in Horizon): the light
+ * march's job is to find how much *shape* is between here and the sun, and the shape
+ * comes from the 3D noise, which is still evaluated per tap.
  */
-float cloudDensity(vec3 p, float h, float detail){
-  if (h <= 0.001 || h >= 0.999) return 0.0;
+struct CloudWeather {
+  float ty;   // blended cloud type
+  float cov;  // coverage BEFORE the height-dependent anvil term
+};
 
+CloudWeather cloudWeatherAt(vec3 p){
   vec4 w = sampleWeather(p);
-  float ty = saturate(u_cloudType + (w.b - 0.5) * 0.30);
+  CloudWeather cw;
+  cw.ty = saturate(u_cloudType + (w.b - 0.5) * 0.30);
 
   float cov = mix(w.r, w.g, 0.40);
   // Slow formation and decay: the coverage threshold itself breathes.
@@ -151,7 +171,20 @@ float cloudDensity(vec3 p, float h, float detail){
   // The window slides AND narrows with coverage. Remapping to a fixed upper bound of 1.0
   // caps effective coverage near the weather map's median (~0.5), so overcast is
   // unreachable no matter how high the slider goes.
-  cov = saturate(remap(cov, 1.0 - u_coverage, 1.0 - u_coverage * 0.35, 0.0, 1.0));
+  cw.cov = saturate(remap(cov, 1.0 - u_coverage, 1.0 - u_coverage * 0.35, 0.0, 1.0));
+  return cw;
+}
+
+/**
+ * @param detail 0..1 — fades high-frequency erosion out with distance. Without it the
+ *        finest worley octave beats against the step size and the far field speckles.
+ * @param cw     weather at this column, from cloudWeatherAt().
+ */
+float cloudDensityW(vec3 p, float h, float detail, CloudWeather cw){
+  if (h <= 0.001 || h >= 0.999) return 0.0;
+
+  float ty  = cw.ty;
+  float cov = cw.cov;
   if (cov <= 0.0) return 0.0;
 
   // Anvil: above the equilibrium level a storm spreads laterally. Gated on type so a
@@ -209,7 +242,19 @@ float cloudAlbedo(float h){
   return mix(1.0, 0.22, u_precip * saturate(remap(h, 0.30, 0.02, 0.0, 1.0)));
 }
 
+/** Samples its own weather. Keeps the original signature for every existing caller,
+ *  including the cloudField surface-shadow path. */
+float cloudDensity(vec3 p, float h, float detail){
+  return cloudDensityW(p, h, detail, cloudWeatherAt(p));
+}
+
 float cloudDensityCheap(vec3 p, float h){ return cloudDensity(p, h, 0.0); }
+
+/** Shape only, against weather already sampled at the shaded point. The light march
+ *  and the empty-space skip both want this. */
+float cloudDensityCheapW(vec3 p, float h, CloudWeather cw){
+  return cloudDensityW(p, h, 0.0, cw);
+}
 `;
 /** Ray/layer and ray/sphere intersection. */
 export const cloudGeometry = /* glsl */ `
@@ -278,7 +323,7 @@ bool sphereRange(vec3 ro, vec3 rd, vec3 c, float r, out float t0, out float t1){
 }
 `;
 export const cloudLighting = /* glsl */ `
-uniform float u_sigmaT, u_g1, u_g2;
+uniform float u_g1, u_g2;
 uniform float u_msExtinction, u_msEnergy, u_msPhase;
 uniform float u_powder, u_silver, u_ambient;
 uniform vec3  u_skyAmbient, u_groundAmbient;
@@ -306,7 +351,27 @@ const vec3 kCone[6] = vec3[6](
  * The step is a FRACTION of cloud depth, not metres: the same absolute value is wrong
  * for an 800 m deck and an 8 km tower.
  */
-float lightMarch(vec3 p, float rayT){
+/**
+ * How far a light tap may travel, as a fraction of a weather cell, before it stops
+ * reusing the shaded point's weather and samples its own.
+ *
+ * The steps grow 1.62x, so the last two taps cover most of the distance and carry
+ * nearly all of the error — sharing weather across all six is fine for a 800 m
+ * stratocumulus deck and badly wrong for a 8.4 km cumulonimbus, where the cone reaches
+ * 5.5 km. Measured against the real baked weather map (p95 absolute coverage error):
+ *
+ *   share all 6   strato 0.115  cumulus 0.173  Cb 0.408   <- too much on the big types
+ *   0.0012 (here) strato 0.074  cumulus 0.106  Cb 0.115
+ *   0.0008        strato 0.039  cumulus 0.057  Cb 0.053   <- if a storm looks wrong
+ *
+ * A distance rule rather than a fixed tap count because it self-tunes: thickness and
+ * weatherCellSize are both user-facing sliders, and their ratio is what decides how
+ * many taps are safe. It costs nothing in divergence either — the condition is built
+ * from uniforms alone, so every fragment in the draw takes the same branch.
+ */
+#define LIGHT_WEATHER_REUSE 0.0012
+
+float lightMarch(vec3 p, float rayT, CloudWeather cw){
   float thick = (u_host < 0.5) ? (2.0 * u_radius) : max(u_layerTop - u_layerBottom, 1.0);
   float st = u_lightStep * thick;
   float acc = 0.0;
@@ -314,10 +379,17 @@ float lightMarch(vec3 p, float rayT){
   for (int i = 0; i < 6; i++){
     if (i >= u_lightSteps) break;
     vec3 sp = p + u_sunDir * (t + st * 0.5) + kCone[i] * (t * 0.38);
-    acc += cloudDensityCheap(sp, heightAt(sp, rayT)) * st;
+    float sh = heightAt(sp, rayT);
+    // Near taps reuse the shaded point's weather; far ones sample their own. What every
+    // tap still fetches per-sample is the 3D shape, which is what forms the shadow.
+    acc += ((t * u_weatherScale < LIGHT_WEATHER_REUSE)
+              ? cloudDensityCheapW(sp, sh, cw)
+              : cloudDensityCheap(sp, sh)) * st;
     t += st;
     st *= 1.62;
   }
+  // The long probe always samples its own: at 2.6x the accumulated distance it can be
+  // 9 km out on a cumulonimbus, well outside the cell the shaded point sits in.
   vec3 fp = p + u_sunDir * (t * 2.6);
   acc += cloudDensityCheap(fp, heightAt(fp, rayT)) * st * 2.0;
   return acc;

package/dist/shaders/glsl/cloudShadow.glsl.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Cloud shadows for surface materials.
+ *
+ * One texture fetch. The expensive part — marching the density field toward the sun —
+ * happens once per frame into a low-res map, not per ground fragment. The earlier
+ * `cloudField` approach put a six-sample march in every surface shader, which is
+ * why nothing ever adopted it.
+ *
+ * Usage in a surface material:
+ *   ${cloudShadowChunk}                       // in the fragment shader
+ *   float cs = cloudShadow(worldPosition);    // multiply into your shadow term
+ * and spread `cloudShadowUniforms` into the material's uniforms.
+ */
+export declare const cloudShadowChunk = "\nuniform sampler2D u_cloudShadowMap;\nuniform mat4  u_cloudShadowMatrix;\nuniform float u_cloudShadowStrength;\n\nfloat cloudShadow(vec3 worldPos){\n  if (u_cloudShadowStrength <= 0.0) return 1.0;\n\n  vec4 sp = u_cloudShadowMatrix * vec4(worldPos, 1.0);\n  vec2 uv = (sp.xy / sp.w) * 0.5 + 0.5;\n\n  // Outside the map is lit, not shadowed. Fading out over the last 8% of the extent\n  // stops a hard rectangle appearing at the edge of the shadowed region, which is\n  // the giveaway that this is a projected texture rather than a sky.\n  vec2 d = min(uv, 1.0 - uv);\n  float edge = smoothstep(0.0, 0.08, min(d.x, d.y));\n  if (edge <= 0.0) return 1.0;\n\n  float transmittance = texture2D(u_cloudShadowMap, uv).r;\n  return mix(1.0, transmittance, u_cloudShadowStrength * edge);\n}\n";
+//# sourceMappingURL=cloudShadow.glsl.d.ts.map

package/dist/shaders/glsl/cloudShadow.glsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudShadow.glsl.d.ts","sourceRoot":"","sources":["../../../src/shaders/glsl/cloudShadow.glsl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,yxBAqB5B,CAAC"}

package/dist/shaders/glsl/cloudShadow.glsl.js

@@ -0,0 +1,35 @@
+/**
+ * Cloud shadows for surface materials.
+ *
+ * One texture fetch. The expensive part — marching the density field toward the sun —
+ * happens once per frame into a low-res map, not per ground fragment. The earlier
+ * `cloudField` approach put a six-sample march in every surface shader, which is
+ * why nothing ever adopted it.
+ *
+ * Usage in a surface material:
+ *   ${cloudShadowChunk}                       // in the fragment shader
+ *   float cs = cloudShadow(worldPosition);    // multiply into your shadow term
+ * and spread `cloudShadowUniforms` into the material's uniforms.
+ */
+export const cloudShadowChunk = /* glsl */ `
+uniform sampler2D u_cloudShadowMap;
+uniform mat4  u_cloudShadowMatrix;
+uniform float u_cloudShadowStrength;
+
+float cloudShadow(vec3 worldPos){
+  if (u_cloudShadowStrength <= 0.0) return 1.0;
+
+  vec4 sp = u_cloudShadowMatrix * vec4(worldPos, 1.0);
+  vec2 uv = (sp.xy / sp.w) * 0.5 + 0.5;
+
+  // Outside the map is lit, not shadowed. Fading out over the last 8% of the extent
+  // stops a hard rectangle appearing at the edge of the shadowed region, which is
+  // the giveaway that this is a projected texture rather than a sky.
+  vec2 d = min(uv, 1.0 - uv);
+  float edge = smoothstep(0.0, 0.08, min(d.x, d.y));
+  if (edge <= 0.0) return 1.0;
+
+  float transmittance = texture2D(u_cloudShadowMap, uv).r;
+  return mix(1.0, transmittance, u_cloudShadowStrength * edge);
+}
+`;

package/dist/types/cloudConfigs.d.ts

@@ -133,6 +133,50 @@ export interface CirrusLayerConfig {
     /** Name of the preset the numbers came from, or '' once any of them is edited. */
     preset?: string;
 }
+/**
+ * Lightning.
+ *
+ * Modelled as light emitted *inside* the volume, not as a screen flash: a bolt is a
+ * point source buried in the deck, so the cloud around it lights from within and the
+ * glow falls off both with distance and with the cloud it has to push through. That
+ * is the whole difference between lightning and someone toggling the exposure.
+ *
+ * Cumulus and stratocumulus can carry it, but the defaults are tuned for a
+ * cumulonimbus and it ships disabled — a thunderstorm over a fair-weather cumulus
+ * field is wrong. Cirrus cannot: three samples through a thin ice slab is not a
+ * volume, and there is nothing for a flash to scatter through.
+ */
+export interface ThunderConfig {
+    enabled: boolean;
+    /** Mean flashes per minute. Actual spacing is exponential around this, because
+     *  storms do not fire on a metronome. */
+    rate: number;
+    /** Peak radiance of the bolt. */
+    intensity: number;
+    /** Bolt colour. Real lightning is a blue-tinged white from ionised nitrogen. */
+    color: string;
+    /** Softening radius of the inverse-square falloff, in metres. Larger reads as a
+     *  sheet lighting a whole cell; smaller as a single localised strike. */
+    radius: number;
+    /** Sub-strokes per event. A real flash flickers 2-5 times over ~200 ms, and that
+     *  flicker is most of what separates lightning from a light bulb. */
+    strokes: number;
+    /** Length of one sub-stroke, seconds. */
+    strokeDuration: number;
+    /** Multiplies extinction between bolt and sample — how far the glow pushes through
+     *  cloud. Low values light the whole cell, high values keep it local to the bolt. */
+    scatter: number;
+    /** How much the rest of the scene brightens, 0..1. Zero lights only the cloud,
+     *  which looks broken: a real flash lights the ground too. */
+    sceneFlash: number;
+    /** Where in the deck the bolt sits, 0 at the base and 1 at the top. Real strikes
+     *  originate low, in the charge separation region. */
+    originHeight: number;
+    /** How far away lightning can strike, in metres. Bolts are placed where a ray
+     *  through a random on-screen point meets the deck, so this caps the distance
+     *  rather than scattering blindly around the origin. */
+    spread: number;
+}
 /** Cost knobs. Shared by both layers, since they share the pipeline. */
 export interface CloudsQualityConfig {
     /** Fraction of full resolution the march runs at. 0.5 is the sweet spot. */
@@ -171,6 +215,7 @@ export declare const defaultCumulusConfig: CloudDeckConfig;
 export declare const defaultStratocumulusConfig: CloudDeckConfig;
 export declare const defaultCumulonimbusConfig: CloudDeckConfig;
 export declare const defaultCirrusConfig: CirrusLayerConfig;
+export declare const defaultThunderConfig: ThunderConfig;
 export declare const defaultCloudsQuality: CloudsQualityConfig;
 /** Per-type deck defaults, for the controller's type switcher. */
 export declare const CLOUD_DECK_DEFAULTS: Record<CloudDeckType, CloudDeckConfig>;
@@ -184,6 +229,8 @@ export interface CloudPropertySchema {
     key: string;
     label: string;
     group: CloudPropertyGroup;
+    /** Widget kind. Absent means a number, which almost everything is. */
+    valueType?: 'number' | 'color';
     min?: number;
     max?: number;
     step?: number;
@@ -195,6 +242,7 @@ export interface CloudPropertySchema {
 }
 export declare const CLOUD_DECK_SCHEMA: CloudPropertySchema[];
 export declare const CIRRUS_SCHEMA: CloudPropertySchema[];
+export declare const THUNDER_SCHEMA: CloudPropertySchema[];
 export declare const CLOUD_QUALITY_SCHEMA: CloudPropertySchema[];
 import type { ObjectAnimations, MouseMoveInteractions } from '@3driseai/3drise-core';
 /**
@@ -215,6 +263,7 @@ export interface VolumetricCloudsSettings {
     config: CloudDeckConfig;
     /** High ice layer. Independent — it sits above whatever the deck is doing. */
     cirrus: CirrusLayerConfig;
+    thunder: ThunderConfig;
     quality: CloudsQualityConfig;
     /** Per-domain keyframe animations; the `clouds` domain drives deck properties. */
     animations?: ObjectAnimations;
@@ -240,5 +289,9 @@ export declare function normalizeCloudDeck(raw: unknown): CloudDeckConfig | null
  *  it was never authored with. A block that exists but omits `enabled` is a
  *  deliberate one and takes the default. */
 export declare function normalizeCirrus(raw: unknown): CirrusLayerConfig | null;
+/** Thunder merged over defaults. Unlike cirrus this returns a config even when the
+ *  block is absent, because the default is `enabled: false` — nothing appears, and a
+ *  scene saved before thunder existed simply has it switched off. */
+export declare function normalizeThunder(raw: unknown): ThunderConfig;
 export declare function normalizeCloudQuality(raw: unknown): CloudsQualityConfig;
 //# sourceMappingURL=cloudConfigs.d.ts.map

package/dist/types/cloudConfigs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cloudConfigs.d.ts","sourceRoot":"","sources":["../../src/types/cloudConfigs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cloudConfigs.d.ts","sourceRoot":"","sources":["../../src/types/cloudConfigs.ts"],"names":[],"mappings":"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"}

package/dist/types/cloudConfigs.js

@@ -123,6 +123,19 @@ export const defaultCirrusConfig = {
     ambient: 1,
     aerialPerspective: 0.000026,
 };
+export const defaultThunderConfig = {
+    enabled: false,
+    rate: 8,
+    intensity: 9,
+    color: '#cfe0ff',
+    radius: 900,
+    strokes: 3,
+    strokeDuration: 0.055,
+    scatter: 0.35,
+    sceneFlash: 0.55,
+    originHeight: 0.35,
+    spread: 40000,
+};
 export const defaultCloudsQuality = {
     resolutionScale: 0.5,
     temporalBlend: 0.9,
@@ -143,67 +156,80 @@ export const CLOUD_DECK_DEFAULTS = {
     cumulonimbus: defaultCumulonimbusConfig,
 };
 export const CLOUD_DECK_SCHEMA = [
-    { key: 'coverage', label: 'Coverage', group: 'shape', min: 0, max: 1, step: 0.005, description: 'Fraction of sky the deck occupies. Above ~0.8 a stratocumulus closes into true overcast.' },
-    { key: 'profile', label: 'Vertical profile', group: 'shape', min: 0, max: 1, step: 0.005, description: 'Blends stratus (0), cumulus (0.5) and cumulonimbus (1) density profiles. The weather map biases it per cell so one sky holds a spread.' },
-    { key: 'density', label: 'Density', group: 'shape', min: 0, max: 9, step: 0.02, description: 'Multiplies the density field. Target optical depth 4-6 through a core; past ~10 the interior goes muddy.' },
-    { key: 'baseAltitude', label: 'Base altitude', group: 'shape', min: 200, max: 6000, step: 10, unit: 'm', description: 'Cloud base. The vertical profile is a fraction of base-to-top, so moving either end restretches the whole shape.' },
-    { key: 'topAltitude', label: 'Top altitude', group: 'shape', min: 600, max: 14000, step: 10, unit: 'm', description: 'Cloud top. Also sets the march step, so cost scales with depth.' },
-    { key: 'featureSize', label: 'Feature size', group: 'shape', min: 600, max: 9000, step: 10, unit: 'm', description: 'Size of the primary lobes. Keep it well above the march step or the shape aliases.' },
-    { key: 'detailSize', label: 'Detail size', group: 'shape', min: 150, max: 2000, step: 10, unit: 'm', description: 'Size of the erosion detail. Below ~2x the march step it beats against the sampling and speckles.' },
-    { key: 'detailStrength', label: 'Detail erosion', group: 'shape', min: 0, max: 1, step: 0.005, description: 'How deeply detail eats into the base shape. Raise for crisp cauliflower, lower for soft mass.' },
-    { key: 'curlStrength', label: 'Curl warp', group: 'shape', min: 0, max: 2, step: 0.01, description: 'Divergence-free warp on the erosion, strongest at the base where a cloud shears into wisps.' },
-    { key: 'weatherCellSize', label: 'Weather cell size', group: 'shape', min: 4000, max: 90000, step: 250, unit: 'm', description: 'Size of the coverage cells. Too large and a whole viewport sits inside one cell.' },
-    { key: 'shear', label: 'Wind shear', group: 'shape', min: 0, max: 1.2, step: 0.005, description: 'Downwind displacement per unit height. Tilts the column so the top leads the base.' },
-    { key: 'anvil', label: 'Anvil spread', group: 'shape', min: 0, max: 1, step: 0.01, types: ['cumulonimbus'], description: 'Lateral growth above 70% height. Below ~0.4 the tower keeps a rounded top instead of flattening at the tropopause.' },
-    { key: 'precipitation', label: 'Precipitation', group: 'shape', min: 0, max: 1, step: 0.01, types: ['cumulonimbus'], description: 'Drops scattering albedo at the base. Set to 0 and a storm reads as an oversized cumulus.' },
-    { key: 'windBearing', label: 'Wind bearing', group: 'animation', min: 0, max: 360, step: 1, unit: 'deg', description: 'Drives advection, shear tilt and the cirrus streak axis.' },
-    { key: 'windSpeed', label: 'Wind speed', group: 'animation', min: 0, max: 40, step: 0.1, unit: 'm/s', description: 'Advection rate of the whole field.' },
-    { key: 'rise', label: 'Convective rise', group: 'animation', min: 0, max: 12, step: 0.05, unit: 'm/s', description: 'Vertical motion of the shape volume. Decoupling it from wind is what makes clouds boil rather than slide.' },
-    { key: 'churn', label: 'Detail churn', group: 'animation', min: 0, max: 24, step: 0.1, unit: 'm/s', description: 'Independent motion of the erosion layer. Without it edges translate instead of evolving.' },
-    { key: 'evolution', label: 'Formation / decay', group: 'animation', min: 0, max: 1, step: 0.01, description: 'Slow oscillation of the coverage threshold. Cells appear and dissipate rather than only drifting.' },
-    { key: 'extinction', label: 'Extinction', group: 'scattering', min: 0.002, max: 0.06, step: 0.0005, unit: '1/m', description: 'Tuned well below the physical ~0.045, because a 3-octave scattering approximation cannot carry that optical depth.' },
-    { key: 'forwardLobe', label: 'Forward lobe', group: 'scattering', min: 0, max: 0.97, step: 0.005, description: 'Anisotropy of the forward Henyey-Greenstein lobe. This is the silver lining.' },
-    { key: 'backLobe', label: 'Back lobe', group: 'scattering', min: 0, max: 0.9, step: 0.005, description: 'Small backward lobe, mixed at 0.42. The glow when the sun is behind you.' },
-    { key: 'msExtinction', label: 'MS extinction decay', group: 'scattering', min: 0.1, max: 0.95, step: 0.005, advanced: true, description: 'Per-octave extinction scale. Higher keeps deep interiors brighter.' },
-    { key: 'msEnergy', label: 'MS energy decay', group: 'scattering', min: 0.1, max: 0.95, step: 0.005, advanced: true, description: 'Per-octave energy scale. Drop to 0.15 and the cloud collapses to flat black.' },
-    { key: 'msPhase', label: 'MS phase decay', group: 'scattering', min: 0.1, max: 0.95, step: 0.005, advanced: true, description: 'Per-octave anisotropy scale. Later octaves go isotropic, as multiply-scattered light does.' },
-    { key: 'powder', label: 'Powder', group: 'scattering', min: 0, max: 1.5, step: 0.01, description: 'Dark-edge term. Applied only when looking away from the sun.' },
-    { key: 'silverLining', label: 'Silver lining', group: 'scattering', min: 0, max: 4, step: 0.01, description: 'Extra forward-scatter boost near the sun disc.' },
-    { key: 'ambient', label: 'Ambient', group: 'scattering', min: 0, max: 3, step: 0.01, description: 'Sky and ground-bounce fill. Too high goes flat; too low crushes shadowed sides to black.' },
-    { key: 'aerialPerspective', label: 'Aerial perspective', group: 'lighting', min: 0, max: 0.00012, step: 0.000001, unit: '1/m', description: 'Rate distant cloud fades into the sky behind it. The main cue for how large the sky reads.' },
+    { key: 'coverage', label: 'Coverage', group: 'shape', min: 0, max: 1, step: 0.005, description: 'How much of the sky is filled with cloud. Low leaves scattered puffs, high closes it into solid overcast.' },
+    { key: 'profile', label: 'Vertical profile', group: 'shape', min: 0, max: 1, step: 0.005, description: 'The overall shape, from flat sheets through classic puffy clouds to towering storm clouds.' },
+    { key: 'density', label: 'Density', group: 'shape', min: 0, max: 9, step: 0.02, description: 'How thick and solid the cloud looks. Too high and it turns into a grey mass.' },
+    { key: 'baseAltitude', label: 'Base altitude', group: 'shape', min: 200, max: 6000, step: 10, unit: 'm', description: 'How high the bottom of the clouds sits.' },
+    { key: 'topAltitude', label: 'Top altitude', group: 'shape', min: 600, max: 14000, step: 10, unit: 'm', description: 'How high the tops reach. The gap between this and the base is how tall the clouds are.' },
+    { key: 'featureSize', label: 'Feature size', group: 'shape', min: 600, max: 9000, step: 10, unit: 'm', description: 'How big individual clouds are. Small makes a busy sky of many clouds, large makes a few huge ones.' },
+    { key: 'detailSize', label: 'Detail size', group: 'shape', min: 150, max: 2000, step: 10, unit: 'm', description: 'The size of the fine bumps and wisps on the cloud surface.' },
+    { key: 'detailStrength', label: 'Detail erosion', group: 'shape', min: 0, max: 1, step: 0.005, description: 'How much the edges are eaten away into wisps. Low gives smooth blobs, high gives ragged, torn edges.' },
+    { key: 'curlStrength', label: 'Curl warp', group: 'shape', min: 0, max: 2, step: 0.01, description: 'Adds a swirling twist to the wisps, like cloud caught in a breeze.' },
+    { key: 'weatherCellSize', label: 'Weather cell size', group: 'shape', min: 4000, max: 90000, step: 250, unit: 'm', description: 'How large an area shares the same weather. Big values give one huge system, small gives patchy skies.' },
+    { key: 'shear', label: 'Wind shear', group: 'shape', min: 0, max: 1.2, step: 0.005, description: 'Leans the clouds over as they rise, like wind pushing the tops sideways.' },
+    { key: 'anvil', label: 'Anvil spread', group: 'shape', min: 0, max: 1, step: 0.01, types: ['cumulonimbus'], description: 'Spreads the top of a storm cloud out flat, the classic anvil shape. Storm clouds only.' },
+    { key: 'precipitation', label: 'Precipitation', group: 'shape', min: 0, max: 1, step: 0.01, types: ['cumulonimbus'], description: 'Darkens the underside to a heavy rain-bearing grey. Storm clouds only.' },
+    { key: 'windBearing', label: 'Wind bearing', group: 'animation', min: 0, max: 360, step: 1, unit: 'deg', description: 'The compass direction the clouds drift towards.' },
+    { key: 'windSpeed', label: 'Wind speed', group: 'animation', min: 0, max: 40, step: 0.1, unit: 'm/s', description: 'How fast the clouds drift across the sky.' },
+    { key: 'rise', label: 'Convective rise', group: 'animation', min: 0, max: 12, step: 0.05, unit: 'm/s', description: 'How fast the clouds boil upwards, as warm air lifts through them.' },
+    { key: 'churn', label: 'Detail churn', group: 'animation', min: 0, max: 24, step: 0.1, unit: 'm/s', description: 'How quickly the fine surface detail shifts and bubbles.' },
+    { key: 'evolution', label: 'Formation / decay', group: 'animation', min: 0, max: 1, step: 0.01, description: 'How fast clouds form and fade away over time. Zero freezes the sky.' },
+    { key: 'extinction', label: 'Extinction', group: 'scattering', min: 0.002, max: 0.06, step: 0.0005, unit: '1/m', description: 'How much light the cloud blocks. Higher makes it more opaque and its shadows deeper.' },
+    { key: 'forwardLobe', label: 'Forward lobe', group: 'scattering', min: 0, max: 0.97, step: 0.005, description: 'The bright halo when you look towards the sun through cloud.' },
+    { key: 'backLobe', label: 'Back lobe', group: 'scattering', min: 0, max: 0.9, step: 0.005, description: 'A soft glow when the sun is behind you.' },
+    { key: 'msExtinction', label: 'MS extinction decay', group: 'scattering', min: 0.1, max: 0.95, step: 0.005, advanced: true, description: 'Fine tuning for how deep light reaches into the cloud. Lower brightens the interior.' },
+    { key: 'msEnergy', label: 'MS energy decay', group: 'scattering', min: 0.1, max: 0.95, step: 0.005, advanced: true, description: 'Fine tuning for how much bounced light survives. Higher lifts the shadowed side.' },
+    { key: 'msPhase', label: 'MS phase decay', group: 'scattering', min: 0.1, max: 0.95, step: 0.005, advanced: true, description: 'Fine tuning for how the glow spreads as light bounces around inside.' },
+    { key: 'powder', label: 'Powder', group: 'scattering', min: 0, max: 1.5, step: 0.01, description: 'Darkens the edges facing away from the sun, which gives clouds their sense of bulk.' },
+    { key: 'silverLining', label: 'Silver lining', group: 'scattering', min: 0, max: 4, step: 0.01, description: 'The bright rim on a cloud with the sun directly behind it.' },
+    { key: 'ambient', label: 'Ambient', group: 'scattering', min: 0, max: 3, step: 0.01, description: 'How much light the cloud picks up from the sky and ground around it. Lifts the shadows.' },
+    { key: 'aerialPerspective', label: 'Aerial perspective', group: 'lighting', min: 0, max: 0.00012, step: 0.000001, unit: '1/m', description: 'How quickly distant clouds fade into the haze.' },
 ];
 export const CIRRUS_SCHEMA = [
-    { key: 'altitude', label: 'Altitude', group: 'shape', min: 4000, max: 14000, step: 50, unit: 'm', description: 'Base of the ice sheet. Real cirrus sits at 6-12 km; below ~5 km it stops reading as ice.' },
-    { key: 'thickness', label: 'Thickness', group: 'shape', min: 100, max: 2500, step: 25, unit: 'm', description: 'Slab depth. Three samples cross it regardless, so this mostly sets what a grazing ray accumulates.' },
-    { key: 'coverage', label: 'Coverage', group: 'shape', min: 0, max: 1, step: 0.005, description: 'Fraction of sky the sheets occupy.' },
-    { key: 'opticalDepth', label: 'Optical depth', group: 'shape', min: 0, max: 2, step: 0.01, description: 'Calibrated so 1.0 gives vertical optical depth around 0.5 — cirrus you can see the sun through.' },
-    { key: 'featureSize', label: 'Feature size', group: 'shape', min: 8000, max: 120000, step: 500, unit: 'm', description: 'Size of a streak band before anisotropy is applied.' },
-    { key: 'anisotropy', label: 'Anisotropy', group: 'shape', min: 0.03, max: 1, step: 0.005, description: '1.0 gives round blobs; 0.1 gives the drawn-out fibratus streaks cirrus is recognised by.' },
-    { key: 'windBearing', label: 'Wind bearing', group: 'animation', min: 0, max: 360, step: 1, unit: 'deg', description: 'Also the streak axis — the noise is rotated into this frame before being compressed.' },
-    { key: 'windSpeed', label: 'Drift speed', group: 'animation', min: 0, max: 60, step: 0.5, unit: 'm/s', description: 'High-altitude winds are fast; values well above a cumulus field are correct here.' },
-    { key: 'halo', label: '22 degree halo', group: 'lighting', min: 0, max: 2, step: 0.01, description: 'Refraction minimum of a hexagonal ice prism. The strongest cue that this is ice, not thin water cloud.' },
-    { key: 'forwardLobe', label: 'Forward lobe', group: 'scattering', min: 0, max: 0.97, step: 0.005, description: 'Ice scatters hard forward — higher than any water cloud value.' },
-    { key: 'secondaryLobe', label: 'Secondary lobe', group: 'scattering', min: 0, max: 0.9, step: 0.005, description: 'Mixed at 0.35 to widen the forward peak rather than add backscatter.' },
-    { key: 'ambient', label: 'Ambient', group: 'scattering', min: 0, max: 3, step: 0.01, description: 'Sky fill. Cirrus has almost no self-shadow, so this mainly sets its floor brightness.' },
-    { key: 'aerialPerspective', label: 'Aerial perspective', group: 'lighting', min: 0, max: 0.00012, step: 0.000001, unit: '1/m', description: 'Applied at 0.55 strength, since cirrus is above most of the atmosphere.' },
+    { key: 'altitude', label: 'Altitude', group: 'shape', min: 4000, max: 14000, step: 50, unit: 'm', description: 'How high the ice sheet floats. Real cirrus sits far above ordinary cloud.' },
+    { key: 'thickness', label: 'Thickness', group: 'shape', min: 100, max: 2500, step: 25, unit: 'm', description: 'How deep the ice layer is.' },
+    { key: 'coverage', label: 'Coverage', group: 'shape', min: 0, max: 1, step: 0.005, description: 'How much of the sky is filled with cloud. Low leaves scattered puffs, high closes it into solid overcast.' },
+    { key: 'opticalDepth', label: 'Optical depth', group: 'shape', min: 0, max: 2, step: 0.01, description: 'How solid the ice looks. Keep it low — you should be able to see the sun through cirrus.' },
+    { key: 'featureSize', label: 'Feature size', group: 'shape', min: 8000, max: 120000, step: 500, unit: 'm', description: 'How big individual clouds are. Small makes a busy sky of many clouds, large makes a few huge ones.' },
+    { key: 'anisotropy', label: 'Anisotropy', group: 'shape', min: 0.03, max: 1, step: 0.005, description: 'How stretched the streaks are. Low gives long drawn-out fibres, high gives rounder patches.' },
+    { key: 'windBearing', label: 'Wind bearing', group: 'animation', min: 0, max: 360, step: 1, unit: 'deg', description: 'The compass direction the clouds drift towards.' },
+    { key: 'windSpeed', label: 'Drift speed', group: 'animation', min: 0, max: 60, step: 0.5, unit: 'm/s', description: 'How fast the clouds drift across the sky.' },
+    { key: 'halo', label: '22 degree halo', group: 'lighting', min: 0, max: 2, step: 0.01, description: 'The ring of light that appears around the sun when it shines through ice crystals.' },
+    { key: 'forwardLobe', label: 'Forward lobe', group: 'scattering', min: 0, max: 0.97, step: 0.005, description: 'The bright halo when you look towards the sun through cloud.' },
+    { key: 'secondaryLobe', label: 'Secondary lobe', group: 'scattering', min: 0, max: 0.9, step: 0.005, description: 'Widens the glow around the sun rather than adding brightness behind you.' },
+    { key: 'ambient', label: 'Ambient', group: 'scattering', min: 0, max: 3, step: 0.01, description: 'How much light the cloud picks up from the sky and ground around it. Lifts the shadows.' },
+    { key: 'aerialPerspective', label: 'Aerial perspective', group: 'lighting', min: 0, max: 0.00012, step: 0.000001, unit: '1/m', description: 'How quickly distant clouds fade into the haze.' },
+];
+export const THUNDER_SCHEMA = [
+    { key: 'rate', label: 'Flash rate', group: 'animation', min: 0.5, max: 60, step: 0.5, unit: '/min', description: 'How often lightning strikes, in flashes per minute.' },
+    { key: 'intensity', label: 'Intensity', group: 'lighting', min: 0, max: 40, step: 0.1, description: 'How bright each flash is.' },
+    { key: 'color', label: 'Bolt colour', group: 'lighting', valueType: 'color', description: 'The colour of the lightning. Real bolts are a cold blue-white.' },
+    { key: 'radius', label: 'Glow radius', group: 'lighting', min: 100, max: 6000, step: 25, unit: 'm', description: 'How wide the glow spreads from the bolt. Large lights up a whole cloud, small keeps it to one spot.' },
+    { key: 'scatter', label: 'Scatter depth', group: 'scattering', min: 0, max: 2, step: 0.01, description: 'How deep the light pushes through the cloud. Low lights the whole cloud, high keeps a tight bright core.' },
+    { key: 'strokes', label: 'Strokes', group: 'animation', min: 1, max: 6, step: 1, description: 'How many times each bolt flickers. Real lightning stutters two to five times rather than flashing once.' },
+    { key: 'strokeDuration', label: 'Stroke length', group: 'animation', min: 0.01, max: 0.3, step: 0.005, unit: 's', description: 'How long each flicker lasts. Longer stops feeling electric.' },
+    { key: 'sceneFlash', label: 'Scene flash', group: 'lighting', min: 0, max: 1, step: 0.01, description: 'How much the rest of the scene lights up. At zero only the cloud flashes, which looks wrong.' },
+    { key: 'originHeight', label: 'Origin height', group: 'shape', min: 0, max: 1, step: 0.01, description: 'How high up in the cloud the bolt sits. Low is where real lightning starts.' },
+    { key: 'spread', label: 'Spread', group: 'shape', min: 500, max: 40000, step: 100, unit: 'm', description: 'How far away lightning can strike. Bolts always appear somewhere you can see.' },
 ];
 export const CLOUD_QUALITY_SCHEMA = [
-    { key: 'resolutionScale', label: 'Render scale', group: 'quality', min: 0.25, max: 1, step: 0.05, description: 'Fraction of full resolution the march runs at. 0.5 is the sweet spot with the temporal resolve on.' },
-    { key: 'temporalBlend', label: 'Temporal blend', group: 'quality', min: 0, max: 0.97, step: 0.005, description: 'History weight when the camera is still. Higher converges further and ghosts more.' },
-    { key: 'steps', label: 'Step budget', group: 'quality', min: 24, max: 176, step: 1, description: 'Sets the fine step as depth/steps*2. Empty space is skipped coarser regardless.' },
-    { key: 'lightSteps', label: 'Light steps', group: 'quality', min: 2, max: 6, step: 1, advanced: true, description: 'Samples toward the sun per shaded point, spread inside a cone so self-shadowing is soft.' },
-    { key: 'lightStep', label: 'Light step', group: 'quality', min: 0.004, max: 0.09, step: 0.001, advanced: true, description: 'First shadow step as a fraction of cloud depth. A fraction, not metres, so one value fits any deck.' },
-    { key: 'stepGrowth', label: 'Distance step scale', group: 'quality', min: 0.0005, max: 0.03, step: 0.0005, advanced: true, description: 'Step size as a fraction of distance. Too small and near-horizontal rays run out of steps before the horizon, cutting the deck along a straight line; too large and distant cloud loses its shape.' },
-    { key: 'maxSpan', label: 'Max march span', group: 'quality', min: 4000, max: 250000, step: 1000, unit: 'm', description: 'Hard cap on ray length. Keep it far enough out that aerial perspective has dissolved the deck before the cut, or the cut shows as a straight edge at the horizon.' },
-    { key: 'detailFadeDistance', label: 'Detail fade distance', group: 'quality', min: 2000, max: 80000, step: 500, unit: 'm', description: 'Distance over which high-frequency erosion fades out. Removes far-field speckle.' },
-    { key: 'curvature', label: 'Planetary curvature', group: 'quality', min: 0, max: 0.0000005, step: 0.00000001, advanced: true, description: '1/(2R). Bends the ray so the deck meets a real horizon. Zero gives a flat deck.' },
-    { key: 'exposure', label: 'Exposure', group: 'quality', min: 0.2, max: 4, step: 0.01, description: 'Applied in the composite, since this pass owns the final image.' },
+    { key: 'resolutionScale', label: 'Render scale', group: 'quality', min: 0.25, max: 1, step: 0.05, description: 'How sharply the clouds are drawn. Lower is faster but softer. 0.5 is the sweet spot.' },
+    { key: 'temporalBlend', label: 'Temporal blend', group: 'quality', min: 0, max: 0.97, step: 0.005, description: 'Smooths the clouds by blending with the previous frame. Higher is cleaner but can smear when you move.' },
+    { key: 'steps', label: 'Step budget', group: 'quality', min: 24, max: 176, step: 1, description: 'How carefully the clouds are traced. Higher looks better and costs more.' },
+    { key: 'lightSteps', label: 'Light steps', group: 'quality', min: 2, max: 6, step: 1, advanced: true, description: 'How carefully shadows inside the cloud are worked out. Lower flattens them.' },
+    { key: 'lightStep', label: 'Light step', group: 'quality', min: 0.004, max: 0.09, step: 0.001, advanced: true, description: 'How far apart those shadow checks are spread through the cloud.' },
+    { key: 'stepGrowth', label: 'Distance step scale', group: 'quality', min: 0.0005, max: 0.03, step: 0.0005, advanced: true, description: 'Lets distant clouds be traced more coarsely, since they cover fewer pixels anyway.' },
+    { key: 'maxSpan', label: 'Max march span', group: 'quality', min: 4000, max: 250000, step: 1000, unit: 'm', description: 'How far into the distance clouds are still drawn.' },
+    { key: 'detailFadeDistance', label: 'Detail fade distance', group: 'quality', min: 2000, max: 80000, step: 500, unit: 'm', description: 'How far away clouds keep their fine detail before smoothing out.' },
+    { key: 'curvature', label: 'Planetary curvature', group: 'quality', min: 0, max: 0.0000005, step: 0.00000001, advanced: true, description: 'Bends the cloud layer with the curve of the earth so it meets a real horizon.' },
+    { key: 'exposure', label: 'Exposure', group: 'quality', min: 0.2, max: 4, step: 0.01, description: 'Overall brightness of the clouds.' },
 ];
 export const defaultVolumetricCloudsSettings = {
     id: '3drise-clouds',
     type: 'clouds',
     config: { ...defaultCumulusConfig, enabled: false },
     cirrus: { ...defaultCirrusConfig, enabled: false },
+    thunder: { ...defaultThunderConfig },
     quality: { ...defaultCloudsQuality },
 };
 /**
@@ -277,6 +303,12 @@ export function normalizeCirrus(raw) {
         return null;
     return { ...defaultCirrusConfig, ...raw };
 }
+/** Thunder merged over defaults. Unlike cirrus this returns a config even when the
+ *  block is absent, because the default is `enabled: false` — nothing appears, and a
+ *  scene saved before thunder existed simply has it switched off. */
+export function normalizeThunder(raw) {
+    return { ...defaultThunderConfig, ...(isRecord(raw) ? raw : {}) };
+}
 export function normalizeCloudQuality(raw) {
     return { ...defaultCloudsQuality, ...(isRecord(raw) ? raw : {}) };
 }

package/dist/types/index.d.ts

@@ -1,9 +1,9 @@
 export type { ObjectReadyProps, ObjectReadySource, OnObjectDispose, OnObjectReady, } from './objectReady';
 export type { AnyGridConfig, CircuitGridConfig, ContourGridConfig, FractalGridConfig, GridCellMode, GridLineMode, GridSurfaceConfig, HexGridConfig, MoireGridConfig, QuasiGridConfig, RadarGridConfig, VoronoiGridConfig, } from './gridConfigs';
-export type { CirrusLayerConfig, CloudAnimatableProperty, CloudDeckConfig, CloudDeckSurfaceConfig, CloudDeckType, CloudPropertyGroup, CloudPropertySchema, CloudsQualityConfig, VolumetricCloudsSettings, } from './cloudConfigs';
+export type { CirrusLayerConfig, CloudAnimatableProperty, CloudDeckConfig, CloudDeckSurfaceConfig, CloudDeckType, CloudPropertyGroup, CloudPropertySchema, CloudsQualityConfig, ThunderConfig, VolumetricCloudsSettings, } from './cloudConfigs';
 export type { ProceduralTerrainSettings, TerrainConfig, TerrainPropertyGroup, TerrainPropertySchema, TerrainQualityConfig, TerrainSurfaceConfig, TerrainType, } from './terrainConfigs';
 export { TERRAIN_DEFAULTS, TERRAIN_QUALITY_SCHEMA, TERRAIN_SCHEMA, defaultCanyonConfig, defaultDunesConfig, defaultHillsConfig, defaultMountainsConfig, defaultProceduralTerrainSettings, defaultTerrainQuality, normalizeTerrain, normalizeTerrainQuality, normalizeTerrainSettings, } from './terrainConfigs';
-export { CIRRUS_SCHEMA, CLOUD_ANIMATABLE_PROPERTIES, CLOUD_DECK_DEFAULTS, CLOUD_DECK_SCHEMA, CLOUD_QUALITY_SCHEMA, defaultCirrusConfig, defaultCloudsQuality, defaultCumulonimbusConfig, defaultCumulusConfig, defaultStratocumulusConfig, defaultVolumetricCloudsSettings, normalizeCirrus, normalizeCloudDeck, normalizeCloudQuality, } from './cloudConfigs';
+export { CIRRUS_SCHEMA, CLOUD_ANIMATABLE_PROPERTIES, CLOUD_DECK_DEFAULTS, CLOUD_DECK_SCHEMA, CLOUD_QUALITY_SCHEMA, defaultCirrusConfig, defaultCloudsQuality, defaultCumulonimbusConfig, defaultCumulusConfig, defaultStratocumulusConfig, defaultThunderConfig, defaultVolumetricCloudsSettings, normalizeCirrus, normalizeCloudDeck, normalizeCloudQuality, normalizeThunder, THUNDER_SCHEMA, } from './cloudConfigs';
 export type { OceanConfig, OceanMeshSettings, OceanPropertyGroup, OceanPropertySchema, OceanQualityConfig, OceanSurfaceConfig, OceanWaterSettings, ReflectionMode, TerrainInteraction, WaterHost, WaterType, WaveModel, } from './oceanConfigs';
 export { OCEAN_DEFAULTS, OCEAN_QUALITY_SCHEMA, OCEAN_SCHEMA, OBJECT_HOST_OVERRIDES, defaultLakeConfig, defaultOceanQuality, defaultOceanWaterSettings, defaultSeaConfig, defaultShoreConfig, defaultStormConfig, normalizeOcean, normalizeOceanQuality, normalizeOceanSettings, } from './oceanConfigs';
 export type { AutoSplatConfig, HeightEncoding, LandscapeConfig, LandscapeHost, LandscapePropertyGroup, LandscapePropertySchema, LandscapeQualityConfig, LandscapeSettings, LandscapeSurface, SplatSource, } from './landscapeConfigs';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,aAAa,GACd,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,eAAe,EACf,eAAe,EACf,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,iBAAiB,EACjB,uBAAuB,EACvB,eAAe,EACf,sBAAsB,EACtB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,yBAAyB,EACzB,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,gCAAgC,EAChC,qBAAqB,EACrB,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,aAAa,EACb,2BAA2B,EAC3B,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,oBAAoB,EACpB,0BAA0B,EAC1B,+BAA+B,EAC/B,eAAe,EACf,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,SAAS,EACT,SAAS,EACT,SAAS,GACV,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,EACzB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,eAAe,EACf,cAAc,EACd,eAAe,EACf,aAAa,EACb,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,EAC7B,0BAA0B,EAC1B,2BAA2B,EAC3B,2BAA2B,EAC3B,sBAAsB,EACtB,wBAAwB,EACxB,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,kBAAkB,EAClB,yBAAyB,EACzB,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,aAAa,GACd,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,eAAe,EACf,eAAe,EACf,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,iBAAiB,EACjB,uBAAuB,EACvB,eAAe,EACf,sBAAsB,EACtB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,yBAAyB,EACzB,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,gCAAgC,EAChC,qBAAqB,EACrB,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,aAAa,EACb,2BAA2B,EAC3B,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,oBAAoB,EACpB,0BAA0B,EAC1B,oBAAoB,EACpB,+BAA+B,EAC/B,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,GACf,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,SAAS,EACT,SAAS,EACT,SAAS,GACV,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,EACzB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,eAAe,EACf,cAAc,EACd,eAAe,EACf,aAAa,EACb,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,EAC7B,0BAA0B,EAC1B,2BAA2B,EAC3B,2BAA2B,EAC3B,sBAAsB,EACtB,wBAAwB,EACxB,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,kBAAkB,EAClB,yBAAyB,EACzB,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC"}

package/dist/types/index.js

@@ -1,4 +1,4 @@
 export { TERRAIN_DEFAULTS, TERRAIN_QUALITY_SCHEMA, TERRAIN_SCHEMA, defaultCanyonConfig, defaultDunesConfig, defaultHillsConfig, defaultMountainsConfig, defaultProceduralTerrainSettings, defaultTerrainQuality, normalizeTerrain, normalizeTerrainQuality, normalizeTerrainSettings, } from './terrainConfigs.js';
-export { CIRRUS_SCHEMA, CLOUD_ANIMATABLE_PROPERTIES, CLOUD_DECK_DEFAULTS, CLOUD_DECK_SCHEMA, CLOUD_QUALITY_SCHEMA, defaultCirrusConfig, defaultCloudsQuality, defaultCumulonimbusConfig, defaultCumulusConfig, defaultStratocumulusConfig, defaultVolumetricCloudsSettings, normalizeCirrus, normalizeCloudDeck, normalizeCloudQuality, } from './cloudConfigs.js';
+export { CIRRUS_SCHEMA, CLOUD_ANIMATABLE_PROPERTIES, CLOUD_DECK_DEFAULTS, CLOUD_DECK_SCHEMA, CLOUD_QUALITY_SCHEMA, defaultCirrusConfig, defaultCloudsQuality, defaultCumulonimbusConfig, defaultCumulusConfig, defaultStratocumulusConfig, defaultThunderConfig, defaultVolumetricCloudsSettings, normalizeCirrus, normalizeCloudDeck, normalizeCloudQuality, normalizeThunder, THUNDER_SCHEMA, } from './cloudConfigs.js';
 export { OCEAN_DEFAULTS, OCEAN_QUALITY_SCHEMA, OCEAN_SCHEMA, OBJECT_HOST_OVERRIDES, defaultLakeConfig, defaultOceanQuality, defaultOceanWaterSettings, defaultSeaConfig, defaultShoreConfig, defaultStormConfig, normalizeOcean, normalizeOceanQuality, normalizeOceanSettings, } from './oceanConfigs.js';
 export { LANDSCAPE_AUTOSPLAT_SCHEMA, LANDSCAPE_LIVE_AUTOSPLAT_KEYS, LANDSCAPE_LIVE_CONFIG_KEYS, LANDSCAPE_LIVE_QUALITY_KEYS, LANDSCAPE_LIVE_SURFACE_KEYS, LANDSCAPE_REBUILD_KEYS, LANDSCAPE_QUALITY_SCHEMA, LANDSCAPE_SCHEMA, MAX_LANDSCAPE_SURFACES, MAX_OBJECT_SURFACES, defaultAutoSplat, defaultLandscapeConfig, defaultLandscapeQuality, defaultLandscapeSettings, defaultLandscapeSurface, normalizeLandscape, normalizeLandscapeQuality, normalizeLandscapeSettings, normalizeLandscapeSurface, } from './landscapeConfigs.js';

package/dist/utils/cloudShadowMap.d.ts

@@ -0,0 +1,43 @@
+import * as THREE from 'three';
+/**
+ * The cloud shadow map, shared with every surface material that wants it.
+ *
+ * These are three.js *shared uniform objects*: a material that spreads
+ * `cloudShadowUniforms` into its own uniforms holds a reference to the same
+ * `{ value }` boxes, so the cloud pass updates them once per frame and terrain,
+ * ocean, landscape and anything else see the new texture without knowing about each
+ * other. Same idea as THREE.UniformsLib.
+ *
+ * The alternative — threading the texture down as props, or having each material
+ * poll a registry per frame — means every new surface material has to be taught
+ * about clouds. This way it costs one line at the material and nothing at the call
+ * site, which is the only version that will actually get adopted across a codebase
+ * with three custom surface shaders and an open-ended set of object materials.
+ */
+export declare const cloudShadowUniforms: {
+    /** R channel is transmittance along the sun ray: 1 lit, 0 fully shadowed. */
+    u_cloudShadowMap: {
+        value: THREE.Texture | null;
+    };
+    /** World -> shadow clip. The chunk does the 0.5 bias itself. */
+    u_cloudShadowMatrix: {
+        value: THREE.Matrix4;
+    };
+    /** 0 disables the lookup entirely, so an unused material pays one compare. */
+    u_cloudShadowStrength: {
+        value: number;
+    };
+};
+/** Called by the cloud pass each frame. Nothing else should write these. */
+export declare function publishCloudShadowMap(texture: THREE.Texture | null, matrix: THREE.Matrix4 | null, strength: number): void;
+/**
+ * Orthographic frame for the shadow camera, looking along the sun.
+ *
+ * Centred ahead of the viewer rather than on it: shadows behind the camera are
+ * never seen, so spending half the map on them halves the effective resolution for
+ * no reason. Snapped to texel increments — without that, the map slides
+ * continuously as the camera moves and the shadow edges crawl and shimmer, which
+ * is far more distracting than a slightly coarse edge.
+ */
+export declare function updateCloudShadowCamera(camera: THREE.OrthographicCamera, viewer: THREE.Vector3, viewDir: THREE.Vector3, sunDir: THREE.Vector3, extent: number, mapSize: number): void;
+//# sourceMappingURL=cloudShadowMap.d.ts.map