[pull] main from motiondivision:main

.github/workflows/claude-code-review.yml

@@ -0,0 +1,57 @@
+name: Claude Code Review
+
+on:
+  pull_request:
+    types: [opened, synchronize]
+    # Optional: Only run on specific file changes
+    # paths:
+    #   - "src/**/*.ts"
+    #   - "src/**/*.tsx"
+    #   - "src/**/*.js"
+    #   - "src/**/*.jsx"
+
+jobs:
+  claude-review:
+    # Optional: Filter by PR author
+    # if: |
+    #   github.event.pull_request.user.login == 'external-contributor' ||
+    #   github.event.pull_request.user.login == 'new-developer' ||
+    #   github.event.pull_request.author_association == 'FIRST_TIME_CONTRIBUTOR'
+
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code Review
+        id: claude-review
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          prompt: |
+            REPO: ${{ github.repository }}
+            PR NUMBER: ${{ github.event.pull_request.number }}
+
+            Please review this pull request and provide feedback on:
+            - Code quality and best practices
+            - Potential bugs or issues
+            - Performance considerations
+            - Security concerns
+            - Test coverage
+
+            Use the repository's CLAUDE.md for guidance on style and conventions. Be constructive and helpful in your feedback.
+
+            Use `gh pr comment` with your Bash tool to leave your review as a comment on the PR.
+
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://code.claude.com/docs/en/cli-reference for available options
+          claude_args: '--allowed-tools "Bash(gh issue view:*),Bash(gh search:*),Bash(gh issue list:*),Bash(gh pr comment:*),Bash(gh pr diff:*),Bash(gh pr view:*),Bash(gh pr list:*)"'
+

.github/workflows/claude.yml

@@ -0,0 +1,50 @@
+name: Claude Code
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+  issues:
+    types: [opened, assigned]
+  pull_request_review:
+    types: [submitted]
+
+jobs:
+  claude:
+    if: |
+      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
+      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+      actions: read # Required for Claude to read CI results on PRs
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code
+        id: claude
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+
+          # This is an optional setting that allows Claude to read CI results on PRs
+          additional_permissions: |
+            actions: read
+
+          # Optional: Give a custom prompt to Claude. If this is not specified, Claude will perform the instructions specified in the comment that tagged it.
+          # prompt: 'Update the pull request description to include a summary of changes.'
+
+          # Optional: Add claude_args to customize behavior and configuration
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://code.claude.com/docs/en/cli-reference for available options
+          # claude_args: '--allowed-tools Bash(gh pr:*)'
+

.gitignore

@@ -44,4 +44,8 @@ test_results
 .cache
 
 # Generated files
-changelog.csv
+changelog.csv
+
+# Environment files
+.env
+.env.*

CHANGELOG.md

@@ -4,6 +4,20 @@ Motion adheres to [Semantic Versioning](http://semver.org/).
 
 Undocumented APIs should be considered internal and may change without warning.
 
+## [12.23.28] 2026-01-05
+
+### Fixed
+
+-   Fixing `MotionStyle` type with React 19 when `skipLibCheck` is `false`.
+-   Add guard for `process` check for better compat with ESM environments.
+
+## [12.23.27] 2026-01-05
+
+### Fixed
+
+-   Improved Intellisense detection for `motion` import.
+-   Adding sourcemaps to release.
+
 ## [12.23.26] 2025-12-10
 
 ### Fixed

CLAUDE.md

@@ -0,0 +1,92 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Build & Development Commands
+
+```bash
+# Install dependencies (use make bootstrap for first-time setup)
+make bootstrap
+
+# Build all packages (ALWAYS run from repo root, not from individual packages)
+yarn build           # or: make build
+
+# Watch mode for development
+yarn watch           # or: make watch
+
+# Run tests
+yarn test            # Unit tests (Jest) for all packages
+yarn test-playwright # Playwright E2E tests
+
+# Run tests for a specific package
+cd packages/framer-motion && yarn test-client  # Client-side Jest tests
+cd packages/framer-motion && yarn test-server  # SSR Jest tests
+
+# Lint
+yarn lint            # or: make lint
+
+# Run E2E tests
+make test-e2e        # Runs all E2E tests (Next.js, HTML, React, React 19, Playwright)
+make test-single     # Run a single Cypress test (edit spec path in Makefile)
+```
+
+## Package Architecture
+
+This is a Yarn workspaces monorepo managed by Turborepo and Lerna.
+
+### Core Packages (packages/)
+
+- **motion** - Main public package (`npm install motion`). Re-exports from framer-motion with cleaner entry points (`motion/react`, `motion/mini`)
+- **framer-motion** - Core implementation for React. Contains all animation logic, components, hooks, and features
+- **motion-dom** - DOM-specific animation utilities (animate, scroll, gestures, effects). Framework-agnostic
+- **motion-utils** - Shared utilities (easing, math helpers, error handling). No dependencies
+
+### Development Apps (dev/)
+
+- **dev/react** - React 18 development/test app (port 9990)
+- **dev/react-19** - React 19 development/test app (port 9991)
+- **dev/next** - Next.js development/test app (port 3000)
+- **dev/html** - Vanilla JS/HTML test pages (port 8000)
+
+### Package Dependency Flow
+
+```
+motion-utils (base utilities)
+    ↓
+motion-dom (DOM animation engine)
+    ↓
+framer-motion (React integration)
+    ↓
+motion (public API)
+```
+
+## Key Source Directories (packages/framer-motion/src/)
+
+- **animation/** - Animation system (animators, sequences, optimized-appear)
+- **components/** - React components (AnimatePresence, LayoutGroup, LazyMotion, Reorder)
+- **context/** - React contexts (MotionContext, PresenceContext, LayoutGroupContext)
+- **gestures/** - Gesture handling (drag, pan, tap, hover, focus)
+- **motion/** - Core motion component and feature system
+- **projection/** - Layout animation projection system (FLIP animations)
+- **render/** - Rendering pipeline (HTML, SVG, DOM utilities)
+- **value/** - Motion values and hooks (useMotionValue, useSpring, useScroll, useTransform)
+
+## Writing Tests
+
+When waiting for the next frame in async tests:
+
+```javascript
+async function nextFrame() {
+    return new Promise<void>((resolve) => {
+        frame.postRender(() => resolve())
+    })
+}
+```
+
+## Code Style
+
+- Use `interface` for type definitions (enforced by ESLint)
+- No default exports (use named exports)
+- Prefer arrow callbacks
+- Use strict equality (`===`)
+- No `var` declarations (use `const`/`let`)

dev/html/package.json

@@ -1,7 +1,7 @@
 {
     "name": "html-env",
     "private": true,
-    "version": "12.23.26",
+    "version": "12.23.27",
     "type": "module",
     "scripts": {
         "dev": "vite",
@@ -10,8 +10,8 @@
         "preview": "vite preview"
     },
     "dependencies": {
-        "framer-motion": "^12.23.26",
-        "motion": "^12.23.26",
+        "framer-motion": "^12.23.27",
+        "motion": "^12.23.27",
         "motion-dom": "^12.23.23",
         "react": "^18.3.1",
         "react-dom": "^18.3.1"

dev/next/package.json

@@ -1,7 +1,7 @@
 {
     "name": "next-env",
     "private": true,
-    "version": "12.23.26",
+    "version": "12.23.27",
     "type": "module",
     "scripts": {
         "dev": "next dev",
@@ -10,8 +10,8 @@
         "build": "next build"
     },
     "dependencies": {
-        "motion": "^12.23.26",
-        "next": "15.4.7",
+        "motion": "^12.23.27",
+        "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.23.26",
+    "version": "12.23.27",
     "type": "module",
     "scripts": {
         "dev": "vite",
@@ -11,7 +11,7 @@
         "preview": "vite preview"
     },
     "dependencies": {
-        "motion": "^12.23.26",
+        "motion": "^12.23.27",
         "react": "^19.0.0",
         "react-dom": "^19.0.0"
     },

dev/react/package.json

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

lerna.json

@@ -1,5 +1,5 @@
 {
-  "version": "12.23.26",
+  "version": "12.23.27",
   "packages": [
     "packages/*",
     "dev/*"

package.json

@@ -48,6 +48,7 @@
         "concurrently": "^7.3.0",
         "convert-tsconfig-paths-to-webpack-aliases": "^0.9.2",
         "cypress": "4",
+        "dotenv": "^17.2.3",
         "eslint": "^8.57.0",
         "eslint-config-prettier": "^8.5.0",
         "eslint-plugin-import": "^2.26.0",
@@ -72,6 +73,7 @@
         "rollup-plugin-analyzer": "^4.0.0",
         "rollup-plugin-dts": "6.1.0",
         "rollup-plugin-preserve-directives": "^0.4.0",
+        "rollup-plugin-sourcemaps": "^0.6.3",
         "rollup-plugin-visualizer": "^5.14.0",
         "start-server-and-test": "^1.14.0",
         "ts-jest": "^29.1.2",

packages/framer-motion/package.json

@@ -1,6 +1,6 @@
 {
     "name": "framer-motion",
-    "version": "12.23.26",
+    "version": "12.23.27",
     "description": "A simple and powerful JavaScript animation library",
     "main": "dist/cjs/index.js",
     "module": "dist/es/index.mjs",

packages/framer-motion/rollup.config.mjs

@@ -1,6 +1,7 @@
 import alias from "@rollup/plugin-alias"
 import resolve from "@rollup/plugin-node-resolve"
 import replace from "@rollup/plugin-replace"
+import sourcemaps from "rollup-plugin-sourcemaps"
 import terser from "@rollup/plugin-terser"
 import path from "node:path"
 import dts from "rollup-plugin-dts"
@@ -118,9 +119,10 @@ const cjs = Object.assign({}, config, {
         dir: "dist/cjs",
         format: "cjs",
         exports: "named",
-        esModule: true
+        esModule: true,
+        sourcemap: true,
     },
-    plugins: [resolve(), replaceSettings()],
+    plugins: [resolve(), replaceSettings(), sourcemaps()],
     external,
     onwarn(warning, warn) {
         if (warning.code === 'MODULE_LEVEL_DIRECTIVE') {
@@ -147,8 +149,9 @@ export const es = Object.assign({}, config, {
         exports: "named",
         preserveModules: true,
         dir: "dist/es",
+        sourcemap: true,
     },
-    plugins: [resolve(), replaceSettings(), preserveDirectives()],
+    plugins: [resolve(), replaceSettings(), preserveDirectives(), sourcemaps()],
     external,
     onwarn(warning, warn) {
         if (warning.code === 'MODULE_LEVEL_DIRECTIVE') {

packages/framer-motion/src/motion/types.ts

@@ -31,7 +31,7 @@ type MakeCustomValueTypeHelper<T> = MakeMotionHelper<T>
 export type MakeMotion<T> = MakeCustomValueTypeHelper<T>
 
 export type MotionCSS = MakeMotion<
-    Omit<CSSProperties, "rotate" | "scale" | "perspective">
+    Omit<CSSProperties, "rotate" | "scale" | "perspective" | "x" | "y" | "z">
 >
 
 /**