qmwts 1.1.77 → 1.1.78

package/dist/utils/array-utils.d.ts

@@ -29,7 +29,8 @@ declare const _default: {
      * @param value 获取元素唯一标识的函数
      * @param override 遇到重复元素是否覆盖
      */
-    uniqueBy<T, K = unknown>(array: T[] | undefined, value: (item: T) => K, override?: boolean): T[];
+    uniqueByKey<T, K = unknown>(array: T[] | undefined, value: (item: T) => K, override?: boolean): T[];
     sort<T>(array: T[], order: "asc" | "desc", ...values: ((item: T) => number)[]): void;
+    mergeByKey<T extends object>(keyExtractor: (item: T) => string | number | symbol, ...arrays: T[][]): T[];
 };
 export default _default;

package/dist/utils/array-utils.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const lodash_es_1 = require("lodash-es");
 exports.default = {
     /**
      * 数组转化为树形结构
@@ -89,7 +90,7 @@ exports.default = {
      * @param value 获取元素唯一标识的函数
      * @param override 遇到重复元素是否覆盖
      */
-    uniqueBy(array = [], value, override = false) {
+    uniqueByKey(array = [], value, override = false) {
         array = array ?? [];
         const map = new Map();
         for (let i = 0; i < array.length; i++) {
@@ -115,5 +116,25 @@ exports.default = {
             }
             return 0;
         });
+    },
+    mergeByKey(keyExtractor, ...arrays) {
+        // 1. 空值防御：过滤空数组，避免无效遍历
+        const validArrays = arrays.filter(arr => Array.isArray(arr) && arr.length > 0);
+        if (validArrays.length === 0)
+            return [];
+        const mergeMap = new Map();
+        for (let e of validArrays.flat()) {
+            if (!e)
+                continue;
+            const key = keyExtractor(e);
+            const v = mergeMap.get(key);
+            if (v) {
+                mergeMap.set(key, (0, lodash_es_1.merge)({}, e, v)); // v放在后面，即保留先插入的值
+            }
+            else {
+                mergeMap.set(key, { ...e });
+            }
+        }
+        return Array.from(mergeMap.values());
     }
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qmwts",
-  "version": "1.1.77",
+  "version": "1.1.78",
   "description": "",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -11,6 +11,7 @@
   "author": "qmw",
   "license": "ISC",
   "devDependencies": {
+    "@types/lodash-es": "^4.17.12",
     "axios": "*",
     "typescript": "^5.9.2",
     "vitest": "^3.2.4"
@@ -19,7 +20,8 @@
     "dist"
   ],
   "dependencies": {
-    "jszip": "^3.10.1"
+    "jszip": "^3.10.1",
+    "lodash-es": "^4.17.22"
   },
   "peerDependencies": {
     "axios": "^1.12.2"