@inkami/blx 0.17.3

package/dist/drag-handle/drag-handle.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Return the vertical center of a block's first line for gutter widget alignment.
+ * Non-text blocks (image, youtube, hr) have contenteditable="false" on their
+ * direct child — for those we use the editor's computed line-height so the
+ * widgets sit near the top, matching paragraph positioning.
+ */
+export declare function firstLineCenterY(blockEl: HTMLElement, editorRoot: HTMLElement): number;
+export declare class DragHandle {
+    private editorRoot;
+    private gutterEl;
+    private handle;
+    private onMoveBlock;
+    private onMoveBlocks;
+    private getSelectedBlockIds;
+    private onDragStart;
+    private onDragEnd;
+    private onDoubleTap;
+    private isBlockDraggable;
+    /** The block element the handle is currently positioned next to */
+    private hoveredBlockEl;
+    private _menuActive;
+    /** Drag state — single or multi block */
+    private dragBlockIds;
+    private dragFromIndices;
+    private ghost;
+    private ghostOffsetY;
+    private currentDropSlot;
+    private sourceHeight;
+    /** Original midpoints cached at drag start (immune to CSS transition drift) */
+    private cachedMidpoints;
+    /** Bound handlers for document-level listeners (so we can remove them) */
+    private boundDocMouseMove;
+    private boundDocMouseUp;
+    /** Bound handlers for touch-based document-level listeners */
+    private boundDocTouchMove;
+    private boundDocTouchEnd;
+    /** Touch drag state: timer for long-press detection */
+    private longPressTimer;
+    private longPressTriggered;
+    private touchStartY;
+    private touchStartX;
+    /** Delay in ms before a touch becomes a drag (long-press) */
+    private static LONG_PRESS_DELAY;
+    /** Max movement in px during long-press before it's cancelled */
+    private static LONG_PRESS_TOLERANCE;
+    /** Max interval in ms between two taps to count as double-tap */
+    private static DOUBLE_TAP_DELAY;
+    /** Timestamp of the last quick tap on the handle (for double-tap detection) */
+    private lastHandleTapTime;
+    /** Pending mouse drag: mousedown recorded but drag not started until mousemove */
+    private pendingMouseDrag;
+    private mouseDownX;
+    private mouseDownY;
+    constructor(editorRoot: HTMLElement, gutterEl: HTMLElement, onMoveBlock: (blockId: string, toIndex: number) => void, options?: {
+        getSelectedBlockIds?: () => string[] | null;
+        onMoveBlocks?: (blockIds: string[], toIndex: number) => void;
+        onDragStart?: () => void;
+        onDragEnd?: () => void;
+        onDoubleTap?: (blockId: string) => void;
+        isBlockDraggable?: (blockId: string) => boolean;
+    });
+    /** Hide the handle and clear hover state (e.g. when user starts typing) */
+    hide(): void;
+    /** Called by the editor when the block action menu opens — suppresses the drag handle */
+    notifyMenuOpen(): void;
+    /** Called by the editor when the block action menu closes */
+    notifyMenuClosed(): void;
+    destroy(): void;
+    private attachListeners;
+    private handleMouseMove;
+    private showHandle;
+    private hideHandle;
+    private findBlockAtY;
+    private handleMouseLeave;
+    /** Hide handle when mouse leaves it away from the editor */
+    private handleHandleLeave;
+    private positionHandle;
+    private handleDblClick;
+    private handleEditorTouchStart;
+    private handleHandleTouchStart;
+    private handleDocTouchMoveDuringLongPress;
+    private handleDocTouchEndDuringLongPress;
+    private cancelLongPress;
+    private cleanupLongPressListeners;
+    private handleMouseDown;
+    private handleDocMouseMove;
+    private handleDocMouseUp;
+    /**
+     * Begin a drag operation from the given screen coordinates.
+     * Called by both mousedown and touch long-press.
+     */
+    private startDrag;
+    /** Update drag position from screen coordinates. */
+    private handleDragMove;
+    /** Finalize the drag and apply the move. */
+    private handleDragEnd;
+    /**
+     * Compute drop slot (0..N) from ghost center Y using cached midpoints.
+     * Hysteresis biases midpoints by THRESHOLD relative to the current slot
+     * so the ghost must cross a midpoint by extra pixels before changing,
+     * preventing jitter near boundaries.
+     */
+    private computeDropSlot;
+    private cleanupDrag;
+}

package/dist/drag-handle/index.d.ts

@@ -0,0 +1 @@
+export { DragHandle } from "./drag-handle";