browser-debugger-cli 0.13.0 → 0.15.0

package/dist/ui/OutputBuilder.d.ts

@@ -9,6 +9,16 @@ import type { BdgResponse } from '../types.js';
  * @returns `{ version, success: true, data }`
  */
 export declare function buildSuccessResponse<T>(data: T): BdgResponse<T>;
+/**
+ * Serialize a `--json` response envelope for stdout.
+ *
+ * Indented by two spaces when stdout is a terminal, so a person can read it;
+ * on one line otherwise, since agents and pipes only pay for the whitespace.
+ *
+ * @param envelope - Response envelope (or other `--json` payload)
+ * @returns JSON text
+ */
+export declare function stringifyEnvelope(envelope: unknown): string;
 /** Builders for JSON error envelopes. */
 export declare class OutputBuilder {
     /**

package/dist/ui/OutputBuilder.js

@@ -11,6 +11,18 @@ import { VERSION } from '../utils/version.js';
 export function buildSuccessResponse(data) {
     return { version: VERSION, success: true, data };
 }
+/**
+ * Serialize a `--json` response envelope for stdout.
+ *
+ * Indented by two spaces when stdout is a terminal, so a person can read it;
+ * on one line otherwise, since agents and pipes only pay for the whitespace.
+ *
+ * @param envelope - Response envelope (or other `--json` payload)
+ * @returns JSON text
+ */
+export function stringifyEnvelope(envelope) {
+    return process.stdout.isTTY ? JSON.stringify(envelope, null, 2) : JSON.stringify(envelope);
+}
 /** Builders for JSON error envelopes. */
 export class OutputBuilder {
     /**

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

@@ -1,5 +1,5 @@
 import type { DomContext } from '../../types.js';
-import type { A11yTree, A11yQueryResult, A11yNode } from '../../types.js';
+import type { A11yQueryResult, A11yNode, ListedA11yTree } from '../../types.js';
 /**
  * Data structure for a11y node with DOM context.
  */
@@ -8,15 +8,13 @@ interface A11yNodeWithContext {
     domContext: DomContext | null;
 }
 /**
- * Format accessibility tree for human-readable output.
+ * Format the listed part of an accessibility tree for human-readable output:
+ * one indented line per node, and when nodes were cut, how to see more.
  *
- * Displays the tree structure with role, name, and key properties.
- * Shows up to 50 nodes by default for manageable output.
- *
- * @param tree - Accessibility tree data
+ * @param tree - Listed accessibility tree
  * @returns Formatted output string
  */
-export declare function formatA11yTree(tree: A11yTree): string;
+export declare function formatA11yTree(tree: ListedA11yTree): string;
 /**
  * Format query result for human-readable output.
  *

package/dist/ui/formatters/a11y.js

@@ -1,79 +1,25 @@
 import { OutputFormatter, areHintsHidden } from '../formatting.js';
-import { a11yMoreMatchesNote } from '../messages/commands.js';
-/**
- * Maximum number of nodes to display in tree output before truncating.
- * Prevents overwhelming terminal output for large accessibility trees.
- */
-const MAX_TREE_NODES_DISPLAY = 50;
+import { a11yMoreMatchesNote, a11yTreeMoreNote, a11yTreeShownNote, } from '../messages/commands.js';
 /**
  * Separator width for section dividers in formatted output.
  */
 const SEPARATOR_WIDTH = 50;
 /**
- * Format accessibility tree for human-readable output.
- *
- * Displays the tree structure with role, name, and key properties.
- * Shows up to 50 nodes by default for manageable output.
+ * Format the listed part of an accessibility tree for human-readable output:
+ * one indented line per node, and when nodes were cut, how to see more.
  *
- * @param tree - Accessibility tree data
+ * @param tree - Listed accessibility tree
  * @returns Formatted output string
  */
 export function formatA11yTree(tree) {
     const fmt = new OutputFormatter();
     fmt.text(`Accessibility Tree (${tree.count} nodes)`).separator('─', SEPARATOR_WIDTH).blank();
-    const { lines, truncated } = treeLines(tree);
-    lines.forEach((line) => fmt.text(line));
-    if (truncated) {
-        fmt
-            .blank()
-            .text(`Showing the first ${MAX_TREE_NODES_DISPLAY} nodes (text boxes and repeated text left out)`)
-            .text('Use --json flag for complete output, or bdg dom a11y query "role:<role>" to search');
+    tree.nodes.forEach((node) => fmt.text('  '.repeat(node.depth) + formatA11yNodeOneLine(node)));
+    if (tree.omitted) {
+        fmt.blank().text(a11yTreeShownNote(tree.nodes.length)).text(a11yTreeMoreNote(tree.omitted));
     }
     return fmt.build();
 }
-/** Roles that only lay out their children and say nothing themselves */
-const LAYOUT_ROLES = new Set([
-    'generic',
-    'none',
-    'presentation',
-    'LayoutTable',
-    'LayoutTableRow',
-    'LayoutTableCell',
-]);
-/**
- * The tree as indented lines, depth-first from the root. Text boxes, blank
- * text, text that repeats its parent's name, and nameless layout wrappers are left out
- * (their children move up a level), so the budget goes to meaningful nodes.
- *
- * @param tree - Accessibility tree
- * @returns Up to {@link MAX_TREE_NODES_DISPLAY} lines, and whether nodes were left
- */
-function treeLines(tree) {
-    const lines = [];
-    const visited = new Set();
-    let truncated = false;
-    const visit = (node, depth, parentName) => {
-        if (visited.has(node.nodeId))
-            return;
-        visited.add(node.nodeId);
-        if (lines.length >= MAX_TREE_NODES_DISPLAY) {
-            truncated = true;
-            return;
-        }
-        const skip = node.role === 'InlineTextBox' ||
-            (node.role === 'StaticText' && (node.name === parentName || !node.name?.trim())) ||
-            (LAYOUT_ROLES.has(node.role) && !node.name);
-        if (!skip)
-            lines.push('  '.repeat(depth) + formatA11yNodeOneLine(node));
-        for (const childId of node.childIds ?? []) {
-            const child = tree.nodes.get(childId);
-            if (child)
-                visit(child, skip ? depth : depth + 1, node.name ?? parentName);
-        }
-    };
-    visit(tree.root, 0, undefined);
-    return { lines, truncated };
-}
 /** Roles whose elements take a value (the next step is fill, not click) */
 const FILLABLE_ROLES = new Set([
     'textbox',

package/dist/ui/formatters/console/chronological.js

@@ -2,11 +2,11 @@
  * Chronological list view (--list mode): all messages with timestamps,
  * level prefixes, and navigation reload markers.
  */
+import { MAX_CONSOLE_TEXT_LENGTH } from '../../../constants.js';
+import { capForDisplay } from '../longValues.js';
 import { OutputFormatter } from '../../formatting.js';
 import { consoleDroppedNote, consoleIndexGapNote } from '../../messages/consoleMessages.js';
-import { truncateByLength } from '../../../utils/strings.js';
 import { formatSourceLocation, formatTimestamp } from './shared.js';
-const MAX_LIST_TEXT_LENGTH = 200;
 /**
  * Format console output as chronological list (--list mode).
  *
@@ -46,8 +46,8 @@ export function formatConsoleChronological(messages, options) {
             }
             lastNavigationId = msg.navigationId;
         }
-        const truncatedText = truncateByLength(msg.text, MAX_LIST_TEXT_LENGTH);
-        fmt.text(`${index}  ${level} ${time}  ${truncatedText}`);
+        const text = capForDisplay(msg.text, MAX_CONSOLE_TEXT_LENGTH, options.full);
+        fmt.text(`${index}  ${level} ${time}  ${text}`);
         const source = formatSourceLocation(msg.stackTrace);
         if (source) {
             fmt.text(`${sourceIndent}→ ${source}`);

package/dist/ui/formatters/console/follow.d.ts

@@ -6,14 +6,16 @@ import type { ConsoleMessage } from '../../../types.js';
 /**
  * Lines of the console stream: the new messages since the last poll, with
  * a rule the first time (the stream banner is on stderr) and a separator
- * after a navigation.
+ * after a navigation. Texts are cut like `console --list` cuts them.
  *
  * @param messages - New messages
- * @param options - `header` the first time; `navigationId` when the page changed
+ * @param options - `header` the first time; `navigationId` when the page
+ *   changed; `full` to print the texts whole
  * @returns Text to print (empty when there is nothing new)
  */
 export declare function formatConsoleFollowLines(messages: ConsoleMessage[], options?: {
     header?: boolean;
     navigationId?: number;
+    full?: boolean | undefined;
 }): string;
 //# sourceMappingURL=follow.d.ts.map

package/dist/ui/formatters/console/follow.js

@@ -2,15 +2,18 @@
  * Follow-mode (live streaming) view. Compact format optimised for
  * repeated polling output.
  */
+import { MAX_CONSOLE_TEXT_LENGTH } from '../../../constants.js';
+import { capForDisplay } from '../longValues.js';
 import { OutputFormatter } from '../../formatting.js';
 import { formatSourceLocation, formatTimestamp } from './shared.js';
 /**
  * Lines of the console stream: the new messages since the last poll, with
  * a rule the first time (the stream banner is on stderr) and a separator
- * after a navigation.
+ * after a navigation. Texts are cut like `console --list` cuts them.
  *
  * @param messages - New messages
- * @param options - `header` the first time; `navigationId` when the page changed
+ * @param options - `header` the first time; `navigationId` when the page
+ *   changed; `full` to print the texts whole
  * @returns Text to print (empty when there is nothing new)
  */
 export function formatConsoleFollowLines(messages, options = {}) {
@@ -26,7 +29,7 @@ export function formatConsoleFollowLines(messages, options = {}) {
     for (const msg of messages) {
         const time = formatTimestamp(msg.timestamp);
         const level = msg.type.padEnd(7);
-        fmt.text(`${time} ${level} ${msg.text}`);
+        fmt.text(`${time} ${level} ${capForDisplay(msg.text, MAX_CONSOLE_TEXT_LENGTH, options.full)}`);
         const source = formatSourceLocation(msg.stackTrace);
         if (source)
             fmt.text(`                → ${source}`);

package/dist/ui/formatters/console/json.d.ts

@@ -7,15 +7,12 @@ import type { ConsoleMessage } from '../../../types.js';
 import { type ConsoleFormatOptions, type ConsoleJsonOutput } from './shared.js';
 /**
  * Build the rich JSON output shape (summary + the newest deduped
- * errors/warnings, plus the message list when --list is requested).
+ * errors/warnings, plus the message list when --list is requested). Texts
+ * longer than 10000 characters are cut with
+ * `truncatedFrom`, unless `--full`.
  *
  * Returns a plain object so callers (e.g. runCommand's JSON envelope) can
  * embed it without re-parsing a stringified payload.
  */
 export declare function buildConsoleJsonOutput(messages: ConsoleMessage[], options: ConsoleFormatOptions): ConsoleJsonOutput;
-/**
- * Format console output as a JSON string. Thin wrapper around
- * buildConsoleJsonOutput for callers that want a serialized payload.
- */
-export declare function formatConsoleJson(messages: ConsoleMessage[], options: ConsoleFormatOptions): string;
 //# sourceMappingURL=json.d.ts.map

package/dist/ui/formatters/console/json.js

@@ -4,7 +4,7 @@
  * --list is set.
  */
 import { lastMessages } from './chronological.js';
-import { analyzeMessages, newestGroups, } from './shared.js';
+import { analyzeMessages, capMessageText, newestGroups, } from './shared.js';
 function toJsonError(dedup, includeStackTrace) {
     const source = dedup.message.stackTrace?.[0];
     return {
@@ -26,7 +26,9 @@ function toJsonError(dedup, includeStackTrace) {
 }
 /**
  * Build the rich JSON output shape (summary + the newest deduped
- * errors/warnings, plus the message list when --list is requested).
+ * errors/warnings, plus the message list when --list is requested). Texts
+ * longer than 10000 characters are cut with
+ * `truncatedFrom`, unless `--full`.
  *
  * Returns a plain object so callers (e.g. runCommand's JSON envelope) can
  * embed it without re-parsing a stringified payload.
@@ -37,22 +39,16 @@ export function buildConsoleJsonOutput(messages, options) {
     const warnings = newestGroups(grouped.warnings, options.groupLimit);
     const output = {
         summary,
-        errors: errors.shown.map((d) => toJsonError(d, true)),
-        warnings: warnings.shown.map((d) => toJsonError(d, false)),
+        errors: errors.shown.map((d) => capMessageText(toJsonError(d, true), options.full)),
+        warnings: warnings.shown.map((d) => capMessageText(toJsonError(d, false), options.full)),
         ...(errors.more > 0 && { moreErrors: errors.more }),
         ...(warnings.more > 0 && { moreWarnings: warnings.more }),
         ...(options.dropped && { dropped: options.dropped }),
         ...(options.pageCrashedAt !== undefined && { pageCrashedAt: options.pageCrashedAt }),
     };
-    if (options.list)
-        output.messages = lastMessages(messages, options.last);
+    if (options.list) {
+        output.messages = lastMessages(messages, options.last).map((message) => capMessageText(message, options.full));
+    }
     return output;
 }
-/**
- * Format console output as a JSON string. Thin wrapper around
- * buildConsoleJsonOutput for callers that want a serialized payload.
- */
-export function formatConsoleJson(messages, options) {
-    return JSON.stringify(buildConsoleJsonOutput(messages, options), null, 2);
-}
 //# sourceMappingURL=json.js.map

package/dist/ui/formatters/console/shared.d.ts

@@ -43,8 +43,6 @@ export interface ConsoleSummary {
  * Options for console formatting.
  */
 export interface ConsoleFormatOptions {
-    /** Output as JSON */
-    json?: boolean | undefined;
     /** List all messages chronologically (--list flag) */
     list?: boolean | undefined;
     /** Follow mode (live streaming) */
@@ -63,6 +61,8 @@ export interface ConsoleFormatOptions {
     dropped?: number | undefined;
     /** When the page crashed (epoch ms), while it is not loaded again */
     pageCrashedAt?: number | undefined;
+    /** Print message texts whole (`--full`) */
+    full?: boolean | undefined;
 }
 /** Distinct errors and warnings the summary lists without `--last` */
 export declare const DEFAULT_GROUP_LIMIT = 50;
@@ -95,6 +95,8 @@ export interface JsonErrorEntry {
     count: number;
     level: string;
     text: string;
+    /** Original length of `text` when it was cut (`--full` keeps it whole) */
+    truncatedFrom?: number;
     /** Position in the session's message list (what `details console <n>` takes) */
     index?: number;
     /** Where it came from; no line/column for a resource URL (e.g. a failed load) */
@@ -175,4 +177,17 @@ export declare function formatSectionHeader(label: string, unique: number, total
  * @returns Location text
  */
 export declare function formatFramePosition(frame: StackFrame): string;
+/**
+ * A console message (or error entry) for JSON output: its text cut to
+ * {@link MAX_CONSOLE_JSON_TEXT_LENGTH} characters with `truncatedFrom`, or
+ * whole with `--full`.
+ *
+ * @param message - Message with a text
+ * @param full - `--full`: keep the text whole
+ * @returns The message, with the text cut when too long
+ */
+export declare function capMessageText<T extends {
+    text: string;
+    truncatedFrom?: number;
+}>(message: T, full: boolean | undefined): T;
 //# sourceMappingURL=shared.d.ts.map

package/dist/ui/formatters/console/shared.js

@@ -1,6 +1,8 @@
 /**
  * Shared types, constants, and helpers used by every console formatter.
  */
+import { MAX_CONSOLE_JSON_TEXT_LENGTH } from '../../../constants.js';
+import { capLength } from '../../../utils/strings.js';
 /** Distinct errors and warnings the summary lists without `--last` */
 export const DEFAULT_GROUP_LIMIT = 50;
 /**
@@ -171,4 +173,19 @@ export function formatFramePosition(frame) {
         ? frame.url
         : `${frame.url}:${frame.lineNumber + 1}:${frame.columnNumber + 1}`;
 }
+/**
+ * A console message (or error entry) for JSON output: its text cut to
+ * {@link MAX_CONSOLE_JSON_TEXT_LENGTH} characters with `truncatedFrom`, or
+ * whole with `--full`.
+ *
+ * @param message - Message with a text
+ * @param full - `--full`: keep the text whole
+ * @returns The message, with the text cut when too long
+ */
+export function capMessageText(message, full) {
+    if (full)
+        return message;
+    const { text, truncatedFrom } = capLength(message.text, MAX_CONSOLE_JSON_TEXT_LENGTH);
+    return truncatedFrom === undefined ? message : { ...message, text, truncatedFrom };
+}
 //# sourceMappingURL=shared.js.map

package/dist/ui/formatters/console/summarize.d.ts

@@ -10,8 +10,8 @@ import { type ConsoleFormatOptions } from './shared.js';
  * dropped its oldest messages.
  *
  * @param messages - Messages to summarise
- * @param options - Distinct messages listed and messages dropped
+ * @param options - Distinct messages listed, messages dropped and `--full`
  * @returns Summary
  */
-export declare function formatConsoleSummary(messages: ConsoleMessage[], options?: Pick<ConsoleFormatOptions, 'groupLimit' | 'dropped'>): string;
+export declare function formatConsoleSummary(messages: ConsoleMessage[], options?: Pick<ConsoleFormatOptions, 'groupLimit' | 'dropped' | 'full'>): string;
 //# sourceMappingURL=summarize.d.ts.map

package/dist/ui/formatters/console/summarize.js

@@ -2,9 +2,21 @@
  * Smart summary view: prioritises errors and warnings with deduplication
  * and shows info/debug/other as count-only footer entries.
  */
+import { MAX_CONSOLE_TEXT_LENGTH } from '../../../constants.js';
+import { capForDisplay } from '../longValues.js';
 import { OutputFormatter, pluralize } from '../../formatting.js';
 import { consoleDroppedNote, consoleMoreGroupsNote } from '../../messages/consoleMessages.js';
 import { analyzeMessages, formatCountPrefix, formatSectionHeader, formatSourceLocation, newestGroups, } from './shared.js';
+/**
+ * A message's text cut like `console --list` cuts it, or whole with `--full`.
+ *
+ * @param message - Message
+ * @param full - `--full`
+ * @returns Text to print
+ */
+function messageText(message, full) {
+    return capForDisplay(message.text, MAX_CONSOLE_TEXT_LENGTH, full);
+}
 /**
  * The errors: the newest distinct ones, with a note for the earlier ones.
  *
@@ -12,8 +24,9 @@ import { analyzeMessages, formatCountPrefix, formatSectionHeader, formatSourceLo
  * @param errors - Distinct errors in order of first appearance
  * @param total - Errors logged
  * @param limit - Distinct errors listed (0 = all)
+ * @param full - Print the texts whole (`--full`)
  */
-function renderErrorSection(fmt, errors, total, limit) {
+function renderErrorSection(fmt, errors, total, limit, full) {
     if (errors.length === 0)
         return;
     const { shown, more } = newestGroups(errors, limit);
@@ -22,7 +35,7 @@ function renderErrorSection(fmt, errors, total, limit) {
     if (more > 0)
         fmt.text(consoleMoreGroupsNote(more, 'error')).blank();
     for (const { message, count } of shown) {
-        fmt.text(`${formatCountPrefix(count)}${message.text}`);
+        fmt.text(`${formatCountPrefix(count)}${messageText(message, full)}`);
         const source = formatSourceLocation(message.stackTrace);
         if (source) {
             fmt.text(`     → ${source}`);
@@ -37,8 +50,9 @@ function renderErrorSection(fmt, errors, total, limit) {
  * @param warnings - Distinct warnings in order of first appearance
  * @param total - Warnings logged
  * @param limit - Distinct warnings listed (0 = all)
+ * @param full - Print the texts whole (`--full`)
  */
-function renderWarningSection(fmt, warnings, total, limit) {
+function renderWarningSection(fmt, warnings, total, limit, full) {
     if (warnings.length === 0)
         return;
     const { shown, more } = newestGroups(warnings, limit);
@@ -47,7 +61,7 @@ function renderWarningSection(fmt, warnings, total, limit) {
     if (more > 0)
         fmt.text(consoleMoreGroupsNote(more, 'warning'));
     for (const { message, count } of shown) {
-        fmt.text(`• ${formatCountPrefix(count)}${message.text}`);
+        fmt.text(`• ${formatCountPrefix(count)}${messageText(message, full)}`);
         const source = formatSourceLocation(message.stackTrace);
         if (source)
             fmt.text(`     → ${source}`);
@@ -71,7 +85,7 @@ function renderOtherSummary(fmt, summary) {
  * dropped its oldest messages.
  *
  * @param messages - Messages to summarise
- * @param options - Distinct messages listed and messages dropped
+ * @param options - Distinct messages listed, messages dropped and `--full`
  * @returns Summary
  */
 export function formatConsoleSummary(messages, options = {}) {
@@ -82,8 +96,9 @@ export function formatConsoleSummary(messages, options = {}) {
     if (options.dropped)
         fmt.text(consoleDroppedNote(options.dropped));
     fmt.blank();
-    renderErrorSection(fmt, grouped.errors, summary.errors.total, options.groupLimit);
-    renderWarningSection(fmt, grouped.warnings, summary.warnings.total, options.groupLimit);
+    const { groupLimit, full } = options;
+    renderErrorSection(fmt, grouped.errors, summary.errors.total, groupLimit, full);
+    renderWarningSection(fmt, grouped.warnings, summary.warnings.total, groupLimit, full);
     if (grouped.errors.length === 0 && grouped.warnings.length === 0) {
         fmt.text('No errors or warnings found');
         fmt.blank();

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

@@ -11,7 +11,7 @@ export type { ConsoleFormatOptions, ConsoleJsonOutput, ConsoleLevel, ConsoleSkip
 export { LEVEL_MAP } from './console/shared.js';
 export { formatConsoleChronological, lastMessages } from './console/chronological.js';
 export { formatConsoleFollowLines } from './console/follow.js';
-export { buildConsoleJsonOutput, formatConsoleJson } from './console/json.js';
+export { buildConsoleJsonOutput } from './console/json.js';
 export { formatConsoleSummary } from './console/summarize.js';
 /**
  * Format console output based on options. Routes to the per-mode formatter:

package/dist/ui/formatters/console.js

@@ -7,12 +7,11 @@
  */
 import { withPageCrashedNote } from '../messages/commands.js';
 import { formatConsoleChronological } from './console/chronological.js';
-import { formatConsoleJson } from './console/json.js';
 import { formatConsoleSummary } from './console/summarize.js';
 export { LEVEL_MAP } from './console/shared.js';
 export { formatConsoleChronological, lastMessages } from './console/chronological.js';
 export { formatConsoleFollowLines } from './console/follow.js';
-export { buildConsoleJsonOutput, formatConsoleJson } from './console/json.js';
+export { buildConsoleJsonOutput } from './console/json.js';
 export { formatConsoleSummary } from './console/summarize.js';
 /**
  * Format console output based on options. Routes to the per-mode formatter:
@@ -21,9 +20,6 @@ export { formatConsoleSummary } from './console/summarize.js';
  * starts with a warning when the page crashed.
  */
 export function formatConsole(messages, options) {
-    if (options.json) {
-        return formatConsoleJson(messages, options);
-    }
     const body = options.list || options.level
         ? formatConsoleChronological(messages, options)
         : formatConsoleSummary(messages, options);

package/dist/ui/formatters/details.js

@@ -1,4 +1,4 @@
-import { skippedBodyReason } from '../../telemetry/network.js';
+import { skippedBodyReason } from '../../telemetry/networkRetention.js';
 import { formatFramePosition, formatTimestamp } from './console/shared.js';
 import { headerValueLines } from './networkHeaders.js';
 import { formatRequestStatus } from './requestStatus.js';

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

@@ -33,10 +33,13 @@ export declare function formatDomQuery(data: DomQueryResult): 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.
+ * Displays the outerHTML of matched elements, each cut to its first
+ * {@link MAX_VALUE_LENGTH} characters with a pointer naming `--full`. 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
+ * @param options - `full` to print the HTML whole
  * @returns Formatted output string
  *
  * @example
@@ -59,7 +62,9 @@ export declare function formatDomQuery(data: DomQueryResult): string;
  * // [1] <span class="error">Error 2</span>
  * ```
  */
-export declare function formatDomGet(data: DomGetResult): string;
+export declare function formatDomGet(data: DomGetResult, options?: {
+    full?: boolean | undefined;
+}): string;
 /**
  * Format DOM eval results for human-readable output.
  *
@@ -69,9 +74,11 @@ export declare function formatDomGet(data: DomGetResult): string;
  * JSON-quoted. Other values are formatted JSON, and values Chrome only
  * describes (functions, DOM nodes) their description. The iframe it ran in
  * (`--frame`) is reported on stderr, so stdout stays the bare value. `--json`
- * output is unchanged (the value in `data.result`).
+ * output is unchanged (the value in `data.result`). The text is cut to its
+ * first {@link MAX_VALUE_LENGTH} characters with a pointer naming `--full`.
  *
  * @param data - DOM eval result containing the evaluated value
+ * @param options - `full` to print the value whole
  * @returns The string, or formatted JSON
  *
  * @example
@@ -90,6 +97,8 @@ export declare function formatDomGet(data: DomGetResult): string;
 export declare function formatDomEval(data: {
     result: unknown;
     type?: string;
+}, options?: {
+    full?: boolean | undefined;
 }): string;
 /**
  * Format the page's iframes, one per line, nested frames indented below

package/dist/ui/formatters/dom.js

@@ -1,4 +1,6 @@
+import { MAX_VALUE_LENGTH } from '../../constants.js';
 import { keyAttributeItems } from './keyAttributes.js';
+import { capForDisplay } from './longValues.js';
 import { OutputFormatter } from '../formatting.js';
 import { frameLabel, framesStillLoadingNote, noFramesMessage, queryMoreMatchesNote, queryViewportCheckedNote, queryNextSteps, screenshotGrownNote, screenshotScaledNote, viewportPositionHint, } from '../messages/commands.js';
 /**
@@ -75,10 +77,13 @@ function queryTagAttributes(node) {
 /**
  * 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.
+ * Displays the outerHTML of matched elements, each cut to its first
+ * {@link MAX_VALUE_LENGTH} characters with a pointer naming `--full`. 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
+ * @param options - `full` to print the HTML whole
  * @returns Formatted output string
  *
  * @example
@@ -101,15 +106,16 @@ function queryTagAttributes(node) {
  * // [1] <span class="error">Error 2</span>
  * ```
  */
-export function formatDomGet(data) {
+export function formatDomGet(data, options = {}) {
     const { nodes } = data;
+    const html = (node) => capForDisplay(node.outerHTML ?? '', MAX_VALUE_LENGTH, options.full);
     if (nodes.length === 1) {
         // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-        return nodes[0].outerHTML ?? '';
+        return html(nodes[0]);
     }
     const fmt = new OutputFormatter();
     nodes.forEach((node, i) => {
-        fmt.text(`[${i}] ${node.outerHTML}`);
+        fmt.text(`[${i}] ${html(node)}`);
     });
     return fmt.build();
 }
@@ -122,9 +128,11 @@ export function formatDomGet(data) {
  * JSON-quoted. Other values are formatted JSON, and values Chrome only
  * describes (functions, DOM nodes) their description. The iframe it ran in
  * (`--frame`) is reported on stderr, so stdout stays the bare value. `--json`
- * output is unchanged (the value in `data.result`).
+ * output is unchanged (the value in `data.result`). The text is cut to its
+ * first {@link MAX_VALUE_LENGTH} characters with a pointer naming `--full`.
  *
  * @param data - DOM eval result containing the evaluated value
+ * @param options - `full` to print the value whole
  * @returns The string, or formatted JSON
  *
  * @example
@@ -140,7 +148,17 @@ export function formatDomGet(data) {
  * // }
  * ```
  */
-export function formatDomEval(data) {
+export function formatDomEval(data, options = {}) {
+    return capForDisplay(evalResultText(data), MAX_VALUE_LENGTH, options.full);
+}
+/**
+ * An eval result as text: a string as is unless it would read as another
+ * value, else formatted JSON.
+ *
+ * @param data - DOM eval result
+ * @returns Text of the value
+ */
+function evalResultText(data) {
     if (data.type === 'undefined')
         return 'undefined';
     const { result } = data;

package/dist/ui/formatters/layout.js

@@ -1,6 +1,7 @@
 /**
  * Human-readable output of `bdg dom layout`.
  */
+import { LAYOUT_ELEMENT_LIMIT } from '../../constants.js';
 import { indexSourceText } from '../../errors/messages.js';
 import { OutputFormatter } from '../formatting.js';
 import { coverText, indexLayoutHeadline, layoutHeadline, layoutPositionLabel, maskedText, moreMatchesNote, pageLayoutLine, } from '../messages/commands.js';
@@ -48,7 +49,7 @@ export function formatLayout(data) {
         ? indexLayoutHeadline(indexSourceText(data.indexSource))
         : layoutHeadline(data.count, data.elements.length + (data.omitted ?? 0), data.selector))
         .list(shown.map((element) => layoutLine(element, data.page.viewport)))
-        .list(more > 0 ? [moreMatchesNote(more, data.omitted ? data.elements.length : undefined)] : [])
+        .list(more > 0 ? [moreMatchesNote(more, LAYOUT_ELEMENT_LIMIT)] : [])
         .build();
 }
 //# sourceMappingURL=layout.js.map