@fast-china/utils 1.0.3 → 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,127 +13532,47 @@ var FastUtils = function(exports, vue) {
     }
     consoleWarn("document", "binding value must be a string or number");
   };
-  const objectUtil = {
+  const envUtil = {
     /**
-     * 对象URL参数化
+     * 是否为 Uni 环境
+     * @returns
      */
-    objectToQueryString(obj) {
-      let params = "";
-      for (const key in obj) {
-        if (Object.prototype.hasOwnProperty.call(obj, key)) {
-          if (params !== "") {
-            params += "&";
-          }
-          params += `${encodeURIComponent(key)}=${encodeURIComponent(obj[key])}`;
-        }
-      }
-      return params;
+    isUni() {
+      return typeof uni !== "undefined";
     },
     /**
-     * 是否存在重复值
+     * 是否为 Web 环境（浏览器环境）
+     * @returns
      */
-    hasDuplicateProperty(arr, prop) {
-      const values2 = arr.map((obj) => obj[prop]);
-      const uniqueValues = new Set(values2);
-      return values2.length !== uniqueValues.size;
+    isWeb() {
+      return typeof window !== "undefined" && typeof window.document !== "undefined";
     },
     /**
-     * 是否存在非重复值
+     * 是否为手机设备
+     * @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;
+    isMobile() {
+      if (!this.isWeb()) return false;
+      const ua = navigator.userAgent || "";
+      return /Mobile|iPhone|Android.*Mobile|Windows Phone/i.test(ua);
     },
     /**
-     * 时间处理翻译
+     * 是否为平板设备
+     * @returns
      */
-    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 "";
-      }
+    isIpad() {
+      if (!this.isWeb()) return false;
+      const ua = navigator.userAgent || "";
+      return /iPad|Android(?!.*Mobile)|Tablet/i.test(ua);
     }
   };
-  const state = vue.reactive({
+  const state$1 = vue.reactive({
     prefix: "fast__",
     expireSuffix: "__Expire",
     crypto: false
   });
-  const CACHE_PREFIX = vue.computed(() => state.prefix);
-  const CACHE_EXPIRE_SUFFIX = vue.computed(() => state.expireSuffix);
+  const CACHE_PREFIX = vue.computed(() => state$1.prefix);
+  const CACHE_EXPIRE_SUFFIX = vue.computed(() => state$1.expireSuffix);
   const useStorage = () => {
     return {
       /**
@@ -13608,21 +13580,21 @@ var FastUtils = function(exports, vue) {
        * @param key
        */
       prefix(key) {
-        state.prefix = key;
+        state$1.prefix = key;
       },
       /**
        * 缓存过期值后缀 Key
        * @param key
        */
       expireSuffix(key) {
-        state.expireSuffix = key;
+        state$1.expireSuffix = key;
       },
       /**
        * 设置缓存是否加密
        * @param crypto
        */
       crypto(crypto) {
-        state.crypto = crypto;
+        state$1.crypto = crypto;
       }
     };
   };
@@ -13673,23 +13645,23 @@ var FastUtils = function(exports, vue) {
      */
     set(key, val, expire, encrypt) {
       try {
-        encrypt ?? (encrypt = state.crypto);
+        encrypt ?? (encrypt = state$1.crypto);
         if (expire) {
           if (isNaN(expire) || expire < 1) {
-            throw new Error("有效期应为一个有效数值");
+            throw new FastError("有效期应为一个有效数值");
           }
           const expireData = {
             time: Date.now(),
             expire
           };
           const expireJson = JSON.stringify(expireData);
-          storage.set(`${state.prefix}${key}${state.expireSuffix}`, expireJson);
+          storage.set(`${state$1.prefix}${key}${state$1.expireSuffix}`, expireJson);
         }
         let valJson = JSON.stringify(val);
         if (encrypt) {
           valJson = base64Util.toBase64(valJson);
         }
-        storage.set(`${state.prefix}${key}`, valJson);
+        storage.set(`${state$1.prefix}${key}`, valJson);
       } catch (error) {
         consoleError("Local", error);
       }
@@ -13702,18 +13674,18 @@ var FastUtils = function(exports, vue) {
      */
     get(key, decrypt) {
       try {
-        decrypt ?? (decrypt = state.crypto);
-        let valJson = storage.get(`${state.prefix}${key}`);
+        decrypt ?? (decrypt = state$1.crypto);
+        let valJson = storage.get(`${state$1.prefix}${key}`);
         if (valJson) {
           if (decrypt) {
             valJson = base64Util.base64ToStr(valJson);
           }
-          const expireJson = storage.get(`${state.prefix}${key}${state.expireSuffix}`);
+          const expireJson = storage.get(`${state$1.prefix}${key}${state$1.expireSuffix}`);
           if (expireJson) {
             const expireData = JSON.parse(expireJson);
             if (Date.now() > expireData.time + expireData.expire * 60 * 1e3) {
-              storage.remove(`${state.prefix}${key}`);
-              storage.remove(`${state.prefix}${key}${state.expireSuffix}`);
+              storage.remove(`${state$1.prefix}${key}`);
+              storage.remove(`${state$1.prefix}${key}${state$1.expireSuffix}`);
               return null;
             }
           }
@@ -13734,8 +13706,8 @@ var FastUtils = function(exports, vue) {
      */
     remove(key) {
       try {
-        storage.remove(`${state.prefix}${key}`);
-        storage.remove(`${state.prefix}${key}${state.expireSuffix}`);
+        storage.remove(`${state$1.prefix}${key}`);
+        storage.remove(`${state$1.prefix}${key}${state$1.expireSuffix}`);
       } catch (error) {
         consoleError("Local", error);
       }
@@ -13747,7 +13719,7 @@ var FastUtils = function(exports, vue) {
     removeByPrefix(key) {
       try {
         for (const itemKey in storage.keys) {
-          if (itemKey.indexOf(`${state.prefix}${key}`) !== -1) {
+          if (itemKey.indexOf(`${state$1.prefix}${key}`) !== -1) {
             storage.remove(itemKey);
           }
         }
@@ -13780,23 +13752,23 @@ var FastUtils = function(exports, vue) {
         return;
       }
       try {
-        encrypt ?? (encrypt = state.crypto);
+        encrypt ?? (encrypt = state$1.crypto);
         if (expire) {
           if (isNaN(expire) || expire < 1) {
-            throw new Error("有效期应为一个有效数值");
+            throw new FastError("有效期应为一个有效数值");
           }
           const expireData = {
             time: Date.now(),
             expire
           };
           const expireJson = JSON.stringify(expireData);
-          window.sessionStorage.setItem(`${state.prefix}${key}${state.expireSuffix}`, expireJson);
+          window.sessionStorage.setItem(`${state$1.prefix}${key}${state$1.expireSuffix}`, expireJson);
         }
         let valJson = JSON.stringify(val);
         if (encrypt) {
           valJson = base64Util.toBase64(valJson);
         }
-        window.sessionStorage.setItem(`${state.prefix}${key}`, valJson);
+        window.sessionStorage.setItem(`${state$1.prefix}${key}`, valJson);
       } catch (error) {
         consoleError("Session", error);
       }
@@ -13813,18 +13785,18 @@ var FastUtils = function(exports, vue) {
         return;
       }
       try {
-        decrypt ?? (decrypt = state.crypto);
-        let valJson = window.sessionStorage.getItem(`${state.prefix}${key}`);
+        decrypt ?? (decrypt = state$1.crypto);
+        let valJson = window.sessionStorage.getItem(`${state$1.prefix}${key}`);
         if (valJson) {
           if (decrypt) {
             valJson = base64Util.base64ToStr(valJson);
           }
-          const expireJson = window.sessionStorage.getItem(`${state.prefix}${key}${state.expireSuffix}`);
+          const expireJson = window.sessionStorage.getItem(`${state$1.prefix}${key}${state$1.expireSuffix}`);
           if (expireJson) {
             const expireData = JSON.parse(expireJson);
             if (Date.now() > expireData.time + expireData.expire * 60 * 1e3) {
-              window.sessionStorage.removeItem(`${state.prefix}${key}`);
-              window.sessionStorage.removeItem(`${state.prefix}${key}${state.expireSuffix}`);
+              window.sessionStorage.removeItem(`${state$1.prefix}${key}`);
+              window.sessionStorage.removeItem(`${state$1.prefix}${key}${state$1.expireSuffix}`);
               return null;
             }
           }
@@ -13849,8 +13821,8 @@ var FastUtils = function(exports, vue) {
         return;
       }
       try {
-        window.sessionStorage.removeItem(`${state.prefix}${key}`);
-        window.sessionStorage.removeItem(`${state.prefix}${key}${state.expireSuffix}`);
+        window.sessionStorage.removeItem(`${state$1.prefix}${key}`);
+        window.sessionStorage.removeItem(`${state$1.prefix}${key}${state$1.expireSuffix}`);
       } catch (error) {
         consoleError("Session", error);
       }
@@ -13866,7 +13838,7 @@ var FastUtils = function(exports, vue) {
       }
       try {
         for (const itemKey in window.sessionStorage) {
-          if (itemKey.indexOf(`${state.prefix}${key}`) !== -1) {
+          if (itemKey.indexOf(`${state$1.prefix}${key}`) !== -1) {
             window.sessionStorage.removeItem(itemKey);
           }
         }
@@ -13919,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;
+    },
     /**
      * 生成随机字符串
      */
@@ -13978,6 +13987,49 @@ var FastUtils = function(exports, vue) {
       }
     }
   };
+  const state = vue.reactive({
+    cacheKey: "__DEVICE_ID",
+    deviceId: ""
+  });
+  const uuidRegExp = /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/;
+  const makeIdentity = () => {
+    if (state.deviceId && uuidRegExp.test(state.deviceId)) {
+      Local.set(state.cacheKey, state.deviceId);
+      return state.deviceId;
+    }
+    let deviceID = Local.get(state.cacheKey);
+    if (deviceID && uuidRegExp.test(deviceID)) {
+      state.deviceId = deviceID;
+      return deviceID;
+    }
+    deviceID = stringUtil.generateUUID();
+    Local.set(state.cacheKey, deviceID);
+    state.deviceId = deviceID;
+    return deviceID;
+  };
+  const useIdentity = () => {
+    return {
+      ...state,
+      makeIdentity
+    };
+  };
+  const objectUtil = {
+    /**
+     * 对象URL参数化
+     */
+    objectToQueryString(obj) {
+      let params = "";
+      for (const key in obj) {
+        if (Object.prototype.hasOwnProperty.call(obj, key)) {
+          if (params !== "") {
+            params += "&";
+          }
+          params += `${encodeURIComponent(key)}=${encodeURIComponent(obj[key])}`;
+        }
+      }
+      return params;
+    }
+  };
   const useExpose = (expose, exposed) => {
     expose(exposed);
     return exposed;
@@ -14042,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;
   };
@@ -14055,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;
@@ -14065,12 +14118,14 @@ 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;
   exports.stringUtil = stringUtil;
   exports.throwError = throwError;
   exports.useExpose = useExpose;
+  exports.useIdentity = useIdentity;
   exports.useProps = useProps;
   exports.useRender = useRender;
   exports.useStorage = useStorage;