@3driseai/3drise-viewer 0.1.25 → 0.1.27

package/dist/hooks/useInteraction.js

@@ -1,283 +1,102 @@
 /**
- * useInteraction.ts
+ * useInteraction — runs an object's interactions.
  *
- * Hook for handling Interactions on scene objects.
- * Provides executeInteraction function and utility functions for:
- * - Resolving target objects
- * - Executing operations
- * - Triggering animations
+ * An interaction (core `Interaction`) is a trigger plus three kinds of reaction,
+ * run in this order:
+ *
+ *   effects     operations on their targets, through the shared operations runtime
+ *               (../operations) — a triggered interaction toggles an operation that
+ *               can be undone, and applies one that can't. 'self' = the object the
+ *               interaction is on.
+ *   animations  play / pause / stop / toggle a clip or a sequence (ClipsRuntime).
+ *               play starts from the beginning, or resumes if paused; toggle plays
+ *               forward, then back — "back" is the opposite of a sequence's own
+ *               reverse.
+ *   actions     apply / revert / toggle an action (SceneActions; its own effects
+ *               run through the same runtime).
  */
-import { useCallback, useRef } from 'react';
-import { AnimationsManager, SceneActions, texturesManager } from '@3driseai/3drise-core';
-import useCameraAnimation from '../hooks/useCameraAnimation.js';
-import { useFrameAnimations } from '../hooks/useFrameAnimations.js';
-import { useObjectEffects } from '../hooks/useObjectEffects.js';
-import { findById } from '../utils/sceneQuery.js';
-// =============================================================================
-// TYPES
-// =============================================================================
-// =============================================================================
-// HOOK
-// =============================================================================
-export function useInteraction({ 
-// mode = 'default',
-cameraSettings, sequences, actionSequences = [], }) {
-    // Redux state
-    // Track currently animated object for toggle behavior
-    const currentAnimatedRef = useRef(null);
-    // Animation ids whose last toggle played forward — the next toggle plays them reversed.
-    const toggledAnimationsRef = useRef(new Set());
-    // Hooks
-    const { animateCamera } = useCameraAnimation({
-        autoAnimate: false,
-        defaultDuration: 1,
-        defaultEase: "power2.out"
-    });
-    const { moveToFront, zoomToFrame, restoreOriginalTransform, restoreCamera } = useFrameAnimations(cameraSettings);
-    const { vanishObject, restoreVanishedObject, animateGlowEffect, removeGlow, isVanished, isGlowing, glowingObjects, vanishedObjects, } = useObjectEffects();
-    // ===========================================================================
-    // UTILITY: Resolve Target Objects
-    // ===========================================================================
-    const resolveTargets = useCallback((interaction, currentRef) => {
-        const { targetIds, targetMode } = interaction;
-        // If no targetIds specified, return current object only
-        if (!targetIds || targetIds.length === 0) {
-            return [currentRef];
-        }
-        const targetRefs = [];
-        // Add current object if mode is 'add'
-        if (targetMode === 'add') {
-            targetRefs.push(currentRef);
-        }
-        // Lookup targets from scene
-        targetIds.forEach(id => {
-            const obj = findById(id);
-            if (obj) {
-                targetRefs.push(obj);
-            }
-        });
-        return targetRefs.length > 0 ? targetRefs : [currentRef];
+import { useCallback, useMemo, useRef } from 'react';
+import { SceneActions } from '@3driseai/3drise-core';
+import ClipsRuntime from '../animationsV2/ClipsRuntime.js';
+import { clipMap } from '../animationsV2/sequenceUtils.js';
+import { runEffect } from '../operations/runtime.js';
+import { useOperationsRuntime } from '../operations/useOperationsRuntime.js';
+export function useInteraction({ cameraSettings, sequences = [], clips = [], actionSequences = [], }) {
+    // The scene's operation tools (camera, bring-to-front…) for the shared runtime.
+    useOperationsRuntime(cameraSettings);
+    // Toggle state: animation ids whose last toggle went "forward".
+    const toggledRef = useRef(new Set());
+    const clipsById = useMemo(() => clipMap(clips), [clips]);
+    /** First trigger → forward (false), next → back (true), … per key. */
+    const nextIsBack = useCallback((key) => {
+        const toggled = toggledRef.current;
+        const back = toggled.has(key);
+        if (back)
+            toggled.delete(key);
+        else
+            toggled.add(key);
+        return back;
     }, []);
-    // ===========================================================================
-    // UTILITY: Trigger Animations
-    // ===========================================================================
-    // 'toggle' in an interaction's operations is a modifier, not an effect of its own:
-    // it makes that interaction's animations and actions two-state. Animations play
-    // forward then reversed; actions apply then revert (their patches are removed).
-    const triggerAnimations = useCallback((animationIds, toggle = false) => {
-        if (!animationIds || animationIds.length === 0)
+    // ---------------------------------------------------------------- run
+    const executeInteraction = useCallback((params) => {
+        const { interaction, ref } = params;
+        if (!interaction?.enabled)
             return;
-        animationIds.forEach(animationId => {
-            const sequence = sequences.find(s => s.id === animationId);
-            if (!sequence)
-                return;
-            if (!toggle) {
-                AnimationsManager.playSequence(sequence);
-                return;
+        // 1. Effects — each on its own targets.
+        for (const effect of interaction.effects ?? [])
+            runEffect(effect, 'trigger', ref);
+        // 2. Animations.
+        for (const a of interaction.animations ?? []) {
+            if (a.kind === 'clip') {
+                const clip = clipsById.get(a.ref);
+                if (!clip)
+                    continue;
+                if (a.command === 'pause')
+                    ClipsRuntime.pause(clip.id);
+                else if (a.command === 'stop')
+                    ClipsRuntime.stop(clip.id);
+                else if (a.command === 'toggle')
+                    ClipsRuntime.play(clip, { reverse: nextIsBack(`clip:${clip.id}`) });
+                else if (ClipsRuntime.isActive(clip.id) && !ClipsRuntime.isPlaying(clip.id) && ClipsRuntime.getTime(clip.id) < clip.duration)
+                    ClipsRuntime.resume(clip.id);
+                else
+                    ClipsRuntime.play(clip, { from: 0 });
             }
-            const toggled = toggledAnimationsRef.current;
-            const reverse = toggled.has(animationId);
-            if (reverse)
-                toggled.delete(animationId);
-            else
-                toggled.add(animationId);
-            AnimationsManager.playSequence(sequence, { reverse });
-        });
-    }, [sequences]);
-    // ===========================================================================
-    // UTILITY: Trigger Actions (instant)
-    // ===========================================================================
-    const triggerActions = useCallback((actionIds, toggle = false) => {
-        if (!actionIds || actionIds.length === 0)
-            return;
-        actionIds.forEach(actionId => {
-            const action = actionSequences.find(a => a.id === actionId);
-            if (!action)
-                return;
-            if (toggle)
-                SceneActions.toggleAction(action);
-            else
-                SceneActions.applyAction(action);
-        });
-    }, [actionSequences]);
-    // ===========================================================================
-    // UTILITY: Execute Single Operation
-    // ===========================================================================
-    const executeOperation = useCallback(async (operation, ref, createdObject, textureUrl) => {
-        if (!operation || operation === 'none')
-            return;
-        const defaultDuration = 1.0;
-        const defaultEase = "power2.out";
-        const defaultDistance = 2.0;
-        const isCurrentlySelected = currentAnimatedRef.current !== null;
-        const isSameObject = currentAnimatedRef.current?.uuid === ref.uuid;
-        switch (operation) {
-            case 'vanish': {
-                if (isVanished(ref.uuid)) {
-                    restoreVanishedObject(ref, defaultDuration, defaultEase);
+            else {
+                const seq = sequences.find(s => s.id === a.ref);
+                if (!seq)
+                    continue;
+                if (a.command === 'pause')
+                    ClipsRuntime.pauseSequence(seq.id);
+                else if (a.command === 'stop')
+                    ClipsRuntime.stopSequence(seq.id);
+                else if (a.command === 'toggle') {
+                    const back = nextIsBack(`seq:${seq.id}`);
+                    ClipsRuntime.playSequence(seq, clipsById, { reverse: back ? !seq.reverse : seq.reverse });
                 }
-                else {
-                    vanishObject(ref, defaultDuration, defaultEase);
-                }
-                break;
-            }
-            case 'glow': {
-                if (isGlowing(ref.uuid)) {
-                    removeGlow(ref);
+                else if (ClipsRuntime.isSequenceActive(seq.id) && !ClipsRuntime.isSequencePlaying(seq.id) && ClipsRuntime.getSequenceProgress(seq.id) < 1) {
+                    ClipsRuntime.resumeSequence(seq.id);
                 }
                 else {
-                    animateGlowEffect(ref);
-                }
-                break;
-            }
-            case 'focus': {
-                animateCamera({}, defaultDuration, defaultEase, createdObject.meshSettings.position);
-                break;
-            }
-            case 'moveToFront': {
-                // Toggle: if clicking the same object, restore it
-                if (isCurrentlySelected && isSameObject) {
-                    restoreOriginalTransform(currentAnimatedRef.current, {
-                        duration: defaultDuration,
-                        ease: defaultEase
-                    });
-                    currentAnimatedRef.current = null;
-                    return;
-                }
-                // Restore previous object if different
-                if (isCurrentlySelected && !isSameObject) {
-                    restoreOriginalTransform(currentAnimatedRef.current, {
-                        duration: defaultDuration,
-                        ease: defaultEase
-                    });
-                }
-                // Apply new animation
-                moveToFront(ref, {
-                    distance: defaultDistance,
-                    scale: [6, 4],
-                    duration: defaultDuration,
-                    ease: defaultEase
-                });
-                currentAnimatedRef.current = ref;
-                break;
-            }
-            case 'zoom': {
-                // Toggle: if clicking the same object, restore camera
-                if (isCurrentlySelected && isSameObject) {
-                    restoreCamera({ duration: defaultDuration, ease: defaultEase });
-                    currentAnimatedRef.current = null;
-                    return;
-                }
-                // Restore previous camera if different object
-                if (isCurrentlySelected && !isSameObject) {
-                    restoreCamera({ duration: defaultDuration, ease: defaultEase });
-                }
-                // Apply new zoom
-                zoomToFrame(ref, {
-                    distance: defaultDistance,
-                    duration: defaultDuration,
-                    ease: defaultEase
-                });
-                currentAnimatedRef.current = ref;
-                break;
-            }
-            case 'playAnimation':
-                // Handled by triggerAnimations
-                break;
-            case 'displayImage': {
-                if (!textureUrl)
-                    break;
-                let applier;
-                let meshWithMap = null;
-                ref.traverse((child) => {
-                    if (!applier && typeof child.userData?.applyTexture === 'function') {
-                        applier = child.userData.applyTexture;
-                    }
-                    else if (!meshWithMap && child.material) {
-                        meshWithMap = child;
-                    }
-                });
-                if (applier) {
-                    applier(textureUrl);
+                    // From the start edge of its own direction.
+                    const total = ClipsRuntime.getSequenceDuration(seq.id);
+                    ClipsRuntime.playSequence(seq, clipsById, { from: seq.reverse && total > 0 ? total : 0 });
                 }
-                else if (meshWithMap) {
-                    const name = textureUrl.split('/').pop()?.split('.')[0] || `texture-${Date.now()}`;
-                    try {
-                        const loaded = await texturesManager.loadTexture(name, textureUrl, 'images');
-                        const mat = meshWithMap.material;
-                        mat.map = loaded;
-                        mat.needsUpdate = true;
-                    }
-                    catch (err) {
-                    }
-                }
-                break;
             }
-            case 'toggle':
-                // Modifier for animationIds/actionIds — handled in executeInteraction.
-                break;
-            case 'create':
-            case 'update':
-            case 'delete':
-            case 'loadProject':
-                break;
         }
-    }, [
-        isVanished,
-        isGlowing,
-        vanishObject,
-        restoreVanishedObject,
-        animateGlowEffect,
-        removeGlow,
-        animateCamera,
-        moveToFront,
-        zoomToFrame,
-        restoreOriginalTransform,
-        restoreCamera,
-    ]);
-    // ===========================================================================
-    // UTILITY: Execute Multiple Operations
-    // ===========================================================================
-    const executeOperations = useCallback((operations, ref, createdObject, textureUrl) => {
-        if (!operations || operations.length === 0)
-            return;
-        operations.forEach(operation => {
-            executeOperation(operation, ref, createdObject, textureUrl);
-        });
-    }, [executeOperation]);
-    // ===========================================================================
-    // MAIN: Execute Interaction
-    // ===========================================================================
-    const executeInteraction = useCallback((params) => {
-        const { interaction, ref, createdObject } = params;
-        if (!interaction.enabled)
-            return;
-        let textureUrl = undefined;
-        if (interaction.operations?.includes('displayImage')) {
-            textureUrl = ref.userData?.url;
+        // 3. Actions.
+        for (const a of interaction.actions ?? []) {
+            const action = actionSequences.find(x => x.id === a.ref);
+            if (!action)
+                continue;
+            if (a.command === 'revert')
+                SceneActions.revertAction(action);
+            else if (a.command === 'toggle')
+                SceneActions.toggleAction(action);
+            else
+                SceneActions.applyAction(action);
         }
-        // 1. Resolve target objects
-        const targets = resolveTargets(interaction, ref);
-        // 2. Execute operations on each target
-        targets.forEach(targetRef => {
-            // Find the createdObject for this target (if different from original)
-            // For now, use the original createdObject for position data
-            executeOperations(interaction.operations, targetRef, createdObject, textureUrl);
-        });
-        // 3. Trigger animations and actions ('toggle' makes both two-state)
-        const toggle = interaction.operations?.includes('toggle') ?? false;
-        triggerAnimations(interaction.animationIds, toggle);
-        triggerActions(interaction.actionIds, toggle);
-    }, [resolveTargets, executeOperations, triggerAnimations, triggerActions]);
-    // ===========================================================================
-    // RETURN
-    // ===========================================================================
-    return {
-        executeInteraction,
-        // Expose refs for context to share
-        currentAnimatedRef,
-        glowingObjects,
-        vanishedObjects,
-    };
+    }, [clipsById, sequences, actionSequences, nextIsBack]);
+    return { executeInteraction };
 }
 export default useInteraction;

package/dist/hooks/useLandscapeMaps.d.ts

@@ -1,5 +1,5 @@
 import { type DecodedHeightmap } from '../utils/landscapeTextures';
-import type { LandscapeConfig, LandscapeQualityConfig } from '../types/landscapeConfigs';
+import type { LandscapeConfig, LandscapeQualityConfig } from '@3driseai/3drise-core';
 import type { LandscapeMapUniforms } from '../utils/landscapeUniforms';
 /**
  * Every image a landscape needs, loaded and packed.

package/dist/hooks/useLandscapeMaps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useLandscapeMaps.d.ts","sourceRoot":"","sources":["../../src/hooks/useLandscapeMaps.ts"],"names":[],"mappings":"AAEA,OAAO,EAOH,KAAK,gBAAgB,EACxB,MAAM,4BAA4B,CAAA;AACnC,OAAO,KAAK,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAA;AACxF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAEtE;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;IAC5D,kEAAkE;IAClE,WAAW,EAAE,gBAAgB,GAAG,IAAI,CAAA;IACpC,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAA;CACrB;AA4CD,wBAAgB,gBAAgB,CAC5B,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,sBAAsB,GAChC,kBAAkB,CAmHpB;AAED,eAAe,gBAAgB,CAAA"}
+{"version":3,"file":"useLandscapeMaps.d.ts","sourceRoot":"","sources":["../../src/hooks/useLandscapeMaps.ts"],"names":[],"mappings":"AAEA,OAAO,EAOH,KAAK,gBAAgB,EACxB,MAAM,4BAA4B,CAAA;AACnC,OAAO,KAAK,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AACpF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAEtE;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;IAC5D,kEAAkE;IAClE,WAAW,EAAE,gBAAgB,GAAG,IAAI,CAAA;IACpC,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAA;CACrB;AA4CD,wBAAgB,gBAAgB,CAC5B,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,sBAAsB,GAChC,kBAAkB,CAmHpB;AAED,eAAe,gBAAgB,CAAA"}

package/dist/hooks/useObjectAnimation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useObjectAnimation.d.ts","sourceRoot":"","sources":["../../src/hooks/useObjectAnimation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAEzE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAE3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,UAAU,yBAAyB;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,UAAU,wBAAyB,SAAQ,0BAA0B,EAAE,2BAA2B;CACjG;AAGD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,GAAI,gBAAgB,qBAAqB,GAAG,IAAI,EAAE,iBAAiB,OAAO,EAAE,UAAS,yBAA8B,EAAE,SAAS,cAAc,KAAG,wBAAwB,GAAG,IAexM,CAAC"}
+{"version":3,"file":"useObjectAnimation.d.ts","sourceRoot":"","sources":["../../src/hooks/useObjectAnimation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAEzE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,UAAU,yBAAyB;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,UAAU,wBAAyB,SAAQ,0BAA0B,EAAE,2BAA2B;CACjG;AAGD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,GAAI,gBAAgB,qBAAqB,GAAG,IAAI,EAAE,iBAAiB,OAAO,EAAE,UAAS,yBAA8B,EAAE,SAAS,cAAc,KAAG,wBAAwB,GAAG,IAcxM,CAAC"}

package/dist/hooks/useObjectAnimation.js

@@ -3,7 +3,6 @@ import { useFrame } from '@react-three/fiber';
 import { findById } from '@3driseai/3drise-core';
 import { useContinuousEffects } from "./useContinuousEffects.js";
 import { useMouseMove } from "./useInteractionEffects.js";
-import { useSequenceAnimation } from "./useSequenceAnimation.js";
 /**
  * Drive every continuous animation for one scene object.
  *
@@ -28,6 +27,5 @@ export const useObjectAnimation = (objectSettings, animateMaterial, options = {}
     const source = object ?? fallbackRef;
     const continuousResult = useContinuousEffects(objectSettings, { enabled, animateMaterial, hovered }, source);
     const mouseMoveResult = useMouseMove(objectSettings, { enabled, animateMaterial }, source);
-    useSequenceAnimation(objectSettings?.id, source);
     return { ...continuousResult, ...mouseMoveResult };
 };

package/dist/hooks/useOceanMaterial.d.ts

@@ -2,7 +2,7 @@ import * as THREE from 'three';
 import { type RootState } from '@react-three/fiber';
 import type { SkySettings, TimeSettings } from '@3driseai/3drise-core';
 import { OceanSurfaceMaterial } from '../shaders/ocean/OceanSurfaceMaterial';
-import type { OceanConfig, OceanQualityConfig } from '../types/oceanConfigs';
+import type { OceanConfig, OceanQualityConfig } from '@3driseai/3drise-core';
 /**
  * Everything the two water hosts share: the material, the live-edit handle, and
  * the per-frame uniform push.

package/dist/hooks/useOceanMaterial.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useOceanMaterial.d.ts","sourceRoot":"","sources":["../../src/hooks/useOceanMaterial.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAIvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAI7E,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE7E;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,uBAAuB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;gFAE4E;IAC5E,OAAO,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;CACtF;AAED,MAAM,WAAW,mBAAmB;IAChC,QAAQ,EAAE,oBAAoB,CAAC;IAC/B;0DACsD;IACtD,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;CAChD;AAED,wBAAgB,gBAAgB,CAAC,EAC7B,EAAE,EACF,MAAM,EACN,OAAO,EACP,WAAW,EACX,YAAY,EACZ,YAAgB,EAChB,OAAO,GACV,EAAE,uBAAuB,GAAG,mBAAmB,CAuE/C;AAED,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"useOceanMaterial.d.ts","sourceRoot":"","sources":["../../src/hooks/useOceanMaterial.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAI7E,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE7E;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,uBAAuB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;gFAE4E;IAC5E,OAAO,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;CACtF;AAED,MAAM,WAAW,mBAAmB;IAChC,QAAQ,EAAE,oBAAoB,CAAC;IAC/B;0DACsD;IACtD,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;CAChD;AAED,wBAAgB,gBAAgB,CAAC,EAC7B,EAAE,EACF,MAAM,EACN,OAAO,EACP,WAAW,EACX,YAAY,EACZ,YAAgB,EAChB,OAAO,GACV,EAAE,uBAAuB,GAAG,mBAAmB,CAkE/C;AAED,eAAe,gBAAgB,CAAC"}

package/dist/hooks/useOceanMaterial.js

@@ -1,7 +1,6 @@
 import { useEffect, useMemo, useRef } from 'react';
 import { useFrame } from '@react-three/fiber';
 import { useCloudSun } from './useCloudSun.js';
-import { useLiveTransitionEvents } from './useLiveTransitionEvents.js';
 import { OCEAN_LIVE_KEY } from './useOceanLive.js';
 import { OceanSurfaceMaterial } from '../shaders/ocean/OceanSurfaceMaterial.js';
 import { applySunUniforms } from '../utils/cloudUniforms.js';
@@ -36,10 +35,6 @@ export function useOceanMaterial({ id, config, quality, skySettings, timeSetting
         root.userData[OCEAN_LIVE_KEY] = liveHandle;
         return () => { delete root.userData[OCEAN_LIVE_KEY]; };
     }, [id, liveHandle]);
-    // Sequence-authored transitions (`transition.state === 'ocean'`) — shared by
-    // both hosts (OceanSurface, WaterBody), the same way the material and the
-    // live handle already are.
-    useLiveTransitionEvents('ocean', liveConfig, config, rootRef);
     useFrame((state) => {
         const shader = material;
         updateSun();

package/dist/hooks/useRuntimeSettings.d.ts

@@ -2,7 +2,7 @@
  * An element's settings with any applied action patches laid over them.
  *
  * `state` is the element's action address: its object id, or 'camera' | 'sky' |
- * 'ocean' | 'clouds'. Subscribes to that one element only, so applying an action
+ * 'ocean' | 'clouds' | 'terrain'. Subscribes to that one element only, so applying an action
  * re-renders the elements it touches and nothing else. With no patch applied this
  * returns `base` itself — no copy, no identity change.
  *

package/dist/hooks/useRuntimeSettings.js

@@ -5,7 +5,7 @@ const noopUnsubscribe = () => { };
  * An element's settings with any applied action patches laid over them.
  *
  * `state` is the element's action address: its object id, or 'camera' | 'sky' |
- * 'ocean' | 'clouds'. Subscribes to that one element only, so applying an action
+ * 'ocean' | 'clouds' | 'terrain'. Subscribes to that one element only, so applying an action
  * re-renders the elements it touches and nothing else. With no patch applied this
  * returns `base` itself — no copy, no identity change.
  *

package/dist/hooks/useThunder.d.ts

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import type { CloudDeckConfig, ThunderConfig } from '../types/cloudConfigs';
+import type { CloudDeckConfig, ThunderConfig } from '@3driseai/3drise-core';
 /**
  * Flash scheduling for lightning.
  *

package/dist/index.d.ts

@@ -1,16 +1,18 @@
-export type { AnimationEvent, AnimationEventType, FontInfo } from '@3driseai/3drise-core';
+export type { FontInfo } from '@3driseai/3drise-core';
 export { AnimationsManager as animationsManager, fontManager } from '@3driseai/3drise-core';
 export * from './types';
 export * from './components';
 export * from './hooks';
 export { createSceneHandle } from './api/sceneHandle';
-export type { SceneHandle, SceneHandleEvent, SceneHandleEventType, SceneActionInfo, SceneAnimationInfo, ScenePlayOptions } from './api/sceneHandle';
+export * from './animationsV2';
+export * from './interactions';
+export * from './operations';
+export type { SceneHandle, SceneHandleEvent, SceneHandleEventType, SceneActionInfo, SceneClipInfo, SceneSequenceInfo, ScenePlayOptions, ScenePlayback } from './api/sceneHandle';
 export type { PathAnimationOptions as PathAnimationHookOptions } from './hooks/usePathAnimation';
 export { cameraManager } from './utils/CameraSingleton';
 export { applyAnchorSettings, createCurves, createSunPosition, randomRange, } from './utils/utils3d';
 export { applyAnchorSettings as applyAnchorSettingsLegacy } from './utils/anchorUtils';
 export * from './utils/shapes';
-export { applyGenerativeAnimations } from './utils/handleGenerativeEffectsAnimations';
 export { hasHoverAnimation } from './utils/hasHoverAnimation';
 export { findById } from './utils/sceneQuery';
 export { hasFrameRenderer, registerFrameRenderer, renderFrame } from './utils/frameRenderer';
@@ -32,7 +34,7 @@ export { applyOceanUniforms, buildWaveTable, seaState } from './utils/oceanUnifo
 export type { WaveTable } from './utils/oceanUniforms';
 export { applyCameraUniforms, applyCirrusUniforms, applyDeckUniforms, applySunUniforms, applyThunderUniforms, } from './utils/cloudUniforms';
 export { applyCloudsKeyframeAnimations, applyCloudsMouseMove, resolveDeckConfig, } from './utils/handleCloudsAnimations';
-export { applyConfigKeyframeAnimations, applyConfigMouseMove, hasConfigOverrides, resolveConfig, } from './utils/configAnimations';
+export { applyConfigKeyframeAnimations, applyConfigMouseMove, hasConfigOverrides, resolveConfig, withConfigDefaults, } from './utils/configAnimations';
 export type { ConfigOverride, ConfigStartValues } from './utils/configAnimations';
 export { volumetricCloudPresets, cirrusPresets, getCloudPresetsForType, getCloudPresetByName, getCirrusPresetByName, searchCloudPresetsByTags, } from './presets/volumetricCloudPresets';
 export type { VolumetricCloudPreset, CirrusPreset } from './presets/volumetricCloudPresets';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -8,12 +8,14 @@ export * from './components/index.js';
 export * from './hooks/index.js';
 // External control of a loaded project (ProjectLoader ref / onSceneReady)
 export { createSceneHandle } from './api/sceneHandle.js';
+export * from './animationsV2/index.js';
+export * from './interactions/index.js';
+export * from './operations/index.js';
 // Utils
 export { cameraManager } from './utils/CameraSingleton.js';
 export { applyAnchorSettings, createCurves, createSunPosition, randomRange, } from './utils/utils3d.js';
 export { applyAnchorSettings as applyAnchorSettingsLegacy } from './utils/anchorUtils.js';
 export * from './utils/shapes.js';
-export { applyGenerativeAnimations } from './utils/handleGenerativeEffectsAnimations.js';
 export { hasHoverAnimation } from './utils/hasHoverAnimation.js';
 export { findById } from './utils/sceneQuery.js';
 export { hasFrameRenderer, registerFrameRenderer, renderFrame } from './utils/frameRenderer.js';
@@ -28,7 +30,7 @@ export { buildTextureArray, decodeHeightmap, loadImage } from './utils/landscape
 export { applyOceanUniforms, buildWaveTable, seaState } from './utils/oceanUniforms.js';
 export { applyCameraUniforms, applyCirrusUniforms, applyDeckUniforms, applySunUniforms, applyThunderUniforms, } from './utils/cloudUniforms.js';
 export { applyCloudsKeyframeAnimations, applyCloudsMouseMove, resolveDeckConfig, } from './utils/handleCloudsAnimations.js';
-export { applyConfigKeyframeAnimations, applyConfigMouseMove, hasConfigOverrides, resolveConfig, } from './utils/configAnimations.js';
+export { applyConfigKeyframeAnimations, applyConfigMouseMove, hasConfigOverrides, resolveConfig, withConfigDefaults, } from './utils/configAnimations.js';
 // Presets
 export { volumetricCloudPresets, cirrusPresets, getCloudPresetsForType, getCloudPresetByName, getCirrusPresetByName, searchCloudPresetsByTags, } from './presets/volumetricCloudPresets.js';
 export { terrainPresets, getTerrainPresetsForType, getTerrainPresetByName, searchTerrainPresetsByTags, } from './presets/terrainPresets.js';

package/dist/interactions/index.d.ts

@@ -0,0 +1,4 @@
+export { runInteraction, setInteractionRunner, previewInteractionEffect, setEffectPreviewer, prewarmInteractionEffect, setEffectPrewarmer, ObjectHoverContext } from './runner';
+export type { RunOptions } from './runner';
+export type { ObjectHoverHandler } from './runner';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interactions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAChL,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC"}

package/dist/interactions/index.js

@@ -0,0 +1 @@
+export { runInteraction, setInteractionRunner, previewInteractionEffect, setEffectPreviewer, prewarmInteractionEffect, setEffectPrewarmer, ObjectHoverContext } from './runner.js';

package/dist/interactions/runner.d.ts

@@ -0,0 +1,24 @@
+import type { CreatedObjectSettings, Interaction, OperationEffect } from '@3driseai/3drise-core';
+/** preview: effects play and then put everything back (the studio's "Try it"). */
+export interface RunOptions {
+    preview?: boolean;
+}
+type Runner = (objectId: string, interaction: Interaction, opts?: RunOptions) => boolean;
+type EffectPreviewer = (objectId: string, effect: OperationEffect) => Promise<boolean>;
+type EffectPrewarmer = (objectId: string, effect: OperationEffect) => Promise<void>;
+export declare function setInteractionRunner(next: Runner): () => void;
+/** Run an interaction now. False when no scene is mounted or the object is not there. */
+export declare function runInteraction(objectId: string, interaction: Interaction, opts?: RunOptions): boolean;
+export declare function setEffectPreviewer(next: EffectPreviewer): () => void;
+/**
+ * Play one effect of an interaction on object `objectId` ('self' resolves to it)
+ * and bring the scene back afterwards. False when no scene is mounted.
+ */
+export declare function setEffectPrewarmer(next: EffectPrewarmer): () => void;
+/** Compile an interaction effect's shaders ahead of time (no visible change), so its first play is instant. */
+export declare function prewarmInteractionEffect(objectId: string, effect: OperationEffect): Promise<void>;
+export declare function previewInteractionEffect(objectId: string, effect: OperationEffect): Promise<boolean>;
+export type ObjectHoverHandler = (createdObject: CreatedObjectSettings, ref: any, trigger: 'mouseEnter' | 'mouseLeave') => void;
+export declare const ObjectHoverContext: import("react").Context<ObjectHoverHandler>;
+export {};
+//# sourceMappingURL=runner.d.ts.map

package/dist/interactions/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/interactions/runner.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAEjG,kFAAkF;AAClF,MAAM,WAAW,UAAU;IAAG,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE;AACjD,KAAK,MAAM,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,UAAU,KAAK,OAAO,CAAC;AACzF,KAAK,eAAe,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEvF,KAAK,eAAe,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAIpF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,IAAI,CAG7D;AAED,yFAAyF;AACzF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAErG;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,IAAI,CAGpE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,IAAI,CAGpE;AAED,+GAA+G;AAC/G,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjG;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAEpG;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,aAAa,EAAE,qBAAqB,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,YAAY,GAAG,YAAY,KAAK,IAAI,CAAC;AAChI,eAAO,MAAM,kBAAkB,6CAAiD,CAAC"}