@3driseai/3drise-core 1.0.18 → 1.0.20

package/dist/services/AnimationsManager.js

@@ -1,399 +1,13 @@
-import gsap from 'gsap';
 import { applyEasing, gsapEasingMap } from '../utils/easingUtils.js';
 /**
- * AnimationsManager
- * Execution-only manager for animation playback.
- * Sequence data lives in Redux - this class only handles execution.
+ * AnimationsManager — the path registry (PathCreator, path animation) and the
+ * progress helpers per-object animations use.
+ *
+ * Sequence playback moved to Animations V2 (viewer `animationsV2/ClipsRuntime`);
+ * the V1 sequence player, its GSAP timelines and its step events are gone.
  */
 class AnimationsManager {
-    // Runtime state for actively playing sequences
-    activeSequences = new Map();
     paths = new Map([]);
-    timelines = new Map();
-    eventListeners = new Map();
-    constructor() {
-        // Initialize event listener sets
-        this.eventListeners.set('sequenceStart', new Set());
-        this.eventListeners.set('sequenceEnd', new Set());
-        this.eventListeners.set('stepStart', new Set());
-        this.eventListeners.set('stepEnd', new Set());
-    }
-    /**
-     * Add an event listener
-     */
-    on(eventType, listener) {
-        const listeners = this.eventListeners.get(eventType);
-        if (listeners) {
-            listeners.add(listener);
-        }
-    }
-    /**
-     * Remove an event listener
-     */
-    off(eventType, listener) {
-        const listeners = this.eventListeners.get(eventType);
-        if (listeners) {
-            listeners.delete(listener);
-        }
-    }
-    /**
-     * Emit an event
-     */
-    emit(event) {
-        const listeners = this.eventListeners.get(event.type);
-        if (listeners) {
-            listeners.forEach(listener => {
-                try {
-                    listener(event);
-                }
-                catch (error) {
-                    console.error(`Error in animation event listener for ${event.type}:`, error);
-                }
-            });
-        }
-    }
-    /**
-     * @deprecated Sequences are now managed in Redux. Use playSequence(sequence) directly.
-     * This method is kept for backwards compatibility during migration.
-     */
-    addSequence(sequence) {
-        console.warn('AnimationsManager.addSequence is deprecated. Sequences are managed in Redux.');
-        // Store for backwards compatibility
-        this.activeSequences.set(sequence.id, {
-            ...sequence,
-            currentStep: 0,
-            isPlaying: false,
-            isPaused: false,
-            progress: 0,
-        });
-        return this.activeSequences.get(sequence.id);
-    }
-    /**
-     * @deprecated Sequences are now managed in Redux.
-     */
-    removeSequence(sequenceId) {
-        console.warn('AnimationsManager.removeSequence is deprecated. Sequences are managed in Redux.');
-        this.stopSequence(sequenceId);
-        this.activeSequences.delete(sequenceId);
-        this.timelines.delete(sequenceId);
-    }
-    /**
-     * Get an actively playing sequence's runtime state
-     */
-    getSequence(sequenceId) {
-        return this.activeSequences.get(sequenceId);
-    }
-    /**
-     * @deprecated Sequences are now managed in Redux. Use Redux selectors instead.
-     */
-    getAllSequences() {
-        console.warn('AnimationsManager.getAllSequences is deprecated. Use Redux selectors.');
-        return Array.from(this.activeSequences.values());
-    }
-    // updateSequence(sequenceId: string, updates: Partial<AnimationSequence>): void {
-    //   const sequence = this.sequences.get(sequenceId);
-    //   if (sequence) {
-    //     Object.assign(sequence, updates);
-    //   }
-    // }
-    /**
-     * Execute a single animation step with multiple transitions
-     * Returns a GSAP timeline for this step
-     */
-    executeStep(step, stepTimeline, sequence, stepIndex) {
-        const { duration, ease = 'power2.out' } = step;
-        const stagger = step.stagger || 0;
-        // Total GSAP timeline duration must cover the last staggered transition finishing.
-        // last object starts at (n-1)*stagger, runs for `duration` seconds.
-        const totalDuration = duration + (step.transitions.length > 1 ? (step.transitions.length) * stagger : 0);
-        // Emit step start event with step data
-        stepTimeline.call(() => {
-            this.emit({
-                type: 'stepStart',
-                sequenceId: sequence.id,
-                sequence,
-                step,
-                stepIndex,
-            });
-        }, undefined, 0); // Call at the start of the step timeline
-        // console.log('Executing step', stepIndex, 'of sequence', sequence.id, 'with duration', duration, 'stagger', stagger, 'totalDuration', totalDuration);
-        stepTimeline.to({}, { duration: totalDuration, ease: ease });
-        // Emit step end event
-        stepTimeline.call(() => {
-            this.emit({
-                type: 'stepEnd',
-                sequenceId: sequence.id,
-                sequence,
-                step,
-                stepIndex,
-            });
-            if (step.onComplete) {
-                step.onComplete();
-            }
-        });
-    }
-    /**
-     * Play an animation sequence
-     * @param sequenceOrId - Either a full AnimationSequence object or a sequence ID (for backwards compat)
-     * @param options - Playback options
-     */
-    async playSequence(sequenceOrId, options = {}) {
-        // Support both sequence object and ID for backwards compatibility
-        let sequence;
-        let originalSequence; // Keep original for yoyo/loop callbacks
-        let sequenceId;
-        if (typeof sequenceOrId === 'string') {
-            // ID passed - look up in activeSequences (backwards compat)
-            const found = this.activeSequences.get(sequenceOrId);
-            if (!found) {
-                console.warn(`Animation sequence with ID ${sequenceOrId} not found. Pass sequence data directly.`);
-                return;
-            }
-            originalSequence = found;
-            sequence = options.reverse ? this.reverseSteps(found) : found;
-            sequenceId = sequenceOrId;
-        }
-        else {
-            // Sequence object passed directly (preferred)
-            originalSequence = sequenceOrId;
-            sequence = options.reverse ? this.reverseSteps(sequenceOrId) : sequenceOrId;
-            sequenceId = sequence.id;
-        }
-        // console.log('Playing sequence:', sequenceId, options);
-        // Stop existing timeline if any
-        this.stopSequence(sequenceId);
-        // Store in activeSequences for runtime state tracking
-        const runtimeSequence = {
-            ...sequence,
-            isPlaying: true,
-            isPaused: false,
-            currentStep: options.startStep || 0,
-            progress: 0,
-        };
-        this.activeSequences.set(sequenceId, runtimeSequence);
-        // console.log({sequence});
-        // Create main timeline
-        // When yoyo is enabled, we handle looping manually via callbacks
-        // When yoyo is disabled, we can use GSAP's repeat for loop
-        const useGsapRepeat = originalSequence.loop && !originalSequence.yoyo;
-        const mainTimeline = gsap.timeline({
-            paused: false,
-            repeat: useGsapRepeat ? -1 : 0,
-            onStart: () => {
-                // Emit sequence start event
-                this.emit({
-                    type: 'sequenceStart',
-                    sequenceId,
-                    sequence: runtimeSequence,
-                });
-            },
-            onUpdate: () => {
-                const progress = mainTimeline.progress();
-                // console.log(progress);
-                runtimeSequence.progress = progress;
-            },
-            onComplete: () => {
-                runtimeSequence.isPlaying = false;
-                runtimeSequence.currentStep = 0;
-                runtimeSequence.progress = 1;
-                // Emit sequence end event
-                this.emit({
-                    type: 'sequenceEnd',
-                    sequenceId,
-                    sequence: runtimeSequence,
-                });
-                if (originalSequence.yoyo) {
-                    if (!options._isYoyoReturn) {
-                        // Just finished the first pass, play the return leg (reversed)
-                        this.playSequence(originalSequence, {
-                            ...options,
-                            reverse: true,
-                            _isYoyoReturn: true,
-                        });
-                    }
-                    else if (originalSequence.loop) {
-                        // Finished the return leg and loop is true, start fresh (forward)
-                        this.playSequence(originalSequence, {
-                            ...options,
-                            reverse: false,
-                            _isYoyoReturn: false,
-                        });
-                    }
-                    // If _isYoyoReturn and loop is false, we're done (no replay)
-                }
-                if (options.onComplete) {
-                    options.onComplete();
-                }
-            },
-        });
-        // Add forward steps to timeline
-        for (let i = 0; i < sequence.steps.length; i++) {
-            const step = sequence.steps[i];
-            const delay = step.delay || 0;
-            // Create a nested timeline for each step
-            const stepTimeline = gsap.timeline({
-                onStart: () => {
-                    runtimeSequence.currentStep = i;
-                }
-            });
-            // Execute the step (this will add tweens to stepTimeline and emit events)
-            this.executeStep(step, stepTimeline, sequence, i);
-            // Add the step timeline to the main timeline
-            if (delay > 0) {
-                mainTimeline.add(stepTimeline, `+=${delay}`);
-            }
-            else {
-                mainTimeline.add(stepTimeline);
-            }
-        }
-        // Apply speed multiplier if provided
-        if (options.speed !== undefined && options.speed > 0) {
-            mainTimeline.timeScale(options.speed);
-        }
-        this.timelines.set(sequenceId, mainTimeline);
-    }
-    /**
-     * Pause an animation sequence
-     */
-    pauseSequence(sequenceId) {
-        const timeline = this.timelines.get(sequenceId);
-        const sequence = this.activeSequences.get(sequenceId);
-        if (timeline && sequence) {
-            timeline.pause();
-            sequence.isPaused = true;
-            sequence.isPlaying = false;
-        }
-    }
-    /**
-     * Resume a paused animation sequence
-     */
-    resumeSequence(sequenceId) {
-        const timeline = this.timelines.get(sequenceId);
-        const sequence = this.activeSequences.get(sequenceId);
-        if (timeline && sequence) {
-            timeline.resume();
-            sequence.isPaused = false;
-            sequence.isPlaying = true;
-        }
-    }
-    /**
-     * Stop an animation sequence
-     */
-    stopSequence(sequenceId) {
-        const timeline = this.timelines.get(sequenceId);
-        const sequence = this.activeSequences.get(sequenceId);
-        if (timeline) {
-            timeline.kill();
-            this.timelines.delete(sequenceId);
-        }
-        if (sequence) {
-            sequence.isPlaying = false;
-            sequence.isPaused = false;
-            sequence.currentStep = 0;
-            sequence.progress = 0;
-            // Clean up from activeSequences when stopped
-            this.activeSequences.delete(sequenceId);
-        }
-    }
-    /**
-     * Stop all animation sequences
-     */
-    stopAllSequences() {
-        this.activeSequences.forEach((_, sequenceId) => {
-            this.stopSequence(sequenceId);
-        });
-    }
-    /**
-     * @deprecated Use Redux to update sequences. This only affects runtime state.
-     */
-    updateSequence(sequenceId, updates) {
-        console.warn('AnimationsManager.updateSequence is deprecated. Use Redux.');
-        const sequence = this.activeSequences.get(sequenceId);
-        if (sequence) {
-            Object.assign(sequence, updates);
-        }
-    }
-    /**
-     * Check if a sequence is playing
-     */
-    isSequencePlaying(sequenceId) {
-        const sequence = this.activeSequences.get(sequenceId);
-        return sequence?.isPlaying || false;
-    }
-    /**
-     * Check if a sequence is paused
-     */
-    isSequencePaused(sequenceId) {
-        const sequence = this.activeSequences.get(sequenceId);
-        return sequence?.isPaused || false;
-    }
-    /**
-     * Seek to a specific progress point in the animation (0-1)
-     */
-    seekToProgress(sequenceId, progress) {
-        const timeline = this.timelines.get(sequenceId);
-        const sequence = this.activeSequences.get(sequenceId);
-        if (timeline && sequence) {
-            const clampedProgress = Math.max(0, Math.min(1, progress));
-            timeline.progress(clampedProgress);
-            sequence.progress = clampedProgress;
-        }
-    }
-    /**
-     * Go to the start of the animation
-     */
-    goToStart(sequenceId) {
-        this.seekToProgress(sequenceId, 0);
-    }
-    /**
-     * Go to the end of the animation
-     */
-    goToEnd(sequenceId) {
-        this.seekToProgress(sequenceId, 1);
-    }
-    /**
-     * Get the current progress of a sequence (0-1)
-     */
-    getProgress(sequenceId) {
-        const timeline = this.timelines.get(sequenceId);
-        return timeline?.progress() || 0;
-    }
-    /**
-     * Clear all active sequences and timelines
-     */
-    clear() {
-        this.stopAllSequences();
-        this.activeSequences.clear();
-        this.timelines.clear();
-    }
-    reverseSteps(sequence) {
-        // Create a deep copy of the sequence
-        const reversedSequence = {
-            ...sequence,
-            id: sequence.id,
-            steps: [...sequence.steps].reverse().map(step => {
-                // Deep copy the step
-                const reversedStep = {
-                    ...step,
-                    transitions: step.transitions.map(transition => {
-                        // Deep copy the transition
-                        const { properties } = transition;
-                        // Ensure we maintain the correct structure with from and to properties
-                        const reversedProperties = {
-                            from: properties.to || {},
-                            to: properties.from || {},
-                        };
-                        return {
-                            ...transition,
-                            properties: reversedProperties,
-                        };
-                    }),
-                };
-                return reversedStep;
-            }),
-        };
-        return reversedSequence;
-    }
     /**
      * Get progress based on start time and duration (uses wall-clock time like GSAP)
      * @param startTime - The timestamp when animation started (from performance.now() or Date.now())

package/dist/services/SceneActions.d.ts

@@ -1,24 +1,38 @@
 import type { ActionSequence } from '../types/actions';
 import { type SettingsPatch } from '../utils/settingsPatch';
 type Listener = () => void;
-export type SceneActionsEvent = {
+export type SceneActionsEvent = 
+/** `reapplied`: it was already applied (patches moved to the top). `runEffects`: false for a patch-only preview. */
+{
     type: 'applied';
     actionId: string;
+    action: ActionSequence;
+    reapplied: boolean;
+    runEffects: boolean;
 } | {
     type: 'reverted';
     actionId: string;
-} | {
+    action: ActionSequence;
+}
+/** `actions`: those that were applied until now. */
+ | {
     type: 'reset';
+    actions: ActionSequence[];
 };
+export interface ApplyActionOptions {
+    /** Run the action's effects (default true). The editor previews patches only. */
+    effects?: boolean;
+}
 declare class SceneActions {
     private stacks;
     private merged;
+    /** Applied actions, by id — the definition as it was applied (for revert events). */
     private applied;
     private stateListeners;
     private eventListeners;
     private version;
     /** Apply an action. Re-applying moves its patches to the top of each stack. */
-    applyAction(action: ActionSequence): void;
+    applyAction(action: ActionSequence, options?: ApplyActionOptions): void;
     /** Remove an action's patches from every element it touched. */
     revertAction(actionOrId: ActionSequence | string): void;
     /** Apply when not applied, revert when applied. Returns true when it applied. */

package/dist/services/SceneActions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SceneActions.d.ts","sourceRoot":"","sources":["../../src/services/SceneActions.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAA0B,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEpF,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAE3B,MAAM,MAAM,iBAAiB,GACvB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAOxB,cAAM,YAAY;IACd,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,MAAM,CAAgD;IAC9D,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,cAAc,CAAoC;IAC1D,OAAO,CAAC,cAAc,CAAiD;IACvE,OAAO,CAAC,OAAO,CAAK;IAEpB,+EAA+E;IAC/E,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAazC,gEAAgE;IAChE,YAAY,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI;IAQvD,iFAAiF;IACjF,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO;IAS7C,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI1C,mBAAmB,IAAI,MAAM,EAAE;IAI/B,8DAA8D;IAC9D,KAAK,IAAI,IAAI;IAOb,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,aAAa,GAAG,SAAS;IAKrE,iEAAiE;IACjE,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI;IAaxD,iFAAiF;IACjF,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,MAAM,IAAI;IAKjE,yFAAyF;IACzF,UAAU,IAAI,MAAM;IAIpB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,MAAM;CAgBjB;AAED,QAAA,MAAM,YAAY,cAAqB,CAAC;AACxC,eAAe,YAAY,CAAC"}
+{"version":3,"file":"SceneActions.d.ts","sourceRoot":"","sources":["../../src/services/SceneActions.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAA0B,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEpF,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAE3B,MAAM,MAAM,iBAAiB;AACzB,oHAAoH;AAClH;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,GACtG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE;AAChE,oDAAoD;GAClD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,cAAc,EAAE,CAAA;CAAE,CAAC;AAEnD,MAAM,WAAW,kBAAkB;IAC/B,iFAAiF;IACjF,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAOD,cAAM,YAAY;IACd,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,MAAM,CAAgD;IAC9D,qFAAqF;IACrF,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,cAAc,CAAoC;IAC1D,OAAO,CAAC,cAAc,CAAiD;IACvE,OAAO,CAAC,OAAO,CAAK;IAEpB,+EAA+E;IAC/E,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,GAAE,kBAAuB,GAAG,IAAI;IAc3E,gEAAgE;IAChE,YAAY,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI;IASvD,iFAAiF;IACjF,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO;IAS7C,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI1C,mBAAmB,IAAI,MAAM,EAAE;IAI/B,8DAA8D;IAC9D,KAAK,IAAI,IAAI;IAQb,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,aAAa,GAAG,SAAS;IAKrE,iEAAiE;IACjE,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI;IAaxD,iFAAiF;IACjF,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,MAAM,IAAI;IAKjE,yFAAyF;IACzF,UAAU,IAAI,MAAM;IAIpB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,MAAM;CAgBjB;AAED,QAAA,MAAM,YAAY,cAAqB,CAAC;AACxC,eAAe,YAAY,CAAC"}

package/dist/services/SceneActions.js

@@ -2,12 +2,14 @@ import { composeSettingsPatches } from '../utils/settingsPatch.js';
 class SceneActions {
     stacks = new Map();
     merged = new Map();
-    applied = new Set();
+    /** Applied actions, by id — the definition as it was applied (for revert events). */
+    applied = new Map();
     stateListeners = new Map();
     eventListeners = new Set();
     version = 0;
     /** Apply an action. Re-applying moves its patches to the top of each stack. */
-    applyAction(action) {
+    applyAction(action, options = {}) {
+        const reapplied = this.applied.has(action.id);
         const touched = this.removeEntries(action.id);
         for (const target of action.targets ?? []) {
             if (!target?.state || !target.patch || Object.keys(target.patch).length === 0)
@@ -17,17 +19,18 @@ class SceneActions {
             this.stacks.set(target.state, stack);
             touched.add(target.state);
         }
-        this.applied.add(action.id);
-        this.commit(touched, { type: 'applied', actionId: action.id });
+        this.applied.set(action.id, action);
+        this.commit(touched, { type: 'applied', actionId: action.id, action, reapplied, runEffects: options.effects !== false });
     }
     /** Remove an action's patches from every element it touched. */
     revertAction(actionOrId) {
         const actionId = typeof actionOrId === 'string' ? actionOrId : actionOrId.id;
-        if (!this.applied.has(actionId))
+        const action = this.applied.get(actionId);
+        if (!action)
             return;
         const touched = this.removeEntries(actionId);
         this.applied.delete(actionId);
-        this.commit(touched, { type: 'reverted', actionId });
+        this.commit(touched, { type: 'reverted', actionId, action });
     }
     /** Apply when not applied, revert when applied. Returns true when it applied. */
     toggleAction(action) {
@@ -42,14 +45,15 @@ class SceneActions {
         return this.applied.has(actionId);
     }
     getAppliedActionIds() {
-        return Array.from(this.applied);
+        return Array.from(this.applied.keys());
     }
     /** Drop every patch (project load, "reset" in the editor). */
     reset() {
         const touched = new Set(this.stacks.keys());
+        const actions = Array.from(this.applied.values());
         this.stacks.clear();
         this.applied.clear();
-        this.commit(touched, { type: 'reset' });
+        this.commit(touched, { type: 'reset', actions });
     }
     /** The merged patch for one element — stable identity until it changes. */
     getPatch(state) {

package/dist/services/ShadersLibrary.d.ts

@@ -1,4 +1,4 @@
-import type { OptionalProperty } from "../utils/optionalProperties";
+import type { OptionalProperty } from "../properties/tables/optionalProperties";
 import type { UniformDefinition } from "../types/types";
 export type CustomShaderSettings = {
     name: string;

package/dist/services/ShadersLibrary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ShadersLibrary.d.ts","sourceRoot":"","sources":["../../src/services/ShadersLibrary.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,MAAM,MAAM,oBAAoB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AA+wBhC,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;GAS1B,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,KAAG,oBAAoB,GAAG;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,CAAC;QACP,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;KACxB,GAAG;QACA,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,EAAE,CAAC;KAC1B,GAAG;QACA,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;KACxB,CAAC,EAAE,CAAC;IACL,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACpB,GAAG,SAEP,CAAC;AAEF,eAAO,MAAM,uBAAuB,QAAO,MAAM,EAEhD,CAAC;AACF,eAAO,MAAM,mBAAmB,QAAO,CAAC,oBAAoB,GAAG;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,CAAC;QACP,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;KACxB,GAAG;QACA,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,EAAE,CAAC;KAC1B,GAAG;QACA,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;KACxB,CAAC,EAAE,CAAC;IACL,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACpB,CAAC,EAEL,CAAC;AACF,eAAO,MAAM,qBAAqB,GAAI,MAAM,MAAM,KAAG,gBAAgB,EAgBpE,CAAC"}
+{"version":3,"file":"ShadersLibrary.d.ts","sourceRoot":"","sources":["../../src/services/ShadersLibrary.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,MAAM,MAAM,oBAAoB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AA+wBhC,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;GAS1B,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,KAAG,oBAAoB,GAAG;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,CAAC;QACP,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;KACxB,GAAG;QACA,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,EAAE,CAAC;KAC1B,GAAG;QACA,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;KACxB,CAAC,EAAE,CAAC;IACL,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACpB,GAAG,SAEP,CAAC;AAEF,eAAO,MAAM,uBAAuB,QAAO,MAAM,EAEhD,CAAC;AACF,eAAO,MAAM,mBAAmB,QAAO,CAAC,oBAAoB,GAAG;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,CAAC;QACP,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;KACxB,GAAG;QACA,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,EAAE,CAAC;KAC1B,GAAG;QACA,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;KACxB,CAAC,EAAE,CAAC;IACL,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACpB,CAAC,EAEL,CAAC;AACF,eAAO,MAAM,qBAAqB,GAAI,MAAM,MAAM,KAAG,gBAAgB,EAgBpE,CAAC"}

package/dist/services/index.d.ts

@@ -1,7 +1,6 @@
 import texturesManager from './TexturesManager';
 export type { MaterialDefinition, MaterialInstance, MaterialVariant, ShaderSource, UniformInfo, } from './MaterialRegistry';
 export type { FontInfo } from './FontManager';
-export type { AnimationEvent, AnimationEventType } from './AnimationsManager';
 export type { SkyTimeState, TimeOfDayLabel } from './SkySystemManager';
 export { MaterialRegistry, default as MaterialRegistryAPI } from './MaterialRegistry';
 export * from '../utils/MaterialCompiler';
@@ -17,5 +16,5 @@ export { SkySystemManager, skySystemManager } from './SkySystemManager';
 export { CubeCameraManager, cubeCameraManager } from './CubeCameraManager';
 export { default as SceneStore } from './SceneStore';
 export { default as SceneActions } from './SceneActions';
-export type { SceneActionsEvent } from './SceneActions';
+export type { SceneActionsEvent, ApplyActionOptions } from './SceneActions';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,GAAG,MAAM,oBAAoB,CAAC;AAE5H,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9E,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEvE,OAAO,EAAE,gBAAgB,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACtF,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC1F,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACzD,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,GAAG,MAAM,oBAAoB,CAAC;AAE5H,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG9C,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEvE,OAAO,EAAE,gBAAgB,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACtF,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC1F,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACzD,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/shaders/WallpaperGridMaterial.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WallpaperGridMaterial.d.ts","sourceRoot":"","sources":["../../src/shaders/WallpaperGridMaterial.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B;;;;;GAKG;AACH,MAAM,WAAW,6BAA6B;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC;IACzB,cAAc,EAAE,KAAK,CAAC,KAAK,CAAC;IAC5B,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC;IACzB,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC;IACzB,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC;IACvB,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,sIAAsI;IACtI,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,MAAM,EAAE,YAAY,CAAC;IACrB,yFAAyF;IACzF,IAAI,EAAE,YAAY,CAAC;IACnB,yFAAyF;IACzF,IAAI,EAAE,YAAY,CAAC;IACnB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,QAAQ,EAAE,YAAY,CAAC;IACvB,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,KAAK,EAAE,YAAY,CAAC;IACpB,kGAAkG;IAClG,MAAM,EAAE,YAAY,CAAC;IACrB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,IAAI,EAAE,YAAY,CAAC;IACnB,uCAAuC;IACvC,IAAI,EAAE,YAAY,CAAC;IACnB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,QAAQ,EAAE,YAAY,CAAC;IACvB,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,KAAK,EAAE,YAAY,CAAC;IACpB,qDAAqD;IACrD,MAAM,EAAE,YAAY,CAAC;IACrB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,OAAO,QAAQ,oBAAoB,CAAC;IAChC,UAAU,aAAa;QACnB,qBAAqB,EAAE,aAAa,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAAC;KACnG;CACJ;AAED,eAAO,MAAM,6BAA6B,EAAE,6BA8C3C,CAAC;AAmVF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkDjC,CAAC"}
+{"version":3,"file":"WallpaperGridMaterial.d.ts","sourceRoot":"","sources":["../../src/shaders/WallpaperGridMaterial.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B;;;;;GAKG;AACH,MAAM,WAAW,6BAA6B;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC;IACzB,cAAc,EAAE,KAAK,CAAC,KAAK,CAAC;IAC5B,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC;IACzB,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC;IACzB,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC;IACvB,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,sIAAsI;IACtI,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,MAAM,EAAE,YAAY,CAAC;IACrB,yFAAyF;IACzF,IAAI,EAAE,YAAY,CAAC;IACnB,yFAAyF;IACzF,IAAI,EAAE,YAAY,CAAC;IACnB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,QAAQ,EAAE,YAAY,CAAC;IACvB,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,KAAK,EAAE,YAAY,CAAC;IACpB,kGAAkG;IAClG,MAAM,EAAE,YAAY,CAAC;IACrB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,IAAI,EAAE,YAAY,CAAC;IACnB,uCAAuC;IACvC,IAAI,EAAE,YAAY,CAAC;IACnB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,QAAQ,EAAE,YAAY,CAAC;IACvB,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,KAAK,EAAE,YAAY,CAAC;IACpB,qDAAqD;IACrD,MAAM,EAAE,YAAY,CAAC;IACrB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,OAAO,QAAQ,oBAAoB,CAAC;IAChC,UAAU,aAAa;QACnB,qBAAqB,EAAE,aAAa,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAAC;KACnG;CACJ;AAED,eAAO,MAAM,6BAA6B,EAAE,6BA8C3C,CAAC;AAwVF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkDjC,CAAC"}

package/dist/shaders/WallpaperGridMaterial.js

@@ -68,7 +68,12 @@ const vertex = /* glsl */ `
     return fract(p.x * p.y);
   }
 
-  
+  // Farris' recipe: a lattice-periodic motif m(q) summed over the coset
+  // representatives g of a wallpaper group, F(p) = sum_g m(g.q), q = B^-1 p.
+  // For any h in the group, {g h} runs over the same cosets, and m ignores
+  // lattice translations, so F(h.p) = F(p) exactly: the picture has precisely
+  // the group's mirrors, glides and rotation centres, and tiles seamlessly.
+  // Level sets of F are the lines; its value bands are the cells.
   uniform vec2  u_wave[6];
   uniform mat2  u_RA[12];
   uniform vec2  u_TA[12];

package/dist/three/GalleryLayoutV.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GalleryLayoutV.d.ts","sourceRoot":"","sources":["../../src/three/GalleryLayoutV.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9D,MAAM,WAAW,qBAAqB;IAClC,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAGD,qBAAa,cAAc;IACvB,OAAO,CAAC,MAAM,CAAC;IACf,OAAO,CAAC,KAAK,CAAC;IACd,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,aAAa,CAAC;IACtB,OAAO,CAAC,OAAO,CAAC;gBACJ,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,aAAa,EAAE,qBAAqB,EAAE,OAAO,GAAE,qBAA0B;IAQ7G,OAAO,CAAC,KAAK;IAmCb,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAc,GAAG,IAAI;IAGpD,mBAAmB,CAAC,aAAa,EAAE,qBAAqB,GAAG,IAAI;IAK/D,OAAO,CAAC,eAAe,GAAE,OAAc,GAAG,IAAI;CAWjD"}
+{"version":3,"file":"GalleryLayoutV.d.ts","sourceRoot":"","sources":["../../src/three/GalleryLayoutV.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9D,MAAM,WAAW,qBAAqB;IAClC,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAGD,qBAAa,cAAc;IACvB,OAAO,CAAC,MAAM,CAAC;IACf,OAAO,CAAC,KAAK,CAAC;IACd,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,aAAa,CAAC;IACtB,OAAO,CAAC,OAAO,CAAC;gBACJ,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,aAAa,EAAE,qBAAqB,EAAE,OAAO,GAAE,qBAA0B;IAQ7G,OAAO,CAAC,KAAK;IA0Bb,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAc,GAAG,IAAI;IAGpD,mBAAmB,CAAC,aAAa,EAAE,qBAAqB,GAAG,IAAI;IAK/D,OAAO,CAAC,eAAe,GAAE,OAAc,GAAG,IAAI;CAWjD"}

package/dist/three/GalleryLayoutV.js

@@ -2,7 +2,6 @@ import * as THREE from 'three';
 import { updateCurrentLayoutSettings } from '../utils/galleriesUtils.js';
 import { FrameV } from './FrameV.js';
 import { ImageGeometryV } from './ImageGeometryV.js';
-import { EffectsGeneratorV } from './EffectsGeneratorV.js';
 export class GalleryLayoutV {
     parent;
     group;
@@ -44,15 +43,6 @@ export class GalleryLayoutV {
                 this.imageGeos.push(ig);
             }
         }
-        if (this.createdObject.effects) {
-            for (const effectSettings of this.createdObject.effects) {
-                if (effectSettings.enabled) {
-                    const fxParent = new THREE.Group();
-                    this.group.add(fxParent);
-                    this.effects.push(new EffectsGeneratorV(fxParent, effectSettings));
-                }
-            }
-        }
     }
     update(elapsed, delta = 0.016) {
         this.effects.forEach(fx => fx.update(elapsed, delta));

package/dist/three/SceneBuilderV.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SceneBuilderV.d.ts","sourceRoot":"","sources":["../../src/three/SceneBuilderV.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAUvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,MAAM,WAAW,oBAAoB;IACjC,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;CAC9B;AAGD,qBAAa,aAAa;IACtB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,aAAa,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,iBAAiB,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,OAAO,CAAC,SAAS,CAAC;IAClB,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,kBAAkB,CAAQ;IAClC,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,KAAK,CAAqB;gBACtB,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,GAAE,oBAAyB;IAuG5F,OAAO,CAAC,SAAS;IA6BjB,OAAO,CAAC,WAAW;IA8EnB,OAAO,CAAC,OAAO;IASf,OAAO,CAAC,YAAY;IASpB,OAAO,IAAI,IAAI;CAWlB"}
+{"version":3,"file":"SceneBuilderV.d.ts","sourceRoot":"","sources":["../../src/three/SceneBuilderV.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAUvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,MAAM,WAAW,oBAAoB;IACjC,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;CAC9B;AAGD,qBAAa,aAAa;IACtB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,aAAa,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,iBAAiB,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,OAAO,CAAC,SAAS,CAAC;IAClB,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,kBAAkB,CAAQ;IAClC,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,KAAK,CAAqB;gBACtB,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,GAAE,oBAAyB;IAuG5F,OAAO,CAAC,SAAS;IAuBjB,OAAO,CAAC,WAAW;IA8EnB,OAAO,CAAC,OAAO;IASf,OAAO,CAAC,YAAY;IASpB,OAAO,IAAI,IAAI;CAWlB"}

package/dist/three/SceneBuilderV.js

@@ -144,13 +144,7 @@ export class SceneBuilderV {
         if (createdObject.type !== 'group') {
             this.buildObject(createdObject, group);
         }
-        // Per-object effects — EffectsGeneratorV needs the scene as parent
-        if (createdObject.effects?.length) {
-            createdObject.effects.forEach((effect) => {
-                // const fx = new EffectsGeneratorV(this.scene, effect);
-                // this.updatables.push(fx as unknown as Updatable);
-            });
-        }
+        // Object effects (createdObject.effects) run on the viewer's operations runtime — not in the vanilla build.
         children.forEach((child) => this.buildNode(child, group));
     }
     buildObject(obj, parent) {

package/dist/types/actions.d.ts

@@ -1,3 +1,4 @@
+import type { OperationEffect } from './objectSettings';
 /**
  * Action Types
  * Defines the structure for UI actions that can trigger animations, toggle elements, or load projects
@@ -28,7 +29,7 @@ export type ActionsSet = {
 };
 /**
  * One element an action changes: `state` addresses it (a scene object id, or one of
- * 'camera' | 'sky' | 'ocean' | 'clouds'), and `patch` is a deep partial of that
+ * 'camera' | 'sky' | 'ocean' | 'clouds' | 'terrain'), and `patch` is a deep partial of that
  * element's own settings — `{ materialSettings: { materialVariant: 'Glass' } }`,
  * `{ config: { intensity: 4 } }`, `{ meshSettings: { position: [0, 2, 0] } }`.
  */
@@ -54,6 +55,12 @@ export interface ActionSequence {
     key?: string;
     description?: string;
     targets: ActionTarget[];
+    /**
+     * Operations run when the action is applied, undone when it is reverted
+     * (glow, fade, zoom to…). Patches change what elements ARE; effects are what
+     * HAPPENS to objects. Patches are applied first.
+     */
+    effects?: OperationEffect[];
     assetId?: string | null;
     /** Runtime only */
     isDirty?: boolean;