@praxisjs/motion 0.2.3 → 1.1.0

package/src/easings.ts

@@ -23,5 +23,10 @@ export const easings = {
 export type Easing = keyof typeof easings | ((t: number) => number);
 
 export function resolveEasing(easing: Easing): (t: number) => number {
-  return typeof easing === "function" ? easing : easings[easing];
+  if (typeof easing === "function") return easing;
+  const fn = easings[easing];
+  if (typeof fn !== "function") {
+    throw new Error(`[resolveEasing] Unknown easing: "${easing}". Valid names are: ${Object.keys(easings).join(", ")}.`);
+  }
+  return fn;
 }

package/src/index.ts

@@ -1,16 +1,3 @@
-export { easings, resolveEasing } from "./easings";
-export type { Easing } from "./easings";
-
-export { tween } from "./tween";
-export type { Tween, TweenOptions } from "./tween";
-
-export { spring } from "./spring";
+export { Tween, Spring } from "./decorators";
+export type { TweenOptions } from "./tween";
 export type { SpringOptions } from "./spring";
-
-export { useMotion } from "./use-motion";
-export type { MotionKeyframes } from "./use-motion";
-
-export { createTransition } from "./transition";
-export type { TransitionOptions } from "./transition";
-
-export { Animate } from "./decorators";

package/src/spring.ts

@@ -15,6 +15,10 @@ export function spring(initial: number, options: SpringOptions = {}) {
     precision = 0.001,
   } = options;
 
+  if (stiffness <= 0) {
+    throw new Error("stiffness must be greater than 0");
+  }
+
   const _value = signal(initial);
   const _target = signal(initial);
   let velocity = 0;

package/src/transition.ts

@@ -10,32 +10,42 @@ export function createTransition(options: TransitionOptions = {}) {
 
   return {
     enter(el: HTMLElement): Promise<void> {
-      onEnter?.(el);
-      el.classList.add(`${name}-enter-from`);
-      requestAnimationFrame(() => {
-        el.classList.remove(`${name}-enter-from`);
-        el.classList.add(`${name}-enter-to`);
-      });
-      return new Promise((res) =>
+      return new Promise((res, rej) => {
+        try {
+          onEnter?.(el);
+        } catch (err) {
+          rej(err instanceof Error ? err : new Error(String(err)));
+          return;
+        }
+        el.classList.add(`${name}-enter-from`);
+        requestAnimationFrame(() => {
+          el.classList.remove(`${name}-enter-from`);
+          el.classList.add(`${name}-enter-to`);
+        });
         setTimeout(() => {
           el.classList.remove(`${name}-enter-to`);
           res();
-        }, duration),
-      );
+        }, duration);
+      });
     },
     leave(el: HTMLElement): Promise<void> {
-      onLeave?.(el);
-      el.classList.add(`${name}-leave-from`);
-      requestAnimationFrame(() => {
-        el.classList.remove(`${name}-leave-from`);
-        el.classList.add(`${name}-leave-to`);
-      });
-      return new Promise((res) =>
+      return new Promise((res, rej) => {
+        try {
+          onLeave?.(el);
+        } catch (err) {
+          rej(err instanceof Error ? err : new Error(String(err)));
+          return;
+        }
+        el.classList.add(`${name}-leave-from`);
+        requestAnimationFrame(() => {
+          el.classList.remove(`${name}-leave-from`);
+          el.classList.add(`${name}-leave-to`);
+        });
         setTimeout(() => {
           el.classList.remove(`${name}-leave-to`);
           res();
-        }, duration),
-      );
+        }, duration);
+      });
     },
   };
 }

package/src/tween.ts

@@ -23,7 +23,8 @@ export function tween(
   to: number,
   options: TweenOptions = {},
 ): Tween {
-  const { duration = 300, easing = "easeOut", delay = 0 } = options;
+  const { duration: rawDuration = 300, easing = "easeOut", delay = 0 } = options;
+  const duration = Math.max(1, rawDuration);
   const easeFn = resolveEasing(easing);
 
   const _value = signal(from);

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

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

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

@@ -1 +0,0 @@
-{"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

@@ -1,139 +0,0 @@
-// @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

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

package/dist/use-motion.d.ts

@@ -1,20 +0,0 @@
-import { type Easing } from "./easings";
-export interface MotionKeyframes {
-    opacity?: [number, number];
-    x?: [number, number];
-    y?: [number, number];
-    scale?: [number, number];
-    rotate?: [number, number];
-    duration?: number;
-    easing?: Easing;
-    delay?: number;
-    onComplete?: () => void;
-}
-export declare function useMotion(ref: {
-    current: HTMLElement | null;
-}): {
-    animate: (keyframes: MotionKeyframes) => () => void;
-    enter: (kf: MotionKeyframes) => () => void;
-    exit: (kf: MotionKeyframes) => () => void;
-};
-//# sourceMappingURL=use-motion.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"use-motion.d.ts","sourceRoot":"","sources":["../src/use-motion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AAEvD,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrB,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrB,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE;IAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;CAAE;yBAChC,eAAe,KAAG,MAAM,IAAI;gBAgE1C,eAAe,WAhEuB,IAAI;eAiE3C,eAAe,WAjEwB,IAAI;EAyEzD"}

package/dist/use-motion.js

@@ -1,58 +0,0 @@
-import { resolveEasing } from "./easings";
-export function useMotion(ref) {
-    function animate(keyframes) {
-        const el = ref.current;
-        if (!el)
-            return () => undefined;
-        const safeEl = el;
-        const { opacity, x, y, scale, rotate, duration = 300, easing = "easeOut", delay = 0, onComplete, } = keyframes;
-        const easeFn = resolveEasing(easing);
-        let raf;
-        let startTime;
-        let cancelled = false;
-        function frame(ts) {
-            if (cancelled)
-                return;
-            startTime ??= ts + delay;
-            const elapsed = Math.max(0, ts - startTime);
-            const t = Math.min(elapsed / duration, 1);
-            const e = easeFn(t);
-            const transforms = [];
-            if (x)
-                transforms.push(`translateX(${String(x[0] + (x[1] - x[0]) * e)}px)`);
-            if (y)
-                transforms.push(`translateY(${String(y[0] + (y[1] - y[0]) * e)}px)`);
-            if (scale)
-                transforms.push(`scale(${String(scale[0] + (scale[1] - scale[0]) * e)})`);
-            if (rotate)
-                transforms.push(`rotate(${String(rotate[0] + (rotate[1] - rotate[0]) * e)}deg)`);
-            if (transforms.length)
-                safeEl.style.transform = transforms.join(" ");
-            if (opacity)
-                safeEl.style.opacity = String(opacity[0] + (opacity[1] - opacity[0]) * e);
-            if (t < 1) {
-                raf = requestAnimationFrame(frame);
-            }
-            else {
-                onComplete?.();
-            }
-        }
-        raf = requestAnimationFrame(frame);
-        return () => {
-            cancelled = true;
-            if (raf)
-                cancelAnimationFrame(raf);
-        };
-    }
-    return {
-        animate,
-        enter: (kf) => animate(kf),
-        exit: (kf) => animate({
-            ...kf,
-            opacity: kf.opacity ? [kf.opacity[1], kf.opacity[0]] : undefined,
-            x: kf.x ? [kf.x[1], kf.x[0]] : undefined,
-            y: kf.y ? [kf.y[1], kf.y[0]] : undefined,
-        }),
-    };
-}
-//# sourceMappingURL=use-motion.js.map

package/dist/use-motion.js.map

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

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

@@ -1,172 +0,0 @@
-// @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");
-  });
-});

package/src/use-motion.ts

@@ -1,89 +0,0 @@
-import { resolveEasing, type Easing } from "./easings";
-
-export interface MotionKeyframes {
-  opacity?: [number, number];
-  x?: [number, number];
-  y?: [number, number];
-  scale?: [number, number];
-  rotate?: [number, number];
-  duration?: number;
-  easing?: Easing;
-  delay?: number;
-  onComplete?: () => void;
-}
-
-export function useMotion(ref: { current: HTMLElement | null }) {
-  function animate(keyframes: MotionKeyframes): () => void {
-    const el: HTMLElement | null = ref.current;
-    if (!el) return () => undefined;
-    const safeEl = el;
-
-    const {
-      opacity,
-      x,
-      y,
-      scale,
-      rotate,
-      duration = 300,
-      easing = "easeOut",
-      delay = 0,
-      onComplete,
-    } = keyframes;
-    const easeFn = resolveEasing(easing);
-    let raf: number | undefined;
-    let startTime: number | undefined;
-    let cancelled = false;
-
-    function frame(ts: number) {
-      if (cancelled) return;
-      startTime ??= ts + delay;
-      const elapsed = Math.max(0, ts - startTime);
-      const t = Math.min(elapsed / duration, 1);
-      const e = easeFn(t);
-
-      const transforms: string[] = [];
-      if (x)
-        transforms.push(`translateX(${String(x[0] + (x[1] - x[0]) * e)}px)`);
-      if (y)
-        transforms.push(`translateY(${String(y[0] + (y[1] - y[0]) * e)}px)`);
-      if (scale)
-        transforms.push(
-          `scale(${String(scale[0] + (scale[1] - scale[0]) * e)})`,
-        );
-      if (rotate)
-        transforms.push(
-          `rotate(${String(rotate[0] + (rotate[1] - rotate[0]) * e)}deg)`,
-        );
-
-      if (transforms.length) safeEl.style.transform = transforms.join(" ");
-      if (opacity)
-        safeEl.style.opacity = String(
-          opacity[0] + (opacity[1] - opacity[0]) * e,
-        );
-
-      if (t < 1) {
-        raf = requestAnimationFrame(frame);
-      } else {
-        onComplete?.();
-      }
-    }
-
-    raf = requestAnimationFrame(frame);
-    return () => {
-      cancelled = true;
-      if (raf) cancelAnimationFrame(raf);
-    };
-  }
-
-  return {
-    animate,
-    enter: (kf: MotionKeyframes) => animate(kf),
-    exit: (kf: MotionKeyframes) =>
-      animate({
-        ...kf,
-        opacity: kf.opacity ? [kf.opacity[1], kf.opacity[0]] : undefined,
-        x: kf.x ? [kf.x[1], kf.x[0]] : undefined,
-        y: kf.y ? [kf.y[1], kf.y[0]] : undefined,
-      }),
-  };
-}