@cj-tech-master/excelts 1.4.2 → 1.4.4

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;
+}

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

@@ -0,0 +1,55 @@
+/**
+ * Native ZIP utilities - Pure native implementation without third-party dependencies
+ *
+ * This module provides ZIP file creation using only native platform APIs:
+ * - Node.js: Uses native zlib module (C++ implementation, fastest)
+ * - Browser: Uses CompressionStream API (Chrome 80+, Firefox 113+, Safari 16.4+)
+ *
+ * Features:
+ * - Full ZIP format support (Local File Headers, Central Directory, EOCD)
+ * - DEFLATE compression (level 0-9 on Node.js, fixed level on browser)
+ * - STORE mode (no compression)
+ * - UTF-8 filename support
+ * - File comments and ZIP comments
+ * - Streaming API for large files
+ * - Both sync (Node.js) and async APIs
+ *
+ * @example Basic usage
+ * ```ts
+ * import { createZip } from "./utils/zip/index.js";
+ *
+ * const zipData = await createZip([
+ *   { name: "hello.txt", data: new TextEncoder().encode("Hello!") },
+ *   { name: "folder/nested.txt", data: new TextEncoder().encode("Nested file") }
+ * ], { level: 6 });
+ *
+ * // Write to file (Node.js)
+ * fs.writeFileSync("output.zip", zipData);
+ * ```
+ *
+ * @example Streaming usage
+ * ```ts
+ * import { ZipBuilder } from "./utils/zip/index.js";
+ *
+ * const builder = new ZipBuilder({ level: 1 });
+ *
+ * // Add files one by one
+ * const [header1, data1] = await builder.addFile({
+ *   name: "file1.txt",
+ *   data: new TextEncoder().encode("File 1 content")
+ * });
+ * stream.write(header1);
+ * stream.write(data1);
+ *
+ * // Finalize and write central directory
+ * for (const chunk of builder.finalize()) {
+ *   stream.write(chunk);
+ * }
+ * ```
+ */
+// CRC32 utilities
+export { crc32, crc32Update, crc32Finalize } from "./crc32.js";
+// Compression utilities
+export { compress, compressSync, decompress, decompressSync, hasNativeZlib, hasCompressionStream } from "./compress.js";
+// ZIP builder
+export { createZip, createZipSync, ZipBuilder } from "./zip-builder.js";

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

@@ -0,0 +1,372 @@
+/**
+ * ZIP file format builder
+ *
+ * Implements ZIP file structure according to PKWARE's APPNOTE.TXT specification
+ * https://pkware.cachefly.net/webdocs/casestudies/APPNOTE.TXT
+ *
+ * ZIP file structure:
+ * ┌──────────────────────────┐
+ * │   Local File Header 1    │
+ * │   File Data 1            │
+ * ├──────────────────────────┤
+ * │   Local File Header 2    │
+ * │   File Data 2            │
+ * ├──────────────────────────┤
+ * │         ...              │
+ * ├──────────────────────────┤
+ * │  Central Directory 1     │
+ * │  Central Directory 2     │
+ * │         ...              │
+ * ├──────────────────────────┤
+ * │ End of Central Directory │
+ * └──────────────────────────┘
+ */
+import { crc32 } from "./crc32.js";
+import { compress, 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;
+/**
+ * Convert Date to DOS time format
+ * @param date - Date to convert
+ * @returns [dosTime, dosDate]
+ */
+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];
+}
+/**
+ * Encode string to UTF-8 bytes
+ */
+const encoder = new TextEncoder();
+function encodeString(str) {
+    return encoder.encode(str);
+}
+/**
+ * Build Local File Header (30 bytes + filename + extra)
+ */
+function buildLocalFileHeader(entry) {
+    const header = new Uint8Array(30 + entry.name.length);
+    const view = new DataView(header.buffer);
+    view.setUint32(0, LOCAL_FILE_HEADER_SIG, true); // Signature
+    view.setUint16(4, VERSION_NEEDED, true); // Version needed to extract
+    view.setUint16(6, 0x0800, true); // General purpose bit flag (UTF-8 names)
+    view.setUint16(8, entry.compressionMethod, true); // Compression method
+    view.setUint16(10, entry.modTime, true); // Last mod time
+    view.setUint16(12, entry.modDate, true); // Last mod date
+    view.setUint32(14, entry.crc, true); // CRC-32
+    view.setUint32(18, entry.compressedData.length, true); // Compressed size
+    view.setUint32(22, entry.data.length, true); // Uncompressed size
+    view.setUint16(26, entry.name.length, true); // Filename length
+    view.setUint16(28, 0, true); // Extra field length
+    header.set(entry.name, 30);
+    return header;
+}
+/**
+ * Build Central Directory Header (46 bytes + filename + extra + comment)
+ */
+function buildCentralDirHeader(entry) {
+    const header = new Uint8Array(46 + entry.name.length + entry.comment.length);
+    const view = new DataView(header.buffer);
+    view.setUint32(0, CENTRAL_DIR_HEADER_SIG, true); // Signature
+    view.setUint16(4, VERSION_MADE_BY, true); // Version made by
+    view.setUint16(6, VERSION_NEEDED, true); // Version needed to extract
+    view.setUint16(8, 0x0800, true); // General purpose bit flag (UTF-8 names)
+    view.setUint16(10, entry.compressionMethod, true); // Compression method
+    view.setUint16(12, entry.modTime, true); // Last mod time
+    view.setUint16(14, entry.modDate, true); // Last mod date
+    view.setUint32(16, entry.crc, true); // CRC-32
+    view.setUint32(20, entry.compressedData.length, true); // Compressed size
+    view.setUint32(24, entry.data.length, true); // Uncompressed size
+    view.setUint16(28, entry.name.length, true); // Filename length
+    view.setUint16(30, 0, true); // Extra field length
+    view.setUint16(32, entry.comment.length, 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); // Relative offset of local header
+    header.set(entry.name, 46);
+    if (entry.comment.length > 0) {
+        header.set(entry.comment, 46 + entry.name.length);
+    }
+    return header;
+}
+/**
+ * Build End of Central Directory Record (22 bytes + comment)
+ */
+function buildEndOfCentralDir(entryCount, centralDirSize, centralDirOffset, comment) {
+    const record = new Uint8Array(22 + comment.length);
+    const view = new DataView(record.buffer);
+    view.setUint32(0, END_OF_CENTRAL_DIR_SIG, true); // Signature
+    view.setUint16(4, 0, true); // Number of this disk
+    view.setUint16(6, 0, true); // Disk where central dir starts
+    view.setUint16(8, entryCount, true); // Number of entries on this disk
+    view.setUint16(10, entryCount, true); // Total number of entries
+    view.setUint32(12, centralDirSize, true); // Size of central directory
+    view.setUint32(16, centralDirOffset, true); // Offset of central directory
+    view.setUint16(20, comment.length, true); // Comment length
+    if (comment.length > 0) {
+        record.set(comment, 22);
+    }
+    return record;
+}
+/**
+ * Create a ZIP file from entries (async)
+ *
+ * @param entries - Files to include in ZIP
+ * @param options - ZIP options
+ * @returns ZIP file as Uint8Array
+ *
+ * @example
+ * ```ts
+ * const zip = await createZip([
+ *   { name: "hello.txt", data: new TextEncoder().encode("Hello!") },
+ *   { name: "folder/file.txt", data: new TextEncoder().encode("Nested!") }
+ * ], { level: 6 });
+ * ```
+ */
+export async function createZip(entries, options = {}) {
+    const level = options.level ?? 6;
+    const zipComment = encodeString(options.comment ?? "");
+    const now = new Date();
+    // Process entries
+    const processedEntries = [];
+    let currentOffset = 0;
+    for (const entry of entries) {
+        const nameBytes = encodeString(entry.name);
+        const commentBytes = encodeString(entry.comment ?? "");
+        const modDate = entry.modTime ?? now;
+        const [dosTime, dosDate] = dateToDos(modDate);
+        // Compress data
+        const isCompressed = level > 0 && entry.data.length > 0;
+        const compressedData = isCompressed ? await compress(entry.data, { level }) : entry.data;
+        const processedEntry = {
+            name: nameBytes,
+            data: entry.data,
+            compressedData,
+            crc: crc32(entry.data),
+            compressionMethod: isCompressed ? COMPRESSION_DEFLATE : COMPRESSION_STORE,
+            modTime: dosTime,
+            modDate: dosDate,
+            comment: commentBytes,
+            offset: currentOffset
+        };
+        // Calculate offset for next entry
+        currentOffset += 30 + nameBytes.length + compressedData.length;
+        processedEntries.push(processedEntry);
+    }
+    // Build ZIP structure
+    const chunks = [];
+    // Local file headers and data
+    for (const entry of processedEntries) {
+        chunks.push(buildLocalFileHeader(entry));
+        chunks.push(entry.compressedData);
+    }
+    const centralDirOffset = currentOffset;
+    // Central directory
+    const centralDirChunks = [];
+    for (const entry of processedEntries) {
+        centralDirChunks.push(buildCentralDirHeader(entry));
+    }
+    chunks.push(...centralDirChunks);
+    const centralDirSize = centralDirChunks.reduce((sum, c) => sum + c.length, 0);
+    // End of central directory
+    chunks.push(buildEndOfCentralDir(processedEntries.length, centralDirSize, centralDirOffset, zipComment));
+    // Combine all chunks
+    const totalSize = chunks.reduce((sum, c) => sum + c.length, 0);
+    const result = new Uint8Array(totalSize);
+    let offset = 0;
+    for (const chunk of chunks) {
+        result.set(chunk, offset);
+        offset += chunk.length;
+    }
+    return result;
+}
+/**
+ * Create a ZIP file from entries (sync, Node.js only)
+ *
+ * @param entries - Files to include in ZIP
+ * @param options - ZIP options
+ * @returns ZIP file as Uint8Array
+ * @throws Error if not in Node.js environment
+ */
+export function createZipSync(entries, options = {}) {
+    const level = options.level ?? 6;
+    const zipComment = encodeString(options.comment ?? "");
+    const now = new Date();
+    // Process entries
+    const processedEntries = [];
+    let currentOffset = 0;
+    for (const entry of entries) {
+        const nameBytes = encodeString(entry.name);
+        const commentBytes = encodeString(entry.comment ?? "");
+        const modDate = entry.modTime ?? now;
+        const [dosTime, dosDate] = dateToDos(modDate);
+        // Compress data
+        const isCompressed = level > 0 && entry.data.length > 0;
+        const compressedData = isCompressed ? compressSync(entry.data, { level }) : entry.data;
+        const processedEntry = {
+            name: nameBytes,
+            data: entry.data,
+            compressedData,
+            crc: crc32(entry.data),
+            compressionMethod: isCompressed ? COMPRESSION_DEFLATE : COMPRESSION_STORE,
+            modTime: dosTime,
+            modDate: dosDate,
+            comment: commentBytes,
+            offset: currentOffset
+        };
+        currentOffset += 30 + nameBytes.length + compressedData.length;
+        processedEntries.push(processedEntry);
+    }
+    // Build ZIP structure
+    const chunks = [];
+    // Local file headers and data
+    for (const entry of processedEntries) {
+        chunks.push(buildLocalFileHeader(entry));
+        chunks.push(entry.compressedData);
+    }
+    const centralDirOffset = currentOffset;
+    // Central directory
+    const centralDirChunks = [];
+    for (const entry of processedEntries) {
+        centralDirChunks.push(buildCentralDirHeader(entry));
+    }
+    chunks.push(...centralDirChunks);
+    const centralDirSize = centralDirChunks.reduce((sum, c) => sum + c.length, 0);
+    // End of central directory
+    chunks.push(buildEndOfCentralDir(processedEntries.length, centralDirSize, centralDirOffset, zipComment));
+    // Combine all chunks
+    const totalSize = chunks.reduce((sum, c) => sum + c.length, 0);
+    const result = new Uint8Array(totalSize);
+    let offset = 0;
+    for (const chunk of chunks) {
+        result.set(chunk, offset);
+        offset += chunk.length;
+    }
+    return result;
+}
+/**
+ * Streaming ZIP builder for large files
+ * Writes chunks to a callback as they are generated
+ */
+export class ZipBuilder {
+    /**
+     * Create a new ZIP builder
+     * @param options - ZIP options
+     */
+    constructor(options = {}) {
+        this.entries = [];
+        this.currentOffset = 0;
+        this.finalized = false;
+        this.level = options.level ?? 6;
+        this.zipComment = encodeString(options.comment ?? "");
+    }
+    /**
+     * Add a file to the ZIP (async)
+     * @param entry - File entry
+     * @returns Local file header and compressed data chunks
+     */
+    async addFile(entry) {
+        if (this.finalized) {
+            throw new Error("Cannot add files after finalizing");
+        }
+        const nameBytes = encodeString(entry.name);
+        const commentBytes = encodeString(entry.comment ?? "");
+        const [dosTime, dosDate] = dateToDos(entry.modTime ?? new Date());
+        // Compress data
+        const isCompressed = this.level > 0 && entry.data.length > 0;
+        const compressedData = isCompressed
+            ? await compress(entry.data, { level: this.level })
+            : entry.data;
+        const processedEntry = {
+            name: nameBytes,
+            data: entry.data,
+            compressedData,
+            crc: crc32(entry.data),
+            compressionMethod: isCompressed ? COMPRESSION_DEFLATE : COMPRESSION_STORE,
+            modTime: dosTime,
+            modDate: dosDate,
+            comment: commentBytes,
+            offset: this.currentOffset
+        };
+        this.entries.push(processedEntry);
+        this.currentOffset += 30 + nameBytes.length + compressedData.length;
+        return [buildLocalFileHeader(processedEntry), compressedData];
+    }
+    /**
+     * Add a file to the ZIP (sync, Node.js only)
+     * @param entry - File entry
+     * @returns Local file header and compressed data chunks
+     */
+    addFileSync(entry) {
+        if (this.finalized) {
+            throw new Error("Cannot add files after finalizing");
+        }
+        const nameBytes = encodeString(entry.name);
+        const commentBytes = encodeString(entry.comment ?? "");
+        const [dosTime, dosDate] = dateToDos(entry.modTime ?? new Date());
+        // Compress data
+        const isCompressed = this.level > 0 && entry.data.length > 0;
+        const compressedData = isCompressed
+            ? compressSync(entry.data, { level: this.level })
+            : entry.data;
+        const processedEntry = {
+            name: nameBytes,
+            data: entry.data,
+            compressedData,
+            crc: crc32(entry.data),
+            compressionMethod: isCompressed ? COMPRESSION_DEFLATE : COMPRESSION_STORE,
+            modTime: dosTime,
+            modDate: dosDate,
+            comment: commentBytes,
+            offset: this.currentOffset
+        };
+        this.entries.push(processedEntry);
+        this.currentOffset += 30 + nameBytes.length + compressedData.length;
+        return [buildLocalFileHeader(processedEntry), compressedData];
+    }
+    /**
+     * Finalize the ZIP and return central directory + end record
+     * @returns Central directory and end of central directory chunks
+     */
+    finalize() {
+        if (this.finalized) {
+            throw new Error("ZIP already finalized");
+        }
+        this.finalized = true;
+        const chunks = [];
+        // Central directory
+        for (const entry of this.entries) {
+            chunks.push(buildCentralDirHeader(entry));
+        }
+        const centralDirSize = chunks.reduce((sum, c) => sum + c.length, 0);
+        // End of central directory
+        chunks.push(buildEndOfCentralDir(this.entries.length, centralDirSize, this.currentOffset, this.zipComment));
+        return chunks;
+    }
+    /**
+     * Get current number of entries
+     */
+    get entryCount() {
+        return this.entries.length;
+    }
+    /**
+     * Get current ZIP data size (without central directory)
+     */
+    get dataSize() {
+        return this.currentOffset;
+    }
+}

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

@@ -1,35 +1,23 @@
 import events from "events";
-import { Zip, ZipPassThrough, ZipDeflate } from "fflate";
+import { ZipBuilder } from "./zip/index.js";
 import { StreamBuf } from "./stream-buf.js";
 // =============================================================================
 // The ZipWriter class
 // Packs streamed data into an output zip stream
+// Uses native zlib (Node.js) or CompressionStream (browser) for best performance
 class ZipWriter extends events.EventEmitter {
     constructor(options) {
         super();
-        this.options = Object.assign({
-            type: "nodebuffer",
-            compression: "DEFLATE"
-        }, options);
-        // Default compression level is 6 (good balance of speed and size)
-        // 0 = no compression, 9 = best compression
-        const level = this.options.compressionOptions?.level ?? 6;
-        this.compressionLevel = Math.max(0, Math.min(9, level));
-        this.files = {};
-        this.stream = new StreamBuf();
         this.finalized = false;
-        // Create fflate Zip instance for streaming compression
-        this.zip = new Zip((err, data, final) => {
-            if (err) {
-                this.stream.emit("error", err);
-            }
-            else {
-                this.stream.write(Buffer.from(data));
-                if (final) {
-                    this.stream.end();
-                }
-            }
-        });
+        this.pendingWrites = [];
+        // Determine compression level:
+        // - STORE mode = 0 (no compression)
+        // - DEFLATE mode = user level or default 1 (fast compression)
+        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 });
     }
     append(data, options) {
         let buffer;
@@ -43,7 +31,7 @@ class ZipWriter extends events.EventEmitter {
             buffer = Buffer.from(data, "utf8");
         }
         else if (Buffer.isBuffer(data)) {
-            // Buffer extends Uint8Array, fflate can use it directly - no copy needed
+            // Buffer extends Uint8Array, can use it directly - no copy needed
             buffer = data;
         }
         else if (ArrayBuffer.isView(data)) {
@@ -58,14 +46,16 @@ class ZipWriter extends events.EventEmitter {
             // Assume it's already a Uint8Array or compatible type
             buffer = data;
         }
-        // Add file to zip using streaming API
-        // Use ZipDeflate for compression or ZipPassThrough for no compression
-        const useCompression = this.options.compression !== "STORE";
-        const zipFile = useCompression
-            ? new ZipDeflate(options.name, { level: this.compressionLevel })
-            : new ZipPassThrough(options.name);
-        this.zip.add(zipFile);
-        zipFile.push(buffer, true); // true = final chunk
+        // Add file to zip using native compression
+        // addFile returns chunks that we write to stream immediately
+        const writePromise = this.zipBuilder
+            .addFile({ name: options.name, data: buffer })
+            .then(chunks => {
+            for (const chunk of chunks) {
+                this.stream.write(Buffer.from(chunk));
+            }
+        });
+        this.pendingWrites.push(writePromise);
     }
     push(chunk) {
         return this.stream.push(chunk);
@@ -75,8 +65,14 @@ class ZipWriter extends events.EventEmitter {
             return;
         }
         this.finalized = true;
-        // End the zip stream
-        this.zip.end();
+        // Wait for all pending writes to complete
+        await Promise.all(this.pendingWrites);
+        // Finalize the zip and write central directory
+        const finalChunks = this.zipBuilder.finalize();
+        for (const chunk of finalChunks) {
+            this.stream.write(Buffer.from(chunk));
+        }
+        this.stream.end();
         this.emit("finish");
     }
     // ==========================================================================