@pawover/kit 0.1.0 → 0.1.1

package/package.json

@@ -8,7 +8,7 @@
   "description": "一个基于 TypeScript 的开发工具包",
   "license": "MIT",
   "type": "module",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "engines": {
     "node": ">=22.20.0"
   },
@@ -53,7 +53,7 @@
   "devDependencies": {
     "@commitlint/cli": "^21.0.2",
     "@commitlint/config-conventional": "^21.0.2",
-    "@eslint-react/eslint-plugin": "^5.8.9",
+    "@eslint-react/eslint-plugin": "^5.8.11",
     "@pawover/eslint-rules": "^0.2.0",
     "@playwright/test": "^1.60.0",
     "@stylistic/eslint-plugin": "^5.10.0",

package/packages/hooks/dist/react.js

@@ -11,7 +11,7 @@ function useLatest(value) {
 	return ref;
 }
 //#endregion
-//#region ../utils/dist/string-C_OCj9Lg.js
+//#region ../utils/dist/string-p6hZ1Mjb.js
 function _typeof(o) {
 	"@babel/helpers - typeof";
 	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o) {
@@ -65,19 +65,22 @@ var TypeUtil = class {
 	}
 	/**
 	* 检查 value 是否为 string 类型
+	* - 当 `checkEmpty` 为 `true` 时，会先 trim 再判断是否为空
 	*
 	* @param value 待检查值
-	* @param checkEmpty 是否检查空字符串
+	* @param checkEmpty 是否检查空字符串（含空白字符串），默认为 `false`
 	* @returns 是否为字符串
 	* @example
 	* ```ts
 	* TypeUtil.isString("abc"); // true
 	* TypeUtil.isString(""); // true
 	* TypeUtil.isString("", true); // false
+	* TypeUtil.isString("   ", true); // false
+	* TypeUtil.isString(" a ", true); // true
 	* ```
 	*/
 	static isString(value, checkEmpty = false) {
-		return typeof value === "string" && (!checkEmpty || !!value.length);
+		return typeof value === "string" && (!checkEmpty || value.trim().length > 0);
 	}
 	/**
 	* 检查 value 是否为 number 类型
@@ -741,6 +744,13 @@ _defineProperty(TypeUtil, "TYPED_ARRAY_TAGS", new Set([
 * 字符串工具类
 */
 var StringUtil = class {
+	static cast(candidate, checkEmpty = true) {
+		if (checkEmpty) {
+			if (candidate === null || candidate === void 0) return "";
+			if (typeof candidate === "string" && candidate.trim().length === 0) return "";
+		}
+		return String(candidate);
+	}
 	/**
 	* 从字符串中提取数字字符串
 	* - 移除非数字字符，保留符号和小数点

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

@@ -26,7 +26,7 @@ declare class ArrayUtil {
    * ```
    */
   static cast<T>(candidate: T | T[] | null | undefined, checkEmpty?: true): NonNullable<T>[];
-  static cast<T>(candidate: T | T[] | null | undefined, checkEmpty?: false): T[];
+  static cast<T>(candidate: T | T[] | null | undefined, checkEmpty: false): T[];
   /**
    * 获取数组第一项
    *
@@ -3717,6 +3717,39 @@ declare class ObjectUtil {
  * 字符串工具类
  */
 declare class StringUtil {
+  /**
+   * 将任意值转换为字符串
+   * - 当传入数值字面量时，返回对应的字符串字面量类型
+   *
+   * @param candidate 待转换的值
+   * @param checkEmpty 是否检查空值（`null` / `undefined` / 空白字符串），默认为 `true`
+   * @returns 转换后的字符串
+   * @example
+   * ```ts
+   * // 重载 1: null / undefined + checkEmpty = true (默认) → ""
+   * StringUtil.cast(null); // ""
+   * StringUtil.cast(undefined); // ""
+   * StringUtil.cast(""); // ""
+   * StringUtil.cast("   "); // ""
+   *
+   * // 重载 2: null / undefined + checkEmpty = false → "null" / "undefined"
+   * StringUtil.cast(null, false); // "null" (类型为 "null")
+   * StringUtil.cast(undefined, false); // "undefined" (类型为 "undefined")
+   *
+   * // 重载 3: 原始类型 → 字符串字面量类型
+   * StringUtil.cast(123); // "123" (类型为 "123")
+   * StringUtil.cast("hello"); // "hello" (类型为 "hello")
+   * StringUtil.cast(true); // "true" (类型为 "true")
+   * StringUtil.cast(42n); // "42" (类型为 "42")
+   *
+   * // 重载 4: 其他类型 → string
+   * StringUtil.cast(Symbol("foo")); // "Symbol(foo)" (类型为 string)
+   * ```
+   */
+  static cast<T extends null | undefined>(candidate: T, checkEmpty?: true): "";
+  static cast<T extends null | undefined>(candidate: T, checkEmpty: false): `${T}`;
+  static cast<T extends string | number | bigint | boolean>(candidate: T, checkEmpty?: boolean): `${T}`;
+  static cast(candidate: unknown, checkEmpty?: boolean): string;
   /**
    * 从字符串中提取数字字符串
    * - 移除非数字字符，保留符号和小数点
@@ -4102,15 +4135,18 @@ declare class TypeUtil {
   private static isConstructable;
   /**
    * 检查 value 是否为 string 类型
+   * - 当 `checkEmpty` 为 `true` 时，会先 trim 再判断是否为空
    *
    * @param value 待检查值
-   * @param checkEmpty 是否检查空字符串
+   * @param checkEmpty 是否检查空字符串（含空白字符串），默认为 `false`
    * @returns 是否为字符串
    * @example
    * ```ts
    * TypeUtil.isString("abc"); // true
    * TypeUtil.isString(""); // true
    * TypeUtil.isString("", true); // false
+   * TypeUtil.isString("   ", true); // false
+   * TypeUtil.isString(" a ", true); // true
    * ```
    */
   static isString(value: unknown, checkEmpty?: boolean): value is string;

package/packages/utils/dist/index.js

@@ -1,4 +1,4 @@
-import { n as TypeUtil, r as _defineProperty, t as StringUtil } from "./string-C_OCj9Lg.js";
+import { n as TypeUtil, r as _defineProperty, t as StringUtil } from "./string-p6hZ1Mjb.js";
 //#region src/array/arrayUtil.ts
 /**
 * 数组工具类

package/packages/utils/dist/math.js

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

package/packages/utils/dist/{string-C_OCj9Lg.js → string-p6hZ1Mjb.js}

@@ -60,19 +60,22 @@ var TypeUtil = class {
 	}
 	/**
 	* 检查 value 是否为 string 类型
+	* - 当 `checkEmpty` 为 `true` 时，会先 trim 再判断是否为空
 	*
 	* @param value 待检查值
-	* @param checkEmpty 是否检查空字符串
+	* @param checkEmpty 是否检查空字符串（含空白字符串），默认为 `false`
 	* @returns 是否为字符串
 	* @example
 	* ```ts
 	* TypeUtil.isString("abc"); // true
 	* TypeUtil.isString(""); // true
 	* TypeUtil.isString("", true); // false
+	* TypeUtil.isString("   ", true); // false
+	* TypeUtil.isString(" a ", true); // true
 	* ```
 	*/
 	static isString(value, checkEmpty = false) {
-		return typeof value === "string" && (!checkEmpty || !!value.length);
+		return typeof value === "string" && (!checkEmpty || value.trim().length > 0);
 	}
 	/**
 	* 检查 value 是否为 number 类型
@@ -738,6 +741,13 @@ _defineProperty(TypeUtil, "TYPED_ARRAY_TAGS", new Set([
 * 字符串工具类
 */
 var StringUtil = class {
+	static cast(candidate, checkEmpty = true) {
+		if (checkEmpty) {
+			if (candidate === null || candidate === void 0) return "";
+			if (typeof candidate === "string" && candidate.trim().length === 0) return "";
+		}
+		return String(candidate);
+	}
 	/**
 	* 从字符串中提取数字字符串
 	* - 移除非数字字符，保留符号和小数点