@pawover/kit 0.4.0 → 0.4.2

package/packages/utils/dist/index.js

@@ -1,4 +1,4 @@
-import { n as TypeUtil, t as StringUtil } from "./stringUtil-voQaLOJj.js";
+import { n as StringUtil, r as TypeUtil, t as MathUtil } from "./math-B5PyWuKn.js";
 //#region src/array/arrayUtil.ts
 /**
 * 数组工具类
@@ -236,6 +236,145 @@ var ArrayUtil = class {
 	}
 };
 //#endregion
+//#region src/currency/currencyUtil.ts
+/**
+* 货币工具类
+* - 基于 [`Intl.NumberFormat`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat) 进行本地化格式化
+* - 支持精确小数位处理（依赖 `mathjs`）
+*/
+var CurrencyUtil = class {
+	/**
+	* 货币代码到 Locale 的映射枚举
+	* - 键为 ISO 4217 货币代码，值为 BCP 47 语言标签
+	* - 用于 `Intl.NumberFormat` 的本地化数字格式化
+	* - 格式示例基于 `Intl.NumberFormat` 对 `1,234,567.89` 的输出
+	*
+	* @example
+	* ```ts
+	* import { CurrencyUtil } from "@pawover/kit/utils";
+	* // 获取人民币的格式化 locale
+	* const locale = CurrencyUtil.CURRENCY_ENUM.CNY; // "zh-CN"
+	*
+	* // 结合 Intl.NumberFormat 使用
+	* new Intl.NumberFormat(CurrencyUtil.CURRENCY_ENUM.USD, {
+	*   style: "currency",
+	*   currency: "USD",
+	* }).format(1234.56); // "$1,234.56"
+	* ```
+	*/
+	static CURRENCY_ENUM = {
+		/** 美元（美国及美元化国家，Locale: 美式英语） → 1,234,567.89 */
+		USD: "en-US",
+		/** 加拿大元（加拿大，Locale: 加拿大英语） → 1,234,567.89 */
+		CAD: "en-CA",
+		/** 墨西哥比索（墨西哥，Locale: 墨西哥西班牙语） → 1,234,567.89 */
+		MXN: "es-MX",
+		/** 巴西雷亚尔（巴西，Locale: 巴西葡萄牙语） → 1.234.567,89 */
+		BRL: "pt-BR",
+		/** 阿根廷比索（阿根廷，Locale: 阿根廷西班牙语） → 1.234.567,89 */
+		ARS: "es-AR",
+		/** 智利比索（智利，Locale: 智利西班牙语） → 1.234.567,89 */
+		CLP: "es-CL",
+		/** 秘鲁新索尔（秘鲁，Locale: 秘鲁西班牙语） → 1,234,567.89 */
+		PEN: "es-PE",
+		/** 哥伦比亚比索（哥伦比亚，Locale: 哥伦比亚西班牙语） → 1.234.567,89 */
+		COP: "es-CO",
+		/** 哥斯达黎加科朗（哥斯达黎加，Locale: 哥斯达黎加西班牙语） → 1 234 567,89（空格千分位） */
+		CRC: "es-CR",
+		/** 人民币（中国，Locale: 简体中文） → 1,234,567.89 */
+		CNY: "zh-CN",
+		/** 港元（中国香港，Locale: 繁体中文+香港） → 1,234,567.89 */
+		HKD: "zh-HK",
+		/** 澳门元（中国澳门，Locale: 繁体中文+澳门） → 1,234,567.89 */
+		MOP: "zh-MO",
+		/** 日元（日本，Locale: 日语） → 1,234,567.89 */
+		JPY: "ja-JP",
+		/** 韩元（韩国，Locale: 韩语） → 1,234,567.89 */
+		KRW: "ko-KR",
+		/** 新加坡元（新加坡，Locale: 英语+新加坡） → 1,234,567.89 */
+		SGD: "en-SG",
+		/** 泰铢（泰国，Locale: 泰语） → 1,234,567.89 */
+		THB: "th-TH",
+		/** 印度卢比（印度，Locale: 英语+印度） → 12,34,567.89（2,2,3 分组） */
+		INR: "en-IN",
+		/** 沙特里亚尔（沙特，Locale: 阿拉伯语+沙特） → ١٬٢٣٤٬٥٦٧٫٨٩（阿拉伯数字） */
+		SAR: "ar-SA",
+		/** 阿联酋迪拉姆（阿联酋，Locale: 阿拉伯语+阿联酋） → 1,234,567.89 */
+		AED: "ar-AE",
+		/** 印尼盾（印尼，Locale: 印尼语） → 1.234.567,89 */
+		IDR: "id-ID",
+		/** 马来西亚林吉特（马来西亚，Locale: 马来语） → 1,234,567.89 */
+		MYR: "ms-MY",
+		/** 越南盾（越南，Locale: 越南语） → 1.234.567,89 */
+		VND: "vi-VN",
+		/** 菲律宾比索（菲律宾，Locale: 英语+菲律宾） → 1,234,567.89 */
+		PHP: "en-PH",
+		/** 巴基斯坦卢比（巴基斯坦，Locale: 英语+巴基斯坦） → 1,234,567.89 */
+		PKR: "en-PK",
+		/** 新台币（中国台湾地区，Locale: 繁体中文+台湾） → 1,234,567.89 */
+		TWD: "zh-TW",
+		/** 欧元（德国，Locale: 德语+德国，代表欧元区） → 1.234.567,89 */
+		EUR: "de-DE",
+		/** 英镑（英国，Locale: 英式英语） → 1,234,567.89 */
+		GBP: "en-GB",
+		/** 瑞士法郎（瑞士，Locale: 德语+瑞士） → 1'234'567.89 */
+		CHF: "de-CH",
+		/** 瑞典克朗（瑞典，Locale: 瑞典语） → 1 234 567,89（空格千分位） */
+		SEK: "sv-SE",
+		/** 挪威克朗（挪威，Locale: 挪威语） → 1 234 567,89（空格千分位） */
+		NOK: "no-NO",
+		/** 丹麦克朗（丹麦，Locale: 丹麦语） → 1.234.567,89 */
+		DKK: "da-DK",
+		/** 波兰兹罗提（波兰，Locale: 波兰语） → 1 234 567,89（空格千分位） */
+		PLN: "pl-PL",
+		/** 捷克克朗（捷克，Locale: 捷克语） → 1 234 567,89（空格千分位） */
+		CZK: "cs-CZ",
+		/** 匈牙利福林（匈牙利，Locale: 匈牙利语） → 1 234 567,89（空格千分位） */
+		HUF: "hu-HU",
+		/** 俄罗斯卢布（俄罗斯，Locale: 俄语） → 1 234 567,89（空格千分位） */
+		RUB: "ru-RU",
+		/** 罗马尼亚列伊（罗马尼亚，Locale: 罗马尼亚语） → 1.234.567,89 */
+		RON: "ro-RO",
+		/** 乌克兰格里夫纳（乌克兰，Locale: 乌克兰语） → 1 234 567,89（空格千分位） */
+		UAH: "uk-UA",
+		/** 澳大利亚元（澳大利亚，Locale: 澳大利亚英语） → 1,234,567.89 */
+		AUD: "en-AU",
+		/** 新西兰元（新西兰，Locale: 新西兰英语） → 1,234,567.89 */
+		NZD: "en-NZ",
+		/** 南非兰特（南非，Locale: 英语+南非） → 1 234 567,89（空格千分位） */
+		ZAR: "en-ZA",
+		/** 埃及镑（埃及，Locale: 阿拉伯语+埃及） → ١٬٢٣٤٬٥٦٧٫٨٩（阿拉伯数字） */
+		EGP: "ar-EG",
+		/** 土耳其里拉（土耳其，Locale: 土耳其语） → 1.234.567,89 */
+		TRY: "tr-TR",
+		/** 以色列新谢克尔（以色列，Locale: 希伯来语） → 1,234,567.89 */
+		ILS: "he-IL",
+		/** 摩洛哥迪拉姆（摩洛哥，Locale: 阿拉伯语+摩洛哥） → 1.234.567,89 */
+		MAD: "ar-MA",
+		/** 科威特第纳尔（科威特，Locale: 阿拉伯语+科威特） → ١٬٢٣٤٬٥٦٧٫٨٩（阿拉伯数字） */
+		KWD: "ar-KW",
+		/** 卡塔尔里亚尔（卡塔尔，Locale: 阿拉伯语+卡塔尔） → ١٬٢٣٤٬٥٦٧٫٨٩（阿拉伯数字） */
+		QAR: "ar-QA",
+		/** 尼日利亚奈拉（尼日利亚，Locale: 英语+尼日利亚） → 1,234,567.89 */
+		NGN: "en-NG",
+		/** 太平洋法郎（法属波利尼西亚，Locale: 法语+太平洋） → 1[U+202F]234[U+202F]567,89（窄空格千分位） */
+		XPF: "fr-PF"
+	};
+	static currencyFormatter(value, options) {
+		if (TypeUtil.isNull(value) || TypeUtil.isUndefined(value)) return null;
+		const { currencySign, currencySignPosition, locales, currencyFormatOptions } = options;
+		let formatedValue = Number(value).toLocaleString(locales, currencyFormatOptions).replace(currencySign, "").trim();
+		if (currencySignPosition === "start") formatedValue = `${currencySign} ${formatedValue}`;
+		if (currencySignPosition === "end") formatedValue = `${formatedValue} ${currencySign}`;
+		return formatedValue;
+	}
+	static toRealValue(mathJsInstance, value, precision, stringMode) {
+		if (TypeUtil.isNull(value) || TypeUtil.isUndefined(value)) return null;
+		const precisionValue = MathUtil.toDecimal(mathJsInstance, value, precision);
+		return stringMode ? precisionValue : Number(precisionValue);
+	}
+};
+//#endregion
 //#region src/dateTime/dateTimeUtil.ts
 /**
 * 日期工具类
@@ -2058,4 +2197,4 @@ var ValidateUtil = class {
 	}
 };
 //#endregion
-export { ArrayUtil, DateTimeUtil, EnvUtil, FunctionUtil, MimeUtil, NumberUtil, ObjectUtil, StringUtil, ThemeUtil, TreeUtil, TypeUtil, ValidateUtil };
+export { ArrayUtil, CurrencyUtil, DateTimeUtil, EnvUtil, FunctionUtil, MimeUtil, NumberUtil, ObjectUtil, StringUtil, ThemeUtil, TreeUtil, TypeUtil, ValidateUtil };

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

@@ -260,6 +260,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
@@ -938,4 +951,58 @@ var StringUtil = class {
 	}
 };
 //#endregion
-export { TypeUtil as n, StringUtil as t };
+//#region src/math/mathUtil.ts
+/**
+* 数学工具类
+* - 基于 [`mathjs`](https://mathjs.org)
+*/
+var MathUtil = class MathUtil {
+	/**
+	* 将任意类型的值转换为 `math.bignumber`
+	*
+	* @param mathJsInstance mathJs 实例
+	* @param value 任意类型的值
+	* @param fallback 回退值
+	* @returns 转换后的 BigNumber
+	* @example
+	* ```ts
+	* import { create, all } from "mathjs";
+	* const math = create(all);
+	* MathUtil.toBignumber(math, "0.1");
+	* ```
+	*/
+	static toBignumber(mathJsInstance, value, fallback) {
+		const errorValue = fallback ?? mathJsInstance.bignumber(0);
+		if (TypeUtil.isFalsyLike(value) || TypeUtil.isInfinityLike(value)) return errorValue;
+		try {
+			return mathJsInstance.bignumber(StringUtil.toNumber(`${value}`));
+		} catch (error) {
+			return errorValue;
+		}
+	}
+	static toDecimal(mathJsInstance, value, precision, isFormat = true) {
+		const bigNumber = MathUtil.toBignumber(mathJsInstance, value);
+		return isFormat ? mathJsInstance.format(bigNumber, {
+			notation: "fixed",
+			precision
+		}) : bigNumber;
+	}
+	/**
+	* 数学表达式求值
+	*
+	* @param mathJsInstance mathJs 实例
+	* @param expr 表达式
+	* @param scope 键值映射
+	* @returns 计算结果的字符串表示
+	* @example
+	* ```ts
+	* MathUtil.toEvaluate(math, "a + b", { a: 1, b: 2 }); // "3"
+	* ```
+	*/
+	static toEvaluate(mathJsInstance, expr, scope) {
+		const evaluateValue = `${mathJsInstance.evaluate(expr, scope || {})}`;
+		return mathJsInstance.format(MathUtil.toBignumber(mathJsInstance, evaluateValue), { notation: "fixed" });
+	}
+};
+//#endregion
+export { StringUtil as n, TypeUtil as r, MathUtil as t };

package/packages/utils/dist/math.js

@@ -1,56 +1,2 @@
-import { n as TypeUtil, t as StringUtil } from "./stringUtil-voQaLOJj.js";
-//#region src/math/mathUtil.ts
-/**
-* 数学工具类
-* - 基于 [`mathjs`](https://mathjs.org)
-*/
-var MathUtil = class MathUtil {
-	/**
-	* 将任意类型的值转换为 `math.bignumber`
-	*
-	* @param mathJsInstance mathJs 实例
-	* @param value 任意类型的值
-	* @param fallback 回退值
-	* @returns 转换后的 BigNumber
-	* @example
-	* ```ts
-	* import { create, all } from "mathjs";
-	* const math = create(all);
-	* MathUtil.toBignumber(math, "0.1");
-	* ```
-	*/
-	static toBignumber(mathJsInstance, value, fallback) {
-		const errorValue = fallback ?? mathJsInstance.bignumber(0);
-		if (TypeUtil.isFalsyLike(value) || TypeUtil.isInfinityLike(value)) return errorValue;
-		try {
-			return mathJsInstance.bignumber(StringUtil.toNumber(`${value}`));
-		} catch (error) {
-			return errorValue;
-		}
-	}
-	static toDecimal(mathJsInstance, value, precision, isFormat = true) {
-		const bigNumber = MathUtil.toBignumber(mathJsInstance, value);
-		return isFormat ? mathJsInstance.format(bigNumber, {
-			notation: "fixed",
-			precision
-		}) : bigNumber;
-	}
-	/**
-	* 数学表达式求值
-	*
-	* @param mathJsInstance mathJs 实例
-	* @param expr 表达式
-	* @param scope 键值映射
-	* @returns 计算结果的字符串表示
-	* @example
-	* ```ts
-	* MathUtil.toEvaluate(math, "a + b", { a: 1, b: 2 }); // "3"
-	* ```
-	*/
-	static toEvaluate(mathJsInstance, expr, scope) {
-		const evaluateValue = `${mathJsInstance.evaluate(expr, scope || {})}`;
-		return mathJsInstance.format(MathUtil.toBignumber(mathJsInstance, evaluateValue), { notation: "fixed" });
-	}
-};
-//#endregion
+import { t as MathUtil } from "./math-B5PyWuKn.js";
 export { MathUtil };

package/packages/utils/dist/metadata.json

@@ -1,5 +1,6 @@
 [
   "ArrayUtil",
+  "CurrencyUtil",
   "DateTimeUtil",
   "EnvUtil",
   "FunctionUtil",

package/packages/utils/dist/vite.js

@@ -24,7 +24,7 @@ var ViteUtil = class {
 	static toProxy(proxyList, options) {
 		const httpsRE = /^https:\/\//;
 		const result = {};
-		if (typeof proxyList === "object") for (const [prefix, target] of proxyList) result[prefix] = {
+		if (Array.isArray(proxyList)) for (const [prefix, target] of proxyList) result[prefix] = {
 			target,
 			changeOrigin: true,
 			ws: true,