@pawover/kit 0.3.1 → 0.4.0

package/package.json

@@ -6,7 +6,7 @@
     "url": "https://github.com/pawover"
   },
   "description": "一个基于 TypeScript 的开发工具包",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "type": "module",
   "engines": {
     "node": ">=22.20.0"

package/packages/hooks/dist/react.js

@@ -11,7 +11,7 @@ function useLatest(value) {
 	return ref;
 }
 //#endregion
-//#region ../utils/dist/stringUtil-DbYpnL4l.js
+//#region ../utils/dist/stringUtil-voQaLOJj.js
 /**
 * 类型工具类
 */
@@ -732,12 +732,13 @@ var TypeUtil = class {
 * 字符串工具类
 */
 var StringUtil = class {
-	static cast(candidate, checkEmpty = true) {
+	static cast(candidate, checkEmpty = true, trim = true) {
 		if (checkEmpty) {
 			if (candidate === null || candidate === void 0) return "";
 			if (typeof candidate === "string" && candidate.trim().length === 0) return "";
 		}
-		return String(candidate);
+		const result = String(candidate);
+		return trim ? result.trim() : result;
 	}
 	/**
 	* 从字符串中提取数字字符串

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

@@ -3875,6 +3875,7 @@ declare class StringUtil {
    *
    * @param candidate 待转换的值
    * @param checkEmpty 是否检查空值（`null` / `undefined` / 空白字符串），默认为 `true`
+   * @param trim 是否去除结果首尾空白，默认为 `true`
    * @returns 转换后的字符串
    * @example
    * ```ts
@@ -3896,12 +3897,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;
   /**
    * 从字符串中提取数字字符串
    * - 移除非数字字符，保留符号和小数点

package/packages/utils/dist/index.js

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

package/packages/utils/dist/math.js

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

package/packages/utils/dist/{stringUtil-DbYpnL4l.js → stringUtil-voQaLOJj.js}

@@ -721,12 +721,13 @@ var TypeUtil = class {
 * 字符串工具类
 */
 var StringUtil = class {
-	static cast(candidate, checkEmpty = true) {
+	static cast(candidate, checkEmpty = true, trim = true) {
 		if (checkEmpty) {
 			if (candidate === null || candidate === void 0) return "";
 			if (typeof candidate === "string" && candidate.trim().length === 0) return "";
 		}
-		return String(candidate);
+		const result = String(candidate);
+		return trim ? result.trim() : result;
 	}
 	/**
 	* 从字符串中提取数字字符串