ngx-virtual-dnd 3.2.0-alpha.1 → 3.2.0

package/package.json

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

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

@@ -351,13 +351,25 @@ interface VdndAnimationConfig {
      * @default 'cubic-bezier(0.2, 0, 0, 1)'
      */
     shiftEasing?: string;
+    /**
+     * Duration (ms) of the drop animation: on drop or cancel, the drag preview glides into
+     * the dropped item's final position instead of disappearing. `0` disables it.
+     * @default 200
+     */
+    dropDuration?: number;
+    /**
+     * CSS easing function for the drop animation.
+     * @default 'cubic-bezier(0.2, 0, 0, 1)'
+     */
+    dropEasing?: string;
 }
 /**
  * Opt-in animation configuration. When provided, items displaced by the placeholder
- * slide into their new position instead of jumping. Resolved through the element
+ * slide into their new position instead of jumping, and on drop the drag preview glides
+ * into the item's final position. Resolved through the element
  * injector, so it can be provided app-wide or per component subtree.
  *
- * The animation is skipped when the user prefers reduced motion. Values are read each
+ * Animations are skipped when the user prefers reduced motion. Values are read each
  * time an animation starts, so getters can toggle the animation at runtime.
  *
  * @example
@@ -994,6 +1006,9 @@ interface DragPreviewContext<T = unknown> {
  * so it works correctly even inside ancestors with CSS `transform` (e.g. Ionic pages).
  * It can be placed anywhere in the component tree.
  *
+ * When `VDND_ANIMATION_CONFIG` is provided, the preview stays up briefly after a drop or
+ * cancel and glides into the item's final position.
+ *
  * @example
  * ```html
  * <vdnd-drag-preview>
@@ -1015,6 +1030,12 @@ declare class DragPreviewComponent<T = unknown> implements OnDestroy {
     }>;
     /** Reference to the clone container element (cannot use ES private with viewChild) */
     private readonly cloneContainer;
+    /** The rendered preview box (cannot use ES private with viewChild) */
+    private readonly previewElement;
+    /** Whether the preview is playing the drop animation */
+    protected readonly isSettling: _angular_core.Signal<boolean>;
+    /** The item shown: the live dragged item, or the dropped one while it settles */
+    protected readonly displayedItem: _angular_core.Signal<DraggedItem | null>;
     /** The cloned element from drag state (used when no custom template is provided) */
     protected readonly clonedElement: _angular_core.Signal<HTMLElement | null>;
     constructor();
@@ -1022,10 +1043,7 @@ declare class DragPreviewComponent<T = unknown> implements OnDestroy {
     /** Whether the preview is visible */
     protected readonly isVisible: _angular_core.Signal<boolean>;
     /** Position of the preview */
-    protected readonly position: _angular_core.Signal<{
-        x: number;
-        y: number;
-    }>;
+    protected readonly position: _angular_core.Signal<CursorPosition>;
     /** Transform-based positioning for better performance (avoid layout from left/top). */
     protected readonly transform: _angular_core.Signal<string>;
     /** Dimensions of the preview */