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

package/dist/esm/modules/stream/streams.browser.js

@@ -11,9 +11,10 @@
  * - Edge >= 89
  */
 import { EventEmitter } from "./event-emitter.js";
-import { PullStream as StandalonePullStream } from "./pull-stream.js";
-import { BufferedStream as StandaloneBufferedStream, StringChunk as StandaloneStringChunk, BufferChunk as StandaloneBufferChunk } from "./buffered-stream.js";
+import { PullStream } from "./pull-stream.js";
+import { BufferedStream, BufferChunk, StringChunk } from "./buffered-stream.js";
 import { concatUint8Arrays, getTextDecoder, textDecoder } from "./shared.js";
+import { isAsyncIterable, isReadableStream, isTransformStream, isWritableStream } from "./internal/type-guards.js";
 const removeEmitterListener = (emitter, event, listener) => {
     if (typeof emitter.off === "function") {
         emitter.off(event, listener);
@@ -2405,21 +2406,8 @@ export class Collector extends Writable {
 // =============================================================================
 // PullStream / BufferedStream / DataChunk helpers
 // =============================================================================
-export class PullStream extends StandalonePullStream {
-    // Keep constructor signature aligned with streams.browser.ts public API
-    constructor(options) {
-        super(options);
-    }
-}
-export class StringChunk extends StandaloneStringChunk {
-}
-export class BufferChunk extends StandaloneBufferChunk {
-}
-export class BufferedStream extends StandaloneBufferedStream {
-    constructor(options) {
-        super(options);
-    }
-}
+// Standalone cross-platform helpers
+export { PullStream, BufferedStream, StringChunk, BufferChunk };
 // =============================================================================
 // Stream Creation Functions
 // =============================================================================
@@ -2502,20 +2490,6 @@ export function createPullStream(options) {
 export function createBufferedStream(options) {
     return new BufferedStream(options);
 }
-const isReadableStream = (value) => !!value && typeof value === "object" && typeof value.getReader === "function";
-const isAsyncIterable = (value) => {
-    if (!value || (typeof value !== "object" && typeof value !== "function")) {
-        return false;
-    }
-    return typeof value[Symbol.asyncIterator] === "function";
-};
-const isWritableStream = (value) => !!value && typeof value === "object" && typeof value.getWriter === "function";
-const isTransformStream = (value) => !!value &&
-    typeof value === "object" &&
-    !!value.readable &&
-    !!value.writable &&
-    isReadableStream(value.readable) &&
-    isWritableStream(value.writable);
 const isPipelineOptions = (value) => {
     if (!value || typeof value !== "object") {
         return false;
@@ -2785,8 +2759,8 @@ export async function streamToPromise(stream) {
  * (Browser equivalent of Node.js streamToBuffer)
  */
 export async function streamToUint8Array(stream) {
-    const { chunks, totalLength } = await collectStreamChunks(stream);
-    return concatWithLength(chunks, totalLength);
+    const [chunks, totalLength] = await collectStreamChunks(stream);
+    return concatUint8Arrays(chunks, totalLength);
 }
 /**
  * Alias for streamToUint8Array (Node.js compatibility)
@@ -2796,8 +2770,8 @@ export const streamToBuffer = streamToUint8Array;
  * Collect all data from a readable stream into a string
  */
 export async function streamToString(stream, encoding) {
-    const { chunks, totalLength } = await collectStreamChunks(stream);
-    const combined = concatWithLength(chunks, totalLength);
+    const [chunks, totalLength] = await collectStreamChunks(stream);
+    const combined = concatUint8Arrays(chunks, totalLength);
     const decoder = encoding ? getTextDecoder(encoding) : textDecoder;
     return decoder.decode(combined);
 }
@@ -2805,16 +2779,7 @@ export async function streamToString(stream, encoding) {
  * Drain a stream (consume all data without processing)
  */
 export async function drainStream(stream) {
-    let iterable;
-    if (isReadableStream(stream)) {
-        iterable = Readable.fromWeb(stream);
-    }
-    else if (isAsyncIterable(stream)) {
-        iterable = stream;
-    }
-    else {
-        throw new Error("drainStream: unsupported stream type");
-    }
+    const iterable = toReadableAsyncIterable(stream, "drainStream");
     for await (const _chunk of iterable) {
         // Consume data
     }
@@ -3034,94 +2999,117 @@ export function compose(...transforms) {
     for (let i = 0; i < len - 1; i++) {
         transforms[i].pipe(transforms[i + 1]);
     }
-    class ComposedTransform extends Transform {
-        constructor(options) {
-            super(options);
-            this._dataForwarding = false;
-            this._endForwarding = false;
-            this._dataForwardCleanup = null;
-            this._endForwardCleanup = null;
-            this._errorForwardCleanup = [];
-            for (const t of transforms) {
-                const onError = (err) => {
-                    this.emit("error", err);
-                };
-                this._errorForwardCleanup.push(addEmitterListener(t, "error", onError));
-            }
-        }
-        on(event, listener) {
-            if (event === "data" && !this._dataForwarding) {
-                this._dataForwarding = true;
-                const onData = (chunk) => {
-                    this.emit("data", chunk);
-                };
-                this._dataForwardCleanup = addEmitterListener(last, "data", onData);
-            }
-            if (event === "end" && !this._endForwarding) {
-                this._endForwarding = true;
-                const onEnd = () => {
-                    this.emit("end");
-                };
-                this._endForwardCleanup = addEmitterListener(last, "end", onEnd, { once: true });
-            }
-            return super.on(event, listener);
-        }
-        write(chunk, encodingOrCallback, callback) {
-            if (typeof encodingOrCallback === "function") {
-                return first.write(chunk, encodingOrCallback);
-            }
-            return first.write(chunk, encodingOrCallback, callback);
-        }
-        end(chunkOrCallback, encodingOrCallback, callback) {
-            if (typeof chunkOrCallback === "function") {
-                first.end(chunkOrCallback);
-                return this;
-            }
-            if (typeof encodingOrCallback === "function") {
-                first.end(chunkOrCallback, encodingOrCallback);
-                return this;
-            }
-            first.end(chunkOrCallback, encodingOrCallback, callback);
-            return this;
+    // A lightweight Transform wrapper that delegates:
+    // - writable side to `first`
+    // - readable side to `last`
+    // It forwards relevant events lazily to avoid per-chunk overhead when unused.
+    const composed = new Transform({
+        objectMode: first?.objectMode ?? true,
+        transform: chunk => chunk
+    });
+    const registry = createListenerRegistry();
+    // Always forward errors; they are critical for pipeline semantics.
+    for (const t of transforms) {
+        registry.add(t, "error", (err) => composed.emit("error", err));
+    }
+    // Forward writable-side backpressure/completion events from `first`.
+    registry.add(first, "drain", () => composed.emit("drain"));
+    registry.once(first, "finish", () => composed.emit("finish"));
+    // Forward readable-side events from `last` lazily.
+    let forwardData = false;
+    let forwardEnd = false;
+    let forwardReadable = false;
+    const ensureDataForwarding = () => {
+        if (forwardData) {
+            return;
         }
-        pipe(destination) {
-            return last.pipe(destination);
+        forwardData = true;
+        registry.add(last, "data", (chunk) => composed.emit("data", chunk));
+    };
+    const ensureEndForwarding = () => {
+        if (forwardEnd) {
+            return;
         }
-        destroy(error) {
-            if (this._dataForwardCleanup) {
-                this._dataForwardCleanup();
-                this._dataForwardCleanup = null;
-            }
-            if (this._endForwardCleanup) {
-                this._endForwardCleanup();
-                this._endForwardCleanup = null;
-            }
-            for (let i = this._errorForwardCleanup.length - 1; i >= 0; i--) {
-                this._errorForwardCleanup[i]();
-            }
-            this._errorForwardCleanup.length = 0;
-            for (const t of transforms) {
-                t.destroy(error);
-            }
-            super.destroy(error);
+        forwardEnd = true;
+        registry.once(last, "end", () => composed.emit("end"));
+    };
+    const ensureReadableForwarding = () => {
+        if (forwardReadable) {
+            return;
         }
-        read(size) {
-            return typeof last.read === "function" ? last.read(size) : null;
+        forwardReadable = true;
+        registry.add(last, "readable", () => composed.emit("readable"));
+    };
+    const originalOn = composed.on.bind(composed);
+    const originalOnce = composed.once.bind(composed);
+    composed.on = (event, listener) => {
+        if (event === "data") {
+            ensureDataForwarding();
         }
-        async *[Symbol.asyncIterator]() {
-            const it = last?.[Symbol.asyncIterator]?.();
-            if (it) {
-                for await (const chunk of it) {
-                    yield chunk;
-                }
-                return;
+        else if (event === "end") {
+            ensureEndForwarding();
+        }
+        else if (event === "readable") {
+            ensureReadableForwarding();
+        }
+        return originalOn(event, listener);
+    };
+    composed.once = (event, listener) => {
+        if (event === "data") {
+            ensureDataForwarding();
+        }
+        else if (event === "end") {
+            ensureEndForwarding();
+        }
+        else if (event === "readable") {
+            ensureReadableForwarding();
+        }
+        return originalOnce(event, listener);
+    };
+    // Delegate core stream methods
+    const firstAny = first;
+    const lastAny = last;
+    composed.write = (chunk, encodingOrCallback, callback) => {
+        if (typeof encodingOrCallback === "function") {
+            return firstAny.write(chunk, encodingOrCallback);
+        }
+        return firstAny.write(chunk, encodingOrCallback, callback);
+    };
+    composed.end = (chunkOrCallback, encodingOrCallback, callback) => {
+        if (typeof chunkOrCallback === "function") {
+            firstAny.end(chunkOrCallback);
+            return composed;
+        }
+        if (typeof encodingOrCallback === "function") {
+            firstAny.end(chunkOrCallback, encodingOrCallback);
+            return composed;
+        }
+        firstAny.end(chunkOrCallback, encodingOrCallback, callback);
+        return composed;
+    };
+    composed.pipe = (destination) => {
+        return lastAny.pipe(destination);
+    };
+    composed.read = (size) => {
+        return typeof lastAny.read === "function" ? lastAny.read(size) : null;
+    };
+    composed[Symbol.asyncIterator] = async function* () {
+        const it = lastAny?.[Symbol.asyncIterator]?.();
+        if (it) {
+            for await (const chunk of it) {
+                yield chunk;
             }
-            yield* super[Symbol.asyncIterator]();
+            return;
         }
-    }
-    const composed = new ComposedTransform({
-        objectMode: first?.objectMode ?? true,
-        transform: chunk => chunk
+        yield* Transform.prototype[Symbol.asyncIterator].call(composed);
+    };
+    const originalDestroy = composed.destroy.bind(composed);
+    composed.destroy = ((error) => {
+        registry.cleanup();
+        for (const t of transforms) {
+            t.destroy(error);
+        }
+        originalDestroy(error);
     });
     // Reflect underlying readability/writability like the previous duck-typed wrapper
     Object.defineProperty(composed, "readable", {
@@ -3368,77 +3356,54 @@ export function duplexPair(options) {
 async function collectStreamChunks(stream) {
     const chunks = [];
     let totalLength = 0;
-    let iterable;
-    if (isReadableStream(stream)) {
-        iterable = Readable.fromWeb(stream);
-    }
-    else if (isAsyncIterable(stream)) {
-        iterable = stream;
-    }
-    else {
-        throw new Error("collectStreamChunks: unsupported stream type");
-    }
+    const iterable = toReadableAsyncIterable(stream, "collectStreamChunks");
     for await (const chunk of iterable) {
         chunks.push(chunk);
         totalLength += chunk.length;
     }
-    return { chunks, totalLength };
+    return [chunks, totalLength];
 }
-// Helper to concatenate with known length (faster)
-function concatWithLength(chunks, totalLength) {
-    const len = chunks.length;
-    if (len === 0) {
-        return new Uint8Array(0);
-    }
-    if (len === 1) {
-        return chunks[0];
+function toReadableAsyncIterable(stream, name) {
+    if (isReadableStream(stream)) {
+        return Readable.fromWeb(stream);
     }
-    const result = new Uint8Array(totalLength);
-    let offset = 0;
-    for (let i = 0; i < len; i++) {
-        result.set(chunks[i], offset);
-        offset += chunks[i].length;
+    if (isAsyncIterable(stream)) {
+        return stream;
     }
-    return result;
+    throw new Error(`${name}: unsupported stream type`);
 }
 export const consumers = {
     /**
      * Consume entire stream as ArrayBuffer
      */
     async arrayBuffer(stream) {
-        const { chunks, totalLength } = await collectStreamChunks(stream);
-        const combined = concatWithLength(chunks, totalLength);
-        return combined.buffer.slice(combined.byteOffset, combined.byteOffset + combined.byteLength);
+        const bytes = await streamToUint8Array(stream);
+        return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
     },
     /**
      * Consume entire stream as Blob
      */
     async blob(stream, options) {
-        const { chunks } = await collectStreamChunks(stream);
+        const [chunks] = await collectStreamChunks(stream);
         return new Blob(chunks, options);
     },
     /**
      * Consume entire stream as Buffer (Uint8Array in browser)
      */
     async buffer(stream) {
-        const { chunks, totalLength } = await collectStreamChunks(stream);
-        return concatWithLength(chunks, totalLength);
+        return streamToUint8Array(stream);
     },
     /**
      * Consume entire stream as JSON
      */
     async json(stream) {
-        const text = await consumers.text(stream);
-        return JSON.parse(text);
+        return JSON.parse(await streamToString(stream));
     },
     /**
      * Consume entire stream as text
      */
     async text(stream, encoding) {
-        const { chunks, totalLength } = await collectStreamChunks(stream);
-        const combined = concatWithLength(chunks, totalLength);
-        const decoder = encoding ? getTextDecoder(encoding) : textDecoder;
-        return decoder.decode(combined);
+        return streamToString(stream, encoding);
     }
 };
 // =============================================================================

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

@@ -5,8 +5,9 @@
  * Provides Readable, Writable, Transform, Duplex, and PassThrough streams.
  */
 import { Readable, Writable as NodeWritable, Transform, Duplex, PassThrough, pipeline as nodePipeline, finished as nodeFinished } from "stream";
-import { BufferedStream as StandaloneBufferedStream, StringChunk as StandaloneStringChunk, BufferChunk as StandaloneBufferChunk } from "./buffered-stream.js";
-import { PullStream as StandalonePullStream } from "./pull-stream.js";
+import { BufferedStream, BufferChunk, StringChunk } from "./buffered-stream.js";
+import { PullStream } from "./pull-stream.js";
+import { isAsyncIterable, isReadableStream, isTransformStream, isWritableStream } from "./internal/type-guards.js";
 /**
  * Unified Writable class - wraps Node.js Writable with browser-compatible API
  *
@@ -59,6 +60,8 @@ export class Writable extends NodeWritable {
 // Re-export native classes with our interfaces
 // =============================================================================
 export { Readable, Transform, Duplex, PassThrough };
+// Standalone cross-platform helpers
+export { PullStream, BufferedStream, StringChunk, BufferChunk };
 // =============================================================================
 // Cross-environment stream normalization
 // =============================================================================
@@ -84,29 +87,12 @@ export function normalizeWritable(stream) {
 }
 // Import for internal use
 import { textDecoder } from "./shared.js";
-const isReadableStream = (value) => !!value && typeof value === "object" && typeof value.getReader === "function";
-const isAsyncIterable = (value) => {
-    if (!value || (typeof value !== "object" && typeof value !== "function")) {
-        return false;
-    }
-    return typeof value[Symbol.asyncIterator] === "function";
-};
-const isWritableStream = (value) => !!value && typeof value === "object" && typeof value.getWriter === "function";
-const isTransformStream = (value) => !!value &&
-    typeof value === "object" &&
-    !!value.readable &&
-    !!value.writable &&
-    isReadableStream(value.readable) &&
-    isWritableStream(value.writable);
 const isPipelineOptions = (value) => {
     if (!value || typeof value !== "object") {
         return false;
     }
-    // IMPORTANT:
-    // Do NOT use `"end" in obj` here because streams have `.end()` and would be
-    // misclassified as options, breaking argument parsing and potentially hanging.
+    // Avoid treating streams as options objects.
     if (typeof value.pipe === "function" ||
-        typeof value.write === "function" ||
         typeof value.end === "function" ||
         typeof value.getReader === "function" ||
         typeof value.getWriter === "function") {
@@ -425,8 +411,6 @@ export function createCollector(options) {
 // =============================================================================
 // Pull Stream - Read data on demand with pattern matching
 // =============================================================================
-export class PullStream extends StandalonePullStream {
-}
 /**
  * Create a pull stream
  */
@@ -436,21 +420,6 @@ export function createPullStream(options) {
 // =============================================================================
 // Buffered Stream - Efficient chunk management
 // =============================================================================
-/**
- * String chunk implementation
- */
-export class StringChunk extends StandaloneStringChunk {
-}
-/**
- * Buffer chunk implementation
- */
-export class BufferChunk extends StandaloneBufferChunk {
-}
-/**
- * Buffered stream with efficient chunk management
- */
-export class BufferedStream extends StandaloneBufferedStream {
-}
 /**
  * Create a buffered stream
  */

package/dist/esm/modules/stream/utils.js

@@ -4,8 +4,8 @@
  * Small, cross-platform helpers built on top of the platform stream
  * implementation selected by `./streams` (Node.js or browser).
  */
-import { createReadableFromArray, createTransform } from "./streams.js";
-import { stringToUint8Array as _stringToUint8Array, uint8ArrayToString as _uint8ArrayToString } from "./shared.js";
+import { consumers, createReadableFromArray, createTransform } from "./streams.js";
+import { stringToUint8Array as _stringToUint8Array } from "./shared.js";
 // =============================================================================
 // High-Level Stream Consumers
 // =============================================================================
@@ -17,46 +17,13 @@ export async function collect(stream) {
     return result;
 }
 export async function text(stream) {
-    const chunks = [];
-    let totalLength = 0;
-    for await (const chunk of stream) {
-        chunks.push(chunk);
-        totalLength += chunk.length;
-    }
-    if (chunks.length === 1) {
-        return _uint8ArrayToString(chunks[0]);
-    }
-    const result = new Uint8Array(totalLength);
-    let offset = 0;
-    for (let i = 0, len = chunks.length; i < len; i++) {
-        const c = chunks[i];
-        result.set(c, offset);
-        offset += c.length;
-    }
-    return _uint8ArrayToString(result);
+    return consumers.text(stream);
 }
 export async function json(stream) {
-    const str = await text(stream);
-    return JSON.parse(str);
+    return consumers.json(stream);
 }
 export async function bytes(stream) {
-    const chunks = [];
-    let totalLength = 0;
-    for await (const chunk of stream) {
-        chunks.push(chunk);
-        totalLength += chunk.length;
-    }
-    if (chunks.length === 1) {
-        return chunks[0];
-    }
-    const result = new Uint8Array(totalLength);
-    let offset = 0;
-    for (let i = 0, len = chunks.length; i < len; i++) {
-        const c = chunks[i];
-        result.set(c, offset);
-        offset += c.length;
-    }
-    return result;
+    return consumers.buffer(stream);
 }
 // =============================================================================
 // Stream Factory Helpers