@3driseai/3drise-core 1.0.17 → 1.0.19

package/dist/services/AnimationsManager.d.ts

@@ -1,114 +1,14 @@
-import type { AnimationSequence, TransitionStep, AnimationPlaybackOptions, PathConfig } from "../types/animations";
+import type { PathConfig } from "../types/animations";
 import type { Vector3Array } from "../types/scene3d";
-export type AnimationEventType = 'sequenceStart' | 'sequenceEnd' | 'stepStart' | 'stepEnd';
-export interface AnimationEvent {
-    type: AnimationEventType;
-    sequenceId: string;
-    sequence: AnimationSequence;
-    step?: TransitionStep;
-    stepIndex?: number;
-}
-type AnimationEventListener = (event: AnimationEvent) => void;
 /**
- * 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.
  */
 declare class AnimationsManager {
-    private activeSequences;
     private paths;
-    private timelines;
-    private eventListeners;
-    constructor();
-    /**
-     * Add an event listener
-     */
-    on(eventType: AnimationEventType, listener: AnimationEventListener): void;
-    /**
-     * Remove an event listener
-     */
-    off(eventType: AnimationEventType, listener: AnimationEventListener): void;
-    /**
-     * Emit an event
-     */
-    private emit;
-    /**
-     * @deprecated Sequences are now managed in Redux. Use playSequence(sequence) directly.
-     * This method is kept for backwards compatibility during migration.
-     */
-    addSequence(sequence: AnimationSequence): AnimationSequence;
-    /**
-     * @deprecated Sequences are now managed in Redux.
-     */
-    removeSequence(sequenceId: string): void;
-    /**
-     * Get an actively playing sequence's runtime state
-     */
-    getSequence(sequenceId: string): AnimationSequence | undefined;
-    /**
-     * @deprecated Sequences are now managed in Redux. Use Redux selectors instead.
-     */
-    getAllSequences(): AnimationSequence[];
-    /**
-     * Execute a single animation step with multiple transitions
-     * Returns a GSAP timeline for this step
-     */
-    private executeStep;
-    /**
-     * Play an animation sequence
-     * @param sequenceOrId - Either a full AnimationSequence object or a sequence ID (for backwards compat)
-     * @param options - Playback options
-     */
-    playSequence(sequenceOrId: AnimationSequence | string, options?: AnimationPlaybackOptions): Promise<void>;
-    /**
-     * Pause an animation sequence
-     */
-    pauseSequence(sequenceId: string): void;
-    /**
-     * Resume a paused animation sequence
-     */
-    resumeSequence(sequenceId: string): void;
-    /**
-     * Stop an animation sequence
-     */
-    stopSequence(sequenceId: string): void;
-    /**
-     * Stop all animation sequences
-     */
-    stopAllSequences(): void;
-    /**
-     * @deprecated Use Redux to update sequences. This only affects runtime state.
-     */
-    updateSequence(sequenceId: string, updates: Partial<AnimationSequence>): void;
-    /**
-     * Check if a sequence is playing
-     */
-    isSequencePlaying(sequenceId: string): boolean;
-    /**
-     * Check if a sequence is paused
-     */
-    isSequencePaused(sequenceId: string): boolean;
-    /**
-     * Seek to a specific progress point in the animation (0-1)
-     */
-    seekToProgress(sequenceId: string, progress: number): void;
-    /**
-     * Go to the start of the animation
-     */
-    goToStart(sequenceId: string): void;
-    /**
-     * Go to the end of the animation
-     */
-    goToEnd(sequenceId: string): void;
-    /**
-     * Get the current progress of a sequence (0-1)
-     */
-    getProgress(sequenceId: string): number;
-    /**
-     * Clear all active sequences and timelines
-     */
-    clear(): void;
-    reverseSteps(sequence: AnimationSequence): AnimationSequence;
     /**
      * 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/AnimationsManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AnimationsManager.d.ts","sourceRoot":"","sources":["../../src/services/AnimationsManager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AnimationsManager.d.ts","sourceRoot":"","sources":["../../src/services/AnimationsManager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD;;;;;;GAMG;AACH,cAAM,iBAAiB;IACnB,OAAO,CAAC,KAAK,CAAe;IAC5B;;;;;;OAMG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,MAAiB,GAAG,MAAM;IAYzF;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM;IAM7E;;OAEG;IACH,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,aAAa,GAAE,YAAY,EAAO,GAAG,MAAM;IAUrE;;OAEG;IACH,OAAO,CAAC,YAAY,EAAE,UAAU,GAAG,IAAI;IAGvC;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAG/C;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE,GAAG,SAAS;IAGzD;;OAEG;IACH,WAAW,IAAI,UAAU,EAAE;IAG3B;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,GAAG,IAAI;IAM1E;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI;IAM9D;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI;IAMzD;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAMxD;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAGhC;;OAEG;IACH,aAAa,IAAI,IAAI;CAGxB;;AAED,wBAAuC"}

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())
@@ -402,6 +16,10 @@ class AnimationsManager {
      * @returns Eased progress value from 0 to 1
      */
     getProgressFromTime(startTime, duration, ease = 'linear') {
+        // Zero-length steps (actions) are complete immediately. Without this, elapsed/0 is
+        // NaN on the first frame (elapsed 0) and every lerp downstream goes NaN.
+        if (!(duration > 0))
+            return 1;
         const elapsed = (performance.now() - startTime) / 1000; // Convert ms to seconds
         const linearProgress = Math.min(Math.max(elapsed / duration, 0), 1);
         // Convert GSAP ease string to easing function name if needed

package/dist/services/SceneActions.d.ts

@@ -0,0 +1,57 @@
+import type { ActionSequence } from '../types/actions';
+import { type SettingsPatch } from '../utils/settingsPatch';
+type Listener = () => void;
+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, 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. */
+    toggleAction(action: ActionSequence): boolean;
+    isActionApplied(actionId: string): boolean;
+    getAppliedActionIds(): string[];
+    /** Drop every patch (project load, "reset" in the editor). */
+    reset(): void;
+    /** The merged patch for one element — stable identity until it changes. */
+    getPatch(state: string | undefined | null): SettingsPatch | undefined;
+    /** Subscribe to one element's patch. Returns the unsubscribe. */
+    subscribe(state: string, listener: Listener): () => void;
+    /** Subscribe to apply / revert / reset events (UI badges, the component API). */
+    onEvent(listener: (event: SceneActionsEvent) => void): () => void;
+    /** Monotonic counter, bumped on every change (a cheap useSyncExternalStore snapshot). */
+    getVersion(): number;
+    private removeEntries;
+    private commit;
+}
+declare const sceneActions: SceneActions;
+export default sceneActions;
+//# sourceMappingURL=SceneActions.d.ts.map

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

@@ -0,0 +1 @@
+{"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"}