@planarcat/js-toolkit 1.3.0 → 1.3.1

package/README.md

@@ -53,9 +53,12 @@ console.log(formatDate(new Date(), 'dd HH:mm', { locale: 'en-US' }));
 import { debounce } from '@planarcat/js-toolkit';
 
 // 创建防抖函数
-const debouncedFn = debounce(() => {
-  console.log('函数执行了！');
-}, { delay: 500 });
+const debouncedFn = debounce(
+    () => {
+        console.log('函数执行了！');
+    },
+    { delay: 500 }
+);
 
 // 多次调用，只会执行最后一次
 debouncedFn();
@@ -64,12 +67,44 @@ debouncedFn();
 // 500ms 后执行一次
 ```
 
+### 数字格式化
+
+```typescript
+import { toFormattedNumber } from '@planarcat/js-toolkit';
+
+// 基本使用
+console.log(toFormattedNumber(1234.5678));
+// 输出: 1234.5678
+
+// 保留两位小数
+console.log(toFormattedNumber(1234.5678, { decimalPlaces: 2 }));
+// 输出: 1234.57
+
+// 处理字符串
+console.log(toFormattedNumber('123.45abc'));
+// 输出: 123.45
+
+// 处理数组
+console.log(toFormattedNumber([123.456, '456.789']));
+// 输出: [123.456, 456.789]
+
+// 处理深层数组
+console.log(
+    toFormattedNumber([
+        [1, '1.23'],
+        ['45.67', [89.01, 'abc']],
+    ])
+);
+// 输出: [[1, 1.23], [45.67, [89.01, NaN]]]
+```
+
 ## API 文档
 
 详细的 API 文档请查看 [docs/](docs/) 目录下的模块文档：
 
 - [日期格式化](docs/functions/formatDate.md)
 - [函数防抖](docs/functions/debounce.md)
+- [数字格式化](docs/functions/toFormattedNumber.md)
 - [类型定义](docs/interfaces/)
 
 ### 生成文档
@@ -92,9 +127,12 @@ src/
 │   └── formatDate.ts      # 日期格式化函数
 ├── function/
 │   └── debounce.ts        # 函数防抖功能
+├── object/
+│   └── toFormattedNumber.ts  # 数字格式化函数
 ├── types/
 │   ├── date.ts            # 日期相关类型定义
-│   ├── debounce.ts        # 防抖相关类型定义
+│   ├── function.ts        # 防抖相关类型定义
+│   ├── object.ts          # 数字格式化相关类型定义
 │   └── index.ts           # 类型导出
 ├── utils/
 │   └── constants.ts       # 常量定义
@@ -158,6 +196,15 @@ npm run test:coverage
 
 ## 更新日志
 
+### v1.3.0
+
+- ✨ 添加数字格式化功能 `toFormattedNumber`
+- ✨ 支持处理任意输入类型（number、string、array、deep array）
+- ✨ 支持自定义小数位数和 NaN 显示
+- ✨ 支持深层数组递归处理
+- ✨ 完善的类型定义和 JSDoc 注释
+- ✨ 新增 object 分类目录结构
+
 ### v1.2.0
 
 - ✨ 优化日期格式化功能，支持使用 `dd` 标记直接显示周几
@@ -177,4 +224,4 @@ npm run test:coverage
 - ✨ 实现日期格式化功能 `formatDate`
 - ✨ 完整的 TypeScript 类型支持
 - ✨ 单元测试覆盖
-- ✨ 构建和发布配置
+- ✨ 构建和发布配置

package/dist/function/debounce.d.ts

@@ -3,7 +3,7 @@ import { DebounceOptions, DebouncedFunction } from "@/types/function";
  * 将函数进行防抖处理
  * @param fn - 需要防抖处理的函数
  * @param delay - 防抖延迟时间，默认100ms
- * @param options - 配置选项
+ * @param _options - 配置选项（当前未使用）
  * @returns 防抖处理后的函数，带有cancel方法
  */
 declare function debounce<T extends unknown[]>(fn: (...args: T) => void, delay?: number, _options?: DebounceOptions): DebouncedFunction<T>;

package/dist/function/debounce.js

@@ -4,7 +4,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * 将函数进行防抖处理
  * @param fn - 需要防抖处理的函数
  * @param delay - 防抖延迟时间，默认100ms
- * @param options - 配置选项
+ * @param _options - 配置选项（当前未使用）
  * @returns 防抖处理后的函数，带有cancel方法
  */
 function debounce(fn, delay = 100, _options = {}) {

package/dist/object/toFormattedNumber.d.ts

@@ -53,7 +53,7 @@
  * toFormattedNumber('abc', { nanDisplay: -1 }); // -1
  * ```
  */
-declare function toFormattedNumber(object: unknown[], options?: import("../types/object").ToFormattedNumberOptions): number[];
-declare function toFormattedNumber(object: unknown, options?: import("../types/object").ToFormattedNumberOptions): number | number[];
+declare function toFormattedNumber(object: unknown[], options?: import('../types/object').ToFormattedNumberOptions): number[];
+declare function toFormattedNumber(object: unknown, options?: import('../types/object').ToFormattedNumberOptions): number | 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;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,GAAG,MAAM,EAAE,CAAC;AAmDrB,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"toFormattedNumber.d.ts","sourceRoot":"","sources":["../../src/object/toFormattedNumber.ts"],"names":[],"mappings":"AA0CA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AAEH,iBAAS,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,OAAO,iBAAiB,EAAE,wBAAwB,GAAG,MAAM,EAAE,CAAC;AAEtH,iBAAS,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,iBAAiB,EAAE,wBAAwB,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;AAgD7H,eAAe,iBAAiB,CAAC"}

package/dist/object/toFormattedNumber.js

@@ -8,7 +8,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 +17,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) : NaN;
         }
-        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;

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,GAAG,CAAC;QACvC,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;AAmED,QAAQ;AACR,SAAS,iBAAiB,CACxB,MAAe,EACf,OAA4D;IAE5D,WAAW;IACX,MAAM,EAAE,aAAa,GAAG,IAAI,EAAE,UAAU,GAAG,GAAG,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IAEjE;;;;OAIG;IACH,MAAM,kBAAkB,GAAG,CAAC,GAAW,EAAU,EAAE;QACjD,UAAU;QACV,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YACf,OAAO,UAAU,CAAC;QACpB,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;;;;GAIG;AACH,SAAS,uBAAuB,CAAC,GAAW;IACxC,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;AACjC,CAAC;AAED;;;;GAIG;AACH,SAAS,eAAe,CAAC,KAAc;IACnC,QAAQ,OAAO,KAAK,EAAE,CAAC;QACnB,KAAK,QAAQ;YACT,OAAO,KAAK,CAAC;QACjB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACZ,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;YAC9C,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACzC,CAAC;QACD,KAAK,SAAS;YACV,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzB,KAAK,UAAU,CAAC;QAChB,KAAK,QAAQ;YACT,OAAO,GAAG,CAAC;QACf,KAAK,QAAQ;YACT,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACjB,OAAO,GAAG,CAAC;YACf,CAAC;YACD,cAAc;YACd,OAAO,GAAG,CAAC;QACf,KAAK,WAAW;YACZ,OAAO,GAAG,CAAC;QACf;YACI,OAAO,GAAG,CAAC;IACnB,CAAC;AACL,CAAC;AA6DD,QAAQ;AACR,SAAS,iBAAiB,CAAC,MAAe,EAAE,OAA4D;IACpG,WAAW;IACX,MAAM,EAAE,aAAa,GAAG,IAAI,EAAE,UAAU,GAAG,GAAG,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IAEjE;;;;OAIG;IACH,MAAM,kBAAkB,GAAG,CAAC,GAAW,EAAU,EAAE;QAC/C,UAAU;QACV,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YACb,OAAO,UAAU,CAAC;QACtB,CAAC;QAED,yBAAyB;QACzB,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;YACzB,gBAAgB;YAChB,OAAO,GAAG,CAAC;QACf,CAAC;aAAM,CAAC;YACJ,eAAe;YACf,OAAO,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;QAC9C,CAAC;IACL,CAAC,CAAC;IAEF;;;;OAIG;IACH,MAAM,YAAY,GAAG,CAAC,KAAc,EAAqB,EAAE;QACvD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,WAAW;YACX,OAAO,KAAK,CAAC,GAAG,CAAC,YAAY,CAAa,CAAC;QAC/C,CAAC;aAAM,CAAC;YACJ,QAAQ;YACR,MAAM,GAAG,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;YACnC,QAAQ;YACR,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC;QACnC,CAAC;IACL,CAAC,CAAC;IAEF,QAAQ;IACR,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,kBAAe,iBAAiB,CAAC"}

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,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}
+{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../../src/types/object.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,mBAAmB;IACjE;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@planarcat/js-toolkit",
-    "version": "1.3.0",
+    "version": "1.3.1",
     "description": "一个自用的带学习性质的（目前）现代化的 JavaScript/TypeScript 实用工具库，提供类型安全、高性能的常用函数，包括对象转换、日期处理、函数优化等开发常用工具。",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",

package/dist/object/toFormatNumber.d.ts

@@ -1,49 +0,0 @@
-import { ToFormattedNumberOptions, ToFormattedNumberStringOptions } from '../types/object';
-/**
- * 将任意对象转化为数字，然后根据格式化参数对转化后的数字进行格式化
- *
- * @param object - 要格式化的对象，可以是任何类型
- * @param options - 格式化选项
- * @returns 格式化后的数字或数字数组
- *
- * @example
- * ```typescript
- * // 单个值
- * toFormattedNumber(123.456); // 123.456
- * toFormattedNumber('123.456abc'); // 123.456
- * toFormattedNumber(true); // 1
- * toFormattedNumber(null); // NaN
- *
- * // 数组
- * toFormattedNumber([123.456, '456.789def']); // [123.456, 456.789]
- *
- * // 保留指定小数位
- * toFormattedNumber(123.456, { decimalPlaces: 2 }); // 123.46
- * ```
- */
-declare function toFormattedNumber(object: any[], options?: ToFormattedNumberOptions): number[];
-declare function toFormattedNumber(object: any, options?: ToFormattedNumberOptions): number;
-/**
- * 将任意对象转化为格式化的数字字符串
- *
- * @param object - 要格式化的对象，可以是任何类型
- * @param options - 格式化选项
- * @returns 格式化后的数字字符串或字符串数组
- *
- * @example
- * ```typescript
- * // 单个值
- * toFormattedNumberString(123.456); // '123.456'
- * toFormattedNumberString(123.4, { decimalPlaces: 2 }); // '123.40'
- *
- * // 数组
- * toFormattedNumberString([123.45, '456.7']); // ['123.45', '456.7']
- *
- * // 带前缀后缀
- * toFormattedNumberString(123.45, { prefix: '$', suffix: ' USD' }); // '$123.45 USD'
- * ```
- */
-declare function toFormattedNumberString(object: any[], options?: ToFormattedNumberStringOptions): string[];
-declare function toFormattedNumberString(object: any, options?: ToFormattedNumberStringOptions): string;
-export { toFormattedNumber, toFormattedNumberString };
-//# sourceMappingURL=toFormatNumber.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"toFormatNumber.d.ts","sourceRoot":"","sources":["../../src/object/toFormatNumber.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,8BAA8B,EAAE,MAAM,iBAAiB,CAAC;AA2C3F;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,iBAAS,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,MAAM,EAAE,CAAC;AACxF,iBAAS,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,MAAM,CAAC;AAsCpF;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,iBAAS,uBAAuB,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,OAAO,CAAC,EAAE,8BAA8B,GAAG,MAAM,EAAE,CAAC;AACpG,iBAAS,uBAAuB,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,8BAA8B,GAAG,MAAM,CAAC;AAoEhG,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/object/toFormatNumber.js

@@ -1,125 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.toFormattedNumberString = exports.toFormattedNumber = void 0;
-/**
- * 从字符串中提取数字部分
- * @param str - 输入字符串
- * @returns 提取的数字字符串
- */
-function extractNumberFromString(str) {
-    // 匹配数字体系：0~9，小数点，正负号等
-    const match = str.match(/[-+]?\d*\.?\d+/);
-    return match ? match[0] : '';
-}
-/**
- * 将单个值转换为数字
- * @param value - 输入值
- * @returns 转换后的数字
- */
-function convertToNumber(value) {
-    switch (typeof value) {
-        case 'number':
-            return value;
-        case 'string':
-            const numStr = extractNumberFromString(value);
-            return numStr ? Number(numStr) : NaN;
-        case 'boolean':
-            return value ? 1 : 0;
-        case 'function':
-        case 'symbol':
-            return NaN;
-        case 'object':
-            if (value === null) {
-                return NaN;
-            }
-            // 其他对象类型返回NaN
-            return NaN;
-        case 'undefined':
-            return NaN;
-        default:
-            return NaN;
-    }
-}
-function toFormattedNumber(object, options) {
-    const { decimalPlaces = true, nanDisplay = NaN } = options || {};
-    // 格式化单个数字
-    const formatSingleNumber = (num) => {
-        if (isNaN(num)) {
-            return nanDisplay;
-        }
-        if (decimalPlaces === true) {
-            // 保留所有小数位
-            return num;
-        }
-        else {
-            // 保留指定小数位
-            return Number(num.toFixed(decimalPlaces));
-        }
-    };
-    // 转换单个值
-    const processSingleValue = (value) => {
-        const num = convertToNumber(value);
-        return formatSingleNumber(num);
-    };
-    // 检查是否为数组
-    if (Array.isArray(object)) {
-        // 数组处理，返回数字数组
-        return object.map(processSingleValue);
-    }
-    else {
-        // 单个值处理，返回数字
-        return processSingleValue(object);
-    }
-}
-exports.toFormattedNumber = toFormattedNumber;
-function toFormattedNumberString(object, options) {
-    const { decimalPlaces = true, nanDisplay = 'NaN', zeroDisplay = '0', useLocale = false, customFormatter, suffix = '', prefix = '' } = options || {};
-    // 使用 toFormattedNumber 获取格式化后的数字
-    const numbers = toFormattedNumber(object, { decimalPlaces });
-    // 将单个数字格式化为字符串
-    const formatNumberToString = (num) => {
-        if (isNaN(num)) {
-            return nanDisplay;
-        }
-        if (num === 0) {
-            return zeroDisplay;
-        }
-        let strNum;
-        if (decimalPlaces === true) {
-            // 保留所有小数位
-            strNum = num.toString();
-        }
-        else {
-            // 保留指定小数位，不足补0
-            strNum = num.toFixed(decimalPlaces);
-        }
-        // 应用本地化
-        if (useLocale) {
-            const parts = strNum.split('.');
-            const integerPart = Number(parts[0]).toLocaleString();
-            if (parts.length > 1) {
-                strNum = `${integerPart}.${parts[1]}`;
-            }
-            else {
-                strNum = integerPart;
-            }
-        }
-        // 应用自定义处理函数
-        if (customFormatter) {
-            strNum = customFormatter(num);
-        }
-        // 添加前缀后缀
-        return `${prefix}${strNum}${suffix}`;
-    };
-    // 处理结果
-    if (Array.isArray(numbers)) {
-        // 数组处理，返回字符串数组
-        return numbers.map(formatNumberToString);
-    }
-    else {
-        // 单个值处理，返回字符串
-        return formatNumberToString(numbers);
-    }
-}
-exports.toFormattedNumberString = toFormattedNumberString;
-//# sourceMappingURL=toFormatNumber.js.map

package/dist/object/toFormatNumber.js.map

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

package/dist/object/toFormattedNumberString.d.ts

@@ -1,24 +0,0 @@
-/**
- * 将任意对象转化为格式化的数字字符串
- *
- * @param object - 要格式化的对象，可以是任何类型
- * @param options - 格式化选项
- * @returns 格式化后的数字字符串或字符串数组
- *
- * @example
- * ```typescript
- * // 单个值
- * toFormattedNumberString(123.456); // '123.456'
- * toFormattedNumberString(123.4, { decimalPlaces: 2 }); // '123.40'
- *
- * // 数组
- * toFormattedNumberString([123.45, '456.7']); // ['123.45', '456.7']
- *
- * // 带前缀后缀
- * toFormattedNumberString(123.45, { prefix: '$', suffix: ' USD' }); // '$123.45 USD'
- * ```
- */
-declare function toFormattedNumberString(object: any[], options?: import('../types/object').ToFormattedNumberStringOptions): string[];
-declare function toFormattedNumberString(object: any, options?: import('../types/object').ToFormattedNumberStringOptions): string | string[];
-export default toFormattedNumberString;
-//# sourceMappingURL=toFormattedNumberString.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"toFormattedNumberString.d.ts","sourceRoot":"","sources":["../../src/object/toFormattedNumberString.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,iBAAS,uBAAuB,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,OAAO,CAAC,EAAE,OAAO,iBAAiB,EAAE,8BAA8B,GAAG,MAAM,EAAE,CAAC;AAC9H,iBAAS,uBAAuB,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,OAAO,iBAAiB,EAAE,8BAA8B,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;AA0ErI,eAAe,uBAAuB,CAAC"}

package/dist/object/toFormattedNumberString.js

@@ -1,63 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const toFormattedNumber_1 = __importDefault(require("./toFormattedNumber"));
-function toFormattedNumberString(object, options) {
-    const { decimalPlaces = true, nanDisplay = 'NaN', zeroDisplay = '0', useLocale = false, customNumberProcessor, suffix = '', prefix = '' } = options || {};
-    // 使用 toFormattedNumber 获取未应用decimalPlaces的原始数字
-    const rawNumbers = (0, toFormattedNumber_1.default)(object, { decimalPlaces: true });
-    // 应用自定义数字处理方法，支持深层数组
-    const applyCustomNumberProcessor = (value) => {
-        if (Array.isArray(value)) {
-            return value.map(applyCustomNumberProcessor);
-        }
-        else {
-            return customNumberProcessor ? customNumberProcessor(value) : value;
-        }
-    };
-    // 应用自定义数字处理
-    const processedNumbers = applyCustomNumberProcessor(rawNumbers);
-    // 将单个值格式化为字符串，支持深层数组
-    const formatValueToString = (value) => {
-        if (Array.isArray(value)) {
-            // 递归处理深层数组
-            return value.map(formatValueToString);
-        }
-        else {
-            if (isNaN(value)) {
-                return `${prefix}${nanDisplay}${suffix}`;
-            }
-            if (value === 0) {
-                return `${prefix}${zeroDisplay}${suffix}`;
-            }
-            let strNum;
-            if (decimalPlaces === true) {
-                // 保留所有小数位
-                strNum = value.toString();
-            }
-            else {
-                // 保留指定小数位，不足补0
-                strNum = value.toFixed(decimalPlaces);
-            }
-            // 应用本地化
-            if (useLocale) {
-                const parts = strNum.split('.');
-                const integerPart = Number(parts[0]).toLocaleString();
-                if (parts.length > 1) {
-                    strNum = `${integerPart}.${parts[1]}`;
-                }
-                else {
-                    strNum = integerPart;
-                }
-            }
-            // 添加前缀后缀
-            return `${prefix}${strNum}${suffix}`;
-        }
-    };
-    // 直接调用格式化函数，它会处理数组和单个值
-    return formatValueToString(processedNumbers);
-}
-exports.default = toFormattedNumberString;
-//# sourceMappingURL=toFormattedNumberString.js.map

package/dist/object/toFormattedNumberString.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"toFormattedNumberString.js","sourceRoot":"","sources":["../../src/object/toFormattedNumberString.ts"],"names":[],"mappings":";;;;;AAAA,4EAAoD;AAyBpD,SAAS,uBAAuB,CAC5B,MAAW,EACX,OAAkE;IAElE,MAAM,EACF,aAAa,GAAG,IAAI,EACpB,UAAU,GAAG,KAAK,EAClB,WAAW,GAAG,GAAG,EACjB,SAAS,GAAG,KAAK,EACjB,qBAAqB,EACrB,MAAM,GAAG,EAAE,EACX,MAAM,GAAG,EAAE,EACd,GAAG,OAAO,IAAI,EAAE,CAAC;IAElB,+CAA+C;IAC/C,MAAM,UAAU,GAAG,IAAA,2BAAiB,EAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtE,qBAAqB;IACrB,MAAM,0BAA0B,GAAG,CAAC,KAAwB,EAAqB,EAAE;QAC/E,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,KAAK,CAAC,GAAG,CAAC,0BAA0B,CAAa,CAAC;QAC7D,CAAC;aAAM,CAAC;YACJ,OAAO,qBAAqB,CAAC,CAAC,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACxE,CAAC;IACL,CAAC,CAAC;IAEF,YAAY;IACZ,MAAM,gBAAgB,GAAG,0BAA0B,CAAC,UAAU,CAAC,CAAC;IAEhE,qBAAqB;IACrB,MAAM,mBAAmB,GAAG,CAAC,KAAwB,EAAqB,EAAE;QACxE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,WAAW;YACX,OAAO,KAAK,CAAC,GAAG,CAAC,mBAAmB,CAAa,CAAC;QACtD,CAAC;aAAM,CAAC;YACJ,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;gBACf,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,EAAE,CAAC;YAC7C,CAAC;YAED,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;gBACd,OAAO,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,EAAE,CAAC;YAC9C,CAAC;YAED,IAAI,MAAc,CAAC;YAEnB,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;gBACzB,UAAU;gBACV,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC9B,CAAC;iBAAM,CAAC;gBACJ,eAAe;gBACf,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;YAC1C,CAAC;YAED,QAAQ;YACR,IAAI,SAAS,EAAE,CAAC;gBACZ,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAChC,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC;gBACtD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACnB,MAAM,GAAG,GAAG,WAAW,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1C,CAAC;qBAAM,CAAC;oBACJ,MAAM,GAAG,WAAW,CAAC;gBACzB,CAAC;YACL,CAAC;YAED,SAAS;YACT,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;QACzC,CAAC;IACL,CAAC,CAAC;IAEF,uBAAuB;IACvB,OAAO,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;AACjD,CAAC;AAED,kBAAe,uBAAuB,CAAC"}

package/dist/types/debounce.d.ts

@@ -1,18 +0,0 @@
-export interface DebounceOptions {
-    /**
-     * 防抖延迟时间，默认500ms
-     */
-    delay?: number;
-}
-/**
- * 防抖处理后的函数接口
- * @template T - 函数类型
- */
-export interface DebouncedFunction<T extends unknown[]> {
-    (...args: T): void;
-    /**
-     * 取消当前正在执行的函数调用
-     */
-    cancel(): void;
-}
-//# sourceMappingURL=debounce.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"debounce.d.ts","sourceRoot":"","sources":["../../src/types/debounce.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,OAAO,EAAE;IACpD,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACnB;;OAEG;IACH,MAAM,IAAI,IAAI,CAAC;CAChB"}

package/dist/types/debounce.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=debounce.js.map

package/dist/types/debounce.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"debounce.js","sourceRoot":"","sources":["../../src/types/debounce.ts"],"names":[],"mappings":""}