erosolar-cli 2.1.172 → 2.1.173

package/dist/ui/telemetry/UITelemetry.js

@@ -0,0 +1,446 @@
+/**
+ * UITelemetry - Collects and tracks UI performance metrics and user interactions
+ * Provides insights into UI responsiveness, user behavior, and system performance
+ */
+import { EventEmitter } from 'events';
+import { performance } from 'perf_hooks';
+export class UITelemetry extends EventEmitter {
+    config;
+    events = [];
+    metrics = [];
+    interactions = [];
+    renderMetrics = [];
+    errors = [];
+    sessionStart;
+    marks = new Map();
+    measures = new Map();
+    flushTimer = null;
+    frameCounter = {
+        frames: 0,
+        dropped: 0,
+        lastFrame: performance.now(),
+    };
+    constructor(config = {}) {
+        super();
+        this.config = {
+            enabled: true,
+            bufferSize: 10000,
+            flushInterval: 60000, // 1 minute
+            captureStackTraces: false,
+            anonymize: true,
+            performanceThresholds: {
+                renderTime: 16, // 60 FPS target
+                responseTime: 100, // 100ms max response time
+                framerate: 30, // Minimum acceptable framerate
+                memory: 500 * 1024 * 1024, // 500MB memory threshold
+            },
+            ...config,
+        };
+        this.sessionStart = Date.now();
+        if (this.config.enabled) {
+            this.startCollection();
+        }
+    }
+    /**
+     * Start telemetry collection
+     */
+    startCollection() {
+        // Set up flush timer
+        if (this.config.flushInterval > 0) {
+            this.flushTimer = setInterval(() => this.flush(), this.config.flushInterval);
+        }
+        // Monitor memory usage
+        setInterval(() => {
+            this.recordMemoryUsage();
+        }, 10000); // Every 10 seconds
+        this.emit('telemetry:started');
+    }
+    /**
+     * Record a UI event
+     */
+    recordEvent(type, eventMetadata) {
+        if (!this.config.enabled)
+            return;
+        const event = {
+            type,
+            timestamp: Date.now(),
+            metadata: this.config.anonymize ? this.anonymizeData(eventMetadata) : eventMetadata,
+        };
+        this.events.push(event);
+        this.trimBuffer('events');
+        this.emit('event:recorded', event);
+    }
+    /**
+     * Start a performance mark
+     */
+    markStart(name) {
+        if (!this.config.enabled)
+            return;
+        this.marks.set(name, performance.now());
+    }
+    /**
+     * End a performance mark and record the duration
+     */
+    markEnd(name, _metadata) {
+        if (!this.config.enabled)
+            return 0;
+        const start = this.marks.get(name);
+        if (!start) {
+            console.warn(`No start mark found for: ${name}`);
+            return 0;
+        }
+        const duration = performance.now() - start;
+        this.marks.delete(name);
+        // Store measure
+        if (!this.measures.has(name)) {
+            this.measures.set(name, []);
+        }
+        this.measures.get(name).push(duration);
+        // Record metric
+        const metric = {
+            name,
+            value: duration,
+            unit: 'ms',
+            timestamp: Date.now(),
+        };
+        this.metrics.push(metric);
+        this.trimBuffer('metrics');
+        // Check threshold
+        this.checkPerformanceThreshold(name, duration);
+        this.emit('metric:recorded', metric);
+        return duration;
+    }
+    /**
+     * Record a user interaction
+     */
+    recordInteraction(type, target) {
+        if (!this.config.enabled) {
+            return {
+                complete: () => { },
+                cancel: () => { },
+            };
+        }
+        const interaction = {
+            type,
+            target,
+            timestamp: Date.now(),
+            completed: false,
+        };
+        this.interactions.push(interaction);
+        return {
+            complete: () => {
+                interaction.completed = true;
+                interaction.responseTime = Date.now() - interaction.timestamp;
+                this.checkResponseTimeThreshold(interaction.responseTime);
+                this.emit('interaction:completed', interaction);
+            },
+            cancel: () => {
+                interaction.completed = false;
+                this.emit('interaction:cancelled', interaction);
+            },
+        };
+    }
+    /**
+     * Record render metrics
+     */
+    recordRender(component, renderTime) {
+        if (!this.config.enabled)
+            return;
+        // Update frame counter
+        const now = performance.now();
+        const timeSinceLastFrame = now - this.frameCounter.lastFrame;
+        if (timeSinceLastFrame > 33.33) { // More than 2 frames at 60fps
+            this.frameCounter.dropped++;
+        }
+        this.frameCounter.frames++;
+        this.frameCounter.lastFrame = now;
+        const metric = {
+            component,
+            renderTime,
+            frameCount: this.frameCounter.frames,
+            dropped: this.frameCounter.dropped,
+            timestamp: Date.now(),
+        };
+        this.renderMetrics.push(metric);
+        this.trimBuffer('renderMetrics');
+        // Check render time threshold
+        if (renderTime > this.config.performanceThresholds.renderTime) {
+            this.emit('performance:slow-render', {
+                component,
+                renderTime,
+                threshold: this.config.performanceThresholds.renderTime,
+            });
+        }
+        this.emit('render:recorded', metric);
+    }
+    /**
+     * Record an error
+     */
+    recordError(error, context) {
+        if (!this.config.enabled)
+            return;
+        const errorRecord = {
+            error: {
+                message: error.message || String(error),
+                type: error.constructor?.name || 'Error',
+                stack: this.config.captureStackTraces ? error.stack : undefined,
+            },
+            timestamp: Date.now(),
+            context: this.config.anonymize ? this.anonymizeData(context) : context,
+        };
+        this.errors.push(errorRecord);
+        this.trimBuffer('errors');
+        this.emit('error:recorded', errorRecord);
+    }
+    /**
+     * Record memory usage
+     */
+    recordMemoryUsage() {
+        const usage = process.memoryUsage();
+        const metric = {
+            name: 'memory.heapUsed',
+            value: usage.heapUsed,
+            unit: 'bytes',
+            timestamp: Date.now(),
+        };
+        this.metrics.push(metric);
+        // Check memory threshold
+        if (usage.heapUsed > this.config.performanceThresholds.memory) {
+            this.emit('performance:high-memory', {
+                usage: usage.heapUsed,
+                threshold: this.config.performanceThresholds.memory,
+            });
+        }
+    }
+    /**
+     * Check performance threshold
+     */
+    checkPerformanceThreshold(name, duration) {
+        if (name.includes('render') &&
+            duration > this.config.performanceThresholds.renderTime) {
+            this.emit('performance:threshold-exceeded', {
+                type: 'render',
+                name,
+                duration,
+                threshold: this.config.performanceThresholds.renderTime,
+            });
+        }
+    }
+    /**
+     * Check response time threshold
+     */
+    checkResponseTimeThreshold(responseTime) {
+        if (responseTime > this.config.performanceThresholds.responseTime) {
+            this.emit('performance:threshold-exceeded', {
+                type: 'response',
+                responseTime,
+                threshold: this.config.performanceThresholds.responseTime,
+            });
+        }
+    }
+    /**
+     * Trim buffer to prevent memory issues
+     */
+    trimBuffer(bufferName) {
+        const buffer = this[bufferName];
+        if (Array.isArray(buffer) && buffer.length > this.config.bufferSize) {
+            // Keep most recent items
+            const toRemove = buffer.length - this.config.bufferSize;
+            buffer.splice(0, toRemove);
+        }
+    }
+    /**
+     * Anonymize sensitive data
+     */
+    anonymizeData(data) {
+        if (!data)
+            return data;
+        if (typeof data !== 'object')
+            return data;
+        const anonymized = { ...data };
+        // Remove or hash sensitive fields
+        const sensitiveFields = ['password', 'token', 'key', 'secret', 'email', 'username'];
+        for (const field of sensitiveFields) {
+            if (field in anonymized) {
+                anonymized[field] = '[REDACTED]';
+            }
+        }
+        // Recursively anonymize nested objects
+        for (const key in anonymized) {
+            if (typeof anonymized[key] === 'object' && anonymized[key] !== null) {
+                anonymized[key] = this.anonymizeData(anonymized[key]);
+            }
+        }
+        return anonymized;
+    }
+    /**
+     * Get current telemetry snapshot
+     */
+    getSnapshot() {
+        const now = Date.now();
+        const period = {
+            start: this.sessionStart,
+            end: now,
+        };
+        // Calculate event statistics
+        const eventsByType = {};
+        for (const event of this.events) {
+            eventsByType[event.type] = (eventsByType[event.type] || 0) + 1;
+        }
+        // Calculate performance metrics
+        const renderTimes = this.renderMetrics.map(m => m.renderTime);
+        const avgRenderTime = renderTimes.length > 0
+            ? renderTimes.reduce((a, b) => a + b, 0) / renderTimes.length
+            : 0;
+        const responseTimes = this.interactions
+            .filter(i => i.responseTime !== undefined)
+            .map(i => i.responseTime);
+        const avgResponseTime = responseTimes.length > 0
+            ? responseTimes.reduce((a, b) => a + b, 0) / responseTimes.length
+            : 0;
+        const framerate = this.frameCounter.frames > 0
+            ? (this.frameCounter.frames - this.frameCounter.dropped) /
+                ((now - this.sessionStart) / 1000)
+            : 0;
+        // Calculate interaction statistics
+        const completedInteractions = this.interactions.filter(i => i.completed).length;
+        const cancelledInteractions = this.interactions.filter(i => !i.completed).length;
+        // Calculate error statistics
+        const errorsByType = {};
+        for (const error of this.errors) {
+            const type = error.error.type || 'Unknown';
+            errorsByType[type] = (errorsByType[type] || 0) + 1;
+        }
+        return {
+            timestamp: now,
+            period,
+            events: {
+                total: this.events.length,
+                byType: eventsByType,
+            },
+            performance: {
+                avgRenderTime,
+                avgResponseTime,
+                framerate,
+                memoryUsage: process.memoryUsage(),
+                cpuUsage: process.cpuUsage(),
+            },
+            interactions: {
+                total: this.interactions.length,
+                completed: completedInteractions,
+                cancelled: cancelledInteractions,
+                avgResponseTime,
+            },
+            errors: {
+                total: this.errors.length,
+                byType: errorsByType,
+            },
+        };
+    }
+    /**
+     * Get performance summary
+     */
+    getPerformanceSummary() {
+        const summary = {};
+        for (const [name, durations] of this.measures) {
+            if (durations.length === 0)
+                continue;
+            summary[name] = {
+                avg: durations.reduce((a, b) => a + b, 0) / durations.length,
+                min: Math.min(...durations),
+                max: Math.max(...durations),
+                count: durations.length,
+            };
+        }
+        // Find slowest operations
+        const allOperations = [];
+        for (const metric of this.metrics) {
+            if (metric.unit === 'ms') {
+                allOperations.push({ name: metric.name, duration: metric.value });
+            }
+        }
+        const slowestOperations = allOperations
+            .sort((a, b) => b.duration - a.duration)
+            .slice(0, 10);
+        return {
+            measures: summary,
+            slowestOperations,
+        };
+    }
+    /**
+     * Flush telemetry data
+     */
+    flush() {
+        const snapshot = this.getSnapshot();
+        this.emit('telemetry:flush', snapshot);
+        // Clear old data based on buffer size
+        const cutoff = Date.now() - this.config.flushInterval;
+        this.events = this.events.filter(e => e.timestamp > cutoff);
+        this.metrics = this.metrics.filter(m => m.timestamp > cutoff);
+        this.interactions = this.interactions.filter(i => i.timestamp > cutoff);
+        this.renderMetrics = this.renderMetrics.filter(m => m.timestamp > cutoff);
+        this.errors = this.errors.filter(e => e.timestamp > cutoff);
+    }
+    /**
+     * Enable or disable telemetry
+     */
+    setEnabled(enabled) {
+        this.config.enabled = enabled;
+        if (!enabled) {
+            this.stop();
+        }
+        else {
+            this.startCollection();
+        }
+        this.emit('telemetry:status-changed', { enabled });
+    }
+    /**
+     * Update configuration
+     */
+    updateConfig(config) {
+        const wasEnabled = this.config.enabled;
+        this.config = { ...this.config, ...config };
+        if (wasEnabled !== this.config.enabled) {
+            this.setEnabled(this.config.enabled);
+        }
+        this.emit('telemetry:config-updated', this.config);
+    }
+    /**
+     * Reset all telemetry data
+     */
+    reset() {
+        this.events = [];
+        this.metrics = [];
+        this.interactions = [];
+        this.renderMetrics = [];
+        this.errors = [];
+        this.marks.clear();
+        this.measures.clear();
+        this.frameCounter = {
+            frames: 0,
+            dropped: 0,
+            lastFrame: performance.now(),
+        };
+        this.sessionStart = Date.now();
+        this.emit('telemetry:reset');
+    }
+    /**
+     * Stop telemetry collection
+     */
+    stop() {
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = null;
+        }
+        this.emit('telemetry:stopped');
+    }
+    /**
+     * Dispose of telemetry
+     */
+    dispose() {
+        this.stop();
+        this.removeAllListeners();
+        this.reset();
+    }
+}
+//# sourceMappingURL=UITelemetry.js.map

package/dist/ui/telemetry/UITelemetry.js.map

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

package/dist/ui/unified/index.d.ts

@@ -1,11 +1,25 @@
-import type { ToolRuntimeObserver } from '../../core/toolRuntime.js';
 import type { Display } from '../display.js';
 import { ShellUIAdapter } from '../ShellUIAdapter.js';
 import { UIUpdateCoordinator } from '../orchestration/UIUpdateCoordinator.js';
+import type { ToolRuntimeObserver } from '../../core/toolRuntime.js';
+import type { ToolCallRequest } from '../../core/types.js';
+export { type ToolOperation, type Badge, type BadgeStyle } from '../ShellUIAdapter.js';
+export { inPlaceUpdater, InPlaceUpdater, updateInPlace, showProgress, finishProgress } from '../inPlaceUpdater.js';
+export { theme, icons, spinnerFrames, progressChars, boxChars } from '../theme.js';
 export interface UnifiedUiOptions {
+    writeStream?: NodeJS.WriteStream;
     display?: Display;
+    enableTelemetry?: boolean;
+    debugMode?: boolean;
     updateCoordinator?: UIUpdateCoordinator;
 }
+/**
+ * UnifiedUiLayer - single entry point for all terminal UI wiring.
+ *
+ * This layer standardizes how the shell interacts with the Unified UI Controller,
+ * the Display system, and update coordination/telemetry. It ensures both the
+ * TypeScript and Python CLIs share the same conceptual contract.
+ */
 export declare class UnifiedUiLayer {
     readonly display: Display;
     readonly adapter: ShellUIAdapter;
@@ -16,6 +30,19 @@ export declare class UnifiedUiLayer {
     startProcessing(message?: string): void;
     endProcessing(message?: string): void;
     updateContextUsage(percentage: number): void;
+    getTelemetry(): ReturnType<ShellUIAdapter['getTelemetry']>;
+    getState(): ReturnType<ShellUIAdapter['getState']>;
+    showInterrupt(message: string, type?: 'confirmation' | 'alert' | 'question', handler?: () => void | Promise<void>): string;
+    completeInterrupt(id: string): void;
+    onToolStart(toolCall: ToolCallRequest): void;
+    /**
+     * Set file change tracking callback
+     */
+    setFileChangeCallback(callback: (path: string, type: 'edit' | 'write' | 'delete', additions: number, removals: number) => void): void;
+    /**
+     * Set tool status callback for dynamic status updates
+     */
+    setToolStatusCallback(callback: (status: string | null) => void): void;
     dispose(): void;
 }
 //# sourceMappingURL=index.d.ts.map

package/dist/ui/unified/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ui/unified/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAE9E,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iBAAiB,CAAC,EAAE,mBAAmB,CAAC;CACzC;AAED,qBAAa,cAAc;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,CAAC;IACjE,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;gBAE1B,OAAO,GAAE,gBAAqB;IAO1C,kBAAkB,IAAI,mBAAmB;IAIzC,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAIvC,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAIrC,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAI5C,OAAO,IAAI,IAAI;CAIhB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ui/unified/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAAE,cAAc,EAA6B,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAC9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG3D,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACnH,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEnF,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iBAAiB,CAAC,EAAE,mBAAmB,CAAC;CACzC;AAED;;;;;;GAMG;AACH,qBAAa,cAAc;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,CAAC;IACjE,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;gBAE1B,OAAO,GAAE,gBAAqB;IAmB1C,kBAAkB,IAAI,mBAAmB;IAIzC,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAIvC,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAIrC,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAI5C,YAAY,IAAI,UAAU,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;IAI1D,QAAQ,IAAI,UAAU,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAIlD,aAAa,CACX,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,cAAc,GAAG,OAAO,GAAG,UAAoB,EACrD,OAAO,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACnC,MAAM;IAIT,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAInC,WAAW,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAI5C;;OAEG;IACH,qBAAqB,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIrI;;OAEG;IACH,qBAAqB,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI;IAItE,OAAO,IAAI,IAAI;CAGhB"}

package/dist/ui/unified/index.js

@@ -1,6 +1,15 @@
 import { display as defaultDisplay } from '../display.js';
 import { ShellUIAdapter } from '../ShellUIAdapter.js';
 import { UIUpdateCoordinator } from '../orchestration/UIUpdateCoordinator.js';
+export { inPlaceUpdater, InPlaceUpdater, updateInPlace, showProgress, finishProgress } from '../inPlaceUpdater.js';
+export { theme, icons, spinnerFrames, progressChars, boxChars } from '../theme.js';
+/**
+ * UnifiedUiLayer - single entry point for all terminal UI wiring.
+ *
+ * This layer standardizes how the shell interacts with the Unified UI Controller,
+ * the Display system, and update coordination/telemetry. It ensures both the
+ * TypeScript and Python CLIs share the same conceptual contract.
+ */
 export class UnifiedUiLayer {
     display;
     adapter;
@@ -9,7 +18,11 @@ export class UnifiedUiLayer {
     constructor(options = {}) {
         this.display = options.display ?? defaultDisplay;
         this.updates = options.updateCoordinator ?? new UIUpdateCoordinator();
-        this.adapter = new ShellUIAdapter(this.display, {});
+        const adapterConfig = {
+            enableTelemetry: options.enableTelemetry ?? true,
+            debugMode: options.debugMode ?? false,
+        };
+        this.adapter = new ShellUIAdapter((options.writeStream ?? process.stdout), this.display, adapterConfig, this.updates);
         this.controller = this.adapter.getController();
     }
     createToolObserver() {
@@ -24,9 +37,35 @@ export class UnifiedUiLayer {
     updateContextUsage(percentage) {
         this.adapter.updateContextUsage(percentage);
     }
+    getTelemetry() {
+        return this.adapter.getTelemetry();
+    }
+    getState() {
+        return this.adapter.getState();
+    }
+    showInterrupt(message, type = 'alert', handler) {
+        return this.adapter.showInterrupt(message, type, handler);
+    }
+    completeInterrupt(id) {
+        this.adapter.completeInterrupt(id);
+    }
+    onToolStart(toolCall) {
+        this.controller.onToolStart(toolCall);
+    }
+    /**
+     * Set file change tracking callback
+     */
+    setFileChangeCallback(callback) {
+        this.adapter.setFileChangeCallback(callback);
+    }
+    /**
+     * Set tool status callback for dynamic status updates
+     */
+    setToolStatusCallback(callback) {
+        this.adapter.setToolStatusCallback(callback);
+    }
     dispose() {
         this.adapter.dispose();
-        this.updates.dispose();
     }
 }
 //# sourceMappingURL=index.js.map

package/dist/ui/unified/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ui/unified/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAO9E,MAAM,OAAO,cAAc;IAChB,OAAO,CAAU;IACjB,OAAO,CAAiB;IACxB,UAAU,CAA8C;IACxD,OAAO,CAAsB;IAEtC,YAAY,UAA4B,EAAE;QACxC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,cAAc,CAAC;QACjD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,iBAAiB,IAAI,IAAI,mBAAmB,EAAE,CAAC;QACtE,IAAI,CAAC,OAAO,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;IACjD,CAAC;IAED,kBAAkB;QAChB,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAC3C,CAAC;IAED,eAAe,CAAC,OAAgB;QAC9B,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,aAAa,CAAC,OAAgB;QAC5B,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,kBAAkB,CAAC,UAAkB;QACnC,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO;QACL,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IACzB,CAAC;CACF"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ui/unified/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,cAAc,EAA6B,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAM9E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACnH,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAUnF;;;;;;GAMG;AACH,MAAM,OAAO,cAAc;IAChB,OAAO,CAAU;IACjB,OAAO,CAAiB;IACxB,UAAU,CAA8C;IACxD,OAAO,CAAsB;IAEtC,YAAY,UAA4B,EAAE;QACxC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,cAAc,CAAC;QACjD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,iBAAiB,IAAI,IAAI,mBAAmB,EAAE,CAAC;QAEtE,MAAM,aAAa,GAAyB;YAC1C,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,IAAI;YAChD,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,KAAK;SACtC,CAAC;QAEF,IAAI,CAAC,OAAO,GAAG,IAAI,cAAc,CAC/B,CAAC,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,MAAM,CAA0B,EAChE,IAAI,CAAC,OAAO,EACZ,aAAa,EACb,IAAI,CAAC,OAAO,CACb,CAAC;QAEF,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;IACjD,CAAC;IAED,kBAAkB;QAChB,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAC3C,CAAC;IAED,eAAe,CAAC,OAAgB;QAC9B,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,aAAa,CAAC,OAAgB;QAC5B,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,kBAAkB,CAAC,UAAkB;QACnC,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC9C,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;IACrC,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;IACjC,CAAC;IAED,aAAa,CACX,OAAe,EACf,OAA8C,OAAO,EACrD,OAAoC;QAEpC,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IAED,iBAAiB,CAAC,EAAU;QAC1B,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,WAAW,CAAC,QAAyB;QACnC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,qBAAqB,CAAC,QAAwG;QAC5H,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,qBAAqB,CAAC,QAAyC;QAC7D,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO;QACL,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IACzB,CAAC;CACF"}

package/dist/ui/unified/layout.d.ts

@@ -0,0 +1,12 @@
+export interface StatusLinePart {
+    text: string;
+    tone?: 'info' | 'warn' | 'error' | 'success' | 'muted';
+}
+export declare const renderDivider: (width: number, label?: string) => string;
+export declare const renderStatusLine: (parts: StatusLinePart[], width: number) => string;
+/**
+ * Render status parts into multiple lines, wrapping as needed.
+ * Unlike renderStatusLine, this never truncates - it wraps to new lines.
+ */
+export declare const renderStatusLines: (parts: StatusLinePart[], width: number) => string[];
+//# sourceMappingURL=layout.d.ts.map

package/dist/ui/unified/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../src/ui/unified/layout.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;CACxD;AAaD,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,EAAE,QAAQ,MAAM,KAAG,MAY7D,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,OAAO,cAAc,EAAE,EAAE,OAAO,MAAM,KAAG,MAuBzE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,cAAc,EAAE,EAAE,OAAO,MAAM,KAAG,MAAM,EAsChF,CAAC"}