react-native-tree-multi-select 3.0.0-beta.1 → 3.0.0-beta.3

package/lib/typescript/src/store/treeView.store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"treeView.store.d.ts","sourceRoot":"","sources":["../../../../src/store/treeView.store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAU,KAAK,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAEpE,MAAM,MAAM,aAAa,CAAC,EAAE,IAAI;IAE5B,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IACjB,aAAa,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IAG1C,aAAa,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IACvB,mBAAmB,EAAE,CAAC,aAAa,EAAE,GAAG,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IAGtD,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,cAAc,EAAE,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IAG5C,mBAAmB,EAAE,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;IACpC,yBAAyB,EAAE,CAAC,mBAAmB,EAAE,QAAQ,CAAC,EAAE,CAAC,EAAE,KAAK,IAAI,CAAC;IAGzE,OAAO,EAAE,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/B,aAAa,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;IAGxD,gBAAgB,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAC9B,sBAAsB,EAAE,CAAC,gBAAgB,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC;IAGhE,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAG/C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,gBAAgB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAGjD,oBAAoB,EAAE,EAAE,EAAE,CAAC;IAC3B,0BAA0B,EAAE,CAAC,oBAAoB,EAAE,EAAE,EAAE,KAAK,IAAI,CAAC;IAEjE,oBAAoB,EAAE,oBAAoB,CAAC;IAC3C,uBAAuB,EAAE,CACrB,oBAAoB,EAAE,oBAAoB,KACzC,IAAI,CAAC;IAGV,aAAa,EAAE,EAAE,GAAG,IAAI,CAAC;IACzB,mBAAmB,EAAE,CAAC,aAAa,EAAE,EAAE,GAAG,IAAI,KAAK,IAAI,CAAC;IAExD,oBAAoB,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,0BAA0B,EAAE,CAAC,oBAAoB,EAAE,GAAG,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IAGpE,gBAAgB,EAAE,EAAE,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,gBAAgB,EAAE,CAAC,MAAM,EAAE,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,KAAK,IAAI,CAAC;IAG7E,oBAAoB,EAAE,MAAM,IAAI,CAAC;CACpC,CAAC;AAOF,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,CAkF3F;AAED,wBAAgB,gBAAgB,CAAC,EAAE,GAAG,MAAM,EAAE,EAAE,EAAE,MAAM,8CAEvD"}
+{"version":3,"file":"treeView.store.d.ts","sourceRoot":"","sources":["../../../../src/store/treeView.store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAU,KAAK,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAEpE,MAAM,MAAM,aAAa,CAAC,EAAE,IAAI;IAE5B,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IACjB,aAAa,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IAG1C,aAAa,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IACvB,mBAAmB,EAAE,CAAC,aAAa,EAAE,GAAG,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IAGtD,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,cAAc,EAAE,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IAG5C,mBAAmB,EAAE,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;IACpC,yBAAyB,EAAE,CAAC,mBAAmB,EAAE,QAAQ,CAAC,EAAE,CAAC,EAAE,KAAK,IAAI,CAAC;IAGzE,OAAO,EAAE,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/B,aAAa,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;IAGxD,gBAAgB,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAC9B,sBAAsB,EAAE,CAAC,gBAAgB,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC;IAGhE,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAG/C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,gBAAgB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAGjD,oBAAoB,EAAE,EAAE,EAAE,CAAC;IAC3B,0BAA0B,EAAE,CAAC,oBAAoB,EAAE,EAAE,EAAE,KAAK,IAAI,CAAC;IAEjE,oBAAoB,EAAE,oBAAoB,CAAC;IAC3C,uBAAuB,EAAE,CACrB,oBAAoB,EAAE,oBAAoB,KACzC,IAAI,CAAC;IAGV,aAAa,EAAE,EAAE,GAAG,IAAI,CAAC;IACzB,mBAAmB,EAAE,CAAC,aAAa,EAAE,EAAE,GAAG,IAAI,KAAK,IAAI,CAAC;IAExD,oBAAoB,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,0BAA0B,EAAE,CAAC,oBAAoB,EAAE,GAAG,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IAGpE,gBAAgB,EAAE,EAAE,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gBAAgB,EAAE,CAAC,MAAM,EAAE,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAGpG,oBAAoB,EAAE,MAAM,IAAI,CAAC;CACpC,CAAC;AAOF,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,CAqF3F;AAED,wBAAgB,gBAAgB,CAAC,EAAE,GAAG,MAAM,EAAE,EAAE,EAAE,MAAM,8CAEvD"}

package/lib/typescript/src/types/dragDrop.types.d.ts

@@ -1,5 +1,7 @@
 import type { TreeNode } from "./treeView.types";
+/** Where a node is dropped relative to the target: as a sibling above/below, or as a child inside */
 export type DropPosition = "above" | "below" | "inside";
+/** Event payload passed to the onDragEnd callback after a successful drop */
 export interface DragEndEvent<ID = string> {
     /** The id of the node that was dragged */
     draggedNodeId: ID;
@@ -10,12 +12,19 @@ export interface DragEndEvent<ID = string> {
     /** The reordered tree data after the move */
     newTreeData: TreeNode<ID>[];
 }
+/** Internal representation of the current drop target during a drag operation */
 export interface DropTarget<ID = string> {
+    /** The id of the node being hovered over */
     targetNodeId: ID;
+    /** Index of the target node in the flattened list */
     targetIndex: number;
+    /** Where the drop would occur relative to the target */
     position: DropPosition;
+    /** Whether this is a valid drop location (e.g. not dropping a node onto itself or its descendants) */
     isValid: boolean;
+    /** Nesting level of the target node */
     targetLevel: number;
+    /** Y-coordinate for positioning the drop indicator */
     indicatorTop: number;
 }
 //# sourceMappingURL=dragDrop.types.d.ts.map

package/lib/typescript/src/types/dragDrop.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dragDrop.types.d.ts","sourceRoot":"","sources":["../../../../src/types/dragDrop.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AAExD,MAAM,WAAW,YAAY,CAAC,EAAE,GAAG,MAAM;IACrC,0CAA0C;IAC1C,aAAa,EAAE,EAAE,CAAC;IAClB,mEAAmE;IACnE,YAAY,EAAE,EAAE,CAAC;IACjB,0EAA0E;IAC1E,QAAQ,EAAE,YAAY,CAAC;IACvB,6CAA6C;IAC7C,WAAW,EAAE,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU,CAAC,EAAE,GAAG,MAAM;IACnC,YAAY,EAAE,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACxB"}
+{"version":3,"file":"dragDrop.types.d.ts","sourceRoot":"","sources":["../../../../src/types/dragDrop.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,qGAAqG;AACrG,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AAExD,6EAA6E;AAC7E,MAAM,WAAW,YAAY,CAAC,EAAE,GAAG,MAAM;IACrC,0CAA0C;IAC1C,aAAa,EAAE,EAAE,CAAC;IAClB,mEAAmE;IACnE,YAAY,EAAE,EAAE,CAAC;IACjB,0EAA0E;IAC1E,QAAQ,EAAE,YAAY,CAAC;IACvB,6CAA6C;IAC7C,WAAW,EAAE,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;CAC/B;AAED,iFAAiF;AACjF,MAAM,WAAW,UAAU,CAAC,EAAE,GAAG,MAAM;IACnC,4CAA4C;IAC5C,YAAY,EAAE,EAAE,CAAC;IACjB,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,QAAQ,EAAE,YAAY,CAAC;IACvB,sGAAsG;IACtG,OAAO,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;CACxB"}

package/lib/typescript/src/types/treeView.types.d.ts

@@ -3,61 +3,111 @@ import type { FlashListProps } from "@shopify/flash-list";
 import type { ScrollToNodeHandlerRef, ScrollToNodeParams } from "../handlers/ScrollToNodeHandler";
 import type { CheckboxProps as _CheckboxProps } from "@futurejj/react-native-checkbox";
 import type { DragEndEvent, DropPosition } from "./dragDrop.types";
+/** The tri-state value of a checkbox: checked, unchecked, or indeterminate */
 export type CheckboxValueType = boolean | "indeterminate";
+/** Props passed to a custom expand/collapse icon component */
 export interface ExpandIconProps {
+    /** Whether the node is currently expanded */
     isExpanded: boolean;
 }
+/** A single node in the tree data structure */
 export interface TreeNode<ID = string> {
+    /** Unique identifier for this node */
     id: ID;
+    /** Display name for this node */
     name: string;
+    /** Child nodes (omit or empty array for leaf nodes) */
     children?: TreeNode<ID>[];
+    /** Additional custom data fields */
     [key: string]: any;
 }
+/** Internal flattened representation of a tree node with its nesting level */
 export interface __FlattenedTreeNode__<ID = string> extends TreeNode<ID> {
+    /** Nesting depth of this node (0 = root level) */
     level?: number;
 }
+/** FlashList props available for customization (excludes `data` and `renderItem`) */
 export type TreeFlatListProps<ItemT = any> = Omit<FlashListProps<ItemT>, "data" | "renderItem">;
+/** Props passed to a custom node row component */
 export interface NodeRowProps<ID = string> {
+    /** The tree node to render */
     node: TreeNode<ID>;
+    /** Nesting depth of this node (0 = root level) */
     level: number;
+    /** Current checkbox state of this node */
     checkedValue: CheckboxValueType;
+    /** Whether this node's children are currently visible */
     isExpanded: boolean;
+    /** Callback to toggle this node's checked state */
     onCheck: () => void;
+    /** Callback to toggle this node's expanded/collapsed state */
     onExpand: () => void;
+    /** Whether this node is an invalid drop target during a drag operation */
     isDragTarget?: boolean;
+    /** Whether a drag operation is currently in progress */
     isDragging?: boolean;
+    /** Whether this node is the one being dragged */
     isDraggedNode?: boolean;
 }
+/** Customization options for tree item appearance and behavior */
 export interface TreeItemCustomizations<ID> {
+    /** Style props for the built-in checkbox view */
     checkBoxViewStyleProps?: BuiltInCheckBoxViewStyleProps;
+    /** Pixels of indentation per nesting level. Default: 15 */
     indentationMultiplier?: number;
+    /** Custom checkbox component replacing the built-in checkbox */
     CheckboxComponent?: React.ComponentType<CheckBoxViewProps>;
+    /** Custom expand/collapse icon component */
     ExpandCollapseIconComponent?: React.ComponentType<ExpandIconProps>;
+    /** Custom touchable component wrapping the expand/collapse icon */
     ExpandCollapseTouchableComponent?: React.ComponentType<TouchableOpacityProps>;
+    /** Fully custom node row component replacing the entire built-in row */
     CustomNodeRowComponent?: React.ComponentType<NodeRowProps<ID>>;
 }
+/** Internal props for a single node in the list (extends TreeItemCustomizations) */
 export interface NodeProps<ID> extends TreeItemCustomizations<ID> {
+    /** The flattened tree node data */
     node: __FlattenedTreeNode__<ID>;
+    /** Nesting depth of this node */
     level: number;
+    /** Internal store identifier */
     storeId: string;
+    /** Index of this node in the flattened list */
     nodeIndex?: number;
+    /** Whether drag-and-drop is enabled */
     dragEnabled?: boolean;
+    /** Whether a drag operation is currently in progress */
     isDragging?: boolean;
+    /** Callback when a touch starts on this node (used for drag initiation) */
     onNodeTouchStart?: (nodeId: ID, pageY: number, locationY: number, nodeIndex: number) => void;
+    /** Callback when a touch ends on this node */
     onNodeTouchEnd?: () => void;
+    /** Long press duration in ms to start drag */
     longPressDuration?: number;
+    /** Callback reporting this node's measured height */
     onItemLayout?: (height: number) => void;
+    /** Customizations for drag-and-drop visuals */
     dragDropCustomizations?: DragDropCustomizations<ID>;
 }
+/** Props for the NodeList component that renders the flattened tree */
 export interface NodeListProps<ID> extends TreeItemCustomizations<ID> {
+    /** Additional props passed to the underlying FlashList */
     treeFlashListProps?: TreeFlatListProps;
+    /** Ref for programmatic scroll-to-node functionality */
     scrollToNodeHandlerRef: React.RefObject<ScrollToNodeHandlerRef<ID>>;
+    /** Node ID to scroll to on initial render */
     initialScrollNodeID?: ID;
+    /** Internal store identifier */
     storeId: string;
+    /** Enable drag-and-drop reordering */
     dragEnabled?: boolean;
+    /** Callback fired after a node is dropped at a new position */
     onDragEnd?: (event: DragEndEvent<ID>) => void;
+    /** Long press duration in ms to start drag. Default: 400 */
     longPressDuration?: number;
+    /** Distance from edge (px) to trigger auto-scroll during drag. Default: 60 */
     autoScrollThreshold?: number;
+    /** Speed multiplier for auto-scroll during drag. Default: 1.0 */
     autoScrollSpeed?: number;
     /** Offset of the dragged overlay from the finger, in item-height units. Default: -1 (one item above finger) */
     dragOverlayOffset?: number;
@@ -66,12 +116,19 @@ export interface NodeListProps<ID> extends TreeItemCustomizations<ID> {
     /** Customizations for drag-and-drop visuals (overlay, indicator, opacity) */
     dragDropCustomizations?: DragDropCustomizations<ID>;
 }
+/** Props for the TreeView component */
 export interface TreeViewProps<ID = string> extends Omit<NodeListProps<ID>, "storeId" | "scrollToNodeHandlerRef"> {
+    /** The tree data to render */
     data: TreeNode<ID>[];
+    /** Callback fired when checked nodes change. Receives checked and indeterminate node IDs. */
     onCheck?: (checkedIds: ID[], indeterminateIds: ID[]) => void;
+    /** Callback fired when expanded nodes change. Receives all currently expanded node IDs. */
     onExpand?: (expandedIds: ID[]) => void;
+    /** Node IDs that should be checked on initial render */
     preselectedIds?: ID[];
+    /** Node IDs that should be expanded on initial render */
     preExpandedIds?: ID[];
+    /** Controls whether checking a node propagates to its children and/or parents */
     selectionPropagation?: SelectionPropagation;
     /** Enable drag-and-drop reordering */
     dragEnabled?: boolean;
@@ -79,9 +136,9 @@ export interface TreeViewProps<ID = string> extends Omit<NodeListProps<ID>, "sto
     onDragEnd?: (event: DragEndEvent<ID>) => void;
     /** Long press duration in ms to start drag. Default: 400 */
     longPressDuration?: number;
-    /** Distance from edge (px) to trigger auto-scroll. Default: 60 */
+    /** Distance from edge (px) to trigger auto-scroll during drag. Default: 60 */
     autoScrollThreshold?: number;
-    /** Speed multiplier for auto-scroll. Default: 1.0 */
+    /** Speed multiplier for auto-scroll during drag. Default: 1.0 */
     autoScrollSpeed?: number;
     /** Offset of the dragged overlay from the finger, in item-height units. Default: -1 (one item above finger) */
     dragOverlayOffset?: number;
@@ -89,43 +146,76 @@ export interface TreeViewProps<ID = string> extends Omit<NodeListProps<ID>, "sto
     autoExpandDelay?: number;
 }
 type CheckboxProps = Omit<_CheckboxProps, "onPress" | "status">;
+/** Props for the checkbox view component */
 export interface CheckBoxViewProps {
+    /** Current checkbox state */
     value: CheckboxValueType;
+    /** Callback when the checkbox value changes */
     onValueChange: (value: boolean) => void;
+    /** Label text displayed next to the checkbox */
     text: string;
+    /** Test ID for testing frameworks */
     testID?: string;
 }
+/** Style props for customizing the built-in checkbox view */
 export interface BuiltInCheckBoxViewStyleProps {
+    /** Style for the outermost container wrapping the checkbox and text */
     outermostParentViewStyle?: StyleProp<ViewStyle>;
+    /** Style for the view wrapping the checkbox itself */
     checkboxParentViewStyle?: StyleProp<ViewStyle>;
+    /** Style for the touchable area wrapping the label text */
     textTouchableStyle?: StyleProp<ViewStyle>;
+    /** Additional props passed to the underlying Checkbox component */
     checkboxProps?: CheckboxProps;
+    /** Props passed to the label Text component */
     textProps?: TextProps;
 }
+/** Combined props for the built-in checkbox view (CheckBoxViewProps + style props) */
 export type BuiltInCheckBoxViewProps = CheckBoxViewProps & BuiltInCheckBoxViewStyleProps;
+/** Ref handle exposed by the TreeView component for imperative operations */
 export interface TreeViewRef<ID = string> {
+    /** Select (check) all nodes in the tree */
     selectAll: () => void;
+    /** Unselect (uncheck) all nodes in the tree */
     unselectAll: () => void;
+    /** Select all nodes that match the current search filter */
     selectAllFiltered: () => void;
+    /** Unselect all nodes that match the current search filter */
     unselectAllFiltered: () => void;
+    /** Expand all nodes in the tree */
     expandAll: () => void;
+    /** Collapse all nodes in the tree */
     collapseAll: () => void;
+    /** Expand specific nodes by their IDs */
     expandNodes: (ids: ID[]) => void;
+    /** Collapse specific nodes by their IDs */
     collapseNodes: (ids: ID[]) => void;
+    /** Select (check) specific nodes by their IDs */
     selectNodes: (ids: ID[]) => void;
+    /** Unselect (uncheck) specific nodes by their IDs */
     unselectNodes: (ids: ID[]) => void;
+    /** Set the search text and optionally specify which node fields to search */
     setSearchText: (searchText: string, searchKeys?: string[]) => void;
+    /** Programmatically scroll to a specific node by its ID */
     scrollToNodeID: (scrollToNodeParams: ScrollToNodeParams<ID>) => void;
+    /** Get a map of child node IDs to their parent node IDs */
     getChildToParentMap: () => Map<ID, ID>;
 }
+/** Controls how checkbox selection propagates through the tree hierarchy */
 export interface SelectionPropagation {
+    /** Whether checking a parent node automatically checks all its children. Default: true */
     toChildren?: boolean;
+    /** Whether checking all children automatically checks their parent. Default: true */
     toParents?: boolean;
 }
 /** Props for the drop indicator rendered on the target node during drag */
 export interface DropIndicatorComponentProps {
     /** Whether the indicator is above, below, or inside the target node */
     position: DropPosition;
+    /** The nesting level of the target node (useful for indenting the indicator) */
+    level: number;
+    /** The indentation multiplier used for each level (pixels per level) */
+    indentationMultiplier: number;
 }
 /** Style props for customizing the built-in drop indicator appearance */
 export interface DropIndicatorStyleProps {
@@ -163,9 +253,9 @@ export interface DragDropCustomizations<ID = string> {
     dropIndicatorStyleProps?: DropIndicatorStyleProps;
     /** Style props for the drag overlay (lifted node ghost) */
     dragOverlayStyleProps?: DragOverlayStyleProps;
-    /** Fully custom drop indicator component — replaces the built-in line/highlight */
+    /** Fully custom drop indicator component - replaces the built-in line/highlight */
     CustomDropIndicatorComponent?: React.ComponentType<DropIndicatorComponentProps>;
-    /** Fully custom drag overlay component — replaces the built-in ghost node */
+    /** Fully custom drag overlay component - replaces the built-in ghost node */
     CustomDragOverlayComponent?: React.ComponentType<DragOverlayComponentProps<ID>>;
 }
 /** Props passed to a custom drag overlay component */

package/lib/typescript/src/types/treeView.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"treeView.types.d.ts","sourceRoot":"","sources":["../../../../src/types/treeView.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"treeView.types.d.ts","sourceRoot":"","sources":["../../../../src/types/treeView.types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-tree-multi-select",
-  "version": "3.0.0-beta.1",
+  "version": "3.0.0-beta.3",
   "description": "A super-fast, customizable tree view component for React Native with multi-selection, checkboxes, and search filtering capabilities.",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/src/components/DragOverlay.tsx

@@ -13,6 +13,7 @@ import { defaultIndentationMultiplier } from "../constants/treeView.constants";
 
 interface DragOverlayProps<ID> extends TreeItemCustomizations<ID> {
     overlayY: Animated.Value;
+    overlayX: Animated.Value;
     node: __FlattenedTreeNode__<ID>;
     level: number;
     dragDropCustomizations?: DragDropCustomizations<ID>;
@@ -21,6 +22,7 @@ interface DragOverlayProps<ID> extends TreeItemCustomizations<ID> {
 function _DragOverlay<ID>(props: DragOverlayProps<ID>) {
     const {
         overlayY,
+        overlayX,
         node,
         level,
         indentationMultiplier = defaultIndentationMultiplier,
@@ -47,7 +49,7 @@ function _DragOverlay<ID>(props: DragOverlayProps<ID>) {
                     ...(overlayStyleProps.elevation != null && { elevation: overlayStyleProps.elevation }),
                 },
                 overlayStyleProps?.style,
-                { transform: [{ translateY: overlayY }] },
+                { transform: [{ translateX: overlayX }, { translateY: overlayY }] },
             ]}
         >
             {CustomOverlay ? (

package/src/components/NodeList.tsx

@@ -114,13 +114,18 @@ function _NodeList<ID>(props: NodeListProps<ID>) {
         updateInnerMostChildrenIds(updatedInnerMostChildrenIds);
     }, [filteredTree, updateInnerMostChildrenIds]);
 
+    const effectiveIndentationMultiplier = indentationMultiplier ?? defaultIndentationMultiplier;
+
     // --- Drag and drop ---
     const {
         panResponder,
         overlayY,
+        overlayX,
         isDragging,
         draggedNode,
+        effectiveDropLevel,
         handleNodeTouchStart,
+        handleNodeTouchEnd,
         cancelLongPressTimer,
         scrollOffsetRef,
     } = useDragDrop<ID>({
@@ -137,6 +142,7 @@ function _NodeList<ID>(props: NodeListProps<ID>) {
         measuredItemHeightRef,
         dragOverlayOffset,
         autoExpandDelay,
+        indentationMultiplier: effectiveIndentationMultiplier,
     });
 
     // Combined onScroll handler
@@ -150,8 +156,6 @@ function _NodeList<ID>(props: NodeListProps<ID>) {
         treeFlashListProps?.onScroll?.(event as any);
     }, [scrollOffsetRef, cancelLongPressTimer, treeFlashListProps]);
 
-    const effectiveIndentationMultiplier = indentationMultiplier ?? defaultIndentationMultiplier;
-
     const nodeRenderer = React.useCallback((
         { item, index }: { item: __FlattenedTreeNode__<ID>; index: number; }
     ) => {
@@ -174,7 +178,7 @@ function _NodeList<ID>(props: NodeListProps<ID>) {
                 dragEnabled={dragEnabled}
                 isDragging={isDragging}
                 onNodeTouchStart={dragEnabled ? handleNodeTouchStart : undefined}
-                onNodeTouchEnd={dragEnabled ? cancelLongPressTimer : undefined}
+                onNodeTouchEnd={dragEnabled ? handleNodeTouchEnd : undefined}
                 onItemLayout={dragEnabled ? handleItemLayout : undefined}
                 dragDropCustomizations={dragDropCustomizations}
             />
@@ -190,8 +194,8 @@ function _NodeList<ID>(props: NodeListProps<ID>) {
         dragEnabled,
         isDragging,
         handleNodeTouchStart,
+        handleNodeTouchEnd,
         dragDropCustomizations,
-        cancelLongPressTimer,
         handleItemLayout,
     ]);
 
@@ -237,8 +241,9 @@ function _NodeList<ID>(props: NodeListProps<ID>) {
                     {isDragging && draggedNode && (
                         <DragOverlay<ID>
                             overlayY={overlayY}
+                            overlayX={overlayX}
                             node={draggedNode}
-                            level={draggedNode.level ?? 0}
+                            level={effectiveDropLevel}
                             indentationMultiplier={effectiveIndentationMultiplier}
                             CheckboxComponent={CheckboxComponent}
                             ExpandCollapseIconComponent={ExpandCollapseIconComponent}
@@ -306,6 +311,7 @@ function _Node<ID>(props: NodeProps<ID>) {
         isDragInvalid,
         isDropTarget,
         nodeDropPosition,
+        nodeDropLevel,
     } = useTreeViewStore<ID>(storeId)(useShallow(
         state => ({
             isExpanded: state.expanded.has(node.id),
@@ -317,18 +323,38 @@ function _Node<ID>(props: NodeProps<ID>) {
             isDragInvalid: state.invalidDragTargetIds.has(node.id),
             isDropTarget: state.dropTargetNodeId === node.id,
             nodeDropPosition: state.dropTargetNodeId === node.id ? state.dropPosition : null,
+            nodeDropLevel: state.dropTargetNodeId === node.id ? state.dropLevel : null,
         })
     ));
 
+    // Track when this node was dragged so we can swallow the onPress/onCheck
+    // that fires when the user lifts their finger after a long-press-initiated drag.
+    // The flag is set during render (synchronous) and cleared on the next touch start.
+    // It is also cleared via effect when dragging ends, to prevent stale `true`
+    // values surviving FlashList recycling (where refs persist across items).
+    const wasDraggedRef = React.useRef(false);
+    if (isDraggingGlobal && isBeingDragged) {
+        wasDraggedRef.current = true;
+    }
+
+    React.useEffect(() => {
+        if (!isDraggingGlobal) {
+            wasDraggedRef.current = false;
+        }
+    }, [isDraggingGlobal]);
+
     const _onToggleExpand = React.useCallback(() => {
+        if (wasDraggedRef.current) return;
         handleToggleExpand(storeId, node.id);
     }, [storeId, node.id]);
 
     const _onCheck = React.useCallback(() => {
+        if (wasDraggedRef.current) return;
         toggleCheckboxes(storeId, [node.id]);
     }, [storeId, node.id]);
 
     const handleTouchStart = React.useCallback((e: any) => {
+        wasDraggedRef.current = false;
         if (!onNodeTouchStart) return;
         const { pageY, locationY } = e.nativeEvent;
         onNodeTouchStart(node.id, pageY, locationY, nodeIndex);
@@ -355,10 +381,11 @@ function _Node<ID>(props: NodeProps<ID>) {
     } : undefined;
 
     const CustomDropIndicator = dragDropCustomizations?.CustomDropIndicatorComponent;
+    const indicatorLevel = nodeDropLevel ?? level;
     const dropIndicator = isDropTarget && nodeDropPosition ? (
         CustomDropIndicator
-            ? <CustomDropIndicator position={nodeDropPosition} />
-            : <NodeDropIndicator position={nodeDropPosition} styleProps={dragDropCustomizations?.dropIndicatorStyleProps} />
+            ? <CustomDropIndicator position={nodeDropPosition} level={indicatorLevel} indentationMultiplier={indentationMultiplier} />
+            : <NodeDropIndicator position={nodeDropPosition} level={indicatorLevel} indentationMultiplier={indentationMultiplier} styleProps={dragDropCustomizations?.dropIndicatorStyleProps} />
     ) : null;
 
     if (!CustomNodeRowComponent) {
@@ -371,6 +398,7 @@ function _Node<ID>(props: NodeProps<ID>) {
                     styles.nodeCheckboxAndArrowRow,
                     { paddingStart: level * indentationMultiplier },
                     { opacity: nodeOpacity },
+                    dropIndicator ? styles.nodeOverflowVisible : undefined,
                 ]}>
                 {dropIndicator}
                 <CheckboxComponent
@@ -398,7 +426,10 @@ function _Node<ID>(props: NodeProps<ID>) {
             <View
                 {...touchHandlers}
                 onLayout={onItemLayout ? handleLayout : undefined}
-                style={{ opacity: nodeOpacity }}
+                style={[
+                    { opacity: nodeOpacity },
+                    dropIndicator ? styles.nodeOverflowVisible : undefined,
+                ]}
             >
                 {dropIndicator}
                 <CustomNodeRowComponent
@@ -417,8 +448,10 @@ function _Node<ID>(props: NodeProps<ID>) {
     }
 };
 
-function NodeDropIndicator({ position, styleProps }: {
+function NodeDropIndicator({ position, level, indentationMultiplier, styleProps }: {
     position: DropPosition;
+    level: number;
+    indentationMultiplier: number;
     styleProps?: DropIndicatorStyleProps;
 }) {
     const lineColor = styleProps?.lineColor ?? "#0078FF";
@@ -427,6 +460,10 @@ function NodeDropIndicator({ position, styleProps }: {
     const highlightColor = styleProps?.highlightColor ?? "rgba(0, 120, 255, 0.15)";
     const highlightBorderColor = styleProps?.highlightBorderColor ?? "rgba(0, 120, 255, 0.5)";
 
+    // Indent the line to match the node's nesting level so users can
+    // visually distinguish drops at different tree depths.
+    const leftOffset = level * indentationMultiplier;
+
     if (position === "inside") {
         return (
             <View
@@ -434,6 +471,7 @@ function NodeDropIndicator({ position, styleProps }: {
                 style={[
                     styles.dropHighlight,
                     {
+                        left: leftOffset,
                         backgroundColor: highlightColor,
                         borderColor: highlightBorderColor,
                     },
@@ -442,26 +480,25 @@ function NodeDropIndicator({ position, styleProps }: {
         );
     }
 
+    // Ensure the circle isn't clipped at shallow indent levels
+    const safeLeftOffset = Math.max(leftOffset, circleSize / 2);
+
     return (
         <View
             pointerEvents="none"
             style={[
                 styles.dropLineContainer,
-                { height: lineThickness },
+                { height: lineThickness, left: safeLeftOffset },
                 position === "above" ? styles.dropLineTop : styles.dropLineBottom,
             ]}
         >
-            <View style={[
-                styles.dropLineCircle,
-                {
-                    width: circleSize,
-                    height: circleSize,
-                    borderRadius: circleSize / 2,
-                    backgroundColor: lineColor,
-                    marginLeft: -(circleSize / 2),
-                    marginTop: -(circleSize / 2 - lineThickness / 2),
-                },
-            ]} />
+            <View style={{
+                width: circleSize,
+                height: circleSize,
+                borderRadius: circleSize / 2,
+                backgroundColor: lineColor,
+                marginLeft: -(circleSize / 2),
+            }} />
             <View style={[
                 styles.dropLine,
                 {
@@ -510,6 +547,7 @@ const styles = StyleSheet.create({
         alignItems: "center",
         height: 3,
         zIndex: 10,
+        overflow: "visible",
     },
     dropLineTop: {
         top: 0,
@@ -517,17 +555,12 @@ const styles = StyleSheet.create({
     dropLineBottom: {
         bottom: 0,
     },
-    dropLineCircle: {
-        width: 10,
-        height: 10,
-        borderRadius: 5,
-        backgroundColor: "#0078FF",
-        marginLeft: -5,
-        marginTop: -4,
-    },
     dropLine: {
         flex: 1,
         height: 3,
         backgroundColor: "#0078FF",
     },
+    nodeOverflowVisible: {
+        overflow: "visible",
+    },
 });

package/src/helpers/toggleCheckbox.helper.ts

@@ -225,7 +225,7 @@ export function recalculateCheckedStates<ID>(storeId: string) {
     const tempIndeterminate = new Set(indeterminate);
 
     // Collect parent nodes and clean up leaf nodes that shouldn't be indeterminate.
-    // A leaf node (no children) can never be indeterminate — this can happen when
+    // A leaf node (no children) can never be indeterminate - this can happen when
     // all children of a formerly-indeterminate parent are dragged away.
     const parentNodes: ID[] = [];
     for (const [id, node] of nodeMap) {