ngx-virtual-dnd 2.0.0 → 3.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ngx-virtual-dnd",
-  "version": "2.0.0",
+  "version": "3.0.1",
   "description": "A performant drag-and-drop library for Angular that works seamlessly with virtual scrolling",
   "keywords": [
     "angular",

package/types/ngx-virtual-dnd.d.ts

@@ -81,54 +81,6 @@ interface DragStartEvent {
     /** 0-indexed position in the source list (for screen reader announcements) */
     sourceIndex: number;
 }
-/**
- * Event emitted during drag movement.
- */
-interface DragMoveEvent {
-    /** Unique identifier for the draggable item */
-    draggableId: string;
-    /** ID of the droppable container the item originated from */
-    sourceDroppableId: string;
-    /** ID of the droppable currently being hovered, or null */
-    targetDroppableId: string | null;
-    /** ID of the item to insert before, or null */
-    placeholderId: string | null;
-    /** Current cursor position */
-    position: CursorPosition;
-    /** Current 0-indexed placeholder position (for screen reader announcements) */
-    targetIndex: number | null;
-}
-/**
- * Event emitted when an item enters a droppable container.
- */
-interface DragEnterEvent {
-    /** ID of the droppable being entered */
-    droppableId: string;
-    /** Information about the dragged item */
-    draggedItem: DraggedItem;
-}
-/**
- * Event emitted when an item leaves a droppable container.
- */
-interface DragLeaveEvent {
-    /** ID of the droppable being left */
-    droppableId: string;
-    /** Information about the dragged item */
-    draggedItem: DraggedItem;
-}
-/**
- * Event emitted while hovering over a droppable container.
- */
-interface DragOverEvent {
-    /** ID of the droppable being hovered */
-    droppableId: string;
-    /** Information about the dragged item */
-    draggedItem: DraggedItem;
-    /** ID of the item the placeholder should appear before */
-    placeholderId: string | null;
-    /** Current cursor position */
-    position: CursorPosition;
-}
 /**
  * Source information for a drop event.
  */
@@ -584,6 +536,13 @@ declare class AutoScrollService {
      * Call this when a drag ends.
      */
     stopMonitoring(): void;
+    /**
+     * Override the cursor position used for edge detection.
+     * When set, #tick() uses this instead of DragStateService.cursorPosition().
+     * Used by constrainToContainer to provide a position without grabOffset distortion.
+     * @internal
+     */
+    setCursorOverride(position: CursorPosition): void;
     /**
      * Check if auto-scrolling is currently active.
      */
@@ -701,13 +660,6 @@ interface VirtualScrollItemContext<T> {
     /** Whether this item is "sticky" (always rendered) */
     isSticky: boolean;
 }
-/**
- * Event emitted when the visible range changes.
- */
-interface VisibleRangeChange {
-    start: number;
-    end: number;
-}
 /**
  * A virtual scroll container that only renders visible items.
  *
@@ -815,10 +767,6 @@ declare class VirtualScrollContainerComponent<T> implements OnInit, AfterViewIni
      * Effective sticky item IDs - combines user-provided IDs with auto-sticky dragged item.
      */
     protected readonly effectiveStickyIds: _angular_core.Signal<string[]>;
-    /** Emits when the visible range changes */
-    visibleRangeChange: _angular_core.OutputEmitterRef<VisibleRangeChange>;
-    /** Emits when scroll position changes */
-    scrollPositionChange: _angular_core.OutputEmitterRef<number>;
     /** Total height of all items (for scrollbar) */
     protected readonly totalHeight: _angular_core.Signal<number>;
     /** Transform offset for content wrapper (position of first rendered item) */
@@ -864,7 +812,7 @@ declare class VirtualScrollContainerComponent<T> implements OnInit, AfterViewIni
      */
     scrollBy(delta: number): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<VirtualScrollContainerComponent<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<VirtualScrollContainerComponent<any>, "vdnd-virtual-scroll", never, { "itemTemplate": { "alias": "itemTemplate"; "required": true; "isSignal": true; }; "scrollContainerId": { "alias": "scrollContainerId"; "required": false; "isSignal": true; }; "autoScrollEnabled": { "alias": "autoScrollEnabled"; "required": false; "isSignal": true; }; "autoScrollConfig": { "alias": "autoScrollConfig"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": true; "isSignal": true; }; "itemHeight": { "alias": "itemHeight"; "required": true; "isSignal": true; }; "dynamicItemHeight": { "alias": "dynamicItemHeight"; "required": false; "isSignal": true; }; "containerHeight": { "alias": "containerHeight"; "required": false; "isSignal": true; }; "overscan": { "alias": "overscan"; "required": false; "isSignal": true; }; "stickyItemIds": { "alias": "stickyItemIds"; "required": false; "isSignal": true; }; "itemIdFn": { "alias": "itemIdFn"; "required": true; "isSignal": true; }; "trackByFn": { "alias": "trackByFn"; "required": false; "isSignal": true; }; "droppableId": { "alias": "droppableId"; "required": false; "isSignal": true; }; "autoStickyDraggedItem": { "alias": "autoStickyDraggedItem"; "required": false; "isSignal": true; }; }, { "visibleRangeChange": "visibleRangeChange"; "scrollPositionChange": "scrollPositionChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<VirtualScrollContainerComponent<any>, "vdnd-virtual-scroll", never, { "itemTemplate": { "alias": "itemTemplate"; "required": true; "isSignal": true; }; "scrollContainerId": { "alias": "scrollContainerId"; "required": false; "isSignal": true; }; "autoScrollEnabled": { "alias": "autoScrollEnabled"; "required": false; "isSignal": true; }; "autoScrollConfig": { "alias": "autoScrollConfig"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": true; "isSignal": true; }; "itemHeight": { "alias": "itemHeight"; "required": true; "isSignal": true; }; "dynamicItemHeight": { "alias": "dynamicItemHeight"; "required": false; "isSignal": true; }; "containerHeight": { "alias": "containerHeight"; "required": false; "isSignal": true; }; "overscan": { "alias": "overscan"; "required": false; "isSignal": true; }; "stickyItemIds": { "alias": "stickyItemIds"; "required": false; "isSignal": true; }; "itemIdFn": { "alias": "itemIdFn"; "required": true; "isSignal": true; }; "trackByFn": { "alias": "trackByFn"; "required": false; "isSignal": true; }; "droppableId": { "alias": "droppableId"; "required": false; "isSignal": true; }; "autoStickyDraggedItem": { "alias": "autoStickyDraggedItem"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 /**
@@ -1069,18 +1017,8 @@ declare class VirtualSortableListComponent<T> {
     constrainToContainer: _angular_core.InputSignal<boolean>;
     /** Emits when an item is dropped on this list */
     drop: _angular_core.OutputEmitterRef<DropEvent>;
-    /** Emits when a dragged item enters this list */
-    dragEnter: _angular_core.OutputEmitterRef<DragEnterEvent>;
-    /** Emits when a dragged item leaves this list */
-    dragLeave: _angular_core.OutputEmitterRef<DragLeaveEvent>;
-    /** Emits while a dragged item is over this list */
-    dragOver: _angular_core.OutputEmitterRef<DragOverEvent>;
-    /** Emits when the visible range changes */
-    visibleRangeChange: _angular_core.OutputEmitterRef<VisibleRangeChange>;
-    /** Emits when scroll position changes */
-    scrollPositionChange: _angular_core.OutputEmitterRef<number>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<VirtualSortableListComponent<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<VirtualSortableListComponent<any>, "vdnd-sortable-list", never, { "droppableId": { "alias": "droppableId"; "required": true; "isSignal": true; }; "group": { "alias": "group"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": true; "isSignal": true; }; "itemHeight": { "alias": "itemHeight"; "required": true; "isSignal": true; }; "dynamicItemHeight": { "alias": "dynamicItemHeight"; "required": false; "isSignal": true; }; "itemIdFn": { "alias": "itemIdFn"; "required": true; "isSignal": true; }; "itemTemplate": { "alias": "itemTemplate"; "required": true; "isSignal": true; }; "trackByFn": { "alias": "trackByFn"; "required": false; "isSignal": true; }; "droppableData": { "alias": "droppableData"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "containerHeight": { "alias": "containerHeight"; "required": false; "isSignal": true; }; "overscan": { "alias": "overscan"; "required": false; "isSignal": true; }; "autoScrollEnabled": { "alias": "autoScrollEnabled"; "required": false; "isSignal": true; }; "autoScrollConfig": { "alias": "autoScrollConfig"; "required": false; "isSignal": true; }; "constrainToContainer": { "alias": "constrainToContainer"; "required": false; "isSignal": true; }; }, { "drop": "drop"; "dragEnter": "dragEnter"; "dragLeave": "dragLeave"; "dragOver": "dragOver"; "visibleRangeChange": "visibleRangeChange"; "scrollPositionChange": "scrollPositionChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<VirtualSortableListComponent<any>, "vdnd-sortable-list", never, { "droppableId": { "alias": "droppableId"; "required": true; "isSignal": true; }; "group": { "alias": "group"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": true; "isSignal": true; }; "itemHeight": { "alias": "itemHeight"; "required": true; "isSignal": true; }; "dynamicItemHeight": { "alias": "dynamicItemHeight"; "required": false; "isSignal": true; }; "itemIdFn": { "alias": "itemIdFn"; "required": true; "isSignal": true; }; "itemTemplate": { "alias": "itemTemplate"; "required": true; "isSignal": true; }; "trackByFn": { "alias": "trackByFn"; "required": false; "isSignal": true; }; "droppableData": { "alias": "droppableData"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "containerHeight": { "alias": "containerHeight"; "required": false; "isSignal": true; }; "overscan": { "alias": "overscan"; "required": false; "isSignal": true; }; "autoScrollEnabled": { "alias": "autoScrollEnabled"; "required": false; "isSignal": true; }; "autoScrollConfig": { "alias": "autoScrollConfig"; "required": false; "isSignal": true; }; "constrainToContainer": { "alias": "constrainToContainer"; "required": false; "isSignal": true; }; }, { "drop": "drop"; }, never, never, true, never>;
 }
 
 /**
@@ -1292,12 +1230,8 @@ declare class DraggableDirective implements OnInit, OnDestroy {
     lockAxis: _angular_core.InputSignal<"x" | "y" | null>;
     /** Emits when drag starts */
     dragStart: _angular_core.OutputEmitterRef<DragStartEvent>;
-    /** Emits during drag movement */
-    dragMove: _angular_core.OutputEmitterRef<DragMoveEvent>;
     /** Emits when drag ends */
     dragEnd: _angular_core.OutputEmitterRef<DragEndEvent>;
-    /** Emits when ready-to-drag state changes (after delay passes) */
-    dragReadyChange: _angular_core.OutputEmitterRef<boolean>;
     readonly isPending: _angular_core.Signal<boolean>;
     /** Whether this element is currently being dragged (based on global drag state) */
     readonly isDragging: _angular_core.Signal<boolean>;
@@ -1325,7 +1259,7 @@ declare class DraggableDirective implements OnInit, OnDestroy {
      */
     protected onEscape(): boolean;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DraggableDirective, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DraggableDirective, "[vdndDraggable]", never, { "vdndDraggable": { "alias": "vdndDraggable"; "required": true; "isSignal": true; }; "vdndDraggableGroup": { "alias": "vdndDraggableGroup"; "required": false; "isSignal": true; }; "vdndDraggableData": { "alias": "vdndDraggableData"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "dragHandle": { "alias": "dragHandle"; "required": false; "isSignal": true; }; "dragThreshold": { "alias": "dragThreshold"; "required": false; "isSignal": true; }; "dragDelay": { "alias": "dragDelay"; "required": false; "isSignal": true; }; "lockAxis": { "alias": "lockAxis"; "required": false; "isSignal": true; }; }, { "dragStart": "dragStart"; "dragMove": "dragMove"; "dragEnd": "dragEnd"; "dragReadyChange": "dragReadyChange"; }, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DraggableDirective, "[vdndDraggable]", never, { "vdndDraggable": { "alias": "vdndDraggable"; "required": true; "isSignal": true; }; "vdndDraggableGroup": { "alias": "vdndDraggableGroup"; "required": false; "isSignal": true; }; "vdndDraggableData": { "alias": "vdndDraggableData"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "dragHandle": { "alias": "dragHandle"; "required": false; "isSignal": true; }; "dragThreshold": { "alias": "dragThreshold"; "required": false; "isSignal": true; }; "dragDelay": { "alias": "dragDelay"; "required": false; "isSignal": true; }; "lockAxis": { "alias": "lockAxis"; "required": false; "isSignal": true; }; }, { "dragStart": "dragStart"; "dragEnd": "dragEnd"; }, never, never, true, never>;
 }
 
 /**
@@ -1373,12 +1307,6 @@ declare class DroppableDirective implements OnInit, OnDestroy {
     autoScrollConfig: _angular_core.InputSignal<Partial<AutoScrollConfig>>;
     /** Constrain drag preview and placeholder to container boundaries */
     constrainToContainer: _angular_core.InputSignal<boolean>;
-    /** Emits when a dragged item enters this droppable */
-    dragEnter: _angular_core.OutputEmitterRef<DragEnterEvent>;
-    /** Emits when a dragged item leaves this droppable */
-    dragLeave: _angular_core.OutputEmitterRef<DragLeaveEvent>;
-    /** Emits while a dragged item is over this droppable */
-    dragOver: _angular_core.OutputEmitterRef<DragOverEvent>;
     /** Emits when an item is dropped on this droppable */
     drop: _angular_core.OutputEmitterRef<DropEvent>;
     /** Whether this droppable is currently being targeted */
@@ -1405,7 +1333,7 @@ declare class DroppableDirective implements OnInit, OnDestroy {
      */
     getScrollHeight(): number;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DroppableDirective, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DroppableDirective, "[vdndDroppable]", never, { "vdndDroppable": { "alias": "vdndDroppable"; "required": true; "isSignal": true; }; "vdndDroppableGroup": { "alias": "vdndDroppableGroup"; "required": false; "isSignal": true; }; "vdndDroppableData": { "alias": "vdndDroppableData"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "autoScrollEnabled": { "alias": "autoScrollEnabled"; "required": false; "isSignal": true; }; "autoScrollConfig": { "alias": "autoScrollConfig"; "required": false; "isSignal": true; }; "constrainToContainer": { "alias": "constrainToContainer"; "required": false; "isSignal": true; }; }, { "dragEnter": "dragEnter"; "dragLeave": "dragLeave"; "dragOver": "dragOver"; "drop": "drop"; }, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DroppableDirective, "[vdndDroppable]", never, { "vdndDroppable": { "alias": "vdndDroppable"; "required": true; "isSignal": true; }; "vdndDroppableGroup": { "alias": "vdndDroppableGroup"; "required": false; "isSignal": true; }; "vdndDroppableData": { "alias": "vdndDroppableData"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "autoScrollEnabled": { "alias": "autoScrollEnabled"; "required": false; "isSignal": true; }; "autoScrollConfig": { "alias": "autoScrollConfig"; "required": false; "isSignal": true; }; "constrainToContainer": { "alias": "constrainToContainer"; "required": false; "isSignal": true; }; }, { "drop": "drop"; }, never, never, true, never>;
 }
 
 /**
@@ -1714,4 +1642,4 @@ declare function insertAt<T>(list: T[], item: T, index: number): T[];
 declare function removeAt<T>(list: T[], index: number): T[];
 
 export { AutoScrollService, ContentHeaderDirective, DragPlaceholderComponent, DragPreviewComponent, DragStateService, DraggableDirective, DroppableDirective, DroppableGroupDirective, DynamicHeightStrategy, END_OF_LIST, ElementCloneService, FixedHeightStrategy, INITIAL_DRAG_STATE, KeyboardDragService, OverlayContainerService, PlaceholderComponent, PositionCalculatorService, ScrollableDirective, VDND_GROUP_TOKEN, VDND_SCROLL_CONTAINER, VDND_VIRTUAL_VIEWPORT, VirtualContentComponent, VirtualForDirective, VirtualScrollContainerComponent, VirtualSortableListComponent, VirtualViewportComponent, applyMove, insertAt, isNoOpDrop, moveItem, removeAt, reorderItems };
-export type { AutoScrollConfig, CursorPosition, DragEndEvent, DragEnterEvent, DragLeaveEvent, DragMoveEvent, DragOverEvent, DragPreviewContext, DragStartEvent, DragState, DraggedItem, DropDestination, DropEvent, DropSource, GrabOffset, PlaceholderContext, VdndGroupContext, VdndScrollContainer, VdndVirtualViewport, VirtualForContext, VirtualScrollItemContext, VirtualScrollStrategy, VisibleRangeChange };
+export type { AutoScrollConfig, CursorPosition, DragEndEvent, DragPreviewContext, DragStartEvent, DragState, DraggedItem, DropDestination, DropEvent, DropSource, GrabOffset, PlaceholderContext, VdndGroupContext, VdndScrollContainer, VdndVirtualViewport, VirtualForContext, VirtualScrollItemContext, VirtualScrollStrategy };