@starweb-libs/tween 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Starweb Libraries, Mason L'Etoile
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,23 @@
+# Starweb Tween
+
+Frame-driven tween manager with easing for the browser, built with TypeScript.
+
+## Tech Stack
+<p align="left">
+  <img height="35" src="https://img.shields.io/badge/TypeScript-%23007ACC?logo=typescript&logoColor=white&style=for-the-badge"/>
+</p>
+
+## Modules
+| Module    | Description                            |
+| ------    | -----------                            |
+| `easing`  | Easing functions and lookup table      |
+| `manager` | Frame-driven tween manager             |
+| `types`   | Tween config, handle, and target types |
+
+## Installation
+```bash
+npm install github:starweb-libs/tween
+```
+
+## License
+MIT — see [LICENSE](./LICENSE) for details.

package/dist/easing.d.ts

@@ -0,0 +1,17 @@
+/** Easing function name. */
+export type EasingName = 'linear' | 'sine.in' | 'sine.out' | 'sine.inOut' | 'quad.in' | 'quad.out' | 'quad.inOut' | 'cubic.in' | 'cubic.out' | 'cubic.inOut' | 'expo.in' | 'expo.out' | 'expo.inOut';
+/** A function that maps a linear progress value (0-1) to an eased value (0-1).*/
+export type EasingFunction = (t: number) => number;
+/** Flips an ease-in function into its ease-out equivalent. */
+export declare const easeOut: (f: EasingFunction) => EasingFunction;
+/** Combines an ease-in function with its inverse for a symmetric ease-in-out curve. */
+export declare const easeInOut: (f: EasingFunction) => EasingFunction;
+/** Generates in/out/inOut easing functions for a given exponent. */
+export declare const makePowerEase: (exponent: number) => {
+    in: EasingFunction;
+    out: EasingFunction;
+    inOut: EasingFunction;
+};
+/** Lookup table of easing functions keyed by name. */
+export declare const TWEEN_EASING: Readonly<Record<EasingName, EasingFunction>>;
+//# sourceMappingURL=easing.d.ts.map

package/dist/easing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"easing.d.ts","sourceRoot":"","sources":["../src/easing.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,MAAM,MAAM,UAAU,GAAG,QAAQ,GACL,SAAS,GAAK,UAAU,GAAK,YAAY,GACzC,SAAS,GAAK,UAAU,GAAK,YAAY,GACzC,UAAU,GAAI,WAAW,GAAI,aAAa,GAC1C,SAAS,GAAK,UAAU,GAAK,YAAY,CAAC;AAEtE,iFAAiF;AACjF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;AAEnD,8DAA8D;AAC9D,eAAO,MAAM,OAAO,GAAI,GAAG,cAAc,KAAG,cACzB,CAAC;AAEpB,uFAAuF;AACvF,eAAO,MAAM,SAAS,GAAI,GAAG,cAAc,KAAG,cACK,CAAC;AAEpD,oEAAoE;AACpE,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM;;;;CAG7C,CAAC;AAqBF,sDAAsD;AACtD,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,cAAc,CAAC,CAsBrE,CAAA"}

package/dist/easing.js

@@ -0,0 +1,46 @@
+/** Flips an ease-in function into its ease-out equivalent. */
+export const easeOut = (f) => t => 1 - f(1 - t);
+/** Combines an ease-in function with its inverse for a symmetric ease-in-out curve. */
+export const easeInOut = (f) => t => t < 0.5 ? f(2 * t) / 2 : 1 - f(-2 * t + 2) / 2;
+/** Generates in/out/inOut easing functions for a given exponent. */
+export const makePowerEase = (exponent) => {
+    const i = t => t ** exponent;
+    return { in: i, out: easeOut(i), inOut: easeInOut(i) };
+};
+/** Sine ease-in base curve. */
+const sineIn = t => 1 - Math.cos(t * Math.PI / 2);
+/** Sine ease-out. */
+const sineOut = easeOut(sineIn);
+/** Sine ease-in-out. */
+const sineInOut = easeInOut(sineIn);
+/** Quadratic easing curves. */
+const quad = makePowerEase(2);
+/** Cubic easing curves.*/
+const cubic = makePowerEase(3);
+/** Exponential ease-in with edge case guards. */
+const expoIn = t => t === 0 ? 0 : t === 1 ? 1 : 2 ** (10 * t - 10);
+/** Exponential ease-out. */
+const expoOut = easeOut(expoIn);
+/** Exponential ease-in-out. */
+const expoInOut = easeInOut(expoIn);
+/** Lookup table of easing functions keyed by name. */
+export const TWEEN_EASING = {
+    'linear': t => t,
+    // Sine
+    'sine.in': sineIn,
+    'sine.out': sineOut,
+    'sine.inOut': sineInOut,
+    // Quad
+    'quad.in': quad.in,
+    'quad.out': quad.out,
+    'quad.inOut': quad.inOut,
+    // Cubic
+    'cubic.in': cubic.in,
+    'cubic.out': cubic.out,
+    'cubic.inOut': cubic.inOut,
+    // Exponential
+    'expo.in': expoIn,
+    'expo.out': expoOut,
+    'expo.inOut': expoInOut,
+};
+//# sourceMappingURL=easing.js.map

package/dist/easing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"easing.js","sourceRoot":"","sources":["../src/easing.ts"],"names":[],"mappings":"AAUA,8DAA8D;AAC9D,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAiB,EAAkB,EAAE,CAC3D,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAEpB,uFAAuF;AACvF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAiB,EAAkB,EAAE,CAC7D,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;AAEpD,oEAAoE;AACpE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAgB,EAAE,EAAE;IAChD,MAAM,CAAC,GAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,QAAQ,CAAC;IAC7C,OAAO,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;AACzD,CAAC,CAAC;AAEF,+BAA+B;AAC/B,MAAM,MAAM,GAAsB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;AACrE,qBAAqB;AACrB,MAAM,OAAO,GAAqB,OAAO,CAAC,MAAM,CAAC,CAAC;AAClD,wBAAwB;AACxB,MAAM,SAAS,GAAmB,SAAS,CAAC,MAAM,CAAC,CAAC;AAEpD,+BAA+B;AAC/B,MAAM,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;AAC9B,0BAA0B;AAC1B,MAAM,KAAK,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;AAE/B,iDAAiD;AACjD,MAAM,MAAM,GAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;AACnF,4BAA4B;AAC5B,MAAM,OAAO,GAAqB,OAAO,CAAC,MAAM,CAAC,CAAC;AAClD,+BAA+B;AAC/B,MAAM,SAAS,GAAmB,SAAS,CAAC,MAAM,CAAC,CAAC;AAEpD,sDAAsD;AACtD,MAAM,CAAC,MAAM,YAAY,GAAiD;IACxE,QAAQ,EAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAErB,OAAO;IACP,SAAS,EAAM,MAAM;IACrB,UAAU,EAAK,OAAO;IACtB,YAAY,EAAG,SAAS;IAExB,OAAO;IACP,SAAS,EAAM,IAAI,CAAC,EAAE;IACtB,UAAU,EAAK,IAAI,CAAC,GAAG;IACvB,YAAY,EAAG,IAAI,CAAC,KAAK;IAEzB,QAAQ;IACR,UAAU,EAAK,KAAK,CAAC,EAAE;IACvB,WAAW,EAAI,KAAK,CAAC,GAAG;IACxB,aAAa,EAAE,KAAK,CAAC,KAAK;IAE1B,cAAc;IACd,SAAS,EAAM,MAAM;IACrB,UAAU,EAAK,OAAO;IACtB,YAAY,EAAG,SAAS;CACzB,CAAA"}

package/dist/manager.d.ts

@@ -0,0 +1,9 @@
+import type { TweenManager } from "./types.js";
+/** Creates a tween manager that drives property animations each frame.
+ *
+ * Call `update` once per frame with the frame delta in **ms**.
+ *
+ * @returns A {@link TweenManager} with `add`, `update`, and `stopAll`.
+ */
+export declare function createTweenManager(): TweenManager;
+//# sourceMappingURL=manager.d.ts.map

package/dist/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../src/manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAyC,YAAY,EAAE,MAAM,YAAY,CAAC;AAmCtF;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CAmJjD"}

package/dist/manager.js

@@ -0,0 +1,151 @@
+import { TWEEN_EASING } from "./easing.js";
+/** Creates a tween manager that drives property animations each frame.
+ *
+ * Call `update` once per frame with the frame delta in **ms**.
+ *
+ * @returns A {@link TweenManager} with `add`, `update`, and `stopAll`.
+ */
+export function createTweenManager() {
+    const tweens = new Set();
+    /** Adds and starts a tween from the given config.
+     * @returns A {@link TweenHandle} to control the tween.
+     */
+    function add(config) {
+        const targetArray = Array.isArray(config.targets) ? [...config.targets] : [config.targets];
+        const easeFn = TWEEN_EASING[config.ease ?? 'linear'];
+        const resolvedTargets = targetArray.map(obj => {
+            const props = {};
+            const keys = [];
+            for (const [key, val] of Object.entries(config.props)) {
+                if (val === undefined)
+                    continue;
+                props[key] = typeof val === 'number' ? { from: obj[key] ?? 0, to: val } : val;
+                keys.push(key);
+            }
+            return { obj, props, keys };
+        });
+        const tween = {
+            targets: resolvedTargets,
+            duration: config.duration,
+            ease: easeFn,
+            yoyo: config.yoyo ?? false,
+            repeat: config.repeat ?? 0,
+            delay: config.delay ?? 0,
+            elapsed: 0,
+            delayElapsed: 0,
+            direction: 1,
+            repeatsDone: 0,
+            started: false,
+            paused: false,
+            stopped: false,
+            onStart: config.onStart,
+            onUpdate: config.onUpdate,
+            onComplete: config.onComplete,
+            onYoyo: config.onYoyo,
+            onRepeat: config.onRepeat,
+        };
+        tweens.add(tween);
+        return {
+            stop: () => { if (!tween.stopped) {
+                tween.stopped = true;
+                tweens.delete(tween);
+            } },
+            pause: () => { if (!tween.stopped)
+                tween.paused = true; },
+            resume: () => { if (!tween.stopped)
+                tween.paused = false; },
+            get isPlaying() { return !tween.paused && !tween.stopped; },
+        };
+    }
+    /** Advances all active tweens by `deltaMs` **milliseconds**. Call once per frame. */
+    function update(deltaMs) {
+        for (const tween of [...tweens]) {
+            if (tween.paused || tween.stopped)
+                continue;
+            let step = deltaMs;
+            if (tween.delayElapsed < tween.delay) {
+                const remaining = tween.delay - tween.delayElapsed;
+                if (step <= remaining) {
+                    tween.delayElapsed += step;
+                    continue;
+                }
+                tween.delayElapsed = tween.delay;
+                step -= remaining;
+            }
+            if (!tween.started) {
+                tween.started = true;
+                tween.onStart?.();
+            }
+            if (tween.duration <= 0) {
+                for (const { obj, props, keys } of tween.targets) {
+                    for (const key of keys) {
+                        const resolved = props[key];
+                        if (resolved)
+                            obj[key] = resolved.to;
+                    }
+                }
+                tween.onUpdate?.(1);
+                tween.onComplete?.();
+                tweens.delete(tween);
+                continue;
+            }
+            while (step > 0 && !tween.stopped) {
+                const next = tween.elapsed + step;
+                const overflow = Math.max(0, next - tween.duration);
+                tween.elapsed = Math.min(next, tween.duration);
+                const raw = tween.elapsed / tween.duration;
+                const t = tween.direction === 1 ? tween.ease(raw) : tween.ease(1 - raw);
+                for (const { obj, props, keys } of tween.targets) {
+                    for (const key of keys) {
+                        const resolved = props[key];
+                        if (resolved)
+                            obj[key] = resolved.from + (resolved.to - resolved.from) * t;
+                    }
+                }
+                tween.onUpdate?.(t);
+                if (tween.elapsed >= tween.duration) {
+                    if (tween.yoyo) {
+                        if (tween.direction === 1) {
+                            tween.direction = -1;
+                            tween.onYoyo?.();
+                        }
+                        else {
+                            tween.direction = 1;
+                            if (tween.repeat === -1 || tween.repeatsDone < tween.repeat) {
+                                tween.repeatsDone++;
+                                tween.onRepeat?.();
+                            }
+                            else {
+                                tween.onComplete?.();
+                                tweens.delete(tween);
+                                break;
+                            }
+                        }
+                    }
+                    else {
+                        if (tween.repeat === -1 || tween.repeatsDone < tween.repeat) {
+                            tween.repeatsDone++;
+                            tween.onRepeat?.();
+                        }
+                        else {
+                            tween.onComplete?.();
+                            tweens.delete(tween);
+                            break;
+                        }
+                    }
+                    tween.elapsed = overflow;
+                    step = overflow;
+                }
+                else {
+                    step = 0;
+                }
+            }
+        }
+    }
+    /** Immediately stops and removes all active tweens. */
+    function stopAll() {
+        tweens.clear();
+    }
+    return { add, update, stopAll };
+}
+//# sourceMappingURL=manager.js.map

package/dist/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../src/manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,YAAY,EAAyB,MAAM,aAAa,CAAC;AAoCvF;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAe,CAAC;IAEtC;;OAEG;IACH,SAAS,GAAG,CAAC,MAAmB;QAC9B,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC3F,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,IAAI,QAAQ,CAAC,CAAC;QAErD,MAAM,eAAe,GAAqB,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;YAC9D,MAAM,KAAK,GAAqD,EAAE,CAAC;YACnE,MAAM,IAAI,GAA0B,EAAE,CAAC;YACvC,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CACgB,EAClE,CAAC;gBACD,IAAI,GAAG,KAAK,SAAS;oBAAE,SAAS;gBAChC,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;gBAC9E,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACjB,CAAC;YACD,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC9B,CAAC,CAAC,CAAC;QAEH,MAAM,KAAK,GAAgB;YACzB,OAAO,EAAO,eAAe;YAC7B,QAAQ,EAAM,MAAM,CAAC,QAAQ;YAC7B,IAAI,EAAU,MAAM;YACpB,IAAI,EAAU,MAAM,CAAC,IAAI,IAAM,KAAK;YACpC,MAAM,EAAQ,MAAM,CAAC,MAAM,IAAI,CAAC;YAChC,KAAK,EAAS,MAAM,CAAC,KAAK,IAAK,CAAC;YAChC,OAAO,EAAO,CAAC;YACf,YAAY,EAAE,CAAC;YACf,SAAS,EAAK,CAAC;YACf,WAAW,EAAG,CAAC;YACf,OAAO,EAAO,KAAK;YACnB,MAAM,EAAQ,KAAK;YACnB,OAAO,EAAO,KAAK;YACnB,OAAO,EAAO,MAAM,CAAC,OAAO;YAC5B,QAAQ,EAAM,MAAM,CAAC,QAAQ;YAC7B,UAAU,EAAI,MAAM,CAAC,UAAU;YAC/B,MAAM,EAAQ,MAAM,CAAC,MAAM;YAC3B,QAAQ,EAAM,MAAM,CAAC,QAAQ;SAC9B,CAAC;QAEF,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAElB,OAAO;YACL,IAAI,EAAM,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;gBAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAAC,CAAC,CAAC,CAAC;YACvF,KAAK,EAAK,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO;gBAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAE,CAAC;YAC7D,MAAM,EAAI,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO;gBAAE,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC;YAC7D,IAAI,SAAS,KAAK,OAAO,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAG,CAAC;SAC9D,CAAC;IACJ,CAAC;IAED,qFAAqF;IACrF,SAAS,MAAM,CAAC,OAAe;QAC7B,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC;YAChC,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,OAAO;gBAAE,SAAS;YAE5C,IAAI,IAAI,GAAG,OAAO,CAAC;YACnB,IAAI,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;gBACrC,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC;gBACnD,IAAI,IAAI,IAAI,SAAS,EAAE,CAAC;oBACtB,KAAK,CAAC,YAAY,IAAI,IAAI,CAAC;oBAC3B,SAAS;gBACX,CAAC;gBACD,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC;gBACjC,IAAI,IAAI,SAAS,CAAC;YACpB,CAAC;YAED,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACnB,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;gBACrB,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YACpB,CAAC;YAED,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC;gBACxB,KAAK,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;oBACjD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;wBACvB,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;wBAC5B,IAAI,QAAQ;4BAAE,GAAG,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC;oBACvC,CAAC;gBACH,CAAC;gBAED,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;gBACpB,KAAK,CAAC,UAAU,EAAE,EAAE,CAAC;gBACrB,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACrB,SAAS;YACX,CAAC;YAED,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBAClC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;gBAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;gBACpD,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;gBAE/C,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC;gBAC3C,MAAM,CAAC,GAAK,KAAK,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;gBAE1E,KAAK,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;oBACjD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;wBACvB,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;wBAC5B,IAAI,QAAQ;4BAAE,GAAG,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBAC7E,CAAC;gBACH,CAAC;gBAED,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;gBAEpB,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;oBACpC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;wBACf,IAAI,KAAK,CAAC,SAAS,KAAK,CAAC,EAAE,CAAC;4BAC1B,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;4BACrB,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;wBACnB,CAAC;6BAAM,CAAC;4BACN,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC;4BACpB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;gCAC5D,KAAK,CAAC,WAAW,EAAE,CAAC;gCACpB,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC;4BACrB,CAAC;iCAAM,CAAC;gCACN,KAAK,CAAC,UAAU,EAAE,EAAE,CAAC;gCACrB,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gCACrB,MAAM;4BACR,CAAC;wBACH,CAAC;oBACH,CAAC;yBAAM,CAAC;wBACN,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;4BAC5D,KAAK,CAAC,WAAW,EAAE,CAAC;4BACpB,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC;wBACrB,CAAC;6BAAM,CAAC;4BACN,KAAK,CAAC,UAAU,EAAE,EAAE,CAAC;4BACrB,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;4BACrB,MAAM;wBACR,CAAC;oBACH,CAAC;oBACD,KAAK,CAAC,OAAO,GAAG,QAAQ,CAAC;oBACzB,IAAI,GAAG,QAAQ,CAAC;gBAClB,CAAC;qBAAM,CAAC;oBACN,IAAI,GAAG,CAAC,CAAC;gBACX,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,uDAAuD;IACvD,SAAS,OAAO;QACd,MAAM,CAAC,KAAK,EAAE,CAAC;IACjB,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAClC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,69 @@
+import { type EasingName } from "./easing.js";
+/** An object whose properties can be animated by the tween system. */
+export type TweenTarget = {
+    alpha?: number;
+    y?: number;
+};
+/** A single target, or an array of targets to animate in parallel. */
+export type TweenTargets = TweenTarget | readonly TweenTarget[];
+/** A target value: number (tweens from current) or explicit from/to. */
+export type TweenPropValue = number | {
+    from: number;
+    to: number;
+};
+/** Map of supported property names to target values. */
+export type TweenProps = Partial<Record<keyof TweenTarget, TweenPropValue>>;
+/** Configuration for a tween animation. */
+export interface TweenConfig {
+    /** Target or array of targets whose properties will be animated. */
+    targets: TweenTargets;
+    /** Map of supported property names to target values. */
+    props: TweenProps;
+    /** Duration of one pass in milliseconds. */
+    duration: number;
+    /** Delay before starting in milliseconds. Default: 0. */
+    delay?: number;
+    /** Easing function. Default: 'linear'. */
+    ease?: EasingName;
+    /** Reverse the animation at the end of each pass. Default: false. */
+    yoyo?: boolean;
+    /**
+     * Additional repeat count after the first play. 0 = play once, -1 = infinite.
+     * With yoyo, each forward+backward pair counts as one repeat.
+     * Default: 0.
+     */
+    repeat?: number;
+    /** Called once when the tween starts (after any delay). */
+    onStart?: () => void;
+    /** Called every frame with the eased progress value (0–1). */
+    onUpdate?: (progress: number) => void;
+    /** Called each time a yoyo reverses direction (forward → backward). */
+    onYoyo?: () => void;
+    /** Called at the start of each new repeat cycle (backward → forward). */
+    onRepeat?: () => void;
+    /** Called when the tween fully completes. Not called for infinite repeats. */
+    onComplete?: () => void;
+}
+/** A handle to control a running tween returned by {@link TweenManager.add}.*/
+export interface TweenHandle {
+    /** Immediately stop and remove the tween. */
+    stop(): void;
+    /** Pause without removing. */
+    pause(): void;
+    /** Resume a paused tween. */
+    resume(): void;
+    /** `true` if the tween is active and not paused. */
+    readonly isPlaying: boolean;
+}
+/** Manages a collection of active tweens, advancing them each frame. */
+export interface TweenManager {
+    /** Adds and starts a tween from the given config.
+     * @returns A {@link TweenHandle} to control the tween.
+     */
+    add(config: TweenConfig): TweenHandle;
+    /** Advances all active tweens by `deltaMs` **ms**. Call once per frame. */
+    update(deltaMs: number): void;
+    /** Immediately stops and removes all active tweens. */
+    stopAll(): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,sEAAsE;AACtE,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ,CAAC;AACF,sEAAsE;AACtE,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,SAAS,WAAW,EAAE,CAAC;AAEhE,wEAAwE;AACxE,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AACnE,wDAAwD;AACxD,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC;AAE5E,2CAA2C;AAC3C,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,OAAO,EAAE,YAAY,CAAC;IACtB,wDAAwD;IACxD,KAAK,EAAE,UAAU,CAAC;IAElB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,0CAA0C;IAC1C,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,qEAAqE;IACrE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB;AAED,+EAA+E;AAC/E,MAAM,WAAW,WAAW;IAC1B,6CAA6C;IAC7C,IAAI,IAAI,IAAI,CAAC;IACb,8BAA8B;IAC9B,KAAK,IAAI,IAAI,CAAC;IACd,6BAA6B;IAC7B,MAAM,IAAI,IAAI,CAAC;IACf,oDAAoD;IACpD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,wEAAwE;AACxE,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAAC;IAEtC,2EAA2E;IAC3E,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B,uDAAuD;IACvD,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+import {} from "./easing.js";
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,MAAM,aAAa,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@starweb-libs/tween",
+  "description": "Frame-driven tween manager with easing for the browser",
+  "author": "Mason L'Etoile",
+  "version": "0.0.1",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/starweb-libs/tween.git"
+  },
+  "homepage": "https://github.com/starweb-libs/tween#readme",
+  "bugs": {
+    "url": "https://github.com/starweb-libs/tween/issues"
+  },
+  "keywords": ["tween", "animation", "easing", "typescript", "browser", "starweb"],
+  "type": "module",
+  "devDependencies": { "typescript": "~6.0.2" },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepare": "npm run build"
+  },
+  "files": ["dist"],
+  "exports": {
+    "./easing.js": {
+      "types": "./dist/easing.d.ts",
+      "import": "./dist/easing.js"
+    },
+    "./manager.js": {
+      "types": "./dist/manager.d.ts",
+      "import": "./dist/manager.js"
+    },
+    "./types.js": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js"
+    }
+  }
+}