@cj-tech-master/excelts 4.2.0 → 4.2.1-canary.20260111102127.f808a37

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

@@ -1,297 +0,0 @@
-"use strict";
-/**
- * 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 │
- * └──────────────────────────┘
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ZipBuilder = void 0;
-exports.createZip = createZip;
-exports.createZipSync = createZipSync;
-const compress_1 = require("./compress.js");
-const crc32_1 = require("./crc32.js");
-const bytes_1 = require("./utils/bytes.js");
-const zip_entry_metadata_1 = require("./zip-entry-metadata.js");
-const defaults_1 = require("./defaults.js");
-const zip_records_1 = require("./zip-records.js");
-const zip_constants_1 = require("./zip-constants.js");
-const LOCAL_FILE_HEADER_FIXED_SIZE = 30;
-function encodeZipComment(comment) {
-    // Keep empty comment as empty bytes (no encoding surprises).
-    return comment ? new TextEncoder().encode(comment) : new Uint8Array(0);
-}
-function shouldDeflate(level, data) {
-    return level > 0 && data.length > 0;
-}
-function computeLocalRecordSize(entry) {
-    return (LOCAL_FILE_HEADER_FIXED_SIZE +
-        entry.name.length +
-        entry.extraField.length +
-        entry.compressedData.length);
-}
-function buildProcessedEntry(entry, offset, settings, compressedData) {
-    const modDate = entry.modTime ?? settings.defaultModTime;
-    const isCompressed = shouldDeflate(settings.level, entry.data);
-    const metadata = (0, zip_entry_metadata_1.buildZipEntryMetadata)({
-        name: entry.name,
-        comment: entry.comment,
-        modTime: modDate,
-        timestamps: settings.timestamps,
-        useDataDescriptor: false,
-        deflate: isCompressed
-    });
-    return {
-        name: metadata.nameBytes,
-        data: entry.data,
-        compressedData,
-        crc: (0, crc32_1.crc32)(entry.data),
-        compressionMethod: (0, zip_entry_metadata_1.resolveZipCompressionMethod)(isCompressed),
-        modTime: metadata.dosTime,
-        modDate: metadata.dosDate,
-        extraField: metadata.extraField,
-        comment: metadata.commentBytes,
-        offset
-    };
-}
-function appendProcessedEntry(processedEntries, entry, compressedData, currentOffset, settings) {
-    const processedEntry = buildProcessedEntry(entry, currentOffset, settings, compressedData);
-    processedEntries.push(processedEntry);
-    return {
-        processedEntry,
-        nextOffset: currentOffset + computeLocalRecordSize(processedEntry)
-    };
-}
-function finalizeZip(processedEntries, zipComment, centralDirOffset) {
-    // Build ZIP structure
-    const chunks = [];
-    // Local file headers and data
-    for (const entry of processedEntries) {
-        chunks.push(buildLocalFileHeaderChunk(entry));
-        chunks.push(entry.compressedData);
-    }
-    chunks.push(...buildCentralDirectorySection(processedEntries, centralDirOffset, zipComment));
-    return (0, bytes_1.concatUint8Arrays)(chunks);
-}
-function buildLocalFileHeaderChunk(entry) {
-    return (0, zip_records_1.buildLocalFileHeader)({
-        fileName: entry.name,
-        extraField: entry.extraField,
-        flags: zip_constants_1.FLAG_UTF8,
-        compressionMethod: entry.compressionMethod,
-        dosTime: entry.modTime,
-        dosDate: entry.modDate,
-        crc32: entry.crc,
-        compressedSize: entry.compressedData.length,
-        uncompressedSize: entry.data.length,
-        versionNeeded: zip_constants_1.VERSION_NEEDED
-    });
-}
-function buildCentralDirHeaderChunk(entry) {
-    return (0, zip_records_1.buildCentralDirectoryHeader)({
-        fileName: entry.name,
-        extraField: entry.extraField,
-        comment: entry.comment,
-        flags: zip_constants_1.FLAG_UTF8,
-        compressionMethod: entry.compressionMethod,
-        dosTime: entry.modTime,
-        dosDate: entry.modDate,
-        crc32: entry.crc,
-        compressedSize: entry.compressedData.length,
-        uncompressedSize: entry.data.length,
-        localHeaderOffset: entry.offset,
-        versionMadeBy: zip_constants_1.VERSION_MADE_BY,
-        versionNeeded: zip_constants_1.VERSION_NEEDED
-    });
-}
-function buildCentralDirectorySection(processedEntries, centralDirOffset, zipComment) {
-    const chunks = [];
-    for (const entry of processedEntries) {
-        chunks.push(buildCentralDirHeaderChunk(entry));
-    }
-    const centralDirSize = (0, bytes_1.sumUint8ArrayLengths)(chunks);
-    chunks.push((0, zip_records_1.buildEndOfCentralDirectory)({
-        entryCount: processedEntries.length,
-        centralDirSize,
-        centralDirOffset,
-        comment: zipComment
-    }));
-    return chunks;
-}
-/**
- * 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 });
- * ```
- */
-async function createZip(entries, options = {}) {
-    const level = options.level ?? defaults_1.DEFAULT_ZIP_LEVEL;
-    const timestamps = options.timestamps ?? defaults_1.DEFAULT_ZIP_TIMESTAMPS;
-    const zipComment = encodeZipComment(options.comment);
-    const defaultModTime = new Date();
-    const settings = {
-        level,
-        timestamps,
-        defaultModTime
-    };
-    const compressOptions = {
-        level,
-        thresholdBytes: options.thresholdBytes
-    };
-    const compressedDatas = await Promise.all(entries.map(async (entry) => {
-        return shouldDeflate(level, entry.data) ? (0, compress_1.compress)(entry.data, compressOptions) : entry.data;
-    }));
-    // Process entries
-    const processedEntries = [];
-    let currentOffset = 0;
-    for (let i = 0; i < entries.length; i++) {
-        const entry = entries[i];
-        const compressedData = compressedDatas[i];
-        const result = appendProcessedEntry(processedEntries, entry, compressedData, currentOffset, settings);
-        currentOffset = result.nextOffset;
-    }
-    return finalizeZip(processedEntries, zipComment, currentOffset);
-}
-/**
- * Create a ZIP file from entries (sync)
- *
- * This is supported in both Node.js and browser builds.
- */
-function createZipSync(entries, options = {}) {
-    const level = options.level ?? defaults_1.DEFAULT_ZIP_LEVEL;
-    const timestamps = options.timestamps ?? defaults_1.DEFAULT_ZIP_TIMESTAMPS;
-    const zipComment = encodeZipComment(options.comment);
-    const defaultModTime = new Date();
-    const settings = {
-        level,
-        timestamps,
-        defaultModTime
-    };
-    const compressOptions = {
-        level,
-        thresholdBytes: options.thresholdBytes
-    };
-    // Process entries
-    const processedEntries = [];
-    let currentOffset = 0;
-    for (const entry of entries) {
-        // Compress data
-        const compressedData = shouldDeflate(level, entry.data)
-            ? (0, compress_1.compressSync)(entry.data, compressOptions)
-            : entry.data;
-        const result = appendProcessedEntry(processedEntries, entry, compressedData, currentOffset, settings);
-        currentOffset = result.nextOffset;
-    }
-    return finalizeZip(processedEntries, zipComment, currentOffset);
-}
-/**
- * Streaming ZIP builder for large files
- * Writes chunks to a callback as they are generated
- */
-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 ?? defaults_1.DEFAULT_ZIP_LEVEL;
-        this.zipComment = encodeZipComment(options.comment);
-        this.timestamps = options.timestamps ?? defaults_1.DEFAULT_ZIP_TIMESTAMPS;
-        this.compressOptions = {
-            level: this.level,
-            thresholdBytes: options.thresholdBytes
-        };
-        this.settings = {
-            level: this.level,
-            timestamps: this.timestamps,
-            defaultModTime: new Date()
-        };
-    }
-    /**
-     * 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");
-        }
-        // Compress data
-        const compressedData = shouldDeflate(this.level, entry.data)
-            ? await (0, compress_1.compress)(entry.data, this.compressOptions)
-            : entry.data;
-        const result = appendProcessedEntry(this.entries, entry, compressedData, this.currentOffset, this.settings);
-        this.currentOffset = result.nextOffset;
-        return [buildLocalFileHeaderChunk(result.processedEntry), compressedData];
-    }
-    /**
-     * Add a file to the ZIP (sync)
-     * @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");
-        }
-        // Compress data
-        const compressedData = shouldDeflate(this.level, entry.data)
-            ? (0, compress_1.compressSync)(entry.data, this.compressOptions)
-            : entry.data;
-        const result = appendProcessedEntry(this.entries, entry, compressedData, this.currentOffset, this.settings);
-        this.currentOffset = result.nextOffset;
-        return [buildLocalFileHeaderChunk(result.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;
-        return buildCentralDirectorySection(this.entries, this.currentOffset, this.zipComment);
-    }
-    /**
-     * Get current number of entries
-     */
-    get entryCount() {
-        return this.entries.length;
-    }
-    /**
-     * Get current ZIP data size (without central directory)
-     */
-    get dataSize() {
-        return this.currentOffset;
-    }
-}
-exports.ZipBuilder = ZipBuilder;

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

@@ -1,26 +0,0 @@
-"use strict";
-/**
- * ZIP format constants (PKWARE APPNOTE)
- * Shared by ZIP writer and parser implementations.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-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;
-// 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;

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

@@ -1,90 +0,0 @@
-"use strict";
-/**
- * ZIP record builders (PKWARE APPNOTE)
- *
- * Shared by streaming zip writer and buffer zip builder.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildLocalFileHeader = buildLocalFileHeader;
-exports.buildCentralDirectoryHeader = buildCentralDirectoryHeader;
-exports.buildEndOfCentralDirectory = buildEndOfCentralDirectory;
-exports.buildDataDescriptor = buildDataDescriptor;
-const zip_constants_1 = require("./zip-constants.js");
-function buildLocalFileHeader(input) {
-    const versionNeeded = input.versionNeeded ?? zip_constants_1.VERSION_NEEDED;
-    const header = new Uint8Array(30 + input.fileName.length + input.extraField.length);
-    const view = new DataView(header.buffer);
-    view.setUint32(0, zip_constants_1.LOCAL_FILE_HEADER_SIG, true);
-    view.setUint16(4, versionNeeded, true);
-    view.setUint16(6, input.flags, true);
-    view.setUint16(8, input.compressionMethod, true);
-    view.setUint16(10, input.dosTime, true);
-    view.setUint16(12, input.dosDate, true);
-    view.setUint32(14, input.crc32, true);
-    view.setUint32(18, input.compressedSize, true);
-    view.setUint32(22, input.uncompressedSize, true);
-    view.setUint16(26, input.fileName.length, true);
-    view.setUint16(28, input.extraField.length, true);
-    header.set(input.fileName, 30);
-    if (input.extraField.length > 0) {
-        header.set(input.extraField, 30 + input.fileName.length);
-    }
-    return header;
-}
-function buildCentralDirectoryHeader(input) {
-    const versionMadeBy = input.versionMadeBy ?? zip_constants_1.VERSION_MADE_BY;
-    const versionNeeded = input.versionNeeded ?? zip_constants_1.VERSION_NEEDED;
-    const externalAttributes = input.externalAttributes ?? 0;
-    const header = new Uint8Array(46 + input.fileName.length + input.extraField.length + input.comment.length);
-    const view = new DataView(header.buffer);
-    view.setUint32(0, zip_constants_1.CENTRAL_DIR_HEADER_SIG, true);
-    view.setUint16(4, versionMadeBy, true);
-    view.setUint16(6, versionNeeded, true);
-    view.setUint16(8, input.flags, true);
-    view.setUint16(10, input.compressionMethod, true);
-    view.setUint16(12, input.dosTime, true);
-    view.setUint16(14, input.dosDate, true);
-    view.setUint32(16, input.crc32, true);
-    view.setUint32(20, input.compressedSize, true);
-    view.setUint32(24, input.uncompressedSize, true);
-    view.setUint16(28, input.fileName.length, true);
-    view.setUint16(30, input.extraField.length, true);
-    view.setUint16(32, input.comment.length, true);
-    view.setUint16(34, 0, true); // disk number start
-    view.setUint16(36, 0, true); // internal file attributes
-    view.setUint32(38, externalAttributes, true);
-    view.setUint32(42, input.localHeaderOffset, true);
-    header.set(input.fileName, 46);
-    if (input.extraField.length > 0) {
-        header.set(input.extraField, 46 + input.fileName.length);
-    }
-    if (input.comment.length > 0) {
-        header.set(input.comment, 46 + input.fileName.length + input.extraField.length);
-    }
-    return header;
-}
-function buildEndOfCentralDirectory(input) {
-    const record = new Uint8Array(22 + input.comment.length);
-    const view = new DataView(record.buffer);
-    view.setUint32(0, zip_constants_1.END_OF_CENTRAL_DIR_SIG, true);
-    view.setUint16(4, 0, true);
-    view.setUint16(6, 0, true);
-    view.setUint16(8, input.entryCount, true);
-    view.setUint16(10, input.entryCount, true);
-    view.setUint32(12, input.centralDirSize, true);
-    view.setUint32(16, input.centralDirOffset, true);
-    view.setUint16(20, input.comment.length, true);
-    if (input.comment.length > 0) {
-        record.set(input.comment, 22);
-    }
-    return record;
-}
-function buildDataDescriptor(crc32, compressedSize, uncompressedSize) {
-    const descriptor = new Uint8Array(16);
-    const view = new DataView(descriptor.buffer);
-    view.setUint32(0, zip_constants_1.DATA_DESCRIPTOR_SIG, true);
-    view.setUint32(4, crc32, true);
-    view.setUint32(8, compressedSize, true);
-    view.setUint32(12, uncompressedSize, true);
-    return descriptor;
-}

package/dist/esm/modules/archive/byte-queue.js

@@ -1,125 +0,0 @@
-export class ByteQueue {
-    constructor(initial) {
-        this._start = 0;
-        this._end = 0;
-        this._cachedView = null;
-        this._cachedBuf = null;
-        this._cachedStart = 0;
-        this._cachedEnd = 0;
-        this._buf = new Uint8Array(0);
-        if (initial && initial.length > 0) {
-            this.reset(initial);
-        }
-    }
-    get length() {
-        return this._end - this._start;
-    }
-    isEmpty() {
-        return this.length === 0;
-    }
-    view() {
-        if (this._start === this._end) {
-            return ByteQueue.EMPTY;
-        }
-        if (this._cachedView &&
-            this._cachedBuf === this._buf &&
-            this._cachedStart === this._start &&
-            this._cachedEnd === this._end) {
-            return this._cachedView;
-        }
-        const view = this._buf.subarray(this._start, this._end);
-        this._cachedView = view;
-        this._cachedBuf = this._buf;
-        this._cachedStart = this._start;
-        this._cachedEnd = this._end;
-        return view;
-    }
-    reset(data) {
-        this._cachedView = null;
-        this._cachedBuf = null;
-        if (!data || data.length === 0) {
-            this._buf = ByteQueue.EMPTY;
-            this._start = 0;
-            this._end = 0;
-            return;
-        }
-        // Keep a private copy to ensure future writes cannot mutate the source.
-        const copy = new Uint8Array(data.length);
-        copy.set(data);
-        this._buf = copy;
-        this._start = 0;
-        this._end = copy.length;
-    }
-    append(chunk) {
-        if (chunk.length === 0) {
-            return;
-        }
-        this._cachedView = null;
-        this._cachedBuf = null;
-        const unread = this.length;
-        // Fast path: enough tail room.
-        if (this._end + chunk.length <= this._buf.length) {
-            this._buf.set(chunk, this._end);
-            this._end += chunk.length;
-            return;
-        }
-        // Allocate a new buffer and copy unread bytes (never compacts in-place).
-        const required = unread + chunk.length;
-        const nextSize = this._buf.length === 0 ? required : Math.max(this._buf.length * 2, required);
-        const next = new Uint8Array(nextSize);
-        if (unread > 0) {
-            next.set(this._buf.subarray(this._start, this._end), 0);
-        }
-        next.set(chunk, unread);
-        this._buf = next;
-        this._start = 0;
-        this._end = required;
-    }
-    read(length) {
-        if (length <= 0) {
-            return new Uint8Array(0);
-        }
-        if (length > this.length) {
-            throw new RangeError("ByteQueue: read beyond available data");
-        }
-        // Return a view for performance.
-        // To keep this safe for async consumers, we must ensure we never write into
-        // the same backing buffer again after it becomes fully consumed.
-        const out = this._buf.subarray(this._start, this._start + length);
-        this._start += length;
-        this._cachedView = null;
-        this._cachedBuf = null;
-        if (this._start === this._end) {
-            // Release backing storage to avoid reusing memory that might still be
-            // referenced by previously returned views.
-            this._buf = ByteQueue.EMPTY;
-            this._start = 0;
-            this._end = 0;
-        }
-        return out;
-    }
-    discard(length) {
-        if (length <= 0) {
-            return;
-        }
-        if (length >= this.length) {
-            // Release backing storage for the same reason as read(): previously
-            // returned views may still be referenced by consumers.
-            this._buf = ByteQueue.EMPTY;
-            this._start = 0;
-            this._end = 0;
-            this._cachedView = null;
-            this._cachedBuf = null;
-            return;
-        }
-        this._start += length;
-        this._cachedView = null;
-        this._cachedBuf = null;
-        if (this._start === this._end) {
-            this._buf = ByteQueue.EMPTY;
-            this._start = 0;
-            this._end = 0;
-        }
-    }
-}
-ByteQueue.EMPTY = new Uint8Array(0);