@yh-kit/utils 1.3.0 → 1.4.0

package/dist/utils.js

@@ -1,127 +1,180 @@
-const i = (t) => {
-  if (!t || !t.length) return {};
-  const e = {};
-  return t.forEach((r) => {
-    const n = Object.assign({ label: r.label, text: r.label }, r);
-    e[r == null ? void 0 : r.value] = n;
-  }), e;
-}, u = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+const p = (e) => {
+  if (!e || !e.length) return {};
+  const t = {};
+  return e.forEach((n) => {
+    const r = Object.assign({ label: n.label, text: n.label }, n);
+    t[n == null ? void 0 : n.value] = r;
+  }), t;
+}, b = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
-  toEnumObj: i
-}, Symbol.toStringTag, { value: "Module" })), h = {
-  ...u,
-  /**
-   * 数组去重
-   * @param arr 数组
-   * @returns 去重后的数组
-   */
-  unique: (t) => t ? Array.from(new Set(t)) : [],
-  /**
-   * 判断某元素是否在数组中
-   * @param arr 数组
-   * @param element 查询元素
-   * @returns 是否存在。true 存在；false 不存在
-   */
-  isExist(t, e) {
-    return !t || !e ? !1 : t.indexOf(e) !== -1;
-  },
-  /**
-   * 统计数组中某元素出现的次数：对于大型数组，手动循环的性能略优于 filter 和 reduce。
-   * @param arr 数组
-   * @param target 目标元素
-   * @returns 出现次数
-   */
-  countOfAppear(t, e) {
-    let r = 0;
-    for (const n of t)
-      n === e && r++;
-    return r;
+  toEnumObj: p
+}, Symbol.toStringTag, { value: "Module" })), A = Object.assign(
+  {
+    /**
+     * 数组去重
+     * @param arr 数组
+     * @returns 去重后的数组
+     */
+    unique(e) {
+      return e ? Array.from(new Set(e)) : [];
+    },
+    /**
+     * 判断某元素是否在数组中
+     * @param arr 数组
+     * @param element 查询元素
+     * @returns 是否存在。true 存在；false 不存在
+     */
+    isExist(e, t) {
+      return !e || !t ? !1 : e.indexOf(t) !== -1;
+    },
+    /**
+     * 统计数组中某元素出现的次数：对于大型数组，手动循环的性能略优于 filter 和 reduce。
+     * @param arr 数组
+     * @param target 目标元素
+     * @returns 出现次数
+     */
+    countOfAppear(e, t) {
+      let n = 0;
+      for (const r of e)
+        r === t && n++;
+      return n;
+    },
+    /**
+     * 数组排序-默认升序
+     * @param arr 数组
+     * @param order 排序方式：asc 升序；desc 降序
+     * @returns 排序后的数组
+     */
+    sort(e, t = "asc") {
+      return e ? e.sort((n, r) => t === "asc" ? n > r ? 1 : -1 : n < r ? 1 : -1) : [];
+    },
+    /**
+     * 数组乱序（洗牌算法）
+     * 1. 从数组的最后一个元素开始，将其与随机位置的元素交换位置。
+     * 2. 然后，从倒数第二个元素开始，将其与随机位置的元素交换位置。
+     * 3. 以此类推，直到第一个元素。
+     * 4. 这样，数组中的元素就会被随机打乱顺序。
+     * 5. 注意，这个算法会改变原数组。如果不想改变原数组，可以先复制一份再进行操作。
+     * 6. 时间复杂度：O(n)
+     * @param arr 数组
+     * @returns
+     */
+    shuffle(e) {
+      if (!e)
+        return [];
+      for (let t = e.length - 1; t > 0; t--) {
+        const n = Math.floor(Math.random() * (t + 1));
+        [e[t], e[n]] = [e[n], e[t]];
+      }
+      return e;
+    }
   },
-  /**
-   * 数组排序-默认升序
-   * @param arr 数组
-   * @param order 排序方式：asc 升序；desc 降序
-   * @returns 排序后的数组
-   */
-  sort(t, e = "asc") {
-    return t ? t.sort((r, n) => e === "asc" ? r > n ? 1 : -1 : r < n ? 1 : -1) : [];
+  {
+    ...b
+  }
+), j = {
+  /**
+   * 将Base64编码的字符串转换为Blob对象。
+   * Blob对象用于表示二进制大型对象，可以在浏览器环境中处理大文件或二进制数据。
+   *
+   * @param base64 Base64编码的字符串。
+   * @param contentType 可选参数，表示生成的Blob对象的MIME类型，默认为空字符串。
+   * @param sliceSize 可选参数，表示分片大小，默认为512字节。用于控制每次处理的Base64字符串长度，以优化大文件的处理。
+   * @returns 返回转换后的Blob对象，如果转换失败，则返回null。
+   */
+  toBlob(e, t = "", n = 512) {
+    const o = (e.split(",")[1] || e).replace(/-/g, "+").replace(/_/g, "/"), i = "=".repeat((4 - o.length % 4) % 4), g = o + i;
+    try {
+      const l = atob(g), f = [];
+      for (let a = 0; a < l.length; a += n) {
+        const c = l.slice(a, a + n), u = new Array(c.length);
+        for (let s = 0; s < c.length; s++)
+          u[s] = c.charCodeAt(s);
+        const d = new Uint8Array(u);
+        f.push(d);
+      }
+      return new Blob(f, { type: t });
+    } catch (l) {
+      return console.error("Failed to convert base64 to blob:", l), null;
+    }
   },
   /**
-   * 数组乱序（洗牌算法）
-   * 1. 从数组的最后一个元素开始，将其与随机位置的元素交换位置。
-   * 2. 然后，从倒数第二个元素开始，将其与随机位置的元素交换位置。
-   * 3. 以此类推，直到第一个元素。
-   * 4. 这样，数组中的元素就会被随机打乱顺序。
-   * 5. 注意，这个算法会改变原数组。如果不想改变原数组，可以先复制一份再进行操作。
-   * 6. 时间复杂度：O(n)
-   * @param arr 数组
-   * @returns
-   */
-  shuffle(t) {
-    if (!t)
-      return [];
-    for (let e = t.length - 1; e > 0; e--) {
-      const r = Math.floor(Math.random() * (e + 1));
-      [t[e], t[r]] = [t[r], t[e]];
+   * 将Base64编码的字符串转换为File对象。
+   * 这个函数接受一个Base64编码的字符串，一个可选的文件名和一个可选的MIME类型，
+   * 并返回一个代表原始数据的File对象。
+   *
+   * @param base64 Base64编码的字符串。
+   * @param fileName 文件名，默认为"file.txt"。
+   * @param mimeType MIME类型，默认为"text/plain"。
+   * @returns 返回一个File对象，包含解码后的数据。
+   */
+  toFile(e, t = "file.txt", n = "text/plain") {
+    const o = e.replace(/^data:.+;base64,/, "").replace(/-/g, "+").replace(/_/g, "/"), i = "=".repeat((4 - o.length % 4) % 4), g = o + i, l = atob(g), f = [];
+    for (let c = 0; c < l.length; c += 512) {
+      const u = l.slice(c, c + 512), d = new Array(u.length);
+      for (let s = 0; s < u.length; s++)
+        d[s] = u.charCodeAt(s);
+      f.push(new Uint8Array(d));
     }
-    return t;
+    const a = new Blob(f, { type: n });
+    return new File([a], t, { type: n });
   }
-}, y = {
+}, E = {
   /**
    * 检查是否为空字符串
    * @param str 要检查的字符串
    * @returns 如果字符串为空，则返回 true，否则返回 false
    */
-  isEmptyString(t) {
-    return typeof t == "string" && t.trim() === "";
+  isEmptyString(e) {
+    return typeof e == "string" && e.trim() === "";
   },
   /**
    * 判断是否为数字
    * @param val 要检查的值
    * @returns 如果值是数字，则返回 true，否则返回 false
    */
-  isNumber(t) {
-    return typeof t == "number" && !isNaN(t);
+  isNumber(e) {
+    return typeof e == "number" && !isNaN(e);
   },
   /**
    * 判断是否为对象
    * @param val 要检查的值
    * @returns 如果值是对象，则返回 true，否则返回 false
    */
-  isObject(t) {
-    return t !== null && typeof t == "object" && !Array.isArray(t);
+  isObject(e) {
+    return e !== null && typeof e == "object" && !Array.isArray(e);
   },
   /**
    * 判断对象是否为空
    * @param obj 要检查的对象
    * @returns 如果对象为空，则返回 true，否则返回 false
    */
-  isEmptyObject(t) {
-    return t ? Object.keys(t).length === 0 && t.constructor === Object : !0;
+  isEmptyObject(e) {
+    return e ? Object.keys(e).length === 0 && e.constructor === Object : !0;
   },
   /**
    * 判断是否为布尔值
    * @param val 要检查的值
    * @returns 如果值是布尔值，则返回 true，否则返回 false
    */
-  isBoolean(t) {
-    return typeof t == "boolean";
+  isBoolean(e) {
+    return typeof e == "boolean";
   },
   /**
    * 判断是否为数组
    * @param val 要检查的值
    * @returns 如果值是数组，则返回 true，否则返回 false
    */
-  isArray(t) {
-    return Array.isArray(t);
+  isArray(e) {
+    return Array.isArray(e);
   },
   /**
    * 判断是否为函数
    * @param val 要检查的值
    * @returns
    */
-  isFunction(t) {
-    return typeof t == "function";
+  isFunction(e) {
+    return typeof e == "function";
   },
   /**
    * 判断是否为 Promise 对象
@@ -129,41 +182,41 @@ const i = (t) => {
    * @returns 如果对象是 Promise 对象，则返回 true，否则返回 false
    */
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  isPromise(t) {
-    return !!t && (typeof t == "object" || typeof t == "function") && typeof t.then == "function";
+  isPromise(e) {
+    return !!e && (typeof e == "object" || typeof e == "function") && typeof e.then == "function";
   },
   /**
    * 判断是否为 DOM 元素
    * @param obj 要检查的对象
    * @returns 如果对象是 DOM 元素，则返回 true，否则返回 false
    */
-  isElement(t) {
-    return t instanceof Element;
+  isElement(e) {
+    return e instanceof Element;
   },
   /**
    * 判断手机号格式（中国）
    * @param str 手机号字符串
    * @returns true 表示手机号格式正确，false 表示手机号格式错误
    */
-  isPhone(t) {
-    return /^1[3-9]\d{9}$/.test(t);
+  isPhone(e) {
+    return /^1[3-9]\d{9}$/.test(e);
   },
   /**
    * 判断邮箱格式
    * @param str 邮箱字符串
    * @returns true 表示邮箱格式正确，false 表示邮箱格式错误
    */
-  isEmail(t) {
-    return /^[\w.-]+@[\w.-]+\.\w+$/.test(t);
+  isEmail(e) {
+    return /^[\w.-]+@[\w.-]+\.\w+$/.test(e);
   },
   /**
    * 判断字符串是否为 JSON
    * @param str 字符串
    * @returns true 表示是 JSON，false 表示不是 JSON
    */
-  isJSON(t) {
+  isJSON(e) {
     try {
-      return JSON.parse(t), !0;
+      return JSON.parse(e), !0;
     } catch {
       return !1;
     }
@@ -176,17 +229,17 @@ const i = (t) => {
    * const img = new Image();
    * img.src = "URL_ADDRESS   * img.src = "https://example.com/image.jpg";
    */
-  isImageLoaded(t) {
-    return t.complete && t.naturalWidth !== 0;
+  isImageLoaded(e) {
+    return e.complete && e.naturalWidth !== 0;
   },
   /**
    * 判断元素是否在可视区域内
    * @param el 元素对象
    * @returns true 表示元素在可视区域内，false 表示元素不在可视区域内
    */
-  isInViewport(t) {
-    const e = t.getBoundingClientRect();
-    return e.top >= 0 && e.left >= 0 && e.bottom <= window.innerHeight && e.right <= window.innerWidth;
+  isInViewport(e) {
+    const t = e.getBoundingClientRect();
+    return t.top >= 0 && t.left >= 0 && t.bottom <= window.innerHeight && t.right <= window.innerWidth;
   },
   /**
    * 判断是否为闰年
@@ -200,8 +253,8 @@ const i = (t) => {
    * isLeapYear(2025); // false
    * isLeapYear(2024); // true
    */
-  isLeapYear(t) {
-    return t % 4 === 0 && t % 100 !== 0 || t % 400 === 0;
+  isLeapYear(e) {
+    return e % 4 === 0 && e % 100 !== 0 || e % 400 === 0;
   },
   /**
    * 判断是否为移动端
@@ -210,16 +263,16 @@ const i = (t) => {
   isMobile() {
     return /Mobi|Android|iPhone/i.test(navigator.userAgent);
   }
-}, m = {
+}, _ = {
   /**
    * 通过传入的name获取cookie的值
    * @param name cookie的name
    * @returns cookie的值
    */
-  getCookie(t) {
-    if (!t) return;
-    const e = document.cookie.match(new RegExp("(^| )" + t + "=([^;]+)"));
-    return e ? decodeURIComponent(e[2]) : null;
+  getCookie(e) {
+    if (!e) return;
+    const t = document.cookie.match(new RegExp("(^| )" + e + "=([^;]+)"));
+    return t ? decodeURIComponent(t[2]) : null;
   },
   /**
    * 设置 cookie
@@ -228,27 +281,27 @@ const i = (t) => {
    * @param days cookie的过期时间，默认7天。如果为0，则表示cookie在会话结束时过期。如果为负数，则表示cookie已过期。
    * @returns void
    */
-  setCookie(t, e, r = 7) {
-    const n = /* @__PURE__ */ new Date();
-    n.setTime(n.getTime() + r * 24 * 60 * 60 * 1e3), document.cookie = `${t}=${encodeURIComponent(e)};expires=${n.toUTCString()};path=/`;
+  setCookie(e, t, n = 7) {
+    const r = /* @__PURE__ */ new Date();
+    r.setTime(r.getTime() + n * 24 * 60 * 60 * 1e3), document.cookie = `${e}=${encodeURIComponent(t)};expires=${r.toUTCString()};path=/`;
   },
   /**
    * 删除cookie
    * @param name cookie的name
    * @returns void
    */
-  deleteCookie(t) {
-    this.setCookie(t, "", -1);
+  deleteCookie(e) {
+    this.setCookie(e, "", -1);
   }
-}, b = {
+}, C = {
   /**
    * 获取当前时间字符串
    * @param locales 区域设置。如：'zh-CN'，'en-US'，"chinese"。默认'zh-CN'。
    * @param hour12 是否使用12小时制。默认false，使用24小时制。
    * @returns 当前时间的字符串。如：'2025/5/27 16:54:45'
    */
-  getTimeString(t, e = !1) {
-    return e ? (/* @__PURE__ */ new Date()).toLocaleString(t, { hour12: !0 }) : (/* @__PURE__ */ new Date()).toLocaleString("chinese", { hour12: !1 });
+  getTimeString(e, t = !1) {
+    return t ? (/* @__PURE__ */ new Date()).toLocaleString(e, { hour12: !0 }) : (/* @__PURE__ */ new Date()).toLocaleString("chinese", { hour12: !1 });
   },
   /**
    * 计算两个日期相差天数
@@ -256,9 +309,9 @@ const i = (t) => {
    * @param date2 日期2
    * @returns 相差天数
    */
-  diffDays(t, e) {
-    const r = new Date(t).getTime(), n = new Date(e).getTime();
-    return r > n ? Math.abs(Math.floor((r - n) / (24 * 3600 * 1e3))) : Math.abs(Math.floor((n - r) / (24 * 3600 * 1e3)));
+  diffDays(e, t) {
+    const n = new Date(e).getTime(), r = new Date(t).getTime();
+    return n > r ? Math.abs(Math.floor((n - r) / (24 * 3600 * 1e3))) : Math.abs(Math.floor((r - n) / (24 * 3600 * 1e3)));
   },
   /**
    * 生成唯一ID（时间戳+随机数）
@@ -267,61 +320,98 @@ const i = (t) => {
   uniqueId() {
     return Date.now().toString(36) + Math.random().toString(36).substr(2, 5);
   }
-}, S = {
+}, M = {
+  /**
+   * 将blob对象转化成文件并导出到本地
+   * @param blob blob对象
+   * @param filename 文件名
+   */
+  saveAsBlob(e, t) {
+    const n = document.createElement("a"), r = window.URL.createObjectURL(e);
+    n.href = r, n.download = t, document.body.appendChild(n), n.click(), URL.revokeObjectURL(r), document.body.removeChild(n);
+  }
+}, x = {
+  /**
+   * 获取元素相对于文档顶部的偏移量（距离）
+   * 处理了SVG元素的特殊情况。
+   * @param el 元素
+   * @returns 偏移量（距离值）
+   */
+  getOffsetTop(e) {
+    if (!e)
+      throw new Error("Element is not provided");
+    if (e instanceof SVGElement) {
+      const n = e.getBoundingClientRect(), r = window.pageYOffset || document.documentElement.scrollTop;
+      return n.top + r;
+    }
+    let t = 0;
+    for (; e; )
+      t += e.offsetTop, e = e.offsetParent;
+    return t;
+  }
+}, B = {
   /**
    * 将选中的字母数组从A-Z排序：用于试题选择答案的排序实例
    * @param arr 字母数组
    * @returns
    */
-  sortFromA2Z: (t) => t != null && t.length ? t.sort((r, n) => {
-    const o = r.toUpperCase(), s = n.toUpperCase();
-    return o < s ? -1 : o > s ? 1 : 0;
-  }) : void 0
-}, c = (t) => t > 25 || t < 0 ? "" : "ABCDEFGHIJKLMNOPQRSTUVWXYZ"[t], l = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  sortFromA2Z(e) {
+    return e != null && e.length ? e.sort((n, r) => {
+      const o = n.toUpperCase(), i = r.toUpperCase();
+      return o < i ? -1 : o > i ? 1 : 0;
+    }) : void 0;
+  }
+}, h = (e) => e > 25 || e < 0 ? "" : "ABCDEFGHIJKLMNOPQRSTUVWXYZ"[e], y = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
-  toLetter: c
-}, Symbol.toStringTag, { value: "Module" })), a = (t) => t.toFixed(2).toString().replace(/\B(?=(\d{3})+(?!\d))/g, ","), f = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  toLetter: h
+}, Symbol.toStringTag, { value: "Module" })), m = (e) => e.toFixed(2).toString().replace(/\B(?=(\d{3})+(?!\d))/g, ","), w = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
-  toMoney: a
-}, Symbol.toStringTag, { value: "Module" })), O = {
-  ...l,
-  ...f,
+  toMoney: m
+}, Symbol.toStringTag, { value: "Module" })), L = {
+  ...y,
+  ...w,
   /**
    * 判断是否为数字
    * @param val 待判断的值
    * @returns 是否为数字。true 是；false 否
    */
-  isNumber(t) {
-    return typeof t == "number" && !isNaN(t);
+  isNumber(e) {
+    return typeof e == "number" && !isNaN(e);
   }
-}, w = {
+}, I = {
   /**
    * 判断对象是否为空
    * @param obj 对象
    * @returns 是否为空。true 为空；false 不为空
    */
-  isEmptyObject: (t) => t ? Object.keys(t).length === 0 && t.constructor === Object : !0
-}, U = {
+  isEmptyObject(e) {
+    return e ? Object.keys(e).length === 0 && e.constructor === Object : !0;
+  }
+}, T = {
   /**
    * 脱敏
    * @param phone 电话号码/手机号码
    * @returns 脱敏后的电话号码/手机号码
    */
-  desensitize: (t) => t ? t.replace(/^(\d{3})\d{4}(\d{4})$/, "$1****$2") || t.slice(0, 3) + "****" + t.slice(7) : ""
-}, M = {
+  desensitize(e) {
+    return e ? e.replace(/^(\d{3})\d{4}(\d{4})$/, "$1****$2") || e.slice(0, 3) + "****" + e.slice(7) : "";
+  }
+}, k = {
   /**
    * 生成随机颜色
    * @returns 随机颜色值
    */
-  color: () => `#${Math.random().toString(16).slice(2, 8)}`,
+  color: function() {
+    return `#${Math.random().toString(16).slice(2, 8)}`;
+  },
   /**
    * 生成指定范围的随机整数
    * @param min 最小值
    * @param max 最大值
    * @returns 随机数
    */
-  int(t, e) {
-    return Math.floor(Math.random() * (e - t + 1)) + t;
+  int(e, t) {
+    return Math.floor(Math.random() * (t - e + 1)) + e;
   },
   /**
    * 生成唯一ID（时间戳+随机数）
@@ -330,65 +420,65 @@ const i = (t) => {
   uniqueId() {
     return Date.now().toString(36) + Math.random().toString(36).substr(2, 5);
   }
-}, _ = {
+}, v = {
   /**
    * 通过key值获取 localStorage 中存储的某个值
    * @param key 获取的key
    * @returns 获取的值
    */
-  getLocal(t) {
-    return localStorage.getItem(t);
+  getLocal(e) {
+    return localStorage.getItem(e);
   },
   /**
    * 设置localStorage中的某个值
    * @param key 设置的key
    * @param value 设置的value
    */
-  setLocal(t, e) {
-    localStorage.setItem(t, e);
+  setLocal(e, t) {
+    localStorage.setItem(e, t);
   },
   /**
    * 删除localStorage中的某个值
    * @param key 删除的key
    */
-  removeLocal(t) {
-    localStorage.removeItem(t);
+  removeLocal(e) {
+    localStorage.removeItem(e);
   },
   /**
    * 通过key值获取 sessionStorage 中存储的某个值
    * @param key 获取的key
    * @returns 获取的值
    */
-  getSession(t) {
-    return sessionStorage.getItem(t);
+  getSession(e) {
+    return sessionStorage.getItem(e);
   },
   /**
    * 设置sessionStorage中的某个值
    * @param key 设置的key
    * @param value 设置的value
    */
-  setSession(t, e) {
-    sessionStorage.setItem(t, e);
+  setSession(e, t) {
+    sessionStorage.setItem(e, t);
   },
   /**
    * 删除sessionStorage中的某个值
    * @param key 删除的key
    */
-  removeSession(t) {
-    sessionStorage.removeItem(t);
+  removeSession(e) {
+    sessionStorage.removeItem(e);
   }
-}, j = {
+}, R = {
   /**
    * 判断某元素是否在字符串中-比includes()方法更兼容，includes为ES6新增方法，IE不支持。小程序也不支持
    * @param str 字符串
    * @param element 查询元素
    * @returns 是否存在。true 存在；false 不存在
    */
-  isExist(t, e) {
-    if (!t || !e)
+  isExist(e, t) {
+    if (!e || !t)
       return !1;
-    const r = t.split(",");
-    return console.log("判断某元素是否在字符串中", r.indexOf(e) === -1), r.indexOf(e) !== -1;
+    const n = e.split(",");
+    return console.log("判断某元素是否在字符串中", n.indexOf(t) === -1), n.indexOf(t) !== -1;
   },
   /**
    * 判断某元素是否在字符串中-比isExist()方法更高效。
@@ -396,72 +486,82 @@ const i = (t) => {
    * @param element 查询元素
    * @returns 是否存在。true 存在；false 不存在
    */
-  includes(t, e) {
-    return !t || !e ? !1 : t.includes(e);
+  includes(e, t) {
+    return !e || !t ? !1 : e.includes(t);
   },
   /**
    * 判断字符串是否为 JSON
    * @param str 字符串
    * @returns
    */
-  isJSON(t) {
+  isJSON(e) {
     try {
-      return JSON.parse(t), !0;
+      return JSON.parse(e), !0;
     } catch {
       return !1;
     }
   }
-}, g = (t) => {
-  const r = new RegExp("[?&]" + t + "=([^&#]*)", "i").exec(window.location.href);
-  return r ? decodeURIComponent(r[1]) : null;
+}, S = (e) => {
+  const n = new RegExp("[?&]" + e + "=([^&#]*)", "i").exec(window.location.href);
+  return n ? decodeURIComponent(n[1]) : null;
 };
-function d(t) {
-  return new URLSearchParams(window.location.search).get(t);
+function O(e) {
+  return new URLSearchParams(window.location.search).get(e);
 }
-const p = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+const U = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
-  getQueryInfoByName: g,
-  getQueryParam: d
-}, Symbol.toStringTag, { value: "Module" })), E = {
-  ...p,
+  getQueryInfoByName: S,
+  getQueryParam: O
+}, Symbol.toStringTag, { value: "Module" })), N = {
+  ...U,
   /**
    * 获取当前域名
    * @returns 当前url链接的host信息
    */
   getHost() {
     return window.location.host;
+  },
+  /**
+   * 获取当前页面路径
+   * @returns 当前url链接的pathname信息
+   */
+  getPath() {
+    return window.location.pathname;
   }
-}, I = {
+}, P = {
   /**
    * 处理瀑布流数据，使其适合瀑布流布局展示
    * @param list 瀑布流数据-数组
    * @param columnsNum 需要展示的列数
    * @returns 适合瀑布流布局的数组
    */
-  toList: (t, e = 2) => {
-    console.log(t, e);
-    const r = {};
-    for (let o = 0; o < e; o++)
-      r[o] = [];
-    t.forEach((o, s) => r[s % e].push(o));
-    const n = [];
-    for (const o in r)
-      n.push(...r[o]);
-    return n;
+  toList(e, t = 2) {
+    console.log(e, t);
+    const n = {};
+    for (let o = 0; o < t; o++)
+      n[o] = [];
+    e.forEach((o, i) => n[i % t].push(o));
+    const r = [];
+    for (const o in n)
+      r.push(...n[o]);
+    return r;
   }
 };
 export {
-  h as arrayUtils,
-  y as booleanUtils,
-  m as cookieUtils,
-  b as dateUtils,
-  S as letterUtils,
-  O as numberUtils,
-  w as objectUtils,
-  U as phoneUtils,
-  M as randomUtils,
-  _ as storageUtils,
-  j as stringUtils,
-  E as urlUtils,
-  I as waterfallUtils
+  A as arrayUtils,
+  j as base64Utils,
+  E as booleanUtils,
+  _ as cookieUtils,
+  C as dateUtils,
+  M as downloadUtils,
+  x as elementUtils,
+  B as letterUtils,
+  L as numberUtils,
+  I as objectUtils,
+  T as phoneUtils,
+  k as randomUtils,
+  v as storageUtils,
+  R as stringUtils,
+  N as urlUtils,
+  P as waterfallUtils
 };

package/dist/utils.umd.cjs

@@ -1 +1 @@
-(function(o,s){typeof exports=="object"&&typeof module<"u"?s(exports):typeof define=="function"&&define.amd?define(["exports"],s):(o=typeof globalThis<"u"?globalThis:o||self,s(o.yhkitUtils={}))})(this,function(o){"use strict";const l={...Object.freeze(Object.defineProperty({__proto__:null,toEnumObj:t=>{if(!t||!t.length)return{};const e={};return t.forEach(r=>{const n=Object.assign({label:r.label,text:r.label},r);e[r==null?void 0:r.value]=n}),e}},Symbol.toStringTag,{value:"Module"})),unique:t=>t?Array.from(new Set(t)):[],isExist(t,e){return!t||!e?!1:t.indexOf(e)!==-1},countOfAppear(t,e){let r=0;for(const n of t)n===e&&r++;return r},sort(t,e="asc"){return t?t.sort((r,n)=>e==="asc"?r>n?1:-1:r<n?1:-1):[]},shuffle(t){if(!t)return[];for(let e=t.length-1;e>0;e--){const r=Math.floor(Math.random()*(e+1));[t[e],t[r]]=[t[r],t[e]]}return t}},c={isEmptyString(t){return typeof t=="string"&&t.trim()===""},isNumber(t){return typeof t=="number"&&!isNaN(t)},isObject(t){return t!==null&&typeof t=="object"&&!Array.isArray(t)},isEmptyObject(t){return t?Object.keys(t).length===0&&t.constructor===Object:!0},isBoolean(t){return typeof t=="boolean"},isArray(t){return Array.isArray(t)},isFunction(t){return typeof t=="function"},isPromise(t){return!!t&&(typeof t=="object"||typeof t=="function")&&typeof t.then=="function"},isElement(t){return t instanceof Element},isPhone(t){return/^1[3-9]\d{9}$/.test(t)},isEmail(t){return/^[\w.-]+@[\w.-]+\.\w+$/.test(t)},isJSON(t){try{return JSON.parse(t),!0}catch{return!1}},isImageLoaded(t){return t.complete&&t.naturalWidth!==0},isInViewport(t){const e=t.getBoundingClientRect();return e.top>=0&&e.left>=0&&e.bottom<=window.innerHeight&&e.right<=window.innerWidth},isLeapYear(t){return t%4===0&&t%100!==0||t%400===0},isMobile(){return/Mobi|Android|iPhone/i.test(navigator.userAgent)}},a={getCookie(t){if(!t)return;const e=document.cookie.match(new RegExp("(^| )"+t+"=([^;]+)"));return e?decodeURIComponent(e[2]):null},setCookie(t,e,r=7){const n=new Date;n.setTime(n.getTime()+r*24*60*60*1e3),document.cookie=`${t}=${encodeURIComponent(e)};expires=${n.toUTCString()};path=/`},deleteCookie(t){this.setCookie(t,"",-1)}},f={getTimeString(t,e=!1){return e?new Date().toLocaleString(t,{hour12:!0}):new Date().toLocaleString("chinese",{hour12:!1})},diffDays(t,e){const r=new Date(t).getTime(),n=new Date(e).getTime();return r>n?Math.abs(Math.floor((r-n)/(24*3600*1e3))):Math.abs(Math.floor((n-r)/(24*3600*1e3)))},uniqueId(){return Date.now().toString(36)+Math.random().toString(36).substr(2,5)}},d={sortFromA2Z:t=>t!=null&&t.length?t.sort((r,n)=>{const i=r.toUpperCase(),u=n.toUpperCase();return i<u?-1:i>u?1:0}):void 0},g={...Object.freeze(Object.defineProperty({__proto__:null,toLetter:t=>t>25||t<0?"":"ABCDEFGHIJKLMNOPQRSTUVWXYZ"[t]},Symbol.toStringTag,{value:"Module"})),...Object.freeze(Object.defineProperty({__proto__:null,toMoney:t=>t.toFixed(2).toString().replace(/\B(?=(\d{3})+(?!\d))/g,",")},Symbol.toStringTag,{value:"Module"})),isNumber(t){return typeof t=="number"&&!isNaN(t)}},y={isEmptyObject:t=>t?Object.keys(t).length===0&&t.constructor===Object:!0},m={desensitize:t=>t?t.replace(/^(\d{3})\d{4}(\d{4})$/,"$1****$2")||t.slice(0,3)+"****"+t.slice(7):""},b={color:()=>`#${Math.random().toString(16).slice(2,8)}`,int(t,e){return Math.floor(Math.random()*(e-t+1))+t},uniqueId(){return Date.now().toString(36)+Math.random().toString(36).substr(2,5)}},h={getLocal(t){return localStorage.getItem(t)},setLocal(t,e){localStorage.setItem(t,e)},removeLocal(t){localStorage.removeItem(t)},getSession(t){return sessionStorage.getItem(t)},setSession(t,e){sessionStorage.setItem(t,e)},removeSession(t){sessionStorage.removeItem(t)}},p={isExist(t,e){if(!t||!e)return!1;const r=t.split(",");return console.log("判断某元素是否在字符串中",r.indexOf(e)===-1),r.indexOf(e)!==-1},includes(t,e){return!t||!e?!1:t.includes(e)},isJSON(t){try{return JSON.parse(t),!0}catch{return!1}}},S=t=>{const r=new RegExp("[?&]"+t+"=([^&#]*)","i").exec(window.location.href);return r?decodeURIComponent(r[1]):null};function U(t){return new URLSearchParams(window.location.search).get(t)}const O={...Object.freeze(Object.defineProperty({__proto__:null,getQueryInfoByName:S,getQueryParam:U},Symbol.toStringTag,{value:"Module"})),getHost(){return window.location.host}},w={toList:(t,e=2)=>{console.log(t,e);const r={};for(let i=0;i<e;i++)r[i]=[];t.forEach((i,u)=>r[u%e].push(i));const n=[];for(const i in r)n.push(...r[i]);return n}};o.arrayUtils=l,o.booleanUtils=c,o.cookieUtils=a,o.dateUtils=f,o.letterUtils=d,o.numberUtils=g,o.objectUtils=y,o.phoneUtils=m,o.randomUtils=b,o.storageUtils=h,o.stringUtils=p,o.urlUtils=O,o.waterfallUtils=w,Object.defineProperty(o,Symbol.toStringTag,{value:"Module"})});
+(function(r,g){typeof exports=="object"&&typeof module<"u"?g(exports):typeof define=="function"&&define.amd?define(["exports"],g):(r=typeof globalThis<"u"?globalThis:r||self,g(r.yhkitUtils={}))})(this,function(r){"use strict";const h=Object.assign({unique(e){return e?Array.from(new Set(e)):[]},isExist(e,t){return!e||!t?!1:e.indexOf(t)!==-1},countOfAppear(e,t){let n=0;for(const o of e)o===t&&n++;return n},sort(e,t="asc"){return e?e.sort((n,o)=>t==="asc"?n>o?1:-1:n<o?1:-1):[]},shuffle(e){if(!e)return[];for(let t=e.length-1;t>0;t--){const n=Math.floor(Math.random()*(t+1));[e[t],e[n]]=[e[n],e[t]]}return e}},{...Object.freeze(Object.defineProperty({__proto__:null,toEnumObj:e=>{if(!e||!e.length)return{};const t={};return e.forEach(n=>{const o=Object.assign({label:n.label,text:n.label},n);t[n==null?void 0:n.value]=o}),t}},Symbol.toStringTag,{value:"Module"}))}),p={toBlob(e,t="",n=512){const s=(e.split(",")[1]||e).replace(/-/g,"+").replace(/_/g,"/"),l="=".repeat((4-s.length%4)%4),y=s+l;try{const a=atob(y),d=[];for(let u=0;u<a.length;u+=n){const c=a.slice(u,u+n),f=new Array(c.length);for(let i=0;i<c.length;i++)f[i]=c.charCodeAt(i);const b=new Uint8Array(f);d.push(b)}return new Blob(d,{type:t})}catch(a){return console.error("Failed to convert base64 to blob:",a),null}},toFile(e,t="file.txt",n="text/plain"){const s=e.replace(/^data:.+;base64,/,"").replace(/-/g,"+").replace(/_/g,"/"),l="=".repeat((4-s.length%4)%4),y=s+l,a=atob(y),d=[];for(let c=0;c<a.length;c+=512){const f=a.slice(c,c+512),b=new Array(f.length);for(let i=0;i<f.length;i++)b[i]=f.charCodeAt(i);d.push(new Uint8Array(b))}const u=new Blob(d,{type:n});return new File([u],t,{type:n})}},m={isEmptyString(e){return typeof e=="string"&&e.trim()===""},isNumber(e){return typeof e=="number"&&!isNaN(e)},isObject(e){return e!==null&&typeof e=="object"&&!Array.isArray(e)},isEmptyObject(e){return e?Object.keys(e).length===0&&e.constructor===Object:!0},isBoolean(e){return typeof e=="boolean"},isArray(e){return Array.isArray(e)},isFunction(e){return typeof e=="function"},isPromise(e){return!!e&&(typeof e=="object"||typeof e=="function")&&typeof e.then=="function"},isElement(e){return e instanceof Element},isPhone(e){return/^1[3-9]\d{9}$/.test(e)},isEmail(e){return/^[\w.-]+@[\w.-]+\.\w+$/.test(e)},isJSON(e){try{return JSON.parse(e),!0}catch{return!1}},isImageLoaded(e){return e.complete&&e.naturalWidth!==0},isInViewport(e){const t=e.getBoundingClientRect();return t.top>=0&&t.left>=0&&t.bottom<=window.innerHeight&&t.right<=window.innerWidth},isLeapYear(e){return e%4===0&&e%100!==0||e%400===0},isMobile(){return/Mobi|Android|iPhone/i.test(navigator.userAgent)}},U={getCookie(e){if(!e)return;const t=document.cookie.match(new RegExp("(^| )"+e+"=([^;]+)"));return t?decodeURIComponent(t[2]):null},setCookie(e,t,n=7){const o=new Date;o.setTime(o.getTime()+n*24*60*60*1e3),document.cookie=`${e}=${encodeURIComponent(t)};expires=${o.toUTCString()};path=/`},deleteCookie(e){this.setCookie(e,"",-1)}},w={getTimeString(e,t=!1){return t?new Date().toLocaleString(e,{hour12:!0}):new Date().toLocaleString("chinese",{hour12:!1})},diffDays(e,t){const n=new Date(e).getTime(),o=new Date(t).getTime();return n>o?Math.abs(Math.floor((n-o)/(24*3600*1e3))):Math.abs(Math.floor((o-n)/(24*3600*1e3)))},uniqueId(){return Date.now().toString(36)+Math.random().toString(36).substr(2,5)}},S={saveAsBlob(e,t){const n=document.createElement("a"),o=window.URL.createObjectURL(e);n.href=o,n.download=t,document.body.appendChild(n),n.click(),URL.revokeObjectURL(o),document.body.removeChild(n)}},O={getOffsetTop(e){if(!e)throw new Error("Element is not provided");if(e instanceof SVGElement){const n=e.getBoundingClientRect(),o=window.pageYOffset||document.documentElement.scrollTop;return n.top+o}let t=0;for(;e;)t+=e.offsetTop,e=e.offsetParent;return t}},j={sortFromA2Z(e){return e!=null&&e.length?e.sort((n,o)=>{const s=n.toUpperCase(),l=o.toUpperCase();return s<l?-1:s>l?1:0}):void 0}},A={...Object.freeze(Object.defineProperty({__proto__:null,toLetter:e=>e>25||e<0?"":"ABCDEFGHIJKLMNOPQRSTUVWXYZ"[e]},Symbol.toStringTag,{value:"Module"})),...Object.freeze(Object.defineProperty({__proto__:null,toMoney:e=>e.toFixed(2).toString().replace(/\B(?=(\d{3})+(?!\d))/g,",")},Symbol.toStringTag,{value:"Module"})),isNumber(e){return typeof e=="number"&&!isNaN(e)}},E={isEmptyObject(e){return e?Object.keys(e).length===0&&e.constructor===Object:!0}},M={desensitize(e){return e?e.replace(/^(\d{3})\d{4}(\d{4})$/,"$1****$2")||e.slice(0,3)+"****"+e.slice(7):""}},_={color:function(){return`#${Math.random().toString(16).slice(2,8)}`},int(e,t){return Math.floor(Math.random()*(t-e+1))+e},uniqueId(){return Date.now().toString(36)+Math.random().toString(36).substr(2,5)}},C={getLocal(e){return localStorage.getItem(e)},setLocal(e,t){localStorage.setItem(e,t)},removeLocal(e){localStorage.removeItem(e)},getSession(e){return sessionStorage.getItem(e)},setSession(e,t){sessionStorage.setItem(e,t)},removeSession(e){sessionStorage.removeItem(e)}},T={isExist(e,t){if(!e||!t)return!1;const n=e.split(",");return console.log("判断某元素是否在字符串中",n.indexOf(t)===-1),n.indexOf(t)!==-1},includes(e,t){return!e||!t?!1:e.includes(t)},isJSON(e){try{return JSON.parse(e),!0}catch{return!1}}},L=e=>{const n=new RegExp("[?&]"+e+"=([^&#]*)","i").exec(window.location.href);return n?decodeURIComponent(n[1]):null};function B(e){return new URLSearchParams(window.location.search).get(e)}const k={...Object.freeze(Object.defineProperty({__proto__:null,getQueryInfoByName:L,getQueryParam:B},Symbol.toStringTag,{value:"Module"})),getHost(){return window.location.host},getPath(){return window.location.pathname}},I={toList(e,t=2){console.log(e,t);const n={};for(let s=0;s<t;s++)n[s]=[];e.forEach((s,l)=>n[l%t].push(s));const o=[];for(const s in n)o.push(...n[s]);return o}};r.arrayUtils=h,r.base64Utils=p,r.booleanUtils=m,r.cookieUtils=U,r.dateUtils=w,r.downloadUtils=S,r.elementUtils=O,r.letterUtils=j,r.numberUtils=A,r.objectUtils=E,r.phoneUtils=M,r.randomUtils=_,r.storageUtils=C,r.stringUtils=T,r.urlUtils=k,r.waterfallUtils=I,Object.defineProperty(r,Symbol.toStringTag,{value:"Module"})});

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@yh-kit/utils",
   "private": false,
-  "version": "1.3.0",
+  "version": "1.4.0",
   "type": "module",
   "files": [
     "dist",
@@ -35,4 +35,4 @@
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   }
-}
+}

package/types/utils/lib/array/index.d.ts

@@ -7,7 +7,7 @@ export declare const arrayUtils: {
      * @param arr 数组
      * @returns 去重后的数组
      */
-    unique: <T>(arr: T[]) => T[];
+    unique<T>(arr: T[]): T[];
     /**
      * 判断某元素是否在数组中
      * @param arr 数组
@@ -41,5 +41,6 @@ export declare const arrayUtils: {
      * @returns
      */
     shuffle<T>(arr: T[]): T[];
-    toEnumObj: (arr: import("../../../typings/src").IOptionItem[]) => import("../../../typings/src").TValueEnum;
+} & {
+    toEnumObj: (arr: import("@yh-kit/types").IOptionItem[]) => import("@yh-kit/types").TValueEnum;
 };

package/types/utils/lib/base64/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Base64 相关操作工具函数
+ */
+export declare const base64Utils: {
+    /**
+     * 将Base64编码的字符串转换为Blob对象。
+     * Blob对象用于表示二进制大型对象，可以在浏览器环境中处理大文件或二进制数据。
+     *
+     * @param base64 Base64编码的字符串。
+     * @param contentType 可选参数，表示生成的Blob对象的MIME类型，默认为空字符串。
+     * @param sliceSize 可选参数，表示分片大小，默认为512字节。用于控制每次处理的Base64字符串长度，以优化大文件的处理。
+     * @returns 返回转换后的Blob对象，如果转换失败，则返回null。
+     */
+    toBlob(base64: string, contentType?: string, sliceSize?: number): Blob | null;
+    /**
+     * 将Base64编码的字符串转换为File对象。
+     * 这个函数接受一个Base64编码的字符串，一个可选的文件名和一个可选的MIME类型，
+     * 并返回一个代表原始数据的File对象。
+     *
+     * @param base64 Base64编码的字符串。
+     * @param fileName 文件名，默认为"file.txt"。
+     * @param mimeType MIME类型，默认为"text/plain"。
+     * @returns 返回一个File对象，包含解码后的数据。
+     */
+    toFile(base64: string, fileName?: string, mimeType?: string): File;
+};

package/types/utils/lib/boolean/index.d.ts

@@ -1,3 +1,6 @@
+/**
+ * 布尔值相关工具函数
+ */
 export declare const booleanUtils: {
     /**
      * 检查是否为空字符串

package/types/utils/lib/download/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 下载相关工具函数
+ */
+export declare const downloadUtils: {
+    /**
+     * 将blob对象转化成文件并导出到本地
+     * @param blob blob对象
+     * @param filename 文件名
+     */
+    saveAsBlob(blob: Blob | MediaSource, filename: string): void;
+};

package/types/utils/lib/element/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 元素相关工具函数
+ */
+export declare const elementUtils: {
+    /**
+     * 获取元素相对于文档顶部的偏移量（距离）
+     * 处理了SVG元素的特殊情况。
+     * @param el 元素
+     * @returns 偏移量（距离值）
+     */
+    getOffsetTop(el: HTMLElement): number;
+};

package/types/utils/lib/index.d.ts

@@ -1,7 +1,10 @@
 export * from "./array";
+export * from "./base64";
 export * from "./boolean";
 export * from "./cookie";
 export * from "./date";
+export * from "./download";
+export * from "./element";
 export * from "./letter";
 export * from "./number";
 export * from "./object";

package/types/utils/lib/letter/index.d.ts

@@ -7,5 +7,5 @@ export declare const letterUtils: {
      * @param arr 字母数组
      * @returns
      */
-    sortFromA2Z: (arr: string[]) => string[] | undefined;
+    sortFromA2Z(arr: string[]): string[] | undefined;
 };

package/types/utils/lib/object/index.d.ts

@@ -7,5 +7,5 @@ export declare const objectUtils: {
      * @param obj 对象
      * @returns 是否为空。true 为空；false 不为空
      */
-    isEmptyObject: (obj: object) => boolean;
+    isEmptyObject(obj: object): boolean;
 };

package/types/utils/lib/phone/index.d.ts

@@ -7,5 +7,5 @@ export declare const phoneUtils: {
      * @param phone 电话号码/手机号码
      * @returns 脱敏后的电话号码/手机号码
      */
-    desensitize: (phone: string) => string;
+    desensitize(phone: string): string;
 };

package/types/utils/lib/url/index.d.ts

@@ -7,6 +7,11 @@ export declare const urlUtils: {
      * @returns 当前url链接的host信息
      */
     getHost(): string;
+    /**
+     * 获取当前页面路径
+     * @returns 当前url链接的pathname信息
+     */
+    getPath(): string;
     getQueryParam(name: string): string | null;
     getQueryInfoByName: (name: string) => string | null;
 };

package/types/utils/lib/waterfall/index.d.ts

@@ -8,5 +8,5 @@ export declare const waterfallUtils: {
      * @param columnsNum 需要展示的列数
      * @returns 适合瀑布流布局的数组
      */
-    toList: <T>(list: T[], columnsNum?: number) => any[];
+    toList<T>(list: T[], columnsNum?: number): any[];
 };