@pawover/kit 0.0.0-beta.32 → 0.0.0-beta.40

package/dist/{utils-RGh-N7TJ.js → utils-DbMbll5L.js}

@@ -1,5 +1,7 @@
+import { clone, cloneDeep, cloneDeepWith } from "lodash-es";
+
 //#region src/utils/typeof/types.ts
-const PROTOTYPE_TAGS = {
+const PROTOTYPE_TAGS = Object.freeze({
 	abortSignal: "[object AbortSignal]",
 	array: "[object Array]",
 	asyncFunction: "[object AsyncFunction]",
@@ -12,6 +14,7 @@ const PROTOTYPE_TAGS = {
 	file: "[object File]",
 	function: "[object Function]",
 	generatorFunction: "[object GeneratorFunction]",
+	global: "[object global]",
 	iframe: "[object HTMLIFrameElement]",
 	map: "[object Map]",
 	null: "[object Null]",
@@ -29,7 +32,7 @@ const PROTOTYPE_TAGS = {
 	weakSet: "[object WeakSet]",
 	webSocket: "[object WebSocket]",
 	window: "[object Window]"
-};
+});
 const TYPED_ARRAY_TAGS = new Set([
 	"[object Int8Array]",
 	"[object Uint8Array]",
@@ -219,20 +222,50 @@ function isDate(value, invalidCheck = true) {
 //#endregion
 //#region src/utils/typeof/isEnumeration.ts
 /**
-* 判断一个值是否为有效的枚举
-* - 枚举不能为空
-* - 枚举所有的值必须是 string 或 number
+* 判断一个对象是否为有效的枚举
+* - 枚举成员不能为空
+* - 枚举成员的键不能具有数值名
+* - 枚举成员的值必须类型一致且为 `string` 或 `number` 类型
+* - 枚举成员的值不能重复
+* - 枚举成员的值必须全部为双向映射或非双向映射
 *
 * @param enumeration 待检查值
-* @returns 是否为有效的枚举
+* @returns [是否为有效的枚举, 是否为双向枚举]
 */
 function isEnumeration(enumeration) {
-	if (!isObject(enumeration)) return [false, false];
+	if (typeof enumeration !== "object" || enumeration === null) return [false, false];
 	const keys = Object.keys(enumeration);
-	if (!keys.length) return [false, false];
-	const values = Object.values(enumeration);
-	if (!values.every((v) => typeof v === "string" || typeof v === "number")) return [false, false];
-	return [true, keys.every((k) => values.some((v) => v.toString() === k))];
+	if (keys.length === 0) return [false, false];
+	const originalKeys = [];
+	const numericKeys = [];
+	for (const key of keys) if (/^\d+$/.test(key)) numericKeys.push(key);
+	else originalKeys.push(key);
+	if (originalKeys.length === 0) return [false, false];
+	let valueType = null;
+	const values = [];
+	for (const key of originalKeys) {
+		const value = enumeration[key];
+		const type = typeof value;
+		if (type !== "string" && type !== "number") return [false, false];
+		if (valueType === null) valueType = type;
+		else if (type !== valueType) return [false, false];
+		values.push(value);
+	}
+	if (new Set(values).size !== values.length) return [false, false];
+	let isBidirectional = false;
+	if (numericKeys.length > 0) {
+		if (numericKeys.length !== originalKeys.length) return [false, false];
+		const reverseMappedNames = /* @__PURE__ */ new Set();
+		for (const numKey of numericKeys) {
+			const reverseValue = enumeration[numKey];
+			if (typeof reverseValue !== "string") return [false, false];
+			if (!originalKeys.includes(reverseValue)) return [false, false];
+			reverseMappedNames.add(reverseValue);
+		}
+		if (reverseMappedNames.size !== originalKeys.length) return [false, false];
+		isBidirectional = true;
+	}
+	return [true, isBidirectional];
 }
 
 //#endregion
@@ -249,18 +282,26 @@ function isEnumeration(enumeration) {
 * ```
 */
 function isEqual(x, y) {
-	if (Object.is(x, y)) return true;
-	if (isDate(x) && isDate(y)) return x.getTime() === y.getTime();
-	if (isRegExp(x) && isRegExp(y)) return x.toString() === y.toString();
-	if (typeof x !== "object" || x === null || typeof y !== "object" || y === null) return false;
-	const keysX = Reflect.ownKeys(x);
-	const keysY = Reflect.ownKeys(y);
-	if (keysX.length !== keysY.length) return false;
-	for (const key of keysX) {
-		if (!Reflect.has(y, key)) return false;
-		if (!isEqual(x[key], y[key])) return false;
+	const seen = /* @__PURE__ */ new WeakMap();
+	function _isEqual(a, b) {
+		if (Object.is(a, b)) return true;
+		if (isDate(a) && isDate(b)) return a.getTime() === b.getTime();
+		if (isRegExp(a) && isRegExp(b)) return a.toString() === b.toString();
+		if (typeof a !== "object" || a === null || typeof b !== "object" || b === null) return false;
+		if (seen.has(a)) {
+			if (seen.get(a).has(b)) return true;
+		} else seen.set(a, /* @__PURE__ */ new Set());
+		seen.get(a).add(b);
+		const keysA = Reflect.ownKeys(a);
+		const keysB = Reflect.ownKeys(b);
+		if (keysA.length !== keysB.length) return false;
+		for (const key of keysA) {
+			if (!Reflect.has(b, key)) return false;
+			if (!_isEqual(a[key], b[key])) return false;
+		}
+		return true;
 	}
-	return true;
+	return _isEqual(x, y);
 }
 
 //#endregion
@@ -287,7 +328,28 @@ function isFalsy(value) {
 }
 function isFalsyLike(value) {
 	if (isFalsy(value)) return true;
-	return typeof value === "string" && (value === "null" || value === "undefined" || value === "NaN" || value === "false" || value === "0" || value === "0n");
+	return typeof value === "string" && (value === "null" || value === "undefined" || value === "NaN" || value === "false" || value === "0" || value === "-0" || value === "0n");
+}
+
+//#endregion
+//#region src/utils/typeof/isIframe.ts
+/**
+* 检查 value 是否为 HTMLIFrameElement
+* @param value 待检查值
+* @returns 是否为 HTMLIFrameElement
+*/
+function isIframe(value) {
+	if (typeof window === "undefined") return false;
+	return resolvePrototypeString(value) === PROTOTYPE_TAGS.iframe;
+}
+function isInIframe() {
+	if (typeof window === "undefined") return false;
+	try {
+		return window.top !== window.self;
+	} catch (error) {
+		if (error.name === "SecurityError") return true;
+		return false;
+	}
 }
 
 //#endregion
@@ -362,7 +424,7 @@ function isNaN(value) {
 * 检查 value 是否为整数
 *
 * @param value 待检查值
-* @param safeCheck 是否附加安全数检查
+* @param safeCheck 是否附加安全整数检查
 * @returns 是否为整数
 */
 function isInteger(value, safeCheck = true) {
@@ -374,7 +436,7 @@ function isInteger(value, safeCheck = true) {
 * - 此函数中 `0` 不被视为正整数
 *
 * @param value 待检查值
-* @param safeCheck 是否附加安全数检查
+* @param safeCheck 是否附加安全整数检查
 */
 function isPositiveInteger(value, safeCheck = true) {
 	return isInteger(value, safeCheck) && value > 0;
@@ -384,7 +446,7 @@ function isPositiveInteger(value, safeCheck = true) {
 * - 此函数中 `0` 不被视为负整数
 *
 * @param value 待检查值
-* @param safeCheck 是否附加安全数检查
+* @param safeCheck 是否附加安全整数检查
 */
 function isNegativeInteger(value, safeCheck = true) {
 	return isInteger(value, safeCheck) && value < 0;
@@ -417,7 +479,7 @@ function isInfinityLike(value) {
 //#endregion
 //#region src/utils/typeof/isObject.ts
 /**
-* 判断是否为对象类型
+* 判断是否为普通对象类型
 * - 可选是否检查原型为 `Object.prototype`，防止原型链污染
 *
 * @param value 待检查值
@@ -426,8 +488,11 @@ function isInfinityLike(value) {
 * @example
 * ```ts
 * isObject({}); // true
+* isObject([]); // false
 * isObject(new Date()); // false (because prototype is not Object.prototype)
 * isObject(new Date(), false); // true (is object type)
+* isObject(Object.create(null)) // false
+* isObject(Object.create(null), false) // true
 * ```
 */
 function isObject(value, prototypeCheck = true) {
@@ -457,16 +522,12 @@ function isPromiseLike(value) {
 //#endregion
 //#region src/utils/typeof/isReadableStream.ts
 /**
-* Checks if a value is a WHATWG ReadableStream instance.
-*
+* 检查 value 是否为 ReadableStream
 * - Uses `Object.prototype.toString` where supported (modern browsers, Node.js ≥18).
 * - Falls back to duck-typing in older environments.
 * - Resistant to basic forgery, but not 100% secure in all polyfill scenarios.
+* - ⚠️ Note: In older Node.js (<18) or with non-compliant polyfills, this may return false positives or negatives.
 *
-* ⚠️ Note: In older Node.js (<18) or with non-compliant polyfills, this may return false positives or negatives.
-*/
-/**
-* 检查 value 是否为 ReadableStream
 * @param value 待检查值
 * @returns 是否为 ReadableStream
 */
@@ -702,20 +763,6 @@ function arrayFork(initialList, match) {
 
 //#endregion
 //#region src/utils/array/arrayIntersection.ts
-/**
-* 求数组交集
-* - 返回在 `initialList` 和 `diffList` 中都存在的元素
-*
-* @param initialList 初始数组
-* @param diffList 对比数组
-* @param match 匹配函数
-* @returns 交集数组
-* @example
-* ```ts
-* arrayIntersection([1, 2], [2, 3]); // [2]
-* arrayIntersection([{ id: 1 }, { id: 2 }], [{ id: 2 }], (x) => x.id); // [{ id: 2 }]
-* ```
-*/
 function arrayIntersection(initialList, diffList, match) {
 	if (!isArray(initialList) || !isArray(diffList)) return [];
 	if (!initialList.length || !diffList.length) return [];
@@ -736,27 +783,6 @@ function arrayLast(initialList, saveValue) {
 
 //#endregion
 //#region src/utils/array/arrayMerge.ts
-/**
-* 数组合并
-* - 如果未提供 `match` 函数，则合并两个数组并去重（Union）
-* - 如果提供了 `match` 函数，则仅更新 `initialList` 中匹配到的项（Left Join Update），不会追加 `mergeList` 中新增的项
-*
-* @param initialList 初始数组
-* @param mergeList 待合并数组
-* @param match 匹配函数
-* @returns 合并后的数组
-* @example
-* ```ts
-* // 基础合并去重
-* arrayMerge([1, 2], [2, 3]); // [1, 2, 3]
-*
-* // 按条件更新
-* const source = [{ id: 1, val: "a" }, { id: 2, val: "b" }];
-* const update = [{ id: 2, val: "new" }, { id: 3, val: "c" }];
-* arrayMerge(source, update, (x) => x.id);
-* // [{ id: 1, val: "a" }, { id: 2, val: "new" }] -> id:3 被忽略
-* ```
-*/
 function arrayMerge(initialList, mergeList, match) {
 	if (!isArray(initialList)) return [];
 	if (!isArray(mergeList)) return [...initialList];
@@ -787,26 +813,12 @@ function arrayPick(initialList, filter, mapper) {
 
 //#endregion
 //#region src/utils/array/arrayReplace.ts
-/**
-* 数组项替换
-* - 在给定的数组中，替换符合匹配函数结果的项目
-* - 只替换第一个匹配项
-*
-* @param initialList 初始数组
-* @param newItem 替换项
-* @param match 匹配函数
-* @returns 替换后的新数组
-* @example
-* ```ts
-* arrayReplace([1, 2, 3], 4, (n) => n === 2); // [1, 4, 3]
-* ```
-*/
 function arrayReplace(initialList, newItem, match) {
 	if (!isArray(initialList) || !initialList.length) return [];
-	if (newItem === void 0 || !isFunction(match)) return [...initialList];
+	if (!isFunction(match)) return [...initialList];
 	for (let i = 0; i < initialList.length; i++) {
 		const item = initialList[i];
-		if (item !== void 0 && match(item, i)) return [
+		if (match(item, i)) return [
 			...initialList.slice(0, i),
 			newItem,
 			...initialList.slice(i + 1, initialList.length)
@@ -839,7 +851,7 @@ function arrayReplace(initialList, newItem, match) {
 function arrayReplaceMove(initialList, newItem, match, position) {
 	if (!isArray(initialList)) return [];
 	if (!initialList.length) return [newItem];
-	if (newItem === void 0 || !isFunction(match)) return [...initialList];
+	if (!isFunction(match)) return [...initialList];
 	const result = [...initialList];
 	const matchIndex = initialList.findIndex(match);
 	if (matchIndex !== -1) result.splice(matchIndex, 1);
@@ -865,6 +877,7 @@ function arrayReplaceMove(initialList, newItem, match, position) {
 */
 function arraySplit(initialList, size = 10) {
 	if (!isArray(initialList)) return [];
+	if (!isPositiveInteger(size, false)) return [];
 	const count = Math.ceil(initialList.length / size);
 	return Array.from({ length: count }).fill(null).map((_c, i) => {
 		return initialList.slice(i * size, i * size + size);
@@ -1003,13 +1016,19 @@ function to(promise, errorExt) {
 	return promise.then((data) => [null, data]).catch((err) => {
 		if (errorExt) {
 			const parsedError = {
-				...err,
-				...errorExt
+				name: "",
+				message: "",
+				stack: ""
 			};
 			if (err instanceof Error) {
-				parsedError["message"] = err.message;
-				parsedError["stack"] = err.stack;
-			}
+				parsedError.message = err.message;
+				parsedError.name = err.name;
+				parsedError.stack = err.stack;
+				Object.getOwnPropertyNames(err).forEach((key) => {
+					if (!(key in parsedError)) parsedError[key] = err[key];
+				});
+			} else Object.assign(parsedError, err);
+			Object.assign(parsedError, errorExt);
 			return [parsedError, void 0];
 		}
 		return [err ? err : /* @__PURE__ */ new Error("defaultError"), void 0];
@@ -1021,9 +1040,6 @@ function to(promise, errorExt) {
 const R1$2 = /[^0-9.-]/g;
 /**
 * 从字符串中提取数字字符串
-*
-/**
-* 从字符串中提取数字字符串
 * - 移除非数字字符，保留符号和小数点
 *
 * @param input 待处理字符串
@@ -1035,8 +1051,9 @@ const R1$2 = /[^0-9.-]/g;
 * ```
 */
 function stringToNumber(input) {
-	if (!isString(input, true)) return "";
+	if (!isString(input, true)) return "0";
 	const cleaned = input.replace(R1$2, "");
+	if (!cleaned) return "0";
 	let isDecimal = false;
 	let signCount = 0;
 	let firstIndex = -1;
@@ -1062,7 +1079,7 @@ function stringToNumber(input) {
 }
 
 //#endregion
-//#region src/utils/math/toMathBignumber.ts
+//#region src/utils/math/mathToBignumber.ts
 /**
 * 将任意类型的值转换为 `math.bignumber`
 *
@@ -1074,10 +1091,10 @@ function stringToNumber(input) {
 * ```ts
 * import { create, all } from "mathjs";
 * const math = create(all);
-* toMathBignumber(math, "0.1");
+* mathToBignumber(math, "0.1");
 * ```
 */
-function toMathBignumber(mathJsInstance, value, saveValue) {
+function mathToBignumber(mathJsInstance, value, saveValue) {
 	const errorValue = saveValue ?? mathJsInstance.bignumber(0);
 	if (isFalsyLike(value) || isInfinityLike(value)) return errorValue;
 	try {
@@ -1088,9 +1105,9 @@ function toMathBignumber(mathJsInstance, value, saveValue) {
 }
 
 //#endregion
-//#region src/utils/math/toMathDecimal.ts
-function toMathDecimal(mathJsInstance, value, precision, isFormat = true) {
-	const bigNumber = toMathBignumber(mathJsInstance, value);
+//#region src/utils/math/mathToDecimal.ts
+function mathToDecimal(mathJsInstance, value, precision, isFormat = true) {
+	const bigNumber = mathToBignumber(mathJsInstance, value);
 	return isFormat ? mathJsInstance.format(bigNumber, {
 		notation: "fixed",
 		precision
@@ -1098,7 +1115,7 @@ function toMathDecimal(mathJsInstance, value, precision, isFormat = true) {
 }
 
 //#endregion
-//#region src/utils/math/toMathEvaluate.ts
+//#region src/utils/math/mathToEvaluate.ts
 /**
 * 数学表达式求值
 *
@@ -1108,16 +1125,16 @@ function toMathDecimal(mathJsInstance, value, precision, isFormat = true) {
 * @returns 计算结果的字符串表示
 * @example
 * ```ts
-* toMathEvaluate(math, "a + b", { a: 1, b: 2 }); // "3"
+* mathToEvaluate(math, "a + b", { a: 1, b: 2 }); // "3"
 * ```
 */
-function toMathEvaluate(mathJsInstance, expr, scope) {
+function mathToEvaluate(mathJsInstance, expr, scope) {
 	const evaluateValue = `${mathJsInstance.evaluate(expr, scope || {})}`;
-	return mathJsInstance.format(toMathBignumber(mathJsInstance, evaluateValue), { notation: "fixed" });
+	return mathJsInstance.format(mathToBignumber(mathJsInstance, evaluateValue), { notation: "fixed" });
 }
 
 //#endregion
-//#region src/utils/number/isWithinInterval.ts
+//#region src/utils/number/numberWithin.ts
 /**
 * 数字区间检查函数
 *
@@ -1128,11 +1145,11 @@ function toMathEvaluate(mathJsInstance, expr, scope) {
 * @returns 是否在区间内
 * @example
 * ```ts
-* isWithinInterval(5, [1, 10]); // true
-* isWithinInterval(1, [1, 10], false); // false
+* numberWithin(5, [1, 10]); // true
+* numberWithin(1, [1, 10], false); // false
 * ```
 */
-function isWithinInterval(input, interval, includeLeft = true, includeRight = false) {
+function numberWithin(input, interval, includeLeft = true, includeRight = false) {
 	if (!isNumber(input)) throw new Error("params [input] mast be a number.");
 	if (isInfinity(input)) throw new Error("params [input] mast be a finite number.");
 	const [left, right] = interval;
@@ -1143,114 +1160,33 @@ function isWithinInterval(input, interval, includeLeft = true, includeRight = fa
 	else return input > left && input < right;
 }
 
-//#endregion
-//#region src/utils/object/cloneDeep.ts
-const defaultCloneStrategy = {
-	cloneMap,
-	cloneSet,
-	cloneDate,
-	cloneArray,
-	cloneObject,
-	cloneOther
-};
-function cloneMap(input, track, clone) {
-	const output = track(/* @__PURE__ */ new Map());
-	for (const [key, value] of input) output.set(key, clone(value));
-	return output;
-}
-function cloneSet(input, track, clone) {
-	const output = track(/* @__PURE__ */ new Set());
-	for (const value of input) output.add(clone(value));
-	return output;
-}
-function cloneDate(input, track) {
-	return track(new Date(input));
-}
-function cloneArray(input, track, clone) {
-	const output = track(new Array(input.length));
-	input.forEach((value, index) => {
-		output[index] = clone(value);
-	});
-	return output;
-}
-function cloneObject(input, track, clone) {
-	const output = track(Object.create(Object.getPrototypeOf(input)));
-	for (const key of Reflect.ownKeys(input)) {
-		const descriptor = Object.getOwnPropertyDescriptor(input, key);
-		if ("value" in descriptor) descriptor.value = clone(descriptor.value);
-		Object.defineProperty(output, key, descriptor);
-	}
-	return output;
-}
-function cloneOther(input, track) {
-	return track(input);
-}
-/**
-* 深度拷贝对象
-* - 支持 Array, Object, Map, Set
-* - 自动处理循环引用
-*
-* @param root 需要拷贝的对象
-* @param customStrategy 自定义拷贝策略
-* @returns 拷贝后的对象
-* @example
-* ```ts
-* const original = { a: 1, b: { c: 2 } };
-* const copy = cloneDeep(original);
-* copy.b.c = 3;
-* // original.b.c === 2
-* ```
-* @reference https://github.com/radashi-org/radashi/blob/main/src/object/cloneDeep.ts
-*/
-function cloneDeep(root, customStrategy) {
-	const strategy = {
-		...defaultCloneStrategy,
-		...customStrategy
-	};
-	const tracked = /* @__PURE__ */ new Map();
-	const track = (parent, newParent) => {
-		tracked.set(parent, newParent);
-		return newParent;
-	};
-	const clone = (value) => {
-		return value && typeof value === "object" ? tracked.get(value) ?? cloneDeep$1(value, strategy) : value;
-	};
-	const cloneDeep$1 = (parent, strategy$1) => {
-		const newParent = (isObject(parent) ? strategy$1.cloneObject : isArray(parent) ? strategy$1.cloneArray : isMap(parent) ? strategy$1.cloneMap : isSet(parent) ? strategy$1.cloneSet : isDate(parent, false) ? strategy$1.cloneDate : strategy$1.cloneOther)(parent, track.bind(null, parent), clone);
-		if (!newParent) return cloneDeep$1(parent, defaultCloneStrategy);
-		tracked.set(parent, newParent);
-		return newParent;
-	};
-	return cloneDeep$1(root, strategy);
-}
-
 //#endregion
 //#region src/utils/object/enumEntries.ts
 function enumEntries(enumeration) {
-	const [isEnum, isTwoWayEnum] = isEnumeration(enumeration);
+	const [isEnum, isBidirectionalEnum] = isEnumeration(enumeration);
 	if (!isEnum) throw Error("function enumEntries expected parameter is a enum, and requires at least one member");
 	const entries = objectEntries(enumeration);
-	if (isTwoWayEnum) return entries.splice(entries.length / 2, entries.length / 2);
+	if (isBidirectionalEnum) return entries.splice(entries.length / 2, entries.length / 2);
 	return entries;
 }
 
 //#endregion
 //#region src/utils/object/enumKeys.ts
 function enumKeys(enumeration) {
-	const [isEnum, isTwoWayEnum] = isEnumeration(enumeration);
+	const [isEnum, isBidirectionalEnum] = isEnumeration(enumeration);
 	if (!isEnum) throw Error("function enumKeys expected parameter is a enum, and requires at least one member");
 	const keys = objectKeys(enumeration);
-	if (isTwoWayEnum) return keys.splice(keys.length / 2, keys.length / 2);
+	if (isBidirectionalEnum) return keys.splice(keys.length / 2, keys.length / 2);
 	return keys;
 }
 
 //#endregion
 //#region src/utils/object/enumValues.ts
 function enumValues(enumeration) {
-	const [isEnum, isTwoWayEnum] = isEnumeration(enumeration);
+	const [isEnum, isBidirectionalEnum] = isEnumeration(enumeration);
 	if (!isEnum) throw Error("function enumValues expected parameter is a enum, and requires at least one member");
 	const values = objectValues(enumeration);
-	if (isTwoWayEnum) return values.splice(values.length / 2, values.length / 2);
+	if (isBidirectionalEnum) return values.splice(values.length / 2, values.length / 2);
 	return values;
 }
 
@@ -1261,24 +1197,24 @@ function objectEntries(value) {
 }
 
 //#endregion
-//#region src/utils/object/mapEntries.ts
+//#region src/utils/object/objectMapEntries.ts
 /**
 * 映射对象条目
 * - 将对象的键值对映射为新的键值对
 *
-* @param obj 对象
+* @param plainObject 对象
 * @param toEntry 映射函数
 * @returns 映射后的新对象
 * @example
 * ```ts
 * const obj = { a: 1, b: 2 };
-* mapEntries(obj, (k, v) => [k, v * 2]); // { a: 2, b: 4 }
+* objectMapEntries(obj, (k, v) => [k, v * 2]); // { a: 2, b: 4 }
 * ```
 */
-function mapEntries(obj, toEntry) {
+function objectMapEntries(plainObject, toEntry) {
 	const defaultResult = {};
-	if (!obj) return defaultResult;
-	return objectEntries(obj).reduce((acc, [key, value]) => {
+	if (!isObject(plainObject)) return defaultResult;
+	return objectEntries(plainObject).reduce((acc, [key, value]) => {
 		const [newKey, newValue] = toEntry(key, value);
 		acc[newKey] = newValue;
 		return acc;
@@ -1287,13 +1223,30 @@ function mapEntries(obj, toEntry) {
 
 //#endregion
 //#region src/utils/object/objectAssign.ts
-function objectAssign(initial, override) {
-	if (!isObject(initial) || !isObject(override)) return initial ?? override ?? {};
-	const proto = Object.getPrototypeOf(initial);
-	const assigned = proto ? { ...initial } : Object.assign(Object.create(proto), initial);
-	for (const key of Object.keys(override)) assigned[key] = isObject(initial[key]) && isObject(override[key]) ? objectAssign(initial[key], override[key]) : override[key];
+const OBJECT_PROTO = Object.prototype;
+/**
+* 为对象创建一个具有相同原型的新副本
+* 这个辅助函数是保留原型的关键。
+*/
+function cloneWithProto(obj) {
+	const proto = Object.getPrototypeOf(obj);
+	return proto === OBJECT_PROTO ? { ...obj } : Object.assign(Object.create(proto), obj);
+}
+function _objectAssign(initial, override, _seen) {
+	if (!isObject(initial, false) && !isObject(override, false)) return {};
+	if (!isObject(initial, false)) return cloneWithProto(override);
+	if (!isObject(override, false)) return cloneWithProto(initial);
+	if (_seen.has(initial)) return cloneWithProto(override);
+	_seen.add(initial);
+	const assigned = cloneWithProto(initial);
+	for (const key of Object.keys(override)) if (isObject(initial[key]) && isObject(override[key])) assigned[key] = _objectAssign(initial[key], override[key], _seen);
+	else assigned[key] = override[key];
+	_seen.delete(initial);
 	return assigned;
 }
+function objectAssign(initial, override) {
+	return _objectAssign(initial, override, /* @__PURE__ */ new WeakSet());
+}
 
 //#endregion
 //#region src/utils/object/objectCrush.ts
@@ -1420,9 +1373,7 @@ function stringReplace(input, search, replacement) {
 const R1 = /\{\{(.+?)\}\}/g;
 /**
 * 字符串模板替换
-*
-/**
-* 字符串模板替换
+* - 使用对象的属性值替换字符串中的 {{key}} 模板
 *
 * @param input 待处理字符串
 * @param template 模板对象
@@ -1435,11 +1386,14 @@ const R1 = /\{\{(.+?)\}\}/g;
 */
 function stringTemplate(input, template, regex = R1) {
 	if (!isString(input, true)) return "";
+	regex.lastIndex = 0;
 	let result = "";
 	let from = 0;
 	let match;
 	while (match = regex.exec(input)) {
-		result += input.slice(from, match.index) + template[match[1]];
+		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;
 	}
 	return result + input.slice(from);
@@ -1475,23 +1429,35 @@ function stringToJson(input, safeValue) {
 //#region src/utils/string/stringToPosix.ts
 /**
 * 将路径转换为 POSIX 风格
-*
-/**
-* 将路径转换为 POSIX 风格
-* - 统一使用正斜杠
-* - 处理 Windows 盘符
+* - 统一使用正斜杠 (/)
+* - 可选移除 Windows 盘符 (如 C:)
+* - 可选移除开头的斜杠
+* - 规范化连续斜杠为单个斜杠
 *
 * @param input 待处理字符串
-* @param removeLeadingSlash 是否移除开头斜杠，默认为 `false`
-* @returns 转换后的路径
+* @param removeLeadingSlash 是否移除开头斜杠，默认为 `false`。如果移除了盘符，路径通常会以 / 开头，此参数可控制是否保留该 /
+* @returns 转换后的路径，如果输入无效则返回空字符串
+*
 * @example
 * ```ts
-* stringToPosix("C:\\Windows\\System32"); // "/Windows/System32"
+* stringToPosix("C:\\Windows\\System32");
+* // 默认: "/Windows/System32" (移除了 C: 并标准化)
+*
+* stringToPosix("C:\\Windows\\System32", true);
+* // 移除开头斜杠: "Windows/System32"
+*
+* stringToPosix("\\\\server\\share\\file.txt");
+* // UNC 路径: "/server/share/file.txt"
+*
+* stringToPosix("folder\\subfolder\\file.txt");
+* // 相对路径: "folder/subfolder/file.txt"
 * ```
 */
 function stringToPosix(input, removeLeadingSlash = false) {
 	if (!isString(input, true)) return "";
-	let normalized = input.replace(/^[A-Za-z]:[\\/]?/, "").replace(/^[\\/]+/, "/");
+	let normalized = input.replace(/^[A-Za-z]:([\\/])?/, (_, separator) => {
+		return separator ? "/" : "";
+	});
 	normalized = normalized.replace(/\\/g, "/");
 	normalized = normalized.replace(/\/+/g, "/");
 	if (removeLeadingSlash && normalized.startsWith("/")) normalized = normalized.substring(1);
@@ -1535,7 +1501,6 @@ function stringTrim(input, charsToTrim = " ") {
 //#endregion
 //#region src/utils/string/stringTruncate.ts
 /**
-/**
 * 截取字符串
 * - 支持自定义省略符，不会截断在汉字中间（因为JS字符串本身按字符处理）
 *
@@ -1550,10 +1515,12 @@ function stringTrim(input, charsToTrim = " ") {
 */
 function stringTruncate(input, maxLength, ellipsis = "...") {
 	if (!isString(input, true)) return "";
-	if (!isPositiveInteger(maxLength)) return input;
-	if (input.length <= maxLength) return input;
-	const truncated = input.slice(0, maxLength - ellipsis.length);
-	return truncated.length > 0 ? truncated + ellipsis : "";
+	const codePoints = Array.from(input);
+	if (!isInteger(maxLength) || maxLength < 0) return input;
+	if (codePoints.length <= maxLength) return input;
+	const availableLength = maxLength - ellipsis.length;
+	if (availableLength <= 0) return "";
+	return codePoints.slice(0, availableLength).join("") + ellipsis;
 }
 
 //#endregion
@@ -2033,5 +2000,5 @@ function treeToRows(tree, options = {}) {
 }
 
 //#endregion
-export { arrayCounting as $, toMathEvaluate as A, isEnumeration as At, arrayZipToObject as B, isBigInt as Bt, mapEntries as C, isMap as Ct, enumEntries as D, isFalsyLike as Dt, enumKeys as E, isFalsy as Et, isTablet as F, isFunction as Ft, arrayReplace as G, arrayZip as H, isTypedArray as Ht, isIOSMobile as I, isGeneratorFunction as It, arrayLast as J, arrayPick as K, isMobile as L, isBoolean as Lt, toMathBignumber as M, isClass as Mt, stringToNumber as N, isAsyncFunction as Nt, cloneDeep as O, isError as Ot, to as P, isAsyncGeneratorFunction as Pt, arrayDifference as Q, isBrowser as R, isBlob as Rt, objectAssign as S, isNull as St, enumValues as T, isIterable as Tt, arraySplit as U, isAbortSignal as Ut, arrayUnzip as V, isArray as Vt, arrayReplaceMove as W, arrayFork as X, arrayIntersection as Y, arrayFirst as Z, objectPick as _, isInteger as _t, treeFind as a, isUndefined as at, objectInvert as b, isNumber as bt, stringTruncate as c, isWeakSet as ct, stringToPosix as d, isReadableStream as dt, arrayCompete as et, stringToJson as f, isPromise as ft, objectValues as g, isInfinityLike as gt, stringInitialCase as h, isInfinity as ht, treeForEach as i, isURLSearchParams as it, toMathDecimal as j, isDate as jt, isWithinInterval as k, isEqual as kt, stringTrim as l, isRegExp as lt, stringReplace as m, isObject as mt, rowsToTree as n, isWindow as nt, treeFilter as o, isSymbol as ot, stringTemplate as p, isPromiseLike as pt, arrayMerge as q, treeMap as r, isWebSocket as rt, getTimeZone as s, isSet as st, treeToRows as t, arrayCast as tt, stringToValues as u, isString as ut, objectOmit as v, isNaN as vt, objectEntries as w, isWeakMap as wt, objectCrush as x, isPositiveInteger as xt, objectKeys as y, isNegativeInteger as yt, isWebWorker as z, isFile as zt };
-//# sourceMappingURL=utils-RGh-N7TJ.js.map
+export { arrayFirst as $, mathToDecimal as A, isFalsy as At, isBrowser as B, isGeneratorFunction as Bt, objectMapEntries as C, isPositiveInteger as Ct, enumEntries as D, isIterable as Dt, enumKeys as E, isWeakMap as Et, cloneDeepWith as F, isDate as Ft, arraySplit as G, isArray as Gt, arrayZipToObject as H, isBlob as Ht, to as I, isClass as It, arrayPick as J, arrayReplaceMove as K, isTypedArray as Kt, isTablet as L, isAsyncFunction as Lt, stringToNumber as M, isError as Mt, clone as N, isEqual as Nt, numberWithin as O, isIframe as Ot, cloneDeep as P, isEnumeration as Pt, arrayFork as Q, isIOSMobile as R, isAsyncGeneratorFunction as Rt, objectAssign as S, isNumber as St, enumValues as T, isMap as Tt, arrayUnzip as U, isFile as Ut, isWebWorker as V, isBoolean as Vt, arrayZip as W, isBigInt as Wt, arrayLast as X, arrayMerge as Y, arrayIntersection as Z, objectPick as _, isInfinity as _t, treeFind as a, isWebSocket as at, objectInvert as b, isNaN as bt, stringTruncate as c, isSymbol as ct, stringToPosix as d, isRegExp as dt, arrayDifference as et, stringToJson as f, isString as ft, objectValues as g, isObject as gt, stringInitialCase as h, isPromiseLike as ht, treeForEach as i, isWindow as it, mathToBignumber as j, isFalsyLike as jt, mathToEvaluate as k, isInIframe as kt, stringTrim as l, isSet as lt, stringReplace as m, isPromise as mt, rowsToTree as n, arrayCompete as nt, treeFilter as o, isURLSearchParams as ot, stringTemplate as p, isReadableStream as pt, arrayReplace as q, isAbortSignal as qt, treeMap as r, arrayCast as rt, getTimeZone as s, isUndefined as st, treeToRows as t, arrayCounting as tt, stringToValues as u, isWeakSet as ut, objectOmit as v, isInfinityLike as vt, objectEntries as w, isNull as wt, objectCrush as x, isNegativeInteger as xt, objectKeys as y, isInteger as yt, isMobile as z, isFunction as zt };
+//# sourceMappingURL=utils-DbMbll5L.js.map