@antelopejs/core 1.10.2 → 1.11.0

package/dist/core/cli/output/tasks.js

@@ -0,0 +1,310 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.terminalDisplay = exports.TerminalDisplay = exports.TaskList = void 0;
+exports.getProcessTasks = getProcessTasks;
+exports.getProcessUi = getProcessUi;
+exports.getProcessPalette = getProcessPalette;
+exports.runTask = runTask;
+const capabilities_1 = require("./capabilities");
+const logging_utils_1 = require("../logging-utils");
+const symbols_1 = require("./symbols");
+const format_1 = require("./format");
+const ui_1 = require("./ui");
+const FRAME_INTERVAL_MS = 80;
+const DURATION_THRESHOLD_MS = 1000;
+const DEFAULT_COLUMNS = 80;
+const FRAME_WIDTH = 2;
+const LINE_END = "\n";
+const ELLIPSIS = "…";
+const ERASE_BELOW = "\x1b[J";
+const WRITE_PROPERTY = "write";
+function cursorUp(lines) {
+    return `\x1b[${lines}A\r`;
+}
+function truncate(text, width) {
+    if ((0, format_1.visibleWidth)(text) <= width) {
+        return text;
+    }
+    return `${(0, logging_utils_1.stripAnsi)(text).slice(0, Math.max(0, width - 1))}${ELLIPSIS}`;
+}
+const SILENT_TASK = {
+    update: () => undefined,
+    succeed: () => undefined,
+    warn: () => undefined,
+    skip: () => undefined,
+    fail: () => undefined,
+    dismiss: () => undefined,
+};
+class GuardedStream {
+    target;
+    tasks;
+    constructor(target, tasks) {
+        this.target = target;
+        this.tasks = tasks;
+    }
+    write(chunk) {
+        this.tasks.write(this.target, chunk);
+        return true;
+    }
+}
+class TaskList {
+    ui;
+    running = new Set();
+    captured = new Map();
+    targets;
+    feedback;
+    palette;
+    frames;
+    isLive;
+    now;
+    drawnLineCount = 0;
+    frameIndex = 0;
+    timer;
+    silent = false;
+    hasOpenLine = false;
+    constructor(options = {}) {
+        const streams = options.streams ?? (0, capabilities_1.processStreams)();
+        const context = { ...(0, capabilities_1.processCapabilityContext)(), streams };
+        const capabilities = options.capabilities ?? (0, capabilities_1.detectCapabilities)(context);
+        this.feedback = streams.feedback;
+        this.targets = [streams.result, streams.feedback];
+        this.isLive = options.isLive ?? (0, capabilities_1.hasLiveProgress)(context);
+        this.now = options.now ?? Date.now;
+        this.palette = (0, format_1.createPalette)(capabilities.colors.feedback);
+        this.frames = (0, symbols_1.selectSymbols)(capabilities.hasUnicode).spinner;
+        this.ui = (0, ui_1.createUi)({
+            capabilities,
+            streams: {
+                result: new GuardedStream(streams.result, this),
+                feedback: new GuardedStream(streams.feedback, this),
+            },
+        });
+    }
+    start(label) {
+        if (this.silent) {
+            return SILENT_TASK;
+        }
+        const task = { label, startedAt: this.now() };
+        this.running.add(task);
+        this.refresh();
+        return {
+            update: (text) => this.relabel(task, text),
+            succeed: (text) => this.finish(task, "success", text),
+            warn: (text) => this.finish(task, "warn", text),
+            skip: (text) => this.finish(task, "skip", text),
+            fail: (text) => this.finish(task, "error", text),
+            dismiss: () => this.remove(task),
+        };
+    }
+    async run(label, work, labels) {
+        const task = this.start(label);
+        try {
+            const result = await work(task);
+            const { done } = labels;
+            task.succeed(typeof done === "function" ? done(result) : done);
+            return result;
+        }
+        catch (error) {
+            if (labels.failed) {
+                task.fail(labels.failed);
+            }
+            else {
+                task.dismiss();
+            }
+            throw error;
+        }
+    }
+    write(target, chunk, ...rest) {
+        this.erase();
+        this.writeRaw(target, chunk, ...rest);
+        this.hasOpenLine = !String(chunk).endsWith(LINE_END);
+        this.draw();
+    }
+    message(level, text, options) {
+        if (!this.silent) {
+            this.ui.message(level, text, options);
+        }
+    }
+    setSilent(silent) {
+        this.silent = silent;
+        if (silent) {
+            this.running.clear();
+            this.refresh();
+        }
+    }
+    isSilent() {
+        return this.silent;
+    }
+    hasRunningTasks() {
+        return this.running.size > 0;
+    }
+    clearLiveLines() {
+        this.erase();
+    }
+    relabel(task, label) {
+        task.label = label;
+        this.refresh();
+    }
+    finish(task, outcome, label) {
+        if (!this.running.delete(task)) {
+            return;
+        }
+        const text = label ?? task.label;
+        this.ui.message(outcome, `${text}${this.elapsed(task)}`);
+        this.syncTimer();
+    }
+    remove(task) {
+        if (this.running.delete(task)) {
+            this.refresh();
+        }
+    }
+    elapsed(task) {
+        const duration = this.now() - task.startedAt;
+        if (duration < DURATION_THRESHOLD_MS) {
+            return "";
+        }
+        return ` ${this.palette.dim((0, format_1.formatDuration)(duration))}`;
+    }
+    refresh() {
+        this.erase();
+        this.draw();
+        this.syncTimer();
+    }
+    syncTimer() {
+        const shouldAnimate = this.isLive && this.running.size > 0;
+        if (shouldAnimate && !this.timer) {
+            this.captureWrites();
+            this.timer = setInterval(() => this.tick(), FRAME_INTERVAL_MS);
+            this.timer.unref();
+        }
+        if (!shouldAnimate && this.timer) {
+            clearInterval(this.timer);
+            this.timer = undefined;
+            this.releaseWrites();
+        }
+    }
+    captureWrites() {
+        this.targets.forEach((target) => {
+            if (this.captured.has(target)) {
+                return;
+            }
+            this.captured.set(target, {
+                write: target.write.bind(target),
+                descriptor: Object.getOwnPropertyDescriptor(target, WRITE_PROPERTY),
+            });
+            target.write = (chunk, ...rest) => {
+                this.write(target, chunk, ...rest);
+                return true;
+            };
+        });
+    }
+    releaseWrites() {
+        this.captured.forEach(({ descriptor }, target) => {
+            if (descriptor) {
+                Object.defineProperty(target, WRITE_PROPERTY, descriptor);
+            }
+            else {
+                Reflect.deleteProperty(target, WRITE_PROPERTY);
+            }
+        });
+        this.captured.clear();
+    }
+    writeRaw(target, chunk, ...rest) {
+        const captured = this.captured.get(target);
+        if (captured) {
+            captured.write(chunk, ...rest);
+            return;
+        }
+        target.write(chunk, ...rest);
+    }
+    tick() {
+        this.frameIndex = (this.frameIndex + 1) % this.frames.length;
+        this.erase();
+        this.draw();
+    }
+    draw() {
+        if (!this.isLive || this.hasOpenLine || this.running.size === 0) {
+            return;
+        }
+        const width = (this.feedback.columns ?? DEFAULT_COLUMNS) - FRAME_WIDTH;
+        const frame = this.palette.cyan(this.frames[this.frameIndex]);
+        const lines = [...this.running].map((task) => `${frame} ${truncate(task.label, width - 1)}`);
+        this.writeRaw(this.feedback, `${lines.join(LINE_END)}${LINE_END}`);
+        this.drawnLineCount = lines.length;
+    }
+    erase() {
+        if (this.drawnLineCount === 0) {
+            return;
+        }
+        this.writeRaw(this.feedback, `${cursorUp(this.drawnLineCount)}${ERASE_BELOW}`);
+        this.drawnLineCount = 0;
+    }
+}
+exports.TaskList = TaskList;
+class TerminalDisplay {
+    tasks;
+    started = [];
+    constructor(tasks = getProcessTasks) {
+        this.tasks = tasks;
+    }
+    setSilent(silent) {
+        this.tasks().setSilent(silent);
+        if (silent) {
+            this.started.length = 0;
+        }
+    }
+    isSilent() {
+        return this.tasks().isSilent();
+    }
+    log(message, stream = process.stdout) {
+        this.tasks().write(stream, `${message}${LINE_END}`);
+    }
+    cleanSpinner() {
+        this.started.splice(0).forEach((task) => task.dismiss());
+        return Promise.resolve();
+    }
+    startSpinner(text) {
+        if (!this.isSilent()) {
+            this.started.push(this.tasks().start(text));
+        }
+        return Promise.resolve();
+    }
+    stopSpinner(text) {
+        const task = this.started.pop();
+        if (text) {
+            task?.succeed(text);
+        }
+        else {
+            task?.dismiss();
+        }
+        return Promise.resolve();
+    }
+    failSpinner(text) {
+        this.started.pop()?.fail(text);
+        return Promise.resolve();
+    }
+    isSpinnerActive() {
+        return this.started.length > 0;
+    }
+    clearSpinnerLine() {
+        this.tasks().clearLiveLines();
+        return Promise.resolve();
+    }
+}
+exports.TerminalDisplay = TerminalDisplay;
+let processTasks;
+function getProcessTasks() {
+    processTasks ??= new TaskList();
+    return processTasks;
+}
+function getProcessUi() {
+    return getProcessTasks().ui;
+}
+function getProcessPalette(channel) {
+    return getProcessUi().palette(channel);
+}
+function runTask(label, work, labels) {
+    return getProcessTasks().run(label, work, labels);
+}
+exports.terminalDisplay = new TerminalDisplay();
+//# sourceMappingURL=tasks.js.map

package/dist/core/cli/output/tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../../../src/core/cli/output/tasks.ts"],"names":[],"mappings":";;;AAkZA,0CAGC;AAMD,oCAEC;AAGD,8CAEC;AAGD,0BAMC;AA3aD,iDAKwB;AACxB,oDAA6C;AAC7C,uCAA0C;AAC1C,qCAAuE;AACvE,6BAAgC;AA2BhC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAC7B,MAAM,qBAAqB,GAAG,IAAI,CAAC;AACnC,MAAM,eAAe,GAAG,EAAE,CAAC;AAC3B,MAAM,WAAW,GAAG,CAAC,CAAC;AACtB,MAAM,QAAQ,GAAG,IAAI,CAAC;AACtB,MAAM,QAAQ,GAAG,GAAG,CAAC;AACrB,MAAM,WAAW,GAAG,QAAQ,CAAC;AAC7B,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B,SAAS,QAAQ,CAAC,KAAa;IAC7B,OAAO,QAAQ,KAAK,KAAK,CAAC;AAC5B,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,KAAa;IAC3C,IAAI,IAAA,qBAAY,EAAC,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,GAAG,IAAA,yBAAS,EAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,QAAQ,EAAE,CAAC;AAC1E,CAAC;AAED,MAAM,WAAW,GAAe;IAC9B,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS;IACvB,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;IACxB,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS;IACrB,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS;IACrB,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS;IACrB,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;CACzB,CAAC;AAEF,MAAM,aAAa;IAEE;IACA;IAFnB,YACmB,MAAoB,EACpB,KAAe;QADf,WAAM,GAAN,MAAM,CAAc;QACpB,UAAK,GAAL,KAAK,CAAU;IAC/B,CAAC;IAEJ,KAAK,CAAC,KAAa;QACjB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAUD,MAAa,QAAQ;IACV,EAAE,CAAK;IACC,OAAO,GAAG,IAAI,GAAG,EAAe,CAAC;IACjC,QAAQ,GAAG,IAAI,GAAG,EAAgC,CAAC;IACnD,OAAO,CAAiB;IACxB,QAAQ,CAAe;IACvB,OAAO,CAAU;IACjB,MAAM,CAAW;IACjB,MAAM,CAAU;IAChB,GAAG,CAAe;IAC3B,cAAc,GAAG,CAAC,CAAC;IACnB,UAAU,GAAG,CAAC,CAAC;IACf,KAAK,CAAkB;IACvB,MAAM,GAAG,KAAK,CAAC;IACf,WAAW,GAAG,KAAK,CAAC;IAE5B,YAAY,UAA2B,EAAE;QACvC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAA,6BAAc,GAAE,CAAC;QACpD,MAAM,OAAO,GAAG,EAAE,GAAG,IAAA,uCAAwB,GAAE,EAAE,OAAO,EAAE,CAAC;QAC3D,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,IAAA,iCAAkB,EAAC,OAAO,CAAC,CAAC;QACzE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAA,8BAAe,EAAC,OAAO,CAAC,CAAC;QACzD,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,IAAA,sBAAa,EAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC3D,IAAI,CAAC,MAAM,GAAG,IAAA,uBAAa,EAAC,YAAY,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC;QAC7D,IAAI,CAAC,EAAE,GAAG,IAAA,aAAQ,EAAC;YACjB,YAAY;YACZ,OAAO,EAAE;gBACP,MAAM,EAAE,IAAI,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;gBAC/C,QAAQ,EAAE,IAAI,aAAa,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC;aACpD;SACF,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,KAAa;QACjB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,WAAW,CAAC;QACrB,CAAC;QACD,MAAM,IAAI,GAAgB,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAC3D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvB,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,OAAO;YACL,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC;YAC1C,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC;YACrD,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC;YAC/C,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC;YAC/C,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC;YAChD,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;SACjC,CAAC;IACJ,CAAC;IAMD,KAAK,CAAC,GAAG,CACP,KAAa,EACb,IAA2C,EAC3C,MAA0B;QAE1B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;YAChC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;YACxB,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC/D,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC3B,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAMD,KAAK,CAAC,MAAoB,EAAE,KAAa,EAAE,GAAG,IAAe;QAC3D,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,WAAW,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAMD,OAAO,CAAC,KAAmB,EAAE,IAAY,EAAE,OAAwB;QACjE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,SAAS,CAAC,MAAe;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACrB,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC;IAC/B,CAAC;IAGD,cAAc;QACZ,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAEO,OAAO,CAAC,IAAiB,EAAE,KAAa;QAC9C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAEO,MAAM,CACZ,IAAiB,EACjB,OAAoB,EACpB,KAAc;QAEd,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC;QACjC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,SAAS,EAAE,CAAC;IACnB,CAAC;IAEO,MAAM,CAAC,IAAiB;QAC9B,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IAEO,OAAO,CAAC,IAAiB;QAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC;QAC7C,IAAI,QAAQ,GAAG,qBAAqB,EAAE,CAAC;YACrC,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,uBAAc,EAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;IAC1D,CAAC;IAEO,OAAO;QACb,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,SAAS,EAAE,CAAC;IACnB,CAAC;IAEO,SAAS;QACf,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC;QAC3D,IAAI,aAAa,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACjC,IAAI,CAAC,aAAa,EAAE,CAAC;YACrB,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,iBAAiB,CAAC,CAAC;YAC/D,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;QACD,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACjC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;YACvB,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;IAOO,aAAa;QACnB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;YAC9B,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC9B,OAAO;YACT,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE;gBACxB,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;gBAChC,UAAU,EAAE,MAAM,CAAC,wBAAwB,CAAC,MAAM,EAAE,cAAc,CAAC;aACpE,CAAC,CAAC;YACH,MAAM,CAAC,KAAK,GAAG,CAAC,KAAa,EAAE,GAAG,IAAe,EAAE,EAAE;gBACnD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;gBACnC,OAAO,IAAI,CAAC;YACd,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,aAAa;QACnB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,EAAE;YAC/C,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,UAAU,CAAC,CAAC;YAC5D,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;YACjD,CAAC;QACH,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAEO,QAAQ,CACd,MAAoB,EACpB,KAAa,EACb,GAAG,IAAe;QAElB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;YAC/B,OAAO;QACT,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;IAC/B,CAAC;IAEO,IAAI;QACV,IAAI,CAAC,UAAU,GAAG,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QAC7D,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAEO,IAAI;QACV,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAChE,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,eAAe,CAAC,GAAG,WAAW,CAAC;QACvE,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAC9D,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CACjC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,KAAK,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,EAAE,CACxD,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,QAAQ,EAAE,CAAC,CAAC;QACnE,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC,MAAM,CAAC;IACrC,CAAC;IAEO,KAAK;QACX,IAAI,IAAI,CAAC,cAAc,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO;QACT,CAAC;QACD,IAAI,CAAC,QAAQ,CACX,IAAI,CAAC,QAAQ,EACb,GAAG,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,WAAW,EAAE,CACjD,CAAC;QACF,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;IAC1B,CAAC;CACF;AArPD,4BAqPC;AASD,MAAa,eAAe;IAGG;IAFZ,OAAO,GAAiB,EAAE,CAAC;IAE5C,YAA6B,QAAwB,eAAe;QAAvC,UAAK,GAAL,KAAK,CAAkC;IAAG,CAAC;IAExE,SAAS,CAAC,MAAe;QACvB,IAAI,CAAC,KAAK,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,CAAC;IACjC,CAAC;IAED,GAAG,CAAC,OAAe,EAAE,SAAuB,OAAO,CAAC,MAAM;QACxD,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,OAAO,GAAG,QAAQ,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,YAAY;QACV,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACzD,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,YAAY,CAAC,IAAY;QACvB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;YACrB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,WAAW,CAAC,IAAa;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QAChC,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,IAAI,EAAE,OAAO,EAAE,CAAC;QAClB,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,WAAW,CAAC,IAAa;QACvB,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,gBAAgB;QACd,IAAI,CAAC,KAAK,EAAE,CAAC,cAAc,EAAE,CAAC;QAC9B,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;CACF;AAvDD,0CAuDC;AAED,IAAI,YAAkC,CAAC;AAMvC,SAAgB,eAAe;IAC7B,YAAY,KAAK,IAAI,QAAQ,EAAE,CAAC;IAChC,OAAO,YAAY,CAAC;AACtB,CAAC;AAMD,SAAgB,YAAY;IAC1B,OAAO,eAAe,EAAE,CAAC,EAAE,CAAC;AAC9B,CAAC;AAGD,SAAgB,iBAAiB,CAAC,OAAuB;IACvD,OAAO,YAAY,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AACzC,CAAC;AAGD,SAAgB,OAAO,CACrB,KAAa,EACb,IAA2C,EAC3C,MAA0B;IAE1B,OAAO,eAAe,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC;AAEY,QAAA,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC"}

package/dist/core/cli/output/translations.d.ts

@@ -0,0 +1,4 @@
+import { ExecError } from "../command";
+import type { CliProblem } from "./types";
+export declare function translateExecError(error: ExecError): CliProblem | undefined;
+export declare function translateFailure(error: unknown): CliProblem | undefined;

package/dist/core/cli/output/translations.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.translateExecError = translateExecError;
+exports.translateFailure = translateFailure;
+const command_1 = require("../command");
+const logging_utils_1 = require("../logging-utils");
+const REMOTE_URL = String.raw `((?:[\w+.-]+:\/\/|[\w.-]+@)\S+)`;
+const MISSING_EXECUTABLE = /([^\s:]+): (?:command )?not found|'([^']+)' is not recognized as an internal/;
+const NETWORK_ERROR_CODES = /\b(ENOTFOUND|EAI_AGAIN|ECONNREFUSED|ECONNRESET|ETIMEDOUT)\b/;
+const EXEC_TRANSLATIONS = [
+    {
+        command: /^npm view (\S+)/,
+        output: /\bE404\b/,
+        describe: ([, name]) => ({
+            title: `Package '${name}' not found on the npm registry`,
+            reason: "The registry answered 404: the name is wrong or the package is private.",
+            fixes: [`Check the name: npm view ${name}`],
+        }),
+    },
+    {
+        command: /^(?:npm|pnpm|yarn)\s/,
+        output: NETWORK_ERROR_CODES,
+        describe: (_, [, code]) => ({
+            title: "Cannot reach the npm registry",
+            reason: `The network request failed (${code}).`,
+            fixes: [
+                "Check your network connection, proxy and registry settings, then try again",
+            ],
+        }),
+    },
+    {
+        command: /^git\s/,
+        output: /Could not resolve host|Failed to connect|Connection refused|Connection timed out/i,
+        describe: (_, [cause]) => ({
+            title: "Cannot reach the git server",
+            reason: `git failed: ${cause}.`,
+            fixes: [
+                "Check your network connection and the repository URL, then try again",
+            ],
+        }),
+    },
+    {
+        command: new RegExp(String.raw `^git clone\b.*?${REMOTE_URL}`),
+        output: /could not read (?:Username|Password)|unable to get password|terminal prompts disabled|Authentication failed|Repository not found|not found/i,
+        describe: ([, url]) => ({
+            title: `Could not clone ${url}`,
+            reason: "The repository does not exist or requires authentication.",
+            fixes: [`Check the URL and your access to it: git ls-remote ${url}`],
+        }),
+    },
+    {
+        command: /^/,
+        output: MISSING_EXECUTABLE,
+        describe: (_, [, shellName, windowsName]) => {
+            const executable = shellName ?? windowsName;
+            return {
+                title: `Command not found: ${executable}`,
+                fixes: [`Install ${executable}, or make sure it is on your PATH`],
+            };
+        },
+    },
+];
+function subjectOf(error) {
+    return error.path ?? error.message;
+}
+function permissionDenied(error) {
+    return {
+        title: `Permission denied: ${subjectOf(error)}`,
+        fixes: ["Check the permissions of this path, then try again"],
+    };
+}
+const SYSTEM_ERROR_TRANSLATIONS = {
+    ENOENT: (error) => ({
+        title: `Path not found: ${subjectOf(error)}`,
+        fixes: ["Check the path, then try again"],
+    }),
+    ENOTDIR: (error) => ({
+        title: `Not a directory: ${subjectOf(error)}`,
+        fixes: ["Pass the path of a directory"],
+    }),
+    EACCES: permissionDenied,
+    EPERM: permissionDenied,
+};
+function isSystemError(error) {
+    return (error instanceof Error &&
+        typeof error.code === "string");
+}
+function applyExecTranslation(translation, command, output) {
+    const commandMatch = command.match(translation.command);
+    const outputMatch = output.match(translation.output);
+    if (!commandMatch || !outputMatch) {
+        return undefined;
+    }
+    return translation.describe(commandMatch, outputMatch);
+}
+function translateExecError(error) {
+    const output = (0, logging_utils_1.stripAnsiCodes)(error.output);
+    return EXEC_TRANSLATIONS.map((translation) => applyExecTranslation(translation, error.command, output)).find((problem) => problem !== undefined);
+}
+function translateFailure(error) {
+    if (error instanceof command_1.ExecError) {
+        return translateExecError(error);
+    }
+    if (isSystemError(error)) {
+        return SYSTEM_ERROR_TRANSLATIONS[error.code ?? ""]?.(error);
+    }
+    return undefined;
+}
+//# sourceMappingURL=translations.js.map

package/dist/core/cli/output/translations.js.map

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

package/dist/core/cli/output/types.d.ts

@@ -0,0 +1,139 @@
+export type MessageLevel = "success" | "info" | "warn" | "error" | "skip" | "hint";
+export type OutputChannel = "result" | "feedback";
+export type ColorName = "green" | "red" | "yellow" | "blue" | "cyan" | "dim" | "bold";
+export type SymbolSetName = "unicode" | "ascii";
+type Paint = (text: string) => string;
+export type Palette = Record<ColorName, Paint>;
+export type ChannelFlags = Record<OutputChannel, boolean>;
+export interface OutputStream {
+    write(chunk: string, ...rest: unknown[]): unknown;
+    isTTY?: boolean;
+    columns?: number;
+}
+export type OutputStreams = Record<OutputChannel, OutputStream>;
+export interface OutputCapabilities {
+    hasUnicode: boolean;
+    colors: ChannelFlags;
+    terminals: ChannelFlags;
+}
+export interface CapabilityContext {
+    env: NodeJS.ProcessEnv;
+    argv: string[];
+    platform: NodeJS.Platform;
+    streams: OutputStreams;
+}
+export interface SymbolSet {
+    levels: Record<MessageLevel, string>;
+    bullet: string;
+    rule: string;
+    spinner: string[];
+}
+export interface CliProblem {
+    title: string;
+    reason?: string;
+    fixes?: string[];
+    details?: string[];
+    exitCode?: number;
+}
+export interface DetailEntry {
+    label: string;
+    value: string;
+}
+export interface TableColumn<Row> {
+    header: string;
+    value: (row: Row) => string;
+}
+export interface MessageOptions {
+    detail?: string;
+    details?: string[];
+    channel?: OutputChannel;
+}
+export interface NextStep {
+    command: string;
+    description?: string;
+}
+export interface SummaryBlock {
+    headline: string;
+    durationMs?: number;
+    artifact?: string;
+    nextSteps?: NextStep[];
+}
+export interface UiOptions {
+    streams?: OutputStreams;
+    capabilities?: OutputCapabilities;
+}
+export interface Ui {
+    readonly symbols: SymbolSet;
+    palette(channel?: OutputChannel): Palette;
+    message(level: MessageLevel, text: string, options?: MessageOptions): void;
+    problem(problem: CliProblem): void;
+    heading(text: string): void;
+    summary(block: SummaryBlock): void;
+    details(entries: DetailEntry[], channel?: OutputChannel): void;
+    list(items: string[]): void;
+    table<Row>(rows: Row[], columns: TableColumn<Row>[]): void;
+    value(text: string): void;
+    json(data: unknown): void;
+}
+export interface TaskHandle {
+    update(label: string): void;
+    succeed(label?: string): void;
+    warn(label?: string): void;
+    skip(label?: string): void;
+    fail(label?: string): void;
+    dismiss(): void;
+}
+type TaskDoneLabel<Result> = string | ((result: Result) => string);
+export interface TaskLabels<Result> {
+    done: TaskDoneLabel<Result>;
+    failed?: string;
+}
+export interface TaskListOptions extends UiOptions {
+    isLive?: boolean;
+    now?: () => number;
+}
+interface InputStream {
+    isTTY?: boolean;
+}
+export interface InteractivityContext {
+    env: NodeJS.ProcessEnv;
+    input: InputStream;
+    output: OutputStream;
+}
+export interface MissingInput {
+    command: string;
+    flags: string[];
+    defaultsFlag?: string;
+    fixes?: string[];
+}
+export interface PromptChoice<Value> {
+    value: Value;
+    label: string;
+    hint?: string;
+}
+export interface Question<Answer> {
+    message: string;
+    flag?: string;
+    answer?: Answer;
+    defaultAnswer?: Answer;
+    isOptional?: boolean;
+}
+interface ChoiceQuestion<Value, Answer> extends Question<Answer> {
+    choices: PromptChoice<Value>[];
+}
+export type SelectQuestion<Value> = ChoiceQuestion<Value, Value>;
+export type MultiSelectQuestion<Value> = ChoiceQuestion<Value, Value[]>;
+export interface PrompterOptions {
+    command: string;
+    acceptsDefaults?: boolean;
+    defaultsFlag?: string;
+}
+export interface Prompter {
+    readonly isInteractive: boolean;
+    text(question: Question<string>): Promise<string>;
+    confirm(question: Question<boolean>): Promise<boolean>;
+    select<Value>(question: SelectQuestion<Value>): Promise<Value>;
+    multiselect<Value>(question: MultiSelectQuestion<Value>): Promise<Value[]>;
+    requireAnswers(missingFlags: string[]): void;
+}
+export {};

package/dist/core/cli/output/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/core/cli/output/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/core/cli/output/types.ts"],"names":[],"mappings":""}

package/dist/core/cli/output/ui.d.ts

@@ -0,0 +1,2 @@
+import type { Ui, UiOptions } from "./types";
+export declare function createUi(options?: UiOptions): Ui;