@3driseai/3drise-viewer 0.1.25 → 0.1.26

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/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.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/index.d.ts

@@ -1,10 +1,13 @@
-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';

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":"AACA,YAAY,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD,OAAO,EAAE,iBAAiB,IAAI,iBAAiB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAG5F,cAAc,SAAS,CAAC;AAGxB,cAAc,cAAc,CAAC;AAG7B,cAAc,SAAS,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,eAAe,EAAE,aAAa,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEjL,YAAY,EAAE,oBAAoB,IAAI,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAGjG,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,iBAAiB,EAAE,WAAW,GAAG,MAAM,iBAAiB,CAAC;AACrG,OAAO,EAAE,mBAAmB,IAAI,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AACvF,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAC7F,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC/E,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACvF,YAAY,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EACL,oBAAoB,EACpB,4BAA4B,EAC5B,qBAAqB,EACrB,eAAe,EACf,8BAA8B,GAC/B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpG,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnF,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC1F,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACrF,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,6BAA6B,EAC7B,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,6BAA6B,EAC7B,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,GACd,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGlF,OAAO,EACL,sBAAsB,EACtB,aAAa,EACb,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAC5F,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,gBAAgB,EAChB,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,sBAAsB,EACtB,eAAe,EACf,uBAAuB,GACxB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,yBAAyB,EACzB,eAAe,EACf,kBAAkB,EAClB,yBAAyB,EACzB,cAAc,EACd,eAAe,EACf,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,yBAAyB,EACzB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/index.js

@@ -8,6 +8,9 @@ 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';

package/dist/interactions/index.d.ts

@@ -0,0 +1,3 @@
+export { runInteraction, setInteractionRunner, ObjectHoverContext } 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,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACpF,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC"}

package/dist/interactions/index.js

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

package/dist/interactions/runner.d.ts

@@ -0,0 +1,9 @@
+import type { CreatedObjectSettings, Interaction } from '@3driseai/3drise-core';
+type Runner = (objectId: string, interaction: Interaction) => boolean;
+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): 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,MAAM,uBAAuB,CAAC;AAEhF,KAAK,MAAM,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,KAAK,OAAO,CAAC;AAGtE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,IAAI,CAG7D;AAED,yFAAyF;AACzF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,OAAO,CAElF;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"}

package/dist/interactions/runner.js

@@ -0,0 +1,23 @@
+// =============================================================================
+// Interaction runner + hover bridge
+// =============================================================================
+//
+// runInteraction(objectId, interaction) — run an interaction as if it were
+// triggered (the studio's "Try it"). ObjectsRenderer registers the runner.
+//
+// ObjectHoverContext — ObjectsRenderer hands CreatedObject the hover handler, so
+// 'mouseEnter' / 'mouseLeave' interactions fire without threading a prop through
+// every renderer.
+//
+import { createContext } from 'react';
+let runner = null;
+export function setInteractionRunner(next) {
+    runner = next;
+    return () => { if (runner === next)
+        runner = null; };
+}
+/** Run an interaction now. False when no scene is mounted or the object is not there. */
+export function runInteraction(objectId, interaction) {
+    return runner ? runner(objectId, interaction) : false;
+}
+export const ObjectHoverContext = createContext(null);

package/dist/operations/catalogue/displayImage.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("..").OperationDefinition;
+export default _default;
+//# sourceMappingURL=displayImage.d.ts.map

package/dist/operations/catalogue/displayImage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"displayImage.d.ts","sourceRoot":"","sources":["../../../src/operations/catalogue/displayImage.ts"],"names":[],"mappings":";AAGA,wBA4BG"}

package/dist/operations/catalogue/displayImage.js

@@ -0,0 +1,39 @@
+import { texturesManager } from '@3driseai/3drise-core';
+import { defineOperation } from '../types.js';
+export default defineOperation({
+    value: 'displayImage',
+    label: 'Show image',
+    description: "Show the clicked frame's image on the target",
+    multi: false,
+    toggles: false,
+    usableIn: ['interaction'],
+    galleryOnly: true,
+    async apply(target, _p, ctx) {
+        const url = ctx.self?.userData?.url;
+        if (!url)
+            return;
+        let applier;
+        let meshWithMap = null;
+        target.traverse((child) => {
+            if (!applier && typeof child.userData?.applyTexture === 'function')
+                applier = child.userData.applyTexture;
+            else if (!meshWithMap && child.material)
+                meshWithMap = child;
+        });
+        if (applier) {
+            applier(url);
+            return;
+        }
+        if (!meshWithMap)
+            return;
+        const name = url.split('/').pop()?.split('.')[0] || `texture-${Date.now()}`;
+        try {
+            const loaded = await texturesManager.loadTexture(name, url, 'images');
+            meshWithMap.material.map = loaded;
+            meshWithMap.material.needsUpdate = true;
+        }
+        catch {
+            // a missing image leaves the target as it was
+        }
+    },
+});

package/dist/operations/catalogue/fade.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("..").OperationDefinition;
+export default _default;
+//# sourceMappingURL=fade.d.ts.map

package/dist/operations/catalogue/fade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fade.d.ts","sourceRoot":"","sources":["../../../src/operations/catalogue/fade.ts"],"names":[],"mappings":";AAMA,wBAoCG"}

package/dist/operations/catalogue/fade.js

@@ -0,0 +1,44 @@
+import { gsap } from 'gsap';
+import { defineOperation } from '../types.js';
+import { forEachMaterial } from './materialFx.js';
+const KEY = '__opFade';
+export default defineOperation({
+    value: 'fade',
+    label: 'Fade out',
+    description: 'Fade the targets away (to a set opacity)',
+    multi: true,
+    toggles: true,
+    usableIn: ['interaction', 'action'],
+    params: {
+        opacity: { type: 'number', label: 'To opacity', default: 0, min: 0, max: 1, step: 0.05, hint: '0 hides the object when the fade ends' },
+        duration: { type: 'number', label: 'Duration', default: 1, min: 0, max: 10, step: 0.05, unit: 's' },
+    },
+    apply(target, p) {
+        const to = Number(p.opacity);
+        forEachMaterial(target, (mat) => {
+            if (!mat.userData[KEY])
+                mat.userData[KEY] = { opacity: mat.opacity, transparent: mat.transparent };
+            mat.transparent = true;
+            mat.needsUpdate = true;
+            gsap.killTweensOf(mat, 'opacity');
+            gsap.to(mat, {
+                opacity: to, duration: Number(p.duration), ease: 'power2.inOut',
+                onComplete: () => { if (to <= 0)
+                    target.visible = false; },
+            });
+        });
+    },
+    revert(target, p) {
+        target.visible = true;
+        forEachMaterial(target, (mat) => {
+            const orig = mat.userData[KEY];
+            if (!orig)
+                return;
+            gsap.killTweensOf(mat, 'opacity');
+            gsap.to(mat, {
+                opacity: orig.opacity, duration: Number(p.duration), ease: 'power2.inOut',
+                onComplete: () => { mat.transparent = orig.transparent; mat.needsUpdate = true; delete mat.userData[KEY]; },
+            });
+        });
+    },
+});