@planarcat/js-toolkit 1.5.1 → 1.5.3

package/README.md

@@ -110,7 +110,7 @@ console.log(toFormattedNumberString(1234.5678, { prefix: '$', suffix: ' USD' }))
 // 输出: "$1234.5678 USD"
 
 // 本地化格式
-console.log(toFormattedNumberString(1234567.89, { useLocalizedFormat: true }));
+console.log(toFormattedNumberString(1234567.89, { localized: true }));
 // 输出: "1,234,567.89"
 
 // 自定义NaN和0显示
@@ -248,6 +248,24 @@ npm run test:coverage
 
 ## 更新日志
 
+### v1.5.3
+
+- ✨ 增强了 `toFormattedNumberString` 函数，为 `preProcessor` 和 `suffix` 函数添加了更多参数
+- ✨ `preProcessor` 现在接收两个参数：转化后的 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
@@ -55,7 +55,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 | 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;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,CAAC;AAgDlH,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) : 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;

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;AAqED,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;;;;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,CAAC,CAAC;QACvC,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;AA+DD,QAAQ;AACR,SAAS,iBAAiB,CAAC,MAAe,EAAE,OAA4D;IACpG,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;QAC/C,UAAU;QACV,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YACb,OAAO,QAAQ,CAAC;QACpB,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/object/toFormattedNumberString.d.ts

@@ -1,4 +1,4 @@
-declare function toFormattedNumberString(object: unknown[], options?: import("../types/object").ToFormattedNumberStringOptions): string[];
-declare function toFormattedNumberString(object: unknown, options?: import("../types/object").ToFormattedNumberStringOptions): string | string[];
+declare function toFormattedNumberString(object: unknown[], options?: import('../types/object').ToFormattedNumberStringOptions): string[];
+declare function toFormattedNumberString(object: unknown, options?: import('../types/object').ToFormattedNumberStringOptions): string;
 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":"AAuEA,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,GAAG,MAAM,EAAE,CAAC;AAuIrB,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;AAyI9H,eAAe,uBAAuB,CAAC"}

package/dist/object/toFormattedNumberString.js

@@ -17,16 +17,17 @@ Object.defineProperty(exports, "__esModule", { value: true });
  *                               number: 保留指定小数位，不够时补0
  * @param options.nanValue - 当值为NaN时的显示，默认'NaN'
  * @param options.zeroValue - 当值为0时的显示，默认'0'
- * @param options.useLocalizedFormat - 是否使用本地化格式，默认false
+ * @param options.localized - 是否使用本地化格式，默认false
  * @param options.preProcessor - 预处理函数，在数字转换后、字符串格式化前应用
+ *                               接收两个参数：转化后的数字和原始对象
  * @param options.prefix - 前缀，可以是字符串或函数，默认''
- *                          如果是函数，会接收格式化前的数字作为参数，返回字符串作为前缀
+ *                          如果是函数，会接收格式化前的数字和原始对象作为参数，返回字符串作为前缀
  * @param options.suffix - 后缀，可以是字符串或函数，默认''
- *                          如果是函数，会接收格式化前的数字作为参数，返回字符串作为后缀
+ *                          如果是函数，会接收三个参数：格式化后的字符串、转化后格式化前的数字、原始对象，返回字符串作为后缀
  *
  * @returns 格式化后的数字字符串或字符串数组
- *          - 如果输入是单个值，返回格式化后的字符串
- *          - 如果输入是数组，返回格式化后的字符串数组
+ *          - 当传入的 object 为非数组时，返回 string
+ *          - 当传入的 object 为数组时，返回 string[]
  *          - 支持深层数组递归处理
  *
  * @example
@@ -41,6 +42,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * 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显示
@@ -75,16 +78,25 @@ const toFormattedNumber_1 = __importDefault(require("./toFormattedNumber"));
 // 主函数实现
 function toFormattedNumberString(object, options) {
     // 解构并设置默认值
-    const { decimalPlaces = true, nanValue = "NaN", zeroValue = "0", useLocalizedFormat = false, preProcessor, prefix = "", suffix = "", } = options || {};
+    const { decimalPlaces = true, nanValue = 'NaN', zeroValue = '0', localized = false, preProcessor, prefix = '', suffix = '' } = options || {};
     /**
      * 处理前缀或后缀，可以是字符串或函数
      * @param prefixOrSuffix - 前缀或后缀，可以是字符串或函数
      * @param num - 要传递给函数的数字
+     * @param formatted - 格式化后的字符串（仅用于后缀函数）
+     * @param original - 原始对象
      * @returns 处理后的前缀或后缀字符串
      */
-    const processPrefixSuffix = (prefixOrSuffix, num) => {
-        if (typeof prefixOrSuffix === "function") {
-            return prefixOrSuffix(num);
+    const processPrefixSuffix = (prefixOrSuffix, num, formatted, original = object) => {
+        if (typeof prefixOrSuffix === 'function') {
+            if (formatted !== undefined) {
+                // 后缀函数，接收三个参数
+                return prefixOrSuffix(formatted, num, original);
+            }
+            else {
+                // 前缀函数，接收两个参数
+                return prefixOrSuffix(num, original);
+            }
         }
         return prefixOrSuffix;
     };
@@ -92,28 +104,30 @@ function toFormattedNumberString(object, options) {
      * 添加前缀和后缀
      * @param str - 要添加前缀后缀的字符串
      * @param num - 要传递给前缀后缀函数的数字
+     * @param original - 原始对象
      * @returns 添加了前缀后缀的字符串
      */
-    const addPrefixSuffix = (str, num) => {
-        const processedPrefix = processPrefixSuffix(prefix, num);
-        const processedSuffix = processPrefixSuffix(suffix, num);
+    const addPrefixSuffix = (str, num, original = object) => {
+        const processedPrefix = processPrefixSuffix(prefix, num, undefined, original);
+        const processedSuffix = processPrefixSuffix(suffix, num, str, original);
         return `${processedPrefix}${str}${processedSuffix}`;
     };
     /**
      * 将单个数字转换为格式化字符串
      * @param num - 要转换的数字
+     * @param original - 原始对象
      * @returns 格式化后的字符串
      */
-    const convertNumberToString = (num) => {
+    const convertNumberToString = (num, original) => {
         // 处理0情况
         if (num === 0) {
-            return addPrefixSuffix(zeroValue, num);
+            return addPrefixSuffix(zeroValue, num, original);
         }
         // 应用预处理函数
-        const processedNum = preProcessor ? preProcessor(num) : num;
+        const processedNum = preProcessor ? preProcessor(num, original) : num;
         // 格式化数字为字符串
         let strNum;
-        if (useLocalizedFormat) {
+        if (localized) {
             // 使用本地化格式
             if (decimalPlaces === true) {
                 // 保留所有小数位
@@ -139,7 +153,7 @@ function toFormattedNumberString(object, options) {
             }
         }
         // 添加前缀和后缀
-        return addPrefixSuffix(strNum, processedNum);
+        return addPrefixSuffix(strNum, processedNum, original);
     };
     /**
      * 检查字符串是否包含数字
@@ -152,18 +166,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)) {
+            if (typeof value === 'string' && !hasNumbers(value)) {
                 // 无数字的字符串返回0
-                return addPrefixSuffix(zeroValue, 0);
+                return addPrefixSuffix(zeroValue, 0, original);
             }
             // 对于其他类型，首先将输入转换为数字
             // 注意：toFormattedNumber对于单个值会返回number类型
@@ -174,10 +189,10 @@ function toFormattedNumberString(object, options) {
             // 检查是否为NaN
             if (isNaN(num)) {
                 // 其他NaN情况，使用nanValue
-                return addPrefixSuffix(nanValue, num);
+                return addPrefixSuffix(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":"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"}

package/dist/types/object.d.ts

@@ -34,24 +34,24 @@ export interface ToFormattedNumberStringOptions extends CommonFormatOptions {
      */
     zeroValue?: string;
     /**
-     * 是否显示本地化，
+     * 是否使用本地化格式，
      * 默认false。
      */
-    useLocalizedFormat?: boolean;
+    localized?: boolean;
     /**
      * 预处理函数，在对象被处理为数字后调用，
      * 默认无。
      */
-    preProcessor?: (num: number) => number;
+    preProcessor?: (num: number, original: unknown) => number;
     /**
      * 前缀，可以是字符串或函数，
      * 默认''。
      */
-    prefix?: string | ((value: number) => string);
+    prefix?: string | ((value: number, original: unknown) => string);
     /**
      * 后缀，可以是字符串或函数，
      * 默认''。
      */
-    suffix?: string | ((value: number) => string);
+    suffix?: string | ((formatted: string, value: number, original: unknown) => 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;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,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;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;CAC/C"}
+{"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,EAAE,QAAQ,EAAE,OAAO,KAAK,MAAM,CAAC;IAC1D;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,KAAK,MAAM,CAAC,CAAC;IACjE;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,KAAK,MAAM,CAAC,CAAC;CACvF"}

package/package.json

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