@3driseai/3drise-viewer 0.1.28 → 0.1.29

package/dist/components/text/useTextObject.js

@@ -0,0 +1,118 @@
+import { useCallback, useEffect, useLayoutEffect, useMemo, useRef } from 'react';
+import * as THREE from 'three';
+import { useFrame } from '@react-three/fiber';
+import { DEFAULT_TEXT_OBJECTS, TEXT_OBJECTS_ANIMATABLE } from '@3driseai/3drise-core';
+import { withConfigDefaults } from '../../utils/configAnimations.js';
+import { useObjectReady } from '../../hooks/useObjectReady.js';
+import { useConfigDriver } from '../../hooks/useConfigDriver.js';
+import { createPlayback } from './engine/playback.js';
+import { VARIANTS } from './engine/variants.js';
+import { layoutOutline, layoutStrokeFont } from './engine/glyphs.js';
+import { loadOutline, loadStrokes } from './fonts/index.js';
+/** One em of the font in world units: the object's own size, so a text of 0.5 m high default. The parent transform does the rest. */
+export const TEXT_EM = 0.5;
+// Keys that are not look knobs.
+const BASE_KEYS = new Set(['type', 'enabled', 'text', 'font', 'drawMethod', 'drawDuration', 'drawEase', 'drawStagger', 'drawAngle',
+    'eraseMethod', 'eraseDuration', 'eraseEase', 'eraseStagger', 'eraseAngle', 'autoPlay', 'loop', 'yoyo', 'holdTime', 'hiddenTime']);
+/** Animation keys that bake a schedule into the geometry: a change rebuilds. */
+const ANIM_STRUCTURAL = ['drawMethod', 'drawStagger', 'drawAngle', 'eraseMethod', 'eraseStagger', 'eraseAngle'];
+const lookKeysOf = (look) => Object.keys(DEFAULT_TEXT_OBJECTS[look]).filter((k) => !BASE_KEYS.has(k));
+const animatableOf = (look) => new Set(TEXT_OBJECTS_ANIMATABLE[look].map((p) => p.value));
+const STATIC = new Map();
+function staticOf(look) {
+    let s = STATIC.get(look);
+    if (!s) {
+        const lookKeys = lookKeysOf(look);
+        const animatable = animatableOf(look);
+        const structuralLook = lookKeys.filter((k) => !animatable.has(k));
+        // Every non-animatable key changes once, on commit: never live.
+        s = { lookKeys, animatable, structuralLook, structural: [...structuralLook, 'text', 'font', ...ANIM_STRUCTURAL] };
+        STATIC.set(look, s);
+    }
+    return s;
+}
+export function useTextObject(look, props) {
+    const { config, id, keyframes, mouseMove, onObjectReady, onObjectDispose } = props;
+    const S = staticOf(look);
+    const rootRef = useRef(null);
+    const innerRef = useRef(null);
+    const cfg = useMemo(() => withConfigDefaults(DEFAULT_TEXT_OBJECTS[look], config), [config, look]);
+    useObjectReady(rootRef, cfg, onObjectReady, onObjectDispose);
+    const cfgRef = useRef(cfg);
+    cfgRef.current = cfg;
+    const pb = useRef(createPlayback());
+    const anim = useRef({ draw: {}, erase: {}, play: {} });
+    const inst = useRef(null);
+    const lookCfg = useCallback((c) => { const o = {}; for (const k of S.lookKeys)
+        o[k] = c[k]; return o; }, [S]);
+    const syncAnim = useCallback((c) => {
+        const a = anim.current;
+        Object.assign(a.draw, { method: c.drawMethod, duration: c.drawDuration, ease: c.drawEase, stagger: c.drawStagger, angle: c.drawAngle });
+        Object.assign(a.erase, { method: c.eraseMethod, duration: c.eraseDuration, ease: c.eraseEase, stagger: c.eraseStagger, angle: c.eraseAngle });
+        Object.assign(a.play, { autoPlay: c.autoPlay, loop: c.loop, yoyo: c.yoyo, holdTime: c.holdTime, hiddenTime: c.hiddenTime });
+    }, []);
+    // The one push point: every look knob, from the committed config, a live drag, a keyframe or the pointer.
+    const push = useCallback((m) => { inst.current?.apply(lookCfg(m)); }, [lookCfg]);
+    useConfigDriver({ rootRef, id, family: 'text', base: cfg, structural: S.structural, allowed: S.animatable, keyframes, mouseMove, push });
+    // Committed edits land the same frame; the playback reads these every frame.
+    useLayoutEffect(() => { syncAnim(cfg); push(cfg); }, [cfg, push, syncAnim]);
+    // Rebuild when text, font, a schedule method or a structural look knob changes.
+    const rebuildKey = [cfg.text, cfg.font, ...ANIM_STRUCTURAL.map((k) => cfg[k]), ...S.structuralLook.map((k) => cfg[k])].join('\u0001');
+    useEffect(() => {
+        let dead = false;
+        let built = null;
+        const V = VARIANTS[look];
+        const c = cfgRef.current;
+        (V.source === 'hand' ? loadStrokes(c.font) : loadOutline(c.font)).then((font) => {
+            if (dead || !innerRef.current)
+                return;
+            const text = String(c.text || ' ');
+            const layout = V.source === 'hand' ? layoutStrokeFont(font, text, { align: 'center' }) : layoutOutline(font, text, { align: 'center' });
+            const now = cfgRef.current;
+            syncAnim(now);
+            built = V.build(layout, lookCfg(now), anim.current);
+            innerRef.current.add(built.object);
+            inst.current = built;
+            pb.current.reset(anim.current);
+            if (now.enabled === false)
+                pb.current.hide();
+        });
+        return () => { dead = true; if (built) {
+            built.object.removeFromParent();
+            built.dispose();
+            if (inst.current === built)
+                inst.current = null;
+        } };
+    }, [look, rebuildKey, lookCfg, syncAnim]);
+    // `enabled` is the trigger: on draws, off erases (then stays hidden). Loop / yoyo restart the cycle.
+    const prev = useRef({ enabled: cfg.enabled, loop: cfg.loop, yoyo: cfg.yoyo });
+    useEffect(() => {
+        const p = prev.current;
+        const changedEnabled = p.enabled !== cfg.enabled;
+        const changedPlay = p.loop !== cfg.loop || p.yoyo !== cfg.yoyo;
+        prev.current = { enabled: cfg.enabled, loop: cfg.loop, yoyo: cfg.yoyo };
+        if (!inst.current)
+            return;
+        if (changedEnabled) {
+            if (cfg.enabled === false)
+                pb.current.playErase(anim.current);
+            else
+                pb.current.restart(anim.current);
+        }
+        else if (changedPlay && cfg.enabled !== false)
+            pb.current.restart(anim.current);
+    }, [cfg.enabled, cfg.loop, cfg.yoyo]);
+    const scale = useMemo(() => new THREE.Vector3(), []);
+    useFrame((state, dt) => {
+        const i = inst.current;
+        const root = rootRef.current;
+        if (!i || !root)
+            return;
+        const st = pb.current.step(Math.min(dt, 0.1), anim.current);
+        const cam = state.camera;
+        const px = cam.isPerspectiveCamera ? state.gl.domElement.height / (2 * Math.tan(THREE.MathUtils.degToRad(cam.fov / 2))) : 800;
+        root.getWorldScale(scale);
+        i.update(st, state.clock.elapsedTime, px * Math.abs(scale.x) * TEXT_EM);
+    });
+    return { rootRef, innerRef };
+}

package/dist/components/water/OceanSurface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OceanSurface.d.ts","sourceRoot":"","sources":["../../../src/components/water/OceanSurface.tsx"],"names":[],"mappings":"AACA,OAAO,KAAiB,MAAM,OAAO,CAAC;AAItC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,QAAA,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAuD3C,CAAC;AAEF,eAAe,YAAY,CAAC"}
+{"version":3,"file":"OceanSurface.d.ts","sourceRoot":"","sources":["../../../src/components/water/OceanSurface.tsx"],"names":[],"mappings":"AACA,OAAO,KAAiB,MAAM,OAAO,CAAC;AAItC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,QAAA,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CA2D3C,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/components/water/OceanSurface.js

@@ -25,7 +25,7 @@ import { useOceanMaterial } from '../../hooks/useOceanMaterial.js';
  * a sea at 0. What connects them is computed — the shoreline is where the ground
  * crosses this surface — never configured.
  */
-const OceanSurface = ({ id = '3drise-water', config, quality, skySettings, timeSettings, sunIntensity = 1, onObjectReady, onObjectDispose, }) => {
+const OceanSurface = ({ id = '3drise-water', config, quality, skySettings, timeSettings, sunIntensity = 1, animations, mouseMove, onObjectReady, onObjectDispose, }) => {
     const clipmap = useClipmap(quality.levels, quality.segments, quality.cellSize);
     const meshRefs = useRef([]);
     const { material, rootRef } = useOceanMaterial({
@@ -35,6 +35,8 @@ const OceanSurface = ({ id = '3drise-water', config, quality, skySettings, timeS
         skySettings,
         timeSettings,
         sunIntensity,
+        animations,
+        mouseMove,
         onFrame: (cfg, _qual, state) => {
             // ONE origin for the whole pyramid, snapped to twice the finest cell.
             //

package/dist/components/water/WaterBody.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WaterBody.d.ts","sourceRoot":"","sources":["../../../src/components/water/WaterBody.tsx"],"names":[],"mappings":"AACA,OAAO,KAA6B,MAAM,OAAO,CAAC;AAGlD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,QAAA,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAsExC,CAAC;AAEF,eAAe,SAAS,CAAC"}
+{"version":3,"file":"WaterBody.d.ts","sourceRoot":"","sources":["../../../src/components/water/WaterBody.tsx"],"names":[],"mappings":"AACA,OAAO,KAA6B,MAAM,OAAO,CAAC;AAGlD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,QAAA,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CA0ExC,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/dist/components/water/WaterBody.js

@@ -29,7 +29,7 @@ import { useOceanMaterial } from '../../hooks/useOceanMaterial.js';
  * The rim taper (`edgeFade`) is in the vertex shader — without it the boundary
  * is a sawn-off cliff of water.
  */
-const WaterBody = ({ id = '3drise-water-body', config, quality, skySettings, timeSettings, sunIntensity = 1, meshSettings, onObjectReady, onObjectDispose, }) => {
+const WaterBody = ({ id = '3drise-water-body', config, quality, skySettings, timeSettings, sunIntensity = 1, animations, mouseMove, meshSettings, onObjectReady, onObjectDispose, }) => {
     const [width, depth] = config.size;
     // A body cannot carry a wave longer than it is: fetch is capped at its own
     // extent, which is physically what fetch MEANS — the open water upwind.
@@ -69,6 +69,8 @@ const WaterBody = ({ id = '3drise-water-body', config, quality, skySettings, tim
         skySettings,
         timeSettings,
         sunIntensity,
+        animations,
+        mouseMove,
     });
     useObjectReady(rootRef, { id, type: 'ocean', config, quality }, onObjectReady, onObjectDispose);
     return (_jsx("group", { ref: rootRef, position: meshSettings?.position ?? [0, config.seaLevel, 0], rotation: meshSettings?.rotation ?? [0, 0, 0], scale: meshSettings?.scale ?? [1, 1, 1], visible: meshSettings ? meshSettings.visible !== false : true, children: _jsx("mesh", { geometry: geometry, material: material, receiveShadow: quality.receiveShadows }) }));

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

@@ -1,6 +1,6 @@
 import type { SkySettings, TimeSettings } from '@3driseai/3drise-core';
 import type { ObjectReadyProps } from '../../types/objectReady';
-import type { OceanConfig, OceanMeshSettings, OceanQualityConfig } from '@3driseai/3drise-core';
+import type { OceanConfig, OceanMeshSettings, OceanQualityConfig, ObjectAnimations, MouseMoveInteractions } from '@3driseai/3drise-core';
 /** Shared by every water type. The builder hands all four the same shape. */
 export interface OceanLayerProps extends ObjectReadyProps {
     /** Scene id, so a controller can findById() the water and drive it live. */
@@ -16,5 +16,9 @@ export interface OceanLayerProps extends ObjectReadyProps {
     sunIntensity?: number;
     /** Object host only — the placed body's transform. */
     meshSettings?: OceanMeshSettings;
+    /** Keyframes; the `ocean` domain drives config knobs per frame. */
+    animations?: ObjectAnimations;
+    /** Pointer bindings; same `ocean` domain. */
+    mouseMove?: MouseMoveInteractions;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/water/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhG,6EAA6E;AAC7E,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACrD,4EAA4E;IAC5E,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,kBAAkB,CAAC;IAC5B;;4DAEwD;IACxD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,YAAY,CAAC,EAAE,iBAAiB,CAAC;CACpC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/water/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEzI,6EAA6E;AAC7E,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACrD,4EAA4E;IAC5E,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,kBAAkB,CAAC;IAC5B;;4DAEwD;IACxD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,mEAAmE;IACnE,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,6CAA6C;IAC7C,SAAS,CAAC,EAAE,qBAAqB,CAAC;CACrC"}

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,gBAAgB,gCAAgC,CAAC;AAC9D,eAAO,MAAM,qBAAqB,aAehC,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,gBAAgB,gCAAgC,CAAC;AAC9D,eAAO,MAAM,qBAAqB,aAmBhC,CAAC"}

package/dist/constants.js

@@ -13,6 +13,10 @@ export const SELF_MANAGED_MATERIAL = new Set([
     'space',
     'grid',
     'particles',
+    // Weather objects (snow…) own their shaders; the legacy rain adds its points to the scene directly.
+    'environment',
+    // Land objects draw with the terrain material (TERRAIN_PATCH).
+    'land',
     // The water surface owns its shader — one material for both hosts, built
     // around the wave field. Left out of this set, useMaterialApplication
     // overwrites it with whatever the registry has under materialType, which for

package/dist/hooks/index.d.ts

@@ -15,6 +15,8 @@ export type { Clipmap, ClipmapLevel } from './useClipmap';
 export { useClipmap } from './useClipmap';
 export type { OceanLiveHandle } from './useOceanLive';
 export { OCEAN_LIVE_KEY, useOceanLive } from './useOceanLive';
+export type { SkyLiveHandle } from './useSkyLive';
+export { SKY_LIVE_KEY, useSkyLive } from './useSkyLive';
 export { useOceanMaterial } from './useOceanMaterial';
 export type { ConfigLiveHandle, ConfigLiveValue, ConfigLiveFamily } from './useConfigLive';
 export { CONFIG_LIVE_KEY, useConfigLive, useConfigLiveHandle } from './useConfigLive';

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":"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"}

package/dist/hooks/index.js

@@ -11,6 +11,7 @@ export { TERRAIN_LIVE_KEY, useTerrainLive } from './useTerrainLive.js';
 export { useTerrainClipmap } from './useTerrainClipmap.js';
 export { useClipmap } from './useClipmap.js';
 export { OCEAN_LIVE_KEY, useOceanLive } from './useOceanLive.js';
+export { SKY_LIVE_KEY, useSkyLive } from './useSkyLive.js';
 export { useOceanMaterial } from './useOceanMaterial.js';
 export { CONFIG_LIVE_KEY, useConfigLive, useConfigLiveHandle } from './useConfigLive.js';
 export { useConfigDriver } from './useConfigDriver.js';

package/dist/hooks/useCloudSun.d.ts

@@ -4,10 +4,15 @@ import type { SkySettings, TimeSettings } from '@3driseai/3drise-core';
  * The one place the cloud renderer decides where the sun is and what colour it is.
  *
  * Direction comes from whatever the scene already uses, in this order:
- *   1. skySystemManager, when time-of-day is enabled — the same source SunLight,
- *      Skybox and Lensflare read, so a time slider moves everything together.
- *   2. SkySettings.elevation / azimuth, the static sun.
- *   3. A fixed mid-morning direction, so a scene with no sky still lights.
+ *   1. The sky as drawn this frame (renderedSky) — time-driven, keyframed,
+ *      clip-driven, pointer-driven or mid-drag. SunLight reads this same hook,
+ *      so the key light, the clouds, the water and the terrain share one sun.
+ *   2. skySystemManager, when time-of-day is enabled and no Preetham sky is
+ *      drawing (the sun-rig mode).
+ *   3. SkySettings.elevation / azimuth, the static sun.
+ *   4. A fixed mid-morning direction, so a scene with no sky still lights.
+ *
+ * All of them are in core sunUtils' convention.
  *
  * Colour comes from Kasten-Young air mass through the SAME four Preetham
  * parameters SkyController draws with. That is what keeps the clouds inside the

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

@@ -1 +1 @@
-{"version":3,"file":"useCloudSun.d.ts","sourceRoot":"","sources":["../../src/hooks/useCloudSun.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEvE;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,aAAa;IAC1B,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC;IACzB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;IACnB,kFAAkF;IAClF,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC;IACxB,sDAAsD;IACtD,aAAa,EAAE,KAAK,CAAC,KAAK,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CAChB;AAaD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,SAAS,EAAE,GAAG,EAAE,aAAa,GAAG,aAAa,CA2BlI;AAED,MAAM,WAAW,kBAAkB;IAC/B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,gEAAgE;IAChE,SAAS,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG;IAAE,KAAK,EAAE,aAAa,CAAC;IAAC,MAAM,IAAI,aAAa,CAAA;CAAE,CA2C/G;AAED,eAAe,WAAW,CAAC"}
+{"version":3,"file":"useCloudSun.d.ts","sourceRoot":"","sources":["../../src/hooks/useCloudSun.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEvE;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,aAAa;IAC1B,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC;IACzB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;IACnB,kFAAkF;IAClF,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC;IACxB,sDAAsD;IACtD,aAAa,EAAE,KAAK,CAAC,KAAK,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CAChB;AAaD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,SAAS,EAAE,GAAG,EAAE,aAAa,GAAG,aAAa,CA2BlI;AAED,MAAM,WAAW,kBAAkB;IAC/B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,gEAAgE;IAChE,SAAS,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG;IAAE,KAAK,EAAE,aAAa,CAAC;IAAC,MAAM,IAAI,aAAa,CAAA;CAAE,CAmD/G;AAED,eAAe,WAAW,CAAC"}

package/dist/hooks/useCloudSun.js

@@ -1,6 +1,8 @@
 import * as THREE from 'three';
 import { useMemo, useRef } from 'react';
-import { skySystemManager } from '@3driseai/3drise-core';
+import { useThree } from '@react-three/fiber';
+import { getRenderedSky } from '../utils/renderedSky.js';
+import { skySystemManager, sunDirectionFromAngles } from '@3driseai/3drise-core';
 const RAYLEIGH_BASE = [0.0487, 0.113, 0.278];
 const DEFAULT_DIRECTION = new THREE.Vector3(0.35, 0.42, 0.84).normalize();
 /** Kasten-Young relative air mass, clamped where the formula stops behaving. */
@@ -45,6 +47,7 @@ export function computeCloudSun(direction, sky, out) {
 export function useCloudSun(options = {}) {
     const optionsRef = useRef(options);
     optionsRef.current = options;
+    const scene = useThree(s => s.scene);
     const state = useMemo(() => ({
         direction: new THREE.Vector3().copy(DEFAULT_DIRECTION),
         color: new THREE.Color(1, 1, 1),
@@ -58,10 +61,19 @@ export function useCloudSun(options = {}) {
     const scratch = useMemo(() => new THREE.Vector3(), []);
     const update = useMemo(() => () => {
         const { skySettings, timeSettings, direction } = optionsRef.current;
+        // What the sky actually drew this frame (keyframed, pointer-driven, time-
+        // driven or mid-drag) wins over the stored settings, so the light on the
+        // clouds and the water moves with the background. Absent while the sky is
+        // hidden or the sun rig is drawing instead.
+        const rendered = getRenderedSky(scene);
+        const sky = rendered ?? skySettings;
         let dir;
         if (direction) {
             dir = scratch.copy(direction).normalize();
         }
+        else if (rendered) {
+            dir = scratch.copy(rendered.sunDirection);
+        }
         else if (timeSettings?.enabled) {
             // Same source SunLight reads, so the two can never disagree.
             const sunDirection = skySystemManager.getState()?.sunDirection;
@@ -69,16 +81,14 @@ export function useCloudSun(options = {}) {
                 ? scratch.copy(sunDirection).normalize()
                 : scratch.copy(DEFAULT_DIRECTION);
         }
-        else if (skySettings) {
-            const el = THREE.MathUtils.degToRad(skySettings.elevation ?? 25);
-            const az = THREE.MathUtils.degToRad(skySettings.azimuth ?? 130);
-            dir = scratch.set(Math.cos(el) * Math.sin(az), Math.sin(el), Math.cos(el) * Math.cos(az)).normalize();
+        else if (sky) {
+            dir = sunDirectionFromAngles(sky.elevation ?? 25, sky.azimuth ?? 130, scratch);
         }
         else {
             dir = scratch.copy(DEFAULT_DIRECTION);
         }
-        return computeCloudSun(dir, skySettings, state);
-    }, [scratch, state]);
+        return computeCloudSun(dir, sky, state);
+    }, [scratch, state, scene]);
     return { state, update };
 }
 export default useCloudSun;

package/dist/hooks/useConfigLive.d.ts

@@ -27,9 +27,10 @@ import type { Object3D } from 'three';
  */
 /** Where a generative component stashes its handle on its root group's userData. */
 export declare const CONFIG_LIVE_KEY = "__configLive";
-export type ConfigLiveValue = number | string | boolean;
+/** Objects too: a land object's texture layers drag live as one `textures` record. */
+export type ConfigLiveValue = number | string | boolean | object;
 /** Generative families that support live config editing. */
-export type ConfigLiveFamily = 'particles' | 'effects' | 'grids' | 'lights';
+export type ConfigLiveFamily = 'particles' | 'effects' | 'grids' | 'lights' | 'environment' | 'space' | 'land' | 'text';
 export interface ConfigLiveHandle {
     id: string;
     family: ConfigLiveFamily;

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

@@ -1 +1 @@
-{"version":3,"file":"useConfigLive.d.ts","sourceRoot":"","sources":["../../src/hooks/useConfigLive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,gBAAgB,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAChG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAGtC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,oFAAoF;AACpF,eAAO,MAAM,eAAe,iBAAiB,CAAC;AAE9C,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAExD,4DAA4D;AAC5D,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE5E,MAAM,WAAW,gBAAgB;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,gBAAgB,CAAC;IACzB,+DAA+D;IAC/D,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;CAClD;AAgBD,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG;IAAE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAAA;CAAE,CAYpG;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAC/B,OAAO,EAAE,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAC,EACnC,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,KAAK,IAAI,GAC5D,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CA8BnD;AAED,eAAe,aAAa,CAAC"}
+{"version":3,"file":"useConfigLive.d.ts","sourceRoot":"","sources":["../../src/hooks/useConfigLive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,gBAAgB,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAChG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAGtC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,oFAAoF;AACpF,eAAO,MAAM,eAAe,iBAAiB,CAAC;AAE9C,sFAAsF;AACtF,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAEjE,4DAA4D;AAC5D,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAExH,MAAM,WAAW,gBAAgB;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,gBAAgB,CAAC;IACzB,+DAA+D;IAC/D,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;CAClD;AAgBD,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG;IAAE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAAA;CAAE,CAYpG;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAC/B,OAAO,EAAE,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAC,EACnC,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,KAAK,IAAI,GAC5D,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CA8BnD;AAED,eAAe,aAAa,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"useContinuousEffects.d.ts","sourceRoot":"","sources":["../../src/hooks/useContinuousEffects.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGhF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,MAAM,WAAW,2BAA2B;IACxC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,0BAA0B;IACvC,eAAe,EAAE,MAAM,OAAO,CAAC;IAC/B,cAAc,EAAE,KAAK,CAAC,gBAAgB,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CAC9D;AAGD,eAAO,MAAM,oBAAoB,GAEjC,gBAAgB,qBAAqB,GAAG,IAAI,EAAE,UAAS,2BAAgC,EAAE,eAAe,cAAc,KAAG,0BAgIxH,CAAC;AACF,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"useContinuousEffects.d.ts","sourceRoot":"","sources":["../../src/hooks/useContinuousEffects.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGhF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,MAAM,WAAW,2BAA2B;IACxC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,0BAA0B;IACvC,eAAe,EAAE,MAAM,OAAO,CAAC;IAC/B,cAAc,EAAE,KAAK,CAAC,gBAAgB,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CAC9D;AAGD,eAAO,MAAM,oBAAoB,GAEjC,gBAAgB,qBAAqB,GAAG,IAAI,EAAE,UAAS,2BAAgC,EAAE,eAAe,cAAc,KAAG,0BA0HxH,CAAC;AACF,eAAe,oBAAoB,CAAC"}

package/dist/hooks/useContinuousEffects.js

@@ -1,6 +1,6 @@
 import { useRef, useEffect } from "react";
 import { useFrame } from "@react-three/fiber";
-import { animateUniforms, cacheChildrenWithMaterials, handleEdgesAnimations, handleMaterialAnimations, handleMaterialEffects, handleTransformAnimations, handleTransformEffect } from "@3driseai/3drise-core";
+import { animateUniforms, cacheChildrenWithMaterials, handleEdgesAnimations, handleMaterialAnimations, handleMaterialEffects, handleTransformAnimations } from "@3driseai/3drise-core";
 import usePathAnimation from "./usePathAnimation.js";
 import { resolveObject3D } from "../utils/resolveObject3D.js";
 export const useContinuousEffects = (
@@ -19,13 +19,11 @@ objectSettings, options = {}, objectSource) => {
     const startValuesRef = useRef({});
     // Cache start values for edges animations
     const edgesStartValuesRef = useRef({});
+    // Transform keyframes. Effects that move the object (float, sway, spin…) are object
+    // effects now (CreatedObject.effects, the operations catalogue) and ride on top of these.
     const transformAnimations = objectSettings?.animations?.transform?.animations || [];
-    const transformEffects = objectSettings?.animations?.transform?.effects || [];
-    const enabledTransformEffects = transformEffects.filter(effect => effect.enabled);
-    const hasTransformEffects = enabledTransformEffects.length > 0;
     const speed = objectSettings?.config?.speed ?? 1;
-    // Skip transform animations if any effect is enabled (effects take precedence)
-    const activeTransformAnimations = hasTransformEffects ? [] : transformAnimations;
+    const activeTransformAnimations = transformAnimations;
     const hasTransformAnimations = activeTransformAnimations.length > 0;
     // Edges domain
     const edgesAnimations = objectSettings?.animations?.edges?.animations || [];
@@ -101,10 +99,6 @@ objectSettings, options = {}, objectSource) => {
                 pathIsActive,
             }, activeTransformAnimations, currentTime, hovered);
         }
-        // Handle transform effect (wave, float, spin, etc.) - now supports multiple effects
-        if (hasTransformEffects) {
-            handleTransformEffect(object, enabledTransformEffects, time, delta, effectStateRef, hovered);
-        }
         if (hasEdgesAnimations) {
             handleEdgesAnimations({ object, startValuesCache: edgesStartValuesRef.current }, edgesAnimations, currentTime, hovered);
         }

package/dist/hooks/useEnvironmentProbe.d.ts

@@ -1,33 +1,14 @@
-/**
- * When the scene's cube-camera probe should exist, and how often it refreshes.
- *
- * This is the *policy* half of the cube camera; useCubeCamera is the imperative
- * half. It lives in a hook rather than inside EnvironmentManager because two
- * hosts need it — the composed EnvironmentManager used by published scenes, and
- * the editor's HDR connector, which subscribes to Redux and composes the leaf
- * components itself. Duplicating a rule this fiddly is how the two paths drifted
- * apart last time.
- *
- * The rule itself:
- *  - An HDR background provides its own IBL, so the probe is disposed.
- *  - Otherwise, if there is any sky, the probe exists and captures it.
- *  - Otherwise there is nothing to capture, so dispose and clear the environment.
- *
- * The refresh accumulates delta and resets. The obvious-looking
- * `clock.getElapsedTime() * 1000 > interval` is true on *every* frame after the
- * first 0.3 s, which re-renders all six cube faces per frame.
- */
 export interface UseEnvironmentProbeOptions {
     /** An HDR background or playlist is supplying the environment map. */
     hdrActive: boolean;
     /** Analytic sky or the sun rig is visible — something worth capturing. */
     skyActive: boolean;
-    /** Time of day is advancing — autoAnimate OR real-time sync — so the capture
-     *  goes stale and needs refreshing. */
+    /** Kept for API compatibility. Refresh now follows the sun's movement, which
+     *  covers playback and real-time sync without needing to be told. */
     autoAnimate: boolean;
     resolution?: number;
     intervalMs?: number;
 }
-export declare function useEnvironmentProbe({ hdrActive, skyActive, autoAnimate, resolution, intervalMs, }: UseEnvironmentProbeOptions): void;
+export declare function useEnvironmentProbe({ hdrActive, skyActive, resolution, intervalMs, }: UseEnvironmentProbeOptions): void;
 export default useEnvironmentProbe;
 //# sourceMappingURL=useEnvironmentProbe.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useEnvironmentProbe.d.ts","sourceRoot":"","sources":["../../src/hooks/useEnvironmentProbe.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,0BAA0B;IACvC,sEAAsE;IACtE,SAAS,EAAE,OAAO,CAAC;IACnB,0EAA0E;IAC1E,SAAS,EAAE,OAAO,CAAC;IACnB;2CACuC;IACvC,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,mBAAmB,CAAC,EAChC,SAAS,EACT,SAAS,EACT,WAAW,EACX,UAAgB,EAChB,UAAgB,GACnB,EAAE,0BAA0B,GAAG,IAAI,CA6BnC;AAED,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"useEnvironmentProbe.d.ts","sourceRoot":"","sources":["../../src/hooks/useEnvironmentProbe.ts"],"names":[],"mappings":"AAmCA,MAAM,WAAW,0BAA0B;IACvC,sEAAsE;IACtE,SAAS,EAAE,OAAO,CAAC;IACnB,0EAA0E;IAC1E,SAAS,EAAE,OAAO,CAAC;IACnB;yEACqE;IACrE,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,mBAAmB,CAAC,EAChC,SAAS,EACT,SAAS,EACT,UAAgB,EAChB,UAAgB,GACnB,EAAE,0BAA0B,GAAG,IAAI,CAoCnC;AAED,eAAe,mBAAmB,CAAC"}

package/dist/hooks/useEnvironmentProbe.js

@@ -1,7 +1,36 @@
-import { useEffect, useRef } from 'react';
-import { useFrame } from '@react-three/fiber';
+import { useEffect, useMemo, useRef } from 'react';
+import { Vector3 } from 'three';
+import { useFrame, useThree } from '@react-three/fiber';
+import { skySystemManager } from '@3driseai/3drise-core';
+import { getRenderedSky } from '../utils/renderedSky.js';
 import { useCubeCamera } from './useCubeCamera.js';
-export function useEnvironmentProbe({ hdrActive, skyActive, autoAnimate, resolution = 512, intervalMs = 300, }) {
+/**
+ * When the scene's cube-camera probe should exist, and how often it refreshes.
+ *
+ * This is the *policy* half of the cube camera; useCubeCamera is the imperative
+ * half. It lives in a hook rather than inside EnvironmentManager because two
+ * hosts need it — the composed EnvironmentManager used by published scenes, and
+ * the editor's HDR connector, which subscribes to Redux and composes the leaf
+ * components itself. Duplicating a rule this fiddly is how the two paths drifted
+ * apart last time.
+ *
+ * The rule itself:
+ *  - An HDR background provides its own IBL, so the probe is disposed.
+ *  - Otherwise, if there is any sky, the probe exists and captures it.
+ *  - Otherwise there is nothing to capture, so dispose and clear the environment.
+ *
+ * Refresh is driven by the SUN MOVING, not by a timer: the capture is re-taken
+ * when the drawn sun (renderedSky, else the clock) has turned at least
+ * REFRESH_ANGLE_DEG since the last one, at most once per `intervalMs`. That
+ * covers every way the sun moves — playback, real-time sync, sky keyframes,
+ * pointer bindings, clips — and costs nothing while it is still. At the default
+ * playback speed it is one capture every few seconds instead of three a second.
+ * Atmosphere-only edits (a turbidity slider) re-capture from SkyController.
+ */
+/** Sun movement, in degrees, that makes the capture stale. */
+const REFRESH_ANGLE_DEG = 0.5;
+const REFRESH_COS = Math.cos((REFRESH_ANGLE_DEG * Math.PI) / 180);
+export function useEnvironmentProbe({ hdrActive, skyActive, resolution = 512, intervalMs = 300, }) {
     const { manager, initializeCubeCamera, updateEnvironment, dispose, clear } = useCubeCamera({
         resolution,
     });
@@ -19,17 +48,27 @@ export function useEnvironmentProbe({ hdrActive, skyActive, autoAnimate, resolut
             clear();
         }
     }, [hdrActive, skyActive, initializeCubeCamera, updateEnvironment, dispose, clear]);
+    const scene = useThree(s => s.scene);
+    const captured = useMemo(() => new Vector3(0, 0, 0), []);
     const elapsedMsRef = useRef(0);
     useFrame((_, delta) => {
-        if (hdrActive || !skyActive || !autoAnimate)
+        if (hdrActive || !skyActive)
             return;
         if (!manager.hasCubeCamera())
             return;
         elapsedMsRef.current += delta * 1000;
-        if (elapsedMsRef.current >= intervalMs) {
-            elapsedMsRef.current = 0;
-            updateEnvironment();
-        }
+        if (elapsedMsRef.current < intervalMs)
+            return;
+        const sun = getRenderedSky(scene)?.sunDirection
+            ?? (skySystemManager.isEnabled() ? skySystemManager.getState().sunDirection : null);
+        if (!sun)
+            return;
+        // `captured` starts at zero length, so the first frame always captures.
+        if (captured.lengthSq() > 0 && captured.dot(sun) >= REFRESH_COS)
+            return;
+        captured.copy(sun);
+        elapsedMsRef.current = 0;
+        updateEnvironment();
     });
 }
 export default useEnvironmentProbe;

package/dist/hooks/useGridSurface.d.ts

@@ -12,8 +12,6 @@ export interface GridSurfaceUniforms {
     u_reveal: number;
 }
 export interface GridSurfaceOptions {
-    /** project the pointer onto the plane and write it into u_focus */
-    followMouse?: boolean;
     /** 0..1 target assemble amount; 1 is fully built, 0 is gone */
     reveal?: number;
     /**
@@ -28,19 +26,14 @@ export interface GridSurfaceOptions {
  *
  * Advances `u_time` with the raw clock (each shader applies its own
  * `u_animSpeed`, matching MyGridMaterial), mirrors the pointer into `u_mouse`
- * as NDC — the 3drise convention — projects the pointer onto the grid's own
- * plane for `u_focus` when `followMouse` is on, and drives `u_reveal` toward
- * its target.
- *
- * The pick plane is derived from the mesh's world matrix rather than hard-coded
- * to XZ, so the projection stays correct whether the grid lies flat or stands
- * upright, and whether or not the host applied a transform above it.
+ * as NDC — the 3drise convention — and drives `u_reveal` toward its target.
+ * `u_focus` stays at the origin: pointer behaviour is a Pointer-tab binding.
  *
  * Reveal is driven at a constant *rate* rather than by replaying a fixed
  * timeline, so retargeting mid-flight — the dissolve that starts while the
  * build is still running — continues smoothly from wherever it had got to
  * instead of snapping back to the start.
  */
-export declare function useGridSurface(materialRef: RefObject<GridSurfaceUniforms | null>, meshRef: RefObject<THREE.Object3D | null>, options?: GridSurfaceOptions): void;
+export declare function useGridSurface(materialRef: RefObject<GridSurfaceUniforms | null>, _meshRef: RefObject<THREE.Object3D | null>, options?: GridSurfaceOptions): void;
 export default useGridSurface;
 //# sourceMappingURL=useGridSurface.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useGridSurface.d.ts","sourceRoot":"","sources":["../../src/hooks/useGridSurface.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC;IACvB,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IAC/B,mEAAmE;IACnE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAC1B,WAAW,EAAE,SAAS,CAAC,mBAAmB,GAAG,IAAI,CAAC,EAClD,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,EACzC,OAAO,GAAE,kBAAuB,GACjC,IAAI,CAgDN;AAED,eAAe,cAAc,CAAC"}
+{"version":3,"file":"useGridSurface.d.ts","sourceRoot":"","sources":["../../src/hooks/useGridSurface.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC;IACvB,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IAC/B,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC1B,WAAW,EAAE,SAAS,CAAC,mBAAmB,GAAG,IAAI,CAAC,EAClD,QAAQ,EAAE,SAAS,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,EAC1C,OAAO,GAAE,kBAAuB,GACjC,IAAI,CAyBN;AAED,eAAe,cAAc,CAAC"}