@codexo/exojs 0.13.0 → 0.15.0

package/dist/esm/animation/TweenManager.d.ts

@@ -1,17 +1,30 @@
+import type { System } from '#core/System';
+import type { Time } from '#core/Time';
 import { Tween } from './Tween';
+import { TweenSequencer } from './TweenSequencer';
+/** Any object that can be driven each frame by a delta in seconds. @internal */
+interface Ticker {
+    update(deltaSeconds: number): void;
+}
 /**
  * Owns and advances a collection of {@link Tween} instances, driving them
  * once per frame from {@link Application.update}. Created tweens are tracked
  * automatically; manually constructed tweens can be opted in via
  * {@link TweenManager.add}.
  *
+ * Custom updatables (such as {@link TweenSequencer}) can be registered via
+ * {@link TweenManager.addTicker} so they share the same frame tick.
+ *
  * Update iteration uses a snapshot so callbacks may freely add or remove
  * tweens during the same frame without corrupting the loop. Completed and
  * stopped tweens are evicted automatically.
  * @stable
  */
-export declare class TweenManager {
+export declare class TweenManager implements System {
+    /** App-systems tick band — tweens after audio. @internal */
+    readonly order = 400;
     private _tweens;
+    private _tickers;
     private _destroyed;
     /**
      * Create a new Tween targeting `target`, register it with this manager, and
@@ -32,6 +45,22 @@ export declare class TweenManager {
      * ```
      */
     sequence(tweens: readonly Tween[]): Tween;
+    /**
+     * Create a new {@link TweenSequencer} bound to this manager and return it.
+     * The sequencer registers itself automatically when {@link TweenSequencer.start}
+     * is called, so no manual wiring is needed.
+     *
+     * @example
+     * ```ts
+     * scene.tweens.createSequencer()
+     *   .then(fadeIn)
+     *   .wait(0.5)
+     *   .then([moveLeft, scaleUp])
+     *   .onComplete(() => console.log('done'))
+     *   .start();
+     * ```
+     */
+    createSequencer(): TweenSequencer;
     /**
      * Explicitly add a stand-alone Tween (created via `new Tween(target)`)
      * to this manager so it participates in the update loop.
@@ -40,17 +69,31 @@ export declare class TweenManager {
     /** Remove a tween from the manager. Called automatically on stop/complete. */
     remove(tween: Tween): this;
     /**
-     * Advance all active tweens by deltaSeconds. Called once per frame by
-     * Application.update(). Uses a snapshot of the list so that callbacks that
-     * add or remove tweens do not corrupt mid-iteration.
+     * Register a custom updatable so it is driven each frame alongside tweens.
+     * Idempotent — registering the same ticker twice is a no-op.
+     *
+     * Used internally by {@link TweenSequencer}.
      */
-    update(deltaSeconds: number): void;
+    addTicker(ticker: Ticker): this;
+    /**
+     * Remove a previously registered ticker. Called automatically by
+     * {@link TweenSequencer} when it completes or is stopped.
+     */
+    removeTicker(ticker: Ticker): this;
+    /**
+     * Advance all active tweens by the frame `delta` (read as seconds), then
+     * advance all registered tickers. Ticked once per frame via
+     * {@link Application.systems}. Uses snapshots so callbacks that add or
+     * remove tweens/tickers do not corrupt mid-iteration.
+     */
+    update(delta: Time): void;
     /**
-     * Remove all tweens immediately. No callbacks (onComplete etc.) fire.
+     * Remove all tweens and tickers immediately. No callbacks fire.
      * The tweens' states are left as-is; they are simply evicted from the list.
      */
     clear(): this;
-    /** Tear down the manager. Clears tweens and makes subsequent updates no-ops. */
+    /** Tear down the manager. Clears tweens and tickers and makes subsequent updates no-ops. */
     destroy(): void;
 }
+export {};
 //# sourceMappingURL=TweenManager.d.ts.map

package/dist/esm/animation/TweenManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TweenManager.d.ts","sourceRoot":"","sources":["../../../src/animation/TweenManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC;;;;;;;;;;GAUG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,UAAU,CAAS;IAE3B;;;OAGG;IACI,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IAQpD;;;;;;;;;;;;OAYG;IACI,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,KAAK;IAgBhD;;;OAGG;IACI,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAU9B,8EAA8E;IACvE,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAUjC;;;;OAIG;IACI,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAUzC;;;OAGG;IACI,KAAK,IAAI,IAAI;IAMpB,gFAAgF;IACzE,OAAO,IAAI,IAAI;CAIvB"}
+{"version":3,"file":"TweenManager.d.ts","sourceRoot":"","sources":["../../../src/animation/TweenManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,gFAAgF;AAChF,UAAU,MAAM;IACd,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,YAAa,YAAW,MAAM;IACzC,4DAA4D;IAC5D,SAAgB,KAAK,OAAO;IAC5B,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,UAAU,CAAS;IAE3B;;;OAGG;IACI,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IAQpD;;;;;;;;;;;;OAYG;IACI,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,KAAK;IAoBhD;;;;;;;;;;;;;;OAcG;IACI,eAAe,IAAI,cAAc;IAIxC;;;OAGG;IACI,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAU9B,8EAA8E;IACvE,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAUjC;;;;;OAKG;IACI,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQtC;;;OAGG;IACI,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAUzC;;;;;OAKG;IACI,MAAM,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI;IAgBhC;;;OAGG;IACI,KAAK,IAAI,IAAI;IAOpB,4FAA4F;IACrF,OAAO,IAAI,IAAI;CAIvB"}

package/dist/esm/animation/TweenManager.js

@@ -1,4 +1,5 @@
 import { Tween } from './Tween.js';
+import { TweenSequencer } from './TweenSequencer.js';
 
 /**
  * Owns and advances a collection of {@link Tween} instances, driving them
@@ -6,13 +7,19 @@ import { Tween } from './Tween.js';
  * automatically; manually constructed tweens can be opted in via
  * {@link TweenManager.add}.
  *
+ * Custom updatables (such as {@link TweenSequencer}) can be registered via
+ * {@link TweenManager.addTicker} so they share the same frame tick.
+ *
  * Update iteration uses a snapshot so callbacks may freely add or remove
  * tweens during the same frame without corrupting the loop. Completed and
  * stopped tweens are evicted automatically.
  * @stable
  */
 class TweenManager {
+    /** App-systems tick band — tweens after audio. @internal */
+    order = 400;
     _tweens = [];
+    _tickers = [];
     _destroyed = false;
     /**
      * Create a new Tween targeting `target`, register it with this manager, and
@@ -38,16 +45,38 @@ class TweenManager {
      * ```
      */
     sequence(tweens) {
-        if (tweens.length === 0) {
+        const [first] = tweens;
+        if (first === undefined) {
             throw new Error('[ExoJS] TweenManager.sequence() requires at least one tween.');
         }
         for (let i = 0; i < tweens.length - 1; i++) {
-            tweens[i].chain(tweens[i + 1]);
+            const current = tweens[i];
+            const next = tweens[i + 1];
+            if (current !== undefined && next !== undefined)
+                current.chain(next);
         }
         for (const tween of tweens) {
             this.add(tween);
         }
-        return tweens[0];
+        return first;
+    }
+    /**
+     * Create a new {@link TweenSequencer} bound to this manager and return it.
+     * The sequencer registers itself automatically when {@link TweenSequencer.start}
+     * is called, so no manual wiring is needed.
+     *
+     * @example
+     * ```ts
+     * scene.tweens.createSequencer()
+     *   .then(fadeIn)
+     *   .wait(0.5)
+     *   .then([moveLeft, scaleUp])
+     *   .onComplete(() => console.log('done'))
+     *   .start();
+     * ```
+     */
+    createSequencer() {
+        return new TweenSequencer(this);
     }
     /**
      * Explicitly add a stand-alone Tween (created via `new Tween(target)`)
@@ -69,27 +98,56 @@ class TweenManager {
         return this;
     }
     /**
-     * Advance all active tweens by deltaSeconds. Called once per frame by
-     * Application.update(). Uses a snapshot of the list so that callbacks that
-     * add or remove tweens do not corrupt mid-iteration.
+     * Register a custom updatable so it is driven each frame alongside tweens.
+     * Idempotent — registering the same ticker twice is a no-op.
+     *
+     * Used internally by {@link TweenSequencer}.
      */
-    update(deltaSeconds) {
+    addTicker(ticker) {
+        if (!this._tickers.includes(ticker)) {
+            this._tickers.push(ticker);
+        }
+        return this;
+    }
+    /**
+     * Remove a previously registered ticker. Called automatically by
+     * {@link TweenSequencer} when it completes or is stopped.
+     */
+    removeTicker(ticker) {
+        const index = this._tickers.indexOf(ticker);
+        if (index !== -1) {
+            this._tickers.splice(index, 1);
+        }
+        return this;
+    }
+    /**
+     * Advance all active tweens by the frame `delta` (read as seconds), then
+     * advance all registered tickers. Ticked once per frame via
+     * {@link Application.systems}. Uses snapshots so callbacks that add or
+     * remove tweens/tickers do not corrupt mid-iteration.
+     */
+    update(delta) {
         if (this._destroyed)
             return;
         const snapshot = [...this._tweens];
         for (const tween of snapshot) {
-            tween.update(deltaSeconds);
+            tween.update(delta.seconds);
+        }
+        const tickerSnapshot = [...this._tickers];
+        for (const ticker of tickerSnapshot) {
+            ticker.update(delta.seconds);
         }
     }
     /**
-     * Remove all tweens immediately. No callbacks (onComplete etc.) fire.
+     * Remove all tweens and tickers immediately. No callbacks fire.
      * The tweens' states are left as-is; they are simply evicted from the list.
      */
     clear() {
         this._tweens = [];
+        this._tickers = [];
         return this;
     }
-    /** Tear down the manager. Clears tweens and makes subsequent updates no-ops. */
+    /** Tear down the manager. Clears tweens and tickers and makes subsequent updates no-ops. */
     destroy() {
         this.clear();
         this._destroyed = true;

package/dist/esm/animation/TweenManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"TweenManager.js","sources":["../../../../src/animation/TweenManager.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA;;;;;;;;;;AAUG;MACU,YAAY,CAAA;IACf,OAAO,GAAY,EAAE;IACrB,UAAU,GAAG,KAAK;AAE1B;;;AAGG;AACI,IAAA,MAAM,CAAmB,MAAS,EAAA;AACvC,QAAA,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC;AAC/B,QAAA,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC;AAC1B,QAAA,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;AAExB,QAAA,OAAO,KAAK;IACd;AAEA;;;;;;;;;;;;AAYG;AACI,IAAA,QAAQ,CAAC,MAAwB,EAAA;AACtC,QAAA,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE;AACvB,YAAA,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC;QACjF;AAEA,QAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE;AAC1C,YAAA,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAChC;AAEA,QAAA,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE;AAC1B,YAAA,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;QACjB;AAEA,QAAA,OAAO,MAAM,CAAC,CAAC,CAAC;IAClB;AAEA;;;AAGG;AACI,IAAA,GAAG,CAAC,KAAY,EAAA;AACrB,QAAA,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC;QAE1B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE;AACjC,YAAA,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;QAC1B;AAEA,QAAA,OAAO,IAAI;IACb;;AAGO,IAAA,MAAM,CAAC,KAAY,EAAA;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;AAEzC,QAAA,IAAI,KAAK,KAAK,EAAE,EAAE;YAChB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/B;AAEA,QAAA,OAAO,IAAI;IACb;AAEA;;;;AAIG;AACI,IAAA,MAAM,CAAC,YAAoB,EAAA;QAChC,IAAI,IAAI,CAAC,UAAU;YAAE;QAErB,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;AAElC,QAAA,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE;AAC5B,YAAA,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC;QAC5B;IACF;AAEA;;;AAGG;IACI,KAAK,GAAA;AACV,QAAA,IAAI,CAAC,OAAO,GAAG,EAAE;AAEjB,QAAA,OAAO,IAAI;IACb;;IAGO,OAAO,GAAA;QACZ,IAAI,CAAC,KAAK,EAAE;AACZ,QAAA,IAAI,CAAC,UAAU,GAAG,IAAI;IACxB;AACD;;;;"}
+{"version":3,"file":"TweenManager.js","sources":["../../../../src/animation/TweenManager.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/animation/TweenSequencer.d.ts

@@ -0,0 +1,139 @@
+import type { Tween } from './Tween';
+import type { TweenManager } from './TweenManager';
+/**
+ * Lifecycle states of a {@link TweenSequencer}. Mirrors {@link TweenState}
+ * semantics: starts `Idle`, becomes `Active` on {@link TweenSequencer.start},
+ * and ends in `Complete` (all stages exhausted) or `Stopped` (cancelled via
+ * {@link TweenSequencer.stop}). `Paused` is reachable from `Active` only.
+ */
+export declare enum TweenSequencerState {
+    Idle = "idle",
+    Active = "active",
+    Paused = "paused",
+    Complete = "complete",
+    Stopped = "stopped"
+}
+/**
+ * Composes multiple {@link Tween} instances into a multi-stage animation.
+ *
+ * Each stage added via {@link TweenSequencer.then} plays after the previous
+ * one finishes. Within a single stage, multiple tweens run simultaneously
+ * (parallel); the stage advances when **all** of them complete.
+ *
+ * Delay stages inserted via {@link TweenSequencer.wait} create a timed pause
+ * between stages without needing a dummy tween.
+ *
+ * The sequencer integrates with {@link TweenManager} via
+ * {@link TweenManager.addTicker} so it is driven automatically each frame.
+ * It can also be used stand-alone by calling {@link TweenSequencer.update}
+ * manually — in that mode the sequencer also advances its child tweens.
+ *
+ * @example
+ * ```ts
+ * app.tweens.createSequencer()
+ *   .then(fadeIn)
+ *   .wait(0.5)
+ *   .then([moveLeft, scaleUp])
+ *   .then(fadeOut)
+ *   .onComplete(() => console.log('done!'))
+ *   .start();
+ * ```
+ * @stable
+ */
+export declare class TweenSequencer {
+    private readonly _stages;
+    private _state;
+    private readonly _manager;
+    /** Index into `_stages` for the current pass (0-based). */
+    private _currentStageIndex;
+    /** 1 = forward through stages, -1 = reversed (yoyo pass). */
+    private _direction;
+    /** Remaining repeat cycles. -1 = infinite. */
+    private _repeatCount;
+    /** The value configured by {@link TweenSequencer.repeat}. Preserved for restart. */
+    private _repeatTotal;
+    private _yoyo;
+    /** Accumulated seconds within the current delay stage. */
+    private _delayElapsed;
+    private _onStartCb;
+    private _onCompleteCb;
+    private _startFired;
+    constructor(manager?: TweenManager);
+    /** Current lifecycle state of the sequencer. */
+    get state(): TweenSequencerState;
+    /**
+     * Playback progress in 0..1, advancing in discrete steps as each stage
+     * completes. Equals `1` when the entire sequence has finished.
+     */
+    get progress(): number;
+    /**
+     * Append a stage to the sequence.
+     *
+     * - **Single tween**: the stage plays that tween, then advances.
+     * - **Array of tweens**: all start simultaneously; the stage advances when
+     *   every tween in the array has completed.
+     */
+    then(tween: Tween | Tween[]): this;
+    /** Insert a fixed pause of `seconds` between stages. */
+    wait(seconds: number): this;
+    /**
+     * Number of additional repeat cycles. -1 = infinite. Default 0 (plays once).
+     *
+     * `repeat(2)` plays the full sequence three times total (initial pass + 2
+     * repeats).
+     */
+    repeat(count: number): this;
+    /**
+     * Reverse stage order on each repeat cycle. Only meaningful when combined
+     * with {@link TweenSequencer.repeat}.
+     */
+    yoyo(enabled?: boolean): this;
+    /**
+     * Register a callback fired once on the first {@link TweenSequencer.update}
+     * call after {@link TweenSequencer.start}.
+     */
+    onStart(cb: () => void): this;
+    /**
+     * Register a callback fired when the sequence finishes naturally (all stages
+     * and repeat cycles exhausted). Does NOT fire when stopped via
+     * {@link TweenSequencer.stop}.
+     */
+    onComplete(cb: () => void): this;
+    /**
+     * Start (or restart) the sequence from stage 0. Resets all internal state
+     * and re-registers with the manager if one is attached.
+     */
+    start(): this;
+    /**
+     * Pause the sequence. Tweens in the current stage are also paused. The
+     * elapsed timer in delay stages is frozen.
+     */
+    pause(): this;
+    /** Resume a paused sequence (and its current-stage tweens) from where they left off. */
+    resume(): this;
+    /**
+     * Stop the sequence without finishing. Active tweens are stopped.
+     * {@link TweenSequencer.onComplete} does NOT fire. The sequencer is removed
+     * from its manager if one is assigned.
+     */
+    stop(): this;
+    /**
+     * Advance the sequencer by `deltaSeconds`. Called automatically by the
+     * attached {@link TweenManager} each frame. When used stand-alone (no
+     * manager), call this manually and child tweens will also be advanced.
+     */
+    update(deltaSeconds: number): void;
+    /**
+     * Map the logical `_currentStageIndex` to the real index in `_stages`,
+     * accounting for yoyo reversal.
+     */
+    private _getActualStageIndex;
+    private _startCurrentStage;
+    private _advanceStage;
+    private _finish;
+    private _getCurrentStageTweens;
+    private _pauseCurrentStageTweens;
+    private _resumeCurrentStageTweens;
+    private _stopCurrentStageTweens;
+}
+//# sourceMappingURL=TweenSequencer.d.ts.map

package/dist/esm/animation/TweenSequencer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TweenSequencer.d.ts","sourceRoot":"","sources":["../../../src/animation/TweenSequencer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAenD;;;;;GAKG;AACH,oBAAY,mBAAmB;IAC7B,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,OAAO,YAAY;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,MAAM,CAAiD;IAC/D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;IAE/C,2DAA2D;IAC3D,OAAO,CAAC,kBAAkB,CAAK;IAE/B,6DAA6D;IAC7D,OAAO,CAAC,UAAU,CAAa;IAE/B,8CAA8C;IAC9C,OAAO,CAAC,YAAY,CAAK;IACzB,oFAAoF;IACpF,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,KAAK,CAAS;IAEtB,0DAA0D;IAC1D,OAAO,CAAC,aAAa,CAAK;IAE1B,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,WAAW,CAAS;gBAET,OAAO,CAAC,EAAE,YAAY;IAMzC,gDAAgD;IAChD,IAAW,KAAK,IAAI,mBAAmB,CAEtC;IAED;;;OAGG;IACH,IAAW,QAAQ,IAAI,MAAM,CAI5B;IAID;;;;;;OAMG;IACI,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,EAAE,GAAG,IAAI;IAMzC,wDAAwD;IACjD,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKlC;;;;;OAKG;IACI,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKlC;;;OAGG;IACI,IAAI,CAAC,OAAO,UAAO,GAAG,IAAI;IAKjC;;;OAGG;IACI,OAAO,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI;IAKpC;;;;OAIG;IACI,UAAU,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI;IAOvC;;;OAGG;IACI,KAAK,IAAI,IAAI;IAWpB;;;OAGG;IACI,KAAK,IAAI,IAAI;IAQpB,wFAAwF;IACjF,MAAM,IAAI,IAAI;IAQrB;;;;OAIG;IACI,IAAI,IAAI,IAAI;IAWnB;;;;OAIG;IACI,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IA2CzC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAK5B,OAAO,CAAC,kBAAkB;IAmB1B,OAAO,CAAC,aAAa;IA0BrB,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,sBAAsB;IAQ9B,OAAO,CAAC,wBAAwB;IAMhC,OAAO,CAAC,yBAAyB;IAMjC,OAAO,CAAC,uBAAuB;CAKhC"}