@cj-tech-master/excelts 3.1.0-canary.20260102041828.82ed571 → 3.1.0

package/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2026 cjnoname
+Copyright (c) 2014-2019 Guyon Roche
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -20,4 +20,3 @@ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
-Third-party software notices and attributions are provided in THIRD_PARTY_NOTICES.md.

package/README.md

@@ -6,7 +6,7 @@ Modern TypeScript Excel Workbook Manager - Read, manipulate and write spreadshee
 
 ## About This Project
 
-ExcelTS is a modern TypeScript Excel workbook manager with:
+ExcelTS is a modernized fork of [ExcelJS](https://github.com/exceljs/exceljs) with:
 
 - 🚀 **Zero Runtime Dependencies** - Pure TypeScript implementation with no external packages
 - ✅ **Full TypeScript Support** - Complete type definitions and modern TypeScript patterns
@@ -15,7 +15,7 @@ ExcelTS is a modern TypeScript Excel workbook manager with:
 - ✅ **ESM First** - Native ES Module support with CommonJS compatibility
 - ✅ **Node 20+** - Optimized for modern Node.js versions
 - ✅ **Named Exports** - All exports are named for better tree-shaking
-- ✅ **Broad Browser Support** - Works in Chrome 89+, Firefox 102+, Safari 14.1+ (with built-in fallbacks for missing `CompressionStream`)
+- ✅ **Broad Browser Support** - Works in Chrome 85+, Firefox 79+, Safari 14+ with built-in polyfills
 
 ## Translations
 
@@ -43,10 +43,7 @@ sheet.addRow(["John Doe", 30, "john@example.com"]);
 sheet.addRow(["Jane Smith", 25, "jane@example.com"]);
 
 // Save to file
-// Node.js only: write to a file path
 await workbook.xlsx.writeFile("output.xlsx");
-
-// Browser: use `writeBuffer()` and save as a Blob (see the Browser Support section)
 ```
 
 ### Reading a Workbook
@@ -55,11 +52,8 @@ await workbook.xlsx.writeFile("output.xlsx");
 import { Workbook } from "@cj-tech-master/excelts";
 
 const workbook = new Workbook();
-// Node.js only: read from a file path
 await workbook.xlsx.readFile("input.xlsx");
 
-// Browser: use `xlsx.load(arrayBuffer)` (see the Browser Support section)
-
 const worksheet = workbook.getWorksheet(1);
 worksheet.eachRow((row, rowNumber) => {
   console.log("Row " + rowNumber + " = " + JSON.stringify(row.values));
@@ -112,14 +106,10 @@ cell.fill = {
   - Data protection
   - Comments and notes
 
-## Streaming API
+## Streaming API (Node.js)
 
 For processing large Excel files without loading them entirely into memory, ExcelTS provides streaming reader and writer APIs.
 
-- **Node.js**: `WorkbookReader` supports reading from a file path, and `WorkbookWriter` supports writing to a filename.
-- **Browsers**: use `Uint8Array` / `ArrayBuffer` / Web `ReadableStream<Uint8Array>` for reading, and Web `WritableStream<Uint8Array>` for writing.
-- Note: ExcelTS does not re-export the internal stream utility surface (e.g. `Readable`, `Writable`). Prefer standard Web Streams (browser/Node 20+) or Node.js streams.
-
 ### Streaming Reader
 
 Read large XLSX files with minimal memory usage:
@@ -127,7 +117,7 @@ Read large XLSX files with minimal memory usage:
 ```javascript
 import { WorkbookReader } from "@cj-tech-master/excelts";
 
-// Node.js: read from file path
+// Read from file path
 const reader = new WorkbookReader("large-file.xlsx", {
   worksheets: "emit", // emit worksheet events
   sharedStrings: "cache", // cache shared strings for cell values
@@ -150,7 +140,6 @@ Write large XLSX files row by row:
 ```javascript
 import { WorkbookWriter } from "@cj-tech-master/excelts";
 
-// Node.js: write to filename
 const workbook = new WorkbookWriter({
   filename: "output.xlsx",
   useSharedStrings: true,
@@ -169,63 +158,6 @@ sheet.commit();
 await workbook.commit();
 ```
 
-### Web Streams (Node.js 20+ and Browsers)
-
-`WorkbookWriter` can write to a Web `WritableStream<Uint8Array>`, and `WorkbookReader` can read from a Web `ReadableStream<Uint8Array>`.
-
-This does **not** require importing any extra stream utility surface from ExcelTS; it uses the standard Web Streams API.
-
-- Full runnable example: [src/modules/excel/examples/web-streams-reader-writer.ts](src/modules/excel/examples/web-streams-reader-writer.ts)
-
-Run locally (Node.js 20+):
-
-```bash
-npx tsx src/modules/excel/examples/web-streams-reader-writer.ts
-```
-
-Minimal end-to-end snippet:
-
-```javascript
-import { WorkbookWriter, WorkbookReader } from "@cj-tech-master/excelts";
-
-// 1) Write workbook -> Web WritableStream
-const chunks = [];
-const writable = new WritableStream({
-  write(chunk) {
-    chunks.push(chunk);
-  }
-});
-
-const writer = new WorkbookWriter({ stream: writable });
-const sheet = writer.addWorksheet("Sheet1");
-sheet.addRow(["Name", "Score"]).commit();
-sheet.addRow(["Alice", 98]).commit();
-await sheet.commit();
-await writer.commit();
-
-// 2) Read workbook <- Web ReadableStream
-const bytes = new Uint8Array(chunks.reduce((n, c) => n + c.length, 0));
-let offset = 0;
-for (const c of chunks) {
-  bytes.set(c, offset);
-  offset += c.length;
-}
-
-const readable = new ReadableStream({
-  start(controller) {
-    controller.enqueue(bytes);
-    controller.close();
-  }
-});
-
-const reader = new WorkbookReader(readable, { worksheets: "emit" });
-for await (const ws of reader) {
-  for await (const row of ws) {
-    console.log(row.values);
-  }
-}
-```
-
 ## CSV Support
 
 ### Node.js (Full Streaming Support)
@@ -311,21 +243,6 @@ const url = URL.createObjectURL(blob);
 </script>
 ```
 
-### Manual Browser Example (Local)
-
-For a quick manual smoke test in a real browser (create/download/read XLSX, worksheet protection, etc.), use:
-
-- [src/modules/excel/examples/browser-smoke.html](src/modules/excel/examples/browser-smoke.html)
-
-Steps:
-
-```bash
-npm run build:browser
-npx serve .
-```
-
-Then open `http://localhost:3000/src/modules/excel/examples/browser-smoke.html`.
-
 ### Browser-Specific Notes
 
 - **CSV operations are supported** using native RFC 4180 implementation
@@ -343,16 +260,14 @@ Then open `http://localhost:3000/src/modules/excel/examples/browser-smoke.html`.
 
 ### Browsers (No Polyfills Required)
 
-- **Chrome >= 89** (March 2021)
-- **Edge >= 89** (March 2021)
-- **Firefox >= 102** (June 2022)
-- **Safari >= 14.1** (April 2021)
-- **Opera >= 75** (March 2021)
+- **Chrome >= 85** (August 2020)
+- **Edge >= 85** (August 2020)
+- **Firefox >= 79** (July 2020)
+- **Safari >= 14** (September 2020)
+- **Opera >= 71** (September 2020)
 
 For older browsers without native `CompressionStream` API (Firefox < 113, Safari < 16.4), ExcelTS automatically uses a built-in pure JavaScript DEFLATE implementation - no configuration or polyfills needed.
 
-ExcelTS does **not** require `crypto.randomUUID()` in browsers; it uses an internal UUID v4 generator with a `crypto.getRandomValues()` fallback.
-
 ## Maintainer
 
 This project is actively maintained by [CJ (@cjnoname)](https://github.com/cjnoname).
@@ -388,13 +303,15 @@ For detailed API documentation, please refer to the comprehensive documentation
 - Conditional Formatting
 - File I/O
 
+The API remains largely compatible with the original ExcelJS.
+
 ## Contributing Guidelines
 
 Contributions are welcome! Please feel free to submit a Pull Request.
 
 ### Before Submitting a PR
 
-1. **Bug Fixes**: Add a unit-test or integration-test (in `src/**/__tests__`) that reproduces the issue
+1. **Bug Fixes**: Add a unit-test or integration-test (in the `src/__test__` folder) that reproduces the issue
 2. **New Features**: Open an issue first to discuss the feature and implementation approach
 3. **Documentation**: Update relevant documentation and type definitions
 4. **Code Style**: Follow the existing code style and pass all linters (`npm run lint`)
@@ -418,13 +335,19 @@ If you need help or have questions:
 
 MIT License
 
-See LICENSE.
+Based on [ExcelJS](https://github.com/exceljs/exceljs) by [Guyon Roche](https://github.com/guyonroche)
+
+## Credits
+
+This project is a fork of ExcelJS with modernization improvements. All credit for the original implementation goes to:
 
-Third-party software notices and attributions are provided in THIRD_PARTY_NOTICES.md.
+- **Guyon Roche** - Original author of ExcelJS
+- All [ExcelJS contributors](https://github.com/exceljs/exceljs/graphs/contributors)
 
 ## Links
 
 - [GitHub Repository](https://github.com/cjnoname/excelts)
+- [Original ExcelJS](https://github.com/exceljs/exceljs)
 - [Issue Tracker](https://github.com/cjnoname/excelts/issues)
 
 ## Changelog

package/README_zh.md

@@ -6,7 +6,7 @@
 
 ## 关于本项目
 
-ExcelTS 是现代化的 TypeScript Excel 工作簿管理器，具有以下特性:
+ExcelTS 是 [ExcelJS](https://github.com/exceljs/exceljs) 的现代化版本，具有以下特性:
 
 - 🚀 **零运行时依赖** - 纯 TypeScript 实现，无任何外部包依赖
 - ✅ **完整的 TypeScript 支持** - 完整的类型定义和现代 TypeScript 模式
@@ -15,7 +15,7 @@ ExcelTS 是现代化的 TypeScript Excel 工作簿管理器，具有以下特性
 - ✅ **ESM 优先** - 原生 ES Module 支持，兼容 CommonJS
 - ✅ **Node 20+** - 针对现代 Node.js 版本优化
 - ✅ **命名导出** - 所有导出都是命名导出，更好的 tree-shaking
-- ✅ **广泛浏览器支持** - 支持 Chrome 89+、Firefox 102+、Safari 14.1+（对缺失 `CompressionStream` 有内置 fallback）
+- ✅ **广泛浏览器支持** - 支持 Chrome 85+、Firefox 79+、Safari 14+，内置兼容方案
 
 ## 翻译
 
@@ -23,9 +23,8 @@ ExcelTS 是现代化的 TypeScript Excel 工作簿管理器，具有以下特性
 
 ## 安装
 
-```bash
+````bash
 npm install @cj-tech-master/excelts
-```
 
 ## 快速开始
 
@@ -43,11 +42,8 @@ sheet.addRow(["张三", 30, "zhang@example.com"]);
 sheet.addRow(["李四", 25, "li@example.com"]);
 
 // 保存文件
-// 仅 Node.js：写入到文件路径
 await workbook.xlsx.writeFile("output.xlsx");
-
-// 浏览器：使用 `writeBuffer()` 并保存为 Blob（见「浏览器支持」章节）
-```
+````
 
 ### 读取工作簿
 
@@ -55,11 +51,8 @@ await workbook.xlsx.writeFile("output.xlsx");
 import { Workbook } from "@cj-tech-master/excelts";
 
 const workbook = new Workbook();
-// 仅 Node.js：从文件路径读取
 await workbook.xlsx.readFile("input.xlsx");
 
-// 浏览器：使用 `xlsx.load(arrayBuffer)`（见「浏览器支持」章节）
-
 const worksheet = workbook.getWorksheet(1);
 worksheet.eachRow((row, rowNumber) => {
   console.log("第 " + rowNumber + " 行 = " + JSON.stringify(row.values));
@@ -112,14 +105,10 @@ cell.fill = {
   - 数据保护
   - 注释和批注
 
-## 流式 API
+## 流式 API（Node.js）
 
 处理大型 Excel 文件时无需将整个文件加载到内存中，ExcelTS 提供了流式读写 API。
 
-- **Node.js**：`WorkbookReader` 支持从文件路径读取；`WorkbookWriter` 支持写入到 `filename`。
-- **浏览器**：读取使用 `Uint8Array` / `ArrayBuffer` / Web `ReadableStream<Uint8Array>`；写入使用 Web `WritableStream<Uint8Array>`。
-- 说明：ExcelTS 不再从主入口 re-export 内部那套 stream 工具类（如 `Readable`、`Writable`）。建议直接使用标准 Web Streams（浏览器/Node 20+）或 Node.js 原生 streams。
-
 ### 流式读取器
 
 以最小内存占用读取大型 XLSX 文件：
@@ -127,7 +116,7 @@ cell.fill = {
 ```javascript
 import { WorkbookReader } from "@cj-tech-master/excelts";
 
-// Node.js：从文件路径读取
+// 从文件路径读取
 const reader = new WorkbookReader("large-file.xlsx", {
   worksheets: "emit", // 触发工作表事件
   sharedStrings: "cache", // 缓存共享字符串以获取单元格值
@@ -143,63 +132,6 @@ for await (const worksheet of reader) {
 }
 ```
 
-### Web Streams（Node.js 20+ 与浏览器）
-
-`WorkbookWriter` 支持写入 Web `WritableStream<Uint8Array>`，`WorkbookReader` 支持从 Web `ReadableStream<Uint8Array>` 读取。
-
-这里直接使用标准 Web Streams API，**不需要**从 ExcelTS 额外导入一堆 stream 工具类。
-
-- 可运行完整示例: [src/modules/excel/examples/web-streams-reader-writer.ts](src/modules/excel/examples/web-streams-reader-writer.ts)
-
-本地运行（Node.js 20+）:
-
-```bash
-npx tsx src/modules/excel/examples/web-streams-reader-writer.ts
-```
-
-最小端到端示例:
-
-```javascript
-import { WorkbookWriter, WorkbookReader } from "@cj-tech-master/excelts";
-
-// 1) 写入工作簿 -> Web WritableStream
-const chunks = [];
-const writable = new WritableStream({
-  write(chunk) {
-    chunks.push(chunk);
-  }
-});
-
-const writer = new WorkbookWriter({ stream: writable });
-const sheet = writer.addWorksheet("Sheet1");
-sheet.addRow(["Name", "Score"]).commit();
-sheet.addRow(["Alice", 98]).commit();
-await sheet.commit();
-await writer.commit();
-
-// 2) 读取工作簿 <- Web ReadableStream
-const bytes = new Uint8Array(chunks.reduce((n, c) => n + c.length, 0));
-let offset = 0;
-for (const c of chunks) {
-  bytes.set(c, offset);
-  offset += c.length;
-}
-
-const readable = new ReadableStream({
-  start(controller) {
-    controller.enqueue(bytes);
-    controller.close();
-  }
-});
-
-const reader = new WorkbookReader(readable, { worksheets: "emit" });
-for await (const ws of reader) {
-  for await (const row of ws) {
-    console.log(row.values);
-  }
-}
-```
-
 ### 流式写入器
 
 逐行写入大型 XLSX 文件：
@@ -207,7 +139,6 @@ for await (const ws of reader) {
 ```javascript
 import { WorkbookWriter } from "@cj-tech-master/excelts";
 
-// Node.js：写入到 filename
 const workbook = new WorkbookWriter({
   filename: "output.xlsx",
   useSharedStrings: true,
@@ -311,21 +242,6 @@ const url = URL.createObjectURL(blob);
 </script>
 ```
 
-### 手动浏览器示例（本地）
-
-如果你想在真实浏览器里做快速手动冒烟测试（创建/下载/读取 XLSX、工作表保护等），可以用这个页面：
-
-- [src/modules/excel/examples/browser-smoke.html](src/modules/excel/examples/browser-smoke.html)
-
-使用方式：
-
-```bash
-npm run build:browser
-npx serve .
-```
-
-然后打开 `http://localhost:3000/src/modules/excel/examples/browser-smoke.html`。
-
 ### 浏览器版本注意事项
 
 - **支持 CSV 操作**（使用原生 RFC 4180 标准实现）
@@ -343,16 +259,14 @@ npx serve .
 
 ### 浏览器（无需 Polyfills）
 
-- **Chrome >= 89**（2021年3月）
-- **Edge >= 89**（2021年3月）
-- **Firefox >= 102**（2022年6月）
-- **Safari >= 14.1**（2021年4月）
-- **Opera >= 75**（2021年3月）
+- **Chrome >= 85**（2020年8月）
+- **Edge >= 85**（2020年8月）
+- **Firefox >= 79**（2020年7月）
+- **Safari >= 14**（2020年9月）
+- **Opera >= 71**（2020年9月）
 
 对于不支持原生 `CompressionStream` API 的旧浏览器（Firefox < 113, Safari < 16.4），ExcelTS 会自动使用内置的纯 JavaScript DEFLATE 实现 - 无需任何配置或 polyfills。
 
-浏览器端不要求必须支持 `crypto.randomUUID()`：ExcelTS 内置了 UUID v4 生成器，并会优先使用 `crypto.getRandomValues()` 作为 fallback。
-
 ## 维护者
 
 本项目由 [CJ (@cjnoname)](https://github.com/cjnoname) 积极维护。
@@ -388,13 +302,15 @@ npx serve .
 - 条件格式
 - 文件输入输出
 
+API 与原始 ExcelJS 保持高度兼容。
+
 ## 贡献指南
 
 欢迎贡献！请随时提交 Pull Request。
 
 ### 提交 PR 前
 
-1. **Bug 修复**：在 `src/**/__tests__` 中添加能重现问题的单元测试或集成测试
+1. **Bug 修复**：在 `src/__test__` 文件夹中添加能重现问题的单元测试或集成测试
 2. **新功能**：先开 issue 讨论功能和实现方案
 3. **文档**：更新相关文档和类型定义
 4. **代码风格**：遵循现有代码风格并通过所有代码检查（`npm run lint`）
@@ -418,13 +334,19 @@ npx serve .
 
 MIT License
 
-详见 LICENSE。
+基于 [ExcelJS](https://github.com/exceljs/exceljs) 由 [Guyon Roche](https://github.com/guyonroche) 创建
+
+## 致谢
+
+本项目是 ExcelJS 的现代化分支。原始实现的所有功劳归于：
 
-第三方软件的声明与归属信息请见 THIRD_PARTY_NOTICES.md。
+- **Guyon Roche** - ExcelJS 原作者
+- 所有 [ExcelJS 贡献者](https://github.com/exceljs/exceljs/graphs/contributors)
 
 ## 链接
 
 - [GitHub 仓库](https://github.com/cjnoname/excelts)
+- [原始 ExcelJS](https://github.com/exceljs/exceljs)
 - [问题跟踪](https://github.com/cjnoname/excelts/issues)
 
 ## 更新日志

package/dist/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2026 cjnoname
+Copyright (c) 2014-2019 Guyon Roche
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -20,4 +20,3 @@ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
-Third-party software notices and attributions are provided in THIRD_PARTY_NOTICES.md.