@proyecto-viviana/solid-stately 0.0.5 → 0.1.0

package/src/dnd/types.d.ts

@@ -0,0 +1,264 @@
+/**
+ * Drag and Drop types for solid-stately.
+ *
+ * Core types for drag and drop operations, matching React Aria's DnD API.
+ */
+/** The type of drop operation to perform. */
+export type DropOperation = 'copy' | 'link' | 'move' | 'cancel';
+/** Drag item data as key-value pairs where keys are MIME types or custom types. */
+export interface DragItem {
+    [type: string]: string;
+}
+/** Base event for drag/drop operations with coordinates. */
+export interface DragDropEvent {
+    /** The x coordinate of the event, relative to the target element. */
+    x: number;
+    /** The y coordinate of the event, relative to the target element. */
+    y: number;
+}
+/** Event fired when a drag operation starts. */
+export interface DragStartEvent extends DragDropEvent {
+    /** The event type. */
+    type: 'dragstart';
+}
+/** Event fired as a drag moves. */
+export interface DragMoveEvent extends DragDropEvent {
+    /** The event type. */
+    type: 'dragmove';
+}
+/** Event fired when a drag operation ends. */
+export interface DragEndEvent extends DragDropEvent {
+    /** The event type. */
+    type: 'dragend';
+    /** The drop operation that occurred. */
+    dropOperation: DropOperation;
+}
+/** Event fired when a drag enters a drop target. */
+export interface DropEnterEvent extends DragDropEvent {
+    /** The event type. */
+    type: 'dropenter';
+}
+/** Event fired as a drag moves within a drop target. */
+export interface DropMoveEvent extends DragDropEvent {
+    /** The event type. */
+    type: 'dropmove';
+}
+/** Event fired when a drag is held over a drop target. */
+export interface DropActivateEvent extends DragDropEvent {
+    /** The event type. */
+    type: 'dropactivate';
+}
+/** Event fired when a drag exits a drop target. */
+export interface DropExitEvent extends DragDropEvent {
+    /** The event type. */
+    type: 'dropexit';
+}
+/** A text item in a drop operation. */
+export interface TextDropItem {
+    /** The item kind. */
+    kind: 'text';
+    /** The drag types available for this item. */
+    types: Set<string>;
+    /** Returns the data for the given type as a string. */
+    getText(type: string): Promise<string>;
+}
+/** A file item in a drop operation. */
+export interface FileDropItem {
+    /** The item kind. */
+    kind: 'file';
+    /** The file type (usually a mime type). */
+    type: string;
+    /** The file name. */
+    name: string;
+    /** Returns the contents of the file as a blob. */
+    getFile(): Promise<File>;
+    /** Returns the contents of the file as a string. */
+    getText(): Promise<string>;
+}
+/** A directory item in a drop operation. */
+export interface DirectoryDropItem {
+    /** The item kind. */
+    kind: 'directory';
+    /** The directory name. */
+    name: string;
+    /** Returns the entries contained within the directory. */
+    getEntries(): AsyncIterable<FileDropItem | DirectoryDropItem>;
+}
+/** Union of all drop item types. */
+export type DropItem = TextDropItem | FileDropItem | DirectoryDropItem;
+/** Event fired when items are dropped. */
+export interface DropEvent extends DragDropEvent {
+    /** The event type. */
+    type: 'drop';
+    /** The drop operation that should occur. */
+    dropOperation: DropOperation;
+    /** The dropped items. */
+    items: DropItem[];
+}
+/** Position relative to an item for drop operations. */
+export type DropPosition = 'on' | 'before' | 'after';
+/** Drop target representing the root of a collection. */
+export interface RootDropTarget {
+    /** The drop target type. */
+    type: 'root';
+}
+/** Drop target representing an item in a collection. */
+export interface ItemDropTarget {
+    /** The drop target type. */
+    type: 'item';
+    /** The item key. */
+    key: string | number;
+    /** The drop position relative to the item. */
+    dropPosition: DropPosition;
+}
+/** Union of drop target types. */
+export type DropTarget = RootDropTarget | ItemDropTarget;
+/** Event fired when a drag enters a droppable collection. */
+export interface DroppableCollectionEnterEvent extends DropEnterEvent {
+    /** The drop target. */
+    target: DropTarget;
+}
+/** Event fired as a drag moves within a droppable collection. */
+export interface DroppableCollectionMoveEvent extends DropMoveEvent {
+    /** The drop target. */
+    target: DropTarget;
+}
+/** Event fired when a drag is held over a droppable collection item. */
+export interface DroppableCollectionActivateEvent extends DropActivateEvent {
+    /** The drop target. */
+    target: DropTarget;
+}
+/** Event fired when a drag exits a droppable collection. */
+export interface DroppableCollectionExitEvent extends DropExitEvent {
+    /** The drop target. */
+    target: DropTarget;
+}
+/** Event fired when items are dropped on a droppable collection. */
+export interface DroppableCollectionDropEvent extends DropEvent {
+    /** The drop target. */
+    target: DropTarget;
+}
+/** Event for inserting items between existing collection items. */
+export interface DroppableCollectionInsertDropEvent {
+    /** The dropped items. */
+    items: DropItem[];
+    /** The drop operation that should occur. */
+    dropOperation: DropOperation;
+    /** The drop target. */
+    target: ItemDropTarget;
+}
+/** Event for dropping on the root of a collection. */
+export interface DroppableCollectionRootDropEvent {
+    /** The dropped items. */
+    items: DropItem[];
+    /** The drop operation that should occur. */
+    dropOperation: DropOperation;
+}
+/** Event for dropping on a specific item. */
+export interface DroppableCollectionOnItemDropEvent {
+    /** The dropped items. */
+    items: DropItem[];
+    /** The drop operation that should occur. */
+    dropOperation: DropOperation;
+    /** Whether the drag originated within the same collection as the drop. */
+    isInternal: boolean;
+    /** The drop target. */
+    target: ItemDropTarget;
+}
+/** Event for reordering items within a collection. */
+export interface DroppableCollectionReorderEvent {
+    /** The keys of the items that were reordered. */
+    keys: Set<string | number>;
+    /** The drop operation that should occur. */
+    dropOperation: DropOperation;
+    /** The drop target. */
+    target: ItemDropTarget;
+}
+/** Interface for checking drag types. */
+export interface DragTypes {
+    /** Returns whether the drag contains data of the given type. */
+    has(type: string | symbol): boolean;
+}
+/** Delegate for determining drop targets within a collection. */
+export interface DropTargetDelegate {
+    /**
+     * Returns a drop target within a collection for the given coordinates.
+     * @param x - X coordinate relative to the collection container
+     * @param y - Y coordinate relative to the collection container
+     * @param isValidDropTarget - Function to check if a target is valid
+     */
+    getDropTargetFromPoint(x: number, y: number, isValidDropTarget: (target: DropTarget) => boolean): DropTarget | null;
+}
+/** Event fired when a collection drag starts. */
+export interface DraggableCollectionStartEvent extends DragStartEvent {
+    /** The keys of the items that were dragged. */
+    keys: Set<string | number>;
+}
+/** Event fired as a collection drag moves. */
+export interface DraggableCollectionMoveEvent extends DragMoveEvent {
+    /** The keys of the items that were dragged. */
+    keys: Set<string | number>;
+}
+/** Event fired when a collection drag ends. */
+export interface DraggableCollectionEndEvent extends DragEndEvent {
+    /** The keys of the items that were dragged. */
+    keys: Set<string | number>;
+    /** Whether the drop ended within the same collection as it originated. */
+    isInternal: boolean;
+}
+/** Function to render a custom drag preview. */
+export type DragPreviewRenderer = (items: DragItem[], callback: (node: HTMLElement | null, x?: number, y?: number) => void) => void;
+/** Props for droppable collection utility handlers. */
+export interface DroppableCollectionUtilityOptions {
+    /**
+     * The drag types that the droppable collection accepts.
+     * @default 'all'
+     */
+    acceptedDragTypes?: 'all' | Array<string | symbol>;
+    /** Handler that is called when external items are dropped "between" items. */
+    onInsert?: (e: DroppableCollectionInsertDropEvent) => void;
+    /** Handler that is called when external items are dropped on the collection's root. */
+    onRootDrop?: (e: DroppableCollectionRootDropEvent) => void;
+    /** Handler that is called when items are dropped "on" an item. */
+    onItemDrop?: (e: DroppableCollectionOnItemDropEvent) => void;
+    /** Handler that is called when items are reordered within the collection. */
+    onReorder?: (e: DroppableCollectionReorderEvent) => void;
+    /** Handler that is called when items are moved within the source collection. */
+    onMove?: (e: DroppableCollectionReorderEvent) => void;
+    /** A function returning whether a given target is a valid "on" drop target. */
+    shouldAcceptItemDrop?: (target: ItemDropTarget, types: DragTypes) => boolean;
+}
+/** Base props for droppable collections. */
+export interface DroppableCollectionBaseProps {
+    /** Handler that is called when a valid drag enters a drop target. */
+    onDropEnter?: (e: DroppableCollectionEnterEvent) => void;
+    /** Handler that is called after a valid drag is held over a drop target. */
+    onDropActivate?: (e: DroppableCollectionActivateEvent) => void;
+    /** Handler that is called when a valid drag exits a drop target. */
+    onDropExit?: (e: DroppableCollectionExitEvent) => void;
+    /** Handler that is called when a valid drag is dropped on a drop target. */
+    onDrop?: (e: DroppableCollectionDropEvent) => void;
+    /** A function returning the drop operation to be performed. */
+    getDropOperation?: (target: DropTarget, types: DragTypes, allowedOperations: DropOperation[]) => DropOperation;
+}
+/** Combined props for droppable collections. */
+export interface DroppableCollectionProps extends DroppableCollectionUtilityOptions, DroppableCollectionBaseProps {
+}
+/** Props for draggable collections. */
+export interface DraggableCollectionProps<T = object> {
+    /** Handler that is called when a drag operation is started. */
+    onDragStart?: (e: DraggableCollectionStartEvent) => void;
+    /** Handler that is called when the drag is moved. */
+    onDragMove?: (e: DraggableCollectionMoveEvent) => void;
+    /** Handler that is called when the drag operation ends. */
+    onDragEnd?: (e: DraggableCollectionEndEvent) => void;
+    /** A function that returns the items being dragged. */
+    getItems: (keys: Set<string | number>, items: T[]) => DragItem[];
+    /** The ref of the element that will be rendered as the drag preview. */
+    preview?: {
+        current: DragPreviewRenderer | null;
+    };
+    /** Function that returns the allowed drop operations. */
+    getAllowedDropOperations?: () => DropOperation[];
+}
+//# sourceMappingURL=types.d.ts.map

package/src/dnd/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,6CAA6C;AAC7C,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEhE,mFAAmF;AACnF,MAAM,WAAW,QAAQ;IACvB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB;AAED,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,CAAC,EAAE,MAAM,CAAC;IACV,qEAAqE;IACrE,CAAC,EAAE,MAAM,CAAC;CACX;AAED,gDAAgD;AAChD,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD,sBAAsB;IACtB,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,mCAAmC;AACnC,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD,sBAAsB;IACtB,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,8CAA8C;AAC9C,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD,sBAAsB;IACtB,IAAI,EAAE,SAAS,CAAC;IAChB,wCAAwC;IACxC,aAAa,EAAE,aAAa,CAAC;CAC9B;AAED,oDAAoD;AACpD,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD,sBAAsB;IACtB,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,wDAAwD;AACxD,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD,sBAAsB;IACtB,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,0DAA0D;AAC1D,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,sBAAsB;IACtB,IAAI,EAAE,cAAc,CAAC;CACtB;AAED,mDAAmD;AACnD,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD,sBAAsB;IACtB,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,uCAAuC;AACvC,MAAM,WAAW,YAAY;IAC3B,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnB,uDAAuD;IACvD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACxC;AAED,uCAAuC;AACvC,MAAM,WAAW,YAAY;IAC3B,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,oDAAoD;IACpD,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5B;AAED,4CAA4C;AAC5C,MAAM,WAAW,iBAAiB;IAChC,qBAAqB;IACrB,IAAI,EAAE,WAAW,CAAC;IAClB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,UAAU,IAAI,aAAa,CAAC,YAAY,GAAG,iBAAiB,CAAC,CAAC;CAC/D;AAED,oCAAoC;AACpC,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,YAAY,GAAG,iBAAiB,CAAC;AAEvE,0CAA0C;AAC1C,MAAM,WAAW,SAAU,SAAQ,aAAa;IAC9C,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,aAAa,EAAE,aAAa,CAAC;IAC7B,yBAAyB;IACzB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,wDAAwD;AACxD,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,QAAQ,GAAG,OAAO,CAAC;AAErD,yDAAyD;AACzD,MAAM,WAAW,cAAc;IAC7B,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC7B,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,8CAA8C;IAC9C,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,kCAAkC;AAClC,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,cAAc,CAAC;AAIzD,6DAA6D;AAC7D,MAAM,WAAW,6BAA8B,SAAQ,cAAc;IACnE,uBAAuB;IACvB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,iEAAiE;AACjE,MAAM,WAAW,4BAA6B,SAAQ,aAAa;IACjE,uBAAuB;IACvB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,wEAAwE;AACxE,MAAM,WAAW,gCAAiC,SAAQ,iBAAiB;IACzE,uBAAuB;IACvB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,4DAA4D;AAC5D,MAAM,WAAW,4BAA6B,SAAQ,aAAa;IACjE,uBAAuB;IACvB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,oEAAoE;AACpE,MAAM,WAAW,4BAA6B,SAAQ,SAAS;IAC7D,uBAAuB;IACvB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,mEAAmE;AACnE,MAAM,WAAW,kCAAkC;IACjD,yBAAyB;IACzB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,4CAA4C;IAC5C,aAAa,EAAE,aAAa,CAAC;IAC7B,uBAAuB;IACvB,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,sDAAsD;AACtD,MAAM,WAAW,gCAAgC;IAC/C,yBAAyB;IACzB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,4CAA4C;IAC5C,aAAa,EAAE,aAAa,CAAC;CAC9B;AAED,6CAA6C;AAC7C,MAAM,WAAW,kCAAkC;IACjD,yBAAyB;IACzB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,4CAA4C;IAC5C,aAAa,EAAE,aAAa,CAAC;IAC7B,0EAA0E;IAC1E,UAAU,EAAE,OAAO,CAAC;IACpB,uBAAuB;IACvB,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,sDAAsD;AACtD,MAAM,WAAW,+BAA+B;IAC9C,iDAAiD;IACjD,IAAI,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC3B,4CAA4C;IAC5C,aAAa,EAAE,aAAa,CAAC;IAC7B,uBAAuB;IACvB,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,yCAAyC;AACzC,MAAM,WAAW,SAAS;IACxB,gEAAgE;IAChE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CACrC;AAED,iEAAiE;AACjE,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,sBAAsB,CACpB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,iBAAiB,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,GACjD,UAAU,GAAG,IAAI,CAAC;CACtB;AAID,iDAAiD;AACjD,MAAM,WAAW,6BAA8B,SAAQ,cAAc;IACnE,+CAA+C;IAC/C,IAAI,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;CAC5B;AAED,8CAA8C;AAC9C,MAAM,WAAW,4BAA6B,SAAQ,aAAa;IACjE,+CAA+C;IAC/C,IAAI,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;CAC5B;AAED,+CAA+C;AAC/C,MAAM,WAAW,2BAA4B,SAAQ,YAAY;IAC/D,+CAA+C;IAC/C,IAAI,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC3B,0EAA0E;IAC1E,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,gDAAgD;AAChD,MAAM,MAAM,mBAAmB,GAAG,CAChC,KAAK,EAAE,QAAQ,EAAE,EACjB,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,KACjE,IAAI,CAAC;AAIV,uDAAuD;AACvD,MAAM,WAAW,iCAAiC;IAChD;;;OAGG;IACH,iBAAiB,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACnD,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,kCAAkC,KAAK,IAAI,CAAC;IAC3D,uFAAuF;IACvF,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,gCAAgC,KAAK,IAAI,CAAC;IAC3D,kEAAkE;IAClE,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,kCAAkC,KAAK,IAAI,CAAC;IAC7D,6EAA6E;IAC7E,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,+BAA+B,KAAK,IAAI,CAAC;IACzD,gFAAgF;IAChF,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,+BAA+B,KAAK,IAAI,CAAC;IACtD,+EAA+E;IAC/E,oBAAoB,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC;CAC9E;AAED,4CAA4C;AAC5C,MAAM,WAAW,4BAA4B;IAC3C,qEAAqE;IACrE,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,6BAA6B,KAAK,IAAI,CAAC;IACzD,4EAA4E;IAC5E,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,gCAAgC,KAAK,IAAI,CAAC;IAC/D,oEAAoE;IACpE,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,4BAA4B,KAAK,IAAI,CAAC;IACvD,4EAA4E;IAC5E,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,4BAA4B,KAAK,IAAI,CAAC;IACnD,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,CACjB,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,SAAS,EAChB,iBAAiB,EAAE,aAAa,EAAE,KAC/B,aAAa,CAAC;CACpB;AAED,gDAAgD;AAChD,MAAM,WAAW,wBACf,SAAQ,iCAAiC,EACvC,4BAA4B;CAAG;AAEnC,uCAAuC;AACvC,MAAM,WAAW,wBAAwB,CAAC,CAAC,GAAG,MAAM;IAClD,+DAA+D;IAC/D,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,6BAA6B,KAAK,IAAI,CAAC;IACzD,qDAAqD;IACrD,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,4BAA4B,KAAK,IAAI,CAAC;IACvD,2DAA2D;IAC3D,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,2BAA2B,KAAK,IAAI,CAAC;IACrD,uDAAuD;IACvD,QAAQ,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;IACjE,wEAAwE;IACxE,OAAO,CAAC,EAAE;QAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAA;KAAE,CAAC;IAClD,yDAAyD;IACzD,wBAAwB,CAAC,EAAE,MAAM,aAAa,EAAE,CAAC;CAClD"}

package/src/dnd/types.ts

@@ -0,0 +1,317 @@
+/**
+ * Drag and Drop types for solid-stately.
+ *
+ * Core types for drag and drop operations, matching React Aria's DnD API.
+ */
+
+/** The type of drop operation to perform. */
+export type DropOperation = 'copy' | 'link' | 'move' | 'cancel';
+
+/** Drag item data as key-value pairs where keys are MIME types or custom types. */
+export interface DragItem {
+  [type: string]: string;
+}
+
+/** Base event for drag/drop operations with coordinates. */
+export interface DragDropEvent {
+  /** The x coordinate of the event, relative to the target element. */
+  x: number;
+  /** The y coordinate of the event, relative to the target element. */
+  y: number;
+}
+
+/** Event fired when a drag operation starts. */
+export interface DragStartEvent extends DragDropEvent {
+  /** The event type. */
+  type: 'dragstart';
+}
+
+/** Event fired as a drag moves. */
+export interface DragMoveEvent extends DragDropEvent {
+  /** The event type. */
+  type: 'dragmove';
+}
+
+/** Event fired when a drag operation ends. */
+export interface DragEndEvent extends DragDropEvent {
+  /** The event type. */
+  type: 'dragend';
+  /** The drop operation that occurred. */
+  dropOperation: DropOperation;
+}
+
+/** Event fired when a drag enters a drop target. */
+export interface DropEnterEvent extends DragDropEvent {
+  /** The event type. */
+  type: 'dropenter';
+}
+
+/** Event fired as a drag moves within a drop target. */
+export interface DropMoveEvent extends DragDropEvent {
+  /** The event type. */
+  type: 'dropmove';
+}
+
+/** Event fired when a drag is held over a drop target. */
+export interface DropActivateEvent extends DragDropEvent {
+  /** The event type. */
+  type: 'dropactivate';
+}
+
+/** Event fired when a drag exits a drop target. */
+export interface DropExitEvent extends DragDropEvent {
+  /** The event type. */
+  type: 'dropexit';
+}
+
+/** A text item in a drop operation. */
+export interface TextDropItem {
+  /** The item kind. */
+  kind: 'text';
+  /** The drag types available for this item. */
+  types: Set<string>;
+  /** Returns the data for the given type as a string. */
+  getText(type: string): Promise<string>;
+}
+
+/** A file item in a drop operation. */
+export interface FileDropItem {
+  /** The item kind. */
+  kind: 'file';
+  /** The file type (usually a mime type). */
+  type: string;
+  /** The file name. */
+  name: string;
+  /** Returns the contents of the file as a blob. */
+  getFile(): Promise<File>;
+  /** Returns the contents of the file as a string. */
+  getText(): Promise<string>;
+}
+
+/** A directory item in a drop operation. */
+export interface DirectoryDropItem {
+  /** The item kind. */
+  kind: 'directory';
+  /** The directory name. */
+  name: string;
+  /** Returns the entries contained within the directory. */
+  getEntries(): AsyncIterable<FileDropItem | DirectoryDropItem>;
+}
+
+/** Union of all drop item types. */
+export type DropItem = TextDropItem | FileDropItem | DirectoryDropItem;
+
+/** Event fired when items are dropped. */
+export interface DropEvent extends DragDropEvent {
+  /** The event type. */
+  type: 'drop';
+  /** The drop operation that should occur. */
+  dropOperation: DropOperation;
+  /** The dropped items. */
+  items: DropItem[];
+}
+
+/** Position relative to an item for drop operations. */
+export type DropPosition = 'on' | 'before' | 'after';
+
+/** Drop target representing the root of a collection. */
+export interface RootDropTarget {
+  /** The drop target type. */
+  type: 'root';
+}
+
+/** Drop target representing an item in a collection. */
+export interface ItemDropTarget {
+  /** The drop target type. */
+  type: 'item';
+  /** The item key. */
+  key: string | number;
+  /** The drop position relative to the item. */
+  dropPosition: DropPosition;
+}
+
+/** Union of drop target types. */
+export type DropTarget = RootDropTarget | ItemDropTarget;
+
+// Collection drag/drop events
+
+/** Event fired when a drag enters a droppable collection. */
+export interface DroppableCollectionEnterEvent extends DropEnterEvent {
+  /** The drop target. */
+  target: DropTarget;
+}
+
+/** Event fired as a drag moves within a droppable collection. */
+export interface DroppableCollectionMoveEvent extends DropMoveEvent {
+  /** The drop target. */
+  target: DropTarget;
+}
+
+/** Event fired when a drag is held over a droppable collection item. */
+export interface DroppableCollectionActivateEvent extends DropActivateEvent {
+  /** The drop target. */
+  target: DropTarget;
+}
+
+/** Event fired when a drag exits a droppable collection. */
+export interface DroppableCollectionExitEvent extends DropExitEvent {
+  /** The drop target. */
+  target: DropTarget;
+}
+
+/** Event fired when items are dropped on a droppable collection. */
+export interface DroppableCollectionDropEvent extends DropEvent {
+  /** The drop target. */
+  target: DropTarget;
+}
+
+/** Event for inserting items between existing collection items. */
+export interface DroppableCollectionInsertDropEvent {
+  /** The dropped items. */
+  items: DropItem[];
+  /** The drop operation that should occur. */
+  dropOperation: DropOperation;
+  /** The drop target. */
+  target: ItemDropTarget;
+}
+
+/** Event for dropping on the root of a collection. */
+export interface DroppableCollectionRootDropEvent {
+  /** The dropped items. */
+  items: DropItem[];
+  /** The drop operation that should occur. */
+  dropOperation: DropOperation;
+}
+
+/** Event for dropping on a specific item. */
+export interface DroppableCollectionOnItemDropEvent {
+  /** The dropped items. */
+  items: DropItem[];
+  /** The drop operation that should occur. */
+  dropOperation: DropOperation;
+  /** Whether the drag originated within the same collection as the drop. */
+  isInternal: boolean;
+  /** The drop target. */
+  target: ItemDropTarget;
+}
+
+/** Event for reordering items within a collection. */
+export interface DroppableCollectionReorderEvent {
+  /** The keys of the items that were reordered. */
+  keys: Set<string | number>;
+  /** The drop operation that should occur. */
+  dropOperation: DropOperation;
+  /** The drop target. */
+  target: ItemDropTarget;
+}
+
+/** Interface for checking drag types. */
+export interface DragTypes {
+  /** Returns whether the drag contains data of the given type. */
+  has(type: string | symbol): boolean;
+}
+
+/** Delegate for determining drop targets within a collection. */
+export interface DropTargetDelegate {
+  /**
+   * Returns a drop target within a collection for the given coordinates.
+   * @param x - X coordinate relative to the collection container
+   * @param y - Y coordinate relative to the collection container
+   * @param isValidDropTarget - Function to check if a target is valid
+   */
+  getDropTargetFromPoint(
+    x: number,
+    y: number,
+    isValidDropTarget: (target: DropTarget) => boolean
+  ): DropTarget | null;
+}
+
+// Draggable collection types
+
+/** Event fired when a collection drag starts. */
+export interface DraggableCollectionStartEvent extends DragStartEvent {
+  /** The keys of the items that were dragged. */
+  keys: Set<string | number>;
+}
+
+/** Event fired as a collection drag moves. */
+export interface DraggableCollectionMoveEvent extends DragMoveEvent {
+  /** The keys of the items that were dragged. */
+  keys: Set<string | number>;
+}
+
+/** Event fired when a collection drag ends. */
+export interface DraggableCollectionEndEvent extends DragEndEvent {
+  /** The keys of the items that were dragged. */
+  keys: Set<string | number>;
+  /** Whether the drop ended within the same collection as it originated. */
+  isInternal: boolean;
+}
+
+/** Function to render a custom drag preview. */
+export type DragPreviewRenderer = (
+  items: DragItem[],
+  callback: (node: HTMLElement | null, x?: number, y?: number) => void
+) => void;
+
+// Props interfaces
+
+/** Props for droppable collection utility handlers. */
+export interface DroppableCollectionUtilityOptions {
+  /**
+   * The drag types that the droppable collection accepts.
+   * @default 'all'
+   */
+  acceptedDragTypes?: 'all' | Array<string | symbol>;
+  /** Handler that is called when external items are dropped "between" items. */
+  onInsert?: (e: DroppableCollectionInsertDropEvent) => void;
+  /** Handler that is called when external items are dropped on the collection's root. */
+  onRootDrop?: (e: DroppableCollectionRootDropEvent) => void;
+  /** Handler that is called when items are dropped "on" an item. */
+  onItemDrop?: (e: DroppableCollectionOnItemDropEvent) => void;
+  /** Handler that is called when items are reordered within the collection. */
+  onReorder?: (e: DroppableCollectionReorderEvent) => void;
+  /** Handler that is called when items are moved within the source collection. */
+  onMove?: (e: DroppableCollectionReorderEvent) => void;
+  /** A function returning whether a given target is a valid "on" drop target. */
+  shouldAcceptItemDrop?: (target: ItemDropTarget, types: DragTypes) => boolean;
+}
+
+/** Base props for droppable collections. */
+export interface DroppableCollectionBaseProps {
+  /** Handler that is called when a valid drag enters a drop target. */
+  onDropEnter?: (e: DroppableCollectionEnterEvent) => void;
+  /** Handler that is called after a valid drag is held over a drop target. */
+  onDropActivate?: (e: DroppableCollectionActivateEvent) => void;
+  /** Handler that is called when a valid drag exits a drop target. */
+  onDropExit?: (e: DroppableCollectionExitEvent) => void;
+  /** Handler that is called when a valid drag is dropped on a drop target. */
+  onDrop?: (e: DroppableCollectionDropEvent) => void;
+  /** A function returning the drop operation to be performed. */
+  getDropOperation?: (
+    target: DropTarget,
+    types: DragTypes,
+    allowedOperations: DropOperation[]
+  ) => DropOperation;
+}
+
+/** Combined props for droppable collections. */
+export interface DroppableCollectionProps
+  extends DroppableCollectionUtilityOptions,
+    DroppableCollectionBaseProps {}
+
+/** Props for draggable collections. */
+export interface DraggableCollectionProps<T = object> {
+  /** Handler that is called when a drag operation is started. */
+  onDragStart?: (e: DraggableCollectionStartEvent) => void;
+  /** Handler that is called when the drag is moved. */
+  onDragMove?: (e: DraggableCollectionMoveEvent) => void;
+  /** Handler that is called when the drag operation ends. */
+  onDragEnd?: (e: DraggableCollectionEndEvent) => void;
+  /** A function that returns the items being dragged. */
+  getItems: (keys: Set<string | number>, items: T[]) => DragItem[];
+  /** The ref of the element that will be rendered as the drag preview. */
+  preview?: { current: DragPreviewRenderer | null };
+  /** Function that returns the allowed drop operations. */
+  getAllowedDropOperations?: () => DropOperation[];
+}