@3driseai/3drise-viewer 0.1.29 → 0.1.31

package/dist/components/text/useTextObject.js

@@ -9,10 +9,12 @@ 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';
+import { extentOf } from './engine/methods.js';
+import { stopRaycast } from '../../utils/pickProxy.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',
+const BASE_KEYS = new Set(['type', 'shown', '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'];
@@ -36,6 +38,8 @@ export function useTextObject(look, props) {
     const S = staticOf(look);
     const rootRef = useRef(null);
     const innerRef = useRef(null);
+    // Hover / click land on one plane over the text's box (em units, inside the em-scaled group), never on a letter.
+    const proxyRef = useRef(null);
     const cfg = useMemo(() => withConfigDefaults(DEFAULT_TEXT_OBJECTS[look], config), [config, look]);
     useObjectReady(rootRef, cfg, onObjectReady, onObjectDispose);
     const cfgRef = useRef(cfg);
@@ -71,10 +75,18 @@ export function useTextObject(look, props) {
             const now = cfgRef.current;
             syncAnim(now);
             built = V.build(layout, lookCfg(now), anim.current);
+            stopRaycast(built.object);
             innerRef.current.add(built.object);
             inst.current = built;
+            const e = extentOf(layout.strokes);
+            const pad = 0.12; // em: a little air around the glyphs
+            const proxy = proxyRef.current;
+            if (proxy) {
+                proxy.position.set((e.x0 + e.x1) / 2, (e.y0 + e.y1) / 2, 0);
+                proxy.scale.set(e.w + 2 * pad, e.h + 2 * pad, 1);
+            }
             pb.current.reset(anim.current);
-            if (now.enabled === false)
+            if (now.shown === false)
                 pb.current.hide();
         });
         return () => { dead = true; if (built) {
@@ -84,24 +96,24 @@ export function useTextObject(look, props) {
                 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 });
+    // `shown` is the trigger: on draws, off erases (then stays hidden). Loop / yoyo restart the cycle.
+    const prev = useRef({ shown: cfg.shown, loop: cfg.loop, yoyo: cfg.yoyo });
     useEffect(() => {
         const p = prev.current;
-        const changedEnabled = p.enabled !== cfg.enabled;
+        const changedShown = p.shown !== cfg.shown;
         const changedPlay = p.loop !== cfg.loop || p.yoyo !== cfg.yoyo;
-        prev.current = { enabled: cfg.enabled, loop: cfg.loop, yoyo: cfg.yoyo };
+        prev.current = { shown: cfg.shown, loop: cfg.loop, yoyo: cfg.yoyo };
         if (!inst.current)
             return;
-        if (changedEnabled) {
-            if (cfg.enabled === false)
+        if (changedShown) {
+            if (cfg.shown === false)
                 pb.current.playErase(anim.current);
             else
                 pb.current.restart(anim.current);
         }
-        else if (changedPlay && cfg.enabled !== false)
+        else if (changedPlay && cfg.shown !== false)
             pb.current.restart(anim.current);
-    }, [cfg.enabled, cfg.loop, cfg.yoyo]);
+    }, [cfg.shown, cfg.loop, cfg.yoyo]);
     const scale = useMemo(() => new THREE.Vector3(), []);
     useFrame((state, dt) => {
         const i = inst.current;
@@ -114,5 +126,5 @@ export function useTextObject(look, props) {
         root.getWorldScale(scale);
         i.update(st, state.clock.elapsedTime, px * Math.abs(scale.x) * TEXT_EM);
     });
-    return { rootRef, innerRef };
+    return { rootRef, innerRef, proxyRef };
 }

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,CA2D3C,CAAC;AAEF,eAAe,YAAY,CAAC"}
+{"version":3,"file":"OceanSurface.d.ts","sourceRoot":"","sources":["../../../src/components/water/OceanSurface.tsx"],"names":[],"mappings":"AAEA,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,CA+D3C,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/components/water/OceanSurface.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { OCEAN_DRAW_ORDER, ringDrawOrder } from '../../utils/environmentDrawOrder.js';
 import { useRef } from 'react';
 import { useObjectReady } from '../../hooks/useObjectReady.js';
 import { useClipmap } from '../../hooks/useClipmap.js';
@@ -25,7 +26,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, animations, mouseMove, onObjectReady, onObjectDispose, }) => {
+const OceanSurface = ({ id = '3drise-water', config, quality, skySettings, timeSettings, sunIntensity = 1, animations, mouseMove, terrain, onObjectReady, onObjectDispose, }) => {
     const clipmap = useClipmap(quality.levels, quality.segments, quality.cellSize);
     const meshRefs = useRef([]);
     const { material, rootRef } = useOceanMaterial({
@@ -37,6 +38,7 @@ const OceanSurface = ({ id = '3drise-water', config, quality, skySettings, timeS
         sunIntensity,
         animations,
         mouseMove,
+        terrain,
         onFrame: (cfg, _qual, state) => {
             // ONE origin for the whole pyramid, snapped to twice the finest cell.
             //
@@ -54,6 +56,8 @@ const OceanSurface = ({ id = '3drise-water', config, quality, skySettings, timeS
     });
     useObjectReady(rootRef, { id, type: 'ocean', config, quality }, onObjectReady, onObjectDispose);
     return (_jsx("group", { ref: rootRef, children: clipmap.levels.map((ring, i) => (_jsx("mesh", { ref: (m) => { meshRefs.current[i] = m; }, geometry: ring.geometry, material: material, receiveShadow: quality.receiveShadows, 
+            // Before the terrain, inner ring first: see environmentDrawOrder.
+            renderOrder: ringDrawOrder(OCEAN_DRAW_ORDER, ring.level), 
             // Displacement happens in the vertex shader, so the
             // object-space bounds describe a flat plane. Culling against
             // them hides the water the moment the camera tilts up.

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, ObjectAnimations, MouseMoveInteractions } from '@3driseai/3drise-core';
+import type { OceanConfig, OceanMeshSettings, OceanQualityConfig, ObjectAnimations, MouseMoveInteractions, TerrainConfig } 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. */
@@ -20,5 +20,7 @@ export interface OceanLayerProps extends ObjectReadyProps {
     animations?: ObjectAnimations;
     /** Pointer bindings; same `ocean` domain. */
     mouseMove?: MouseMoveInteractions;
+    /** The environment terrain, for the world ocean's shoreline and terrain shadow. */
+    terrain?: TerrainConfig | null;
 }
 //# 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,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"}
+{"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,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAExJ,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;IAClC,mFAAmF;IACnF,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;CAClC"}

package/dist/constants.d.ts

@@ -1,3 +1,3 @@
-export declare const dataCenterServer = "https://3drise.ai/api/data/";
+export declare const dataCenterServer = "http://localhost:3001/api/data/";
 export declare const SELF_MANAGED_MATERIAL: Set<string>;
 //# sourceMappingURL=constants.d.ts.map

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,aAmBhC,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,gBAAgB,oCAA2B,CAAC;AACzD,eAAO,MAAM,qBAAqB,aAqBhC,CAAC"}

package/dist/constants.js

@@ -3,7 +3,7 @@ const PRODUCTION_DATA_CENTER_SERVER = 'https://3drise.ai/api/data/';
 const isLocalHostRuntime = typeof window !== 'undefined' &&
     (window.location.hostname === 'localhost' || window.location.hostname === '127.0.0.1');
 // export const dataCenterServer = isLocalHostRuntime ? LOCAL_DATA_CENTER_SERVER : PRODUCTION_DATA_CENTER_SERVER;
-export const dataCenterServer = PRODUCTION_DATA_CENTER_SERVER;
+export const dataCenterServer = LOCAL_DATA_CENTER_SERVER;
 export const SELF_MANAGED_MATERIAL = new Set([
     // The landscape owns its shader: splat arrays, height blending and the
     // heightmap displacement are the material. useMaterialApplication would
@@ -17,6 +17,8 @@ export const SELF_MANAGED_MATERIAL = new Set([
     'environment',
     // Land objects draw with the terrain material (TERRAIN_PATCH).
     'land',
+    // Text looks (plain, handwriting, neon…) draw with their own shaders; 3d text is a mesh and takes a material.
+    'text',
     // 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/useOceanMaterial.d.ts

@@ -2,7 +2,7 @@ import * as THREE from 'three';
 import { type RootState } from '@react-three/fiber';
 import type { SkySettings, TimeSettings } from '@3driseai/3drise-core';
 import { OceanSurfaceMaterial } from '../shaders/ocean/OceanSurfaceMaterial';
-import type { OceanConfig, OceanQualityConfig, ObjectAnimations, MouseMoveInteractions } from '@3driseai/3drise-core';
+import type { OceanConfig, OceanQualityConfig, ObjectAnimations, MouseMoveInteractions, TerrainConfig } from '@3driseai/3drise-core';
 /**
  * Everything the two water hosts share: the material, the live-edit handle, and
  * the per-frame uniform push.
@@ -27,6 +27,10 @@ export interface UseOceanMaterialOptions {
     animations?: ObjectAnimations;
     /** Pointer bindings; same `ocean` domain. */
     mouseMove?: MouseMoveInteractions;
+    /** The environment terrain's config, when it is on: the water reads the ground
+     *  under it for the shoreline (waves shoal, shallow colour, shore foam) and
+     *  marches the terrain's shadow. World host only. */
+    terrain?: TerrainConfig | null;
     /** Runs after the uniforms are pushed, with the live overrides already
      *  merged in — where a host does its own per-frame work (snapping the
      *  clipmap to the camera, say) with the config it is actually rendering. */
@@ -38,6 +42,6 @@ export interface OceanMaterialHandle {
      *  handle a controller reaches through `findById`. */
     rootRef: React.RefObject<THREE.Group | null>;
 }
-export declare function useOceanMaterial({ id, config, quality, skySettings, timeSettings, sunIntensity, animations, mouseMove, onFrame, }: UseOceanMaterialOptions): OceanMaterialHandle;
+export declare function useOceanMaterial({ id, config, quality, skySettings, timeSettings, sunIntensity, animations, mouseMove, terrain, onFrame, }: UseOceanMaterialOptions): OceanMaterialHandle;
 export default useOceanMaterial;
 //# sourceMappingURL=useOceanMaterial.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useOceanMaterial.d.ts","sourceRoot":"","sources":["../../src/hooks/useOceanMaterial.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAU7E,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAStH;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,uBAAuB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,6CAA6C;IAC7C,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC;;gFAE4E;IAC5E,OAAO,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;CACtF;AAED,MAAM,WAAW,mBAAmB;IAChC,QAAQ,EAAE,oBAAoB,CAAC;IAC/B;0DACsD;IACtD,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;CAChD;AAED,wBAAgB,gBAAgB,CAAC,EAC7B,EAAE,EACF,MAAM,EACN,OAAO,EACP,WAAW,EACX,YAAY,EACZ,YAAgB,EAChB,UAAU,EACV,SAAS,EACT,OAAO,GACV,EAAE,uBAAuB,GAAG,mBAAmB,CAuG/C;AAED,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"useOceanMaterial.d.ts","sourceRoot":"","sources":["../../src/hooks/useOceanMaterial.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAU7E,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AASrI;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,uBAAuB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,6CAA6C;IAC7C,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC;;yDAEqD;IACrD,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAC/B;;gFAE4E;IAC5E,OAAO,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;CACtF;AAED,MAAM,WAAW,mBAAmB;IAChC,QAAQ,EAAE,oBAAoB,CAAC;IAC/B;0DACsD;IACtD,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;CAChD;AAED,wBAAgB,gBAAgB,CAAC,EAC7B,EAAE,EACF,MAAM,EACN,OAAO,EACP,WAAW,EACX,YAAY,EACZ,YAAgB,EAChB,UAAU,EACV,SAAS,EACT,OAAO,EACP,OAAO,GACV,EAAE,uBAAuB,GAAG,mBAAmB,CA0H/C;AAED,eAAe,gBAAgB,CAAC"}

package/dist/hooks/useOceanMaterial.js

@@ -5,7 +5,7 @@ import { useCloudSun } from './useCloudSun.js';
 import { OCEAN_LIVE_KEY } from './useOceanLive.js';
 import { OceanSurfaceMaterial } from '../shaders/ocean/OceanSurfaceMaterial.js';
 import { applySunUniforms } from '../utils/cloudUniforms.js';
-import { applyTerrainAmbient } from '../utils/terrainUniforms.js';
+import { applyTerrainAmbient, applyTerrainFieldUniforms } from '../utils/terrainUniforms.js';
 import { applyOceanUniforms } from '../utils/oceanUniforms.js';
 import { resolveMoon, moonlightFactor, MOON_LIGHT_COLOR } from '../utils/skyMoon.js';
 /** Moonlight on the water relative to the sun's (sunIntensity 1). The key light
@@ -14,7 +14,7 @@ import { resolveMoon, moonlightFactor, MOON_LIGHT_COLOR } from '../utils/skyMoon
 const MOON_WATER_STRENGTH = 0.15;
 import { getAnimatableProperties } from '@3driseai/3drise-core';
 import { applyConfigKeyframeAnimations, applyConfigMouseMove, } from '../utils/configAnimations.js';
-export function useOceanMaterial({ id, config, quality, skySettings, timeSettings, sunIntensity = 1, animations, mouseMove, onFrame, }) {
+export function useOceanMaterial({ id, config, quality, skySettings, timeSettings, sunIntensity = 1, animations, mouseMove, terrain, onFrame, }) {
     const { state: sun, update: updateSun } = useCloudSun({ skySettings, timeSettings });
     const moon = useRef({ direction: new THREE.Vector3(), illumination: 0 });
     const material = useMemo(() => new OceanSurfaceMaterial(), []);
@@ -82,6 +82,26 @@ export function useOceanMaterial({ id, config, quality, skySettings, timeSetting
         const cfg = { ...config, ...o, ...liveConfig.current };
         const qual = { ...quality, ...liveQuality.current };
         applyOceanUniforms(shader, cfg, qual);
+        // The shoreline. OCEAN_TERRAIN compiles the terrain field into the water;
+        // it flips only when terrain is switched on or off, never per frame.
+        const withTerrain = !!terrain?.enabled;
+        const defines = (shader.defines ??= {});
+        if (withTerrain !== ('OCEAN_TERRAIN' in defines)) {
+            if (withTerrain)
+                defines.OCEAN_TERRAIN = '';
+            else
+                delete defines.OCEAN_TERRAIN;
+            shader.needsUpdate = true;
+        }
+        const u = shader.uniforms;
+        u.u_shoreDepth.value = Math.max(cfg.shoreDepth ?? 3, 0.05);
+        u.u_shoreFoam.value = cfg.shoreFoam ?? 1;
+        if (withTerrain && terrain) {
+            applyTerrainFieldUniforms(shader, terrain);
+            u.u_sunShadow.value = cfg.terrainShadow ?? 1;
+            u.u_shadowSteps.value = Math.round(qual.terrainShadowSteps ?? 10);
+            u.u_shadowDistance.value = Math.max(qual.terrainShadowDistance ?? 4000, 1);
+        }
         shader.uniforms.u_time.value = state.clock.getElapsedTime();
         // World size of one pixel at unit distance. The detail fade and the
         // specular filtering are both screen-space decisions — whether a ripple

package/dist/hooks/useOrbitTargetFollow.d.ts

@@ -0,0 +1,10 @@
+import type { ControlsConfig, OrbitTargetObject } from '@3driseai/3drise-core';
+export declare function useOrbitTargetFollow(controlsRef: React.MutableRefObject<any>, targetObject: OrbitTargetObject | null | undefined, followObject: OrbitTargetObject | null | undefined, 
+/** True while something else owns the camera position (a camera animation). */
+isCameraBusy: () => boolean, 
+/** False when the orbit controls are switched off: the camera keeps its own orientation. */
+orbiting: boolean, 
+/** The authored controls — their limits are what the widening falls back to. */
+authored: ControlsConfig): void;
+export default useOrbitTargetFollow;
+//# sourceMappingURL=useOrbitTargetFollow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useOrbitTargetFollow.d.ts","sourceRoot":"","sources":["../../src/hooks/useOrbitTargetFollow.ts"],"names":[],"mappings":"AA+CA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAsE/E,wBAAgB,oBAAoB,CAChC,WAAW,EAAE,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,EACxC,YAAY,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,EAClD,YAAY,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS;AAClD,+EAA+E;AAC/E,YAAY,EAAE,MAAM,OAAO;AAC3B,4FAA4F;AAC5F,QAAQ,EAAE,OAAO;AACjB,gFAAgF;AAChF,QAAQ,EAAE,cAAc,QAqE3B;AAED,eAAe,oBAAoB,CAAC"}

package/dist/hooks/useOrbitTargetFollow.js

@@ -0,0 +1,194 @@
+// =============================================================================
+// useOrbitTargetFollow — the camera tracks scene objects
+// =============================================================================
+//
+// Two independent settings on `controls`:
+//
+//   targetObject   ORBIT TARGET — the orbit point (what the camera looks at) sits on the
+//                  object's centre every frame. The camera position is not touched; it
+//                  only turns to keep looking at the object.
+//   followObject   FOLLOW — the camera travels with the object: it (and the orbit point)
+//                  moves by exactly as much as the object moved, so the distance and
+//                  angle stay the same. Translation only — the object spinning in place
+//                  does not swing the camera around.
+//
+// Both together: the camera rides along with one object and looks at another (or the
+// same one).
+//
+// Smoothness — why this runs in scene.onBeforeRender and not in useFrame:
+// clips, actions, effects and physics move objects in useFrame callbacks, some of them
+// after this component's. Reading the object in useFrame would see last frame's position
+// half the time, so the camera would trail the object by a frame and stutter. Three calls
+// scene.onBeforeRender inside gl.render, after it has updated every matrixWorld and before
+// it builds the view — so here every object is exactly where it is drawn this frame. We
+// move the camera, re-aim it and update its matrix ourselves, and this frame's image is
+// already right.
+//
+// The object's centre is its bounding-box centre, measured once in the object's own space
+// when it is found and then carried by its matrixWorld every frame — exact under animation
+// and cheap (no per-frame box).
+//
+// Limits vs a moving target: OrbitControls clamps the camera's distance and angles to
+// the target on every update. When the TARGET moves (the plane climbs above a camera
+// limited to 88°), that clamp would drag the camera along — the camera must not move.
+// So while looking at an object, the limits are widened each frame just enough to hold
+// where the camera is now: the object can take the view outside the authored range,
+// the user still can't rotate / zoom further out of it, and moving back in tightens
+// them to the authored values again. The authored values come from `controls`.
+//
+// Height limits (controls.minHeight / maxHeight) are world Y, not relative to the target,
+// and are applied after everything else in the frame.
+//
+// While a camera animation (path / gsap) runs, follow does not move the camera — the
+// animation owns its position; the follow just keeps counting, so nothing jumps after.
+//
+import { useEffect, useRef } from 'react';
+import { useFrame, useThree } from '@react-three/fiber';
+import { Box3, Vector3 } from 'three';
+import { orbitAngleLimits } from '@3driseai/3drise-core';
+import { findById } from '../utils/sceneQuery.js';
+const RESOLVE_EVERY = 30; // frames between lookups while the object is missing
+const _box = new Box3();
+const _p = new Vector3();
+const _d = new Vector3();
+const _off = new Vector3();
+const keyOf = (t) => (t?.id ? `${t.id}|${t.node ?? ''}` : '');
+/** Finds one object and gives its centre in world space, every frame, without lag. */
+class Tracker {
+    key = '';
+    obj = null;
+    local = new Vector3(); // bounding-box centre in the object's own space
+    missingSince = -1e9;
+    locked = false; // first point taken
+    last = new Vector3(); // point at the previous frame
+    sync(t) {
+        const key = keyOf(t);
+        if (key === this.key)
+            return;
+        this.key = key;
+        this.obj = null;
+        this.missingSince = -1e9;
+        this.locked = false;
+    }
+    /** Writes the object's centre into `out`; false while the object is not there. */
+    point(t, frame, out) {
+        if (!this.obj || !this.obj.parent) {
+            if (frame - this.missingSince < RESOLVE_EVERY)
+                return false;
+            const root = findById(t.id);
+            const obj = root && t.node ? root.getObjectByName(t.node) ?? null : root;
+            if (!obj) {
+                this.missingSince = frame;
+                this.obj = null;
+                return false;
+            }
+            this.obj = obj;
+            this.locked = false;
+            obj.updateWorldMatrix(true, true);
+            _box.setFromObject(obj);
+            if (_box.isEmpty())
+                this.local.set(0, 0, 0);
+            else
+                obj.worldToLocal(_box.getCenter(this.local));
+        }
+        out.copy(this.local).applyMatrix4(this.obj.matrixWorld);
+        return true;
+    }
+}
+/** Authored limits, widened to include the camera's current distance and angles to the target. */
+function widenLimits(controls, cameraPos, auth) {
+    _off.copy(cameraPos).sub(controls.target);
+    const r = _off.length();
+    if (r < 1e-6)
+        return;
+    const phi = Math.acos(Math.min(1, Math.max(-1, _off.y / r)));
+    const theta = Math.atan2(_off.x, _off.z);
+    const lim = orbitAngleLimits(auth);
+    const minD = auth.minDistance ?? 0, maxD = auth.maxDistance ?? Infinity;
+    controls.minDistance = Math.min(minD, r);
+    controls.maxDistance = Math.max(maxD, r);
+    controls.minPolarAngle = Math.min(lim.minPolarAngle, phi);
+    controls.maxPolarAngle = Math.max(lim.maxPolarAngle, phi);
+    // Azimuth: only when it is limited (the full circle needs nothing).
+    if (lim.maxAzimuthAngle - lim.minAzimuthAngle < Math.PI * 2 - 1e-6) {
+        controls.minAzimuthAngle = Math.min(lim.minAzimuthAngle, theta);
+        controls.maxAzimuthAngle = Math.max(lim.maxAzimuthAngle, theta);
+    }
+}
+export function useOrbitTargetFollow(controlsRef, targetObject, followObject, 
+/** True while something else owns the camera position (a camera animation). */
+isCameraBusy, 
+/** False when the orbit controls are switched off: the camera keeps its own orientation. */
+orbiting, 
+/** The authored controls — their limits are what the widening falls back to. */
+authored) {
+    const { scene, camera } = useThree();
+    const live = useRef({ targetObject, followObject, isCameraBusy, orbiting, authored });
+    live.current = { targetObject, followObject, isCameraBusy, orbiting, authored };
+    const frame = useRef(0);
+    const done = useRef(-1);
+    const aim = useRef(new Tracker());
+    const follow = useRef(new Tracker());
+    // A frame counter, so the render hook runs once per frame even if the scene is
+    // rendered more than once (reflections, previews).
+    useFrame(() => { frame.current++; });
+    useEffect(() => {
+        const prev = scene.onBeforeRender;
+        scene.onBeforeRender = function (...args) {
+            prev.apply(this, args);
+            const cam = args[2];
+            if (cam !== camera || done.current === frame.current)
+                return;
+            done.current = frame.current;
+            const controls = controlsRef.current;
+            const { targetObject: tObj, followObject: fObj, isCameraBusy: busy, orbiting: orb, authored: auth } = live.current;
+            const f = follow.current, a = aim.current;
+            f.sync(fObj);
+            a.sync(tObj);
+            let moved = false;
+            // FOLLOW: move the camera and the orbit point with the object.
+            if (fObj && f.point(fObj, frame.current, _p)) {
+                if (!f.locked) {
+                    f.last.copy(_p);
+                    f.locked = true;
+                }
+                _d.copy(_p).sub(f.last);
+                f.last.copy(_p);
+                if (_d.lengthSq() > 0 && !busy()) {
+                    camera.position.add(_d);
+                    if (controls)
+                        controls.target.add(_d);
+                    moved = true;
+                }
+            }
+            // ORBIT TARGET: look at the object; the camera stays where it is.
+            if (tObj && controls && a.point(tObj, frame.current, _p)) {
+                if (!a.locked || !controls.target.equals(_p)) {
+                    controls.target.copy(_p);
+                    if (orb)
+                        camera.lookAt(_p);
+                    a.locked = true;
+                    moved = true;
+                }
+            }
+            // HEIGHT LIMITS (world Y): last, so nothing — user, target, follow, a clip — ends
+            // the frame under the floor or over the ceiling. The camera keeps facing the target.
+            const minH = typeof auth.minHeight === 'number' ? auth.minHeight : -Infinity;
+            const maxH = typeof auth.maxHeight === 'number' ? auth.maxHeight : Infinity;
+            const y = Math.min(maxH, Math.max(minH, camera.position.y));
+            if (y !== camera.position.y) {
+                camera.position.y = y;
+                if (orb && controls)
+                    camera.lookAt(controls.target);
+                moved = true;
+            }
+            if (moved)
+                camera.updateMatrixWorld();
+            // Limits hold the camera where the moving target left it (see the header).
+            if (tObj && controls && a.locked)
+                widenLimits(controls, camera.position, auth);
+        };
+        return () => { scene.onBeforeRender = prev; };
+    }, [scene, camera, controlsRef]);
+}
+export default useOrbitTargetFollow;

package/dist/index.d.ts

@@ -15,16 +15,17 @@ export { cameraManager } from './utils/CameraSingleton';
 export { applyAnchorSettings, createCurves, createSunPosition, randomRange, } from './utils/utils3d';
 export { applyAnchorSettings as applyAnchorSettingsLegacy } from './utils/anchorUtils';
 export * from './utils/shapes';
+export * from './utils/pickProxy';
 export { hasHoverAnimation } from './utils/hasHoverAnimation';
 export { findById } from './utils/sceneQuery';
 export { hasFrameRenderer, registerFrameRenderer, renderFrame } from './utils/frameRenderer';
 export type { FrameRenderer } from './utils/frameRenderer';
 export { resolveObject3D } from './utils/resolveObject3D';
 export type { Object3DRefLike, Object3DSource } from './utils/resolveObject3D';
-export * from './utils/textEffects';
 export { applyTerrainUniforms, applyTerrainTextures } from './utils/terrainUniforms';
 export { useTerrainTextures } from './hooks/useTerrainTextures';
 export { terrainHeightAt } from './utils/terrainHeight';
+export { isMobileDevice } from './utils/deviceTier';
 export { setTerrainTextureResolver, resolveTerrainTextureSets, useTerrainTextureResolverVersion, type TerrainTextureResolver } from './utils/terrainTextureResolver';
 export { landHeightAt, landWorldHeightAt, landSeedOffset, landToTerrainConfig, LAND_SEGMENTS } from './utils/landPatch';
 export type { TerrainTextureState } from './hooks/useTerrainTextures';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -18,14 +18,15 @@ export { cameraManager } from './utils/CameraSingleton.js';
 export { applyAnchorSettings, createCurves, createSunPosition, randomRange, } from './utils/utils3d.js';
 export { applyAnchorSettings as applyAnchorSettingsLegacy } from './utils/anchorUtils.js';
 export * from './utils/shapes.js';
+export * from './utils/pickProxy.js';
 export { hasHoverAnimation } from './utils/hasHoverAnimation.js';
 export { findById } from './utils/sceneQuery.js';
 export { hasFrameRenderer, registerFrameRenderer, renderFrame } from './utils/frameRenderer.js';
 export { resolveObject3D } from './utils/resolveObject3D.js';
-export * from './utils/textEffects.js';
 export { applyTerrainUniforms, applyTerrainTextures } from './utils/terrainUniforms.js';
 export { useTerrainTextures } from './hooks/useTerrainTextures.js';
 export { terrainHeightAt } from './utils/terrainHeight.js';
+export { isMobileDevice } from './utils/deviceTier.js';
 export { setTerrainTextureResolver, resolveTerrainTextureSets, useTerrainTextureResolverVersion } from './utils/terrainTextureResolver.js';
 export { landHeightAt, landWorldHeightAt, landSeedOffset, landToTerrainConfig, LAND_SEGMENTS } from './utils/landPatch.js';
 export { applyLandscapeMaps, applyLandscapeUniforms } from './utils/landscapeUniforms.js';

package/dist/operations/catalogue/flock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flock.d.ts","sourceRoot":"","sources":["../../../src/operations/catalogue/flock.ts"],"names":[],"mappings":";AA6CA,wBAwHG"}
+{"version":3,"file":"flock.d.ts","sourceRoot":"","sources":["../../../src/operations/catalogue/flock.ts"],"names":[],"mappings":";AA+CA,wBAyJG"}