@codexo/exojs 0.6.10 → 0.6.11

package/CHANGELOG.md

@@ -4,6 +4,69 @@ All notable changes to ExoJS are documented in this file.
 
 The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.6.11] - 2026-05-02
+
+Adds a fluent-builder Tween / Animation system. Pure addition — no
+existing surface changes shape.
+
+### Added
+
+- **`Tween` class.** Fluent-builder API for animating numeric
+  properties on any target object:
+
+  ```ts
+  app.tweens.create(sprite)
+      .to({ x: 100, alpha: 0.5 }, 1.0)        // 1 second
+      .easing(Ease.cubicOut)
+      .delay(0.2)
+      .onComplete(() => console.log('done'))
+      .start();
+  ```
+
+  Lifecycle: `Idle → Active → Complete | Stopped` (with
+  `Paused` as an intermediate). Supports `delay()`, `repeat(N)`
+  with `repeat(-1)` for infinite, `yoyo()` to reverse on each
+  repeat, `chain(next)` to start another tween on completion,
+  and the standard `pause()` / `resume()` / `stop()` controls.
+  Lifecycle callbacks: `onStart` (after delay, on first
+  interpolation), `onUpdate` (per frame), `onRepeat` (cycle
+  boundaries), `onComplete` (final cycle ends naturally).
+  `stop()` does NOT fire `onComplete`.
+- **`TweenManager` class.** Owns active tweens and ticks them
+  from `Application.update()`. Use `app.tweens.create(target)` to
+  spawn-and-register a tween in one call; `app.tweens.add(tween)`
+  for stand-alone constructions; `manager.update(dt)` /
+  `manager.clear()` / `manager.destroy()` for lifecycle. Tweens
+  self-remove on natural completion or `stop()`.
+- **`Ease` namespace.** Robert Penner's standard library, 31
+  functions: `linear`, `quad{In,Out,InOut}`, `cubic{...}`,
+  `quart{...}`, `quint{...}`, `sine{...}`, `expo{...}`,
+  `circ{...}`, `back{...}`, `bounce{...}`, `elastic{...}`. Each
+  returns 0 at `t=0` and 1 at `t=1`. Use `Ease.cubicOut` (etc.) as
+  the argument to `.easing()`.
+- **`Application.tweens: TweenManager`.** Pre-instantiated on
+  every Application; ticked automatically each frame between
+  `inputManager.update()` and `sceneManager.update()`. So
+  tween-driven sprite positions are visible during the same
+  frame's render.
+- **Types: `EasingFunction`, `TweenLifecycleCallback`,
+  `TweenUpdateCallback`, `TweenState`** — all exported.
+
+### Notes
+
+- v1 supports **shallow numeric properties only**. Tweening
+  `{ x: 100 }` works; tweening `{ position: someVector }` does
+  not (use `{ x, y }` instead). Vector / Color / Matrix
+  interpolators are deferred to v2.
+- Non-numeric target properties at start time emit a
+  `console.warn` and are skipped; they don't throw.
+- Lazy snapshot of start values: `to()` records the END values;
+  the START values are captured on the FIRST `update()` after
+  `start()` (after any `delay`). Mutate the target between
+  `to()` and `start()` and the snapshot is correct.
+- `chain()` only fires on natural completion. `stop()` does
+  not start chained tweens.
+
 ## [0.6.10] - 2026-05-02
 
 ExoJS now ships with **zero runtime dependencies**. The single

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

@@ -0,0 +1,45 @@
+export type EasingFunction = (t: number) => number;
+/**
+ * Standard Robert Penner easing functions as static methods.
+ * Each function accepts a normalized time `t` in [0, 1] and returns a value
+ * that equals 0 at t=0 and 1 at t=1 (overshoot functions like back/elastic
+ * may exceed that range between the endpoints).
+ *
+ * Usage: `Ease.cubicOut`, `Ease.bounceIn`, etc.
+ *
+ * Note: only scalar numeric properties are supported in v1. Vector, Color, and
+ * Matrix interpolation are out of scope.
+ */
+export declare class Ease {
+    static readonly linear: EasingFunction;
+    static readonly quadIn: EasingFunction;
+    static readonly quadOut: EasingFunction;
+    static readonly quadInOut: EasingFunction;
+    static readonly cubicIn: EasingFunction;
+    static readonly cubicOut: EasingFunction;
+    static readonly cubicInOut: EasingFunction;
+    static readonly quartIn: EasingFunction;
+    static readonly quartOut: EasingFunction;
+    static readonly quartInOut: EasingFunction;
+    static readonly quintIn: EasingFunction;
+    static readonly quintOut: EasingFunction;
+    static readonly quintInOut: EasingFunction;
+    static readonly sineIn: EasingFunction;
+    static readonly sineOut: EasingFunction;
+    static readonly sineInOut: EasingFunction;
+    static readonly expoIn: EasingFunction;
+    static readonly expoOut: EasingFunction;
+    static readonly expoInOut: EasingFunction;
+    static readonly circIn: EasingFunction;
+    static readonly circOut: EasingFunction;
+    static readonly circInOut: EasingFunction;
+    static readonly backIn: EasingFunction;
+    static readonly backOut: EasingFunction;
+    static readonly backInOut: EasingFunction;
+    static readonly bounceOut: EasingFunction;
+    static readonly bounceIn: EasingFunction;
+    static readonly bounceInOut: EasingFunction;
+    static readonly elasticIn: EasingFunction;
+    static readonly elasticOut: EasingFunction;
+    static readonly elasticInOut: EasingFunction;
+}

package/dist/esm/animation/Easing.js

@@ -0,0 +1,112 @@
+const bounceOutFn = (t) => {
+    const n1 = 7.5625;
+    const d1 = 2.75;
+    if (t < 1 / d1) {
+        return n1 * t * t;
+    }
+    else if (t < 2 / d1) {
+        return n1 * (t -= 1.5 / d1) * t + 0.75;
+    }
+    else if (t < 2.5 / d1) {
+        return n1 * (t -= 2.25 / d1) * t + 0.9375;
+    }
+    else {
+        return n1 * (t -= 2.625 / d1) * t + 0.984375;
+    }
+};
+/**
+ * Standard Robert Penner easing functions as static methods.
+ * Each function accepts a normalized time `t` in [0, 1] and returns a value
+ * that equals 0 at t=0 and 1 at t=1 (overshoot functions like back/elastic
+ * may exceed that range between the endpoints).
+ *
+ * Usage: `Ease.cubicOut`, `Ease.bounceIn`, etc.
+ *
+ * Note: only scalar numeric properties are supported in v1. Vector, Color, and
+ * Matrix interpolation are out of scope.
+ */
+class Ease {
+    static linear = (t) => t;
+    static quadIn = (t) => t * t;
+    static quadOut = (t) => t * (2 - t);
+    static quadInOut = (t) => t < 0.5 ? 2 * t * t : -1 + (4 - 2 * t) * t;
+    static cubicIn = (t) => t * t * t;
+    static cubicOut = (t) => (--t) * t * t + 1;
+    static cubicInOut = (t) => t < 0.5 ? 4 * t * t * t : 1 - Math.pow(-2 * t + 2, 3) / 2;
+    static quartIn = (t) => t * t * t * t;
+    static quartOut = (t) => 1 - (--t) * t * t * t;
+    static quartInOut = (t) => t < 0.5 ? 8 * t * t * t * t : 1 - Math.pow(-2 * t + 2, 4) / 2;
+    static quintIn = (t) => t * t * t * t * t;
+    static quintOut = (t) => 1 + (--t) * t * t * t * t;
+    static quintInOut = (t) => t < 0.5 ? 16 * t * t * t * t * t : 1 - Math.pow(-2 * t + 2, 5) / 2;
+    static sineIn = (t) => 1 - Math.cos((t * Math.PI) / 2);
+    static sineOut = (t) => Math.sin((t * Math.PI) / 2);
+    static sineInOut = (t) => -(Math.cos(Math.PI * t) - 1) / 2;
+    static expoIn = (t) => t === 0 ? 0 : Math.pow(2, 10 * t - 10);
+    static expoOut = (t) => t === 1 ? 1 : 1 - Math.pow(2, -10 * t);
+    static expoInOut = (t) => {
+        if (t === 0)
+            return 0;
+        if (t === 1)
+            return 1;
+        return t < 0.5
+            ? Math.pow(2, 20 * t - 10) / 2
+            : (2 - Math.pow(2, -20 * t + 10)) / 2;
+    };
+    static circIn = (t) => 1 - Math.sqrt(1 - Math.pow(t, 2));
+    static circOut = (t) => Math.sqrt(1 - Math.pow(t - 1, 2));
+    static circInOut = (t) => t < 0.5
+        ? (1 - Math.sqrt(1 - Math.pow(2 * t, 2))) / 2
+        : (Math.sqrt(1 - Math.pow(-2 * t + 2, 2)) + 1) / 2;
+    static backIn = (t) => {
+        const c1 = 1.70158;
+        const c3 = c1 + 1;
+        return c3 * t * t * t - c1 * t * t;
+    };
+    static backOut = (t) => {
+        const c1 = 1.70158;
+        const c3 = c1 + 1;
+        return 1 + c3 * Math.pow(t - 1, 3) + c1 * Math.pow(t - 1, 2);
+    };
+    static backInOut = (t) => {
+        const c1 = 1.70158;
+        const c2 = c1 * 1.525;
+        return t < 0.5
+            ? (Math.pow(2 * t, 2) * ((c2 + 1) * 2 * t - c2)) / 2
+            : (Math.pow(2 * t - 2, 2) * ((c2 + 1) * (2 * t - 2) + c2) + 2) / 2;
+    };
+    static bounceOut = bounceOutFn;
+    static bounceIn = (t) => 1 - bounceOutFn(1 - t);
+    static bounceInOut = (t) => t < 0.5
+        ? (1 - bounceOutFn(1 - 2 * t)) / 2
+        : (1 + bounceOutFn(2 * t - 1)) / 2;
+    static elasticIn = (t) => {
+        if (t === 0)
+            return 0;
+        if (t === 1)
+            return 1;
+        const c4 = (2 * Math.PI) / 3;
+        return -Math.pow(2, 10 * t - 10) * Math.sin((t * 10 - 10.75) * c4);
+    };
+    static elasticOut = (t) => {
+        if (t === 0)
+            return 0;
+        if (t === 1)
+            return 1;
+        const c4 = (2 * Math.PI) / 3;
+        return Math.pow(2, -10 * t) * Math.sin((t * 10 - 0.75) * c4) + 1;
+    };
+    static elasticInOut = (t) => {
+        if (t === 0)
+            return 0;
+        if (t === 1)
+            return 1;
+        const c5 = (2 * Math.PI) / 4.5;
+        return t < 0.5
+            ? -(Math.pow(2, 20 * t - 10) * Math.sin((20 * t - 11.125) * c5)) / 2
+            : (Math.pow(2, -20 * t + 10) * Math.sin((20 * t - 11.125) * c5)) / 2 + 1;
+    };
+}
+
+export { Ease };
+//# sourceMappingURL=Easing.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Easing.js","sources":["../../../../src/animation/Easing.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

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

@@ -0,0 +1,100 @@
+import { TweenState } from './types';
+import type { EasingFunction, TweenLifecycleCallback, TweenUpdateCallback } from './types';
+import type { TweenManager } from './TweenManager';
+export declare class Tween<T extends object = object> {
+    private readonly _target;
+    private _state;
+    private _properties;
+    private _startValues;
+    private _duration;
+    private _delay;
+    private _easing;
+    private _elapsed;
+    private _delayElapsed;
+    /**
+     * Remaining repeat cycles. -1 = infinite.
+     * At start this is set to _repeatTotal. Decremented on each cycle boundary.
+     */
+    private _repeatCount;
+    /** The value as configured by .repeat(). Preserved for reset. */
+    private _repeatTotal;
+    private _yoyo;
+    /** Current playback direction: 1 = forward, -1 = reverse. */
+    private _direction;
+    private _onStart;
+    private _onUpdate;
+    private _onComplete;
+    private _onRepeat;
+    private _chained;
+    private _manager;
+    /** Whether onStart has already fired this tween lifecycle. */
+    private _startFired;
+    constructor(target: T);
+    get target(): T;
+    get state(): TweenState;
+    /**
+     * Current eased progress in 0..1. Reflects the eased t after applying the
+     * easing function, not the raw elapsed/duration ratio.
+     */
+    get progress(): number;
+    /**
+     * Set target end-values and duration in seconds. Replaces any prior to().
+     * The starting values are captured lazily on first update() after start(),
+     * so mutating target between to() and start() is safe.
+     */
+    to(properties: Partial<Record<keyof T, number>>, duration: number): this;
+    /** Delay in seconds before the tween begins interpolating. Default 0. */
+    delay(seconds: number): this;
+    /** Easing function applied to the normalized time. Default Ease.linear. */
+    easing(fn: EasingFunction): this;
+    /**
+     * Number of additional repeat cycles. -1 = infinite. Default 0 (runs once).
+     * Note: repeat(2) means the animation runs 3 times total.
+     */
+    repeat(count: number): this;
+    /**
+     * Reverse playback direction on each repeat cycle. Only meaningful when
+     * combined with repeat(). Calling yoyo() without repeat() is a no-op.
+     */
+    yoyo(enabled?: boolean): this;
+    onStart(callback: TweenLifecycleCallback): this;
+    onUpdate(callback: TweenUpdateCallback): this;
+    onComplete(callback: TweenLifecycleCallback): this;
+    onRepeat(callback: TweenLifecycleCallback): this;
+    /**
+     * Start the tween. If a manager owns this tween it is already tracked;
+     * otherwise this is a stand-alone tween driven by manual update() calls.
+     */
+    start(): this;
+    /** Pause the tween. update() calls are ignored while paused. */
+    pause(): this;
+    /** Resume a paused tween from where it left off. */
+    resume(): this;
+    /**
+     * Stop the tween without finishing. Target properties stay at their
+     * current interpolated values. onComplete does NOT fire. The tween is
+     * removed from its manager if one is assigned.
+     */
+    stop(): this;
+    /**
+     * When this tween completes naturally, automatically start `next`.
+     * Returns `next` for fluent chaining:
+     *   `fadeIn.chain(moveOut).start()` — note that start() here starts moveOut,
+     *   so typically you only call start() on the first tween.
+     */
+    chain(next: Tween): Tween;
+    /**
+     * Attach this tween to a manager. Called by TweenManager.create() and
+     * TweenManager.add(). Not part of the public fluent API.
+     * @internal
+     */
+    _attachManager(manager: TweenManager): void;
+    /**
+     * Advance the tween by deltaSeconds. Called by TweenManager each frame, or
+     * manually for stand-alone usage. No-ops when Paused, Stopped, or Complete.
+     */
+    update(deltaSeconds: number): void;
+    private _captureStartValues;
+    private _applyProgress;
+    private _complete;
+}

package/dist/esm/animation/Tween.js

@@ -0,0 +1,270 @@
+import { Ease } from './Easing.js';
+import { TweenState } from './types.js';
+
+class Tween {
+    _target;
+    _state = TweenState.Idle;
+    _properties = {};
+    _startValues = null;
+    _duration = 0;
+    _delay = 0;
+    _easing = Ease.linear;
+    _elapsed = 0;
+    _delayElapsed = 0;
+    /**
+     * Remaining repeat cycles. -1 = infinite.
+     * At start this is set to _repeatTotal. Decremented on each cycle boundary.
+     */
+    _repeatCount = 0;
+    /** The value as configured by .repeat(). Preserved for reset. */
+    _repeatTotal = 0;
+    _yoyo = false;
+    /** Current playback direction: 1 = forward, -1 = reverse. */
+    _direction = 1;
+    _onStart = null;
+    _onUpdate = null;
+    _onComplete = null;
+    _onRepeat = null;
+    _chained = null;
+    _manager = null;
+    /** Whether onStart has already fired this tween lifecycle. */
+    _startFired = false;
+    constructor(target) {
+        this._target = target;
+    }
+    get target() {
+        return this._target;
+    }
+    get state() {
+        return this._state;
+    }
+    /**
+     * Current eased progress in 0..1. Reflects the eased t after applying the
+     * easing function, not the raw elapsed/duration ratio.
+     */
+    get progress() {
+        if (this._duration === 0)
+            return 1;
+        const rawT = Math.min(this._elapsed / this._duration, 1);
+        const t = this._direction === 1 ? rawT : 1 - rawT;
+        return this._easing(t);
+    }
+    /**
+     * Set target end-values and duration in seconds. Replaces any prior to().
+     * The starting values are captured lazily on first update() after start(),
+     * so mutating target between to() and start() is safe.
+     */
+    to(properties, duration) {
+        this._properties = { ...properties };
+        this._duration = duration;
+        this._startValues = null;
+        return this;
+    }
+    /** Delay in seconds before the tween begins interpolating. Default 0. */
+    delay(seconds) {
+        this._delay = seconds;
+        return this;
+    }
+    /** Easing function applied to the normalized time. Default Ease.linear. */
+    easing(fn) {
+        this._easing = fn;
+        return this;
+    }
+    /**
+     * Number of additional repeat cycles. -1 = infinite. Default 0 (runs once).
+     * Note: repeat(2) means the animation runs 3 times total.
+     */
+    repeat(count) {
+        this._repeatTotal = count;
+        return this;
+    }
+    /**
+     * Reverse playback direction on each repeat cycle. Only meaningful when
+     * combined with repeat(). Calling yoyo() without repeat() is a no-op.
+     */
+    yoyo(enabled = true) {
+        this._yoyo = enabled;
+        return this;
+    }
+    onStart(callback) {
+        this._onStart = callback;
+        return this;
+    }
+    onUpdate(callback) {
+        this._onUpdate = callback;
+        return this;
+    }
+    onComplete(callback) {
+        this._onComplete = callback;
+        return this;
+    }
+    onRepeat(callback) {
+        this._onRepeat = callback;
+        return this;
+    }
+    /**
+     * Start the tween. If a manager owns this tween it is already tracked;
+     * otherwise this is a stand-alone tween driven by manual update() calls.
+     */
+    start() {
+        this._state = TweenState.Active;
+        this._elapsed = 0;
+        this._delayElapsed = 0;
+        this._startValues = null;
+        this._startFired = false;
+        this._direction = 1;
+        this._repeatCount = this._repeatTotal;
+        return this;
+    }
+    /** Pause the tween. update() calls are ignored while paused. */
+    pause() {
+        if (this._state === TweenState.Active) {
+            this._state = TweenState.Paused;
+        }
+        return this;
+    }
+    /** Resume a paused tween from where it left off. */
+    resume() {
+        if (this._state === TweenState.Paused) {
+            this._state = TweenState.Active;
+        }
+        return this;
+    }
+    /**
+     * Stop the tween without finishing. Target properties stay at their
+     * current interpolated values. onComplete does NOT fire. The tween is
+     * removed from its manager if one is assigned.
+     */
+    stop() {
+        if (this._state === TweenState.Active || this._state === TweenState.Paused) {
+            this._state = TweenState.Stopped;
+            this._manager?.remove(this);
+        }
+        return this;
+    }
+    /**
+     * When this tween completes naturally, automatically start `next`.
+     * Returns `next` for fluent chaining:
+     *   `fadeIn.chain(moveOut).start()` — note that start() here starts moveOut,
+     *   so typically you only call start() on the first tween.
+     */
+    chain(next) {
+        this._chained = next;
+        return next;
+    }
+    /**
+     * Attach this tween to a manager. Called by TweenManager.create() and
+     * TweenManager.add(). Not part of the public fluent API.
+     * @internal
+     */
+    _attachManager(manager) {
+        this._manager = manager;
+    }
+    /**
+     * Advance the tween by deltaSeconds. Called by TweenManager each frame, or
+     * manually for stand-alone usage. No-ops when Paused, Stopped, or Complete.
+     */
+    update(deltaSeconds) {
+        if (this._state !== TweenState.Active)
+            return;
+        // Handle delay phase.
+        if (this._delayElapsed < this._delay) {
+            this._delayElapsed += deltaSeconds;
+            if (this._delayElapsed < this._delay)
+                return;
+            // Carry overflow past delay into elapsed.
+            const overflow = this._delayElapsed - this._delay;
+            this._delayElapsed = this._delay;
+            deltaSeconds = overflow;
+        }
+        // Lazy snapshot of start values on the first update after delay.
+        if (this._startValues === null) {
+            this._captureStartValues();
+        }
+        // Fire onStart once.
+        if (!this._startFired) {
+            this._startFired = true;
+            this._onStart?.();
+        }
+        this._elapsed += deltaSeconds;
+        // Clamp to duration for this cycle.
+        if (this._elapsed >= this._duration) {
+            this._elapsed = this._duration;
+        }
+        // Apply interpolation.
+        this._applyProgress();
+        if (this._elapsed >= this._duration) {
+            // Cycle complete.
+            const hasMoreRepeats = this._repeatCount === -1 || this._repeatCount > 0;
+            if (hasMoreRepeats) {
+                // Decrement repeat counter (skip for infinite).
+                if (this._repeatCount !== -1) {
+                    this._repeatCount--;
+                }
+                this._onRepeat?.();
+                // Flip direction for yoyo.
+                if (this._yoyo) {
+                    this._direction = this._direction === 1 ? -1 : 1;
+                }
+                // Reset elapsed for next cycle; carry overflow.
+                const overflow = this._elapsed - this._duration;
+                this._elapsed = overflow > 0 ? Math.min(overflow, this._duration) : 0;
+                this._startFired = false; // allow onStart to re-fire next cycle? No — spec says once.
+                // Actually spec says onStart fires when actual interpolation begins.
+                // For repeats it fires once total at the very first cycle.
+                // Re-reading spec: "onStart fires AFTER the delay (when actual interpolation begins)".
+                // We'll keep it as one-shot across the full lifecycle; don't reset _startFired.
+                this._startFired = true;
+                // Apply progress for any overflow.
+                if (overflow > 0) {
+                    this._applyProgress();
+                }
+            }
+            else {
+                // All cycles done.
+                this._complete();
+            }
+        }
+    }
+    _captureStartValues() {
+        const snap = {};
+        const keys = Object.keys(this._properties);
+        for (const key of keys) {
+            const val = this._target[key];
+            if (typeof val !== 'number') {
+                console.warn(`Tween: property "${String(key)}" is not a number on target ` +
+                    `(got ${typeof val}). It will be skipped.`);
+                continue;
+            }
+            snap[String(key)] = val;
+        }
+        this._startValues = snap;
+    }
+    _applyProgress() {
+        if (this._startValues === null)
+            return;
+        const rawT = this._duration === 0 ? 1 : Math.min(this._elapsed / this._duration, 1);
+        const t = this._direction === 1 ? rawT : 1 - rawT;
+        const easedT = this._easing(t);
+        const keys = Object.keys(this._startValues);
+        for (const key of keys) {
+            const start = this._startValues[key];
+            const end = this._properties[key];
+            this._target[key] = start + (end - start) * easedT;
+        }
+        this._onUpdate?.(easedT);
+    }
+    _complete() {
+        // Ensure the target is at its final interpolated position.
+        this._elapsed = this._duration;
+        this._applyProgress();
+        this._state = TweenState.Complete;
+        this._manager?.remove(this);
+        this._onComplete?.();
+        // Fire chained tween, if any.
+        this._chained?.start();
+    }
+}
+
+export { Tween };
+//# sourceMappingURL=Tween.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Tween.js","sources":["../../../../src/animation/Tween.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

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

@@ -0,0 +1,30 @@
+import { Tween } from './Tween';
+export declare class TweenManager {
+    private _tweens;
+    private _destroyed;
+    /**
+     * Create a new Tween targeting `target`, register it with this manager, and
+     * return it. Call .to(...).start() on the result to begin animating.
+     */
+    create<T extends object>(target: T): Tween<T>;
+    /**
+     * Explicitly add a stand-alone Tween (created via `new Tween(target)`)
+     * to this manager so it participates in the update loop.
+     */
+    add(tween: Tween): this;
+    /** 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.
+     */
+    update(deltaSeconds: number): this;
+    /**
+     * Remove all tweens immediately. No callbacks (onComplete etc.) 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. */
+    destroy(): void;
+}