@pawover/kit 0.0.1 → 0.1.0

package/packages/utils/dist/index.js

@@ -1,4 +1,4 @@
-import { n as TypeUtil, r as _defineProperty, t as StringUtil } from "./string-DCWqoW4P.js";
+import { n as TypeUtil, r as _defineProperty, t as StringUtil } from "./string-C_OCj9Lg.js";
 //#region src/array/arrayUtil.ts
 /**
 * 数组工具类
@@ -311,17 +311,50 @@ _defineProperty(DateTimeUtil, "FORMAT", {
 * 环境检查工具类
 */
 var EnvUtil = class {
+	/**
+	* 检测是否处于浏览器环境
+	*
+	* @returns 是否为浏览器环境
+	* @example
+	* ```ts
+	* EnvUtil.isBrowser(); // true: 浏览器, false: Node.js
+	* ```
+	*/
 	static isBrowser() {
 		return this._isBrowser;
 	}
+	/**
+	* 检测是否处于 Web Worker 环境
+	*
+	* @returns 是否为 Web Worker 环境
+	* @example
+	* ```ts
+	* EnvUtil.isWebWorker(); // true: Worker, false: 主线程/Node.js
+	* ```
+	*/
 	static isWebWorker() {
 		return this._isWebWorker;
 	}
+	/**
+	* 检测是否处于 React Native 环境
+	*
+	* @returns 是否为 React Native 环境
+	* @example
+	* ```ts
+	* EnvUtil.isReactNative(); // true: React Native, false: Web/Node.js
+	* ```
+	*/
 	static isReactNative() {
 		return this._isReactNative;
 	}
 	/**
 	* 检查是否在 iframe 环境中
+	*
+	* @returns 是否在 iframe 中
+	* @example
+	* ```ts
+	* EnvUtil.isIframe(); // true: 当前页面在 iframe 中
+	* ```
 	*/
 	static isIframe() {
 		if (typeof window === "undefined") return false;
@@ -523,6 +556,7 @@ var FunctionUtil = class {
 	* @throws TypeError 如果 args 为 null 或 undefined
 	*
 	* @example
+	* ```ts
 	* // 遗留代码场景
 	* function legacyFn(a: number, b: string) {
 	*   const argsArray = FunctionUtil.toArgs(arguments);
@@ -539,6 +573,7 @@ var FunctionUtil = class {
 	*   const rest = FunctionUtil.toArgs(arguments, 1);
 	*   // rest: unknown[]，跳过第一个参数
 	* }
+	* ```
 	*/
 	static toArgs(args, start) {
 		if (args === null) throw new TypeError(`function [toArgs] Expected parameter [args] to be a arguments object, got ${typeof args}`);
@@ -553,6 +588,7 @@ var FunctionUtil = class {
 	* @returns 标准化的 Promise
 	*
 	* @example
+	* ```ts
 	* // 同步函数
 	* FunctionUtil.toPromise(() => 42).then(v => console.log(v)); // 42
 	*
@@ -561,6 +597,7 @@ var FunctionUtil = class {
 	*
 	* // 异常处理
 	* FunctionUtil.toPromise(() => { throw new Error('fail'); }).catch(err => console.error(err)); // 捕获同步异常
+	* ```
 	*/
 	static toPromise(fn) {
 		try {
@@ -591,8 +628,38 @@ _defineProperty(MimeUtil, "MIME", {
 	XML: "text/xml",
 	/** XHTML 文档（XML 严格格式的 HTML） */
 	XHTML: "application/xhtml+xml",
-	/** JavaScript 脚本文件（标准推荐） */
+	/** JavaScript 文件 */
 	JS: "text/javascript",
+	/** TypeScript 文件 */
+	TS: "text/typescript",
+	/** Python 文件 */
+	PY: "text/x-python",
+	/** Shell 脚本 (.sh) */
+	SH: "text/x-sh",
+	/** C 语言源文件 */
+	C: "text/x-c",
+	/** C++ 源文件 */
+	CPP: "text/x-c++",
+	/** C# 源文件 */
+	CSHARP: "text/x-csharp",
+	/** Java 源文件 */
+	JAVA: "text/x-java",
+	/** Go 源文件 */
+	GO: "text/x-go",
+	/** Rust 源文件 */
+	RUST: "text/x-rust",
+	/** PHP 文件 */
+	PHP: "text/x-php",
+	/** Ruby 文件 */
+	RUBY: "text/x-ruby",
+	/** Swift 源文件 */
+	SWIFT: "text/x-swift",
+	/** YAML 文档 */
+	YAML: "text/vnd.yaml",
+	/** TOML 文档 */
+	TOML: "text/x-toml",
+	/** SQL 脚本 */
+	SQL: "text/x-sql",
 	/** Markdown 格式文档 */
 	MARKDOWN: "text/markdown",
 	/** 富文本格式文档（.rtf） */
@@ -617,6 +684,12 @@ _defineProperty(MimeUtil, "MIME", {
 	ICO: "image/vnd.microsoft.icon",
 	/** WebP 图像（高效压缩） */
 	WEBP: "image/webp",
+	/** TIFF 图像（.tif/.tiff） */
+	TIFF: "image/tiff",
+	/** HEIC 图像（高效编码） */
+	HEIC: "image/heic",
+	/** Adobe Photoshop 文件（.psd） */
+	PSD: "image/vnd.adobe.photoshop",
 	/** MP3 音频（.mp3） */
 	MP3: "audio/mpeg",
 	/** AAC 音频（.aac） */
@@ -685,6 +758,8 @@ _defineProperty(MimeUtil, "MIME", {
 	BZIP2: "application/x-bzip2",
 	/** 7-Zip 压缩文件（.7z） */
 	SEVEN_Z: "application/x-7z-compressed",
+	/** RAR 压缩文件（.rar） */
+	RAR: "application/vnd.rar",
 	/** 通用二进制数据（默认类型） */
 	OCTET_STREAM: "application/octet-stream",
 	/** JSON 数据格式（.json） */
@@ -693,10 +768,18 @@ _defineProperty(MimeUtil, "MIME", {
 	LD_JSON: "application/ld+json",
 	/** Java 归档文件（.jar） */
 	JAR: "application/java-archive",
+	/** WebAssembly 二进制指令格式（.wasm） */
+	WASM: "application/wasm",
 	/** MS 嵌入式 OpenType 字体（.eot） */
 	EOT: "application/vnd.ms-fontobject",
 	/** OpenType 字体（.otf） */
 	OTF: "font/otf",
+	/** WOFF 字体（.woff） */
+	WOFF: "font/woff",
+	/** WOFF2 字体（.woff2） */
+	WOFF2: "font/woff2",
+	/** TrueType 字体（.ttf） */
+	TTF: "font/ttf",
 	/** Excel 97-2003 工作簿（.xls） */
 	XLS: "application/vnd.ms-excel",
 	/** Microsoft XPS 文档（.xps） */
@@ -760,7 +843,10 @@ var ObjectUtil = class {
 	* @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(plainObject, toEntry) {
@@ -1301,192 +1387,320 @@ var TreeUtil = class {
 var ValidateUtil = class {
 	/**
 	* 验证是否为手机号码
+	* @example
+	* ```ts
+	* ValidateUtil.isPhone("13800138000"); // true
+	* ```
 	*/
 	static isPhone(input) {
 		return this._phone.test(input.toString());
 	}
 	/**
 	* 验证是否为固定电话
+	* @example
+	* ```ts
+	* ValidateUtil.isTelephone("010-12345678"); // true
+	* ```
 	*/
 	static isTelephone(input) {
 		return this._telephone.test(input.toString());
 	}
 	/**
 	* 验证是否为移动设备识别码
+	* @example
+	* ```ts
+	* ValidateUtil.isIMEI("490154203237518"); // true
+	* ```
 	*/
 	static isIMEI(input) {
 		return this._IMEI.test(input.toString());
 	}
 	/**
 	* 验证是否为电子邮箱
+	* @example
+	* ```ts
+	* ValidateUtil.isEmail("dev@example.com"); // true
+	* ```
 	*/
 	static isEmail(input) {
 		return this._email.test(input.toString());
 	}
 	/**
 	* 验证是否为 http(s) 链接
+	* @example
+	* ```ts
+	* ValidateUtil.isHttpLink("https://example.com/path"); // true
+	* ```
 	*/
 	static isHttpLink(input) {
 		return this._link.test(input.toString());
 	}
 	/**
 	* 验证是否为端口号链接
+	* @example
+	* ```ts
+	* ValidateUtil.isPortLink("http://example.com:8080"); // true
+	* ```
 	*/
 	static isPortLink(input) {
 		return this._portLink.test(input.toString());
 	}
 	/**
 	* 验证是否为迅雷链接
+	* @example
+	* ```ts
+	* ValidateUtil.isThunderLink("thunder://QUFodHRwOi8vZXhhbXBsZS5jb20vZmlsZQ=="); // true
+	* ```
 	*/
 	static isThunderLink(input) {
 		return this._thunderLink.test(input.toString());
 	}
 	/**
 	* 验证是否为统一社会信用代码
+	* @example
+	* ```ts
+	* ValidateUtil.isUSCC("91350100M000100Y43"); // true
+	* ```
 	*/
 	static isUSCC(input) {
 		return this._uscc.test(input.toString());
 	}
 	/**
 	* 验证是否为统一社会信用代码 - 15位/18位/20位数字/字母
+	* @example
+	* ```ts
+	* ValidateUtil.isUSCCS("91350100M000100Y43"); // true
+	* ```
 	*/
 	static isUSCCS(input) {
 		return this._usccs.test(input.toString());
 	}
 	/**
 	* 验证是否为 Windows 系统文件夹路径
+	* @example
+	* ```ts
+	* ValidateUtil.isDirPathWindows("C:\\Users\\pawover\\"); // true
+	* ```
 	*/
 	static isDirPathWindows(input) {
 		return this._dirPathWindows.test(input.toString());
 	}
 	/**
 	* 验证是否为 Windows 系统文件路径
+	* @example
+	* ```ts
+	* ValidateUtil.isFilePathWindows("C:\\Users\\pawover\\a.txt"); // true
+	* ```
 	*/
 	static isFilePathWindows(input) {
 		return this._filePathWindows.test(input.toString());
 	}
 	/**
 	* 验证是否为 Linux 系统文件夹路径
+	* @example
+	* ```ts
+	* ValidateUtil.isDirPathLinux("/usr/local/"); // true
+	* ```
 	*/
 	static isDirPathLinux(input) {
 		return this._dirPathLinux.test(input.toString());
 	}
 	/**
 	* 验证是否为 Linux 系统文件路径
+	* @example
+	* ```ts
+	* ValidateUtil.isFilePathLinux("/usr/local/bin/node"); // true
+	* ```
 	*/
 	static isFilePathLinux(input) {
 		return this._filePathLinux.test(input.toString());
 	}
 	/**
 	* 验证是否为新能源车牌号
+	* @example
+	* ```ts
+	* ValidateUtil.isEVCarNumber("粤AD12345"); // true
+	* ```
 	*/
 	static isEVCarNumber(input) {
 		return this._EVCarNumber.test(input.toString());
 	}
 	/**
 	* 验证是否为燃油车车牌号
+	* @example
+	* ```ts
+	* ValidateUtil.isGVCarNumber("粤B12345"); // true
+	* ```
 	*/
 	static isGVCarNumber(input) {
 		return this._GVCarNumber.test(input.toString());
 	}
 	/**
 	* 验证是否为中文姓名
+	* @example
+	* ```ts
+	* ValidateUtil.isChineseName("张三"); // true
+	* ```
 	*/
 	static isChineseName(input) {
 		return this._chineseName.test(input.toString());
 	}
 	/**
 	* 验证是否为中国身份证号
+	* @example
+	* ```ts
+	* ValidateUtil.isChineseID("11010519491231002X"); // true
+	* ```
 	*/
 	static isChineseID(input) {
 		return this._chineseId.test(input.toString());
 	}
 	/**
 	* 验证是否为中国省份
+	* @example
+	* ```ts
+	* ValidateUtil.isChineseProvince("浙江"); // true
+	* ```
 	*/
 	static isChineseProvince(input) {
 		return this._chineseProvince.test(input.toString());
 	}
 	/**
 	* 验证是否为中华民族
+	* @example
+	* ```ts
+	* ValidateUtil.isChineseNation("汉族"); // true
+	* ```
 	*/
 	static isChineseNation(input) {
 		return this._chineseNation.test(input.toString());
 	}
 	/**
 	* 验证是否只包含字母
+	* @example
+	* ```ts
+	* ValidateUtil.isLetter("abcDEF"); // true
+	* ```
 	*/
 	static isLetter(input) {
 		return this._letter.test(input.toString());
 	}
 	/**
 	* 验证是否只包含小写字母
+	* @example
+	* ```ts
+	* ValidateUtil.isLetterLowercase("abc"); // true
+	* ```
 	*/
 	static isLetterLowercase(input) {
 		return this._letterLowercase.test(input.toString());
 	}
 	/**
 	* 验证是否只包含大写字母
+	* @example
+	* ```ts
+	* ValidateUtil.isLetterUppercase("ABC"); // true
+	* ```
 	*/
 	static isLetterUppercase(input) {
 		return this._letterUppercase.test(input.toString());
 	}
 	/**
 	* 验证是否不包含字母
+	* @example
+	* ```ts
+	* ValidateUtil.isLetterOmit("123_-"); // true
+	* ```
 	*/
 	static isLetterOmit(input) {
 		return this._letterOmit.test(input.toString());
 	}
 	/**
 	* 验证是否为数字和字母组合
+	* @example
+	* ```ts
+	* ValidateUtil.isLetterAndNumber("A1B2"); // true
+	* ```
 	*/
 	static isLetterAndNumber(input) {
 		return this._LetterAndNumber.test(input.toString());
 	}
 	/**
 	* 验证是否为有符号浮点数
+	* @example
+	* ```ts
+	* ValidateUtil.isSignedFloat("-12.34"); // true
+	* ```
 	*/
 	static isSignedFloat(input) {
 		return this._signedFloat.test(input.toString());
 	}
 	/**
 	* 验证是否为无符号浮点数
+	* @example
+	* ```ts
+	* ValidateUtil.isUnsignedFloat("12.34"); // true
+	* ```
 	*/
 	static isUnsignedFloat(input) {
 		return this._unsignedFloat.test(input.toString());
 	}
 	/**
 	* 验证是否为有符号整数
+	* @example
+	* ```ts
+	* ValidateUtil.isSignedInteger("-12"); // true
+	* ```
 	*/
 	static isSignedInteger(input) {
 		return this._signedInteger.test(input.toString());
 	}
 	/**
 	* 验证是否为无符号整数
+	* @example
+	* ```ts
+	* ValidateUtil.isUnsignedInteger("12"); // true
+	* ```
 	*/
 	static isUnsignedInteger(input) {
 		return this._unsignedInteger.test(input.toString());
 	}
 	/**
 	* 验证是否包含空格
+	* @example
+	* ```ts
+	* ValidateUtil.isSpaceInclude("a b"); // true
+	* ```
 	*/
 	static isSpaceInclude(input) {
 		return this._spaceInclude.test(input.toString());
 	}
 	/**
 	* 验证是否以空格开头
+	* @example
+	* ```ts
+	* ValidateUtil.isSpaceStart(" abc"); // true
+	* ```
 	*/
 	static isSpaceStart(input) {
 		return this._spaceStart.test(input.toString());
 	}
 	/**
 	* 验证是否以空格结尾
+	* @example
+	* ```ts
+	* ValidateUtil.isSpaceEnd("abc "); // true
+	* ```
 	*/
 	static isSpaceEnd(input) {
 		return this._spaceEnd.test(input.toString());
 	}
 	/**
 	* 验证是否以空格开头或结尾
+	* @example
+	* ```ts
+	* ValidateUtil.isSpaceStartOrEnd(" abc"); // true
+	* ```
 	*/
 	static isSpaceStartOrEnd(input) {
 		return this.isSpaceStart(input) || this.isSpaceEnd(input);

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

@@ -31,7 +31,11 @@ declare class MathUtil {
    * @returns 格式化后的字符串或 BigNumber
    * @example
    * ```ts
+   * // 重载 1: isFormat = true (默认)
    * MathUtil.toDecimal(math, 0.12345, 2); // "0.12"
+   *
+   * // 重载 2: isFormat = false
+   * MathUtil.toDecimal(math, 0.12345, 2, false); // BigNumber(0.12345)
    * ```
    */
   static toDecimal(mathJsInstance: MathJsInstance, value: unknown, precision?: number | undefined, isFormat?: true | undefined): string;

package/packages/utils/dist/math.js

@@ -1,4 +1,4 @@
-import { n as TypeUtil, t as StringUtil } from "./string-DCWqoW4P.js";
+import { n as TypeUtil, t as StringUtil } from "./string-C_OCj9Lg.js";
 //#region src/math/mathUtil.ts
 /**
 * 数学工具类