@pawover/kit 0.0.0-beta.41 → 0.0.0-beta.43

package/dist/{utils-_dtCs-qa.js → utils-DvWLCdYR.js}

@@ -1,5 +1,3 @@
-import { clone, cloneDeep, cloneDeepWith } from "lodash-es";
-
 //#region src/utils/typeof/types.ts
 const PROTOTYPE_TAGS = Object.freeze({
 	abortSignal: "[object AbortSignal]",
@@ -46,10 +44,19 @@ const TYPED_ARRAY_TAGS = new Set([
 	"[object BigInt64Array]",
 	"[object BigUint64Array]"
 ]);
+/**
+* 获取值的 [[Prototype]] 标签（通过 Object.prototype.toString）
+*
+* @example
+* resolvePrototypeString([]) // "[object Array]"
+* resolvePrototypeString(null) // "[object Null]"
+*
+* @param value - 任意 JavaScript 值
+* @returns 标准化的类型标签字符串
+*/
 function resolvePrototypeString(value) {
 	return Object.prototype.toString.call(value);
 }
-
 //#endregion
 //#region src/utils/typeof/isAbortSignal.ts
 /**
@@ -60,7 +67,6 @@ function resolvePrototypeString(value) {
 function isAbortSignal(value) {
 	return resolvePrototypeString(value) === PROTOTYPE_TAGS.abortSignal;
 }
-
 //#endregion
 //#region src/utils/typeof/isArray.ts
 /**
@@ -89,7 +95,6 @@ function isArray(value) {
 function isTypedArray(value) {
 	return typeof value === "object" && value !== null && TYPED_ARRAY_TAGS.has(resolvePrototypeString(value));
 }
-
 //#endregion
 //#region src/utils/typeof/isBigInt.ts
 /**
@@ -100,7 +105,6 @@ function isTypedArray(value) {
 function isBigInt(value) {
 	return typeof value === "bigint";
 }
-
 //#endregion
 //#region src/utils/typeof/isBlob.ts
 /**
@@ -114,7 +118,6 @@ function isBlob(value) {
 function isFile(value) {
 	return resolvePrototypeString(value) === PROTOTYPE_TAGS.file;
 }
-
 //#endregion
 //#region src/utils/typeof/isBoolean.ts
 /**
@@ -125,7 +128,6 @@ function isFile(value) {
 function isBoolean(value) {
 	return typeof value === "boolean";
 }
-
 //#endregion
 //#region src/utils/typeof/isFunction.ts
 /**
@@ -160,7 +162,6 @@ function isGeneratorFunction(value) {
 function isAsyncGeneratorFunction(value) {
 	return isFunction(value) && resolvePrototypeString(value) === PROTOTYPE_TAGS.asyncGeneratorFunction;
 }
-
 //#endregion
 //#region src/utils/typeof/isClass.ts
 function isConstructable(fn) {
@@ -186,7 +187,6 @@ function isConstructable(fn) {
 function isClass(value) {
 	return isFunction(value) && !isAsyncFunction(value) && Function.prototype.toString.call(value).startsWith("class ") && isConstructable(value) && value.prototype !== void 0;
 }
-
 //#endregion
 //#region src/utils/typeof/isDate.ts
 /**
@@ -218,7 +218,6 @@ function isDate(value, invalidCheck = true) {
 		return false;
 	}
 }
-
 //#endregion
 //#region src/utils/typeof/isEnumeration.ts
 /**
@@ -267,7 +266,6 @@ function isEnumeration(enumeration) {
 	}
 	return [true, isBidirectional];
 }
-
 //#endregion
 //#region src/utils/typeof/isEqual.ts
 /**
@@ -303,7 +301,6 @@ function isEqual(x, y) {
 	}
 	return _isEqual(x, y);
 }
-
 //#endregion
 //#region src/utils/typeof/isError.ts
 /**
@@ -314,7 +311,6 @@ function isEqual(x, y) {
 function isError(value) {
 	return value instanceof Error || resolvePrototypeString(value) === PROTOTYPE_TAGS.error;
 }
-
 //#endregion
 //#region src/utils/typeof/isFalsy.ts
 /**
@@ -330,7 +326,6 @@ function isFalsyLike(value) {
 	if (isFalsy(value)) return true;
 	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
 /**
@@ -351,7 +346,6 @@ function isInIframe() {
 		return false;
 	}
 }
-
 //#endregion
 //#region src/utils/typeof/isIterable.ts
 /**
@@ -362,7 +356,6 @@ function isInIframe() {
 function isIterable(value) {
 	return !!value && typeof value[Symbol.iterator] === "function";
 }
-
 //#endregion
 //#region src/utils/typeof/isMap.ts
 /**
@@ -381,7 +374,6 @@ function isMap(value) {
 function isWeakMap(value) {
 	return resolvePrototypeString(value) === PROTOTYPE_TAGS.weakMap;
 }
-
 //#endregion
 //#region src/utils/typeof/isNull.ts
 /**
@@ -392,7 +384,6 @@ function isWeakMap(value) {
 function isNull(value) {
 	return value === null;
 }
-
 //#endregion
 //#region src/utils/typeof/isNumber.ts
 /**
@@ -475,7 +466,6 @@ function isInfinityLike(value) {
 	}
 	return false;
 }
-
 //#endregion
 //#region src/utils/typeof/isObject.ts
 /**
@@ -489,8 +479,8 @@ function isInfinityLike(value) {
 * ```ts
 * isObject({}); // true
 * isObject([]); // false
-* isObject(new Date()); // false (because prototype is not Object.prototype)
-* isObject(new Date(), false); // true (is object type)
+* isObject(new Date()); // false
+* isObject(new Date(), false); // true
 * isObject(Object.create(null)) // false
 * isObject(Object.create(null), false) // true
 * ```
@@ -499,7 +489,6 @@ function isObject(value, prototypeCheck = true) {
 	const check = resolvePrototypeString(value) === PROTOTYPE_TAGS.object;
 	return prototypeCheck ? check && Object.getPrototypeOf(value) === Object.prototype : check;
 }
-
 //#endregion
 //#region src/utils/typeof/isPromise.ts
 /**
@@ -516,9 +505,8 @@ function isPromise(value) {
 * @returns 是否为 PromiseLike
 */
 function isPromiseLike(value) {
-	return isPromise(value) || isObject(value) && isFunction(value["then"]);
+	return isPromise(value) || isObject(value, false) && isFunction(value["then"]);
 }
-
 //#endregion
 //#region src/utils/typeof/isReadableStream.ts
 /**
@@ -535,26 +523,6 @@ function isReadableStream(value) {
 	if (resolvePrototypeString(value) === PROTOTYPE_TAGS.readableStream) return true;
 	return isObject(value) && isFunction(value["getReader"]) && isFunction(value["pipeThrough"]);
 }
-
-//#endregion
-//#region src/utils/typeof/isString.ts
-/**
-* 检查 value 是否为 string 类型
-*
-* @param value 待检查值
-* @param checkEmpty 是否检查空字符串
-* @returns 是否为字符串
-* @example
-* ```ts
-* isString("abc"); // true
-* isString(""); // true
-* isString("", true); // false
-* ```
-*/
-function isString(value, checkEmpty = false) {
-	return typeof value === "string" && (!checkEmpty || !!value.length);
-}
-
 //#endregion
 //#region src/utils/typeof/isRegExp.ts
 /**
@@ -571,7 +539,6 @@ function isRegExp(value) {
 		return false;
 	}
 }
-
 //#endregion
 //#region src/utils/typeof/isSet.ts
 /**
@@ -590,7 +557,24 @@ function isSet(value) {
 function isWeakSet(value) {
 	return resolvePrototypeString(value) === PROTOTYPE_TAGS.weakSet;
 }
-
+//#endregion
+//#region src/utils/typeof/isString.ts
+/**
+* 检查 value 是否为 string 类型
+*
+* @param value 待检查值
+* @param checkEmpty 是否检查空字符串
+* @returns 是否为字符串
+* @example
+* ```ts
+* isString("abc"); // true
+* isString(""); // true
+* isString("", true); // false
+* ```
+*/
+function isString(value, checkEmpty = false) {
+	return typeof value === "string" && (!checkEmpty || !!value.length);
+}
 //#endregion
 //#region src/utils/typeof/isSymbol.ts
 /**
@@ -601,7 +585,6 @@ function isWeakSet(value) {
 function isSymbol(value) {
 	return typeof value === "symbol";
 }
-
 //#endregion
 //#region src/utils/typeof/isUndefined.ts
 /**
@@ -612,7 +595,6 @@ function isSymbol(value) {
 function isUndefined(value) {
 	return typeof value === "undefined";
 }
-
 //#endregion
 //#region src/utils/typeof/isURLSearchParams.ts
 /**
@@ -623,7 +605,6 @@ function isUndefined(value) {
 function isURLSearchParams(value) {
 	return resolvePrototypeString(value) === PROTOTYPE_TAGS.URLSearchParams;
 }
-
 //#endregion
 //#region src/utils/typeof/isWebSocket.ts
 /**
@@ -634,7 +615,6 @@ function isURLSearchParams(value) {
 function isWebSocket(value) {
 	return resolvePrototypeString(value) === PROTOTYPE_TAGS.webSocket;
 }
-
 //#endregion
 //#region src/utils/typeof/isWindow.ts
 /**
@@ -645,14 +625,12 @@ function isWebSocket(value) {
 function isWindow(value) {
 	return resolvePrototypeString(value) === PROTOTYPE_TAGS.window;
 }
-
 //#endregion
 //#region src/utils/array/arrayCast.ts
 function arrayCast(candidate, checkEmpty = true) {
 	if (checkEmpty && (isUndefined(candidate) || isNull(candidate))) return [];
 	return isArray(candidate) ? [...candidate] : [candidate];
 }
-
 //#endregion
 //#region src/utils/array/arrayCompete.ts
 /**
@@ -673,7 +651,6 @@ function arrayCompete(initialList, match) {
 	if (!isArray(initialList) || initialList.length === 0 || !isFunction(match)) return null;
 	return initialList.reduce(match);
 }
-
 //#endregion
 //#region src/utils/array/arrayCounting.ts
 /**
@@ -700,7 +677,6 @@ function arrayCounting(initialList, match) {
 		return prev;
 	}, {});
 }
-
 //#endregion
 //#region src/utils/array/arrayDifference.ts
 /**
@@ -731,14 +707,12 @@ function arrayDifference(initialList, diffList, match) {
 	});
 	return initialList.filter((item, index) => !map.get(match(item, index)));
 }
-
 //#endregion
 //#region src/utils/array/arrayFirst.ts
 function arrayFirst(initialList, saveValue) {
 	if (!isArray(initialList) || initialList.length === 0) return saveValue;
 	return initialList[0];
 }
-
 //#endregion
 //#region src/utils/array/arrayFork.ts
 /**
@@ -760,7 +734,6 @@ function arrayFork(initialList, match) {
 	});
 	return forked;
 }
-
 //#endregion
 //#region src/utils/array/arrayIntersection.ts
 function arrayIntersection(initialList, diffList, match) {
@@ -773,14 +746,12 @@ function arrayIntersection(initialList, diffList, match) {
 	const diffKeys = new Set(diffList.map((item, index) => match(item, index)));
 	return initialList.filter((item, index) => diffKeys.has(match(item, index)));
 }
-
 //#endregion
 //#region src/utils/array/arrayLast.ts
 function arrayLast(initialList, saveValue) {
 	if (!isArray(initialList) || initialList.length === 0) return saveValue;
 	return initialList[initialList.length - 1];
 }
-
 //#endregion
 //#region src/utils/array/arrayMerge.ts
 function arrayMerge(initialList, mergeList, match) {
@@ -796,7 +767,6 @@ function arrayMerge(initialList, mergeList, match) {
 		return keys.has(key) ? keys.get(key) : prevItem;
 	});
 }
-
 //#endregion
 //#region src/utils/array/arrayPick.ts
 function arrayPick(initialList, filter, mapper) {
@@ -810,7 +780,6 @@ function arrayPick(initialList, filter, mapper) {
 		return prev;
 	}, []);
 }
-
 //#endregion
 //#region src/utils/array/arrayReplace.ts
 function arrayReplace(initialList, newItem, match) {
@@ -826,7 +795,6 @@ function arrayReplace(initialList, newItem, match) {
 	}
 	return [...initialList];
 }
-
 //#endregion
 //#region src/utils/array/arrayReplaceMove.ts
 /**
@@ -860,7 +828,6 @@ function arrayReplaceMove(initialList, newItem, match, position) {
 	else result.push(newItem);
 	return result;
 }
-
 //#endregion
 //#region src/utils/array/arraySplit.ts
 /**
@@ -883,7 +850,6 @@ function arraySplit(initialList, size = 10) {
 		return initialList.slice(i * size, i * size + size);
 	});
 }
-
 //#endregion
 //#region src/utils/array/arrayZip.ts
 /**
@@ -908,7 +874,6 @@ function arrayUnzip(arrays) {
 function arrayZip(...arrays) {
 	return arrayUnzip(arrays);
 }
-
 //#endregion
 //#region src/utils/array/arrayZipToObject.ts
 function arrayZipToObject(keys, values) {
@@ -920,7 +885,6 @@ function arrayZipToObject(keys, values) {
 		return acc;
 	}, result);
 }
-
 //#endregion
 //#region src/utils/device/isBrowser.ts
 function isBrowser() {
@@ -929,7 +893,37 @@ function isBrowser() {
 function isWebWorker() {
 	return typeof window === "undefined" && typeof self !== "undefined" && "importScripts" in self;
 }
-
+//#endregion
+//#region src/utils/device/isTablet.ts
+/**
+* 检测当前设备是否为平板
+*
+* @param minWidth - 平板最小宽度（默认 768px）
+* @param maxWidth - 平板最大宽度（默认 1200px）
+* @param dpi - 标准 DPI 基准（默认 160）
+* @returns 是否为平板设备
+* @example
+* ```ts
+* // 假设 window.innerWidth = 1000
+* isTablet(); // true
+* ```
+*/
+function isTablet(minWidth = 768, maxWidth = 1200, dpi = 160) {
+	if (typeof window === "undefined" || !isPositiveInteger(minWidth) || !isPositiveInteger(maxWidth)) return false;
+	const width = window.innerWidth;
+	const isWithinWidthRange = width >= minWidth && width <= maxWidth;
+	try {
+		const widthPx = window.screen.width;
+		const heightPx = window.screen.height;
+		const DPI = dpi * (window.devicePixelRatio || 1);
+		const widthInch = widthPx / DPI;
+		const heightInch = heightPx / DPI;
+		const screenInches = Math.sqrt(widthInch ** 2 + heightInch ** 2);
+		return isWithinWidthRange || screenInches >= 7;
+	} catch {
+		return isWithinWidthRange;
+	}
+}
 //#endregion
 //#region src/utils/device/isMobile.ts
 /**
@@ -964,39 +958,6 @@ function isIOSMobile(maxWidth = 768, dpi = 160) {
 	if (typeof navigator === "undefined" || !navigator.userAgent || !isPositiveInteger(maxWidth)) return false;
 	return /iPhone|iPad|iPod/i.test(navigator.userAgent) && !isTablet(maxWidth, 1200, dpi);
 }
-
-//#endregion
-//#region src/utils/device/isTablet.ts
-/**
-* 检测当前设备是否为平板
-*
-* @param minWidth - 平板最小宽度（默认 768px）
-* @param maxWidth - 平板最大宽度（默认 1200px）
-* @param dpi - 标准 DPI 基准（默认 160）
-* @returns 是否为平板设备
-* @example
-* ```ts
-* // 假设 window.innerWidth = 1000
-* isTablet(); // true
-* ```
-*/
-function isTablet(minWidth = 768, maxWidth = 1200, dpi = 160) {
-	if (typeof window === "undefined" || !isPositiveInteger(minWidth) || !isPositiveInteger(maxWidth)) return false;
-	const width = window.innerWidth;
-	const isWithinWidthRange = width >= minWidth && width <= maxWidth;
-	try {
-		const widthPx = window.screen.width;
-		const heightPx = window.screen.height;
-		const DPI = dpi * (window.devicePixelRatio || 1);
-		const widthInch = widthPx / DPI;
-		const heightInch = heightPx / DPI;
-		const screenInches = Math.sqrt(widthInch ** 2 + heightInch ** 2);
-		return isWithinWidthRange || screenInches >= 7;
-	} catch {
-		return isWithinWidthRange;
-	}
-}
-
 //#endregion
 //#region src/utils/function/to.ts
 /**
@@ -1034,10 +995,116 @@ function to(promise, errorExt) {
 		return [err ? err : /* @__PURE__ */ new Error("defaultError"), void 0];
 	});
 }
-
+//#endregion
+//#region src/utils/string/stringInitialCase.ts
+const R1$2 = /\S+/g;
+const R2 = /[^a-zA-Z\u00C0-\u017F]/;
+/**
+* 字符串首字母大小写
+* - 包含非西欧字母字符时，不处理
+* - 纯字母且全大写时，不处理
+* - 纯字母且非全大写时，首字母小写，其余保留
+* - 纯字母且非全大写时，首字母大写，其余保留
+*
+* @param input 待处理字符串
+* @param caseType 大小写类型
+* @returns 处理后的字符串
+* @example
+* ```ts
+* stringInitialCase("Hello", "lower"); // "hello"
+* stringInitialCase("hello", "upper"); // "Hello"
+* ```
+*/
+function stringInitialCase(input, caseType) {
+	if (!isString(input, true)) return "";
+	return input.replace(R1$2, (word) => {
+		if (R2.test(word)) return word;
+		if (word === word.toLocaleUpperCase()) return word;
+		if (caseType === "lower" && word[0]) return word[0].toLocaleLowerCase() + word.slice(1);
+		if (caseType === "upper" && word[0]) return word[0].toLocaleUpperCase() + word.slice(1);
+		return word;
+	});
+}
+//#endregion
+//#region src/utils/string/stringReplace.ts
+/**
+* 字符串替换
+* - 替换第一个匹配项
+*
+* @param input 待处理字符串
+* @param search 匹配项
+* @param replacement 替换项
+* @returns 替换后的字符串
+* @example
+* ```ts
+* stringReplace("hello world", "world", "context"); // "hello context"
+* ```
+*/
+function stringReplace(input, search, replacement) {
+	if (!isString(input, true)) return "";
+	return input.replace(search, replacement);
+}
+//#endregion
+//#region src/utils/string/stringTemplate.ts
+const R1$1 = /\{\{(.+?)\}\}/g;
+/**
+* 字符串模板替换
+* - 使用对象的属性值替换字符串中的 {{key}} 模板
+*
+* @param input 待处理字符串
+* @param template 模板对象
+* @param regex 模板匹配正则 (默认: `\{\{(.+?)\}\}`)
+* @returns 替换后的字符串
+* @example
+* ```ts
+* stringTemplate("Hello {{name}}", { name: "World" }); // "Hello World"
+* ```
+*/
+function stringTemplate(input, template, regex = R1$1) {
+	if (!isString(input, true)) return "";
+	regex.lastIndex = 0;
+	let result = "";
+	let from = 0;
+	let match;
+	while (match = regex.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;
+	}
+	return result + input.slice(from);
+}
+//#endregion
+//#region src/utils/string/stringToJson.ts
+/**
+* 处理 JSON 字符串
+*
+* @param input 待处理字符串
+* @param safeValue 安全值 (当解析失败或输入无效时返回)
+* @returns 解析后的对象 或 安全值
+* @example
+* ```ts
+* stringToJson('{"a": 1}', {}); // { a: 1 }
+* stringToJson('invalid', {}); // {}
+* ```
+*/
+function stringToJson(input, safeValue) {
+	if (!isString(input, true)) return safeValue;
+	try {
+		return JSON.parse(input);
+	} catch (error) {
+		return safeValue;
+	}
+}
+//#endregion
+//#region src/utils/string/stringToLowerCase.ts
+function stringToLowerCase(input) {
+	if (!isString(input, true)) return "";
+	return input.toLowerCase();
+}
 //#endregion
 //#region src/utils/string/stringToNumber.ts
-const R1$2 = /[^0-9.-]/g;
+const R1 = /[^0-9.-]/g;
 /**
 * 从字符串中提取数字字符串
 * - 移除非数字字符，保留符号和小数点
@@ -1052,7 +1119,7 @@ const R1$2 = /[^0-9.-]/g;
 */
 function stringToNumber(input) {
 	if (!isString(input, true)) return "0";
-	const cleaned = input.replace(R1$2, "");
+	const cleaned = input.replace(R1, "");
 	if (!cleaned) return "0";
 	let isDecimal = false;
 	let signCount = 0;
@@ -1077,7 +1144,106 @@ function stringToNumber(input) {
 	if (result.endsWith(".")) result = result.slice(0, -1);
 	return sign + result;
 }
-
+//#endregion
+//#region src/utils/string/stringToPosix.ts
+/**
+* 将路径转换为 POSIX 风格
+* - 统一使用正斜杠 (/)
+* - 可选移除 Windows 盘符 (如 C:)
+* - 可选移除开头的斜杠
+* - 规范化连续斜杠为单个斜杠
+*
+* @param input 待处理字符串
+* @param removeLeadingSlash 是否移除开头斜杠，默认为 `false`。如果移除了盘符，路径通常会以 / 开头，此参数可控制是否保留该 /
+* @returns 转换后的路径，如果输入无效则返回空字符串
+*
+* @example
+* ```ts
+* 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]:([\\/])?/, (_, separator) => {
+		return separator ? "/" : "";
+	});
+	normalized = normalized.replace(/\\/g, "/");
+	normalized = normalized.replace(/\/+/g, "/");
+	if (removeLeadingSlash && normalized.startsWith("/")) normalized = normalized.substring(1);
+	return normalized;
+}
+//#endregion
+//#region src/utils/string/stringToUpperCase.ts
+function stringToUpperCase(input) {
+	if (!isString(input, true)) return "";
+	return input.toUpperCase();
+}
+//#endregion
+//#region src/utils/string/stringToValues.ts
+function stringToValues(input, valueType = "number", splitSymbol = ",") {
+	if (!isString(input, true)) return [];
+	try {
+		const values = input.split(splitSymbol);
+		if (valueType === "number") return values.map((d) => Number(d));
+		return values;
+	} catch (error) {
+		return [];
+	}
+}
+//#endregion
+//#region src/utils/string/stringTrim.ts
+/**
+* 从字符串中裁切掉所有的前缀和后缀字符
+*
+* @param input 待处理字符串
+* @param charsToTrim 裁切字符，默认为 `" "`
+* @returns 裁切后的字符串
+* @example
+* ```ts
+* stringTrim("  hello  "); // "hello"
+* stringTrim("__hello__", "_"); // "hello"
+* ```
+*/
+function stringTrim(input, charsToTrim = " ") {
+	if (!isString(input, true)) return "";
+	const toTrim = charsToTrim.replace(/[\W]{1}/g, "\\$&");
+	const regex = new RegExp(`^[${toTrim}]+|[${toTrim}]+$`, "g");
+	return input.replace(regex, "");
+}
+//#endregion
+//#region src/utils/string/stringTruncate.ts
+/**
+* 截取字符串
+* - 支持自定义省略符，不会截断在汉字中间（因为JS字符串本身按字符处理）
+*
+* @param input 待处理字符串
+* @param maxLength 最大长度 (包含省略符)
+* @param ellipsis 省略符，默认为 `...`
+* @returns 截取后的字符串
+* @example
+* ```ts
+* stringTruncate("hello world", 8); // "hello..."
+* ```
+*/
+function stringTruncate(input, maxLength, ellipsis = "...") {
+	if (!isString(input, true)) return "";
+	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
 //#region src/utils/math/mathToBignumber.ts
 /**
@@ -1103,7 +1269,6 @@ function mathToBignumber(mathJsInstance, value, saveValue) {
 		return errorValue;
 	}
 }
-
 //#endregion
 //#region src/utils/math/mathToDecimal.ts
 function mathToDecimal(mathJsInstance, value, precision, isFormat = true) {
@@ -1113,7 +1278,6 @@ function mathToDecimal(mathJsInstance, value, precision, isFormat = true) {
 		precision
 	}) : bigNumber;
 }
-
 //#endregion
 //#region src/utils/math/mathToEvaluate.ts
 /**
@@ -1132,7 +1296,6 @@ function mathToEvaluate(mathJsInstance, expr, scope) {
 	const evaluateValue = `${mathJsInstance.evaluate(expr, scope || {})}`;
 	return mathJsInstance.format(mathToBignumber(mathJsInstance, evaluateValue), { notation: "fixed" });
 }
-
 //#endregion
 //#region src/utils/number/numberWithin.ts
 /**
@@ -1159,7 +1322,6 @@ function numberWithin(input, interval, includeLeft = true, includeRight = false)
 	else if (includeRight) return input > left && input <= right;
 	else return input > left && input < right;
 }
-
 //#endregion
 //#region src/utils/object/enumEntries.ts
 function enumEntries(enumeration) {
@@ -1169,7 +1331,6 @@ function enumEntries(enumeration) {
 	if (isBidirectionalEnum) return entries.splice(entries.length / 2, entries.length / 2);
 	return entries;
 }
-
 //#endregion
 //#region src/utils/object/enumKeys.ts
 function enumKeys(enumeration) {
@@ -1179,7 +1340,6 @@ function enumKeys(enumeration) {
 	if (isBidirectionalEnum) return keys.splice(keys.length / 2, keys.length / 2);
 	return keys;
 }
-
 //#endregion
 //#region src/utils/object/enumValues.ts
 function enumValues(enumeration) {
@@ -1189,13 +1349,11 @@ function enumValues(enumeration) {
 	if (isBidirectionalEnum) return values.splice(values.length / 2, values.length / 2);
 	return values;
 }
-
 //#endregion
 //#region src/utils/object/objectEntries.ts
 function objectEntries(value) {
 	return Object.entries(value);
 }
-
 //#endregion
 //#region src/utils/object/objectMapEntries.ts
 /**
@@ -1220,7 +1378,6 @@ function objectMapEntries(plainObject, toEntry) {
 		return acc;
 	}, defaultResult);
 }
-
 //#endregion
 //#region src/utils/object/objectAssign.ts
 const OBJECT_PROTO = Object.prototype;
@@ -1247,7 +1404,6 @@ function _objectAssign(initial, override, _seen) {
 function objectAssign(initial, override) {
 	return _objectAssign(initial, override, /* @__PURE__ */ new WeakSet());
 }
-
 //#endregion
 //#region src/utils/object/objectCrush.ts
 function objectCrush(obj) {
@@ -1259,7 +1415,6 @@ function objectCrush(obj) {
 	}
 	return crushReducer({}, obj, "");
 }
-
 //#endregion
 //#region src/utils/object/objectInvert.ts
 function objectInvert(obj) {
@@ -1268,13 +1423,11 @@ function objectInvert(obj) {
 	for (const [k, v] of objectEntries(obj)) if (isString(v) || isNumber(v) || isSymbol(v)) result[v] = k;
 	return result;
 }
-
 //#endregion
 //#region src/utils/object/objectKeys.ts
 function objectKeys(value) {
 	return Object.keys(value);
 }
-
 //#endregion
 //#region src/utils/object/objectOmit.ts
 function objectOmit(obj, keys) {
@@ -1287,7 +1440,6 @@ function objectOmit(obj, keys) {
 		return acc;
 	}, result);
 }
-
 //#endregion
 //#region src/utils/object/objectPick.ts
 function objectPick(obj, keys) {
@@ -1299,230 +1451,11 @@ function objectPick(obj, keys) {
 		return acc;
 	}, result);
 }
-
 //#endregion
 //#region src/utils/object/objectValues.ts
 function objectValues(value) {
 	return Object.values(value);
 }
-
-//#endregion
-//#region src/utils/string/stringInitialCase.ts
-const R1$1 = /\S+/g;
-const R2 = /[^a-zA-Z\u00C0-\u017F]/;
-/**
-* 字符串首字母大小写
-* - 包含非西欧字母字符时，不处理
-* - 纯字母且全大写时，不处理
-* - 纯字母且非全大写时，首字母小写，其余保留
-* - 纯字母且非全大写时，首字母大写，其余保留
-*
-* @param input 待处理字符串
-* @param caseType 大小写类型
-* @returns 处理后的字符串
-* @example
-* ```ts
-* stringInitialCase("Hello", "lower"); // "hello"
-* stringInitialCase("hello", "upper"); // "Hello"
-* ```
-*/
-function stringInitialCase(input, caseType) {
-	if (!isString(input, true)) return "";
-	return input.replace(R1$1, (word) => {
-		if (R2.test(word)) return word;
-		if (word === word.toLocaleUpperCase()) return word;
-		if (caseType === "lower" && word[0]) return word[0].toLocaleLowerCase() + word.slice(1);
-		if (caseType === "upper" && word[0]) return word[0].toLocaleUpperCase() + word.slice(1);
-		return word;
-	});
-}
-
-//#endregion
-//#region src/utils/string/stringReplace.ts
-/**
-* 字符串替换
-* - 替换第一个匹配项
-*
-* @param input 待处理字符串
-* @param search 匹配项
-* @param replacement 替换项
-* @returns 替换后的字符串
-* @example
-* ```ts
-* stringReplace("hello world", "world", "context"); // "hello context"
-* ```
-*/
-function stringReplace(input, search, replacement) {
-	if (!isString(input, true)) return "";
-	return input.replace(search, replacement);
-}
-
-//#endregion
-//#region src/utils/string/stringTemplate.ts
-const R1 = /\{\{(.+?)\}\}/g;
-/**
-* 字符串模板替换
-* - 使用对象的属性值替换字符串中的 {{key}} 模板
-*
-* @param input 待处理字符串
-* @param template 模板对象
-* @param regex 模板匹配正则 (默认: `\{\{(.+?)\}\}`)
-* @returns 替换后的字符串
-* @example
-* ```ts
-* stringTemplate("Hello {{name}}", { name: "World" }); // "Hello World"
-* ```
-*/
-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)) {
-		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);
-}
-
-//#endregion
-//#region src/utils/string/stringToJson.ts
-/**
-* 处理 JSON 字符串
-*
-* @param input 待处理字符串
-* @param safeValue 安全值 (当解析失败或输入无效时返回)
-* @returns 解析后的对象 或 安全值
-* @example
-* ```ts
-* stringToJson('{"a": 1}', {}); // { a: 1 }
-* stringToJson('invalid', {}); // {}
-* ```
-*/
-function stringToJson(input, safeValue) {
-	if (!isString(input, true)) return safeValue;
-	try {
-		return JSON.parse(input);
-	} catch (error) {
-		return safeValue;
-	}
-}
-
-//#endregion
-//#region src/utils/string/stringToLowerCase.ts
-function stringToLowerCase(input) {
-	if (!isString(input, true)) return "";
-	return input.toLowerCase();
-}
-
-//#endregion
-//#region src/utils/string/stringToPosix.ts
-/**
-* 将路径转换为 POSIX 风格
-* - 统一使用正斜杠 (/)
-* - 可选移除 Windows 盘符 (如 C:)
-* - 可选移除开头的斜杠
-* - 规范化连续斜杠为单个斜杠
-*
-* @param input 待处理字符串
-* @param removeLeadingSlash 是否移除开头斜杠，默认为 `false`。如果移除了盘符，路径通常会以 / 开头，此参数可控制是否保留该 /
-* @returns 转换后的路径，如果输入无效则返回空字符串
-*
-* @example
-* ```ts
-* 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]:([\\/])?/, (_, separator) => {
-		return separator ? "/" : "";
-	});
-	normalized = normalized.replace(/\\/g, "/");
-	normalized = normalized.replace(/\/+/g, "/");
-	if (removeLeadingSlash && normalized.startsWith("/")) normalized = normalized.substring(1);
-	return normalized;
-}
-
-//#endregion
-//#region src/utils/string/stringToUpperCase.ts
-function stringToUpperCase(input) {
-	if (!isString(input, true)) return "";
-	return input.toUpperCase();
-}
-
-//#endregion
-//#region src/utils/string/stringToValues.ts
-function stringToValues(input, valueType = "number", splitSymbol = ",") {
-	if (!isString(input, true)) return [];
-	try {
-		const values = input.split(splitSymbol);
-		if (valueType === "number") return values.map((d) => Number(d));
-		return values;
-	} catch (error) {
-		return [];
-	}
-}
-
-//#endregion
-//#region src/utils/string/stringTrim.ts
-/**
-* 从字符串中裁切掉所有的前缀和后缀字符
-*
-* @param input 待处理字符串
-* @param charsToTrim 裁切字符，默认为 `" "`
-* @returns 裁切后的字符串
-* @example
-* ```ts
-* stringTrim("  hello  "); // "hello"
-* stringTrim("__hello__", "_"); // "hello"
-* ```
-*/
-function stringTrim(input, charsToTrim = " ") {
-	if (!isString(input, true)) return "";
-	const toTrim = charsToTrim.replace(/[\W]{1}/g, "\\$&");
-	const regex = new RegExp(`^[${toTrim}]+|[${toTrim}]+$`, "g");
-	return input.replace(regex, "");
-}
-
-//#endregion
-//#region src/utils/string/stringTruncate.ts
-/**
-* 截取字符串
-* - 支持自定义省略符，不会截断在汉字中间（因为JS字符串本身按字符处理）
-*
-* @param input 待处理字符串
-* @param maxLength 最大长度 (包含省略符)
-* @param ellipsis 省略符，默认为 `...`
-* @returns 截取后的字符串
-* @example
-* ```ts
-* stringTruncate("hello world", 8); // "hello..."
-* ```
-*/
-function stringTruncate(input, maxLength, ellipsis = "...") {
-	if (!isString(input, true)) return "";
-	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
 //#region src/utils/time/timeZone.ts
 /**
@@ -1541,7 +1474,6 @@ function getTimeZone() {
 		timeZone: Intl.DateTimeFormat().resolvedOptions().timeZone
 	};
 }
-
 //#endregion
 //#region src/utils/tree/types.ts
 function getFinalChildrenKey(tree, meta, options) {
@@ -1551,7 +1483,6 @@ function getFinalChildrenKey(tree, meta, options) {
 	}
 	return options.childrenKey;
 }
-
 //#endregion
 //#region src/utils/tree/treeFilter.ts
 function preImpl$3(row, callback, options) {
@@ -1610,8 +1541,8 @@ function breadthImpl$3(row, callback, options) {
 				parents: [...queueOptions.parents, queueRow],
 				depth: queueOptions.depth + 1
 			};
-			const subQueueItems = children.map((queueRow$1) => ({
-				queueRow: queueRow$1,
+			const subQueueItems = children.map((queueRow) => ({
+				queueRow,
 				queueOptions: nextLevelOptions
 			}));
 			queue.push(...subQueueItems);
@@ -1658,7 +1589,6 @@ function treeFilter(tree, callback, options = {}) {
 	};
 	return isArray(tree) ? tree.map((row) => traversalMethod(row, callback, innerOptions)).filter((t) => !!t) : traversalMethod(tree, callback, innerOptions) || [];
 }
-
 //#endregion
 //#region src/utils/tree/treeFind.ts
 const strategies$2 = {
@@ -1705,8 +1635,8 @@ function breadthImpl$2(row, callback, options) {
 				parents: [...queueOptions.parents, queueRow],
 				depth: queueOptions.depth + 1
 			};
-			const subQueueItems = children.map((queueRow$1) => ({
-				queueRow: queueRow$1,
+			const subQueueItems = children.map((queueRow) => ({
+				queueRow,
 				queueOptions: nextLevelOptions
 			}));
 			queue.push(...subQueueItems);
@@ -1748,7 +1678,6 @@ function treeFind(tree, callback, options = {}) {
 	}
 	return traversalMethod(tree, callback, innerOptions);
 }
-
 //#endregion
 //#region src/utils/tree/treeForEach.ts
 const strategies$1 = {
@@ -1795,8 +1724,8 @@ function breadthImpl$1(row, callback, options) {
 				parents: [...queueOptions.parents, queueRow],
 				depth: queueOptions.depth + 1
 			};
-			const subQueueItems = children.map((queueRow$1) => ({
-				queueRow: queueRow$1,
+			const subQueueItems = children.map((queueRow) => ({
+				queueRow,
 				queueOptions: nextLevelOptions
 			}));
 			queue.push(...subQueueItems);
@@ -1832,7 +1761,6 @@ function treeForEach(tree, callback, options = {}) {
 	if (isArray(tree)) for (const row of tree) traversalMethod(row, callback, innerOptions);
 	else traversalMethod(tree, callback, innerOptions);
 }
-
 //#endregion
 //#region src/utils/tree/treeMap.ts
 const strategies = {
@@ -1894,8 +1822,8 @@ function breadthImpl(row, callback, options) {
 				parents: [...queueOptions.parents, queueRow],
 				depth: queueOptions.depth + 1
 			};
-			const subQueueItems = children.map((queueRow$1) => ({
-				queueRow: queueRow$1,
+			const subQueueItems = children.map((queueRow) => ({
+				queueRow,
 				queueOptions: nextLevelOptions
 			}));
 			queue.push(...subQueueItems);
@@ -1926,7 +1854,6 @@ function treeMap(tree, callback, options = {}) {
 	};
 	return isArray(tree) ? tree.map((row) => traversalMethod(row, callback, innerOptions)) : traversalMethod(tree, callback, innerOptions);
 }
-
 //#endregion
 //#region src/utils/tree/rowsToTree.ts
 /**
@@ -1971,7 +1898,6 @@ function rowsToTree(rows, options) {
 	}
 	return result;
 }
-
 //#endregion
 //#region src/utils/tree/treeToRows.ts
 /**
@@ -1998,7 +1924,7 @@ function treeToRows(tree, options = {}) {
 	}), options);
 	return result;
 }
-
 //#endregion
-export { arrayIntersection as $, numberWithin as A, isIframe as At, isIOSMobile as B, isAsyncGeneratorFunction as Bt, objectCrush as C, isNegativeInteger as Ct, enumValues as D, isMap as Dt, objectEntries as E, isNull as Et, clone as F, isEqual as Ft, arrayUnzip as G, isFile as Gt, isBrowser as H, isGeneratorFunction as Ht, cloneDeep as I, isEnumeration as It, arrayReplaceMove as J, isTypedArray as Jt, arrayZip as K, isBigInt as Kt, cloneDeepWith as L, isDate as Lt, mathToDecimal as M, isFalsy as Mt, mathToBignumber as N, isFalsyLike as Nt, enumKeys as O, isWeakMap as Ot, stringToNumber as P, isError as Pt, arrayLast as Q, to as R, isClass as Rt, objectInvert as S, isNaN as St, objectMapEntries as T, isPositiveInteger as Tt, isWebWorker as U, isBoolean as Ut, isMobile as V, isFunction as Vt, arrayZipToObject as W, isBlob as Wt, arrayPick as X, arrayReplace as Y, isAbortSignal as Yt, arrayMerge as Z, stringInitialCase as _, isPromiseLike as _t, treeFind as a, arrayCast as at, objectOmit as b, isInfinityLike as bt, stringTruncate as c, isURLSearchParams as ct, stringToUpperCase as d, isSet as dt, arrayFork as et, stringToPosix as f, isWeakSet as ft, stringReplace as g, isPromise as gt, stringTemplate as h, isReadableStream as ht, treeForEach as i, arrayCompete as it, mathToEvaluate as j, isInIframe as jt, enumEntries as k, isIterable as kt, stringTrim as l, isUndefined as lt, stringToJson as m, isString as mt, rowsToTree as n, arrayDifference as nt, treeFilter as o, isWindow as ot, stringToLowerCase as p, isRegExp as pt, arraySplit as q, isArray as qt, treeMap as r, arrayCounting as rt, getTimeZone as s, isWebSocket as st, treeToRows as t, arrayFirst as tt, stringToValues as u, isSymbol as ut, objectValues as v, isObject as vt, objectAssign as w, isNumber as wt, objectKeys as x, isInteger as xt, objectPick as y, isInfinity as yt, isTablet as z, isAsyncFunction as zt };
-//# sourceMappingURL=utils-_dtCs-qa.js.map
+export { arrayDifference as $, stringToLowerCase as A, isFalsyLike as At, isWebWorker as B, isBoolean as Bt, mathToBignumber as C, isNull as Ct, stringToUpperCase as D, isIframe as Dt, stringToValues as E, isIterable as Et, to as F, isClass as Ft, arrayReplaceMove as G, isTypedArray as Gt, arrayUnzip as H, isFile as Ht, isIOSMobile as I, isAsyncFunction as It, arrayMerge as J, arrayReplace as K, isAbortSignal as Kt, isMobile as L, isAsyncGeneratorFunction as Lt, stringTemplate as M, isEqual as Mt, stringReplace as N, isEnumeration as Nt, stringToPosix as O, isInIframe as Ot, stringInitialCase as P, isDate as Pt, arrayFirst as Q, isTablet as R, isFunction as Rt, mathToDecimal as S, isPositiveInteger as St, stringTrim as T, isWeakMap as Tt, arrayZip as U, isBigInt as Ut, arrayZipToObject as V, isBlob as Vt, arraySplit as W, isArray as Wt, arrayIntersection as X, arrayLast as Y, arrayFork as Z, enumValues as _, isInfinityLike as _t, treeFind as a, isURLSearchParams as at, numberWithin as b, isNegativeInteger as bt, objectValues as c, isString as ct, objectKeys as d, isRegExp as dt, arrayCounting as et, objectInvert as f, isReadableStream as ft, objectEntries as g, isInfinity as gt, objectMapEntries as h, isObject as ht, treeForEach as i, isWebSocket as it, stringToJson as j, isError as jt, stringToNumber as k, isFalsy as kt, objectPick as l, isSet as lt, objectAssign as m, isPromiseLike as mt, rowsToTree as n, arrayCast as nt, treeFilter as o, isUndefined as ot, objectCrush as p, isPromise as pt, arrayPick as q, treeMap as r, isWindow as rt, getTimeZone as s, isSymbol as st, treeToRows as t, arrayCompete as tt, objectOmit as u, isWeakSet as ut, enumKeys as v, isInteger as vt, stringTruncate as w, isMap as wt, mathToEvaluate as x, isNumber as xt, enumEntries as y, isNaN as yt, isBrowser as z, isGeneratorFunction as zt };
+
+//# sourceMappingURL=utils-DvWLCdYR.js.map