knt-shared 1.5.2 → 1.5.3

package/dist/utils/tree.d.ts

@@ -16,6 +16,30 @@ export interface ArrayToMapOptions {
     /** 作为 value 的字段名，不传则返回整个对象 */
     valueField?: string;
 }
+/**
+ * 树形数据转换上下文
+ */
+export interface TransformContext<T = any> {
+    /** 当前节点层级（从 0 开始） */
+    level: number;
+    /** 在同级节点中的索引位置 */
+    index: number;
+    /** 父节点引用（根节点为 null） */
+    parent: T | null;
+    /** 节点路径（由各层级索引组成的数组） */
+    path: number[];
+    /** 所有祖先节点数组（从根节点到父节点，不包含当前节点） */
+    ancestors: T[];
+    /** 是否为叶子节点（无子节点） */
+    isLeaf: boolean;
+}
+/**
+ * 树形数据转换选项
+ */
+export interface TransformTreeOptions {
+    /** 子节点字段名，默认 'children' */
+    childrenField?: string;
+}
 /**
  * 将树形结构扁平化为一维数组
  * @param tree 树形数据数组
@@ -76,4 +100,120 @@ export declare function flattenTree<T extends Record<string, any>>(tree: T[], op
  * ```
  */
 export declare function arrayToMap<T extends Record<string, any>>(array: T[], options?: ArrayToMapOptions): Map<any, any>;
+/**
+ * 转换树形数据结构，支持字段映射、添加元数据、条件转换等操作
+ * @param tree 树形数据数组
+ * @param transform 转换函数，接收节点和上下文信息，返回转换后的节点
+ * @param options 配置选项
+ * @returns 转换后的新树形数据数组
+ * @example
+ * ```ts
+ * // 示例 1：字段映射（后端数据转 Arco Tree 格式）
+ * const backendData = [
+ *   { id: 1, name: '节点1', items: [
+ *     { id: 2, name: '节点1-1' },
+ *     { id: 3, name: '节点1-2' }
+ *   ]}
+ * ];
+ *
+ * const arcoTreeData = transformTree(
+ *   backendData,
+ *   (node) => ({
+ *     key: node.id,
+ *     title: node.name,
+ *   }),
+ *   { childrenField: 'items' }
+ * );
+ * // 结果: [{ key: 1, title: '节点1', children: [
+ * //   { key: 2, title: '节点1-1' },
+ * //   { key: 3, title: '节点1-2' }
+ * // ]}]
+ *
+ * // 示例 2：添加元数据字段
+ * const tree = [
+ *   { id: 1, title: '根节点', children: [
+ *     { id: 2, title: '子节点1' },
+ *     { id: 3, title: '子节点2', children: [
+ *       { id: 4, title: '孙节点' }
+ *     ]}
+ *   ]}
+ * ];
+ *
+ * const enrichedTree = transformTree(
+ *   tree,
+ *   (node, ctx) => ({
+ *     ...node,
+ *     level: ctx.level,
+ *     parentId: ctx.parent?.id,
+ *     isLeaf: ctx.isLeaf,
+ *     pathStr: ctx.path.join('-'),
+ *   })
+ * );
+ * // 结果: 每个节点都会添加 level、parentId、isLeaf、pathStr 字段
+ *
+ * // 示例 3：条件转换
+ * const menuTree = [
+ *   { id: 1, name: '首页', status: 'active', children: [
+ *     { id: 2, name: '用户管理', status: 'inactive' },
+ *     { id: 3, name: '系统设置', status: 'active' }
+ *   ]}
+ * ];
+ *
+ * const transformedMenu = transformTree(
+ *   menuTree,
+ *   (node, ctx) => ({
+ *     ...node,
+ *     title: ctx.level === 0 ? `【根】${node.name}` : node.name,
+ *     disabled: node.status === 'inactive',
+ *     icon: ctx.isLeaf ? 'icon-file' : 'icon-folder',
+ *   })
+ * );
+ * // 结果: 根节点标题添加前缀，inactive 状态的节点被禁用，根据是否为叶子节点设置不同图标
+ *
+ * // 示例 4：使用 ancestors 构建完整路径
+ * const categoryTree = [
+ *   { id: '767488425906949', name: 'HSS_专用勿动', children: [
+ *     { id: '767489603769093', name: '医疗保健', children: [
+ *       { id: '767489603769094', name: '医疗器械' }
+ *     ]}
+ *   ]}
+ * ];
+ *
+ * const treeWithFullPath = transformTree(
+ *   categoryTree,
+ *   (node, ctx) => ({
+ *     ...node,
+ *     fullPath: [...ctx.ancestors.map(a => a.id), node.id].join('/'),
+ *     fullPathText: [...ctx.ancestors.map(a => a.name), node.name].join('/'),
+ *   })
+ * );
+ * // 结果:
+ * // 根节点: { fullPath: '767488425906949', fullPathText: 'HSS_专用勿动' }
+ * // 子节点: { fullPath: '767488425906949/767489603769093', fullPathText: 'HSS_专用勿动/医疗保健' }
+ * // 孙节点: { fullPath: '767488425906949/767489603769093/767489603769094', fullPathText: 'HSS_专用勿动/医疗保健/医疗器械' }
+ *
+ * // 示例 5：复杂嵌套结构转换
+ * const orgData = [
+ *   {
+ *     deptId: 1,
+ *     deptName: '技术部',
+ *     subDepts: [
+ *       { deptId: 2, deptName: '前端组' },
+ *       { deptId: 3, deptName: '后端组' }
+ *     ]
+ *   }
+ * ];
+ *
+ * const treeSelectData = transformTree(
+ *   orgData,
+ *   (node, ctx) => ({
+ *     value: node.deptId,
+ *     label: node.deptName,
+ *     depth: ctx.level,
+ *   }),
+ *   { childrenField: 'subDepts' }
+ * );
+ * ```
+ */
+export declare function transformTree<T extends Record<string, any>, R = T>(tree: T[], transform: (node: T, context: TransformContext<T>) => R, options?: TransformTreeOptions): R[];
 //# sourceMappingURL=tree.d.ts.map

package/dist/utils/tree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../src/utils/tree.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,2BAA2B;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACvD,IAAI,EAAE,CAAC,EAAE,EACT,OAAO,CAAC,EAAE,kBAAkB,GAC3B,CAAC,EAAE,CA2CL;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACtD,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,CAAC,EAAE,iBAAiB,GAC1B,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CA0Bf"}
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../src/utils/tree.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,2BAA2B;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,GAAG;IACvC,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;IACjB,wBAAwB;IACxB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,iCAAiC;IACjC,SAAS,EAAE,CAAC,EAAE,CAAC;IACf,oBAAoB;IACpB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,2BAA2B;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACvD,IAAI,EAAE,CAAC,EAAE,EACT,OAAO,CAAC,EAAE,kBAAkB,GAC3B,CAAC,EAAE,CA2CL;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACtD,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,CAAC,EAAE,iBAAiB,GAC1B,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CA0Bf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkHG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAChE,IAAI,EAAE,CAAC,EAAE,EACT,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,EACvD,OAAO,CAAC,EAAE,oBAAoB,GAC7B,CAAC,EAAE,CAuEL"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "knt-shared",
-  "version": "1.5.2",
+  "version": "1.5.3",
   "description": "KNT共享组件库和工具函数",
   "author": "hss",
   "main": "dist/index.cjs.js",