@mk-drag-and-drop/dom 0.3.0 → 0.4.0

package/README.md

@@ -98,6 +98,9 @@ The returned controller has:
   array of target ids, or `{ group }`
 - `remeasureOverlay()`: remeasures the currently mounted drag overlay element;
   it is a safe no-op when no overlay is mounted or no drag is active
+- `recomputeActiveDrag()`: reruns active targeting and drag update from the
+  last pointer position; it is a safe no-op when no drag is active and does not
+  remeasure drop targets
 
 The controller does not expose runtime teardown, disposal, update, or broad
 overlay removal methods. Runtime objects are ordinary JavaScript objects; DOM
@@ -408,6 +411,36 @@ order, so app-owned layout changes such as expanding tree rows or changing
 grouped sections during a drag should call the public remeasure API when those
 changes need to affect targeting.
 
+## Active Drag Recompute
+
+`controller.recomputeActiveDrag()` reruns the active drag update path from the
+last stored raw pointer position. It reapplies modifiers, derives the overlay
+rect from cached overlay measurement, recomputes the active drop target from
+cached target measurements, updates the overlay host, and sends the normal drag
+update notifications. This is the same update path used by pointer movement.
+Calling it with no active drag is safe and does nothing.
+
+Use it when something external changes what is under the pointer during an
+active drag without producing a new pointer event.
+
+```ts
+controller.recomputeActiveDrag();
+```
+
+Recompute does not remeasure drop targets. If target geometry or registrations
+changed and those changes should affect targeting, remeasure first and then
+recompute.
+
+```ts
+controller.remeasureDropTargets({ group: "items" });
+controller.recomputeActiveDrag();
+```
+
+```ts
+// Example: after external scrolling changes what is under the pointer
+controller.recomputeActiveDrag();
+```
+
 ## Data Ownership
 
 The DOM package never owns application data. Item ids, target ids, group ids,

package/dist/controller/create-drag-controller.d.ts

@@ -35,5 +35,6 @@ export type DragControllerOptions = {
 export type DragController = {
     remeasureDropTargets: (input?: RemeasureDropTargetsInput) => void;
     remeasureOverlay: () => void;
+    recomputeActiveDrag: () => void;
 };
 export declare function createDragController(options?: DragControllerOptions): DragController;

package/dist/controller/create-drag-controller.js

@@ -23,6 +23,9 @@ export function createDragController(options = {}) {
             runtime.remeasureDropTargets(input);
         },
         remeasureOverlay,
+        recomputeActiveDrag: () => {
+            runtime.recomputeActiveDrag();
+        },
     };
     setControllerRuntime(controller, runtime);
     return controller;

package/dist/runtime/drag-runtime-scope.d.ts

@@ -11,6 +11,7 @@ export type DragRuntimeScope = DomDraggableRuntime & DomDroppableRuntime & DomDr
     configure: (input: DragRuntimeScopeConfigureInput) => void;
     cancelDrag: () => void;
     releaseActiveDragResources: () => void;
+    recomputeActiveDrag: () => void;
     setOverlayRect: (overlayRect: DragRect | null) => void;
 };
 export type InternalStaleDomBindingRuntime = {

package/dist/runtime/drag-runtime-scope.js

@@ -5,6 +5,7 @@ export function createDragRuntimeScope(options) {
         configure: (input) => runtime.configure(input),
         cancelDrag: () => runtime.cancelDrag(),
         releaseActiveDragResources: () => runtime.releaseActiveDragResources(),
+        recomputeActiveDrag: () => runtime.recomputeActiveDrag(),
         setOverlayRect: (overlayRect) => runtime.setOverlayRect(overlayRect),
         requestDragStart: (input) => runtime.requestDragStart(input),
         isKeyboardDragEnabled: () => runtime.isKeyboardDragEnabled(),

package/dist/runtime/drag-runtime.d.ts

@@ -43,6 +43,7 @@ export declare class DragRuntime {
     requestKeyboardDragStart(input: RequestKeyboardDragStartInput): void;
     moveKeyboardDrag(direction: KeyboardMoveDirection): void;
     updatePointer(rawPointerPosition: Point): void;
+    recomputeActiveDrag(): void;
     private updatePointerNow;
     private updatePointerNowOrRelease;
     private finishDragAfterQueuedPointerUpdate;

package/dist/runtime/drag-runtime.js

@@ -180,6 +180,13 @@ export class DragRuntime {
             }
         });
     }
+    recomputeActiveDrag() {
+        const session = this.getDraggingSession();
+        if (!session) {
+            return;
+        }
+        this.updatePointerNowOrRelease(session.rawPointerPosition);
+    }
     updatePointerNow(rawPointerPosition) {
         const session = this.getDraggingSession();
         if (!session) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mk-drag-and-drop/dom",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Headless DOM drag-and-drop primitives for draggable, droppable, sortable, and grouped interactions.",
   "license": "MIT",
   "homepage": "https://mkramer.dev",
@@ -47,8 +47,8 @@
     "jsdom": "^24.1.3",
     "typescript": "5.5.4",
     "vitest": "^2.1.9",
-    "@repo/eslint-config": "0.0.0",
-    "@repo/typescript-config": "0.0.0"
+    "@repo/typescript-config": "0.0.0",
+    "@repo/eslint-config": "0.0.0"
   },
   "scripts": {
     "clean": "node -e \"require('fs').rmSync('dist', { recursive: true, force: true })\"",