[add] what's new for v9.1.2, dropPosition parameter for drag-related events

Author: mafanya23

docs/grid/api/grid_afterrowdrop_event.md

@@ -8,7 +8,7 @@ description: You can explore the afterRowDrop event of Grid in the documentation
 
 @short: fires before the user has finished dragging a row but after the mouse button is released
 
-@signature: {'afterRowDrop: (data: object, event: MouseEvent) => void;'}
+@signature: {'afterRowDrop: (data: object, event: MouseEvent, dropPosition: "top" | "bottom" | "in") => void;'}
 
 @params:
 The callback of the event is called with the following parameters:
@@ -18,9 +18,10 @@ The callback of the event is called with the following parameters:
     - `source: array` - an array with ids of dragged rows
     - `target: string | number` - the id of a potential target row
 - `event: MouseEvent` - a native HTML event object
+- `dropPosition: string` - defines the position of the dragged item dropping relative to the target item: "top" | "bottom" | "in" (the "in" value is used only for the TreeGrid mode)
 
 @example:
-grid.events.on("afterRowDrop", (data, event) => {
+grid.events.on("afterRowDrop", (data, event, dropPosition) => {
     // your logic here
 });
 

docs/grid/api/grid_beforerowdrop_event.md

@@ -8,7 +8,7 @@ description: You can explore the beforeRowDrop event of Grid in the documentatio
 
 @short: fires before the user has finished dragging and released the mouse button over a target row
 
-@signature: {'beforeRowDrop: (data: object, event: MouseEvent) => void | boolean;'}
+@signature: {'beforeRowDrop: (data: object, event: MouseEvent, dropPosition: "top" | "bottom" | "in") => void | boolean;'}
 
 @params:
 The callback of the event is called with the following parameters:
@@ -17,12 +17,14 @@ The callback of the event is called with the following parameters:
     - `source: array` - an array with ids of dragged rows
     - `target: string | number` - the id of a potential target row
 - `event: MouseEvent` - a native HTML event object 
+- `dropPosition: string` - defines the position of the dragged item dropping relative to the target item: "top" | "bottom" | "in" (the "in" value is used only for the TreeGrid mode)
+
 
 @returns:
 Return `false` to block the default action; otherwise, `true`.
 
 @example:
-grid.events.on("beforeRowDrop", (data, event) => {
+grid.events.on("beforeRowDrop", (data, event, dropPosition) => {
     // your logic here
     return false;
 });

docs/grid/api/grid_dragrowin_event.md

@@ -8,7 +8,7 @@ description: You can explore the dragRowIn event of Grid in the documentation of
 
 @short: fires when a row is dragged to another potential target
 
-@signature: {'dragRowIn: (data: object, event: MouseEvent) => void;'}
+@signature: {'dragRowIn: (data: object, event: MouseEvent, dropPosition: "top" | "bottom" | "in") => void;'}
 
 @params:
 The callback of the event is called with the following parameters:
@@ -18,9 +18,10 @@ The callback of the event is called with the following parameters:
     - `source: array` - an array with ids of dragged rows
     - `target: string | number` - the id of a potential target row
 - `event: MouseEvent` - a native HTML event object
+- `dropPosition: string` - defines the position of the dragged item dropping relative to the target item: "top" | "bottom" | "in" (the "in" value is used only for the TreeGrid mode)
 
 @example:
-grid.events.on("dragRowIn", (data, event) => {
+grid.events.on("dragRowIn", (data, event, dropPosition) => {
   // your logic here
 });
 

docs/whatsnew.md

@@ -8,6 +8,22 @@ description: You can explore what's new in DHTMLX Suite and its release history
 
 Before updating DHTMLX to the latest version, please check the [Migration to Newer Versions](migration.md) guide to avoid possible breakdowns.
 
+## Version 9.2.1 
+
+Released on September 1, 2025
+
+### Fixes
+
+- DragManager. Incorrect determining of dragged items' ids while dragging multiple items
+- Form. The `beforeChange` event behavior in the Input and Textarea controls
+- Grid. The `BlockSelection` module behavior when using several Grids on a page
+- Grid. The issue with inserting data into inputFilter from the clipboard 
+- Grid. The parameter that defines the dragged item's drop position relative to the target item is added for the callback of drag-related events
+- Grid. The problem with multiselection of rows outside the visible Grid area when the `dragMode` option is enabled
+- Grid. Displaying of boolean values in the grouped data
+- Grid. Processing of invalid data for columns with the `number` type 
+- Grid. The processing of the grouped invalid data is improved
+
 ## Version 9.2 
 
 Released on July 15, 2025