browser-debugger-cli 0.6.0 → 0.6.2

package/dist/types.d.ts

@@ -1,70 +1,40 @@
-import type { ChildProcess } from 'child_process';
-export interface CDPMessage {
-    id?: number;
-    method?: string;
-    params?: Record<string, unknown>;
-    result?: unknown;
-    error?: {
-        code?: number;
-        message: string;
-    };
-    sessionId?: string;
-}
-export interface CDPTarget {
-    id: string;
-    type: string;
-    title: string;
-    url: string;
-    webSocketDebuggerUrl: string;
-}
+import type { Protocol } from './connection/typed-cdp.js';
+/**
+ * Re-export connection types for backward compatibility.
+ *
+ * These types are now defined in connection/connectionTypes.ts for better cohesion.
+ * This re-export maintains backward compatibility with existing code.
+ */
+export type { CDPMessage, CDPTarget, ConnectionOptions, LaunchedChrome, Logger, CleanupFunction, } from './connection/types.js';
 export interface DOMData {
     url: string;
     title: string;
     outerHTML: string;
+    a11yTree?: {
+        root: A11yNode;
+        nodes: Record<string, A11yNode>;
+        count: number;
+    };
 }
 export interface NetworkRequest {
     requestId: string;
     url: string;
     method: string;
     timestamp: number;
-    status?: number | undefined;
-    mimeType?: string | undefined;
+    status?: number;
+    mimeType?: string;
     requestHeaders?: Record<string, string>;
     responseHeaders?: Record<string, string>;
-    requestBody?: string | undefined;
-    responseBody?: string | undefined;
-    navigationId?: number | undefined;
+    requestBody?: string;
+    responseBody?: string;
+    navigationId?: number;
 }
 export interface ConsoleMessage {
-    type: string;
+    type: Protocol.Runtime.ConsoleAPICalledEvent['type'] | 'error';
     text: string;
     timestamp: number;
     args?: unknown[];
-    navigationId?: number | undefined;
-}
-/**
- * Screenshot capture data returned by dom screenshot command
- */
-export interface ScreenshotData {
-    /** Absolute path where screenshot was saved */
-    path: string;
-    /** Image format */
-    format: 'png' | 'jpeg';
-    /** JPEG quality (0-100), only present for JPEG format */
-    quality?: number;
-    /** Image width in pixels */
-    width: number;
-    /** Image height in pixels */
-    height: number;
-    /** File size in bytes */
-    size: number;
-    /** Viewport dimensions when fullPage is false */
-    viewport?: {
-        width: number;
-        height: number;
-    };
-    /** Whether screenshot captured full page or just viewport */
-    fullPage: boolean;
+    navigationId?: number;
 }
 export interface BdgOutput {
     version: string;
@@ -85,36 +55,75 @@ export interface BdgOutput {
 }
 export type TelemetryType = 'dom' | 'network' | 'console';
 /**
- * Optional tuning parameters for CDPConnection.connect.
+ * Accessibility tree node with filtered and formatted data.
+ *
+ * This is a simplified representation of Protocol.Accessibility.AXNode
+ * optimized for agent consumption and semantic queries.
+ */
+export interface A11yNode {
+    /** Unique node identifier from CDP */
+    nodeId: string;
+    /** ARIA role (button, textbox, heading, etc.) */
+    role: string;
+    /** Accessible name (computed label) */
+    name?: string;
+    /** Accessible description */
+    description?: string;
+    /** Node value (for inputs, textareas, etc.) */
+    value?: string;
+    /** Whether node is focusable */
+    focusable?: boolean;
+    /** Whether node is currently focused */
+    focused?: boolean;
+    /** Whether node is disabled */
+    disabled?: boolean;
+    /** Whether field is required (forms) */
+    required?: boolean;
+    /** Additional ARIA properties */
+    properties?: Record<string, unknown>;
+    /** Child node IDs */
+    childIds?: string[];
+    /** Associated DOM node ID for querying */
+    backendDOMNodeId?: number;
+}
+/**
+ * Accessibility tree data structure.
+ */
+export interface A11yTree {
+    /** Root node of the tree */
+    root: A11yNode;
+    /** All nodes indexed by nodeId for fast lookup */
+    nodes: Map<string, A11yNode>;
+    /** Total node count */
+    count: number;
+}
+/**
+ * Query pattern for searching accessibility tree.
+ *
+ * @example
+ * ```typescript
+ * { role: 'button', name: 'Submit' }
+ * { role: 'textbox' }
+ * { name: 'Email' }
+ * ```
  */
-export interface ConnectionOptions {
-    /** Milliseconds to wait for the initial socket open */
-    timeout?: number;
-    /** Number of connection attempts before failing */
-    maxRetries?: number;
-    /** Reconnect automatically when the socket closes */
-    autoReconnect?: boolean;
-    /** Interval between ping frames to keep CDP alive */
-    keepaliveInterval?: number;
-    /** Async hook invoked after a successful reconnect */
-    onReconnect?: (() => Promise<void>) | undefined;
-    /** Async hook invoked when WebSocket closes unexpectedly (P1 Fix #1) */
-    onDisconnect?: ((code: number, reason: string) => void | Promise<void>) | undefined;
+export interface A11yQueryPattern {
+    /** Filter by ARIA role */
+    role?: string;
+    /** Filter by accessible name (case-insensitive) */
+    name?: string;
+    /** Filter by accessible description (case-insensitive) */
+    description?: string;
 }
-export type CleanupFunction = () => void;
 /**
- * Information about a launched Chrome instance.
+ * Result from A11y query operation.
  */
-export interface LaunchedChrome {
-    /** Process ID of the Chrome instance */
-    pid: number;
-    /** Remote debugging port Chrome is listening on */
-    port: number;
-    /** Resolved Chrome user data directory (profile path) */
-    userDataDir?: string | undefined;
-    /** Child process handle (for advanced use cases like log streaming) */
-    process: ChildProcess | null;
-    /** Async function to terminate Chrome and cleanup temp directories */
-    kill: () => Promise<void>;
+export interface A11yQueryResult {
+    /** Matching nodes */
+    nodes: A11yNode[];
+    /** Total matches found */
+    count: number;
+    /** Query pattern used */
+    pattern: A11yQueryPattern;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/{commands/shared → ui}/OutputBuilder.d.ts

@@ -1,4 +1,10 @@
-import type { BdgOutput, CDPTarget, NetworkRequest, ConsoleMessage, DOMData, TelemetryType } from '../../types';
+/**
+ * Structured output building for CLI commands.
+ *
+ * Provides helpers for building consistent JSON output across all commands.
+ * Moved from commands/shared to ui layer as it's presentation logic, not command logic.
+ */
+import type { BdgOutput, CDPTarget, NetworkRequest, ConsoleMessage, DOMData, TelemetryType } from '../types';
 /**
  * Output mode determines what data is included and how partial flag is set
  */
@@ -46,7 +52,9 @@ export declare class OutputBuilder {
      */
     static buildJsonError(error: string | Error, options?: {
         exitCode?: number;
-        [key: string]: unknown;
+        suggestion?: string;
+        note?: string;
+        context?: Record<string, string>;
     }): Record<string, unknown>;
     /**
      * Build a simple JSON success response for commands.

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

@@ -0,0 +1 @@
+{"version":3,"file":"OutputBuilder.d.ts","sourceRoot":"","sources":["../../src/ui/OutputBuilder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,cAAc,EACd,cAAc,EACd,OAAO,EACP,aAAa,EACd,MAAM,SAAS,CAAC;AAIjB;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,aAAa,EAAE,CAAC;CAClC;AAED;;;GAGG;AACH,qBAAa,aAAa;IACxB;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,oBAAoB,GAAG,SAAS;IA4FtD;;;;;;;OAOG;IACH,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS;IAYnF;;;;;;;OAOG;IACH,MAAM,CAAC,cAAc,CACnB,KAAK,EAAE,MAAM,GAAG,KAAK,EACrB,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAClC,GACA,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAS1B;;;;;;OAMG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOhF"}

package/dist/{commands/shared → ui}/OutputBuilder.js

@@ -1,5 +1,11 @@
-import { getErrorMessage } from '../../ui/errors/index.js';
-import { VERSION } from '../../utils/version.js';
+/**
+ * Structured output building for CLI commands.
+ *
+ * Provides helpers for building consistent JSON output across all commands.
+ * Moved from commands/shared to ui layer as it's presentation logic, not command logic.
+ */
+import { getErrorMessage } from '../utils/errors.js';
+import { VERSION } from '../utils/version.js';
 /**
  * Helper: build output payloads for different modes with consistent metadata.
  * Modes: preview (metadata only), full (with bodies), final (complete with DOM).

package/dist/ui/OutputBuilder.js.map

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

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

@@ -3,6 +3,20 @@
  *
  * Provides CommandError class for throwing errors with metadata and exit codes.
  */
+/**
+ * Metadata that can be attached to command errors.
+ *
+ * Provides structured context for error messages including user-facing
+ * suggestions, technical notes, and additional context.
+ */
+export interface ErrorMetadata {
+    /** User-facing suggestion for resolving the error */
+    suggestion?: string;
+    /** Technical note or additional context */
+    note?: string;
+    /** Additional contextual key-value pairs */
+    context?: Record<string, string>;
+}
 /**
  * Custom error class for CLI commands with structured metadata.
  *
@@ -22,7 +36,7 @@ export declare class CommandError extends Error {
     /**
      * Additional context for the error (suggestions, notes, etc.)
      */
-    readonly metadata: Record<string, string>;
+    readonly metadata: ErrorMetadata;
     /**
      * Specific exit code for this error
      */
@@ -34,6 +48,6 @@ export declare class CommandError extends Error {
      * @param metadata - Additional context (suggestions, notes, etc.)
      * @param exitCode - Exit code to use when this error occurs
      */
-    constructor(message: string, metadata?: Record<string, string>, exitCode?: number);
+    constructor(message: string, metadata?: ErrorMetadata, exitCode?: number);
 }
 //# sourceMappingURL=CommandError.d.ts.map

package/dist/ui/errors/CommandError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CommandError.d.ts","sourceRoot":"","sources":["../../../src/ui/errors/CommandError.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;GAcG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC;;OAEG;IACH,SAAgB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjD;;OAEG;IACH,SAAgB,QAAQ,EAAE,MAAM,CAAC;IAEjC;;;;;;OAMG;gBACS,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EAAE,QAAQ,GAAE,MAAU;CAWzF"}
+{"version":3,"file":"CommandError.d.ts","sourceRoot":"","sources":["../../../src/ui/errors/CommandError.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC;;OAEG;IACH,SAAgB,QAAQ,EAAE,aAAa,CAAC;IAExC;;OAEG;IACH,SAAgB,QAAQ,EAAE,MAAM,CAAC;IAEjC;;;;;;OAMG;gBAED,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,aAAkB,EAC5B,QAAQ,GAAE,MAAmC;CAYhD"}

package/dist/ui/errors/CommandError.js

@@ -3,6 +3,7 @@
  *
  * Provides CommandError class for throwing errors with metadata and exit codes.
  */
+import { EXIT_CODES } from '../../utils/exitCodes.js';
 /**
  * Custom error class for CLI commands with structured metadata.
  *
@@ -34,7 +35,7 @@ export class CommandError extends Error {
      * @param metadata - Additional context (suggestions, notes, etc.)
      * @param exitCode - Exit code to use when this error occurs
      */
-    constructor(message, metadata = {}, exitCode = 1) {
+    constructor(message, metadata = {}, exitCode = EXIT_CODES.GENERIC_FAILURE) {
         super(message);
         this.name = 'CommandError';
         this.metadata = metadata;

package/dist/ui/errors/CommandError.js.map

@@ -1 +1 @@
-{"version":3,"file":"CommandError.js","sourceRoot":"","sources":["../../../src/ui/errors/CommandError.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC;;OAEG;IACa,QAAQ,CAAyB;IAEjD;;OAEG;IACa,QAAQ,CAAS;IAEjC;;;;;;OAMG;IACH,YAAY,OAAe,EAAE,WAAmC,EAAE,EAAE,WAAmB,CAAC;QACtF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAEzB,8DAA8D;QAC9D,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"CommandError.js","sourceRoot":"","sources":["../../../src/ui/errors/CommandError.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAiBlD;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC;;OAEG;IACa,QAAQ,CAAgB;IAExC;;OAEG;IACa,QAAQ,CAAS;IAEjC;;;;;;OAMG;IACH,YACE,OAAe,EACf,WAA0B,EAAE,EAC5B,WAAmB,UAAU,CAAC,eAAe;QAE7C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAEzB,8DAA8D;QAC9D,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;CACF"}

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

@@ -1,9 +1,8 @@
 /**
  * Error handling for bdg CLI.
  *
- * Provides structured error classes for CLI commands and re-exports domain errors.
+ * Provides structured error classes for CLI commands.
  */
-export { CommandError } from './CommandError.js';
-export { CDPConnectionError, ChromeLaunchError, CDPTimeoutError, getErrorMessage, } from '../../connection/errors.js';
+export { CommandError, type ErrorMetadata } from './CommandError.js';
 export { isDaemonConnectionError } from './utils.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ui/errors/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ui/errors/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC"}

package/dist/ui/errors/index.js

@@ -1,12 +1,10 @@
 /**
  * Error handling for bdg CLI.
  *
- * Provides structured error classes for CLI commands and re-exports domain errors.
+ * Provides structured error classes for CLI commands.
  */
 // CLI-level errors (user-facing command errors)
 export { CommandError } from './CommandError.js';
-// Re-export connection errors for backward compatibility (deprecated - import from @/connection/errors instead)
-export { CDPConnectionError, ChromeLaunchError, CDPTimeoutError, getErrorMessage, } from '../../connection/errors.js';
 // Utility functions
 export { isDaemonConnectionError } from './utils.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ui/errors/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,gDAAgD;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,gHAAgH;AAChH,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAEhC,oBAAoB;AACpB,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ui/errors/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,gDAAgD;AAChD,OAAO,EAAE,YAAY,EAAsB,MAAM,mBAAmB,CAAC;AAErE,oBAAoB;AACpB,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC"}

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

@@ -2,10 +2,16 @@
  * Error utility functions.
  *
  * Helper functions for detecting specific error conditions in the CLI layer.
+ *
+ * @deprecated This module re-exports IPC utilities for backward compatibility.
+ * Prefer importing from \@/ipc/utils/errors.js directly.
  */
 /**
  * Detect whether an error indicates the daemon/socket is unavailable.
  *
+ * @deprecated Use `isConnectionError` from \@/ipc/utils/errors.js instead.
+ * This function is maintained for backward compatibility.
+ *
  * @param error - Error of unknown type
  * @returns True if error indicates daemon connection failure
  *

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

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/ui/errors/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAG/D"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/ui/errors/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE/D"}

package/dist/ui/errors/utils.js

@@ -2,11 +2,17 @@
  * Error utility functions.
  *
  * Helper functions for detecting specific error conditions in the CLI layer.
+ *
+ * @deprecated This module re-exports IPC utilities for backward compatibility.
+ * Prefer importing from \@/ipc/utils/errors.js directly.
  */
-import { getErrorMessage } from '../../connection/errors.js';
+import { isConnectionError } from '../../ipc/utils/errors.js';
 /**
  * Detect whether an error indicates the daemon/socket is unavailable.
  *
+ * @deprecated Use `isConnectionError` from \@/ipc/utils/errors.js instead.
+ * This function is maintained for backward compatibility.
+ *
  * @param error - Error of unknown type
  * @returns True if error indicates daemon connection failure
  *
@@ -22,7 +28,6 @@ import { getErrorMessage } from '../../connection/errors.js';
  * ```
  */
 export function isDaemonConnectionError(error) {
-    const message = getErrorMessage(error);
-    return message.includes('ENOENT') || message.includes('ECONNREFUSED');
+    return isConnectionError(error);
 }
 //# sourceMappingURL=utils.js.map

package/dist/ui/errors/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/ui/errors/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACvC,OAAO,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;AACxE,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/ui/errors/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC"}

package/dist/ui/formatters/__tests__/semantic.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=semantic.unit.test.d.ts.map

package/dist/ui/formatters/__tests__/semantic.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic.unit.test.d.ts","sourceRoot":"","sources":["../../../../src/ui/formatters/__tests__/semantic.unit.test.ts"],"names":[],"mappings":""}

package/dist/ui/formatters/__tests__/semantic.unit.test.js

@@ -0,0 +1,111 @@
+import assert from 'node:assert/strict';
+import { describe, test } from 'node:test';
+import { semantic } from '../../../ui/formatters/semantic.js';
+describe('semantic formatter', () => {
+    test('formats simple tree with indentation', () => {
+        const tree = {
+            root: { nodeId: '1', role: 'RootWebArea', name: 'Test Page' },
+            nodes: new Map([
+                ['1', { nodeId: '1', role: 'RootWebArea', name: 'Test Page', childIds: ['2'] }],
+                ['2', { nodeId: '2', role: 'button', name: 'Click me', focusable: true }],
+            ]),
+            count: 2,
+        };
+        const output = semantic(tree);
+        assert.equal(output, '[RootWebArea] "Test Page"\n  [Button] "Click me" (focusable)');
+    });
+    test('handles heading levels', () => {
+        const tree = {
+            root: { nodeId: '1', role: 'heading', properties: { level: '1' } },
+            nodes: new Map([
+                ['1', { nodeId: '1', role: 'heading', name: 'Main Title', properties: { level: '1' } }],
+            ]),
+            count: 1,
+        };
+        const output = semantic(tree);
+        assert.equal(output, '[Heading L1] "Main Title"');
+    });
+    test('shows multiple properties', () => {
+        const node = {
+            nodeId: '1',
+            role: 'textbox',
+            name: 'Email',
+            focusable: true,
+            required: true,
+            disabled: false,
+        };
+        const tree = {
+            root: node,
+            nodes: new Map([['1', node]]),
+            count: 1,
+        };
+        const output = semantic(tree);
+        assert.equal(output, '[Textbox] "Email" (focusable, required)');
+    });
+    test('omits name when not present', () => {
+        const tree = {
+            root: { nodeId: '1', role: 'generic' },
+            nodes: new Map([
+                ['1', { nodeId: '1', role: 'generic', childIds: ['2'] }],
+                ['2', { nodeId: '2', role: 'paragraph', name: 'Text' }],
+            ]),
+            count: 2,
+        };
+        const output = semantic(tree);
+        assert.equal(output, '[Generic]\n  [Paragraph] "Text"');
+    });
+    test('handles deep nesting', () => {
+        const tree = {
+            root: { nodeId: '1', role: 'RootWebArea', childIds: ['2'] },
+            nodes: new Map([
+                ['1', { nodeId: '1', role: 'RootWebArea', childIds: ['2'] }],
+                ['2', { nodeId: '2', role: 'main', childIds: ['3'] }],
+                ['3', { nodeId: '3', role: 'navigation', childIds: ['4'] }],
+                ['4', { nodeId: '4', role: 'link', name: 'Home' }],
+            ]),
+            count: 4,
+        };
+        const output = semantic(tree);
+        assert.equal(output, '[RootWebArea]\n  [Main]\n    [Navigation]\n      [Link] "Home"');
+    });
+    test('handles all boolean properties', () => {
+        const node = {
+            nodeId: '1',
+            role: 'button',
+            name: 'Submit',
+            focusable: true,
+            focused: true,
+            disabled: true,
+            required: true,
+        };
+        const tree = {
+            root: node,
+            nodes: new Map([['1', node]]),
+            count: 1,
+        };
+        const output = semantic(tree);
+        assert.equal(output, '[Button] "Submit" (focusable, focused, disabled, required)');
+    });
+    test('handles nodes without children', () => {
+        const tree = {
+            root: { nodeId: '1', role: 'button', name: 'Click' },
+            nodes: new Map([['1', { nodeId: '1', role: 'button', name: 'Click' }]]),
+            count: 1,
+        };
+        const output = semantic(tree);
+        assert.equal(output, '[Button] "Click"');
+    });
+    test('capitalizes role names', () => {
+        const tree = {
+            root: { nodeId: '1', role: 'navigation' },
+            nodes: new Map([
+                ['1', { nodeId: '1', role: 'navigation', childIds: ['2'] }],
+                ['2', { nodeId: '2', role: 'searchbox', name: 'Search' }],
+            ]),
+            count: 2,
+        };
+        const output = semantic(tree);
+        assert.equal(output, '[Navigation]\n  [Searchbox] "Search"');
+    });
+});
+//# sourceMappingURL=semantic.unit.test.js.map

package/dist/ui/formatters/__tests__/semantic.unit.test.js.map

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

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

@@ -0,0 +1,30 @@
+import type { A11yTree, A11yQueryResult, A11yNode } from '../../types.js';
+/**
+ * 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.
+ *
+ * @param tree - Accessibility tree data
+ * @returns Formatted output string
+ */
+export declare function formatA11yTree(tree: A11yTree): string;
+/**
+ * Format query result for human-readable output.
+ *
+ * Shows matching nodes with their role, name, and properties.
+ *
+ * @param result - Query result with matching nodes
+ * @returns Formatted output string
+ */
+export declare function formatA11yQueryResult(result: A11yQueryResult): string;
+/**
+ * Format single accessibility node for human-readable output.
+ *
+ * Shows detailed properties including role, name, description, value, and states.
+ *
+ * @param node - Accessibility node
+ * @returns Formatted output string
+ */
+export declare function formatA11yNode(node: A11yNode): string;
+//# sourceMappingURL=a11y.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"a11y.d.ts","sourceRoot":"","sources":["../../../src/ui/formatters/a11y.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AActE;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAmBrD;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAyBrE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CA8CrD"}