@3driseai/3drise-viewer 0.1.28 → 0.1.29

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

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/operations/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC9F,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AA0CrF,eAAO,MAAM,UAAU,EAAE,mBAAmB,EAO3C,CAAC;AAIF,eAAO,MAAM,YAAY,GAAI,MAAM,aAAa,KAAG,mBAAmB,GAAG,SAA6B,CAAC;AAEvG,2GAA2G;AAC3G,eAAO,MAAM,aAAa,GAAI,QAAQ,eAAe,EAAE,OAAM;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,gBAAgB,CAAA;CAAO,KAAG,mBAAmB,EACG,CAAC;AAE7I,kGAAkG;AAClG,eAAO,MAAM,SAAS,GAAI,QAAQ,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,gBAAgB,CAAA;CAAE,KAAG,gBAC/B,CAAC;AAE1E,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,GAAG,EAAE,mBAAmB,EAAE,SAAS,CAAC,EAAE,eAAe,GAAG,eAAe,CAOpG"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/operations/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC9F,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AA+DrF,eAAO,MAAM,UAAU,EAAE,mBAAmB,EAQ3C,CAAC;AAIF,eAAO,MAAM,YAAY,GAAI,MAAM,aAAa,KAAG,mBAAmB,GAAG,SAA6B,CAAC;AAEvG,2GAA2G;AAC3G,eAAO,MAAM,aAAa,GAAI,QAAQ,eAAe,EAAE,OAAM;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,gBAAgB,CAAA;CAAO,KAAG,mBAAmB,EACG,CAAC;AAE7I,kGAAkG;AAClG,eAAO,MAAM,SAAS,GAAI,QAAQ,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,gBAAgB,CAAA;CAAE,KAAG,gBAC/B,CAAC;AAE1E,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,GAAG,EAAE,mBAAmB,EAAE,SAAS,CAAC,EAAE,eAAe,GAAG,eAAe,CAOpG"}

package/dist/operations/registry.js

@@ -11,6 +11,18 @@ import spin from './catalogue/spin.js';
 import jelly from './catalogue/jelly.js';
 import flip from './catalogue/flip.js';
 import swirl from './catalogue/swirl.js';
+import blastOff from './catalogue/blastOff.js';
+import vortexDrain from './catalogue/vortexDrain.js';
+import leafFall from './catalogue/leafFall.js';
+import pop from './catalogue/pop.js';
+import driftUp from './catalogue/driftUp.js';
+import slingshot from './catalogue/slingshot.js';
+import warp from './catalogue/warp.js';
+import knockAway from './catalogue/knockAway.js';
+import turnAway from './catalogue/turnAway.js';
+import flyBy from './catalogue/flyBy.js';
+import whoosh from './catalogue/whoosh.js';
+import slam from './catalogue/slam.js';
 import emberAsh from './catalogue/emberAsh.js';
 import particleSwarm from './catalogue/particleSwarm.js';
 import hologram from './catalogue/hologram.js';
@@ -37,12 +49,22 @@ import curlSmoke from './catalogue/curlSmoke.js';
 import lidarScan from './catalogue/lidarScan.js';
 import print3d from './catalogue/print3d.js';
 import silkDrape from './catalogue/silkDrape.js';
+import { TRAILS } from './catalogue/motionTrail.js';
+import float from './catalogue/float.js';
+import sway from './catalogue/sway.js';
+import bounce from './catalogue/bounce.js';
+import wobble from './catalogue/wobble.js';
+import pulse from './catalogue/pulse.js';
+import shake from './catalogue/shake.js';
+import rotate from './catalogue/rotate.js';
+import grow from './catalogue/grow.js';
 // Grouped by channel (picker order): transform · visual · camera.
 export const OPERATIONS = [
-    jelly, flip, spin, swirl, moveToFront,
+    jelly, flip, spin, swirl, blastOff, vortexDrain, leafFall, pop, driftUp, slingshot, warp, knockAway, turnAway, flyBy, whoosh, slam, moveToFront,
+    float, sway, bounce, wobble, pulse, shake, rotate, grow,
     glow, rimLight, dissolve, emberAsh, particleSwarm, hologram, shatter,
     sandErosion, teleport, inkBloom, flock, liquidMetal, metalize, frost, heatCracks, petrify, kintsugi, rainBeads, ivy,
-    portal, voxelize, unweave, petalPeel, curlSmoke, lidarScan, print3d, silkDrape,
+    portal, voxelize, unweave, petalPeel, curlSmoke, lidarScan, print3d, silkDrape, ...TRAILS,
     fade, visibility, displayImage,
     zoom, frame, focus, orbit,
 ];

package/dist/operations/runtime.d.ts

@@ -1,6 +1,7 @@
 import type { Object3D } from 'three';
-import type { ActionSequence, OperationEffect, OperationName } from '@3driseai/3drise-core';
+import type { ActionSequence, EffectClip, EffectClipUse, OperationEffect, OperationName } from '@3driseai/3drise-core';
 import type { OperationDefinition, OperationParams, OperationTools } from './types';
+import '../triggers/kinds/effects';
 /** 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;
@@ -23,6 +24,49 @@ export declare function revertOperation(def: OperationDefinition, target: Object
  * operations that are not on do nothing.
  */
 export declare function forceRevert(def: OperationDefinition, target: Object3D, params: OperationParams): void;
+/**
+ * Object effects that an interaction or an action adds are run by the object's own effects
+ * controller (objectEffects.ts registers itself here — the import goes that way round), so they
+ * follow the same rules as the object's own: take-overs hand over directly, playback, one of each.
+ */
+export interface AddedEffectsRouter {
+    add(root: Object3D, key: string, effect: {
+        operation: OperationName;
+        params?: OperationParams;
+        playback?: OperationEffect['playback'];
+        meshNames?: string[];
+        scope?: OperationEffect['scope'];
+    }): boolean;
+    remove(root: Object3D, key: string): boolean;
+    has(root: Object3D, key: string): boolean;
+    applyClip(root: Object3D, key: string, clip: EffectClip, parts?: string[]): boolean;
+    removeClip(root: Object3D, key: string): boolean;
+    hasClip(root: Object3D, key: string): boolean;
+}
+export declare function setEffectClipTemplates(list: EffectClip[] | null | undefined, source?: string): void;
+export declare const getEffectClipTemplate: (id: string) => EffectClip | undefined;
+/** Asset type of a saved effect clip (assets table). */
+export declare const EFFECT_CLIP_ASSET = "effect_clip";
+/** A saved effect clip from its asset row: the clip is the asset's `settings` ({ version, effects, steps, loop, yoyo }), the preview its `url`. */
+export declare function effectClipFromAsset(asset: {
+    id: string;
+    name?: string;
+    url?: string | null;
+    settings?: unknown;
+    creatorId?: string;
+    privacy?: string;
+} | null | undefined): EffectClip | null;
+/**
+ * Apply / revert / toggle a saved effect clip on its targets (an interaction's or an action's
+ * `effectClips`). The clip has no target of its own: it is laid over each target object's own
+ * effects by that object's controller, and comes off again on revert.
+ */
+export declare function runEffectClip(use: EffectClipUse, mode: 'apply' | 'revert' | 'toggle', self?: Object3D | null): number;
+/** Is a saved effect clip use on (on any of its targets)? */
+export declare function isEffectClipOn(use: EffectClipUse, self?: Object3D | null): boolean;
+export declare const registerAddedEffects: (r: AddedEffectsRouter) => void;
+/** Is an effect on (on any of its targets)? One-shot operations never are. */
+export declare function isEffectOn(effect: OperationEffect, self?: Object3D | null): boolean;
 /** The objects an effect acts on: 'self', object ids, narrowed to model nodes. */
 export declare function resolveEffectTargets(effect: OperationEffect, self?: Object3D | null): Object3D[];
 /**
@@ -52,7 +96,18 @@ export declare const isPreviewing: (effectId: string) => boolean;
  * interactions and actions use, when the scene loads.
  */
 export declare function prewarmEffect(effect: OperationEffect, self?: Object3D | null): Promise<void>;
-/** Apply or undo an action's effects directly (the editor's "Try it"). */
+/**
+ * A warm-only apply: stages and compiles what the operation needs on the target and
+ * animates nothing. It is left staged at its start — apply it for real next, or revert it.
+ * Used to get an effect ready while its object is still hidden (see objectEffects, Visible).
+ */
+export declare function warmOperation(def: OperationDefinition, target: Object3D, params: OperationParams, self?: Object3D | null, opts?: {
+    bare?: boolean;
+}): Promise<void>;
+/**
+ * Apply or undo an action's effects directly (the editor's "Try it"). They run through the
+ * triggers engine with the action as their source (and whatever applied it as their chain).
+ */
 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). */

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

@@ -1 +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;AAI1G,OAAO,KAAK,EAAoB,mBAAmB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAwCtG,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,EAAE,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAkB9J;AAcD,kGAAkG;AAClG,eAAO,MAAM,KAAK,GAAI,IAAI,aAAa,EAAE,QAAQ,QAAQ,kBAAqD,CAAC;AAE/G;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAUjJ;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAIrG;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;AASD;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAoCrG;AAED,oEAAoE;AACpE,wBAAsB,cAAc,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAGzG;AAED,eAAO,MAAM,YAAY,GAAI,UAAU,MAAM,YAA2B,CAAC;AASzE;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB5F;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"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/operations/runtime.ts"],"names":[],"mappings":"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"}

package/dist/operations/runtime.js

@@ -2,6 +2,9 @@ import { SceneActions, findNodesByName } from '@3driseai/3drise-core';
 import { findById } from '../utils/sceneQuery.js';
 import { getOperation, resolveParams } from './registry.js';
 import { warmMode } from './catalogue/warmup.js';
+import { runActionCommands } from '../triggers/hosts/actions.js';
+// the effect / effect clip triggerables (they call back into this module at run time)
+import '../triggers/kinds/effects.js';
 const active = new Map(); // `${op}:${uuid}`
 const slots = new Map(); // exclusive group → active key
 const toolsStack = [];
@@ -118,6 +121,123 @@ export function forceRevert(def, target, params) {
     const ctx = context(undefined, true);
     runs.set(keyOf(def.value, target), finished(def.revert(target, params, ctx), params));
 }
+// ---------------------------------------------------------------- effect clips (templates)
+/**
+ * Saved effect clips (templates), by id. Interactions and actions point at them; an object that
+ * imports one gets a copy. They come from more than one place — the studio's list of the user's
+ * templates, the templates a loaded project links — so each source keeps its own list.
+ */
+const clipSources = new Map();
+export function setEffectClipTemplates(list, source = 'default') {
+    const m = new Map();
+    for (const c of list ?? [])
+        if (c?.id)
+            m.set(c.id, c);
+    clipSources.set(source, m);
+}
+export const getEffectClipTemplate = (id) => {
+    for (const m of clipSources.values()) {
+        const c = m.get(id);
+        if (c)
+            return c;
+    }
+    return undefined;
+};
+/** Asset type of a saved effect clip (assets table). */
+export const EFFECT_CLIP_ASSET = 'effect_clip';
+/** A saved effect clip from its asset row: the clip is the asset's `settings` ({ version, effects, steps, loop, yoyo }), the preview its `url`. */
+export function effectClipFromAsset(asset) {
+    if (!asset?.id)
+        return null;
+    const s = (asset.settings && typeof asset.settings === 'object' && !Array.isArray(asset.settings) ? asset.settings : {});
+    return {
+        id: asset.id, name: asset.name || 'Effect clip',
+        effects: Array.isArray(s.effects) ? s.effects : [],
+        ...(Array.isArray(s.steps) ? { steps: s.steps } : {}),
+        ...(s.loop !== undefined ? { loop: !!s.loop } : {}),
+        ...(s.yoyo !== undefined ? { yoyo: !!s.yoyo } : {}),
+        ...(s.visible ? { visible: true } : {}),
+        ...(s.spread && typeof s.spread === 'object' ? { spread: s.spread } : {}),
+        ...(asset.url ? { previewUrl: asset.url } : {}),
+        ...(asset.creatorId ? { creatorId: asset.creatorId } : {}),
+        ...(asset.privacy ? { privacy: asset.privacy } : {}),
+    };
+}
+/**
+ * Apply / revert / toggle a saved effect clip on its targets (an interaction's or an action's
+ * `effectClips`). The clip has no target of its own: it is laid over each target object's own
+ * effects by that object's controller, and comes off again on revert.
+ */
+export function runEffectClip(use, mode, self) {
+    const clip = getEffectClipTemplate(use.clip);
+    if (!router)
+        return 0;
+    let n = 0;
+    for (const t of use.targets ?? []) {
+        const root = t === 'self' ? self : findById(t);
+        if (!root)
+            continue;
+        const on = router.hasClip(root, use.id);
+        if (mode === 'revert' || (mode === 'toggle' && on)) {
+            if (router.removeClip(root, use.id))
+                n++;
+        }
+        else if (clip && router.applyClip(root, use.id, clip, t === 'self' ? undefined : use.meshNames?.[t]))
+            n++;
+    }
+    return n;
+}
+/** Is a saved effect clip use on (on any of its targets)? */
+export function isEffectClipOn(use, self) {
+    if (!router)
+        return false;
+    return (use?.targets ?? []).some(t => {
+        const root = t === 'self' ? self : findById(t);
+        return !!root && router.hasClip(root, use.id);
+    });
+}
+let router = null;
+export const registerAddedEffects = (r) => { router = r; };
+const routable = (def) => !!router && def.usableIn.includes('object');
+function slotsOf(effect, self, multi) {
+    const out = [];
+    for (const t of effect.targets ?? []) {
+        const root = t === 'self' ? self : findById(t);
+        if (!root)
+            continue;
+        const names = t === 'self' ? undefined : effect.meshNames?.[t];
+        const nodes = names?.length
+            ? names.flatMap(name => findNodesByName(root, name).filter(n => n !== root))
+            : [root];
+        out.push({ root, names: names?.length ? names : undefined, nodes });
+    }
+    return multi ? out : out.slice(0, 1);
+}
+function slotOn(def, effect, slot) {
+    return routable(def) ? router.has(slot.root, effect.id) : slot.nodes.some(n => isOperationOn(def.value, n));
+}
+function slotApply(def, effect, slot, params, self) {
+    if (routable(def))
+        router.add(slot.root, effect.id, { operation: def.value, params, playback: effect.playback, meshNames: slot.names, ...(effect.scope ? { scope: effect.scope } : {}) });
+    else
+        for (const n of slot.nodes)
+            applyOperation(def, n, params, self);
+}
+function slotRevert(def, effect, slot) {
+    if (routable(def))
+        router.remove(slot.root, effect.id);
+    else
+        for (const n of slot.nodes)
+            revertOperation(def, n);
+}
+const slotDone = (def, slot) => Promise.all(slot.nodes.map(n => runOf(def.value, n)));
+/** Is an effect on (on any of its targets)? One-shot operations never are. */
+export function isEffectOn(effect, self) {
+    const def = effect && getOperation(effect.operation);
+    if (!def)
+        return false;
+    return slotsOf(effect, self, !!def.multi).some(s => slotOn(def, effect, s));
+}
 /** The objects an effect acts on: 'self', object ids, narrowed to model nodes. */
 export function resolveEffectTargets(effect, self) {
     const out = [];
@@ -145,15 +265,14 @@ export function runEffect(effect, mode, self) {
     const def = getOperation(effect.operation);
     if (!def)
         return;
-    const targets = resolveEffectTargets(effect, self);
     const params = resolveParams(def, effect.params);
-    for (const target of def.multi ? targets : targets.slice(0, 1)) {
-        const on = isOperationOn(def.value, target);
+    for (const slot of slotsOf(effect, self, !!def.multi)) {
+        const on = slotOn(def, effect, slot);
         const m = mode === 'trigger' ? (def.toggles ? 'toggle' : 'apply') : mode;
         if (m === 'revert' || (m === 'toggle' && on))
-            revertOperation(def, target);
+            slotRevert(def, effect, slot);
         else if (m === 'apply' || m === 'toggle')
-            applyOperation(def, target, params, self);
+            slotApply(def, effect, slot, params, self);
     }
 }
 // ---------------------------------------------------------------- preview
@@ -173,26 +292,27 @@ export async function previewEffect(effect, self) {
     const def = getOperation(effect.operation);
     if (!def || !tools())
         return false;
-    const targets = resolveEffectTargets(effect, self);
-    if (!targets.length)
+    const list = slotsOf(effect, self, !!def.multi);
+    if (!list.some(s => s.nodes.length))
         return false;
-    const list = def.multi ? targets : targets.slice(0, 1);
     const prev = previews.get(effect.id);
     if (prev) {
         const pd = getOperation(prev.op);
         if (pd)
-            for (const t of prev.targets)
-                if (isOperationOn(pd.value, t))
-                    revertOperation(pd, t);
+            for (const s of prev.slots)
+                if (slotOn(pd, { ...effect, operation: prev.op }, s))
+                    slotRevert(pd, { ...effect, operation: prev.op }, s);
     }
     const token = (prev?.token ?? 0) + 1;
-    previews.set(effect.id, { token, op: def.value, targets: list });
+    previews.set(effect.id, { token, op: def.value, slots: list });
     const alive = () => previews.get(effect.id)?.token === token;
     const params = resolveParams(def, effect.params);
-    const applyAll = () => Promise.all(list.map(t => { applyOperation(def, t, params, self); return runOf(def.value, t); }));
-    const revertAll = () => Promise.all(list.map(t => { revertOperation(def, t); return runOf(def.value, t); }));
+    // (a routed effect starts through the object's controller: give it a tick before waiting on its run)
+    const tick = () => new Promise(r => setTimeout(r, 0));
+    const applyAll = async () => { list.forEach(s => slotApply(def, effect, s, params, self)); await tick(); await Promise.all(list.map(s => slotDone(def, s))); };
+    const revertAll = async () => { list.forEach(s => slotRevert(def, effect, s)); await tick(); await Promise.all(list.map(s => slotDone(def, s))); };
     try {
-        const wasOn = list.some(t => isOperationOn(def.value, t));
+        const wasOn = list.some(s => slotOn(def, effect, s));
         if (wasOn) {
             await revertAll();
             if (!alive())
@@ -270,6 +390,27 @@ export function prewarmEffect(effect, self) {
     warmQueue = warmQueue.then(job, job);
     return warmQueue;
 }
+/**
+ * A warm-only apply: stages and compiles what the operation needs on the target and
+ * animates nothing. It is left staged at its start — apply it for real next, or revert it.
+ * Used to get an effect ready while its object is still hidden (see objectEffects, Visible).
+ */
+export function warmOperation(def, target, params, self, opts) {
+    if (def.channel !== 'visual' || !def.revert || NO_SHADERS.has(def.value))
+        return Promise.resolve();
+    const ctx = context(self, opts?.bare);
+    if (!ctx)
+        return Promise.resolve();
+    warmMode.on = true;
+    let res;
+    try {
+        res = def.apply(target, params, ctx);
+    }
+    finally {
+        warmMode.on = false;
+    }
+    return finished(res, { duration: 0 });
+}
 // ---------------------------------------------------------------- actions
 const actionEffectsOn = new Set();
 const listeners = new Set();
@@ -277,15 +418,17 @@ const notify = () => listeners.forEach(l => { try {
     l();
 }
 catch { /* listener error */ } });
-/** Apply or undo an action's effects directly (the editor's "Try it"). */
+/**
+ * Apply or undo an action's effects directly (the editor's "Try it"). They run through the
+ * triggers engine with the action as their source (and whatever applied it as their chain).
+ */
 export function runActionEffects(action, mode) {
     const on = actionEffectsOn.has(action.id);
     if (mode === 'apply' && on)
         return;
     if (mode === 'revert' && !on)
         return;
-    for (const effect of action.effects ?? [])
-        runEffect(effect, mode);
+    runActionCommands(action, mode);
     if (mode === 'apply')
         actionEffectsOn.add(action.id);
     else

package/dist/operations/types.d.ts

@@ -1,7 +1,7 @@
 import type { Object3D } from 'three';
 import type { OperationChannel, OperationName, OperationParamValue, Vector3Array } from '@3driseai/3drise-core';
 /** A parameter the studio shows under the effect, with its default. */
-export type OperationParamSpec = {
+export type OperationParamSpec = ({
     type: 'number';
     label: string;
     default: number;
@@ -29,7 +29,28 @@ export type OperationParamSpec = {
     label: string;
     default: boolean;
     hint?: string;
+}
+/** Several of the options at once. The value is their keys joined by commas ('x,z'); at least one stays on. */
+ | {
+    type: 'multi';
+    label: string;
+    default: string;
+    options: Array<{
+        value: string;
+        label: string;
+    }>;
+    hint?: string;
+}) & {
+    /**
+     * Shown only while other parameters have one of these values, e.g. `{ style: ['sparks'] }`
+     * (a setting that belongs to one style of the effect). Hidden settings keep their values.
+     */
+    showWhen?: Record<string, string[]>;
 };
+/** Whether a parameter is shown for the effect's current values (see `showWhen`). */
+export declare const paramShown: (spec: OperationParamSpec, values: Record<string, unknown>) => boolean;
+/** The options a `multi` parameter value has on. */
+export declare const multiValues: (value: unknown) => string[];
 export type OperationParams = Record<string, OperationParamValue>;
 /** interaction / action: triggered. object: layered on the object (CreatedObject.effects), switched on / off. */
 export type OperationSource = 'interaction' | 'action' | 'object';
@@ -95,8 +116,9 @@ export interface OperationDefinition {
     };
     params?: Record<string, OperationParamSpec>;
     /**
-     * Object effects only: parameters forced to these values (the studio hides
-     * them), e.g. a hologram that must stay visible.
+     * Object effects only: the defaults an attached effect starts from, e.g. a hologram
+     * that stays (`disappear: false`). The user can change them (Disappear on makes the
+     * effect the object's entrance / exit when its effects follow visibility).
      */
     objectParams?: OperationParams;
     /**
@@ -109,6 +131,41 @@ export interface OperationDefinition {
     apply: (target: Object3D, params: OperationParams, ctx: OperationContext) => void | Promise<void>;
     /** No revert = one-way (applies only). */
     revert?: (target: Object3D, params: OperationParams, ctx: OperationContext) => void | Promise<void>;
+    /**
+     * A motion that repeats for as long as the effect is on (float, sway, rotate…).
+     * Played as an object effect it follows the same playback as everything else:
+     * one pass of `duration` and it settles, unless Loop keeps it going.
+     */
+    periodic?: boolean;
+    /**
+     * How the effect brings the object in and out when it follows the object's
+     * visibility (its effect clip's `visible`):
+     *   paint   a sweeping take-over (frost, hologram…): the object is drawn only where
+     *           the effect has painted it, and nothing is left where it has retreated
+     *   vanish  the effect takes the object away (dissolve, swirl…): shown = it plays
+     *           back from gone, hidden = it plays to gone; in between the object is plain
+     * Unset: the object appears and the effect plays in; it plays out before the object goes.
+     * Any effect with Disappear switched on behaves as `vanish`.
+     */
+    presence?: 'paint' | 'vanish';
+    /**
+     * An add-on that draws what OTHER effects do to the object (the motion trails). Following
+     * the object's visibility it is fully on before the object is shown — so it catches the
+     * whole entrance — and stays on through the exit, going off only once the object is gone
+     * (what is still in flight finishes on its own).
+     */
+    addOn?: boolean;
+    /**
+     * Take-overs built on the transition field: the field state of the look that is on `target`.
+     * Having it means the look can be WIPED by the look that replaces it (a direct handover
+     * between effect steps — see `goneGlsl` in transitionField.ts) and can wipe another.
+     */
+    field?: (target: Object3D) => import('./catalogue/transitionField').FieldState | undefined;
+    /**
+     * One-shots (no revert): stop a move that is playing and put the target back at
+     * once — an object effect switched off or removed mid-move.
+     */
+    cancel?: (target: Object3D) => void;
 }
 /** Type helper for catalogue files. */
 export declare const defineOperation: (def: OperationDefinition) => OperationDefinition;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/operations/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/operations/types.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEhH,uEAAuE;AACvE,MAAM,MAAM,kBAAkB,GAAG,CAC3B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3H;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACnH;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;AACrE,+GAA+G;GAC7G;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CACvH,GAAG;IACA;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACvC,CAAC;AAEF,qFAAqF;AACrF,eAAO,MAAM,UAAU,GAAI,MAAM,kBAAkB,EAAE,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,OACyB,CAAC;AAEjH,oDAAoD;AACpD,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,MAAM,EAAuE,CAAC;AAE3H,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;AAElE,iHAAiH;AACjH,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAElE,kFAAkF;AAClF,MAAM,WAAW,cAAc;IAC3B,2DAA2D;IAC3D,aAAa,EAAE,CAAC,EAAE,EAAE;QAAE,QAAQ,CAAC,EAAE,YAAY,CAAA;KAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzH,+CAA+C;IAC/C,UAAU,EAAE,MAAM;QAAE,QAAQ,EAAE,YAAY,CAAC;QAAC,MAAM,EAAE,YAAY,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1E;;;OAGG;IACH,WAAW,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtG,WAAW,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAChI,gBAAgB,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAC7F;AAED,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,cAAc,CAAC;IACtB,2DAA2D;IAC3D,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IACvB,wEAAwE;IACxE,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,qDAAqD;IACrD,iBAAiB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/D;AAED,MAAM,WAAW,mBAAmB;IAChC,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,4FAA4F;IAC5F,OAAO,EAAE,gBAAgB,CAAC;IAC1B,oCAAoC;IACpC,KAAK,EAAE,OAAO,CAAC;IACf,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,+BAA+B;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,QAAQ,GAAG,UAAU,CAAA;KAAE,CAAC;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC5C;;;;OAIG;IACH,YAAY,CAAC,EAAE,eAAe,CAAC;IAC/B;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,mFAAmF;IACnF,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClG,0CAA0C;IAC1C,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpG;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC9B;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,KAAK,OAAO,6BAA6B,EAAE,UAAU,GAAG,SAAS,CAAC;IAC3F;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,KAAK,IAAI,CAAC;CACvC;AAED,uCAAuC;AACvC,eAAO,MAAM,eAAe,GAAI,KAAK,mBAAmB,KAAG,mBAA0B,CAAC;AAEtF,eAAO,MAAM,YAAY,eAAe,CAAC;AAEzC,uDAAuD;AACvD,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAIrG,CAAC"}

package/dist/operations/types.js

@@ -1,9 +1,13 @@
+/** Whether a parameter is shown for the effect's current values (see `showWhen`). */
+export const paramShown = (spec, values) => !spec.showWhen || Object.entries(spec.showWhen).every(([k, allowed]) => allowed.includes(String(values[k])));
+/** The options a `multi` parameter value has on. */
+export const multiValues = (value) => String(value ?? '').split(',').map(v => v.trim()).filter(Boolean);
 /** Type helper for catalogue files. */
 export const defineOperation = (def) => def;
 export const DEFAULT_EASE = 'power2.out';
 /** The channels in studio order, with their labels. */
 export const OPERATION_CHANNELS = [
-    { value: 'transform', label: 'Transform', description: "Moves, turns or scales the object itself" },
+    { value: 'transform', label: 'Physical', description: "Moves, turns or scales the object itself" },
     { value: 'visual', label: 'Visual', description: 'Changes how the object looks — never where it is' },
     { value: 'camera', label: 'Camera', description: 'Moves or turns the camera' },
 ];

package/dist/operations/useObjectEffectLayers.d.ts

@@ -1,4 +1,4 @@
 import type { Object3D } from 'three';
-import type { ObjectEffect } from '@3driseai/3drise-core';
-export declare function useObjectEffectLayers(ref: React.RefObject<Object3D | null>, effects: ObjectEffect[] | undefined): void;
+import type { EffectSpread, EffectSteps, ObjectEffect } from '@3driseai/3drise-core';
+export declare function useObjectEffectLayers(ref: React.RefObject<Object3D | null>, effects: ObjectEffect[] | undefined, visible?: boolean, steps?: EffectSteps | null, parts?: string[] | null, follows?: boolean, group?: EffectSpread | null): void;
 //# sourceMappingURL=useObjectEffectLayers.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useObjectEffectLayers.d.ts","sourceRoot":"","sources":["../../src/operations/useObjectEffectLayers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAM1D,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,SAAS,QAkC/G"}
+{"version":3,"file":"useObjectEffectLayers.d.ts","sourceRoot":"","sources":["../../src/operations/useObjectEffectLayers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAQrF,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,SAAS,EAAE,OAAO,UAAO,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,UAAQ,EAAE,KAAK,CAAC,EAAE,YAAY,GAAG,IAAI,QAgDlO"}

package/dist/operations/useObjectEffectLayers.js

@@ -1,38 +1,59 @@
 // Runs an object's effects (CreatedObject.effects) on its group — see ./objectEffects.ts.
 import { useEffect, useRef } from 'react';
 import { useFrame } from '@react-three/fiber';
-import { ObjectEffectsController, surfaceSignature } from './objectEffects.js';
+import { ObjectEffectsController, objectEffectsControllerFor, surfaceSignature } from './objectEffects.js';
+import { tickMix } from './catalogue/physicalMix.js';
+import { useSceneReady } from '../triggers/readiness.js';
 /** How often (frames) the object's meshes / materials are checked for replacement. */
 const CHECK_EVERY = 20;
-export function useObjectEffectLayers(ref, effects) {
+export function useObjectEffectLayers(ref, effects, visible = true, steps, parts, follows = false, group) {
     const ctrl = useRef(null);
     const signature = useRef('');
     const latest = useRef(effects);
     latest.current = effects;
-    const has = !!effects?.length;
+    const has = !!effects?.length || !!steps?.steps?.length;
+    // A published scene's effects start once it is ready (the studio is never gated).
+    const ready = useSceneReady();
     // Changes after the first sync play their transitions; the first lands at once.
     useEffect(() => {
         const root = ref.current;
-        if (!root)
+        if (!root || !ready)
             return;
         if (!ctrl.current) {
-            if (!has)
+            // an interaction or action may have made one already (an effect added to an object with none of its own)
+            const made = objectEffectsControllerFor(root);
+            if (!made && !has)
                 return;
-            ctrl.current = new ObjectEffectsController(root);
+            ctrl.current = made ?? new ObjectEffectsController(root);
+            if (!made)
+                ctrl.current.setShown(visible); // visibility effects of a hidden object wait for it to be shown
             signature.current = surfaceSignature(root);
-            ctrl.current.sync(effects, 'instant');
+            ctrl.current.sync(effects, 'instant', steps, parts, follows, group);
             return;
         }
-        ctrl.current.sync(effects, 'animate');
-    }, [effects, has, ref]);
+        ctrl.current.sync(effects, 'animate', steps, parts, follows, group);
+    }, [effects, steps, parts, follows, group, has, ref, ready]);
     useEffect(() => () => { ctrl.current?.dispose(); ctrl.current = null; }, []);
     // A model that finished loading, a material swapped by an edit: move the effects over.
     const frame = useRef(0);
     useFrame(() => {
-        const c = ctrl.current;
         const root = ref.current;
+        if (!ctrl.current && root && !(frame.current % CHECK_EVERY)) {
+            // made meanwhile for an added effect: take it over (moves over on a new surface, disposed with the object)
+            const made = objectEffectsControllerFor(root);
+            if (made) {
+                ctrl.current = made;
+                signature.current = surfaceSignature(root);
+            }
+        }
+        const c = ctrl.current;
+        // Physical effects ride on the object's own transform: lay them over it again now, after the
+        // object's property animations wrote it this frame and before the render.
+        if (root)
+            tickMix(root);
         if (!c || !root || ++frame.current % CHECK_EVERY)
             return;
+        c.checkFanout(); // a group: children joined or left
         const sig = surfaceSignature(root);
         if (sig === signature.current)
             return;

package/dist/operations/usePresentedVisibility.d.ts

@@ -0,0 +1,10 @@
+interface Presentable {
+    id?: string;
+    meshSettings?: {
+        visible?: boolean;
+    } | null;
+    effects?: unknown;
+}
+export declare function usePresentedVisibility<T extends Presentable | null | undefined>(object: T): T;
+export {};
+//# sourceMappingURL=usePresentedVisibility.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usePresentedVisibility.d.ts","sourceRoot":"","sources":["../../src/operations/usePresentedVisibility.ts"],"names":[],"mappings":"AAsBA,UAAU,WAAW;IAAG,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE;AAErG,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,WAAW,GAAG,IAAI,GAAG,SAAS,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CA8B7F"}