@planarcat/js-toolkit 1.7.11 → 1.7.22

package/README.md

@@ -73,6 +73,7 @@ debouncedFn();
 import {
   toFormattedNumber,
   toFormattedNumberString,
+  DecimalPlacesOptions,
 } from '@planarcat/js-toolkit';
 
 // 基本使用
@@ -83,6 +84,14 @@ console.log(toFormattedNumber(1234.5678));
 console.log(toFormattedNumber(1234.5678, { decimalPlaces: 2 }));
 // 输出: 1234.57
 
+// 使用 RETAIN_ALL 常量保留所有小数位
+console.log(
+  toFormattedNumber(1234.5678, {
+    decimalPlaces: DecimalPlacesOptions.RETAIN_ALL,
+  }),
+);
+// 输出: 1234.5678
+
 // 处理字符串
 console.log(toFormattedNumber('123.45abc'));
 // 输出: 123.45
@@ -104,6 +113,14 @@ console.log(
 console.log(toFormattedNumberString(1234.5678, { decimalPlaces: 2 }));
 // 输出: "1234.57"
 
+// 使用 RETAIN_ALL 常量保留所有小数位
+console.log(
+  toFormattedNumberString(1234.5678, {
+    decimalPlaces: DecimalPlacesOptions.RETAIN_ALL,
+  }),
+);
+// 输出: "1234.5678"
+
 // 保留两位小数，不够时补0
 console.log(toFormattedNumberString(123.4, { decimalPlaces: 2 }));
 // 输出: "123.40"
@@ -235,6 +252,35 @@ pnpm test
 pnpm run test:coverage
 ```
 
+### 发布
+
+项目使用 GitHub Actions 和 Trusted Publishing 进行自动发布。
+
+#### 发布流程
+
+1. **更新版本号**：使用 `bump-version.js` 脚本更新版本号
+   ```bash
+   # 可选参数：patch (默认), minor, major, prerelease
+   pnpm run bump:patch
+   ```
+
+2. **推送代码和标签**：
+   ```bash
+   git push && git push --tags
+   ```
+
+3. **自动发布**：GitHub Actions 将自动触发发布流程：
+   - 执行质量检查
+   - 构建项目
+   - 使用 Trusted Publishing 发布到 npm
+   - 创建 GitHub Release
+
+#### 发布配置
+
+- **Trusted Publishing**：通过 OIDC 令牌进行身份验证，无需持久化的 npm 令牌
+- **自动触发**：仅在标签推送时触发发布
+- **安全可靠**：使用 GitHub Actions 安全上下文
+
 ## 贡献
 
 欢迎贡献代码！请遵循以下步骤：
@@ -255,6 +301,17 @@ pnpm run test:coverage
 
 ## 更新日志
 
+### v1.7.13
+
+- ✨ 重构了 `decimalPlaces` 参数类型，使用 `DecimalPlacesOptions` 联合类型
+- ✨ 新增 `DecimalPlacesOptions` 对象，包含 `RETAIN_ALL` 常量用于保留所有小数位
+- ✨ 优化了类型定义，提高了类型安全性
+- ✨ 更新了文档，添加了 `DecimalPlacesOptions` 的使用示例
+
+### v1.7.12
+
+- ✨ 修复了构建错误，解决了合并声明问题
+
 ### v1.7.1
 
 - ✨ 修复了 `formatDate` 函数中 Unix 时间戳计算问题，确保基于 UTC 时间

package/dist/date/formatDateCompiled.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 编译模式日期格式化实现
+ * 首次调用编译格式化字符串，后续调用使用缓存的编译函数
+ */
+import { DateFormatOptions, DateInput } from '../types/date';
+/**
+ * 编译后的格式化函数类型
+ */
+type CompiledFormatter = (date: Date, options: DateFormatOptions) => string;
+/**
+ * 编译格式化字符串，生成优化的格式化函数
+ * @param formatStr - 格式化字符串
+ * @returns 编译后的格式化函数
+ */
+export declare function compileFormat(formatStr: string): CompiledFormatter;
+/**
+ * 清除格式化缓存
+ * @param formatStr - 可选，指定要清除的格式化字符串缓存
+ */
+export declare function clearFormatCache(formatStr?: string): void;
+/**
+ * 编译模式日期格式化
+ * @param input - 要格式化的日期输入
+ * @param formatStr - 格式化字符串
+ * @param options - 格式化选项
+ * @returns 格式化后的日期字符串
+ */
+export declare function formatDateCompiled(input: DateInput, formatStr?: string, options?: Partial<DateFormatOptions>): string;
+export default formatDateCompiled;
+//# sourceMappingURL=formatDateCompiled.d.ts.map

package/dist/date/formatDateCompiled.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatDateCompiled.d.ts","sourceRoot":"","sources":["../../src/date/formatDateCompiled.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAI7D;;GAEG;AACH,KAAK,iBAAiB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,KAAK,MAAM,CAAC;AAO5E;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,CA0FlE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAMzD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAC9B,KAAK,EAAE,SAAS,EAChB,SAAS,GAAE,MAA8B,EACzC,OAAO,GAAE,OAAO,CAAC,iBAAiB,CAAM,GACzC,MAAM,CASR;AAED,eAAe,kBAAkB,CAAC"}

package/dist/date/formatDateCompiled.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDateCompiled = exports.clearFormatCache = exports.compileFormat = void 0;
+const constants_1 = require("../utils/constants");
+const formatDatePlain_1 = require("./formatDatePlain");
+/**
+ * 格式化缓存，用于存储编译后的格式化函数
+ */
+const FORMAT_CACHE = new Map();
+/**
+ * 编译格式化字符串，生成优化的格式化函数
+ * @param formatStr - 格式化字符串
+ * @returns 编译后的格式化函数
+ */
+function compileFormat(formatStr) {
+    // 检查缓存
+    if (FORMAT_CACHE.has(formatStr)) {
+        return FORMAT_CACHE.get(formatStr);
+    }
+    // 生成编译后的函数
+    const compiledFn = (date, options) => {
+        // 获取日期各部分
+        const year = date.getFullYear();
+        const month = date.getMonth() + 1;
+        const day = date.getDate();
+        const hours = date.getHours();
+        const minutes = date.getMinutes();
+        const seconds = date.getSeconds();
+        const milliseconds = date.getMilliseconds();
+        const weekday = date.getDay();
+        const quarter = Math.floor((date.getMonth() + 3) / 3);
+        const weekNumber = (0, formatDatePlain_1.getWeekNumber)(date);
+        // 12小时制
+        const hours12 = hours % 12 || 12;
+        const ampm = hours < 12 ? 'AM' : 'PM';
+        const ampmLower = ampm.toLowerCase();
+        let result = formatStr;
+        // 优先替换 timestamp，避免被拆解
+        if (result.includes('timestamp')) {
+            result = result.replace(/timestamp/g, date.getTime().toString());
+        }
+        // 2. 应用自定义格式化器（优先级最高）
+        if (options.customFormatters) {
+            Object.entries(options.customFormatters).forEach(([token, formatter]) => {
+                const escapedToken = token.replace(/[.*+?^${}()|[\\]/g, '\\$&');
+                const regex = new RegExp(`(?<![a-zA-Z0-9])${escapedToken}(?![a-zA-Z0-9])`, 'g');
+                result = result.replace(regex, formatter(date));
+            });
+        }
+        // 3. 替换多字符标记（2-4个字符）
+        const multiCharReplacements = {
+            YYYY: year.toString().padStart(4, '0'),
+            YY: year.toString().slice(-2),
+            MM: month.toString().padStart(2, '0'),
+            DD: day.toString().padStart(2, '0'),
+            HH: hours.toString().padStart(2, '0'),
+            hh: hours12.toString().padStart(2, '0'),
+            mm: minutes.toString().padStart(2, '0'),
+            ss: seconds.toString().padStart(2, '0'),
+            SSS: milliseconds.toString().padStart(3, '0'),
+            WW: weekNumber.toString().padStart(2, '0'),
+            dd: (0, formatDatePlain_1.getLocalizedWeekday)(weekday, options),
+        };
+        Object.entries(multiCharReplacements).forEach(([token, value]) => {
+            // 使用单词边界或字符串边界来确保精确匹配
+            const regex = new RegExp(`\\b${token}\\b|${token}(?![a-zA-Z0-9])`, 'g');
+            result = result.replace(regex, value);
+        });
+        // 4. 替换单字符标记（使用更精确的匹配）
+        const singleCharReplacements = {
+            Y: year.toString(),
+            M: month.toString(),
+            D: day.toString(),
+            H: hours.toString(),
+            h: hours12.toString(),
+            m: minutes.toString(),
+            s: seconds.toString(),
+            W: weekNumber.toString(),
+            d: weekday.toString(),
+            Q: quarter.toString(),
+            A: ampm,
+            a: ampmLower,
+        };
+        Object.entries(singleCharReplacements).forEach(([token, value]) => {
+            // 单字符需要更精确的匹配：前面是边界或特定字符，后面不是相同字符
+            const regex = new RegExp(`(?<![a-zA-Z0-9])${token}(?![a-zA-Z0-9])`, 'g');
+            result = result.replace(regex, value);
+        });
+        return result;
+    };
+    // 缓存编译结果
+    FORMAT_CACHE.set(formatStr, compiledFn);
+    return compiledFn;
+}
+exports.compileFormat = compileFormat;
+/**
+ * 清除格式化缓存
+ * @param formatStr - 可选，指定要清除的格式化字符串缓存
+ */
+function clearFormatCache(formatStr) {
+    if (formatStr) {
+        FORMAT_CACHE.delete(formatStr);
+    }
+    else {
+        FORMAT_CACHE.clear();
+    }
+}
+exports.clearFormatCache = clearFormatCache;
+/**
+ * 编译模式日期格式化
+ * @param input - 要格式化的日期输入
+ * @param formatStr - 格式化字符串
+ * @param options - 格式化选项
+ * @returns 格式化后的日期字符串
+ */
+function formatDateCompiled(input, formatStr = 'YYYY-MM-DD HH:mm:ss', options = {}) {
+    const date = (0, formatDatePlain_1.safeParseDate)(input);
+    const mergedOptions = { ...constants_1.DEFAULT_DATE_FORMAT_OPTIONS, ...options };
+    // 编译并缓存格式化函数
+    const formatter = compileFormat(formatStr);
+    // 使用编译后的函数格式化日期
+    return formatter(date, mergedOptions);
+}
+exports.formatDateCompiled = formatDateCompiled;
+exports.default = formatDateCompiled;
+//# sourceMappingURL=formatDateCompiled.js.map

package/dist/date/formatDateCompiled.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatDateCompiled.js","sourceRoot":"","sources":["../../src/date/formatDateCompiled.ts"],"names":[],"mappings":"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"}

package/dist/date/formatDatePlain.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 普通模式日期格式化实现
+ * 每次调用都会重新解析格式化字符串
+ */
+import { DateFormatOptions, DateInput } from '../types/date';
+/**
+ * 将各种输入类型安全地转换为 Date 对象
+ * @param input - 日期输入
+ * @returns 转换后的 Date 对象，无效输入返回当前时间
+ */
+export declare function safeParseDate(input: DateInput): Date;
+/**
+ * 计算一年中的第几周 (ISO 8601)
+ * @param date - 日期对象
+ * @returns 周数
+ */
+export declare function getWeekNumber(date: Date): number;
+/**
+ * 获取本地化的星期几
+ * @param weekday - 星期几 (0-6)
+ * @param options - 格式化选项
+ * @returns 本地化的星期几字符串
+ */
+export declare function getLocalizedWeekday(weekday: number, options: DateFormatOptions): string;
+/**
+ * 普通模式日期格式化
+ * @param input - 要格式化的日期输入
+ * @param formatStr - 格式化字符串
+ * @param options - 格式化选项
+ * @returns 格式化后的日期字符串
+ */
+export declare function formatDatePlain(input: DateInput, formatStr?: string, options?: Partial<DateFormatOptions>): string;
+export default formatDatePlain;
+//# sourceMappingURL=formatDatePlain.d.ts.map

package/dist/date/formatDatePlain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatDatePlain.d.ts","sourceRoot":"","sources":["../../src/date/formatDatePlain.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG7D;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAepD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAMhD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAGvF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC3B,KAAK,EAAE,SAAS,EAChB,SAAS,GAAE,MAA8B,EACzC,OAAO,GAAE,OAAO,CAAC,iBAAiB,CAAM,GACzC,MAAM,CA+ER;AAED,eAAe,eAAe,CAAC"}

package/dist/date/formatDatePlain.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDatePlain = exports.getLocalizedWeekday = exports.getWeekNumber = exports.safeParseDate = void 0;
+const constants_1 = require("../utils/constants");
+/**
+ * 将各种输入类型安全地转换为 Date 对象
+ * @param input - 日期输入
+ * @returns 转换后的 Date 对象，无效输入返回当前时间
+ */
+function safeParseDate(input) {
+    if (input instanceof Date && !isNaN(input.getTime())) {
+        return input;
+    }
+    if (typeof input === 'string' || typeof input === 'number') {
+        const date = new Date(input);
+        if (!isNaN(date.getTime())) {
+            return date;
+        }
+    }
+    // 无效输入返回当前时间
+    console.warn(`Invalid date input: ${input}, using current date instead.`);
+    return new Date();
+}
+exports.safeParseDate = safeParseDate;
+/**
+ * 计算一年中的第几周 (ISO 8601)
+ * @param date - 日期对象
+ * @returns 周数
+ */
+function getWeekNumber(date) {
+    const d = new Date(Date.UTC(date.getFullYear(), date.getMonth(), date.getDate()));
+    const dayNum = d.getUTCDay() || 7;
+    d.setUTCDate(d.getUTCDate() + 4 - dayNum);
+    const yearStart = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));
+    return Math.ceil(((d.getTime() - yearStart.getTime()) / 86400000 + 1) / 7);
+}
+exports.getWeekNumber = getWeekNumber;
+/**
+ * 获取本地化的星期几
+ * @param weekday - 星期几 (0-6)
+ * @param options - 格式化选项
+ * @returns 本地化的星期几字符串
+ */
+function getLocalizedWeekday(weekday, options) {
+    const lang = options.locale?.split('-')[0] || 'zh';
+    return constants_1.WEEKDAY_MAP[lang]?.[weekday] || constants_1.WEEKDAY_MAP.zh[weekday];
+}
+exports.getLocalizedWeekday = getLocalizedWeekday;
+/**
+ * 普通模式日期格式化
+ * @param input - 要格式化的日期输入
+ * @param formatStr - 格式化字符串
+ * @param options - 格式化选项
+ * @returns 格式化后的日期字符串
+ */
+function formatDatePlain(input, formatStr = 'YYYY-MM-DD HH:mm:ss', options = {}) {
+    const date = safeParseDate(input);
+    const mergedOptions = { ...constants_1.DEFAULT_DATE_FORMAT_OPTIONS, ...options };
+    // 获取日期各部分
+    const year = date.getFullYear();
+    const month = date.getMonth() + 1;
+    const day = date.getDate();
+    const hours = date.getHours();
+    const minutes = date.getMinutes();
+    const seconds = date.getSeconds();
+    const milliseconds = date.getMilliseconds();
+    const weekday = date.getDay();
+    const quarter = Math.floor((date.getMonth() + 3) / 3);
+    const weekNumber = getWeekNumber(date);
+    // 12小时制
+    const hours12 = hours % 12 || 12;
+    const ampm = hours < 12 ? 'AM' : 'PM';
+    const ampmLower = ampm.toLowerCase();
+    let result = formatStr;
+    // 优先替换 timestamp，避免被拆解
+    if (result.includes('timestamp')) {
+        result = result.replace(/timestamp/g, date.getTime().toString());
+    }
+    // 2. 应用自定义格式化器（优先级最高）
+    if (mergedOptions.customFormatters) {
+        Object.entries(mergedOptions.customFormatters).forEach(([token, formatter]) => {
+            const escapedToken = token.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+            const regex = new RegExp(`(?<![a-zA-Z0-9])${escapedToken}(?![a-zA-Z0-9])`, 'g');
+            result = result.replace(regex, formatter(date));
+        });
+    }
+    // 3. 替换多字符标记（2-4个字符）
+    const multiCharReplacements = {
+        YYYY: year.toString().padStart(4, '0'),
+        YY: year.toString().slice(-2),
+        MM: month.toString().padStart(2, '0'),
+        DD: day.toString().padStart(2, '0'),
+        HH: hours.toString().padStart(2, '0'),
+        hh: hours12.toString().padStart(2, '0'),
+        mm: minutes.toString().padStart(2, '0'),
+        ss: seconds.toString().padStart(2, '0'),
+        SSS: milliseconds.toString().padStart(3, '0'),
+        WW: weekNumber.toString().padStart(2, '0'),
+        dd: getLocalizedWeekday(weekday, mergedOptions),
+    };
+    Object.entries(multiCharReplacements).forEach(([token, value]) => {
+        const regex = new RegExp(`\\b${token}\\b|${token}(?![a-zA-Z0-9])`, 'g');
+        result = result.replace(regex, value);
+    });
+    // 4. 替换单字符标记（使用更精确的匹配）
+    const singleCharReplacements = {
+        Y: year.toString(),
+        M: month.toString(),
+        D: day.toString(),
+        H: hours.toString(),
+        h: hours12.toString(),
+        m: minutes.toString(),
+        s: seconds.toString(),
+        W: weekNumber.toString(),
+        d: weekday.toString(),
+        Q: quarter.toString(),
+        A: ampm,
+        a: ampmLower,
+    };
+    Object.entries(singleCharReplacements).forEach(([token, value]) => {
+        const regex = new RegExp(`(?<![a-zA-Z0-9])${token}(?![a-zA-Z0-9])`, 'g');
+        result = result.replace(regex, value);
+    });
+    return result;
+}
+exports.formatDatePlain = formatDatePlain;
+exports.default = formatDatePlain;
+//# sourceMappingURL=formatDatePlain.js.map

package/dist/date/formatDatePlain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatDatePlain.js","sourceRoot":"","sources":["../../src/date/formatDatePlain.ts"],"names":[],"mappings":";;;AAKA,kDAA8E;AAE9E;;;;GAIG;AACH,SAAgB,aAAa,CAAC,KAAgB;IAC1C,IAAI,KAAK,YAAY,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QACnD,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACzD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IAED,aAAa;IACb,OAAO,CAAC,IAAI,CAAC,uBAAuB,KAAK,+BAA+B,CAAC,CAAC;IAC1E,OAAO,IAAI,IAAI,EAAE,CAAC;AACtB,CAAC;AAfD,sCAeC;AAED;;;;GAIG;AACH,SAAgB,aAAa,CAAC,IAAU;IACpC,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAClF,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/D,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/E,CAAC;AAND,sCAMC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,OAAe,EAAE,OAA0B;IAC3E,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IACnD,OAAO,uBAAW,CAAC,IAAgC,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,uBAAW,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;AAC/F,CAAC;AAHD,kDAGC;AAED;;;;;;GAMG;AACH,SAAgB,eAAe,CAC3B,KAAgB,EAChB,YAAoB,qBAAqB,EACzC,UAAsC,EAAE;IAExC,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAClC,MAAM,aAAa,GAAG,EAAE,GAAG,uCAA2B,EAAE,GAAG,OAAO,EAAE,CAAC;IAErE,UAAU;IACV,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;IAClC,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;IAClC,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;IAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACtD,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAEvC,QAAQ;IACR,MAAM,OAAO,GAAG,KAAK,GAAG,EAAE,IAAI,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACtC,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAErC,IAAI,MAAM,GAAG,SAAS,CAAC;IAEvB,uBAAuB;IACvB,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/B,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,sBAAsB;IACtB,IAAI,aAAa,CAAC,gBAAgB,EAAE,CAAC;QACjC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE;YAC1E,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;YAClE,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,mBAAmB,YAAY,iBAAiB,EAAE,GAAG,CAAC,CAAC;YAChF,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;IACP,CAAC;IAED,qBAAqB;IACrB,MAAM,qBAAqB,GAA2B;QAClD,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;QACtC,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC7B,EAAE,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;QACrC,EAAE,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;QACnC,EAAE,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;QACrC,EAAE,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;QACvC,EAAE,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;QACvC,EAAE,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;QACvC,GAAG,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;QAC7C,EAAE,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;QAC1C,EAAE,EAAE,mBAAmB,CAAC,OAAO,EAAE,aAAa,CAAC;KAClD,CAAC;IAEF,MAAM,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE;QAC7D,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,KAAK,iBAAiB,EAAE,GAAG,CAAC,CAAC;QACxE,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,uBAAuB;IACvB,MAAM,sBAAsB,GAA2B;QACnD,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE;QAClB,CAAC,EAAE,KAAK,CAAC,QAAQ,EAAE;QACnB,CAAC,EAAE,GAAG,CAAC,QAAQ,EAAE;QACjB,CAAC,EAAE,KAAK,CAAC,QAAQ,EAAE;QACnB,CAAC,EAAE,OAAO,CAAC,QAAQ,EAAE;QACrB,CAAC,EAAE,OAAO,CAAC,QAAQ,EAAE;QACrB,CAAC,EAAE,OAAO,CAAC,QAAQ,EAAE;QACrB,CAAC,EAAE,UAAU,CAAC,QAAQ,EAAE;QACxB,CAAC,EAAE,OAAO,CAAC,QAAQ,EAAE;QACrB,CAAC,EAAE,OAAO,CAAC,QAAQ,EAAE;QACrB,CAAC,EAAE,IAAI;QACP,CAAC,EAAE,SAAS;KACf,CAAC;IAEF,MAAM,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE;QAC9D,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,mBAAmB,KAAK,iBAAiB,EAAE,GAAG,CAAC,CAAC;QACzE,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAClB,CAAC;AAnFD,0CAmFC;AAED,kBAAe,eAAe,CAAC"}

package/dist/object/toFormattedNumber.d.ts

@@ -51,7 +51,7 @@
  * toFormattedNumber('abc', { nanValue: -1 }); // -1
  * ```
  */
-declare function toFormattedNumber(object: unknown[], options?: import("../types/object").ToFormattedNumberOptions): number[];
-declare function toFormattedNumber(object: unknown, options?: import("../types/object").ToFormattedNumberOptions): number;
+declare function toFormattedNumber(object: unknown[], options?: import('../types/object').ToFormattedNumberOptions): number[];
+declare function toFormattedNumber(object: unknown, options?: import('../types/object').ToFormattedNumberOptions): number;
 export default toFormattedNumber;
 //# sourceMappingURL=toFormattedNumber.d.ts.map

package/dist/object/toFormattedNumber.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toFormattedNumber.d.ts","sourceRoot":"","sources":["../../src/object/toFormattedNumber.ts"],"names":[],"mappings":"AA0CA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAEH,iBAAS,iBAAiB,CACxB,MAAM,EAAE,OAAO,EAAE,EACjB,OAAO,CAAC,EAAE,OAAO,iBAAiB,EAAE,wBAAwB,GAC3D,MAAM,EAAE,CAAC;AAEZ,iBAAS,iBAAiB,CACxB,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,OAAO,iBAAiB,EAAE,wBAAwB,GAC3D,MAAM,CAAC;AAmDV,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"toFormattedNumber.d.ts","sourceRoot":"","sources":["../../src/object/toFormattedNumber.ts"],"names":[],"mappings":"AA4CA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAEH,iBAAS,iBAAiB,CACxB,MAAM,EAAE,OAAO,EAAE,EACjB,OAAO,CAAC,EAAE,OAAO,iBAAiB,EAAE,wBAAwB,GAC3D,MAAM,EAAE,CAAC;AAEZ,iBAAS,iBAAiB,CACxB,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,OAAO,iBAAiB,EAAE,wBAAwB,GAC3D,MAAM,CAAC;AAoDV,eAAe,iBAAiB,CAAC"}

package/dist/object/toFormattedNumber.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const constants_1 = require("../utils/constants");
 /**
  * 从字符串中提取数字部分
  * @param str - 输入字符串
@@ -8,7 +9,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 function extractNumberFromString(str) {
     // 匹配数字体系：0~9，小数点，正负号，科学计数法
     const match = str.match(/[-+]?\d*\.?\d+(?:[eE][-+]?\d+)?/);
-    return match ? match[0] : "";
+    return match ? match[0] : '';
 }
 /**
  * 将单个值转换为数字
@@ -17,24 +18,24 @@ function extractNumberFromString(str) {
  */
 function convertToNumber(value) {
     switch (typeof value) {
-        case "number":
+        case 'number':
             return value;
-        case "string": {
+        case 'string': {
             const numStr = extractNumberFromString(value);
             return numStr ? Number(numStr) : 0;
         }
-        case "boolean":
+        case 'boolean':
             return value ? 1 : 0;
-        case "function":
-        case "symbol":
+        case 'function':
+        case 'symbol':
             return NaN;
-        case "object":
+        case 'object':
             if (value === null) {
                 return NaN;
             }
             // 其他对象类型返回NaN
             return NaN;
-        case "undefined":
+        case 'undefined':
             return NaN;
         default:
             return NaN;
@@ -43,7 +44,7 @@ function convertToNumber(value) {
 // 主函数实现
 function toFormattedNumber(object, options) {
     // 解构并设置默认值
-    const { decimalPlaces = true, nanValue = NaN } = options || {};
+    const { decimalPlaces = constants_1.DecimalPlacesOptions.RETAIN_ALL, nanValue = NaN } = options || {};
     /**
      * 格式化单个数字
      * @param num - 要格式化的数字
@@ -55,14 +56,14 @@ function toFormattedNumber(object, options) {
             return nanValue;
         }
         // 根据decimalPlaces选项处理小数位
-        if (decimalPlaces === true) {
-            // 保留所有小数位，不额外处理
-            return num;
-        }
-        else {
+        if (typeof decimalPlaces === 'number') {
             // 保留指定小数位，四舍五入
             return Number(num.toFixed(decimalPlaces));
         }
+        else {
+            // 保留所有小数位，不额外处理
+            return num;
+        }
     };
     /**
      * 转换单个值为数字，支持深层数组递归处理

package/dist/object/toFormattedNumber.js.map

@@ -1 +1 @@
-{"version":3,"file":"toFormattedNumber.js","sourceRoot":"","sources":["../../src/object/toFormattedNumber.ts"],"names":[],"mappings":";;AAAA;;;;GAIG;AACH,SAAS,uBAAuB,CAAC,GAAW;IAC1C,2BAA2B;IAC3B,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAC3D,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,SAAS,eAAe,CAAC,KAAc;IACrC,QAAQ,OAAO,KAAK,EAAE,CAAC;QACrB,KAAK,QAAQ;YACX,OAAO,KAAK,CAAC;QACf,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;YAC9C,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrC,CAAC;QACD,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACvB,KAAK,UAAU,CAAC;QAChB,KAAK,QAAQ;YACX,OAAO,GAAG,CAAC;QACb,KAAK,QAAQ;YACX,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnB,OAAO,GAAG,CAAC;YACb,CAAC;YACD,cAAc;YACd,OAAO,GAAG,CAAC;QACb,KAAK,WAAW;YACd,OAAO,GAAG,CAAC;QACb;YACE,OAAO,GAAG,CAAC;IACf,CAAC;AACH,CAAC;AAiED,QAAQ;AACR,SAAS,iBAAiB,CACxB,MAAe,EACf,OAA4D;IAE5D,WAAW;IACX,MAAM,EAAE,aAAa,GAAG,IAAI,EAAE,QAAQ,GAAG,GAAG,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IAE/D;;;;OAIG;IACH,MAAM,kBAAkB,GAAG,CAAC,GAAW,EAAU,EAAE;QACjD,UAAU;QACV,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YACf,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,yBAAyB;QACzB,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;YAC3B,gBAAgB;YAChB,OAAO,GAAG,CAAC;QACb,CAAC;aAAM,CAAC;YACN,eAAe;YACf,OAAO,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC,CAAC;IAEF;;;;OAIG;IACH,MAAM,YAAY,GAAG,CAAC,KAAc,EAAqB,EAAE;QACzD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,WAAW;YACX,OAAO,KAAK,CAAC,GAAG,CAAC,YAAY,CAAa,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,QAAQ;YACR,MAAM,GAAG,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;YACnC,QAAQ;YACR,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC;IACH,CAAC,CAAC;IAEF,QAAQ;IACR,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC;AAED,kBAAe,iBAAiB,CAAC"}
+{"version":3,"file":"toFormattedNumber.js","sourceRoot":"","sources":["../../src/object/toFormattedNumber.ts"],"names":[],"mappings":";;AAAA,kDAA0D;AAE1D;;;;GAIG;AACH,SAAS,uBAAuB,CAAC,GAAW;IAC1C,2BAA2B;IAC3B,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAC3D,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,SAAS,eAAe,CAAC,KAAc;IACrC,QAAQ,OAAO,KAAK,EAAE,CAAC;QACrB,KAAK,QAAQ;YACX,OAAO,KAAK,CAAC;QACf,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;YAC9C,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrC,CAAC;QACD,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACvB,KAAK,UAAU,CAAC;QAChB,KAAK,QAAQ;YACX,OAAO,GAAG,CAAC;QACb,KAAK,QAAQ;YACX,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnB,OAAO,GAAG,CAAC;YACb,CAAC;YACD,cAAc;YACd,OAAO,GAAG,CAAC;QACb,KAAK,WAAW;YACd,OAAO,GAAG,CAAC;QACb;YACE,OAAO,GAAG,CAAC;IACf,CAAC;AACH,CAAC;AAiED,QAAQ;AACR,SAAS,iBAAiB,CACxB,MAAe,EACf,OAA4D;IAE5D,WAAW;IACX,MAAM,EAAE,aAAa,GAAG,gCAAoB,CAAC,UAAU,EAAE,QAAQ,GAAG,GAAG,EAAE,GACvE,OAAO,IAAI,EAAE,CAAC;IAEhB;;;;OAIG;IACH,MAAM,kBAAkB,GAAG,CAAC,GAAW,EAAU,EAAE;QACjD,UAAU;QACV,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YACf,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,yBAAyB;QACzB,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;YACtC,eAAe;YACf,OAAO,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;QAC5C,CAAC;aAAM,CAAC;YACN,gBAAgB;YAChB,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC,CAAC;IAEF;;;;OAIG;IACH,MAAM,YAAY,GAAG,CAAC,KAAc,EAAqB,EAAE;QACzD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,WAAW;YACX,OAAO,KAAK,CAAC,GAAG,CAAC,YAAY,CAAa,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,QAAQ;YACR,MAAM,GAAG,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;YACnC,QAAQ;YACR,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC;IACH,CAAC,CAAC;IAEF,QAAQ;IACR,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC;AAED,kBAAe,iBAAiB,CAAC"}

package/dist/object/toFormattedNumberString.d.ts

@@ -1,4 +1,63 @@
-declare function toFormattedNumberString(object: unknown[], options?: import("../types/object").ToFormattedNumberStringOptions): string[];
-declare function toFormattedNumberString(object: unknown, options?: import("../types/object").ToFormattedNumberStringOptions): string;
+declare function toFormattedNumberString(object: unknown[], options?: import('../types/object').ToFormattedNumberStringOptions): string[];
+declare function toFormattedNumberString(object: unknown, options?: import('../types/object').ToFormattedNumberStringOptions): string;
+/**
+ * 将任意对象转化为格式化的数字字符串
+ *
+ * 该函数先使用toFormattedNumber将对象转化为数字，再对数字进行字符串格式化
+ * 支持多种输入类型，包括数字、字符串、布尔值、null、undefined、数组等
+ * 支持深层数组递归处理
+ *
+ * @param object - 要格式化的对象，可以是任何类型
+ * @param options - 格式化选项，具体参数说明见类型声明
+ *
+ * @returns 格式化后的数字字符串或字符串数组
+ *          - 当传入的 object 为非数组时，返回 string
+ *          - 当传入的 object 为数组时，返回 string[]
+ *          - 支持深层数组递归处理
+ *
+ * @example
+ * ```typescript
+ * // 单个数字值
+ * toFormattedNumberString(123.456); // "123.456"
+ *
+ * // 保留两位小数，不够时补0
+ * toFormattedNumberString(123.4, { decimalPlaces: 2 }); // "123.40"
+ *
+ * // 带前缀后缀
+ * toFormattedNumberString(123.456, { prefix: '$', suffix: ' USD' }); // "$123.456 USD"
+ *
+ * // 本地化格式
+ * toFormattedNumberString(1234567.89, { localized: true }); // "1,234,567.89"
+ * // 兼容旧的useLocalizedFormat参数
+ * toFormattedNumberString(1234567.89, { useLocalizedFormat: true }); // "1,234,567.89"
+ *
+ * // 自定义NaN和0显示
+ * toFormattedNumberString(null, { nanValue: 'N/A' }); // "N/A"
+ * toFormattedNumberString(0, { zeroValue: '-' }); // "-"
+ *
+ * // 预处理函数
+ * toFormattedNumberString(0.1234, {
+ *   preProcessor: (original, num) => num * 100,
+ *   suffix: '%'
+ * }); // "12.34%"
+ *
+ * // 函数类型前缀
+ * toFormattedNumberString(123.456, {
+ *   prefix: (original, num, formatted) => `$${Math.floor(num)}`
+ * }); // "$123123.456"
+ *
+ * // 函数类型后缀
+ * toFormattedNumberString(123.456, {
+ *   suffix: (original, num, formatted) => `/${num.toFixed(0)}`
+ * }); // "123.456/123"
+ *
+ * // 处理数组
+ * toFormattedNumberString([123.456, '789.012'], { decimalPlaces: 2 }); // ["123.46", "789.01"]
+ *
+ * // 处理深层数组
+ * toFormattedNumberString([[1, '1.23'], ['45.67', [89.01, 'abc']]], { decimalPlaces: 2 });
+ * // 返回: [["1.00", "1.23"], ["45.67", ["89.01", "NaN"]]]
+ * ```
+ */
 export default toFormattedNumberString;
 //# sourceMappingURL=toFormattedNumberString.d.ts.map

package/dist/object/toFormattedNumberString.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toFormattedNumberString.d.ts","sourceRoot":"","sources":["../../src/object/toFormattedNumberString.ts"],"names":[],"mappings":"AAuOA,iBAAS,uBAAuB,CAC9B,MAAM,EAAE,OAAO,EAAE,EACjB,OAAO,CAAC,EAAE,OAAO,iBAAiB,EAAE,8BAA8B,GACjE,MAAM,EAAE,CAAC;AAEZ,iBAAS,uBAAuB,CAC9B,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,OAAO,iBAAiB,EAAE,8BAA8B,GACjE,MAAM,CAAC;AA6BV,eAAe,uBAAuB,CAAC"}
+{"version":3,"file":"toFormattedNumberString.d.ts","sourceRoot":"","sources":["../../src/object/toFormattedNumberString.ts"],"names":[],"mappings":"AA6KA,iBAAS,uBAAuB,CAC9B,MAAM,EAAE,OAAO,EAAE,EACjB,OAAO,CAAC,EAAE,OAAO,iBAAiB,EAAE,8BAA8B,GACjE,MAAM,EAAE,CAAC;AAEZ,iBAAS,uBAAuB,CAC9B,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,OAAO,iBAAiB,EAAE,8BAA8B,GACjE,MAAM,CAAC;AA6BV;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,eAAe,uBAAuB,CAAC"}

package/dist/object/toFormattedNumberString.js

@@ -3,65 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * 将任意对象转化为格式化的数字字符串
- *
- * 该函数先使用toFormattedNumber将对象转化为数字，再对数字进行字符串格式化
- * 支持多种输入类型，包括数字、字符串、布尔值、null、undefined、数组等
- * 支持深层数组递归处理
- *
- * @param object - 要格式化的对象，可以是任何类型
- * @param options - 格式化选项，具体参数说明见类型声明
- *
- * @returns 格式化后的数字字符串或字符串数组
- *          - 当传入的 object 为非数组时，返回 string
- *          - 当传入的 object 为数组时，返回 string[]
- *          - 支持深层数组递归处理
- *
- * @example
- * ```typescript
- * // 单个数字值
- * toFormattedNumberString(123.456); // "123.456"
- *
- * // 保留两位小数，不够时补0
- * toFormattedNumberString(123.4, { decimalPlaces: 2 }); // "123.40"
- *
- * // 带前缀后缀
- * toFormattedNumberString(123.456, { prefix: '$', suffix: ' USD' }); // "$123.456 USD"
- *
- * // 本地化格式
- * toFormattedNumberString(1234567.89, { localized: true }); // "1,234,567.89"
- * // 兼容旧的useLocalizedFormat参数
- * toFormattedNumberString(1234567.89, { useLocalizedFormat: true }); // "1,234,567.89"
- *
- * // 自定义NaN和0显示
- * toFormattedNumberString(null, { nanValue: 'N/A' }); // "N/A"
- * toFormattedNumberString(0, { zeroValue: '-' }); // "-"
- *
- * // 预处理函数
- * toFormattedNumberString(0.1234, {
- *   preProcessor: (original, num) => num * 100,
- *   suffix: '%'
- * }); // "12.34%"
- *
- * // 函数类型前缀
- * toFormattedNumberString(123.456, {
- *   prefix: (original, num, formatted) => `$${Math.floor(num)}`
- * }); // "$123123.456"
- *
- * // 函数类型后缀
- * toFormattedNumberString(123.456, {
- *   suffix: (original, num, formatted) => `/${num.toFixed(0)}`
- * }); // "123.456/123"
- *
- * // 处理数组
- * toFormattedNumberString([123.456, '789.012'], { decimalPlaces: 2 }); // ["123.46", "789.01"]
- *
- * // 处理深层数组
- * toFormattedNumberString([[1, '1.23'], ['45.67', [89.01, 'abc']]], { decimalPlaces: 2 });
- * // 返回: [["1.00", "1.23"], ["45.67", ["89.01", "NaN"]]]
- * ```
- */
+const constants_1 = require("../utils/constants");
 const toFormattedNumber_1 = __importDefault(require("./toFormattedNumber"));
 /**
  * 检查字符串是否包含数字
@@ -82,14 +24,14 @@ function hasNumbers(str) {
  */
 function addPrefixSuffix(prefix, suffix, formatted, converted, original) {
     let processedPrefix;
-    if (typeof prefix === "function") {
+    if (typeof prefix === 'function') {
         processedPrefix = prefix(original, converted, formatted);
     }
     else {
         processedPrefix = prefix;
     }
     let processedSuffix;
-    if (typeof suffix === "function") {
+    if (typeof suffix === 'function') {
         processedSuffix = suffix(original, converted, formatted);
     }
     else {
@@ -118,7 +60,7 @@ function format(converted, original, options) {
     let formatted;
     if (localized) {
         // 使用本地化格式
-        if (decimalPlaces === true) {
+        if (typeof decimalPlaces !== 'number') {
             // 保留所有小数位
             formatted = preProcessed.toLocaleString();
         }
@@ -132,7 +74,7 @@ function format(converted, original, options) {
     }
     else {
         // 使用非本地化格式
-        if (decimalPlaces === true) {
+        if (typeof decimalPlaces !== 'number') {
             // 保留所有小数位
             formatted = preProcessed.toString();
         }
@@ -159,13 +101,13 @@ function processValue(value, original, options) {
     }
     else {
         // 检查是否为无数字的字符串
-        if (typeof value === "string" && !hasNumbers(value)) {
+        if (typeof value === 'string' && !hasNumbers(value)) {
             // 无数字的字符串返回0
             return addPrefixSuffix(prefix, suffix, zeroValue, 0, original);
         }
         // 对于其他类型，首先将输入转换为数字
         // 注意：toFormattedNumber对于单个值会返回number类型
-        const converted = typeof value === "number"
+        const converted = typeof value === 'number'
             ? value
             : (0, toFormattedNumber_1.default)(value, {
                 decimalPlaces,
@@ -183,7 +125,7 @@ function processValue(value, original, options) {
 // 主函数实现
 function toFormattedNumberString(object, options) {
     // 解构并设置默认值
-    const { decimalPlaces = true, nanValue = "NaN", zeroValue = "0", localized, preProcessor, prefix = "", suffix = "", } = options || {};
+    const { decimalPlaces = constants_1.DecimalPlacesOptions.RETAIN_ALL, nanValue = 'NaN', zeroValue = '0', localized, preProcessor, prefix = '', suffix = '', } = options || {};
     // 处理输入值
     return processValue(object, object, {
         decimalPlaces,
@@ -195,5 +137,64 @@ function toFormattedNumberString(object, options) {
         suffix,
     });
 }
+/**
+ * 将任意对象转化为格式化的数字字符串
+ *
+ * 该函数先使用toFormattedNumber将对象转化为数字，再对数字进行字符串格式化
+ * 支持多种输入类型，包括数字、字符串、布尔值、null、undefined、数组等
+ * 支持深层数组递归处理
+ *
+ * @param object - 要格式化的对象，可以是任何类型
+ * @param options - 格式化选项，具体参数说明见类型声明
+ *
+ * @returns 格式化后的数字字符串或字符串数组
+ *          - 当传入的 object 为非数组时，返回 string
+ *          - 当传入的 object 为数组时，返回 string[]
+ *          - 支持深层数组递归处理
+ *
+ * @example
+ * ```typescript
+ * // 单个数字值
+ * toFormattedNumberString(123.456); // "123.456"
+ *
+ * // 保留两位小数，不够时补0
+ * toFormattedNumberString(123.4, { decimalPlaces: 2 }); // "123.40"
+ *
+ * // 带前缀后缀
+ * toFormattedNumberString(123.456, { prefix: '$', suffix: ' USD' }); // "$123.456 USD"
+ *
+ * // 本地化格式
+ * toFormattedNumberString(1234567.89, { localized: true }); // "1,234,567.89"
+ * // 兼容旧的useLocalizedFormat参数
+ * toFormattedNumberString(1234567.89, { useLocalizedFormat: true }); // "1,234,567.89"
+ *
+ * // 自定义NaN和0显示
+ * toFormattedNumberString(null, { nanValue: 'N/A' }); // "N/A"
+ * toFormattedNumberString(0, { zeroValue: '-' }); // "-"
+ *
+ * // 预处理函数
+ * toFormattedNumberString(0.1234, {
+ *   preProcessor: (original, num) => num * 100,
+ *   suffix: '%'
+ * }); // "12.34%"
+ *
+ * // 函数类型前缀
+ * toFormattedNumberString(123.456, {
+ *   prefix: (original, num, formatted) => `$${Math.floor(num)}`
+ * }); // "$123123.456"
+ *
+ * // 函数类型后缀
+ * toFormattedNumberString(123.456, {
+ *   suffix: (original, num, formatted) => `/${num.toFixed(0)}`
+ * }); // "123.456/123"
+ *
+ * // 处理数组
+ * toFormattedNumberString([123.456, '789.012'], { decimalPlaces: 2 }); // ["123.46", "789.01"]
+ *
+ * // 处理深层数组
+ * toFormattedNumberString([[1, '1.23'], ['45.67', [89.01, 'abc']]], { decimalPlaces: 2 });
+ * // 返回: [["1.00", "1.23"], ["45.67", ["89.01", "NaN"]]]
+ * ```
+ */
 exports.default = toFormattedNumberString;
 //# sourceMappingURL=toFormattedNumberString.js.map

package/dist/object/toFormattedNumberString.js.map

@@ -1 +1 @@
-{"version":3,"file":"toFormattedNumberString.js","sourceRoot":"","sources":["../../src/object/toFormattedNumberString.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"toFormattedNumberString.js","sourceRoot":"","sources":["../../src/object/toFormattedNumberString.ts"],"names":[],"mappings":"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"}

package/dist/types/object.d.ts

@@ -1,13 +1,14 @@
+import { DecimalPlacesOptions } from '../utils/constants';
 /**
  * 公共格式化选项接口
  */
 export interface CommonFormatOptions {
     /**
      * 保留多少位小数，
-     * 默认true（保留所有小数位，不额外处理），
-     * 可选值：number(保留指定小数位) | true(保留所有小数位，不额外处理)。
+     * 默认DecimalPlacesOptions.RETAIN_ALL（保留所有小数位，不额外处理），
+     * 可选值：number(保留指定小数位) | DecimalPlacesOptions.RETAIN_ALL(保留所有小数位，不额外处理)。
      */
-    decimalPlaces?: number | true;
+    decimalPlaces?: DecimalPlacesOptions;
 }
 /**
  * toFormattedNumber 函数的选项接口

package/dist/types/object.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../../src/types/object.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,mBAAmB;IACnE;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,8BAA+B,SAAQ,mBAAmB;IACzE;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IAChE;;;OAGG;IACH,MAAM,CAAC,EACH,MAAM,GACN,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;IAC1E;;;OAGG;IACH,MAAM,CAAC,EACH,MAAM,GACN,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;CAC3E"}
+{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../../src/types/object.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,aAAa,CAAC,EAAE,oBAAoB,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,mBAAmB;IACnE;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,8BAA+B,SAAQ,mBAAmB;IACzE;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IAChE;;;OAGG;IACH,MAAM,CAAC,EACH,MAAM,GACN,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;IAC1E;;;OAGG;IACH,MAAM,CAAC,EACH,MAAM,GACN,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;CAC3E"}

package/dist/utils/constants.d.ts

@@ -17,4 +17,17 @@ export declare const WEEKDAY_MAP: Record<string, [
     string,
     string
 ]>;
+/**
+ * 小数位格式化选项
+ */
+declare const RETAIN_ALL_BRAND: unique symbol;
+interface RETAIN_ALL {
+    readonly [RETAIN_ALL_BRAND]: typeof RETAIN_ALL_BRAND;
+}
+export type DecimalPlacesOptions = number | RETAIN_ALL;
+declare const RETAIN_ALL: RETAIN_ALL;
+export declare const DecimalPlacesOptions: {
+    RETAIN_ALL: RETAIN_ALL;
+};
+export {};
 //# sourceMappingURL=constants.d.ts.map

package/dist/utils/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;CAGvC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAC9B,MAAM,EACN;IAAC,MAAM;IAAE,MAAM;IAAE,MAAM;IAAE,MAAM;IAAE,MAAM;IAAE,MAAM;IAAE,MAAM;CAAC,CAYzD,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;CAGvC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAC9B,MAAM,EACN;IAAC,MAAM;IAAE,MAAM;IAAE,MAAM;IAAE,MAAM;IAAE,MAAM;IAAE,MAAM;IAAE,MAAM;CAAC,CAYzD,CAAC;AAEF;;GAEG;AA2BH,QAAA,MAAM,gBAAgB,eAA6B,CAAC;AAEpD,UAAU,UAAU;IAClB,QAAQ,CAAC,CAAC,gBAAgB,CAAC,EAAE,OAAO,gBAAgB,CAAC;CACtD;AAGD,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,UAAU,CAAC;AAEvD,QAAA,MAAM,UAAU,EAAE,UAEF,CAAC;AACjB,eAAO,MAAM,oBAAoB;;CAEhC,CAAC"}

package/dist/utils/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WEEKDAY_MAP = exports.DEFAULT_DATE_FORMAT_OPTIONS = void 0;
+exports.DecimalPlacesOptions = exports.WEEKDAY_MAP = exports.DEFAULT_DATE_FORMAT_OPTIONS = void 0;
 /**
  * 默认格式化选项
  */
@@ -23,4 +23,38 @@ exports.WEEKDAY_MAP = {
         'Saturday',
     ],
 };
+/**
+ * 小数位格式化选项
+ */
+// 可扩展多个标记的写法
+// declare const DECIMAL_OPTIONS_BRAND: unique symbol;
+// type DecimalOptionBase = {
+//   readonly [DECIMAL_OPTIONS_BRAND]: typeof DECIMAL_OPTIONS_BRAND;
+// };
+// /**
+//  * 保留所有小数位的特殊标记类型
+//  */
+// export type RetainAll = DecimalOptionBase & {
+//   readonly type: 'retain-all';
+// };
+// // 创建工厂函数
+// const createDecimalOption = <T extends DecimalOptionBase & { type: string }>(
+//   type: T['type']
+// ): T => {
+//   return {
+//     [DECIMAL_OPTIONS_BRAND]: DECIMAL_OPTIONS_BRAND,
+//     type
+//   } as T;
+// };
+// // 导出所有特殊值
+// export const RETAIN_ALL: RetainAll =
+//   createDecimalOption('retain-all');
+// 只需要一个标记的更简洁的写法
+const RETAIN_ALL_BRAND = Symbol('RETAIN_ALL_BRAND');
+const RETAIN_ALL = Object.freeze({
+    [RETAIN_ALL_BRAND]: RETAIN_ALL_BRAND,
+});
+exports.DecimalPlacesOptions = {
+    RETAIN_ALL,
+};
 //# sourceMappingURL=constants.js.map

package/dist/utils/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACU,QAAA,2BAA2B,GAAG;IACzC,QAAQ,EAAE,OAAgB;IAC1B,MAAM,EAAE,OAAO;CAChB,CAAC;AAEF;;GAEG;AACU,QAAA,WAAW,GAGpB;IACF,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;IAC9C,EAAE,EAAE;QACF,QAAQ;QACR,QAAQ;QACR,SAAS;QACT,WAAW;QACX,UAAU;QACV,QAAQ;QACR,UAAU;KACX;CACF,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACU,QAAA,2BAA2B,GAAG;IACzC,QAAQ,EAAE,OAAgB;IAC1B,MAAM,EAAE,OAAO;CAChB,CAAC;AAEF;;GAEG;AACU,QAAA,WAAW,GAGpB;IACF,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;IAC9C,EAAE,EAAE;QACF,QAAQ;QACR,QAAQ;QACR,SAAS;QACT,WAAW;QACX,UAAU;QACV,QAAQ;QACR,UAAU;KACX;CACF,CAAC;AAEF;;GAEG;AAEH,aAAa;AACb,sDAAsD;AACtD,6BAA6B;AAC7B,oEAAoE;AACpE,KAAK;AACL,MAAM;AACN,oBAAoB;AACpB,MAAM;AACN,gDAAgD;AAChD,iCAAiC;AACjC,KAAK;AACL,YAAY;AACZ,gFAAgF;AAChF,oBAAoB;AACpB,YAAY;AACZ,aAAa;AACb,sDAAsD;AACtD,WAAW;AACX,YAAY;AACZ,KAAK;AACL,aAAa;AACb,uCAAuC;AACvC,uCAAuC;AAEvC,iBAAiB;AACjB,MAAM,gBAAgB,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;AASpD,MAAM,UAAU,GAAe,MAAM,CAAC,MAAM,CAAC;IAC3C,CAAC,gBAAgB,CAAC,EAAE,gBAAgB;CACvB,CAAC,CAAC;AACJ,QAAA,oBAAoB,GAAG;IAClC,UAAU;CACX,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@planarcat/js-toolkit",
-  "version": "1.7.11",
-  "description": "一个自用的带学习性质的（目前）现代化的 JavaScript/TypeScript 实用工具库，提供类型安全、高性能的常用函数，包括对象转换、日期处理、函数优化等开发常用工具。",
+  "version": "1.7.22",
+  "description": "一个现代化的 JavaScript/TypeScript 实用工具库，提供类型安全、高性能的常用函数，包括对象转换、日期处理、函数优化等开发常用工具。",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
@@ -9,6 +9,28 @@
     "README.md",
     "LICENSE"
   ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "build:watch": "tsc --watch",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint \"src/**/*.ts\" \"__tests__/**/*.ts\"",
+    "lint:fix": "eslint \"src/**/*.ts\" \"__tests__/**/*.ts\" --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"__tests__/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"__tests__/**/*.ts\"",
+    "prepare": "husky",
+    "prepublishOnly": "pnpm run lint && pnpm test && pnpm run build",
+    "clean": "rimraf dist coverage",
+    "docs": "typedoc",
+    "docs:watch": "typedoc --watch",
+    "bump": "node scripts/bump-version.js",
+    "bump:patch": "node scripts/bump-version.js patch",
+    "bump:minor": "node scripts/bump-version.js minor",
+    "bump:major": "node scripts/bump-version.js major",
+    "bump:beta": "node scripts/bump-version.js prerelease beta",
+    "bump:alpha": "node scripts/bump-version.js prerelease alpha"
+  },
   "keywords": [
     "javascript",
     "typescript",
@@ -56,25 +78,5 @@
   },
   "publishConfig": {
     "access": "public"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json",
-    "build:watch": "tsc --watch",
-    "test": "jest",
-    "test:watch": "jest --watch",
-    "test:coverage": "jest --coverage",
-    "lint": "eslint \"src/**/*.ts\" \"__tests__/**/*.ts\"",
-    "lint:fix": "eslint \"src/**/*.ts\" \"__tests__/**/*.ts\" --fix",
-    "format": "prettier --write \"src/**/*.ts\" \"__tests__/**/*.ts\"",
-    "format:check": "prettier --check \"src/**/*.ts\" \"__tests__/**/*.ts\"",
-    "clean": "rimraf dist coverage",
-    "docs": "typedoc",
-    "docs:watch": "typedoc --watch",
-    "bump": "node scripts/bump-version.js",
-    "bump:patch": "node scripts/bump-version.js patch",
-    "bump:minor": "node scripts/bump-version.js minor",
-    "bump:major": "node scripts/bump-version.js major",
-    "bump:beta": "node scripts/bump-version.js prerelease beta",
-    "bump:alpha": "node scripts/bump-version.js prerelease alpha"
   }
-}
+}