@alterior/terminal 3.1.12 → 3.13.3

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export * from './style';
 export * from './read';
 export * from './terminal-ui';
+export * from './task-list';

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -17,4 +17,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./style"), exports);
 __exportStar(require("./read"), exports);
 __exportStar(require("./terminal-ui"), exports);
+__exportStar(require("./task-list"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,yCAAuB;AACvB,gDAA8B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,yCAAuB;AACvB,gDAA8B;AAC9B,8CAA4B"}

package/dist/read/basic.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basic.test.d.ts","sourceRoot":"","sources":["../../src/read/basic.test.ts"],"names":[],"mappings":""}

package/dist/read/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/read/fixtures.ts"],"names":[],"mappings":"AAKA,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;YAGjD,MAAM;YAAU,MAAM;GAuBpD"}

package/dist/read/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/read/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC"}

package/dist/read/many.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"many.test.d.ts","sourceRoot":"","sources":["../../src/read/many.test.ts"],"names":[],"mappings":""}

package/dist/read/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/read/read.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AAE9C,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,OAAO,CAAC,EAAE,GAAG,CAAC;IAEd;;OAEG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;IAEnB;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,IAAI,CAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAwElE"}

package/dist/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../src/style.ts"],"names":[],"mappings":"AAKA,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BhB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,QAAQ,EAAE,CAAC,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,EAAE,KAAK,YAAY,CAAC;AACxG,MAAM,MAAM,cAAc,GAAG;KACxB,CAAC,IAAI,MAAM,OAAO,WAAW,IAAI,IAAI,CAAC,EAAE,GAAG,CAAC,GAAG,QAAQ,EAAE,CAAC,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC,EAAE,KAAK,YAAY;CAChH,CAAA;AAED,MAAM,MAAM,MAAM,GAAG,WAAW,GAAG,cAAc,CAAC;AAElD,MAAM,MAAM,KAAK,GAAG,MAAM,OAAO,WAAW,CAAC;AAC7C,eAAO,MAAM,UAAU,QAAS,MAAM,kBAAkB,GAAG,SAAS,WAA2B,CAAC;AAChG,eAAO,MAAM,QAAQ,QAAS,MAAM,kBAAkB,GAAG,SAAS,WAA2B,CAAC;AAE9F,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,OAAO,WAAW,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,UAMtF;AAED,qBAAa,YAAY;IAEjB,QAAQ,CAAC,KAAK,CAAC;IACf,QAAQ,CAAC,KAAK,EAAE,CAAC,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC,EAAE;gBADzC,KAAK,CAAC,wSAA0B,EAChC,KAAK,GAAE,CAAC,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC,EAAO;IAI3D,KAAK;IAIL,GAAG;IAIH,QAAQ;CAGX;AASD,eAAO,MAAM,KAAK,QAAiB,CAAC;AAEpC,wBAAgB,MAAM,CAAC,GAAG,QAAQ,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,YAAY,CAAC,EAAE,GAAG,MAAM,CAE9E"}

package/dist/task-list.d.ts

@@ -0,0 +1,104 @@
+/// <reference types="node" />
+export interface CLITaskInit {
+    omitInNonInteractive?: boolean;
+    parentTask?: CLITask;
+}
+export declare class CLITaskList {
+    readonly interactive: boolean;
+    readonly silent: boolean;
+    constructor(interactive?: boolean, silent?: boolean);
+    private timer;
+    private renderedLineCount;
+    readonly spinner: CLITaskStatusWidget;
+    private globalTask;
+    private started;
+    startCursor: {
+        x: number;
+        y: number;
+    };
+    private start;
+    stop(): void;
+    get remainingLines(): number;
+    startTask(title: string, init?: CLITaskInit): CLITask;
+    addTask(task: CLITask): void;
+    get allTasksFinished(): boolean;
+    idle: boolean;
+    private idleTimeout;
+    beforeCpu: NodeJS.CpuUsage;
+    cpu: NodeJS.CpuUsage;
+    ram: NodeJS.MemoryUsage;
+    lastTimestamp: bigint;
+    secondTicks: number;
+    startedAt: number;
+    private render;
+    drawHeader(): void;
+    private startFrame;
+    private endFrame;
+    drawLine(input?: string): void;
+    private truncateLineIfNeeded;
+}
+declare class LineTracker {
+    private _maxLines;
+    constructor(_maxLines: number);
+    static unbounded: LineTracker;
+    private _consumed;
+    get maxLines(): number;
+    get consumed(): number;
+    consume(count?: number): void;
+}
+export type CLITaskCharm = () => string;
+export type CLITaskStatus = 'running' | 'error' | 'finished';
+export declare class CLITask {
+    constructor(title: string, init?: CLITaskInit);
+    parent?: CLITask;
+    children: CLITask[];
+    title: string;
+    status: CLITaskStatus;
+    finishedAt: number;
+    startedAt: number;
+    charms: CLITaskCharm[];
+    staleAfter: number;
+    staleWithErrorsAndLogAfter: number;
+    omitInNonInteractive: boolean;
+    private logMessages;
+    get depth(): any;
+    get indent(): string;
+    get isFinishedAndStale(): boolean;
+    get containsLogsOrError(): boolean;
+    get isDeleted(): boolean;
+    get parents(): CLITask[];
+    get chain(): CLITask[];
+    onUpdated: (task: CLITask) => void;
+    onDeleted: (task: CLITask) => void;
+    onLog: (task: CLITask, message: string) => void;
+    log(message: string): void;
+    error(message?: string): void;
+    finish(notify?: boolean): void;
+    delete(): void;
+    subtask(title: string, init?: CLITaskInit): CLITask;
+    addTask(child: CLITask): CLITask;
+    render(renderer: CLITaskList, lineTracker: LineTracker, parentFinished?: boolean): number;
+    renderNonInteractive(renderer: CLITaskList): void;
+    renderSelfAndParents(renderer: CLITaskList): void;
+    renderSelf(renderer: CLITaskList, lineTracker: LineTracker): void;
+    renderLogs(renderer: CLITaskList, lineTracker: LineTracker): void;
+    renderLogLine(renderer: CLITaskList, line: string): void;
+    renderChildren(renderer: CLITaskList, lineTracker: LineTracker, parentFinished?: boolean): number;
+    private summarizeCounts;
+    private summarizeCount;
+    private statusStyle;
+    private iconForStatus;
+}
+export declare class CLITaskStatusWidget {
+    private task?;
+    constructor(task?: CLITask);
+    protected readonly spinner: string[];
+    private id?;
+    private spinnerPosition;
+    spin(): void;
+    render(): string;
+    isRunning(): boolean;
+    start(cb?: () => void, interval?: number): void;
+    stop(): void;
+}
+export {};

package/dist/task-list.js

@@ -0,0 +1,452 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLITaskStatusWidget = exports.CLITask = exports.CLITaskList = void 0;
+const functions_1 = require("@alterior/functions");
+const style_1 = require("./style");
+const CLI_TASK_ERROR_ICON = '𐄂';
+const CLI_TASK_FINISHED_ICON = '✓';
+const INDENT = '    ';
+class CLITaskList {
+    constructor(interactive = true, silent = false) {
+        this.interactive = interactive;
+        this.silent = silent;
+        this.renderedLineCount = 0;
+        this.spinner = new CLITaskStatusWidget();
+        this.globalTask = new CLITask('Global Task');
+        this.started = false;
+        this.startCursor = { x: 0, y: 0 };
+        this.idle = false;
+        this.lastTimestamp = BigInt(0);
+        this.secondTicks = 1000000;
+        this.startedAt = Date.now();
+        this.globalTask.onUpdated = task => {
+            if (!this.interactive) {
+                if (task.children.length === 0)
+                    task.renderNonInteractive(this);
+                return;
+            }
+            // When the last task completes, we need to re-render inline to be sure we render the right state.
+            // But we only want to do this once, and only when needed, otherwise its a waste.
+            if (this.globalTask.children.every(t => t.status !== 'running'))
+                this.render();
+        };
+        this.globalTask.onLog = (task, message) => {
+            if (this.interactive)
+                return;
+            task.renderNonInteractive(this);
+            for (let line of message.split(/\r?\n/))
+                task.renderLogLine(this, line);
+        };
+    }
+    start() {
+        if (!this.interactive)
+            return;
+        if (this.started)
+            return;
+        this.started = true;
+        this.timer = setInterval(() => this.render(), 1000 / 30);
+        this.spinner.start();
+    }
+    stop() {
+        if (!this.interactive)
+            return;
+        if (!this.started)
+            return;
+        // Render once more to be sure we capture the final state.
+        this.render();
+        this.started = false;
+        clearInterval(this.timer);
+        this.timer = undefined;
+        this.spinner.stop();
+        this.renderedLineCount = 0;
+    }
+    get remainingLines() {
+        // The -2 here is:
+        // -  (x) Its desirable to keep the prompt line visible at the top of the screen if possible (-1)
+        // - We will have one empty line visible at the end of the output to avoid flickering the
+        //   cursor (-1)
+        return Math.max(0, process.stdout.rows - this.renderedLineCount - 1);
+    }
+    startTask(title, init) {
+        let task = new CLITask(title, init);
+        this.addTask(task);
+        return task;
+    }
+    addTask(task) {
+        if (!this.started) {
+            this.start();
+        }
+        this.globalTask.addTask(task);
+    }
+    get allTasksFinished() {
+        return this.globalTask.children.every(x => x.status !== 'running');
+    }
+    render() {
+        let newSecond = process.hrtime.bigint();
+        if (this.lastTimestamp + BigInt(1000000000) < newSecond) {
+            this.secondTicks = Number((newSecond - this.lastTimestamp) / BigInt(1000));
+            this.lastTimestamp = newSecond;
+            this.cpu = process.cpuUsage(this.beforeCpu);
+            this.beforeCpu = process.cpuUsage();
+            this.ram = process.memoryUsage();
+        }
+        this.startFrame();
+        // other cool u characters include: 𝖚
+        // see more: https://unicodeplus.com/U+0075
+        let elapsedTime = formatDuration(Date.now() - this.startedAt);
+        this.drawHeader();
+        this.globalTask.renderChildren(this, new LineTracker(this.remainingLines));
+        this.endFrame();
+    }
+    drawHeader() {
+    }
+    startFrame() {
+        process.stdout.cork();
+        process.stdout.moveCursor(0, -this.renderedLineCount);
+        this.renderedLineCount = 0;
+    }
+    endFrame() {
+        process.stdout.clearScreenDown();
+        process.stdout.uncork();
+        // Update idle
+        if (this.idle !== this.allTasksFinished) {
+            this.idle = this.allTasksFinished;
+            if (this.idle) {
+                this.idleTimeout = setTimeout(() => {
+                    if (this.idle) {
+                        this.stop();
+                    }
+                }, 1000);
+            }
+            else {
+                this.idle = false;
+                clearTimeout(this.idleTimeout);
+            }
+        }
+    }
+    drawLine(input = '') {
+        if (this.silent)
+            return;
+        if (!this.interactive) {
+            console.log(input);
+            return;
+        }
+        let lines = input.split(/\r?\n/);
+        let count = 0;
+        for (let line of lines) {
+            process.stdout.clearLine(0);
+            process.stdout.write(`${this.truncateLineIfNeeded(line)}\n`);
+            process.stdout.clearLine(1);
+            this.renderedLineCount += 1;
+            count += 1;
+        }
+    }
+    truncateLineIfNeeded(line) {
+        let indicatorPattern = /\u001b\[[^m]*m/g;
+        let visibleLength = line.replace(indicatorPattern, '').length;
+        if (visibleLength < process.stdout.columns)
+            return line;
+        let newLine = '';
+        let newVisible = 0;
+        for (let i = 0, max = line.length; i < max && newVisible < process.stdout.columns - 3; ++i) {
+            let match = /^\u001b\[[^m]*m/.exec(line.slice(i));
+            if (match) {
+                newLine += `${match[0]}`;
+                i += match[0].length - 1;
+            }
+            else {
+                newLine += line.at(i);
+                newVisible += 1;
+            }
+        }
+        newLine += (0, style_1.styled)(style_1.style.$dim('...'));
+        // We may have cut off style codes by eliding this line. To prevent weirdness, we must
+        // reset the terminal back to default
+        newLine += (0, style_1.startStyle)('reset');
+        return newLine;
+    }
+}
+exports.CLITaskList = CLITaskList;
+class LineTracker {
+    constructor(_maxLines) {
+        this._maxLines = _maxLines;
+        this._consumed = 0;
+    }
+    get maxLines() {
+        if (this._maxLines === undefined)
+            return Number.MAX_SAFE_INTEGER;
+        return this._maxLines;
+    }
+    get consumed() {
+        if (this._maxLines === undefined)
+            return 0;
+        return this._consumed;
+    }
+    consume(count = 1) {
+        if (this._maxLines !== undefined)
+            this._maxLines -= count;
+        this._consumed += count;
+    }
+}
+LineTracker.unbounded = new LineTracker(undefined);
+class CLITask {
+    constructor(title, init = {}) {
+        this.children = [];
+        this.status = 'running';
+        this.startedAt = Date.now();
+        this.charms = [];
+        this.staleAfter = 0;
+        this.staleWithErrorsAndLogAfter = 10000;
+        this.omitInNonInteractive = false;
+        this.logMessages = [];
+        this.title = title;
+        if (init.omitInNonInteractive)
+            this.omitInNonInteractive = true;
+    }
+    // Computed Properties
+    get depth() {
+        var _a, _b;
+        return ((_b = (_a = this.parent) === null || _a === void 0 ? void 0 : _a.depth) !== null && _b !== void 0 ? _b : -1) + 1;
+    }
+    get indent() {
+        if (this.depth === 0)
+            return ``;
+        return Array.from(Array(this.depth - 1)).map(() => INDENT).join('');
+    }
+    get isFinishedAndStale() {
+        let staleTime = this.containsLogsOrError ? this.staleWithErrorsAndLogAfter : this.staleAfter;
+        let freshness = Math.min(staleTime);
+        return this.status === 'finished' && this.finishedAt + freshness < Date.now();
+    }
+    get containsLogsOrError() {
+        return this.logMessages.length > 0 || this.status === 'error' || this.children.some(x => x.containsLogsOrError);
+    }
+    get isDeleted() {
+        var _a;
+        return this.parent ? !((_a = this.parent) === null || _a === void 0 ? void 0 : _a.children.includes(this)) : false;
+    }
+    get parents() {
+        let parents = [];
+        let parent = this.parent;
+        while (parent === null || parent === void 0 ? void 0 : parent.parent) {
+            parents.unshift(parent);
+            parent = parent.parent;
+        }
+        return parents;
+    }
+    get chain() {
+        return [...this.parents, this];
+    }
+    // Lifecycle API
+    log(message) {
+        var _a;
+        this.logMessages.push(...message.split(/\r?\n/));
+        (_a = this.onLog) === null || _a === void 0 ? void 0 : _a.call(this, this, message);
+    }
+    error(message) {
+        this.status = 'error';
+        this.log(`[Error] ${message || 'The task failed.'}`);
+    }
+    finish(notify = true) {
+        var _a;
+        this.status = 'finished';
+        this.finishedAt = Date.now();
+        for (let child of this.children)
+            child.finish(false);
+        if (notify)
+            (_a = this.onUpdated) === null || _a === void 0 ? void 0 : _a.call(this, this);
+    }
+    delete() {
+        var _a;
+        (_a = this.onDeleted) === null || _a === void 0 ? void 0 : _a.call(this, this);
+    }
+    // Subtasks
+    subtask(title, init = {}) {
+        let child = new CLITask(title, init);
+        this.addTask(child);
+        return child;
+    }
+    addTask(child) {
+        this.children.push(child);
+        child.parent = this;
+        child.onUpdated = child => { var _a; return (_a = this.onUpdated) === null || _a === void 0 ? void 0 : _a.call(this, child); };
+        child.onLog = (task, message) => { var _a; return (_a = this.onLog) === null || _a === void 0 ? void 0 : _a.call(this, task, message); };
+        child.onDeleted = child => {
+            var _a;
+            let index = this.children.indexOf(child);
+            if (index >= 0)
+                this.children.splice(index, 1);
+            (_a = this.onUpdated) === null || _a === void 0 ? void 0 : _a.call(this, child);
+        };
+        return child;
+    }
+    // Rendering
+    render(renderer, lineTracker, parentFinished = false) {
+        if (parentFinished && !this.containsLogsOrError)
+            return 0;
+        this.renderSelf(renderer, lineTracker);
+        this.renderChildren(renderer, lineTracker, parentFinished || this.isFinishedAndStale);
+        this.renderLogs(renderer, lineTracker);
+    }
+    renderNonInteractive(renderer) {
+        if (this.omitInNonInteractive)
+            return;
+        renderer.drawLine(this.chain.filter(x => !x.omitInNonInteractive).map(p => `${p.statusStyle(p.title)}`).join(' » '));
+    }
+    renderSelfAndParents(renderer) {
+        for (let parent of this.parents)
+            parent.renderSelf(renderer, LineTracker.unbounded);
+        this.renderSelf(renderer, LineTracker.unbounded);
+    }
+    renderSelf(renderer, lineTracker) {
+        var _a;
+        renderer.drawLine(`${(_a = this.indent) !== null && _a !== void 0 ? _a : ''}`
+            + `${this.statusStyle(`${this.iconForStatus(renderer)} ${this.title}`, this.status)}`
+            + `${this.summarizeCounts(renderer)}`
+        //+ ` DEBUG: ${maxLines}`
+        );
+        lineTracker.consume();
+    }
+    renderLogs(renderer, lineTracker) {
+        let displayedLogs = this.logMessages.slice();
+        while (displayedLogs.length > lineTracker.maxLines)
+            displayedLogs.shift();
+        for (let line of displayedLogs) {
+            this.renderLogLine(renderer, line);
+            lineTracker.consume();
+        }
+    }
+    renderLogLine(renderer, line) {
+        var _a;
+        renderer.drawLine(`${(_a = this.indent) !== null && _a !== void 0 ? _a : ''}  ${(0, style_1.styled)(style_1.style.$dim(line))}`);
+    }
+    renderChildren(renderer, lineTracker, parentFinished = false) {
+        if (lineTracker.maxLines <= 0)
+            return 0;
+        let statusOrder = {
+            'error': 0,
+            'finished': 1,
+            'running': 2
+        };
+        this.children.sort((a, b) => statusOrder[a.status] - statusOrder[b.status]);
+        let maxDisplayedTasks = lineTracker.maxLines;
+        let displayedTasks = this.children.slice();
+        if (parentFinished) {
+            displayedTasks = displayedTasks.filter(x => x.containsLogsOrError);
+        }
+        else {
+            displayedTasks = displayedTasks.filter(x => !x.isFinishedAndStale);
+        }
+        // If we're tight on space, elide freshly finished tasks, too.
+        while (displayedTasks.length > maxDisplayedTasks) {
+            let taskIndex = displayedTasks.findIndex(x => x.status === 'finished');
+            if (taskIndex < 0)
+                break;
+            displayedTasks.splice(taskIndex, 1);
+        }
+        // Elide errors (better to see ongoing progress) ////////////////
+        while (displayedTasks.length > maxDisplayedTasks) {
+            let taskIndex = displayedTasks.findIndex(x => x.status === 'error');
+            if (taskIndex < 0)
+                break;
+            displayedTasks.splice(taskIndex, 1);
+        }
+        // Elide all remaining from end of sorted list until we fit within the maxDisplayedTasks
+        if (displayedTasks.length > maxDisplayedTasks)
+            displayedTasks.splice(maxDisplayedTasks, displayedTasks.length);
+        let extraLinesForChildren = lineTracker.maxLines - displayedTasks.length;
+        for (let task of displayedTasks) {
+            let childLineTracker = new LineTracker(1 + extraLinesForChildren);
+            task.render(renderer, childLineTracker, parentFinished);
+            lineTracker.consume(childLineTracker.consumed);
+            extraLinesForChildren -= (childLineTracker.consumed - 1);
+            extraLinesForChildren = Math.max(0, extraLinesForChildren);
+        }
+    }
+    // Helpers
+    summarizeCounts(r) {
+        let counts = [
+            this.logMessages.length > 0 ? `${(0, style_1.styled)(style_1.style.$yellow(`• ${this.logMessages.length}`))}` : undefined,
+            this.summarizeCount(r, (0, functions_1.count)(this.children, x => x.status === 'finished'), 'finished'),
+            this.summarizeCount(r, (0, functions_1.count)(this.children, x => x.status === 'error'), 'error'),
+            this.summarizeCount(r, (0, functions_1.count)(this.children, x => x.status === 'running'), 'running'),
+        ].filter(x => x);
+        if (counts.length === 0)
+            return '';
+        return `  ${(0, style_1.styled)(style_1.style.$dim(counts.join('   ')))}`;
+    }
+    summarizeCount(r, count, status) {
+        if (count <= 0)
+            return undefined;
+        return this.statusStyle(`${this.iconForStatus(r, status)} ${count}`, status);
+    }
+    statusStyle(line, status = this.status) {
+        if (status === 'running') {
+            line = (0, style_1.styled)(style_1.style.$bold(style_1.style.$blue(line)));
+        }
+        else if (status === 'finished') {
+            line = (0, style_1.styled)(style_1.style.$green(line));
+        }
+        else if (status === 'error') {
+            line = (0, style_1.styled)(style_1.style.$red(line));
+        }
+        return line;
+    }
+    iconForStatus(renderer, status = this.status) {
+        if (this.status === 'error')
+            return CLI_TASK_ERROR_ICON;
+        else if (this.status === 'finished')
+            return CLI_TASK_FINISHED_ICON;
+        return renderer.spinner.render();
+    }
+}
+exports.CLITask = CLITask;
+class CLITaskStatusWidget {
+    constructor(task) {
+        this.task = task;
+        this.spinner = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+        this.spinnerPosition = 0;
+        this.start();
+    }
+    spin() {
+        this.spinnerPosition = ++this.spinnerPosition % this.spinner.length;
+        if (this.task && this.task.status !== 'running') {
+            clearInterval(this.id);
+        }
+    }
+    render() {
+        var _a, _b;
+        if (((_a = this.task) === null || _a === void 0 ? void 0 : _a.status) === 'error')
+            return CLI_TASK_ERROR_ICON;
+        else if (((_b = this.task) === null || _b === void 0 ? void 0 : _b.status) === 'finished')
+            return CLI_TASK_FINISHED_ICON;
+        return this.spinner[this.spinnerPosition];
+    }
+    isRunning() {
+        return !!this.id;
+    }
+    start(cb, interval = 100) {
+        clearInterval(this.id);
+        this.id = setInterval(() => {
+            this.spin();
+            if (cb) {
+                cb();
+            }
+        }, interval);
+    }
+    stop() {
+        clearInterval(this.id);
+    }
+}
+exports.CLITaskStatusWidget = CLITaskStatusWidget;
+function formatDuration(duration) {
+    const msPerSec = 1000;
+    const msPerMinute = (1000 * 60);
+    const msPerHour = (1000 * 60 * 60);
+    let hours = duration / msPerHour | 0;
+    let minutes = (duration - (hours * msPerHour)) / msPerMinute | 0;
+    let seconds = (duration - (hours * msPerHour + minutes * msPerMinute)) / msPerSec | 0;
+    let ms = duration % 1000;
+    return `${(0, functions_1.zeroPad)(hours)}:${(0, functions_1.zeroPad)(minutes)}:${(0, functions_1.zeroPad)(seconds)}:${(0, functions_1.zeroPad)(ms, 3)}`;
+}
+//# sourceMappingURL=task-list.js.map

package/dist/task-list.js.map

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

package/dist/terminal-ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-ui.d.ts","sourceRoot":"","sources":["../src/terminal-ui.ts"],"names":[],"mappings":";;AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AAE9C,OAAO,EAAU,YAAY,EAAE,MAAM,SAAS,CAAC;AAE/C,qBAAa,UAAU;gBACP,KAAK;;KAAgB,EAAE,MAAM;;KAAiB;IAK1D,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IAEpB,OAAO,CAAC,EAAE,CAAmC;IAC7C,OAAO,CAAC,OAAO,CAAc;IAC7B,IAAI,MAAM,WAET;IAED,IAAI,MAAM,CAAC,KAAK,QAAA,EAMf;IAED,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,cAAc,UAAS;IAEjB,KAAK;IAKX,OAAO,EAAE,MAAM,EAAE,CAAM;YAET,WAAW;IAqCzB,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,YAAY;IASd,GAAG,CAAC,GAAG,QAAQ,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,YAAY,CAAC,EAAE;CAe5D"}

package/dist/test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../src/test.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@alterior/terminal",
-  "version": "3.1.12",
+  "version": "3.13.3",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "mute-stream": "~1.0.0"
+    "mute-stream": "~1.0.0",
+    "@alterior/functions": "^3.11.1"
   },
   "devDependencies": {
     "@types/mute-stream": "^0.0.1"
@@ -27,5 +28,5 @@
     "test": "npm run build && node dist/test",
     "prepublishOnly": "npm test"
   },
-  "gitHead": "b2faab5729a63f356c37b6bab5a6eacb1a1180ef"
-}
+  "gitHead": "87f31ea4078faaca53b45573c6a0013cdb40dd07"
+}

package/src/index.ts

@@ -1,3 +1,4 @@
 export * from './style';
 export * from './read';
-export * from './terminal-ui';
+export * from './terminal-ui';
+export * from './task-list';

package/src/task-list.ts

@@ -0,0 +1,561 @@
+import { count, zeroPad } from '@alterior/functions';
+import { startStyle, style, styled } from './style';
+
+const CLI_TASK_ERROR_ICON = '𐄂';
+const CLI_TASK_FINISHED_ICON = '✓';
+const INDENT = '    ';
+
+export interface CLITaskInit {
+    omitInNonInteractive?: boolean;
+    parentTask?: CLITask;
+}
+
+export class CLITaskList {
+    constructor(readonly interactive = true, readonly silent = false) {
+        this.globalTask.onUpdated = task => {
+            if (!this.interactive) {
+                if (task.children.length === 0)
+                    task.renderNonInteractive(this);
+                return;
+            }
+            // When the last task completes, we need to re-render inline to be sure we render the right state.
+            // But we only want to do this once, and only when needed, otherwise its a waste.
+            if (this.globalTask.children.every(t => t.status !== 'running'))
+                this.render();
+        };
+        this.globalTask.onLog = (task: CLITask, message: string) => {
+            if (this.interactive)
+                return;
+
+            task.renderNonInteractive(this);
+            for (let line of message.split(/\r?\n/))
+                task.renderLogLine(this, line);
+        }
+    }
+
+    private timer;
+    private renderedLineCount = 0;
+    readonly spinner = new CLITaskStatusWidget();
+    private globalTask = new CLITask('Global Task');
+
+    private started = false;
+    startCursor: { x: number, y: number } = { x: 0, y: 0 };
+
+    private start() {
+        if (!this.interactive)
+            return;
+
+        if (this.started)
+            return;
+
+        this.started = true;
+        this.timer = setInterval(() => this.render(), 1000 / 30);
+        this.spinner.start();
+    }
+
+    stop() {
+        if (!this.interactive)
+            return;
+        if (!this.started)
+            return;
+
+        // Render once more to be sure we capture the final state.
+        this.render();
+        
+        this.started = false;
+        clearInterval(this.timer);
+        this.timer = undefined;
+        this.spinner.stop();
+
+
+        this.renderedLineCount = 0;     
+    }
+
+    get remainingLines() {
+        // The -2 here is:
+        // -  (x) Its desirable to keep the prompt line visible at the top of the screen if possible (-1)
+        // - We will have one empty line visible at the end of the output to avoid flickering the
+        //   cursor (-1)
+        return Math.max(0, process.stdout.rows - this.renderedLineCount - 1);
+    }
+
+    startTask(title: string, init?: CLITaskInit) {
+        let task = new CLITask(title, init);
+        this.addTask(task);
+        return task;
+    }
+
+    addTask(task: CLITask) {
+        if (!this.started) {
+            this.start();
+        }
+
+        this.globalTask.addTask(task);
+    }
+
+    get allTasksFinished() {
+        return this.globalTask.children.every(x => x.status !== 'running');
+    }
+
+    idle = false;
+    private idleTimeout: any;
+    beforeCpu: NodeJS.CpuUsage;
+    cpu: NodeJS.CpuUsage;
+    ram: NodeJS.MemoryUsage;
+
+    lastTimestamp: bigint = BigInt(0);
+    secondTicks = 1_000_000;
+    startedAt = Date.now();
+
+    private render() {
+        let newSecond = process.hrtime.bigint();
+        if (this.lastTimestamp + BigInt(1_000_000_000) < newSecond) {
+            this.secondTicks = Number((newSecond - this.lastTimestamp) / BigInt(1_000));
+            this.lastTimestamp = newSecond;
+            this.cpu = process.cpuUsage(this.beforeCpu);
+            this.beforeCpu = process.cpuUsage();
+            this.ram = process.memoryUsage();
+        }
+
+        this.startFrame();
+
+        // other cool u characters include: 𝖚
+        // see more: https://unicodeplus.com/U+0075
+
+        let elapsedTime = formatDuration(Date.now() - this.startedAt)
+
+        this.drawHeader();
+
+        this.globalTask.renderChildren(this, new LineTracker(this.remainingLines));
+        this.endFrame();
+    }
+
+    drawHeader() {
+        
+    }
+
+    private startFrame() {
+        process.stdout.cork();
+        process.stdout.moveCursor(0, -this.renderedLineCount);
+        this.renderedLineCount = 0;
+    }
+
+    private endFrame() {
+        process.stdout.clearScreenDown();
+        process.stdout.uncork();
+
+        // Update idle
+        if (this.idle !== this.allTasksFinished) {
+            this.idle = this.allTasksFinished;
+            if (this.idle) {
+                this.idleTimeout = setTimeout(() => {
+                    if (this.idle) {
+                        this.stop();
+                    }
+                }, 1_000);
+            } else {
+                this.idle = false;
+                clearTimeout(this.idleTimeout);
+            }
+        }
+    }
+
+    drawLine(input: string = ''): void {
+        if (this.silent)
+            return;
+
+        if (!this.interactive) {
+            console.log(input);
+            return;
+        }
+
+        let lines = input.split(/\r?\n/);
+        let count = 0;
+
+        for (let line of lines) {
+            process.stdout.clearLine(0);
+            process.stdout.write(`${this.truncateLineIfNeeded(line)}\n`);
+            process.stdout.clearLine(1);
+
+            this.renderedLineCount += 1;
+            count += 1;
+        }
+    }
+
+    private truncateLineIfNeeded(line: string) {
+        let indicatorPattern = /\u001b\[[^m]*m/g;
+        let visibleLength = line.replace(indicatorPattern, '').length;
+        if (visibleLength < process.stdout.columns)
+            return line;
+
+        let newLine = '';
+        let newVisible = 0;
+
+        for (let i = 0, max = line.length; i < max && newVisible < process.stdout.columns - 3; ++i) {
+            let match = /^\u001b\[[^m]*m/.exec(line.slice(i));
+            if (match) {
+                newLine += `${match[0]}`;
+                i += match[0].length - 1;
+            } else {
+                newLine += line.at(i);
+                newVisible += 1;
+            }
+        }
+
+        newLine += styled(style.$dim('...'));
+
+        // We may have cut off style codes by eliding this line. To prevent weirdness, we must
+        // reset the terminal back to default
+        newLine += startStyle('reset');
+        return newLine;
+    }
+}
+
+class LineTracker {
+    constructor(private _maxLines: number) {
+    }
+
+    static unbounded = new LineTracker(undefined);
+    private _consumed = 0;
+
+    get maxLines() {
+        if (this._maxLines === undefined)
+            return Number.MAX_SAFE_INTEGER;
+        return this._maxLines;
+    }
+
+    get consumed() {
+        if (this._maxLines === undefined)
+            return 0;
+        return this._consumed;
+    }
+
+    consume(count: number = 1) {
+        if (this._maxLines !== undefined)
+            this._maxLines -= count;
+        this._consumed += count;
+    }
+}
+
+export type CLITaskCharm = () => string;
+export type CLITaskStatus = 'running' | 'error' | 'finished';
+export class CLITask {
+    constructor(title: string, init: CLITaskInit = {}) {
+        this.title = title;
+        if (init.omitInNonInteractive)
+            this.omitInNonInteractive = true;
+    }
+    parent?: CLITask;
+    children: CLITask[] = [];
+    title: string;
+    status: CLITaskStatus = 'running';
+    finishedAt: number;
+    startedAt = Date.now();
+
+    charms: CLITaskCharm[] = [];
+    staleAfter = 0;
+    staleWithErrorsAndLogAfter = 10_000;
+    omitInNonInteractive = false;
+
+    private logMessages: string[] = [];
+
+    // Computed Properties
+
+    get depth() {
+        return (this.parent?.depth ?? -1) + 1;
+    }
+
+    get indent() {
+        if (this.depth === 0)
+            return ``;
+        return Array.from(Array(this.depth - 1)).map(() => INDENT).join('');
+    }
+
+    get isFinishedAndStale(): boolean {
+        let staleTime = this.containsLogsOrError ? this.staleWithErrorsAndLogAfter : this.staleAfter;
+        let freshness = Math.min(staleTime);
+        return this.status === 'finished' && this.finishedAt + freshness < Date.now();
+    }
+
+    get containsLogsOrError(): boolean {
+        return this.logMessages.length > 0 || this.status === 'error' || this.children.some(x => x.containsLogsOrError);
+    }
+
+    get isDeleted() {
+        return this.parent ? !this.parent?.children.includes(this) : false;
+    }
+
+    get parents() {
+        let parents: CLITask[] = [];
+        let parent = this.parent;
+        while (parent?.parent) {
+            parents.unshift(parent);
+            parent = parent.parent;
+        }
+        return parents;
+    }
+
+    get chain() {
+        return [...this.parents, this];
+    }
+
+    // Events
+
+    onUpdated: (task: CLITask) => void;
+    onDeleted: (task: CLITask) => void;
+    onLog: (task: CLITask, message: string) => void;
+
+    // Lifecycle API
+
+    log(message: string) {
+        this.logMessages.push(...message.split(/\r?\n/));
+        this.onLog?.(this, message);
+    }
+
+    error(message?: string) {
+        this.status = 'error';
+        this.log(`[Error] ${message || 'The task failed.'}`);
+    }
+
+    finish(notify = true) {
+        this.status = 'finished';
+        this.finishedAt = Date.now();
+
+        for (let child of this.children)
+            child.finish(false);
+
+        if (notify)
+            this.onUpdated?.(this);
+    }
+
+    delete() {
+        this.onDeleted?.(this);
+    }
+
+    // Subtasks
+
+    subtask(title: string, init: CLITaskInit = {}): CLITask {
+        let child = new CLITask(title, init);
+        this.addTask(child);
+        return child;
+    }
+
+    addTask(child: CLITask) {
+        this.children.push(child);
+        child.parent = this;
+        child.onUpdated = child => this.onUpdated?.(child);
+        child.onLog = (task, message) => this.onLog?.(task, message);
+        child.onDeleted = child => {
+            let index = this.children.indexOf(child);
+            if (index >= 0)
+                this.children.splice(index, 1);
+            this.onUpdated?.(child);
+        };
+
+        return child;
+    }
+
+    // Rendering
+
+    render(renderer: CLITaskList, lineTracker: LineTracker, parentFinished = false) {
+        if (parentFinished && !this.containsLogsOrError)
+            return 0;
+
+        this.renderSelf(renderer, lineTracker);
+        this.renderChildren(renderer, lineTracker, parentFinished || this.isFinishedAndStale);
+        this.renderLogs(renderer, lineTracker);
+    }
+
+    renderNonInteractive(renderer: CLITaskList) {
+        if (this.omitInNonInteractive)
+            return;
+        renderer.drawLine(this.chain.filter(x => !x.omitInNonInteractive).map(p => `${p.statusStyle(p.title)}`).join(' » '));
+    }
+
+    renderSelfAndParents(renderer: CLITaskList) {
+        for (let parent of this.parents)
+            parent.renderSelf(renderer, LineTracker.unbounded);
+        this.renderSelf(renderer, LineTracker.unbounded);
+    }
+
+    renderSelf(renderer: CLITaskList, lineTracker: LineTracker) {
+        renderer.drawLine(
+            `${this.indent ?? ''}`
+            + `${this.statusStyle(`${this.iconForStatus(renderer)} ${this.title}`, this.status)}`
+            + `${this.summarizeCounts(renderer)}`
+            //+ ` DEBUG: ${maxLines}`
+        );
+        lineTracker.consume();
+    }
+
+    renderLogs(renderer: CLITaskList, lineTracker: LineTracker) {
+        let displayedLogs = this.logMessages.slice();
+        while (displayedLogs.length > lineTracker.maxLines)
+            displayedLogs.shift();
+        for (let line of displayedLogs) {
+            this.renderLogLine(renderer, line);
+            lineTracker.consume();
+        }
+    }
+
+    renderLogLine(renderer: CLITaskList, line: string) {
+        renderer.drawLine(`${this.indent ?? ''}  ${styled(style.$dim(line))}`);
+    }
+
+    renderChildren(renderer: CLITaskList, lineTracker: LineTracker, parentFinished = false) {
+        if (lineTracker.maxLines <= 0)
+            return 0;
+
+        let statusOrder = {
+            'error': 0,
+            'finished': 1,
+            'running': 2
+        };
+        this.children.sort((a, b) => statusOrder[a.status] - statusOrder[b.status]);
+
+        let maxDisplayedTasks = lineTracker.maxLines;
+        let displayedTasks = this.children.slice();
+
+        if (parentFinished) {
+            displayedTasks = displayedTasks.filter(x => x.containsLogsOrError);
+        } else {
+            displayedTasks = displayedTasks.filter(x => !x.isFinishedAndStale);
+        }
+
+        // If we're tight on space, elide freshly finished tasks, too.
+        while (displayedTasks.length > maxDisplayedTasks) {
+            let taskIndex = displayedTasks.findIndex(x => x.status === 'finished');
+            if (taskIndex < 0)
+                break;
+
+            displayedTasks.splice(taskIndex, 1);
+        }
+
+        // Elide errors (better to see ongoing progress) ////////////////
+
+        while (displayedTasks.length > maxDisplayedTasks) {
+            let taskIndex = displayedTasks.findIndex(x => x.status === 'error');
+            if (taskIndex < 0)
+                break;
+
+            displayedTasks.splice(taskIndex, 1);
+        }
+
+        // Elide all remaining from end of sorted list until we fit within the maxDisplayedTasks
+
+        if (displayedTasks.length > maxDisplayedTasks)
+            displayedTasks.splice(maxDisplayedTasks, displayedTasks.length);
+
+        let extraLinesForChildren = lineTracker.maxLines - displayedTasks.length;
+        for (let task of displayedTasks) {
+            let childLineTracker = new LineTracker(1 + extraLinesForChildren);
+            task.render(renderer, childLineTracker, parentFinished);
+            lineTracker.consume(childLineTracker.consumed);
+            extraLinesForChildren -= (childLineTracker.consumed - 1);
+            extraLinesForChildren = Math.max(0, extraLinesForChildren);
+        }
+    }
+
+    // Helpers
+
+    private summarizeCounts(r: CLITaskList) {
+        let counts = [
+            this.logMessages.length > 0 ? `${styled(style.$yellow(`• ${this.logMessages.length}`))}` : undefined,
+            this.summarizeCount(r, count(this.children, x => x.status === 'finished'), 'finished'),
+            this.summarizeCount(r, count(this.children, x => x.status === 'error'), 'error'),
+            this.summarizeCount(r, count(this.children, x => x.status === 'running'), 'running'),
+        ].filter(x => x);
+
+        if (counts.length === 0)
+            return '';
+
+        return `  ${styled(style.$dim(counts.join('   ')))}`;
+    }
+
+    private summarizeCount(r: CLITaskList, count: number, status: CLITaskStatus) {
+        if (count <= 0)
+            return undefined;
+        return this.statusStyle(`${this.iconForStatus(r, status)} ${count}`, status);
+    }
+
+    private statusStyle(line: string, status: CLITaskStatus = this.status) {
+        if (status === 'running') {
+            line = styled(style.$bold(style.$blue(line)));
+        } else if (status === 'finished') {
+            line = styled(style.$green(line));
+        } else if (status === 'error') {
+            line = styled(style.$red(line));
+        }
+
+        return line;
+    }
+
+    private iconForStatus(renderer: CLITaskList, status: CLITaskStatus = this.status) {
+        if (this.status === 'error')
+            return CLI_TASK_ERROR_ICON;
+        else if (this.status === 'finished')
+            return CLI_TASK_FINISHED_ICON;
+
+        return renderer.spinner.render();
+    }
+}
+
+export class CLITaskStatusWidget {
+    constructor(private task?: CLITask) {
+        this.start();
+    }
+
+    protected readonly spinner: string[] = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏']
+    private id?: NodeJS.Timeout
+
+    private spinnerPosition = 0
+
+    public spin(): void {
+        this.spinnerPosition = ++this.spinnerPosition % this.spinner.length
+        if (this.task && this.task.status !== 'running') {
+            clearInterval(this.id);
+        }
+    }
+
+    public render(): string {
+        if (this.task?.status === 'error')
+            return CLI_TASK_ERROR_ICON;
+        else if (this.task?.status === 'finished')
+            return CLI_TASK_FINISHED_ICON;
+
+        return this.spinner[this.spinnerPosition]
+    }
+
+    public isRunning(): boolean {
+        return !!this.id
+    }
+
+    public start(cb?: () => void, interval = 100): void {
+        clearInterval(this.id);
+        this.id = setInterval(() => {
+            this.spin()
+
+            if (cb) {
+                cb()
+            }
+        }, interval)
+    }
+
+    public stop(): void {
+        clearInterval(this.id)
+    }
+}
+
+function formatDuration(duration: number) {
+
+    const msPerSec = 1000;
+    const msPerMinute = (1000 * 60);
+    const msPerHour = (1000 * 60 * 60);
+
+    let hours = duration / msPerHour | 0;
+    let minutes = (duration - (hours * msPerHour)) / msPerMinute | 0;
+    let seconds = (duration - (hours * msPerHour + minutes * msPerMinute)) / msPerSec | 0;
+    let ms = duration % 1000;
+
+    return `${zeroPad(hours)}:${zeroPad(minutes)}:${zeroPad(seconds)}:${zeroPad(ms, 3)}`;
+}