@pawover/kit 0.3.1 → 0.4.1

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

@@ -1,3 +1,4 @@
+import { MathJsInstance } from "mathjs";
 //#region src/array/index.type.d.ts
 type MatchFunction<T, R = unknown> = (row: T, index: number) => R;
 //#endregion
@@ -305,678 +306,6 @@ declare class ArrayUtil {
   static zipToObject<const K extends PropertyKey, const V>(keys: readonly K[], value: V): Record<K, V>;
 }
 //#endregion
-//#region src/dateTime/dateTimeUtil.d.ts
-/**
- * 日期工具类
- */
-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";
-    readonly ISO_DATE_TIME: "yyyy-MM-dd HH:mm:ss";
-    readonly ISO_DATE_TIME_MS: "yyyy-MM-dd HH:mm:ss.SSS";
-    readonly ISO_DATETIME_TZ: "yyyy-MM-dd'T'HH:mm:ssXXX";
-    readonly ISO_DATETIME_TZ_MS: "yyyy-MM-dd'T'HH:mm:ss.SSSXXX";
-    readonly US_DATE: "MM/dd/yyyy";
-    readonly US_DATE_TIME: "MM/dd/yyyy HH:mm:ss";
-    readonly US_DATE_SHORT_YEAR: "MM/dd/yy";
-    readonly EU_DATE: "dd/MM/yyyy";
-    readonly EU_DATE_TIME: "dd/MM/yyyy HH:mm:ss";
-    readonly CN_DATE: "yyyy年MM月dd日";
-    readonly CN_DATE_TIME: "yyyy年MM月dd日 HH时mm分ss秒";
-    readonly CN_DATE_WEEKDAY: "yyyy年MM月dd日 EEE";
-    readonly CN_WEEKDAY_FULL: "EEEE";
-    readonly SHORT_DATE: "yy-MM-dd";
-    readonly SHORT_DATE_SLASH: "yy/MM/dd";
-    readonly MONTH_DAY: "MM-dd";
-    readonly MONTH_DAY_CN: "MM月dd日";
-    readonly DATE_WITH_WEEKDAY_SHORT: "yyyy-MM-dd (EEE)";
-    readonly DATE_WITH_WEEKDAY_FULL: "yyyy-MM-dd (EEEE)";
-    readonly TIME_24: "HH:mm:ss";
-    readonly TIME_24_NO_SEC: "HH:mm";
-    readonly TIME_12: "hh:mm:ss a";
-    readonly TIME_12_NO_SEC: "hh:mm a";
-    readonly TIMESTAMP: "yyyyMMddHHmmss";
-    readonly TIMESTAMP_MS: "yyyyMMddHHmmssSSS";
-    readonly RFC2822: "EEE, dd MMM yyyy HH:mm:ss xxx";
-    readonly READABLE_DATE: "MMM dd, yyyy";
-    readonly READABLE_DATE_TIME: "MMM dd, yyyy HH:mm";
-    readonly COMPACT_DATETIME: "yyyyMMdd_HHmmss";
-  };
-  /**
-   * 获取当前时区信息
-   *
-   * @returns 时区信息对象 (UTC偏移和时区名称)
-   * @example
-   * ```ts
-   * DateTimeUtil.getTimeZone(); // { UTC: "UTC+8", timeZone: "Asia/Shanghai" }
-   * ```
-   */
-  static getTimeZone(): {
-    UTC: string;
-    timeZone: string;
-  };
-}
-//#endregion
-//#region src/env/envUtil.d.ts
-/**
- * 环境检查工具类
- */
-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;
-  /**
-   * 检测当前设备是否为桌面设备
-   *
-   * @param minWidth - 桌面设备最小宽度（默认 1200px）
-   * @param minScreenSize - 桌面设备最小屏幕尺寸（默认 10英寸）
-   * @param dpi - 标准 DPI 基准（默认 160）
-   * @returns 是否为桌面设备
-   * @example
-   * ```ts
-   * // 假设 window.innerWidth = 1920
-   * EnvUtil.isDesktop(); // true
-   *
-   * // 自定义阈值
-   * EnvUtil.isDesktop(1440, 13); // 更严格的桌面检测
-   * ```
-   */
-  static isDesktop(minWidth?: number, minScreenSize?: number, dpi?: number): boolean;
-  /**
-   * 检测当前设备是否为 Windows 桌面设备
-   *
-   * @param minWidth - 桌面设备最小宽度（默认 1200px）
-   * @param minScreenSize - 桌面设备最小屏幕尺寸（默认 10英寸）
-   * @param dpi - 标准 DPI 基准（默认 160）
-   * @returns 是否为 Windows 桌面设备
-   * @example
-   * ```ts
-   * // UA contains Windows
-   * EnvUtil.isWindowsDesktop(); // true
-   * ```
-   */
-  static isWindowsDesktop(minWidth?: number, minScreenSize?: number, dpi?: number): boolean;
-  /**
-   * 检测当前设备是否为 macOS 桌面设备
-   *
-   * @param minWidth - 桌面设备最小宽度（默认 1200px）
-   * @param minScreenSize - 桌面设备最小屏幕尺寸（默认 10英寸）
-   * @param dpi - 标准 DPI 基准（默认 160）
-   * @returns 是否为 macOS 桌面设备
-   * @example
-   * ```ts
-   * // UA contains Macintosh
-   * EnvUtil.isMacOSDesktop(); // true
-   * ```
-   */
-  static isMacOSDesktop(minWidth?: number, minScreenSize?: number, dpi?: number): boolean;
-  /**
-   * 检测当前设备是否为移动设备
-   *
-   * @param maxWidth - 移动设备最大宽度（默认 768px）
-   * @param dpi - 标准 DPI 基准（默认 160）
-   * @returns 是否为移动设备
-   * @example
-   * ```ts
-   * // 假设 window.innerWidth = 500
-   * EnvUtil.isMobile(); // true
-   * ```
-   */
-  static isMobile(maxWidth?: number, dpi?: number): boolean;
-  /**
-   * 检测当前设备是否为IOS移动设备
-   *
-   * @param maxWidth - 移动设备最大宽度（默认 768px）
-   * @param dpi - 标准 DPI 基准（默认 160）
-   * @returns 是否为 iOS 移动设备 (iPhone/iPod)
-   * @example
-   * ```ts
-   * // UA contains iPhone
-   * EnvUtil.isIOSMobile(); // true
-   * ```
-   */
-  static isIOSMobile(maxWidth?: number, dpi?: number): boolean;
-  /**
-   * 检测当前设备是否为平板
-   *
-   * @param minWidth - 平板最小宽度（默认 768px）
-   * @param maxWidth - 平板最大宽度（默认 1200px）
-   * @param dpi - 标准 DPI 基准（默认 160）
-   * @returns 是否为平板设备
-   * @example
-   * ```ts
-   * // 假设 window.innerWidth = 1000
-   * EnvUtil.isTablet(); // true
-   * ```
-   */
-  static isTablet(minWidth?: number, maxWidth?: number, dpi?: number): boolean;
-}
-//#endregion
-//#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/global.d.ts
-/** 任意对象类型 */
-type AnyObject<K extends PropertyKey = PropertyKey, T = any> = Record<K, T>;
-/** 普通对象类型 */
-type PlainObject<K extends PropertyKey = PropertyKey, T = unknown> = Record<K, T>;
-/** 描述树类型 */
-type TreeLike<T extends AnyObject, CK extends string = "children"> = T & Record<CK, TreeLike<T, CK>[]>;
-/** 描述函数类型 */
-type AnyFunction<P extends any[] = any[], R = any> = (...arg: P) => R;
-/** 描述异步函数类型 */
-type AnyAsyncFunction<P extends any[] = any[], R = any> = (...args: P) => Promise<R>;
-/** 描述生成器函数类型 */
-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
-//#region src/function/functionUtil.d.ts
-/**
- * 函数工具类
- */
-declare class FunctionUtil {
-  /**
-   *将 Promise 转换为 `[err, result]` 格式，方便 async/await 错误处理
-   *
-   * @param promise 待处理的 Promise
-   * @param errorExt 附加到 error 对象的扩展信息（注意：如果原 error 是 Error 实例，扩展属性可能会覆盖或无法正确合并非枚举属性）
-   * @returns `[err, null]` 或 `[null, data]`
-   * @example
-   * ```ts
-   * const [err, data] = await FunctionUtil.to(someAsyncFunc());
-   * ```
-   */
-  static to<T, U = Error>(promise: Readonly<Promise<T>>, errorExt?: PlainObject): Promise<[U, undefined] | [null, T]>;
-  /**
-   * 将 Arguments 对象转换为数组
-   *
-   * ⚠️ 注意：TypeScript 官方推荐使用 rest parameters (...args) 替代 arguments
-   * 本函数仅用于处理遗留代码或特殊场景（如装饰器中需保留 this 绑定）
-   *
-   * @param args Arguments 对象（必须为类数组对象）
-   * @param start 起始索引（可选，默认为 0）
-   * @returns 转换后的数组，元素类型为 T
-   *
-   * @throws TypeError 如果 args 为 null 或 undefined
-   *
-   * @example
-   * ```ts
-   * // 遗留代码场景
-   * function legacyFn(a: number, b: string) {
-   *   const argsArray = FunctionUtil.toArgs(arguments);
-   *   // argsArray: unknown[]
-   * }
-   *
-   * // 现代替代方案（推荐）
-   * function modernFn(a: number, b: string, ...rest: unknown[]) {
-   *   // rest 已经是数组，无需 toArgs
-   * }
-   *
-   * // 参数截取
-   * function skipFirst(...args: unknown[]) {
-   *   const rest = FunctionUtil.toArgs(arguments, 1);
-   *   // rest: unknown[]，跳过第一个参数
-   * }
-   * ```
-   */
-  static toArgs<T = unknown>(args: IArguments, start?: number | undefined): T[];
-  /**
-   * 将同步或异步函数统一包装为 Promise
-   * - 自动捕获同步异常
-   *
-   * @param fn 返回值可为同步值或 Promise 的函数
-   * @returns 标准化的 Promise
-   *
-   * @example
-   * ```ts
-   * // 同步函数
-   * FunctionUtil.toPromise(() => 42).then(v => console.log(v)); // 42
-   *
-   * // 异步函数
-   * FunctionUtil.toPromise(async () => await fetchData()).then(data => ...);
-   *
-   * // 异常处理
-   * FunctionUtil.toPromise(() => { throw new Error('fail'); }).catch(err => console.error(err)); // 捕获同步异常
-   * ```
-   */
-  static toPromise<T>(fn: () => T | Promise<T>): Promise<T>;
-}
-//#endregion
-//#region src/mime/mimeUtil.d.ts
-/**
- * MIME 工具类
- */
-declare class MimeUtil {
-  /**
-   * 文件类型 MIME 常量
-   * - 每个类型对应具体的文件扩展名
-   */
-  static readonly FILE_MIME: {
-    /** 普通文本文件（.txt） */
-    readonly TEXT: "text/plain";
-    /** 超文本标记语言文档（.html/.htm） */
-    readonly HTML: "text/html";
-    /** 层叠样式表文件（.css） */
-    readonly CSS: "text/css";
-    /** 逗号分隔值文件/表格数据（.csv） */
-    readonly CSV: "text/csv";
-    /** 制表符分隔值文件（.tsv） */
-    readonly TSV: "text/tab-separated-values";
-    /** XML 文档（.xml） */
-    readonly XML: "application/xml";
-    /** XML 文档/兼容值 */
-    readonly XML_LEGACY: "text/xml";
-    /** XHTML 文档（.xhtml/.xht） */
-    readonly XHTML: "application/xhtml+xml";
-    /** JavaScript 文件（.js） */
-    readonly JS: "text/javascript";
-    /** TypeScript 文件（.ts） */
-    readonly TS: "text/typescript";
-    /** Python 文件（.py） */
-    readonly PY: "text/x-python";
-    /** Shell 脚本 (.sh) */
-    readonly SH: "text/x-sh";
-    /** C 语言源文件（.c） */
-    readonly C: "text/x-c";
-    /** C++ 源文件（.cpp/.cc/.cxx） */
-    readonly CPP: "text/x-c++";
-    /** C# 源文件（.cs） */
-    readonly CSHARP: "text/x-csharp";
-    /** Java 源文件（.java） */
-    readonly JAVA: "text/x-java";
-    /** Go 源文件（.go） */
-    readonly GO: "text/x-go";
-    /** Rust 源文件（.rs） */
-    readonly RUST: "text/x-rust";
-    /** PHP 文件（.php） */
-    readonly PHP: "text/x-php";
-    /** Ruby 文件（.rb） */
-    readonly RUBY: "text/x-ruby";
-    /** Swift 源文件（.swift） */
-    readonly SWIFT: "text/x-swift";
-    /** YAML 文档（.yaml/.yml） */
-    readonly YAML: "application/yaml";
-    /** YAML 文档/兼容值 */
-    readonly YAML_LEGACY: "text/vnd.yaml";
-    /** TOML 文档（.toml） */
-    readonly TOML: "application/toml";
-    /** TOML 文档/兼容值 */
-    readonly TOML_LEGACY: "text/x-toml";
-    /** SQL 脚本（.sql） */
-    readonly SQL: "application/sql";
-    /** SQL 脚本/兼容值 */
-    readonly SQL_LEGACY: "text/x-sql";
-    /** Markdown 格式文档（.md/.markdown） */
-    readonly MARKDOWN: "text/markdown";
-    /** 富文本格式文档（.rtf） */
-    readonly RTF: "application/rtf";
-    /** iCalendar 日历格式（.ics） */
-    readonly CALENDAR: "text/calendar";
-    /** JPEG 图像（.jpg/.jpeg） */
-    readonly JPEG: "image/jpeg";
-    /** JPG 图像（JPEG 别名，.jpg） */
-    readonly JPG: "image/jpeg";
-    /** PNG 图像/无损压缩，支持透明（.png） */
-    readonly PNG: "image/png";
-    /** GIF 图像/支持动画（.gif） */
-    readonly GIF: "image/gif";
-    /** Windows 位图（.bmp） */
-    readonly BMP: "image/bmp";
-    /** SVG 向量图形（.svg） */
-    readonly SVG: "image/svg+xml";
-    /** APNG 动态图像（.apng） */
-    readonly APNG: "image/apng";
-    /** AVIF 图像/高效压缩（.avif） */
-    readonly AVIF: "image/avif";
-    /** 图标文件格式（.ico） */
-    readonly ICO: "image/vnd.microsoft.icon";
-    /** 图标文件格式/兼容值（.ico） */
-    readonly ICO_LEGACY: "image/x-icon";
-    /** WebP 图像/高效压缩（.webp） */
-    readonly WEBP: "image/webp";
-    /** TIFF 图像（.tif/.tiff） */
-    readonly TIFF: "image/tiff";
-    /** HEIC 图像/高效编码（.heic） */
-    readonly HEIC: "image/heic";
-    /** HEIF 图像/高效编码（.heif） */
-    readonly HEIF: "image/heif";
-    /** 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） */
-    readonly OGG_AUDIO: "audio/ogg";
-    /** Opus 音频（.opus） */
-    readonly OPUS: "audio/opus";
-    /** FLAC 无损音频（.flac） */
-    readonly FLAC: "audio/flac";
-    /** WAV 音频（.wav） */
-    readonly WAV: "audio/wav";
-    /** WebM 音频（.weba） */
-    readonly WEBM_AUDIO: "audio/webm";
-    /** RealAudio 音频（.ra/.ram） */
-    readonly REAL_AUDIO: "audio/x-pn-realaudio";
-    /** MP4 视频（.mp4） */
-    readonly MP4: "video/mp4";
-    /** MPEG 视频（.mpeg/.mpg） */
-    readonly MPEG: "video/mpeg";
-    /** OGG 视频（.ogv） */
-    readonly OGG_VIDEO: "video/ogg";
-    /** AVI 视频（.avi） */
-    readonly AVI: "video/x-msvideo";
-    /** 3GPP 视频（.3gp） */
-    readonly THREE_GPP: "video/3gpp";
-    /** 3GPP2 视频（.3g2） */
-    readonly THREE_GPP2: "video/3gpp2";
-    /** WebM 视频（.webm） */
-    readonly WEBM: "video/webm";
-    /** Matroska 视频（.mkv） */
-    readonly MKV: "video/x-matroska";
-    /** Matroska 音频（.mka） */
-    readonly MKA: "audio/x-matroska";
-    /** QuickTime 视频（.mov） */
-    readonly QUICKTIME: "video/quicktime";
-    /** PDF 文档（.pdf） */
-    readonly PDF: "application/pdf";
-    /** Word 97-2003 文档（.doc） */
-    readonly DOC: "application/msword";
-    /** Word 2007+ 文档（.docx） */
-    readonly DOCX: "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
-    /** Excel 2007+ 工作簿（.xlsx） */
-    readonly XLSX: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
-    /** 启用宏的Excel工作簿（.xlsm） */
-    readonly XLSM: "application/vnd.ms-excel.sheet.macroEnabled.12";
-    /** Excel模板文件（.xltx） */
-    readonly XLTX: "application/vnd.openxmlformats-officedocument.spreadsheetml.template";
-    /** PowerPoint 2007+ 演示文稿（.pptx） */
-    readonly PPTX: "application/vnd.openxmlformats-officedocument.presentationml.presentation";
-    /** PowerPoint 97-2003 演示文稿（.ppt） */
-    readonly PPT: "application/vnd.ms-powerpoint";
-    /** OpenDocument 文本文档（.odt） */
-    readonly ODT: "application/vnd.oasis.opendocument.text";
-    /** OpenDocument 表格文档（.ods） */
-    readonly ODS: "application/vnd.oasis.opendocument.spreadsheet";
-    /** OpenDocument 演示文稿（.odp） */
-    readonly ODP: "application/vnd.oasis.opendocument.presentation";
-    /** EPUB 电子书（.epub） */
-    readonly EPUB: "application/epub+zip";
-    /** Kindle 电子书（.azw） */
-    readonly AZW: "application/vnd.amazon.ebook";
-    /** ZIP 压缩文件（.zip） */
-    readonly ZIP: "application/zip";
-    /** GZIP 压缩文件（.gz） */
-    readonly GZIP: "application/gzip";
-    /** TAR 归档文件（.tar） */
-    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";
-    /** RAR 压缩文件（.rar） */
-    readonly RAR: "application/vnd.rar";
-    /** XZ 压缩文件（.xz） */
-    readonly XZ: "application/x-xz";
-    /** Zstandard 压缩文件（.zst） */
-    readonly ZSTD: "application/zstd";
-    /** ISO 光盘镜像（.iso） */
-    readonly ISO9660_IMAGE: "application/x-iso9660-image";
-    /** JSON 数据格式（.json） */
-    readonly JSON: "application/json";
-    /** JSON-LD 格式（.jsonld） */
-    readonly LD_JSON: "application/ld+json";
-    /** Web App Manifest（.webmanifest） */
-    readonly MANIFEST: "application/manifest+json";
-    /** Java 归档文件（.jar） */
-    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";
-    /** 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";
-  };
-  /**
-   * 协议/内容类型 MIME 常量
-   * - 用于 HTTP 请求/响应内容协商，无对应文件扩展名
-   */
-  static readonly PROTOCOL_MIME: {
-    /** 通用二进制数据流 */
-    readonly OCTET_STREAM: "application/octet-stream";
-    /** URL 编码表单 */
-    readonly FORM_URLENCODED: "application/x-www-form-urlencoded";
-    /** multipart 表单 */
-    readonly FORM_DATA: "multipart/form-data";
-    /** Server-Sent Events 数据流 */
-    readonly EVENT_STREAM: "text/event-stream";
-    /** 问题详情 JSON（RFC 9457） */
-    readonly PROBLEM_JSON: "application/problem+json";
-    /** JSON Patch（RFC 6902） */
-    readonly JSON_PATCH: "application/json-patch+json";
-    /** JSON Merge Patch（RFC 7386） */
-    readonly MERGE_PATCH_JSON: "application/merge-patch+json";
-  };
-  /**
-   * 根据文件后缀名获取对应的标准 MIME 类型（含历史兼容值）
-   * - 支持带 `.` 或不带 `.` 的后缀名，不区分大小写
-   * - 元组第一项始终为 IANA 官方标准 MIME，后续项为历史兼容值
-   * - 仅查询文件类型 MIME，不包含无后缀对应的协议类型
-   *
-   * @param extension 文件后缀名（如 `".png"` / `"png"` / `".PNG"`）
-   * @returns 标准 MIME + 兼容值的元组；如无匹配则返回 `undefined`
-   * @example
-   * ```ts
-   * MimeUtil.fromExtension(".png");  // ["image/png"]
-   * MimeUtil.fromExtension("ico");   // ["image/vnd.microsoft.icon", "image/x-icon"]
-   * MimeUtil.fromExtension(".xml");  // ["application/xml", "text/xml"]
-   * MimeUtil.fromExtension(".xyz");  // undefined
-   * ```
-   */
-  static fromExtension(extension: string): readonly [string, ...string[]] | undefined;
-  /**
-   * 根据 MIME 类型获取对应的文件后缀名列表
-   * - 一个 MIME 类型可能对应多个后缀名（如 `text/html` → `.html` / `.htm`）
-   * - 兼容值和标准值映射到相同的后缀（如 `image/x-icon` 和 `image/vnd.microsoft.icon` 均返回 `[".ico"]`）
-   * - 仅查询文件类型 MIME，协议类型无对应后缀
-   *
-   * @param mime MIME 类型字符串（如 `"image/png"` / `"IMAGE/PNG"`）
-   * @returns 文件后缀名列表；如无匹配则返回 `undefined`
-   * @example
-   * ```ts
-   * MimeUtil.toExtension("IMAGE/PNG");                    // [".png"]
-   * MimeUtil.toExtension("text/html");                    // [".html", ".htm"]
-   * MimeUtil.toExtension("image/jpeg");                   // [".jpg", ".jpeg"]
-   * MimeUtil.toExtension("application/octet-stream");     // undefined
-   * ```
-   */
-  static toExtension(mime: string): readonly [string, ...string[]] | undefined;
-}
-//#endregion
-//#region src/number/numberUtil.d.ts
-/**
- * 数字工具类
- */
-declare class NumberUtil {
-  /**
-   * 数字区间检查函数
-   *
-   * @param input 待检查数字
-   * @param interval 由两个数字组成的元组 [left, right]
-   * @param includeLeft 是否包含左边界（默认 true）
-   * @param includeRight 是否包含右边界（默认 false）
-   * @returns 是否在区间内
-   * @example
-   * ```ts
-   * NumberUtil.within(5, [1, 10]); // true
-   * NumberUtil.within(1, [1, 10], false); // false
-   * ```
-   */
-  static within(input: number, interval: [number, number], includeLeft?: boolean, includeRight?: boolean): boolean;
-}
-//#endregion
 //#region ../../node_modules/.pnpm/type-fest@5.8.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`.
@@ -2878,283 +2207,1154 @@ type _ExcludeExactly<Union, Delete> = IfNotAnyOrNever<Delete, {
 //#endregion
 //#region ../../node_modules/.pnpm/type-fest@5.8.0/node_modules/type-fest/source/union-member.d.ts
 /**
-Returns an arbitrary member of a union type.
+Returns an arbitrary member of a union type.
+
+Use-cases:
+- Implementing recursive type functions that accept a union type.
+
+@example
+```
+import type {UnionMember, IsNever} from 'type-fest';
+
+type UnionLength<T, Acc extends any[] = []> =
+	UnionMember<T> extends infer Member
+		? IsNever<Member> extends false
+			? UnionLength<Exclude<T, Member>, [...Acc, Member]>
+			: Acc['length']
+		: never;
+
+type T1 = UnionLength<'foo' | 'bar' | 'baz'>;
+//=> 3
+
+type T2 = UnionLength<{a: string}>;
+//=> 1
+```
+
+- Picking an arbitrary member from a union
+
+@example
+```
+import type {UnionMember, Primitive, LiteralToPrimitive} from 'type-fest';
+
+type IsHomogenous<T extends Primitive> = [T] extends [LiteralToPrimitive<UnionMember<T>>] ? true : false;
+
+type T1 = IsHomogenous<1 | 2 | 3 | 4>;
+//=> true
+
+type T2 = IsHomogenous<'foo' | 'bar'>;
+//=> true
+
+type T3 = IsHomogenous<'foo' | 'bar' | 1>;
+//=> false
+```
+
+Returns `never` when the input is `never`.
+
+@example
+```
+import type {UnionMember} from 'type-fest';
+
+type LastNever = UnionMember<never>;
+//=> never
+```
+
+@category Type
+*/
+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.8.0/node_modules/type-fest/source/union-to-tuple.d.ts
+/**
+Convert a union type into an unordered tuple type of its elements.
+
+"Unordered" means the elements of the tuple are not guaranteed to be in the same order as in the union type. The arrangement can appear random and may change at any time.
+
+This can be useful when you have objects with a finite set of keys and want a type defining only the allowed keys, but do not want to repeat yourself.
+
+@example
+```
+import type {UnionToTuple} from 'type-fest';
+
+type Numbers = 1 | 2 | 3;
+type NumbersTuple = UnionToTuple<Numbers>;
+//=> [1, 2, 3]
+```
+
+@example
+```
+import type {UnionToTuple} from 'type-fest';
+
+const pets = {
+	dog: '🐶',
+	cat: '🐱',
+	snake: '🐍',
+};
+
+type Pet = keyof typeof pets;
+//=> 'dog' | 'cat' | 'snake'
+
+const petList = Object.keys(pets) as UnionToTuple<Pet>;
+//=> ['dog', 'cat', 'snake']
+```
+
+@category Array
+*/
+type UnionToTuple<Union> = _UnionToTuple<Union> extends (infer Result extends UnknownArray) ? Result : never; // 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.8.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.
+
+Use-case: You want to define a single model where the only thing that changes is whether or not some of the keys are optional.
+
+@example
+```
+import type {SetOptional} from 'type-fest';
+
+type Foo = {
+	a: number;
+	b?: string;
+	c: boolean;
+};
+
+type SomeOptional = SetOptional<Foo, 'b' | 'c'>;
+//=> {a: number; b?: string; c?: boolean}
+```
+
+@category Object
+*/
+type SetOptional<BaseType, Keys extends keyof BaseType> = (BaseType extends ((...arguments_: never) => any) ? (...arguments_: Parameters<BaseType>) => ReturnType<BaseType> : unknown) & _SetOptional<BaseType, Keys>;
+type _SetOptional<BaseType, Keys extends keyof BaseType> = BaseType extends unknown // To distribute `BaseType` when it's a union type.
+ ? Simplify<
+// Pick just the keys that are readonly from the base type.
+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.8.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.
+
+Please upvote [this issue](https://github.com/microsoft/TypeScript/issues/31438) if you want to have this type as a built-in in TypeScript.
+
+@example
+```
+import type {ValueOf} from 'type-fest';
+
+type A = ValueOf<{id: number; name: string; active: boolean}>;
+//=> string | number | boolean
+
+type B = ValueOf<{id: number; name: string; active: boolean}, 'name'>;
+//=> string
+
+type C = ValueOf<{id: number; name: string; active: boolean}, 'id' | 'name'>;
+//=> string | number
+```
+
+@category Object
+*/
+type ValueOf<ObjectType, ValueType extends keyof ObjectType = keyof ObjectType> = ObjectType[ValueType];
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.8.0/node_modules/type-fest/source/split.d.ts
+/**
+Split options.
+
+@see {@link Split}
+*/
+type SplitOptions = {
+  /**
+	When enabled, instantiations with non-literal string types (e.g., `string`, `Uppercase<string>`, `on${string}`) simply return back `string[]` without performing any splitting, as the exact structure cannot be statically determined.
+
+	@default true
+
+	@example
+	```ts
+	import type {Split} from 'type-fest';
+
+	type Example1 = Split<`foo.${string}.bar`, '.', {strictLiteralChecks: false}>;
+	//=> ['foo', string, 'bar']
+
+	type Example2 = Split<`foo.${string}`, '.', {strictLiteralChecks: true}>;
+	//=> string[]
+
+	type Example3 = Split<'foobarbaz', `b${string}`, {strictLiteralChecks: false}>;
+	//=> ['foo', 'r', 'z']
+
+	type Example4 = Split<'foobarbaz', `b${string}`, {strictLiteralChecks: true}>;
+	//=> string[]
+	```
+	*/
+  strictLiteralChecks?: boolean;
+};
+type DefaultSplitOptions = {
+  strictLiteralChecks: true;
+};
+/**
+Represents an array of strings split using a given character or character set.
 
-Use-cases:
-- Implementing recursive type functions that accept a union type.
+Use-case: Defining the return type of a method like `String.prototype.split`.
 
 @example
 ```
-import type {UnionMember, IsNever} from 'type-fest';
-
-type UnionLength<T, Acc extends any[] = []> =
-	UnionMember<T> extends infer Member
-		? IsNever<Member> extends false
-			? UnionLength<Exclude<T, Member>, [...Acc, Member]>
-			: Acc['length']
-		: never;
+import type {Split} from 'type-fest';
 
-type T1 = UnionLength<'foo' | 'bar' | 'baz'>;
-//=> 3
+declare function split<S extends string, D extends string>(string: S, separator: D): Split<S, D>;
 
-type T2 = UnionLength<{a: string}>;
-//=> 1
+type Item = 'foo' | 'bar' | 'baz' | 'waldo';
+const items = 'foo,bar,baz,waldo';
+const array: Item[] = split(items, ',');
 ```
 
-- Picking an arbitrary member from a union
+@see {@link SplitOptions}
+
+@category String
+@category Template literal
+*/
+type Split<S extends string, Delimiter extends string, Options extends SplitOptions = {}> = SplitHelper<S, Delimiter, ApplyDefaultOptions<SplitOptions, DefaultSplitOptions, Options>>;
+type SplitHelper<S extends string, Delimiter extends string, Options extends Required<SplitOptions>, Accumulator extends string[] = []> = S extends string // For distributing `S`
+ ? Delimiter extends string // For distributing `Delimiter`
+ ?
+// If `strictLiteralChecks` is `false` OR `S` and `Delimiter` both are string literals, then perform the split
+Or<Not<Options['strictLiteralChecks']>, And<IsStringLiteral<S>, IsStringLiteral<Delimiter>>> extends true ? S extends `${infer Head}${Delimiter}${infer Tail}` ? SplitHelper<Tail, Delimiter, Options, [...Accumulator, Head]> : Delimiter extends '' ? S extends '' ? Accumulator : [...Accumulator, S] : [...Accumulator, S] :
+// Otherwise, return `string[]`
+string[] : never // Should never happen
+ : never; // Should never happen
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.8.0/node_modules/type-fest/source/replace.d.ts
+type ReplaceOptions = {
+  all?: boolean;
+};
+type DefaultReplaceOptions = {
+  all: false;
+};
+/**
+Represents a string with some or all matches replaced by a replacement.
+
+Use-case:
+- `kebab-case-path` to `dotted.path.notation`
+- Changing date/time format: `01-08-2042` → `01/08/2042`
+- Manipulation of type properties, for example, removal of prefixes
 
 @example
 ```
-import type {UnionMember, Primitive, LiteralToPrimitive} from 'type-fest';
+import type {Replace} from 'type-fest';
 
-type IsHomogenous<T extends Primitive> = [T] extends [LiteralToPrimitive<UnionMember<T>>] ? true : false;
+declare function replace<
+	Input extends string,
+	Search extends string,
+	Replacement extends string,
+>(
+	input: Input,
+	search: Search,
+	replacement: Replacement,
+): Replace<Input, Search, Replacement>;
 
-type T1 = IsHomogenous<1 | 2 | 3 | 4>;
-//=> true
+declare function replaceAll<
+	Input extends string,
+	Search extends string,
+	Replacement extends string,
+>(
+	input: Input,
+	search: Search,
+	replacement: Replacement,
+): Replace<Input, Search, Replacement, {all: true}>;
 
-type T2 = IsHomogenous<'foo' | 'bar'>;
-//=> true
+// The return type is the exact string literal, not just `string`.
 
-type T3 = IsHomogenous<'foo' | 'bar' | 1>;
-//=> false
-```
+replace('hello ?', '?', '🦄');
+//=> 'hello 🦄'
 
-Returns `never` when the input is `never`.
+replace('hello ??', '?', '❓');
+//=> 'hello ❓?'
 
-@example
-```
-import type {UnionMember} from 'type-fest';
+replaceAll('10:42:00', ':', '-');
+//=> '10-42-00'
 
-type LastNever = UnionMember<never>;
-//=> never
+replaceAll('__userName__', '__', '');
+//=> 'userName'
+
+replaceAll('My Cool Title', ' ', '');
+//=> 'MyCoolTitle'
 ```
 
-@category Type
+@category String
+@category Template literal
 */
-type UnionMember<T> = IsNever<T> extends true ? never : UnionToIntersection<T extends any ? () => T : never> extends (() => (infer R)) ? R : never;
+type Replace<Input extends string, Search extends string, Replacement extends string, Options extends ReplaceOptions = {}> = _Replace<Input, Search, Replacement, ApplyDefaultOptions<ReplaceOptions, DefaultReplaceOptions, Options>>;
+type _Replace<Input extends string, Search extends string, Replacement extends string, Options extends Required<ReplaceOptions>, Accumulator extends string = ''> = Search extends string // For distributing `Search`
+ ? Replacement extends string // For distributing `Replacement`
+ ? Input extends `${infer Head}${Search}${infer Tail}` ? Options['all'] extends true ? _Replace<Tail, Search, Replacement, Options, `${Accumulator}${Head}${Replacement}`> : `${Head}${Replacement}${Tail}` : `${Accumulator}${Input}` : never : never;
+//#endregion
+//#region src/currency/index.type.d.ts
+type CurrencyCode = keyof typeof CurrencyUtil.CURRENCY_ENUM;
+type CurrencyLocale = ValueOf<typeof CurrencyUtil.CURRENCY_ENUM>;
+interface FormatterOptions {
+  locales: [CurrencyLocale, CurrencyLocale];
+  currencySign: string;
+  currencySignPosition: "prefix" | "suffix" | "start" | "end";
+  currencyFormatOptions: Intl.NumberFormatOptions;
+  precision?: number | undefined;
+}
+//#endregion
+//#region src/currency/currencyUtil.d.ts
+/**
+ * 货币工具类
+ * - 基于 [`Intl.NumberFormat`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat) 进行本地化格式化
+ * - 支持精确小数位处理（依赖 `mathjs`）
+ */
+declare class CurrencyUtil {
+  /**
+   * 货币代码到 Locale 的映射枚举
+   * - 键为 ISO 4217 货币代码，值为 BCP 47 语言标签
+   * - 用于 `Intl.NumberFormat` 的本地化数字格式化
+   * - 格式示例基于 `Intl.NumberFormat` 对 `1,234,567.89` 的输出
+   *
+   * @example
+   * ```ts
+   * import { CurrencyUtil } from "@pawover/kit/utils";
+   * // 获取人民币的格式化 locale
+   * const locale = CurrencyUtil.CURRENCY_ENUM.CNY; // "zh-CN"
+   *
+   * // 结合 Intl.NumberFormat 使用
+   * new Intl.NumberFormat(CurrencyUtil.CURRENCY_ENUM.USD, {
+   *   style: "currency",
+   *   currency: "USD",
+   * }).format(1234.56); // "$1,234.56"
+   * ```
+   */
+  static readonly CURRENCY_ENUM: {
+    /** 美元（美国及美元化国家，Locale: 美式英语） → 1,234,567.89 */
+    readonly USD: "en-US";
+    /** 加拿大元（加拿大，Locale: 加拿大英语） → 1,234,567.89 */
+    readonly CAD: "en-CA";
+    /** 墨西哥比索（墨西哥，Locale: 墨西哥西班牙语） → 1,234,567.89 */
+    readonly MXN: "es-MX";
+    /** 巴西雷亚尔（巴西，Locale: 巴西葡萄牙语） → 1.234.567,89 */
+    readonly BRL: "pt-BR";
+    /** 阿根廷比索（阿根廷，Locale: 阿根廷西班牙语） → 1.234.567,89 */
+    readonly ARS: "es-AR";
+    /** 智利比索（智利，Locale: 智利西班牙语） → 1.234.567,89 */
+    readonly CLP: "es-CL";
+    /** 秘鲁新索尔（秘鲁，Locale: 秘鲁西班牙语） → 1,234,567.89 */
+    readonly PEN: "es-PE";
+    /** 哥伦比亚比索（哥伦比亚，Locale: 哥伦比亚西班牙语） → 1.234.567,89 */
+    readonly COP: "es-CO";
+    /** 哥斯达黎加科朗（哥斯达黎加，Locale: 哥斯达黎加西班牙语） → 1 234 567,89（空格千分位） */
+    readonly CRC: "es-CR";
+    /** 人民币（中国，Locale: 简体中文） → 1,234,567.89 */
+    readonly CNY: "zh-CN";
+    /** 港元（中国香港，Locale: 繁体中文+香港） → 1,234,567.89 */
+    readonly HKD: "zh-HK";
+    /** 澳门元（中国澳门，Locale: 繁体中文+澳门） → 1,234,567.89 */
+    readonly MOP: "zh-MO";
+    /** 日元（日本，Locale: 日语） → 1,234,567.89 */
+    readonly JPY: "ja-JP";
+    /** 韩元（韩国，Locale: 韩语） → 1,234,567.89 */
+    readonly KRW: "ko-KR";
+    /** 新加坡元（新加坡，Locale: 英语+新加坡） → 1,234,567.89 */
+    readonly SGD: "en-SG";
+    /** 泰铢（泰国，Locale: 泰语） → 1,234,567.89 */
+    readonly THB: "th-TH";
+    /** 印度卢比（印度，Locale: 英语+印度） → 12,34,567.89（2,2,3 分组） */
+    readonly INR: "en-IN";
+    /** 沙特里亚尔（沙特，Locale: 阿拉伯语+沙特） → ١٬٢٣٤٬٥٦٧٫٨٩（阿拉伯数字） */
+    readonly SAR: "ar-SA";
+    /** 阿联酋迪拉姆（阿联酋，Locale: 阿拉伯语+阿联酋） → 1,234,567.89 */
+    readonly AED: "ar-AE";
+    /** 印尼盾（印尼，Locale: 印尼语） → 1.234.567,89 */
+    readonly IDR: "id-ID";
+    /** 马来西亚林吉特（马来西亚，Locale: 马来语） → 1,234,567.89 */
+    readonly MYR: "ms-MY";
+    /** 越南盾（越南，Locale: 越南语） → 1.234.567,89 */
+    readonly VND: "vi-VN";
+    /** 菲律宾比索（菲律宾，Locale: 英语+菲律宾） → 1,234,567.89 */
+    readonly PHP: "en-PH";
+    /** 巴基斯坦卢比（巴基斯坦，Locale: 英语+巴基斯坦） → 1,234,567.89 */
+    readonly PKR: "en-PK";
+    /** 新台币（中国台湾地区，Locale: 繁体中文+台湾） → 1,234,567.89 */
+    readonly TWD: "zh-TW";
+    /** 欧元（德国，Locale: 德语+德国，代表欧元区） → 1.234.567,89 */
+    readonly EUR: "de-DE";
+    /** 英镑（英国，Locale: 英式英语） → 1,234,567.89 */
+    readonly GBP: "en-GB";
+    /** 瑞士法郎（瑞士，Locale: 德语+瑞士） → 1'234'567.89 */
+    readonly CHF: "de-CH";
+    /** 瑞典克朗（瑞典，Locale: 瑞典语） → 1 234 567,89（空格千分位） */
+    readonly SEK: "sv-SE";
+    /** 挪威克朗（挪威，Locale: 挪威语） → 1 234 567,89（空格千分位） */
+    readonly NOK: "no-NO";
+    /** 丹麦克朗（丹麦，Locale: 丹麦语） → 1.234.567,89 */
+    readonly DKK: "da-DK";
+    /** 波兰兹罗提（波兰，Locale: 波兰语） → 1 234 567,89（空格千分位） */
+    readonly PLN: "pl-PL";
+    /** 捷克克朗（捷克，Locale: 捷克语） → 1 234 567,89（空格千分位） */
+    readonly CZK: "cs-CZ";
+    /** 匈牙利福林（匈牙利，Locale: 匈牙利语） → 1 234 567,89（空格千分位） */
+    readonly HUF: "hu-HU";
+    /** 俄罗斯卢布（俄罗斯，Locale: 俄语） → 1 234 567,89（空格千分位） */
+    readonly RUB: "ru-RU";
+    /** 罗马尼亚列伊（罗马尼亚，Locale: 罗马尼亚语） → 1.234.567,89 */
+    readonly RON: "ro-RO";
+    /** 乌克兰格里夫纳（乌克兰，Locale: 乌克兰语） → 1 234 567,89（空格千分位） */
+    readonly UAH: "uk-UA";
+    /** 澳大利亚元（澳大利亚，Locale: 澳大利亚英语） → 1,234,567.89 */
+    readonly AUD: "en-AU";
+    /** 新西兰元（新西兰，Locale: 新西兰英语） → 1,234,567.89 */
+    readonly NZD: "en-NZ";
+    /** 南非兰特（南非，Locale: 英语+南非） → 1 234 567,89（空格千分位） */
+    readonly ZAR: "en-ZA";
+    /** 埃及镑（埃及，Locale: 阿拉伯语+埃及） → ١٬٢٣٤٬٥٦٧٫٨٩（阿拉伯数字） */
+    readonly EGP: "ar-EG";
+    /** 土耳其里拉（土耳其，Locale: 土耳其语） → 1.234.567,89 */
+    readonly TRY: "tr-TR";
+    /** 以色列新谢克尔（以色列，Locale: 希伯来语） → 1,234,567.89 */
+    readonly ILS: "he-IL";
+    /** 摩洛哥迪拉姆（摩洛哥，Locale: 阿拉伯语+摩洛哥） → 1.234.567,89 */
+    readonly MAD: "ar-MA";
+    /** 科威特第纳尔（科威特，Locale: 阿拉伯语+科威特） → ١٬٢٣٤٬٥٦٧٫٨٩（阿拉伯数字） */
+    readonly KWD: "ar-KW";
+    /** 卡塔尔里亚尔（卡塔尔，Locale: 阿拉伯语+卡塔尔） → ١٬٢٣٤٬٥٦٧٫٨٩（阿拉伯数字） */
+    readonly QAR: "ar-QA";
+    /** 尼日利亚奈拉（尼日利亚，Locale: 英语+尼日利亚） → 1,234,567.89 */
+    readonly NGN: "en-NG";
+    /** 太平洋法郎（法属波利尼西亚，Locale: 法语+太平洋） → 1[U+202F]234[U+202F]567,89（窄空格千分位） */
+    readonly XPF: "fr-PF";
+  };
+  /**
+   * 货币格式化
+   * - 使用 `Intl.NumberFormat` 进行本地化数字格式化
+   * - 支持自定义货币符号及位置（前缀/后缀/首/尾）
+   * - 当值为 `null` 或 `undefined` 时返回 `null`
+   *
+   * @param value 待格式化的数值
+   * @param options 格式化选项
+   * @param options.locales locale 元组，同时指定格式化语言和货币所属地区
+   * @param options.currencySign 货币符号（如 `¥`、`$`、`€`）
+   * @param options.currencySignPosition 货币符号位置
+   * @param options.currencyFormatOptions `Intl.NumberFormatOptions` 格式化选项
+   * @returns 格式化后的货币字符串，无效输入返回 `null`
+   *
+   * @example
+   * ```ts
+   * import { CurrencyUtil } from "@pawover/kit/utils";
+   *
+   * // 重载 1: 有效数值
+   * CurrencyUtil.currencyFormatter(1234.56, {
+   *   locales: [CurrencyUtil.CURRENCY_ENUM.CNY, CurrencyUtil.CURRENCY_ENUM.USD],
+   *   currencySign: "¥",
+   *   currencySignPosition: "prefix",
+   *   currencyFormatOptions: { style: "currency", currency: "CNY" },
+   * }); // "¥ 1,234.56"
+   *
+   * // 重载 2: null / undefined
+   * CurrencyUtil.currencyFormatter(null, options); // null
+   * CurrencyUtil.currencyFormatter(undefined, options); // null
+   * ```
+   */
+  static currencyFormatter(value: string | number, options: FormatterOptions): string;
+  static currencyFormatter(value: string | number | null | undefined, options: FormatterOptions): string | null;
+  /**
+   * 将任意数值转换为精确的十进制值
+   * - 基于 `mathjs` 的 `bignumber` 处理，避免浮点数精度问题
+   * - 当值为 `null` 或 `undefined` 时返回 `null`
+   *
+   * @param mathJsInstance `mathjs` 实例
+   * @param value 待转换的数值
+   * @param precision 小数精度位数
+   * @param stringMode 是否返回字符串类型，默认 `true`
+   * @returns 精确的十进制值，无效输入返回 `null`
+   *
+   * @example
+   * ```ts
+   * import { create, all } from "mathjs";
+   * import { CurrencyUtil } from "@pawover/kit/utils";
+   *
+   * const math = create(all);
+   *
+   * // 重载 1: 有效值 + stringMode = true（默认）
+   * CurrencyUtil.toRealValue(math, "0.1"); // "0.1"
+   * CurrencyUtil.toRealValue(math, 0.1 + 0.2, 2); // "0.30"
+   *
+   * // 重载 2: stringMode = false → number
+   * CurrencyUtil.toRealValue(math, "0.1", undefined, false); // 0.1
+   *
+   * // 重载 3: null / undefined
+   * CurrencyUtil.toRealValue(math, null); // null
+   * ```
+   */
+  static toRealValue(mathJsInstance: MathJsInstance, value: string | number, precision?: number | undefined, stringMode?: boolean | undefined): string | number;
+  static toRealValue(mathJsInstance: MathJsInstance, value: string | number | null | undefined, precision?: number | undefined, stringMode?: boolean | undefined): string | number | null;
+}
+//#endregion
+//#region src/dateTime/dateTimeUtil.d.ts
+/**
+ * 日期工具类
+ */
+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";
+    readonly ISO_DATE_TIME: "yyyy-MM-dd HH:mm:ss";
+    readonly ISO_DATE_TIME_MS: "yyyy-MM-dd HH:mm:ss.SSS";
+    readonly ISO_DATETIME_TZ: "yyyy-MM-dd'T'HH:mm:ssXXX";
+    readonly ISO_DATETIME_TZ_MS: "yyyy-MM-dd'T'HH:mm:ss.SSSXXX";
+    readonly US_DATE: "MM/dd/yyyy";
+    readonly US_DATE_TIME: "MM/dd/yyyy HH:mm:ss";
+    readonly US_DATE_SHORT_YEAR: "MM/dd/yy";
+    readonly EU_DATE: "dd/MM/yyyy";
+    readonly EU_DATE_TIME: "dd/MM/yyyy HH:mm:ss";
+    readonly CN_DATE: "yyyy年MM月dd日";
+    readonly CN_DATE_TIME: "yyyy年MM月dd日 HH时mm分ss秒";
+    readonly CN_DATE_WEEKDAY: "yyyy年MM月dd日 EEE";
+    readonly CN_WEEKDAY_FULL: "EEEE";
+    readonly SHORT_DATE: "yy-MM-dd";
+    readonly SHORT_DATE_SLASH: "yy/MM/dd";
+    readonly MONTH_DAY: "MM-dd";
+    readonly MONTH_DAY_CN: "MM月dd日";
+    readonly DATE_WITH_WEEKDAY_SHORT: "yyyy-MM-dd (EEE)";
+    readonly DATE_WITH_WEEKDAY_FULL: "yyyy-MM-dd (EEEE)";
+    readonly TIME_24: "HH:mm:ss";
+    readonly TIME_24_NO_SEC: "HH:mm";
+    readonly TIME_12: "hh:mm:ss a";
+    readonly TIME_12_NO_SEC: "hh:mm a";
+    readonly TIMESTAMP: "yyyyMMddHHmmss";
+    readonly TIMESTAMP_MS: "yyyyMMddHHmmssSSS";
+    readonly RFC2822: "EEE, dd MMM yyyy HH:mm:ss xxx";
+    readonly READABLE_DATE: "MMM dd, yyyy";
+    readonly READABLE_DATE_TIME: "MMM dd, yyyy HH:mm";
+    readonly COMPACT_DATETIME: "yyyyMMdd_HHmmss";
+  };
+  /**
+   * 获取当前时区信息
+   *
+   * @returns 时区信息对象 (UTC偏移和时区名称)
+   * @example
+   * ```ts
+   * DateTimeUtil.getTimeZone(); // { UTC: "UTC+8", timeZone: "Asia/Shanghai" }
+   * ```
+   */
+  static getTimeZone(): {
+    UTC: string;
+    timeZone: string;
+  };
+}
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.8.0/node_modules/type-fest/source/union-to-tuple.d.ts
+//#region src/env/envUtil.d.ts
 /**
-Convert a union type into an unordered tuple type of its elements.
-
-"Unordered" means the elements of the tuple are not guaranteed to be in the same order as in the union type. The arrangement can appear random and may change at any time.
-
-This can be useful when you have objects with a finite set of keys and want a type defining only the allowed keys, but do not want to repeat yourself.
-
-@example
-```
-import type {UnionToTuple} from 'type-fest';
-
-type Numbers = 1 | 2 | 3;
-type NumbersTuple = UnionToTuple<Numbers>;
-//=> [1, 2, 3]
-```
-
-@example
-```
-import type {UnionToTuple} from 'type-fest';
-
-const pets = {
-	dog: '🐶',
-	cat: '🐱',
-	snake: '🐍',
-};
-
-type Pet = keyof typeof pets;
-//=> 'dog' | 'cat' | 'snake'
-
-const petList = Object.keys(pets) as UnionToTuple<Pet>;
-//=> ['dog', 'cat', 'snake']
-```
-
-@category Array
-*/
-type UnionToTuple<Union> = _UnionToTuple<Union> extends (infer Result extends UnknownArray) ? Result : never; // 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]>;
+ * 环境检查工具类
+ */
+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;
+  /**
+   * 检测当前设备是否为桌面设备
+   *
+   * @param minWidth - 桌面设备最小宽度（默认 1200px）
+   * @param minScreenSize - 桌面设备最小屏幕尺寸（默认 10英寸）
+   * @param dpi - 标准 DPI 基准（默认 160）
+   * @returns 是否为桌面设备
+   * @example
+   * ```ts
+   * // 假设 window.innerWidth = 1920
+   * EnvUtil.isDesktop(); // true
+   *
+   * // 自定义阈值
+   * EnvUtil.isDesktop(1440, 13); // 更严格的桌面检测
+   * ```
+   */
+  static isDesktop(minWidth?: number, minScreenSize?: number, dpi?: number): boolean;
+  /**
+   * 检测当前设备是否为 Windows 桌面设备
+   *
+   * @param minWidth - 桌面设备最小宽度（默认 1200px）
+   * @param minScreenSize - 桌面设备最小屏幕尺寸（默认 10英寸）
+   * @param dpi - 标准 DPI 基准（默认 160）
+   * @returns 是否为 Windows 桌面设备
+   * @example
+   * ```ts
+   * // UA contains Windows
+   * EnvUtil.isWindowsDesktop(); // true
+   * ```
+   */
+  static isWindowsDesktop(minWidth?: number, minScreenSize?: number, dpi?: number): boolean;
+  /**
+   * 检测当前设备是否为 macOS 桌面设备
+   *
+   * @param minWidth - 桌面设备最小宽度（默认 1200px）
+   * @param minScreenSize - 桌面设备最小屏幕尺寸（默认 10英寸）
+   * @param dpi - 标准 DPI 基准（默认 160）
+   * @returns 是否为 macOS 桌面设备
+   * @example
+   * ```ts
+   * // UA contains Macintosh
+   * EnvUtil.isMacOSDesktop(); // true
+   * ```
+   */
+  static isMacOSDesktop(minWidth?: number, minScreenSize?: number, dpi?: number): boolean;
+  /**
+   * 检测当前设备是否为移动设备
+   *
+   * @param maxWidth - 移动设备最大宽度（默认 768px）
+   * @param dpi - 标准 DPI 基准（默认 160）
+   * @returns 是否为移动设备
+   * @example
+   * ```ts
+   * // 假设 window.innerWidth = 500
+   * EnvUtil.isMobile(); // true
+   * ```
+   */
+  static isMobile(maxWidth?: number, dpi?: number): boolean;
+  /**
+   * 检测当前设备是否为IOS移动设备
+   *
+   * @param maxWidth - 移动设备最大宽度（默认 768px）
+   * @param dpi - 标准 DPI 基准（默认 160）
+   * @returns 是否为 iOS 移动设备 (iPhone/iPod)
+   * @example
+   * ```ts
+   * // UA contains iPhone
+   * EnvUtil.isIOSMobile(); // true
+   * ```
+   */
+  static isIOSMobile(maxWidth?: number, dpi?: number): boolean;
+  /**
+   * 检测当前设备是否为平板
+   *
+   * @param minWidth - 平板最小宽度（默认 768px）
+   * @param maxWidth - 平板最大宽度（默认 1200px）
+   * @param dpi - 标准 DPI 基准（默认 160）
+   * @returns 是否为平板设备
+   * @example
+   * ```ts
+   * // 假设 window.innerWidth = 1000
+   * EnvUtil.isTablet(); // true
+   * ```
+   */
+  static isTablet(minWidth?: number, maxWidth?: number, dpi?: number): boolean;
+}
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.8.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.
-
-Use-case: You want to define a single model where the only thing that changes is whether or not some of the keys are optional.
-
-@example
-```
-import type {SetOptional} from 'type-fest';
-
-type Foo = {
-	a: number;
-	b?: string;
-	c: boolean;
-};
-
-type SomeOptional = SetOptional<Foo, 'b' | 'c'>;
-//=> {a: number; b?: string; c?: boolean}
-```
-
-@category Object
-*/
-type SetOptional<BaseType, Keys extends keyof BaseType> = (BaseType extends ((...arguments_: never) => any) ? (...arguments_: Parameters<BaseType>) => ReturnType<BaseType> : unknown) & _SetOptional<BaseType, Keys>;
-type _SetOptional<BaseType, Keys extends keyof BaseType> = BaseType extends unknown // To distribute `BaseType` when it's a union type.
- ? Simplify<
-// Pick just the keys that are readonly from the base type.
-Except<BaseType, Keys> &
-// Pick the keys that should be mutable from the base type and make them mutable.
-Partial<HomomorphicPick<BaseType, Keys>>> : never;
+//#region ../../node_modules/.pnpm/@pawover+types@0.0.4_@types+react@19.2.15_typescript@6.0.3/node_modules/@pawover/types/dist/index.d.ts
+/** 任意对象类型 */
+type AnyObject<K extends PropertyKey = PropertyKey, T = any> = Record<K, T>;
+/** 普通对象类型 */
+type PlainObject<K extends PropertyKey = PropertyKey, T = unknown> = Record<K, T>;
+/** 描述树类型 */
+type TreeLike<T extends AnyObject, CK extends string = "children"> = T & Record<CK, TreeLike<T, CK>[]>;
+/** 描述函数类型 */
+type AnyFunction<P extends any[] = any[], R = any> = (...arg: P) => R;
+/** 描述异步函数类型 */
+type AnyAsyncFunction<P extends any[] = any[], R = any> = (...args: P) => Promise<R>;
+/** 描述生成器函数类型 */
+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
-//#region ../../node_modules/.pnpm/type-fest@5.8.0/node_modules/type-fest/source/value-of.d.ts
+//#region src/function/functionUtil.d.ts
 /**
-Create a union of the given object's values, and optionally specify which keys to get the values from.
-
-Please upvote [this issue](https://github.com/microsoft/TypeScript/issues/31438) if you want to have this type as a built-in in TypeScript.
-
-@example
-```
-import type {ValueOf} from 'type-fest';
-
-type A = ValueOf<{id: number; name: string; active: boolean}>;
-//=> string | number | boolean
-
-type B = ValueOf<{id: number; name: string; active: boolean}, 'name'>;
-//=> string
-
-type C = ValueOf<{id: number; name: string; active: boolean}, 'id' | 'name'>;
-//=> string | number
-```
-
-@category Object
-*/
-type ValueOf<ObjectType, ValueType extends keyof ObjectType = keyof ObjectType> = ObjectType[ValueType];
+ * 函数工具类
+ */
+declare class FunctionUtil {
+  /**
+   *将 Promise 转换为 `[err, result]` 格式，方便 async/await 错误处理
+   *
+   * @param promise 待处理的 Promise
+   * @param errorExt 附加到 error 对象的扩展信息（注意：如果原 error 是 Error 实例，扩展属性可能会覆盖或无法正确合并非枚举属性）
+   * @returns `[err, null]` 或 `[null, data]`
+   * @example
+   * ```ts
+   * const [err, data] = await FunctionUtil.to(someAsyncFunc());
+   * ```
+   */
+  static to<T, U = Error>(promise: Readonly<Promise<T>>, errorExt?: PlainObject): Promise<[U, undefined] | [null, T]>;
+  /**
+   * 将 Arguments 对象转换为数组
+   *
+   * ⚠️ 注意：TypeScript 官方推荐使用 rest parameters (...args) 替代 arguments
+   * 本函数仅用于处理遗留代码或特殊场景（如装饰器中需保留 this 绑定）
+   *
+   * @param args Arguments 对象（必须为类数组对象）
+   * @param start 起始索引（可选，默认为 0）
+   * @returns 转换后的数组，元素类型为 T
+   *
+   * @throws TypeError 如果 args 为 null 或 undefined
+   *
+   * @example
+   * ```ts
+   * // 遗留代码场景
+   * function legacyFn(a: number, b: string) {
+   *   const argsArray = FunctionUtil.toArgs(arguments);
+   *   // argsArray: unknown[]
+   * }
+   *
+   * // 现代替代方案（推荐）
+   * function modernFn(a: number, b: string, ...rest: unknown[]) {
+   *   // rest 已经是数组，无需 toArgs
+   * }
+   *
+   * // 参数截取
+   * function skipFirst(...args: unknown[]) {
+   *   const rest = FunctionUtil.toArgs(arguments, 1);
+   *   // rest: unknown[]，跳过第一个参数
+   * }
+   * ```
+   */
+  static toArgs<T = unknown>(args: IArguments, start?: number | undefined): T[];
+  /**
+   * 将同步或异步函数统一包装为 Promise
+   * - 自动捕获同步异常
+   *
+   * @param fn 返回值可为同步值或 Promise 的函数
+   * @returns 标准化的 Promise
+   *
+   * @example
+   * ```ts
+   * // 同步函数
+   * FunctionUtil.toPromise(() => 42).then(v => console.log(v)); // 42
+   *
+   * // 异步函数
+   * FunctionUtil.toPromise(async () => await fetchData()).then(data => ...);
+   *
+   * // 异常处理
+   * FunctionUtil.toPromise(() => { throw new Error('fail'); }).catch(err => console.error(err)); // 捕获同步异常
+   * ```
+   */
+  static toPromise<T>(fn: () => T | Promise<T>): Promise<T>;
+}
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.8.0/node_modules/type-fest/source/split.d.ts
+//#region src/mime/mimeUtil.d.ts
 /**
-Split options.
-
-@see {@link Split}
-*/
-type SplitOptions = {
+ * MIME 工具类
+ */
+declare class MimeUtil {
+  /**
+   * 文件类型 MIME 常量
+   * - 每个类型对应具体的文件扩展名
+   */
+  static readonly FILE_MIME: {
+    /** 普通文本文件（.txt） */
+    readonly TEXT: "text/plain";
+    /** 超文本标记语言文档（.html/.htm） */
+    readonly HTML: "text/html";
+    /** 层叠样式表文件（.css） */
+    readonly CSS: "text/css";
+    /** 逗号分隔值文件/表格数据（.csv） */
+    readonly CSV: "text/csv";
+    /** 制表符分隔值文件（.tsv） */
+    readonly TSV: "text/tab-separated-values";
+    /** XML 文档（.xml） */
+    readonly XML: "application/xml";
+    /** XML 文档/兼容值 */
+    readonly XML_LEGACY: "text/xml";
+    /** XHTML 文档（.xhtml/.xht） */
+    readonly XHTML: "application/xhtml+xml";
+    /** JavaScript 文件（.js） */
+    readonly JS: "text/javascript";
+    /** TypeScript 文件（.ts） */
+    readonly TS: "text/typescript";
+    /** Python 文件（.py） */
+    readonly PY: "text/x-python";
+    /** Shell 脚本 (.sh) */
+    readonly SH: "text/x-sh";
+    /** C 语言源文件（.c） */
+    readonly C: "text/x-c";
+    /** C++ 源文件（.cpp/.cc/.cxx） */
+    readonly CPP: "text/x-c++";
+    /** C# 源文件（.cs） */
+    readonly CSHARP: "text/x-csharp";
+    /** Java 源文件（.java） */
+    readonly JAVA: "text/x-java";
+    /** Go 源文件（.go） */
+    readonly GO: "text/x-go";
+    /** Rust 源文件（.rs） */
+    readonly RUST: "text/x-rust";
+    /** PHP 文件（.php） */
+    readonly PHP: "text/x-php";
+    /** Ruby 文件（.rb） */
+    readonly RUBY: "text/x-ruby";
+    /** Swift 源文件（.swift） */
+    readonly SWIFT: "text/x-swift";
+    /** YAML 文档（.yaml/.yml） */
+    readonly YAML: "application/yaml";
+    /** YAML 文档/兼容值 */
+    readonly YAML_LEGACY: "text/vnd.yaml";
+    /** TOML 文档（.toml） */
+    readonly TOML: "application/toml";
+    /** TOML 文档/兼容值 */
+    readonly TOML_LEGACY: "text/x-toml";
+    /** SQL 脚本（.sql） */
+    readonly SQL: "application/sql";
+    /** SQL 脚本/兼容值 */
+    readonly SQL_LEGACY: "text/x-sql";
+    /** Markdown 格式文档（.md/.markdown） */
+    readonly MARKDOWN: "text/markdown";
+    /** 富文本格式文档（.rtf） */
+    readonly RTF: "application/rtf";
+    /** iCalendar 日历格式（.ics） */
+    readonly CALENDAR: "text/calendar";
+    /** JPEG 图像（.jpg/.jpeg） */
+    readonly JPEG: "image/jpeg";
+    /** JPG 图像（JPEG 别名，.jpg） */
+    readonly JPG: "image/jpeg";
+    /** PNG 图像/无损压缩，支持透明（.png） */
+    readonly PNG: "image/png";
+    /** GIF 图像/支持动画（.gif） */
+    readonly GIF: "image/gif";
+    /** Windows 位图（.bmp） */
+    readonly BMP: "image/bmp";
+    /** SVG 向量图形（.svg） */
+    readonly SVG: "image/svg+xml";
+    /** APNG 动态图像（.apng） */
+    readonly APNG: "image/apng";
+    /** AVIF 图像/高效压缩（.avif） */
+    readonly AVIF: "image/avif";
+    /** 图标文件格式（.ico） */
+    readonly ICO: "image/vnd.microsoft.icon";
+    /** 图标文件格式/兼容值（.ico） */
+    readonly ICO_LEGACY: "image/x-icon";
+    /** WebP 图像/高效压缩（.webp） */
+    readonly WEBP: "image/webp";
+    /** TIFF 图像（.tif/.tiff） */
+    readonly TIFF: "image/tiff";
+    /** HEIC 图像/高效编码（.heic） */
+    readonly HEIC: "image/heic";
+    /** HEIF 图像/高效编码（.heif） */
+    readonly HEIF: "image/heif";
+    /** 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） */
+    readonly OGG_AUDIO: "audio/ogg";
+    /** Opus 音频（.opus） */
+    readonly OPUS: "audio/opus";
+    /** FLAC 无损音频（.flac） */
+    readonly FLAC: "audio/flac";
+    /** WAV 音频（.wav） */
+    readonly WAV: "audio/wav";
+    /** WebM 音频（.weba） */
+    readonly WEBM_AUDIO: "audio/webm";
+    /** RealAudio 音频（.ra/.ram） */
+    readonly REAL_AUDIO: "audio/x-pn-realaudio";
+    /** MP4 视频（.mp4） */
+    readonly MP4: "video/mp4";
+    /** MPEG 视频（.mpeg/.mpg） */
+    readonly MPEG: "video/mpeg";
+    /** OGG 视频（.ogv） */
+    readonly OGG_VIDEO: "video/ogg";
+    /** AVI 视频（.avi） */
+    readonly AVI: "video/x-msvideo";
+    /** 3GPP 视频（.3gp） */
+    readonly THREE_GPP: "video/3gpp";
+    /** 3GPP2 视频（.3g2） */
+    readonly THREE_GPP2: "video/3gpp2";
+    /** WebM 视频（.webm） */
+    readonly WEBM: "video/webm";
+    /** Matroska 视频（.mkv） */
+    readonly MKV: "video/x-matroska";
+    /** Matroska 音频（.mka） */
+    readonly MKA: "audio/x-matroska";
+    /** QuickTime 视频（.mov） */
+    readonly QUICKTIME: "video/quicktime";
+    /** PDF 文档（.pdf） */
+    readonly PDF: "application/pdf";
+    /** Word 97-2003 文档（.doc） */
+    readonly DOC: "application/msword";
+    /** Word 2007+ 文档（.docx） */
+    readonly DOCX: "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
+    /** Excel 2007+ 工作簿（.xlsx） */
+    readonly XLSX: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
+    /** 启用宏的Excel工作簿（.xlsm） */
+    readonly XLSM: "application/vnd.ms-excel.sheet.macroEnabled.12";
+    /** Excel模板文件（.xltx） */
+    readonly XLTX: "application/vnd.openxmlformats-officedocument.spreadsheetml.template";
+    /** PowerPoint 2007+ 演示文稿（.pptx） */
+    readonly PPTX: "application/vnd.openxmlformats-officedocument.presentationml.presentation";
+    /** PowerPoint 97-2003 演示文稿（.ppt） */
+    readonly PPT: "application/vnd.ms-powerpoint";
+    /** OpenDocument 文本文档（.odt） */
+    readonly ODT: "application/vnd.oasis.opendocument.text";
+    /** OpenDocument 表格文档（.ods） */
+    readonly ODS: "application/vnd.oasis.opendocument.spreadsheet";
+    /** OpenDocument 演示文稿（.odp） */
+    readonly ODP: "application/vnd.oasis.opendocument.presentation";
+    /** EPUB 电子书（.epub） */
+    readonly EPUB: "application/epub+zip";
+    /** Kindle 电子书（.azw） */
+    readonly AZW: "application/vnd.amazon.ebook";
+    /** ZIP 压缩文件（.zip） */
+    readonly ZIP: "application/zip";
+    /** GZIP 压缩文件（.gz） */
+    readonly GZIP: "application/gzip";
+    /** TAR 归档文件（.tar） */
+    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";
+    /** RAR 压缩文件（.rar） */
+    readonly RAR: "application/vnd.rar";
+    /** XZ 压缩文件（.xz） */
+    readonly XZ: "application/x-xz";
+    /** Zstandard 压缩文件（.zst） */
+    readonly ZSTD: "application/zstd";
+    /** ISO 光盘镜像（.iso） */
+    readonly ISO9660_IMAGE: "application/x-iso9660-image";
+    /** JSON 数据格式（.json） */
+    readonly JSON: "application/json";
+    /** JSON-LD 格式（.jsonld） */
+    readonly LD_JSON: "application/ld+json";
+    /** Web App Manifest（.webmanifest） */
+    readonly MANIFEST: "application/manifest+json";
+    /** Java 归档文件（.jar） */
+    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";
+    /** 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";
+  };
   /**
-	When enabled, instantiations with non-literal string types (e.g., `string`, `Uppercase<string>`, `on${string}`) simply return back `string[]` without performing any splitting, as the exact structure cannot be statically determined.
-
-	@default true
-
-	@example
-	```ts
-	import type {Split} from 'type-fest';
-
-	type Example1 = Split<`foo.${string}.bar`, '.', {strictLiteralChecks: false}>;
-	//=> ['foo', string, 'bar']
-
-	type Example2 = Split<`foo.${string}`, '.', {strictLiteralChecks: true}>;
-	//=> string[]
-
-	type Example3 = Split<'foobarbaz', `b${string}`, {strictLiteralChecks: false}>;
-	//=> ['foo', 'r', 'z']
-
-	type Example4 = Split<'foobarbaz', `b${string}`, {strictLiteralChecks: true}>;
-	//=> string[]
-	```
-	*/
-  strictLiteralChecks?: boolean;
-};
-type DefaultSplitOptions = {
-  strictLiteralChecks: true;
-};
-/**
-Represents an array of strings split using a given character or character set.
-
-Use-case: Defining the return type of a method like `String.prototype.split`.
-
-@example
-```
-import type {Split} from 'type-fest';
-
-declare function split<S extends string, D extends string>(string: S, separator: D): Split<S, D>;
-
-type Item = 'foo' | 'bar' | 'baz' | 'waldo';
-const items = 'foo,bar,baz,waldo';
-const array: Item[] = split(items, ',');
-```
-
-@see {@link SplitOptions}
-
-@category String
-@category Template literal
-*/
-type Split<S extends string, Delimiter extends string, Options extends SplitOptions = {}> = SplitHelper<S, Delimiter, ApplyDefaultOptions<SplitOptions, DefaultSplitOptions, Options>>;
-type SplitHelper<S extends string, Delimiter extends string, Options extends Required<SplitOptions>, Accumulator extends string[] = []> = S extends string // For distributing `S`
- ? Delimiter extends string // For distributing `Delimiter`
- ?
-// If `strictLiteralChecks` is `false` OR `S` and `Delimiter` both are string literals, then perform the split
-Or<Not<Options['strictLiteralChecks']>, And<IsStringLiteral<S>, IsStringLiteral<Delimiter>>> extends true ? S extends `${infer Head}${Delimiter}${infer Tail}` ? SplitHelper<Tail, Delimiter, Options, [...Accumulator, Head]> : Delimiter extends '' ? S extends '' ? Accumulator : [...Accumulator, S] : [...Accumulator, S] :
-// Otherwise, return `string[]`
-string[] : never // Should never happen
- : never; // Should never happen
+   * 协议/内容类型 MIME 常量
+   * - 用于 HTTP 请求/响应内容协商，无对应文件扩展名
+   */
+  static readonly PROTOCOL_MIME: {
+    /** 通用二进制数据流 */
+    readonly OCTET_STREAM: "application/octet-stream";
+    /** URL 编码表单 */
+    readonly FORM_URLENCODED: "application/x-www-form-urlencoded";
+    /** multipart 表单 */
+    readonly FORM_DATA: "multipart/form-data";
+    /** Server-Sent Events 数据流 */
+    readonly EVENT_STREAM: "text/event-stream";
+    /** 问题详情 JSON（RFC 9457） */
+    readonly PROBLEM_JSON: "application/problem+json";
+    /** JSON Patch（RFC 6902） */
+    readonly JSON_PATCH: "application/json-patch+json";
+    /** JSON Merge Patch（RFC 7386） */
+    readonly MERGE_PATCH_JSON: "application/merge-patch+json";
+  };
+  /**
+   * 根据文件后缀名获取对应的标准 MIME 类型（含历史兼容值）
+   * - 支持带 `.` 或不带 `.` 的后缀名，不区分大小写
+   * - 元组第一项始终为 IANA 官方标准 MIME，后续项为历史兼容值
+   * - 仅查询文件类型 MIME，不包含无后缀对应的协议类型
+   *
+   * @param extension 文件后缀名（如 `".png"` / `"png"` / `".PNG"`）
+   * @returns 标准 MIME + 兼容值的元组；如无匹配则返回 `undefined`
+   * @example
+   * ```ts
+   * MimeUtil.fromExtension(".png");  // ["image/png"]
+   * MimeUtil.fromExtension("ico");   // ["image/vnd.microsoft.icon", "image/x-icon"]
+   * MimeUtil.fromExtension(".xml");  // ["application/xml", "text/xml"]
+   * MimeUtil.fromExtension(".xyz");  // undefined
+   * ```
+   */
+  static fromExtension(extension: string): readonly [string, ...string[]] | undefined;
+  /**
+   * 根据 MIME 类型获取对应的文件后缀名列表
+   * - 一个 MIME 类型可能对应多个后缀名（如 `text/html` → `.html` / `.htm`）
+   * - 兼容值和标准值映射到相同的后缀（如 `image/x-icon` 和 `image/vnd.microsoft.icon` 均返回 `[".ico"]`）
+   * - 仅查询文件类型 MIME，协议类型无对应后缀
+   *
+   * @param mime MIME 类型字符串（如 `"image/png"` / `"IMAGE/PNG"`）
+   * @returns 文件后缀名列表；如无匹配则返回 `undefined`
+   * @example
+   * ```ts
+   * MimeUtil.toExtension("IMAGE/PNG");                    // [".png"]
+   * MimeUtil.toExtension("text/html");                    // [".html", ".htm"]
+   * MimeUtil.toExtension("image/jpeg");                   // [".jpg", ".jpeg"]
+   * MimeUtil.toExtension("application/octet-stream");     // undefined
+   * ```
+   */
+  static toExtension(mime: string): readonly [string, ...string[]] | undefined;
+}
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.8.0/node_modules/type-fest/source/replace.d.ts
-type ReplaceOptions = {
-  all?: boolean;
-};
-type DefaultReplaceOptions = {
-  all: false;
-};
+//#region src/number/numberUtil.d.ts
 /**
-Represents a string with some or all matches replaced by a replacement.
-
-Use-case:
-- `kebab-case-path` to `dotted.path.notation`
-- Changing date/time format: `01-08-2042` → `01/08/2042`
-- Manipulation of type properties, for example, removal of prefixes
-
-@example
-```
-import type {Replace} from 'type-fest';
-
-declare function replace<
-	Input extends string,
-	Search extends string,
-	Replacement extends string,
->(
-	input: Input,
-	search: Search,
-	replacement: Replacement,
-): Replace<Input, Search, Replacement>;
-
-declare function replaceAll<
-	Input extends string,
-	Search extends string,
-	Replacement extends string,
->(
-	input: Input,
-	search: Search,
-	replacement: Replacement,
-): Replace<Input, Search, Replacement, {all: true}>;
-
-// The return type is the exact string literal, not just `string`.
-
-replace('hello ?', '?', '🦄');
-//=> 'hello 🦄'
-
-replace('hello ??', '?', '❓');
-//=> 'hello ❓?'
-
-replaceAll('10:42:00', ':', '-');
-//=> '10-42-00'
-
-replaceAll('__userName__', '__', '');
-//=> 'userName'
-
-replaceAll('My Cool Title', ' ', '');
-//=> 'MyCoolTitle'
-```
-
-@category String
-@category Template literal
-*/
-type Replace<Input extends string, Search extends string, Replacement extends string, Options extends ReplaceOptions = {}> = _Replace<Input, Search, Replacement, ApplyDefaultOptions<ReplaceOptions, DefaultReplaceOptions, Options>>;
-type _Replace<Input extends string, Search extends string, Replacement extends string, Options extends Required<ReplaceOptions>, Accumulator extends string = ''> = Search extends string // For distributing `Search`
- ? Replacement extends string // For distributing `Replacement`
- ? Input extends `${infer Head}${Search}${infer Tail}` ? Options['all'] extends true ? _Replace<Tail, Search, Replacement, Options, `${Accumulator}${Head}${Replacement}`> : `${Head}${Replacement}${Tail}` : `${Accumulator}${Input}` : never : never;
+ * 数字工具类
+ */
+declare class NumberUtil {
+  /**
+   * 数字区间检查函数
+   *
+   * @param input 待检查数字
+   * @param interval 由两个数字组成的元组 [left, right]
+   * @param includeLeft 是否包含左边界（默认 true）
+   * @param includeRight 是否包含右边界（默认 false）
+   * @returns 是否在区间内
+   * @example
+   * ```ts
+   * NumberUtil.within(5, [1, 10]); // true
+   * NumberUtil.within(1, [1, 10], false); // false
+   * ```
+   */
+  static within(input: number, interval: [number, number], includeLeft?: boolean, includeRight?: boolean): boolean;
+}
 //#endregion
 //#region ../../node_modules/.pnpm/ts-toolbelt@9.6.0/node_modules/ts-toolbelt/out/List/List.d.ts
 /**
@@ -3875,6 +4075,7 @@ declare class StringUtil {
    *
    * @param candidate 待转换的值
    * @param checkEmpty 是否检查空值（`null` / `undefined` / 空白字符串），默认为 `true`
+   * @param trim 是否去除结果首尾空白，默认为 `true`
    * @returns 转换后的字符串
    * @example
    * ```ts
@@ -3896,12 +4097,17 @@ declare class StringUtil {
    *
    * // 重载 4: 其他类型 → string
    * StringUtil.cast(Symbol("foo")); // "Symbol(foo)" (类型为 string)
+   *
+   * // trim 参数（默认 true）
+   * StringUtil.cast("  hello  "); // "hello"
+   * StringUtil.cast("\n  abc  \n"); // "abc"
+   * StringUtil.cast("\n  abc  \n", true, false); // "\n  abc  \n"
    * ```
    */
-  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;
+  static cast<T extends null | undefined>(candidate: T, checkEmpty?: true, trim?: boolean): "";
+  static cast<T extends null | undefined>(candidate: T, checkEmpty: false, trim?: boolean): `${T}`;
+  static cast<T extends string | number | bigint | boolean>(candidate: T, checkEmpty?: boolean, trim?: boolean): `${T}`;
+  static cast(candidate: unknown, checkEmpty?: boolean, trim?: boolean): string;
   /**
    * 从字符串中提取数字字符串
    * - 移除非数字字符，保留符号和小数点
@@ -5085,4 +5291,4 @@ declare class ValidateUtil {
   static isSpaceStartOrEnd(input: string): boolean;
 }
 //#endregion
-export { ArrayUtil, DateTimeUtil, EnvUtil, FunctionUtil, MimeUtil, NumberUtil, ObjectUtil, StringUtil, type THEME_MODE_TYPE, type THEME_TYPE, ThemeUtil, TreeUtil, TypeUtil, ValidateUtil };
+export { ArrayUtil, type CurrencyCode, type CurrencyLocale, CurrencyUtil, DateTimeUtil, EnvUtil, type FormatterOptions, FunctionUtil, MimeUtil, NumberUtil, ObjectUtil, StringUtil, type THEME_MODE_TYPE, type THEME_TYPE, ThemeUtil, TreeUtil, TypeUtil, ValidateUtil };