utiller 1.0.374 → 1.0.376

package/lib/utiller/index.js

@@ -595,6 +595,16 @@ var Utiller = /*#__PURE__*/function () {
         return match ? _lodash["default"].merge({}, item, match) : item;
       });
     });
+    /**
+     * console.log(toPercentageDecimal(100)); // 1
+     * console.log(toPercentageDecimal(97));  // 0.97
+     * console.log(toPercentageDecimal('97')); // 0（非數字）
+     */
+    (0, _defineProperty2["default"])(this, "toPercentageDecimal", function (num) {
+      var parsed = _lodash["default"].toNumber(num);
+      if (!_lodash["default"].isFinite(parsed)) return 1;
+      return _lodash["default"].round(parsed / 100, 10);
+    });
     /**
      * @param {Array<Object>} current - 要更新的目標陣列
      * @param {Array<Object>} reference - 用來替換屬性的參照陣列
@@ -4195,6 +4205,81 @@ var Utiller = /*#__PURE__*/function () {
         return false;
       }
     }
+  }, {
+    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 = _lodash["default"].camelCase(rawKey);
+        if (usedKeys.has(key)) {
+          throw new Error("Duplicate key detected: \"".concat(key, "\" (\u539F\u59CB\u503C: \"").concat(rawKey, "\")"));
+        }
+        usedKeys.add(key);
+        result[key] = generateRandomCode();
+      }, {});
+    }
 
     /** ============== 排課系統公式 開始 ============== */
 

package/package.json

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

package/template/sample.package.json

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