@cj-tech-master/excelts 1.6.2 → 1.6.3

package/dist/browser/excelts.iife.min.js

@@ -1,5 +1,5 @@
 /*!
-* @cj-tech-master/excelts v1.6.2
+* @cj-tech-master/excelts v1.6.3
 * TypeScript Excel Workbook Manager - Read and Write xlsx and csv Files.
 * (c) 2025 cjnoname
 * Released under the MIT License

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

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

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

@@ -73,6 +73,9 @@ class WorkbookReader extends events_1.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));
@@ -316,13 +319,13 @@ class WorkbookReader extends events_1.EventEmitter {
         const worksheetReader = new worksheet_reader_js_1.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;
@@ -337,7 +340,7 @@ class WorkbookReader extends events_1.EventEmitter {
         const hyperlinksReader = new hyperlink_reader_js_1.HyperlinkReader({
             workbook: this,
             id: parseInt(sheetNo, 10),
-            iterator,
+            iterator: iterator,
             options: this.options
         });
         if (this.options.hyperlinks === "emit") {

package/dist/cjs/stream/xlsx/workbook-writer.js

@@ -98,14 +98,14 @@ class WorkbookWriter {
         let buffer;
         if (base64) {
             // Use Buffer.from for efficient base64 decoding
-            const base64Data = typeof data === "string" ? data : data.toString();
+            const base64Data = typeof data === "string" ? data : new TextDecoder().decode(data);
             buffer = Buffer.from(base64Data, "base64");
         }
         else if (typeof data === "string") {
             buffer = Buffer.from(data, "utf8");
         }
         else {
-            buffer = new Uint8Array(data);
+            buffer = data;
         }
         zipFile.push(buffer, true); // true = final chunk
     }
@@ -125,15 +125,15 @@ class WorkbookWriter {
         // if there are any uncommitted worksheets, commit them now and wait
         const promises = this._worksheets.map(commitWorksheet);
         if (promises.length) {
-            return Promise.all(promises);
+            return Promise.all(promises).then(() => { });
         }
         return Promise.resolve();
     }
     async commit() {
-        // commit all worksheets, then add suplimentary files
+        // commit all worksheets, then add supplementary files
         await this.promise;
-        await this.addMedia();
         await this._commitWorksheets();
+        await this.addMedia();
         await Promise.all([
             this.addContentTypes(),
             this.addApp(),
@@ -155,28 +155,39 @@ class WorkbookWriter {
         }
         return this._worksheets.length || 1;
     }
+    /**
+     * Add Image to Workbook and return the id
+     */
     addImage(image) {
         const id = this.media.length;
-        const medium = Object.assign({}, image, {
+        const medium = {
+            ...image,
             type: "image",
             name: `image${id}.${image.extension}`
-        });
+        };
         this.media.push(medium);
         return id;
     }
+    /**
+     * Get image by id
+     */
     getImage(id) {
         return this.media[id];
     }
-    addWorksheet(name, options = {}) {
+    /**
+     * Add a new worksheet and return a reference to it
+     */
+    addWorksheet(name, options) {
         // it's possible to add a worksheet with different than default
         // shared string handling
         // in fact, it's even possible to switch it mid-sheet
-        const useSharedStrings = options.useSharedStrings !== undefined ? options.useSharedStrings : this.useSharedStrings;
-        if (options.tabColor) {
+        const opts = options || {};
+        const useSharedStrings = opts.useSharedStrings !== undefined ? opts.useSharedStrings : this.useSharedStrings;
+        if (opts.tabColor) {
             console.trace("tabColor option has moved to { properties: tabColor: {...} }");
-            options.properties = Object.assign({
-                tabColor: options.tabColor
-            }, options.properties);
+            opts.properties = Object.assign({
+                tabColor: opts.tabColor
+            }, opts.properties);
         }
         const id = this.nextId;
         name = name || `sheet${id}`;
@@ -185,16 +196,19 @@ class WorkbookWriter {
             name,
             workbook: this,
             useSharedStrings,
-            properties: options.properties,
-            state: options.state,
-            pageSetup: options.pageSetup,
-            views: options.views,
-            autoFilter: options.autoFilter,
-            headerFooter: options.headerFooter
+            properties: opts.properties,
+            state: opts.state,
+            pageSetup: opts.pageSetup,
+            views: opts.views,
+            autoFilter: opts.autoFilter,
+            headerFooter: opts.headerFooter
         });
         this._worksheets[id] = worksheet;
         return worksheet;
     }
+    /**
+     * Fetch sheet by name or id
+     */
     getWorksheet(id) {
         if (id === undefined) {
             return this._worksheets.find(() => true);
@@ -203,7 +217,7 @@ class WorkbookWriter {
             return this._worksheets[id];
         }
         if (typeof id === "string") {
-            return this._worksheets.find((worksheet) => worksheet && worksheet.name === id);
+            return this._worksheets.find(worksheet => worksheet && worksheet.name === id);
         }
         return undefined;
     }
@@ -256,7 +270,7 @@ class WorkbookWriter {
                                 reject(err);
                             }
                             else {
-                                resolve(data);
+                                resolve(new Uint8Array(data));
                             }
                         });
                     });
@@ -265,13 +279,13 @@ class WorkbookWriter {
                 }
                 if (medium.buffer) {
                     this._addFile(medium.buffer, filename);
-                    return Promise.resolve();
+                    return;
                 }
                 if (medium.base64) {
                     const dataimg64 = medium.base64;
                     const content = dataimg64.substring(dataimg64.indexOf(",") + 1);
                     this._addFile(content, filename, true);
-                    return Promise.resolve();
+                    return;
                 }
             }
             throw new Error("Unsupported media");

package/dist/cjs/stream/xlsx/worksheet-reader.js

@@ -28,7 +28,7 @@ class WorksheetReader extends events_1.EventEmitter {
     destroy() {
         throw new Error("Invalid Operation: destroy");
     }
-    // return the current dimensions of the writer
+    // return the current dimensions of the reader
     get dimensions() {
         return this._dimensions;
     }
@@ -47,7 +47,7 @@ class WorksheetReader extends events_1.EventEmitter {
             if (col) {
                 return col;
             }
-            // otherise, assume letter
+            // otherwise, assume letter
             c = col_cache_js_1.colCache.l2n(c);
         }
         if (!this._columns) {
@@ -88,9 +88,9 @@ class WorksheetReader extends events_1.EventEmitter {
     }
     async *[Symbol.asyncIterator]() {
         for await (const events of this.parse()) {
-            for (const { eventType, value } of events) {
-                if (eventType === "row") {
-                    yield value;
+            for (const event of events) {
+                if (event.eventType === "row") {
+                    yield event.value;
                 }
             }
         }
@@ -286,6 +286,7 @@ class WorksheetReader extends events_1.EventEmitter {
                                                     cell.value = sharedStrings[index];
                                                 }
                                                 else {
+                                                    // Streaming format - unresolved shared string reference
                                                     cell.value = {
                                                         sharedString: index
                                                     };
@@ -302,19 +303,22 @@ class WorksheetReader extends events_1.EventEmitter {
                                             case "b":
                                                 cell.value = parseInt(c.v.text, 10) !== 0;
                                                 break;
-                                            default:
-                                                if ((0, utils_js_1.isDateFmt)(cell.numFmt)) {
-                                                    cell.value = (0, utils_js_1.excelToDate)(parseFloat(c.v.text), properties.model && properties.model.date1904);
+                                            default: {
+                                                const numFmtStr = typeof cell.numFmt === "string" ? cell.numFmt : cell.numFmt?.formatCode;
+                                                if (numFmtStr && (0, utils_js_1.isDateFmt)(numFmtStr)) {
+                                                    cell.value = (0, utils_js_1.excelToDate)(parseFloat(c.v.text), properties?.model?.date1904);
                                                 }
                                                 else {
                                                     cell.value = parseFloat(c.v.text);
                                                 }
                                                 break;
+                                            }
                                         }
                                     }
                                     if (hyperlinks) {
                                         const hyperlink = hyperlinks[c.ref];
                                         if (hyperlink) {
+                                            // Streaming-specific: assign text and hyperlink for further processing
                                             cell.text = cell.value;
                                             cell.value = undefined;
                                             cell.hyperlink = hyperlink;

package/dist/cjs/stream/xlsx/worksheet-writer.js

@@ -278,20 +278,26 @@ class WorksheetWriter {
     }
     // iterate over every uncommitted row in the worksheet, including maybe empty rows
     eachRow(options, iteratee) {
-        if (!iteratee) {
-            iteratee = options;
-            options = undefined;
+        let callback;
+        let opts;
+        if (typeof options === "function") {
+            callback = options;
+            opts = undefined;
         }
-        if (options && options.includeEmpty) {
+        else {
+            callback = iteratee;
+            opts = options;
+        }
+        if (opts && opts.includeEmpty) {
             const n = this._nextRow;
             for (let i = this._rowZero; i < n; i++) {
-                iteratee(this.getRow(i), i);
+                callback(this.getRow(i), i);
             }
         }
         else {
             this._rows.forEach(row => {
                 if (row.hasValues) {
-                    iteratee(row, row.number);
+                    callback(row, row.number);
                 }
             });
         }

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") {

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

@@ -92,14 +92,14 @@ class WorkbookWriter {
         let buffer;
         if (base64) {
             // Use Buffer.from for efficient base64 decoding
-            const base64Data = typeof data === "string" ? data : data.toString();
+            const base64Data = typeof data === "string" ? data : new TextDecoder().decode(data);
             buffer = Buffer.from(base64Data, "base64");
         }
         else if (typeof data === "string") {
             buffer = Buffer.from(data, "utf8");
         }
         else {
-            buffer = new Uint8Array(data);
+            buffer = data;
         }
         zipFile.push(buffer, true); // true = final chunk
     }
@@ -119,15 +119,15 @@ class WorkbookWriter {
         // if there are any uncommitted worksheets, commit them now and wait
         const promises = this._worksheets.map(commitWorksheet);
         if (promises.length) {
-            return Promise.all(promises);
+            return Promise.all(promises).then(() => { });
         }
         return Promise.resolve();
     }
     async commit() {
-        // commit all worksheets, then add suplimentary files
+        // commit all worksheets, then add supplementary files
         await this.promise;
-        await this.addMedia();
         await this._commitWorksheets();
+        await this.addMedia();
         await Promise.all([
             this.addContentTypes(),
             this.addApp(),
@@ -149,28 +149,39 @@ class WorkbookWriter {
         }
         return this._worksheets.length || 1;
     }
+    /**
+     * Add Image to Workbook and return the id
+     */
     addImage(image) {
         const id = this.media.length;
-        const medium = Object.assign({}, image, {
+        const medium = {
+            ...image,
             type: "image",
             name: `image${id}.${image.extension}`
-        });
+        };
         this.media.push(medium);
         return id;
     }
+    /**
+     * Get image by id
+     */
     getImage(id) {
         return this.media[id];
     }
-    addWorksheet(name, options = {}) {
+    /**
+     * Add a new worksheet and return a reference to it
+     */
+    addWorksheet(name, options) {
         // it's possible to add a worksheet with different than default
         // shared string handling
         // in fact, it's even possible to switch it mid-sheet
-        const useSharedStrings = options.useSharedStrings !== undefined ? options.useSharedStrings : this.useSharedStrings;
-        if (options.tabColor) {
+        const opts = options || {};
+        const useSharedStrings = opts.useSharedStrings !== undefined ? opts.useSharedStrings : this.useSharedStrings;
+        if (opts.tabColor) {
             console.trace("tabColor option has moved to { properties: tabColor: {...} }");
-            options.properties = Object.assign({
-                tabColor: options.tabColor
-            }, options.properties);
+            opts.properties = Object.assign({
+                tabColor: opts.tabColor
+            }, opts.properties);
         }
         const id = this.nextId;
         name = name || `sheet${id}`;
@@ -179,16 +190,19 @@ class WorkbookWriter {
             name,
             workbook: this,
             useSharedStrings,
-            properties: options.properties,
-            state: options.state,
-            pageSetup: options.pageSetup,
-            views: options.views,
-            autoFilter: options.autoFilter,
-            headerFooter: options.headerFooter
+            properties: opts.properties,
+            state: opts.state,
+            pageSetup: opts.pageSetup,
+            views: opts.views,
+            autoFilter: opts.autoFilter,
+            headerFooter: opts.headerFooter
         });
         this._worksheets[id] = worksheet;
         return worksheet;
     }
+    /**
+     * Fetch sheet by name or id
+     */
     getWorksheet(id) {
         if (id === undefined) {
             return this._worksheets.find(() => true);
@@ -197,7 +211,7 @@ class WorkbookWriter {
             return this._worksheets[id];
         }
         if (typeof id === "string") {
-            return this._worksheets.find((worksheet) => worksheet && worksheet.name === id);
+            return this._worksheets.find(worksheet => worksheet && worksheet.name === id);
         }
         return undefined;
     }
@@ -250,7 +264,7 @@ class WorkbookWriter {
                                 reject(err);
                             }
                             else {
-                                resolve(data);
+                                resolve(new Uint8Array(data));
                             }
                         });
                     });
@@ -259,13 +273,13 @@ class WorkbookWriter {
                 }
                 if (medium.buffer) {
                     this._addFile(medium.buffer, filename);
-                    return Promise.resolve();
+                    return;
                 }
                 if (medium.base64) {
                     const dataimg64 = medium.base64;
                     const content = dataimg64.substring(dataimg64.indexOf(",") + 1);
                     this._addFile(content, filename, true);
-                    return Promise.resolve();
+                    return;
                 }
             }
             throw new Error("Unsupported media");

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

@@ -25,7 +25,7 @@ class WorksheetReader extends EventEmitter {
     destroy() {
         throw new Error("Invalid Operation: destroy");
     }
-    // return the current dimensions of the writer
+    // return the current dimensions of the reader
     get dimensions() {
         return this._dimensions;
     }
@@ -44,7 +44,7 @@ class WorksheetReader extends EventEmitter {
             if (col) {
                 return col;
             }
-            // otherise, assume letter
+            // otherwise, assume letter
             c = colCache.l2n(c);
         }
         if (!this._columns) {
@@ -85,9 +85,9 @@ class WorksheetReader extends EventEmitter {
     }
     async *[Symbol.asyncIterator]() {
         for await (const events of this.parse()) {
-            for (const { eventType, value } of events) {
-                if (eventType === "row") {
-                    yield value;
+            for (const event of events) {
+                if (event.eventType === "row") {
+                    yield event.value;
                 }
             }
         }
@@ -283,6 +283,7 @@ class WorksheetReader extends EventEmitter {
                                                     cell.value = sharedStrings[index];
                                                 }
                                                 else {
+                                                    // Streaming format - unresolved shared string reference
                                                     cell.value = {
                                                         sharedString: index
                                                     };
@@ -299,19 +300,22 @@ class WorksheetReader extends EventEmitter {
                                             case "b":
                                                 cell.value = parseInt(c.v.text, 10) !== 0;
                                                 break;
-                                            default:
-                                                if (isDateFmt(cell.numFmt)) {
-                                                    cell.value = excelToDate(parseFloat(c.v.text), properties.model && properties.model.date1904);
+                                            default: {
+                                                const numFmtStr = typeof cell.numFmt === "string" ? cell.numFmt : cell.numFmt?.formatCode;
+                                                if (numFmtStr && isDateFmt(numFmtStr)) {
+                                                    cell.value = excelToDate(parseFloat(c.v.text), properties?.model?.date1904);
                                                 }
                                                 else {
                                                     cell.value = parseFloat(c.v.text);
                                                 }
                                                 break;
+                                            }
                                         }
                                     }
                                     if (hyperlinks) {
                                         const hyperlink = hyperlinks[c.ref];
                                         if (hyperlink) {
+                                            // Streaming-specific: assign text and hyperlink for further processing
                                             cell.text = cell.value;
                                             cell.value = undefined;
                                             cell.hyperlink = hyperlink;

package/dist/esm/stream/xlsx/worksheet-writer.js

@@ -275,20 +275,26 @@ class WorksheetWriter {
     }
     // iterate over every uncommitted row in the worksheet, including maybe empty rows
     eachRow(options, iteratee) {
-        if (!iteratee) {
-            iteratee = options;
-            options = undefined;
+        let callback;
+        let opts;
+        if (typeof options === "function") {
+            callback = options;
+            opts = undefined;
         }
-        if (options && options.includeEmpty) {
+        else {
+            callback = iteratee;
+            opts = options;
+        }
+        if (opts && opts.includeEmpty) {
             const n = this._nextRow;
             for (let i = this._rowZero; i < n; i++) {
-                iteratee(this.getRow(i), i);
+                callback(this.getRow(i), i);
             }
         }
         else {
             this._rows.forEach(row => {
                 if (row.hasValues) {
-                    iteratee(row, row.number);
+                    callback(row, row.number);
                 }
             });
         }

package/dist/types/doc/table.d.ts

@@ -67,8 +67,8 @@ declare class Table {
     set headerRow(value: boolean | undefined);
     get totalsRow(): boolean | undefined;
     set totalsRow(value: boolean | undefined);
-    get theme(): string | undefined;
-    set theme(value: string | undefined);
+    get theme(): TableStyleProperties["theme"];
+    set theme(value: TableStyleProperties["theme"]);
     get showFirstColumn(): boolean | undefined;
     set showFirstColumn(value: boolean | undefined);
     get showLastColumn(): boolean | undefined;

package/dist/types/index.d.ts

@@ -13,6 +13,9 @@ 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 type { WorkbookReaderOptions, ParseEvent, SharedStringEvent, WorksheetReadyEvent, HyperlinksEvent } from "./stream/xlsx/workbook-reader.js";
+export type { WorksheetReaderOptions, WorksheetEvent, RowEvent, HyperlinkEvent, WorksheetHyperlink } from "./stream/xlsx/worksheet-reader.js";
+export type { WorkbookWriterOptions, ZipOptions, ZlibOptions } from "./stream/xlsx/workbook-writer.js";
 export type { PivotTable, PivotTableModel, PivotTableSource, CacheField, DataField, PivotTableSubtotal, ParsedCacheDefinition, ParsedCacheRecords } from "./doc/pivot-table.js";
 export * from "./doc/enums.js";
 export * from "./types.js";

package/dist/types/stream/xlsx/hyperlink-reader.d.ts

@@ -1,24 +1,24 @@
 import { EventEmitter } from "events";
-interface HyperlinkReaderOptions {
-    workbook: any;
+import type { WorkbookReader, InternalWorksheetOptions } from "./workbook-reader.js";
+export interface HyperlinkReaderOptions {
+    workbook: WorkbookReader;
     id: number;
-    iterator: any;
-    options: any;
+    iterator: AsyncIterable<unknown>;
+    options: InternalWorksheetOptions;
 }
-interface Hyperlink {
+/** Hyperlink relationship parsed from worksheet rels */
+export interface Hyperlink {
     type: number;
     rId: string;
     target: string;
     targetMode: string;
 }
 declare class HyperlinkReader extends EventEmitter {
-    workbook: any;
+    workbook: WorkbookReader;
     id: number;
-    iterator: any;
-    options: any;
-    hyperlinks?: {
-        [key: string]: Hyperlink;
-    };
+    iterator: AsyncIterable<unknown>;
+    options: InternalWorksheetOptions;
+    hyperlinks?: Record<string, Hyperlink>;
     constructor({ workbook, id, iterator, options }: HyperlinkReaderOptions);
     get count(): number;
     each(fn: (hyperlink: Hyperlink, rId: string) => void): void;