@cj-tech-master/excelts 4.2.1 → 4.2.2-canary.20260115044841.88820eb

package/dist/cjs/modules/archive/zip/zip-bytes.js

@@ -0,0 +1,242 @@
+"use strict";
+/**
+ * ZIP file format encoder (single-buffer output)
+ *
+ * Implements ZIP file structure according to PKWARE's APPNOTE.TXT specification
+ * https://pkware.cachefly.net/webdocs/casestudies/APPNOTE.TXT
+ *
+ * This module focuses on producing a complete ZIP as a single Uint8Array.
+ * For true streaming (push chunks while reading sources), use `zip()` / `ZipArchive.stream()`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createZip = createZip;
+exports.createZipSync = createZipSync;
+const compress_1 = require("../compression/compress.js");
+const crc32_1 = require("../compression/crc32.js");
+const defaults_1 = require("../defaults.js");
+const compressibility_1 = require("../utils/compressibility.js");
+const text_1 = require("../utils/text.js");
+const zip_entry_metadata_1 = require("./zip-entry-metadata.js");
+const zip_records_1 = require("../zip-spec/zip-records.js");
+const REPRODUCIBLE_ZIP_MOD_TIME = new Date(1980, 0, 1, 0, 0, 0);
+function encodeZipComment(comment) {
+    // Keep empty comment as empty bytes (no encoding surprises).
+    return comment ? (0, text_1.encodeUtf8)(comment) : new Uint8Array(0);
+}
+function shouldDeflate(level, data) {
+    return level > 0 && data.length > 0;
+}
+async function compressEntryMaybe(entry, level, compressOptions, smartStore) {
+    if (!shouldDeflate(level, entry.data)) {
+        return { compressedData: entry.data, deflate: false };
+    }
+    if (!smartStore) {
+        const compressed = await (0, compress_1.compress)(entry.data, compressOptions);
+        return { compressedData: compressed, deflate: true };
+    }
+    // Heuristic: skip deflate for high-entropy inputs.
+    if ((0, compressibility_1.isProbablyIncompressible)(entry.data)) {
+        return { compressedData: entry.data, deflate: false };
+    }
+    const compressed = await (0, compress_1.compress)(entry.data, compressOptions);
+    if (compressed.length >= entry.data.length) {
+        return { compressedData: entry.data, deflate: false };
+    }
+    return { compressedData: compressed, deflate: true };
+}
+function compressEntryMaybeSync(entry, level, compressOptions, smartStore) {
+    if (!shouldDeflate(level, entry.data)) {
+        return { compressedData: entry.data, deflate: false };
+    }
+    if (!smartStore) {
+        const compressed = (0, compress_1.compressSync)(entry.data, compressOptions);
+        return { compressedData: compressed, deflate: true };
+    }
+    if ((0, compressibility_1.isProbablyIncompressible)(entry.data)) {
+        return { compressedData: entry.data, deflate: false };
+    }
+    const compressed = (0, compress_1.compressSync)(entry.data, compressOptions);
+    if (compressed.length >= entry.data.length) {
+        return { compressedData: entry.data, deflate: false };
+    }
+    return { compressedData: compressed, deflate: true };
+}
+function computeLocalRecordSize(entry) {
+    return (zip_records_1.ZIP_LOCAL_FILE_HEADER_FIXED_SIZE +
+        entry.name.length +
+        entry.extraField.length +
+        entry.compressedData.length);
+}
+function computeCentralDirHeaderSize(entry) {
+    return (zip_records_1.ZIP_CENTRAL_DIR_HEADER_FIXED_SIZE +
+        entry.name.length +
+        entry.extraField.length +
+        entry.comment.length);
+}
+function buildProcessedEntry(entry, offset, settings, compressedData, deflate) {
+    const modDate = entry.modTime ?? settings.defaultModTime;
+    const metadata = (0, zip_entry_metadata_1.buildZipEntryMetadata)({
+        name: entry.name,
+        comment: entry.comment,
+        modTime: modDate,
+        timestamps: settings.timestamps,
+        useDataDescriptor: false,
+        deflate
+    });
+    return {
+        name: metadata.nameBytes,
+        uncompressedSize: entry.data.length,
+        compressedData,
+        crc: (0, crc32_1.crc32)(entry.data),
+        compressionMethod: (0, zip_entry_metadata_1.resolveZipCompressionMethod)(deflate),
+        modTime: metadata.dosTime,
+        modDate: metadata.dosDate,
+        extraField: metadata.extraField,
+        comment: metadata.commentBytes,
+        offset
+    };
+}
+function appendProcessedEntry(processedEntries, entry, compressedData, deflate, currentOffset, settings) {
+    const processedEntry = buildProcessedEntry(entry, currentOffset, settings, compressedData, deflate);
+    processedEntries.push(processedEntry);
+    return {
+        processedEntry,
+        nextOffset: currentOffset + computeLocalRecordSize(processedEntry)
+    };
+}
+function finalizeZip(processedEntries, zipComment) {
+    // Assemble ZIP into a single buffer to reduce allocations and copying.
+    let localSectionSize = 0;
+    let centralDirSize = 0;
+    for (const entry of processedEntries) {
+        localSectionSize += computeLocalRecordSize(entry);
+        centralDirSize += computeCentralDirHeaderSize(entry);
+    }
+    // The central directory should start immediately after local section.
+    const centralDirOffset = localSectionSize;
+    const totalSize = localSectionSize + centralDirSize + zip_records_1.ZIP_END_OF_CENTRAL_DIR_FIXED_SIZE + zipComment.length;
+    const out = new Uint8Array(totalSize);
+    const view = new DataView(out.buffer, out.byteOffset, out.byteLength);
+    let offset = 0;
+    // Local file headers and data
+    for (const entry of processedEntries) {
+        offset += (0, zip_records_1.writeLocalFileHeaderInto)(out, view, offset, {
+            fileName: entry.name,
+            extraField: entry.extraField,
+            flags: zip_records_1.FLAG_UTF8,
+            compressionMethod: entry.compressionMethod,
+            dosTime: entry.modTime,
+            dosDate: entry.modDate,
+            crc32: entry.crc,
+            compressedSize: entry.compressedData.length,
+            uncompressedSize: entry.uncompressedSize
+        });
+        out.set(entry.compressedData, offset);
+        offset += entry.compressedData.length;
+    }
+    // Central directory headers
+    for (const entry of processedEntries) {
+        offset += (0, zip_records_1.writeCentralDirectoryHeaderInto)(out, view, offset, {
+            fileName: entry.name,
+            extraField: entry.extraField,
+            comment: entry.comment,
+            flags: zip_records_1.FLAG_UTF8,
+            compressionMethod: entry.compressionMethod,
+            dosTime: entry.modTime,
+            dosDate: entry.modDate,
+            crc32: entry.crc,
+            compressedSize: entry.compressedData.length,
+            uncompressedSize: entry.uncompressedSize,
+            localHeaderOffset: entry.offset
+        });
+    }
+    // End of central directory
+    (0, zip_records_1.writeEndOfCentralDirectoryInto)(out, view, offset, {
+        entryCount: processedEntries.length,
+        centralDirSize,
+        centralDirOffset,
+        comment: zipComment
+    });
+    return out;
+}
+/**
+ * Create a ZIP file from entries (async)
+ */
+async function createZip(entries, options = {}) {
+    const reproducible = options.reproducible ?? false;
+    const level = options.level ?? defaults_1.DEFAULT_ZIP_LEVEL;
+    const smartStore = options.smartStore ?? true;
+    const concurrency = options.concurrency ?? 4;
+    const timestamps = options.timestamps ?? (reproducible ? "dos" : defaults_1.DEFAULT_ZIP_TIMESTAMPS);
+    const zipComment = encodeZipComment(options.comment);
+    const defaultModTime = options.modTime ?? (reproducible ? REPRODUCIBLE_ZIP_MOD_TIME : new Date());
+    const settings = {
+        level,
+        timestamps,
+        defaultModTime
+    };
+    const thresholdBytes = options.thresholdBytes;
+    const limit = Math.max(1, Math.floor(concurrency));
+    const processedEntries = new Array(entries.length);
+    if (entries.length > 0) {
+        let nextIndex = 0;
+        const workerCount = Math.min(limit, entries.length);
+        const workers = Array.from({ length: workerCount }, async () => {
+            while (true) {
+                const idx = nextIndex++;
+                if (idx >= entries.length) {
+                    return;
+                }
+                const entry = entries[idx];
+                const entryLevel = entry.level ?? level;
+                const compressOptions = {
+                    level: entryLevel,
+                    thresholdBytes
+                };
+                const { compressedData, deflate } = await compressEntryMaybe(entry, entryLevel, compressOptions, smartStore);
+                processedEntries[idx] = buildProcessedEntry(entry, 0, settings, compressedData, deflate);
+            }
+        });
+        await Promise.all(workers);
+    }
+    // Compute offsets in original order.
+    let currentOffset = 0;
+    for (let i = 0; i < processedEntries.length; i++) {
+        const processedEntry = processedEntries[i];
+        processedEntry.offset = currentOffset;
+        currentOffset += computeLocalRecordSize(processedEntry);
+    }
+    return finalizeZip(processedEntries, zipComment);
+}
+/**
+ * Create a ZIP file from entries (sync)
+ *
+ * This is supported in both Node.js and browser builds.
+ */
+function createZipSync(entries, options = {}) {
+    const reproducible = options.reproducible ?? false;
+    const level = options.level ?? defaults_1.DEFAULT_ZIP_LEVEL;
+    const smartStore = options.smartStore ?? true;
+    const timestamps = options.timestamps ?? (reproducible ? "dos" : defaults_1.DEFAULT_ZIP_TIMESTAMPS);
+    const zipComment = encodeZipComment(options.comment);
+    const defaultModTime = options.modTime ?? (reproducible ? REPRODUCIBLE_ZIP_MOD_TIME : new Date());
+    const settings = {
+        level,
+        timestamps,
+        defaultModTime
+    };
+    const thresholdBytes = options.thresholdBytes;
+    const processedEntries = [];
+    let currentOffset = 0;
+    for (const entry of entries) {
+        const entryLevel = entry.level ?? level;
+        const compressOptions = {
+            level: entryLevel,
+            thresholdBytes
+        };
+        const { compressedData, deflate } = compressEntryMaybeSync(entry, entryLevel, compressOptions, smartStore);
+        const result = appendProcessedEntry(processedEntries, entry, compressedData, deflate, currentOffset, settings);
+        currentOffset = result.nextOffset;
+    }
+    return finalizeZip(processedEntries, zipComment);
+}

package/dist/cjs/modules/archive/{zip-entry-metadata.js → zip/zip-entry-metadata.js}

@@ -3,14 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveZipCompressionMethod = resolveZipCompressionMethod;
 exports.resolveZipFlags = resolveZipFlags;
 exports.buildZipEntryMetadata = buildZipEntryMetadata;
-const text_1 = require("./utils/text.js");
-const timestamps_1 = require("./utils/timestamps.js");
-const zip_constants_1 = require("./zip-constants.js");
+const text_1 = require("../utils/text.js");
+const timestamps_1 = require("../utils/timestamps.js");
+const zip_records_1 = require("../zip-spec/zip-records.js");
 function resolveZipCompressionMethod(deflate) {
-    return deflate ? zip_constants_1.COMPRESSION_DEFLATE : zip_constants_1.COMPRESSION_STORE;
+    return deflate ? zip_records_1.COMPRESSION_DEFLATE : zip_records_1.COMPRESSION_STORE;
 }
 function resolveZipFlags(useDataDescriptor) {
-    return useDataDescriptor ? zip_constants_1.FLAG_UTF8 | zip_constants_1.FLAG_DATA_DESCRIPTOR : zip_constants_1.FLAG_UTF8;
+    return useDataDescriptor ? zip_records_1.FLAG_UTF8 | zip_records_1.FLAG_DATA_DESCRIPTOR : zip_records_1.FLAG_UTF8;
 }
 function buildZipEntryMetadata(input) {
     const nameBytes = (0, text_1.encodeUtf8)(input.name);

package/dist/cjs/modules/archive/zip-spec/zip-records.js

@@ -0,0 +1,136 @@
+"use strict";
+/**
+ * ZIP record builders (PKWARE APPNOTE)
+ *
+ * Shared by streaming zip writer and buffer zip builder.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZIP_END_OF_CENTRAL_DIR_FIXED_SIZE = exports.ZIP_CENTRAL_DIR_HEADER_FIXED_SIZE = exports.ZIP_LOCAL_FILE_HEADER_FIXED_SIZE = exports.UINT32_MAX = exports.UINT16_MAX = exports.FLAG_DATA_DESCRIPTOR = exports.FLAG_UTF8 = exports.COMPRESSION_DEFLATE = exports.COMPRESSION_STORE = exports.VERSION_MADE_BY = exports.VERSION_NEEDED = exports.ZIP64_END_OF_CENTRAL_DIR_LOCATOR_SIG = exports.ZIP64_END_OF_CENTRAL_DIR_SIG = exports.DATA_DESCRIPTOR_SIG = exports.END_OF_CENTRAL_DIR_SIG = exports.CENTRAL_DIR_HEADER_SIG = exports.LOCAL_FILE_HEADER_SIG = void 0;
+exports.writeLocalFileHeaderInto = writeLocalFileHeaderInto;
+exports.buildLocalFileHeader = buildLocalFileHeader;
+exports.writeCentralDirectoryHeaderInto = writeCentralDirectoryHeaderInto;
+exports.buildCentralDirectoryHeader = buildCentralDirectoryHeader;
+exports.writeEndOfCentralDirectoryInto = writeEndOfCentralDirectoryInto;
+exports.buildEndOfCentralDirectory = buildEndOfCentralDirectory;
+exports.buildDataDescriptor = buildDataDescriptor;
+// =============================================================================
+// ZIP format constants (PKWARE APPNOTE)
+// =============================================================================
+// Signatures
+exports.LOCAL_FILE_HEADER_SIG = 0x04034b50;
+exports.CENTRAL_DIR_HEADER_SIG = 0x02014b50;
+exports.END_OF_CENTRAL_DIR_SIG = 0x06054b50;
+exports.DATA_DESCRIPTOR_SIG = 0x08074b50;
+exports.ZIP64_END_OF_CENTRAL_DIR_SIG = 0x06064b50;
+exports.ZIP64_END_OF_CENTRAL_DIR_LOCATOR_SIG = 0x07064b50;
+// Versions
+exports.VERSION_NEEDED = 20; // 2.0 - supports DEFLATE
+exports.VERSION_MADE_BY = 20; // 2.0
+// Compression methods
+exports.COMPRESSION_STORE = 0;
+exports.COMPRESSION_DEFLATE = 8;
+// General purpose bit flags
+exports.FLAG_UTF8 = 0x0800;
+exports.FLAG_DATA_DESCRIPTOR = 0x0008;
+// ZIP64 / sentinel sizes
+exports.UINT16_MAX = 0xffff;
+exports.UINT32_MAX = 0xffffffff;
+exports.ZIP_LOCAL_FILE_HEADER_FIXED_SIZE = 30;
+exports.ZIP_CENTRAL_DIR_HEADER_FIXED_SIZE = 46;
+exports.ZIP_END_OF_CENTRAL_DIR_FIXED_SIZE = 22;
+function writeLocalFileHeaderInto(out, view, offset, input) {
+    const versionNeeded = input.versionNeeded ?? exports.VERSION_NEEDED;
+    view.setUint32(offset + 0, exports.LOCAL_FILE_HEADER_SIG, true);
+    view.setUint16(offset + 4, versionNeeded, true);
+    view.setUint16(offset + 6, input.flags, true);
+    view.setUint16(offset + 8, input.compressionMethod, true);
+    view.setUint16(offset + 10, input.dosTime, true);
+    view.setUint16(offset + 12, input.dosDate, true);
+    view.setUint32(offset + 14, input.crc32, true);
+    view.setUint32(offset + 18, input.compressedSize, true);
+    view.setUint32(offset + 22, input.uncompressedSize, true);
+    view.setUint16(offset + 26, input.fileName.length, true);
+    view.setUint16(offset + 28, input.extraField.length, true);
+    out.set(input.fileName, offset + exports.ZIP_LOCAL_FILE_HEADER_FIXED_SIZE);
+    if (input.extraField.length > 0) {
+        out.set(input.extraField, offset + exports.ZIP_LOCAL_FILE_HEADER_FIXED_SIZE + input.fileName.length);
+    }
+    return exports.ZIP_LOCAL_FILE_HEADER_FIXED_SIZE + input.fileName.length + input.extraField.length;
+}
+function buildLocalFileHeader(input) {
+    const header = new Uint8Array(exports.ZIP_LOCAL_FILE_HEADER_FIXED_SIZE + input.fileName.length + input.extraField.length);
+    const view = new DataView(header.buffer, header.byteOffset, header.byteLength);
+    writeLocalFileHeaderInto(header, view, 0, input);
+    return header;
+}
+function writeCentralDirectoryHeaderInto(out, view, offset, input) {
+    const versionMadeBy = input.versionMadeBy ?? exports.VERSION_MADE_BY;
+    const versionNeeded = input.versionNeeded ?? exports.VERSION_NEEDED;
+    const externalAttributes = input.externalAttributes ?? 0;
+    view.setUint32(offset + 0, exports.CENTRAL_DIR_HEADER_SIG, true);
+    view.setUint16(offset + 4, versionMadeBy, true);
+    view.setUint16(offset + 6, versionNeeded, true);
+    view.setUint16(offset + 8, input.flags, true);
+    view.setUint16(offset + 10, input.compressionMethod, true);
+    view.setUint16(offset + 12, input.dosTime, true);
+    view.setUint16(offset + 14, input.dosDate, true);
+    view.setUint32(offset + 16, input.crc32, true);
+    view.setUint32(offset + 20, input.compressedSize, true);
+    view.setUint32(offset + 24, input.uncompressedSize, true);
+    view.setUint16(offset + 28, input.fileName.length, true);
+    view.setUint16(offset + 30, input.extraField.length, true);
+    view.setUint16(offset + 32, input.comment.length, true);
+    view.setUint16(offset + 34, 0, true); // disk number start
+    view.setUint16(offset + 36, 0, true); // internal file attributes
+    view.setUint32(offset + 38, externalAttributes, true);
+    view.setUint32(offset + 42, input.localHeaderOffset, true);
+    out.set(input.fileName, offset + exports.ZIP_CENTRAL_DIR_HEADER_FIXED_SIZE);
+    if (input.extraField.length > 0) {
+        out.set(input.extraField, offset + exports.ZIP_CENTRAL_DIR_HEADER_FIXED_SIZE + input.fileName.length);
+    }
+    if (input.comment.length > 0) {
+        out.set(input.comment, offset + exports.ZIP_CENTRAL_DIR_HEADER_FIXED_SIZE + input.fileName.length + input.extraField.length);
+    }
+    return (exports.ZIP_CENTRAL_DIR_HEADER_FIXED_SIZE +
+        input.fileName.length +
+        input.extraField.length +
+        input.comment.length);
+}
+function buildCentralDirectoryHeader(input) {
+    const header = new Uint8Array(exports.ZIP_CENTRAL_DIR_HEADER_FIXED_SIZE +
+        input.fileName.length +
+        input.extraField.length +
+        input.comment.length);
+    const view = new DataView(header.buffer, header.byteOffset, header.byteLength);
+    writeCentralDirectoryHeaderInto(header, view, 0, input);
+    return header;
+}
+function writeEndOfCentralDirectoryInto(out, view, offset, input) {
+    view.setUint32(offset + 0, exports.END_OF_CENTRAL_DIR_SIG, true);
+    view.setUint16(offset + 4, 0, true);
+    view.setUint16(offset + 6, 0, true);
+    view.setUint16(offset + 8, input.entryCount, true);
+    view.setUint16(offset + 10, input.entryCount, true);
+    view.setUint32(offset + 12, input.centralDirSize, true);
+    view.setUint32(offset + 16, input.centralDirOffset, true);
+    view.setUint16(offset + 20, input.comment.length, true);
+    if (input.comment.length > 0) {
+        out.set(input.comment, offset + exports.ZIP_END_OF_CENTRAL_DIR_FIXED_SIZE);
+    }
+    return exports.ZIP_END_OF_CENTRAL_DIR_FIXED_SIZE + input.comment.length;
+}
+function buildEndOfCentralDirectory(input) {
+    const record = new Uint8Array(exports.ZIP_END_OF_CENTRAL_DIR_FIXED_SIZE + input.comment.length);
+    const view = new DataView(record.buffer, record.byteOffset, record.byteLength);
+    writeEndOfCentralDirectoryInto(record, view, 0, input);
+    return record;
+}
+function buildDataDescriptor(crc32, compressedSize, uncompressedSize) {
+    const descriptor = new Uint8Array(16);
+    const view = new DataView(descriptor.buffer);
+    view.setUint32(0, exports.DATA_DESCRIPTOR_SIG, true);
+    view.setUint32(4, crc32, true);
+    view.setUint32(8, compressedSize, true);
+    view.setUint32(12, uncompressedSize, true);
+    return descriptor;
+}

package/dist/cjs/modules/excel/stream/workbook-reader.browser.js

@@ -12,7 +12,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WorkbookReader = exports.WorkbookReaderOptionsSchema = exports.WorkbookReaderBase = void 0;
 const _stream_1 = require("../../stream/index.js");
-const parse_1 = require("../../archive/parse.js");
+const stream_1 = require("../../archive/unzip/stream.js");
 const iterate_stream_1 = require("../utils/iterate-stream.js");
 const ooxml_paths_1 = require("../utils/ooxml-paths.js");
 const parse_sax_1 = require("../utils/parse-sax.js");
@@ -359,7 +359,7 @@ class WorkbookReaderBase extends _stream_1.EventEmitter {
         }
     }
     async *_parseEntries(stream) {
-        const zip = (0, parse_1.createParse)({ forceStream: true });
+        const zip = (0, stream_1.createParse)({ forceStream: true });
         stream.on("error", (err) => zip.emit("error", err));
         stream.pipe(zip);
         for await (const entry of (0, iterate_stream_1.iterateStream)(zip)) {

package/dist/cjs/modules/excel/stream/workbook-writer.browser.js

@@ -10,7 +10,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WorkbookWriter = exports.WorkbookWriterOptionsSchema = exports.WorkbookWriterBase = void 0;
-const streaming_zip_1 = require("../../archive/streaming-zip.js");
+const stream_1 = require("../../archive/zip/stream.js");
 const stream_buf_1 = require("../utils/stream-buf.js");
 const utils_1 = require("../../../utils/utils.js");
 const rel_type_1 = require("../xlsx/rel-type.js");
@@ -54,7 +54,7 @@ class WorkbookWriterBase {
         this.commentRefs = [];
         this._trueStreaming = options.trueStreaming ?? false;
         // Create Zip instance
-        this.zip = new streaming_zip_1.Zip((err, data, final) => {
+        this.zip = new stream_1.Zip((err, data, final) => {
             if (err) {
                 this.stream.emit("error", err);
             }
@@ -88,7 +88,7 @@ class WorkbookWriterBase {
             bufSize: this._trueStreaming ? 4096 : 65536,
             batch: !this._trueStreaming
         });
-        const zipFile = new streaming_zip_1.ZipDeflate(path, { level: this.compressionLevel });
+        const zipFile = new stream_1.ZipDeflate(path, { level: this.compressionLevel });
         this.zip.add(zipFile);
         const onData = (chunk) => zipFile.push(chunk);
         stream.on("data", onData);
@@ -100,7 +100,7 @@ class WorkbookWriterBase {
         return stream;
     }
     _addFile(data, name, base64) {
-        const zipFile = new streaming_zip_1.ZipDeflate(name, { level: this.compressionLevel });
+        const zipFile = new stream_1.ZipDeflate(name, { level: this.compressionLevel });
         this.zip.add(zipFile);
         let buffer;
         if (base64) {