@cj-tech-master/excelts 5.1.18 → 6.0.0-beta.1

package/README.md

@@ -111,13 +111,77 @@ cell.fill = {
   - Data protection
   - Comments and notes
 
+## Subpath Exports
+
+ExcelTS provides focused subpath exports for standalone module usage:
+
+```typescript
+// Main entry - Excel core (Workbook, Worksheet, Cell, etc.)
+import { Workbook, WorkbookWriter } from "@cj-tech-master/excelts";
+
+// ZIP/TAR archive utilities
+import { zip, unzip, ZipArchive, compress } from "@cj-tech-master/excelts/zip";
+
+// CSV parsing, formatting, and streaming
+import { parseCsv, formatCsv, CsvParserStream } from "@cj-tech-master/excelts/csv";
+
+// Cross-platform stream primitives
+import { Readable, pipeline, createTransform } from "@cj-tech-master/excelts/stream";
+```
+
+Each subpath supports `browser`, `import` (ESM), and `require` (CJS) conditions. See the module READMEs for details:
+
+- [CSV Module](src/modules/csv/README.md) - RFC 4180 parser/formatter, streaming, data generation
+- [Archive Module](src/modules/archive/README.md) - ZIP/TAR create/read/edit, compression, encryption
+- [Stream Module](src/modules/stream/README.md) - Cross-platform Readable/Writable/Transform/Duplex
+
+## Archive Utilities (ZIP/TAR)
+
+ExcelTS includes internal ZIP/TAR utilities used by the XLSX pipeline. If you use the
+archive APIs directly, ZIP string encoding can be customized via `ZipStringEncoding`:
+
+- Default: `"utf-8"`
+- Legacy: `"cp437"`
+- Custom: provide a codec with `encode`/`decode` plus optional flags
+
+When a non-UTF-8 encoding is used, Unicode extra fields can be emitted for better
+cross-tool compatibility.
+
+### Editing an existing ZIP (ZipEditor)
+
+ExcelTS also includes a ZIP editor that can apply filesystem-like edits to an existing archive
+and then output a new ZIP.
+
+- Supports `set()`, `delete()`, `rename()`, `deleteDirectory()`, `setComment()`
+- Unchanged entries are passed through efficiently when possible
+
+```js
+import { editZip } from "@cj-tech-master/excelts";
+
+const editor = await editZip(existingZipBytes, {
+  reproducible: true,
+
+  // Passthrough behavior for unchanged entries:
+  // - "strict" (default): raw passthrough must be available or it throws
+  // - "best-effort": if raw passthrough is unavailable, fall back to extract+re-add
+  preserve: "best-effort",
+  onWarning: w => console.warn(w.code, w.entry, w.message)
+});
+
+editor.delete("old.txt");
+editor.rename("a.txt", "renamed.txt");
+editor.set("new.txt", "hello");
+
+const out = await editor.bytes();
+```
+
 ## 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.
+- Note: ExcelTS does not re-export the internal stream utility surface (e.g. `Readable`, `Writable`). Prefer standard Web Streams (browser/Node 22+) or Node.js streams.
 
 ### Streaming Reader
 
@@ -168,7 +232,7 @@ sheet.commit();
 await workbook.commit();
 ```
 
-### Web Streams (Node.js 20+ and Browsers)
+### Web Streams (Node.js 22+ and Browsers)
 
 `WorkbookWriter` can write to a Web `WritableStream<Uint8Array>`, and `WorkbookReader` can read from a Web `ReadableStream<Uint8Array>`.
 
@@ -176,7 +240,7 @@ This does **not** require importing any extra stream utility surface from ExcelT
 
 - 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+):
+Run locally (Node.js 22+):
 
 ```bash
 npx tsx src/modules/excel/examples/web-streams-reader-writer.ts
@@ -231,26 +295,27 @@ for await (const ws of reader) {
 
 ```javascript
 import { Workbook } from "@cj-tech-master/excelts";
+import fs from "fs";
 
 const workbook = new Workbook();
 
-// Read CSV from file (streaming)
-await workbook.csv.readFile("data.csv");
+// Read CSV from file
+await workbook.readCsvFile("data.csv");
 
 // Read CSV from stream
-import fs from "fs";
 const stream = fs.createReadStream("data.csv");
-await workbook.csv.read(stream, { sheetName: "Imported" });
+await workbook.readCsv(stream, { sheetName: "Imported" });
 
-// Write CSV to file (streaming)
-await workbook.csv.writeFile("output.csv");
+// Write CSV to file
+await workbook.writeCsvFile("output.csv");
 
 // Write CSV to stream
 const writeStream = fs.createWriteStream("output.csv");
-await workbook.csv.write(writeStream);
+await workbook.writeCsv(writeStream);
 
-// Write CSV to buffer
-const buffer = await workbook.csv.writeBuffer();
+// Write CSV to string / bytes
+const csvText = workbook.writeCsv();
+const bytes = await workbook.writeCsvBuffer();
 ```
 
 ### Browser (In-Memory)
@@ -260,19 +325,22 @@ import { Workbook } from "@cj-tech-master/excelts";
 
 const workbook = new Workbook();
 
-// Load CSV from string
-workbook.csv.load(csvString);
+// Read CSV from string
+await workbook.readCsv(csvString);
 
-// Load CSV from ArrayBuffer (e.g., from fetch or file input)
+// Read CSV from ArrayBuffer (e.g., from fetch)
 const response = await fetch("data.csv");
 const arrayBuffer = await response.arrayBuffer();
-workbook.csv.load(arrayBuffer);
+await workbook.readCsv(arrayBuffer);
+
+// Read CSV from File (e.g., <input type="file">)
+await workbook.readCsv(file);
 
 // Write CSV to string
-const csvOutput = workbook.csv.writeString();
+const csvOutput = workbook.writeCsv();
 
-// Write CSV to Uint8Array buffer
-const buffer = workbook.csv.writeBuffer();
+// Write CSV to Uint8Array bytes
+const bytes = await workbook.writeCsvBuffer();
 ```
 
 ## Browser Support
@@ -328,17 +396,53 @@ Then open `http://localhost:3000/src/modules/excel/examples/browser-smoke.html`.
 ### 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 `await workbook.readCsv(input)` to read CSV
+  - Use `workbook.writeCsv()` or `await workbook.writeCsvBuffer()` 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)
 
+## Utility Exports
+
+The main entry also exports commonly useful utilities:
+
+```typescript
+import {
+  // Excel date conversion
+  dateToExcel, // JS Date -> Excel serial number
+  excelToDate, // Excel serial number -> JS Date
+
+  // Date parsing/formatting (high-performance, zero-dep)
+  DateParser, // Batch date parser with format auto-detection
+  DateFormatter, // Batch date formatter
+
+  // Binary utilities (cross-platform)
+  base64ToUint8Array,
+  uint8ArrayToBase64,
+  concatUint8Arrays,
+  toUint8Array,
+  stringToUint8Array,
+  uint8ArrayToString,
+
+  // XML utilities
+  xmlEncode,
+  xmlDecode,
+
+  // Error infrastructure
+  BaseError, // Base class for all library errors
+  ExcelError, // Base Excel error (instanceof checks)
+  toError, // Normalize unknown -> Error
+  errorToJSON, // Serialize error (with cause chain)
+  getErrorChain, // Get full error cause chain as array
+  getRootCause // Get deepest error in cause chain
+} from "@cj-tech-master/excelts";
+```
+
 ## Requirements
 
 ### Node.js
 
-- **Node.js >= 20.0.0** (ES2020 native support)
+- **Node.js >= 22.0.0** (ES2020 native support)
 
 ### Browsers (No Polyfills Required)
 

package/README_zh.md

@@ -111,13 +111,75 @@ cell.fill = {
   - 数据保护
   - 注释和批注
 
+## 子路径导出
+
+ExcelTS 提供独立模块的子路径导出：
+
+```typescript
+// 主入口 - Excel 核心（Workbook, Worksheet, Cell 等）
+import { Workbook, WorkbookWriter } from "@cj-tech-master/excelts";
+
+// ZIP/TAR 归档工具
+import { zip, unzip, ZipArchive, compress } from "@cj-tech-master/excelts/zip";
+
+// CSV 解析、格式化与流式处理
+import { parseCsv, formatCsv, CsvParserStream } from "@cj-tech-master/excelts/csv";
+
+// 跨平台流式原语
+import { Readable, pipeline, createTransform } from "@cj-tech-master/excelts/stream";
+```
+
+每个子路径支持 `browser`、`import`（ESM）和 `require`（CJS）条件。详见各模块文档：
+
+- [CSV 模块](src/modules/csv/README.md) - RFC 4180 解析/格式化、流式处理、数据生成
+- [归档模块](src/modules/archive/README.md) - ZIP/TAR 创建/读取/编辑、压缩、加密
+- [流模块](src/modules/stream/README.md) - 跨平台 Readable/Writable/Transform/Duplex
+
+## 归档工具（ZIP/TAR）
+
+ExcelTS 内置 ZIP/TAR 归档工具（用于 XLSX 管线）。若直接使用归档相关 API，
+可通过 `ZipStringEncoding` 自定义 ZIP 字符串编码：
+
+- 默认：`"utf-8"`
+- 传统兼容：`"cp437"`
+- 自定义：提供带 `encode`/`decode` 的 codec，并可设置可选标记
+
+当使用非 UTF-8 编码时，可写入 Unicode Extra Field 以提升跨工具兼容性。
+
+### 编辑现有 ZIP（ZipEditor）
+
+ExcelTS 也提供 ZIP 编辑器：对已有压缩包做类似文件系统的编辑，然后输出一个新的 ZIP。
+
+- 支持 `set()` / `delete()` / `rename()` / `deleteDirectory()` / `setComment()`
+- 对未改动条目会尽量走高效 passthrough（可用时不重压缩）
+
+```js
+import { editZip } from "@cj-tech-master/excelts";
+
+const editor = await editZip(existingZipBytes, {
+  reproducible: true,
+
+  // 未改动条目的保留策略：
+  // - "strict"（默认）：必须能读取 raw passthrough，否则直接抛错
+  // - "best-effort"：raw 不可用时退化为 extract + 重新写入（可能更耗 CPU/内存）
+  preserve: "best-effort",
+  onWarning: w => console.warn(w.code, w.entry, w.message)
+});
+
+editor.delete("old.txt");
+editor.rename("a.txt", "renamed.txt");
+editor.set("new.txt", "hello");
+
+const out = await editor.bytes();
+```
+
 ## 流式 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。
+- 说明：ExcelTS 不再从主入口 re-export 内部那套 stream 工具类（如 `Readable`、`Writable`）。建议直接使用标准 Web Streams（浏览器/Node 22+）或 Node.js 原生 streams。
 
 ### 流式读取器
 
@@ -142,7 +204,7 @@ for await (const worksheet of reader) {
 }
 ```
 
-### Web Streams（Node.js 20+ 与浏览器）
+### Web Streams（Node.js 22+ 与浏览器）
 
 `WorkbookWriter` 支持写入 Web `WritableStream<Uint8Array>`，`WorkbookReader` 支持从 Web `ReadableStream<Uint8Array>` 读取。
 
@@ -150,7 +212,7 @@ for await (const worksheet of reader) {
 
 - 可运行完整示例: [src/modules/excel/examples/web-streams-reader-writer.ts](src/modules/excel/examples/web-streams-reader-writer.ts)
 
-本地运行（Node.js 20+）:
+本地运行（Node.js 22+）:
 
 ```bash
 npx tsx src/modules/excel/examples/web-streams-reader-writer.ts
@@ -231,26 +293,27 @@ await workbook.commit();
 
 ```javascript
 import { Workbook } from "@cj-tech-master/excelts";
+import fs from "fs";
 
 const workbook = new Workbook();
 
-// 从文件读取 CSV（流式）
-await workbook.csv.readFile("data.csv");
+// 从文件读取 CSV
+await workbook.readCsvFile("data.csv");
 
 // 从流读取 CSV
-import fs from "fs";
 const stream = fs.createReadStream("data.csv");
-await workbook.csv.read(stream, { sheetName: "Imported" });
+await workbook.readCsv(stream, { sheetName: "Imported" });
 
-// 写入 CSV 到文件（流式）
-await workbook.csv.writeFile("output.csv");
+// 写入 CSV 到文件
+await workbook.writeCsvFile("output.csv");
 
 // 写入 CSV 到流
 const writeStream = fs.createWriteStream("output.csv");
-await workbook.csv.write(writeStream);
+await workbook.writeCsv(writeStream);
 
-// 写入 CSV 到 buffer
-const buffer = await workbook.csv.writeBuffer();
+// 写入 CSV 为字符串 / 字节
+const csvText = workbook.writeCsv();
+const bytes = await workbook.writeCsvBuffer();
 ```
 
 ### 浏览器（内存中）
@@ -260,19 +323,22 @@ import { Workbook } from "@cj-tech-master/excelts";
 
 const workbook = new Workbook();
 
-// 从字符串加载 CSV
-workbook.csv.load(csvString);
+// 从字符串读取 CSV
+await workbook.readCsv(csvString);
 
-// 从 ArrayBuffer 加载 CSV（例如从 fetch 或文件输入）
+// 从 ArrayBuffer 读取 CSV（例如从 fetch）
 const response = await fetch("data.csv");
 const arrayBuffer = await response.arrayBuffer();
-workbook.csv.load(arrayBuffer);
+await workbook.readCsv(arrayBuffer);
+
+// 从 File 读取 CSV（例如 <input type="file">）
+await workbook.readCsv(file);
 
 // 写入 CSV 为字符串
-const csvOutput = workbook.csv.writeString();
+const csvOutput = workbook.writeCsv();
 
-// 写入 CSV 为 Uint8Array buffer
-const buffer = workbook.csv.writeBuffer();
+// 写入 CSV 为 Uint8Array 字节
+const bytes = await workbook.writeCsvBuffer();
 ```
 
 ## 浏览器支持
@@ -328,17 +394,53 @@ npx serve .
 ### 浏览器版本注意事项
 
 - **支持 CSV 操作**（使用原生 RFC 4180 标准实现）
-  - 使用 `csv.load(stringOrArrayBuffer)` 读取 CSV
-  - 使用 `csv.writeString()` 或 `csv.writeBuffer()` 写入 CSV
+  - 使用 `await workbook.readCsv(input)` 读取 CSV
+  - 使用 `workbook.writeCsv()` 或 `await workbook.writeCsvBuffer()` 写入 CSV
 - 使用 `xlsx.load(arrayBuffer)` 代替 `xlsx.readFile()`
 - 使用 `xlsx.writeBuffer()` 代替 `xlsx.writeFile()`
 - 完全支持带密码的工作表保护（纯 JS SHA-512 实现）
 
+## 工具导出
+
+主入口还导出了常用工具函数：
+
+```typescript
+import {
+  // Excel 日期转换
+  dateToExcel, // JS Date -> Excel 序列号
+  excelToDate, // Excel 序列号 -> JS Date
+
+  // 日期解析/格式化（高性能，零依赖）
+  DateParser, // 批量日期解析器，支持格式自动检测
+  DateFormatter, // 批量日期格式化器
+
+  // 二进制工具（跨平台）
+  base64ToUint8Array,
+  uint8ArrayToBase64,
+  concatUint8Arrays,
+  toUint8Array,
+  stringToUint8Array,
+  uint8ArrayToString,
+
+  // XML 工具
+  xmlEncode,
+  xmlDecode,
+
+  // 错误基础设施
+  BaseError, // 所有库错误的基类
+  ExcelError, // Excel 基础错误（支持 instanceof 检查）
+  toError, // 将 unknown 标准化为 Error
+  errorToJSON, // 序列化错误（包含 cause 链）
+  getErrorChain, // 获取完整的错误 cause 链数组
+  getRootCause // 获取 cause 链中最深层的错误
+} from "@cj-tech-master/excelts";
+```
+
 ## 系统要求
 
 ### Node.js
 
-- **Node.js >= 20.0.0**（原生支持 ES2020）
+- **Node.js >= 22.0.0**（原生支持 ES2020）
 
 ### 浏览器（无需 Polyfills）
 

package/THIRD_PARTY_NOTICES.md

@@ -29,53 +29,3 @@ 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
-
-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/browser/index.browser.d.ts

@@ -2,27 +2,38 @@
  * 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 { FormCheckbox } from "@excel/form-control";
-export * from "@excel/enums";
-export * from "@excel/types";
-export type { PivotTable, PivotTableModel, PivotTableValue, PivotTableSource, CacheField, SharedItemValue, DataField, PivotTableSubtotal, RecordValue, ParsedCacheDefinition, ParsedCacheRecords } from "@excel/pivot-table";
-export type { FormCheckboxModel, FormCheckboxOptions, FormControlRange, FormControlAnchor } from "@excel/form-control";
-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 { 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";
+export { FormCheckbox } from "./modules/excel/form-control.js";
+export * from "./modules/excel/enums.js";
+export * from "./modules/excel/types.js";
+export type { PivotTable, PivotTableModel, PivotTableValue, PivotTableSource, CacheField, SharedItemValue, DataField, PivotTableSubtotal, RecordValue, ParsedCacheDefinition, ParsedCacheRecords } from "./modules/excel/pivot-table.js";
+export type { FormCheckboxModel, FormCheckboxOptions, FormControlRange, FormControlAnchor } from "./modules/excel/form-control.js";
+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 type { CsvReadOptions, CsvWriteOptions, CsvStreamReadOptions, CsvStreamWriteOptions } from "@csv/csv.browser";
-export { CsvParserStream, CsvFormatterStream } from "@csv/csv.browser";
-export * from "@excel/utils/sheet-utils";
-export { zip, unzip, ZipArchive, ZipReader, UnzipEntry, type ZipOptions, type ZipEntryOptions, type UnzipOptions, type ArchiveSource, type ArchiveSink, crc32, crc32Update, crc32Finalize, compress, compressSync, decompress, decompressSync, hasCompressionStream, type CompressOptions, createDeflateStream, createInflateStream, hasDeflateRaw, type StreamCompressOptions } from "@archive/index.browser";
+export type { CsvOptions, CsvInput } from "./modules/excel/workbook.js";
+export { CsvParserStream, CsvFormatterStream, createCsvParserStream, createCsvFormatterStream } from "./modules/csv/stream/index.js";
+export { DefinedNames, type DefinedNameModel } from "./modules/excel/defined-names.js";
+export type { CheckboxState } from "./modules/excel/form-control.js";
+export type { ColumnDefn, ColumnHeaderValue } from "./modules/excel/column.js";
+export type { RangeInput } from "./modules/excel/range.js";
+export type { WorkbookModel, WorkbookMedia } from "./modules/excel/workbook.js";
+export * from "./modules/excel/utils/sheet-utils.js";
+export { dateToExcel, excelToDate } from "./utils/utils.base.js";
+export { base64ToUint8Array, uint8ArrayToBase64 } from "./utils/utils.base.js";
+export { xmlEncode, xmlDecode } from "./utils/utils.base.js";
+export { DateParser, DateFormatter, getSupportedFormats, type DateFormat } from "./utils/datetime.js";
+export { BaseError, type BaseErrorOptions, toError, errorToJSON, getErrorChain, getRootCause } from "./utils/errors.js";
+export { concatUint8Arrays, toUint8Array, stringToUint8Array, uint8ArrayToString } from "./utils/binary.js";
+export { ExcelError, isExcelError, ExcelFileError, ExcelDownloadError, ExcelNotSupportedError, ExcelStreamStateError, InvalidAddressError, ColumnOutOfBoundsError, RowOutOfBoundsError, MergeConflictError, InvalidValueTypeError, XmlParseError, WorksheetNameError, PivotTableError, TableError, ImageError, MaxItemsExceededError } from "./modules/excel/errors.js";

package/dist/browser/index.browser.js

@@ -5,7 +5,7 @@
 // =============================================================================
 // Main Classes (Browser-compatible)
 // =============================================================================
-export { Workbook } from "./modules/excel/workbook.js";
+export { Workbook } from "./modules/excel/workbook.browser.js";
 export { Worksheet } from "./modules/excel/worksheet.js";
 export { Row } from "./modules/excel/row.js";
 export { Column } from "./modules/excel/column.js";
@@ -34,20 +34,28 @@ import { WorkbookReader } from "./modules/excel/stream/workbook-reader.browser.j
 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";
+export { CsvParserStream, CsvFormatterStream, createCsvParserStream, createCsvFormatterStream } from "./modules/csv/stream/index.js";
+// =============================================================================
+// Additional Classes & Types
+// =============================================================================
+export { DefinedNames } from "./modules/excel/defined-names.js";
 // =============================================================================
 // Utilities
 // =============================================================================
 export * from "./modules/excel/utils/sheet-utils.js";
-// =============================================================================
-// Archive (ZIP) support (Browser-compatible)
-// =============================================================================
-export { 
-// High-level archive API
-zip, unzip, ZipArchive, ZipReader, UnzipEntry, 
-// CRC32
-crc32, crc32Update, crc32Finalize, 
-// Compression utilities
-compress, compressSync, decompress, decompressSync, hasCompressionStream, 
-// Streaming compression
-createDeflateStream, createInflateStream, hasDeflateRaw } from "./modules/archive/index.browser.js";
+// Date conversion (Excel serial dates <-> JS Date)
+export { dateToExcel, excelToDate } from "./utils/utils.base.js";
+// Base64 utilities (cross-platform)
+export { base64ToUint8Array, uint8ArrayToBase64 } from "./utils/utils.base.js";
+// XML utilities
+export { xmlEncode, xmlDecode } from "./utils/utils.base.js";
+// Date parsing/formatting (high-performance, zero-dep)
+export { DateParser, DateFormatter, getSupportedFormats } from "./utils/datetime.js";
+// Error infrastructure
+export { BaseError, toError, errorToJSON, getErrorChain, getRootCause } from "./utils/errors.js";
+// Binary utilities (cross-platform)
+export { concatUint8Arrays, toUint8Array, stringToUint8Array, uint8ArrayToString } from "./utils/binary.js";
+// =============================================================================
+// Errors
+// =============================================================================
+export { ExcelError, isExcelError, ExcelFileError, ExcelDownloadError, ExcelNotSupportedError, ExcelStreamStateError, InvalidAddressError, ColumnOutOfBoundsError, RowOutOfBoundsError, MergeConflictError, InvalidValueTypeError, XmlParseError, WorksheetNameError, PivotTableError, TableError, ImageError, MaxItemsExceededError } from "./modules/excel/errors.js";