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

package/THIRD_PARTY_NOTICES.md

@@ -62,37 +62,6 @@ 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,3 +25,4 @@ 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,3 +39,15 @@ 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/{types/modules/archive → browser/modules/archive/compression}/compress.base.d.ts

@@ -35,6 +35,7 @@ export interface CompressOptions {
  * Default threshold (in bytes) to choose the lower-overhead path.
  *
  * This is a performance knob, not a correctness requirement.
+ * Default: 8MB.
  */
 export declare const DEFAULT_COMPRESS_THRESHOLD_BYTES: number;
 /**

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

@@ -8,11 +8,12 @@
  * Browser fallback: For browsers without deflate-raw support (Firefox < 113, Safari < 16.4),
  * see deflate-fallback.ts for pure JS implementation
  */
-import { ByteQueue } from "./byte-queue.js";
+import { ByteQueue } from "../internal/byte-queue.js";
 /**
  * Default threshold (in bytes) to choose the lower-overhead path.
  *
  * This is a performance knob, not a correctness requirement.
+ * Default: 8MB.
  */
 export const DEFAULT_COMPRESS_THRESHOLD_BYTES = 8 * 1024 * 1024;
 /**

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

@@ -10,18 +10,15 @@
  * - Safari >= 14.1
  * - Edge >= 89
  */
-import { type CompressOptions } from "./compress.base.js";
+import { type CompressOptions, hasCompressionStream } from "@archive/compression/compress.base";
 export { type CompressOptions };
-/**
- * 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;
+export { hasCompressionStream };
 /**
  * Compress data using browser's native CompressionStream or JS fallback
  *
+ * Note: We always prefer native CompressionStream when available because
+ * it's significantly faster than pure JS implementation.
+ *
  * @param data - Data to compress
  * @param options - Compression options
  * @returns Compressed data
@@ -44,7 +41,12 @@ export declare function compressSync(data: Uint8Array, options?: CompressOptions
 /**
  * Decompress data using browser's native DecompressionStream or JS fallback
  *
+ * Note: We always prefer native DecompressionStream when available because
+ * it's significantly faster than pure JS implementation, regardless of data size.
+ * The threshold is only useful for compression where the overhead matters more.
+ *
  * @param data - Compressed data (deflate-raw format)
+ * @param options - Decompression options (kept for API parity; currently unused in browser)
  * @returns Decompressed data
  */
 export declare function decompress(data: Uint8Array, options?: CompressOptions): Promise<Uint8Array>;

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

@@ -10,23 +10,18 @@
  * - Safari >= 14.1
  * - Edge >= 89
  */
-import { compressWithStream, decompressWithStream, hasDeflateRawCompressionStream, hasDeflateRawDecompressionStream, resolveCompressThresholdBytes } from "./compress.base.js";
+import { compressWithStream, decompressWithStream, hasCompressionStream, 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 {};
-/**
- * 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";
-}
+export { hasCompressionStream };
 /**
  * Compress data using browser's native CompressionStream or JS fallback
  *
+ * Note: We always prefer native CompressionStream when available because
+ * it's significantly faster than pure JS implementation.
+ *
  * @param data - Data to compress
  * @param options - Compression options
  * @returns Compressed data
@@ -39,16 +34,15 @@ export function hasCompressionStream() {
  */
 export async function compress(data, options = {}) {
     const level = options.level ?? DEFAULT_COMPRESS_LEVEL;
-    const thresholdBytes = resolveCompressThresholdBytes(options);
     // Level 0 means no compression
     if (level === 0) {
         return data;
     }
-    // Use native CompressionStream only for larger inputs.
-    if (hasDeflateRawCompressionStream() && data.byteLength > thresholdBytes) {
+    // Always use native CompressionStream when available - it's much faster than JS
+    if (hasDeflateRawCompressionStream()) {
         return compressWithStream(data);
     }
-    // Fallback to pure JS implementation
+    // Fallback to pure JS implementation only when native is unavailable
     return deflateRawCompressed(data);
 }
 /**
@@ -70,16 +64,21 @@ export function compressSync(data, options = {}) {
 /**
  * Decompress data using browser's native DecompressionStream or JS fallback
  *
+ * Note: We always prefer native DecompressionStream when available because
+ * it's significantly faster than pure JS implementation, regardless of data size.
+ * The threshold is only useful for compression where the overhead matters more.
+ *
  * @param data - Compressed data (deflate-raw format)
+ * @param options - Decompression options (kept for API parity; currently unused in browser)
  * @returns Decompressed data
  */
 export async function decompress(data, options = {}) {
-    const thresholdBytes = resolveCompressThresholdBytes(options);
-    // Use native DecompressionStream only for larger inputs.
-    if (hasDeflateRawDecompressionStream() && data.byteLength > thresholdBytes) {
+    void options;
+    // Always use native DecompressionStream when available - it's much faster than JS
+    if (hasDeflateRawDecompressionStream()) {
         return decompressWithStream(data);
     }
-    // Fallback to pure JS implementation
+    // Fallback to pure JS implementation only when native is unavailable
     return inflateRaw(data);
 }
 /**

package/dist/browser/modules/archive/{compress.d.ts → compression/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/compress.base";
-import type { CompressOptions } from "@archive/compress.base";
+export { type CompressOptions, hasCompressionStream } from "@archive/compression/compress.base";
+import type { CompressOptions } from "@archive/compression/compress.base";
 /**
  * Compress data using Node.js native zlib
  *

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

package/dist/browser/modules/archive/{crc32.d.ts → compression/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/crc32.base";
+import { crc32Finalize } from "@archive/compression/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/{crc32.js → compression/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/{deflate-fallback.js → compression/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/{streaming-compress.browser.d.ts → compression/streaming-compress.browser.d.ts}

@@ -6,8 +6,8 @@
  *
  * API compatible with Node.js version - supports .on("data"), .on("end"), .write(callback), .end()
  */
-export type { StreamCompressOptions } from "@archive/streaming-compress.base";
-import { type DeflateStream, type InflateStream, type StreamCompressOptions } from "@archive/streaming-compress.base";
+export type { DeflateStream, InflateStream, StreamCompressOptions, StreamingCodec } from "@archive/compression/streaming-compress.base";
+import { type DeflateStream, type InflateStream, type StreamCompressOptions } from "@archive/compression/streaming-compress.base";
 /**
  * Check if deflate-raw streaming compression is supported by this library.
  *

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

@@ -6,11 +6,11 @@
  *
  * API compatible with Node.js version - supports .on("data"), .on("end"), .write(callback), .end()
  */
-import { EventEmitter } from "../stream/index.browser.js";
+import { EventEmitter } from "../../stream/index.browser.js";
 import { deflateRawCompressed, inflateRaw } from "./deflate-fallback.js";
 import { hasDeflateRawWebStreams } from "./compress.base.js";
-import { concatUint8Arrays } from "./utils/bytes.js";
-import { DEFAULT_COMPRESS_LEVEL } from "./defaults.js";
+import { concatUint8Arrays } from "../utils/bytes.js";
+import { DEFAULT_COMPRESS_LEVEL } from "../defaults.js";
 import { asError } from "./streaming-compress.base.js";
 /**
  * Check if deflate-raw streaming compression is supported by this library.

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

@@ -4,8 +4,8 @@
  * Uses zlib.createDeflateRaw() with explicit flush() calls for real chunk-by-chunk streaming.
  * Each write() immediately produces compressed output without waiting for end().
  */
-export type { DeflateStream, InflateStream, StreamCompressOptions, StreamingCodec } from "@archive/streaming-compress.base";
-import type { DeflateStream, InflateStream, StreamCompressOptions } from "@archive/streaming-compress.base";
+export type { DeflateStream, InflateStream, StreamCompressOptions, StreamingCodec } from "@archive/compression/streaming-compress.base";
+import type { DeflateStream, InflateStream, StreamCompressOptions } from "@archive/compression/streaming-compress.base";
 /**
  * Create a true streaming DEFLATE compressor
  * Returns a Transform stream that emits compressed data immediately after each write

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

@@ -5,8 +5,8 @@
  * Each write() immediately produces compressed output without waiting for end().
  */
 import { createDeflateRaw, createInflateRaw, constants } from "zlib";
-import { Transform } from "../stream/index.browser.js";
-import { DEFAULT_COMPRESS_LEVEL } from "./defaults.js";
+import { Transform } from "../../stream/index.browser.js";
+import { DEFAULT_COMPRESS_LEVEL } from "../defaults.js";
 /**
  * Wrapper around zlib DeflateRaw that flushes after every write
  * This ensures true streaming behavior - data is emitted immediately, not buffered

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

@@ -1,4 +1,5 @@
 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,3 +1,6 @@
-export const DEFAULT_COMPRESS_LEVEL = 6;
-export const DEFAULT_ZIP_LEVEL = 6;
-export const DEFAULT_ZIP_TIMESTAMPS = "dos+utc";
+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";

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 { 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";
+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";

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

@@ -5,9 +5,6 @@
  * Platform-specific entrypoints (index.ts / index.browser.ts) should re-export
  * from this file and then layer their platform-specific bindings.
  */
-// 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";
+// High-level APIs
+export { zip, ZipArchive } from "./zip/index.js";
+export { unzip, ZipReader, UnzipEntry } from "./unzip/index.js";

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

@@ -5,7 +5,6 @@
  * browser-specific implementations so we can enforce export-surface parity.
  */
 export * from "@archive/index.base";
-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";
+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";

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

@@ -6,12 +6,8 @@
  */
 export * from "./index.base.js";
 // CRC32
-export { crc32, crc32Update, crc32Finalize } from "./crc32.browser.js";
+export { crc32, crc32Update, crc32Finalize } from "./compression/crc32.browser.js";
 // Compression
-export { compress, compressSync, decompress, decompressSync, hasCompressionStream } from "./compress.browser.js";
+export { compress, compressSync, decompress, decompressSync, hasCompressionStream } from "./compression/compress.browser.js";
 // Streaming compression
-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)
+export { createDeflateStream, createInflateStream, hasDeflateRaw } from "./compression/streaming-compress.browser.js";

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

@@ -5,7 +5,6 @@
  * It groups all ZIP creation and extraction utilities in one place.
  */
 export * from "@archive/index.base";
-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";
+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";

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

@@ -6,10 +6,8 @@
  */
 export * from "./index.base.js";
 // CRC32
-export { crc32, crc32Update, crc32Finalize } from "./crc32.browser.js";
+export { crc32, crc32Update, crc32Finalize } from "./compression/crc32.browser.js";
 // Compression
-export { compress, compressSync, decompress, decompressSync, hasCompressionStream } from "./compress.browser.js";
+export { compress, compressSync, decompress, decompressSync, hasCompressionStream } from "./compression/compress.browser.js";
 // Streaming compression
-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";
+export { createDeflateStream, createInflateStream, hasDeflateRaw } from "./compression/streaming-compress.browser.js";

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

@@ -0,0 +1,33 @@
+export declare class ByteQueue {
+    private static readonly EMPTY;
+    private _chunks;
+    private _headOffset;
+    private _length;
+    private _cachedView;
+    private _cachedLength;
+    constructor(initial?: Uint8Array);
+    get length(): number;
+    isEmpty(): boolean;
+    view(): Uint8Array;
+    reset(data?: Uint8Array): void;
+    append(chunk: Uint8Array): void;
+    read(length: number): Uint8Array;
+    /**
+     * Return a list of chunk views totaling `length` bytes without consuming.
+     *
+     * This avoids materializing a contiguous buffer for streaming write paths.
+     */
+    peekChunks(length: number): Uint8Array[];
+    discard(length: number): void;
+    /**
+     * Find the first index of `pattern` within the queue.
+     *
+     * This avoids materializing a contiguous `view()` for common small patterns
+     * (ZIP signatures are typically 2-4 bytes).
+     */
+    indexOfPattern(pattern: Uint8Array, startIndex?: number): number;
+    /** Peek a little-endian uint32 at `offset` without consuming bytes. Returns null if not enough bytes. */
+    peekUint32LE(offset: number): number | null;
+    /** Peek a single byte at `offset` without consuming bytes. */
+    peekByte(offset: number): number;
+}