@humanspeak/svelte-motion 0.1.27 → 0.1.28

package/README.md

@@ -1,4 +1,4 @@
-# @humanspeak/svelte-motion
+# Svelte Motion — Framer Motion API for Svelte 5
 
 [![NPM version](https://img.shields.io/npm/v/@humanspeak/svelte-motion.svg)](https://www.npmjs.com/package/@humanspeak/svelte-motion)
 [![Build Status](https://github.com/humanspeak/svelte-motion/actions/workflows/npm-publish.yml/badge.svg)](https://github.com/humanspeak/svelte-motion/actions/workflows/npm-publish.yml)
@@ -32,7 +32,7 @@ npm install @humanspeak/svelte-motion
 </motion.button>
 ```
 
-## API parity snapshot (current)
+## Framer Motion API Parity
 
 Goal: Framer Motion API parity for Svelte where common React examples can be translated with minimal changes.
 

package/dist/html/_MotionContainer.svelte

@@ -168,6 +168,24 @@
         })
     }
 
+    // Capture mid-animation computed styles via rAF so exit clones can start
+    // from the correct visual state. Without this, interrupting an enter animation
+    // causes the exit to snap (the element is disconnected before onDestroy, so
+    // getAnimations()/commitStyles() can't work at clone time).
+    $effect(() => {
+        if (!(element && context)) return
+        let rafId: number
+        const capture = () => {
+            if (element && element.isConnected && element.getAnimations().length > 0) {
+                const cs = getComputedStyle(element)
+                context.updateChildAnimatedStyle(presenceKey, cs.opacity, cs.transform)
+            }
+            rafId = requestAnimationFrame(capture)
+        }
+        rafId = requestAnimationFrame(capture)
+        return () => cancelAnimationFrame(rafId)
+    })
+
     // Keep a live snapshot of the layoutId element's rect so the next element can FLIP from it.
     // We store the last-known-good rect and push it to the registry on cleanup,
     // because onDestroy fires after the element is removed from DOM (rect would be zeros).
@@ -985,6 +1003,9 @@
 
                     // Mark that we're triggering the initial animation to prevent duplicate runs
                     initialAnimationTriggered = true
+                    if (animateProp && typeof animateProp !== 'string') {
+                        lastAnimatePropJson = JSON.stringify(animateProp)
+                    }
 
                     // IMPORTANT: Start the animation BEFORE changing isLoaded.
                     // When isLoaded changes to 'ready', Svelte will reactively remove the

package/dist/index.d.ts

@@ -9,6 +9,8 @@ export type { DragAxis, DragConstraints, DragControls, DragInfo, DragTransition,
 export { useAnimationFrame } from './utils/animationFrame';
 export { createDragControls } from './utils/dragControls';
 export { useMotionTemplate } from './utils/motionTemplate';
+export { useMotionValue } from './utils/motionValue';
+export type { MotionValue } from './utils/motionValue';
 export { useMotionValueEvent } from './utils/motionValueEvent';
 export { useScroll } from './utils/scroll';
 export { useSpring } from './utils/spring';

package/dist/index.js

@@ -12,6 +12,7 @@ export { clamp, distance, distance2D, interpolate, mix, pipe, progress, wrap } f
 export { useAnimationFrame } from './utils/animationFrame';
 export { createDragControls } from './utils/dragControls';
 export { useMotionTemplate } from './utils/motionTemplate';
+export { useMotionValue } from './utils/motionValue';
 export { useMotionValueEvent } from './utils/motionValueEvent';
 export { useScroll } from './utils/scroll';
 export { useSpring } from './utils/spring';

package/dist/utils/motionValue.d.ts

@@ -0,0 +1,6 @@
+import { type Readable } from 'svelte/store';
+export type MotionValue<T = number> = Readable<T> & {
+    set: (v: T) => void;
+    get: () => T;
+};
+export declare const useMotionValue: <T = number>(initial: T) => MotionValue<T>;

package/dist/utils/motionValue.js

@@ -0,0 +1,13 @@
+import { writable } from 'svelte/store';
+export const useMotionValue = (initial) => {
+    let current = initial;
+    const store = writable(initial);
+    return {
+        subscribe: store.subscribe,
+        set: (v) => {
+            current = v;
+            store.set(v);
+        },
+        get: () => current
+    };
+};

package/dist/utils/presence.d.ts

@@ -31,6 +31,8 @@ export type AnimatePresenceContext = {
     registerChild: (key: string, element: HTMLElement, exit?: MotionExit, mergedTransition?: MotionTransition) => void;
     /** Update the last known rect/style snapshot for a registered child. */
     updateChildState: (key: string, rect: DOMRect, computedStyle: CSSStyleDeclaration) => void;
+    /** Update the last captured mid-animation style values for a child. */
+    updateChildAnimatedStyle: (key: string, opacity: string, transform: string) => void;
     /** Unregister a child. If it has an exit, clone and animate it out. */
     unregisterChild: (key: string) => void;
 };

package/dist/utils/presence.js

@@ -239,6 +239,17 @@ export const createAnimatePresenceContext = (context) => {
             child.lastComputedStyle = computedStyle;
         }
     };
+    /**
+     * Update the last captured mid-animation style values for a child.
+     * Called from a rAF loop while WAAPI animations are running.
+     */
+    const updateChildAnimatedStyle = (key, opacity, transform) => {
+        const child = children.get(key);
+        if (child) {
+            child.lastAnimatedOpacity = opacity;
+            child.lastAnimatedTransform = transform;
+        }
+    };
     /**
      * Unregister a child. If it has an `exit` definition, create a styled
      * clone and run the exit animation using Motion. Cleans up after finish.
@@ -316,6 +327,13 @@ export const createAnimatePresenceContext = (context) => {
         catch {
             // Ignore
         }
+        // Apply last captured mid-animation values (from rAF polling) so that
+        // exit clones start from the correct visual state when interrupting
+        // an enter animation. The element is disconnected by now so
+        // getComputedStyle/getAnimations won't reflect in-flight values.
+        if (child.lastAnimatedOpacity != null) {
+            clone.style.opacity = child.lastAnimatedOpacity;
+        }
         // Attach to original parent and position absolutely at the last known rect
         // Find the nearest positioned ancestor that isn't display: contents
         let parent = child.element.parentElement ?? document.body;
@@ -464,6 +482,7 @@ export const createAnimatePresenceContext = (context) => {
         onExitComplete: context.onExitComplete,
         registerChild,
         updateChildState,
+        updateChildAnimatedStyle,
         unregisterChild
     };
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@humanspeak/svelte-motion",
-  "version": "0.1.27",
-  "description": "A lightweight animation library for Svelte 5 that provides smooth, hardware-accelerated animations. Features include spring physics, custom easing, and fluid transitions. Built on top of the motion library, it offers a simple API for creating complex animations with minimal code. Perfect for interactive UIs, micro-interactions, and engaging user experiences.",
+  "version": "0.1.28",
+  "description": "A Framer Motion-compatible animation library for Svelte 5 that provides smooth, hardware-accelerated animations. Features include spring physics, custom easing, and fluid transitions. Built on top of the motion library, it offers a simple API for creating complex animations with minimal code. Perfect for interactive UIs, micro-interactions, and engaging user experiences.",
   "keywords": [
     "svelte",
     "animation",
@@ -12,7 +12,18 @@
     "svelte5",
     "hardware-accelerated",
     "micro-interactions",
-    "performance"
+    "performance",
+    "framer-motion",
+    "framer-motion-svelte",
+    "gestures",
+    "exit-animation",
+    "animate-presence",
+    "layout-animation",
+    "drag",
+    "variants",
+    "sveltekit",
+    "typescript",
+    "svelte-animation"
   ],
   "homepage": "https://motion.svelte.page",
   "bugs": {
@@ -62,20 +73,19 @@
     "@eslint/js": "^10.0.1",
     "@playwright/test": "^1.58.2",
     "@sveltejs/adapter-auto": "^7.0.1",
-    "@sveltejs/kit": "^2.53.0",
+    "@sveltejs/kit": "^2.53.3",
     "@sveltejs/package": "^2.5.7",
     "@sveltejs/vite-plugin-svelte": "^6.2.4",
     "@tailwindcss/aspect-ratio": "^0.4.2",
     "@tailwindcss/container-queries": "^0.1.1",
     "@tailwindcss/forms": "^0.5.11",
-    "@tailwindcss/postcss": "^4.2.0",
+    "@tailwindcss/postcss": "^4.2.1",
     "@tailwindcss/typography": "^0.5.19",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/svelte": "^5.3.1",
-    "@types/node": "^25.3.0",
+    "@types/node": "^25.3.2",
     "@vitest/coverage-v8": "^4.0.18",
-    "concurrently": "^9.2.1",
-    "eslint": "^10.0.1",
+    "eslint": "^10.0.2",
     "eslint-config-prettier": "10.1.8",
     "eslint-plugin-import": "2.32.0",
     "eslint-plugin-svelte": "3.15.0",
@@ -86,6 +96,7 @@
     "html-void-elements": "^3.0.0",
     "husky": "^9.1.7",
     "jsdom": "^28.1.0",
+    "mprocs": "^0.8.3",
     "prettier": "^3.8.1",
     "prettier-plugin-organize-imports": "^4.3.0",
     "prettier-plugin-sort-json": "^4.2.0",
@@ -93,16 +104,16 @@
     "prettier-plugin-tailwindcss": "^0.7.2",
     "publint": "^0.3.17",
     "runed": "0.37.1",
-    "svelte": "^5.53.2",
-    "svelte-check": "^4.4.3",
+    "svelte": "^5.53.5",
+    "svelte-check": "^4.4.4",
     "svg-tags": "^1.0.0",
     "tailwind-merge": "^3.5.0",
     "tailwind-variants": "^3.2.2",
-    "tailwindcss": "^4.2.0",
+    "tailwindcss": "^4.2.1",
     "tailwindcss-animate": "^1.0.7",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.56.0",
+    "typescript-eslint": "^8.56.1",
     "vite": "^7.3.1",
     "vite-tsconfig-paths": "^6.1.1",
     "vitest": "^4.0.18"
@@ -135,7 +146,7 @@
     "cs:publish": "pnpm run build && changeset publish",
     "cs:version": "changeset version && pnpm i --lockfile-only",
     "dev": "vite dev",
-    "dev:all": "concurrently -k -n pkg,docs,sitemap,registry -c green,cyan,magenta,yellow \"pnpm -w -r --filter @humanspeak/svelte-motion run dev\" \"pnpm --filter docs run dev\" \"pnpm --filter docs run sitemap:watch\" \"pnpm --filter docs run registry:watch\"",
+    "dev:all": "mprocs",
     "dev:pkg": "svelte-kit sync && svelte-package --watch",
     "format": "prettier --write .",
     "generate": "tsx scripts/generate-html.ts",