utiller 1.0.321 → 1.0.322

package/lib/utiller/index.js

@@ -3596,6 +3596,41 @@ var Utiller = /*#__PURE__*/function () {
         return predict(value);
       }));
     }
+
+    /**
+    *
+    const array = [
+    { serial: 'A023' },
+    { serial: 'Z001' },
+    { serial: 'C002' },
+    { serial: 'G123' },
+    { serial: 'A001' },
+    { serial: 'A999' }
+    ];
+    mutateBy(array, (item) => {
+    const serial = item.serial;
+    const match = serial.match(/^([A-Z]+)(\d+)$/i);
+    const [letter, number] = match ? [match[1], parseInt(match[2], 10)] : [serial, 0];
+    return [letter, number]; // 多層排序：先字母，再數字
+    });
+    *
+    * [ { serial: 'A001' }, { serial: 'A023' }, { serial: 'A999' }, { serial: 'C002' }, { serial: 'G123' }, { serial: 'Z001' } ]
+    *
+    *
+    * 通用的排序變異工具：依照 predict 提供的排序 key 對 array 進行原地排序(mutated)
+    *
+    * @param {Array} array - 要排序的陣列（會就地變異）
+    * @param {Function} predict - 回傳排序 key（可以是陣列以支援多層排序）
+    */
+  }, {
+    key: "mutateBy",
+    value: function mutateBy(array) {
+      var predict = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : function (item) {
+        return item;
+      };
+      var sorted = _lodash["default"].sortBy(array, predict);
+      array.splice.apply(array, [0, array.length].concat((0, _toConsumableArray2["default"])(sorted)));
+    }
   }]);
 }();
 var _default = exports["default"] = Utiller;

package/package.json

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

package/template/sample.package.json

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