@cj-tech-master/excelts 3.1.0 → 4.0.0-canary.20260103013222.0e5d37f

package/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2014-2019 Guyon Roche
+Copyright (c) 2026 cjnoname
 
 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,3 +20,4 @@ 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 modernized fork of [ExcelJS](https://github.com/exceljs/exceljs) with:
+ExcelTS is a modern TypeScript Excel workbook manager 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 modernized fork of [ExcelJS](https://github.com/exceljs/exceljs) wi
 - ✅ **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 85+, Firefox 79+, Safari 14+ with built-in polyfills
+- ✅ **Broad Browser Support** - Works in Chrome 89+, Firefox 102+, Safari 14.1+ (with built-in fallbacks for missing `CompressionStream`)
 
 ## Translations
 
@@ -43,7 +43,10 @@ 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
@@ -52,8 +55,11 @@ 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));
@@ -106,10 +112,14 @@ cell.fill = {
   - Data protection
   - Comments and notes
 
-## Streaming API (Node.js)
+## Streaming API
 
 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:
@@ -117,7 +127,7 @@ Read large XLSX files with minimal memory usage:
 ```javascript
 import { WorkbookReader } from "@cj-tech-master/excelts";
 
-// Read from file path
+// Node.js: read from file path
 const reader = new WorkbookReader("large-file.xlsx", {
   worksheets: "emit", // emit worksheet events
   sharedStrings: "cache", // cache shared strings for cell values
@@ -140,6 +150,7 @@ 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,
@@ -158,6 +169,63 @@ 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)
@@ -235,7 +303,7 @@ const url = URL.createObjectURL(blob);
 ### Using with Script Tags (No Bundler)
 
 ```html
-<script src="https://unpkg.com/@cj-tech-master/excelts/dist/browser/excelts.iife.min.js"></script>
+<script src="https://unpkg.com/@cj-tech-master/excelts/dist/iife/excelts.iife.min.js"></script>
 <script>
   const { Workbook } = ExcelTS;
   const wb = new Workbook();
@@ -243,6 +311,21 @@ 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:bundle
+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
@@ -260,14 +343,16 @@ const url = URL.createObjectURL(blob);
 
 ### Browsers (No Polyfills Required)
 
-- **Chrome >= 85** (August 2020)
-- **Edge >= 85** (August 2020)
-- **Firefox >= 79** (July 2020)
-- **Safari >= 14** (September 2020)
-- **Opera >= 71** (September 2020)
+- **Chrome >= 89** (March 2021)
+- **Edge >= 89** (March 2021)
+- **Firefox >= 102** (June 2022)
+- **Safari >= 14.1** (April 2021)
+- **Opera >= 75** (March 2021)
 
 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).
@@ -303,15 +388,13 @@ 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 the `src/__test__` folder) that reproduces the issue
+1. **Bug Fixes**: Add a unit-test or integration-test (in `src/**/__tests__`) 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`)
@@ -335,19 +418,13 @@ If you need help or have questions:
 
 MIT 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:
+See LICENSE.
 
-- **Guyon Roche** - Original author of ExcelJS
-- All [ExcelJS contributors](https://github.com/exceljs/exceljs/graphs/contributors)
+Third-party software notices and attributions are provided in THIRD_PARTY_NOTICES.md.
 
 ## 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 是 [ExcelJS](https://github.com/exceljs/exceljs) 的现代化版本，具有以下特性:
+ExcelTS 是现代化的 TypeScript Excel 工作簿管理器，具有以下特性:
 
 - 🚀 **零运行时依赖** - 纯 TypeScript 实现，无任何外部包依赖
 - ✅ **完整的 TypeScript 支持** - 完整的类型定义和现代 TypeScript 模式
@@ -15,7 +15,7 @@ ExcelTS 是 [ExcelJS](https://github.com/exceljs/exceljs) 的现代化版本，
 - ✅ **ESM 优先** - 原生 ES Module 支持，兼容 CommonJS
 - ✅ **Node 20+** - 针对现代 Node.js 版本优化
 - ✅ **命名导出** - 所有导出都是命名导出，更好的 tree-shaking
-- ✅ **广泛浏览器支持** - 支持 Chrome 85+、Firefox 79+、Safari 14+，内置兼容方案
+- ✅ **广泛浏览器支持** - 支持 Chrome 89+、Firefox 102+、Safari 14.1+（对缺失 `CompressionStream` 有内置 fallback）
 
 ## 翻译
 
@@ -23,8 +23,9 @@ ExcelTS 是 [ExcelJS](https://github.com/exceljs/exceljs) 的现代化版本，
 
 ## 安装
 
-````bash
+```bash
 npm install @cj-tech-master/excelts
+```
 
 ## 快速开始
 
@@ -42,8 +43,11 @@ sheet.addRow(["张三", 30, "zhang@example.com"]);
 sheet.addRow(["李四", 25, "li@example.com"]);
 
 // 保存文件
+// 仅 Node.js：写入到文件路径
 await workbook.xlsx.writeFile("output.xlsx");
-````
+
+// 浏览器：使用 `writeBuffer()` 并保存为 Blob（见「浏览器支持」章节）
+```
 
 ### 读取工作簿
 
@@ -51,8 +55,11 @@ 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));
@@ -105,10 +112,14 @@ cell.fill = {
   - 数据保护
   - 注释和批注
 
-## 流式 API（Node.js）
+## 流式 API
 
 处理大型 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 文件：
@@ -116,7 +127,7 @@ cell.fill = {
 ```javascript
 import { WorkbookReader } from "@cj-tech-master/excelts";
 
-// 从文件路径读取
+// Node.js：从文件路径读取
 const reader = new WorkbookReader("large-file.xlsx", {
   worksheets: "emit", // 触发工作表事件
   sharedStrings: "cache", // 缓存共享字符串以获取单元格值
@@ -132,6 +143,63 @@ 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 文件：
@@ -139,6 +207,7 @@ for await (const worksheet of reader) {
 ```javascript
 import { WorkbookWriter } from "@cj-tech-master/excelts";
 
+// Node.js：写入到 filename
 const workbook = new WorkbookWriter({
   filename: "output.xlsx",
   useSharedStrings: true,
@@ -234,7 +303,7 @@ const url = URL.createObjectURL(blob);
 ### 使用 Script 标签（无打包工具）
 
 ```html
-<script src="https://unpkg.com/@cj-tech-master/excelts/dist/browser/excelts.iife.min.js"></script>
+<script src="https://unpkg.com/@cj-tech-master/excelts/dist/iife/excelts.iife.min.js"></script>
 <script>
   const { Workbook } = ExcelTS;
   const wb = new Workbook();
@@ -242,6 +311,21 @@ 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:bundle
+npx serve .
+```
+
+然后打开 `http://localhost:3000/src/modules/excel/examples/browser-smoke.html`。
+
 ### 浏览器版本注意事项
 
 - **支持 CSV 操作**（使用原生 RFC 4180 标准实现）
@@ -259,14 +343,16 @@ const url = URL.createObjectURL(blob);
 
 ### 浏览器（无需 Polyfills）
 
-- **Chrome >= 85**（2020年8月）
-- **Edge >= 85**（2020年8月）
-- **Firefox >= 79**（2020年7月）
-- **Safari >= 14**（2020年9月）
-- **Opera >= 71**（2020年9月）
+- **Chrome >= 89**（2021年3月）
+- **Edge >= 89**（2021年3月）
+- **Firefox >= 102**（2022年6月）
+- **Safari >= 14.1**（2021年4月）
+- **Opera >= 75**（2021年3月）
 
 对于不支持原生 `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) 积极维护。
@@ -302,15 +388,13 @@ const url = URL.createObjectURL(blob);
 - 条件格式
 - 文件输入输出
 
-API 与原始 ExcelJS 保持高度兼容。
-
 ## 贡献指南
 
 欢迎贡献！请随时提交 Pull Request。
 
 ### 提交 PR 前
 
-1. **Bug 修复**：在 `src/__test__` 文件夹中添加能重现问题的单元测试或集成测试
+1. **Bug 修复**：在 `src/**/__tests__` 中添加能重现问题的单元测试或集成测试
 2. **新功能**：先开 issue 讨论功能和实现方案
 3. **文档**：更新相关文档和类型定义
 4. **代码风格**：遵循现有代码风格并通过所有代码检查（`npm run lint`）
@@ -334,19 +418,13 @@ API 与原始 ExcelJS 保持高度兼容。
 
 MIT License
 
-基于 [ExcelJS](https://github.com/exceljs/exceljs) 由 [Guyon Roche](https://github.com/guyonroche) 创建
-
-## 致谢
-
-本项目是 ExcelJS 的现代化分支。原始实现的所有功劳归于：
+详见 LICENSE。
 
-- **Guyon Roche** - ExcelJS 原作者
-- 所有 [ExcelJS 贡献者](https://github.com/exceljs/exceljs/graphs/contributors)
+第三方软件的声明与归属信息请见 THIRD_PARTY_NOTICES.md。
 
 ## 链接
 
 - [GitHub 仓库](https://github.com/cjnoname/excelts)
-- [原始 ExcelJS](https://github.com/exceljs/exceljs)
 - [问题跟踪](https://github.com/cjnoname/excelts/issues)
 
 ## 更新日志

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,112 @@
+# Third-Party Notices
+
+This project includes software developed by third parties. The following notices are provided for attribution and license compliance.
+
+---
+
+## Third-party component
+
+ExcelJS is licensed under the MIT License:
+
+The MIT License (MIT)
+
+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
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+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 component
+
+fast-csv is licensed under the MIT License:
+
+The MIT License (MIT)
+
+Copyright (c) 2011-2025 C2FO
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+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 component
+
+unzipper is licensed under the MIT License:
+
+The MIT License (MIT)
+
+Copyright (c) 2012 - 2013 Near Infinity Corporation
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+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.
+
+Commits in this fork are (c) Ziggy Jonsson (ziggy.jonsson.nyc@gmail.com) and
+fall under same licence structure as the original repo (MIT).
+
+---
+
+## Third-party component
+
+saxes is licensed under the ISC License:
+
+The ISC License
+
+Copyright (c) Contributors
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
+IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/dist/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2014-2019 Guyon Roche
+Copyright (c) 2026 cjnoname
 
 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,3 +20,4 @@ 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/dist/browser/index.browser.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Browser entry point - No Node.js dependencies
+ * This version is optimized for browser environments with minimal bundle size
+ */
+export { Workbook } from "@excel/workbook";
+export { Worksheet } from "@excel/worksheet";
+export { Row } from "@excel/row";
+export { Column } from "@excel/column";
+export { Cell } from "@excel/cell";
+export { Range } from "@excel/range";
+export { Image } from "@excel/image";
+export * from "@excel/anchor";
+export { Table } from "@excel/table";
+export { DataValidations } from "@excel/data-validations";
+export * from "@excel/enums";
+export * from "@excel/types";
+export type { PivotTable, PivotTableModel, PivotTableSource, CacheField, DataField, PivotTableSubtotal, ParsedCacheDefinition, ParsedCacheRecords } from "@excel/pivot-table";
+import { WorkbookWriter } from "@excel/stream/workbook-writer.browser";
+import { WorkbookReader } from "@excel/stream/workbook-reader.browser";
+import { WorksheetWriter } from "@excel/stream/worksheet-writer";
+import { WorksheetReader } from "@excel/stream/worksheet-reader";
+export { WorkbookWriter, WorkbookReader, WorksheetWriter, WorksheetReader };
+export type { CsvReadOptions, CsvWriteOptions, CsvStreamReadOptions, CsvStreamWriteOptions } from "@csv/csv.browser";
+export { CsvParserStream, CsvFormatterStream } from "@csv/csv.browser";
+export * from "@excel/utils/sheet-utils";

package/dist/browser/index.browser.js

@@ -0,0 +1,40 @@
+/**
+ * Browser entry point - No Node.js dependencies
+ * This version is optimized for browser environments with minimal bundle size
+ */
+// =============================================================================
+// Main Classes (Browser-compatible)
+// =============================================================================
+export { Workbook } from "./modules/excel/workbook.js";
+export { Worksheet } from "./modules/excel/worksheet.js";
+export { Row } from "./modules/excel/row.js";
+export { Column } from "./modules/excel/column.js";
+export { Cell } from "./modules/excel/cell.js";
+export { Range } from "./modules/excel/range.js";
+export { Image } from "./modules/excel/image.js";
+export * from "./modules/excel/anchor.js";
+export { Table } from "./modules/excel/table.js";
+export { DataValidations } from "./modules/excel/data-validations.js";
+// =============================================================================
+// Enums
+// =============================================================================
+export * from "./modules/excel/enums.js";
+// =============================================================================
+// Types
+// =============================================================================
+// Export all type definitions from types.ts
+export * from "./modules/excel/types.js";
+// =============================================================================
+// Streaming Writer (Browser-compatible)
+// Uses cross-platform base implementation without Node.js fs
+// =============================================================================
+import { WorkbookWriter } from "./modules/excel/stream/workbook-writer.browser.js";
+import { WorkbookReader } from "./modules/excel/stream/workbook-reader.browser.js";
+import { WorksheetWriter } from "./modules/excel/stream/worksheet-writer.js";
+import { WorksheetReader } from "./modules/excel/stream/worksheet-reader.js";
+export { WorkbookWriter, WorkbookReader, WorksheetWriter, WorksheetReader };
+export { CsvParserStream, CsvFormatterStream } from "./modules/csv/csv.browser.js";
+// =============================================================================
+// Utilities
+// =============================================================================
+export * from "./modules/excel/utils/sheet-utils.js";