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

package/dist/cjs/modules/stream/streams.js

@@ -62,20 +62,34 @@ class Writable extends stream_1.Writable {
     constructor(options) {
         // If wrapping an existing stream, proxy to it
         if (options?.stream) {
+            const underlying = options.stream;
             // Create a pass-through wrapper that proxies to the underlying stream
             super({
                 highWaterMark: options?.highWaterMark,
                 objectMode: options?.objectMode,
                 write(chunk, encoding, callback) {
-                    options.stream.write(chunk, encoding, callback);
+                    underlying.write(chunk, encoding, callback);
                 },
                 final(callback) {
-                    options.stream.end(callback);
+                    underlying.end(callback);
                 }
             });
-            // Proxy events from underlying stream
-            options.stream.on("error", err => this.emit("error", err));
-            options.stream.on("close", () => this.emit("close"));
+            // Proxy events from underlying stream, but ensure we clean up listeners so
+            // the underlying stream cannot retain this wrapper longer than necessary.
+            const onUnderlyingError = (err) => {
+                this.emit("error", err);
+            };
+            const onUnderlyingClose = () => {
+                this.emit("close");
+            };
+            const cleanup = () => {
+                underlying.off("error", onUnderlyingError);
+                underlying.off("close", onUnderlyingClose);
+            };
+            underlying.on("error", onUnderlyingError);
+            underlying.on("close", onUnderlyingClose);
+            this.once("close", cleanup);
+            this.once("finish", cleanup);
         }
         else {
             super({
@@ -100,17 +114,16 @@ function normalizeWritable(stream) {
     if (stream instanceof Writable) {
         return stream;
     }
-    // Node.js Writable: accept structurally even if typed as unknown.
+    // Node.js Writable: already compatible, avoid extra wrapper allocation.
     if (stream instanceof stream_1.Writable) {
-        return new Writable({ stream: stream });
+        return stream;
     }
     // Web WritableStream: detect by getWriter() (avoid relying on global WritableStream).
     if (stream?.getWriter) {
-        const nodeWritable = stream_1.Writable.fromWeb(stream);
-        return new Writable({ stream: nodeWritable });
+        return stream_1.Writable.fromWeb(stream);
     }
-    // Assume it structurally matches Node's Writable; wrap for consistent API.
-    return new Writable({ stream: stream });
+    // Assume it structurally matches Node's Writable.
+    return stream;
 }
 // Import for internal use
 const shared_1 = require("./shared.js");
@@ -223,12 +236,13 @@ function finished(stream, optionsOrCallback, callback) {
     const promise = new Promise((resolve, reject) => {
         const normalizedStream = toNodePipelineStream(stream);
         stream_1.finished(normalizedStream, options, (err) => {
-            if (err && !(options && options.error)) {
+            // Node.js semantics: options.error defaults to true (report errors).
+            // If options.error === false, ignore errors and resolve.
+            if (err && options?.error !== false) {
                 reject(err);
+                return;
             }
-            else {
-                resolve();
-            }
+            resolve();
         });
     });
     if (cb) {
@@ -581,13 +595,28 @@ function addAbortSignal(signal, stream) {
         stream.destroy(new Error("Aborted"));
         return stream;
     }
+    const cleanup = () => {
+        signal.removeEventListener("abort", onAbort);
+        stream.off?.("close", onDone);
+        stream.off?.("end", onDone);
+        stream.off?.("finish", onDone);
+        stream.off?.("error", onError);
+    };
     const onAbort = () => {
+        cleanup();
         stream.destroy(new Error("Aborted"));
     };
+    const onDone = () => {
+        cleanup();
+    };
+    const onError = () => {
+        cleanup();
+    };
     signal.addEventListener("abort", onAbort, { once: true });
-    stream.on("close", () => {
-        signal.removeEventListener("abort", onAbort);
-    });
+    stream.once?.("close", onDone);
+    stream.once?.("end", onDone);
+    stream.once?.("finish", onDone);
+    stream.once?.("error", onError);
     return stream;
 }
 /**
@@ -630,56 +659,109 @@ function compose(...transforms) {
     if (len === 1 && isNativeTransform(transforms[0])) {
         return transforms[0];
     }
-    // Chain all transforms together
+    // Chain all transforms together once.
     for (let i = 0; i < len - 1; i++) {
         transforms[i].pipe(transforms[i + 1]);
     }
-    // Create a Duplex that writes to first and reads from last
     const first = transforms[0];
     const last = transforms[len - 1];
-    // Create a PassThrough as the composed stream
-    const composed = new stream_1.PassThrough({ objectMode: first.readableObjectMode });
-    // Store original methods for forwarding
-    const passthroughWrite = composed.write.bind(composed);
-    const passthroughEnd = composed.end.bind(composed);
-    // Override write to write to first transform
-    composed.write = function (chunk, encodingOrCallback, callback) {
-        if (typeof encodingOrCallback === "function") {
-            return first.write(chunk, encodingOrCallback);
-        }
-        return first.write(chunk, encodingOrCallback, callback);
-    };
-    // Override end to end first transform
-    composed.end = function (chunkOrCallback, encodingOrCallback, callback) {
-        if (typeof chunkOrCallback === "function") {
-            first.end(chunkOrCallback);
+    // Use a private output stream so we don't have to monkey-patch `write()` on the
+    // public composed stream (which would break piping into it).
+    const output = new stream_1.PassThrough({ objectMode: last.readableObjectMode ?? true });
+    last.pipe(output);
+    let outputEnded = false;
+    const pumpOutput = (target) => {
+        if (outputEnded) {
+            return;
         }
-        else if (typeof encodingOrCallback === "function") {
-            first.end(chunkOrCallback, encodingOrCallback);
+        while (true) {
+            const chunk = output.read();
+            if (chunk === null) {
+                break;
+            }
+            if (!target.push(chunk)) {
+                break;
+            }
         }
-        else {
-            first.end(chunkOrCallback, encodingOrCallback, callback);
+    };
+    const composed = new stream_1.Transform({
+        readableObjectMode: last.readableObjectMode,
+        writableObjectMode: first.writableObjectMode,
+        transform(chunk, encoding, callback) {
+            try {
+                // Forward writes into the head of the chain.
+                first.write(chunk, encoding, callback);
+            }
+            catch (err) {
+                callback(err);
+            }
+        },
+        flush(callback) {
+            // End the head of the chain; readable completion is driven by `output` ending.
+            const onFinish = () => {
+                cleanupFlush();
+                callback();
+            };
+            const onError = (err) => {
+                cleanupFlush();
+                callback(err);
+            };
+            const cleanupFlush = () => {
+                first.off?.("finish", onFinish);
+                first.off?.("error", onError);
+            };
+            first.once?.("finish", onFinish);
+            first.once?.("error", onError);
+            first.end();
+        },
+        read() {
+            pumpOutput(this);
+        },
+        destroy(err, callback) {
+            try {
+                output.destroy(err ?? undefined);
+                for (const t of transforms) {
+                    t.destroy?.(err ?? undefined);
+                }
+            }
+            finally {
+                callback(err);
+            }
         }
-        return composed;
+    });
+    const onOutputReadable = () => {
+        pumpOutput(composed);
     };
-    // Override pipe to pipe from last transform
-    composed.pipe = function (dest) {
-        return last.pipe(dest);
+    const onOutputEnd = () => {
+        cleanupListeners();
+        outputEnded = true;
+        composed.push(null);
     };
-    // Forward data from last to composed
-    last.on("data", (chunk) => {
-        passthroughWrite(chunk);
-    });
-    // Forward end from last
-    last.on("end", () => {
-        passthroughEnd();
-    });
-    // Forward errors from any transform
-    for (const transform of transforms) {
-        transform.on("error", (err) => {
-            composed.emit("error", err);
-        });
+    const onAnyError = (err) => {
+        cleanupListeners();
+        composed.destroy(err);
+    };
+    const transformErrorListeners = [];
+    const cleanupListeners = () => {
+        output.off("readable", onOutputReadable);
+        output.off("end", onOutputEnd);
+        output.off("error", onAnyError);
+        for (const { t, fn } of transformErrorListeners) {
+            t.off?.("error", fn);
+        }
+        transformErrorListeners.length = 0;
+    };
+    output.on("readable", onOutputReadable);
+    output.once("end", onOutputEnd);
+    output.once("error", onAnyError);
+    for (const t of transforms) {
+        const tt = t;
+        tt.once?.("error", onAnyError);
+        transformErrorListeners.push({ t: tt, fn: onAnyError });
     }
+    composed.once("close", () => {
+        cleanupListeners();
+    });
     return composed;
 }
 /**
@@ -760,7 +842,7 @@ function once(emitter, event, options) {
                 onAbort();
                 return;
             }
-            options.signal.addEventListener("abort", onAbort);
+            options.signal.addEventListener("abort", onAbort, { once: true });
         }
     });
 }

package/dist/esm/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/esm/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/{browser/modules/archive → esm/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/esm/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/esm/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/esm/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/esm/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.js";
+import { EventEmitter } from "../../stream/index.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/esm/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.js";
-import { DEFAULT_COMPRESS_LEVEL } from "./defaults.js";
+import { Transform } from "../../stream/index.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/esm/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/esm/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/esm/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/esm/modules/archive/index.js

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