jz-toolkit 1.0.9 → 1.1.0

package/dist/demo/index.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const filterDuplicateValues_1 = require("../array/filterDuplicateValues");
 const toFixed_1 = require("../number/toFixed");
 const hasKey_1 = require("../object/hasKey");
+const flattenTree_1 = require("../mapToArray/flattenTree");
 console.log((0, hasKey_1.getPropertyNames)({ a: 1, b: 2 }));
 const res = (0, filterDuplicateValues_1.filterArrayAttr)([
     {
@@ -17,3 +18,17 @@ const res = (0, filterDuplicateValues_1.filterArrayAttr)([
 console.log("res :>> ", res);
 const price = 19.956;
 console.log((0, toFixed_1.numberToFixed)(price, 2)); // "19.96" - 保留两位小数
+const tree = [
+    {
+        id: 1,
+        name: "节点1",
+        children: [
+            { id: 11, name: "节点1-1" },
+            { id: 12, name: "节点1-2", children: [{ id: 121, name: "节点1-2-1" }] },
+        ],
+    },
+    { id: 2, name: "节点2" },
+];
+// 扁平化
+const flatArray = (0, flattenTree_1.flattenTree)(tree);
+console.log(flatArray);

package/dist/esm/demo/index.js

@@ -1,6 +1,7 @@
 import { filterArrayAttr } from "../array/filterDuplicateValues";
 import { numberToFixed } from "../number/toFixed";
 import { getPropertyNames } from "../object/hasKey";
+import { flattenTree } from "../mapToArray/flattenTree";
 console.log(getPropertyNames({ a: 1, b: 2 }));
 const res = filterArrayAttr([
     {
@@ -15,3 +16,17 @@ const res = filterArrayAttr([
 console.log("res :>> ", res);
 const price = 19.956;
 console.log(numberToFixed(price, 2)); // "19.96" - 保留两位小数
+const tree = [
+    {
+        id: 1,
+        name: "节点1",
+        children: [
+            { id: 11, name: "节点1-1" },
+            { id: 12, name: "节点1-2", children: [{ id: 121, name: "节点1-2-1" }] },
+        ],
+    },
+    { id: 2, name: "节点2" },
+];
+// 扁平化
+const flatArray = flattenTree(tree);
+console.log(flatArray);

package/dist/esm/index.d.ts

@@ -7,7 +7,9 @@ export * as object from "./object";
 export * as string from "./string";
 export * as utility from "./utility";
 export * as number from "./number";
-export { chunk, compact, } from "./array";
+export * as mapToArray from "./mapToArray";
+export { chunk, compact, filterDuplicateValues, filterArrayAttr, } from "./array";
+export { flattenTree, convertToArray } from "./mapToArray";
 export { pick, omit, } from "./object";
 export { capitalize, camelCase, } from "./string";
 export { numberToFixed, } from "./number";

package/dist/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,SAAS,CAAC;AAGxB,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AAGnC,OAAO,EAEL,KAAK,EACL,OAAO,GACR,MAAM,SAAS,CAAC;AAEjB,OAAO,EAEL,IAAI,EACJ,IAAI,GACL,MAAM,UAAU,CAAC;AAElB,OAAO,EAEL,UAAU,EACV,SAAS,GACV,MAAM,UAAU,CAAC;AAElB,OAAO,EAEL,aAAa,GACd,MAAM,UAAU,CAAC;AAElB,OAAO,EAEL,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,MAAM,EACN,WAAW,EACX,iBAAiB,EACjB,OAAO,EACP,QAAQ,EACR,UAAU,EACV,MAAM,EACN,QAAQ,EACR,KAAK,EACL,KAAK,EACL,OAAO,GACR,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,SAAS,CAAC;AAGxB,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAG3C,OAAO,EAEL,KAAK,EACL,OAAO,EACP,qBAAqB,EACrB,eAAe,GAChB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EAEL,IAAI,EACJ,IAAI,GACL,MAAM,UAAU,CAAC;AAElB,OAAO,EAEL,UAAU,EACV,SAAS,GACV,MAAM,UAAU,CAAC;AAElB,OAAO,EAEL,aAAa,GACd,MAAM,UAAU,CAAC;AAElB,OAAO,EAEL,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,MAAM,EACN,WAAW,EACX,iBAAiB,EACjB,OAAO,EACP,QAAQ,EACR,UAAU,EACV,MAAM,EACN,QAAQ,EACR,KAAK,EACL,KAAK,EACL,OAAO,GACR,MAAM,WAAW,CAAC"}

package/dist/esm/index.js

@@ -9,10 +9,12 @@ export * as object from "./object";
 export * as string from "./string";
 export * as utility from "./utility";
 export * as number from "./number";
+export * as mapToArray from "./mapToArray";
 // 直接导出常用函数
 export { 
 // 数组
-chunk, compact, } from "./array";
+chunk, compact, filterDuplicateValues, filterArrayAttr, } from "./array";
+export { flattenTree, convertToArray } from "./mapToArray";
 export { 
 // 对象
 pick, omit, } from "./object";

package/dist/esm/mapToArray/convertToArray.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 将 Map 转换为数组
+ * @param map 输入 Map
+ * @returns 转换后的数组
+ *
+ * @example
+ * convertToArray(new Map<string, number>([["a", 1], ["b", 2], ["c", 3]])) // => [1, 2, 3]
+ */
+export declare function convertToArray<T>(map: Map<string, T>): T[];
+//# sourceMappingURL=convertToArray.d.ts.map

package/dist/esm/mapToArray/convertToArray.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertToArray.d.ts","sourceRoot":"","sources":["../../../src/mapToArray/convertToArray.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAK1D"}

package/dist/esm/mapToArray/convertToArray.js

@@ -0,0 +1,14 @@
+/**
+ * 将 Map 转换为数组
+ * @param map 输入 Map
+ * @returns 转换后的数组
+ *
+ * @example
+ * convertToArray(new Map<string, number>([["a", 1], ["b", 2], ["c", 3]])) // => [1, 2, 3]
+ */
+export function convertToArray(map) {
+    if (map.size === 0) {
+        return [];
+    }
+    return Array.from(map.values());
+}

package/dist/esm/mapToArray/flattenTree.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 将树形结构展平为数组
+ * @param tree 树形结构数组
+ * @param childrenKey 子节点在节点对象中的键名，默认为"children"
+ * @returns 展平后的数组
+ */
+export declare function flattenTree(tree: Record<string, unknown>[], childrenKey?: string): Record<string, unknown>[];
+//# sourceMappingURL=flattenTree.d.ts.map

package/dist/esm/mapToArray/flattenTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flattenTree.d.ts","sourceRoot":"","sources":["../../../src/mapToArray/flattenTree.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,WAAW,GAAE,MAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAcxH"}

package/dist/esm/mapToArray/flattenTree.js

@@ -0,0 +1,21 @@
+/**
+ * 将树形结构展平为数组
+ * @param tree 树形结构数组
+ * @param childrenKey 子节点在节点对象中的键名，默认为"children"
+ * @returns 展平后的数组
+ */
+export function flattenTree(tree, childrenKey = "children") {
+    if (!Array.isArray(tree)) {
+        throw new Error("tree must be an array");
+    }
+    const result = [];
+    tree.forEach((node) => {
+        result.push(node);
+        const children = node[childrenKey];
+        if (children && Array.isArray(children)) {
+            const flattenedChildren = flattenTree(children, childrenKey);
+            result.push(...flattenedChildren);
+        }
+    });
+    return result;
+}

package/dist/esm/mapToArray/index.d.ts

@@ -1,2 +1,3 @@
-export * from "./mapToArray";
+export * from "./convertToArray";
+export * from "./flattenTree";
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/mapToArray/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mapToArray/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mapToArray/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC"}

package/dist/esm/mapToArray/index.js

@@ -1 +1,2 @@
-export * from "./mapToArray";
+export * from "./convertToArray";
+export * from "./flattenTree";

package/dist/index.d.ts

@@ -7,7 +7,9 @@ export * as object from "./object";
 export * as string from "./string";
 export * as utility from "./utility";
 export * as number from "./number";
-export { chunk, compact, } from "./array";
+export * as mapToArray from "./mapToArray";
+export { chunk, compact, filterDuplicateValues, filterArrayAttr, } from "./array";
+export { flattenTree, convertToArray } from "./mapToArray";
 export { pick, omit, } from "./object";
 export { capitalize, camelCase, } from "./string";
 export { numberToFixed, } from "./number";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,SAAS,CAAC;AAGxB,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AAGnC,OAAO,EAEL,KAAK,EACL,OAAO,GACR,MAAM,SAAS,CAAC;AAEjB,OAAO,EAEL,IAAI,EACJ,IAAI,GACL,MAAM,UAAU,CAAC;AAElB,OAAO,EAEL,UAAU,EACV,SAAS,GACV,MAAM,UAAU,CAAC;AAElB,OAAO,EAEL,aAAa,GACd,MAAM,UAAU,CAAC;AAElB,OAAO,EAEL,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,MAAM,EACN,WAAW,EACX,iBAAiB,EACjB,OAAO,EACP,QAAQ,EACR,UAAU,EACV,MAAM,EACN,QAAQ,EACR,KAAK,EACL,KAAK,EACL,OAAO,GACR,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,SAAS,CAAC;AAGxB,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAG3C,OAAO,EAEL,KAAK,EACL,OAAO,EACP,qBAAqB,EACrB,eAAe,GAChB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EAEL,IAAI,EACJ,IAAI,GACL,MAAM,UAAU,CAAC;AAElB,OAAO,EAEL,UAAU,EACV,SAAS,GACV,MAAM,UAAU,CAAC;AAElB,OAAO,EAEL,aAAa,GACd,MAAM,UAAU,CAAC;AAElB,OAAO,EAEL,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,MAAM,EACN,WAAW,EACX,iBAAiB,EACjB,OAAO,EACP,QAAQ,EACR,UAAU,EACV,MAAM,EACN,QAAQ,EACR,KAAK,EACL,KAAK,EACL,OAAO,GACR,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -29,7 +29,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isEmpty = exports.isSet = exports.isMap = exports.isRegExp = exports.isDate = exports.isFunction = exports.isObject = exports.isArray = exports.isNullOrUndefined = exports.isUndefined = exports.isNull = exports.isBoolean = exports.isNumber = exports.isString = exports.numberToFixed = exports.camelCase = exports.capitalize = exports.omit = exports.pick = exports.compact = exports.chunk = exports.number = exports.utility = exports.string = exports.object = exports.array = void 0;
+exports.isEmpty = exports.isSet = exports.isMap = exports.isRegExp = exports.isDate = exports.isFunction = exports.isObject = exports.isArray = exports.isNullOrUndefined = exports.isUndefined = exports.isNull = exports.isBoolean = exports.isNumber = exports.isString = exports.numberToFixed = exports.camelCase = exports.capitalize = exports.omit = exports.pick = exports.convertToArray = exports.flattenTree = exports.filterArrayAttr = exports.filterDuplicateValues = exports.compact = exports.chunk = exports.mapToArray = exports.number = exports.utility = exports.string = exports.object = exports.array = void 0;
 // 类型导出
 __exportStar(require("./types"), exports);
 // 功能模块导出
@@ -38,11 +38,17 @@ exports.object = __importStar(require("./object"));
 exports.string = __importStar(require("./string"));
 exports.utility = __importStar(require("./utility"));
 exports.number = __importStar(require("./number"));
+exports.mapToArray = __importStar(require("./mapToArray"));
 // 直接导出常用函数
 var array_1 = require("./array");
 // 数组
 Object.defineProperty(exports, "chunk", { enumerable: true, get: function () { return array_1.chunk; } });
 Object.defineProperty(exports, "compact", { enumerable: true, get: function () { return array_1.compact; } });
+Object.defineProperty(exports, "filterDuplicateValues", { enumerable: true, get: function () { return array_1.filterDuplicateValues; } });
+Object.defineProperty(exports, "filterArrayAttr", { enumerable: true, get: function () { return array_1.filterArrayAttr; } });
+var mapToArray_1 = require("./mapToArray");
+Object.defineProperty(exports, "flattenTree", { enumerable: true, get: function () { return mapToArray_1.flattenTree; } });
+Object.defineProperty(exports, "convertToArray", { enumerable: true, get: function () { return mapToArray_1.convertToArray; } });
 var object_1 = require("./object");
 // 对象
 Object.defineProperty(exports, "pick", { enumerable: true, get: function () { return object_1.pick; } });

package/dist/mapToArray/convertToArray.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 将 Map 转换为数组
+ * @param map 输入 Map
+ * @returns 转换后的数组
+ *
+ * @example
+ * convertToArray(new Map<string, number>([["a", 1], ["b", 2], ["c", 3]])) // => [1, 2, 3]
+ */
+export declare function convertToArray<T>(map: Map<string, T>): T[];
+//# sourceMappingURL=convertToArray.d.ts.map

package/dist/mapToArray/convertToArray.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertToArray.d.ts","sourceRoot":"","sources":["../../src/mapToArray/convertToArray.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAK1D"}

package/dist/mapToArray/convertToArray.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertToArray = void 0;
+/**
+ * 将 Map 转换为数组
+ * @param map 输入 Map
+ * @returns 转换后的数组
+ *
+ * @example
+ * convertToArray(new Map<string, number>([["a", 1], ["b", 2], ["c", 3]])) // => [1, 2, 3]
+ */
+function convertToArray(map) {
+    if (map.size === 0) {
+        return [];
+    }
+    return Array.from(map.values());
+}
+exports.convertToArray = convertToArray;

package/dist/mapToArray/flattenTree.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 将树形结构展平为数组
+ * @param tree 树形结构数组
+ * @param childrenKey 子节点在节点对象中的键名，默认为"children"
+ * @returns 展平后的数组
+ */
+export declare function flattenTree(tree: Record<string, unknown>[], childrenKey?: string): Record<string, unknown>[];
+//# sourceMappingURL=flattenTree.d.ts.map

package/dist/mapToArray/flattenTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flattenTree.d.ts","sourceRoot":"","sources":["../../src/mapToArray/flattenTree.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,WAAW,GAAE,MAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAcxH"}

package/dist/mapToArray/flattenTree.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flattenTree = void 0;
+/**
+ * 将树形结构展平为数组
+ * @param tree 树形结构数组
+ * @param childrenKey 子节点在节点对象中的键名，默认为"children"
+ * @returns 展平后的数组
+ */
+function flattenTree(tree, childrenKey = "children") {
+    if (!Array.isArray(tree)) {
+        throw new Error("tree must be an array");
+    }
+    const result = [];
+    tree.forEach((node) => {
+        result.push(node);
+        const children = node[childrenKey];
+        if (children && Array.isArray(children)) {
+            const flattenedChildren = flattenTree(children, childrenKey);
+            result.push(...flattenedChildren);
+        }
+    });
+    return result;
+}
+exports.flattenTree = flattenTree;

package/dist/mapToArray/index.d.ts

@@ -1,2 +1,3 @@
-export * from "./mapToArray";
+export * from "./convertToArray";
+export * from "./flattenTree";
 //# sourceMappingURL=index.d.ts.map

package/dist/mapToArray/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mapToArray/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mapToArray/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC"}

package/dist/mapToArray/index.js

@@ -14,4 +14,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./mapToArray"), exports);
+__exportStar(require("./convertToArray"), exports);
+__exportStar(require("./flattenTree"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jz-toolkit",
-  "version": "1.0.9",
+  "version": "1.1.0",
   "description": "一个轻量级的JavaScript/TypeScript 工具库",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",