@pawover/kit 0.0.0-beta.1 → 0.0.0-beta.3

package/dist/index.js

@@ -99,8 +99,8 @@ function isClass(value) {
 * 判断是否为对象类型
 * - 可选是否检查原型为 `Object.prototype`，防止原型链污染
 *
-* @param value - 待检查值
-* @param prototypeCheck - 是否进行原型检查，默认 `true`
+* @param value 待检查值
+* @param prototypeCheck 是否进行原型检查，默认 `true`
 */
 function isObject(value, prototypeCheck = true) {
 	const check = resolvePrototypeString(value) === PROTOTYPE_TAGS.object;
@@ -206,8 +206,8 @@ function isNull(value) {
 /**
 * 检查 value 是否为 number 类型
 *
-* @param value - 待检查值
-* @param checkNaN - 是否排除 `NaN`，默认为 `true`
+* @param value 待检查值
+* @param checkNaN 是否排除 `NaN`，默认为 `true`
 */
 function isNumber(value, checkNaN = true) {
 	return typeof value === "number" && (!checkNaN || !isNaN(value));
@@ -215,7 +215,7 @@ function isNumber(value, checkNaN = true) {
 /**
 * 检查 value 是否为 NaN
 *
-* @param value - 待检查值
+* @param value 待检查值
 */
 function isNaN(value) {
 	return Number.isNaN(value);
@@ -223,8 +223,8 @@ function isNaN(value) {
 /**
 * 检查 value 是否为整数
 *
-* @param value - 待检查值
-* @param safeCheck - 是否附加安全数检查
+* @param value 待检查值
+* @param safeCheck 是否附加安全数检查
 */
 function isInteger(value, safeCheck = true) {
 	const check = Number.isInteger(value);
@@ -234,8 +234,8 @@ function isInteger(value, safeCheck = true) {
 * 检查 value 是否为正整数
 * - 此函数中 `0` 不被视为正整数
 *
-* @param value - 待检查值
-* @param safeCheck - 是否附加安全数检查
+* @param value 待检查值
+* @param safeCheck 是否附加安全数检查
 */
 function isPositiveInteger(value, safeCheck = true) {
 	return isInteger(value, safeCheck) && value > 0;
@@ -244,8 +244,8 @@ function isPositiveInteger(value, safeCheck = true) {
 * 检查 value 是否为负整数
 * - 此函数中 `0` 不被视为负整数
 *
-* @param value - 待检查值
-* @param safeCheck - 是否附加安全数检查
+* @param value 待检查值
+* @param safeCheck 是否附加安全数检查
 */
 function isNegativeInteger(value, safeCheck = true) {
 	return isInteger(value, safeCheck) && value < 0;
@@ -254,7 +254,7 @@ function isNegativeInteger(value, safeCheck = true) {
 * 检查 value 是否为 Infinity
 * - 排除 `NaN`
 *
-* @param value - 待检查值
+* @param value 待检查值
 */
 function isInfinity(value) {
 	return isNumber(value) && (Number.POSITIVE_INFINITY === value || Number.NEGATIVE_INFINITY === value);
@@ -263,7 +263,7 @@ function isInfinity(value) {
 * 检查 value 是否类似 Infinity
 * - 排除 `NaN`
 *
-* @param value - 待检查值
+* @param value 待检查值
 */
 function isInfinityLike(value) {
 	const check = isInfinity(value);
@@ -323,8 +323,14 @@ function isWeakSet(value) {
 
 //#endregion
 //#region src/utils/typeof/isString.ts
-function isString(value) {
-	return typeof value === "string";
+/**
+* 检查 value 是否为 string 类型
+*
+* @param value 待检查值
+* @param checkEmpty 是否排除空字符串
+*/
+function isString(value, checkEmpty = false) {
+	return typeof value === "string" && (!checkEmpty || !!value.length);
 }
 
 //#endregion
@@ -567,7 +573,7 @@ function arraySplit(initialList, size = 10) {
 //#region src/utils/function/to.ts
 /**
 * @param promise
-* @param errorExt - 可以传递给err对象的其他信息
+* @param errorExt 可以传递给err对象的其他信息
 */
 function to(promise, errorExt) {
 	return promise.then((data) => [null, data]).catch((err) => {
@@ -588,7 +594,7 @@ const R1$1 = /[^0-9.-]/g;
 * @param input 待处理字符串
 */
 function stringToNumber(input) {
-	if (!isString(input) || !input.length) return "";
+	if (!isString(input, true)) return "";
 	const cleaned = input.replace(R1$1, "");
 	let isDecimal = false;
 	let signCount = 0;
@@ -887,7 +893,7 @@ const R2 = /[^a-zA-Z\u00C0-\u017F]/;
 * @param caseType 大小写类型
 */
 function stringInitialCase(input, caseType) {
-	if (!isString(input) || !input.length) return "";
+	if (!isString(input, true)) return "";
 	return input.replace(R1, (word) => {
 		if (R2.test(word)) return word;
 		if (word === word.toLocaleUpperCase()) return word;
@@ -908,7 +914,7 @@ function stringInitialCase(input, caseType) {
 * @param replacement 替换项
 */
 function stringReplace(input, search, replacement) {
-	if (!isString(input) || !input.length) return "";
+	if (!isString(input, true)) return "";
 	return input.replace(search, replacement);
 }
 
@@ -922,7 +928,7 @@ function stringReplace(input, search, replacement) {
 * @param regex 模板匹配正则
 */
 function stringTemplate(input, template, regex = /\{\{(.+?)\}\}/g) {
-	if (!isString(input) || !input.length) return "";
+	if (!isString(input, true)) return "";
 	let result = "";
 	let from = 0;
 	let match;
@@ -942,7 +948,7 @@ function stringTemplate(input, template, regex = /\{\{(.+?)\}\}/g) {
 * @param safeValue 安全值
 */
 function stringToJson(input, safeValue) {
-	if (!isString(input) || !input.length) return safeValue;
+	if (!isString(input, true)) return safeValue;
 	try {
 		return JSON.parse(input);
 	} catch (error) {
@@ -950,10 +956,27 @@ function stringToJson(input, safeValue) {
 	}
 }
 
+//#endregion
+//#region src/utils/string/stringToPosix.ts
+/**
+* 将路径转换为 POSIX 风格
+*
+* @param input 待处理字符串
+* @param removeLeadingSlash 是否移除开头斜杠，默认为 `false`
+*/
+function stringToPosix(input, removeLeadingSlash = false) {
+	if (!isString(input, true)) return "";
+	let normalized = input.replace(/^[A-Za-z]:[\\/]?/, "").replace(/^[\\/]+/, "");
+	normalized = normalized.replace(/\\/g, "/");
+	normalized = normalized.replace(/\/+/g, "/");
+	if (removeLeadingSlash && normalized.startsWith("/")) normalized = normalized.substring(1);
+	return normalized;
+}
+
 //#endregion
 //#region src/utils/string/stringToValues.ts
 function stringToValues(input, valueType = "number", splitSymbol = ",") {
-	if (!isString(input) || !input.length) return [];
+	if (!isString(input, true)) return [];
 	try {
 		const values = input.split(splitSymbol);
 		if (valueType === "number") return values.map((d) => Number(d));
@@ -963,6 +986,39 @@ function stringToValues(input, valueType = "number", splitSymbol = ",") {
 	}
 }
 
+//#endregion
+//#region src/utils/string/stringTrim.ts
+/**
+* 从字符串中裁切掉所有的前缀和后缀字符
+*
+* @param input 待处理字符串
+* @param charsToTrim 裁切字符，默认为 `" "`
+*/
+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
+/**
+* 截取字符串
+* - 支持中英文混排，不会在汉字中间截断
+*
+* @param input 待处理字符串
+* @param maxLength 最大长度
+* @param ellipsis 省略符，默认为 `...`
+*/
+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 : "";
+}
+
 //#endregion
 //#region src/utils/tree/types.ts
 function getFinalChildrenKey(tree, meta, options) {
@@ -1371,5 +1427,5 @@ function treeToRows(tree, options = {}) {
 }
 
 //#endregion
-export { arrayCast, arrayCompete, arrayCounting, arrayDifference, arrayFirst, arrayFork, arrayIntersection, arrayLast, arrayMerge, arrayPick, arrayReplace, arraySplit, cloneDeep, enumEntries, enumKeys, enumTypeCheck, enumValues, isAbortSignal, isArray, isAsyncFunction, isAsyncGeneratorFunction, isBigInt, isBlob, isBoolean, isClass, isDate, isEqual, isError, isFalsy, isFalsyLike, isFile, isFunction, isGeneratorFunction, isInfinity, isInfinityLike, isInteger, isIterable, isMap, isNaN, isNegativeInteger, isNull, isNumber, isObject, isPositiveInteger, isPromise, isPromiseLike, isReadableStream, isRegExp, isSet, isString, isSymbol, isTypedArray, isURLSearchParams, isUndefined, isWeakMap, isWeakSet, isWebSocket, isWindow, mapEntries, objectAssign, objectCrush, objectEntries, objectKeys, objectPick, objectSwitch, objectValues, rowsToTree, stringInitialCase, stringReplace, stringTemplate, stringToJson, stringToNumber, stringToValues, to, toMathBignumber, toMathDecimal, toMathEvaluate, treeFilter, treeFind, treeForEach, treeMap, treeToRows };
+export { arrayCast, arrayCompete, arrayCounting, arrayDifference, arrayFirst, arrayFork, arrayIntersection, arrayLast, arrayMerge, arrayPick, arrayReplace, arraySplit, cloneDeep, enumEntries, enumKeys, enumTypeCheck, enumValues, isAbortSignal, isArray, isAsyncFunction, isAsyncGeneratorFunction, isBigInt, isBlob, isBoolean, isClass, isDate, isEqual, isError, isFalsy, isFalsyLike, isFile, isFunction, isGeneratorFunction, isInfinity, isInfinityLike, isInteger, isIterable, isMap, isNaN, isNegativeInteger, isNull, isNumber, isObject, isPositiveInteger, isPromise, isPromiseLike, isReadableStream, isRegExp, isSet, isString, isSymbol, isTypedArray, isURLSearchParams, isUndefined, isWeakMap, isWeakSet, isWebSocket, isWindow, mapEntries, objectAssign, objectCrush, objectEntries, objectKeys, objectPick, objectSwitch, objectValues, rowsToTree, stringInitialCase, stringReplace, stringTemplate, stringToJson, stringToNumber, stringToPosix, stringToValues, stringTrim, stringTruncate, to, toMathBignumber, toMathDecimal, toMathEvaluate, treeFilter, treeFind, treeForEach, treeMap, treeToRows };
 //# sourceMappingURL=index.js.map