@cj-tech-master/excelts 1.6.3 → 2.0.0

package/dist/esm/utils/zip/streaming-zip.js

@@ -0,0 +1,259 @@
+/**
+ * Streaming ZIP creator - fflate-compatible API
+ *
+ * This module provides a streaming ZIP API compatible with fflate's Zip/ZipDeflate,
+ * but uses native zlib compression for better performance.
+ *
+ * Usage:
+ * ```ts
+ * const zip = new StreamingZip((err, data, final) => {
+ *   if (err) handleError(err);
+ *   else {
+ *     stream.write(data);
+ *     if (final) stream.end();
+ *   }
+ * });
+ *
+ * const file = new ZipDeflateFile("path/file.txt", { level: 6 });
+ * zip.add(file);
+ * file.push(data1);
+ * file.push(data2, true); // true = final chunk
+ *
+ * zip.end();
+ * ```
+ */
+import { crc32 } from "./crc32.js";
+import { compressSync } from "./compress.js";
+// ZIP signature constants
+const LOCAL_FILE_HEADER_SIG = 0x04034b50;
+const CENTRAL_DIR_HEADER_SIG = 0x02014b50;
+const END_OF_CENTRAL_DIR_SIG = 0x06054b50;
+// ZIP version constants
+const VERSION_NEEDED = 20; // 2.0 - supports DEFLATE
+const VERSION_MADE_BY = 20; // 2.0
+// Compression methods
+const COMPRESSION_STORE = 0;
+const COMPRESSION_DEFLATE = 8;
+const encoder = new TextEncoder();
+/**
+ * Convert Date to DOS time format
+ */
+function dateToDos(date) {
+    const dosTime = ((date.getHours() & 0x1f) << 11) |
+        ((date.getMinutes() & 0x3f) << 5) |
+        ((date.getSeconds() >> 1) & 0x1f);
+    const dosDate = (((date.getFullYear() - 1980) & 0x7f) << 9) |
+        (((date.getMonth() + 1) & 0x0f) << 5) |
+        (date.getDate() & 0x1f);
+    return [dosTime, dosDate];
+}
+/**
+ * ZipDeflate-compatible file stream
+ * Collects data chunks, compresses on finalization
+ */
+export class ZipDeflateFile {
+    constructor(name, options) {
+        this.chunks = [];
+        this.totalSize = 0;
+        this.finalized = false;
+        this._ondata = null;
+        this.name = name;
+        this.level = options?.level ?? 6;
+    }
+    /**
+     * Set data callback (called by StreamingZip)
+     */
+    set ondata(cb) {
+        this._ondata = cb;
+    }
+    /**
+     * Push data to the file
+     * @param data - Data chunk
+     * @param final - Whether this is the final chunk
+     */
+    push(data, final = false) {
+        if (this.finalized) {
+            throw new Error("Cannot push to finalized ZipDeflateFile");
+        }
+        if (data.length > 0) {
+            this.chunks.push(data);
+            this.totalSize += data.length;
+        }
+        if (final) {
+            this.finalized = true;
+            this._flush();
+        }
+    }
+    /**
+     * Flush collected data through compression and emit
+     */
+    _flush() {
+        if (!this._ondata) {
+            return;
+        }
+        // Combine chunks
+        let uncompressed;
+        if (this.chunks.length === 0) {
+            uncompressed = new Uint8Array(0);
+        }
+        else if (this.chunks.length === 1) {
+            uncompressed = this.chunks[0];
+        }
+        else {
+            uncompressed = new Uint8Array(this.totalSize);
+            let offset = 0;
+            for (const chunk of this.chunks) {
+                uncompressed.set(chunk, offset);
+                offset += chunk.length;
+            }
+        }
+        // Compress if level > 0 and data is not empty
+        const shouldCompress = this.level > 0 && uncompressed.length > 0;
+        const compressed = shouldCompress
+            ? compressSync(uncompressed, { level: this.level })
+            : uncompressed;
+        // Build local file header + data
+        const nameBytes = encoder.encode(this.name);
+        const crcValue = crc32(uncompressed);
+        const [dosTime, dosDate] = dateToDos(new Date());
+        // Local file header (30 bytes + filename)
+        const header = new Uint8Array(30 + nameBytes.length);
+        const view = new DataView(header.buffer);
+        view.setUint32(0, LOCAL_FILE_HEADER_SIG, true);
+        view.setUint16(4, VERSION_NEEDED, true);
+        view.setUint16(6, 0x0800, true); // UTF-8 flag
+        view.setUint16(8, shouldCompress ? COMPRESSION_DEFLATE : COMPRESSION_STORE, true);
+        view.setUint16(10, dosTime, true);
+        view.setUint16(12, dosDate, true);
+        view.setUint32(14, crcValue, true);
+        view.setUint32(18, compressed.length, true);
+        view.setUint32(22, uncompressed.length, true);
+        view.setUint16(26, nameBytes.length, true);
+        view.setUint16(28, 0, true); // Extra field length
+        header.set(nameBytes, 30);
+        // Store info for central directory BEFORE emitting data
+        // (StreamingZip reads this in the final callback)
+        this._entryInfo = {
+            name: nameBytes,
+            crc: crcValue,
+            compressedSize: compressed.length,
+            uncompressedSize: uncompressed.length,
+            compressionMethod: shouldCompress ? COMPRESSION_DEFLATE : COMPRESSION_STORE,
+            dosTime,
+            dosDate,
+            offset: -1 // Will be set by StreamingZip
+        };
+        // Emit header
+        this._ondata(header, false);
+        // Emit compressed data (final chunk)
+        this._ondata(compressed, true);
+        // Clear chunks for GC
+        this.chunks.length = 0;
+    }
+    /**
+     * Get entry info (called by StreamingZip after finalization)
+     */
+    getEntryInfo() {
+        return this._entryInfo || null;
+    }
+}
+/**
+ * Streaming ZIP - fflate Zip-compatible API
+ * Creates ZIP files in a streaming manner
+ */
+export class StreamingZip {
+    /**
+     * Create a streaming ZIP
+     * @param callback - Called with (err, data, final) as data becomes available
+     */
+    constructor(callback) {
+        this.entries = [];
+        this.currentOffset = 0;
+        this.ended = false;
+        this.callback = callback;
+    }
+    /**
+     * Add a file to the ZIP
+     * @param file - ZipDeflateFile instance
+     */
+    add(file) {
+        if (this.ended) {
+            throw new Error("Cannot add files after calling end()");
+        }
+        // Capture offset when first data is written, not when add() is called
+        // This is important because streaming files may have data pushed later
+        let startOffset = -1;
+        file.ondata = (data, final) => {
+            // Capture offset on first data chunk
+            if (startOffset === -1) {
+                startOffset = this.currentOffset;
+            }
+            this.currentOffset += data.length;
+            this.callback(null, data, false);
+            if (final) {
+                // Get entry info and set offset
+                const entryInfo = file.getEntryInfo();
+                if (entryInfo) {
+                    entryInfo.offset = startOffset;
+                    this.entries.push(entryInfo);
+                }
+            }
+        };
+    }
+    /**
+     * Finalize the ZIP
+     * Writes central directory and end-of-central-directory record
+     */
+    end() {
+        if (this.ended) {
+            return;
+        }
+        this.ended = true;
+        const centralDirOffset = this.currentOffset;
+        const centralDirChunks = [];
+        // Build central directory headers
+        for (const entry of this.entries) {
+            const header = new Uint8Array(46 + entry.name.length);
+            const view = new DataView(header.buffer);
+            view.setUint32(0, CENTRAL_DIR_HEADER_SIG, true);
+            view.setUint16(4, VERSION_MADE_BY, true);
+            view.setUint16(6, VERSION_NEEDED, true);
+            view.setUint16(8, 0x0800, true); // UTF-8 flag
+            view.setUint16(10, entry.compressionMethod, true);
+            view.setUint16(12, entry.dosTime, true);
+            view.setUint16(14, entry.dosDate, true);
+            view.setUint32(16, entry.crc, true);
+            view.setUint32(20, entry.compressedSize, true);
+            view.setUint32(24, entry.uncompressedSize, true);
+            view.setUint16(28, entry.name.length, true);
+            view.setUint16(30, 0, true); // Extra field length
+            view.setUint16(32, 0, true); // Comment length
+            view.setUint16(34, 0, true); // Disk number start
+            view.setUint16(36, 0, true); // Internal file attributes
+            view.setUint32(38, 0, true); // External file attributes
+            view.setUint32(42, entry.offset, true);
+            header.set(entry.name, 46);
+            centralDirChunks.push(header);
+        }
+        // Emit central directory
+        for (const chunk of centralDirChunks) {
+            this.callback(null, chunk, false);
+        }
+        const centralDirSize = centralDirChunks.reduce((sum, c) => sum + c.length, 0);
+        // Build end of central directory
+        const eocd = new Uint8Array(22);
+        const eocdView = new DataView(eocd.buffer);
+        eocdView.setUint32(0, END_OF_CENTRAL_DIR_SIG, true);
+        eocdView.setUint16(4, 0, true); // Disk number
+        eocdView.setUint16(6, 0, true); // Disk with central dir
+        eocdView.setUint16(8, this.entries.length, true);
+        eocdView.setUint16(10, this.entries.length, true);
+        eocdView.setUint32(12, centralDirSize, true);
+        eocdView.setUint32(16, centralDirOffset, true);
+        eocdView.setUint16(20, 0, true); // Comment length
+        // Emit end of central directory (final chunk)
+        this.callback(null, eocd, true);
+    }
+}
+// Export aliases for fflate compatibility
+export { StreamingZip as Zip, ZipDeflateFile as ZipDeflate };

package/dist/esm/utils/zip-stream.browser.js

@@ -0,0 +1,132 @@
+import { ZipBuilder } from "./zip/zip-builder.js";
+import { StreamBuf } from "./stream-buf.browser.js";
+// Helper function for base64 decoding in browser
+function base64ToUint8Array(base64) {
+    const binaryString = atob(base64);
+    const bytes = new Uint8Array(binaryString.length);
+    for (let i = 0; i < binaryString.length; i++) {
+        bytes[i] = binaryString.charCodeAt(i);
+    }
+    return bytes;
+}
+// =============================================================================
+// The ZipWriter class - Browser version without Node.js events dependency
+// Packs streamed data into an output zip stream
+class ZipWriter {
+    constructor(options) {
+        this.finalized = false;
+        this.pendingWrites = [];
+        this.events = new Map();
+        const level = options?.compression === "STORE"
+            ? 0
+            : Math.max(0, Math.min(9, options?.compressionOptions?.level ?? 1));
+        this.stream = new StreamBuf();
+        this.zipBuilder = new ZipBuilder({ level });
+    }
+    // Event emitter methods
+    on(event, callback) {
+        const callbacks = this.events.get(event) || [];
+        callbacks.push(callback);
+        this.events.set(event, callbacks);
+        return this;
+    }
+    once(event, callback) {
+        const onceCallback = (...args) => {
+            this.off(event, onceCallback);
+            callback(...args);
+        };
+        return this.on(event, onceCallback);
+    }
+    off(event, callback) {
+        const callbacks = this.events.get(event) || [];
+        const index = callbacks.indexOf(callback);
+        if (index !== -1) {
+            callbacks.splice(index, 1);
+        }
+        return this;
+    }
+    emit(event, ...args) {
+        const callbacks = this.events.get(event) || [];
+        callbacks.forEach(cb => cb(...args));
+        return callbacks.length > 0;
+    }
+    removeListener(event, callback) {
+        return this.off(event, callback);
+    }
+    append(data, options) {
+        let buffer;
+        if (Object.prototype.hasOwnProperty.call(options, "base64") && options.base64) {
+            const base64Data = typeof data === "string" ? data : String(data);
+            buffer = base64ToUint8Array(base64Data);
+        }
+        else if (typeof data === "string") {
+            buffer = new TextEncoder().encode(data);
+        }
+        else if (data instanceof Uint8Array) {
+            buffer = data;
+        }
+        else if (ArrayBuffer.isView(data)) {
+            buffer = new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+        }
+        else if (data instanceof ArrayBuffer) {
+            buffer = new Uint8Array(data);
+        }
+        else {
+            buffer = data;
+        }
+        const writePromise = this.zipBuilder
+            .addFile({ name: options.name, data: buffer })
+            .then(chunks => {
+            for (const chunk of chunks) {
+                this.stream.write(new Uint8Array(chunk));
+            }
+        });
+        this.pendingWrites.push(writePromise);
+    }
+    push(chunk) {
+        return this.stream.push(chunk);
+    }
+    async finalize() {
+        if (this.finalized) {
+            return;
+        }
+        this.finalized = true;
+        await Promise.all(this.pendingWrites);
+        const finalChunks = this.zipBuilder.finalize();
+        for (const chunk of finalChunks) {
+            this.stream.write(new Uint8Array(chunk));
+        }
+        this.stream.end();
+        this.emit("finish");
+    }
+    // ==========================================================================
+    // Stream.Readable interface
+    read(size) {
+        return this.stream.read(size);
+    }
+    setEncoding(encoding) {
+        return this.stream.setEncoding(encoding);
+    }
+    pause() {
+        return this.stream.pause();
+    }
+    resume() {
+        return this.stream.resume();
+    }
+    isPaused() {
+        return this.stream.isPaused();
+    }
+    pipe(destination) {
+        return this.stream.pipe(destination);
+    }
+    unpipe(destination) {
+        return this.stream.unpipe(destination);
+    }
+    unshift() {
+        return this.stream.unshift();
+    }
+    wrap() {
+        return this.stream.wrap();
+    }
+}
+export { ZipWriter };

package/dist/esm/xlsx/xform/pivot-table/pivot-table-xform.js

@@ -1,4 +1,3 @@
-import { v4 as uuidv4 } from "uuid";
 import { XmlStream } from "../../../utils/xml-stream.js";
 import { xmlEncode, xmlDecode } from "../../../utils/utils.js";
 import { BaseXform } from "../base-xform.js";
@@ -57,7 +56,7 @@ class PivotTableXform extends BaseXform {
     renderNew(xmlStream, model) {
         const { rows, columns, values, cacheFields, cacheId, applyWidthHeightFormats } = model;
         // Generate unique UID for each pivot table to prevent Excel treating them as identical
-        const uniqueUid = `{${uuidv4().toUpperCase()}}`;
+        const uniqueUid = `{${crypto.randomUUID().toUpperCase()}}`;
         xmlStream.openXml(XmlStream.StdDocAttributes);
         xmlStream.openNode(this.tag, {
             ...PivotTableXform.PIVOT_TABLE_ATTRIBUTES,
@@ -138,7 +137,7 @@ class PivotTableXform extends BaseXform {
      * Render loaded pivot table (preserving original structure)
      */
     renderLoaded(xmlStream, model) {
-        const uniqueUid = model.uid || `{${uuidv4().toUpperCase()}}`;
+        const uniqueUid = model.uid || `{${crypto.randomUUID().toUpperCase()}}`;
         xmlStream.openXml(XmlStream.StdDocAttributes);
         xmlStream.openNode(this.tag, {
             ...PivotTableXform.PIVOT_TABLE_ATTRIBUTES,

package/dist/esm/xlsx/xform/sheet/cf-ext/cf-rule-ext-xform.js

@@ -1,4 +1,3 @@
-import { v4 } from "uuid";
 import { BaseXform } from "../../base-xform.js";
 import { CompositeXform } from "../../composite-xform.js";
 import { DatabarExtXform } from "./databar-ext-xform.js";
@@ -33,7 +32,7 @@ class CfRuleExtXform extends CompositeXform {
     }
     prepare(model) {
         if (CfRuleExtXform.isExt(model)) {
-            model.x14Id = `{${v4()}}`.toUpperCase();
+            model.x14Id = `{${crypto.randomUUID()}}`.toUpperCase();
         }
     }
     render(xmlStream, model) {
@@ -61,7 +60,7 @@ class CfRuleExtXform extends CompositeXform {
         xmlStream.openNode(this.tag, {
             type: "iconSet",
             priority: model.priority,
-            id: model.x14Id || `{${v4()}}`
+            id: model.x14Id || `{${crypto.randomUUID()}}`
         });
         this.iconSetXform.render(xmlStream, model);
         xmlStream.closeNode();

package/dist/esm/xlsx/xform/sheet/col-breaks-xform.js

@@ -0,0 +1,35 @@
+import { PageBreaksXform } from "./page-breaks-xform.js";
+import { ListXform } from "../list-xform.js";
+/**
+ * Xform for column page breaks (colBreaks element in worksheet XML)
+ * Used to define manual page breaks between columns when printing.
+ *
+ * XML structure:
+ * <colBreaks count="3" manualBreakCount="3">
+ *   <brk id="3" max="1048575" man="1"/>
+ *   <brk id="6" max="1048575" man="1"/>
+ * </colBreaks>
+ */
+class ColBreaksXform extends ListXform {
+    constructor() {
+        super({
+            tag: "colBreaks",
+            count: true,
+            childXform: new PageBreaksXform()
+        });
+    }
+    // Override to add manualBreakCount attribute required by Excel
+    render(xmlStream, model) {
+        if (model && model.length) {
+            xmlStream.openNode(this.tag, this.$);
+            xmlStream.addAttribute(this.$count, model.length);
+            xmlStream.addAttribute("manualBreakCount", model.length);
+            const { childXform } = this;
+            for (const childModel of model) {
+                childXform.render(xmlStream, childModel);
+            }
+            xmlStream.closeNode();
+        }
+    }
+}
+export { ColBreaksXform };

package/dist/esm/xlsx/xform/sheet/page-breaks-xform.js

@@ -1,4 +1,8 @@
 import { BaseXform } from "../base-xform.js";
+/**
+ * Xform for individual page break (brk element)
+ * Used by both RowBreaksXform and ColBreaksXform
+ */
 class PageBreaksXform extends BaseXform {
     get tag() {
         return "brk";
@@ -8,7 +12,15 @@ class PageBreaksXform extends BaseXform {
     }
     parseOpen(node) {
         if (node.name === "brk") {
-            this.model = node.attributes.ref;
+            const { id, max, man, min } = node.attributes;
+            this.model = {
+                id: +id,
+                max: +max,
+                man: +man
+            };
+            if (min !== undefined) {
+                this.model.min = +min;
+            }
             return true;
         }
         return false;

package/dist/esm/xlsx/xform/sheet/row-breaks-xform.js

@@ -1,31 +1,29 @@
 import { PageBreaksXform } from "./page-breaks-xform.js";
 import { ListXform } from "../list-xform.js";
+/**
+ * Xform for row page breaks (rowBreaks element in worksheet XML)
+ * Used to define manual page breaks between rows when printing.
+ */
 class RowBreaksXform extends ListXform {
     constructor() {
-        const options = {
+        super({
             tag: "rowBreaks",
             count: true,
             childXform: new PageBreaksXform()
-        };
-        super(options);
+        });
     }
-    // get tag() { return 'rowBreaks'; }
+    // Override to add manualBreakCount attribute required by Excel
     render(xmlStream, model) {
         if (model && model.length) {
             xmlStream.openNode(this.tag, this.$);
-            if (this.count) {
-                xmlStream.addAttribute(this.$count, model.length);
-                xmlStream.addAttribute("manualBreakCount", model.length);
-            }
+            xmlStream.addAttribute(this.$count, model.length);
+            xmlStream.addAttribute("manualBreakCount", model.length);
             const { childXform } = this;
-            model.forEach((childModel) => {
+            for (const childModel of model) {
                 childXform.render(xmlStream, childModel);
-            });
+            }
             xmlStream.closeNode();
         }
-        else if (this.empty) {
-            xmlStream.leafNode(this.tag);
-        }
     }
 }
 export { RowBreaksXform };

package/dist/esm/xlsx/xform/sheet/worksheet-xform.js

@@ -22,6 +22,7 @@ import { PictureXform } from "./picture-xform.js";
 import { DrawingXform } from "./drawing-xform.js";
 import { TablePartXform } from "./table-part-xform.js";
 import { RowBreaksXform } from "./row-breaks-xform.js";
+import { ColBreaksXform } from "./col-breaks-xform.js";
 import { HeaderFooterXform } from "./header-footer-xform.js";
 import { ConditionalFormattingsXform } from "./cf/conditional-formattings-xform.js";
 import { ExtLstXform } from "./ext-lst-xform.js";
@@ -108,6 +109,7 @@ class WorkSheetXform extends BaseXform {
                 childXform: new MergeCellXform()
             }),
             rowBreaks: new RowBreaksXform(),
+            colBreaks: new ColBreaksXform(),
             hyperlinks: new ListXform({
                 tag: "hyperlinks",
                 count: false,
@@ -324,7 +326,8 @@ class WorkSheetXform extends BaseXform {
         this.map.pageSetup.render(xmlStream, model.pageSetup);
         this.map.headerFooter.render(xmlStream, model.headerFooter);
         this.map.rowBreaks.render(xmlStream, model.rowBreaks);
-        this.map.drawing.render(xmlStream, model.drawing); // Note: must be after rowBreaks
+        this.map.colBreaks.render(xmlStream, model.colBreaks);
+        this.map.drawing.render(xmlStream, model.drawing); // Note: must be after rowBreaks/colBreaks
         this.map.picture.render(xmlStream, model.background); // Note: must be after drawing
         this.map.tableParts.render(xmlStream, model.tables);
         this.map.extLst.render(xmlStream, model);
@@ -399,7 +402,9 @@ class WorkSheetXform extends BaseXform {
                     background: this.map.picture.model,
                     drawing: this.map.drawing.model,
                     tables: this.map.tableParts.model,
-                    conditionalFormattings
+                    conditionalFormattings,
+                    rowBreaks: this.map.rowBreaks.model || [],
+                    colBreaks: this.map.colBreaks.model || []
                 };
                 if (this.map.autoFilter.model) {
                     this.model.autoFilter = this.map.autoFilter.model;