utiller 1.0.380 → 1.0.382

package/lib/utiller/index.js

@@ -306,6 +306,64 @@ var Utiller = /*#__PURE__*/function () {
         minimumFractionDigits: 0 // 確保不顯示小數
       }).format(number);
     });
+    /**
+     * 使用 ES10+ 和 Lodash，將短句子轉換為潛在的搜尋關鍵字陣列。
+     * 策略：1. 清理 2. 窮舉所有可能的 2 字或 3 字詞組 3. 去重和過濾
+     * @param {string} sentence - 原始字串。
+     * @param {number} [maxLength=50] - 允許的最大字串長度，預設為 30。
+     * @returns {string[]} - 潛在關鍵字陣列（至少 2 個中文字）。
+     */
+    (0, _defineProperty2["default"])(this, "generateUniversalKeywords", function (sentence) {
+      var maxLength = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 50;
+      // 引入 Lodash，確保在執行環境中可用
+      // 由於在瀏覽器環境中執行，我們假設 Lodash 已經全域引入或在 Node.js 環境中運行。
+      // 在大多數現代前端框架中，這行可能需要根據實際模組系統調整（例如 import _ from 'lodash'）。
+      if (!sentence || typeof sentence !== "string") {
+        return [];
+      }
+      var textToProcess = sentence;
+
+      // 警告/截斷邏輯
+      if (textToProcess.length > maxLength) {
+        console.warn("\u8B66\u544A\uFF1A\u8F38\u5165\u5B57\u4E32\u9577\u5EA6\u70BA ".concat(textToProcess.length, "\uFF0C\u5DF2\u6839\u64DA maxLength: ").concat(maxLength, " \u622A\u65B7\u3002"));
+        textToProcess = textToProcess.substring(0, maxLength);
+      }
+
+      // 步驟 1: 清理和標準化
+      var cleanText = textToProcess.toLowerCase();
+
+      // 移除規格、數量和常見符號，然後移除通用詞
+      cleanText = cleanText.replace(/[a-z0-9]+(w|led|uv|顆|組|片|入|ml|g|oz|號|色|\/|\-|\~|k)/g, " ") // 移除規格和數量 (新增了 k, 修正了 w)
+      .replace(/[!@#$%^&*()_+={}\[\]:;"'<>,.?\/\\|`~]/g, " ") // 移除特殊符號
+      .replace(/系列|一組|單色|多款|套組|全套|專用|迷你|頂級|高品質|超閃|奢華|最新|款式|新款|超亮|的|與|和|閃|美甲/g, " ") // 移除通用詞 (新增了 閃, 美甲)
+      .replace(/\s+/g, "") // **移除所有空格**，確保中文句子連貫提取
+      .trim();
+      if (cleanText.length < 2) {
+        return []; // 如果清理後長度不足，直接返回空陣列
+      }
+
+      // 步驟 2: 窮舉所有 >= 2 個字的 N-gram 詞組
+      var keywords = [];
+      var minLength = 2;
+      var maxNgramLength = 3; // N-gram 最大長度
+
+      for (var len = minLength; len <= maxNgramLength; len++) {
+        for (var i = 0; i <= cleanText.length - len; i++) {
+          var keyword = cleanText.substring(i, i + len);
+          keywords.push(keyword);
+        }
+      }
+
+      // 步驟 3: 標準化、去重和過濾
+      var finalKeywords = _lodash["default"].chain(keywords)
+      // 確保只包含長度 >= 2 的詞
+      .filter(function (k) {
+        return k.length >= 2;
+      })
+      // 去除重複
+      .uniq().value();
+      return finalKeywords;
+    });
     /**
      * 直接修改原本 array，將 object 移動到指定 index
      * @param {Array} array - 要修改的陣列
@@ -930,8 +988,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) {
@@ -4059,14 +4117,14 @@ var Utiller = /*#__PURE__*/function () {
       }).keys().compact() // 移除 null、undefined、''、0、false、NaN
       .value();
     }
-
+  }, {
+    key: "getObjectOfSpecifyKey",
+    value:
     /**
      * 減少不必要的{}
      * 例如 array.map(each => {return {key,value}})
      **/
-  }, {
-    key: "getObjectOfSpecifyKey",
-    value: function getObjectOfSpecifyKey(value, key) {
+    function getObjectOfSpecifyKey(value, key) {
       var object = {};
       object[key] = value;
       return object;
@@ -4291,8 +4349,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 +4414,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.382",
   "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.381",
     "linepayer": "^1.0.15",
     "databazer": "^1.0.17",
     "lodash": "^4.17.20",