@cj-tech-master/excelts 1.6.3-canary.20251224124621.73c5d94 → 1.6.3

package/README.md

@@ -106,47 +106,34 @@ cell.fill = {
 
 ## Browser Support
 
-ExcelTS has native browser support with **zero configuration** required for modern bundlers.
-
-### Using with Bundlers (Vite, Webpack, Rollup, esbuild)
-
-Simply import ExcelTS - no polyfills or configuration needed:
+ExcelTS supports both Node.js and browser environments:
 
 ```javascript
-import { Workbook } from "@cj-tech-master/excelts";
+// Browser usage
+import { Workbook } from "@cj-tech-master/excelts/browser";
 
 const workbook = new Workbook();
-const sheet = workbook.addWorksheet("Sheet1");
-sheet.getCell("A1").value = "Hello, Browser!";
-
-// Write to buffer and download
-const buffer = await workbook.xlsx.writeBuffer();
-const blob = new Blob([buffer], {
-  type: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
-});
-const url = URL.createObjectURL(blob);
-// ... trigger download
+// ... use workbook API
 ```
 
-### Using with Script Tags (No Bundler)
+### Vite Configuration
+
+When using ExcelTS with Vite, you need to install Node.js polyfills:
 
-```html
-<script src="https://unpkg.com/@cj-tech-master/excelts/dist/browser/excelts.iife.min.js"></script>
-<script>
-  const { Workbook } = ExcelTS;
-  const wb = new Workbook();
-  // ... use workbook API
-</script>
+```bash
+npm install -D vite-plugin-node-polyfills
 ```
 
-### Browser-Specific Notes
+Configure your `vite.config.ts`:
 
-- **CSV operations are supported** using native RFC 4180 implementation
-  - Use `csv.load(stringOrArrayBuffer)` to read CSV
-  - Use `csv.writeString()` or `csv.writeBuffer()` to write CSV
-- Use `xlsx.load(arrayBuffer)` instead of `xlsx.readFile()`
-- Use `xlsx.writeBuffer()` instead of `xlsx.writeFile()`
-- Worksheet protection with passwords is fully supported (pure JS SHA-512)
+```typescript
+import { defineConfig } from 'vite'
+import { nodePolyfills } from 'vite-plugin-node-polyfills'
+
+export default defineConfig({
+  plugins: [nodePolyfills()]
+})
+```
 
 ## Requirements
 

package/README_zh.md

@@ -106,47 +106,35 @@ cell.fill = {
 
 ## 浏览器支持
 
-ExcelTS 原生支持浏览器环境，现代打包工具**无需任何配置**。
-
-### 在打包工具中使用（Vite, Webpack, Rollup, esbuild）
-
-直接导入 ExcelTS - 无需 polyfills 或额外配置：
+ExcelTS 同时支持 Node.js 和浏览器环境：
 
+````javascript
 ```javascript
-import { Workbook } from "@cj-tech-master/excelts";
+// 浏览器使用
+import { Workbook } from "@cj-tech-master/excelts/browser";
 
 const workbook = new Workbook();
-const sheet = workbook.addWorksheet("Sheet1");
-sheet.getCell("A1").value = "你好，浏览器！";
+// ... 使用 workbook API
+````
 
-// 写入 buffer 并下载
-const buffer = await workbook.xlsx.writeBuffer();
-const blob = new Blob([buffer], {
-  type: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
-});
-const url = URL.createObjectURL(blob);
-// ... 触发下载
-```
+### Vite 配置
 
-### 使用 Script 标签（无打包工具）
+在 Vite 项目中使用 ExcelTS 时，需要安装 Node.js polyfills：
 
-```html
-<script src="https://unpkg.com/@cj-tech-master/excelts/dist/browser/excelts.iife.min.js"></script>
-<script>
-  const { Workbook } = ExcelTS;
-  const wb = new Workbook();
-  // ... 使用 workbook API
-</script>
+```bash
+npm install -D vite-plugin-node-polyfills
 ```
 
-### 浏览器版本注意事项
+配置 `vite.config.ts`：
 
-- **支持 CSV 操作**（使用原生 RFC 4180 标准实现）
-  - 使用 `csv.load(stringOrArrayBuffer)` 读取 CSV
-  - 使用 `csv.writeString()` 或 `csv.writeBuffer()` 写入 CSV
-- 使用 `xlsx.load(arrayBuffer)` 代替 `xlsx.readFile()`
-- 使用 `xlsx.writeBuffer()` 代替 `xlsx.writeFile()`
-- 完全支持带密码的工作表保护（纯 JS SHA-512 实现）
+```typescript
+import { defineConfig } from 'vite'
+import { nodePolyfills } from 'vite-plugin-node-polyfills'
+
+export default defineConfig({
+  plugins: [nodePolyfills()]
+})
+```
 
 ## 系统要求