Motion 3D

An open source motion library for React Three Fiber.

Motion powers Framer, the web builder for creative pros. Design and ship your dream site. Zero code, maximum speed.

It looks like this:

<motion.boxGeometry animate={{ x: 0 }} />

It does all this:

• Springs
• Keyframes
• Gestures (tap/hover)
• Exit animations
• Orchestrate animations across components

...and a whole lot more.

📚 Docs

Check out our documentation for guides and a full API reference.

Or check out our examples for inspiration.

🛠 Contribute

Want to contribute to Motion 3D? Our contributing guide has you covered.

👩🏻‍⚖️ License

Motion 3D is MIT licensed.

Framer

Get on the same page as your designers before production. Get started with design and prototyping in Framer.

Changelog

Motion adheres to Semantic Versioning.

Undocumented APIs should be considered internal and may change without warning.

[12.4.7] 2025-02-20

Fixed

• Fixed AnimatePresence not triggering exit animations when a child with layout or drag is removed.

[12.4.6] 2025-02-20

Fixed

• Fixed drag gesture on child elements.

[12.4.5] 2025-02-19

Fixed

• Fixed onClick handlers not working inside press events.

[12.4.4] 2025-02-18

Fixed

• Changed press, drag and pan gestures to use pointer capturing for better usage within iframe embeds.

[12.4.3] 2025-02-12

Fixed

• Restored warning for when animating more than two keyframes with a spring.

[12.4.2] 2025-02-10

Fixed

• Preventing press from triggering when an element is disabled.

[12.4.1] 2025-02-06

Fixed

• Check for transition in initial when animating removed values.

[12.4.0] 2025-02-06

Added

• Added initial option to useInView.

[12.3.1] 2025-02-05

Fixed

• Correctly applying CSS variables at the end of a mini animate animation.

[12.3.0] 2025-02-05

Added

• Added usePresenceData to get custom data passed to AnimatePresence in descendant components.

[12.2.0] 2025-02-05

Added

• Added unit support to useSpring.

[12.1.0] 2025-02-04

Fixed

• Bug with AnimatePresence in React 19 strict mode.

Deprecated

• Motion 3D.

[12.0.11] 2025-02-03

Fixed

• Moving updateSVGDimensions to its own file to help with tree-shaking.

[12.0.10] 2025-02-03

Fixed

• Providing MotionValue to motion component from motion/react-client entrypoint.

[12.0.9] 2025-02-03

Fixed

• Removing React from bundle.

[12.0.8] 2025-02-03

Fixed

• Infer type of children prop for motion.create.

[12.0.7] 2025-01-28

Fixed

• Fixed SVG transform animations via animate.

[12.0.6] 2025-01-27

Fixed

• Discard layout projection snapshots if 0x0.

[12.0.5] 2025-01-24

Fixed

• Fix scale correction for CSS variables.

[12.0.4] 2025-01-24

Fixed

• Add scale correction for CSS variables.

[12.0.3] 2025-01-23

Fixed

• Fixed toggling between shared layout animations multiple times.

Added

• Added private anchorX prop to AnimatePresence.

Changed

• Simplified useSpring for smaller bundlesize.

[12.0.1] 2025-01-21

Fixed

• Prevent relative animations from restarting layout animations unnecessarily.

[12.0.0] 2025-01-20

Changed

• press, hover and inView now pass the target element as the first argument to the gesture start callback.

[11.18.2] 2025-01-20

Fixed

• Animations with transformTemplate not hardware accelerated.

[11.18.1] 2025-01-17

Fixed

• AnimatePresence types in React 19.
• SVG with transform not always setting styles correctly on mount.

[11.18.0] 2025-01-14

Added

• Adding animateSequence to perform animation sequences via WAAPI for a tiny bundlesize.

Fixed

• Missing AnimationControls type export.

[11.17.1] 2025-01-13

Fixed

• Remeasure SVG when size/position changes to ensure correct transform-origin.

[11.17.0] 2025-01-10

Added

• Added propagate to AnimatePresence. This prop allows parent exit animations to be propagated to children.

Removed

• Removed exitBeforeEnter from AnimatePresence.

[11.16.7] 2025-01-10

Fixed

• Fixing timelines where a string label is used as the first segment.

[11.16.6] 2025-01-10

Changed

• More movement values like height and top are now blocked by reduced motion.

[11.16.5] 2025-01-09

Fixed

• Fixed scroll progress being stuck at 1 when a target is 100vh.

[11.16.4] 2025-01-09

Fixed

• Fix type of attachTimeline when skipLibCheck is disabled.

[11.16.3] 2025-01-09

Fixed

• Checking return of press, hover, and inView callbacks before calling.

[11.16.2] 2025-01-09

Fixed

• Restoring missing type exports.

[11.16.1] 2025-01-08

Fixed

• Adding displayName to motion components.
• Ensure press doesn't override tabindex when explicitly set.

[11.16.0] 2025-01-06

Added

• Added view() alpha to early access.

[11.15.0] 2024-12-13

Added

• Add support for repeat in animation sequences.

Fixed

• Clearing scheduled jobs at the end of an animation frame to ensure memory is released should the animation loop settle.

[11.14.4] 2024-12-13

Fixed

• Exporting AnimationSequence via "motion" entrypoint.
• Adding support for passing normal components to motion.create() in React 19.

[11.14.3] 2024-12-13

Fixed

• Fixing motion-dom and motion-utils entrypoints.

[11.14.2] 2024-12-13

Fixed

• Exporting time for internal use.
• Making MotionValue.updatedAt public for internal use.

[11.14.1] 2024-12-12

Fixed

• Fixing missing license in motion-dom and motion-utils packages.

[11.14.0] 2024-12-12

Added

• Added press gesture in Motion+ early access.

[11.13.6] 2024-12-10

Fixed

• Adding React 19 to optional peer dependencies in "motion" package also.

[11.13.5] 2024-12-10

Fixed

• Adding React 19 to optional peer dependencies in "framer-motion" packages.

[11.13.4] 2024-12-10

Fixed

• Fixing types for React 19.

[11.13.3] 2024-12-09

Fixed

• Attempting to update types to be compatible with both React 18 and 19.

[11.13.2] 2024-12-04

Fixed

• Hover gesture now always passive: true.

[11.13.1] 2024-12-03

Fixed

• SVG elements (like motion.text) now update when given a MotionValue as children, matching HTML element behavior.
• Exporting DynamicAnimationOptions type.

[11.13.0] 2024-12-03

Added

• Vanilla hover gesture in Motion+ early access.

[11.12.0] 2024-11-27

Added

• New visualDuration option for spring animations.
• New spring(visualDuration, bounce) syntax.

[11.11.16] 2024-11-14

Fixed

• Fixing stagger with mini animate.

[11.11.16] 2024-11-14

Fixed

• Ensuring animations passed to scroll are scrubbed linearly.
• Fixing mini types entrypoint.
• Exporting easing types from "motion".

[11.11.15] 2024-11-13

Fixed

• Fixing mini and react-mini entrypoints.

[11.11.14] 2024-11-12

Fixed

• Fixing fallback entry points for "motion/react" etc.

[11.11.13] 2024-11-12

Fixed

• Fixing build and entry points for "motion".

[11.11.12] 2024-11-12

Changed

• Adding "motion" package.
• Replaced Motion One (see upgrade guide).

[11.11.11] 2024-10-31

Fixed

• Fixing double update() call on mount.

[11.11.10] 2024-10-25

Fixed

• Removing will-change from SSR.

[11.11.9] 2024-10-15

Changed

• will-change is now no longer automatically managed without useWillChange.

[11.11.8] 2024-10-11

Fixed

• Fixing fallback package.json for entrypoints in older versions of Node.

[11.11.7] 2024-10-09

Fixed

• Improving generic value signature for animate.

[11.11.6] 2024-10-09

Fixed

• Allowing generic motion value types in animate.

[11.11.5] 2024-10-09

Fixed

• Removed ability to define CSS variables on style without casting, as this was conflicting with React CSSProperties.

[11.11.4] 2024-10-08

Fixed

• Memoize AnimatePresence safeToRemove.
• Remove duplicate layout="size" annotation.

[11.11.3] 2024-10-08

Fixed

• Remove as any requirement for CSS variables.

[11.11.2] 2024-10-08

Fixed

• Make BezierDefinition readonly for easier definition outside a Transition.

[11.11.1] 2024-10-04

Fix

• Fixed optimised appear effects in granular Suspense environments.

[11.11.0] 2024-10-03

Added

• animate can now animate any object.

[11.10.0] 2024-10-02

Added

• delay with seconds now exported from "framer-motion/dom".

Fixed

• Only transform is added to will-change when a potentially layerising value is animated as opacity and filter will prematurely flatten preserve-3d.

[11.9.0] 2024-09-27

Added

• Mini animate and useAnimate functions.

[11.8.0] 2024-09-25

Added

• Easing functions now get compiled into linear() easings when animating via WAAPI.

[11.7.0] 2024-09-25

Added

• Added support for custom animation generators via type.

[11.6.0] 2024-09-24

Added

• Added info and element tracking to scroll.
• Added steps easing.

Changed

• Values added to will-change now stay there for their lifespan to prevent GPU thrashing and weird Safari subpixel jitters.

[11.5.6] 2024-09-20

Fixed

• Ensuring updating motion values during render doesn't lock rendering for an element.

[11.5.5] 2024-09-19

Fixed

• Changed values of child variants now animate even when the parent variant name hasn't changed.

[11.5.4] 2024-09-05

Fixed

• Improving tree-shakability.

[11.5.3] 2024-09-05

Fixed

• Reorder components now import motion proxy.

[11.5.2] 2024-09-04

Added

• Changing motion() deprecation warning to warnOnce.

[11.5.1] 2024-09-04

Added

• Exporting findSpring for internal use.

[11.5.0] 2024-09-04

Added

• motion.create() and m.create().

Deprecrated

• motion() and m().

[11.4.0] 2024-09-03

Added

• Support for React Server Components, including new entrypoints for motion and m components.

[11.3.31] 2024-08-29

Fixed

• Detects conflicts between optimised animations and rendered style.
• Resumes optimised animations where possible once layout measurements are complete.

[11.3.30] 2024-08-23

Fixed

• Removed double "change" handler on externally-provided MotionValues.

[11.3.29] 2024-08-21

Fixed

• Selective cancellation of optimised appear animations.

[11.3.28] 2024-08-15

Fixed

• Use startTime instead of elapsed to sync optimised animations.

[11.3.27] 2024-08-14

Changed

• Allow manual setting of startTime via animation options (currently for internal use only).

[11.3.26] 2024-08-14

Fixed

• Improving synchronisation between DOM animations on externally-provided MotionValues and internal MotionValues.
• Fixing unit conversion on DOM animations with externally-provided MotionValues.

[11.3.25] 2024-08-14

Changed

• Improve calculation of startTime to prefer the immediacy of animation creation over keyframe resolution, but fall back to the latter if the former would lead to a perceptual jump.

[11.3.24] 2024-08-08

Fixed

• Fixing incorrect version publish.

[11.3.23] 2024-08-07

Fixed

• Improving optimised appear animation check from data-appear-id to active recording of started animations.
• Only cancelling optimised appear animations from layout animations when they're animating transform.

[11.3.22] 2024-08-07

Fixed

• Fixing spring animations with explicit velocities that animate to their current value.

[11.3.21] 2024-07-27

Changed

• Removing default transforms from generated transform string provided to transformTemplate.

[11.3.20] 2024-07-27

Changed

• Improved performance of transform by up to 30% when providing many default transforms as MotionValues.

[11.3.19] 2024-07-27

Fixed

• Fixed problem with AnimatePresence not rerendering children unless their presence had changed.

[11.3.18] 2024-07-26

Fixed

• Improved correctness of AnimatePresence and made safe to use with concurrent rendering.

[11.3.17] 2024-07-24

Added

• domMin feature bundle.

[11.3.16] 2024-07-24

Changed

• Exporting UseScrollOptions type.

[11.3.15] 2024-07-24

Changed

• Improved types for inView()'s margin property.

[11.3.14] 2024-07-24

Fixed

• Wrapping usePresence's safeToRemove callback in useCallback leading to fewer re-renders.

[11.3.13] 2024-07-24

Fixed

• Fixing position: fixed layout animations while scrolling.

[11.3.12] 2024-07-23

Fixed

• Improving useSpring types so it accepts MotionValue<string> or MotionValue<number> but always returns MotionValue<number>.

[11.3.11] 2024-07-23

Fixed

• Removing "react" import from DOM-only bundle.

[11.3.10] 2024-07-23

Fixed

• Changing isBrowser check from document to window.

[11.3.9] 2024-07-23

Changed

• Improve performance of window.MotionDebug check.

[11.3.8] 2024-07-19

Changed

• Improve performance of layout animation calculated projection comparisons.

[11.3.7] 2024-07-18

Changed

• Active render scheduling check to prevent unnecessary Set lookups.

[11.3.6] 2024-07-17

Changed

• Minor performance improvements for layout animations.

[11.3.5] 2024-07-16

Fixed

• Ensuring DOM bundle doesn't include react and react-dom as dependencies.

[11.3.4] 2024-07-16

Changed

• Check for display: contents elements now against component props instead of Element.style.

[11.3.3] 2024-07-16

Changed

• Frameloop now uses a single Set vs Set and Array, leading to smaller bundlesize and better performance under heavy load.

[11.3.2] 2024-07-11

Fixed

• No longer adding background-color to will-change.

[11.3.1] 2024-07-11

Updated

• Externally-provided MotionValues are no longer permanently added to will-change.

[11.3.0] 2024-07-10

Updated

• Animations automatically optimised via will-change.

[11.2.14] 2024-07-09

Updated

• Improved performance of core render loop.

[11.2.13] 2024-07-04

Fixed

• Checking for null before interpolating color values.

[11.2.12] 2024-06-25

Fixed

• Fixing dragConstraints={ref} mixed with layout animations.

[11.2.10] 2024-05-31

Fixed

• Changing invalid number interpolation from error to warning and immediate mix.

[11.2.9] 2024-05-29

Fixed

• Fixing animation of CSS variables when leading space is present.

[11.2.8] 2024-05-29

Fixed

• Ensuring instant animations return animation controls.

[11.2.7] 2024-05-29

Fixed

• Only allow layout animations to cancel optimised appear animations when on the same node or an ancestor.

[11.2.6] 2024-05-22

Fixed

• Fixed optimised appear animations interrupted by layout animations triggered by a state update within useLayoutEffect.

[11.2.5] 2024-05-21

Fixed

• Fixing layout animations within portals. Tag motion root within portal with data-framer-portal-id attribute.

[11.2.4] 2024-05-16

Fixed

• Batching triggering animations with useSpring.

[11.2.3] 2024-05-16

Fixed

• MotionValues created with undefined can track velocity correctly.

[11.2.2] 2024-05-15

Fixed

• Fixed visual jump when interrupting an optimised appear animation.

[11.2.1] 2024-05-15

Changed

• Improved performance of resolving variants by lazy resolving current MotionValue state.

[11.2.0] 2024-05-14

Added

• Binary visibility interpolation i.e display: ["block", "none"] now maintains the visible state throughout the animation.

[11.1.9] 2024-05-07

Changed

• Reinstating async event handlers to fix issues with user code and Suspence within Framer.

[11.1.8] 2024-05-06

Fixed

• Animating between keyframe unit types when one keyframe is 0 and the other is an explicitly defined keyframe, e.g y: ["100%", 0].

[11.1.7] 2024-04-19

Changed

• Updating types for motion.div.

[11.1.6] 2024-04-19

Changed

• Binding stop to MainThreadAnimation

[11.1.5] 2024-04-18

Changed

• Exporting DOMMotionComponents.

[11.1.4] 2024-04-18

Fixed

• Fixing types of motion.div in certain TS5 environment configurations.

Changed

• Skip removal of existing motion value when undefined.

[11.1.3] 2024-04-17

Fixed

• ESM compat with CJS bundle.

[11.1.2] 2024-04-16

Fixed

• Ensuring transforms unset during unit conversion are restored.

[11.1.1] 2024-04-16

Changed

• Updating JSX transform.

[11.1.0] 2024-04-16

Changed

• TypeScript 5 upgrade.

[11.0.28] 2024-04-11

Fixed

• Ensure CSS var token is set as final animation keyframe.

[11.0.27] 2024-04-10

Fixed

• Skipping animations with duration: 0.

[11.0.26] 2024-04-10

Fixed

• Adding perspective() to projection transform.
• Changing scheduling of useTransform to ensure frames are up-to-date.

[11.0.25] 2024-04-03

Fixed

• Ensuring motion(Fragment) nodes are skipped from layout projection.

[11.0.24] 2024-03-29

Fixed

• Changes in style are visible once a value is no longer present in animation props.

[11.0.23] 2024-03-28

Fixed

• Fixed layout animations when combined with z transforms.

[11.0.22] 2024-03-26

Fixed

• Fixed pre-generation of no-op WAAPI animations.

[11.0.21] 2024-03-26

Fixed

• Fixed interrupting WAAPI spring animations.

[11.0.20] 2024-03-21

Fixed

• Fixed interrupting shared element animations that contain rotate or skew transforms.

[11.0.19] 2024-03-21

Fixed

• Fixed layout animations when combined with skew transforms.

[11.0.18] 2024-03-20

Fixed

• Default duration doesn't override duration: 0 WAAPI animations.
• Fix error when trying to animate unmounted element.
• Avoid resolving WAAPI animation when stopping unresolved animation.

[11.0.17] 2024-03-20

Fixed

• Interruption of WAAPI animations now animates from correct value.

[11.0.16] 2024-03-20

Fixed

• Restored animation promise handling to match behaviour of <11.0.11.

[11.0.15] 2024-03-19

Fixed

• Fixed measurements when more than one transform changes unit type.

[11.0.14] 2024-03-15

Fixed

• Fixed animation controls in instances where keyframes resolve to be unanimatable.

[11.0.13] 2024-03-13

Added

• Added default value types for backgroundPositionX and backgroundPositionY.

Fixed

• Fixed height: auto animations.

[11.0.12] 2024-03-12

Fixed

• Updated @emotion/is-valid-prop as peer dependency.

[11.0.11] 2024-03-12

Changed

• Keyframes now resolved asynchronously.
• External event handlers now fired synchronously.
• CSS variables and unit conversion now supported with >2 keyframe animations.
• Removed WAAPI animation of background-color.

[11.0.10] 2024-03-12

Fixed

• Improved speed and stability of regexes.

[11.0.9] 2024-03-12

Added

• Added support for Content Security Policy (CSP) nonces via MotionConfig.

[11.0.8] 2024-02-29

Fixed

• Ensure optimised appear animations are cancelled before layout animation measurements.

[11.0.7] 2024-02-29

Fixed

• Strip comments from strings before testing if they're CSS variables to prevent significant performance degradation.

[11.0.6] 2024-02-23

Updated

• Added support for motion(Fragment) for controlling variants. For internal Framer use only.

[11.0.5] 2024-02-13

Updated

• Performance updates.

[11.0.4] 2024-02-13

Fixed

• Tighten check for navigator.userAgent.

[11.0.3] 2024-01-24

Fixed

• Fixed layout animation bug in Framer.

[11.0.2] 2024-01-23

Fixed

• Fixed velocity calculations when interrupting WAAPI animations.

[11.0.1] 2024-01-23

Removed

• Support for internal transformValues prop.

[11.0.0] 2024-01-23

Changed

• Replaced velocity-check jobs in favour of passive detection.
• Post-commit render moved to a microtask.

[10.18.0] 2024-01-10

Added

• globalTapTarget for use in Framer.

[10.17.12] 2024-01-09

Fixed

• Fixed animate sequencing for MotionValues.

[10.17.11] 2024-01-09

Fixed

• Fixed layout prop crashing Motion 3D.

[10.17.10] 2024-01-05

Fixed

• Export UseInViewOptions.

[10.17.9] 2024-01-05

Fixed

• Improve error message when trying to animate multiple keyframes via spring.

[10.17.8] 2024-01-05

Fixed

• Adding null safeguard for useAnimationControls.

[10.17.7] 2024-01-05

Fixed

• Fix touch event filtering for hover gesture.

[10.17.6] 2024-01-04

Fixed

• Ensure cancelled WAAPI animations can't finish.

[10.17.5] 2024-01-04

Fixed

• Fixing final keyframe when using repeatType "reverse" and "mirror".
• Display warning if scroll container is position: static.
• Move more scroll measurements to read frame lifecycle.
• Adding amount to useInView dependencies.

[10.17.4] 2024-01-03

Fixed

• Ensure keyframe animations don't rerun if all values are the same.

[10.17.3] 2024-01-03

Fixed

• Unset gestures correctly animate back to values defined in parent variant.

[10.17.2] 2024-01-03

Fixed

• Fixed issues with duration-based springs appearing stuck or snapping.

[10.17.1] 2024-01-03

Fixed

• Fixed issue with dragSnapToOrigin not continuing animation when interrupted.

[10.17.0] 2024-01-01

Added

• Adding MotionGlobalConfig.skipAnimations to globally disable animations when testing.

[10.16.16] 2023-12-08

Fixed

• circInOut easing fixed.
• Improved optimised animation handoff.

[10.16.15] 2023-12-07

Fixed

• Ensure animateChanges only runs in layout effect in initial render.

[10.16.13] 2023-12-05

Fixed

• Ensure animations don't attempt to fire when initial equals animate.

[10.16.13] 2023-12-05

Fixed

• Improved animation skipping for keyframe lists.

[10.16.12] 2023-12-01

Fixed

• Use single animation to detect document paint ready before triggering optimised animations.
• Measure one time for optimised animation start and one for handoff to emulate frame scheduling.

[10.16.11] 2023-12-01

Fixed

• Ensure animation is never skipped if it's an interrupting animation.

[10.16.10] 2023-11-30

Fixed

• Fixing appear animation optimisation when React portal is present.

[10.16.9] 2023-11-30

Fixed

• Skipping no-op animations.

[10.16.8] 2023-11-29

Fixed

• Added disableInstantAnimation private API.
• Ensure optimised appear animations don't run post-hydration.

[10.16.7] 2023-11-29

Fixed

• Fixing pan events within React portal.

[10.16.6] 2023-11-29

Fixed

• Fixing Reorder component types.
• Fixing Reorder.Item order calculation.
• Fixing broken dragConstraints if component re-renders during resize.

[10.16.5] 2023-11-14

Fixed

• Fixing AnimatePresence fast rerender bug.

[10.16.4] 2023-09-05

Fixed

• Changed handoff startTime source from performance.now() to document.timeline.currentTime.

[10.16.3] 2023-09-04

Fixed

• Improved compatibility of custom RefObject and MutableRefObject types.
• Fixing useScroll dependencies array.
• Fixing optimised handoff to WAAPI animations.

[10.16.2] 2023-08-30

Fixed

• Improved performance of frameloop scheduling.
• Fixed crasher when using SVGs as scroll animation targets.

[10.16.1] 2023-08-21

Fixed

• SVGs mount read/writes are now batched.

[10.16.0] 2023-08-16

Added

• New function syntax for useTransform.

Improved

• Improved handoff animation performance.

[10.15.2] 2023-08-14

Fixed

• Numerical CSS variables are now read correctly.

[10.15.1] 2023-08-07

Fixed

• Replacing requestAnimationFrame timestamp with performance.now() to avoid timestamp bug in Chrome.

[10.15.0] 2023-07-28

Added

• Updated types for public inView API.

[10.14.0] 2023-07-27

Added

• scroll() now accepts animations from animate() to create hardware-accelerated animations.

[10.13.2] 2023-07-27

Fixed

• Removed animation resync for optimised animation handoff.
• Fixed offset not working with useScroll.

[10.13.1] 2023-07-24

Added

• Fixed subpixel layout rounding in Chrome.

[10.13.0] 2023-07-19

Added

• scroll(), a universal API for powering scroll-driven animations via ScrollTimeline.

[10.12.23] 2023-07-19

Fixed

• Fixing subpixel layout support in Webkit.

[10.12.22] 2023-07-17

Fixed

• Supporting subpixel layouts in layout animations.

[10.12.21] 2023-07-14

Fixed

• Transforming values if new values have been read from props.

[10.12.20] 2023-07-13

Fixed

• Fixing race condition with animation Promise.
• Attempt to read initial animation from props before reading from DOM.

[10.12.19] 2023-06-30

Fixed

• Fixing unit conversion for translateX/translateY.

[10.12.18] 2023-06-30

Fixed

• When layout animation is forced to be instant via useInstantTransition, ignore the delay option.

[10.12.17] 2023-06-23

Fixed

• Fixing useInstantTransition when called on subsequent frames.
• Fixing reverse animation with negative speed finishes too early when the time is set to the duration.

[10.12.16] 2023-05-24

Fixed

• Fixing unit conversion when animating translateX/translateY.

[10.12.15] 2023-05-24

Fixed

• Fixed timing bug when mixing layout prop and animate().
• Removing errant log from resolveConstraints.

[10.12.14] 2023-05-23

Fixed

• Ensure new layout components animate correctly on the first re-render.

[10.12.13] 2023-05-23

Fixed

• Fixed scale correction in elements that have finished layout animations.

[10.12.12] 2023-05-15

Fixed

• Ensuring zero units like "0px" can be used as keyframe templates.

[10.12.11] 2023-05-15

Fixed

• Fixing ending layout animations immediately on resize.

[10.12.10] 2023-05-10

Fixed

• Fixing persisting AnimatePresence child when exit animation is interrupted.

[10.12.9] 2023-05-05

Fixed

• Fixing jumpy layer when a layout changes after a pending animation has been scheduled.

[10.12.8] 2023-05-05

Fixed

• Moving layout animations to queueMicrotasks(), ensuring layout animations don't fire until all synchronous effects have executed.

[10.12.7] 2023-05-02

Fixed

• Improve handling of "none" keyframes.

[10.12.6] 2023-05-02

Fixed

• Fixing relative layout animations when mixing type: false and type: "tween", duration: 0.

[10.12.5] 2023-05-01

Changed

• Exporting visualElementStore for internal use.

[10.12.4] 2023-04-18

Fixed

• Fixing types for attrX, attrY and attrScale values.

[10.12.3] 2023-04-18

Fixed

• Fixing CSS variable interpolation inside complex strings.

[10.12.2] 2023-04-14

Added

• Support for attrScale. Animate the scale SVG attribute.

[10.12.1] 2023-04-14

Added

• Creating sync and cancelSync as legacy APIs for use within Framer.

[10.12.0] 2023-04-14

Added

• Exporting frame and cancelFrame as a public API.

[10.11.6] 2023-04-12

Fixed

• Fixed performance regression introduced with previous fix.

[10.11.5] 2023-04-11

Fixed

• Propagating relative nodes in layout animations.

[10.11.4] 2023-04-11

Fixed

• Fixing optimised transform animations.

[10.11.3] 2023-04-11

Fixed

• Calling .play() on finished animations now correctly restarts them.

[10.11.2] 2023-04-06

Fixed

• Fixing WAAPI offsets with springs in animation sequences.

[10.11.0] 2023-04-06

Added

• Adding springs to animation sequences.

Fixed

• Fixing "keyframes must be of same type" error with some animation

[10.10.0] 2023-03-29

Fixed

• Adding .duration to animate(). sequences.

[10.9.4] 2023-03-29

Fixed

• Removing log from useSpring.

[10.9.3] 2023-03-29

Fixed

• Improving scroll animation startup time.

[10.9.2] 2023-03-28

Fixed

• Fixing animation scope with animation sequences.

[10.9.1] 2023-03-24

Fixed

• Recalculating and rerendering relative targets when layout is remeasured.

[10.9.0] 2023-03-24

Added

• Animation sequencing.

[10.8.5] 2023-03-22

Fixed

• Fixed use of multiple easing functions with WAAPI animations.

[10.8.4] 2023-03-21

Changed

• Fixing from option in stagger().

[10.8.3] 2023-03-21

Changed

• Fixing duration: 0 animations never ending.

[10.8.2] 2023-03-21

Changed

• Further loosening animate() overloads.

[10.8.1] 2023-03-21

Changed

• Loosening animate() overloads.

[10.8.0] 2023-03-21

Added

• stagger()

Fixed

• SVG and SVG path types for animate().

[10.7.0] 2023-03-21

Changed

• Default transitions no longer need to be namespaced under default.

[10.6.1] 2023-03-20

Fixed

• Complex string types interpolate correctly with WAAPI spring easing.

[10.6.0] 2023-03-17

Added

• cancel(), complete() and speed to animate().

Changed

• "easeIn", "easeOut" and "easeInOut" easing functions are now WAAPI spec-compliant.

Fixed

• .stop() stops animations permanently.
• useSpring timing.
• animate() with repeat: 1 and repeatType "reverse" or "mirror" correctly applies final keyframe.

[10.5.0] 2023-03-16

Added

• useAnimate() provides a composable way to use animate().

[10.4.0] 2023-03-16

Added

• animate() now supports DOM elements and DOM selectors.

[10.3.4] 2023-03-16

Fixed

• Updating README.

[10.3.3] 2023-03-16

Fixed

• Using frame timestamp, when available, to sample time.

[10.3.2] 2023-03-15

Fixed

• Applying target CSS variable at the end of animation.

[10.3.1] 2023-03-14

Fixed

• Fixed time Promise on instant animation.

[10.3.0] 2023-03-14

Added

• time, play(), pause() and then() to animations created with animate().

[10.2.5] 2023-03-13

Fixed

• Adding de-opt to projection tree when relative target has changed.

[10.2.4] 2023-03-10

Changed

• Refactored animate to resolve for time instead of timeDelta.

Fixed

• delay will now apply to "inertia" animations.

[10.2.3] 2023-03-07

Fixed

• Unifying AnimationPlaybackControls types.
• Changing Feature type to fix Next build errors.

[10.2.2] 2023-03-07

Fixed

• Restoring DeprecatedLayoutGroupContext for legacy Smart Components in Framer.

[10.2.1] 2023-03-07

Fixed

• Passing low restSpeed and restDelta to useSpring().

[10.2.0] 2023-03-07

Added

• Vanilla JS entry point framer-motion/dom.

[10.1.0] 2023-03-06

Added

• Frame-batched event handlers. This means external event handlers are now batched on the next animation frame, allowing React to correctly batch state updates.

[10.0.2] 2023-03-05

Fixed

• Fixing "Non-numeric offset" error in older browsers.

[10.0.1] 2023-02-27

Changed

• Reducing keyframe pregeneration duration by 75%.

[10.0.0] 2023-02-24

Added

• background-color animations are now hardware accelerated.

Removed

• Removing fallback for IntersectionObserver. Use a polyfill for support in older browsers.
• Removed DeprecatedLayoutGroupContext.

Changed

• Using exitBeforeEnter with AnimatePresence now throws an error.
• Using value.onChange will now throw a warning with instructions to change to value.on("change", callback).
• Using AnimateSharedLayout now throws an error.

Fixed

• repeat: Infinity no longer de-opts from pre-generated WAAPI animations.

[9.1.7] 2023-02-24

Fixed

• Switching const enum for types.

[9.1.6] 2023-02-23

Added

• Exporting scroll for internal use inside Framer.

[9.1.5] 2023-02-23

Fixed

• Changing Feature<any> to Feature<unknown>.

[9.1.4] 2023-02-23

Fixed

• Fixing types of useScroll.

[9.1.3] 2023-02-23

Updated

• Limiting propagation of dirty projection nodes for improved layout animation performance.

[9.1.2] 2023-02-23

Updated

• Replacing type enum with const enum for smaller bundlesize.

[9.1.1] 2023-02-23

Updated

• Removing external dependencies.

[9.1.0] 2023-02-23

Added

• Hardware acceleration of clipPath, filter and transform styles.

[9.0.7] 2023-02-21

Fixed

• Improving types of color.parse().

[9.0.6] 2023-02-21

Added

• Exporting animation types for internal Framer use.

[9.0.5] 2023-02-21

Added

• Adding legacy Popmotion exports for internal Framer use.

[9.0.4] 2023-02-16

Updated

• 25% speed improvement for transform string creation.

[9.0.3] 2023-02-14

Updated

• Refactored motion component features to load without React components.
• Deprecated fallback behavior for missing IntersectionObserver.

[9.0.2] 2023-02-07

Changed

• Reorder.Item no longer throws an error within MotionConfig strict.

[9.0.1] 2023-02-02

Removed

• Tap events no longer suspend tabindex attribute for the duration of the gesture.

[9.0.0] 2023-02-01

Added

• Tap events are now keyboard accessible.

Changed

• whileFocus only triggers according to focus-visible rules.

[8.5.5] 2023-01-30

Fixed

• Ensuring Animation.cancel() is called on finished WAAPI animations.

[8.5.4] 2023-01-27

Fixed

• Reducing size of prop filtering.

[8.5.3] 2023-01-26

Fixed

• Manually recording optimised appear startTime to fix inaccuracies of Firefox's Animation.currentTime.

[8.5.2] 2023-01-23

Fixed

• Updated optimised appear animations to defer animations until Chrome releases paint holding.

[8.5.1] 2023-01-19

Fixed

• Changed restSpeed and restDelta defaults for granular spring animations.

[8.5.0] 2023-01-18

Added

• layoutRoot prop. When component has layout and layoutRoot props, it will perform layout animations instantly but all children will perform layout animations relative to it.

[8.4.7] 2023-01-18

Fixed

• Fixed right-click filtering.

[8.4.6] 2023-01-17

Fixed

• Fixed WAAPI deoptimisation with layout animations.
• Reduced number of animations triggered for components that have gesture event handlers but no corresponding while- props.

[8.4.5] 2023-01-17

Fixed

• Only trigger animateChanges in a useLayoutEffect when optimised appear animations are present.
• Resync optimised appear handoff animations before cancelling WAAPI animations to ensure seamless visual handoff.

[8.4.4] 2023-01-17

Fixed

• Filtering values prop.

[8.4.3] 2023-01-13

Fixed

• When in Reduced Motion mode, transition no longer overrides instant transitions.

[8.4.2] 2023-01-11

Fixed

• Events sourced from pointercancel no longer being added to pan gesture history.

[8.4.1] 2023-01-11

Fixed

• delay no longer getting doubled with pregenerated WAAPI keyframes.

[8.4.0] 2023-01-10

Added

• Exporting frameData and sync for internal Framer use.

[8.3.4] 2023-01-10

Fixed

• Detection of hex colors with alpha values within complex strings.

[8.3.3] 2023-01-09

Fixed

• Stop filtering pen hover events.

[8.3.2] 2023-01-09

Fixed

• Allow useMotionTemplate to accept static values.

[8.3.1] 2023-01-09

Fixed

• Memoisation of tap callbacks.

[8.3.0] 2023-01-09

Added

• motion components can accept a MotionValue as children.

[8.2.4] 2023-01-06

Fixed

• Stop applying scale correction to an element's styles when there's no active projection transform.

[8.2.3] 2023-01-06

Changed

• Improved memoisation of internal event handlers.

[8.2.2] 2023-01-06

Fixed

• Removed ability to trigger animations via useAnimationControls() during render lifecycle. This would be a source of silent or subtle errors.

[8.2.1] 2023-01-06

Fixed

• Variant transition fixed in Motion 3D.

[8.2.0] 2023-01-06

Added

• Exporting easing functions.

[8.1.9] 2023-01-05

Fixed

• Preventing infinite keyframe pre-generation.

[8.1.8] 2023-01-05

Fixed

• Sampling of animations with delay/repeat settings when interrupting WAAPI animations.

[8.1.7] 2023-01-04

Fixed

• Swapping style value between MotionValue and static value.

[8.1.6] 2023-01-04

Fixed

• Minification of process.env.NODE_ENV.

[8.1.5] 2023-01-03

Changed

• Display warning in development mode when Reduced Motion is enabled on device.

[8.1.4] 2023-01-03

Fixed

• Ensuring child variant components fire onAnimationStart when an animation is triggered by a parent.

[8.1.3] 2023-01-02

Fixed

• Fixed times.

[8.1.2] 2023-01-02

Fixed

• Fixed extends error in LayoutCamera and LayoutOrthographicCamera components.

[8.1.1] 2023-01-02

Fixed

• Fixing error when Transition.type is invalid.

[8.1.0] 2023-01-02

Added

• MotionValue.jump can be used to "jump" a MotionValue to a new value, bypassing active springs, ending current animations and resetting to velocity to 0.

[8.0.4] 2023-01-02

Fixed

• Cleaning up animations when a MotionValue has no active "change" subscribers.
• Changing useMotionValueEvent subscription to useInsertionEffect.

[8.0.3] 2023-01-02

Fixed

• Use range for tslib dependency.
• Fixing multitouch with drag and pan gestures.

[8.0.2] 2022-12-23

Fixed

• Fixing defaults for hardware-accelerated animations.

[8.0.1] 2022-12-21

Added

• Warning for unhydrated refs passed to useScroll() options.

[8.0.0] 2022-12-21

Removed

• Removed polyfilled support for mouse/touch events.
• Removed drag pointerup patch for Safari over <select /> elements.

Changed

• DragControls.start now accepts PointerEvent only.

[7.10.3] 2022-12-20

Changed

• Firing animateChanges in useLayoutEffect rather than useEffect to ensure optimised appear animations are handed off before paint.

[7.10.2] 2022-12-16

Fixed

• Adding support for all easing functions with WAAPI.

[7.10.1] 2022-12-16

Fixed

• Fixed type inference of useMotionValueEvent.

[7.10.0] 2022-12-15

Added

• .on() event method to MotionValue.
• "animationStart", "animationComplete", "animationCancel" and "change" events for MotionValue.
• useMotionValueEvent helper method for adding events.

[7.9.1] 2022-12-14

Fixed

• Fixing mapping Motion easing names to WAAPI.

[7.9.0] 2022-12-14

Added

• Hardware-accelerated opacity animations.

[7.8.1] 2022-12-14

Changed

• Refactored animation pipeline to better accomodate WAAPI.

[7.9.0] 2022-12-14

Added

• Hardware-accelerated opacity animations.

[7.8.1] 2022-12-14

Changed

• Refactored animation pipeline to better accommodate WAAPI.

[7.8.0] 2022-12-13

Added

• Added private APIs for starting initial animations before React hydration and handing off to the component after hydration.

[7.7.3] 2022-12-13

Fixed

• Fixed spring effect of useSpring.

[7.7.2] 2022-12-12

Removed

• Reduced ?? operators to reduce bundlesize.

[7.7.1] 2022-12-12

Changed

• Removed style-value-types and framesync as external dependencies.

[7.7.0] 2022-12-12

Added

• Added support for "startOffset", "textLength" and "lengthAdjust" SVG attributes.

Removed

• Removed ability to define "inertia" animation as "decay" (officially removed in 3.0.0).

Removed

• Removed legacy repeat options (officially removed in 3.0.0).

[7.6.19] 2022-12-05

Fixed

• Animation of viewBox for SVG elements.

[7.6.18] 2022-12-02

Changed

• Removed popmotion as external dependency.

[7.6.17] 2022-12-01

Fixed

• Manually firing callback with latest callback when useOnChange is provided new motion value (affects useSpring).

[7.6.16] 2022-12-01

Fixed

• Fixing useOnChange to resubscribe when provided a new motion value (affects useSpring).

[7.6.15] 2022-11-28

Fixed

• Rounding tree scale to 1 to prevent unnecessary scale transforms.

[7.6.14] 2022-11-28

Fixed

• Nothing to see here.

[7.6.12] 2022-11-24

Fixed

• isTransformDirty node skipping logic.

[7.6.11] 2022-11-24

Fixed

• Treat <motion.svg /> components as HTML.

Updated

• Further layout animation performance enhancements.

[7.6.10] 2022-11-24

Updated

• Removing read of (currently unused) position style as it's erroneously breaking a test in Framer.

[7.6.9] 2022-11-22

Updated

• Only updating projection calculations for dirty nodes.

[7.6.8] 2022-11-22

Updated

• Reducing number of scroll reads during layout animations.

[7.6.7] 2022-11-15

Fixed

• Removed instantiation of externally-provided motion values.

[7.6.6] 2022-11-11

Fixed

• Minor layout animation refactors.

[7.6.5] 2022-11-07

Fixed

• VisualElement changed to class implementation.
• Fixed issue with relative layout animations when switching relative parents.

[7.6.4] 2022-11-01

Fixed

• Updated buildTransform types to only expect required arguments.

[7.6.3] 2022-11-01

Added

• Exposing buildTransform for internal use.

[7.6.2] 2022-10-27

Added

• Internal option for useScroll to use useEffect instead of useLayoutEffect.

[7.6.1] 2022-10-18

Fixed

• Exporting CycleState and Cycle types.

[7.6.0] 2022-10-18

Added

• delay(): An alternative to window.setTimeout() that is locked to the animation framerate.

[7.5.4] 2022-10-17

Fixed

• Fixed bug relative layout animations within rotated layers.
• Fixed bug with layout="preserve-aspect" where layers that do change size but aren't moved are reprojected to the old size and stay there.

[7.5.3] 2022-10-04

Fixed

• If the initial style was derived from the initial prop, and that style is removed from animate, while also being removed from initial, it won't animate back to the originally-defined value.

[7.5.2] 2022-10-04

Fixed

• Gracefully handle undefined values in values prop.

[7.5.1] 2022-09-30

Fixed

• useTransform correctly cleans up any scheduled animation frames when it unmounts.

[7.5.0] 2022-09-27

Added

• useAnimationFrame now passes delta to provided callbacks as the second argument.

[7.4.0] 2022-09-26

Added

• Added internal values prop that allows the provision of motion values to use exclusively for performing animations on.

[7.3.6] 2022-09-20

Fixed

• Increasing threshold for what's considered a similar aspect ratio in "preserve-ratio" layout animations.

[7.3.5] 2022-09-14

Fixed

• isMotionValue no longer crashing when provided null.

[7.3.4] 2022-09-13

Fixed

• Run feature detection based on rendered props.

[7.3.3] 2022-09-13

Fixed

• Ensuring children dynamic components re-render when context changes.

[7.3.2] 2022-09-07

Added

• isMotionComponent returns true if the provided component is a motion component.
• unwrapMotionComponent returns the rendered component.

[7.3.1] 2022-09-07

Fixed

• Fixing application of rotateZ.

[7.3.0] 2022-09-06

Added

• layout="preserve-ratio" performs a position-only transition if the aspect ratio has changed.

Fixed

• layout="position" now works with shared element transitions.

[7.2.1] 2022-08-23

Added

• Various filesize reductions.

[7.2.0] 2022-08-14

Added

• AnimatePresence's new mode="popLayout" prop will "pop" exiting elements from the document layout flow, allowing sibling layout elements to animate to their new layout as soon as exiting starts.

Deprecated

• exitBeforeEnter - replace with mode="wait".

[7.1.2] 2022-08-16

Fixed

• Fixing useWillChange export.

[7.1.1] 2022-08-15

Changed

• Upping TypeScript output target to "ES6".

Updated

• `typescript@4.7`

[7.1.0] 2022-08-11

Added

• useWillChange for automatically managing the will-change style.

[7.0.3] 2022-08-11

Fixed

• Trimming CSS vars.

[7.0.2] 2022-08-11

Fixed

• Correctly parsing slash-delimited opacities within colors.
• Exporting types correctly for Typescript 4.7.

[7.0.1] 2022-08-10

Changed

• Replacing internal useId with React 18's useId.

[7.0.0] 2022-08-04

Updated

• react@18
• react-three-fiber@8

Fixed

• Drag to reorder items no longer jumping in React 18.

[6.5.2] 2022-07-27

Fixed

• Fix types for mixer option in useTransform.

Update

• `style-value-types@5.1.0`

[6.5.1] 2022-07-14

Fixed

• Adding onChange handlers in useTransform on useLayoutEffect.

[6.5.0] 2022-07-13

Added

• useScroll for creating scroll-linked animations.

Deprecated

• useViewportScroll and useElementScroll.

[6.4.3] 2022-07-08

Fixed

• Split module to improve ability to code-split and tree-shake <m> and domMax.

[6.4.2] 2022-07-06

Added

• useInView now automatically respects rootMargin within an iframe.

[6.4.1] 2022-07-05

Added

• Renaming useAnimation to useAnimationControls. useAnimation will stay as backwards compatible alias.

[6.4.0] 2022-07-05

Added

• useInView.

[6.3.16] 2022-06-27

Fixed

• Fixing layout animations within position: fixed elements. Provide position: fixed elements the layoutScroll prop to fix.

[6.3.15] 2022-06-24

Fixed

• Explicitly declaring children prop for components.

[6.3.14] 2022-06-24

Fixed

• Exposing more internal types.

[6.3.13] 2022-06-22

Fixed

• Fix some missing types by replacing @internalRemarks comment with @privateRemarks.

[6.3.12] 2022-06-21

Changed

• Rolling up published type definitions.

[6.3.11] 2022-06-08

Fixed

• Fixed scale correction during rotation & layout animations.

[6.3.10] 2022-06-03

Fixed

• Fixing version mismatch warning.

[6.3.9] 2022-06-03

Fixed

• Providing path to types via package.json's exports field to fix types in TypeScript 4.7.
• Safer process.env.NODE_ENV check.

[6.3.8] 2022-06-03

Fixed

• Restore scroll position after measuring height when doing unit conversion animation.

[6.3.7] 2022-06-03

Fixed

• Will display a warning if different versions of Motion are mixed.

[6.3.6] 2022-05-31

Fixed

• All events are now passive unless a user provides an explicit event listener.

[6.3.5] 2022-05-30

Fixed

• Added initial prop to Motion 3D types.

[6.3.4] 2022-05-25

Fixed

• Updating reducedMotion prop in MotionConfig now correctly updates throughout the tree.

[6.3.3] 2022-04-28

Fixed

• Re-enabling layout animations on svg elements.

[6.3.2] 2022-04-26

Fixed

• Fixing internal type errors in React 18.
• Adding deprecation notice to AnimateSharedLayout.

[6.3.1] 2022-04-22

Fixed

• SSR in Deno.

[6.3.0] 2022-04-14

Added

• Adding layout prop to Reorder.Item.
• onLayoutAnimationStart.

Fixed

• Ensure cycle is properly memoised.

[6.2.10] 2022-04-12

Fixed

• Fixed useSpring dependencies if properties change between renders.
• Fixed children types of AnimatePresence and LayoutGroup.

[6.2.9] 2022-04-06

Fixed

• Fixing process in ESM environments.

[6.2.8] 2022-02-23

Changed

• Fixing race conditions for variants changed by state vs by gesture.

[6.2.7] 2022-02-21

Changed

• Replaced undocumented LayoutGroup prop inheritId with inherit.

[6.2.6] 2022-02-10

Fixed

• Remove useId from React 18.

[6.2.5] 2022-02-08

Fixed

• Improving compatibility with React 18.

[6.2.4] 2022-02-03

Fixed

• Fixed layout animations with Framer's Stack gap Safari polyfill.

[6.2.3] 2022-01-25

Added

• Adding useReducedMotionConfig for internal Framer use.

[6.2.2] 2022-01-21

Fixed

• Fixing onBeforeLayoutMeasure.

[6.2.1] 2022-01-21

Added

• Ensure useReducedMotion detects reduced motion on load.

[6.2.0] 2022-01-21

Added

• reducedMotion option to MotionConfig.

[6.1.0] 2022-01-20

Added

• Added viewport.fallback option to disable IntersectionObserver polyfill.

[6.0.0] 2022-01-19

Changed

• framer-motion/three is now framer-motion-3d.

[5.6.0] 2022-01-12

Added

• isValidProp prop to MotionConfig that allows the injection of custom detection of valid React props.

[5.5.8] 2022-01-12

Fixed

• Removing transformTemplate prop correctly rerenders element.

[5.5.7] 2022-01-11

Fixed

• Fixing crossfade for % or px unit border radius. Issue

[5.5.6] 2022-01-07

Fixed

• MotionConfig propagates changes to transition.

[5.5.5] 2021-12-17

Fixed

• Using dpr prop in layout animation calculations.

[5.5.4] 2021-12-16

Fixed

• Improving performance of LayoutCamera.
• Removing data-projection-id in static mode.

[5.5.3] 2021-12-15

Fixed

• Improving performance of LayoutCamera and fixing final flash.

[5.5.2] 2021-12-15

Fixed

• Reimplemented dynamic resolution scaling for LayoutCamera.

[5.5.1] 2021-12-14

Fixed

• Removed dynamic resolution scaling from LayoutCamera to fix crash in iOS.

[5.5.0] 2021-12-14

Added

• LayoutCamera and LayoutOrthographicCamera.

[5.4.5] 2021-12-09

Fixed

• Passing MotionConfigContext through from DOM into 3D.

[5.4.4] 2021-12-08

Fixed

• Fixing variant animations across DOM and 3D boundaries via MotionCanvas.

[5.4.3] 2021-12-07

Fixed

• Fixing export paths. PR by @edoardolincetto.

[5.4.2] 2021-12-07

Fixed

• Sharing MotionContext across Motion and Motion 3D environments in CommonJS environments.

[5.4.1] 2021-12-06

Fixed

• 3D entry point overwriting ES modules with dropped exports.

[5.4.0] 2021-12-06

Added

• useAnimationFrame

[5.3.3] 2021-11-24

Fixed

• Fixing animating to CSS variables with SVGElement. Issue
• Unsetting z-index for resting Reorder.Item components. Issue
• Forward native drag listeners to draggable elements. Issue
• Authors can now support browsers without Proxy by using motion("div") syntax. Issue

[5.3.2] 2021-11-23

Fixed

• Ensuring forced renders are batched so sibling AnimatePresence renders are triggered together. Issue
• Viewport enter/leave event handlers are passed IntersectionObserverEntry or null if IntersectionObserver is not supported on the device. Issue
• No longer applying touch scroll-disabling styles if dragListener is set to false. Issue

[5.3.1] 2021-11-19

Added

• useInstantTransition hook for internal use.

Fixed

• Removing layoutDependency from forwarded props. Issue
• Reorder.Item correctly fires onDrag. Issue
• Fires onPressStart and onHoverStart after triggering animations.
• Replay keyframes when variant changes. Issue
• Correctly SSR final keyframe when initial is false.

[5.3.0] 2021-11-11

Added

• whileInView, onViewportEnter and onViewportLeave props.

[5.2.1] 2021-11-05

Fixed

• Fixing unit conversion for x and y styles. Issue

[5.2.0] 2021-11-04

Added

• Enable animation between hsla and rgba/hex.

Fixed

• Fixing HSLA color interpolation. Issue

[5.1.0] 2021-11-02

Added

• Adding path drawing support for circle, ellipse, line, path, polygon, polyline and rect components.
• Add SSR support for pathLength.

Fixed

• Fixed SSR for pathLength.
• Downgrading whileFocus to lowest gesture priority. Issue
• Fixed path length for elements with vectorEffect="non-scaling-stroke" Issue
• Stripping dragSnapToOrigin from DOM output. PR by @Evalon

[5.0.2] 2021-11-02

Fixed

• Convert x/y from percent to pixels before drag. Issue
• Dynamic functions passed to controls.start() can now return variant names. Issue
• Factors in padding when measuring elements for width/height unit conversion. Issue

[5.0.1] 2021-11-01

Added

• onAnimationStart is now called with the definition of the triggering animation.

Fixed

• Removing context memoisation to ensure removed values are correctly animated to.
• Adding unmount check to AnimatePresence before updating state. PR by @ctrlplusb
• Fixing types for multi-input useTransform. PR by @kena0ki
• Fixing staggerChildren for value-specific transitions. Issue
• Fixes animation between 0 and non-number/pixel keyframe array. Issue

[5.0.0] 2021-10-27

Added

• Reorder components to create drag-to-reorder interfaces.
• LayoutGroup allows namespacing layoutId and group elements that may affect each-other's layout on re-render.
• layoutDependency prop to restrict when components are measured.
• layoutScroll prop to hint to layout animations when a element is scrollable.
• Layout animations are auto-completed when the viewport resizes.
• layout="size" for size-only animations PR by @bhollis.

Fixed

• Various layout projection improvements.

Changed

• AnimateSharedLayout is deprecated.

[4.1.17] 2021-05-17

Fixed

• Fixing SVG gradientTransform.
• Removing hover event suspension during layout measurements.

[4.1.16] 2021-05-12

Fixed

• Use with changing external refs.

[4.1.15] 2021-05-11

Fixed

• Correctly firing onAnimationComplete when a spring animation defined by bounce and no duration is completed.

[4.1.14] 2021-05-11

Fixed

• Narrowing the edge cases within which drag could lock the projection viewport box.
• Comparing prev scale to correct axis.

[4.1.13] 2021-05-07

Fixed

• Call function ref if it changes between renders.

[4.1.12] 2021-05-07

Fixed

• Layout measurements for drag gesture don't happen until the gesture is confirmed to start.
• Prevent occasional flash when projection hasn't yet been hydrated.
• Unifying layout batcher between drag and layout animations.
• Suspending hover events globally during layout measurements.

[4.1.11] 2021-04-28

Fixed

• Layout projection fix.

[4.1.10] 2021-04-26

Fixed

• Allow a component to have transform reset before measuring child layout.

[4.1.9] 2021-04-23

Fixed

• Further nested drag improvements for external motion values.

[4.1.8] 2021-04-22

Fixed

• Nested drag improvements for external motion values.

[4.1.7] 2021-04-21

Fixed

• Nested drag improvements.

[4.1.6] 2021-04-20

Fixed

• Nested drag improvements.

[4.1.5] 2021-04-19

Fixed

• Layout projection improvements.

[4.1.4] 2021-04-19

Fixed

• Disabling hover events when a drag is active.

[4.1.3] 2021-04-07

Fixed

• Animating to/between 0rem and other non-specifically handled unit types.

[4.1.2] 2021-04-01

Fixed

• Clamping borderRadius to 0 and above during crossfade.

[4.1.1] 2021-04-01

Fixed

• Animating from undefined to number (including units) now animates from 0.

[4.1.0] 2021-03-31

Added

• Relative layout animations
• Adding transition.crossfade and transition.layout for crossfade and layout-specific transitions.

Fixed

• Various layout projection improvements.

[4.0.3] 2021-03-24

Fixed

• Replaced layout animation tree traversal with flat array traversal of just projecting elements.

[4.0.2] 2021-03-19

Fixed

• Various layout animation bugfixes.

Upgraded

• Upgraded popmotion, framesync, style-value-types and tslib to latest.

[4.0.1] 2021-03-23

Fixed

• Adding package.json to exports so it can be imported by Node.

[4.0.0] 2021-03-18

Added

• Added the new LazyMotion component to defer the loading of animations and gestures.

Removed

• The deprecated motion.custom(). Use motion() instead.

[3.10.6] 2021-03-18

Fixed

• Various variant bugs.

[3.10.5] 2021-03-15

Fixed

• Added specific default and require fields to the exports field for CJS compatibility.

[3.10.4] 2021-03-15

Added

• exports field to package.json.

Fixed

• useMotionValue now forces re-render on the Framer canvas when the underlying MotionValue updates.

[3.10.3] 2021-03-10

Fixed

• Reduced memory consumption in static mode by not loading VisualElement.

[3.10.2] 2021-03-09

Fixed

• Improved memory consumption of SubscriptionManager.

[3.10.1] 2021-03-09

Fixed

• New layout animations now only trigger when the target viewport box has changed.

[3.10.0] 2021-03-03

Added

• useVelocity.

[3.9.3] 2021-03-03

Fixed

• Exporting AnimationPlaybackControls and AnimationOptions for animate().
• Fixed passing dynamic function to controls.start().

[3.9.2] 2021-03-02

Fixed

• Crossfader now only returns values for the lead and follow components.

[3.9.1] 2021-03-02

Fixed

• Drag now passing velocity to useSpring correctly.

[3.9.0] 2021-03-02

Added

• dragElastic now accepts per-axis elastic settings.

[3.8.2] 2021-03-01

Fixed

• perspective now correctly set as its own style. transformPerspective still builds into transform.

[3.8.1] 2021-03-01

Changed

• Refactoring AnimationType is improve bundle-splitting.

[3.8.0] 2021-03-01

Fixed

• Code-splitting for Webpack.

[3.7.0] 2021-02-23

Added

• motion() creates custom motion components.
• forwardMotionProps boolean to optionally forward MotionProps to custom components.

Changed

• Custom motion components no longer forward MotionProps by default.

Deprecated

• motion.custom

Fixed

• Listing React 17 as a peerDependency.

[3.6.7] 2021-02-22

Fixed

• More permissive check for previously-unencountered values.

[3.6.6] 2021-02-22

Fixed

• Safer hasOwnProperty check for null values.

[3.6.5] 2021-02-22

Fixed

• Only fire onPanEnd if onPanStart has triggered.

[3.6.4] 2021-02-22

Fixed

• Adding polyfill performance.now in framesync.

[3.6.3] 2021-02-22

Fixed

• Only crossfading defined borderRadius borders during shared element transitions.

[3.6.2] 2021-02-20

Fixed

• AnimatePresence now correctly unmounts children if it contains no motion components.

[3.6.1] 2021-02-19

Fixed

• onAnimationComplete on child variant components now fire as expected.

[3.6.0] 2021-02-19

Added

• onAnimationComplete now provides the definition of the triggering animation.

[3.5.3] 2021-02-19

Fixed

• Fixing bug with afterChildren and exit animations.

[3.5.2] 2021-02-18

Added

• Setting sideEffects: false in package.json to help code splitting in Webpack.

[3.5.1] 2021-02-18

Fixed

• onTapCancel is now being correctly cleaned up.

[3.5.0] 2021-02-18

Added

• Adding transition prop to MotionConfig to set a default transition for an entire tree.

[3.4.2] 2021-02-18

Added

• onBeforeLayoutMeasure prop, currently a Framer internal.

[3.4.1] 2021-02-18

Fixed

• De-duplicating features in nested MotionConfigs to avoid key error.

[3.4.0] 2021-02-18

Changed

• Main motion component concurrent-safe.

Fixed

• Crossfading elements can now never fall out of positional/style sync due to mismatched animations or framelag.
• Fixing SVG double translation transform (props + transform style).
• animate onComplete now firing correctly.
• Only firing keyframe animation when all values have changed.
• Removing forced re-renders for variant trees.
• Variant stagger order now determined by DOM APIs.
• Fixed default spring for scale, opacity etc from being overdamped to being critically damped when animating to 0.

[3.3.0] 2020-02-03

• Fixing errant publish.

[3.2.1] 2020-01-11

Added

• Exporting useVariantContext for internal Framer use.

[3.2.0] 2020-01-08

Added

• Support for hex alpha, ie #FFF0 and #FFFFFF00.
• Support for default filter values. For example, when animating from brightness(50%), the animation will start from brightness(100%)rather thanbrightness(0%).

[3.1.5] 2020-01-08

Fixed

• Hover events are now blocked while layout is being measured.

[3.1.4] 2020-01-05

Fixed

• Blocking layout animations to/from zero bounding boxes.
• onTapCancel now fires correctly on touch screens.
• createDomMotionComponent types.

[3.1.3] 2020-01-04

Fixed

• Fixed types for pathSpacing and pathOffset.

[3.1.2] 2020-01-04

Fixed

• snapToCursor respects drag axis.

[3.1.1] 2020-12-18

Updated

• Updated dependencies.

[3.1.0] 2020-12-18

Added

• whileFocus

[3.0.1] 2020-12-18

Fixed

• Error when mixing initial={false} and animate={controls}.

[3.0.0] 2020-12-16

Added

• whileDrag
• Adding Safari-prefixed userSelect css to draggable elements.
• whileHover, whileTap and exit all now accept variant lists.

Changed

• New behaviour for when values are removed from animation props (animate, whileHover, exit etc). The value will be searched for in active props of a lower priority running (style <- animate <- whileHover <- whileTap <- whileDrag <- exit). This may introduce subtle behavioural changes, hence the major.

Removed

• The deprecated useInvertedScale hook. Use the layout prop instead.
• The deprecated yoyo, flip and loop options. Use repeat and repeatType options instead.

Fixed

• Correctly applying transform on SVG elements.
• Lazy-initialising viewport scroll, VisualElement.axisProgress, and reduced motion MotionValues, for increased startup performance.
• Improved measurement scheduling for drag components and nested AnimateSharedLayout trees.
• Robust calculation of treeScale.

[2.9.5] 2020-11-16

Added

• Updating package.json to be compatible with React 17.

[2.9.4] 2020-10-21

Added

• Exporting internal API startVisualElementAnimation for use in Framer.

[2.9.3] 2020-10-19

Added

• Exporting Target type.

[2.9.2] 2020-10-19

Fixed

• Over-eager variant propagation.

[2.9.1] 2020-10-12

Fixed

• Reverting matchMedia listener to legacy addListener to fix in Safari.

[2.9.0] 2020-10-12

Added

• Refactor has reduced complete bundle size to 27kb and m component bundle size to 12.5kb.

Fixed

• Removing whitespace from resolved CSS variables.

[2.8.0] 2020-10-09

Added

• animate function for low-level single MotionValue or arbitrary value animations.

[2.7.8] 2020-10-07

Changed

• Reverting previous behaviour to allow manual triggering of updating drag constraints via useDragControls.

[2.7.8] 2020-10-07

Changed

• If dragConstraints is set to a ref on a non-draggable component, we resolve the constraints on mount in order to pass them to onMeasureDragConstraints.

[2.7.7] 2020-10-01

Fixed

• duration and bounce are now overridden by damping, stiffness, and mass. This fixes an issue in Framer where legacy transitions were breaking.

[2.7.6] 2020-09-29

Fixed

• When a transform is provided to style as a MotionValue and then replaced with a number on a subsequent render, we create a new MotionValue for it.

[2.7.5] 2020-09-26

Fixed

• Manually setting a from in transition.

[2.7.4] 2020-09-26

Fixed

• Blocks propagation of variants from parent if a component's animate prop is set to AnimationControls. inherit can be used to force inheritence true or false.

[2.7.3] 2020-09-25

Fixed

• Blocks touch viewport scrolling from draggable components on a per-axis basis.
• Reinstating sideEffects: false now that the blockViewportScroll method has been removed.

[2.7.2] 2020-09-24

Added

• createDomMotionComponent for legacy browser support.

[2.7.1] 2020-09-23

Fixed

• Reverting sideEffects: false, as viewport touch scroll blocking is a side effect.

[2.7.0] 2020-09-23

Added

• Duration-based springs.

[2.6.15] 2020-09-18

Fix

• Fixing dynamic type imports in generated types.

[2.6.14] 2020-09-18

Fix

• No longer unsetting transform motion values from style if their current value is 0.
• Correct useDomEvent types to allow any EventTarget.
• Fix memory leak error in AnimatePresence.

Change

• Added sideEffects: false to package.json.
• Added bundlesize bundle budgeting.

[2.6.13] 2020-09-12

Fix

• drag + layout components no longer reset position to center.

[2.6.12] 2020-09-11

Change

• Reduced full bundle size by 0.8kb by replacing import * from "popmotion" with a named map of specifically just the easing functions.

[2.6.11] 2020-09-11

Fixed

• Reinstating default keyframes duration of 0.8 seconds.

[2.6.10] 2020-09-10

Fixed

• dragElastic={0} gesture end animations now work correctly.

[2.6.9] 2020-09-09

Fixed

• Ensure AnimatePresence children re-render when children exit.

[2.6.8] 2020-09-08

Fixed

• Ensure useTransform uses the latest handler.

[2.6.7] 2020-09-08

Added

• Scale correction for borderRadius and boxShadow found in style.
• Fixed conflict between initial and style. initial will now take precedence on initial render.
• Support for CSS variables in scale-corrected boxShadow styles.

[2.6.6] 2020-09-03

Fixed

• Correctly mapping times option to Popmotion's offset.

[2.6.5] 2020-08-28

Changed

• Tweaked restSpeed defaults for smoother halting of physical (px) springs.

Fixed

• Critical-damped spring equations in Popmotion.

[2.6.4] 2020-08-28

Fixed

• Forcing array targets to use keyframes animations.

[2.6.3] 2020-08-27

Fixed

• Coercion to type auto.

[2.6.2] 2020-08-26

Fixed

• Fixing detection of transition definitions and application of default transitions.
• When animating to/from 0 and a unit type, 0 will be coerced to that unit type rather than needing unit conversion via DOM measurement.

[2.6.1] 2020-08-26

Fixed

• Updating useDragControls documentation to reflect that triggering events should be usePointerDown, as mouse events work differently on touch screens.
• AnimatePresence.custom is passed throughout the tree for all exit variants.
• Animating the viewBox attribute of svg elements now correctly sets the viewBox attribute instead of view-box.

Upgrade

• Typescript 4.

[2.6.0] 2020-08-24

Fixed

• Reverting relative dragConstraints resolution that was erroneously changed in 2.1.3.

[2.5.5] 2020-08-20

Fixed

• Tweaked restDelta in `popmotion@9.0.0-rc.7for smootheropacity` transitions.

[2.5.4] 2020-08-20

Fixed

• Fixed jumpy drag transitions resulting from existing animations not being correctly stopped.

[2.5.3] 2020-08-20

Fixed

• Improved velocity check for underdamped springs.

[2.5.2] 2020-08-20

Fixed

• Drag transitionEnd conflicting with layout animations.

[2.5.1] 2020-08-18

Fixed

• Occasional glitchy movement with type: "spring" and repeatType: "mirror"

[2.5.0] 2020-08-18

Added

• New repeat syntax
• Support for repeated springs

Fixed

• Fixed support for null in keyframes animations.
• Fixed delay propagation.

[2.4.3] 2020-08-18

Changed

• Upgrading to Popmotion 9 RC.

[2.4.1] 2020-08-12

Fixed

• Adding defensive check for visualElement.box in MeasureLayout.

[2.4.0] 2020-08-12

Added

• Upgraded useTransform to accept multiple MotionValues.
• Support for transformPerspective style.
• Internal: _dragX and _dragY external MotionValue targets for drag gesture.
• Internal: Support for rotate in AnimateSharedLayout within Framer.
• Internal: onViewportBoxUpdate, onLayoutMeasure and onLayoutUpdate event handlers added to HTMLVisualElement.

Fixed

• Fixed AnimateSharedLayout within React 17.0.0-rc.0.
• Drag now works directly on x and y transforms unless layout or layoutId are also set.

Changed

• Marked useInvertedScale as deprecated.

[2.3.0] 2020-07-28

Added

• useMotionTemplate, a hook for combining MotionValues using a string template literal.

[2.2.0] 2020-07-27

Added

• m component is a lightweight, featureless version of the motion component.
• MotionConfig is used to dynamically provide features to m components via context.

[2.1.4] 2020-07-24

Added

• Drag Cypress test suite.

Fixed

• Application of relative drag constraints.
• User-set transforms were only updating when layout transforms updated.
• Fixing drag on SVG components.

[2.1.3] 2020-07-23

Fixed

• HSLA interpolation when either HSLA contains a decimal.
• Whitespace-syntax color support.
• onLayoutAnimationComplete now firing correctly.

[2.1.2] 2020-07-22

Fixed

• Respecting transformTemplate for layout animations.
• Fixed this.box is undefined errors.

Changed

• Internal refactoring to improve tree-shaking and allow for dynamic feature injection.

[2.1.1] 2020-07-20

Fixed

• Performance improvements to layout delta calculations.

[2.1.0] 2020-07-17

Added

• layout="position" for position-only layout animations.

[2.0.1] 2020-07-16

Fixed

• Fixed issue with draggable components staying stuck when they're getting render-thrashed.

[2.0.0] 2020-07-15

Added

• layout prop for automatic layout animations.
• AnimateSharedLayout and layoutId for shared layout animations.
• onMeasureDragConstraints prop that fires when dragConstraints are measured.
• useIsPresent, a read-only version of usePresence.
• Allow dragConstraints to be a ref that is smaller than the draggable element.

Removed

• positionTransition and layoutTransition props (use layout={true} instead).
• Point type in favour of Point2D.
• useAnimatedState: Moved to Framer library.
• dragOriginX, dragOriginY props.
• stylefire as a dependency.

Fixed

• Removing a MotionValue from style now correctly unsets it from the element.

Changed

• Using Proxy to generate motion components. This saves ~0.5kb from the bundle size and ensures compatibility with all DOM elements and Web Components.
• x and y transform values won't change as a result of a drag gesture as this now works via layout projection.
• Drag events now report point as the pointer relative to the viewport, in line with other pointer events.
• Changed build process and using Terser for uglification. Reduces bundle size by ~1.2kb. (@stokesman in #596)

[1.11.1] 2020-06-16

Fixed

• Using useIsomorphicEffect for useElementScroll and useViewportScroll.(@thebuilder in #592)

[1.11.0] 2020-05-15

Added

• Added a useElementScroll hook that allows the creation of scroll motion values for HTML elements. (@souporserious in #195)

[1.10.3] 2020-03-23

Fix

• Replacing the functionality of DragControls e.preventDefault() with CSS and HTML attributes. (@inventingwithmonster in #495)

[1.10.2] 2020-03-23

Fix

• Fixing PresenceChild losing correct count of exiting children if it re-renders. (@inventingwithmonster in #490)

Changed

• Removed developer warning when using usePresence outside of an AnimatePresence block.

[1.10.1] 2020-03-23

Fix

• Fixing AnimatePresence children not re-rendering when their exiting siblings have been removed from the tree (which broke siblings positionTransition and layoutTransition). (@inventingwithmonster in #489)
• Adding null check for getTranslateFromMatrix (@JoyalJoyMadeckal in #482)

[1.10.0] 2020-03-19

Added

• AnimatePresence now supports multiple usePresence children within a given sub-tree.

[1.9.1] 2020-03-06

Fixed

• Ensuring drag momentum animations happen on _dragValueX and _dragValueY if provided. (@inventingwithmonster in #473)

[1.9.0] 2020-03-02

Added

• usePresence hook. (@inventingwithmonster in #473)
• repository field in package.json. (@iamstarkov in #469)

[1.8.4] 2020-02-05

Added

• dragListener prop to disable drag event listeners.

[1.8.3] 2020-01-28

Added

• Updated documentation for DragControls.start.

[1.8.2] 2020-01-28

Downgrade

• Downgraded api-extractor to `@7.3as7.7.7brokeMethod` name indexing.

[1.8.1] 2020-01-28

Added

• Updated documentation for useDragControls.

[1.8.0] 2020-01-27

Added

• useDragControls allows imperative initiation of a drag gesture.

[1.7.3] 2020-01-24

Fixed

• Updated transformTemplate to provide an empty string if all transform values are default.

[1.7.2] 2020-01-20

Fixed

• Changed definition of staggerDirection from 1 | -1 to number to reduce the need for casting externally-defined types.

[1.7.1] 2020-01-20

Added

• Added support for TargetResolver in exit types.

Fixed

• Filtering onAnimationStart from forwarded props.

[1.7.0] 2019-12-12

Added

• Support for prefers-reduced-motion via the useReducedMotion hook.

[1.6.18] 2019-12-10

Fixed

• Various StrictMode-related bugs including layoutTransition origin calculation.
• Only applying drag constraints during a useEffect to allow render-triggered animations a chance to start (thereby blocking the application of constraints).

[1.6.17] 2019-11-21

Added

• controls.set can now accept a function that will resolve once for each child.

[1.6.16] 2019-11-21

Fixes

• Fixing ref hydration in useLayoutEffect. (Note: This release effectively reverts 1.6.10. Each child of AnimatePresence with a unique key should be given a unique ref).
• Moving callback ref mutation in use-drag and use-pan-gesture to a useEffect.

[1.6.15] 2019-10-24

Added

• Quick start section to README.

[1.6.14] 2019-10-14

Fix

• Making position change detection more intelligent.

[1.6.13] 2019-10-14

Fix

• Fixing undefined this.props error for AnimatePresence.exitBeforeEnter.

[1.6.12] 2019-10-10

Fix

• Support strings in motion.custom for Web Component support.

[1.6.11] 2019-10-09

Fix

• Inconsistency in handling x/y between SVG and HTML. Now always a shorthand for translateX and translateY.

[1.6.10] 2019-10-09

Fix

• Fixing the use of externally-provided refs with single-child AnimatePresence components.

[1.6.9] 2019-10-08

Fix

• Exit variant propagation.
• Cancelling exit animations.

[1.6.8] 2019-10-02

Fix

• Fixed exit animation when animate={useAnimation()}.
• Fixed exit animations when another animation is playing concurrently and finishes first.
• Upgrade `stylefire@6.0.11to fixclipPath` in Webkit.
• Allow motion.custom to accept custom prop types.
• Support clicks within draggable components on iOS Safari.
• Making inherit public API.

[1.6.7] 2019-08-30

Fix

• Restoring React-style behaviour for transform style properties when a component isStatic.

[1.6.6] 2019-08-29

Fix

• Adding @emotion/is-prop-valid as an optional dependency to ensure we filter out arbitrary props passed along by Emotion and Styled Components.

[1.6.5] 2019-08-27

Fix

• Value-specific delay.

[1.6.4] 2019-08-27

Upgrade

• `stylefire@6.0.10`

[1.6.3] 2019-08-19

Fixed

• Ensuring onDragEnd always fires after if onDragStart fired.

[1.6.2] 2019-08-14

Fixed

• Invalid property in SVGs.

[1.6.1] 2019-08-12

Fixed

• Making useInvertedScale public and changing const to function.

[1.6.0] 2019-08-12

Added

• layoutTransition
• EventInfo now passed as second argument to onHoverStart and onHoverEnd.
• useDomEvent hook for attaching events directly to an Element.

Fixed

• Simplifying event system.
• Applying values in animate.transitionEnd if not initial animation.
• Made drag constraints only apply if a value isn't animating.
• Don't throw error if useInvertedScale is provided arguments.

[1.5.0] 2019-08-02

Added

• useInvertedScale for inverting parent scales.

[1.4.2] 2019-07-31

Fixed

• positionTransition on exiting components within AnimatePresence.

[1.4.1] 2019-07-30

Fixed

• Pan and drag gestures with PointerEvent.

[1.4.0] 2019-07-29

Added

• AnimatePresence.exitBeforeEnter.
• Added explicit support for custom components as children of AnimatePresence.

Fixed

• Fixing issue with drag constraints (ref-based) being reset, while dragging, on unrelated parent component updates.
• Updated rollup config to list tslib as an external dependency.
• Ensuring unmounting components don't call onAnimationComplete.
• Adding error message when no initial value is set, or can be read or inferred.
• Ensuring color alpha is always within bounds.
• Ensuring variants propagate on unmount.

[1.3.0] 2019-07-24

• Added onAnimationStart.

Fixed

[1.2.6] 2019-07-23

Fixed

• Make sure select, input, textarea loose focus when blocking default behaviour in a draggable element.

[1.2.5] 2019-07-23

Fixed

• Value type conversion for currently-hidden elements.
• Fixing unit type conversions when non-positional transforms are applied.
• Fixing variant propagation via useAnimation() when the parent component has no variants prop set.
• Fixing unsetting whileHover and whileTap if they contain transitionEnd values.
• Child components within variant trees now animate to animate as set by their parent.
• Checking animation props for array variants as well as strings.
• If unencountered value is animated, first attempt to extract an initial value from keyframes definition. Also upgrading stylefire to gracefully handle transform requests.

[1.2.4] 2019-07-15

Added

• isValidMotionProp function.

Fixed

• Improving types for SVGTextElement components.

[1.2.3] 2019-07-11

Fixed

• Don't load positionTransition functionality component server-side.
• In development mode, ensuring all child keys are unique.

[1.2.2] 2019-07-11

Upgrade

• Typescript to 3.5.

[1.2.1] 2019-07-10

Fixed

• Removing re-entering children from exiting list in AnimatePresence.

[1.2.0] 2019-07-09

Added

• Supporting positionTransition as a function that resolves when the component has moved.
• Adding dragOriginX and dragOriginY props.

Fixed

• Excluding positionTransition from SVG type.

[1.1.4] 2019-07-08

Updated

• Exporting AnimatePresenceProps.

[1.1.3] 2019-07-08

Fixed

• Fixing positionTransition on server-side.

[1.1.2] 2019-07-08

Fixed

• Upgrade to AnimatePresence algo.

[1.1.1] 2019-07-05

Changed

• Moving UMD global from FramerMotion to Motion.
• Removed @emotion/is-valid-prop, saving ~1.9kb from bundle.
• Using a slimmed-down version of Popmotion, saving ~3kb from bundle.
• Removing async markers, saving ~0.7kb from bundle.

Fixed

• Cancelling drag and pan gestures on component unmount.
• Previously unseen props in animate animate correctly.
• Fixing reading SVG attributes from DOM.
• Fixed unit type conversion not working with previously-undefined values.
• Calling onAnimationComplete when while overrides are unset.
• Preventing initial animation if animate is a map of props and initial={false}. This went previously unseen as both values were equivalent, but onAnimationComplete would fire on mount.

[1.1.0] 2019-07-03

Added

• AnimatePresence component for controlling mount/unmount animations.
• positionTransition prop for animating when the layout of a component changes.

[1.0.5] 2019-07-02

Fixed

• Fixing SVG path props.

[1.0.4] 2019-07-01

Fixed

• Moving SVG path props to MotionStyle type.
• Changing MakeMotion to accept either MotionValue<string> OR MotionValue<number>.

[1.0.3] 2019-07-01

Fixed

• Moving dragConstraints to a ref if a component re-renders mid gesture.
• Only applying dragConstraints on render if component isn't currently dragging.

[1.0.2] 2019-06-28

Fixed

• Making when type more permissive for passing in implicitly typed, pre-defined variants.
• Not blocking default browser behaviour when dragging is initiated on draggable element's select, input, textarea elements.

[1.0.1] 2019-06-27

Fixed

• Fixing useSpring unsubscriptions.

[1.0.0] 2019-06-26

Added

• Improved SVG support.

[0.20.2] 2019-06-20

Fixed

• Ensuring each MotionValue receives one MotionValuesMap update subscriber.

[0.20.1] 2019-06-20

Fixed

• Adding x/y MotionValues to the useDrag dependency list.
• Ensure hover events only fire as a result of mouse interactions.

[0.20.0] 2019-06-18

Feature

• Allowing SVG motion components to accept MotionValues via attributes.
• Adding SVG attribute types to Target.

[0.19.2] 2019-06-13

Fixed

• Detecting originZ as a transform-origin value.

[0.19.1] 2019-06-13

Added

• initial={false} to shadow contents of animate thereby disabling on mount animation.
• AnimationControls.set for imperative setting of values.

Fixed

• Resolve animations only after a defined delay to ensure velocity is only resolved as an animation begins on a value.

[0.19.0] 2019-06-13

Upgraded

• `stylefire@5.0.0- ChangesoriginX/Ydefault to"50%"`.

[0.18.6] 2019-06-13

Added

• Production and prototype environment-specific tsdocs.

[0.18.5] 2019-06-07

Fixed

• Properly cleaning up event listeners in tap gesture.
• Only starting pan gesture when pointer has moved more than one point.
• Applying transformPagePoint to dragConstraints when it's a RefObject<Element> to ensure it works in scaled environments.
• Fixing dragElastic behaviour when dragMomentum={false}.

[0.18.4] 2019-05-30

Fixed

• Preventing default browser behaviours on draggable elements.

[0.18.3] 2019-05-30

Fixed

• Fixing drag when a multitouch gesture starts.

[0.18.2] 2019-05-22

Fixed

• Application of delay.

[0.18.1] 2019-05-21

Fixed

• Fixed regex detection for fallbacks containing a decimal.

[0.18.0] 2019-05-21

Added

• dragConstraints can now be set as a React.RefObject.

Fixed

• Support CSS variables with metadata
• Fixing circular CSS dependencies

[0.17.2] 2019-05-15

Fixed

• Even if a motion component wasn't inheriting variant changes, it'd still register with its parent, meaning it'd be considered during stagger duration calculations.
• Only firing onDragEnd if dragging has actually happened.

[0.17.1] 2019-05-13

Fixed

• dragTransition now listed as a useDraggable dependency.

[0.17.0] 2019-05-09

Added

• Experimental useAnimatedState Hook for animating arbitrary values.

[0.16.11] 2019-05-08

Fixed

• Disabling the animation of zIndex.
• Making components without variants or animation-controlling props invisible to staggerChildren.

[0.16.10] 2019-05-07

Updated

• API

Fixed

• Variant propagation when rerendering children

[0.16.9] 2019-05-07

Fixed

• Using transition and transitionEnd as direct values on the animate prop on subsequent renders.
• Rounding zIndex.
• AnimationControls.start now accepts the same AnimationDefinition as ValueAnimationControls.start.

[0.16.8] 2019-05-06

Fixed

• Cancelling pan gesture when the move events have no mouse button.

[0.16.7] 2019-05-06

Fixed

• Fixing propagation of unsetting variant overrides.
• Making variant inheritance more permissive.

[0.16.6] 2019-05-02

Fixed

• Improved handling of attempting to animate between non-animatable and animatable values.

[0.16.5] 2019-05-01

Added

• Adds array and object support to transform.

Fixed

• Makes boxShadow and other complex value type support more robust.
• Fixing overwriting transform.

[0.16.4] 2019-04-30

• Updating deps.

[0.16.3] 2019-04-30

Added

• shadow to CustomValueTypes.

[0.16.2] 2019-04-30

Fixed

• Fixed propagation of initial in static mode.
• Fixing animations from values that are read as "none".

[0.16.1] 2019-04-25

Fixed

• Filtering pointer events not from the primary pointer (ie non-left clicks for mouse).
• Fixing drag in Android devices by adding aggressive viewport scroll blocking. This will need dialling back down when it comes to open sourcing Motion so, for instance, a horizontal carousel doesn't block vertical scrolling.

[0.16.0] 2019-04-19

Added

• custom prop for dynamic variants.

Removed

• useAnimation no longer takes variants or defaultTransition arguments (provide these to the component).

Fixed

• Improving comparison for animate prop to account for keyframe arrays.
• Adding drag point in onDragStart and onDragEnd callbacks.

[0.15.2] 2019-04-17

Added

• Support for CSS variables.

Fixed

• onDragEnd not returning transformed point.
• Fixing use of variants prop with useAnimation.

[0.15.1] 2019-04-16

Added

• HTMLMotionProps and SVGMotionProps.

[0.15.0] 2019-04-16

Added

• onPanSessionStart event handler.

Changed

• useViewportScrollValues => useViewportScroll.

Added

• ease can now be an array for keyframes animations.

Removed

• easings prop.

[0.14.3] 2019-04-12

Fixed

• Only firing value.onChange when value actually changes.

[0.14.2] 2019-04-11

Fixed

• Updating hey-listen.

[0.14.1] 2019-04-11

Added

• Explicit support for the radius value.

[0.14.0] 2019-04-10

Changed

• Making special value support configurable

[0.13.0] 2019-04-08

Changed

• useTransformedValue => useTransform

Added

• transform(value, input, output, options) overload.

[0.12.2] 2019-04-08

Changed

• Added new methods to safeWindow SSR window mocking.

Fixed

• Deleting unused props from style object rather than setting to undefined. #99

[0.12.1] 2019-04-03

Fixed

• size works with while gestures.

[0.12.0] 2019-04-03

Changed

• useCycle([...args]) -> useCycle(...args)

Added

• static components reflect changes in initial.

Fixed

• Dragging doesn't break during re-renders.
• useCycle setter is independent from render cycle.

Removed

• useCycle no longer has the ability to start at a different index.

[0.11.1] 2019-04-02

Added

• onDragTransitionEnd

Upgraded

• Popmotion libraries.

[0.11.0] 2019-04-01

Changed

• value.addUpdateSubscription => value.onChange
• value.addRenderSubscription => value.onRenderRequest (and made internal)

Upgraded

• `popmotion@8.6.5`

Fixed

• Variants propagate to children even if not present on parent.

[0.10.2] 2019-03-27

Changed

• Updating docs to avoid single-letter event vars.

[0.10.1] 2019-03-27

Fixed

• Fixing TargetAndTransform type to omit CSS-native rotate property.

[0.10.0] 2019-03-26

Changed

• press -> whileTap
• hover -> whileHover

[0.9.4] 2019-03-26

Fixed

• Fixing HTML types.

[0.9.3] 2019-03-25

Added

• Exporting MotionTransform type.

[0.9.2] 2019-03-22

Added

• Added support for CustomValueType in unwrapMotionValue.

[0.9.0] 2019-03-22

Added

• Added dragDirectionLock prop.

Removed

• "lockDirection" from dragEnabled.

Changed

• Renamed dragEnabled to drag.

[0.8.8] 2019-03-20

[0.8.7] 2019-03-20

Added

• Adding transition argument to animation.start().

Fixed

• No longer fire tap gesture if parent is dragging.
• Adjusting default inertia settings to more naturally incorporate velocity.
• Killing drag momentum on subsequent pressDown.
• Preventing pan velocity from adjusting draggable parents that have not received dragPropagation.
• Updating of dragConstraints repositions the draggable element to adhere to the new values

[0.8.6] 2019-03-19

Added

• Point.relativeTo
• transform

Fixed

• Statefull style bug.
• Fixing Promise resolution with animate.start() when fired pre-mount.

[0.8.5] 2019-03-15

Fix

• Blocking extra gesture props from being passed to DOM.
• Upgrading @popmotion/popcorn to fix Jest bug.

[0.8.4] 2019-03-15

Fix

• Fixing style set as null.

[0.8.3] 2019-03-14

Update

• Adding support for custom values.

[0.8.2] 2019-03-14

Update

• Updating tsdocs for MotionValue.

[0.8.1] 2019-03-12

Update

• Updating dependencies.

[0.8.0] 2019-03-12

Changed

• originX, originY, pathLength, pathOffset changed from percent to progress value types.

[0.7.5] 2019-03-11

Added

• Exporting AnimationControls.

[0.7.4] 2019-03-11

Added

• Exporting animationControls and motionValue for internal use.

[0.7.3] 2019-03-08

Added

• Passing panInfo through to onDragStart and onDragEnd.

[0.7.2] 2019-03-07

Fixed

• easings property on keyframes now maps correctly to easing functions.

[0.7.1] 2019-03-07

Fixed

• Enforcing keyframes animation if target is array.
• Orchestration props in transition prop weren't being respected by variants with no transition of their own.

[0.7.0] 2019-03-07

Added

• Animation targets can be set as keyframes.

[0.6.8] 2019-03-05

Fixed

• Updating dragConstraints when they change.

[0.6.7] 2019-03-04

Updated

• Removing GPU-acceleration for static components.
• Adding customStyles plugin.

[0.6.6] 2019-02-29

Updated

• `stylefire@2.4.3`

[0.6.4] 2019-02-22

Added

• Exporting MotionContext.

Update

• Updated `popmotion@8.6.3` to improve synchronisation across tweens when yoyoing.

[0.6.3] 2019-02-21

Fixed

• If transformPagePoint is present, transforming initial point.

[0.6.2] 2019-02-21

Fixed

• Recognising press when it's the lone gesture.

[0.6.1] 2019-02-20

Fixed

• Fixed an issue where values set to style would overwrite animate values even if they hadn't changed.

[0.6.0] 2019-02-20

Added

• static prop. Set static on a motion component to prevent animation and interaction.

Removed

• render

[0.5.2] 2019-02-20

Fixed

• Animating unit-converting values on mount.

[0.5.1] 2019-02-19

Added

• Exporting MotionComponents, CustomMotionComponent, HTMLMotionComponents and SVGMotionComponents types.
• Exporting safeWindow.

[0.5.0] 2019-02-19

Added

• onDrag event listener
• Exporting MotionStyles type.

Changed

• tap -> press

[0.4.5] 2019-02-15

Fixed

• Fixing originX and originY SSR.
• Updating style props to overwrite CSS rotate, scale and perspective.

[0.4.3] 2019-02-14

Fixed

• Rendering initial properties via Stylefire when component mounts to ensure its in-sync with all transform values set in initial that might not later be rendered.
• Exporting htmlElements, svgElements and createMotionComponent as their exclusion was causing errors with the output declaration file.

[0.4.2] 2019-02-14

Changed

• Exporting useExternalRef.

[0.4.1] 2019-02-13

Changed

• Simplifying inline tsdocs.

[0.4.0] 2019-02-12

Changed

• Standardizing (event, pointInfo) as signature for gesture callbacks.

Fixed

• Gesture priority bugs

[0.3.2] 2019-02-08

Changed

• Added TSDocs for useCycle

[0.3.0] 2019-02-05

Changed

• duration and delay are now defined as seconds.
• tapActive -> tap
• hoverActive -> hover
• drag -> dragEnabled