browser-debugger-cli 0.1.0 → 0.3.0

package/dist/ui/formatting.js

@@ -0,0 +1,454 @@
+/**
+ * Shared formatting utilities for UI output.
+ *
+ * This module provides low-level formatting helpers used across all UI components.
+ * Includes: separators, sections, lists, key-value pairs, text utilities, time formatting,
+ * and the OutputFormatter class for building complex formatted output.
+ */
+import { safeParseUrl } from '../utils/url.js';
+// ============================================================================
+// Output Formatter Class
+// ============================================================================
+/**
+ * Fluent builder for constructing formatted console output.
+ *
+ * Provides a chainable API for building complex multi-line output with consistent
+ * spacing, indentation, and structure. All methods return `this` for chaining.
+ *
+ * @example
+ * ```typescript
+ * const output = new OutputFormatter()
+ *   .text('Found 3 elements:')
+ *   .list(['<div>', '<span>', '<p>'])
+ *   .blank()
+ *   .section('Next steps:', [
+ *     'Highlight: bdg dom highlight 0',
+ *     'Get HTML: bdg dom get 0'
+ *   ])
+ *   .build();
+ *
+ * console.log(output);
+ * // Output:
+ * // Found 3 elements:
+ * //   <div>
+ * //   <span>
+ * //   <p>
+ * //
+ * // Next steps:
+ * //   Highlight: bdg dom highlight 0
+ * //   Get HTML: bdg dom get 0
+ * ```
+ */
+export class OutputFormatter {
+    lines = [];
+    /**
+     * Add a text line to the output.
+     *
+     * @param content - Text content to add
+     * @returns This formatter for chaining
+     */
+    text(content) {
+        this.lines.push(content);
+        return this;
+    }
+    /**
+     * Add a blank line to the output.
+     *
+     * @returns This formatter for chaining
+     */
+    blank() {
+        this.lines.push('');
+        return this;
+    }
+    /**
+     * Add an indented list of items.
+     *
+     * @param items - Array of items to list
+     * @param indent - Indentation spaces (default: 2)
+     * @returns This formatter for chaining
+     */
+    list(items, indent = 2) {
+        const prefix = ' '.repeat(indent);
+        items.forEach((item) => this.lines.push(prefix + item));
+        return this;
+    }
+    /**
+     * Add a section with title and indented items.
+     *
+     * @param title - Section title
+     * @param items - Array of items (will be indented)
+     * @param indent - Indentation spaces (default: 2)
+     * @returns This formatter for chaining
+     */
+    section(title, items, indent = 2) {
+        this.lines.push(title);
+        return this.list(items, indent);
+    }
+    /**
+     * Add a horizontal separator line.
+     *
+     * @param char - Character to repeat (default: '━')
+     * @param width - Width in characters (default: 50)
+     * @returns This formatter for chaining
+     */
+    separator(char = '━', width = 50) {
+        this.lines.push(char.repeat(width));
+        return this;
+    }
+    /**
+     * Add a key-value pair with alignment.
+     *
+     * @param key - Key string
+     * @param value - Value string
+     * @param keyWidth - Width to pad key to (default: no padding)
+     * @returns This formatter for chaining
+     */
+    keyValue(key, value, keyWidth) {
+        const formatted = keyWidth ? `${key}:`.padEnd(keyWidth) + value : `${key}: ${value}`;
+        this.lines.push(formatted);
+        return this;
+    }
+    /**
+     * Add multiple key-value pairs with aligned keys.
+     *
+     * @param pairs - Array of [key, value] tuples
+     * @param keyWidth - Width to pad keys to (auto-calculated if not provided)
+     * @returns This formatter for chaining
+     */
+    keyValueList(pairs, keyWidth) {
+        const width = keyWidth ?? Math.max(...pairs.map(([k]) => k.length)) + 2;
+        pairs.forEach(([key, value]) => this.keyValue(key, value, width));
+        return this;
+    }
+    /**
+     * Add indented content.
+     *
+     * @param content - Content to indent (can be multiline)
+     * @param spaces - Number of spaces to indent (default: 2)
+     * @returns This formatter for chaining
+     */
+    indent(content, spaces = 2) {
+        const prefix = ' '.repeat(spaces);
+        content.split('\n').forEach((line) => this.lines.push(prefix + line));
+        return this;
+    }
+    /**
+     * Build the final output string.
+     *
+     * @returns Formatted output with lines joined by newlines
+     */
+    build() {
+        return this.lines.join('\n');
+    }
+}
+// ============================================================================
+// Visual Elements
+// ============================================================================
+/**
+ * Create a horizontal separator line.
+ *
+ * @param char - Character to use for separator (default: '━')
+ * @param width - Width of separator in characters (default: 50)
+ * @returns Separator string
+ *
+ * @example
+ * ```typescript
+ * separator()        // → '━━━━━━...' (50 chars)
+ * separator('-', 20) // → '--------------------'
+ * ```
+ */
+export function separator(char = '━', width = 50) {
+    return char.repeat(width);
+}
+// ============================================================================
+// Section Builders
+// ============================================================================
+/**
+ * Create a titled section with content lines.
+ *
+ * @param title - Section title
+ * @param content - Array of content lines (will be indented)
+ * @param indent - Number of spaces to indent content (default: 2)
+ * @returns Formatted section string
+ *
+ * @example
+ * ```typescript
+ * section('Process Info:', [
+ *   'Daemon PID: 12345',
+ *   'Chrome PID: 67890'
+ * ])
+ * // →
+ * // Process Info:
+ * //   Daemon PID: 12345
+ * //   Chrome PID: 67890
+ * ```
+ */
+export function section(title, content, indent = 2) {
+    const lines = [title, ...content.map((line) => ' '.repeat(indent) + line)];
+    return lines.join('\n');
+}
+/**
+ * Create a bullet list with optional indentation.
+ *
+ * @param items - Array of list items
+ * @param indent - Number of spaces to indent (default: 2)
+ * @param bullet - Bullet character (default: '-')
+ * @returns Formatted bullet list
+ *
+ * @example
+ * ```typescript
+ * bulletList(['Item 1', 'Item 2'], 2, '•')
+ * // →
+ * //   • Item 1
+ * //   • Item 2
+ * ```
+ */
+export function bulletList(items, indent = 2, bullet = '-') {
+    const prefix = ' '.repeat(indent) + bullet + ' ';
+    return items.map((item) => prefix + item).join('\n');
+}
+/**
+ * Create a key-value pair with alignment.
+ *
+ * @param key - Key string
+ * @param value - Value string
+ * @param keyWidth - Width to pad key to (default: auto)
+ * @returns Formatted key-value pair
+ *
+ * @example
+ * ```typescript
+ * keyValue('Status', 'Active', 15)
+ * // → 'Status:         Active'
+ * ```
+ */
+export function keyValue(key, value, keyWidth) {
+    if (keyWidth) {
+        return `${key}:`.padEnd(keyWidth) + value;
+    }
+    return `${key}: ${value}`;
+}
+// ============================================================================
+// Text Utilities
+// ============================================================================
+/**
+ * Indent text by a number of spaces.
+ *
+ * @param text - Text to indent (can be multiline)
+ * @param spaces - Number of spaces to indent
+ * @returns Indented text
+ *
+ * @example
+ * ```typescript
+ * indent('Line 1\nLine 2', 4)
+ * // →
+ * //     Line 1
+ * //     Line 2
+ * ```
+ */
+export function indent(text, spaces) {
+    const prefix = ' '.repeat(spaces);
+    return text
+        .split('\n')
+        .map((line) => prefix + line)
+        .join('\n');
+}
+/**
+ * Truncate text to maximum length with ellipsis.
+ *
+ * @param text - Text to truncate
+ * @param maxLength - Maximum length
+ * @returns Truncated text
+ *
+ * @example
+ * ```typescript
+ * truncate('Very long text here', 10)
+ * // → 'Very lo...'
+ * ```
+ */
+export function truncate(text, maxLength) {
+    if (text.length <= maxLength) {
+        return text;
+    }
+    return text.substring(0, maxLength - 3) + '...';
+}
+/**
+ * Truncate console message text (especially stack traces).
+ *
+ * @param text - The console message text
+ * @param maxLines - Maximum number of lines to show (default: 3)
+ * @returns Truncated text with line count
+ *
+ * @example
+ * ```typescript
+ * truncateText('Line 1\nLine 2\nLine 3\nLine 4\nLine 5', 3)
+ * // →
+ * // Line 1
+ * // Line 2
+ * // Line 3
+ * //   ... (2 more lines)
+ * ```
+ */
+export function truncateText(text, maxLines = 3) {
+    const lines = text.split('\n');
+    if (lines.length <= maxLines) {
+        return text;
+    }
+    const truncated = lines.slice(0, maxLines).join('\n');
+    const hiddenCount = lines.length - maxLines;
+    return `${truncated}\n  ... (${hiddenCount} more lines)`;
+}
+/**
+ * Truncate a URL for compact display.
+ *
+ * Removes www. prefix, shortens long paths with ellipsis, and truncates to maxLength.
+ *
+ * @param url - URL string to truncate
+ * @param maxLength - Maximum length of output (default: 60)
+ * @returns Truncated URL for display
+ *
+ * @example
+ * ```typescript
+ * truncateUrl('https://i.clarity.ms/collect')
+ *   // → 'clarity.ms/collect'
+ * truncateUrl('https://aswpapius.com/api/web-channels/47d7def8-d602-49ec-bfdb-c959b1346774')
+ *   // → 'aswpapius.com/.../47d7def8'
+ * ```
+ */
+export function truncateUrl(url, maxLength = 60) {
+    const parsed = safeParseUrl(url);
+    if (!parsed) {
+        // Fallback: simple string truncation if URL parsing fails
+        return url.length > maxLength ? url.substring(0, maxLength - 3) + '...' : url;
+    }
+    // Remove www. prefix
+    const domain = parsed.hostname.replace(/^www\./, '');
+    // Get path without leading slash
+    const path = parsed.pathname.substring(1);
+    // Start with domain + path
+    let result = domain + (path ? `/${path}` : '');
+    // If still too long, truncate the path
+    if (result.length > maxLength) {
+        const pathParts = path.split('/');
+        if (pathParts.length > 2) {
+            // Show first part, ellipsis, and last part
+            const first = pathParts[0];
+            const last = pathParts[pathParts.length - 1];
+            if (first && last) {
+                result = `${domain}/${first}/.../${last}`;
+                // If still too long, truncate the last part
+                if (result.length > maxLength) {
+                    const truncatedLast = last.substring(0, 8);
+                    result = `${domain}/${first}/.../${truncatedLast}`;
+                }
+            }
+        }
+        else {
+            // Simple truncation
+            result = result.substring(0, maxLength - 3) + '...';
+        }
+    }
+    return result;
+}
+/**
+ * Pluralize a word based on count.
+ *
+ * @param count - Number of items
+ * @param singular - Singular form of word
+ * @param plural - Plural form of word (optional, defaults to singular + 's')
+ * @returns Formatted count with correct word form
+ *
+ * @example
+ * ```typescript
+ * pluralize(1, 'request')       // → '1 request'
+ * pluralize(5, 'request')       // → '5 requests'
+ * pluralize(0, 'entry', 'entries') // → '0 entries'
+ * ```
+ */
+export function pluralize(count, singular, plural) {
+    const word = count === 1 ? singular : (plural ?? singular + 's');
+    return `${count} ${word}`;
+}
+// ============================================================================
+// Time Formatting
+// ============================================================================
+/**
+ * Format duration in milliseconds to human-readable string.
+ *
+ * @param ms - Duration in milliseconds
+ * @returns Formatted duration string
+ *
+ * @example
+ * ```typescript
+ * formatDuration(1500)      // → '1.5s'
+ * formatDuration(65000)     // → '1m 5s'
+ * formatDuration(3661000)   // → '1h 1m'
+ * ```
+ */
+export function formatDuration(ms) {
+    const seconds = Math.floor(ms / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    if (hours > 0) {
+        const remainingMinutes = minutes % 60;
+        return remainingMinutes > 0 ? `${hours}h ${remainingMinutes}m` : `${hours}h`;
+    }
+    if (minutes > 0) {
+        const remainingSeconds = seconds % 60;
+        return remainingSeconds > 0 ? `${minutes}m ${remainingSeconds}s` : `${minutes}m`;
+    }
+    if (seconds > 0) {
+        const remainingMs = ms % 1000;
+        if (remainingMs >= 100) {
+            return `${(ms / 1000).toFixed(1)}s`;
+        }
+        return `${seconds}s`;
+    }
+    return `${ms}ms`;
+}
+/**
+ * Format timestamp to ISO string.
+ *
+ * @param date - Date object or timestamp
+ * @returns ISO 8601 formatted string
+ *
+ * @example
+ * ```typescript
+ * formatTimestamp(new Date())
+ * // → '2025-11-05T12:34:56.789Z'
+ * ```
+ */
+export function formatTimestamp(date) {
+    const d = typeof date === 'number' ? new Date(date) : date;
+    return d.toISOString();
+}
+/**
+ * Format relative time ("time ago").
+ *
+ * @param date - Date object or timestamp
+ * @returns Human-readable relative time
+ *
+ * @example
+ * ```typescript
+ * formatTimeAgo(Date.now() - 5000)     // → '5 seconds ago'
+ * formatTimeAgo(Date.now() - 65000)    // → '1 minute ago'
+ * formatTimeAgo(Date.now() - 3661000)  // → '1 hour ago'
+ * ```
+ */
+export function formatTimeAgo(date) {
+    const d = typeof date === 'number' ? new Date(date) : date;
+    const seconds = Math.floor((Date.now() - d.getTime()) / 1000);
+    if (seconds < 60) {
+        return seconds === 1 ? '1 second ago' : `${seconds} seconds ago`;
+    }
+    const minutes = Math.floor(seconds / 60);
+    if (minutes < 60) {
+        return minutes === 1 ? '1 minute ago' : `${minutes} minutes ago`;
+    }
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24) {
+        return hours === 1 ? '1 hour ago' : `${hours} hours ago`;
+    }
+    const days = Math.floor(hours / 24);
+    return days === 1 ? '1 day ago' : `${days} days ago`;
+}
+//# sourceMappingURL=formatting.js.map

package/dist/ui/formatting.js.map

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

package/dist/ui/messages/chrome.d.ts

@@ -0,0 +1,172 @@
+/**
+ * Chrome-related user-facing messages.
+ *
+ * Centralized location for Chrome diagnostics, launch errors, and troubleshooting messages.
+ */
+import type { ChromeDiagnostics } from '../../utils/chromeDiagnostics.js';
+/**
+ * Format Chrome diagnostics for error reporting when Chrome launch fails.
+ *
+ * @param diagnostics - Chrome diagnostics information
+ * @returns Formatted error message lines with troubleshooting steps
+ *
+ * @example
+ * ```typescript
+ * const diagnostics = getChromeDiagnostics();
+ * const errorLines = formatDiagnosticsForError(diagnostics);
+ * console.error(errorLines.join('\n'));
+ * ```
+ */
+export declare function formatDiagnosticsForError(diagnostics: ChromeDiagnostics): string[];
+/**
+ * Format Chrome diagnostics for verbose status output (bdg status --verbose).
+ *
+ * @param diagnostics - Chrome diagnostics information
+ * @returns Array of formatted status lines
+ *
+ * @example
+ * ```typescript
+ * const diagnostics = getChromeDiagnostics();
+ * const statusLines = formatDiagnosticsForStatus(diagnostics);
+ * console.log(statusLines.join('\n'));
+ * ```
+ */
+export declare function formatDiagnosticsForStatus(diagnostics: ChromeDiagnostics): string[];
+/**
+ * Generate invalid port error message.
+ *
+ * @param port - Invalid port number
+ * @returns Formatted error message
+ */
+export declare function invalidPortError(port: number): string;
+/**
+ * Generate user data directory creation error.
+ *
+ * @param dir - Directory path that failed
+ * @param error - Error message
+ * @returns Formatted error message
+ */
+export declare function userDataDirError(dir: string, error: string): string;
+/**
+ * Generate Chrome launch start message.
+ *
+ * @param port - CDP port number
+ * @returns Formatted message
+ */
+export declare function chromeLaunchStartMessage(port: number): string;
+/**
+ * Generate Chrome launch success message.
+ *
+ * @param pid - Chrome process ID
+ * @param duration - Launch duration in milliseconds
+ * @returns Formatted message
+ */
+export declare function chromeLaunchSuccessMessage(pid: number, duration: number): string;
+/**
+ * Generate user data directory info message.
+ *
+ * @param dir - User data directory path
+ * @returns Formatted message
+ */
+export declare function chromeUserDataDirMessage(dir: string): string;
+/**
+ * Generate preferences file not found error.
+ *
+ * @param file - Preferences file path
+ * @returns Formatted error message
+ */
+export declare function prefsFileNotFoundError(file: string): string;
+/**
+ * Generate invalid preferences format error.
+ *
+ * @param file - Preferences file path
+ * @param type - Actual type found
+ * @returns Formatted error message
+ */
+export declare function invalidPrefsFormatError(file: string, type: string): string;
+/**
+ * Generate preferences load error.
+ *
+ * @param file - Preferences file path
+ * @param error - Error message
+ * @returns Formatted error message
+ */
+export declare function prefsLoadError(file: string, error: string): string;
+/**
+ * Generate generic Chrome launch error.
+ *
+ * @param error - Error message
+ * @returns Formatted error message
+ */
+export declare function chromeLaunchFailedError(error: string): string;
+/**
+ * Generate message for starting Chrome cleanup process.
+ *
+ * @returns Formatted message
+ *
+ * @example
+ * ```typescript
+ * console.error(cleanupChromeAttemptingMessage());
+ * ```
+ */
+export declare function cleanupChromeAttemptingMessage(): string;
+/**
+ * Generate warning message when Chrome PID is not found in cache.
+ *
+ * @returns Multi-line formatted warning message
+ *
+ * @example
+ * ```typescript
+ * console.error(cleanupChromePidNotFoundMessage());
+ * ```
+ */
+export declare function cleanupChromePidNotFoundMessage(): string;
+/**
+ * Generate message indicating Chrome process is being killed.
+ *
+ * @param pid - Chrome process ID
+ * @returns Formatted message
+ *
+ * @example
+ * ```typescript
+ * console.error(cleanupChromeKillingMessage(12345));
+ * // Output: "Killing Chrome process (PID: 12345)..."
+ * ```
+ */
+export declare function cleanupChromeKillingMessage(pid: number): string;
+/**
+ * Generate success message after Chrome process is killed.
+ *
+ * @returns Formatted success message
+ *
+ * @example
+ * ```typescript
+ * console.error(cleanupChromeSuccessMessage());
+ * ```
+ */
+export declare function cleanupChromeSuccessMessage(): string;
+/**
+ * Generate error message when Chrome cleanup fails.
+ *
+ * @param error - Error message
+ * @returns Multi-line formatted error message with troubleshooting
+ *
+ * @example
+ * ```typescript
+ * console.error(cleanupChromeFailedMessage('Process not found'));
+ * ```
+ */
+export declare function cleanupChromeFailedMessage(error: string): string;
+/**
+ * Generate generic error message for Chrome cleanup process failure.
+ *
+ * @param error - Error message
+ * @returns Formatted error message
+ *
+ * @example
+ * ```typescript
+ * console.error(cleanupChromeProcessFailedMessage('Cannot read PID file'));
+ * ```
+ */
+export declare function cleanupChromeProcessFailedMessage(error: string): string;
+//# sourceMappingURL=chrome.d.ts.map

package/dist/ui/messages/chrome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chrome.d.ts","sourceRoot":"","sources":["../../../src/ui/messages/chrome.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEtE;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAsBlF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAmBnF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnE;AAMD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEhF;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7D;AAMD;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,IAAI,MAAM,CAEvD;AAED;;;;;;;;;GASG;AACH,wBAAgB,+BAA+B,IAAI,MAAM,CAKxD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKhE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvE"}