@splicetree/core 3.0.1 → 3.0.2

package/dist/index.d.ts

@@ -216,6 +216,11 @@ interface SpliceTreeInstance<T = SpliceTreeData> {
    * @param beforeId 插入到指定兄弟节点之前（不传表示末尾）
    */
   moveNode: (id: string, newParentId: string | undefined, beforeId?: string) => void;
+  /**
+   * 移除指定节点或节点列表（包含其子孙）
+   * @param id 单个 id 或 id 数组
+   */
+  remove: (id: string | string[]) => void;
   syncData: (next: T[]) => void;
 }
 /**
@@ -237,6 +242,13 @@ interface SpliceTreePluginContext<T = SpliceTreeData> {
    * 事件总线
    */
   events: SpliceTreeEvents;
+  /**
+   * 插件可访问的内部缓存
+   */
+  roots: SpliceTreeNode<T>[];
+  map: Map<string, SpliceTreeNode<T>>;
+  parentCache: Map<string, SpliceTreeNode<T> | undefined>;
+  childrenCache: Map<string, SpliceTreeNode<T>[]>;
 }
 /**
  * 插件定义接口

package/dist/index.js

@@ -328,6 +328,36 @@ function moveNode(ctx, id, newParentId, beforeId) {
 	setLevelRecursively(node, ctx.childrenCache, node.level);
 	ctx.notify();
 }
+function removeNodes(ctx, ids) {
+	const list = Array.isArray(ids) ? ids : [ids];
+	const toRemove = /* @__PURE__ */ new Set();
+	const collect = (id) => {
+		if (toRemove.has(id)) return;
+		toRemove.add(id);
+		const children = ctx.childrenCache.get(id) ?? [];
+		for (const c of children) collect(c.id);
+	};
+	for (const id of list) if (ctx.map.has(id)) collect(id);
+	for (const id of toRemove) {
+		const parent = ctx.parentCache.get(id);
+		if (parent) {
+			const arr = ctx.childrenCache.get(parent.id) ?? [];
+			const idx = arr.findIndex((n) => n.id === id);
+			if (idx >= 0) arr.splice(idx, 1);
+		} else {
+			const idx = ctx.roots.findIndex((n) => n.id === id);
+			if (idx >= 0) ctx.roots.splice(idx, 1);
+		}
+	}
+	for (const id of toRemove) {
+		ctx.childrenCache.delete(id);
+		ctx.parentCache.delete(id);
+		ctx.map.delete(id);
+		ctx.expandedKeys.delete(id);
+	}
+	for (const r of ctx.roots) setLevelRecursively(r, ctx.childrenCache, 0);
+	ctx.notify();
+}
 
 //#endregion
 //#region src/use.ts
@@ -338,6 +368,7 @@ function moveNode(ctx, id, newParentId, beforeId) {
 * - 提供插件扩展点（setup/extendNode）
 */
 function createSpliceTree(data, options = {}) {
+	let pluginCtx;
 	const cfg = options.configuration ?? {};
 	const keyField = cfg.keyField ?? "id";
 	const parentField = cfg.parentField ?? "parent";
@@ -422,6 +453,18 @@ function createSpliceTree(data, options = {}) {
 				notify: emitVisibility
 			}, id, newParentId, beforeId);
 		},
+		remove(ids) {
+			removeNodes({
+				map,
+				tree,
+				roots,
+				keyField,
+				parentCache,
+				childrenCache,
+				expandedKeys,
+				notify: emitVisibility
+			}, ids);
+		},
 		syncData(next) {
 			tree.data = next;
 			const built = buildTree(next, keyField, parentField, expandedKeys);
@@ -436,13 +479,21 @@ function createSpliceTree(data, options = {}) {
 			});
 			for (const id of toDelete) expandedKeys.delete(id);
 			applyNodeExtensions();
+			pluginCtx.roots = roots;
+			pluginCtx.map = map;
+			pluginCtx.parentCache = parentCache;
+			pluginCtx.childrenCache = childrenCache;
 			emitVisibility();
 		}
 	};
-	const pluginCtx = {
+	pluginCtx = {
 		tree,
 		options,
-		events
+		events,
+		roots,
+		map,
+		parentCache,
+		childrenCache
 	};
 	options?.plugins?.forEach((plugin) => {
 		const api = plugin.setup?.(pluginCtx);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@splicetree/core",
   "type": "module",
-  "version": "3.0.1",
+  "version": "3.0.2",
   "author": {
     "email": "michael.cocova@gmail.com",
     "name": "Michael Cocova"