@motion-script/core 0.1.0

package/dist/tween/ease/constants.js

@@ -0,0 +1,71 @@
+import { clamp01 } from "../../util/clamp";
+export const linear = (t) => clamp01(t);
+export const easeInQuad = (t) => {
+    t = clamp01(t);
+    return t * t;
+};
+export const easeOutQuad = (t) => {
+    t = clamp01(t);
+    return t * (2 - t);
+};
+export const easeOutQuart = (t) => {
+    t = clamp01(t);
+    return 1 - Math.pow(1 - t, 4);
+};
+export const easeInOutQuad = (t) => {
+    t = clamp01(t);
+    return t < 0.5 ? 2 * t * t : -1 + (4 - 2 * t) * t;
+};
+export const easeOutBack = (overshoot = 1.70158) => (t) => {
+    t = clamp01(t) - 1;
+    return 1 + t * t * ((overshoot + 1) * t + overshoot);
+};
+export const easeInBack = (overshoot = 1.70158) => (t) => {
+    t = clamp01(t);
+    return t * t * ((overshoot + 1) * t - overshoot);
+};
+export const easeInOutBack = (overshoot = 1.70158) => (t) => {
+    t = clamp01(t) * 2;
+    const s = overshoot * 1.525;
+    if (t < 1) {
+        return 0.5 * (t * t * ((s + 1) * t - s));
+    }
+    t -= 2;
+    return 0.5 * (t * t * ((s + 1) * t + s) + 2);
+};
+export const easeOutElastic = (amplitude = 1, period = 0.3) => (t) => {
+    t = clamp01(t);
+    if (t === 0 || t === 1)
+        return t;
+    const s = period / (2 * Math.PI) * Math.asin(1 / amplitude);
+    return (amplitude *
+        Math.pow(2, -10 * t) *
+        Math.sin((t - s) * (2 * Math.PI) / period) +
+        1);
+};
+export const easeInElastic = (amplitude = 1, period = 0.3) => (t) => {
+    t = clamp01(t);
+    if (t === 0 || t === 1)
+        return t;
+    const s = period / (2 * Math.PI) * Math.asin(1 / amplitude);
+    return -(amplitude *
+        Math.pow(2, 10 * (t - 1)) *
+        Math.sin((t - 1 - s) * (2 * Math.PI) / period));
+};
+export const easeInOutElastic = (amplitude = 1, period = 0.45) => (t) => {
+    t = clamp01(t) * 2;
+    if (t === 0 || t === 2)
+        return t / 2;
+    const s = period / (2 * Math.PI) * Math.asin(1 / amplitude);
+    if (t < 1) {
+        return -0.5 * (amplitude *
+            Math.pow(2, 10 * (t - 1)) *
+            Math.sin((t - 1 - s) * (2 * Math.PI) / period));
+    }
+    return (amplitude *
+        Math.pow(2, -10 * (t - 1)) *
+        Math.sin((t - 1 - s) * (2 * Math.PI) / period) *
+        0.5 +
+        1);
+};
+//# sourceMappingURL=constants.js.map

package/dist/tween/ease/constants.js.map

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

package/dist/tween/ease/type.d.ts

@@ -0,0 +1,2 @@
+export type EaseFunction = (t: number) => number;
+//# sourceMappingURL=type.d.ts.map

package/dist/tween/ease/type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../../src/tween/ease/type.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC"}

package/dist/tween/ease/type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=type.js.map

package/dist/tween/ease/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../../src/tween/ease/type.ts"],"names":[],"mappings":""}

package/dist/tween/eases.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=eases.test.d.ts.map

package/dist/tween/eases.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eases.test.d.ts","sourceRoot":"","sources":["../../src/tween/eases.test.ts"],"names":[],"mappings":""}

package/dist/tween/eases.test.js

@@ -0,0 +1,91 @@
+import { describe, it, expect } from 'vitest';
+import { linear, easeInQuad, easeOutQuad, easeOutQuart, easeInOutQuad, easeOutBack, easeInBack, easeInOutBack, easeOutElastic, easeInElastic, easeInOutElastic, } from '@/tween/ease/constants';
+function endpoints(fn, atOne = 1) {
+    expect(fn(0)).toBeCloseTo(0, 5);
+    expect(fn(1)).toBeCloseTo(atOne, 5);
+}
+describe('linear', () => {
+    it('is identity in [0,1]', () => {
+        expect(linear(0)).toBe(0);
+        expect(linear(0.5)).toBe(0.5);
+        expect(linear(1)).toBe(1);
+    });
+    it('clamps below 0 and above 1', () => {
+        expect(linear(-0.5)).toBe(0);
+        expect(linear(2)).toBe(1);
+    });
+});
+describe('easeInQuad / easeOutQuad', () => {
+    it('endpoints', () => {
+        endpoints(easeInQuad);
+        endpoints(easeOutQuad);
+    });
+    it('easeInQuad(0.5) < 0.5', () => {
+        expect(easeInQuad(0.5)).toBeLessThan(0.5);
+    });
+    it('easeOutQuad(0.5) > 0.5', () => {
+        expect(easeOutQuad(0.5)).toBeGreaterThan(0.5);
+    });
+    it('clamps to [0,1] range', () => {
+        expect(easeInQuad(-1)).toBe(0);
+        expect(easeOutQuad(2)).toBe(1);
+    });
+});
+describe('easeOutQuart', () => {
+    it('endpoints', () => endpoints(easeOutQuart));
+    it('decelerates strongly (f(0.5) > easeOutQuad(0.5))', () => {
+        expect(easeOutQuart(0.5)).toBeGreaterThan(easeOutQuad(0.5));
+    });
+});
+describe('easeInOutQuad', () => {
+    it('endpoints', () => endpoints(easeInOutQuad));
+    it('symmetric around 0.5', () => {
+        expect(easeInOutQuad(0.5)).toBeCloseTo(0.5, 5);
+        expect(easeInOutQuad(0.25)).toBeCloseTo(1 - easeInOutQuad(0.75), 5);
+    });
+});
+describe('easeOutBack', () => {
+    it('endpoints (default overshoot)', () => endpoints(easeOutBack()));
+    it('overshoots above 1 before reaching endpoint', () => {
+        const fn = easeOutBack();
+        let overshot = false;
+        for (let t = 0; t <= 1; t += 0.02) {
+            if (fn(t) > 1.01)
+                overshot = true;
+        }
+        expect(overshot).toBe(true);
+    });
+});
+describe('easeInBack', () => {
+    it('endpoints', () => endpoints(easeInBack()));
+    it('dips below 0 before settling', () => {
+        const fn = easeInBack();
+        let dipped = false;
+        for (let t = 0; t <= 1; t += 0.02) {
+            if (fn(t) < -0.01)
+                dipped = true;
+        }
+        expect(dipped).toBe(true);
+    });
+});
+describe('easeInOutBack', () => {
+    it('endpoints', () => endpoints(easeInOutBack()));
+    it('midpoint is ~0.5', () => {
+        expect(easeInOutBack()(0.5)).toBeCloseTo(0.5, 5);
+    });
+});
+describe('elastic eases', () => {
+    it('endpoints for easeOutElastic', () => endpoints(easeOutElastic()));
+    it('endpoints for easeInElastic', () => endpoints(easeInElastic()));
+    it('endpoints for easeInOutElastic', () => endpoints(easeInOutElastic()));
+    it('oscillates somewhere in the middle', () => {
+        const fn = easeOutElastic();
+        let above1 = false;
+        for (let t = 0; t <= 1; t += 0.01) {
+            if (fn(t) > 1.001)
+                above1 = true;
+        }
+        expect(above1).toBe(true);
+    });
+});
+//# sourceMappingURL=eases.test.js.map

package/dist/tween/eases.test.js.map

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

package/dist/tween/generator.d.ts

@@ -0,0 +1,22 @@
+/**
+ * A generator that drives a single animation forward frame by frame.
+ *
+ * - **yield** suspends the animation and receives the elapsed delta time (`dt`,
+ *   in seconds) for that frame when execution resumes.
+ * - **return** (or falling off the end) signals completion.
+ *
+ * Compose frame generators with {@link sequence} and {@link parallel}, or
+ * drive them manually by calling `.next(dt)` until `.done` is `true`.
+ *
+ * @example
+ * function* fadeIn(node: MyNode): FrameGenerator {
+ *   let elapsed = 0;
+ *   while (elapsed < 1) {
+ *     node.opacity = elapsed;
+ *     elapsed += yield;
+ *   }
+ *   node.opacity = 1;
+ * }
+ */
+export type FrameGenerator = Generator<void, void, number>;
+//# sourceMappingURL=generator.d.ts.map

package/dist/tween/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/tween/generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC"}

package/dist/tween/generator.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=generator.js.map

package/dist/tween/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../src/tween/generator.ts"],"names":[],"mappings":""}

package/dist/tween/index.d.ts

@@ -0,0 +1,12 @@
+export * from './ease/type';
+export * from './ease/constants';
+export * from './tween';
+export * from './generator';
+export * from './animation-builder';
+export * from './parallel';
+export * from './sequence';
+export * from './wait';
+export * from './prepare';
+export * from './stepper';
+export * from './lerp';
+//# sourceMappingURL=index.d.ts.map

package/dist/tween/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tween/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AAEjC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AAEpC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC"}

package/dist/tween/index.js

@@ -0,0 +1,12 @@
+export * from './ease/type';
+export * from './ease/constants';
+export * from './tween';
+export * from './generator';
+export * from './animation-builder';
+export * from './parallel';
+export * from './sequence';
+export * from './wait';
+export * from './prepare';
+export * from './stepper';
+export * from './lerp';
+//# sourceMappingURL=index.js.map

package/dist/tween/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tween/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AAEjC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AAEpC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC"}

package/dist/tween/lerp.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Linearly interpolates between two numbers.
+ *
+ * @param from - Start value at `t = 0`.
+ * @param to   - End value at `t = 1`.
+ * @param t    - Normalized progress in [0, 1]. Values outside this range
+ *               extrapolate beyond the endpoints.
+ * @returns The interpolated value: `from + (to - from) * t`.
+ */
+export declare function lerpNumber(from: number, to: number, t: number): number;
+//# sourceMappingURL=lerp.d.ts.map

package/dist/tween/lerp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lerp.d.ts","sourceRoot":"","sources":["../../src/tween/lerp.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtE"}

package/dist/tween/lerp.js

@@ -0,0 +1,13 @@
+/**
+ * Linearly interpolates between two numbers.
+ *
+ * @param from - Start value at `t = 0`.
+ * @param to   - End value at `t = 1`.
+ * @param t    - Normalized progress in [0, 1]. Values outside this range
+ *               extrapolate beyond the endpoints.
+ * @returns The interpolated value: `from + (to - from) * t`.
+ */
+export function lerpNumber(from, to, t) {
+    return from + (to - from) * t;
+}
+//# sourceMappingURL=lerp.js.map

package/dist/tween/lerp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lerp.js","sourceRoot":"","sources":["../../src/tween/lerp.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,EAAU,EAAE,CAAS;IAC1D,OAAO,IAAI,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;AAClC,CAAC"}

package/dist/tween/lerp.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=lerp.test.d.ts.map

package/dist/tween/lerp.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lerp.test.d.ts","sourceRoot":"","sources":["../../src/tween/lerp.test.ts"],"names":[],"mappings":""}

package/dist/tween/lerp.test.js

@@ -0,0 +1,22 @@
+import { describe, it, expect } from 'vitest';
+import { lerpNumber } from '@/tween/lerp';
+describe('lerpNumber', () => {
+    it('returns from at t=0 and to at t=1', () => {
+        expect(lerpNumber(10, 20, 0)).toBe(10);
+        expect(lerpNumber(10, 20, 1)).toBe(20);
+    });
+    it('interpolates the midpoint at t=0.5', () => {
+        expect(lerpNumber(0, 10, 0.5)).toBe(5);
+    });
+    it('works with descending ranges', () => {
+        expect(lerpNumber(20, 0, 0.25)).toBe(15);
+    });
+    it('extrapolates outside [0,1] (no clamping)', () => {
+        expect(lerpNumber(0, 10, 2)).toBe(20);
+        expect(lerpNumber(0, 10, -1)).toBe(-10);
+    });
+    it('handles negative endpoints', () => {
+        expect(lerpNumber(-10, 10, 0.5)).toBe(0);
+    });
+});
+//# sourceMappingURL=lerp.test.js.map

package/dist/tween/lerp.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lerp.test.js","sourceRoot":"","sources":["../../src/tween/lerp.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IACxB,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvC,MAAM,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtC,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QAClC,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/tween/parallel.d.ts

@@ -0,0 +1,23 @@
+import { FrameGenerator } from "../tween/generator";
+/**
+ * Runs multiple animations simultaneously, finishing when all of them complete.
+ *
+ * **Performance fast-path:** animations that implement {@link Steppable}
+ * (e.g. an {@link AnimationBuilder} returned by `node.to(...)`) are driven as
+ * flat {@link TweenStepper}s — no generator resumes per item. This makes
+ * `parallel` efficient even with hundreds of concurrent node tweens.
+ *
+ * All other animations (nested `parallel`/`sequence`, `wait`, custom
+ * generators) are driven normally as iterators.
+ *
+ * @param animations - Animations to run at the same time.
+ *
+ * @example
+ * yield* parallel(
+ *   nodeA.to({ x: 200 }, 0.6),
+ *   nodeB.to({ opacity: 0 }, 0.4),
+ *   wait(0.6),
+ * );
+ */
+export declare function parallel(...animations: (FrameGenerator | Iterable<void>)[]): FrameGenerator;
+//# sourceMappingURL=parallel.d.ts.map

package/dist/tween/parallel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel.d.ts","sourceRoot":"","sources":["../../src/tween/parallel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAiB,QAAQ,CACrB,GAAG,UAAU,EAAE,CAAC,cAAc,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,GACnD,cAAc,CAyDhB"}

package/dist/tween/parallel.js

@@ -0,0 +1,79 @@
+import { isSteppable } from "../tween/stepper";
+/**
+ * Runs multiple animations simultaneously, finishing when all of them complete.
+ *
+ * **Performance fast-path:** animations that implement {@link Steppable}
+ * (e.g. an {@link AnimationBuilder} returned by `node.to(...)`) are driven as
+ * flat {@link TweenStepper}s — no generator resumes per item. This makes
+ * `parallel` efficient even with hundreds of concurrent node tweens.
+ *
+ * All other animations (nested `parallel`/`sequence`, `wait`, custom
+ * generators) are driven normally as iterators.
+ *
+ * @param animations - Animations to run at the same time.
+ *
+ * @example
+ * yield* parallel(
+ *   nodeA.to({ x: 200 }, 0.6),
+ *   nodeB.to({ opacity: 0 }, 0.4),
+ *   wait(0.6),
+ * );
+ */
+export function* parallel(...animations) {
+    if (animations.length === 0)
+        return;
+    // Split into flat steppers (simple node tweens) and generators (everything
+    // else: wait, nested parallel/sequence, custom generators). Steppers are
+    // driven in a tight loop with no per-item generator resume — the big win
+    // when a parallel holds hundreds of node.to() animations.
+    const steppers = [];
+    const active = [];
+    for (const a of animations) {
+        if (isSteppable(a)) {
+            steppers.push(a._stepper());
+        }
+        else {
+            active.push(Symbol.iterator in a
+                ? a[Symbol.iterator]()
+                : a);
+        }
+    }
+    // Prime: apply each item's t=0 value before the first yield, matching the
+    // old loop where the first next(undefined) ran ahead of any dt.
+    for (const s of steppers)
+        s.seek(0);
+    let g = 0;
+    while (g < active.length) {
+        if (active[g].next(undefined).done) {
+            active[g] = active[active.length - 1];
+            active.pop();
+        }
+        else {
+            g++;
+        }
+    }
+    while (steppers.length > 0 || active.length > 0) {
+        const dt = yield;
+        let i = 0;
+        while (i < steppers.length) {
+            if (steppers[i].advance(dt)) {
+                steppers[i] = steppers[steppers.length - 1];
+                steppers.pop();
+            }
+            else {
+                i++;
+            }
+        }
+        let j = 0;
+        while (j < active.length) {
+            if (active[j].next(dt).done) {
+                active[j] = active[active.length - 1];
+                active.pop();
+            }
+            else {
+                j++;
+            }
+        }
+    }
+}
+//# sourceMappingURL=parallel.js.map

package/dist/tween/parallel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel.js","sourceRoot":"","sources":["../../src/tween/parallel.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAgB,MAAM,iBAAiB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,SAAS,CAAC,CAAC,QAAQ,CACrB,GAAG,UAA+C;IAElD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEpC,2EAA2E;IAC3E,yEAAyE;IACzE,yEAAyE;IACzE,0DAA0D;IAC1D,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,MAAM,MAAM,GAAmC,EAAE,CAAC;IAClD,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QACzB,IAAI,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;YACjB,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QAChC,CAAC;aAAM,CAAC;YACJ,MAAM,CAAC,IAAI,CACP,MAAM,CAAC,QAAQ,IAAI,CAAC;gBAChB,CAAC,CAAE,CAAoB,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAkC;gBAC1E,CAAC,CAAC,CAAiC,CAC1C,CAAC;QACN,CAAC;IACL,CAAC;IAED,0EAA0E;IAC1E,gEAAgE;IAChE,KAAK,MAAM,CAAC,IAAI,QAAQ;QAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpC,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QACvB,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAgB,CAAC,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACtC,MAAM,CAAC,GAAG,EAAE,CAAC;QACjB,CAAC;aAAM,CAAC;YACJ,CAAC,EAAE,CAAC;QACR,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,EAAE,GAAG,KAAK,CAAC;QAEjB,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC;YACzB,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC1B,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBAC5C,QAAQ,CAAC,GAAG,EAAE,CAAC;YACnB,CAAC;iBAAM,CAAC;gBACJ,CAAC,EAAE,CAAC;YACR,CAAC;QACL,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;YACvB,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC1B,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBACtC,MAAM,CAAC,GAAG,EAAE,CAAC;YACjB,CAAC;iBAAM,CAAC;gBACJ,CAAC,EAAE,CAAC;YACR,CAAC;QACL,CAAC;IACL,CAAC;AACL,CAAC"}

package/dist/tween/prepare.d.ts

@@ -0,0 +1,34 @@
+import type { Signal } from "../signals/signal";
+/**
+ * Snapshots the current numeric property values on `target` for the keys
+ * present in `to`, then returns a lerp callback that writes interpolated values
+ * back each frame.
+ *
+ * The snapshot is taken at call time, so invoke this immediately before the
+ * animation starts (not lazily) to capture the correct `from` state.
+ *
+ * @param target - The object whose properties will be animated.
+ * @param to     - Desired end values keyed by property name. Keys with
+ *                 `undefined` values are ignored.
+ * @returns A function `(t: number) => void` that writes `lerp(from, to, t)`
+ *          for each key. `t` must already be eased by the caller.
+ */
+export declare function prepareNumericTween<T extends object>(target: T, to: Partial<Record<keyof T, number>>): (t: number) => void;
+/**
+ * Like {@link prepareNumericTween}, but bypasses property setters and writes
+ * directly to the backing {@link Signal} cells.
+ *
+ * Skipping the setter avoids the mapper-lookup and `_writeProp` indirection on
+ * every frame step. Only valid for numeric, mapper-free properties — the caller
+ * is responsible for resolving the signal cells and capturing the `from`/`end`
+ * values before calling this.
+ *
+ * - `cells[i]` — the signal cell for the i-th animated property.
+ * - `from[i]`  — start value for that property.
+ * - `end[i]`   — end value for that property.
+ *
+ * The arrays are captured by the returned closure and reused each step, so the
+ * per-frame cost is one `cell.set(number)` per property with no allocation.
+ */
+export declare function prepareNumericCellTween(cells: Signal<number>[], from: number[], end: number[]): (t: number) => void;
+//# sourceMappingURL=prepare.d.ts.map

package/dist/tween/prepare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare.d.ts","sourceRoot":"","sources":["../../src/tween/prepare.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE/C;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,EAChD,MAAM,EAAE,CAAC,EACT,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,GACrC,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAarB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CACnC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,EACvB,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,EAAE,GACd,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAMrB"}

package/dist/tween/prepare.js

@@ -0,0 +1,52 @@
+/**
+ * Snapshots the current numeric property values on `target` for the keys
+ * present in `to`, then returns a lerp callback that writes interpolated values
+ * back each frame.
+ *
+ * The snapshot is taken at call time, so invoke this immediately before the
+ * animation starts (not lazily) to capture the correct `from` state.
+ *
+ * @param target - The object whose properties will be animated.
+ * @param to     - Desired end values keyed by property name. Keys with
+ *                 `undefined` values are ignored.
+ * @returns A function `(t: number) => void` that writes `lerp(from, to, t)`
+ *          for each key. `t` must already be eased by the caller.
+ */
+export function prepareNumericTween(target, to) {
+    const keys = Object.keys(to).filter((k) => to[k] !== undefined);
+    const from = new Array(keys.length);
+    const end = new Array(keys.length);
+    for (let i = 0; i < keys.length; i++) {
+        from[i] = target[keys[i]];
+        end[i] = to[keys[i]];
+    }
+    return (t) => {
+        for (let i = 0; i < keys.length; i++) {
+            target[keys[i]] = from[i] + (end[i] - from[i]) * t;
+        }
+    };
+}
+/**
+ * Like {@link prepareNumericTween}, but bypasses property setters and writes
+ * directly to the backing {@link Signal} cells.
+ *
+ * Skipping the setter avoids the mapper-lookup and `_writeProp` indirection on
+ * every frame step. Only valid for numeric, mapper-free properties — the caller
+ * is responsible for resolving the signal cells and capturing the `from`/`end`
+ * values before calling this.
+ *
+ * - `cells[i]` — the signal cell for the i-th animated property.
+ * - `from[i]`  — start value for that property.
+ * - `end[i]`   — end value for that property.
+ *
+ * The arrays are captured by the returned closure and reused each step, so the
+ * per-frame cost is one `cell.set(number)` per property with no allocation.
+ */
+export function prepareNumericCellTween(cells, from, end) {
+    return (t) => {
+        for (let i = 0; i < cells.length; i++) {
+            cells[i].set(from[i] + (end[i] - from[i]) * t);
+        }
+    };
+}
+//# sourceMappingURL=prepare.js.map

package/dist/tween/prepare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare.js","sourceRoot":"","sources":["../../src/tween/prepare.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,mBAAmB,CAC/B,MAAS,EACT,EAAoC;IAEpC,MAAM,IAAI,GAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;IACjF,MAAM,IAAI,GAAG,IAAI,KAAK,CAAS,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,IAAI,KAAK,CAAS,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,IAAI,CAAC,CAAC,CAAC,GAAI,MAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAW,CAAC;QAC7C,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAW,CAAC;IACnC,CAAC;IACD,OAAO,CAAC,CAAS,EAAE,EAAE;QACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAClC,MAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAChE,CAAC;IACL,CAAC,CAAC;AACN,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,uBAAuB,CACnC,KAAuB,EACvB,IAAc,EACd,GAAa;IAEb,OAAO,CAAC,CAAS,EAAE,EAAE;QACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACnD,CAAC;IACL,CAAC,CAAC;AACN,CAAC"}

package/dist/tween/prepare.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=prepare.test.d.ts.map

package/dist/tween/prepare.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare.test.d.ts","sourceRoot":"","sources":["../../src/tween/prepare.test.ts"],"names":[],"mappings":""}

package/dist/tween/prepare.test.js

@@ -0,0 +1,44 @@
+import { describe, it, expect } from 'vitest';
+import { prepareNumericTween } from '@/tween/prepare';
+describe('prepareNumericTween', () => {
+    it('snapshots the start values and interpolates toward the target', () => {
+        const target = { x: 0, y: 100 };
+        const apply = prepareNumericTween(target, { x: 10, y: 0 });
+        apply(0.5);
+        expect(target.x).toBe(5);
+        expect(target.y).toBe(50);
+    });
+    it('writes the exact target at t=1', () => {
+        const target = { x: 0 };
+        const apply = prepareNumericTween(target, { x: 42 });
+        apply(1);
+        expect(target.x).toBe(42);
+    });
+    it('leaves the start value at t=0', () => {
+        const target = { x: 7 };
+        const apply = prepareNumericTween(target, { x: 100 });
+        apply(0);
+        expect(target.x).toBe(7);
+    });
+    it('captures the start value at preparation time, not call time', () => {
+        const target = { x: 0 };
+        const apply = prepareNumericTween(target, { x: 10 });
+        // Mutating after prepare must not change the interpolation baseline.
+        target.x = 1000;
+        apply(0.5);
+        expect(target.x).toBe(5);
+    });
+    it('only touches keys present in the target spec', () => {
+        const target = { x: 0, y: 0 };
+        const apply = prepareNumericTween(target, { x: 10 });
+        apply(1);
+        expect(target.y).toBe(0);
+    });
+    it('ignores undefined target values', () => {
+        const target = { x: 5 };
+        const apply = prepareNumericTween(target, { x: undefined });
+        apply(1);
+        expect(target.x).toBe(5);
+    });
+});
+//# sourceMappingURL=prepare.test.js.map

package/dist/tween/prepare.test.js.map

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

package/dist/tween/sequence.d.ts

@@ -0,0 +1,19 @@
+import { FrameGenerator } from "../tween/generator";
+/**
+ * Runs a list of animations one after another.
+ *
+ * Each animation must complete before the next one starts. Accepts both
+ * {@link FrameGenerator} instances and any `Iterable<void>` (e.g. an
+ * {@link AnimationBuilder}).
+ *
+ * @param animations - Animations to run in order.
+ *
+ * @example
+ * yield* sequence(
+ *   nodeA.to({ x: 100 }, 0.5),
+ *   wait(0.2),
+ *   nodeB.to({ opacity: 0 }, 0.3),
+ * );
+ */
+export declare function sequence(...animations: (FrameGenerator | Iterable<void>)[]): FrameGenerator;
+//# sourceMappingURL=sequence.d.ts.map

package/dist/tween/sequence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence.d.ts","sourceRoot":"","sources":["../../src/tween/sequence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;;;;;;;;;;;;;;GAeG;AACH,wBAAiB,QAAQ,CACrB,GAAG,UAAU,EAAE,CAAC,cAAc,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,GACnD,cAAc,CAIhB"}