@rushstack/terminal 0.7.24 → 0.8.1

package/lib/AnsiEscape.js

@@ -0,0 +1,136 @@
+"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.AnsiEscape = void 0;
+const Colorize_1 = require("./Colorize");
+/**
+ * Operations for working with text strings that contain
+ * {@link https://en.wikipedia.org/wiki/ANSI_escape_code | ANSI escape codes}.
+ * The most commonly used escape codes set the foreground/background color for console output.
+ * @public
+ */
+class AnsiEscape {
+    static getEscapeSequenceForAnsiCode(code) {
+        return `\u001b[${code}m`;
+    }
+    /**
+     * Returns the input text with all ANSI escape codes removed.  For example, this is useful when saving
+     * colorized console output to a log file.
+     */
+    static removeCodes(text) {
+        // eslint-disable-next-line no-control-regex
+        return text.replace(AnsiEscape._csiRegExp, '');
+    }
+    /**
+     * Replaces ANSI escape codes with human-readable tokens.  This is useful for unit tests
+     * that compare text strings in test assertions or snapshot files.
+     */
+    static formatForTests(text, options) {
+        if (!options) {
+            options = {};
+        }
+        let result = text.replace(AnsiEscape._csiRegExp, (capture, csiCode) => {
+            // If it is an SGR code, then try to show a friendly token
+            const match = csiCode.match(AnsiEscape._sgrRegExp);
+            if (match) {
+                const sgrParameter = parseInt(match[1], 10);
+                const sgrParameterName = AnsiEscape._tryGetSgrFriendlyName(sgrParameter);
+                if (sgrParameterName) {
+                    // Example: "[black-bg]"
+                    return `[${sgrParameterName}]`;
+                }
+            }
+            // Otherwise show the raw code, but without the "[" from the CSI prefix
+            // Example: "[31m]"
+            return `[${csiCode}]`;
+        });
+        if (options.encodeNewlines) {
+            result = result
+                .replace(AnsiEscape._backslashNRegExp, '[n]')
+                .replace(AnsiEscape._backslashRRegExp, `[r]`);
+        }
+        return result;
+    }
+    // Returns a human-readable token representing an SGR parameter, or undefined for parameter that is not well-known.
+    // The SGR parameter numbers are documented in this table:
+    // https://en.wikipedia.org/wiki/ANSI_escape_code#SGR_parameters
+    static _tryGetSgrFriendlyName(sgiParameter) {
+        switch (sgiParameter) {
+            case Colorize_1.SgrParameterAttribute.BlackForeground:
+                return 'black';
+            case Colorize_1.SgrParameterAttribute.RedForeground:
+                return 'red';
+            case Colorize_1.SgrParameterAttribute.GreenForeground:
+                return 'green';
+            case Colorize_1.SgrParameterAttribute.YellowForeground:
+                return 'yellow';
+            case Colorize_1.SgrParameterAttribute.BlueForeground:
+                return 'blue';
+            case Colorize_1.SgrParameterAttribute.MagentaForeground:
+                return 'magenta';
+            case Colorize_1.SgrParameterAttribute.CyanForeground:
+                return 'cyan';
+            case Colorize_1.SgrParameterAttribute.WhiteForeground:
+                return 'white';
+            case Colorize_1.SgrParameterAttribute.GrayForeground:
+                return 'gray';
+            case Colorize_1.SgrParameterAttribute.DefaultForeground:
+                return 'default';
+            case Colorize_1.SgrParameterAttribute.BlackBackground:
+                return 'black-bg';
+            case Colorize_1.SgrParameterAttribute.RedBackground:
+                return 'red-bg';
+            case Colorize_1.SgrParameterAttribute.GreenBackground:
+                return 'green-bg';
+            case Colorize_1.SgrParameterAttribute.YellowBackground:
+                return 'yellow-bg';
+            case Colorize_1.SgrParameterAttribute.BlueBackground:
+                return 'blue-bg';
+            case Colorize_1.SgrParameterAttribute.MagentaBackground:
+                return 'magenta-bg';
+            case Colorize_1.SgrParameterAttribute.CyanBackground:
+                return 'cyan-bg';
+            case Colorize_1.SgrParameterAttribute.WhiteBackground:
+                return 'white-bg';
+            case Colorize_1.SgrParameterAttribute.GrayBackground:
+                return 'gray-bg';
+            case Colorize_1.SgrParameterAttribute.DefaultBackground:
+                return 'default-bg';
+            case Colorize_1.SgrParameterAttribute.Bold:
+                return 'bold';
+            case Colorize_1.SgrParameterAttribute.Dim:
+                return 'dim';
+            case Colorize_1.SgrParameterAttribute.NormalColorOrIntensity:
+                return 'normal';
+            case Colorize_1.SgrParameterAttribute.Underline:
+                return 'underline';
+            case Colorize_1.SgrParameterAttribute.UnderlineOff:
+                return 'underline-off';
+            case Colorize_1.SgrParameterAttribute.Blink:
+                return 'blink';
+            case Colorize_1.SgrParameterAttribute.BlinkOff:
+                return 'blink-off';
+            case Colorize_1.SgrParameterAttribute.InvertColor:
+                return 'invert';
+            case Colorize_1.SgrParameterAttribute.InvertColorOff:
+                return 'invert-off';
+            case Colorize_1.SgrParameterAttribute.Hidden:
+                return 'hidden';
+            case Colorize_1.SgrParameterAttribute.HiddenOff:
+                return 'hidden-off';
+            default:
+                return undefined;
+        }
+    }
+}
+exports.AnsiEscape = AnsiEscape;
+// For now, we only care about the Control Sequence Introducer (CSI) commands which always start with "[".
+// eslint-disable-next-line no-control-regex
+AnsiEscape._csiRegExp = /\x1b\[([\x30-\x3f]*[\x20-\x2f]*[\x40-\x7e])/gu;
+// Text coloring is performed using Select Graphic Rendition (SGR) codes, which come after the
+// CSI introducer "ESC [".  The SGR sequence is a number followed by "m".
+AnsiEscape._sgrRegExp = /([0-9]+)m/u;
+AnsiEscape._backslashNRegExp = /\n/g;
+AnsiEscape._backslashRRegExp = /\r/g;
+//# sourceMappingURL=AnsiEscape.js.map

package/lib/AnsiEscape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnsiEscape.js","sourceRoot":"","sources":["../src/AnsiEscape.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 { SgrParameterAttribute } from './Colorize';\n\n/**\n * Options for {@link AnsiEscape.formatForTests}.\n * @public\n */\nexport interface IAnsiEscapeConvertForTestsOptions {\n  /**\n   * If true then `\\n` will be replaced by `[n]`, and `\\r` will be replaced by `[r]`.\n   */\n  encodeNewlines?: boolean;\n}\n\n/**\n * Operations for working with text strings that contain\n * {@link https://en.wikipedia.org/wiki/ANSI_escape_code | ANSI escape codes}.\n * The most commonly used escape codes set the foreground/background color for console output.\n * @public\n */\nexport class AnsiEscape {\n  // For now, we only care about the Control Sequence Introducer (CSI) commands which always start with \"[\".\n  // eslint-disable-next-line no-control-regex\n  private static readonly _csiRegExp: RegExp = /\\x1b\\[([\\x30-\\x3f]*[\\x20-\\x2f]*[\\x40-\\x7e])/gu;\n\n  // Text coloring is performed using Select Graphic Rendition (SGR) codes, which come after the\n  // CSI introducer \"ESC [\".  The SGR sequence is a number followed by \"m\".\n  private static readonly _sgrRegExp: RegExp = /([0-9]+)m/u;\n\n  private static readonly _backslashNRegExp: RegExp = /\\n/g;\n  private static readonly _backslashRRegExp: RegExp = /\\r/g;\n\n  public static getEscapeSequenceForAnsiCode(code: number): string {\n    return `\\u001b[${code}m`;\n  }\n\n  /**\n   * Returns the input text with all ANSI escape codes removed.  For example, this is useful when saving\n   * colorized console output to a log file.\n   */\n  public static removeCodes(text: string): string {\n    // eslint-disable-next-line no-control-regex\n    return text.replace(AnsiEscape._csiRegExp, '');\n  }\n\n  /**\n   * Replaces ANSI escape codes with human-readable tokens.  This is useful for unit tests\n   * that compare text strings in test assertions or snapshot files.\n   */\n  public static formatForTests(text: string, options?: IAnsiEscapeConvertForTestsOptions): string {\n    if (!options) {\n      options = {};\n    }\n\n    let result: string = text.replace(AnsiEscape._csiRegExp, (capture: string, csiCode: string) => {\n      // If it is an SGR code, then try to show a friendly token\n      const match: RegExpMatchArray | null = csiCode.match(AnsiEscape._sgrRegExp);\n      if (match) {\n        const sgrParameter: number = parseInt(match[1], 10);\n        const sgrParameterName: string | undefined = AnsiEscape._tryGetSgrFriendlyName(sgrParameter);\n        if (sgrParameterName) {\n          // Example: \"[black-bg]\"\n          return `[${sgrParameterName}]`;\n        }\n      }\n\n      // Otherwise show the raw code, but without the \"[\" from the CSI prefix\n      // Example: \"[31m]\"\n      return `[${csiCode}]`;\n    });\n\n    if (options.encodeNewlines) {\n      result = result\n        .replace(AnsiEscape._backslashNRegExp, '[n]')\n        .replace(AnsiEscape._backslashRRegExp, `[r]`);\n    }\n    return result;\n  }\n\n  // Returns a human-readable token representing an SGR parameter, or undefined for parameter that is not well-known.\n  // The SGR parameter numbers are documented in this table:\n  // https://en.wikipedia.org/wiki/ANSI_escape_code#SGR_parameters\n  private static _tryGetSgrFriendlyName(sgiParameter: number): string | undefined {\n    switch (sgiParameter) {\n      case SgrParameterAttribute.BlackForeground:\n        return 'black';\n      case SgrParameterAttribute.RedForeground:\n        return 'red';\n      case SgrParameterAttribute.GreenForeground:\n        return 'green';\n      case SgrParameterAttribute.YellowForeground:\n        return 'yellow';\n      case SgrParameterAttribute.BlueForeground:\n        return 'blue';\n      case SgrParameterAttribute.MagentaForeground:\n        return 'magenta';\n      case SgrParameterAttribute.CyanForeground:\n        return 'cyan';\n      case SgrParameterAttribute.WhiteForeground:\n        return 'white';\n      case SgrParameterAttribute.GrayForeground:\n        return 'gray';\n      case SgrParameterAttribute.DefaultForeground:\n        return 'default';\n\n      case SgrParameterAttribute.BlackBackground:\n        return 'black-bg';\n      case SgrParameterAttribute.RedBackground:\n        return 'red-bg';\n      case SgrParameterAttribute.GreenBackground:\n        return 'green-bg';\n      case SgrParameterAttribute.YellowBackground:\n        return 'yellow-bg';\n      case SgrParameterAttribute.BlueBackground:\n        return 'blue-bg';\n      case SgrParameterAttribute.MagentaBackground:\n        return 'magenta-bg';\n      case SgrParameterAttribute.CyanBackground:\n        return 'cyan-bg';\n      case SgrParameterAttribute.WhiteBackground:\n        return 'white-bg';\n      case SgrParameterAttribute.GrayBackground:\n        return 'gray-bg';\n      case SgrParameterAttribute.DefaultBackground:\n        return 'default-bg';\n\n      case SgrParameterAttribute.Bold:\n        return 'bold';\n      case SgrParameterAttribute.Dim:\n        return 'dim';\n      case SgrParameterAttribute.NormalColorOrIntensity:\n        return 'normal';\n      case SgrParameterAttribute.Underline:\n        return 'underline';\n      case SgrParameterAttribute.UnderlineOff:\n        return 'underline-off';\n      case SgrParameterAttribute.Blink:\n        return 'blink';\n      case SgrParameterAttribute.BlinkOff:\n        return 'blink-off';\n      case SgrParameterAttribute.InvertColor:\n        return 'invert';\n      case SgrParameterAttribute.InvertColorOff:\n        return 'invert-off';\n      case SgrParameterAttribute.Hidden:\n        return 'hidden';\n      case SgrParameterAttribute.HiddenOff:\n        return 'hidden-off';\n      default:\n        return undefined;\n    }\n  }\n}\n"]}

package/lib/Colorize.d.ts

@@ -0,0 +1,79 @@
+export declare enum SgrParameterAttribute {
+    BlackForeground = 30,
+    RedForeground = 31,
+    GreenForeground = 32,
+    YellowForeground = 33,
+    BlueForeground = 34,
+    MagentaForeground = 35,
+    CyanForeground = 36,
+    WhiteForeground = 37,
+    GrayForeground = 90,
+    DefaultForeground = 39,
+    BlackBackground = 40,
+    RedBackground = 41,
+    GreenBackground = 42,
+    YellowBackground = 43,
+    BlueBackground = 44,
+    MagentaBackground = 45,
+    CyanBackground = 46,
+    WhiteBackground = 47,
+    GrayBackground = 100,
+    DefaultBackground = 49,
+    Bold = 1,
+    Dim = 2,
+    NormalColorOrIntensity = 22,
+    Underline = 4,
+    UnderlineOff = 24,
+    Blink = 5,
+    BlinkOff = 25,
+    InvertColor = 7,
+    InvertColorOff = 27,
+    Hidden = 8,
+    HiddenOff = 28
+}
+/**
+ * The static functions on this class are used to produce colored text
+ * for use with a terminal that supports ANSI escape codes.
+ *
+ * Note that this API always generates color codes, regardless of whether
+ * the process's stdout is a TTY. The reason is that, in a complex program, the
+ * code that is generating strings often does not know were those strings will end
+ * up. In some cases, the same log message may get printed both to a shell
+ * that supports color AND to a log file that does not.
+ *
+ * @example
+ * ```ts
+ * console.log(Colorize.red('Red Text!'))
+ * terminal.writeLine(Colorize.green('Green Text!'), ' ', Colorize.blue('Blue Text!'));
+ *```
+ *
+ * @public
+ */
+export declare class Colorize {
+    static black(text: string): string;
+    static red(text: string): string;
+    static green(text: string): string;
+    static yellow(text: string): string;
+    static blue(text: string): string;
+    static magenta(text: string): string;
+    static cyan(text: string): string;
+    static white(text: string): string;
+    static gray(text: string): string;
+    static blackBackground(text: string): string;
+    static redBackground(text: string): string;
+    static greenBackground(text: string): string;
+    static yellowBackground(text: string): string;
+    static blueBackground(text: string): string;
+    static magentaBackground(text: string): string;
+    static cyanBackground(text: string): string;
+    static whiteBackground(text: string): string;
+    static grayBackground(text: string): string;
+    static bold(text: string): string;
+    static dim(text: string): string;
+    static underline(text: string): string;
+    static blink(text: string): string;
+    static invertColor(text: string): string;
+    static hidden(text: string): string;
+    private static _wrapTextInAnsiEscapeCodes;
+}
+//# sourceMappingURL=Colorize.d.ts.map

package/lib/Colorize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Colorize.d.ts","sourceRoot":"","sources":["../src/Colorize.ts"],"names":[],"mappings":"AAKA,oBAAY,qBAAqB;IAC/B,eAAe,KAAK;IACpB,aAAa,KAAK;IAClB,eAAe,KAAK;IACpB,gBAAgB,KAAK;IACrB,cAAc,KAAK;IACnB,iBAAiB,KAAK;IACtB,cAAc,KAAK;IACnB,eAAe,KAAK;IACpB,cAAc,KAAK;IACnB,iBAAiB,KAAK;IAEtB,eAAe,KAAK;IACpB,aAAa,KAAK;IAClB,eAAe,KAAK;IACpB,gBAAgB,KAAK;IACrB,cAAc,KAAK;IACnB,iBAAiB,KAAK;IACtB,cAAc,KAAK;IACnB,eAAe,KAAK;IACpB,cAAc,MAAM;IACpB,iBAAiB,KAAK;IAEtB,IAAI,IAAI;IAOR,GAAG,IAAI;IACP,sBAAsB,KAAK;IAC3B,SAAS,IAAI;IACb,YAAY,KAAK;IACjB,KAAK,IAAI;IACT,QAAQ,KAAK;IACb,WAAW,IAAI;IACf,cAAc,KAAK;IACnB,MAAM,IAAI;IACV,SAAS,KAAK;CACf;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,QAAQ;WACL,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;WAQ3B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;WAQzB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;WAQ3B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;WAQ5B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;WAQ1B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;WAQ7B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;WAQ1B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;WAQ3B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;WAQ1B,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;WAQrC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;WAQnC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;WAQrC,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;WAQtC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;WAQpC,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;WAQvC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;WAQpC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;WAQrC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;WAQpC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;WAQ1B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;WAQzB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;WAQ/B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;WAQ3B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;WAQjC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAQ1C,OAAO,CAAC,MAAM,CAAC,0BAA0B;CAO1C"}

package/lib/Colorize.js

@@ -0,0 +1,143 @@
+"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.Colorize = exports.SgrParameterAttribute = void 0;
+const AnsiEscape_1 = require("./AnsiEscape");
+var SgrParameterAttribute;
+(function (SgrParameterAttribute) {
+    SgrParameterAttribute[SgrParameterAttribute["BlackForeground"] = 30] = "BlackForeground";
+    SgrParameterAttribute[SgrParameterAttribute["RedForeground"] = 31] = "RedForeground";
+    SgrParameterAttribute[SgrParameterAttribute["GreenForeground"] = 32] = "GreenForeground";
+    SgrParameterAttribute[SgrParameterAttribute["YellowForeground"] = 33] = "YellowForeground";
+    SgrParameterAttribute[SgrParameterAttribute["BlueForeground"] = 34] = "BlueForeground";
+    SgrParameterAttribute[SgrParameterAttribute["MagentaForeground"] = 35] = "MagentaForeground";
+    SgrParameterAttribute[SgrParameterAttribute["CyanForeground"] = 36] = "CyanForeground";
+    SgrParameterAttribute[SgrParameterAttribute["WhiteForeground"] = 37] = "WhiteForeground";
+    SgrParameterAttribute[SgrParameterAttribute["GrayForeground"] = 90] = "GrayForeground";
+    SgrParameterAttribute[SgrParameterAttribute["DefaultForeground"] = 39] = "DefaultForeground";
+    SgrParameterAttribute[SgrParameterAttribute["BlackBackground"] = 40] = "BlackBackground";
+    SgrParameterAttribute[SgrParameterAttribute["RedBackground"] = 41] = "RedBackground";
+    SgrParameterAttribute[SgrParameterAttribute["GreenBackground"] = 42] = "GreenBackground";
+    SgrParameterAttribute[SgrParameterAttribute["YellowBackground"] = 43] = "YellowBackground";
+    SgrParameterAttribute[SgrParameterAttribute["BlueBackground"] = 44] = "BlueBackground";
+    SgrParameterAttribute[SgrParameterAttribute["MagentaBackground"] = 45] = "MagentaBackground";
+    SgrParameterAttribute[SgrParameterAttribute["CyanBackground"] = 46] = "CyanBackground";
+    SgrParameterAttribute[SgrParameterAttribute["WhiteBackground"] = 47] = "WhiteBackground";
+    SgrParameterAttribute[SgrParameterAttribute["GrayBackground"] = 100] = "GrayBackground";
+    SgrParameterAttribute[SgrParameterAttribute["DefaultBackground"] = 49] = "DefaultBackground";
+    SgrParameterAttribute[SgrParameterAttribute["Bold"] = 1] = "Bold";
+    // On Linux, the "BoldOff" code instead causes the text to be double-underlined:
+    // https://en.wikipedia.org/wiki/Talk:ANSI_escape_code#SGR_21%E2%80%94%60Bold_off%60_not_widely_supported
+    // Use "NormalColorOrIntensity" instead
+    // BoldOff = 21,
+    SgrParameterAttribute[SgrParameterAttribute["Dim"] = 2] = "Dim";
+    SgrParameterAttribute[SgrParameterAttribute["NormalColorOrIntensity"] = 22] = "NormalColorOrIntensity";
+    SgrParameterAttribute[SgrParameterAttribute["Underline"] = 4] = "Underline";
+    SgrParameterAttribute[SgrParameterAttribute["UnderlineOff"] = 24] = "UnderlineOff";
+    SgrParameterAttribute[SgrParameterAttribute["Blink"] = 5] = "Blink";
+    SgrParameterAttribute[SgrParameterAttribute["BlinkOff"] = 25] = "BlinkOff";
+    SgrParameterAttribute[SgrParameterAttribute["InvertColor"] = 7] = "InvertColor";
+    SgrParameterAttribute[SgrParameterAttribute["InvertColorOff"] = 27] = "InvertColorOff";
+    SgrParameterAttribute[SgrParameterAttribute["Hidden"] = 8] = "Hidden";
+    SgrParameterAttribute[SgrParameterAttribute["HiddenOff"] = 28] = "HiddenOff";
+})(SgrParameterAttribute || (exports.SgrParameterAttribute = SgrParameterAttribute = {}));
+/**
+ * The static functions on this class are used to produce colored text
+ * for use with a terminal that supports ANSI escape codes.
+ *
+ * Note that this API always generates color codes, regardless of whether
+ * the process's stdout is a TTY. The reason is that, in a complex program, the
+ * code that is generating strings often does not know were those strings will end
+ * up. In some cases, the same log message may get printed both to a shell
+ * that supports color AND to a log file that does not.
+ *
+ * @example
+ * ```ts
+ * console.log(Colorize.red('Red Text!'))
+ * terminal.writeLine(Colorize.green('Green Text!'), ' ', Colorize.blue('Blue Text!'));
+ *```
+ *
+ * @public
+ */
+class Colorize {
+    static black(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.BlackForeground, SgrParameterAttribute.DefaultForeground, text);
+    }
+    static red(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.RedForeground, SgrParameterAttribute.DefaultForeground, text);
+    }
+    static green(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.GreenForeground, SgrParameterAttribute.DefaultForeground, text);
+    }
+    static yellow(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.YellowForeground, SgrParameterAttribute.DefaultForeground, text);
+    }
+    static blue(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.BlueForeground, SgrParameterAttribute.DefaultForeground, text);
+    }
+    static magenta(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.MagentaForeground, SgrParameterAttribute.DefaultForeground, text);
+    }
+    static cyan(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.CyanForeground, SgrParameterAttribute.DefaultForeground, text);
+    }
+    static white(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.WhiteForeground, SgrParameterAttribute.DefaultForeground, text);
+    }
+    static gray(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.GrayForeground, SgrParameterAttribute.DefaultForeground, text);
+    }
+    static blackBackground(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.BlackBackground, SgrParameterAttribute.DefaultBackground, text);
+    }
+    static redBackground(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.RedBackground, SgrParameterAttribute.DefaultBackground, text);
+    }
+    static greenBackground(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.GreenBackground, SgrParameterAttribute.DefaultBackground, text);
+    }
+    static yellowBackground(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.YellowBackground, SgrParameterAttribute.DefaultBackground, text);
+    }
+    static blueBackground(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.BlueBackground, SgrParameterAttribute.DefaultBackground, text);
+    }
+    static magentaBackground(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.MagentaBackground, SgrParameterAttribute.DefaultBackground, text);
+    }
+    static cyanBackground(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.CyanBackground, SgrParameterAttribute.DefaultBackground, text);
+    }
+    static whiteBackground(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.WhiteBackground, SgrParameterAttribute.DefaultBackground, text);
+    }
+    static grayBackground(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.GrayBackground, SgrParameterAttribute.DefaultBackground, text);
+    }
+    static bold(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.Bold, SgrParameterAttribute.NormalColorOrIntensity, text);
+    }
+    static dim(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.Dim, SgrParameterAttribute.NormalColorOrIntensity, text);
+    }
+    static underline(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.Underline, SgrParameterAttribute.UnderlineOff, text);
+    }
+    static blink(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.Blink, SgrParameterAttribute.BlinkOff, text);
+    }
+    static invertColor(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.InvertColor, SgrParameterAttribute.InvertColorOff, text);
+    }
+    static hidden(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.Hidden, SgrParameterAttribute.HiddenOff, text);
+    }
+    static _wrapTextInAnsiEscapeCodes(startCode, endCode, text) {
+        return (AnsiEscape_1.AnsiEscape.getEscapeSequenceForAnsiCode(startCode) +
+            text +
+            AnsiEscape_1.AnsiEscape.getEscapeSequenceForAnsiCode(endCode));
+    }
+}
+exports.Colorize = Colorize;
+//# sourceMappingURL=Colorize.js.map

package/lib/Colorize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Colorize.js","sourceRoot":"","sources":["../src/Colorize.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 { AnsiEscape } from './AnsiEscape';\n\nexport enum SgrParameterAttribute {\n  BlackForeground = 30,\n  RedForeground = 31,\n  GreenForeground = 32,\n  YellowForeground = 33,\n  BlueForeground = 34,\n  MagentaForeground = 35,\n  CyanForeground = 36,\n  WhiteForeground = 37,\n  GrayForeground = 90,\n  DefaultForeground = 39,\n\n  BlackBackground = 40,\n  RedBackground = 41,\n  GreenBackground = 42,\n  YellowBackground = 43,\n  BlueBackground = 44,\n  MagentaBackground = 45,\n  CyanBackground = 46,\n  WhiteBackground = 47,\n  GrayBackground = 100,\n  DefaultBackground = 49,\n\n  Bold = 1,\n\n  // On Linux, the \"BoldOff\" code instead causes the text to be double-underlined:\n  // https://en.wikipedia.org/wiki/Talk:ANSI_escape_code#SGR_21%E2%80%94%60Bold_off%60_not_widely_supported\n  // Use \"NormalColorOrIntensity\" instead\n  // BoldOff = 21,\n\n  Dim = 2,\n  NormalColorOrIntensity = 22,\n  Underline = 4,\n  UnderlineOff = 24,\n  Blink = 5,\n  BlinkOff = 25,\n  InvertColor = 7,\n  InvertColorOff = 27,\n  Hidden = 8,\n  HiddenOff = 28\n}\n\n/**\n * The static functions on this class are used to produce colored text\n * for use with a terminal that supports ANSI escape codes.\n *\n * Note that this API always generates color codes, regardless of whether\n * the process's stdout is a TTY. The reason is that, in a complex program, the\n * code that is generating strings often does not know were those strings will end\n * up. In some cases, the same log message may get printed both to a shell\n * that supports color AND to a log file that does not.\n *\n * @example\n * ```ts\n * console.log(Colorize.red('Red Text!'))\n * terminal.writeLine(Colorize.green('Green Text!'), ' ', Colorize.blue('Blue Text!'));\n *```\n *\n * @public\n */\nexport class Colorize {\n  public static black(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.BlackForeground,\n      SgrParameterAttribute.DefaultForeground,\n      text\n    );\n  }\n\n  public static red(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.RedForeground,\n      SgrParameterAttribute.DefaultForeground,\n      text\n    );\n  }\n\n  public static green(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.GreenForeground,\n      SgrParameterAttribute.DefaultForeground,\n      text\n    );\n  }\n\n  public static yellow(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.YellowForeground,\n      SgrParameterAttribute.DefaultForeground,\n      text\n    );\n  }\n\n  public static blue(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.BlueForeground,\n      SgrParameterAttribute.DefaultForeground,\n      text\n    );\n  }\n\n  public static magenta(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.MagentaForeground,\n      SgrParameterAttribute.DefaultForeground,\n      text\n    );\n  }\n\n  public static cyan(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.CyanForeground,\n      SgrParameterAttribute.DefaultForeground,\n      text\n    );\n  }\n\n  public static white(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.WhiteForeground,\n      SgrParameterAttribute.DefaultForeground,\n      text\n    );\n  }\n\n  public static gray(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.GrayForeground,\n      SgrParameterAttribute.DefaultForeground,\n      text\n    );\n  }\n\n  public static blackBackground(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.BlackBackground,\n      SgrParameterAttribute.DefaultBackground,\n      text\n    );\n  }\n\n  public static redBackground(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.RedBackground,\n      SgrParameterAttribute.DefaultBackground,\n      text\n    );\n  }\n\n  public static greenBackground(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.GreenBackground,\n      SgrParameterAttribute.DefaultBackground,\n      text\n    );\n  }\n\n  public static yellowBackground(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.YellowBackground,\n      SgrParameterAttribute.DefaultBackground,\n      text\n    );\n  }\n\n  public static blueBackground(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.BlueBackground,\n      SgrParameterAttribute.DefaultBackground,\n      text\n    );\n  }\n\n  public static magentaBackground(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.MagentaBackground,\n      SgrParameterAttribute.DefaultBackground,\n      text\n    );\n  }\n\n  public static cyanBackground(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.CyanBackground,\n      SgrParameterAttribute.DefaultBackground,\n      text\n    );\n  }\n\n  public static whiteBackground(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.WhiteBackground,\n      SgrParameterAttribute.DefaultBackground,\n      text\n    );\n  }\n\n  public static grayBackground(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.GrayBackground,\n      SgrParameterAttribute.DefaultBackground,\n      text\n    );\n  }\n\n  public static bold(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.Bold,\n      SgrParameterAttribute.NormalColorOrIntensity,\n      text\n    );\n  }\n\n  public static dim(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.Dim,\n      SgrParameterAttribute.NormalColorOrIntensity,\n      text\n    );\n  }\n\n  public static underline(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.Underline,\n      SgrParameterAttribute.UnderlineOff,\n      text\n    );\n  }\n\n  public static blink(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.Blink,\n      SgrParameterAttribute.BlinkOff,\n      text\n    );\n  }\n\n  public static invertColor(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.InvertColor,\n      SgrParameterAttribute.InvertColorOff,\n      text\n    );\n  }\n\n  public static hidden(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.Hidden,\n      SgrParameterAttribute.HiddenOff,\n      text\n    );\n  }\n\n  private static _wrapTextInAnsiEscapeCodes(startCode: number, endCode: number, text: string): string {\n    return (\n      AnsiEscape.getEscapeSequenceForAnsiCode(startCode) +\n      text +\n      AnsiEscape.getEscapeSequenceForAnsiCode(endCode)\n    );\n  }\n}\n"]}

package/lib/ConsoleTerminalProvider.d.ts

@@ -0,0 +1,48 @@
+import { type ITerminalProvider, TerminalProviderSeverity } from './ITerminalProvider';
+/**
+ * Options to be provided to a {@link ConsoleTerminalProvider}
+ *
+ * @beta
+ */
+export interface IConsoleTerminalProviderOptions {
+    /**
+     * If true, print verbose logging messages.
+     */
+    verboseEnabled: boolean;
+    /**
+     * If true, print debug logging messages. Note that "verbose" and "debug" are considered
+     * separate message filters; if you want debug to imply verbose, it is up to your
+     * application code to enforce that.
+     */
+    debugEnabled: boolean;
+}
+/**
+ * Terminal provider that prints to STDOUT (for log- and verbose-level messages) and
+ * STDERR (for warning- and error-level messsages).
+ *
+ * @beta
+ */
+export declare class ConsoleTerminalProvider implements ITerminalProvider {
+    /**
+     * If true, verbose-level messages should be written to the console.
+     */
+    verboseEnabled: boolean;
+    /**
+     * If true, debug-level messages should be written to the console.
+     */
+    debugEnabled: boolean;
+    constructor(options?: Partial<IConsoleTerminalProviderOptions>);
+    /**
+     * {@inheritDoc ITerminalProvider.write}
+     */
+    write(data: string, severity: TerminalProviderSeverity): void;
+    /**
+     * {@inheritDoc ITerminalProvider.eolCharacter}
+     */
+    get eolCharacter(): string;
+    /**
+     * {@inheritDoc ITerminalProvider.supportsColor}
+     */
+    get supportsColor(): boolean;
+}
+//# sourceMappingURL=ConsoleTerminalProvider.d.ts.map

package/lib/ConsoleTerminalProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsoleTerminalProvider.d.ts","sourceRoot":"","sources":["../src/ConsoleTerminalProvider.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAEvF;;;;GAIG;AACH,MAAM,WAAW,+BAA+B;IAC9C;;OAEG;IACH,cAAc,EAAE,OAAO,CAAC;IAExB;;;;OAIG;IACH,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;;;;GAKG;AACH,qBAAa,uBAAwB,YAAW,iBAAiB;IAC/D;;OAEG;IACI,cAAc,EAAE,OAAO,CAAS;IAEvC;;OAEG;IACI,YAAY,EAAE,OAAO,CAAS;gBAElB,OAAO,GAAE,OAAO,CAAC,+BAA+B,CAAM;IAKzE;;OAEG;IACI,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,wBAAwB,GAAG,IAAI;IA8BpE;;OAEG;IACH,IAAW,YAAY,IAAI,MAAM,CAEhC;IAED;;OAEG;IACH,IAAW,aAAa,IAAI,OAAO,CAElC;CACF"}

package/lib/ConsoleTerminalProvider.js

@@ -0,0 +1,71 @@
+"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.ConsoleTerminalProvider = void 0;
+const os_1 = require("os");
+const safe_1 = require("colors/safe");
+const ITerminalProvider_1 = require("./ITerminalProvider");
+/**
+ * Terminal provider that prints to STDOUT (for log- and verbose-level messages) and
+ * STDERR (for warning- and error-level messsages).
+ *
+ * @beta
+ */
+class ConsoleTerminalProvider {
+    constructor(options = {}) {
+        /**
+         * If true, verbose-level messages should be written to the console.
+         */
+        this.verboseEnabled = false;
+        /**
+         * If true, debug-level messages should be written to the console.
+         */
+        this.debugEnabled = false;
+        this.verboseEnabled = !!options.verboseEnabled;
+        this.debugEnabled = !!options.debugEnabled;
+    }
+    /**
+     * {@inheritDoc ITerminalProvider.write}
+     */
+    write(data, severity) {
+        switch (severity) {
+            case ITerminalProvider_1.TerminalProviderSeverity.warning:
+            case ITerminalProvider_1.TerminalProviderSeverity.error: {
+                process.stderr.write(data);
+                break;
+            }
+            case ITerminalProvider_1.TerminalProviderSeverity.verbose: {
+                if (this.verboseEnabled) {
+                    process.stdout.write(data);
+                }
+                break;
+            }
+            case ITerminalProvider_1.TerminalProviderSeverity.debug: {
+                if (this.debugEnabled) {
+                    process.stdout.write(data);
+                }
+                break;
+            }
+            case ITerminalProvider_1.TerminalProviderSeverity.log:
+            default: {
+                process.stdout.write(data);
+                break;
+            }
+        }
+    }
+    /**
+     * {@inheritDoc ITerminalProvider.eolCharacter}
+     */
+    get eolCharacter() {
+        return os_1.EOL;
+    }
+    /**
+     * {@inheritDoc ITerminalProvider.supportsColor}
+     */
+    get supportsColor() {
+        return safe_1.enabled;
+    }
+}
+exports.ConsoleTerminalProvider = ConsoleTerminalProvider;
+//# sourceMappingURL=ConsoleTerminalProvider.js.map

package/lib/ConsoleTerminalProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsoleTerminalProvider.js","sourceRoot":"","sources":["../src/ConsoleTerminalProvider.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAE3D,2BAAyB;AACzB,sCAAuD;AAEvD,2DAAuF;AAqBvF;;;;;GAKG;AACH,MAAa,uBAAuB;IAWlC,YAAmB,UAAoD,EAAE;QAVzE;;WAEG;QACI,mBAAc,GAAY,KAAK,CAAC;QAEvC;;WAEG;QACI,iBAAY,GAAY,KAAK,CAAC;QAGnC,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;QAC/C,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;IAC7C,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,IAAY,EAAE,QAAkC;QAC3D,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,4CAAwB,CAAC,OAAO,CAAC;YACtC,KAAK,4CAAwB,CAAC,KAAK,CAAC,CAAC,CAAC;gBACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC3B,MAAM;YACR,CAAC;YAED,KAAK,4CAAwB,CAAC,OAAO,CAAC,CAAC,CAAC;gBACtC,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;oBACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC7B,CAAC;gBACD,MAAM;YACR,CAAC;YAED,KAAK,4CAAwB,CAAC,KAAK,CAAC,CAAC,CAAC;gBACpC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;oBACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC7B,CAAC;gBACD,MAAM;YACR,CAAC;YAED,KAAK,4CAAwB,CAAC,GAAG,CAAC;YAClC,OAAO,CAAC,CAAC,CAAC;gBACR,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC3B,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAW,YAAY;QACrB,OAAO,QAAG,CAAC;IACb,CAAC;IAED;;OAEG;IACH,IAAW,aAAa;QACtB,OAAO,cAAa,CAAC;IACvB,CAAC;CACF;AA9DD,0DA8DC","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 { EOL } from 'os';\nimport { enabled as supportsColor } from 'colors/safe';\n\nimport { type ITerminalProvider, TerminalProviderSeverity } from './ITerminalProvider';\n\n/**\n * Options to be provided to a {@link ConsoleTerminalProvider}\n *\n * @beta\n */\nexport interface IConsoleTerminalProviderOptions {\n  /**\n   * If true, print verbose logging messages.\n   */\n  verboseEnabled: boolean;\n\n  /**\n   * If true, print debug logging messages. Note that \"verbose\" and \"debug\" are considered\n   * separate message filters; if you want debug to imply verbose, it is up to your\n   * application code to enforce that.\n   */\n  debugEnabled: boolean;\n}\n\n/**\n * Terminal provider that prints to STDOUT (for log- and verbose-level messages) and\n * STDERR (for warning- and error-level messsages).\n *\n * @beta\n */\nexport class ConsoleTerminalProvider implements ITerminalProvider {\n  /**\n   * If true, verbose-level messages should be written to the console.\n   */\n  public verboseEnabled: boolean = false;\n\n  /**\n   * If true, debug-level messages should be written to the console.\n   */\n  public debugEnabled: boolean = false;\n\n  public constructor(options: Partial<IConsoleTerminalProviderOptions> = {}) {\n    this.verboseEnabled = !!options.verboseEnabled;\n    this.debugEnabled = !!options.debugEnabled;\n  }\n\n  /**\n   * {@inheritDoc ITerminalProvider.write}\n   */\n  public write(data: string, severity: TerminalProviderSeverity): void {\n    switch (severity) {\n      case TerminalProviderSeverity.warning:\n      case TerminalProviderSeverity.error: {\n        process.stderr.write(data);\n        break;\n      }\n\n      case TerminalProviderSeverity.verbose: {\n        if (this.verboseEnabled) {\n          process.stdout.write(data);\n        }\n        break;\n      }\n\n      case TerminalProviderSeverity.debug: {\n        if (this.debugEnabled) {\n          process.stdout.write(data);\n        }\n        break;\n      }\n\n      case TerminalProviderSeverity.log:\n      default: {\n        process.stdout.write(data);\n        break;\n      }\n    }\n  }\n\n  /**\n   * {@inheritDoc ITerminalProvider.eolCharacter}\n   */\n  public get eolCharacter(): string {\n    return EOL;\n  }\n\n  /**\n   * {@inheritDoc ITerminalProvider.supportsColor}\n   */\n  public get supportsColor(): boolean {\n    return supportsColor;\n  }\n}\n"]}

package/lib/ITerminal.d.ts

@@ -0,0 +1,81 @@
+import type { ITerminalProvider } from './ITerminalProvider';
+/**
+ * @beta
+ */
+export interface ITerminalWriteOptions {
+    /**
+     * If set to true, SGR parameters will not be replaced by the terminal
+     * standard (i.e. - red for errors, yellow for warnings).
+     */
+    doNotOverrideSgrCodes?: boolean;
+}
+/**
+ * @beta
+ */
+export type TerminalWriteParameters = string[] | [...string[], ITerminalWriteOptions];
+/**
+ * @beta
+ */
+export interface ITerminal {
+    /**
+     * Subscribe a new terminal provider.
+     */
+    registerProvider(provider: ITerminalProvider): void;
+    /**
+     * Unsubscribe a terminal provider. If the provider isn't subscribed, this function does nothing.
+     */
+    unregisterProvider(provider: ITerminalProvider): void;
+    /**
+     * Write a generic message to the terminal
+     */
+    write(...messageParts: TerminalWriteParameters): void;
+    /**
+     * Write a generic message to the terminal, followed by a newline
+     */
+    writeLine(...messageParts: TerminalWriteParameters): void;
+    /**
+     * Write a warning message to the console with yellow text.
+     *
+     * @remarks
+     * The yellow color takes precedence over any other foreground colors set.
+     */
+    writeWarning(...messageParts: TerminalWriteParameters): void;
+    /**
+     * Write a warning message to the console with yellow text, followed by a newline.
+     *
+     * @remarks
+     * The yellow color takes precedence over any other foreground colors set.
+     */
+    writeWarningLine(...messageParts: TerminalWriteParameters): void;
+    /**
+     * Write an error message to the console with red text.
+     *
+     * @remarks
+     * The red color takes precedence over any other foreground colors set.
+     */
+    writeError(...messageParts: TerminalWriteParameters): void;
+    /**
+     * Write an error message to the console with red text, followed by a newline.
+     *
+     * @remarks
+     * The red color takes precedence over any other foreground colors set.
+     */
+    writeErrorLine(...messageParts: TerminalWriteParameters): void;
+    /**
+     * Write a verbose-level message.
+     */
+    writeVerbose(...messageParts: TerminalWriteParameters): void;
+    /**
+     * Write a verbose-level message followed by a newline.
+     */
+    writeVerboseLine(...messageParts: TerminalWriteParameters): void;
+    /**
+     * Write a debug-level message.
+     */
+    writeDebug(...messageParts: TerminalWriteParameters): void;
+    /**
+     * Write a debug-level message followed by a newline.
+     */
+    writeDebugLine(...messageParts: TerminalWriteParameters): void;
+}
+//# sourceMappingURL=ITerminal.d.ts.map

package/lib/ITerminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITerminal.d.ts","sourceRoot":"","sources":["../src/ITerminal.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,EAAE,EAAE,qBAAqB,CAAC,CAAC;AAEtF;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAEpD;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAEtD;;OAEG;IACH,KAAK,CAAC,GAAG,YAAY,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAEtD;;OAEG;IACH,SAAS,CAAC,GAAG,YAAY,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAE1D;;;;;OAKG;IACH,YAAY,CAAC,GAAG,YAAY,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAE7D;;;;;OAKG;IACH,gBAAgB,CAAC,GAAG,YAAY,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAEjE;;;;;OAKG;IACH,UAAU,CAAC,GAAG,YAAY,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAE3D;;;;;OAKG;IACH,cAAc,CAAC,GAAG,YAAY,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAE/D;;OAEG;IACH,YAAY,CAAC,GAAG,YAAY,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAE7D;;OAEG;IACH,gBAAgB,CAAC,GAAG,YAAY,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAEjE;;OAEG;IACH,UAAU,CAAC,GAAG,YAAY,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAE3D;;OAEG;IACH,cAAc,CAAC,GAAG,YAAY,EAAE,uBAAuB,GAAG,IAAI,CAAC;CAChE"}

package/lib/ITerminal.js

@@ -0,0 +1,5 @@
+"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 });
+//# sourceMappingURL=ITerminal.js.map

package/lib/ITerminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITerminal.js","sourceRoot":"","sources":["../src/ITerminal.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D","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 } from './ITerminalProvider';\n\n/**\n * @beta\n */\nexport interface ITerminalWriteOptions {\n  /**\n   * If set to true, SGR parameters will not be replaced by the terminal\n   * standard (i.e. - red for errors, yellow for warnings).\n   */\n  doNotOverrideSgrCodes?: boolean;\n}\n\n/**\n * @beta\n */\nexport type TerminalWriteParameters = string[] | [...string[], ITerminalWriteOptions];\n\n/**\n * @beta\n */\nexport interface ITerminal {\n  /**\n   * Subscribe a new terminal provider.\n   */\n  registerProvider(provider: ITerminalProvider): void;\n\n  /**\n   * Unsubscribe a terminal provider. If the provider isn't subscribed, this function does nothing.\n   */\n  unregisterProvider(provider: ITerminalProvider): void;\n\n  /**\n   * Write a generic message to the terminal\n   */\n  write(...messageParts: TerminalWriteParameters): void;\n\n  /**\n   * Write a generic message to the terminal, followed by a newline\n   */\n  writeLine(...messageParts: TerminalWriteParameters): void;\n\n  /**\n   * Write a warning message to the console with yellow text.\n   *\n   * @remarks\n   * The yellow color takes precedence over any other foreground colors set.\n   */\n  writeWarning(...messageParts: TerminalWriteParameters): void;\n\n  /**\n   * Write a warning message to the console with yellow text, followed by a newline.\n   *\n   * @remarks\n   * The yellow color takes precedence over any other foreground colors set.\n   */\n  writeWarningLine(...messageParts: TerminalWriteParameters): void;\n\n  /**\n   * Write an error message to the console with red text.\n   *\n   * @remarks\n   * The red color takes precedence over any other foreground colors set.\n   */\n  writeError(...messageParts: TerminalWriteParameters): void;\n\n  /**\n   * Write an error message to the console with red text, followed by a newline.\n   *\n   * @remarks\n   * The red color takes precedence over any other foreground colors set.\n   */\n  writeErrorLine(...messageParts: TerminalWriteParameters): void;\n\n  /**\n   * Write a verbose-level message.\n   */\n  writeVerbose(...messageParts: TerminalWriteParameters): void;\n\n  /**\n   * Write a verbose-level message followed by a newline.\n   */\n  writeVerboseLine(...messageParts: TerminalWriteParameters): void;\n\n  /**\n   * Write a debug-level message.\n   */\n  writeDebug(...messageParts: TerminalWriteParameters): void;\n\n  /**\n   * Write a debug-level message followed by a newline.\n   */\n  writeDebugLine(...messageParts: TerminalWriteParameters): void;\n}\n"]}