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

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

@@ -62,34 +62,20 @@ 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) {
-                    underlying.write(chunk, encoding, callback);
+                    options.stream.write(chunk, encoding, callback);
                 },
                 final(callback) {
-                    underlying.end(callback);
+                    options.stream.end(callback);
                 }
             });
-            // 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);
+            // Proxy events from underlying stream
+            options.stream.on("error", err => this.emit("error", err));
+            options.stream.on("close", () => this.emit("close"));
         }
         else {
             super({
@@ -114,16 +100,17 @@ function normalizeWritable(stream) {
     if (stream instanceof Writable) {
         return stream;
     }
-    // Node.js Writable: already compatible, avoid extra wrapper allocation.
+    // Node.js Writable: accept structurally even if typed as unknown.
     if (stream instanceof stream_1.Writable) {
-        return stream;
+        return new Writable({ stream: stream });
     }
     // Web WritableStream: detect by getWriter() (avoid relying on global WritableStream).
     if (stream?.getWriter) {
-        return stream_1.Writable.fromWeb(stream);
+        const nodeWritable = stream_1.Writable.fromWeb(stream);
+        return new Writable({ stream: nodeWritable });
     }
-    // Assume it structurally matches Node's Writable.
-    return stream;
+    // Assume it structurally matches Node's Writable; wrap for consistent API.
+    return new Writable({ stream: stream });
 }
 // Import for internal use
 const shared_1 = require("./shared.js");
@@ -236,13 +223,12 @@ function finished(stream, optionsOrCallback, callback) {
     const promise = new Promise((resolve, reject) => {
         const normalizedStream = toNodePipelineStream(stream);
         stream_1.finished(normalizedStream, options, (err) => {
-            // Node.js semantics: options.error defaults to true (report errors).
-            // If options.error === false, ignore errors and resolve.
-            if (err && options?.error !== false) {
+            if (err && !(options && options.error)) {
                 reject(err);
-                return;
             }
-            resolve();
+            else {
+                resolve();
+            }
         });
     });
     if (cb) {
@@ -595,28 +581,13 @@ 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.once?.("close", onDone);
-    stream.once?.("end", onDone);
-    stream.once?.("finish", onDone);
-    stream.once?.("error", onError);
+    stream.on("close", () => {
+        signal.removeEventListener("abort", onAbort);
+    });
     return stream;
 }
 /**
@@ -659,109 +630,56 @@ function compose(...transforms) {
     if (len === 1 && isNativeTransform(transforms[0])) {
         return transforms[0];
     }
-    // Chain all transforms together once.
+    // Chain all transforms together
     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];
-    // 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;
-        }
-        while (true) {
-            const chunk = output.read();
-            if (chunk === null) {
-                break;
-            }
-            if (!target.push(chunk)) {
-                break;
-            }
+    // 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);
     };
-    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);
-            }
+    // Override end to end first transform
+    composed.end = function (chunkOrCallback, encodingOrCallback, callback) {
+        if (typeof chunkOrCallback === "function") {
+            first.end(chunkOrCallback);
         }
-    });
-    const onOutputReadable = () => {
-        pumpOutput(composed);
-    };
-    const onOutputEnd = () => {
-        cleanupListeners();
-        outputEnded = true;
-        composed.push(null);
-    };
-    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);
+        else if (typeof encodingOrCallback === "function") {
+            first.end(chunkOrCallback, encodingOrCallback);
+        }
+        else {
+            first.end(chunkOrCallback, encodingOrCallback, callback);
         }
-        transformErrorListeners.length = 0;
+        return composed;
     };
-    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();
+    // Override pipe to pipe from last transform
+    composed.pipe = function (dest) {
+        return last.pipe(dest);
+    };
+    // 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);
+        });
+    }
     return composed;
 }
 /**
@@ -842,7 +760,7 @@ function once(emitter, event, options) {
                 onAbort();
                 return;
             }
-            options.signal.addEventListener("abort", onAbort, { once: true });
+            options.signal.addEventListener("abort", onAbort);
         }
     });
 }

package/dist/esm/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/esm/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/esm/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 → esm/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 → esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/modules/archive/index.js

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