@cj-tech-master/excelts 4.2.1 → 4.2.2

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

@@ -2,6 +2,7 @@ import { BaseCellAnchorXform } from "./base-cell-anchor-xform.js";
 import { StaticXform } from "../static-xform.js";
 import { CellPositionXform } from "./cell-position-xform.js";
 import { PicXform } from "./pic-xform.js";
+import { SpXform } from "./sp-xform.js";
 class TwoCellAnchorXform extends BaseCellAnchorXform {
     constructor() {
         super();
@@ -9,6 +10,7 @@ class TwoCellAnchorXform extends BaseCellAnchorXform {
             "xdr:from": new CellPositionXform({ tag: "xdr:from" }),
             "xdr:to": new CellPositionXform({ tag: "xdr:to" }),
             "xdr:pic": new PicXform(),
+            "xdr:sp": new SpXform(),
             "xdr:clientData": new StaticXform({ tag: "xdr:clientData" })
         };
     }
@@ -16,15 +18,41 @@ class TwoCellAnchorXform extends 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/esm/modules/excel/xlsx/xform/drawing/vml-drawing-xform.js

@@ -107,14 +107,22 @@ class VmlDrawingXform extends 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(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) {
@@ -126,6 +134,9 @@ class VmlDrawingXform extends BaseXform {
         }
         // Checked state (0 = unchecked, 1 = checked, 2 = mixed)
         xmlStream.leafNode("x:Checked", undefined, String(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/esm/modules/excel/xlsx/xform/sheet/page-setup-xform.js

@@ -36,13 +36,27 @@ class PageSetupXform extends 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/esm/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/esm/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.js";
-import { StreamingZip, ZipDeflateFile } from "../../archive/streaming-zip.js";
-import { ZipParser } from "../../archive/index.js";
+import { StreamingZip, ZipDeflateFile } from "../../archive/zip/stream.js";
+import { ZipParser } from "../../archive/unzip/zip-parser.js";
 import { PassThrough, concatUint8Arrays } from "../../stream/index.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) {

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

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

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

@@ -1,52 +1,23 @@
 /**
- * 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.js';
- *
- * // 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 "./index.js";
  *
- * // 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);
  * ```
  */
-// =============================================================================
-// Native Stream Classes and Functions (platform-specific)
-// =============================================================================
-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.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.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/esm/modules/stream/internal/event-utils.js

@@ -0,0 +1,40 @@
+/**
+ * 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.
+ */
+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`.
+ */
+export 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/esm/modules/stream/internal/type-guards.js

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