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

package/README.md

@@ -106,16 +106,48 @@ cell.fill = {
 
 ## Browser Support
 
-ExcelTS supports both Node.js and browser environments:
+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:
 
 ```javascript
-// Browser usage
-import { Workbook } from "@cj-tech-master/excelts/browser";
+import { Workbook } from "@cj-tech-master/excelts";
 
 const workbook = new Workbook();
-// ... use workbook API
+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
 ```
 
+### Using with Script Tags (No Bundler)
+
+```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>
+```
+
+### Browser-Specific Notes
+
+- **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)
+
 ## Requirements
 
 ### Node.js

package/README_zh.md

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