[pull] main from motiondivision:main

.circleci/config.yml

@@ -1,19 +1,16 @@
 # Check https://circleci.com/docs/2.0/language-javascript/ for more details
 #
 jobs:
-    test:
+    setup:
         docker:
             - image: cimg/node:20.11.1-browsers
         working_directory: ~/repo
         resource_class: large
+        environment:
+            CYPRESS_CACHE_FOLDER: ~/repo/.cache/Cypress
         steps:
             - checkout
 
-            - run:
-                  name: Yarn version
-                  command: yarn --version
-
-            # Download and cache dependencies (Yarn artifacts, not node_modules)
             - restore_cache:
                   keys:
                       - v3-yarn-{{ checksum "yarn.lock" }}
@@ -29,6 +26,24 @@ jobs:
                       - .yarn/patches
                   key: v3-yarn-{{ checksum "yarn.lock" }}
 
+            - run:
+                  name: Build
+                  command: yarn build
+
+            - persist_to_workspace:
+                  root: .
+                  paths:
+                      - .
+
+    test:
+        docker:
+            - image: cimg/node:20.11.1-browsers
+        working_directory: ~/repo
+        resource_class: large
+        steps:
+            - attach_workspace:
+                  at: ~/repo
+
             - run:
                   name: Test Jest
                   command: make test-jest
@@ -40,29 +55,13 @@ jobs:
         docker:
             - image: cimg/node:20.11.1-browsers
         working_directory: ~/repo
-        parallelism: 6
+        parallelism: 4
         resource_class: large
+        environment:
+            CYPRESS_CACHE_FOLDER: ~/repo/.cache/Cypress
         steps:
-            - checkout
-
-            - run:
-                  name: Yarn version
-                  command: yarn --version
-
-            - restore_cache:
-                  keys:
-                      - v3-yarn-{{ checksum "yarn.lock" }}
-                      - v3-yarn-
-            - run:
-                  name: Install dependencies (immutable)
-                  command: yarn install --immutable
-            - save_cache:
-                  paths:
-                      - .yarn/cache
-                      - .yarn/releases
-                      - .yarn/plugins
-                      - .yarn/patches
-                  key: v3-yarn-{{ checksum "yarn.lock" }}
+            - attach_workspace:
+                  at: ~/repo
 
             - run:
                   name: React tests
@@ -77,32 +76,16 @@ jobs:
         docker:
             - image: cimg/node:20.11.1-browsers
         working_directory: ~/repo
-        parallelism: 6
+        parallelism: 4
         resource_class: large
+        environment:
+            CYPRESS_CACHE_FOLDER: ~/repo/.cache/Cypress
         steps:
-            - checkout
-
-            - run:
-                  name: Yarn version
-                  command: yarn --version
-
-            - restore_cache:
-                  keys:
-                      - v3-yarn-{{ checksum "yarn.lock" }}
-                      - v3-yarn-
-            - run:
-                  name: Install dependencies (immutable)
-                  command: yarn install --immutable
-            - save_cache:
-                  paths:
-                      - .yarn/cache
-                      - .yarn/releases
-                      - .yarn/plugins
-                      - .yarn/patches
-                  key: v3-yarn-{{ checksum "yarn.lock" }}
+            - attach_workspace:
+                  at: ~/repo
 
             - run:
-                  name: React tests
+                  name: React 19 tests
                   command: make test-react-19
                   environment:
                       JEST_JUNIT_OUTPUT: test_reports/framer-motion-react-19.xml
@@ -115,27 +98,11 @@ jobs:
             - image: cimg/node:20.11.1-browsers
         resource_class: large
         working_directory: ~/repo
+        environment:
+            CYPRESS_CACHE_FOLDER: ~/repo/.cache/Cypress
         steps:
-            - checkout
-
-            - run:
-                  name: Yarn version
-                  command: yarn --version
-
-            - restore_cache:
-                  keys:
-                      - v3-yarn-{{ checksum "yarn.lock" }}
-                      - v3-yarn-
-            - run:
-                  name: Install dependencies (immutable)
-                  command: yarn install --immutable
-            - save_cache:
-                  paths:
-                      - .yarn/cache
-                      - .yarn/releases
-                      - .yarn/plugins
-                      - .yarn/patches
-                  key: v3-yarn-{{ checksum "yarn.lock" }}
+            - attach_workspace:
+                  at: ~/repo
 
             - run:
                   name: HTML tests
@@ -152,47 +119,20 @@ jobs:
             - store_test_results:
                   path: test_reports
 
-    test-playwright:
-        docker:
-            - image: mcr.microsoft.com/playwright:v1.51.1-noble
-        resource_class: large
-        working_directory: ~/repo
-        steps:
-            - checkout
-
-            - run:
-                  name: Yarn version
-                  command: yarn --version
-
-            - restore_cache:
-                  keys:
-                      - v3-yarn-{{ checksum "yarn.lock" }}
-                      - v3-yarn-
-            - run:
-                  name: Install dependencies (immutable)
-                  command: yarn install --immutable
-            - save_cache:
-                  paths:
-                      - .yarn/cache
-                      - .yarn/releases
-                      - .yarn/plugins
-                      - .yarn/patches
-                  key: v3-yarn-{{ checksum "yarn.lock" }}
-
-            - run:
-                  name: Playwright tests
-                  command: yarn test-playwright
-                  environment:
-                      JEST_JUNIT_OUTPUT: test_reports/framer-motion-playwright.xml
-
-            - store_test_results:
-                  path: test_reports
-
 workflows:
     version: 2
     build:
         jobs:
-            - test
-            - test-react
-            - test-react-19
-            - test-html
+            - setup
+            - test:
+                  requires:
+                      - setup
+            - test-react:
+                  requires:
+                      - setup
+            - test-react-19:
+                  requires:
+                      - setup
+            - test-html:
+                  requires:
+                      - setup

CHANGELOG.md

@@ -4,6 +4,35 @@ Motion adheres to [Semantic Versioning](http://semver.org/).
 
 Undocumented APIs should be considered internal and may change without warning.
 
+## [12.33.0] 2026-02-05
+
+### Added
+
+-   `<motion />`: New `propagate.tap` prop prevents tap gestures from propagating to parents.
+
+## [12.32.0] 2026-02-05
+
+### Added
+
+-   `transition.inherit`: When `true`, inherit transition values from less-specific transitions.
+
+## [12.31.3] 2026-02-05
+
+### Fixed
+
+-   `<motion />`: Ensure animation state is reset after being re-suspended.
+-   Prevent stale values when mixing `transitionEnd` and `transition.type: false`.
+-   Drag: Fix "sticky" throw velocity on initial interaciton.
+-   Drag: Ensure catching a thrown element kills its velocity.
+
+## [12.31.2] 2026-02-05
+
+### Fixed
+
+-   `onHoverStart` and `onHoverEnd` first argument now correctly typed as `PointerEvent`.
+-   `whileHover`: No longer persists after drag end.
+-   `AnimatePresence`: Allow changing `mode` prop.
+
 ## [12.31.1] 2026-02-04
 
 ### Added

CLAUDE.md

@@ -87,6 +87,8 @@ async function nextFrame() {
 
 ## Code Style
 
+- **Prioritise small file size** — this is a library shipped to end users. Prefer concise patterns that minimise output bytes.
+- Prefer optional chaining (`value?.jump()`) over explicit `if` statements
 - Use `interface` for type definitions (enforced by ESLint)
 - No default exports (use named exports)
 - Prefer arrow callbacks

Makefile

@@ -95,7 +95,7 @@ test-e2e: test-nextjs test-html test-react test-react-19
 	yarn test-playwright
 
 test-single: build test-mkdir
-	yarn start-server-and-test "yarn dev-server" http://localhost:9991 "cd packages/framer-motion && cypress run --config-file=cypress.react.json --headed --spec cypress/integration/drag-nested.ts"
+	yarn start-server-and-test "yarn dev-server" http://localhost:9990 "cd packages/framer-motion && cypress run --config-file=cypress.json --headed --spec cypress/integration/drag-momentum.ts"
 
 lint: bootstrap
 	yarn lint

dev/html/package.json

@@ -1,7 +1,7 @@
 {
     "name": "html-env",
     "private": true,
-    "version": "12.31.1",
+    "version": "12.33.0",
     "type": "module",
     "scripts": {
         "dev": "vite",
@@ -10,9 +10,9 @@
         "preview": "vite preview"
     },
     "dependencies": {
-        "framer-motion": "^12.31.1",
-        "motion": "^12.31.1",
-        "motion-dom": "^12.30.1",
+        "framer-motion": "^12.33.0",
+        "motion": "^12.33.0",
+        "motion-dom": "^12.33.0",
         "react": "^18.3.1",
         "react-dom": "^18.3.1"
     },

dev/html/public/playwright/gestures/press.html

@@ -33,6 +33,10 @@
         <div class="box" id="press-div-nested">
             <button id="press-click-button">click</button>
         </div>
+        <div class="box" id="propagate-parent">
+            <div class="box" id="propagate-child" style="width: 50px; height: 50px">child</div>
+        </div>
+        <input type="text" id="propagate-output" value="" />
         <script type="module" src="/src/inc.js"></script>
         <script type="module">
             const { press } = window.MotionDOM
@@ -100,6 +104,21 @@
                         : "cancel"
                 }
             })
+
+            // Propagation test: child with stopPropagation prevents parent press
+            const propagateOutput = document.getElementById("propagate-output")
+            press("#propagate-parent", () => {
+                propagateOutput.value += "parent-start,"
+                return (_, { success }) => {
+                    propagateOutput.value += success ? "parent-end," : "parent-cancel,"
+                }
+            })
+            press("#propagate-child", () => {
+                propagateOutput.value += "child-start,"
+                return (_, { success }) => {
+                    propagateOutput.value += success ? "child-end," : "child-cancel,"
+                }
+            }, { stopPropagation: true })
         </script>
     </body>
 </html>

dev/next/package.json

@@ -1,7 +1,7 @@
 {
     "name": "next-env",
     "private": true,
-    "version": "12.31.1",
+    "version": "12.33.0",
     "type": "module",
     "scripts": {
         "dev": "next dev",
@@ -10,7 +10,7 @@
         "build": "next build"
     },
     "dependencies": {
-        "motion": "^12.31.1",
+        "motion": "^12.33.0",
         "next": "15.4.10",
         "react": "19.0.0",
         "react-dom": "19.0.0"

dev/react-19/package.json

@@ -1,7 +1,7 @@
 {
     "name": "react-19-env",
     "private": true,
-    "version": "12.31.1",
+    "version": "12.33.0",
     "type": "module",
     "scripts": {
         "dev": "vite",
@@ -11,7 +11,7 @@
         "preview": "vite preview"
     },
     "dependencies": {
-        "motion": "^12.31.1",
+        "motion": "^12.33.0",
         "react": "^19.0.0",
         "react-dom": "^19.0.0"
     },

dev/react/package.json

@@ -1,7 +1,7 @@
 {
     "name": "react-env",
     "private": true,
-    "version": "12.31.1",
+    "version": "12.33.0",
     "type": "module",
     "scripts": {
         "dev": "yarn vite",
@@ -11,7 +11,7 @@
         "preview": "yarn vite preview"
     },
     "dependencies": {
-        "framer-motion": "^12.31.1",
+        "framer-motion": "^12.33.0",
         "react": "^18.3.1",
         "react-dom": "^18.3.1"
     },

dev/react/src/tests/drag-momentum.tsx

@@ -0,0 +1,21 @@
+import { motion } from "framer-motion"
+
+export const App = () => {
+    return (
+        <div style={{ height: 2000, paddingTop: 100 }}>
+            <motion.div
+                id="box"
+                data-testid="draggable"
+                drag
+                dragMomentum={true}
+                initial={{
+                    width: 50,
+                    height: 1000,
+                    background: "red",
+                    x: 0,
+                    y: 0,
+                }}
+            />
+        </div>
+    )
+}