react-util-tools 1.0.25 → 1.0.27

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

@@ -149,3 +149,48 @@ export type {
   Sheet2JSONOpts,
   JSON2SheetOpts
 } from './excel/index'
+export {
+  capitalize,
+  camelCase,
+  pascalCase,
+  snakeCase,
+  kebabCase,
+  truncate,
+  trim,
+  trimStart,
+  trimEnd,
+  reverse,
+  repeat,
+  padStart,
+  padEnd,
+  startsWith,
+  endsWith,
+  includes,
+  replaceAll,
+  stripHtml,
+  escapeHtml,
+  unescapeHtml,
+  toLowerCase,
+  toUpperCase,
+  titleCase,
+  isEmpty,
+  isNotEmpty,
+  length,
+  split,
+  extractNumbers,
+  removeSpaces,
+  normalizeSpaces,
+  countOccurrences,
+  randomString,
+  uuid,
+  maskPhone,
+  maskIdCard,
+  maskBankCard,
+  maskName,
+  isValidPhone,
+  isValidEmail,
+  isValidUrl,
+  isValidIdCard,
+  toBase64,
+  fromBase64
+} from './string/index'