@trenchwork/erosolar 1.1.16

package/dist/ui/layout.js

@@ -0,0 +1,184 @@
+import { theme } from './theme.js';
+import { isPlainOutputMode } from './outputMode.js';
+/**
+ * Layout constants for terminal rendering
+ * These ensure consistent behavior across all terminal sizes
+ */
+const MIN_WIDTH = 20; // Minimum usable width (reduced from 42 for narrow terminals)
+const MAX_WIDTH = 120; // Maximum content width for readability
+const ULTRA_NARROW_WIDTH = 30; // Below this, use compact mode
+const DEFAULT_WIDTH = 80; // Standard terminal width fallback
+// eslint-disable-next-line no-control-regex
+const ANSI_REGEX = /\u001B\[[0-9;]*m/g;
+/**
+ * Get terminal columns with robust fallback handling
+ * Handles edge cases: undefined stdout, non-TTY, invalid values
+ */
+export function getTerminalColumns(defaultWidth = DEFAULT_WIDTH) {
+    try {
+        // Check if stdout exists and has columns
+        if (process.stdout &&
+            typeof process.stdout.columns === 'number' &&
+            Number.isFinite(process.stdout.columns) &&
+            process.stdout.columns > 0) {
+            return process.stdout.columns;
+        }
+        // Fallback: try COLUMNS env variable (used in some terminals)
+        const envColumns = process.env['COLUMNS'];
+        if (envColumns) {
+            const parsed = parseInt(envColumns, 10);
+            if (Number.isFinite(parsed) && parsed > 0) {
+                return parsed;
+            }
+        }
+    }
+    catch {
+        // Silently handle any errors (e.g., in restricted environments)
+    }
+    return defaultWidth;
+}
+/**
+ * Check if we're in ultra-narrow terminal mode
+ */
+export function isUltraNarrowMode() {
+    return getTerminalColumns() < ULTRA_NARROW_WIDTH;
+}
+export function getContentWidth() {
+    const columns = getTerminalColumns();
+    const usable = typeof columns === 'number' && Number.isFinite(columns) ? columns - 6 : MAX_WIDTH;
+    return clampWidth(usable, columns);
+}
+export function wrapParagraph(text, width) {
+    const words = text.split(/\s+/).filter(Boolean);
+    if (!words.length) {
+        return [''];
+    }
+    const lines = [];
+    let current = words.shift();
+    for (const word of words) {
+        if (measure(`${current} ${word}`) > width) {
+            lines.push(current);
+            current = word;
+        }
+        else {
+            current += ` ${word}`;
+        }
+    }
+    lines.push(current);
+    return lines;
+}
+export function wrapPreformatted(text, width) {
+    if (!text) {
+        return [''];
+    }
+    const result = [];
+    let remaining = text;
+    while (measure(remaining) > width) {
+        result.push(remaining.slice(0, width));
+        remaining = remaining.slice(width);
+    }
+    if (remaining) {
+        result.push(remaining);
+    }
+    return result.length ? result : [''];
+}
+export function normalizePanelWidth(width) {
+    if (typeof width === 'number' && Number.isFinite(width)) {
+        return clampWidth(width, getTerminalColumns());
+    }
+    return clampWidth(getContentWidth(), getTerminalColumns());
+}
+export function renderPanel(lines, options = {}) {
+    // Check if plain output mode is enabled for clipboard-friendly text
+    if (isPlainOutputMode()) {
+        return renderPlainPanel(lines, options);
+    }
+    const width = normalizePanelWidth(options.width);
+    const accent = options.accentColor ?? theme.primary;
+    const iconSegment = options.icon ? `${options.icon} ` : '';
+    const titleText = options.title ? `${iconSegment}${options.title}` : '';
+    const output = [];
+    // Add empty line for spacing
+    output.push('');
+    if (titleText) {
+        const paddedTitle = padLine(accent(truncate(titleText, width)), width);
+        output.push(paddedTitle);
+        output.push('');
+    }
+    if (!lines.length) {
+        lines = [''];
+    }
+    for (const line of lines) {
+        const padded = padLine(line, width);
+        output.push(padded);
+    }
+    // Add empty line for spacing
+    output.push('');
+    return output.join('\n');
+}
+/**
+ * Renders a panel in plain text mode without box-drawing characters.
+ * Outputs clean text that's clipboard-friendly.
+ */
+function renderPlainPanel(lines, options = {}) {
+    const accent = options.accentColor ?? theme.primary;
+    const iconSegment = options.icon ? `${options.icon} ` : '';
+    const titleText = options.title ? `${iconSegment}${options.title}` : '';
+    const output = [];
+    if (titleText) {
+        output.push(`[${accent(titleText)}]`);
+        output.push('');
+    }
+    if (!lines.length) {
+        lines = [''];
+    }
+    for (const line of lines) {
+        output.push(line.trimEnd());
+    }
+    return output.join('\n');
+}
+export function measure(text) {
+    return stripAnsi(text).length;
+}
+export function stripAnsi(text) {
+    return text.replace(ANSI_REGEX, '');
+}
+/**
+ * Clamp width to valid bounds with robust error handling
+ * Ensures we never return invalid dimensions that could break rendering
+ */
+function clampWidth(value, columns) {
+    // Handle invalid inputs gracefully
+    if (!Number.isFinite(value) || value < 0) {
+        value = DEFAULT_WIDTH;
+    }
+    // Calculate max width based on terminal size
+    const terminalMax = typeof columns === 'number' && Number.isFinite(columns) && columns > 0
+        ? Math.max(MIN_WIDTH, Math.floor(columns - 4)) // Leave margin for borders
+        : MAX_WIDTH;
+    // Ensure min doesn't exceed max
+    const effectiveMin = Math.min(MIN_WIDTH, terminalMax);
+    const effectiveMax = Math.min(MAX_WIDTH, terminalMax);
+    // Clamp to valid range
+    const normalized = Math.floor(value);
+    return Math.max(effectiveMin, Math.min(normalized, effectiveMax));
+}
+export function padLine(text, width) {
+    const visible = measure(text);
+    if (visible === width) {
+        return text;
+    }
+    if (visible > width) {
+        return truncate(text, width);
+    }
+    return `${text}${' '.repeat(width - visible)}`;
+}
+export function truncate(text, width) {
+    const visible = stripAnsi(text);
+    if (visible.length <= width) {
+        return text;
+    }
+    const truncated = visible.slice(0, Math.max(1, width - 1));
+    return `${truncated}…`;
+}
+//# sourceMappingURL=layout.js.map

package/dist/ui/layout.js.map

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

package/dist/ui/outputMode.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Output mode configuration for terminal UI
+ *
+ * Controls whether to use decorative box-drawing characters or plain text.
+ * Plain mode outputs clipboard-friendly text without Unicode borders.
+ * Automatically enabled in CI or non-interactive shells; override with EROSOLAR_PLAIN_OUTPUT=true.
+ *
+ * Environment Variables:
+ * - EROSOLAR_PLAIN_OUTPUT: Set to 'true', '1', 'yes', or 'on' to force plain mode
+ * - CI: Automatically enables plain mode when set
+ * - TERM: Checked for 'dumb' terminals which get plain mode
+ * - NO_COLOR: If set, enables plain mode (respects https://no-color.org/)
+ */
+/**
+ * Check if plain output mode is enabled.
+ * Plain mode outputs text without box-drawing characters for clean clipboard copying.
+ */
+export declare function isPlainOutputMode(): boolean;
+/**
+ * Check if color output is enabled.
+ * Respects NO_COLOR environment variable (https://no-color.org/)
+ */
+export declare function isColorEnabled(): boolean;
+/**
+ * Override the plain output mode setting (useful for testing)
+ */
+export declare function setPlainOutputMode(enabled: boolean): void;
+/**
+ * Override the color output mode setting (useful for testing)
+ */
+export declare function setColorEnabled(enabled: boolean): void;
+/**
+ * Reset plain output mode to check environment variable again
+ */
+export declare function resetPlainOutputMode(): void;
+/**
+ * Reset color mode to check environment variable again
+ */
+export declare function resetColorEnabled(): void;
+/**
+ * Reset all output mode settings
+ */
+export declare function resetOutputModes(): void;
+/**
+ * Detect Windows PowerShell ISE. ISE reports `isTTY=true` but implements
+ * almost no ANSI; rich UI output appears as literal escape text. Three
+ * signals cover the deployed install base:
+ *
+ *   - `PSModulePath` contains "ISE"
+ *   - `EROSOLAR_FORCE_PSISE` (test/manual override)
+ *   - the resize event never fires; we can't detect that synchronously
+ *     here, so we lean on the env signals
+ *
+ * Returns true ONLY when running in ISE — Windows Terminal,
+ * PowerShell.exe, and pwsh are all unaffected.
+ */
+export declare function isPowerShellIse(): boolean;
+//# sourceMappingURL=outputMode.d.ts.map

package/dist/ui/outputMode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outputMode.d.ts","sourceRoot":"","sources":["../../src/ui/outputMode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CA2E3C;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAgCxC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEzD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEtD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAYzC"}

package/dist/ui/outputMode.js

@@ -0,0 +1,179 @@
+/**
+ * Output mode configuration for terminal UI
+ *
+ * Controls whether to use decorative box-drawing characters or plain text.
+ * Plain mode outputs clipboard-friendly text without Unicode borders.
+ * Automatically enabled in CI or non-interactive shells; override with EROSOLAR_PLAIN_OUTPUT=true.
+ *
+ * Environment Variables:
+ * - EROSOLAR_PLAIN_OUTPUT: Set to 'true', '1', 'yes', or 'on' to force plain mode
+ * - CI: Automatically enables plain mode when set
+ * - TERM: Checked for 'dumb' terminals which get plain mode
+ * - NO_COLOR: If set, enables plain mode (respects https://no-color.org/)
+ */
+let _plainMode = null;
+let _colorEnabled = null;
+/**
+ * Check if plain output mode is enabled.
+ * Plain mode outputs text without box-drawing characters for clean clipboard copying.
+ */
+export function isPlainOutputMode() {
+    if (_plainMode !== null) {
+        return _plainMode;
+    }
+    try {
+        // Check explicit environment override first
+        const envValue = process.env['EROSOLAR_PLAIN_OUTPUT'];
+        if (envValue !== undefined) {
+            const envEnabled = ['true', '1', 'yes', 'on'].includes(envValue.toLowerCase());
+            if (envEnabled) {
+                _plainMode = true;
+                return _plainMode;
+            }
+            // Also check for explicit disable
+            const envDisabled = ['false', '0', 'no', 'off'].includes(envValue.toLowerCase());
+            if (envDisabled) {
+                _plainMode = false;
+                return _plainMode;
+            }
+        }
+        // NO_COLOR (https://no-color.org) — vision-sensitivity users, log
+        // scrapers, accessibility tools all rely on this signal. Per the spec
+        // it disables not just colours but also decorative output, so it
+        // forces plain mode here in addition to gating chalk in isColorEnabled.
+        if (process.env['NO_COLOR'] !== undefined && process.env['NO_COLOR'] !== '') {
+            _plainMode = true;
+            return _plainMode;
+        }
+        // Check for dumb terminal
+        const term = process.env['TERM'];
+        if (term === 'dumb') {
+            _plainMode = true;
+            return _plainMode;
+        }
+        // PowerShell ISE reports isTTY=true but implements a tiny subset of
+        // ANSI; overlay output appears as literal `[?25l[2J` text. Fall back
+        // to plain mode so output is at least readable there.
+        if (isPowerShellIse()) {
+            _plainMode = true;
+            return _plainMode;
+        }
+        // Check for CI environments
+        const isCi = Boolean(process.env['CI'] ||
+            process.env['GITHUB_ACTIONS'] ||
+            process.env['GITLAB_CI'] ||
+            process.env['CIRCLECI'] ||
+            process.env['TRAVIS'] ||
+            process.env['JENKINS_URL']);
+        // Check TTY status safely
+        const isTty = Boolean(process.stdout?.isTTY &&
+            process.stdin?.isTTY);
+        // FORCE_COLOR overrides CI detection — some CIs (Buildkite, modern
+        // GitHub Actions log groups) handle ANSI fine and operators set this
+        // explicitly to keep colour in captured logs.
+        const forceColor = process.env['FORCE_COLOR'] !== undefined && process.env['FORCE_COLOR'] !== '0';
+        // Default to plain logging in non-interactive/CI environments; rich UI only in TTY sessions.
+        _plainMode = !isTty || (isCi && !forceColor);
+    }
+    catch {
+        // If anything fails, default to plain mode for safety
+        _plainMode = true;
+    }
+    return _plainMode;
+}
+/**
+ * Check if color output is enabled.
+ * Respects NO_COLOR environment variable (https://no-color.org/)
+ */
+export function isColorEnabled() {
+    if (_colorEnabled !== null) {
+        return _colorEnabled;
+    }
+    try {
+        // NO_COLOR takes precedence (https://no-color.org/)
+        if (process.env['NO_COLOR'] !== undefined && process.env['NO_COLOR'] !== '') {
+            _colorEnabled = false;
+            return _colorEnabled;
+        }
+        // FORCE_COLOR enables colors (overrides every disable below).
+        if (process.env['FORCE_COLOR'] !== undefined && process.env['FORCE_COLOR'] !== '0') {
+            _colorEnabled = true;
+            return _colorEnabled;
+        }
+        // If plain mode is on (dumb terminal, ISE, CI without FORCE_COLOR,
+        // non-TTY), don't emit colour either — keeps captured logs clean.
+        if (isPlainOutputMode()) {
+            _colorEnabled = false;
+            return _colorEnabled;
+        }
+        // Color enabled in TTY by default
+        _colorEnabled = Boolean(process.stdout?.isTTY);
+    }
+    catch {
+        _colorEnabled = false;
+    }
+    return _colorEnabled;
+}
+/**
+ * Override the plain output mode setting (useful for testing)
+ */
+export function setPlainOutputMode(enabled) {
+    _plainMode = enabled;
+}
+/**
+ * Override the color output mode setting (useful for testing)
+ */
+export function setColorEnabled(enabled) {
+    _colorEnabled = enabled;
+}
+/**
+ * Reset plain output mode to check environment variable again
+ */
+export function resetPlainOutputMode() {
+    _plainMode = null;
+}
+/**
+ * Reset color mode to check environment variable again
+ */
+export function resetColorEnabled() {
+    _colorEnabled = null;
+}
+/**
+ * Reset all output mode settings
+ */
+export function resetOutputModes() {
+    _plainMode = null;
+    _colorEnabled = null;
+}
+/**
+ * Detect Windows PowerShell ISE. ISE reports `isTTY=true` but implements
+ * almost no ANSI; rich UI output appears as literal escape text. Three
+ * signals cover the deployed install base:
+ *
+ *   - `PSModulePath` contains "ISE"
+ *   - `EROSOLAR_FORCE_PSISE` (test/manual override)
+ *   - the resize event never fires; we can't detect that synchronously
+ *     here, so we lean on the env signals
+ *
+ * Returns true ONLY when running in ISE — Windows Terminal,
+ * PowerShell.exe, and pwsh are all unaffected.
+ */
+export function isPowerShellIse() {
+    if (process.platform !== 'win32')
+        return false;
+    try {
+        if (process.env['EROSOLAR_FORCE_PSISE'] === '1')
+            return true;
+        const psModulePath = process.env['PSModulePath'] || '';
+        if (/\bISE\b/i.test(psModulePath))
+            return true;
+        // Some ISE installs set this; harmless to check elsewhere.
+        if ((process.env['PROCESSOR_HOST'] || '').includes('ISE'))
+            return true;
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=outputMode.js.map

package/dist/ui/outputMode.js.map

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

package/dist/ui/overlay/OverlayManager.d.ts

@@ -0,0 +1,105 @@
+/**
+ * OverlayManager - Manages terminal overlay rendering with ANSI escape sequences
+ * Provides sophisticated overlay composition and rendering capabilities
+ */
+export interface OverlayRegion {
+    content: string;
+    height: number;
+    priority: number;
+}
+export interface OverlayLayout {
+    regions: {
+        status?: OverlayRegion;
+        progress?: OverlayRegion;
+        hints?: OverlayRegion;
+        alerts?: OverlayRegion;
+    };
+    maxHeight: number;
+}
+export interface OverlayOptions {
+    adaptToTerminalSize: boolean;
+    smoothTransitions: boolean;
+    preserveCursor: boolean;
+}
+export declare class OverlayManager {
+    private currentLayout;
+    private renderedRows;
+    private allocatedRows;
+    private isVisible;
+    private isEnabled;
+    private outputGuardCount;
+    private writeStream;
+    private options;
+    private readonly SAVE_CURSOR;
+    private readonly RESTORE_CURSOR;
+    private readonly CLEAR_LINE;
+    private readonly MOVE_TO_COLUMN;
+    private readonly MOVE_UP;
+    constructor(writeStream: NodeJS.WriteStream, options?: Partial<OverlayOptions>);
+    /**
+     * Set the overlay layout to render
+     */
+    setLayout(layout: OverlayLayout | null): void;
+    /**
+     * Show the overlay if enabled and not in output guard
+     */
+    show(): void;
+    /**
+     * Hide the overlay
+     */
+    hide(): void;
+    /**
+     * Begin output operation (increments guard counter)
+     */
+    beginOutput(): void;
+    /**
+     * End output operation (decrements guard counter)
+     */
+    endOutput(): void;
+    /**
+     * Enable or disable overlay rendering
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * Update a specific region in the layout
+     */
+    updateRegion(regionName: keyof OverlayLayout['regions'], region: OverlayRegion | undefined): void;
+    /**
+     * Compose the overlay content from all regions
+     */
+    private composeOverlay;
+    /**
+     * Render the overlay to the terminal
+     */
+    private render;
+    /**
+     * Clear the rendered overlay from the terminal
+     */
+    private clearRenderedOverlay;
+    /**
+     * Get maximum overlay height based on terminal size
+     */
+    private getMaxOverlayHeight;
+    /**
+     * Truncate a line to fit terminal width
+     */
+    private truncateLine;
+    /**
+     * Force a refresh of the overlay
+     */
+    refresh(): void;
+    /**
+     * Get current overlay state
+     */
+    getState(): {
+        isVisible: boolean;
+        isEnabled: boolean;
+        renderedRows: number;
+        hasLayout: boolean;
+    };
+    /**
+     * Clean up resources
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=OverlayManager.d.ts.map

package/dist/ui/overlay/OverlayManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OverlayManager.d.ts","sourceRoot":"","sources":["../../../src/ui/overlay/OverlayManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE;QACP,MAAM,CAAC,EAAE,aAAa,CAAC;QACvB,QAAQ,CAAC,EAAE,aAAa,CAAC;QACzB,KAAK,CAAC,EAAE,aAAa,CAAC;QACtB,MAAM,CAAC,EAAE,aAAa,CAAC;KACxB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,gBAAgB,CAAa;IACrC,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,OAAO,CAAiB;IAGhC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAa;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAe;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqC;IACpE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;gBAG7D,WAAW,EAAE,MAAM,CAAC,WAAW,EAC/B,OAAO,GAAE,OAAO,CAAC,cAAc,CAAM;IAWvC;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI;IAa7C;;OAEG;IACH,IAAI,IAAI,IAAI;IASZ;;OAEG;IACH,IAAI,IAAI,IAAI;IASZ;;OAEG;IACH,WAAW,IAAI,IAAI;IAOnB;;OAEG;IACH,SAAS,IAAI,IAAI;IAOjB;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAalC;;OAEG;IACH,YAAY,CACV,UAAU,EAAE,MAAM,aAAa,CAAC,SAAS,CAAC,EAC1C,MAAM,EAAE,aAAa,GAAG,SAAS,GAChC,IAAI;IAeP;;OAEG;IACH,OAAO,CAAC,cAAc;IA6BtB;;OAEG;IACH,OAAO,CAAC,MAAM;IA8Dd;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAuC5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAU3B;;OAEG;IACH,OAAO,CAAC,YAAY;IA0CpB;;OAEG;IACH,OAAO,IAAI,IAAI;IAMf;;OAEG;IACH,QAAQ,IAAI;QACV,SAAS,EAAE,OAAO,CAAC;QACnB,SAAS,EAAE,OAAO,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,OAAO,CAAC;KACpB;IASD;;OAEG;IACH,OAAO,IAAI,IAAI;CAIhB"}