Updating changelog

Author: mattgperry

CHANGELOG.md

@@ -4,6 +4,12 @@ Motion adheres to [Semantic Versioning](http://semver.org/).
 
 Undocumented APIs should be considered internal and may change without warning.
 
+## [12.21.0] 2025-07-01
+
+### Added
+
+-   Allow `distanceThreshold` to be configurable via `useDragControls`.
+
 ## [12.20.5] 2025-07-01
 
 ### Fixed

packages/framer-motion/src/gestures/drag/VisualElementDragControls.ts

@@ -36,9 +36,18 @@ export const elementDragControls = new WeakMap<
 >()
 
 export interface DragControlOptions {
-    /** The distance after which dragging starts. */
-    distanceThreshold?: number;
-    /** Whether to immediately snap to the cursor when dragging starts. */
+    /**
+     * This distance after which dragging starts and a direction is locked in.
+     *
+     * @public
+     */
+    distanceThreshold?: number
+
+    /**
+     * Whether to immediately snap to the cursor when dragging starts.
+     *
+     * @public
+     */
     snapToCursor?: boolean
 }
 

packages/framer-motion/src/gestures/pan/PanSession.ts

@@ -23,7 +23,7 @@ interface PanSessionHandlers {
 interface PanSessionOptions {
     transformPagePoint?: TransformPoint
     dragSnapToOrigin?: boolean
-    distanceThreshold?: number;
+    distanceThreshold?: number
     contextWindow?: (Window & typeof globalThis) | null
 }
 
@@ -94,7 +94,7 @@ export class PanSession {
         handlers: Partial<PanSessionHandlers>,
         {
             transformPagePoint,
-            contextWindow,
+            contextWindow = window,
             dragSnapToOrigin = false,
             distanceThreshold = 3,
         }: PanSessionOptions = {}