react-util-tools 1.0.27 → 1.0.29

package/dist/index.cjs

@@ -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,
@@ -147,6 +151,7 @@ __export(index_exports, {
   maskIdCard: () => maskIdCard,
   maskName: () => maskName,
   maskPhone: () => maskPhone,
+  maskString: () => maskString,
   multiply: () => multiply,
   negate: () => negate,
   normalizeSpaces: () => normalizeSpaces,
@@ -161,6 +166,7 @@ __export(index_exports, {
   readExcelToJSON: () => readExcelToJSON,
   readFile: () => readFile,
   removeCookie: () => removeCookie,
+  removeInvalidZero: () => removeInvalidZero,
   removeSpaces: () => removeSpaces,
   repeat: () => repeat,
   replaceAll: () => replaceAll,
@@ -184,6 +190,7 @@ __export(index_exports, {
   titleCase: () => titleCase,
   toBase64: () => toBase64,
   toISOString: () => toISOString,
+  toLocalString: () => toLocalString,
   toLowerCase: () => toLowerCase,
   toUTC: () => toUTC,
   toUpperCase: () => toUpperCase,
@@ -191,6 +198,7 @@ __export(index_exports, {
   trimEnd: () => trimEnd,
   trimStart: () => trimStart,
   truncate: () => truncate,
+  tryRun: () => tryRun,
   unescapeHtml: () => unescapeHtml,
   unmaskEmail: () => unmaskEmail,
   utils: () => utils2,
@@ -601,6 +609,111 @@ 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();
@@ -1262,6 +1375,15 @@ function maskName(name) {
   }
   return name.charAt(0) + "*".repeat(name.length - 2) + name.charAt(name.length - 1);
 }
+function maskString(str, visibleChars = 3, mask = "...") {
+  if (!str) return "";
+  if (str.length <= visibleChars * 2) {
+    return str;
+  }
+  const start = str.slice(0, visibleChars);
+  const end = str.slice(-visibleChars);
+  return `${start}${mask}${end}`;
+}
 function isValidPhone(phone) {
   if (!phone) return false;
   return /^1[3-9]\d{9}$/.test(phone);
@@ -1358,6 +1480,9 @@ function fromBase64(base64) {
   formatUTC,
   formatUTCDateOnly,
   formatUTCTimeOnly,
+  formateAmount,
+  formateFaitAmount,
+  formatePrecision,
   fromBase64,
   fromUTC,
   getAllCookies,
@@ -1414,6 +1539,7 @@ function fromBase64(base64) {
   greaterThanOrEqual,
   hasCookie,
   includes,
+  integerTokenArr,
   isAfterDate,
   isAndroid,
   isBeforeDate,
@@ -1441,6 +1567,7 @@ function fromBase64(base64) {
   maskIdCard,
   maskName,
   maskPhone,
+  maskString,
   multiply,
   negate,
   normalizeSpaces,
@@ -1455,6 +1582,7 @@ function fromBase64(base64) {
   readExcelToJSON,
   readFile,
   removeCookie,
+  removeInvalidZero,
   removeSpaces,
   repeat,
   replaceAll,
@@ -1478,6 +1606,7 @@ function fromBase64(base64) {
   titleCase,
   toBase64,
   toISOString,
+  toLocalString,
   toLowerCase,
   toUTC,
   toUpperCase,
@@ -1485,6 +1614,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;
@@ -227,6 +240,7 @@ declare function maskPhone(phone: string): string;
 declare function maskIdCard(idCard: string): string;
 declare function maskBankCard(cardNumber: string): string;
 declare function maskName(name: string): string;
+declare function maskString(str: string, visibleChars?: number, mask?: string): string;
 declare function isValidPhone(phone: string): boolean;
 declare function isValidEmail(email: string): boolean;
 declare function isValidUrl(url: string): boolean;
@@ -234,4 +248,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, maskString, 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;
@@ -227,6 +240,7 @@ declare function maskPhone(phone: string): string;
 declare function maskIdCard(idCard: string): string;
 declare function maskBankCard(cardNumber: string): string;
 declare function maskName(name: string): string;
+declare function maskString(str: string, visibleChars?: number, mask?: string): string;
 declare function isValidPhone(phone: string): boolean;
 declare function isValidEmail(email: string): boolean;
 declare function isValidUrl(url: string): boolean;
@@ -234,4 +248,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, maskString, 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

@@ -397,6 +397,111 @@ 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();
@@ -1101,6 +1206,15 @@ function maskName(name) {
   }
   return name.charAt(0) + "*".repeat(name.length - 2) + name.charAt(name.length - 1);
 }
+function maskString(str, visibleChars = 3, mask = "...") {
+  if (!str) return "";
+  if (str.length <= visibleChars * 2) {
+    return str;
+  }
+  const start = str.slice(0, visibleChars);
+  const end = str.slice(-visibleChars);
+  return `${start}${mask}${end}`;
+}
 function isValidPhone(phone) {
   if (!phone) return false;
   return /^1[3-9]\d{9}$/.test(phone);
@@ -1196,6 +1310,9 @@ export {
   formatUTC,
   formatUTCDateOnly,
   formatUTCTimeOnly,
+  formateAmount,
+  formateFaitAmount,
+  formatePrecision,
   fromBase64,
   fromUTC,
   getAllCookies,
@@ -1252,6 +1369,7 @@ export {
   greaterThanOrEqual,
   hasCookie,
   includes,
+  integerTokenArr,
   isAfterDate,
   isAndroid,
   isBeforeDate,
@@ -1279,6 +1397,7 @@ export {
   maskIdCard,
   maskName,
   maskPhone,
+  maskString,
   multiply,
   negate,
   normalizeSpaces,
@@ -1293,6 +1412,7 @@ export {
   readExcelToJSON,
   readFile,
   removeCookie,
+  removeInvalidZero,
   removeSpaces,
   repeat,
   replaceAll,
@@ -1316,6 +1436,7 @@ export {
   titleCase,
   toBase64,
   toISOString,
+  toLocalString,
   toLowerCase,
   toUTC,
   toUpperCase,
@@ -1323,6 +1444,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.27",
+  "version": "1.0.29",
   "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/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,
@@ -187,6 +195,7 @@ export {
   maskIdCard,
   maskBankCard,
   maskName,
+  maskString,
   isValidPhone,
   isValidEmail,
   isValidUrl,

package/src/string/README.md

@@ -90,6 +90,7 @@ import {
   maskIdCard,
   maskBankCard,
   maskName,
+  maskString,
   maskEmail
 } from 'react-util-tools'
 
@@ -106,6 +107,22 @@ maskBankCard('6222021234567890') // '6222 **** **** 7890'
 maskName('张三') // '张*'
 maskName('李四光') // '李*光'
 
+// 通用字符串脱敏
+maskString('123wedwdwddwed567', 3) // '123...567'
+maskString('abcdefghijk', 2) // 'ab...jk'
+maskString('hello', 2, '***') // 'he***lo'
+
+// 邮箱脱敏（在 format 模块）
+maskEmail('test@example.com') // 'tes***@example.com'
+```
+
+// 银行卡号脱敏
+maskBankCard('6222021234567890') // '6222 **** **** 7890'
+
+// 姓名脱敏
+maskName('张三') // '张*'
+maskName('李四光') // '李*光'
+
 // 邮箱脱敏（在 format 模块）
 maskEmail('test@example.com') // 'tes***@example.com'
 ```
@@ -318,6 +335,7 @@ extractNumbers('abc123def456') // [123, 456]
 - `maskIdCard(idCard)` - 身份证号脱敏
 - `maskBankCard(cardNumber)` - 银行卡号脱敏
 - `maskName(name)` - 姓名脱敏
+- `maskString(str, visibleChars?, mask?)` - 通用字符串脱敏
 
 ### 格式验证
 

package/src/string/index.ts

@@ -428,6 +428,31 @@ export function maskName(name: string): string {
   return name.charAt(0) + '*'.repeat(name.length - 2) + name.charAt(name.length - 1)
 }
 
+/**
+ * 通用字符串脱敏：保留前后指定位数，中间用省略号替换
+ * @param str 字符串
+ * @param visibleChars 前后各保留的字符数，默认 3
+ * @param mask 脱敏符号，默认 '...'
+ * @returns 脱敏后的字符串
+ * @example
+ * maskString('123wedwdwddwed567', 3) // '123...567'
+ * maskString('abcdefghijk', 2) // 'ab...jk'
+ * maskString('hello', 2, '***') // 'he***lo'
+ */
+export function maskString(str: string, visibleChars = 3, mask = '...'): string {
+  if (!str) return ''
+  
+  // 如果字符串长度小于等于需要显示的字符数，直接返回原字符串
+  if (str.length <= visibleChars * 2) {
+    return str
+  }
+  
+  const start = str.slice(0, visibleChars)
+  const end = str.slice(-visibleChars)
+  
+  return `${start}${mask}${end}`
+}
+
 /**
  * 判断是否为有效的手机号（中国大陆）
  * @param phone 手机号