@cj-tech-master/excelts 1.4.3 → 1.4.4

package/dist/cjs/xlsx/xform/sheet/row-xform.js

@@ -4,6 +4,7 @@ exports.RowXform = void 0;
 const base_xform_js_1 = require("../base-xform");
 const cell_xform_js_1 = require("./cell-xform");
 const utils_js_1 = require("../../../utils/utils");
+const col_cache_js_1 = require("../../../utils/col-cache");
 class RowXform extends base_xform_js_1.BaseXform {
     constructor(options) {
         super();
@@ -15,6 +16,11 @@ class RowXform extends base_xform_js_1.BaseXform {
     get tag() {
         return "row";
     }
+    reset() {
+        super.reset();
+        this.numRowsSeen = 0;
+        this.lastCellCol = 0;
+    }
     prepare(model, options) {
         const styleId = options.styles.addStyleModel(model.style);
         if (styleId) {
@@ -65,11 +71,15 @@ class RowXform extends base_xform_js_1.BaseXform {
         }
         if (node.name === "row") {
             this.numRowsSeen += 1;
+            // Reset lastCellCol for each new row
+            this.lastCellCol = 0;
             const spans = node.attributes.spans
                 ? node.attributes.spans.split(":").map((span) => parseInt(span, 10))
                 : [undefined, undefined];
+            // If r attribute is missing, use numRowsSeen as the row number
+            const rowNumber = node.attributes.r ? parseInt(node.attributes.r, 10) : this.numRowsSeen;
             const model = (this.model = {
-                number: parseInt(node.attributes.r, 10),
+                number: rowNumber,
                 min: spans[0],
                 max: spans[1],
                 cells: []
@@ -109,7 +119,19 @@ class RowXform extends base_xform_js_1.BaseXform {
     parseClose(name) {
         if (this.parser) {
             if (!this.parser.parseClose(name)) {
-                this.model.cells.push(this.parser.model);
+                const cellModel = this.parser.model;
+                // If cell has address, extract column number from it
+                // Otherwise, calculate address based on position
+                if (cellModel.address) {
+                    const decoded = col_cache_js_1.colCache.decodeAddress(cellModel.address);
+                    this.lastCellCol = decoded.col;
+                }
+                else {
+                    // No r attribute, calculate address from position
+                    this.lastCellCol += 1;
+                    cellModel.address = col_cache_js_1.colCache.encodeAddress(this.model.number, this.lastCellCol);
+                }
+                this.model.cells.push(cellModel);
                 if (this.maxItems && this.model.cells.length > this.maxItems) {
                     throw new Error(`Max column count (${this.maxItems}) exceeded`);
                 }

package/dist/cjs/xlsx/xform/table/filter-column-xform.js

@@ -57,6 +57,10 @@ class FilterColumnXform extends base_xform_js_1.BaseXform {
                     filterButton: attributes.hiddenButton === "0"
                 };
                 return true;
+            case "dynamicFilter":
+                // Ignore dynamicFilter nodes - we don't need to preserve them for reading
+                // See: https://github.com/exceljs/exceljs/issues/2972
+                return true;
             default:
                 this.parser = this.map[node.name];
                 if (this.parser) {

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

@@ -31,8 +31,9 @@ class WorkbookWriter {
         this.views = [];
         this.zipOptions = options.zip;
         // Extract compression level from zip options (supports both zlib.level and compressionOptions.level)
-        // Default compression level is 6 (good balance of speed and size)
-        const level = options.zip?.zlib?.level ?? options.zip?.compressionOptions?.level ?? 6;
+        // Default compression level is 1 (fast compression with good ratio)
+        // Level 1 is ~2x faster than level 6 with only ~7% larger files
+        const level = options.zip?.zlib?.level ?? options.zip?.compressionOptions?.level ?? 1;
         this.compressionLevel = Math.max(0, Math.min(9, level));
         this.media = [];
         this.commentRefs = [];

package/dist/esm/utils/unzip/extract.js

@@ -0,0 +1,160 @@
+/**
+ * Simple ZIP extraction utilities
+ * Provides easy-to-use Promise-based API for extracting ZIP files
+ */
+import { Readable } from "stream";
+import { createParse } from "./parse.js";
+/**
+ * Extract all files from a ZIP buffer
+ *
+ * @param zipData - ZIP file data as Buffer or Uint8Array
+ * @returns Map of file paths to their content
+ *
+ * @example
+ * ```ts
+ * import { extractAll } from "./utils/unzip/extract.js";
+ *
+ * const zipData = fs.readFileSync("archive.zip");
+ * const files = await extractAll(zipData);
+ *
+ * for (const [path, file] of files) {
+ *   console.log(`${path}: ${file.data.length} bytes`);
+ * }
+ * ```
+ */
+export async function extractAll(zipData) {
+    const files = new Map();
+    const buffer = Buffer.isBuffer(zipData) ? zipData : Buffer.from(zipData);
+    const parse = createParse({ forceStream: true });
+    const stream = Readable.from([buffer]);
+    stream.pipe(parse);
+    for await (const entry of parse) {
+        const zipEntry = entry;
+        const isDirectory = zipEntry.type === "Directory";
+        if (isDirectory) {
+            files.set(zipEntry.path, {
+                path: zipEntry.path,
+                data: Buffer.alloc(0),
+                isDirectory: true,
+                size: 0
+            });
+            zipEntry.autodrain();
+        }
+        else {
+            const data = await zipEntry.buffer();
+            files.set(zipEntry.path, {
+                path: zipEntry.path,
+                data,
+                isDirectory: false,
+                size: data.length
+            });
+        }
+    }
+    return files;
+}
+/**
+ * Extract a single file from a ZIP buffer
+ *
+ * @param zipData - ZIP file data as Buffer or Uint8Array
+ * @param filePath - Path of the file to extract
+ * @returns File content as Buffer, or null if not found
+ *
+ * @example
+ * ```ts
+ * import { extractFile } from "./utils/unzip/extract.js";
+ *
+ * const zipData = fs.readFileSync("archive.zip");
+ * const content = await extractFile(zipData, "readme.txt");
+ * if (content) {
+ *   console.log(content.toString("utf-8"));
+ * }
+ * ```
+ */
+export async function extractFile(zipData, filePath) {
+    const buffer = Buffer.isBuffer(zipData) ? zipData : Buffer.from(zipData);
+    const parse = createParse({ forceStream: true });
+    const stream = Readable.from([buffer]);
+    stream.pipe(parse);
+    for await (const entry of parse) {
+        const zipEntry = entry;
+        if (zipEntry.path === filePath) {
+            if (zipEntry.type === "Directory") {
+                return Buffer.alloc(0);
+            }
+            return zipEntry.buffer();
+        }
+        zipEntry.autodrain();
+    }
+    return null;
+}
+/**
+ * List all file paths in a ZIP buffer (without extracting content)
+ *
+ * @param zipData - ZIP file data as Buffer or Uint8Array
+ * @returns Array of file paths
+ *
+ * @example
+ * ```ts
+ * import { listFiles } from "./utils/unzip/extract.js";
+ *
+ * const zipData = fs.readFileSync("archive.zip");
+ * const paths = await listFiles(zipData);
+ * console.log(paths); // ["file1.txt", "folder/file2.txt", ...]
+ * ```
+ */
+export async function listFiles(zipData) {
+    const paths = [];
+    const buffer = Buffer.isBuffer(zipData) ? zipData : Buffer.from(zipData);
+    const parse = createParse({ forceStream: true });
+    const stream = Readable.from([buffer]);
+    stream.pipe(parse);
+    for await (const entry of parse) {
+        const zipEntry = entry;
+        paths.push(zipEntry.path);
+        zipEntry.autodrain();
+    }
+    return paths;
+}
+/**
+ * Iterate over ZIP entries with a callback (memory efficient for large ZIPs)
+ *
+ * @param zipData - ZIP file data as Buffer or Uint8Array
+ * @param callback - Async callback for each entry, return false to stop iteration
+ *
+ * @example
+ * ```ts
+ * import { forEachEntry } from "./utils/unzip/extract.js";
+ *
+ * await forEachEntry(zipData, async (path, getData) => {
+ *   if (path.endsWith(".xml")) {
+ *     const content = await getData();
+ *     console.log(content.toString("utf-8"));
+ *   }
+ *   return true; // continue iteration
+ * });
+ * ```
+ */
+export async function forEachEntry(zipData, callback) {
+    const buffer = Buffer.isBuffer(zipData) ? zipData : Buffer.from(zipData);
+    const parse = createParse({ forceStream: true });
+    const stream = Readable.from([buffer]);
+    stream.pipe(parse);
+    for await (const entry of parse) {
+        const zipEntry = entry;
+        let dataPromise = null;
+        const getData = () => {
+            if (!dataPromise) {
+                dataPromise = zipEntry.buffer();
+            }
+            return dataPromise;
+        };
+        const shouldContinue = await callback(zipEntry.path, getData, zipEntry);
+        // If callback didn't read data, drain it
+        if (!dataPromise) {
+            zipEntry.autodrain();
+        }
+        if (shouldContinue === false) {
+            break;
+        }
+    }
+}

package/dist/esm/utils/unzip/index.js

@@ -10,3 +10,5 @@ export { bufferStream } from "./buffer-stream.js";
 export { parse as parseBuffer } from "./parse-buffer.js";
 export { parseDateTime } from "./parse-datetime.js";
 export { parseExtraField } from "./parse-extra-field.js";
+// Simple extraction API
+export { extractAll, extractFile, listFiles, forEachEntry } from "./extract.js";

package/dist/esm/utils/xml-stream.js

@@ -4,6 +4,8 @@ const OPEN_ANGLE = "<";
 const CLOSE_ANGLE = ">";
 const OPEN_ANGLE_SLASH = "</";
 const CLOSE_SLASH_ANGLE = "/>";
+// Chunk size for periodic consolidation (reduces final join overhead)
+const CHUNK_SIZE = 10000;
 function pushAttribute(xml, name, value) {
     xml.push(` ${name}="${xmlEncode(value.toString())}"`);
 }
@@ -21,15 +23,23 @@ function pushAttributes(xml, attributes) {
 class XmlStream {
     constructor() {
         this._xml = [];
+        this._chunks = [];
         this._stack = [];
         this._rollbacks = [];
     }
+    _consolidate() {
+        // Periodically join small strings into larger chunks to reduce final join overhead
+        if (this._xml.length >= CHUNK_SIZE) {
+            this._chunks.push(this._xml.join(""));
+            this._xml = [];
+        }
+    }
     get tos() {
         return this._stack.length ? this._stack[this._stack.length - 1] : undefined;
     }
     get cursor() {
         // handy way to track whether anything has been added
-        return this._xml.length;
+        return this._chunks.length * CHUNK_SIZE + this._xml.length;
     }
     openXml(docAttributes) {
         const xml = this._xml;
@@ -96,6 +106,7 @@ class XmlStream {
         }
         this.open = false;
         this.leaf = false;
+        this._consolidate();
     }
     leafNode(name, attributes, text) {
         this.openNode(name, attributes);
@@ -115,7 +126,8 @@ class XmlStream {
             xml: this._xml.length,
             stack: this._stack.length,
             leaf: this.leaf,
-            open: this.open
+            open: this.open,
+            chunksLength: this._chunks.length
         });
         return this.cursor;
     }
@@ -130,12 +142,22 @@ class XmlStream {
         if (this._stack.length > r.stack) {
             this._stack.splice(r.stack, this._stack.length - r.stack);
         }
+        if (this._chunks.length > r.chunksLength) {
+            this._chunks.splice(r.chunksLength, this._chunks.length - r.chunksLength);
+        }
         this.leaf = r.leaf;
         this.open = r.open;
     }
     get xml() {
         this.closeAll();
-        return this._xml.join("");
+        // Join chunks first, then remaining xml array
+        if (this._chunks.length === 0) {
+            return this._xml.join("");
+        }
+        if (this._xml.length > 0) {
+            this._chunks.push(this._xml.join(""));
+        }
+        return this._chunks.join("");
     }
 }
 XmlStream.StdDocAttributes = {

package/dist/esm/utils/zip/compress.js

@@ -0,0 +1,220 @@
+/**
+ * Native compression utilities using platform APIs
+ *
+ * - Node.js: Uses native zlib module (C++ implementation, fastest)
+ * - Browser: Uses CompressionStream API (Chrome 80+, Firefox 113+, Safari 16.4+)
+ *
+ * Both use "deflate-raw" format which is required for ZIP files
+ * (raw DEFLATE without zlib header/trailer)
+ */
+// Detect environment
+const isNode = typeof process !== "undefined" && process.versions?.node;
+// Lazy-loaded zlib module for Node.js
+let _zlib = null;
+let _zlibLoading = null;
+// Auto-initialize zlib in Node.js environment
+if (isNode) {
+    _zlibLoading = import("zlib")
+        .then(module => {
+        _zlib = module.default ?? module;
+        return _zlib;
+    })
+        .catch(() => {
+        _zlib = null;
+        return null;
+    });
+}
+/**
+ * Get zlib module (Node.js only)
+ * Returns null if not yet loaded or not in Node.js
+ */
+function getZlib() {
+    return _zlib;
+}
+/**
+ * Ensure zlib is loaded (Node.js only)
+ * Call this before using sync methods if you need to guarantee availability
+ */
+export async function ensureZlib() {
+    if (_zlibLoading) {
+        return _zlibLoading;
+    }
+    return _zlib;
+}
+/**
+ * Check if native zlib is available (Node.js)
+ */
+export function hasNativeZlib() {
+    const zlib = getZlib();
+    return zlib !== null && typeof zlib.deflateRawSync === "function";
+}
+/**
+ * Check if CompressionStream is available (Browser/Node.js 17+)
+ */
+export function hasCompressionStream() {
+    return typeof CompressionStream !== "undefined";
+}
+/**
+ * Compress data using the best available native method
+ *
+ * Priority:
+ * 1. Node.js zlib (if available) - fastest, supports compression levels
+ * 2. CompressionStream (browser/Node.js 17+) - no level support
+ * 3. Return uncompressed data (fallback)
+ *
+ * @param data - Data to compress
+ * @param options - Compression options
+ * @returns Compressed data
+ *
+ * @example
+ * ```ts
+ * const data = new TextEncoder().encode("Hello, World!");
+ * const compressed = await compress(data, { level: 6 });
+ * ```
+ */
+export async function compress(data, options = {}) {
+    const level = options.level ?? 6;
+    // Level 0 means no compression
+    if (level === 0) {
+        return data;
+    }
+    // Ensure zlib is loaded first
+    const zlib = await ensureZlib();
+    // Try Node.js zlib first (fastest, supports levels)
+    if (zlib && typeof zlib.deflateRawSync === "function") {
+        const result = zlib.deflateRawSync(Buffer.from(data), { level });
+        return new Uint8Array(result.buffer, result.byteOffset, result.byteLength);
+    }
+    // Fall back to CompressionStream (browser/Node.js 17+)
+    if (typeof CompressionStream !== "undefined") {
+        return compressWithCompressionStream(data);
+    }
+    // No compression available - return original data
+    console.warn("No native compression available, returning uncompressed data");
+    return data;
+}
+/**
+ * Compress data synchronously using Node.js zlib
+ * Only available in Node.js environment
+ *
+ * @param data - Data to compress
+ * @param options - Compression options
+ * @returns Compressed data
+ * @throws Error if not in Node.js environment
+ */
+export function compressSync(data, options = {}) {
+    const level = options.level ?? 6;
+    if (level === 0) {
+        return data;
+    }
+    const zlib = getZlib();
+    if (!zlib || typeof zlib.deflateRawSync !== "function") {
+        throw new Error("Synchronous compression is only available in Node.js environment");
+    }
+    const result = zlib.deflateRawSync(Buffer.from(data), { level });
+    return new Uint8Array(result.buffer, result.byteOffset, result.byteLength);
+}
+/**
+ * Compress using browser's native CompressionStream
+ * Uses "deflate-raw" format (required for ZIP files)
+ *
+ * Note: CompressionStream does not support compression level configuration
+ *
+ * @param data - Data to compress
+ * @returns Compressed data
+ */
+async function compressWithCompressionStream(data) {
+    const cs = new CompressionStream("deflate-raw");
+    const writer = cs.writable.getWriter();
+    const reader = cs.readable.getReader();
+    // Write data and close
+    writer.write(new Uint8Array(data.buffer, data.byteOffset, data.byteLength));
+    writer.close();
+    // Read all compressed chunks
+    const chunks = [];
+    let totalLength = 0;
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done) {
+            break;
+        }
+        chunks.push(value);
+        totalLength += value.length;
+    }
+    // Combine chunks into single array
+    const result = new Uint8Array(totalLength);
+    let offset = 0;
+    for (const chunk of chunks) {
+        result.set(chunk, offset);
+        offset += chunk.length;
+    }
+    return result;
+}
+/**
+ * Decompress data using the best available native method
+ *
+ * @param data - Compressed data (deflate-raw format)
+ * @returns Decompressed data
+ */
+export async function decompress(data) {
+    // Ensure zlib is loaded first
+    const zlib = await ensureZlib();
+    // Try Node.js zlib first
+    if (zlib && typeof zlib.inflateRawSync === "function") {
+        const result = zlib.inflateRawSync(Buffer.from(data));
+        return new Uint8Array(result.buffer, result.byteOffset, result.byteLength);
+    }
+    // Fall back to DecompressionStream
+    if (typeof DecompressionStream !== "undefined") {
+        return decompressWithDecompressionStream(data);
+    }
+    throw new Error("No native decompression available");
+}
+/**
+ * Decompress data synchronously using Node.js zlib
+ *
+ * @param data - Compressed data (deflate-raw format)
+ * @returns Decompressed data
+ * @throws Error if not in Node.js environment
+ */
+export function decompressSync(data) {
+    const zlib = getZlib();
+    if (!zlib || typeof zlib.inflateRawSync !== "function") {
+        throw new Error("Synchronous decompression is only available in Node.js environment");
+    }
+    const result = zlib.inflateRawSync(Buffer.from(data));
+    return new Uint8Array(result.buffer, result.byteOffset, result.byteLength);
+}
+/**
+ * Decompress using browser's native DecompressionStream
+ *
+ * @param data - Compressed data (deflate-raw format)
+ * @returns Decompressed data
+ */
+async function decompressWithDecompressionStream(data) {
+    const ds = new DecompressionStream("deflate-raw");
+    const writer = ds.writable.getWriter();
+    const reader = ds.readable.getReader();
+    // Write data and close
+    writer.write(new Uint8Array(data.buffer, data.byteOffset, data.byteLength));
+    writer.close();
+    // Read all decompressed chunks
+    const chunks = [];
+    let totalLength = 0;
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done) {
+            break;
+        }
+        chunks.push(value);
+        totalLength += value.length;
+    }
+    // Combine chunks into single array
+    const result = new Uint8Array(totalLength);
+    let offset = 0;
+    for (const chunk of chunks) {
+        result.set(chunk, offset);
+        offset += chunk.length;
+    }
+    return result;
+}

package/dist/esm/utils/zip/crc32.js

@@ -0,0 +1,116 @@
+/**
+ * CRC32 calculation utility for ZIP files
+ *
+ * - Node.js: Uses native zlib.crc32 (C++ implementation, ~100x faster)
+ * - Browser: Uses lookup table optimization
+ *
+ * The polynomial used is the standard CRC-32 IEEE 802.3:
+ * x^32 + x^26 + x^23 + x^22 + x^16 + x^12 + x^11 + x^10 + x^8 + x^7 + x^5 + x^4 + x^2 + x + 1
+ * Represented as 0xEDB88320 in reversed (LSB-first) form
+ */
+// Detect Node.js environment
+const isNode = typeof process !== "undefined" && process.versions?.node;
+// Lazy-loaded zlib module for Node.js
+let _zlib = null;
+let _zlibLoading = null;
+// Auto-initialize zlib in Node.js environment
+if (isNode) {
+    _zlibLoading = import("zlib")
+        .then(module => {
+        _zlib = module.default ?? module;
+        return _zlib;
+    })
+        .catch(() => {
+        _zlib = null;
+        return null;
+    });
+}
+/**
+ * Pre-computed CRC32 lookup table (256 entries)
+ * Generated using the standard polynomial 0xEDB88320
+ * Used as fallback when native zlib is not available
+ */
+const CRC32_TABLE = /* @__PURE__ */ (() => {
+    const table = new Uint32Array(256);
+    for (let i = 0; i < 256; i++) {
+        let crc = i;
+        for (let j = 0; j < 8; j++) {
+            crc = crc & 1 ? 0xedb88320 ^ (crc >>> 1) : crc >>> 1;
+        }
+        table[i] = crc;
+    }
+    return table;
+})();
+/**
+ * JavaScript fallback CRC32 implementation using lookup table
+ */
+function crc32JS(data) {
+    let crc = 0xffffffff;
+    for (let i = 0; i < data.length; i++) {
+        crc = CRC32_TABLE[(crc ^ data[i]) & 0xff] ^ (crc >>> 8);
+    }
+    return (crc ^ 0xffffffff) >>> 0;
+}
+/**
+ * Calculate CRC32 checksum for the given data
+ * Uses native zlib.crc32 in Node.js for ~100x better performance
+ *
+ * @param data - Input data as Uint8Array or Buffer
+ * @returns CRC32 checksum as unsigned 32-bit integer
+ *
+ * @example
+ * ```ts
+ * const data = new TextEncoder().encode("Hello, World!");
+ * const checksum = crc32(data);
+ * console.log(checksum.toString(16)); // "ec4ac3d0"
+ * ```
+ */
+export function crc32(data) {
+    // Use native zlib.crc32 if available (Node.js)
+    if (_zlib && typeof _zlib.crc32 === "function") {
+        return _zlib.crc32(data) >>> 0;
+    }
+    // Fallback to JS implementation
+    return crc32JS(data);
+}
+/**
+ * Ensure zlib is loaded (for use before calling crc32)
+ */
+export async function ensureCrc32() {
+    if (_zlibLoading) {
+        await _zlibLoading;
+    }
+}
+/**
+ * Calculate CRC32 incrementally (useful for streaming)
+ * Call with initial crc of 0xffffffff, then finalize with crc32Finalize
+ * Note: This always uses JS implementation for consistency in streaming
+ *
+ * @param crc - Current CRC value (start with 0xffffffff)
+ * @param data - Input data chunk
+ * @returns Updated CRC value (not finalized)
+ *
+ * @example
+ * ```ts
+ * let crc = 0xffffffff;
+ * crc = crc32Update(crc, chunk1);
+ * crc = crc32Update(crc, chunk2);
+ * const checksum = crc32Finalize(crc);
+ * ```
+ */
+export function crc32Update(crc, data) {
+    for (let i = 0; i < data.length; i++) {
+        crc = CRC32_TABLE[(crc ^ data[i]) & 0xff] ^ (crc >>> 8);
+    }
+    return crc;
+}
+/**
+ * Finalize CRC32 calculation
+ * XOR with 0xffffffff and convert to unsigned 32-bit
+ *
+ * @param crc - CRC value from crc32Update
+ * @returns Final CRC32 checksum
+ */
+export function crc32Finalize(crc) {
+    return (crc ^ 0xffffffff) >>> 0;
+}