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

package/dist/cjs/modules/excel/xlsx/xform/drawing/two-cell-anchor-xform.js

@@ -5,6 +5,7 @@ const base_cell_anchor_xform_1 = require("./base-cell-anchor-xform.js");
 const static_xform_1 = require("../static-xform.js");
 const cell_position_xform_1 = require("./cell-position-xform.js");
 const pic_xform_1 = require("./pic-xform.js");
+const sp_xform_1 = require("./sp-xform.js");
 class TwoCellAnchorXform extends base_cell_anchor_xform_1.BaseCellAnchorXform {
     constructor() {
         super();
@@ -12,6 +13,7 @@ class TwoCellAnchorXform extends base_cell_anchor_xform_1.BaseCellAnchorXform {
             "xdr:from": new cell_position_xform_1.CellPositionXform({ tag: "xdr:from" }),
             "xdr:to": new cell_position_xform_1.CellPositionXform({ tag: "xdr:to" }),
             "xdr:pic": new pic_xform_1.PicXform(),
+            "xdr:sp": new sp_xform_1.SpXform(),
             "xdr:clientData": new static_xform_1.StaticXform({ tag: "xdr:clientData" })
         };
     }
@@ -19,15 +21,41 @@ class TwoCellAnchorXform extends base_cell_anchor_xform_1.BaseCellAnchorXform {
         return "xdr:twoCellAnchor";
     }
     prepare(model, options) {
-        this.map["xdr:pic"].prepare(model.picture, options);
+        if (model.picture) {
+            this.map["xdr:pic"].prepare(model.picture, options);
+        }
     }
     render(xmlStream, model) {
+        const wrapAlternateContent = !!model.alternateContent;
+        if (wrapAlternateContent) {
+            xmlStream.openNode("mc:AlternateContent", {
+                "xmlns:mc": "http://schemas.openxmlformats.org/markup-compatibility/2006"
+            });
+            xmlStream.openNode("mc:Choice", {
+                Requires: model.alternateContent?.requires,
+                ...(model.alternateContent?.requires === "a14"
+                    ? {
+                        "xmlns:a14": "http://schemas.microsoft.com/office/drawing/2010/main"
+                    }
+                    : {})
+            });
+        }
         xmlStream.openNode(this.tag, { editAs: model.range.editAs || "oneCell" });
         this.map["xdr:from"].render(xmlStream, model.range.tl);
         this.map["xdr:to"].render(xmlStream, model.range.br);
-        this.map["xdr:pic"].render(xmlStream, model.picture);
+        if (model.picture) {
+            this.map["xdr:pic"].render(xmlStream, model.picture);
+        }
+        else if (model.shape) {
+            this.map["xdr:sp"].render(xmlStream, model.shape);
+        }
         this.map["xdr:clientData"].render(xmlStream, {});
         xmlStream.closeNode();
+        if (wrapAlternateContent) {
+            xmlStream.closeNode(); // mc:Choice
+            xmlStream.leafNode("mc:Fallback");
+            xmlStream.closeNode(); // mc:AlternateContent
+        }
     }
     parseClose(name) {
         if (this.parser) {

package/dist/cjs/modules/excel/xlsx/xform/drawing/vml-drawing-xform.js

@@ -110,14 +110,22 @@ class VmlDrawingXform extends base_xform_1.BaseXform {
         }
         // ClientData - the core of the checkbox control
         xmlStream.openNode("x:ClientData", { ObjectType: "Checkbox" });
+        // Match Excel's VML patterns (similar to Note ClientData): include positioning and cell address.
+        // Omitting these can cause Excel to repair the sheet by dropping all legacy controls.
+        xmlStream.leafNode("x:MoveWithCells");
+        xmlStream.leafNode("x:SizeWithCells");
         // Anchor position
         xmlStream.openNode("x:Anchor");
         xmlStream.writeText(form_control_1.FormCheckbox.getVmlAnchor(control));
         xmlStream.closeNode();
+        // Protection / text locking
+        xmlStream.leafNode("x:Locked", undefined, "False");
+        xmlStream.leafNode("x:LockText", undefined, "True");
         // Print settings
         xmlStream.leafNode("x:PrintObject", undefined, control.print ? "True" : "False");
         xmlStream.leafNode("x:AutoFill", undefined, "False");
         xmlStream.leafNode("x:AutoLine", undefined, "False");
+        xmlStream.leafNode("x:TextHAlign", undefined, "Left");
         xmlStream.leafNode("x:TextVAlign", undefined, "Center");
         // Linked cell
         if (control.link) {
@@ -129,6 +137,9 @@ class VmlDrawingXform extends base_xform_1.BaseXform {
         }
         // Checked state (0 = unchecked, 1 = checked, 2 = mixed)
         xmlStream.leafNode("x:Checked", undefined, String(form_control_1.FormCheckbox.getVmlCheckedValue(control)));
+        // Cell address (0-based row/column)
+        xmlStream.leafNode("x:Row", undefined, String(control.tl.row));
+        xmlStream.leafNode("x:Column", undefined, String(control.tl.col));
         xmlStream.closeNode(); // x:ClientData
         xmlStream.closeNode(); // v:shape
     }

package/dist/cjs/modules/excel/xlsx/xform/sheet/page-setup-xform.js

@@ -39,13 +39,27 @@ class PageSetupXform extends base_xform_1.BaseXform {
     get tag() {
         return "pageSetup";
     }
+    _dpiToXml(value) {
+        // Excel commonly omits these attributes. 4294967295 is used as a sentinel default
+        // when parsing missing values; it should never be serialized back out.
+        if (value === undefined) {
+            return undefined;
+        }
+        if (!Number.isFinite(value)) {
+            return undefined;
+        }
+        if (value === 4294967295) {
+            return undefined;
+        }
+        return value;
+    }
     render(xmlStream, model) {
         if (model) {
             const attributes = {
                 paperSize: model.paperSize,
                 orientation: model.orientation,
-                horizontalDpi: model.horizontalDpi,
-                verticalDpi: model.verticalDpi,
+                horizontalDpi: this._dpiToXml(model.horizontalDpi),
+                verticalDpi: this._dpiToXml(model.verticalDpi),
                 pageOrder: pageOrderToXml(model.pageOrder),
                 blackAndWhite: booleanToXml(model.blackAndWhite),
                 draft: booleanToXml(model.draft),

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

@@ -140,6 +140,14 @@ class WorkSheetXform extends base_xform_1.BaseXform {
         options.merges = new merges_1.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);
@@ -281,6 +289,23 @@ class WorkSheetXform extends base_xform_1.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: (0, ooxml_paths_1.drawingRelTargetFromWorksheet)(drawing.name)
+                });
+            }
             // If no comments, we need to add the VML drawing relationship for form controls
             if (model.comments.length === 0) {
                 rels.push({
@@ -289,6 +314,14 @@ class WorkSheetXform extends base_xform_1.BaseXform {
                     Target: (0, ooxml_paths_1.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;
@@ -301,6 +334,22 @@ class WorkSheetXform extends base_xform_1.BaseXform {
                     Target: (0, ooxml_paths_1.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
@@ -308,7 +357,14 @@ class WorkSheetXform extends base_xform_1.BaseXform {
     }
     render(xmlStream, model) {
         xmlStream.openXml(xml_stream_1.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,
@@ -358,26 +414,68 @@ class WorkSheetXform extends base_xform_1.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 === rel_type_1.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 === rel_type_1.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/cjs/modules/stream/base-transform.js

@@ -20,6 +20,8 @@ class BaseTransform extends event_emitter_1.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;
     }
@@ -48,26 +50,8 @@ class BaseTransform extends event_emitter_1.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
@@ -116,13 +100,43 @@ class BaseTransform extends event_emitter_1.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/cjs/modules/stream/chunked-builder.js

@@ -48,7 +48,7 @@ class ChunkedBuilder {
     _consolidate() {
         if (this._pieces.length > 0) {
             this._chunks.push(this._pieces.join(""));
-            this._pieces = [];
+            this._pieces.length = 0;
         }
     }
     /**
@@ -79,8 +79,8 @@ class ChunkedBuilder {
      * Clear all content
      */
     clear() {
-        this._pieces = [];
-        this._chunks = [];
+        this._pieces.length = 0;
+        this._chunks.length = 0;
         this._totalLength = 0;
     }
     /**
@@ -102,7 +102,7 @@ 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/cjs/modules/stream/index.browser.js

@@ -1,17 +1,16 @@
 "use strict";
 /**
- * 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).
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.consumers = exports.Writeable = exports.duplexPair = exports.setDefaultHighWaterMark = exports.getDefaultHighWaterMark = exports.isErrored = exports.isDisturbed = exports.isDestroyed = exports.isStream = exports.isDuplex = exports.isTransform = exports.isWritable = exports.isReadable = exports.promisify = exports.once = exports.finishedAll = exports.compose = exports.addAbortSignal = exports.copyStream = exports.drainStream = exports.streamToString = exports.streamToBuffer = exports.streamToUint8Array = exports.streamToPromise = exports.finished = exports.pipeline = exports.createNullWritable = exports.createEmptyReadable = exports.createDuplex = exports.createReadableFromPromise = exports.createReadableFromGenerator = exports.createReadableFromAsyncIterable = exports.createReadableFromArray = exports.createBufferedStream = exports.createPullStream = exports.createPassThrough = exports.createCollector = exports.createTransform = exports.createWritable = exports.createReadable = exports.BufferChunk = exports.StringChunk = exports.BufferedStream = exports.PullStream = exports.Collector = exports.PassThrough = exports.Duplex = exports.Transform = exports.Writable = exports.Readable = void 0;
 exports.filter = exports.transform = exports.fromBytes = exports.fromJSON = exports.fromString = exports.bytes = exports.json = exports.text = exports.collect = exports.concatUint8Arrays = exports.bufferToString = exports.toUint8Array = exports.uint8ArraySlice = exports.uint8ArrayIndexOf = exports.uint8ArrayEquals = exports.uint8ArrayToString = exports.stringToUint8Array = exports.textDecoder = exports.textEncoder = exports.TransactionalChunkedBuilder = exports.ChunkedBuilder = exports.EventEmitter = exports.promises = void 0;
-// =============================================================================
-// Native Stream Classes and Functions (browser)
-// =============================================================================
-const streams_browser_1 = require("./streams.browser.js");
+var streams_browser_1 = require("./streams.browser.js");
 Object.defineProperty(exports, "Readable", { enumerable: true, get: function () { return streams_browser_1.Readable; } });
 Object.defineProperty(exports, "Writable", { enumerable: true, get: function () { return streams_browser_1.Writable; } });
 Object.defineProperty(exports, "Transform", { enumerable: true, get: function () { return streams_browser_1.Transform; } });
@@ -63,18 +62,12 @@ Object.defineProperty(exports, "duplexPair", { enumerable: true, get: function (
 Object.defineProperty(exports, "Writeable", { enumerable: true, get: function () { return streams_browser_1.normalizeWritable; } });
 Object.defineProperty(exports, "consumers", { enumerable: true, get: function () { return streams_browser_1.consumers; } });
 Object.defineProperty(exports, "promises", { enumerable: true, get: function () { return streams_browser_1.promises; } });
-const event_emitter_1 = require("./event-emitter.js");
+var event_emitter_1 = require("./event-emitter.js");
 Object.defineProperty(exports, "EventEmitter", { enumerable: true, get: function () { return event_emitter_1.EventEmitter; } });
-// =============================================================================
-// ChunkedBuilder (platform-independent)
-// =============================================================================
-const chunked_builder_1 = require("./chunked-builder.js");
+var chunked_builder_1 = require("./chunked-builder.js");
 Object.defineProperty(exports, "ChunkedBuilder", { enumerable: true, get: function () { return chunked_builder_1.ChunkedBuilder; } });
 Object.defineProperty(exports, "TransactionalChunkedBuilder", { enumerable: true, get: function () { return chunked_builder_1.TransactionalChunkedBuilder; } });
-// =============================================================================
-// Utility Functions (platform-independent)
-// =============================================================================
-const shared_1 = require("./shared.js");
+var shared_1 = require("./shared.js");
 Object.defineProperty(exports, "textEncoder", { enumerable: true, get: function () { return shared_1.textEncoder; } });
 Object.defineProperty(exports, "textDecoder", { enumerable: true, get: function () { return shared_1.textDecoder; } });
 Object.defineProperty(exports, "stringToUint8Array", { enumerable: true, get: function () { return shared_1.stringToUint8Array; } });
@@ -85,7 +78,7 @@ Object.defineProperty(exports, "uint8ArraySlice", { enumerable: true, get: funct
 Object.defineProperty(exports, "toUint8Array", { enumerable: true, get: function () { return shared_1.toUint8Array; } });
 Object.defineProperty(exports, "bufferToString", { enumerable: true, get: function () { return shared_1.bufferToString; } });
 Object.defineProperty(exports, "concatUint8Arrays", { enumerable: true, get: function () { return shared_1.concatUint8Arrays; } });
-const utils_1 = require("./utils.js");
+var utils_1 = require("./utils.js");
 Object.defineProperty(exports, "collect", { enumerable: true, get: function () { return utils_1.collect; } });
 Object.defineProperty(exports, "text", { enumerable: true, get: function () { return utils_1.text; } });
 Object.defineProperty(exports, "json", { enumerable: true, get: function () { return utils_1.json; } });

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

@@ -1,44 +1,26 @@
 "use strict";
 /**
- * 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);
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.consumers = exports.Writeable = exports.duplexPair = exports.setDefaultHighWaterMark = exports.getDefaultHighWaterMark = exports.isErrored = exports.isDisturbed = exports.isDestroyed = exports.isStream = exports.isDuplex = exports.isTransform = exports.isWritable = exports.isReadable = exports.promisify = exports.once = exports.finishedAll = exports.compose = exports.addAbortSignal = exports.copyStream = exports.drainStream = exports.streamToString = exports.streamToBuffer = exports.streamToUint8Array = exports.streamToPromise = exports.finished = exports.pipeline = exports.createNullWritable = exports.createEmptyReadable = exports.createDuplex = exports.createReadableFromPromise = exports.createReadableFromGenerator = exports.createReadableFromAsyncIterable = exports.createReadableFromArray = exports.createBufferedStream = exports.createPullStream = exports.createPassThrough = exports.createCollector = exports.createTransform = exports.createWritable = exports.createReadable = exports.BufferChunk = exports.StringChunk = exports.BufferedStream = exports.PullStream = exports.Collector = exports.PassThrough = exports.Duplex = exports.Transform = exports.Writable = exports.Readable = void 0;
 exports.filter = exports.transform = exports.fromBytes = exports.fromJSON = exports.fromString = exports.bytes = exports.json = exports.text = exports.collect = exports.concatUint8Arrays = exports.bufferToString = exports.toUint8Array = exports.uint8ArraySlice = exports.uint8ArrayIndexOf = exports.uint8ArrayEquals = exports.uint8ArrayToString = exports.stringToUint8Array = exports.textDecoder = exports.textEncoder = exports.TransactionalChunkedBuilder = exports.ChunkedBuilder = exports.EventEmitter = exports.promises = void 0;
-// =============================================================================
-// Native Stream Classes and Functions (platform-specific)
-// =============================================================================
-const streams_1 = require("./streams.js");
+var streams_1 = require("./streams.js");
 Object.defineProperty(exports, "Readable", { enumerable: true, get: function () { return streams_1.Readable; } });
 Object.defineProperty(exports, "Writable", { enumerable: true, get: function () { return streams_1.Writable; } });
 Object.defineProperty(exports, "Transform", { enumerable: true, get: function () { return streams_1.Transform; } });
@@ -90,18 +72,12 @@ Object.defineProperty(exports, "duplexPair", { enumerable: true, get: function (
 Object.defineProperty(exports, "Writeable", { enumerable: true, get: function () { return streams_1.normalizeWritable; } });
 Object.defineProperty(exports, "consumers", { enumerable: true, get: function () { return streams_1.consumers; } });
 Object.defineProperty(exports, "promises", { enumerable: true, get: function () { return streams_1.promises; } });
-const event_emitter_1 = require("./event-emitter.js");
+var event_emitter_1 = require("./event-emitter.js");
 Object.defineProperty(exports, "EventEmitter", { enumerable: true, get: function () { return event_emitter_1.EventEmitter; } });
-// =============================================================================
-// ChunkedBuilder (platform-independent)
-// =============================================================================
-const chunked_builder_1 = require("./chunked-builder.js");
+var chunked_builder_1 = require("./chunked-builder.js");
 Object.defineProperty(exports, "ChunkedBuilder", { enumerable: true, get: function () { return chunked_builder_1.ChunkedBuilder; } });
 Object.defineProperty(exports, "TransactionalChunkedBuilder", { enumerable: true, get: function () { return chunked_builder_1.TransactionalChunkedBuilder; } });
-// =============================================================================
-// Utility Functions (platform-independent)
-// =============================================================================
-const shared_1 = require("./shared.js");
+var shared_1 = require("./shared.js");
 Object.defineProperty(exports, "textEncoder", { enumerable: true, get: function () { return shared_1.textEncoder; } });
 Object.defineProperty(exports, "textDecoder", { enumerable: true, get: function () { return shared_1.textDecoder; } });
 Object.defineProperty(exports, "stringToUint8Array", { enumerable: true, get: function () { return shared_1.stringToUint8Array; } });
@@ -112,7 +88,7 @@ Object.defineProperty(exports, "uint8ArraySlice", { enumerable: true, get: funct
 Object.defineProperty(exports, "toUint8Array", { enumerable: true, get: function () { return shared_1.toUint8Array; } });
 Object.defineProperty(exports, "bufferToString", { enumerable: true, get: function () { return shared_1.bufferToString; } });
 Object.defineProperty(exports, "concatUint8Arrays", { enumerable: true, get: function () { return shared_1.concatUint8Arrays; } });
-const utils_1 = require("./utils.js");
+var utils_1 = require("./utils.js");
 Object.defineProperty(exports, "collect", { enumerable: true, get: function () { return utils_1.collect; } });
 Object.defineProperty(exports, "text", { enumerable: true, get: function () { return utils_1.text; } });
 Object.defineProperty(exports, "json", { enumerable: true, get: function () { return utils_1.json; } });

package/dist/cjs/modules/stream/internal/event-utils.js

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * Small event utilities for Node-style emitters.
+ *
+ * Prefer keeping this separate from the main stream implementation so other
+ * modules (e.g. archive) can reuse it without pulling in the whole stream API.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.onceEvent = onceEvent;
+function off(emitter, event, listener) {
+    if (typeof emitter.off === "function") {
+        emitter.off(event, listener);
+    }
+    else if (typeof emitter.removeListener === "function") {
+        emitter.removeListener(event, listener);
+    }
+}
+/**
+ * Resolve when an emitter fires `event`, reject on `error`.
+ */
+function onceEvent(emitter, event) {
+    return new Promise((resolve, reject) => {
+        const onError = (err) => {
+            cleanup();
+            reject(err instanceof Error ? err : new Error(String(err)));
+        };
+        const onDone = () => {
+            cleanup();
+            resolve();
+        };
+        const cleanup = () => {
+            off(emitter, "error", onError);
+            off(emitter, event, onDone);
+        };
+        if (typeof emitter.once === "function") {
+            emitter.once("error", onError);
+            emitter.once(event, onDone);
+            return;
+        }
+        emitter.on?.("error", onError);
+        emitter.on?.(event, onDone);
+    });
+}

package/dist/cjs/modules/stream/internal/type-guards.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * Lightweight runtime type guards shared across modules.
+ *
+ * Keep this file dependency-free to maximize deduping in bundled builds.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isReadableStream = isReadableStream;
+exports.isWritableStream = isWritableStream;
+exports.isAsyncIterable = isAsyncIterable;
+exports.isTransformStream = isTransformStream;
+function isReadableStream(value) {
+    return !!value && typeof value === "object" && typeof value.getReader === "function";
+}
+function isWritableStream(value) {
+    return !!value && typeof value === "object" && typeof value.getWriter === "function";
+}
+function isAsyncIterable(value) {
+    return (!!value &&
+        (typeof value === "object" || typeof value === "function") &&
+        typeof value[Symbol.asyncIterator] === "function");
+}
+function isTransformStream(value) {
+    return (!!value &&
+        typeof value === "object" &&
+        !!value.readable &&
+        !!value.writable &&
+        isReadableStream(value.readable) &&
+        isWritableStream(value.writable));
+}