@base-web-kits/base-tools-ts 0.0.3 → 0.0.5

package/dist/index.js

@@ -0,0 +1,1140 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+
+// src/ts/index.ts
+var index_exports = {};
+__export(index_exports, {
+  BigNumber: () => BigNumber,
+  appendUrlParam: () => appendUrlParam,
+  arrayMove: () => arrayMove,
+  big: () => big,
+  bigAdd: () => bigAdd,
+  bigCompare: () => bigCompare,
+  bigDiv: () => bigDiv,
+  bigEqual: () => bigEqual,
+  bigGt: () => bigGt,
+  bigGte: () => bigGte,
+  bigLt: () => bigLt,
+  bigLte: () => bigLte,
+  bigMul: () => bigMul,
+  bigPow: () => bigPow,
+  bigRound: () => bigRound,
+  bigSub: () => bigSub,
+  buildOssUrl: () => buildOssUrl,
+  createRandId: () => createRandId,
+  createTimeRandId: () => createTimeRandId,
+  createUuid: () => createUuid,
+  dayjs: () => dayjs,
+  getAgeByBirthdate: () => getAgeByBirthdate,
+  getCountdownParts: () => getCountdownParts,
+  getDateRangeAfter: () => getDateRangeAfter,
+  getDateRangeBefore: () => getDateRangeBefore,
+  getFileSuffix: () => getFileSuffix,
+  getFileType: () => getFileType,
+  getObjectKeys: () => getObjectKeys,
+  getOssAudio: () => getOssAudio,
+  getOssHls: () => getOssHls,
+  getOssImg: () => getOssImg,
+  getOssVideo: () => getOssVideo,
+  getQnAudio: () => getQnAudio,
+  getQnHls: () => getQnHls,
+  getQnImg: () => getQnImg,
+  getQnVideo: () => getQnVideo,
+  getStringByteLength: () => getStringByteLength,
+  getUrlNumber: () => getUrlNumber,
+  getUrlParam: () => getUrlParam,
+  getUrlParamAll: () => getUrlParamAll,
+  isBankCard: () => isBankCard,
+  isChinese: () => isChinese,
+  isChineseName: () => isChineseName,
+  isDigits: () => isDigits,
+  isEmail: () => isEmail,
+  isHKMOPermit: () => isHKMOPermit,
+  isHexColor: () => isHexColor,
+  isIP: () => isIP,
+  isIPRange: () => isIPRange,
+  isIPv6: () => isIPv6,
+  isIdentityCard: () => isIdentityCard,
+  isJSON: () => isJSON,
+  isLandline: () => isLandline,
+  isLatitude: () => isLatitude,
+  isLetter: () => isLetter,
+  isLicensePlate: () => isLicensePlate,
+  isLongitude: () => isLongitude,
+  isMilitaryId: () => isMilitaryId,
+  isMobilePhone: () => isMobilePhone,
+  isNumeric: () => isNumeric,
+  isOfficerId: () => isOfficerId,
+  isPassport: () => isPassport,
+  isPhone: () => isPhone,
+  isPortNumber: () => isPortNumber,
+  isSoldierId: () => isSoldierId,
+  isTaiwanPermit: () => isTaiwanPermit,
+  isTaxID: () => isTaxID,
+  isURL: () => isURL,
+  randomBoolean: () => randomBoolean,
+  randomFloat: () => randomFloat,
+  randomInt: () => randomInt,
+  toAsync: () => toAsync,
+  toChineseCurrency: () => toChineseCurrency,
+  toChineseNum: () => toChineseNum,
+  toDayjs: () => toDayjs,
+  toFixed: () => toFixed,
+  toMaskName: () => toMaskName,
+  toMaskPhone: () => toMaskPhone,
+  toMaskText: () => toMaskText,
+  toThousandth: () => toThousandth,
+  withDistance: () => withDistance,
+  withUnit: () => withUnit,
+  withUnitPx: () => withUnitPx,
+  zeroPad: () => zeroPad
+});
+
+// src/ts/array/index.ts
+function arrayMove(list, fromIndex, toIndex) {
+  const newList = [...list];
+  const [removed] = newList.splice(fromIndex, 1);
+  newList.splice(toIndex, 0, removed);
+  return newList;
+}
+
+// src/ts/async/index.ts
+async function toAsync(p) {
+  try {
+    const data = await p;
+    return [data, null];
+  } catch (err) {
+    return [null, err];
+  }
+}
+
+// src/ts/day/index.ts
+import dayjs from "dayjs";
+import customParseFormat from "dayjs/plugin/customParseFormat";
+import utc from "dayjs/plugin/utc";
+import timezone from "dayjs/plugin/timezone";
+import relativeTime from "dayjs/plugin/relativeTime";
+import advancedFormat from "dayjs/plugin/advancedFormat";
+import "dayjs/locale/zh-cn";
+
+// src/ts/number/big.ts
+import BigNumber from "bignumber.js";
+function big(x) {
+  return x instanceof BigNumber ? x : new BigNumber(x);
+}
+function bigAdd(a, ...rest) {
+  let acc = big(a);
+  for (const x of rest) acc = acc.plus(big(x));
+  return acc.toNumber();
+}
+function bigSub(a, ...rest) {
+  let acc = big(a);
+  for (const x of rest) acc = acc.minus(big(x));
+  return acc.toNumber();
+}
+function bigMul(a, ...rest) {
+  let acc = big(a);
+  for (const x of rest) acc = acc.times(big(x));
+  return acc.toNumber();
+}
+function bigDiv(a, ...rest) {
+  let acc = big(a);
+  for (const x of rest) acc = acc.div(big(x));
+  return acc.toNumber();
+}
+function bigPow(x, y) {
+  return big(x).pow(big(y)).toNumber();
+}
+function bigRound(x, dp = 0, rm = BigNumber.ROUND_HALF_UP) {
+  return big(x).decimalPlaces(dp, rm).toNumber();
+}
+function toFixed(x, dp = 2, rm = BigNumber.ROUND_HALF_UP) {
+  return big(x).toFixed(dp, rm);
+}
+function bigCompare(a, b) {
+  return big(a).comparedTo(big(b));
+}
+function bigEqual(a, b) {
+  return big(a).isEqualTo(big(b));
+}
+function bigGt(a, b) {
+  return big(a).isGreaterThan(big(b));
+}
+function bigGte(a, b) {
+  return big(a).isGreaterThanOrEqualTo(big(b));
+}
+function bigLt(a, b) {
+  return big(a).isLessThan(big(b));
+}
+function bigLte(a, b) {
+  return big(a).isLessThanOrEqualTo(big(b));
+}
+
+// src/ts/number/format.ts
+function zeroPad(n, len = 2) {
+  return String(n).padStart(len, "0");
+}
+function withUnit(num, unit = "") {
+  if (num === null || num === void 0 || num === "") return "";
+  if (typeof num === "number") return `${num}${unit}`;
+  const str = String(num).trim();
+  if (str === "") return "";
+  return isNaN(+str) ? str : `${str}${unit}`;
+}
+function withUnitPx(num) {
+  return withUnit(num, "px");
+}
+function withDistance(m) {
+  const n = Number(m ?? 0);
+  if (!Number.isFinite(n)) return "0m";
+  return n >= 1e3 ? `${+(n / 1e3).toFixed(2)}km` : `${+n.toFixed(2)}m`;
+}
+function toThousandth(str) {
+  const v = String(str ?? "").trim();
+  if (v === "") return "";
+  let sign = "";
+  let num = v;
+  if (num[0] === "-" || num[0] === "+") {
+    sign = num[0];
+    num = num.slice(1);
+  }
+  const [intPart, decPart] = num.split(".");
+  const groupedInt = intPart.replace(/\B(?=(\d{3})+(?!\d))/g, ",");
+  return decPart !== void 0 && decPart !== "" ? `${sign}${groupedInt}.${decPart}` : `${sign}${groupedInt}`;
+}
+function toChineseNum(num) {
+  const numInt = Math.trunc(+num);
+  if (numInt === 0) return "\u96F6";
+  const digit = ["\u96F6", "\u4E00", "\u4E8C", "\u4E09", "\u56DB", "\u4E94", "\u516D", "\u4E03", "\u516B", "\u4E5D"];
+  const unit = ["", "\u5341", "\u767E", "\u5343"];
+  const bigUnit = ["", "\u4E07", "\u4EBF", "\u5146"];
+  const section4 = (n2) => {
+    let str = "", zeroFlag = false;
+    for (let i = 0; i < 4; i++) {
+      const d = n2 % 10;
+      n2 = Math.floor(n2 / 10);
+      if (d === 0) {
+        zeroFlag = true;
+        continue;
+      }
+      if (zeroFlag) str = digit[0] + str;
+      str = digit[d] + unit[i] + str;
+      zeroFlag = false;
+    }
+    return str;
+  };
+  let res = "";
+  let sectionIndex = 0;
+  let n = Math.abs(numInt);
+  while (n > 0) {
+    const seg = n % 1e4;
+    n = Math.floor(n / 1e4);
+    if (seg) {
+      const segStr = section4(seg);
+      res = segStr + (sectionIndex ? bigUnit[sectionIndex] : "") + res;
+    } else if (res && !res.startsWith("\u96F6")) {
+      res = `\u96F6${res}`;
+    }
+    sectionIndex++;
+  }
+  res = res.replace(/^一十/, "\u5341");
+  return numInt < 0 ? `\u8D1F${res}` : res;
+}
+function toChineseCurrency(amount, opts = {}) {
+  const dp = opts.precision ?? 2;
+  const rm = opts.rm ?? BigNumber.ROUND_HALF_UP;
+  const yuan = opts.yuanChar ?? "\u5143";
+  if (amount === null || amount === void 0) return "";
+  const bn = new BigNumber(amount);
+  if (!bn.isFinite()) return "";
+  const s = bn.toFixed(dp, rm);
+  const sign = s.startsWith("-") ? "\u8D1F" : "";
+  const [intStr, decStr = ""] = s.replace(/^-/, "").split(".");
+  const digit = ["\u96F6", "\u58F9", "\u8D30", "\u53C1", "\u8086", "\u4F0D", "\u9646", "\u67D2", "\u634C", "\u7396"];
+  const unit = ["", "\u62FE", "\u4F70", "\u4EDF"];
+  const bigUnit = ["", "\u4E07", "\u4EBF", "\u5146"];
+  const smallUnit = ["\u89D2", "\u5206", "\u5398"];
+  const section4 = (n) => {
+    let str = "";
+    let zeroFlag = false;
+    for (let i = 0; i < 4; i++) {
+      const d = n.mod(10).toNumber();
+      n = n.idiv(10);
+      if (d === 0) {
+        zeroFlag = true;
+        continue;
+      }
+      if (zeroFlag) str = digit[0] + str;
+      str = digit[d] + unit[i] + str;
+      zeroFlag = false;
+    }
+    return str.replace(/零+$/g, "");
+  };
+  const intNum = new BigNumber(intStr);
+  let res = "";
+  if (intNum.isZero()) {
+    res = digit[0];
+  } else {
+    let n = intNum.abs();
+    let sectionIndex = 0;
+    while (n.gt(0)) {
+      const seg = n.mod(1e4);
+      n = n.idiv(1e4);
+      if (seg.gt(0)) {
+        const segStr = section4(seg);
+        const needZero = res && !res.startsWith(digit[0]) && (seg.lt(1e3) || seg.mod(1e3).isZero());
+        const bu = sectionIndex ? bigUnit[sectionIndex] : "";
+        res = segStr + bu + (needZero ? digit[0] : "") + res;
+      } else if (res && !res.startsWith(digit[0])) {
+        res = digit[0] + res;
+      }
+      sectionIndex++;
+    }
+    res = res.replace(/^壹拾/, "\u62FE");
+  }
+  let frac = "";
+  for (let i = 0; i < Math.min(3, dp); i++) {
+    const ch = decStr[i] || "0";
+    const d = ch.charCodeAt(0) - 48;
+    if (d > 0) frac += digit[d] + smallUnit[i];
+  }
+  return frac ? `${sign}${res}${yuan}${frac}` : `${sign}${res}${yuan}\u6574`;
+}
+
+// src/ts/number/random.ts
+function randomInt(a, b) {
+  if (!Number.isFinite(a) || !Number.isFinite(b)) {
+    throw new TypeError("min \u548C max \u5FC5\u987B\u662F\u6709\u9650\u6570\u503C");
+  }
+  const low = Math.min(a, b);
+  const high = Math.max(a, b);
+  const minInt = Math.ceil(low);
+  const maxInt = Math.floor(high);
+  if (maxInt < minInt) {
+    throw new RangeError("\u53D6\u6574\u540E\u533A\u95F4\u4E3A\u7A7A");
+  }
+  if (maxInt === minInt) return minInt;
+  return Math.floor(Math.random() * (maxInt - minInt + 1)) + minInt;
+}
+function randomFloat(a, b) {
+  if (!Number.isFinite(a) || !Number.isFinite(b)) {
+    throw new TypeError("min \u548C max \u5FC5\u987B\u662F\u6709\u9650\u6570\u503C");
+  }
+  const low = Math.min(a, b);
+  const high = Math.max(a, b);
+  if (high === low) return low;
+  return Math.random() * (high - low) + low;
+}
+function randomBoolean() {
+  return Math.random() < 0.5;
+}
+
+// src/ts/day/index.ts
+dayjs.extend(customParseFormat);
+dayjs.extend(utc);
+dayjs.extend(timezone);
+dayjs.extend(relativeTime);
+dayjs.extend(advancedFormat);
+dayjs.locale("zh-cn");
+function toDayjs(t, fmt) {
+  if (t === null || t === void 0) return dayjs();
+  if (typeof t === "number") {
+    const s = String(Math.trunc(t));
+    return dayjs(s.length === 10 ? t * 1e3 : t, fmt);
+  }
+  if (typeof t === "string") {
+    const s = t.trim();
+    if (/^\d{10}$/.test(s)) return dayjs(Number(s) * 1e3, fmt);
+    if (/^\d{13}$/.test(s)) return dayjs(Number(s), fmt);
+    if (/^\d{4}-\d{2}-\d{2}$/.test(s)) return dayjs(s, fmt || "YYYY-MM-DD");
+    if (/^\d{4}\/\d{2}\/\d{2}$/.test(s)) return dayjs(s, fmt || "YYYY/MM/DD");
+    if (/^\d{4}-\d{2}-\d{2}\s+\d{2}:\d{2}:\d{2}$/.test(s))
+      return dayjs(s, fmt || "YYYY-MM-DD HH:mm:ss");
+    if (/^\d{4}\/\d{2}\/\d{2}\s+\d{2}:\d{2}:\d{2}$/.test(s))
+      return dayjs(s, fmt || "YYYY/MM/DD HH:mm:ss");
+    return dayjs(s, fmt);
+  }
+  return dayjs(t, fmt);
+}
+function getDateRangeBefore(offset, fmt = "YYYY-MM-DD") {
+  const now = toDayjs(Date.now());
+  const n = Math.max(0, Math.trunc(offset));
+  const hasTime = /H|h|m|s|S|A|a|x|X/.test(fmt);
+  const startDay = now.add(-n, "day");
+  const endDay = now;
+  const start = (hasTime ? startDay.startOf("day") : startDay).format(fmt);
+  const end = (hasTime ? endDay.endOf("day") : endDay).format(fmt);
+  return [start, end];
+}
+function getDateRangeAfter(offset, fmt = "YYYY-MM-DD") {
+  const now = toDayjs(Date.now());
+  const n = Math.max(0, Math.trunc(offset));
+  const hasTime = /H|h|m|s|S|A|a|x|X/.test(fmt);
+  const startDay = now;
+  const endDay = now.add(n, "day");
+  const start = (hasTime ? startDay.startOf("day") : startDay).format(fmt);
+  const end = (hasTime ? endDay.endOf("day") : endDay).format(fmt);
+  return [start, end];
+}
+function getCountdownParts(diff) {
+  if (diff <= 0) return { d: "00", h: "00", m: "00", s: "00", ms: "000" };
+  const d = Math.floor(diff / (1e3 * 60 * 60 * 24));
+  const h = Math.floor(diff / (1e3 * 60 * 60) % 24);
+  const m = Math.floor(diff / (1e3 * 60) % 60);
+  const s = Math.floor(diff / 1e3 % 60);
+  const ms = diff % 1e3;
+  return {
+    d: zeroPad(d),
+    h: zeroPad(h),
+    m: zeroPad(m),
+    s: zeroPad(s),
+    ms: zeroPad(ms, 3)
+  };
+}
+function getAgeByBirthdate(birthdate) {
+  const birth = toDayjs(birthdate, "YYYY-MM-DD");
+  const now = toDayjs(Date.now());
+  const totalMonths = (now.year() - birth.year()) * 12 + (now.month() - birth.month());
+  const adjustedMonths = now.date() < birth.date() ? totalMonths - 1 : totalMonths;
+  if (adjustedMonths >= 12) {
+    let age = Math.floor(adjustedMonths / 12);
+    const birthdayThisYear = birth.add(age, "year");
+    if (now.isBefore(birthdayThisYear)) {
+      age--;
+    }
+    return { age, type: "year" };
+  }
+  return { age: adjustedMonths, type: "month" };
+}
+
+// src/ts/lodash/index.ts
+var lodash_exports = {};
+__reExport(lodash_exports, lodash_es_star);
+import * as lodash_es_star from "lodash-es";
+
+// src/ts/index.ts
+__reExport(index_exports, lodash_exports);
+
+// src/ts/object/index.ts
+function getObjectKeys(obj) {
+  return Object.keys(obj);
+}
+
+// src/ts/string/format.ts
+function toMaskText(s, keepLeft = 1, keepRight = 0, maskChar = "*") {
+  if (!s) return "";
+  const v = String(s);
+  const l = Math.max(0, keepLeft);
+  const r = Math.max(0, keepRight);
+  const len = v.length;
+  const left = Math.min(l, len);
+  const right = Math.min(r, len - left);
+  const mid = len - left - right;
+  if (mid <= 0) return v;
+  const m = maskChar && maskChar.length > 0 ? maskChar : "*";
+  return v.slice(0, left) + m.repeat(mid) + v.slice(len - right);
+}
+function toMaskPhone(phone) {
+  return toMaskText(phone, 3, 4);
+}
+function toMaskName(name) {
+  if (!name) return "";
+  const v = String(name);
+  return v.length <= 2 ? toMaskText(v, 1, 0) : toMaskText(v, 1, 1);
+}
+
+// src/ts/string/random.ts
+function createUuid() {
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, function(c) {
+    const r = Math.random() * 16 | 0, v = c === "x" ? r : r & 3 | 8;
+    return v.toString(16);
+  });
+}
+function createRandId(prefix = "id_") {
+  return `${prefix}${Math.random().toString(36).substring(2, 16)}`;
+}
+function createTimeRandId(digits = 6) {
+  const base = 10 ** (digits - 1);
+  const range = 9 * base;
+  const randomInt2 = Math.floor(Math.random() * range) + base;
+  return `${Date.now()}${randomInt2}`;
+}
+
+// src/ts/string/other.ts
+function getStringByteLength(str) {
+  let byteLen = 0;
+  for (let i = 0; i < str.length; i++) {
+    const code = str.charCodeAt(i);
+    if (code <= 127) {
+      byteLen += 1;
+    } else if (code <= 2047) {
+      byteLen += 2;
+    } else if (code >= 55296 && code <= 56319) {
+      byteLen += 4;
+      i++;
+    } else {
+      byteLen += 3;
+    }
+  }
+  return byteLen;
+}
+
+// src/ts/url/file/index.ts
+var FILE_TYPE = {
+  img: ["png", "jpg", "jpeg", "gif", "svg", "webp"],
+  video: ["mp4", "mov", "m4v"],
+  voice: ["mp3", "wav", "m4a"],
+  excel: ["csv", "xls", "xlsx", "xlsm", "ods"],
+  word: ["txt", "doc", "docx", "pdf", "md", "wps"],
+  zip: ["zip", "gz", "tar", "rar", "7z"],
+  ppt: ["ppt", "pptx", "odp"],
+  app: ["apk", "ipa"]
+};
+function getFileSuffix(fileName) {
+  if (fileName.startsWith(".")) return "";
+  const idx = fileName.lastIndexOf(".");
+  return idx > 0 ? fileName.slice(idx + 1).toLowerCase() : "";
+}
+function getFileType(fileName) {
+  const suffix = getFileSuffix(fileName);
+  if (!suffix) return "unknown";
+  const keys = getObjectKeys(FILE_TYPE);
+  for (const key of keys) {
+    if (FILE_TYPE[key].includes(suffix)) {
+      return key;
+    }
+  }
+  return "unknown";
+}
+
+// src/ts/url/oss/index.ts
+function getOssImg(src, option) {
+  return buildOssUrl(src, "image", option);
+}
+function getOssVideo(src, option) {
+  return buildOssUrl(src, "video", option);
+}
+function getOssAudio(src, option) {
+  return buildOssUrl(src, "audio", option);
+}
+function getOssHls(src, option) {
+  return buildOssUrl(src, "hls", option);
+}
+function buildOssUrl(src, type, option) {
+  if (!src || !option) return src;
+  if (src.startsWith("blob:")) return src;
+  if (src.includes(".svg")) return src;
+  const segs = [];
+  for (const [k, v] of Object.entries(option)) {
+    const seg = k === "watermark" ? getWatermark(v) : getOssSegs(k, v);
+    if (seg) segs.push(seg);
+  }
+  if (!segs.length) return src;
+  const base = src.split("?")[0];
+  return `${base}?x-oss-process=${type}/${segs.join("/")}`;
+}
+function getOssSegs(type, option) {
+  if (!option && option !== 0) return "";
+  if (option === true) return type;
+  if (typeof option === "number" || typeof option === "string") return `${type},${option}`;
+  const segs = Object.entries(option).map(([k, v]) => `${k}_${v}`).join(",");
+  return segs ? `${type},${segs}` : "";
+}
+function getWatermark(w) {
+  if (!w) return "";
+  if (w.image) w.image = toBase64Url(w.image);
+  if (w.text) w.text = toBase64Url(w.text);
+  if (w.type) w.type = toBase64Url(w.type);
+  return getOssSegs("watermark", w);
+}
+function toBase64Url(s) {
+  let b64 = "";
+  if (typeof Buffer !== "undefined") {
+    const buf = Buffer.from(s, "utf-8");
+    b64 = buf.toString("base64");
+  } else {
+    try {
+      b64 = btoa(unescape(encodeURIComponent(s)));
+    } catch {
+      b64 = "";
+    }
+  }
+  return b64.replace(/=+$/g, "").replace(/\+/g, "-").replace(/\//g, "_");
+}
+
+// src/ts/url/param/index.ts
+function getUrlParam(key, url) {
+  const raw = url.includes("?") ? url.slice(url.indexOf("?") + 1) : url.includes("=") ? url : "";
+  const qs = raw.split("#")[0];
+  if (!qs) return null;
+  const pairs = qs.split("&").filter(Boolean);
+  const decode = (s) => {
+    try {
+      return decodeURIComponent(s.replace(/\+/g, " "));
+    } catch {
+      return s;
+    }
+  };
+  for (const pair of pairs) {
+    const i = pair.indexOf("=");
+    const k = i >= 0 ? pair.slice(0, i) : pair;
+    if (decode(k) === key) {
+      const v = i >= 0 ? decode(pair.slice(i + 1)) : "";
+      return v !== "null" && v !== "undefined" ? v : null;
+    }
+  }
+  return null;
+}
+function getUrlNumber(key, url) {
+  const str = getUrlParam(key, url);
+  if (!str) return null;
+  const num = Number(str);
+  return isNaN(num) ? null : num;
+}
+function getUrlParamAll(url) {
+  const raw = url.includes("?") ? url.slice(url.indexOf("?") + 1) : url.includes("=") ? url : "";
+  const qs = raw.split("#")[0];
+  const result = {};
+  if (!qs) return result;
+  const decode = (s) => {
+    try {
+      return decodeURIComponent(s.replace(/\+/g, " "));
+    } catch {
+      return s;
+    }
+  };
+  for (const seg of qs.split("&")) {
+    if (!seg) continue;
+    const i = seg.indexOf("=");
+    const k = i >= 0 ? seg.slice(0, i) : seg;
+    const v = i >= 0 ? seg.slice(i + 1) : "";
+    const dv = decode(v);
+    if (dv !== "null" && dv !== "undefined") {
+      result[decode(k)] = dv;
+    }
+  }
+  return result;
+}
+function appendUrlParam(url, param) {
+  if (!param || typeof param !== "object") return url;
+  const hashIndex = url.indexOf("#");
+  const baseWithoutHash = hashIndex >= 0 ? url.slice(0, hashIndex) : url;
+  const hash = hashIndex >= 0 ? url.slice(hashIndex) : "";
+  const [base, existingQs] = baseWithoutHash.split("?");
+  const parts = [];
+  if (existingQs) parts.push(existingQs);
+  for (const key in param) {
+    const rawVal = param[key];
+    if (rawVal === null || rawVal === void 0) continue;
+    const val = typeof rawVal === "object" ? JSON.stringify(rawVal) : String(rawVal);
+    parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(val)}`);
+  }
+  const qs = parts.filter(Boolean).join("&");
+  return base + (qs ? `?${qs}` : "") + hash;
+}
+
+// src/ts/url/qn/index.ts
+function getQnImg(src, option) {
+  if (!src || !option) return src;
+  if (src.startsWith("blob:")) return src;
+  if (src.includes(".svg")) return src;
+  const segs = [];
+  if (option.imageslim) segs.push("imageslim");
+  if (option.imageView2) segs.push(getImageView2(option.imageView2));
+  const mogr = getImageMogr2(option.imageMogr2 ?? option);
+  if (mogr) segs.push(mogr);
+  if (option.watermark) segs.push(getWatermark2(option.watermark));
+  if (option.imageInfo) segs.push("imageInfo");
+  if (!segs.length) return src;
+  const base = src.split("?")[0];
+  return `${base}?${segs.join("|")}`;
+}
+function getQnVideo(src, option) {
+  if (!src || !option) return src;
+  if (src.startsWith("blob:")) return src;
+  if (src.includes(".svg")) return src;
+  const segs = [];
+  if (option.avthumb) segs.push(getAvthumb(option.avthumb));
+  if (option.vframe) segs.push(getVframe(option.vframe));
+  if (!segs.length) return src;
+  const base = src.split("?")[0];
+  return `${base}?${segs.join("|")}`;
+}
+function getQnAudio(src, option) {
+  if (!src || !option) return src;
+  if (src.startsWith("blob:")) return src;
+  const segs = [];
+  if (option.avthumb) segs.push(getAvthumb(option.avthumb));
+  if (!segs.length) return src;
+  const base = src.split("?")[0];
+  return `${base}?${segs.join("|")}`;
+}
+function getQnHls(src, option) {
+  if (!src || !option) return src;
+  if (src.startsWith("blob:")) return src;
+  const seg = getAvcvt(option);
+  if (!seg) return src;
+  const base = src.split("?")[0];
+  return `${base}?${seg}`;
+}
+function getImageView2(opt) {
+  if (!opt) return "";
+  const mode = typeof opt.mode === "number" ? opt.mode : 0;
+  const kv = [];
+  for (const [k, v] of Object.entries(opt)) {
+    if (k === "mode") continue;
+    if (typeof v === "boolean") {
+      if (v) kv.push(`${k}/1`);
+    } else if (typeof v === "number" || typeof v === "string") {
+      kv.push(`${k}/${v}`);
+    }
+  }
+  return kv.length ? `imageView2/${mode}/${kv.join("/")}` : `imageView2/${mode}`;
+}
+function getImageMogr2(opt) {
+  if (!opt) return "";
+  const parts = [];
+  const tn = opt.thumbnail;
+  if (typeof tn !== "undefined") parts.push(`thumbnail/${tn}`);
+  const cp = opt.crop;
+  if (typeof cp !== "undefined") parts.push(`crop/${cp}`);
+  const rot = opt.rotate;
+  if (typeof rot === "number") parts.push(`rotate/${rot}`);
+  const ao = opt["auto-orient"];
+  if (ao) parts.push("auto-orient");
+  const fmt = opt.format;
+  if (typeof fmt === "string") parts.push(`format/${fmt}`);
+  const il = opt.interlace;
+  if (il === 0 || il === 1) parts.push(`interlace/${il}`);
+  const bg = opt.background;
+  if (typeof bg === "string") parts.push(`background/${bg}`);
+  const q = opt.q;
+  if (typeof q === "number") parts.push(`q/${q}`);
+  const blur = opt.blur;
+  if (typeof blur !== "undefined") {
+    if (typeof blur === "string") parts.push(`blur/${blur}`);
+    else parts.push(`blur/${blur.r}x${blur.s}`);
+  }
+  const colors = opt.colors;
+  if (typeof colors === "number") parts.push(`colors/${colors}`);
+  return parts.length ? `imageMogr2/${parts.join("/")}` : "";
+}
+function getWatermark2(w) {
+  if (!w) return "";
+  const mode = w.type === "image" ? 1 : w.type === "text" ? 2 : typeof w.type === "number" ? w.type : 2;
+  const segs = [`watermark/${mode}`];
+  if (mode === 1 && w.image) segs.push(`image/${toBase64Url2(w.image)}`);
+  if (mode === 2 && w.text) segs.push(`text/${toBase64Url2(w.text)}`);
+  if (w.font) segs.push(`font/${toBase64Url2(w.font)}`);
+  if (typeof w.fontsize === "number") segs.push(`fontsize/${w.fontsize}`);
+  if (w.fill) segs.push(`fill/${toBase64Url2(w.fill)}`);
+  if (w.gravity) segs.push(`gravity/${w.gravity}`);
+  if (typeof w.dx === "number") segs.push(`dx/${w.dx}`);
+  if (typeof w.dy === "number") segs.push(`dy/${w.dy}`);
+  if (typeof w.dissolve === "number") segs.push(`dissolve/${w.dissolve}`);
+  return segs.join("/");
+}
+function toBase64Url2(s) {
+  let b64 = "";
+  if (typeof Buffer !== "undefined") {
+    const buf = Buffer.from(s, "utf-8");
+    b64 = buf.toString("base64");
+  } else {
+    try {
+      b64 = btoa(unescape(encodeURIComponent(s)));
+    } catch {
+      b64 = "";
+    }
+  }
+  return b64.replace(/=+$/g, "").replace(/\+/g, "-").replace(/\//g, "_");
+}
+function getAvthumb(opt) {
+  const parts = [];
+  if (opt.format) parts.push(`avthumb/${opt.format}`);
+  else parts.push("avthumb");
+  if (opt.s) parts.push(`s/${opt.s}`);
+  if (opt.vcodec) parts.push(`vcodec/${opt.vcodec}`);
+  if (typeof opt.vb !== "undefined") parts.push(`vb/${opt.vb}`);
+  if (typeof opt.r === "number") parts.push(`r/${opt.r}`);
+  if (typeof opt.ab !== "undefined") parts.push(`ab/${opt.ab}`);
+  if (typeof opt.ar === "number") parts.push(`ar/${opt.ar}`);
+  if (opt.acodec) parts.push(`acodec/${opt.acodec}`);
+  return parts.join("/");
+}
+function getVframe(opt) {
+  const parts = [];
+  parts.push(`vframe/${opt.format || "jpg"}`);
+  if (typeof opt.offset === "number") parts.push(`offset/${opt.offset}`);
+  if (typeof opt.w === "number") parts.push(`w/${opt.w}`);
+  if (typeof opt.h === "number") parts.push(`h/${opt.h}`);
+  return parts.join("/");
+}
+function getAvcvt(opt) {
+  const parts = [];
+  const level = typeof opt.level === "number" ? `/${opt.level}` : "/3";
+  parts.push(`avcvt${level}`);
+  parts.push(`format/${opt.format || "m3u8"}`);
+  if (typeof opt.segtime === "number") parts.push(`segtime/${opt.segtime}`);
+  if (typeof opt.t === "string") parts.push(`t/${opt.t}`);
+  if (opt.vcodec) parts.push(`vcodec/${opt.vcodec}`);
+  if (typeof opt.vb !== "undefined") parts.push(`vb/${opt.vb}`);
+  if (typeof opt.r === "number") parts.push(`r/${opt.r}`);
+  if (typeof opt.s === "string") parts.push(`s/${opt.s}`);
+  if (opt.acodec) parts.push(`acodec/${opt.acodec}`);
+  if (typeof opt.ab !== "undefined") parts.push(`ab/${opt.ab}`);
+  if (typeof opt.ar === "number") parts.push(`ar/${opt.ar}`);
+  if (typeof opt.output === "string") parts.push(`output/${toBase64Url2(opt.output)}`);
+  return parts.join("/");
+}
+
+// src/ts/validator/index.ts
+function isLetter(s) {
+  return /^[a-zA-Z]*$/.test(s);
+}
+function isChinese(s) {
+  const v = String(s ?? "").trim();
+  return /^[\u4E00-\u9FA5]+$/.test(v);
+}
+function isDigits(s) {
+  return /^[0-9]+$/.test(s);
+}
+function isNumeric(value, options) {
+  const { negative = false, decimal = 2, thousands = false, leadZero = false } = options || {};
+  if (value === null || value === void 0 || value === "") return false;
+  const str = String(value).trim();
+  const sign = negative && str.startsWith("-") ? "-" : "";
+  const body = sign ? str.slice(1) : str;
+  const thousandsPart = thousands ? "(?:[1-9]\\d{0,2}(,\\d{3})*|0)" : "(?:\\d+)";
+  const intPart = thousands ? thousandsPart : leadZero ? "(?:\\d+)" : "(?:0|[1-9]\\d*)";
+  const fracPart = decimal === 0 ? "" : `(\\.\\d{1,${decimal}})`;
+  const pattern = `^${intPart}${fracPart}$`;
+  const reg = new RegExp(pattern);
+  return reg.test(body);
+}
+function isMobilePhone(s) {
+  const v = String(s ?? "").trim();
+  return /^1[3-9]\d{9}$/.test(v);
+}
+function isLandline(s) {
+  const v = String(s ?? "").trim();
+  return /^0\d{2,3}-?\d{7,8}(?:-\d{1,6})?$/.test(v);
+}
+function isPhone(s) {
+  return isMobilePhone(s) || isLandline(s);
+}
+function isEmail(s) {
+  const v = String(s ?? "").trim();
+  if (v === "") return false;
+  const emailRegex = /^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?(?:\.[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?)+$/;
+  return emailRegex.test(v);
+}
+function isChineseName(s) {
+  const v = String(s ?? "").trim();
+  return /^[\u4E00-\u9FA5·]{2,20}$/.test(v);
+}
+function isIdentityCard(code) {
+  const v = String(code ?? "").trim();
+  if (v === "") return false;
+  const isValidDate = (yyyymmdd) => {
+    const y = Number(yyyymmdd.slice(0, 4));
+    const m = Number(yyyymmdd.slice(4, 6));
+    const d = Number(yyyymmdd.slice(6, 8));
+    if (y < 1900 || y > 2100) return false;
+    const date = new Date(y, m - 1, d);
+    return date.getFullYear() === y && date.getMonth() === m - 1 && date.getDate() === d;
+  };
+  if (/^\d{17}[\dXx]$/.test(v)) {
+    const birth = v.slice(6, 14);
+    if (!isValidDate(birth)) return false;
+    const weights = [7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2];
+    const checkMap = ["1", "0", "X", "9", "8", "7", "6", "5", "4", "3", "2"];
+    let sum = 0;
+    for (let i = 0; i < 17; i++) sum += Number(v[i]) * weights[i];
+    const mod = sum % 11;
+    const code18 = v[17].toUpperCase();
+    return checkMap[mod] === code18;
+  }
+  if (/^\d{15}$/.test(v)) {
+    const birth = v.slice(6, 12);
+    const y = Number(`19${birth.slice(0, 2)}`);
+    const m = Number(birth.slice(2, 4));
+    const d = Number(birth.slice(4, 6));
+    const date = new Date(y, m - 1, d);
+    return date.getFullYear() === y && date.getMonth() === m - 1 && date.getDate() === d;
+  }
+  if (/^[A-Za-z][12]\d{8}$/.test(v)) return true;
+  if (/^[A-Za-z]{1,2}\d{6}\(?[0-9A]\)?$/.test(v)) return true;
+  if (/^[157]\d{6}\(?\d\)?$/.test(v)) return true;
+  return false;
+}
+function isPassport(s) {
+  const t = String(s ?? "").replace(/[-\s]/g, "").trim();
+  if (t === "") return false;
+  if (/^[EG]\d{8}$/.test(t)) return true;
+  if (/^[DPS]\d{7}$/.test(t)) return true;
+  if (/^[A-Za-z]\d{8}$/.test(t)) return true;
+  if (/^[A-Za-z0-9]{6,9}$/.test(t)) return true;
+  return false;
+}
+function isHKMOPermit(s) {
+  const t = String(s ?? "").replace(/[-\s]/g, "").trim().toUpperCase();
+  return /^[HM]\d{8,10}$/.test(t);
+}
+function isTaiwanPermit(s) {
+  const t = String(s ?? "").replace(/[-\s]/g, "").trim().toUpperCase();
+  if (/^\d{8}$/.test(t)) return true;
+  if (/^[A-Z]\d{8}$/.test(t)) return true;
+  if (/^\d{10}$/.test(t)) return true;
+  return false;
+}
+function isOfficerId(s) {
+  const t = String(s ?? "").replace(/[-\s]/g, "").trim().toUpperCase();
+  return /^[A-Z0-9]{7,18}$/.test(t);
+}
+function isSoldierId(s) {
+  const t = String(s ?? "").replace(/[-\s]/g, "").trim().toUpperCase();
+  return /^[A-Z0-9]{7,18}$/.test(t);
+}
+function isMilitaryId(s) {
+  return isOfficerId(s) || isSoldierId(s);
+}
+function isBankCard(s) {
+  const t = String(s ?? "").replace(/[-\s]/g, "").trim();
+  if (!/^\d{12,19}$/.test(t)) return false;
+  let sum = 0;
+  let shouldDouble = false;
+  for (let i = t.length - 1; i >= 0; i--) {
+    let digit = Number(t[i]);
+    if (shouldDouble) {
+      digit *= 2;
+      if (digit > 9) digit -= 9;
+    }
+    sum += digit;
+    shouldDouble = !shouldDouble;
+  }
+  return sum % 10 === 0;
+}
+function isLicensePlate(s) {
+  const v = String(s ?? "").trim().toUpperCase();
+  const prov = "\u4EAC\u6CAA\u6D25\u6E1D\u5180\u8C6B\u4E91\u8FBD\u9ED1\u6E58\u7696\u9C81\u65B0\u82CF\u6D59\u8D63\u9102\u6842\u7518\u664B\u8499\u9655\u5409\u95FD\u8D35\u9752\u85CF\u5DDD\u5B81\u743C\u7CA4";
+  const std = new RegExp(`^[${prov}][A-HJ-NP-Z][A-HJ-NP-Z0-9]{4}[A-HJ-NP-Z0-9\u6302\u5B66\u8B66\u6E2F\u6FB3]$`);
+  const ne1 = new RegExp(`^[${prov}][A-HJ-NP-Z][DF][A-HJ-NP-Z0-9]{5}$`);
+  const ne2 = new RegExp(`^[${prov}][A-HJ-NP-Z][A-HJ-NP-Z0-9]{5}[DF]$`);
+  return std.test(v) || ne1.test(v) || ne2.test(v);
+}
+function isTaxID(code) {
+  const v = String(code ?? "").trim();
+  if (!/^[0-9A-HJ-NPQRTUWXY]{18}$/.test(v)) return false;
+  const charset = "0123456789ABCDEFGHJKLMNPQRTUWXY";
+  const weights = [1, 3, 9, 27, 19, 26, 16, 17, 20, 29, 25, 13, 8, 24, 10, 30, 28];
+  const map = {};
+  for (let i = 0; i < charset.length; i++) map[charset[i]] = i;
+  let sum = 0;
+  for (let i = 0; i < 17; i++) {
+    sum += map[v[i]] * weights[i];
+  }
+  const logicCheck = (31 - sum % 31) % 31;
+  const expected = charset[logicCheck];
+  return v[17] === expected;
+}
+function isJSON(input) {
+  if (typeof input === "string") {
+    const s = input.trim();
+    if (s === "") return false;
+    try {
+      JSON.parse(s);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  if (input !== null && typeof input === "object") return true;
+  return false;
+}
+function isHexColor(s) {
+  const v = String(s ?? "").trim();
+  return /^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/.test(v);
+}
+function isURL(s) {
+  const v = String(s ?? "").trim();
+  if (v === "") return false;
+  try {
+    const u = new URL(v);
+    return ["http:", "https:", "ftp:"].includes(u.protocol) && !!u.hostname;
+  } catch {
+    return false;
+  }
+}
+function isIPv4(s) {
+  const v = String(s ?? "").trim();
+  if (v === "") return false;
+  const parts = v.split(".");
+  if (parts.length !== 4) return false;
+  for (const p of parts) {
+    if (!/^\d+$/.test(p)) return false;
+    if (p.length > 1 && p.startsWith("0")) return false;
+    const n = Number(p);
+    if (n < 0 || n > 255) return false;
+  }
+  return true;
+}
+function isIPv6(s) {
+  const v = String(s ?? "").trim();
+  if (v === "") return false;
+  const lastColon = v.lastIndexOf(":");
+  if (lastColon !== -1 && v.includes(".")) {
+    const ipv6Part = v.slice(0, lastColon);
+    const ipv4Part = v.slice(lastColon + 1);
+    return isIPv6(ipv6Part) && isIPv4(ipv4Part);
+  }
+  const dblColonCount = (v.match(/::/g) || []).length;
+  if (dblColonCount > 1) return false;
+  const segments = v.split(":");
+  if (v.startsWith("::")) segments.shift();
+  if (v.endsWith("::")) segments.pop();
+  const segmentsFiltered = segments.filter((seg) => seg !== "");
+  if (dblColonCount === 0 && segmentsFiltered.length !== 8) return false;
+  if (dblColonCount === 1 && segmentsFiltered.length >= 1 && segmentsFiltered.length <= 7) {
+  } else if (dblColonCount === 1 && segments.length === 0) {
+    return true;
+  } else if (dblColonCount === 0 && segmentsFiltered.length === 8) {
+  } else {
+    return false;
+  }
+  return segmentsFiltered.every(
+    (seg) => seg.length >= 1 && seg.length <= 4 && /^[0-9a-fA-F]{1,4}$/.test(seg)
+  );
+}
+function isIP(s, version) {
+  if (version === 4 || version === "4") return isIPv4(s);
+  if (version === 6 || version === "6") return isIPv6(s);
+  return isIPv4(s) || isIPv6(s);
+}
+function isIPRange(s) {
+  const v = String(s ?? "").trim();
+  if (v === "") return false;
+  const parts = v.split("/");
+  if (parts.length !== 2) return false;
+  const [ip, prefixStr] = parts;
+  if (!/^\d+$/.test(prefixStr)) return false;
+  const prefix = Number(prefixStr);
+  if (ip.includes(":")) {
+    if (!isIPv6(ip)) return false;
+    return prefix >= 0 && prefix <= 128;
+  }
+  if (!isIPv4(ip)) return false;
+  return prefix >= 0 && prefix <= 32;
+}
+function isPortNumber(s) {
+  const v = typeof s === "number" ? s : Number(String(s ?? "").trim());
+  return Number.isInteger(v) && v >= 0 && v <= 65535;
+}
+function isLatitude(s) {
+  const v = typeof s === "number" ? s : Number(String(s ?? "").trim());
+  return Number.isFinite(v) && v >= -90 && v <= 90;
+}
+function isLongitude(s) {
+  const v = typeof s === "number" ? s : Number(String(s ?? "").trim());
+  return Number.isFinite(v) && v >= -180 && v <= 180;
+}
+export {
+  BigNumber,
+  appendUrlParam,
+  arrayMove,
+  big,
+  bigAdd,
+  bigCompare,
+  bigDiv,
+  bigEqual,
+  bigGt,
+  bigGte,
+  bigLt,
+  bigLte,
+  bigMul,
+  bigPow,
+  bigRound,
+  bigSub,
+  buildOssUrl,
+  createRandId,
+  createTimeRandId,
+  createUuid,
+  dayjs,
+  getAgeByBirthdate,
+  getCountdownParts,
+  getDateRangeAfter,
+  getDateRangeBefore,
+  getFileSuffix,
+  getFileType,
+  getObjectKeys,
+  getOssAudio,
+  getOssHls,
+  getOssImg,
+  getOssVideo,
+  getQnAudio,
+  getQnHls,
+  getQnImg,
+  getQnVideo,
+  getStringByteLength,
+  getUrlNumber,
+  getUrlParam,
+  getUrlParamAll,
+  isBankCard,
+  isChinese,
+  isChineseName,
+  isDigits,
+  isEmail,
+  isHKMOPermit,
+  isHexColor,
+  isIP,
+  isIPRange,
+  isIPv6,
+  isIdentityCard,
+  isJSON,
+  isLandline,
+  isLatitude,
+  isLetter,
+  isLicensePlate,
+  isLongitude,
+  isMilitaryId,
+  isMobilePhone,
+  isNumeric,
+  isOfficerId,
+  isPassport,
+  isPhone,
+  isPortNumber,
+  isSoldierId,
+  isTaiwanPermit,
+  isTaxID,
+  isURL,
+  randomBoolean,
+  randomFloat,
+  randomInt,
+  toAsync,
+  toChineseCurrency,
+  toChineseNum,
+  toDayjs,
+  toFixed,
+  toMaskName,
+  toMaskPhone,
+  toMaskText,
+  toThousandth,
+  withDistance,
+  withUnit,
+  withUnitPx,
+  zeroPad
+};