@cj-tech-master/excelts 4.2.1 → 4.2.2-canary.20260115044841.88820eb

package/dist/browser/modules/excel/xlsx/xform/sheet/worksheet-xform.js

@@ -137,6 +137,14 @@ class WorkSheetXform extends BaseXform {
         options.merges = new Merges();
         model.hyperlinks = options.hyperlinks = [];
         model.comments = options.comments = [];
+        // Some Excel builds are surprisingly strict when legacy form controls exist.
+        // Emitting a default sheetView (workbookViewId=0) matches typical Excel output
+        // and avoids relying on optional element handling.
+        if (model.formControls && model.formControls.length > 0) {
+            if (!model.views || model.views.length === 0) {
+                model.views = [{ workbookViewId: 0 }];
+            }
+        }
         options.formulae = {};
         options.siFormulae = 0;
         this.map.cols.prepare(model.cols, options);
@@ -278,6 +286,23 @@ class WorkSheetXform extends BaseXform {
         // prepare form controls (legacy checkboxes)
         // Form controls share the VML file with comments, but need separate ctrlProp relationships
         if (model.formControls && model.formControls.length > 0) {
+            // Ensure a DrawingML drawing part exists for form controls.
+            // Excel often repairs sheets that have legacy controls but no <drawing> part.
+            let { drawing } = model;
+            if (!drawing) {
+                drawing = model.drawing = {
+                    rId: nextRid(rels),
+                    name: `drawing${++options.drawingsCount}`,
+                    anchors: [],
+                    rels: []
+                };
+                options.drawings.push(drawing);
+                rels.push({
+                    Id: drawing.rId,
+                    Type: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/drawing",
+                    Target: drawingRelTargetFromWorksheet(drawing.name)
+                });
+            }
             // If no comments, we need to add the VML drawing relationship for form controls
             if (model.comments.length === 0) {
                 rels.push({
@@ -286,6 +311,14 @@ class WorkSheetXform extends BaseXform {
                     Target: vmlDrawingRelTargetFromWorksheet(model.id)
                 });
             }
+            // Add hidden DrawingML shapes that bridge to the VML shape ids.
+            // This mirrors what Excel writes when it "repairs" legacy form controls.
+            const toNativePos = (p) => ({
+                nativeCol: p.col,
+                nativeColOff: p.colOff,
+                nativeRow: p.row,
+                nativeRowOff: p.rowOff
+            });
             // Add ctrlProp relationships for each form control
             for (const control of model.formControls) {
                 const globalCtrlPropId = options.formControlRefs.length + 1;
@@ -298,6 +331,22 @@ class WorkSheetXform extends BaseXform {
                     Target: ctrlPropRelTargetFromWorksheet(globalCtrlPropId)
                 });
                 options.formControlRefs.push(globalCtrlPropId);
+                const defaultName = `Check Box ${Math.max(1, control.shapeId - 1024)}`;
+                drawing.anchors.push({
+                    range: {
+                        editAs: "absolute",
+                        tl: toNativePos(control.tl),
+                        br: toNativePos(control.br)
+                    },
+                    alternateContent: { requires: "a14" },
+                    shape: {
+                        cNvPrId: control.shapeId,
+                        name: control.name || defaultName,
+                        hidden: true,
+                        spid: `_x0000_s${control.shapeId}`,
+                        text: control.text
+                    }
+                });
             }
         }
         // prepare ext items
@@ -305,7 +354,14 @@ class WorkSheetXform extends BaseXform {
     }
     render(xmlStream, model) {
         xmlStream.openXml(XmlStream.StdDocAttributes);
-        xmlStream.openNode("worksheet", WorkSheetXform.WORKSHEET_ATTRIBUTES);
+        const worksheetAttrs = { ...WorkSheetXform.WORKSHEET_ATTRIBUTES };
+        if (model.formControls && model.formControls.length > 0) {
+            worksheetAttrs["xmlns:x14"] = "http://schemas.microsoft.com/office/spreadsheetml/2009/9/main";
+            worksheetAttrs["xmlns:xdr"] =
+                "http://schemas.openxmlformats.org/drawingml/2006/spreadsheetDrawing";
+            worksheetAttrs["mc:Ignorable"] = `${worksheetAttrs["mc:Ignorable"]} x14`;
+        }
+        xmlStream.openNode("worksheet", worksheetAttrs);
         const sheetFormatPropertiesModel = model.properties
             ? {
                 defaultRowHeight: model.properties.defaultRowHeight,
@@ -355,26 +411,68 @@ class WorkSheetXform extends BaseXform {
         this.map.colBreaks.render(xmlStream, model.colBreaks);
         this.map.drawing.render(xmlStream, model.drawing); // Note: must be after rowBreaks/colBreaks
         this.map.picture.render(xmlStream, model.background); // Note: must be after drawing
-        this.map.tableParts.render(xmlStream, model.tables);
+        if (model.rels) {
+            // Add a <legacyDrawing /> node for each VML drawing relationship (comments and/or form controls).
+            // NOTE: Excel is picky about worksheet child element order; legacyDrawing must come before controls.
+            model.rels.forEach(rel => {
+                if (rel.Type === RelType.VmlDrawing) {
+                    xmlStream.leafNode("legacyDrawing", { "r:id": rel.Id });
+                }
+            });
+        }
         // Controls section for legacy form controls (checkboxes, etc.)
         // Excel expects <controls> entries that reference ctrlProp relationships.
         if (model.formControls && model.formControls.length > 0) {
+            xmlStream.openNode("mc:AlternateContent");
+            xmlStream.openNode("mc:Choice", { Requires: "x14" });
             xmlStream.openNode("controls");
             for (const control of model.formControls) {
-                if (control.ctrlPropRelId) {
-                    xmlStream.leafNode("control", { shapeId: control.shapeId, "r:id": control.ctrlPropRelId });
+                if (!control.ctrlPropRelId) {
+                    continue;
                 }
+                const defaultName = `Check Box ${Math.max(1, control.shapeId - 1024)}`;
+                xmlStream.openNode("mc:AlternateContent");
+                xmlStream.openNode("mc:Choice", { Requires: "x14" });
+                xmlStream.openNode("control", {
+                    shapeId: control.shapeId,
+                    "r:id": control.ctrlPropRelId,
+                    name: control.name || defaultName
+                });
+                xmlStream.openNode("controlPr", {
+                    locked: 0,
+                    defaultSize: 0,
+                    print: control.print ? 1 : 0,
+                    autoFill: 0,
+                    autoLine: 0,
+                    autoPict: 0
+                });
+                xmlStream.openNode("anchor");
+                xmlStream.openNode("from");
+                xmlStream.leafNode("xdr:col", undefined, control.tl.col);
+                xmlStream.leafNode("xdr:colOff", undefined, control.tl.colOff);
+                xmlStream.leafNode("xdr:row", undefined, control.tl.row);
+                xmlStream.leafNode("xdr:rowOff", undefined, control.tl.rowOff);
+                xmlStream.closeNode();
+                xmlStream.openNode("to");
+                xmlStream.leafNode("xdr:col", undefined, control.br.col);
+                xmlStream.leafNode("xdr:colOff", undefined, control.br.colOff);
+                xmlStream.leafNode("xdr:row", undefined, control.br.row);
+                xmlStream.leafNode("xdr:rowOff", undefined, control.br.rowOff);
+                xmlStream.closeNode(); // to
+                xmlStream.closeNode(); // anchor
+                xmlStream.closeNode(); // controlPr
+                xmlStream.closeNode(); // control
+                xmlStream.closeNode(); // mc:Choice
+                xmlStream.leafNode("mc:Fallback");
+                xmlStream.closeNode(); // mc:AlternateContent
             }
             xmlStream.closeNode();
+            xmlStream.closeNode();
+            xmlStream.leafNode("mc:Fallback");
+            xmlStream.closeNode();
         }
-        if (model.rels) {
-            // Add a <legacyDrawing /> node for each VML drawing relationship (comments and/or form controls).
-            model.rels.forEach(rel => {
-                if (rel.Type === RelType.VmlDrawing) {
-                    xmlStream.leafNode("legacyDrawing", { "r:id": rel.Id });
-                }
-            });
-        }
+        // Table parts must come after <controls> in worksheet element order.
+        this.map.tableParts.render(xmlStream, model.tables);
         // extLst should be the last element in the worksheet.
         this.map.extLst.render(xmlStream, model);
         xmlStream.closeNode();

package/dist/browser/modules/excel/xlsx/xform/strings/shared-string-xform.js

@@ -36,16 +36,15 @@ class SharedStringXform extends BaseXform {
         xmlStream.closeNode();
     }
     parseOpen(node) {
-        const { name } = node;
         if (this.parser) {
             this.parser.parseOpen(node);
             return true;
         }
-        if (name === this.tag) {
+        if (node.name === this.tag) {
             this.model = {};
             return true;
         }
-        this.parser = this.map[name];
+        this.parser = this.map[node.name];
         if (this.parser) {
             this.parser.parseOpen(node);
             return true;

package/dist/browser/modules/excel/xlsx/xform/strings/text-xform.js

@@ -13,14 +13,12 @@ class TextXform extends BaseXform {
         xmlStream.closeNode();
     }
     parseOpen(node) {
-        switch (node.name) {
-            case "t":
-                this._text = [];
-                this.model = ""; // Initialize model to empty string
-                return true;
-            default:
-                return false;
+        if (node.name === "t") {
+            this._text = [];
+            this.model = "";
+            return true;
         }
+        return false;
     }
     parseText(text) {
         this._text.push(text);

package/dist/browser/modules/excel/xlsx/xlsx.browser.js

@@ -30,8 +30,8 @@ import { theme1Xml } from "./xml/theme1.js";
 import { RelType } from "./rel-type.js";
 import { StreamBuf } from "../utils/stream-buf.js";
 import { bufferToString, base64ToUint8Array } from "../../../utils/utils.browser.js";
-import { StreamingZip, ZipDeflateFile } from "../../archive/streaming-zip.js";
-import { ZipParser } from "../../archive/index.browser.js";
+import { StreamingZip, ZipDeflateFile } from "../../archive/zip/stream.js";
+import { ZipParser } from "../../archive/unzip/zip-parser.js";
 import { PassThrough, concatUint8Arrays } from "../../stream/index.browser.js";
 import { commentsPath, commentsRelTargetFromWorksheetName, ctrlPropPath, drawingPath, drawingRelsPath, OOXML_REL_TARGETS, pivotTableRelTargetFromWorksheetName, pivotCacheDefinitionRelTargetFromWorkbook, getCommentsIndexFromPath, getDrawingNameFromPath, getDrawingNameFromRelsPath, getMediaFilenameFromPath, mediaPath, getPivotCacheDefinitionNameFromPath, getPivotCacheDefinitionNameFromRelsPath, getPivotCacheRecordsNameFromPath, getPivotTableNameFromPath, getPivotTableNameFromRelsPath, pivotCacheDefinitionPath, pivotCacheDefinitionRelsPath, pivotCacheDefinitionRelTargetFromPivotTable, pivotCacheRecordsPath, pivotCacheRecordsRelTarget, pivotTablePath, pivotTableRelsPath, getTableNameFromPath, tablePath, tableRelTargetFromWorksheetName, themePath, getThemeNameFromPath, getVmlDrawingNameFromPath, getWorksheetNoFromWorksheetPath, getWorksheetNoFromWorksheetRelsPath, isBinaryEntryPath, normalizeZipPath, OOXML_PATHS, vmlDrawingRelTargetFromWorksheetName, vmlDrawingPath, worksheetPath, worksheetRelsPath } from "../utils/ooxml-paths.js";
 class StreamingZipWriterAdapter {
@@ -126,10 +126,7 @@ class StreamingZipWriterAdapter {
             timestamps: this.timestamps
         });
         this.zip.add(file);
-        const pushResult = file.push(buffer, true);
-        if (pushResult && typeof pushResult.catch === "function") {
-            pushResult.catch((err) => this._emit("error", err));
-        }
+        file.push(buffer, true);
     }
     finalize() {
         if (this.finalized) {
@@ -367,8 +364,10 @@ class XLSX {
                     case OOXML_PATHS.docPropsApp: {
                         const appXform = new AppXform();
                         const appProperties = await appXform.parseStream(stream);
-                        model.company = appProperties.company;
-                        model.manager = appProperties.manager;
+                        if (appProperties) {
+                            model.company = appProperties.company;
+                            model.manager = appProperties.manager;
+                        }
                         break;
                     }
                     case OOXML_PATHS.docPropsCore: {
@@ -830,8 +829,10 @@ class XLSX {
                         case OOXML_PATHS.docPropsApp: {
                             const appXform = new AppXform();
                             const appProperties = await appXform.parseStream(stream);
-                            model.company = appProperties.company;
-                            model.manager = appProperties.manager;
+                            if (appProperties) {
+                                model.company = appProperties.company;
+                                model.manager = appProperties.manager;
+                            }
                             break;
                         }
                         case OOXML_PATHS.docPropsCore: {

package/dist/browser/modules/excel/xlsx/xlsx.js

@@ -16,7 +16,7 @@
 import fs from "fs";
 import { fileExists } from "../../../utils/utils.browser.js";
 import { XLSX as XLSXBase } from "./xlsx.browser.js";
-import { Parse } from "../../archive/index.browser.js";
+import { Parse } from "../../archive/unzip/stream.browser.js";
 import { Writable, pipeline } from "../../stream/index.browser.js";
 class XLSX extends XLSXBase {
     constructor(workbook) {

package/dist/browser/modules/stream/base-transform.d.ts

@@ -24,6 +24,8 @@ export declare abstract class BaseTransform<TInput = Uint8Array, TOutput = Uint8
     protected _errorEmitted: boolean;
     protected _objectMode: boolean;
     protected _highWaterMark: number;
+    private _ending;
+    private _flushInProgress;
     constructor(options?: BaseTransformOptions);
     /**
      * Main transform implementation - must be overridden by subclasses
@@ -49,6 +51,7 @@ export declare abstract class BaseTransform<TInput = Uint8Array, TOutput = Uint8
      * Process next chunk in buffer
      */
     private _processNext;
+    private _maybeFlush;
     /**
      * Emit error only once
      */

package/dist/browser/modules/stream/base-transform.js

@@ -17,6 +17,8 @@ export class BaseTransform extends EventEmitter {
         this._isDestroyed = false;
         this._isFinished = false;
         this._errorEmitted = false;
+        this._ending = false;
+        this._flushInProgress = false;
         this._objectMode = options.objectMode ?? false;
         this._highWaterMark = options.highWaterMark ?? 16384;
     }
@@ -45,26 +47,8 @@ export class BaseTransform extends EventEmitter {
         if (chunk !== undefined) {
             this.write(chunk);
         }
-        // Wait for buffer to drain, then flush
-        const checkAndFlush = () => {
-            if (this._buffer.length === this._bufferIndex && !this._isProcessing) {
-                this.processFlush((err, data) => {
-                    if (err) {
-                        this._emitError(err);
-                    }
-                    else if (data !== undefined) {
-                        this.emit("data", data);
-                    }
-                    this._isFinished = true;
-                    this.emit("finish");
-                    this.emit("end");
-                });
-            }
-            else {
-                setTimeout(checkAndFlush, 0);
-            }
-        };
-        checkAndFlush();
+        this._ending = true;
+        this._maybeFlush();
     }
     /**
      * Destroy the stream
@@ -113,13 +97,43 @@ export class BaseTransform extends EventEmitter {
                     }
                     // Process next chunk
                     this._processNext();
+                    this._maybeFlush();
                 }
             });
         }
         catch (err) {
             this._isProcessing = false;
             this._emitError(err);
+            this._maybeFlush();
+        }
+    }
+    _maybeFlush() {
+        if (!this._ending || this._isDestroyed || this._isFinished || this._flushInProgress) {
+            return;
         }
+        // If an error was emitted, stop flushing to avoid hanging end().
+        if (this._errorEmitted) {
+            this._isFinished = true;
+            this.emit("finish");
+            this.emit("end");
+            return;
+        }
+        if (this._isProcessing || this._bufferIndex < this._buffer.length) {
+            return;
+        }
+        this._flushInProgress = true;
+        this.processFlush((err, data) => {
+            this._flushInProgress = false;
+            if (err) {
+                this._emitError(err);
+            }
+            else if (data !== undefined) {
+                this.emit("data", data);
+            }
+            this._isFinished = true;
+            this.emit("finish");
+            this.emit("end");
+        });
     }
     /**
      * Emit error only once

package/dist/browser/modules/stream/buffered-stream.d.ts

@@ -5,14 +5,8 @@
  * Works identically in both browser and Node.js environments.
  */
 import { EventEmitter } from "@stream/event-emitter";
-/**
- * Represents a chunk of data with copy capabilities
- */
-export interface DataChunk {
-    readonly length: number;
-    copy(target: Uint8Array, targetOffset: number, offset: number, length: number): number;
-    toUint8Array(): Uint8Array;
-}
+import type { BufferedStreamOptions, DataChunk } from "@stream/types";
+export type { BufferedStreamOptions, DataChunk } from "@stream/types";
 /**
  * String chunk implementation
  */
@@ -34,10 +28,6 @@ export declare class BufferChunk implements DataChunk {
     copy(target: Uint8Array, targetOffset: number, offset: number, length: number): number;
     toUint8Array(): Uint8Array;
 }
-export interface BufferedStreamOptions {
-    /** Batch size for internal read-write buffers */
-    batchSize?: number;
-}
 /**
  * Browser-compatible Buffered Stream with efficient chunk management
  */

package/dist/browser/modules/stream/chunked-builder.js

@@ -45,7 +45,7 @@ export class ChunkedBuilder {
     _consolidate() {
         if (this._pieces.length > 0) {
             this._chunks.push(this._pieces.join(""));
-            this._pieces = [];
+            this._pieces.length = 0;
         }
     }
     /**
@@ -76,8 +76,8 @@ export class ChunkedBuilder {
      * Clear all content
      */
     clear() {
-        this._pieces = [];
-        this._chunks = [];
+        this._pieces.length = 0;
+        this._chunks.length = 0;
         this._totalLength = 0;
     }
     /**
@@ -99,7 +99,7 @@ export class ChunkedBuilder {
         // Has chunks - consolidate and join
         if (piecesLen > 0) {
             this._chunks.push(this._pieces.join(""));
-            this._pieces = [];
+            this._pieces.length = 0;
         }
         if (this._chunks.length === 1) {
             return this._chunks[0];

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

@@ -1,22 +1,16 @@
 /**
- * Stream Module (browser type surface)
+ * Stream Module (browser entry)
  *
- * Mirrors [src/modules/stream/index.ts] but explicitly re-exports from
- * ./streams.browser so we can enforce index export-surface parity.
+ * Mirrors the public surface of `./index.ts`, but exports the browser
+ * implementation from `./streams.browser`.
+ *
+ * This file is intentionally export-only (tree-shaking friendly).
  */
-import type { ReadableStreamOptions, WritableStreamOptions, TransformStreamOptions, DuplexStreamOptions, PullStreamOptions, BufferedStreamOptions, TransformCallback, FlushCallback, WriteCallback, DestroyCallback, IEventEmitter, IReadable, IWritable, ITransform, IDuplex, IPullStream, IBufferedStream, IPassThrough, ICollector, DataChunk, EventListener, PipelineSource, PipelineTransform, PipelineDestination, ReadWriteBufferOptions } from "@stream/types";
-export type { ReadableStreamOptions, WritableStreamOptions, TransformStreamOptions, DuplexStreamOptions, PullStreamOptions, BufferedStreamOptions, TransformCallback, FlushCallback, WriteCallback, DestroyCallback, IEventEmitter, IReadable, IWritable, ITransform, IDuplex, IPullStream, IBufferedStream, IPassThrough, ICollector, DataChunk, EventListener, PipelineSource, PipelineTransform, PipelineDestination, ReadWriteBufferOptions };
-import { Readable, Writable, Transform, Duplex, PassThrough, Collector, PullStream, BufferedStream, StringChunk, BufferChunk, createReadable, createWritable, createTransform, createCollector, createPassThrough, createPullStream, createBufferedStream, createReadableFromArray, createReadableFromAsyncIterable, createReadableFromGenerator, createReadableFromPromise, createDuplex, createEmptyReadable, createNullWritable, pipeline, finished, streamToPromise, streamToUint8Array, streamToBuffer, streamToString, drainStream, copyStream, addAbortSignal, compose, finishedAll, once, promisify, isReadable, isWritable, isTransform, isDuplex, isStream, isDestroyed, isDisturbed, isErrored, getDefaultHighWaterMark, setDefaultHighWaterMark, duplexPair, normalizeWritable as Writeable, consumers, promises } from "@stream/streams.browser";
-import type { PipelineOptions, FinishedOptions } from "@stream/streams.browser";
-export { Readable, Writable, Transform, Duplex, PassThrough, Collector, PullStream, BufferedStream, StringChunk, BufferChunk, createReadable, createWritable, createTransform, createCollector, createPassThrough, createPullStream, createBufferedStream, createReadableFromArray, createReadableFromAsyncIterable, createReadableFromGenerator, createReadableFromPromise, createDuplex, createEmptyReadable, createNullWritable, pipeline, finished, streamToPromise, streamToUint8Array, streamToBuffer, streamToString, drainStream, copyStream, addAbortSignal, compose, finishedAll, once, promisify, isReadable, isWritable, isTransform, isDuplex, isStream, isDestroyed, isDisturbed, isErrored, getDefaultHighWaterMark, setDefaultHighWaterMark, duplexPair, Writeable, consumers, promises };
-export type { PipelineOptions, FinishedOptions };
-import { EventEmitter } from "@stream/event-emitter";
-export { EventEmitter };
-import { ChunkedBuilder, TransactionalChunkedBuilder } from "@stream/chunked-builder";
-import type { ChunkedBuilderOptions, BuilderSnapshot } from "@stream/chunked-builder";
-export { ChunkedBuilder, TransactionalChunkedBuilder };
-export type { ChunkedBuilderOptions, BuilderSnapshot };
-import { textEncoder, textDecoder, stringToUint8Array, uint8ArrayToString, uint8ArrayEquals, uint8ArrayIndexOf, uint8ArraySlice, toUint8Array, bufferToString, concatUint8Arrays } from "@stream/shared";
-export { textEncoder, textDecoder, stringToUint8Array, uint8ArrayToString, uint8ArrayEquals, uint8ArrayIndexOf, uint8ArraySlice, toUint8Array, bufferToString, concatUint8Arrays };
-import { collect, text, json, bytes, fromString, fromJSON, fromBytes, transform, filter } from "@stream/utils";
-export { collect, text, json, bytes, fromString, fromJSON, fromBytes, transform, filter };
+export type { ReadableStreamOptions, WritableStreamOptions, TransformStreamOptions, DuplexStreamOptions, PullStreamOptions, BufferedStreamOptions, TransformCallback, FlushCallback, WriteCallback, DestroyCallback, IEventEmitter, IReadable, IWritable, ITransform, IDuplex, IPullStream, IBufferedStream, IPassThrough, ICollector, DataChunk, EventListener, PipelineSource, PipelineTransform, PipelineDestination, ReadWriteBufferOptions } from "@stream/types";
+export { Readable, Writable, Transform, Duplex, PassThrough, Collector, PullStream, BufferedStream, StringChunk, BufferChunk, createReadable, createWritable, createTransform, createCollector, createPassThrough, createPullStream, createBufferedStream, createReadableFromArray, createReadableFromAsyncIterable, createReadableFromGenerator, createReadableFromPromise, createDuplex, createEmptyReadable, createNullWritable, pipeline, finished, streamToPromise, streamToUint8Array, streamToBuffer, streamToString, drainStream, copyStream, addAbortSignal, compose, finishedAll, once, promisify, isReadable, isWritable, isTransform, isDuplex, isStream, isDestroyed, isDisturbed, isErrored, getDefaultHighWaterMark, setDefaultHighWaterMark, duplexPair, normalizeWritable as Writeable, consumers, promises } from "@stream/streams.browser";
+export type { PipelineOptions, FinishedOptions } from "@stream/streams.browser";
+export { EventEmitter } from "@stream/event-emitter";
+export { ChunkedBuilder, TransactionalChunkedBuilder } from "@stream/chunked-builder";
+export type { ChunkedBuilderOptions, BuilderSnapshot } from "@stream/chunked-builder";
+export { textEncoder, textDecoder, stringToUint8Array, uint8ArrayToString, uint8ArrayEquals, uint8ArrayIndexOf, uint8ArraySlice, toUint8Array, bufferToString, concatUint8Arrays } from "@stream/shared";
+export { collect, text, json, bytes, fromString, fromJSON, fromBytes, transform, filter } from "@stream/utils";

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

@@ -1,25 +1,13 @@
 /**
- * Stream Module (browser type surface)
+ * Stream Module (browser entry)
  *
- * Mirrors [src/modules/stream/index.ts] but explicitly re-exports from
- * ./streams.browser so we can enforce index export-surface parity.
+ * Mirrors the public surface of `./index.ts`, but exports the browser
+ * implementation from `./streams.browser`.
+ *
+ * This file is intentionally export-only (tree-shaking friendly).
  */
-// =============================================================================
-// Native Stream Classes and Functions (browser)
-// =============================================================================
-import { Readable, Writable, Transform, Duplex, PassThrough, Collector, PullStream, BufferedStream, StringChunk, BufferChunk, createReadable, createWritable, createTransform, createCollector, createPassThrough, createPullStream, createBufferedStream, createReadableFromArray, createReadableFromAsyncIterable, createReadableFromGenerator, createReadableFromPromise, createDuplex, createEmptyReadable, createNullWritable, pipeline, finished, streamToPromise, streamToUint8Array, streamToBuffer, streamToString, drainStream, copyStream, addAbortSignal, compose, finishedAll, once, promisify, isReadable, isWritable, isTransform, isDuplex, isStream, isDestroyed, isDisturbed, isErrored, getDefaultHighWaterMark, setDefaultHighWaterMark, duplexPair, normalizeWritable as Writeable, consumers, promises } from "./streams.browser.js";
-export { Readable, Writable, Transform, Duplex, PassThrough, Collector, PullStream, BufferedStream, StringChunk, BufferChunk, createReadable, createWritable, createTransform, createCollector, createPassThrough, createPullStream, createBufferedStream, createReadableFromArray, createReadableFromAsyncIterable, createReadableFromGenerator, createReadableFromPromise, createDuplex, createEmptyReadable, createNullWritable, pipeline, finished, streamToPromise, streamToUint8Array, streamToBuffer, streamToString, drainStream, copyStream, addAbortSignal, compose, finishedAll, once, promisify, isReadable, isWritable, isTransform, isDuplex, isStream, isDestroyed, isDisturbed, isErrored, getDefaultHighWaterMark, setDefaultHighWaterMark, duplexPair, Writeable, consumers, promises };
-import { EventEmitter } from "./event-emitter.js";
-export { EventEmitter };
-// =============================================================================
-// ChunkedBuilder (platform-independent)
-// =============================================================================
-import { ChunkedBuilder, TransactionalChunkedBuilder } from "./chunked-builder.js";
-export { ChunkedBuilder, TransactionalChunkedBuilder };
-// =============================================================================
-// Utility Functions (platform-independent)
-// =============================================================================
-import { textEncoder, textDecoder, stringToUint8Array, uint8ArrayToString, uint8ArrayEquals, uint8ArrayIndexOf, uint8ArraySlice, toUint8Array, bufferToString, concatUint8Arrays } from "./shared.js";
-export { textEncoder, textDecoder, stringToUint8Array, uint8ArrayToString, uint8ArrayEquals, uint8ArrayIndexOf, uint8ArraySlice, toUint8Array, bufferToString, concatUint8Arrays };
-import { collect, text, json, bytes, fromString, fromJSON, fromBytes, transform, filter } from "./utils.js";
-export { collect, text, json, bytes, fromString, fromJSON, fromBytes, transform, filter };
+export { Readable, Writable, Transform, Duplex, PassThrough, Collector, PullStream, BufferedStream, StringChunk, BufferChunk, createReadable, createWritable, createTransform, createCollector, createPassThrough, createPullStream, createBufferedStream, createReadableFromArray, createReadableFromAsyncIterable, createReadableFromGenerator, createReadableFromPromise, createDuplex, createEmptyReadable, createNullWritable, pipeline, finished, streamToPromise, streamToUint8Array, streamToBuffer, streamToString, drainStream, copyStream, addAbortSignal, compose, finishedAll, once, promisify, isReadable, isWritable, isTransform, isDuplex, isStream, isDestroyed, isDisturbed, isErrored, getDefaultHighWaterMark, setDefaultHighWaterMark, duplexPair, normalizeWritable as Writeable, consumers, promises } from "./streams.browser.js";
+export { EventEmitter } from "./event-emitter.js";
+export { ChunkedBuilder, TransactionalChunkedBuilder } from "./chunked-builder.js";
+export { textEncoder, textDecoder, stringToUint8Array, uint8ArrayToString, uint8ArrayEquals, uint8ArrayIndexOf, uint8ArraySlice, toUint8Array, bufferToString, concatUint8Arrays } from "./shared.js";
+export { collect, text, json, bytes, fromString, fromJSON, fromBytes, transform, filter } from "./utils.js";

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

@@ -1,49 +1,26 @@
 /**
- * Stream Module
+ * Stream Module (Node.js entry)
  *
- * Native stream implementations for Node.js and Browser.
+ * Public entrypoint for stream utilities and classes.
  *
- * - Node.js: Uses native `stream` module (Readable, Writable, Transform, Duplex, PassThrough)
- * - Browser: Uses Web Streams API (ReadableStream, WritableStream, TransformStream)
- *
- * Both implementations provide the same API for cross-platform compatibility.
+ * Notes:
+ * - This file is intentionally export-only (tree-shaking friendly).
+ * - Browser builds should import from `@stream/index.browser`.
  *
  * @example
- * ```typescript
- * import {
- *   Readable,
- *   Writable,
- *   Transform,
- *   Duplex,
- *   PassThrough,
- *   pipeline,
- *   createTransform,
- *   streamToUint8Array
- * } from './modules/stream';
- *
- * // Create a transform stream
- * const uppercase = createTransform<Uint8Array, Uint8Array>(chunk => {
- *   const text = new TextDecoder().decode(chunk);
- *   return new TextEncoder().encode(text.toUpperCase());
- * });
+ * ```ts
+ * import { pipeline, createTransform, createCollector } from "@stream";
  *
- * // Use pipeline for clean stream composition
- * await pipeline(readable, uppercase, writable);
+ * const upper = createTransform<Uint8Array, Uint8Array>(chunk => chunk);
+ * const out = createCollector<Uint8Array>();
+ * await pipeline(source, upper, out);
  * ```
  */
-import type { ReadableStreamOptions, WritableStreamOptions, TransformStreamOptions, DuplexStreamOptions, PullStreamOptions, BufferedStreamOptions, TransformCallback, FlushCallback, WriteCallback, DestroyCallback, IEventEmitter, IReadable, IWritable, ITransform, IDuplex, IPullStream, IBufferedStream, IPassThrough, ICollector, DataChunk, EventListener, PipelineSource, PipelineTransform, PipelineDestination, ReadWriteBufferOptions } from "@stream/types";
-export type { ReadableStreamOptions, WritableStreamOptions, TransformStreamOptions, DuplexStreamOptions, PullStreamOptions, BufferedStreamOptions, TransformCallback, FlushCallback, WriteCallback, DestroyCallback, IEventEmitter, IReadable, IWritable, ITransform, IDuplex, IPullStream, IBufferedStream, IPassThrough, ICollector, DataChunk, EventListener, PipelineSource, PipelineTransform, PipelineDestination, ReadWriteBufferOptions };
-import { Readable, Writable, Transform, Duplex, PassThrough, Collector, PullStream, BufferedStream, StringChunk, BufferChunk, createReadable, createWritable, createTransform, createCollector, createPassThrough, createPullStream, createBufferedStream, createReadableFromArray, createReadableFromAsyncIterable, createReadableFromGenerator, createReadableFromPromise, createDuplex, createEmptyReadable, createNullWritable, pipeline, finished, streamToPromise, streamToUint8Array, streamToBuffer, streamToString, drainStream, copyStream, addAbortSignal, compose, finishedAll, once, promisify, isReadable, isWritable, isTransform, isDuplex, isStream, isDestroyed, isDisturbed, isErrored, getDefaultHighWaterMark, setDefaultHighWaterMark, duplexPair, normalizeWritable as Writeable, consumers, promises } from "@stream/streams";
-import type { PipelineOptions, FinishedOptions } from "@stream/streams";
-export { Readable, Writable, Transform, Duplex, PassThrough, Collector, PullStream, BufferedStream, StringChunk, BufferChunk, createReadable, createWritable, createTransform, createCollector, createPassThrough, createPullStream, createBufferedStream, createReadableFromArray, createReadableFromAsyncIterable, createReadableFromGenerator, createReadableFromPromise, createDuplex, createEmptyReadable, createNullWritable, pipeline, finished, streamToPromise, streamToUint8Array, streamToBuffer, streamToString, drainStream, copyStream, addAbortSignal, compose, finishedAll, once, promisify, isReadable, isWritable, isTransform, isDuplex, isStream, isDestroyed, isDisturbed, isErrored, getDefaultHighWaterMark, setDefaultHighWaterMark, duplexPair, Writeable, consumers, promises };
-export type { PipelineOptions, FinishedOptions };
-import { EventEmitter } from "@stream/event-emitter";
-export { EventEmitter };
-import { ChunkedBuilder, TransactionalChunkedBuilder } from "@stream/chunked-builder";
-import type { ChunkedBuilderOptions, BuilderSnapshot } from "@stream/chunked-builder";
-export { ChunkedBuilder, TransactionalChunkedBuilder };
-export type { ChunkedBuilderOptions, BuilderSnapshot };
-import { textEncoder, textDecoder, stringToUint8Array, uint8ArrayToString, uint8ArrayEquals, uint8ArrayIndexOf, uint8ArraySlice, toUint8Array, bufferToString, concatUint8Arrays } from "@stream/shared";
-export { textEncoder, textDecoder, stringToUint8Array, uint8ArrayToString, uint8ArrayEquals, uint8ArrayIndexOf, uint8ArraySlice, toUint8Array, bufferToString, concatUint8Arrays };
-import { collect, text, json, bytes, fromString, fromJSON, fromBytes, transform, filter } from "@stream/utils";
-export { collect, text, json, bytes, fromString, fromJSON, fromBytes, transform, filter };
+export type { ReadableStreamOptions, WritableStreamOptions, TransformStreamOptions, DuplexStreamOptions, PullStreamOptions, BufferedStreamOptions, TransformCallback, FlushCallback, WriteCallback, DestroyCallback, IEventEmitter, IReadable, IWritable, ITransform, IDuplex, IPullStream, IBufferedStream, IPassThrough, ICollector, DataChunk, EventListener, PipelineSource, PipelineTransform, PipelineDestination, ReadWriteBufferOptions } from "@stream/types";
+export { Readable, Writable, Transform, Duplex, PassThrough, Collector, PullStream, BufferedStream, StringChunk, BufferChunk, createReadable, createWritable, createTransform, createCollector, createPassThrough, createPullStream, createBufferedStream, createReadableFromArray, createReadableFromAsyncIterable, createReadableFromGenerator, createReadableFromPromise, createDuplex, createEmptyReadable, createNullWritable, pipeline, finished, streamToPromise, streamToUint8Array, streamToBuffer, streamToString, drainStream, copyStream, addAbortSignal, compose, finishedAll, once, promisify, isReadable, isWritable, isTransform, isDuplex, isStream, isDestroyed, isDisturbed, isErrored, getDefaultHighWaterMark, setDefaultHighWaterMark, duplexPair, normalizeWritable as Writeable, consumers, promises } from "@stream/streams";
+export type { PipelineOptions, FinishedOptions } from "@stream/streams";
+export { EventEmitter } from "@stream/event-emitter";
+export { ChunkedBuilder, TransactionalChunkedBuilder } from "@stream/chunked-builder";
+export type { ChunkedBuilderOptions, BuilderSnapshot } from "@stream/chunked-builder";
+export { textEncoder, textDecoder, stringToUint8Array, uint8ArrayToString, uint8ArrayEquals, uint8ArrayIndexOf, uint8ArraySlice, toUint8Array, bufferToString, concatUint8Arrays } from "@stream/shared";
+export { collect, text, json, bytes, fromString, fromJSON, fromBytes, transform, filter } from "@stream/utils";