@cloudcome/utils-core 1.1.1 → 1.2.1

package/dist/promise.mjs

@@ -0,0 +1,62 @@
+import { isPromise, isObject } from "./type.mjs";
+function isPromiseLike(unknown) {
+  return isPromise(unknown) || isObject(unknown) && typeof unknown.then === "function";
+}
+async function promiseDelay(ms = 0, ctrl) {
+  return new Promise((resolve) => {
+    const t = setTimeout(resolve, ms);
+    if (ctrl) {
+      ctrl.signal.addEventListener("abort", () => {
+        clearTimeout(t);
+        resolve();
+      });
+    }
+  });
+}
+async function promiseTimeout(promise, ms) {
+  const ctrl = new AbortController();
+  const result = await Promise.race([
+    promise,
+    promiseDelay(ms, ctrl).then(() => {
+      throw new Error("timeout");
+    })
+  ]);
+  ctrl.abort();
+  return result;
+}
+function promiseWhen(condition, ms = 10) {
+  return new Promise((resolve, reject) => {
+    const check = () => {
+      if (condition()) {
+        resolve();
+      } else {
+        setTimeout(check, ms);
+      }
+    };
+    check();
+  });
+}
+function promiseShared(promise) {
+  return new Promise((resolve, reject) => {
+    promise.then(resolve, reject);
+  });
+}
+function createMinDelayPromise(ms) {
+  const startTime = Date.now();
+  return async function end() {
+    const endTime = Date.now();
+    const waitTime = ms - (endTime - startTime);
+    if (waitTime > 0) {
+      await promiseDelay(waitTime);
+    }
+  };
+}
+export {
+  createMinDelayPromise,
+  isPromiseLike,
+  promiseDelay,
+  promiseShared,
+  promiseTimeout,
+  promiseWhen
+};
+//# sourceMappingURL=promise.mjs.map

package/dist/promise.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise.mjs","sources":["../src/promise.ts"],"sourcesContent":["import { isObject, isPromise } from './type';\n\n/**\n * 检查给定的值是否为 Promise 类似对象。\n * @param unknown - 要检查的值。\n * @returns 如果值是 Promise 类似对象，则返回 `true`，否则返回 `false`。\n */\nexport function isPromiseLike<T>(unknown: unknown): unknown is Promise<T> {\n  return isPromise(unknown) || (isObject(unknown) && typeof (unknown as unknown as Promise<T>).then === 'function');\n}\n\n/**\n * 等待一定时间后解决 Promise\n * @param ms - 等待的毫秒数，默认为 0\n * @param ctrl - 可选的 AbortController，用于提前终止等待\n * @returns 一个 Promise，等待指定时间后解决\n */\nexport async function promiseDelay(ms = 0, ctrl?: AbortController) {\n  return new Promise<void>((resolve) => {\n    const t = setTimeout(resolve, ms);\n\n    if (ctrl) {\n      ctrl.signal.addEventListener('abort', () => {\n        clearTimeout(t);\n        resolve();\n      });\n    }\n  });\n}\n\n/**\n * 使 Promise 在指定时间内执行，超时则拒绝\n * @param promise - 要执行的 Promise\n * @param ms - 超时的毫秒数\n * @returns 如果 Promise 在指定时间内解决，则返回其结果；否则抛出 \"timeout\" 错误\n * @throws {Error} 如果 Promise 超时，抛出 \"timeout\" 错误\n */\nexport async function promiseTimeout<T>(promise: Promise<T>, ms: number) {\n  const ctrl = new AbortController();\n  const result = await Promise.race([\n    promise,\n    promiseDelay(ms, ctrl).then(() => {\n      throw new Error('timeout');\n    }),\n  ]);\n  ctrl.abort();\n  return result;\n}\n\n/**\n * 在指定条件满足时解决 Promise\n * @param condition - 一个返回布尔值的函数，用于检查条件是否满足\n * @param ms - 检查条件的时间间隔（毫秒），默认为 10\n * @returns 一个 Promise，在条件满足时解决\n */\nexport function promiseWhen(condition: () => boolean, ms = 10) {\n  return new Promise<void>((resolve, reject) => {\n    const check = () => {\n      if (condition()) {\n        resolve();\n      } else {\n        setTimeout(check, ms);\n      }\n    };\n\n    check();\n  });\n}\n\n/**\n * 创建一个与给定 Promise 共享状态的新 Promise。\n * 新的 Promise 不具备 resolve 或 reject 的能力，它仅反映原始 Promise 的状态。\n * @param promise - 要共享状态的原始 Promise。\n * @returns 一个新的 Promise，其状态与给定的 Promise 完全相同。\n * @example\n * const { promise: p1 } = Promise.withResolvers();\n * const sp1 = sharedPromise(p1);\n * const sp2 = sharedPromise(p1);\n * // 此时 sp1、sp2 完全共享 p1 的状态，自身并不具备 resolve 或 reject 的能力\n */\nexport function promiseShared<T>(promise: Promise<T>) {\n  return new Promise<T>((resolve, reject) => {\n    promise.then(resolve, reject);\n  });\n}\n\n/**\n * 创建一个最小等待时间的函数\n * @param {number} ms - 最小等待时间（毫秒）\n * @returns {function} 返回一个异步函数，该函数会确保从 createMinDelayPromise 调用到其执行的时间至少为 ms 毫秒\n * @example\n * const end = createMinDelayPromise(1000);\n * // 执行一些操作\n * await end(); // 确保从 createMinDelayPromise 调用到这里的总时间至少为 1000 毫秒\n */\nexport function createMinDelayPromise(ms: number) {\n  const startTime = Date.now();\n  /**\n   * 确保最小等待时间的结束函数\n   * @async\n   * @function end\n   * @returns {Promise<void>} 在达到最小等待时间后解决\n   */\n  return async function end() {\n    const endTime = Date.now();\n    const waitTime = ms - (endTime - startTime);\n    if (waitTime > 0) {\n      await promiseDelay(waitTime);\n    }\n  };\n}\n"],"names":[],"mappings":";AAOO,SAAS,cAAiB,SAAyC;AACjE,SAAA,UAAU,OAAO,KAAM,SAAS,OAAO,KAAK,OAAQ,QAAkC,SAAS;AACxG;AAQsB,eAAA,aAAa,KAAK,GAAG,MAAwB;AAC1D,SAAA,IAAI,QAAc,CAAC,YAAY;AAC9B,UAAA,IAAI,WAAW,SAAS,EAAE;AAEhC,QAAI,MAAM;AACH,WAAA,OAAO,iBAAiB,SAAS,MAAM;AAC1C,qBAAa,CAAC;AACN,gBAAA;AAAA,MAAA,CACT;AAAA,IAAA;AAAA,EACH,CACD;AACH;AASsB,eAAA,eAAkB,SAAqB,IAAY;AACjE,QAAA,OAAO,IAAI,gBAAgB;AAC3B,QAAA,SAAS,MAAM,QAAQ,KAAK;AAAA,IAChC;AAAA,IACA,aAAa,IAAI,IAAI,EAAE,KAAK,MAAM;AAC1B,YAAA,IAAI,MAAM,SAAS;AAAA,IAC1B,CAAA;AAAA,EAAA,CACF;AACD,OAAK,MAAM;AACJ,SAAA;AACT;AAQgB,SAAA,YAAY,WAA0B,KAAK,IAAI;AAC7D,SAAO,IAAI,QAAc,CAAC,SAAS,WAAW;AAC5C,UAAM,QAAQ,MAAM;AAClB,UAAI,aAAa;AACP,gBAAA;AAAA,MAAA,OACH;AACL,mBAAW,OAAO,EAAE;AAAA,MAAA;AAAA,IAExB;AAEM,UAAA;AAAA,EAAA,CACP;AACH;AAaO,SAAS,cAAiB,SAAqB;AACpD,SAAO,IAAI,QAAW,CAAC,SAAS,WAAW;AACjC,YAAA,KAAK,SAAS,MAAM;AAAA,EAAA,CAC7B;AACH;AAWO,SAAS,sBAAsB,IAAY;AAC1C,QAAA,YAAY,KAAK,IAAI;AAO3B,SAAO,eAAe,MAAM;AACpB,UAAA,UAAU,KAAK,IAAI;AACnB,UAAA,WAAW,MAAM,UAAU;AACjC,QAAI,WAAW,GAAG;AAChB,YAAM,aAAa,QAAQ;AAAA,IAAA;AAAA,EAE/B;AACF;"}

package/dist/qs.cjs

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const each = require("./each.cjs");
+const type = require("./type.cjs");
+function qsParse(queryString, parser) {
+  const sp = new globalThis.URLSearchParams(queryString.replace(/^.*\?/, ""));
+  const qsObject = {};
+  for (const [key, val] of sp.entries()) {
+    const valFinal = parser ? parser(val, key, qsObject) : val;
+    if (type.isNullish(valFinal)) continue;
+    if (Object.hasOwn(qsObject, key)) {
+      if (!type.isArray(qsObject[key])) qsObject[key] = [qsObject[key]];
+      qsObject[key].push(val);
+    } else {
+      qsObject[key] = valFinal;
+    }
+  }
+  return qsObject;
+}
+const defaultWriter = (val) => {
+  if (type.isString(val)) return val;
+  if (type.isNumber(val)) return String(val);
+  if (type.isBoolean(val)) return val ? "true" : "false";
+  if (type.isDate(val)) return val.toISOString();
+  return null;
+};
+function qsStringify(qsObject, stringify = defaultWriter) {
+  const sp = new globalThis.URLSearchParams();
+  const pushPairs = (val, key) => {
+    const valFinal = stringify(val, String(key), qsObject);
+    if (type.isNullish(valFinal)) return;
+    sp.append(key, valFinal);
+  };
+  each.objectEach(qsObject, (val, key) => {
+    if (type.isArray(val)) {
+      for (const it of val) {
+        pushPairs(it, key);
+      }
+    } else {
+      pushPairs(val, key);
+    }
+  });
+  return sp.toString();
+}
+exports.qsParse = qsParse;
+exports.qsStringify = qsStringify;
+//# sourceMappingURL=qs.cjs.map

package/dist/qs.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"qs.cjs","sources":["../src/qs.ts"],"sourcesContent":["import { objectEach } from './object';\nimport { isArray, isBoolean, isDate, isNull, isNullish, isNumber, isString, isUndefined } from './type';\nimport type { AnyObject } from './types';\n\n/**\n * 查询字符串解析函数\n * @template T - 解析后返回的对象类型\n * @callback QSReader\n * @param {string} value - 查询字符串的值\n * @param {string} key - 查询字符串的键\n * @param {T} qsObject - 当前解析的对象\n * @returns {unknown} 解析后的值，如果返回 undefined 或 null 则不会添加到对象中\n * @example\n * const parser: QSReader<MyObject> = (value, key, obj) => {\n *   if (key === 'date') return new Date(value);\n *   return value;\n * };\n */\nexport type QSReader<T extends AnyObject> = (value: string, key: string, qsObject: T) => unknown;\n\n/**\n * 解析查询字符串为对象\n * @template T - 返回的对象类型\n * @param {string} queryString - 要解析的查询字符串\n * @param {QSReader<T>} [parser] - 自定义解析函数\n * @returns {T} 解析后的对象\n * @example\n * const obj = qsParse('name=John&age=30');\n * // { name: 'John', age: '30' }\n *\n * const obj2 = qsParse('date=2023-01-01', (val, key) => {\n *   if (key === 'date') return new Date(val);\n *   return val;\n * });\n * // { date: Date('2023-01-01') }\n */\nexport function qsParse<T extends AnyObject>(queryString: string, parser?: QSReader<T>): T {\n  // 添加 globalThis 是便于对接外部环境 URL 的自行实现\n  // 例如在 uni-app、微信小程序等运行环境。\n  const sp = new globalThis.URLSearchParams(queryString.replace(/^.*\\?/, ''));\n  const qsObject = {} as T;\n\n  for (const [key, val] of sp.entries()) {\n    const valFinal = parser ? parser(val, key, qsObject) : val;\n\n    if (isNullish(valFinal)) continue;\n\n    if (Object.hasOwn(qsObject, key)) {\n      // @ts-expect-error\n      if (!isArray(qsObject[key])) qsObject[key] = [qsObject[key]];\n      (qsObject[key] as unknown[]).push(val);\n    } else {\n      // @ts-expect-error\n      qsObject[key] = valFinal;\n    }\n  }\n\n  return qsObject;\n}\n\n/**\n * 查询字符串序列化函数\n * @template T - 要序列化的对象类型\n * @callback QSWriter\n * @param {unknown} value - 要序列化的值\n * @param {string} key - 对象的键\n * @param {T} query - 当前序列化的对象\n * @returns {string | null} 序列化后的字符串，如果返回 null 则忽略该键值对\n * @example\n * const writer: QSWriter<MyObject> = (val, key) => {\n *   if (val instanceof Date) return val.toISOString();\n *   return String(val);\n * };\n */\nexport type QSWriter<T extends AnyObject = AnyObject> = (value: unknown, key: string, query: T) => string | null;\nconst defaultWriter: QSWriter<AnyObject> = (val: unknown) => {\n  if (isString(val)) return val;\n  if (isNumber(val)) return String(val);\n  if (isBoolean(val)) return val ? 'true' : 'false';\n  if (isDate(val)) return val.toISOString();\n  return null;\n};\n\n/**\n * 将对象序列化为查询字符串\n * @template T - 要序列化的对象类型\n * @param {T} qsObject - 要序列化的对象\n * @param {QSWriter<T>} [stringify=defaultWriter] - 自定义序列化函数\n * @returns {string} 序列化后的查询字符串\n * @example\n * const str = qsStringify({ name: 'John', age: 30 });\n * // 'name=John&age=30'\n *\n * const str2 = qsStringify({ date: new Date('2023-01-01') });\n * // 'date=2023-01-01T00:00:00.000Z'\n */\nexport function qsStringify<T extends AnyObject>(qsObject: T, stringify: QSWriter<T> = defaultWriter): string {\n  // 添加 globalThis 是便于对接外部环境 URL 的自行实现\n  // 例如在 uni-app、微信小程序等运行环境。\n  const sp = new globalThis.URLSearchParams();\n  const pushPairs = (val: unknown, key: string) => {\n    const valFinal = stringify(val, String(key), qsObject);\n    if (isNullish(valFinal)) return;\n\n    sp.append(key, valFinal);\n  };\n\n  objectEach(qsObject, (val, key: string) => {\n    if (isArray(val)) {\n      for (const it of val) {\n        pushPairs(it, key);\n      }\n    } else {\n      pushPairs(val, key);\n    }\n  });\n\n  return sp.toString();\n}\n"],"names":["isNullish","isArray","isString","isNumber","isBoolean","isDate","objectEach"],"mappings":";;;;AAoCgB,SAAA,QAA6B,aAAqB,QAAyB;AAGnF,QAAA,KAAK,IAAI,WAAW,gBAAgB,YAAY,QAAQ,SAAS,EAAE,CAAC;AAC1E,QAAM,WAAW,CAAC;AAElB,aAAW,CAAC,KAAK,GAAG,KAAK,GAAG,WAAW;AACrC,UAAM,WAAW,SAAS,OAAO,KAAK,KAAK,QAAQ,IAAI;AAEnD,QAAAA,KAAAA,UAAU,QAAQ,EAAG;AAEzB,QAAI,OAAO,OAAO,UAAU,GAAG,GAAG;AAEhC,UAAI,CAACC,KAAA,QAAQ,SAAS,GAAG,CAAC,EAAY,UAAA,GAAG,IAAI,CAAC,SAAS,GAAG,CAAC;AAC1D,eAAS,GAAG,EAAgB,KAAK,GAAG;AAAA,IAAA,OAChC;AAEL,eAAS,GAAG,IAAI;AAAA,IAAA;AAAA,EAClB;AAGK,SAAA;AACT;AAiBA,MAAM,gBAAqC,CAAC,QAAiB;AACvD,MAAAC,KAAA,SAAS,GAAG,EAAU,QAAA;AAC1B,MAAIC,KAAS,SAAA,GAAG,EAAG,QAAO,OAAO,GAAG;AACpC,MAAIC,KAAU,UAAA,GAAG,EAAG,QAAO,MAAM,SAAS;AAC1C,MAAIC,KAAO,OAAA,GAAG,EAAG,QAAO,IAAI,YAAY;AACjC,SAAA;AACT;AAegB,SAAA,YAAiC,UAAa,YAAyB,eAAuB;AAGtG,QAAA,KAAK,IAAI,WAAW,gBAAgB;AACpC,QAAA,YAAY,CAAC,KAAc,QAAgB;AAC/C,UAAM,WAAW,UAAU,KAAK,OAAO,GAAG,GAAG,QAAQ;AACjD,QAAAL,KAAAA,UAAU,QAAQ,EAAG;AAEtB,OAAA,OAAO,KAAK,QAAQ;AAAA,EACzB;AAEWM,OAAAA,WAAA,UAAU,CAAC,KAAK,QAAgB;AACrC,QAAAL,KAAAA,QAAQ,GAAG,GAAG;AAChB,iBAAW,MAAM,KAAK;AACpB,kBAAU,IAAI,GAAG;AAAA,MAAA;AAAA,IACnB,OACK;AACL,gBAAU,KAAK,GAAG;AAAA,IAAA;AAAA,EACpB,CACD;AAED,SAAO,GAAG,SAAS;AACrB;;;"}

package/{src/qs.ts → dist/qs.d.ts}

@@ -1,7 +1,4 @@
-import { objectEach } from './object';
-import { isArray, isBoolean, isDate, isNull, isNullish, isNumber, isString, isUndefined } from './type';
-import type { AnyObject } from './types';
-
+import { AnyObject } from './types';
 /**
  * 查询字符串解析函数
  * @template T - 解析后返回的对象类型
@@ -17,7 +14,6 @@ import type { AnyObject } from './types';
  * };
  */
 export type QSReader<T extends AnyObject> = (value: string, key: string, qsObject: T) => unknown;
-
 /**
  * 解析查询字符串为对象
  * @template T - 返回的对象类型
@@ -34,30 +30,7 @@ export type QSReader<T extends AnyObject> = (value: string, key: string, qsObjec
  * });
  * // { date: Date('2023-01-01') }
  */
-export function qsParse<T extends AnyObject>(queryString: string, parser?: QSReader<T>): T {
-  // 添加 globalThis 是便于对接外部环境 URL 的自行实现
-  // 例如在 uni-app、微信小程序等运行环境。
-  const sp = new globalThis.URLSearchParams(queryString.replace(/^.*\?/, ''));
-  const qsObject = {} as T;
-
-  for (const [key, val] of sp.entries()) {
-    const valFinal = parser ? parser(val, key, qsObject) : val;
-
-    if (isNullish(valFinal)) continue;
-
-    if (Object.hasOwn(qsObject, key)) {
-      // @ts-expect-error
-      if (!isArray(qsObject[key])) qsObject[key] = [qsObject[key]];
-      (qsObject[key] as unknown[]).push(val);
-    } else {
-      // @ts-expect-error
-      qsObject[key] = valFinal;
-    }
-  }
-
-  return qsObject;
-}
-
+export declare function qsParse<T extends AnyObject>(queryString: string, parser?: QSReader<T>): T;
 /**
  * 查询字符串序列化函数
  * @template T - 要序列化的对象类型
@@ -73,14 +46,6 @@ export function qsParse<T extends AnyObject>(queryString: string, parser?: QSRea
  * };
  */
 export type QSWriter<T extends AnyObject = AnyObject> = (value: unknown, key: string, query: T) => string | null;
-const defaultWriter: QSWriter<AnyObject> = (val: unknown) => {
-  if (isString(val)) return val;
-  if (isNumber(val)) return String(val);
-  if (isBoolean(val)) return val ? 'true' : 'false';
-  if (isDate(val)) return val.toISOString();
-  return null;
-};
-
 /**
  * 将对象序列化为查询字符串
  * @template T - 要序列化的对象类型
@@ -94,26 +59,4 @@ const defaultWriter: QSWriter<AnyObject> = (val: unknown) => {
  * const str2 = qsStringify({ date: new Date('2023-01-01') });
  * // 'date=2023-01-01T00:00:00.000Z'
  */
-export function qsStringify<T extends AnyObject>(qsObject: T, stringify: QSWriter<T> = defaultWriter): string {
-  // 添加 globalThis 是便于对接外部环境 URL 的自行实现
-  // 例如在 uni-app、微信小程序等运行环境。
-  const sp = new globalThis.URLSearchParams();
-  const pushPairs = (val: unknown, key: string) => {
-    const valFinal = stringify(val, String(key), qsObject);
-    if (isNullish(valFinal)) return;
-
-    sp.append(key, valFinal);
-  };
-
-  objectEach(qsObject, (val, key: string) => {
-    if (isArray(val)) {
-      for (const it of val) {
-        pushPairs(it, key);
-      }
-    } else {
-      pushPairs(val, key);
-    }
-  });
-
-  return sp.toString();
-}
+export declare function qsStringify<T extends AnyObject>(qsObject: T, stringify?: QSWriter<T>): string;

package/dist/qs.mjs

@@ -0,0 +1,47 @@
+import { o as objectEach } from "./each.mjs";
+import { isNullish, isArray, isString, isNumber, isBoolean, isDate } from "./type.mjs";
+function qsParse(queryString, parser) {
+  const sp = new globalThis.URLSearchParams(queryString.replace(/^.*\?/, ""));
+  const qsObject = {};
+  for (const [key, val] of sp.entries()) {
+    const valFinal = parser ? parser(val, key, qsObject) : val;
+    if (isNullish(valFinal)) continue;
+    if (Object.hasOwn(qsObject, key)) {
+      if (!isArray(qsObject[key])) qsObject[key] = [qsObject[key]];
+      qsObject[key].push(val);
+    } else {
+      qsObject[key] = valFinal;
+    }
+  }
+  return qsObject;
+}
+const defaultWriter = (val) => {
+  if (isString(val)) return val;
+  if (isNumber(val)) return String(val);
+  if (isBoolean(val)) return val ? "true" : "false";
+  if (isDate(val)) return val.toISOString();
+  return null;
+};
+function qsStringify(qsObject, stringify = defaultWriter) {
+  const sp = new globalThis.URLSearchParams();
+  const pushPairs = (val, key) => {
+    const valFinal = stringify(val, String(key), qsObject);
+    if (isNullish(valFinal)) return;
+    sp.append(key, valFinal);
+  };
+  objectEach(qsObject, (val, key) => {
+    if (isArray(val)) {
+      for (const it of val) {
+        pushPairs(it, key);
+      }
+    } else {
+      pushPairs(val, key);
+    }
+  });
+  return sp.toString();
+}
+export {
+  qsParse,
+  qsStringify
+};
+//# sourceMappingURL=qs.mjs.map

package/dist/qs.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"qs.mjs","sources":["../src/qs.ts"],"sourcesContent":["import { objectEach } from './object';\nimport { isArray, isBoolean, isDate, isNull, isNullish, isNumber, isString, isUndefined } from './type';\nimport type { AnyObject } from './types';\n\n/**\n * 查询字符串解析函数\n * @template T - 解析后返回的对象类型\n * @callback QSReader\n * @param {string} value - 查询字符串的值\n * @param {string} key - 查询字符串的键\n * @param {T} qsObject - 当前解析的对象\n * @returns {unknown} 解析后的值，如果返回 undefined 或 null 则不会添加到对象中\n * @example\n * const parser: QSReader<MyObject> = (value, key, obj) => {\n *   if (key === 'date') return new Date(value);\n *   return value;\n * };\n */\nexport type QSReader<T extends AnyObject> = (value: string, key: string, qsObject: T) => unknown;\n\n/**\n * 解析查询字符串为对象\n * @template T - 返回的对象类型\n * @param {string} queryString - 要解析的查询字符串\n * @param {QSReader<T>} [parser] - 自定义解析函数\n * @returns {T} 解析后的对象\n * @example\n * const obj = qsParse('name=John&age=30');\n * // { name: 'John', age: '30' }\n *\n * const obj2 = qsParse('date=2023-01-01', (val, key) => {\n *   if (key === 'date') return new Date(val);\n *   return val;\n * });\n * // { date: Date('2023-01-01') }\n */\nexport function qsParse<T extends AnyObject>(queryString: string, parser?: QSReader<T>): T {\n  // 添加 globalThis 是便于对接外部环境 URL 的自行实现\n  // 例如在 uni-app、微信小程序等运行环境。\n  const sp = new globalThis.URLSearchParams(queryString.replace(/^.*\\?/, ''));\n  const qsObject = {} as T;\n\n  for (const [key, val] of sp.entries()) {\n    const valFinal = parser ? parser(val, key, qsObject) : val;\n\n    if (isNullish(valFinal)) continue;\n\n    if (Object.hasOwn(qsObject, key)) {\n      // @ts-expect-error\n      if (!isArray(qsObject[key])) qsObject[key] = [qsObject[key]];\n      (qsObject[key] as unknown[]).push(val);\n    } else {\n      // @ts-expect-error\n      qsObject[key] = valFinal;\n    }\n  }\n\n  return qsObject;\n}\n\n/**\n * 查询字符串序列化函数\n * @template T - 要序列化的对象类型\n * @callback QSWriter\n * @param {unknown} value - 要序列化的值\n * @param {string} key - 对象的键\n * @param {T} query - 当前序列化的对象\n * @returns {string | null} 序列化后的字符串，如果返回 null 则忽略该键值对\n * @example\n * const writer: QSWriter<MyObject> = (val, key) => {\n *   if (val instanceof Date) return val.toISOString();\n *   return String(val);\n * };\n */\nexport type QSWriter<T extends AnyObject = AnyObject> = (value: unknown, key: string, query: T) => string | null;\nconst defaultWriter: QSWriter<AnyObject> = (val: unknown) => {\n  if (isString(val)) return val;\n  if (isNumber(val)) return String(val);\n  if (isBoolean(val)) return val ? 'true' : 'false';\n  if (isDate(val)) return val.toISOString();\n  return null;\n};\n\n/**\n * 将对象序列化为查询字符串\n * @template T - 要序列化的对象类型\n * @param {T} qsObject - 要序列化的对象\n * @param {QSWriter<T>} [stringify=defaultWriter] - 自定义序列化函数\n * @returns {string} 序列化后的查询字符串\n * @example\n * const str = qsStringify({ name: 'John', age: 30 });\n * // 'name=John&age=30'\n *\n * const str2 = qsStringify({ date: new Date('2023-01-01') });\n * // 'date=2023-01-01T00:00:00.000Z'\n */\nexport function qsStringify<T extends AnyObject>(qsObject: T, stringify: QSWriter<T> = defaultWriter): string {\n  // 添加 globalThis 是便于对接外部环境 URL 的自行实现\n  // 例如在 uni-app、微信小程序等运行环境。\n  const sp = new globalThis.URLSearchParams();\n  const pushPairs = (val: unknown, key: string) => {\n    const valFinal = stringify(val, String(key), qsObject);\n    if (isNullish(valFinal)) return;\n\n    sp.append(key, valFinal);\n  };\n\n  objectEach(qsObject, (val, key: string) => {\n    if (isArray(val)) {\n      for (const it of val) {\n        pushPairs(it, key);\n      }\n    } else {\n      pushPairs(val, key);\n    }\n  });\n\n  return sp.toString();\n}\n"],"names":[],"mappings":";;AAoCgB,SAAA,QAA6B,aAAqB,QAAyB;AAGnF,QAAA,KAAK,IAAI,WAAW,gBAAgB,YAAY,QAAQ,SAAS,EAAE,CAAC;AAC1E,QAAM,WAAW,CAAC;AAElB,aAAW,CAAC,KAAK,GAAG,KAAK,GAAG,WAAW;AACrC,UAAM,WAAW,SAAS,OAAO,KAAK,KAAK,QAAQ,IAAI;AAEnD,QAAA,UAAU,QAAQ,EAAG;AAEzB,QAAI,OAAO,OAAO,UAAU,GAAG,GAAG;AAEhC,UAAI,CAAC,QAAQ,SAAS,GAAG,CAAC,EAAY,UAAA,GAAG,IAAI,CAAC,SAAS,GAAG,CAAC;AAC1D,eAAS,GAAG,EAAgB,KAAK,GAAG;AAAA,IAAA,OAChC;AAEL,eAAS,GAAG,IAAI;AAAA,IAAA;AAAA,EAClB;AAGK,SAAA;AACT;AAiBA,MAAM,gBAAqC,CAAC,QAAiB;AACvD,MAAA,SAAS,GAAG,EAAU,QAAA;AAC1B,MAAI,SAAS,GAAG,EAAG,QAAO,OAAO,GAAG;AACpC,MAAI,UAAU,GAAG,EAAG,QAAO,MAAM,SAAS;AAC1C,MAAI,OAAO,GAAG,EAAG,QAAO,IAAI,YAAY;AACjC,SAAA;AACT;AAegB,SAAA,YAAiC,UAAa,YAAyB,eAAuB;AAGtG,QAAA,KAAK,IAAI,WAAW,gBAAgB;AACpC,QAAA,YAAY,CAAC,KAAc,QAAgB;AAC/C,UAAM,WAAW,UAAU,KAAK,OAAO,GAAG,GAAG,QAAQ;AACjD,QAAA,UAAU,QAAQ,EAAG;AAEtB,OAAA,OAAO,KAAK,QAAQ;AAAA,EACzB;AAEW,aAAA,UAAU,CAAC,KAAK,QAAgB;AACrC,QAAA,QAAQ,GAAG,GAAG;AAChB,iBAAW,MAAM,KAAK;AACpB,kBAAU,IAAI,GAAG;AAAA,MAAA;AAAA,IACnB,OACK;AACL,gBAAU,KAAK,GAAG;AAAA,IAAA;AAAA,EACpB,CACD;AAED,SAAO,GAAG,SAAS;AACrB;"}

package/dist/regexp.cjs

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const specialRE = /[.*+?^=!:${}()|[\]/\\-]/g;
+function regexpEscape(string) {
+  return string.replace(specialRE, "\\$&");
+}
+const EMAIL_RE = /^\w+[-+.\w]*@([a-z\d-]+\.)+[a-z]{2,5}$/i;
+function isEmail(value) {
+  return EMAIL_RE.test(value);
+}
+const PHONE_RE = /^1\d{10}$/;
+function isPhone(value) {
+  return PHONE_RE.test(value);
+}
+const IDNO_RE = /^(1[1-5]|2[1-3]|3[1-7]|4[1-6]|5[0-4]|6[1-5]|7[1]|8[1-2]|9[1])\d{4}(18|19|20)\d{2}[01]\d[0123]\d{4}[\dxX]$/;
+function isIDNo(value) {
+  const isSameFormat = IDNO_RE.test(value);
+  if (!isSameFormat) return false;
+  const year = Number(value.slice(6, 10));
+  const month = Number(value.slice(10, 12));
+  const date = Number(value.slice(12, 14));
+  const d = new Date(year, month - 1, date);
+  const isSameDate = d.getFullYear() === year && d.getMonth() + 1 === month && d.getDate() === date;
+  if (!isSameDate) return false;
+  const coefficientList = [7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2];
+  const residueList = ["1", "0", "X", "9", "8", "7", "6", "5", "4", "3", "2"];
+  let sum = 0;
+  for (let start = 0; start < 17; start++) {
+    sum += Number(value.slice(start, start + 1)) * coefficientList[start];
+  }
+  return residueList[sum % 11] === value.slice(-1);
+}
+const URL_RE = /^https?:\/\/(([a-z\d-]+\.)+[a-z]{2,5}|(\d{1,3}\.){3}\d{1,3})(:[1-9]\d{0,4})?(\/|\/[\w#!:.?+=&%@'/()-]+)?$/i;
+function isURL(value) {
+  return URL_RE.test(value);
+}
+const IPV4_RE = /^(?:(?:\d|[1-9]\d|1\d\d|2[0-4]\d|25[0-5])\.){3}(?:\d|[1-9]\d|1\d\d|2[0-4]\d|25[0-5])$/;
+function isIPV4(value) {
+  return IPV4_RE.test(value);
+}
+const INTEGER_RE = /^(-?[1-9]\d*|0)$/;
+function isInteger(value) {
+  return INTEGER_RE.test(value);
+}
+const FLOAT_RE = /^-?([1-9]\d*|0)\.\d+$/;
+function isFloat(value) {
+  return FLOAT_RE.test(value);
+}
+function isNumerical(value) {
+  return isInteger(value) || isFloat(value);
+}
+const DIGIT_RE = /^\d+$/;
+function isDigit(value) {
+  return DIGIT_RE.test(value);
+}
+exports.isDigit = isDigit;
+exports.isEmail = isEmail;
+exports.isFloat = isFloat;
+exports.isIDNo = isIDNo;
+exports.isIPV4 = isIPV4;
+exports.isInteger = isInteger;
+exports.isNumerical = isNumerical;
+exports.isPhone = isPhone;
+exports.isURL = isURL;
+exports.regexpEscape = regexpEscape;
+//# sourceMappingURL=regexp.cjs.map

package/dist/regexp.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"regexp.cjs","sources":["../src/regexp.ts"],"sourcesContent":["const specialRE = /[.*+?^=!:${}()|[\\]/\\\\-]/g;\n\n/**\n * 编码处理正则表达式\n * @example\n * ```js\n * reEscape('/$')\n * // => '\\\\/\\\\$'\n * ```\n * @param {string} string\n * @returns {string}\n */\nexport function regexpEscape(string: string): string {\n  return string.replace(specialRE, '\\\\$&');\n}\n\n// 邮箱\nconst EMAIL_RE = /^\\w+[-+.\\w]*@([a-z\\d-]+\\.)+[a-z]{2,5}$/i;\n/**\n * 判断字符串是否为邮箱格式，不对邮箱真实性做验证，如域名是否正确等\n * @param {string} value\n * @returns {boolean}\n */\nexport function isEmail(value: string): boolean {\n  return EMAIL_RE.test(value);\n}\n\n// 手机号码\nconst PHONE_RE = /^1\\d{10}$/;\n/**\n * 判断字符串是否为宽松手机格式，即首位为 1 的 11 位数字都属于手机号\n * @param {string} value\n * @returns {boolean}\n */\nexport function isPhone(value: string): boolean {\n  return PHONE_RE.test(value);\n}\n\n// 身份证号码\n// http://www.stats.gov.cn/tjsj/tjbz/xzqhdm/\n// [\"北京市\", \"天津市\", \"河北省\", \"山西省\", \"内蒙古自治区\",\n// \"辽宁省\", \"吉林省\", \"黑龙江省\",\n// \"上海市\", \"江苏省\", \"浙江省\", \"安徽省\", \"福建省\", \"江西省\", \"山东省\",\n// \"河南省\", \"湖北省\", \"湖南省\", \"广东省\", \"广西壮族自治区\", \"海南省\",\n// \"重庆市\", \"四川省\", \"贵州省\", \"云南省\", \"西藏自治区\",\n// \"陕西省\", \"甘肃省\", \"青海省\",\"宁夏回族自治区\", \"新疆维吾尔自治区\",\n// \"台湾省\",\n// \"香港特别行政区\", \"澳门特别行政区\"]\n// [\"11\", \"12\", \"13\", \"14\", \"15\",\n// \"21\", \"22\", \"23\",\n// \"31\", \"32\", \"33\", \"34\", \"35\", \"36\", \"37\",\n// \"41\", \"42\", \"43\", \"44\", \"45\", \"46\",\n// \"50\", \"51\", \"52\", \"53\", \"54\",\n// \"61\", \"62\", \"63\", \"64\", \"65\",\n// \"71\",\n// \"81\", \"82\"]\n// 91 国外\nconst IDNO_RE =\n  /^(1[1-5]|2[1-3]|3[1-7]|4[1-6]|5[0-4]|6[1-5]|7[1]|8[1-2]|9[1])\\d{4}(18|19|20)\\d{2}[01]\\d[0123]\\d{4}[\\dxX]$/;\n/**\n * 判断字符串是否为身份证号码格式\n * @param {string} value\n * @returns {boolean}\n */\nexport function isIDNo(value: string): boolean {\n  const isSameFormat = IDNO_RE.test(value);\n\n  if (!isSameFormat) return false;\n\n  const year = Number(value.slice(6, 10));\n  const month = Number(value.slice(10, 12));\n  const date = Number(value.slice(12, 14));\n  const d = new Date(year, month - 1, date);\n  const isSameDate = d.getFullYear() === year && d.getMonth() + 1 === month && d.getDate() === date;\n\n  if (!isSameDate) return false;\n\n  // 将身份证号码前面的17位数分别乘以不同的系数；\n  // 从第一位到第十七位的系数分别为：7－9－10－5－8－4－2－1－6－3－7－9－10－5－8－4－2\n  // 将这17位数字和系数相乘的结果相加；\n  // 用加出来和除以11，看余数是多少；\n  // 余数只可能有0－1－2－3－4－5－6－7－8－9－10这11个数字；\n  // 其分别对应的最后一位身份证的号码为1－0－X－9－8－7－6－5－4－3－2\n  // 通过上面得知如果余数是2，就会在身份证的第18位数字上出现罗马数字的Ⅹ。如果余数是10，身份证的最后一位号码就是2。\n  const coefficientList = [7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2];\n  const residueList = ['1', '0', 'X', '9', '8', '7', '6', '5', '4', '3', '2'];\n  let sum = 0;\n\n  for (let start = 0; start < 17; start++) {\n    sum += Number(value.slice(start, start + 1)) * coefficientList[start];\n  }\n\n  return residueList[sum % 11] === value.slice(-1);\n}\n\n// url\nconst URL_RE =\n  /^https?:\\/\\/(([a-z\\d-]+\\.)+[a-z]{2,5}|(\\d{1,3}\\.){3}\\d{1,3})(:[1-9]\\d{0,4})?(\\/|\\/[\\w#!:.?+=&%@'/()-]+)?$/i;\n/**\n * 判断字符串是否为 url 格式，仅支持 http 协议，支持域名或者 ipV4\n * @param {string} value\n * @returns {boolean}\n */\nexport function isURL(value: string): boolean {\n  return URL_RE.test(value);\n}\n\n// ipv4\nconst IPV4_RE = /^(?:(?:\\d|[1-9]\\d|1\\d\\d|2[0-4]\\d|25[0-5])\\.){3}(?:\\d|[1-9]\\d|1\\d\\d|2[0-4]\\d|25[0-5])$/;\n/**\n * 判断字符串是否为 IPV4 格式，不对 ip 真实性做验证\n * @param {string} value\n * @returns {boolean}\n */\nexport function isIPV4(value: string): boolean {\n  return IPV4_RE.test(value);\n}\n\nconst INTEGER_RE = /^(-?[1-9]\\d*|0)$/;\n/**\n * 判断字符串是否为整数（自然数），即 ...,-3,-2,-1,0,1,2,3,...\n * @param {string} value\n * @returns {boolean}\n */\nexport function isInteger(value: string): boolean {\n  return INTEGER_RE.test(value);\n}\n\nconst FLOAT_RE = /^-?([1-9]\\d*|0)\\.\\d+$/;\n/**\n * 判断字符串是否为浮点数，即必须有小数点的有理数\n * @param {string} value\n * @returns {boolean}\n */\nexport function isFloat(value: string): boolean {\n  return FLOAT_RE.test(value);\n}\n\n/**\n * 判断字符串是否为正确数值，包括整数和浮点数\n * @param {string} value\n * @returns {boolean}\n */\nexport function isNumerical(value: string): boolean {\n  return isInteger(value) || isFloat(value);\n}\n\nconst DIGIT_RE = /^\\d+$/;\n/**\n * 判断字符串是否为数字，例如六位数字短信验证码（093031）\n * @param {string} value\n * @returns {boolean}\n */\nexport function isDigit(value: string): boolean {\n  return DIGIT_RE.test(value);\n}\n"],"names":[],"mappings":";;AAAA,MAAM,YAAY;AAYX,SAAS,aAAa,QAAwB;AAC5C,SAAA,OAAO,QAAQ,WAAW,MAAM;AACzC;AAGA,MAAM,WAAW;AAMV,SAAS,QAAQ,OAAwB;AACvC,SAAA,SAAS,KAAK,KAAK;AAC5B;AAGA,MAAM,WAAW;AAMV,SAAS,QAAQ,OAAwB;AACvC,SAAA,SAAS,KAAK,KAAK;AAC5B;AAqBA,MAAM,UACJ;AAMK,SAAS,OAAO,OAAwB;AACvC,QAAA,eAAe,QAAQ,KAAK,KAAK;AAEnC,MAAA,CAAC,aAAqB,QAAA;AAE1B,QAAM,OAAO,OAAO,MAAM,MAAM,GAAG,EAAE,CAAC;AACtC,QAAM,QAAQ,OAAO,MAAM,MAAM,IAAI,EAAE,CAAC;AACxC,QAAM,OAAO,OAAO,MAAM,MAAM,IAAI,EAAE,CAAC;AACvC,QAAM,IAAI,IAAI,KAAK,MAAM,QAAQ,GAAG,IAAI;AACxC,QAAM,aAAa,EAAE,YAAY,MAAM,QAAQ,EAAE,SAAS,IAAI,MAAM,SAAS,EAAE,QAAc,MAAA;AAEzF,MAAA,CAAC,WAAmB,QAAA;AASxB,QAAM,kBAAkB,CAAC,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,CAAC;AAC5E,QAAM,cAAc,CAAC,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,GAAG;AAC1E,MAAI,MAAM;AAEV,WAAS,QAAQ,GAAG,QAAQ,IAAI,SAAS;AAChC,WAAA,OAAO,MAAM,MAAM,OAAO,QAAQ,CAAC,CAAC,IAAI,gBAAgB,KAAK;AAAA,EAAA;AAGtE,SAAO,YAAY,MAAM,EAAE,MAAM,MAAM,MAAM,EAAE;AACjD;AAGA,MAAM,SACJ;AAMK,SAAS,MAAM,OAAwB;AACrC,SAAA,OAAO,KAAK,KAAK;AAC1B;AAGA,MAAM,UAAU;AAMT,SAAS,OAAO,OAAwB;AACtC,SAAA,QAAQ,KAAK,KAAK;AAC3B;AAEA,MAAM,aAAa;AAMZ,SAAS,UAAU,OAAwB;AACzC,SAAA,WAAW,KAAK,KAAK;AAC9B;AAEA,MAAM,WAAW;AAMV,SAAS,QAAQ,OAAwB;AACvC,SAAA,SAAS,KAAK,KAAK;AAC5B;AAOO,SAAS,YAAY,OAAwB;AAClD,SAAO,UAAU,KAAK,KAAK,QAAQ,KAAK;AAC1C;AAEA,MAAM,WAAW;AAMV,SAAS,QAAQ,OAAwB;AACvC,SAAA,SAAS,KAAK,KAAK;AAC5B;;;;;;;;;;;"}

package/dist/regexp.d.ts

@@ -0,0 +1,65 @@
+/**
+ * 编码处理正则表达式
+ * @example
+ * ```js
+ * reEscape('/$')
+ * // => '\\/\\$'
+ * ```
+ * @param {string} string
+ * @returns {string}
+ */
+export declare function regexpEscape(string: string): string;
+/**
+ * 判断字符串是否为邮箱格式，不对邮箱真实性做验证，如域名是否正确等
+ * @param {string} value
+ * @returns {boolean}
+ */
+export declare function isEmail(value: string): boolean;
+/**
+ * 判断字符串是否为宽松手机格式，即首位为 1 的 11 位数字都属于手机号
+ * @param {string} value
+ * @returns {boolean}
+ */
+export declare function isPhone(value: string): boolean;
+/**
+ * 判断字符串是否为身份证号码格式
+ * @param {string} value
+ * @returns {boolean}
+ */
+export declare function isIDNo(value: string): boolean;
+/**
+ * 判断字符串是否为 url 格式，仅支持 http 协议，支持域名或者 ipV4
+ * @param {string} value
+ * @returns {boolean}
+ */
+export declare function isURL(value: string): boolean;
+/**
+ * 判断字符串是否为 IPV4 格式，不对 ip 真实性做验证
+ * @param {string} value
+ * @returns {boolean}
+ */
+export declare function isIPV4(value: string): boolean;
+/**
+ * 判断字符串是否为整数（自然数），即 ...,-3,-2,-1,0,1,2,3,...
+ * @param {string} value
+ * @returns {boolean}
+ */
+export declare function isInteger(value: string): boolean;
+/**
+ * 判断字符串是否为浮点数，即必须有小数点的有理数
+ * @param {string} value
+ * @returns {boolean}
+ */
+export declare function isFloat(value: string): boolean;
+/**
+ * 判断字符串是否为正确数值，包括整数和浮点数
+ * @param {string} value
+ * @returns {boolean}
+ */
+export declare function isNumerical(value: string): boolean;
+/**
+ * 判断字符串是否为数字，例如六位数字短信验证码（093031）
+ * @param {string} value
+ * @returns {boolean}
+ */
+export declare function isDigit(value: string): boolean;

package/dist/regexp.mjs

@@ -0,0 +1,66 @@
+const specialRE = /[.*+?^=!:${}()|[\]/\\-]/g;
+function regexpEscape(string) {
+  return string.replace(specialRE, "\\$&");
+}
+const EMAIL_RE = /^\w+[-+.\w]*@([a-z\d-]+\.)+[a-z]{2,5}$/i;
+function isEmail(value) {
+  return EMAIL_RE.test(value);
+}
+const PHONE_RE = /^1\d{10}$/;
+function isPhone(value) {
+  return PHONE_RE.test(value);
+}
+const IDNO_RE = /^(1[1-5]|2[1-3]|3[1-7]|4[1-6]|5[0-4]|6[1-5]|7[1]|8[1-2]|9[1])\d{4}(18|19|20)\d{2}[01]\d[0123]\d{4}[\dxX]$/;
+function isIDNo(value) {
+  const isSameFormat = IDNO_RE.test(value);
+  if (!isSameFormat) return false;
+  const year = Number(value.slice(6, 10));
+  const month = Number(value.slice(10, 12));
+  const date = Number(value.slice(12, 14));
+  const d = new Date(year, month - 1, date);
+  const isSameDate = d.getFullYear() === year && d.getMonth() + 1 === month && d.getDate() === date;
+  if (!isSameDate) return false;
+  const coefficientList = [7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2];
+  const residueList = ["1", "0", "X", "9", "8", "7", "6", "5", "4", "3", "2"];
+  let sum = 0;
+  for (let start = 0; start < 17; start++) {
+    sum += Number(value.slice(start, start + 1)) * coefficientList[start];
+  }
+  return residueList[sum % 11] === value.slice(-1);
+}
+const URL_RE = /^https?:\/\/(([a-z\d-]+\.)+[a-z]{2,5}|(\d{1,3}\.){3}\d{1,3})(:[1-9]\d{0,4})?(\/|\/[\w#!:.?+=&%@'/()-]+)?$/i;
+function isURL(value) {
+  return URL_RE.test(value);
+}
+const IPV4_RE = /^(?:(?:\d|[1-9]\d|1\d\d|2[0-4]\d|25[0-5])\.){3}(?:\d|[1-9]\d|1\d\d|2[0-4]\d|25[0-5])$/;
+function isIPV4(value) {
+  return IPV4_RE.test(value);
+}
+const INTEGER_RE = /^(-?[1-9]\d*|0)$/;
+function isInteger(value) {
+  return INTEGER_RE.test(value);
+}
+const FLOAT_RE = /^-?([1-9]\d*|0)\.\d+$/;
+function isFloat(value) {
+  return FLOAT_RE.test(value);
+}
+function isNumerical(value) {
+  return isInteger(value) || isFloat(value);
+}
+const DIGIT_RE = /^\d+$/;
+function isDigit(value) {
+  return DIGIT_RE.test(value);
+}
+export {
+  isDigit,
+  isEmail,
+  isFloat,
+  isIDNo,
+  isIPV4,
+  isInteger,
+  isNumerical,
+  isPhone,
+  isURL,
+  regexpEscape
+};
+//# sourceMappingURL=regexp.mjs.map

package/dist/regexp.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"regexp.mjs","sources":["../src/regexp.ts"],"sourcesContent":["const specialRE = /[.*+?^=!:${}()|[\\]/\\\\-]/g;\n\n/**\n * 编码处理正则表达式\n * @example\n * ```js\n * reEscape('/$')\n * // => '\\\\/\\\\$'\n * ```\n * @param {string} string\n * @returns {string}\n */\nexport function regexpEscape(string: string): string {\n  return string.replace(specialRE, '\\\\$&');\n}\n\n// 邮箱\nconst EMAIL_RE = /^\\w+[-+.\\w]*@([a-z\\d-]+\\.)+[a-z]{2,5}$/i;\n/**\n * 判断字符串是否为邮箱格式，不对邮箱真实性做验证，如域名是否正确等\n * @param {string} value\n * @returns {boolean}\n */\nexport function isEmail(value: string): boolean {\n  return EMAIL_RE.test(value);\n}\n\n// 手机号码\nconst PHONE_RE = /^1\\d{10}$/;\n/**\n * 判断字符串是否为宽松手机格式，即首位为 1 的 11 位数字都属于手机号\n * @param {string} value\n * @returns {boolean}\n */\nexport function isPhone(value: string): boolean {\n  return PHONE_RE.test(value);\n}\n\n// 身份证号码\n// http://www.stats.gov.cn/tjsj/tjbz/xzqhdm/\n// [\"北京市\", \"天津市\", \"河北省\", \"山西省\", \"内蒙古自治区\",\n// \"辽宁省\", \"吉林省\", \"黑龙江省\",\n// \"上海市\", \"江苏省\", \"浙江省\", \"安徽省\", \"福建省\", \"江西省\", \"山东省\",\n// \"河南省\", \"湖北省\", \"湖南省\", \"广东省\", \"广西壮族自治区\", \"海南省\",\n// \"重庆市\", \"四川省\", \"贵州省\", \"云南省\", \"西藏自治区\",\n// \"陕西省\", \"甘肃省\", \"青海省\",\"宁夏回族自治区\", \"新疆维吾尔自治区\",\n// \"台湾省\",\n// \"香港特别行政区\", \"澳门特别行政区\"]\n// [\"11\", \"12\", \"13\", \"14\", \"15\",\n// \"21\", \"22\", \"23\",\n// \"31\", \"32\", \"33\", \"34\", \"35\", \"36\", \"37\",\n// \"41\", \"42\", \"43\", \"44\", \"45\", \"46\",\n// \"50\", \"51\", \"52\", \"53\", \"54\",\n// \"61\", \"62\", \"63\", \"64\", \"65\",\n// \"71\",\n// \"81\", \"82\"]\n// 91 国外\nconst IDNO_RE =\n  /^(1[1-5]|2[1-3]|3[1-7]|4[1-6]|5[0-4]|6[1-5]|7[1]|8[1-2]|9[1])\\d{4}(18|19|20)\\d{2}[01]\\d[0123]\\d{4}[\\dxX]$/;\n/**\n * 判断字符串是否为身份证号码格式\n * @param {string} value\n * @returns {boolean}\n */\nexport function isIDNo(value: string): boolean {\n  const isSameFormat = IDNO_RE.test(value);\n\n  if (!isSameFormat) return false;\n\n  const year = Number(value.slice(6, 10));\n  const month = Number(value.slice(10, 12));\n  const date = Number(value.slice(12, 14));\n  const d = new Date(year, month - 1, date);\n  const isSameDate = d.getFullYear() === year && d.getMonth() + 1 === month && d.getDate() === date;\n\n  if (!isSameDate) return false;\n\n  // 将身份证号码前面的17位数分别乘以不同的系数；\n  // 从第一位到第十七位的系数分别为：7－9－10－5－8－4－2－1－6－3－7－9－10－5－8－4－2\n  // 将这17位数字和系数相乘的结果相加；\n  // 用加出来和除以11，看余数是多少；\n  // 余数只可能有0－1－2－3－4－5－6－7－8－9－10这11个数字；\n  // 其分别对应的最后一位身份证的号码为1－0－X－9－8－7－6－5－4－3－2\n  // 通过上面得知如果余数是2，就会在身份证的第18位数字上出现罗马数字的Ⅹ。如果余数是10，身份证的最后一位号码就是2。\n  const coefficientList = [7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2];\n  const residueList = ['1', '0', 'X', '9', '8', '7', '6', '5', '4', '3', '2'];\n  let sum = 0;\n\n  for (let start = 0; start < 17; start++) {\n    sum += Number(value.slice(start, start + 1)) * coefficientList[start];\n  }\n\n  return residueList[sum % 11] === value.slice(-1);\n}\n\n// url\nconst URL_RE =\n  /^https?:\\/\\/(([a-z\\d-]+\\.)+[a-z]{2,5}|(\\d{1,3}\\.){3}\\d{1,3})(:[1-9]\\d{0,4})?(\\/|\\/[\\w#!:.?+=&%@'/()-]+)?$/i;\n/**\n * 判断字符串是否为 url 格式，仅支持 http 协议，支持域名或者 ipV4\n * @param {string} value\n * @returns {boolean}\n */\nexport function isURL(value: string): boolean {\n  return URL_RE.test(value);\n}\n\n// ipv4\nconst IPV4_RE = /^(?:(?:\\d|[1-9]\\d|1\\d\\d|2[0-4]\\d|25[0-5])\\.){3}(?:\\d|[1-9]\\d|1\\d\\d|2[0-4]\\d|25[0-5])$/;\n/**\n * 判断字符串是否为 IPV4 格式，不对 ip 真实性做验证\n * @param {string} value\n * @returns {boolean}\n */\nexport function isIPV4(value: string): boolean {\n  return IPV4_RE.test(value);\n}\n\nconst INTEGER_RE = /^(-?[1-9]\\d*|0)$/;\n/**\n * 判断字符串是否为整数（自然数），即 ...,-3,-2,-1,0,1,2,3,...\n * @param {string} value\n * @returns {boolean}\n */\nexport function isInteger(value: string): boolean {\n  return INTEGER_RE.test(value);\n}\n\nconst FLOAT_RE = /^-?([1-9]\\d*|0)\\.\\d+$/;\n/**\n * 判断字符串是否为浮点数，即必须有小数点的有理数\n * @param {string} value\n * @returns {boolean}\n */\nexport function isFloat(value: string): boolean {\n  return FLOAT_RE.test(value);\n}\n\n/**\n * 判断字符串是否为正确数值，包括整数和浮点数\n * @param {string} value\n * @returns {boolean}\n */\nexport function isNumerical(value: string): boolean {\n  return isInteger(value) || isFloat(value);\n}\n\nconst DIGIT_RE = /^\\d+$/;\n/**\n * 判断字符串是否为数字，例如六位数字短信验证码（093031）\n * @param {string} value\n * @returns {boolean}\n */\nexport function isDigit(value: string): boolean {\n  return DIGIT_RE.test(value);\n}\n"],"names":[],"mappings":"AAAA,MAAM,YAAY;AAYX,SAAS,aAAa,QAAwB;AAC5C,SAAA,OAAO,QAAQ,WAAW,MAAM;AACzC;AAGA,MAAM,WAAW;AAMV,SAAS,QAAQ,OAAwB;AACvC,SAAA,SAAS,KAAK,KAAK;AAC5B;AAGA,MAAM,WAAW;AAMV,SAAS,QAAQ,OAAwB;AACvC,SAAA,SAAS,KAAK,KAAK;AAC5B;AAqBA,MAAM,UACJ;AAMK,SAAS,OAAO,OAAwB;AACvC,QAAA,eAAe,QAAQ,KAAK,KAAK;AAEnC,MAAA,CAAC,aAAqB,QAAA;AAE1B,QAAM,OAAO,OAAO,MAAM,MAAM,GAAG,EAAE,CAAC;AACtC,QAAM,QAAQ,OAAO,MAAM,MAAM,IAAI,EAAE,CAAC;AACxC,QAAM,OAAO,OAAO,MAAM,MAAM,IAAI,EAAE,CAAC;AACvC,QAAM,IAAI,IAAI,KAAK,MAAM,QAAQ,GAAG,IAAI;AACxC,QAAM,aAAa,EAAE,YAAY,MAAM,QAAQ,EAAE,SAAS,IAAI,MAAM,SAAS,EAAE,QAAc,MAAA;AAEzF,MAAA,CAAC,WAAmB,QAAA;AASxB,QAAM,kBAAkB,CAAC,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,CAAC;AAC5E,QAAM,cAAc,CAAC,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,GAAG;AAC1E,MAAI,MAAM;AAEV,WAAS,QAAQ,GAAG,QAAQ,IAAI,SAAS;AAChC,WAAA,OAAO,MAAM,MAAM,OAAO,QAAQ,CAAC,CAAC,IAAI,gBAAgB,KAAK;AAAA,EAAA;AAGtE,SAAO,YAAY,MAAM,EAAE,MAAM,MAAM,MAAM,EAAE;AACjD;AAGA,MAAM,SACJ;AAMK,SAAS,MAAM,OAAwB;AACrC,SAAA,OAAO,KAAK,KAAK;AAC1B;AAGA,MAAM,UAAU;AAMT,SAAS,OAAO,OAAwB;AACtC,SAAA,QAAQ,KAAK,KAAK;AAC3B;AAEA,MAAM,aAAa;AAMZ,SAAS,UAAU,OAAwB;AACzC,SAAA,WAAW,KAAK,KAAK;AAC9B;AAEA,MAAM,WAAW;AAMV,SAAS,QAAQ,OAAwB;AACvC,SAAA,SAAS,KAAK,KAAK;AAC5B;AAOO,SAAS,YAAY,OAAwB;AAClD,SAAO,UAAU,KAAK,KAAK,QAAQ,KAAK;AAC1C;AAEA,MAAM,WAAW;AAMV,SAAS,QAAQ,OAAwB;AACvC,SAAA,SAAS,KAAK,KAAK;AAC5B;"}

package/dist/string.cjs

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const number = require("./string2.cjs");
+require("./type.cjs");
+exports.STRING_ARABIC_NUMERALS = number.STRING_ARABIC_NUMERALS;
+exports.STRING_DICT = number.STRING_DICT;
+exports.STRING_HEXADECIMALS = number.STRING_HEXADECIMALS;
+exports.STRING_LOWERCASE_ALPHA = number.STRING_LOWERCASE_ALPHA;
+exports.STRING_UPPERCASE_ALPHA = number.STRING_UPPERCASE_ALPHA;
+exports.randomString = number.randomString;
+exports.randomUUID4 = number.randomUUID4;
+exports.stringCamelCase = number.stringCamelCase;
+exports.stringFormat = number.stringFormat;
+exports.stringKebabCase = number.stringKebabCase;
+exports.stringify = number.stringify;
+//# sourceMappingURL=string.cjs.map

package/dist/string.cjs.map

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

package/dist/string.d.ts

@@ -0,0 +1,80 @@
+export declare const STRING_ARABIC_NUMERALS = "0123456789";
+export declare const STRING_HEXADECIMALS = "0123456789abcdef";
+export declare const STRING_LOWERCASE_ALPHA = "abcdefghijklmnopqrstuvwxyz";
+export declare const STRING_UPPERCASE_ALPHA = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
+export declare const STRING_DICT = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
+/**
+ * 将字符串转换为驼峰格式
+ * @param {string} string - 要转换的字符串
+ * @param {boolean} [bigger] - 是否大写第一个字母，默认为 false
+ * @returns {string} - 转换后的驼峰格式字符串
+ */
+export declare function stringCamelCase(string: string, bigger?: boolean): string;
+/**
+ * 将字符串转换为连字格式
+ * @param {string} string - 要转换的字符串
+ * @param {string} [separator] - 分隔符，默认是 "-"（短横线）
+ * @returns {string} - 转换后的连字格式字符串
+ */
+export declare function stringKebabCase(string: string, separator?: string): string;
+/**
+ * 生成随机字符串
+ * @param {number} length - 生成的随机字符串长度
+ * @param {string} [dict] - 用于生成随机字符串的字符字典，默认为数字、小写字母和大写字母的组合
+ * @returns {string} - 生成的随机字符串
+ * @example
+ * randomString(10); // 生成一个长度为 10 的随机字符串
+ * randomString(8, 'ABCDEF'); // 生成一个长度为 8 的随机字符串，仅包含字符 'ABCDEF'
+ */
+export declare function randomString(length: number, dict?: string): string;
+/**
+ * 简单的模板引擎，类似于 Python 的 `.format()` 方法
+ * 支持通过索引或对象/名称的方式传递变量
+ * 当使用对象/名称方式时，可以传递一个回退值作为第三个参数
+ *
+ * @category 字符串
+ * @example
+ * ```
+ * // 索引方式
+ * const result = stringFormat(
+ *   '你好 {0}！我的名字是 {1}。',
+ *   '张三',
+ *   '李四'
+ * ); // 你好 张三！我的名字是 李四。
+ * ```
+ *
+ * @example
+ * ```
+ * // 对象方式
+ * const result = stringFormat(
+ *   '{greet}！我的名字是 {name}。',
+ *   { greet: '你好', name: '王五' }
+ * ); // 你好！我的名字是 王五。
+ * ```
+ *
+ * @example
+ * ```
+ * // 带回退值的对象方式
+ * const result = stringFormat(
+ *   '{greet}！我的名字是 {name}。',
+ *   { greet: '你好' }, // name 未传递，因此会使用回退值
+ *   '未知'
+ * ); // 你好！我的名字是 未知。
+ * ```
+ */
+export declare function stringFormat(str: string, object: Record<string | number, unknown>, fallback?: string | ((key: string) => string)): string;
+export declare function stringFormat(str: string, ...args: (string | number | bigint | undefined | null)[]): string;
+/**
+ * 生成符合 [RFC 4122](https://www.ietf.org/rfc/rfc4122.txt) 版本 4 的 UUID 字符串
+ * @returns {string} - 生成的 UUID 字符串
+ * @example
+ * const uuid = randomUUID4();
+ * console.log(uuid); // 输出类似 '123e4567-e89b-12d3-a456-426614174000' 的 UUID 字符串
+ */
+export declare function randomUUID4(): string;
+/**
+ * 将值转换为字符串，若值为 null 或 undefined 则返回空字符串
+ * @param {unknown} value - 需要转换的值
+ * @returns {string} 转换后的字符串结果
+ */
+export declare function stringify(value: unknown): string;

package/dist/string.mjs

@@ -0,0 +1,16 @@
+import { g, S, h, i, j, m, o, k, s, l, p } from "./string2.mjs";
+import "./type.mjs";
+export {
+  g as STRING_ARABIC_NUMERALS,
+  S as STRING_DICT,
+  h as STRING_HEXADECIMALS,
+  i as STRING_LOWERCASE_ALPHA,
+  j as STRING_UPPERCASE_ALPHA,
+  m as randomString,
+  o as randomUUID4,
+  k as stringCamelCase,
+  s as stringFormat,
+  l as stringKebabCase,
+  p as stringify
+};
+//# sourceMappingURL=string.mjs.map

package/dist/string.mjs.map

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