utiller 1.0.380 → 1.0.381

package/lib/utiller/index.js

@@ -930,8 +930,8 @@ var Utiller = /*#__PURE__*/function () {
   }, {
     key: "accumulate",
     value:
-    /** 就是把 target 放到 condition 裡面處理, 然後取代原本的target
-     *
+    /**
+     * 把敘述句和條件子句累加在一起，讓其變成一個合理的functional呼叫
      * condition2(condition1(target)) =>  為了應付 collection(path).where('age','>',11).orderBy('age');
      * */
     function accumulate(target, conditions) {
@@ -4291,8 +4291,55 @@ var Utiller = /*#__PURE__*/function () {
       }, {});
     }
   }, {
-    key: "getFilteredHeraPeriods",
-    value: /** ============== 排課系統公式 開始 ============== */
+    key: "mergeArrayByKey",
+    value:
+    /**
+     * 📦 mergeArrayByKey(array)
+     * ---------------------------------------
+     * 將陣列中相同 key 的物件進行「巢狀合併」，並直接 mutate 原陣列內容。
+     *
+     * ✅ 特點：
+     * - 自動合併相同 key 的物件內容（深層合併）
+     * - 不建立新陣列，會直接修改傳入的 array
+     * - 適用於需要整併設定、狀態、表單資料等情境
+     *
+     * 🧩 範例：
+     * ```js
+     * const array = [
+     *   { a: { c: 1 } },
+     *   { b: { d: 2 } },
+     *   { a: { f: 3 } }
+     * ];
+     *
+     * ArrayHelper.mergeArrayByKey(array);
+     *
+     * console.log(array);
+     * // 👉 [ { a: { c: 1, f: 3 } }, { b: { d: 2 } } ]
+     * ```
+     *
+     * @param {Array<Object>} array - 需被合併的物件陣列
+     * @returns {Array<Object>} - 回傳同一個（已被 mutate 的）陣列
+     */
+    function mergeArrayByKey(array) {
+      if (!Array.isArray(array)) return array;
+
+      // 1️⃣ 利用 lodash 深層合併所有物件（例如 {a:{x}} + {a:{y}} => {a:{x,y}})
+      var merged = _lodash["default"].merge.apply(_lodash["default"], [{}].concat((0, _toConsumableArray2["default"])(array)));
+
+      // 2️⃣ 清空原陣列（mutate）
+      array.length = 0;
+
+      // 3️⃣ 將合併結果重新拆成 [{a:{...}}, {b:{...}}] 結構
+      Object.entries(merged).forEach(function (_ref12) {
+        var _ref13 = (0, _slicedToArray2["default"])(_ref12, 2),
+          key = _ref13[0],
+          value = _ref13[1];
+        array.push((0, _defineProperty2["default"])({}, key, value));
+      });
+      return array;
+    }
+
+    /** ============== 排課系統公式 開始 ============== */
 
     /**
      * /const arrayWithDup = [
@@ -4309,7 +4356,9 @@ var Utiller = /*#__PURE__*/function () {
      * 2. idOfBooze和idOfVariant為PK， 重複的只保留一組
      * 3. 回傳filter array,(反查出哪些課程重複會用到其他資訊)
      * */
-    function getFilteredHeraPeriods(arr, idOfCurrentBooze) {
+  }, {
+    key: "getFilteredHeraPeriods",
+    value: function getFilteredHeraPeriods(arr, idOfCurrentBooze) {
       return _lodash["default"].chain(arr)
       // 1️⃣ 刪掉 idOfBooze 等於目標值的項目
       .filter(function (item) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "utiller",
-  "version": "1.0.380",
+  "version": "1.0.381",
   "description": "",
   "main": "index.js",
   "scripts": {

package/template/sample.package.json

@@ -11,7 +11,7 @@
   "license": "ISC",
   "dependencies": {
     "configerer": "^1.0.23",
-    "utiller": "^1.0.379",
+    "utiller": "^1.0.380",
     "linepayer": "^1.0.15",
     "databazer": "^1.0.17",
     "lodash": "^4.17.20",