clauderic/dnd-kit @dnd-kit/vue@0.4.0

on GitHub

Minor Changes

• #1915 9b24dff Thanks @clauderic! - Redesign event type system to follow the DOM EventMap pattern. Introduces DragDropEventMap for event object types and DragDropEventHandlers for event handler signatures, replacing the ambiguously named DragDropEvents. Event type aliases (CollisionEvent, DragStartEvent, etc.) now derive directly from DragDropEventMap rather than using Parameters<> extraction.

  Migration guide

  • DragDropEvents has been split into two types:
    • DragDropEventMap — maps event names to event object types (like WindowEventMap)
    • DragDropEventHandlers — maps event names to (event, manager) => void handler signatures
  • If you were importing DragDropEvents to type event objects, use DragDropEventMap instead:

    // Before
    type MyEvent = Parameters<DragDropEvents<D, P, M>['dragend']>[0];
    // After
    type MyEvent = DragDropEventMap<D, P, M>['dragend'];

  • If you were importing DragDropEvents to type event handlers, use DragDropEventHandlers instead:

    // Before
    const handler: DragDropEvents<D, P, M>['dragend'] = (event, manager) => {};
    // After
    const handler: DragDropEventHandlers<D, P, M>['dragend'] = (
      event,
      manager
    ) => {};

  • The DragDropEvents re-export from @dnd-kit/react and @dnd-kit/solid has been removed. Import DragDropEventMap or DragDropEventHandlers from @dnd-kit/abstract directly if needed.
  • Convenience aliases (CollisionEvent, DragStartEvent, DragEndEvent, etc.) are unchanged and continue to work as before.

• #1938 e69387d Thanks @clauderic! - Added per-entity plugin configuration and moved feedback from the Draggable entity to the Feedback plugin.

  Draggable entities now accept a plugins property for per-entity plugin configuration, using the existing Plugin.configure() pattern. Plugins can read per-entity options via source.pluginConfig(PluginClass).

  The feedback property ('default' | 'move' | 'clone' | 'none') has been moved from the Draggable entity to FeedbackOptions. Drop animation can also now be configured per-draggable.

  Plugins listed in an entity's plugins array are auto-registered on the manager if not already present. The Sortable class now uses this generic mechanism instead of its own custom registration logic.

  Migration guide

  The feedback property has been moved from the draggable/sortable hook input to per-entity Feedback plugin configuration.

  Before:

  import {FeedbackType} from '@dnd-kit/dom';
  
  useDraggable({id: 'item', feedback: 'clone'});
  useSortable({id: 'item', index: 0, feedback: 'clone'});

  After:

  import {Feedback} from '@dnd-kit/dom';
  
  useDraggable({
    id: 'item',
    plugins: [Feedback.configure({feedback: 'clone'})],
  });
  useSortable({
    id: 'item',
    index: 0,
    plugins: (defaults) => [
      ...defaults,
      Feedback.configure({feedback: 'clone'}),
    ],
  });

  Drop animation can now be configured per-draggable:

  useDraggable({
    id: 'item',
    plugins: [Feedback.configure({feedback: 'clone', dropAnimation: null})],
  });

Patch Changes

• #1971 8fc1962 Thanks @clauderic! - Added LICENSE file to all published packages.

• #1953 cdaebff Thanks @ImBaedin! - Fix sortable type narrowing so isSortable(event.operation.source) narrows to a sortable draggable with access to initialIndex, and re-export the drag event type aliases from @dnd-kit/vue.

• #1985 ed65220 Thanks @tenianon! - fix: preserve DragDropProvider emits type in built declaration files

• Updated dependencies [4bc7e71, 87bf1e6, 521f760, c001272, cde61e4, 78af13b, 1328af8, 532ae9b, 267c97c, bfff7de, a5935e0, 462e435, 9b24dff, 8fc1962, 88d5ef9, 8115a57, 688e00f, cdaebff, e69387d, 11ff2eb, 7489265, 4e35963, 5a2ed80]:

  • @dnd-kit/dom@0.4.0
  • @dnd-kit/abstract@0.4.0
  • @dnd-kit/state@0.4.0