@yh-kit/utils 1.3.1 → 1.5.0

package/dist/utils.js

@@ -1,72 +1,125 @@
-const i = (t) => {
+const b = (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;
+    const o = Object.assign({ label: r.label, text: r.label }, r);
+    e[r == null ? void 0 : r.value] = o;
   }), e;
-}, u = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+}, y = /* @__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: b
+}, Symbol.toStringTag, { value: "Module" })), A = Object.assign(
+  {
+    /**
+     * 数组去重
+     * @param arr 数组
+     * @returns 去重后的数组
+     */
+    unique(t) {
+      return 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 o of t)
+        o === e && r++;
+      return r;
+    },
+    /**
+     * 数组排序-默认升序
+     * @param arr 数组
+     * @param order 排序方式：asc 升序；desc 降序
+     * @returns 排序后的数组
+     */
+    sort(t, e = "asc") {
+      return t ? t.sort((r, o) => e === "asc" ? r > o ? 1 : -1 : r < o ? 1 : -1) : [];
+    },
+    /**
+     * 数组乱序（洗牌算法）
+     * 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]];
+      }
+      return t;
+    }
   },
-  /**
-   * 数组排序-默认升序
-   * @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) : [];
+  {
+    ...y
+  }
+), j = {
+  /**
+   * 将Base64编码的字符串转换为Blob对象。
+   * Blob对象用于表示二进制大型对象，可以在浏览器环境中处理大文件或二进制数据。
+   *
+   * @param base64 Base64编码的字符串。
+   * @param contentType 可选参数，表示生成的Blob对象的MIME类型，默认为空字符串。
+   * @param sliceSize 可选参数，表示分片大小，默认为512字节。用于控制每次处理的Base64字符串长度，以优化大文件的处理。
+   * @returns 返回转换后的Blob对象，如果转换失败，则返回null。
+   */
+  toBlob(t, e = "", r = 512) {
+    const s = (t.split(",")[1] || t).replace(/-/g, "+").replace(/_/g, "/"), l = "=".repeat((4 - s.length % 4) % 4), d = s + l;
+    try {
+      const i = atob(d), g = [];
+      for (let u = 0; u < i.length; u += r) {
+        const n = i.slice(u, u + r), a = new Array(n.length);
+        for (let c = 0; c < n.length; c++)
+          a[c] = n.charCodeAt(c);
+        const f = new Uint8Array(a);
+        g.push(f);
+      }
+      return new Blob(g, { type: e });
+    } catch (i) {
+      return console.error("Failed to convert base64 to blob:", i), 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(t, e = "file.txt", r = "text/plain") {
+    const s = t.replace(/^data:.+;base64,/, "").replace(/-/g, "+").replace(/_/g, "/"), l = "=".repeat((4 - s.length % 4) % 4), d = s + l, i = atob(d), g = [];
+    for (let n = 0; n < i.length; n += 512) {
+      const a = i.slice(n, n + 512), f = new Array(a.length);
+      for (let c = 0; c < a.length; c++)
+        f[c] = a.charCodeAt(c);
+      g.push(new Uint8Array(f));
     }
-    return t;
+    const u = new Blob(g, { type: r });
+    return new File([u], e, { type: r });
   }
-}, y = {
+}, x = {
   /**
    * 检查是否为空字符串
    * @param str 要检查的字符串
@@ -210,7 +263,7 @@ const i = (t) => {
   isMobile() {
     return /Mobi|Android|iPhone/i.test(navigator.userAgent);
   }
-}, m = {
+}, C = {
   /**
    * 通过传入的name获取cookie的值
    * @param name cookie的name
@@ -229,8 +282,8 @@ const i = (t) => {
    * @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=/`;
+    const o = /* @__PURE__ */ new Date();
+    o.setTime(o.getTime() + r * 24 * 60 * 60 * 1e3), document.cookie = `${t}=${encodeURIComponent(e)};expires=${o.toUTCString()};path=/`;
   },
   /**
    * 删除cookie
@@ -240,7 +293,7 @@ const i = (t) => {
   deleteCookie(t) {
     this.setCookie(t, "", -1);
   }
-}, b = {
+}, _ = {
   /**
    * 获取当前时间字符串
    * @param locales 区域设置。如：'zh-CN'，'en-US'，"chinese"。默认'zh-CN'。
@@ -257,8 +310,8 @@ const i = (t) => {
    * @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)));
+    const r = new Date(t).getTime(), o = new Date(e).getTime();
+    return r > o ? Math.abs(Math.floor((r - o) / (24 * 3600 * 1e3))) : Math.abs(Math.floor((o - r) / (24 * 3600 * 1e3)));
   },
   /**
    * 生成唯一ID（时间戳+随机数）
@@ -267,25 +320,112 @@ const i = (t) => {
   uniqueId() {
     return Date.now().toString(36) + Math.random().toString(36).substr(2, 5);
   }
-}, S = {
+}, N = {
+  /**
+   * 将blob对象转化成文件并导出到本地
+   * @param blob blob对象
+   * @param filename 文件名
+   */
+  saveAsBlob(t, e) {
+    const r = document.createElement("a"), o = window.URL.createObjectURL(t);
+    r.href = o, r.download = e, document.body.appendChild(r), r.click(), URL.revokeObjectURL(o), document.body.removeChild(r);
+  }
+}, B = {
+  /**
+   * 获取元素相对于文档顶部的偏移量（距离）
+   * 处理了SVG元素的特殊情况。
+   * @param el 元素
+   * @returns 偏移量（距离值）
+   */
+  getOffsetTop(t) {
+    if (!t)
+      throw new Error("Element is not provided");
+    if (t instanceof SVGElement) {
+      const r = t.getBoundingClientRect(), o = window.pageYOffset || document.documentElement.scrollTop;
+      return r.top + o;
+    }
+    let e = 0;
+    for (; t; )
+      e += t.offsetTop, t = t.offsetParent;
+    return e;
+  }
+}, I = {
   /**
    * 将选中的字母数组从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(t) {
+    return t != null && t.length ? t.sort((r, o) => {
+      const s = r.toUpperCase(), l = o.toUpperCase();
+      return s < l ? -1 : s > l ? 1 : 0;
+    }) : void 0;
+  }
+};
+class L {
+  /**
+   * 转换为标准金额格式（带千分位和两位小数）
+   * @param num 要转换的数字
+   * @returns 格式化后的字符串
+   */
+  static toStandardFormat(e) {
+    try {
+      const r = typeof e == "string" ? parseFloat(e) : e;
+      if (isNaN(r))
+        throw new Error("输入不是有效的数字");
+      if (!isFinite(r))
+        throw new Error("输入是无穷大");
+      return r.toFixed(2).toString().replace(/\B(?=(\d{3})+(?!\d))/g, ",");
+    } catch (r) {
+      return console.error("格式化失败:", r), "格式错误";
+    }
+  }
+  /**
+   * 转换为中文大写金额
+   * @param num 要转换的数字
+   * @returns 中文大写金额字符串
+   */
+  static toChineseFormat(e) {
+    try {
+      const r = typeof e == "string" ? parseFloat(e) : e;
+      if (isNaN(r))
+        throw new Error("输入不是有效的数字");
+      if (r > 9999999999999e-2 || r < -9999999999999e-2)
+        throw new Error("输入数字超出范围");
+      const o = r < 0, s = Math.abs(r), l = Math.floor(s), d = Math.round((s - l) * 100), i = ["零", "壹", "贰", "叁", "肆", "伍", "陆", "柒", "捌", "玖"], g = ["", "拾", "佰", "仟", "万", "拾", "佰", "仟", "亿", "拾", "佰", "仟"], u = ["角", "分"];
+      let n = "", a = l;
+      if (a === 0)
+        n = i[0];
+      else {
+        let h = 0;
+        for (; a > 0; ) {
+          const p = a % 10;
+          p !== 0 ? n = i[p] + g[h] + n : n.charAt(0) !== i[0] && (n = i[p] + n), a = Math.floor(a / 10), h++;
+        }
+        n = n.replace(/零+/g, "零"), n = n.replace(/零+$/, "");
+      }
+      let f = "";
+      if (d > 0) {
+        const h = Math.floor(d / 10), p = d % 10;
+        h > 0 && (f += i[h] + u[0]), p > 0 && (f += i[p] + u[1]);
+      } else
+        f = "整";
+      let c = (o ? "负" : "") + n + "圆" + f;
+      return c === "零圆整" && (c = "零圆"), c;
+    } catch (r) {
+      return console.error("转换失败:", r), "格式错误";
+    }
+  }
+}
+const m = (t) => t > 25 || t < 0 ? "" : "ABCDEFGHIJKLMNOPQRSTUVWXYZ"[t], w = /* @__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: m
+}, Symbol.toStringTag, { value: "Module" })), S = (t) => t.toFixed(2).toString().replace(/\B(?=(\d{3})+(?!\d))/g, ","), O = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
-  toMoney: a
-}, Symbol.toStringTag, { value: "Module" })), O = {
-  ...l,
-  ...f,
+  toMoney: S
+}, Symbol.toStringTag, { value: "Module" })), T = {
+  ...w,
+  ...O,
   /**
    * 判断是否为数字
    * @param val 待判断的值
@@ -294,26 +434,32 @@ const i = (t) => {
   isNumber(t) {
     return typeof t == "number" && !isNaN(t);
   }
-}, w = {
+}, v = {
   /**
    * 判断对象是否为空
    * @param obj 对象
    * @returns 是否为空。true 为空；false 不为空
    */
-  isEmptyObject: (t) => t ? Object.keys(t).length === 0 && t.constructor === Object : !0
-}, U = {
+  isEmptyObject(t) {
+    return t ? Object.keys(t).length === 0 && t.constructor === Object : !0;
+  }
+}, F = {
   /**
    * 脱敏
    * @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(t) {
+    return t ? t.replace(/^(\d{3})\d{4}(\d{4})$/, "$1****$2") || t.slice(0, 3) + "****" + t.slice(7) : "";
+  }
+}, P = {
   /**
    * 生成随机颜色
    * @returns 随机颜色值
    */
-  color: () => `#${Math.random().toString(16).slice(2, 8)}`,
+  color: function() {
+    return `#${Math.random().toString(16).slice(2, 8)}`;
+  },
   /**
    * 生成指定范围的随机整数
    * @param min 最小值
@@ -330,7 +476,7 @@ const i = (t) => {
   uniqueId() {
     return Date.now().toString(36) + Math.random().toString(36).substr(2, 5);
   }
-}, _ = {
+}, k = {
   /**
    * 通过key值获取 localStorage 中存储的某个值
    * @param key 获取的key
@@ -377,7 +523,7 @@ const i = (t) => {
   removeSession(t) {
     sessionStorage.removeItem(t);
   }
-}, j = {
+}, R = {
   /**
    * 判断某元素是否在字符串中-比includes()方法更兼容，includes为ES6新增方法，IE不支持。小程序也不支持
    * @param str 字符串
@@ -411,57 +557,68 @@ const i = (t) => {
       return !1;
     }
   }
-}, g = (t) => {
+}, U = (t) => {
   const r = new RegExp("[?&]" + t + "=([^&#]*)", "i").exec(window.location.href);
   return r ? decodeURIComponent(r[1]) : null;
 };
-function d(t) {
+function M(t) {
   return new URLSearchParams(window.location.search).get(t);
 }
-const p = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+const E = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
-  getQueryInfoByName: g,
-  getQueryParam: d
-}, Symbol.toStringTag, { value: "Module" })), E = {
-  ...p,
+  getQueryInfoByName: U,
+  getQueryParam: M
+}, Symbol.toStringTag, { value: "Module" })), $ = {
+  ...E,
   /**
    * 获取当前域名
    * @returns 当前url链接的host信息
    */
   getHost() {
     return window.location.host;
+  },
+  /**
+   * 获取当前页面路径
+   * @returns 当前url链接的pathname信息
+   */
+  getPath() {
+    return window.location.pathname;
   }
-}, I = {
+}, D = {
   /**
    * 处理瀑布流数据，使其适合瀑布流布局展示
    * @param list 瀑布流数据-数组
    * @param columnsNum 需要展示的列数
    * @returns 适合瀑布流布局的数组
    */
-  toList: (t, e = 2) => {
+  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;
+    for (let s = 0; s < e; s++)
+      r[s] = [];
+    t.forEach((s, l) => r[l % e].push(s));
+    const o = [];
+    for (const s in r)
+      o.push(...r[s]);
+    return o;
   }
 };
 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
+  L as MoneyFormatter,
+  A as arrayUtils,
+  j as base64Utils,
+  x as booleanUtils,
+  C as cookieUtils,
+  _ as dateUtils,
+  N as downloadUtils,
+  B as elementUtils,
+  I as letterUtils,
+  T as numberUtils,
+  v as objectUtils,
+  F as phoneUtils,
+  P as randomUtils,
+  k as storageUtils,
+  R as stringUtils,
+  $ as urlUtils,
+  D 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(o,p){typeof exports=="object"&&typeof module<"u"?p(exports):typeof define=="function"&&define.amd?define(["exports"],p):(o=typeof globalThis<"u"?globalThis:o||self,p(o.yhkitUtils={}))})(this,function(o){"use strict";const m=Object.assign({unique(t){return 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}},{...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"}))}),w={toBlob(t,e="",r=512){const i=(t.split(",")[1]||t).replace(/-/g,"+").replace(/_/g,"/"),u="=".repeat((4-i.length%4)%4),g=i+u;try{const c=atob(g),h=[];for(let f=0;f<c.length;f+=r){const s=c.slice(f,f+r),a=new Array(s.length);for(let l=0;l<s.length;l++)a[l]=s.charCodeAt(l);const d=new Uint8Array(a);h.push(d)}return new Blob(h,{type:e})}catch(c){return console.error("Failed to convert base64 to blob:",c),null}},toFile(t,e="file.txt",r="text/plain"){const i=t.replace(/^data:.+;base64,/,"").replace(/-/g,"+").replace(/_/g,"/"),u="=".repeat((4-i.length%4)%4),g=i+u,c=atob(g),h=[];for(let s=0;s<c.length;s+=512){const a=c.slice(s,s+512),d=new Array(a.length);for(let l=0;l<a.length;l++)d[l]=a.charCodeAt(l);h.push(new Uint8Array(d))}const f=new Blob(h,{type:r});return new File([f],e,{type:r})}},U={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)}},S={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)}},O={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)}},M={saveAsBlob(t,e){const r=document.createElement("a"),n=window.URL.createObjectURL(t);r.href=n,r.download=e,document.body.appendChild(r),r.click(),URL.revokeObjectURL(n),document.body.removeChild(r)}},j={getOffsetTop(t){if(!t)throw new Error("Element is not provided");if(t instanceof SVGElement){const r=t.getBoundingClientRect(),n=window.pageYOffset||document.documentElement.scrollTop;return r.top+n}let e=0;for(;t;)e+=t.offsetTop,t=t.offsetParent;return e}},E={sortFromA2Z(t){return 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}};class A{static toStandardFormat(e){try{const r=typeof e=="string"?parseFloat(e):e;if(isNaN(r))throw new Error("输入不是有效的数字");if(!isFinite(r))throw new Error("输入是无穷大");return r.toFixed(2).toString().replace(/\B(?=(\d{3})+(?!\d))/g,",")}catch(r){return console.error("格式化失败:",r),"格式错误"}}static toChineseFormat(e){try{const r=typeof e=="string"?parseFloat(e):e;if(isNaN(r))throw new Error("输入不是有效的数字");if(r>9999999999999e-2||r<-9999999999999e-2)throw new Error("输入数字超出范围");const n=r<0,i=Math.abs(r),u=Math.floor(i),g=Math.round((i-u)*100),c=["零","壹","贰","叁","肆","伍","陆","柒","捌","玖"],h=["","拾","佰","仟","万","拾","佰","仟","亿","拾","佰","仟"],f=["角","分"];let s="",a=u;if(a===0)s=c[0];else{let y=0;for(;a>0;){const b=a%10;b!==0?s=c[b]+h[y]+s:s.charAt(0)!==c[0]&&(s=c[b]+s),a=Math.floor(a/10),y++}s=s.replace(/零+/g,"零"),s=s.replace(/零+$/,"")}let d="";if(g>0){const y=Math.floor(g/10),b=g%10;y>0&&(d+=c[y]+f[0]),b>0&&(d+=c[b]+f[1])}else d="整";let l=(n?"负":"")+s+"圆"+d;return l==="零圆整"&&(l="零圆"),l}catch(r){return console.error("转换失败:",r),"格式错误"}}}const C={...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)}},_={isEmptyObject(t){return t?Object.keys(t).length===0&&t.constructor===Object:!0}},N={desensitize(t){return t?t.replace(/^(\d{3})\d{4}(\d{4})$/,"$1****$2")||t.slice(0,3)+"****"+t.slice(7):""}},T={color:function(){return`#${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)}},B={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)}},I={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}}},L=t=>{const r=new RegExp("[?&]"+t+"=([^&#]*)","i").exec(window.location.href);return r?decodeURIComponent(r[1]):null};function k(t){return new URLSearchParams(window.location.search).get(t)}const v={...Object.freeze(Object.defineProperty({__proto__:null,getQueryInfoByName:L,getQueryParam:k},Symbol.toStringTag,{value:"Module"})),getHost(){return window.location.host},getPath(){return window.location.pathname}},F={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.MoneyFormatter=A,o.arrayUtils=m,o.base64Utils=w,o.booleanUtils=U,o.cookieUtils=S,o.dateUtils=O,o.downloadUtils=M,o.elementUtils=j,o.letterUtils=E,o.numberUtils=C,o.objectUtils=_,o.phoneUtils=N,o.randomUtils=T,o.storageUtils=B,o.stringUtils=I,o.urlUtils=v,o.waterfallUtils=F,Object.defineProperty(o,Symbol.toStringTag,{value:"Module"})});

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@yh-kit/utils",
   "private": false,
-  "version": "1.3.1",
+  "version": "1.5.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/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,8 +1,12 @@
 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 "./money";
 export * from "./number";
 export * from "./object";
 export * from "./phone";

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/money/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 金额格式化工具类
+ */
+export declare class MoneyFormatter {
+    /**
+     * 转换为标准金额格式（带千分位和两位小数）
+     * @param num 要转换的数字
+     * @returns 格式化后的字符串
+     */
+    static toStandardFormat(num: number | string): string;
+    /**
+     * 转换为中文大写金额
+     * @param num 要转换的数字
+     * @returns 中文大写金额字符串
+     */
+    static toChineseFormat(num: number | string): string;
+}

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[];
 };