@sepveneto/dnde 0.7.5 → 0.8.0

package/dist/composables/dragCore.d.ts

@@ -0,0 +1,69 @@
+import type { Node } from '@sepveneto/dnde-core/class';
+/** 拖拽逻辑作用的目标列表 */
+export interface DragTarget {
+    /** 当前列表（响应式数组） */
+    list: Node[];
+    /** 列表所属的父节点，根列表传 rootNode */
+    parent: Node;
+    /** 用新数组替换当前列表 */
+    setList: (list: Node[]) => void;
+}
+/** 拖拽逻辑需要的外部能力，由编辑器 store 提供 */
+export interface DragHost {
+    /** 跨容器拖动被撤销时，把节点还原回指定容器的指定位置 */
+    restoreToContainer: (containerId: string, index: number, node: Node) => void;
+    /** 把节点登记到目标父节点下 */
+    addNode: (node: Node, parent: Node) => void;
+}
+/** 只取逻辑用到的字段，便于在测试中构造 */
+export interface DragAddEvent {
+    newIndex: number;
+    newDraggableIndex: number;
+    oldIndex: number;
+    from: {
+        dataset: {
+            id?: string;
+        };
+    };
+    to: {
+        dataset: {
+            id?: string;
+        };
+    };
+}
+/**
+ * 找出列表中第一处重复出现的 wid。
+ *
+ * vuedraggable 在同级跨列表拖动时，会在目标列表里留下源列表的重复项，
+ * 靠这个函数定位需要清理的节点。
+ */
+export declare function findDuplicatedWid(list: Node[]): string | undefined;
+/**
+ * 该位置是否紧邻 fixed 节点（header 之后 / footer 之前都不允许插入）。
+ *
+ * 注意：入参是 `Widget.isFixed` 归一化之后的值，即 `meta.fixed: true` 会变成 `'header'`。
+ */
+export declare function isFixedBoundary(list: Node[], index: number): boolean;
+/**
+ * 计算跨列表拖动后应从后一个数组中移除的重复项下标。
+ *
+ * `originIndex` 是被拖动节点在原数组中的位置，用来判断它在新数组里是上移还是下移。
+ * 返回 -1 表示不删除（没有重复，或相邻是 fixed 边界需要保留）。
+ */
+export declare function resolveDuplicateRemovalIndex(current: Node[], next: Node[], wid: string, originIndex: number): number;
+/**
+ * 处理一次「放入」：
+ * - 落点紧邻 fixed 节点时撤销这次插入；
+ * - 跨容器拖动被撤销时，把节点还原回原容器；
+ * - 否则把节点登记到目标父节点下。
+ */
+export declare function handleNodeAdd(target: DragTarget, evt: DragAddEvent, host: DragHost): void;
+/**
+ * 处理列表更新：
+ * - 长度没有增加（同级重排）→ 直接整体替换；
+ * - 长度增加（跨列表拖动）→ 清理 vuedraggable 留下的重复项，
+ *   若重复项紧邻 fixed 边界则保留。
+ *
+ * `defer` 用于把清理后的写入推迟到下一个 tick（与 vuedraggable 的更新时机对齐）。
+ */
+export declare function handleNodeInput(target: DragTarget, val: Node[], defer: (fn: () => void) => void): void;

package/dist/composables/useNodeListDrag.d.ts

@@ -0,0 +1,15 @@
+import type { DraggableEvt } from '@/type';
+import type { Node } from '@sepveneto/dnde-core/class';
+import type { DragTarget } from './dragCore';
+export type NodeListDragTarget = DragTarget;
+/**
+ * 编辑区与大纲面板中所有可拖拽列表共用的拖拽处理。
+ *
+ * 逻辑本体在 `./dragCore`（不依赖 store / vue，便于单测），
+ * 这里只负责取 store 并接线。
+ */
+export declare function useNodeListDrag(target: NodeListDragTarget): {
+    onStart: (evt: DraggableEvt) => void;
+    onAdd: (evt: DraggableEvt) => void;
+    onInput: (val: Node[]) => void;
+};