@3driseai/3drise-viewer 0.1.24 → 0.1.26

package/dist/hooks/useSequenceAnimation.js

@@ -15,6 +15,17 @@ function lerp(a, b, t) {
 function lerpVec3(a, b, t) {
     return [lerp(a[0], b[0], t), lerp(a[1], b[1], t), lerp(a[2], b[2], t)];
 }
+/** Transform lerp for one step at progress p (non-path). */
+function applyTransform(obj, step, p) {
+    obj.position.set(...lerpVec3(step.fromPosition, step.toPosition, p));
+    obj.rotation.set(...lerpVec3(step.fromRotation, step.toRotation, p));
+    obj.scale.set(...lerpVec3(step.fromScale, step.toScale, p));
+}
+/** Transform + material for one step at progress p (non-path). */
+function applyTransformAndMaterial(obj, step, p) {
+    applyTransform(obj, step, p);
+    interpolateMaterialProps(obj, step.materialFrom, step.materialTo, p);
+}
 /** Get material-related properties from a transition properties record */
 function extractMaterialProps(props) {
     if (!props)
@@ -67,7 +78,8 @@ export const useSequenceAnimation = (objectId, objectSource) => {
             const transition = event.step.transitions[transitionIndex];
             const stagger = event.step.stagger || 0;
             const staggerOffsetMs = transitionIndex * stagger * 1000;
-            const d = event.step.duration || 1;
+            // `?? 1`, not `|| 1`: a 0 duration is an instant change (actions), not a missing value.
+            const d = event.step.duration ?? 1;
             const ease = event.step.ease || 'linear';
             const { properties, pathId = null } = transition;
             // Visibility shortcut
@@ -120,6 +132,18 @@ export const useSequenceAnimation = (objectId, objectSource) => {
                 visibilityOverride: null,
                 pathId,
             });
+            // Instant step (an action, or a 0-length animation step): land on `to` now.
+            // The manager emits stepStart and sequenceEnd in the same tick for these, and
+            // sequenceEnd clears stepRef, so waiting for useFrame would apply nothing.
+            if (d === 0) {
+                stopPathAnimation();
+                if (resolvedObject && stepRef.current) {
+                    applyTransformAndMaterial(resolvedObject, stepRef.current, 1);
+                }
+                updateStepRef(null);
+                updateProgressRef(1);
+                return;
+            }
             updateProgressRef(0);
             if (pathId) {
                 startPathAnimation(pathId, d, { ease });
@@ -176,15 +200,9 @@ export const useSequenceAnimation = (objectId, objectSource) => {
             resolvedObject.scale.set(...sca);
         }
         else {
-            // — Transform —
-            const pos = lerpVec3(step.fromPosition, step.toPosition, p);
-            const rot = lerpVec3(step.fromRotation, step.toRotation, p);
-            const sca = lerpVec3(step.fromScale, step.toScale, p);
-            resolvedObject.position.set(...pos);
-            resolvedObject.rotation.set(...rot);
-            resolvedObject.scale.set(...sca);
+            applyTransform(resolvedObject, step, p);
         }
-        // — Material properties —
+        // Material properties
         interpolateMaterialProps(resolvedObject, step.materialFrom, step.materialTo, p);
         if (p >= 1) {
             updateProgressRef(1);

package/dist/index.d.ts

@@ -1,8 +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 * 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":"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"}

package/dist/index.js

@@ -6,6 +6,11 @@ export * from './types/index.js';
 export * from './components/index.js';
 // Hooks (hooks/index.ts owns the list)
 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]; },
+            });
+        });
+    },
+});

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

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

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

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

package/dist/operations/catalogue/focus.js

@@ -0,0 +1,22 @@
+import { Vector3 } from 'three';
+import { DEFAULT_EASE, defineOperation } from '../types.js';
+export default defineOperation({
+    value: 'focus',
+    label: 'Look at',
+    description: 'Turn the camera to face the target, without moving it',
+    multi: false,
+    toggles: true,
+    usableIn: ['interaction', 'action'],
+    exclusive: { group: 'camera', release: 'handover' },
+    params: {
+        duration: { type: 'number', label: 'Duration', default: 1, min: 0, max: 10, step: 0.05, unit: 's' },
+    },
+    apply(target, p, ctx) {
+        ctx.saveCameraHome();
+        const at = target.getWorldPosition(new Vector3());
+        void ctx.tools.animateCamera({}, Number(p.duration), DEFAULT_EASE, [at.x, at.y, at.z]);
+    },
+    revert(_target, p, ctx) {
+        ctx.restoreCameraHome(Number(p.duration), DEFAULT_EASE);
+    },
+});

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

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

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

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

package/dist/operations/catalogue/glow.js

@@ -0,0 +1,49 @@
+import { gsap } from 'gsap';
+import { defineOperation } from '../types.js';
+import { forEachMaterial, isLit, toColor } from './materialFx.js';
+const KEY = '__opGlow';
+export default defineOperation({
+    value: 'glow',
+    label: 'Glow',
+    description: 'Light the targets up with an emissive glow',
+    multi: true,
+    toggles: true,
+    usableIn: ['interaction', 'action'],
+    params: {
+        color: { type: 'color', label: 'Colour', default: '#3380ff' },
+        intensity: { type: 'number', label: 'Intensity', default: 3, min: 0, max: 20, step: 0.1 },
+        duration: { type: 'number', label: 'Duration', default: 0.4, min: 0, max: 10, step: 0.05, unit: 's' },
+    },
+    apply(target, p) {
+        const color = toColor(String(p.color));
+        forEachMaterial(target, (mat) => {
+            if (!isLit(mat))
+                return;
+            if (!mat.userData[KEY]) {
+                mat.userData[KEY] = { emissive: mat.emissive.getHex(), intensity: mat.emissiveIntensity, toneMapped: mat.toneMapped };
+            }
+            mat.toneMapped = false;
+            gsap.killTweensOf(mat);
+            gsap.killTweensOf(mat.emissive);
+            gsap.to(mat, { emissiveIntensity: Number(p.intensity), duration: Number(p.duration), ease: 'power2.out' });
+            gsap.to(mat.emissive, { r: color.r, g: color.g, b: color.b, duration: Number(p.duration), ease: 'power2.out' });
+        });
+    },
+    revert(target, p) {
+        forEachMaterial(target, (mat) => {
+            if (!isLit(mat))
+                return;
+            const orig = mat.userData[KEY];
+            if (!orig)
+                return;
+            const c = toColor('#000000').setHex(orig.emissive);
+            gsap.killTweensOf(mat);
+            gsap.killTweensOf(mat.emissive);
+            gsap.to(mat, {
+                emissiveIntensity: orig.intensity, duration: Number(p.duration), ease: 'power2.in',
+                onComplete: () => { mat.toneMapped = orig.toneMapped; delete mat.userData[KEY]; },
+            });
+            gsap.to(mat.emissive, { r: c.r, g: c.g, b: c.b, duration: Number(p.duration), ease: 'power2.in' });
+        });
+    },
+});

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

@@ -0,0 +1,6 @@
+import { Color, MeshStandardMaterial } from 'three';
+import type { Material, Object3D } from 'three';
+export declare function forEachMaterial(root: Object3D, fn: (mat: Material) => void): void;
+export declare const isLit: (m: Material) => m is MeshStandardMaterial;
+export declare const toColor: (hex: string) => Color;
+//# sourceMappingURL=materialFx.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"materialFx.d.ts","sourceRoot":"","sources":["../../../src/operations/catalogue/materialFx.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAwB,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAC1E,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEhD,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,QAM1E;AAED,eAAO,MAAM,KAAK,GAAI,GAAG,QAAQ,KAAG,CAAC,IAAI,oBACiC,CAAC;AAE3E,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,UAAmB,CAAC"}

package/dist/operations/catalogue/materialFx.js

@@ -0,0 +1,13 @@
+// Material helpers shared by glow / fade. Originals are kept on the material's
+// userData under op-specific keys, so glow and fade can stack and revert exactly.
+import { Color, MeshPhysicalMaterial, MeshStandardMaterial } from 'three';
+export function forEachMaterial(root, fn) {
+    root.traverse((child) => {
+        if (!child.isMesh && !child.isPoints && !child.isLine)
+            return;
+        const mats = Array.isArray(child.material) ? child.material : [child.material];
+        mats.forEach((m) => m && fn(m));
+    });
+}
+export const isLit = (m) => m instanceof MeshStandardMaterial || m instanceof MeshPhysicalMaterial;
+export const toColor = (hex) => new Color(hex);

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

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

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

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

package/dist/operations/catalogue/moveToFront.js

@@ -0,0 +1,25 @@
+import { DEFAULT_EASE, defineOperation } from '../types.js';
+export default defineOperation({
+    value: 'moveToFront',
+    label: 'Bring to front',
+    description: 'Bring the target in front of the camera',
+    multi: false,
+    toggles: true,
+    usableIn: ['interaction', 'action'],
+    exclusive: { group: 'front', release: 'revert' },
+    params: {
+        distance: { type: 'number', label: 'Distance', default: 2, min: 0.1, max: 100, step: 0.1 },
+        width: { type: 'number', label: 'Scale X', default: 6, min: 0.01, max: 100, step: 0.1 },
+        height: { type: 'number', label: 'Scale Y', default: 4, min: 0.01, max: 100, step: 0.1 },
+        duration: { type: 'number', label: 'Duration', default: 1, min: 0, max: 10, step: 0.05, unit: 's' },
+    },
+    apply(target, p, ctx) {
+        ctx.tools.moveToFront(target, {
+            distance: Number(p.distance), scale: [Number(p.width), Number(p.height)],
+            duration: Number(p.duration), ease: DEFAULT_EASE,
+        });
+    },
+    revert(target, p, ctx) {
+        ctx.tools.restoreTransform(target, { duration: Number(p.duration), ease: DEFAULT_EASE });
+    },
+});

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

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

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

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

package/dist/operations/catalogue/visibility.js

@@ -0,0 +1,24 @@
+import { defineOperation } from '../types.js';
+const KEY = '__opVisible';
+export default defineOperation({
+    value: 'visibility',
+    label: 'Show / hide',
+    description: 'Hide (or show) the targets instantly',
+    multi: true,
+    toggles: true,
+    usableIn: ['interaction', 'action'],
+    params: {
+        mode: { type: 'select', label: 'Make it', default: 'hide', options: [{ value: 'hide', label: 'Hidden' }, { value: 'show', label: 'Visible' }] },
+    },
+    apply(target, p) {
+        if (target.userData[KEY] === undefined)
+            target.userData[KEY] = target.visible;
+        target.visible = p.mode === 'show';
+    },
+    revert(target) {
+        if (target.userData[KEY] === undefined)
+            return;
+        target.visible = target.userData[KEY];
+        delete target.userData[KEY];
+    },
+});

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

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

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

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

package/dist/operations/catalogue/zoom.js

@@ -0,0 +1,32 @@
+import { Quaternion, Vector3 } from 'three';
+import { DEFAULT_EASE, defineOperation } from '../types.js';
+export default defineOperation({
+    value: 'zoom',
+    label: 'Zoom to',
+    description: 'Fly the camera close to the target, facing it',
+    multi: false,
+    toggles: true,
+    usableIn: ['interaction', 'action'],
+    exclusive: { group: 'camera', release: 'handover' },
+    params: {
+        distance: { type: 'number', label: 'Distance', default: 2, min: 0.1, max: 100, step: 0.1 },
+        duration: { type: 'number', label: 'Duration', default: 1, min: 0, max: 10, step: 0.05, unit: 's' },
+    },
+    apply(target, p, ctx) {
+        const pose = ctx.tools.cameraPose();
+        if (!pose)
+            return;
+        ctx.saveCameraHome();
+        const camPos = new Vector3(...pose.position);
+        const at = target.getWorldPosition(new Vector3());
+        // Stand in front of the target, on the side the camera is already on.
+        const forward = new Vector3(0, 0, 1).applyQuaternion(target.getWorldQuaternion(new Quaternion()));
+        if (forward.dot(camPos.clone().sub(at).normalize()) < 0)
+            forward.negate();
+        const to = at.clone().add(forward.multiplyScalar(Number(p.distance)));
+        void ctx.tools.animateCamera({ position: [to.x, to.y, to.z] }, Number(p.duration), DEFAULT_EASE, [at.x, at.y, at.z]);
+    },
+    revert(_target, p, ctx) {
+        ctx.restoreCameraHome(Number(p.duration), DEFAULT_EASE);
+    },
+});

package/dist/operations/index.d.ts

@@ -0,0 +1,5 @@
+export * from './types';
+export { OPERATIONS, getOperation, operationsFor, resolveParams } from './registry';
+export { runEffect, applyOperation, revertOperation, isOperationOn, resolveEffectTargets, runActionEffects, areActionEffectsOn, subscribeActionEffects, registerOperationTools, } from './runtime';
+export { useOperationsRuntime } from './useOperationsRuntime';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/operations/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,EACH,SAAS,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,oBAAoB,EAC/E,gBAAgB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,sBAAsB,GACvF,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/operations/index.js

@@ -0,0 +1,4 @@
+export * from './types.js';
+export { OPERATIONS, getOperation, operationsFor, resolveParams } from './registry.js';
+export { runEffect, applyOperation, revertOperation, isOperationOn, resolveEffectTargets, runActionEffects, areActionEffectsOn, subscribeActionEffects, registerOperationTools, } from './runtime.js';
+export { useOperationsRuntime } from './useOperationsRuntime.js';

package/dist/operations/registry.d.ts

@@ -0,0 +1,11 @@
+import type { OperationName } from '@3driseai/3drise-core';
+import type { OperationDefinition, OperationParams, OperationSource } from './types';
+export declare const OPERATIONS: OperationDefinition[];
+export declare const getOperation: (name: OperationName) => OperationDefinition | undefined;
+/** Operations offered in a context (gallery-only ones only on gallery objects). */
+export declare const operationsFor: (source: OperationSource, opts?: {
+    gallery?: boolean;
+}) => OperationDefinition[];
+/** Defaults overlaid with the effect's own values (unknown keys dropped). */
+export declare function resolveParams(def: OperationDefinition, overrides?: OperationParams): OperationParams;
+//# sourceMappingURL=registry.d.ts.map

package/dist/operations/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/operations/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AASrF,eAAO,MAAM,UAAU,EAAE,mBAAmB,EAAqE,CAAC;AAIlH,eAAO,MAAM,YAAY,GAAI,MAAM,aAAa,KAAG,mBAAmB,GAAG,SAA6B,CAAC;AAEvG,mFAAmF;AACnF,eAAO,MAAM,aAAa,GAAI,QAAQ,eAAe,EAAE,OAAM;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,KAAG,mBAAmB,EAClB,CAAC;AAE5F,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,GAAG,EAAE,mBAAmB,EAAE,SAAS,CAAC,EAAE,eAAe,GAAG,eAAe,CAOpG"}

package/dist/operations/registry.js

@@ -0,0 +1,21 @@
+import glow from './catalogue/glow.js';
+import fade from './catalogue/fade.js';
+import visibility from './catalogue/visibility.js';
+import zoom from './catalogue/zoom.js';
+import focus from './catalogue/focus.js';
+import moveToFront from './catalogue/moveToFront.js';
+import displayImage from './catalogue/displayImage.js';
+export const OPERATIONS = [glow, fade, visibility, zoom, focus, moveToFront, displayImage];
+const byName = new Map(OPERATIONS.map(o => [o.value, o]));
+export const getOperation = (name) => byName.get(name);
+/** Operations offered in a context (gallery-only ones only on gallery objects). */
+export const operationsFor = (source, opts = {}) => OPERATIONS.filter(o => o.usableIn.includes(source) && (!o.galleryOnly || opts.gallery));
+/** Defaults overlaid with the effect's own values (unknown keys dropped). */
+export function resolveParams(def, overrides) {
+    const out = {};
+    for (const [key, spec] of Object.entries(def.params ?? {})) {
+        const v = overrides?.[key];
+        out[key] = v === undefined || v === null ? spec.default : v;
+    }
+    return out;
+}

package/dist/operations/runtime.d.ts

@@ -0,0 +1,22 @@
+import type { Object3D } from 'three';
+import type { ActionSequence, OperationEffect, OperationName } from '@3driseai/3drise-core';
+import type { OperationDefinition, OperationParams, OperationTools } from './types';
+/** Register the mounted scene's tools. Returns the unregister. */
+export declare function registerOperationTools(t: OperationTools): () => void;
+export declare function isOperationOn(op: OperationName, target: Object3D): boolean;
+export declare function applyOperation(def: OperationDefinition, target: Object3D, params: OperationParams, self?: Object3D | null): boolean;
+export declare function revertOperation(def: OperationDefinition, target: Object3D): boolean;
+/** The objects an effect acts on: 'self', object ids, narrowed to model nodes. */
+export declare function resolveEffectTargets(effect: OperationEffect, self?: Object3D | null): Object3D[];
+/**
+ * Run one effect.
+ *   trigger  interactions: toggle when the operation toggles, else apply
+ *   apply / revert / toggle  explicit
+ */
+export declare function runEffect(effect: OperationEffect, mode: 'trigger' | 'apply' | 'revert' | 'toggle', self?: Object3D | null): void;
+/** Apply or undo an action's effects directly (the editor's "Try it"). */
+export declare function runActionEffects(action: ActionSequence, mode: 'apply' | 'revert'): void;
+export declare const areActionEffectsOn: (actionId: string) => boolean;
+/** Subscribe to action-effects on/off changes (studio badges). */
+export declare function subscribeActionEffects(fn: () => void): () => void;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/operations/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/operations/runtime.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEtC,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAgB,MAAM,uBAAuB,CAAC;AAG1G,OAAO,KAAK,EAAoB,mBAAmB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AA2BtG,kEAAkE;AAClE,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,IAAI,CAQpE;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,GAAG,OAAO,CAE1E;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,CAkBnI;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,QAAQ,GAAG,OAAO,CASnF;AAED,kFAAkF;AAClF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,QAAQ,EAAE,CAahG;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAWhI;AAQD,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,CAQvF;AAED,eAAO,MAAM,kBAAkB,GAAI,UAAU,MAAM,YAAkC,CAAC;AAEtF,kEAAkE;AAClE,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAGjE"}