@qxs-bns/utils 0.0.15 → 0.0.16

package/es/index.d.ts

@@ -1,4 +1,5 @@
 export * from './src/argo-log';
+export * from './src/date-transfer';
 export * from './src/device';
 export * from './src/file-operations';
 export * from './src/json';

package/es/index.mjs

@@ -1,33 +1,35 @@
 import { ArgoLog as r } from "./src/argo-log.mjs";
-import { isMobile as t } from "./src/device.mjs";
-import { createVideoUploader as m, downloadFile as p } from "./src/file-operations.mjs";
-import { JsonToExcel as a, excelToJson as n } from "./src/json.mjs";
-import { OssError as d, OssUploader as f, generateSignedUrl as g, uploadFile as c } from "./src/oss-uploader.mjs";
-import { Storage as O } from "./src/storage.mjs";
-import { isBoolean as b, isElement as w, isImageByMimeType as E, isJSONString as J, isNumber as T, isPlainObject as u, isUndefined as y, isWindow as A } from "./src/types.mjs";
-import { ApiService as F } from "./src/use-api.mjs";
-import { watermark as N } from "./src/watermark.mjs";
+import { formatTime as t } from "./src/date-transfer.mjs";
+import { isMobile as p } from "./src/device.mjs";
+import { createVideoUploader as a, downloadFile as l } from "./src/file-operations.mjs";
+import { JsonToExcel as n, excelToJson as x } from "./src/json.mjs";
+import { OssError as g, OssUploader as c, generateSignedUrl as S, uploadFile as O } from "./src/oss-uploader.mjs";
+import { Storage as U } from "./src/storage.mjs";
+import { isBoolean as w, isElement as E, isImageByMimeType as J, isJSONString as u, isNumber as y, isPlainObject as A, isUndefined as B, isWindow as F } from "./src/types.mjs";
+import { ApiService as N } from "./src/use-api.mjs";
+import { watermark as k } from "./src/watermark.mjs";
 export {
-  F as ApiService,
+  N as ApiService,
   r as ArgoLog,
-  a as JsonToExcel,
-  d as OssError,
-  f as OssUploader,
-  O as Storage,
-  m as createVideoUploader,
-  p as downloadFile,
-  n as excelToJson,
-  g as generateSignedUrl,
-  b as isBoolean,
-  w as isElement,
-  E as isImageByMimeType,
-  J as isJSONString,
-  t as isMobile,
-  T as isNumber,
-  u as isPlainObject,
-  y as isUndefined,
-  A as isWindow,
-  c as uploadFile,
-  N as watermark
+  n as JsonToExcel,
+  g as OssError,
+  c as OssUploader,
+  U as Storage,
+  a as createVideoUploader,
+  l as downloadFile,
+  x as excelToJson,
+  t as formatTime,
+  S as generateSignedUrl,
+  w as isBoolean,
+  E as isElement,
+  J as isImageByMimeType,
+  u as isJSONString,
+  p as isMobile,
+  y as isNumber,
+  A as isPlainObject,
+  B as isUndefined,
+  F as isWindow,
+  O as uploadFile,
+  k as watermark
 };
 //# sourceMappingURL=index.mjs.map

package/es/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;"}
+{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;"}

package/es/src/date-transfer.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 统一的时间转换函数
+ * @param {number|string|Date} time - 输入时间（时间戳、日期字符串或Date对象）
+ * @param {object} options - 配置选项
+ * @param {boolean} options.isMs - 输入是否为毫秒，默认false（秒）
+ * @param {string} options.format - 输出格式：'duration'（持续时间）| 'relative'（相对时间），默认'duration'
+ * @param {string} options.separator - 时间分隔符，默认':'
+ * @param {boolean} options.complete - 是否显示完整时间格式，默认false
+ * @param {boolean} options.showDate - 是否显示日期部分，默认true
+ * @param {boolean} options.showTime - 是否显示时间部分，默认true
+ * @returns {string} 格式化后的时间字符串
+ */
+export declare function formatTime(time: number | string | Date, { isMs, format, separator, complete, showDate, showTime, }?: {
+    isMs?: boolean | undefined;
+    format?: string | undefined;
+    separator?: string | undefined;
+    complete?: boolean | undefined;
+    showDate?: boolean | undefined;
+    showTime?: boolean | undefined;
+}): string;

package/es/src/date-transfer.mjs

@@ -0,0 +1,62 @@
+const c = {
+  thresholds: {
+    second: 1e3,
+    minute: 6e4,
+    hour: 36e5,
+    day: 864e5,
+    month: 2592e6,
+    year: 31536e6
+  },
+  units: {
+    year: 31536e6,
+    month: 2592e6,
+    day: 864e5,
+    hour: 36e5,
+    minute: 6e4,
+    second: 1e3
+  },
+  labels: {
+    relative: {
+      justNow: "刚刚",
+      seconds: "几秒前",
+      minutes: "分钟前",
+      hours: "小时前",
+      days: "天前",
+      months: "个月前",
+      years: "年前"
+    }
+  }
+};
+function b(u, {
+  isMs: m = !1,
+  format: $ = "duration",
+  separator: d = ":",
+  complete: y = !1,
+  showDate: M = !0,
+  showTime: w = !0
+} = {}) {
+  let e;
+  if (typeof u == "number")
+    e = m ? u : u * 1e3;
+  else {
+    const r = Date.now(), t = new Date(u).getTime();
+    e = $ === "relative" ? r - t : t;
+  }
+  if (Number.isNaN(e) || e < 0)
+    throw new Error("无效的时间输入");
+  if ($ === "relative") {
+    const { justNow: r, seconds: t, minutes: f, hours: N, days: p, months: S, years: T } = c.labels.relative, o = c.thresholds;
+    return e < o.second ? r : e < o.minute ? t : e < o.hour ? `${Math.floor(e / o.minute)}${f}` : e < o.day ? `${Math.floor(e / o.hour)}${N}` : e < o.month ? `${Math.floor(e / o.day)}${p}` : e < o.year ? `${Math.floor(e / o.month)}${S}` : `${Math.floor(e / o.year)}${T}`;
+  }
+  const h = [], i = Math.floor(e / 1e3), l = Math.floor(i / (24 * 3600)), a = Math.floor(i % (24 * 3600) / 3600), s = Math.floor(i % 3600 / 60), n = i % 60;
+  if (M && l > 0 && h.push(`${l}天`), w) {
+    const r = (f) => String(f).padStart(2, "0");
+    let t = "";
+    y ? t = `${r(a)}${d}${r(s)}${d}${r(n)}` : l > 0 ? (t = a > 0 ? `${a}小时` : "", t += s > 0 ? `${s}分钟` : "") : a > 0 ? (t = `${a}小时`, t += s > 0 ? `${s}分钟` : "", t += n > 0 ? `${n}秒` : "") : s > 0 ? (t = `${s}分钟`, t += n > 0 ? `${n}秒` : "") : t = `${n}秒`, t && h.push(t);
+  }
+  return h.join(" ");
+}
+export {
+  b as formatTime
+};
+//# sourceMappingURL=date-transfer.mjs.map

package/es/src/date-transfer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-transfer.mjs","sources":["../../../../packages/utils/src/date-transfer.ts"],"sourcesContent":["// 将阈值和时间单位合并为一个常量对象\nconst TIME_CONSTANTS = {\n  thresholds: {\n    second: 1000,\n    minute: 60000,\n    hour: 3600000,\n    day: 86400000,\n    month: 2592000000,\n    year: 31536000000,\n  },\n  units: {\n    year: 31536000000,\n    month: 2592000000,\n    day: 86400000,\n    hour: 3600000,\n    minute: 60000,\n    second: 1000,\n  },\n  labels: {\n    relative: {\n      justNow: '刚刚',\n      seconds: '几秒前',\n      minutes: '分钟前',\n      hours: '小时前',\n      days: '天前',\n      months: '个月前',\n      years: '年前',\n    },\n  },\n}\n\n/**\n * 统一的时间转换函数\n * @param {number|string|Date} time - 输入时间（时间戳、日期字符串或Date对象）\n * @param {object} options - 配置选项\n * @param {boolean} options.isMs - 输入是否为毫秒，默认false（秒）\n * @param {string} options.format - 输出格式：'duration'（持续时间）| 'relative'（相对时间），默认'duration'\n * @param {string} options.separator - 时间分隔符，默认':'\n * @param {boolean} options.complete - 是否显示完整时间格式，默认false\n * @param {boolean} options.showDate - 是否显示日期部分，默认true\n * @param {boolean} options.showTime - 是否显示时间部分，默认true\n * @returns {string} 格式化后的时间字符串\n */\nexport function formatTime(\n  time: number | string | Date,\n  {\n    isMs = false,\n    format = 'duration',\n    separator = ':',\n    complete = false,\n    showDate = true,\n    showTime = true,\n  } = {},\n) {\n  // 处理输入时间\n  let ms: number\n\n  if (typeof time === 'number') {\n    ms = isMs ? time : time * 1000\n  }\n  else {\n    const now = Date.now()\n    const timestamp = new Date(time).getTime()\n    ms = format === 'relative' ? now - timestamp : timestamp\n  }\n\n  // 验证输入\n  if (Number.isNaN(ms) || ms < 0) {\n    throw new Error('无效的时间输入')\n  }\n\n  // 相对时间格式\n  if (format === 'relative') {\n    const { justNow, seconds, minutes, hours, days, months, years }\n      = TIME_CONSTANTS.labels.relative\n    const thresholds = TIME_CONSTANTS.thresholds\n\n    if (ms < thresholds.second) {\n      return justNow\n    }\n    if (ms < thresholds.minute) {\n      return seconds\n    }\n    if (ms < thresholds.hour) {\n      return `${Math.floor(ms / thresholds.minute)}${minutes}`\n    }\n    if (ms < thresholds.day) {\n      return `${Math.floor(ms / thresholds.hour)}${hours}`\n    }\n    if (ms < thresholds.month) {\n      return `${Math.floor(ms / thresholds.day)}${days}`\n    }\n    if (ms < thresholds.year) {\n      return `${Math.floor(ms / thresholds.month)}${months}`\n    }\n    return `${Math.floor(ms / thresholds.year)}${years}`\n  }\n\n  // 持续时间格式\n  const result = []\n  const totalSeconds = Math.floor(ms / 1000)\n  const days = Math.floor(totalSeconds / (24 * 3600))\n  const hours = Math.floor((totalSeconds % (24 * 3600)) / 3600)\n  const minutes = Math.floor((totalSeconds % 3600) / 60)\n  const seconds = totalSeconds % 60\n\n  // 处理日期部分\n  if (showDate && days > 0) {\n    result.push(`${days}天`)\n  }\n\n  // 处理时间部分\n  if (showTime) {\n    const pad = (num: number): string => String(num).padStart(2, '0')\n    let timeStr = ''\n\n    if (complete) {\n      timeStr = `${pad(hours)}${separator}${pad(minutes)}${separator}${pad(seconds)}`\n    }\n    else {\n      if (days > 0) {\n        timeStr = hours > 0 ? `${hours}小时` : ''\n        timeStr += minutes > 0 ? `${minutes}分钟` : ''\n      }\n      else if (hours > 0) {\n        timeStr = `${hours}小时`\n        timeStr += minutes > 0 ? `${minutes}分钟` : ''\n        timeStr += seconds > 0 ? `${seconds}秒` : ''\n      }\n      else if (minutes > 0) {\n        timeStr = `${minutes}分钟`\n        timeStr += seconds > 0 ? `${seconds}秒` : ''\n      }\n      else {\n        timeStr = `${seconds}秒`\n      }\n    }\n    if (timeStr) {\n      result.push(timeStr)\n    }\n  }\n\n  return result.join(' ')\n}\n"],"names":["TIME_CONSTANTS","formatTime","time","isMs","format","separator","complete","showDate","showTime","ms","now","timestamp","justNow","seconds","minutes","hours","days","months","years","thresholds","result","totalSeconds","pad","num","timeStr"],"mappings":"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"}

package/lib/index.d.ts

@@ -1,4 +1,5 @@
 export * from './src/argo-log';
+export * from './src/date-transfer';
 export * from './src/device';
 export * from './src/file-operations';
 export * from './src/json';

package/lib/index.js

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("./src/argo-log.js"),n=require("./src/device.js"),r=require("./src/file-operations.js"),o=require("./src/json.js"),i=require("./src/oss-uploader.js"),t=require("./src/storage.js"),e=require("./src/types.js"),a=require("./src/use-api.js"),l=require("./src/watermark.js");exports.ArgoLog=s.ArgoLog;exports.isMobile=n.isMobile;exports.createVideoUploader=r.createVideoUploader;exports.downloadFile=r.downloadFile;exports.JsonToExcel=o.JsonToExcel;exports.excelToJson=o.excelToJson;exports.OssError=i.OssError;exports.OssUploader=i.OssUploader;exports.generateSignedUrl=i.generateSignedUrl;exports.uploadFile=i.uploadFile;exports.Storage=t.Storage;exports.isBoolean=e.isBoolean;exports.isElement=e.isElement;exports.isImageByMimeType=e.isImageByMimeType;exports.isJSONString=e.isJSONString;exports.isNumber=e.isNumber;exports.isPlainObject=e.isPlainObject;exports.isUndefined=e.isUndefined;exports.isWindow=e.isWindow;exports.ApiService=a.ApiService;exports.watermark=l.watermark;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("./src/argo-log.js"),n=require("./src/date-transfer.js"),t=require("./src/device.js"),i=require("./src/file-operations.js"),o=require("./src/json.js"),r=require("./src/oss-uploader.js"),a=require("./src/storage.js"),e=require("./src/types.js"),l=require("./src/use-api.js"),d=require("./src/watermark.js");exports.ArgoLog=s.ArgoLog;exports.formatTime=n.formatTime;exports.isMobile=t.isMobile;exports.createVideoUploader=i.createVideoUploader;exports.downloadFile=i.downloadFile;exports.JsonToExcel=o.JsonToExcel;exports.excelToJson=o.excelToJson;exports.OssError=r.OssError;exports.OssUploader=r.OssUploader;exports.generateSignedUrl=r.generateSignedUrl;exports.uploadFile=r.uploadFile;exports.Storage=a.Storage;exports.isBoolean=e.isBoolean;exports.isElement=e.isElement;exports.isImageByMimeType=e.isImageByMimeType;exports.isJSONString=e.isJSONString;exports.isNumber=e.isNumber;exports.isPlainObject=e.isPlainObject;exports.isUndefined=e.isUndefined;exports.isWindow=e.isWindow;exports.ApiService=l.ApiService;exports.watermark=d.watermark;
 //# sourceMappingURL=index.js.map

package/lib/src/date-transfer.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 统一的时间转换函数
+ * @param {number|string|Date} time - 输入时间（时间戳、日期字符串或Date对象）
+ * @param {object} options - 配置选项
+ * @param {boolean} options.isMs - 输入是否为毫秒，默认false（秒）
+ * @param {string} options.format - 输出格式：'duration'（持续时间）| 'relative'（相对时间），默认'duration'
+ * @param {string} options.separator - 时间分隔符，默认':'
+ * @param {boolean} options.complete - 是否显示完整时间格式，默认false
+ * @param {boolean} options.showDate - 是否显示日期部分，默认true
+ * @param {boolean} options.showTime - 是否显示时间部分，默认true
+ * @returns {string} 格式化后的时间字符串
+ */
+export declare function formatTime(time: number | string | Date, { isMs, format, separator, complete, showDate, showTime, }?: {
+    isMs?: boolean | undefined;
+    format?: string | undefined;
+    separator?: string | undefined;
+    complete?: boolean | undefined;
+    showDate?: boolean | undefined;
+    showTime?: boolean | undefined;
+}): string;

package/lib/src/date-transfer.js

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c={thresholds:{second:1e3,minute:6e4,hour:36e5,day:864e5,month:2592e6,year:31536e6},units:{year:31536e6,month:2592e6,day:864e5,hour:36e5,minute:6e4,second:1e3},labels:{relative:{justNow:"刚刚",seconds:"几秒前",minutes:"分钟前",hours:"小时前",days:"天前",months:"个月前",years:"年前"}}};function p(i,{isMs:m=!1,format:d="duration",separator:$=":",complete:y=!1,showDate:M=!0,showTime:S=!0}={}){let e;if(typeof i=="number")e=m?i:i*1e3;else{const r=Date.now(),t=new Date(i).getTime();e=d==="relative"?r-t:t}if(Number.isNaN(e)||e<0)throw new Error("无效的时间输入");if(d==="relative"){const{justNow:r,seconds:t,minutes:f,hours:w,days:N,months:T,years:b}=c.labels.relative,o=c.thresholds;return e<o.second?r:e<o.minute?t:e<o.hour?`${Math.floor(e/o.minute)}${f}`:e<o.day?`${Math.floor(e/o.hour)}${w}`:e<o.month?`${Math.floor(e/o.day)}${N}`:e<o.year?`${Math.floor(e/o.month)}${T}`:`${Math.floor(e/o.year)}${b}`}const l=[],u=Math.floor(e/1e3),h=Math.floor(u/(24*3600)),a=Math.floor(u%(24*3600)/3600),s=Math.floor(u%3600/60),n=u%60;if(M&&h>0&&l.push(`${h}天`),S){const r=f=>String(f).padStart(2,"0");let t="";y?t=`${r(a)}${$}${r(s)}${$}${r(n)}`:h>0?(t=a>0?`${a}小时`:"",t+=s>0?`${s}分钟`:""):a>0?(t=`${a}小时`,t+=s>0?`${s}分钟`:"",t+=n>0?`${n}秒`:""):s>0?(t=`${s}分钟`,t+=n>0?`${n}秒`:""):t=`${n}秒`,t&&l.push(t)}return l.join(" ")}exports.formatTime=p;
+//# sourceMappingURL=date-transfer.js.map

package/lib/src/date-transfer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-transfer.js","sources":["../../../../packages/utils/src/date-transfer.ts"],"sourcesContent":["// 将阈值和时间单位合并为一个常量对象\nconst TIME_CONSTANTS = {\n  thresholds: {\n    second: 1000,\n    minute: 60000,\n    hour: 3600000,\n    day: 86400000,\n    month: 2592000000,\n    year: 31536000000,\n  },\n  units: {\n    year: 31536000000,\n    month: 2592000000,\n    day: 86400000,\n    hour: 3600000,\n    minute: 60000,\n    second: 1000,\n  },\n  labels: {\n    relative: {\n      justNow: '刚刚',\n      seconds: '几秒前',\n      minutes: '分钟前',\n      hours: '小时前',\n      days: '天前',\n      months: '个月前',\n      years: '年前',\n    },\n  },\n}\n\n/**\n * 统一的时间转换函数\n * @param {number|string|Date} time - 输入时间（时间戳、日期字符串或Date对象）\n * @param {object} options - 配置选项\n * @param {boolean} options.isMs - 输入是否为毫秒，默认false（秒）\n * @param {string} options.format - 输出格式：'duration'（持续时间）| 'relative'（相对时间），默认'duration'\n * @param {string} options.separator - 时间分隔符，默认':'\n * @param {boolean} options.complete - 是否显示完整时间格式，默认false\n * @param {boolean} options.showDate - 是否显示日期部分，默认true\n * @param {boolean} options.showTime - 是否显示时间部分，默认true\n * @returns {string} 格式化后的时间字符串\n */\nexport function formatTime(\n  time: number | string | Date,\n  {\n    isMs = false,\n    format = 'duration',\n    separator = ':',\n    complete = false,\n    showDate = true,\n    showTime = true,\n  } = {},\n) {\n  // 处理输入时间\n  let ms: number\n\n  if (typeof time === 'number') {\n    ms = isMs ? time : time * 1000\n  }\n  else {\n    const now = Date.now()\n    const timestamp = new Date(time).getTime()\n    ms = format === 'relative' ? now - timestamp : timestamp\n  }\n\n  // 验证输入\n  if (Number.isNaN(ms) || ms < 0) {\n    throw new Error('无效的时间输入')\n  }\n\n  // 相对时间格式\n  if (format === 'relative') {\n    const { justNow, seconds, minutes, hours, days, months, years }\n      = TIME_CONSTANTS.labels.relative\n    const thresholds = TIME_CONSTANTS.thresholds\n\n    if (ms < thresholds.second) {\n      return justNow\n    }\n    if (ms < thresholds.minute) {\n      return seconds\n    }\n    if (ms < thresholds.hour) {\n      return `${Math.floor(ms / thresholds.minute)}${minutes}`\n    }\n    if (ms < thresholds.day) {\n      return `${Math.floor(ms / thresholds.hour)}${hours}`\n    }\n    if (ms < thresholds.month) {\n      return `${Math.floor(ms / thresholds.day)}${days}`\n    }\n    if (ms < thresholds.year) {\n      return `${Math.floor(ms / thresholds.month)}${months}`\n    }\n    return `${Math.floor(ms / thresholds.year)}${years}`\n  }\n\n  // 持续时间格式\n  const result = []\n  const totalSeconds = Math.floor(ms / 1000)\n  const days = Math.floor(totalSeconds / (24 * 3600))\n  const hours = Math.floor((totalSeconds % (24 * 3600)) / 3600)\n  const minutes = Math.floor((totalSeconds % 3600) / 60)\n  const seconds = totalSeconds % 60\n\n  // 处理日期部分\n  if (showDate && days > 0) {\n    result.push(`${days}天`)\n  }\n\n  // 处理时间部分\n  if (showTime) {\n    const pad = (num: number): string => String(num).padStart(2, '0')\n    let timeStr = ''\n\n    if (complete) {\n      timeStr = `${pad(hours)}${separator}${pad(minutes)}${separator}${pad(seconds)}`\n    }\n    else {\n      if (days > 0) {\n        timeStr = hours > 0 ? `${hours}小时` : ''\n        timeStr += minutes > 0 ? `${minutes}分钟` : ''\n      }\n      else if (hours > 0) {\n        timeStr = `${hours}小时`\n        timeStr += minutes > 0 ? `${minutes}分钟` : ''\n        timeStr += seconds > 0 ? `${seconds}秒` : ''\n      }\n      else if (minutes > 0) {\n        timeStr = `${minutes}分钟`\n        timeStr += seconds > 0 ? `${seconds}秒` : ''\n      }\n      else {\n        timeStr = `${seconds}秒`\n      }\n    }\n    if (timeStr) {\n      result.push(timeStr)\n    }\n  }\n\n  return result.join(' ')\n}\n"],"names":["TIME_CONSTANTS","formatTime","time","isMs","format","separator","complete","showDate","showTime","ms","now","timestamp","justNow","seconds","minutes","hours","days","months","years","thresholds","result","totalSeconds","pad","num","timeStr"],"mappings":"gFACA,MAAMA,EAAiB,CACrB,WAAY,CACV,OAAQ,IACR,OAAQ,IACR,KAAM,KACN,IAAK,MACL,MAAO,OACP,KAAM,OACR,EACA,MAAO,CACL,KAAM,QACN,MAAO,OACP,IAAK,MACL,KAAM,KACN,OAAQ,IACR,OAAQ,GACV,EACA,OAAQ,CACN,SAAU,CACR,QAAS,KACT,QAAS,MACT,QAAS,MACT,MAAO,MACP,KAAM,KACN,OAAQ,MACR,MAAO,IAAA,CACT,CAEJ,EAcO,SAASC,EACdC,EACA,CACE,KAAAC,EAAO,GACP,OAAAC,EAAS,WACT,UAAAC,EAAY,IACZ,SAAAC,EAAW,GACX,SAAAC,EAAW,GACX,SAAAC,EAAW,EACb,EAAI,GACJ,CAEI,IAAAC,EAEA,GAAA,OAAOP,GAAS,SACbO,EAAAN,EAAOD,EAAOA,EAAO,QAEvB,CACG,MAAAQ,EAAM,KAAK,IAAI,EACfC,EAAY,IAAI,KAAKT,CAAI,EAAE,QAAQ,EACpCO,EAAAL,IAAW,WAAaM,EAAMC,EAAYA,CAAA,CAIjD,GAAI,OAAO,MAAMF,CAAE,GAAKA,EAAK,EACrB,MAAA,IAAI,MAAM,SAAS,EAI3B,GAAIL,IAAW,WAAY,CACzB,KAAM,CAAE,QAAAQ,EAAS,QAAAC,EAAS,QAAAC,EAAS,MAAAC,EAAO,KAAAC,EAAM,OAAAC,EAAQ,MAAAC,CAAM,EAC1DlB,EAAe,OAAO,SACpBmB,EAAanB,EAAe,WAE9B,OAAAS,EAAKU,EAAW,OACXP,EAELH,EAAKU,EAAW,OACXN,EAELJ,EAAKU,EAAW,KACX,GAAG,KAAK,MAAMV,EAAKU,EAAW,MAAM,CAAC,GAAGL,CAAO,GAEpDL,EAAKU,EAAW,IACX,GAAG,KAAK,MAAMV,EAAKU,EAAW,IAAI,CAAC,GAAGJ,CAAK,GAEhDN,EAAKU,EAAW,MACX,GAAG,KAAK,MAAMV,EAAKU,EAAW,GAAG,CAAC,GAAGH,CAAI,GAE9CP,EAAKU,EAAW,KACX,GAAG,KAAK,MAAMV,EAAKU,EAAW,KAAK,CAAC,GAAGF,CAAM,GAE/C,GAAG,KAAK,MAAMR,EAAKU,EAAW,IAAI,CAAC,GAAGD,CAAK,EAAA,CAIpD,MAAME,EAAS,CAAC,EACVC,EAAe,KAAK,MAAMZ,EAAK,GAAI,EACnCO,EAAO,KAAK,MAAMK,GAAgB,GAAK,KAAK,EAC5CN,EAAQ,KAAK,MAAOM,GAAgB,GAAK,MAAS,IAAI,EACtDP,EAAU,KAAK,MAAOO,EAAe,KAAQ,EAAE,EAC/CR,EAAUQ,EAAe,GAQ/B,GALId,GAAYS,EAAO,GACdI,EAAA,KAAK,GAAGJ,CAAI,GAAG,EAIpBR,EAAU,CACN,MAAAc,EAAOC,GAAwB,OAAOA,CAAG,EAAE,SAAS,EAAG,GAAG,EAChE,IAAIC,EAAU,GAEVlB,EACFkB,EAAU,GAAGF,EAAIP,CAAK,CAAC,GAAGV,CAAS,GAAGiB,EAAIR,CAAO,CAAC,GAAGT,CAAS,GAAGiB,EAAIT,CAAO,CAAC,GAGzEG,EAAO,GACTQ,EAAUT,EAAQ,EAAI,GAAGA,CAAK,KAAO,GACrCS,GAAWV,EAAU,EAAI,GAAGA,CAAO,KAAO,IAEnCC,EAAQ,GACfS,EAAU,GAAGT,CAAK,KAClBS,GAAWV,EAAU,EAAI,GAAGA,CAAO,KAAO,GAC1CU,GAAWX,EAAU,EAAI,GAAGA,CAAO,IAAM,IAElCC,EAAU,GACjBU,EAAU,GAAGV,CAAO,KACpBU,GAAWX,EAAU,EAAI,GAAGA,CAAO,IAAM,IAGzCW,EAAU,GAAGX,CAAO,IAGpBW,GACFJ,EAAO,KAAKI,CAAO,CACrB,CAGK,OAAAJ,EAAO,KAAK,GAAG,CACxB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qxs-bns/utils",
-  "version": "0.0.15",
+  "version": "0.0.16",
   "main": "lib/index.js",
   "module": "es/index.mjs",
   "types": "es/index.d.ts",