@3driseai/3drise-viewer 0.1.7 → 0.1.9

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

@@ -1 +1 @@
-{"version":3,"file":"Clouds.d.ts","sourceRoot":"","sources":["../../src/components/Clouds.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAQ7D,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,MAAM,WAAW,WAAY,SAAQ,gBAAgB;IACjD,QAAQ,EAAE,qBAAqB,CAAC;IAChC,YAAY,CAAC,EAAE,YAAY,CAAC;CAC/B;AAmFD,QAAA,MAAM,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CAsLjC,CAAC;AACF,eAAe,MAAM,CAAC"}
+{"version":3,"file":"Clouds.d.ts","sourceRoot":"","sources":["../../src/components/Clouds.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAQ7D,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,MAAM,WAAW,WAAY,SAAQ,gBAAgB;IACjD,QAAQ,EAAE,qBAAqB,CAAC;IAChC,YAAY,CAAC,EAAE,YAAY,CAAC;CAC/B;AAmFD,QAAA,MAAM,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CAqLjC,CAAC;AACF,eAAe,MAAM,CAAC"}

package/dist/components/Clouds.js

@@ -185,7 +185,6 @@ const Clouds = ({ settings, timeSettings = defaultTimeSettings, onObjectReady, o
             return;
         const now = Date.now();
         const pointer = state.pointer;
-        // ── PER-DOMAIN ANIMATIONS ────────────────────────────────────────────────
         const mouseMove = settings.mouseMove;
         // const isPerDomain = mm && ('transform' in mm || 'material' in mm || 'edges' in mm || 'light' in mm || 'clouds' in mm);
         // transform: position / rotation / scale

package/dist/components/CloudsGenerator.d.ts

@@ -0,0 +1,32 @@
+import React from 'react';
+import type { SkySettings, TimeSettings } from '@3driseai/3drise-core';
+import type { ObjectReadyProps } from '../types/objectReady';
+import type { VolumetricCloudsSettings } from '../types/cloudConfigs';
+export interface CloudsGeneratorProps extends ObjectReadyProps {
+    /** Accepts a partial or older-shaped blob: a published scene loads whatever was
+     *  saved the day it was authored, and every block is merged over its defaults. */
+    settings?: Partial<VolumetricCloudsSettings> | null;
+    skySettings?: SkySettings;
+    timeSettings?: TimeSettings;
+    /** Matches SkySystem's sunIntensity, so clouds brighten with the rest of the scene. */
+    sunIntensity?: number;
+}
+/**
+ * Picks the cloud model for the scene's sky.
+ *
+ * A sky is a deck plus an optional ice layer, not one of four things — cirrus
+ * coexists with every other type in nature and in the renderer. So the deck's type
+ * selects the component, and cirrus rides along with whichever one is chosen. With
+ * the deck off, the cirrus-only branch runs a three-sample ice pass and skips the
+ * volumetric march entirely.
+ *
+ * Whichever branch is taken mounts exactly one render pass, which is the constraint
+ * that matters: the pass owns the render loop.
+ *
+ * Each block is memoised against its own source object, not against `settings`, so
+ * editing cirrus does not hand the deck a new config and restart its temporal
+ * accumulation.
+ */
+declare const CloudsGenerator: React.FC<CloudsGeneratorProps>;
+export default CloudsGenerator;
+//# sourceMappingURL=CloudsGenerator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CloudsGenerator.d.ts","sourceRoot":"","sources":["../../src/components/CloudsGenerator.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,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAOtE,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC1D;sFACkF;IAClF,QAAQ,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,GAAG,IAAI,CAAC;IACpD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,uFAAuF;IACvF,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;GAeG;AACH,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CA4CnD,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/components/CloudsGenerator.js

@@ -0,0 +1,58 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useMemo } from 'react';
+import { CLOUD_DECK_DEFAULTS, normalizeCirrus, normalizeCloudDeck, normalizeCloudQuality } from '../types/cloudConfigs.js';
+import Cumulus from './volumetricClouds/Cumulus.js';
+import Stratocumulus from './volumetricClouds/Stratocumulus.js';
+import Cumulonimbus from './volumetricClouds/Cumulonimbus.js';
+import Cirrus from './volumetricClouds/Cirrus.js';
+/**
+ * Picks the cloud model for the scene's sky.
+ *
+ * A sky is a deck plus an optional ice layer, not one of four things — cirrus
+ * coexists with every other type in nature and in the renderer. So the deck's type
+ * selects the component, and cirrus rides along with whichever one is chosen. With
+ * the deck off, the cirrus-only branch runs a three-sample ice pass and skips the
+ * volumetric march entirely.
+ *
+ * Whichever branch is taken mounts exactly one render pass, which is the constraint
+ * that matters: the pass owns the render loop.
+ *
+ * Each block is memoised against its own source object, not against `settings`, so
+ * editing cirrus does not hand the deck a new config and restart its temporal
+ * accumulation.
+ */
+const CloudsGenerator = ({ settings, skySettings, timeSettings, sunIntensity, onObjectReady, onObjectDispose, }) => {
+    const deck = useMemo(() => normalizeCloudDeck(settings?.config), [settings?.config]);
+    const cirrus = useMemo(() => normalizeCirrus(settings?.cirrus), [settings?.cirrus]);
+    const quality = useMemo(() => normalizeCloudQuality(settings?.quality), [settings?.quality]);
+    const deckOn = !!deck?.enabled;
+    const cirrusOn = !!cirrus?.enabled;
+    // The cirrus-only branch ignores the deck entirely (it passes deck={null} to the
+    // pass), but the shared prop shape still wants a real config rather than a
+    // non-null assertion over something that is genuinely absent.
+    const deckOrDefault = deck ?? { ...CLOUD_DECK_DEFAULTS.stratocumulus, enabled: false };
+    if (!deckOn && !cirrusOn)
+        return null;
+    const shared = {
+        deck: deckOrDefault,
+        cirrus: cirrusOn ? cirrus : null,
+        quality,
+        skySettings,
+        timeSettings,
+        sunIntensity,
+        animations: settings?.animations,
+        mouseMove: settings?.mouseMove,
+        id: settings?.id,
+        onObjectReady,
+        onObjectDispose,
+    };
+    if (!deckOn)
+        return _jsx(Cirrus, { ...shared });
+    switch (deckOrDefault.deckType) {
+        case 'cumulus': return _jsx(Cumulus, { ...shared });
+        case 'cumulonimbus': return _jsx(Cumulonimbus, { ...shared });
+        case 'stratocumulus':
+        default: return _jsx(Stratocumulus, { ...shared });
+    }
+};
+export default CloudsGenerator;

package/dist/components/EnvironmentManager.d.ts

@@ -1,9 +1,51 @@
-import { type SkySystemProps } from './SkySystem';
-import type { EnvironmentConfig } from '@3driseai/3drise-core';
-export interface EnvironmentManagerProps extends SkySystemProps {
-    environment?: EnvironmentConfig;
+import React from 'react';
+import { Vector3 } from 'three';
+import { type SkySystemRef, type SkySystemProps } from './SkySystem';
+import type { EnvironmentConfig, FogSettings, HdrSettings, SkySettings, TimeSettings } from '@3driseai/3drise-core';
+import type { VolumetricCloudsSettings } from '../types/cloudConfigs';
+import type { ProceduralTerrainSettings } from '../types/terrainConfigs';
+import type { ObjectReadyProps } from '../types/objectReady';
+/**
+ * The whole environment in one component: HDR background, image-based lighting,
+ * sky, sun, fog, clouds and terrain.
+ *
+ * This is the *composed* entry point, for SceneBuilder and for anyone embedding a
+ * published scene, where the settings arrive as one saved blob and nothing
+ * re-renders unless the project changes.
+ *
+ * A host with fine-grained reactive state — the editor — should compose the same
+ * pieces itself, one store subscription per slice, so a fog change cannot
+ * re-render the sun. Every piece here is exported for exactly that:
+ * HdrEnvironment, useEnvironmentProbe, SkySystem, SceneFog, CloudsGenerator,
+ * TerrainBuilder. Both paths run the same components; only the subscription
+ * granularity differs, and that is the only thing that should ever differ.
+ */
+/** core's EnvironmentConfig still types `clouds` as the retired CloudsSettings.
+ *  Narrowed here rather than in core, which cannot reference the viewer's cloud
+ *  types — they live next to the shader that consumes them. */
+export type ViewerEnvironmentConfig = Omit<EnvironmentConfig, 'clouds'> & {
+    clouds?: VolumetricCloudsSettings;
+    /** core's EnvironmentConfig has no terrain field at all, and its
+     *  `TerrainSettings` is the retired flat shape. Declared here for the same
+     *  reason `clouds` is narrowed here: the config type lives next to the shader
+     *  that consumes it, and core cannot reference the viewer. */
+    terrain?: ProceduralTerrainSettings;
+};
+export interface EnvironmentManagerProps extends ObjectReadyProps {
+    timeSettings: TimeSettings;
+    /** Saved-project shape. Any discrete prop below overrides the matching field. */
+    environment?: ViewerEnvironmentConfig;
+    hdrSettings?: HdrSettings;
+    skySettings?: SkySettings;
+    cloudsSettings?: VolumetricCloudsSettings;
+    terrainSettings?: ProceduralTerrainSettings;
+    fogSettings?: FogSettings;
     cubeCameraResolution?: number;
+    skyboxScale?: number;
+    playerPosition?: Vector3;
+    onTimeOfDayChange?: SkySystemProps['onTimeOfDayChange'];
+    onTimeUpdate?: SkySystemProps['onTimeUpdate'];
 }
-declare const EnvironmentManager: any;
+declare const EnvironmentManager: React.ForwardRefExoticComponent<EnvironmentManagerProps & React.RefAttributes<SkySystemRef>>;
 export default EnvironmentManager;
 //# sourceMappingURL=EnvironmentManager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"EnvironmentManager.d.ts","sourceRoot":"","sources":["../../src/components/EnvironmentManager.tsx"],"names":[],"mappings":"AAIA,OAAkB,EAAqB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAIhF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,MAAM,WAAW,uBAAwB,SAAQ,cAAc;IAC3D,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,QAAA,MAAM,kBAAkB,EA8DlB,GAAI,CAAC;AAEX,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"EnvironmentManager.d.ts","sourceRoot":"","sources":["../../src/components/EnvironmentManager.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqB,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAkB,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAGhF,OAAO,KAAK,EACR,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,EACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAEzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D;;;;;;;;;;;;;;GAcG;AAEH;;+DAE+D;AAC/D,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC,GAAG;IACtE,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAClC;;;kEAG8D;IAC9D,OAAO,CAAC,EAAE,yBAAyB,CAAC;CACvC,CAAC;AAEF,MAAM,WAAW,uBAAwB,SAAQ,gBAAgB;IAC7D,YAAY,EAAE,YAAY,CAAC;IAC3B,iFAAiF;IACjF,WAAW,CAAC,EAAE,uBAAuB,CAAC;IACtC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,cAAc,CAAC,EAAE,wBAAwB,CAAC;IAC1C,eAAe,CAAC,EAAE,yBAAyB,CAAC;IAC5C,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iBAAiB,CAAC,EAAE,cAAc,CAAC,mBAAmB,CAAC,CAAC;IACxD,YAAY,CAAC,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC;CACjD;AAoBD,QAAA,MAAM,kBAAkB,8FAwEtB,CAAC;AAGH,eAAe,kBAAkB,CAAC"}

package/dist/components/EnvironmentManager.js

@@ -1,74 +1,43 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
-import { useMemo, forwardRef } from 'react';
-import { Environment } from '@react-three/drei';
-import { useThree } from '@react-three/fiber';
+import { forwardRef } from 'react';
 import { Vector3 } from 'three';
 import SkySystem from './SkySystem.js';
-import { useCubeCamera } from '../hooks/useCubeCamera.js';
-import HdrPlaylistRenderer from './HdrPlaylistRenderer.js';
-import { getTransitionSettings } from '@3driseai/3drise-core';
-const EnvironmentManager = forwardRef(({ environment, cubeCameraResolution = 512, timeSettings, onTimeOfDayChange, onTimeUpdate, onObjectReady, onObjectDispose, }, ref) => {
-    const { scene } = useThree();
-    const defaultHdr = {
-        visible: false,
-        name: null,
-        settings: {
-            groundRadius: 200,
-            groundHeight: 10,
-            groundScale: 100,
-            blur: 0,
-            backgroundBlurriness: 0,
-            backgroundIntensity: 1,
-            backgroundRotation: 0,
-            environmentIntensity: 1,
-            environmentRotation: 0,
-        },
-    };
-    const hdr = environment?.hdr ?? defaultHdr;
-    const backgroundName = hdr.visible ? hdr.name : null;
-    const urls = hdr.urls;
-    const playlistActive = !!urls && urls.length > 1;
-    const singleUrl = urls && urls.length === 1 ? urls[0] : undefined;
-    const hdrActive = !!(backgroundName || singleUrl || playlistActive);
-    const sky = environment?.sky;
-    const sunSystemVisible = sky?.sunSystem?.visible;
-    const sunSize = sky?.sunSystem?.sunSize;
-    const moonSize = sky?.sunSystem?.moonSize;
-    const skyboxScale = 100000;
-    const sunIntensity = sky?.sunSystem?.intensity;
-    const castShadow = sky?.sunSystem?.castShadow;
-    const shadowMapSize = sky?.sunSystem?.shadowMapSize;
-    const playerPosition = new Vector3(0, 0, 0);
-    const starsSettings = environment?.stars;
-    const cloudsSettings = environment?.clouds;
-    const cloudsMaterialSettings = environment?.clouds?.materialSettings;
-    const skyControllerSettings = sky && !sky.sunSystem.visible ? sky : undefined;
-    const rainSettings = environment?.rain;
-    const fogSettings = environment?.fog;
-    useCubeCamera({
-        hdrSettings: hdr,
-        skyVisible: true,
-        sunSystemVisible: sunSystemVisible ?? false,
-        timeSettings,
+import HdrEnvironment, { isHdrActive } from './HdrEnvironment.js';
+import { useEnvironmentProbe } from '../hooks/useEnvironmentProbe.js';
+import TerrainBuilder from './TerrainBuilder.js';
+const DEFAULT_HDR = {
+    visible: false,
+    name: null,
+    settings: {
+        groundRadius: 200,
+        groundHeight: 10,
+        groundScale: 100,
+        blur: 0,
+        backgroundBlurriness: 0,
+        backgroundIntensity: 1,
+        backgroundRotation: 0,
+        environmentIntensity: 1,
+        environmentRotation: 0,
+    },
+};
+const ORIGIN = new Vector3(0, 0, 0);
+const EnvironmentManager = forwardRef(({ timeSettings, environment, hdrSettings, skySettings, cloudsSettings, terrainSettings, fogSettings, cubeCameraResolution = 512, skyboxScale = 100000, playerPosition = ORIGIN, onTimeOfDayChange, onTimeUpdate, onObjectReady, onObjectDispose, }, ref) => {
+    const hdr = hdrSettings ?? environment?.hdr ?? DEFAULT_HDR;
+    const sky = skySettings ?? environment?.sky;
+    const clouds = cloudsSettings ?? environment?.clouds;
+    const terrain = terrainSettings ?? environment?.terrain;
+    const fog = fogSettings ?? environment?.fog;
+    const sunSystemVisible = !!sky?.sunSystem?.visible;
+    // Previously hardcoded true, which kept a cube camera alive — and re-captured
+    // its six faces — for scenes that have no sky at all.
+    const skyActive = !!sky?.visible || sunSystemVisible;
+    useEnvironmentProbe({
+        hdrActive: isHdrActive(hdr),
+        skyActive,
+        autoAnimate: !!timeSettings.autoAnimate,
         resolution: cubeCameraResolution,
     });
-    // While the playlist is active, drei <Environment> unmounts; HdrPlaylistRenderer
-    // owns scene.environment + scene.background for the duration of the transitions.
-    const environmentComponent = useMemo(() => {
-        if (playlistActive)
-            return null;
-        if (!singleUrl && !backgroundName)
-            return null;
-        const sourceProps = singleUrl
-            ? { files: singleUrl }
-            : { preset: backgroundName };
-        return (_jsx(Environment, { ...sourceProps, background: true, scene: scene, backgroundBlurriness: hdr.settings.backgroundBlurriness ?? 0, backgroundIntensity: hdr.settings.backgroundIntensity ?? 1, backgroundRotation: [0, hdr.settings.backgroundRotation ?? Math.PI / 2, 0], environmentIntensity: hdr.settings.environmentIntensity ?? 1, environmentRotation: [0, hdr.settings.environmentRotation ?? Math.PI / 2, 0], blur: hdr.settings.blur ?? 0, ground: {
-                radius: hdr.settings.groundRadius,
-                height: hdr.settings.groundHeight,
-                scale: hdr.settings.groundScale,
-            } }));
-    }, [playlistActive, singleUrl, backgroundName, hdr.settings, scene]);
-    return (_jsxs(_Fragment, { children: [environmentComponent, playlistActive && urls && (_jsx(HdrPlaylistRenderer, { urls: urls, transition: getTransitionSettings(hdr), onObjectReady: onObjectReady, onObjectDispose: onObjectDispose })), _jsx(SkySystem, { ref: ref, timeSettings: timeSettings, visible: true, sunSystemVisible: sunSystemVisible, sunSize: sunSize, moonSize: moonSize, skyboxScale: skyboxScale, sunIntensity: sunIntensity, castShadow: castShadow, shadowMapSize: shadowMapSize, playerPosition: playerPosition, starsSettings: starsSettings, cloudsSettings: cloudsSettings, cloudsMaterialSettings: cloudsMaterialSettings, skyControllerSettings: skyControllerSettings, rainSettings: rainSettings, fogSettings: fogSettings, onTimeOfDayChange: onTimeOfDayChange, onTimeUpdate: onTimeUpdate, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose })] }));
+    return (_jsxs(_Fragment, { children: [_jsx(HdrEnvironment, { hdr: hdr, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }), _jsx(TerrainBuilder, { settings: terrain, skySettings: sky, timeSettings: timeSettings, sunIntensity: sky?.sunSystem?.intensity ?? 1, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }), _jsx(SkySystem, { ref: ref, timeSettings: timeSettings, visible: true, sunSystemVisible: sunSystemVisible, sunSize: sky?.sunSystem?.sunSize, moonSize: sky?.sunSystem?.moonSize, skyboxScale: skyboxScale, sunIntensity: sky?.sunSystem?.intensity ?? 1, castShadow: sky?.sunSystem?.castShadow, shadowMapSize: sky?.sunSystem?.shadowMapSize, playerPosition: playerPosition, cloudsSettings: clouds, skyControllerSettings: sky, fogSettings: fog, onTimeOfDayChange: onTimeOfDayChange, onTimeUpdate: onTimeUpdate, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose })] }));
 });
 EnvironmentManager.displayName = 'EnvironmentManager';
 export default EnvironmentManager;

package/dist/components/HdrEnvironment.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+import type { HdrSettings } from '@3driseai/3drise-core';
+import type { ObjectReadyProps } from '../types/objectReady';
+/**
+ * The HDR background and the image-based lighting that comes with it.
+ *
+ * Split out of EnvironmentManager so the editor's HDR connector and a published
+ * scene render the identical thing from the identical settings object. One
+ * `<Environment>`, one set of prop defaults, one place to change them.
+ */
+/** A background is active when something is actually going to be drawn: a named
+ *  drei preset, a single URL, or a playlist. `visible` alone is not enough — it
+ *  can be true with nothing selected. */
+export declare function isHdrActive(hdr: HdrSettings): boolean;
+export interface HdrEnvironmentProps extends ObjectReadyProps {
+    hdr: HdrSettings;
+}
+declare const HdrEnvironment: React.FC<HdrEnvironmentProps>;
+export default HdrEnvironment;
+//# sourceMappingURL=HdrEnvironment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HdrEnvironment.d.ts","sourceRoot":"","sources":["../../src/components/HdrEnvironment.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AAIvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D;;;;;;GAMG;AAEH;;yCAEyC;AACzC,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAIrD;AAED,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IACzD,GAAG,EAAE,WAAW,CAAC;CACpB;AAED,QAAA,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAgDjD,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/components/HdrEnvironment.js

@@ -0,0 +1,44 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useMemo } from 'react';
+import { Environment } from '@react-three/drei';
+import { useThree } from '@react-three/fiber';
+import { getTransitionSettings } from '@3driseai/3drise-core';
+import HdrPlaylistRenderer from './HdrPlaylistRenderer.js';
+/**
+ * The HDR background and the image-based lighting that comes with it.
+ *
+ * Split out of EnvironmentManager so the editor's HDR connector and a published
+ * scene render the identical thing from the identical settings object. One
+ * `<Environment>`, one set of prop defaults, one place to change them.
+ */
+/** A background is active when something is actually going to be drawn: a named
+ *  drei preset, a single URL, or a playlist. `visible` alone is not enough — it
+ *  can be true with nothing selected. */
+export function isHdrActive(hdr) {
+    const name = hdr.visible ? hdr.name : null;
+    const urls = hdr.urls;
+    return !!(name || (urls && urls.length >= 1));
+}
+const HdrEnvironment = ({ hdr, onObjectReady, onObjectDispose }) => {
+    const { scene } = useThree();
+    const backgroundName = hdr.visible ? hdr.name : null;
+    const urls = hdr.urls;
+    const playlistActive = !!urls && urls.length > 1;
+    const singleUrl = urls && urls.length === 1 ? urls[0] : undefined;
+    const active = !!(backgroundName || singleUrl || playlistActive);
+    // While the playlist runs, drei's <Environment> unmounts: HdrPlaylistRenderer
+    // owns scene.environment and scene.background for the duration of the
+    // transitions, and two owners means one of them loses.
+    const environmentComponent = useMemo(() => {
+        if (playlistActive || !active)
+            return null;
+        const sourceProps = singleUrl ? { files: singleUrl } : { preset: backgroundName };
+        return (_jsx(Environment, { ...sourceProps, background: true, scene: scene, backgroundBlurriness: hdr.settings.backgroundBlurriness ?? 0, backgroundIntensity: hdr.settings.backgroundIntensity ?? 1, backgroundRotation: [0, hdr.settings.backgroundRotation ?? Math.PI / 2, 0], environmentIntensity: hdr.settings.environmentIntensity ?? 1, environmentRotation: [0, hdr.settings.environmentRotation ?? Math.PI / 2, 0], blur: hdr.settings.blur ?? 0, ground: {
+                radius: hdr.settings.groundRadius,
+                height: hdr.settings.groundHeight,
+                scale: hdr.settings.groundScale,
+            } }));
+    }, [playlistActive, active, singleUrl, backgroundName, hdr.settings, scene]);
+    return (_jsxs(_Fragment, { children: [environmentComponent, playlistActive && urls && (_jsx(HdrPlaylistRenderer, { urls: urls, transition: getTransitionSettings(hdr), onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }))] }));
+};
+export default HdrEnvironment;

package/dist/components/LandscapeBuilder.d.ts

@@ -0,0 +1,23 @@
+import React from 'react';
+import type { ObjectReadyProps } from '../types/objectReady';
+import type { LandscapeSettings } from '../types/landscapeConfigs';
+export interface LandscapeBuilderProps extends ObjectReadyProps {
+    /** Accepts a partial or older-shaped blob. A blob with no `heightMap`
+     *  normalises to nothing — a landscape without one is not a landscape, and
+     *  inventing a default would put ground in a scene that never had any. */
+    settings?: Partial<LandscapeSettings> | null;
+}
+/**
+ * The world ground.
+ *
+ * The counterpart to `TerrainBuilder` and deliberately independent of it: a
+ * scene may have procedural terrain, an authored landscape, both or neither.
+ * They are different objects with different config and nothing shared, which is
+ * why there is no `groundType` switch anywhere.
+ *
+ * Each block is normalised against its own source, so editing quality cannot
+ * invalidate the config and re-run RTIN.
+ */
+declare const LandscapeBuilder: React.FC<LandscapeBuilderProps>;
+export default LandscapeBuilder;
+//# sourceMappingURL=LandscapeBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LandscapeBuilder.d.ts","sourceRoot":"","sources":["../../src/components/LandscapeBuilder.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAIlE,MAAM,WAAW,qBAAsB,SAAQ,gBAAgB;IAC3D;;8EAE0E;IAC1E,QAAQ,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAA;CAC/C;AAED;;;;;;;;;;GAUG;AACH,QAAA,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAqBrD,CAAA;AAED,eAAe,gBAAgB,CAAA"}

package/dist/components/LandscapeBuilder.js

@@ -0,0 +1,25 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useMemo } from 'react';
+import { normalizeLandscape, normalizeLandscapeQuality } from '../types/landscapeConfigs.js';
+import LandscapeMesh from './landscape/LandscapeMesh.js';
+/**
+ * The world ground.
+ *
+ * The counterpart to `TerrainBuilder` and deliberately independent of it: a
+ * scene may have procedural terrain, an authored landscape, both or neither.
+ * They are different objects with different config and nothing shared, which is
+ * why there is no `groundType` switch anywhere.
+ *
+ * Each block is normalised against its own source, so editing quality cannot
+ * invalidate the config and re-run RTIN.
+ */
+const LandscapeBuilder = ({ settings, onObjectReady, onObjectDispose, }) => {
+    const config = useMemo(() => normalizeLandscape(settings?.config), [settings?.config]);
+    const quality = useMemo(() => normalizeLandscapeQuality(settings?.quality), [settings?.quality]);
+    if (!config?.enabled)
+        return null;
+    if (!config.heightMap || config.surfaces.length === 0)
+        return null;
+    return (_jsx(LandscapeMesh, { id: settings?.id ?? '3drise-landscape', config: config, quality: quality, applyTransform: true, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }));
+};
+export default LandscapeBuilder;

package/dist/components/LandscapeObject.d.ts

@@ -0,0 +1,24 @@
+import React from 'react';
+import type { ObjectReadyProps } from '../types/objectReady';
+import type { LandscapeSettings } from '../types/landscapeConfigs';
+export interface LandscapeObjectProps extends ObjectReadyProps {
+    settings: Partial<LandscapeSettings> & {
+        id?: string;
+    };
+}
+/**
+ * A placed landscape — a floating island, a diorama, a game tile, a table-top
+ * relief.
+ *
+ * Mounted through `ObjectNode`'s renderers map, so it is an ordinary
+ * `CreatedObject` and gets the transform gizmo, keyframe animation, mouse-move
+ * interactions, parenting and click actions with no work here. That is the whole
+ * argument for it being an object rather than a second environment entry.
+ *
+ * `applyTransform` is false: the wrapper owns position, rotation and scale, and
+ * the config's own `origin` / `rotationY` are ground-host fields that would
+ * fight it.
+ */
+declare const LandscapeObject: React.FC<LandscapeObjectProps>;
+export default LandscapeObject;
+//# sourceMappingURL=LandscapeObject.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LandscapeObject.d.ts","sourceRoot":"","sources":["../../src/components/LandscapeObject.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAIlE,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC1D,QAAQ,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACzD;AAED;;;;;;;;;;;;GAYG;AACH,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAqBnD,CAAA;AAED,eAAe,eAAe,CAAA"}

package/dist/components/LandscapeObject.js

@@ -0,0 +1,27 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useMemo } from 'react';
+import { normalizeLandscape, normalizeLandscapeQuality } from '../types/landscapeConfigs.js';
+import LandscapeMesh from './landscape/LandscapeMesh.js';
+/**
+ * A placed landscape — a floating island, a diorama, a game tile, a table-top
+ * relief.
+ *
+ * Mounted through `ObjectNode`'s renderers map, so it is an ordinary
+ * `CreatedObject` and gets the transform gizmo, keyframe animation, mouse-move
+ * interactions, parenting and click actions with no work here. That is the whole
+ * argument for it being an object rather than a second environment entry.
+ *
+ * `applyTransform` is false: the wrapper owns position, rotation and scale, and
+ * the config's own `origin` / `rotationY` are ground-host fields that would
+ * fight it.
+ */
+const LandscapeObject = ({ settings, onObjectReady, onObjectDispose, }) => {
+    const config = useMemo(() => normalizeLandscape(settings?.config), [settings?.config]);
+    const quality = useMemo(() => normalizeLandscapeQuality(settings?.quality), [settings?.quality]);
+    if (!config?.enabled)
+        return null;
+    if (!config.heightMap || config.surfaces.length === 0)
+        return null;
+    return (_jsx(LandscapeMesh, { id: settings.id ?? 'landscape-object', config: config, quality: quality, applyTransform: false, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }));
+};
+export default LandscapeObject;

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

@@ -1 +1 @@
-{"version":3,"file":"ObjectNode.d.ts","sourceRoot":"","sources":["../../src/components/ObjectNode.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,KAAK,EAAe,qBAAqB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAChG,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,KAAK,eAAe,GAAG,gBAAgB,GAAG;IACtC,IAAI,EAAE,cAAc,CAAC;IACrB,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;CAC7G,CAAC;AAgBF,QAAA,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAyGzC,CAAC;AACF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"ObjectNode.d.ts","sourceRoot":"","sources":["../../src/components/ObjectNode.tsx"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,KAAK,EAAe,qBAAqB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAChG,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,KAAK,eAAe,GAAG,gBAAgB,GAAG;IACtC,IAAI,EAAE,cAAc,CAAC;IACrB,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;CAC7G,CAAC;AAgBF,QAAA,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAmHzC,CAAC;AACF,eAAe,UAAU,CAAC"}

package/dist/components/ObjectNode.js

@@ -13,6 +13,8 @@ import LightObject from "./LightObject.js";
 import EnvironmentObject from "./EnvironmentObject.js";
 import Galaxy from "./Galaxy.js";
 import GridGenerator from "./GridsGenerator.js";
+import OceanBuilder from "./OceanBuilder.js";
+import LandscapeObject from "./LandscapeObject.js";
 import { SELF_MANAGED_MATERIAL } from "../constants.js";
 // const EffectsLayer: React.FC<{ effects: CreatedObjectSettings['effects'] }> = ({ effects }) =>
 //     effects?.length ? (
@@ -77,6 +79,14 @@ const ObjectNode = ({ node, onObjectReady, onObjectDispose, handleObjectClick })
         grid: (obj, onObjectReady) => (
         // <GridHelper {...(obj.config as GridConfig)} side={2} />
         _jsx(GridGenerator, { config: obj.config, ...relabel(obj) })),
+        // A placed body of water — the object host. The world ocean is mounted by
+        // the environment instead, so this branch only ever sees a pool, a pond or
+        // a canal; OceanBuilder decides which from config.host either way.
+        ocean: (obj, onObjectReady) => (_jsx(OceanBuilder, { settings: obj, ...relabel(obj) }, obj.id)),
+        // A placed landscape — the object host. The world ground is mounted by
+        // LandscapeConnector instead; this one is a diorama, a floating island or
+        // a game tile, and gets its transform from the CreatedObject wrapper.
+        landscape: (obj, onObjectReady) => (_jsx(LandscapeObject, { settings: obj, ...relabel(obj) }, obj.id)),
         effect: (obj) => (_jsx(EffectsGenerator, { settings: {
                 config: obj.config,
             }, ...relabel(obj) }, obj.id)),

package/dist/components/OceanBuilder.d.ts

@@ -0,0 +1,35 @@
+import React from 'react';
+import type { SkySettings, TimeSettings } from '@3driseai/3drise-core';
+import type { ObjectReadyProps } from '../types/objectReady';
+import type { OceanWaterSettings } from '../types/oceanConfigs';
+export interface OceanBuilderProps extends ObjectReadyProps {
+    /** Accepts a partial or older-shaped blob — including core's retired
+     *  `OceanSettings`, the flat plane with a water material picked out of the
+     *  registry. That one is MAPPED rather than dropped: see below. */
+    settings?: Partial<OceanWaterSettings> | null;
+    skySettings?: SkySettings;
+    timeSettings?: TimeSettings;
+    /** Matches SkySystem's sunIntensity, so water brightens with the scene. */
+    sunIntensity?: number;
+}
+/**
+ * Picks the water body for the scene.
+ *
+ * The counterpart to `CloudsGenerator` and `TerrainBuilder`, 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.
+ *
+ * ## One place it differs from the terrain, on purpose
+ *
+ * `normalizeTerrain` returns null for a blob in the retired shape, because a
+ * project saved before terrain existed never had ground and defaulting one in
+ * would give it a landscape it was never authored with. The ocean is the
+ * opposite case: the old ocean is a visible plane with a water material, so a
+ * project saved before this system very possibly HAD water, and returning null
+ * would delete it. A legacy blob is therefore mapped — its material variant onto
+ * the nearest type, its plane size onto the host, its Y onto the sea level. See
+ * `normalizeOcean`.
+ */
+declare const OceanBuilder: React.FC<OceanBuilderProps>;
+export default OceanBuilder;
+//# sourceMappingURL=OceanBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OceanBuilder.d.ts","sourceRoot":"","sources":["../../src/components/OceanBuilder.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,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAOhE,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACvD;;uEAEmE;IACnE,QAAQ,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC;IAC9C,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,QAAA,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAmC7C,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/components/OceanBuilder.js

@@ -0,0 +1,53 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useMemo } from 'react';
+import { normalizeOcean, normalizeOceanQuality } from '../types/oceanConfigs.js';
+import Sea from './water/Sea.js';
+import Lake from './water/Lake.js';
+import Storm from './water/Storm.js';
+import Shore from './water/Shore.js';
+/**
+ * Picks the water body for the scene.
+ *
+ * The counterpart to `CloudsGenerator` and `TerrainBuilder`, 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.
+ *
+ * ## One place it differs from the terrain, on purpose
+ *
+ * `normalizeTerrain` returns null for a blob in the retired shape, because a
+ * project saved before terrain existed never had ground and defaulting one in
+ * would give it a landscape it was never authored with. The ocean is the
+ * opposite case: the old ocean is a visible plane with a water material, so a
+ * project saved before this system very possibly HAD water, and returning null
+ * would delete it. A legacy blob is therefore mapped — its material variant onto
+ * the nearest type, its plane size onto the host, its Y onto the sea level. See
+ * `normalizeOcean`.
+ */
+const OceanBuilder = ({ settings, skySettings, timeSettings, sunIntensity, onObjectReady, onObjectDispose, }) => {
+    // Each block against its own source. Merging them through one object would
+    // hand the renderer a new config every time a quality slider moved, which
+    // rebuilds every clipmap ring.
+    const config = useMemo(() => normalizeOcean(settings?.config, settings), [settings]);
+    const quality = useMemo(() => normalizeOceanQuality(settings?.quality), [settings?.quality]);
+    if (!config?.enabled)
+        return null;
+    const shared = {
+        config,
+        quality,
+        skySettings,
+        timeSettings,
+        sunIntensity,
+        id: settings?.id,
+        meshSettings: settings?.meshSettings,
+        onObjectReady,
+        onObjectDispose,
+    };
+    switch (config.waterType) {
+        case 'lake': return _jsx(Lake, { ...shared });
+        case 'storm': return _jsx(Storm, { ...shared });
+        case 'shore': return _jsx(Shore, { ...shared });
+        case 'sea':
+        default: return _jsx(Sea, { ...shared });
+    }
+};
+export default OceanBuilder;

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

@@ -1 +1 @@
-{"version":3,"file":"SceneBuilder.d.ts","sourceRoot":"","sources":["../../src/components/SceneBuilder.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAQ/D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,QAAA,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,GAAG,gBAAgB,CA+HhE,CAAC;AACF,eAAe,YAAY,CAAC"}
+{"version":3,"file":"SceneBuilder.d.ts","sourceRoot":"","sources":["../../src/components/SceneBuilder.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAQ/D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,QAAA,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,GAAG,gBAAgB,CAmIhE,CAAC;AACF,eAAe,YAAY,CAAC"}