utiller 1.0.375 → 1.0.377

package/lib/utiller/index.js

@@ -4206,8 +4206,82 @@ var Utiller = /*#__PURE__*/function () {
       }
     }
   }, {
-    key: "getFilteredHeraPeriods",
-    value: /** ============== 排課系統公式 開始 ============== */
+    key: "generateUniqueCodeMap",
+    value:
+    /**
+     * 🧩 產生合法變數命名的唯一亂碼代碼對照表（支援自訂長度）
+     *
+     * 將輸入的字串陣列轉換成：
+     * 1️⃣ 合法變數命名 key（以 _.camelCase() 處理）
+     * 2️⃣ 對應唯一亂碼代碼（預設長度 3，第一字母必須為英文字母）
+     * 3️⃣ 若 key 重複，拋出錯誤並指出是哪個 key 重複
+     *
+     * @param {string[]} array - 要轉換的字串陣列
+     * @param {number} [length=3] - 代碼長度（預設為 3，最小為 2）
+     * @returns {Object} 回傳一個 JSON 物件，例如：
+     *                   { mainDiv: 'f2x', mainBanner: 'k9A' }
+     *
+     * 📘 範例：
+     * ```js
+     * const arr = ["MainDiv", "MainPromotedBannerSwiperSlide", "MainPromotedBannerSwiperList"];
+     *
+     * console.log(generateUniqueCodeMap(arr)); // 預設長度3
+     * // => { mainDiv: 'a9F', mainPromotedBannerSwiperSlide: 'm2q', mainPromotedBannerSwiperList: 'z5K' }
+     *
+     * console.log(generateUniqueCodeMap(arr, 4)); // 改為4字元
+     * // => { mainDiv: 'a9Fz', mainPromotedBannerSwiperSlide: 'm2qR', mainPromotedBannerSwiperList: 'z5K2' }
+     * ```
+     *
+     * // === 🧪 測試範例 ===
+     *     const arr = [
+     *         "MainDiv",
+     *         "MainPromotedBannerSwiperSlide",
+     *         "MainPromotedBannerSwiperList",
+     *     ];
+     *
+     *     console.log("3字元預設：", generateUniqueCodeMap(arr));
+     *     console.log("4字元代碼：", generateUniqueCodeMap(arr, 4));
+     *
+     */
+    function generateUniqueCodeMap(array) {
+      var length = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 3;
+      if (length < 2) {
+        throw new Error("代碼長度最少必須為 2。");
+      }
+      var usedCodes = new Set();
+      var usedKeys = new Set();
+
+      /**
+       * 產生合法變數代碼（指定長度亂碼）
+       * 第1字母：a-zA-Z
+       * 其餘字元：a-zA-Z0-9
+       */
+      var generateRandomCode = function generateRandomCode() {
+        var letters = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ";
+        var chars = letters + "0123456789";
+        var code;
+        do {
+          // 第一個字母必須是英文
+          code = letters[Math.floor(Math.random() * letters.length)];
+          // 其餘字元隨機取
+          for (var i = 1; i < length; i++) {
+            code += chars[Math.floor(Math.random() * chars.length)];
+          }
+        } while (usedCodes.has(code));
+        usedCodes.add(code);
+        return code;
+      };
+      return _lodash["default"].transform(array, function (result, rawKey) {
+        var key = rawKey;
+        if (usedKeys.has(key)) {
+          throw new Error("Duplicate key detected: \"".concat(key, "\" (\u539F\u59CB\u503C: \"").concat(rawKey, "\")"));
+        }
+        usedKeys.add(key);
+        result[key] = generateRandomCode();
+      }, {});
+    }
+
+    /** ============== 排課系統公式 開始 ============== */
 
     /**
      * /const arrayWithDup = [
@@ -4224,7 +4298,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.375",
+  "version": "1.0.377",
   "description": "",
   "main": "index.js",
   "scripts": {

package/template/sample.package.json

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