@3driseai/3drise-viewer 0.1.28 → 0.1.29

package/dist/components/ProjectLoader.d.ts

@@ -1,5 +1,5 @@
 import type { SceneHandle } from "../api/sceneHandle";
-import type { CreatedObjectSettings, HtmlElement } from '@3driseai/3drise-core';
+import type { CreatedObjectSettings } from '@3driseai/3drise-core';
 import React from "react";
 import { Object3D } from "three";
 import { type ThreeEvent } from "@react-three/fiber";
@@ -9,8 +9,10 @@ declare const ProjectLoader: React.ForwardRefExoticComponent<ObjectReadyProps &
     loadingIndicator?: React.ReactNode;
     onObjectClick?: (object: CreatedObjectSettings, ref: Object3D, event: ThreeEvent<MouseEvent>) => void;
     onObjectHover?: (object: CreatedObjectSettings, ref: Object3D) => void;
-    onElementClick?: (element: HtmlElement) => void;
-    onElementHover?: (element: HtmlElement | null) => void;
+    /** Render the project's UI layers over the scene (default true). `false` leaves the scene bare, for your own UI. */
+    ui?: boolean;
+    /** CSS appended to every UI layer after its own — restyle the generic rise-* classes or set --rise-* variables. */
+    uiStyles?: string;
     onSceneInitialized?: () => void;
     /**
      * Called once the project is loaded and its canvas exists, with the handle for

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

@@ -1 +1 @@
-{"version":3,"file":"ProjectLoader.d.ts","sourceRoot":"","sources":["../../src/components/ProjectLoader.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAItD,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGhF,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAkB7D,QAAA,MAAM,aAAa;eAhBJ,MAAM;uBACE,KAAK,CAAC,SAAS;oBAClB,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI;oBACrF,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,KAAK,IAAI;qBACrD,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI;qBAC9B,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI;yBACjC,MAAM,IAAI;IAC/B;;;;OAIG;mBACY,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI;qCA0D7C,CAAC;AAEH,eAAe,aAAa,CAAC"}
+{"version":3,"file":"ProjectLoader.d.ts","sourceRoot":"","sources":["../../src/components/ProjectLoader.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAItD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAInE,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAoB7D,QAAA,MAAM,aAAa;eAlBJ,MAAM;uBACE,KAAK,CAAC,SAAS;oBAClB,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI;oBACrF,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,KAAK,IAAI;IACtE,oHAAoH;SAC/G,OAAO;IACZ,mHAAmH;eACxG,MAAM;yBACI,MAAM,IAAI;IAC/B;;;;OAIG;mBACY,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI;qCA4D7C,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/dist/components/ProjectLoader.js

@@ -3,9 +3,10 @@ import { forwardRef, useEffect, useState } from "react";
 import { dataCenterServer } from '../constants.js';
 import SceneBuilder from "./SceneBuilder.js";
 import { loadAssets, } from "@3driseai/3drise-core";
+import { migrateObject } from '@3driseai/3drise-core';
 import LoadingIndicator from "./LoadingIndicator.js";
 import { useMeshController } from "../hooks/useMeshController.js";
-const ProjectLoader = forwardRef(({ projectId, onObjectClick, onObjectHover, onElementClick, onElementHover, onSceneInitialized, onSceneReady, onObjectReady, onObjectDispose, loadingIndicator = _jsx(LoadingIndicator, { text: "Loading project...", fullScreen: true, animate: true }) }, ref) => {
+const ProjectLoader = forwardRef(({ projectId, onObjectClick, onObjectHover, ui = true, uiStyles, onSceneInitialized, onSceneReady, onObjectReady, onObjectDispose, loadingIndicator = _jsx(LoadingIndicator, { text: "Loading project...", fullScreen: true, animate: true }) }, ref) => {
     const [project, setProject] = useState(null);
     const meshController = useMeshController();
     useEffect(() => {
@@ -30,7 +31,9 @@ const ProjectLoader = forwardRef(({ projectId, onObjectClick, onObjectHover, onE
                 throw new Error(`HTTP error! status: ${response.status}`);
             }
             const responseData = await response.json();
-            const sceneObjects = responseData.sceneObjects || [];
+            // Legacy space configs (the starfield's rotateSpeed) -> the space family's shape.
+            const sceneObjects = (responseData.sceneObjects || []).map(migrateObject);
+            responseData.sceneObjects = sceneObjects;
             const modelObjects = sceneObjects.filter(obj => obj.type === 'model');
             const meshObjects = sceneObjects.filter(obj => obj.type === 'mesh');
             try {
@@ -56,7 +59,7 @@ const ProjectLoader = forwardRef(({ projectId, onObjectClick, onObjectHover, onE
                 flexDirection: 'column', gap: '1rem'
             }, children: loadingIndicator });
     }
-    return _jsx(_Fragment, { children: _jsx(SceneBuilder, { ref: ref, project: project, onSceneReady: onSceneReady, onSceneInitialized: onSceneInitialized, onUiElementClick: onElementClick, onUiElementHover: onElementHover, onObjectClick: onObjectClick, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }) });
+    return _jsx(_Fragment, { children: _jsx(SceneBuilder, { ref: ref, project: project, onSceneReady: onSceneReady, loadingIndicator: loadingIndicator, onSceneInitialized: onSceneInitialized, ui: ui, uiStyles: uiStyles, onObjectClick: onObjectClick, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }) });
 });
 ProjectLoader.displayName = 'ProjectLoader';
 export default ProjectLoader;

package/dist/components/QuasiGrid.d.ts

@@ -12,7 +12,7 @@ export interface QuasiGridProps extends ObjectReadyProps {
     /** Pointer bindings on this grid's config knobs (mouseMove.grid). */
     mouseMove?: MouseMoveDomain;
 }
-/** QuasiGridConfig — the single source of truth for a quasicrystal grid instance. */
+/** QuasiGridConfig defaults: the core registry entry (DEFAULT_GRIDS.quasiGrid), never a copy. */
 export declare const defaultQuasiGridConfig: QuasiGridConfig;
 export declare function QuasiGrid({ config, groupProps, id, keyframes, mouseMove, onObjectReady, onObjectDispose }: QuasiGridProps): import("react").JSX.Element;
 export default QuasiGrid;

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

@@ -1 +1 @@
-{"version":3,"file":"QuasiGrid.d.ts","sourceRoot":"","sources":["../../src/components/QuasiGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACpD,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAKD,qFAAqF;AACrF,eAAO,MAAM,sBAAsB,EAAE,eA2BpC,CAAC;AAqBF,wBAAgB,SAAS,CAAC,EAAE,MAA+B,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,cAAc,+BA6ClJ;AAED,eAAe,SAAS,CAAC"}
+{"version":3,"file":"QuasiGrid.d.ts","sourceRoot":"","sources":["../../src/components/QuasiGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACpD,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAKD,iGAAiG;AACjG,eAAO,MAAM,sBAAsB,EAAyC,eAAe,CAAC;AAqB5F,wBAAgB,SAAS,CAAC,EAAE,MAA+B,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,cAAc,+BA6ClJ;AAED,eAAe,SAAS,CAAC"}

package/dist/components/QuasiGrid.js

@@ -6,38 +6,11 @@ import { useGridSurface } from '../hooks/useGridSurface.js';
 import { useConfigDriver } from '../hooks/useConfigDriver.js';
 import { withConfigDefaults } from '../utils/configAnimations.js';
 import { applyGridConfig, GRID_STRUCTURAL } from '../utils/gridConfig.js';
-import { QuasiGridMaterial, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
+import { QuasiGridMaterial, DEFAULT_GRIDS, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
 // Side-effect import registers <quasiGridMaterial> via extend().
 void QuasiGridMaterial;
-/** QuasiGridConfig — the single source of truth for a quasicrystal grid instance. */
-export const defaultQuasiGridConfig = {
-    cellSize: 3,
-    size: 50,
-    segments: undefined,
-    flat: true,
-    lineMode: 1, // ripple out from the focus point
-    cellMode: 2, // twinkle
-    lineWidth: 1.2,
-    sectionSize: 5,
-    sectionWidth: 2,
-    animSpeed: 1,
-    animScale: 0.5,
-    animIntensity: 1,
-    fadeDistance: undefined,
-    fadeStrength: 0.7,
-    displace: 0,
-    symmetry: 5, // Penrose
-    phase: 0.2,
-    lineColor: '#8c4d1f',
-    sectionColor: '#ffc759',
-    cellColor: '#381a08',
-    glowColor: '#ffa640',
-    bgColor: '#0d0503',
-    bgOpacity: 0,
-    followMouse: false,
-    reveal: 1,
-    revealDuration: 0,
-};
+/** QuasiGridConfig defaults: the core registry entry (DEFAULT_GRIDS.quasiGrid), never a copy. */
+export const defaultQuasiGridConfig = DEFAULT_GRIDS.quasiGrid;
 /**
  * An aperiodic quasicrystal lattice, built as a de Bruijn multigrid: `symmetry`
  * families of evenly spaced parallel lines spread over a half turn.
@@ -64,11 +37,11 @@ export function QuasiGrid({ config = defaultQuasiGridConfig, groupProps, id, key
     // The committed config over this grid's defaults: every knob has a value to render
     // and for a keyframe or pointer binding to start from.
     const base = useMemo(() => withConfigDefaults(defaultQuasiGridConfig, config), [config]);
-    const { cellSize, size, segments, flat, displace, followMouse, reveal, revealDuration } = base;
+    const { cellSize, size, segments, displace, reveal, revealDuration } = base;
     const segs = segments ?? (displace > 0
         ? Math.min(256, Math.max(64, Math.ceil(size / Math.max(cellSize, 1e-4)) * 2))
         : 1);
-    useGridSurface(matRef, meshRef, { followMouse, reveal, revealDuration });
+    useGridSurface(matRef, meshRef, { reveal, revealDuration });
     // One push point for every uniform the config owns: the committed config when the
     // material mounts or the config commits, the merged one while anything overrides it.
     const baseRef = useRef(base);
@@ -81,6 +54,6 @@ export function QuasiGrid({ config = defaultQuasiGridConfig, groupProps, id, key
     useLayoutEffect(() => { applyGridConfig(matRef.current, base, VARIANT, DERIVE); }, [base]);
     const push = useCallback((merged) => applyGridConfig(matRef.current, merged, VARIANT, DERIVE), []);
     useConfigDriver({ rootRef, id, family: 'grids', base, structural: STRUCTURAL, allowed: ANIMATABLE, keyframes, mouseMove, push });
-    return (_jsx("group", { ref: rootRef, ...groupProps, children: _jsxs("mesh", { ref: meshRef, rotation: flat ? [-Math.PI / 2, 0, 0] : [0, 0, 0], children: [_jsx("planeGeometry", { args: [size, size, segs, segs] }), _jsx("quasiGridMaterial", { ref: setMaterial, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide }, QuasiGridMaterial.key)] }) }));
+    return (_jsx("group", { ref: rootRef, ...groupProps, children: _jsxs("mesh", { ref: meshRef, rotation: [-Math.PI / 2, 0, 0], children: [_jsx("planeGeometry", { args: [size, size, segs, segs] }), _jsx("quasiGridMaterial", { ref: setMaterial, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide }, QuasiGridMaterial.key)] }) }));
 }
 export default QuasiGrid;

package/dist/components/RadarGrid.d.ts

@@ -12,7 +12,7 @@ export interface RadarGridProps extends ObjectReadyProps {
     /** Pointer bindings on this grid's config knobs (mouseMove.grid). */
     mouseMove?: MouseMoveDomain;
 }
-/** RadarGridConfig — the single source of truth for a radar grid instance. */
+/** RadarGridConfig defaults: the core registry entry (DEFAULT_GRIDS.radarGrid), never a copy. */
 export declare const defaultRadarGridConfig: RadarGridConfig;
 export declare function RadarGrid({ config, groupProps, id, keyframes, mouseMove, onObjectReady, onObjectDispose }: RadarGridProps): import("react").JSX.Element;
 export default RadarGrid;

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

@@ -1 +1 @@
-{"version":3,"file":"RadarGrid.d.ts","sourceRoot":"","sources":["../../src/components/RadarGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACpD,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAKD,8EAA8E;AAC9E,eAAO,MAAM,sBAAsB,EAAE,eA4BpC,CAAC;AAuBF,wBAAgB,SAAS,CAAC,EAAE,MAA+B,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,cAAc,+BA6ClJ;AAED,eAAe,SAAS,CAAC"}
+{"version":3,"file":"RadarGrid.d.ts","sourceRoot":"","sources":["../../src/components/RadarGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACpD,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAKD,iGAAiG;AACjG,eAAO,MAAM,sBAAsB,EAAyC,eAAe,CAAC;AAuB5F,wBAAgB,SAAS,CAAC,EAAE,MAA+B,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,cAAc,+BA6ClJ;AAED,eAAe,SAAS,CAAC"}

package/dist/components/RadarGrid.js

@@ -6,39 +6,11 @@ import { useGridSurface } from '../hooks/useGridSurface.js';
 import { useConfigDriver } from '../hooks/useConfigDriver.js';
 import { withConfigDefaults } from '../utils/configAnimations.js';
 import { applyGridConfig, GRID_STRUCTURAL } from '../utils/gridConfig.js';
-import { RadarGridMaterial, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
+import { RadarGridMaterial, DEFAULT_GRIDS, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
 // Side-effect import registers <radarGridMaterial> via extend().
 void RadarGridMaterial;
-/** RadarGridConfig — the single source of truth for a radar grid instance. */
-export const defaultRadarGridConfig = {
-    cellSize: 2.5,
-    size: 50,
-    segments: undefined,
-    flat: true,
-    lineMode: 1, // ping rings expanding from the focus point
-    cellMode: 0,
-    lineWidth: 1,
-    sectionSize: 4,
-    sectionWidth: 1.8,
-    animSpeed: 1,
-    animScale: 0.5,
-    animIntensity: 1,
-    fadeDistance: 24,
-    fadeStrength: 0.25,
-    displace: 0,
-    spokes: 24,
-    sweepWidth: 0.13,
-    blipDensity: 0.08,
-    lineColor: '#1a805a',
-    sectionColor: '#80ffb8',
-    cellColor: '#0d3324',
-    glowColor: '#59ff99',
-    bgColor: '#020d08',
-    bgOpacity: 0.25,
-    followMouse: false,
-    reveal: 1,
-    revealDuration: 0,
-};
+/** RadarGridConfig defaults: the core registry entry (DEFAULT_GRIDS.radarGrid), never a copy. */
+export const defaultRadarGridConfig = DEFAULT_GRIDS.radarGrid;
 /**
  * A polar HUD — concentric rings and radial spokes instead of an X/Y lattice,
  * masked to a disc of `fadeDistance` rather than filling its square plane.
@@ -67,11 +39,11 @@ export function RadarGrid({ config = defaultRadarGridConfig, groupProps, id, key
     // The committed config over this grid's defaults: every knob has a value to render
     // and for a keyframe or pointer binding to start from.
     const base = useMemo(() => withConfigDefaults(defaultRadarGridConfig, config), [config]);
-    const { cellSize, size, segments, flat, displace, followMouse, reveal, revealDuration } = base;
+    const { cellSize, size, segments, displace, reveal, revealDuration } = base;
     const segs = segments ?? (displace > 0
         ? Math.min(256, Math.max(64, Math.ceil(size / Math.max(cellSize, 1e-4)) * 4))
         : 1);
-    useGridSurface(matRef, meshRef, { followMouse, reveal, revealDuration });
+    useGridSurface(matRef, meshRef, { reveal, revealDuration });
     // One push point for every uniform the config owns: the committed config when the
     // material mounts or the config commits, the merged one while anything overrides it.
     const baseRef = useRef(base);
@@ -84,6 +56,6 @@ export function RadarGrid({ config = defaultRadarGridConfig, groupProps, id, key
     useLayoutEffect(() => { applyGridConfig(matRef.current, base, VARIANT, DERIVE); }, [base]);
     const push = useCallback((merged) => applyGridConfig(matRef.current, merged, VARIANT, DERIVE), []);
     useConfigDriver({ rootRef, id, family: 'grids', base, structural: STRUCTURAL, allowed: ANIMATABLE, keyframes, mouseMove, push });
-    return (_jsx("group", { ref: rootRef, ...groupProps, children: _jsxs("mesh", { ref: meshRef, rotation: flat ? [-Math.PI / 2, 0, 0] : [0, 0, 0], children: [_jsx("planeGeometry", { args: [size, size, segs, segs] }), _jsx("radarGridMaterial", { ref: setMaterial, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide }, RadarGridMaterial.key)] }) }));
+    return (_jsx("group", { ref: rootRef, ...groupProps, children: _jsxs("mesh", { ref: meshRef, rotation: [-Math.PI / 2, 0, 0], children: [_jsx("planeGeometry", { args: [size, size, segs, segs] }), _jsx("radarGridMaterial", { ref: setMaterial, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide }, RadarGridMaterial.key)] }) }));
 }
 export default RadarGrid;

package/dist/components/ReactionDiffusionGrid.d.ts

@@ -12,7 +12,7 @@ export interface ReactionDiffusionGridProps extends ObjectReadyProps {
     /** Pointer bindings on this grid's config knobs (mouseMove.grid). */
     mouseMove?: MouseMoveDomain;
 }
-/** ReactionDiffusionGridConfig defaults. Must match the catalog entry in grid-defaults.json exactly. */
+/** ReactionDiffusionGridConfig defaults: the core registry entry (DEFAULT_GRIDS.reactionDiffusionGrid), never a copy. */
 export declare const defaultReactionDiffusionGridConfig: ReactionDiffusionGridConfig;
 /**
  * A Gray-Scott reaction-diffusion field simulated on the GPU and sampled by the plane: coral, labyrinths and dividing spots grow, merge and keep evolving, wrapped seamlessly as a torus.

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

@@ -1 +1 @@
-{"version":3,"file":"ReactionDiffusionGrid.d.ts","sourceRoot":"","sources":["../../src/components/ReactionDiffusionGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAQxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAExE,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,0BAA2B,SAAQ,gBAAgB;IAChE,MAAM,CAAC,EAAE,2BAA2B,CAAC;IACrC,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAKD,wGAAwG;AACxG,eAAO,MAAM,kCAAkC,EAAE,2BA6BhD,CAAC;AA+LF;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,MAA2C,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,0BAA0B,+BA0DtL;AAED,eAAe,qBAAqB,CAAC"}
+{"version":3,"file":"ReactionDiffusionGrid.d.ts","sourceRoot":"","sources":["../../src/components/ReactionDiffusionGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAQxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAExE,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,0BAA2B,SAAQ,gBAAgB;IAChE,MAAM,CAAC,EAAE,2BAA2B,CAAC;IACrC,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAKD,yHAAyH;AACzH,eAAO,MAAM,kCAAkC,EAAqD,2BAA2B,CAAC;AA+LhI;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,MAA2C,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,0BAA0B,+BA0DtL;AAED,eAAe,qBAAqB,CAAC"}

package/dist/components/ReactionDiffusionGrid.js

@@ -7,40 +7,11 @@ import { useGridSurface } from '../hooks/useGridSurface.js';
 import { useConfigDriver } from '../hooks/useConfigDriver.js';
 import { withConfigDefaults } from '../utils/configAnimations.js';
 import { applyGridConfig, GRID_STRUCTURAL } from '../utils/gridConfig.js';
-import { ReactionDiffusionGridMaterial, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
+import { ReactionDiffusionGridMaterial, DEFAULT_GRIDS, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
 // Side-effect import registers <reactionDiffusionGridMaterial> via extend().
 void ReactionDiffusionGridMaterial;
-/** ReactionDiffusionGridConfig defaults. Must match the catalog entry in grid-defaults.json exactly. */
-export const defaultReactionDiffusionGridConfig = {
-    cellSize: 3,
-    size: 50,
-    flat: true,
-    segments: undefined,
-    lineMode: 0,
-    cellMode: 0,
-    lineWidth: 1.1,
-    sectionSize: 5,
-    sectionWidth: 1.2,
-    animSpeed: 1,
-    animScale: 0.5,
-    animIntensity: 0.6,
-    fadeDistance: undefined,
-    fadeStrength: 0.7,
-    displace: 0,
-    feed: 0.037,
-    kill: 0.06,
-    variation: 0.55,
-    tileCells: 7,
-    lineColor: '#7ff0d4',
-    sectionColor: '#f0a26a',
-    cellColor: '#0d4b52',
-    glowColor: '#2fd9c8',
-    bgColor: '#03080a',
-    bgOpacity: 0,
-    followMouse: false,
-    reveal: 1,
-    revealDuration: 0,
-};
+/** ReactionDiffusionGridConfig defaults: the core registry entry (DEFAULT_GRIDS.reactionDiffusionGrid), never a copy. */
+export const defaultReactionDiffusionGridConfig = DEFAULT_GRIDS.reactionDiffusionGrid;
 // ---------------------------------------------------------------------------
 // Gray-Scott reaction-diffusion. Two chemicals diffuse at different rates and
 // react as u + 2v -> 3v: the autocatalyst v eats u, u is fed in at rate F and
@@ -233,10 +204,10 @@ export function ReactionDiffusionGrid({ config = defaultReactionDiffusionGridCon
     // The committed config over this grid's defaults: every knob has a value to render
     // and for a keyframe or pointer binding to start from.
     const base = useMemo(() => withConfigDefaults(defaultReactionDiffusionGridConfig, config), [config]);
-    const { cellSize, size, segments, flat, displace, followMouse, reveal, revealDuration } = base;
+    const { cellSize, size, segments, displace, reveal, revealDuration } = base;
     // the relief follows the pattern itself, which is a few texels wide
     const segs = segments ?? (displace > 0 ? Math.min(512, Math.max(128, Math.ceil(size / Math.max(cellSize, 1e-4)) * 12)) : 1);
-    useGridSurface(matRef, meshRef, { followMouse, reveal, revealDuration });
+    useGridSurface(matRef, meshRef, { reveal, revealDuration });
     // One push point for every uniform the config owns: the committed config when the
     // material mounts or the config commits, the merged one while anything overrides it.
     const baseRef = useRef(base);
@@ -265,6 +236,6 @@ export function ReactionDiffusionGrid({ config = defaultReactionDiffusionGridCon
             runtimeRef.current = null;
         }
     }, []);
-    return (_jsx("group", { ref: rootRef, ...groupProps, children: _jsxs("mesh", { ref: meshRef, rotation: flat ? [-Math.PI / 2, 0, 0] : [0, 0, 0], children: [_jsx("planeGeometry", { args: [size, size, segs, segs] }), _jsx("reactionDiffusionGridMaterial", { ref: setMaterial, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide }, ReactionDiffusionGridMaterial.key)] }) }));
+    return (_jsx("group", { ref: rootRef, ...groupProps, children: _jsxs("mesh", { ref: meshRef, rotation: [-Math.PI / 2, 0, 0], children: [_jsx("planeGeometry", { args: [size, size, segs, segs] }), _jsx("reactionDiffusionGridMaterial", { ref: setMaterial, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide }, ReactionDiffusionGridMaterial.key)] }) }));
 }
 export default ReactionDiffusionGrid;

package/dist/components/SceneBuilder.d.ts

@@ -1,14 +1,36 @@
 import { type SceneHandle } from "../api/sceneHandle";
-import type { SceneBuilderProps } from '@3driseai/3drise-core';
+import type { SceneBuilderProps, UiLayer } from '@3driseai/3drise-core';
 import React from "react";
 import type { ObjectReadyProps } from "../types/objectReady";
 export type SceneBuilderViewerProps = SceneBuilderProps & ObjectReadyProps & {
-    /** Called once the canvas exists, with the handle for driving this project's actions and animations. */
+    /**
+     * Called once the scene is READY — every model loaded (or failed), shaders compiled, one frame
+     * rendered (see triggers/readiness) — with the handle for driving this project's actions and animations.
+     */
     onSceneReady?: (scene: SceneHandle) => void;
+    /** Covers the scene until it is ready (default: the scene's background colour). */
+    loadingIndicator?: React.ReactNode;
+    /** Render the project's UI layers over the scene (default true). */
+    ui?: boolean;
+    /** UI layers to render instead of `project.uiLayers` (the studio passes its own). */
+    uiLayers?: UiLayer[];
+    /** Extra CSS appended to every UI layer after its own, to restyle them. */
+    uiStyles?: string;
 };
 declare const SceneBuilder: React.ForwardRefExoticComponent<SceneBuilderProps & ObjectReadyProps & {
-    /** Called once the canvas exists, with the handle for driving this project's actions and animations. */
+    /**
+     * Called once the scene is READY — every model loaded (or failed), shaders compiled, one frame
+     * rendered (see triggers/readiness) — with the handle for driving this project's actions and animations.
+     */
     onSceneReady?: (scene: SceneHandle) => void;
+    /** Covers the scene until it is ready (default: the scene's background colour). */
+    loadingIndicator?: React.ReactNode;
+    /** Render the project's UI layers over the scene (default true). */
+    ui?: boolean;
+    /** UI layers to render instead of `project.uiLayers` (the studio passes its own). */
+    uiLayers?: UiLayer[];
+    /** Extra CSS appended to every UI layer after its own, to restyle them. */
+    uiStyles?: string;
 } & React.RefAttributes<SceneHandle>>;
 export default SceneBuilder;
 //# sourceMappingURL=SceneBuilder.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"SceneBuilder.d.ts","sourceRoot":"","sources":["../../src/components/SceneBuilder.tsx"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,WAAW,EAA0B,MAAM,oBAAoB,CAAC;AAGjG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAW/D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,MAAM,uBAAuB,GAAG,iBAAiB,GAAG,gBAAgB,GAAG;IACzE,wGAAwG;IACxG,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;CAC/C,CAAC;AAEF,QAAA,MAAM,YAAY;IAJd,wGAAwG;mBACzF,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI;qCAgK7C,CAAC;AAEH,eAAe,YAAY,CAAC"}
+{"version":3,"file":"SceneBuilder.d.ts","sourceRoot":"","sources":["../../src/components/SceneBuilder.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAqB,KAAK,WAAW,EAA0B,MAAM,oBAAoB,CAAC;AAGjG,OAAO,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAWxE,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAK7D,MAAM,MAAM,uBAAuB,GAAG,iBAAiB,GAAG,gBAAgB,GAAG;IACzE;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IAC5C,mFAAmF;IACnF,gBAAgB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACnC,oEAAoE;IACpE,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,qFAAqF;IACrF,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,QAAA,MAAM,YAAY;IAfd;;;OAGG;mBACY,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI;IAC3C,mFAAmF;uBAChE,KAAK,CAAC,SAAS;IAClC,oEAAoE;SAC/D,OAAO;IACZ,qFAAqF;eAC1E,OAAO,EAAE;IACpB,2EAA2E;eAChE,MAAM;qCA0LnB,CAAC;AAIH,eAAe,YAAY,CAAC"}

package/dist/components/SceneBuilder.js

@@ -1,5 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { forwardRef, useImperativeHandle, useMemo, useRef, useState } from "react";
+import { forwardRef, useEffect, useImperativeHandle, useLayoutEffect, useMemo, useRef, useState } from "react";
+import { EFFECT_CLIP_ASSET, effectClipFromAsset, setEffectClipTemplates } from "../operations/runtime.js";
 import { createSceneHandle } from "../api/sceneHandle.js";
 import { Canvas } from "@react-three/fiber";
 import { LIGHTING_PRESETS, SceneStore } from "@3driseai/3drise-core";
@@ -13,7 +14,10 @@ import ClipPlayer from "../animationsV2/ClipPlayer.js";
 import { normalizeClip, normalizeSequence } from "../animationsV2/normalize.js";
 import { resolveElementSettings } from "../animationsV2/elementSettings.js";
 import { Physics } from "@react-three/rapier";
-const SceneBuilder = forwardRef(({ project, width = "100%", height = "100vh", style = {}, className = "", onSceneInitialized, onSceneReady, onUiElementClick, onObjectClick, onObjectReady, onObjectDispose, }, ref) => {
+import UiLayers from "../ui/UiLayers.js";
+import { sceneReadiness, useSceneReady } from "../triggers/readiness.js";
+import UiAnchorUpdater from "../ui/UiAnchorUpdater.js";
+const SceneBuilder = forwardRef(({ project, width = "100%", height = "100vh", style = {}, className = "", onSceneInitialized, onSceneReady, loadingIndicator, ui = true, uiLayers, uiStyles, onObjectClick, onObjectReady, onObjectDispose, }, ref) => {
     const sceneSettings = (project.sceneSettingsData || {});
     // const meshController = useMeshController();
     const [isThreeJsMounted, setIsThreeJsMounted] = useState(false);
@@ -50,14 +54,42 @@ const SceneBuilder = forwardRef(({ project, width = "100%", height = "100vh", st
     const animationClips = useMemo(() => (rawClips || []).map(normalizeClip), [rawClips]);
     const animationSequences = useMemo(() => (rawSequences || []).map(normalizeSequence), [rawSequences]);
     const actionSequences = project.actionSequences || [];
+    // Effect clip templates the project links (its interactions and actions point at them).
+    const rawAssets = project.assets;
+    useEffect(() => {
+        setEffectClipTemplates((rawAssets ?? []).filter(a => a?.type === EFFECT_CLIP_ASSET).map(a => effectClipFromAsset(a)).filter(Boolean), 'project');
+    }, [rawAssets]);
     const clipAutoplay = useMemo(() => ({ sequences: animationSequences, clips: animationClips }), [animationSequences, animationClips]);
     // The external control handle (see api/sceneHandle). Built once; reads the
     // current project lists through a ref, so it never goes stale.
     const handleSource = useRef({ actions: actionSequences, clips: animationClips, sequences: animationSequences });
-    handleSource.current = { actions: actionSequences, clips: animationClips, sequences: animationSequences };
+    handleSource.current = { actions: actionSequences, clips: animationClips, sequences: animationSequences, objects: project.sceneObjects || sceneSettings.scene?.objectSettings || [] };
     const sceneHandle = useMemo(() => createSceneHandle(() => handleSource.current), []);
     useImperativeHandle(ref, () => sceneHandle, [sceneHandle]);
     const sceneObjects = project.sceneObjects || sceneSettings.scene?.objectSettings || [];
+    // Readiness: nothing runs (autoplay, object effects, onSceneReady) and the cover stays on until
+    // the canvas exists, every model has loaded or failed, shaders are compiled and a frame rendered.
+    const ready = useSceneReady();
+    const threeRef = useRef(null);
+    const onSceneReadyRef = useRef(onSceneReady);
+    onSceneReadyRef.current = onSceneReady;
+    const modelKey = sceneObjects.filter(o => o?.type === 'model').map(o => o.id).join(',');
+    // A layout effect: the gate must close before the canvas renders its children (R3F renders
+    // them after it has measured itself), or their effects would start ungated.
+    const [started, setStarted] = useState(false);
+    useLayoutEffect(() => {
+        sceneReadiness.begin([CANVAS_READY, ...(modelKey ? modelKey.split(',') : [])], {
+            compile: () => {
+                const t = threeRef.current;
+                return t?.gl?.compileAsync ? t.gl.compileAsync(t.scene, t.camera) : Promise.resolve();
+            },
+        });
+        if (threeRef.current)
+            sceneReadiness.report(CANVAS_READY); // remount with the canvas already there
+        const cancel = sceneReadiness.whenReady(() => onSceneReadyRef.current?.(sceneHandle));
+        setStarted(true);
+        return () => { cancel(); sceneReadiness.reset(); };
+    }, [modelKey, sceneHandle]);
     const modelObjects = sceneObjects.filter((obj) => obj.type === "model");
     const meshObjects = sceneObjects.filter((obj) => obj.type === "mesh");
     const sceneCanvas = sceneSettings.canvas || sceneSettings.scene?.canvas || {};
@@ -121,41 +153,39 @@ const SceneBuilder = forwardRef(({ project, width = "100%", height = "100vh", st
     //   };
     //   initializeSceneAssets();
     // }, [meshController, modelObjects, meshObjects]);
-    const handleElementClick = (element) => {
-        if (element && onUiElementClick) {
-            onUiElementClick(element);
-        }
-    };
-    return (_jsx("div", { className: className, style: containerStyle, children: _jsx(Canvas, { style: {
-                backgroundColor: backgroundColor,
-            }, shadows: shadows, dpr: dpr, gl: {
-                antialias,
-                alpha: true,
-                powerPreference: "high-performance",
-                ...gl,
-            }, camera: {
-                fov,
-                near,
-                far,
-                position: [position[0], position[1], position[2]],
-                rotation: [orientation[0], orientation[1], orientation[2]],
-            }, onCreated: (state) => {
-                state.gl.toneMapping = NoToneMapping;
-                setIsThreeJsMounted(true);
-                SceneStore.scene = state.scene;
-                SceneStore.gl = state.gl;
-                if (onSceneInitialized) {
-                    onSceneInitialized();
-                }
-                onSceneReady?.(sceneHandle);
-            }, children: _jsxs(Physics, { gravity: physicsSettings.gravity, paused: !physicsSettings.enabled, debug: physicsSettings.debug, children: [_jsx(LightsManager, { config: lighting[0], onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }), environment && _jsx(EnvironmentManager, { environment: environment, timeSettings: timeSettings, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }), _jsx(CameraController, { settings: camera, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }), _jsx(ObjectsRenderer, { cameraSettings: camera, generalObjectSettings: generalObjectSettings, createdObjects: sceneObjects, onObjectsReady: undefined, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose, sequences: animationSequences, clips: animationClips, actionSequences: actionSequences, handleObjectClick: onObjectClick ? (object, ref, event) => onObjectClick(object, ref, event) : undefined }), _jsx(ClipPlayer, { autoplay: clipAutoplay, getAction: (id) => actionSequences?.find((a) => a.id === id), getSettings: (state) => resolveElementSettings(state, {
-                            objects: sceneObjects,
-                            camera,
-                            sky: environment?.sky,
-                            clouds: environment?.clouds,
-                            ocean: environment?.ocean,
-                            terrain: environment?.terrain,
-                        }) }), _jsx(CursorController, { effects: project.cursor?.effects, clickActions: project.cursor?.clickActions, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose })] }) }) }));
+    return (_jsxs("div", { className: className, style: containerStyle, children: [_jsx(Canvas, { style: {
+                    backgroundColor: backgroundColor,
+                }, shadows: shadows, dpr: dpr, gl: {
+                    antialias,
+                    alpha: true,
+                    powerPreference: "high-performance",
+                    ...gl,
+                }, camera: {
+                    fov,
+                    near,
+                    far,
+                    position: [position[0], position[1], position[2]],
+                    rotation: [orientation[0], orientation[1], orientation[2]],
+                }, onCreated: (state) => {
+                    state.gl.toneMapping = NoToneMapping;
+                    setIsThreeJsMounted(true);
+                    SceneStore.scene = state.scene;
+                    SceneStore.gl = state.gl;
+                    if (onSceneInitialized) {
+                        onSceneInitialized();
+                    }
+                    threeRef.current = { gl: state.gl, scene: state.scene, camera: state.camera };
+                    sceneReadiness.report(CANVAS_READY);
+                }, children: _jsxs(Physics, { gravity: physicsSettings.gravity, paused: !physicsSettings.enabled, debug: physicsSettings.debug, children: [_jsx(LightsManager, { config: lighting[0], onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }), environment && _jsx(EnvironmentManager, { environment: environment, timeSettings: timeSettings, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }), _jsx(CameraController, { settings: camera, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }), _jsx(ObjectsRenderer, { cameraSettings: camera, generalObjectSettings: generalObjectSettings, createdObjects: sceneObjects, onObjectsReady: undefined, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose, sequences: animationSequences, clips: animationClips, actionSequences: actionSequences, handleObjectClick: onObjectClick ? (object, ref, event) => onObjectClick(object, ref, event) : undefined }), _jsx(ClipPlayer, { autoplay: clipAutoplay, getAction: (id) => actionSequences?.find((a) => a.id === id), getSettings: (state) => resolveElementSettings(state, {
+                                objects: sceneObjects,
+                                camera,
+                                sky: environment?.sky,
+                                clouds: environment?.clouds,
+                                ocean: environment?.ocean,
+                                terrain: environment?.terrain,
+                            }) }), _jsx(CursorController, { effects: project.cursor?.effects, clickActions: project.cursor?.clickActions, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }), _jsx(UiAnchorUpdater, {})] }) }), ui && _jsx(UiLayers, { layers: uiLayers ?? project.uiLayers, scene: sceneHandle, extraCss: uiStyles }), (!started || !ready) && (_jsx("div", { style: { position: 'absolute', inset: 0, zIndex: 1000, backgroundColor, display: 'flex', alignItems: 'center', justifyContent: 'center' }, children: loadingIndicator }))] }));
 });
 SceneBuilder.displayName = 'SceneBuilder';
+/** Readiness entry for "the canvas exists" (its renderer is what compiles the shaders). */
+const CANVAS_READY = '__canvas__';
 export default SceneBuilder;

package/dist/components/SkyController.d.ts

@@ -4,8 +4,32 @@ export interface SkyControllerProps extends ObjectReadyProps {
     settings: SkySettings;
     timeSettings: TimeSettings;
     scale?: number;
+    /** Unused since time of day stopped writing its values back into the
+     *  settings (they are the day look now, not a mirror of the clock). Kept so
+     *  existing hosts still type-check. */
     onSettingsChange?: (settings: SkySettings) => void;
 }
-declare function SkyController({ settings, timeSettings, scale, onSettingsChange, onObjectReady, onObjectDispose, }: SkyControllerProps): any;
+/**
+ * The analytic (Preetham) sky.
+ *
+ * What it draws, each frame, in order:
+ *   1. the stored settings — or, while time of day is enabled, the time-driven
+ *      sun and atmosphere (time owns all six knobs then);
+ *   2. the `sky` keyframe domain        (settings.animations.sky)
+ *   3. the `sky` pointer domain on top  (settings.mouseMove.sky)
+ *   4. a controller's live drag         (SKY_LIVE_KEY handle on the mesh)
+ * With time of day on, the clock owns the sun's position (elevation/azimuth), and
+ * 1–4 above are the DAY look: atmosphereForSunElevation blends them into golden
+ * hour, twilight and night by the sun's height. Sliders, keyframes and pointer
+ * bindings on the atmosphere keep working with the clock running.
+ *
+ * Whatever it draws is published per scene (renderedSky) so the key light, the
+ * clouds, the water and the terrain are lit by the same sun and atmosphere.
+ *
+ * It draws only. The sun LIGHT is SkySystem's SunLight, which reads what this
+ * publishes; a second light here used to double the sun (always white, always
+ * on, lit from below the ground at night).
+ */
+declare function SkyController({ settings, timeSettings, scale, onObjectReady, onObjectDispose }: SkyControllerProps): import("react").JSX.Element;
 export default SkyController;
 //# sourceMappingURL=SkyController.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"SkyController.d.ts","sourceRoot":"","sources":["../../src/components/SkyController.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAQ7D,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEvE,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IACxD,QAAQ,EAAE,WAAW,CAAC;IACtB,YAAY,EAAE,YAAY,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,WAAW,KAAK,IAAI,CAAC;CACtD;AAED,iBAAS,aAAa,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,GAAG,EAAE,kBAAkB,GA+I8H,GAAG,CACtQ;AA6BD,eAAe,aAAa,CAAC"}
+{"version":3,"file":"SkyController.d.ts","sourceRoot":"","sources":["../../src/components/SkyController.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAiB7D,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGvE,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IACxD,QAAQ,EAAE,WAAW,CAAC;IACtB,YAAY,EAAE,YAAY,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;2CAEuC;IACvC,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,WAAW,KAAK,IAAI,CAAC;CACtD;AAsBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,iBAAS,aAAa,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAY,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,kBAAkB,+BAyMlH;AAED,eAAe,aAAa,CAAC"}