browser-debugger-cli 0.7.2 → 0.9.0

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

@@ -1 +0,0 @@
-{"version":3,"file":"consoleMessages.d.ts","sourceRoot":"","sources":["../../../src/ui/messages/consoleMessages.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,IAAI,MAAM,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C"}

package/dist/ui/messages/consoleMessages.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"consoleMessages.js","sourceRoot":"","sources":["../../../src/ui/messages/consoleMessages.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO,gDAAgD,CAAC;AAC1D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,8BAA8B;IAC5C,OAAO,oCAAoC,CAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,kFAAkF,CAAC;AAC5F,CAAC"}

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

@@ -1,168 +0,0 @@
-/**
- * Debug and diagnostic messages for daemon and worker processes.
- *
- * User-facing debug output for internal operations. Context prefixes
- * (e.g., [daemon], [worker]) are added by the logger, not here.
- *
- * WHY: Avoids duplicate prefixes when used with createLogger().
- */
-/**
- * Generate worker spawn message with configuration.
- *
- * @param workerPath - Path to worker script
- * @param config - Worker configuration object
- * @returns Formatted debug message
- */
-export declare function daemonSpawningWorker(workerPath: string, config: unknown): string;
-/**
- * Generate worker spawned success message.
- *
- * @param pid - Worker process ID
- * @returns Formatted debug message
- */
-export declare function daemonWorkerSpawned(pid: number): string;
-/**
- * Generate worker ready signal received message.
- *
- * @param workerPid - Worker process ID
- * @param chromePid - Chrome process ID
- * @returns Formatted debug message
- */
-export declare function daemonWorkerReady(workerPid: number, chromePid: number): string;
-/**
- * Generate failed to parse stdout message.
- *
- * @param line - The line that failed to parse
- * @returns Formatted debug message
- */
-export declare function daemonParseError(line: string): string;
-/**
- * Generate telemetry module activation message.
- *
- * @param collectorName - Name of telemetry module being activated
- * @returns Formatted debug message
- */
-export declare function workerActivatingCollector(collectorName: string): string;
-/**
- * Generate all telemetry modules activated message.
- *
- * @param telemetry - Array of activated telemetry module names
- * @returns Formatted debug message
- */
-export declare function workerCollectorsActivated(telemetry: string[]): string;
-/**
- * Generate unknown command received message.
- *
- * @param commandName - The unknown command name
- * @returns Formatted debug message
- */
-export declare function workerUnknownCommand(commandName: string): string;
-/**
- * Generate handling command message.
- *
- * @param commandName - Command being handled
- * @returns Formatted debug message
- */
-export declare function workerHandlingCommand(commandName: string): string;
-/**
- * Generate command response sent message.
- *
- * @param commandName - Command that was handled
- * @param success - Whether the command succeeded
- * @param error - Optional error message if failed
- * @returns Formatted debug message
- */
-export declare function workerCommandResponse(commandName: string, success: boolean, error?: string): string;
-/**
- * Generate IPC message parse failure message.
- *
- * @param error - Error message from parse failure
- * @returns Formatted debug message
- */
-export declare function workerIPCParseError(error: string): string;
-/**
- * Generate stdin closed message.
- *
- * @returns Formatted debug message
- */
-export declare function workerStdinClosed(): string;
-/**
- * Generate stdin listener setup message.
- *
- * @returns Formatted debug message
- */
-export declare function workerStdinListenerSetup(): string;
-/**
- * Generate collecting final DOM snapshot message.
- *
- * @returns Formatted debug message
- */
-export declare function workerCollectingDOM(): string;
-/**
- * Generate DOM snapshot collected message.
- *
- * @returns Formatted debug message
- */
-export declare function workerDOMCollected(): string;
-/**
- * Generate failed to collect DOM message.
- *
- * @param error - Error message from collection failure
- * @returns Formatted debug message
- */
-export declare function workerDOMCollectionFailed(error: string): string;
-/**
- * Generate writing final output message.
- *
- * @returns Formatted debug message
- */
-export declare function workerWritingOutput(): string;
-/**
- * Generate running cleanup functions message.
- *
- * @returns Formatted debug message
- */
-export declare function workerRunningCleanup(): string;
-/**
- * Generate closing CDP connection message.
- *
- * @returns Formatted debug message
- */
-export declare function workerClosingCDP(): string;
-/**
- * Generate graceful shutdown complete message.
- *
- * @returns Formatted debug message
- */
-export declare function workerShutdownComplete(): string;
-/**
- * Generate exiting due to Chrome connection loss message.
- *
- * @returns Formatted debug message
- */
-export declare function workerExitingConnectionLoss(): string;
-/**
- * Generate received SIGTERM message.
- *
- * @returns Formatted debug message
- */
-export declare function workerReceivedSIGTERM(): string;
-/**
- * Generate received SIGINT message.
- *
- * @returns Formatted debug message
- */
-export declare function workerReceivedSIGINT(): string;
-/**
- * Generate timeout reached message.
- *
- * @returns Formatted debug message
- */
-export declare function workerTimeoutReached(): string;
-/**
- * Generate session active waiting message.
- *
- * @returns Formatted debug message
- */
-export declare function workerSessionActive(): string;
-//# sourceMappingURL=debug.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../../src/ui/messages/debug.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAEhF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAErE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,OAAO,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CAKR;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C"}

package/dist/ui/messages/debug.js

@@ -1,219 +0,0 @@
-/**
- * Debug and diagnostic messages for daemon and worker processes.
- *
- * User-facing debug output for internal operations. Context prefixes
- * (e.g., [daemon], [worker]) are added by the logger, not here.
- *
- * WHY: Avoids duplicate prefixes when used with createLogger().
- */
-/**
- * Generate worker spawn message with configuration.
- *
- * @param workerPath - Path to worker script
- * @param config - Worker configuration object
- * @returns Formatted debug message
- */
-export function daemonSpawningWorker(workerPath, config) {
-    return `Spawning worker: node ${workerPath} <config>\nWorker config: ${JSON.stringify(config)}`;
-}
-/**
- * Generate worker spawned success message.
- *
- * @param pid - Worker process ID
- * @returns Formatted debug message
- */
-export function daemonWorkerSpawned(pid) {
-    return `Worker spawned (PID ${pid})`;
-}
-/**
- * Generate worker ready signal received message.
- *
- * @param workerPid - Worker process ID
- * @param chromePid - Chrome process ID
- * @returns Formatted debug message
- */
-export function daemonWorkerReady(workerPid, chromePid) {
-    return `Worker ready signal received\nWorker PID: ${workerPid}\nChrome PID: ${chromePid}`;
-}
-/**
- * Generate failed to parse stdout message.
- *
- * @param line - The line that failed to parse
- * @returns Formatted debug message
- */
-export function daemonParseError(line) {
-    return `Failed to parse stdout line: ${line}`;
-}
-/**
- * Generate telemetry module activation message.
- *
- * @param collectorName - Name of telemetry module being activated
- * @returns Formatted debug message
- */
-export function workerActivatingCollector(collectorName) {
-    return `Activating ${collectorName} telemetry`;
-}
-/**
- * Generate all telemetry modules activated message.
- *
- * @param telemetry - Array of activated telemetry module names
- * @returns Formatted debug message
- */
-export function workerCollectorsActivated(telemetry) {
-    return `All telemetry modules activated: ${telemetry.join(', ')}`;
-}
-/**
- * Generate unknown command received message.
- *
- * @param commandName - The unknown command name
- * @returns Formatted debug message
- */
-export function workerUnknownCommand(commandName) {
-    return `Unknown command: ${commandName}`;
-}
-/**
- * Generate handling command message.
- *
- * @param commandName - Command being handled
- * @returns Formatted debug message
- */
-export function workerHandlingCommand(commandName) {
-    return `Handling ${commandName}_request`;
-}
-/**
- * Generate command response sent message.
- *
- * @param commandName - Command that was handled
- * @param success - Whether the command succeeded
- * @param error - Optional error message if failed
- * @returns Formatted debug message
- */
-export function workerCommandResponse(commandName, success, error) {
-    if (success) {
-        return `Sent ${commandName}_response (success)`;
-    }
-    return `Sent ${commandName}_response (error: ${error})`;
-}
-/**
- * Generate IPC message parse failure message.
- *
- * @param error - Error message from parse failure
- * @returns Formatted debug message
- */
-export function workerIPCParseError(error) {
-    return `Failed to parse IPC message: ${error}`;
-}
-/**
- * Generate stdin closed message.
- *
- * @returns Formatted debug message
- */
-export function workerStdinClosed() {
-    return 'Stdin closed, daemon disconnected';
-}
-/**
- * Generate stdin listener setup message.
- *
- * @returns Formatted debug message
- */
-export function workerStdinListenerSetup() {
-    return 'Stdin listener set up for IPC commands';
-}
-/**
- * Generate collecting final DOM snapshot message.
- *
- * @returns Formatted debug message
- */
-export function workerCollectingDOM() {
-    return 'Collecting final DOM snapshot...';
-}
-/**
- * Generate DOM snapshot collected message.
- *
- * @returns Formatted debug message
- */
-export function workerDOMCollected() {
-    return 'DOM snapshot collected';
-}
-/**
- * Generate failed to collect DOM message.
- *
- * @param error - Error message from collection failure
- * @returns Formatted debug message
- */
-export function workerDOMCollectionFailed(error) {
-    return `Failed to collect DOM: ${error}`;
-}
-/**
- * Generate writing final output message.
- *
- * @returns Formatted debug message
- */
-export function workerWritingOutput() {
-    return 'Writing final output...';
-}
-/**
- * Generate running cleanup functions message.
- *
- * @returns Formatted debug message
- */
-export function workerRunningCleanup() {
-    return 'Running collector cleanup functions...';
-}
-/**
- * Generate closing CDP connection message.
- *
- * @returns Formatted debug message
- */
-export function workerClosingCDP() {
-    return 'Closing CDP connection...';
-}
-/**
- * Generate graceful shutdown complete message.
- *
- * @returns Formatted debug message
- */
-export function workerShutdownComplete() {
-    return 'Graceful shutdown complete';
-}
-/**
- * Generate exiting due to Chrome connection loss message.
- *
- * @returns Formatted debug message
- */
-export function workerExitingConnectionLoss() {
-    return 'Exiting due to Chrome connection loss';
-}
-/**
- * Generate received SIGTERM message.
- *
- * @returns Formatted debug message
- */
-export function workerReceivedSIGTERM() {
-    return 'Received SIGTERM';
-}
-/**
- * Generate received SIGINT message.
- *
- * @returns Formatted debug message
- */
-export function workerReceivedSIGINT() {
-    return 'Received SIGINT';
-}
-/**
- * Generate timeout reached message.
- *
- * @returns Formatted debug message
- */
-export function workerTimeoutReached() {
-    return 'Timeout reached, initiating shutdown';
-}
-/**
- * Generate session active waiting message.
- *
- * @returns Formatted debug message
- */
-export function workerSessionActive() {
-    return 'Session active, waiting for signal or timeout...';
-}
-//# sourceMappingURL=debug.js.map

package/dist/ui/messages/debug.js.map

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

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

@@ -1,14 +0,0 @@
-/**
- * DOM command messages (bdg dom)
- *
- * User-facing messages for DOM command output and formatting.
- */
-/**
- * Generate resize info message for screenshot output.
- *
- * @param originalTokens - Token count at original size
- * @param finalTokens - Token count after resize
- * @returns Formatted resize info string
- */
-export declare function screenshotResizeInfo(originalTokens: number, finalTokens: number): string;
-//# sourceMappingURL=dom.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../../src/ui/messages/dom.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAeH;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAExF"}

package/dist/ui/messages/dom.js

@@ -1,28 +0,0 @@
-/**
- * DOM command messages (bdg dom)
- *
- * User-facing messages for DOM command output and formatting.
- */
-/**
- * Format token count for display.
- *
- * @param tokens - Token count
- * @returns Formatted string (e.g., "1.6k" or "500")
- */
-function formatTokenCount(tokens) {
-    if (tokens >= 1000) {
-        return `${(tokens / 1000).toFixed(1)}k`;
-    }
-    return String(tokens);
-}
-/**
- * Generate resize info message for screenshot output.
- *
- * @param originalTokens - Token count at original size
- * @param finalTokens - Token count after resize
- * @returns Formatted resize info string
- */
-export function screenshotResizeInfo(originalTokens, finalTokens) {
-    return `resized: ${formatTokenCount(originalTokens)} → ${formatTokenCount(finalTokens)} tokens`;
-}
-//# sourceMappingURL=dom.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"dom.js","sourceRoot":"","sources":["../../../src/ui/messages/dom.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,MAAc;IACtC,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QACnB,OAAO,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAC1C,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,cAAsB,EAAE,WAAmB;IAC9E,OAAO,YAAY,gBAAgB,CAAC,cAAc,CAAC,MAAM,gBAAgB,CAAC,WAAW,CAAC,SAAS,CAAC;AAClG,CAAC"}

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

@@ -1,233 +0,0 @@
-/**
- * Common error messages and patterns.
- *
- * Centralized location for reusable error messages with consistent formatting.
- */
-/**
- * Generate "session already running" error message.
- *
- * @param pid - Process ID of running session
- * @param duration - Session duration in milliseconds
- * @param targetUrl - Optional target URL to show
- * @returns Formatted error message
- *
- * @example
- * ```typescript
- * const message = sessionAlreadyRunningError(12345, 60000, 'http://localhost:3000');
- * console.error(message);
- * ```
- */
-export declare function sessionAlreadyRunningError(pid: number, duration: number, targetUrl?: string): string;
-/**
- * Context for daemon error messages.
- */
-export interface DaemonErrorContext {
-    /** Whether stale PID file was cleaned up */
-    staleCleanedUp?: boolean;
-    /** Whether to suggest checking status (for commands that expect daemon) */
-    suggestStatus?: boolean;
-    /** Whether to suggest retrying (for transient errors) */
-    suggestRetry?: boolean;
-    /** Last error message if available */
-    lastError?: string;
-}
-/**
- * Generate unified "daemon not running" error message with context.
- *
- * This replaces the three previous variants:
- * - daemonNotRunningError()
- * - daemonConnectionFailedError()
- * - daemonNotRunningWithCleanup()
- *
- * @param context - Optional context about the error
- * @returns Formatted error message with suggestions
- *
- * @example
- * ```typescript
- * // Basic usage
- * console.error(daemonNotRunningError());
- *
- * // With stale cleanup
- * console.error(daemonNotRunningError({ staleCleanedUp: true }));
- *
- * // With status suggestion
- * console.error(daemonNotRunningError({ suggestStatus: true }));
- * ```
- */
-export declare function daemonNotRunningError(context?: DaemonErrorContext): string;
-/**
- * Generate generic error message with optional context.
- *
- * @param message - Error message
- * @param context - Optional additional context
- * @returns Formatted error message
- *
- * @example
- * ```typescript
- * console.error(genericError('Operation failed', 'Network timeout'));
- * ```
- */
-export declare function genericError(message: string, context?: string): string;
-/**
- * Generate "unknown error" message.
- *
- * @returns Formatted error message
- */
-export declare function unknownError(): string;
-/**
- * Generate "invalid response" error message.
- *
- * @param reason - Reason for invalid response
- * @returns Formatted error message
- */
-export declare function invalidResponseError(reason: string): string;
-/**
- * Generate session not active error with state-aware suggestion.
- *
- * Provides context-appropriate guidance based on what operation was attempted.
- *
- * @param operation - Operation that was attempted (e.g., "peek", "dom query")
- * @returns Formatted error message with suggestions
- *
- * @example
- * ```typescript
- * throw new CommandError(
- *   sessionNotActiveError('peek'),
- *   {},
- *   EXIT_CODES.RESOURCE_NOT_FOUND
- * );
- * ```
- */
-export declare function sessionNotActiveError(operation: string): string;
-/**
- * Generate element not found error with shell quote detection and CDP fallback.
- *
- * Provides guidance for when high-level DOM commands fail to find elements.
- * Detects shell quote damage for attribute selectors and provides specific
- * recovery suggestions including the two-step query-then-inspect pattern.
- *
- * @param selector - CSS selector that failed (as received by the command)
- * @returns Formatted error message with context-aware suggestions
- *
- * @example
- * ```typescript
- * // Simple selector - standard suggestions
- * elementNotFoundError('#missing-element')
- *
- * // Attribute selector with shell damage detected
- * elementNotFoundError('[data-test-id=value]')
- * // Shows: "Shell quote handling detected. Selector received without quotes."
- * ```
- */
-export declare function elementNotFoundError(selector: string): string;
-/**
- * Error with suggestion pair for CommandError usage.
- */
-export interface ErrorWithSuggestion {
-    message: string;
-    suggestion: string;
-}
-/**
- * Index out of range error.
- */
-export declare function indexOutOfRangeError(index: number, max: number): ErrorWithSuggestion;
-/**
- * Element at index not found (stale cache).
- */
-export declare function elementAtIndexNotFoundError(index: number, selector: string): ErrorWithSuggestion;
-/**
- * No nodes found for selector.
- */
-export declare function noNodesFoundError(selector: string): ErrorWithSuggestion;
-/**
- * Element not visible/rendered.
- */
-export declare function elementNotVisibleError(): ErrorWithSuggestion;
-/**
- * Element has zero dimensions.
- */
-export declare function elementZeroDimensionsError(): ErrorWithSuggestion;
-/**
- * Missing required argument.
- */
-export declare function missingArgumentError(usage: string): ErrorWithSuggestion;
-/**
- * Either/or argument required.
- */
-export declare function eitherArgumentRequiredError(arg1: string, arg2: string, example: string): ErrorWithSuggestion;
-/**
- * Invalid query pattern.
- */
-export declare function invalidQueryPatternError(pattern: string): ErrorWithSuggestion;
-/**
- * No a11y nodes matching pattern.
- */
-export declare function noA11yNodesFoundError(pattern: string): ErrorWithSuggestion;
-/**
- * Element not accessible (a11y).
- */
-export declare function elementNotAccessibleError(index: number): ErrorWithSuggestion;
-/**
- * Fillable element not found.
- */
-export declare function fillableElementNotFoundError(selector: string): ErrorWithSuggestion;
-/**
- * Clickable element not found.
- */
-export declare function clickableElementNotFoundError(selector: string): ErrorWithSuggestion;
-/**
- * Key press failed.
- */
-export declare function keyPressFailedError(details: string): ErrorWithSuggestion;
-/**
- * Session target not found.
- */
-export declare function sessionTargetNotFoundError(): ErrorWithSuggestion;
-/**
- * Session metadata missing.
- */
-export declare function sessionMetadataMissingError(field: string): ErrorWithSuggestion;
-/**
- * Script execution error with shell quote detection.
- *
- * Shows the script as received to help diagnose shell quote stripping issues.
- * Detects common patterns like `querySelector(input)` that indicate shell damage.
- *
- * @param errorMessage - The JavaScript error message
- * @param receivedScript - The script as received by the command (optional for backwards compat)
- * @returns Error with context-aware suggestions
- */
-export declare function scriptExecutionError(errorMessage: string, receivedScript?: string): ErrorWithSuggestion;
-/**
- * Unexpected CDP response format.
- */
-export declare function unexpectedResponseFormatError(context: string): ErrorWithSuggestion;
-/**
- * Generic operation failure with dynamic error message.
- */
-export declare function operationFailedError(operation: string, errorMessage: string): ErrorWithSuggestion;
-/**
- * Internal error (should not happen in normal usage).
- */
-export declare function internalError(context: string): ErrorWithSuggestion;
-/**
- * No forms found on page.
- */
-export declare function noFormsFoundError(): ErrorWithSuggestion;
-/**
- * Form selection out of range.
- */
-export declare function formSelectionOutOfRangeError(index: number, count: number): ErrorWithSuggestion;
-/**
- * Form selection by name not found.
- */
-export declare function formSelectionByNameNotFoundError(name: string, availableNames: string[]): ErrorWithSuggestion;
-/**
- * Form in iframe (cross-origin or same-origin).
- */
-export declare function formInIframeError(iframeUrl: string, crossOrigin: boolean): ErrorWithSuggestion;
-/**
- * Custom component interaction warning.
- */
-export declare function customComponentWarning(elementType: string, suggestedAction: string): ErrorWithSuggestion;
-//# sourceMappingURL=errors.d.ts.map