Some progress

Author: MatiPl01

packages/docs/docs/flex/props.mdx

@@ -572,11 +572,17 @@ Component to use as the drop indicator. It gives a **full control** over the dro
 
 ```tsx
 type DropIndicatorComponentProps = {
-  activationProgress: SharedValue<number>;
-  touchedItemKey: SharedValue<null | string>;
+  /** Progress of the active item animation (from 0 to 1) */
+  activeAnimationProgress: SharedValue<number>;
+  /** Key of the currently dragged item, or null if no item is being dragged */
+  activeItemKey: SharedValue<null | string>;
+  /** Current index where the dragged item would be dropped */
   dropIndex: SharedValue<number>;
+  /** Current position where the item would be dropped */
   dropPosition: SharedValue<Vector>;
+  /** Array of item keys in their current order */
   orderedItemKeys: SharedValue<Array<string>>;
+  /** Style to be applied to the drop indicator */
   style: ViewStyle;
 };
 ```
@@ -820,6 +826,12 @@ type OrderChangeParams = {
 
 </details>
 
+:::warning
+
+**Don't use** this callback to update items order in state because it's called **frequently** during dragging. Use `onDragEnd` for **state updates** instead.
+
+:::
+
 ---
 
 ### onDragMove
@@ -883,6 +895,16 @@ You can also use any other haptics library but you will have to trigger haptics
 
 ---
 
+### overflow
+
+Controls if the overflowing content should be clipped or visible. Applies only when no item is active.
+
+| type                    | default    | required |
+| ----------------------- | ---------- | -------- |
+| `'hidden' \| 'visible'` | `'hidden'` | NO       |
+
+---
+
 ### debug
 
 Enables debug mode, which shows additional views helpful for debugging. This property is intended for the library **developers** and is not recommended for the library **users**.

packages/docs/docs/grid/props.mdx

@@ -456,11 +456,17 @@ Component to use as the drop indicator. It gives a **full control** over the dro
 
 ```tsx
 type DropIndicatorComponentProps = {
-  activationProgress: SharedValue<number>;
-  touchedItemKey: SharedValue<null | string>;
+  /** Progress of the active item animation (from 0 to 1) */
+  activeAnimationProgress: SharedValue<number>;
+  /** Key of the currently dragged item, or null if no item is being dragged */
+  activeItemKey: SharedValue<null | string>;
+  /** Current index where the dragged item would be dropped */
   dropIndex: SharedValue<number>;
+  /** Current position where the item would be dropped */
   dropPosition: SharedValue<Vector>;
+  /** Array of item keys in their current order */
   orderedItemKeys: SharedValue<Array<string>>;
+  /** Style to be applied to the drop indicator */
   style: ViewStyle;
 };
 ```
@@ -704,6 +710,12 @@ type OrderChangeParams = {
 
 </details>
 
+:::warning
+
+**Don't use** this callback to update items order in state because it's called **frequently** during dragging. Use `onDragEnd` for **state updates** instead.
+
+:::
+
 ---
 
 ### onDragMove
@@ -769,6 +781,16 @@ You can also use any other haptics library but you will have to trigger haptics
 
 ---
 
+### overflow
+
+Controls if the overflowing content should be clipped or visible. Applies only when no item is active.
+
+| type                    | default    | required |
+| ----------------------- | ---------- | -------- |
+| `'hidden' \| 'visible'` | `'hidden'` | NO       |
+
+---
+
 ### debug
 
 Enables debug mode, which shows additional views helpful for debugging. This property is intended for the library **developers** and is not recommended for the library **users**.

packages/react-native-sortables/src/types/props/shared.ts

@@ -12,7 +12,7 @@ import type { Animatable, AnimatableProps, Simplify } from '../utils';
  * Almost all values are provided as Reanimated shared values for fast updates.
  */
 export type DropIndicatorComponentProps = {
-  /** Progress of the active drag animation (0 to 1) */
+  /** Progress of the active item animation (from 0 to 1) */
   activeAnimationProgress: SharedValue<number>;
   /** Key of the currently dragged item, or null if no item is being dragged */
   activeItemKey: SharedValue<null | string>;
@@ -22,7 +22,7 @@ export type DropIndicatorComponentProps = {
   dropPosition: SharedValue<Vector>;
   /** Array of item keys in their current order */
   orderedItemKeys: SharedValue<Array<string>>;
-  /** Style to be applied to the drop indicator (will be merged with the default style) */
+  /** Style to be applied to the drop indicator */
   style: ViewStyle;
 };