@flighthq/tween 0.1.0

package/dist/colorTween.d.ts

@@ -0,0 +1,14 @@
+import type { Tween, TweenManager, TweenOptions } from '@flighthq/types';
+type ColorComponents = {
+    b: number;
+    g: number;
+    r: number;
+};
+/**
+ * Tween a packed 0xRRGGBB color property on target.
+ * Components are interpolated in float space; the composed value written on each
+ * update is always a rounded integer.
+ */
+export declare function createColorTween(manager: TweenManager, target: Record<string, number>, property: string, duration: number, toColor: number, options?: Readonly<TweenOptions>): Tween<ColorComponents>;
+export {};
+//# sourceMappingURL=colorTween.d.ts.map

package/dist/colorTween.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorTween.d.ts","sourceRoot":"","sources":["../src/colorTween.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAIzE,KAAK,eAAe,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,GAC/B,KAAK,CAAC,eAAe,CAAC,CAyBxB"}

package/dist/colorTween.js

@@ -0,0 +1,28 @@
+import { connectSignal } from '@flighthq/signals';
+import { createTween } from './tween';
+/**
+ * Tween a packed 0xRRGGBB color property on target.
+ * Components are interpolated in float space; the composed value written on each
+ * update is always a rounded integer.
+ */
+export function createColorTween(manager, target, property, duration, toColor, options) {
+    const fromColor = target[property] ?? 0;
+    const components = {
+        b: fromColor & 0xff,
+        g: (fromColor >> 8) & 0xff,
+        r: (fromColor >> 16) & 0xff,
+    };
+    const tween = createTween(manager, components, duration, {
+        b: toColor & 0xff,
+        g: (toColor >> 8) & 0xff,
+        r: (toColor >> 16) & 0xff,
+    }, options);
+    connectSignal(tween.onUpdate, () => {
+        target[property] =
+            ((Math.round(components.r) & 0xff) << 16) |
+                ((Math.round(components.g) & 0xff) << 8) |
+                (Math.round(components.b) & 0xff);
+    });
+    return tween;
+}
+//# sourceMappingURL=colorTween.js.map

package/dist/colorTween.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorTween.js","sourceRoot":"","sources":["../src/colorTween.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGlD,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAItC;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAqB,EACrB,MAA8B,EAC9B,QAAgB,EAChB,QAAgB,EAChB,OAAe,EACf,OAAgC;IAEhC,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,UAAU,GAAoB;QAClC,CAAC,EAAE,SAAS,GAAG,IAAI;QACnB,CAAC,EAAE,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,IAAI;QAC1B,CAAC,EAAE,CAAC,SAAS,IAAI,EAAE,CAAC,GAAG,IAAI;KAC5B,CAAC;IACF,MAAM,KAAK,GAAG,WAAW,CACvB,OAAO,EACP,UAAU,EACV,QAAQ,EACR;QACE,CAAC,EAAE,OAAO,GAAG,IAAI;QACjB,CAAC,EAAE,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,IAAI;QACxB,CAAC,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,GAAG,IAAI;KAC1B,EACD,OAAO,CACR,CAAC;IACF,aAAa,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,QAAQ,CAAC;YACd,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;gBACzC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;gBACxC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from './colorTween';
+export * from './timer';
+export * from './tween';
+export * from './tweenManager';
+export * from './tweenProgress';
+export * from './tweenStagger';
+export * from './updateTweens';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export * from './colorTween';
+export * from './timer';
+export * from './tween';
+export * from './tweenManager';
+export * from './tweenProgress';
+export * from './tweenStagger';
+export * from './updateTweens';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC"}

package/dist/internal.d.ts

@@ -0,0 +1,3 @@
+import type { Tween } from '@flighthq/types';
+export declare function initializeTween<T extends object>(tween: Tween<T>): void;
+//# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAevE"}

package/dist/internal.js

@@ -0,0 +1,18 @@
+export function initializeTween(tween) {
+    const target = tween.target;
+    const propertyMap = tween.propertyMap;
+    for (const detail of tween.properties) {
+        const start = target[detail.key] ?? 0;
+        const end = propertyMap[detail.key] ?? 0;
+        detail.start = start;
+        detail.change = end - start;
+        if (tween.smartRotation) {
+            let change = ((detail.change % 360) + 360) % 360;
+            if (change > 180)
+                change -= 360;
+            detail.change = change;
+        }
+    }
+    tween.initialized = true;
+}
+//# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,eAAe,CAAmB,KAAe;IAC/D,MAAM,MAAM,GAAG,KAAK,CAAC,MAAgC,CAAC;IACtD,MAAM,WAAW,GAAG,KAAK,CAAC,WAAqC,CAAC;IAChE,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;QACrB,MAAM,CAAC,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC;QAC5B,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;YACxB,IAAI,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;YACjD,IAAI,MAAM,GAAG,GAAG;gBAAE,MAAM,IAAI,GAAG,CAAC;YAChC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;QACzB,CAAC;IACH,CAAC;IACD,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;AAC3B,CAAC"}

package/dist/timer.d.ts

@@ -0,0 +1,3 @@
+import type { Tween, TweenManager, TweenOptions } from '@flighthq/types';
+export declare function createTweenTimer(manager: TweenManager, duration: number, options?: Readonly<TweenOptions>): Tween<object>;
+//# sourceMappingURL=timer.d.ts.map

package/dist/timer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timer.d.ts","sourceRoot":"","sources":["../src/timer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAIzE,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,GAC/B,KAAK,CAAC,MAAM,CAAC,CAEf"}

package/dist/timer.js

@@ -0,0 +1,5 @@
+import { createTween } from './tween';
+export function createTweenTimer(manager, duration, options) {
+    return createTween(manager, {}, duration, {}, options);
+}
+//# sourceMappingURL=timer.js.map

package/dist/timer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timer.js","sourceRoot":"","sources":["../src/timer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,MAAM,UAAU,gBAAgB,CAC9B,OAAqB,EACrB,QAAgB,EAChB,OAAgC;IAEhC,OAAO,WAAW,CAAC,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;AACzD,CAAC"}

package/dist/tween.d.ts

@@ -0,0 +1,20 @@
+import type { NumericProps, StopTweenOptions, Tween, TweenManager, TweenOptions } from '@flighthq/types';
+export type { NumericProps, StopTweenOptions, Tween, TweenManager, TweenOptions } from '@flighthq/types';
+export declare function applyTween<T extends object>(manager: TweenManager, target: T, propertyMap: Readonly<NumericProps<T>>): void;
+export declare function createTween<T extends object>(manager: TweenManager, target: T, duration: number, propertyMap: Readonly<NumericProps<T>>, options?: Readonly<TweenOptions>): Tween<T>;
+export declare function createTween<T extends object>(target: T, duration: number, propertyMap: Readonly<NumericProps<T>>, options?: Readonly<TweenOptions>): Tween<T>;
+export declare function getActiveTweenCount(manager: TweenManager): number;
+export declare function getTweensOf(manager: TweenManager, target: object): readonly Tween<any>[];
+export declare function hasTweensOf(manager: TweenManager, target: object): boolean;
+export declare function killTweensOfProperty(manager: TweenManager, key: string): void;
+export declare function pauseAllTweens(manager: TweenManager): void;
+export declare function pauseTween(tween: Tween<any>): void;
+export declare function pauseTweens(manager: TweenManager, target: object): void;
+export declare function resetAllTweens(manager: TweenManager): void;
+export declare function resumeAllTweens(manager: TweenManager): void;
+export declare function resumeTween(tween: Tween<any>): void;
+export declare function resumeTweens(manager: TweenManager, target: object): void;
+export declare function stopAllTweens(manager: TweenManager, options?: Readonly<StopTweenOptions>): void;
+export declare function stopTween(tween: Tween<any>, options?: Readonly<StopTweenOptions>): void;
+export declare function stopTweens(manager: TweenManager, target: object, propertyMap?: Readonly<NumericProps<any>>, options?: Readonly<StopTweenOptions>): void;
+//# sourceMappingURL=tween.d.ts.map

package/dist/tween.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tween.d.ts","sourceRoot":"","sources":["../src/tween.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,YAAY,EACZ,gBAAgB,EAChB,KAAK,EACL,YAAY,EACZ,YAAY,EAEb,MAAM,iBAAiB,CAAC;AAKzB,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEzG,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EACzC,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,CAAC,EACT,WAAW,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GACrC,IAAI,CAQN;AAMD,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAC1C,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,CAAC,EACT,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EACtC,OAAO,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,GAC/B,KAAK,CAAC,CAAC,CAAC,CAAC;AACZ,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAC1C,MAAM,EAAE,CAAC,EACT,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EACtC,OAAO,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,GAC/B,KAAK,CAAC,CAAC,CAAC,CAAC;AAiCZ,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAIjE;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE,CAExF;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAG1E;AAMD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAO7E;AAkCD,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAI1D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAElD;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAIvE;AAyBD,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAE1D;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAI3D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAEnD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAIxE;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAI/F;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAkBvF;AAED,wBAAgB,UAAU,CACxB,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EACzC,OAAO,CAAC,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GACnC,IAAI,CAoBN"}

package/dist/tween.js

@@ -0,0 +1,194 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { createSignal, emitSignal } from '@flighthq/signals';
+import { initializeTween } from './internal';
+import { defaultManager } from './tweenManager';
+export function applyTween(manager, target, propertyMap) {
+    stopTweens(manager, target, propertyMap);
+    const t = target;
+    const p = propertyMap;
+    for (const key of Object.keys(p)) {
+        const val = p[key];
+        if (val !== undefined)
+            t[key] = val;
+    }
+}
+export function createTween(managerOrTarget, targetOrDuration, durationOrProps, propsOrOptions, maybeOptions) {
+    let manager;
+    let target;
+    let duration;
+    let propertyMap;
+    let options;
+    if (isTweenManager(managerOrTarget)) {
+        manager = managerOrTarget;
+        target = targetOrDuration;
+        duration = durationOrProps;
+        propertyMap = propsOrOptions;
+        options = maybeOptions;
+    }
+    else {
+        manager = defaultManager;
+        target = managerOrTarget;
+        duration = targetOrDuration;
+        propertyMap = durationOrProps;
+        options = propsOrOptions;
+    }
+    const tween = makeTween(target, duration, propertyMap, options, manager.defaultEase);
+    registerTween(manager, tween, options?.overwrite ?? true);
+    return tween;
+}
+export function getActiveTweenCount(manager) {
+    let count = 0;
+    for (const list of manager.tweens.values())
+        count += list.length;
+    return count;
+}
+export function getTweensOf(manager, target) {
+    return manager.tweens.get(target) ?? [];
+}
+export function hasTweensOf(manager, target) {
+    const list = manager.tweens.get(target);
+    return list !== undefined && list.length > 0;
+}
+function isTweenManager(value) {
+    return typeof value === 'object' && value !== null && value.__brand === 'TweenManager';
+}
+export function killTweensOfProperty(manager, key) {
+    for (const list of manager.tweens.values()) {
+        for (const tween of list) {
+            const p = tween.propertyMap;
+            if (key in p)
+                tween.complete = true;
+        }
+    }
+}
+function makeTween(target, duration, propertyMap, options, defaultEase) {
+    const keys = Object.keys(propertyMap);
+    const properties = keys.map((key) => ({ change: 0, key, start: 0 }));
+    return {
+        complete: false,
+        delay: options?.delay ?? 0,
+        duration,
+        ease: options?.ease ?? defaultEase,
+        elapsed: 0,
+        initialized: false,
+        onComplete: createSignal(),
+        onRepeat: createSignal(),
+        onUpdate: createSignal(),
+        onYoyo: createSignal(),
+        paused: false,
+        properties,
+        propertyMap,
+        reflect: options?.reflect ?? false,
+        repeat: options?.repeat ?? 0,
+        reverse: options?.reverse ?? false,
+        smartRotation: options?.smartRotation ?? false,
+        snapping: options?.snapping ?? false,
+        target,
+    };
+}
+export function pauseAllTweens(manager) {
+    for (const list of manager.tweens.values()) {
+        for (const tween of list)
+            tween.paused = true;
+    }
+}
+export function pauseTween(tween) {
+    tween.paused = true;
+}
+export function pauseTweens(manager, target) {
+    const list = manager.tweens.get(target);
+    if (list === undefined)
+        return;
+    for (const tween of list)
+        tween.paused = true;
+}
+function registerTween(manager, tween, overwrite) {
+    let list = manager.tweens.get(tween.target);
+    if (list === undefined) {
+        list = [];
+        manager.tweens.set(tween.target, list);
+    }
+    if (overwrite) {
+        for (let i = list.length - 1; i >= 0; i--) {
+            const existing = list[i];
+            const existingMap = existing.propertyMap;
+            let overlaps = false;
+            for (const detail of tween.properties) {
+                if (detail.key in existingMap) {
+                    overlaps = true;
+                    break;
+                }
+            }
+            if (overlaps)
+                existing.complete = true;
+        }
+    }
+    list.push(tween);
+}
+export function resetAllTweens(manager) {
+    manager.tweens.clear();
+}
+export function resumeAllTweens(manager) {
+    for (const list of manager.tweens.values()) {
+        for (const tween of list)
+            tween.paused = false;
+    }
+}
+export function resumeTween(tween) {
+    tween.paused = false;
+}
+export function resumeTweens(manager, target) {
+    const list = manager.tweens.get(target);
+    if (list === undefined)
+        return;
+    for (const tween of list)
+        tween.paused = false;
+}
+export function stopAllTweens(manager, options) {
+    for (const list of manager.tweens.values()) {
+        for (const tween of list)
+            stopTween(tween, options);
+    }
+}
+export function stopTween(tween, options) {
+    const doComplete = options?.complete ?? false;
+    const doSendEvent = options?.sendEvent ?? true;
+    if (doComplete) {
+        if (!tween.initialized)
+            initializeTween(tween);
+        const effectiveT = tween.reverse ? 0 : 1;
+        const easedT = tween.ease(effectiveT);
+        const t = tween.target;
+        for (const detail of tween.properties) {
+            let value = detail.start + detail.change * easedT;
+            if (tween.snapping)
+                value = Math.round(value);
+            t[detail.key] = value;
+        }
+        if (doSendEvent)
+            emitSignal(tween.onComplete);
+    }
+    tween.complete = true;
+}
+export function stopTweens(manager, target, propertyMap, options) {
+    const list = manager.tweens.get(target);
+    if (list === undefined)
+        return;
+    for (const tween of list) {
+        if (propertyMap !== undefined) {
+            const p = propertyMap;
+            const tweenMap = tween.propertyMap;
+            let overlaps = false;
+            for (const key of Object.keys(p)) {
+                if (key in tweenMap) {
+                    overlaps = true;
+                    break;
+                }
+            }
+            if (!overlaps)
+                continue;
+        }
+        stopTween(tween, options);
+    }
+}
+//# sourceMappingURL=tween.js.map

package/dist/tween.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tween.js","sourceRoot":"","sources":["../src/tween.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAW7D,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIhD,MAAM,UAAU,UAAU,CACxB,OAAqB,EACrB,MAAS,EACT,WAAsC;IAEtC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IACzC,MAAM,CAAC,GAAG,MAAgC,CAAC;IAC3C,MAAM,CAAC,GAAG,WAAiD,CAAC;IAC5D,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QACnB,IAAI,GAAG,KAAK,SAAS;YAAE,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACtC,CAAC;AACH,CAAC;AAmBD,MAAM,UAAU,WAAW,CACzB,eAAiC,EACjC,gBAA4B,EAC5B,eAAmD,EACnD,cAAmE,EACnE,YAAqC;IAErC,IAAI,OAAqB,CAAC;IAC1B,IAAI,MAAS,CAAC;IACd,IAAI,QAAgB,CAAC;IACrB,IAAI,WAAsC,CAAC;IAC3C,IAAI,OAA2C,CAAC;IAEhD,IAAI,cAAc,CAAC,eAAe,CAAC,EAAE,CAAC;QACpC,OAAO,GAAG,eAAe,CAAC;QAC1B,MAAM,GAAG,gBAAqB,CAAC;QAC/B,QAAQ,GAAG,eAAyB,CAAC;QACrC,WAAW,GAAG,cAA2C,CAAC;QAC1D,OAAO,GAAG,YAAY,CAAC;IACzB,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,cAAc,CAAC;QACzB,MAAM,GAAG,eAAoB,CAAC;QAC9B,QAAQ,GAAG,gBAA0B,CAAC;QACtC,WAAW,GAAG,eAA4C,CAAC;QAC3D,OAAO,GAAG,cAAoD,CAAC;IACjE,CAAC;IAED,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACrF,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,IAAI,IAAI,CAAC,CAAC;IAC1D,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAqB;IACvD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC;IACjE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAqB,EAAE,MAAc;IAC/D,OAAO,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAqB,EAAE,MAAc;IAC/D,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAK,KAAa,CAAC,OAAO,KAAK,cAAc,CAAC;AAClG,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAqB,EAAE,GAAW;IACrE,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;QAC3C,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,KAAK,CAAC,WAAsC,CAAC;YACvD,IAAI,GAAG,IAAI,CAAC;gBAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;QACtC,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAChB,MAAS,EACT,QAAgB,EAChB,WAAsC,EACtC,OAA2C,EAC3C,WAA2B;IAE3B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtC,MAAM,UAAU,GAA0B,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5F,OAAO;QACL,QAAQ,EAAE,KAAK;QACf,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;QAC1B,QAAQ;QACR,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,WAAW;QAClC,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,KAAK;QAClB,UAAU,EAAE,YAAY,EAAE;QAC1B,QAAQ,EAAE,YAAY,EAAE;QACxB,QAAQ,EAAE,YAAY,EAAE;QACxB,MAAM,EAAE,YAAY,EAAE;QACtB,MAAM,EAAE,KAAK;QACb,UAAU;QACV,WAAW;QACX,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,KAAK;QAClC,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;QAC5B,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,KAAK;QAClC,aAAa,EAAE,OAAO,EAAE,aAAa,IAAI,KAAK;QAC9C,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,KAAK;QACpC,MAAM;KACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAqB;IAClD,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;QAC3C,KAAK,MAAM,KAAK,IAAI,IAAI;YAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;IAChD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAiB;IAC1C,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAqB,EAAE,MAAc;IAC/D,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO;IAC/B,KAAK,MAAM,KAAK,IAAI,IAAI;QAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;AAChD,CAAC;AAED,SAAS,aAAa,CAAmB,OAAqB,EAAE,KAAe,EAAE,SAAkB;IACjG,IAAI,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,IAAI,GAAG,EAAE,CAAC;QACV,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACzB,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAsC,CAAC;YACpE,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACtC,IAAI,MAAM,CAAC,GAAG,IAAI,WAAW,EAAE,CAAC;oBAC9B,QAAQ,GAAG,IAAI,CAAC;oBAChB,MAAM;gBACR,CAAC;YACH,CAAC;YACD,IAAI,QAAQ;gBAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC;QACzC,CAAC;IACH,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAqB;IAClD,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAqB;IACnD,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;QAC3C,KAAK,MAAM,KAAK,IAAI,IAAI;YAAE,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;IACjD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAiB;IAC3C,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAqB,EAAE,MAAc;IAChE,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO;IAC/B,KAAK,MAAM,KAAK,IAAI,IAAI;QAAE,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAqB,EAAE,OAAoC;IACvF,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;QAC3C,KAAK,MAAM,KAAK,IAAI,IAAI;YAAE,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAiB,EAAE,OAAoC;IAC/E,MAAM,UAAU,GAAG,OAAO,EAAE,QAAQ,IAAI,KAAK,CAAC;IAC9C,MAAM,WAAW,GAAG,OAAO,EAAE,SAAS,IAAI,IAAI,CAAC;IAE/C,IAAI,UAAU,EAAE,CAAC;QACf,IAAI,CAAC,KAAK,CAAC,WAAW;YAAE,eAAe,CAAC,KAAK,CAAC,CAAC;QAC/C,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtC,MAAM,CAAC,GAAG,KAAK,CAAC,MAAgC,CAAC;QACjD,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACtC,IAAI,KAAK,GAAG,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;YAClD,IAAI,KAAK,CAAC,QAAQ;gBAAE,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC9C,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACxB,CAAC;QACD,IAAI,WAAW;YAAE,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,OAAqB,EACrB,MAAc,EACd,WAAyC,EACzC,OAAoC;IAEpC,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO;IAE/B,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;QACzB,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,CAAC,GAAG,WAAsC,CAAC;YACjD,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAsC,CAAC;YAC9D,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjC,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;oBACpB,QAAQ,GAAG,IAAI,CAAC;oBAChB,MAAM;gBACR,CAAC;YACH,CAAC;YACD,IAAI,CAAC,QAAQ;gBAAE,SAAS;QAC1B,CAAC;QAED,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC"}

package/dist/tweenManager.d.ts

@@ -0,0 +1,5 @@
+import type { TweenManager, TweenManagerOptions } from '@flighthq/types';
+export type { TweenManagerOptions } from '@flighthq/types';
+export declare function createTweenManager(options?: Readonly<TweenManagerOptions>): TweenManager;
+export declare const defaultManager: TweenManager;
+//# sourceMappingURL=tweenManager.d.ts.map

package/dist/tweenManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tweenManager.d.ts","sourceRoot":"","sources":["../src/tweenManager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEzE,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,mBAAmB,CAAC,GAAG,YAAY,CAMxF;AAED,eAAO,MAAM,cAAc,EAAE,YAAmC,CAAC"}

package/dist/tweenManager.js

@@ -0,0 +1,10 @@
+import { easeOutExponential } from '@flighthq/easing';
+export function createTweenManager(options) {
+    return {
+        __brand: 'TweenManager',
+        defaultEase: options?.defaultEase ?? easeOutExponential,
+        tweens: new Map(),
+    };
+}
+export const defaultManager = createTweenManager();
+//# sourceMappingURL=tweenManager.js.map

package/dist/tweenManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tweenManager.js","sourceRoot":"","sources":["../src/tweenManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAKtD,MAAM,UAAU,kBAAkB,CAAC,OAAuC;IACxE,OAAO;QACL,OAAO,EAAE,cAAc;QACvB,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,kBAAkB;QACvD,MAAM,EAAE,IAAI,GAAG,EAAE;KAClB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAiB,kBAAkB,EAAE,CAAC"}

package/dist/tweenProgress.d.ts

@@ -0,0 +1,33 @@
+import type { Tween } from '@flighthq/types';
+/**
+ * Return the normalized playback progress of a tween in the range 0..1.
+ * Returns 0 if the tween is still in its delay phase; returns 1 when complete.
+ * Does not account for repeat; each cycle starts at 0 and ends at 1.
+ */
+export declare function getTweenProgress(tween: Tween<any>): number;
+/**
+ * Drop all captured start values so the next update re-captures them from the current
+ * target state. Equivalent to GSAP `invalidate()`. Resets elapsed and complete state.
+ */
+export declare function invalidateTween(tween: Tween<any>): void;
+/**
+ * Rewind and replay a tween from the beginning. Re-initializes start values from the
+ * current target state. Optionally keeps the initial delay.
+ */
+export declare function restartTween(tween: Tween<any>, includeDelay?: boolean): void;
+/**
+ * Jump the tween to an absolute elapsed time and immediately apply the resulting
+ * property values to the target. The time is measured from the start of the tween
+ * (before any delay). Clamps to 0..delay+duration.
+ *
+ * This is alias-safe: all input values are read before any writes occur.
+ */
+export declare function seekTween(tween: Tween<any>, timeSeconds: number): void;
+/**
+ * Set the normalized progress of a tween to a value in 0..1 and immediately apply
+ * the resulting property values to the target. Safe to call before the delay has elapsed.
+ *
+ * This is alias-safe: all input values are read before any writes occur.
+ */
+export declare function setTweenProgress(tween: Tween<any>, progress: number): void;
+//# sourceMappingURL=tweenProgress.d.ts.map

package/dist/tweenProgress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tweenProgress.d.ts","sourceRoot":"","sources":["../src/tweenProgress.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAI7C;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,MAAM,CAK1D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAIvD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,YAAY,UAAO,GAAG,IAAI,CAIzE;AAID;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CA2BtE;AAGD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAI1E"}

package/dist/tweenProgress.js

@@ -0,0 +1,87 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { emitSignal } from '@flighthq/signals';
+import { initializeTween } from './internal';
+/**
+ * Return the normalized playback progress of a tween in the range 0..1.
+ * Returns 0 if the tween is still in its delay phase; returns 1 when complete.
+ * Does not account for repeat; each cycle starts at 0 and ends at 1.
+ */
+export function getTweenProgress(tween) {
+    if (tween.complete)
+        return 1;
+    const activeElapsed = tween.elapsed - tween.delay;
+    if (activeElapsed <= 0)
+        return 0;
+    return Math.min(activeElapsed / tween.duration, 1);
+}
+/**
+ * Drop all captured start values so the next update re-captures them from the current
+ * target state. Equivalent to GSAP `invalidate()`. Resets elapsed and complete state.
+ */
+export function invalidateTween(tween) {
+    tween.initialized = false;
+    tween.complete = false;
+    tween.elapsed = 0;
+}
+/**
+ * Rewind and replay a tween from the beginning. Re-initializes start values from the
+ * current target state. Optionally keeps the initial delay.
+ */
+export function restartTween(tween, includeDelay = true) {
+    tween.initialized = false;
+    tween.complete = false;
+    tween.elapsed = includeDelay ? 0 : tween.delay;
+}
+// Seeking to the exact end (delay + duration) marks the tween complete and
+// fires onComplete. Seeking to any earlier time does not.
+/**
+ * Jump the tween to an absolute elapsed time and immediately apply the resulting
+ * property values to the target. The time is measured from the start of the tween
+ * (before any delay). Clamps to 0..delay+duration.
+ *
+ * This is alias-safe: all input values are read before any writes occur.
+ */
+export function seekTween(tween, timeSeconds) {
+    if (!tween.initialized)
+        initializeTween(tween);
+    // Clamp to valid range
+    const maxElapsed = tween.delay + tween.duration;
+    const clampedElapsed = Math.max(0, Math.min(timeSeconds, maxElapsed));
+    tween.elapsed = clampedElapsed;
+    const activeElapsed = clampedElapsed - tween.delay;
+    if (activeElapsed <= 0)
+        return;
+    const t = Math.min(activeElapsed / tween.duration, 1);
+    const effectiveT = tween.reverse ? 1 - t : t;
+    const easedT = tween.ease(effectiveT);
+    // Read all start/change values before writing
+    const writes = [];
+    for (const detail of tween.properties) {
+        let value = detail.start + detail.change * easedT;
+        if (tween.snapping)
+            value = Math.round(value);
+        writes.push({ key: detail.key, value });
+    }
+    const target = tween.target;
+    for (const { key, value } of writes) {
+        target[key] = value;
+    }
+    emitSignal(tween.onUpdate);
+    if (t >= 1 && !tween.complete) {
+        tween.complete = true;
+        emitSignal(tween.onComplete);
+    }
+}
+// Setting progress to exactly 1 marks the tween complete and fires onComplete.
+/**
+ * Set the normalized progress of a tween to a value in 0..1 and immediately apply
+ * the resulting property values to the target. Safe to call before the delay has elapsed.
+ *
+ * This is alias-safe: all input values are read before any writes occur.
+ */
+export function setTweenProgress(tween, progress) {
+    const clamped = Math.max(0, Math.min(progress, 1));
+    const targetElapsed = tween.delay + clamped * tween.duration;
+    seekTween(tween, targetElapsed);
+}
+//# sourceMappingURL=tweenProgress.js.map

package/dist/tweenProgress.js.map

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

package/dist/tweenStagger.d.ts

@@ -0,0 +1,27 @@
+import type { EasingFunction, NumericProps, Tween, TweenManager, TweenOptions } from '@flighthq/types';
+export interface TweenStaggerOptions {
+    /**
+     * Delay in seconds between each target's tween start.
+     * Default: 0.1.
+     */
+    each?: number;
+    /**
+     * How to order the stagger delay distribution across targets.
+     * - 'start': first target starts first (default).
+     * - 'center': middle target starts first, delays spread outward.
+     * - 'end': last target starts first.
+     * - number: index of the target that starts first; delays spread outward from there.
+     */
+    from?: 'center' | 'end' | 'start' | number;
+    /** Optional easing applied to the stagger delay distribution (not to individual tweens). */
+    staggerEase?: EasingFunction;
+}
+/**
+ * Batch-tween an array of targets with staggered start delays.
+ * Returns the array of created tweens in the same order as `targets`.
+ *
+ * Each tween inherits `options` but gets an additional `delay` equal to its position in the
+ * stagger sequence (plus any `options.delay` already set).
+ */
+export declare function createTweenStagger<T extends object>(manager: TweenManager, targets: readonly T[], duration: number, propertyMap: Readonly<NumericProps<T>>, stagger?: Readonly<TweenStaggerOptions>, options?: Readonly<TweenOptions>): Tween<T>[];
+//# sourceMappingURL=tweenStagger.d.ts.map

package/dist/tweenStagger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tweenStagger.d.ts","sourceRoot":"","sources":["../src/tweenStagger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAIvG,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;IAC3C,4FAA4F;IAC5F,WAAW,CAAC,EAAE,cAAc,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,EACjD,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,SAAS,CAAC,EAAE,EACrB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EACtC,OAAO,CAAC,EAAE,QAAQ,CAAC,mBAAmB,CAAC,EACvC,OAAO,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,GAC/B,KAAK,CAAC,CAAC,CAAC,EAAE,CAiBZ"}

package/dist/tweenStagger.js

@@ -0,0 +1,51 @@
+import { createTween } from './tween';
+/**
+ * Batch-tween an array of targets with staggered start delays.
+ * Returns the array of created tweens in the same order as `targets`.
+ *
+ * Each tween inherits `options` but gets an additional `delay` equal to its position in the
+ * stagger sequence (plus any `options.delay` already set).
+ */
+export function createTweenStagger(manager, targets, duration, propertyMap, stagger, options) {
+    if (targets.length === 0)
+        return [];
+    const each = stagger?.each ?? 0.1;
+    const from = stagger?.from ?? 'start';
+    const staggerEase = stagger?.staggerEase;
+    const baseDelay = options?.delay ?? 0;
+    const count = targets.length;
+    const tweens = [];
+    for (let i = 0; i < count; i++) {
+        const staggerOffset = computeStaggerDelay(i, count, each, from, staggerEase);
+        const tween = createTween(manager, targets[i], duration, propertyMap, {
+            ...options,
+            delay: baseDelay + staggerOffset,
+        });
+        tweens.push(tween);
+    }
+    return tweens;
+}
+function computeStaggerDelay(index, count, each, from, staggerEase) {
+    if (count <= 1)
+        return 0;
+    let normalizedPosition;
+    if (from === 'start') {
+        normalizedPosition = index / (count - 1);
+    }
+    else if (from === 'end') {
+        normalizedPosition = (count - 1 - index) / (count - 1);
+    }
+    else if (from === 'center') {
+        const center = (count - 1) / 2;
+        normalizedPosition = Math.abs(index - center) / center;
+    }
+    else {
+        // from is a numeric index: distance from the specified origin
+        const origin = Math.max(0, Math.min(from, count - 1));
+        const maxDistance = Math.max(origin, count - 1 - origin);
+        normalizedPosition = maxDistance > 0 ? Math.abs(index - origin) / maxDistance : 0;
+    }
+    const eased = staggerEase !== undefined ? staggerEase(normalizedPosition) : normalizedPosition;
+    return eased * each * (count - 1);
+}
+//# sourceMappingURL=tweenStagger.js.map

package/dist/tweenStagger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tweenStagger.js","sourceRoot":"","sources":["../src/tweenStagger.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAoBtC;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAqB,EACrB,OAAqB,EACrB,QAAgB,EAChB,WAAsC,EACtC,OAAuC,EACvC,OAAgC;IAEhC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,GAAG,CAAC;IAClC,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,OAAO,CAAC;IACtC,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,CAAC;IACzC,MAAM,SAAS,GAAG,OAAO,EAAE,KAAK,IAAI,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IAC7B,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/B,MAAM,aAAa,GAAG,mBAAmB,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;QAC7E,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE;YACpE,GAAG,OAAO;YACV,KAAK,EAAE,SAAS,GAAG,aAAa;SACjC,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,mBAAmB,CAC1B,KAAa,EACb,KAAa,EACb,IAAY,EACZ,IAAyC,EACzC,WAA4B;IAE5B,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACzB,IAAI,kBAA0B,CAAC;IAC/B,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,kBAAkB,GAAG,KAAK,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAC3C,CAAC;SAAM,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QAC1B,kBAAkB,GAAG,CAAC,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IACzD,CAAC;SAAM,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QAC/B,kBAAkB,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC;IACzD,CAAC;SAAM,CAAC;QACN,8DAA8D;QAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;QACtD,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;QACzD,kBAAkB,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACpF,CAAC;IACD,MAAM,KAAK,GAAG,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC;IAC/F,OAAO,KAAK,GAAG,IAAI,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC"}

package/dist/updateTweens.d.ts

@@ -0,0 +1,4 @@
+import type { Tween, TweenManager } from '@flighthq/types';
+export declare function completeTween<T extends object>(tween: Tween<T>): void;
+export declare function updateTweens(manager: TweenManager, deltaTime: number): void;
+//# sourceMappingURL=updateTweens.d.ts.map

package/dist/updateTweens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateTweens.d.ts","sourceRoot":"","sources":["../src/updateTweens.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAI3D,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAarE;AA8CD,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAa3E"}