react-util-tools 1.0.25 → 1.0.26

package/dist/index.js

@@ -921,6 +921,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 +1162,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 +1187,7 @@ export {
   formatUTC,
   formatUTCDateOnly,
   formatUTCTimeOnly,
+  fromBase64,
   fromUTC,
   getAllCookies,
   getAllQueryParams,
@@ -1004,35 +1242,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 +1304,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.26",
   "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

@@ -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'