Changelog

Changed

• pinch: Snap points use velocity-based prediction to calculate rotation snap point.
• pinch: Configure transform origin between element-relative origin and pointer center.

Added

• pinch: Multitouch pinch and rotate gestures.

Fixed

• animate: Fix not recognising timeline of only nested sequences as timeline.
• Various performance-related improvements.

Added

• press: count, hold and repeat, for double/triple press, long press and multipress gestures.
• drag: Expose getProps on the dragConstraints function context.
• drag: x/y props for headless gesture tracking.
• Reorder: Home and End buttons move selected item to beginning and end of list, respectively.
• motion: New tap prop for configuring press gesture.

Fixed

• animate: Minor fixes.

Added

• Ensure accelerated transform animations finish correctly.
• AnimatePresence: Fix exit never starting when a child mounts already exiting.
• AnimatePresence: Fix exit stuck after an open layoutId card switches to another item.
• Ensure accelerated animations are cleaned up in WebKit.

Added

• PresenceContext: Added internal keepValuesOnRemount option for internal use.
• dragConstraints: Accepts function for internal use.
• Reorder: Keyboard accessibility now focuses just the first item, arrows move focus, arrow keys work in relation to how items are presented on-screen.

Added

• transition: Added mixer option for passing custom mixer functions.

Fixed

• Only counts projection stats while recordStats() is running.
• Fix accelerated animations stuck at initial after remount.
• drag: 20% smaller.
• m component: 6% smaller.
• Keep timeline adjustments within timeline scope.
• Reorder

Fixed

• Demote transforms to CPU when interrupted by layout animations.

Added

• animate: Mutable timeline sequences.
• animate: Relative label offsets for timeline sequences.
• useScroll: Returns scrollXLength and scrollYLength.
• Reorder: Add LazyMotion-compatible import.
• motion: transition.out prop for transitions when exiting a state.

Fixed

• Fix one flash when changing playback speed of accelerated independent transform.
• AnimatePresence: Improved positioning of popped elements.
• spring: Fix overdamped springs snapping to target.
• drag: Ref-constraints kept up-to-date after scroll.
• motion: Animate layoutId elements relative to layoutRoot container.
• motion: Bundle size reductions.
• Moving background-color animations back to main thread for improved interpolation.
• drag: Fix drag inertia stopping dead after a fast flick from a standstill.
• layout: layoutId elements now animate relative to their closest layoutRoot ancestor, if any.
• layout: layoutId may be changed after mount.
• useScroll: Fix tracking in horizontal containers.
• useSpring: Reduced bundle size by 30%.

Added

• Reorder: Grab-and-move keyboard reordering.
• processFrame: Manually process the frameloop at t.
• stepFrames: For tests, synchronously advance frameloop time by duration.

Fixed

• Improved tree-shaking.
• motion: Fix layoutId elements jumping in some situations.
• Reorder: Make auto-scroll speed independent of refresh rate.
• drag: Fix animations when disabling drag from within onDrag.
• Fix shared layout animations applying an element's own scale/x/y twice.
• Fix replaying mount animation when an element takes over a layoutId.
• motion: Fix updating SVG styles.
• useTransform: Improving value resolution.

Added

• scopeMotion/useScopeMotion: Scope animations and gestures to set default transitions, specify root elements, match media, and easy cleanup.
• Reorder: Pass moved to onReorder as second argument.

Fixed

• drag: With direction lock, apply the move that sets the lock. Before, a fast drag released in that frame didn't move.
• press: Improve cleanup of keyboard accessibility events.
• Reorder: Stop double-counting window scroll during drag.
• motion: Ensure we animate from the latest props when parent Activity is made visible.
• useInView: Observe ref if contents change after mount.

Added

• drag: Drag gesture added to JavaScript API.

Fixed

• AnimatePresence: Fire onExitComplete after exiting children unmount.
• AnimatePresence: popLayout children that don't accept ref are now popped when root component is <motion> element.
• Fix interpolation of axis rotate and skew transforms during shared layout animation.
• Fix layout animations when layout is enabled after mount.
• Fix drag jumping to 0 after animate x/y to CSS variable.
• arc: Fix path animations with animate.
• Ensure shared elements are freed from memory when unmounted.
• Fix accelerated independent transform animations vanishing when they start from a float residue.

Added

• stagger: New grid, from: "edges" | "random" options.
• Support for scaleZ.

Fixed

• Fix matrix3d and other digit-named transform functions being tokenised as numbers.
• useSpring: Ensure when switching targets we animate to the new target on switch.
• Fix SVG MotionValue children being written as a children attribute.

Added

• Hardware accelerated independent transforms like x, y, scaleX etc.

Fixed

• Fix velocity hand-off for hardware-accelerated springs.
• cubicBezier: More accurate, 2x faster.
• Reorder: Fix click events on reoredered items.
• useTransform: Fix desync when source is set in an effect under Strict Mode.

Added

• animateLayout: Layout animations for vanilla JS.

Fixed

• Delay animation start when main thread held to prevent visual jumps.
• Fix whileHover/whileTap getting stuck after Fast Refresh reorders siblings.
• scroll/useScroll: Fix reporting of elastic overscroll.
• AnimatePresence: Fix popLayout when rendering into another window or iframe.
• animate: Fix JS animations jumping ahead when played after a pause at non-1 speed.
• Allow layout animations inside dragged elements.

Changed

• Removed internal APIs restored in 13.5.1 for compatibility with framer-motion 13.0–13.4. Future removed internal APIs won't cause cross-compatibility issues since pinning internal framer-motion, motion-dom and motion-utils dependencies.

Changed

• <motion>: Fall back to the attribute in readSVGValue when computed style is empty.
• <motion>: Internal changes to animateChanges for size reductions.

Fixed

• scroll: Temporarily reverted removal of internal observeTimeline API to fix compatibility with previous 13.x APIs. Moving to pinned dependencies before removing in 14.x.
• styleEffect: Cleaning up an earlier value no longer removes a value that was bound to the same key after it.
• svgEffect: No longer writes transforms and origins as attributes.
• <motion>: inherit={false} now correctly not inheriting parent animations.
• <motion>: Fix sortNodePosition throwing when a sibling hasn't mounted

Added

• spring: Now accepts negative bounce (0--1) to define overdamped springs.

Changed

• <m>: 20% smaller.
• useSpring: 10% smaller.
• scroll/useScroll: Use main thread for all offset animations.

Fixed

• Ensure warning and error messages are cleaned from production build.
• Ensure values are never rendered before they've been resolved.

Changed

• scroll/useScroll: More offsets are now hardware accelerated via ViewTimeline.

Fixed

• animate: Reduced size of Motion Studio introspection call.
• useTransform: Accelerated values now correctly clamp.
• scroll/useScroll: Ensure offsets work the same across the JS main thread and ViewTimeline.
• scroll/useScroll: Remove ScrollTimeline/ViewTimeline observer in favour of main-thread scroll tracking.

Fixed

• AnimatePresence: mode="wait" no longer drops new children if exit completes during a React transition.

Fixed

• layout: Fix relative child jumping when parent interrupts layout animation.
• AnimatePresence: Can no longer drop a child added while another exit animation completes.
• Reorder: Only clear Reorder.Group's reorder guard when values change.
• spring/useSpring: 5% smaller.