@rushstack/stream-collator 4.1.125 → 4.2.0

package/CHANGELOG.json

@@ -1,6 +1,41 @@
 {
   "name": "@rushstack/stream-collator",
   "entries": [
+    {
+      "version": "4.2.0",
+      "tag": "@rushstack/stream-collator_v4.2.0",
+      "date": "Thu, 19 Feb 2026 00:04:53 GMT",
+      "comments": {
+        "minor": [
+          {
+            "comment": "Normalize package layout. CommonJS is now under `lib-commonjs`, DTS is now under `lib-dts`, and ESM is now under `lib-esm`. Imports to `lib` still work as before, handled by the `\"exports\"` field in `package.json`."
+          }
+        ],
+        "dependency": [
+          {
+            "comment": "Updating dependency \"@rushstack/node-core-library\" to `5.20.0`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/terminal\" to `0.22.0`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/heft\" to `1.2.0`"
+          }
+        ]
+      }
+    },
+    {
+      "version": "4.1.126",
+      "tag": "@rushstack/stream-collator_v4.1.126",
+      "date": "Sat, 07 Feb 2026 01:13:26 GMT",
+      "comments": {
+        "dependency": [
+          {
+            "comment": "Updating dependency \"@rushstack/heft\" to `1.1.14`"
+          }
+        ]
+      }
+    },
     {
       "version": "4.1.125",
       "tag": "@rushstack/stream-collator_v4.1.125",

package/CHANGELOG.md

@@ -1,6 +1,18 @@
 # Change Log - @rushstack/stream-collator
 
-This log was last generated on Wed, 04 Feb 2026 20:42:47 GMT and should not be manually modified.
+This log was last generated on Thu, 19 Feb 2026 00:04:53 GMT and should not be manually modified.
+
+## 4.2.0
+Thu, 19 Feb 2026 00:04:53 GMT
+
+### Minor changes
+
+- Normalize package layout. CommonJS is now under `lib-commonjs`, DTS is now under `lib-dts`, and ESM is now under `lib-esm`. Imports to `lib` still work as before, handled by the `"exports"` field in `package.json`.
+
+## 4.1.126
+Sat, 07 Feb 2026 01:13:26 GMT
+
+_Version update only_
 
 ## 4.1.125
 Wed, 04 Feb 2026 20:42:47 GMT

package/dist/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.56.1"
+      "packageVersion": "7.56.3"
     }
   ]
 }

package/lib-esm/CollatedTerminal.js

@@ -0,0 +1,23 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import { TerminalChunkKind } from '@rushstack/terminal';
+/**
+ * This API was introduced as a temporary measure.
+ * @deprecated Very soon we plan to replace this with the `Terminal` API from `@rushstack/node-core-library`.
+ * @beta
+ */
+export class CollatedTerminal {
+    constructor(destination) {
+        this._destination = destination;
+    }
+    writeChunk(chunk) {
+        this._destination.writeChunk(chunk);
+    }
+    writeStdoutLine(message) {
+        this._destination.writeChunk({ text: message + '\n', kind: TerminalChunkKind.Stdout });
+    }
+    writeStderrLine(message) {
+        this._destination.writeChunk({ text: message + '\n', kind: TerminalChunkKind.Stderr });
+    }
+}
+//# sourceMappingURL=CollatedTerminal.js.map

package/lib-esm/CollatedTerminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CollatedTerminal.js","sourceRoot":"","sources":["../src/CollatedTerminal.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAE3D,OAAO,EAAuB,iBAAiB,EAAyB,MAAM,qBAAqB,CAAC;AAEpG;;;;GAIG;AACH,MAAM,OAAO,gBAAgB;IAG3B,YAAmB,WAA6B;QAC9C,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;IAClC,CAAC;IAEM,UAAU,CAAC,KAAqB;QACrC,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAEM,eAAe,CAAC,OAAe;QACpC,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,EAAE,IAAI,EAAE,iBAAiB,CAAC,MAAM,EAAE,CAAC,CAAC;IACzF,CAAC;IAEM,eAAe,CAAC,OAAe;QACpC,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,EAAE,IAAI,EAAE,iBAAiB,CAAC,MAAM,EAAE,CAAC,CAAC;IACzF,CAAC;CACF","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport { type ITerminalChunk, TerminalChunkKind, type TerminalWritable } from '@rushstack/terminal';\n\n/**\n * This API was introduced as a temporary measure.\n * @deprecated Very soon we plan to replace this with the `Terminal` API from `@rushstack/node-core-library`.\n * @beta\n */\nexport class CollatedTerminal {\n  private readonly _destination: TerminalWritable;\n\n  public constructor(destination: TerminalWritable) {\n    this._destination = destination;\n  }\n\n  public writeChunk(chunk: ITerminalChunk): void {\n    this._destination.writeChunk(chunk);\n  }\n\n  public writeStdoutLine(message: string): void {\n    this._destination.writeChunk({ text: message + '\\n', kind: TerminalChunkKind.Stdout });\n  }\n\n  public writeStderrLine(message: string): void {\n    this._destination.writeChunk({ text: message + '\\n', kind: TerminalChunkKind.Stderr });\n  }\n}\n"]}

package/lib-esm/CollatedWriter.js

@@ -0,0 +1,47 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import { TerminalWritable } from '@rushstack/terminal';
+import { CollatedTerminal } from './CollatedTerminal';
+/**
+ * An writable interface for managing output of simultaneous processes.
+ *
+ * @beta
+ */
+export class CollatedWriter extends TerminalWritable {
+    constructor(taskName, collator) {
+        super({ preventAutoclose: true });
+        this.taskName = taskName;
+        this.terminal = new CollatedTerminal(this);
+        this._collator = collator;
+        this._bufferedChunks = [];
+    }
+    /**
+     * Returns true if this is the active writer for its associated {@link StreamCollator}.
+     */
+    get isActive() {
+        return this._collator.activeWriter === this;
+    }
+    /**
+     * For diagnostic purposes, if the writer is buffering chunks because it has
+     * not become active yet, they can be inspected via this property.
+     */
+    get bufferedChunks() {
+        return this._bufferedChunks;
+    }
+    /** {@inheritDoc @rushstack/terminal#TerminalWritable.onWriteChunk} */
+    onWriteChunk(chunk) {
+        this._collator._writerWriteChunk(this, chunk, this._bufferedChunks);
+    }
+    /** {@inheritDoc @rushstack/terminal#TerminalWritable.onClose} */
+    onClose() {
+        this._collator._writerClose(this, this._bufferedChunks);
+    }
+    /** @internal */
+    _flushBufferedChunks() {
+        for (const chunk of this._bufferedChunks) {
+            this._collator.destination.writeChunk(chunk);
+        }
+        this._bufferedChunks.length = 0;
+    }
+}
+//# sourceMappingURL=CollatedWriter.js.map

package/lib-esm/CollatedWriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CollatedWriter.js","sourceRoot":"","sources":["../src/CollatedWriter.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAE3D,OAAO,EAAuB,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,OAAO,cAAe,SAAQ,gBAAgB;IAOlD,YAAmB,QAAgB,EAAE,QAAwB;QAC3D,KAAK,CAAC,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC;QAElC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAE3C,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAE1B,IAAI,CAAC,eAAe,GAAG,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,IAAW,QAAQ;QACjB,OAAO,IAAI,CAAC,SAAS,CAAC,YAAY,KAAK,IAAI,CAAC;IAC9C,CAAC;IAED;;;OAGG;IACH,IAAW,cAAc;QACvB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED,sEAAsE;IAC/D,YAAY,CAAC,KAAqB;QACvC,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;IACtE,CAAC;IAED,iEAAiE;IAC1D,OAAO;QACZ,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;IAC1D,CAAC;IAED,gBAAgB;IACT,oBAAoB;QACzB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC;IAClC,CAAC;CACF","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport { type ITerminalChunk, TerminalWritable } from '@rushstack/terminal';\n\nimport type { StreamCollator } from './StreamCollator';\nimport { CollatedTerminal } from './CollatedTerminal';\n\n/**\n * An writable interface for managing output of simultaneous processes.\n *\n * @beta\n */\nexport class CollatedWriter extends TerminalWritable {\n  private readonly _collator: StreamCollator;\n  private readonly _bufferedChunks: ITerminalChunk[];\n\n  public readonly taskName: string;\n  public readonly terminal: CollatedTerminal;\n\n  public constructor(taskName: string, collator: StreamCollator) {\n    super({ preventAutoclose: true });\n\n    this.taskName = taskName;\n    this.terminal = new CollatedTerminal(this);\n\n    this._collator = collator;\n\n    this._bufferedChunks = [];\n  }\n\n  /**\n   * Returns true if this is the active writer for its associated {@link StreamCollator}.\n   */\n  public get isActive(): boolean {\n    return this._collator.activeWriter === this;\n  }\n\n  /**\n   * For diagnostic purposes, if the writer is buffering chunks because it has\n   * not become active yet, they can be inspected via this property.\n   */\n  public get bufferedChunks(): ReadonlyArray<ITerminalChunk> {\n    return this._bufferedChunks;\n  }\n\n  /** {@inheritDoc @rushstack/terminal#TerminalWritable.onWriteChunk} */\n  public onWriteChunk(chunk: ITerminalChunk): void {\n    this._collator._writerWriteChunk(this, chunk, this._bufferedChunks);\n  }\n\n  /** {@inheritDoc @rushstack/terminal#TerminalWritable.onClose} */\n  public onClose(): void {\n    this._collator._writerClose(this, this._bufferedChunks);\n  }\n\n  /** @internal */\n  public _flushBufferedChunks(): void {\n    for (const chunk of this._bufferedChunks) {\n      this._collator.destination.writeChunk(chunk);\n    }\n    this._bufferedChunks.length = 0;\n  }\n}\n"]}

package/lib-esm/StreamCollator.js

@@ -0,0 +1,144 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import { InternalError } from '@rushstack/node-core-library';
+import { CollatedWriter } from './CollatedWriter';
+import { CollatedTerminal } from './CollatedTerminal';
+/**
+ * A static class which manages the output of multiple threads.
+ *
+ * @beta
+ */
+export class StreamCollator {
+    constructor(options) {
+        this._taskNames = new Set();
+        this._writers = new Set();
+        // The writer whose output is being shown in realtime, or undefined if none
+        this._activeWriter = undefined;
+        // Writers that are not closed yet, and have never been active
+        this._openInactiveWriters = new Set();
+        // Writers that are now closed, but have accumulated buffered chunks, and have never been active
+        this._closedInactiveWriters = new Set();
+        this._preventReentrantCall = false;
+        this.destination = options.destination;
+        this.terminal = new CollatedTerminal(this.destination);
+        this._onWriterActive = options.onWriterActive;
+    }
+    /**
+     * Returns the currently active `CollatedWriter`, or `undefined` if no writer
+     * is active yet.
+     */
+    get activeWriter() {
+        return this._activeWriter;
+    }
+    /**
+     * For diagnostic purposes, returns the {@link CollatedWriter.taskName} for the
+     * currently active writer, or an empty string if no writer is active.
+     */
+    get activeTaskName() {
+        if (this._activeWriter) {
+            return this._activeWriter.taskName;
+        }
+        return '';
+    }
+    /**
+     * The list of writers that have been registered by calling {@link StreamCollator.registerTask},
+     * in the order that they were registered.
+     */
+    get writers() {
+        return this._writers;
+    }
+    /**
+     * Registers a new task to be collated, and constructs a {@link CollatedWriter} object
+     * to receive its input.
+     */
+    registerTask(taskName) {
+        if (this._taskNames.has(taskName)) {
+            throw new Error('A task with that name has already been registered');
+        }
+        const writer = new CollatedWriter(taskName, this);
+        this._writers.add(writer);
+        this._taskNames.add(writer.taskName);
+        // When a task is initially registered, it is open and has not accumulated any buffered chunks
+        this._openInactiveWriters.add(writer);
+        if (this._activeWriter === undefined) {
+            // If there is no active writer, then the first one to be registered becomes active.
+            this._assignActiveWriter(writer);
+        }
+        return writer;
+    }
+    /** @internal */
+    _writerWriteChunk(writer, chunk, bufferedChunks) {
+        this._checkForReentrantCall();
+        if (this._activeWriter === undefined) {
+            // If no writer is currently active, then the first one to write something becomes active
+            this._assignActiveWriter(writer);
+        }
+        if (writer.isActive) {
+            this.destination.writeChunk(chunk);
+        }
+        else {
+            bufferedChunks.push(chunk);
+        }
+    }
+    /** @internal */
+    _writerClose(writer, bufferedChunks) {
+        this._checkForReentrantCall();
+        if (writer.isActive) {
+            writer._flushBufferedChunks();
+            this._activeWriter = undefined;
+            // If any buffered writers are already closed, activate them each immediately
+            // We copy the set, since _assignActiveWriter() will be deleting from it.
+            for (const closedInactiveWriter of [...this._closedInactiveWriters]) {
+                try {
+                    this._assignActiveWriter(closedInactiveWriter);
+                }
+                finally {
+                    this._activeWriter = undefined;
+                }
+            }
+            let writerToActivate = undefined;
+            // Try to activate a writer that already accumulated some data
+            for (const openInactiveWriter of this._openInactiveWriters) {
+                if (openInactiveWriter.bufferedChunks.length > 0) {
+                    writerToActivate = openInactiveWriter;
+                    break;
+                }
+            }
+            if (!writerToActivate) {
+                // Otherwise just take the first one
+                for (const openInactiveWriter of this._openInactiveWriters) {
+                    writerToActivate = openInactiveWriter;
+                    break;
+                }
+            }
+            if (writerToActivate) {
+                this._assignActiveWriter(writerToActivate);
+            }
+        }
+        else {
+            this._openInactiveWriters.delete(writer);
+            this._closedInactiveWriters.add(writer);
+        }
+    }
+    _assignActiveWriter(writer) {
+        this._activeWriter = writer;
+        this._closedInactiveWriters.delete(writer);
+        this._openInactiveWriters.delete(writer);
+        if (this._onWriterActive) {
+            this._preventReentrantCall = true;
+            try {
+                this._onWriterActive(writer);
+            }
+            finally {
+                this._preventReentrantCall = false;
+            }
+        }
+        writer._flushBufferedChunks();
+    }
+    _checkForReentrantCall() {
+        if (this._preventReentrantCall) {
+            throw new InternalError('Reentrant call to StreamCollator');
+        }
+    }
+}
+//# sourceMappingURL=StreamCollator.js.map

package/lib-esm/StreamCollator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamCollator.js","sourceRoot":"","sources":["../src/StreamCollator.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport { InternalError } from '@rushstack/node-core-library';\nimport type { TerminalWritable, ITerminalChunk } from '@rushstack/terminal';\n\nimport { CollatedWriter } from './CollatedWriter';\nimport { CollatedTerminal } from './CollatedTerminal';\n\n/**\n * Constructor options for {@link StreamCollator}.\n *\n * @beta\n */\nexport interface IStreamCollatorOptions {\n  /**\n   * The target {@link @rushstack/terminal#TerminalWritable} object that the\n   * {@link StreamCollator} will write its output to.\n   */\n  destination: TerminalWritable;\n\n  /**\n   * An event handler that is called when a {@link CollatedWriter} becomes output,\n   * before any of its chunks have been written to the destination.\n   *\n   * @remarks\n   *\n   * Each `CollatedWriter` object will become active exactly once\n   * before the `StreamCollator` completes.\n   */\n  onWriterActive?: (writer: CollatedWriter) => void;\n}\n\n/**\n * A static class which manages the output of multiple threads.\n *\n * @beta\n */\nexport class StreamCollator {\n  private _taskNames: Set<string> = new Set();\n  private _writers: Set<CollatedWriter> = new Set();\n\n  // The writer whose output is being shown in realtime, or undefined if none\n  private _activeWriter: CollatedWriter | undefined = undefined;\n\n  // Writers that are not closed yet, and have never been active\n  private _openInactiveWriters: Set<CollatedWriter> = new Set();\n\n  // Writers that are now closed, but have accumulated buffered chunks, and have never been active\n  private _closedInactiveWriters: Set<CollatedWriter> = new Set();\n\n  private _onWriterActive: ((writer: CollatedWriter) => void) | undefined;\n\n  private _preventReentrantCall: boolean = false;\n\n  public readonly destination: TerminalWritable;\n  public readonly terminal: CollatedTerminal;\n\n  public constructor(options: IStreamCollatorOptions) {\n    this.destination = options.destination;\n    this.terminal = new CollatedTerminal(this.destination);\n    this._onWriterActive = options.onWriterActive;\n  }\n\n  /**\n   * Returns the currently active `CollatedWriter`, or `undefined` if no writer\n   * is active yet.\n   */\n  public get activeWriter(): CollatedWriter | undefined {\n    return this._activeWriter;\n  }\n\n  /**\n   * For diagnostic purposes, returns the {@link CollatedWriter.taskName} for the\n   * currently active writer, or an empty string if no writer is active.\n   */\n  public get activeTaskName(): string {\n    if (this._activeWriter) {\n      return this._activeWriter.taskName;\n    }\n    return '';\n  }\n\n  /**\n   * The list of writers that have been registered by calling {@link StreamCollator.registerTask},\n   * in the order that they were registered.\n   */\n  public get writers(): ReadonlySet<CollatedWriter> {\n    return this._writers;\n  }\n\n  /**\n   * Registers a new task to be collated, and constructs a {@link CollatedWriter} object\n   * to receive its input.\n   */\n  public registerTask(taskName: string): CollatedWriter {\n    if (this._taskNames.has(taskName)) {\n      throw new Error('A task with that name has already been registered');\n    }\n\n    const writer: CollatedWriter = new CollatedWriter(taskName, this);\n\n    this._writers.add(writer);\n    this._taskNames.add(writer.taskName);\n\n    // When a task is initially registered, it is open and has not accumulated any buffered chunks\n    this._openInactiveWriters.add(writer);\n\n    if (this._activeWriter === undefined) {\n      // If there is no active writer, then the first one to be registered becomes active.\n      this._assignActiveWriter(writer);\n    }\n\n    return writer;\n  }\n\n  /** @internal */\n  public _writerWriteChunk(\n    writer: CollatedWriter,\n    chunk: ITerminalChunk,\n    bufferedChunks: ITerminalChunk[]\n  ): void {\n    this._checkForReentrantCall();\n\n    if (this._activeWriter === undefined) {\n      // If no writer is currently active, then the first one to write something becomes active\n      this._assignActiveWriter(writer);\n    }\n\n    if (writer.isActive) {\n      this.destination.writeChunk(chunk);\n    } else {\n      bufferedChunks.push(chunk);\n    }\n  }\n\n  /** @internal */\n  public _writerClose(writer: CollatedWriter, bufferedChunks: ITerminalChunk[]): void {\n    this._checkForReentrantCall();\n\n    if (writer.isActive) {\n      writer._flushBufferedChunks();\n\n      this._activeWriter = undefined;\n\n      // If any buffered writers are already closed, activate them each immediately\n      // We copy the set, since _assignActiveWriter() will be deleting from it.\n      for (const closedInactiveWriter of [...this._closedInactiveWriters]) {\n        try {\n          this._assignActiveWriter(closedInactiveWriter);\n        } finally {\n          this._activeWriter = undefined;\n        }\n      }\n\n      let writerToActivate: CollatedWriter | undefined = undefined;\n\n      // Try to activate a writer that already accumulated some data\n      for (const openInactiveWriter of this._openInactiveWriters) {\n        if (openInactiveWriter.bufferedChunks.length > 0) {\n          writerToActivate = openInactiveWriter;\n          break;\n        }\n      }\n      if (!writerToActivate) {\n        // Otherwise just take the first one\n        for (const openInactiveWriter of this._openInactiveWriters) {\n          writerToActivate = openInactiveWriter;\n          break;\n        }\n      }\n\n      if (writerToActivate) {\n        this._assignActiveWriter(writerToActivate);\n      }\n    } else {\n      this._openInactiveWriters.delete(writer);\n      this._closedInactiveWriters.add(writer);\n    }\n  }\n\n  private _assignActiveWriter(writer: CollatedWriter): void {\n    this._activeWriter = writer;\n\n    this._closedInactiveWriters.delete(writer);\n    this._openInactiveWriters.delete(writer);\n\n    if (this._onWriterActive) {\n      this._preventReentrantCall = true;\n      try {\n        this._onWriterActive(writer);\n      } finally {\n        this._preventReentrantCall = false;\n      }\n    }\n\n    writer._flushBufferedChunks();\n  }\n\n  private _checkForReentrantCall(): void {\n    if (this._preventReentrantCall) {\n      throw new InternalError('Reentrant call to StreamCollator');\n    }\n  }\n}\n"]}

package/lib-esm/index.js

@@ -0,0 +1,17 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+/**
+ * This library enables a tool to display live console output from multiple concurrent processes,
+ * while ensuring that their output does not get jumbled together.
+ *
+ * @remarks
+ *
+ * For more info, please see the package {@link https://www.npmjs.com/package/@rushstack/stream-collator
+ * | README}.
+ *
+ * @packageDocumentation
+ */
+export { CollatedTerminal } from './CollatedTerminal';
+export { CollatedWriter } from './CollatedWriter';
+export { StreamCollator } from './StreamCollator';
+//# sourceMappingURL=index.js.map

package/lib-esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAE3D;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,cAAc,EAA+B,MAAM,kBAAkB,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\n/**\n * This library enables a tool to display live console output from multiple concurrent processes,\n * while ensuring that their output does not get jumbled together.\n *\n * @remarks\n *\n * For more info, please see the package {@link https://www.npmjs.com/package/@rushstack/stream-collator\n * | README}.\n *\n * @packageDocumentation\n */\n\nexport { CollatedTerminal } from './CollatedTerminal';\nexport { CollatedWriter } from './CollatedWriter';\nexport { StreamCollator, type IStreamCollatorOptions } from './StreamCollator';\n"]}

package/package.json

@@ -1,24 +1,46 @@
 {
   "name": "@rushstack/stream-collator",
-  "version": "4.1.125",
+  "version": "4.2.0",
   "description": "Display intelligible realtime output from concurrent processes",
   "repository": {
     "type": "git",
     "url": "https://github.com/microsoft/rushstack.git",
     "directory": "libraries/stream-collator"
   },
-  "main": "lib/index.js",
-  "typings": "dist/stream-collator.d.ts",
+  "main": "./lib-commonjs/index.js",
+  "module": "./lib-esm/index.js",
+  "types": "./dist/stream-collator.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/stream-collator.d.ts",
+      "import": "./lib-esm/index.js",
+      "require": "./lib-commonjs/index.js"
+    },
+    "./lib/*": {
+      "types": "./lib-dts/*.d.ts",
+      "import": "./lib-esm/*.js",
+      "require": "./lib-commonjs/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "lib/*": [
+        "lib-dts/*"
+      ]
+    }
+  },
   "license": "MIT",
   "dependencies": {
-    "@rushstack/node-core-library": "5.19.1",
-    "@rushstack/terminal": "0.21.0"
+    "@rushstack/terminal": "0.22.0",
+    "@rushstack/node-core-library": "5.20.0"
   },
   "devDependencies": {
     "eslint": "~9.37.0",
-    "@rushstack/heft": "1.1.13",
+    "@rushstack/heft": "1.2.0",
     "local-node-rig": "1.0.0"
   },
+  "sideEffects": false,
   "scripts": {
     "build": "heft build --clean",
     "_phase:build": "heft run --only build -- --clean",