@praxisjs/motion 0.2.1 → 0.2.2

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @praxisjs/motion
 
+## 0.2.2
+
+### Patch Changes
+
+- Updated dependencies [fe39901]
+  - @praxisjs/core@0.4.1
+
 ## 0.2.1
 
 ### Patch Changes

package/dist/__tests__/easings.test.d.ts

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

package/dist/__tests__/easings.test.d.ts.map

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

package/dist/__tests__/easings.test.js

@@ -0,0 +1,71 @@
+import { describe, it, expect } from "vitest";
+import { easings, resolveEasing } from "../easings";
+const EPSILON = 1e-6;
+function nearly(a, b) {
+    return Math.abs(a - b) < EPSILON;
+}
+describe("easings", () => {
+    describe("boundary conditions (t=0 → 0, t=1 → 1)", () => {
+        for (const [name, fn] of Object.entries(easings)) {
+            it(`${name}(0) === 0`, () => {
+                expect(nearly(fn(0), 0)).toBe(true);
+            });
+            it(`${name}(1) === 1`, () => {
+                expect(nearly(fn(1), 1)).toBe(true);
+            });
+        }
+    });
+    describe("linear", () => {
+        it("returns t unchanged", () => {
+            expect(easings.linear(0.5)).toBe(0.5);
+            expect(easings.linear(0.25)).toBe(0.25);
+        });
+    });
+    describe("easeIn", () => {
+        it("is slower at start than end (t² curve)", () => {
+            expect(easings.easeIn(0.25)).toBeLessThan(0.25);
+        });
+    });
+    describe("easeOut", () => {
+        it("is faster at start than end", () => {
+            expect(easings.easeOut(0.75)).toBeGreaterThan(0.75);
+        });
+    });
+    describe("easeInOut", () => {
+        it("is symmetric around 0.5", () => {
+            const v = easings.easeInOut(0.5);
+            expect(nearly(v, 0.5)).toBe(true);
+        });
+    });
+    describe("easeInCubic", () => {
+        it("is t³", () => {
+            expect(nearly(easings.easeInCubic(0.5), 0.125)).toBe(true);
+        });
+    });
+    describe("bounce", () => {
+        it("stays within [0, 1] for t in [0, 1]", () => {
+            for (let t = 0; t <= 1; t += 0.1) {
+                const v = easings.bounce(t);
+                expect(v).toBeGreaterThanOrEqual(0);
+                expect(v).toBeLessThanOrEqual(1 + EPSILON);
+            }
+        });
+    });
+    describe("elastic", () => {
+        it("returns 0 at t=0 and 1 at t=1", () => {
+            expect(easings.elastic(0)).toBe(0);
+            expect(easings.elastic(1)).toBe(1);
+        });
+    });
+});
+describe("resolveEasing", () => {
+    it("resolves a string key to the easing function", () => {
+        const fn = resolveEasing("linear");
+        expect(fn).toBe(easings.linear);
+    });
+    it("passes through a custom function", () => {
+        const custom = (t) => t * t * t;
+        expect(resolveEasing(custom)).toBe(custom);
+    });
+});
+//# sourceMappingURL=easings.test.js.map

package/dist/__tests__/easings.test.js.map

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

package/dist/__tests__/spring.test.d.ts

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

package/dist/__tests__/spring.test.d.ts.map

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

package/dist/__tests__/spring.test.js

@@ -0,0 +1,54 @@
+// @vitest-environment jsdom
+import { describe, it, expect, vi } from "vitest";
+import { spring } from "../spring";
+describe("spring", () => {
+    it("initializes value to the starting number", () => {
+        vi.useFakeTimers();
+        const s = spring(42);
+        expect(s.value()).toBe(42);
+        vi.clearAllTimers();
+        vi.useRealTimers();
+    });
+    it("target signal starts at the initial value", () => {
+        vi.useFakeTimers();
+        const s = spring(10);
+        expect(s.target()).toBe(10);
+        vi.clearAllTimers();
+        vi.useRealTimers();
+    });
+    it("stop() cancels without throwing", () => {
+        vi.useFakeTimers();
+        const s = spring(0);
+        expect(() => { s.stop(); }).not.toThrow();
+        vi.clearAllTimers();
+        vi.useRealTimers();
+    });
+    it("stop() can be called multiple times safely", () => {
+        vi.useFakeTimers();
+        const s = spring(5);
+        s.stop();
+        expect(() => { s.stop(); }).not.toThrow();
+        vi.clearAllTimers();
+        vi.useRealTimers();
+    });
+    it("updating target signal triggers animation", () => {
+        vi.useFakeTimers();
+        const s = spring(0);
+        s.target.set(100);
+        // Run a few frames
+        vi.advanceTimersByTime(100);
+        // Value should have moved towards 100
+        expect(s.value()).toBeGreaterThan(0);
+        s.stop();
+        vi.clearAllTimers();
+        vi.useRealTimers();
+    });
+    it("accepts custom spring options", () => {
+        vi.useFakeTimers();
+        const s = spring(0, { stiffness: 0.5, damping: 0.9, mass: 2, precision: 0.01 });
+        expect(s.value()).toBe(0);
+        vi.clearAllTimers();
+        vi.useRealTimers();
+    });
+});
+//# sourceMappingURL=spring.test.js.map

package/dist/__tests__/spring.test.js.map

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

package/dist/__tests__/transition.test.d.ts

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

package/dist/__tests__/transition.test.d.ts.map

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

package/dist/__tests__/transition.test.js

@@ -0,0 +1,63 @@
+// @vitest-environment jsdom
+import { describe, it, expect, vi } from "vitest";
+import { createTransition } from "../transition";
+describe("createTransition", () => {
+    it("enter() adds and removes CSS classes", async () => {
+        vi.useFakeTimers();
+        const t = createTransition({ name: "fade", duration: 100 });
+        const el = document.createElement("div");
+        const p = t.enter(el);
+        // enter-from should have been added immediately
+        expect(el.classList.contains("fade-enter-from")).toBe(true);
+        // requestAnimationFrame fires
+        await vi.runAllTimersAsync();
+        await p;
+        expect(el.classList.contains("fade-enter-from")).toBe(false);
+        expect(el.classList.contains("fade-enter-to")).toBe(false);
+        vi.useRealTimers();
+    });
+    it("leave() adds and removes CSS classes", async () => {
+        vi.useFakeTimers();
+        const t = createTransition({ name: "slide", duration: 100 });
+        const el = document.createElement("div");
+        const p = t.leave(el);
+        expect(el.classList.contains("slide-leave-from")).toBe(true);
+        await vi.runAllTimersAsync();
+        await p;
+        expect(el.classList.contains("slide-leave-from")).toBe(false);
+        expect(el.classList.contains("slide-leave-to")).toBe(false);
+        vi.useRealTimers();
+    });
+    it("calls onEnter callback", async () => {
+        vi.useFakeTimers();
+        const onEnter = vi.fn();
+        const t = createTransition({ onEnter, duration: 0 });
+        const el = document.createElement("div");
+        const p = t.enter(el);
+        expect(onEnter).toHaveBeenCalledWith(el);
+        await vi.runAllTimersAsync();
+        await p;
+        vi.useRealTimers();
+    });
+    it("calls onLeave callback", async () => {
+        vi.useFakeTimers();
+        const onLeave = vi.fn();
+        const t = createTransition({ onLeave, duration: 0 });
+        const el = document.createElement("div");
+        const p = t.leave(el);
+        expect(onLeave).toHaveBeenCalledWith(el);
+        await vi.runAllTimersAsync();
+        await p;
+        vi.useRealTimers();
+    });
+    it("uses 'transition' as default name", async () => {
+        vi.useFakeTimers();
+        const t = createTransition();
+        const el = document.createElement("div");
+        t.enter(el);
+        expect(el.classList.contains("transition-enter-from")).toBe(true);
+        await vi.runAllTimersAsync();
+        vi.useRealTimers();
+    });
+});
+//# sourceMappingURL=transition.test.js.map

package/dist/__tests__/transition.test.js.map

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

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

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

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

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

package/dist/__tests__/tween.test.js

@@ -0,0 +1,122 @@
+// @vitest-environment jsdom
+import { describe, it, expect, vi } from "vitest";
+import { Animate } from "../decorators";
+import { tween } from "../tween";
+// ── tween ─────────────────────────────────────────────────────────────────────
+describe("tween", () => {
+    it("starts with the from value", () => {
+        vi.useFakeTimers();
+        const t = tween(0, 100);
+        expect(t.value()).toBe(0);
+        vi.clearAllTimers();
+        vi.useRealTimers();
+    });
+    it("target starts at the to value", () => {
+        vi.useFakeTimers();
+        const t = tween(0, 100);
+        expect(t.target()).toBe(100);
+        vi.clearAllTimers();
+        vi.useRealTimers();
+    });
+    it("playing is initially true (animation started immediately)", () => {
+        vi.useFakeTimers();
+        const t = tween(0, 100);
+        expect(t.playing()).toBe(true);
+        vi.clearAllTimers();
+        vi.useRealTimers();
+    });
+    it("stop() sets playing to false", () => {
+        vi.useFakeTimers();
+        const t = tween(0, 100);
+        t.stop();
+        expect(t.playing()).toBe(false);
+        vi.clearAllTimers();
+        vi.useRealTimers();
+    });
+    it("reset() restores to from value and clears progress", () => {
+        vi.useFakeTimers();
+        const t = tween(5, 100);
+        t.reset();
+        expect(t.value()).toBe(5);
+        expect(t.progress()).toBe(0);
+        vi.clearAllTimers();
+        vi.useRealTimers();
+    });
+    it("progress moves towards 1 as animation advances", () => {
+        vi.useFakeTimers();
+        const t = tween(0, 100, { duration: 300 });
+        vi.advanceTimersByTime(300);
+        // After full duration, value should be near the target
+        expect(t.progress()).toBeGreaterThanOrEqual(0);
+        vi.clearAllTimers();
+        vi.useRealTimers();
+    });
+    it("changing target restarts animation", () => {
+        vi.useFakeTimers();
+        const t = tween(0, 50);
+        t.target.set(200);
+        expect(t.playing()).toBe(true);
+        t.stop();
+        vi.clearAllTimers();
+        vi.useRealTimers();
+    });
+    it("accepts custom easing and delay options", () => {
+        vi.useFakeTimers();
+        const t = tween(0, 100, { easing: "linear", delay: 100, duration: 200 });
+        expect(t.value()).toBe(0);
+        vi.clearAllTimers();
+        vi.useRealTimers();
+    });
+});
+// ── Animate decorator ─────────────────────────────────────────────────────────
+describe("Animate decorator", () => {
+    function makeCtx(name) {
+        const initializers = [];
+        return {
+            ctx: {
+                name,
+                kind: "field",
+                addInitializer(fn) {
+                    initializers.push(fn);
+                },
+            },
+            run(instance) {
+                initializers.forEach((fn) => { fn.call(instance); });
+            },
+        };
+    }
+    it("creates a numeric getter/setter on first assignment", () => {
+        vi.useFakeTimers();
+        const { ctx, run } = makeCtx("x");
+        Animate()(undefined, ctx);
+        const instance = {};
+        run(instance);
+        instance.x = 10;
+        expect(typeof instance.x).toBe("number");
+        vi.clearAllTimers();
+        vi.useRealTimers();
+    });
+    it("returns 0 before any value is set", () => {
+        vi.useFakeTimers();
+        const { ctx, run } = makeCtx("opacity");
+        Animate()(undefined, ctx);
+        const instance = {};
+        run(instance);
+        expect(instance.opacity).toBe(0);
+        vi.clearAllTimers();
+        vi.useRealTimers();
+    });
+    it("updating the property updates the tween target", () => {
+        vi.useFakeTimers();
+        const { ctx, run } = makeCtx("scale");
+        Animate()(undefined, ctx);
+        const instance = {};
+        run(instance);
+        instance.scale = 1;
+        instance.scale = 2; // second set updates tween target
+        expect(typeof instance.scale).toBe("number");
+        vi.clearAllTimers();
+        vi.useRealTimers();
+    });
+});
+//# sourceMappingURL=tween.test.js.map

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

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

package/dist/__tests__/use-motion.test.d.ts

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

package/dist/__tests__/use-motion.test.d.ts.map

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

package/dist/__tests__/use-motion.test.js

@@ -0,0 +1,139 @@
+// @vitest-environment jsdom
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { useMotion } from "../use-motion";
+function makeRef(el = null) {
+    return { current: el };
+}
+describe("useMotion", () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.clearAllTimers();
+        vi.useRealTimers();
+    });
+    it("returns animate, enter, and exit functions", () => {
+        const ref = makeRef(document.createElement("div"));
+        const m = useMotion(ref);
+        expect(typeof m.animate).toBe("function");
+        expect(typeof m.enter).toBe("function");
+        expect(typeof m.exit).toBe("function");
+    });
+    it("returns a cancel function when ref.current is null", () => {
+        const ref = makeRef(null);
+        const m = useMotion(ref);
+        const cancel = m.animate({ opacity: [0, 1] });
+        expect(typeof cancel).toBe("function");
+        // calling cancel on null ref should not throw
+        expect(() => { cancel(); }).not.toThrow();
+    });
+    it("sets opacity style during animation", async () => {
+        const el = document.createElement("div");
+        const ref = makeRef(el);
+        const m = useMotion(ref);
+        const rafCallbacks = [];
+        vi.spyOn(window, "requestAnimationFrame").mockImplementation((cb) => {
+            rafCallbacks.push(cb);
+            return 1;
+        });
+        m.animate({ opacity: [0, 1], duration: 100 });
+        // Simulate first frame at t=50 (half way through)
+        rafCallbacks[0]?.(50);
+        expect(el.style.opacity).not.toBe("");
+    });
+    it("sets transform style for x, y, scale, rotate", () => {
+        const el = document.createElement("div");
+        const ref = makeRef(el);
+        const m = useMotion(ref);
+        const rafCallbacks = [];
+        vi.spyOn(window, "requestAnimationFrame").mockImplementation((cb) => {
+            rafCallbacks.push(cb);
+            return 1;
+        });
+        m.animate({ x: [0, 100], y: [0, 50], scale: [1, 2], rotate: [0, 90], duration: 200 });
+        rafCallbacks[0]?.(100);
+        expect(el.style.transform).toContain("translateX");
+        expect(el.style.transform).toContain("translateY");
+        expect(el.style.transform).toContain("scale");
+        expect(el.style.transform).toContain("rotate");
+    });
+    it("calls onComplete when animation finishes", () => {
+        const el = document.createElement("div");
+        const ref = makeRef(el);
+        const m = useMotion(ref);
+        const onComplete = vi.fn();
+        const rafCallbacks = [];
+        vi.spyOn(window, "requestAnimationFrame").mockImplementation((cb) => {
+            rafCallbacks.push(cb);
+            return rafCallbacks.length;
+        });
+        m.animate({ opacity: [0, 1], duration: 100, onComplete });
+        // First frame sets startTime = 0
+        rafCallbacks[0](0);
+        // Second frame at ts=100: elapsed=100, t=1, onComplete fires
+        rafCallbacks[1](100);
+        expect(onComplete).toHaveBeenCalledTimes(1);
+    });
+    it("cancel() stops the animation", () => {
+        const el = document.createElement("div");
+        const ref = makeRef(el);
+        const m = useMotion(ref);
+        const cancelRaf = vi.fn();
+        const rafCallbacks = [];
+        vi.spyOn(window, "requestAnimationFrame").mockImplementation((cb) => {
+            rafCallbacks.push(cb);
+            return 42;
+        });
+        vi.spyOn(window, "cancelAnimationFrame").mockImplementation(cancelRaf);
+        const cancel = m.animate({ opacity: [0, 1], duration: 300 });
+        cancel();
+        // After cancel, further frames should be no-ops
+        rafCallbacks[0]?.(100);
+        expect(cancelRaf).toHaveBeenCalledWith(42);
+    });
+    it("exit() reverses opacity and x/y values", () => {
+        const el = document.createElement("div");
+        const ref = makeRef(el);
+        const m = useMotion(ref);
+        const rafCallbacks = [];
+        vi.spyOn(window, "requestAnimationFrame").mockImplementation((cb) => {
+            rafCallbacks.push(cb);
+            return 1;
+        });
+        // exit reverses opacity [0,1] → animates [1,0] and x [0,100] → [100,0]
+        m.exit({ opacity: [0, 1], x: [0, 100], duration: 100 });
+        rafCallbacks[0]?.(0);
+        // At t=0 (start), opacity should be 1 (the reversed start)
+        expect(el.style.opacity).toBe("1");
+    });
+    it("enter() is an alias for animate()", () => {
+        const el = document.createElement("div");
+        const ref = makeRef(el);
+        const m = useMotion(ref);
+        const onComplete = vi.fn();
+        const rafCallbacks = [];
+        vi.spyOn(window, "requestAnimationFrame").mockImplementation((cb) => {
+            rafCallbacks.push(cb);
+            return rafCallbacks.length;
+        });
+        m.enter({ opacity: [0, 1], duration: 50, onComplete });
+        rafCallbacks[0](0); // sets startTime=0
+        rafCallbacks[1](50); // elapsed=50, t=1
+        expect(onComplete).toHaveBeenCalledTimes(1);
+    });
+    it("respects delay option — no progress before delay elapses", () => {
+        const el = document.createElement("div");
+        const ref = makeRef(el);
+        const m = useMotion(ref);
+        const rafCallbacks = [];
+        vi.spyOn(window, "requestAnimationFrame").mockImplementation((cb) => {
+            rafCallbacks.push(cb);
+            return 1;
+        });
+        m.animate({ opacity: [0, 1], delay: 200, duration: 100 });
+        // At ts=50, delay not yet passed; opacity should be at start value (0)
+        rafCallbacks[0]?.(50);
+        expect(el.style.opacity).toBe("0");
+    });
+});
+//# sourceMappingURL=use-motion.test.js.map

package/dist/__tests__/use-motion.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisjs/motion",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -14,7 +14,7 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@praxisjs/core": "0.4.0",
+    "@praxisjs/core": "0.4.1",
     "@praxisjs/shared": "0.2.0"
   },
   "scripts": {

package/src/__tests__/easings.test.ts

@@ -0,0 +1,83 @@
+import { describe, it, expect } from "vitest";
+
+import { easings, resolveEasing } from "../easings";
+
+const EPSILON = 1e-6;
+
+function nearly(a: number, b: number) {
+  return Math.abs(a - b) < EPSILON;
+}
+
+describe("easings", () => {
+  describe("boundary conditions (t=0 → 0, t=1 → 1)", () => {
+    for (const [name, fn] of Object.entries(easings)) {
+      it(`${name}(0) === 0`, () => {
+        expect(nearly(fn(0), 0)).toBe(true);
+      });
+      it(`${name}(1) === 1`, () => {
+        expect(nearly(fn(1), 1)).toBe(true);
+      });
+    }
+  });
+
+  describe("linear", () => {
+    it("returns t unchanged", () => {
+      expect(easings.linear(0.5)).toBe(0.5);
+      expect(easings.linear(0.25)).toBe(0.25);
+    });
+  });
+
+  describe("easeIn", () => {
+    it("is slower at start than end (t² curve)", () => {
+      expect(easings.easeIn(0.25)).toBeLessThan(0.25);
+    });
+  });
+
+  describe("easeOut", () => {
+    it("is faster at start than end", () => {
+      expect(easings.easeOut(0.75)).toBeGreaterThan(0.75);
+    });
+  });
+
+  describe("easeInOut", () => {
+    it("is symmetric around 0.5", () => {
+      const v = easings.easeInOut(0.5);
+      expect(nearly(v, 0.5)).toBe(true);
+    });
+  });
+
+  describe("easeInCubic", () => {
+    it("is t³", () => {
+      expect(nearly(easings.easeInCubic(0.5), 0.125)).toBe(true);
+    });
+  });
+
+  describe("bounce", () => {
+    it("stays within [0, 1] for t in [0, 1]", () => {
+      for (let t = 0; t <= 1; t += 0.1) {
+        const v = easings.bounce(t);
+        expect(v).toBeGreaterThanOrEqual(0);
+        expect(v).toBeLessThanOrEqual(1 + EPSILON);
+      }
+    });
+  });
+
+  describe("elastic", () => {
+    it("returns 0 at t=0 and 1 at t=1", () => {
+      expect(easings.elastic(0)).toBe(0);
+      expect(easings.elastic(1)).toBe(1);
+    });
+  });
+});
+
+describe("resolveEasing", () => {
+  it("resolves a string key to the easing function", () => {
+    const fn = resolveEasing("linear");
+    expect(fn).toBe(easings.linear);
+  });
+
+  it("passes through a custom function", () => {
+    const custom = (t: number) => t * t * t;
+    expect(resolveEasing(custom)).toBe(custom);
+  });
+});

package/src/__tests__/spring.test.ts

@@ -0,0 +1,60 @@
+// @vitest-environment jsdom
+import { describe, it, expect, vi } from "vitest";
+
+import { spring } from "../spring";
+
+describe("spring", () => {
+  it("initializes value to the starting number", () => {
+    vi.useFakeTimers();
+    const s = spring(42);
+    expect(s.value()).toBe(42);
+    vi.clearAllTimers();
+    vi.useRealTimers();
+  });
+
+  it("target signal starts at the initial value", () => {
+    vi.useFakeTimers();
+    const s = spring(10);
+    expect(s.target()).toBe(10);
+    vi.clearAllTimers();
+    vi.useRealTimers();
+  });
+
+  it("stop() cancels without throwing", () => {
+    vi.useFakeTimers();
+    const s = spring(0);
+    expect(() => { s.stop(); }).not.toThrow();
+    vi.clearAllTimers();
+    vi.useRealTimers();
+  });
+
+  it("stop() can be called multiple times safely", () => {
+    vi.useFakeTimers();
+    const s = spring(5);
+    s.stop();
+    expect(() => { s.stop(); }).not.toThrow();
+    vi.clearAllTimers();
+    vi.useRealTimers();
+  });
+
+  it("updating target signal triggers animation", () => {
+    vi.useFakeTimers();
+    const s = spring(0);
+    s.target.set(100);
+    // Run a few frames
+    vi.advanceTimersByTime(100);
+    // Value should have moved towards 100
+    expect(s.value()).toBeGreaterThan(0);
+    s.stop();
+    vi.clearAllTimers();
+    vi.useRealTimers();
+  });
+
+  it("accepts custom spring options", () => {
+    vi.useFakeTimers();
+    const s = spring(0, { stiffness: 0.5, damping: 0.9, mass: 2, precision: 0.01 });
+    expect(s.value()).toBe(0);
+    vi.clearAllTimers();
+    vi.useRealTimers();
+  });
+});

package/src/__tests__/transition.test.ts

@@ -0,0 +1,75 @@
+// @vitest-environment jsdom
+import { describe, it, expect, vi } from "vitest";
+
+import { createTransition } from "../transition";
+
+describe("createTransition", () => {
+  it("enter() adds and removes CSS classes", async () => {
+    vi.useFakeTimers();
+    const t = createTransition({ name: "fade", duration: 100 });
+    const el = document.createElement("div");
+
+    const p = t.enter(el);
+
+    // enter-from should have been added immediately
+    expect(el.classList.contains("fade-enter-from")).toBe(true);
+
+    // requestAnimationFrame fires
+    await vi.runAllTimersAsync();
+
+    await p;
+    expect(el.classList.contains("fade-enter-from")).toBe(false);
+    expect(el.classList.contains("fade-enter-to")).toBe(false);
+    vi.useRealTimers();
+  });
+
+  it("leave() adds and removes CSS classes", async () => {
+    vi.useFakeTimers();
+    const t = createTransition({ name: "slide", duration: 100 });
+    const el = document.createElement("div");
+
+    const p = t.leave(el);
+    expect(el.classList.contains("slide-leave-from")).toBe(true);
+
+    await vi.runAllTimersAsync();
+    await p;
+
+    expect(el.classList.contains("slide-leave-from")).toBe(false);
+    expect(el.classList.contains("slide-leave-to")).toBe(false);
+    vi.useRealTimers();
+  });
+
+  it("calls onEnter callback", async () => {
+    vi.useFakeTimers();
+    const onEnter = vi.fn();
+    const t = createTransition({ onEnter, duration: 0 });
+    const el = document.createElement("div");
+    const p = t.enter(el);
+    expect(onEnter).toHaveBeenCalledWith(el);
+    await vi.runAllTimersAsync();
+    await p;
+    vi.useRealTimers();
+  });
+
+  it("calls onLeave callback", async () => {
+    vi.useFakeTimers();
+    const onLeave = vi.fn();
+    const t = createTransition({ onLeave, duration: 0 });
+    const el = document.createElement("div");
+    const p = t.leave(el);
+    expect(onLeave).toHaveBeenCalledWith(el);
+    await vi.runAllTimersAsync();
+    await p;
+    vi.useRealTimers();
+  });
+
+  it("uses 'transition' as default name", async () => {
+    vi.useFakeTimers();
+    const t = createTransition();
+    const el = document.createElement("div");
+    t.enter(el);
+    expect(el.classList.contains("transition-enter-from")).toBe(true);
+    await vi.runAllTimersAsync();
+    vi.useRealTimers();
+  });
+});

package/src/__tests__/tween.test.ts

@@ -0,0 +1,136 @@
+// @vitest-environment jsdom
+import { describe, it, expect, vi } from "vitest";
+
+import { Animate } from "../decorators";
+import { tween } from "../tween";
+
+// ── tween ─────────────────────────────────────────────────────────────────────
+
+describe("tween", () => {
+  it("starts with the from value", () => {
+    vi.useFakeTimers();
+    const t = tween(0, 100);
+    expect(t.value()).toBe(0);
+    vi.clearAllTimers();
+    vi.useRealTimers();
+  });
+
+  it("target starts at the to value", () => {
+    vi.useFakeTimers();
+    const t = tween(0, 100);
+    expect(t.target()).toBe(100);
+    vi.clearAllTimers();
+    vi.useRealTimers();
+  });
+
+  it("playing is initially true (animation started immediately)", () => {
+    vi.useFakeTimers();
+    const t = tween(0, 100);
+    expect(t.playing()).toBe(true);
+    vi.clearAllTimers();
+    vi.useRealTimers();
+  });
+
+  it("stop() sets playing to false", () => {
+    vi.useFakeTimers();
+    const t = tween(0, 100);
+    t.stop();
+    expect(t.playing()).toBe(false);
+    vi.clearAllTimers();
+    vi.useRealTimers();
+  });
+
+  it("reset() restores to from value and clears progress", () => {
+    vi.useFakeTimers();
+    const t = tween(5, 100);
+    t.reset();
+    expect(t.value()).toBe(5);
+    expect(t.progress()).toBe(0);
+    vi.clearAllTimers();
+    vi.useRealTimers();
+  });
+
+  it("progress moves towards 1 as animation advances", () => {
+    vi.useFakeTimers();
+    const t = tween(0, 100, { duration: 300 });
+    vi.advanceTimersByTime(300);
+    // After full duration, value should be near the target
+    expect(t.progress()).toBeGreaterThanOrEqual(0);
+    vi.clearAllTimers();
+    vi.useRealTimers();
+  });
+
+  it("changing target restarts animation", () => {
+    vi.useFakeTimers();
+    const t = tween(0, 50);
+    t.target.set(200);
+    expect(t.playing()).toBe(true);
+    t.stop();
+    vi.clearAllTimers();
+    vi.useRealTimers();
+  });
+
+  it("accepts custom easing and delay options", () => {
+    vi.useFakeTimers();
+    const t = tween(0, 100, { easing: "linear", delay: 100, duration: 200 });
+    expect(t.value()).toBe(0);
+    vi.clearAllTimers();
+    vi.useRealTimers();
+  });
+});
+
+// ── Animate decorator ─────────────────────────────────────────────────────────
+
+describe("Animate decorator", () => {
+  function makeCtx(name: string) {
+    const initializers: Array<(this: unknown) => void> = [];
+    return {
+      ctx: {
+        name,
+        kind: "field" as const,
+        addInitializer(fn: (this: unknown) => void) {
+          initializers.push(fn);
+        },
+      } as ClassFieldDecoratorContext,
+      run(instance: unknown) {
+        initializers.forEach((fn) => { fn.call(instance); });
+      },
+    };
+  }
+
+  it("creates a numeric getter/setter on first assignment", () => {
+    vi.useFakeTimers();
+    const { ctx, run } = makeCtx("x");
+    Animate()(undefined, ctx);
+    const instance: Record<string, unknown> = {};
+    run(instance);
+    instance.x = 10;
+    expect(typeof instance.x).toBe("number");
+    vi.clearAllTimers();
+    vi.useRealTimers();
+  });
+
+  it("returns 0 before any value is set", () => {
+    vi.useFakeTimers();
+    const { ctx, run } = makeCtx("opacity");
+    Animate()(undefined, ctx);
+    const instance: Record<string, unknown> = {};
+    run(instance);
+    expect(instance.opacity).toBe(0);
+    vi.clearAllTimers();
+    vi.useRealTimers();
+  });
+
+  it("updating the property updates the tween target", () => {
+    vi.useFakeTimers();
+    const { ctx, run } = makeCtx("scale");
+    Animate()(undefined, ctx);
+    const instance: Record<string, unknown> = {};
+    run(instance);
+    instance.scale = 1;
+    instance.scale = 2; // second set updates tween target
+    expect(typeof instance.scale).toBe("number");
+    vi.clearAllTimers();
+    vi.useRealTimers();
+  });
+});

package/src/__tests__/use-motion.test.ts

@@ -0,0 +1,172 @@
+// @vitest-environment jsdom
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+
+import { useMotion } from "../use-motion";
+
+function makeRef(el: HTMLElement | null = null) {
+  return { current: el };
+}
+
+describe("useMotion", () => {
+  beforeEach(() => {
+    vi.useFakeTimers();
+  });
+
+  afterEach(() => {
+    vi.clearAllTimers();
+    vi.useRealTimers();
+  });
+
+  it("returns animate, enter, and exit functions", () => {
+    const ref = makeRef(document.createElement("div"));
+    const m = useMotion(ref);
+    expect(typeof m.animate).toBe("function");
+    expect(typeof m.enter).toBe("function");
+    expect(typeof m.exit).toBe("function");
+  });
+
+  it("returns a cancel function when ref.current is null", () => {
+    const ref = makeRef(null);
+    const m = useMotion(ref);
+    const cancel = m.animate({ opacity: [0, 1] });
+    expect(typeof cancel).toBe("function");
+    // calling cancel on null ref should not throw
+    expect(() => { cancel(); }).not.toThrow();
+  });
+
+  it("sets opacity style during animation", async () => {
+    const el = document.createElement("div");
+    const ref = makeRef(el);
+    const m = useMotion(ref);
+
+    const rafCallbacks: FrameRequestCallback[] = [];
+    vi.spyOn(window, "requestAnimationFrame").mockImplementation((cb) => {
+      rafCallbacks.push(cb);
+      return 1;
+    });
+
+    m.animate({ opacity: [0, 1], duration: 100 });
+
+    // Simulate first frame at t=50 (half way through)
+    rafCallbacks[0]?.(50);
+    expect(el.style.opacity).not.toBe("");
+  });
+
+  it("sets transform style for x, y, scale, rotate", () => {
+    const el = document.createElement("div");
+    const ref = makeRef(el);
+    const m = useMotion(ref);
+
+    const rafCallbacks: FrameRequestCallback[] = [];
+    vi.spyOn(window, "requestAnimationFrame").mockImplementation((cb) => {
+      rafCallbacks.push(cb);
+      return 1;
+    });
+
+    m.animate({ x: [0, 100], y: [0, 50], scale: [1, 2], rotate: [0, 90], duration: 200 });
+
+    rafCallbacks[0]?.(100);
+    expect(el.style.transform).toContain("translateX");
+    expect(el.style.transform).toContain("translateY");
+    expect(el.style.transform).toContain("scale");
+    expect(el.style.transform).toContain("rotate");
+  });
+
+  it("calls onComplete when animation finishes", () => {
+    const el = document.createElement("div");
+    const ref = makeRef(el);
+    const m = useMotion(ref);
+    const onComplete = vi.fn();
+
+    const rafCallbacks: FrameRequestCallback[] = [];
+    vi.spyOn(window, "requestAnimationFrame").mockImplementation((cb) => {
+      rafCallbacks.push(cb);
+      return rafCallbacks.length;
+    });
+
+    m.animate({ opacity: [0, 1], duration: 100, onComplete });
+
+    // First frame sets startTime = 0
+    rafCallbacks[0](0);
+    // Second frame at ts=100: elapsed=100, t=1, onComplete fires
+    rafCallbacks[1](100);
+    expect(onComplete).toHaveBeenCalledTimes(1);
+  });
+
+  it("cancel() stops the animation", () => {
+    const el = document.createElement("div");
+    const ref = makeRef(el);
+    const m = useMotion(ref);
+
+    const cancelRaf = vi.fn();
+    const rafCallbacks: FrameRequestCallback[] = [];
+    vi.spyOn(window, "requestAnimationFrame").mockImplementation((cb) => {
+      rafCallbacks.push(cb);
+      return 42;
+    });
+    vi.spyOn(window, "cancelAnimationFrame").mockImplementation(cancelRaf);
+
+    const cancel = m.animate({ opacity: [0, 1], duration: 300 });
+    cancel();
+
+    // After cancel, further frames should be no-ops
+    rafCallbacks[0]?.(100);
+    expect(cancelRaf).toHaveBeenCalledWith(42);
+  });
+
+  it("exit() reverses opacity and x/y values", () => {
+    const el = document.createElement("div");
+    const ref = makeRef(el);
+    const m = useMotion(ref);
+
+    const rafCallbacks: FrameRequestCallback[] = [];
+    vi.spyOn(window, "requestAnimationFrame").mockImplementation((cb) => {
+      rafCallbacks.push(cb);
+      return 1;
+    });
+
+    // exit reverses opacity [0,1] → animates [1,0] and x [0,100] → [100,0]
+    m.exit({ opacity: [0, 1], x: [0, 100], duration: 100 });
+
+    rafCallbacks[0]?.(0);
+    // At t=0 (start), opacity should be 1 (the reversed start)
+    expect(el.style.opacity).toBe("1");
+  });
+
+  it("enter() is an alias for animate()", () => {
+    const el = document.createElement("div");
+    const ref = makeRef(el);
+    const m = useMotion(ref);
+    const onComplete = vi.fn();
+
+    const rafCallbacks: FrameRequestCallback[] = [];
+    vi.spyOn(window, "requestAnimationFrame").mockImplementation((cb) => {
+      rafCallbacks.push(cb);
+      return rafCallbacks.length;
+    });
+
+    m.enter({ opacity: [0, 1], duration: 50, onComplete });
+
+    rafCallbacks[0](0);   // sets startTime=0
+    rafCallbacks[1](50);  // elapsed=50, t=1
+    expect(onComplete).toHaveBeenCalledTimes(1);
+  });
+
+  it("respects delay option — no progress before delay elapses", () => {
+    const el = document.createElement("div");
+    const ref = makeRef(el);
+    const m = useMotion(ref);
+
+    const rafCallbacks: FrameRequestCallback[] = [];
+    vi.spyOn(window, "requestAnimationFrame").mockImplementation((cb) => {
+      rafCallbacks.push(cb);
+      return 1;
+    });
+
+    m.animate({ opacity: [0, 1], delay: 200, duration: 100 });
+
+    // At ts=50, delay not yet passed; opacity should be at start value (0)
+    rafCallbacks[0]?.(50);
+    expect(el.style.opacity).toBe("0");
+  });
+});