@planarcat/js-toolkit 1.5.2 → 1.5.4

package/README.md

@@ -122,7 +122,7 @@ console.log(toFormattedNumberString(0, { zeroValue: '-' }));
 // 预处理函数
 console.log(
     toFormattedNumberString(0.1234, {
-        preProcessor: num => num * 100,
+        preProcessor: (original, num) => num * 100,
         suffix: '%',
     })
 );
@@ -131,7 +131,7 @@ console.log(
 // 函数类型前缀
 console.log(
     toFormattedNumberString(123.456, {
-        prefix: num => `$${Math.floor(num)}`,
+        prefix: (original, num, formatted) => `$${Math.floor(num)}`,
     })
 );
 // 输出: "$123123.456"
@@ -139,7 +139,7 @@ console.log(
 // 函数类型后缀
 console.log(
     toFormattedNumberString(123.456, {
-        suffix: num => `/${num.toFixed(0)}`,
+        suffix: (original, num, formatted) => `/${num.toFixed(0)}`,
     })
 );
 // 输出: "123.456/123"
@@ -248,6 +248,25 @@ npm run test:coverage
 
 ## 更新日志
 
+### v1.5.3
+
+- ✨ 增强了 `toFormattedNumberString` 函数，为 `preProcessor`、`prefix` 和 `suffix` 函数更新了参数顺序
+- ✨ `preProcessor` 现在接收两个参数：原始对象和转化后的 number
+- ✨ `prefix` 如果是函数，现在接收三个参数：原始对象、转化后的 number、格式化后的字符串
+- ✨ `suffix` 如果是函数，现在接收三个参数：原始对象、转化后的 number、格式化后的字符串
+- ✨ 增强了测试用例，验证新功能
+- ✨ 更新了文档，明确说明每个函数参数的用途
+
+### v1.5.2
+
+- ✨ 更新了函数返回值类型说明，明确区分数组和非数组输入的返回值
+- ✨ 生成了最新的 API 文档
+
+### v1.5.1
+
+- ✨ 更新了 README 文档，修复了参数名称
+- ✨ 生成了最新的 API 文档
+
 ### v1.5.0
 
 - ✨ 为 `toFormattedNumberString` 函数的前缀后缀添加函数类型支持

package/dist/object/toFormattedNumber.d.ts

@@ -13,8 +13,8 @@
  * @param options.nanValue - 当值为NaN时的显示，默认NaN
  *
  * @returns 格式化后的数字或数字数组
- *          - 如果输入是单个值，返回格式化后的数字
- *          - 如果输入是数组，返回格式化后的数字数组
+ *          - 当传入的 object 为非数组时，返回 number
+ *          - 当传入的 object 为数组时，返回 number[]
  *          - 支持深层数组递归处理
  *
  * @example

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

@@ -1 +1 @@
-{"version":3,"file":"toFormattedNumberString.d.ts","sourceRoot":"","sources":["../../src/object/toFormattedNumberString.ts"],"names":[],"mappings":"AAyEA,iBAAS,uBAAuB,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,OAAO,iBAAiB,EAAE,8BAA8B,GAAG,MAAM,EAAE,CAAC;AAElI,iBAAS,uBAAuB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,iBAAiB,EAAE,8BAA8B,GAAG,MAAM,CAAC;AAyH9H,eAAe,uBAAuB,CAAC"}
+{"version":3,"file":"toFormattedNumberString.d.ts","sourceRoot":"","sources":["../../src/object/toFormattedNumberString.ts"],"names":[],"mappings":"AA0EA,iBAAS,uBAAuB,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,OAAO,iBAAiB,EAAE,8BAA8B,GAAG,MAAM,EAAE,CAAC;AAElI,iBAAS,uBAAuB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,iBAAiB,EAAE,8BAA8B,GAAG,MAAM,CAAC;AAiI9H,eAAe,uBAAuB,CAAC"}

package/dist/object/toFormattedNumberString.js

@@ -19,14 +19,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * @param options.zeroValue - 当值为0时的显示，默认'0'
  * @param options.localized - 是否使用本地化格式，默认false
  * @param options.preProcessor - 预处理函数，在数字转换后、字符串格式化前应用
- * @param options.prefix - 前缀，可以是字符串或函数，默认''
- *                          如果是函数，会接收格式化前的数字作为参数，返回字符串作为前缀
- * @param options.suffix - 后缀，可以是字符串或函数，默认''
- *                          如果是函数，会接收格式化前的数字作为参数，返回字符串作为后缀
+ *                               接收两个参数：原始对象和转化后的数字
+ * @param options.prefix - 前缀，字符串或函数
+ *                          如果是函数，会接收三个参数：原始对象、转化后的数字、格式化后的字符串，返回字符串作为前缀
+ * @param options.suffix - 后缀，字符串或函数
+ *                          如果是函数，会接收三个参数：原始对象、转化后的数字、格式化后的字符串，返回字符串作为后缀
  *
  * @returns 格式化后的数字字符串或字符串数组
- *          - 如果输入是单个值，返回格式化后的字符串
- *          - 如果输入是数组，返回格式化后的字符串数组
+ *          - 当传入的 object 为非数组时，返回 string
+ *          - 当传入的 object 为数组时，返回 string[]
  *          - 支持深层数组递归处理
  *
  * @example
@@ -51,18 +52,18 @@ Object.defineProperty(exports, "__esModule", { value: true });
  *
  * // 预处理函数
  * toFormattedNumberString(0.1234, {
- *   preProcessor: (num) => num * 100,
+ *   preProcessor: (original, num) => num * 100,
  *   suffix: '%'
  * }); // "12.34%"
  *
  * // 函数类型前缀
  * toFormattedNumberString(123.456, {
- *   prefix: (num) => `$${Math.floor(num)}`
+ *   prefix: (original, num, formatted) => `$${Math.floor(num)}`
  * }); // "$123123.456"
  *
  * // 函数类型后缀
  * toFormattedNumberString(123.456, {
- *   suffix: (num) => `/${num.toFixed(0)}`
+ *   suffix: (original, num, formatted) => `/${num.toFixed(0)}`
  * }); // "123.456/123"
  *
  * // 处理数组
@@ -77,42 +78,46 @@ const toFormattedNumber_1 = __importDefault(require("./toFormattedNumber"));
 // 主函数实现
 function toFormattedNumberString(object, options) {
     // 解构并设置默认值
-    const { decimalPlaces = true, nanValue = 'NaN', zeroValue = '0', localized = false, preProcessor, prefix = '', suffix = '' } = options || {};
-    /**
-     * 处理前缀或后缀，可以是字符串或函数
-     * @param prefixOrSuffix - 前缀或后缀，可以是字符串或函数
-     * @param num - 要传递给函数的数字
-     * @returns 处理后的前缀或后缀字符串
-     */
-    const processPrefixSuffix = (prefixOrSuffix, num) => {
-        if (typeof prefixOrSuffix === 'function') {
-            return prefixOrSuffix(num);
-        }
-        return prefixOrSuffix;
-    };
+    const { decimalPlaces = true, nanValue = 'NaN', zeroValue = '0', localized, preProcessor, prefix = '', suffix = '' } = options || {};
     /**
      * 添加前缀和后缀
-     * @param str - 要添加前缀后缀的字符串
-     * @param num - 要传递给前缀后缀函数的数字
+     * @param prefix - 前缀
+     * @param suffix - 后缀
+     * @param formatted - 格式化后的字符串
+     * @param converted - 转化后的数字
+     * @param original - 原始对象
      * @returns 添加了前缀后缀的字符串
      */
-    const addPrefixSuffix = (str, num) => {
-        const processedPrefix = processPrefixSuffix(prefix, num);
-        const processedSuffix = processPrefixSuffix(suffix, num);
-        return `${processedPrefix}${str}${processedSuffix}`;
+    const addPrefixSuffix = (prefix, suffix, formatted, converted, original) => {
+        let processedPrefix;
+        if (typeof prefix === 'function') {
+            processedPrefix = prefix(original, converted, formatted);
+        }
+        else {
+            processedPrefix = prefix;
+        }
+        let processedSuffix;
+        if (typeof suffix === 'function') {
+            processedSuffix = suffix(original, converted, formatted);
+        }
+        else {
+            processedSuffix = suffix;
+        }
+        return `${processedPrefix}${formatted}${processedSuffix}`;
     };
     /**
      * 将单个数字转换为格式化字符串
-     * @param num - 要转换的数字
+     * @param converted - 转化后的数字
+     * @param original - 原始对象
      * @returns 格式化后的字符串
      */
-    const convertNumberToString = (num) => {
+    const convertNumberToString = (converted, original) => {
         // 处理0情况
-        if (num === 0) {
-            return addPrefixSuffix(zeroValue, num);
+        if (converted === 0) {
+            return addPrefixSuffix(prefix, suffix, zeroValue, converted, original);
         }
         // 应用预处理函数
-        const processedNum = preProcessor ? preProcessor(num) : num;
+        const processedNum = preProcessor ? preProcessor(original, converted) : converted;
         // 格式化数字为字符串
         let strNum;
         if (localized) {
@@ -141,7 +146,7 @@ function toFormattedNumberString(object, options) {
             }
         }
         // 添加前缀和后缀
-        return addPrefixSuffix(strNum, processedNum);
+        return addPrefixSuffix(prefix, suffix, strNum, processedNum, original);
     };
     /**
      * 检查字符串是否包含数字
@@ -154,18 +159,19 @@ function toFormattedNumberString(object, options) {
     /**
      * 递归处理值，转换为格式化字符串
      * @param value - 要处理的值
+     * @param original - 原始对象或数组元素
      * @returns 格式化后的字符串或字符串数组
      */
-    const processValue = (value) => {
+    const processValue = (value, original = object) => {
         if (Array.isArray(value)) {
             // 递归处理数组
-            return value.map(processValue);
+            return value.map((item, _index) => processValue(item, item));
         }
         else {
             // 检查是否为无数字的字符串
             if (typeof value === 'string' && !hasNumbers(value)) {
                 // 无数字的字符串返回0
-                return addPrefixSuffix(zeroValue, 0);
+                return addPrefixSuffix(prefix, suffix, zeroValue, 0, original);
             }
             // 对于其他类型，首先将输入转换为数字
             // 注意：toFormattedNumber对于单个值会返回number类型
@@ -176,10 +182,10 @@ function toFormattedNumberString(object, options) {
             // 检查是否为NaN
             if (isNaN(num)) {
                 // 其他NaN情况，使用nanValue
-                return addPrefixSuffix(nanValue, num);
+                return addPrefixSuffix(prefix, suffix, nanValue, num, original);
             }
             // 正常数字转换
-            return convertNumberToString(num);
+            return convertNumberToString(num, original);
         }
     };
     // 处理输入值

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":";;;;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsEG;AACH,4EAAoD;AAMpD,QAAQ;AACR,SAAS,uBAAuB,CAAC,MAAe,EAAE,OAAkE;IAChH,WAAW;IACX,MAAM,EAAE,aAAa,GAAG,IAAI,EAAE,QAAQ,GAAG,KAAK,EAAE,SAAS,GAAG,GAAG,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,EAAE,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IAErI;;;;;;;;OAQG;IACH,MAAM,eAAe,GAAG,CACpB,MAAsF,EACtF,MAAsF,EACtF,SAAiB,EACjB,SAAiB,EACjB,QAAiB,EACX,EAAE;QACR,IAAI,eAAuB,CAAC;QAC5B,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;YAC/B,eAAe,GAAG,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QAC7D,CAAC;aAAM,CAAC;YACJ,eAAe,GAAG,MAAM,CAAC;QAC7B,CAAC;QACD,IAAI,eAAuB,CAAC;QAC5B,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;YAC/B,eAAe,GAAG,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QAC7D,CAAC;aAAM,CAAC;YACJ,eAAe,GAAG,MAAM,CAAC;QAC7B,CAAC;QACD,OAAO,GAAG,eAAe,GAAG,SAAS,GAAG,eAAe,EAAE,CAAC;IAC9D,CAAC,CAAC;IAEF;;;;;OAKG;IACH,MAAM,qBAAqB,GAAG,CAAC,SAAiB,EAAE,QAAiB,EAAU,EAAE;QAC3E,QAAQ;QACR,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;YAClB,OAAO,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC3E,CAAC;QAED,UAAU;QACV,MAAM,YAAY,GAAG,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAElF,YAAY;QACZ,IAAI,MAAc,CAAC;QACnB,IAAI,SAAS,EAAE,CAAC;YACZ,UAAU;YACV,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;gBACzB,UAAU;gBACV,MAAM,GAAG,YAAY,CAAC,cAAc,EAAE,CAAC;YAC3C,CAAC;iBAAM,CAAC;gBACJ,gBAAgB;gBAChB,MAAM,GAAG,YAAY,CAAC,cAAc,CAAC,SAAS,EAAE;oBAC5C,qBAAqB,EAAE,aAAa;oBACpC,qBAAqB,EAAE,aAAa;iBACvC,CAAC,CAAC;YACP,CAAC;QACL,CAAC;aAAM,CAAC;YACJ,WAAW;YACX,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;gBACzB,UAAU;gBACV,MAAM,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC;YACrC,CAAC;iBAAM,CAAC;gBACJ,gBAAgB;gBAChB,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;YACjD,CAAC;QACL,CAAC;QAED,UAAU;QACV,OAAO,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;IAC3E,CAAC,CAAC;IAEF;;;;OAIG;IACH,MAAM,UAAU,GAAG,CAAC,GAAW,EAAW,EAAE;QACxC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC,CAAC;IAEF;;;;;OAKG;IACH,MAAM,YAAY,GAAG,CAAC,KAAc,EAAE,WAAoB,MAAM,EAAqB,EAAE;QACnF,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,SAAS;YACT,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAa,CAAC;QAC7E,CAAC;aAAM,CAAC;YACJ,eAAe;YACf,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBAClD,aAAa;gBACb,OAAO,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;YACnE,CAAC;YAED,oBAAoB;YACpB,uCAAuC;YACvC,MAAM,GAAG,GAAG,IAAA,2BAAiB,EAAC,KAAK,EAAE;gBACjC,aAAa;gBACb,QAAQ,EAAE,GAAG;aAChB,CAAW,CAAC;YAEb,WAAW;YACX,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBACb,qBAAqB;gBACrB,OAAO,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;YACpE,CAAC;YAED,SAAS;YACT,OAAO,qBAAqB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAChD,CAAC;IACL,CAAC,CAAC;IAEF,QAAQ;IACR,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,kBAAe,uBAAuB,CAAC"}

package/dist/types/object.d.ts

@@ -41,17 +41,20 @@ export interface ToFormattedNumberStringOptions extends CommonFormatOptions {
     /**
      * 预处理函数，在对象被处理为数字后调用，
      * 默认无。
+     * 接收参数：原始对象、转化后的数字，返回处理后的数字
      */
-    preProcessor?: (num: number) => number;
+    preProcessor?: (original: unknown, converted: number) => number;
     /**
      * 前缀，可以是字符串或函数，
      * 默认''。
+     * 如果是函数，接收参数：原始对象、转化后数字、格式化后的字符串，返回字符串作为前缀
      */
-    prefix?: string | ((value: number) => string);
+    prefix?: string | ((original: unknown, converted: number, formatted: string) => string);
     /**
      * 后缀，可以是字符串或函数，
      * 默认''。
+     * 如果是函数，接收参数：原始对象、转化后数字、格式化后的字符串，返回字符串作为后缀
      */
-    suffix?: string | ((value: number) => string);
+    suffix?: string | ((original: unknown, converted: number, formatted: string) => string);
 }
 //# sourceMappingURL=object.d.ts.map

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;IAChC;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,mBAAmB;IACjE;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,8BAA+B,SAAQ,mBAAmB;IACvE;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IACvC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;IAC9C;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;CACjD"}
+{"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,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,8BAA+B,SAAQ,mBAAmB;IACvE;;;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;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;IACxF;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;CAC3F"}

package/package.json

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