@cj-tech-master/excelts 4.2.0 → 4.2.1-canary.20260112134913.a3cecdd

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

@@ -1,292 +0,0 @@
-/**
- * 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 { compress, compressSync } from "./compress.js";
-import { crc32 } from "./crc32.js";
-import { concatUint8Arrays, sumUint8ArrayLengths } from "./utils/bytes.js";
-import {} from "./utils/timestamps.js";
-import { buildZipEntryMetadata, resolveZipCompressionMethod } from "./zip-entry-metadata.js";
-import { DEFAULT_ZIP_LEVEL, DEFAULT_ZIP_TIMESTAMPS } from "./defaults.js";
-import { buildCentralDirectoryHeader, buildEndOfCentralDirectory, buildLocalFileHeader } from "./zip-records.js";
-import { FLAG_UTF8, VERSION_MADE_BY, VERSION_NEEDED } from "./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 = 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: crc32(entry.data),
-        compressionMethod: 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 concatUint8Arrays(chunks);
-}
-function buildLocalFileHeaderChunk(entry) {
-    return buildLocalFileHeader({
-        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.data.length,
-        versionNeeded: VERSION_NEEDED
-    });
-}
-function buildCentralDirHeaderChunk(entry) {
-    return buildCentralDirectoryHeader({
-        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.data.length,
-        localHeaderOffset: entry.offset,
-        versionMadeBy: VERSION_MADE_BY,
-        versionNeeded: VERSION_NEEDED
-    });
-}
-function buildCentralDirectorySection(processedEntries, centralDirOffset, zipComment) {
-    const chunks = [];
-    for (const entry of processedEntries) {
-        chunks.push(buildCentralDirHeaderChunk(entry));
-    }
-    const centralDirSize = sumUint8ArrayLengths(chunks);
-    chunks.push(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 });
- * ```
- */
-export async function createZip(entries, options = {}) {
-    const level = options.level ?? DEFAULT_ZIP_LEVEL;
-    const timestamps = options.timestamps ?? 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) ? 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.
- */
-export function createZipSync(entries, options = {}) {
-    const level = options.level ?? DEFAULT_ZIP_LEVEL;
-    const timestamps = options.timestamps ?? 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)
-            ? 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
- */
-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 ?? DEFAULT_ZIP_LEVEL;
-        this.zipComment = encodeZipComment(options.comment);
-        this.timestamps = options.timestamps ?? 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 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)
-            ? 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;
-    }
-}

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

@@ -1,23 +0,0 @@
-/**
- * ZIP format constants (PKWARE APPNOTE)
- * Shared by ZIP writer and parser implementations.
- */
-// 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;

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

@@ -1,84 +0,0 @@
-/**
- * ZIP record builders (PKWARE APPNOTE)
- *
- * Shared by streaming zip writer and buffer zip builder.
- */
-import { CENTRAL_DIR_HEADER_SIG, DATA_DESCRIPTOR_SIG, END_OF_CENTRAL_DIR_SIG, LOCAL_FILE_HEADER_SIG, VERSION_MADE_BY, VERSION_NEEDED } from "./zip-constants.js";
-export function buildLocalFileHeader(input) {
-    const versionNeeded = input.versionNeeded ?? VERSION_NEEDED;
-    const header = new Uint8Array(30 + input.fileName.length + input.extraField.length);
-    const view = new DataView(header.buffer);
-    view.setUint32(0, 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;
-}
-export function buildCentralDirectoryHeader(input) {
-    const versionMadeBy = input.versionMadeBy ?? VERSION_MADE_BY;
-    const versionNeeded = input.versionNeeded ?? 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, 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;
-}
-export function buildEndOfCentralDirectory(input) {
-    const record = new Uint8Array(22 + input.comment.length);
-    const view = new DataView(record.buffer);
-    view.setUint32(0, 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;
-}
-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;
-}

package/dist/types/modules/archive/byte-queue.d.ts

@@ -1,18 +0,0 @@
-export declare class ByteQueue {
-    private static readonly EMPTY;
-    private _buf;
-    private _start;
-    private _end;
-    private _cachedView;
-    private _cachedBuf;
-    private _cachedStart;
-    private _cachedEnd;
-    constructor(initial?: Uint8Array);
-    get length(): number;
-    isEmpty(): boolean;
-    view(): Uint8Array;
-    reset(data?: Uint8Array): void;
-    append(chunk: Uint8Array): void;
-    read(length: number): Uint8Array;
-    discard(length: number): void;
-}

package/dist/types/modules/archive/utils/zip-extra.d.ts

@@ -1,18 +0,0 @@
-export declare function unixSecondsFromDate(date: Date): number;
-/**
- * Build Info-ZIP "Extended Timestamp" extra field (0x5455).
- * We write only mtime (UTC, Unix seconds) to minimize size.
- *
- * Layout:
- * - Header ID: 2 bytes (0x5455)
- * - Data size: 2 bytes
- * - Flags: 1 byte (bit0 = mtime)
- * - mtime: 4 bytes (Unix seconds)
- */
-export declare function buildExtendedTimestampExtraFieldFromUnixSeconds(unixSeconds: number): Uint8Array;
-export declare function buildExtendedTimestampExtraFieldFromDate(date: Date): Uint8Array;
-/**
- * Parse Info-ZIP "Extended Timestamp" extra field (0x5455) and return mtime.
- * Returns Unix seconds (UTC) if present.
- */
-export declare function parseExtendedTimestampMtimeUnixSeconds(extraField: Uint8Array): number | undefined;

package/dist/types/modules/archive/zip-builder.d.ts

@@ -1,117 +0,0 @@
-/**
- * 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 { type CompressOptions } from "./compress.js";
-import { type ZipTimestampMode } from "./utils/timestamps.js";
-/**
- * ZIP file entry
- */
-export interface ZipEntry {
-    /** File name (can include directory path, use forward slashes) */
-    name: string;
-    /** File data (will be compressed unless level=0) */
-    data: Uint8Array;
-    /** File modification time (optional, defaults to current time) */
-    modTime?: Date;
-    /** File comment (optional) */
-    comment?: string;
-}
-/**
- * ZIP builder options
- */
-export interface ZipOptions extends CompressOptions {
-    /** ZIP file comment (optional) */
-    comment?: string;
-    /**
-     * Timestamp writing strategy.
-     * - "dos": only write DOS date/time fields (smallest output)
-     * - "dos+utc": also write UTC mtime in 0x5455 extra field (default, best practice)
-     */
-    timestamps?: ZipTimestampMode;
-}
-/**
- * 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 declare function createZip(entries: ZipEntry[], options?: ZipOptions): Promise<Uint8Array>;
-/**
- * Create a ZIP file from entries (sync)
- *
- * This is supported in both Node.js and browser builds.
- */
-export declare function createZipSync(entries: ZipEntry[], options?: ZipOptions): Uint8Array;
-/**
- * Streaming ZIP builder for large files
- * Writes chunks to a callback as they are generated
- */
-export declare class ZipBuilder {
-    private entries;
-    private currentOffset;
-    private level;
-    private zipComment;
-    private timestamps;
-    private compressOptions;
-    private settings;
-    private finalized;
-    /**
-     * Create a new ZIP builder
-     * @param options - ZIP options
-     */
-    constructor(options?: ZipOptions);
-    /**
-     * Add a file to the ZIP (async)
-     * @param entry - File entry
-     * @returns Local file header and compressed data chunks
-     */
-    addFile(entry: ZipEntry): Promise<Uint8Array[]>;
-    /**
-     * Add a file to the ZIP (sync)
-     * @param entry - File entry
-     * @returns Local file header and compressed data chunks
-     */
-    addFileSync(entry: ZipEntry): Uint8Array[];
-    /**
-     * Finalize the ZIP and return central directory + end record
-     * @returns Central directory and end of central directory chunks
-     */
-    finalize(): Uint8Array[];
-    /**
-     * Get current number of entries
-     */
-    get entryCount(): number;
-    /**
-     * Get current ZIP data size (without central directory)
-     */
-    get dataSize(): number;
-}

package/dist/types/modules/archive/zip-constants.d.ts

@@ -1,18 +0,0 @@
-/**
- * ZIP format constants (PKWARE APPNOTE)
- * Shared by ZIP writer and parser implementations.
- */
-export declare const LOCAL_FILE_HEADER_SIG = 67324752;
-export declare const CENTRAL_DIR_HEADER_SIG = 33639248;
-export declare const END_OF_CENTRAL_DIR_SIG = 101010256;
-export declare const DATA_DESCRIPTOR_SIG = 134695760;
-export declare const ZIP64_END_OF_CENTRAL_DIR_SIG = 101075792;
-export declare const ZIP64_END_OF_CENTRAL_DIR_LOCATOR_SIG = 117853008;
-export declare const VERSION_NEEDED = 20;
-export declare const VERSION_MADE_BY = 20;
-export declare const COMPRESSION_STORE = 0;
-export declare const COMPRESSION_DEFLATE = 8;
-export declare const FLAG_UTF8 = 2048;
-export declare const FLAG_DATA_DESCRIPTOR = 8;
-export declare const UINT16_MAX = 65535;
-export declare const UINT32_MAX = 4294967295;