@motion-script/core 0.1.0

package/dist/tween/wait.js

@@ -0,0 +1,25 @@
+/**
+ * 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 function* wait(seconds) {
+    let elapsed = 0;
+    while (elapsed < seconds) {
+        const dt = yield;
+        elapsed += dt;
+    }
+    return;
+}
+//# sourceMappingURL=wait.js.map

package/dist/tween/wait.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.js","sourceRoot":"","sources":["../../src/tween/wait.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,SAAS,CAAC,CAAC,IAAI,CACjB,OAAe;IAEf,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,OAAO,OAAO,GAAG,OAAO,EAAE,CAAC;QACvB,MAAM,EAAE,GAAG,KAAK,CAAC;QACjB,OAAO,IAAI,EAAE,CAAC;IAClB,CAAC;IAED,OAAO;AACX,CAAC"}

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

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

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

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

package/dist/tween/wait.test.js

@@ -0,0 +1,35 @@
+import { describe, it, expect } from 'vitest';
+import { wait } from '@/tween/wait';
+describe('wait', () => {
+    it('completes immediately when duration is 0', () => {
+        const gen = wait(0);
+        // First next() enters the loop; 0 < 0 is false → returns immediately
+        expect(gen.next().done).toBe(true);
+    });
+    it('completes after enough total dt accumulates', () => {
+        const gen = wait(0.5);
+        gen.next(); // prime
+        let r = gen.next(0.2);
+        expect(r.done).toBe(false);
+        r = gen.next(0.2);
+        expect(r.done).toBe(false);
+        r = gen.next(0.2); // 0.6 ≥ 0.5
+        expect(r.done).toBe(true);
+    });
+    it('accepts a single oversized dt to finish in one shot', () => {
+        const gen = wait(1.0);
+        gen.next();
+        const r = gen.next(10);
+        expect(r.done).toBe(true);
+    });
+    it('does not finish before duration is reached', () => {
+        const gen = wait(0.5);
+        gen.next();
+        for (let i = 0; i < 5; i++) {
+            // 5 * 0.05 = 0.25 < 0.5 → not done
+            const r = gen.next(0.05);
+            expect(r.done).toBe(false);
+        }
+    });
+});
+//# sourceMappingURL=wait.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wait.test.js","sourceRoot":"","sources":["../../src/tween/wait.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEpC,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE;IAClB,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAChD,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,qEAAqE;QACrE,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACnD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QACtB,GAAG,CAAC,IAAI,EAAE,CAAC,CAAc,QAAQ;QACjC,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtB,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClB,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAO,YAAY;QACrC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QACtB,GAAG,CAAC,IAAI,EAAE,CAAC;QACX,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvB,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QAClD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QACtB,GAAG,CAAC,IAAI,EAAE,CAAC;QACX,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACzB,mCAAmC;YACnC,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACzB,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/util/clamp.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Clamps a number between a minimum and maximum value.
+ *
+ * @param value - The number to clamp.
+ * @param min - The lower bound.
+ * @param max - The upper bound.
+ * @returns The clamped number.
+ */
+export declare const clamp: (value: number, min: number, max: number) => number;
+/** Shorthand for `clamp(t, 0, 1)`, commonly used to normalize tween progress. */
+export declare function clamp01(t: number): number;
+//# sourceMappingURL=clamp.d.ts.map

package/dist/util/clamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clamp.d.ts","sourceRoot":"","sources":["../../src/util/clamp.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK,GAAI,OAAO,MAAM,EAAE,KAAK,MAAM,EAAE,KAAK,MAAM,KAAG,MAE/D,CAAC;AAEF,iFAAiF;AACjF,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,UAEhC"}

package/dist/util/clamp.js

@@ -0,0 +1,16 @@
+/**
+ * Clamps a number between a minimum and maximum value.
+ *
+ * @param value - The number to clamp.
+ * @param min - The lower bound.
+ * @param max - The upper bound.
+ * @returns The clamped number.
+ */
+export const clamp = (value, min, max) => {
+    return Math.max(min, Math.min(value, max));
+};
+/** Shorthand for `clamp(t, 0, 1)`, commonly used to normalize tween progress. */
+export function clamp01(t) {
+    return clamp(t, 0, 1);
+}
+//# sourceMappingURL=clamp.js.map

package/dist/util/clamp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clamp.js","sourceRoot":"","sources":["../../src/util/clamp.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW,EAAU,EAAE;IACvE,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;AAC7C,CAAC,CAAC;AAEF,iFAAiF;AACjF,MAAM,UAAU,OAAO,CAAC,CAAS;IAC7B,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAC1B,CAAC"}

package/dist/util/clamp.test.d.ts

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

package/dist/util/clamp.test.d.ts.map

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

package/dist/util/clamp.test.js

@@ -0,0 +1,31 @@
+import { describe, it, expect } from 'vitest';
+import { clamp, clamp01 } from '@/util/clamp';
+describe('clamp', () => {
+    it('returns the value when within range', () => {
+        expect(clamp(5, 0, 10)).toBe(5);
+    });
+    it('clamps to the lower bound', () => {
+        expect(clamp(-3, 0, 10)).toBe(0);
+    });
+    it('clamps to the upper bound', () => {
+        expect(clamp(42, 0, 10)).toBe(10);
+    });
+    it('returns the bound exactly when value equals it', () => {
+        expect(clamp(0, 0, 10)).toBe(0);
+        expect(clamp(10, 0, 10)).toBe(10);
+    });
+    it('works with negative ranges', () => {
+        expect(clamp(-5, -10, -1)).toBe(-5);
+        expect(clamp(0, -10, -1)).toBe(-1);
+    });
+});
+describe('clamp01', () => {
+    it('passes through values inside [0,1]', () => {
+        expect(clamp01(0.5)).toBe(0.5);
+    });
+    it('clamps below 0 to 0 and above 1 to 1', () => {
+        expect(clamp01(-2)).toBe(0);
+        expect(clamp01(3)).toBe(1);
+    });
+});
+//# sourceMappingURL=clamp.test.js.map

package/dist/util/clamp.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clamp.test.js","sourceRoot":"","sources":["../../src/util/clamp.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE9C,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE;IACnB,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACtD,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QAClC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;IACrB,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5B,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/util/index.d.ts

@@ -0,0 +1,4 @@
+export * from './clamp';
+export * from './range';
+export * from './reference';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/util/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA"}

package/dist/util/index.js

@@ -0,0 +1,4 @@
+export * from './clamp';
+export * from './range';
+export * from './reference';
+//# sourceMappingURL=index.js.map

package/dist/util/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/util/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA"}

package/dist/util/random.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Deterministic pseudo-random number generator based on the mulberry32 algorithm.
+ * Produces the same sequence for the same seed, making animations reproducible.
+ */
+export declare class SeedGenerator {
+    private state;
+    constructor(seed: string | number);
+    /**
+     * Resets the generator to a new seed.
+     * String seeds are hashed via djb2 into a 32-bit integer.
+     */
+    setSeed(seed: string | number): void;
+    /** Returns the next pseudo-random float in [0, 1). */
+    next(): number;
+}
+//# sourceMappingURL=random.d.ts.map

package/dist/util/random.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../../src/util/random.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,KAAK,CAAa;gBAEd,IAAI,EAAE,MAAM,GAAG,MAAM;IAIjC;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAM7B,sDAAsD;IACtD,IAAI;CAMP"}

package/dist/util/random.js

@@ -0,0 +1,28 @@
+/**
+ * Deterministic pseudo-random number generator based on the mulberry32 algorithm.
+ * Produces the same sequence for the same seed, making animations reproducible.
+ */
+export class SeedGenerator {
+    state = 0;
+    constructor(seed) {
+        this.setSeed(seed);
+    }
+    /**
+     * Resets the generator to a new seed.
+     * String seeds are hashed via djb2 into a 32-bit integer.
+     */
+    setSeed(seed) {
+        this.state = typeof seed === 'string'
+            ? seed.split('').reduce((a, b) => { a = ((a << 5) - a) + b.charCodeAt(0); return a & a; }, 0)
+            : seed;
+    }
+    /** Returns the next pseudo-random float in [0, 1). */
+    next() {
+        this.state |= 0;
+        this.state = this.state + 0x6D2B79F5 | 0;
+        var t = Math.imul(this.state ^ this.state >>> 15, 1 | this.state);
+        t = t + Math.imul(t ^ t >>> 7, 61 | t) ^ t;
+        return ((t ^ t >>> 14) >>> 0) / 4294967296;
+    }
+}
+//# sourceMappingURL=random.js.map

package/dist/util/random.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.js","sourceRoot":"","sources":["../../src/util/random.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,aAAa;IACd,KAAK,GAAW,CAAC,CAAC;IAE1B,YAAY,IAAqB;QAC7B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,IAAqB;QACzB,IAAI,CAAC,KAAK,GAAG,OAAO,IAAI,KAAK,QAAQ;YACjC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC7F,CAAC,CAAC,IAAI,CAAC;IACf,CAAC;IAED,sDAAsD;IACtD,IAAI;QACA,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;QAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,UAAU,GAAG,CAAC,CAAC;QAC1D,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,KAAK,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAClE,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QAC3C,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,UAAU,CAAC;IAC/C,CAAC;CACJ"}

package/dist/util/random.test.d.ts

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

package/dist/util/random.test.d.ts.map

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

package/dist/util/random.test.js

@@ -0,0 +1,42 @@
+import { describe, it, expect } from 'vitest';
+import { SeedGenerator } from '@/util/random';
+describe('SeedGenerator', () => {
+    it('produces values in the [0,1) range', () => {
+        const gen = new SeedGenerator(123);
+        for (let i = 0; i < 100; i++) {
+            const v = gen.next();
+            expect(v).toBeGreaterThanOrEqual(0);
+            expect(v).toBeLessThan(1);
+        }
+    });
+    it('is deterministic for the same numeric seed', () => {
+        const a = new SeedGenerator(42);
+        const b = new SeedGenerator(42);
+        for (let i = 0; i < 10; i++) {
+            expect(a.next()).toBe(b.next());
+        }
+    });
+    it('is deterministic for the same string seed', () => {
+        const a = new SeedGenerator('motion');
+        const b = new SeedGenerator('motion');
+        expect(a.next()).toBe(b.next());
+    });
+    it('produces different sequences for different seeds', () => {
+        const a = new SeedGenerator(1);
+        const b = new SeedGenerator(2);
+        expect(a.next()).not.toBe(b.next());
+    });
+    it('advances state across successive calls', () => {
+        const gen = new SeedGenerator(7);
+        const first = gen.next();
+        const second = gen.next();
+        expect(first).not.toBe(second);
+    });
+    it('reseeding resets the sequence', () => {
+        const gen = new SeedGenerator(99);
+        const first = gen.next();
+        gen.setSeed(99);
+        expect(gen.next()).toBe(first);
+    });
+});
+//# sourceMappingURL=random.test.js.map

package/dist/util/random.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.test.js","sourceRoot":"","sources":["../../src/util/random.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC1C,MAAM,GAAG,GAAG,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC;QACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;YACrB,MAAM,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;YACpC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC9B,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,GAAG,IAAI,aAAa,CAAC,EAAE,CAAC,CAAC;QAChC,MAAM,CAAC,GAAG,IAAI,aAAa,CAAC,EAAE,CAAC,CAAC;QAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1B,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACpC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACjD,MAAM,CAAC,GAAG,IAAI,aAAa,CAAC,QAAQ,CAAC,CAAC;QACtC,MAAM,CAAC,GAAG,IAAI,aAAa,CAAC,QAAQ,CAAC,CAAC;QACtC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QACxD,MAAM,CAAC,GAAG,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,GAAG,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAC9C,MAAM,GAAG,GAAG,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QAC1B,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACrC,MAAM,GAAG,GAAG,IAAI,aAAa,CAAC,EAAE,CAAC,CAAC;QAClC,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACzB,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAChB,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/util/range.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Generates an array of numbers.
+ *
+ * - `range(n)` → `[0, 1, …, n-1]`
+ * - `range(from, to)` → integers from `from` up to (not including) `to`
+ * - `range(from, to, step)` → same but incremented by `step`; a negative
+ *   `step` counts downward (e.g. `range(5, 0, -1)` → `[5, 4, 3, 2, 1]`)
+ */
+export declare function range(length: number): number[];
+export declare function range(from: number, to: number): number[];
+export declare function range(from: number, to: number, step: number): number[];
+//# sourceMappingURL=range.d.ts.map

package/dist/util/range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"range.d.ts","sourceRoot":"","sources":["../../src/util/range.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;AAC/C,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;AACzD,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA"}

package/dist/util/range.js

@@ -0,0 +1,11 @@
+export function range(fromOrLength, to, step = 1) {
+    if (to === undefined) {
+        return Array.from({ length: fromOrLength }, (_, i) => i);
+    }
+    const result = [];
+    for (let i = fromOrLength; step > 0 ? i < to : i > to; i += step) {
+        result.push(i);
+    }
+    return result;
+}
+//# sourceMappingURL=range.js.map

package/dist/util/range.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"range.js","sourceRoot":"","sources":["../../src/util/range.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,KAAK,CAAC,YAAoB,EAAE,EAAW,EAAE,IAAI,GAAG,CAAC;IAC/D,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;IAC1D,CAAC;IACD,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,KAAK,IAAI,CAAC,GAAG,YAAY,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;QACjE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAChB,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/util/reference.d.ts

@@ -0,0 +1,15 @@
+/**
+ * A callable reference that acts as both getter and setter.
+ * - `ref()` → returns the current value (throws if not yet assigned)
+ * - `ref(value)` → sets the current value
+ */
+export interface Reference<T> {
+    (): T;
+    (node: T | null): void;
+}
+/**
+ * Creates a typed reference holder — analogous to React's `createRef`,
+ * but expressed as a single overloaded function rather than a `{ current }` object.
+ */
+export declare function createRef<T>(): Reference<T>;
+//# sourceMappingURL=reference.d.ts.map

package/dist/util/reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../../src/util/reference.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC;IACxB,IAAI,CAAC,CAAC;IACN,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAiB3C"}

package/dist/util/reference.js

@@ -0,0 +1,20 @@
+/**
+ * Creates a typed reference holder — analogous to React's `createRef`,
+ * but expressed as a single overloaded function rather than a `{ current }` object.
+ */
+export function createRef() {
+    let current = null;
+    function ref(node) {
+        if (node !== undefined) {
+            current = node;
+        }
+        else {
+            if (current === null) {
+                throw new Error("Reference not assigned yet");
+            }
+            return current;
+        }
+    }
+    return ref;
+}
+//# sourceMappingURL=reference.js.map

package/dist/util/reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.js","sourceRoot":"","sources":["../../src/util/reference.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,MAAM,UAAU,SAAS;IACrB,IAAI,OAAO,GAAa,IAAI,CAAC;IAI7B,SAAS,GAAG,CAAC,IAAe;QACxB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACrB,OAAO,GAAG,IAAI,CAAC;QACnB,CAAC;aAAM,CAAC;YACJ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACnB,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;YAClD,CAAC;YACD,OAAO,OAAO,CAAC;QACnB,CAAC;IACL,CAAC;IAED,OAAO,GAAG,CAAC;AACf,CAAC"}

package/dist/util/reference.test.d.ts

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

package/dist/util/reference.test.d.ts.map

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

package/dist/util/reference.test.js

@@ -0,0 +1,32 @@
+import { describe, it, expect } from 'vitest';
+import { createRef } from '@/util/reference';
+describe('createRef', () => {
+    it('throws when read before assignment', () => {
+        const ref = createRef();
+        expect(() => ref()).toThrow(/not assigned/i);
+    });
+    it('returns the value after it is set', () => {
+        const ref = createRef();
+        ref('hello');
+        expect(ref()).toBe('hello');
+    });
+    it('overwrites the value on a second set', () => {
+        const ref = createRef();
+        ref(1);
+        ref(2);
+        expect(ref()).toBe(2);
+    });
+    it('stores object references identically', () => {
+        const ref = createRef();
+        const obj = { id: 7 };
+        ref(obj);
+        expect(ref()).toBe(obj);
+    });
+    it('treats null as a cleared reference', () => {
+        const ref = createRef();
+        ref(5);
+        ref(null);
+        expect(() => ref()).toThrow(/not assigned/i);
+    });
+});
+//# sourceMappingURL=reference.test.js.map

package/dist/util/reference.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.test.js","sourceRoot":"","sources":["../../src/util/reference.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACvB,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC1C,MAAM,GAAG,GAAG,SAAS,EAAU,CAAC;QAChC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QACzC,MAAM,GAAG,GAAG,SAAS,EAAU,CAAC;QAChC,GAAG,CAAC,OAAO,CAAC,CAAC;QACb,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC5C,MAAM,GAAG,GAAG,SAAS,EAAU,CAAC;QAChC,GAAG,CAAC,CAAC,CAAC,CAAC;QACP,GAAG,CAAC,CAAC,CAAC,CAAC;QACP,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC5C,MAAM,GAAG,GAAG,SAAS,EAAkB,CAAC;QACxC,MAAM,GAAG,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;QACtB,GAAG,CAAC,GAAG,CAAC,CAAC;QACT,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC1C,MAAM,GAAG,GAAG,SAAS,EAAU,CAAC;QAChC,GAAG,CAAC,CAAC,CAAC,CAAC;QACP,GAAG,CAAC,IAAI,CAAC,CAAC;QACV,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@motion-script/core",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Engine-agnostic animation library for Motion Script: scenes, nodes, signals, tweens, layout, and the JSX runtime.",
+  "keywords": [
+    "motion-script",
+    "motion script",
+    "animation"
+  ],
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./jsx/jsx-runtime": {
+      "types": "./dist/jsx/jsx-runtime.d.ts",
+      "default": "./dist/jsx/jsx-runtime.js"
+    },
+    "./jsx/jsx-dev-runtime": {
+      "types": "./dist/jsx/jsx-dev-runtime.d.ts",
+      "default": "./dist/jsx/jsx-dev-runtime.js"
+    }
+  },
+  "scripts": {
+    "build": "eslint . && tsc -b tsconfig.build.json && tsc-alias -p tsconfig.build.json",
+    "dev": "concurrently \"tsc -b tsconfig.build.json --watch\" \"tsc-alias -p tsconfig.build.json -w\"",
+    "clean": "rimraf dist .turbo && tsc -b tsconfig.build.json --clean",
+    "test": "vitest",
+    "lint": "eslint .",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "devDependencies": {
+    "@types/node": "catalog:",
+    "concurrently": "catalog:",
+    "eslint": "^9.39.4",
+    "eslint-import-resolver-typescript": "^4.4.4",
+    "eslint-plugin-import-x": "^4.16.1",
+    "tsc-alias": "catalog:",
+    "typescript": "catalog:",
+    "typescript-eslint": "^8.48.0",
+    "vitest": "catalog:"
+  }
+}