@3driseai/3drise-viewer 0.1.7 → 0.1.8

package/dist/components/SkySystem.d.ts

@@ -1,7 +1,22 @@
 import type { ObjectReadyProps } from '../types/objectReady';
 import * as THREE from 'three';
-import type { TimeSettings, StarsSettings, CloudsSettings, SkySettings, RainSettings, FogSettings, MaterialSettings } from '@3driseai/3drise-core';
-import React from "react";
+import type { TimeSettings, SkySettings, FogSettings } from '@3driseai/3drise-core';
+import type { VolumetricCloudsSettings } from '../types/cloudConfigs';
+import React from 'react';
+/**
+ * Sky, sun and everything lit by them.
+ *
+ * Pure and props-driven: it holds no store subscription of its own, so the same
+ * component serves the editor (through a thin connector that supplies the props
+ * from Redux) and a published scene (through EnvironmentManager, which reads
+ * them out of the saved project). There is deliberately no second copy of this
+ * file in the client — a divergence here shows up as an embed that renders
+ * differently from the editor it was authored in.
+ *
+ * It owns the per-frame tick of skySystemManager, which is the single source of
+ * truth for time of day. Everything below reads the manager rather than
+ * receiving a sun direction, so nothing has to be threaded through props.
+ */
 export interface SkySystemRef {
     setTime: (hours: number, minutes?: number) => void;
     getTime: () => Date;
@@ -11,6 +26,9 @@ export interface SkySystemRef {
 export interface SkySystemProps extends ObjectReadyProps {
     timeSettings: TimeSettings;
     visible?: boolean;
+    /** True mounts the physical sun rig (skybox + lensflare + directional light);
+     *  false mounts the analytic Preetham sky instead. They are alternatives, not
+     *  layers — the sun rig draws its own background. */
     sunSystemVisible?: boolean;
     sunSize?: number;
     moonSize?: number;
@@ -19,11 +37,14 @@ export interface SkySystemProps extends ObjectReadyProps {
     castShadow?: boolean;
     shadowMapSize?: number;
     playerPosition?: THREE.Vector3;
-    starsSettings?: StarsSettings;
-    cloudsSettings?: CloudsSettings;
-    cloudsMaterialSettings?: MaterialSettings;
+    /** Volumetric cloud layers. Optional because a host may prefer to mount
+     *  CloudsGenerator itself as a sibling — the editor does, so a cloud slider
+     *  cannot re-render the sun. Both positions put the pass in the same place
+     *  in the tree. */
+    cloudsSettings?: VolumetricCloudsSettings;
     skyControllerSettings?: SkySettings;
-    rainSettings?: RainSettings;
+    /** Optional for the same reason as cloudsSettings: the editor gives fog its
+     *  own connector, the embed path passes it here. */
     fogSettings?: FogSettings;
     onTimeOfDayChange?: (timeOfDay: string, elapsedTime: number) => void;
     onTimeUpdate?: (timeOfDay: number) => void;

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

@@ -1 +1 @@
-{"version":3,"file":"SkySystem.d.ts","sourceRoot":"","sources":["../../src/components/SkySystem.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAMnJ,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,YAAY,EAAE,MAAM,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,KAAK,CAAC,OAAO,CAAC;CACxC;AAED,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACpD,YAAY,EAAE,YAAY,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC;IAC/B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,sBAAsB,CAAC,EAAE,gBAAgB,CAAC;IAC1C,qBAAqB,CAAC,EAAE,WAAW,CAAC;IACpC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IACrE,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAGD,QAAA,MAAM,SAAS,EAAE,KAAK,CAAC,yBAAyB,CAAC,cAAc,GAAG,KAAK,CAAC,aAAa,CAAC,YAAY,CAAC,CAoCjG,CAAC;AAEH,eAAe,SAAS,CAAC"}
+{"version":3,"file":"SkySystem.d.ts","sourceRoot":"","sources":["../../src/components/SkySystem.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAOtE,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,YAAY,EAAE,MAAM,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,KAAK,CAAC,OAAO,CAAC;CACxC;AAED,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACpD,YAAY,EAAE,YAAY,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;yDAEqD;IACrD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC;IAC/B;;;uBAGmB;IACnB,cAAc,CAAC,EAAE,wBAAwB,CAAC;IAC1C,qBAAqB,CAAC,EAAE,WAAW,CAAC;IACpC;wDACoD;IACpD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IACrE,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAED,QAAA,MAAM,SAAS,qFAmHb,CAAC;AAGH,eAAe,SAAS,CAAC"}

package/dist/components/SkySystem.js

@@ -1,7 +1,6 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import { useObjectReady } from '../hooks/useObjectReady.js';
 import { useEffect, useLayoutEffect, useRef, forwardRef, useImperativeHandle } from 'react';
-import * as THREE from 'three';
 import { useFrame } from '@react-three/fiber';
 import { skySystemManager } from '@3driseai/3drise-core';
 import Skybox from './Skybox.js';
@@ -9,7 +8,8 @@ import Lensflare from './Lensflare.js';
 import SunLight from './SunLight.js';
 import SkyController from './SkyController.js';
 import SceneFog from './SceneFog.js';
-const SkySystem = forwardRef(({ timeSettings, visible = true, sunSystemVisible = false, sunSize = 1, moonSize = 1, skyboxScale = 1000, sunIntensity = 1, castShadow = true, shadowMapSize = 2048, playerPosition = new THREE.Vector3(0, 0, 0), starsSettings, cloudsSettings, cloudsMaterialSettings, skyControllerSettings, rainSettings, fogSettings, onTimeOfDayChange, onTimeUpdate, onObjectReady, onObjectDispose, }, ref) => {
+import CloudsGenerator from './CloudsGenerator.js';
+const SkySystem = forwardRef(({ timeSettings, visible = true, sunSystemVisible = false, sunSize = 1, moonSize = 1, skyboxScale = 100000, sunIntensity = 1, castShadow = true, shadowMapSize = 2048, playerPosition, cloudsSettings, skyControllerSettings, fogSettings, onTimeOfDayChange, onTimeUpdate, onObjectReady, onObjectDispose, }, ref) => {
     const previousTimeOfDayRef = useRef(null);
     const rootRef = useRef(null);
     const ready = { onObjectReady, onObjectDispose };
@@ -20,8 +20,9 @@ const SkySystem = forwardRef(({ timeSettings, visible = true, sunSystemVisible =
         getTimeOfDay: () => skySystemManager.getTimeOfDay(),
         getSunDirection: () => skySystemManager.getSunDirection(),
     }));
-    // useLayoutEffect so the manager is registered before useFrame's first
-    // rAF callback (regular useEffect runs after paint, too late).
+    // useLayoutEffect so the manager is registered before useFrame's first rAF
+    // callback — a regular useEffect runs after paint, and the first tick is
+    // dropped with manager.enabled still false.
     useLayoutEffect(() => {
         skySystemManager.setTimeSettings(timeSettings);
     }, [timeSettings]);
@@ -44,7 +45,7 @@ const SkySystem = forwardRef(({ timeSettings, visible = true, sunSystemVisible =
     });
     if (!visible)
         return null;
-    return (_jsxs("group", { ref: rootRef, children: [skyControllerSettings && !sunSystemVisible && (_jsx(SkyController, { settings: skyControllerSettings, timeSettings: timeSettings, scale: skyboxScale, ...ready })), sunSystemVisible && (_jsxs(_Fragment, { children: [_jsx(Skybox, { visible: true, scale: skyboxScale, sunSize: sunSize, moonSize: moonSize, timeSettings: timeSettings, ...ready }), _jsx(Lensflare, { visible: true, intensity: sunIntensity, timeSettings: timeSettings, ...ready }), _jsx(SunLight, { visible: true, timeSettings: timeSettings, targetPosition: playerPosition, intensity: sunIntensity, castShadow: castShadow, shadowMapSize: shadowMapSize, ...ready })] })), fogSettings && (_jsx(SceneFog, { fog: fogSettings }))] }));
+    return (_jsxs("group", { ref: rootRef, children: [skyControllerSettings && !sunSystemVisible && (_jsx(SkyController, { settings: skyControllerSettings, timeSettings: timeSettings, scale: skyboxScale, ...ready })), sunSystemVisible && (_jsxs(_Fragment, { children: [_jsx(Skybox, { visible: true, scale: skyboxScale, sunSize: sunSize, moonSize: moonSize, timeSettings: timeSettings, ...ready }), _jsx(Lensflare, { visible: true, intensity: sunIntensity, timeSettings: timeSettings, ...ready }), _jsx(SunLight, { visible: true, timeSettings: timeSettings, targetPosition: playerPosition, intensity: sunIntensity, castShadow: castShadow, shadowMapSize: shadowMapSize, ...ready })] })), fogSettings && _jsx(SceneFog, { fog: fogSettings }), cloudsSettings && (_jsx(CloudsGenerator, { settings: cloudsSettings, skySettings: skyControllerSettings, timeSettings: timeSettings, sunIntensity: sunIntensity, ...ready }))] }));
 });
 SkySystem.displayName = 'SkySystem';
 export default SkySystem;

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

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

package/dist/components/SunLight.js

@@ -13,7 +13,10 @@ const SUNRISE = 6;
 const SUNSET = 21;
 const DARKNESS_START = 20.42;
 const DARKNESS_END = 6.58;
-const SunLight = ({ visible = true, timeSettings, targetPosition = new THREE.Vector3(0, 0, 0), shadowDistance = 300, intensity: intensityMultiplier = 1, castShadow = true, shadowMapSize = 2048, onObjectReady, onObjectDispose, }) => {
+/** Shared so the default does not hand a fresh Vector3 to the deps array on every
+ *  render, which re-ran the reposition effect every time anything above re-rendered. */
+const ORIGIN = new THREE.Vector3(0, 0, 0);
+const SunLight = ({ visible = true, timeSettings, targetPosition = ORIGIN, shadowDistance = 300, intensity: intensityMultiplier = 1, castShadow = true, shadowMapSize = 2048, onObjectReady, onObjectDispose, }) => {
     const lightRef = useRef(null);
     useObjectReady(lightRef, { visible, timeSettings, intensity: intensityMultiplier, castShadow, shadowMapSize }, onObjectReady, onObjectDispose);
     const colorRef = useRef(new THREE.Color(0xffe5b0));

package/dist/components/TerrainBuilder.d.ts

@@ -0,0 +1,30 @@
+import React from 'react';
+import type { SkySettings, TimeSettings } from '@3driseai/3drise-core';
+import type { ObjectReadyProps } from '../types/objectReady';
+import type { ProceduralTerrainSettings } from '../types/terrainConfigs';
+export interface TerrainBuilderProps extends ObjectReadyProps {
+    /** Accepts a partial or older-shaped blob — including core's retired flat
+     *  `TerrainSettings`, which has no `config` and normalises to nothing rather
+     *  than to a landscape the project was never authored with. */
+    settings?: Partial<ProceduralTerrainSettings> | null;
+    skySettings?: SkySettings;
+    timeSettings?: TimeSettings;
+    /** Matches SkySystem's sunIntensity, so terrain brightens with the scene. */
+    sunIntensity?: number;
+}
+/**
+ * Picks the landform for the scene's ground.
+ *
+ * The counterpart to `CloudsGenerator`, and deliberately the same shape: switch
+ * on the model field, mount exactly one renderer, normalise each block against
+ * its own source so editing one cannot invalidate the other.
+ *
+ * Terrain is simpler than the sky in one respect — there is one landform, not a
+ * deck plus an independent ice layer — so there is no second branch to compose.
+ * It is harder in another: `quality` rebuilds every clipmap ring when its
+ * identity changes, which is why it is memoised separately and why the controller
+ * writes quality changes live rather than through Redux.
+ */
+declare const TerrainBuilder: React.FC<TerrainBuilderProps>;
+export default TerrainBuilder;
+//# sourceMappingURL=TerrainBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TerrainBuilder.d.ts","sourceRoot":"","sources":["../../src/components/TerrainBuilder.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAOzE,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IACzD;;mEAE+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,GAAG,IAAI,CAAC;IACrD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;GAYG;AACH,QAAA,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CA+BjD,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/components/TerrainBuilder.js

@@ -0,0 +1,44 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useMemo } from 'react';
+import { normalizeTerrain, normalizeTerrainQuality } from '../types/terrainConfigs.js';
+import Mountains from './terrain/Mountains.js';
+import Dunes from './terrain/Dunes.js';
+import Hills from './terrain/Hills.js';
+import Canyon from './terrain/Canyon.js';
+/**
+ * Picks the landform for the scene's ground.
+ *
+ * The counterpart to `CloudsGenerator`, and deliberately the same shape: switch
+ * on the model field, mount exactly one renderer, normalise each block against
+ * its own source so editing one cannot invalidate the other.
+ *
+ * Terrain is simpler than the sky in one respect — there is one landform, not a
+ * deck plus an independent ice layer — so there is no second branch to compose.
+ * It is harder in another: `quality` rebuilds every clipmap ring when its
+ * identity changes, which is why it is memoised separately and why the controller
+ * writes quality changes live rather than through Redux.
+ */
+const TerrainBuilder = ({ settings, skySettings, timeSettings, sunIntensity, onObjectReady, onObjectDispose, }) => {
+    const config = useMemo(() => normalizeTerrain(settings?.config), [settings?.config]);
+    const quality = useMemo(() => normalizeTerrainQuality(settings?.quality), [settings?.quality]);
+    if (!config?.enabled)
+        return null;
+    const shared = {
+        config,
+        quality,
+        skySettings,
+        timeSettings,
+        sunIntensity,
+        id: settings?.id,
+        onObjectReady,
+        onObjectDispose,
+    };
+    switch (config.terrainType) {
+        case 'mountains': return _jsx(Mountains, { ...shared });
+        case 'dunes': return _jsx(Dunes, { ...shared });
+        case 'canyon': return _jsx(Canyon, { ...shared });
+        case 'hills':
+        default: return _jsx(Hills, { ...shared });
+    }
+};
+export default TerrainBuilder;

package/dist/components/index.d.ts

@@ -1,8 +1,10 @@
 export type { AnimatedObjectProps } from './AnimatedObject';
 export type { BubblesProps } from './Bubbles';
 export type { CloudsProps } from './Clouds';
+export type { CloudsGeneratorProps } from './CloudsGenerator';
 export type { EffectsGeneratorProps } from './EffectsGenerator';
-export type { EnvironmentManagerProps } from './EnvironmentManager';
+export type { EnvironmentManagerProps, ViewerEnvironmentConfig } from './EnvironmentManager';
+export type { HdrEnvironmentProps } from './HdrEnvironment';
 export type { OutlineMode, Point3 } from './extractOutline';
 export type { FrameProps } from './Frame';
 export type { FrameShapeType } from './FrameGeometry';
@@ -48,18 +50,22 @@ export type { StarsProps } from './Stars';
 export type { SunCoreProps } from './SunCore';
 export type { SunLightProps } from './SunLight';
 export type { Text2DProps } from './Text2D';
+export type { TerrainBuilderProps } from './TerrainBuilder';
+export type { OceanBuilderProps } from './OceanBuilder';
 export type { Text3DProps } from './Text3D';
 export type { VolumePointsProps } from './VolumePoints';
 export { AnimatedObject, default as AnimatedObjectDefault } from './AnimatedObject';
 export { default as Bubbles } from './Bubbles';
 export { CameraController, default as CameraControllerDefault } from './CameraController';
 export { default as Clouds } from './Clouds';
+export { default as CloudsGenerator } from './CloudsGenerator';
 export { default as CreatedObject } from './CreatedObject';
 export { default as CustomPrimitive } from './CustomPrimitive';
 export { default as Earth } from './Earth';
 export { default as EffectsGenerator } from './EffectsGenerator';
 export { default as EffectsGroup } from './EffectsGroup';
 export { default as EnvironmentManager } from './EnvironmentManager';
+export { default as HdrEnvironment, isHdrActive } from './HdrEnvironment';
 export { default as EnvironmentObject } from './EnvironmentObject';
 export { default as Frame } from './Frame';
 export { FrameGeometry } from './FrameGeometry';
@@ -119,11 +125,21 @@ export { default as Stars, generateStarsGeometry } from './Stars';
 export { default as Sun } from './Sun';
 export { default as SunCore } from './SunCore';
 export { default as SunLight } from './SunLight';
+export { default as TerrainBuilder } from './TerrainBuilder';
+export { default as OceanBuilder } from './OceanBuilder';
 export { default as Text2D } from './Text2D';
 export { default as Text3D } from './Text3D';
 export { VolumePoints } from './VolumePoints';
 export { FitGroup, GeometryMesh, computeMode, contourSlices, evenScatter, meshVertices, plexus, surfaceScatter, symmetricScatter, useShapeGeometry as useGeometryShape, volumeFill, wireframe, } from './GeometryShape';
 export { contour2D, edges3D } from './extractOutline';
 export * from './cursor';
+export * from './volumetricClouds';
+export * from './terrain';
+export * from './water';
 export * from './effects';
+export type { LandscapeBuilderProps } from './LandscapeBuilder';
+export { default as LandscapeBuilder } from './LandscapeBuilder';
+export type { LandscapeObjectProps } from './LandscapeObject';
+export { default as LandscapeObject } from './LandscapeObject';
+export * from './landscape';
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/components/index.js

@@ -5,12 +5,14 @@ export { AnimatedObject, default as AnimatedObjectDefault } from './AnimatedObje
 export { default as Bubbles } from './Bubbles.js';
 export { CameraController, default as CameraControllerDefault } from './CameraController.js';
 export { default as Clouds } from './Clouds.js';
+export { default as CloudsGenerator } from './CloudsGenerator.js';
 export { default as CreatedObject } from './CreatedObject.js';
 export { default as CustomPrimitive } from './CustomPrimitive.js';
 export { default as Earth } from './Earth.js';
 export { default as EffectsGenerator } from './EffectsGenerator.js';
 export { default as EffectsGroup } from './EffectsGroup.js';
 export { default as EnvironmentManager } from './EnvironmentManager.js';
+export { default as HdrEnvironment, isHdrActive } from './HdrEnvironment.js';
 export { default as EnvironmentObject } from './EnvironmentObject.js';
 export { default as Frame } from './Frame.js';
 export { FrameGeometry } from './FrameGeometry.js';
@@ -70,6 +72,8 @@ export { default as Stars, generateStarsGeometry } from './Stars.js';
 export { default as Sun } from './Sun.js';
 export { default as SunCore } from './SunCore.js';
 export { default as SunLight } from './SunLight.js';
+export { default as TerrainBuilder } from './TerrainBuilder.js';
+export { default as OceanBuilder } from './OceanBuilder.js';
 export { default as Text2D } from './Text2D.js';
 export { default as Text3D } from './Text3D.js';
 export { VolumePoints } from './VolumePoints.js';
@@ -82,4 +86,10 @@ export { FitGroup, GeometryMesh, computeMode, contourSlices, evenScatter, meshVe
 export { contour2D, edges3D } from './extractOutline.js';
 // ------------------------------------------------------------ sub-folders
 export * from './cursor/index.js';
+export * from './volumetricClouds/index.js';
+export * from './terrain/index.js';
+export * from './water/index.js';
 export * from './effects/index.js';
+export { default as LandscapeBuilder } from './LandscapeBuilder.js';
+export { default as LandscapeObject } from './LandscapeObject.js';
+export * from './landscape/index.js';

package/dist/components/landscape/LandscapeMesh.d.ts

@@ -0,0 +1,18 @@
+import React from 'react';
+import type { LandscapeLayerProps } from './types';
+/**
+ * The landscape renderer, shared by the world ground and the placed object.
+ *
+ * Unlike the cloud pass this does not take over the render loop, and unlike the
+ * terrain it is a bounded tile — which is what buys the two things the
+ * procedural terrain cannot have: it frustum-culls per chunk, and it CASTS into
+ * the scene's shadow map, because the sun's shadow camera already covers it.
+ *
+ * Three things happen per frame and none of them re-render React: the config is
+ * pushed into uniforms (with any live controller overrides on top), the bounds
+ * are refreshed if the elevation moved, and the height field's world origin is
+ * kept in step for CPU queries.
+ */
+declare const LandscapeMesh: React.FC<LandscapeLayerProps>;
+export default LandscapeMesh;
+//# sourceMappingURL=LandscapeMesh.d.ts.map

package/dist/components/landscape/LandscapeMesh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LandscapeMesh.d.ts","sourceRoot":"","sources":["../../../src/components/landscape/LandscapeMesh.tsx"],"names":[],"mappings":"AACA,OAAO,KAAkD,MAAM,OAAO,CAAA;AA0BtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAElD;;;;;;;;;;;;GAYG;AACH,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CA8QhD,CAAA;AA8BD,eAAe,aAAa,CAAA"}

package/dist/components/landscape/LandscapeMesh.js

@@ -0,0 +1,278 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import * as THREE from 'three';
+import { useCallback, useEffect, useMemo, useRef } from 'react';
+import { useFrame, useThree } from '@react-three/fiber';
+import { useObjectReady } from '../../hooks/useObjectReady.js';
+import { useLandscapeMaps } from '../../hooks/useLandscapeMaps.js';
+import { LANDSCAPE_LIVE_KEY } from '../../hooks/useLandscapeLive.js';
+import { LandscapeMaterial, createLandscapeDepthMaterial, createLandscapeDistanceMaterial, createLandscapeUniforms, landscapeShapeKey, } from '../../shaders/landscape/LandscapeMaterial.js';
+import { applyLandscapeMaps, applyLandscapeUniforms } from '../../utils/landscapeUniforms.js';
+import { buildLandscapeGeometry, setLandscapeBounds } from '../../utils/landscapeGeometry.js';
+import { registerLandscapeHeightField, unregisterLandscapeHeightField, } from '../../utils/landscapeHeight.js';
+import { LANDSCAPE_LIVE_AUTOSPLAT_KEYS, LANDSCAPE_LIVE_CONFIG_KEYS, LANDSCAPE_LIVE_QUALITY_KEYS, LANDSCAPE_LIVE_SURFACE_KEYS, } from '../../types/landscapeConfigs.js';
+/**
+ * The landscape renderer, shared by the world ground and the placed object.
+ *
+ * Unlike the cloud pass this does not take over the render loop, and unlike the
+ * terrain it is a bounded tile — which is what buys the two things the
+ * procedural terrain cannot have: it frustum-culls per chunk, and it CASTS into
+ * the scene's shadow map, because the sun's shadow camera already covers it.
+ *
+ * Three things happen per frame and none of them re-render React: the config is
+ * pushed into uniforms (with any live controller overrides on top), the bounds
+ * are refreshed if the elevation moved, and the height field's world origin is
+ * kept in step for CPU queries.
+ */
+const LandscapeMesh = ({ id = '3drise-landscape', config, quality, applyTransform = true, onObjectReady, onObjectDispose, }) => {
+    const gl = useThree((state) => state.gl);
+    const maps = useLandscapeMaps(config, quality);
+    const surfaces = useMemo(() => config.surfaces.filter((s) => !!s.diffuse), [config.surfaces]);
+    const count = Math.max(1, surfaces.length);
+    // Uniforms are shared by reference with the depth and distance materials, so
+    // a write here reaches the shadow pass too and the shadow cannot drift from
+    // the surface it belongs to.
+    const uniforms = useMemo(() => createLandscapeUniforms(count), [count]);
+    const shape = useMemo(() => ({
+        count,
+        samples: config.surfaceSamples,
+        splats: config.splatMaps.length,
+        auto: config.splatSource === 'auto' || config.splatMaps.length === 0,
+        stochastic: quality.stochastic && surfaces.some((s) => s.aperiodic),
+        triplanar: quality.triplanar && surfaces.some((s) => s.triplanar),
+        ao: !!config.aoMap,
+    }), [
+        count,
+        config.surfaceSamples,
+        config.splatMaps.length,
+        config.splatSource,
+        config.aoMap,
+        quality.stochastic,
+        quality.triplanar,
+        surfaces,
+    ]);
+    const shapeKey = landscapeShapeKey(shape);
+    // Shape lives in #defines, so a change of shape is a new program. Rebuilding
+    // the material is the honest way to say that; the controller commits those
+    // knobs on release so it happens once per edit, not once per frame of a drag.
+    const material = useMemo(() => new LandscapeMaterial(shape, uniforms), [shapeKey, uniforms]);
+    const depthMaterial = useMemo(() => createLandscapeDepthMaterial(uniforms), [uniforms]);
+    const distanceMaterial = useMemo(() => createLandscapeDistanceMaterial(uniforms), [uniforms]);
+    useEffect(() => () => {
+        material.dispose();
+        depthMaterial.dispose();
+        distanceMaterial.dispose();
+    }, [material, depthMaterial, distanceMaterial]);
+    // RTIN's error map is normalised, so a world-unit budget divides by the
+    // elevation scale. Quantised, because a float that jitters in the last digit
+    // would rebuild the mesh for nothing. Note this reads the COMMITTED
+    // elevation: a live drag moves the surface without re-meshing, and the error
+    // catches up on release.
+    const normalisedError = useMemo(() => {
+        const raw = quality.meshError / Math.max(config.elevationScale, 1e-3);
+        return Math.round(raw * 1e5) / 1e5;
+    }, [quality.meshError, config.elevationScale]);
+    const geometry = useMemo(() => {
+        if (!maps.heightField)
+            return null;
+        return buildLandscapeGeometry(maps.heightField, {
+            size: config.size,
+            chunks: quality.chunks,
+            maxError: normalisedError,
+        });
+    }, [maps.heightField, config.size, quality.chunks, normalisedError]);
+    useEffect(() => () => { geometry?.dispose(); }, [geometry]);
+    useEffect(() => {
+        if (maps.ready)
+            applyLandscapeMaps(uniforms, maps);
+    }, [maps, uniforms]);
+    // ---- live controller overrides -----------------------------------------
+    // A drag writes here every pointer-move and the frame loop reads it on top of
+    // the config, so the landscape responds without a dispatch per frame. Cleared
+    // when the config identity changes, which is exactly slider-end committing
+    // the same value.
+    const liveConfig = useRef({});
+    const liveSurfaces = useRef({});
+    const liveAutoSplat = useRef({});
+    const liveQuality = useRef({});
+    const dirty = useRef(true);
+    // Cleared by the block they belong to, and by that block only: surfaces and
+    // the auto-splat rows live in `config`, so a quality edit must not drop a
+    // surface override that has not been committed yet.
+    useEffect(() => {
+        liveConfig.current = {};
+        liveSurfaces.current = {};
+        liveAutoSplat.current = {};
+        dirty.current = true;
+    }, [config]);
+    useEffect(() => { liveQuality.current = {}; dirty.current = true; }, [quality]);
+    const rootRef = useRef(null);
+    const meshRefs = useRef([]);
+    // The live handle a controller reaches through findById(id).userData.
+    //
+    // It filters. A controller hands over every key its slider owns and this
+    // drops anything that is not purely a uniform, because a rebuild key applied
+    // live half-applies: `size` scales the triplanar projection from a uniform
+    // while the mesh, built at the committed size, stays where it was. The key
+    // sets live in landscapeConfigs so the panel and the renderer cannot drift.
+    const liveHandle = useMemo(() => ({
+        config: (key, value) => {
+            if (!LANDSCAPE_LIVE_CONFIG_KEYS.includes(key))
+                return;
+            liveConfig.current[key] = value;
+            dirty.current = true;
+        },
+        quality: (key, value) => {
+            if (!LANDSCAPE_LIVE_QUALITY_KEYS.includes(key))
+                return;
+            liveQuality.current[key] = value;
+            dirty.current = true;
+        },
+        surface: (index, key, value) => {
+            if (!LANDSCAPE_LIVE_SURFACE_KEYS.includes(key))
+                return;
+            liveSurfaces.current[`${index}:${key}`] = value;
+            dirty.current = true;
+        },
+        autoSplat: (key, value) => {
+            if (!LANDSCAPE_LIVE_AUTOSPLAT_KEYS.includes(key))
+                return;
+            liveAutoSplat.current[key] = value;
+            dirty.current = true;
+        },
+    }), []);
+    // Attached from a CALLBACK REF, not from an effect, and never as a userData
+    // JSX prop (R3F replaces the whole userData object on every render, which
+    // would drop the handle whenever anything above re-rendered).
+    //
+    // The effect version is what broke live editing outright. This component used
+    // to return null until the maps had loaded, so on the first render there was
+    // no group; the effect ran, found `rootRef.current` null, and returned. Its
+    // deps were [id, liveHandle], neither of which changes when the maps finish
+    // loading — so it never ran again, `userData.id` was never set, findById()
+    // never resolved the landscape, and every controller's live handle fell back
+    // to the no-op for the rest of the session. Nothing errored; the panel simply
+    // did nothing until the pointer came up. A callback ref cannot miss the
+    // mount, whatever the render gating does later.
+    const attachRoot = useCallback((group) => {
+        rootRef.current = group;
+        if (!group)
+            return;
+        group.userData.id = id;
+        group.userData[LANDSCAPE_LIVE_KEY] = liveHandle;
+    }, [id, liveHandle]);
+    useEffect(() => () => {
+        const root = rootRef.current;
+        if (root)
+            delete root.userData[LANDSCAPE_LIVE_KEY];
+    }, []);
+    useObjectReady(rootRef, { id, type: 'landscape', config, quality }, onObjectReady, onObjectDispose);
+    // ---- CPU height field ---------------------------------------------------
+    useEffect(() => {
+        if (!maps.heightField)
+            return;
+        return () => unregisterLandscapeHeightField(id);
+    }, [id, maps.heightField]);
+    const appliedElevation = useRef({ scale: NaN, bias: NaN });
+    useFrame(() => {
+        if (!geometry)
+            return;
+        const merged = mergeLive(config, liveConfig.current, liveSurfaces.current, liveAutoSplat.current);
+        const mergedQuality = Object.keys(liveQuality.current).length === 0
+            ? quality
+            : { ...quality, ...liveQuality.current };
+        if (dirty.current) {
+            applyLandscapeUniforms(uniforms, merged, mergedQuality);
+            material.wireframe = mergedQuality.wireframe;
+            material.envMapIntensity = merged.envMapIntensity;
+            // Shadow flags are per mesh, so the live path has to reach the chunks
+            // rather than the material.
+            for (const mesh of meshRefs.current) {
+                if (!mesh)
+                    continue;
+                mesh.castShadow = mergedQuality.castShadows;
+                mesh.receiveShadow = mergedQuality.receiveShadows;
+            }
+            applyAnisotropy(mergedQuality.anisotropy);
+            // rotationY is a live key, and it is a transform rather than a
+            // uniform — the JSX prop carries the committed value, so the drag has
+            // to be written onto the object itself or the slider moves nothing.
+            const root = rootRef.current;
+            if (root && applyTransform) {
+                root.rotation.y = THREE.MathUtils.degToRad(merged.rotationY);
+            }
+            dirty.current = false;
+        }
+        if (appliedElevation.current.scale !== merged.elevationScale
+            || appliedElevation.current.bias !== merged.elevationBias) {
+            appliedElevation.current = { scale: merged.elevationScale, bias: merged.elevationBias };
+            setLandscapeBounds(geometry, merged.elevationScale, merged.elevationBias);
+        }
+        const root = rootRef.current;
+        if (root && maps.heightField) {
+            registerLandscapeHeightField(id, {
+                data: maps.heightField.data,
+                gridSize: maps.heightField.gridSize,
+                tileSize: maps.heightField.tileSize,
+                size: merged.size,
+                origin: root.getWorldPosition(new THREE.Vector3()),
+                rotationY: root.rotation.y,
+                elevationScale: merged.elevationScale,
+                elevationBias: merged.elevationBias,
+            });
+        }
+    });
+    // Anisotropy is capped by the device, not by the panel, and re-uploading the
+    // arrays is not free — so it is applied only when the value actually changes,
+    // whether that came from a commit or from a live drag.
+    const appliedAnisotropy = useRef(NaN);
+    const applyAnisotropy = useCallback((requested) => {
+        const value = Math.min(requested, gl.capabilities.getMaxAnisotropy());
+        if (appliedAnisotropy.current === value)
+            return;
+        appliedAnisotropy.current = value;
+        if (maps.diffuse) {
+            maps.diffuse.anisotropy = value;
+            maps.diffuse.needsUpdate = true;
+        }
+        if (maps.normal) {
+            maps.normal.anisotropy = value;
+            maps.normal.needsUpdate = true;
+        }
+    }, [gl, maps.diffuse, maps.normal]);
+    useEffect(() => {
+        appliedAnisotropy.current = NaN;
+        applyAnisotropy(quality.anisotropy);
+    }, [applyAnisotropy, quality.anisotropy]);
+    // The group is ALWAYS rendered, even before the maps have loaded and even when
+    // the config is incomplete — only the chunks inside it are gated. TerrainSurface
+    // does the same, and this is why: the root is what carries `userData.id`, so it
+    // is what findById() resolves, and a controller that opens before the ground
+    // exists has to find something to write into. Returning null here is what broke
+    // live editing.
+    const ready = !!geometry && maps.ready;
+    return (_jsx("group", { ref: attachRoot, position: applyTransform ? config.origin : undefined, rotation: applyTransform ? [0, THREE.MathUtils.degToRad(config.rotationY), 0] : undefined, children: ready && geometry.chunks.map((chunk, i) => (_jsx("mesh", { ref: (m) => { meshRefs.current[i] = m; }, geometry: chunk.geometry, material: material, castShadow: quality.castShadows, receiveShadow: quality.receiveShadows, customDepthMaterial: depthMaterial, customDistanceMaterial: distanceMaterial }, i))) }));
+};
+/** Config with the live controller's overrides on top. Cheap enough to build per
+ *  frame — it is at most eight small objects — and only rebuilt when something
+ *  actually wrote. */
+function mergeLive(config, live, liveSurfaces, liveAutoSplat) {
+    const keys = Object.keys(liveSurfaces);
+    const surfaces = keys.length === 0
+        ? config.surfaces
+        : config.surfaces.map((surface, index) => {
+            let next = null;
+            for (const key of keys) {
+                const [i, field] = key.split(':');
+                if (Number(i) !== index)
+                    continue;
+                next = next ?? { ...surface };
+                next[field] = liveSurfaces[key];
+            }
+            return next ?? surface;
+        });
+    const autoSplat = Object.keys(liveAutoSplat).length === 0
+        ? config.autoSplat
+        : { ...config.autoSplat, ...liveAutoSplat };
+    return { ...config, ...live, surfaces, autoSplat };
+}
+export default LandscapeMesh;

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

@@ -0,0 +1,3 @@
+export { default as LandscapeMesh } from './LandscapeMesh';
+export type { LandscapeLayerProps } from './types';
+//# sourceMappingURL=index.d.ts.map