@rushstack/terminal 0.7.24 → 0.8.0

package/lib/Terminal.d.ts

@@ -0,0 +1,63 @@
+import { type ITerminalProvider } from './ITerminalProvider';
+import type { ITerminal, TerminalWriteParameters } from './ITerminal';
+/**
+ * This class facilitates writing to a console.
+ *
+ * @beta
+ */
+export declare class Terminal implements ITerminal {
+    private _providers;
+    constructor(provider: ITerminalProvider);
+    /**
+     * {@inheritdoc ITerminal.registerProvider}
+     */
+    registerProvider(provider: ITerminalProvider): void;
+    /**
+     * {@inheritdoc ITerminal.unregisterProvider}
+     */
+    unregisterProvider(provider: ITerminalProvider): void;
+    /**
+     * {@inheritdoc ITerminal.write}
+     */
+    write(...messageParts: TerminalWriteParameters): void;
+    /**
+     * {@inheritdoc ITerminal.writeLine}
+     */
+    writeLine(...messageParts: TerminalWriteParameters): void;
+    /**
+     * {@inheritdoc ITerminal.writeWarning}
+     */
+    writeWarning(...messageParts: TerminalWriteParameters): void;
+    /**
+     * {@inheritdoc ITerminal.writeWarningLine}
+     */
+    writeWarningLine(...messageParts: TerminalWriteParameters): void;
+    /**
+     * {@inheritdoc ITerminal.writeError}
+     */
+    writeError(...messageParts: TerminalWriteParameters): void;
+    /**
+     * {@inheritdoc ITerminal.writeErrorLine}
+     */
+    writeErrorLine(...messageParts: TerminalWriteParameters): void;
+    /**
+     * {@inheritdoc ITerminal.writeVerbose}
+     */
+    writeVerbose(...messageParts: TerminalWriteParameters): void;
+    /**
+     * {@inheritdoc ITerminal.writeVerboseLine}
+     */
+    writeVerboseLine(...messageParts: TerminalWriteParameters): void;
+    /**
+     * {@inheritdoc ITerminal.writeDebug}
+     */
+    writeDebug(...messageParts: TerminalWriteParameters): void;
+    /**
+     * {@inheritdoc ITerminal.writeDebugLine}
+     */
+    writeDebugLine(...messageParts: TerminalWriteParameters): void;
+    private _writeSegmentsToProviders;
+    private _serializeLegacyColorableSequence;
+    private _normalizeWriteParameters;
+}
+//# sourceMappingURL=Terminal.d.ts.map

package/lib/Terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Terminal.d.ts","sourceRoot":"","sources":["../src/Terminal.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,iBAAiB,EAA4B,MAAM,qBAAqB,CAAC;AAEvF,OAAO,KAAK,EAAE,SAAS,EAAyB,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAsC7F;;;;GAIG;AACH,qBAAa,QAAS,YAAW,SAAS;IACxC,OAAO,CAAC,UAAU,CAAyB;gBAExB,QAAQ,EAAE,iBAAiB;IAK9C;;OAEG;IACI,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAI1D;;OAEG;IACI,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAM5D;;OAEG;IACI,KAAK,CAAC,GAAG,YAAY,EAAE,uBAAuB,GAAG,IAAI;IAK5D;;OAEG;IACI,SAAS,CAAC,GAAG,YAAY,EAAE,uBAAuB,GAAG,IAAI;IAKhE;;OAEG;IACI,YAAY,CAAC,GAAG,YAAY,EAAE,uBAAuB,GAAG,IAAI;IAcnE;;OAEG;IACI,gBAAgB,CAAC,GAAG,YAAY,EAAE,uBAAuB,GAAG,IAAI;IAcvE;;OAEG;IACI,UAAU,CAAC,GAAG,YAAY,EAAE,uBAAuB,GAAG,IAAI;IAYjE;;OAEG;IACI,cAAc,CAAC,GAAG,YAAY,EAAE,uBAAuB,GAAG,IAAI;IAYrE;;OAEG;IACI,YAAY,CAAC,GAAG,YAAY,EAAE,uBAAuB,GAAG,IAAI;IAKnE;;OAEG;IACI,gBAAgB,CAAC,GAAG,YAAY,EAAE,uBAAuB,GAAG,IAAI;IAKvE;;OAEG;IACI,UAAU,CAAC,GAAG,YAAY,EAAE,uBAAuB,GAAG,IAAI;IAKjE;;OAEG;IACI,cAAc,CAAC,GAAG,YAAY,EAAE,uBAAuB,GAAG,IAAI;IAKrE,OAAO,CAAC,yBAAyB;IA6DjC,OAAO,CAAC,iCAAiC;IA6KzC,OAAO,CAAC,yBAAyB;CAelC"}

package/lib/Terminal.js

@@ -0,0 +1,348 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Terminal = void 0;
+const ITerminalProvider_1 = require("./ITerminalProvider");
+const Colorize_1 = require("./Colorize");
+const AnsiEscape_1 = require("./AnsiEscape");
+/**
+ * Colors used with {@link ILegacyColorableSequence}.
+ */
+var ColorValue;
+(function (ColorValue) {
+    ColorValue[ColorValue["Black"] = 0] = "Black";
+    ColorValue[ColorValue["Red"] = 1] = "Red";
+    ColorValue[ColorValue["Green"] = 2] = "Green";
+    ColorValue[ColorValue["Yellow"] = 3] = "Yellow";
+    ColorValue[ColorValue["Blue"] = 4] = "Blue";
+    ColorValue[ColorValue["Magenta"] = 5] = "Magenta";
+    ColorValue[ColorValue["Cyan"] = 6] = "Cyan";
+    ColorValue[ColorValue["White"] = 7] = "White";
+    ColorValue[ColorValue["Gray"] = 8] = "Gray";
+})(ColorValue || (ColorValue = {}));
+/**
+ * Text styles used with {@link ILegacyColorableSequence}.
+ */
+var TextAttribute;
+(function (TextAttribute) {
+    TextAttribute[TextAttribute["Bold"] = 0] = "Bold";
+    TextAttribute[TextAttribute["Dim"] = 1] = "Dim";
+    TextAttribute[TextAttribute["Underline"] = 2] = "Underline";
+    TextAttribute[TextAttribute["Blink"] = 3] = "Blink";
+    TextAttribute[TextAttribute["InvertColor"] = 4] = "InvertColor";
+    TextAttribute[TextAttribute["Hidden"] = 5] = "Hidden";
+})(TextAttribute || (TextAttribute = {}));
+/**
+ * This class facilitates writing to a console.
+ *
+ * @beta
+ */
+class Terminal {
+    constructor(provider) {
+        this._providers = new Set();
+        this._providers.add(provider);
+    }
+    /**
+     * {@inheritdoc ITerminal.registerProvider}
+     */
+    registerProvider(provider) {
+        this._providers.add(provider);
+    }
+    /**
+     * {@inheritdoc ITerminal.unregisterProvider}
+     */
+    unregisterProvider(provider) {
+        if (this._providers.has(provider)) {
+            this._providers.delete(provider);
+        }
+    }
+    /**
+     * {@inheritdoc ITerminal.write}
+     */
+    write(...messageParts) {
+        const { parts } = this._normalizeWriteParameters(messageParts);
+        this._writeSegmentsToProviders(parts, ITerminalProvider_1.TerminalProviderSeverity.log, false);
+    }
+    /**
+     * {@inheritdoc ITerminal.writeLine}
+     */
+    writeLine(...messageParts) {
+        const { parts } = this._normalizeWriteParameters(messageParts);
+        this._writeSegmentsToProviders(parts, ITerminalProvider_1.TerminalProviderSeverity.log, true);
+    }
+    /**
+     * {@inheritdoc ITerminal.writeWarning}
+     */
+    writeWarning(...messageParts) {
+        const { parts, options: { doNotOverrideSgrCodes } } = this._normalizeWriteParameters(messageParts);
+        this._writeSegmentsToProviders(doNotOverrideSgrCodes
+            ? parts
+            : parts.map((part) => Colorize_1.Colorize.yellow(AnsiEscape_1.AnsiEscape.removeCodes(part))), ITerminalProvider_1.TerminalProviderSeverity.warning, false);
+    }
+    /**
+     * {@inheritdoc ITerminal.writeWarningLine}
+     */
+    writeWarningLine(...messageParts) {
+        const { parts, options: { doNotOverrideSgrCodes } } = this._normalizeWriteParameters(messageParts);
+        this._writeSegmentsToProviders(doNotOverrideSgrCodes
+            ? parts
+            : parts.map((part) => Colorize_1.Colorize.yellow(AnsiEscape_1.AnsiEscape.removeCodes(part))), ITerminalProvider_1.TerminalProviderSeverity.warning, true);
+    }
+    /**
+     * {@inheritdoc ITerminal.writeError}
+     */
+    writeError(...messageParts) {
+        const { parts, options: { doNotOverrideSgrCodes } } = this._normalizeWriteParameters(messageParts);
+        this._writeSegmentsToProviders(doNotOverrideSgrCodes ? parts : parts.map((part) => Colorize_1.Colorize.red(AnsiEscape_1.AnsiEscape.removeCodes(part))), ITerminalProvider_1.TerminalProviderSeverity.error, false);
+    }
+    /**
+     * {@inheritdoc ITerminal.writeErrorLine}
+     */
+    writeErrorLine(...messageParts) {
+        const { parts, options: { doNotOverrideSgrCodes } } = this._normalizeWriteParameters(messageParts);
+        this._writeSegmentsToProviders(doNotOverrideSgrCodes ? parts : parts.map((part) => Colorize_1.Colorize.red(AnsiEscape_1.AnsiEscape.removeCodes(part))), ITerminalProvider_1.TerminalProviderSeverity.error, true);
+    }
+    /**
+     * {@inheritdoc ITerminal.writeVerbose}
+     */
+    writeVerbose(...messageParts) {
+        const { parts } = this._normalizeWriteParameters(messageParts);
+        this._writeSegmentsToProviders(parts, ITerminalProvider_1.TerminalProviderSeverity.verbose, false);
+    }
+    /**
+     * {@inheritdoc ITerminal.writeVerboseLine}
+     */
+    writeVerboseLine(...messageParts) {
+        const { parts } = this._normalizeWriteParameters(messageParts);
+        this._writeSegmentsToProviders(parts, ITerminalProvider_1.TerminalProviderSeverity.verbose, true);
+    }
+    /**
+     * {@inheritdoc ITerminal.writeDebug}
+     */
+    writeDebug(...messageParts) {
+        const { parts } = this._normalizeWriteParameters(messageParts);
+        this._writeSegmentsToProviders(parts, ITerminalProvider_1.TerminalProviderSeverity.debug, false);
+    }
+    /**
+     * {@inheritdoc ITerminal.writeDebugLine}
+     */
+    writeDebugLine(...messageParts) {
+        const { parts } = this._normalizeWriteParameters(messageParts);
+        this._writeSegmentsToProviders(parts, ITerminalProvider_1.TerminalProviderSeverity.debug, true);
+    }
+    _writeSegmentsToProviders(segments, severity, followedByEol) {
+        const linesSegments = [[]];
+        let currentLineSegments = linesSegments[0];
+        for (const segment of segments) {
+            if (typeof segment === 'string') {
+                currentLineSegments.push(segment);
+            }
+            else {
+                if (segment.isEol) {
+                    linesSegments.push([]);
+                    currentLineSegments = linesSegments[linesSegments.length - 1];
+                }
+                else {
+                    currentLineSegments.push(this._serializeLegacyColorableSequence(segment));
+                }
+            }
+        }
+        const lines = [];
+        for (const lineSegments of linesSegments) {
+            lines.push(lineSegments.join(''));
+        }
+        if (followedByEol) {
+            lines.push('');
+        }
+        let linesWithoutColor;
+        const concatenatedLinesWithColorByNewlineChar = new Map();
+        const concatenatedLinesWithoutColorByNewlineChar = new Map();
+        for (const provider of this._providers) {
+            let textToWrite;
+            const eol = provider.eolCharacter;
+            if (provider.supportsColor) {
+                textToWrite = concatenatedLinesWithColorByNewlineChar.get(eol);
+                if (!textToWrite) {
+                    textToWrite = lines.join(eol);
+                    concatenatedLinesWithColorByNewlineChar.set(eol, textToWrite);
+                }
+            }
+            else {
+                textToWrite = concatenatedLinesWithoutColorByNewlineChar.get(eol);
+                if (!textToWrite) {
+                    if (!linesWithoutColor) {
+                        linesWithoutColor = [];
+                        for (const line of lines) {
+                            linesWithoutColor.push(AnsiEscape_1.AnsiEscape.removeCodes(line));
+                        }
+                    }
+                    textToWrite = linesWithoutColor.join(eol);
+                    concatenatedLinesWithoutColorByNewlineChar.set(eol, textToWrite);
+                }
+            }
+            provider.write(textToWrite, severity);
+        }
+    }
+    _serializeLegacyColorableSequence(segment) {
+        const startColorCodes = [];
+        const endColorCodes = [];
+        switch (segment.foregroundColor) {
+            case ColorValue.Black: {
+                startColorCodes.push(Colorize_1.SgrParameterAttribute.BlackForeground);
+                endColorCodes.push(Colorize_1.SgrParameterAttribute.DefaultForeground);
+                break;
+            }
+            case ColorValue.Red: {
+                startColorCodes.push(Colorize_1.SgrParameterAttribute.RedForeground);
+                endColorCodes.push(Colorize_1.SgrParameterAttribute.DefaultForeground);
+                break;
+            }
+            case ColorValue.Green: {
+                startColorCodes.push(Colorize_1.SgrParameterAttribute.GreenForeground);
+                endColorCodes.push(Colorize_1.SgrParameterAttribute.DefaultForeground);
+                break;
+            }
+            case ColorValue.Yellow: {
+                startColorCodes.push(Colorize_1.SgrParameterAttribute.YellowForeground);
+                endColorCodes.push(Colorize_1.SgrParameterAttribute.DefaultForeground);
+                break;
+            }
+            case ColorValue.Blue: {
+                startColorCodes.push(Colorize_1.SgrParameterAttribute.BlueForeground);
+                endColorCodes.push(Colorize_1.SgrParameterAttribute.DefaultForeground);
+                break;
+            }
+            case ColorValue.Magenta: {
+                startColorCodes.push(Colorize_1.SgrParameterAttribute.MagentaForeground);
+                endColorCodes.push(Colorize_1.SgrParameterAttribute.DefaultForeground);
+                break;
+            }
+            case ColorValue.Cyan: {
+                startColorCodes.push(Colorize_1.SgrParameterAttribute.CyanForeground);
+                endColorCodes.push(Colorize_1.SgrParameterAttribute.DefaultForeground);
+                break;
+            }
+            case ColorValue.White: {
+                startColorCodes.push(Colorize_1.SgrParameterAttribute.WhiteForeground);
+                endColorCodes.push(Colorize_1.SgrParameterAttribute.DefaultForeground);
+                break;
+            }
+            case ColorValue.Gray: {
+                startColorCodes.push(Colorize_1.SgrParameterAttribute.GrayForeground);
+                endColorCodes.push(Colorize_1.SgrParameterAttribute.DefaultForeground);
+                break;
+            }
+        }
+        switch (segment.backgroundColor) {
+            case ColorValue.Black: {
+                startColorCodes.push(Colorize_1.SgrParameterAttribute.BlackBackground);
+                endColorCodes.push(Colorize_1.SgrParameterAttribute.DefaultBackground);
+                break;
+            }
+            case ColorValue.Red: {
+                startColorCodes.push(Colorize_1.SgrParameterAttribute.RedBackground);
+                endColorCodes.push(Colorize_1.SgrParameterAttribute.DefaultBackground);
+                break;
+            }
+            case ColorValue.Green: {
+                startColorCodes.push(Colorize_1.SgrParameterAttribute.GreenBackground);
+                endColorCodes.push(Colorize_1.SgrParameterAttribute.DefaultBackground);
+                break;
+            }
+            case ColorValue.Yellow: {
+                startColorCodes.push(Colorize_1.SgrParameterAttribute.YellowBackground);
+                endColorCodes.push(Colorize_1.SgrParameterAttribute.DefaultBackground);
+                break;
+            }
+            case ColorValue.Blue: {
+                startColorCodes.push(Colorize_1.SgrParameterAttribute.BlueBackground);
+                endColorCodes.push(Colorize_1.SgrParameterAttribute.DefaultBackground);
+                break;
+            }
+            case ColorValue.Magenta: {
+                startColorCodes.push(Colorize_1.SgrParameterAttribute.MagentaBackground);
+                endColorCodes.push(Colorize_1.SgrParameterAttribute.DefaultBackground);
+                break;
+            }
+            case ColorValue.Cyan: {
+                startColorCodes.push(Colorize_1.SgrParameterAttribute.CyanBackground);
+                endColorCodes.push(Colorize_1.SgrParameterAttribute.DefaultBackground);
+                break;
+            }
+            case ColorValue.White: {
+                startColorCodes.push(Colorize_1.SgrParameterAttribute.WhiteBackground);
+                endColorCodes.push(Colorize_1.SgrParameterAttribute.DefaultBackground);
+                break;
+            }
+            case ColorValue.Gray: {
+                startColorCodes.push(Colorize_1.SgrParameterAttribute.GrayBackground);
+                endColorCodes.push(49);
+                break;
+            }
+        }
+        if (segment.textAttributes) {
+            for (const textAttribute of segment.textAttributes) {
+                switch (textAttribute) {
+                    case TextAttribute.Bold: {
+                        startColorCodes.push(Colorize_1.SgrParameterAttribute.Bold);
+                        endColorCodes.push(Colorize_1.SgrParameterAttribute.NormalColorOrIntensity);
+                        break;
+                    }
+                    case TextAttribute.Dim: {
+                        startColorCodes.push(Colorize_1.SgrParameterAttribute.Dim);
+                        endColorCodes.push(Colorize_1.SgrParameterAttribute.NormalColorOrIntensity);
+                        break;
+                    }
+                    case TextAttribute.Underline: {
+                        startColorCodes.push(Colorize_1.SgrParameterAttribute.Underline);
+                        endColorCodes.push(Colorize_1.SgrParameterAttribute.UnderlineOff);
+                        break;
+                    }
+                    case TextAttribute.Blink: {
+                        startColorCodes.push(Colorize_1.SgrParameterAttribute.Blink);
+                        endColorCodes.push(Colorize_1.SgrParameterAttribute.BlinkOff);
+                        break;
+                    }
+                    case TextAttribute.InvertColor: {
+                        startColorCodes.push(Colorize_1.SgrParameterAttribute.InvertColor);
+                        endColorCodes.push(Colorize_1.SgrParameterAttribute.InvertColorOff);
+                        break;
+                    }
+                    case TextAttribute.Hidden: {
+                        startColorCodes.push(Colorize_1.SgrParameterAttribute.Hidden);
+                        endColorCodes.push(Colorize_1.SgrParameterAttribute.HiddenOff);
+                        break;
+                    }
+                }
+            }
+        }
+        const resultSegments = [];
+        for (let j = 0; j < startColorCodes.length; j++) {
+            const code = startColorCodes[j];
+            resultSegments.push(AnsiEscape_1.AnsiEscape.getEscapeSequenceForAnsiCode(code));
+        }
+        resultSegments.push(segment.text);
+        for (let j = endColorCodes.length - 1; j >= 0; j--) {
+            const code = endColorCodes[j];
+            resultSegments.push(AnsiEscape_1.AnsiEscape.getEscapeSequenceForAnsiCode(code));
+        }
+        return resultSegments.join('');
+    }
+    _normalizeWriteParameters(parameters) {
+        if (parameters.length === 0) {
+            return { parts: [], options: {} };
+        }
+        else {
+            const lastParameter = parameters[parameters.length - 1];
+            if (typeof lastParameter === 'string') {
+                return { parts: parameters, options: {} };
+            }
+            else {
+                return { parts: parameters.slice(0, -1), options: lastParameter };
+            }
+        }
+    }
+}
+exports.Terminal = Terminal;
+//# sourceMappingURL=Terminal.js.map

package/lib/Terminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Terminal.js","sourceRoot":"","sources":["../src/Terminal.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 { type ITerminalProvider, TerminalProviderSeverity } from './ITerminalProvider';\nimport { Colorize, SgrParameterAttribute } from './Colorize';\nimport type { ITerminal, ITerminalWriteOptions, TerminalWriteParameters } from './ITerminal';\nimport { AnsiEscape } from './AnsiEscape';\n\n/**\n * Colors used with {@link ILegacyColorableSequence}.\n */\nenum ColorValue {\n  Black,\n  Red,\n  Green,\n  Yellow,\n  Blue,\n  Magenta,\n  Cyan,\n  White,\n  Gray\n}\n\n/**\n * Text styles used with {@link ILegacyColorableSequence}.\n */\nenum TextAttribute {\n  Bold,\n  Dim,\n  Underline,\n  Blink,\n  InvertColor,\n  Hidden\n}\n\ninterface ILegacyColorableSequence {\n  text: string;\n  isEol?: boolean;\n  foregroundColor?: ColorValue;\n  backgroundColor?: ColorValue;\n  textAttributes?: TextAttribute[];\n}\n\n/**\n * This class facilitates writing to a console.\n *\n * @beta\n */\nexport class Terminal implements ITerminal {\n  private _providers: Set<ITerminalProvider>;\n\n  public constructor(provider: ITerminalProvider) {\n    this._providers = new Set<ITerminalProvider>();\n    this._providers.add(provider);\n  }\n\n  /**\n   * {@inheritdoc ITerminal.registerProvider}\n   */\n  public registerProvider(provider: ITerminalProvider): void {\n    this._providers.add(provider);\n  }\n\n  /**\n   * {@inheritdoc ITerminal.unregisterProvider}\n   */\n  public unregisterProvider(provider: ITerminalProvider): void {\n    if (this._providers.has(provider)) {\n      this._providers.delete(provider);\n    }\n  }\n\n  /**\n   * {@inheritdoc ITerminal.write}\n   */\n  public write(...messageParts: TerminalWriteParameters): void {\n    const { parts } = this._normalizeWriteParameters(messageParts);\n    this._writeSegmentsToProviders(parts, TerminalProviderSeverity.log, false);\n  }\n\n  /**\n   * {@inheritdoc ITerminal.writeLine}\n   */\n  public writeLine(...messageParts: TerminalWriteParameters): void {\n    const { parts } = this._normalizeWriteParameters(messageParts);\n    this._writeSegmentsToProviders(parts, TerminalProviderSeverity.log, true);\n  }\n\n  /**\n   * {@inheritdoc ITerminal.writeWarning}\n   */\n  public writeWarning(...messageParts: TerminalWriteParameters): void {\n    const {\n      parts,\n      options: { doNotOverrideSgrCodes }\n    } = this._normalizeWriteParameters(messageParts);\n    this._writeSegmentsToProviders(\n      doNotOverrideSgrCodes\n        ? parts\n        : parts.map((part): string => Colorize.yellow(AnsiEscape.removeCodes(part))),\n      TerminalProviderSeverity.warning,\n      false\n    );\n  }\n\n  /**\n   * {@inheritdoc ITerminal.writeWarningLine}\n   */\n  public writeWarningLine(...messageParts: TerminalWriteParameters): void {\n    const {\n      parts,\n      options: { doNotOverrideSgrCodes }\n    } = this._normalizeWriteParameters(messageParts);\n    this._writeSegmentsToProviders(\n      doNotOverrideSgrCodes\n        ? parts\n        : parts.map((part): string => Colorize.yellow(AnsiEscape.removeCodes(part))),\n      TerminalProviderSeverity.warning,\n      true\n    );\n  }\n\n  /**\n   * {@inheritdoc ITerminal.writeError}\n   */\n  public writeError(...messageParts: TerminalWriteParameters): void {\n    const {\n      parts,\n      options: { doNotOverrideSgrCodes }\n    } = this._normalizeWriteParameters(messageParts);\n    this._writeSegmentsToProviders(\n      doNotOverrideSgrCodes ? parts : parts.map((part): string => Colorize.red(AnsiEscape.removeCodes(part))),\n      TerminalProviderSeverity.error,\n      false\n    );\n  }\n\n  /**\n   * {@inheritdoc ITerminal.writeErrorLine}\n   */\n  public writeErrorLine(...messageParts: TerminalWriteParameters): void {\n    const {\n      parts,\n      options: { doNotOverrideSgrCodes }\n    } = this._normalizeWriteParameters(messageParts);\n    this._writeSegmentsToProviders(\n      doNotOverrideSgrCodes ? parts : parts.map((part): string => Colorize.red(AnsiEscape.removeCodes(part))),\n      TerminalProviderSeverity.error,\n      true\n    );\n  }\n\n  /**\n   * {@inheritdoc ITerminal.writeVerbose}\n   */\n  public writeVerbose(...messageParts: TerminalWriteParameters): void {\n    const { parts } = this._normalizeWriteParameters(messageParts);\n    this._writeSegmentsToProviders(parts, TerminalProviderSeverity.verbose, false);\n  }\n\n  /**\n   * {@inheritdoc ITerminal.writeVerboseLine}\n   */\n  public writeVerboseLine(...messageParts: TerminalWriteParameters): void {\n    const { parts } = this._normalizeWriteParameters(messageParts);\n    this._writeSegmentsToProviders(parts, TerminalProviderSeverity.verbose, true);\n  }\n\n  /**\n   * {@inheritdoc ITerminal.writeDebug}\n   */\n  public writeDebug(...messageParts: TerminalWriteParameters): void {\n    const { parts } = this._normalizeWriteParameters(messageParts);\n    this._writeSegmentsToProviders(parts, TerminalProviderSeverity.debug, false);\n  }\n\n  /**\n   * {@inheritdoc ITerminal.writeDebugLine}\n   */\n  public writeDebugLine(...messageParts: TerminalWriteParameters): void {\n    const { parts } = this._normalizeWriteParameters(messageParts);\n    this._writeSegmentsToProviders(parts, TerminalProviderSeverity.debug, true);\n  }\n\n  private _writeSegmentsToProviders(\n    segments: (string | ILegacyColorableSequence)[],\n    severity: TerminalProviderSeverity,\n    followedByEol: boolean\n  ): void {\n    const linesSegments: string[][] = [[]];\n    let currentLineSegments: string[] = linesSegments[0];\n    for (const segment of segments) {\n      if (typeof segment === 'string') {\n        currentLineSegments.push(segment);\n      } else {\n        if (segment.isEol) {\n          linesSegments.push([]);\n          currentLineSegments = linesSegments[linesSegments.length - 1];\n        } else {\n          currentLineSegments.push(this._serializeLegacyColorableSequence(segment));\n        }\n      }\n    }\n\n    const lines: string[] = [];\n    for (const lineSegments of linesSegments) {\n      lines.push(lineSegments.join(''));\n    }\n\n    if (followedByEol) {\n      lines.push('');\n    }\n\n    let linesWithoutColor: string[] | undefined;\n\n    const concatenatedLinesWithColorByNewlineChar: Map<string, string> = new Map();\n    const concatenatedLinesWithoutColorByNewlineChar: Map<string, string> = new Map();\n    for (const provider of this._providers) {\n      let textToWrite: string | undefined;\n      const eol: string = provider.eolCharacter;\n      if (provider.supportsColor) {\n        textToWrite = concatenatedLinesWithColorByNewlineChar.get(eol);\n        if (!textToWrite) {\n          textToWrite = lines.join(eol);\n          concatenatedLinesWithColorByNewlineChar.set(eol, textToWrite);\n        }\n      } else {\n        textToWrite = concatenatedLinesWithoutColorByNewlineChar.get(eol);\n        if (!textToWrite) {\n          if (!linesWithoutColor) {\n            linesWithoutColor = [];\n            for (const line of lines) {\n              linesWithoutColor.push(AnsiEscape.removeCodes(line));\n            }\n          }\n\n          textToWrite = linesWithoutColor.join(eol);\n          concatenatedLinesWithoutColorByNewlineChar.set(eol, textToWrite);\n        }\n      }\n\n      provider.write(textToWrite, severity);\n    }\n  }\n\n  private _serializeLegacyColorableSequence(segment: ILegacyColorableSequence): string {\n    const startColorCodes: number[] = [];\n    const endColorCodes: number[] = [];\n    switch (segment.foregroundColor) {\n      case ColorValue.Black: {\n        startColorCodes.push(SgrParameterAttribute.BlackForeground);\n        endColorCodes.push(SgrParameterAttribute.DefaultForeground);\n        break;\n      }\n\n      case ColorValue.Red: {\n        startColorCodes.push(SgrParameterAttribute.RedForeground);\n        endColorCodes.push(SgrParameterAttribute.DefaultForeground);\n        break;\n      }\n\n      case ColorValue.Green: {\n        startColorCodes.push(SgrParameterAttribute.GreenForeground);\n        endColorCodes.push(SgrParameterAttribute.DefaultForeground);\n        break;\n      }\n\n      case ColorValue.Yellow: {\n        startColorCodes.push(SgrParameterAttribute.YellowForeground);\n        endColorCodes.push(SgrParameterAttribute.DefaultForeground);\n        break;\n      }\n\n      case ColorValue.Blue: {\n        startColorCodes.push(SgrParameterAttribute.BlueForeground);\n        endColorCodes.push(SgrParameterAttribute.DefaultForeground);\n        break;\n      }\n\n      case ColorValue.Magenta: {\n        startColorCodes.push(SgrParameterAttribute.MagentaForeground);\n        endColorCodes.push(SgrParameterAttribute.DefaultForeground);\n        break;\n      }\n\n      case ColorValue.Cyan: {\n        startColorCodes.push(SgrParameterAttribute.CyanForeground);\n        endColorCodes.push(SgrParameterAttribute.DefaultForeground);\n        break;\n      }\n\n      case ColorValue.White: {\n        startColorCodes.push(SgrParameterAttribute.WhiteForeground);\n        endColorCodes.push(SgrParameterAttribute.DefaultForeground);\n        break;\n      }\n\n      case ColorValue.Gray: {\n        startColorCodes.push(SgrParameterAttribute.GrayForeground);\n        endColorCodes.push(SgrParameterAttribute.DefaultForeground);\n        break;\n      }\n    }\n\n    switch (segment.backgroundColor) {\n      case ColorValue.Black: {\n        startColorCodes.push(SgrParameterAttribute.BlackBackground);\n        endColorCodes.push(SgrParameterAttribute.DefaultBackground);\n        break;\n      }\n\n      case ColorValue.Red: {\n        startColorCodes.push(SgrParameterAttribute.RedBackground);\n        endColorCodes.push(SgrParameterAttribute.DefaultBackground);\n        break;\n      }\n\n      case ColorValue.Green: {\n        startColorCodes.push(SgrParameterAttribute.GreenBackground);\n        endColorCodes.push(SgrParameterAttribute.DefaultBackground);\n        break;\n      }\n\n      case ColorValue.Yellow: {\n        startColorCodes.push(SgrParameterAttribute.YellowBackground);\n        endColorCodes.push(SgrParameterAttribute.DefaultBackground);\n        break;\n      }\n\n      case ColorValue.Blue: {\n        startColorCodes.push(SgrParameterAttribute.BlueBackground);\n        endColorCodes.push(SgrParameterAttribute.DefaultBackground);\n        break;\n      }\n\n      case ColorValue.Magenta: {\n        startColorCodes.push(SgrParameterAttribute.MagentaBackground);\n        endColorCodes.push(SgrParameterAttribute.DefaultBackground);\n        break;\n      }\n\n      case ColorValue.Cyan: {\n        startColorCodes.push(SgrParameterAttribute.CyanBackground);\n        endColorCodes.push(SgrParameterAttribute.DefaultBackground);\n        break;\n      }\n\n      case ColorValue.White: {\n        startColorCodes.push(SgrParameterAttribute.WhiteBackground);\n        endColorCodes.push(SgrParameterAttribute.DefaultBackground);\n        break;\n      }\n\n      case ColorValue.Gray: {\n        startColorCodes.push(SgrParameterAttribute.GrayBackground);\n        endColorCodes.push(49);\n        break;\n      }\n    }\n\n    if (segment.textAttributes) {\n      for (const textAttribute of segment.textAttributes) {\n        switch (textAttribute) {\n          case TextAttribute.Bold: {\n            startColorCodes.push(SgrParameterAttribute.Bold);\n            endColorCodes.push(SgrParameterAttribute.NormalColorOrIntensity);\n            break;\n          }\n\n          case TextAttribute.Dim: {\n            startColorCodes.push(SgrParameterAttribute.Dim);\n            endColorCodes.push(SgrParameterAttribute.NormalColorOrIntensity);\n            break;\n          }\n\n          case TextAttribute.Underline: {\n            startColorCodes.push(SgrParameterAttribute.Underline);\n            endColorCodes.push(SgrParameterAttribute.UnderlineOff);\n            break;\n          }\n\n          case TextAttribute.Blink: {\n            startColorCodes.push(SgrParameterAttribute.Blink);\n            endColorCodes.push(SgrParameterAttribute.BlinkOff);\n            break;\n          }\n\n          case TextAttribute.InvertColor: {\n            startColorCodes.push(SgrParameterAttribute.InvertColor);\n            endColorCodes.push(SgrParameterAttribute.InvertColorOff);\n            break;\n          }\n\n          case TextAttribute.Hidden: {\n            startColorCodes.push(SgrParameterAttribute.Hidden);\n            endColorCodes.push(SgrParameterAttribute.HiddenOff);\n            break;\n          }\n        }\n      }\n    }\n\n    const resultSegments: string[] = [];\n    for (let j: number = 0; j < startColorCodes.length; j++) {\n      const code: number = startColorCodes[j];\n      resultSegments.push(AnsiEscape.getEscapeSequenceForAnsiCode(code));\n    }\n\n    resultSegments.push(segment.text);\n\n    for (let j: number = endColorCodes.length - 1; j >= 0; j--) {\n      const code: number = endColorCodes[j];\n      resultSegments.push(AnsiEscape.getEscapeSequenceForAnsiCode(code));\n    }\n\n    return resultSegments.join('');\n  }\n\n  private _normalizeWriteParameters(parameters: TerminalWriteParameters): {\n    parts: string[];\n    options: ITerminalWriteOptions;\n  } {\n    if (parameters.length === 0) {\n      return { parts: [], options: {} };\n    } else {\n      const lastParameter: string | ITerminalWriteOptions = parameters[parameters.length - 1];\n      if (typeof lastParameter === 'string') {\n        return { parts: parameters as string[], options: {} };\n      } else {\n        return { parts: parameters.slice(0, -1) as string[], options: lastParameter };\n      }\n    }\n  }\n}\n"]}

package/lib/TerminalStreamWritable.d.ts

@@ -0,0 +1,35 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import { Writable, type WritableOptions } from 'stream';
+import type { ITerminal } from './ITerminal';
+import { TerminalProviderSeverity } from './ITerminalProvider';
+/**
+ * Options for {@link TerminalStreamWritable}.
+ *
+ * @beta
+ */
+export interface ITerminalStreamWritableOptions {
+    /**
+     * The {@link ITerminal} that the Writable will write to.
+     */
+    terminal: ITerminal;
+    /**
+     * The severity of the messages that will be written to the {@link ITerminal}.
+     */
+    severity: TerminalProviderSeverity;
+    /**
+     * Options for the underlying Writable.
+     */
+    writableOptions?: WritableOptions;
+}
+/**
+ * A adapter to allow writing to a provided terminal using Writable streams.
+ *
+ * @beta
+ */
+export declare class TerminalStreamWritable extends Writable {
+    private _writeMethod;
+    constructor(options: ITerminalStreamWritableOptions);
+    _write(chunk: string | Buffer | Uint8Array, encoding: string, callback: (error?: Error | null) => void): void;
+}
+//# sourceMappingURL=TerminalStreamWritable.d.ts.map

package/lib/TerminalStreamWritable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TerminalStreamWritable.d.ts","sourceRoot":"","sources":["../src/TerminalStreamWritable.ts"],"names":[],"mappings":";;AAGA,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,QAAQ,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAE/D;;;;GAIG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IACpB;;OAEG;IACH,QAAQ,EAAE,wBAAwB,CAAC;IACnC;;OAEG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,QAAQ;IAClD,OAAO,CAAC,YAAY,CAAyB;gBAE1B,OAAO,EAAE,8BAA8B;IA0BnD,MAAM,CACX,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,EACnC,QAAQ,EAAE,MAAM,EAEhB,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,GACvC,IAAI;CAUR"}

package/lib/TerminalStreamWritable.js

@@ -0,0 +1,53 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TerminalStreamWritable = void 0;
+const stream_1 = require("stream");
+const ITerminalProvider_1 = require("./ITerminalProvider");
+/**
+ * A adapter to allow writing to a provided terminal using Writable streams.
+ *
+ * @beta
+ */
+class TerminalStreamWritable extends stream_1.Writable {
+    constructor(options) {
+        const { terminal, severity, writableOptions } = options;
+        super(writableOptions);
+        this._writev = undefined;
+        switch (severity) {
+            case ITerminalProvider_1.TerminalProviderSeverity.log:
+                this._writeMethod = terminal.write.bind(terminal);
+                break;
+            case ITerminalProvider_1.TerminalProviderSeverity.verbose:
+                this._writeMethod = terminal.writeVerbose.bind(terminal);
+                break;
+            case ITerminalProvider_1.TerminalProviderSeverity.debug:
+                this._writeMethod = terminal.writeDebug.bind(terminal);
+                break;
+            case ITerminalProvider_1.TerminalProviderSeverity.warning:
+                this._writeMethod = terminal.writeWarning.bind(terminal);
+                break;
+            case ITerminalProvider_1.TerminalProviderSeverity.error:
+                this._writeMethod = terminal.writeError.bind(terminal);
+                break;
+            default:
+                throw new Error(`Unknown severity: ${severity}`);
+        }
+    }
+    _write(chunk, encoding, 
+    // eslint-disable-next-line @rushstack/no-new-null
+    callback) {
+        try {
+            const chunkData = typeof chunk === 'string' ? chunk : Buffer.from(chunk);
+            this._writeMethod(chunkData.toString());
+        }
+        catch (e) {
+            callback(e);
+            return;
+        }
+        callback();
+    }
+}
+exports.TerminalStreamWritable = TerminalStreamWritable;
+//# sourceMappingURL=TerminalStreamWritable.js.map

package/lib/TerminalStreamWritable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TerminalStreamWritable.js","sourceRoot":"","sources":["../src/TerminalStreamWritable.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAE3D,mCAAwD;AAExD,2DAA+D;AAsB/D;;;;GAIG;AACH,MAAa,sBAAuB,SAAQ,iBAAQ;IAGlD,YAAmB,OAAuC;QACxD,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC;QACxD,KAAK,CAAC,eAAe,CAAC,CAAC;QAEvB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QACzB,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,4CAAwB,CAAC,GAAG;gBAC/B,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAClD,MAAM;YACR,KAAK,4CAAwB,CAAC,OAAO;gBACnC,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACzD,MAAM;YACR,KAAK,4CAAwB,CAAC,KAAK;gBACjC,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACvD,MAAM;YACR,KAAK,4CAAwB,CAAC,OAAO;gBACnC,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACzD,MAAM;YACR,KAAK,4CAAwB,CAAC,KAAK;gBACjC,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACvD,MAAM;YACR;gBACE,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAEM,MAAM,CACX,KAAmC,EACnC,QAAgB;IAChB,kDAAkD;IAClD,QAAwC;QAExC,IAAI,CAAC;YACH,MAAM,SAAS,GAAoB,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1F,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,QAAQ,CAAC,CAAU,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,QAAQ,EAAE,CAAC;IACb,CAAC;CACF;AA5CD,wDA4CC","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 { Writable, type WritableOptions } from 'stream';\nimport type { ITerminal } from './ITerminal';\nimport { TerminalProviderSeverity } from './ITerminalProvider';\n\n/**\n * Options for {@link TerminalStreamWritable}.\n *\n * @beta\n */\nexport interface ITerminalStreamWritableOptions {\n  /**\n   * The {@link ITerminal} that the Writable will write to.\n   */\n  terminal: ITerminal;\n  /**\n   * The severity of the messages that will be written to the {@link ITerminal}.\n   */\n  severity: TerminalProviderSeverity;\n  /**\n   * Options for the underlying Writable.\n   */\n  writableOptions?: WritableOptions;\n}\n\n/**\n * A adapter to allow writing to a provided terminal using Writable streams.\n *\n * @beta\n */\nexport class TerminalStreamWritable extends Writable {\n  private _writeMethod: (data: string) => void;\n\n  public constructor(options: ITerminalStreamWritableOptions) {\n    const { terminal, severity, writableOptions } = options;\n    super(writableOptions);\n\n    this._writev = undefined;\n    switch (severity) {\n      case TerminalProviderSeverity.log:\n        this._writeMethod = terminal.write.bind(terminal);\n        break;\n      case TerminalProviderSeverity.verbose:\n        this._writeMethod = terminal.writeVerbose.bind(terminal);\n        break;\n      case TerminalProviderSeverity.debug:\n        this._writeMethod = terminal.writeDebug.bind(terminal);\n        break;\n      case TerminalProviderSeverity.warning:\n        this._writeMethod = terminal.writeWarning.bind(terminal);\n        break;\n      case TerminalProviderSeverity.error:\n        this._writeMethod = terminal.writeError.bind(terminal);\n        break;\n      default:\n        throw new Error(`Unknown severity: ${severity}`);\n    }\n  }\n\n  public _write(\n    chunk: string | Buffer | Uint8Array,\n    encoding: string,\n    // eslint-disable-next-line @rushstack/no-new-null\n    callback: (error?: Error | null) => void\n  ): void {\n    try {\n      const chunkData: string | Buffer = typeof chunk === 'string' ? chunk : Buffer.from(chunk);\n      this._writeMethod(chunkData.toString());\n    } catch (e: unknown) {\n      callback(e as Error);\n      return;\n    }\n    callback();\n  }\n}\n"]}

package/lib/TerminalWritable.d.ts

@@ -21,7 +21,7 @@ export interface ITerminalWritableOptions {
 /**
  * The abstract base class for objects that can present, route, or process text output for
  * a console application.  This output is typically prepared using
- * the {@link @rushstack/node-core-library#Terminal} API.
+ * the {@link Terminal} API.
  *
  * @remarks
  *

package/lib/TerminalWritable.js

@@ -6,7 +6,7 @@ exports.TerminalWritable = void 0;
 /**
  * The abstract base class for objects that can present, route, or process text output for
  * a console application.  This output is typically prepared using
- * the {@link @rushstack/node-core-library#Terminal} API.
+ * the {@link Terminal} API.
  *
  * @remarks
  *

package/lib/TerminalWritable.js.map

@@ -1 +1 @@
-{"version":3,"file":"TerminalWritable.js","sourceRoot":"","sources":["../src/TerminalWritable.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAwB3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,MAAsB,gBAAgB;IAKpC,YAAmB,OAAkC;QACnD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QAEpB,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,EAAE,CAAC;QACf,CAAC;QAED,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;IACrD,CAAC;IAED;;;;OAIG;IACH,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;;;;;;;;;;OAYG;IACI,UAAU,CAAC,KAAqB;QACrC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAOD;;;;;;;;;;;;OAYG;IACI,KAAK;QACV,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACvB,CAAC;IACH,CAAC;IAED;;;;;;;;;OASG;IACO,OAAO,KAAU,CAAC;CAC7B;AAhFD,4CAgFC","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 } from './ITerminalChunk';\n\n/**\n * Constructor options for {@link TerminalWritable}\n *\n * @public\n */\nexport interface ITerminalWritableOptions {\n  /**\n   * When this object is the {@link TerminalTransform.destination} for a transform,\n   * the transform will automatically close this object.  Set `preventAutoclose` to `true`\n   * to prevent that behavior.\n   *\n   * @remarks\n   * When a transform is closed, normally it will automatically close its destination\n   * `TerminalWritable` object.  There are two ways to prevent that: either by setting\n   * `preventDestinationAutoclose` to `true` for the transform, or by setting\n   * {@link TerminalWritable.preventAutoclose} to `true` for the `destination` object.\n   */\n  preventAutoclose?: boolean;\n}\n\n/**\n * The abstract base class for objects that can present, route, or process text output for\n * a console application.  This output is typically prepared using\n * the {@link @rushstack/node-core-library#Terminal} API.\n *\n * @remarks\n *\n * The design is based loosely on the `WritableStream` and `TransformStream` classes from\n * the system {@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API/Concepts\n * | Streams API}, except that instead of asynchronous byte streams, the `TerminalWritable`\n * system synchronously transmits human readable messages intended to be rendered on a text\n * console or log file.\n *\n * Consider a console application whose output may need to be processed in different ways\n * before finally being output.  The conceptual block diagram might look like this:\n *\n * ```\n *          [Terminal API]\n *                 |\n *                 V\n *        [normalize newlines]\n *                 |\n *                 V\n *       +----[splitter]-------+\n *       |                     |\n *       V                     V\n *   [shell console]     [remove ANSI colors]\n *                             |\n *                             V\n *                       [write to build.log]\n * ```\n *\n * The application uses the `Terminal` API to print `stdout` and `stderr` messages, for example with standardized\n * formatting for errors and warnings, and ANSI escapes to make nice colors.  Maybe it also includes text\n * received from external processes, whose newlines may be inconsistent.  Ultimately we want to write the\n * output to the shell console and a `build.log` file, but we don't want to put ANSI colors in the build log.\n *\n * For the above example, `[shell console]` and `[write to build.log]` would be modeled as subclasses of\n * `TerminalWritable`.  The `[normalize newlines]` and `[remove ANSI colors]` steps are modeled as subclasses\n * of {@link TerminalTransform}, because they output to a \"destination\" object.  The `[splitter]` would be\n * implemented using {@link SplitterTransform}.\n *\n * The stream of messages are {@link ITerminalChunk} objects, which can represent both `stdout` and `stderr`\n * channels.  The pipeline operates synchronously on each chunk, but by processing one chunk at a time,\n * it avoids storing the entire output in memory.  This means that operations like `[remove ANSI colors]`\n * cannot be simple regular expressions -- they must be implemented as state machines ({@link TextRewriter}\n * subclasses) capable of matching substrings that span multiple chunks.\n *\n * @public\n */\nexport abstract class TerminalWritable {\n  private _isOpen: boolean;\n\n  public readonly preventAutoclose: boolean;\n\n  public constructor(options?: ITerminalWritableOptions) {\n    this._isOpen = true;\n\n    if (!options) {\n      options = {};\n    }\n\n    this.preventAutoclose = !!options.preventAutoclose;\n  }\n\n  /**\n   * This property is initially `true` when the object is constructed, and becomes `false`\n   * when `close()` is called.\n   * @sealed\n   */\n  public get isOpen(): boolean {\n    return this._isOpen;\n  }\n\n  /**\n   * Upstream objects call this method to provide inputs to this object.\n   *\n   * @remarks\n   * The subclass provides its implementation via the the {@link TerminalWritable.onWriteChunk}\n   * method, which is called by `writeChunk()`.\n   *\n   * The object that calls `writeChunk()` must call `close()` when it is finished;\n   * failing to do so may introduce a resource leak, or may prevent some buffered data from\n   * being written.\n   *\n   * @sealed\n   */\n  public writeChunk(chunk: ITerminalChunk): void {\n    if (!this._isOpen) {\n      throw new Error('Writer was already closed');\n    }\n    this.onWriteChunk(chunk);\n  }\n\n  /**\n   * Subclasses should implement this `abstract` method to process the chunk.\n   */\n  protected abstract onWriteChunk(chunk: ITerminalChunk): void;\n\n  /**\n   * Calling this method flushes any remaining outputs and permanently transitions the\n   * `TerminalWritable` to a \"closed\" state, where no further chunks can be written.\n   *\n   * @remarks\n   * The subclass provides its implementation via the the {@link TerminalWritable.onClose}\n   * method, which is called by `close()`.\n   *\n   * If this method is called more than once, the additional calls are ignored;\n   * `TerminalWritable.onClose` will be called at most once.\n   *\n   * @sealed\n   */\n  public close(): void {\n    if (this._isOpen) {\n      this.onClose();\n      this._isOpen = false;\n    }\n  }\n\n  /**\n   * Subclasses can override this empty method to perform additional operations\n   * such as closing a file handle.\n   *\n   * @remarks\n   * It is guaranteed that this method will be called at most once during the lifetime\n   * of a `TerminalWritable` object.\n   *\n   * @virtual\n   */\n  protected onClose(): void {}\n}\n"]}
+{"version":3,"file":"TerminalWritable.js","sourceRoot":"","sources":["../src/TerminalWritable.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAwB3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,MAAsB,gBAAgB;IAKpC,YAAmB,OAAkC;QACnD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QAEpB,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,EAAE,CAAC;QACf,CAAC;QAED,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;IACrD,CAAC;IAED;;;;OAIG;IACH,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;;;;;;;;;;OAYG;IACI,UAAU,CAAC,KAAqB;QACrC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAOD;;;;;;;;;;;;OAYG;IACI,KAAK;QACV,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACvB,CAAC;IACH,CAAC;IAED;;;;;;;;;OASG;IACO,OAAO,KAAU,CAAC;CAC7B;AAhFD,4CAgFC","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 } from './ITerminalChunk';\n\n/**\n * Constructor options for {@link TerminalWritable}\n *\n * @public\n */\nexport interface ITerminalWritableOptions {\n  /**\n   * When this object is the {@link TerminalTransform.destination} for a transform,\n   * the transform will automatically close this object.  Set `preventAutoclose` to `true`\n   * to prevent that behavior.\n   *\n   * @remarks\n   * When a transform is closed, normally it will automatically close its destination\n   * `TerminalWritable` object.  There are two ways to prevent that: either by setting\n   * `preventDestinationAutoclose` to `true` for the transform, or by setting\n   * {@link TerminalWritable.preventAutoclose} to `true` for the `destination` object.\n   */\n  preventAutoclose?: boolean;\n}\n\n/**\n * The abstract base class for objects that can present, route, or process text output for\n * a console application.  This output is typically prepared using\n * the {@link Terminal} API.\n *\n * @remarks\n *\n * The design is based loosely on the `WritableStream` and `TransformStream` classes from\n * the system {@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API/Concepts\n * | Streams API}, except that instead of asynchronous byte streams, the `TerminalWritable`\n * system synchronously transmits human readable messages intended to be rendered on a text\n * console or log file.\n *\n * Consider a console application whose output may need to be processed in different ways\n * before finally being output.  The conceptual block diagram might look like this:\n *\n * ```\n *          [Terminal API]\n *                 |\n *                 V\n *        [normalize newlines]\n *                 |\n *                 V\n *       +----[splitter]-------+\n *       |                     |\n *       V                     V\n *   [shell console]     [remove ANSI colors]\n *                             |\n *                             V\n *                       [write to build.log]\n * ```\n *\n * The application uses the `Terminal` API to print `stdout` and `stderr` messages, for example with standardized\n * formatting for errors and warnings, and ANSI escapes to make nice colors.  Maybe it also includes text\n * received from external processes, whose newlines may be inconsistent.  Ultimately we want to write the\n * output to the shell console and a `build.log` file, but we don't want to put ANSI colors in the build log.\n *\n * For the above example, `[shell console]` and `[write to build.log]` would be modeled as subclasses of\n * `TerminalWritable`.  The `[normalize newlines]` and `[remove ANSI colors]` steps are modeled as subclasses\n * of {@link TerminalTransform}, because they output to a \"destination\" object.  The `[splitter]` would be\n * implemented using {@link SplitterTransform}.\n *\n * The stream of messages are {@link ITerminalChunk} objects, which can represent both `stdout` and `stderr`\n * channels.  The pipeline operates synchronously on each chunk, but by processing one chunk at a time,\n * it avoids storing the entire output in memory.  This means that operations like `[remove ANSI colors]`\n * cannot be simple regular expressions -- they must be implemented as state machines ({@link TextRewriter}\n * subclasses) capable of matching substrings that span multiple chunks.\n *\n * @public\n */\nexport abstract class TerminalWritable {\n  private _isOpen: boolean;\n\n  public readonly preventAutoclose: boolean;\n\n  public constructor(options?: ITerminalWritableOptions) {\n    this._isOpen = true;\n\n    if (!options) {\n      options = {};\n    }\n\n    this.preventAutoclose = !!options.preventAutoclose;\n  }\n\n  /**\n   * This property is initially `true` when the object is constructed, and becomes `false`\n   * when `close()` is called.\n   * @sealed\n   */\n  public get isOpen(): boolean {\n    return this._isOpen;\n  }\n\n  /**\n   * Upstream objects call this method to provide inputs to this object.\n   *\n   * @remarks\n   * The subclass provides its implementation via the the {@link TerminalWritable.onWriteChunk}\n   * method, which is called by `writeChunk()`.\n   *\n   * The object that calls `writeChunk()` must call `close()` when it is finished;\n   * failing to do so may introduce a resource leak, or may prevent some buffered data from\n   * being written.\n   *\n   * @sealed\n   */\n  public writeChunk(chunk: ITerminalChunk): void {\n    if (!this._isOpen) {\n      throw new Error('Writer was already closed');\n    }\n    this.onWriteChunk(chunk);\n  }\n\n  /**\n   * Subclasses should implement this `abstract` method to process the chunk.\n   */\n  protected abstract onWriteChunk(chunk: ITerminalChunk): void;\n\n  /**\n   * Calling this method flushes any remaining outputs and permanently transitions the\n   * `TerminalWritable` to a \"closed\" state, where no further chunks can be written.\n   *\n   * @remarks\n   * The subclass provides its implementation via the the {@link TerminalWritable.onClose}\n   * method, which is called by `close()`.\n   *\n   * If this method is called more than once, the additional calls are ignored;\n   * `TerminalWritable.onClose` will be called at most once.\n   *\n   * @sealed\n   */\n  public close(): void {\n    if (this._isOpen) {\n      this.onClose();\n      this._isOpen = false;\n    }\n  }\n\n  /**\n   * Subclasses can override this empty method to perform additional operations\n   * such as closing a file handle.\n   *\n   * @remarks\n   * It is guaranteed that this method will be called at most once during the lifetime\n   * of a `TerminalWritable` object.\n   *\n   * @virtual\n   */\n  protected onClose(): void {}\n}\n"]}