@3driseai/3drise-viewer 0.1.23 → 0.1.25

package/dist/api/sceneHandle.d.ts

@@ -0,0 +1,63 @@
+import type { ActionSequence, AnimationSequence } from '@3driseai/3drise-core';
+export interface SceneActionInfo {
+    id: string;
+    key?: string;
+    name: string;
+    description?: string;
+    applied: boolean;
+}
+export interface SceneAnimationInfo {
+    id: string;
+    name: string;
+    description?: string;
+    /** Seconds, one forward pass: Σ(delay + duration) over steps */
+    duration: number;
+    loop: boolean;
+    yoyo: boolean;
+    playing: boolean;
+}
+export interface ScenePlayOptions {
+    speed?: number;
+    reverse?: boolean;
+}
+export type SceneHandleEventType = 'actionApplied' | 'actionReverted' | 'animationStart' | 'animationEnd';
+export interface SceneHandleEvent {
+    type: SceneHandleEventType;
+    id: string;
+    key?: string;
+    name: string;
+}
+export interface SceneHandle {
+    actions: {
+        list(): SceneActionInfo[];
+        apply(ref: string): boolean;
+        revert(ref: string): boolean;
+        /** Returns true when it applied, false when it reverted (or the action was not found). */
+        toggle(ref: string): boolean;
+        isApplied(ref: string): boolean;
+        /** Revert every applied action of this project — back to the authored scene. */
+        reset(): void;
+    };
+    animations: {
+        list(): SceneAnimationInfo[];
+        play(ref: string, options?: ScenePlayOptions): boolean;
+        pause(ref: string): boolean;
+        resume(ref: string): boolean;
+        stop(ref: string): boolean;
+        /** Jump to a point in the animation, 0–1. */
+        seek(ref: string, progress: number): boolean;
+        isPlaying(ref: string): boolean;
+    };
+    /** Subscribe to this project's action / animation events. Returns the unsubscribe. */
+    on(type: SceneHandleEventType, listener: (event: SceneHandleEvent) => void): () => void;
+}
+export interface SceneHandleSource {
+    actions: ActionSequence[];
+    animations: AnimationSequence[];
+}
+/**
+ * Build a handle over one project's actions and animations. `getSource` is read on
+ * every call, so the handle stays valid if the project data is replaced.
+ */
+export declare function createSceneHandle(getSource: () => SceneHandleSource): SceneHandle;
+//# sourceMappingURL=sceneHandle.d.ts.map

package/dist/api/sceneHandle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sceneHandle.d.ts","sourceRoot":"","sources":["../../src/api/sceneHandle.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,cAAc,EAAkB,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/F,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,oBAAoB,GAAG,eAAe,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,cAAc,CAAC;AAE1G,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,oBAAoB,CAAC;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IACxB,OAAO,EAAE;QACL,IAAI,IAAI,eAAe,EAAE,CAAC;QAC1B,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAC5B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAC7B,0FAA0F;QAC1F,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAC7B,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAChC,gFAAgF;QAChF,KAAK,IAAI,IAAI,CAAC;KACjB,CAAC;IACF,UAAU,EAAE;QACR,IAAI,IAAI,kBAAkB,EAAE,CAAC;QAC7B,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC;QACvD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAC5B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAC7B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAC3B,6CAA6C;QAC7C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAC7C,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACnC,CAAC;IACF,sFAAsF;IACtF,EAAE,CAAC,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC3F;AAED,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,UAAU,EAAE,iBAAiB,EAAE,CAAC;CACnC;AA0BD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,iBAAiB,GAAG,WAAW,CAuGjF"}

package/dist/api/sceneHandle.js

@@ -0,0 +1,160 @@
+// =============================================================================
+// SceneHandle — control a loaded 3drise project from outside it
+// =============================================================================
+//
+// What a developer extending a project gets from <ProjectLoader ref={…} /> or
+// onSceneReady(handle): trigger the project's actions and animations from their
+// own UI, and hear when they run.
+//
+//   scene.current?.actions.toggle('open-door');
+//   scene.current?.animations.play('intro', { speed: 1.5 });
+//   const off = scene.current?.on('actionApplied', (e) => console.log(e.key));
+//
+// Addressing (`ref`): an action's `key` first (stable across renames and project
+// copies — prefer it), then its id, then its exact name. Animations have no key
+// yet, so id, then name. An ambiguous name warns and uses the first match.
+//
+// This is a thin layer: object clicks go through the same SceneActions /
+// AnimationsManager calls, so a button and a click behave identically.
+//
+import { AnimationsManager, SceneActions } from '@3driseai/3drise-core';
+function resolve(items, ref, kind) {
+    if (!ref)
+        return undefined;
+    const byKey = items.find(i => i.key === ref);
+    if (byKey)
+        return byKey;
+    const byId = items.find(i => i.id === ref);
+    if (byId)
+        return byId;
+    const byName = items.filter(i => i.name === ref);
+    if (byName.length > 1) {
+        console.warn(`[3drise] ${byName.length} ${kind}s are named "${ref}"; using the first.${kind === 'action' ? ' Address it by its key instead.' : ''}`);
+    }
+    if (byName.length === 0) {
+        console.warn(`[3drise] No ${kind} "${ref}" in this project. Known: ${items.map(i => i.key ?? i.name).join(', ') || 'none'}`);
+    }
+    return byName[0];
+}
+function animationDuration(seq) {
+    return (seq.steps ?? []).reduce((sum, s) => sum + (s.delay || 0) + (s.duration || 0), 0);
+}
+/**
+ * Build a handle over one project's actions and animations. `getSource` is read on
+ * every call, so the handle stays valid if the project data is replaced.
+ */
+export function createSceneHandle(getSource) {
+    const actions = () => getSource().actions ?? [];
+    const animations = () => getSource().animations ?? [];
+    const findAction = (ref) => resolve(actions(), ref, 'action');
+    const findAnimation = (ref) => resolve(animations(), ref, 'animation');
+    return {
+        actions: {
+            list: () => actions().map(a => ({
+                id: a.id,
+                key: a.key,
+                name: a.name,
+                description: a.description,
+                applied: SceneActions.isActionApplied(a.id),
+            })),
+            apply(ref) {
+                const a = findAction(ref);
+                if (!a)
+                    return false;
+                SceneActions.applyAction(a);
+                return true;
+            },
+            revert(ref) {
+                const a = findAction(ref);
+                if (!a)
+                    return false;
+                SceneActions.revertAction(a);
+                return true;
+            },
+            toggle(ref) {
+                const a = findAction(ref);
+                return a ? SceneActions.toggleAction(a) : false;
+            },
+            isApplied(ref) {
+                const a = findAction(ref);
+                return a ? SceneActions.isActionApplied(a.id) : false;
+            },
+            reset() {
+                // Only this project's actions — another scene on the page keeps its state.
+                for (const a of actions())
+                    SceneActions.revertAction(a.id);
+            },
+        },
+        animations: {
+            list: () => animations().map(s => ({
+                id: s.id,
+                name: s.name,
+                description: s.description,
+                duration: animationDuration(s),
+                loop: !!s.loop,
+                yoyo: !!s.yoyo,
+                playing: AnimationsManager.isSequencePlaying(s.id),
+            })),
+            play(ref, options = {}) {
+                const s = findAnimation(ref);
+                if (!s)
+                    return false;
+                AnimationsManager.playSequence(s, { speed: options.speed, reverse: options.reverse });
+                return true;
+            },
+            pause(ref) {
+                const s = findAnimation(ref);
+                if (!s)
+                    return false;
+                AnimationsManager.pauseSequence(s.id);
+                return true;
+            },
+            resume(ref) {
+                const s = findAnimation(ref);
+                if (!s)
+                    return false;
+                AnimationsManager.resumeSequence(s.id);
+                return true;
+            },
+            stop(ref) {
+                const s = findAnimation(ref);
+                if (!s)
+                    return false;
+                AnimationsManager.stopSequence(s.id);
+                return true;
+            },
+            seek(ref, progress) {
+                const s = findAnimation(ref);
+                if (!s)
+                    return false;
+                AnimationsManager.seekToProgress(s.id, progress);
+                return true;
+            },
+            isPlaying(ref) {
+                const s = findAnimation(ref);
+                return s ? AnimationsManager.isSequencePlaying(s.id) : false;
+            },
+        },
+        on(type, listener) {
+            if (type === 'actionApplied' || type === 'actionReverted') {
+                return SceneActions.onEvent((e) => {
+                    if (e.type === 'reset')
+                        return;
+                    if ((type === 'actionApplied') !== (e.type === 'applied'))
+                        return;
+                    const a = actions().find(x => x.id === e.actionId);
+                    if (a)
+                        listener({ type, id: a.id, key: a.key, name: a.name });
+                });
+            }
+            const managerEvent = type === 'animationStart' ? 'sequenceStart' : 'sequenceEnd';
+            const handler = (e) => {
+                const s = animations().find(x => x.id === e.sequenceId);
+                if (s)
+                    listener({ type, id: s.id, name: s.name });
+            };
+            AnimationsManager.on(managerEvent, handler);
+            return () => AnimationsManager.off(managerEvent, handler);
+        },
+    };
+}

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

@@ -1 +1 @@
-{"version":3,"file":"CameraController.d.ts","sourceRoot":"","sources":["../../src/components/CameraController.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAQ7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,UAAU,qBAAsB,SAAQ,gBAAgB;IACpD,QAAQ,EAAE,WAAW,CAAC;IACtB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,CAAC;IAC1C,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,CAAC;CAC/C;AAGD,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAwJ5D,CAAC;AACF,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"CameraController.d.ts","sourceRoot":"","sources":["../../src/components/CameraController.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAS7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,UAAU,qBAAsB,SAAQ,gBAAgB;IACpD,QAAQ,EAAE,WAAW,CAAC;IACtB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,CAAC;IAC1C,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,CAAC;CAC/C;AAGD,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CA0J5D,CAAC;AACF,eAAe,gBAAgB,CAAC"}

package/dist/components/CameraController.js

@@ -7,7 +7,10 @@ import { cameraManager } from '../utils/CameraSingleton.js';
 import { useAnimationEvents } from '../hooks/useAnimationEvents.js';
 import { usePathAnimation } from '../hooks/usePathAnimation.js';
 import { OrbitControls } from "@react-three/drei";
+import { useRuntimeSettings } from '../hooks/useRuntimeSettings.js';
 export const CameraController = ({ enableAutoAnimation = true, animationDuration = 1, animationEase = "power2.out", settings, onObjectReady, onObjectDispose, onControlsReady, onControlsDispose, }) => {
+    // Authored camera + any applied action patch ('camera').
+    settings = useRuntimeSettings('camera', settings);
     const { camera, set } = useThree();
     const cameraRef = useRef(camera);
     const transformAnimationProgress = useRef(0);
@@ -104,7 +107,7 @@ export const CameraController = ({ enableAutoAnimation = true, animationDuration
     useAnimationEvents({
         onStepStart: (event) => {
             if (event.step?.transitions) {
-                const stepDuration = event.step.duration || 1;
+                const stepDuration = event.step.duration ?? 1; // 0 = instant (actions)
                 event.step.transitions.forEach((transition) => {
                     const { state, properties, pathId } = transition;
                     if (state === 'camera') {

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

@@ -1 +1 @@
-{"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;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAIhE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;;;;;;;;iFAWiF;AACjF,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,iBAAiB,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG;IAChF,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAClC,OAAO,CAAC,EAAE,yBAAyB,CAAC;IACpC,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC9B,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,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,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;IAC9C;sEACkE;IAClE,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB;AAoBD,QAAA,MAAM,kBAAkB,8FAwGtB,CAAC;AAGH,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;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAIhE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;;;;;;;;iFAWiF;AACjF,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,iBAAiB,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG;IAChF,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAClC,OAAO,CAAC,EAAE,yBAAyB,CAAC;IACpC,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC9B,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,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,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;IAC9C;sEACkE;IAClE,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB;AAoBD,QAAA,MAAM,kBAAkB,8FAyGtB,CAAC;AAGH,eAAe,kBAAkB,CAAC"}

package/dist/components/EnvironmentManager.js

@@ -7,6 +7,7 @@ import { useEnvironmentProbe } from '../hooks/useEnvironmentProbe.js';
 import TerrainBuilder from './TerrainBuilder.js';
 import LandscapeBuilder from './LandscapeBuilder.js';
 import OceanBuilder from './OceanBuilder.js';
+import { useRuntimeSettings } from '../hooks/useRuntimeSettings.js';
 const DEFAULT_HDR = {
     visible: false,
     name: null,
@@ -25,11 +26,12 @@ const DEFAULT_HDR = {
 const ORIGIN = new Vector3(0, 0, 0);
 const EnvironmentManager = forwardRef(({ timeSettings, environment, hdrSettings, skySettings, cloudsSettings, terrainSettings, landscapeSettings, oceanSettings, fogSettings, cubeCameraResolution = 512, skyboxScale = 100000, playerPosition = ORIGIN, onTimeOfDayChange, onTimeUpdate, driveTime = true, onObjectReady, onObjectDispose, }, ref) => {
     const hdr = hdrSettings ?? environment?.hdr ?? DEFAULT_HDR;
-    const sky = skySettings ?? environment?.sky;
-    const clouds = cloudsSettings ?? environment?.clouds;
+    // Authored settings + applied action patches (runtime only).
+    const sky = useRuntimeSettings('sky', skySettings ?? environment?.sky);
+    const clouds = useRuntimeSettings('clouds', cloudsSettings ?? environment?.clouds);
     const terrain = terrainSettings ?? environment?.terrain;
     const landscape = landscapeSettings ?? environment?.landscape;
-    const ocean = oceanSettings ?? environment?.ocean;
+    const ocean = useRuntimeSettings('ocean', oceanSettings ?? environment?.ocean);
     const fog = fogSettings ?? environment?.fog;
     const sunSystemVisible = !!sky?.sunSystem?.visible;
     // Previously hardcoded true, which kept a cube camera alive — and re-captured

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

@@ -1 +1 @@
-{"version":3,"file":"LightObject.d.ts","sourceRoot":"","sources":["../../src/components/LightObject.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAK7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAQnE,KAAK,gBAAgB,GAAG,gBAAgB,GAAG;IACvC,aAAa,EAAE,qBAAqB,CAAC;CACxC,CAAC;AA+CF,QAAA,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CA4B3C,CAAC;AACF,eAAe,WAAW,CAAC"}
+{"version":3,"file":"LightObject.d.ts","sourceRoot":"","sources":["../../src/components/LightObject.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAK7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAUnE,KAAK,gBAAgB,GAAG,gBAAgB,GAAG;IACvC,aAAa,EAAE,qBAAqB,CAAC;CACxC,CAAC;AA+CF,QAAA,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CA+B3C,CAAC;AACF,eAAe,WAAW,CAAC"}

package/dist/components/LightObject.js

@@ -8,6 +8,7 @@ import LightBulb from './lightBulb/LightBulb.js';
 import SpotBeam from './spotBeam/SpotBeam.js';
 import LedArray from './ledArray/LedArray.js';
 import FluorescentTube from './fluorescentTube/FluorescentTube.js';
+import Candle from './candle/Candle.js';
 const DirectionalLightR3F = ({ config, animations, mouseMove, settings, onObjectReady, onObjectDispose }) => {
     const lightRef = useRef(null);
     useObjectReady(lightRef, settings, onObjectReady, onObjectDispose);
@@ -65,6 +66,9 @@ const LightObject = ({ createdObject, onObjectReady, onObjectDispose }) => {
             return _jsx(SpotLightR3F, { config: config, animations: animations, mouseMove: mouseMove, settings: createdObject, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose });
         case 'point':
             return _jsx(PointLightR3F, { config: config, animations: animations, mouseMove: mouseMove, settings: createdObject, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose });
+        // A raymarched flame with its own physics, and the wax under it.
+        case 'candle':
+            return _jsx(Candle, { id: createdObject.id, config: config, animations: animations, mouseMove: mouseMove, settings: createdObject, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose });
         // An array of LED dies: instant on, PWM ripple, optional diffuser.
         case 'ledArray':
             return _jsx(LedArray, { id: createdObject.id, config: config, animations: animations, mouseMove: mouseMove, settings: createdObject, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose });

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

@@ -1 +1 @@
-{"version":3,"file":"ObjectNode.d.ts","sourceRoot":"","sources":["../../src/components/ObjectNode.tsx"],"names":[],"mappings":"AAkBA,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;AAiBrD,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;AAkBF,QAAA,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAsIzC,CAAC;AACF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"ObjectNode.d.ts","sourceRoot":"","sources":["../../src/components/ObjectNode.tsx"],"names":[],"mappings":"AAmBA,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;AAiBrD,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;AAkBF,QAAA,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAyIzC,CAAC;AACF,eAAe,UAAU,CAAC"}

package/dist/components/ObjectNode.js

@@ -15,6 +15,7 @@ import GridGenerator from "./GridsGenerator.js";
 import OceanBuilder from "./OceanBuilder.js";
 import LandscapeObject from "./LandscapeObject.js";
 import LayoutInstances from "./LayoutInstances.js";
+import { useRuntimeSettings } from "../hooks/useRuntimeSettings.js";
 import { SELF_MANAGED_MATERIAL } from "../constants.js";
 import { LAYOUT_CAPABLE_TYPES, getObjectLayoutSupport, normalizeObjectLayout, isGenerativeParticlesConfig } from "@3driseai/3drise-core";
 // Slots after the first render with no ready callbacks: one object reports once.
@@ -47,7 +48,10 @@ const GroupWithChildren = ({ createdObject, children, onObjectReady, onObjectDis
     return (_jsxs(CreatedObject, { createdObject: createdObject, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose, handleObjectClick: handleObjectClick, shouldApply3driseMaterial: !isGroup && !selfManagedMaterial, children: [!isGroup && renderObject(createdObject, handleObjectClick), children.map(childNode => (_jsx(ObjectNode, { node: childNode, handleObjectClick: handleObjectClick, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }, childNode.objectId)))] }, createdObject.id));
 };
 const ObjectNode = ({ node, onObjectReady, onObjectDispose, handleObjectClick }) => {
-    const { children, createdObject } = node;
+    const { children } = node;
+    // Authored settings + any applied action patches (runtime only). Every renderer
+    // below sees the patched object, so an action can change anything an edit can.
+    const createdObject = useRuntimeSettings(node.createdObject?.id, node.createdObject);
     // Children describe themselves with their own settings; the scene above
     // knows them by the node's createdObject, so relabel on the way up.
     const relabel = useCallback((obj) => ({

package/dist/components/ObjectsRenderer.d.ts

@@ -1,4 +1,4 @@
-import type { AnimationSequence, GeneralObjectSettings, CameraState, CreatedObjectSettings } from '@3driseai/3drise-core';
+import type { ActionSequence, AnimationSequence, GeneralObjectSettings, CameraState, CreatedObjectSettings } from '@3driseai/3drise-core';
 import type { ObjectReadyProps } from '../types/objectReady';
 import React from "react";
 import { Object3D } from "three";
@@ -10,6 +10,7 @@ interface ObjectsRendererProps extends ObjectReadyProps {
     onObjectsReady?: () => void;
     handleObjectClick?: (object: CreatedObjectSettings, ref: Object3D, event: ThreeEvent<MouseEvent>) => void;
     sequences?: AnimationSequence[];
+    actionSequences?: ActionSequence[];
 }
 declare const ObjectsRenderer: React.FC<ObjectsRendererProps>;
 export default ObjectsRenderer;

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

@@ -1 +1 @@
-{"version":3,"file":"ObjectsRenderer.d.ts","sourceRoot":"","sources":["../../src/components/ObjectsRenderer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAI1H,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,UAAU,oBAAqB,SAAQ,gBAAgB;IACnD,cAAc,EAAE,WAAW,CAAC;IAC5B,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C,cAAc,EAAE,qBAAqB,EAAE,CAAC;IACxC,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;IAC1G,SAAS,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACnC;AAGD,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CA0ClD,CAAC;AAEH,eAAe,eAAe,CAAC"}
+{"version":3,"file":"ObjectsRenderer.d.ts","sourceRoot":"","sources":["../../src/components/ObjectsRenderer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAI1I,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,UAAU,oBAAqB,SAAQ,gBAAgB;IACnD,cAAc,EAAE,WAAW,CAAC;IAC5B,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C,cAAc,EAAE,qBAAqB,EAAE,CAAC;IACxC,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;IAC1G,SAAS,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAChC,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;CACtC;AAGD,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CA2ClD,CAAC;AAEH,eAAe,eAAe,CAAC"}

package/dist/components/ObjectsRenderer.js

@@ -4,7 +4,7 @@ import { buildObjectTree } from '@3driseai/3drise-core';
 import ObjectNode from './ObjectNode.js';
 import useInteraction from '../hooks/useInteraction.js';
 import { useObjectReady } from '../hooks/useObjectReady.js';
-const ObjectsRenderer = memo(({ cameraSettings, createdObjects, generalObjectSettings, onObjectsReady, onObjectReady, onObjectDispose, handleObjectClick, sequences = [], }) => {
+const ObjectsRenderer = memo(({ cameraSettings, createdObjects, generalObjectSettings, onObjectsReady, onObjectReady, onObjectDispose, handleObjectClick, sequences = [], actionSequences = [], }) => {
     const groupRef = useRef(null);
     const objectsTree = useMemo(() => buildObjectTree(createdObjects), [createdObjects]);
     const readyObjectsCount = useRef(0);
@@ -32,6 +32,7 @@ const ObjectsRenderer = memo(({ cameraSettings, createdObjects, generalObjectSet
     const { executeInteraction } = useInteraction({
         cameraSettings,
         sequences,
+        actionSequences,
     });
     const handleObjectClickHandler = (createdObject, ref, event) => {
         const clickInteractions = filterInteractionsByEvent(createdObject.actions, "click");

package/dist/components/ProjectLoader.d.ts

@@ -1,9 +1,10 @@
+import type { SceneHandle } from "../api/sceneHandle";
 import type { CreatedObjectSettings, HtmlElement } from '@3driseai/3drise-core';
 import React from "react";
 import { Object3D } from "three";
 import { type ThreeEvent } from "@react-three/fiber";
 import type { ObjectReadyProps } from "../types/objectReady";
-type ProjectProps = ObjectReadyProps & {
+declare const ProjectLoader: React.ForwardRefExoticComponent<ObjectReadyProps & {
     projectId: string;
     loadingIndicator?: React.ReactNode;
     onObjectClick?: (object: CreatedObjectSettings, ref: Object3D, event: ThreeEvent<MouseEvent>) => void;
@@ -11,7 +12,12 @@ type ProjectProps = ObjectReadyProps & {
     onElementClick?: (element: HtmlElement) => void;
     onElementHover?: (element: HtmlElement | null) => void;
     onSceneInitialized?: () => void;
-};
-declare const ProjectLoader: React.FC<ProjectProps>;
+    /**
+     * Called once the project is loaded and its canvas exists, with the handle for
+     * driving its actions and animations from your own UI. The same handle is also
+     * available through `ref`.
+     */
+    onSceneReady?: (scene: SceneHandle) => void;
+} & React.RefAttributes<SceneHandle>>;
 export default ProjectLoader;
 //# sourceMappingURL=ProjectLoader.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ProjectLoader.d.ts","sourceRoot":"","sources":["../../src/components/ProjectLoader.tsx"],"names":[],"mappings":"AAIA,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;AAC7D,KAAK,YAAY,GAAG,gBAAgB,GAAG;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACnC,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;IACtG,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,KAAK,IAAI,CAAC;IACvE,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IAChD,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IACvD,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;CACnC,CAAC;AAGF,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,YAAY,CAsDzC,CAAC;AACF,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,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"}

package/dist/components/ProjectLoader.js

@@ -1,11 +1,11 @@
 import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
-import { useEffect, useState } from "react";
+import { forwardRef, useEffect, useState } from "react";
 import { dataCenterServer } from '../constants.js';
 import SceneBuilder from "./SceneBuilder.js";
 import { loadAssets, } from "@3driseai/3drise-core";
 import LoadingIndicator from "./LoadingIndicator.js";
 import { useMeshController } from "../hooks/useMeshController.js";
-const ProjectLoader = ({ projectId, onObjectClick, onObjectHover, onElementClick, onElementHover, onSceneInitialized, onObjectReady, onObjectDispose, loadingIndicator = _jsx(LoadingIndicator, { text: "Loading project...", fullScreen: true, animate: true }) }) => {
+const ProjectLoader = forwardRef(({ projectId, onObjectClick, onObjectHover, onElementClick, onElementHover, onSceneInitialized, onSceneReady, onObjectReady, onObjectDispose, loadingIndicator = _jsx(LoadingIndicator, { text: "Loading project...", fullScreen: true, animate: true }) }, ref) => {
     const [project, setProject] = useState(null);
     const meshController = useMeshController();
     useEffect(() => {
@@ -56,6 +56,7 @@ const ProjectLoader = ({ projectId, onObjectClick, onObjectHover, onElementClick
                 flexDirection: 'column', gap: '1rem'
             }, children: loadingIndicator });
     }
-    return _jsx(_Fragment, { children: _jsx(SceneBuilder, { project: project, onSceneInitialized: onSceneInitialized, onUiElementClick: onElementClick, onUiElementHover: onElementHover, onObjectClick: onObjectClick, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }) });
-};
+    return _jsx(_Fragment, { children: _jsx(SceneBuilder, { ref: ref, project: project, onSceneReady: onSceneReady, onSceneInitialized: onSceneInitialized, onUiElementClick: onElementClick, onUiElementHover: onElementHover, onObjectClick: onObjectClick, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }) });
+});
+ProjectLoader.displayName = 'ProjectLoader';
 export default ProjectLoader;

package/dist/components/SceneBuilder.d.ts

@@ -1,6 +1,14 @@
+import { type SceneHandle } from "../api/sceneHandle";
 import type { SceneBuilderProps } from '@3driseai/3drise-core';
 import React from "react";
 import type { ObjectReadyProps } from "../types/objectReady";
-declare const SceneBuilder: React.FC<SceneBuilderProps & ObjectReadyProps>;
+export type SceneBuilderViewerProps = SceneBuilderProps & ObjectReadyProps & {
+    /** Called once the canvas exists, with the handle for driving this project's actions and animations. */
+    onSceneReady?: (scene: SceneHandle) => void;
+};
+declare const SceneBuilder: React.ForwardRefExoticComponent<SceneBuilderProps & ObjectReadyProps & {
+    /** Called once the canvas exists, with the handle for driving this project's actions and animations. */
+    onSceneReady?: (scene: SceneHandle) => void;
+} & 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":"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,CAuIhE,CAAC;AACF,eAAe,YAAY,CAAC"}
+{"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;AAQ/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;qCAkJ7C,CAAC;AAEH,eAAe,YAAY,CAAC"}

package/dist/components/SceneBuilder.js

@@ -1,5 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useState } from "react";
+import { forwardRef, useImperativeHandle, useMemo, useRef, useState } from "react";
+import { createSceneHandle } from "../api/sceneHandle.js";
 import { Canvas } from "@react-three/fiber";
 import { LIGHTING_PRESETS, SceneStore } from "@3driseai/3drise-core";
 import { NoToneMapping } from "three";
@@ -9,7 +10,7 @@ import CameraController from "./CameraController.js";
 import ObjectsRenderer from "./ObjectsRenderer.js";
 import CursorController from "./cursor/CursorController.js";
 import { Physics } from "@react-three/rapier";
-const SceneBuilder = ({ project, width = "100%", height = "100vh", style = {}, className = "", onSceneInitialized, onUiElementClick, onObjectClick, onObjectReady, onObjectDispose, }) => {
+const SceneBuilder = forwardRef(({ project, width = "100%", height = "100vh", style = {}, className = "", onSceneInitialized, onSceneReady, onUiElementClick, onObjectClick, onObjectReady, onObjectDispose, }, ref) => {
     const sceneSettings = (project.sceneSettingsData || {});
     // const meshController = useMeshController();
     const [isThreeJsMounted, setIsThreeJsMounted] = useState(false);
@@ -41,6 +42,13 @@ const SceneBuilder = ({ project, width = "100%", height = "100vh", style = {}, c
         }
     });
     const animationSequences = project.animationSequences || [];
+    const actionSequences = project.actionSequences || [];
+    // 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, animations: animationSequences });
+    handleSource.current = { actions: actionSequences, animations: animationSequences };
+    const sceneHandle = useMemo(() => createSceneHandle(() => handleSource.current), []);
+    useImperativeHandle(ref, () => sceneHandle, [sceneHandle]);
     const sceneObjects = project.sceneObjects || sceneSettings.scene?.objectSettings || [];
     const modelObjects = sceneObjects.filter((obj) => obj.type === "model");
     const meshObjects = sceneObjects.filter((obj) => obj.type === "mesh");
@@ -131,6 +139,8 @@ const SceneBuilder = ({ project, width = "100%", height = "100vh", style = {}, c
                 if (onSceneInitialized) {
                     onSceneInitialized();
                 }
-            }, 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, handleObjectClick: onObjectClick ? (object, ref, event) => onObjectClick(object, ref, event) : undefined }), _jsx(CursorController, { effects: project.cursor?.effects, clickActions: project.cursor?.clickActions, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose })] }) }) }));
-};
+                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, actionSequences: actionSequences, handleObjectClick: onObjectClick ? (object, ref, event) => onObjectClick(object, ref, event) : undefined }), _jsx(CursorController, { effects: project.cursor?.effects, clickActions: project.cursor?.clickActions, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose })] }) }) }));
+});
+SceneBuilder.displayName = 'SceneBuilder';
 export default SceneBuilder;

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

@@ -1 +1 @@
-{"version":3,"file":"Stars.d.ts","sourceRoot":"","sources":["../../src/components/Stars.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,EAAE,cAAc,EAA4C,MAAM,OAAO,CAAC;AAQjF,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,MAAM,WAAW,UAAW,SAAQ,gBAAgB;IAChD,QAAQ,EAAE,qBAAqB,CAAC;IAChC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAOD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAuDnE;AAYD,QAAA,MAAM,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,UAAU,CA2K/B,CAAC;AACF,eAAe,KAAK,CAAC"}
+{"version":3,"file":"Stars.d.ts","sourceRoot":"","sources":["../../src/components/Stars.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,EAAE,cAAc,EAA4C,MAAM,OAAO,CAAC;AAQjF,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,MAAM,WAAW,UAAW,SAAQ,gBAAgB;IAChD,QAAQ,EAAE,qBAAqB,CAAC;IAChC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAOD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAuDnE;AAYD,QAAA,MAAM,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,UAAU,CA4K/B,CAAC;AACF,eAAe,KAAK,CAAC"}

package/dist/components/Stars.js

@@ -135,7 +135,8 @@ const Stars = ({ settings, timeSettings, sunSystemEnabled = false, onObjectReady
                     pointsRef.current.visible = toProps.visible;
                 }
                 // color — existing path
-                setDuration(event.step.duration);
+                // speed = 1 / duration below; keep an instant (0) step finite.
+                setDuration(Math.max(event.step.duration ?? 1, 0.001));
                 if (toProps.color !== undefined) {
                     setColors({
                         baseColor: fromProps.color,

package/dist/components/candle/Candle.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import type { AnimationOptions, CreatedObjectSettings, MouseMoveDomain } from '@3driseai/3drise-core';
+import type { ObjectReadyProps } from '../../types/objectReady';
+export type CandleProps = ObjectReadyProps & {
+    /** Scene object id: the light controller finds the live-edit handle by it. */
+    id?: string;
+    config: Record<string, any>;
+    animations?: AnimationOptions[];
+    mouseMove?: MouseMoveDomain;
+    settings: CreatedObjectSettings | Record<string, any>;
+};
+declare const Candle: React.FC<CandleProps>;
+export default Candle;
+//# sourceMappingURL=Candle.d.ts.map

package/dist/components/candle/Candle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Candle.d.ts","sourceRoot":"","sources":["../../../src/components/candle/Candle.tsx"],"names":[],"mappings":"AAiBA,OAAO,KAAqC,MAAM,OAAO,CAAC;AAK1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAItG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAQhE,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG;IACzC,8EAA8E;IAC9E,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAChC,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,QAAQ,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACzD,CAAC;AAYF,QAAA,MAAM,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CA+RjC,CAAC;AAKF,eAAe,MAAM,CAAC"}