utiller 1.0.283 → 1.0.285

package/lib/utiller/index.js

@@ -219,16 +219,20 @@ var Utiller = /*#__PURE__*/function () {
      * utiller.insertToArray(array, 999, 'QQ', 'WW'); /**  [3,4,5,'QQ','WW']
      * */
     (0, _defineProperty2["default"])(this, "insertToArray", function (array, index) {
-      index = index + 1;
-      /** 植樹問題拔 我想 */
-      var initial = _lodash["default"].slice(array, 0, index);
-      var end = _lodash["default"].slice(array, index, array.length);
-      for (var _len = arguments.length, item = new Array(_len > 2 ? _len - 2 : 0), _key2 = 2; _key2 < _len; _key2++) {
-        item[_key2 - 2] = arguments[_key2];
-      }
-      var combine = [].concat((0, _toConsumableArray2["default"])(initial), item, (0, _toConsumableArray2["default"])(end));
-      array.length = 0;
-      array.push.apply(array, (0, _toConsumableArray2["default"])(combine));
+      if (!Array.isArray(array)) {
+        throw new Error("First argument must be an array.");
+      }
+      // splice 的 index 是插入位置，原函式 index 是插入點的前一個位置
+      // index = -1 應插入到開頭 (index 0)
+      // index >= array.length 應插入到結尾
+      var insertAt = Math.max(0, Math.min(index + 1, array.length));
+      for (var _len = arguments.length, items = new Array(_len > 2 ? _len - 2 : 0), _key2 = 2; _key2 < _len; _key2++) {
+        items[_key2 - 2] = arguments[_key2];
+      }
+      array.splice.apply(array, [insertAt, 0].concat(items));
+      // 注意：此函式直接修改了傳入的 array，行為與原函式不同（原函式隱式返回 undefined 但修改了 array）
+      // 如果需要保持原函式返回 undefined 的行為，可以不加 return
+      // 如果希望返回修改後的 array，可以 return array;
     });
     /** 西元年 轉成 民國年
      * full = 是否打印出全名 民國 ＸＸ 年
@@ -349,9 +353,9 @@ var Utiller = /*#__PURE__*/function () {
       var predicate = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : function (value) {
         return _lodash["default"].isUndefined(value);
       };
-      for (var key in object) {
-        if (predicate(object[key])) {
-          delete object[key];
+      for (var _key4 in object) {
+        if (predicate(object[_key4])) {
+          delete object[_key4];
         }
       }
     }
@@ -471,8 +475,8 @@ var Utiller = /*#__PURE__*/function () {
       var self = this;
       var idOfCurrentTimeoutTask = this.mapOfIdNTimeoutId[id];
       if (idOfCurrentTimeoutTask) clearTimeout(idOfCurrentTimeoutTask);
-      for (var _len3 = arguments.length, params = new Array(_len3 > 3 ? _len3 - 3 : 0), _key4 = 3; _key4 < _len3; _key4++) {
-        params[_key4 - 3] = arguments[_key4];
+      for (var _len3 = arguments.length, params = new Array(_len3 > 3 ? _len3 - 3 : 0), _key5 = 3; _key5 < _len3; _key5++) {
+        params[_key5 - 3] = arguments[_key5];
       }
       var idOfTimeoutTask = setTimeout.apply(void 0, [/*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee4() {
         return _regenerator["default"].wrap(function _callee4$(_context4) {
@@ -495,8 +499,8 @@ var Utiller = /*#__PURE__*/function () {
     value: function printLogMessage(message) {
       var error = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
       if (!this.isProductionEnvironment()) {
-        for (var _len4 = arguments.length, infos = new Array(_len4 > 2 ? _len4 - 2 : 0), _key5 = 2; _key5 < _len4; _key5++) {
-          infos[_key5 - 2] = arguments[_key5];
+        for (var _len4 = arguments.length, infos = new Array(_len4 > 2 ? _len4 - 2 : 0), _key6 = 2; _key6 < _len4; _key6++) {
+          infos[_key6 - 2] = arguments[_key6];
         }
         if (error) {
           this.appendError.apply(this, [message].concat(infos));
@@ -599,8 +603,8 @@ var Utiller = /*#__PURE__*/function () {
   }, {
     key: "isOrEquals",
     value: function isOrEquals(target) {
-      for (var _len5 = arguments.length, several = new Array(_len5 > 1 ? _len5 - 1 : 0), _key6 = 1; _key6 < _len5; _key6++) {
-        several[_key6 - 1] = arguments[_key6];
+      for (var _len5 = arguments.length, several = new Array(_len5 > 1 ? _len5 - 1 : 0), _key7 = 1; _key7 < _len5; _key7++) {
+        several[_key7 - 1] = arguments[_key7];
       }
       for (var _i = 0, _several = several; _i < _several.length; _i++) {
         var each = _several[_i];
@@ -611,8 +615,8 @@ var Utiller = /*#__PURE__*/function () {
   }, {
     key: "isAndEquals",
     value: function isAndEquals() {
-      for (var _len6 = arguments.length, predicates = new Array(_len6), _key7 = 0; _key7 < _len6; _key7++) {
-        predicates[_key7] = arguments[_key7];
+      for (var _len6 = arguments.length, predicates = new Array(_len6), _key8 = 0; _key8 < _len6; _key8++) {
+        predicates[_key8] = arguments[_key8];
       }
       for (var _i2 = 0, _predicates = predicates; _i2 < _predicates.length; _i2++) {
         var predicate = _predicates[_i2];
@@ -634,8 +638,8 @@ var Utiller = /*#__PURE__*/function () {
   }, {
     key: "or",
     value: function or() {
-      for (var _len7 = arguments.length, booleans = new Array(_len7), _key8 = 0; _key8 < _len7; _key8++) {
-        booleans[_key8] = arguments[_key8];
+      for (var _len7 = arguments.length, booleans = new Array(_len7), _key9 = 0; _key9 < _len7; _key9++) {
+        booleans[_key9] = arguments[_key9];
       }
       for (var _i3 = 0, _booleans = booleans; _i3 < _booleans.length; _i3++) {
         var boo = _booleans[_i3];
@@ -646,8 +650,8 @@ var Utiller = /*#__PURE__*/function () {
   }, {
     key: "and",
     value: function and() {
-      for (var _len8 = arguments.length, booleans = new Array(_len8), _key9 = 0; _key9 < _len8; _key9++) {
-        booleans[_key9] = arguments[_key9];
+      for (var _len8 = arguments.length, booleans = new Array(_len8), _key10 = 0; _key10 < _len8; _key10++) {
+        booleans[_key10] = arguments[_key10];
       }
       for (var _i4 = 0, _booleans2 = booleans; _i4 < _booleans2.length; _i4++) {
         var boo = _booleans2[_i4];
@@ -673,8 +677,8 @@ var Utiller = /*#__PURE__*/function () {
   }, {
     key: "getExistOne",
     value: function getExistOne() {
-      for (var _len9 = arguments.length, candidates = new Array(_len9), _key10 = 0; _key10 < _len9; _key10++) {
-        candidates[_key10] = arguments[_key10];
+      for (var _len9 = arguments.length, candidates = new Array(_len9), _key11 = 0; _key11 < _len9; _key11++) {
+        candidates[_key11] = arguments[_key11];
       }
       for (var _i5 = 0, _candidates = candidates; _i5 < _candidates.length; _i5++) {
         var candidate = _candidates[_i5];
@@ -693,8 +697,8 @@ var Utiller = /*#__PURE__*/function () {
   }, {
     key: "isAndWith",
     value: function isAndWith(self, predicate) {
-      for (var _len10 = arguments.length, several = new Array(_len10 > 2 ? _len10 - 2 : 0), _key11 = 2; _key11 < _len10; _key11++) {
-        several[_key11 - 2] = arguments[_key11];
+      for (var _len10 = arguments.length, several = new Array(_len10 > 2 ? _len10 - 2 : 0), _key12 = 2; _key12 < _len10; _key12++) {
+        several[_key12 - 2] = arguments[_key12];
       }
       for (var _i6 = 0, _several2 = several; _i6 < _several2.length; _i6++) {
         var each = _several2[_i6];
@@ -925,8 +929,8 @@ var Utiller = /*#__PURE__*/function () {
       var result = new Array(n),
         len = arr.length,
         taken = new Array(len);
-      if (n > len) n = len;
-      if (n > len) throw new RangeError("getShuffledArrayWithLimitCount: more elements taken than available");
+      if (n > len) n = len; // Handle n > arr.length case gracefully
+
       while (n--) {
         var x = Math.floor(Math.random() * len);
         result[n] = arr[x in taken ? taken[x] : x];
@@ -1036,16 +1040,15 @@ var Utiller = /*#__PURE__*/function () {
   }, {
     key: "getShuffledArrayWithLimitCount",
     value: function getShuffledArrayWithLimitCount(arr, n) {
-      var shuffled = _lodash["default"].shuffle(arr);
-      return _lodash["default"].take(shuffled, n);
+      return this.getShuffledArrayWithLimitCountHighPerformance(arr, n); // 使用已優化的版本
     }
   }, {
     key: "getRandomItemOfArray",
     value: /** ignore 就是黑名單的意思 */
     function getRandomItemOfArray(array) {
       if (!_lodash["default"].isArray(array)) throw new _exceptioner["default"](9999, "why are you so stupid, typeof array should be array, not ==> ".concat(array, " "));
-      for (var _len11 = arguments.length, ignores = new Array(_len11 > 1 ? _len11 - 1 : 0), _key12 = 1; _key12 < _len11; _key12++) {
-        ignores[_key12 - 1] = arguments[_key12];
+      for (var _len11 = arguments.length, ignores = new Array(_len11 > 1 ? _len11 - 1 : 0), _key13 = 1; _key13 < _len11; _key13++) {
+        ignores[_key13 - 1] = arguments[_key13];
       }
       var filter = _lodash["default"].without.apply(_lodash["default"], [array].concat(ignores));
       var target = _lodash["default"].size(filter) > 0 ? filter : array;
@@ -1066,8 +1069,8 @@ var Utiller = /*#__PURE__*/function () {
   }, {
     key: "appendMapOfKeyArray",
     value: function appendMapOfKeyArray(object, key) {
-      for (var _len12 = arguments.length, value = new Array(_len12 > 2 ? _len12 - 2 : 0), _key13 = 2; _key13 < _len12; _key13++) {
-        value[_key13 - 2] = arguments[_key13];
+      for (var _len12 = arguments.length, value = new Array(_len12 > 2 ? _len12 - 2 : 0), _key14 = 2; _key14 < _len12; _key14++) {
+        value[_key14 - 2] = arguments[_key14];
       }
       if (this.isUndefinedNullEmpty(object[key])) {
         object[key] = [].concat(value);
@@ -1078,6 +1081,13 @@ var Utiller = /*#__PURE__*/function () {
     }
 
     /**
+    * 優化版本：針對基於唯一 Key 的合併
+    * @param {Array} major - 主要陣列
+    * @param {Array} sub - 次要陣列
+    * @param {string} key - 用於匹配的唯一鍵名 (e.g., 'id')
+    * @returns {Array} - 合併後的新陣列
+    *
+    *
     * util.getMergedArrayBy(
     [{id: 123, name: 'david'}, {id: 321, name: 'Joe'}],
     [{id: 321, age: 13}, {id: 123, age: 30}],
@@ -1095,23 +1105,24 @@ var Utiller = /*#__PURE__*/function () {
     value: function getMergedArrayBy() {
       var major = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
       var sub = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [];
-      var predicate = arguments.length > 2 ? arguments[2] : undefined;
-      /** predicate可以只帶入屬性質 */
-      if (_lodash["default"].isString(predicate)) {
-        var attribute = predicate;
-        predicate = function predicate(item1, item2) {
-          return _lodash["default"].isEqual(item1[attribute], item2[attribute]);
-        };
-      } else {
-        predicate = _lodash["default"].isFunction(predicate) ? predicate : function () {
-          return true;
-        };
+      var key = arguments.length > 2 ? arguments[2] : undefined;
+      if (!key || major.length === 0 || sub.length === 0) {
+        // 如果沒有 key 或任一陣列為空，無法優化或無需合併，回傳 major 的淺拷貝
+        return (0, _toConsumableArray2["default"])(major);
       }
-      return major.map(function (item1) {
-        return _objectSpread(_objectSpread({}, _lodash["default"].find(sub, function (item2) {
-          return predicate(item1, item2);
-        })), item1);
+
+      // 1. 將 sub 陣列轉換為以 key 為鍵的 Map，時間複雜度 O(N)
+      var subMap = new Map(sub.map(function (item) {
+        return [item[key], item];
+      }));
+
+      // 2. 遍歷 major 陣列，從 Map 中查找匹配項，時間複雜度 O(M)
+      return major.map(function (majorItem) {
+        var subItem = subMap.get(majorItem[key]);
+        // 合併找到的 subItem 和 majorItem，majorItem 的屬性優先
+        return _objectSpread(_objectSpread({}, subItem || {}), majorItem);
       });
+      // 整體時間複雜度約為 O(M + N)
     }
   }, {
     key: "getShuffledItemFromArray",
@@ -1221,8 +1232,8 @@ var Utiller = /*#__PURE__*/function () {
     value: function replaceAllWithSets() {
       var string = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : "";
       var after = string;
-      for (var _len13 = arguments.length, patterns = new Array(_len13 > 1 ? _len13 - 1 : 0), _key14 = 1; _key14 < _len13; _key14++) {
-        patterns[_key14 - 1] = arguments[_key14];
+      for (var _len13 = arguments.length, patterns = new Array(_len13 > 1 ? _len13 - 1 : 0), _key15 = 1; _key15 < _len13; _key15++) {
+        patterns[_key15 - 1] = arguments[_key15];
       }
       for (var _i7 = 0, _patterns = patterns; _i7 < _patterns.length; _i7++) {
         var pattern = _patterns[_i7];
@@ -1250,29 +1261,47 @@ var Utiller = /*#__PURE__*/function () {
     key: "deepFlat",
     value: function deepFlat(collection) {
       var sign = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : "_";
-      var _self = "";
-      if (_lodash["default"].isArray(collection)) {
-        var _iterator4 = _createForOfIteratorHelper(collection),
-          _step4;
-        try {
-          for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
-            var o = _step4.value;
-            _self += (_lodash["default"].isEmpty(_self) ? "" : sign) + this.deepFlat(o);
+      var result = "";
+      var stack = [[collection, ""]]; // 儲存 [項目, 目前的前綴]
+
+      while (stack.length > 0) {
+        var _stack$pop = stack.pop(),
+          _stack$pop2 = (0, _slicedToArray2["default"])(_stack$pop, 2),
+          current = _stack$pop2[0],
+          prefix = _stack$pop2[1];
+        if (_lodash["default"].isArray(current)) {
+          // 將陣列元素反向推入堆疊以保持順序
+          for (var i = current.length - 1; i >= 0; i--) {
+            stack.push([current[i], prefix]); // 陣列元素不加前綴
+          }
+        } else if (_lodash["default"].isObject(current)) {
+          // 將物件鍵值對反向推入堆疊
+          var keys = Object.keys(current);
+          for (var _i8 = keys.length - 1; _i8 >= 0; _i8--) {
+            var _key16 = keys[_i8];
+            // 值推入堆疊，前綴包含當前鍵
+            stack.push([current[_key16], prefix + _key16 + sign]);
+          }
+        } else {
+          // 基本型別，添加到結果字串
+          var valueString = _lodash["default"].trim(String(current)); // 確保轉為字串並去除頭尾空白
+          if (valueString.length > 0) {
+            // 避免添加空字串或只有空白的字串
+            result += (result.length > 0 ? sign : "") + prefix + valueString;
+          } else if (prefix.length > 0 && result.length > 0) {
+            // 如果值為空但有前綴，且結果已非空，則添加分隔符
+            result += sign;
+          } else if (prefix.length > 0 && result.length === 0) {
+            // 如果值為空但有前綴，且結果為空，則只添加前綴（去掉末尾的 sign）
+            result += prefix.endsWith(sign) ? prefix.slice(0, -sign.length) : prefix;
           }
-        } catch (err) {
-          _iterator4.e(err);
-        } finally {
-          _iterator4.f();
-        }
-        return _self;
-      } else if (_lodash["default"].isObject(collection)) {
-        for (var key in collection) {
-          _self += (_lodash["default"].isEmpty(_self) ? "" : sign) + key + sign + this.deepFlat(collection[key]);
         }
-        return _self;
-      } else {
-        return _lodash["default"].trim(collection);
       }
+      // 最後可能需要處理結尾多餘的 sign
+      if (result.endsWith(sign)) {
+        result = result.slice(0, -sign.length);
+      }
+      return result;
     }
   }, {
     key: "joinEscapeChar",
@@ -1294,11 +1323,11 @@ var Utiller = /*#__PURE__*/function () {
   }, {
     key: "getValueOfPriority",
     value: function getValueOfPriority() {
-      for (var _len14 = arguments.length, compares = new Array(_len14), _key15 = 0; _key15 < _len14; _key15++) {
-        compares[_key15] = arguments[_key15];
+      for (var _len14 = arguments.length, compares = new Array(_len14), _key17 = 0; _key17 < _len14; _key17++) {
+        compares[_key17] = arguments[_key17];
       }
-      for (var _i8 = 0, _compares = compares; _i8 < _compares.length; _i8++) {
-        var compare = _compares[_i8];
+      for (var _i9 = 0, _compares = compares; _i9 < _compares.length; _i9++) {
+        var compare = _compares[_i9];
         if (!this.isUndefinedNullEmpty(compare)) return compare;
       }
       return undefined;
@@ -1307,20 +1336,20 @@ var Utiller = /*#__PURE__*/function () {
     key: "asyncPool",
     value: function () {
       var _asyncPool = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee7(poolLimit, array, iteratorFn) {
-        var ret, executing, _iterator5, _step5, _loop;
+        var ret, executing, _iterator4, _step4, _loop;
         return _regenerator["default"].wrap(function _callee7$(_context8) {
           while (1) switch (_context8.prev = _context8.next) {
             case 0:
               ret = [];
               executing = [];
-              _iterator5 = _createForOfIteratorHelper(array);
+              _iterator4 = _createForOfIteratorHelper(array);
               _context8.prev = 3;
               _loop = /*#__PURE__*/_regenerator["default"].mark(function _loop() {
                 var item, p, e;
                 return _regenerator["default"].wrap(function _loop$(_context7) {
                   while (1) switch (_context7.prev = _context7.next) {
                     case 0:
-                      item = _step5.value;
+                      item = _step4.value;
                       p = Promise.resolve().then(function () {
                         return iteratorFn(item, array);
                       });
@@ -1345,9 +1374,9 @@ var Utiller = /*#__PURE__*/function () {
                   }
                 }, _loop);
               });
-              _iterator5.s();
+              _iterator4.s();
             case 6:
-              if ((_step5 = _iterator5.n()).done) {
+              if ((_step4 = _iterator4.n()).done) {
                 _context8.next = 10;
                 break;
               }
@@ -1361,10 +1390,10 @@ var Utiller = /*#__PURE__*/function () {
             case 12:
               _context8.prev = 12;
               _context8.t1 = _context8["catch"](3);
-              _iterator5.e(_context8.t1);
+              _iterator4.e(_context8.t1);
             case 15:
               _context8.prev = 15;
-              _iterator5.f();
+              _iterator4.f();
               return _context8.finish(15);
             case 18:
               return _context8.abrupt("return", Promise.all(ret));
@@ -1382,11 +1411,11 @@ var Utiller = /*#__PURE__*/function () {
   }, {
     key: "getAttrValueInSequence",
     value: function getAttrValueInSequence(info) {
-      for (var _len15 = arguments.length, attrs = new Array(_len15 > 1 ? _len15 - 1 : 0), _key16 = 1; _key16 < _len15; _key16++) {
-        attrs[_key16 - 1] = arguments[_key16];
+      for (var _len15 = arguments.length, attrs = new Array(_len15 > 1 ? _len15 - 1 : 0), _key18 = 1; _key18 < _len15; _key18++) {
+        attrs[_key18 - 1] = arguments[_key18];
       }
-      for (var _i9 = 0, _attrs = attrs; _i9 < _attrs.length; _i9++) {
-        var attr = _attrs[_i9];
+      for (var _i10 = 0, _attrs = attrs; _i10 < _attrs.length; _i10++) {
+        var attr = _attrs[_i10];
         if (!_lodash["default"].isEmpty(info[attr])) {
           return info[attr];
         }
@@ -1525,11 +1554,11 @@ var Utiller = /*#__PURE__*/function () {
     function getSliceArrayOfSpecificIndexes(array) {
       var items = [];
       var size = _lodash["default"].size(array);
-      for (var _len16 = arguments.length, indexes = new Array(_len16 > 1 ? _len16 - 1 : 0), _key17 = 1; _key17 < _len16; _key17++) {
-        indexes[_key17 - 1] = arguments[_key17];
+      for (var _len16 = arguments.length, indexes = new Array(_len16 > 1 ? _len16 - 1 : 0), _key19 = 1; _key19 < _len16; _key19++) {
+        indexes[_key19 - 1] = arguments[_key19];
       }
-      for (var _i10 = 0, _indexes = indexes; _i10 < _indexes.length; _i10++) {
-        var index = _indexes[_i10];
+      for (var _i11 = 0, _indexes = indexes; _i11 < _indexes.length; _i11++) {
+        var index = _indexes[_i11];
         if (!_lodash["default"].isNumber(index)) throw new _exceptioner["default"](9999, "59941278 index should be number => ".concat(index, ", ").concat(array));
         if (index > size - 1) throw new _exceptioner["default"](9999, "5994123 index=>".concat(index, " is not valid, exceed than array size=").concat(size, ", ").concat(array));
         items.push(_lodash["default"].nth(array, index));
@@ -1594,11 +1623,11 @@ var Utiller = /*#__PURE__*/function () {
   }, {
     key: "isAndConditionOfUndefinedNullEmpty",
     value: function isAndConditionOfUndefinedNullEmpty() {
-      for (var _len17 = arguments.length, objs = new Array(_len17), _key18 = 0; _key18 < _len17; _key18++) {
-        objs[_key18] = arguments[_key18];
+      for (var _len17 = arguments.length, objs = new Array(_len17), _key20 = 0; _key20 < _len17; _key20++) {
+        objs[_key20] = arguments[_key20];
       }
-      for (var _i11 = 0, _objs = objs; _i11 < _objs.length; _i11++) {
-        var obj = _objs[_i11];
+      for (var _i12 = 0, _objs = objs; _i12 < _objs.length; _i12++) {
+        var obj = _objs[_i12];
         if (!this.isUndefinedNullEmpty(obj)) return false;
       }
       return true;
@@ -1606,11 +1635,11 @@ var Utiller = /*#__PURE__*/function () {
   }, {
     key: "isOrConditionOfUndefinedNullEmpty",
     value: function isOrConditionOfUndefinedNullEmpty() {
-      for (var _len18 = arguments.length, objs = new Array(_len18), _key19 = 0; _key19 < _len18; _key19++) {
-        objs[_key19] = arguments[_key19];
+      for (var _len18 = arguments.length, objs = new Array(_len18), _key21 = 0; _key21 < _len18; _key21++) {
+        objs[_key21] = arguments[_key21];
       }
-      for (var _i12 = 0, _objs2 = objs; _i12 < _objs2.length; _i12++) {
-        var obj = _objs2[_i12];
+      for (var _i13 = 0, _objs2 = objs; _i13 < _objs2.length; _i13++) {
+        var obj = _objs2[_i13];
         if (this.isUndefinedNullEmpty(obj)) return true;
       }
       return false;
@@ -1625,17 +1654,17 @@ var Utiller = /*#__PURE__*/function () {
       };
       var separator = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : "\n";
       var segments = string.split(separator);
-      var _iterator6 = _createForOfIteratorHelper(segments),
-        _step6;
+      var _iterator5 = _createForOfIteratorHelper(segments),
+        _step5;
       try {
-        for (_iterator6.s(); !(_step6 = _iterator6.n()).done;) {
-          var segment = _step6.value;
+        for (_iterator5.s(); !(_step5 = _iterator5.n()).done;) {
+          var segment = _step5.value;
           predict(segment, _lodash["default"].indexOf(segments, segment), segments);
         }
       } catch (err) {
-        _iterator6.e(err);
+        _iterator5.e(err);
       } finally {
-        _iterator6.f();
+        _iterator5.f();
       }
       return segments.join(separator);
     }
@@ -1662,8 +1691,8 @@ var Utiller = /*#__PURE__*/function () {
     key: "getNormalizedStringNotStartWith",
     value: function getNormalizedStringNotStartWith(string) {
       var _this2 = this;
-      for (var _len19 = arguments.length, predicate = new Array(_len19 > 1 ? _len19 - 1 : 0), _key20 = 1; _key20 < _len19; _key20++) {
-        predicate[_key20 - 1] = arguments[_key20];
+      for (var _len19 = arguments.length, predicate = new Array(_len19 > 1 ? _len19 - 1 : 0), _key22 = 1; _key22 < _len19; _key22++) {
+        predicate[_key22 - 1] = arguments[_key22];
       }
       string = this.toCDB(string);
       var after = _lodash["default"].join(_lodash["default"].dropWhile(string, function (each) {
@@ -1677,8 +1706,8 @@ var Utiller = /*#__PURE__*/function () {
     key: "getNormalizedStringNotEndWith",
     value: function getNormalizedStringNotEndWith(string) {
       var _this3 = this;
-      for (var _len20 = arguments.length, predicate = new Array(_len20 > 1 ? _len20 - 1 : 0), _key21 = 1; _key21 < _len20; _key21++) {
-        predicate[_key21 - 1] = arguments[_key21];
+      for (var _len20 = arguments.length, predicate = new Array(_len20 > 1 ? _len20 - 1 : 0), _key23 = 1; _key23 < _len20; _key23++) {
+        predicate[_key23 - 1] = arguments[_key23];
       }
       string = this.toCDB(string);
       var after = _lodash["default"].join(_lodash["default"].dropRightWhile(string, function (each) {
@@ -1890,25 +1919,25 @@ var Utiller = /*#__PURE__*/function () {
   }, {
     key: "isStringContainInLines",
     value: function isStringContainInLines(context, key) {
-      var _iterator7 = _createForOfIteratorHelper(_lodash["default"].split(context, "\n")),
-        _step7;
+      var _iterator6 = _createForOfIteratorHelper(_lodash["default"].split(context, "\n")),
+        _step6;
       try {
-        for (_iterator7.s(); !(_step7 = _iterator7.n()).done;) {
-          var each = _step7.value;
+        for (_iterator6.s(); !(_step6 = _iterator6.n()).done;) {
+          var each = _step6.value;
           if (this.has(each, key)) return true;
         }
       } catch (err) {
-        _iterator7.e(err);
+        _iterator6.e(err);
       } finally {
-        _iterator7.f();
+        _iterator6.f();
       }
       return false;
     }
   }, {
     key: "camel",
     value: function camel() {
-      for (var _len21 = arguments.length, words = new Array(_len21), _key22 = 0; _key22 < _len21; _key22++) {
-        words[_key22] = arguments[_key22];
+      for (var _len21 = arguments.length, words = new Array(_len21), _key24 = 0; _key24 < _len21; _key24++) {
+        words[_key24] = arguments[_key24];
       }
       return _lodash["default"].camelCase(words.join("_"));
     }
@@ -1928,17 +1957,17 @@ var Utiller = /*#__PURE__*/function () {
     key: "array2Obj",
     value: function array2Obj(array) {
       var obj = {};
-      var _iterator8 = _createForOfIteratorHelper(array),
-        _step8;
+      var _iterator7 = _createForOfIteratorHelper(array),
+        _step7;
       try {
-        for (_iterator8.s(); !(_step8 = _iterator8.n()).done;) {
-          var each = _step8.value;
+        for (_iterator7.s(); !(_step7 = _iterator7.n()).done;) {
+          var each = _step7.value;
           obj["".concat(this.getObjectKey(each))] = this.getObjectValue(each);
         }
       } catch (err) {
-        _iterator8.e(err);
+        _iterator7.e(err);
       } finally {
-        _iterator8.f();
+        _iterator7.f();
       }
       return obj;
     }
@@ -1952,23 +1981,23 @@ var Utiller = /*#__PURE__*/function () {
     key: "arrayToObjWith",
     value: function arrayToObjWith(array, predicate) {
       var obj = {};
-      var _iterator9 = _createForOfIteratorHelper(array),
-        _step9;
+      var _iterator8 = _createForOfIteratorHelper(array),
+        _step8;
       try {
-        for (_iterator9.s(); !(_step9 = _iterator9.n()).done;) {
-          var item = _step9.value;
-          var key = predicate(item);
-          var content = obj[key];
+        for (_iterator8.s(); !(_step8 = _iterator8.n()).done;) {
+          var item = _step8.value;
+          var _key25 = predicate(item);
+          var content = obj[_key25];
           if (content && _lodash["default"].isArray(content)) {
             content.push(item);
           } else {
-            obj[key] = [item];
+            obj[_key25] = [item];
           }
         }
       } catch (err) {
-        _iterator9.e(err);
+        _iterator8.e(err);
       } finally {
-        _iterator9.f();
+        _iterator8.f();
       }
       return obj;
     }
@@ -2272,36 +2301,36 @@ var Utiller = /*#__PURE__*/function () {
     key: "toObjectMap",
     value: function toObjectMap(array) {
       var newbies = [];
-      for (var _len22 = arguments.length, rules = new Array(_len22 > 1 ? _len22 - 1 : 0), _key23 = 1; _key23 < _len22; _key23++) {
-        rules[_key23 - 1] = arguments[_key23];
+      for (var _len22 = arguments.length, rules = new Array(_len22 > 1 ? _len22 - 1 : 0), _key26 = 1; _key26 < _len22; _key26++) {
+        rules[_key26 - 1] = arguments[_key26];
       }
-      var _iterator10 = _createForOfIteratorHelper(array),
-        _step10;
+      var _iterator9 = _createForOfIteratorHelper(array),
+        _step9;
       try {
-        for (_iterator10.s(); !(_step10 = _iterator10.n()).done;) {
-          var each = _step10.value;
+        for (_iterator9.s(); !(_step9 = _iterator9.n()).done;) {
+          var each = _step9.value;
           var object = {};
-          var _iterator11 = _createForOfIteratorHelper(rules),
-            _step11;
+          var _iterator10 = _createForOfIteratorHelper(rules),
+            _step10;
           try {
-            for (_iterator11.s(); !(_step11 = _iterator11.n()).done;) {
-              var rule = _step11.value;
+            for (_iterator10.s(); !(_step10 = _iterator10.n()).done;) {
+              var rule = _step10.value;
               var func = rule.func ? rule.func : function (stmt) {
                 return stmt;
               };
               object[rule.to] = this.isUndefinedNullEmpty(rule.from) || !_lodash["default"].isObject(each) ? func(each) : func(each[rule.from]);
             }
           } catch (err) {
-            _iterator11.e(err);
+            _iterator10.e(err);
           } finally {
-            _iterator11.f();
+            _iterator10.f();
           }
           newbies.push(object);
         }
       } catch (err) {
-        _iterator10.e(err);
+        _iterator9.e(err);
       } finally {
-        _iterator10.f();
+        _iterator9.f();
       }
       return newbies;
     }
@@ -2318,47 +2347,47 @@ var Utiller = /*#__PURE__*/function () {
   }, {
     key: "exeAll",
     value: function exeAll(collection) {
-      for (var _len23 = arguments.length, funcs = new Array(_len23 > 1 ? _len23 - 1 : 0), _key24 = 1; _key24 < _len23; _key24++) {
-        funcs[_key24 - 1] = arguments[_key24];
+      for (var _len23 = arguments.length, funcs = new Array(_len23 > 1 ? _len23 - 1 : 0), _key27 = 1; _key27 < _len23; _key27++) {
+        funcs[_key27 - 1] = arguments[_key27];
       }
       if (_lodash["default"].isArray(collection)) {
-        var _iterator12 = _createForOfIteratorHelper(collection),
-          _step12;
+        var _iterator11 = _createForOfIteratorHelper(collection),
+          _step11;
         try {
-          for (_iterator12.s(); !(_step12 = _iterator12.n()).done;) {
-            var each = _step12.value;
-            var _iterator13 = _createForOfIteratorHelper(funcs),
-              _step13;
+          for (_iterator11.s(); !(_step11 = _iterator11.n()).done;) {
+            var each = _step11.value;
+            var _iterator12 = _createForOfIteratorHelper(funcs),
+              _step12;
             try {
-              for (_iterator13.s(); !(_step13 = _iterator13.n()).done;) {
-                var func = _step13.value;
+              for (_iterator12.s(); !(_step12 = _iterator12.n()).done;) {
+                var func = _step12.value;
                 func(each);
               }
             } catch (err) {
-              _iterator13.e(err);
+              _iterator12.e(err);
             } finally {
-              _iterator13.f();
+              _iterator12.f();
             }
           }
           /** 陣列專屬邏輯 */
         } catch (err) {
-          _iterator12.e(err);
+          _iterator11.e(err);
         } finally {
-          _iterator12.f();
+          _iterator11.f();
         }
       } else if (_lodash["default"].isObject(collection)) {
         for (var _each in collection) {
-          var _iterator14 = _createForOfIteratorHelper(funcs),
-            _step14;
+          var _iterator13 = _createForOfIteratorHelper(funcs),
+            _step13;
           try {
-            for (_iterator14.s(); !(_step14 = _iterator14.n()).done;) {
-              var _func = _step14.value;
+            for (_iterator13.s(); !(_step13 = _iterator13.n()).done;) {
+              var _func = _step13.value;
               collection[_each] = _func(collection[_each]);
             }
           } catch (err) {
-            _iterator14.e(err);
+            _iterator13.e(err);
           } finally {
-            _iterator14.f();
+            _iterator13.f();
           }
         }
         /** 物件專屬邏輯 */
@@ -2374,9 +2403,9 @@ var Utiller = /*#__PURE__*/function () {
         return true;
       };
       var collection = {};
-      for (var key in major) {
-        if (predicate(major, minor, key)) {
-          collection[key] = major[key];
+      for (var _key28 in major) {
+        if (predicate(major, minor, _key28)) {
+          collection[_key28] = major[_key28];
         }
       }
       return collection;
@@ -2423,8 +2452,8 @@ var Utiller = /*#__PURE__*/function () {
     key: "isObjectContainAndEqual",
     value: function isObjectContainAndEqual(targetObject, mainObject) {
       var equal = true;
-      for (var key in targetObject) {
-        if (mainObject[key] === undefined || mainObject[key] !== targetObject[key]) {
+      for (var _key29 in targetObject) {
+        if (mainObject[_key29] === undefined || mainObject[_key29] !== targetObject[_key29]) {
           equal = false;
           break;
         }
@@ -2465,11 +2494,11 @@ var Utiller = /*#__PURE__*/function () {
     key: "toObjectWithAttributeKey",
     value: function toObjectWithAttributeKey(array, attrKeyOfPK) {
       var object = {};
-      var _iterator15 = _createForOfIteratorHelper(array),
-        _step15;
+      var _iterator14 = _createForOfIteratorHelper(array),
+        _step14;
       try {
-        for (_iterator15.s(); !(_step15 = _iterator15.n()).done;) {
-          var each = _step15.value;
+        for (_iterator14.s(); !(_step14 = _iterator14.n()).done;) {
+          var each = _step14.value;
           var pk = each[attrKeyOfPK];
           if (this.isUndefinedNullEmpty(pk)) {
             throw new _exceptioner["default"](9999, "48157232 pk can't be empty => '".concat(pk, "'"));
@@ -2477,9 +2506,9 @@ var Utiller = /*#__PURE__*/function () {
           object[pk] = each;
         }
       } catch (err) {
-        _iterator15.e(err);
+        _iterator14.e(err);
       } finally {
-        _iterator15.f();
+        _iterator14.f();
       }
       return object;
     }
@@ -2502,11 +2531,11 @@ var Utiller = /*#__PURE__*/function () {
   }, {
     key: "getStateOfStringContainsSign",
     value: function getStateOfStringContainsSign(string) {
-      for (var _len24 = arguments.length, signs = new Array(_len24 > 1 ? _len24 - 1 : 0), _key25 = 1; _key25 < _len24; _key25++) {
-        signs[_key25 - 1] = arguments[_key25];
+      for (var _len24 = arguments.length, signs = new Array(_len24 > 1 ? _len24 - 1 : 0), _key30 = 1; _key30 < _len24; _key30++) {
+        signs[_key30 - 1] = arguments[_key30];
       }
-      for (var _i13 = 0, _signs = signs; _i13 < _signs.length; _i13++) {
-        var sign = _signs[_i13];
+      for (var _i14 = 0, _signs = signs; _i14 < _signs.length; _i14++) {
+        var sign = _signs[_i14];
         if (this.has(string, sign)) {
           return {
             exists: true,
@@ -2525,8 +2554,8 @@ var Utiller = /*#__PURE__*/function () {
     key: "constraintOfParam",
     value: function constraintOfParam(collection, type) {
       var result = false;
-      for (var _len25 = arguments.length, others = new Array(_len25 > 2 ? _len25 - 2 : 0), _key26 = 2; _key26 < _len25; _key26++) {
-        others[_key26 - 2] = arguments[_key26];
+      for (var _len25 = arguments.length, others = new Array(_len25 > 2 ? _len25 - 2 : 0), _key31 = 2; _key31 < _len25; _key31++) {
+        others[_key31 - 2] = arguments[_key31];
       }
       var validOfOthersCondition = _lodash["default"].isEmpty(others) ? true : this.and.apply(this, (0, _toConsumableArray2["default"])(others.map(function (each) {
         return each.logic;
@@ -2599,26 +2628,26 @@ var Utiller = /*#__PURE__*/function () {
   }, {
     key: "getArrayOfMoveToSpecificIndex",
     value: function getArrayOfMoveToSpecificIndex(array, from, to) {
-      /* #move - Moves an array item from one position in an array to another.
-      Note: This is a pure function so a new array will be returned, instead
-      of altering the array argument.
-      Arguments:
-      1. array     (String) : Array in which to move an item.         (required)
-      2. moveIndex (Object) : The index of the item to move.          (required)
-      3. toIndex   (Object) : The index to move item at moveIndex to. (required)
-      */
-      var item = array[from];
+      if (!Array.isArray(array)) {
+        throw new Error("First argument must be an array.");
+      }
       var length = array.length;
-      var diff = from - to;
-      if (diff > 0) {
-        // move left
-        return [].concat((0, _toConsumableArray2["default"])(array.slice(0, to)), [item], (0, _toConsumableArray2["default"])(array.slice(to, from)), (0, _toConsumableArray2["default"])(array.slice(from + 1, length)));
-      } else if (diff < 0) {
-        // move right
-        var targetIndex = to + 1;
-        return [].concat((0, _toConsumableArray2["default"])(array.slice(0, from)), (0, _toConsumableArray2["default"])(array.slice(from + 1, targetIndex)), [item], (0, _toConsumableArray2["default"])(array.slice(targetIndex, length)));
+      // 驗證索引範圍
+      if (from < 0 || from >= length || to < 0 || to >= length) {
+        console.warn("Invalid 'from' or 'to' index for getArrayOfMoveToSpecificIndexOptimized.");
+        // 可以選擇拋出錯誤或返回原陣列的副本
+        // throw new RangeError("Index out of bounds");
+        return (0, _toConsumableArray2["default"])(array); // 返回副本
+      }
+      if (from === to) {
+        return (0, _toConsumableArray2["default"])(array); // 位置相同，無需移動，返回副本
       }
-      return array;
+      var copy = (0, _toConsumableArray2["default"])(array); // 創建副本
+      var _copy$splice = copy.splice(from, 1),
+        _copy$splice2 = (0, _slicedToArray2["default"])(_copy$splice, 1),
+        item = _copy$splice2[0]; // 從副本中移除元素
+      copy.splice(to, 0, item); // 將元素插入到副本的新位置
+      return copy; // 返回修改後的副本
     }
 
     /** 把array裏面的項目移動到指定的index
@@ -2671,17 +2700,17 @@ var Utiller = /*#__PURE__*/function () {
         return l > r ? 1 : -1;
       });
       var checkValue = "";
-      var _iterator16 = _createForOfIteratorHelper(keys),
-        _step16;
+      var _iterator15 = _createForOfIteratorHelper(keys),
+        _step15;
       try {
-        for (_iterator16.s(); !(_step16 = _iterator16.n()).done;) {
-          var key = _step16.value;
-          checkValue += "".concat(key, "=").concat(clone[key], "&");
+        for (_iterator15.s(); !(_step15 = _iterator15.n()).done;) {
+          var _key32 = _step15.value;
+          checkValue += "".concat(_key32, "=").concat(clone[_key32], "&");
         }
       } catch (err) {
-        _iterator16.e(err);
+        _iterator15.e(err);
       } finally {
-        _iterator16.f();
+        _iterator15.f();
       }
       checkValue = "HashKey=".concat(hashKey, "&").concat(checkValue, "HashIV=").concat(hashIV); // There is already an & in the end of checkValue
       checkValue = encodeURIComponent(checkValue).toLowerCase();
@@ -2721,17 +2750,17 @@ var Utiller = /*#__PURE__*/function () {
   }, {
     key: "getSpecifyObjectBy",
     value: function getSpecifyObjectBy(array, predicate) {
-      var _iterator17 = _createForOfIteratorHelper(array),
-        _step17;
+      var _iterator16 = _createForOfIteratorHelper(array),
+        _step16;
       try {
-        for (_iterator17.s(); !(_step17 = _iterator17.n()).done;) {
-          var item = _step17.value;
+        for (_iterator16.s(); !(_step16 = _iterator16.n()).done;) {
+          var item = _step16.value;
           if (predicate(item)) return item;
         }
       } catch (err) {
-        _iterator17.e(err);
+        _iterator16.e(err);
       } finally {
-        _iterator17.f();
+        _iterator16.f();
       }
     }
 
@@ -2760,27 +2789,27 @@ var Utiller = /*#__PURE__*/function () {
       if (this.isUndefinedNullEmpty(content)) {
         throw new _exceptioner["default"](9999, "".concat(idOfError, " content(pay-load) is undefined || empty"));
       }
-      var _iterator18 = _createForOfIteratorHelper(rules),
-        _step18;
+      var _iterator17 = _createForOfIteratorHelper(rules),
+        _step17;
       try {
-        for (_iterator18.s(); !(_step18 = _iterator18.n()).done;) {
-          var rule = _step18.value;
+        for (_iterator17.s(); !(_step17 = _iterator17.n()).done;) {
+          var rule = _step17.value;
           if (_lodash["default"].isString(rule)) {
             if (this.isUndefinedNullEmpty(content[rule])) {
               throw new _exceptioner["default"](9999, "".concat(idOfError, " ATTRIBUTE:'").concat(rule, "' is not Exist"));
             }
           } else if (_lodash["default"].isObject(rule)) {
-            var key = this.getObjectKey(rule);
+            var _key33 = this.getObjectKey(rule);
             var predicate = this.getObjectValue(rule);
-            if (!predicate(content[key])) {
-              throw new _exceptioner["default"](9999, "".concat(idOfError, " ATTRIBUTE:'").concat(key, "' is not valid of custom rule"));
+            if (!predicate(content[_key33])) {
+              throw new _exceptioner["default"](9999, "".concat(idOfError, " ATTRIBUTE:'").concat(_key33, "' is not valid of custom rule"));
             }
           }
         }
       } catch (err) {
-        _iterator18.e(err);
+        _iterator17.e(err);
       } finally {
-        _iterator18.f();
+        _iterator17.f();
       }
       return true;
     }
@@ -2802,28 +2831,28 @@ var Utiller = /*#__PURE__*/function () {
     key: "getArrayOfSummarizeBy",
     value: function getArrayOfSummarizeBy(array, keyOfId, keyOfSum) {
       var obj = {};
-      var _iterator19 = _createForOfIteratorHelper(array),
-        _step19;
+      var _iterator18 = _createForOfIteratorHelper(array),
+        _step18;
       try {
-        for (_iterator19.s(); !(_step19 = _iterator19.n()).done;) {
-          var item = _step19.value;
-          var _key27 = item[keyOfId];
-          if (obj[_key27] !== undefined) {
-            obj[_key27] = obj[_key27] + item[keyOfSum];
+        for (_iterator18.s(); !(_step18 = _iterator18.n()).done;) {
+          var item = _step18.value;
+          var _key35 = item[keyOfId];
+          if (obj[_key35] !== undefined) {
+            obj[_key35] = obj[_key35] + item[keyOfSum];
           } else {
-            obj[_key27] = item[keyOfSum];
+            obj[_key35] = item[keyOfSum];
           }
         }
       } catch (err) {
-        _iterator19.e(err);
+        _iterator18.e(err);
       } finally {
-        _iterator19.f();
+        _iterator18.f();
       }
       var items = [];
-      for (var key in obj) {
+      for (var _key34 in obj) {
         var _obj = {};
-        _obj[keyOfId] = key;
-        _obj[keyOfSum] = obj[key];
+        _obj[keyOfId] = _key34;
+        _obj[keyOfSum] = obj[_key34];
         items.push(_obj);
       }
       return items;
@@ -3174,7 +3203,7 @@ var Utiller = /*#__PURE__*/function () {
           element,
           _len26,
           attributes,
-          _key28,
+          _key36,
           _args10 = arguments;
         return _regenerator["default"].wrap(function _callee9$(_context10) {
           while (1) switch (_context10.prev = _context10.next) {
@@ -3188,8 +3217,8 @@ var Utiller = /*#__PURE__*/function () {
                 _context10.next = 16;
                 break;
               }
-              for (_len26 = _args10.length, attributes = new Array(_len26 > 3 ? _len26 - 3 : 0), _key28 = 3; _key28 < _len26; _key28++) {
-                attributes[_key28 - 3] = _args10[_key28];
+              for (_len26 = _args10.length, attributes = new Array(_len26 > 3 ? _len26 - 3 : 0), _key36 = 3; _key36 < _len26; _key36++) {
+                attributes[_key36 - 3] = _args10[_key36];
               }
               _context10.prev = 6;
               _context10.next = 9;
@@ -3232,7 +3261,7 @@ var Utiller = /*#__PURE__*/function () {
         var element,
           _len27,
           attributes,
-          _key29,
+          _key37,
           _args11 = arguments;
         return _regenerator["default"].wrap(function _callee10$(_context11) {
           while (1) switch (_context11.prev = _context11.next) {
@@ -3241,8 +3270,8 @@ var Utiller = /*#__PURE__*/function () {
               return dom.$(stringOfTrait);
             case 2:
               element = _context11.sent;
-              for (_len27 = _args11.length, attributes = new Array(_len27 > 2 ? _len27 - 2 : 0), _key29 = 2; _key29 < _len27; _key29++) {
-                attributes[_key29 - 2] = _args11[_key29];
+              for (_len27 = _args11.length, attributes = new Array(_len27 > 2 ? _len27 - 2 : 0), _key37 = 2; _key37 < _len27; _key37++) {
+                attributes[_key37 - 2] = _args11[_key37];
               }
               if (this.isUndefinedNullEmpty(element)) {
                 _context11.next = 9;
@@ -3277,8 +3306,9 @@ var Utiller = /*#__PURE__*/function () {
     key: "getSliceArrayOfUnique",
     value:
     /**
-     * 去重數組內容
-     * @param {Array} array - 要去重的數組
+     * 優化版本：根據元素類型選擇最高效的去重方式
+     * @param {Array} array - 要去重的陣列
+     * @param {string} [key] - (可選) 如果是物件陣列，指定用於判斷唯一的屬性鍵名
      * @returns {Array} - 去重後的數組
      *
      * // 使用範例
@@ -3295,15 +3325,30 @@ var Utiller = /*#__PURE__*/function () {
      * console.log(uniqueArray(objects)); // [{'aa': 1, 'bb': 2}, {'cc': 1, 'dd': 2}, {'ee': 4, 'ff': 5}]
      */
     function getSliceArrayOfUnique(array) {
-      if (array.length === 0) return array;
-
-      // 判斷是否為物件數組
-      if (_lodash["default"].isObject(array[0])) {
+      if (!Array.isArray(array) || array.length === 0) {
+        return [];
+      }
+      var firstElement = array[0];
+
+      // 1. 處理物件陣列，且提供了 key
+      if (_lodash["default"].isObject(firstElement) && key) {
+        // 使用 Map 根據 key 去重，效率 O(N)
+        var uniqueMap = new Map(array.map(function (item) {
+          return [item[key], item];
+        }));
+        return Array.from(uniqueMap.values());
+      }
+      // 2. 處理物件陣列，但未提供 key (或 key 無效)
+      else if (_lodash["default"].isObject(firstElement)) {
+        // 回退到 lodash 的深度比較，效率較低 O(N^2)
+        console.warn("getSliceArrayOfUniqueOptimized: No key provided for object array, using potentially slow deep comparison.");
         return _lodash["default"].uniqWith(array, _lodash["default"].isEqual);
       }
-
-      // 默認處理為簡單數組
-      return _lodash["default"].uniq(array);
+      // 3. 處理基本型別陣列 (string, number, boolean, null, undefined, symbol)
+      else {
+        // 使用 Set 去重，效率 O(N)
+        return Array.from(new Set(array));
+      }
     }
   }]);
 }();

package/package.json

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

package/template/sample.package.json

@@ -11,7 +11,7 @@
   "license": "ISC",
   "dependencies": {
     "configerer": "^1.0.11",
-    "utiller": "^1.0.282",
+    "utiller": "^1.0.284",
     "linepayer": "^1.0.4",
     "databazer": "^1.0.12",
     "lodash": "^4.17.20",