motiondivision/motion
42.2
Weak · 7 November 2026
65.1k
lines of production code
TypeScript
with JavaScript
4
measurements over time
What this system is
Features
Add DOM event listener utility
A new utility function \addDomEvent\ has been introduced in the \motion-dom\ package to manage DOM event listeners. This function wraps \addEventListener\ with a default passive option and returns a cleanup function for removing the listener, providing a standardized way to attach and detach events within the library's event handling system.
packages/motion-dom/src/events · high confidence
Add ObjectVisualElement and reduced-motion utilities to motion-dom
The motion-dom package now includes an ObjectVisualElement class that handles rendering and state management for generic object instances, allowing animations to apply resolved values directly to plain objects. Additionally, utilities for handling the prefers-reduced-motion media query have been added, including state management and initialization logic to detect and respond to user accessibility preferences in the browser.
packages/motion-dom/src/render/object, packages/motion-dom/src/render/utils/reduced-motion · high confidence
Add hover gesture support with drag-interoperability
The gesture module now includes a new \hover()\ function that provides a simplified API for handling hover states, automatically managing pointer enter/leave events and filtering out touch interactions. A key behavioral improvement is its interoperability with drag gestures: if a pointer is pressed while hovering, the hover end event is deferred until the press is released, preventing the hover state from dropping prematurely when a drag operation begins. The implementation also introduces a shared \EventOptions\ interface to configure passive listeners and one-time event binding.
packages/motion-dom/src/gestures · high confidence
Add native ViewTimeline support for scroll-linked animations
Scroll-linked animations now leverage the browser's native ViewTimeline and ScrollTimeline APIs when supported, replacing the previous JS-driven scroll tracking for compatible scenarios. This change introduces a caching mechanism for timelines to optimize performance and maps specific scroll offsets to exact ViewTimeline ranges, allowing for more accurate and performant scroll-based interactions. If native timelines are unavailable or the offset cannot be mapped, the system falls back to JavaScript-based scroll value tracking.
packages/framer-motion/src/render/dom/scroll/utils · high confidence
Added Next.js app directory demo for motion/react client components
Added a new Next.js application structure under dev/next/app to demonstrate the integration of motion/react with React Server Components. This includes a root layout with a WeakRef polyfill, a client-boundary module using motion.create for custom components, and a main page that renders various motion features (LazyMotion, AnimatePresence, MotionConfig) to showcase client-side animation capabilities within a server-component architecture.
dev/next/app · high confidence
Added Next.js app router demo for layout animations
A new demo page (\dev/next/app/layout-id/page.tsx\) has been added to the Next.js application to demonstrate layout animations using \LayoutGroup\ and \layoutId\. The page implements a navigation bar with two items ('Home' and 'Account') that switch state, triggering a smooth animated indicator transition between them. Supporting configuration files (\tsconfig.json\, \next-env.d.ts\) have also been added to enable TypeScript support for this new demo area.
dev/next · high confidence
Added generic property effect for non-DOM subjects
A new \propEffect\ has been introduced in the motion-dom package to handle animation updates for generic object properties. This effect serves as a fallback mechanism for the \animate()\ function, allowing motion values to be written to any object (such as plain JavaScript objects) that is not explicitly claimed by other specific effects like style or transform handlers. It ensures that animations can drive changes in arbitrary object properties by reading and writing values directly.
packages/motion-dom/src/effects/prop · high confidence
Added performance benchmarks for animation libraries
Added a suite of HTML-based performance benchmarks in the public directory to measure the performance of various animation libraries and techniques. These benchmarks cover cold-start scenarios for Anime.js, Framer Motion, GSAP, and WAAPI; interruption performance for Motion and Anime; unit value mixing for Motion and Greensock; and stress tests for style effects and scroll-triggered animations.
dev/html/public/benchmarks · high confidence
Added resize detection utilities for elements and window
The motion-dom package now includes a new resize module that provides a unified \resize\ function to detect size changes. Users can subscribe to window resize events or specific element resize events (using ResizeObserver for elements and addEventListener for the window). The module handles cleanup automatically by returning an unsubscribe function, and includes a mock implementation for testing purposes.
packages/motion-dom/src/resize · high confidence
Added tag-proxy utility for dynamic component creation
Introduced a new \tag-proxy\ utility in the components utils module that enables the creation of generic components capable of rendering as different HTML tags or custom components. This utility handles prop binding and caching to ensure efficient rendering of elements like \\<component.div /\>\ while correctly managing overlapping props between custom and HTML-specific interfaces.
packages/framer-motion/src/components/utils · high confidence
AnimatePresence introduces 'popLayout' mode for smoother layout transitions
AnimatePresence now supports a new 'popLayout' mode (in addition to existing 'sync' and 'wait' modes) that allows exiting elements to be visually 'popped' from the layout, enabling sibling elements to immediately shift into their new positions without waiting for the exit animation to complete. This is implemented via a new PopChild component that injects a scoped style block to fix the exiting element's position and dimensions during the exit, while a new PresenceChild component manages the context and lifecycle. The component also adds 'propagate' and 'root' props to support nested presence contexts and Shadow DOM environments, and includes fixes for React 19 compatibility and RTL direction handling.
packages/framer-motion/src/components/AnimatePresence · high confidence
Auto-scroll and multidimensional reorder support
The Reorder component now automatically scrolls its container (or the page if the container lacks overflow) when dragging items near the edges, preventing items from getting stuck outside the visible area. Additionally, Reorder.Group now supports multidimensional (xy) layouts, allowing items to be reordered across both axes rather than just a single linear direction. Also in this area: 2 commits (0 fixes) modifying packages/framer-motion/src/components; Reorder auto-scroll scales by frame delta and onReorder passes the moved item; Improved Reorder auto-scroll behavior and test stability.
packages/framer-motion/src/components/Reorder/utils · medium confidence · unverified
Automated changelog distribution via new release scripts
Added three new scripts to streamline the release process: \generate-changelog.js\ converts the repository's \CHANGELOG.md\ into a structured \changelog.csv\ file; \notify-slack.js\ sends version-specific changelog summaries to a Slack channel (using a local endpoint in dev mode or the production Motion API); and \push-to-site.js\ mirrors the generated \changelog.csv\ to the local \motion-api\ site source to keep the public changelog page in sync. These changes shift the workflow from manual updates to an automated, script-driven pipeline for publishing release notes.
scripts · high confidence
Easing utility functions and tests added
Added utility functions for handling easing definitions, including \easingDefinitionToFunction\ which maps string names and cubic bezier arrays to their corresponding easing functions, along with helper functions \isBezierDefinition\ and \isEasingArray\. Included unit tests for these new utilities to ensure correct behavior.
packages/motion-utils/src/easing/utils · high confidence
Implement view-transition name assignment and layer management utilities
Added a suite of utility functions in the motion-dom view module to manage CSS View Transitions. This includes logic to assign and release unique \view-transition-name\ identifiers (supporting both author-defined and generated names), batch style reads to avoid recalculation, and handle layer grouping and cropping. New helpers also resolve element targets, determine layer types (new/old/group), and retrieve active view transition animations from the document.
packages/motion-dom/src/view/utils · high confidence
Introduce MotionConfig component for centralized animation settings
The new MotionConfig component allows users to configure animation behavior for all child motion components via context. It supports inheriting and merging transition settings from parent configurations, managing reduced motion preferences, skipping animations for testing, and validating custom props. This enables consistent animation defaults across a component tree without passing props manually.
packages/framer-motion/src/components/MotionConfig · high confidence
Introduce MotionValueState for per-element animation state management
Added a new MotionValueState class in packages/motion-dom/src/effects to manage animation values per element. This class handles binding MotionValues to render functions, scheduling updates within the frameloop, and managing lifecycle events like removal and release. It replaces the previous approach of sharing a single state instance across multiple elements, allowing for more granular control over animation rendering and reducing unnecessary re-renders by tracking pending renders per state.
packages/motion-dom/src/effects · high confidence
Introduce WAAPI-based animation engine for lightweight animations
This change introduces a new Web Animations API (WAAPI) animator implementation within the \framer-motion\ library, providing a lighter-weight alternative for DOM animations. The new module adds \animateElements\ to handle individual element animations with optimized interruption and keyframe resolution, \animateSequence\ to manage chained animation sequences, and \animateMini\ as the entry point for scoped, lightweight animations. This implementation is designed to reduce bundle size and improve performance for standard CSS animations by leveraging native browser capabilities instead of the previous JavaScript-based animator.
packages/framer-motion/src/animation/animators/waapi · high confidence
Introduce animateView API for CSS View Transitions
Adds a new \animateView\ builder in \packages/motion-dom/src/view\ that exposes the browser's native CSS View Transitions API. This allows users to define shared-element morphs between old and new states using a fluent interface (\.add()\, \.new()\, \.old()\, \.enter()\, \.exit()\), with support for automatic cropping, layout morphing, staggered animations, and nested group control. The implementation includes a queue system to batch transitions and handles the assignment of \view-transition-name\ properties to elements, enabling smooth, hardware-accelerated UI transitions without manual keyframe management.
packages/motion-dom/src/view · high confidence
Introduce imperative layout animation API with shared projection tree
Adds a new \animateLayout\ API for vanilla JavaScript that enables layout animations via \data-layout\ and \data-layout-id\ attributes. This implementation replaces previous \getBoundingClientRect\ measurements with a shared projection tree system, allowing multiple layout animations to be batched and committed together for consistent cross-element transitions.
packages/motion-dom/src/layout · high confidence
Introduction of motion-dom node type definitions
The motion-dom package now includes a comprehensive set of TypeScript type definitions for its node system, located in packages/motion-dom/src/node/types.ts. This file establishes the core interfaces and types used for animation targets, variants, transitions, and legacy animation controls, providing the foundational type safety for the library's animation engine.
packages/motion-dom/src/node · high confidence
Introduction of motion-utils package with core utility functions
A new \motion-utils\ package has been added, providing a collection of core utility functions and types used across the motion library. This includes array manipulation helpers (\addUniqueItem\, \removeItem\, \moveItem\), value constraints (\clamp\, \wrap\), and type guards (\isObject\, \isNumericalString\, \isZeroValueString\). It also introduces a \SubscriptionManager\ for handling event listeners, time conversion utilities (\secondsToMilliseconds\), and a development warning system (\warning\, \invariant\, \warnOnce\) that respects the \NODE\_ENV\ environment variable to ensure dev-only code is eliminated in production builds. Additionally, the package exports various easing functions and global configuration options (\MotionGlobalConfig\).
packages/motion-utils/src · high confidence
Manual drag control via useDragControls hook
Users can now programmatically control drag gestures on motion components using the new useDragControls hook. This hook returns a DragControls instance that exposes start, cancel, and stop methods, allowing developers to initiate, interrupt, or terminate dragging from external triggers (such as a separate button or handle) rather than relying solely on direct pointer interaction with the draggable element itself.
packages/framer-motion/src/gestures/drag · high confidence
Minimal motion component API and tree-shaking verification
The \m\ module now exposes a \create\ function (accessible as \m.create()\) that allows users to construct minimal motion components, alongside a full set of pre-built HTML and SVG motion elements (e.g., \m.div\, \m.span\). This location specifically implements the minimal component factory and the element registry, ensuring that these minimal components exclude heavy layout scale correctors to support better tree-shaking, a behavior verified by new tests that confirm the absence of specific canary code in the bundled output.
packages/framer-motion/src/render/components/m · high confidence
New AnimateView component for React View Transitions
The library now includes an AnimateView component that integrates with the browser's View Transitions API to animate enter, exit, share, and update transitions. This feature allows developers to create smooth, native-feeling page transitions by wrapping content in AnimateView and defining custom keyframes for each transition state. The implementation includes utilities to manage view transition layers, reset styles, and handle animation lifecycle events, requiring React 19.3 or later.
packages/framer-motion/src · high confidence
New Arcs demo page showcasing motion path animations
A new demo page has been added at dev/next/app/arcs that illustrates how to use the \arc\ motion path within the \motion\ component's transition and the \useAnimate\ hook. The page includes two examples: one using keyframe-style animation with a repeating reverse arc path, and another using imperative animation via \useAnimate\ to move an element along an arc trajectory.
dev/next/app/arcs · high confidence
New GPU adapter preview examples for Three.js and vgpu
Added a set of interactive demo pages in dev/html/src to preview GPU adapter capabilities. These include examples for animating Three.js object and material properties, animating shader uniforms, and leveraging Three.js TSL (Three.js Shading Language) uniform nodes with the WebGPURenderer. Additionally, new vgpu-based demos demonstrate animating node transforms, materials, lights, and camera controls, as well as rendering custom fragment shaders with dynamic uniforms. All examples share a common dark-themed UI and provide controls to trigger animations and view status updates.
dev/html/src · high confidence
New MeasureLayout component for layout animation coordination
A new MeasureLayout component has been introduced in the layout features module to manage layout animations. It integrates with LayoutGroup and SwitchLayoutGroup contexts to coordinate projection nodes, handles layout dependency changes, and manages the lifecycle of layout animations including exit states and safe removal logic.
packages/framer-motion/src/motion/features/layout · high confidence
New React 19 development environment for testing and examples
A new local development environment has been added at dev/react-19 to support testing and example development against React 19. This environment uses Vite and provides a playground where users can browse and run example components or specific test files via URL parameters. It is configured to run on port 9991, enforces React StrictMode, and includes a sample component demonstrating the updated children types and client-side motion APIs available in React 19.
dev/react-19 · high confidence
New React development environment powered by Vite
A new local development environment for React has been added to the \dev/react\ directory, replacing previous setups with a Vite-based configuration. This environment provides a dedicated server (defaulting to port 9990) and includes a README with instructions to run examples via \yarn dev\. It allows developers to easily test Motion components by visiting example files or running specific tests via URL parameters.
dev/react · high confidence
New React examples and Vite-based playground
The development environment has been replaced with Vite, introducing a new \App.tsx\ entry point that dynamically loads examples and tests via \import.meta.glob\. A comprehensive suite of new examples has been added to the \dev/react/src/examples\ directory, demonstrating \AnimatePresence\ features (including the new \propagate\ option, \mode="wait"\, and layout animations with \LayoutGroup\), various animation types (CSS variables, keyframes, layout size/position, and stress tests), and interaction patterns like drag-to-dismiss notifications and image galleries.
dev/react/src/examples · high confidence
New Vanilla dev environment with Vite and GPU preview demos
The dev/html directory now provides a new Vanilla JavaScript development environment powered by Vite, replacing previous tooling. This setup includes a local playground server (port 8000) featuring several interactive GPU adapter preview examples: Three.js animate() demos, Three.js effects with shared MotionValues, a Three.js TSL demo using the WebGPU renderer, and vgpu uniform/scene animations. These pages allow users to test and visualize motion capabilities directly in the browser.
dev/html · high confidence
New animateView() examples for view transitions
Added a suite of public examples in dev/html/public/examples demonstrating the animateView() API, including avatar-profile, clip, crop-compare, filter-gallery, group-escape, lightbox, netflix, now-playing, and stagger. These showcase features such as shared-element morphs, staggered enter/exit animations, auto-layout morphs, circular clip-path reveals, default crop behavior, and group nesting with escape capabilities.
dev/html/public/examples · high confidence
New animation hooks and legacy controls implementation
This change introduces several new React hooks in the animation hooks module: \useAnimate\ and \useAnimateMini\ for scoped animations, \useAnimatedState\ for animating state values, and \useAnimationControls\ (aliased as \useAnimation\) for managing legacy animation controls. The \useAnimate\ hook specifically respects the \MotionConfig\ context, applying \skipAnimations\ and \reduceMotion\ settings to scoped animations. Additionally, a new \animation-controls.ts\ file implements the \LegacyAnimationControls\ interface, providing \start\, \set\, \stop\, and \subscribe\ methods for manual animation sequencing. All new hooks include the 'use client' directive for React Server Components compatibility.
packages/framer-motion/src/animation/hooks · high confidence
New demo pages for the animateLayout API
Added a suite of HTML demo pages in the animate-layout directory to showcase and test the new vanilla JS layout animation API. These include a basic position change test, a fire-and-forget animation test, an interruptible animation test, and several complex modal/card interaction scenarios (such as open-close-open and A-B-A patterns) that verify correct behavior for shared layout nodes, crossfades, and interrupted transitions.
dev/html/public/animate-layout · high confidence
New easing functions and modifiers added to motion-utils
The \packages/motion-utils/src/easing\ module now includes new easing functions (\anticipate\, \backIn\, \backOut\, \backInOut\, \circIn\, \circOut\, \circInOut\) and utility modifiers (\mirrorEasing\, \reverseEasing\) that allow composing custom easing curves. The \cubicBezier\ solver has been refactored to use a Newton-Raphson method with bisection safeguarding, improving output precision and reducing bundle size by removing the lookup table. Additionally, a \steps\ function is introduced to create stepped easing effects, and TypeScript types for these new easings are defined in \types.ts\.
packages/motion-utils/src/easing · high confidence
New extensible effect system for custom animations
The motion-dom package now exposes a new effect API that allows developers to register custom animation behaviors via \animate.addEffect()\. This change introduces \createEffect\ and \createSelectorEffect\ utilities, enabling effects to handle element selection, read initial values, and manage motion value state. This provides a standardized way to extend the animation engine with custom logic, such as handling specific DOM properties or integrating with other rendering systems.
packages/motion-dom/src/effects/utils · high confidence
New gesture demo pages for hover, press, and resize
Added interactive demo pages for the hover, press, and resize gesture APIs in the MotionDOM library. The hover demo illustrates attaching multiple handlers and using the once option. The press demo covers multiple handlers, cancellation states, nested click handling, and propagation control via stopPropagation. The resize demo shows tracking dimension changes for both HTML elements and SVG shapes.
dev/html/public/playwright/gestures · high confidence
New global animation and development utility APIs exposed to window
The \dev/html/src/imports\ directory now exposes several new global APIs for use in development and vanilla JavaScript contexts. \window.AnimateLayout\ provides a new \unstable\_animateLayout\ function and related builders for layout animations, while \window.Animate\ and \window.Undo\ expose projection node creation and animation logic for script-based animations. Additionally, \window.Assert\ is introduced to provide assertion helpers for testing layout properties like viewport boxes, visibility, opacity, and transforms. Existing animation libraries are also explicitly exposed: \window.Motion\ (framer-motion/dom), \window.MotionDOM\, \window.Projection\ (framer-motion/projection), \window.anime\ (animejs), and \window.gsap\ (gsap with ScrollTrigger). React and ReactDOM modules are also exposed via \window.React\, \window.ReactDOM\, \window.ReactDOMClient\, and \window.ReactDOMServer\ in the optimized-appear import.
dev/html/src/imports · high confidence
New inView utility for viewport intersection detection
A new \inView\ function has been added to the DOM viewport rendering module, allowing users to detect when elements enter or leave the viewport using the Intersection Observer API. This utility accepts an element or selector, along with options for root context, margin, and intersection amount thresholds, and provides callbacks for when elements start and stop intersecting. It returns a cleanup function to disconnect the observer, enabling precise control over viewport-based interactions without manual observer management.
packages/framer-motion/src/render/dom/viewport · high confidence
New library-specific effect entrypoints and restructured barrel exports
The motion package now exposes dedicated entry points for Three.js and vgpu effects, allowing users to animate 3D objects, materials, uniforms, and shader bindings directly via \threeEffect\ and \vgpuEffect\. To support these and improve IDE experience, the main \react.ts\ barrel has been refactored to use explicit local bindings for \motion\ and \m\ instead of a duplicate-source re-export, which resolves Turbopack OOM issues in Next.js. Additionally, new subpath exports are available for React-specific client rendering (\react-client.ts\), mini bundles (\react-mini.ts\), and debug utilities (\debug.ts\).
packages/motion/src · high confidence
New low-level MotionValue primitives for animation and transformation
The \packages/motion-dom/src/value\ module now exposes new primitives that allow values to be animated, mapped, and transformed independently of React hooks. \followValue\ and \springValue\ create \MotionValue\ instances that automatically animate to a source value (with \followValue\ supporting a \skipInitialAnimation\ option to prevent animations on page refresh), while \transformValue\ and \mapValue\ derive new values from existing ones via functions or range mappings. These utilities provide a foundation for scroll timeline acceleration and more efficient spring retargeting by decoupling value tracking from component-level hooks.
packages/motion-dom/src/value · high confidence
New motion component factory and element exports
The \packages/framer-motion/src/render/components/motion\ directory now provides the infrastructure for creating custom motion components and exporting standard HTML/SVG elements. It introduces \createMotionComponentWithFeatures\ to generate motion-wrapped components with a standard feature bundle (animations, gestures, drag, layout), exports a comprehensive list of \Motion\*\ components for all HTML and SVG tags in \elements.ts\, and exposes a \motion\ proxy object in \proxy.ts\ for dynamic access. The \namespace.ts\ file re-exports these elements under their lowercase tag names (e.g., \motion.div\) and exposes the \create\ factory function, while \index.ts\ consolidates the \motion\ namespace export.
packages/framer-motion/src/render/components/motion · high confidence
New motion-dom package exports core animation and rendering primitives
The new \packages/motion-dom/src/index.ts\ file establishes a public API surface for the \motion-dom\ package, exporting core modules for animation (including generators like spring and inertia, keyframe resolution, and WAAPI support), visual element management (DOM, HTML, SVG, and object visual elements), gesture handling (drag, hover, press), and value utilities (motion values, color/dimension types, and interpolation). This change consolidates and exposes the foundational building blocks required for DOM-based animations and interactions, separating them from higher-level React-specific concerns.
packages/motion-dom/src · high confidence
New press gesture API with keyboard accessibility and pointer capture support
The \packages/motion-dom/src/gestures/press\ module introduces a new \press()\ function that provides a robust alternative to native click events. It automatically filters out secondary pointer events (like right-clicks) and multitouch, while adding full keyboard accessibility by making elements focusable and responding to Enter key presses. The implementation supports pointer capture to ensure gestures complete even if the pointer leaves the element, and includes a \stopPropagation\ option to prevent parent tap handlers from firing. Additionally, it ensures that end listeners run in the capture phase, preventing descendant \stopPropagation()\ calls from blocking the gesture's completion.
packages/motion-dom/src/gestures/press · high confidence
New scopeMotion API for grouped animation lifecycle management
Introduces the \scopeMotion\ function in \motion-dom\, allowing users to group animations, scroll listeners, and gestures into a single scope that can be stopped or cancelled together. This new capability includes an \ignore()\ method to exclude specific callbacks from scope collection, support for optional root elements to scope selector resolution, and media-condition support (via \matchMedia\) that automatically refreshes the scope when conditions change. The API also provides a \cancel()\ method to stop animations and restore inline styles to their pre-animation state, alongside a \stop()\ method that halts activity without style restoration.
packages/motion-dom/src/scope · high confidence
New style effect implementation with transform-origin support
The style effect system has been refactored to introduce a new \styleEffect\ that shares state between \animate()\ and direct style calls, improving performance and consistency. This change adds support for \transform-origin\ properties (originX, originY, originZ) and introduces a non-destructive \pathRotation\ channel for orienting paths along curves. The implementation also optimizes transform building by caching string openers and ensures SVG elements correctly handle transform origins as attributes.
packages/motion-dom/src/effects/style · high confidence
New useDomEvent hook for direct DOM event binding
A new \useDomEvent\ hook has been added to the events module, allowing users to attach event listeners directly to DOM elements via refs, bypassing React's synthetic event system. This is particularly useful for scenarios requiring non-passive event handlers (such as custom wheel or scroll handling) where default browser behavior needs to be prevented. The hook is marked with the 'use client' directive to ensure compatibility with React Server Components.
packages/framer-motion/src/events · high confidence
New utility hooks and drag-correction helpers in framer-motion utils
This update introduces several new utilities to the framer-motion library. For drag interactions, it adds \correctParentTransform\ to handle pointer coordinates inside rotated or scaled parent containers, and \transformViewBoxPoint\ to correctly map coordinates when dragging within SVGs that use a viewBox. Several new React hooks are added: \useInView\ (with an \initial\ option) and \usePageInView\ for visibility detection, \useAnimationFrame\ for frame-based callbacks, \useComposedRefs\ for combining multiple refs, \useCycle\ for cycling through states, \useInstantTransition\ for immediate layout transitions, and \useMotionValueEvent\ for listening to motion value changes. It also includes \useIsomorphicLayoutEffect\ to safely handle SSR environments by falling back to \useEffect\ when not in a browser. Also in this area: Reorder auto-scroll scales by frame delta and onReorder passes the moved item.
packages/framer-motion/src/utils · high confidence
Support for animating SVG and DOM attributes via attr() effect
The library now supports animating HTML and SVG attributes (such as \cx\, \cy\, or \opacity\) through the new \attrEffect\ in \packages/motion-dom/src/effects/attr\. This change allows values to be applied directly as DOM properties when a setter exists, or as string attributes otherwise, with automatic camelCase-to-dash conversion for \data-\ and \aria-\ attributes. This enables smoother animation of SVG elements and other attribute-based properties that were previously unsupported.
packages/motion-dom/src/effects/attr · high confidence
Support for border-radius and rotation value mixing in projection animations
The projection animation system now correctly interpolates \borderRadius\ and \rotate\ properties during layout transitions. This change introduces logic to handle numeric, pixel, and percentage values for border radius, ensuring that incompatible units (e.g., px vs %) do not mix incorrectly, while also supporting smooth rotation interpolation between animation states.
packages/motion-dom/src/projection/animation · high confidence
Support for repeat and relative time definitions in animation sequences
Animation sequences now support the \repeat\ and \repeatDelay\ options, allowing keyframes to loop with configurable delays. Additionally, time definitions can now be specified relative to previous keyframes using syntax like \\<\ (start at previous end) or \\<+0.5\ (offset from previous end), providing more flexible timeline construction.
packages/framer-motion/src/animation/sequence/utils · high confidence
Removals
Removal of internal test and loader files
The internal test component (src/test.tsx), its export (src/index.ts), and the Webpack loader entry point (src/loader.ts) have been removed from the source code. This cleanup eliminates the 'Hello world' test component and the runtime checks for React/ReactDOM dependencies that were previously exposed or used for build validation.
src · high confidence
Removal of legacy Webpack-based development environment
The local development setup previously powered by Webpack has been removed. This includes the deletion of the Webpack configuration, the example listing application, the development entry point, and the bundled React runtime files. Developers will no longer be able to run the legacy Webpack dev server on port 9990 to view or edit examples.
dev/webpack · high confidence
Removal of test example component
The test example component located at dev/examples/test.tsx has been removed from the project. This file previously imported and rendered a Test component from the @framer package, and its deletion eliminates this specific example usage.
dev/examples · high confidence
Architecture
Build infrastructure and packaging configuration for motion-dom and motion-utils
This change introduces the build and packaging configuration files for the \motion-dom\ and \motion-utils\ packages. It adds Rollup configurations (\rollup.config.mjs\) that define build targets for UMD, CommonJS, and ES modules, including sourcemap support and production minification. Additionally, it includes TypeScript configurations (\tsconfig.json\), Jest test configurations (\jest.config.json\), \.npmignore\ files to control package contents, and \LICENSE.md\ files for both packages.
packages/motion-dom · high confidence
New modular feature registration system for motion components
The motion component library now uses a new feature registration system located in \src/motion/features\. This system introduces a \definitions.ts\ module that maps specific props (like \animate\, \drag\, \whileHover\) to their corresponding feature flags, and a \loadFeatures.ts\ module that allows these features to be registered or hydrated at runtime. New files define the structure for animation, drag, gesture, and layout features, enabling a more modular and potentially tree-shakeable architecture for how motion capabilities are enabled and managed within components.
packages/framer-motion/src/motion/features · high confidence
Refactor render architecture with Feature plugin system
The render logic in motion-dom has been restructured to use a new Feature plugin system, introducing a base Feature class and a centralized VisualElement abstraction. This change moves core rendering responsibilities (mounting, unmounting, and updating) into modular plugins, allowing framework-specific implementations to inject behavior like gestures, animations, or layout tracking more cleanly. The VisualElement class now serves as the central imperative abstraction for UI elements, managing motion values and coordinating with these features.
packages/motion-dom/src/render · high confidence
Repository restructured as a monorepo with Yarn 3 and Turborepo 2
The project has been reorganized into a monorepo structure with packages located in \/packages\ and development environments in \/dev\. The build system has migrated from Webpack to Turborepo 2.x (evidenced by the \turbo.json\ pipeline update) and the package manager has been upgraded to Yarn 3 (evidenced by \.yarnrc.yml\ and \yarnPath\). TypeScript linting has been removed (deletion of \tslint.json\), and the repository now enforces Node.js 22 via \.nvmrc\. The root \Makefile\ has been updated to support these new build and test commands.
(repo-wide) · high confidence
Behavioural changes
11 commits (2 fixes) modifying packages/motion-dom/src/utils/mix
A change to existing behaviour in packages/motion-dom/src/utils/mix — 11 commits (2 fixs), 14 files: “Adding warnings”; “Refactor animation APIs”; “Merge branch 'main' into fix/svg-transform-origin”; and 8 more.
packages/motion-dom/src/utils/mix · medium confidence · unverified
113 commits (14 fixes) modifying dev/inc
A change to existing behaviour in dev/inc — 113 commits (14 fixs), 5 files: “Add times, after and repeat options to press gesture”; “Raise size budgets for scopes, fix flaky spring-value test”; “Latest”; and 109 more (refs \#2503, \#3974, \#2232, \#1935, \#2579, …).
dev/inc · medium confidence · unverified
18 commits (1 fix) modifying packages/motion-dom/src/animation/waapi/supports
A change to existing behaviour in packages/motion-dom/src/animation/waapi/supports — 18 commits (1 fix), 2 files: “adding svg acceleration”; “Adding comment”; “Leave numbers to the usual blending with transition.mixer”; and 15 more.
packages/motion-dom/src/animation/waapi/supports · medium confidence · unverified
20 commits (1 fix) modifying packages/framer-motion/src/animation/timeline
A change to existing behaviour in packages/framer-motion/src/animation/timeline — 20 commits (1 fix), 1 file: “Prototype mutable timelines”; “Make repeated playback calls on a timeline cheaper”; “Share one repeat helper and keep the finished check”; and 17 more.
packages/framer-motion/src/animation/timeline · medium confidence · unverified
20 commits (1 fix) modifying packages/motion-dom/src/frameloop
A change to existing behaviour in packages/motion-dom/src/frameloop — 20 commits (1 fix), 11 files: “Release the last-run frame callback once a step finishes”; “Fixing scroll frame scheduling”; “Latest”; and 17 more (refs \#3816).
packages/motion-dom/src/frameloop · medium confidence · unverified
24 commits (3 fixes) modifying packages/motion-dom/src/gestures/drag
A change to existing behaviour in packages/motion-dom/src/gestures/drag — 24 commits (3 fixs), 6 files: “Trim drag, pan, VisualElement and the React gesture wrappers”; “drag(): Add x/y options to drive motion values without moving the element”; “Add an immediate option to start a drag from a pointer event”; and 21 more (refs \#2024, \#2255, \#2248).
packages/motion-dom/src/gestures/drag · medium confidence · unverified
29 commits (5 fixes) modifying packages/motion-dom/src/render/utils
A change to existing behaviour in packages/motion-dom/src/render/utils — 29 commits (5 fixs), 15 files: “Fix whileHover/whileTap staying applied after initial is removed (\#3787)”; “Drop more unused code when Motion is bundled into a flat library”; “Only rebase stayed values in development”; and 26 more (refs \#3787, \#1725).
packages/motion-dom/src/render/utils · medium confidence · unverified
4 commits (0 fixes) modifying packages/framer-motion/src/projection
A change to existing behaviour in packages/framer-motion/src/projection — 4 commits, 2 files: “run autofix”; “More size reductions”; “Move projection node system to motion-dom”; and 1 more (refs \#1417).
packages/framer-motion/src/projection · medium confidence · unverified
4 commits (0 fixes) modifying packages/motion-dom/src/animation/optimized-appear
A change to existing behaviour in packages/motion-dom/src/animation/optimized-appear — 4 commits, 3 files: “Drop more unused code when Motion is bundled into a flat library”; “Hand off appear animations with the mount animation's rule instead of a flag”; “Hand off optimised appear animations generated from initial's out”; and 1 more.
packages/motion-dom/src/animation/optimized-appear · medium confidence · unverified
43 commits (6 fixes) modifying dev/html/public/playwright/animate
A change to existing behaviour in dev/html/public/playwright/animate — 43 commits (6 fixs), 59 files: “Fixing DOM tests”; “Speed up starting, repeating and interrupting accelerated transforms”; “Write SVG path data as the d attribute in animate()”; and 36 more (refs \#3825).
dev/html/public/playwright/animate · medium confidence · unverified
5 commits (1 fix) modifying packages/motion-dom/src/value/types/color
A change to existing behaviour in packages/motion-dom/src/value/types/color — 5 commits (1 fix), 7 files: “Improve handling of 'none' values”; “Refactor animation APIs”; “Merge branch 'main' into fix/svg-transform-origin”; and 2 more.
packages/motion-dom/src/value/types/color · medium confidence · unverified
5 commits (2 fixes) modifying packages/motion-dom
A change to existing behaviour in packages/motion-dom — 5 commits (2 fixs), 2 files: “Fix timing flake in "built when played after a pause" test”; “Build on time after a seek or speed change while paused and waiting”; “Pause and play transform groups that are waiting to start without rebuilding”; and 2 more. Also in this area: Hardware-accelerated independent transform animations.
packages/motion-dom/src/animation/waapi/transforms, packages/motion-dom/src/gestures/press/\\tests\\_ · medium confidence · unverified_
6 commits (1 fix) modifying packages/motion-dom/src/stats
A change to existing behaviour in packages/motion-dom/src/stats — 6 commits (1 fix), 3 files: “Fixing scroll frame scheduling”; “Adding vanilla motionValue”; “Only count projection stats while recordStats() runs”; and 3 more.
packages/motion-dom/src/stats · medium confidence · unverified
6 commits (2 fixes) modifying packages/motion-dom/src/gestures/pan
A change to existing behaviour in packages/motion-dom/src/gestures/pan — 6 commits (2 fixs), 3 files: “Trim drag, pan, VisualElement and the React gesture wrappers”; “Add an immediate option to start a drag from a pointer event”; “Fix drag release velocity collapsing after a flick from a standstill”; and 3 more.
packages/motion-dom/src/gestures/pan · medium confidence · unverified
65 commits (15 fixes) modifying packages/framer-motion/src/components/Reorder
A change to existing behaviour in packages/framer-motion/src/components/Reorder — 65 commits (15 fixs), 7 files: “Only clear Reorder.Group's reorder guard when values change”; “Adding warnings”; “Prototype keyboard reordering for Reorder (\#2658)”; and 62 more (refs \#2658, \#2359, \#2232, \#2414, \#1712, …).
packages/framer-motion/src/components/Reorder · medium confidence · unverified
7 commits (1 fix) modifying packages/motion-dom/src/projection/utils
A change to existing behaviour in packages/motion-dom/src/projection/utils — 7 commits (1 fix), 5 files: “Fix rotateZ (and rotateX/Y, skew) in shared layout animations”; “Remove duplicate projection/utils code from framer-motion”; “Move VisualElement class hierarchy to motion-dom”; and 4 more.
packages/motion-dom/src/projection/utils · medium confidence · unverified
77 commits (12 fixes) modifying packages/motion-dom/src/projection/node
A change to existing behaviour in packages/motion-dom/src/projection/node — 77 commits (12 fixs), 7 files: “Animate shared layout animations relative to their layoutRoot (\#1935)”; “Refactor LayoutAnimationBuilder”; “Say where the projection node setup is bundled”; and 72 more (refs \#1935, \#1411, \#3839, \#1630, \#1436, …).
packages/motion-dom/src/projection/node · medium confidence · unverified
8 commits (2 fixes) modifying dev/remix
A change to existing behaviour in dev/remix — 8 commits (2 fixs), 19 files: “motion/remix: motion values as SVG attributes and as children”; “motion/remix: Reorder, holdPresence and shared layout exits”; “motion/remix: fixes from code review”; and 5 more.
dev/remix · medium confidence · unverified
9 commits (1 fix) modifying packages/motion-dom/src/projection/styles
A change to existing behaviour in packages/motion-dom/src/projection/styles — 9 commits (1 fix), 6 files: “Drop more unused code when Motion is bundled into a flat library”; “Keep a scale in scaled trees, reset projected styles on mount”; “Dedupe corner-radius longhands; merge crop box/radii measurements”; and 6 more.
packages/motion-dom/src/projection/styles · medium confidence · unverified
Added bundle integrity checks to prevent type inlining and dead-code elimination issues
A new build verification script has been added to ensure the distribution bundles meet specific quality and compatibility standards. This script validates that TypeScript declaration files are self-contained without relative imports or inlined type definitions (which previously caused assignability issues), that CJS bundles correctly share React context instances to support interoperability between different entry points, and that production UMD bundles do not contain unresolved environment variable checks that would prevent dead-code elimination of development warnings.
packages/framer-motion/scripts · high confidence
Added support detection for ViewTimeline and linear easing
The motion-dom package now includes runtime checks to detect browser support for ViewTimeline (scroll-linked animations) and linear easing functions. These new utility functions allow the library to gracefully handle environments that do not natively support these modern CSS animation features, preventing crashes and enabling appropriate fallbacks for scroll-linked and linearly eased animations.
packages/motion-dom/src/utils/supports · high confidence
Added utility to convert camelCase strings to dash-case
A new utility function, \camelToDash\, has been added to the DOM rendering utilities. This function converts camelCase identifiers (e.g., \backgroundColor\) into their dash-case equivalents (e.g., \background-color\), which is typically required for mapping JavaScript style properties to CSS custom properties or standard CSS rules.
packages/motion-dom/src/render/dom/utils · high confidence
AnimateSharedLayout component deprecated with runtime warning
The AnimateSharedLayout component now displays a runtime error warning when rendered, directing users to the shared layout animations upgrade guide. This change marks the component as deprecated in favor of the new LayoutGroup-based approach, ensuring users are notified of the API shift during development.
packages/framer-motion/src/components · high confidence
Animation performance, arc pathing, and inspection hooks
This update introduces several improvements to the animation engine in motion-dom. It adds an \arc()\ utility for creating curved motion paths with configurable strength, peak, and rotation. Performance is enhanced by deferring Promise allocation until the \finished\ property is accessed and by optimizing active animation tracking via a WeakMap. The system now supports transition inheritance through a new \inherit\ option and prevents visual jumps by starting animations from their first frame if they are more than 40ms late. Additionally, an optional inspection hook (\globalThis.\_\_MOTION\INSPECT\\_\) is provided for debugging, and CSS variable parsing is improved to handle fallbacks and nested variables.
packages/motion-dom/src/animation/utils · high confidence
Centralized animation orchestration in motion-dom
The animation logic for visual elements has been consolidated into the \motion-dom\ package, introducing dedicated modules for handling target animations, variant transitions, and individual motion values. This change establishes a unified entry point (\animateVisualElement\) that coordinates how elements respond to state changes and variant switches, ensuring consistent behavior across different rendering contexts while supporting features like animation handoffs and reduced-motion preferences.
packages/motion-dom/src/animation/interfaces · high confidence
Context providers updated for React Server Components and new configuration options
All context providers in the context directory (LayoutGroup, Lazy, MotionConfig, Presence, Reorder, and SwitchLayoutGroup) now include the 'use client' directive to ensure compatibility with React Server Components. The MotionConfig context has been expanded to support new configuration options including 'reducedMotion' for respecting device accessibility settings, 'nonce' for Content Security Policy compliance, 'skipAnimations' for testing, and 'isValidProp' for custom prop validation.
packages/framer-motion/src/context · high confidence
Deprecation of legacy scroll hooks
The \useElementScroll\ and \useViewportScroll\ hooks are now deprecated and emit warnings in development environments. Users should migrate to the unified \useScroll\ hook, passing a container reference for element-specific scrolling or calling it without arguments for viewport scrolling. The underlying \ScrollMotionValues\ interface remains available for internal use.
packages/framer-motion/src/value/scroll · high confidence
Enforce exclusion of React from the DOM bundle
A new build verification script has been added to ensure the motion-dom package does not include references to React in its distribution. This check reads the generated type definitions and fails the build if the string 'react' is found, preventing accidental inclusion of the React library in the standalone DOM bundle.
packages/motion-dom/scripts · high confidence
Expanded view-transition animation capabilities and bug fixes
The view animation system now supports advanced morphing features including automatic layout morphing for survivors, per-element staggered enter/exit animations, and cropped morphs that animate clip paths and border radii. A new \.class()\ escape hatch allows CSS-keyed view-transition layers, while \.add(from, to)\ enables shared-element morphs between different elements. The API has been refined by dropping legacy methods like \.get()\, \.new()\, \.old()\, and \.addName()\, and introducing \.new()\ and \.old()\ for explicit layer styling. Several correctness bugs were fixed, including issues with enter/exit application to persistent elements, duplicate view-transition names, and brightness flashes during crossfades.
dev/html/public/playwright/view · high confidence
Framer Motion rebrands to Motion with new package structure and build configuration
The library has officially rebranded from Framer Motion to Motion, with the README now instructing users to import from \motion/react\ instead of \framer-motion\. This change is supported by a new monorepo structure where the \packages/framer-motion\ directory now contains a comprehensive build setup (Rollup) and configuration files. The new \.npmignore\ file explicitly defines the published package contents, exposing subpaths for \dom\, \mini\, \m\, \client\, and \animate-view\. The build configuration (\rollup.config.mjs\) is updated to bundle TypeScript definitions into self-contained \.d.ts\ files and ensures React contexts are shared between the main CJS bundle and the \/m\ subpath to fix communication issues with components like \\<LazyMotion\>\. Additionally, the repository now includes dedicated Cypress configurations for testing against React 19 and React Server Components (RSC), alongside standard Jest configurations for unit and SSR testing.
packages/framer-motion · high confidence
Granular control over LayoutGroup inheritance via new 'inherit' prop
The LayoutGroup component now accepts an 'inherit' prop that allows users to precisely control whether child components inherit the group context, the ID context, or both. Previously, inheritance was likely all-or-nothing; now, setting 'inherit' to 'id' allows ID inheritance without group inheritance, while 'true' (the default) maintains the previous behavior of inheriting both. This change is implemented in the LayoutGroup component itself, which now checks the 'inherit' value to decide whether to concatenate upstream IDs or create a new node group, providing finer control over layout animation scoping.
packages/framer-motion/src/components/LayoutGroup · high confidence
HTML visual element ref forwarding validation
The HTML rendering layer now enforces that custom components forward their refs to actual HTML or SVG elements. If a ref is forwarded to a non-DOM node (such as a class instance or imperative handle), the library throws a clear error instead of silently failing or crashing, ensuring that motion styles and measurements are applied only to valid DOM targets.
packages/motion-dom/src/render/html · high confidence
Improved handling of 'none' values in complex CSS properties
The library now correctly resolves 'none' values for complex CSS properties like filters and masks, preventing issues such as invisible elements when animating mask gradients. This is achieved by introducing dedicated type handlers for filters and masks that ensure default values (e.g., 1 or 100%) are applied appropriately, and by refining the core complex value parser to avoid double-parsing and handle edge cases like calc() divisions without producing NaN.
packages/motion-dom/src/value/types/complex · high confidence
Improved keyframe resolution for CSS variables and 'none' values
The DOM keyframe resolver now automatically resolves CSS variable tokens by sampling the element's computed style and converts 'none' transform values into animatable defaults. It also handles unit mismatches between keyframes by measuring the element's bounding box when necessary, ensuring smoother animations when transitioning between different value types or undefined states.
packages/motion-dom/src/animation/keyframes · high confidence
Introduce DOM-specific rendering layer in motion-dom
This change introduces the core DOM rendering implementation within the \motion-dom\ package, establishing the concrete logic for how animations interact with the browser's DOM. It adds \DOMVisualElement\ to manage element state and child subscriptions, and implements specific utilities for style management (\style-set.ts\, \style-computed.ts\) and CSS variable detection (\is-css-var.ts\). A significant addition is \parse-transform.ts\, which provides the capability to parse computed CSS transform matrices (both 2D and 3D) into individual transform values (like rotation, scale, and translation), enabling the library to read and resolve independent transform values from the computed style. These files collectively define the 'how' of DOM updates, separating the platform-specific rendering details from the core animation engine.
packages/motion-dom/src/render/dom · high confidence
Introduce motion-dom value utilities for robust animation tracking
This change introduces a new set of utility functions in the motion-dom package to improve how animations track and respond to value changes. The new \follow\ utility enables values to animate towards a source (such as another MotionValue), specifically handling pre-attachment state changes to prevent missed updates and stopping orphaned animations on detach to avoid conflicts in strict modes. It also includes helper utilities like \isMotionValue\ for type checking, \as-number\ for consistent numeric parsing, and \resolve-motion-value\ to unwrap values, ensuring animations remain accurate and stable at high frame rates.
packages/motion-dom/src/value/utils · high confidence
Introduction of optimized appear animation handoff and will-change value management
This change introduces the core logic for optimized appear animations and will-change value handling within the motion-dom package. It adds a global handoff mechanism (via \Window.MotionHandoffAnimation\ and related methods) to bridge inline scripts with Motion for optimized appear animations, including utilities to retrieve the appear ID and define the necessary types. Additionally, it implements logic to manage the \willChange\ CSS property, allowing values to be added to a specialized \WillChange\ MotionValue or creating one if the global configuration permits, thereby improving rendering performance for animated elements.
packages/motion-dom/src/value/will-change · medium confidence
LazyMotion component now supports synchronous feature loading
The LazyMotion component has been updated to handle both synchronous and asynchronous feature bundles. Previously, it primarily supported asynchronous loading via a function that returns a Promise. The new implementation detects whether the provided \features\ prop is a synchronous \FeatureBundle\ or a lazy \LazyFeatureBundle\. If synchronous, it loads the features immediately during render, setting the renderer and state right away. If asynchronous, it continues to load the features via \useEffect\ and updates the state once loaded. This change allows developers to use \LazyMotion\ with pre-loaded feature bundles (like \domAnimation\) without the overhead of an async import, while still supporting code-splitting via dynamic imports.
packages/framer-motion/src/components/LazyMotion · high confidence
Motion package restructuring and new React entry points
The motion package has been restructured to support new library-specific entry points, including \motion/react-animate-view\ for React View transitions (requiring React 19.3+) and \motion/react-m\. The build system now bundles these distinct entry points (react, mini, react-client, react-m, debug, three, vgpu) into separate ES and CJS modules, and the package now includes an \.npmignore\ file to control published contents. Documentation has been updated to reflect the migration from \framer-motion\ to \motion/react\, added sections for AI integration and Motion Studio, and clarified Motion+ licensing.
packages/motion · high confidence
New NodeStack class for managing shared layout node hierarchy
A new NodeStack class has been introduced in the motion-dom projection system to manage the hierarchy and lifecycle of shared layout nodes. This component tracks the current and previous 'lead' nodes within a group, handling the promotion and relegation of nodes as they enter or leave the DOM. It ensures that layout snapshots and animation states are correctly transferred between nodes during transitions, which supports the fixes for layout dependency issues and stale node states during single-page application navigations.
packages/motion-dom/src/projection/shared · high confidence
New \`motion.create()\` API for dynamic component creation
The library now supports a \motion.create()\ method, allowing users to dynamically generate motion-wrapped components at runtime (e.g., \motion.create('div')\). This new API is the recommended approach, while the legacy \motion(Component)\ pattern is retained for backward compatibility but now emits a deprecation warning via \warnOnce\ to guide users toward the new method.
packages/framer-motion/src/render/components · high confidence
New animation type definitions for keyframe resolution
The animation module now includes a new \types.ts\ file that exports the \ResolveKeyframes\ type. This type defines the signature for functions that resolve keyframes, accepting an array of resolved keyframes, a completion callback, an optional name, and an optional motion value, and returning a \KeyframeResolver\. This provides explicit type definitions for the keyframe resolution logic within the animation system.
packages/framer-motion/src/animation · medium confidence
New extensible animation effect system and unified element animation
The animation engine now supports a new effect system via \animate.addEffect()\, allowing custom animation targets beyond standard DOM elements. HTML and SVG elements are animated through dedicated \styleEffect\ and \svgEffect\ adapters, which share a single \MotionValueState\ per element to ensure consistency between \animate()\ calls and style updates. The \animateElement()\ function now drives DOM elements through these effects and the DOM keyframe resolver, enabling batched reads and unit conversion, while \handOffElementState()\ allows \VisualElement\ instances to take ownership of existing animation values for unified rendering. Also in this area: 5 commits (0 fixes) modifying packages/motion-dom/src/animation; Fixes to drag gesture stability and introduction of a vanilla drag() API; Fixes for motion path animation and accelerated transform stability.
packages/motion-dom/src/animation/animate · medium confidence · unverified
New gesture handling system for focus, hover, and press interactions
The gesture subsystem has been restructured into dedicated modules (focus, hover, press) that leverage the new 'motion-dom' event utilities. Users can now rely on improved accessibility with the focus gesture, which respects the :focus-visible selector to ensure animations only trigger when focus is keyboard-visible. The press gesture now includes a fix to ignore events on disabled buttons and supports a new propagate option (propagate={{ tap: false }}) to prevent parent tap handlers from firing. The hover gesture utilizes passive event listeners for better performance.
packages/framer-motion/src/gestures · high confidence
New optimized appear animation handoff system
This change introduces a new internal mechanism for handling 'optimized appear' animations, specifically focusing on the handoff between server-side rendering and client-side hydration. The diff adds four new files (\handoff.ts\, \start.ts\, \store-id.ts\, \store.ts\) that implement a store-based system to track and synchronize animations during the initial paint. Key features include a 'ready' animation to detect when Chrome is prepared to paint, a handoff function that transfers animation state from the server to the client, and logic to cancel or suspend animations if they conflict with layout measurements or if styles differ. This ensures that appear animations start smoothly and in sync with the GPU, preventing visual glitches during hydration.
packages/framer-motion/src/animation/optimized-appear · high confidence
New render type definitions and VisualElement options
The render module now includes a new types.ts file that defines core interfaces for the rendering system, including VisualElementOptions which introduces explicit support for SVG detection (isSVG) and animation skipping for testing (skipAnimations). This change establishes the type foundation for the VisualElement class and its configuration, separating render-specific types from the core motion logic.
packages/framer-motion/src/render · high confidence
New utility functions and type definitions for drag and animation states
This change introduces new utility code in the render utils module to support drag interactions and animation state tracking. A new \isDraggable\ function has been added to determine if a visual element is currently draggable by checking its props, and a new \AnimationType\ union type has been defined to explicitly list valid animation states such as 'animate', 'whileHover', 'whileTap', 'whileDrag', 'whileFocus', 'whileInView', and 'exit'.
packages/framer-motion/src/render/utils · high confidence
New utility functions for interpolation, element resolution, and staggered animations
The motion-dom package now includes a suite of new utility functions in its utils directory to support core animation logic. Users benefit from improved iframe compatibility through new \isHTMLElement\, \isSVGElement\, and \isSVGSVGElement\ checks that rely on DOM properties rather than \instanceof\. The \resolveElements\ function provides a robust way to convert selectors or element lists into arrays, respecting animation scopes. Additionally, new \interpolate\ and \transform\ functions enable mapping input ranges to output values with support for easing and clamping, while \stagger\ allows for calculating delays based on element index and origin. A \delay\ utility is also added for frame-accurate timeouts, and \borderRadius\ props are centralized for consistent handling. Also in this area: Fixes to drag gesture stability and introduction of a vanilla drag() API.
packages/motion-dom/src/utils · high confidence
Optimized will-change handling for transform animations
The library now uses a dedicated \WillChangeMotionValue\ to manage the CSS \will-change\ property, restricting it to only track \transform\ properties. This change ensures that \will-change\ is set to \transform\ only when a transform animation is active, and reverts to \auto\ otherwise, reducing unnecessary browser repaints and improving performance for non-transform animations.
packages/framer-motion/src/value/use-will-change · high confidence
Projection scale correction for border-radius and box-shadow
The projection system now automatically corrects \border-radius\ and \box-shadow\ values when elements are scaled. Pixel-based border radii are converted to percentages to prevent unnecessary layout paints during animation, while box-shadow offsets, blur, and spread are adjusted to match the projection scale. These corrections are registered by default when the projection node is loaded, ensuring visual consistency without requiring manual configuration. Also in this area: 1 commit (0 fixes) modifying packages/motion-dom/src/projection.
packages/motion-dom/src/projection/styles/\\tests\\_ · medium confidence · unverified_
Reduced motion detection now warns in development and supports RSC
The library now includes a new \useReducedMotion\ hook that detects the device's reduced motion preference and actively warns developers in development mode if animations are disabled, helping to identify potential UX issues. Additionally, the reduced-motion utilities have been updated with the 'use client' directive to ensure compatibility with React Server Components.
packages/framer-motion/src/utils/reduced-motion · high confidence
Refactor HTML style and transform rendering utilities
The HTML rendering pipeline in motion-dom has been restructured into dedicated utility modules (build-styles, build-transform, render, scrape-motion-values) to improve how CSS styles and transforms are computed and applied. This change introduces explicit handling for transform defaults, ensuring that 'none' is correctly resolved when no transform values are present, and fixes a bug where string scale values of zero were incorrectly treated as default values. It also adds support for non-destructive path rotation and ensures CSS variables are properly applied via setProperty, while scraping motion values from props is now isolated in its own function for cleaner separation of concerns.
packages/motion-dom/src/render/html/utils · high confidence
Refactor animation keyframe offsets and value type definitions
This change refactors the internal handling of animation keyframes and value types. In the keyframe offsets module, new logic has been introduced to automatically generate default offsets for animation sequences, convert these offsets into time-based values, and fill gaps in offset arrays to ensure smooth interpolation. Additionally, the value types system has been restructured with new TypeScript definitions for value types, including support for 'auto' values, dimensional units (pixels, percentages, degrees, viewport units), integers, and a testing utility to identify value types. These changes improve the robustness of animation offset calculations and provide a more structured approach to parsing and transforming CSS-like values.
packages/motion-dom/src/animation/keyframes/offsets, packages/motion-dom/src/value/types, packages/motion-utils/src/types · high confidence
Refactored CSS value type mapping system
The internal system for mapping CSS properties to animation value types has been reorganized into a modular structure. The previous monolithic configuration is now split into dedicated files: \number.ts\ handles numeric properties (including logical inset/margin/padding properties and \fontSize\), \transform.ts\ manages transform-related properties (including a new \pathRotation\ channel for non-destructive path-based rotation), and \defaults.ts\ aggregates color, filter, and mask types. This change improves the maintainability of the value type registry without altering the external API.
packages/motion-dom/src/value/types/maps · high confidence
Refactored DOM prop filtering and SVG detection logic
The internal utilities for handling DOM props and identifying SVG components have been restructured. The new \filterProps\ function in \filter-props.ts\ now explicitly handles the forwarding of motion-specific props, supports custom prop validation via an \isValidProp\ callback, and prevents invalid props like \values\ from leaking into the DOM when used with SVG elements. Additionally, \is-svg-component.ts\ introduces a stricter heuristic for detecting SVG components by checking against a list of lowercase SVG tags and identifying custom components by capitalization, ensuring that only appropriate elements are treated as SVGs during rendering.
packages/framer-motion/src/render/dom/utils · medium confidence
Refactored HTML rendering internals and added React Server Components support
The HTML rendering layer has been restructured to improve compatibility with React Server Components and streamline internal logic. New files in the render/html directory introduce explicit type definitions for all standard HTML elements and establish a dedicated visual state hook marked with the 'use client' directive, ensuring correct client-side execution boundaries. The props handling logic has been updated to automatically manage accessibility and interaction behaviors, such as setting tabIndex for tap events and disabling text selection during drag operations, while the underlying render state creation has been modularized for better maintainability.
packages/framer-motion/src/render/html · high confidence
Refactored MotionContext to support React Server Components
The MotionContext implementation has been restructured into separate files (create.ts, index.ts, utils.ts) and updated with the 'use client' directive to ensure compatibility with React Server Components. This change allows framer-motion to function correctly in RSC environments by explicitly marking the context logic as client-side code, while also consolidating variant resolution logic into a dedicated utility function.
packages/framer-motion/src/context/MotionContext · high confidence
Refactored SVG rendering internals and type definitions
The SVG rendering module has been restructured to improve type safety and runtime performance. New files define explicit lists of supported SVG elements and their attributes, while type definitions now correctly map motion props to SVG components. The rendering logic has been updated to use a dedicated SVG render state and attribute builder, ensuring that SVG-specific attributes are handled consistently during animations.
packages/framer-motion/src/render/svg · high confidence
Refactored animate() to support object targets and callback sequences
The \animate()\ function has been refactored to support animating plain JavaScript objects (not just DOM elements) by introducing an \ObjectTarget\ type and a new effect-driven resolution system. Additionally, animation sequences now support callback functions as segments, which are executed via MotionValue change listeners, and the \onComplete\ callback is guaranteed to fire once after the entire group finishes. The implementation also gracefully handles null/undefined subjects and respects \reduceMotion\ and \skipAnimations\ options passed through the scoped animate instance.
packages/framer-motion/src/animation/animate · high confidence
Refactored animation engine with new Async and Follow animation classes
The animation engine in motion-dom has been refactored to improve performance and accuracy. A new AsyncMotionValueAnimation class now handles asynchronous keyframe resolution, allowing animations to start immediately while keyframes are being computed, with a fallback to JSAnimation if Web Animations API (WAAPI) is unsupported. A new FollowAnimation class provides a lightweight, shared-frame-callback mechanism for values that follow a target (like springValue), significantly reducing overhead for followers. GroupAnimation now supports iterationDuration and properly aggregates animation controls. NativeAnimationExtended uses a renderless JSAnimation to sample values for accurate velocity calculation during WAAPI interruptions, preventing visual jumps. The frameloop driver now uses framelocked timestamps when processing to keep animations in sync.
packages/motion-dom/src/animation · high confidence
Refactored animation generator utilities with new duration and velocity helpers
The animation generator utilities have been restructured to improve how keyframe durations are calculated and how velocity is sampled. A new \calcGeneratorDuration\ function now enforces a maximum duration (20 seconds) to prevent infinite loops during keyframe generation, while \pregenerateKeyframes\ uses a tighter 10-second limit and 10ms time step for precomputed animations. Velocity calculation has been split into \getGeneratorVelocity\ for finite-difference sampling and \calcGeneratorVelocity\ to handle both analytical (spring) and numerical velocity, ensuring consistent velocity data is available for animations like JSAnimation and FollowAnimation. Additionally, \createGeneratorEasing\ now leverages these utilities to generate easing functions from generators, and an \isGenerator\ type guard has been added to identify valid generator factories.
packages/motion-dom/src/animation/generators/utils · high confidence
Refactored animation generators with new inertia support and spring physics improvements
The animation engine in the motion-dom package has been refactored to improve performance and add new capabilities. A new inertia generator has been introduced, allowing animations to simulate momentum-based movement with friction and bounce boundaries. The spring generator has been consolidated and optimized, including faster retargeting and support for negative spring bounce values to create overdamped effects. Additionally, the keyframes generator now includes fast paths for simple two-keyframe animations and handles unrecognized easing functions by falling back to easeInOut.
packages/motion-dom/src/animation/generators · high confidence
Refactored animation sequence engine with new type definitions and callback handling
The animation sequence logic in \packages/framer-motion/src/animation/sequence\ has been refactored to improve type safety and callback management. The \create.ts\ module now explicitly handles timeline labels, relative/absolute time offsets, and spring easing generation within the sequence parsing loop. Concurrently, \types.ts\ introduces strict type definitions for sequence segments, explicitly disallowing lifecycle callbacks (like \onComplete\, \onUpdate\) on individual segment options in favor of sequence-level options defined in \SequenceOptions\. This change ensures that callbacks are fired correctly at the sequence level rather than being lost or misapplied to individual segments.
packages/framer-motion/src/animation/sequence · high confidence
Refactored animation value type utilities
The animation value type utilities in \packages/motion-dom/src/value/types/utils\ have been reorganized into individual modules. This includes new files for handling \animatable-none\ values (using a Set for custom types like filter and mask to support tree shaking), color and float regular expressions, value type detection (\findValueType\), and utility functions for sanitization and null checks. This structural change supports the broader refactoring of animation APIs by isolating core type-handling logic.
packages/motion-dom/src/value/types/utils · high confidence
Refactored exit animation logic into a dedicated feature module
The exit animation handling has been extracted from the core animation logic into a new, standalone \ExitAnimationFeature\ class located in \packages/framer-motion/src/motion/features/animation/exit.ts\. This change isolates the state management for exit animations, including tracking completion via a dedicated \exit\ field and handling re-entry scenarios where an element re-enters after an exit has completed. The main \AnimationFeature\ in \index.ts\ now focuses on managing the \AnimationState\ and \AnimationControls\ subscriptions, while the new exit feature specifically manages the lifecycle of exit animations and their interaction with the presence context.
packages/framer-motion/src/motion/features/animation · high confidence
Refactored keyboard press handling and accessibility utilities
The press gesture's keyboard support has been refactored to prevent listener accumulation and improve accessibility logic. A new \keyboard.ts\ utility now scopes keydown/keyup listeners to the focused element, removing them on blur to fix a bug where listeners leaked and caused duplicate events on repeated Enter presses. Additionally, \is-keyboard-accessible.ts\ introduces a shared utility to identify natively focusable elements (buttons, inputs, links, etc.) and a separate check for text-input elements, allowing drag gestures to correctly initiate from child buttons and links without being blocked by text-selection behaviors.
packages/motion-dom/src/gestures/press/utils · high confidence
Refactored keyframe utility functions for unit conversion and value resolution
The keyframe utility module has been restructured into specific helper files to improve code organization and maintainability. New utilities include \applyPxDefaults\ for automatically appending 'px' units to numeric values where appropriate, \fillWildcards\ to propagate previous keyframe values to undefined slots, \isNone\ for robust detection of null/zero/none states, and \makeNoneKeyframesAnimatable\ to convert 'none' keyframes into animatable zero-equivalents based on surrounding complex values. Additionally, \unit-conversion.ts\ now centralizes logic for measuring dimensions from computed styles (handling box-sizing correctly) and removing non-translational transforms before measurement, replacing previous ad-hoc implementations.
packages/motion-dom/src/animation/keyframes/utils · high confidence
Refactored motion component creation and type definitions
The \motion\ component implementation has been restructured to use a new \createMotionComponent\ factory function, which now explicitly supports an optional \type\ option to force SVG rendering for custom components that are otherwise auto-detected as HTML. The component's props and style types have been consolidated into dedicated \MotionProps\ and \MotionStyle\ interfaces, enhancing type safety for motion values and CSS properties.
packages/framer-motion/src/motion · high confidence
Refactored motion component internals and added ref handling tests
The internal utilities for motion components have been restructured to improve modularity and React 19 compatibility. A new \useMotionRef\ hook now manages external refs, correctly handling React 19's cleanup-returning callback refs and preventing unnecessary remounts when used with libraries like Radix UI. Utility functions \isMotionComponent\ and \unwrapMotionComponent\ were added to safely identify and unwrap motion components using a dedicated symbol. The \useVisualElement\ hook was updated to better handle hydration handoffs and ensure animations replay when Suspense boundaries resolve. Additionally, a new test suite for \useMotionRef\ was added to verify correct ref callback behavior on mount, unmount, and with ref object transitions.
packages/framer-motion/src/motion/utils · high confidence
Refactored pan gesture handling to use async event batching
The pan gesture implementation in \packages/framer-motion/src/gestures/pan\ has been rewritten to wrap event handlers (\onPanSessionStart\, \onPanStart\, \onPan\) in an asynchronous wrapper that schedules updates via \frame.update\. This change allows React to batch state updates triggered by pan events, potentially improving performance and preventing intermediate re-renders during rapid interactions. The \onPanEnd\ handler continues to use \frame.postRender\ for finalization.
packages/framer-motion/src/gestures/pan · high confidence
Refactored projection geometry to fix layout animations with percentage values
The projection geometry logic has been restructured into dedicated modules (conversion, copy, delta-apply, delta-calc, delta-remove, models, and utils) to improve code organization and reduce per-frame allocations. Crucially, this change fixes a bug where layout animations would break when parent elements used percentage-based x/y values; the system now correctly resolves these percentages within the transform box calculation, ensuring accurate projection and animation behavior.
packages/motion-dom/src/projection/geometry · high confidence
Refactored scroll animation engine with native ViewTimeline support and unified scroll info
The scroll rendering logic has been rewritten to support native browser ViewTimelines for scroll-linked animations, falling back to a JS-driven observer when native timelines are unavailable or when specific offsets are required. The new \scroll()\ API accepts both callback functions and animation controls, automatically attaching to the appropriate timeline (ScrollTimeline or ViewTimeline) based on the provided target and offset. Scroll progress, velocity, and offset calculations are now centralized in a \scrollInfo\ system that measures containers once per frame and notifies all registered handlers, improving performance and consistency. The implementation also handles reversed animations, dynamic content size changes via \trackContentSize\, and provides detailed scroll info including target offsets and container dimensions.
packages/framer-motion/src/render/dom/scroll · high confidence
Refactored scroll offset resolution and added comprehensive tests
The scroll offset calculation logic in \packages/framer-motion/src/render/dom/scroll/offsets\ has been refactored to derive progress directly from resolved pixel offsets rather than using an external interpolator, and now supports a wider range of input formats including named edges (\start\, \center\, \end\), percentages, viewport units (\vw\, \vh\), and pixel values. This change introduces new internal modules (\edge.ts\, \offset.ts\, \inset.ts\, \presets.ts\) to handle these resolutions and includes a full suite of unit tests (\edge.test.ts\, \offset.test.ts\, \progress.test.ts\) to verify correctness against previous behavior and handle edge cases like SVG offset measurement.
packages/framer-motion/src/render/dom/scroll/offsets · high confidence
Refactored value hooks and introduced useFollowValue
The value hooks in \packages/framer-motion/src/value\ have been refactored to use a new internal \useFollowValue\ hook (renamed from \useAnimatedValue\), which unifies animation logic by accepting any transition type (spring, tween, inertia, keyframes) rather than being limited to springs. \useSpring\ is now a thin wrapper around this new hook. New hooks \useComputed\ and \useCombineMotionValues\ were added to support dynamic value derivation and combination. \useScroll\ was updated to use microtask batching for better hydration timing and to support ViewTimeline acceleration. \useInvertedScale\ is now deprecated in favor of the layout prop.
packages/framer-motion/src/value · high confidence
SVG animation effects now use CSS styles for transforms and unitless values for dash arrays
The SVG effect system has been updated to write transform and origin properties (such as x, scaleX, rotateX) to the element's CSS style object rather than as SVG attributes, ensuring consistent rendering across browsers. Additionally, stroke-dasharray and stroke-dashoffset values are now applied as unitless numbers to prevent zooming bugs in Safari, and the system now falls back to reading SVG attributes when computed styles are empty.
packages/motion-dom/src/effects/svg · high confidence
SVG transform and style reading logic refactored
The SVG rendering engine now handles independent transforms and CSS properties more accurately. Transforms no longer use SVG attributes (like \x\ or \y\) as their base; instead, they derive from the style object or default values, preventing conflicts with positional attributes. Additionally, CSS style properties are now read directly from the computed style, ensuring that animations respect inline styles and external CSS rules rather than relying solely on SVG attributes.
packages/motion-dom/src/render/svg · high confidence
Support for motion values as children and improved SVG handling
Framer Motion now accepts MotionValues directly as children of motion components, automatically rendering their current value and updating the DOM when the value changes. Additionally, SVG visual elements are now created with explicit type support, allowing for better handling of SVG-specific properties and animations through the new createDomVisualElement factory.
packages/framer-motion/src/render/dom · high confidence
Viewport detection now uses a shared IntersectionObserver pool
The viewport feature now manages IntersectionObserver instances via a shared pool keyed by root and settings, rather than creating a new observer for every element. This reduces memory overhead and ensures that viewport state updates are batched efficiently. The \InViewFeature\ now only restarts the observer when viewport options (amount, margin, root) actually change, improving performance during prop updates.
packages/framer-motion/src/motion/features/viewport · high confidence
WAAPI acceleration expanded for modern color formats and logical properties
The animation engine now forces Web Animations API (WAAPI) acceleration for browser-only CSS color formats (oklch, oklab, lab, lch, color, color-mix, light-dark) to ensure correct rendering, while restricting general color acceleration to backgroundColor. It also adds support for CSS logical properties (inset, padding, margin) and fontSize in pixel-based value handling, and introduces utilities for generating linear easing strings and replacing unsupported easing functions.
packages/motion-dom/src/animation/waapi/utils · high confidence
Fixes
Fix Safari zoom bug in SVG stroke-dash animations
SVG stroke-dash animations now use unitless values for stroke-dashoffset and stroke-dasharray properties, resolving a zoom-related rendering bug in Safari. This change is supported by new tests verifying that the buildSVGPath utility generates the correct unitless attribute values.
packages/framer-motion/src/render/svg/utils · high confidence
Fix for handling multiple concurrent press gestures
This change fixes an issue where adding multiple press gestures on the same element could fail or behave incorrectly. The fix introduces a new \isPrimaryPointer\ utility to correctly distinguish between primary and secondary pointer events (e.g., distinguishing between a mouse click and a touch point), and a \setupGesture\ helper that manages gesture lifecycle via an AbortController scoped to the element. This ensures that concurrent gestures are handled independently and cleaned up properly when the element is removed or the gesture is cancelled.
packages/motion-dom/src/gestures/utils · high confidence
Fixes for SVG rendering, Safari zoom bugs, and style/attribute handling
This update resolves several SVG rendering issues by introducing a new utility layer in motion-dom. It fixes a Safari zoom bug by ensuring stroke-dash values are unitless, corrects the handling of SVG MotionValue children to prevent them from being incorrectly written as attributes, and ensures SVG CSS properties (such as opacity, clipPath, and filter) are rendered via styles to avoid zero-duration desyncs and WAAPI override conflicts. Additionally, it standardizes attribute casing for specific SVG properties and consolidates style property handling.
packages/motion-dom/src/render/svg/utils · high confidence
Test coverage
101 commits adding/updating tests in tests/react; 11 commits adding/updating tests in packages/framer-motion/src/animation/sequence/utils/\_\tests\\; 11 commits adding/updating tests in packages/framer-motion/src/animation/timeline/\\tests\\; 11 commits adding/updating tests in packages/framer-motion/src/projection/\\tests\\; 11 commits adding/updating tests in packages/motion-dom/src/gestures/drag/\\tests\\; 11 commits adding/updating tests in tests/remix; 2 commits adding/updating tests in packages/motion-dom/src/projection/utils/\\tests\\; 25 commits adding/updating tests in packages/motion/src/\\tests\\; 34 commits adding/updating tests in packages/motion-dom/src/value/\\tests\\; 37 commits adding/updating tests in packages/motion-dom/src/animation/\\tests\\; 38 commits adding/updating tests in packages/framer-motion/src/animation/animate/\\tests\\; 41 commits adding/updating tests in packages/framer-motion/src/components/Reorder/\\tests\\; 5 commits adding/updating tests in packages/motion-dom/src/stats/\\tests\\; 53 commits adding/updating tests in tests/animate; 9 commits adding/updating tests in packages/motion-dom/src/frameloop/\\tests\\_; Added Cypress \nextFrame\ command for animation synchronization; Added Cypress integration test for React Server Components; Added HTML integration tests for layout, appear, and projection animations; Added Playwright test coverage for attr and SVG effects; Added Playwright tests for animateLayout shared element animations; Added Playwright tests for drag, hover, and press gestures; Added Playwright tests for scroll progress and ViewTimeline parity; Added Playwright tests for scroll progress and ViewTimeline parity; Added Playwright tests for view-target resolution and morph behaviors; Added WAAPI easing support utilities and tests; Added comprehensive tests for drag gesture behavior and controls; Added optimized-appear test scenarios for layout animation conflicts; Added projection animation and scroll layout test demos; Added reproduction test fixtures for AnimatePresence and animation edge cases; Added test coverage for WAAPI animation, transition inheritance, and React hooks; Added test coverage for WAAPI animator; Added test coverage for animation generators; Added test coverage for animation utility functions; Added test coverage for event handling utilities; Added test coverage for gesture interactions; Added test coverage for motion-dom effects and state management; Added test coverage for the new animation effects and element animation system; Added test suite for motion component behavior; Added test suite for projection node system in motion-dom; Added test utilities for synchronous animation driver simulation; Added tests for AnimatePresence re-entry, presence hooks, and React 18.3 ref warnings; Added tests for HTML style and transform building utilities; Added tests for HTML useProps hook; Added tests for LayoutGroup context and relative child layout behavior; Added tests for MotionConfig transition inheritance, custom prop validation, and animation control flags; Added tests for MotionContext utility functions; Added tests for Reorder auto-scroll and layout logic; Added tests for SVG motion value scraping logic; Added tests for SVGVisualElement CSS property reading; Added tests for WAAPI support detection logic; Added tests for animation sequence creation; Added tests for getFinalKeyframe logic; Added tests for hardware-accelerated independent transform animations; Added tests for non-browser runtime safety and legacy path hooks; Added tests for scroll info tracking and measurement optimization; Added tests for scroll offset to ViewTimeline range mapping; Added tests for shallowCompare utility; Added tests for transform parsing logic; Added tests for useAnimate and useAnimatedState hooks; Added tests for value type parsing and tokenization; Added tests for view transition name assignment and animation queue error handling; Added tests for will-change behavior and SSR compatibility; Added unit tests for HTMLVisualElement; Added unit tests for SVG property handling; Added unit tests for animation sequence utility functions; Added unit tests for animation state, variants, and flat-tree utilities; Added unit tests for easing functions; Added unit tests for framer-motion utility hooks and functions; Added unit tests for framer-motion value hooks and primitives; Added unit tests for keyframe utility functions; Added unit tests for motion-utils utility functions; Added unit tests for projection geometry utilities; Added unit tests for reduced motion listener initialization; Expanded Cypress E2E test coverage for AnimatePresence and animation APIs; New Playwright effect demos for SVG attributes and transforms.
Dependencies
Release of Motion 14.0.0 with React 19 support and new subpath exports
The core \motion\ and \framer-motion\ packages have been updated to version 14.0.0. This release adds explicit support for React 19 in peer dependencies and introduces new subpath exports for \react-client\, \react-m\, and \react-mini\ entry points. Development environments have been upgraded to use Next.js 15.5.24 and Vite 6.4.2, with the \react-19-env\ dev environment now pinning React 19.3.0 to validate compatibility.
(dependencies) · high confidence
Updated Yarn to version 3.6.4
The project's bundled Yarn binary has been updated to version 3.6.4. This change ensures that package installation and management operations use the latest features and fixes provided by this specific release of the Yarn package manager.
.yarn/releases · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
This is the PUBLIC form of this artifact. Findings are listed in full, but the details of SECURITY findings — which rule fired, in which file, on which line, and how to fix it — are deliberately withheld, and any secret-scanner results are excluded entirely. Where detail is absent here it was REMOVED FOR PUBLICATION; it is not missing from the analysis. The complete artifact is available from the repository owner.
Score
- CAI 45 → 42 (-3.2)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.
Lenses
- Code Health 63 → 64 (+0.9)
- Architecture 56 → 55 (-0.4)
- Maturity 51 → 60 (+9.3)
- Readiness 39 → 36 (-2.7)
- Security 67 → 75 (+7.6)
- Accessibility 46 → 35 (-11.3)
- Performance 60 → 60 (+0.0)
Resolved (117)
- Cross-context type AnyResolvedKeyframe (motion-dom → framer-motion) (packages/framer-motion/src/animation/sequence/types.ts)
- Cross-context type AnyResolvedKeyframe (motion-dom → framer-motion) (packages/framer-motion/src/render/html/use-props.ts)
- Cross-context type AnyResolvedKeyframe (motion-dom → framer-motion) (packages/framer-motion/src/value/use-follow-value.ts)
- Cross-context type AnyResolvedKeyframe (motion-dom → framer-motion) (packages/framer-motion/src/value/use-follow-value.ts)
- Cross-context type AnyResolvedKeyframe (motion-dom → framer-motion) (packages/framer-motion/src/value/use-transform.ts)
- Cross-context type Easing (motion-utils → framer-motion) (packages/framer-motion/src/animation/sequence/types.ts)
- Cross-context type Easing (motion-utils → framer-motion) (packages/framer-motion/src/animation/sequence/utils/edit.ts)
- Cross-context type Easing (motion-utils → motion-dom) (packages/motion-dom/src/animation/types.ts)
- Cross-context type Easing (motion-utils → motion-dom) (packages/motion-dom/src/animation/waapi/easing/is-supported.ts)
- Cross-context type Easing (motion-utils → motion-dom) (packages/motion-dom/src/animation/waapi/easing/map-easing.ts)
- Cross-context type ElementOrSelector (motion-dom → framer-motion) (packages/framer-motion/src/animation/animate/subject.ts)
- Cross-context type ElementOrSelector (motion-dom → framer-motion) (packages/framer-motion/src/animation/animators/waapi/animate-elements.ts)
- Cross-context type ElementOrSelector (motion-dom → framer-motion) (packages/framer-motion/src/render/dom/viewport/index.ts)
- Cross-context type Transition (motion-dom → framer-motion) (packages/framer-motion/src/animation/sequence/types.ts)
- Cross-context type Transition (motion-dom → framer-motion) (packages/framer-motion/src/components/AnimateView/types.ts)
- Cross-context type Transition (motion-dom → framer-motion) (packages/framer-motion/src/context/MotionConfigContext.tsx)
- Cross-context type UnresolvedValueKeyframe (motion-dom → framer-motion) (packages/framer-motion/src/animation/animate/subject.ts)
- Cross-context type UnresolvedValueKeyframe (motion-dom → framer-motion) (packages/framer-motion/src/animation/sequence/utils/edit.ts)
- FunctionTooLong: spring.spring (packages/motion-dom/src/animation/generators/spring.ts)
- High CVE: [GHSA redacted] (yarn.lock)
- …and 97 more
New (77)
- Board.createBoard.drag (cognitive 17) (packages/framer-motion/src/components/Reorder/Board.tsx)
- Dependency hygiene PARTLY measured — npm pinning read, dependency currency not (registry.npmjs.org unreachable)
- FileTooLong: src/remix.ts (packages/framer-motion/src/remix.ts)
- FunctionTooLong: Board.createBoard (packages/framer-motion/src/components/Reorder/Board.tsx)
- FunctionTooLong: index.createScopedAnimate (packages/framer-motion/src/animation/animate/index.ts)
- FunctionTooLong: remix-reorder.createReorder (packages/framer-motion/src/remix-reorder.ts)
- FunctionTooLong: remix-reorder.createReorder.Group (packages/framer-motion/src/remix-reorder.ts)
- FunctionTooLong: spring.springGenerator (packages/motion-dom/src/animation/generators/spring.ts)
- Group.ReorderGroupComponent (cognitive 49) (packages/framer-motion/src/components/Reorder/Group.tsx)
- Group.ReorderGroupComponent (cyclomatic 47) (packages/framer-motion/src/components/Reorder/Group.tsx)
- High CVE: [GHSA redacted] (yarn.lock)
- High CVE: [GHSA redacted] (yarn.lock)
- High CVE: [GHSA redacted] (yarn.lock)
- High: security finding (details withheld)
- Hotspot: packages/framer-motion/src/animation/sequence/create.ts (packages/framer-motion/src/animation/sequence/create.ts)
- Hotspot: packages/framer-motion/src/animation/timeline/index.ts (packages/framer-motion/src/animation/timeline/index.ts)
- Hotspot: packages/framer-motion/src/components/Reorder/Board.tsx (packages/framer-motion/src/components/Reorder/Board.tsx)
- Hotspot: packages/framer-motion/src/components/Reorder/Group.tsx (packages/framer-motion/src/components/Reorder/Group.tsx)
- Hotspot: packages/framer-motion/src/components/Reorder/Item.tsx (packages/framer-motion/src/components/Reorder/Item.tsx)
- Hotspot: packages/framer-motion/src/remix-reorder.ts (packages/framer-motion/src/remix-reorder.ts)
- …and 57 more
Changes since last survey
- 300 commits — 281 feature/other, 19 fixes
By area
- (repo) — 90 commits
- packages/motion-dom — 74 commits
- packages/framer-motion — 69 commits
- (root) — 26 commits
- dev/inc — 21 commits
- dev/react — 6 commits
- dev/remix — 4 commits
- packages/motion — 4 commits
- dev/html — 3 commits
- tests/animate — 1 commit
- tests/gestures — 1 commit
- tests/react — 1 commit
Notable commits
- fix: Fix AnimatePresence exit never starting when a child mounts already exiting
- fix: Fix Reorder.Board review findings
- fix: Fix animate() not recognising a sequence made only of nested sequences
- fix: Fix exit stuck after an open layoutId card switches to another item
- fix: Fix flaky motion/remix variants stagger test
- fix: Fix flaky motion/remix variants stagger test
- fix: Fix pathConstraints after layout changes and overlapping subpaths
- fix: Fix timeline callbacks firing extra times on repeat
- fix: Fix timing flake in "built when played after a pause" test
- fix: Merge main into claude/project-thread-45aghj-sequence-scope-fixes
- fix: Merge main into claude/project-thread-45aghj-sequence-scope-fixes
- fix: Merge main into claude/project-thread-45aghj-sequence-scope-fixes
- fix: Merge main into the timeline repeat fix
- fix: Merge pull request #4019 from motiondivision/claude/project-thread-45aghj-sequence-scope-fixes
- fix: Merge pull request #4058 from motiondivision/fix/sequence-of-nested-sequences
- fix: Raise size budgets for the repeat fix
- fix: Wait for the build in the new transform tests rather than a fixed time
- fix: motion/remix: React parity fixes from porting the examples
- fix: motion/remix: fixes from code review
- change: Add a Reorder.Board demo page with a scrolling page and columns
- …and 280 more
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
motiondivision/motion was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 7 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 78f3ff51b5508f7e8c1c283d8e80bcd26fec37d7 — the exact code this score is about.
- Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.3+preprod-110e4fee044f.