@3driseai/3drise-viewer 0.1.30 → 0.1.31

package/dist/components/particles/index.d.ts

@@ -20,4 +20,6 @@ export { default as ShapeBurstParticles } from './ShapeBurstParticles';
 export type { ShapeBurstParticlesProps } from './ShapeBurstParticles';
 export { default as ShapeFlowParticles } from './ShapeFlowParticles';
 export type { ShapeFlowParticlesProps } from './ShapeFlowParticles';
+export { default as FireworksParticles } from './FireworksParticles';
+export type { FireworksParticlesProps } from './FireworksParticles';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/particles/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/particles/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACzE,YAAY,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC3E,YAAY,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,OAAO,IAAI,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AACvF,YAAY,EAAE,gCAAgC,EAAE,MAAM,+BAA+B,CAAC;AACtF,OAAO,EAAE,OAAO,IAAI,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACnF,YAAY,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAClF,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,YAAY,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACzE,YAAY,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,YAAY,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACnE,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAC/E,YAAY,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACvE,YAAY,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACrE,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/particles/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACzE,YAAY,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC3E,YAAY,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,OAAO,IAAI,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AACvF,YAAY,EAAE,gCAAgC,EAAE,MAAM,+BAA+B,CAAC;AACtF,OAAO,EAAE,OAAO,IAAI,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACnF,YAAY,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAClF,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,YAAY,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACzE,YAAY,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,YAAY,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACnE,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAC/E,YAAY,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACvE,YAAY,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACrE,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACrE,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/components/particles/index.js

@@ -10,3 +10,4 @@ export { default as NeonRainParticles } from './NeonRainParticles.js';
 export { default as MagneticBottleParticles } from './MagneticBottleParticles.js';
 export { default as ShapeBurstParticles } from './ShapeBurstParticles.js';
 export { default as ShapeFlowParticles } from './ShapeFlowParticles.js';
+export { default as FireworksParticles } from './FireworksParticles.js';

package/dist/components/terrain/TerrainSurface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TerrainSurface.d.ts","sourceRoot":"","sources":["../../../src/components/terrain/TerrainSurface.tsx"],"names":[],"mappings":"AACA,OAAO,KAAqC,MAAM,OAAO,CAAC;AAkB1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;;;;;;;;;;;;;;;GAgBG;AACH,QAAA,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAkI/C,CAAC;AAEF,eAAe,cAAc,CAAC"}
+{"version":3,"file":"TerrainSurface.d.ts","sourceRoot":"","sources":["../../../src/components/terrain/TerrainSurface.tsx"],"names":[],"mappings":"AACA,OAAO,KAAqC,MAAM,OAAO,CAAC;AAkB1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAkBjD;;;;;;;;;;;;;;;;GAgBG;AACH,QAAA,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CA6I/C,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/components/terrain/TerrainSurface.js

@@ -11,6 +11,21 @@ import { applyTerrainAmbient, applyTerrainTextures, applyTerrainUniforms } from
 import { useTerrainTextures } from '../../hooks/useTerrainTextures.js';
 import { getAnimatableProperties } from '@3driseai/3drise-core';
 import { applyConfigKeyframeAnimations, applyConfigMouseMove, } from '../../utils/configAnimations.js';
+import { TERRAIN_DRAW_ORDER, ringDrawOrder } from '../../utils/environmentDrawOrder.js';
+import { isMobileDevice } from '../../utils/deviceTier.js';
+/**
+ * Phone / tablet tier, applied at render time only — the saved scene keeps its
+ * numbers, so the same project is full quality on a desktop. Measured on the
+ * desktop: textures within 100 m instead of 1500 saved ~2.8 ms, 5 octaves
+ * instead of 8 ~1.7 ms; the shadow march costs nothing measurable, so it stays.
+ * Fewer, coarser rings cut the vertex load by roughly half.
+ */
+const MOBILE = {
+    maxSegments: 96,
+    maxLevels: 8,
+    maxOctaves: 5,
+    maxTextureDistance: 400,
+};
 /**
  * The terrain renderer. One clipmap, one material, four landforms — they differ
  * by the shaping operator the height field applies, not by having separate
@@ -29,7 +44,8 @@ import { applyConfigKeyframeAnimations, applyConfigMouseMove, } from '../../util
  * the camera. Nothing here re-renders React.
  */
 const TerrainSurface = ({ id = '3drise-terrain', config, quality, skySettings, timeSettings, sunIntensity = 1, animations, mouseMove, onObjectReady, onObjectDispose, }) => {
-    const clipmap = useTerrainClipmap(quality.levels, quality.segments, quality.cellSize);
+    const mobile = isMobileDevice();
+    const clipmap = useTerrainClipmap(mobile ? Math.min(quality.levels, MOBILE.maxLevels) : quality.levels, mobile ? Math.min(quality.segments, MOBILE.maxSegments) : quality.segments, quality.cellSize);
     const { state: sun, update: updateSun } = useCloudSun({ skySettings, timeSettings });
     const material = useMemo(() => new TerrainMaterial(), []);
     // The four ground textures, packed into arrays. Repacks only when a map URL
@@ -46,9 +62,9 @@ const TerrainSurface = ({ id = '3drise-terrain', config, quality, skySettings, t
     useEffect(() => { liveConfig.current = {}; }, [config]);
     useEffect(() => { liveQuality.current = {}; }, [quality]);
     // The `terrain` keyframe / pointer domains: config -> keyframes -> pointer ->
-    // live drag, the clouds' order. Only the surface's lighting and colour knobs are
-    // in the set — the registry marks every land-shape knob non-animatable, so the
-    // ground itself never moves.
+    // live drag, the clouds' order. Every numeric / colour knob is in the set — shape
+    // and surface alike are shader uniforms, so the ground can rise or shift per frame;
+    // only the integer counts (octaves, strata) are structural in the registry.
     const animatable = useMemo(() => new Set(getAnimatableProperties({ type: 'terrain', config }, 'terrain').map(p => p.value)), [config.terrainType]);
     const override = useRef({});
     const startValues = useRef({});
@@ -91,6 +107,10 @@ const TerrainSurface = ({ id = '3drise-terrain', config, quality, skySettings, t
             applyConfigMouseMove(mouseMove.terrain.properties, config, o, state.pointer, animatable);
         }
         const cfg = { ...config, ...o, ...liveConfig.current };
+        if (mobile) {
+            cfg.octaves = Math.min(cfg.octaves, MOBILE.maxOctaves);
+            cfg.textureDistance = Math.min(cfg.textureDistance ?? 4000, MOBILE.maxTextureDistance);
+        }
         const qual = { ...quality, ...liveQuality.current };
         applyTerrainUniforms(material, cfg, qual);
         applyTerrainTextures(material, cfg, textures);
@@ -110,6 +130,8 @@ const TerrainSurface = ({ id = '3drise-terrain', config, quality, skySettings, t
         }
     });
     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, 
+            // After the water, inner ring first: see environmentDrawOrder.
+            renderOrder: ringDrawOrder(TERRAIN_DRAW_ORDER, ring.level), 
             // Displacement happens in the vertex shader, so the object-space
             // bounds describe a flat plane. Culling against them hides the
             // terrain the moment the camera tilts up.

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,aAqBhC,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

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

@@ -25,6 +25,7 @@ export type { Object3DRefLike, Object3DSource } from './utils/resolveObject3D';
 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

@@ -26,6 +26,7 @@ export { resolveObject3D } from './utils/resolveObject3D.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';