@twilio/flex-dev-utils 5.0.1-beta.0

package/dist/logger/lib/logger.js

@@ -0,0 +1,354 @@
+"use strict";
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from) {
+    for (var i = 0, il = from.length, j = to.length; i < il; i++, j++)
+        to[j] = from[i];
+    return to;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._logger = exports.Logger = exports.coloredStrings = void 0;
+/* eslint-disable @typescript-eslint/no-explicit-any, prefer-named-capture-group */
+var util_1 = require("util");
+var chalk_1 = __importDefault(require("chalk"));
+var wrap_ansi_1 = __importDefault(require("wrap-ansi"));
+var pipe_compose_1 = require("@k88/pipe-compose");
+var flex_plugins_utils_env_1 = __importDefault(require("@twilio/flex-plugins-utils-env"));
+var string_width_1 = __importDefault(require("string-width"));
+var columnify_1 = __importDefault(require("./columnify"));
+// The default option for wrap-ansi
+var DefaultWrapOptions = { hard: true };
+exports.coloredStrings = {
+    dim: chalk_1.default.dim,
+    bold: chalk_1.default.bold,
+    italic: chalk_1.default.italic,
+    code: chalk_1.default.magenta,
+    link: chalk_1.default.cyan,
+    info: chalk_1.default.blue,
+    success: chalk_1.default.green,
+    warning: chalk_1.default.yellow,
+    error: chalk_1.default.red,
+    headline: chalk_1.default.bold.green,
+    name: chalk_1.default.bold.magenta,
+    digit: chalk_1.default.magenta,
+};
+/**
+ * The Logger class
+ */
+var Logger = /** @class */ (function () {
+    function Logger(options) {
+        var _this = this;
+        /**
+         * debug level log
+         * @param args
+         */
+        this.debug = function () {
+            var args = [];
+            for (var _i = 0; _i < arguments.length; _i++) {
+                args[_i] = arguments[_i];
+            }
+            if (_this.isDebug()) {
+                _this._log({ level: 'info', args: args });
+            }
+        };
+        /**
+         * trace level trace
+         * @param args
+         */
+        this.trace = function () {
+            var args = [];
+            for (var _i = 0; _i < arguments.length; _i++) {
+                args[_i] = arguments[_i];
+            }
+            if (_this.isTrace()) {
+                _this._log({ level: 'info', args: args });
+            }
+        };
+        /**
+         * info level log
+         * @param args
+         */
+        this.info = function () {
+            var args = [];
+            for (var _i = 0; _i < arguments.length; _i++) {
+                args[_i] = arguments[_i];
+            }
+            _this._log({ level: 'info', args: args });
+        };
+        /**
+         * success level log
+         * @param args
+         */
+        this.success = function () {
+            var args = [];
+            for (var _i = 0; _i < arguments.length; _i++) {
+                args[_i] = arguments[_i];
+            }
+            _this._log({ level: 'info', color: 'green', args: args });
+        };
+        /**
+         * error level log
+         * @param args
+         */
+        this.error = function () {
+            var args = [];
+            for (var _i = 0; _i < arguments.length; _i++) {
+                args[_i] = arguments[_i];
+            }
+            _this._log({ level: 'error', color: 'red', args: args });
+        };
+        /**
+         * warning level log
+         * @param args
+         */
+        this.warning = function () {
+            var args = [];
+            for (var _i = 0; _i < arguments.length; _i++) {
+                args[_i] = arguments[_i];
+            }
+            _this._log({ level: 'warn', color: 'yellow', args: args });
+        };
+        /**
+         * Notice log is info level with a magenta color
+         * @param args
+         */
+        this.notice = function () {
+            var args = [];
+            for (var _i = 0; _i < arguments.length; _i++) {
+                args[_i] = arguments[_i];
+            }
+            _this._log({ level: 'info', color: 'magenta', args: args });
+        };
+        /**
+         * Simple wrapper for column printing
+         * @param lines
+         * @param options
+         */
+        this.columns = function (lines, options) {
+            var minWidths = Array(lines[0].length).fill(0);
+            lines.forEach(function (line) {
+                line.forEach(function (entry, index) {
+                    minWidths[index] = Math.max(minWidths[index], string_width_1.default(entry));
+                });
+            });
+            // Convert array to object
+            var data = lines.map(function (line) {
+                return line.reduce(function (accum, entry, index) {
+                    accum["entry" + index] = entry;
+                    return accum;
+                }, {});
+            });
+            // create the configuration
+            var config = minWidths.reduce(function (accum, minWidth, index) {
+                if (index < minWidths.length - 1) {
+                    minWidth += 5;
+                }
+                accum["entry" + index] = { minWidth: minWidth };
+                return accum;
+            }, {});
+            var cols = columnify_1.default(data, { showHeaders: false, config: config });
+            if (options === null || options === void 0 ? void 0 : options.indent) {
+                cols = cols
+                    .split('\n')
+                    .map(function (entry) { return "\t" + entry; })
+                    .join('\n');
+            }
+            _this._log({ level: 'info', args: [cols] });
+        };
+        /**
+         * Appends new line
+         * @param lines the number of lines to append
+         */
+        this.newline = function (lines) {
+            if (lines === void 0) { lines = 1; }
+            for (var i = 0; i < lines; i++) {
+                _this.info();
+            }
+        };
+        /**
+         * A wrapper for showing bash command information such as `npm install foo`
+         * @param command the bash command
+         * @param args  the remaining arguments
+         */
+        this.installInfo = function (command) {
+            var args = [];
+            for (var _i = 1; _i < arguments.length; _i++) {
+                args[_i - 1] = arguments[_i];
+            }
+            _this.info.apply(_this, __spreadArray(['\t', chalk_1.default.cyan(command)], __read(args)));
+        };
+        /**
+         * Clears the terminal either if forced is provided, or if persist_terminal env is not set
+         */
+        /* istanbul ignore next */
+        this.clearTerminal = function (forced) {
+            if (forced === void 0) { forced = false; }
+            if (forced || !flex_plugins_utils_env_1.default.isTerminalPersisted()) {
+                process.stdout.write(flex_plugins_utils_env_1.default.isWin32() ? '\x1B[2J\x1B[0f' : '\x1B[2J\x1B[3J\x1B[H');
+            }
+        };
+        /**
+         * Provides basic markdown support. Currently supported bold **bold** and italic *italic*
+         * @param msg
+         */
+        this.markdown = function (msg) {
+            if (!msg || msg === '') {
+                return msg;
+            }
+            for (var key in Logger.formatter) {
+                if (Logger.formatter.hasOwnProperty(key)) {
+                    var formatter = Logger.formatter[key];
+                    var regex = new RegExp(formatter.openChars + "(.*?)" + formatter.closeChars);
+                    var match = msg.match(regex);
+                    if (match) {
+                        var replace = match[0]
+                            .replace(new RegExp(formatter.openChars, 'g'), '')
+                            .replace(new RegExp(formatter.closeChars, 'g'), '');
+                        return _this.markdown(msg.replace(regex, formatter.render(replace)));
+                    }
+                }
+            }
+            return msg.replace(/\\/g, '');
+        };
+        /**
+         * The internal logger method
+         * @param args
+         * @private
+         */
+        this._log = function (args) {
+            if (!_this.isQuiet() || args.level === 'error' || _this.isDebug()) {
+                // eslint-disable-next-line no-console
+                var log = console[args.level];
+                var color = args.color ? chalk_1.default[args.color] : function (msg) { return msg; };
+                var msg = util_1.format.apply({}, args.args);
+                pipe_compose_1.pipe(msg, color, _this.markdown, log);
+            }
+        };
+        /**
+         * Checks whether the logger is set for debug mode
+         */
+        this.isDebug = function () {
+            if ('isDebug' in _this.options) {
+                return _this.options.isDebug || false;
+            }
+            return flex_plugins_utils_env_1.default.isDebug();
+        };
+        /**
+         * Checks whether the logger is set for trace mode
+         */
+        this.isTrace = function () {
+            if ('isTrace' in _this.options) {
+                return _this.options.isTrace || false;
+            }
+            return flex_plugins_utils_env_1.default.isTrace();
+        };
+        this.isQuiet = function () {
+            if ('isQuiet' in _this.options) {
+                return _this.options.isQuiet || false;
+            }
+            return flex_plugins_utils_env_1.default.isQuiet();
+        };
+        this.options = options || {};
+    }
+    Logger.formatter = {
+        dim: {
+            openChars: '\\.{2}',
+            closeChars: '\\.{2}',
+            render: exports.coloredStrings.dim,
+        },
+        bold: {
+            openChars: '\\*{2}',
+            closeChars: '\\*{2}',
+            render: exports.coloredStrings.bold,
+        },
+        italic: {
+            openChars: '\\*',
+            closeChars: '\\*',
+            render: exports.coloredStrings.italic,
+        },
+        code: {
+            openChars: '\\{{2}',
+            closeChars: '\\}{2}',
+            render: exports.coloredStrings.code,
+        },
+        link: {
+            openChars: '\\[{2}',
+            closeChars: '\\]{2}',
+            render: exports.coloredStrings.link,
+        },
+        info: {
+            openChars: '@{2}',
+            closeChars: '@{2}',
+            render: exports.coloredStrings.info,
+        },
+        success: {
+            openChars: '\\+{2}',
+            closeChars: '\\+{2}',
+            render: exports.coloredStrings.success,
+        },
+        warning: {
+            openChars: '\\!{2}',
+            closeChars: '\\!{2}',
+            render: exports.coloredStrings.warning,
+        },
+        error: {
+            openChars: '\\-{2}',
+            closeChars: '\\-{2}',
+            render: exports.coloredStrings.error,
+        },
+    };
+    return Logger;
+}());
+exports.Logger = Logger;
+/**
+ * Word wrapping using ANSI escape codes
+ *
+ * @param input     the string to wrap
+ * @param columns   number of columns
+ * @param options   options
+ */
+var wrap = function (input, columns, options) {
+    if (options === void 0) { options = DefaultWrapOptions; }
+    return wrap_ansi_1.default(input, columns, options);
+};
+/**
+ * The default logger will use environment variables to determine behavior.
+ * You can create an instance to overwrite default behavior.
+ */
+exports._logger = new Logger();
+var debug = exports._logger.debug, info = exports._logger.info, warning = exports._logger.warning, error = exports._logger.error, trace = exports._logger.trace, success = exports._logger.success, newline = exports._logger.newline, notice = exports._logger.notice, installInfo = exports._logger.installInfo, clearTerminal = exports._logger.clearTerminal, markdown = exports._logger.markdown, columns = exports._logger.columns;
+exports.default = {
+    debug: debug,
+    info: info,
+    warning: warning,
+    error: error,
+    trace: trace,
+    success: success,
+    newline: newline,
+    notice: notice,
+    installInfo: installInfo,
+    clearTerminal: clearTerminal,
+    markdown: markdown,
+    wrap: wrap,
+    columns: columns,
+    colors: chalk_1.default,
+    coloredStrings: exports.coloredStrings,
+};
+//# sourceMappingURL=logger.js.map

package/dist/logger/lib/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/logger/lib/logger.ts"],"names":[],"mappings":"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"}

package/dist/logger/lib/strings.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Converts an array of arguments into a multiline string
+ *
+ * @param args  the lines to print
+ */
+export declare const multilineString: (...args: string[]) => string;
+/**
+ * Converts an array of string into a single lin
+ * @param args  the lines to print
+ */
+export declare const singleLineString: (...args: string[]) => string;
+declare const _default: {
+    multilineString: (...args: string[]) => string;
+    singleLineString: (...args: string[]) => string;
+};
+export default _default;

package/dist/logger/lib/strings.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.singleLineString = exports.multilineString = void 0;
+/**
+ * Converts an array of arguments into a multiline string
+ *
+ * @param args  the lines to print
+ */
+var multilineString = function () {
+    var args = [];
+    for (var _i = 0; _i < arguments.length; _i++) {
+        args[_i] = arguments[_i];
+    }
+    return args.join('\r\n');
+};
+exports.multilineString = multilineString;
+/**
+ * Converts an array of string into a single lin
+ * @param args  the lines to print
+ */
+var singleLineString = function () {
+    var args = [];
+    for (var _i = 0; _i < arguments.length; _i++) {
+        args[_i] = arguments[_i];
+    }
+    return args.map(function (arg, index) { return (index === 0 ? arg.trim() : " " + arg.trim()); }).join('');
+};
+exports.singleLineString = singleLineString;
+exports.default = {
+    multilineString: exports.multilineString,
+    singleLineString: exports.singleLineString,
+};
+//# sourceMappingURL=strings.js.map

package/dist/logger/lib/strings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strings.js","sourceRoot":"","sources":["../../../src/logger/lib/strings.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACI,IAAM,eAAe,GAAG;IAAC,cAAiB;SAAjB,UAAiB,EAAjB,qBAAiB,EAAjB,IAAiB;QAAjB,yBAAiB;;IAAa,OAAA,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;AAAjB,CAAiB,CAAC;AAAnE,QAAA,eAAe,mBAAoD;AAEhF;;;GAGG;AACI,IAAM,gBAAgB,GAAG;IAAC,cAAiB;SAAjB,UAAiB,EAAjB,qBAAiB,EAAjB,IAAiB;QAAjB,yBAAiB;;IAChD,OAAA,IAAI,CAAC,GAAG,CAAC,UAAC,GAAG,EAAE,KAAK,IAAK,OAAA,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAI,GAAG,CAAC,IAAI,EAAI,CAAC,EAA7C,CAA6C,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;AAAhF,CAAgF,CAAC;AADtE,QAAA,gBAAgB,oBACsD;AAEnF,kBAAe;IACb,eAAe,yBAAA;IACf,gBAAgB,0BAAA;CACjB,CAAC"}

package/dist/logger/lib/table.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Checks that the matrix's rows all have the same number of entries
+ *
+ * @param matrix
+ */
+export declare const isRegularMatrix: (matrix: string[][]) => boolean;
+/**
+ * Prints the data in a table format with the provided headers
+ *
+ * @param header  the header of the table
+ * @param data    the data entry to print
+ */
+export declare const printArray: (header: string[], data: string[][]) => void;
+/**
+ * Prints the data in a table format with the provided headers.
+ *
+ * @param data    the data entry to print
+ */
+export declare const printObjectArray: (data: object[]) => void;
+declare const _default: {
+    isRegularMatrix: (matrix: string[][]) => boolean;
+    printArray: (header: string[], data: string[][]) => void;
+    printObjectArray: (data: object[]) => void;
+};
+export default _default;

package/dist/logger/lib/table.js

@@ -0,0 +1,75 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printObjectArray = exports.printArray = exports.isRegularMatrix = void 0;
+var table_1 = require("table");
+var logger_1 = __importDefault(require("./logger"));
+var config = {
+    border: {
+        topBody: '─',
+        topJoin: '┬',
+        topLeft: '┌',
+        topRight: '┐',
+        bottomBody: '─',
+        bottomJoin: '┴',
+        bottomLeft: '└',
+        bottomRight: '┘',
+        bodyLeft: '│',
+        bodyRight: '│',
+        bodyJoin: '│',
+        joinBody: '─',
+        joinLeft: '├',
+        joinRight: '┤',
+        joinJoin: '┼',
+    },
+};
+/**
+ * Checks that the matrix's rows all have the same number of entries
+ *
+ * @param matrix
+ */
+var isRegularMatrix = function (matrix) {
+    return matrix && matrix.length > 0 && matrix[0].constructor === Array && matrix.every(function (r) { return r.length === matrix[0].length; });
+};
+exports.isRegularMatrix = isRegularMatrix;
+/**
+ * Prints the data in a table format with the provided headers
+ *
+ * @param header  the header of the table
+ * @param data    the data entry to print
+ */
+var printArray = function (header, data) {
+    if (!exports.isRegularMatrix(data)) {
+        logger_1.default.warning('Table rows are not all the same length; this may produce an irregular tabular view.');
+    }
+    if (header.length === Object.keys(data[0]).length) {
+        data.unshift(header.map(function (h) { return h.toUpperCase(); }));
+    }
+    else {
+        logger_1.default.warning('Header length does not match data row length; printing table without header.');
+    }
+    logger_1.default.info(table_1.table(data, config));
+};
+exports.printArray = printArray;
+/**
+ * Prints the data in a table format with the provided headers.
+ *
+ * @param data    the data entry to print
+ */
+// eslint-disable-next-line @typescript-eslint/ban-types
+var printObjectArray = function (data) {
+    if (data.length !== 0) {
+        var header = Object.keys(data[0]);
+        var rows = data.map(Object.values);
+        exports.printArray(header, rows);
+    }
+};
+exports.printObjectArray = printObjectArray;
+exports.default = {
+    isRegularMatrix: exports.isRegularMatrix,
+    printArray: exports.printArray,
+    printObjectArray: exports.printObjectArray,
+};
+//# sourceMappingURL=table.js.map

package/dist/logger/lib/table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.js","sourceRoot":"","sources":["../../../src/logger/lib/table.ts"],"names":[],"mappings":";;;;;;AAAA,+BAA+C;AAE/C,oDAA8B;AAE9B,IAAM,MAAM,GAAoB;IAC9B,MAAM,EAAE;QACN,OAAO,EAAE,GAAG;QACZ,OAAO,EAAE,GAAG;QACZ,OAAO,EAAE,GAAG;QACZ,QAAQ,EAAE,GAAG;QAEb,UAAU,EAAE,GAAG;QACf,UAAU,EAAE,GAAG;QACf,UAAU,EAAE,GAAG;QACf,WAAW,EAAE,GAAG;QAEhB,QAAQ,EAAE,GAAG;QACb,SAAS,EAAE,GAAG;QACd,QAAQ,EAAE,GAAG;QAEb,QAAQ,EAAE,GAAG;QACb,QAAQ,EAAE,GAAG;QACb,SAAS,EAAE,GAAG;QACd,QAAQ,EAAE,GAAG;KACd;CACF,CAAC;AAEF;;;;GAIG;AACI,IAAM,eAAe,GAAG,UAAC,MAAkB;IAChD,OAAA,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,KAAK,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,UAAC,CAAC,IAAK,OAAA,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,EAA7B,CAA6B,CAAC;AAApH,CAAoH,CAAC;AAD1G,QAAA,eAAe,mBAC2F;AAEvH;;;;;GAKG;AACI,IAAM,UAAU,GAAG,UAAC,MAAgB,EAAE,IAAgB;IAC3D,IAAI,CAAC,uBAAe,CAAC,IAAI,CAAC,EAAE;QAC1B,gBAAM,CAAC,OAAO,CAAC,qFAAqF,CAAC,CAAC;KACvG;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE;QACjD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,UAAC,CAAC,IAAK,OAAA,CAAC,CAAC,WAAW,EAAE,EAAf,CAAe,CAAC,CAAC,CAAC;KAClD;SAAM;QACL,gBAAM,CAAC,OAAO,CAAC,8EAA8E,CAAC,CAAC;KAChG;IAED,gBAAM,CAAC,IAAI,CAAC,aAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;AACnC,CAAC,CAAC;AAZW,QAAA,UAAU,cAYrB;AAEF;;;;GAIG;AACH,wDAAwD;AACjD,IAAM,gBAAgB,GAAG,UAAC,IAAc;IAC7C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE;QACrB,IAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,IAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAErC,kBAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;KAC1B;AACH,CAAC,CAAC;AAPW,QAAA,gBAAgB,oBAO3B;AAEF,kBAAe;IACb,eAAe,yBAAA;IACf,UAAU,oBAAA;IACV,gBAAgB,0BAAA;CACjB,CAAC"}

package/dist/open.d.ts

@@ -0,0 +1,2 @@
+import open from 'open';
+export default open;

package/dist/open.js

@@ -0,0 +1,9 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var open_1 = __importDefault(require("open"));
+/* istanbul ignore next */
+exports.default = open_1.default;
+//# sourceMappingURL=open.js.map

package/dist/open.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open.js","sourceRoot":"","sources":["../src/open.ts"],"names":[],"mappings":";;;;;AAAA,8CAAwB;AAExB,0BAA0B;AAC1B,kBAAe,cAAI,CAAC"}

package/dist/prints.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Prints the lines in a numbered list:
+ *  1. line 1
+ *  2. line 2
+ *  3. line 3
+ *
+ * @param lines the lines to print
+ */
+export declare const printList: (...lines: string[]) => void;
+declare const _default: {};
+export default _default;

package/dist/prints.js

@@ -0,0 +1,47 @@
+"use strict";
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from) {
+    for (var i = 0, il = from.length, j = to.length; i < il; i++, j++)
+        to[j] = from[i];
+    return to;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printList = void 0;
+var logger_1 = require("./logger");
+/**
+ * Prints the lines in a numbered list:
+ *  1. line 1
+ *  2. line 2
+ *  3. line 3
+ *
+ * @param lines the lines to print
+ */
+var printList = function () {
+    var lines = [];
+    for (var _i = 0; _i < arguments.length; _i++) {
+        lines[_i] = arguments[_i];
+    }
+    var digitColor = logger_1.logger.coloredStrings.digit;
+    lines = lines.map(function (line, index) { return "\t " + digitColor((index + 1).toString()) + ". " + line; });
+    logger_1.logger.newline();
+    logger_1.logger.info(logger_1.multilineString.apply(void 0, __spreadArray([], __read(lines))));
+    logger_1.logger.newline();
+};
+exports.printList = printList;
+exports.default = {};
+//# sourceMappingURL=prints.js.map

package/dist/prints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prints.js","sourceRoot":"","sources":["../src/prints.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAAA,mCAAmD;AAEnD;;;;;;;GAOG;AACI,IAAM,SAAS,GAAG;IAAC,eAAkB;SAAlB,UAAkB,EAAlB,qBAAkB,EAAlB,IAAkB;QAAlB,0BAAkB;;IAC1C,IAAM,UAAU,GAAG,eAAM,CAAC,cAAc,CAAC,KAAK,CAAC;IAE/C,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,UAAC,IAAI,EAAE,KAAK,IAAK,OAAA,QAAM,UAAU,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,UAAK,IAAM,EAAnD,CAAmD,CAAC,CAAC;IACxF,eAAM,CAAC,OAAO,EAAE,CAAC;IACjB,eAAM,CAAC,IAAI,CAAC,wBAAe,wCAAI,KAAK,IAAE,CAAC;IACvC,eAAM,CAAC,OAAO,EAAE,CAAC;AACnB,CAAC,CAAC;AAPW,QAAA,SAAS,aAOpB;AAEF,kBAAe,EAAE,CAAC"}

package/dist/progress/index.d.ts

@@ -0,0 +1 @@
+export { default as progress } from './lib/progress';

package/dist/progress/index.js

@@ -0,0 +1,9 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.progress = void 0;
+var progress_1 = require("./lib/progress");
+Object.defineProperty(exports, "progress", { enumerable: true, get: function () { return __importDefault(progress_1).default; } });
+//# sourceMappingURL=index.js.map

package/dist/progress/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/progress/index.ts"],"names":[],"mappings":";;;;;;AAAA,2CAAqD;AAA5C,qHAAA,OAAO,OAAY"}

package/dist/progress/lib/progress.d.ts

@@ -0,0 +1,21 @@
+export declare type Callback<R> = () => Promise<R>;
+interface Progress {
+    start: () => void;
+    succeed: () => void;
+    fail: (text?: string) => void;
+}
+/**
+ * Added for testing purposes
+ * @param title
+ * @param disabled
+ */
+export declare const _getSpinner: (text: string, disabled: boolean) => Progress;
+/**
+ * An {@link ora} progress wrapper
+ *
+ * @param title   the title to show
+ * @param action  the callback to run
+ * @param disabled force enable the progress
+ */
+export declare const progress: <R>(title: string, action: Callback<R>, disabled?: boolean) => Promise<R>;
+export default progress;