@motion-script/core 0.1.0

package/dist/signals/signal.js

@@ -0,0 +1,162 @@
+/**
+ * Reactive cell that stores a value and tracks dependencies.
+ *
+ * A cell can be a plain value (set/get) or bound to a computation fn.
+ * Reads during a bound fn's execution are recorded as dependencies; when any
+ * dep is set, the cell is marked dirty and recomputes lazily on next read.
+ *
+ * Subscribers fire only when the cell's value actually changes. Bound cells
+ * without listeners stay lazy — they recompute on the next read. Bound cells
+ * with listeners recompute eagerly when dirtied so subscribers can be notified
+ * with a fresh value.
+ */
+export class Signal {
+    _value;
+    _fn = null;
+    _dirty = false;
+    // Bound cells that read this one (i.e. downstream dependents).
+    _subs = new Set();
+    // Cells this one reads (only populated while bound).
+    _deps = new Set();
+    // External subscribers (not part of the cell graph).
+    _listeners = new Set();
+    constructor(initial) {
+        if (typeof initial === "function") {
+            this._fn = initial;
+            this._dirty = true;
+            this._value = undefined;
+        }
+        else {
+            this._value = initial;
+        }
+    }
+    get() {
+        if (currentReader && currentReader !== this) {
+            this._subs.add(currentReader);
+            currentReader._deps.add(this);
+        }
+        if (this._fn && this._dirty)
+            this._recompute();
+        return this._value;
+    }
+    peek() {
+        if (this._fn && this._dirty)
+            this._recompute();
+        return this._value;
+    }
+    set(value) {
+        if (this._fn)
+            this._detach();
+        if (Object.is(this._value, value))
+            return;
+        const prev = this._value;
+        this._value = value;
+        this._propagateDirty();
+        this._notify(prev);
+    }
+    bind(fn) {
+        this._detach();
+        this._fn = fn;
+        this._dirty = true;
+        this._propagateDirty();
+        if (this._listeners.size > 0) {
+            const prev = this._value;
+            this._recompute();
+            if (!Object.is(prev, this._value))
+                this._notify(prev);
+        }
+    }
+    unbind() {
+        this._detach();
+    }
+    /**
+     * Permanently severs all graph edges and releases closures.
+     *
+     * - Upstream: removes this cell from every dep's `_subs` (same as unbind).
+     * - Downstream: removes this cell from every subscriber's `_deps` so they
+     *   stop tracking it, then clears `_subs`.
+     * - External: clears all `_listeners` so subscriber callbacks are released.
+     *
+     * After `dispose()` the cell is inert. Do not read or write it.
+     */
+    dispose() {
+        // Sever upstream (this cell → deps).
+        this._detach();
+        // Sever downstream (deps → this cell tracked via their _deps sets).
+        for (const sub of this._subs)
+            sub._deps.delete(this);
+        this._subs.clear();
+        // Release external subscriber callbacks.
+        this._listeners.clear();
+        // Drop any reference held by the value slot to aid GC.
+        this._value = undefined;
+    }
+    isBound() {
+        return this._fn !== null;
+    }
+    subscribe(fn) {
+        this._listeners.add(fn);
+        return () => {
+            this._listeners.delete(fn);
+        };
+    }
+    _notify(prev) {
+        if (this._listeners.size === 0)
+            return;
+        if (Object.is(prev, this._value))
+            return;
+        for (const sub of this._listeners)
+            sub(this._value);
+    }
+    _detach() {
+        if (!this._fn)
+            return;
+        this._fn = null;
+        this._dirty = false;
+        for (const d of this._deps)
+            d._subs.delete(this);
+        this._deps.clear();
+    }
+    _recompute() {
+        for (const d of this._deps)
+            d._subs.delete(this);
+        this._deps.clear();
+        const prev = currentReader;
+        currentReader = this;
+        try {
+            this._value = this._fn();
+            this._dirty = false;
+        }
+        finally {
+            currentReader = prev;
+        }
+    }
+    _propagateDirty() {
+        const stack = [];
+        for (const sub of this._subs)
+            stack.push(sub);
+        while (stack.length > 0) {
+            const s = stack.pop();
+            if (s._dirty)
+                continue;
+            s._dirty = true;
+            for (const next of s._subs)
+                stack.push(next);
+            // Eagerly recompute listened-to derived cells so subscribers fire
+            // with a fresh value. Lazy cells just stay dirty until pulled.
+            if (s._listeners.size > 0) {
+                const prevVal = s._value;
+                s._recompute();
+                if (!Object.is(prevVal, s._value)) {
+                    for (const fn of s._listeners)
+                        fn(s._value);
+                }
+            }
+        }
+    }
+}
+let currentReader = null;
+export function isTracking() {
+    return currentReader !== null;
+}
+//# sourceMappingURL=signal.js.map

package/dist/signals/signal.js.map

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

package/dist/signals/signal.test.d.ts

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

package/dist/signals/signal.test.d.ts.map

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

package/dist/signals/signal.test.js

@@ -0,0 +1,192 @@
+import { describe, it, expect, vi } from 'vitest';
+import { createSignal } from '@/signals/create';
+import { Signal } from '@/signals/signal';
+import { linear } from '@/tween/ease/constants';
+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('generator did not terminate');
+    }
+    return frames;
+}
+describe('createSignal – basic read/write', () => {
+    it('returns the initial value via get()', () => {
+        const s = createSignal(10);
+        expect(s.get()).toBe(10);
+    });
+    it('zero-arg call is sugar for get()', () => {
+        const s = createSignal(42);
+        expect(s()).toBe(42);
+    });
+    it('set() updates the value', () => {
+        const s = createSignal(0);
+        s.set(5);
+        expect(s.get()).toBe(5);
+    });
+    it('single-arg call writes the value', () => {
+        const s = createSignal(0);
+        s(7);
+        expect(s.get()).toBe(7);
+    });
+    it('updater function receives previous value', () => {
+        const s = createSignal(10);
+        s.set((prev) => prev + 5);
+        expect(s.get()).toBe(15);
+    });
+    it('updater via single-arg call works the same', () => {
+        const s = createSignal(10);
+        s((prev) => prev * 2);
+        expect(s.get()).toBe(20);
+    });
+});
+describe('createSignal – reactive binding', () => {
+    it('binds to a zero-arity function and tracks dependencies', () => {
+        const source = createSignal(1);
+        const derived = createSignal(0);
+        derived.set(() => source.get() * 10);
+        expect(derived.get()).toBe(10);
+        source.set(3);
+        expect(derived.get()).toBe(30);
+    });
+    it('chain of derived signals propagates updates', () => {
+        const a = createSignal(1);
+        const b = createSignal(0);
+        const c = createSignal(0);
+        b.set(() => a.get() + 1);
+        c.set(() => b.get() + 1);
+        expect(c.get()).toBe(3);
+        a.set(10);
+        expect(c.get()).toBe(12);
+    });
+    it('plain value initializer is non-reactive', () => {
+        const source = createSignal(5);
+        const independent = createSignal(source.get());
+        source.set(99);
+        expect(independent.get()).toBe(5);
+    });
+    it('passing an existing signal returns the same signal', () => {
+        const a = createSignal(1);
+        const b = createSignal(a);
+        expect(b).toBe(a);
+    });
+});
+describe('createSignal – subscribe', () => {
+    it('fires the subscriber when the value changes', () => {
+        const s = createSignal(0);
+        const fn = vi.fn();
+        s.subscribe(fn);
+        s.set(1);
+        expect(fn).toHaveBeenCalledWith(1);
+    });
+    it('does not fire for set with identical value', () => {
+        const s = createSignal(5);
+        const fn = vi.fn();
+        s.subscribe(fn);
+        s.set(5);
+        expect(fn).not.toHaveBeenCalled();
+    });
+    it('unsubscribe stops notifications', () => {
+        const s = createSignal(0);
+        const fn = vi.fn();
+        const off = s.subscribe(fn);
+        off();
+        s.set(99);
+        expect(fn).not.toHaveBeenCalled();
+    });
+    it('subscriber sees recomputed value when an upstream signal changes', () => {
+        const source = createSignal(1);
+        const derived = createSignal(0);
+        derived.set(() => source.get() * 2);
+        const fn = vi.fn();
+        derived.subscribe(fn);
+        // Ensure first compute happened
+        derived.get();
+        source.set(5);
+        // The signal cell propagates eagerly to listened-to derived cells.
+        expect(fn).toHaveBeenLastCalledWith(10);
+    });
+});
+describe('createSignal – tween', () => {
+    it('returns a FrameGenerator from tween()', () => {
+        const s = createSignal(0);
+        const gen = s.tween(10, 0.1, linear);
+        expect(typeof gen.next).toBe('function');
+    });
+    it('arity ≥ 2 with numeric duration via call form delegates to tween', () => {
+        const s = createSignal(0);
+        const gen = s(10, 0.1, linear);
+        expect(typeof gen.next).toBe('function');
+    });
+    it('tween advances numeric value to target by the end', () => {
+        const s = createSignal(0);
+        drive(s.tween(100, 0.2, linear));
+        expect(s.get()).toBe(100);
+    });
+    it('intermediate value is between from and to', () => {
+        const s = createSignal(0);
+        const gen = s.tween(100, 0.5, linear);
+        gen.next();
+        gen.next(0.1);
+        expect(s.get()).toBeGreaterThan(0);
+        expect(s.get()).toBeLessThan(100);
+    });
+    it('applies easing function', () => {
+        const s = createSignal(0);
+        const seen = [];
+        const easing = (t) => {
+            seen.push(t);
+            return t;
+        };
+        drive(s.tween(10, 0.05, easing));
+        expect(seen.length).toBeGreaterThan(0);
+        expect(s.get()).toBe(10);
+    });
+    it('uses defaultLerp when provided to createSignal', () => {
+        const lerp = (from, to, t) => ({
+            x: from.x + (to.x - from.x) * t,
+        });
+        const s = createSignal({ x: 0 }, lerp);
+        drive(s.tween({ x: 100 }, 0.1, linear));
+        expect(s.get().x).toBe(100);
+    });
+    it('custom lerp overrides default for a single tween', () => {
+        const s = createSignal(0);
+        const captured = [];
+        const lerp = (from, to, t) => {
+            captured.push(t);
+            return from + (to - from) * t;
+        };
+        drive(s.tween(10, 0.05, linear, lerp));
+        expect(captured.length).toBeGreaterThan(0);
+        expect(s.get()).toBe(10);
+    });
+    it('non-numeric values without lerp snap at t=1', () => {
+        const s = createSignal('a');
+        drive(s.tween('b', 0.05, linear));
+        expect(s.get()).toBe('b');
+    });
+    it('lerpNullable handles initial null', () => {
+        const s = createSignal(null);
+        drive(s.tween(50, 0.1, linear));
+        expect(s.get()).toBe(50);
+    });
+    it('lerpNullable handles null target (returns from)', () => {
+        const s = createSignal(10);
+        drive(s.tween(null, 0.1, linear));
+        expect(s.get()).toBe(10);
+    });
+});
+describe('createSignal – interaction with Signal', () => {
+    it('binding the underlying cell still drives the signal', () => {
+        const upstream = new Signal(7);
+        const s = createSignal(0);
+        s.set(() => upstream.get() + 1);
+        expect(s.get()).toBe(8);
+        upstream.set(20);
+        expect(s.get()).toBe(21);
+    });
+});
+//# sourceMappingURL=signal.test.js.map

package/dist/signals/signal.test.js.map

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

package/dist/signals/subscriber.d.ts

@@ -0,0 +1,5 @@
+/** Called whenever a signal emits a new value. */
+export type Subscriber<T> = (value: T) => void;
+/** Disposes a subscription created by a signal's `subscribe` method. Safe to call multiple times. */
+export type Unsubscribe = () => void;
+//# sourceMappingURL=subscriber.d.ts.map

package/dist/signals/subscriber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriber.d.ts","sourceRoot":"","sources":["../../src/signals/subscriber.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;AAE/C,qGAAqG;AACrG,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC"}

package/dist/signals/subscriber.js

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

package/dist/signals/subscriber.js.map

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

package/dist/tween/animation-builder.d.ts

@@ -0,0 +1,74 @@
+import { FrameGenerator } from "../tween/generator";
+import { EaseFunction } from "../tween/ease/type";
+import { Steppable, TweenStepper } from "../tween/stepper";
+/** A single step in an {@link AnimationBuilder} chain. */
+type ToStep<P> = {
+    to: Partial<P>;
+    duration: number;
+    easing?: EaseFunction;
+};
+/**
+ * Interface that a node must implement to be driven by {@link AnimationBuilder}.
+ *
+ * - `_toGen` — produces a {@link FrameGenerator} for one tween step (used by
+ *   the iterator path: `sequence`, manual `yield*`).
+ * - `_prepareStep` — produces a {@link TweenStepper} for one tween step (used
+ *   by the fast path inside {@link parallel}).
+ */
+export interface AnimationTarget<P> {
+    _toGen(props: Partial<P>, duration: number, easing?: EaseFunction): FrameGenerator;
+    _prepareStep(props: Partial<P>, duration: number, easing?: EaseFunction): TweenStepper;
+}
+/**
+ * A chainable, replayable animation description for a single node.
+ *
+ * Created by calling `node.to(props, duration, easing?)` on any animatable
+ * node. Additional steps are appended with {@link to}, and the whole chain can
+ * be passed directly to {@link sequence} or {@link parallel}.
+ *
+ * Implements both `Iterable<void>` (drives steps as chained generators) and
+ * {@link Steppable} (drives steps as flat {@link TweenStepper}s for the
+ * {@link parallel} fast-path).
+ *
+ * @example
+ * // Animate a node to x=100 then x=0
+ * const anim = node.to({ x: 100 }, 0.5).to({ x: 0 }, 0.5);
+ * yield* sequence(anim);
+ *
+ * // Run alongside another animation
+ * yield* parallel(anim, otherNode.to({ opacity: 0 }, 1));
+ */
+export declare class AnimationBuilder<P> implements Steppable {
+    private steps;
+    private node;
+    constructor(node: AnimationTarget<P>, first: ToStep<P>);
+    /**
+     * Append another tween step to this animation chain.
+     *
+     * The step starts from whatever property values the node has when the
+     * previous step finishes — snapshots are taken lazily at step boundaries.
+     *
+     * @param props    - Target property values for this step.
+     * @param duration - Duration of this step in seconds.
+     * @param easing   - Optional easing function (identity / linear if omitted).
+     * @returns `this` for further chaining.
+     */
+    to(props: Partial<P>, duration: number, easing?: EaseFunction): this;
+    /**
+     * Flat driver over this builder's steps — no generators. Steps run in
+     * sequence; each is prepared when the previous one finishes (so its `from`
+     * snapshot is taken at the right time, matching the generator's `yield*`
+     * chaining). {@link parallel} uses this to drive a batch of tweens in one
+     * loop with zero generator resumes per item.
+     */
+    _stepper(): TweenStepper;
+    /**
+     * Iterator path: yields each step as a chained generator.
+     *
+     * Used when the builder is passed to `yield*` directly or given to
+     * {@link sequence}. {@link parallel} prefers {@link _stepper} instead.
+     */
+    [Symbol.iterator](): Iterator<void, void, number>;
+}
+export {};
+//# sourceMappingURL=animation-builder.d.ts.map

package/dist/tween/animation-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation-builder.d.ts","sourceRoot":"","sources":["../../src/tween/animation-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE1D,0DAA0D;AAC1D,KAAK,MAAM,CAAC,CAAC,IAAI;IAAE,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,YAAY,CAAA;CAAE,CAAC;AAE7E;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAC9B,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,cAAc,CAAC;IACnF,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,YAAY,CAAC;CAC1F;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,gBAAgB,CAAC,CAAC,CAAE,YAAW,SAAS;IACjD,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,IAAI,CAAqB;gBAG7B,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,EACxB,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAMpB;;;;;;;;;;OAUG;IACH,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI;IAKpE;;;;;;OAMG;IACH,QAAQ,IAAI,YAAY;IA+BxB;;;;;OAKG;IACH,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC;CAYpD"}

package/dist/tween/animation-builder.js

@@ -0,0 +1,99 @@
+/**
+ * A chainable, replayable animation description for a single node.
+ *
+ * Created by calling `node.to(props, duration, easing?)` on any animatable
+ * node. Additional steps are appended with {@link to}, and the whole chain can
+ * be passed directly to {@link sequence} or {@link parallel}.
+ *
+ * Implements both `Iterable<void>` (drives steps as chained generators) and
+ * {@link Steppable} (drives steps as flat {@link TweenStepper}s for the
+ * {@link parallel} fast-path).
+ *
+ * @example
+ * // Animate a node to x=100 then x=0
+ * const anim = node.to({ x: 100 }, 0.5).to({ x: 0 }, 0.5);
+ * yield* sequence(anim);
+ *
+ * // Run alongside another animation
+ * yield* parallel(anim, otherNode.to({ opacity: 0 }, 1));
+ */
+export class AnimationBuilder {
+    steps = [];
+    node;
+    constructor(node, first) {
+        this.node = node;
+        this.steps.push(first);
+    }
+    /**
+     * Append another tween step to this animation chain.
+     *
+     * The step starts from whatever property values the node has when the
+     * previous step finishes — snapshots are taken lazily at step boundaries.
+     *
+     * @param props    - Target property values for this step.
+     * @param duration - Duration of this step in seconds.
+     * @param easing   - Optional easing function (identity / linear if omitted).
+     * @returns `this` for further chaining.
+     */
+    to(props, duration, easing) {
+        this.steps.push({ to: props, duration, easing });
+        return this;
+    }
+    /**
+     * Flat driver over this builder's steps — no generators. Steps run in
+     * sequence; each is prepared when the previous one finishes (so its `from`
+     * snapshot is taken at the right time, matching the generator's `yield*`
+     * chaining). {@link parallel} uses this to drive a batch of tweens in one
+     * loop with zero generator resumes per item.
+     */
+    _stepper() {
+        const steps = this.steps;
+        const node = this.node;
+        let index = 0;
+        let current = null;
+        const prime = () => {
+            if (index >= steps.length)
+                return null;
+            const s = steps[index];
+            current = node._prepareStep(s.to, s.duration, s.easing);
+            current.seek(0);
+            return current;
+        };
+        return {
+            seek: () => { if (!current)
+                prime(); },
+            advance: (dt) => {
+                if (!current && prime() === null)
+                    return true;
+                if (!current.advance(dt))
+                    return false;
+                // Current step finished on this frame. Apply its final value
+                // (already done by advance), then start the next step at t=0 in
+                // the same frame — mirrors `yield*` pulling the next generator,
+                // whose seek(0) runs before its first yield.
+                index++;
+                current = null;
+                if (prime() === null)
+                    return true;
+                return false;
+            },
+        };
+    }
+    /**
+     * Iterator path: yields each step as a chained generator.
+     *
+     * Used when the builder is passed to `yield*` directly or given to
+     * {@link sequence}. {@link parallel} prefers {@link _stepper} instead.
+     */
+    [Symbol.iterator]() {
+        const steps = this.steps;
+        const node = this.node;
+        function* run() {
+            for (const step of steps) {
+                yield* node._toGen(step.to, step.duration, step.easing);
+            }
+        }
+        return run();
+    }
+}
+//# sourceMappingURL=animation-builder.js.map

package/dist/tween/animation-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation-builder.js","sourceRoot":"","sources":["../../src/tween/animation-builder.ts"],"names":[],"mappings":"AAoBA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,gBAAgB;IACjB,KAAK,GAAgB,EAAE,CAAC;IACxB,IAAI,CAAqB;IAEjC,YACI,IAAwB,EACxB,KAAgB;QAEhB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED;;;;;;;;;;OAUG;IACH,EAAE,CAAC,KAAiB,EAAE,QAAgB,EAAE,MAAqB;QACzD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;;OAMG;IACH,QAAQ;QACJ,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,OAAO,GAAwB,IAAI,CAAC;QAExC,MAAM,KAAK,GAAG,GAAwB,EAAE;YACpC,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM;gBAAE,OAAO,IAAI,CAAC;YACvC,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;YACvB,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;YACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChB,OAAO,OAAO,CAAC;QACnB,CAAC,CAAC;QAEF,OAAO;YACH,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO;gBAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YACtC,OAAO,EAAE,CAAC,EAAU,EAAW,EAAE;gBAC7B,IAAI,CAAC,OAAO,IAAI,KAAK,EAAE,KAAK,IAAI;oBAAE,OAAO,IAAI,CAAC;gBAC9C,IAAI,CAAC,OAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;oBAAE,OAAO,KAAK,CAAC;gBACxC,6DAA6D;gBAC7D,gEAAgE;gBAChE,gEAAgE;gBAChE,6CAA6C;gBAC7C,KAAK,EAAE,CAAC;gBACR,OAAO,GAAG,IAAI,CAAC;gBACf,IAAI,KAAK,EAAE,KAAK,IAAI;oBAAE,OAAO,IAAI,CAAC;gBAClC,OAAO,KAAK,CAAC;YACjB,CAAC;SACJ,CAAC;IACN,CAAC;IAED;;;;;OAKG;IACH,CAAC,MAAM,CAAC,QAAQ,CAAC;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QAEvB,QAAQ,CAAC,CAAC,GAAG;YACT,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACvB,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAC5D,CAAC;QACL,CAAC;QAED,OAAO,GAAG,EAAE,CAAC;IACjB,CAAC;CACJ"}

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

@@ -0,0 +1,13 @@
+import { EaseFunction } from "./type";
+export declare const linear: EaseFunction;
+export declare const easeInQuad: EaseFunction;
+export declare const easeOutQuad: EaseFunction;
+export declare const easeOutQuart: EaseFunction;
+export declare const easeInOutQuad: EaseFunction;
+export declare const easeOutBack: (overshoot?: number) => EaseFunction;
+export declare const easeInBack: (overshoot?: number) => EaseFunction;
+export declare const easeInOutBack: (overshoot?: number) => EaseFunction;
+export declare const easeOutElastic: (amplitude?: number, period?: number) => EaseFunction;
+export declare const easeInElastic: (amplitude?: number, period?: number) => EaseFunction;
+export declare const easeInOutElastic: (amplitude?: number, period?: number) => EaseFunction;
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/tween/ease/constants.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAItC,eAAO,MAAM,MAAM,EAAE,YAAwC,CAAC;AAE9D,eAAO,MAAM,UAAU,EAAE,YAExB,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,YAEzB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,YAG1B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,YAG3B,CAAC;AAEF,eAAO,MAAM,WAAW,GACpB,kBAAmB,KACpB,YAGF,CAAC;AAEF,eAAO,MAAM,UAAU,GACnB,kBAAmB,KACpB,YAGF,CAAC;AAEF,eAAO,MAAM,aAAa,GACtB,kBAAmB,KACpB,YAQF,CAAC;AAGF,eAAO,MAAM,cAAc,GACvB,kBAAa,EACb,eAAY,KACb,YAWF,CAAC;AAEF,eAAO,MAAM,aAAa,GACtB,kBAAa,EACb,eAAY,KACb,YAUF,CAAC;AAEF,eAAO,MAAM,gBAAgB,GACzB,kBAAa,EACb,eAAa,KACd,YAqBF,CAAC"}