@kcuf/helper-data 0.2.3 → 0.3.0

package/CHANGELOG.md

@@ -1,6 +1,10 @@
 # CHANGELOG
 
-## 0.2.3 2024/11/05 @驳是
+## 0.3.0 2025/12/18 @驳是
+
+* FEAT 新增 `normalizeTreeList`
+
+## 0.2.3 2025/10/26 @驳是
 
 * FEAT 新增 `isEmptyPagedList`
 

package/dist/cjs/helper/index.js

@@ -52,6 +52,12 @@ Object.defineProperty(exports, "normalizeTime", {
     return _normalizeTime.default;
   }
 });
+Object.defineProperty(exports, "normalizeTreeList", {
+  enumerable: true,
+  get: function get() {
+    return _normalizeTreeList.default;
+  }
+});
 var _normalizeId = _interopRequireDefault(require("./normalize-id"));
 var _normalizeBoolean = _interopRequireDefault(require("./normalize-boolean"));
 var _normalizeNumber = _interopRequireDefault(require("./normalize-number"));
@@ -59,4 +65,5 @@ var _normalizeEnum = _interopRequireDefault(require("./normalize-enum"));
 var _normalizeTime = _interopRequireDefault(require("./normalize-time"));
 var _normalizePagedList = _interopRequireDefault(require("./normalize-paged-list"));
 var _normalizePagedListUncertain = _interopRequireDefault(require("./normalize-paged-list-uncertain"));
+var _normalizeTreeList = _interopRequireDefault(require("./normalize-tree-list"));
 var _isEmptyPagedList = _interopRequireDefault(require("./is-empty-paged-list"));

package/dist/cjs/helper/normalize-tree-list.js

@@ -0,0 +1,38 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = normalizeTreeList;
+var _objectSpread2 = _interopRequireDefault(require("@babel/runtime/helpers/objectSpread2"));
+/**
+ * 将平铺的数据转成树节点列表
+ */
+function normalizeTreeList(list) {
+  var nodeMap = new Map();
+  var treeList = list.map(function (v) {
+    var treeItem = (0, _objectSpread2.default)({}, v);
+    nodeMap.set(treeItem.id, treeItem);
+    return treeItem;
+  });
+  function putToParent(o) {
+    if (!o.parentId) {
+      return;
+    }
+    var parentNode = nodeMap.get(o.parentId);
+    if (parentNode) {
+      var _parentNode$children;
+      (_parentNode$children = parentNode.children) !== null && _parentNode$children !== void 0 ? _parentNode$children : parentNode.children = [];
+      parentNode.children.push(o);
+    } else {
+      o.parentId = ''; // wrong parent
+    }
+  }
+  treeList.forEach(function (v) {
+    return putToParent(v);
+  });
+  return treeList.filter(function (v) {
+    return !v.parentId;
+  }); // all top-level nodes
+}

package/dist/esm/helper/index.js

@@ -5,5 +5,6 @@ export { default as normalizeEnum } from './normalize-enum';
 export { default as normalizeTime } from './normalize-time';
 export { default as normalizePagedList } from './normalize-paged-list';
 export { default as normalizePagedListUncertain } from './normalize-paged-list-uncertain';
+export { default as normalizeTreeList } from './normalize-tree-list';
 export { default as isEmptyPagedList } from './is-empty-paged-list';
 //# sourceMappingURL=index.js.map

package/dist/esm/helper/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["default","normalizeId","normalizeBoolean","normalizeNumber","normalizeEnum","normalizeTime","normalizePagedList","normalizePagedListUncertain","isEmptyPagedList"],"sources":["../../../src/helper/index.ts"],"sourcesContent":["export { default as normalizeId } from './normalize-id';\nexport { default as normalizeBoolean } from './normalize-boolean';\nexport { default as normalizeNumber } from './normalize-number';\nexport { default as normalizeEnum } from './normalize-enum';\nexport { default as normalizeTime } from './normalize-time';\nexport { default as normalizePagedList } from './normalize-paged-list';\nexport { default as normalizePagedListUncertain } from './normalize-paged-list-uncertain';\n\nexport { default as isEmptyPagedList } from './is-empty-paged-list';\n"],"mappings":"AAAA,SAASA,OAAO,IAAIC,WAAW,QAAQ,gBAAgB;AACvD,SAASD,OAAO,IAAIE,gBAAgB,QAAQ,qBAAqB;AACjE,SAASF,OAAO,IAAIG,eAAe,QAAQ,oBAAoB;AAC/D,SAASH,OAAO,IAAII,aAAa,QAAQ,kBAAkB;AAC3D,SAASJ,OAAO,IAAIK,aAAa,QAAQ,kBAAkB;AAC3D,SAASL,OAAO,IAAIM,kBAAkB,QAAQ,wBAAwB;AACtE,SAASN,OAAO,IAAIO,2BAA2B,QAAQ,kCAAkC;AAEzF,SAASP,OAAO,IAAIQ,gBAAgB,QAAQ,uBAAuB","ignoreList":[]}
+{"version":3,"file":"index.js","names":["default","normalizeId","normalizeBoolean","normalizeNumber","normalizeEnum","normalizeTime","normalizePagedList","normalizePagedListUncertain","normalizeTreeList","isEmptyPagedList"],"sources":["../../../src/helper/index.ts"],"sourcesContent":["export { default as normalizeId } from './normalize-id';\nexport { default as normalizeBoolean } from './normalize-boolean';\nexport { default as normalizeNumber } from './normalize-number';\nexport { default as normalizeEnum } from './normalize-enum';\nexport { default as normalizeTime } from './normalize-time';\nexport { default as normalizePagedList } from './normalize-paged-list';\nexport { default as normalizePagedListUncertain } from './normalize-paged-list-uncertain';\nexport { default as normalizeTreeList } from './normalize-tree-list';\n\nexport { default as isEmptyPagedList } from './is-empty-paged-list';\n"],"mappings":"AAAA,SAASA,OAAO,IAAIC,WAAW,QAAQ,gBAAgB;AACvD,SAASD,OAAO,IAAIE,gBAAgB,QAAQ,qBAAqB;AACjE,SAASF,OAAO,IAAIG,eAAe,QAAQ,oBAAoB;AAC/D,SAASH,OAAO,IAAII,aAAa,QAAQ,kBAAkB;AAC3D,SAASJ,OAAO,IAAIK,aAAa,QAAQ,kBAAkB;AAC3D,SAASL,OAAO,IAAIM,kBAAkB,QAAQ,wBAAwB;AACtE,SAASN,OAAO,IAAIO,2BAA2B,QAAQ,kCAAkC;AACzF,SAASP,OAAO,IAAIQ,iBAAiB,QAAQ,uBAAuB;AAEpE,SAASR,OAAO,IAAIS,gBAAgB,QAAQ,uBAAuB","ignoreList":[]}

package/dist/esm/helper/normalize-tree-list.js

@@ -0,0 +1,32 @@
+import _objectSpread from "@babel/runtime/helpers/objectSpread2";
+/**
+ * 将平铺的数据转成树节点列表
+ */
+export default function normalizeTreeList(list) {
+  var nodeMap = new Map();
+  var treeList = list.map(function (v) {
+    var treeItem = _objectSpread({}, v);
+    nodeMap.set(treeItem.id, treeItem);
+    return treeItem;
+  });
+  function putToParent(o) {
+    if (!o.parentId) {
+      return;
+    }
+    var parentNode = nodeMap.get(o.parentId);
+    if (parentNode) {
+      var _parentNode$children;
+      (_parentNode$children = parentNode.children) !== null && _parentNode$children !== void 0 ? _parentNode$children : parentNode.children = [];
+      parentNode.children.push(o);
+    } else {
+      o.parentId = ''; // wrong parent
+    }
+  }
+  treeList.forEach(function (v) {
+    return putToParent(v);
+  });
+  return treeList.filter(function (v) {
+    return !v.parentId;
+  }); // all top-level nodes
+}
+//# sourceMappingURL=normalize-tree-list.js.map

package/dist/esm/helper/normalize-tree-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-tree-list.js","names":["normalizeTreeList","list","nodeMap","Map","treeList","map","v","treeItem","_objectSpread","set","id","putToParent","o","parentId","parentNode","get","_parentNode$children","children","push","forEach","filter"],"sources":["../../../src/helper/normalize-tree-list.ts"],"sourcesContent":["import {\n  IBaseDataId,\n  IBaseDataParentId\n} from '../types';\n\ninterface IBaseItem extends IBaseDataId, IBaseDataParentId {}\n\ntype TTreeItem<T extends IBaseItem> = T & {\n  children?: TTreeItem<T>[];\n};\n\n/**\n * 将平铺的数据转成树节点列表\n */\nexport default function normalizeTreeList<T extends IBaseItem>(list: T[]): TTreeItem<T>[] {\n  const nodeMap = new Map<string, TTreeItem<T>>();\n  const treeList: TTreeItem<T>[] = list.map((v: T) => {\n    const treeItem: TTreeItem<T> = { // shallow clone\n      ...v\n    };\n    \n    nodeMap.set(treeItem.id, treeItem);\n    \n    return treeItem;\n  });\n  \n  function putToParent(o: TTreeItem<T>): void {\n    if (!o.parentId) {\n      return;\n    }\n    \n    const parentNode = nodeMap.get(o.parentId);\n    \n    if (parentNode) {\n      parentNode.children ??= [];\n      \n      parentNode.children.push(o);\n    } else {\n      o.parentId = ''; // wrong parent\n    }\n  }\n  \n  treeList.forEach(v => putToParent(v));\n  \n  return treeList.filter(v => !v.parentId); // all top-level nodes\n}\n"],"mappings":";AAWA;AACA;AACA;AACA,eAAe,SAASA,iBAAiBA,CAAsBC,IAAS,EAAkB;EACxF,IAAMC,OAAO,GAAG,IAAIC,GAAG,CAAuB,CAAC;EAC/C,IAAMC,QAAwB,GAAGH,IAAI,CAACI,GAAG,CAAC,UAACC,CAAI,EAAK;IAClD,IAAMC,QAAsB,GAAAC,aAAA,KACvBF,CAAC,CACL;IAEDJ,OAAO,CAACO,GAAG,CAACF,QAAQ,CAACG,EAAE,EAAEH,QAAQ,CAAC;IAElC,OAAOA,QAAQ;EACjB,CAAC,CAAC;EAEF,SAASI,WAAWA,CAACC,CAAe,EAAQ;IAC1C,IAAI,CAACA,CAAC,CAACC,QAAQ,EAAE;MACf;IACF;IAEA,IAAMC,UAAU,GAAGZ,OAAO,CAACa,GAAG,CAACH,CAAC,CAACC,QAAQ,CAAC;IAE1C,IAAIC,UAAU,EAAE;MAAA,IAAAE,oBAAA;MACd,CAAAA,oBAAA,GAAAF,UAAU,CAACG,QAAQ,cAAAD,oBAAA,cAAAA,oBAAA,GAAnBF,UAAU,CAACG,QAAQ,GAAK,EAAE;MAE1BH,UAAU,CAACG,QAAQ,CAACC,IAAI,CAACN,CAAC,CAAC;IAC7B,CAAC,MAAM;MACLA,CAAC,CAACC,QAAQ,GAAG,EAAE,CAAC,CAAC;IACnB;EACF;EAEAT,QAAQ,CAACe,OAAO,CAAC,UAAAb,CAAC;IAAA,OAAIK,WAAW,CAACL,CAAC,CAAC;EAAA,EAAC;EAErC,OAAOF,QAAQ,CAACgB,MAAM,CAAC,UAAAd,CAAC;IAAA,OAAI,CAACA,CAAC,CAACO,QAAQ;EAAA,EAAC,CAAC,CAAC;AAC5C","ignoreList":[]}

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/index.ts"],"sourcesContent":["export * from './helper';\n\nexport type {\n  // 参数标准化\n  IBaseParamsPage as BaseParamsPage,\n  IBaseParamsPageWithQ as BaseParamsPageWithQ,\n  IBaseParamsCursorPage as BaseParamsCursorPage,\n  IBaseParamsCursorPageWithQ as BaseParamsCursorPageWithQ,\n  \n  // 数据标准化\n  IBaseDataId as BaseDataId,\n  IBaseDataName as BaseDataName,\n  IBaseDataIdName as BaseDataIdName,\n  IBaseDataTitle as BaseDataTitle,\n  IBaseDataDescription as BaseDataDescription,\n  IBaseDataContent as BaseDataContent,\n  IBaseDataTimeCreated as BaseDataTimeCreated,\n  IBaseDataTimeUpdated as BaseDataTimeModified,\n  IBaseDataTimes as BaseDataTimes,\n  IBaseDataCreator as BaseDataCreator,\n  IBaseDataUpdater as BaseDataUpdater,\n  \n  // 数据标准化（泛型）\n  IPagedList as PagedList,\n  IPagedCursorList as PagedCursorList,\n  IPagedListUncertain as PagedListUncertain\n} from './types';\n"],"mappings":"AAAA,cAAc,UAAU;AAAC","ignoreList":[]}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/index.ts"],"sourcesContent":["export * from './helper';\n\nexport type {\n  // 参数标准化\n  IBaseParamsPage as BaseParamsPage,\n  IBaseParamsPageWithQ as BaseParamsPageWithQ,\n  IBaseParamsCursorPage as BaseParamsCursorPage,\n  IBaseParamsCursorPageWithQ as BaseParamsCursorPageWithQ,\n  \n  // 数据标准化\n  IBaseDataId as BaseDataId,\n  IBaseDataParentId as BaseDataParentId,\n  IBaseDataName as BaseDataName,\n  IBaseDataIdName as BaseDataIdName,\n  IBaseDataTitle as BaseDataTitle,\n  IBaseDataDescription as BaseDataDescription,\n  IBaseDataContent as BaseDataContent,\n  IBaseDataTimeCreated as BaseDataTimeCreated,\n  IBaseDataTimeUpdated as BaseDataTimeModified,\n  IBaseDataTimes as BaseDataTimes,\n  IBaseDataCreator as BaseDataCreator,\n  IBaseDataUpdater as BaseDataUpdater,\n  \n  // 数据标准化（泛型）\n  IPagedList as PagedList,\n  IPagedCursorList as PagedCursorList,\n  IPagedListUncertain as PagedListUncertain\n} from './types';\n"],"mappings":"AAAA,cAAc,UAAU;AAAC","ignoreList":[]}

package/dist/esm/types/base-data.js.map

@@ -1 +1 @@
-{"version":3,"file":"base-data.js","names":[],"sources":["../../../src/types/base-data.ts"],"sourcesContent":["// 基础类型 mixin，用于继承，统一前缀 BaseData\n\n/**\n * 「ID」标准化\n */\nexport interface IBaseDataId {\n  id: string;\n}\n\n/**\n * 「名称」标准化\n */\nexport interface IBaseDataName {\n  name: string;\n}\n\n/**\n * 「标题」标准化\n */\nexport interface IBaseDataTitle {\n  title: string;\n}\n\n/**\n * 「内容」标准化\n */\nexport interface IBaseDataContent {\n  content: string;\n}\n\n/**\n * 「描述」标准化\n */\nexport interface IBaseDataDescription {\n  description: string;\n}\n\n/**\n * id + name\n */\nexport interface IBaseDataIdName extends IBaseDataId, IBaseDataName {}\n\n/**\n * 「创建时间」标准化\n */\nexport interface IBaseDataTimeCreated {\n  timeCreated: Date;\n}\n\n/**\n * 「更新时间」标准化\n */\nexport interface IBaseDataTimeUpdated {\n  timeUpdated: Date;\n}\n\n/**\n * timeCreated + timeUpdated\n */\nexport interface IBaseDataTimes extends IBaseDataTimeCreated, IBaseDataTimeUpdated {}\n\n/**\n * 「创建人」标准化\n */\nexport interface IBaseDataCreator {\n  creator: IBaseDataIdName;\n}\n\n/**\n * 「更新人」标准化\n */\nexport interface IBaseDataUpdater {\n  updater: IBaseDataIdName;\n}\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"base-data.js","names":[],"sources":["../../../src/types/base-data.ts"],"sourcesContent":["// 基础类型 mixin，用于继承，统一前缀 BaseData\n\n/**\n * 「ID」标准化\n */\nexport interface IBaseDataId {\n  id: string;\n}\n\n/**\n * 「父 ID」标准化\n */\nexport interface IBaseDataParentId {\n  parentId: string;\n}\n\n/**\n * 「名称」标准化\n */\nexport interface IBaseDataName {\n  name: string;\n}\n\n/**\n * 「标题」标准化\n */\nexport interface IBaseDataTitle {\n  title: string;\n}\n\n/**\n * 「内容」标准化\n */\nexport interface IBaseDataContent {\n  content: string;\n}\n\n/**\n * 「描述」标准化\n */\nexport interface IBaseDataDescription {\n  description: string;\n}\n\n/**\n * id + name\n */\nexport interface IBaseDataIdName extends IBaseDataId, IBaseDataName {}\n\n/**\n * 「创建时间」标准化\n */\nexport interface IBaseDataTimeCreated {\n  timeCreated: Date;\n}\n\n/**\n * 「更新时间」标准化\n */\nexport interface IBaseDataTimeUpdated {\n  timeUpdated: Date;\n}\n\n/**\n * timeCreated + timeUpdated\n */\nexport interface IBaseDataTimes extends IBaseDataTimeCreated, IBaseDataTimeUpdated {}\n\n/**\n * 「创建人」标准化\n */\nexport interface IBaseDataCreator {\n  creator: IBaseDataIdName;\n}\n\n/**\n * 「更新人」标准化\n */\nexport interface IBaseDataUpdater {\n  updater: IBaseDataIdName;\n}\n"],"mappings":"","ignoreList":[]}

package/dist/types/helper/index.d.ts

@@ -5,4 +5,5 @@ export { default as normalizeEnum } from './normalize-enum';
 export { default as normalizeTime } from './normalize-time';
 export { default as normalizePagedList } from './normalize-paged-list';
 export { default as normalizePagedListUncertain } from './normalize-paged-list-uncertain';
+export { default as normalizeTreeList } from './normalize-tree-list';
 export { default as isEmptyPagedList } from './is-empty-paged-list';

package/dist/types/helper/normalize-tree-list.d.ts

@@ -0,0 +1,11 @@
+import { IBaseDataId, IBaseDataParentId } from '../types';
+interface IBaseItem extends IBaseDataId, IBaseDataParentId {
+}
+type TTreeItem<T extends IBaseItem> = T & {
+    children?: TTreeItem<T>[];
+};
+/**
+ * 将平铺的数据转成树节点列表
+ */
+export default function normalizeTreeList<T extends IBaseItem>(list: T[]): TTreeItem<T>[];
+export {};

package/dist/types/index.d.ts

@@ -1,2 +1,2 @@
 export * from './helper';
-export type { IBaseParamsPage as BaseParamsPage, IBaseParamsPageWithQ as BaseParamsPageWithQ, IBaseParamsCursorPage as BaseParamsCursorPage, IBaseParamsCursorPageWithQ as BaseParamsCursorPageWithQ, IBaseDataId as BaseDataId, IBaseDataName as BaseDataName, IBaseDataIdName as BaseDataIdName, IBaseDataTitle as BaseDataTitle, IBaseDataDescription as BaseDataDescription, IBaseDataContent as BaseDataContent, IBaseDataTimeCreated as BaseDataTimeCreated, IBaseDataTimeUpdated as BaseDataTimeModified, IBaseDataTimes as BaseDataTimes, IBaseDataCreator as BaseDataCreator, IBaseDataUpdater as BaseDataUpdater, IPagedList as PagedList, IPagedCursorList as PagedCursorList, IPagedListUncertain as PagedListUncertain } from './types';
+export type { IBaseParamsPage as BaseParamsPage, IBaseParamsPageWithQ as BaseParamsPageWithQ, IBaseParamsCursorPage as BaseParamsCursorPage, IBaseParamsCursorPageWithQ as BaseParamsCursorPageWithQ, IBaseDataId as BaseDataId, IBaseDataParentId as BaseDataParentId, IBaseDataName as BaseDataName, IBaseDataIdName as BaseDataIdName, IBaseDataTitle as BaseDataTitle, IBaseDataDescription as BaseDataDescription, IBaseDataContent as BaseDataContent, IBaseDataTimeCreated as BaseDataTimeCreated, IBaseDataTimeUpdated as BaseDataTimeModified, IBaseDataTimes as BaseDataTimes, IBaseDataCreator as BaseDataCreator, IBaseDataUpdater as BaseDataUpdater, IPagedList as PagedList, IPagedCursorList as PagedCursorList, IPagedListUncertain as PagedListUncertain } from './types';

package/dist/types/types/base-data.d.ts

@@ -4,6 +4,12 @@
 export interface IBaseDataId {
     id: string;
 }
+/**
+ * 「父 ID」标准化
+ */
+export interface IBaseDataParentId {
+    parentId: string;
+}
 /**
  * 「名称」标准化
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kcuf/helper-data",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "description": "Data normalizer helpers and loading stuff to make all frontend data processing sane.",
   "keywords": [],
   "license": "MIT",
@@ -12,7 +12,7 @@
     "type": "git",
     "url": "git+https://github.com/justnewbee/kcuf.git"
   },
-  "homepage": "https://github.com/justnewbee/kcuf/tree/master/packages-helper/helper-data",
+  "homepage": "https://github.com/justnewbee/kcuf/tree/main/packages-helper/helper-data",
   "bugs": "https://github.com/justnewbee/kcuf/issues",
   "author": {
     "name": "Jianchun Wang",
@@ -27,12 +27,12 @@
     "@babel/plugin-transform-runtime": "^7.28.5",
     "@babel/preset-env": "^7.28.5",
     "@babel/preset-typescript": "^7.28.5",
-    "rimraf": "^6.0.1",
+    "rimraf": "^6.1.2",
     "typescript": "^5.9.3",
-    "@kcuf/ts-config": "^0.0.1"
+    "@kcuf/ts-config": "^0.1.0"
   },
   "peerDependencies": {
-    "@babel/runtime": "^7.x"
+    "@babel/runtime": ">=7.0.0"
   },
   "scripts": {
     "build:clean": "rimraf dist",