@yh-kit/utils 1.4.0 → 1.5.0

package/dist/utils.js

@@ -1,13 +1,13 @@
-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({
+const b = (t) => {
+  if (!t || !t.length) return {};
+  const e = {};
+  return t.forEach((r) => {
+    const o = Object.assign({ label: r.label, text: r.label }, r);
+    e[r == null ? void 0 : r.value] = o;
+  }), e;
+}, y = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
-  toEnumObj: p
+  toEnumObj: b
 }, Symbol.toStringTag, { value: "Module" })), A = Object.assign(
   {
     /**
@@ -15,8 +15,8 @@ const p = (e) => {
      * @param arr 数组
      * @returns 去重后的数组
      */
-    unique(e) {
-      return e ? Array.from(new Set(e)) : [];
+    unique(t) {
+      return t ? Array.from(new Set(t)) : [];
     },
     /**
      * 判断某元素是否在数组中
@@ -24,8 +24,8 @@ const p = (e) => {
      * @param element 查询元素
      * @returns 是否存在。true 存在；false 不存在
      */
-    isExist(e, t) {
-      return !e || !t ? !1 : e.indexOf(t) !== -1;
+    isExist(t, e) {
+      return !t || !e ? !1 : t.indexOf(e) !== -1;
     },
     /**
      * 统计数组中某元素出现的次数：对于大型数组，手动循环的性能略优于 filter 和 reduce。
@@ -33,11 +33,11 @@ const p = (e) => {
      * @param target 目标元素
      * @returns 出现次数
      */
-    countOfAppear(e, t) {
-      let n = 0;
-      for (const r of e)
-        r === t && n++;
-      return n;
+    countOfAppear(t, e) {
+      let r = 0;
+      for (const o of t)
+        o === e && r++;
+      return r;
     },
     /**
      * 数组排序-默认升序
@@ -45,8 +45,8 @@ const p = (e) => {
      * @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) : [];
+    sort(t, e = "asc") {
+      return t ? t.sort((r, o) => e === "asc" ? r > o ? 1 : -1 : r < o ? 1 : -1) : [];
     },
     /**
      * 数组乱序（洗牌算法）
@@ -59,18 +59,18 @@ const p = (e) => {
      * @param arr 数组
      * @returns
      */
-    shuffle(e) {
-      if (!e)
+    shuffle(t) {
+      if (!t)
         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]];
+      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 e;
+      return t;
     }
   },
   {
-    ...b
+    ...y
   }
 ), j = {
   /**
@@ -82,20 +82,20 @@ const p = (e) => {
    * @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;
+  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 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);
+      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(f, { type: t });
-    } catch (l) {
-      return console.error("Failed to convert base64 to blob:", l), null;
+      return new Blob(g, { type: e });
+    } catch (i) {
+      return console.error("Failed to convert base64 to blob:", i), null;
     }
   },
   /**
@@ -108,73 +108,73 @@ const p = (e) => {
    * @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));
+  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));
     }
-    const a = new Blob(f, { type: n });
-    return new File([a], t, { type: n });
+    const u = new Blob(g, { type: r });
+    return new File([u], e, { type: r });
   }
-}, E = {
+}, x = {
   /**
    * 检查是否为空字符串
    * @param str 要检查的字符串
    * @returns 如果字符串为空，则返回 true，否则返回 false
    */
-  isEmptyString(e) {
-    return typeof e == "string" && e.trim() === "";
+  isEmptyString(t) {
+    return typeof t == "string" && t.trim() === "";
   },
   /**
    * 判断是否为数字
    * @param val 要检查的值
    * @returns 如果值是数字，则返回 true，否则返回 false
    */
-  isNumber(e) {
-    return typeof e == "number" && !isNaN(e);
+  isNumber(t) {
+    return typeof t == "number" && !isNaN(t);
   },
   /**
    * 判断是否为对象
    * @param val 要检查的值
    * @returns 如果值是对象，则返回 true，否则返回 false
    */
-  isObject(e) {
-    return e !== null && typeof e == "object" && !Array.isArray(e);
+  isObject(t) {
+    return t !== null && typeof t == "object" && !Array.isArray(t);
   },
   /**
    * 判断对象是否为空
    * @param obj 要检查的对象
    * @returns 如果对象为空，则返回 true，否则返回 false
    */
-  isEmptyObject(e) {
-    return e ? Object.keys(e).length === 0 && e.constructor === Object : !0;
+  isEmptyObject(t) {
+    return t ? Object.keys(t).length === 0 && t.constructor === Object : !0;
   },
   /**
    * 判断是否为布尔值
    * @param val 要检查的值
    * @returns 如果值是布尔值，则返回 true，否则返回 false
    */
-  isBoolean(e) {
-    return typeof e == "boolean";
+  isBoolean(t) {
+    return typeof t == "boolean";
   },
   /**
    * 判断是否为数组
    * @param val 要检查的值
    * @returns 如果值是数组，则返回 true，否则返回 false
    */
-  isArray(e) {
-    return Array.isArray(e);
+  isArray(t) {
+    return Array.isArray(t);
   },
   /**
    * 判断是否为函数
    * @param val 要检查的值
    * @returns
    */
-  isFunction(e) {
-    return typeof e == "function";
+  isFunction(t) {
+    return typeof t == "function";
   },
   /**
    * 判断是否为 Promise 对象
@@ -182,41 +182,41 @@ const p = (e) => {
    * @returns 如果对象是 Promise 对象，则返回 true，否则返回 false
    */
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  isPromise(e) {
-    return !!e && (typeof e == "object" || typeof e == "function") && typeof e.then == "function";
+  isPromise(t) {
+    return !!t && (typeof t == "object" || typeof t == "function") && typeof t.then == "function";
   },
   /**
    * 判断是否为 DOM 元素
    * @param obj 要检查的对象
    * @returns 如果对象是 DOM 元素，则返回 true，否则返回 false
    */
-  isElement(e) {
-    return e instanceof Element;
+  isElement(t) {
+    return t instanceof Element;
   },
   /**
    * 判断手机号格式（中国）
    * @param str 手机号字符串
    * @returns true 表示手机号格式正确，false 表示手机号格式错误
    */
-  isPhone(e) {
-    return /^1[3-9]\d{9}$/.test(e);
+  isPhone(t) {
+    return /^1[3-9]\d{9}$/.test(t);
   },
   /**
    * 判断邮箱格式
    * @param str 邮箱字符串
    * @returns true 表示邮箱格式正确，false 表示邮箱格式错误
    */
-  isEmail(e) {
-    return /^[\w.-]+@[\w.-]+\.\w+$/.test(e);
+  isEmail(t) {
+    return /^[\w.-]+@[\w.-]+\.\w+$/.test(t);
   },
   /**
    * 判断字符串是否为 JSON
    * @param str 字符串
    * @returns true 表示是 JSON，false 表示不是 JSON
    */
-  isJSON(e) {
+  isJSON(t) {
     try {
-      return JSON.parse(e), !0;
+      return JSON.parse(t), !0;
     } catch {
       return !1;
     }
@@ -229,17 +229,17 @@ const p = (e) => {
    * const img = new Image();
    * img.src = "URL_ADDRESS   * img.src = "https://example.com/image.jpg";
    */
-  isImageLoaded(e) {
-    return e.complete && e.naturalWidth !== 0;
+  isImageLoaded(t) {
+    return t.complete && t.naturalWidth !== 0;
   },
   /**
    * 判断元素是否在可视区域内
    * @param el 元素对象
    * @returns true 表示元素在可视区域内，false 表示元素不在可视区域内
    */
-  isInViewport(e) {
-    const t = e.getBoundingClientRect();
-    return t.top >= 0 && t.left >= 0 && t.bottom <= window.innerHeight && t.right <= window.innerWidth;
+  isInViewport(t) {
+    const e = t.getBoundingClientRect();
+    return e.top >= 0 && e.left >= 0 && e.bottom <= window.innerHeight && e.right <= window.innerWidth;
   },
   /**
    * 判断是否为闰年
@@ -253,8 +253,8 @@ const p = (e) => {
    * isLeapYear(2025); // false
    * isLeapYear(2024); // true
    */
-  isLeapYear(e) {
-    return e % 4 === 0 && e % 100 !== 0 || e % 400 === 0;
+  isLeapYear(t) {
+    return t % 4 === 0 && t % 100 !== 0 || t % 400 === 0;
   },
   /**
    * 判断是否为移动端
@@ -263,16 +263,16 @@ const p = (e) => {
   isMobile() {
     return /Mobi|Android|iPhone/i.test(navigator.userAgent);
   }
-}, _ = {
+}, C = {
   /**
    * 通过传入的name获取cookie的值
    * @param name cookie的name
    * @returns cookie的值
    */
-  getCookie(e) {
-    if (!e) return;
-    const t = document.cookie.match(new RegExp("(^| )" + e + "=([^;]+)"));
-    return t ? decodeURIComponent(t[2]) : null;
+  getCookie(t) {
+    if (!t) return;
+    const e = document.cookie.match(new RegExp("(^| )" + t + "=([^;]+)"));
+    return e ? decodeURIComponent(e[2]) : null;
   },
   /**
    * 设置 cookie
@@ -281,27 +281,27 @@ const p = (e) => {
    * @param days cookie的过期时间，默认7天。如果为0，则表示cookie在会话结束时过期。如果为负数，则表示cookie已过期。
    * @returns void
    */
-  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=/`;
+  setCookie(t, e, r = 7) {
+    const o = /* @__PURE__ */ new Date();
+    o.setTime(o.getTime() + r * 24 * 60 * 60 * 1e3), document.cookie = `${t}=${encodeURIComponent(e)};expires=${o.toUTCString()};path=/`;
   },
   /**
    * 删除cookie
    * @param name cookie的name
    * @returns void
    */
-  deleteCookie(e) {
-    this.setCookie(e, "", -1);
+  deleteCookie(t) {
+    this.setCookie(t, "", -1);
   }
-}, C = {
+}, _ = {
   /**
    * 获取当前时间字符串
    * @param locales 区域设置。如：'zh-CN'，'en-US'，"chinese"。默认'zh-CN'。
    * @param hour12 是否使用12小时制。默认false，使用24小时制。
    * @returns 当前时间的字符串。如：'2025/5/27 16:54:45'
    */
-  getTimeString(e, t = !1) {
-    return t ? (/* @__PURE__ */ new Date()).toLocaleString(e, { hour12: !0 }) : (/* @__PURE__ */ new Date()).toLocaleString("chinese", { hour12: !1 });
+  getTimeString(t, e = !1) {
+    return e ? (/* @__PURE__ */ new Date()).toLocaleString(t, { hour12: !0 }) : (/* @__PURE__ */ new Date()).toLocaleString("chinese", { hour12: !1 });
   },
   /**
    * 计算两个日期相差天数
@@ -309,9 +309,9 @@ const p = (e) => {
    * @param date2 日期2
    * @returns 相差天数
    */
-  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)));
+  diffDays(t, e) {
+    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（时间戳+随机数）
@@ -320,83 +320,139 @@ const p = (e) => {
   uniqueId() {
     return Date.now().toString(36) + Math.random().toString(36).substr(2, 5);
   }
-}, M = {
+}, N = {
   /**
    * 将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);
+  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);
   }
-}, x = {
+}, B = {
   /**
    * 获取元素相对于文档顶部的偏移量（距离）
    * 处理了SVG元素的特殊情况。
    * @param el 元素
    * @returns 偏移量（距离值）
    */
-  getOffsetTop(e) {
-    if (!e)
+  getOffsetTop(t) {
+    if (!t)
       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;
+    if (t instanceof SVGElement) {
+      const r = t.getBoundingClientRect(), o = window.pageYOffset || document.documentElement.scrollTop;
+      return r.top + o;
     }
-    let t = 0;
-    for (; e; )
-      t += e.offsetTop, e = e.offsetParent;
-    return t;
+    let e = 0;
+    for (; t; )
+      e += t.offsetTop, t = t.offsetParent;
+    return e;
   }
-}, B = {
+}, I = {
   /**
    * 将选中的字母数组从A-Z排序：用于试题选择答案的排序实例
    * @param arr 字母数组
    * @returns
    */
-  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;
+  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;
   }
-}, h = (e) => e > 25 || e < 0 ? "" : "ABCDEFGHIJKLMNOPQRSTUVWXYZ"[e], y = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+};
+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: h
-}, Symbol.toStringTag, { value: "Module" })), m = (e) => e.toFixed(2).toString().replace(/\B(?=(\d{3})+(?!\d))/g, ","), w = /* @__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: m
-}, Symbol.toStringTag, { value: "Module" })), L = {
-  ...y,
+  toMoney: S
+}, Symbol.toStringTag, { value: "Module" })), T = {
   ...w,
+  ...O,
   /**
    * 判断是否为数字
    * @param val 待判断的值
    * @returns 是否为数字。true 是；false 否
    */
-  isNumber(e) {
-    return typeof e == "number" && !isNaN(e);
+  isNumber(t) {
+    return typeof t == "number" && !isNaN(t);
   }
-}, I = {
+}, v = {
   /**
    * 判断对象是否为空
    * @param obj 对象
    * @returns 是否为空。true 为空；false 不为空
    */
-  isEmptyObject(e) {
-    return e ? Object.keys(e).length === 0 && e.constructor === Object : !0;
+  isEmptyObject(t) {
+    return t ? Object.keys(t).length === 0 && t.constructor === Object : !0;
   }
-}, T = {
+}, F = {
   /**
    * 脱敏
    * @param phone 电话号码/手机号码
    * @returns 脱敏后的电话号码/手机号码
    */
-  desensitize(e) {
-    return e ? e.replace(/^(\d{3})\d{4}(\d{4})$/, "$1****$2") || e.slice(0, 3) + "****" + e.slice(7) : "";
+  desensitize(t) {
+    return t ? t.replace(/^(\d{3})\d{4}(\d{4})$/, "$1****$2") || t.slice(0, 3) + "****" + t.slice(7) : "";
   }
-}, k = {
+}, P = {
   /**
    * 生成随机颜色
    * @returns 随机颜色值
@@ -410,8 +466,8 @@ const p = (e) => {
    * @param max 最大值
    * @returns 随机数
    */
-  int(e, t) {
-    return Math.floor(Math.random() * (t - e + 1)) + e;
+  int(t, e) {
+    return Math.floor(Math.random() * (e - t + 1)) + t;
   },
   /**
    * 生成唯一ID（时间戳+随机数）
@@ -420,52 +476,52 @@ const p = (e) => {
   uniqueId() {
     return Date.now().toString(36) + Math.random().toString(36).substr(2, 5);
   }
-}, v = {
+}, k = {
   /**
    * 通过key值获取 localStorage 中存储的某个值
    * @param key 获取的key
    * @returns 获取的值
    */
-  getLocal(e) {
-    return localStorage.getItem(e);
+  getLocal(t) {
+    return localStorage.getItem(t);
   },
   /**
    * 设置localStorage中的某个值
    * @param key 设置的key
    * @param value 设置的value
    */
-  setLocal(e, t) {
-    localStorage.setItem(e, t);
+  setLocal(t, e) {
+    localStorage.setItem(t, e);
   },
   /**
    * 删除localStorage中的某个值
    * @param key 删除的key
    */
-  removeLocal(e) {
-    localStorage.removeItem(e);
+  removeLocal(t) {
+    localStorage.removeItem(t);
   },
   /**
    * 通过key值获取 sessionStorage 中存储的某个值
    * @param key 获取的key
    * @returns 获取的值
    */
-  getSession(e) {
-    return sessionStorage.getItem(e);
+  getSession(t) {
+    return sessionStorage.getItem(t);
   },
   /**
    * 设置sessionStorage中的某个值
    * @param key 设置的key
    * @param value 设置的value
    */
-  setSession(e, t) {
-    sessionStorage.setItem(e, t);
+  setSession(t, e) {
+    sessionStorage.setItem(t, e);
   },
   /**
    * 删除sessionStorage中的某个值
    * @param key 删除的key
    */
-  removeSession(e) {
-    sessionStorage.removeItem(e);
+  removeSession(t) {
+    sessionStorage.removeItem(t);
   }
 }, R = {
   /**
@@ -474,11 +530,11 @@ const p = (e) => {
    * @param element 查询元素
    * @returns 是否存在。true 存在；false 不存在
    */
-  isExist(e, t) {
-    if (!e || !t)
+  isExist(t, e) {
+    if (!t || !e)
       return !1;
-    const n = e.split(",");
-    return console.log("判断某元素是否在字符串中", n.indexOf(t) === -1), n.indexOf(t) !== -1;
+    const r = t.split(",");
+    return console.log("判断某元素是否在字符串中", r.indexOf(e) === -1), r.indexOf(e) !== -1;
   },
   /**
    * 判断某元素是否在字符串中-比isExist()方法更高效。
@@ -486,34 +542,34 @@ const p = (e) => {
    * @param element 查询元素
    * @returns 是否存在。true 存在；false 不存在
    */
-  includes(e, t) {
-    return !e || !t ? !1 : e.includes(t);
+  includes(t, e) {
+    return !t || !e ? !1 : t.includes(e);
   },
   /**
    * 判断字符串是否为 JSON
    * @param str 字符串
    * @returns
    */
-  isJSON(e) {
+  isJSON(t) {
     try {
-      return JSON.parse(e), !0;
+      return JSON.parse(t), !0;
     } catch {
       return !1;
     }
   }
-}, S = (e) => {
-  const n = new RegExp("[?&]" + e + "=([^&#]*)", "i").exec(window.location.href);
-  return n ? decodeURIComponent(n[1]) : null;
+}, U = (t) => {
+  const r = new RegExp("[?&]" + t + "=([^&#]*)", "i").exec(window.location.href);
+  return r ? decodeURIComponent(r[1]) : null;
 };
-function O(e) {
-  return new URLSearchParams(window.location.search).get(e);
+function M(t) {
+  return new URLSearchParams(window.location.search).get(t);
 }
-const U = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+const E = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
-  getQueryInfoByName: S,
-  getQueryParam: O
-}, Symbol.toStringTag, { value: "Module" })), N = {
-  ...U,
+  getQueryInfoByName: U,
+  getQueryParam: M
+}, Symbol.toStringTag, { value: "Module" })), $ = {
+  ...E,
   /**
    * 获取当前域名
    * @returns 当前url链接的host信息
@@ -528,40 +584,41 @@ const U = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   getPath() {
     return window.location.pathname;
   }
-}, P = {
+}, D = {
   /**
    * 处理瀑布流数据，使其适合瀑布流布局展示
    * @param list 瀑布流数据-数组
    * @param columnsNum 需要展示的列数
    * @returns 适合瀑布流布局的数组
    */
-  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;
+  toList(t, e = 2) {
+    console.log(t, e);
+    const r = {};
+    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 {
+  L as MoneyFormatter,
   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,
+  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,
-  N as urlUtils,
-  P as waterfallUtils
+  $ as urlUtils,
+  D as waterfallUtils
 };

package/dist/utils.umd.cjs

@@ -1 +1 @@
-(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"})});
+(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.4.0",
+  "version": "1.5.0",
   "type": "module",
   "files": [
     "dist",

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

@@ -6,6 +6,7 @@ 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/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;
+}