@pawover/kit 0.4.1 → 0.5.1

package/packages/utils/dist/{math-Cvy9HBP0.js → math-DRbCtLQH.js}

@@ -56,20 +56,12 @@ var TypeUtil = class {
 	static getPrototypeString(value) {
 		return Object.prototype.toString.call(value);
 	}
-	static isConstructable(fn) {
-		try {
-			Reflect.construct(fn, []);
-			return true;
-		} catch {
-			return false;
-		}
-	}
 	/**
 	* 检查 value 是否为 string 类型
-	* - 当 `checkEmpty` 为 `true` 时，会先 trim 再判断是否为空
+	* - 当 `checkNullish` 为 `true` 时，会先 trim 再判断是否为空
 	*
 	* @param value 待检查值
-	* @param checkEmpty 是否检查空字符串（含空白字符串），默认为 `false`
+	* @param checkNullish 是否检查空字符串（含空白字符串），默认为 `false`
 	* @returns 是否为字符串
 	* @example
 	* ```ts
@@ -80,8 +72,8 @@ var TypeUtil = class {
 	* TypeUtil.isString(" a ", true); // true
 	* ```
 	*/
-	static isString(value, checkEmpty = false) {
-		return typeof value === "string" && (!checkEmpty || value.trim().length > 0);
+	static isString(value, checkNullish = false) {
+		return typeof value === "string" && (!checkNullish || value.trim().length > 0);
 	}
 	/**
 	* 检查 value 是否为 number 类型
@@ -260,6 +252,19 @@ var TypeUtil = class {
 		return value === null;
 	}
 	/**
+	* 检查 value 是否为 null 或 undefined
+	* @param value 待检查值
+	* @returns 是否为 Nullish
+	* @example
+	* ```ts
+	* TypeUtil.isNullish(null); // true
+	* TypeUtil.isNullish(undefined); // true
+	* ```
+	*/
+	static isNullish(value) {
+		return this.isNull(value) || this.isUndefined(value);
+	}
+	/**
 	* 检查 value 是否为 Function
 	* @param value 待检查值
 	* @returns 是否为 Function
@@ -435,7 +440,7 @@ var TypeUtil = class {
 	* ```
 	*/
 	static isClass(value) {
-		return this.isFunction(value) && !this.isAsyncFunction(value) && Function.prototype.toString.call(value).startsWith("class ") && this.isConstructable(value) && value.prototype !== void 0;
+		return this.isFunction(value) && !this.isAsyncFunction(value) && Function.prototype.toString.call(value).startsWith("class ") && value.prototype !== void 0;
 	}
 	/**
 	* 检查 value 是否为数组
@@ -686,7 +691,9 @@ var TypeUtil = class {
 		return !!value && typeof value[Symbol.iterator] === "function";
 	}
 	/**
-	* 检查 value 是否为 Falsy 值 (false, 0, "", null, undefined, NaN)
+	* 检查 value 是否为 Falsy 值 (false, 0, "", null, undefined, NaN, 0n)
+	* - 处理非字符串形式的 falsy；字符串形式（`"null"`、`"0"` 等）请使用 `isFalsyLike`
+	*
 	* @param value 待检查值
 	* @returns 是否为 Falsy
 	* @example
@@ -695,8 +702,7 @@ var TypeUtil = class {
 	* ```
 	*/
 	static isFalsy(value) {
-		if (this.isNaN(value) || this.isNull(value) || this.isUndefined(value)) return true;
-		return value === false || value === 0 || value === 0n || value === "";
+		return this.isNaN(value) || this.isNullish(value) || value === false || value === 0 || value === 0n || value === "";
 	}
 	/**
 	* 检查 value 是否为 FalsyLike 值
@@ -721,8 +727,8 @@ var TypeUtil = class {
 * 字符串工具类
 */
 var StringUtil = class {
-	static cast(candidate, checkEmpty = true, trim = true) {
-		if (checkEmpty) {
+	static cast(candidate, checkNullish = true, trim = true) {
+		if (checkNullish) {
 			if (candidate === null || candidate === void 0) return "";
 			if (typeof candidate === "string" && candidate.trim().length === 0) return "";
 		}
@@ -777,19 +783,26 @@ var StringUtil = class {
 		return input.toUpperCase();
 	}
 	/**
-	* 字符串首字母大小写
-	* - 包含非西欧字母字符时，不处理
+	* 调整大小写
+	* - 每个单词（`\S+`）独立处理
+	* - 包含非西欧字母字符（如 `.`、`,`、`'`、`-`）时，该词不处理
 	* - 纯字母且全大写时，不处理
-	* - 纯字母且非全大写时，首字母小写，其余保留
-	* - 纯字母且非全大写时，首字母大写，其余保留
+	* - 纯字母且非全大写时：`caseType` 为 `"lower"` 则首字母小写，`"upper"` 则首字母大写，其余字符保留
+	* - ⚠️ 缺省 `caseType` 时不产生任何转换（no-op），需显式传 `"lower"` / `"upper"`
 	*
 	* @param input 待处理字符串
-	* @param caseType 大小写类型
+	* @param caseType 大小写类型（缺省时无操作）
 	* @returns 处理后的字符串
 	* @example
 	* ```ts
-	* StringUtil.toInitialCase("Hello", "lower"); // "hello"
-	* StringUtil.toInitialCase("hello", "upper"); // "Hello"
+	* // 重载 1: lower
+	* StringUtil.toInitialCase("Hello World", "lower"); // "hello world"
+	*
+	* // 重载 2: upper
+	* StringUtil.toInitialCase("hello world", "upper"); // "Hello World"
+	*
+	* // 缺省 caseType → no-op
+	* StringUtil.toInitialCase("Hello"); // "Hello"
 	* ```
 	*/
 	static toInitialCase(input, caseType) {
@@ -908,14 +921,15 @@ var StringUtil = class {
 	static template(input, template, regex = /\{\{(.+?)\}\}/g) {
 		if (!TypeUtil.isString(input, true)) return "";
 		regex.lastIndex = 0;
+		const executor = regex.global ? regex : new RegExp(regex.source, `${regex.flags}g`);
 		let result = "";
 		let from = 0;
 		let match;
-		while (match = regex.exec(input)) {
+		while (match = executor.exec(input)) {
 			const replacement = template[match[1]];
 			const valueToInsert = replacement === null || replacement === void 0 ? match[0] : replacement;
 			result += input.slice(from, match.index) + valueToInsert;
-			from = regex.lastIndex;
+			from = executor.lastIndex;
 		}
 		return result + input.slice(from);
 	}
@@ -977,6 +991,9 @@ var MathUtil = class MathUtil {
 	/**
 	* 数学表达式求值
 	*
+	* ⚠️ 安全警告：mathjs `evaluate` 存在已知的沙箱逃逸向量，**仅限可信输入**（硬编码表达式或受控参数），
+	* 切勿直接用于用户提供的表达式。
+	*
 	* @param mathJsInstance mathJs 实例
 	* @param expr 表达式
 	* @param scope 键值映射

package/packages/utils/dist/math.cjs

@@ -0,0 +1,3 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_math = require("./math-BznvO4qI.cjs");
+exports.MathUtil = require_math.MathUtil;

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

@@ -0,0 +1 @@
+export type * from './math.d.ts'

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

@@ -42,6 +42,9 @@ declare class MathUtil {
   /**
    * 数学表达式求值
    *
+   * ⚠️ 安全警告：mathjs `evaluate` 存在已知的沙箱逃逸向量，**仅限可信输入**（硬编码表达式或受控参数），
+   * 切勿直接用于用户提供的表达式。
+   *
    * @param mathJsInstance mathJs 实例
    * @param expr 表达式
    * @param scope 键值映射

package/packages/utils/dist/math.js

@@ -1,2 +1,2 @@
-import { t as MathUtil } from "./math-Cvy9HBP0.js";
+import { t as MathUtil } from "./math-DRbCtLQH.js";
 export { MathUtil };

package/packages/utils/dist/vite.cjs

@@ -0,0 +1,44 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/vite/viteUtil.ts
+/**
+* Vite 工具类
+*/
+var ViteUtil = class {
+	/**
+	* 开发服务器反向代理配置
+	*
+	* @param proxyList 代理配置项
+	* @param options 追加到每个代理项的 Vite `ProxyOptions`
+	* @returns Vite `server.proxy` 可直接使用的配置对象
+	* @example
+	* ```ts
+	* ViteUtil.toProxy([
+	*   ["/api", "http://localhost:3000"],
+	*   ["/mock", "https://example.com"],
+	* ]);
+	* // {
+	* //   "/api": { target: "http://localhost:3000", changeOrigin: true, ws: true, rewrite: [Function] },
+	* //   "/mock": { target: "https://example.com", changeOrigin: true, ws: true, secure: false, rewrite: [Function] }
+	* // }
+	* ```
+	*/
+	static toProxy(proxyList, options) {
+		const httpsRE = /^https:\/\//;
+		const result = {};
+		if (Array.isArray(proxyList)) for (const [prefix, target] of proxyList) {
+			const isHttps = httpsRE.test(target);
+			const escapedPrefix = prefix.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+			result[prefix] = {
+				target,
+				changeOrigin: true,
+				ws: true,
+				rewrite: (path) => path.replace(new RegExp(`^${escapedPrefix}`), ""),
+				...isHttps ? { secure: false } : {},
+				...options
+			};
+		}
+		return result;
+	}
+};
+//#endregion
+exports.ViteUtil = ViteUtil;

package/packages/utils/dist/vite.d.cts

@@ -0,0 +1 @@
+export type * from './vite.d.ts'

package/packages/utils/dist/vite.js

@@ -24,14 +24,18 @@ var ViteUtil = class {
 	static toProxy(proxyList, options) {
 		const httpsRE = /^https:\/\//;
 		const result = {};
-		if (typeof proxyList === "object") for (const [prefix, target] of proxyList) result[prefix] = {
-			target,
-			changeOrigin: true,
-			ws: true,
-			rewrite: (path) => path.replace(new RegExp(`^${prefix}`), ""),
-			...httpsRE.test(target) ? { secure: false } : {},
-			...options
-		};
+		if (Array.isArray(proxyList)) for (const [prefix, target] of proxyList) {
+			const isHttps = httpsRE.test(target);
+			const escapedPrefix = prefix.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+			result[prefix] = {
+				target,
+				changeOrigin: true,
+				ws: true,
+				rewrite: (path) => path.replace(new RegExp(`^${escapedPrefix}`), ""),
+				...isHttps ? { secure: false } : {},
+				...options
+			};
+		}
 		return result;
 	}
 };

package/packages/zod/dist/index.cjs

@@ -0,0 +1,91 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let zod = require("zod");
+//#region src/server.ts
+const id = zod.z.union([zod.z.string().min(1), zod.z.number()]);
+const idAllowEmpty = id.nullish();
+//#endregion
+//#region src/type.ts
+/** 空 */
+const empty = zod.z.union([zod.z.null(), zod.z.undefined()]);
+/** 字符串 */
+const string = zod.z.string();
+/** 字符串-空 */
+const stringEmpty = zod.z.literal("").nullish();
+/** 字符串-非空 */
+const stringNoEmpty = string.min(1);
+/** 字符串-可空 */
+const stringAllowEmpty = string.nullish();
+/** 数字 */
+const number = zod.z.number();
+/** 数字-可空 */
+const numberAllowEmpty = number.nullish();
+/** 整数 */
+const integer = number.int();
+/** 整数-可空 */
+const integerAllowEmpty = integer.nullish();
+/** 整数-正整数和零 */
+const integerPositive = integer.nonnegative().int();
+/** 整数-正整数和零-可空 */
+const integerPositiveAllowEmpty = integerPositive.nullish();
+/** 整数-负整数和零 */
+const integerNegative = integer.nonpositive().int();
+/** 整数-负整数和零-可空 */
+const integerNegativeAllowEmpty = integerNegative.nullish();
+/** 布尔值 */
+const boolean = zod.z.boolean();
+/** 布尔值-可空 */
+const booleanAllowEmpty = boolean.nullish();
+/** 大数字 */
+const bigint = zod.z.bigint();
+/** 大数字-可空 */
+const bigintAllowEmpty = bigint.nullish();
+/** 大数字-正整数和零 */
+const bigintPositive = bigint.nonnegative();
+/** 大数字-正整数和零-可空 */
+const bigintPositiveAllowEmpty = bigintPositive.nullish();
+/** 大数字-负整数和零 */
+const bigintNegative = bigint.nonpositive();
+/** 大数字-负整数和零-可空 */
+const bigintNegativeAllowEmpty = bigintNegative.nullish();
+const symbol = zod.z.symbol();
+const any = zod.z.any();
+const unknown = zod.z.unknown();
+const never = zod.z.never();
+const propertyKey = zod.z.union([
+	string,
+	number,
+	symbol
+]);
+const anyObject = zod.z.record(propertyKey, any);
+const plainObject = zod.z.record(propertyKey, unknown);
+//#endregion
+exports.any = any;
+exports.anyObject = anyObject;
+exports.bigint = bigint;
+exports.bigintAllowEmpty = bigintAllowEmpty;
+exports.bigintNegative = bigintNegative;
+exports.bigintNegativeAllowEmpty = bigintNegativeAllowEmpty;
+exports.bigintPositive = bigintPositive;
+exports.bigintPositiveAllowEmpty = bigintPositiveAllowEmpty;
+exports.boolean = boolean;
+exports.booleanAllowEmpty = booleanAllowEmpty;
+exports.empty = empty;
+exports.id = id;
+exports.idAllowEmpty = idAllowEmpty;
+exports.integer = integer;
+exports.integerAllowEmpty = integerAllowEmpty;
+exports.integerNegative = integerNegative;
+exports.integerNegativeAllowEmpty = integerNegativeAllowEmpty;
+exports.integerPositive = integerPositive;
+exports.integerPositiveAllowEmpty = integerPositiveAllowEmpty;
+exports.never = never;
+exports.number = number;
+exports.numberAllowEmpty = numberAllowEmpty;
+exports.plainObject = plainObject;
+exports.propertyKey = propertyKey;
+exports.string = string;
+exports.stringAllowEmpty = stringAllowEmpty;
+exports.stringEmpty = stringEmpty;
+exports.stringNoEmpty = stringNoEmpty;
+exports.symbol = symbol;
+exports.unknown = unknown;

package/packages/zod/dist/index.d.cts

@@ -0,0 +1 @@
+export type * from './index.d.ts'