@cj-tech-master/excelts 3.1.0 → 4.0.0

package/dist/types/utils/unzip/noop-stream.d.ts

@@ -1,13 +0,0 @@
-/**
- * Unzipper noop-stream module
- * Original source: https://github.com/ZJONSSON/node-unzipper
- * License: MIT
- * Copyright (c) 2012 - 2013 Near Infinity Corporation
- * Commits in this fork are (c) Ziggy Jonsson (ziggy.jonsson.nyc@gmail.com)
- */
-import { Transform } from "stream";
-import type { TransformCallback } from "stream";
-export declare class NoopStream extends Transform {
-    constructor();
-    _transform(_chunk: any, _encoding: BufferEncoding, cb: TransformCallback): void;
-}

package/dist/types/utils/unzip/parse-buffer.d.ts

@@ -1,24 +0,0 @@
-/**
- * Unzipper parse-buffer module
- * Original source: https://github.com/ZJONSSON/node-unzipper
- * License: MIT
- * Copyright (c) 2012 - 2013 Near Infinity Corporation
- * Commits in this fork are (c) Ziggy Jonsson (ziggy.jonsson.nyc@gmail.com)
- */
-/**
- * Parses sequential unsigned little endian numbers from the head of the passed buffer according to
- * the specified format passed. If the buffer is not large enough to satisfy the full format,
- * null values will be assigned to the remaining keys.
- * @param buffer The buffer to sequentially extract numbers from.
- * @param format Expected format to follow when extracting values from the buffer. A list of list entries
- * with the following structure:
- * [
- *   [
- *     <key>,  // Name of the key to assign the extracted number to.
- *     <size>  // The size in bytes of the number to extract. possible values are 1, 2, 4, 8.
- *   ],
- *   ...
- * ]
- * @returns An object with keys set to their associated extracted values.
- */
-export declare function parse(buffer: Buffer, format: [string, number][]): Record<string, number | null>;

package/dist/types/utils/unzip/parse-datetime.d.ts

@@ -1,12 +0,0 @@
-/**
- * Unzipper parse-datetime module
- * Original source: https://github.com/ZJONSSON/node-unzipper
- * License: MIT
- * Copyright (c) 2012 - 2013 Near Infinity Corporation
- * Commits in this fork are (c) Ziggy Jonsson (ziggy.jonsson.nyc@gmail.com)
- */
-/**
- * Dates in zip file entries are stored as DosDateTime
- * Spec is here: https://docs.microsoft.com/en-us/windows/win32/api/winbase/nf-winbase-dosdatetimetofiletime
- */
-export declare function parseDateTime(date: number, time?: number): Date;

package/dist/types/utils/unzip/parse-extra-field.d.ts

@@ -1,18 +0,0 @@
-/**
- * Unzipper parse-extra-field module
- * Original source: https://github.com/ZJONSSON/node-unzipper
- * License: MIT
- * Copyright (c) 2012 - 2013 Near Infinity Corporation
- * Commits in this fork are (c) Ziggy Jonsson (ziggy.jonsson.nyc@gmail.com)
- */
-export interface ZipVars {
-    uncompressedSize: number;
-    compressedSize: number;
-    offsetToLocalFileHeader?: number;
-}
-export interface ExtraField {
-    uncompressedSize?: number;
-    compressedSize?: number;
-    offsetToLocalFileHeader?: number;
-}
-export declare function parseExtraField(extraField: Buffer, vars: ZipVars): ExtraField;

package/dist/types/utils/unzip/parse.d.ts

@@ -1,70 +0,0 @@
-/**
- * Unzipper parse module
- * Original source: https://github.com/ZJONSSON/node-unzipper
- * License: MIT
- * Copyright (c) 2012 - 2013 Near Infinity Corporation
- * Commits in this fork are (c) Ziggy Jonsson (ziggy.jonsson.nyc@gmail.com)
- */
-import { PassThrough } from "stream";
-import { PullStream } from "./pull-stream";
-import { NoopStream } from "./noop-stream";
-import { type ExtraField } from "./parse-extra-field";
-export interface ParseOptions {
-    verbose?: boolean;
-    forceStream?: boolean;
-}
-export interface CrxHeader {
-    version: number | null;
-    pubKeyLength: number | null;
-    signatureLength: number | null;
-    publicKey?: Buffer;
-    signature?: Buffer;
-}
-export interface EntryVars {
-    versionsNeededToExtract: number | null;
-    flags: number | null;
-    compressionMethod: number | null;
-    lastModifiedTime: number | null;
-    lastModifiedDate: number | null;
-    crc32: number | null;
-    compressedSize: number;
-    uncompressedSize: number;
-    fileNameLength: number | null;
-    extraFieldLength: number | null;
-    lastModifiedDateTime?: Date;
-    crxHeader?: CrxHeader;
-}
-export interface EntryProps {
-    path: string;
-    pathBuffer: Buffer;
-    flags: {
-        isUnicode: boolean;
-    };
-}
-export interface ZipEntry extends PassThrough {
-    path: string;
-    props: EntryProps;
-    type: "Directory" | "File";
-    vars: EntryVars;
-    extra: ExtraField;
-    size?: number;
-    __autodraining?: boolean;
-    autodrain: () => NoopStream & {
-        promise: () => Promise<void>;
-    };
-    buffer: () => Promise<Buffer>;
-}
-export declare class Parse extends PullStream {
-    private _opts;
-    crxHeader?: CrxHeader;
-    reachedCD?: boolean;
-    constructor(opts?: ParseOptions);
-    private _readRecord;
-    private _readCrxHeader;
-    private _readFile;
-    private _processDataDescriptor;
-    private _readCentralDirectoryFileHeader;
-    private _readEndOfCentralDirectoryRecord;
-    promise(): Promise<void>;
-}
-export declare function createParse(opts?: ParseOptions): Parse;

package/dist/types/utils/unzip/pull-stream.d.ts

@@ -1,24 +0,0 @@
-/**
- * Unzipper pull-stream module
- * Original source: https://github.com/ZJONSSON/node-unzipper
- * License: MIT
- * Copyright (c) 2012 - 2013 Near Infinity Corporation
- * Commits in this fork are (c) Ziggy Jonsson (ziggy.jonsson.nyc@gmail.com)
- */
-import { Duplex, PassThrough } from "stream";
-export declare class PullStream extends Duplex {
-    buffer: Buffer;
-    cb?: () => void;
-    finished: boolean;
-    match?: number;
-    __emittedError?: Error;
-    constructor();
-    _write(chunk: Buffer, _encoding: BufferEncoding, cb: () => void): void;
-    _read(): void;
-    /**
-     * The `eof` parameter is interpreted as `file_length` if the type is number
-     * otherwise (i.e. buffer) it is interpreted as a pattern signaling end of stream
-     */
-    stream(eof: number | Buffer, includeEof?: boolean): PassThrough;
-    pull(eof: number | Buffer, includeEof?: boolean): Promise<Buffer>;
-}

package/dist/types/utils/unzip/zip-parser.d.ts

@@ -1,97 +0,0 @@
-/**
- * Pure Uint8Array-based ZIP parser
- * Works in both Node.js and browser environments
- * No dependency on Node.js stream module
- */
-/**
- * Parsed ZIP entry
- */
-export interface ZipEntryInfo {
-    /** File path within the ZIP */
-    path: string;
-    /** Whether this is a directory */
-    isDirectory: boolean;
-    /** Compressed size */
-    compressedSize: number;
-    /** Uncompressed size */
-    uncompressedSize: number;
-    /** Compression method (0 = stored, 8 = deflate) */
-    compressionMethod: number;
-    /** CRC-32 checksum */
-    crc32: number;
-    /** Last modified date */
-    lastModified: Date;
-    /** Offset to local file header */
-    localHeaderOffset: number;
-    /** File comment */
-    comment: string;
-    /** External file attributes */
-    externalAttributes: number;
-    /** Is encrypted */
-    isEncrypted: boolean;
-}
-/**
- * ZIP parsing options
- */
-export interface ZipParseOptions {
-    /** Whether to decode file names as UTF-8 (default: true) */
-    decodeStrings?: boolean;
-}
-/**
- * Parse ZIP file entries from Central Directory
- */
-export declare function parseZipEntries(data: Uint8Array, options?: ZipParseOptions): ZipEntryInfo[];
-/**
- * Extract file data for a specific entry
- */
-export declare function extractEntryData(data: Uint8Array, entry: ZipEntryInfo): Promise<Uint8Array>;
-/**
- * Extract file data synchronously (Node.js only)
- */
-export declare function extractEntryDataSync(data: Uint8Array, entry: ZipEntryInfo): Uint8Array;
-/**
- * High-level ZIP parser class
- */
-export declare class ZipParser {
-    private data;
-    private entries;
-    private entryMap;
-    constructor(data: Uint8Array | ArrayBuffer, options?: ZipParseOptions);
-    /**
-     * Get all entries in the ZIP file
-     */
-    getEntries(): ZipEntryInfo[];
-    /**
-     * Get entry by path
-     */
-    getEntry(path: string): ZipEntryInfo | undefined;
-    /**
-     * Check if entry exists
-     */
-    hasEntry(path: string): boolean;
-    /**
-     * List all file paths
-     */
-    listFiles(): string[];
-    /**
-     * Extract a single file (async)
-     */
-    extract(path: string): Promise<Uint8Array | null>;
-    /**
-     * Extract a single file (sync, Node.js only)
-     */
-    extractSync(path: string): Uint8Array | null;
-    /**
-     * Extract all files (async)
-     */
-    extractAll(): Promise<Map<string, Uint8Array>>;
-    /**
-     * Extract all files (sync, Node.js only)
-     * Returns object with file paths as keys and Uint8Array content as values
-     */
-    extractAllSync(): Record<string, Uint8Array>;
-    /**
-     * Iterate over entries with async callback
-     */
-    forEach(callback: (entry: ZipEntryInfo, getData: () => Promise<Uint8Array>) => Promise<boolean | void>): Promise<void>;
-}

package/dist/types/utils/zip/compress.base.d.ts

@@ -1,45 +0,0 @@
-/**
- * Base compression utilities using Web Streams API
- * Shared between Node.js and Browser implementations
- *
- * Uses CompressionStream/DecompressionStream API with "deflate-raw" format
- * (raw DEFLATE without zlib header/trailer, required for ZIP files)
- *
- * Browser fallback: For browsers without deflate-raw support (Firefox < 113, Safari < 16.4),
- * see deflate-fallback.ts for pure JS implementation
- */
-/**
- * Compression options
- */
-export interface CompressOptions {
-    /**
-     * Compression level (0-9)
-     * - 0: No compression (STORE)
-     * - 1: Fastest compression
-     * - 6: Default compression (good balance)
-     * - 9: Best compression (slowest)
-     *
-     * Note: CompressionStream does not support level configuration,
-     * it uses a fixed level (~6)
-     */
-    level?: number;
-}
-/**
- * Check if CompressionStream is available
- */
-export declare function hasCompressionStream(): boolean;
-/**
- * Compress using CompressionStream API
- * Uses "deflate-raw" format (required for ZIP files)
- *
- * @param data - Data to compress
- * @returns Compressed data
- */
-export declare function compressWithStream(data: Uint8Array): Promise<Uint8Array>;
-/**
- * Decompress using DecompressionStream API
- *
- * @param data - Compressed data (deflate-raw format)
- * @returns Decompressed data
- */
-export declare function decompressWithStream(data: Uint8Array): Promise<Uint8Array>;

package/dist/types/utils/zip/compress.browser.d.ts

@@ -1,63 +0,0 @@
-/**
- * Browser compression utilities
- *
- * Primary: CompressionStream API (Chrome 103+, Firefox 113+, Safari 16.4+)
- * Fallback: Pure JS DEFLATE implementation for older browsers
- *
- * Supported browsers with fallback:
- * - Chrome >= 85
- * - Firefox >= 79
- * - Safari >= 14
- * - Edge >= 85
- */
-import { type CompressOptions } from "./compress.base";
-export { type CompressOptions };
-/**
- * Check if CompressionStream with "deflate-raw" is available
- * Note: Chrome 80-102 has CompressionStream but not deflate-raw support
- */
-export declare function hasCompressionStream(): boolean;
-/**
- * Check if native zlib is available (always false in browser)
- */
-export declare function hasNativeZlib(): boolean;
-/**
- * Compress data using browser's native CompressionStream or JS fallback
- *
- * @param data - Data to compress
- * @param options - Compression options
- * @returns Compressed data
- *
- * @example
- * ```ts
- * const data = new TextEncoder().encode("Hello, World!");
- * const compressed = await compress(data, { level: 6 });
- * ```
- */
-export declare function compress(data: Uint8Array, options?: {
-    level?: number;
-}): Promise<Uint8Array>;
-/**
- * Compress data synchronously using pure JS implementation
- *
- * @param data - Data to compress
- * @param options - Compression options
- * @returns Compressed data
- */
-export declare function compressSync(data: Uint8Array, options?: {
-    level?: number;
-}): Uint8Array;
-/**
- * Decompress data using browser's native DecompressionStream or JS fallback
- *
- * @param data - Compressed data (deflate-raw format)
- * @returns Decompressed data
- */
-export declare function decompress(data: Uint8Array): Promise<Uint8Array>;
-/**
- * Decompress data synchronously using pure JS implementation
- *
- * @param data - Compressed data (deflate-raw format)
- * @returns Decompressed data
- */
-export declare function decompressSync(data: Uint8Array): Uint8Array;

package/dist/types/utils/zip/compress.d.ts

@@ -1,51 +0,0 @@
-/**
- * Node.js compression utilities using native zlib
- *
- * Uses zlib module (C++ implementation, fastest) with "deflate-raw" format
- * (raw DEFLATE without zlib header/trailer, required for ZIP files)
- */
-export { type CompressOptions, hasCompressionStream } from "./compress.base";
-/**
- * Check if native zlib is available (always true in Node.js)
- */
-export declare function hasNativeZlib(): boolean;
-/**
- * Compress data using Node.js native zlib
- *
- * @param data - Data to compress
- * @param options - Compression options
- * @returns Compressed data
- *
- * @example
- * ```ts
- * const data = new TextEncoder().encode("Hello, World!");
- * const compressed = await compress(data, { level: 6 });
- * ```
- */
-export declare function compress(data: Uint8Array, options?: {
-    level?: number;
-}): Promise<Uint8Array>;
-/**
- * Compress data synchronously using Node.js zlib
- *
- * @param data - Data to compress
- * @param options - Compression options
- * @returns Compressed data
- */
-export declare function compressSync(data: Uint8Array, options?: {
-    level?: number;
-}): Uint8Array;
-/**
- * Decompress data using Node.js native zlib
- *
- * @param data - Compressed data (deflate-raw format)
- * @returns Decompressed data
- */
-export declare function decompress(data: Uint8Array): Promise<Uint8Array>;
-/**
- * Decompress data synchronously using Node.js zlib
- *
- * @param data - Compressed data (deflate-raw format)
- * @returns Decompressed data
- */
-export declare function decompressSync(data: Uint8Array): Uint8Array;

package/dist/types/utils/zip/crc32.browser.d.ts

@@ -1,52 +0,0 @@
-/**
- * CRC32 calculation utility for ZIP files (Browser version)
- *
- * Uses lookup table optimization - no Node.js dependencies
- *
- * 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
- */
-/**
- * Calculate CRC32 checksum for the given data
- *
- * @param data - Input data as Uint8Array
- * @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 declare function crc32(data: Uint8Array): number;
-/**
- * Ensure CRC32 is ready (no-op in browser, for API compatibility)
- */
-export declare function ensureCrc32(): Promise<void>;
-/**
- * Calculate CRC32 incrementally (useful for streaming)
- * Call with initial crc of 0xffffffff, then finalize with crc32Finalize
- *
- * @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 declare function crc32Update(crc: number, data: Uint8Array): number;
-/**
- * Finalize CRC32 calculation
- * XOR with 0xffffffff and convert to unsigned 32-bit
- *
- * @param crc - CRC value from crc32Update
- * @returns Final CRC32 checksum
- */
-export declare function crc32Finalize(crc: number): number;

package/dist/types/utils/zip/crc32.d.ts

@@ -1,55 +0,0 @@
-/**
- * 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
- */
-/**
- * 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 declare function crc32(data: Uint8Array): number;
-/**
- * Ensure zlib is loaded (for use before calling crc32)
- */
-export declare function ensureCrc32(): Promise<void>;
-/**
- * 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 declare function crc32Update(crc: number, data: Uint8Array): number;
-/**
- * Finalize CRC32 calculation
- * XOR with 0xffffffff and convert to unsigned 32-bit
- *
- * @param crc - CRC value from crc32Update
- * @returns Final CRC32 checksum
- */
-export declare function crc32Finalize(crc: number): number;

package/dist/types/utils/zip/index.d.ts

@@ -1,52 +0,0 @@
-/**
- * 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";
- *
- * 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";
- *
- * 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);
- * }
- * ```
- */
-export { crc32, crc32Update, crc32Finalize } from "./crc32";
-export { compress, compressSync, decompress, decompressSync, hasNativeZlib, hasCompressionStream, type CompressOptions } from "./compress";
-export { createZip, createZipSync, ZipBuilder, type ZipEntry, type ZipOptions } from "./zip-builder";

package/dist/types/utils/zip/streaming-zip.d.ts

@@ -1,96 +0,0 @@
-/**
- * Streaming ZIP creator - fflate-compatible API
- *
- * This module provides a streaming ZIP API compatible with fflate's Zip/ZipDeflate,
- * but uses native zlib compression for better performance.
- *
- * Usage:
- * ```ts
- * const zip = new StreamingZip((err, data, final) => {
- *   if (err) handleError(err);
- *   else {
- *     stream.write(data);
- *     if (final) stream.end();
- *   }
- * });
- *
- * const file = new ZipDeflateFile("path/file.txt", { level: 6 });
- * zip.add(file);
- * file.push(data1);
- * file.push(data2, true); // true = final chunk
- *
- * zip.end();
- * ```
- */
-/**
- * Internal entry info for central directory
- */
-interface ZipEntryInfo {
-    name: Uint8Array;
-    crc: number;
-    compressedSize: number;
-    uncompressedSize: number;
-    compressionMethod: number;
-    dosTime: number;
-    dosDate: number;
-    offset: number;
-}
-/**
- * ZipDeflate-compatible file stream
- * Collects data chunks, compresses on finalization
- */
-export declare class ZipDeflateFile {
-    private chunks;
-    private totalSize;
-    private finalized;
-    private _ondata;
-    readonly name: string;
-    readonly level: number;
-    constructor(name: string, options?: {
-        level?: number;
-    });
-    /**
-     * Set data callback (called by StreamingZip)
-     */
-    set ondata(cb: (data: Uint8Array, final: boolean) => void);
-    /**
-     * Push data to the file
-     * @param data - Data chunk
-     * @param final - Whether this is the final chunk
-     */
-    push(data: Uint8Array, final?: boolean): void;
-    /**
-     * Flush collected data through compression and emit
-     */
-    private _flush;
-    /**
-     * Get entry info (called by StreamingZip after finalization)
-     */
-    getEntryInfo(): ZipEntryInfo | null;
-}
-/**
- * Streaming ZIP - fflate Zip-compatible API
- * Creates ZIP files in a streaming manner
- */
-export declare class StreamingZip {
-    private callback;
-    private entries;
-    private currentOffset;
-    private ended;
-    /**
-     * Create a streaming ZIP
-     * @param callback - Called with (err, data, final) as data becomes available
-     */
-    constructor(callback: (err: Error | null, data: Uint8Array, final: boolean) => void);
-    /**
-     * Add a file to the ZIP
-     * @param file - ZipDeflateFile instance
-     */
-    add(file: ZipDeflateFile): void;
-    /**
-     * Finalize the ZIP
-     * Writes central directory and end-of-central-directory record
-     */
-    end(): void;
-}
-export { StreamingZip as Zip, ZipDeflateFile as ZipDeflate };