@splicetree/core 0.2.0 → 1.0.0

package/dist/index.d.ts

@@ -5,6 +5,10 @@
  * - 若传入 `D`，表示函数可选择性接收该参数类型
  */
 type Fn<T, D = undefined> = [D] extends [undefined] ? () => T : (data?: D) => T;
+/** 可能是数组的类型 */
+type MaybeArray<T> = T | T[];
+/** 可能是函数的类型 */
+type MaybeFn<T, Args extends any[] = []> = T | ((...args: Args) => T);
 /**
  * 输入数据的通用结构
  * - 表示原始树数据的任意键值对对象
@@ -121,6 +125,7 @@ interface SpliceTreeConfiguration {
    * 设为 'deepest' 表示默认展开所有层级
    */
   defaultExpandedLevel?: number | 'deepest';
+  autoExpandParent?: boolean;
 }
 interface UseSpliceTreeOptions<T = SpliceTreeData> {
   /**
@@ -279,4 +284,4 @@ type CreateSpliceTree = <T = SpliceTreeData>(data: T[], options?: UseSpliceTreeO
  */
 declare function createSpliceTree<T extends SpliceTreeData = SpliceTreeData>(data: T[], options?: UseSpliceTreeOptions<T>): SpliceTreeInstance<T>;
 //#endregion
-export { CreateSpliceTree, Fn, SpliceTreeConfiguration, SpliceTreeData, SpliceTreeEventName, SpliceTreeEventPayload, SpliceTreeEventPayloadMap, SpliceTreeEvents, SpliceTreeInstance, SpliceTreeNode, SpliceTreePlugin, SpliceTreePluginContext, UseSpliceTreeOptions, createSpliceTree };
+export { CreateSpliceTree, Fn, MaybeArray, MaybeFn, SpliceTreeConfiguration, SpliceTreeData, SpliceTreeEventName, SpliceTreeEventPayload, SpliceTreeEventPayloadMap, SpliceTreeEvents, SpliceTreeInstance, SpliceTreeNode, SpliceTreePlugin, SpliceTreePluginContext, UseSpliceTreeOptions, createSpliceTree };

package/dist/index.js

@@ -92,7 +92,7 @@ function buildTree(data, keyField, parentField, expandedKeys = /* @__PURE__ */ n
 
 //#endregion
 //#region src/utils/expand.ts
-function initDefaultExpansion(map, expanded, def, lvl) {
+function initDefaultExpansion(map, expanded, def, lvl, autoExpandParent) {
 	const expandAll = () => {
 		for (const id of map.keys()) expanded.add(id);
 	};
@@ -104,7 +104,18 @@ function initDefaultExpansion(map, expanded, def, lvl) {
 		return;
 	}
 	if (Array.isArray(def)) {
-		for (const id of def) expanded.add(id);
+		for (const id of def) {
+			expanded.add(id);
+			if (autoExpandParent) {
+				let cur = map.get(id);
+				while (cur) {
+					const p = cur.getParent();
+					if (!p) break;
+					expanded.add(p.id);
+					cur = p;
+				}
+			}
+		}
 		if (lvl === "deepest") {
 			expandAll();
 			return;
@@ -332,6 +343,7 @@ function createSpliceTree(data, options = {}) {
 	const parentField = cfg.parentField ?? "parent";
 	const defaultExpanded = cfg.defaultExpanded;
 	const defaultExpandedLevel = cfg.defaultExpandedLevel;
+	const autoExpandParent = cfg.autoExpandParent;
 	const events = createEmitter();
 	const expandedKeys = createReactive(/* @__PURE__ */ new Set(), (payload) => {
 		events.emit({
@@ -340,7 +352,7 @@ function createSpliceTree(data, options = {}) {
 		});
 	});
 	let { roots, map, parentCache, childrenCache } = buildTree(data, keyField, parentField, expandedKeys);
-	initDefaultExpansion(map, expandedKeys, defaultExpanded, defaultExpandedLevel);
+	initDefaultExpansion(map, expandedKeys, defaultExpanded, defaultExpandedLevel, autoExpandParent);
 	const emitVisibility = () => {
 		events.emit({
 			name: "visibility",

package/package.json

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