@yh-kit/utils 1.6.0 → 1.6.1

package/dist/utils.js

@@ -1,22 +1,22 @@
-const b = (t) => {
-  if (!t || !t.length) return {};
+const y = (e) => {
+  if (!e || !e.length) return {};
   const r = {};
-  return t.forEach((e) => {
-    const o = Object.assign({ label: e.label, text: e.label }, e);
-    r[e == null ? void 0 : e.value] = o;
+  return e.forEach((t) => {
+    const n = Object.assign({ label: t.label, text: t.label }, t);
+    r[t == null ? void 0 : t.value] = n;
   }), r;
-}, y = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+}, b = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
-  toEnumObj: b
-}, Symbol.toStringTag, { value: "Module" })), A = Object.assign(
+  toEnumObj: y
+}, Symbol.toStringTag, { value: "Module" })), L = Object.assign(
   {
     /**
      * 数组去重
      * @param arr 数组
      * @returns 去重后的数组
      */
-    unique(t) {
-      return t ? Array.from(new Set(t)) : [];
+    unique(e) {
+      return e ? Array.from(new Set(e)) : [];
     },
     /**
      * 判断某元素是否在数组中
@@ -24,8 +24,8 @@ const b = (t) => {
      * @param element 查询元素
      * @returns 是否存在。true 存在；false 不存在
      */
-    isExist(t, r) {
-      return !t || !r ? !1 : t.indexOf(r) !== -1;
+    isExist(e, r) {
+      return !e || !r ? !1 : e.indexOf(r) !== -1;
     },
     /**
      * 统计数组中某元素出现的次数：对于大型数组，手动循环的性能略优于 filter 和 reduce。
@@ -33,11 +33,11 @@ const b = (t) => {
      * @param target 目标元素
      * @returns 出现次数
      */
-    countOfAppear(t, r) {
-      let e = 0;
-      for (const o of t)
-        o === r && e++;
-      return e;
+    countOfAppear(e, r) {
+      let t = 0;
+      for (const n of e)
+        n === r && t++;
+      return t;
     },
     /**
      * 查找某个元素在数组中重复出现的位置
@@ -45,13 +45,13 @@ const b = (t) => {
      * @param element 元素
      * @returns 位置数组
      */
-    indexsOfAppear(t, r) {
-      let e = -1;
-      const o = [];
+    indexsOfAppear(e, r) {
+      let t = -1;
+      const n = [];
       do
-        e = t.indexOf(r, e + 1), e !== -1 && o.push(e);
-      while (e !== -1);
-      return o;
+        t = e.indexOf(r, t + 1), t !== -1 && n.push(t);
+      while (t !== -1);
+      return n;
     },
     /**
      * 数组排序-默认升序
@@ -59,8 +59,8 @@ const b = (t) => {
      * @param order 排序方式：asc 升序；desc 降序
      * @returns 排序后的数组
      */
-    sort(t, r = "asc") {
-      return t ? t.sort((e, o) => r === "asc" ? e > o ? 1 : -1 : e < o ? 1 : -1) : [];
+    sort(e, r = "asc") {
+      return e ? e.sort((t, n) => r === "asc" ? t > n ? 1 : -1 : t < n ? 1 : -1) : [];
     },
     /**
      * 数组乱序（洗牌算法）
@@ -73,36 +73,36 @@ const b = (t) => {
      * @param arr 数组
      * @returns
      */
-    shuffle(t) {
-      if (!t)
+    shuffle(e) {
+      if (!e)
         return [];
-      for (let r = t.length - 1; r > 0; r--) {
-        const e = Math.floor(Math.random() * (r + 1));
-        [t[r], t[e]] = [t[e], t[r]];
+      for (let r = e.length - 1; r > 0; r--) {
+        const t = Math.floor(Math.random() * (r + 1));
+        [e[r], e[t]] = [e[t], e[r]];
       }
-      return t;
+      return e;
     },
     /**
      * 获取数组中的最大值
      * @param arr 数组
      * @returns 最大值
      */
-    getMaxValue(t) {
-      return t ? Math.max(...t) : 0;
+    getMaxValue(e) {
+      return e ? Math.max(...e) : 0;
     },
     /**
      * 获取数组中的最小值
      * @param arr 数组
      * @returns 最小值
      */
-    getMinValue(t) {
-      return t ? Math.min(...t) : 0;
+    getMinValue(e) {
+      return e ? Math.min(...e) : 0;
     }
   },
   {
-    ...y
+    ...b
   }
-), L = {
+), A = {
   /**
    * 将Base64编码的字符串转换为Blob对象。
    * Blob对象用于表示二进制大型对象，可以在浏览器环境中处理大文件或二进制数据。
@@ -112,20 +112,20 @@ const b = (t) => {
    * @param sliceSize 可选参数，表示分片大小，默认为512字节。用于控制每次处理的Base64字符串长度，以优化大文件的处理。
    * @returns 返回转换后的Blob对象，如果转换失败，则返回null。
    */
-  toBlob(t, r = "", e = 512) {
-    const n = (t.split(",")[1] || t).replace(/-/g, "+").replace(/_/g, "/"), s = "=".repeat((4 - n.length % 4) % 4), l = n + s;
+  toBlob(e, r = "", t = 512) {
+    const o = (e.split(",")[1] || e).replace(/-/g, "+").replace(/_/g, "/"), s = "=".repeat((4 - o.length % 4) % 4), c = o + s;
     try {
-      const c = atob(l), a = [];
-      for (let d = 0; d < c.length; d += e) {
-        const i = c.slice(d, d + e), f = new Array(i.length);
-        for (let u = 0; u < i.length; u++)
-          f[u] = i.charCodeAt(u);
-        const h = new Uint8Array(f);
-        a.push(h);
+      const i = atob(c), l = [];
+      for (let h = 0; h < i.length; h += t) {
+        const a = i.slice(h, h + t), d = new Array(a.length);
+        for (let u = 0; u < a.length; u++)
+          d[u] = a.charCodeAt(u);
+        const f = new Uint8Array(d);
+        l.push(f);
       }
-      return new Blob(a, { type: r });
-    } catch (c) {
-      return console.error("Failed to convert base64 to blob:", c), null;
+      return new Blob(l, { type: r });
+    } catch (i) {
+      return console.error("Failed to convert base64 to blob:", i), null;
     }
   },
   /**
@@ -138,16 +138,16 @@ const b = (t) => {
    * @param mimeType MIME类型，默认为"text/plain"。
    * @returns 返回一个File对象，包含解码后的数据。
    */
-  toFile(t, r = "file.txt", e = "text/plain") {
-    const n = t.replace(/^data:.+;base64,/, "").replace(/-/g, "+").replace(/_/g, "/"), s = "=".repeat((4 - n.length % 4) % 4), l = n + s, c = atob(l), a = [];
-    for (let i = 0; i < c.length; i += 512) {
-      const f = c.slice(i, i + 512), h = new Array(f.length);
-      for (let u = 0; u < f.length; u++)
-        h[u] = f.charCodeAt(u);
-      a.push(new Uint8Array(h));
+  toFile(e, r = "file.txt", t = "text/plain") {
+    const o = e.replace(/^data:.+;base64,/, "").replace(/-/g, "+").replace(/_/g, "/"), s = "=".repeat((4 - o.length % 4) % 4), c = o + s, i = atob(c), l = [];
+    for (let a = 0; a < i.length; a += 512) {
+      const d = i.slice(a, a + 512), f = new Array(d.length);
+      for (let u = 0; u < d.length; u++)
+        f[u] = d.charCodeAt(u);
+      l.push(new Uint8Array(f));
     }
-    const d = new Blob(a, { type: e });
-    return new File([d], r, { type: e });
+    const h = new Blob(l, { type: t });
+    return new File([h], r, { type: t });
   }
 }, m = {
   /**
@@ -155,56 +155,56 @@ const b = (t) => {
    * @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 对象
@@ -212,41 +212,41 @@ const b = (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;
     }
@@ -259,16 +259,16 @@ const b = (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 r = t.getBoundingClientRect();
+  isInViewport(e) {
+    const r = e.getBoundingClientRect();
     return r.top >= 0 && r.left >= 0 && r.bottom <= window.innerHeight && r.right <= window.innerWidth;
   },
   /**
@@ -283,8 +283,8 @@ const b = (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;
   },
   /**
    * 判断是否为移动端
@@ -293,15 +293,15 @@ const b = (t) => {
   isMobile() {
     return /Mobi|Android|iPhone/i.test(navigator.userAgent);
   }
-}, j = {
+}, v = {
   /**
    * 通过传入的name获取cookie的值
    * @param name cookie的name
    * @returns cookie的值
    */
-  getCookie(t) {
-    if (!t) return;
-    const r = document.cookie.match(new RegExp("(^| )" + t + "=([^;]+)"));
+  getCookie(e) {
+    if (!e) return;
+    const r = document.cookie.match(new RegExp("(^| )" + e + "=([^;]+)"));
     return r ? decodeURIComponent(r[2]) : null;
   },
   /**
@@ -311,27 +311,27 @@ const b = (t) => {
    * @param days cookie的过期时间，默认7天。如果为0，则表示cookie在会话结束时过期。如果为负数，则表示cookie已过期。
    * @returns void
    */
-  setCookie(t, r, e = 7) {
-    const o = /* @__PURE__ */ new Date();
-    o.setTime(o.getTime() + e * 24 * 60 * 60 * 1e3), document.cookie = `${t}=${encodeURIComponent(r)};expires=${o.toUTCString()};path=/`;
+  setCookie(e, r, t = 7) {
+    const n = /* @__PURE__ */ new Date();
+    n.setTime(n.getTime() + t * 24 * 60 * 60 * 1e3), document.cookie = `${e}=${encodeURIComponent(r)};expires=${n.toUTCString()};path=/`;
   },
   /**
    * 删除cookie
    * @param name cookie的name
    * @returns void
    */
-  deleteCookie(t) {
-    this.setCookie(t, "", -1);
+  deleteCookie(e) {
+    this.setCookie(e, "", -1);
   }
-}, C = {
+}, R = {
   /**
    * 获取当前时间字符串
    * @param locales 区域设置。如：'zh-CN'，'en-US'，"chinese"。默认'zh-CN'。
    * @param hour12 是否使用12小时制。默认false，使用24小时制。
    * @returns 当前时间的字符串。如：'2025/5/27 16:54:45'
    */
-  getTimeString(t, r = !1) {
-    return r ? (/* @__PURE__ */ new Date()).toLocaleString(t, { hour12: !0 }) : (/* @__PURE__ */ new Date()).toLocaleString("chinese", { hour12: !1 });
+  getTimeString(e, r = !1) {
+    return r ? (/* @__PURE__ */ new Date()).toLocaleString(e, { hour12: !0 }) : (/* @__PURE__ */ new Date()).toLocaleString("chinese", { hour12: !1 });
   },
   /**
    * 计算两个日期相差天数
@@ -339,9 +339,9 @@ const b = (t) => {
    * @param date2 日期2
    * @returns 相差天数
    */
-  diffDays(t, r) {
-    const e = new Date(t).getTime(), o = new Date(r).getTime();
-    return e > o ? Math.abs(Math.floor((e - o) / (24 * 3600 * 1e3))) : Math.abs(Math.floor((o - e) / (24 * 3600 * 1e3)));
+  diffDays(e, r) {
+    const t = new Date(e).getTime(), n = new Date(r).getTime();
+    return t > n ? Math.abs(Math.floor((t - n) / (24 * 3600 * 1e3))) : Math.abs(Math.floor((n - t) / (24 * 3600 * 1e3)));
   },
   /**
    * 生成唯一ID（时间戳+随机数）
@@ -357,10 +357,10 @@ const b = (t) => {
    * @param day 日期
    * @returns 当年的第几天
    */
-  getWhichDays(t, r, e) {
-    let o = e;
-    for (let n = 1; n < r; n++)
-      switch (n) {
+  getWhichDays(e, r, t) {
+    let n = t;
+    for (let o = 1; o < r; o++)
+      switch (o) {
         case 1:
         case 3:
         case 5:
@@ -368,34 +368,34 @@ const b = (t) => {
         case 8:
         case 10:
         case 12:
-          o += 31;
+          n += 31;
           break;
         case 2:
-          m.isLeapYear(t) ? o += 29 : o += 28;
+          m.isLeapYear(e) ? n += 29 : n += 28;
           break;
         default:
-          o += 30;
+          n += 30;
           break;
       }
-    return o;
+    return n;
   }
-}, T = {
+}, j = {
   /**
    * 获取元素相对于文档顶部的偏移量（距离）
    * 处理了SVG元素的特殊情况。
    * @param el 元素
    * @returns 偏移量（距离值）
    */
-  getOffsetTop(t) {
-    if (!t)
+  getOffsetTop(e) {
+    if (!e)
       throw new Error("Element is not provided");
-    if (t instanceof SVGElement) {
-      const e = t.getBoundingClientRect(), o = window.pageYOffset || document.documentElement.scrollTop;
-      return e.top + o;
+    if (e instanceof SVGElement) {
+      const t = e.getBoundingClientRect(), n = window.pageYOffset || document.documentElement.scrollTop;
+      return t.top + n;
     }
     let r = 0;
-    for (; t; )
-      r += t.offsetTop, t = t.offsetParent;
+    for (; e; )
+      r += e.offsetTop, e = e.offsetParent;
     return r;
   },
   /**
@@ -403,11 +403,11 @@ const b = (t) => {
    * @returns 包含滚动值的对象 { scrollLeft: 水平滚动值, scrollTop: 垂直滚动值 }
    */
   getScrollValue() {
-    const t = {
+    const e = {
       scrollLeft: 0,
       scrollTop: 0
     };
-    return t.scrollLeft = document.body.scrollLeft || document.documentElement.scrollLeft, t.scrollTop = document.body.scrollTop || document.documentElement.scrollTop, t;
+    return e.scrollLeft = document.body.scrollLeft || document.documentElement.scrollLeft, e.scrollTop = document.body.scrollTop || document.documentElement.scrollTop, e;
   },
   /**
    * 获取鼠标事件的页面坐标
@@ -417,12 +417,12 @@ const b = (t) => {
    * @param e 鼠标事件
    * @returns 包含页面坐标的对象 { pageX: 水平页面坐标, pageY: 垂直页面坐标 }
    */
-  getPageValue(t) {
-    t = t || window.event;
-    const r = t.pageX || t.clientX + this.getScrollValue().scrollLeft, e = t.pageY || t.clientY + this.getScrollValue().scrollTop;
+  getPageValue(e) {
+    e = e || window.event;
+    const r = e.pageX || e.clientX + this.getScrollValue().scrollLeft, t = e.pageY || e.clientY + this.getScrollValue().scrollTop;
     return {
       pageX: r,
-      pageY: e
+      pageY: t
     };
   },
   /**
@@ -433,62 +433,118 @@ const b = (t) => {
    * @param fn 事件处理函数
    */
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  addEventListener(t, r, e) {
-    t.addEventListener ? t.addEventListener(r, e) : t.attachEvent ? t.attachEvent("on" + r, e) : t["on" + r] = e;
+  addEventListener(e, r, t) {
+    e.addEventListener ? e.addEventListener(r, t) : e.attachEvent ? e.attachEvent("on" + r, t) : e["on" + r] = t;
   }
-}, k = {
+}, C = {
   /**
    * 将blob对象转化成文件并导出到本地
    * @param blob blob对象
    * @param filename 文件名
    */
-  saveAsBlob(t, r) {
-    const e = document.createElement("a"), o = window.URL.createObjectURL(t);
-    e.href = o, e.download = r, document.body.appendChild(e), e.click(), URL.revokeObjectURL(o), document.body.removeChild(e);
+  saveAsBlob(e, r) {
+    const t = document.createElement("a"), n = window.URL.createObjectURL(e);
+    t.href = n, t.download = r, document.body.appendChild(t), t.click(), URL.revokeObjectURL(n), document.body.removeChild(t);
   }
-}, _ = {
+}, k = {
   /**
    * 将选中的字母数组从A-Z排序：用于试题选择答案的排序实例
    * @param arr 字母数组
    * @returns
    */
-  sortFromA2Z(t) {
-    return t != null && t.length ? t.sort((e, o) => {
-      const n = e.toUpperCase(), s = o.toUpperCase();
-      return n < s ? -1 : n > s ? 1 : 0;
+  sortFromA2Z(e) {
+    return e != null && e.length ? e.sort((t, n) => {
+      const o = t.toUpperCase(), s = n.toUpperCase();
+      return o < s ? -1 : o > s ? 1 : 0;
     }) : void 0;
   }
-}, v = {
+}, B = {
   /**
-   * 计算弧度
+   * 角度（度数）转弧度
    * 在数学和编程里，角度有两种常用单位，分别是度（°）和弧度（rad）。
    * 1 个完整的圆周，用角度表示是 360°，用弧度表示则是 2π rad。
    * 角度和弧度的换算关系为：弧度 = 角度 × π / 180。
-   * @param d 经度值或纬度值
+   * @param degrees 度数。单位：°
    * @returns 弧度值
    */
-  rad(t) {
-    return t * Math.PI / 180;
+  degrees2Radians(e) {
+    return e * Math.PI / 180;
   },
   /**
-   * 根据经纬度计算距离
+   * 根据经纬度计算距离【弃用】
    * @param userLat 用户纬度
    * @param userLng 用户经度
    * @param targetLat 目标纬度
    * @param targetLng 目标经度
    * @returns 距离值 单位：km
    */
-  getDistance(t, r, e, o) {
-    const n = this.rad(t), s = this.rad(e), l = n - s, c = this.rad(r) - this.rad(o);
-    let a = 2 * Math.asin(
+  getDistance(e, r, t, n) {
+    const o = this.degrees2Radians(e), s = this.degrees2Radians(t), c = o - s, i = this.degrees2Radians(r) - this.degrees2Radians(n);
+    let l = 2 * Math.asin(
       Math.sqrt(
-        Math.pow(Math.sin(l / 2), 2) + Math.cos(n) * Math.cos(s) * Math.pow(Math.sin(c / 2), 2)
+        Math.pow(Math.sin(c / 2), 2) + Math.cos(o) * Math.cos(s) * Math.pow(Math.sin(i / 2), 2)
       )
     );
-    return a = a * 6378.137, a = Math.round(a * 1e4) / 1e4, a = +a.toFixed(2), console.log("经纬度计算的距离为：" + a), a;
+    return l = l * 6378.137, l = Math.round(l * 1e4) / 1e4, l = +l.toFixed(2), console.log("经纬度计算的距离为：" + l), l;
+  },
+  /**
+   * 计算两个坐标点之间的距离（Haversine公式）
+   * Haversine公式：
+   * a = sin²(Δlat/2) + cos(lat1)·cos(lat2)·sin²(Δlon/2) 其中：
+   *  lat1, lat2: 两点的纬度（弧度）
+   *  Δlat: 两点纬度之差（弧度）
+   *  Δlon: 两点经度之差（弧度）
+   * c = 2·atan2(√a, √(1−a))
+   * d = R·c  其中：
+   *  R: 地球半径（平均约 6371km）
+   * @param point1 坐标点1
+   * @param point2 坐标点2
+   * @param unit 距离单位，默认单位为千米。可选值：km（千米）、m（米）、mi（英里）、nmi（海里）
+   * @returns 距离值
+   */
+  calculateDistanceByHaversine(e, r, t = "km") {
+    const n = this, o = e.longitude ?? e.lng, s = e.latitude ?? e.lat, c = r.longitude ?? r.lng, i = r.latitude ?? r.lat;
+    if (o === void 0 || s === void 0 || c === void 0 || i === void 0)
+      throw new Error("无效的坐标格式，缺少经纬度信息");
+    const l = 6371, h = n.degrees2Radians(s), a = n.degrees2Radians(i), d = n.degrees2Radians(i - s), f = n.degrees2Radians(c - o), u = Math.sin(d / 2) * Math.sin(d / 2) + Math.cos(h) * Math.cos(a) * Math.sin(f / 2) * Math.sin(f / 2), p = 2 * Math.atan2(Math.sqrt(u), Math.sqrt(1 - u)), g = l * p;
+    switch (t) {
+      case "m":
+        return g * 1e3;
+      // 米
+      case "mi":
+        return g * 0.621371;
+      // 英里
+      case "nmi":
+        return g * 0.539957;
+      // 海里
+      default:
+        return g;
+    }
+  },
+  /**
+   * 计算多个坐标点之间的总距离（Haversine公式）
+   * @param points 坐标点数组
+   * @param unit 距离单位，默认单位为千米。可选值：km（千米）、m（米）、mi（英里）、nmi（海里）
+   * @param closed 是否闭合路径，默认不闭合
+   * @returns 距离结果对象。包含每个距离段的数组（segments）和总距离（total）。
+   */
+  calculateDistancesByHaversine(e, r = "km", t = !1) {
+    if (e.length < 2)
+      return { segments: [], total: 0 };
+    const n = [];
+    let o = 0;
+    for (let s = 0; s < e.length - 1; s++) {
+      const c = this.calculateDistanceByHaversine(e[s], e[s + 1], r);
+      n.push(c), o += c;
+    }
+    if (t && e.length > 2) {
+      const s = this.calculateDistanceByHaversine(e[e.length - 1], e[0], r);
+      n.push(s), o += s;
+    }
+    return { segments: n, total: o };
   }
 };
-class I {
+class T {
   /**
    * 转换为标准金额格式（带千分位和两位小数）
    * @param num 要转换的数字
@@ -496,14 +552,14 @@ class I {
    */
   static toStandardFormat(r) {
     try {
-      const e = typeof r == "string" ? parseFloat(r) : r;
-      if (isNaN(e))
+      const t = typeof r == "string" ? parseFloat(r) : r;
+      if (isNaN(t))
         throw new Error("输入不是有效的数字");
-      if (!isFinite(e))
+      if (!isFinite(t))
         throw new Error("输入是无穷大");
-      return e.toFixed(2).toString().replace(/\B(?=(\d{3})+(?!\d))/g, ",");
-    } catch (e) {
-      return console.error("格式化失败:", e), "格式错误";
+      return t.toFixed(2).toString().replace(/\B(?=(\d{3})+(?!\d))/g, ",");
+    } catch (t) {
+      return console.error("格式化失败:", t), "格式错误";
     }
   }
   /**
@@ -513,61 +569,61 @@ class I {
    */
   static toChineseFormat(r) {
     try {
-      const e = typeof r == "string" ? parseFloat(r) : r;
-      if (isNaN(e))
+      const t = typeof r == "string" ? parseFloat(r) : r;
+      if (isNaN(t))
         throw new Error("输入不是有效的数字");
-      if (e > 9999999999999e-2 || e < -9999999999999e-2)
+      if (t > 9999999999999e-2 || t < -9999999999999e-2)
         throw new Error("输入数字超出范围");
-      const o = e < 0, n = Math.abs(e), s = Math.floor(n), l = Math.round((n - s) * 100), c = ["零", "壹", "贰", "叁", "肆", "伍", "陆", "柒", "捌", "玖"], a = ["", "拾", "佰", "仟", "万", "拾", "佰", "仟", "亿", "拾", "佰", "仟"], d = ["角", "分"];
-      let i = "", f = s;
-      if (f === 0)
-        i = c[0];
+      const n = t < 0, o = Math.abs(t), s = Math.floor(o), c = Math.round((o - s) * 100), i = ["零", "壹", "贰", "叁", "肆", "伍", "陆", "柒", "捌", "玖"], l = ["", "拾", "佰", "仟", "万", "拾", "佰", "仟", "亿", "拾", "佰", "仟"], h = ["角", "分"];
+      let a = "", d = s;
+      if (d === 0)
+        a = i[0];
       else {
         let p = 0;
-        for (; f > 0; ) {
-          const g = f % 10;
-          g !== 0 ? i = c[g] + a[p] + i : i.charAt(0) !== c[0] && (i = c[g] + i), f = Math.floor(f / 10), p++;
+        for (; d > 0; ) {
+          const g = d % 10;
+          g !== 0 ? a = i[g] + l[p] + a : a.charAt(0) !== i[0] && (a = i[g] + a), d = Math.floor(d / 10), p++;
         }
-        i = i.replace(/零+/g, "零"), i = i.replace(/零+$/, "");
+        a = a.replace(/零+/g, "零"), a = a.replace(/零+$/, "");
       }
-      let h = "";
-      if (l > 0) {
-        const p = Math.floor(l / 10), g = l % 10;
-        p > 0 && (h += c[p] + d[0]), g > 0 && (h += c[g] + d[1]);
+      let f = "";
+      if (c > 0) {
+        const p = Math.floor(c / 10), g = c % 10;
+        p > 0 && (f += i[p] + h[0]), g > 0 && (f += i[g] + h[1]);
       } else
-        h = "整";
-      let u = (o ? "负" : "") + i + "圆" + h;
+        f = "整";
+      let u = (n ? "负" : "") + a + "圆" + f;
       return u === "零圆整" && (u = "零圆"), u;
-    } catch (e) {
-      return console.error("转换失败:", e), "格式错误";
+    } catch (t) {
+      return console.error("转换失败:", t), "格式错误";
     }
   }
 }
-const w = (t) => t > 25 || t < 0 ? "" : "ABCDEFGHIJKLMNOPQRSTUVWXYZ"[t], S = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+const w = (e) => e > 25 || e < 0 ? "" : "ABCDEFGHIJKLMNOPQRSTUVWXYZ"[e], M = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   toLetter: w
-}, Symbol.toStringTag, { value: "Module" })), M = (t) => t.toFixed(2).toString().replace(/\B(?=(\d{3})+(?!\d))/g, ","), O = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+}, Symbol.toStringTag, { value: "Module" })), S = (e) => e.toFixed(2).toString().replace(/\B(?=(\d{3})+(?!\d))/g, ","), O = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
-  toMoney: M
-}, Symbol.toStringTag, { value: "Module" })), B = {
-  ...S,
+  toMoney: S
+}, Symbol.toStringTag, { value: "Module" })), _ = {
+  ...M,
   ...O,
   /**
    * 判断是否为数字
    * @param val 待判断的值
    * @returns 是否为数字。true 是；false 否
    */
-  isNumber(t) {
-    return typeof t == "number" && !isNaN(t);
+  isNumber(e) {
+    return typeof e == "number" && !isNaN(e);
   }
-}, N = {
+}, I = {
   /**
    * 判断对象是否为空
    * @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;
   },
   /**
    * 复制对象【对象的浅拷贝    把obj1的成员，复制给obj2】
@@ -575,9 +631,9 @@ const w = (t) => t > 25 || t < 0 ? "" : "ABCDEFGHIJKLMNOPQRSTUVWXYZ"[t], S = /*
    * @param obj2 目标对象
    */
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  copy(t, r) {
-    for (const e in t)
-      r[e] = t[e];
+  copy(e, r) {
+    for (const t in e)
+      r[t] = e[t];
   },
   /**
    * 对象的深拷贝    把o1 的成员，复制给o2
@@ -585,22 +641,22 @@ const w = (t) => t > 25 || t < 0 ? "" : "ABCDEFGHIJKLMNOPQRSTUVWXYZ"[t], S = /*
    * @param o2
    */
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  deepCopy(t, r) {
-    for (const e in t) {
-      const o = t[e];
-      o instanceof Object ? (r[e] = {}, this.deepCopy(o, r[e])) : o instanceof Array ? (r[e] = [], this.deepCopy(o, r[e])) : r[e] = t[e];
+  deepCopy(e, r) {
+    for (const t in e) {
+      const n = e[t];
+      n instanceof Object ? (r[t] = {}, this.deepCopy(n, r[t])) : n instanceof Array ? (r[t] = [], this.deepCopy(n, r[t])) : r[t] = e[t];
     }
   }
-}, P = {
+}, N = {
   /**
    * 脱敏
    * @param phone 电话号码/手机号码
    * @returns 脱敏后的电话号码/手机号码
    */
-  desensitize(t) {
-    return t ? t.replace(/^(\d{3})\d{4}(\d{4})$/, "$1****$2") || t.slice(0, 3) + "****" + t.slice(7) : "";
+  desensitize(e) {
+    return e ? e.replace(/^(\d{3})\d{4}(\d{4})$/, "$1****$2") || e.slice(0, 3) + "****" + e.slice(7) : "";
   }
-}, F = {
+}, D = {
   /**
    * 生成随机颜色
    * @returns 随机颜色值
@@ -614,8 +670,8 @@ const w = (t) => t > 25 || t < 0 ? "" : "ABCDEFGHIJKLMNOPQRSTUVWXYZ"[t], S = /*
    * @param max 最大值
    * @returns 随机数
    */
-  int(t, r) {
-    return Math.floor(Math.random() * (r - t + 1)) + t;
+  int(e, r) {
+    return Math.floor(Math.random() * (r - e + 1)) + e;
   },
   /**
    * 生成唯一ID（时间戳+随机数）
@@ -624,65 +680,65 @@ const w = (t) => t > 25 || t < 0 ? "" : "ABCDEFGHIJKLMNOPQRSTUVWXYZ"[t], S = /*
   uniqueId() {
     return Date.now().toString(36) + Math.random().toString(36).substr(2, 5);
   }
-}, R = {
+}, P = {
   /**
    * 通过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, r) {
-    localStorage.setItem(t, r);
+  setLocal(e, r) {
+    localStorage.setItem(e, r);
   },
   /**
    * 删除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, r) {
-    sessionStorage.setItem(t, r);
+  setSession(e, r) {
+    sessionStorage.setItem(e, r);
   },
   /**
    * 删除sessionStorage中的某个值
    * @param key 删除的key
    */
-  removeSession(t) {
-    sessionStorage.removeItem(t);
+  removeSession(e) {
+    sessionStorage.removeItem(e);
   }
-}, D = {
+}, F = {
   /**
    * 判断某元素是否在字符串中-比includes()方法更兼容，includes为ES6新增方法，IE不支持。小程序也不支持
    * @param str 字符串
    * @param element 查询元素
    * @returns 是否存在。true 存在；false 不存在
    */
-  isExist(t, r) {
-    if (!t || !r)
+  isExist(e, r) {
+    if (!e || !r)
       return !1;
-    const e = t.split(",");
-    return console.log("判断某元素是否在字符串中", e.indexOf(r) === -1), e.indexOf(r) !== -1;
+    const t = e.split(",");
+    return console.log("判断某元素是否在字符串中", t.indexOf(r) === -1), t.indexOf(r) !== -1;
   },
   /**
    * 判断某元素是否在字符串中-比isExist()方法更高效。
@@ -690,17 +746,17 @@ const w = (t) => t > 25 || t < 0 ? "" : "ABCDEFGHIJKLMNOPQRSTUVWXYZ"[t], S = /*
    * @param element 查询元素
    * @returns 是否存在。true 存在；false 不存在
    */
-  includes(t, r) {
-    return !t || !r ? !1 : t.includes(r);
+  includes(e, r) {
+    return !e || !r ? !1 : e.includes(r);
   },
   /**
    * 判断字符串是否为 JSON
    * @param str 字符串
    * @returns
    */
-  isJSON(t) {
+  isJSON(e) {
     try {
-      return JSON.parse(t), !0;
+      return JSON.parse(e), !0;
     } catch {
       return !1;
     }
@@ -711,39 +767,39 @@ const w = (t) => t > 25 || t < 0 ? "" : "ABCDEFGHIJKLMNOPQRSTUVWXYZ"[t], S = /*
    * @param element 元素
    * @returns 位置数组
    */
-  indexsOfAppear(t, r) {
-    let e = -1;
-    const o = [];
+  indexsOfAppear(e, r) {
+    let t = -1;
+    const n = [];
     do
-      e = t.indexOf(r, e + 1), e !== -1 && o.push(e);
-    while (e !== -1);
-    return o;
+      t = e.indexOf(r, t + 1), t !== -1 && n.push(t);
+    while (t !== -1);
+    return n;
   },
   /**
    * 获取字符串中出现次数最多的字符和次数
    * @param string 字符串
    * @returns 数组，第一个元素为出现次数，第二个元素为出现次数最多的字符
    */
-  getMaxTimesAndVal(t) {
-    const r = [0, ""], e = {};
-    for (let s = 0; s < t.length; s++) {
-      const l = t.charAt(s);
-      e[l] ? e[l]++ : e[l] = 1;
+  getMaxTimesAndVal(e) {
+    const r = [0, ""], t = {};
+    for (let s = 0; s < e.length; s++) {
+      const c = e.charAt(s);
+      t[c] ? t[c]++ : t[c] = 1;
     }
-    let o = 1;
-    for (const s in e)
-      o < e[s] && (o = e[s]);
-    const n = [];
-    for (const s in e)
-      o == e[s] && n.push(s);
-    return r[0] = o, r[1] = n.join(), r;
+    let n = 1;
+    for (const s in t)
+      n < t[s] && (n = t[s]);
+    const o = [];
+    for (const s in t)
+      n == t[s] && o.push(s);
+    return r[0] = n, r[1] = o.join(), r;
   }
-}, U = (t) => {
-  const e = new RegExp("[?&]" + t + "=([^&#]*)", "i").exec(window.location.href);
-  return e ? decodeURIComponent(e[1]) : null;
+}, U = (e) => {
+  const t = new RegExp("[?&]" + e + "=([^&#]*)", "i").exec(window.location.href);
+  return t ? decodeURIComponent(t[1]) : null;
 };
-function E(t) {
-  return new URLSearchParams(window.location.search).get(t);
+function E(e) {
+  return new URLSearchParams(window.location.search).get(e);
 }
 const x = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
@@ -772,35 +828,35 @@ const x = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
    * @param columnsNum 需要展示的列数
    * @returns 适合瀑布流布局的数组
    */
-  toList(t, r = 2) {
-    console.log(t, r);
-    const e = {};
-    for (let n = 0; n < r; n++)
-      e[n] = [];
-    t.forEach((n, s) => e[s % r].push(n));
-    const o = [];
-    for (const n in e)
-      o.push(...e[n]);
-    return o;
+  toList(e, r = 2) {
+    console.log(e, r);
+    const t = {};
+    for (let o = 0; o < r; o++)
+      t[o] = [];
+    e.forEach((o, s) => t[s % r].push(o));
+    const n = [];
+    for (const o in t)
+      n.push(...t[o]);
+    return n;
   }
 };
 export {
-  I as MoneyFormatter,
-  A as arrayUtils,
-  L as base64Utils,
+  T as MoneyFormatter,
+  L as arrayUtils,
+  A as base64Utils,
   m as booleanUtils,
-  j as cookieUtils,
-  C as dateUtils,
-  T as documentUtils,
-  k as downloadUtils,
-  _ as letterUtils,
-  v as mapUtils,
-  B as numberUtils,
-  N as objectUtils,
-  P as phoneUtils,
-  F as randomUtils,
-  R as storageUtils,
-  D as stringUtils,
+  v as cookieUtils,
+  R as dateUtils,
+  j as documentUtils,
+  C as downloadUtils,
+  k as letterUtils,
+  B as mapUtils,
+  _ as numberUtils,
+  I as objectUtils,
+  N as phoneUtils,
+  D as randomUtils,
+  P as storageUtils,
+  F as stringUtils,
   V as urlUtils,
   $ as waterfallUtils
 };

package/dist/utils.umd.cjs

@@ -1 +1 @@
-(function(i,b){typeof exports=="object"&&typeof module<"u"?b(exports):typeof define=="function"&&define.amd?define(["exports"],b):(i=typeof globalThis<"u"?globalThis:i||self,b(i.yhkitUtils={}))})(this,function(i){"use strict";const w=Object.assign({unique(t){return t?Array.from(new Set(t)):[]},isExist(t,r){return!t||!r?!1:t.indexOf(r)!==-1},countOfAppear(t,r){let e=0;for(const n of t)n===r&&e++;return e},indexsOfAppear(t,r){let e=-1;const n=[];do e=t.indexOf(r,e+1),e!==-1&&n.push(e);while(e!==-1);return n},sort(t,r="asc"){return t?t.sort((e,n)=>r==="asc"?e>n?1:-1:e<n?1:-1):[]},shuffle(t){if(!t)return[];for(let r=t.length-1;r>0;r--){const e=Math.floor(Math.random()*(r+1));[t[r],t[e]]=[t[e],t[r]]}return t},getMaxValue(t){return t?Math.max(...t):0},getMinValue(t){return t?Math.min(...t):0}},{...Object.freeze(Object.defineProperty({__proto__:null,toEnumObj:t=>{if(!t||!t.length)return{};const r={};return t.forEach(e=>{const n=Object.assign({label:e.label,text:e.label},e);r[e==null?void 0:e.value]=n}),r}},Symbol.toStringTag,{value:"Module"}))}),U={toBlob(t,r="",e=512){const o=(t.split(",")[1]||t).replace(/-/g,"+").replace(/_/g,"/"),s="=".repeat((4-o.length%4)%4),u=o+s;try{const a=atob(u),l=[];for(let h=0;h<a.length;h+=e){const c=a.slice(h,h+e),d=new Array(c.length);for(let f=0;f<c.length;f++)d[f]=c.charCodeAt(f);const g=new Uint8Array(d);l.push(g)}return new Blob(l,{type:r})}catch(a){return console.error("Failed to convert base64 to blob:",a),null}},toFile(t,r="file.txt",e="text/plain"){const o=t.replace(/^data:.+;base64,/,"").replace(/-/g,"+").replace(/_/g,"/"),s="=".repeat((4-o.length%4)%4),u=o+s,a=atob(u),l=[];for(let c=0;c<a.length;c+=512){const d=a.slice(c,c+512),g=new Array(d.length);for(let f=0;f<d.length;f++)g[f]=d.charCodeAt(f);l.push(new Uint8Array(g))}const h=new Blob(l,{type:e});return new File([h],r,{type:e})}},m={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 r=t.getBoundingClientRect();return r.top>=0&&r.left>=0&&r.bottom<=window.innerHeight&&r.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 r=document.cookie.match(new RegExp("(^| )"+t+"=([^;]+)"));return r?decodeURIComponent(r[2]):null},setCookie(t,r,e=7){const n=new Date;n.setTime(n.getTime()+e*24*60*60*1e3),document.cookie=`${t}=${encodeURIComponent(r)};expires=${n.toUTCString()};path=/`},deleteCookie(t){this.setCookie(t,"",-1)}},M={getTimeString(t,r=!1){return r?new Date().toLocaleString(t,{hour12:!0}):new Date().toLocaleString("chinese",{hour12:!1})},diffDays(t,r){const e=new Date(t).getTime(),n=new Date(r).getTime();return e>n?Math.abs(Math.floor((e-n)/(24*3600*1e3))):Math.abs(Math.floor((n-e)/(24*3600*1e3)))},uniqueId(){return Date.now().toString(36)+Math.random().toString(36).substr(2,5)},getWhichDays(t,r,e){let n=e;for(let o=1;o<r;o++)switch(o){case 1:case 3:case 5:case 7:case 8:case 10:case 12:n+=31;break;case 2:m.isLeapYear(t)?n+=29:n+=28;break;default:n+=30;break}return n}},O={getOffsetTop(t){if(!t)throw new Error("Element is not provided");if(t instanceof SVGElement){const e=t.getBoundingClientRect(),n=window.pageYOffset||document.documentElement.scrollTop;return e.top+n}let r=0;for(;t;)r+=t.offsetTop,t=t.offsetParent;return r},getScrollValue(){const t={scrollLeft:0,scrollTop:0};return t.scrollLeft=document.body.scrollLeft||document.documentElement.scrollLeft,t.scrollTop=document.body.scrollTop||document.documentElement.scrollTop,t},getPageValue(t){t=t||window.event;const r=t.pageX||t.clientX+this.getScrollValue().scrollLeft,e=t.pageY||t.clientY+this.getScrollValue().scrollTop;return{pageX:r,pageY:e}},addEventListener(t,r,e){t.addEventListener?t.addEventListener(r,e):t.attachEvent?t.attachEvent("on"+r,e):t["on"+r]=e}},E={saveAsBlob(t,r){const e=document.createElement("a"),n=window.URL.createObjectURL(t);e.href=n,e.download=r,document.body.appendChild(e),e.click(),URL.revokeObjectURL(n),document.body.removeChild(e)}},j={sortFromA2Z(t){return t!=null&&t.length?t.sort((e,n)=>{const o=e.toUpperCase(),s=n.toUpperCase();return o<s?-1:o>s?1:0}):void 0}},L={rad(t){return t*Math.PI/180},getDistance(t,r,e,n){const o=this.rad(t),s=this.rad(e),u=o-s,a=this.rad(r)-this.rad(n);let l=2*Math.asin(Math.sqrt(Math.pow(Math.sin(u/2),2)+Math.cos(o)*Math.cos(s)*Math.pow(Math.sin(a/2),2)));return l=l*6378.137,l=Math.round(l*1e4)/1e4,l=+l.toFixed(2),console.log("经纬度计算的距离为："+l),l}};class A{static toStandardFormat(r){try{const e=typeof r=="string"?parseFloat(r):r;if(isNaN(e))throw new Error("输入不是有效的数字");if(!isFinite(e))throw new Error("输入是无穷大");return e.toFixed(2).toString().replace(/\B(?=(\d{3})+(?!\d))/g,",")}catch(e){return console.error("格式化失败:",e),"格式错误"}}static toChineseFormat(r){try{const e=typeof r=="string"?parseFloat(r):r;if(isNaN(e))throw new Error("输入不是有效的数字");if(e>9999999999999e-2||e<-9999999999999e-2)throw new Error("输入数字超出范围");const n=e<0,o=Math.abs(e),s=Math.floor(o),u=Math.round((o-s)*100),a=["零","壹","贰","叁","肆","伍","陆","柒","捌","玖"],l=["","拾","佰","仟","万","拾","佰","仟","亿","拾","佰","仟"],h=["角","分"];let c="",d=s;if(d===0)c=a[0];else{let y=0;for(;d>0;){const p=d%10;p!==0?c=a[p]+l[y]+c:c.charAt(0)!==a[0]&&(c=a[p]+c),d=Math.floor(d/10),y++}c=c.replace(/零+/g,"零"),c=c.replace(/零+$/,"")}let g="";if(u>0){const y=Math.floor(u/10),p=u%10;y>0&&(g+=a[y]+h[0]),p>0&&(g+=a[p]+h[1])}else g="整";let f=(n?"负":"")+c+"圆"+g;return f==="零圆整"&&(f="零圆"),f}catch(e){return console.error("转换失败:",e),"格式错误"}}}const T={...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)}},C={isEmptyObject(t){return t?Object.keys(t).length===0&&t.constructor===Object:!0},copy(t,r){for(const e in t)r[e]=t[e]},deepCopy(t,r){for(const e in t){const n=t[e];n instanceof Object?(r[e]={},this.deepCopy(n,r[e])):n instanceof Array?(r[e]=[],this.deepCopy(n,r[e])):r[e]=t[e]}}},k={desensitize(t){return t?t.replace(/^(\d{3})\d{4}(\d{4})$/,"$1****$2")||t.slice(0,3)+"****"+t.slice(7):""}},_={color:function(){return`#${Math.random().toString(16).slice(2,8)}`},int(t,r){return Math.floor(Math.random()*(r-t+1))+t},uniqueId(){return Date.now().toString(36)+Math.random().toString(36).substr(2,5)}},v={getLocal(t){return localStorage.getItem(t)},setLocal(t,r){localStorage.setItem(t,r)},removeLocal(t){localStorage.removeItem(t)},getSession(t){return sessionStorage.getItem(t)},setSession(t,r){sessionStorage.setItem(t,r)},removeSession(t){sessionStorage.removeItem(t)}},I={isExist(t,r){if(!t||!r)return!1;const e=t.split(",");return console.log("判断某元素是否在字符串中",e.indexOf(r)===-1),e.indexOf(r)!==-1},includes(t,r){return!t||!r?!1:t.includes(r)},isJSON(t){try{return JSON.parse(t),!0}catch{return!1}},indexsOfAppear(t,r){let e=-1;const n=[];do e=t.indexOf(r,e+1),e!==-1&&n.push(e);while(e!==-1);return n},getMaxTimesAndVal(t){const r=[0,""],e={};for(let s=0;s<t.length;s++){const u=t.charAt(s);e[u]?e[u]++:e[u]=1}let n=1;for(const s in e)n<e[s]&&(n=e[s]);const o=[];for(const s in e)n==e[s]&&o.push(s);return r[0]=n,r[1]=o.join(),r}},B=t=>{const e=new RegExp("[?&]"+t+"=([^&#]*)","i").exec(window.location.href);return e?decodeURIComponent(e[1]):null};function N(t){return new URLSearchParams(window.location.search).get(t)}const P={...Object.freeze(Object.defineProperty({__proto__:null,getQueryInfoByName:B,getQueryParam:N},Symbol.toStringTag,{value:"Module"})),getHost(){return window.location.host},getPath(){return window.location.pathname}},F={toList(t,r=2){console.log(t,r);const e={};for(let o=0;o<r;o++)e[o]=[];t.forEach((o,s)=>e[s%r].push(o));const n=[];for(const o in e)n.push(...e[o]);return n}};i.MoneyFormatter=A,i.arrayUtils=w,i.base64Utils=U,i.booleanUtils=m,i.cookieUtils=S,i.dateUtils=M,i.documentUtils=O,i.downloadUtils=E,i.letterUtils=j,i.mapUtils=L,i.numberUtils=T,i.objectUtils=C,i.phoneUtils=k,i.randomUtils=_,i.storageUtils=v,i.stringUtils=I,i.urlUtils=P,i.waterfallUtils=F,Object.defineProperty(i,Symbol.toStringTag,{value:"Module"})});
+(function(i,p){typeof exports=="object"&&typeof module<"u"?p(exports):typeof define=="function"&&define.amd?define(["exports"],p):(i=typeof globalThis<"u"?globalThis:i||self,p(i.yhkitUtils={}))})(this,function(i){"use strict";const w=Object.assign({unique(e){return e?Array.from(new Set(e)):[]},isExist(e,n){return!e||!n?!1:e.indexOf(n)!==-1},countOfAppear(e,n){let t=0;for(const r of e)r===n&&t++;return t},indexsOfAppear(e,n){let t=-1;const r=[];do t=e.indexOf(n,t+1),t!==-1&&r.push(t);while(t!==-1);return r},sort(e,n="asc"){return e?e.sort((t,r)=>n==="asc"?t>r?1:-1:t<r?1:-1):[]},shuffle(e){if(!e)return[];for(let n=e.length-1;n>0;n--){const t=Math.floor(Math.random()*(n+1));[e[n],e[t]]=[e[t],e[n]]}return e},getMaxValue(e){return e?Math.max(...e):0},getMinValue(e){return e?Math.min(...e):0}},{...Object.freeze(Object.defineProperty({__proto__:null,toEnumObj:e=>{if(!e||!e.length)return{};const n={};return e.forEach(t=>{const r=Object.assign({label:t.label,text:t.label},t);n[t==null?void 0:t.value]=r}),n}},Symbol.toStringTag,{value:"Module"}))}),M={toBlob(e,n="",t=512){const o=(e.split(",")[1]||e).replace(/-/g,"+").replace(/_/g,"/"),s="=".repeat((4-o.length%4)%4),l=o+s;try{const c=atob(l),u=[];for(let g=0;g<c.length;g+=t){const a=c.slice(g,g+t),f=new Array(a.length);for(let d=0;d<a.length;d++)f[d]=a.charCodeAt(d);const h=new Uint8Array(f);u.push(h)}return new Blob(u,{type:n})}catch(c){return console.error("Failed to convert base64 to blob:",c),null}},toFile(e,n="file.txt",t="text/plain"){const o=e.replace(/^data:.+;base64,/,"").replace(/-/g,"+").replace(/_/g,"/"),s="=".repeat((4-o.length%4)%4),l=o+s,c=atob(l),u=[];for(let a=0;a<c.length;a+=512){const f=c.slice(a,a+512),h=new Array(f.length);for(let d=0;d<f.length;d++)h[d]=f.charCodeAt(d);u.push(new Uint8Array(h))}const g=new Blob(u,{type:t});return new File([g],n,{type:t})}},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 n=e.getBoundingClientRect();return n.top>=0&&n.left>=0&&n.bottom<=window.innerHeight&&n.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 n=document.cookie.match(new RegExp("(^| )"+e+"=([^;]+)"));return n?decodeURIComponent(n[2]):null},setCookie(e,n,t=7){const r=new Date;r.setTime(r.getTime()+t*24*60*60*1e3),document.cookie=`${e}=${encodeURIComponent(n)};expires=${r.toUTCString()};path=/`},deleteCookie(e){this.setCookie(e,"",-1)}},S={getTimeString(e,n=!1){return n?new Date().toLocaleString(e,{hour12:!0}):new Date().toLocaleString("chinese",{hour12:!1})},diffDays(e,n){const t=new Date(e).getTime(),r=new Date(n).getTime();return t>r?Math.abs(Math.floor((t-r)/(24*3600*1e3))):Math.abs(Math.floor((r-t)/(24*3600*1e3)))},uniqueId(){return Date.now().toString(36)+Math.random().toString(36).substr(2,5)},getWhichDays(e,n,t){let r=t;for(let o=1;o<n;o++)switch(o){case 1:case 3:case 5:case 7:case 8:case 10:case 12:r+=31;break;case 2:m.isLeapYear(e)?r+=29:r+=28;break;default:r+=30;break}return r}},O={getOffsetTop(e){if(!e)throw new Error("Element is not provided");if(e instanceof SVGElement){const t=e.getBoundingClientRect(),r=window.pageYOffset||document.documentElement.scrollTop;return t.top+r}let n=0;for(;e;)n+=e.offsetTop,e=e.offsetParent;return n},getScrollValue(){const e={scrollLeft:0,scrollTop:0};return e.scrollLeft=document.body.scrollLeft||document.documentElement.scrollLeft,e.scrollTop=document.body.scrollTop||document.documentElement.scrollTop,e},getPageValue(e){e=e||window.event;const n=e.pageX||e.clientX+this.getScrollValue().scrollLeft,t=e.pageY||e.clientY+this.getScrollValue().scrollTop;return{pageX:n,pageY:t}},addEventListener(e,n,t){e.addEventListener?e.addEventListener(n,t):e.attachEvent?e.attachEvent("on"+n,t):e["on"+n]=t}},E={saveAsBlob(e,n){const t=document.createElement("a"),r=window.URL.createObjectURL(e);t.href=r,t.download=n,document.body.appendChild(t),t.click(),URL.revokeObjectURL(r),document.body.removeChild(t)}},L={sortFromA2Z(e){return e!=null&&e.length?e.sort((t,r)=>{const o=t.toUpperCase(),s=r.toUpperCase();return o<s?-1:o>s?1:0}):void 0}},j={degrees2Radians(e){return e*Math.PI/180},getDistance(e,n,t,r){const o=this.degrees2Radians(e),s=this.degrees2Radians(t),l=o-s,c=this.degrees2Radians(n)-this.degrees2Radians(r);let u=2*Math.asin(Math.sqrt(Math.pow(Math.sin(l/2),2)+Math.cos(o)*Math.cos(s)*Math.pow(Math.sin(c/2),2)));return u=u*6378.137,u=Math.round(u*1e4)/1e4,u=+u.toFixed(2),console.log("经纬度计算的距离为："+u),u},calculateDistanceByHaversine(e,n,t="km"){const r=this,o=e.longitude??e.lng,s=e.latitude??e.lat,l=n.longitude??n.lng,c=n.latitude??n.lat;if(o===void 0||s===void 0||l===void 0||c===void 0)throw new Error("无效的坐标格式，缺少经纬度信息");const u=6371,g=r.degrees2Radians(s),a=r.degrees2Radians(c),f=r.degrees2Radians(c-s),h=r.degrees2Radians(l-o),d=Math.sin(f/2)*Math.sin(f/2)+Math.cos(g)*Math.cos(a)*Math.sin(h/2)*Math.sin(h/2),b=2*Math.atan2(Math.sqrt(d),Math.sqrt(1-d)),y=u*b;switch(t){case"m":return y*1e3;case"mi":return y*.621371;case"nmi":return y*.539957;default:return y}},calculateDistancesByHaversine(e,n="km",t=!1){if(e.length<2)return{segments:[],total:0};const r=[];let o=0;for(let s=0;s<e.length-1;s++){const l=this.calculateDistanceByHaversine(e[s],e[s+1],n);r.push(l),o+=l}if(t&&e.length>2){const s=this.calculateDistanceByHaversine(e[e.length-1],e[0],n);r.push(s),o+=s}return{segments:r,total:o}}};class v{static toStandardFormat(n){try{const t=typeof n=="string"?parseFloat(n):n;if(isNaN(t))throw new Error("输入不是有效的数字");if(!isFinite(t))throw new Error("输入是无穷大");return t.toFixed(2).toString().replace(/\B(?=(\d{3})+(?!\d))/g,",")}catch(t){return console.error("格式化失败:",t),"格式错误"}}static toChineseFormat(n){try{const t=typeof n=="string"?parseFloat(n):n;if(isNaN(t))throw new Error("输入不是有效的数字");if(t>9999999999999e-2||t<-9999999999999e-2)throw new Error("输入数字超出范围");const r=t<0,o=Math.abs(t),s=Math.floor(o),l=Math.round((o-s)*100),c=["零","壹","贰","叁","肆","伍","陆","柒","捌","玖"],u=["","拾","佰","仟","万","拾","佰","仟","亿","拾","佰","仟"],g=["角","分"];let a="",f=s;if(f===0)a=c[0];else{let b=0;for(;f>0;){const y=f%10;y!==0?a=c[y]+u[b]+a:a.charAt(0)!==c[0]&&(a=c[y]+a),f=Math.floor(f/10),b++}a=a.replace(/零+/g,"零"),a=a.replace(/零+$/,"")}let h="";if(l>0){const b=Math.floor(l/10),y=l%10;b>0&&(h+=c[b]+g[0]),y>0&&(h+=c[y]+g[1])}else h="整";let d=(r?"负":"")+a+"圆"+h;return d==="零圆整"&&(d="零圆"),d}catch(t){return console.error("转换失败:",t),"格式错误"}}}const 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)}},R={isEmptyObject(e){return e?Object.keys(e).length===0&&e.constructor===Object:!0},copy(e,n){for(const t in e)n[t]=e[t]},deepCopy(e,n){for(const t in e){const r=e[t];r instanceof Object?(n[t]={},this.deepCopy(r,n[t])):r instanceof Array?(n[t]=[],this.deepCopy(r,n[t])):n[t]=e[t]}}},k={desensitize(e){return e?e.replace(/^(\d{3})\d{4}(\d{4})$/,"$1****$2")||e.slice(0,3)+"****"+e.slice(7):""}},T={color:function(){return`#${Math.random().toString(16).slice(2,8)}`},int(e,n){return Math.floor(Math.random()*(n-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,n){localStorage.setItem(e,n)},removeLocal(e){localStorage.removeItem(e)},getSession(e){return sessionStorage.getItem(e)},setSession(e,n){sessionStorage.setItem(e,n)},removeSession(e){sessionStorage.removeItem(e)}},B={isExist(e,n){if(!e||!n)return!1;const t=e.split(",");return console.log("判断某元素是否在字符串中",t.indexOf(n)===-1),t.indexOf(n)!==-1},includes(e,n){return!e||!n?!1:e.includes(n)},isJSON(e){try{return JSON.parse(e),!0}catch{return!1}},indexsOfAppear(e,n){let t=-1;const r=[];do t=e.indexOf(n,t+1),t!==-1&&r.push(t);while(t!==-1);return r},getMaxTimesAndVal(e){const n=[0,""],t={};for(let s=0;s<e.length;s++){const l=e.charAt(s);t[l]?t[l]++:t[l]=1}let r=1;for(const s in t)r<t[s]&&(r=t[s]);const o=[];for(const s in t)r==t[s]&&o.push(s);return n[0]=r,n[1]=o.join(),n}},_=e=>{const t=new RegExp("[?&]"+e+"=([^&#]*)","i").exec(window.location.href);return t?decodeURIComponent(t[1]):null};function I(e){return new URLSearchParams(window.location.search).get(e)}const N={...Object.freeze(Object.defineProperty({__proto__:null,getQueryInfoByName:_,getQueryParam:I},Symbol.toStringTag,{value:"Module"})),getHost(){return window.location.host},getPath(){return window.location.pathname}},P={toList(e,n=2){console.log(e,n);const t={};for(let o=0;o<n;o++)t[o]=[];e.forEach((o,s)=>t[s%n].push(o));const r=[];for(const o in t)r.push(...t[o]);return r}};i.MoneyFormatter=v,i.arrayUtils=w,i.base64Utils=M,i.booleanUtils=m,i.cookieUtils=U,i.dateUtils=S,i.documentUtils=O,i.downloadUtils=E,i.letterUtils=L,i.mapUtils=j,i.numberUtils=A,i.objectUtils=R,i.phoneUtils=k,i.randomUtils=T,i.storageUtils=C,i.stringUtils=B,i.urlUtils=N,i.waterfallUtils=P,Object.defineProperty(i,Symbol.toStringTag,{value:"Module"})});

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@yh-kit/utils",
   "private": false,
-  "version": "1.6.0",
+  "version": "1.6.1",
   "type": "module",
   "files": [
     "dist",

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

@@ -1,18 +1,48 @@
+/**
+ * 经纬度坐标接口 - 支持多种常见格式
+ *
+ * 经纬度通常以度（°）为单位表示，通常要求4位小数以上。其小数部分的位数决定了精度：
+ * 小数点后 1 位：约 11.1 km（影响较大）
+ * 小数点后 2 位：约 1.1 km（城市级别精度）
+ * 小数点后 3 位：约 111 m（街区级别精度）
+ * 小数点后 4 位：约 11.1 m（建筑物/大厦级别精度）
+ * 小数点后 5 位：约 1.1 m（GPS 设备常见精度）
+ * 小数点后 6 位：约 11 cm（高精度定位）
+ * 小数点后 7 位：约 1.1 cm（特高精度定位）
+ */
+interface ICoordinate {
+    /** 经度 */
+    lng: number;
+    /** 纬度 */
+    lat: number;
+    longitude?: number;
+    latitude?: number;
+    [key: string]: unknown;
+}
+/**
+ * 距离计算结果接口
+ */
+interface IDistanceResult {
+    /** 距离分段值 */
+    segments: number[];
+    /** 总距离值 */
+    total: number;
+}
 /**
  * 地图相关工具函数
  */
 export declare const mapUtils: {
     /**
-     * 计算弧度
+     * 角度（度数）转弧度
      * 在数学和编程里，角度有两种常用单位，分别是度（°）和弧度（rad）。
      * 1 个完整的圆周，用角度表示是 360°，用弧度表示则是 2π rad。
      * 角度和弧度的换算关系为：弧度 = 角度 × π / 180。
-     * @param d 经度值或纬度值
+     * @param degrees 度数。单位：°
      * @returns 弧度值
      */
-    rad(d: number): number;
+    degrees2Radians(degrees: number): number;
     /**
-     * 根据经纬度计算距离
+     * 根据经纬度计算距离【弃用】
      * @param userLat 用户纬度
      * @param userLng 用户经度
      * @param targetLat 目标纬度
@@ -20,4 +50,29 @@ export declare const mapUtils: {
      * @returns 距离值 单位：km
      */
     getDistance(userLat: number, userLng: number, targetLat: number, targetLng: number): number;
+    /**
+     * 计算两个坐标点之间的距离（Haversine公式）
+     * Haversine公式：
+     * a = sin²(Δlat/2) + cos(lat1)·cos(lat2)·sin²(Δlon/2) 其中：
+     *  lat1, lat2: 两点的纬度（弧度）
+     *  Δlat: 两点纬度之差（弧度）
+     *  Δlon: 两点经度之差（弧度）
+     * c = 2·atan2(√a, √(1−a))
+     * d = R·c  其中：
+     *  R: 地球半径（平均约 6371km）
+     * @param point1 坐标点1
+     * @param point2 坐标点2
+     * @param unit 距离单位，默认单位为千米。可选值：km（千米）、m（米）、mi（英里）、nmi（海里）
+     * @returns 距离值
+     */
+    calculateDistanceByHaversine(point1: ICoordinate, point2: ICoordinate, unit?: "km" | "m" | "mi" | "nmi"): number;
+    /**
+     * 计算多个坐标点之间的总距离（Haversine公式）
+     * @param points 坐标点数组
+     * @param unit 距离单位，默认单位为千米。可选值：km（千米）、m（米）、mi（英里）、nmi（海里）
+     * @param closed 是否闭合路径，默认不闭合
+     * @returns 距离结果对象。包含每个距离段的数组（segments）和总距离（total）。
+     */
+    calculateDistancesByHaversine(points: ICoordinate[], unit?: "km" | "m" | "mi" | "nmi", closed?: boolean): IDistanceResult;
 };
+export {};