browser-debugger-cli 0.12.0 → 0.13.0

package/dist/ui/formatters/dom.js

@@ -1,15 +1,13 @@
 import { keyAttributeItems } from './keyAttributes.js';
 import { OutputFormatter } from '../formatting.js';
-import { frameLabel, moreMatchesNote, framesStillLoadingNote, noFramesMessage, queryNextSteps, screenshotGrownNote, screenshotScaledNote, viewportPositionHint, } from '../messages/commands.js';
-/** Matches listed in human output (JSON has all of them) */
-const QUERY_DISPLAY_LIMIT = 50;
+import { frameLabel, framesStillLoadingNote, noFramesMessage, queryMoreMatchesNote, queryViewportCheckedNote, queryNextSteps, screenshotGrownNote, screenshotScaledNote, viewportPositionHint, } from '../messages/commands.js';
 /**
  * Format DOM query results for human-readable output.
  *
  * Displays found nodes with their index, tag, identifying attributes
  * ({@link queryTagAttributes}), classes, and preview text
  * (plus where they are when outside the viewport or hidden, e.g.
- * `(below fold)`), up to {@link QUERY_DISPLAY_LIMIT} of them (no match is an error, exit 83).
+ * `(below fold)`), as many as `--limit` listed, with a note for the rest (no match is an error, exit 83).
  * One line of next commands follows; they take the match's index, so they
  * work for matches in shadow roots and iframes too.
  *
@@ -35,7 +33,7 @@ const QUERY_DISPLAY_LIMIT = 50;
 export function formatDomQuery(data) {
     const { count, nodes, selector } = data;
     const fmt = new OutputFormatter();
-    const nodeLines = nodes.slice(0, QUERY_DISPLAY_LIMIT).map((node) => {
+    const nodeLines = nodes.map((node) => {
         const attributes = queryTagAttributes(node)
             .map((item) => ` ${item}`)
             .join('');
@@ -49,7 +47,8 @@ export function formatDomQuery(data) {
     return fmt
         .text(`Found ${count} node${count === 1 ? '' : 's'} matching "${selector}":`)
         .list(nodeLines)
-        .list(count > QUERY_DISPLAY_LIMIT ? [moreMatchesNote(count - QUERY_DISPLAY_LIMIT)] : [])
+        .list(data.omitted ? [queryMoreMatchesNote(data.omitted, data.indexed)] : [])
+        .list(data.viewportChecked ? [queryViewportCheckedNote(data.viewportChecked)] : [])
         .tip(queryNextSteps(exampleIndex))
         .build();
 }

package/dist/ui/formatters/helpFormatters.js

@@ -17,7 +17,7 @@ import { section } from '../formatting.js';
 export function buildAgentDiscoveryHelp() {
     const counts = getProtocolCounts();
     return section('For AI Agents:', [
-        'bdg --help --json          Machine-readable command schema',
+        'bdg --help --json          Commands, flags, exit codes (bdg <cmd> --help --json: details)',
         `bdg cdp --list             List all ${counts.domains} CDP domains`,
         `bdg cdp --search <term>    Search ${counts.methods} CDP methods`,
     ]);

package/dist/ui/formatters/inspect.js

@@ -212,6 +212,9 @@ function fontParts(text) {
 }
 /**
  * A contrast as words, e.g. `contrast 4.47 fail on #fff (faded: opacity 0.4)`.
+ * An approximate one gets no pass/fail level, only the estimate and why
+ * (`contrast ≈1 on #fff (approximate: img.hero behind)`): what is behind
+ * the text is not a known color.
  *
  * @param contrast - Contrast
  * @returns Words, or undefined
@@ -221,10 +224,9 @@ function contrastText(contrast) {
         return undefined;
     return [
         contrast.approximate
-            ? `contrast ≈${contrast.ratio} ${contrast.level}`
+            ? `contrast ≈${contrast.ratio}`
             : `contrast ${contrast.ratio} ${contrast.level}`,
         `on ${contrast.background}`,
-        contrast.overImage && '(over image)',
         contrast.opacity !== undefined && `(faded: opacity ${contrast.opacity})`,
         contrast.approximate && `(approximate: ${contrast.approximate.join(', ')})`,
     ]
@@ -274,7 +276,7 @@ function fillText(fill) {
         .join(' ');
 }
 /**
- * The fill line: backgrounds, opacity and blend mode.
+ * The fill line: backgrounds (and that they are clipped to gradient text), opacity and blend mode.
  *
  * @param data - Inspect result
  * @returns Line
@@ -286,6 +288,10 @@ function fillLine(data) {
         paint &&
             `stroke ${paint.stroke}${paint.strokeWidth !== undefined ? ` ${paint.strokeWidth}` : ''}`,
         ...(data.fills ?? []).map(fillText),
+        data.text?.gradientFill &&
+            !data.text.holder &&
+            (data.fills ?? []).length > 0 &&
+            'clipped to the text',
         data.opacity !== undefined && `opacity ${data.opacity}`,
         data.blend && `blend ${data.blend}`,
     ]);

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

@@ -1,6 +1,14 @@
 import type { InstalledSkill } from '../../types.js';
 /**
- * Format where the skill was installed, one line per agent.
+ * Format the targets the skill was written for, as a failed install lists
+ * the ones that succeeded.
+ *
+ * @param skills - Install results
+ * @returns Human-readable lines
+ */
+export declare function formatSkillTargets(skills: InstalledSkill[]): string;
+/**
+ * Format where the skill was installed, plus what to do next.
  *
  * @param data - Install results
  * @returns Human-readable summary

package/dist/ui/formatters/installSkill.js

@@ -1,5 +1,8 @@
 import { homedir } from 'os';
 import { OutputFormatter } from '../formatting.js';
+import { skillBackupMessage } from '../messages/commands.js';
+/** Indent of the path column, so a backup line sits under the path it belongs to */
+const PATH_INDENT = ' '.repeat(2 + 6 + 2 + 9 + 2);
 /**
  * Shorten a path under the home directory to `~/...`.
  *
@@ -11,17 +14,40 @@ function tildePath(path) {
     return path.startsWith(`${home}/`) ? `~${path.slice(home.length)}` : path;
 }
 /**
- * Format where the skill was installed, one line per agent.
+ * Add where the skill was installed, one line per agent, plus where a
+ * replaced copy was kept.
+ *
+ * @param fmt - Formatter to add the lines to
+ * @param skills - Install results
+ * @returns The formatter
+ */
+function addSkillTargets(fmt, skills) {
+    fmt.text('bdg skill:');
+    for (const skill of skills) {
+        fmt.text(`  ${skill.target.padEnd(6)}  ${skill.status.padEnd(9)}  ${tildePath(skill.path)}`);
+        if (skill.backup)
+            fmt.text(`${PATH_INDENT}${skillBackupMessage(tildePath(skill.backup))}`);
+    }
+    return fmt;
+}
+/**
+ * Format the targets the skill was written for, as a failed install lists
+ * the ones that succeeded.
+ *
+ * @param skills - Install results
+ * @returns Human-readable lines
+ */
+export function formatSkillTargets(skills) {
+    return addSkillTargets(new OutputFormatter(), skills).build();
+}
+/**
+ * Format where the skill was installed, plus what to do next.
  *
  * @param data - Install results
  * @returns Human-readable summary
  */
 export function formatInstalledSkills(data) {
-    const fmt = new OutputFormatter().text('bdg skill:');
-    for (const skill of data.skills) {
-        fmt.text(`  ${skill.target.padEnd(6)}  ${skill.status.padEnd(9)}  ${tildePath(skill.path)}`);
-    }
-    return fmt
+    return addSkillTargets(new OutputFormatter(), data.skills)
         .hints('Next:', [
         'Start a new agent session to load it (running sessions keep the old list)',
         'After upgrading bdg, run bdg install-skill again',

package/dist/ui/formatters/layout.js

@@ -3,7 +3,7 @@
  */
 import { indexSourceText } from '../../errors/messages.js';
 import { OutputFormatter } from '../formatting.js';
-import { coverText, indexLayoutHeadline, layoutHeadline, layoutPositionLabel, moreMatchesNote, pageLayoutLine, } from '../messages/commands.js';
+import { coverText, indexLayoutHeadline, layoutHeadline, layoutPositionLabel, maskedText, moreMatchesNote, pageLayoutLine, } from '../messages/commands.js';
 /** Elements listed in human output (JSON has up to 100) */
 const LAYOUT_DISPLAY_LIMIT = 20;
 /**
@@ -26,6 +26,7 @@ export function layoutLine(element, viewport) {
         element.coveredBy && coverText(element.coveredBy, element.coverTransparent),
         element.inert && 'inert',
         element.invisible,
+        element.masked && maskedText(element.masked),
         element.context && element.context !== element.clippedBy && `in ${element.context}`,
     ]
         .filter(Boolean)

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

@@ -41,7 +41,7 @@ export declare function pageStartOf(requests: NetworkRequest[]): PageStart | und
 export declare function formatStartOffset(request: NetworkRequest, pageStart: PageStart | undefined): string;
 /**
  * Rows of the network stream: requests that finished since the last poll,
- * with the column header the first time.
+ * with the column header the first time (the stream banner is on stderr).
  *
  * @param requests - Newly finished requests
  * @param options - `header` the first time; `verbose` for full URLs; the page start for START

package/dist/ui/formatters/networkList.js

@@ -170,7 +170,7 @@ function formatNetworkListHuman(requests, options) {
 const FOLLOW_ID_WIDTH = 14;
 /**
  * Rows of the network stream: requests that finished since the last poll,
- * with the column header the first time.
+ * with the column header the first time (the stream banner is on stderr).
  *
  * @param requests - Newly finished requests
  * @param options - `header` the first time; `verbose` for full URLs; the page start for START
@@ -180,7 +180,6 @@ export function formatNetworkFollowRows(requests, options = {}) {
     const fmt = new OutputFormatter();
     const widths = columnWidths(requests, FOLLOW_ID_WIDTH);
     if (options.header) {
-        fmt.text('Streaming network requests... (Ctrl+C to stop)');
         fmt.text(formatColumnHeader(widths));
         fmt.separator('─', SEPARATOR_WIDTH);
     }

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

@@ -53,6 +53,8 @@ export interface PreviewJsonData {
     target: BdgOutput['target'];
     partial?: boolean;
     totals?: BdgOutput['totals'];
+    /** When the page's renderer crashed (epoch ms), while it is not loaded again */
+    pageCrashedAt?: number;
     network?: BdgOutput['data']['network'];
     console?: BdgOutput['data']['console'];
 }

package/dist/ui/formatters/preview.js

@@ -3,7 +3,9 @@ import { buildSuccessResponse } from '../OutputBuilder.js';
 import { formatTimestamp } from './console/shared.js';
 import { failureReason, formatRequestStatus, getRequestState, } from './requestStatus.js';
 import { OutputFormatter, truncateUrl, truncateText } from '../formatting.js';
+import { withPageCrashedNote } from '../messages/commands.js';
 import { PREVIEW_EMPTY_STATES, PREVIEW_HEADERS, compactTipsMessage, verboseCommandsMessage, } from '../messages/preview.js';
+import { consoleDroppedNote } from '../messages/consoleMessages.js';
 import { sessionCommand } from '../messages/sessionCommand.js';
 /**
  * Infer resource type from MIME type when CDP doesn't provide it.
@@ -69,6 +71,7 @@ export function buildPreviewJsonData(output, options) {
         target: output.target,
         ...(output.partial !== undefined && { partial: output.partial }),
         ...(output.totals && { totals: output.totals }),
+        ...(output.pageCrashedAt !== undefined && { pageCrashedAt: output.pageCrashedAt }),
         ...(pick('network') && output.data.network && { network: last(output.data.network) }),
         ...(pick('console') && output.data.console && { console: last(output.data.console) }),
     };
@@ -78,19 +81,22 @@ export function buildPreviewJsonData(output, options) {
  *
  * @param output - Preview output
  * @param options - Preview options
- * @returns Pretty-printed `{ version, success, data }` envelope
+ * @returns `{ version, success, data }` envelope, pretty-printed, or on one
+ *   line in follow mode (one object per line, NDJSON)
  */
 function formatPreviewAsJson(output, options) {
-    return JSON.stringify(buildSuccessResponse(buildPreviewJsonData(output, options)), null, 2);
+    const envelope = buildSuccessResponse(buildPreviewJsonData(output, options));
+    return options.follow ? JSON.stringify(envelope) : JSON.stringify(envelope, null, 2);
 }
 /**
- * Format preview as human-readable output
+ * Format preview as human-readable output, after a warning when the page
+ * crashed (what is shown was collected before).
  */
 function formatPreviewHumanReadable(output, options) {
-    if (options.verbose) {
-        return formatPreviewVerbose(output, options);
-    }
-    return formatPreviewCompact(output, options);
+    const body = options.verbose
+        ? formatPreviewVerbose(output, options)
+        : formatPreviewCompact(output, options);
+    return withPageCrashedNote(body, output.pageCrashedAt);
 }
 /**
  * Format preview in compact format (default)
@@ -145,6 +151,8 @@ function formatPreviewCompact(output, options) {
             const totalCount = output.totals?.console ?? output.data.console.length;
             const limitHint = formatLimitHint(showingCount, totalCount);
             fmt.text(`CONSOLE (${showingCount}/${totalCount})${limitHint}:`);
+            if (output.totals?.consoleDropped)
+                fmt.text(`  ${consoleDroppedNote(output.totals.consoleDropped)}`);
             if (messages.length === 0) {
                 fmt.text(`  ${PREVIEW_EMPTY_STATES.NO_DATA}`);
             }
@@ -232,6 +240,8 @@ function formatPreviewVerbose(output, options) {
                 ? `Console Messages (all ${messages.length})`
                 : `Console Messages (last ${messages.length} of ${output.totals?.console ?? output.data.console.length})`;
             fmt.text(title).separator('━', 50);
+            if (output.totals?.consoleDropped)
+                fmt.text(consoleDroppedNote(output.totals.consoleDropped));
             if (messages.length === 0) {
                 fmt.text(PREVIEW_EMPTY_STATES.NO_CONSOLE_MESSAGES);
             }

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

@@ -1,7 +1,7 @@
 import type { RunningSessionInfo } from '../../session/sessionList.js';
 /**
- * Format the sessions as a table, followed by the cleanup commands of
- * crashed and stale sessions.
+ * Format the sessions as a table, followed by why ended sessions ended and
+ * the cleanup commands of crashed and stale sessions.
  *
  * @param data - Sessions
  * @returns Human-readable list

package/dist/ui/formatters/sessions.js

@@ -1,9 +1,10 @@
 import { OutputFormatter } from '../formatting.js';
+import { endedSessionText } from '../messages/session.js';
 /** Label of the default session in the list */
 const DEFAULT_SESSION_LABEL = '(default)';
 /**
- * Format the sessions as a table, followed by the cleanup commands of
- * crashed and stale sessions.
+ * Format the sessions as a table, followed by why ended sessions ended and
+ * the cleanup commands of crashed and stale sessions.
  *
  * @param data - Sessions
  * @returns Human-readable list
@@ -31,6 +32,12 @@ export function formatSessionList(data) {
             .join('  ')
             .trimEnd());
     }
+    const ended = data.sessions.flatMap(({ name, endReason, endedAt }) => endReason && endedAt !== undefined
+        ? [endedSessionText(name ?? DEFAULT_SESSION_LABEL, { reason: endReason, endedAt })]
+        : []);
+    if (ended.length > 0) {
+        fmt.blank().section('Ended without bdg stop:', ended);
+    }
     const cleanups = data.sessions.flatMap((session) => (session.cleanup ? [session.cleanup] : []));
     if (cleanups.length > 0) {
         fmt.hints('Crashed or stale sessions; clean up with:', cleanups);

package/dist/ui/logging/logger.d.ts

@@ -29,7 +29,7 @@ export type LogLevel = 'info' | 'debug';
  * Log contexts for different components.
  * Used to prefix log messages with component name.
  */
-export type LogContext = 'bdg' | 'launcher' | 'daemon' | 'client' | 'cleanup' | 'session' | 'chrome' | 'cdp' | 'ipc' | 'http' | 'dialogs' | 'navigation' | 'console' | 'dom' | 'network' | 'diagnostics' | 'readiness' | 'atomic-file' | 'object-expander' | 'fetcher' | 'targets';
+export type LogContext = 'bdg' | 'launcher' | 'daemon' | 'client' | 'cleanup' | 'session' | 'chrome' | 'cdp' | 'ipc' | 'http' | 'dialogs' | 'navigation' | 'page-crash' | 'console' | 'dom' | 'network' | 'diagnostics' | 'readiness' | 'atomic-file' | 'object-expander' | 'fetcher' | 'targets';
 /**
  * Logger instance with support for different log levels.
  */

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

@@ -24,6 +24,13 @@ export declare function chromeClosedMessage(pid?: number): string;
  * @returns Formatted success message
  */
 export declare function orphanedDaemonsCleanedMessage(count: number): string;
+/**
+ * Where `bdg install-skill` kept the copy it replaced.
+ *
+ * @param path - Backup path, as the user would type it
+ * @returns One line
+ */
+export declare function skillBackupMessage(path: string): string;
 /**
  * Warning shown when a click falls back from mouse events to `el.click()`.
  *
@@ -135,6 +142,22 @@ export declare const CLICK_NOT_RECEIVED_WARNING = "The click may not have reache
  *   "... and 8980 more (--json lists the first 100)"
  */
 export declare function moreMatchesNote(hidden: number, jsonLimit?: number): string;
+/**
+ * Note under `dom query` matches cut by `--limit`.
+ *
+ * @param omitted - Matches not listed
+ * @param indexed - Matches usable by index, when not all of them
+ * @returns e.g. `... and 49953 more (--limit 0 lists all; indices 0-999 work with other commands)`
+ */
+export declare function queryMoreMatchesNote(omitted: number, indexed?: number): string;
+/**
+ * Note under `dom query` matches listed past those whose viewport position
+ * was checked.
+ *
+ * @param checked - First matches checked
+ * @returns e.g. `Visibility is checked for the first 100 matches only; bdg dom layout <index> checks any of them`
+ */
+export declare function queryViewportCheckedNote(checked: number): string;
 /**
  * Note under a list of a11y query matches cut by `--limit`.
  *
@@ -185,6 +208,31 @@ export declare const LAYOUT_REASONS: {
     /** Joins an invisible reason to the ancestor causing it */
     readonly on: " on ";
 };
+/** Why an out-of-view text's contrast in `dom audit` is approximate: none of its ancestors paints a background */
+export declare const AUDIT_OUT_OF_VIEW_RISK = "only its ancestors were checked";
+/**
+ * `dom audit contrast` note for text that looks below the level but cannot
+ * be measured exactly (over an image, blended, under or over another layer).
+ *
+ * @param count - How many such texts
+ * @returns e.g. `(+12 more may be below it but cannot be measured: text over images or blended layers; check them with bdg dom inspect)`
+ */
+export declare function auditUncertainContrastNote(count: number): string;
+/**
+ * `dom audit animations` note for canvas elements, whose script-drawn
+ * animations it cannot see.
+ *
+ * @param count - Visible canvas elements
+ * @returns e.g. `(+ 2 canvas elements: animations drawn by scripts on them are not listed)`
+ */
+export declare function auditCanvasNote(count: number): string;
+/**
+ * A mask over an element, for `dom layout` and `dom inspect`.
+ *
+ * @param masked - The mask, e.g. `mask-image on div.hero`
+ * @returns e.g. `masked by mask-image on div.hero`
+ */
+export declare function maskedText(masked: string): string;
 /**
  * Off-screen reason for an element out of view on a page whose scrolling is
  * locked, naming the visible dialog that likely locked it when there is one.
@@ -228,16 +276,53 @@ export declare function layoutPositionLabel(element: LabelledLayout, viewport?:
  * @returns e.g. `prefers-color-scheme: dark (from the system setting)`
  */
 export declare function colorSchemeLabel(scheme: string, emulated: boolean): string;
+/**
+ * Suggestion for an action that failed on a page that replaced built-ins
+ * bdg's page scripts use.
+ *
+ * @param replaced - Their dotted names (all are named)
+ * @returns Suggestion naming them and a way around
+ */
+export declare function brokenByReplacedBuiltinsSuggestion(replaced: readonly string[]): string;
+/**
+ * Warning on an action when the page replaced built-ins bdg's page scripts
+ * use (polyfills, old frameworks, anti-bot scripts). Names the first four;
+ * the action's `replacedBuiltins` (JSON) lists them all.
+ *
+ * @param replaced - Their dotted names
+ * @returns e.g. `the page replaced built-ins bdg's scripts use (Element.prototype.querySelectorAll); bdg found the element in its own world, but the action runs in the page's and may misbehave`
+ */
+export declare function replacedBuiltinsWarning(replaced: readonly string[]): string;
 /**
  * First line of `bdg status` for a running session.
  *
- * @param page - URL and title of the page, when the session reported them
- * @returns e.g. `Session active: https://example.com/ — Example Domain`
+ * @param page - URL and title of the page, when the session reported them,
+ *   and when it crashed
+ * @returns e.g. `Session active: https://example.com/ — Example Domain`, with
+ *   a crash warning on a second line
  */
 export declare function sessionActiveLine(page?: {
     url: string;
     title: string;
+    crashedAt?: number | undefined;
 }): string;
+/**
+ * Warning that the session's page crashed, for `bdg status`, `bdg peek`,
+ * `bdg console` and `bdg network list`.
+ *
+ * @param crashedAt - When it crashed (epoch ms)
+ * @returns e.g. `⚠ The page crashed at 18:42:10 (renderer gone); bdg page reload brings it back`
+ */
+export declare function pageCrashedNote(crashedAt: number): string;
+/**
+ * Put the page-crashed warning before a view of collected data, when the
+ * page crashed (what is shown was collected before).
+ *
+ * @param body - The view
+ * @param crashedAt - When the page crashed (epoch ms), if it did
+ * @returns The view, after the warning when the page crashed
+ */
+export declare function withPageCrashedNote(body: string, crashedAt: number | undefined): string;
 /**
  * Page dimensions line of `bdg dom layout`.
  *
@@ -405,6 +490,16 @@ export declare function dialogConsoleText(dialog: {
     type: string;
     message: string;
 }): string;
+/**
+ * How far a pointer action scrolled the page to reach its element.
+ *
+ * @param scrolledBy - Page scroll (CSS px)
+ * @returns e.g. `page down 1240px to reach it`, `page right 300px, up 80px to reach it`
+ */
+export declare function pointerScrollText(scrolledBy: {
+    x: number;
+    y: number;
+}): string;
 /** Headline of each pointer action, e.g. "Element Double-clicked" */
 export declare const POINTER_ACTION_DONE: {
     readonly click: "Clicked";
@@ -556,9 +651,11 @@ export declare function elementTextLine(text: string): string;
  *
  * @param children - First child elements, e.g. `iframe#app`
  * @param count - Number of child elements
- * @returns e.g. `No text; holds 1 element: iframe (see its HTML with --raw)`
+ * @param inShadowRoot - The children are those of its shadow root (`--raw` does not show them)
+ * @returns e.g. `No text; holds 1 element: iframe (see its HTML with --raw)`,
+ *   `No text; its shadow root holds 1 element: button "Close" (see it with bdg dom inspect)`
  */
-export declare function emptyElementLine(children: string[], count: number): string;
+export declare function emptyElementLine(children: string[], count: number, inShadowRoot?: boolean): string;
 /**
  * Note on a screenshot scaled down to keep its image token cost bounded.
  *
@@ -600,6 +697,23 @@ export declare function queryNextSteps(index: number): string;
  * @returns e.g. `Frame: https://pay.example/`
  */
 export declare function evalFrameLine(url: string): string;
+/**
+ * Warning on a `dom eval` result the browser copied because the page
+ * replaced built-ins bdg's own copy uses.
+ *
+ * @param replaced - Their dotted names (all are named)
+ * @returns e.g. `the page replaced Object.keys, so the browser copied the result: undefined, NaN, functions, DOM nodes, dates, maps and sets inside it show as null or {}`
+ */
+export declare function evalCopiedByBrowserWarning(replaced: readonly string[]): string;
+/**
+ * Warning on a `dom eval` result shown as its preview: the page replaced
+ * built-ins bdg's copy uses and the browser could not copy it either (a
+ * cycle or a BigInt inside).
+ *
+ * @param replaced - Their dotted names (all are named)
+ * @returns Warning that the value is a shortened preview
+ */
+export declare function evalPreviewWarning(replaced: readonly string[]): string;
 /**
  * Generate warning message.
  *
@@ -715,5 +829,11 @@ export declare function inspectMidTransitionNote(): string;
 export declare const AUDIT_HELP_EXAMPLES = "\nExamples:\n  bdg dom audit                       All checks\n  bdg dom audit contrast --level AAA  Text below WCAG AAA, weakest first\n  bdg dom audit overflow              What scrolls sideways, cut-off text, scaled images\n  bdg dom audit layers animations     Fixed/sticky elements and running animations\n\nFollow up on a finding with bdg dom inspect <element> (e.g. --why color).";
 /** Examples under `bdg css search --help` */
 export declare const CSS_SEARCH_HELP_EXAMPLES = "\nExamples:\n  bdg css search -- --brand       Where a custom property is set and used (-- before a text\n                                  that starts with -; options go before it:\n                                  bdg css search --limit 50 -- --brand)\n  bdg css search \"oklch(\"         Rules that use oklch colors\n  bdg css search \".btn-primary\"   Rules of a class, in every stylesheet";
+/**
+ * `details` field of `bdg --help --json`: where the full help is.
+ *
+ * @returns Note
+ */
+export declare function helpJsonDetailsNote(): string;
 export {};
 //# sourceMappingURL=commands.d.ts.map