@splicetree/core 3.0.1 → 3.1.0

package/dist/index.d.ts

@@ -62,6 +62,7 @@ interface SpliceTreeNode<T = SpliceTreeData> {
    * @param expand 不传表示切换；true/false 表示显式设置
    */
   toggleExpand: Fn<void, boolean | undefined>;
+  updateOriginal: (patch: Partial<T>) => void;
 }
 /**
  * 事件负载映射（可被插件扩展）
@@ -216,6 +217,17 @@ interface SpliceTreeInstance<T = SpliceTreeData> {
    * @param beforeId 插入到指定兄弟节点之前（不传表示末尾）
    */
   moveNode: (id: string, newParentId: string | undefined, beforeId?: string) => void;
+  /**
+   * 移除指定节点或节点列表（包含其子孙）
+   * @param id 单个 id 或 id 数组
+   */
+  remove: (id: string | string[]) => void;
+  /**
+   * 更新节点原始数据（非结构字段）
+   * - 若包含父级字段变更，将转为 moveNode 处理
+   * - 不支持直接修改主键字段
+   */
+  updateOriginal: (id: string, patch: Partial<T>) => boolean;
   syncData: (next: T[]) => void;
 }
 /**
@@ -237,6 +249,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";
@@ -407,7 +438,10 @@ function createSpliceTree(data, options = {}) {
 				parentCache,
 				childrenCache,
 				expandedKeys,
-				notify: emitVisibility
+				notify: () => {
+					applyNodeExtensions();
+					emitVisibility();
+				}
 			}, parentId, children);
 		},
 		moveNode(id, newParentId, beforeId) {
@@ -422,6 +456,31 @@ function createSpliceTree(data, options = {}) {
 				notify: emitVisibility
 			}, id, newParentId, beforeId);
 		},
+		remove(ids) {
+			removeNodes({
+				map,
+				tree,
+				roots,
+				keyField,
+				parentCache,
+				childrenCache,
+				expandedKeys,
+				notify: emitVisibility
+			}, ids);
+		},
+		updateOriginal(id, patch) {
+			const node = map.get(id);
+			if (!node) return false;
+			if (Object.prototype.hasOwnProperty.call(patch, keyField)) return false;
+			if (Object.prototype.hasOwnProperty.call(patch, parentField)) {
+				const nextParent = patch[parentField];
+				if (nextParent !== node.getParent()?.id) tree.moveNode(id, nextParent);
+				delete patch[parentField];
+			}
+			Object.assign(node.original, patch);
+			emitVisibility();
+			return true;
+		},
 		syncData(next) {
 			tree.data = next;
 			const built = buildTree(next, keyField, parentField, expandedKeys);
@@ -436,13 +495,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);
@@ -457,6 +524,9 @@ function createSpliceTree(data, options = {}) {
 				else if (expand) tree.expand(node.id);
 				else tree.collapse(node.id);
 			};
+			node.updateOriginal = (patch) => {
+				tree.updateOriginal(node.id, patch);
+			};
 		}
 	}
 	applyNodeExtensions();

package/package.json

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