@gadgetinc/ggt 0.4.10 → 1.0.0

package/lib/services/output/select.js

@@ -0,0 +1,198 @@
+import { _ as _define_property } from "@swc/helpers/_/_define_property";
+import chalk from "chalk";
+import indentString from "indent-string";
+import assert from "node:assert";
+import process from "node:process";
+import { isString } from "../util/is.js";
+import { defaults } from "../util/object.js";
+import { output } from "./output.js";
+import { println } from "./print.js";
+import { entriesToDisplay, Prompt } from "./prompt.js";
+import { sprint, sprintln } from "./sprint.js";
+import { symbol } from "./symbols.js";
+// TODO: i regret this api... don't make it the same as println... just make it take ctx and options
+export const select = (options)=>{
+    options = defaults(options, {
+        ensureEmptyLineAbove: true
+    });
+    return (template, ...values)=>{
+        let text = template;
+        if (!isString(text)) {
+            text = sprint(template, ...values);
+        }
+        if (!output.isInteractive) {
+            // TODO: log an error here
+            println(options)(text);
+            println({
+                ensureEmptyLineAbove: true
+            })`
+        Aborting because ggt is not running in an interactive terminal.
+      `;
+            process.exit(1);
+        }
+        return new Promise((resolve)=>{
+            const sel = new Select(text, {
+                formatChoice: (choice)=>choice,
+                formatSelection: (choice)=>choice,
+                ...options
+            });
+            sel.on("submit", resolve);
+            sel.on("exit", ()=>process.exit(0));
+            sel.on("abort", ()=>process.exit(0));
+        });
+    };
+};
+/**
+ * Inspired by `prompts`:
+ * https://github.com/terkelg/prompts/blob/e0519913ec4fcc6746bb3d97d8cd0960c3f3ffde/lib/elements/select.js
+ *
+ * MIT License
+ *
+ * Copyright (c) 2018 Terkel Gjervig Nielsen
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */ // TODO: implement autocomplete https://github.com/terkelg/prompts/blob/e0519913ec4fcc6746bb3d97d8cd0960c3f3ffde/lib/elements/autocomplete.js
+class Select extends Prompt {
+    get selection() {
+        const choice = this.options.choices[this.cursor];
+        assert(choice, `choices[${this.cursor}] is not defined`);
+        return choice;
+    }
+    moveCursor(n) {
+        this.cursor = n;
+        this.fire();
+    }
+    reset() {
+        this.moveCursor(0);
+        this.fire();
+        this.render();
+    }
+    exit() {
+        this.abort();
+    }
+    abort() {
+        this.done = this.aborted = true;
+        this.fire();
+        this.render("Cancel (Ctrl+C)");
+        this.close();
+    }
+    submit() {
+        this.done = true;
+        this.aborted = false;
+        this.value = this.selection;
+        this.fire();
+        this.render();
+        this.close();
+    }
+    first() {
+        this.moveCursor(0);
+        this.render();
+    }
+    last() {
+        this.moveCursor(this.options.choices.length - 1);
+        this.render();
+    }
+    up() {
+        if (this.cursor === 0) {
+            this.moveCursor(this.options.choices.length - 1);
+        } else {
+            this.moveCursor(this.cursor - 1);
+        }
+        this.render();
+    }
+    down() {
+        if (this.cursor === this.options.choices.length - 1) {
+            this.moveCursor(0);
+        } else {
+            this.moveCursor(this.cursor + 1);
+        }
+        this.render();
+    }
+    next() {
+        this.moveCursor((this.cursor + 1) % this.options.choices.length);
+        this.render();
+    }
+    _(char, _key) {
+        if (char === " ") {
+            this.submit();
+            return;
+        }
+    }
+    render(selection) {
+        if (this.closed) {
+            return;
+        }
+        super.render();
+        let question = this.text;
+        if (this.done) {
+            output.persistPrompt(sprintln`
+        ${question.trimEnd()} ${this.options.formatChoice(selection ?? this.selection)}
+      `);
+            return;
+        }
+        question += ` ${chalk.gray("Use arrow keys to move")}\n\n`;
+        let choices = "";
+        const { startIndex, endIndex } = entriesToDisplay(this.cursor, this.options.choices.length, this.optionsPerPage);
+        for(let index = startIndex; index < endIndex; index++){
+            // determine whether to display "more choices" indicators
+            let prefix;
+            if (this.cursor === index) {
+                prefix = `${symbol.arrowRight} `;
+            } else if (index === startIndex && startIndex > 0) {
+                prefix = `${symbol.arrowUp} `;
+            } else if (index === endIndex - 1 && endIndex < this.options.choices.length) {
+                prefix = `${symbol.arrowDown} `;
+            } else {
+                prefix = "  ";
+            }
+            const choice_ = this.options.choices[index];
+            assert(choice_, `choices[${index}] is not defined`);
+            let choice = this.options.formatChoice(choice_);
+            if (this.cursor === index) {
+                choice = chalk.blue.underline(choice);
+            }
+            choices += `${prefix}${choice}\n`;
+        }
+        if (this.options.indent) {
+            choices = indentString(choices, this.options.indent);
+        }
+        output.updatePrompt(question + choices);
+    }
+    constructor(text, options){
+        super();
+        _define_property(this, "text", void 0);
+        _define_property(this, "cursor", void 0);
+        _define_property(this, "optionsPerPage", void 0);
+        _define_property(this, "options", void 0);
+        this.text = text;
+        this.cursor = 0;
+        this.optionsPerPage = 10;
+        this.options = defaults(options, {
+            formatChoice: (choice)=>choice,
+            formatSelection: (choice)=>choice,
+            ...options
+        });
+        if (this.options.ensureEmptyLineAbove) {
+            this.text = "\n" + this.text;
+        }
+        this.render();
+    }
+}
+
+//# sourceMappingURL=select.js.map

package/lib/services/output/select.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/services/output/select.ts"],"sourcesContent":["import chalk from \"chalk\";\nimport indentString from \"indent-string\";\nimport assert from \"node:assert\";\nimport process from \"node:process\";\nimport { isString } from \"../util/is.js\";\nimport { defaults } from \"../util/object.js\";\nimport { output } from \"./output.js\";\nimport { println } from \"./print.js\";\nimport { entriesToDisplay, Prompt, type StdinKey } from \"./prompt.js\";\nimport { sprint, sprintln, type SprintOptions } from \"./sprint.js\";\nimport { symbol } from \"./symbols.js\";\n\nexport type SelectOptions<Choice extends string> = SprintOptions & {\n  choices: Choice[];\n  formatChoice?: (choice: Choice) => string;\n  formatSelection?: (choice: Choice) => string;\n};\n\nexport type select<Choice extends string> = (options: SelectOptions<Choice>) => selectWithChoices<Choice>;\n\nexport type selectWithChoices<Choice extends string> = {\n  (str: string): Promise<Choice>;\n  (template: TemplateStringsArray, ...values: unknown[]): Promise<Choice>;\n};\n\n// TODO: i regret this api... don't make it the same as println... just make it take ctx and options\nexport const select = <Choice extends string>(options: SelectOptions<Choice>): selectWithChoices<Choice> => {\n  options = defaults(options, {\n    ensureEmptyLineAbove: true,\n  });\n\n  return ((template: string | TemplateStringsArray, ...values: unknown[]): Promise<Choice> => {\n    let text = template as string;\n    if (!isString(text)) {\n      text = sprint(template as TemplateStringsArray, ...values);\n    }\n\n    if (!output.isInteractive) {\n      // TODO: log an error here\n      println(options)(text);\n      println({ ensureEmptyLineAbove: true })`\n        Aborting because ggt is not running in an interactive terminal.\n      `;\n      process.exit(1);\n    }\n\n    return new Promise((resolve) => {\n      const sel = new Select(text, {\n        formatChoice: (choice) => choice,\n        formatSelection: (choice) => choice,\n        ...options,\n      });\n      sel.on(\"submit\", resolve);\n      sel.on(\"exit\", () => process.exit(0));\n      sel.on(\"abort\", () => process.exit(0));\n    });\n  }) as selectWithChoices<Choice>;\n};\n\n/**\n * Inspired by `prompts`:\n * https://github.com/terkelg/prompts/blob/e0519913ec4fcc6746bb3d97d8cd0960c3f3ffde/lib/elements/select.js\n *\n * MIT License\n *\n * Copyright (c) 2018 Terkel Gjervig Nielsen\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n// TODO: implement autocomplete https://github.com/terkelg/prompts/blob/e0519913ec4fcc6746bb3d97d8cd0960c3f3ffde/lib/elements/autocomplete.js\nclass Select<Choice extends string> extends Prompt {\n  cursor = 0;\n  optionsPerPage = 10;\n  options;\n\n  constructor(\n    readonly text: string,\n    options: SelectOptions<Choice>,\n  ) {\n    super();\n\n    this.options = defaults(options, {\n      formatChoice: (choice) => choice,\n      formatSelection: (choice) => choice,\n      ...options,\n    });\n\n    if (this.options.ensureEmptyLineAbove) {\n      this.text = \"\\n\" + this.text;\n    }\n\n    this.render();\n  }\n\n  get selection(): Choice {\n    const choice = this.options.choices[this.cursor];\n    assert(choice, `choices[${this.cursor}] is not defined`);\n    return choice;\n  }\n\n  moveCursor(n: number): void {\n    this.cursor = n;\n    this.fire();\n  }\n\n  reset(): void {\n    this.moveCursor(0);\n    this.fire();\n    this.render();\n  }\n\n  exit(): void {\n    this.abort();\n  }\n\n  abort(): void {\n    this.done = this.aborted = true;\n    this.fire();\n    this.render(\"Cancel (Ctrl+C)\" as Choice);\n    this.close();\n  }\n\n  submit(): void {\n    this.done = true;\n    this.aborted = false;\n    this.value = this.selection;\n    this.fire();\n    this.render();\n    this.close();\n  }\n\n  first(): void {\n    this.moveCursor(0);\n    this.render();\n  }\n\n  last(): void {\n    this.moveCursor(this.options.choices.length - 1);\n    this.render();\n  }\n\n  up(): void {\n    if (this.cursor === 0) {\n      this.moveCursor(this.options.choices.length - 1);\n    } else {\n      this.moveCursor(this.cursor - 1);\n    }\n    this.render();\n  }\n\n  down(): void {\n    if (this.cursor === this.options.choices.length - 1) {\n      this.moveCursor(0);\n    } else {\n      this.moveCursor(this.cursor + 1);\n    }\n    this.render();\n  }\n\n  next(): void {\n    this.moveCursor((this.cursor + 1) % this.options.choices.length);\n    this.render();\n  }\n\n  override _(char: string, _key: StdinKey): void {\n    if (char === \" \") {\n      this.submit();\n      return;\n    }\n  }\n\n  override render(selection?: Choice): void {\n    if (this.closed) {\n      return;\n    }\n\n    super.render();\n\n    let question = this.text;\n    if (this.done) {\n      output.persistPrompt(sprintln`\n        ${question.trimEnd()} ${this.options.formatChoice(selection ?? this.selection)}\n      `);\n      return;\n    }\n\n    question += ` ${chalk.gray(\"Use arrow keys to move\")}\\n\\n`;\n\n    let choices = \"\";\n    const { startIndex, endIndex } = entriesToDisplay(this.cursor, this.options.choices.length, this.optionsPerPage);\n    for (let index = startIndex; index < endIndex; index++) {\n      // determine whether to display \"more choices\" indicators\n      let prefix: string;\n      if (this.cursor === index) {\n        prefix = `${symbol.arrowRight} `;\n      } else if (index === startIndex && startIndex > 0) {\n        prefix = `${symbol.arrowUp} `;\n      } else if (index === endIndex - 1 && endIndex < this.options.choices.length) {\n        prefix = `${symbol.arrowDown} `;\n      } else {\n        prefix = \"  \";\n      }\n\n      const choice_ = this.options.choices[index];\n      assert(choice_, `choices[${index}] is not defined`);\n\n      let choice = this.options.formatChoice(choice_);\n      if (this.cursor === index) {\n        choice = chalk.blue.underline(choice);\n      }\n\n      choices += `${prefix}${choice}\\n`;\n    }\n\n    if (this.options.indent) {\n      choices = indentString(choices, this.options.indent);\n    }\n\n    output.updatePrompt(question + choices);\n  }\n}\n"],"names":["chalk","indentString","assert","process","isString","defaults","output","println","entriesToDisplay","Prompt","sprint","sprintln","symbol","select","options","ensureEmptyLineAbove","template","values","text","isInteractive","exit","Promise","resolve","sel","Select","formatChoice","choice","formatSelection","on","selection","choices","cursor","moveCursor","n","fire","reset","render","abort","done","aborted","close","submit","value","first","last","length","up","down","next","_","char","_key","closed","question","persistPrompt","trimEnd","gray","startIndex","endIndex","optionsPerPage","index","prefix","arrowRight","arrowUp","arrowDown","choice_","blue","underline","indent","updatePrompt","constructor"],"mappings":"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"}

package/lib/services/output/spinner.js

@@ -0,0 +1,141 @@
+import chalk from "chalk";
+import chalkTemplate from "chalk-template";
+import cliSpinners from "cli-spinners";
+import assert from "node:assert";
+import os from "node:os";
+import { dedent } from "ts-dedent";
+import { isString } from "../util/is.js";
+import { output } from "./output.js";
+import { isSprintOptions, sprintln } from "./sprint.js";
+import { symbol } from "./symbols.js";
+export let activeSpinner;
+export const createSpin = (options)=>{
+    return (optionsOrString, ...values)=>{
+        if (isSprintOptions(optionsOrString)) {
+            return createSpin({
+                ...options,
+                ...optionsOrString
+            });
+        }
+        assert(!activeSpinner, "a spinner is already active");
+        let str = optionsOrString;
+        if (!isString(str)) {
+            str = sprintln(str, ...values);
+        }
+        const { ensureNewLine = true, ensureEmptyLineAbove = false, kind = "dots", color = "white", successSymbol = chalk.green(symbol.tick), failSymbol = chalk.red(symbol.cross) } = options;
+        let frameIndex = 0;
+        const frames = cliSpinners[kind].frames;
+        const interval = cliSpinners[kind].interval;
+        let firstRender = true;
+        const render = ({ symbol, message, final: finalRender = false })=>{
+            // strip leading and trailing newlines so we can add them back in
+            // the right place
+            while(message.startsWith("\n")){
+                message = message.slice(1);
+            }
+            while(message.endsWith("\n")){
+                message = message.slice(0, -1);
+            }
+            // if no symbol is provided, use the next frame
+            if (symbol === undefined) {
+                frameIndex = ++frameIndex % frames.length;
+                symbol = chalk[color](frames[frameIndex]);
+            }
+            if (message) {
+                // we have a message to display
+                if (symbol) {
+                    // add the spinner symbol to the first line of the message
+                    const lines = message.split(/\r?\n/);
+                    lines[0] = `${symbol} ${lines[0]}`;
+                    message = lines.join(os.EOL);
+                }
+                if (ensureEmptyLineAbove && !message.startsWith("\n")) {
+                    // add an empty line before the symbol
+                    message = "\n" + message;
+                }
+                if (ensureNewLine && !message.endsWith("\n")) {
+                    // add a newline after the message
+                    message += "\n";
+                }
+            }
+            if (finalRender) {
+                if (!output.isInteractive && ensureEmptyLineAbove) {
+                    // we're in a non-interactive terminal, therefor
+                    // ensureEmptyLineAbove only applies to the first render.
+                    // strip it so that the final render of the spinner is right
+                    // below the first render of the spinner
+                    message = message.slice(1);
+                }
+                // this is the final render, so persist the spinner
+                output.persistSpinner(message);
+                activeSpinner = undefined;
+                return;
+            }
+            // this is not the final render, so we need to update the spinner
+            if (output.isInteractive) {
+                // we're in an interactive terminal, so update the spinner
+                output.updateSpinner(message);
+            } else if (firstRender) {
+                // we're not in an interactive terminal, and this is the first
+                // render, so just write the first render to stdout
+                output.writeStdout(message);
+                firstRender = false;
+            }
+        };
+        // render the first frame
+        render({
+            message: str
+        });
+        let spinnerInterval;
+        if (output.isInteractive) {
+            // we are in an interactive terminal, so keep rendering the spinner
+            spinnerInterval = setInterval(()=>render({
+                    message: str
+                }), interval);
+        }
+        // setup the last render
+        const finalRender = (renderOptions)=>{
+            render({
+                ...renderOptions,
+                final: true
+            });
+            clearInterval(spinnerInterval);
+        };
+        activeSpinner = {
+            text: str,
+            clear () {
+                this.text = "";
+                finalRender({
+                    symbol: "",
+                    message: ""
+                });
+            },
+            succeed (finalStr, ...values) {
+                finalStr ??= str;
+                if (!isString(finalStr)) {
+                    finalStr = dedent(chalkTemplate(finalStr, ...values));
+                }
+                this.text = finalStr;
+                finalRender({
+                    message: finalStr,
+                    symbol: successSymbol
+                });
+            },
+            fail (finalStr, ...values) {
+                finalStr ??= str;
+                if (!isString(finalStr)) {
+                    finalStr = dedent(chalkTemplate(finalStr, ...values));
+                }
+                this.text = finalStr;
+                finalRender({
+                    message: finalStr,
+                    symbol: failSymbol
+                });
+            }
+        };
+        return activeSpinner;
+    };
+};
+export const spin = createSpin({});
+
+//# sourceMappingURL=spinner.js.map

package/lib/services/output/spinner.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/services/output/spinner.ts"],"sourcesContent":["import type { ColorName } from \"chalk\";\nimport chalk from \"chalk\";\nimport chalkTemplate from \"chalk-template\";\nimport type { SpinnerName } from \"cli-spinners\";\nimport cliSpinners from \"cli-spinners\";\nimport assert from \"node:assert\";\nimport os from \"node:os\";\nimport { dedent } from \"ts-dedent\";\nimport { isString } from \"../util/is.js\";\nimport { output } from \"./output.js\";\nimport { isSprintOptions, sprintln } from \"./sprint.js\";\nimport { symbol } from \"./symbols.js\";\n\nexport type SpinnerOptions = {\n  /**\n   * Whether to ensure a new line is after the text.\n   *\n   * @default false\n   */\n  ensureNewLine?: boolean;\n\n  /**\n   * Whether to ensure an empty line is above the spinner.\n   *\n   * @default false\n   */\n  ensureEmptyLineAbove?: boolean;\n\n  /**\n   * The name of the spinner to use.\n   *\n   * @default \"dots\"\n   * @see https://github.com/sindresorhus/cli-spinners\n   */\n  kind?: SpinnerName;\n\n  /**\n   * The color of the spinner.\n   *\n   * @default \"cyan\"\n   * @see https://github.com/chalk/chalk\n   */\n  color?: ColorName;\n\n  /**\n   * The symbol to display when the spinner succeeds.\n   *\n   * @default \"✔\"\n   */\n  successSymbol?: string;\n\n  /**\n   * The symbol to display when the spinner fails.\n   *\n   * @default \"✖\"\n   */\n  failSymbol?: string;\n};\n\nexport type spin = {\n  (str: string): spinner;\n  (template: TemplateStringsArray, ...values: unknown[]): spinner;\n  (options: Omit<SpinnerOptions, \"str\">): spin;\n};\n\nexport type spinner = {\n  text: string;\n  clear: () => void;\n  succeed: {\n    (str?: string): void;\n    (template: TemplateStringsArray, ...values: unknown[]): void;\n  };\n  fail: {\n    (str?: string): void;\n    (template: TemplateStringsArray, ...values: unknown[]): void;\n  };\n};\n\nexport let activeSpinner: spinner | undefined;\n\nexport const createSpin = (options: SpinnerOptions): spin => {\n  return ((optionsOrString: SpinnerOptions | string | TemplateStringsArray, ...values: unknown[]): spin | spinner => {\n    if (isSprintOptions(optionsOrString)) {\n      return createSpin({ ...options, ...optionsOrString });\n    }\n\n    assert(!activeSpinner, \"a spinner is already active\");\n\n    let str = optionsOrString as string;\n    if (!isString(str)) {\n      str = sprintln(str, ...values);\n    }\n\n    const {\n      ensureNewLine = true,\n      ensureEmptyLineAbove = false,\n      kind = \"dots\",\n      color = \"white\",\n      successSymbol = chalk.green(symbol.tick),\n      failSymbol = chalk.red(symbol.cross),\n    } = options;\n\n    let frameIndex = 0;\n    const frames = cliSpinners[kind].frames;\n    const interval = cliSpinners[kind].interval;\n\n    type RenderOptions = { symbol?: string; message: string; final?: boolean };\n    let firstRender = true;\n\n    const render = ({ symbol, message, final: finalRender = false }: RenderOptions): void => {\n      // strip leading and trailing newlines so we can add them back in\n      // the right place\n      while (message.startsWith(\"\\n\")) {\n        message = message.slice(1);\n      }\n\n      while (message.endsWith(\"\\n\")) {\n        message = message.slice(0, -1);\n      }\n\n      // if no symbol is provided, use the next frame\n      if (symbol === undefined) {\n        frameIndex = ++frameIndex % frames.length;\n        symbol = chalk[color](frames[frameIndex]);\n      }\n\n      if (message) {\n        // we have a message to display\n        if (symbol) {\n          // add the spinner symbol to the first line of the message\n          const lines = message.split(/\\r?\\n/);\n          lines[0] = `${symbol} ${lines[0]}`;\n          message = lines.join(os.EOL);\n        }\n\n        if (ensureEmptyLineAbove && !message.startsWith(\"\\n\")) {\n          // add an empty line before the symbol\n          message = \"\\n\" + message;\n        }\n\n        if (ensureNewLine && !message.endsWith(\"\\n\")) {\n          // add a newline after the message\n          message += \"\\n\";\n        }\n      }\n\n      if (finalRender) {\n        if (!output.isInteractive && ensureEmptyLineAbove) {\n          // we're in a non-interactive terminal, therefor\n          // ensureEmptyLineAbove only applies to the first render.\n          // strip it so that the final render of the spinner is right\n          // below the first render of the spinner\n          message = message.slice(1);\n        }\n\n        // this is the final render, so persist the spinner\n        output.persistSpinner(message);\n        activeSpinner = undefined;\n        return;\n      }\n\n      // this is not the final render, so we need to update the spinner\n      if (output.isInteractive) {\n        // we're in an interactive terminal, so update the spinner\n        output.updateSpinner(message);\n      } else if (firstRender) {\n        // we're not in an interactive terminal, and this is the first\n        // render, so just write the first render to stdout\n        output.writeStdout(message);\n        firstRender = false;\n      }\n    };\n\n    // render the first frame\n    render({ message: str });\n\n    let spinnerInterval: NodeJS.Timeout | undefined;\n    if (output.isInteractive) {\n      // we are in an interactive terminal, so keep rendering the spinner\n      spinnerInterval = setInterval(() => render({ message: str }), interval);\n    }\n\n    // setup the last render\n    const finalRender = (renderOptions: Omit<RenderOptions, \"final\">): void => {\n      render({ ...renderOptions, final: true });\n      clearInterval(spinnerInterval);\n    };\n\n    activeSpinner = {\n      text: str,\n      clear(): void {\n        this.text = \"\";\n        finalRender({ symbol: \"\", message: \"\" });\n      },\n      succeed(finalStr?: string | TemplateStringsArray, ...values: unknown[]): void {\n        finalStr ??= str;\n        if (!isString(finalStr)) {\n          finalStr = dedent(chalkTemplate(finalStr, ...values));\n        }\n        this.text = finalStr;\n        finalRender({ message: finalStr, symbol: successSymbol });\n      },\n      fail(finalStr?: string | TemplateStringsArray, ...values: unknown[]): void {\n        finalStr ??= str;\n        if (!isString(finalStr)) {\n          finalStr = dedent(chalkTemplate(finalStr, ...values));\n        }\n        this.text = finalStr;\n        finalRender({ message: finalStr, symbol: failSymbol });\n      },\n    };\n\n    return activeSpinner;\n  }) as spin;\n};\n\nexport const spin = createSpin({});\n"],"names":["chalk","chalkTemplate","cliSpinners","assert","os","dedent","isString","output","isSprintOptions","sprintln","symbol","activeSpinner","createSpin","options","optionsOrString","values","str","ensureNewLine","ensureEmptyLineAbove","kind","color","successSymbol","green","tick","failSymbol","red","cross","frameIndex","frames","interval","firstRender","render","message","final","finalRender","startsWith","slice","endsWith","undefined","length","lines","split","join","EOL","isInteractive","persistSpinner","updateSpinner","writeStdout","spinnerInterval","setInterval","renderOptions","clearInterval","text","clear","succeed","finalStr","fail","spin"],"mappings":"AACA,OAAOA,WAAW,QAAQ;AAC1B,OAAOC,mBAAmB,iBAAiB;AAE3C,OAAOC,iBAAiB,eAAe;AACvC,OAAOC,YAAY,cAAc;AACjC,OAAOC,QAAQ,UAAU;AACzB,SAASC,MAAM,QAAQ,YAAY;AACnC,SAASC,QAAQ,QAAQ,gBAAgB;AACzC,SAASC,MAAM,QAAQ,cAAc;AACrC,SAASC,eAAe,EAAEC,QAAQ,QAAQ,cAAc;AACxD,SAASC,MAAM,QAAQ,eAAe;AAmEtC,OAAO,IAAIC,cAAmC;AAE9C,OAAO,MAAMC,aAAa,CAACC;IACzB,OAAQ,CAACC,iBAAiE,GAAGC;QAC3E,IAAIP,gBAAgBM,kBAAkB;YACpC,OAAOF,WAAW;gBAAE,GAAGC,OAAO;gBAAE,GAAGC,eAAe;YAAC;QACrD;QAEAX,OAAO,CAACQ,eAAe;QAEvB,IAAIK,MAAMF;QACV,IAAI,CAACR,SAASU,MAAM;YAClBA,MAAMP,SAASO,QAAQD;QACzB;QAEA,MAAM,EACJE,gBAAgB,IAAI,EACpBC,uBAAuB,KAAK,EAC5BC,OAAO,MAAM,EACbC,QAAQ,OAAO,EACfC,gBAAgBrB,MAAMsB,KAAK,CAACZ,OAAOa,IAAI,CAAC,EACxCC,aAAaxB,MAAMyB,GAAG,CAACf,OAAOgB,KAAK,CAAC,EACrC,GAAGb;QAEJ,IAAIc,aAAa;QACjB,MAAMC,SAAS1B,WAAW,CAACiB,KAAK,CAACS,MAAM;QACvC,MAAMC,WAAW3B,WAAW,CAACiB,KAAK,CAACU,QAAQ;QAG3C,IAAIC,cAAc;QAElB,MAAMC,SAAS,CAAC,EAAErB,MAAM,EAAEsB,OAAO,EAAEC,OAAOC,cAAc,KAAK,EAAiB;YAC5E,iEAAiE;YACjE,kBAAkB;YAClB,MAAOF,QAAQG,UAAU,CAAC,MAAO;gBAC/BH,UAAUA,QAAQI,KAAK,CAAC;YAC1B;YAEA,MAAOJ,QAAQK,QAAQ,CAAC,MAAO;gBAC7BL,UAAUA,QAAQI,KAAK,CAAC,GAAG,CAAC;YAC9B;YAEA,+CAA+C;YAC/C,IAAI1B,WAAW4B,WAAW;gBACxBX,aAAa,EAAEA,aAAaC,OAAOW,MAAM;gBACzC7B,SAASV,KAAK,CAACoB,MAAM,CAACQ,MAAM,CAACD,WAAW;YAC1C;YAEA,IAAIK,SAAS;gBACX,+BAA+B;gBAC/B,IAAItB,QAAQ;oBACV,0DAA0D;oBAC1D,MAAM8B,QAAQR,QAAQS,KAAK,CAAC;oBAC5BD,KAAK,CAAC,EAAE,GAAG,CAAC,EAAE9B,OAAO,CAAC,EAAE8B,KAAK,CAAC,EAAE,CAAC,CAAC;oBAClCR,UAAUQ,MAAME,IAAI,CAACtC,GAAGuC,GAAG;gBAC7B;gBAEA,IAAIzB,wBAAwB,CAACc,QAAQG,UAAU,CAAC,OAAO;oBACrD,sCAAsC;oBACtCH,UAAU,OAAOA;gBACnB;gBAEA,IAAIf,iBAAiB,CAACe,QAAQK,QAAQ,CAAC,OAAO;oBAC5C,kCAAkC;oBAClCL,WAAW;gBACb;YACF;YAEA,IAAIE,aAAa;gBACf,IAAI,CAAC3B,OAAOqC,aAAa,IAAI1B,sBAAsB;oBACjD,gDAAgD;oBAChD,yDAAyD;oBACzD,4DAA4D;oBAC5D,wCAAwC;oBACxCc,UAAUA,QAAQI,KAAK,CAAC;gBAC1B;gBAEA,mDAAmD;gBACnD7B,OAAOsC,cAAc,CAACb;gBACtBrB,gBAAgB2B;gBAChB;YACF;YAEA,iEAAiE;YACjE,IAAI/B,OAAOqC,aAAa,EAAE;gBACxB,0DAA0D;gBAC1DrC,OAAOuC,aAAa,CAACd;YACvB,OAAO,IAAIF,aAAa;gBACtB,8DAA8D;gBAC9D,mDAAmD;gBACnDvB,OAAOwC,WAAW,CAACf;gBACnBF,cAAc;YAChB;QACF;QAEA,yBAAyB;QACzBC,OAAO;YAAEC,SAAShB;QAAI;QAEtB,IAAIgC;QACJ,IAAIzC,OAAOqC,aAAa,EAAE;YACxB,mEAAmE;YACnEI,kBAAkBC,YAAY,IAAMlB,OAAO;oBAAEC,SAAShB;gBAAI,IAAIa;QAChE;QAEA,wBAAwB;QACxB,MAAMK,cAAc,CAACgB;YACnBnB,OAAO;gBAAE,GAAGmB,aAAa;gBAAEjB,OAAO;YAAK;YACvCkB,cAAcH;QAChB;QAEArC,gBAAgB;YACdyC,MAAMpC;YACNqC;gBACE,IAAI,CAACD,IAAI,GAAG;gBACZlB,YAAY;oBAAExB,QAAQ;oBAAIsB,SAAS;gBAAG;YACxC;YACAsB,SAAQC,QAAwC,EAAE,GAAGxC,MAAiB;gBACpEwC,aAAavC;gBACb,IAAI,CAACV,SAASiD,WAAW;oBACvBA,WAAWlD,OAAOJ,cAAcsD,aAAaxC;gBAC/C;gBACA,IAAI,CAACqC,IAAI,GAAGG;gBACZrB,YAAY;oBAAEF,SAASuB;oBAAU7C,QAAQW;gBAAc;YACzD;YACAmC,MAAKD,QAAwC,EAAE,GAAGxC,MAAiB;gBACjEwC,aAAavC;gBACb,IAAI,CAACV,SAASiD,WAAW;oBACvBA,WAAWlD,OAAOJ,cAAcsD,aAAaxC;gBAC/C;gBACA,IAAI,CAACqC,IAAI,GAAGG;gBACZrB,YAAY;oBAAEF,SAASuB;oBAAU7C,QAAQc;gBAAW;YACtD;QACF;QAEA,OAAOb;IACT;AACF,EAAE;AAEF,OAAO,MAAM8C,OAAO7C,WAAW,CAAC,GAAG"}

package/lib/services/output/sprint.js

@@ -1,21 +1,44 @@
+import boxen from "boxen";
 import chalkTemplate from "chalk-template";
+import indentString from "indent-string";
 import { dedent } from "ts-dedent";
-import { isString } from "../util/is.js";
-export const sprint = (template, ...values)=>{
-    let content = template;
-    if (!isString(content)) {
-        content = chalkTemplate(content, ...values);
-    }
-    return dedent(content);
+import { isArray, isString } from "../util/is.js";
+export const isSprintOptions = (value)=>{
+    return !isString(value) && !isArray(value);
 };
-export const sprintln = (template, ...values)=>{
-    return sprint(template, ...values) + "\n";
-};
-export const sprintln2 = (template, ...values)=>{
-    return sprintln(template, ...values) + "\n";
-};
-export const sprintlns = (template, ...values)=>{
-    return "\n" + sprintln(template, ...values);
+const createSprint = (options)=>{
+    return (optionsOrString, ...values)=>{
+        if (isSprintOptions(optionsOrString)) {
+            return createSprint({
+                ...options,
+                ...optionsOrString
+            });
+        }
+        const { ensureNewLine = false, ensureEmptyLineAbove = false, indent = 0, boxen: boxenOptions } = options;
+        let str = optionsOrString;
+        if (!isString(str)) {
+            str = dedent(chalkTemplate(str, ...values));
+        }
+        if (ensureEmptyLineAbove && !str.startsWith("\n")) {
+            str = "\n" + str;
+        }
+        if (ensureNewLine && !str.endsWith("\n")) {
+            str += "\n";
+        }
+        if (boxenOptions) {
+            str = boxen(str, boxenOptions);
+        }
+        if (indent > 0) {
+            str = indentString(str, indent);
+        }
+        return str;
+    };
 };
+export const sprint = createSprint({
+    ensureNewLine: false
+});
+export const sprintln = createSprint({
+    ensureNewLine: true
+});
 
 //# sourceMappingURL=sprint.js.map

package/lib/services/output/sprint.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/services/output/sprint.ts"],"sourcesContent":["import chalkTemplate from \"chalk-template\";\nimport { dedent } from \"ts-dedent\";\nimport { isString } from \"../util/is.js\";\n\nexport type Sprint = (template: TemplateStringsArray | string, ...values: unknown[]) => string;\n\nexport const sprint: Sprint = (template, ...values) => {\n  let content = template;\n  if (!isString(content)) {\n    content = chalkTemplate(content, ...values);\n  }\n  return dedent(content);\n};\n\nexport const sprintln: Sprint = (template, ...values) => {\n  return sprint(template, ...values) + \"\\n\";\n};\n\nexport const sprintln2: Sprint = (template, ...values) => {\n  return sprintln(template, ...values) + \"\\n\";\n};\n\nexport const sprintlns: Sprint = (template, ...values) => {\n  return \"\\n\" + sprintln(template, ...values);\n};\n"],"names":["chalkTemplate","dedent","isString","sprint","template","values","content","sprintln","sprintln2","sprintlns"],"mappings":"AAAA,OAAOA,mBAAmB,iBAAiB;AAC3C,SAASC,MAAM,QAAQ,YAAY;AACnC,SAASC,QAAQ,QAAQ,gBAAgB;AAIzC,OAAO,MAAMC,SAAiB,CAACC,UAAU,GAAGC;IAC1C,IAAIC,UAAUF;IACd,IAAI,CAACF,SAASI,UAAU;QACtBA,UAAUN,cAAcM,YAAYD;IACtC;IACA,OAAOJ,OAAOK;AAChB,EAAE;AAEF,OAAO,MAAMC,WAAmB,CAACH,UAAU,GAAGC;IAC5C,OAAOF,OAAOC,aAAaC,UAAU;AACvC,EAAE;AAEF,OAAO,MAAMG,YAAoB,CAACJ,UAAU,GAAGC;IAC7C,OAAOE,SAASH,aAAaC,UAAU;AACzC,EAAE;AAEF,OAAO,MAAMI,YAAoB,CAACL,UAAU,GAAGC;IAC7C,OAAO,OAAOE,SAASH,aAAaC;AACtC,EAAE"}
+{"version":3,"sources":["../../../src/services/output/sprint.ts"],"sourcesContent":["import type { Options as BoxenOptions } from \"boxen\";\nimport boxen from \"boxen\";\nimport chalkTemplate from \"chalk-template\";\nimport indentString from \"indent-string\";\nimport { dedent } from \"ts-dedent\";\nimport { isArray, isString } from \"../util/is.js\";\n\nexport type SprintOptions = {\n  /**\n   * Whether to ensure a new line is after the content.\n   *\n   * @default true\n   */\n  ensureNewLine?: boolean;\n\n  /**\n   * Whether to ensure an empty line is above the content.\n   *\n   * @default false\n   */\n  ensureEmptyLineAbove?: boolean;\n\n  /**\n   * The number of spaces to indent the text.\n   *\n   * @default 0\n   */\n  indent?: number;\n\n  /**\n   * Whether to wrap the text in a box.\n   *\n   * @default undefined (no box)\n   */\n  boxen?: BoxenOptions;\n};\n\nexport type sprint = {\n  (str: string): string;\n  (template: TemplateStringsArray, ...values: unknown[]): string;\n  (options: SprintOptions): sprint;\n};\n\nexport const isSprintOptions = <const T extends SprintOptions>(value: string | TemplateStringsArray | SprintOptions): value is T => {\n  return !isString(value) && !isArray(value);\n};\n\nconst createSprint = (options: SprintOptions): sprint => {\n  return ((optionsOrString: SprintOptions | string | TemplateStringsArray, ...values: unknown[]): sprint | string => {\n    if (isSprintOptions(optionsOrString)) {\n      return createSprint({ ...options, ...optionsOrString });\n    }\n\n    const { ensureNewLine = false, ensureEmptyLineAbove = false, indent = 0, boxen: boxenOptions } = options;\n\n    let str = optionsOrString as string;\n    if (!isString(str)) {\n      str = dedent(chalkTemplate(str, ...values));\n    }\n\n    if (ensureEmptyLineAbove && !str.startsWith(\"\\n\")) {\n      str = \"\\n\" + str;\n    }\n\n    if (ensureNewLine && !str.endsWith(\"\\n\")) {\n      str += \"\\n\";\n    }\n\n    if (boxenOptions) {\n      str = boxen(str, boxenOptions);\n    }\n\n    if (indent > 0) {\n      str = indentString(str, indent);\n    }\n\n    return str;\n  }) as sprint;\n};\n\nexport const sprint = createSprint({ ensureNewLine: false });\nexport const sprintln = createSprint({ ensureNewLine: true });\n"],"names":["boxen","chalkTemplate","indentString","dedent","isArray","isString","isSprintOptions","value","createSprint","options","optionsOrString","values","ensureNewLine","ensureEmptyLineAbove","indent","boxenOptions","str","startsWith","endsWith","sprint","sprintln"],"mappings":"AACA,OAAOA,WAAW,QAAQ;AAC1B,OAAOC,mBAAmB,iBAAiB;AAC3C,OAAOC,kBAAkB,gBAAgB;AACzC,SAASC,MAAM,QAAQ,YAAY;AACnC,SAASC,OAAO,EAAEC,QAAQ,QAAQ,gBAAgB;AAsClD,OAAO,MAAMC,kBAAkB,CAAgCC;IAC7D,OAAO,CAACF,SAASE,UAAU,CAACH,QAAQG;AACtC,EAAE;AAEF,MAAMC,eAAe,CAACC;IACpB,OAAQ,CAACC,iBAAgE,GAAGC;QAC1E,IAAIL,gBAAgBI,kBAAkB;YACpC,OAAOF,aAAa;gBAAE,GAAGC,OAAO;gBAAE,GAAGC,eAAe;YAAC;QACvD;QAEA,MAAM,EAAEE,gBAAgB,KAAK,EAAEC,uBAAuB,KAAK,EAAEC,SAAS,CAAC,EAAEd,OAAOe,YAAY,EAAE,GAAGN;QAEjG,IAAIO,MAAMN;QACV,IAAI,CAACL,SAASW,MAAM;YAClBA,MAAMb,OAAOF,cAAce,QAAQL;QACrC;QAEA,IAAIE,wBAAwB,CAACG,IAAIC,UAAU,CAAC,OAAO;YACjDD,MAAM,OAAOA;QACf;QAEA,IAAIJ,iBAAiB,CAACI,IAAIE,QAAQ,CAAC,OAAO;YACxCF,OAAO;QACT;QAEA,IAAID,cAAc;YAChBC,MAAMhB,MAAMgB,KAAKD;QACnB;QAEA,IAAID,SAAS,GAAG;YACdE,MAAMd,aAAac,KAAKF;QAC1B;QAEA,OAAOE;IACT;AACF;AAEA,OAAO,MAAMG,SAASX,aAAa;IAAEI,eAAe;AAAM,GAAG;AAC7D,OAAO,MAAMQ,WAAWZ,aAAa;IAAEI,eAAe;AAAK,GAAG"}

package/lib/services/output/symbols.js

@@ -0,0 +1,23 @@
+// eslint-disable-next-line no-restricted-imports -- this is the only place we're allowed to import figures
+import figures, { mainSymbols } from "figures";
+import isUnicodeSupported from "is-unicode-supported";
+import { config } from "../config/config.js";
+import { env } from "../config/env.js";
+// we always use main symbols in tests rather than figures so that our
+// tests are consistent across platforms (particularly Windows)
+export const symbol = {
+    ...env.testLike ? mainSymbols : figures
+};
+if (isUnicodeSupported() && config.windowsOrWsl) {
+    // when unicode is supported and we're on windows or wsl, these
+    // symbols end up rendering over two cells while only taking up one,
+    // so we add an extra space to each of them to make them take up two
+    for (const name of [
+        "tick",
+        "cross"
+    ]){
+        symbol[name] += " ";
+    }
+}
+
+//# sourceMappingURL=symbols.js.map

package/lib/services/output/symbols.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/services/output/symbols.ts"],"sourcesContent":["// eslint-disable-next-line no-restricted-imports -- this is the only place we're allowed to import figures\nimport figures, { mainSymbols } from \"figures\";\nimport isUnicodeSupported from \"is-unicode-supported\";\nimport { config } from \"../config/config.js\";\nimport { env } from \"../config/env.js\";\n\n// we always use main symbols in tests rather than figures so that our\n// tests are consistent across platforms (particularly Windows)\nexport const symbol = { ...(env.testLike ? mainSymbols : figures) };\n\nif (isUnicodeSupported() && config.windowsOrWsl) {\n  // when unicode is supported and we're on windows or wsl, these\n  // symbols end up rendering over two cells while only taking up one,\n  // so we add an extra space to each of them to make them take up two\n  for (const name of [\"tick\", \"cross\"] as const) {\n    symbol[name] += \" \";\n  }\n}\n"],"names":["figures","mainSymbols","isUnicodeSupported","config","env","symbol","testLike","windowsOrWsl","name"],"mappings":"AAAA,2GAA2G;AAC3G,OAAOA,WAAWC,WAAW,QAAQ,UAAU;AAC/C,OAAOC,wBAAwB,uBAAuB;AACtD,SAASC,MAAM,QAAQ,sBAAsB;AAC7C,SAASC,GAAG,QAAQ,mBAAmB;AAEvC,sEAAsE;AACtE,+DAA+D;AAC/D,OAAO,MAAMC,SAAS;IAAE,GAAID,IAAIE,QAAQ,GAAGL,cAAcD,OAAO;AAAE,EAAE;AAEpE,IAAIE,wBAAwBC,OAAOI,YAAY,EAAE;IAC/C,+DAA+D;IAC/D,oEAAoE;IACpE,oEAAoE;IACpE,KAAK,MAAMC,QAAQ;QAAC;QAAQ;KAAQ,CAAW;QAC7CH,MAAM,CAACG,KAAK,IAAI;IAClB;AACF"}

package/lib/services/output/table.js

@@ -0,0 +1,98 @@
+import CliTable3 from "cli-table3";
+import indentString from "indent-string";
+import { dedent } from "ts-dedent";
+import { println } from "./print.js";
+import { sprintln } from "./sprint.js";
+export const sprintTable = ({ title, headers, rows, footer, ensureEmptyLineAboveBody = false, ensureEmptyLineAboveFooter = false, borders: borderType = "none", colAligns = [], colWidths = [], indent, ...printOptions })=>{
+    const table = new CliTable3({
+        chars: borders[borderType],
+        colAligns,
+        colWidths,
+        head: headers,
+        style: {
+            head: [],
+            border: []
+        }
+    });
+    table.push(...rows);
+    let text = table.toString() + "\n";
+    if (borderType === "none") {
+        // remove the left padding
+        text = dedent(text).slice(1);
+    }
+    // remove the right padding
+    text = text.split("\n").map((line)=>line.trimEnd()).join("\n");
+    if (indent) {
+        text = indentString(text, indent);
+    }
+    if (title) {
+        text = sprintln(title) + sprintln({
+            ensureEmptyLineAbove: ensureEmptyLineAboveBody
+        })(text);
+    }
+    if (footer) {
+        text = sprintln(text) + sprintln({
+            ensureEmptyLineAbove: ensureEmptyLineAboveFooter
+        })(footer);
+    }
+    return sprintln(printOptions)(text);
+};
+export const printTable = (options)=>{
+    println(options)(sprintTable(options));
+};
+// prettier-ignore
+const borders = {
+    none: {
+        "top-left": "",
+        top: "",
+        "top-mid": "",
+        "top-right": "",
+        "left-mid": "",
+        mid: "",
+        "mid-mid": "",
+        "right-mid": "",
+        left: "",
+        middle: "",
+        right: "",
+        "bottom-left": "",
+        bottom: "",
+        "bottom-mid": "",
+        "bottom-right": ""
+    },
+    thin: {
+        "top-left": "┌",
+        top: "─",
+        "top-mid": "┬",
+        "top-right": "┐",
+        "left-mid": "├",
+        mid: "─",
+        "mid-mid": "┼",
+        "right-mid": "┤",
+        left: "│",
+        middle: "│",
+        right: "│",
+        "bottom-left": "└",
+        bottom: "─",
+        "bottom-mid": "┴",
+        "bottom-right": "┘"
+    },
+    thick: {
+        "top-left": "╔",
+        top: "═",
+        "top-mid": "╤",
+        "top-right": "╗",
+        left: "║",
+        middle: "│",
+        right: "║",
+        "left-mid": "╟",
+        mid: "─",
+        "mid-mid": "┼",
+        "right-mid": "╢",
+        "bottom-left": "╚",
+        bottom: "═",
+        "bottom-mid": "╧",
+        "bottom-right": "╝"
+    }
+};
+
+//# sourceMappingURL=table.js.map

package/lib/services/output/table.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/services/output/table.ts"],"sourcesContent":["import CliTable3 from \"cli-table3\";\nimport indentString from \"indent-string\";\nimport { dedent } from \"ts-dedent\";\nimport { println, type PrintOptions } from \"./print.js\";\nimport { sprintln, type SprintOptions } from \"./sprint.js\";\n\nexport type SprintTableOptions = SprintOptions & {\n  /**\n   * The text to print above the table.\n   */\n  title?: string;\n\n  /**\n   * The headers of the table.\n   */\n  headers?: string[];\n\n  /**\n   * The rows of the table.\n   */\n  rows: string[][];\n\n  /**\n   * The text to print below the table.\n   */\n  footer?: string;\n\n  /**\n   * Whether to add an empty line above the body of the table.\n   *\n   * @default false\n   */\n  ensureEmptyLineAboveBody?: boolean;\n\n  /**\n   * Whether to add an empty line above the footer of the table.\n   *\n   * @default false\n   */\n  ensureEmptyLineAboveFooter?: boolean;\n\n  /**\n   * The type of borders to use.\n   *\n   * @default \"none\"\n   */\n  borders?: \"none\" | \"thin\" | \"thick\";\n\n  /**\n   * The alignment of the content in each column.\n   *\n   * @default [] (left-aligned)\n   */\n  colAligns?: (\"left\" | \"center\" | \"right\")[];\n\n  /**\n   * The width of each column.\n   *\n   * @default [] (auto-sized)\n   */\n  colWidths?: number[];\n};\n\nexport const sprintTable = ({\n  title,\n  headers,\n  rows,\n  footer,\n  ensureEmptyLineAboveBody = false,\n  ensureEmptyLineAboveFooter = false,\n  borders: borderType = \"none\",\n  colAligns = [],\n  colWidths = [],\n  indent,\n  ...printOptions\n}: SprintTableOptions): string => {\n  const table = new CliTable3({\n    chars: borders[borderType],\n    colAligns,\n    colWidths,\n    head: headers,\n    style: { head: [], border: [] },\n  });\n\n  table.push(...rows);\n\n  let text = table.toString() + \"\\n\";\n  if (borderType === \"none\") {\n    // remove the left padding\n    text = dedent(text).slice(1);\n  }\n\n  // remove the right padding\n  text = text\n    .split(\"\\n\")\n    .map((line) => line.trimEnd())\n    .join(\"\\n\");\n\n  if (indent) {\n    text = indentString(text, indent);\n  }\n\n  if (title) {\n    text = sprintln(title) + sprintln({ ensureEmptyLineAbove: ensureEmptyLineAboveBody })(text);\n  }\n\n  if (footer) {\n    text = sprintln(text) + sprintln({ ensureEmptyLineAbove: ensureEmptyLineAboveFooter })(footer);\n  }\n\n  return sprintln(printOptions)(text);\n};\n\nexport type PrintTableOptions = PrintOptions & SprintTableOptions;\n\nexport const printTable = (options: PrintTableOptions): void => {\n  println(options)(sprintTable(options));\n};\n\n// prettier-ignore\nconst borders = {\n    none: {\n      \"top-left\": \"\", top: \"\", \"top-mid\": \"\", \"top-right\": \"\",\n      \"left-mid\": \"\", mid: \"\", \"mid-mid\": \"\", \"right-mid\": \"\",\n      left: \"\", middle: \"\", right: \"\",\n      \"bottom-left\": \"\", bottom: \"\", \"bottom-mid\": \"\", \"bottom-right\": \"\",\n    },\n    thin: {\n      \"top-left\": \"┌\", top: \"─\", \"top-mid\": \"┬\", \"top-right\": \"┐\",\n      \"left-mid\": \"├\", mid: \"─\", \"mid-mid\": \"┼\", \"right-mid\": \"┤\",\n      left: \"│\", middle: \"│\", right: \"│\",\n      \"bottom-left\": \"└\", bottom: \"─\", \"bottom-mid\": \"┴\", \"bottom-right\": \"┘\",\n    },\n    thick: {\n      \"top-left\": \"╔\", top: \"═\", \"top-mid\": \"╤\", \"top-right\": \"╗\",\n      left: \"║\", middle: \"│\", right: \"║\",\n      \"left-mid\": \"╟\", mid: \"─\", \"mid-mid\": \"┼\", \"right-mid\": \"╢\",\n      \"bottom-left\": \"╚\", bottom: \"═\", \"bottom-mid\": \"╧\", \"bottom-right\": \"╝\",\n    },\n  };\n"],"names":["CliTable3","indentString","dedent","println","sprintln","sprintTable","title","headers","rows","footer","ensureEmptyLineAboveBody","ensureEmptyLineAboveFooter","borders","borderType","colAligns","colWidths","indent","printOptions","table","chars","head","style","border","push","text","toString","slice","split","map","line","trimEnd","join","ensureEmptyLineAbove","printTable","options","none","top","mid","left","middle","right","bottom","thin","thick"],"mappings":"AAAA,OAAOA,eAAe,aAAa;AACnC,OAAOC,kBAAkB,gBAAgB;AACzC,SAASC,MAAM,QAAQ,YAAY;AACnC,SAASC,OAAO,QAA2B,aAAa;AACxD,SAASC,QAAQ,QAA4B,cAAc;AA2D3D,OAAO,MAAMC,cAAc,CAAC,EAC1BC,KAAK,EACLC,OAAO,EACPC,IAAI,EACJC,MAAM,EACNC,2BAA2B,KAAK,EAChCC,6BAA6B,KAAK,EAClCC,SAASC,aAAa,MAAM,EAC5BC,YAAY,EAAE,EACdC,YAAY,EAAE,EACdC,MAAM,EACN,GAAGC,cACgB;IACnB,MAAMC,QAAQ,IAAIlB,UAAU;QAC1BmB,OAAOP,OAAO,CAACC,WAAW;QAC1BC;QACAC;QACAK,MAAMb;QACNc,OAAO;YAAED,MAAM,EAAE;YAAEE,QAAQ,EAAE;QAAC;IAChC;IAEAJ,MAAMK,IAAI,IAAIf;IAEd,IAAIgB,OAAON,MAAMO,QAAQ,KAAK;IAC9B,IAAIZ,eAAe,QAAQ;QACzB,0BAA0B;QAC1BW,OAAOtB,OAAOsB,MAAME,KAAK,CAAC;IAC5B;IAEA,2BAA2B;IAC3BF,OAAOA,KACJG,KAAK,CAAC,MACNC,GAAG,CAAC,CAACC,OAASA,KAAKC,OAAO,IAC1BC,IAAI,CAAC;IAER,IAAIf,QAAQ;QACVQ,OAAOvB,aAAauB,MAAMR;IAC5B;IAEA,IAAIV,OAAO;QACTkB,OAAOpB,SAASE,SAASF,SAAS;YAAE4B,sBAAsBtB;QAAyB,GAAGc;IACxF;IAEA,IAAIf,QAAQ;QACVe,OAAOpB,SAASoB,QAAQpB,SAAS;YAAE4B,sBAAsBrB;QAA2B,GAAGF;IACzF;IAEA,OAAOL,SAASa,cAAcO;AAChC,EAAE;AAIF,OAAO,MAAMS,aAAa,CAACC;IACzB/B,QAAQ+B,SAAS7B,YAAY6B;AAC/B,EAAE;AAEF,kBAAkB;AAClB,MAAMtB,UAAU;IACZuB,MAAM;QACJ,YAAY;QAAIC,KAAK;QAAI,WAAW;QAAI,aAAa;QACrD,YAAY;QAAIC,KAAK;QAAI,WAAW;QAAI,aAAa;QACrDC,MAAM;QAAIC,QAAQ;QAAIC,OAAO;QAC7B,eAAe;QAAIC,QAAQ;QAAI,cAAc;QAAI,gBAAgB;IACnE;IACAC,MAAM;QACJ,YAAY;QAAKN,KAAK;QAAK,WAAW;QAAK,aAAa;QACxD,YAAY;QAAKC,KAAK;QAAK,WAAW;QAAK,aAAa;QACxDC,MAAM;QAAKC,QAAQ;QAAKC,OAAO;QAC/B,eAAe;QAAKC,QAAQ;QAAK,cAAc;QAAK,gBAAgB;IACtE;IACAE,OAAO;QACL,YAAY;QAAKP,KAAK;QAAK,WAAW;QAAK,aAAa;QACxDE,MAAM;QAAKC,QAAQ;QAAKC,OAAO;QAC/B,YAAY;QAAKH,KAAK;QAAK,WAAW;QAAK,aAAa;QACxD,eAAe;QAAKI,QAAQ;QAAK,cAAc;QAAK,gBAAgB;IACtE;AACF"}

package/lib/services/output/timestamp.js

@@ -0,0 +1,12 @@
+import chalk from "chalk";
+import dayjs from "dayjs";
+import { env } from "../config/env.js";
+import { parseBoolean } from "../util/boolean.js";
+export const ts = ()=>{
+    if (!env.testLike && parseBoolean(process.env["CI"])) {
+        return new Date().toISOString();
+    }
+    return chalk.gray(dayjs().format("hh:mm:ss A"));
+};
+
+//# sourceMappingURL=timestamp.js.map

package/lib/services/output/timestamp.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/services/output/timestamp.ts"],"sourcesContent":["import chalk from \"chalk\";\nimport dayjs from \"dayjs\";\nimport { env } from \"../config/env.js\";\nimport { parseBoolean } from \"../util/boolean.js\";\n\nexport const ts = (): string => {\n  if (!env.testLike && parseBoolean(process.env[\"CI\"])) {\n    return new Date().toISOString();\n  }\n  return chalk.gray(dayjs().format(\"hh:mm:ss A\"));\n};\n"],"names":["chalk","dayjs","env","parseBoolean","ts","testLike","process","Date","toISOString","gray","format"],"mappings":"AAAA,OAAOA,WAAW,QAAQ;AAC1B,OAAOC,WAAW,QAAQ;AAC1B,SAASC,GAAG,QAAQ,mBAAmB;AACvC,SAASC,YAAY,QAAQ,qBAAqB;AAElD,OAAO,MAAMC,KAAK;IAChB,IAAI,CAACF,IAAIG,QAAQ,IAAIF,aAAaG,QAAQJ,GAAG,CAAC,KAAK,GAAG;QACpD,OAAO,IAAIK,OAAOC,WAAW;IAC/B;IACA,OAAOR,MAAMS,IAAI,CAACR,QAAQS,MAAM,CAAC;AACnC,EAAE"}