@pawover/kit 0.0.1 → 0.1.1

package/packages/utils/dist/index.d.ts

@@ -13,15 +13,20 @@ declare class ArrayUtil {
    * @returns 构造后的数组
    * @example
    * ```ts
+   * // 重载 1: checkEmpty = true (默认)
    * ArrayUtil.cast(1); // [1]
-   * ArrayUtil.cast([1, 2]); // [1, 2]
    * ArrayUtil.cast(null); // []
-   * ArrayUtil.cast(undefined); // []
+   *
+   * // 重载 2: checkEmpty = false
    * ArrayUtil.cast(null, false); // [null]
+   *
+   * // 通用场景
+   * ArrayUtil.cast([1, 2]); // [1, 2]
+   * ArrayUtil.cast(undefined); // []
    * ```
    */
   static cast<T>(candidate: T | T[] | null | undefined, checkEmpty?: true): NonNullable<T>[];
-  static cast<T>(candidate: T | T[] | null | undefined, checkEmpty?: false): T[];
+  static cast<T>(candidate: T | T[] | null | undefined, checkEmpty: false): T[];
   /**
    * 获取数组第一项
    *
@@ -30,7 +35,11 @@ declare class ArrayUtil {
    * @returns 数组第一项，如果为空则返回回退值
    * @example
    * ```ts
+   * // 重载 1: 无 fallback
    * ArrayUtil.first([1, 2]); // 1
+   * ArrayUtil.first([]); // undefined
+   *
+   * // 重载 2: 有 fallback
    * ArrayUtil.first([], 0); // 0
    * ```
    */
@@ -44,7 +53,11 @@ declare class ArrayUtil {
    * @returns 数组最后一项，如果为空则返回回退值
    * @example
    * ```ts
+   * // 重载 1: 无 fallback
    * ArrayUtil.last([1, 2, 3]); // 3
+   * ArrayUtil.last([]); // undefined
+   *
+   * // 重载 2: 有 fallback
    * ArrayUtil.last([], 0); // 0
    * ```
    */
@@ -107,7 +120,10 @@ declare class ArrayUtil {
    * @returns 交集数组
    * @example
    * ```ts
+   * // 重载 1: 按元素本身比较
    * ArrayUtil.intersection([1, 2], [2, 3]); // [2]
+   *
+   * // 重载 2: 按 match 结果比较
    * ArrayUtil.intersection([{ id: 1 }, { id: 2 }], [{ id: 2 }], (x) => x.id); // [{ id: 2 }]
    * ```
    */
@@ -124,11 +140,11 @@ declare class ArrayUtil {
    * @returns 合并后的数组
    * @example
    * ```ts
-   * // 基础合并去重
+   * // 重载 1: 基础合并去重
    * ArrayUtil.merge([1, 2], [2, 3]); // [1, 2, 3]
    * ArrayUtil.merge([], [1, 2, 3]); // [1, 2, 3]
    *
-   * // 按条件更新
+   * // 重载 2: 按条件更新
    * const source = [{ id: 1, val: "a" }, { id: 2, val: "b" }];
    * const update = [{ id: 2, val: "new" }, { id: 3, val: "c" }];
    * ArrayUtil.merge(source, update, (x) => x.id); // [{ id: 1, val: "a" }, { id: 2, val: "new" }] -> id:3 被忽略
@@ -147,7 +163,11 @@ declare class ArrayUtil {
    * @example
    * ```ts
    * const list = [1, 2, 3, 4];
+   *
+   * // 重载 1: 仅过滤
    * ArrayUtil.pick(list, (n) => n % 2 === 0); // [2, 4]
+   *
+   * // 重载 2: 过滤 + 映射
    * ArrayUtil.pick(list, (n) => n % 2 === 0, (n) => n * 2); // [4, 8]
    * ```
    */
@@ -164,7 +184,11 @@ declare class ArrayUtil {
    * @returns 替换后的新数组
    * @example
    * ```ts
+   * // 重载 1/2: newItem 与数组元素类型兼容
    * ArrayUtil.replace([1, 2, 3], 4, (n) => n === 2); // [1, 4, 3]
+   *
+   * // 重载 3: newItem 可扩展为新类型
+   * ArrayUtil.replace([1, 2, 3], "X", (n) => n === 2); // [1, "X", 3]
    * ```
    */
   static replace<const T>(initialList: readonly T[], newItem: T, match: MatchFunction<T, boolean>): T[];
@@ -236,7 +260,20 @@ declare class ArrayUtil {
    * @returns 压缩后的元组数组
    * @example
    * ```ts
+   * // 重载 1: 两个数组
    * ArrayUtil.zip([1, 2], ["a", "b"]); // [[1, "a"], [2, "b"]]
+   *
+   * // 重载 2: 三个数组
+   * ArrayUtil.zip([1, 2], ["a", "b"], [true, false]); // [[1, "a", true], [2, "b", false]]
+   *
+   * // 重载 3: 四个数组
+   * ArrayUtil.zip([1], ["a"], [true], ["x"]); // [[1, "a", true, "x"]]
+   *
+   * // 重载 4: 五个数组
+   * ArrayUtil.zip([1], ["a"], [true], ["x"], [9]); // [[1, "a", true, "x", 9]]
+   *
+   * // 重载 5: 空参数
+   * ArrayUtil.zip(); // []
    * ```
    */
   static zip<T1, T2, T3, T4, T5>(array1: readonly T1[], array2: readonly T2[], array3: readonly T3[], array4: readonly T4[], array5: readonly T5[]): [T1, T2, T3, T4, T5][];
@@ -253,8 +290,13 @@ declare class ArrayUtil {
    * @returns 生成的对象
    * @example
    * ```ts
+   * // 重载 1: 传值数组
    * ArrayUtil.zipToObject(["a", "b"], [1, 2]); // { a: 1, b: 2 }
+   *
+   * // 重载 2: 传生成函数
    * ArrayUtil.zipToObject(["a", "b"], (k, i) => k + i); // { a: "a0", b: "b1" }
+   *
+   * // 重载 3: 传静态值
    * ArrayUtil.zipToObject(["a", "b"], 1); // { a: 1, b: 1 }
    * ```
    */
@@ -270,52 +312,109 @@ declare class ArrayUtil {
 declare class DateTimeUtil {
   /**
    * 每秒的毫秒数
+   * @example
+   * ```ts
+   * DateTimeUtil.MILLISECONDS_PER_SECOND; // 1000
+   * ```
    */
   static readonly MILLISECONDS_PER_SECOND: number;
   /**
    * 每分钟的秒数
+   * @example
+   * ```ts
+   * DateTimeUtil.SECOND_PER_MINUTE; // 60
+   * ```
    */
   static readonly SECOND_PER_MINUTE: number;
   /**
    * 每小时的分钟数
+   * @example
+   * ```ts
+   * DateTimeUtil.MINUTE_PER_HOUR; // 60
+   * ```
    */
   static readonly MINUTE_PER_HOUR: number;
   /**
    * 每小时的秒数
+   * @example
+   * ```ts
+   * DateTimeUtil.SECOND_PER_HOUR; // 3600
+   * ```
    */
   static readonly SECOND_PER_HOUR: number;
   /**
    * 每天小时数
+   * @example
+   * ```ts
+   * DateTimeUtil.HOUR_PER_DAY; // 24
+   * ```
    */
   static readonly HOUR_PER_DAY: number;
   /**
    * 每天秒数
+   * @example
+   * ```ts
+   * DateTimeUtil.SECOND_PER_DAY; // 86400
+   * ```
    */
   static readonly SECOND_PER_DAY: number;
   /**
    * 每周天数
+   * @example
+   * ```ts
+   * DateTimeUtil.DAY_PER_WEEK; // 7
+   * ```
    */
   static readonly DAY_PER_WEEK: number;
   /**
    * 每月天数
+   * @example
+   * ```ts
+   * DateTimeUtil.DAY_PER_MONTH; // 30
+   * ```
    */
   static readonly DAY_PER_MONTH: number;
   /**
    * 每年天数
+   * @example
+   * ```ts
+   * DateTimeUtil.DAY_PER_YEAR; // 365
+   * ```
    */
   static readonly DAY_PER_YEAR: number;
   /**
    * 每年月数
+   * @example
+   * ```ts
+   * DateTimeUtil.MONTH_PER_YEAR; // 12
+   * ```
    */
   static readonly MONTH_PER_YEAR: number;
   /**
    * 每年平均周
+   * @example
+   * ```ts
+   * DateTimeUtil.WEEK_PER_YEAR; // 52
+   * ```
    */
   static readonly WEEK_PER_YEAR: number;
   /**
    * 每月平均周
+   * @example
+   * ```ts
+   * DateTimeUtil.WEEK_PER_MONTH; // 4
+   * ```
    */
   static readonly WEEK_PER_MONTH: number;
+  /**
+   * 常用时间格式模板集合
+   *
+   * @example
+   * ```ts
+   * DateTimeUtil.FORMAT.ISO_DATE; // "yyyy-MM-dd"
+   * DateTimeUtil.FORMAT.CN_DATE_TIME; // "yyyy年MM月dd日 HH时mm分ss秒"
+   * ```
+   */
   static readonly FORMAT: {
     readonly ISO_DATE: "yyyy-MM-dd";
     readonly ISO_TIME: "HH:mm:ss";
@@ -372,11 +471,44 @@ declare class EnvUtil {
   private static readonly _isBrowser;
   private static readonly _isWebWorker;
   private static readonly _isReactNative;
+  /**
+   * 检测是否处于浏览器环境
+   *
+   * @returns 是否为浏览器环境
+   * @example
+   * ```ts
+   * EnvUtil.isBrowser(); // true: 浏览器, false: Node.js
+   * ```
+   */
   static isBrowser(): boolean;
+  /**
+   * 检测是否处于 Web Worker 环境
+   *
+   * @returns 是否为 Web Worker 环境
+   * @example
+   * ```ts
+   * EnvUtil.isWebWorker(); // true: Worker, false: 主线程/Node.js
+   * ```
+   */
   static isWebWorker(): boolean;
+  /**
+   * 检测是否处于 React Native 环境
+   *
+   * @returns 是否为 React Native 环境
+   * @example
+   * ```ts
+   * EnvUtil.isReactNative(); // true: React Native, false: Web/Node.js
+   * ```
+   */
   static isReactNative(): boolean;
   /**
    * 检查是否在 iframe 环境中
+   *
+   * @returns 是否在 iframe 中
+   * @example
+   * ```ts
+   * EnvUtil.isIframe(); // true: 当前页面在 iframe 中
+   * ```
    */
   static isIframe(): boolean;
   /**
@@ -466,9 +598,9 @@ declare class EnvUtil {
   static isTablet(minWidth?: number, maxWidth?: number, dpi?: number): boolean;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@pawover+types@0.0.1_@types+react@19.2.14_typescript@6.0.3/node_modules/@pawover/types/dist/index.d.ts
+//#region ../../node_modules/.pnpm/@pawover+types@0.0.2_@types+react@19.2.15_typescript@6.0.3/node_modules/@pawover/types/dist/index.d.ts
 //#endregion
-//#region src/index.d.ts
+//#region src/global.d.ts
 /** 任意对象类型 */
 type AnyObject<K extends PropertyKey = PropertyKey, T = any> = Record<K, T>;
 /** 普通对象类型 */
@@ -482,7 +614,8 @@ type AnyAsyncFunction<P extends any[] = any[], R = any> = (...args: P) => Promis
 /** 描述生成器函数类型 */
 type AnyGeneratorFunction<P extends any[] = any[], T = any, R = any, N = any> = (...args: P) => Generator<T, R, N>;
 /** 描述异步生成器函数类型 */
-type AnyAsyncGeneratorFunction<P extends any[] = any[], T = any, R = any, N = any> = (...args: P) => AsyncGenerator<T, R, N>; //#endregion
+type AnyAsyncGeneratorFunction<P extends any[] = any[], T = any, R = any, N = any> = (...args: P) => AsyncGenerator<T, R, N>;
+/** 描述无返回值函数 */
 //#endregion
 //#region src/function/functionUtil.d.ts
 /**
@@ -514,6 +647,7 @@ declare class FunctionUtil {
    * @throws TypeError 如果 args 为 null 或 undefined
    *
    * @example
+   * ```ts
    * // 遗留代码场景
    * function legacyFn(a: number, b: string) {
    *   const argsArray = FunctionUtil.toArgs(arguments);
@@ -530,6 +664,7 @@ declare class FunctionUtil {
    *   const rest = FunctionUtil.toArgs(arguments, 1);
    *   // rest: unknown[]，跳过第一个参数
    * }
+   * ```
    */
   static toArgs<T = unknown>(args: IArguments, start?: number | undefined): T[];
   /**
@@ -540,6 +675,7 @@ declare class FunctionUtil {
    * @returns 标准化的 Promise
    *
    * @example
+   * ```ts
    * // 同步函数
    * FunctionUtil.toPromise(() => 42).then(v => console.log(v)); // 42
    *
@@ -548,6 +684,7 @@ declare class FunctionUtil {
    *
    * // 异常处理
    * FunctionUtil.toPromise(() => { throw new Error('fail'); }).catch(err => console.error(err)); // 捕获同步异常
+   * ```
    */
   static toPromise<T>(fn: () => T | Promise<T>): Promise<T>;
 }
@@ -568,8 +705,23 @@ declare class MimeUtil {
     readonly CSV: "text/csv"; /** 制表符分隔值文件 */
     readonly TSV: "text/tab-separated-values"; /** XML 文档 */
     readonly XML: "text/xml"; /** XHTML 文档（XML 严格格式的 HTML） */
-    readonly XHTML: "application/xhtml+xml"; /** JavaScript 脚本文件（标准推荐） */
-    readonly JS: "text/javascript"; /** Markdown 格式文档 */
+    readonly XHTML: "application/xhtml+xml"; /** JavaScript 文件 */
+    readonly JS: "text/javascript"; /** TypeScript 文件 */
+    readonly TS: "text/typescript"; /** Python 文件 */
+    readonly PY: "text/x-python"; /** Shell 脚本 (.sh) */
+    readonly SH: "text/x-sh"; /** C 语言源文件 */
+    readonly C: "text/x-c"; /** C++ 源文件 */
+    readonly CPP: "text/x-c++"; /** C# 源文件 */
+    readonly CSHARP: "text/x-csharp"; /** Java 源文件 */
+    readonly JAVA: "text/x-java"; /** Go 源文件 */
+    readonly GO: "text/x-go"; /** Rust 源文件 */
+    readonly RUST: "text/x-rust"; /** PHP 文件 */
+    readonly PHP: "text/x-php"; /** Ruby 文件 */
+    readonly RUBY: "text/x-ruby"; /** Swift 源文件 */
+    readonly SWIFT: "text/x-swift"; /** YAML 文档 */
+    readonly YAML: "text/vnd.yaml"; /** TOML 文档 */
+    readonly TOML: "text/x-toml"; /** SQL 脚本 */
+    readonly SQL: "text/x-sql"; /** Markdown 格式文档 */
     readonly MARKDOWN: "text/markdown"; /** 富文本格式文档（.rtf） */
     readonly RTF: "application/rtf"; /** iCalendar 日历格式（.ics） */
     readonly CALENDAR: "text/calendar"; /** JPEG 图像（.jpg/.jpeg） */
@@ -581,7 +733,10 @@ declare class MimeUtil {
     readonly APNG: "image/apng"; /** AVIF 图像（高效压缩） */
     readonly AVIF: "image/avif"; /** 图标文件格式（.ico） */
     readonly ICO: "image/vnd.microsoft.icon"; /** WebP 图像（高效压缩） */
-    readonly WEBP: "image/webp"; /** MP3 音频（.mp3） */
+    readonly WEBP: "image/webp"; /** TIFF 图像（.tif/.tiff） */
+    readonly TIFF: "image/tiff"; /** HEIC 图像（高效编码） */
+    readonly HEIC: "image/heic"; /** Adobe Photoshop 文件（.psd） */
+    readonly PSD: "image/vnd.adobe.photoshop"; /** MP3 音频（.mp3） */
     readonly MP3: "audio/mpeg"; /** AAC 音频（.aac） */
     readonly AAC: "audio/aac"; /** MIDI 音乐文件（.mid/.midi） */
     readonly MIDI: "audio/midi"; /** OGG 音频（.oga） */
@@ -615,13 +770,18 @@ declare class MimeUtil {
     readonly TAR: "application/x-tar"; /** BZip 归档（.bz） */
     readonly BZIP: "application/x-bzip"; /** BZip2 归档（.bz2） */
     readonly BZIP2: "application/x-bzip2"; /** 7-Zip 压缩文件（.7z） */
-    readonly SEVEN_Z: "application/x-7z-compressed"; /** 通用二进制数据（默认类型） */
+    readonly SEVEN_Z: "application/x-7z-compressed"; /** RAR 压缩文件（.rar） */
+    readonly RAR: "application/vnd.rar"; /** 通用二进制数据（默认类型） */
     readonly OCTET_STREAM: "application/octet-stream"; /** JSON 数据格式（.json） */
     readonly JSON: "application/json"; /** JSON-LD 格式（.jsonld） */
     readonly LD_JSON: "application/ld+json"; /** Java 归档文件（.jar） */
-    readonly JAR: "application/java-archive"; /** MS 嵌入式 OpenType 字体（.eot） */
+    readonly JAR: "application/java-archive"; /** WebAssembly 二进制指令格式（.wasm） */
+    readonly WASM: "application/wasm"; /** MS 嵌入式 OpenType 字体（.eot） */
     readonly EOT: "application/vnd.ms-fontobject"; /** OpenType 字体（.otf） */
-    readonly OTF: "font/otf"; /** Excel 97-2003 工作簿（.xls） */
+    readonly OTF: "font/otf"; /** WOFF 字体（.woff） */
+    readonly WOFF: "font/woff"; /** WOFF2 字体（.woff2） */
+    readonly WOFF2: "font/woff2"; /** TrueType 字体（.ttf） */
+    readonly TTF: "font/ttf"; /** Excel 97-2003 工作簿（.xls） */
     readonly XLS: "application/vnd.ms-excel"; /** Microsoft XPS 文档（.xps） */
     readonly XPS: "application/vnd.ms-xpsdocument"; /** Word 启用宏文档（.docm） */
     readonly DOCM: "application/vnd.ms-word.document.macroEnabled.12";
@@ -650,7 +810,7 @@ declare class NumberUtil {
   static within(input: number, interval: [number, number], includeLeft?: boolean, includeRight?: boolean): boolean;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/typed-array.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/typed-array.d.ts
 /**
 Matches any [typed array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray), like `Uint8Array` or `Float64Array`.
 
@@ -658,7 +818,24 @@ Matches any [typed array](https://developer.mozilla.org/en-US/docs/Web/JavaScrip
 */
 type TypedArray = Int8Array | Uint8Array | Uint8ClampedArray | Int16Array | Uint16Array | Int32Array | Uint32Array | Float32Array | Float64Array | BigInt64Array | BigUint64Array;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/union-to-intersection.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/characters.d.ts
+/**
+Matches any digit as a string ('0'-'9').
+
+@example
+```
+import type {DigitCharacter} from 'type-fest';
+
+const a: DigitCharacter = '0'; // Valid
+// @ts-expect-error
+const b: DigitCharacter = 0; // Invalid
+```
+
+@category Type
+*/
+type DigitCharacter = '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9';
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/union-to-intersection.d.ts
 /**
 Convert a union type to an intersection type.
 
@@ -687,7 +864,7 @@ Union extends unknown // The union type is used as the only argument to a functi
 ) extends ((mergedIntersection: infer Intersection) => void) // The `& Union` is to ensure result of `UnionToIntersection<A | B>` is always assignable to `A | B`
 ? Intersection & Union : never;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/keys-of-union.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/keys-of-union.d.ts
 /**
 Create a union of all keys from a given type, even those exclusive to specific union members.
 
@@ -728,7 +905,7 @@ type AllKeys = KeysOfUnion<Union>;
 type KeysOfUnion<ObjectType> = // Hack to fix https://github.com/sindresorhus/type-fest/issues/1008
 keyof UnionToIntersection<ObjectType extends unknown ? Record<keyof ObjectType, never> : never>;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/is-any.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/is-any.d.ts
 /**
 Returns a boolean for whether the given type is `any`.
 
@@ -759,7 +936,7 @@ const anyA = get(anyObject, 'a');
 */
 type IsAny<T> = 0 extends 1 & NoInfer<T> ? true : false;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/is-optional-key-of.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/is-optional-key-of.d.ts
 /**
 Returns a boolean for whether the given key is an optional key of type.
 
@@ -802,7 +979,7 @@ type T5 = IsOptionalKeyOf<User | Admin, 'surname'>;
 */
 type IsOptionalKeyOf<Type extends object, Key extends keyof Type> = IsAny<Type | Key> extends true ? never : Key extends keyof Type ? Type extends Record<Key, Type[Key]> ? false : true : false;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/optional-keys-of.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/optional-keys-of.d.ts
 /**
 Extract all optional keys from the given type.
 
@@ -840,7 +1017,7 @@ type OptionalKeysOf<Type extends object> = Type extends unknown // For distribut
 ? (keyof { [Key in keyof Type as IsOptionalKeyOf<Type, Key> extends false ? never : Key]: never }) & keyof Type // Intersect with `keyof Type` to ensure result of `OptionalKeysOf<Type>` is always assignable to `keyof Type`
 : never;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/required-keys-of.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/required-keys-of.d.ts
 /**
 Extract all required keys from the given type.
 
@@ -874,7 +1051,7 @@ const validator3 = createValidation<User>('luckyNumber', value => value > 0);
 type RequiredKeysOf<Type extends object> = Type extends unknown // For distributing `Type`
 ? Exclude<keyof Type, OptionalKeysOf<Type>> : never;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/is-never.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/is-never.d.ts
 /**
 Returns a boolean for whether the given type is `never`.
 
@@ -930,7 +1107,7 @@ type B = IsTrueFixed<never>;
 */
 type IsNever<T> = [T] extends [never] ? true : false;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/if.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/if.d.ts
 /**
 An if-else-like type that resolves depending on whether the given `boolean` type is `true` or `false`.
 
@@ -1025,7 +1202,7 @@ type Works = IncludesWithoutIf<HundredZeroes, '1'>;
 */
 type If<Type extends boolean, IfBranch, ElseBranch> = IsNever<Type> extends true ? ElseBranch : Type extends true ? IfBranch : ElseBranch;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/unknown-array.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/unknown-array.d.ts
 /**
 Represents an array with `unknown` value.
 
@@ -1052,7 +1229,7 @@ type C = IsArray<string>;
 */
 type UnknownArray = readonly unknown[];
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/internal/type.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/internal/type.d.ts
 /**
 Returns a boolean for whether A is false.
 
@@ -1116,7 +1293,7 @@ Indicates the value of `exactOptionalPropertyTypes` compiler option.
 */
 type IsExactOptionalPropertyTypesEnabled = [(string | undefined)?] extends [string?] ? false : true;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/internal/array.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/internal/array.d.ts
 /**
 Transforms a tuple type by replacing it's rest element with a single element that has the same type as the rest element, while keeping all the non-rest elements intact.
 
@@ -1158,7 +1335,7 @@ type _CollapseRestElement<TArray extends UnknownArray, ForwardAccumulator extend
 : First], BackwardAccumulator> : never // Should never happen, since `[(infer First)?, ...infer Rest]` is a top-type for arrays.
 : never; // Should never happen
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/numeric.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/numeric.d.ts
 type _Numeric = number | bigint;
 type Zero = 0 | 0n;
 /**
@@ -1203,7 +1380,7 @@ type IsNegative<T extends _Numeric> = T extends Negative<T> ? true : false;
 //#region ../../node_modules/.pnpm/tagged-tag@1.0.0/node_modules/tagged-tag/index.d.ts
 declare const tag: unique symbol;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/tagged.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/tagged.d.ts
 // eslint-disable-next-line type-fest/require-exported-types
 type TagContainer<Token> = {
   readonly [tag]: Token;
@@ -1375,7 +1552,7 @@ type Person = {
 @deprecated Use {@link Tagged} instead
 */
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/is-literal.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/is-literal.d.ts
 /**
 Returns a boolean for whether the given type is a `string` [literal type](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#literal-types).
 
@@ -1437,7 +1614,7 @@ type _IsStringLiteral<S> = // If `T` is an infinite string type (e.g., `on${stri
 // and since `{}` extends index signatures, the result becomes `false`.
 S extends string ? {} extends Record<S, never> ? false : true : false;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/tuple-of.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/tuple-of.d.ts
 /**
 Create a tuple type of the specified length with elements of the specified type.
 
@@ -1465,7 +1642,7 @@ type ZeroToFour = Range<0, 5>;
 //=> '0' | '1' | '2' | '3' | '4'
 
 type ThreeToEight = Range<3, 9>;
-//=> '5' | '3' | '4' | '6' | '7' | '8'
+//=> '3' | '4' | '5' | '6' | '7' | '8'
 ```
 
 Note: If the specified length is the non-literal `number` type, the result will not be a tuple but a regular array.
@@ -1498,14 +1675,27 @@ type EmptyTuple = TupleOf<-3, string>;
 //=> []
 ```
 
+Note: If the specified length has a decimal part, the decimal part will be ignored.
+
+@example
+```
+import type {TupleOf} from 'type-fest';
+
+type DecimalLength = TupleOf<3.5, string>;
+//=> [string, string, string]
+```
+
 Note: If you need a readonly tuple, simply wrap this type with `Readonly`, for example, to create `readonly [number, number, number]` use `Readonly<TupleOf<3, number>>`.
 
 @category Array
 */
-type TupleOf<Length extends number, Fill = unknown> = IfNotAnyOrNever<Length, _TupleOf<If<IsNegative<Length>, 0, Length>, Fill, []>, Fill[], []>;
-type _TupleOf<L extends number, Fill, Accumulator extends UnknownArray> = number extends L ? Fill[] : L extends Accumulator['length'] ? Accumulator : _TupleOf<L, Fill, [...Accumulator, Fill]>;
+type TupleOf<Length extends number, Fill = unknown> = IfNotAnyOrNever<Length, _TupleOf<If<IsNegative<Length>, 0, Length>, Fill>, Fill[], []>;
+type _TupleOf<Length extends number, Fill> = number extends Length ? Fill[] : BuildTupleDigitByDigit<`${Length}`, Fill>;
+type BuildTupleDigitByDigit<Length extends string, Fill, Accumulator extends UnknownArray = []> = Length extends `${infer First extends DigitCharacter}${infer Rest}` ? BuildTupleDigitByDigit<Rest, Fill, [...RepeatTupleTenTimes<Accumulator>, ...DigitTupleOf<First, Fill>]> : Accumulator;
+type RepeatTupleTenTimes<Tuple extends UnknownArray> = [...Tuple, ...Tuple, ...Tuple, ...Tuple, ...Tuple, ...Tuple, ...Tuple, ...Tuple, ...Tuple, ...Tuple];
+type DigitTupleOf<Digit extends DigitCharacter, Fill> = [[], [Fill], [Fill, Fill], [Fill, Fill, Fill], [Fill, Fill, Fill, Fill], [Fill, Fill, Fill, Fill, Fill], [Fill, Fill, Fill, Fill, Fill, Fill], [Fill, Fill, Fill, Fill, Fill, Fill, Fill], [Fill, Fill, Fill, Fill, Fill, Fill, Fill, Fill], [Fill, Fill, Fill, Fill, Fill, Fill, Fill, Fill, Fill]][Digit];
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/simplify.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/simplify.d.ts
 /**
 Useful to flatten the type output to improve type hints shown in editors. And also to transform an interface into a type to aide with assignability.
 
@@ -1566,7 +1756,7 @@ fn(someInterface as Simplify<SomeInterface>); // Good: transform an `interface`
 */
 type Simplify<T> = { [KeyType in keyof T]: T[KeyType] } & {};
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/is-equal.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/is-equal.d.ts
 /**
 Returns a boolean for whether the two given types are equal.
 
@@ -1597,7 +1787,7 @@ type IsEqual<A, B> = [A] extends [B] ? [B] extends [A] ? _IsEqual<A, B> : false
 // This version fails the `equalWrappedTupleIntersectionToBeNeverAndNeverExpanded` test in `test-d/is-equal.ts`.
 type _IsEqual<A, B> = (<G>() => G extends A & G | G ? 1 : 2) extends (<G>() => G extends B & G | G ? 1 : 2) ? true : false;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/omit-index-signature.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/omit-index-signature.d.ts
 /**
 Omit any index signatures from the given object type, leaving only explicitly defined properties.
 
@@ -1691,7 +1881,7 @@ type ExampleWithoutIndexSignatures = OmitIndexSignature<Example>;
 */
 type OmitIndexSignature<ObjectType> = { [KeyType in keyof ObjectType as {} extends Record<KeyType, unknown> ? never : KeyType]: ObjectType[KeyType] };
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/pick-index-signature.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/pick-index-signature.d.ts
 /**
 Pick only index signatures from the given object type, leaving out all explicitly defined properties.
 
@@ -1739,7 +1929,7 @@ type ExampleIndexSignature = PickIndexSignature<Example>;
 */
 type PickIndexSignature<ObjectType> = { [KeyType in keyof ObjectType as {} extends Record<KeyType, unknown> ? KeyType : never]: ObjectType[KeyType] };
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/merge.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/merge.d.ts
 // Merges two objects without worrying about index signatures.
 type SimpleMerge<Destination, Source> = Simplify<{ [Key in keyof Destination as Key extends keyof Source ? never : Key]: Destination[Key] } & Source>;
 /**
@@ -1811,7 +2001,7 @@ type Merge<Destination, Source> = Destination extends unknown // For distributin
 // Should never happen
 type _Merge<Destination, Source> = Simplify<SimpleMerge<PickIndexSignature<Destination>, PickIndexSignature<Source>> & SimpleMerge<OmitIndexSignature<Destination>, OmitIndexSignature<Source>>>;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/internal/object.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/internal/object.d.ts
 /**
 Works similar to the built-in `Pick` utility type, except for the following differences:
 - Distributes over union types and allows picking keys from any member of the union type.
@@ -1902,8 +2092,9 @@ type Result = ApplyDefaultOptions<PathsOptions, DefaultPathsOptions, SpecifiedOp
 // Types of property 'leavesOnly' are incompatible. Type 'string' is not assignable to type 'boolean'.
 ```
 */
-type ApplyDefaultOptions<Options extends object, Defaults extends Simplify<Omit<Required<Options>, RequiredKeysOf<Options>> & Partial<Record<RequiredKeysOf<Options>, never>>>, SpecifiedOptions extends Options> = If<IsAny<SpecifiedOptions>, Defaults, If<IsNever<SpecifiedOptions>, Defaults, Simplify<Merge<Defaults, { [Key in keyof SpecifiedOptions as Key extends OptionalKeysOf<Options> ? undefined extends SpecifiedOptions[Key] ? never : Key : Key]: SpecifiedOptions[Key] }> & Required<Options>>>>;
-// `& Required<Options>` ensures that `ApplyDefaultOptions<SomeOption, ...>` is always assignable to `Required<SomeOption>`
+type ApplyDefaultOptions<Options extends object, Defaults extends Simplify<Omit<Required<Options>, RequiredKeysOf<Options>> & Partial<Record<RequiredKeysOf<Options>, never>>>, SpecifiedOptions extends Options> = _ApplyDefaultOptions<Options, Defaults, SpecifiedOptions> extends infer Result extends Required<Options> // `extends Required<Options>` ensures that `ApplyDefaultOptions<SomeOption, ...>` is always assignable to `Required<SomeOption>`
+? Result : never;
+type _ApplyDefaultOptions<Options, Defaults, SpecifiedOptions> = If<IsAny<SpecifiedOptions>, Defaults, If<IsNever<SpecifiedOptions>, Defaults, Merge<Defaults, { [Key in keyof SpecifiedOptions as undefined extends Required<Options>[Key & keyof Options] ? Key : undefined extends SpecifiedOptions[Key] ? never : Key]: SpecifiedOptions[Key] }>>>;
 /**
 Collapses literal types in a union into their corresponding primitive types, when possible. For example, `CollapseLiterals<'foo' | 'bar' | (string & {})>` returns `string`.
 
@@ -1933,7 +2124,7 @@ type E = CollapseLiterals<LiteralUnion<'foo' | 'bar', string> | null | undefined
 */
 type CollapseLiterals<T> = {} extends T ? T : T extends infer U & {} ? U : T;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/some-extend.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/some-extend.d.ts
 /**
 @see {@link SomeExtend}
 */
@@ -2015,7 +2206,7 @@ type SomeExtend<TArray extends UnknownArray, Type, Options extends SomeExtendOpt
 type _SomeExtend<TArray extends UnknownArray, Type, Options extends Required<SomeExtendOptions>> = IfNotAnyOrNever<TArray, TArray extends readonly [infer First, ...infer Rest] ? IsNever<First> extends true ? Or<Or<IsNever<Type>, IsAny<Type>>, Not<Options['strictNever']>> extends true // If target `Type` is also `never`, or is `any`, or `strictNever` is disabled, return `true`.
 ? true : _SomeExtend<Rest, Type, Options> : First extends Type ? true : _SomeExtend<Rest, Type, Options> : false, false, false>;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/or-all.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/or-all.d.ts
 /**
 Returns a boolean for whether any of the given elements is `true`.
 
@@ -2086,7 +2277,7 @@ Note: `OrAll<[]>` evaluates to `false` because there are no `true` elements in a
 */
 type OrAll<T extends readonly boolean[]> = SomeExtend<T, true>;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/or.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/or.d.ts
 /**
 Returns a boolean for whether either of two given types is `true`.
 
@@ -2166,7 +2357,7 @@ type G = Or<never, never>;
 */
 type Or<A extends boolean, B extends boolean> = OrAll<[A, B]>;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/all-extend.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/all-extend.d.ts
 /**
 @see {@link AllExtend}
 */
@@ -2252,7 +2443,7 @@ type AllExtend<TArray extends UnknownArray, Type, Options extends AllExtendOptio
 type _AllExtend<TArray extends UnknownArray, Type, Options extends Required<AllExtendOptions>> = IfNotAnyOrNever<TArray, TArray extends readonly [infer First, ...infer Rest] ? IsNever<First> extends true ? Or<Or<IsNever<Type>, IsAny<Type>>, Not<Options['strictNever']>> extends true // If target `Type` is also `never`, or is `any`, or `strictNever` is disabled, recurse further.
 ? _AllExtend<Rest, Type, Options> : false : First extends Type ? _AllExtend<Rest, Type, Options> : false : true, false, false>;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/and-all.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/and-all.d.ts
 /**
 Returns a boolean for whether all of the given elements are `true`.
 
@@ -2326,7 +2517,7 @@ Note: `AndAll<[]>` evaluates to `true` due to the concept of [vacuous truth](htt
 */
 type AndAll<T extends readonly boolean[]> = AllExtend<T, true>;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/and.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/and.d.ts
 /**
 Returns a boolean for whether two given types are both `true`.
 
@@ -2406,7 +2597,7 @@ type G = And<never, never>;
 */
 type And<A extends boolean, B extends boolean> = AndAll<[A, B]>;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/except.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/except.d.ts
 /**
 Filter out keys from an object.
 
@@ -2504,7 +2695,7 @@ type PostPayloadFixed = Except<UserData, 'email'>;
 type Except<ObjectType, KeysType extends keyof ObjectType, Options extends ExceptOptions = {}> = _Except<ObjectType, KeysType, ApplyDefaultOptions<ExceptOptions, DefaultExceptOptions, Options>>;
 type _Except<ObjectType, KeysType extends keyof ObjectType, Options extends Required<ExceptOptions>> = { [KeyType in keyof ObjectType as Filter<KeyType, KeysType>]: ObjectType[KeyType] } & (Options['requireExactProps'] extends true ? Partial<Record<KeysType, never>> : {});
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/exclude-exactly.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/exclude-exactly.d.ts
 /**
 A stricter version of `Exclude<T, U>` that excludes types only when they are exactly identical.
 
@@ -2542,7 +2733,7 @@ type _ExcludeExactly<Union, Delete> = IfNotAnyOrNever<Delete, Union extends unkn
 // because `Union` cannot be `any` or `never` here.
 Union, Union>;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/union-member.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/union-member.d.ts
 /**
 Returns an arbitrary member of a union type.
 
@@ -2599,7 +2790,7 @@ type LastNever = UnionMember<never>;
 */
 type UnionMember<T> = IsNever<T> extends true ? never : UnionToIntersection<T extends any ? () => T : never> extends (() => (infer R)) ? R : never;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/union-to-tuple.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/union-to-tuple.d.ts
 /**
 Convert a union type into an unordered tuple type of its elements.
 
@@ -2639,7 +2830,7 @@ type UnionToTuple<Union> = _UnionToTuple<Union> extends infer Result extends Unk
 // Nudges the compiler that `UnionToTuple` always yields an array.
 type _UnionToTuple<Union, Accumulator extends UnknownArray = [], Member = UnionMember<Union>> = IsNever<Union> extends true ? Accumulator : _UnionToTuple<ExcludeExactly<Union, Member>, [Member, ...Accumulator]>;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/set-optional.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/set-optional.d.ts
 /**
 Create a type that makes the given keys optional, while keeping the remaining keys as is.
 
@@ -2667,7 +2858,7 @@ type _SetOptional<BaseType, Keys extends keyof BaseType> = BaseType extends unkn
 Except<BaseType, Keys> // Pick the keys that should be mutable from the base type and make them mutable.
 & Partial<HomomorphicPick<BaseType, Keys>>> : never;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/value-of.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/value-of.d.ts
 /**
 Create a union of the given object's values, and optionally specify which keys to get the values from.
 
@@ -2691,7 +2882,7 @@ type C = ValueOf<{id: number; name: string; active: boolean}, 'id' | 'name'>;
 */
 type ValueOf<ObjectType, ValueType extends keyof ObjectType = keyof ObjectType> = ObjectType[ValueType];
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/split.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/split.d.ts
 /**
 Split options.
 
@@ -2748,7 +2939,7 @@ type SplitHelper<S extends string, Delimiter extends string, Options extends Req
 : string[] : never // Should never happen
 : never; // Should never happen
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/replace.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/replace.d.ts
 type ReplaceOptions = {
   all?: boolean;
 };
@@ -3304,7 +3495,18 @@ declare class ObjectUtil {
    * @returns 键数组
    * @example
    * ```ts
+   * // 重载 1: string
+   * ObjectUtil.keys("abc"); // ["0", "1", "2"]
+   *
+   * // 重载 2: ArrayLike
+   * ObjectUtil.keys([10, 20]); // ["0", "1"]
+   *
+   * // 重载 3: PlainObject
    * ObjectUtil.keys({ a: 1, b: 2 }); // ["a", "b"]
+   *
+   * // 重载 4: AnyObject
+   * const anyObj = { x: 1, y: 2 } as Record<string, unknown>;
+   * ObjectUtil.keys(anyObj); // ["x", "y"]
    * ```
    */
   static keys<const S extends string>(string: S): UnionToTuple<Range<0, Split<S, "">["length"]>>;
@@ -3318,7 +3520,18 @@ declare class ObjectUtil {
    * @returns 值数组
    * @example
    * ```ts
+   * // 重载 1: string
+   * ObjectUtil.values("abc"); // ["a", "b", "c"]
+   *
+   * // 重载 2: ArrayLike
+   * ObjectUtil.values([10, 20]); // [10, 20]
+   *
+   * // 重载 3: PlainObject
    * ObjectUtil.values({ a: 1, b: 2 }); // [1, 2]
+   *
+   * // 重载 4: AnyObject
+   * const anyObj = { x: 1, y: 2 } as Record<string, unknown>;
+   * ObjectUtil.values(anyObj); // [1, 2]
    * ```
    */
   static values<S extends string>(string: S): Split<S, "">;
@@ -3332,7 +3545,18 @@ declare class ObjectUtil {
    * @returns 键值对数组
    * @example
    * ```ts
+   * // 重载 1: string
+   * ObjectUtil.entries("ab"); // [["0", "a"], ["1", "b"]]
+   *
+   * // 重载 2: readonly array
+   * ObjectUtil.entries([10, 20] as const); // [["0", 10], ["1", 20]]
+   *
+   * // 重载 3: PlainObject
    * ObjectUtil.entries({ a: 1 }); // [["a", 1]]
+   *
+   * // 重载 4: AnyObject
+   * const anyObj = { x: 1 } as Record<string, unknown>;
+   * ObjectUtil.entries(anyObj); // [["x", 1]]
    * ```
    */
   static entries<const S extends string>(string: S): TupleToEntries<Split<S, "">>;
@@ -3349,7 +3573,10 @@ declare class ObjectUtil {
    * @example
    * ```ts
    * const obj = { a: 1, b: 2 };
+   *
    * ObjectUtil.entriesMap(obj, (k, v) => [k, v * 2]); // { a: 2, b: 4 }
+   *
+   * ObjectUtil.entriesMap(obj, (k, v) => [`prefix_${String(k)}`, `${v}x`]); // { prefix_a: "1x", prefix_b: "2x" }
    * ```
    */
   static entriesMap<O extends PlainObject, NK extends PropertyKey, NV>(plainObject: O, toEntry: (key: keyof O, value: O[keyof O]) => [NK, NV]): PlainObject<NK, NV>;
@@ -3361,7 +3588,12 @@ declare class ObjectUtil {
    * @returns 包含指定属性的新对象
    * @example
    * ```ts
+   * // 重载 1: PlainObject
    * ObjectUtil.pick({ a: 1, b: 2 }, ["a"]); // { a: 1 }
+   *
+   * // 重载 2: AnyObject
+   * const anyObj = { x: 1, y: 2 } as Record<string, unknown>;
+   * ObjectUtil.pick(anyObj, ["x"]); // { x: 1 }
    * ```
    */
   static pick<O extends PlainObject, K extends keyof O>(plainObject: O, keys: readonly K[]): Pick<O, K>;
@@ -3374,7 +3606,12 @@ declare class ObjectUtil {
    * @returns 排除指定属性后的新对象
    * @example
    * ```ts
+   * // 重载 1: PlainObject
    * ObjectUtil.omit({ a: 1, b: 2 }, ["a"]); // { b: 2 }
+   *
+   * // 重载 2: AnyObject
+   * const anyObj = { x: 1, y: 2 } as Record<string, unknown>;
+   * ObjectUtil.omit(anyObj, ["x"]); // { y: 2 }
    * ```
    */
   static omit<O extends PlainObject, K extends keyof O>(plainObject: O, keys: readonly K[]): Omit<O, K>;
@@ -3386,8 +3623,13 @@ declare class ObjectUtil {
    * @returns 键值互换后的对象
    * @example
    * ```ts
+   * // 重载 1: Record<keyof O, PropertyKey>
    * const obj = { a: "1", b: 2 };
    * ObjectUtil.invert(obj); // { "1": "a", 2: "b" }
+   *
+   * // 重载 2: AnyObject
+   * const anyObj = { x: Symbol.for("s"), y: true } as Record<string, unknown>;
+   * ObjectUtil.invert(anyObj); // { [Symbol.for("s")]: "x" }
    * ```
    */
   static invert<const O extends Record<keyof O, PropertyKey>>(plainObject: O): Invert<O>;
@@ -3400,8 +3642,13 @@ declare class ObjectUtil {
    * @returns 压平后的对象
    * @example
    * ```ts
-   * const obj = { a: { b: 1 } };
-   * ObjectUtil.crush(obj); // { "a.b": 1 }
+   * // 重载 1: PlainObject
+   * const plainObj = { a: { b: 1 } };
+   * ObjectUtil.crush(plainObj); // { "a.b": 1 }
+   *
+   * // 重载 2: AnyObject
+   * const anyObj = { list: [{ id: 1 }] } as Record<string, unknown>;
+   * ObjectUtil.crush(anyObj); // { "list.0.id": 1 }
    * ```
    */
   static crush<T extends PlainObject>(plainObject: T): Crush<T>;
@@ -3413,8 +3660,14 @@ declare class ObjectUtil {
    * @returns 键数组
    * @example
    * ```ts
-   * enum A { k = "v" }
-   * ObjectUtil.enumKeys(A); // ["k"]
+   * // 重载 1: PlainObject
+   * enum StringEnum { A = "a", B = "b" }
+   * ObjectUtil.enumKeys(StringEnum); // ["A", "B"]
+   *
+   * // 重载 2: AnyObject
+   * enum NumberEnum { A, B }
+   * const anyEnum = NumberEnum as Record<string, unknown>;
+   * ObjectUtil.enumKeys(anyEnum); // ["A", "B"]
    * ```
    */
   static enumKeys<E extends PlainObject>(enumeration: E): (keyof E)[];
@@ -3426,8 +3679,14 @@ declare class ObjectUtil {
    * @returns 值数组
    * @example
    * ```ts
-   * enum A { k = "v" }
-   * ObjectUtil.enumValues(A); // ["v"]
+   * // 重载 1: PlainObject
+   * enum StringEnum { A = "a", B = "b" }
+   * ObjectUtil.enumValues(StringEnum); // ["a", "b"]
+   *
+   * // 重载 2: AnyObject
+   * enum NumberEnum { A, B }
+   * const anyEnum = NumberEnum as Record<string, unknown>;
+   * ObjectUtil.enumValues(anyEnum); // [0, 1]
    * ```
    */
   static enumValues<E extends PlainObject>(enumeration: E): UnionToTuple<ValueOf<E>>;
@@ -3439,8 +3698,14 @@ declare class ObjectUtil {
    * @returns 键值对数组
    * @example
    * ```ts
-   * enum A { k = "v" }
-   * ObjectUtil.enumEntries(A); // [["k", "v"]]
+   * // 重载 1: PlainObject
+   * enum StringEnum { A = "a", B = "b" }
+   * ObjectUtil.enumEntries(StringEnum); // [["A", "a"], ["B", "b"]]
+   *
+   * // 重载 2: AnyObject
+   * enum NumberEnum { A, B }
+   * const anyEnum = NumberEnum as Record<string, unknown>;
+   * ObjectUtil.enumEntries(anyEnum); // [["A", 0], ["B", 1]]
    * ```
    */
   static enumEntries<E extends PlainObject>(enumeration: E): [keyof E, E[keyof E]][];
@@ -3452,6 +3717,39 @@ declare class ObjectUtil {
  * 字符串工具类
  */
 declare class StringUtil {
+  /**
+   * 将任意值转换为字符串
+   * - 当传入数值字面量时，返回对应的字符串字面量类型
+   *
+   * @param candidate 待转换的值
+   * @param checkEmpty 是否检查空值（`null` / `undefined` / 空白字符串），默认为 `true`
+   * @returns 转换后的字符串
+   * @example
+   * ```ts
+   * // 重载 1: null / undefined + checkEmpty = true (默认) → ""
+   * StringUtil.cast(null); // ""
+   * StringUtil.cast(undefined); // ""
+   * StringUtil.cast(""); // ""
+   * StringUtil.cast("   "); // ""
+   *
+   * // 重载 2: null / undefined + checkEmpty = false → "null" / "undefined"
+   * StringUtil.cast(null, false); // "null" (类型为 "null")
+   * StringUtil.cast(undefined, false); // "undefined" (类型为 "undefined")
+   *
+   * // 重载 3: 原始类型 → 字符串字面量类型
+   * StringUtil.cast(123); // "123" (类型为 "123")
+   * StringUtil.cast("hello"); // "hello" (类型为 "hello")
+   * StringUtil.cast(true); // "true" (类型为 "true")
+   * StringUtil.cast(42n); // "42" (类型为 "42")
+   *
+   * // 重载 4: 其他类型 → string
+   * StringUtil.cast(Symbol("foo")); // "Symbol(foo)" (类型为 string)
+   * ```
+   */
+  static cast<T extends null | undefined>(candidate: T, checkEmpty?: true): "";
+  static cast<T extends null | undefined>(candidate: T, checkEmpty: false): `${T}`;
+  static cast<T extends string | number | bigint | boolean>(candidate: T, checkEmpty?: boolean): `${T}`;
+  static cast(candidate: unknown, checkEmpty?: boolean): string;
   /**
    * 从字符串中提取数字字符串
    * - 移除非数字字符，保留符号和小数点
@@ -3474,7 +3772,10 @@ declare class StringUtil {
    * @returns 转换后的小写字符串类型，如果输入无效则返回空字符串类型 ""
    * @example
    * ```ts
+   * // 重载 1: 输入 string
    * StringUtil.toLowerCase("HELLO"); // "hello"
+   *
+   * // 重载 2: 输入 unknown
    * StringUtil.toLowerCase(null); // ""
    * ```
    */
@@ -3489,7 +3790,10 @@ declare class StringUtil {
    * @returns 转换后的大写字符串，如果输入无效则返回空字符串
    * @example
    * ```ts
+   * // 重载 1: 输入 string
    * StringUtil.toUpperCase("hello"); // "HELLO"
+   *
+   * // 重载 2: 输入 unknown
    * StringUtil.toUpperCase(null); // ""
    * ```
    */
@@ -3543,8 +3847,12 @@ declare class StringUtil {
    * @returns 解析后的对象 或 回退值
    * @example
    * ```ts
-   * StringUtil.toJson('{"a": 1}', {}); // { a: 1 }
-   * StringUtil.toJson('invalid', {}); // {}
+   * // 重载 1: 无 fallback
+   * StringUtil.toJson<{ a: number }>("{\"a\":1}"); // { a: 1 }
+   * StringUtil.toJson("invalid"); // undefined
+   *
+   * // 重载 2: 有 fallback
+   * StringUtil.toJson<{ a: number }>("invalid", { a: 0 }); // { a: 0 }
    * ```
    */
   static toJson<D extends AnyObject = AnyObject>(input: string | null | undefined): D | undefined;
@@ -3559,7 +3867,10 @@ declare class StringUtil {
    * @returns 分割后的数组
    * @example
    * ```ts
+   * // 重载 1: valueType = "number" (默认)
    * StringUtil.toValues("1,2,3"); // [1, 2, 3]
+   *
+   * // 重载 2: valueType = "string"
    * StringUtil.toValues("a-b-c", "string", "-"); // ["a", "b", "c"]
    * ```
    */
@@ -3627,10 +3938,28 @@ declare class StringUtil {
  * 主题工具类
  */
 declare class ThemeUtil {
+  /**
+   * 固定主题类型（仅亮色/暗色）
+   *
+   * @example
+   * ```ts
+   * ThemeUtil.THEME.LIGHT; // "light"
+   * ThemeUtil.THEME.DARK; // "dark"
+   * ```
+   */
   static readonly THEME: {
     readonly LIGHT: "light";
     readonly DARK: "dark";
   };
+  /**
+   * 主题模式（支持跟随系统）
+   *
+   * @example
+   * ```ts
+   * ThemeUtil.THEME_MODE.SYSTEM; // "system"
+   * ThemeUtil.THEME_MODE.DARK; // "dark"
+   * ```
+   */
   static readonly THEME_MODE: {
     readonly LIGHT: "light";
     readonly DARK: "dark";
@@ -3748,8 +4077,12 @@ declare class TreeUtil {
    * @example
    * ```ts
    * const tree = [{ id: 1, visible: true, children: [{ id: 2, visible: false }] }];
-   * TreeUtil.filter(tree, (node) => node.visible);
-   * // [{ id: 1, visible: true, children: [] }]
+   *
+   * // 重载 1: 传入树数组
+   * TreeUtil.filter(tree, (node) => node.visible); // [{ id: 1, visible: true, children: [] }]
+   *
+   * // 重载 2: 传入单个树节点
+   * TreeUtil.filter(tree[0], (node) => node.visible); // { id: 1, visible: true, children: [] }
    * ```
    */
   static filter<T extends AnyObject, CK extends string = ChildrenKey>(tree: T[], callback: TreeFilterCallback<T>, options?: TreeFilterOptions<T, CK>): T[];
@@ -3765,8 +4098,14 @@ declare class TreeUtil {
    * @example
    * ```ts
    * const tree = [{ id: 1, val: 10, children: [{ id: 2, val: 20 }] }];
+   *
+   * // 重载 1: 传入树数组
    * TreeUtil.map(tree, (node) => ({ ...node, val: node.val * 2 }));
    * // [{ id: 1, val: 20, children: [{ id: 2, val: 40 }] }]
+   *
+   * // 重载 2: 传入单个树节点
+   * TreeUtil.map(tree[0], (node) => ({ ...node, val: node.val * 2 }));
+   * // { id: 1, val: 20, children: [{ id: 2, val: 40 }] }
    * ```
    */
   static map<R extends AnyObject, T extends AnyObject, CK extends string = ChildrenKey>(tree: T[], callback: TreeMapCallback<R, T>, options?: TreeMapOptions<T, CK>): TreeLike<R, CK>[];
@@ -3796,23 +4135,27 @@ declare class TypeUtil {
   private static isConstructable;
   /**
    * 检查 value 是否为 string 类型
+   * - 当 `checkEmpty` 为 `true` 时，会先 trim 再判断是否为空
    *
    * @param value 待检查值
-   * @param checkEmpty 是否检查空字符串
+   * @param checkEmpty 是否检查空字符串（含空白字符串），默认为 `false`
    * @returns 是否为字符串
    * @example
    * ```ts
    * TypeUtil.isString("abc"); // true
    * TypeUtil.isString(""); // true
    * TypeUtil.isString("", true); // false
+   * TypeUtil.isString("   ", true); // false
+   * TypeUtil.isString(" a ", true); // true
    * ```
    */
   static isString(value: unknown, checkEmpty?: boolean): value is string;
   /**
    * 检查 value 是否为 number 类型
+   * - 默认会调用 `TypeUtil.isNaN`（内部基于 `Number.isNaN`）过滤掉 `NaN`
    *
    * @param value 待检查值
-   * @param checkNaN 是否排除 `NaN`，默认为 `true`
+   * @param checkNaN 是否检查 `NaN`，默认为 `true`
    * @returns 是否为 number
    * @example
    * ```ts
@@ -3824,9 +4167,15 @@ declare class TypeUtil {
   static isNumber(value: unknown, checkNaN?: boolean): value is number;
   /**
    * 检查 value 是否为 NaN
+   * - 禁止使用全局 `isNaN`，其会先进行隐式数字转换，可能导致误判（例如 `isNaN("foo") === true`）
+   * - 使用 `Number.isNaN` 仅在值本身就是 `NaN` 时返回 `true`，语义更严格且更安全
    *
    * @param value 待检查值
    * @returns 是否为 NaN
+   * @example
+   * ```ts
+   * TypeUtil.isNaN(NaN); // true
+   * ```
    */
   static isNaN(value: unknown): value is number;
   /**
@@ -3835,6 +4184,11 @@ declare class TypeUtil {
    * @param value 待检查值
    * @param checkSafe 是否附加安全整数检查
    * @returns 是否为整数
+   * @example
+   * ```ts
+   * TypeUtil.isInteger(1); // true
+   * TypeUtil.isInteger(1.1); // false
+   * ```
    */
   static isInteger(value: unknown, checkSafe?: boolean): value is number;
   /**
@@ -3843,6 +4197,11 @@ declare class TypeUtil {
    *
    * @param value 待检查值
    * @param checkSafe 是否附加安全整数检查
+   * @example
+   * ```ts
+   * TypeUtil.isPositiveInteger(1); // true
+   * TypeUtil.isPositiveInteger(0); // false
+   * ```
    */
   static isPositiveInteger(value: unknown, checkSafe?: boolean): value is number;
   /**
@@ -3851,6 +4210,11 @@ declare class TypeUtil {
    *
    * @param value 待检查值
    * @param checkSafe 是否附加安全整数检查
+   * @example
+   * ```ts
+   * TypeUtil.isNegativeInteger(-1); // true
+   * TypeUtil.isNegativeInteger(0); // false
+   * ```
    */
   static isNegativeInteger(value: unknown, checkSafe?: boolean): value is number;
   /**
@@ -3858,6 +4222,11 @@ declare class TypeUtil {
    * - 排除 `NaN`
    *
    * @param value 待检查值
+   * @example
+   * ```ts
+   * TypeUtil.isInfinity(Infinity); // true
+   * TypeUtil.isInfinity(1); // false
+   * ```
    */
   static isInfinity(value: unknown): value is number;
   /**
@@ -3865,66 +4234,111 @@ declare class TypeUtil {
    * - 排除 `NaN`
    *
    * @param value 待检查值
+   * @example
+   * ```ts
+   * TypeUtil.isInfinityLike("Infinity"); // true
+   * TypeUtil.isInfinityLike("123"); // false
+   * ```
    */
   static isInfinityLike(value: unknown): boolean;
   /**
    * 检查 value 是否为 Boolean
    * @param value 待检查值
    * @returns 是否为 Boolean
+   * @example
+   * ```ts
+   * TypeUtil.isBoolean(false); // true
+   * ```
    */
   static isBoolean(value: unknown): value is boolean;
   /**
    * 检查 value 是否为 BigInt
    * @param value 待检查值
    * @returns 是否为 BigInt
+   * @example
+   * ```ts
+   * TypeUtil.isBigInt(1n); // true
+   * ```
    */
   static isBigInt(value: unknown): value is bigint;
   /**
    * 检查 value 是否为 Symbol
    * @param value 待检查值
    * @returns 是否为 Symbol
+   * @example
+   * ```ts
+   * TypeUtil.isSymbol(Symbol("a")); // true
+   * ```
    */
   static isSymbol(value: unknown): value is symbol;
   /**
    * 检查 value 是否为 undefined
    * @param value 待检查值
    * @returns 是否为 undefined
+   * @example
+   * ```ts
+   * TypeUtil.isUndefined(undefined); // true
+   * ```
    */
   static isUndefined(value: unknown): value is undefined;
   /**
    * 检查 value 是否为 null
    * @param value 待检查值
    * @returns 是否为 null
+   * @example
+   * ```ts
+   * TypeUtil.isNull(null); // true
+   * ```
    */
   static isNull(value: unknown): value is null;
   /**
    * 检查 value 是否为 Function
    * @param value 待检查值
    * @returns 是否为 Function
+   * @example
+   * ```ts
+   * TypeUtil.isFunction(() => {}); // true
+   * ```
    */
   static isFunction(value: unknown): value is AnyFunction;
   /**
    * 检查 value 是否为 AsyncFunction
    * @param value 待检查值
    * @returns 是否为 AsyncFunction
+   * @example
+   * ```ts
+   * TypeUtil.isAsyncFunction(async () => {}); // true
+   * ```
    */
   static isAsyncFunction(value: unknown): value is AnyAsyncFunction;
   /**
    * 检查 value 是否为 GeneratorFunction
    * @param value 待检查值
    * @returns 是否为 GeneratorFunction
+   * @example
+   * ```ts
+   * TypeUtil.isGeneratorFunction(function * a () {}); // true
+   * ```
    */
   static isGeneratorFunction(value: unknown): value is AnyGeneratorFunction;
   /**
    * 检查 value 是否为 AsyncGeneratorFunction
    * @param value 待检查值
    * @returns 是否为 AsyncGeneratorFunction
+   * @example
+   * ```ts
+   * TypeUtil.isAsyncGeneratorFunction(async function * a () {}); // true
+   * ```
    */
   static isAsyncGeneratorFunction(value: unknown): value is AnyAsyncGeneratorFunction;
   /**
    * 检查 value 是否为 Promise
    * @param value 待检查值
    * @returns 是否为 Promise
+   * @example
+   * ```ts
+   * TypeUtil.isPromise(Promise.resolve(1)); // true
+   * ```
    */
   static isPromise(value: unknown): value is Promise<unknown>;
   /**
@@ -3932,6 +4346,10 @@ declare class TypeUtil {
    * - 可识别拥有 then 方法的非 Promise 对象
    * @param value 待检查值
    * @returns 是否为 PromiseLike
+   * @example
+   * ```ts
+   * TypeUtil.isPromiseLike({ then: () => {} }); // true
+   * ```
    */
   static isPromiseLike(value: unknown): value is PromiseLike<unknown>;
   /**
@@ -3962,6 +4380,11 @@ declare class TypeUtil {
    *
    * @param enumeration 待检查值
    * @returns [是否为有效的枚举, 是否为双向枚举]
+   * @example
+   * ```ts
+   * enum A { X, Y }
+   * TypeUtil.isEnumeration(A); // [true, true]
+   * ```
    */
   static isEnumeration(enumeration: PlainObject): [boolean, boolean];
   /**
@@ -4003,36 +4426,60 @@ declare class TypeUtil {
    * 检查 value 是否为 Map
    * @param value 待检查值
    * @returns 是否为 Map
+   * @example
+   * ```ts
+   * TypeUtil.isMap(new Map()); // true
+   * ```
    */
   static isMap(value: unknown): value is Map<unknown, unknown>;
   /**
    * 检查 value 是否为 WeakMap
    * @param value 待检查值
    * @returns 是否为 WeakMap
+   * @example
+   * ```ts
+   * TypeUtil.isWeakMap(new WeakMap()); // true
+   * ```
    */
   static isWeakMap(value: unknown): value is WeakMap<AnyObject, unknown>;
   /**
    * 检查 value 是否为 Set
    * @param value 待检查值
    * @returns 是否为 Set
+   * @example
+   * ```ts
+   * TypeUtil.isSet(new Set()); // true
+   * ```
    */
   static isSet(value: unknown): value is Set<unknown>;
   /**
    * 检查 value 是否为 WeakSet
    * @param value 待检查值
    * @returns 是否为 WeakSet
+   * @example
+   * ```ts
+   * TypeUtil.isWeakSet(new WeakSet()); // true
+   * ```
    */
   static isWeakSet(value: unknown): value is WeakSet<AnyObject>;
   /**
    * 检查 value 是否为 Blob
    * @param value 待检查值
    * @returns 是否为 Blob
+   * @example
+   * ```ts
+   * TypeUtil.isBlob(new Blob(["a"])); // true
+   * ```
    */
   static isBlob(value: unknown): value is Blob;
   /**
    * 检查 value 是否为 File
    * @param value 待检查值
    * @returns 是否为 File
+   * @example
+   * ```ts
+   * TypeUtil.isFile(new File(["a"], "a.txt")); // true
+   * ```
    */
   static isFile(value: unknown): value is File;
   /**
@@ -4044,18 +4491,30 @@ declare class TypeUtil {
    *
    * @param value 待检查值
    * @returns 是否为 ReadableStream
+   * @example
+   * ```ts
+   * TypeUtil.isReadableStream(new ReadableStream()); // true
+   * ```
    */
   static isReadableStream(value: unknown): value is ReadableStream;
   /**
    * 检查 value 是否为 Window
    * @param value 待检查值
    * @returns 是否为 Window
+   * @example
+   * ```ts
+   * TypeUtil.isWindow(window); // true
+   * ```
    */
   static isWindow(value: unknown): value is Window;
   /**
    * 检查 value 是否为 HTMLIFrameElement
    * @param value 待检查值
    * @returns 是否为 HTMLIFrameElement
+   * @example
+   * ```ts
+   * TypeUtil.isIframe(document.createElement("iframe")); // true
+   * ```
    */
   static isIframe(value: unknown): value is HTMLIFrameElement;
   /**
@@ -4081,36 +4540,60 @@ declare class TypeUtil {
    * 检查 value 是否为 Error 对象
    * @param value 待检查值
    * @returns 是否为 Error
+   * @example
+   * ```ts
+   * TypeUtil.isError(new Error("x")); // true
+   * ```
    */
   static isError(value: unknown): value is Error;
   /**
    * 检查 value 是否为 RegExp
    * @param value 待检查值
    * @returns 是否为 RegExp
+   * @example
+   * ```ts
+   * TypeUtil.isRegExp(/a/); // true
+   * ```
    */
   static isRegExp(value: unknown): value is RegExp;
   /**
    * 检查 value 是否为 WebSocket
    * @param value 待检查值
    * @returns 是否为 WebSocket
+   * @example
+   * ```ts
+   * TypeUtil.isWebSocket(new WebSocket("wss://echo.websocket.events")); // true
+   * ```
    */
   static isWebSocket(value: unknown): value is WebSocket;
   /**
    * 检查 value 是否为 URLSearchParams
    * @param value 待检查值
    * @returns 是否为 URLSearchParams
+   * @example
+   * ```ts
+   * TypeUtil.isURLSearchParams(new URLSearchParams("a=1")); // true
+   * ```
    */
   static isURLSearchParams(value: unknown): value is URLSearchParams;
   /**
    * 检查 value 是否为 AbortSignal
    * @param value 待检查值
    * @returns 是否为 AbortSignal
+   * @example
+   * ```ts
+   * TypeUtil.isAbortSignal(new AbortController().signal); // true
+   * ```
    */
   static isAbortSignal(value: unknown): value is AbortSignal;
   /**
    * 检查 value 是否为可迭代对象 (Iterable)
    * @param value 待检查值
    * @returns 是否为 Iterable
+   * @example
+   * ```ts
+   * TypeUtil.isIterable([1, 2]); // true
+   * ```
    */
   static isIterable(value: unknown): value is {
     [Symbol.iterator]: () => Iterator<unknown>;
@@ -4119,8 +4602,24 @@ declare class TypeUtil {
    * 检查 value 是否为 Falsy 值 (false, 0, "", null, undefined, NaN)
    * @param value 待检查值
    * @returns 是否为 Falsy
+   * @example
+   * ```ts
+   * TypeUtil.isFalsy(0); // true
+   * ```
    */
   static isFalsy(value: unknown): value is false | 0 | "" | null | undefined;
+  /**
+   * 检查 value 是否为 FalsyLike 值
+   * - 包含字符串形式的 `"null"`、`"undefined"`、`"false"`、`"0"` 等
+   *
+   * @param value 待检查值
+   * @returns 是否为 FalsyLike
+   * @example
+   * ```ts
+   * TypeUtil.isFalsyLike("false"); // true
+   * TypeUtil.isFalsyLike("hello"); // false
+   * ```
+   */
   static isFalsyLike(value: unknown): boolean;
 }
 //#endregion
@@ -4132,162 +4631,290 @@ declare class ValidateUtil {
   static _phone: RegExp;
   /**
    * 验证是否为手机号码
+   * @example
+   * ```ts
+   * ValidateUtil.isPhone("13800138000"); // true
+   * ```
    */
   static isPhone(input: string): boolean;
   static _telephone: RegExp;
   /**
    * 验证是否为固定电话
+   * @example
+   * ```ts
+   * ValidateUtil.isTelephone("010-12345678"); // true
+   * ```
    */
   static isTelephone(input: string): boolean;
   static _IMEI: RegExp;
   /**
    * 验证是否为移动设备识别码
+   * @example
+   * ```ts
+   * ValidateUtil.isIMEI("490154203237518"); // true
+   * ```
    */
   static isIMEI(input: string): boolean;
   static _email: RegExp;
   /**
    * 验证是否为电子邮箱
+   * @example
+   * ```ts
+   * ValidateUtil.isEmail("dev@example.com"); // true
+   * ```
    */
   static isEmail(input: string): boolean;
   static _link: RegExp;
   /**
    * 验证是否为 http(s) 链接
+   * @example
+   * ```ts
+   * ValidateUtil.isHttpLink("https://example.com/path"); // true
+   * ```
    */
   static isHttpLink(input: string): boolean;
   static _portLink: RegExp;
   /**
    * 验证是否为端口号链接
+   * @example
+   * ```ts
+   * ValidateUtil.isPortLink("http://example.com:8080"); // true
+   * ```
    */
   static isPortLink(input: string): boolean;
   static _thunderLink: RegExp;
   /**
    * 验证是否为迅雷链接
+   * @example
+   * ```ts
+   * ValidateUtil.isThunderLink("thunder://QUFodHRwOi8vZXhhbXBsZS5jb20vZmlsZQ=="); // true
+   * ```
    */
   static isThunderLink(input: string): boolean;
   static _uscc: RegExp;
   /**
    * 验证是否为统一社会信用代码
+   * @example
+   * ```ts
+   * ValidateUtil.isUSCC("91350100M000100Y43"); // true
+   * ```
    */
   static isUSCC(input: string): boolean;
   static _usccs: RegExp;
   /**
    * 验证是否为统一社会信用代码 - 15位/18位/20位数字/字母
+   * @example
+   * ```ts
+   * ValidateUtil.isUSCCS("91350100M000100Y43"); // true
+   * ```
    */
   static isUSCCS(input: string): boolean;
   static _dirPathWindows: RegExp;
   /**
    * 验证是否为 Windows 系统文件夹路径
+   * @example
+   * ```ts
+   * ValidateUtil.isDirPathWindows("C:\\Users\\pawover\\"); // true
+   * ```
    */
   static isDirPathWindows(input: string): boolean;
   static _filePathWindows: RegExp;
   /**
    * 验证是否为 Windows 系统文件路径
+   * @example
+   * ```ts
+   * ValidateUtil.isFilePathWindows("C:\\Users\\pawover\\a.txt"); // true
+   * ```
    */
   static isFilePathWindows(input: string): boolean;
   static _dirPathLinux: RegExp;
   /**
    * 验证是否为 Linux 系统文件夹路径
+   * @example
+   * ```ts
+   * ValidateUtil.isDirPathLinux("/usr/local/"); // true
+   * ```
    */
   static isDirPathLinux(input: string): boolean;
   static _filePathLinux: RegExp;
   /**
    * 验证是否为 Linux 系统文件路径
+   * @example
+   * ```ts
+   * ValidateUtil.isFilePathLinux("/usr/local/bin/node"); // true
+   * ```
    */
   static isFilePathLinux(input: string): boolean;
   static _EVCarNumber: RegExp;
   /**
    * 验证是否为新能源车牌号
+   * @example
+   * ```ts
+   * ValidateUtil.isEVCarNumber("粤AD12345"); // true
+   * ```
    */
   static isEVCarNumber(input: string): boolean;
   static _GVCarNumber: RegExp;
   /**
    * 验证是否为燃油车车牌号
+   * @example
+   * ```ts
+   * ValidateUtil.isGVCarNumber("粤B12345"); // true
+   * ```
    */
   static isGVCarNumber(input: string): boolean;
   static _chineseName: RegExp;
   /**
    * 验证是否为中文姓名
+   * @example
+   * ```ts
+   * ValidateUtil.isChineseName("张三"); // true
+   * ```
    */
   static isChineseName(input: string): boolean;
   static _chineseId: RegExp;
   /**
    * 验证是否为中国身份证号
+   * @example
+   * ```ts
+   * ValidateUtil.isChineseID("11010519491231002X"); // true
+   * ```
    */
   static isChineseID(input: string): boolean;
   static _chineseProvince: RegExp;
   /**
    * 验证是否为中国省份
+   * @example
+   * ```ts
+   * ValidateUtil.isChineseProvince("浙江"); // true
+   * ```
    */
   static isChineseProvince(input: string): boolean;
   static _chineseNation: RegExp;
   /**
    * 验证是否为中华民族
+   * @example
+   * ```ts
+   * ValidateUtil.isChineseNation("汉族"); // true
+   * ```
    */
   static isChineseNation(input: string): boolean;
   static _letter: RegExp;
   /**
    * 验证是否只包含字母
+   * @example
+   * ```ts
+   * ValidateUtil.isLetter("abcDEF"); // true
+   * ```
    */
   static isLetter(input: string): boolean;
   static _letterLowercase: RegExp;
   /**
    * 验证是否只包含小写字母
+   * @example
+   * ```ts
+   * ValidateUtil.isLetterLowercase("abc"); // true
+   * ```
    */
   static isLetterLowercase(input: string): boolean;
   static _letterUppercase: RegExp;
   /**
    * 验证是否只包含大写字母
+   * @example
+   * ```ts
+   * ValidateUtil.isLetterUppercase("ABC"); // true
+   * ```
    */
   static isLetterUppercase(input: string): boolean;
   static _letterOmit: RegExp;
   /**
    * 验证是否不包含字母
+   * @example
+   * ```ts
+   * ValidateUtil.isLetterOmit("123_-"); // true
+   * ```
    */
   static isLetterOmit(input: string): boolean;
   static _LetterAndNumber: RegExp;
   /**
    * 验证是否为数字和字母组合
+   * @example
+   * ```ts
+   * ValidateUtil.isLetterAndNumber("A1B2"); // true
+   * ```
    */
   static isLetterAndNumber(input: string): boolean;
   static _signedFloat: RegExp;
   /**
    * 验证是否为有符号浮点数
+   * @example
+   * ```ts
+   * ValidateUtil.isSignedFloat("-12.34"); // true
+   * ```
    */
   static isSignedFloat(input: string): boolean;
   static _unsignedFloat: RegExp;
   /**
    * 验证是否为无符号浮点数
+   * @example
+   * ```ts
+   * ValidateUtil.isUnsignedFloat("12.34"); // true
+   * ```
    */
   static isUnsignedFloat(input: string): boolean;
   static _signedInteger: RegExp;
   /**
    * 验证是否为有符号整数
+   * @example
+   * ```ts
+   * ValidateUtil.isSignedInteger("-12"); // true
+   * ```
    */
   static isSignedInteger(input: string): boolean;
   static _unsignedInteger: RegExp;
   /**
    * 验证是否为无符号整数
+   * @example
+   * ```ts
+   * ValidateUtil.isUnsignedInteger("12"); // true
+   * ```
    */
   static isUnsignedInteger(input: string): boolean;
   static _spaceInclude: RegExp;
   /**
    * 验证是否包含空格
+   * @example
+   * ```ts
+   * ValidateUtil.isSpaceInclude("a b"); // true
+   * ```
    */
   static isSpaceInclude(input: string): boolean;
   static _spaceStart: RegExp;
   /**
    * 验证是否以空格开头
+   * @example
+   * ```ts
+   * ValidateUtil.isSpaceStart(" abc"); // true
+   * ```
    */
   static isSpaceStart(input: string): boolean;
   static _spaceEnd: RegExp;
   /**
    * 验证是否以空格结尾
+   * @example
+   * ```ts
+   * ValidateUtil.isSpaceEnd("abc "); // true
+   * ```
    */
   static isSpaceEnd(input: string): boolean;
   /**
    * 验证是否以空格开头或结尾
+   * @example
+   * ```ts
+   * ValidateUtil.isSpaceStartOrEnd(" abc"); // true
+   * ```
    */
   static isSpaceStartOrEnd(input: string): boolean;
 }
 //#endregion
-export { ArrayUtil, DateTimeUtil, EnvUtil, FunctionUtil, MimeUtil, NumberUtil, ObjectUtil, StringUtil, THEME_MODE_TYPE, THEME_TYPE, ThemeUtil, TreeUtil, TypeUtil, ValidateUtil };
+export { ArrayUtil, DateTimeUtil, EnvUtil, FunctionUtil, MimeUtil, NumberUtil, ObjectUtil, StringUtil, type THEME_MODE_TYPE, type THEME_TYPE, ThemeUtil, TreeUtil, TypeUtil, ValidateUtil };