@mk-drag-and-drop/react 0.4.0 → 0.4.2

package/README.md

@@ -453,6 +453,18 @@ Preview movement does not trigger full target remeasurement. The app still
 commits data on drop, using placement derived from the current preview DOM
 order. React rendering should then reflect the final data.
 
+React uses the DOM package placement rules. Same-container sortable preview
+keeps its movement-responsive first-placement behavior: forward movement places
+after a newly active target, backward movement places before, and no
+sortable-axis movement uses the target midpoint. When a sortable item first
+enters a different DOM container, the initial side is based on the pointer
+position against the target midpoint on the sortable axis: above or left of
+midpoint places before, while below or right of midpoint places after.
+Rect-based targeting such as `centerToCenter` still selects the active target;
+cross-container initial preview side follows the pointer. `placementBoundary`
+remains a same-target reversal and hysteresis control after preview placement
+exists; it does not decide the initial side for cross-container sortable entry.
+
 Examples may rerender a full list for simplicity, but granular state management,
 external stores, server commits, and imperative rendering strategies are
 compatible. The package does not require React state.
@@ -552,6 +564,11 @@ DOM registry may narrow measured candidates to relevant sortable item, neighbor,
 or container entries before the targeting algorithm runs; the algorithm still
 chooses from that narrowed measured list.
 
+The before/after side follows the DOM package sortable placement behavior
+described above, including pointer-vs-midpoint initial placement for
+cross-container entry and `placementBoundary` for later same-target reversal
+behavior.
+
 - `lockToXAxis()`
 - `lockToYAxis()`
 - `restrictToContainer(refOrResolver)`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mk-drag-and-drop/react",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "React hooks and provider for the mk drag-and-drop DOM runtime.",
   "license": "MIT",
   "homepage": "https://mkramer.dev",
@@ -39,7 +39,7 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@mk-drag-and-drop/dom": "^0.4.0"
+    "@mk-drag-and-drop/dom": "^0.4.2"
   },
   "peerDependencies": {
     "react": "^19.0.0"