react-util-tools 1.0.25 → 1.0.27

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,13 @@ function unmaskEmail(maskedEmail, originalEmail) {
   }
   return maskedEmail;
 }
+function tryRun(fn) {
+  try {
+    return fn();
+  } catch (error) {
+    return null;
+  }
+}
 
 // src/date/index.ts
 import {
@@ -704,19 +713,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 +823,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 +831,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;
   }
@@ -921,6 +930,237 @@ function aoaToSheet(data, options) {
 function sheetToAOA(worksheet, options) {
   return XLSX.utils.sheet_to_json(worksheet, { ...options, header: 1 });
 }
+
+// src/string/index.ts
+function capitalize(str) {
+  if (!str) return "";
+  return str.charAt(0).toUpperCase() + str.slice(1).toLowerCase();
+}
+function camelCase(str) {
+  if (!str) return "";
+  return str.replace(/[-_\s]+(.)?/g, (_, char) => char ? char.toUpperCase() : "").replace(/^[A-Z]/, (char) => char.toLowerCase());
+}
+function pascalCase(str) {
+  if (!str) return "";
+  const camel = camelCase(str);
+  return camel.charAt(0).toUpperCase() + camel.slice(1);
+}
+function snakeCase(str) {
+  if (!str) return "";
+  return str.replace(/([A-Z])/g, "_$1").replace(/[-\s]+/g, "_").replace(/^_/, "").toLowerCase();
+}
+function kebabCase(str) {
+  if (!str) return "";
+  return str.replace(/([A-Z])/g, "-$1").replace(/[_\s]+/g, "-").replace(/^-/, "").toLowerCase();
+}
+function truncate(str, length2, suffix = "...") {
+  if (!str || str.length <= length2) return str;
+  return str.slice(0, length2) + suffix;
+}
+function trim(str) {
+  return str ? str.trim() : "";
+}
+function trimStart(str) {
+  return str ? str.trimStart() : "";
+}
+function trimEnd(str) {
+  return str ? str.trimEnd() : "";
+}
+function reverse(str) {
+  if (!str) return "";
+  return str.split("").reverse().join("");
+}
+function repeat(str, count) {
+  if (!str || count <= 0) return "";
+  return str.repeat(count);
+}
+function padStart(str, length2, padStr = " ") {
+  if (!str) return padStr.repeat(length2);
+  return str.padStart(length2, padStr);
+}
+function padEnd(str, length2, padStr = " ") {
+  if (!str) return padStr.repeat(length2);
+  return str.padEnd(length2, padStr);
+}
+function startsWith(str, searchString) {
+  if (!str) return false;
+  return str.startsWith(searchString);
+}
+function endsWith(str, searchString) {
+  if (!str) return false;
+  return str.endsWith(searchString);
+}
+function includes(str, searchString) {
+  if (!str) return false;
+  return str.includes(searchString);
+}
+function replaceAll(str, search, replacement) {
+  if (!str) return "";
+  if (typeof search === "string") {
+    return str.split(search).join(replacement);
+  }
+  return str.replace(search, replacement);
+}
+function stripHtml(str) {
+  if (!str) return "";
+  return str.replace(/<[^>]*>/g, "");
+}
+function escapeHtml(str) {
+  if (!str) return "";
+  const map = {
+    "&": "&amp;",
+    "<": "&lt;",
+    ">": "&gt;",
+    '"': "&quot;",
+    "'": "&#39;"
+  };
+  return str.replace(/[&<>"']/g, (char) => map[char]);
+}
+function unescapeHtml(str) {
+  if (!str) return "";
+  const map = {
+    "&amp;": "&",
+    "&lt;": "<",
+    "&gt;": ">",
+    "&quot;": '"',
+    "&#39;": "'"
+  };
+  return str.replace(/&(amp|lt|gt|quot|#39);/g, (entity) => map[entity]);
+}
+function toLowerCase(str) {
+  return str ? str.toLowerCase() : "";
+}
+function toUpperCase(str) {
+  return str ? str.toUpperCase() : "";
+}
+function titleCase(str) {
+  if (!str) return "";
+  return str.toLowerCase().split(" ").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
+}
+function isEmpty(str) {
+  return !str || str.trim().length === 0;
+}
+function isNotEmpty(str) {
+  return !isEmpty(str);
+}
+function length(str) {
+  if (!str) return 0;
+  return Array.from(str).length;
+}
+function split(str, separator) {
+  if (!str) return [];
+  return str.split(separator);
+}
+function extractNumbers(str) {
+  if (!str) return [];
+  const matches = str.match(/\d+(\.\d+)?/g);
+  return matches ? matches.map(Number) : [];
+}
+function removeSpaces(str) {
+  if (!str) return "";
+  return str.replace(/\s+/g, "");
+}
+function normalizeSpaces(str) {
+  if (!str) return "";
+  return str.replace(/\s+/g, " ").trim();
+}
+function countOccurrences(str, searchString) {
+  if (!str || !searchString) return 0;
+  return str.split(searchString).length - 1;
+}
+function randomString(length2, chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789") {
+  let result = "";
+  for (let i = 0; i < length2; i++) {
+    result += chars.charAt(Math.floor(Math.random() * chars.length));
+  }
+  return result;
+}
+function uuid() {
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = Math.random() * 16 | 0;
+    const v = c === "x" ? r : r & 3 | 8;
+    return v.toString(16);
+  });
+}
+function maskPhone(phone) {
+  if (!phone || phone.length < 11) return phone;
+  return phone.replace(/(\d{3})\d{4}(\d{4})/, "$1****$2");
+}
+function maskIdCard(idCard) {
+  if (!idCard || idCard.length < 18) return idCard;
+  return idCard.replace(/(\d{6})\d{8}(\d{4})/, "$1********$2");
+}
+function maskBankCard(cardNumber) {
+  if (!cardNumber || cardNumber.length < 16) return cardNumber;
+  return cardNumber.replace(/(\d{4})\d+(\d{4})/, "$1 **** **** $2");
+}
+function maskName(name) {
+  if (!name) return "";
+  if (name.length === 2) {
+    return name.charAt(0) + "*";
+  }
+  return name.charAt(0) + "*".repeat(name.length - 2) + name.charAt(name.length - 1);
+}
+function isValidPhone(phone) {
+  if (!phone) return false;
+  return /^1[3-9]\d{9}$/.test(phone);
+}
+function isValidEmail(email) {
+  if (!email) return false;
+  return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email);
+}
+function isValidUrl(url) {
+  if (!url) return false;
+  try {
+    new URL(url);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function isValidIdCard(idCard) {
+  if (!idCard) return false;
+  return /(^\d{15}$)|(^\d{18}$)|(^\d{17}(\d|X|x)$)/.test(idCard);
+}
+function toBase64(str) {
+  if (!str) return "";
+  if (typeof window !== "undefined" && window.btoa) {
+    try {
+      return window.btoa(encodeURIComponent(str).replace(/%([0-9A-F]{2})/g, (_, p1) => {
+        return String.fromCharCode(parseInt(p1, 16));
+      }));
+    } catch {
+      return "";
+    }
+  }
+  try {
+    const BufferClass = globalThis.Buffer;
+    return BufferClass ? BufferClass.from(str, "utf-8").toString("base64") : "";
+  } catch {
+    return "";
+  }
+}
+function fromBase64(base64) {
+  if (!base64) return "";
+  if (typeof window !== "undefined" && window.atob) {
+    try {
+      const binary = window.atob(base64);
+      const bytes = new Uint8Array(binary.length);
+      for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+      }
+      return new TextDecoder().decode(bytes);
+    } catch {
+      return "";
+    }
+  }
+  try {
+    const BufferClass = globalThis.Buffer;
+    return BufferClass ? BufferClass.from(base64, "base64").toString("utf-8") : "";
+  } catch {
+    return "";
+  }
+}
 export {
   default2 as Decimal,
   XLSX,
@@ -931,13 +1171,19 @@ export {
   addMonthsToDate,
   addMonthsUTC,
   aoaToSheet,
+  camelCase,
+  capitalize,
   ceil,
   clearAllCookies,
+  countOccurrences,
   debounceFn as debounce,
   divide,
+  endsWith,
   equals,
+  escapeHtml,
   exportExcelFile,
   exportJSONToExcel,
+  extractNumbers,
   floor,
   formatDate,
   formatDateOnly,
@@ -950,6 +1196,7 @@ export {
   formatUTC,
   formatUTCDateOnly,
   formatUTCTimeOnly,
+  fromBase64,
   fromUTC,
   getAllCookies,
   getAllQueryParams,
@@ -1004,35 +1251,61 @@ export {
   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,
   read2 as read,
   readExcelFile,
   readExcelToJSON,
   readFile,
   removeCookie,
+  removeSpaces,
+  repeat,
+  replaceAll,
+  reverse,
   round,
   setCookie,
   sheetToAOA,
   sheetToCSV,
   sheetToHTML,
+  snakeCase,
+  split,
+  startsWith,
+  stripHtml,
   subDaysFromDate,
   subDaysUTC,
   subMonthsFromDate,
@@ -1040,10 +1313,20 @@ export {
   subtract,
   tableToSheet,
   throttleFn as throttle,
+  titleCase,
+  toBase64,
   toISOString,
+  toLowerCase,
   toUTC,
+  toUpperCase,
+  trim,
+  trimEnd,
+  trimStart,
+  truncate,
+  unescapeHtml,
   unmaskEmail,
   utils2 as utils,
+  uuid,
   workbookToJSON,
   write,
   writeFile2 as writeFile,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-util-tools",
-  "version": "1.0.25",
+  "version": "1.0.27",
   "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",