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

package/dist/esm/doc/workbook.base.js

@@ -0,0 +1,207 @@
+/**
+ * WorkbookBase - Platform-independent base class for Workbook
+ *
+ * This file contains all the shared logic between Node.js and Browser versions.
+ * Platform-specific features (xlsx, csv, streaming) are added by subclasses.
+ */
+import { Worksheet } from "./worksheet.js";
+import { DefinedNames } from "./defined-names.js";
+// =============================================================================
+// WorkbookBase Class
+// =============================================================================
+/**
+ * Base class for Workbook containing all platform-independent functionality.
+ *
+ * Subclasses add:
+ * - Node.js: xlsx (full), csv, streaming (createStreamWriter/Reader)
+ * - Browser: xlsx (buffer only), no csv, no streaming
+ */
+export class WorkbookBase {
+    constructor() {
+        this.category = "";
+        this.company = "";
+        this.created = new Date();
+        this.description = "";
+        this.keywords = "";
+        this.manager = "";
+        this.modified = this.created;
+        this.properties = {};
+        this.calcProperties = {};
+        this._worksheets = [];
+        this.subject = "";
+        this.title = "";
+        this.views = [];
+        this.media = [];
+        this.pivotTables = [];
+        this._definedNames = new DefinedNames();
+    }
+    // ===========================================================================
+    // Worksheet Management
+    // ===========================================================================
+    get nextId() {
+        // Find the next unique spot to add worksheet
+        for (let i = 1; i < this._worksheets.length; i++) {
+            if (!this._worksheets[i]) {
+                return i;
+            }
+        }
+        return this._worksheets.length || 1;
+    }
+    /**
+     * Add a new worksheet and return a reference to it
+     */
+    addWorksheet(name, options) {
+        const id = this.nextId;
+        const lastOrderNo = this._worksheets.reduce((acc, ws) => ((ws && ws.orderNo) > acc ? ws.orderNo : acc), 0);
+        const worksheetOptions = {
+            ...options,
+            id,
+            name,
+            orderNo: lastOrderNo + 1,
+            workbook: this
+        };
+        const worksheet = new Worksheet(worksheetOptions);
+        this._worksheets[id] = worksheet;
+        return worksheet;
+    }
+    removeWorksheetEx(worksheet) {
+        delete this._worksheets[worksheet.id];
+    }
+    removeWorksheet(id) {
+        const worksheet = this.getWorksheet(id);
+        if (worksheet) {
+            worksheet.destroy();
+        }
+    }
+    /**
+     * Fetch sheet by name or id
+     */
+    getWorksheet(id) {
+        if (id === undefined) {
+            return this._worksheets.find(Boolean);
+        }
+        if (typeof id === "number") {
+            return this._worksheets[id];
+        }
+        if (typeof id === "string") {
+            return this._worksheets.find(worksheet => worksheet && worksheet.name === id);
+        }
+        return undefined;
+    }
+    /**
+     * Return a clone of worksheets in order
+     */
+    get worksheets() {
+        return this._worksheets
+            .slice(1)
+            .sort((a, b) => a.orderNo - b.orderNo)
+            .filter(Boolean);
+    }
+    /**
+     * Iterate over all sheets.
+     *
+     * Note: `workbook.worksheets.forEach` will still work but this is better.
+     */
+    eachSheet(callback) {
+        this.worksheets.forEach(sheet => {
+            callback(sheet, sheet.id);
+        });
+    }
+    // ===========================================================================
+    // Defined Names
+    // ===========================================================================
+    get definedNames() {
+        return this._definedNames;
+    }
+    // ===========================================================================
+    // Themes
+    // ===========================================================================
+    clearThemes() {
+        // Note: themes are not an exposed feature, meddle at your peril!
+        this._themes = undefined;
+    }
+    // ===========================================================================
+    // Images
+    // ===========================================================================
+    /**
+     * Add Image to Workbook and return the id
+     */
+    addImage(image) {
+        const id = this.media.length;
+        this.media.push({ ...image, type: "image" });
+        return id;
+    }
+    getImage(id) {
+        return this.media[Number(id)];
+    }
+    // ===========================================================================
+    // Model (Serialization)
+    // ===========================================================================
+    get model() {
+        return {
+            creator: this.creator || "Unknown",
+            lastModifiedBy: this.lastModifiedBy || "Unknown",
+            lastPrinted: this.lastPrinted,
+            created: this.created,
+            modified: this.modified,
+            properties: this.properties,
+            worksheets: this.worksheets.map(worksheet => worksheet.model),
+            sheets: this.worksheets.map(ws => ws.model).filter(Boolean),
+            definedNames: this._definedNames.model,
+            views: this.views,
+            company: this.company,
+            manager: this.manager,
+            title: this.title,
+            subject: this.subject,
+            keywords: this.keywords,
+            category: this.category,
+            description: this.description,
+            language: this.language,
+            revision: this.revision,
+            contentStatus: this.contentStatus,
+            themes: this._themes,
+            media: this.media,
+            pivotTables: this.pivotTables,
+            calcProperties: this.calcProperties
+        };
+    }
+    set model(value) {
+        this.creator = value.creator;
+        this.lastModifiedBy = value.lastModifiedBy;
+        this.lastPrinted = value.lastPrinted;
+        this.created = value.created;
+        this.modified = value.modified;
+        this.company = value.company;
+        this.manager = value.manager;
+        this.title = value.title;
+        this.subject = value.subject;
+        this.keywords = value.keywords;
+        this.category = value.category;
+        this.description = value.description;
+        this.language = value.language;
+        this.revision = value.revision;
+        this.contentStatus = value.contentStatus;
+        this.properties = value.properties;
+        this.calcProperties = value.calcProperties;
+        this._worksheets = [];
+        value.worksheets.forEach(worksheetModel => {
+            const { id, name, state } = worksheetModel;
+            const orderNo = value.sheets && value.sheets.findIndex(ws => ws.id === id);
+            const worksheet = (this._worksheets[id] = new Worksheet({
+                id,
+                name,
+                orderNo: orderNo !== -1 ? orderNo : undefined,
+                state,
+                workbook: this
+            }));
+            worksheet.model = worksheetModel;
+        });
+        this._definedNames.model = value.definedNames;
+        this.views = value.views;
+        this._themes = value.themes;
+        this.media = value.media || [];
+        // Handle pivot tables - either newly created or loaded from file
+        // Loaded pivot tables come from loadedPivotTables after reconciliation
+        this.pivotTables = value.pivotTables || value.loadedPivotTables || [];
+    }
+}

package/dist/esm/doc/workbook.browser.js

@@ -0,0 +1,59 @@
+/**
+ * Workbook Browser version - No Node.js dependencies
+ *
+ * Extends WorkbookBase with:
+ * - xlsx: Buffer-based operations (load, writeBuffer)
+ * - csv: Buffer-based operations (load, writeString, writeBuffer)
+ * - streaming: NOT supported (throws error)
+ */
+import { WorkbookBase } from "./workbook.base.js";
+import { XLSX } from "../xlsx/xlsx.browser.js";
+import { CSV } from "../csv/csv.browser.js";
+class Workbook extends WorkbookBase {
+    /**
+     * xlsx file format operations
+     * Supports: load (buffer), writeBuffer
+     * NOT supported: readFile, writeFile, read (stream), write (stream)
+     */
+    get xlsx() {
+        if (!this._xlsx) {
+            this._xlsx = new XLSX(this);
+        }
+        return this._xlsx;
+    }
+    /**
+     * CSV file format operations
+     * Supports: load (string/buffer), writeString, writeBuffer
+     * NOT supported: readFile, writeFile, read (stream), write (stream)
+     */
+    get csv() {
+        if (!this._csv) {
+            this._csv = new CSV(this);
+        }
+        return this._csv;
+    }
+    // ===========================================================================
+    // Static Factory Methods - NOT available in browser
+    // TypeScript users: These methods don't exist on this type
+    // JavaScript users: These methods throw helpful errors
+    // ===========================================================================
+    /**
+     * @deprecated Streaming is not available in browser
+     * @throws Error with helpful message
+     */
+    static createStreamWriter(_options) {
+        throw new Error("Streaming workbook writer is not available in browser. " +
+            "Use `new Workbook()` with `xlsx.writeBuffer()` instead, " +
+            "or import from 'excelts' (Node.js) for streaming support.");
+    }
+    /**
+     * @deprecated Streaming is not available in browser
+     * @throws Error with helpful message
+     */
+    static createStreamReader(_input, _options) {
+        throw new Error("Streaming workbook reader is not available in browser. " +
+            "Use `new Workbook()` with `xlsx.load()` instead, " +
+            "or import from 'excelts' (Node.js) for streaming support.");
+    }
+}
+export { Workbook };

package/dist/esm/doc/workbook.js

@@ -1,33 +1,20 @@
-import { Worksheet } from "./worksheet.js";
-import { DefinedNames } from "./defined-names.js";
+/**
+ * Workbook - Node.js version with full functionality
+ *
+ * Extends WorkbookBase with:
+ * - xlsx: Full file/stream/buffer support
+ * - csv: CSV read/write support
+ * - streaming: createStreamWriter/createStreamReader for large files
+ */
+import { WorkbookBase } from "./workbook.base.js";
 import { XLSX } from "../xlsx/xlsx.js";
 import { CSV } from "../csv/csv.js";
-// Workbook requirements
-//  Load and Save from file and stream
-//  Access/Add/Delete individual worksheets
-//  Manage String table, Hyperlink table, etc.
-//  Manage scaffolding for contained objects to write to/read from
-class Workbook {
-    constructor() {
-        this.category = "";
-        this.company = "";
-        this.created = new Date();
-        this.description = "";
-        this.keywords = "";
-        this.manager = "";
-        this.modified = this.created;
-        this.properties = {};
-        this.calcProperties = {};
-        this._worksheets = [];
-        this.subject = "";
-        this.title = "";
-        this.views = [];
-        this.media = [];
-        this.pivotTables = [];
-        this._definedNames = new DefinedNames();
-    }
+import { WorkbookWriter } from "../stream/xlsx/workbook-writer.js";
+import { WorkbookReader } from "../stream/xlsx/workbook-reader.js";
+class Workbook extends WorkbookBase {
     /**
      * xlsx file format operations
+     * Supports: readFile, writeFile, read (stream), write (stream), load (buffer), writeBuffer
      */
     get xlsx() {
         if (!this._xlsx) {
@@ -37,6 +24,7 @@ class Workbook {
     }
     /**
      * csv file format operations
+     * Supports: readFile, writeFile, read (stream), write (stream)
      */
     get csv() {
         if (!this._csv) {
@@ -44,161 +32,62 @@ class Workbook {
         }
         return this._csv;
     }
-    get nextId() {
-        // find the next unique spot to add worksheet
-        for (let i = 1; i < this._worksheets.length; i++) {
-            if (!this._worksheets[i]) {
-                return i;
-            }
-        }
-        return this._worksheets.length || 1;
-    }
-    /**
-     * Add a new worksheet and return a reference to it
-     */
-    addWorksheet(name, options) {
-        const id = this.nextId;
-        const lastOrderNo = this._worksheets.reduce((acc, ws) => ((ws && ws.orderNo) > acc ? ws.orderNo : acc), 0);
-        const worksheetOptions = {
-            ...options,
-            id,
-            name,
-            orderNo: lastOrderNo + 1,
-            workbook: this
-        };
-        const worksheet = new Worksheet(worksheetOptions);
-        this._worksheets[id] = worksheet;
-        return worksheet;
-    }
-    removeWorksheetEx(worksheet) {
-        delete this._worksheets[worksheet.id];
-    }
-    removeWorksheet(id) {
-        const worksheet = this.getWorksheet(id);
-        if (worksheet) {
-            worksheet.destroy();
-        }
-    }
-    /**
-     * Fetch sheet by name or id
-     */
-    getWorksheet(id) {
-        if (id === undefined) {
-            return this._worksheets.find(Boolean);
-        }
-        if (typeof id === "number") {
-            return this._worksheets[id];
-        }
-        if (typeof id === "string") {
-            return this._worksheets.find(worksheet => worksheet && worksheet.name === id);
-        }
-        return undefined;
-    }
+    // ===========================================================================
+    // Static Factory Methods for Streaming (Node.js only)
+    // ===========================================================================
     /**
-     * Return a clone of worksheets in order
-     */
-    get worksheets() {
-        // return a clone of _worksheets
-        return this._worksheets
-            .slice(1)
-            .sort((a, b) => a.orderNo - b.orderNo)
-            .filter(Boolean);
-    }
-    /**
-     * Iterate over all sheets.
+     * Create a streaming workbook writer for large files.
+     * This is more memory-efficient than using Workbook for large datasets.
+     *
+     * @param options - Options for the workbook writer
+     * @returns A new WorkbookWriter instance
      *
-     * Note: `workbook.worksheets.forEach` will still work but this is better.
+     * @example
+     * ```ts
+     * const writer = Workbook.createStreamWriter({ filename: "large-file.xlsx" });
+     * const sheet = writer.addWorksheet("Sheet1");
+     * for (let i = 0; i < 1000000; i++) {
+     *   sheet.addRow([i, `Row ${i}`]).commit();
+     * }
+     * await writer.commit();
+     * ```
      */
-    eachSheet(callback) {
-        this.worksheets.forEach(sheet => {
-            callback(sheet, sheet.id);
-        });
-    }
-    get definedNames() {
-        return this._definedNames;
-    }
-    clearThemes() {
-        // Note: themes are not an exposed feature, meddle at your peril!
-        this._themes = undefined;
+    static createStreamWriter(options) {
+        return new WorkbookWriter(options);
     }
     /**
-     * Add Image to Workbook and return the id
+     * Create a streaming workbook reader for large files.
+     * This is more memory-efficient than using Workbook.xlsx.readFile for large datasets.
+     *
+     * @param input - File path or readable stream
+     * @param options - Options for the workbook reader
+     * @returns A new WorkbookReader instance
+     *
+     * @example
+     * ```ts
+     * const reader = Workbook.createStreamReader("large-file.xlsx");
+     * for await (const event of reader) {
+     *   if (event.eventType === "worksheet") {
+     *     const worksheet = event.value;
+     *     for await (const row of worksheet) {
+     *       console.log(row.values);
+     *     }
+     *   }
+     * }
+     * ```
      */
-    addImage(image) {
-        // TODO:  validation?
-        const id = this.media.length;
-        this.media.push({ ...image, type: "image" });
-        return id;
-    }
-    getImage(id) {
-        return this.media[Number(id)];
-    }
-    get model() {
-        return {
-            creator: this.creator || "Unknown",
-            lastModifiedBy: this.lastModifiedBy || "Unknown",
-            lastPrinted: this.lastPrinted,
-            created: this.created,
-            modified: this.modified,
-            properties: this.properties,
-            worksheets: this.worksheets.map(worksheet => worksheet.model),
-            sheets: this.worksheets.map(ws => ws.model).filter(Boolean),
-            definedNames: this._definedNames.model,
-            views: this.views,
-            company: this.company,
-            manager: this.manager,
-            title: this.title,
-            subject: this.subject,
-            keywords: this.keywords,
-            category: this.category,
-            description: this.description,
-            language: this.language,
-            revision: this.revision,
-            contentStatus: this.contentStatus,
-            themes: this._themes,
-            media: this.media,
-            pivotTables: this.pivotTables,
-            calcProperties: this.calcProperties
-        };
-    }
-    set model(value) {
-        this.creator = value.creator;
-        this.lastModifiedBy = value.lastModifiedBy;
-        this.lastPrinted = value.lastPrinted;
-        this.created = value.created;
-        this.modified = value.modified;
-        this.company = value.company;
-        this.manager = value.manager;
-        this.title = value.title;
-        this.subject = value.subject;
-        this.keywords = value.keywords;
-        this.category = value.category;
-        this.description = value.description;
-        this.language = value.language;
-        this.revision = value.revision;
-        this.contentStatus = value.contentStatus;
-        this.properties = value.properties;
-        this.calcProperties = value.calcProperties;
-        this._worksheets = [];
-        value.worksheets.forEach(worksheetModel => {
-            const { id, name, state } = worksheetModel;
-            const orderNo = value.sheets && value.sheets.findIndex(ws => ws.id === id);
-            const worksheet = (this._worksheets[id] = new Worksheet({
-                id,
-                name,
-                orderNo: orderNo !== -1 ? orderNo : undefined,
-                state,
-                workbook: this
-            }));
-            worksheet.model = worksheetModel;
-        });
-        this._definedNames.model = value.definedNames;
-        this.views = value.views;
-        this._themes = value.themes;
-        this.media = value.media || [];
-        // Handle pivot tables - either newly created or loaded from file
-        // Loaded pivot tables come from loadedPivotTables after reconciliation
-        this.pivotTables = value.pivotTables || value.loadedPivotTables || [];
+    static createStreamReader(input, options) {
+        return new WorkbookReader(input, options);
     }
 }
+/**
+ * Streaming workbook writer class for large files.
+ * @example new Workbook.Writer({ filename: "large.xlsx" })
+ */
+Workbook.Writer = WorkbookWriter;
+/**
+ * Streaming workbook reader class for large files.
+ * @example new Workbook.Reader("large.xlsx")
+ */
+Workbook.Reader = WorkbookReader;
 export { Workbook };

package/dist/esm/index.browser.js

@@ -1,4 +1,36 @@
-export { Workbook } from "./doc/workbook.js";
+/**
+ * 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 "./doc/workbook.browser.js";
+export { Worksheet } from "./doc/worksheet.js";
+export { Row } from "./doc/row.js";
+export { Column } from "./doc/column.js";
+export { Cell } from "./doc/cell.js";
+export { Range } from "./doc/range.js";
+export { Image } from "./doc/image.js";
+export * from "./doc/anchor.js";
+export { Table } from "./doc/table.js";
+export { DataValidations } from "./doc/data-validations.js";
+// =============================================================================
+// Enums
+// =============================================================================
 export * from "./doc/enums.js";
+// =============================================================================
+// Types
+// =============================================================================
+// Export all type definitions from types.ts
 export * from "./types.js";
+// =============================================================================
+// Utilities
+// =============================================================================
 export * from "./utils/sheet-utils.js";
+// =============================================================================
+// NOTE: The following are NOT exported in browser build (Node.js only):
+// - WorkbookWriter, WorkbookReader (streaming classes for file I/O)
+// - WorksheetWriter, WorksheetReader (streaming classes)
+// - ModelContainer
+// =============================================================================

package/dist/esm/index.js

@@ -1,11 +1,8 @@
-// Export main classes
+// =============================================================================
+// Main Classes
+// =============================================================================
 export { Workbook } from "./doc/workbook.js";
-export { ModelContainer } from "./doc/modelcontainer.js";
-export { WorkbookWriter } from "./stream/xlsx/workbook-writer.js";
-export { WorkbookReader } from "./stream/xlsx/workbook-reader.js";
 export { Worksheet } from "./doc/worksheet.js";
-export { WorksheetReader } from "./stream/xlsx/worksheet-reader.js";
-export { WorksheetWriter } from "./stream/xlsx/worksheet-writer.js";
 export { Row } from "./doc/row.js";
 export { Column } from "./doc/column.js";
 export { Cell } from "./doc/cell.js";
@@ -14,8 +11,26 @@ export { Image } from "./doc/image.js";
 export * from "./doc/anchor.js";
 export { Table } from "./doc/table.js";
 export { DataValidations } from "./doc/data-validations.js";
-// Export enums
+// =============================================================================
+// Node.js Only: Streaming Classes
+// These can also be accessed via Workbook.createStreamWriter/createStreamReader
+// =============================================================================
+export { WorkbookWriter } from "./stream/xlsx/workbook-writer.js";
+export { WorkbookReader } from "./stream/xlsx/workbook-reader.js";
+export { WorksheetWriter } from "./stream/xlsx/worksheet-writer.js";
+export { WorksheetReader } from "./stream/xlsx/worksheet-reader.js";
+export { ModelContainer } from "./doc/modelcontainer.js";
+// =============================================================================
+// Enums
+// =============================================================================
 export * from "./doc/enums.js";
-// Export all type definitions
+// =============================================================================
+// Types
+// =============================================================================
+// Export all type definitions from types.ts
 export * from "./types.js";
+export { CsvParserStream, CsvFormatterStream } from "./csv/csv.js";
+// =============================================================================
+// Utilities
+// =============================================================================
 export * from "./utils/sheet-utils.js";

package/dist/esm/local.js

@@ -1,2 +1 @@
 console.log(123);
-export {};

package/dist/esm/stream/xlsx/hyperlink-reader.js

@@ -49,7 +49,7 @@ class HyperlinkReader extends EventEmitter {
                                 case RelType.Hyperlink:
                                     {
                                         const relationship = {
-                                            type: Enums.RelationshipType.Styles,
+                                            type: Enums.RelationshipType.Hyperlink,
                                             rId,
                                             target: node.attributes.Target,
                                             targetMode: node.attributes.TargetMode

package/dist/esm/stream/xlsx/workbook-reader.js

@@ -67,6 +67,9 @@ class WorkbookReader extends EventEmitter {
     }
     async *parse(input, options) {
         if (options) {
+            // Note: This replaces all options, not merging with constructor defaults.
+            // This is intentional for backwards compatibility - passing partial options
+            // to parse() will leave unspecified options as undefined.
             this.options = options;
         }
         const stream = (this.stream = this._getStream(input || this.input));
@@ -310,13 +313,13 @@ class WorkbookReader extends EventEmitter {
         const worksheetReader = new WorksheetReader({
             workbook: this,
             id: parseInt(sheetNo, 10),
-            iterator,
+            iterator: iterator,
             options: this.options
         });
-        const matchingRel = (this.workbookRels || []).find((rel) => rel.Target === `worksheets/sheet${sheetNo}.xml`);
+        const matchingRel = (this.workbookRels || []).find(rel => rel.Target === `worksheets/sheet${sheetNo}.xml`);
         const matchingSheet = matchingRel &&
             this.model &&
-            (this.model.sheets || []).find((sheet) => sheet.rId === matchingRel.Id);
+            (this.model.sheets || []).find(sheet => sheet.rId === matchingRel.Id);
         if (matchingSheet) {
             worksheetReader.id = matchingSheet.id;
             worksheetReader.name = matchingSheet.name;
@@ -331,7 +334,7 @@ class WorkbookReader extends EventEmitter {
         const hyperlinksReader = new HyperlinkReader({
             workbook: this,
             id: parseInt(sheetNo, 10),
-            iterator,
+            iterator: iterator,
             options: this.options
         });
         if (this.options.hyperlinks === "emit") {