@mapples/dnd 1.1.2 → 1.2.1

package/dist/monitor/Monitor.d.ts

@@ -1,6 +1,6 @@
 import { LayoutRectangle } from 'react-native';
 import { Subject } from 'rxjs';
-import { DnDEvent, DragCoords, DragElementTarget, DragItem, DropTarget, DropTargetConfig, MonitorConfig } from '../types';
+import { DnDEvent, DragCoords, DragElementTarget, DragItem, DropTarget, DropTargetConfig, FrameEntry, MonitorConfig } from '../types';
 /**
  * Core monitor class that manages drag and drop operations.
  * This class tracks drag elements, drop targets, handles hit detection, and emits events.
@@ -22,8 +22,25 @@ export declare class Monitor<DragData extends object, DropData extends object =
     private dragElements;
     /** Tree structure of registered drop elements */
     private dropElementsTree;
+    /**
+     * Flat index of every registered drop element and its parent id. Kept in
+     * lockstep with the tree by register/unregister/update — the only writers —
+     * so id lookups and frame-key resolution are O(1)/O(depth) instead of a
+     * full recursive tree walk per layout event.
+     */
+    private dropNodesById;
+    private dropParentById;
+    /** Pending coalesced force-layout broadcast (one per animation frame). */
+    private forceLayoutUpdatePending;
+    /** Registered frame coordinate spaces by key */
+    private frames;
     /** ID of the currently active drag target */
     private dragTargetId;
+    /** Active move-drag source (an existing canvas element being moved) */
+    private moveSource;
+    /** Pointer coords at drag start / most recent drag tick (drop space) */
+    private dragStartCoords;
+    private lastDragCoords;
     /** Currently active drop target */
     private dropTarget;
     /** Index position within the current drop target */
@@ -35,6 +52,26 @@ export declare class Monitor<DragData extends object, DropData extends object =
      * @param config - Configuration options for the monitor
      */
     constructor(config: MonitorConfig);
+    /**
+     * Registers (or replaces) a frame coordinate space. Drop elements whose
+     * config carries the same `frameKey` are stored and hit-tested in
+     * coordinates relative to this frame's origin.
+     */
+    registerFrame(frameKey: string, entry: FrameEntry): void;
+    /**
+     * Moves a frame's world origin. O(1): no element re-measures needed since
+     * frame content layouts are origin-relative.
+     */
+    updateFrameOrigin(frameKey: string, origin: DragCoords): void;
+    /** Removes a frame coordinate space. */
+    unregisterFrame(frameKey: string): void;
+    /** Gets a registered frame space by key. */
+    getFrame(frameKey: string): FrameEntry | undefined;
+    /**
+     * Converts world coordinates into a frame's local space.
+     * Falls through unchanged when the frame isn't registered.
+     */
+    toFrameLocal(coords: DragCoords, frameKey: string): DragCoords;
     /**
      * Gets the ID of the currently active drag target.
      * @returns The drag target ID or null if no drag is active
@@ -47,7 +84,10 @@ export declare class Monitor<DragData extends object, DropData extends object =
     private setDragTargetId;
     /**
      * Triggers a force layout update event.
-     * This causes all registered elements to recalculate their layout information.
+     * This causes all registered elements to recalculate their layout
+     * information. Every registered element answers with a forced layout read,
+     * so calls are coalesced to at most one broadcast per animation frame —
+     * scroll handlers and settle timers may call this at input rate.
      */
     triggerForceLayoutUpdate(): void;
     /**
@@ -103,35 +143,90 @@ export declare class Monitor<DragData extends object, DropData extends object =
     updateDragElementLayout(id: number, layout: LayoutRectangle): void;
     /**
      * Handles the start of a drag operation.
-     * @param dragCoords - The coordinates where the drag started
+     * @param dragCoords - Coordinates in drop-target space (world space when a
+     * pointer transform is installed), or `null` when the press began outside
+     * that space entirely. A palette press is exactly that case — the palette
+     * lives beside the canvas, not on it — so a null here must never abort the
+     * drag; it only rules out grabbing an existing element to move.
+     * @param windowCoords - Raw window coordinates for drag-*source* hit
+     * testing (palette items live outside any frame); defaults to `dragCoords`
      */
-    onDragStart(dragCoords: DragCoords): void;
+    onDragStart(dragCoords: DragCoords | null, windowCoords?: DragCoords): void;
     /**
      * Handles drag movement during a drag operation.
      * @param dragCoords - The current coordinates of the drag
      */
     onDrag(dragCoords: DragCoords): void;
+    /**
+     * The pointer left the drop coordinate space entirely — reported by the
+     * host when its `pointerTransform` cannot place the pointer (e.g. it moved
+     * off the canvas viewport onto surrounding chrome). Equivalent to hovering
+     * empty space: the pending drop clears, so a release here cancels.
+     */
+    onDragOutside(): void;
+    /**
+     * Hit-tests a point in drop space with no drag registered. Drags that start
+     * outside the app — files dragged in from the OS — never register a drag
+     * element, so they cannot go through {@link onDrag}; this gives them the
+     * same target and insert-index resolution the in-app drag path uses.
+     * @param dropCoords - The coordinates to hit-test, in drop space
+     */
+    hitTest(dropCoords: DragCoords): {
+        dropTarget: DropTarget<DropData> | null;
+        dropTargetIndex: number | null;
+    };
+    /**
+     * Publishes an external drag's current position, so the drop chrome
+     * (hover highlight, insert line) tracks a file dragged in from the OS
+     * exactly as it tracks an in-app drag. Pass `null` coordinates while the
+     * pointer sits outside the drop space — that clears the pending drop the
+     * same way hovering off a droppable area does mid-drag.
+     * @param dropCoords - The pointer position in drop space, or null
+     */
+    onExternalDrag(dropCoords: DragCoords | null): void;
+    /**
+     * Ends an external drag — the files were dropped, or the drag left the
+     * window. Always `cancelled`: whatever the drop produces is inserted by
+     * the host once its uploads finish, never by the DnD path.
+     */
+    onExternalDragEnd(): void;
     /**
      * Handles selection/tap events.
      * @param dragCoords - The coordinates where the selection occurred
      */
     onSelect(dragCoords: DragCoords): void;
     /**
-     * Checks if the given coordinates are inside the first root element.
-     * @param dragCoords - The coordinates to check
-     * @returns True if inside the first root element
+     * Checks if the given coordinates are inside any root drop element,
+     * converting into frame-local space for frame-rooted elements.
      * @private
      */
-    private isInsideFirstRootElement;
+    private isInsideAnyRootElement;
+    /**
+     * Looks up a registered drop target (with its current layout and frame
+     * key) by matching data properties — e.g. `{ id: componentId }`.
+     *
+     * @param frameKey - Restrict the search to one frame's subtree. Required
+     * whenever ids are only unique per frame (every page root shares the id
+     * `root`, so an unscoped lookup can return another frame's element).
+     */
+    getDropTargetByData(dataQuery: Partial<DropData>, frameKey?: string): DropTarget<DropData> | null;
     /**
      * Handles external selection by data query.
      * @param dataQuery - Partial data to match against drop targets
      */
     onExternalSelect(dataQuery: Partial<DropData>): void;
     /**
-     * Handles the end of a drag operation.
+     * Handles the end of a drag operation. Releasing the pointer outside every
+     * droppable area cancels the drag: `DragEnd` still fires — overlays, the
+     * drag ghost and `isDragging` all reset on it — but carries a null
+     * `dropTarget` and `cancelled: true`, so nothing is inserted or moved.
      */
     onDragEnd(): void;
+    /**
+     * Clears every piece of per-drag state.
+     * @private
+     */
+    private resetDragState;
     /**
      * Registers a new drop element with the monitor.
      * @param layout - The layout rectangle of the drop element
@@ -155,13 +250,11 @@ export declare class Monitor<DragData extends object, DropData extends object =
      */
     updateDropElement(id: number, layout: LayoutRectangle, config?: DropTargetConfig, data?: DropData): void;
     /**
-     * Finds a drop target by ID in the tree structure.
-     * @param id - The ID to search for
-     * @param tree - The tree to search in
-     * @returns The drop item or null if not found
+     * Resolves the frame space an element (or any of its ancestors) belongs to
+     * by walking the parent chain — O(depth).
      * @private
      */
-    private findDropTarget;
+    private findFrameKeyFor;
     /**
      * Finds a drop target by matching data properties.
      * @param dataQuery - Partial data to match against
@@ -178,14 +271,6 @@ export declare class Monitor<DragData extends object, DropData extends object =
      * @private
      */
     private partialMatch;
-    /**
-     * Finds the parent of a drop target by ID.
-     * @param id - The ID of the child drop target
-     * @param tree - The tree to search in
-     * @returns The parent drop item or null if not found
-     * @private
-     */
-    private findDropTargetParent;
     /**
      * Gets all drop targets that contain the given coordinates.
      * @param dropCoords - The coordinates to check

package/dist/monitor/Monitor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Monitor.d.ts","sourceRoot":"","sources":["../../src/monitor/Monitor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Monitor.d.ts","sourceRoot":"","sources":["../../src/monitor/Monitor.ts"],"names":[],"mappings":"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"}