react-util-tools 1.0.23 → 1.0.25

package/dist/index.js

@@ -75,6 +75,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();
@@ -302,6 +362,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
 import {
@@ -750,18 +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,
@@ -775,10 +951,12 @@ export {
   formatUTCDateOnly,
   formatUTCTimeOnly,
   fromUTC,
+  getAllCookies,
   getAllQueryParams,
   getBrowser,
   getBrowserEngine,
   getBrowserVersion,
+  getCookie,
   getDaysDiff,
   getDeviceInfo,
   getDevicePixelRatio,
@@ -793,6 +971,8 @@ export {
   getQueryParam,
   getQueryParamAll,
   getScreenResolution,
+  getSheet,
+  getSheetNames,
   getStartOfDay,
   getStartOfMonth,
   getStartOfWeek,
@@ -823,6 +1003,7 @@ export {
   getViewportSize,
   greaterThan,
   greaterThanOrEqual,
+  hasCookie,
   isAfterDate,
   isAndroid,
   isBeforeDate,
@@ -834,19 +1015,37 @@ export {
   isTouchDevice,
   isValidDate,
   isWeChat,
+  jsonToWorkbook,
   lessThan,
   lessThanOrEqual,
+  maskEmail,
   multiply,
   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
+  toUTC,
+  unmaskEmail,
+  utils2 as utils,
+  workbookToJSON,
+  write,
+  writeFile2 as writeFile,
+  writeFileXLSX
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "react-util-tools",
-  "version": "1.0.23",
-  "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",
@@ -14,6 +14,15 @@
       "require": "./dist/index.cjs"
     }
   },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts",
+    "dev": "tsup src/index.ts --watch",
+    "prepublishOnly": "pnpm run build",
+    "release:patch": "pnpm version patch --no-git-tag-version && git add . && git commit -m 'chore: release v%s' && git tag v$(node -p \"require('./package.json').version\") && git push --follow-tags && pnpm publish --no-git-checks",
+    "release:minor": "pnpm version minor --no-git-tag-version && git add . && git commit -m 'chore: release v%s' && git tag v$(node -p \"require('./package.json').version\") && git push --follow-tags && pnpm publish --no-git-checks",
+    "release:major": "pnpm version major --no-git-tag-version && git add . && git commit -m 'chore: release v%s' && git tag v$(node -p \"require('./package.json').version\") && git push --follow-tags && pnpm publish --no-git-checks",
+    "release": "pnpm run release:patch"
+  },
   "keywords": [
     "react",
     "utils",
@@ -27,6 +36,10 @@
     "browser-detection",
     "money-format",
     "url-params",
+    "excel",
+    "xlsx",
+    "sheetjs",
+    "cookie",
     "typescript"
   ],
   "author": "alice & bobby",
@@ -53,14 +66,7 @@
   "dependencies": {
     "date-fns": "^4.1.0",
     "date-fns-tz": "^3.2.0",
-    "decimal.js": "^10.6.0"
-  },
-  "scripts": {
-    "build": "tsup src/index.ts --format esm,cjs --dts",
-    "dev": "tsup src/index.ts --watch",
-    "release:patch": "pnpm version patch --no-git-tag-version && git add . && git commit -m 'chore: release v%s' && git tag v$(node -p \"require('./package.json').version\") && git push --follow-tags && pnpm publish --no-git-checks",
-    "release:minor": "pnpm version minor --no-git-tag-version && git add . && git commit -m 'chore: release v%s' && git tag v$(node -p \"require('./package.json').version\") && git push --follow-tags && pnpm publish --no-git-checks",
-    "release:major": "pnpm version major --no-git-tag-version && git add . && git commit -m 'chore: release v%s' && git tag v$(node -p \"require('./package.json').version\") && git push --follow-tags && pnpm publish --no-git-checks",
-    "release": "pnpm run release:patch"
+    "decimal.js": "^10.6.0",
+    "xlsx": "^0.18.5"
   }
-}
+}

package/src/excel/README.md

@@ -0,0 +1,388 @@
+# Excel - SheetJS 封装
+
+基于 [SheetJS (xlsx)](https://docs.sheetjs.com/) 的 Excel 文件处理工具，保留了 SheetJS 的所有原生功能。
+
+## 特性
+
+- ✅ 完整导出 SheetJS 所有功能
+- 📖 读取 Excel 文件（.xlsx, .xls, .csv 等）
+- 📝 创建和导出 Excel 文件
+- 🔄 JSON 与 Excel 互转
+- 🌐 支持多种格式（CSV, HTML, AOA 等）
+- 💻 浏览器和 Node.js 环境均可使用
+
+## 安装
+
+```bash
+npm install react-util-tools
+```
+
+## 基础用法
+
+### 导入模块
+
+```typescript
+import {
+  XLSX,                    // 完整的 XLSX 对象
+  readExcelFile,           // 读取 Excel 文件
+  exportJSONToExcel,       // 导出 JSON 为 Excel
+  workbookToJSON,          // WorkBook 转 JSON
+  jsonToWorkbook,          // JSON 转 WorkBook
+  utils                    // XLSX 工具函数
+} from 'react-util-tools'
+```
+
+## 常用功能
+
+### 1. 读取 Excel 文件
+
+```typescript
+import { readExcelFile, workbookToJSON } from 'react-util-tools'
+
+// 从 File 对象读取
+async function handleFileUpload(file: File) {
+  try {
+    const workbook = await readExcelFile(file)
+    
+    // 获取所有工作表名称
+    console.log(workbook.SheetNames) // ['Sheet1', 'Sheet2']
+    
+    // 转换为 JSON
+    const data = workbookToJSON(workbook)
+    console.log(data)
+  } catch (error) {
+    console.error('读取失败:', error)
+  }
+}
+
+// 在 React 中使用
+function ExcelUploader() {
+  const handleChange = async (e: React.ChangeEvent<HTMLInputElement>) => {
+    const file = e.target.files?.[0]
+    if (file) {
+      await handleFileUpload(file)
+    }
+  }
+  
+  return <input type="file" accept=".xlsx,.xls" onChange={handleChange} />
+}
+```
+
+### 2. 直接读取为 JSON
+
+```typescript
+import { readExcelToJSON } from 'react-util-tools'
+
+async function loadExcelData(file: File) {
+  // 读取第一个工作表
+  const data = await readExcelToJSON(file)
+  console.log(data)
+  
+  // 读取指定工作表
+  const sheet2Data = await readExcelToJSON(file, 'Sheet2')
+  console.log(sheet2Data)
+}
+```
+
+### 3. 导出 JSON 为 Excel
+
+```typescript
+import { exportJSONToExcel } from 'react-util-tools'
+
+function exportData() {
+  const data = [
+    { name: '张三', age: 25, city: '北京' },
+    { name: '李四', age: 30, city: '上海' },
+    { name: '王五', age: 28, city: '广州' }
+  ]
+  
+  // 导出为 Excel 文件
+  exportJSONToExcel(data, 'users.xlsx', 'UserList')
+}
+
+// 在 React 中使用
+function ExportButton() {
+  return <button onClick={exportData}>导出 Excel</button>
+}
+```
+
+### 4. 创建多工作表 Excel
+
+```typescript
+import { XLSX, utils, exportExcelFile } from 'react-util-tools'
+
+function exportMultiSheet() {
+  // 创建工作簿
+  const workbook = utils.book_new()
+  
+  // 第一个工作表
+  const users = [
+    { name: '张三', age: 25 },
+    { name: '李四', age: 30 }
+  ]
+  const sheet1 = utils.json_to_sheet(users)
+  utils.book_append_sheet(workbook, sheet1, '用户列表')
+  
+  // 第二个工作表
+  const products = [
+    { product: 'iPhone', price: 5999 },
+    { product: 'iPad', price: 3999 }
+  ]
+  const sheet2 = utils.json_to_sheet(products)
+  utils.book_append_sheet(workbook, sheet2, '产品列表')
+  
+  // 导出文件
+  exportExcelFile(workbook, 'data.xlsx')
+}
+```
+
+### 5. 自定义表头
+
+```typescript
+import { jsonToWorkbook, exportExcelFile } from 'react-util-tools'
+
+function exportWithCustomHeaders() {
+  const data = [
+    { name: '张三', age: 25, city: '北京' },
+    { name: '李四', age: 30, city: '上海' }
+  ]
+  
+  // 自定义表头
+  const workbook = jsonToWorkbook(data, 'Sheet1', {
+    header: ['姓名', '年龄', '城市']
+  })
+  
+  exportExcelFile(workbook, 'custom-headers.xlsx')
+}
+```
+
+### 6. 使用 AOA (Array of Arrays)
+
+```typescript
+import { aoaToSheet, utils, exportExcelFile } from 'react-util-tools'
+
+function exportFromArray() {
+  const data = [
+    ['姓名', '年龄', '城市'],
+    ['张三', 25, '北京'],
+    ['李四', 30, '上海'],
+    ['王五', 28, '广州']
+  ]
+  
+  const worksheet = aoaToSheet(data)
+  const workbook = utils.book_new()
+  utils.book_append_sheet(workbook, worksheet, 'Sheet1')
+  
+  exportExcelFile(workbook, 'array-data.xlsx')
+}
+```
+
+### 7. 转换为 CSV
+
+```typescript
+import { readExcelFile, getSheet, sheetToCSV } from 'react-util-tools'
+
+async function convertToCSV(file: File) {
+  const workbook = await readExcelFile(file)
+  const sheet = getSheet(workbook, 'Sheet1')
+  const csv = sheetToCSV(sheet)
+  
+  console.log(csv)
+  
+  // 下载 CSV
+  const blob = new Blob([csv], { type: 'text/csv' })
+  const url = URL.createObjectURL(blob)
+  const a = document.createElement('a')
+  a.href = url
+  a.download = 'data.csv'
+  a.click()
+}
+```
+
+### 8. 从 HTML 表格创建 Excel
+
+```typescript
+import { tableToSheet, utils, exportExcelFile } from 'react-util-tools'
+
+function exportTableToExcel() {
+  const table = document.querySelector('table')
+  if (!table) return
+  
+  const worksheet = tableToSheet(table)
+  const workbook = utils.book_new()
+  utils.book_append_sheet(workbook, worksheet, 'Sheet1')
+  
+  exportExcelFile(workbook, 'table-export.xlsx')
+}
+```
+
+## 高级用法
+
+### 使用完整的 XLSX 对象
+
+```typescript
+import { XLSX } from 'react-util-tools'
+
+// 访问所有 SheetJS 功能
+const workbook = XLSX.read(data, { type: 'binary' })
+const worksheet = workbook.Sheets[workbook.SheetNames[0]]
+
+// 设置单元格样式（需要 xlsx-style 或 xlsx-js-style）
+worksheet['A1'].s = {
+  font: { bold: true },
+  fill: { fgColor: { rgb: 'FFFF00' } }
+}
+
+// 合并单元格
+worksheet['!merges'] = [
+  { s: { r: 0, c: 0 }, e: { r: 0, c: 2 } }
+]
+
+// 设置列宽
+worksheet['!cols'] = [
+  { wch: 20 },
+  { wch: 15 },
+  { wch: 30 }
+]
+```
+
+### 读取选项
+
+```typescript
+import { readExcelFile } from 'react-util-tools'
+
+const workbook = await readExcelFile(file, {
+  type: 'binary',           // 数据类型
+  cellDates: true,          // 将日期解析为 Date 对象
+  cellNF: false,            // 不保存数字格式
+  cellStyles: false,        // 不保存样式
+  sheetStubs: false,        // 不生成空单元格
+  raw: false                // 不使用原始值
+})
+```
+
+### 写入选项
+
+```typescript
+import { exportExcelFile } from 'react-util-tools'
+
+exportExcelFile(workbook, 'output.xlsx', {
+  bookType: 'xlsx',         // 文件类型
+  type: 'binary',           // 输出类型
+  compression: true,        // 启用压缩
+  Props: {                  // 文档属性
+    Title: '数据报表',
+    Author: '系统管理员',
+    CreatedDate: new Date()
+  }
+})
+```
+
+## 支持的文件格式
+
+### 读取格式
+- `.xlsx` - Excel 2007+ XML 格式
+- `.xlsb` - Excel 2007+ 二进制格式
+- `.xlsm` - Excel 2007+ 宏文件
+- `.xls` - Excel 97-2004 格式
+- `.csv` - 逗号分隔值
+- `.txt` - 文本文件
+- `.ods` - OpenDocument 电子表格
+- 更多格式请参考 [SheetJS 文档](https://docs.sheetjs.com/)
+
+### 导出格式
+- `xlsx` - Excel 2007+ XML 格式（默认）
+- `xlsb` - Excel 2007+ 二进制格式
+- `xls` - Excel 97-2004 格式
+- `csv` - 逗号分隔值
+- `txt` - UTF-16 文本
+- `html` - HTML 表格
+- `ods` - OpenDocument 电子表格
+
+## API 参考
+
+### 核心导出
+
+- `XLSX` - 完整的 SheetJS 对象
+- `utils` - SheetJS 工具函数集合
+- `read` - 读取数据
+- `write` - 写入数据
+- `readFile` - 读取文件（Node.js）
+- `writeFile` - 写入文件
+
+### 封装函数
+
+#### readExcelFile(file, options?)
+从 File 对象读取 Excel 文件
+
+#### workbookToJSON(workbook, sheetName?, options?)
+将 WorkBook 转换为 JSON 数组
+
+#### jsonToWorkbook(data, sheetName?, options?)
+从 JSON 数组创建 WorkBook
+
+#### exportExcelFile(workbook, filename?, options?)
+导出 Excel 文件（浏览器下载）
+
+#### exportJSONToExcel(data, filename?, sheetName?, options?)
+直接从 JSON 导出 Excel 文件
+
+#### readExcelToJSON(file, sheetName?, parseOptions?, jsonOptions?)
+读取 Excel 文件并转换为 JSON
+
+#### getSheetNames(workbook)
+获取所有工作表名称
+
+#### getSheet(workbook, sheetName)
+获取指定工作表
+
+#### sheetToCSV(worksheet, options?)
+将工作表转换为 CSV 字符串
+
+#### sheetToHTML(worksheet, options?)
+将工作表转换为 HTML 字符串
+
+#### tableToSheet(table, options?)
+从 HTML 表格创建工作表
+
+#### aoaToSheet(data, options?)
+从二维数组创建工作表
+
+#### sheetToAOA(worksheet, options?)
+将工作表转换为二维数组
+
+## TypeScript 支持
+
+完整的 TypeScript 类型定义：
+
+```typescript
+import type {
+  WorkBook,
+  WorkSheet,
+  CellObject,
+  Range,
+  WritingOptions,
+  ParsingOptions,
+  BookType,
+  Sheet2JSONOpts,
+  JSON2SheetOpts
+} from 'react-util-tools'
+```
+
+## 注意事项
+
+1. **浏览器环境**：文件读取使用 FileReader API
+2. **文件大小**：处理大文件时注意内存占用
+3. **样式支持**：基础版本不支持样式，需要额外的库
+4. **日期格式**：Excel 日期需要特殊处理
+5. **公式**：默认读取公式的计算结果，不是公式本身
+
+## 相关链接
+
+- [SheetJS 官方文档](https://docs.sheetjs.com/)
+- [SheetJS GitHub](https://github.com/SheetJS/sheetjs)
+- [在线演示](https://sheetjs.com/demos)
+
+## 示例项目
+
+完整的使用示例请参考项目中的示例代码。