@pawover/kit 0.2.2 → 0.3.0

package/package.json

@@ -6,7 +6,7 @@
     "url": "https://github.com/pawover"
   },
   "description": "一个基于 TypeScript 的开发工具包",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "type": "module",
   "engines": {
     "node": ">=22.20.0"
@@ -53,8 +53,8 @@
   "devDependencies": {
     "@commitlint/cli": "^21.2.1",
     "@commitlint/config-conventional": "^21.2.0",
-    "@eslint-react/eslint-plugin": "^5.14.6",
-    "@pawover/eslint-rules": "^0.2.2",
+    "@eslint-react/eslint-plugin": "^5.14.8",
+    "@pawover/eslint-rules": "^0.2.3",
     "@playwright/test": "^1.61.1",
     "@stylistic/eslint-plugin": "^6.0.0-beta.5",
     "@types/fs-extra": "^11.0.4",
@@ -75,9 +75,9 @@
     "rimraf": "^6.1.3",
     "taze": "^19.14.1",
     "tsdown": "^0.22.7",
-    "turbo": "^2.10.4",
+    "turbo": "^2.10.5",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.63.0",
+    "typescript-eslint": "^8.64.0",
     "vitest": "^4.1.10"
   },
   "peerDependencies": {

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

@@ -694,57 +694,65 @@ declare class FunctionUtil {
  */
 declare class MimeUtil {
   /**
-   * 标准 MIME 类型常量，用于文件类型标识和 HTTP Content-Type 头部
-   * 基于 IANA 注册标准和浏览器兼容性验证
+   * 文件类型 MIME 常量
+   * - 每个类型对应具体的文件扩展名
    */
-  static readonly 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 文档 */
-    readonly XML: "text/xml";
-    /** XHTML 文档（XML 严格格式的 HTML） */
+    /** XML 文档（.xml） */
+    readonly XML: "application/xml";
+    /** XML 文档/兼容值 */
+    readonly XML_TEXT: "text/xml";
+    /** XHTML 文档（.xhtml/.xht） */
     readonly XHTML: "application/xhtml+xml";
-    /** JavaScript 文件 */
+    /** JavaScript 文件（.js） */
     readonly JS: "text/javascript";
-    /** TypeScript 文件 */
+    /** TypeScript 文件（.ts） */
     readonly TS: "text/typescript";
-    /** Python 文件 */
+    /** Python 文件（.py） */
     readonly PY: "text/x-python";
     /** Shell 脚本 (.sh) */
     readonly SH: "text/x-sh";
-    /** C 语言源文件 */
+    /** C 语言源文件（.c） */
     readonly C: "text/x-c";
-    /** C++ 源文件 */
+    /** C++ 源文件（.cpp/.cc/.cxx） */
     readonly CPP: "text/x-c++";
-    /** C# 源文件 */
+    /** C# 源文件（.cs） */
     readonly CSHARP: "text/x-csharp";
-    /** Java 源文件 */
+    /** Java 源文件（.java） */
     readonly JAVA: "text/x-java";
-    /** Go 源文件 */
+    /** Go 源文件（.go） */
     readonly GO: "text/x-go";
-    /** Rust 源文件 */
+    /** Rust 源文件（.rs） */
     readonly RUST: "text/x-rust";
-    /** PHP 文件 */
+    /** PHP 文件（.php） */
     readonly PHP: "text/x-php";
-    /** Ruby 文件 */
+    /** Ruby 文件（.rb） */
     readonly RUBY: "text/x-ruby";
-    /** Swift 源文件 */
+    /** Swift 源文件（.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 格式文档 */
+    /** YAML 文档（.yaml/.yml） */
+    readonly YAML: "application/yaml";
+    /** YAML 文档/兼容值 */
+    readonly YAML_TEXT: "text/vnd.yaml";
+    /** TOML 文档（.toml） */
+    readonly TOML: "application/toml";
+    /** TOML 文档/兼容值 */
+    readonly TOML_TEXT: "text/x-toml";
+    /** SQL 脚本（.sql） */
+    readonly SQL: "application/sql";
+    /** SQL 脚本/兼容值 */
+    readonly SQL_TEXT: "text/x-sql";
+    /** Markdown 格式文档（.md/.markdown） */
     readonly MARKDOWN: "text/markdown";
     /** 富文本格式文档（.rtf） */
     readonly RTF: "application/rtf";
@@ -752,9 +760,11 @@ declare class MimeUtil {
     readonly CALENDAR: "text/calendar";
     /** JPEG 图像（.jpg/.jpeg） */
     readonly JPEG: "image/jpeg";
-    /** PNG 图像（无损压缩，支持透明） */
+    /** JPG 图像（JPEG 别名，.jpg） */
+    readonly JPG: "image/jpeg";
+    /** PNG 图像/无损压缩，支持透明（.png） */
     readonly PNG: "image/png";
-    /** GIF 图像（支持动画） */
+    /** GIF 图像/支持动画（.gif） */
     readonly GIF: "image/gif";
     /** Windows 位图（.bmp） */
     readonly BMP: "image/bmp";
@@ -762,16 +772,18 @@ declare class MimeUtil {
     readonly SVG: "image/svg+xml";
     /** APNG 动态图像（.apng） */
     readonly APNG: "image/apng";
-    /** AVIF 图像（高效压缩） */
+    /** AVIF 图像/高效压缩（.avif） */
     readonly AVIF: "image/avif";
     /** 图标文件格式（.ico） */
     readonly ICO: "image/vnd.microsoft.icon";
-    /** WebP 图像（高效压缩） */
+    /** WebP 图像/高效压缩（.webp） */
     readonly WEBP: "image/webp";
     /** TIFF 图像（.tif/.tiff） */
     readonly TIFF: "image/tiff";
-    /** HEIC 图像（高效编码） */
+    /** HEIC 图像/高效编码（.heic） */
     readonly HEIC: "image/heic";
+    /** HEIF 图像/高效编码（.heif） */
+    readonly HEIF: "image/heif";
     /** Adobe Photoshop 文件（.psd） */
     readonly PSD: "image/vnd.adobe.photoshop";
     /** MP3 音频（.mp3） */
@@ -784,8 +796,12 @@ declare class MimeUtil {
     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） */
@@ -802,7 +818,9 @@ declare class MimeUtil {
     readonly THREE_GPP2: "video/3gpp2";
     /** WebM 视频（.webm） */
     readonly WEBM: "video/webm";
-    /** PDF 文档 */
+    /** QuickTime 视频（.mov） */
+    readonly QUICKTIME: "video/quicktime";
+    /** PDF 文档（.pdf） */
     readonly PDF: "application/pdf";
     /** Word 97-2003 文档（.doc） */
     readonly DOC: "application/msword";
@@ -832,8 +850,6 @@ declare class MimeUtil {
     readonly ZIP: "application/zip";
     /** GZIP 压缩文件（.gz） */
     readonly GZIP: "application/gzip";
-    /** GZIP 压缩文件（旧格式） */
-    readonly X_GZIP: "application/x-gzip";
     /** TAR 归档文件（.tar） */
     readonly TAR: "application/x-tar";
     /** BZip 归档（.bz） */
@@ -844,12 +860,18 @@ declare class MimeUtil {
     readonly SEVEN_Z: "application/x-7z-compressed";
     /** RAR 压缩文件（.rar） */
     readonly RAR: "application/vnd.rar";
-    /** 通用二进制数据（默认类型） */
-    readonly OCTET_STREAM: "application/octet-stream";
+    /** 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） */
@@ -871,6 +893,26 @@ declare class MimeUtil {
     /** 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";
+  };
 }
 //#endregion
 //#region src/number/numberUtil.d.ts

package/packages/utils/dist/index.js

@@ -704,57 +704,65 @@ var FunctionUtil = class {
 */
 var MimeUtil = class {
 	/**
-	* 标准 MIME 类型常量，用于文件类型标识和 HTTP Content-Type 头部
-	* 基于 IANA 注册标准和浏览器兼容性验证
+	* 文件类型 MIME 常量
+	* - 每个类型对应具体的文件扩展名
 	*/
-	static MIME = {
-		/** 普通文本文件 */
+	static FILE_MIME = {
+		/** 普通文本文件（.txt） */
 		TEXT: "text/plain",
-		/** 超文本标记语言文档 */
+		/** 超文本标记语言文档（.html/.htm） */
 		HTML: "text/html",
-		/** 层叠样式表文件 */
+		/** 层叠样式表文件（.css） */
 		CSS: "text/css",
-		/** 逗号分隔值文件（表格数据） */
+		/** 逗号分隔值文件/表格数据（.csv） */
 		CSV: "text/csv",
-		/** 制表符分隔值文件 */
+		/** 制表符分隔值文件（.tsv） */
 		TSV: "text/tab-separated-values",
-		/** XML 文档 */
-		XML: "text/xml",
-		/** XHTML 文档（XML 严格格式的 HTML） */
+		/** XML 文档（.xml） */
+		XML: "application/xml",
+		/** XML 文档/兼容值 */
+		XML_TEXT: "text/xml",
+		/** XHTML 文档（.xhtml/.xht） */
 		XHTML: "application/xhtml+xml",
-		/** JavaScript 文件 */
+		/** JavaScript 文件（.js） */
 		JS: "text/javascript",
-		/** TypeScript 文件 */
+		/** TypeScript 文件（.ts） */
 		TS: "text/typescript",
-		/** Python 文件 */
+		/** Python 文件（.py） */
 		PY: "text/x-python",
 		/** Shell 脚本 (.sh) */
 		SH: "text/x-sh",
-		/** C 语言源文件 */
+		/** C 语言源文件（.c） */
 		C: "text/x-c",
-		/** C++ 源文件 */
+		/** C++ 源文件（.cpp/.cc/.cxx） */
 		CPP: "text/x-c++",
-		/** C# 源文件 */
+		/** C# 源文件（.cs） */
 		CSHARP: "text/x-csharp",
-		/** Java 源文件 */
+		/** Java 源文件（.java） */
 		JAVA: "text/x-java",
-		/** Go 源文件 */
+		/** Go 源文件（.go） */
 		GO: "text/x-go",
-		/** Rust 源文件 */
+		/** Rust 源文件（.rs） */
 		RUST: "text/x-rust",
-		/** PHP 文件 */
+		/** PHP 文件（.php） */
 		PHP: "text/x-php",
-		/** Ruby 文件 */
+		/** Ruby 文件（.rb） */
 		RUBY: "text/x-ruby",
-		/** Swift 源文件 */
+		/** Swift 源文件（.swift） */
 		SWIFT: "text/x-swift",
-		/** YAML 文档 */
-		YAML: "text/vnd.yaml",
-		/** TOML 文档 */
-		TOML: "text/x-toml",
-		/** SQL 脚本 */
-		SQL: "text/x-sql",
-		/** Markdown 格式文档 */
+		/** YAML 文档（.yaml/.yml） */
+		YAML: "application/yaml",
+		/** YAML 文档/兼容值 */
+		YAML_TEXT: "text/vnd.yaml",
+		/** TOML 文档（.toml） */
+		TOML: "application/toml",
+		/** TOML 文档/兼容值 */
+		TOML_TEXT: "text/x-toml",
+		/** SQL 脚本（.sql） */
+		SQL: "application/sql",
+		/** SQL 脚本/兼容值 */
+		SQL_TEXT: "text/x-sql",
+		/** Markdown 格式文档（.md/.markdown） */
 		MARKDOWN: "text/markdown",
 		/** 富文本格式文档（.rtf） */
 		RTF: "application/rtf",
@@ -762,9 +770,11 @@ var MimeUtil = class {
 		CALENDAR: "text/calendar",
 		/** JPEG 图像（.jpg/.jpeg） */
 		JPEG: "image/jpeg",
-		/** PNG 图像（无损压缩，支持透明） */
+		/** JPG 图像（JPEG 别名，.jpg） */
+		JPG: "image/jpeg",
+		/** PNG 图像/无损压缩，支持透明（.png） */
 		PNG: "image/png",
-		/** GIF 图像（支持动画） */
+		/** GIF 图像/支持动画（.gif） */
 		GIF: "image/gif",
 		/** Windows 位图（.bmp） */
 		BMP: "image/bmp",
@@ -772,16 +782,18 @@ var MimeUtil = class {
 		SVG: "image/svg+xml",
 		/** APNG 动态图像（.apng） */
 		APNG: "image/apng",
-		/** AVIF 图像（高效压缩） */
+		/** AVIF 图像/高效压缩（.avif） */
 		AVIF: "image/avif",
 		/** 图标文件格式（.ico） */
 		ICO: "image/vnd.microsoft.icon",
-		/** WebP 图像（高效压缩） */
+		/** WebP 图像/高效压缩（.webp） */
 		WEBP: "image/webp",
 		/** TIFF 图像（.tif/.tiff） */
 		TIFF: "image/tiff",
-		/** HEIC 图像（高效编码） */
+		/** HEIC 图像/高效编码（.heic） */
 		HEIC: "image/heic",
+		/** HEIF 图像/高效编码（.heif） */
+		HEIF: "image/heif",
 		/** Adobe Photoshop 文件（.psd） */
 		PSD: "image/vnd.adobe.photoshop",
 		/** MP3 音频（.mp3） */
@@ -794,8 +806,12 @@ var MimeUtil = class {
 		OGG_AUDIO: "audio/ogg",
 		/** Opus 音频（.opus） */
 		OPUS: "audio/opus",
+		/** FLAC 无损音频（.flac） */
+		FLAC: "audio/flac",
 		/** WAV 音频（.wav） */
 		WAV: "audio/wav",
+		/** WebM 音频（.weba） */
+		WEBM_AUDIO: "audio/webm",
 		/** RealAudio 音频（.ra/.ram） */
 		REAL_AUDIO: "audio/x-pn-realaudio",
 		/** MP4 视频（.mp4） */
@@ -812,7 +828,9 @@ var MimeUtil = class {
 		THREE_GPP2: "video/3gpp2",
 		/** WebM 视频（.webm） */
 		WEBM: "video/webm",
-		/** PDF 文档 */
+		/** QuickTime 视频（.mov） */
+		QUICKTIME: "video/quicktime",
+		/** PDF 文档（.pdf） */
 		PDF: "application/pdf",
 		/** Word 97-2003 文档（.doc） */
 		DOC: "application/msword",
@@ -842,8 +860,6 @@ var MimeUtil = class {
 		ZIP: "application/zip",
 		/** GZIP 压缩文件（.gz） */
 		GZIP: "application/gzip",
-		/** GZIP 压缩文件（旧格式） */
-		X_GZIP: "application/x-gzip",
 		/** TAR 归档文件（.tar） */
 		TAR: "application/x-tar",
 		/** BZip 归档（.bz） */
@@ -854,12 +870,18 @@ var MimeUtil = class {
 		SEVEN_Z: "application/x-7z-compressed",
 		/** RAR 压缩文件（.rar） */
 		RAR: "application/vnd.rar",
-		/** 通用二进制数据（默认类型） */
-		OCTET_STREAM: "application/octet-stream",
+		/** XZ 压缩文件（.xz） */
+		XZ: "application/x-xz",
+		/** Zstandard 压缩文件（.zst） */
+		ZSTD: "application/zstd",
+		/** ISO 光盘镜像（.iso） */
+		ISO9660_IMAGE: "application/x-iso9660-image",
 		/** JSON 数据格式（.json） */
 		JSON: "application/json",
 		/** JSON-LD 格式（.jsonld） */
 		LD_JSON: "application/ld+json",
+		/** Web App Manifest（.webmanifest） */
+		MANIFEST: "application/manifest+json",
 		/** Java 归档文件（.jar） */
 		JAR: "application/java-archive",
 		/** WebAssembly 二进制指令格式（.wasm） */
@@ -881,6 +903,26 @@ var MimeUtil = class {
 		/** Word 启用宏文档（.docm） */
 		DOCM: "application/vnd.ms-word.document.macroEnabled.12"
 	};
+	/**
+	* 协议/内容类型 MIME 常量
+	* - 用于 HTTP 请求/响应内容协商，无对应文件扩展名
+	*/
+	static PROTOCOL_MIME = {
+		/** 通用二进制数据流 */
+		OCTET_STREAM: "application/octet-stream",
+		/** URL 编码表单 */
+		FORM_URLENCODED: "application/x-www-form-urlencoded",
+		/** multipart 表单 */
+		FORM_DATA: "multipart/form-data",
+		/** Server-Sent Events 数据流 */
+		EVENT_STREAM: "text/event-stream",
+		/** 问题详情 JSON（RFC 9457） */
+		PROBLEM_JSON: "application/problem+json",
+		/** JSON Patch（RFC 6902） */
+		JSON_PATCH: "application/json-patch+json",
+		/** JSON Merge Patch（RFC 7386） */
+		MERGE_PATCH_JSON: "application/merge-patch+json"
+	};
 };
 //#endregion
 //#region src/number/numberUtil.ts