@fast-china/utils 1.0.4 → 1.0.5

package/dist/index.global.js

@@ -1,5 +1,34 @@
 var FastUtils = function(exports, vue) {
   "use strict";
+  const arrayUtil = {
+    /**
+     * 是否存在重复值
+     * @param arr 数组
+     * @param prop 属性
+     * @returns
+     */
+    hasDuplicateProperty(arr, prop) {
+      const values2 = arr.map((obj) => obj[prop]);
+      const uniqueValues = new Set(values2);
+      return values2.length !== uniqueValues.size;
+    },
+    /**
+     * 是否存在非重复值
+     * @param arr 数组
+     * @param prop 属性
+     * @returns
+     */
+    hasDifferentProperty(arr, prop) {
+      const valueSet = /* @__PURE__ */ new Set();
+      for (const obj of arr) {
+        valueSet.add(obj[prop]);
+        if (valueSet.size > 1) {
+          return true;
+        }
+      }
+      return false;
+    }
+  };
   const b64 = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=";
   const b64re = /^(?:[A-Za-z\d+/]{4})*?(?:[A-Za-z\d+/]{2}(?:==)?|[A-Za-z\d+/]{3}=?)?$/;
   const base64PwdDic = [
@@ -74,6 +103,9 @@ var FastUtils = function(exports, vue) {
     return result2;
   }
   const base64Util = {
+    /**
+     * 将字符串编码为Base64格式
+     */
     bota(string2) {
       string2 = String(string2);
       let bitmap, a, b, c, result2 = "", i = 0, rest2 = string2.length % 3;
@@ -87,6 +119,9 @@ var FastUtils = function(exports, vue) {
       }
       return rest2 ? result2.slice(0, rest2 - 3) + "===".substring(rest2) : result2;
     },
+    /**
+     * 将Base64编码的字符串解码回其原始格式。
+     */
     atob(string2) {
       string2 = String(string2).replace(/[\t\n\f\r ]+/g, "");
       if (!b64re.test(string2)) throw new TypeError("Failed to execute 'atob' on 'Window': The string to be decoded is not correctly encoded.");
@@ -206,6 +241,12 @@ var FastUtils = function(exports, vue) {
       });
     }
   };
+  class FastError extends Error {
+    constructor(m) {
+      super(m);
+      this.name = "FastError";
+    }
+  }
   const colorUtil = {
     /**
      * hex颜色转rgb颜色
@@ -215,7 +256,7 @@ var FastUtils = function(exports, vue) {
     hexToRgb(str) {
       let hex = "";
       const reg = /^#?[0-9A-Fa-f]{6}$/;
-      if (!reg.test(str)) throw new Error("输入错误的hex");
+      if (!reg.test(str)) throw new FastError("输入错误的hex");
       str = str.replace("#", "");
       hex = str.match(/../g);
       for (let i = 0; i < 3; i++) hex[i] = parseInt(hex[i], 16);
@@ -230,7 +271,7 @@ var FastUtils = function(exports, vue) {
      */
     rgbToHex(r, g, b) {
       const reg = /^\d{1,3}$/;
-      if (!reg.test(r) || !reg.test(g) || !reg.test(b)) throw new Error("输入错误的rgb颜色值");
+      if (!reg.test(r) || !reg.test(g) || !reg.test(b)) throw new FastError("输入错误的rgb颜色值");
       const hex = [r.toString(16), g.toString(16), b.toString(16)];
       for (let i = 0; i < 3; i++) if (hex[i].length === 1) hex[i] = `0${hex[i]}`;
       return `#${hex.join("")}`;
@@ -243,7 +284,7 @@ var FastUtils = function(exports, vue) {
      */
     getDarkColor(color, level) {
       const reg = /^#?[0-9A-Fa-f]{6}$/;
-      if (!reg.test(color)) throw new Error("输入错误的hex颜色值");
+      if (!reg.test(color)) throw new FastError("输入错误的hex颜色值");
       const rgb = this.hexToRgb(color);
       for (let i = 0; i < 3; i++) rgb[i] = Math.round(20.5 * level + rgb[i] * (1 - level));
       return this.rgbToHex(rgb[0], rgb[1], rgb[2]);
@@ -256,7 +297,7 @@ var FastUtils = function(exports, vue) {
      */
     getLightColor(color, level) {
       const reg = /^#?[0-9A-Fa-f]{6}$/;
-      if (!reg.test(color)) throw new Error("输入错误的hex颜色值");
+      if (!reg.test(color)) throw new FastError("输入错误的hex颜色值");
       const rgb = this.hexToRgb(color);
       for (let i = 0; i < 3; i++) rgb[i] = Math.round(255 * level + rgb[i] * (1 - level));
       return this.rgbToHex(rgb[0], rgb[1], rgb[2]);
@@ -6287,12 +6328,6 @@ var FastUtils = function(exports, vue) {
    * Based on Underscore.js 1.8.3 <http://underscorejs.org/LICENSE>
    * Copyright Jeremy Ashkenas, DocumentCloud and Investigative Reporters & Editors
    */
-  class FastError extends Error {
-    constructor(m) {
-      super(m);
-      this.name = "FastError";
-    }
-  }
   const consoleLog = (name, message, error) => {
     if (error) {
       console.log(`[Fast-Log-${name}]${message ? ` ${message}` : ""}`, error);
@@ -13319,6 +13354,10 @@ var FastUtils = function(exports, vue) {
         return "";
       }
     },
+    /**
+     * 获取默认时间
+     * @returns [00:00:00, 23:59:59]
+     */
     getDefaultTime() {
       const end = /* @__PURE__ */ new Date();
       const start = /* @__PURE__ */ new Date();
@@ -13327,11 +13366,18 @@ var FastUtils = function(exports, vue) {
       end.setHours(23, 59, 59);
       return [start, end];
     },
+    /**
+     * 获取简单的日期时间
+     * @returns xxxx-xx-xx 00:00:00
+     */
     getSimpleTime() {
       const start = /* @__PURE__ */ new Date();
       start.setHours(0, 0, 0);
       return start;
     },
+    /**
+     * 获取简单的日期时间范围
+     */
     getSimpleShortcuts() {
       return [
         {
@@ -13380,6 +13426,9 @@ var FastUtils = function(exports, vue) {
         }
       ];
     },
+    /**
+     * 获取日期范围
+     */
     getShortcuts() {
       return [
         {
@@ -13461,6 +13510,9 @@ var FastUtils = function(exports, vue) {
         }
       ];
     },
+    /**
+     * 判断传入的时间是否大于当前时间
+     */
     getDisabledDate(time) {
       return time.getTime() > Date.now();
     }
@@ -13480,6 +13532,40 @@ var FastUtils = function(exports, vue) {
     }
     consoleWarn("document", "binding value must be a string or number");
   };
+  const envUtil = {
+    /**
+     * 是否为 Uni 环境
+     * @returns
+     */
+    isUni() {
+      return typeof uni !== "undefined";
+    },
+    /**
+     * 是否为 Web 环境（浏览器环境）
+     * @returns
+     */
+    isWeb() {
+      return typeof window !== "undefined" && typeof window.document !== "undefined";
+    },
+    /**
+     * 是否为手机设备
+     * @returns
+     */
+    isMobile() {
+      if (!this.isWeb()) return false;
+      const ua = navigator.userAgent || "";
+      return /Mobile|iPhone|Android.*Mobile|Windows Phone/i.test(ua);
+    },
+    /**
+     * 是否为平板设备
+     * @returns
+     */
+    isIpad() {
+      if (!this.isWeb()) return false;
+      const ua = navigator.userAgent || "";
+      return /iPad|Android(?!.*Mobile)|Tablet/i.test(ua);
+    }
+  };
   const state$1 = vue.reactive({
     prefix: "fast__",
     expireSuffix: "__Expire",
@@ -13562,7 +13648,7 @@ var FastUtils = function(exports, vue) {
         encrypt ?? (encrypt = state$1.crypto);
         if (expire) {
           if (isNaN(expire) || expire < 1) {
-            throw new Error("有效期应为一个有效数值");
+            throw new FastError("有效期应为一个有效数值");
           }
           const expireData = {
             time: Date.now(),
@@ -13669,7 +13755,7 @@ var FastUtils = function(exports, vue) {
         encrypt ?? (encrypt = state$1.crypto);
         if (expire) {
           if (isNaN(expire) || expire < 1) {
-            throw new Error("有效期应为一个有效数值");
+            throw new FastError("有效期应为一个有效数值");
           }
           const expireData = {
             time: Date.now(),
@@ -13805,6 +13891,43 @@ var FastUtils = function(exports, vue) {
       }
       return false;
     },
+    /**
+     * 切割骆驼命名式字符串
+     */
+    splitCamelCase(value) {
+      if (!value) return [];
+      if (value.length === 1) return [value];
+      return value.split(new RegExp("(?=\\p{Lu}\\p{Ll})|(?<=\\p{Ll})(?=\\p{Lu})", "u")).filter((token) => token.length > 0);
+    },
+    /**
+     * 将字符串转为 camelCase 格式，支持 - 或 _ 分隔的字符串
+     * 例如：'hello-world' 或 'hello_world' => 'helloWorld'
+     */
+    toCamelCase(value) {
+      if (!value) return "";
+      return value.replace(/[-_](\w)/g, (_, c) => c ? c.toUpperCase() : "");
+    },
+    /**
+     * 字符串首字母大写
+     */
+    firstCharToUpper(value) {
+      if (!value) return "";
+      return value.charAt(0).toUpperCase() + value.slice(1);
+    },
+    /**
+     * 字符串首字母小写
+     */
+    firstCharToLower(value) {
+      if (!value) return "";
+      return value.charAt(0).toLowerCase() + value.slice(1);
+    },
+    /**
+     * 截取指定长度的字符串
+     */
+    subStringWithEllipsis(value, length, suffix = "...") {
+      if (!value) return "";
+      return value.length > length ? value.substring(0, length) + suffix : value;
+    },
     /**
      * 生成随机字符串
      */
@@ -13905,103 +14028,6 @@ var FastUtils = function(exports, vue) {
         }
       }
       return params;
-    },
-    /**
-     * 是否存在重复值
-     */
-    hasDuplicateProperty(arr, prop) {
-      const values2 = arr.map((obj) => obj[prop]);
-      const uniqueValues = new Set(values2);
-      return values2.length !== uniqueValues.size;
-    },
-    /**
-     * 是否存在非重复值
-     */
-    hasDifferentProperty(arr, prop) {
-      const valueSet = /* @__PURE__ */ new Set();
-      for (const obj of arr) {
-        valueSet.add(obj[prop]);
-        if (valueSet.size > 1) {
-          return true;
-        }
-      }
-      return false;
-    },
-    /**
-     * 时间处理翻译
-     */
-    dateTimeFix(date2) {
-      if (date2 !== null && date2 !== void 0 && date2) {
-        if (typeof date2 === "string") {
-          date2 = new Date(date2);
-        }
-        let timestamp = date2.getTime();
-        if (timestamp.toString().length < 13) {
-          const arrTimestamp = timestamp.toString().split("");
-          for (let start = 0; start < 13; start++) {
-            if (!arrTimestamp[start]) {
-              arrTimestamp[start] = "0";
-            }
-          }
-          timestamp = parseInt(arrTimestamp.join(""));
-        }
-        const minute = 1e3 * 60;
-        const hour = minute * 60;
-        const day = hour * 24;
-        const month = day * 30;
-        const curTime = (/* @__PURE__ */ new Date()).getTime();
-        const diffValue = curTime - timestamp;
-        const monthC = diffValue / month;
-        const weekC = diffValue / (7 * day);
-        const dayC = diffValue / day;
-        const hourC = diffValue / hour;
-        const minC = diffValue / minute;
-        if (diffValue < 0) {
-          const monthC1 = Math.abs(monthC);
-          const weekC1 = Math.abs(weekC);
-          const dayC1 = Math.abs(dayC);
-          const hourC1 = Math.abs(hourC);
-          const minC1 = Math.abs(minC);
-          if (monthC1 > 12) {
-            return `${parseInt(`${monthC1 / 12}`)}年后`;
-          } else if (monthC1 >= 6) {
-            return "半年后";
-          } else if (monthC1 >= 1) {
-            return `${parseInt(`${monthC1}`)}月后`;
-          } else if (weekC1 > 2) {
-            return "半月后";
-          } else if (weekC1 >= 1) {
-            return `${parseInt(`${weekC1}`)}周后`;
-          } else if (dayC1 >= 1) {
-            return `${parseInt(`${dayC1}`)}天后`;
-          } else if (hourC1 >= 1) {
-            return `${parseInt(`${hourC1}`)}小时后`;
-          } else if (minC1 >= 1) {
-            return `${parseInt(`${minC1}`)}分钟后`;
-          }
-          return "刚刚";
-        }
-        if (monthC > 12) {
-          return `${parseInt(`${monthC / 12}`)}年前`;
-        } else if (monthC >= 6) {
-          return "半年前";
-        } else if (monthC >= 1) {
-          return `${parseInt(`${monthC}`)}月前`;
-        } else if (weekC > 2) {
-          return "半月前";
-        } else if (weekC >= 1) {
-          return `${parseInt(`${weekC}`)}周前`;
-        } else if (dayC >= 1) {
-          return `${parseInt(`${dayC}`)}天前`;
-        } else if (hourC >= 1) {
-          return `${parseInt(`${hourC}`)}小时前`;
-        } else if (minC >= 1) {
-          return `${parseInt(`${minC}`)}分钟前`;
-        }
-        return "刚刚";
-      } else {
-        return "";
-      }
     }
   };
   const useExpose = (expose, exposed) => {
@@ -14068,7 +14094,7 @@ var FastUtils = function(exports, vue) {
   const useRender = (render) => {
     const vm = vue.getCurrentInstance();
     if (!vm) {
-      throw new Error("useRender must be called from inside a setup function");
+      throw new FastError("useRender must be called from inside a setup function");
     }
     vm.render = render;
   };
@@ -14081,6 +14107,7 @@ var FastUtils = function(exports, vue) {
   exports.Local = Local;
   exports.Session = Session;
   exports.addUnit = addUnit;
+  exports.arrayUtil = arrayUtil;
   exports.base64Util = base64Util;
   exports.clickUtil = clickUtil;
   exports.colorUtil = colorUtil;
@@ -14091,6 +14118,7 @@ var FastUtils = function(exports, vue) {
   exports.cryptoUtil = cryptoUtil;
   exports.dateUtil = dateUtil;
   exports.definePropType = definePropType;
+  exports.envUtil = envUtil;
   exports.execFunction = execFunction;
   exports.makeSlots = makeSlots;
   exports.objectUtil = objectUtil;