browser-debugger-cli 0.1.0 → 0.3.0

package/dist/ui/formatters/cookies.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Cookie formatter for human-readable output.
+ */
+/**
+ * CDP Cookie type
+ */
+export interface Cookie {
+    name: string;
+    value: string;
+    domain: string;
+    path: string;
+    expires?: number;
+    httpOnly: boolean;
+    secure: boolean;
+    sameSite?: 'Strict' | 'Lax' | 'None';
+}
+/**
+ * Format cookies for human-readable output.
+ *
+ * @param cookies - Array of CDP cookies
+ * @returns Formatted cookie list
+ *
+ * @example
+ * ```typescript
+ * const output = formatCookies([
+ *   { name: 'session', value: 'abc123', domain: '.example.com', ... }
+ * ]);
+ * console.log(output);
+ * ```
+ */
+export declare function formatCookies(cookies: Cookie[]): string;
+//# sourceMappingURL=cookies.d.ts.map

package/dist/ui/formatters/cookies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookies.d.ts","sourceRoot":"","sources":["../../../src/ui/formatters/cookies.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;CACtC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAmCvD"}

package/dist/ui/formatters/cookies.js

@@ -0,0 +1,45 @@
+/**
+ * Cookie formatter for human-readable output.
+ */
+import { OutputFormatter, pluralize } from '../../ui/formatting.js';
+/**
+ * Format cookies for human-readable output.
+ *
+ * @param cookies - Array of CDP cookies
+ * @returns Formatted cookie list
+ *
+ * @example
+ * ```typescript
+ * const output = formatCookies([
+ *   { name: 'session', value: 'abc123', domain: '.example.com', ... }
+ * ]);
+ * console.log(output);
+ * ```
+ */
+export function formatCookies(cookies) {
+    if (cookies.length === 0) {
+        return 'No cookies found';
+    }
+    const fmt = new OutputFormatter();
+    fmt.text(`${pluralize(cookies.length, 'Cookie', 'Cookies')}:`).blank();
+    cookies.forEach((cookie, index) => {
+        fmt.text(`[${index + 1}] ${cookie.name}`);
+        const expires = cookie.expires && cookie.expires !== -1
+            ? new Date(cookie.expires * 1000).toISOString()
+            : 'Session';
+        fmt.list([
+            `Value: ${cookie.value}`,
+            `Domain: ${cookie.domain}`,
+            `Path: ${cookie.path}`,
+            `Expires: ${expires}`,
+            `HttpOnly: ${cookie.httpOnly ? 'Yes' : 'No'}`,
+            `Secure: ${cookie.secure ? 'Yes' : 'No'}`,
+            `SameSite: ${cookie.sameSite ?? 'None'}`,
+        ], 2);
+        if (index < cookies.length - 1) {
+            fmt.blank();
+        }
+    });
+    return fmt.build();
+}
+//# sourceMappingURL=cookies.js.map

package/dist/ui/formatters/cookies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookies.js","sourceRoot":"","sources":["../../../src/ui/formatters/cookies.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAgBhE;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa,CAAC,OAAiB;IAC7C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,eAAe,EAAE,CAAC;IAClC,GAAG,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;IAEvE,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QAChC,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,GAAG,CAAC,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAE1C,MAAM,OAAO,GACX,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,CAAC;YACrC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE;YAC/C,CAAC,CAAC,SAAS,CAAC;QAEhB,GAAG,CAAC,IAAI,CACN;YACE,UAAU,MAAM,CAAC,KAAK,EAAE;YACxB,WAAW,MAAM,CAAC,MAAM,EAAE;YAC1B,SAAS,MAAM,CAAC,IAAI,EAAE;YACtB,YAAY,OAAO,EAAE;YACrB,aAAa,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;YAC7C,WAAW,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;YACzC,aAAa,MAAM,CAAC,QAAQ,IAAI,MAAM,EAAE;SACzC,EACD,CAAC,CACF,CAAC;QAEF,IAAI,KAAK,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,GAAG,CAAC,KAAK,EAAE,CAAC;QACd,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC,KAAK,EAAE,CAAC;AACrB,CAAC"}

package/dist/ui/formatters/details.d.ts

@@ -0,0 +1,10 @@
+import type { NetworkRequest, ConsoleMessage } from '../../types';
+/**
+ * Format network request details for human-readable output
+ */
+export declare function formatNetworkDetails(request: NetworkRequest): string;
+/**
+ * Format console message details for human-readable output
+ */
+export declare function formatConsoleDetails(message: ConsoleMessage): string;
+//# sourceMappingURL=details.d.ts.map

package/dist/ui/formatters/details.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"details.d.ts","sourceRoot":"","sources":["../../../src/ui/formatters/details.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAG9D;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CA4CpE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAsBpE"}

package/dist/ui/formatters/details.js

@@ -0,0 +1,61 @@
+import { OutputFormatter } from '../../ui/formatting.js';
+/**
+ * Format network request details for human-readable output
+ */
+export function formatNetworkDetails(request) {
+    const fmt = new OutputFormatter();
+    fmt.text('Network Request Details').separator('━', 70);
+    fmt.keyValueList([
+        ['Request ID', request.requestId],
+        ['URL', request.url],
+        ['Method', request.method],
+        ['Status', request.status?.toString() ?? 'pending'],
+        ['MIME Type', request.mimeType ?? 'N/A'],
+    ], 13);
+    fmt.blank();
+    if (request.requestHeaders) {
+        fmt.text('Request Headers:').separator('━', 70);
+        Object.entries(request.requestHeaders).forEach(([key, value]) => {
+            fmt.text(`  ${key}: ${value}`);
+        });
+        fmt.blank();
+    }
+    if (request.requestBody) {
+        fmt.text('Request Body:').separator('━', 70);
+        fmt.text(request.requestBody);
+        fmt.blank();
+    }
+    if (request.responseHeaders) {
+        fmt.text('Response Headers:').separator('━', 70);
+        Object.entries(request.responseHeaders).forEach(([key, value]) => {
+            fmt.text(`  ${key}: ${value}`);
+        });
+        fmt.blank();
+    }
+    if (request.responseBody) {
+        fmt.text('Response Body:').separator('━', 70);
+        fmt.text(request.responseBody);
+    }
+    return fmt.build();
+}
+/**
+ * Format console message details for human-readable output
+ */
+export function formatConsoleDetails(message) {
+    const fmt = new OutputFormatter();
+    fmt.text('Console Message Details').separator('━', 70);
+    fmt.keyValueList([
+        ['Type', message.type],
+        ['Timestamp', new Date(message.timestamp).toISOString()],
+        ['Text', message.text],
+    ], 12);
+    fmt.blank();
+    if (message.args && message.args.length > 0) {
+        fmt.text('Arguments:').separator('━', 70);
+        message.args.forEach((arg, idx) => {
+            fmt.text(`  [${idx}]: ${JSON.stringify(arg, null, 2)}`);
+        });
+    }
+    return fmt.build();
+}
+//# sourceMappingURL=details.js.map

package/dist/ui/formatters/details.js.map

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

package/dist/ui/formatters/dom.d.ts

@@ -0,0 +1,135 @@
+import type { DomQueryData, DomHighlightData, DomGetData } from '../../ipc/commands.js';
+/**
+ * Format DOM query results for human-readable output.
+ *
+ * Displays found elements with their index, tag, classes, and preview text.
+ * Shows helpful message when no elements are found.
+ *
+ * @param data - DOM query result containing selector, count, and matching nodes
+ * @returns Formatted output string
+ *
+ * @example
+ * ```typescript
+ * formatDomQuery({
+ *   selector: '.error',
+ *   count: 2,
+ *   nodes: [
+ *     { index: 0, nodeId: 123, tag: 'div', classes: ['error'], preview: 'Invalid input' },
+ *     { index: 1, nodeId: 456, tag: 'span', classes: ['error'], preview: 'Required field' }
+ *   ]
+ * });
+ * // Output:
+ * // Found 2 elements matching ".error":
+ * //   [0] <div class="error"> Invalid input
+ * //   [1] <span class="error"> Required field
+ * ```
+ */
+export declare function formatDomQuery(data: DomQueryData): string;
+/**
+ * Format DOM highlight results for human-readable output.
+ *
+ * Displays success message with count of highlighted elements.
+ *
+ * @param data - DOM highlight result containing count of highlighted elements
+ * @returns Formatted output string
+ *
+ * @example
+ * ```typescript
+ * formatDomHighlight({ highlighted: 3, nodeIds: [123, 456, 789] });
+ * // Output: ✓ Highlighted 3 elements
+ * ```
+ */
+export declare function formatDomHighlight(data: DomHighlightData): string;
+/**
+ * Format DOM get results for human-readable output.
+ *
+ * Displays full outerHTML for matched elements. For single elements, shows HTML directly.
+ * For multiple elements, shows numbered list with HTML for each.
+ *
+ * @param data - DOM get result containing array of nodes with outerHTML
+ * @returns Formatted output string
+ *
+ * @example
+ * ```typescript
+ * // Single element
+ * formatDomGet({
+ *   nodes: [{ nodeId: 123, outerHTML: '<div class="error">Invalid input</div>' }]
+ * });
+ * // Output: <div class="error">Invalid input</div>
+ *
+ * // Multiple elements
+ * formatDomGet({
+ *   nodes: [
+ *     { nodeId: 123, outerHTML: '<div class="error">Error 1</div>' },
+ *     { nodeId: 456, outerHTML: '<span class="error">Error 2</span>' }
+ *   ]
+ * });
+ * // Output:
+ * // [1] <div class="error">Error 1</div>
+ * // [2] <span class="error">Error 2</span>
+ * ```
+ */
+export declare function formatDomGet(data: DomGetData): string;
+/**
+ * Format DOM eval results for human-readable output.
+ *
+ * Outputs the evaluated JavaScript result as formatted JSON.
+ *
+ * @param data - DOM eval result containing the evaluated value
+ * @returns Formatted JSON string
+ *
+ * @example
+ * ```typescript
+ * formatDomEval({ result: 'My Page Title' });
+ * // Output: "My Page Title"
+ *
+ * formatDomEval({ result: { url: 'https://example.com', title: 'Example' } });
+ * // Output:
+ * // {
+ * //   "url": "https://example.com",
+ * //   "title": "Example"
+ * // }
+ * ```
+ */
+export declare function formatDomEval(data: {
+    result: unknown;
+}): string;
+/**
+ * Format screenshot capture result for human-readable display.
+ *
+ * @param data - Screenshot metadata
+ * @returns Formatted string with screenshot details
+ *
+ * @example
+ * ```typescript
+ * formatDomScreenshot({
+ *   path: '/path/to/screenshot.png',
+ *   format: 'png',
+ *   width: 1920,
+ *   height: 1080,
+ *   size: 245632,
+ *   fullPage: true
+ * });
+ * // Output:
+ * // Screenshot captured
+ * // Path: /path/to/screenshot.png
+ * // Format: png
+ * // Dimensions: 1920x1080
+ * // Size: 240.0 KB
+ * // Full page: yes
+ * ```
+ */
+export declare function formatDomScreenshot(data: {
+    path: string;
+    format: 'png' | 'jpeg';
+    quality?: number;
+    width: number;
+    height: number;
+    size: number;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    fullPage: boolean;
+}): string;
+//# sourceMappingURL=dom.d.ts.map

package/dist/ui/formatters/dom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../../src/ui/formatters/dom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CA8BzD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAWjE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAcrD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAE/D;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,QAAQ,EAAE,OAAO,CAAC;CACnB,GAAG,MAAM,CAyBT"}

package/dist/ui/formatters/dom.js

@@ -0,0 +1,193 @@
+import { OutputFormatter } from '../../ui/formatting.js';
+/**
+ * Format DOM query results for human-readable output.
+ *
+ * Displays found elements with their index, tag, classes, and preview text.
+ * Shows helpful message when no elements are found.
+ *
+ * @param data - DOM query result containing selector, count, and matching nodes
+ * @returns Formatted output string
+ *
+ * @example
+ * ```typescript
+ * formatDomQuery({
+ *   selector: '.error',
+ *   count: 2,
+ *   nodes: [
+ *     { index: 0, nodeId: 123, tag: 'div', classes: ['error'], preview: 'Invalid input' },
+ *     { index: 1, nodeId: 456, tag: 'span', classes: ['error'], preview: 'Required field' }
+ *   ]
+ * });
+ * // Output:
+ * // Found 2 elements matching ".error":
+ * //   [0] <div class="error"> Invalid input
+ * //   [1] <span class="error"> Required field
+ * ```
+ */
+export function formatDomQuery(data) {
+    const { count, nodes, selector } = data;
+    const fmt = new OutputFormatter();
+    if (count === 0) {
+        return fmt
+            .text(`No elements found matching "${selector}"`)
+            .blank()
+            .section('Suggestions:', [
+            `Verify selector: bdg dom eval "document.querySelector('${selector}')"`,
+            'List elements:   bdg dom query "*"',
+        ])
+            .build();
+    }
+    const nodeLines = nodes.map((node) => {
+        const classInfo = node.classes?.length ? ` class="${node.classes.join(' ')}"` : '';
+        return `[${node.index}] <${node.tag}${classInfo}> ${node.preview}`;
+    });
+    return fmt
+        .text(`Found ${count} element${count === 1 ? '' : 's'} matching "${selector}":`)
+        .list(nodeLines)
+        .blank()
+        .section('Next steps:', [
+        'Highlight:  bdg dom highlight <index>',
+        'Get HTML:   bdg dom get <index>',
+        'Inspect:    bdg details dom <index>',
+    ])
+        .build();
+}
+/**
+ * Format DOM highlight results for human-readable output.
+ *
+ * Displays success message with count of highlighted elements.
+ *
+ * @param data - DOM highlight result containing count of highlighted elements
+ * @returns Formatted output string
+ *
+ * @example
+ * ```typescript
+ * formatDomHighlight({ highlighted: 3, nodeIds: [123, 456, 789] });
+ * // Output: ✓ Highlighted 3 elements
+ * ```
+ */
+export function formatDomHighlight(data) {
+    const fmt = new OutputFormatter();
+    return fmt
+        .text(`✓ Highlighted ${data.highlighted} element${data.highlighted === 1 ? '' : 's'}`)
+        .blank()
+        .section('Next steps:', [
+        'Get HTML:   bdg dom get <index>',
+        'Query more: bdg dom query <selector>',
+    ])
+        .build();
+}
+/**
+ * Format DOM get results for human-readable output.
+ *
+ * Displays full outerHTML for matched elements. For single elements, shows HTML directly.
+ * For multiple elements, shows numbered list with HTML for each.
+ *
+ * @param data - DOM get result containing array of nodes with outerHTML
+ * @returns Formatted output string
+ *
+ * @example
+ * ```typescript
+ * // Single element
+ * formatDomGet({
+ *   nodes: [{ nodeId: 123, outerHTML: '<div class="error">Invalid input</div>' }]
+ * });
+ * // Output: <div class="error">Invalid input</div>
+ *
+ * // Multiple elements
+ * formatDomGet({
+ *   nodes: [
+ *     { nodeId: 123, outerHTML: '<div class="error">Error 1</div>' },
+ *     { nodeId: 456, outerHTML: '<span class="error">Error 2</span>' }
+ *   ]
+ * });
+ * // Output:
+ * // [1] <div class="error">Error 1</div>
+ * // [2] <span class="error">Error 2</span>
+ * ```
+ */
+export function formatDomGet(data) {
+    const { nodes } = data;
+    if (nodes.length === 1) {
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        return nodes[0].outerHTML ?? '';
+    }
+    const fmt = new OutputFormatter();
+    nodes.forEach((node, i) => {
+        fmt.text(`[${i + 1}] ${node.outerHTML}`);
+    });
+    return fmt.build();
+}
+/**
+ * Format DOM eval results for human-readable output.
+ *
+ * Outputs the evaluated JavaScript result as formatted JSON.
+ *
+ * @param data - DOM eval result containing the evaluated value
+ * @returns Formatted JSON string
+ *
+ * @example
+ * ```typescript
+ * formatDomEval({ result: 'My Page Title' });
+ * // Output: "My Page Title"
+ *
+ * formatDomEval({ result: { url: 'https://example.com', title: 'Example' } });
+ * // Output:
+ * // {
+ * //   "url": "https://example.com",
+ * //   "title": "Example"
+ * // }
+ * ```
+ */
+export function formatDomEval(data) {
+    return JSON.stringify(data.result, null, 2);
+}
+/**
+ * Format screenshot capture result for human-readable display.
+ *
+ * @param data - Screenshot metadata
+ * @returns Formatted string with screenshot details
+ *
+ * @example
+ * ```typescript
+ * formatDomScreenshot({
+ *   path: '/path/to/screenshot.png',
+ *   format: 'png',
+ *   width: 1920,
+ *   height: 1080,
+ *   size: 245632,
+ *   fullPage: true
+ * });
+ * // Output:
+ * // Screenshot captured
+ * // Path: /path/to/screenshot.png
+ * // Format: png
+ * // Dimensions: 1920x1080
+ * // Size: 240.0 KB
+ * // Full page: yes
+ * ```
+ */
+export function formatDomScreenshot(data) {
+    const fmt = new OutputFormatter();
+    // Format file size
+    const sizeKB = data.size / 1024;
+    const sizeStr = sizeKB < 1024 ? `${sizeKB.toFixed(1)} KB` : `${(sizeKB / 1024).toFixed(1)} MB`;
+    fmt
+        .text('Screenshot captured')
+        .blank()
+        .keyValueList([
+        ['Path', data.path],
+        ['Format', data.format.toUpperCase()],
+        ...(data.format === 'jpeg' && data.quality !== undefined
+            ? [['Quality', `${data.quality}%`]]
+            : []),
+        ['Dimensions', `${data.width}x${data.height}`],
+        ['Size', sizeStr],
+        ['Full page', data.fullPage ? 'yes' : 'no'],
+        ...(data.viewport
+            ? [['Viewport', `${data.viewport.width}x${data.viewport.height}`]]
+            : []),
+    ]);
+    return fmt.build();
+}
+//# sourceMappingURL=dom.js.map

package/dist/ui/formatters/dom.js.map

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

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

@@ -0,0 +1,11 @@
+/**
+ * Data formatters for human-readable output.
+ *
+ * Re-exports all formatter modules for easy importing.
+ */
+export * from './cookies.js';
+export * from './dom.js';
+export * from './status.js';
+export * from './preview.js';
+export * from './details.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ui/formatters/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}

package/dist/ui/formatters/index.js

@@ -0,0 +1,11 @@
+/**
+ * Data formatters for human-readable output.
+ *
+ * Re-exports all formatter modules for easy importing.
+ */
+export * from './cookies.js';
+export * from './dom.js';
+export * from './status.js';
+export * from './preview.js';
+export * from './details.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ui/formatters/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}

package/dist/ui/formatters/preview.d.ts

@@ -0,0 +1,25 @@
+import type { BdgOutput } from '../../types';
+/**
+ * Flags that shape how preview output is rendered for `bdg peek`.
+ */
+export interface PreviewOptions {
+    /** Emit raw JSON instead of formatted text. */
+    json?: boolean;
+    /** Limit output to network requests (ignores console data). */
+    network?: boolean;
+    /** Limit output to console messages (ignores network data). */
+    console?: boolean;
+    /** Number of recent entries to include (parsed as integer). */
+    last: string;
+    /** Use the expanded, human-friendly layout. */
+    verbose?: boolean;
+    /** Stream updates until interrupted (tail-like behaviour). */
+    follow?: boolean;
+    /** Current view timestamp (for follow mode to show refresh time). */
+    viewedAt?: Date;
+}
+/**
+ * Format preview output (peek command)
+ */
+export declare function formatPreview(output: BdgOutput, options: PreviewOptions): string;
+//# sourceMappingURL=preview.d.ts.map

package/dist/ui/formatters/preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../../src/ui/formatters/preview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AASzC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,+DAA+D;IAC/D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CAMhF"}