ngx-virtual-dnd 1.2.2 → 1.2.3

package/package.json

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

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

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { InjectionToken, OnInit, AfterViewInit, OnDestroy, TemplateRef, Signal, WritableSignal } from '@angular/core';
+import { InjectionToken, OnDestroy, OnInit, AfterViewInit, TemplateRef, Signal, WritableSignal } from '@angular/core';
 
 /**
  * Represents the item currently being dragged.
@@ -572,6 +572,28 @@ declare class KeyboardDragService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<KeyboardDragService>;
 }
 
+/**
+ * Service that manages a shared overlay container appended to `document.body`.
+ *
+ * Elements placed inside the overlay container escape any ancestor CSS `transform`,
+ * `perspective`, or `filter` that would create a new containing block for
+ * `position: fixed` children. This ensures viewport-relative positioning works
+ * correctly regardless of where the consuming component sits in the DOM tree.
+ *
+ * Mirrors the strategy used by Angular CDK's `OverlayContainer`.
+ */
+declare class OverlayContainerService implements OnDestroy {
+    #private;
+    /**
+     * Returns the shared overlay container element, lazily creating it on first access.
+     * Returns `null` in non-browser environments (SSR).
+     */
+    getContainerElement(): HTMLElement | null;
+    ngOnDestroy(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<OverlayContainerService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<OverlayContainerService>;
+}
+
 /**
  * Context provided to the item template.
  */
@@ -753,8 +775,9 @@ interface DragPreviewContext<T = unknown> {
 /**
  * Renders a preview of the dragged item that follows the cursor.
  *
- * This component should be placed at the root of your application (or at least
- * outside of any scrollable containers) to ensure the preview is always visible.
+ * The component automatically teleports itself into a body-level overlay container,
+ * so it works correctly even inside ancestors with CSS `transform` (e.g. Ionic pages).
+ * It can be placed anywhere in the component tree.
  *
  * @example
  * ```html
@@ -765,7 +788,8 @@ interface DragPreviewContext<T = unknown> {
  * </vdnd-drag-preview>
  * ```
  */
-declare class DragPreviewComponent<T = unknown> {
+declare class DragPreviewComponent<T = unknown> implements OnDestroy {
+    #private;
     protected readonly dragState: DragStateService;
     /** Optional custom template for the preview */
     previewTemplate: _angular_core.InputSignal<TemplateRef<DragPreviewContext<T>> | undefined>;
@@ -779,6 +803,7 @@ declare class DragPreviewComponent<T = unknown> {
     /** The cloned element from drag state (used when no custom template is provided) */
     protected readonly clonedElement: _angular_core.Signal<HTMLElement | null>;
     constructor();
+    ngOnDestroy(): void;
     /** Whether the preview is visible */
     protected readonly isVisible: _angular_core.Signal<boolean>;
     /** Position of the preview */
@@ -1232,6 +1257,10 @@ declare class DroppableDirective implements OnInit, OnDestroy {
      * Optional when a parent `vdndGroup` directive provides the group context.
      */
     vdndDroppableGroup: _angular_core.InputSignal<string | undefined>;
+    /**
+     * Resolved group name - uses explicit input or falls back to parent group.
+     * Returns null (and disables dropping) if neither is available.
+     */
     readonly effectiveGroup: _angular_core.Signal<string | null>;
     /** Optional data associated with this droppable */
     vdndDroppableData: _angular_core.InputSignal<unknown>;
@@ -1544,5 +1573,5 @@ declare function insertAt<T>(list: T[], item: T, index: number): T[];
  */
 declare function removeAt<T>(list: T[], index: number): T[];
 
-export { AutoScrollService, DragPlaceholderComponent, DragPreviewComponent, DragStateService, DraggableDirective, DroppableDirective, DroppableGroupDirective, END_OF_LIST, ElementCloneService, INITIAL_DRAG_STATE, KeyboardDragService, PlaceholderComponent, PositionCalculatorService, ScrollableDirective, VDND_GROUP_TOKEN, VDND_SCROLL_CONTAINER, VDND_VIRTUAL_VIEWPORT, VirtualContentComponent, VirtualForDirective, VirtualScrollContainerComponent, VirtualSortableListComponent, VirtualViewportComponent, applyMove, insertAt, isNoOpDrop, moveItem, removeAt, reorderItems };
+export { AutoScrollService, DragPlaceholderComponent, DragPreviewComponent, DragStateService, DraggableDirective, DroppableDirective, DroppableGroupDirective, END_OF_LIST, ElementCloneService, 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, VisibleRangeChange };