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

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

@@ -1,239 +0,0 @@
-/**
- * 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()`.
- */
-import { compress, compressSync } from "../compression/compress.browser.js";
-import { crc32 } from "../compression/crc32.browser.js";
-import { DEFAULT_ZIP_LEVEL, DEFAULT_ZIP_TIMESTAMPS } from "../defaults.js";
-import { isProbablyIncompressible } from "../utils/compressibility.js";
-import { encodeUtf8 } from "../utils/text.js";
-import {} from "../utils/timestamps.js";
-import { buildZipEntryMetadata, resolveZipCompressionMethod } from "./zip-entry-metadata.js";
-import { FLAG_UTF8, ZIP_CENTRAL_DIR_HEADER_FIXED_SIZE, ZIP_END_OF_CENTRAL_DIR_FIXED_SIZE, ZIP_LOCAL_FILE_HEADER_FIXED_SIZE, writeCentralDirectoryHeaderInto, writeEndOfCentralDirectoryInto, writeLocalFileHeaderInto } from "../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 ? 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 compress(entry.data, compressOptions);
-        return { compressedData: compressed, deflate: true };
-    }
-    // Heuristic: skip deflate for high-entropy inputs.
-    if (isProbablyIncompressible(entry.data)) {
-        return { compressedData: entry.data, deflate: false };
-    }
-    const compressed = await 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 = compressSync(entry.data, compressOptions);
-        return { compressedData: compressed, deflate: true };
-    }
-    if (isProbablyIncompressible(entry.data)) {
-        return { compressedData: entry.data, deflate: false };
-    }
-    const compressed = 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_LOCAL_FILE_HEADER_FIXED_SIZE +
-        entry.name.length +
-        entry.extraField.length +
-        entry.compressedData.length);
-}
-function computeCentralDirHeaderSize(entry) {
-    return (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 = 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: crc32(entry.data),
-        compressionMethod: 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_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 += writeLocalFileHeaderInto(out, view, offset, {
-            fileName: entry.name,
-            extraField: entry.extraField,
-            flags: 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 += writeCentralDirectoryHeaderInto(out, view, offset, {
-            fileName: entry.name,
-            extraField: entry.extraField,
-            comment: entry.comment,
-            flags: 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
-    writeEndOfCentralDirectoryInto(out, view, offset, {
-        entryCount: processedEntries.length,
-        centralDirSize,
-        centralDirOffset,
-        comment: zipComment
-    });
-    return out;
-}
-/**
- * Create a ZIP file from entries (async)
- */
-export async function createZip(entries, options = {}) {
-    const reproducible = options.reproducible ?? false;
-    const level = options.level ?? DEFAULT_ZIP_LEVEL;
-    const smartStore = options.smartStore ?? true;
-    const concurrency = options.concurrency ?? 4;
-    const timestamps = options.timestamps ?? (reproducible ? "dos" : 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.
- */
-export function createZipSync(entries, options = {}) {
-    const reproducible = options.reproducible ?? false;
-    const level = options.level ?? DEFAULT_ZIP_LEVEL;
-    const smartStore = options.smartStore ?? true;
-    const timestamps = options.timestamps ?? (reproducible ? "dos" : 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/browser/modules/archive/zip-spec/zip-records.js

@@ -1,126 +0,0 @@
-/**
- * ZIP record builders (PKWARE APPNOTE)
- *
- * Shared by streaming zip writer and buffer zip builder.
- */
-// =============================================================================
-// ZIP format constants (PKWARE APPNOTE)
-// =============================================================================
-// Signatures
-export const LOCAL_FILE_HEADER_SIG = 0x04034b50;
-export const CENTRAL_DIR_HEADER_SIG = 0x02014b50;
-export const END_OF_CENTRAL_DIR_SIG = 0x06054b50;
-export const DATA_DESCRIPTOR_SIG = 0x08074b50;
-export const ZIP64_END_OF_CENTRAL_DIR_SIG = 0x06064b50;
-export const ZIP64_END_OF_CENTRAL_DIR_LOCATOR_SIG = 0x07064b50;
-// Versions
-export const VERSION_NEEDED = 20; // 2.0 - supports DEFLATE
-export const VERSION_MADE_BY = 20; // 2.0
-// Compression methods
-export const COMPRESSION_STORE = 0;
-export const COMPRESSION_DEFLATE = 8;
-// General purpose bit flags
-export const FLAG_UTF8 = 0x0800;
-export const FLAG_DATA_DESCRIPTOR = 0x0008;
-// ZIP64 / sentinel sizes
-export const UINT16_MAX = 0xffff;
-export const UINT32_MAX = 0xffffffff;
-export const ZIP_LOCAL_FILE_HEADER_FIXED_SIZE = 30;
-export const ZIP_CENTRAL_DIR_HEADER_FIXED_SIZE = 46;
-export const ZIP_END_OF_CENTRAL_DIR_FIXED_SIZE = 22;
-export function writeLocalFileHeaderInto(out, view, offset, input) {
-    const versionNeeded = input.versionNeeded ?? VERSION_NEEDED;
-    view.setUint32(offset + 0, 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 + ZIP_LOCAL_FILE_HEADER_FIXED_SIZE);
-    if (input.extraField.length > 0) {
-        out.set(input.extraField, offset + ZIP_LOCAL_FILE_HEADER_FIXED_SIZE + input.fileName.length);
-    }
-    return ZIP_LOCAL_FILE_HEADER_FIXED_SIZE + input.fileName.length + input.extraField.length;
-}
-export function buildLocalFileHeader(input) {
-    const header = new Uint8Array(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;
-}
-export function writeCentralDirectoryHeaderInto(out, view, offset, input) {
-    const versionMadeBy = input.versionMadeBy ?? VERSION_MADE_BY;
-    const versionNeeded = input.versionNeeded ?? VERSION_NEEDED;
-    const externalAttributes = input.externalAttributes ?? 0;
-    view.setUint32(offset + 0, 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 + ZIP_CENTRAL_DIR_HEADER_FIXED_SIZE);
-    if (input.extraField.length > 0) {
-        out.set(input.extraField, offset + ZIP_CENTRAL_DIR_HEADER_FIXED_SIZE + input.fileName.length);
-    }
-    if (input.comment.length > 0) {
-        out.set(input.comment, offset + ZIP_CENTRAL_DIR_HEADER_FIXED_SIZE + input.fileName.length + input.extraField.length);
-    }
-    return (ZIP_CENTRAL_DIR_HEADER_FIXED_SIZE +
-        input.fileName.length +
-        input.extraField.length +
-        input.comment.length);
-}
-export function buildCentralDirectoryHeader(input) {
-    const header = new Uint8Array(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;
-}
-export function writeEndOfCentralDirectoryInto(out, view, offset, input) {
-    view.setUint32(offset + 0, 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 + ZIP_END_OF_CENTRAL_DIR_FIXED_SIZE);
-    }
-    return ZIP_END_OF_CENTRAL_DIR_FIXED_SIZE + input.comment.length;
-}
-export function buildEndOfCentralDirectory(input) {
-    const record = new Uint8Array(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;
-}
-export function buildDataDescriptor(crc32, compressedSize, uncompressedSize) {
-    const descriptor = new Uint8Array(16);
-    const view = new DataView(descriptor.buffer);
-    view.setUint32(0, DATA_DESCRIPTOR_SIG, true);
-    view.setUint32(4, crc32, true);
-    view.setUint32(8, compressedSize, true);
-    view.setUint32(12, uncompressedSize, true);
-    return descriptor;
-}