@motion-script/core 0.1.0

package/dist/tween/sequence.js

@@ -0,0 +1,22 @@
+/**
+ * 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 function* sequence(...animations) {
+    for (const animation of animations) {
+        yield* animation;
+    }
+}
+//# sourceMappingURL=sequence.js.map

package/dist/tween/sequence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence.js","sourceRoot":"","sources":["../../src/tween/sequence.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,SAAS,CAAC,CAAC,QAAQ,CACrB,GAAG,UAA+C;IAElD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACjC,KAAK,CAAC,CAAC,SAAgB,CAAC;IAC5B,CAAC;AACL,CAAC"}

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

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

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

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

package/dist/tween/sequence.test.js

@@ -0,0 +1,68 @@
+import { describe, it, expect } from 'vitest';
+import { sequence } from '@/tween/sequence';
+import { tween } from '@/tween/tween';
+import { wait } from '@/tween/wait';
+import { parallel } from '@/tween/parallel';
+function drive(gen, dt = 1 / 60) {
+    let frames = 0;
+    let result = gen.next();
+    while (!result.done) {
+        result = gen.next(dt);
+        if (++frames > 100_000)
+            throw new Error('did not terminate');
+    }
+    return frames;
+}
+describe('sequence', () => {
+    it('returns immediately when given no animations', () => {
+        const gen = sequence();
+        expect(gen.next().done).toBe(true);
+    });
+    it('passes dt to a child tween end-to-end', () => {
+        const values = [];
+        const gen = sequence(tween(0.05, (t) => values.push(t)));
+        drive(gen, 1 / 60);
+        expect(values[values.length - 1]).toBe(1);
+    });
+    it('runs each animation to completion before starting the next', () => {
+        const log = [];
+        const a = (function* () {
+            log.push('a-start');
+            yield;
+            log.push('a-end');
+        })();
+        const b = (function* () {
+            log.push('b-start');
+            yield;
+            log.push('b-end');
+        })();
+        const seq = sequence(a, b);
+        while (!seq.next().done) { }
+        expect(log).toEqual(['a-start', 'a-end', 'b-start', 'b-end']);
+    });
+    it('combined wait times add up roughly correctly', () => {
+        const dt = 1 / 60;
+        const gen = sequence(wait(0.5), wait(0.5));
+        const frames = drive(gen, dt);
+        expect(frames).toBeGreaterThanOrEqual(60);
+        expect(frames).toBeLessThanOrEqual(65);
+    });
+    it('nested sequence inside sequence flattens execution order', () => {
+        const log = [];
+        const inner = sequence((function* () { log.push('i1'); yield; })(), (function* () { log.push('i2'); yield; })());
+        const after = (function* () { log.push('after'); })();
+        const outer = sequence(inner, after);
+        while (!outer.next().done) { }
+        expect(log).toEqual(['i1', 'i2', 'after']);
+    });
+    it('sequence containing parallel waits for parallel to finish', () => {
+        const log = [];
+        const par = parallel((function* () { yield; log.push('p1'); })(), (function* () { yield; yield; log.push('p2'); })());
+        const after = (function* () { log.push('after'); })();
+        const seq = sequence(par, after);
+        while (!seq.next().done) { }
+        expect(log.indexOf('after')).toBeGreaterThan(log.indexOf('p1'));
+        expect(log.indexOf('after')).toBeGreaterThan(log.indexOf('p2'));
+    });
+});
+//# sourceMappingURL=sequence.test.js.map

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

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

package/dist/tween/stepper.d.ts

@@ -0,0 +1,34 @@
+/**
+ * A non-generator animation driver. `advance(dt)` moves the animation forward
+ * by `dt` seconds and returns `true` once it has completed (and applied its
+ * final value). It must be primed at t=0 before the first `advance` so the
+ * starting frame is correct — callers apply the initial value via `seek(0)`.
+ *
+ * This is the flat alternative to a {@link FrameGenerator}: {@link parallel}
+ * can drive a batch of steppers in one tight loop with zero generator resumes
+ * per item, which matters when hundreds of node tweens run simultaneously.
+ */
+export interface TweenStepper {
+    /**
+     * Jump to the value corresponding to `elapsed` seconds from the start.
+     * Call with `0` to prime the stepper before the first {@link advance}.
+     */
+    seek(elapsed: number): void;
+    /**
+     * Advance the animation by `dt` seconds.
+     * @returns `true` when the animation has finished and its final value has
+     *          been applied; `false` if it is still running.
+     */
+    advance(dt: number): boolean;
+}
+/**
+ * Implemented by objects that can produce a {@link TweenStepper} instead of
+ * (or in addition to) a {@link FrameGenerator}. {@link parallel} checks for
+ * this interface and prefers the stepper path when available.
+ */
+export interface Steppable {
+    /** Return a fresh stepper for a single playthrough of this animation. */
+    _stepper(): TweenStepper;
+}
+export declare function isSteppable(x: unknown): x is Steppable;
+//# sourceMappingURL=stepper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stepper.d.ts","sourceRoot":"","sources":["../../src/tween/stepper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAY;IACzB;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;;;;OAIG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACtB,yEAAyE;IACzE,QAAQ,IAAI,YAAY,CAAC;CAC5B;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,SAAS,CAEtD"}

package/dist/tween/stepper.js

@@ -0,0 +1,4 @@
+export function isSteppable(x) {
+    return typeof x?._stepper === "function";
+}
+//# sourceMappingURL=stepper.js.map

package/dist/tween/stepper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepper.js","sourceRoot":"","sources":["../../src/tween/stepper.ts"],"names":[],"mappings":"AAkCA,MAAM,UAAU,WAAW,CAAC,CAAU;IAClC,OAAO,OAAQ,CAAe,EAAE,QAAQ,KAAK,UAAU,CAAC;AAC5D,CAAC"}

package/dist/tween/tests/batched-parallel.test.d.ts

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

package/dist/tween/tests/batched-parallel.test.d.ts.map

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

package/dist/tween/tests/batched-parallel.test.js

@@ -0,0 +1,76 @@
+import { describe, it, expect } from 'vitest';
+import { parallel } from '../parallel';
+import { Rect } from '../../nodes/geometry/rect-node';
+// Drive a generator to completion, sending a fixed dt each frame and snapshotting
+// a value after every frame (the first next() primes / applies t=0).
+function frames(gen, dt, sample) {
+    const out = [];
+    let r = gen.next(); // prime → applies t=0
+    out.push(sample());
+    let safety = 0;
+    while (!r.done) {
+        r = gen.next(dt);
+        out.push(sample());
+        if (++safety > 100_000)
+            throw new Error('did not terminate');
+    }
+    return out;
+}
+describe('parallel – batched stepper path (node.to)', () => {
+    it('interpolates a single node tween linearly', () => {
+        const node = new Rect({ x: 0 });
+        // 1s tween at 0.5s steps → t = 0, 0.5, 1
+        const xs = frames(parallel(node.to({ x: 100 }, 1)), 0.5, () => node.x);
+        expect(xs).toEqual([0, 50, 100]);
+    });
+    it('drives many node tweens in one parallel to their targets', () => {
+        const nodes = Array.from({ length: 50 }, (_, i) => new Rect({ x: i }));
+        const targets = nodes.map((_, i) => i * 10 + 5);
+        const gen = parallel(...nodes.map((n, i) => n.to({ x: targets[i] }, 1)));
+        // Run to completion at 1/60s steps.
+        let r = gen.next();
+        let safety = 0;
+        while (!r.done) {
+            r = gen.next(1 / 60);
+            if (++safety > 100_000)
+                throw new Error('hang');
+        }
+        nodes.forEach((n, i) => expect(n.x).toBeCloseTo(targets[i], 6));
+    });
+    it('animates multiple props of one node together', () => {
+        const node = new Rect({ x: 0, y: 0, rotation: 0 });
+        const gen = parallel(node.to({ x: 10, y: 20, rotation: 90 }, 1));
+        gen.next();
+        gen.next(0.5);
+        expect(node.x).toBeCloseTo(5, 6);
+        expect(node.y).toBeCloseTo(10, 6);
+        expect(node.rotation).toBeCloseTo(45, 6);
+        gen.next(0.5);
+        expect(node.x).toBeCloseTo(10, 6);
+        expect(node.y).toBeCloseTo(20, 6);
+        expect(node.rotation).toBeCloseTo(90, 6);
+    });
+    it('chained .to() steps run sequentially within the batch', () => {
+        const node = new Rect({ x: 0 });
+        const gen = parallel(node.to({ x: 10 }, 1).to({ x: 20 }, 1));
+        gen.next(); // t=0 of step 1
+        expect(node.x).toBeCloseTo(0, 6);
+        gen.next(1); // step 1 finishes (x=10), step 2 primed at t=0
+        expect(node.x).toBeCloseTo(10, 6);
+        gen.next(0.5); // halfway through step 2
+        expect(node.x).toBeCloseTo(15, 6);
+        gen.next(0.5); // step 2 finishes
+        expect(node.x).toBeCloseTo(20, 6);
+    });
+    it('matches the generator (_toGen) path frame-for-frame', () => {
+        const dt = 1 / 60;
+        const a = new Rect({ x: 0 });
+        const b = new Rect({ x: 0 });
+        // Batched path via parallel(node.to(...))
+        const batched = frames(parallel(a.to({ x: 100 }, 0.37)), dt, () => a.x);
+        // Generator path: drive _toGen directly.
+        const direct = frames(b._toGen({ x: 100 }, 0.37), dt, () => b.x);
+        expect(batched).toEqual(direct);
+    });
+});
+//# sourceMappingURL=batched-parallel.test.js.map

package/dist/tween/tests/batched-parallel.test.js.map

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

package/dist/tween/tests/parallel.test.d.ts

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

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

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

package/dist/tween/tests/parallel.test.js

@@ -0,0 +1,129 @@
+import { describe, it, expect } from 'vitest';
+import { parallel } from '../parallel';
+import { tween } from '../tween';
+import { wait } from '../wait';
+import { sequence } from '../sequence';
+// Drive a generator to completion, sending dt each frame.
+function driveWithDt(gen, dt) {
+    let result = gen.next();
+    let safety = 0;
+    while (!result.done) {
+        result = gen.next(dt);
+        if (++safety > 100_000)
+            throw new Error('generator did not terminate');
+    }
+}
+describe('parallel', () => {
+    it('returns immediately when given no animations', () => {
+        const gen = parallel();
+        const result = gen.next();
+        expect(result.done).toBe(true);
+    });
+    it('runs a single animation to completion', () => {
+        const calls = [];
+        const gen = parallel(tween(0.1, (t) => calls.push(t)));
+        driveWithDt(gen, 1 / 60);
+        expect(calls[calls.length - 1]).toBe(1);
+    });
+    it('advances all animations on every frame', () => {
+        const log = [];
+        const a = (function* () {
+            log.push('a0');
+            yield;
+            log.push('a1');
+            yield;
+        })();
+        const b = (function* () {
+            log.push('b0');
+            yield;
+        })();
+        const p = parallel(a, b);
+        while (!p.next().done) { }
+        expect(log).toEqual(['a0', 'b0', 'a1']);
+    });
+    it('completes only after the longest animation finishes', () => {
+        const dt = 1 / 60;
+        let shortDone = false;
+        let longDone = false;
+        const short = (function* () {
+            yield* wait(0.1);
+            shortDone = true;
+        })();
+        const long = (function* () {
+            yield* wait(0.5);
+            longDone = true;
+        })();
+        const p = parallel(short, long);
+        driveWithDt(p, dt);
+        expect(shortDone).toBe(true);
+        expect(longDone).toBe(true);
+    });
+    it('continues after one of two animations finishes', () => {
+        const log = [];
+        const fast = (function* () {
+            log.push('fast-frame0');
+            yield;
+            log.push('fast-done');
+        })();
+        const slow = (function* () {
+            log.push('slow-frame0');
+            yield;
+            log.push('slow-frame1');
+            yield;
+            log.push('slow-done');
+        })();
+        const p = parallel(fast, slow);
+        while (!p.next().done) { }
+        expect(log).toContain('fast-done');
+        expect(log).toContain('slow-done');
+        // slow runs at least 2 frames after fast is done
+        expect(log.indexOf('slow-done')).toBeGreaterThan(log.indexOf('fast-done'));
+    });
+    it('forwards dt to each child animation', () => {
+        const dtReceived = [];
+        const tracker = (function* () {
+            for (let i = 0; i < 3; i++) {
+                const received = yield;
+                if (received !== undefined)
+                    dtReceived.push(received);
+            }
+        })();
+        const p = parallel(tracker);
+        p.next(); // prime — no dt yet
+        p.next(0.016);
+        p.next(0.033);
+        p.next(0.050);
+        expect(dtReceived).toEqual([0.016, 0.033, 0.050]);
+    });
+    it('works with three simultaneous tweens', () => {
+        const results = { x: 0, y: 0, z: 0 };
+        const p = parallel(tween(0.2, (t) => { results.x = t; }), tween(0.4, (t) => { results.y = t; }), tween(0.1, (t) => { results.z = t; }));
+        driveWithDt(p, 1 / 60);
+        expect(results.x).toBe(1);
+        expect(results.y).toBe(1);
+        expect(results.z).toBe(1);
+    });
+    it('nested parallel inside sequence runs correctly', () => {
+        const log = [];
+        const inner = parallel((function* () { log.push('p-a0'); yield; log.push('p-a1'); })(), (function* () { log.push('p-b0'); yield; })());
+        const after = (function* () { log.push('after'); })();
+        const seq = sequence(inner, after);
+        while (!seq.next().done) { }
+        // 'after' must come after both parallel arms finish
+        const afterIdx = log.indexOf('after');
+        expect(afterIdx).toBeGreaterThan(log.indexOf('p-a1'));
+        expect(afterIdx).toBeGreaterThan(log.indexOf('p-b0'));
+    });
+    it('parallel nested inside parallel all complete', () => {
+        const done = [];
+        const a = (function* () { yield; done.push('a'); })();
+        const b = (function* () { yield; yield; done.push('b'); })();
+        const c = (function* () { yield; done.push('c'); })();
+        const outer = parallel(parallel(a, b), c);
+        while (!outer.next().done) { }
+        expect(done).toContain('a');
+        expect(done).toContain('b');
+        expect(done).toContain('c');
+    });
+});
+//# sourceMappingURL=parallel.test.js.map

package/dist/tween/tests/parallel.test.js.map

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

package/dist/tween/tests/realtime.test.d.ts

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

package/dist/tween/tests/realtime.test.d.ts.map

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

package/dist/tween/tests/realtime.test.js

@@ -0,0 +1,76 @@
+import { describe, it, expect } from 'vitest';
+import { sequence } from '../sequence';
+import { parallel } from '../parallel';
+describe('realtime generators', () => {
+    // it('tween calls callback across frames and finishes at 1', () => {
+    //     const calls: number[] = [];
+    //     const duration = 0.1; // seconds -> gives several frames at 60 FPS
+    //     const gen = tween(duration, (t) => calls.push(t));
+    //     // Drive the generator to completion
+    //     while (!gen.next().done) { }
+    //     // There should be at least two calls (start..final)
+    //     expect(calls.length).toBeGreaterThanOrEqual(2);
+    //     // First call should be 0 (frame 0)
+    //     expect(calls[0]).toBe(0);
+    //     // Final call should be 1
+    //     expect(calls[calls.length - 1]).toBe(1);
+    //     // Values should be non-decreasing
+    //     for (let i = 1; i < calls.length; i++) {
+    //         expect(calls[i]).toBeGreaterThanOrEqual(calls[i - 1]);
+    //     }
+    // });
+    it('sequence runs animations in order', () => {
+        const calls = [];
+        const a = (function* () {
+            calls.push('a0');
+            yield;
+            calls.push('a1');
+            yield;
+        })();
+        const b = (function* () {
+            calls.push('b0');
+            yield;
+        })();
+        const seq = sequence(a, b);
+        while (!seq.next().done) { }
+        expect(calls).toEqual(['a0', 'a1', 'b0']);
+    });
+    it('parallel advances animations together and completes when all done', () => {
+        const calls = [];
+        const a = (function* () {
+            calls.push('a0');
+            yield;
+            calls.push('a1');
+            yield;
+        })();
+        const b = (function* () {
+            calls.push('b0');
+            yield;
+        })();
+        const p = parallel(a, b);
+        while (!p.next().done) { }
+        // Expect interleaved execution: a0, b0, a1
+        expect(calls).toEqual(['a0', 'b0', 'a1']);
+    });
+    // it('any delegates to parallel (same behavior)', () => {
+    //     const calls1: string[] = [];
+    //     const calls2: string[] = [];
+    //     const makeA = () => (function* () {
+    //         calls1.push('a0');
+    //         yield;
+    //         calls1.push('a1');
+    //         yield;
+    //     })();
+    //     const makeB = () => (function* () {
+    //         calls1.push('b0');
+    //         yield;
+    //     })();
+    //     const a1 = (function* () { calls2.push('a0'); yield; calls2.push('a1'); yield; })();
+    //     const b1 = (function* () { calls2.push('b0'); yield; })();
+    //     const parGen = parallel(makeA(), makeB());
+    //     while (!parGen.next().done) { }
+    //     expect(calls2).toEqual(['a0', 'b0', 'a1']);
+    //     expect(calls1).toEqual(['a0', 'b0', 'a1']);
+    // });
+});
+//# sourceMappingURL=realtime.test.js.map

package/dist/tween/tests/realtime.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.test.js","sourceRoot":"","sources":["../../../src/tween/tests/realtime.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IAEjC,qEAAqE;IACrE,kCAAkC;IAClC,yEAAyE;IAEzE,yDAAyD;IAEzD,2CAA2C;IAC3C,mCAAmC;IAEnC,2DAA2D;IAC3D,sDAAsD;IACtD,0CAA0C;IAC1C,gCAAgC;IAChC,gCAAgC;IAChC,+CAA+C;IAC/C,yCAAyC;IACzC,+CAA+C;IAC/C,iEAAiE;IACjE,QAAQ;IACR,MAAM;IAEN,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QACzC,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAChB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,KAAK,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,KAAK,CAAC;QACV,CAAC,CAAC,EAAE,CAAC;QAEL,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAChB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,KAAK,CAAC;QACV,CAAC,CAAC,EAAE,CAAC;QAEL,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAE5B,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QACzE,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAChB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,KAAK,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,KAAK,CAAC;QACV,CAAC,CAAC,EAAE,CAAC;QAEL,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAChB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,KAAK,CAAC;QACV,CAAC,CAAC,EAAE,CAAC;QAEL,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACzB,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAE1B,2CAA2C;QAC3C,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,0DAA0D;IAC1D,mCAAmC;IACnC,mCAAmC;IAEnC,0CAA0C;IAC1C,6BAA6B;IAC7B,iBAAiB;IACjB,6BAA6B;IAC7B,iBAAiB;IACjB,YAAY;IAEZ,0CAA0C;IAC1C,6BAA6B;IAC7B,iBAAiB;IACjB,YAAY;IAEZ,2FAA2F;IAC3F,iEAAiE;IAEjE,iDAAiD;IAEjD,sCAAsC;IAEtC,kDAAkD;IAClD,kDAAkD;IAClD,MAAM;AAEV,CAAC,CAAC,CAAC"}

package/dist/tween/tween.d.ts

@@ -0,0 +1,18 @@
+import { FrameGenerator } from "../tween/generator";
+/**
+ * Core animation primitive. Runs `callback` every frame for `duration` seconds,
+ * passing a normalized progress value `t` in [0, 1].
+ *
+ * The callback receives a pre-eased `t` — apply your easing before calling
+ * (typically done by {@link AnimationBuilder} / node helpers). The generator
+ * guarantees a final call with `t = 1` so the end state is always applied
+ * cleanly, even if the last frame overshoots.
+ *
+ * @param duration - Length of the animation in seconds.
+ * @param callback - Called each frame with the current normalized progress.
+ *
+ * @example
+ * yield* tween(0.5, t => { node.opacity = t; });
+ */
+export declare function tween(duration: number, callback: (t: number) => void): FrameGenerator;
+//# sourceMappingURL=tween.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tween.d.ts","sourceRoot":"","sources":["../../src/tween/tween.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;;;;;;;;;;;;;GAcG;AACH,wBAAiB,KAAK,CAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,GAC9B,cAAc,CAchB"}

package/dist/tween/tween.js

@@ -0,0 +1,28 @@
+/**
+ * Core animation primitive. Runs `callback` every frame for `duration` seconds,
+ * passing a normalized progress value `t` in [0, 1].
+ *
+ * The callback receives a pre-eased `t` — apply your easing before calling
+ * (typically done by {@link AnimationBuilder} / node helpers). The generator
+ * guarantees a final call with `t = 1` so the end state is always applied
+ * cleanly, even if the last frame overshoots.
+ *
+ * @param duration - Length of the animation in seconds.
+ * @param callback - Called each frame with the current normalized progress.
+ *
+ * @example
+ * yield* tween(0.5, t => { node.opacity = t; });
+ */
+export function* tween(duration, callback) {
+    let elapsed = 0;
+    while (elapsed < duration) {
+        const t = elapsed / duration;
+        callback(t);
+        const dt = yield;
+        elapsed += dt;
+    }
+    // Ensure the tween ends exactly at 1
+    callback(1);
+    return;
+}
+//# sourceMappingURL=tween.js.map

package/dist/tween/tween.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tween.js","sourceRoot":"","sources":["../../src/tween/tween.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,MAAM,SAAS,CAAC,CAAC,KAAK,CAClB,QAAgB,EAChB,QAA6B;IAE7B,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,OAAO,OAAO,GAAG,QAAQ,EAAE,CAAC;QACxB,MAAM,CAAC,GAAG,OAAO,GAAG,QAAQ,CAAC;QAE7B,QAAQ,CAAC,CAAC,CAAC,CAAC;QACZ,MAAM,EAAE,GAAG,KAAK,CAAC;QACjB,OAAO,IAAI,EAAE,CAAC;IAClB,CAAC;IAED,qCAAqC;IACrC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEZ,OAAO;AACX,CAAC"}

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

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

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

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

package/dist/tween/tween.test.js

@@ -0,0 +1,38 @@
+import { describe, it, expect } from 'vitest';
+import { tween } from '@/tween/tween';
+/** Drive a tween generator with a fixed-size frame delta until it completes. */
+function drive(duration, dt) {
+    const calls = [];
+    const gen = tween(duration, (t) => calls.push(t));
+    let res = gen.next(); // prime to the first yield
+    while (!res.done) {
+        res = gen.next(dt);
+    }
+    return calls;
+}
+describe('tween', () => {
+    it('invokes the callback with t=0 on the first frame', () => {
+        const calls = drive(1, 0.25);
+        expect(calls[0]).toBe(0);
+    });
+    it('always finishes exactly at t=1', () => {
+        const calls = drive(1, 0.3);
+        expect(calls[calls.length - 1]).toBe(1);
+    });
+    it('produces non-decreasing t values', () => {
+        const calls = drive(1, 0.1);
+        for (let i = 1; i < calls.length; i++) {
+            expect(calls[i]).toBeGreaterThanOrEqual(calls[i - 1]);
+        }
+    });
+    it('reports progress as elapsed/duration before the final frame', () => {
+        // duration 1, dt 0.25 → intermediate ts are 0, 0.25, 0.5, 0.75, then 1.
+        const calls = drive(1, 0.25);
+        expect(calls).toEqual([0, 0.25, 0.5, 0.75, 1]);
+    });
+    it('still emits the final t=1 when the first frame already exceeds duration', () => {
+        const calls = drive(0.1, 1);
+        expect(calls).toEqual([0, 1]);
+    });
+});
+//# sourceMappingURL=tween.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tween.test.js","sourceRoot":"","sources":["../../src/tween/tween.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEtC,gFAAgF;AAChF,SAAS,KAAK,CAAC,QAAgB,EAAE,EAAU;IACvC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,IAAI,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,2BAA2B;IACjD,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACf,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE;IACnB,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QACxD,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QAC7B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACtC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC5B,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QACxC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC1D,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACnE,wEAAwE;QACxE,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QAC7B,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QAC/E,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC5B,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/tween/wait.d.ts

@@ -0,0 +1,19 @@
+import { FrameGenerator } from "../tween/generator";
+/**
+ * Pauses the animation timeline for a fixed number of seconds.
+ *
+ * Yields control back to the runtime each frame until the elapsed time reaches
+ * `seconds`, then returns. Use inside {@link sequence} to add gaps between
+ * animations, or inside {@link parallel} to delay a branch.
+ *
+ * @param seconds - How long to wait, in seconds.
+ *
+ * @example
+ * yield* sequence(
+ *   node.to({ opacity: 1 }, 0.3),
+ *   wait(0.5),
+ *   node.to({ opacity: 0 }, 0.3),
+ * );
+ */
+export declare function wait(seconds: number): FrameGenerator;
+//# sourceMappingURL=wait.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wait.d.ts","sourceRoot":"","sources":["../../src/tween/wait.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;;;;;;;;;;;;;;GAeG;AACH,wBAAiB,IAAI,CACjB,OAAO,EAAE,MAAM,GAChB,cAAc,CAQhB"}