@3driseai/3drise-viewer 0.1.10 → 0.1.12

package/dist/components/CloudsGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CloudsGenerator.d.ts","sourceRoot":"","sources":["../../src/components/CloudsGenerator.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAOtE,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC1D;sFACkF;IAClF,QAAQ,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,GAAG,IAAI,CAAC;IACpD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,uFAAuF;IACvF,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;GAeG;AACH,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CA4CnD,CAAC;AAEF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"CloudsGenerator.d.ts","sourceRoot":"","sources":["../../src/components/CloudsGenerator.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAOtE,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC1D;sFACkF;IAClF,QAAQ,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,GAAG,IAAI,CAAC;IACpD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,uFAAuF;IACvF,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;GAeG;AACH,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CA8CnD,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/components/CloudsGenerator.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { useMemo } from 'react';
-import { CLOUD_DECK_DEFAULTS, normalizeCirrus, normalizeCloudDeck, normalizeCloudQuality } from '../types/cloudConfigs.js';
+import { CLOUD_DECK_DEFAULTS, normalizeCirrus, normalizeCloudDeck, normalizeCloudQuality, normalizeThunder } from '../types/cloudConfigs.js';
 import Cumulus from './volumetricClouds/Cumulus.js';
 import Stratocumulus from './volumetricClouds/Stratocumulus.js';
 import Cumulonimbus from './volumetricClouds/Cumulonimbus.js';
@@ -25,6 +25,7 @@ const CloudsGenerator = ({ settings, skySettings, timeSettings, sunIntensity, on
     const deck = useMemo(() => normalizeCloudDeck(settings?.config), [settings?.config]);
     const cirrus = useMemo(() => normalizeCirrus(settings?.cirrus), [settings?.cirrus]);
     const quality = useMemo(() => normalizeCloudQuality(settings?.quality), [settings?.quality]);
+    const thunder = useMemo(() => normalizeThunder(settings?.thunder), [settings?.thunder]);
     const deckOn = !!deck?.enabled;
     const cirrusOn = !!cirrus?.enabled;
     // The cirrus-only branch ignores the deck entirely (it passes deck={null} to the
@@ -37,6 +38,7 @@ const CloudsGenerator = ({ settings, skySettings, timeSettings, sunIntensity, on
         deck: deckOrDefault,
         cirrus: cirrusOn ? cirrus : null,
         quality,
+        thunder,
         skySettings,
         timeSettings,
         sunIntensity,

package/dist/components/effects/DataStreamEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DataStreamEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/DataStreamEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEhF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,UAAU,qBAAsB,SAAQ,gBAAgB;IACpD,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,gBAAgB,CAAC;IACzB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAqFD,QAAA,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAmDrD,CAAC;AACF,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"DataStreamEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/DataStreamEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEhF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,UAAU,qBAAsB,SAAQ,gBAAgB;IACpD,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,gBAAgB,CAAC;IACzB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAuFD,QAAA,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAoErD,CAAC;AACF,eAAe,gBAAgB,CAAC"}

package/dist/components/effects/DataStreamEffect.js

@@ -18,17 +18,19 @@ const vertexShader = /* glsl */ `
   uniform float uHeight;
   uniform float uPointSize;
   uniform float uIntensity;
+  uniform vec3 uColdColor;
+  uniform vec3 uMidColor;
+  uniform vec3 uHotColor;
+  uniform vec3 uTintColor;
 
   varying float vAlpha;
   varying vec3  vColor;
 
-  // Palette: deep electric blue → cyan → white-gold
+  // Four-stop gradient: cold -> mid -> hot -> tint (config.color)
   vec3 palette(float t) {
-    vec3 cold = vec3(0.05, 0.15, 0.9);   // deep blue
-    vec3 mid  = vec3(0.0,  0.85, 1.0);   // cyan
-    vec3 hot  = vec3(1.0,  0.92, 0.55);  // warm gold-white
-    if (t < 0.5) return mix(cold, mid,  t * 2.0);
-    else          return mix(mid,  hot, (t - 0.5) * 2.0);
+    if (t < 0.333)      return mix(uColdColor, uMidColor,  t * 3.0);
+    else if (t < 0.666)  return mix(uMidColor,  uHotColor, (t - 0.333) * 3.0);
+    else                  return mix(uHotColor,  uTintColor, (t - 0.666) * 3.0);
   }
 
   void main() {
@@ -87,7 +89,7 @@ const fragmentShader = /* glsl */ `
   }
 `;
 const DataStreamEffect = ({ boundingRadius, config, animations, onObjectReady, onObjectDispose }) => {
-    const { particleCount, spiralTurns, streamRadius, inward, particleSize, opacity, speed, intensity } = config;
+    const { particleCount, spiralTurns, streamRadius, inward, particleSize, opacity, speed, intensity, color = '#ffffff', coldColor = '#0d26e6', midColor = '#00d9ff', hotColor = '#ffeb8c', } = config;
     const startValuesCacheRef = useRef({});
     const rootRef = useRef(null);
     useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
@@ -123,13 +125,17 @@ const DataStreamEffect = ({ boundingRadius, config, animations, onObjectReady, o
                 uPointSize: { value: particleSize * 80 },
                 uIntensity: { value: intensity },
                 uOpacity: { value: opacity },
+                uColdColor: { value: new THREE.Color(coldColor) },
+                uMidColor: { value: new THREE.Color(midColor) },
+                uHotColor: { value: new THREE.Color(hotColor) },
+                uTintColor: { value: new THREE.Color(color) },
             },
             transparent: true,
             depthWrite: false,
             blending: THREE.AdditiveBlending,
         });
         return { geometry: geo, material: mat };
-    }, [particleCount, spiralTurns, r, h, inward, particleSize, intensity, speed, opacity]);
+    }, [particleCount, spiralTurns, r, h, inward, particleSize, intensity, speed, opacity, coldColor, midColor, hotColor, color]);
     useFrame((state) => {
         material.uniforms.u_time.value = state.clock.getElapsedTime();
         if (animations?.length) {

package/dist/components/effects/NeuralNetworkEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NeuralNetworkEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/NeuralNetworkEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEnF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,UAAU,wBAAyB,SAAQ,gBAAgB;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AA6BD,QAAA,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CA4J3D,CAAC;AACF,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"NeuralNetworkEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/NeuralNetworkEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEnF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,UAAU,wBAAyB,SAAQ,gBAAgB;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AA+BD,QAAA,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CA4J3D,CAAC;AACF,eAAe,mBAAmB,CAAC"}

package/dist/components/effects/NeuralNetworkEffect.js

@@ -4,7 +4,7 @@ import { useFrame } from '@react-three/fiber';
 import * as THREE from 'three';
 import { applyGenerativeAnimations } from '../../utils/handleGenerativeEffectsAnimations.js';
 import { useObjectReady } from '../../hooks/useObjectReady.js';
-// Glow sprite for pulse signals and node flashes
+// Tight point sprites for electrical signals moving through the connections.
 const pulseVert = /* glsl */ `
   attribute float aBright;
   uniform float   uSize;
@@ -13,7 +13,7 @@ const pulseVert = /* glsl */ `
     vB = aBright;
     if (vB < 0.01) { gl_PointSize = 0.0; gl_Position = vec4(0); return; }
     vec4 mv = modelViewMatrix * vec4(position, 1.0);
-    gl_PointSize = uSize * vB * (200.0 / -mv.z);
+    gl_PointSize = uSize * (0.75 + vB * 0.25) * (200.0 / -mv.z);
     gl_Position  = projectionMatrix * mv;
   }
 `;
@@ -23,10 +23,12 @@ const pulseFrag = /* glsl */ `
   varying float vB;
   void main() {
     if (vB < 0.01) discard;
-    vec2  c = gl_PointCoord - 0.5;
-    if (length(c) > 0.5) discard;
-    float g = exp(-dot(c, c) * 5.5);
-    gl_FragColor = vec4(uColor, g * vB * uOpacity);
+    vec2 c = gl_PointCoord - 0.5;
+    float radius = length(c);
+    if (radius > 0.5) discard;
+    float core = smoothstep(0.24, 0.0, radius);
+    float halo = smoothstep(0.5, 0.12, radius) * 0.2;
+    gl_FragColor = vec4(uColor, (core + halo) * vB * uOpacity);
   }
 `;
 const MAX_PULSES = 4;
@@ -105,7 +107,7 @@ const NeuralNetworkEffect = ({ boundingRadius, config, animations, onObjectReady
         const pulseMat = new THREE.ShaderMaterial({
             vertexShader: pulseVert, fragmentShader: pulseFrag,
             uniforms: {
-                uSize: { value: 20 * intensity },
+                uSize: { value: 7 * intensity },
                 uColor: { value: new THREE.Vector3(pc.r, pc.g, pc.b) },
                 uOpacity: { value: opacity },
             },
@@ -176,11 +178,11 @@ const NeuralNetworkEffect = ({ boundingRadius, config, animations, onObjectReady
             }
             const pos = curPos[p.fromIdx].clone().lerp(curPos[p.toIdx], p.progress);
             ptPos.setXYZ(pi, pos.x, pos.y, pos.z);
-            ptBright.setX(pi, 0.7 + 0.3 * Math.sin(p.progress * Math.PI));
+            ptBright.setX(pi, 0.75 + 0.25 * Math.sin(p.progress * Math.PI * 3.0));
         });
         ptPos.needsUpdate = true;
         ptBright.needsUpdate = true;
-        pulseMat.uniforms.uSize.value = 20 * intensity;
+        pulseMat.uniforms.uSize.value = 7 * intensity;
         if (animations?.length) {
             applyGenerativeAnimations([pulseMat], animations, startValuesCacheRef.current, Date.now(), false);
         }

package/dist/components/volumetricClouds/Cirrus.d.ts

@@ -8,6 +8,10 @@ import type { CloudLayerProps } from './types';
  * case where the deck is switched off entirely, so the deck march is skipped and
  * only the three-sample ice pass runs. That is a fraction of the cost of any
  * volumetric type, which is why a clear-with-cirrus sky is close to free.
+ *
+ * No thunder here, deliberately: a bolt needs a deck to sit inside and a volume to
+ * light. An ice sheet has neither, so the flash would have nowhere to originate and
+ * nothing to scatter through.
  */
 declare const Cirrus: React.FC<CloudLayerProps>;
 export default Cirrus;

package/dist/components/volumetricClouds/Cirrus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Cirrus.d.ts","sourceRoot":"","sources":["../../../src/components/volumetricClouds/Cirrus.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;;;;GAQG;AACH,QAAA,MAAM,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAErC,CAAC;AACF,eAAe,MAAM,CAAC"}
+{"version":3,"file":"Cirrus.d.ts","sourceRoot":"","sources":["../../../src/components/volumetricClouds/Cirrus.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;;;;;;;;GAYG;AACH,QAAA,MAAM,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAErC,CAAC;AACF,eAAe,MAAM,CAAC"}

package/dist/components/volumetricClouds/Cirrus.js

@@ -8,6 +8,10 @@ import VolumetricCloudsPass from './VolumetricCloudsPass.js';
  * case where the deck is switched off entirely, so the deck march is skipped and
  * only the three-sample ice pass runs. That is a fraction of the cost of any
  * volumetric type, which is why a clear-with-cirrus sky is close to free.
+ *
+ * No thunder here, deliberately: a bolt needs a deck to sit inside and a volume to
+ * light. An ice sheet has neither, so the flash would have nowhere to originate and
+ * nothing to scatter through.
  */
 const Cirrus = ({ cirrus, quality, skySettings, timeSettings, sunIntensity, animations, mouseMove, id, onObjectReady, onObjectDispose }) => (_jsx(VolumetricCloudsPass, { deck: null, cirrus: cirrus, quality: quality, skySettings: skySettings, timeSettings: timeSettings, sunIntensity: sunIntensity, animations: animations, mouseMove: mouseMove, id: id, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }));
 export default Cirrus;

package/dist/components/volumetricClouds/Cumulonimbus.js

@@ -13,8 +13,8 @@ import VolumetricCloudsPass from './VolumetricCloudsPass.js';
  * Cost scales with depth, since the fine step is derived from it, so a shallow step
  * budget on a 9 km tower gives kilometre steps and loses the structure. Floored here.
  */
-const Cumulonimbus = ({ deck, cirrus, quality, skySettings, timeSettings, sunIntensity, animations, mouseMove, id, onObjectReady, onObjectDispose }) => {
+const Cumulonimbus = ({ deck, cirrus, quality, thunder, skySettings, timeSettings, sunIntensity, animations, mouseMove, id, onObjectReady, onObjectDispose }) => {
     const resolvedQuality = useMemo(() => ({ ...quality, steps: Math.max(quality.steps, 96) }), [quality]);
-    return (_jsx(VolumetricCloudsPass, { deck: deck, cirrus: cirrus, quality: resolvedQuality, skySettings: skySettings, timeSettings: timeSettings, sunIntensity: sunIntensity, animations: animations, mouseMove: mouseMove, id: id, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }));
+    return (_jsx(VolumetricCloudsPass, { deck: deck, cirrus: cirrus, quality: resolvedQuality, thunder: thunder, skySettings: skySettings, timeSettings: timeSettings, sunIntensity: sunIntensity, animations: animations, mouseMove: mouseMove, id: id, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }));
 };
 export default Cumulonimbus;

package/dist/components/volumetricClouds/Cumulus.js

@@ -10,8 +10,8 @@ import VolumetricCloudsPass from './VolumetricCloudsPass.js';
  * inside the shader anyway, so leaving a stale value in the config would do nothing
  * visible while making the panel read as though it should.
  */
-const Cumulus = ({ deck, cirrus, quality, skySettings, timeSettings, sunIntensity, animations, mouseMove, id, onObjectReady, onObjectDispose }) => {
+const Cumulus = ({ deck, cirrus, quality, thunder, skySettings, timeSettings, sunIntensity, animations, mouseMove, id, onObjectReady, onObjectDispose }) => {
     const resolved = useMemo(() => ({ ...deck, anvil: 0, precipitation: 0 }), [deck]);
-    return (_jsx(VolumetricCloudsPass, { deck: resolved, cirrus: cirrus, quality: quality, skySettings: skySettings, timeSettings: timeSettings, sunIntensity: sunIntensity, animations: animations, mouseMove: mouseMove, id: id, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }));
+    return (_jsx(VolumetricCloudsPass, { deck: resolved, cirrus: cirrus, quality: quality, thunder: thunder, skySettings: skySettings, timeSettings: timeSettings, sunIntensity: sunIntensity, animations: animations, mouseMove: mouseMove, id: id, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }));
 };
 export default Cumulus;

package/dist/components/volumetricClouds/Stratocumulus.js

@@ -8,9 +8,9 @@ import VolumetricCloudsPass from './VolumetricCloudsPass.js';
  * small and a large step budget is wasted; it is capped here. Anvil and
  * precipitation are off for the same reason as cumulus.
  */
-const Stratocumulus = ({ deck, cirrus, quality, skySettings, timeSettings, sunIntensity, animations, mouseMove, id, onObjectReady, onObjectDispose }) => {
+const Stratocumulus = ({ deck, cirrus, quality, thunder, skySettings, timeSettings, sunIntensity, animations, mouseMove, id, onObjectReady, onObjectDispose }) => {
     const resolved = useMemo(() => ({ ...deck, anvil: 0, precipitation: 0 }), [deck]);
     const resolvedQuality = useMemo(() => ({ ...quality, steps: Math.min(quality.steps, 112) }), [quality]);
-    return (_jsx(VolumetricCloudsPass, { deck: resolved, cirrus: cirrus, quality: resolvedQuality, skySettings: skySettings, timeSettings: timeSettings, sunIntensity: sunIntensity, animations: animations, mouseMove: mouseMove, id: id, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }));
+    return (_jsx(VolumetricCloudsPass, { deck: resolved, cirrus: cirrus, quality: resolvedQuality, thunder: thunder, skySettings: skySettings, timeSettings: timeSettings, sunIntensity: sunIntensity, animations: animations, mouseMove: mouseMove, id: id, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }));
 };
 export default Stratocumulus;

package/dist/components/volumetricClouds/VolumetricCloudsPass.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
 import type { ObjectReadyProps } from '../../types/objectReady';
 import type { SkySettings, TimeSettings } from '@3driseai/3drise-core';
-import type { CirrusLayerConfig, CloudDeckConfig, CloudsQualityConfig } from '../../types/cloudConfigs';
+import type { CirrusLayerConfig, CloudDeckConfig, CloudsQualityConfig, ThunderConfig } from '../../types/cloudConfigs';
 import type { ObjectAnimations, MouseMoveInteractions } from '@3driseai/3drise-core';
 /**
  * The cloud render pipeline. The only component in this package that takes over
@@ -28,6 +28,9 @@ export interface VolumetricCloudsPassProps extends ObjectReadyProps {
     deck?: CloudDeckConfig | null;
     cirrus?: CirrusLayerConfig | null;
     quality: CloudsQualityConfig;
+    /** Lightning. Needs a deck — the bolt sits inside it and lights it from within —
+     *  so it is ignored on the cirrus-only path. */
+    thunder?: ThunderConfig;
     skySettings?: SkySettings;
     timeSettings?: TimeSettings;
     /** Multiplies sun radiance for the clouds only. Matches SkySystem's sunIntensity. */

package/dist/components/volumetricClouds/VolumetricCloudsPass.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VolumetricCloudsPass.d.ts","sourceRoot":"","sources":["../../../src/components/volumetricClouds/VolumetricCloudsPass.tsx"],"names":[],"mappings":"AACA,OAAO,KAAkD,MAAM,OAAO,CAAC;AAIvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAQvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAExG,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAErF;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,yBAA0B,SAAQ,gBAAgB;IAC/D,6EAA6E;IAC7E,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAC9B,MAAM,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAClC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,qFAAqF;IACrF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,6DAA6D;IAC7D,SAAS,CAAC,EAAE,qBAAqB,CAAC;CACrC;AAkBD,QAAA,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,yBAAyB,CA0S7D,CAAC;AAEF,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"VolumetricCloudsPass.d.ts","sourceRoot":"","sources":["../../../src/components/volumetricClouds/VolumetricCloudsPass.tsx"],"names":[],"mappings":"AACA,OAAO,KAAkD,MAAM,OAAO,CAAC;AAKvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAQvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEvH,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAErF;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,yBAA0B,SAAQ,gBAAgB;IAC/D,6EAA6E;IAC7E,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAC9B,MAAM,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAClC,OAAO,EAAE,mBAAmB,CAAC;IAC7B;oDACgD;IAChD,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,qFAAqF;IACrF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,6DAA6D;IAC7D,SAAS,CAAC,EAAE,qBAAqB,CAAC;CACrC;AAkBD,QAAA,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,yBAAyB,CAmW7D,CAAC;AAEF,eAAe,oBAAoB,CAAC"}

package/dist/components/volumetricClouds/VolumetricCloudsPass.js

@@ -3,6 +3,7 @@ import * as THREE from 'three';
 import { useCallback, useEffect, useMemo, useRef } from 'react';
 import { useFrame, useThree } from '@react-three/fiber';
 import { useFrameRenderer } from '../../hooks/useFrameRenderer.js';
+import { useThunder } from '../../hooks/useThunder.js';
 import { useObjectReady } from '../../hooks/useObjectReady.js';
 import { CLOUD_LIVE_KEY } from '../../hooks/useCloudLive.js';
 import { useCloudNoise } from '../../hooks/useCloudNoise.js';
@@ -11,7 +12,7 @@ import { CloudVolumeMaterial } from '../../shaders/clouds/CloudVolumeMaterial.js
 import { CirrusMaterial } from '../../shaders/clouds/CirrusMaterial.js';
 import { CloudResolveMaterial } from '../../shaders/clouds/CloudResolveMaterial.js';
 import { CloudCompositeMaterial } from '../../shaders/clouds/CloudCompositeMaterial.js';
-import { applyCameraUniforms, applyCirrusUniforms, applyDeckUniforms, applySunUniforms, } from '../../utils/cloudUniforms.js';
+import { applyCameraUniforms, applyCirrusUniforms, applyDeckUniforms, applySunUniforms, applyThunderUniforms } from '../../utils/cloudUniforms.js';
 import { applyCloudsKeyframeAnimations, applyCloudsMouseMove, resolveDeckConfig, } from '../../utils/handleCloudsAnimations.js';
 const quad = new THREE.PlaneGeometry(2, 2);
 const orthoCam = new THREE.OrthographicCamera(-1, 1, 1, -1, 0, 1);
@@ -26,7 +27,7 @@ function emptyTexture() {
     tex.needsUpdate = true;
     return tex;
 }
-const VolumetricCloudsPass = ({ id = '3drise-clouds', deck, cirrus, quality, skySettings, timeSettings, sunIntensity = 1, animations, mouseMove, onObjectReady, onObjectDispose, }) => {
+const VolumetricCloudsPass = ({ id = '3drise-clouds', deck, cirrus, quality, thunder, skySettings, timeSettings, sunIntensity = 1, animations, mouseMove, onObjectReady, onObjectDispose, }) => {
     const gl = useThree((s) => s.gl);
     const scene = useThree((s) => s.scene);
     const size = useThree((s) => s.size);
@@ -107,16 +108,29 @@ const VolumetricCloudsPass = ({ id = '3drise-clouds', deck, cirrus, quality, sky
     // React tree sixty times a second.
     const override = useRef({});
     const startValues = useRef({});
+    // When the current animation set started, in ms. calculateTimeProgress divides by
+    // duration, so it wants time *since the animation began* — not a wall clock and not
+    // seconds. Reset when the animations change so editing one restarts it from the
+    // beginning rather than dropping the user somewhere mid-cycle.
+    const animStart = useRef(0);
+    useEffect(() => {
+        animStart.current = performance.now();
+        startValues.current = {};
+    }, [animations]);
     // Live controller overrides. A slider drag writes here every pointer-move and the
     // frame loop reads it on top of the config, so the deck responds without a Redux
     // dispatch per frame. Cleared when the config identity changes, which is exactly
     // slider-end committing the same value.
+    const thunderDriver = useThunder();
+    const boltRef = useRef(null);
     const liveDeck = useRef({});
+    const liveThunder = useRef({});
     const liveCirrus = useRef({});
     const liveQuality = useRef({});
     useEffect(() => { liveDeck.current = {}; }, [deck]);
     useEffect(() => { liveCirrus.current = {}; }, [cirrus]);
     useEffect(() => { liveQuality.current = {}; }, [quality]);
+    useEffect(() => { liveThunder.current = {}; }, [thunder]);
     // The handle a controller reaches through findById(id).userData. Set in an effect,
     // never as a userData JSX prop: R3F replaces the whole userData object on every
     // render, which would drop the handle the moment anything above re-renders.
@@ -125,6 +139,7 @@ const VolumetricCloudsPass = ({ id = '3drise-clouds', deck, cirrus, quality, sky
         deck: (key, value) => { liveDeck.current[key] = value; },
         cirrus: (key, value) => { liveCirrus.current[key] = value; },
         quality: (key, value) => { liveQuality.current[key] = value; },
+        thunder: (key, value) => { liveThunder.current[key] = value; },
     }), []);
     useEffect(() => {
         const root = rootRef.current;
@@ -159,6 +174,29 @@ const VolumetricCloudsPass = ({ id = '3drise-clouds', deck, cirrus, quality, sky
         frame.current += 1;
         time.current += Math.min(delta, 0.05);
         updateSun();
+        // Lightning is scheduled on the CPU because three things need the same event:
+        // the emission uniforms, the scene light, and the temporal blend below.
+        const liveThunderCfg = (thunder
+            ? { ...thunder, ...liveThunder.current }
+            : undefined);
+        const bolt = (liveThunderCfg && deck)
+            ? thunderDriver.update(delta, deck, liveThunderCfg, camera)
+            : null;
+        // The scene light is what stops the flash looking like it happens in a
+        // separate universe from the ground. decay 0 / distance 0 on purpose: a bolt
+        // 2 km up with physical falloff contributes nothing at ground level, and what
+        // a distant flash actually does is brighten everything at once.
+        if (boltRef.current) {
+            const lit = bolt && liveThunderCfg
+                ? bolt.intensity * liveThunderCfg.sceneFlash
+                : 0;
+            boltRef.current.intensity = lit;
+            boltRef.current.visible = lit > 0.001;
+            if (lit > 0.001) {
+                boltRef.current.position.copy(bolt.position);
+                boltRef.current.color.set(liveThunderCfg.color);
+            }
+        }
         // ---- 1. scene ----
         const sceneRT = (frame.current & 1) ? targets.sceneA : targets.sceneB;
         const prevTarget = gl.getRenderTarget();
@@ -194,7 +232,7 @@ const VolumetricCloudsPass = ({ id = '3drise-clouds', deck, cirrus, quality, sky
             // the pointer snapping back to the stored config every frame.
             for (const k in override.current)
                 delete override.current[k];
-            applyCloudsKeyframeAnimations(animations?.clouds?.animations, startValues.current, deck, override.current, time.current);
+            applyCloudsKeyframeAnimations(animations?.clouds?.animations, startValues.current, deck, override.current, performance.now() - animStart.current);
             if (mouseMove?.enabled && mouseMove.clouds?.enabled) {
                 applyCloudsMouseMove(mouseMove.clouds.properties, deck, override.current, pointer);
             }
@@ -204,6 +242,12 @@ const VolumetricCloudsPass = ({ id = '3drise-clouds', deck, cirrus, quality, sky
             const liveQual = { ...quality, ...liveQuality.current };
             const m = passes.deckMat;
             applyDeckUniforms(m, live, liveQual);
+            if (liveThunderCfg && bolt) {
+                applyThunderUniforms(m, liveThunderCfg, bolt.intensity, bolt.position);
+            }
+            else if (m.uniforms.u_flash) {
+                m.uniforms.u_flash.value = 0;
+            }
             m.uniforms.u_base.value = noise.base;
             m.uniforms.u_detail.value = noise.detail;
             m.uniforms.u_weather.value = noise.weather;
@@ -236,6 +280,13 @@ const VolumetricCloudsPass = ({ id = '3drise-clouds', deck, cirrus, quality, sky
             // and a high history weight smears. Ease off, and restore it once still.
             const moved = camera.position.distanceToSquared(prevCamPos.current) > 1e-8
                 || Math.abs(camera.quaternion.dot(prevCamQuat.current)) < 0.9999995;
+            // Deliberately NOT special-cased for lightning. The resolve clamps history
+            // to the 3x3 neighbourhood of the current frame before blending, and that
+            // clamp already handles a flash in both directions: dark history is pulled
+            // up when the bolt fires, and the bright frame is clamped away the moment
+            // it stops. Dropping the blend during a flash — which is what this used to
+            // do — throws away the temporal accumulation that turns the march's
+            // sub-pixel jitter into detail, and the whole deck visibly shakes.
             r.u_blend.value = moved ? Math.min(quality.temporalBlend, 0.7) : quality.temporalBlend;
             gl.setRenderTarget(destination);
             gl.render(passes.resolveScene, orthoCam);
@@ -293,6 +344,6 @@ const VolumetricCloudsPass = ({ id = '3drise-clouds', deck, cirrus, quality, sky
     useFrameRenderer(renderCompleteFrame);
     // An empty group, but a real one: it carries userData.id so findById() can reach
     // this layer, and the live handle so a controller can drive it without Redux.
-    return _jsx("group", { ref: rootRef });
+    return (_jsx("group", { ref: rootRef, children: _jsx("pointLight", { ref: boltRef, visible: false, intensity: 0, distance: 0, decay: 0 }) }));
 };
 export default VolumetricCloudsPass;

package/dist/components/volumetricClouds/types.d.ts

@@ -1,6 +1,6 @@
 import type { MouseMoveInteractions, ObjectAnimations, SkySettings, TimeSettings } from '@3driseai/3drise-core';
 import type { ObjectReadyProps } from '../../types/objectReady';
-import type { CirrusLayerConfig, CloudDeckConfig, CloudsQualityConfig } from '../../types/cloudConfigs';
+import type { CirrusLayerConfig, CloudDeckConfig, CloudsQualityConfig, ThunderConfig } from '../../types/cloudConfigs';
 /** Shared by every layer component. The generator hands all four the same shape. */
 export interface CloudLayerProps extends ObjectReadyProps {
     /** Scene id, so a controller can findById() the layer and drive it live. */
@@ -8,6 +8,8 @@ export interface CloudLayerProps extends ObjectReadyProps {
     deck: CloudDeckConfig;
     cirrus: CirrusLayerConfig | null;
     quality: CloudsQualityConfig;
+    /** Lightning. Absent or disabled means the flash path never runs. */
+    thunder?: ThunderConfig;
     skySettings?: SkySettings;
     timeSettings?: TimeSettings;
     sunIntensity?: number;

package/dist/components/volumetricClouds/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/volumetricClouds/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAExG,oFAAoF;AACpF,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACrD,4EAA4E;IAC5E,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACjC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,SAAS,CAAC,EAAE,qBAAqB,CAAC;CACrC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/volumetricClouds/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEvH,oFAAoF;AACpF,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACrD,4EAA4E;IAC5E,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACjC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,qEAAqE;IACrE,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,SAAS,CAAC,EAAE,qBAAqB,CAAC;CACrC"}

package/dist/hooks/index.d.ts

@@ -25,6 +25,8 @@ export { useCubeCamera } from './useCubeCamera';
 export type { UseEnvironmentProbeOptions } from './useEnvironmentProbe';
 export { useEnvironmentProbe } from './useEnvironmentProbe';
 export { useFrameRenderer } from './useFrameRenderer';
+export type { ThunderDriver, ThunderState } from './useThunder';
+export { createThunderDriver, useThunder } from './useThunder';
 export type { UseEnvironmentEffectsOptions } from './useEnvironmentEffects';
 export { useEnvironmentEffects } from './useEnvironmentEffects';
 export { useFrameAnimations } from './useFrameAnimations';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAKA,YAAY,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEhF,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhE,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE7D,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9D,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEpE,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEvF,YAAY,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACtG,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/D,YAAY,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,YAAY,EAAE,4BAA4B,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AACzG,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAEhD,YAAY,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,YAAY,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,YAAY,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,YAAY,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC7G,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE1E,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC5G,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/hooks/index.js

@@ -17,6 +17,7 @@ export { useContinuousEffects } from './useContinuousEffects.js';
 export { useCubeCamera } from './useCubeCamera.js';
 export { useEnvironmentProbe } from './useEnvironmentProbe.js';
 export { useFrameRenderer } from './useFrameRenderer.js';
+export { createThunderDriver, useThunder } from './useThunder.js';
 export { useEnvironmentEffects } from './useEnvironmentEffects.js';
 export { useFrameAnimations } from './useFrameAnimations.js';
 export { useFrameEffects } from './useFrameEffects.js';

package/dist/hooks/useCloudLive.d.ts

@@ -18,6 +18,7 @@ export interface CloudLiveHandle {
     deck(key: string, value: number | boolean): void;
     cirrus(key: string, value: number | boolean): void;
     quality(key: string, value: number | boolean): void;
+    thunder(key: string, value: number | boolean | string): void;
 }
 /**
  * Safe before the layer mounts and after it unmounts: the handle is resolved at call

package/dist/hooks/useCloudLive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCloudLive.d.ts","sourceRoot":"","sources":["../../src/hooks/useCloudLive.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAGtC;;;;;;;;;;;;GAYG;AAEH,mFAAmF;AACnF,eAAO,MAAM,cAAc,gBAAgB,CAAC;AAE5C,MAAM,WAAW,eAAe;IAC5B,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IACjD,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IACnD,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;CACvD;AAID;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,GAAG,eAAe,CAkB/E;AAED,eAAe,YAAY,CAAC"}
+{"version":3,"file":"useCloudLive.d.ts","sourceRoot":"","sources":["../../src/hooks/useCloudLive.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAGtC;;;;;;;;;;;;GAYG;AAEH,mFAAmF;AACnF,eAAO,MAAM,cAAc,gBAAgB,CAAC;AAE5C,MAAM,WAAW,eAAe;IAC5B,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IACjD,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IACnD,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IACpD,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;CAChE;AAID;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,GAAG,eAAe,CAmB/E;AAED,eAAe,YAAY,CAAC"}

package/dist/hooks/useCloudLive.js

@@ -15,7 +15,7 @@ import { findById } from '../utils/sceneQuery.js';
  */
 /** Where VolumetricCloudsPass stashes its handle on the root object's userData. */
 export const CLOUD_LIVE_KEY = '__cloudLive';
-const NOOP = { deck: () => { }, cirrus: () => { }, quality: () => { } };
+const NOOP = { deck: () => { }, cirrus: () => { }, quality: () => { }, thunder: () => { } };
 /**
  * Safe before the layer mounts and after it unmounts: the handle is resolved at call
  * time, not at hook time, so a controller opened before the scene is ready still works
@@ -37,6 +37,7 @@ export function useCloudLive(target) {
             deck: (key, value) => resolve().deck(key, value),
             cirrus: (key, value) => resolve().cirrus(key, value),
             quality: (key, value) => resolve().quality(key, value),
+            thunder: (key, value) => resolve().thunder(key, value),
         };
     }, [target]);
 }

package/dist/hooks/useThunder.d.ts

@@ -0,0 +1,37 @@
+import * as THREE from 'three';
+import type { CloudDeckConfig, ThunderConfig } from '../types/cloudConfigs';
+/**
+ * Flash scheduling for lightning.
+ *
+ * On the CPU rather than as a time hash in the shader, because three consumers need
+ * the *same* event: the volumetric emission uniforms, the scene light, and the
+ * temporal resolve (which has to stop blending while a flash is on screen, or the
+ * flash both under-reads and then ghosts for twenty frames). A GPU-side hash can
+ * drive only the first of those.
+ *
+ * Two things make it read as lightning rather than a blinking lamp:
+ *
+ *  - **Exponential spacing.** Storms do not fire on a metronome. Waiting an
+ *    exponentially distributed interval around the mean rate is the actual arrival
+ *    process, and it costs one log().
+ *  - **Multi-stroke flicker.** A single bolt is 2-5 return strokes over ~200 ms, each
+ *    a fast attack and exponential decay. One clean flash looks synthetic; the
+ *    stutter is what the eye recognises.
+ */
+export interface ThunderState {
+    /** 0 when dark. Peaks at ThunderConfig.intensity. */
+    intensity: number;
+    /** Bolt position in world space. Only meaningful while intensity > 0. */
+    position: THREE.Vector3;
+    /** True while the bolt is actually emitting light. */
+    active: boolean;
+}
+export interface ThunderDriver {
+    /** Advance by delta seconds and return the current state. */
+    update(dt: number, deck: CloudDeckConfig, cfg: ThunderConfig, camera: THREE.Camera): ThunderState;
+}
+export declare function createThunderDriver(): ThunderDriver;
+/** One driver per mounted pass, stable across renders. */
+export declare function useThunder(): ThunderDriver;
+export default useThunder;
+//# sourceMappingURL=useThunder.d.ts.map

package/dist/hooks/useThunder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useThunder.d.ts","sourceRoot":"","sources":["../../src/hooks/useThunder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE5E;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,YAAY;IACzB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC;IACxB,sDAAsD;IACtD,MAAM,EAAE,OAAO,CAAC;CACnB;AAID,MAAM,WAAW,aAAa;IAC1B,6DAA6D;IAC7D,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,YAAY,CAAC;CACrG;AAuED,wBAAgB,mBAAmB,IAAI,aAAa,CAiEnD;AAED,0DAA0D;AAC1D,wBAAgB,UAAU,IAAI,aAAa,CAM1C;AAED,eAAe,UAAU,CAAC"}