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

package/THIRD_PARTY_NOTICES.md

@@ -62,6 +62,37 @@ SOFTWARE.
 
 ## Third-party component
 
+unzipper is licensed under the MIT License:
+
+The MIT License (MIT)
+
+Copyright (c) 2012 - 2013 Near Infinity Corporation
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+Commits in this fork are (c) Ziggy Jonsson (ziggy.jonsson.nyc@gmail.com) and
+fall under same licence structure as the original repo (MIT).
+
+---
+
+## Third-party component
+
 saxes is licensed under the ISC License:
 
 The ISC License

package/dist/browser/index.browser.d.ts

@@ -25,4 +25,3 @@ export { WorkbookWriter, WorkbookReader, WorksheetWriter, WorksheetReader };
 export type { CsvReadOptions, CsvWriteOptions, CsvStreamReadOptions, CsvStreamWriteOptions } from "@csv/csv.browser";
 export { CsvParserStream, CsvFormatterStream } from "@csv/csv.browser";
 export * from "@excel/utils/sheet-utils";
-export { zip, unzip, ZipArchive, ZipReader, UnzipEntry, type ZipOptions, type ZipEntryOptions, type UnzipOptions, type ArchiveSource, type ArchiveSink, crc32, crc32Update, crc32Finalize, compress, compressSync, decompress, decompressSync, hasCompressionStream, type CompressOptions, createDeflateStream, createInflateStream, hasDeflateRaw, type StreamCompressOptions } from "@archive/index.browser";

package/dist/browser/index.browser.js

@@ -39,15 +39,3 @@ export { CsvParserStream, CsvFormatterStream } from "./modules/csv/csv.browser.j
 // Utilities
 // =============================================================================
 export * from "./modules/excel/utils/sheet-utils.js";
-// =============================================================================
-// Archive (ZIP) support (Browser-compatible)
-// =============================================================================
-export { 
-// High-level archive API
-zip, unzip, ZipArchive, ZipReader, UnzipEntry, 
-// CRC32
-crc32, crc32Update, crc32Finalize, 
-// Compression utilities
-compress, compressSync, decompress, decompressSync, hasCompressionStream, 
-// Streaming compression
-createDeflateStream, createInflateStream, hasDeflateRaw } from "./modules/archive/index.browser.js";

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

@@ -0,0 +1,18 @@
+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/browser/modules/archive/byte-queue.js

@@ -0,0 +1,125 @@
+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);

package/dist/browser/modules/archive/{compression/compress.base.js → compress.base.js}

@@ -8,7 +8,7 @@
  * Browser fallback: For browsers without deflate-raw support (Firefox < 113, Safari < 16.4),
  * see deflate-fallback.ts for pure JS implementation
  */
-import { ByteQueue } from "../internal/byte-queue.js";
+import { ByteQueue } from "./byte-queue.js";
 /**
  * Default threshold (in bytes) to choose the lower-overhead path.
  *

package/dist/browser/modules/archive/{compression/compress.browser.d.ts → compress.browser.d.ts}

@@ -10,9 +10,15 @@
  * - Safari >= 14.1
  * - Edge >= 89
  */
-import { type CompressOptions, hasCompressionStream } from "@archive/compression/compress.base";
+import { type CompressOptions } from "@archive/compress.base";
 export { type CompressOptions };
-export { hasCompressionStream };
+/**
+ * Check if CompressionStream is available in this environment.
+ *
+ * Note: Some environments may expose CompressionStream but not support
+ * the "deflate-raw" format that ZIP requires.
+ */
+export declare function hasCompressionStream(): boolean;
 /**
  * Compress data using browser's native CompressionStream or JS fallback
  *

package/dist/{esm/modules/archive/compression → browser/modules/archive}/compress.browser.js

@@ -10,12 +10,20 @@
  * - Safari >= 14.1
  * - Edge >= 89
  */
-import { compressWithStream, decompressWithStream, hasCompressionStream, hasDeflateRawCompressionStream, hasDeflateRawDecompressionStream } from "./compress.base.js";
+import { compressWithStream, decompressWithStream, hasDeflateRawCompressionStream, hasDeflateRawDecompressionStream } from "./compress.base.js";
 import { inflateRaw, deflateRawCompressed } from "./deflate-fallback.js";
-import { DEFAULT_COMPRESS_LEVEL } from "../defaults.js";
+import { DEFAULT_COMPRESS_LEVEL } from "./defaults.js";
 // Re-export shared types
 export {};
-export { hasCompressionStream };
+/**
+ * Check if CompressionStream is available in this environment.
+ *
+ * Note: Some environments may expose CompressionStream but not support
+ * the "deflate-raw" format that ZIP requires.
+ */
+export function hasCompressionStream() {
+    return typeof CompressionStream !== "undefined";
+}
 /**
  * Compress data using browser's native CompressionStream or JS fallback
  *

package/dist/browser/modules/archive/{compression/compress.d.ts → compress.d.ts}

@@ -4,8 +4,8 @@
  * 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 "@archive/compression/compress.base";
-import type { CompressOptions } from "@archive/compression/compress.base";
+export { type CompressOptions, hasCompressionStream } from "@archive/compress.base";
+import type { CompressOptions } from "@archive/compress.base";
 /**
  * Compress data using Node.js native zlib
  *

package/dist/{esm/modules/archive/compression → browser/modules/archive}/compress.js

@@ -6,7 +6,7 @@
  */
 import { promisify } from "util";
 import * as zlib from "zlib";
-import { DEFAULT_COMPRESS_LEVEL } from "../defaults.js";
+import { DEFAULT_COMPRESS_LEVEL } from "./defaults.js";
 // Re-export shared types and utilities
 export { hasCompressionStream } from "./compress.base.js";
 function uint8ArrayToBufferView(data) {

package/dist/browser/modules/archive/{compression/crc32.browser.d.ts → crc32.browser.d.ts}

@@ -7,7 +7,7 @@
  * 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
  */
-export { crc32JS as crc32, crc32UpdateJS as crc32Update, crc32Finalize } from "@archive/compression/crc32.base";
+export { crc32JS as crc32, crc32UpdateJS as crc32Update, crc32Finalize } from "@archive/crc32.base";
 /**
  * Ensure CRC32 is ready (no-op in browser, for API compatibility)
  */

package/dist/browser/modules/archive/{compression/crc32.d.ts → crc32.d.ts}

@@ -8,7 +8,7 @@
  * 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
  */
-import { crc32Finalize } from "@archive/compression/crc32.base";
+import { crc32Finalize } from "@archive/crc32.base";
 /**
  * Calculate CRC32 checksum for the given data
  * Uses native zlib.crc32 in Node.js for ~100x better performance

package/dist/browser/modules/archive/{compression/crc32.js → crc32.js}

@@ -8,7 +8,7 @@
  * 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
  */
-import { isNode } from "../../../utils/env.js";
+import { isNode } from "../../utils/env.js";
 import { crc32JS, crc32UpdateJS, crc32Finalize } from "./crc32.base.js";
 // Lazy-loaded zlib module for Node.js
 let _zlib = null;

package/dist/browser/modules/archive/defaults.d.ts

@@ -1,5 +1,4 @@
 import type { ZipTimestampMode } from "@archive/utils/timestamps";
-export declare const DEFAULT_DEFLATE_LEVEL = 6;
 export declare const DEFAULT_COMPRESS_LEVEL = 6;
 export declare const DEFAULT_ZIP_LEVEL = 6;
 export declare const DEFAULT_ZIP_TIMESTAMPS: ZipTimestampMode;

package/dist/browser/modules/archive/defaults.js

@@ -1,6 +1,3 @@
-export const DEFAULT_DEFLATE_LEVEL = 6;
-// Backward-compatible aliases (avoid default drift across modules).
-export const DEFAULT_COMPRESS_LEVEL = DEFAULT_DEFLATE_LEVEL;
-export const DEFAULT_ZIP_LEVEL = DEFAULT_DEFLATE_LEVEL;
-// Prefer reproducible output by default: omit the Info-ZIP UTC mtime extra field.
-export const DEFAULT_ZIP_TIMESTAMPS = "dos";
+export const DEFAULT_COMPRESS_LEVEL = 6;
+export const DEFAULT_ZIP_LEVEL = 6;
+export const DEFAULT_ZIP_TIMESTAMPS = "dos+utc";

package/dist/browser/modules/archive/{compression/deflate-fallback.js → deflate-fallback.js}

@@ -10,7 +10,7 @@
  * - Safari < 16.4
  * - Chrome < 103
  */
-import { concatUint8Arrays } from "../utils/bytes.js";
+import { concatUint8Arrays } from "./utils/bytes.js";
 // ============================================================================
 // DEFLATE Decompression (Full implementation)
 // ============================================================================

package/dist/browser/modules/archive/{unzip/extract.d.ts → extract.d.ts}

@@ -3,7 +3,7 @@
  * Provides easy-to-use Promise-based API for extracting ZIP files
  * Works in both Node.js and browser environments
  */
-import { type ZipEntryInfo } from "@archive/unzip/zip-parser";
+import { type ZipEntryInfo } from "@archive/zip-parser";
 /**
  * Extracted file entry
  */
@@ -91,4 +91,4 @@ export declare function listFiles(zipData: Uint8Array | ArrayBuffer): Promise<st
  * ```
  */
 export declare function forEachEntry(zipData: Uint8Array | ArrayBuffer, callback: (path: string, getData: () => Promise<Uint8Array>, entry: ZipEntryInfo) => Promise<boolean | void>): Promise<void>;
-export { ZipParser, type ZipEntryInfo, type ZipParseOptions } from "@archive/unzip/zip-parser";
+export { ZipParser, type ZipEntryInfo, type ZipParseOptions } from "@archive/zip-parser";

package/dist/browser/modules/archive/index.base.d.ts

@@ -5,7 +5,7 @@
  * Platform-specific entrypoints (index.ts / index.browser.ts) should re-export
  * from this file and then layer their platform-specific bindings.
  */
-export type { ArchiveSource } from "@archive/io/archive-source";
-export type { ArchiveSink } from "@archive/io/archive-sink";
-export { zip, ZipArchive, type ZipOptions, type ZipEntryOptions } from "@archive/zip";
-export { unzip, ZipReader, UnzipEntry, type UnzipOptions } from "@archive/unzip";
+export { createZip, createZipSync, ZipBuilder, type ZipEntry, type ZipOptions } from "@archive/zip-builder";
+export { StreamingZip, ZipDeflateFile, Zip, ZipDeflate } from "@archive/streaming-zip";
+export { extractAll, extractFile, listFiles, forEachEntry, ZipParser, type ExtractedFile, type ZipParseOptions } from "@archive/extract";
+export type { ZipEntryInfo } from "@archive/zip-entry-info";

package/dist/browser/modules/archive/index.base.js

@@ -5,6 +5,9 @@
  * Platform-specific entrypoints (index.ts / index.browser.ts) should re-export
  * from this file and then layer their platform-specific bindings.
  */
-// High-level APIs
-export { zip, ZipArchive } from "./zip/index.js";
-export { unzip, ZipReader, UnzipEntry } from "./unzip/index.js";
+// ZIP builders
+export { createZip, createZipSync, ZipBuilder } from "./zip-builder.js";
+// Streaming ZIP (fflate-like API)
+export { StreamingZip, ZipDeflateFile, Zip, ZipDeflate } from "./streaming-zip.js";
+// Buffer-based unzip API (cross-platform)
+export { extractAll, extractFile, listFiles, forEachEntry, ZipParser } from "./extract.js";

package/dist/browser/modules/archive/index.browser.d.ts

@@ -5,6 +5,7 @@
  * browser-specific implementations so we can enforce export-surface parity.
  */
 export * from "@archive/index.base";
-export { crc32, crc32Update, crc32Finalize } from "@archive/compression/crc32.browser";
-export { compress, compressSync, decompress, decompressSync, hasCompressionStream, type CompressOptions } from "@archive/compression/compress.browser";
-export { createDeflateStream, createInflateStream, hasDeflateRaw, type StreamCompressOptions } from "@archive/compression/streaming-compress.browser";
+export { crc32, crc32Update, crc32Finalize } from "@archive/crc32.browser";
+export { compress, compressSync, decompress, decompressSync, hasCompressionStream, type CompressOptions } from "@archive/compress.browser";
+export { createDeflateStream, createInflateStream, hasDeflateRaw, type StreamCompressOptions } from "@archive/streaming-compress.browser";
+export { Parse, createParse, type ParseOptions, type ZipEntry as StreamZipEntry } from "@archive/parse.browser";

package/dist/browser/modules/archive/index.browser.js

@@ -6,8 +6,12 @@
  */
 export * from "./index.base.js";
 // CRC32
-export { crc32, crc32Update, crc32Finalize } from "./compression/crc32.browser.js";
+export { crc32, crc32Update, crc32Finalize } from "./crc32.browser.js";
 // Compression
-export { compress, compressSync, decompress, decompressSync, hasCompressionStream } from "./compression/compress.browser.js";
+export { compress, compressSync, decompress, decompressSync, hasCompressionStream } from "./compress.browser.js";
 // Streaming compression
-export { createDeflateStream, createInflateStream, hasDeflateRaw } from "./compression/streaming-compress.browser.js";
+export { createDeflateStream, createInflateStream, hasDeflateRaw } from "./streaming-compress.browser.js";
+// Stream-based unzip API (browser implementation)
+export { Parse, createParse } from "./parse.browser.js";
+// Buffer-based unzip API (cross-platform)
+// (re-exported from ./index.base)

package/dist/browser/modules/archive/index.d.ts

@@ -5,6 +5,7 @@
  * It groups all ZIP creation and extraction utilities in one place.
  */
 export * from "@archive/index.base";
-export { crc32, crc32Update, crc32Finalize } from "@archive/compression/crc32";
-export { compress, compressSync, decompress, decompressSync, hasCompressionStream, type CompressOptions } from "@archive/compression/compress";
-export { createDeflateStream, createInflateStream, hasDeflateRaw, type StreamCompressOptions } from "@archive/compression/streaming-compress";
+export { crc32, crc32Update, crc32Finalize } from "@archive/crc32";
+export { compress, compressSync, decompress, decompressSync, hasCompressionStream, type CompressOptions } from "@archive/compress";
+export { createDeflateStream, createInflateStream, hasDeflateRaw, type StreamCompressOptions } from "@archive/streaming-compress";
+export { Parse, createParse, type ParseOptions, type ZipEntry as StreamZipEntry } from "@archive/parse";

package/dist/browser/modules/archive/index.js

@@ -6,8 +6,10 @@
  */
 export * from "./index.base.js";
 // CRC32
-export { crc32, crc32Update, crc32Finalize } from "./compression/crc32.browser.js";
+export { crc32, crc32Update, crc32Finalize } from "./crc32.browser.js";
 // Compression
-export { compress, compressSync, decompress, decompressSync, hasCompressionStream } from "./compression/compress.browser.js";
+export { compress, compressSync, decompress, decompressSync, hasCompressionStream } from "./compress.browser.js";
 // Streaming compression
-export { createDeflateStream, createInflateStream, hasDeflateRaw } from "./compression/streaming-compress.browser.js";
+export { createDeflateStream, createInflateStream, hasDeflateRaw } from "./streaming-compress.browser.js";
+// Stream-based unzip API (Node.js; browser build aliases to ./parse.browser.ts)
+export { Parse, createParse } from "./parse.browser.js";

package/dist/browser/modules/archive/{unzip/stream.base.d.ts → parse.base.d.ts}

@@ -1,7 +1,6 @@
 import { Duplex, PassThrough, Transform, type Readable } from "@stream";
-import { ByteQueue } from "@archive/internal/byte-queue";
+import { ByteQueue } from "@archive/byte-queue";
 import { parseZipExtraFields, type ZipExtraFields, type ZipVars } from "@archive/utils/zip-extra-fields";
-export declare const DATA_DESCRIPTOR_SIGNATURE_BYTES: Uint8Array<ArrayBufferLike>;
 export declare const CRX_HEADER_FORMAT: [string, number][];
 export declare const LOCAL_FILE_HEADER_FORMAT: [string, number][];
 export declare const DATA_DESCRIPTOR_FORMAT: [string, number][];
@@ -120,14 +119,9 @@ export interface ValidatedDataDescriptorScanResult {
  */
 export declare function scanValidatedDataDescriptor(view: Uint8Array, dataDescriptorSignature: Uint8Array, bytesEmitted: number, startIndex?: number, out?: ValidatedDataDescriptorScanResult): ValidatedDataDescriptorScanResult;
 export interface StreamUntilValidatedDataDescriptorSource {
+    getView(): Uint8Array;
     getLength(): number;
     read(length: number): Uint8Array;
-    /** Optional: zero-copy chunk views for streaming writes. */
-    peekChunks?(length: number): Uint8Array[];
-    /** Optional: consume bytes previously written from peekChunks(). */
-    discard?(length: number): void;
-    indexOfPattern(pattern: Uint8Array, startIndex: number): number;
-    peekUint32LE(offset: number): number | null;
     isFinished(): boolean;
     onDataAvailable(cb: () => void): () => void;
     maybeReleaseWriteCallback?: () => void;
@@ -148,34 +142,6 @@ export declare function streamUntilValidatedDataDescriptor(options: StreamUntilV
 export interface ParseOptions {
     verbose?: boolean;
     forceStream?: boolean;
-    /**
-     * Browser-only: use a Web Worker to run inflate off the main thread.
-     * Defaults to false.
-     */
-    useWorkerInflate?: boolean;
-    /**
-     * Browser-only: provide an explicit Worker script URL.
-     *
-     * Useful under strict CSP that blocks `blob:` workers. When set, the browser
-     * parser will try to construct `new Worker(workerInflateUrl)`.
-     */
-    workerInflateUrl?: string;
-    /**
-     * Input backpressure high-water mark (bytes).
-     *
-     * When provided, implementations may delay the writable callback until the
-     * internal input buffer drops below `inputLowWaterMarkBytes`.
-     *
-     * This is primarily used by the browser parser, because its writable side
-     * otherwise tends to accept unlimited data and can cause large memory spikes.
-     */
-    inputHighWaterMarkBytes?: number;
-    /**
-     * Input backpressure low-water mark (bytes).
-     * When the internal buffer drops to (or below) this value, a delayed writable
-     * callback may be released.
-     */
-    inputLowWaterMarkBytes?: number;
     /**
      * Threshold (in bytes) for small file optimization.
      * Files smaller than this will use sync decompression (no stream overhead).