browser-debugger-cli 0.1.0 → 0.2.0

package/dist/utils/pageReadiness.js

@@ -0,0 +1,271 @@
+/**
+ * Smart page readiness detection using self-tuning thresholds
+ *
+ * This module provides adaptive page load detection that works for any page type
+ * without configuration. It uses a three-phase approach:
+ * 1. Load event (baseline readiness)
+ * 2. Network stability (adapts to request patterns)
+ * 3. DOM stability (adapts to mutation rate)
+ */
+/**
+ * Wait for page to be ready using self-tuning detection
+ *
+ * Strategy:
+ * 1. Wait for load event (baseline)
+ * 2. Wait for network to stabilize (adaptive)
+ * 3. Wait for DOM to stabilize (adaptive)
+ *
+ * All thresholds adapt to observed page behavior.
+ * No framework detection, no configuration needed.
+ *
+ * @param cdp - CDP connection
+ * @param options - Optional configuration
+ *
+ * @example
+ * ```typescript
+ * // Default: Self-tuning for any page
+ * await waitForPageReady(cdp);
+ *
+ * // Custom timeout for slow apps
+ * await waitForPageReady(cdp, { maxWaitMs: 60000 });
+ * ```
+ */
+export async function waitForPageReady(cdp, options = {}) {
+    const maxWaitMs = options.maxWaitMs ?? 2000;
+    const deadline = Date.now() + maxWaitMs;
+    try {
+        // Phase 1: Wait for load event (sufficient for most pages)
+        await waitForLoadEvent(cdp, deadline);
+        console.error('[readiness] ✓ Load event');
+        // Optional: Wait for network/DOM stability (only for SPAs with heavy hydration)
+        if (options.waitForStability) {
+            const networkIdleMs = await waitForNetworkStable(cdp, deadline);
+            console.error(`[readiness] ✓ Network stable (${networkIdleMs}ms idle)`);
+            const domIdleMs = await waitForDOMStable(cdp, deadline);
+            console.error(`[readiness] ✓ DOM stable (${domIdleMs}ms idle)`);
+        }
+        console.error('[readiness] ✓ Page ready');
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`[readiness] ${message}, proceeding anyway`);
+        // Don't rethrow - allow session to continue
+    }
+}
+/**
+ * Wait for Page.loadEventFired (window.onload equivalent)
+ *
+ * This is the browser's native load event - fires when:
+ * - Document is fully loaded
+ * - All synchronous scripts executed
+ * - DOMContentLoaded already fired
+ *
+ * Framework-agnostic baseline.
+ *
+ * Handles edge case where load event already fired (Chrome navigates during launch).
+ *
+ * @param cdp - CDP connection
+ * @param deadline - Timestamp when to timeout
+ * @throws Error if deadline exceeded
+ */
+async function waitForLoadEvent(cdp, deadline) {
+    await cdp.send('Page.enable');
+    // Check if page already loaded (handles Chrome pre-navigation)
+    try {
+        const result = await cdp.send('Runtime.evaluate', {
+            expression: 'document.readyState',
+            returnByValue: true,
+        });
+        if (result.result?.value === 'complete') {
+            // Load event already fired
+            return;
+        }
+    }
+    catch {
+        // Ignore evaluation errors, proceed to wait for event
+    }
+    return new Promise((resolve, reject) => {
+        let timeout;
+        let handlerId;
+        const cleanup = () => {
+            clearTimeout(timeout);
+            if (handlerId !== undefined) {
+                cdp.off('Page.loadEventFired', handlerId);
+            }
+        };
+        const checkDeadline = () => {
+            if (Date.now() >= deadline) {
+                cleanup();
+                reject(new Error('Load event timeout'));
+            }
+            else {
+                timeout = setTimeout(checkDeadline, 100);
+            }
+        };
+        const loadHandler = () => {
+            cleanup();
+            resolve();
+        };
+        handlerId = cdp.on('Page.loadEventFired', loadHandler);
+        checkDeadline();
+    });
+}
+/**
+ * Wait for network to stabilize using adaptive thresholds
+ *
+ * LEARNING PHASE (first 2s):
+ * - Track request intervals
+ * - Calculate average request frequency
+ *
+ * DETECTION PHASE:
+ * - Fast pattern (avg \< 100ms): 200ms idle = stable
+ * - Steady pattern (100-500ms): 500ms idle = stable
+ * - Slow pattern (\> 500ms): 1000ms idle = stable
+ *
+ * Why this works:
+ * - Fast sites: Quick bursts, fast stabilization
+ * - SSR apps: Steady hydration requests, medium wait
+ * - API-heavy: Slow requests, longer patience
+ *
+ * Framework-agnostic - adapts to actual behavior.
+ *
+ * @param cdp - CDP connection
+ * @param deadline - Timestamp when to timeout
+ * @returns Actual idle duration detected
+ * @throws Error if deadline exceeded
+ */
+async function waitForNetworkStable(cdp, deadline) {
+    await cdp.send('Network.enable');
+    let activeRequests = 0;
+    let lastActivity = Date.now();
+    const intervals = [];
+    let lastRequestTime = Date.now();
+    // Track request patterns
+    const requestHandler = () => {
+        const now = Date.now();
+        const interval = now - lastRequestTime;
+        if (interval < 5000)
+            intervals.push(interval);
+        lastRequestTime = now;
+        activeRequests++;
+        lastActivity = now;
+    };
+    const finishHandler = () => {
+        activeRequests--;
+        if (activeRequests === 0) {
+            lastActivity = Date.now();
+        }
+    };
+    const requestHandlerId = cdp.on('Network.requestWillBeSent', requestHandler);
+    const loadingFinishedId = cdp.on('Network.loadingFinished', finishHandler);
+    const loadingFailedId = cdp.on('Network.loadingFailed', finishHandler);
+    try {
+        // Use fixed threshold for immediate detection
+        const idleThreshold = 200; // 200ms idle = network stable
+        // Detection phase: wait for stability
+        while (Date.now() < deadline) {
+            if (activeRequests === 0) {
+                const idleTime = Date.now() - lastActivity;
+                if (idleTime >= idleThreshold) {
+                    return idleTime; // Success!
+                }
+            }
+            await delay(50); // Check every 50ms
+        }
+        throw new Error('Network stability timeout');
+    }
+    finally {
+        // Cleanup handlers
+        cdp.off('Network.requestWillBeSent', requestHandlerId);
+        cdp.off('Network.loadingFinished', loadingFinishedId);
+        cdp.off('Network.loadingFailed', loadingFailedId);
+    }
+}
+/**
+ * Wait for DOM to stabilize using adaptive thresholds
+ *
+ * HOW IT WORKS:
+ * 1. Inject MutationObserver into page
+ * 2. Track mutation rate for 1 second
+ * 3. Calculate adaptive stability threshold:
+ *    - High rate (\>50 mutations/sec): 1000ms no-change = stable
+ *    - Medium rate (10-50 mutations/sec): 500ms no-change = stable
+ *    - Low rate (\<10 mutations/sec): 300ms no-change = stable
+ * 4. Wait for DOM to remain unchanged for threshold duration
+ *
+ * Why this works:
+ * - SSR hydration causes DOM mutations
+ * - React/Vue/Svelte all mutate during hydration
+ * - When mutations stop, hydration is complete
+ *
+ * Framework-agnostic - detects actual mutations.
+ *
+ * @param cdp - CDP connection
+ * @param deadline - Timestamp when to timeout
+ * @returns Actual stable duration detected
+ * @throws Error if deadline exceeded
+ */
+async function waitForDOMStable(cdp, deadline) {
+    // Inject mutation observer
+    await cdp.send('Runtime.evaluate', {
+        expression: `
+      window.__bdg_mutations = 0;
+      window.__bdg_lastMutation = Date.now();
+
+      const observer = new MutationObserver(() => {
+        window.__bdg_mutations++;
+        window.__bdg_lastMutation = Date.now();
+      });
+
+      observer.observe(document.body, {
+        childList: true,
+        subtree: true,
+        attributes: true,
+        characterData: true
+      });
+
+      window.__bdg_observer = observer;
+    `,
+    });
+    try {
+        // Use fixed threshold for immediate detection
+        const stableThreshold = 300; // 300ms no mutations = DOM stable
+        // Detection phase: wait for stability
+        while (Date.now() < deadline) {
+            const checkResult = await cdp.send('Runtime.evaluate', {
+                expression: 'Date.now() - window.__bdg_lastMutation',
+                returnByValue: true,
+            });
+            const timeSinceLastMutation = checkResult.result?.value ?? 0;
+            if (timeSinceLastMutation >= stableThreshold) {
+                return timeSinceLastMutation; // Success!
+            }
+            await delay(100); // Check every 100ms
+        }
+        throw new Error('DOM stability timeout');
+    }
+    finally {
+        // Cleanup observer
+        await cdp
+            .send('Runtime.evaluate', {
+            expression: `
+        window.__bdg_observer?.disconnect();
+        delete window.__bdg_observer;
+        delete window.__bdg_mutations;
+        delete window.__bdg_lastMutation;
+      `,
+        })
+            .catch(() => {
+            // Ignore cleanup errors
+        });
+    }
+}
+/**
+ * Delay utility
+ *
+ * @param ms - Milliseconds to delay
+ */
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=pageReadiness.js.map

package/dist/utils/pageReadiness.js.map

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

package/dist/utils/ui.d.ts

@@ -0,0 +1,36 @@
+/**
+ * UI utilities for enhanced terminal output.
+ *
+ * WHY: Provides visual feedback and branding for CLI operations.
+ */
+/**
+ * Options for the landing page display.
+ */
+export interface LandingPageOptions {
+    /** Target URL being monitored */
+    url: string;
+    /** Worker process ID */
+    workerPid: number;
+    /** Chrome process ID */
+    chromePid: number;
+    /** Collectors enabled */
+    collectors: string[];
+}
+/**
+ * Generate the landing page display for session start.
+ *
+ * @param options - Landing page options
+ * @returns Formatted landing page string
+ *
+ * @example
+ * ```typescript
+ * landingPage({
+ *   url: 'http://localhost:3000',
+ *   workerPid: 12345,
+ *   chromePid: 12346,
+ *   collectors: ['network', 'console', 'dom']
+ * });
+ * ```
+ */
+export declare function landingPage(options: LandingPageOptions): string;
+//# sourceMappingURL=ui.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/utils/ui.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CA2B/D"}

package/dist/utils/ui.js

@@ -0,0 +1,47 @@
+/**
+ * UI utilities for enhanced terminal output.
+ *
+ * WHY: Provides visual feedback and branding for CLI operations.
+ */
+/**
+ * Generate the landing page display for session start.
+ *
+ * @param options - Landing page options
+ * @returns Formatted landing page string
+ *
+ * @example
+ * ```typescript
+ * landingPage({
+ *   url: 'http://localhost:3000',
+ *   workerPid: 12345,
+ *   chromePid: 12346,
+ *   collectors: ['network', 'console', 'dom']
+ * });
+ * ```
+ */
+export function landingPage(options) {
+    const { url, workerPid, chromePid, collectors } = options;
+    const lines = [];
+    lines.push('');
+    lines.push('   bdg');
+    lines.push('');
+    lines.push('   ▲  Session Started');
+    lines.push('');
+    lines.push(`   ○  Target      ${url}`);
+    lines.push(`   ○  Chrome      PID ${chromePid}`);
+    lines.push(`   ○  Worker      PID ${workerPid}`);
+    lines.push(`   ○  Collecting  ${collectors.join(', ')}`);
+    lines.push('');
+    lines.push('   Ready — use these commands:');
+    lines.push('');
+    lines.push('     bdg status                   Session info');
+    lines.push('     bdg peek                     Preview data');
+    lines.push('     bdg cdp <method> [params]    Execute CDP commands');
+    lines.push('     bdg stop                     Stop & save');
+    lines.push('');
+    lines.push('   💡 Run any Chrome DevTools Protocol command:');
+    lines.push('      bdg cdp Runtime.evaluate \'{"expression": "document.title"}\'');
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=ui.js.map

package/dist/utils/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../src/utils/ui.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,WAAW,CAAC,OAA2B;IACrD,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAE1D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACpC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,qBAAqB,GAAG,EAAE,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,yBAAyB,SAAS,EAAE,CAAC,CAAC;IACjD,KAAK,CAAC,IAAI,CAAC,yBAAyB,SAAS,EAAE,CAAC,CAAC;IACjD,KAAK,CAAC,IAAI,CAAC,qBAAqB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;IAC7C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;IAC7D,KAAK,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;IAC7D,KAAK,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;IACrE,KAAK,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;IAC5D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;IAC9D,KAAK,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;IAClF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/utils/url.d.ts

@@ -1,3 +1,9 @@
+/**
+ * URL normalization and validation utilities.
+ *
+ * Note: Display formatting functions (truncateUrl, truncateText) have been
+ * moved to \@/ui/formatting.js as part of UI centralization.
+ */
 /**
  * Normalize a URL by adding http:// protocol if missing.
  *
@@ -17,30 +23,6 @@
  * ```
  */
 export declare function normalizeUrl(url: string): string;
-/**
- * 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 declare function truncateUrl(url: string, maxLength?: number): string;
-/**
- * Truncate console message text (especially stack traces)
- * @param text - The console message text
- * @param maxLines - Maximum number of lines to show (default: 3)
- */
-export declare function truncateText(text: string, maxLines?: number): string;
 /**
  * Validate that a URL is valid and usable for Chrome navigation.
  *

package/dist/utils/url.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAgBhD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,GAAE,MAAW,GAAG,MAAM,CAuCvE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAWvE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG;IACxC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CA4CA"}
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAgBhD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG;IACxC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CA4CA"}

package/dist/utils/url.js

@@ -1,4 +1,9 @@
-import { safeParseUrl } from './url/safeParseUrl.js';
+/**
+ * URL normalization and validation utilities.
+ *
+ * Note: Display formatting functions (truncateUrl, truncateText) have been
+ * moved to \@/ui/formatting.js as part of UI centralization.
+ */
 /**
  * Normalize a URL by adding http:// protocol if missing.
  *
@@ -32,72 +37,6 @@ export function normalizeUrl(url) {
     }
     return `http://${url}`;
 }
-/**
- * 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;
-}
-/**
- * Truncate console message text (especially stack traces)
- * @param text - The console message text
- * @param maxLines - Maximum number of lines to show (default: 3)
- */
-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)`;
-}
 /**
  * Validate that a URL is valid and usable for Chrome navigation.
  *

package/dist/utils/url.js.map

@@ -1 +1 @@
-{"version":3,"file":"url.js","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,kDAAkD;IAClD,IACE,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC;QACzB,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC;QAC1B,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC;QACzB,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC;QACxB,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC;QACzB,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC;QACvB,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC;QAC7B,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC;QAC3B,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,EACvB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,UAAU,GAAG,EAAE,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IAKrC,YAAY;IACZ,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpC,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,qBAAqB;YAC5B,UAAU,EAAE,kDAAkD;SAC/D,CAAC;IACJ,CAAC;IAED,4CAA4C;IAC5C,MAAM,UAAU,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAErC,sBAAsB;IACtB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;QAEnC,2BAA2B;QAC3B,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAClF,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9C,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,sBAAsB,MAAM,CAAC,QAAQ,GAAG;gBAC/C,UAAU,EAAE,2DAA2D;aACxE,CAAC;QACJ,CAAC;QAED,4CAA4C;QAC5C,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACtF,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,wBAAwB,GAAG,sBAAsB;gBACxD,UAAU,EAAE,8DAA8D;aAC3E,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,wBAAwB,GAAG,GAAG;YACrC,UAAU,EAAE,0DAA0D;SACvE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browser-debugger-cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "DevTools telemetry in your terminal. For humans and agents. Direct WebSocket to Chrome's debugging port.",
   "type": "module",
   "bin": {

package/dist/cli/collectors/dom.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../../src/cli/collectors/dom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsZzC;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmD1D"}