@planarcat/js-toolkit 1.7.12 → 1.7.27

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/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.12",
-  "description": "一个自用的带学习性质的（目前）现代化的 JavaScript/TypeScript 实用工具库，提供类型安全、高性能的常用函数，包括对象转换、日期处理、函数优化等开发常用工具。",
+  "version": "1.7.27",
+  "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"
   }
-}
+}