react-util-tools 1.0.23 → 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,16 +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,
@@ -54,10 +59,12 @@ __export(index_exports, {
   formatUTCDateOnly: () => formatUTCDateOnly,
   formatUTCTimeOnly: () => formatUTCTimeOnly,
   fromUTC: () => fromUTC,
+  getAllCookies: () => getAllCookies,
   getAllQueryParams: () => getAllQueryParams,
   getBrowser: () => getBrowser,
   getBrowserEngine: () => getBrowserEngine,
   getBrowserVersion: () => getBrowserVersion,
+  getCookie: () => getCookie,
   getDaysDiff: () => getDaysDiff,
   getDeviceInfo: () => getDeviceInfo,
   getDevicePixelRatio: () => getDevicePixelRatio,
@@ -72,6 +79,8 @@ __export(index_exports, {
   getQueryParam: () => getQueryParam,
   getQueryParamAll: () => getQueryParamAll,
   getScreenResolution: () => getScreenResolution,
+  getSheet: () => getSheet,
+  getSheetNames: () => getSheetNames,
   getStartOfDay: () => getStartOfDay,
   getStartOfMonth: () => getStartOfMonth,
   getStartOfWeek: () => getStartOfWeek,
@@ -102,6 +111,7 @@ __export(index_exports, {
   getViewportSize: () => getViewportSize,
   greaterThan: () => greaterThan,
   greaterThanOrEqual: () => greaterThanOrEqual,
+  hasCookie: () => hasCookie,
   isAfterDate: () => isAfterDate,
   isAndroid: () => isAndroid,
   isBeforeDate: () => isBeforeDate,
@@ -113,21 +123,39 @@ __export(index_exports, {
   isTouchDevice: () => isTouchDevice,
   isValidDate: () => isValidDate,
   isWeChat: () => isWeChat,
+  jsonToWorkbook: () => jsonToWorkbook,
   lessThan: () => lessThan,
   lessThanOrEqual: () => lessThanOrEqual,
+  maskEmail: () => maskEmail,
   multiply: () => multiply,
   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
+  toUTC: () => toUTC,
+  unmaskEmail: () => unmaskEmail,
+  utils: () => utils2,
+  workbookToJSON: () => workbookToJSON,
+  write: () => write,
+  writeFile: () => writeFile2,
+  writeFileXLSX: () => writeFileXLSX
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -208,6 +236,66 @@ function getQueryParamAll(key, url) {
   return searchParams.getAll(key);
 }
 
+// src/cookie/index.ts
+function setCookie(name, value, options = {}) {
+  let cookieString = `${encodeURIComponent(name)}=${encodeURIComponent(value)}`;
+  if (options.expires) {
+    const expires = options.expires instanceof Date ? options.expires : new Date(Date.now() + options.expires * 1e3);
+    cookieString += `; expires=${expires.toUTCString()}`;
+  }
+  if (options.path) {
+    cookieString += `; path=${options.path}`;
+  }
+  if (options.domain) {
+    cookieString += `; domain=${options.domain}`;
+  }
+  if (options.secure) {
+    cookieString += "; secure";
+  }
+  if (options.sameSite) {
+    cookieString += `; SameSite=${options.sameSite}`;
+  }
+  document.cookie = cookieString;
+}
+function getCookie(name) {
+  const nameEQ = encodeURIComponent(name) + "=";
+  const cookies = document.cookie.split(";");
+  for (let cookie of cookies) {
+    cookie = cookie.trim();
+    if (cookie.indexOf(nameEQ) === 0) {
+      return decodeURIComponent(cookie.substring(nameEQ.length));
+    }
+  }
+  return null;
+}
+function removeCookie(name, options = {}) {
+  setCookie(name, "", {
+    ...options,
+    expires: /* @__PURE__ */ new Date(0)
+  });
+}
+function hasCookie(name) {
+  return getCookie(name) !== null;
+}
+function getAllCookies() {
+  const cookies = {};
+  const cookieArray = document.cookie.split(";");
+  for (let cookie of cookieArray) {
+    cookie = cookie.trim();
+    const [name, ...valueParts] = cookie.split("=");
+    if (name) {
+      cookies[decodeURIComponent(name)] = decodeURIComponent(valueParts.join("="));
+    }
+  }
+  return cookies;
+}
+function clearAllCookies(options = {}) {
+  const cookies = getAllCookies();
+  for (const name in cookies) {
+    removeCookie(name, options);
+  }
+}
+
 // src/device/index.ts
 function getUserAgent() {
   return navigator.userAgent.toLowerCase();
@@ -435,6 +523,39 @@ function formatPercent(value, options = {}) {
   const num = multiply2 ? value * 100 : value;
   return num.toFixed(decimals) + "%";
 }
+function maskEmail(email) {
+  if (!email || typeof email !== "string") {
+    return "";
+  }
+  const atIndex = email.indexOf("@");
+  if (atIndex <= 0) {
+    return email;
+  }
+  const localPart = email.substring(0, atIndex);
+  const domainPart = email.substring(atIndex);
+  const visiblePart = localPart.substring(0, 3);
+  return `${visiblePart}***${domainPart}`;
+}
+function unmaskEmail(maskedEmail, originalEmail) {
+  if (!maskedEmail || !originalEmail) {
+    return "";
+  }
+  if (!maskedEmail.includes("***@")) {
+    return maskedEmail;
+  }
+  const maskedParts = maskedEmail.split("***@");
+  const atIndex = originalEmail.indexOf("@");
+  if (atIndex <= 0) {
+    return maskedEmail;
+  }
+  const originalPrefix = originalEmail.substring(0, 3);
+  const originalDomain = originalEmail.substring(atIndex + 1);
+  const maskedDomain = maskedParts[1];
+  if (maskedParts[0] === originalPrefix && maskedDomain === originalDomain) {
+    return originalEmail;
+  }
+  return maskedEmail;
+}
 
 // src/date/index.ts
 var import_date_fns = require("date-fns");
@@ -840,19 +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,
@@ -866,10 +1070,12 @@ function negate(value) {
   formatUTCDateOnly,
   formatUTCTimeOnly,
   fromUTC,
+  getAllCookies,
   getAllQueryParams,
   getBrowser,
   getBrowserEngine,
   getBrowserVersion,
+  getCookie,
   getDaysDiff,
   getDeviceInfo,
   getDevicePixelRatio,
@@ -884,6 +1090,8 @@ function negate(value) {
   getQueryParam,
   getQueryParamAll,
   getScreenResolution,
+  getSheet,
+  getSheetNames,
   getStartOfDay,
   getStartOfMonth,
   getStartOfWeek,
@@ -914,6 +1122,7 @@ function negate(value) {
   getViewportSize,
   greaterThan,
   greaterThanOrEqual,
+  hasCookie,
   isAfterDate,
   isAndroid,
   isBeforeDate,
@@ -925,19 +1134,37 @@ function negate(value) {
   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,
   throttle,
   toISOString,
-  toUTC
+  toUTC,
+  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;
@@ -11,6 +14,20 @@ declare function getQueryParam(key: string, url?: string): string | null;
 declare function getAllQueryParams(url?: string): Record<string, string>;
 declare function getQueryParamAll(key: string, url?: string): string[];
 
+interface CookieOptions {
+    expires?: number | Date;
+    path?: string;
+    domain?: string;
+    secure?: boolean;
+    sameSite?: 'Strict' | 'Lax' | 'None';
+}
+declare function setCookie(name: string, value: string, options?: CookieOptions): void;
+declare function getCookie(name: string): string | null;
+declare function removeCookie(name: string, options?: Pick<CookieOptions, 'path' | 'domain'>): void;
+declare function hasCookie(name: string): boolean;
+declare function getAllCookies(): Record<string, string>;
+declare function clearAllCookies(options?: Pick<CookieOptions, 'path' | 'domain'>): void;
+
 declare function getOS(): string;
 declare function getBrowser(): string;
 declare function getBrowserEngine(): string;
@@ -70,6 +87,8 @@ declare function formatPercent(value: number, options?: {
     decimals?: number;
     multiply?: boolean;
 }): string;
+declare function maskEmail(email: string): string;
+declare function unmaskEmail(maskedEmail: string, originalEmail: string): string;
 
 declare function formatDate(date: Date | number | string, formatStr?: string): string;
 declare function formatDateOnly(date: Date | number | string): string;
@@ -151,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 { abs, add, addDaysToDate, addDaysUTC, addMonthsToDate, addMonthsUTC, ceil, debounceFn as debounce, divide, equals, floor, formatDate, formatDateOnly, formatMoney, formatMoneyToChinese, formatNumber, formatPercent, formatRelativeTime, formatTimeOnly, formatUTC, formatUTCDateOnly, formatUTCTimeOnly, fromUTC, getAllQueryParams, getBrowser, getBrowserEngine, getBrowserVersion, 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, isAfterDate, isAndroid, isBeforeDate, isDesktop, isIOS, isMobile, isSameDayDate, isTablet, isTouchDevice, isValidDate, isWeChat, lessThan, lessThanOrEqual, multiply, negate, parseDate, parseMoney, round, subDaysFromDate, subDaysUTC, subMonthsFromDate, subMonthsUTC, subtract, throttleFn as throttle, toISOString, toUTC };
+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;
@@ -11,6 +14,20 @@ declare function getQueryParam(key: string, url?: string): string | null;
 declare function getAllQueryParams(url?: string): Record<string, string>;
 declare function getQueryParamAll(key: string, url?: string): string[];
 
+interface CookieOptions {
+    expires?: number | Date;
+    path?: string;
+    domain?: string;
+    secure?: boolean;
+    sameSite?: 'Strict' | 'Lax' | 'None';
+}
+declare function setCookie(name: string, value: string, options?: CookieOptions): void;
+declare function getCookie(name: string): string | null;
+declare function removeCookie(name: string, options?: Pick<CookieOptions, 'path' | 'domain'>): void;
+declare function hasCookie(name: string): boolean;
+declare function getAllCookies(): Record<string, string>;
+declare function clearAllCookies(options?: Pick<CookieOptions, 'path' | 'domain'>): void;
+
 declare function getOS(): string;
 declare function getBrowser(): string;
 declare function getBrowserEngine(): string;
@@ -70,6 +87,8 @@ declare function formatPercent(value: number, options?: {
     decimals?: number;
     multiply?: boolean;
 }): string;
+declare function maskEmail(email: string): string;
+declare function unmaskEmail(maskedEmail: string, originalEmail: string): string;
 
 declare function formatDate(date: Date | number | string, formatStr?: string): string;
 declare function formatDateOnly(date: Date | number | string): string;
@@ -151,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 { abs, add, addDaysToDate, addDaysUTC, addMonthsToDate, addMonthsUTC, ceil, debounceFn as debounce, divide, equals, floor, formatDate, formatDateOnly, formatMoney, formatMoneyToChinese, formatNumber, formatPercent, formatRelativeTime, formatTimeOnly, formatUTC, formatUTCDateOnly, formatUTCTimeOnly, fromUTC, getAllQueryParams, getBrowser, getBrowserEngine, getBrowserVersion, 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, isAfterDate, isAndroid, isBeforeDate, isDesktop, isIOS, isMobile, isSameDayDate, isTablet, isTouchDevice, isValidDate, isWeChat, lessThan, lessThanOrEqual, multiply, negate, parseDate, parseMoney, round, subDaysFromDate, subDaysUTC, subMonthsFromDate, subMonthsUTC, subtract, throttleFn as throttle, toISOString, toUTC };
+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 };