@3driseai/3drise-viewer 0.1.28 → 0.1.29

package/dist/components/SkySystem.js

@@ -4,9 +4,10 @@ import { useEffect, useLayoutEffect, useMemo, useRef, forwardRef, useImperativeH
 import { useFrame } from '@react-three/fiber';
 import { skySystemManager } from '@3driseai/3drise-core';
 import Skybox from './Skybox.js';
-import Lensflare from './Lensflare.js';
 import SunLight from './SunLight.js';
+import MoonDisc from './MoonDisc.js';
 import SkyController from './SkyController.js';
+import SkyStars from './SkyStars.js';
 import SceneFog from './SceneFog.js';
 import CloudsGenerator from './CloudsGenerator.js';
 const SkySystem = forwardRef(({ timeSettings, visible = true, sunSystemVisible = false, sunSize = 1, moonSize = 1, skyboxScale = 100000, sunIntensity = 1, castShadow = true, shadowMapSize = 2048, playerPosition, cloudsSettings, skyControllerSettings, fogSettings, onTimeOfDayChange, onTimeUpdate, driveTime = true, onObjectReady, onObjectDispose, }, ref) => {
@@ -81,7 +82,12 @@ const SkySystem = forwardRef(({ timeSettings, visible = true, sunSystemVisible =
     });
     if (!visible)
         return null;
-    return (_jsxs("group", { ref: rootRef, children: [skyControllerSettings && !sunSystemVisible && (_jsx(SkyController, { settings: skyControllerSettings, timeSettings: timeSettings, scale: skyboxScale, ...ready })), sunSystemVisible && (_jsxs(_Fragment, { children: [_jsx(Skybox, { visible: true, scale: skyboxScale, sunSize: sunSize, moonSize: moonSize, timeSettings: timeSettings, ...ready }), _jsx(Lensflare, { visible: true, intensity: sunIntensity, timeSettings: timeSettings, ...ready }), _jsx(SunLight, { visible: true, timeSettings: timeSettings, targetPosition: playerPosition, intensity: sunIntensity, castShadow: castShadow, shadowMapSize: shadowMapSize, ...ready })] })), fogSettings && _jsx(SceneFog, { fog: fogSettings }), cloudsSettings && (_jsx(CloudsGenerator, { settings: cloudsSettings, skySettings: skyControllerSettings, timeSettings: timeSettings, sunIntensity: sunIntensity, ...ready }))] }));
+    // The key light exists whenever there is a sky to own the sun — either
+    // renderer. It is the scene's only sun while mounted (LightsManager's sun
+    // stands down), and it reads the same resolved sun as clouds, water and
+    // terrain.
+    const skyActive = !!skyControllerSettings?.visible || sunSystemVisible;
+    return (_jsxs("group", { ref: rootRef, children: [skyControllerSettings && !sunSystemVisible && (_jsx(SkyController, { settings: skyControllerSettings, timeSettings: timeSettings, scale: skyboxScale, ...ready })), sunSystemVisible && (_jsx(_Fragment, { children: _jsx(Skybox, { visible: true, scale: skyboxScale, sunSize: sunSize, moonSize: moonSize, timeSettings: timeSettings, ...ready }) })), skyActive && (_jsx(SunLight, { visible: true, timeSettings: timeSettings, skySettings: skyControllerSettings, targetPosition: playerPosition, intensity: sunIntensity, moonIntensity: skyControllerSettings?.sunSystem?.moonIntensity ?? 1, castShadow: castShadow, shadowMapSize: shadowMapSize, ...ready })), (skyActive ? skyControllerSettings?.stars?.visible !== false : skyControllerSettings?.stars?.visible === true) && (_jsx(SkyStars, { timeSettings: timeSettings, skySettings: skyControllerSettings, stars: skyControllerSettings?.stars })), skyActive && (_jsx(MoonDisc, { timeSettings: timeSettings, skySettings: skyControllerSettings, size: moonSize })), fogSettings && _jsx(SceneFog, { fog: fogSettings }), cloudsSettings && (_jsx(CloudsGenerator, { settings: cloudsSettings, skySettings: skyControllerSettings, timeSettings: timeSettings, sunIntensity: sunIntensity, ...ready }))] }));
 });
 SkySystem.displayName = 'SkySystem';
 export default SkySystem;

package/dist/components/Sun.d.ts

@@ -1,4 +1,16 @@
+import type { MutableRefObject } from 'react';
+import * as THREE from 'three';
 import type { ObjectReadyProps } from '../types/objectReady';
+/** Live tint / brightness for the sun, written by its owner's push point (SolarSystem). */
+export interface SunControl {
+    /** Tint relative to REFERENCE_TINT: the reference keeps the sun's own palette. */
+    color: THREE.Color;
+    /** Brightness relative to REFERENCE_INTENSITY. */
+    intensity: number;
+}
+/** The SolarSystem defaults: at these values the sun looks exactly as it was designed. */
+export declare const SUN_REFERENCE_TINT: THREE.Color;
+export declare const SUN_REFERENCE_INTENSITY = 3;
 type SunProps = ObjectReadyProps & {
     /** Radius of the sun core. Default 1. */
     radius?: number;
@@ -10,7 +22,9 @@ type SunProps = ObjectReadyProps & {
     coronaUniforms?: Record<string, any>;
     /** Uniform overrides for SunFlareMaterial. */
     flareUniforms?: Record<string, any>;
+    /** Read every frame: tints the surface ramp, the corona and the light, and scales their brightness. */
+    control?: MutableRefObject<SunControl>;
 };
-export default function Sun({ radius, coronaScale, coreUniforms, coronaUniforms, flareUniforms, onObjectReady, onObjectDispose, }: SunProps): import("react").JSX.Element;
+export default function Sun({ radius, coronaScale, coreUniforms, coronaUniforms, flareUniforms, control, onObjectReady, onObjectDispose, }: SunProps): import("react").JSX.Element;
 export {};
 //# sourceMappingURL=Sun.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Sun.d.ts","sourceRoot":"","sources":["../../src/components/Sun.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAI7D,KAAK,QAAQ,GAAG,gBAAgB,GAAG;IAC/B,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnC,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrC,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACvC,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,GAAG,CAAC,EAAE,MAAU,EAAE,WAAkB,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,GAAG,EAAE,QAAQ,+BAIrJ"}
+{"version":3,"file":"Sun.d.ts","sourceRoot":"","sources":["../../src/components/Sun.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAI7D,2FAA2F;AAC3F,MAAM,WAAW,UAAU;IACvB,kFAAkF;IAClF,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;IACnB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,0FAA0F;AAC1F,eAAO,MAAM,kBAAkB,aAA6B,CAAC;AAC7D,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,KAAK,QAAQ,GAAG,gBAAgB,GAAG;IAC/B,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnC,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrC,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACpC,uGAAuG;IACvG,OAAO,CAAC,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;CAC1C,CAAC;AAeF,MAAM,CAAC,OAAO,UAAU,GAAG,CAAC,EAAE,MAAU,EAAE,WAAkB,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,EAAE,eAAe,GAAG,EAAE,QAAQ,+BA6C9J"}

package/dist/components/Sun.js

@@ -1,11 +1,72 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useRef } from 'react';
+import * as THREE from 'three';
+import { useFrame } from '@react-three/fiber';
 import { useObjectReady } from '../hooks/useObjectReady.js';
-// import { ReactNode } from "react";
 import SunCore from "./SunCore.js";
 import Corona from "./effects/Corona.js";
-export default function Sun({ radius = 1, coronaScale = 1.25, coreUniforms, coronaUniforms, flareUniforms, onObjectReady, onObjectDispose, }) {
+/** The SolarSystem defaults: at these values the sun looks exactly as it was designed. */
+export const SUN_REFERENCE_TINT = new THREE.Color('#ffd27a');
+export const SUN_REFERENCE_INTENSITY = 3;
+const LAVA_COLORS = ['u_color1', 'u_color2', 'u_color3', 'u_color4', 'u_color5', 'u_rimColor'];
+const CORONA_COLORS = ['u_innerColor', 'u_outerColor'];
+const LIGHT_COLOR = '#ffa544';
+const LIGHT_INTENSITY = 6;
+export default function Sun({ radius = 1, coronaScale = 1.25, coreUniforms, coronaUniforms, flareUniforms, control, onObjectReady, onObjectDispose, }) {
     const rootRef = useRef(null);
+    const lightRef = useRef(null);
+    const cache = useRef(null);
+    const ratio = useRef(new THREE.Vector3());
     useObjectReady(rootRef, { radius, coronaScale }, onObjectReady, onObjectDispose);
-    return (_jsxs("group", { ref: rootRef, children: [_jsx(SunCore, { radius: radius, uniforms: coreUniforms }), _jsx(Corona, { radius: radius, shellScale: coronaScale, uniforms: coronaUniforms }), _jsx("pointLight", { color: "#ffa544", intensity: 6, distance: 60, decay: 1.6 })] }));
+    useFrame(() => {
+        if (!control || !rootRef.current)
+            return;
+        if (!cache.current) {
+            const c = { lava: null, corona: null, light: lightRef.current, base: {} };
+            rootRef.current.traverse((o) => {
+                const u = o.material?.uniforms;
+                if (!u)
+                    return;
+                if (u.u_color1 && !c.lava)
+                    c.lava = o.material;
+                else if (u.u_innerColor && !c.corona)
+                    c.corona = o.material;
+            });
+            if (!c.lava || !c.corona || !c.light)
+                return;
+            // Own the vectors before writing into them: shaderMaterial defaults may be shared between instances.
+            for (const k of LAVA_COLORS) {
+                const u = c.lava.uniforms[k];
+                c.base[k] = u.value.clone();
+                u.value = u.value.clone();
+            }
+            for (const k of CORONA_COLORS) {
+                const u = c.corona.uniforms[k];
+                c.base[k] = u.value.clone();
+                u.value = u.value.clone();
+            }
+            c.base.u_brightness = c.lava.uniforms.u_brightness.value;
+            c.base.u_intensity = c.corona.uniforms.u_intensity?.value ?? 1;
+            cache.current = c;
+        }
+        const c = cache.current;
+        const { color, intensity } = control.current;
+        // Per-channel ratio to the reference tint (clamped): the designed palette at the reference.
+        ratio.current.set(Math.min(4, color.r / SUN_REFERENCE_TINT.r), Math.min(4, color.g / SUN_REFERENCE_TINT.g), Math.min(4, color.b / SUN_REFERENCE_TINT.b));
+        const gain = Math.max(0, intensity / SUN_REFERENCE_INTENSITY);
+        for (const k of LAVA_COLORS)
+            c.lava.uniforms[k].value.copy(c.base[k]).multiply(ratio.current);
+        for (const k of CORONA_COLORS)
+            c.corona.uniforms[k].value.copy(c.base[k]).multiply(ratio.current);
+        c.lava.uniforms.u_brightness.value = c.base.u_brightness * gain;
+        if (c.corona.uniforms.u_intensity)
+            c.corona.uniforms.u_intensity.value = c.base.u_intensity * gain;
+        const light = c.light;
+        light.color.set(LIGHT_COLOR);
+        light.color.r *= ratio.current.x;
+        light.color.g *= ratio.current.y;
+        light.color.b *= ratio.current.z;
+        light.intensity = LIGHT_INTENSITY * gain;
+    });
+    return (_jsxs("group", { ref: rootRef, children: [_jsx(SunCore, { radius: radius, uniforms: coreUniforms }), _jsx(Corona, { radius: radius, shellScale: coronaScale, uniforms: coronaUniforms }), _jsx("pointLight", { ref: lightRef, color: LIGHT_COLOR, intensity: LIGHT_INTENSITY, distance: 60, decay: 1.6 })] }));
 }

package/dist/components/SunLight.d.ts

@@ -1,13 +1,18 @@
 import type { ObjectReadyProps } from '../types/objectReady';
 import * as THREE from 'three';
 import React from "react";
-import type { TimeSettings } from "@3driseai/3drise-core";
+import type { SkySettings, TimeSettings } from "@3driseai/3drise-core";
 export interface SunLightProps extends ObjectReadyProps {
     visible?: boolean;
     timeSettings: TimeSettings;
+    /** The sky this sun belongs to — the static sun when time of day is off and
+     *  no Preetham sky is publishing what it drew. */
+    skySettings?: SkySettings;
     targetPosition?: THREE.Vector3;
     shadowDistance?: number;
     intensity?: number;
+    /** Multiplier on moonlight. */
+    moonIntensity?: number;
     castShadow?: boolean;
     shadowMapSize?: number;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"SunLight.d.ts","sourceRoot":"","sources":["../../src/components/SunLight.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,MAAM,WAAW,aAAc,SAAQ,gBAAgB;IACnD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,YAAY,CAAC;IAC3B,cAAc,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAiBD,QAAA,MAAM,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CA0CrC,CAAC;AACF,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"SunLight.d.ts","sourceRoot":"","sources":["../../src/components/SunLight.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAKvE,MAAM,WAAW,aAAc,SAAQ,gBAAgB;IACnD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,YAAY,CAAC;IAC3B;sDACkD;IAClD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,cAAc,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAiED,QAAA,MAAM,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CA0DrC,CAAC;AACF,eAAe,QAAQ,CAAC"}

package/dist/components/SunLight.js

@@ -1,59 +1,111 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { useObjectReady } from '../hooks/useObjectReady.js';
-import { useRef, useCallback } from 'react';
+import { useEffect, useRef } from 'react';
 import * as THREE from 'three';
-import { useSkySystem } from '../hooks/useSkySystem.js';
-const COLORS = {
-    white: new THREE.Color(0xffffff),
-    orange: new THREE.Color(0xff4500),
-    moon: new THREE.Color(0xe6e8fa),
+import { useFrame, useThree } from '@react-three/fiber';
+import { useCloudSun, computeCloudSun } from '../hooks/useCloudSun.js';
+import { claimSceneSun } from '../utils/renderedSky.js';
+import { resolveMoon, moonlightFactor, MOON_LIGHT_COLOR } from '../utils/skyMoon.js';
+/**
+ * The scene's key light while a sky is active — the ONE sun.
+ *
+ * Direction comes from useCloudSun, the same resolver the clouds, the water and
+ * the terrain use: what the sky drew this frame, else the day-cycle clock, else
+ * the stored sun. So the disc, the light and every sky-lit surface agree.
+ *
+ * Colour is the direct beam through a clear atmosphere (Kasten-Young air mass,
+ * the cloud model's own computeCloudSun), white-balanced to the overhead sun:
+ * white at noon, warm through the afternoon, deep orange and dim at the horizon,
+ * with no colour tables or hour constants. The atmosphere for the beam is fixed
+ * to clear air on purpose: Preetham's turbidity/rayleigh are artistic sky knobs
+ * (the time curve pushes rayleigh to 3.5 at sunset) and fed into a physical beam
+ * they black the scene out at exactly the hour it should glow.
+ *
+ * Below the horizon it hands over to the moon: one light, so one set of
+ * shadows. Through twilight (sun −1° … −8°) moonlight fades in; its strength
+ * follows the lit fraction of the moon (full bright, new none) and the moon's
+ * own height. Cool tint, weaker and softer shadows. Neither up → light off.
+ *
+ * While mounted it claims the scene's sun, so LightsManager's general-purpose
+ * sun stands down (see claimSceneSun).
+ */
+/** Light intensity for the overhead sun at `intensity` 1. π because three's
+ *  physically-correct lights divide diffuse by π: at π a white surface facing
+ *  the overhead sun renders at its own albedo. Tuning knob. */
+const KEY_BASE_INTENSITY = Math.PI;
+/** Elevation, in degrees, over which the light fades in: the disc is fully
+ *  set at −1° (half-diameter plus refraction) and the beam is unoccluded by 4°. */
+const FADE_START = -1;
+const FADE_END = 4;
+/** Moonlight at full moon, overhead, `moonIntensity` 1. Real moonlight is
+ *  ~1/400 000 of the sun; this is compressed until exposure handles night.
+ *  Tuning knob. */
+const MOON_BASE_INTENSITY = 0.3;
+const SUN_SHADOW_INTENSITY = 1;
+const MOON_SHADOW_INTENSITY = 0.6;
+const smooth01 = (edge0, edge1, x) => {
+    const t = THREE.MathUtils.clamp((x - edge0) / (edge1 - edge0), 0, 1);
+    return t * t * (3 - 2 * t);
 };
-const MAX_ELEVATION = 42;
-const SUNRISE = 6;
-const SUNSET = 21;
-const DARKNESS_START = 20.42;
-const DARKNESS_END = 6.58;
+const elevationOf = (dir) => THREE.MathUtils.radToDeg(Math.asin(THREE.MathUtils.clamp(dir.y, -1, 1)));
+const CLEAR_AIR = { turbidity: 2, rayleigh: 1, mieCoefficient: 0.005 };
+const newSunState = () => ({
+    direction: new THREE.Vector3(),
+    color: new THREE.Color(),
+    skyAmbient: new THREE.Color(),
+    groundAmbient: new THREE.Color(),
+    turbidity: 0, rayleigh: 0, mieCoefficient: 0, mieG: 0,
+});
+/** Beam colour of the sun straight overhead — the white point. */
+const ZENITH = computeCloudSun(new THREE.Vector3(0, 1, 0), CLEAR_AIR, newSunState()).color.clone();
 /** Shared so the default does not hand a fresh Vector3 to the deps array on every
- *  render, which re-ran the reposition effect every time anything above re-rendered. */
+ *  render. */
 const ORIGIN = new THREE.Vector3(0, 0, 0);
-const SunLight = ({ visible = true, timeSettings, targetPosition = ORIGIN, shadowDistance = 300, intensity: intensityMultiplier = 1, castShadow = true, shadowMapSize = 2048, onObjectReady, onObjectDispose, }) => {
+const SunLight = ({ visible = true, timeSettings, skySettings, targetPosition = ORIGIN, shadowDistance = 300, intensity: intensityMultiplier = 1, moonIntensity = 1, castShadow = true, shadowMapSize = 2048, onObjectReady, onObjectDispose, }) => {
     const lightRef = useRef(null);
     useObjectReady(lightRef, { visible, timeSettings, intensity: intensityMultiplier, castShadow, shadowMapSize }, onObjectReady, onObjectDispose);
-    const colorRef = useRef(new THREE.Color(0xffe5b0));
-    const targetColorRef = useRef(new THREE.Color(0xffe5b0));
-    const intensityRef = useRef(1);
-    const targetIntensityRef = useRef(1);
-    const handleTimeUpdate = useCallback((state) => {
-        const { timeInHours, normalizedTime, isDaytime, sunDirection, sunElevation } = state;
-        const isInDarkTransition = (timeInHours >= DARKNESS_START && timeInHours <= SUNSET) ||
-            (timeInHours >= SUNRISE && timeInHours <= DARKNESS_END);
-        if (isDaytime) {
-            const normalizedElevation = Math.min(sunElevation / MAX_ELEVATION, 1);
-            const t = Math.pow(1 - normalizedElevation, 3);
-            targetColorRef.current.lerpColors(COLORS.white, COLORS.orange, t);
-            targetIntensityRef.current = isInDarkTransition
-                ? 0.1
-                : Math.min(40, Math.pow(normalizedElevation, 1.2) * 4);
+    const scene = useThree(s => s.scene);
+    const { update } = useCloudSun({ skySettings, timeSettings });
+    const beam = useRef(newSunState());
+    const moon = useRef({ direction: new THREE.Vector3(), illumination: 0 });
+    useEffect(() => {
+        if (!visible)
+            return;
+        return claimSceneSun(scene);
+    }, [scene, visible]);
+    useFrame(() => {
+        const light = lightRef.current;
+        if (!light)
+            return;
+        const sunDir = update().direction;
+        const sunElevation = elevationOf(sunDir);
+        const sunFade = smooth01(FADE_START, FADE_END, sunElevation);
+        let dir;
+        if (sunFade > 0) {
+            dir = sunDir;
+            const c = computeCloudSun(sunDir, CLEAR_AIR, beam.current).color;
+            light.color.setRGB(Math.min(1, c.r / ZENITH.r), Math.min(1, c.g / ZENITH.g), Math.min(1, c.b / ZENITH.b));
+            light.intensity = KEY_BASE_INTENSITY * intensityMultiplier * sunFade;
+            light.shadow.intensity = SUN_SHADOW_INTENSITY;
         }
         else {
-            targetColorRef.current.copy(COLORS.moon).multiplyScalar(1.8);
-            targetIntensityRef.current = 0.5;
+            // The sun is fully set, so the hand-over is continuous: the sun's term
+            // is already 0 at −1°, which is where night starts fading in.
+            const m = resolveMoon(timeSettings, sunDir, moon.current);
+            dir = m.direction;
+            light.color.setRGB(MOON_LIGHT_COLOR.r, MOON_LIGHT_COLOR.g, MOON_LIGHT_COLOR.b);
+            light.intensity = MOON_BASE_INTENSITY * moonIntensity * moonlightFactor(sunElevation, m);
+            light.shadow.intensity = MOON_SHADOW_INTENSITY;
         }
-        const lerpSpeed = Math.min(1, 2.0 * (state.delta || 1));
-        colorRef.current.lerp(targetColorRef.current, lerpSpeed);
-        intensityRef.current += (targetIntensityRef.current - intensityRef.current) * lerpSpeed;
-        if (lightRef.current) {
-            lightRef.current.position.set(targetPosition.x + sunDirection.x * shadowDistance, targetPosition.y + sunDirection.y * shadowDistance, targetPosition.z + sunDirection.z * shadowDistance);
-            lightRef.current.target.position.copy(targetPosition);
-            lightRef.current.target.updateMatrixWorld();
-            lightRef.current.intensity = intensityRef.current * intensityMultiplier;
-            lightRef.current.color.copy(colorRef.current);
+        if (light.intensity <= 1e-4) {
+            // Off, not dim: an invisible light also skips its shadow pass.
+            light.visible = false;
+            return;
         }
-    }, [targetPosition, shadowDistance, intensityMultiplier]);
-    useSkySystem({
-        timeSettings,
-        onTimeUpdate: handleTimeUpdate,
-        enabled: visible,
+        light.visible = true;
+        light.position.set(targetPosition.x + dir.x * shadowDistance, targetPosition.y + dir.y * shadowDistance, targetPosition.z + dir.z * shadowDistance);
+        light.target.position.copy(targetPosition);
+        light.target.updateMatrixWorld();
     });
     if (!visible)
         return null;

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

@@ -1 +1 @@
-{"version":3,"file":"TerrainBuilder.d.ts","sourceRoot":"","sources":["../../src/components/TerrainBuilder.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,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAOvE,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IACzD;;mEAE+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,GAAG,IAAI,CAAC;IACrD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;GAYG;AACH,QAAA,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CA+BjD,CAAC;AAEF,eAAe,cAAc,CAAC"}
+{"version":3,"file":"TerrainBuilder.d.ts","sourceRoot":"","sources":["../../src/components/TerrainBuilder.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,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAOvE,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IACzD;;mEAE+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,GAAG,IAAI,CAAC;IACrD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;GAYG;AACH,QAAA,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAiCjD,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/components/TerrainBuilder.js

@@ -30,6 +30,8 @@ const TerrainBuilder = ({ settings, skySettings, timeSettings, sunIntensity, onO
         timeSettings,
         sunIntensity,
         id: settings?.id,
+        animations: settings?.animations,
+        mouseMove: settings?.mouseMove,
         onObjectReady,
         onObjectDispose,
     };

package/dist/components/TextGenerator.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { CreatedObjectSettings } from '@3driseai/3drise-core';
+import type { ObjectReadyProps } from '../types/objectReady';
+type TextGeneratorProps = ObjectReadyProps & {
+    createdObject: CreatedObjectSettings;
+};
+declare const TextGenerator: React.FC<TextGeneratorProps>;
+export default TextGenerator;
+//# sourceMappingURL=TextGenerator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TextGenerator.d.ts","sourceRoot":"","sources":["../../src/components/TextGenerator.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,qBAAqB,EAA2C,MAAM,uBAAuB,CAAC;AAC5G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,KAAK,kBAAkB,GAAG,gBAAgB,GAAG;IACzC,aAAa,EAAE,qBAAqB,CAAC;CACxC,CAAC;AAkBF,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAc/C,CAAC;AACF,eAAe,aAAa,CAAC"}

package/dist/components/TextGenerator.js

@@ -0,0 +1,29 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { HandwritingText, NeonTubeText, FourierSketchText, FrostGrowthText, PlasmaDischargeText, BurnAwayText, LightPaintingText, ConstellationText, InkBleedText, LiquidMetalText, EmbroideryText, ChalkboardText } from './text/index.js';
+/** The text looks' components by config.type (the legacy bitmap / 3D text is rendered by ObjectNode, not here). */
+const FAMILY = {
+    handwriting: HandwritingText,
+    neonTube: NeonTubeText,
+    fourierSketch: FourierSketchText,
+    frostGrowth: FrostGrowthText,
+    plasmaDischarge: PlasmaDischargeText,
+    burnAway: BurnAwayText,
+    lightPainting: LightPaintingText,
+    constellation: ConstellationText,
+    inkBleed: InkBleedText,
+    liquidMetal: LiquidMetalText,
+    embroidery: EmbroideryText,
+    chalkboard: ChalkboardText,
+};
+const TextGenerator = ({ createdObject, onObjectReady, onObjectDispose }) => {
+    const config = createdObject.config;
+    if (!config)
+        return null;
+    const Component = FAMILY[config.type];
+    if (!Component)
+        return null;
+    // Every look renders the same way: FAMILY is the only per-key entry. `enabled` is not a gate here: the text stays
+    // mounted and the look plays its erase animation when it goes false.
+    return _jsx(Component, { config: config, id: createdObject.id, keyframes: createdObject.animations?.text?.animations, mouseMove: createdObject.mouseMove?.text, onObjectReady: (_source, ref) => onObjectReady?.(createdObject, ref), onObjectDispose: (_source, ref) => onObjectDispose?.(createdObject, ref) });
+};
+export default TextGenerator;

package/dist/components/TruchetGrid.d.ts

@@ -12,7 +12,7 @@ export interface TruchetGridProps extends ObjectReadyProps {
     /** Pointer bindings on this grid's config knobs (mouseMove.grid). */
     mouseMove?: MouseMoveDomain;
 }
-/** TruchetGridConfig defaults. Must match the catalog entry in grid-defaults.json exactly. */
+/** TruchetGridConfig defaults: the core registry entry (DEFAULT_GRIDS.truchetGrid), never a copy. */
 export declare const defaultTruchetGridConfig: TruchetGridConfig;
 /**
  * Smith quarter-circle Truchet tiles: arcs always meet arcs, so the plane fills with endless two-coloured loops. Tiles re-deal by turning a quarter turn, and comets travel the loops in one direction.

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

@@ -1 +1 @@
-{"version":3,"file":"TruchetGrid.d.ts","sourceRoot":"","sources":["../../src/components/TruchetGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACtD,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAKD,8FAA8F;AAC9F,eAAO,MAAM,wBAAwB,EAAE,iBA2BtC,CAAC;AAWF;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,EAAE,MAAiC,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,gBAAgB,+BA4CxJ;AAED,eAAe,WAAW,CAAC"}
+{"version":3,"file":"TruchetGrid.d.ts","sourceRoot":"","sources":["../../src/components/TruchetGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACtD,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAKD,qGAAqG;AACrG,eAAO,MAAM,wBAAwB,EAA2C,iBAAiB,CAAC;AAWlG;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,EAAE,MAAiC,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,gBAAgB,+BA4CxJ;AAED,eAAe,WAAW,CAAC"}

package/dist/components/TruchetGrid.js

@@ -6,38 +6,11 @@ import { useGridSurface } from '../hooks/useGridSurface.js';
 import { useConfigDriver } from '../hooks/useConfigDriver.js';
 import { withConfigDefaults } from '../utils/configAnimations.js';
 import { applyGridConfig, GRID_STRUCTURAL } from '../utils/gridConfig.js';
-import { TruchetGridMaterial, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
+import { TruchetGridMaterial, DEFAULT_GRIDS, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
 // Side-effect import registers <truchetGridMaterial> via extend().
 void TruchetGridMaterial;
-/** TruchetGridConfig defaults. Must match the catalog entry in grid-defaults.json exactly. */
-export const defaultTruchetGridConfig = {
-    cellSize: 3,
-    size: 50,
-    segments: undefined,
-    lineMode: 0,
-    cellMode: 0,
-    lineWidth: 1.3,
-    sectionSize: 4,
-    sectionWidth: 1.2,
-    animSpeed: 1,
-    animScale: 0.5,
-    animIntensity: 0.6,
-    fadeDistance: undefined,
-    fadeStrength: 0.7,
-    displace: 0,
-    flip: 0.25,
-    bias: 0.5,
-    pulse: 0.8,
-    regionFill: 0.8,
-    lineColor: '#a052e0',
-    sectionColor: '#4a2a66',
-    cellColor: '#2a0f45',
-    glowColor: '#ff7ad9',
-    bgColor: '#07030d',
-    bgOpacity: 0,
-    reveal: 1,
-    revealDuration: 0,
-};
+/** TruchetGridConfig defaults: the core registry entry (DEFAULT_GRIDS.truchetGrid), never a copy. */
+export const defaultTruchetGridConfig = DEFAULT_GRIDS.truchetGrid;
 /** This grid's own uniforms (u_<key>), pushed by applyGridConfig beside the shared surface knobs. */
 const VARIANT = ['flip', 'bias', 'pulse', 'regionFill'];
 /** No computed uniforms: every knob maps straight to its u_<key>. */

package/dist/components/VoronoiGrid.d.ts

@@ -12,7 +12,7 @@ export interface VoronoiGridProps extends ObjectReadyProps {
     /** Pointer bindings on this grid's config knobs (mouseMove.grid). */
     mouseMove?: MouseMoveDomain;
 }
-/** VoronoiGridConfig — the single source of truth for a Voronoi grid instance. */
+/** VoronoiGridConfig defaults: the core registry entry (DEFAULT_GRIDS.voronoiGrid), never a copy. */
 export declare const defaultVoronoiGridConfig: VoronoiGridConfig;
 export declare function VoronoiGrid({ config, groupProps, id, keyframes, mouseMove, onObjectReady, onObjectDispose }: VoronoiGridProps): import("react").JSX.Element;
 export default VoronoiGrid;

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

@@ -1 +1 @@
-{"version":3,"file":"VoronoiGrid.d.ts","sourceRoot":"","sources":["../../src/components/VoronoiGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACtD,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAKD,kFAAkF;AAClF,eAAO,MAAM,wBAAwB,EAAE,iBA2BtC,CAAC;AAoBF,wBAAgB,WAAW,CAAC,EAAE,MAAiC,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,gBAAgB,+BA6CxJ;AAED,eAAe,WAAW,CAAC"}
+{"version":3,"file":"VoronoiGrid.d.ts","sourceRoot":"","sources":["../../src/components/VoronoiGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACtD,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAKD,qGAAqG;AACrG,eAAO,MAAM,wBAAwB,EAA2C,iBAAiB,CAAC;AAoBlG,wBAAgB,WAAW,CAAC,EAAE,MAAiC,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,gBAAgB,+BA6CxJ;AAED,eAAe,WAAW,CAAC"}

package/dist/components/VoronoiGrid.js

@@ -6,38 +6,11 @@ import { useGridSurface } from '../hooks/useGridSurface.js';
 import { useConfigDriver } from '../hooks/useConfigDriver.js';
 import { withConfigDefaults } from '../utils/configAnimations.js';
 import { applyGridConfig, GRID_STRUCTURAL } from '../utils/gridConfig.js';
-import { VoronoiGridMaterial, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
+import { VoronoiGridMaterial, DEFAULT_GRIDS, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
 // Side-effect import registers <voronoiGridMaterial> via extend().
 void VoronoiGridMaterial;
-/** VoronoiGridConfig — the single source of truth for a Voronoi grid instance. */
-export const defaultVoronoiGridConfig = {
-    cellSize: 3,
-    size: 50,
-    segments: undefined,
-    flat: true,
-    lineMode: 1, // ripple out from the focus point
-    cellMode: 2, // twinkle
-    lineWidth: 1.4,
-    sectionSize: 4,
-    sectionWidth: 1,
-    animSpeed: 1,
-    animScale: 0.5,
-    animIntensity: 1,
-    fadeDistance: undefined,
-    fadeStrength: 0.7,
-    displace: 0,
-    jitter: 0.9,
-    drift: 0.5,
-    lineColor: '#5a339e',
-    sectionColor: '#d999ff',
-    cellColor: '#1f0d47',
-    glowColor: '#b366ff',
-    bgColor: '#05030d',
-    bgOpacity: 0,
-    followMouse: false,
-    reveal: 1,
-    revealDuration: 0,
-};
+/** VoronoiGridConfig defaults: the core registry entry (DEFAULT_GRIDS.voronoiGrid), never a copy. */
+export const defaultVoronoiGridConfig = DEFAULT_GRIDS.voronoiGrid;
 /**
  * An irregular cellular lattice on a shader plane.
  *
@@ -63,11 +36,11 @@ export function VoronoiGrid({ config = defaultVoronoiGridConfig, groupProps, id,
     // The committed config over this grid's defaults: every knob has a value to render
     // and for a keyframe or pointer binding to start from.
     const base = useMemo(() => withConfigDefaults(defaultVoronoiGridConfig, config), [config]);
-    const { cellSize, size, segments, flat, displace, followMouse, reveal, revealDuration } = base;
+    const { cellSize, size, segments, displace, reveal, revealDuration } = base;
     const segs = segments ?? (displace > 0
         ? Math.min(384, Math.max(96, Math.ceil(size / Math.max(cellSize, 1e-4)) * 6))
         : 1);
-    useGridSurface(matRef, meshRef, { followMouse, reveal, revealDuration });
+    useGridSurface(matRef, meshRef, { reveal, revealDuration });
     // One push point for every uniform the config owns: the committed config when the
     // material mounts or the config commits, the merged one while anything overrides it.
     const baseRef = useRef(base);
@@ -80,6 +53,6 @@ export function VoronoiGrid({ config = defaultVoronoiGridConfig, groupProps, id,
     useLayoutEffect(() => { applyGridConfig(matRef.current, base, VARIANT, DERIVE); }, [base]);
     const push = useCallback((merged) => applyGridConfig(matRef.current, merged, VARIANT, DERIVE), []);
     useConfigDriver({ rootRef, id, family: 'grids', base, structural: STRUCTURAL, allowed: ANIMATABLE, keyframes, mouseMove, push });
-    return (_jsx("group", { ref: rootRef, ...groupProps, children: _jsxs("mesh", { ref: meshRef, rotation: flat ? [-Math.PI / 2, 0, 0] : [0, 0, 0], children: [_jsx("planeGeometry", { args: [size, size, segs, segs] }), _jsx("voronoiGridMaterial", { ref: setMaterial, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide }, VoronoiGridMaterial.key)] }) }));
+    return (_jsx("group", { ref: rootRef, ...groupProps, children: _jsxs("mesh", { ref: meshRef, rotation: [-Math.PI / 2, 0, 0], children: [_jsx("planeGeometry", { args: [size, size, segs, segs] }), _jsx("voronoiGridMaterial", { ref: setMaterial, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide }, VoronoiGridMaterial.key)] }) }));
 }
 export default VoronoiGrid;

package/dist/components/WallpaperGrid.d.ts

@@ -12,7 +12,7 @@ export interface WallpaperGridProps extends ObjectReadyProps {
     /** Pointer bindings on this grid's config knobs (mouseMove.grid). */
     mouseMove?: MouseMoveDomain;
 }
-/** WallpaperGridConfig defaults. Must match the catalog entry in grid-defaults.json exactly. */
+/** WallpaperGridConfig defaults: the core registry entry (DEFAULT_GRIDS.wallpaperGrid), never a copy. */
 export declare const defaultWallpaperGridConfig: WallpaperGridConfig;
 /**
  * Wallpaper-group kaleidoscope: a drifting lattice-periodic Fourier motif summed over the coset representatives of one of the 17 plane crystallographic groups. The runtime builds the group tables and crossfades from group to group.

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

@@ -1 +1 @@
-{"version":3,"file":"WallpaperGrid.d.ts","sourceRoot":"","sources":["../../src/components/WallpaperGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAQxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IACxD,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAKD,gGAAgG;AAChG,eAAO,MAAM,0BAA0B,EAAE,mBA6BxC,CAAC;AAkQF;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,MAAmC,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,kBAAkB,+BA0D9J;AAED,eAAe,aAAa,CAAC"}
+{"version":3,"file":"WallpaperGrid.d.ts","sourceRoot":"","sources":["../../src/components/WallpaperGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAQxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IACxD,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAKD,yGAAyG;AACzG,eAAO,MAAM,0BAA0B,EAA6C,mBAAmB,CAAC;AAkQxG;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,MAAmC,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,kBAAkB,+BA0D9J;AAED,eAAe,aAAa,CAAC"}

package/dist/components/WallpaperGrid.js

@@ -7,40 +7,11 @@ import { useGridSurface } from '../hooks/useGridSurface.js';
 import { useConfigDriver } from '../hooks/useConfigDriver.js';
 import { withConfigDefaults } from '../utils/configAnimations.js';
 import { applyGridConfig, GRID_STRUCTURAL } from '../utils/gridConfig.js';
-import { WallpaperGridMaterial, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
+import { WallpaperGridMaterial, DEFAULT_GRIDS, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
 // Side-effect import registers <wallpaperGridMaterial> via extend().
 void WallpaperGridMaterial;
-/** WallpaperGridConfig defaults. Must match the catalog entry in grid-defaults.json exactly. */
-export const defaultWallpaperGridConfig = {
-    cellSize: 10,
-    size: 50,
-    flat: true,
-    segments: undefined,
-    lineMode: 2,
-    cellMode: 2,
-    lineWidth: 2,
-    sectionSize: 0,
-    sectionWidth: 1.4,
-    animSpeed: 1,
-    animScale: 0.6,
-    animIntensity: 0.55,
-    fadeDistance: undefined,
-    fadeStrength: 0.7,
-    displace: 0,
-    group: -1,
-    cycleTime: 12,
-    motif: 0.5,
-    levels: 11,
-    lineColor: '#f3d79b',
-    sectionColor: '#7fd6ff',
-    cellColor: '#101c50',
-    glowColor: '#ff9ec7',
-    bgColor: '#05070a',
-    bgOpacity: 0,
-    followMouse: false,
-    reveal: 1,
-    revealDuration: 0,
-};
+/** WallpaperGridConfig defaults: the core registry entry (DEFAULT_GRIDS.wallpaperGrid), never a copy. */
+export const defaultWallpaperGridConfig = DEFAULT_GRIDS.wallpaperGrid;
 // ---------------------------------------------------------------------------
 // The 17 wallpaper groups (Farris, "Creating Symmetry").
 // Each group is listed by its ITA general positions in lattice coordinates:
@@ -341,10 +312,10 @@ export function WallpaperGrid({ config = defaultWallpaperGridConfig, groupProps,
     // The committed config over this grid's defaults: every knob has a value to render
     // and for a keyframe or pointer binding to start from.
     const base = useMemo(() => withConfigDefaults(defaultWallpaperGridConfig, config), [config]);
-    const { cellSize, size, segments, flat, displace, followMouse, reveal, revealDuration } = base;
+    const { cellSize, size, segments, displace, reveal, revealDuration } = base;
     // the motif has up to ~3 waves per unit cell, so 16 vertices per cell keep the displaced relief smooth
     const segs = segments ?? (displace > 0 ? Math.min(512, Math.max(96, Math.ceil(size / Math.max(cellSize, 1e-4)) * 16)) : 1);
-    useGridSurface(matRef, meshRef, { followMouse, reveal, revealDuration });
+    useGridSurface(matRef, meshRef, { reveal, revealDuration });
     // One push point for every uniform the config owns: the committed config when the
     // material mounts or the config commits, the merged one while anything overrides it.
     const baseRef = useRef(base);
@@ -373,6 +344,6 @@ export function WallpaperGrid({ config = defaultWallpaperGridConfig, groupProps,
             runtimeRef.current = null;
         }
     }, []);
-    return (_jsx("group", { ref: rootRef, ...groupProps, children: _jsxs("mesh", { ref: meshRef, rotation: flat ? [-Math.PI / 2, 0, 0] : [0, 0, 0], children: [_jsx("planeGeometry", { args: [size, size, segs, segs] }), _jsx("wallpaperGridMaterial", { ref: setMaterial, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide }, WallpaperGridMaterial.key)] }) }));
+    return (_jsx("group", { ref: rootRef, ...groupProps, children: _jsxs("mesh", { ref: meshRef, rotation: [-Math.PI / 2, 0, 0], children: [_jsx("planeGeometry", { args: [size, size, segs, segs] }), _jsx("wallpaperGridMaterial", { ref: setMaterial, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide }, WallpaperGridMaterial.key)] }) }));
 }
 export default WallpaperGrid;