@cloudcome/utils-core 1.21.0 → 1.23.0

package/dist/type.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"type.mjs","names":[],"sources":["../src/type.ts"],"sourcesContent":["import type { AnyArray, AnyAsyncFunction, AnyFunction, AnyObject } from './types';\n\n/**\n * 获取未知类型的类型名称\n * @param unknown - 未知类型的值\n * @returns 类型名称字符串\n */\nexport function typeIs(\n  unknown: unknown,\n):\n  | 'string'\n  | 'number'\n  | 'boolean'\n  | 'object'\n  | 'array'\n  | 'function'\n  | 'null'\n  | 'undefined'\n  | 'symbol'\n  | 'bigint'\n  | 'error'\n  | 'promise'\n  | string {\n  return Object.prototype.toString.call(unknown).slice(8, -1).toLowerCase();\n}\n\n/**\n * 检查值是否为字符串\n * @param unknown - 未知类型的值\n * @returns 如果值为字符串则返回 true，否则返回 false\n */\nexport function isString(unknown: unknown): unknown is string {\n  return typeof unknown === 'string';\n}\n\n/**\n * 检查值是否为布尔值\n * @param unknown - 未知类型的值\n * @returns 如果值为布尔值则返回 true，否则返回 false\n */\nexport function isBoolean(unknown: unknown): unknown is boolean {\n  return typeof unknown === 'boolean';\n}\n\n/**\n * 检查值是否为符号\n * @param unknown - 未知类型的值\n * @returns 如果值为符号则返回 true，否则返回 false\n */\nexport function isSymbol(unknown: unknown): unknown is symbol {\n  return typeof unknown === 'symbol';\n}\n\n/**\n * 检查值是否为大整数\n * @param unknown - 未知类型的值\n * @returns 如果值为大整数则返回 true，否则返回 false\n */\nexport function isBigInt(unknown: unknown): unknown is bigint {\n  return typeof unknown === 'bigint';\n}\n\n/**\n * 检查值是否为数字\n * @param unknown - 未知类型的值\n * @returns 如果值为数字且不是 NaN 则返回 true，否则返回 false\n */\nexport function isNumber(unknown: unknown): unknown is number {\n  return typeof unknown === 'number' && !Number.isNaN(unknown);\n}\n\n/**\n * 检查值是否为 undefined\n * @param unknown - 未知类型的值\n * @returns 如果值为 undefined 则返回 true，否则返回 false\n */\nexport function isUndefined(unknown: unknown): unknown is undefined {\n  return typeof unknown === 'undefined';\n}\n\n/**\n * 检查值是否为 void\n * @param unknown - 未知类型的值\n * @returns 如果值为 undefined 则返回 true，否则返回 false\n */\n// biome-ignore lint/suspicious/noConfusingVoidType: 必须使用 void 类型断言\nexport function isVoid(unknown: unknown): unknown is void {\n  return isUndefined(unknown);\n}\n\n/**\n * 永不执行，用于 switch-case/if-else 类型断言\n * @param unknown - 永远不会执行的值\n */\nexport function isNever(_unknown: never) {\n  //\n}\n\n/**\n * 检查值是否为 null\n * @param unknown - 未知类型的值\n * @returns 如果值为 null 则返回 true，否则返回 false\n */\nexport function isNull(unknown: unknown): unknown is null {\n  return unknown === null;\n}\n\n/**\n * 检查值是否为 nullish（null 或 undefined 或 void）\n * @param unknown - 未知类型的值\n * @returns 如果值为 null 或 undefined 或 void 则返回 true，否则返回 false\n */\nexport function isNullish(unknown: unknown): unknown is null | undefined | undefined {\n  return isNull(unknown) || isUndefined(unknown) || isVoid(unknown);\n}\n\n/**\n * 检查值是否为原始类型（null 或 非对象）\n * @param unknown - 未知类型的值\n * @returns 如果值为原始类型则返回 true，否则返回 false\n */\nexport function isPrimitive(\n  unknown: unknown,\n): unknown is string | number | boolean | symbol | bigint | null | undefined {\n  return isNull(unknown) || !(typeof unknown === 'object' || typeof unknown === 'function');\n}\n\n/**\n * 检查值是否为对象，但要注意，此时的对象类型是包含了数组和函数\n * @param unknown - 未知类型的值\n * @returns 如果值为对象则返回 true，否则返回 false\n */\nexport function isObject(unknown: unknown): unknown is AnyObject {\n  return typeIs(unknown) === 'object';\n}\n\n/**\n * 检查值是否为数组\n * @param unknown - 未知类型的值\n * @returns 如果值为数组则返回 true，否则返回 false\n */\nexport function isArray(unknown: unknown): unknown is AnyArray {\n  return Array.isArray(unknown);\n}\n\n/**\n * 检查值是否为函数\n * @param unknown - 未知类型的值\n * @returns 如果值为函数则返回 true，否则返回 false\n */\nexport function isFunction(unknown: unknown): unknown is AnyFunction {\n  return typeof unknown === 'function';\n}\n\n/**\n * 检查值是否为异步函数\n * @param unknown - 需要检查的值\n * @returns 如果值为异步函数则返回 true，否则返回 false\n * @example\n * ```typescript\n * async function example() {}\n *\n * isAsyncFunction(example); // true\n * isAsyncFunction(() => {}); // false\n * ```\n */\nexport function isAsyncFunction(unknown: unknown): unknown is AnyAsyncFunction {\n  return isFunction(unknown) && unknown.constructor.name === 'AsyncFunction';\n}\n\n/**\n * 检查值是否为 Error 类型\n * @param unknown - 未知类型的值\n * @returns 如果值为 Error 类型则返回 true，否则返回 false\n */\nexport function isError(unknown: unknown): unknown is Error {\n  return unknown instanceof Error;\n}\n\n/**\n * 检查值是否为 Promise 类型\n * @param unknown - 未知类型的值\n * @returns 如果值为 Promise 类型则返回 true，否则返回 false\n */\nexport function isPromise<T>(unknown: unknown): unknown is Promise<T> {\n  return typeIs(unknown) === 'promise';\n}\n\n/**\n * 检查值是否为 Date 类型\n * @param unknown - 未知类型的值\n * @returns 如果值为 Date 类型则返回 true，否则返回 false\n */\nexport function isDate(unknown: unknown): unknown is Date {\n  return unknown instanceof Date;\n}\n"],"mappings":";;;;;;AAOA,SAAgB,OACd,SAcS;CACT,OAAO,OAAO,UAAU,SAAS,KAAK,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC,aAAa;;;;;;;AAQ3E,SAAgB,SAAS,SAAqC;CAC5D,OAAO,OAAO,YAAY;;;;;;;AAQ5B,SAAgB,UAAU,SAAsC;CAC9D,OAAO,OAAO,YAAY;;;;;;;AAQ5B,SAAgB,SAAS,SAAqC;CAC5D,OAAO,OAAO,YAAY;;;;;;;AAQ5B,SAAgB,SAAS,SAAqC;CAC5D,OAAO,OAAO,YAAY;;;;;;;AAQ5B,SAAgB,SAAS,SAAqC;CAC5D,OAAO,OAAO,YAAY,YAAY,CAAC,OAAO,MAAM,QAAQ;;;;;;;AAQ9D,SAAgB,YAAY,SAAwC;CAClE,OAAO,OAAO,YAAY;;;;;;;AAS5B,SAAgB,OAAO,SAAmC;CACxD,OAAO,YAAY,QAAQ;;;;;;AAO7B,SAAgB,QAAQ,UAAiB;;;;;;AASzC,SAAgB,OAAO,SAAmC;CACxD,OAAO,YAAY;;;;;;;AAQrB,SAAgB,UAAU,SAA2D;CACnF,OAAO,OAAO,QAAQ,IAAI,YAAY,QAAQ,IAAI,OAAO,QAAQ;;;;;;;AAQnE,SAAgB,YACd,SAC2E;CAC3E,OAAO,OAAO,QAAQ,IAAI,EAAE,OAAO,YAAY,YAAY,OAAO,YAAY;;;;;;;AAQhF,SAAgB,SAAS,SAAwC;CAC/D,OAAO,OAAO,QAAQ,KAAK;;;;;;;AAQ7B,SAAgB,QAAQ,SAAuC;CAC7D,OAAO,MAAM,QAAQ,QAAQ;;;;;;;AAQ/B,SAAgB,WAAW,SAA0C;CACnE,OAAO,OAAO,YAAY;;;;;;;;;;;;;;AAe5B,SAAgB,gBAAgB,SAA+C;CAC7E,OAAO,WAAW,QAAQ,IAAI,QAAQ,YAAY,SAAS;;;;;;;AAQ7D,SAAgB,QAAQ,SAAoC;CAC1D,OAAO,mBAAmB;;;;;;;AAQ5B,SAAgB,UAAa,SAAyC;CACpE,OAAO,OAAO,QAAQ,KAAK;;;;;;;AAQ7B,SAAgB,OAAO,SAAmC;CACxD,OAAO,mBAAmB"}
+{"version":3,"file":"type.mjs","names":[],"sources":["../src/type.ts"],"sourcesContent":["import type { AnyArray, AnyAsyncFunction, AnyFunction, AnyObject } from './types';\n\n/**\n * 获取未知类型的类型名称\n * @param unknown - 未知类型的值\n * @returns 类型名称字符串\n */\nexport function typeIs(\n  unknown: unknown,\n):\n  | 'string'\n  | 'number'\n  | 'boolean'\n  | 'object'\n  | 'array'\n  | 'function'\n  | 'null'\n  | 'undefined'\n  | 'symbol'\n  | 'bigint'\n  | 'error'\n  | 'promise'\n  | string {\n  return Object.prototype.toString.call(unknown).slice(8, -1).toLowerCase();\n}\n\n/**\n * 检查值是否为字符串\n * @param unknown - 未知类型的值\n * @returns 如果值为字符串则返回 true，否则返回 false\n */\nexport function isString(unknown: unknown): unknown is string {\n  return typeof unknown === 'string';\n}\n\n/**\n * 检查值是否为布尔值\n * @param unknown - 未知类型的值\n * @returns 如果值为布尔值则返回 true，否则返回 false\n */\nexport function isBoolean(unknown: unknown): unknown is boolean {\n  return typeof unknown === 'boolean';\n}\n\n/**\n * 检查值是否为符号\n * @param unknown - 未知类型的值\n * @returns 如果值为符号则返回 true，否则返回 false\n */\nexport function isSymbol(unknown: unknown): unknown is symbol {\n  return typeof unknown === 'symbol';\n}\n\n/**\n * 检查值是否为大整数\n * @param unknown - 未知类型的值\n * @returns 如果值为大整数则返回 true，否则返回 false\n */\nexport function isBigInt(unknown: unknown): unknown is bigint {\n  return typeof unknown === 'bigint';\n}\n\n/**\n * 检查值是否为数字\n * @param unknown - 未知类型的值\n * @returns 如果值为数字且不是 NaN 则返回 true，否则返回 false\n */\nexport function isNumber(unknown: unknown): unknown is number {\n  return typeof unknown === 'number' && !Number.isNaN(unknown);\n}\n\n/**\n * 检查值是否为 undefined\n * @param unknown - 未知类型的值\n * @returns 如果值为 undefined 则返回 true，否则返回 false\n */\nexport function isUndefined(unknown: unknown): unknown is undefined {\n  return typeof unknown === 'undefined';\n}\n\n/**\n * 检查值是否为 void\n * @param unknown - 未知类型的值\n * @returns 如果值为 undefined 则返回 true，否则返回 false\n */\n// biome-ignore lint/suspicious/noConfusingVoidType: 必须使用 void 类型断言\nexport function isVoid(unknown: unknown): unknown is void {\n  return isUndefined(unknown);\n}\n\n/**\n * 永不执行，用于 switch-case/if-else 类型断言\n * @param unknown - 永远不会执行的值\n */\nexport function isNever(_unknown: never) {\n  //\n}\n\n/**\n * 检查值是否为 null\n * @param unknown - 未知类型的值\n * @returns 如果值为 null 则返回 true，否则返回 false\n */\nexport function isNull(unknown: unknown): unknown is null {\n  return unknown === null;\n}\n\n/**\n * 检查值是否为 nullish（null 或 undefined 或 void）\n * @param unknown - 未知类型的值\n * @returns 如果值为 null 或 undefined 或 void 则返回 true，否则返回 false\n */\nexport function isNullish(unknown: unknown): unknown is null | undefined | undefined {\n  return isNull(unknown) || isUndefined(unknown) || isVoid(unknown);\n}\n\n/**\n * 检查值是否为原始类型（null 或 非对象）\n * @param unknown - 未知类型的值\n * @returns 如果值为原始类型则返回 true，否则返回 false\n */\nexport function isPrimitive(\n  unknown: unknown,\n): unknown is string | number | boolean | symbol | bigint | null | undefined {\n  return isNull(unknown) || !(typeof unknown === 'object' || typeof unknown === 'function');\n}\n\n/**\n * 检查值是否为对象，但要注意，此时的对象类型是包含了数组和函数\n * @param unknown - 未知类型的值\n * @returns 如果值为对象则返回 true，否则返回 false\n */\nexport function isObject(unknown: unknown): unknown is AnyObject {\n  return typeIs(unknown) === 'object';\n}\n\n/**\n * 检查值是否为数组\n * @param unknown - 未知类型的值\n * @returns 如果值为数组则返回 true，否则返回 false\n */\nexport function isArray(unknown: unknown): unknown is AnyArray {\n  return Array.isArray(unknown);\n}\n\n/**\n * 检查值是否为函数\n * @param unknown - 未知类型的值\n * @returns 如果值为函数则返回 true，否则返回 false\n */\nexport function isFunction(unknown: unknown): unknown is AnyFunction {\n  return typeof unknown === 'function';\n}\n\n/**\n * 检查值是否为异步函数\n * @param unknown - 需要检查的值\n * @returns 如果值为异步函数则返回 true，否则返回 false\n * @example\n * ```typescript\n * async function example() {}\n *\n * isAsyncFunction(example); // true\n * isAsyncFunction(() => {}); // false\n * ```\n */\nexport function isAsyncFunction(unknown: unknown): unknown is AnyAsyncFunction {\n  return isFunction(unknown) && unknown.constructor.name === 'AsyncFunction';\n}\n\n/**\n * 检查值是否为 Error 类型\n * @param unknown - 未知类型的值\n * @returns 如果值为 Error 类型则返回 true，否则返回 false\n */\nexport function isError(unknown: unknown): unknown is Error {\n  return unknown instanceof Error;\n}\n\n/**\n * 检查值是否为 Promise 类型\n * @param unknown - 未知类型的值\n * @returns 如果值为 Promise 类型则返回 true，否则返回 false\n */\nexport function isPromise<T>(unknown: unknown): unknown is Promise<T> {\n  return typeIs(unknown) === 'promise';\n}\n\n/**\n * 检查值是否为 Date 类型\n * @param unknown - 未知类型的值\n * @returns 如果值为 Date 类型则返回 true，否则返回 false\n */\nexport function isDate(unknown: unknown): unknown is Date {\n  return unknown instanceof Date;\n}\n"],"mappings":";;;;;;AAOA,SAAgB,OACd,SAcS;CACT,OAAO,OAAO,UAAU,SAAS,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,EAAE,YAAY;AAC1E;;;;;;AAOA,SAAgB,SAAS,SAAqC;CAC5D,OAAO,OAAO,YAAY;AAC5B;;;;;;AAOA,SAAgB,UAAU,SAAsC;CAC9D,OAAO,OAAO,YAAY;AAC5B;;;;;;AAOA,SAAgB,SAAS,SAAqC;CAC5D,OAAO,OAAO,YAAY;AAC5B;;;;;;AAOA,SAAgB,SAAS,SAAqC;CAC5D,OAAO,OAAO,YAAY;AAC5B;;;;;;AAOA,SAAgB,SAAS,SAAqC;CAC5D,OAAO,OAAO,YAAY,YAAY,CAAC,OAAO,MAAM,OAAO;AAC7D;;;;;;AAOA,SAAgB,YAAY,SAAwC;CAClE,OAAO,OAAO,YAAY;AAC5B;;;;;;AAQA,SAAgB,OAAO,SAAmC;CACxD,OAAO,YAAY,OAAO;AAC5B;;;;;AAMA,SAAgB,QAAQ,UAAiB,CAEzC;;;;;;AAOA,SAAgB,OAAO,SAAmC;CACxD,OAAO,YAAY;AACrB;;;;;;AAOA,SAAgB,UAAU,SAA2D;CACnF,OAAO,OAAO,OAAO,KAAK,YAAY,OAAO,KAAK,OAAO,OAAO;AAClE;;;;;;AAOA,SAAgB,YACd,SAC2E;CAC3E,OAAO,OAAO,OAAO,KAAK,EAAE,OAAO,YAAY,YAAY,OAAO,YAAY;AAChF;;;;;;AAOA,SAAgB,SAAS,SAAwC;CAC/D,OAAO,OAAO,OAAO,MAAM;AAC7B;;;;;;AAOA,SAAgB,QAAQ,SAAuC;CAC7D,OAAO,MAAM,QAAQ,OAAO;AAC9B;;;;;;AAOA,SAAgB,WAAW,SAA0C;CACnE,OAAO,OAAO,YAAY;AAC5B;;;;;;;;;;;;;AAcA,SAAgB,gBAAgB,SAA+C;CAC7E,OAAO,WAAW,OAAO,KAAK,QAAQ,YAAY,SAAS;AAC7D;;;;;;AAOA,SAAgB,QAAQ,SAAoC;CAC1D,OAAO,mBAAmB;AAC5B;;;;;;AAOA,SAAgB,UAAa,SAAyC;CACpE,OAAO,OAAO,OAAO,MAAM;AAC7B;;;;;;AAOA,SAAgB,OAAO,SAAmC;CACxD,OAAO,mBAAmB;AAC5B"}

package/dist/unique.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"unique.cjs","names":[],"sources":["../src/unique.ts"],"sourcesContent":["import { numberConvert, randomNumber } from './number';\nimport { STRING_DICT } from './string';\nimport { isNumber, isString } from './type';\n\nlet lastTimestamp = 0;\nlet lastSafePadding = 0;\n\n/**\n * 生成一个唯一的 BigInt 值。\n *\n * @param randomLength - 可选参数，指定随机部分的长度，默认为 0。\n *                        如果大于 0，则会在结果中附加指定长度的随机数。\n * @returns 返回一个唯一的 BigInt 值，包含时间戳、随机部分（如果有）以及递增的填充值。\n */\nexport function uniqueBigInt(randomLength = 0): bigint {\n  const now = Date.now();\n\n  if (now !== lastTimestamp) {\n    lastTimestamp = now;\n    lastSafePadding = 0;\n  }\n\n  let randomPart = '';\n\n  if (randomLength > 0) {\n    const randomMin = 10 ** (randomLength - 1);\n    const randomMax = 10 ** randomLength - 1;\n    randomPart = String(randomNumber(randomMin, randomMax));\n  }\n\n  return BigInt(randomPart + lastSafePadding++ + now);\n}\n\nconst _randomChar = (dict: string): string => {\n  const poolIndex = randomNumber(0, dict.length - 1);\n\n  return dict[poolIndex];\n};\n\n/**\n * 生成一个唯一的字符串。\n *\n * @param minLength - 可选参数，指定生成字符串的最小长度。\n *                 如果未提供或为字符串类型，则使用默认长度。\n * @param dict - 可选参数，指定生成字符串时使用的字符集。\n *               如果未提供，则使用默认字符集 `STRING_DICT`。\n * @returns 返回一个唯一的字符串，包含时间戳、随机部分（如果有）以及递增的填充值。\n *          如果指定了 `length`，则返回值的长度将被调整到指定长度。\n */\nexport function uniqueString(minLength: number, dict: string): string;\nexport function uniqueString(minLength: number): string;\nexport function uniqueString(dict: string): string;\nexport function uniqueString(): string;\nexport function uniqueString(minLength?: number | string, dict?: string) {\n  let finalLength = 0;\n  let finalDict = STRING_DICT;\n\n  if (isString(dict)) {\n    finalLength = minLength as number;\n    finalDict = dict;\n  } else if (isNumber(minLength)) {\n    finalLength = minLength;\n  } else if (isString(minLength)) {\n    finalDict = minLength;\n  }\n\n  let uniqueString = numberConvert(uniqueBigInt(), finalDict);\n  let insertLength = finalLength - uniqueString.length;\n\n  if (insertLength <= 0) return uniqueString;\n\n  while (insertLength--) {\n    uniqueString += _randomChar(finalDict);\n  }\n\n  return uniqueString;\n}\n"],"mappings":";;;;AAIA,IAAI,gBAAgB;AACpB,IAAI,kBAAkB;;;;;;;;AAStB,SAAgB,aAAa,eAAe,GAAW;CACrD,MAAM,MAAM,KAAK,KAAK;CAEtB,IAAI,QAAQ,eAAe;EACzB,gBAAgB;EAChB,kBAAkB;;CAGpB,IAAI,aAAa;CAEjB,IAAI,eAAe,GAAG;EACpB,MAAM,YAAY,OAAO,eAAe;EACxC,MAAM,YAAY,MAAM,eAAe;EACvC,aAAa,OAAO,eAAA,aAAa,WAAW,UAAU,CAAC;;CAGzD,OAAO,OAAO,aAAa,oBAAoB,IAAI;;AAGrD,IAAM,eAAe,SAAyB;CAG5C,OAAO,KAFW,eAAA,aAAa,GAAG,KAAK,SAAS,EAEpC;;AAiBd,SAAgB,aAAa,WAA6B,MAAe;CACvE,IAAI,cAAc;CAClB,IAAI,YAAY,eAAA;CAEhB,IAAI,aAAA,SAAS,KAAK,EAAE;EAClB,cAAc;EACd,YAAY;QACP,IAAI,aAAA,SAAS,UAAU,EAC5B,cAAc;MACT,IAAI,aAAA,SAAS,UAAU,EAC5B,YAAY;CAGd,IAAI,eAAe,eAAA,cAAc,cAAc,EAAE,UAAU;CAC3D,IAAI,eAAe,cAAc,aAAa;CAE9C,IAAI,gBAAgB,GAAG,OAAO;CAE9B,OAAO,gBACL,gBAAgB,YAAY,UAAU;CAGxC,OAAO"}
+{"version":3,"file":"unique.cjs","names":[],"sources":["../src/unique.ts"],"sourcesContent":["import { numberConvert, randomNumber } from './number';\nimport { STRING_DICT } from './string';\nimport { isNumber, isString } from './type';\n\nlet lastTimestamp = 0;\nlet lastSafePadding = 0;\n\n/**\n * 生成一个唯一的 BigInt 值。\n *\n * @param randomLength - 可选参数，指定随机部分的长度，默认为 0。\n *                        如果大于 0，则会在结果中附加指定长度的随机数。\n * @returns 返回一个唯一的 BigInt 值，包含时间戳、随机部分（如果有）以及递增的填充值。\n */\nexport function uniqueBigInt(randomLength = 0): bigint {\n  const now = Date.now();\n\n  if (now !== lastTimestamp) {\n    lastTimestamp = now;\n    lastSafePadding = 0;\n  }\n\n  let randomPart = '';\n\n  if (randomLength > 0) {\n    const randomMin = 10 ** (randomLength - 1);\n    const randomMax = 10 ** randomLength - 1;\n    randomPart = String(randomNumber(randomMin, randomMax));\n  }\n\n  return BigInt(randomPart + lastSafePadding++ + now);\n}\n\nconst _randomChar = (dict: string): string => {\n  const poolIndex = randomNumber(0, dict.length - 1);\n\n  return dict[poolIndex];\n};\n\n/**\n * 生成一个唯一的字符串。\n *\n * @param minLength - 可选参数，指定生成字符串的最小长度。\n *                 如果未提供或为字符串类型，则使用默认长度。\n * @param dict - 可选参数，指定生成字符串时使用的字符集。\n *               如果未提供，则使用默认字符集 `STRING_DICT`。\n * @returns 返回一个唯一的字符串，包含时间戳、随机部分（如果有）以及递增的填充值。\n *          如果指定了 `length`，则返回值的长度将被调整到指定长度。\n */\nexport function uniqueString(minLength: number, dict: string): string;\nexport function uniqueString(minLength: number): string;\nexport function uniqueString(dict: string): string;\nexport function uniqueString(): string;\nexport function uniqueString(minLength?: number | string, dict?: string) {\n  let finalLength = 0;\n  let finalDict = STRING_DICT;\n\n  if (isString(dict)) {\n    finalLength = minLength as number;\n    finalDict = dict;\n  } else if (isNumber(minLength)) {\n    finalLength = minLength;\n  } else if (isString(minLength)) {\n    finalDict = minLength;\n  }\n\n  let uniqueString = numberConvert(uniqueBigInt(), finalDict);\n  let insertLength = finalLength - uniqueString.length;\n\n  if (insertLength <= 0) return uniqueString;\n\n  while (insertLength--) {\n    uniqueString += _randomChar(finalDict);\n  }\n\n  return uniqueString;\n}\n"],"mappings":";;;;AAIA,IAAI,gBAAgB;AACpB,IAAI,kBAAkB;;;;;;;;AAStB,SAAgB,aAAa,eAAe,GAAW;CACrD,MAAM,MAAM,KAAK,IAAI;CAErB,IAAI,QAAQ,eAAe;EACzB,gBAAgB;EAChB,kBAAkB;CACpB;CAEA,IAAI,aAAa;CAEjB,IAAI,eAAe,GAAG;EACpB,MAAM,YAAY,OAAO,eAAe;EACxC,MAAM,YAAY,MAAM,eAAe;EACvC,aAAa,OAAO,eAAA,aAAa,WAAW,SAAS,CAAC;CACxD;CAEA,OAAO,OAAO,aAAa,oBAAoB,GAAG;AACpD;AAEA,IAAM,eAAe,SAAyB;CAG5C,OAAO,KAFW,eAAA,aAAa,GAAG,KAAK,SAAS,CAEpC;AACd;AAgBA,SAAgB,aAAa,WAA6B,MAAe;CACvE,IAAI,cAAc;CAClB,IAAI,YAAY,eAAA;CAEhB,IAAI,aAAA,SAAS,IAAI,GAAG;EAClB,cAAc;EACd,YAAY;CACd,OAAO,IAAI,aAAA,SAAS,SAAS,GAC3B,cAAc;MACT,IAAI,aAAA,SAAS,SAAS,GAC3B,YAAY;CAGd,IAAI,eAAe,eAAA,cAAc,aAAa,GAAG,SAAS;CAC1D,IAAI,eAAe,cAAc,aAAa;CAE9C,IAAI,gBAAgB,GAAG,OAAO;CAE9B,OAAO,gBACL,gBAAgB,YAAY,SAAS;CAGvC,OAAO;AACT"}

package/dist/unique.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"unique.mjs","names":[],"sources":["../src/unique.ts"],"sourcesContent":["import { numberConvert, randomNumber } from './number';\nimport { STRING_DICT } from './string';\nimport { isNumber, isString } from './type';\n\nlet lastTimestamp = 0;\nlet lastSafePadding = 0;\n\n/**\n * 生成一个唯一的 BigInt 值。\n *\n * @param randomLength - 可选参数，指定随机部分的长度，默认为 0。\n *                        如果大于 0，则会在结果中附加指定长度的随机数。\n * @returns 返回一个唯一的 BigInt 值，包含时间戳、随机部分（如果有）以及递增的填充值。\n */\nexport function uniqueBigInt(randomLength = 0): bigint {\n  const now = Date.now();\n\n  if (now !== lastTimestamp) {\n    lastTimestamp = now;\n    lastSafePadding = 0;\n  }\n\n  let randomPart = '';\n\n  if (randomLength > 0) {\n    const randomMin = 10 ** (randomLength - 1);\n    const randomMax = 10 ** randomLength - 1;\n    randomPart = String(randomNumber(randomMin, randomMax));\n  }\n\n  return BigInt(randomPart + lastSafePadding++ + now);\n}\n\nconst _randomChar = (dict: string): string => {\n  const poolIndex = randomNumber(0, dict.length - 1);\n\n  return dict[poolIndex];\n};\n\n/**\n * 生成一个唯一的字符串。\n *\n * @param minLength - 可选参数，指定生成字符串的最小长度。\n *                 如果未提供或为字符串类型，则使用默认长度。\n * @param dict - 可选参数，指定生成字符串时使用的字符集。\n *               如果未提供，则使用默认字符集 `STRING_DICT`。\n * @returns 返回一个唯一的字符串，包含时间戳、随机部分（如果有）以及递增的填充值。\n *          如果指定了 `length`，则返回值的长度将被调整到指定长度。\n */\nexport function uniqueString(minLength: number, dict: string): string;\nexport function uniqueString(minLength: number): string;\nexport function uniqueString(dict: string): string;\nexport function uniqueString(): string;\nexport function uniqueString(minLength?: number | string, dict?: string) {\n  let finalLength = 0;\n  let finalDict = STRING_DICT;\n\n  if (isString(dict)) {\n    finalLength = minLength as number;\n    finalDict = dict;\n  } else if (isNumber(minLength)) {\n    finalLength = minLength;\n  } else if (isString(minLength)) {\n    finalDict = minLength;\n  }\n\n  let uniqueString = numberConvert(uniqueBigInt(), finalDict);\n  let insertLength = finalLength - uniqueString.length;\n\n  if (insertLength <= 0) return uniqueString;\n\n  while (insertLength--) {\n    uniqueString += _randomChar(finalDict);\n  }\n\n  return uniqueString;\n}\n"],"mappings":";;;AAIA,IAAI,gBAAgB;AACpB,IAAI,kBAAkB;;;;;;;;AAStB,SAAgB,aAAa,eAAe,GAAW;CACrD,MAAM,MAAM,KAAK,KAAK;CAEtB,IAAI,QAAQ,eAAe;EACzB,gBAAgB;EAChB,kBAAkB;;CAGpB,IAAI,aAAa;CAEjB,IAAI,eAAe,GAAG;EACpB,MAAM,YAAY,OAAO,eAAe;EACxC,MAAM,YAAY,MAAM,eAAe;EACvC,aAAa,OAAO,aAAa,WAAW,UAAU,CAAC;;CAGzD,OAAO,OAAO,aAAa,oBAAoB,IAAI;;AAGrD,IAAM,eAAe,SAAyB;CAG5C,OAAO,KAFW,aAAa,GAAG,KAAK,SAAS,EAEpC;;AAiBd,SAAgB,aAAa,WAA6B,MAAe;CACvE,IAAI,cAAc;CAClB,IAAI,YAAY;CAEhB,IAAI,SAAS,KAAK,EAAE;EAClB,cAAc;EACd,YAAY;QACP,IAAI,SAAS,UAAU,EAC5B,cAAc;MACT,IAAI,SAAS,UAAU,EAC5B,YAAY;CAGd,IAAI,eAAe,cAAc,cAAc,EAAE,UAAU;CAC3D,IAAI,eAAe,cAAc,aAAa;CAE9C,IAAI,gBAAgB,GAAG,OAAO;CAE9B,OAAO,gBACL,gBAAgB,YAAY,UAAU;CAGxC,OAAO"}
+{"version":3,"file":"unique.mjs","names":[],"sources":["../src/unique.ts"],"sourcesContent":["import { numberConvert, randomNumber } from './number';\nimport { STRING_DICT } from './string';\nimport { isNumber, isString } from './type';\n\nlet lastTimestamp = 0;\nlet lastSafePadding = 0;\n\n/**\n * 生成一个唯一的 BigInt 值。\n *\n * @param randomLength - 可选参数，指定随机部分的长度，默认为 0。\n *                        如果大于 0，则会在结果中附加指定长度的随机数。\n * @returns 返回一个唯一的 BigInt 值，包含时间戳、随机部分（如果有）以及递增的填充值。\n */\nexport function uniqueBigInt(randomLength = 0): bigint {\n  const now = Date.now();\n\n  if (now !== lastTimestamp) {\n    lastTimestamp = now;\n    lastSafePadding = 0;\n  }\n\n  let randomPart = '';\n\n  if (randomLength > 0) {\n    const randomMin = 10 ** (randomLength - 1);\n    const randomMax = 10 ** randomLength - 1;\n    randomPart = String(randomNumber(randomMin, randomMax));\n  }\n\n  return BigInt(randomPart + lastSafePadding++ + now);\n}\n\nconst _randomChar = (dict: string): string => {\n  const poolIndex = randomNumber(0, dict.length - 1);\n\n  return dict[poolIndex];\n};\n\n/**\n * 生成一个唯一的字符串。\n *\n * @param minLength - 可选参数，指定生成字符串的最小长度。\n *                 如果未提供或为字符串类型，则使用默认长度。\n * @param dict - 可选参数，指定生成字符串时使用的字符集。\n *               如果未提供，则使用默认字符集 `STRING_DICT`。\n * @returns 返回一个唯一的字符串，包含时间戳、随机部分（如果有）以及递增的填充值。\n *          如果指定了 `length`，则返回值的长度将被调整到指定长度。\n */\nexport function uniqueString(minLength: number, dict: string): string;\nexport function uniqueString(minLength: number): string;\nexport function uniqueString(dict: string): string;\nexport function uniqueString(): string;\nexport function uniqueString(minLength?: number | string, dict?: string) {\n  let finalLength = 0;\n  let finalDict = STRING_DICT;\n\n  if (isString(dict)) {\n    finalLength = minLength as number;\n    finalDict = dict;\n  } else if (isNumber(minLength)) {\n    finalLength = minLength;\n  } else if (isString(minLength)) {\n    finalDict = minLength;\n  }\n\n  let uniqueString = numberConvert(uniqueBigInt(), finalDict);\n  let insertLength = finalLength - uniqueString.length;\n\n  if (insertLength <= 0) return uniqueString;\n\n  while (insertLength--) {\n    uniqueString += _randomChar(finalDict);\n  }\n\n  return uniqueString;\n}\n"],"mappings":";;;AAIA,IAAI,gBAAgB;AACpB,IAAI,kBAAkB;;;;;;;;AAStB,SAAgB,aAAa,eAAe,GAAW;CACrD,MAAM,MAAM,KAAK,IAAI;CAErB,IAAI,QAAQ,eAAe;EACzB,gBAAgB;EAChB,kBAAkB;CACpB;CAEA,IAAI,aAAa;CAEjB,IAAI,eAAe,GAAG;EACpB,MAAM,YAAY,OAAO,eAAe;EACxC,MAAM,YAAY,MAAM,eAAe;EACvC,aAAa,OAAO,aAAa,WAAW,SAAS,CAAC;CACxD;CAEA,OAAO,OAAO,aAAa,oBAAoB,GAAG;AACpD;AAEA,IAAM,eAAe,SAAyB;CAG5C,OAAO,KAFW,aAAa,GAAG,KAAK,SAAS,CAEpC;AACd;AAgBA,SAAgB,aAAa,WAA6B,MAAe;CACvE,IAAI,cAAc;CAClB,IAAI,YAAY;CAEhB,IAAI,SAAS,IAAI,GAAG;EAClB,cAAc;EACd,YAAY;CACd,OAAO,IAAI,SAAS,SAAS,GAC3B,cAAc;MACT,IAAI,SAAS,SAAS,GAC3B,YAAY;CAGd,IAAI,eAAe,cAAc,aAAa,GAAG,SAAS;CAC1D,IAAI,eAAe,cAAc,aAAa;CAE9C,IAAI,gBAAgB,GAAG,OAAO;CAE9B,OAAO,gBACL,gBAAgB,YAAY,SAAS;CAGvC,OAAO;AACT"}

package/dist/url.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"url.cjs","names":[],"sources":["../src/url.ts"],"sourcesContent":["/**\n * URL 元信息\n */\nexport type UrlMeta = {\n  /**\n   * 协议部分，包含冒号，例如 \"https:\"。\n   */\n  protocol: string;\n  /**\n   * 主机部分，包括主机名和端口。\n   */\n  host: string;\n  /**\n   * 主机名部分。\n   */\n  hostname: string;\n  /**\n   * 端口部分。\n   */\n  port: string;\n  /**\n   * 路径部分。\n   */\n  pathname: string;\n  /**\n   * 查询字符串部分。\n   */\n  search: string;\n  /**\n   * 哈希部分。\n   */\n  hash: string;\n  /**\n   * 用户名部分。\n   */\n  username: string;\n  /**\n   * 密码部分。\n   */\n  password: string;\n};\n\n/**\n * 解析 URL 字符串为组件对象。\n * @param url - 需要解析的 URL 字符串。\n * @returns 包含解析后 URL 组件的对象。\n */\nexport function urlParse(url: string): UrlMeta {\n  let result: URL | null = null;\n\n  try {\n    // 添加 globalThis 是便于对接外部环境 URL 的自行实现\n    // 例如在 uni-app、微信小程序等运行环境。\n    result = new globalThis.URL(url);\n  } catch {\n    // ignore\n  }\n\n  const protocol = result?.protocol || '';\n  const host = result?.host || '';\n\n  return {\n    protocol,\n    host,\n    hostname: result?.hostname || '',\n    port: result?.port || '',\n    pathname: result?.pathname || '',\n    search: result?.search || '',\n    hash: result?.hash || '',\n    username: result?.username || '',\n    password: result?.password || '',\n  };\n}\n\n/**\n * 将 UrlMeta 对象转换回 URL 字符串。\n * @param url - 需要转换的 UrlMeta 对象。\n * @returns 转换后的 URL 字符串。\n */\nexport function urlStringify(url: UrlMeta) {\n  const { protocol, hostname, port, pathname, search, hash, username, password } = url;\n  return [\n    protocol ? `${protocol}//` : '',\n    username && password ? `${username}:${password}@` : '',\n    hostname,\n    port ? `:${port}` : '',\n    pathname,\n    search,\n    hash,\n  ]\n    .filter(Boolean)\n    .join('');\n}\n"],"mappings":";;;;;;;AA+CA,SAAgB,SAAS,KAAsB;CAC7C,IAAI,SAAqB;CAEzB,IAAI;EAGF,SAAS,IAAI,WAAW,IAAI,IAAI;SAC1B;CAOR,OAAO;EACL,UAJe,QAAQ,YAAY;EAKnC,MAJW,QAAQ,QAAQ;EAK3B,UAAU,QAAQ,YAAY;EAC9B,MAAM,QAAQ,QAAQ;EACtB,UAAU,QAAQ,YAAY;EAC9B,QAAQ,QAAQ,UAAU;EAC1B,MAAM,QAAQ,QAAQ;EACtB,UAAU,QAAQ,YAAY;EAC9B,UAAU,QAAQ,YAAY;EAC/B;;;;;;;AAQH,SAAgB,aAAa,KAAc;CACzC,MAAM,EAAE,UAAU,UAAU,MAAM,UAAU,QAAQ,MAAM,UAAU,aAAa;CACjF,OAAO;EACL,WAAW,GAAG,SAAS,MAAM;EAC7B,YAAY,WAAW,GAAG,SAAS,GAAG,SAAS,KAAK;EACpD;EACA,OAAO,IAAI,SAAS;EACpB;EACA;EACA;EACD,CACE,OAAO,QAAQ,CACf,KAAK,GAAG"}
+{"version":3,"file":"url.cjs","names":[],"sources":["../src/url.ts"],"sourcesContent":["/**\n * URL 元信息\n */\nexport type UrlMeta = {\n  /**\n   * 协议部分，包含冒号，例如 \"https:\"。\n   */\n  protocol: string;\n  /**\n   * 主机部分，包括主机名和端口。\n   */\n  host: string;\n  /**\n   * 主机名部分。\n   */\n  hostname: string;\n  /**\n   * 端口部分。\n   */\n  port: string;\n  /**\n   * 路径部分。\n   */\n  pathname: string;\n  /**\n   * 查询字符串部分。\n   */\n  search: string;\n  /**\n   * 哈希部分。\n   */\n  hash: string;\n  /**\n   * 用户名部分。\n   */\n  username: string;\n  /**\n   * 密码部分。\n   */\n  password: string;\n};\n\n/**\n * 解析 URL 字符串为组件对象。\n * @param url - 需要解析的 URL 字符串。\n * @returns 包含解析后 URL 组件的对象。\n */\nexport function urlParse(url: string): UrlMeta {\n  let result: URL | null = null;\n\n  try {\n    // 添加 globalThis 是便于对接外部环境 URL 的自行实现\n    // 例如在 uni-app、微信小程序等运行环境。\n    result = new globalThis.URL(url);\n  } catch {\n    // ignore\n  }\n\n  const protocol = result?.protocol || '';\n  const host = result?.host || '';\n\n  return {\n    protocol,\n    host,\n    hostname: result?.hostname || '',\n    port: result?.port || '',\n    pathname: result?.pathname || '',\n    search: result?.search || '',\n    hash: result?.hash || '',\n    username: result?.username || '',\n    password: result?.password || '',\n  };\n}\n\n/**\n * 将 UrlMeta 对象转换回 URL 字符串。\n * @param url - 需要转换的 UrlMeta 对象。\n * @returns 转换后的 URL 字符串。\n */\nexport function urlStringify(url: UrlMeta) {\n  const { protocol, hostname, port, pathname, search, hash, username, password } = url;\n  return [\n    protocol ? `${protocol}//` : '',\n    username && password ? `${username}:${password}@` : '',\n    hostname,\n    port ? `:${port}` : '',\n    pathname,\n    search,\n    hash,\n  ]\n    .filter(Boolean)\n    .join('');\n}\n"],"mappings":";;;;;;;AA+CA,SAAgB,SAAS,KAAsB;CAC7C,IAAI,SAAqB;CAEzB,IAAI;EAGF,SAAS,IAAI,WAAW,IAAI,GAAG;CACjC,QAAQ,CAER;CAKA,OAAO;EACL,UAJe,QAAQ,YAAY;EAKnC,MAJW,QAAQ,QAAQ;EAK3B,UAAU,QAAQ,YAAY;EAC9B,MAAM,QAAQ,QAAQ;EACtB,UAAU,QAAQ,YAAY;EAC9B,QAAQ,QAAQ,UAAU;EAC1B,MAAM,QAAQ,QAAQ;EACtB,UAAU,QAAQ,YAAY;EAC9B,UAAU,QAAQ,YAAY;CAChC;AACF;;;;;;AAOA,SAAgB,aAAa,KAAc;CACzC,MAAM,EAAE,UAAU,UAAU,MAAM,UAAU,QAAQ,MAAM,UAAU,aAAa;CACjF,OAAO;EACL,WAAW,GAAG,SAAS,MAAM;EAC7B,YAAY,WAAW,GAAG,SAAS,GAAG,SAAS,KAAK;EACpD;EACA,OAAO,IAAI,SAAS;EACpB;EACA;EACA;CACF,EACG,OAAO,OAAO,EACd,KAAK,EAAE;AACZ"}

package/dist/url.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"url.mjs","names":[],"sources":["../src/url.ts"],"sourcesContent":["/**\n * URL 元信息\n */\nexport type UrlMeta = {\n  /**\n   * 协议部分，包含冒号，例如 \"https:\"。\n   */\n  protocol: string;\n  /**\n   * 主机部分，包括主机名和端口。\n   */\n  host: string;\n  /**\n   * 主机名部分。\n   */\n  hostname: string;\n  /**\n   * 端口部分。\n   */\n  port: string;\n  /**\n   * 路径部分。\n   */\n  pathname: string;\n  /**\n   * 查询字符串部分。\n   */\n  search: string;\n  /**\n   * 哈希部分。\n   */\n  hash: string;\n  /**\n   * 用户名部分。\n   */\n  username: string;\n  /**\n   * 密码部分。\n   */\n  password: string;\n};\n\n/**\n * 解析 URL 字符串为组件对象。\n * @param url - 需要解析的 URL 字符串。\n * @returns 包含解析后 URL 组件的对象。\n */\nexport function urlParse(url: string): UrlMeta {\n  let result: URL | null = null;\n\n  try {\n    // 添加 globalThis 是便于对接外部环境 URL 的自行实现\n    // 例如在 uni-app、微信小程序等运行环境。\n    result = new globalThis.URL(url);\n  } catch {\n    // ignore\n  }\n\n  const protocol = result?.protocol || '';\n  const host = result?.host || '';\n\n  return {\n    protocol,\n    host,\n    hostname: result?.hostname || '',\n    port: result?.port || '',\n    pathname: result?.pathname || '',\n    search: result?.search || '',\n    hash: result?.hash || '',\n    username: result?.username || '',\n    password: result?.password || '',\n  };\n}\n\n/**\n * 将 UrlMeta 对象转换回 URL 字符串。\n * @param url - 需要转换的 UrlMeta 对象。\n * @returns 转换后的 URL 字符串。\n */\nexport function urlStringify(url: UrlMeta) {\n  const { protocol, hostname, port, pathname, search, hash, username, password } = url;\n  return [\n    protocol ? `${protocol}//` : '',\n    username && password ? `${username}:${password}@` : '',\n    hostname,\n    port ? `:${port}` : '',\n    pathname,\n    search,\n    hash,\n  ]\n    .filter(Boolean)\n    .join('');\n}\n"],"mappings":";;;;;;AA+CA,SAAgB,SAAS,KAAsB;CAC7C,IAAI,SAAqB;CAEzB,IAAI;EAGF,SAAS,IAAI,WAAW,IAAI,IAAI;SAC1B;CAOR,OAAO;EACL,UAJe,QAAQ,YAAY;EAKnC,MAJW,QAAQ,QAAQ;EAK3B,UAAU,QAAQ,YAAY;EAC9B,MAAM,QAAQ,QAAQ;EACtB,UAAU,QAAQ,YAAY;EAC9B,QAAQ,QAAQ,UAAU;EAC1B,MAAM,QAAQ,QAAQ;EACtB,UAAU,QAAQ,YAAY;EAC9B,UAAU,QAAQ,YAAY;EAC/B;;;;;;;AAQH,SAAgB,aAAa,KAAc;CACzC,MAAM,EAAE,UAAU,UAAU,MAAM,UAAU,QAAQ,MAAM,UAAU,aAAa;CACjF,OAAO;EACL,WAAW,GAAG,SAAS,MAAM;EAC7B,YAAY,WAAW,GAAG,SAAS,GAAG,SAAS,KAAK;EACpD;EACA,OAAO,IAAI,SAAS;EACpB;EACA;EACA;EACD,CACE,OAAO,QAAQ,CACf,KAAK,GAAG"}
+{"version":3,"file":"url.mjs","names":[],"sources":["../src/url.ts"],"sourcesContent":["/**\n * URL 元信息\n */\nexport type UrlMeta = {\n  /**\n   * 协议部分，包含冒号，例如 \"https:\"。\n   */\n  protocol: string;\n  /**\n   * 主机部分，包括主机名和端口。\n   */\n  host: string;\n  /**\n   * 主机名部分。\n   */\n  hostname: string;\n  /**\n   * 端口部分。\n   */\n  port: string;\n  /**\n   * 路径部分。\n   */\n  pathname: string;\n  /**\n   * 查询字符串部分。\n   */\n  search: string;\n  /**\n   * 哈希部分。\n   */\n  hash: string;\n  /**\n   * 用户名部分。\n   */\n  username: string;\n  /**\n   * 密码部分。\n   */\n  password: string;\n};\n\n/**\n * 解析 URL 字符串为组件对象。\n * @param url - 需要解析的 URL 字符串。\n * @returns 包含解析后 URL 组件的对象。\n */\nexport function urlParse(url: string): UrlMeta {\n  let result: URL | null = null;\n\n  try {\n    // 添加 globalThis 是便于对接外部环境 URL 的自行实现\n    // 例如在 uni-app、微信小程序等运行环境。\n    result = new globalThis.URL(url);\n  } catch {\n    // ignore\n  }\n\n  const protocol = result?.protocol || '';\n  const host = result?.host || '';\n\n  return {\n    protocol,\n    host,\n    hostname: result?.hostname || '',\n    port: result?.port || '',\n    pathname: result?.pathname || '',\n    search: result?.search || '',\n    hash: result?.hash || '',\n    username: result?.username || '',\n    password: result?.password || '',\n  };\n}\n\n/**\n * 将 UrlMeta 对象转换回 URL 字符串。\n * @param url - 需要转换的 UrlMeta 对象。\n * @returns 转换后的 URL 字符串。\n */\nexport function urlStringify(url: UrlMeta) {\n  const { protocol, hostname, port, pathname, search, hash, username, password } = url;\n  return [\n    protocol ? `${protocol}//` : '',\n    username && password ? `${username}:${password}@` : '',\n    hostname,\n    port ? `:${port}` : '',\n    pathname,\n    search,\n    hash,\n  ]\n    .filter(Boolean)\n    .join('');\n}\n"],"mappings":";;;;;;AA+CA,SAAgB,SAAS,KAAsB;CAC7C,IAAI,SAAqB;CAEzB,IAAI;EAGF,SAAS,IAAI,WAAW,IAAI,GAAG;CACjC,QAAQ,CAER;CAKA,OAAO;EACL,UAJe,QAAQ,YAAY;EAKnC,MAJW,QAAQ,QAAQ;EAK3B,UAAU,QAAQ,YAAY;EAC9B,MAAM,QAAQ,QAAQ;EACtB,UAAU,QAAQ,YAAY;EAC9B,QAAQ,QAAQ,UAAU;EAC1B,MAAM,QAAQ,QAAQ;EACtB,UAAU,QAAQ,YAAY;EAC9B,UAAU,QAAQ,YAAY;CAChC;AACF;;;;;;AAOA,SAAgB,aAAa,KAAc;CACzC,MAAM,EAAE,UAAU,UAAU,MAAM,UAAU,QAAQ,MAAM,UAAU,aAAa;CACjF,OAAO;EACL,WAAW,GAAG,SAAS,MAAM;EAC7B,YAAY,WAAW,GAAG,SAAS,GAAG,SAAS,KAAK;EACpD;EACA,OAAO,IAAI,SAAS;EACpB;EACA;EACA;CACF,EACG,OAAO,OAAO,EACd,KAAK,EAAE;AACZ"}

package/dist/version.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"version.cjs","names":[],"sources":["../src/version.ts"],"sourcesContent":["import { isInteger } from './regexp';\nimport { isUndefined } from './type';\n\n/**\n * 表示包含主版本号、次版本号和修订号的对象\n */\nexport type VersionObject = {\n  /**\n   * 主版本号，当有不兼容的API修改时递增\n   */\n  major: number;\n  /**\n   * 次版本号，当有向下兼容的功能新增时递增\n   */\n  minor: number;\n  /**\n   * 修订号，当有向下兼容的问题修正时递增\n   */\n  patch: number;\n};\n\n/**\n * 将数字转换为安全的数值，如果输入为NaN则返回0\n * @param pos - 位置描述，用于错误提示\n * @param str - 要转换的数字字符串\n * @returns 安全的数字（如果输入为NaN则返回0）\n */\nfunction internal_numerical(pos: string, str?: string) {\n  if (isUndefined(str)) throw new Error(`${pos}不存在`);\n  if (!isInteger(str)) throw new Error(`${pos}不是整数`);\n  const num = Number(str);\n  if (num < 0) throw new Error(`${pos}不是正整数`);\n  return num;\n}\n\n/**\n * 将语义化版本号字符串解析为VersionObject对象\n * @param version - 要解析的版本号字符串 (例如 \"1.2.3\")\n * @returns 包含主版本号、次版本号和修订号的对象\n * @throws 如果版本号字符串格式无效将抛出错误\n */\nexport function versionParse(version: string): VersionObject {\n  const parts = version.split('.');\n\n  if (parts.length !== 3) {\n    throw new Error('版本号格式不正确');\n  }\n\n  const [major, minor, patch] = parts;\n\n  return {\n    major: internal_numerical('主版本号', major),\n    minor: internal_numerical('次版本号', minor),\n    patch: internal_numerical('修订号', patch),\n  };\n}\n\n/**\n * 比较两个语义化版本号字符串\n * @param version1 - 要比较的第一个版本号字符串\n * @param version2 - 要比较的第二个版本号字符串\n * @returns 如果version1较大返回1，version2较大返回-1，相等返回0\n * @throws 如果任一版本号字符串格式无效将抛出错误\n */\nexport function versionCompare(version1: string, version2: string): number {\n  const vo1 = versionParse(version1);\n  const vo2 = versionParse(version2);\n  const order: (keyof VersionObject)[] = ['major', 'minor', 'patch'];\n\n  for (const key of order) {\n    const n1 = vo1[key];\n    const n2 = vo2[key];\n\n    if (n1 > n2) {\n      return 1;\n    }\n\n    if (n1 < n2) {\n      return -1;\n    }\n  }\n\n  return 0;\n}\n"],"mappings":";;;;;;;;;;AA2BA,SAAS,mBAAmB,KAAa,KAAc;CACrD,IAAI,aAAA,YAAY,IAAI,EAAE,MAAM,IAAI,MAAM,GAAG,IAAI,KAAK;CAClD,IAAI,CAAC,eAAA,UAAU,IAAI,EAAE,MAAM,IAAI,MAAM,GAAG,IAAI,MAAM;CAClD,MAAM,MAAM,OAAO,IAAI;CACvB,IAAI,MAAM,GAAG,MAAM,IAAI,MAAM,GAAG,IAAI,OAAO;CAC3C,OAAO;;;;;;;;AAST,SAAgB,aAAa,SAAgC;CAC3D,MAAM,QAAQ,QAAQ,MAAM,IAAI;CAEhC,IAAI,MAAM,WAAW,GACnB,MAAM,IAAI,MAAM,WAAW;CAG7B,MAAM,CAAC,OAAO,OAAO,SAAS;CAE9B,OAAO;EACL,OAAO,mBAAmB,QAAQ,MAAM;EACxC,OAAO,mBAAmB,QAAQ,MAAM;EACxC,OAAO,mBAAmB,OAAO,MAAM;EACxC;;;;;;;;;AAUH,SAAgB,eAAe,UAAkB,UAA0B;CACzE,MAAM,MAAM,aAAa,SAAS;CAClC,MAAM,MAAM,aAAa,SAAS;CAGlC,KAAK,MAAM,OAAO;EAFsB;EAAS;EAAS;EAExC,EAAO;EACvB,MAAM,KAAK,IAAI;EACf,MAAM,KAAK,IAAI;EAEf,IAAI,KAAK,IACP,OAAO;EAGT,IAAI,KAAK,IACP,OAAO;;CAIX,OAAO"}
+{"version":3,"file":"version.cjs","names":[],"sources":["../src/version.ts"],"sourcesContent":["import { isInteger } from './regexp';\nimport { isUndefined } from './type';\n\n/**\n * 表示包含主版本号、次版本号和修订号的对象\n */\nexport type VersionObject = {\n  /**\n   * 主版本号，当有不兼容的API修改时递增\n   */\n  major: number;\n  /**\n   * 次版本号，当有向下兼容的功能新增时递增\n   */\n  minor: number;\n  /**\n   * 修订号，当有向下兼容的问题修正时递增\n   */\n  patch: number;\n};\n\n/**\n * 将数字转换为安全的数值，如果输入为NaN则返回0\n * @param pos - 位置描述，用于错误提示\n * @param str - 要转换的数字字符串\n * @returns 安全的数字（如果输入为NaN则返回0）\n */\nfunction internal_numerical(pos: string, str?: string) {\n  if (isUndefined(str)) throw new Error(`${pos}不存在`);\n  if (!isInteger(str)) throw new Error(`${pos}不是整数`);\n  const num = Number(str);\n  if (num < 0) throw new Error(`${pos}不是正整数`);\n  return num;\n}\n\n/**\n * 将语义化版本号字符串解析为VersionObject对象\n * @param version - 要解析的版本号字符串 (例如 \"1.2.3\")\n * @returns 包含主版本号、次版本号和修订号的对象\n * @throws 如果版本号字符串格式无效将抛出错误\n */\nexport function versionParse(version: string): VersionObject {\n  const parts = version.split('.');\n\n  if (parts.length !== 3) {\n    throw new Error('版本号格式不正确');\n  }\n\n  const [major, minor, patch] = parts;\n\n  return {\n    major: internal_numerical('主版本号', major),\n    minor: internal_numerical('次版本号', minor),\n    patch: internal_numerical('修订号', patch),\n  };\n}\n\n/**\n * 比较两个语义化版本号字符串\n * @param version1 - 要比较的第一个版本号字符串\n * @param version2 - 要比较的第二个版本号字符串\n * @returns 如果version1较大返回1，version2较大返回-1，相等返回0\n * @throws 如果任一版本号字符串格式无效将抛出错误\n */\nexport function versionCompare(version1: string, version2: string): number {\n  const vo1 = versionParse(version1);\n  const vo2 = versionParse(version2);\n  const order: (keyof VersionObject)[] = ['major', 'minor', 'patch'];\n\n  for (const key of order) {\n    const n1 = vo1[key];\n    const n2 = vo2[key];\n\n    if (n1 > n2) {\n      return 1;\n    }\n\n    if (n1 < n2) {\n      return -1;\n    }\n  }\n\n  return 0;\n}\n"],"mappings":";;;;;;;;;;AA2BA,SAAS,mBAAmB,KAAa,KAAc;CACrD,IAAI,aAAA,YAAY,GAAG,GAAG,MAAM,IAAI,MAAM,GAAG,IAAI,IAAI;CACjD,IAAI,CAAC,eAAA,UAAU,GAAG,GAAG,MAAM,IAAI,MAAM,GAAG,IAAI,KAAK;CACjD,MAAM,MAAM,OAAO,GAAG;CACtB,IAAI,MAAM,GAAG,MAAM,IAAI,MAAM,GAAG,IAAI,MAAM;CAC1C,OAAO;AACT;;;;;;;AAQA,SAAgB,aAAa,SAAgC;CAC3D,MAAM,QAAQ,QAAQ,MAAM,GAAG;CAE/B,IAAI,MAAM,WAAW,GACnB,MAAM,IAAI,MAAM,UAAU;CAG5B,MAAM,CAAC,OAAO,OAAO,SAAS;CAE9B,OAAO;EACL,OAAO,mBAAmB,QAAQ,KAAK;EACvC,OAAO,mBAAmB,QAAQ,KAAK;EACvC,OAAO,mBAAmB,OAAO,KAAK;CACxC;AACF;;;;;;;;AASA,SAAgB,eAAe,UAAkB,UAA0B;CACzE,MAAM,MAAM,aAAa,QAAQ;CACjC,MAAM,MAAM,aAAa,QAAQ;CAGjC,KAAK,MAAM,OAAO;EAFsB;EAAS;EAAS;CAExC,GAAO;EACvB,MAAM,KAAK,IAAI;EACf,MAAM,KAAK,IAAI;EAEf,IAAI,KAAK,IACP,OAAO;EAGT,IAAI,KAAK,IACP,OAAO;CAEX;CAEA,OAAO;AACT"}

package/dist/version.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"version.mjs","names":[],"sources":["../src/version.ts"],"sourcesContent":["import { isInteger } from './regexp';\nimport { isUndefined } from './type';\n\n/**\n * 表示包含主版本号、次版本号和修订号的对象\n */\nexport type VersionObject = {\n  /**\n   * 主版本号，当有不兼容的API修改时递增\n   */\n  major: number;\n  /**\n   * 次版本号，当有向下兼容的功能新增时递增\n   */\n  minor: number;\n  /**\n   * 修订号，当有向下兼容的问题修正时递增\n   */\n  patch: number;\n};\n\n/**\n * 将数字转换为安全的数值，如果输入为NaN则返回0\n * @param pos - 位置描述，用于错误提示\n * @param str - 要转换的数字字符串\n * @returns 安全的数字（如果输入为NaN则返回0）\n */\nfunction internal_numerical(pos: string, str?: string) {\n  if (isUndefined(str)) throw new Error(`${pos}不存在`);\n  if (!isInteger(str)) throw new Error(`${pos}不是整数`);\n  const num = Number(str);\n  if (num < 0) throw new Error(`${pos}不是正整数`);\n  return num;\n}\n\n/**\n * 将语义化版本号字符串解析为VersionObject对象\n * @param version - 要解析的版本号字符串 (例如 \"1.2.3\")\n * @returns 包含主版本号、次版本号和修订号的对象\n * @throws 如果版本号字符串格式无效将抛出错误\n */\nexport function versionParse(version: string): VersionObject {\n  const parts = version.split('.');\n\n  if (parts.length !== 3) {\n    throw new Error('版本号格式不正确');\n  }\n\n  const [major, minor, patch] = parts;\n\n  return {\n    major: internal_numerical('主版本号', major),\n    minor: internal_numerical('次版本号', minor),\n    patch: internal_numerical('修订号', patch),\n  };\n}\n\n/**\n * 比较两个语义化版本号字符串\n * @param version1 - 要比较的第一个版本号字符串\n * @param version2 - 要比较的第二个版本号字符串\n * @returns 如果version1较大返回1，version2较大返回-1，相等返回0\n * @throws 如果任一版本号字符串格式无效将抛出错误\n */\nexport function versionCompare(version1: string, version2: string): number {\n  const vo1 = versionParse(version1);\n  const vo2 = versionParse(version2);\n  const order: (keyof VersionObject)[] = ['major', 'minor', 'patch'];\n\n  for (const key of order) {\n    const n1 = vo1[key];\n    const n2 = vo2[key];\n\n    if (n1 > n2) {\n      return 1;\n    }\n\n    if (n1 < n2) {\n      return -1;\n    }\n  }\n\n  return 0;\n}\n"],"mappings":";;;;;;;;;AA2BA,SAAS,mBAAmB,KAAa,KAAc;CACrD,IAAI,YAAY,IAAI,EAAE,MAAM,IAAI,MAAM,GAAG,IAAI,KAAK;CAClD,IAAI,CAAC,UAAU,IAAI,EAAE,MAAM,IAAI,MAAM,GAAG,IAAI,MAAM;CAClD,MAAM,MAAM,OAAO,IAAI;CACvB,IAAI,MAAM,GAAG,MAAM,IAAI,MAAM,GAAG,IAAI,OAAO;CAC3C,OAAO;;;;;;;;AAST,SAAgB,aAAa,SAAgC;CAC3D,MAAM,QAAQ,QAAQ,MAAM,IAAI;CAEhC,IAAI,MAAM,WAAW,GACnB,MAAM,IAAI,MAAM,WAAW;CAG7B,MAAM,CAAC,OAAO,OAAO,SAAS;CAE9B,OAAO;EACL,OAAO,mBAAmB,QAAQ,MAAM;EACxC,OAAO,mBAAmB,QAAQ,MAAM;EACxC,OAAO,mBAAmB,OAAO,MAAM;EACxC;;;;;;;;;AAUH,SAAgB,eAAe,UAAkB,UAA0B;CACzE,MAAM,MAAM,aAAa,SAAS;CAClC,MAAM,MAAM,aAAa,SAAS;CAGlC,KAAK,MAAM,OAAO;EAFsB;EAAS;EAAS;EAExC,EAAO;EACvB,MAAM,KAAK,IAAI;EACf,MAAM,KAAK,IAAI;EAEf,IAAI,KAAK,IACP,OAAO;EAGT,IAAI,KAAK,IACP,OAAO;;CAIX,OAAO"}
+{"version":3,"file":"version.mjs","names":[],"sources":["../src/version.ts"],"sourcesContent":["import { isInteger } from './regexp';\nimport { isUndefined } from './type';\n\n/**\n * 表示包含主版本号、次版本号和修订号的对象\n */\nexport type VersionObject = {\n  /**\n   * 主版本号，当有不兼容的API修改时递增\n   */\n  major: number;\n  /**\n   * 次版本号，当有向下兼容的功能新增时递增\n   */\n  minor: number;\n  /**\n   * 修订号，当有向下兼容的问题修正时递增\n   */\n  patch: number;\n};\n\n/**\n * 将数字转换为安全的数值，如果输入为NaN则返回0\n * @param pos - 位置描述，用于错误提示\n * @param str - 要转换的数字字符串\n * @returns 安全的数字（如果输入为NaN则返回0）\n */\nfunction internal_numerical(pos: string, str?: string) {\n  if (isUndefined(str)) throw new Error(`${pos}不存在`);\n  if (!isInteger(str)) throw new Error(`${pos}不是整数`);\n  const num = Number(str);\n  if (num < 0) throw new Error(`${pos}不是正整数`);\n  return num;\n}\n\n/**\n * 将语义化版本号字符串解析为VersionObject对象\n * @param version - 要解析的版本号字符串 (例如 \"1.2.3\")\n * @returns 包含主版本号、次版本号和修订号的对象\n * @throws 如果版本号字符串格式无效将抛出错误\n */\nexport function versionParse(version: string): VersionObject {\n  const parts = version.split('.');\n\n  if (parts.length !== 3) {\n    throw new Error('版本号格式不正确');\n  }\n\n  const [major, minor, patch] = parts;\n\n  return {\n    major: internal_numerical('主版本号', major),\n    minor: internal_numerical('次版本号', minor),\n    patch: internal_numerical('修订号', patch),\n  };\n}\n\n/**\n * 比较两个语义化版本号字符串\n * @param version1 - 要比较的第一个版本号字符串\n * @param version2 - 要比较的第二个版本号字符串\n * @returns 如果version1较大返回1，version2较大返回-1，相等返回0\n * @throws 如果任一版本号字符串格式无效将抛出错误\n */\nexport function versionCompare(version1: string, version2: string): number {\n  const vo1 = versionParse(version1);\n  const vo2 = versionParse(version2);\n  const order: (keyof VersionObject)[] = ['major', 'minor', 'patch'];\n\n  for (const key of order) {\n    const n1 = vo1[key];\n    const n2 = vo2[key];\n\n    if (n1 > n2) {\n      return 1;\n    }\n\n    if (n1 < n2) {\n      return -1;\n    }\n  }\n\n  return 0;\n}\n"],"mappings":";;;;;;;;;AA2BA,SAAS,mBAAmB,KAAa,KAAc;CACrD,IAAI,YAAY,GAAG,GAAG,MAAM,IAAI,MAAM,GAAG,IAAI,IAAI;CACjD,IAAI,CAAC,UAAU,GAAG,GAAG,MAAM,IAAI,MAAM,GAAG,IAAI,KAAK;CACjD,MAAM,MAAM,OAAO,GAAG;CACtB,IAAI,MAAM,GAAG,MAAM,IAAI,MAAM,GAAG,IAAI,MAAM;CAC1C,OAAO;AACT;;;;;;;AAQA,SAAgB,aAAa,SAAgC;CAC3D,MAAM,QAAQ,QAAQ,MAAM,GAAG;CAE/B,IAAI,MAAM,WAAW,GACnB,MAAM,IAAI,MAAM,UAAU;CAG5B,MAAM,CAAC,OAAO,OAAO,SAAS;CAE9B,OAAO;EACL,OAAO,mBAAmB,QAAQ,KAAK;EACvC,OAAO,mBAAmB,QAAQ,KAAK;EACvC,OAAO,mBAAmB,OAAO,KAAK;CACxC;AACF;;;;;;;;AASA,SAAgB,eAAe,UAAkB,UAA0B;CACzE,MAAM,MAAM,aAAa,QAAQ;CACjC,MAAM,MAAM,aAAa,QAAQ;CAGjC,KAAK,MAAM,OAAO;EAFsB;EAAS;EAAS;CAExC,GAAO;EACvB,MAAM,KAAK,IAAI;EACf,MAAM,KAAK,IAAI;EAEf,IAAI,KAAK,IACP,OAAO;EAGT,IAAI,KAAK,IACP,OAAO;CAEX;CAEA,OAAO;AACT"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudcome/utils-core",
-  "version": "1.21.0",
+  "version": "1.23.0",
   "description": "cloudcome core utils",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
@@ -43,9 +43,6 @@
       "error": [
         "./dist/error.d.ts"
       ],
-      "exception": [
-        "./dist/exception.d.ts"
-      ],
       "function": [
         "./dist/function.d.ts"
       ],
@@ -167,11 +164,6 @@
       "import": "./dist/error.mjs",
       "require": "./dist/error.cjs"
     },
-    "./exception": {
-      "types": "./dist/exception.d.ts",
-      "import": "./dist/exception.mjs",
-      "require": "./dist/exception.cjs"
-    },
     "./function": {
       "types": "./dist/function.d.ts",
       "import": "./dist/function.mjs",

package/dist/exception.cjs

@@ -1,40 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_object = require("./object.cjs");
-//#region src/exception.ts
-/**
-* 默认的异常构建选项
-*/
-var defaults = { 
-/**
-* 默认消息格式函数
-* @default (name, message) => `[${name}] ${message}`
-*/
-format: (name, message) => `[${name}] ${message}` };
-/**
-* 自定义异常类
-* @template T 额外属性的类型
-* @param name 异常类名称
-* @param options 构建选项
-* @returns 自定义异常类
-* @example
-* const MyException = defineException<{ code: number }>('MyException');
-* const err = new MyException('error', { code: 404 });
-*
-* @example
-* const SimpleException = defineException('SimpleException');
-* const err = new SimpleException('error', undefined);
-*/
-function defineException(name, options) {
-	const { format } = require_object.objectDefaults(options || {}, defaults);
-	return class extends Error {
-		constructor(message, extra) {
-			super(format(name, message));
-			this.name = name;
-			Object.assign(this, extra);
-		}
-	};
-}
-//#endregion
-exports.defineException = defineException;
-
-//# sourceMappingURL=exception.cjs.map

package/dist/exception.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"exception.cjs","names":[],"sources":["../src/exception.ts"],"sourcesContent":["import { objectDefaults } from './object';\n\n/**\n * 构建异常选项\n */\nexport type DefineExceptionOptions = {\n  /**\n   * 自定义错误消息格式函数\n   * @param name 错误名称\n   * @param message 原始错误消息\n   * @returns 格式化后的错误消息\n   * @example\n   * (name, message) => `${name}::${message}`\n   */\n  format?: (name: string, message: string) => string;\n};\n\n/**\n * 默认的异常构建选项\n */\nconst defaults: DefineExceptionOptions = {\n  /**\n   * 默认消息格式函数\n   * @default (name, message) => `[${name}] ${message}`\n   */\n  format: (name, message) => `[${name}] ${message}`,\n};\n\n/**\n * 自定义异常类\n * @template T 额外属性的类型\n * @param name 异常类名称\n * @param options 构建选项\n * @returns 自定义异常类\n * @example\n * const MyException = defineException<{ code: number }>('MyException');\n * const err = new MyException('error', { code: 404 });\n *\n * @example\n * const SimpleException = defineException('SimpleException');\n * const err = new SimpleException('error', undefined);\n */\nexport function defineException<T = void>(name: string, options?: DefineExceptionOptions) {\n  const { format } = objectDefaults(options || {}, defaults) as Required<DefineExceptionOptions>;\n\n  return class extends Error {\n    constructor(message: string, extra: T) {\n      super(format(name, message));\n      this.name = name;\n      Object.assign(this, extra);\n    }\n  } as unknown as {\n    new (message: string, extra: T): Error & T;\n  };\n}\n\n// const MyException = defineException<{ foo: string; bar: number }>('MyException: ');\n// const myException = new MyException('bar', { foo: '1', bar: 1 });\n// myException.foo;\n// myException.bar;\n// myException.name;\n// myException.message;\n// myException.stack;\n// myException.cause;\n\n// const MyException2 = defineException('MyException2: ');\n// const myException2 = new MyException2('bar');\n"],"mappings":";;;;;;AAoBA,IAAM,WAAmC;;;;;AAKvC,SAAS,MAAM,YAAY,IAAI,KAAK,IAAI,WACzC;;;;;;;;;;;;;;;AAgBD,SAAgB,gBAA0B,MAAc,SAAkC;CACxF,MAAM,EAAE,WAAW,eAAA,eAAe,WAAW,EAAE,EAAE,SAAS;CAE1D,OAAO,cAAc,MAAM;EACzB,YAAY,SAAiB,OAAU;GACrC,MAAM,OAAO,MAAM,QAAQ,CAAC;GAC5B,KAAK,OAAO;GACZ,OAAO,OAAO,MAAM,MAAM"}

package/dist/exception.d.ts

@@ -1,31 +0,0 @@
-/**
- * 构建异常选项
- */
-export type DefineExceptionOptions = {
-    /**
-     * 自定义错误消息格式函数
-     * @param name 错误名称
-     * @param message 原始错误消息
-     * @returns 格式化后的错误消息
-     * @example
-     * (name, message) => `${name}::${message}`
-     */
-    format?: (name: string, message: string) => string;
-};
-/**
- * 自定义异常类
- * @template T 额外属性的类型
- * @param name 异常类名称
- * @param options 构建选项
- * @returns 自定义异常类
- * @example
- * const MyException = defineException<{ code: number }>('MyException');
- * const err = new MyException('error', { code: 404 });
- *
- * @example
- * const SimpleException = defineException('SimpleException');
- * const err = new SimpleException('error', undefined);
- */
-export declare function defineException<T = void>(name: string, options?: DefineExceptionOptions): {
-    new (message: string, extra: T): Error & T;
-};

package/dist/exception.mjs

@@ -1,39 +0,0 @@
-import { objectDefaults } from "./object.mjs";
-//#region src/exception.ts
-/**
-* 默认的异常构建选项
-*/
-var defaults = { 
-/**
-* 默认消息格式函数
-* @default (name, message) => `[${name}] ${message}`
-*/
-format: (name, message) => `[${name}] ${message}` };
-/**
-* 自定义异常类
-* @template T 额外属性的类型
-* @param name 异常类名称
-* @param options 构建选项
-* @returns 自定义异常类
-* @example
-* const MyException = defineException<{ code: number }>('MyException');
-* const err = new MyException('error', { code: 404 });
-*
-* @example
-* const SimpleException = defineException('SimpleException');
-* const err = new SimpleException('error', undefined);
-*/
-function defineException(name, options) {
-	const { format } = objectDefaults(options || {}, defaults);
-	return class extends Error {
-		constructor(message, extra) {
-			super(format(name, message));
-			this.name = name;
-			Object.assign(this, extra);
-		}
-	};
-}
-//#endregion
-export { defineException };
-
-//# sourceMappingURL=exception.mjs.map

package/dist/exception.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"exception.mjs","names":[],"sources":["../src/exception.ts"],"sourcesContent":["import { objectDefaults } from './object';\n\n/**\n * 构建异常选项\n */\nexport type DefineExceptionOptions = {\n  /**\n   * 自定义错误消息格式函数\n   * @param name 错误名称\n   * @param message 原始错误消息\n   * @returns 格式化后的错误消息\n   * @example\n   * (name, message) => `${name}::${message}`\n   */\n  format?: (name: string, message: string) => string;\n};\n\n/**\n * 默认的异常构建选项\n */\nconst defaults: DefineExceptionOptions = {\n  /**\n   * 默认消息格式函数\n   * @default (name, message) => `[${name}] ${message}`\n   */\n  format: (name, message) => `[${name}] ${message}`,\n};\n\n/**\n * 自定义异常类\n * @template T 额外属性的类型\n * @param name 异常类名称\n * @param options 构建选项\n * @returns 自定义异常类\n * @example\n * const MyException = defineException<{ code: number }>('MyException');\n * const err = new MyException('error', { code: 404 });\n *\n * @example\n * const SimpleException = defineException('SimpleException');\n * const err = new SimpleException('error', undefined);\n */\nexport function defineException<T = void>(name: string, options?: DefineExceptionOptions) {\n  const { format } = objectDefaults(options || {}, defaults) as Required<DefineExceptionOptions>;\n\n  return class extends Error {\n    constructor(message: string, extra: T) {\n      super(format(name, message));\n      this.name = name;\n      Object.assign(this, extra);\n    }\n  } as unknown as {\n    new (message: string, extra: T): Error & T;\n  };\n}\n\n// const MyException = defineException<{ foo: string; bar: number }>('MyException: ');\n// const myException = new MyException('bar', { foo: '1', bar: 1 });\n// myException.foo;\n// myException.bar;\n// myException.name;\n// myException.message;\n// myException.stack;\n// myException.cause;\n\n// const MyException2 = defineException('MyException2: ');\n// const myException2 = new MyException2('bar');\n"],"mappings":";;;;;AAoBA,IAAM,WAAmC;;;;;AAKvC,SAAS,MAAM,YAAY,IAAI,KAAK,IAAI,WACzC;;;;;;;;;;;;;;;AAgBD,SAAgB,gBAA0B,MAAc,SAAkC;CACxF,MAAM,EAAE,WAAW,eAAe,WAAW,EAAE,EAAE,SAAS;CAE1D,OAAO,cAAc,MAAM;EACzB,YAAY,SAAiB,OAAU;GACrC,MAAM,OAAO,MAAM,QAAQ,CAAC;GAC5B,KAAK,OAAO;GACZ,OAAO,OAAO,MAAM,MAAM"}