@quenty/cli-output-helpers 1.10.1 → 1.12.0

package/dist/reporting/summary-table-reporter.js

@@ -1,6 +1,7 @@
 import { OutputHelper } from '../outputHelper.js';
 import { formatDurationMs } from '../cli-utils.js';
 import { BaseReporter } from './reporter.js';
+import { formatTable } from './format-table.js';
 import { formatProgressResult, isEmptyTestRun } from './progress-format.js';
 /**
  * Prints a final summary table of all results when jobs complete.
@@ -25,40 +26,27 @@ export class SummaryTableReporter extends BaseReporter {
         const failures = this._state.getFailures();
         const passed = results.length - failures.length;
         const durationMs = Date.now() - this._state.startTimeMs;
-        const STATUS_WIDTH = 26;
-        console.log('');
-        console.log('Package'.padEnd(40) + 'Status'.padEnd(STATUS_WIDTH) + 'Duration');
-        console.log('─'.repeat(40 + STATUS_WIDTH + 8));
         let emptyRunCount = 0;
-        for (const result of results) {
-            const progressText = formatProgressResult(result.progressSummary);
-            const empty = isEmptyTestRun(result.progressSummary);
-            if (empty)
-                emptyRunCount++;
-            let label;
-            if (result.success) {
-                label = progressText ? `${this._successLabel} ${progressText}` : this._successLabel;
-            }
-            else {
-                const failedPhase = result.failedPhase;
-                label = failedPhase
-                    ? `${this._failureLabel} at ${failedPhase}`
-                    : this._failureLabel;
-            }
-            // Pad the plain text BEFORE wrapping in ANSI so padEnd counts visible chars
-            const paddedLabel = label.padEnd(STATUS_WIDTH);
-            let status;
-            if (result.success) {
-                status = empty
-                    ? OutputHelper.formatWarning(paddedLabel)
-                    : OutputHelper.formatSuccess(paddedLabel);
-            }
-            else {
-                status = OutputHelper.formatError(paddedLabel);
-            }
-            const duration = OutputHelper.formatDim(formatDurationMs(result.durationMs));
-            console.log(result.packageName.padEnd(40) + status + duration);
-        }
+        const columns = [
+            {
+                header: 'Package',
+                value: (r) => r.packageName,
+                minWidth: 40,
+            },
+            {
+                header: 'Status',
+                value: (r) => this._statusLabel(r),
+                format: (label, r) => this._colorStatus(label, r, () => emptyRunCount++),
+                minWidth: 26,
+            },
+            {
+                header: 'Duration',
+                value: (r) => formatDurationMs(r.durationMs),
+                format: (v) => OutputHelper.formatDim(v),
+            },
+        ];
+        console.log('');
+        console.log(formatTable(results, columns));
         console.log('');
         const passedText = OutputHelper.formatSuccess(`${passed} passed`);
         const failedText = failures.length > 0
@@ -70,5 +58,28 @@ export class SummaryTableReporter extends BaseReporter {
             console.log(OutputHelper.formatWarning(`⚠ ${emptyRunCount} package(s) ran 0 tests — check test discovery`));
         }
     }
+    _statusLabel(result) {
+        if (result.success) {
+            const progressText = formatProgressResult(result.progressSummary);
+            return progressText
+                ? `${this._successLabel} ${progressText}`
+                : this._successLabel;
+        }
+        const failedPhase = result.failedPhase;
+        return failedPhase
+            ? `${this._failureLabel} at ${failedPhase}`
+            : this._failureLabel;
+    }
+    _colorStatus(label, result, countEmpty) {
+        if (result.success) {
+            const empty = isEmptyTestRun(result.progressSummary);
+            if (empty)
+                countEmpty();
+            return empty
+                ? OutputHelper.formatWarning(label)
+                : OutputHelper.formatSuccess(label);
+        }
+        return OutputHelper.formatError(label);
+    }
 }
 //# sourceMappingURL=summary-table-reporter.js.map

package/dist/reporting/summary-table-reporter.js.map

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

package/dist/reporting/watch-renderer.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Live-updating renderer for watch/monitoring commands. In TTY mode,
+ * rewrites output in-place using cursor control. In non-TTY mode,
+ * appends new output only when it changes.
+ */
+export interface WatchRendererOptions {
+    intervalMs?: number;
+    rewrite?: boolean;
+}
+export interface WatchRenderer {
+    start(): void;
+    update(): void;
+    stop(): void;
+}
+export declare function createWatchRenderer(render: () => string, options?: WatchRendererOptions): WatchRenderer;
+//# sourceMappingURL=watch-renderer.d.ts.map

package/dist/reporting/watch-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-renderer.d.ts","sourceRoot":"","sources":["../../src/reporting/watch-renderer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,IAAI,IAAI,CAAC;IACd,MAAM,IAAI,IAAI,CAAC;IACf,IAAI,IAAI,IAAI,CAAC;CACd;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,MAAM,EACpB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,aAAa,CA+Gf"}

package/dist/reporting/watch-renderer.js

@@ -0,0 +1,110 @@
+/**
+ * Live-updating renderer for watch/monitoring commands. In TTY mode,
+ * rewrites output in-place using cursor control. In non-TTY mode,
+ * appends new output only when it changes.
+ */
+export function createWatchRenderer(render, options) {
+    const intervalMs = options?.intervalMs ?? 1000;
+    const rewrite = options?.rewrite ?? (process.stdout.isTTY ? true : false);
+    let _intervalHandle = null;
+    let _previousOutput = '';
+    let _previousLineCount = 0;
+    function _render() {
+        const output = render();
+        if (rewrite) {
+            // TTY rewrite mode: move cursor up and clear previous output
+            if (_previousLineCount > 0) {
+                process.stdout.write(`\x1b[${_previousLineCount}A\x1b[J`);
+            }
+            process.stdout.write(output + '\n');
+            _previousLineCount = output.split('\n').length;
+        }
+        else {
+            // Non-TTY append mode: only write when content changes
+            if (output !== _previousOutput) {
+                process.stdout.write(output + '\n');
+            }
+        }
+        _previousOutput = output;
+    }
+    function _startInterval() {
+        _intervalHandle = setInterval(_render, intervalMs);
+    }
+    function _clearInterval() {
+        if (_intervalHandle !== null) {
+            clearInterval(_intervalHandle);
+            _intervalHandle = null;
+        }
+    }
+    let _cursorHidden = false;
+    let _signalsBound = false;
+    function _showCursor() {
+        if (_cursorHidden) {
+            _cursorHidden = false;
+            process.stdout.write('\x1b[?25h');
+        }
+    }
+    function _onSignal(signal) {
+        _clearInterval();
+        _showCursor();
+        // Restore default behavior so the process actually exits
+        process.removeListener('SIGINT', _onSignal);
+        process.removeListener('SIGTERM', _onSignal);
+        process.kill(process.pid, signal);
+    }
+    function _bindSignals() {
+        if (_signalsBound)
+            return;
+        _signalsBound = true;
+        process.once('SIGINT', _onSignal);
+        process.once('SIGTERM', _onSignal);
+    }
+    function _unbindSignals() {
+        if (!_signalsBound)
+            return;
+        _signalsBound = false;
+        process.removeListener('SIGINT', _onSignal);
+        process.removeListener('SIGTERM', _onSignal);
+    }
+    return {
+        start() {
+            if (rewrite) {
+                process.stdout.write('\x1b[?25l'); // hide cursor
+                _cursorHidden = true;
+                _bindSignals();
+            }
+            try {
+                _render();
+            }
+            catch (err) {
+                _showCursor();
+                _unbindSignals();
+                throw err;
+            }
+            _startInterval();
+        },
+        update() {
+            _clearInterval();
+            try {
+                _render();
+            }
+            catch (err) {
+                _showCursor();
+                _unbindSignals();
+                throw err;
+            }
+            _startInterval();
+        },
+        stop() {
+            _clearInterval();
+            try {
+                _render();
+            }
+            finally {
+                _showCursor();
+                _unbindSignals();
+            }
+        },
+    };
+}
+//# sourceMappingURL=watch-renderer.js.map

package/dist/reporting/watch-renderer.js.map

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

package/dist/reporting/watch-renderer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=watch-renderer.test.d.ts.map

package/dist/reporting/watch-renderer.test.d.ts.map

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

package/dist/reporting/watch-renderer.test.js

@@ -0,0 +1,103 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { createWatchRenderer } from './watch-renderer.js';
+describe('createWatchRenderer', () => {
+    let writes;
+    beforeEach(() => {
+        vi.useFakeTimers();
+        writes = [];
+        vi.spyOn(process.stdout, 'write').mockImplementation(((chunk) => {
+            writes.push(typeof chunk === 'string' ? chunk : chunk.toString());
+            return true;
+        }));
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+        vi.restoreAllMocks();
+    });
+    it('start renders immediately and stop clears interval with final render', () => {
+        let count = 0;
+        const renderer = createWatchRenderer(() => `frame-${count++}`, {
+            rewrite: false,
+            intervalMs: 1000,
+        });
+        renderer.start();
+        expect(writes).toEqual(['frame-0\n']);
+        renderer.stop();
+        // stop does a final render
+        expect(writes).toEqual(['frame-0\n', 'frame-1\n']);
+        // After stop, no more renders should happen
+        writes.length = 0;
+        vi.advanceTimersByTime(3000);
+        expect(writes).toEqual([]);
+    });
+    it('update forces immediate render and resets interval', () => {
+        let count = 0;
+        const renderer = createWatchRenderer(() => `frame-${count++}`, {
+            rewrite: false,
+            intervalMs: 1000,
+        });
+        renderer.start(); // frame-0
+        expect(writes).toEqual(['frame-0\n']);
+        // Advance 500ms, then force update
+        vi.advanceTimersByTime(500);
+        renderer.update(); // frame-1 (forced)
+        expect(writes).toEqual(['frame-0\n', 'frame-1\n']);
+        // Advance 500ms more — the old interval would have fired at 1000ms total,
+        // but update() reset it, so nothing fires yet
+        vi.advanceTimersByTime(500);
+        expect(writes).toEqual(['frame-0\n', 'frame-1\n']);
+        // Advance another 500ms (1000ms since update), new interval fires
+        vi.advanceTimersByTime(500);
+        expect(writes).toEqual(['frame-0\n', 'frame-1\n', 'frame-2\n']);
+        renderer.stop();
+    });
+    it('non-TTY mode only writes when content changes', () => {
+        let value = 'same';
+        const renderer = createWatchRenderer(() => value, {
+            rewrite: false,
+            intervalMs: 100,
+        });
+        renderer.start(); // writes "same"
+        expect(writes).toEqual(['same\n']);
+        // Same content on next interval — should NOT write
+        vi.advanceTimersByTime(100);
+        expect(writes).toEqual(['same\n']);
+        // Change content — should write
+        value = 'different';
+        vi.advanceTimersByTime(100);
+        expect(writes).toEqual(['same\n', 'different\n']);
+        renderer.stop();
+    });
+    it('stop clears the interval so no more renders happen', () => {
+        let count = 0;
+        const renderer = createWatchRenderer(() => `f-${count++}`, {
+            rewrite: false,
+            intervalMs: 100,
+        });
+        renderer.start(); // f-0
+        renderer.stop(); // f-1 (final)
+        writes.length = 0;
+        vi.advanceTimersByTime(1000);
+        expect(writes).toEqual([]);
+    });
+    it('TTY rewrite mode hides/shows cursor and uses escape codes', () => {
+        let count = 0;
+        const renderer = createWatchRenderer(() => `line-${count++}`, {
+            rewrite: true,
+            intervalMs: 100,
+        });
+        renderer.start();
+        // Should have written hide-cursor + first frame
+        expect(writes[0]).toBe('\x1b[?25l');
+        expect(writes[1]).toBe('line-0\n');
+        // Advance to trigger second render — should include cursor-up + clear
+        vi.advanceTimersByTime(100);
+        const cursorUpWrite = writes.find((w) => w.includes('\x1b[1A\x1b[J'));
+        expect(cursorUpWrite).toBeDefined();
+        renderer.stop();
+        // Should have written show-cursor
+        const lastWrite = writes[writes.length - 1];
+        expect(lastWrite).toBe('\x1b[?25h');
+    });
+});
+//# sourceMappingURL=watch-renderer.test.js.map

package/dist/reporting/watch-renderer.test.js.map

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

package/dist/reporting/watch-result-reporter.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Live-redraw reporter for watch-mode commands. Wraps the WatchRenderer —
+ * stores the latest result and redraws via cursor manipulation.
+ *
+ * The first onResult starts the underlying renderer; subsequent calls update
+ * it. stopAsync stops the renderer and restores the cursor.
+ */
+import { BaseResultReporter } from './result-reporter.js';
+export interface WatchResultReporterOptions<T> {
+    render: (result: T) => string;
+    intervalMs?: number;
+}
+export declare class WatchResultReporter<T = unknown> extends BaseResultReporter<T> {
+    private _renderer;
+    private _latest;
+    private _started;
+    constructor(options: WatchResultReporterOptions<T>);
+    onResult(result: T): void;
+    stopAsync(): Promise<void>;
+}
+//# sourceMappingURL=watch-result-reporter.d.ts.map

package/dist/reporting/watch-result-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-result-reporter.d.ts","sourceRoot":"","sources":["../../src/reporting/watch-result-reporter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D,MAAM,WAAW,0BAA0B,CAAC,CAAC;IAC3C,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,mBAAmB,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,kBAAkB,CAAC,CAAC,CAAC;IACzE,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE,0BAA0B,CAAC,CAAC,CAAC;IAQzC,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI;IAUnB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CAK1C"}

package/dist/reporting/watch-result-reporter.js

@@ -0,0 +1,34 @@
+/**
+ * Live-redraw reporter for watch-mode commands. Wraps the WatchRenderer —
+ * stores the latest result and redraws via cursor manipulation.
+ *
+ * The first onResult starts the underlying renderer; subsequent calls update
+ * it. stopAsync stops the renderer and restores the cursor.
+ */
+import { BaseResultReporter } from './result-reporter.js';
+import { createWatchRenderer } from './watch-renderer.js';
+export class WatchResultReporter extends BaseResultReporter {
+    _renderer;
+    _latest;
+    _started = false;
+    constructor(options) {
+        super();
+        this._renderer = createWatchRenderer(() => (this._latest === undefined ? '' : options.render(this._latest)), { intervalMs: options.intervalMs });
+    }
+    onResult(result) {
+        this._latest = result;
+        if (!this._started) {
+            this._started = true;
+            this._renderer.start();
+        }
+        else {
+            this._renderer.update();
+        }
+    }
+    async stopAsync() {
+        if (this._started) {
+            this._renderer.stop();
+        }
+    }
+}
+//# sourceMappingURL=watch-result-reporter.js.map

package/dist/reporting/watch-result-reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-result-reporter.js","sourceRoot":"","sources":["../../src/reporting/watch-result-reporter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAsB,MAAM,qBAAqB,CAAC;AAO9E,MAAM,OAAO,mBAAiC,SAAQ,kBAAqB;IACjE,SAAS,CAAgB;IACzB,OAAO,CAAgB;IACvB,QAAQ,GAAG,KAAK,CAAC;IAEzB,YAAY,OAAsC;QAChD,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,SAAS,GAAG,mBAAmB,CAClC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,EACtE,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CACnC,CAAC;IACJ,CAAC;IAEQ,QAAQ,CAAC,MAAS;QACzB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACrB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;IAEQ,KAAK,CAAC,SAAS;QACtB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;CACF"}

package/dist/reporting/watch-result-reporter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=watch-result-reporter.test.d.ts.map

package/dist/reporting/watch-result-reporter.test.d.ts.map

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

package/dist/reporting/watch-result-reporter.test.js

@@ -0,0 +1,37 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { WatchResultReporter } from './watch-result-reporter.js';
+describe('WatchResultReporter', () => {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let writeSpy;
+    const originalIsTTY = process.stdout.isTTY;
+    beforeEach(() => {
+        writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+        writeSpy.mockRestore();
+        process.stdout.isTTY = originalIsTTY;
+    });
+    it('starts the renderer on the first onResult and updates on subsequent calls', () => {
+        process.stdout.isTTY = false;
+        const renderFn = vi.fn((r) => `v=${r.v}`);
+        const reporter = new WatchResultReporter({
+            render: renderFn,
+            intervalMs: 1000,
+        });
+        reporter.onResult({ v: 1 });
+        expect(renderFn).toHaveBeenCalledWith({ v: 1 });
+        expect(writeSpy).toHaveBeenCalled();
+        reporter.onResult({ v: 2 });
+        expect(renderFn).toHaveBeenCalledWith({ v: 2 });
+    });
+    it('stopAsync without any onResult does not start the renderer', async () => {
+        process.stdout.isTTY = false;
+        const renderFn = vi.fn(() => '');
+        const reporter = new WatchResultReporter({ render: renderFn });
+        await reporter.stopAsync();
+        expect(renderFn).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=watch-result-reporter.test.js.map

package/dist/reporting/watch-result-reporter.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-result-reporter.test.js","sourceRoot":"","sources":["../../src/reporting/watch-result-reporter.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,8DAA8D;IAC9D,IAAI,QAAa,CAAC;IAClB,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IAE3C,UAAU,CAAC,GAAG,EAAE;QACd,QAAQ,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAC5E,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,aAAa,EAAE,CAAC;QACnB,QAAQ,CAAC,WAAW,EAAE,CAAC;QACvB,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,aAAa,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2EAA2E,EAAE,GAAG,EAAE;QACnF,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;QAC7B,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAgB,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,IAAI,mBAAmB,CAAgB;YACtD,MAAM,EAAE,QAAQ;YAChB,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC;QAEH,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC5B,MAAM,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAChD,MAAM,CAAC,QAAQ,CAAC,CAAC,gBAAgB,EAAE,CAAC;QAEpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC5B,MAAM,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC1E,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;QAC7B,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QACjC,MAAM,QAAQ,GAAG,IAAI,mBAAmB,CAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QAExE,MAAM,QAAQ,CAAC,SAAS,EAAE,CAAC;QAC3B,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quenty/cli-output-helpers",
-  "version": "1.10.1",
+  "version": "1.12.0",
   "description": "Helpers to generate Nevermore package and game templates",
   "type": "module",
   "keywords": [
@@ -59,5 +59,5 @@
   "engines": {
     "node": ">=16"
   },
-  "gitHead": "ab12ae11f52faf00116949383563934b2853b449"
+  "gitHead": "5cba15660c2856169fd0362e1eeeca4c260029c2"
 }

package/src/outputHelper.ts

@@ -69,8 +69,7 @@ export class OutputHelper {
     return chalk.greenBright(message);
   }
 
-  private static _hasAnsi = (text: string): boolean =>
-    text.includes('\x1b[');
+  private static _hasAnsi = (text: string): boolean => text.includes('\x1b[');
 
   /** Strip ANSI escape codes from terminal output. */
   public static stripAnsi = (text: string): string =>
@@ -135,6 +134,14 @@ export class OutputHelper {
     this._verbose = verbose;
   }
 
+  /**
+   * Returns the current verbose flag. Useful for handlers that need to
+   * forward the global `--verbose` setting to downstream APIs.
+   */
+  public static isVerbose(): boolean {
+    return this._verbose;
+  }
+
   /**
    * Logs a verbose/intermediate message. Suppressed when verbose is false.
    * When running inside a buffered context (see runBuffered), messages are
@@ -145,7 +152,9 @@ export class OutputHelper {
       return;
     }
 
-    const formatted = this._hasAnsi(message) ? message : this.formatDim(message);
+    const formatted = this._hasAnsi(message)
+      ? message
+      : this.formatDim(message);
     const buffer = _outputStorage.getStore();
     if (buffer) {
       buffer.lines.push(formatted);

package/src/reporting/build-result-reporter.test.ts

@@ -0,0 +1,48 @@
+import { describe, it, expect } from 'vitest';
+import { buildResultReporter } from './build-result-reporter.js';
+import { StdoutResultReporter } from './stdout-result-reporter.js';
+import { FileResultReporter } from './file-result-reporter.js';
+import { WatchResultReporter } from './watch-result-reporter.js';
+
+describe('buildResultReporter', () => {
+  const render = (r: unknown) => String(r);
+
+  it('returns a StdoutResultReporter by default', () => {
+    const reporter = buildResultReporter({ render });
+    expect(reporter).toBeInstanceOf(StdoutResultReporter);
+  });
+
+  it('returns a FileResultReporter when outputPath is set', () => {
+    const reporter = buildResultReporter({
+      outputPath: '/tmp/out.txt',
+      render,
+    });
+    expect(reporter).toBeInstanceOf(FileResultReporter);
+  });
+
+  it('returns a WatchResultReporter when watch is true and no outputPath', () => {
+    const reporter = buildResultReporter({ watch: true, render });
+    expect(reporter).toBeInstanceOf(WatchResultReporter);
+  });
+
+  it('outputPath wins over watch', () => {
+    const reporter = buildResultReporter({
+      outputPath: '/tmp/out.txt',
+      watch: true,
+      render,
+    });
+    expect(reporter).toBeInstanceOf(FileResultReporter);
+  });
+
+  it('treats empty-string outputPath as a file destination', () => {
+    // Empty string is a valid (if degenerate) path — selection is by
+    // presence of the field, not truthiness.
+    const reporter = buildResultReporter({ outputPath: '', render });
+    expect(reporter).toBeInstanceOf(FileResultReporter);
+  });
+
+  it('returns Stdout when watch is false and no outputPath', () => {
+    const reporter = buildResultReporter({ watch: false, render });
+    expect(reporter).toBeInstanceOf(StdoutResultReporter);
+  });
+});