react-util-tools 1.0.26 → 1.0.28

package/dist/index.cjs

@@ -30,7 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  Decimal: () => import_decimal.default,
+  Decimal: () => import_decimal2.default,
   XLSX: () => XLSX,
   abs: () => abs,
   add: () => add,
@@ -64,6 +64,9 @@ __export(index_exports, {
   formatUTC: () => formatUTC,
   formatUTCDateOnly: () => formatUTCDateOnly,
   formatUTCTimeOnly: () => formatUTCTimeOnly,
+  formateAmount: () => formateAmount,
+  formateFaitAmount: () => formateFaitAmount,
+  formatePrecision: () => formatePrecision,
   fromBase64: () => fromBase64,
   fromUTC: () => fromUTC,
   getAllCookies: () => getAllCookies,
@@ -120,6 +123,7 @@ __export(index_exports, {
   greaterThanOrEqual: () => greaterThanOrEqual,
   hasCookie: () => hasCookie,
   includes: () => includes,
+  integerTokenArr: () => integerTokenArr,
   isAfterDate: () => isAfterDate,
   isAndroid: () => isAndroid,
   isBeforeDate: () => isBeforeDate,
@@ -161,6 +165,7 @@ __export(index_exports, {
   readExcelToJSON: () => readExcelToJSON,
   readFile: () => readFile,
   removeCookie: () => removeCookie,
+  removeInvalidZero: () => removeInvalidZero,
   removeSpaces: () => removeSpaces,
   repeat: () => repeat,
   replaceAll: () => replaceAll,
@@ -184,6 +189,7 @@ __export(index_exports, {
   titleCase: () => titleCase,
   toBase64: () => toBase64,
   toISOString: () => toISOString,
+  toLocalString: () => toLocalString,
   toLowerCase: () => toLowerCase,
   toUTC: () => toUTC,
   toUpperCase: () => toUpperCase,
@@ -191,6 +197,7 @@ __export(index_exports, {
   trimEnd: () => trimEnd,
   trimStart: () => trimStart,
   truncate: () => truncate,
+  tryRun: () => tryRun,
   unescapeHtml: () => unescapeHtml,
   unmaskEmail: () => unmaskEmail,
   utils: () => utils2,
@@ -464,6 +471,7 @@ function getDeviceInfo() {
 }
 
 // src/format/index.ts
+var import_decimal = __toESM(require("decimal.js"), 1);
 function formatMoney(amount, options = {}) {
   const {
     decimals = 2,
@@ -471,20 +479,19 @@ function formatMoney(amount, options = {}) {
     separator = ",",
     decimalPoint = "."
   } = options;
-  const num = typeof amount === "string" ? parseFloat(amount) : amount;
-  if (isNaN(num)) {
-    return `${symbol}0${decimalPoint}${"0".repeat(decimals)}`;
-  }
-  const isNegative = num < 0;
-  const absNum = Math.abs(num);
-  const fixed = absNum.toFixed(decimals);
-  const [integerPart, decimalPart] = fixed.split(".");
-  const formattedInteger = integerPart.replace(/\B(?=(\d{3})+(?!\d))/g, separator);
-  let result = symbol + formattedInteger;
-  if (decimals > 0 && decimalPart) {
-    result += decimalPoint + decimalPart;
-  }
-  return isNegative ? `-${result}` : result;
+  return tryRun(() => {
+    const dec = new import_decimal.default(amount);
+    const isNegative = dec.isNegative();
+    const absDec = dec.abs();
+    const fixed = absDec.toFixed(decimals, import_decimal.default.ROUND_DOWN);
+    const [integerPart, decimalPart] = fixed.split(".");
+    const formattedInteger = integerPart.replace(/\B(?=(\d{3})+(?!\d))/g, separator);
+    let result = symbol + formattedInteger;
+    if (decimals > 0 && decimalPart) {
+      result += decimalPoint + decimalPart;
+    }
+    return isNegative ? `-${result}` : result;
+  }) ?? `${symbol}0${decimalPoint}${"0".repeat(decimals)}`;
 }
 function parseMoney(formattedAmount) {
   if (!formattedAmount || typeof formattedAmount !== "string") {
@@ -495,68 +502,70 @@ function parseMoney(formattedAmount) {
   return isNaN(num) ? 0 : num;
 }
 function formatNumber(amount, decimals = 2) {
-  const num = typeof amount === "string" ? parseFloat(amount) : amount;
-  if (isNaN(num)) {
-    return "0." + "0".repeat(decimals);
-  }
-  const fixed = num.toFixed(decimals);
-  const [integerPart, decimalPart] = fixed.split(".");
-  const formattedInteger = integerPart.replace(/\B(?=(\d{3})+(?!\d))/g, ",");
-  return decimals > 0 && decimalPart ? `${formattedInteger}.${decimalPart}` : formattedInteger;
+  return tryRun(() => {
+    const dec = new import_decimal.default(amount);
+    const fixed = dec.toFixed(decimals, import_decimal.default.ROUND_DOWN);
+    const [integerPart, decimalPart] = fixed.split(".");
+    const formattedInteger = integerPart.replace(/\B(?=(\d{3})+(?!\d))/g, ",");
+    return decimals > 0 && decimalPart ? `${formattedInteger}.${decimalPart}` : formattedInteger;
+  }) ?? "0." + "0".repeat(decimals);
 }
 function formatMoneyToChinese(amount) {
-  const num = typeof amount === "string" ? parseFloat(amount) : amount;
-  if (isNaN(num) || num < 0) {
-    return "\u96F6\u5143\u6574";
-  }
-  const digits = ["\u96F6", "\u58F9", "\u8D30", "\u53C1", "\u8086", "\u4F0D", "\u9646", "\u67D2", "\u634C", "\u7396"];
-  const units = ["", "\u62FE", "\u4F70", "\u4EDF"];
-  const bigUnits = ["", "\u4E07", "\u4EBF", "\u5146"];
-  const decimalUnits = ["\u89D2", "\u5206"];
-  const [integerPart, decimalPart] = num.toFixed(2).split(".");
-  let result = "";
-  if (integerPart === "0") {
-    result = "\u96F6\u5143";
-  } else {
-    const integerStr = integerPart;
-    const len = integerStr.length;
-    let zeroCount = 0;
-    for (let i = 0; i < len; i++) {
-      const digit = parseInt(integerStr[i]);
-      const unitIndex = (len - i - 1) % 4;
-      const bigUnitIndex = Math.floor((len - i - 1) / 4);
-      if (digit === 0) {
-        zeroCount++;
-      } else {
-        if (zeroCount > 0) {
-          result += "\u96F6";
+  return tryRun(() => {
+    const dec = new import_decimal.default(amount);
+    if (dec.isNegative()) {
+      return "\u96F6\u5143\u6574";
+    }
+    const num = dec.toNumber();
+    const digits = ["\u96F6", "\u58F9", "\u8D30", "\u53C1", "\u8086", "\u4F0D", "\u9646", "\u67D2", "\u634C", "\u7396"];
+    const units = ["", "\u62FE", "\u4F70", "\u4EDF"];
+    const bigUnits = ["", "\u4E07", "\u4EBF", "\u5146"];
+    const decimalUnits = ["\u89D2", "\u5206"];
+    const [integerPart, decimalPart] = num.toFixed(2).split(".");
+    let result = "";
+    if (integerPart === "0") {
+      result = "\u96F6\u5143";
+    } else {
+      const integerStr = integerPart;
+      const len = integerStr.length;
+      let zeroCount = 0;
+      for (let i = 0; i < len; i++) {
+        const digit = parseInt(integerStr[i]);
+        const unitIndex = (len - i - 1) % 4;
+        const bigUnitIndex = Math.floor((len - i - 1) / 4);
+        if (digit === 0) {
+          zeroCount++;
+        } else {
+          if (zeroCount > 0) {
+            result += "\u96F6";
+          }
+          result += digits[digit] + units[unitIndex];
+          zeroCount = 0;
         }
-        result += digits[digit] + units[unitIndex];
-        zeroCount = 0;
-      }
-      if (unitIndex === 0 && bigUnitIndex > 0) {
-        if (result[result.length - 1] !== bigUnits[bigUnitIndex]) {
-          result += bigUnits[bigUnitIndex];
+        if (unitIndex === 0 && bigUnitIndex > 0) {
+          if (result[result.length - 1] !== bigUnits[bigUnitIndex]) {
+            result += bigUnits[bigUnitIndex];
+          }
         }
       }
+      result += "\u5143";
     }
-    result += "\u5143";
-  }
-  if (decimalPart && decimalPart !== "00") {
-    const jiao = parseInt(decimalPart[0]);
-    const fen = parseInt(decimalPart[1]);
-    if (jiao > 0) {
-      result += digits[jiao] + decimalUnits[0];
-    } else if (fen > 0) {
-      result += "\u96F6";
-    }
-    if (fen > 0) {
-      result += digits[fen] + decimalUnits[1];
+    if (decimalPart && decimalPart !== "00") {
+      const jiao = parseInt(decimalPart[0]);
+      const fen = parseInt(decimalPart[1]);
+      if (jiao > 0) {
+        result += digits[jiao] + decimalUnits[0];
+      } else if (fen > 0) {
+        result += "\u96F6";
+      }
+      if (fen > 0) {
+        result += digits[fen] + decimalUnits[1];
+      }
+    } else {
+      result += "\u6574";
     }
-  } else {
-    result += "\u6574";
-  }
-  return result;
+    return result;
+  }) ?? "\u96F6\u5143\u6574";
 }
 function formatPercent(value, options = {}) {
   const { decimals = 2, multiply: multiply2 = true } = options;
@@ -599,6 +608,118 @@ function unmaskEmail(maskedEmail, originalEmail) {
   }
   return maskedEmail;
 }
+function toLocalString(value) {
+  let result = value;
+  if (Number(value) >= 1e3) {
+    result = Number(value).toLocaleString("en-US");
+  } else {
+    result = value;
+  }
+  return result;
+}
+var integerTokenArr = ["SATS"];
+function removeInvalidZero(num) {
+  let result = num;
+  if (num.includes(".")) {
+    result = result.replace(/\.?0+$/, "");
+  }
+  return result;
+}
+function formatePrecision(n, precision, tokenSymbol) {
+  if (!isNaN(Number(n))) {
+    let prec = precision && precision <= 8 ? precision : 8;
+    if (tokenSymbol && integerTokenArr.includes(tokenSymbol)) {
+      prec = 0;
+    }
+    return new import_decimal.default(Number(n)).toFixed(prec, import_decimal.default.ROUND_DOWN);
+  }
+  const num = new import_decimal.default(n).toNumber();
+  return num;
+}
+function formateAmount({
+  num = 0,
+  precision = 8,
+  tokenSymbol = "",
+  type = "0"
+}) {
+  return tryRun(() => {
+    const dec = new import_decimal.default(num);
+    const { length: length2 } = dec.abs().floor().toString();
+    const pres = precision;
+    precision = precision > 8 ? 9 : precision + 1;
+    if (length2 >= precision) {
+      let value = "";
+      if (dec.greaterThan(1)) {
+        value = dec.toFixed(8, import_decimal.default.ROUND_DOWN);
+      } else {
+        value = dec.toFixed(precision - length2, import_decimal.default.ROUND_DOWN);
+      }
+      value = formatePrecision(value, pres).toString();
+      if (integerTokenArr.includes(tokenSymbol)) {
+        value = new import_decimal.default(value).toFixed(0, import_decimal.default.ROUND_CEIL);
+      }
+      let result = "";
+      if (typeof value === "string") {
+        if (value.includes(".")) {
+          result = value.replace(/\d(?=(\d{3})+\.)/g, "$&,");
+        } else {
+          result = toLocalString(value);
+        }
+      } else {
+        result = value;
+      }
+      if (Number(num) === 0) {
+        return result;
+      } else {
+        return dec.greaterThan(new import_decimal.default(0)) ? removeInvalidZero(result) : type === "0" ? "-" + removeInvalidZero(result) : removeInvalidZero(result);
+      }
+    } else {
+      let value = "";
+      if (dec.greaterThan(1)) {
+        value = dec.toFixed(8, import_decimal.default.ROUND_DOWN);
+      } else {
+        value = dec.toFixed(precision - length2, import_decimal.default.ROUND_DOWN);
+      }
+      value = formatePrecision(value, pres).toString();
+      if (integerTokenArr.includes(tokenSymbol)) {
+        value = new import_decimal.default(value).toFixed(0, import_decimal.default.ROUND_CEIL);
+      }
+      let result = "";
+      if (typeof value === "string") {
+        if (value.includes(".")) {
+          result = value.replace(/\d(?=(\d{3})+\.)/g, "$&,");
+        } else {
+          result = toLocalString(value);
+        }
+      } else {
+        result = value;
+      }
+      return removeInvalidZero(result);
+    }
+  }) ?? "0.00";
+}
+function formateFaitAmount(num = 0) {
+  return tryRun(() => {
+    const dec = new import_decimal.default(num);
+    const fnum = dec.toFixed(2, import_decimal.default.ROUND_DOWN);
+    if (Number(num) >= 1e3) {
+      let result = toLocalString(fnum);
+      if (!result.includes(".")) {
+        result = result + ".00";
+      }
+      return result;
+    } else {
+      return fnum;
+    }
+  }) ?? "0.00";
+}
+function tryRun(fn) {
+  try {
+    return fn();
+  } catch (error) {
+    return null;
+  }
+}
 
 // src/date/index.ts
 var import_date_fns = require("date-fns");
@@ -862,22 +983,22 @@ function getUTCWeekNumber(date) {
 }
 
 // src/decimal/index.ts
-var import_decimal = __toESM(require("decimal.js"), 1);
+var import_decimal2 = __toESM(require("decimal.js"), 1);
 
 // src/decimal/utils/index.ts
-var import_decimal2 = __toESM(require("decimal.js"), 1);
+var import_decimal3 = __toESM(require("decimal.js"), 1);
 function safeDecimal(value) {
   try {
-    if (value instanceof import_decimal2.default) {
+    if (value instanceof import_decimal3.default) {
       return value;
     }
-    const decimal = new import_decimal2.default(value);
+    const decimal = new import_decimal3.default(value);
     if (decimal.isNaN()) {
-      return new import_decimal2.default(0);
+      return new import_decimal3.default(0);
     }
     return decimal;
   } catch {
-    return new import_decimal2.default(0);
+    return new import_decimal3.default(0);
   }
 }
 function add(a, b) {
@@ -975,7 +1096,7 @@ function round(value, decimalPlaces = 2) {
 function ceil(value, decimalPlaces = 2) {
   try {
     const decimal = safeDecimal(value);
-    return decimal.toDecimalPlaces(decimalPlaces, import_decimal2.default.ROUND_CEIL).toNumber();
+    return decimal.toDecimalPlaces(decimalPlaces, import_decimal3.default.ROUND_CEIL).toNumber();
   } catch {
     return 0;
   }
@@ -983,7 +1104,7 @@ function ceil(value, decimalPlaces = 2) {
 function floor(value, decimalPlaces = 2) {
   try {
     const decimal = safeDecimal(value);
-    return decimal.toDecimalPlaces(decimalPlaces, import_decimal2.default.ROUND_FLOOR).toNumber();
+    return decimal.toDecimalPlaces(decimalPlaces, import_decimal3.default.ROUND_FLOOR).toNumber();
   } catch {
     return 0;
   }
@@ -1349,6 +1470,9 @@ function fromBase64(base64) {
   formatUTC,
   formatUTCDateOnly,
   formatUTCTimeOnly,
+  formateAmount,
+  formateFaitAmount,
+  formatePrecision,
   fromBase64,
   fromUTC,
   getAllCookies,
@@ -1405,6 +1529,7 @@ function fromBase64(base64) {
   greaterThanOrEqual,
   hasCookie,
   includes,
+  integerTokenArr,
   isAfterDate,
   isAndroid,
   isBeforeDate,
@@ -1446,6 +1571,7 @@ function fromBase64(base64) {
   readExcelToJSON,
   readFile,
   removeCookie,
+  removeInvalidZero,
   removeSpaces,
   repeat,
   replaceAll,
@@ -1469,6 +1595,7 @@ function fromBase64(base64) {
   titleCase,
   toBase64,
   toISOString,
+  toLocalString,
   toLowerCase,
   toUTC,
   toUpperCase,
@@ -1476,6 +1603,7 @@ function fromBase64(base64) {
   trimEnd,
   trimStart,
   truncate,
+  tryRun,
   unescapeHtml,
   unmaskEmail,
   utils,

package/dist/index.d.cts

@@ -89,6 +89,19 @@ declare function formatPercent(value: number, options?: {
 }): string;
 declare function maskEmail(email: string): string;
 declare function unmaskEmail(maskedEmail: string, originalEmail: string): string;
+declare function toLocalString(value: string): string;
+declare const integerTokenArr: string[];
+type AmountNum = string | number | Decimal;
+declare function removeInvalidZero(num: string): string;
+declare function formatePrecision(n: AmountNum, precision?: number, tokenSymbol?: string): string | number;
+declare function formateAmount({ num, precision, tokenSymbol, type, }: {
+    num: AmountNum;
+    precision?: number;
+    tokenSymbol?: string;
+    type?: string;
+}): any;
+declare function formateFaitAmount(num?: AmountNum): any;
+declare function tryRun(fn: () => any): any;
 
 declare function formatDate(date: Date | number | string, formatStr?: string): string;
 declare function formatDateOnly(date: Date | number | string): string;
@@ -234,4 +247,4 @@ declare function isValidIdCard(idCard: string): boolean;
 declare function toBase64(str: string): string;
 declare function fromBase64(base64: string): string;
 
-export { type CookieOptions, abs, add, addDaysToDate, addDaysUTC, addMonthsToDate, addMonthsUTC, aoaToSheet, camelCase, capitalize, ceil, clearAllCookies, countOccurrences, debounceFn as debounce, divide, endsWith, equals, escapeHtml, exportExcelFile, exportJSONToExcel, extractNumbers, floor, formatDate, formatDateOnly, formatMoney, formatMoneyToChinese, formatNumber, formatPercent, formatRelativeTime, formatTimeOnly, formatUTC, formatUTCDateOnly, formatUTCTimeOnly, fromBase64, fromUTC, getAllCookies, getAllQueryParams, getBrowser, getBrowserEngine, getBrowserVersion, getCookie, getDaysDiff, getDeviceInfo, getDevicePixelRatio, getDeviceType, getEndOfDay, getEndOfMonth, getEndOfWeek, getEndOfYear, getHoursDiff, getMinutesDiff, getOS, getQueryParam, getQueryParamAll, getScreenResolution, getSheet, getSheetNames, getStartOfDay, getStartOfMonth, getStartOfWeek, getStartOfYear, getTimestamp, getTimestampInSeconds, getTimezoneOffset, getTimezoneOffsetHours, getUTCAllWeeksInYear, getUTCDaysDiff, getUTCEndOfDay, getUTCEndOfMonth, getUTCHoursDiff, getUTCMinutesDiff, getUTCNow, getUTCStartOfDay, getUTCStartOfMonth, getUTCTimestamp, getUTCTimestampInSeconds, getUTCWeekEnd, getUTCWeekNumber, getUTCWeekStart, getUTCWeeksInYear, getUTCYearEnd, getUTCYearEndTimestamp, getUTCYearStart, getUTCYearStartTimestamp, getViewportSize, greaterThan, greaterThanOrEqual, hasCookie, includes, isAfterDate, isAndroid, isBeforeDate, isDesktop, isEmpty, isIOS, isMobile, isNotEmpty, isSameDayDate, isTablet, isTouchDevice, isValidDate, isValidEmail, isValidIdCard, isValidPhone, isValidUrl, isWeChat, jsonToWorkbook, kebabCase, length, lessThan, lessThanOrEqual, maskBankCard, maskEmail, maskIdCard, maskName, maskPhone, multiply, negate, normalizeSpaces, padEnd, padStart, parseDate, parseMoney, pascalCase, randomString, read, readExcelFile, readExcelToJSON, readFile, removeCookie, removeSpaces, repeat, replaceAll, reverse, round, setCookie, sheetToAOA, sheetToCSV, sheetToHTML, snakeCase, split, startsWith, stripHtml, subDaysFromDate, subDaysUTC, subMonthsFromDate, subMonthsUTC, subtract, tableToSheet, throttleFn as throttle, titleCase, toBase64, toISOString, toLowerCase, toUTC, toUpperCase, trim, trimEnd, trimStart, truncate, unescapeHtml, unmaskEmail, utils, uuid, workbookToJSON, write, writeFile, writeFileXLSX };
+export { type AmountNum, type CookieOptions, abs, add, addDaysToDate, addDaysUTC, addMonthsToDate, addMonthsUTC, aoaToSheet, camelCase, capitalize, ceil, clearAllCookies, countOccurrences, debounceFn as debounce, divide, endsWith, equals, escapeHtml, exportExcelFile, exportJSONToExcel, extractNumbers, floor, formatDate, formatDateOnly, formatMoney, formatMoneyToChinese, formatNumber, formatPercent, formatRelativeTime, formatTimeOnly, formatUTC, formatUTCDateOnly, formatUTCTimeOnly, formateAmount, formateFaitAmount, formatePrecision, fromBase64, fromUTC, getAllCookies, getAllQueryParams, getBrowser, getBrowserEngine, getBrowserVersion, getCookie, getDaysDiff, getDeviceInfo, getDevicePixelRatio, getDeviceType, getEndOfDay, getEndOfMonth, getEndOfWeek, getEndOfYear, getHoursDiff, getMinutesDiff, getOS, getQueryParam, getQueryParamAll, getScreenResolution, getSheet, getSheetNames, getStartOfDay, getStartOfMonth, getStartOfWeek, getStartOfYear, getTimestamp, getTimestampInSeconds, getTimezoneOffset, getTimezoneOffsetHours, getUTCAllWeeksInYear, getUTCDaysDiff, getUTCEndOfDay, getUTCEndOfMonth, getUTCHoursDiff, getUTCMinutesDiff, getUTCNow, getUTCStartOfDay, getUTCStartOfMonth, getUTCTimestamp, getUTCTimestampInSeconds, getUTCWeekEnd, getUTCWeekNumber, getUTCWeekStart, getUTCWeeksInYear, getUTCYearEnd, getUTCYearEndTimestamp, getUTCYearStart, getUTCYearStartTimestamp, getViewportSize, greaterThan, greaterThanOrEqual, hasCookie, includes, integerTokenArr, isAfterDate, isAndroid, isBeforeDate, isDesktop, isEmpty, isIOS, isMobile, isNotEmpty, isSameDayDate, isTablet, isTouchDevice, isValidDate, isValidEmail, isValidIdCard, isValidPhone, isValidUrl, isWeChat, jsonToWorkbook, kebabCase, length, lessThan, lessThanOrEqual, maskBankCard, maskEmail, maskIdCard, maskName, maskPhone, multiply, negate, normalizeSpaces, padEnd, padStart, parseDate, parseMoney, pascalCase, randomString, read, readExcelFile, readExcelToJSON, readFile, removeCookie, removeInvalidZero, removeSpaces, repeat, replaceAll, reverse, round, setCookie, sheetToAOA, sheetToCSV, sheetToHTML, snakeCase, split, startsWith, stripHtml, subDaysFromDate, subDaysUTC, subMonthsFromDate, subMonthsUTC, subtract, tableToSheet, throttleFn as throttle, titleCase, toBase64, toISOString, toLocalString, toLowerCase, toUTC, toUpperCase, trim, trimEnd, trimStart, truncate, tryRun, unescapeHtml, unmaskEmail, utils, uuid, workbookToJSON, write, writeFile, writeFileXLSX };

package/dist/index.d.ts

@@ -89,6 +89,19 @@ declare function formatPercent(value: number, options?: {
 }): string;
 declare function maskEmail(email: string): string;
 declare function unmaskEmail(maskedEmail: string, originalEmail: string): string;
+declare function toLocalString(value: string): string;
+declare const integerTokenArr: string[];
+type AmountNum = string | number | Decimal;
+declare function removeInvalidZero(num: string): string;
+declare function formatePrecision(n: AmountNum, precision?: number, tokenSymbol?: string): string | number;
+declare function formateAmount({ num, precision, tokenSymbol, type, }: {
+    num: AmountNum;
+    precision?: number;
+    tokenSymbol?: string;
+    type?: string;
+}): any;
+declare function formateFaitAmount(num?: AmountNum): any;
+declare function tryRun(fn: () => any): any;
 
 declare function formatDate(date: Date | number | string, formatStr?: string): string;
 declare function formatDateOnly(date: Date | number | string): string;
@@ -234,4 +247,4 @@ declare function isValidIdCard(idCard: string): boolean;
 declare function toBase64(str: string): string;
 declare function fromBase64(base64: string): string;
 
-export { type CookieOptions, abs, add, addDaysToDate, addDaysUTC, addMonthsToDate, addMonthsUTC, aoaToSheet, camelCase, capitalize, ceil, clearAllCookies, countOccurrences, debounceFn as debounce, divide, endsWith, equals, escapeHtml, exportExcelFile, exportJSONToExcel, extractNumbers, floor, formatDate, formatDateOnly, formatMoney, formatMoneyToChinese, formatNumber, formatPercent, formatRelativeTime, formatTimeOnly, formatUTC, formatUTCDateOnly, formatUTCTimeOnly, fromBase64, fromUTC, getAllCookies, getAllQueryParams, getBrowser, getBrowserEngine, getBrowserVersion, getCookie, getDaysDiff, getDeviceInfo, getDevicePixelRatio, getDeviceType, getEndOfDay, getEndOfMonth, getEndOfWeek, getEndOfYear, getHoursDiff, getMinutesDiff, getOS, getQueryParam, getQueryParamAll, getScreenResolution, getSheet, getSheetNames, getStartOfDay, getStartOfMonth, getStartOfWeek, getStartOfYear, getTimestamp, getTimestampInSeconds, getTimezoneOffset, getTimezoneOffsetHours, getUTCAllWeeksInYear, getUTCDaysDiff, getUTCEndOfDay, getUTCEndOfMonth, getUTCHoursDiff, getUTCMinutesDiff, getUTCNow, getUTCStartOfDay, getUTCStartOfMonth, getUTCTimestamp, getUTCTimestampInSeconds, getUTCWeekEnd, getUTCWeekNumber, getUTCWeekStart, getUTCWeeksInYear, getUTCYearEnd, getUTCYearEndTimestamp, getUTCYearStart, getUTCYearStartTimestamp, getViewportSize, greaterThan, greaterThanOrEqual, hasCookie, includes, isAfterDate, isAndroid, isBeforeDate, isDesktop, isEmpty, isIOS, isMobile, isNotEmpty, isSameDayDate, isTablet, isTouchDevice, isValidDate, isValidEmail, isValidIdCard, isValidPhone, isValidUrl, isWeChat, jsonToWorkbook, kebabCase, length, lessThan, lessThanOrEqual, maskBankCard, maskEmail, maskIdCard, maskName, maskPhone, multiply, negate, normalizeSpaces, padEnd, padStart, parseDate, parseMoney, pascalCase, randomString, read, readExcelFile, readExcelToJSON, readFile, removeCookie, removeSpaces, repeat, replaceAll, reverse, round, setCookie, sheetToAOA, sheetToCSV, sheetToHTML, snakeCase, split, startsWith, stripHtml, subDaysFromDate, subDaysUTC, subMonthsFromDate, subMonthsUTC, subtract, tableToSheet, throttleFn as throttle, titleCase, toBase64, toISOString, toLowerCase, toUTC, toUpperCase, trim, trimEnd, trimStart, truncate, unescapeHtml, unmaskEmail, utils, uuid, workbookToJSON, write, writeFile, writeFileXLSX };
+export { type AmountNum, type CookieOptions, abs, add, addDaysToDate, addDaysUTC, addMonthsToDate, addMonthsUTC, aoaToSheet, camelCase, capitalize, ceil, clearAllCookies, countOccurrences, debounceFn as debounce, divide, endsWith, equals, escapeHtml, exportExcelFile, exportJSONToExcel, extractNumbers, floor, formatDate, formatDateOnly, formatMoney, formatMoneyToChinese, formatNumber, formatPercent, formatRelativeTime, formatTimeOnly, formatUTC, formatUTCDateOnly, formatUTCTimeOnly, formateAmount, formateFaitAmount, formatePrecision, fromBase64, fromUTC, getAllCookies, getAllQueryParams, getBrowser, getBrowserEngine, getBrowserVersion, getCookie, getDaysDiff, getDeviceInfo, getDevicePixelRatio, getDeviceType, getEndOfDay, getEndOfMonth, getEndOfWeek, getEndOfYear, getHoursDiff, getMinutesDiff, getOS, getQueryParam, getQueryParamAll, getScreenResolution, getSheet, getSheetNames, getStartOfDay, getStartOfMonth, getStartOfWeek, getStartOfYear, getTimestamp, getTimestampInSeconds, getTimezoneOffset, getTimezoneOffsetHours, getUTCAllWeeksInYear, getUTCDaysDiff, getUTCEndOfDay, getUTCEndOfMonth, getUTCHoursDiff, getUTCMinutesDiff, getUTCNow, getUTCStartOfDay, getUTCStartOfMonth, getUTCTimestamp, getUTCTimestampInSeconds, getUTCWeekEnd, getUTCWeekNumber, getUTCWeekStart, getUTCWeeksInYear, getUTCYearEnd, getUTCYearEndTimestamp, getUTCYearStart, getUTCYearStartTimestamp, getViewportSize, greaterThan, greaterThanOrEqual, hasCookie, includes, integerTokenArr, isAfterDate, isAndroid, isBeforeDate, isDesktop, isEmpty, isIOS, isMobile, isNotEmpty, isSameDayDate, isTablet, isTouchDevice, isValidDate, isValidEmail, isValidIdCard, isValidPhone, isValidUrl, isWeChat, jsonToWorkbook, kebabCase, length, lessThan, lessThanOrEqual, maskBankCard, maskEmail, maskIdCard, maskName, maskPhone, multiply, negate, normalizeSpaces, padEnd, padStart, parseDate, parseMoney, pascalCase, randomString, read, readExcelFile, readExcelToJSON, readFile, removeCookie, removeInvalidZero, removeSpaces, repeat, replaceAll, reverse, round, setCookie, sheetToAOA, sheetToCSV, sheetToHTML, snakeCase, split, startsWith, stripHtml, subDaysFromDate, subDaysUTC, subMonthsFromDate, subMonthsUTC, subtract, tableToSheet, throttleFn as throttle, titleCase, toBase64, toISOString, toLocalString, toLowerCase, toUTC, toUpperCase, trim, trimEnd, trimStart, truncate, tryRun, unescapeHtml, unmaskEmail, utils, uuid, workbookToJSON, write, writeFile, writeFileXLSX };

package/dist/index.js

@@ -260,6 +260,7 @@ function getDeviceInfo() {
 }
 
 // src/format/index.ts
+import Decimal from "decimal.js";
 function formatMoney(amount, options = {}) {
   const {
     decimals = 2,
@@ -267,20 +268,19 @@ function formatMoney(amount, options = {}) {
     separator = ",",
     decimalPoint = "."
   } = options;
-  const num = typeof amount === "string" ? parseFloat(amount) : amount;
-  if (isNaN(num)) {
-    return `${symbol}0${decimalPoint}${"0".repeat(decimals)}`;
-  }
-  const isNegative = num < 0;
-  const absNum = Math.abs(num);
-  const fixed = absNum.toFixed(decimals);
-  const [integerPart, decimalPart] = fixed.split(".");
-  const formattedInteger = integerPart.replace(/\B(?=(\d{3})+(?!\d))/g, separator);
-  let result = symbol + formattedInteger;
-  if (decimals > 0 && decimalPart) {
-    result += decimalPoint + decimalPart;
-  }
-  return isNegative ? `-${result}` : result;
+  return tryRun(() => {
+    const dec = new Decimal(amount);
+    const isNegative = dec.isNegative();
+    const absDec = dec.abs();
+    const fixed = absDec.toFixed(decimals, Decimal.ROUND_DOWN);
+    const [integerPart, decimalPart] = fixed.split(".");
+    const formattedInteger = integerPart.replace(/\B(?=(\d{3})+(?!\d))/g, separator);
+    let result = symbol + formattedInteger;
+    if (decimals > 0 && decimalPart) {
+      result += decimalPoint + decimalPart;
+    }
+    return isNegative ? `-${result}` : result;
+  }) ?? `${symbol}0${decimalPoint}${"0".repeat(decimals)}`;
 }
 function parseMoney(formattedAmount) {
   if (!formattedAmount || typeof formattedAmount !== "string") {
@@ -291,68 +291,70 @@ function parseMoney(formattedAmount) {
   return isNaN(num) ? 0 : num;
 }
 function formatNumber(amount, decimals = 2) {
-  const num = typeof amount === "string" ? parseFloat(amount) : amount;
-  if (isNaN(num)) {
-    return "0." + "0".repeat(decimals);
-  }
-  const fixed = num.toFixed(decimals);
-  const [integerPart, decimalPart] = fixed.split(".");
-  const formattedInteger = integerPart.replace(/\B(?=(\d{3})+(?!\d))/g, ",");
-  return decimals > 0 && decimalPart ? `${formattedInteger}.${decimalPart}` : formattedInteger;
+  return tryRun(() => {
+    const dec = new Decimal(amount);
+    const fixed = dec.toFixed(decimals, Decimal.ROUND_DOWN);
+    const [integerPart, decimalPart] = fixed.split(".");
+    const formattedInteger = integerPart.replace(/\B(?=(\d{3})+(?!\d))/g, ",");
+    return decimals > 0 && decimalPart ? `${formattedInteger}.${decimalPart}` : formattedInteger;
+  }) ?? "0." + "0".repeat(decimals);
 }
 function formatMoneyToChinese(amount) {
-  const num = typeof amount === "string" ? parseFloat(amount) : amount;
-  if (isNaN(num) || num < 0) {
-    return "\u96F6\u5143\u6574";
-  }
-  const digits = ["\u96F6", "\u58F9", "\u8D30", "\u53C1", "\u8086", "\u4F0D", "\u9646", "\u67D2", "\u634C", "\u7396"];
-  const units = ["", "\u62FE", "\u4F70", "\u4EDF"];
-  const bigUnits = ["", "\u4E07", "\u4EBF", "\u5146"];
-  const decimalUnits = ["\u89D2", "\u5206"];
-  const [integerPart, decimalPart] = num.toFixed(2).split(".");
-  let result = "";
-  if (integerPart === "0") {
-    result = "\u96F6\u5143";
-  } else {
-    const integerStr = integerPart;
-    const len = integerStr.length;
-    let zeroCount = 0;
-    for (let i = 0; i < len; i++) {
-      const digit = parseInt(integerStr[i]);
-      const unitIndex = (len - i - 1) % 4;
-      const bigUnitIndex = Math.floor((len - i - 1) / 4);
-      if (digit === 0) {
-        zeroCount++;
-      } else {
-        if (zeroCount > 0) {
-          result += "\u96F6";
+  return tryRun(() => {
+    const dec = new Decimal(amount);
+    if (dec.isNegative()) {
+      return "\u96F6\u5143\u6574";
+    }
+    const num = dec.toNumber();
+    const digits = ["\u96F6", "\u58F9", "\u8D30", "\u53C1", "\u8086", "\u4F0D", "\u9646", "\u67D2", "\u634C", "\u7396"];
+    const units = ["", "\u62FE", "\u4F70", "\u4EDF"];
+    const bigUnits = ["", "\u4E07", "\u4EBF", "\u5146"];
+    const decimalUnits = ["\u89D2", "\u5206"];
+    const [integerPart, decimalPart] = num.toFixed(2).split(".");
+    let result = "";
+    if (integerPart === "0") {
+      result = "\u96F6\u5143";
+    } else {
+      const integerStr = integerPart;
+      const len = integerStr.length;
+      let zeroCount = 0;
+      for (let i = 0; i < len; i++) {
+        const digit = parseInt(integerStr[i]);
+        const unitIndex = (len - i - 1) % 4;
+        const bigUnitIndex = Math.floor((len - i - 1) / 4);
+        if (digit === 0) {
+          zeroCount++;
+        } else {
+          if (zeroCount > 0) {
+            result += "\u96F6";
+          }
+          result += digits[digit] + units[unitIndex];
+          zeroCount = 0;
         }
-        result += digits[digit] + units[unitIndex];
-        zeroCount = 0;
-      }
-      if (unitIndex === 0 && bigUnitIndex > 0) {
-        if (result[result.length - 1] !== bigUnits[bigUnitIndex]) {
-          result += bigUnits[bigUnitIndex];
+        if (unitIndex === 0 && bigUnitIndex > 0) {
+          if (result[result.length - 1] !== bigUnits[bigUnitIndex]) {
+            result += bigUnits[bigUnitIndex];
+          }
         }
       }
+      result += "\u5143";
     }
-    result += "\u5143";
-  }
-  if (decimalPart && decimalPart !== "00") {
-    const jiao = parseInt(decimalPart[0]);
-    const fen = parseInt(decimalPart[1]);
-    if (jiao > 0) {
-      result += digits[jiao] + decimalUnits[0];
-    } else if (fen > 0) {
-      result += "\u96F6";
-    }
-    if (fen > 0) {
-      result += digits[fen] + decimalUnits[1];
+    if (decimalPart && decimalPart !== "00") {
+      const jiao = parseInt(decimalPart[0]);
+      const fen = parseInt(decimalPart[1]);
+      if (jiao > 0) {
+        result += digits[jiao] + decimalUnits[0];
+      } else if (fen > 0) {
+        result += "\u96F6";
+      }
+      if (fen > 0) {
+        result += digits[fen] + decimalUnits[1];
+      }
+    } else {
+      result += "\u6574";
     }
-  } else {
-    result += "\u6574";
-  }
-  return result;
+    return result;
+  }) ?? "\u96F6\u5143\u6574";
 }
 function formatPercent(value, options = {}) {
   const { decimals = 2, multiply: multiply2 = true } = options;
@@ -395,6 +397,118 @@ function unmaskEmail(maskedEmail, originalEmail) {
   }
   return maskedEmail;
 }
+function toLocalString(value) {
+  let result = value;
+  if (Number(value) >= 1e3) {
+    result = Number(value).toLocaleString("en-US");
+  } else {
+    result = value;
+  }
+  return result;
+}
+var integerTokenArr = ["SATS"];
+function removeInvalidZero(num) {
+  let result = num;
+  if (num.includes(".")) {
+    result = result.replace(/\.?0+$/, "");
+  }
+  return result;
+}
+function formatePrecision(n, precision, tokenSymbol) {
+  if (!isNaN(Number(n))) {
+    let prec = precision && precision <= 8 ? precision : 8;
+    if (tokenSymbol && integerTokenArr.includes(tokenSymbol)) {
+      prec = 0;
+    }
+    return new Decimal(Number(n)).toFixed(prec, Decimal.ROUND_DOWN);
+  }
+  const num = new Decimal(n).toNumber();
+  return num;
+}
+function formateAmount({
+  num = 0,
+  precision = 8,
+  tokenSymbol = "",
+  type = "0"
+}) {
+  return tryRun(() => {
+    const dec = new Decimal(num);
+    const { length: length2 } = dec.abs().floor().toString();
+    const pres = precision;
+    precision = precision > 8 ? 9 : precision + 1;
+    if (length2 >= precision) {
+      let value = "";
+      if (dec.greaterThan(1)) {
+        value = dec.toFixed(8, Decimal.ROUND_DOWN);
+      } else {
+        value = dec.toFixed(precision - length2, Decimal.ROUND_DOWN);
+      }
+      value = formatePrecision(value, pres).toString();
+      if (integerTokenArr.includes(tokenSymbol)) {
+        value = new Decimal(value).toFixed(0, Decimal.ROUND_CEIL);
+      }
+      let result = "";
+      if (typeof value === "string") {
+        if (value.includes(".")) {
+          result = value.replace(/\d(?=(\d{3})+\.)/g, "$&,");
+        } else {
+          result = toLocalString(value);
+        }
+      } else {
+        result = value;
+      }
+      if (Number(num) === 0) {
+        return result;
+      } else {
+        return dec.greaterThan(new Decimal(0)) ? removeInvalidZero(result) : type === "0" ? "-" + removeInvalidZero(result) : removeInvalidZero(result);
+      }
+    } else {
+      let value = "";
+      if (dec.greaterThan(1)) {
+        value = dec.toFixed(8, Decimal.ROUND_DOWN);
+      } else {
+        value = dec.toFixed(precision - length2, Decimal.ROUND_DOWN);
+      }
+      value = formatePrecision(value, pres).toString();
+      if (integerTokenArr.includes(tokenSymbol)) {
+        value = new Decimal(value).toFixed(0, Decimal.ROUND_CEIL);
+      }
+      let result = "";
+      if (typeof value === "string") {
+        if (value.includes(".")) {
+          result = value.replace(/\d(?=(\d{3})+\.)/g, "$&,");
+        } else {
+          result = toLocalString(value);
+        }
+      } else {
+        result = value;
+      }
+      return removeInvalidZero(result);
+    }
+  }) ?? "0.00";
+}
+function formateFaitAmount(num = 0) {
+  return tryRun(() => {
+    const dec = new Decimal(num);
+    const fnum = dec.toFixed(2, Decimal.ROUND_DOWN);
+    if (Number(num) >= 1e3) {
+      let result = toLocalString(fnum);
+      if (!result.includes(".")) {
+        result = result + ".00";
+      }
+      return result;
+    } else {
+      return fnum;
+    }
+  }) ?? "0.00";
+}
+function tryRun(fn) {
+  try {
+    return fn();
+  } catch (error) {
+    return null;
+  }
+}
 
 // src/date/index.ts
 import {
@@ -704,19 +818,19 @@ function getUTCWeekNumber(date) {
 import { default as default2 } from "decimal.js";
 
 // src/decimal/utils/index.ts
-import Decimal from "decimal.js";
+import Decimal2 from "decimal.js";
 function safeDecimal(value) {
   try {
-    if (value instanceof Decimal) {
+    if (value instanceof Decimal2) {
       return value;
     }
-    const decimal = new Decimal(value);
+    const decimal = new Decimal2(value);
     if (decimal.isNaN()) {
-      return new Decimal(0);
+      return new Decimal2(0);
     }
     return decimal;
   } catch {
-    return new Decimal(0);
+    return new Decimal2(0);
   }
 }
 function add(a, b) {
@@ -814,7 +928,7 @@ function round(value, decimalPlaces = 2) {
 function ceil(value, decimalPlaces = 2) {
   try {
     const decimal = safeDecimal(value);
-    return decimal.toDecimalPlaces(decimalPlaces, Decimal.ROUND_CEIL).toNumber();
+    return decimal.toDecimalPlaces(decimalPlaces, Decimal2.ROUND_CEIL).toNumber();
   } catch {
     return 0;
   }
@@ -822,7 +936,7 @@ function ceil(value, decimalPlaces = 2) {
 function floor(value, decimalPlaces = 2) {
   try {
     const decimal = safeDecimal(value);
-    return decimal.toDecimalPlaces(decimalPlaces, Decimal.ROUND_FLOOR).toNumber();
+    return decimal.toDecimalPlaces(decimalPlaces, Decimal2.ROUND_FLOOR).toNumber();
   } catch {
     return 0;
   }
@@ -1187,6 +1301,9 @@ export {
   formatUTC,
   formatUTCDateOnly,
   formatUTCTimeOnly,
+  formateAmount,
+  formateFaitAmount,
+  formatePrecision,
   fromBase64,
   fromUTC,
   getAllCookies,
@@ -1243,6 +1360,7 @@ export {
   greaterThanOrEqual,
   hasCookie,
   includes,
+  integerTokenArr,
   isAfterDate,
   isAndroid,
   isBeforeDate,
@@ -1284,6 +1402,7 @@ export {
   readExcelToJSON,
   readFile,
   removeCookie,
+  removeInvalidZero,
   removeSpaces,
   repeat,
   replaceAll,
@@ -1307,6 +1426,7 @@ export {
   titleCase,
   toBase64,
   toISOString,
+  toLocalString,
   toLowerCase,
   toUTC,
   toUpperCase,
@@ -1314,6 +1434,7 @@ export {
   trimEnd,
   trimStart,
   truncate,
+  tryRun,
   unescapeHtml,
   unmaskEmail,
   utils2 as utils,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-util-tools",
-  "version": "1.0.26",
+  "version": "1.0.28",
   "description": "A collection of useful utilities: throttle, debounce, date formatting, device detection, money formatting, decimal calculations, Excel processing and more",
   "type": "module",
   "main": "dist/index.cjs",

package/src/format/index.ts

@@ -1,3 +1,5 @@
+import Decimal from "decimal.js"
+
 /**
  * 金额格式化：将数字格式化为金额字符串
  * @param amount 金额数字
@@ -20,32 +22,29 @@ export function formatMoney(
     decimalPoint = '.'
   } = options
 
-  // 转换为数字
-  const num = typeof amount === 'string' ? parseFloat(amount) : amount
-
-  // 处理无效数字
-  if (isNaN(num)) {
-    return `${symbol}0${decimalPoint}${'0'.repeat(decimals)}`
-  }
-
-  // 处理负数
-  const isNegative = num < 0
-  const absNum = Math.abs(num)
-
-  // 固定小数位
-  const fixed = absNum.toFixed(decimals)
-  const [integerPart, decimalPart] = fixed.split('.')
-
-  // 添加千分位分隔符
-  const formattedInteger = integerPart.replace(/\B(?=(\d{3})+(?!\d))/g, separator)
-
-  // 组合结果
-  let result = symbol + formattedInteger
-  if (decimals > 0 && decimalPart) {
-    result += decimalPoint + decimalPart
-  }
-
-  return isNegative ? `-${result}` : result
+  return tryRun(() => {
+    // 使用 Decimal 处理，避免精度问题
+    const dec = new Decimal(amount)
+    
+    // 处理负数
+    const isNegative = dec.isNegative()
+    const absDec = dec.abs()
+    
+    // 固定小数位（向下取整）
+    const fixed = absDec.toFixed(decimals, Decimal.ROUND_DOWN)
+    const [integerPart, decimalPart] = fixed.split('.')
+    
+    // 添加千分位分隔符
+    const formattedInteger = integerPart.replace(/\B(?=(\d{3})+(?!\d))/g, separator)
+    
+    // 组合结果
+    let result = symbol + formattedInteger
+    if (decimals > 0 && decimalPart) {
+      result += decimalPoint + decimalPart
+    }
+    
+    return isNegative ? `-${result}` : result
+  }) ?? `${symbol}0${decimalPoint}${'0'.repeat(decimals)}`
 }
 
 /**
@@ -74,20 +73,18 @@ export function parseMoney(formattedAmount: string): number {
  * @returns 格式化后的金额字符串（不含货币符号）
  */
 export function formatNumber(amount: number | string, decimals = 2): string {
-  const num = typeof amount === 'string' ? parseFloat(amount) : amount
-
-  if (isNaN(num)) {
-    return '0.' + '0'.repeat(decimals)
-  }
-
-  const fixed = num.toFixed(decimals)
-  const [integerPart, decimalPart] = fixed.split('.')
-
-  const formattedInteger = integerPart.replace(/\B(?=(\d{3})+(?!\d))/g, ',')
-
-  return decimals > 0 && decimalPart
-    ? `${formattedInteger}.${decimalPart}`
-    : formattedInteger
+  return tryRun(() => {
+    // 使用 Decimal 处理，避免精度问题
+    const dec = new Decimal(amount)
+    const fixed = dec.toFixed(decimals, Decimal.ROUND_DOWN)
+    const [integerPart, decimalPart] = fixed.split('.')
+    
+    const formattedInteger = integerPart.replace(/\B(?=(\d{3})+(?!\d))/g, ',')
+    
+    return decimals > 0 && decimalPart
+      ? `${formattedInteger}.${decimalPart}`
+      : formattedInteger
+  }) ?? '0.' + '0'.repeat(decimals)
 }
 
 /**
@@ -96,73 +93,76 @@ export function formatNumber(amount: number | string, decimals = 2): string {
  * @returns 中文大写金额
  */
 export function formatMoneyToChinese(amount: number | string): string {
-  const num = typeof amount === 'string' ? parseFloat(amount) : amount
-
-  if (isNaN(num) || num < 0) {
-    return '零元整'
-  }
-
-  const digits = ['零', '壹', '贰', '叁', '肆', '伍', '陆', '柒', '捌', '玖']
-  const units = ['', '拾', '佰', '仟']
-  const bigUnits = ['', '万', '亿', '兆']
-  const decimalUnits = ['角', '分']
-
-  // 分离整数和小数部分
-  const [integerPart, decimalPart] = num.toFixed(2).split('.')
-  let result = ''
-
-  // 处理整数部分
-  if (integerPart === '0') {
-    result = '零元'
-  } else {
-    const integerStr = integerPart
-    const len = integerStr.length
-    let zeroCount = 0
-
-    for (let i = 0; i < len; i++) {
-      const digit = parseInt(integerStr[i])
-      const unitIndex = (len - i - 1) % 4
-      const bigUnitIndex = Math.floor((len - i - 1) / 4)
-
-      if (digit === 0) {
-        zeroCount++
-      } else {
-        if (zeroCount > 0) {
-          result += '零'
+  return tryRun(() => {
+    const dec = new Decimal(amount)
+    
+    if (dec.isNegative()) {
+      return '零元整'
+    }
+    
+    const num = dec.toNumber()
+    const digits = ['零', '壹', '贰', '叁', '肆', '伍', '陆', '柒', '捌', '玖']
+    const units = ['', '拾', '佰', '仟']
+    const bigUnits = ['', '万', '亿', '兆']
+    const decimalUnits = ['角', '分']
+    
+    // 分离整数和小数部分
+    const [integerPart, decimalPart] = num.toFixed(2).split('.')
+    let result = ''
+    
+    // 处理整数部分
+    if (integerPart === '0') {
+      result = '零元'
+    } else {
+      const integerStr = integerPart
+      const len = integerStr.length
+      let zeroCount = 0
+      
+      for (let i = 0; i < len; i++) {
+        const digit = parseInt(integerStr[i])
+        const unitIndex = (len - i - 1) % 4
+        const bigUnitIndex = Math.floor((len - i - 1) / 4)
+        
+        if (digit === 0) {
+          zeroCount++
+        } else {
+          if (zeroCount > 0) {
+            result += '零'
+          }
+          result += digits[digit] + units[unitIndex]
+          zeroCount = 0
         }
-        result += digits[digit] + units[unitIndex]
-        zeroCount = 0
-      }
-
-      if (unitIndex === 0 && bigUnitIndex > 0) {
-        if (result[result.length - 1] !== bigUnits[bigUnitIndex]) {
-          result += bigUnits[bigUnitIndex]
+        
+        if (unitIndex === 0 && bigUnitIndex > 0) {
+          if (result[result.length - 1] !== bigUnits[bigUnitIndex]) {
+            result += bigUnits[bigUnitIndex]
+          }
         }
       }
+      
+      result += '元'
     }
-
-    result += '元'
-  }
-
-  // 处理小数部分
-  if (decimalPart && decimalPart !== '00') {
-    const jiao = parseInt(decimalPart[0])
-    const fen = parseInt(decimalPart[1])
-
-    if (jiao > 0) {
-      result += digits[jiao] + decimalUnits[0]
-    } else if (fen > 0) {
-      result += '零'
-    }
-
-    if (fen > 0) {
-      result += digits[fen] + decimalUnits[1]
+    
+    // 处理小数部分
+    if (decimalPart && decimalPart !== '00') {
+      const jiao = parseInt(decimalPart[0])
+      const fen = parseInt(decimalPart[1])
+      
+      if (jiao > 0) {
+        result += digits[jiao] + decimalUnits[0]
+      } else if (fen > 0) {
+        result += '零'
+      }
+      
+      if (fen > 0) {
+        result += digits[fen] + decimalUnits[1]
+      }
+    } else {
+      result += '整'
     }
-  } else {
-    result += '整'
-  }
-
-  return result
+    
+    return result
+  }) ?? '零元整'
 }
 
 /**
@@ -252,3 +252,164 @@ export function unmaskEmail(maskedEmail: string, originalEmail: string): string
 
   return maskedEmail // 不匹配，返回脱敏邮箱
 }
+
+/* thousandths processing
+ ** value The coin string to be processed
+ */
+export function toLocalString(value: string) {
+  // Do thousandths
+  let result = value
+  if (Number(value) >= 1000) {
+    result = Number(value).toLocaleString('en-US')
+  } else {
+    result = value
+  }
+  return result
+}
+
+export const integerTokenArr = ['SATS']
+export type AmountNum = string | number | Decimal
+
+export function removeInvalidZero(num: string) {
+  let result = num
+  if (num.includes('.')) {
+    result = result.replace(/\.?0+$/, '')
+  }
+  return result
+}
+
+//(<= 8)Output precision control, if it is greater than 8 digits, 8 digits will be reserved, if it is less than 8 digits, the corresponding digits will be displayed, and the default is 8 digits
+export function formatePrecision(
+  n: AmountNum,
+  precision?: number,
+  tokenSymbol?: string
+) {
+  if (!isNaN(Number(n))) {
+    let prec = precision && precision <= 8 ? precision : 8
+    if (tokenSymbol && integerTokenArr.includes(tokenSymbol)) {
+      prec = 0
+    }
+    return new Decimal(Number(n)).toFixed(prec, Decimal.ROUND_DOWN)
+  }
+  const num = new Decimal(n).toNumber()
+  return num
+}
+
+/**
+ * (>= 8) formatted amount, number of tokens
+ * Keep 8 digits after the decimal point, a total of 10 digits
+ */
+export function formateAmount({
+  num = 0,
+  precision = 8,
+  tokenSymbol = '',
+  type = '0',
+}: {
+  num: AmountNum
+  precision?: number
+  tokenSymbol?: string
+  type?: string
+}) {
+  return (
+    tryRun(() => {
+      const dec = new Decimal(num)
+      const { length } = dec.abs().floor().toString()
+      const pres = precision
+      precision = precision > 8 ? 9 : precision + 1
+      if (length >= precision) {
+        let value = ''
+        // Here it is necessary to judge whether it is greater than 1, and if it is greater than 1, directly retain 8 decimal places
+        if (dec.greaterThan(1)) {
+          value = dec.toFixed(8, Decimal.ROUND_DOWN)
+        } else {
+          value = dec.toFixed(precision - length, Decimal.ROUND_DOWN)
+        }
+        value = formatePrecision(value, pres).toString()
+        // If you round up here, the decimal place will be removed
+        // If it is a sats token, round up
+        if (integerTokenArr.includes(tokenSymbol)) {
+          value = new Decimal(value).toFixed(0, Decimal.ROUND_CEIL)
+        }
+        // Do thousandths
+        let result = ''
+        if (typeof value === 'string') {
+          if (value.includes('.')) {
+            result = value.replace(/\d(?=(\d{3})+\.)/g, '$&,')
+          } else {
+            result = toLocalString(value)
+          }
+        } else {
+          result = value
+        }
+
+        if (Number(num) === 0) {
+          return result
+        } else {
+          return dec.greaterThan(new Decimal(0))
+            ? removeInvalidZero(result)
+            : type === '0'
+              ? '-' + removeInvalidZero(result)
+              : removeInvalidZero(result)
+        }
+      } else {
+        let value = ''
+        // Here it is necessary to judge whether it is greater than 1, and if it is greater than 1, directly retain 8 decimal places
+        if (dec.greaterThan(1)) {
+          value = dec.toFixed(8, Decimal.ROUND_DOWN)
+        } else {
+          value = dec.toFixed(precision - length, Decimal.ROUND_DOWN)
+        }
+
+        value = formatePrecision(value, pres).toString()
+        // If it is a sats token, round up
+        if (integerTokenArr.includes(tokenSymbol)) {
+          value = new Decimal(value).toFixed(0, Decimal.ROUND_CEIL)
+        }
+
+        // Do thousandths
+        let result = ''
+        if (typeof value === 'string') {
+          if (value.includes('.')) {
+            result = value.replace(/\d(?=(\d{3})+\.)/g, '$&,')
+          } else {
+            result = toLocalString(value)
+          }
+        } else {
+          result = value
+        }
+
+        return removeInvalidZero(result)
+      }
+    }) ?? '0.00'
+  )
+}
+
+/**
+ * Format the local fiat currency, with two decimal places by default
+ */
+export function formateFaitAmount(num: AmountNum = 0) {
+  return (
+    tryRun(() => {
+      const dec = new Decimal(num)
+      const fnum = dec.toFixed(2, Decimal.ROUND_DOWN)
+      // If it is greater than 1000, perform thousandths processing
+      if (Number(num) >= 1000) {
+        let result = toLocalString(fnum)
+        if (!result.includes('.')) {
+          result = result + '.00'
+        }
+        return result
+      } else {
+        return fnum
+      }
+    }) ?? '0.00'
+  )
+}
+
+export function tryRun(fn: () => any) {
+  try {
+    return fn()
+  } catch (error: any) {
+    return null
+  }
+}

package/src/index.ts

@@ -35,8 +35,16 @@ export {
   formatMoneyToChinese,
   formatPercent,
   maskEmail,
-  unmaskEmail
+  unmaskEmail,
+  toLocalString,
+  integerTokenArr,
+  removeInvalidZero,
+  formatePrecision,
+  formateAmount,
+  formateFaitAmount,
+  tryRun
 } from './format/index'
+export type { AmountNum } from './format/index'
 export {
   formatDate,
   formatDateOnly,