react-util-tools 1.0.24 → 1.0.25

package/README.md

@@ -60,6 +60,16 @@ const total = new Decimal('0.1').plus('0.2') // Decimal(0.3)
 
 [查看文档](./src/address/README.md)
 
+### 🍪 Cookie - Cookie 操作
+- `setCookie()` - 设置 Cookie
+- `getCookie()` - 获取 Cookie
+- `removeCookie()` - 删除 Cookie
+- `hasCookie()` - 检查 Cookie 是否存在
+- `getAllCookies()` - 获取所有 Cookie
+- `clearAllCookies()` - 清除所有 Cookie
+
+[查看文档](./src/cookie/README.md)
+
 ### 📱 Device - 设备检测
 - `getOS()` - 获取操作系统
 - `getBrowser()` - 获取浏览器类型
@@ -76,6 +86,8 @@ const total = new Decimal('0.1').plus('0.2') // Decimal(0.3)
 - `formatNumber()` - 数字格式化
 - `formatMoneyToChinese()` - 金额转中文大写
 - `formatPercent()` - 百分比格式化
+- `maskEmail()` - 邮箱脱敏
+- `unmaskEmail()` - 邮箱解脱敏
 
 [查看文档](./src/format/README.md)
 
@@ -108,6 +120,31 @@ const total = new Decimal('0.1').plus('0.2') // Decimal(0.3)
 
 [查看文档](./src/decimal/README.md)
 
+#### Decimal Utils - 高精度计算工具函数
+- `add()` - 加法运算
+- `subtract()` - 减法运算
+- `multiply()` - 乘法运算
+- `divide()` - 除法运算
+- `equals()` - 判断相等
+- `greaterThan()` / `lessThan()` - 大小比较
+- `round()` / `ceil()` / `floor()` - 取整
+- `abs()` / `negate()` - 绝对值/取反
+
+[查看文档](./src/decimal/utils/README.md)
+
+### 📊 Excel - Excel 文件处理
+基于 SheetJS (xlsx) 的 Excel 文件处理工具：
+- `XLSX` - 完整的 SheetJS 对象
+- `readExcelFile()` - 读取 Excel 文件
+- `exportJSONToExcel()` - 导出 JSON 为 Excel
+- `workbookToJSON()` - WorkBook 转 JSON
+- `jsonToWorkbook()` - JSON 转 WorkBook
+- `readExcelToJSON()` - 直接读取为 JSON
+- 支持多种格式（.xlsx, .xls, .csv 等）
+- 完整保留 SheetJS 所有功能
+
+[查看文档](./src/excel/README.md)
+
 ## 使用示例
 
 ### 节流防抖
@@ -136,6 +173,26 @@ const id = getQueryParam('id') // "123"
 const params = getAllQueryParams() // { id: "123", name: "test" }
 ```
 
+### Cookie 操作
+
+```typescript
+import { setCookie, getCookie, removeCookie } from '@dj49846917/react-tools'
+
+// 设置 Cookie
+setCookie('token', 'abc123', {
+  expires: 7 * 24 * 60 * 60, // 7天（秒）
+  path: '/',
+  secure: true,
+  sameSite: 'Strict'
+})
+
+// 获取 Cookie
+const token = getCookie('token') // "abc123"
+
+// 删除 Cookie
+removeCookie('token')
+```
+
 ### 设备检测
 
 ```typescript
@@ -152,7 +209,7 @@ if (isMobile()) {
 ### 金额格式化
 
 ```typescript
-import { formatMoney, parseMoney, formatMoneyToChinese } from 'react-tools'
+import { formatMoney, parseMoney, formatMoneyToChinese, maskEmail } from 'react-tools'
 
 formatMoney(1234.56) // "¥1,234.56"
 formatMoney(1234.56, { symbol: '$' }) // "$1,234.56"
@@ -160,6 +217,9 @@ formatMoney(1234.56, { symbol: '$' }) // "$1,234.56"
 parseMoney('¥1,234.56') // 1234.56
 
 formatMoneyToChinese(1234.56) // "壹仟贰佰叁拾肆元伍角陆分"
+
+// 邮箱脱敏
+maskEmail('dj49846917@proton.me') // "dj4***@proton.me"
 ```
 
 ### 日期处理
@@ -203,9 +263,9 @@ getUTCWeekStart(2024, 10) // Date 对象
 ### 高精度计算
 
 ```typescript
-import { Decimal } from 'react-tools'
+import { Decimal, add, multiply, divide } from 'react-tools'
 
-// 解决浮点数精度问题
+// 使用 Decimal 类
 const result = new Decimal('0.1').plus('0.2')
 console.log(result.toString()) // "0.3"
 
@@ -214,6 +274,32 @@ const price = new Decimal('19.99')
 const quantity = new Decimal('3')
 const total = price.times(quantity)
 console.log(total.toFixed(2)) // "59.97"
+
+// 使用工具函数（返回 number 类型）
+add(0.1, 0.2) // 0.3
+multiply(19.99, 3) // 59.97
+divide(100, 3) // 33.333...
+```
+
+### Excel 文件处理
+
+```typescript
+import { readExcelToJSON, exportJSONToExcel } from 'react-tools'
+
+// 读取 Excel 文件
+async function handleFileUpload(file: File) {
+  const data = await readExcelToJSON(file)
+  console.log(data) // [{ name: '张三', age: 25 }, ...]
+}
+
+// 导出 JSON 为 Excel
+function exportData() {
+  const data = [
+    { name: '张三', age: 25, city: '北京' },
+    { name: '李四', age: 30, city: '上海' }
+  ]
+  exportJSONToExcel(data, 'users.xlsx', 'UserList')
+}
 ```
 
 ## TypeScript 支持
@@ -244,6 +330,7 @@ import { formatMoney, Decimal } from 'react-tools'
 - `date-fns` - 日期处理
 - `date-fns-tz` - 时区处理
 - `decimal.js` - 高精度计算
+- `xlsx` - Excel 文件处理
 
 ## 许可证
 

package/dist/index.cjs

@@ -31,17 +31,21 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   Decimal: () => import_decimal.default,
+  XLSX: () => XLSX,
   abs: () => abs,
   add: () => add,
   addDaysToDate: () => addDaysToDate,
   addDaysUTC: () => addDaysUTC,
   addMonthsToDate: () => addMonthsToDate,
   addMonthsUTC: () => addMonthsUTC,
+  aoaToSheet: () => aoaToSheet,
   ceil: () => ceil,
   clearAllCookies: () => clearAllCookies,
   debounce: () => debounceFn,
   divide: () => divide,
   equals: () => equals,
+  exportExcelFile: () => exportExcelFile,
+  exportJSONToExcel: () => exportJSONToExcel,
   floor: () => floor,
   formatDate: () => formatDate,
   formatDateOnly: () => formatDateOnly,
@@ -75,6 +79,8 @@ __export(index_exports, {
   getQueryParam: () => getQueryParam,
   getQueryParamAll: () => getQueryParamAll,
   getScreenResolution: () => getScreenResolution,
+  getSheet: () => getSheet,
+  getSheetNames: () => getSheetNames,
   getStartOfDay: () => getStartOfDay,
   getStartOfMonth: () => getStartOfMonth,
   getStartOfWeek: () => getStartOfWeek,
@@ -117,6 +123,7 @@ __export(index_exports, {
   isTouchDevice: () => isTouchDevice,
   isValidDate: () => isValidDate,
   isWeChat: () => isWeChat,
+  jsonToWorkbook: () => jsonToWorkbook,
   lessThan: () => lessThan,
   lessThanOrEqual: () => lessThanOrEqual,
   maskEmail: () => maskEmail,
@@ -124,18 +131,31 @@ __export(index_exports, {
   negate: () => negate,
   parseDate: () => parseDate,
   parseMoney: () => parseMoney,
+  read: () => read2,
+  readExcelFile: () => readExcelFile,
+  readExcelToJSON: () => readExcelToJSON,
+  readFile: () => readFile,
   removeCookie: () => removeCookie,
   round: () => round,
   setCookie: () => setCookie,
+  sheetToAOA: () => sheetToAOA,
+  sheetToCSV: () => sheetToCSV,
+  sheetToHTML: () => sheetToHTML,
   subDaysFromDate: () => subDaysFromDate,
   subDaysUTC: () => subDaysUTC,
   subMonthsFromDate: () => subMonthsFromDate,
   subMonthsUTC: () => subMonthsUTC,
   subtract: () => subtract,
+  tableToSheet: () => tableToSheet,
   throttle: () => throttleFn,
   toISOString: () => toISOString,
   toUTC: () => toUTC,
-  unmaskEmail: () => unmaskEmail
+  unmaskEmail: () => unmaskEmail,
+  utils: () => utils2,
+  workbookToJSON: () => workbookToJSON,
+  write: () => write,
+  writeFile: () => writeFile2,
+  writeFileXLSX: () => writeFileXLSX
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -941,20 +961,102 @@ function negate(value) {
     return 0;
   }
 }
+
+// src/excel/index.ts
+var XLSX = __toESM(require("xlsx"), 1);
+var {
+  read: read2,
+  readFile,
+  write,
+  writeFile: writeFile2,
+  writeFileXLSX,
+  utils: utils2
+} = XLSX;
+function readExcelFile(file, options) {
+  return new Promise((resolve, reject) => {
+    const reader = new FileReader();
+    reader.onload = (e) => {
+      try {
+        const data = e.target?.result;
+        const workbook = XLSX.read(data, options);
+        resolve(workbook);
+      } catch (error) {
+        reject(error);
+      }
+    };
+    reader.onerror = () => {
+      reject(new Error("Failed to read file"));
+    };
+    reader.readAsArrayBuffer(file);
+  });
+}
+function workbookToJSON(workbook, sheetName, options) {
+  const sheet = sheetName ? workbook.Sheets[sheetName] : workbook.Sheets[workbook.SheetNames[0]];
+  if (!sheet) {
+    throw new Error(`Sheet "${sheetName}" not found`);
+  }
+  return XLSX.utils.sheet_to_json(sheet, options);
+}
+function jsonToWorkbook(data, sheetName = "Sheet1", options) {
+  const worksheet = XLSX.utils.json_to_sheet(data, options);
+  const workbook = XLSX.utils.book_new();
+  XLSX.utils.book_append_sheet(workbook, worksheet, sheetName);
+  return workbook;
+}
+function exportExcelFile(workbook, filename = "export.xlsx", options) {
+  XLSX.writeFile(workbook, filename, options);
+}
+function exportJSONToExcel(data, filename = "export.xlsx", sheetName = "Sheet1", options) {
+  const workbook = jsonToWorkbook(data, sheetName);
+  exportExcelFile(workbook, filename, options);
+}
+async function readExcelToJSON(file, sheetName, parseOptions, jsonOptions) {
+  const workbook = await readExcelFile(file, parseOptions);
+  return workbookToJSON(workbook, sheetName, jsonOptions);
+}
+function getSheetNames(workbook) {
+  return workbook.SheetNames;
+}
+function getSheet(workbook, sheetName) {
+  const sheet = workbook.Sheets[sheetName];
+  if (!sheet) {
+    throw new Error(`Sheet "${sheetName}" not found`);
+  }
+  return sheet;
+}
+function sheetToCSV(worksheet, options) {
+  return XLSX.utils.sheet_to_csv(worksheet, options);
+}
+function sheetToHTML(worksheet, options) {
+  return XLSX.utils.sheet_to_html(worksheet, options);
+}
+function tableToSheet(table, options) {
+  return XLSX.utils.table_to_sheet(table, options);
+}
+function aoaToSheet(data, options) {
+  return XLSX.utils.aoa_to_sheet(data, options);
+}
+function sheetToAOA(worksheet, options) {
+  return XLSX.utils.sheet_to_json(worksheet, { ...options, header: 1 });
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Decimal,
+  XLSX,
   abs,
   add,
   addDaysToDate,
   addDaysUTC,
   addMonthsToDate,
   addMonthsUTC,
+  aoaToSheet,
   ceil,
   clearAllCookies,
   debounce,
   divide,
   equals,
+  exportExcelFile,
+  exportJSONToExcel,
   floor,
   formatDate,
   formatDateOnly,
@@ -988,6 +1090,8 @@ function negate(value) {
   getQueryParam,
   getQueryParamAll,
   getScreenResolution,
+  getSheet,
+  getSheetNames,
   getStartOfDay,
   getStartOfMonth,
   getStartOfWeek,
@@ -1030,6 +1134,7 @@ function negate(value) {
   isTouchDevice,
   isValidDate,
   isWeChat,
+  jsonToWorkbook,
   lessThan,
   lessThanOrEqual,
   maskEmail,
@@ -1037,16 +1142,29 @@ function negate(value) {
   negate,
   parseDate,
   parseMoney,
+  read,
+  readExcelFile,
+  readExcelToJSON,
+  readFile,
   removeCookie,
   round,
   setCookie,
+  sheetToAOA,
+  sheetToCSV,
+  sheetToHTML,
   subDaysFromDate,
   subDaysUTC,
   subMonthsFromDate,
   subMonthsUTC,
   subtract,
+  tableToSheet,
   throttle,
   toISOString,
   toUTC,
-  unmaskEmail
+  unmaskEmail,
+  utils,
+  workbookToJSON,
+  write,
+  writeFile,
+  writeFileXLSX
 });

package/dist/index.d.cts

@@ -1,5 +1,8 @@
 import Decimal from 'decimal.js';
 export { default as Decimal, Decimal as DecimalType } from 'decimal.js';
+import * as XLSX from 'xlsx';
+export { XLSX };
+export { BookType, CellObject, JSON2SheetOpts, ParsingOptions, Range, Sheet2JSONOpts, WorkBook, WorkSheet, WritingOptions } from 'xlsx';
 
 declare function throttleFn<T extends (...args: any[]) => any>(fn: T, wait?: number, options?: {
     leading?: boolean;
@@ -167,4 +170,24 @@ declare function floor(value: number | string | Decimal, decimalPlaces?: number)
 declare function abs(value: number | string | Decimal): number;
 declare function negate(value: number | string | Decimal): number;
 
-export { type CookieOptions, abs, add, addDaysToDate, addDaysUTC, addMonthsToDate, addMonthsUTC, ceil, clearAllCookies, debounceFn as debounce, divide, equals, floor, formatDate, formatDateOnly, formatMoney, formatMoneyToChinese, formatNumber, formatPercent, formatRelativeTime, formatTimeOnly, formatUTC, formatUTCDateOnly, formatUTCTimeOnly, fromUTC, getAllCookies, getAllQueryParams, getBrowser, getBrowserEngine, getBrowserVersion, getCookie, getDaysDiff, getDeviceInfo, getDevicePixelRatio, getDeviceType, getEndOfDay, getEndOfMonth, getEndOfWeek, getEndOfYear, getHoursDiff, getMinutesDiff, getOS, getQueryParam, getQueryParamAll, getScreenResolution, 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, isAfterDate, isAndroid, isBeforeDate, isDesktop, isIOS, isMobile, isSameDayDate, isTablet, isTouchDevice, isValidDate, isWeChat, lessThan, lessThanOrEqual, maskEmail, multiply, negate, parseDate, parseMoney, removeCookie, round, setCookie, subDaysFromDate, subDaysUTC, subMonthsFromDate, subMonthsUTC, subtract, throttleFn as throttle, toISOString, toUTC, unmaskEmail };
+declare const read: typeof XLSX.read;
+declare const readFile: typeof XLSX.readFile;
+declare const write: typeof XLSX.write;
+declare const writeFile: typeof XLSX.writeFile;
+declare const writeFileXLSX: typeof XLSX.writeFileXLSX;
+declare const utils: XLSX.XLSX$Utils;
+declare function readExcelFile(file: File, options?: XLSX.ParsingOptions): Promise<XLSX.WorkBook>;
+declare function workbookToJSON<T = any>(workbook: XLSX.WorkBook, sheetName?: string, options?: XLSX.Sheet2JSONOpts): T[];
+declare function jsonToWorkbook<T = any>(data: T[], sheetName?: string, options?: XLSX.JSON2SheetOpts): XLSX.WorkBook;
+declare function exportExcelFile(workbook: XLSX.WorkBook, filename?: string, options?: XLSX.WritingOptions): void;
+declare function exportJSONToExcel<T = any>(data: T[], filename?: string, sheetName?: string, options?: XLSX.WritingOptions): void;
+declare function readExcelToJSON<T = any>(file: File, sheetName?: string, parseOptions?: XLSX.ParsingOptions, jsonOptions?: XLSX.Sheet2JSONOpts): Promise<T[]>;
+declare function getSheetNames(workbook: XLSX.WorkBook): string[];
+declare function getSheet(workbook: XLSX.WorkBook, sheetName: string): XLSX.WorkSheet;
+declare function sheetToCSV(worksheet: XLSX.WorkSheet, options?: XLSX.Sheet2CSVOpts): string;
+declare function sheetToHTML(worksheet: XLSX.WorkSheet, options?: XLSX.Sheet2HTMLOpts): string;
+declare function tableToSheet(table: HTMLElement | string, options?: XLSX.Table2SheetOpts): XLSX.WorkSheet;
+declare function aoaToSheet(data: any[][], options?: XLSX.AOA2SheetOpts): XLSX.WorkSheet;
+declare function sheetToAOA(worksheet: XLSX.WorkSheet, options?: XLSX.Sheet2JSONOpts): any[][];
+
+export { type CookieOptions, abs, add, addDaysToDate, addDaysUTC, addMonthsToDate, addMonthsUTC, aoaToSheet, ceil, clearAllCookies, debounceFn as debounce, divide, equals, exportExcelFile, exportJSONToExcel, floor, formatDate, formatDateOnly, formatMoney, formatMoneyToChinese, formatNumber, formatPercent, formatRelativeTime, formatTimeOnly, formatUTC, formatUTCDateOnly, formatUTCTimeOnly, 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, isAfterDate, isAndroid, isBeforeDate, isDesktop, isIOS, isMobile, isSameDayDate, isTablet, isTouchDevice, isValidDate, isWeChat, jsonToWorkbook, lessThan, lessThanOrEqual, maskEmail, multiply, negate, parseDate, parseMoney, read, readExcelFile, readExcelToJSON, readFile, removeCookie, round, setCookie, sheetToAOA, sheetToCSV, sheetToHTML, subDaysFromDate, subDaysUTC, subMonthsFromDate, subMonthsUTC, subtract, tableToSheet, throttleFn as throttle, toISOString, toUTC, unmaskEmail, utils, workbookToJSON, write, writeFile, writeFileXLSX };

package/dist/index.d.ts

@@ -1,5 +1,8 @@
 import Decimal from 'decimal.js';
 export { default as Decimal, Decimal as DecimalType } from 'decimal.js';
+import * as XLSX from 'xlsx';
+export { XLSX };
+export { BookType, CellObject, JSON2SheetOpts, ParsingOptions, Range, Sheet2JSONOpts, WorkBook, WorkSheet, WritingOptions } from 'xlsx';
 
 declare function throttleFn<T extends (...args: any[]) => any>(fn: T, wait?: number, options?: {
     leading?: boolean;
@@ -167,4 +170,24 @@ declare function floor(value: number | string | Decimal, decimalPlaces?: number)
 declare function abs(value: number | string | Decimal): number;
 declare function negate(value: number | string | Decimal): number;
 
-export { type CookieOptions, abs, add, addDaysToDate, addDaysUTC, addMonthsToDate, addMonthsUTC, ceil, clearAllCookies, debounceFn as debounce, divide, equals, floor, formatDate, formatDateOnly, formatMoney, formatMoneyToChinese, formatNumber, formatPercent, formatRelativeTime, formatTimeOnly, formatUTC, formatUTCDateOnly, formatUTCTimeOnly, fromUTC, getAllCookies, getAllQueryParams, getBrowser, getBrowserEngine, getBrowserVersion, getCookie, getDaysDiff, getDeviceInfo, getDevicePixelRatio, getDeviceType, getEndOfDay, getEndOfMonth, getEndOfWeek, getEndOfYear, getHoursDiff, getMinutesDiff, getOS, getQueryParam, getQueryParamAll, getScreenResolution, 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, isAfterDate, isAndroid, isBeforeDate, isDesktop, isIOS, isMobile, isSameDayDate, isTablet, isTouchDevice, isValidDate, isWeChat, lessThan, lessThanOrEqual, maskEmail, multiply, negate, parseDate, parseMoney, removeCookie, round, setCookie, subDaysFromDate, subDaysUTC, subMonthsFromDate, subMonthsUTC, subtract, throttleFn as throttle, toISOString, toUTC, unmaskEmail };
+declare const read: typeof XLSX.read;
+declare const readFile: typeof XLSX.readFile;
+declare const write: typeof XLSX.write;
+declare const writeFile: typeof XLSX.writeFile;
+declare const writeFileXLSX: typeof XLSX.writeFileXLSX;
+declare const utils: XLSX.XLSX$Utils;
+declare function readExcelFile(file: File, options?: XLSX.ParsingOptions): Promise<XLSX.WorkBook>;
+declare function workbookToJSON<T = any>(workbook: XLSX.WorkBook, sheetName?: string, options?: XLSX.Sheet2JSONOpts): T[];
+declare function jsonToWorkbook<T = any>(data: T[], sheetName?: string, options?: XLSX.JSON2SheetOpts): XLSX.WorkBook;
+declare function exportExcelFile(workbook: XLSX.WorkBook, filename?: string, options?: XLSX.WritingOptions): void;
+declare function exportJSONToExcel<T = any>(data: T[], filename?: string, sheetName?: string, options?: XLSX.WritingOptions): void;
+declare function readExcelToJSON<T = any>(file: File, sheetName?: string, parseOptions?: XLSX.ParsingOptions, jsonOptions?: XLSX.Sheet2JSONOpts): Promise<T[]>;
+declare function getSheetNames(workbook: XLSX.WorkBook): string[];
+declare function getSheet(workbook: XLSX.WorkBook, sheetName: string): XLSX.WorkSheet;
+declare function sheetToCSV(worksheet: XLSX.WorkSheet, options?: XLSX.Sheet2CSVOpts): string;
+declare function sheetToHTML(worksheet: XLSX.WorkSheet, options?: XLSX.Sheet2HTMLOpts): string;
+declare function tableToSheet(table: HTMLElement | string, options?: XLSX.Table2SheetOpts): XLSX.WorkSheet;
+declare function aoaToSheet(data: any[][], options?: XLSX.AOA2SheetOpts): XLSX.WorkSheet;
+declare function sheetToAOA(worksheet: XLSX.WorkSheet, options?: XLSX.Sheet2JSONOpts): any[][];
+
+export { type CookieOptions, abs, add, addDaysToDate, addDaysUTC, addMonthsToDate, addMonthsUTC, aoaToSheet, ceil, clearAllCookies, debounceFn as debounce, divide, equals, exportExcelFile, exportJSONToExcel, floor, formatDate, formatDateOnly, formatMoney, formatMoneyToChinese, formatNumber, formatPercent, formatRelativeTime, formatTimeOnly, formatUTC, formatUTCDateOnly, formatUTCTimeOnly, 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, isAfterDate, isAndroid, isBeforeDate, isDesktop, isIOS, isMobile, isSameDayDate, isTablet, isTouchDevice, isValidDate, isWeChat, jsonToWorkbook, lessThan, lessThanOrEqual, maskEmail, multiply, negate, parseDate, parseMoney, read, readExcelFile, readExcelToJSON, readFile, removeCookie, round, setCookie, sheetToAOA, sheetToCSV, sheetToHTML, subDaysFromDate, subDaysUTC, subMonthsFromDate, subMonthsUTC, subtract, tableToSheet, throttleFn as throttle, toISOString, toUTC, unmaskEmail, utils, workbookToJSON, write, writeFile, writeFileXLSX };

package/dist/index.js

@@ -843,19 +843,101 @@ function negate(value) {
     return 0;
   }
 }
+
+// src/excel/index.ts
+import * as XLSX from "xlsx";
+var {
+  read: read2,
+  readFile,
+  write,
+  writeFile: writeFile2,
+  writeFileXLSX,
+  utils: utils2
+} = XLSX;
+function readExcelFile(file, options) {
+  return new Promise((resolve, reject) => {
+    const reader = new FileReader();
+    reader.onload = (e) => {
+      try {
+        const data = e.target?.result;
+        const workbook = XLSX.read(data, options);
+        resolve(workbook);
+      } catch (error) {
+        reject(error);
+      }
+    };
+    reader.onerror = () => {
+      reject(new Error("Failed to read file"));
+    };
+    reader.readAsArrayBuffer(file);
+  });
+}
+function workbookToJSON(workbook, sheetName, options) {
+  const sheet = sheetName ? workbook.Sheets[sheetName] : workbook.Sheets[workbook.SheetNames[0]];
+  if (!sheet) {
+    throw new Error(`Sheet "${sheetName}" not found`);
+  }
+  return XLSX.utils.sheet_to_json(sheet, options);
+}
+function jsonToWorkbook(data, sheetName = "Sheet1", options) {
+  const worksheet = XLSX.utils.json_to_sheet(data, options);
+  const workbook = XLSX.utils.book_new();
+  XLSX.utils.book_append_sheet(workbook, worksheet, sheetName);
+  return workbook;
+}
+function exportExcelFile(workbook, filename = "export.xlsx", options) {
+  XLSX.writeFile(workbook, filename, options);
+}
+function exportJSONToExcel(data, filename = "export.xlsx", sheetName = "Sheet1", options) {
+  const workbook = jsonToWorkbook(data, sheetName);
+  exportExcelFile(workbook, filename, options);
+}
+async function readExcelToJSON(file, sheetName, parseOptions, jsonOptions) {
+  const workbook = await readExcelFile(file, parseOptions);
+  return workbookToJSON(workbook, sheetName, jsonOptions);
+}
+function getSheetNames(workbook) {
+  return workbook.SheetNames;
+}
+function getSheet(workbook, sheetName) {
+  const sheet = workbook.Sheets[sheetName];
+  if (!sheet) {
+    throw new Error(`Sheet "${sheetName}" not found`);
+  }
+  return sheet;
+}
+function sheetToCSV(worksheet, options) {
+  return XLSX.utils.sheet_to_csv(worksheet, options);
+}
+function sheetToHTML(worksheet, options) {
+  return XLSX.utils.sheet_to_html(worksheet, options);
+}
+function tableToSheet(table, options) {
+  return XLSX.utils.table_to_sheet(table, options);
+}
+function aoaToSheet(data, options) {
+  return XLSX.utils.aoa_to_sheet(data, options);
+}
+function sheetToAOA(worksheet, options) {
+  return XLSX.utils.sheet_to_json(worksheet, { ...options, header: 1 });
+}
 export {
   default2 as Decimal,
+  XLSX,
   abs,
   add,
   addDaysToDate,
   addDaysUTC,
   addMonthsToDate,
   addMonthsUTC,
+  aoaToSheet,
   ceil,
   clearAllCookies,
   debounceFn as debounce,
   divide,
   equals,
+  exportExcelFile,
+  exportJSONToExcel,
   floor,
   formatDate,
   formatDateOnly,
@@ -889,6 +971,8 @@ export {
   getQueryParam,
   getQueryParamAll,
   getScreenResolution,
+  getSheet,
+  getSheetNames,
   getStartOfDay,
   getStartOfMonth,
   getStartOfWeek,
@@ -931,6 +1015,7 @@ export {
   isTouchDevice,
   isValidDate,
   isWeChat,
+  jsonToWorkbook,
   lessThan,
   lessThanOrEqual,
   maskEmail,
@@ -938,16 +1023,29 @@ export {
   negate,
   parseDate,
   parseMoney,
+  read2 as read,
+  readExcelFile,
+  readExcelToJSON,
+  readFile,
   removeCookie,
   round,
   setCookie,
+  sheetToAOA,
+  sheetToCSV,
+  sheetToHTML,
   subDaysFromDate,
   subDaysUTC,
   subMonthsFromDate,
   subMonthsUTC,
   subtract,
+  tableToSheet,
   throttleFn as throttle,
   toISOString,
   toUTC,
-  unmaskEmail
+  unmaskEmail,
+  utils2 as utils,
+  workbookToJSON,
+  write,
+  writeFile2 as writeFile,
+  writeFileXLSX
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "react-util-tools",
-  "version": "1.0.24",
-  "description": "A collection of useful utilities: throttle, debounce, date formatting, device detection, money formatting, decimal calculations and more",
+  "version": "1.0.25",
+  "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",
   "module": "dist/index.js",
@@ -36,6 +36,10 @@
     "browser-detection",
     "money-format",
     "url-params",
+    "excel",
+    "xlsx",
+    "sheetjs",
+    "cookie",
     "typescript"
   ],
   "author": "alice & bobby",
@@ -62,6 +66,7 @@
   "dependencies": {
     "date-fns": "^4.1.0",
     "date-fns-tz": "^3.2.0",
-    "decimal.js": "^10.6.0"
+    "decimal.js": "^10.6.0",
+    "xlsx": "^0.18.5"
   }
 }