@qontinui/ui-bridge 0.2.0 → 0.3.1

package/dist/{types-CPMbN_Iw.d.ts → types-suaYwWWg.d.ts}

@@ -1,8 +1,142 @@
+/**
+ * Browser Event Capture Types
+ *
+ * Discriminated union of all browser-side events captured for debugging.
+ */
+type BrowserEventType = 'console' | 'network' | 'react-error' | 'navigation' | 'long-task' | 'long-animation-frame' | 'resource-error' | 'web-vital' | 'memory' | 'ws-disconnection' | 'hmr';
+interface BrowserCapturedEvent {
+    type: BrowserEventType;
+    timestamp: number;
+    url: string;
+}
+interface ConsoleCapturedEvent extends BrowserCapturedEvent {
+    type: 'console';
+    level: 'error' | 'warn' | 'unhandledrejection';
+    message: string;
+    stack?: string;
+}
+interface NetworkCapturedEvent extends BrowserCapturedEvent {
+    type: 'network';
+    method: string;
+    requestUrl: string;
+    status?: number;
+    statusText?: string;
+    durationMs: number;
+    kind: 'http-error' | 'network-error' | 'timeout' | 'cors' | 'abort';
+    errorMessage?: string;
+}
+interface ReactErrorCapturedEvent extends BrowserCapturedEvent {
+    type: 'react-error';
+    message: string;
+    stack?: string;
+    componentStack?: string;
+}
+interface NavigationCapturedEvent extends BrowserCapturedEvent {
+    type: 'navigation';
+    from: string;
+    to: string;
+    trigger: 'pushState' | 'replaceState' | 'popstate';
+}
+interface LongTaskCapturedEvent extends BrowserCapturedEvent {
+    type: 'long-task';
+    durationMs: number;
+}
+interface ResourceErrorCapturedEvent extends BrowserCapturedEvent {
+    type: 'resource-error';
+    resourceUrl: string;
+    tagName: string;
+}
+interface WebVitalCapturedEvent extends BrowserCapturedEvent {
+    type: 'web-vital';
+    metric: 'LCP' | 'CLS';
+    value: number;
+}
+interface MemoryCapturedEvent extends BrowserCapturedEvent {
+    type: 'memory';
+    usedJSHeapSize: number;
+    totalJSHeapSize: number;
+    jsHeapSizeLimit: number;
+}
+interface WsDisconnectionCapturedEvent extends BrowserCapturedEvent {
+    type: 'ws-disconnection';
+    previousState: string;
+    newState: string;
+    reconnectAttempt?: number;
+}
+interface HmrCapturedEvent extends BrowserCapturedEvent {
+    type: 'hmr';
+    level: 'error' | 'warning';
+    message: string;
+    /** Source file that caused the error, if available */
+    moduleName?: string;
+    /** Source location (line:col), if available */
+    loc?: string;
+}
+interface LoafScriptAttribution {
+    invoker: string;
+    sourceURL: string;
+    sourceFunctionName: string;
+    sourceCharPosition: number;
+    duration: number;
+}
+interface LoafCapturedEvent extends BrowserCapturedEvent {
+    type: 'long-animation-frame';
+    durationMs: number;
+    blockingDurationMs: number;
+    scripts: LoafScriptAttribution[];
+}
+type AnyCapturedEvent = ConsoleCapturedEvent | NetworkCapturedEvent | ReactErrorCapturedEvent | NavigationCapturedEvent | LongTaskCapturedEvent | LoafCapturedEvent | ResourceErrorCapturedEvent | WebVitalCapturedEvent | MemoryCapturedEvent | WsDisconnectionCapturedEvent | HmrCapturedEvent;
+type OnBrowserEventCallback = (event: AnyCapturedEvent) => void;
+interface CapturedError {
+    timestamp: number;
+    level: 'error' | 'warn' | 'unhandledrejection';
+    message: string;
+    stack?: string;
+}
+/**
+ * @deprecated Use OnBrowserEventCallback instead
+ */
+type OnCaptureCallback = (entry: CapturedError) => void;
+interface BrowserCaptureConfig {
+    /** Capture console.error/warn + unhandled rejections. Default: true */
+    console?: boolean;
+    /** Capture failed fetch requests (4xx/5xx/network errors). Default: true */
+    network?: boolean;
+    /** Capture History API navigation. Default: true */
+    navigation?: boolean;
+    /** Capture PerformanceObserver long tasks. Default: true */
+    longTasks?: boolean;
+    /** Capture Long Animation Frames (LoAF) with script attribution. Default: true */
+    longAnimationFrames?: boolean;
+    /** Capture failed resource loads (img/script/link). Default: true */
+    resourceErrors?: boolean;
+    /** Capture WebSocket disconnection events. Default: true */
+    wsDisconnections?: boolean;
+    /** Capture Next.js HMR compilation errors/warnings via EventSource. Default: true */
+    hmr?: boolean;
+    /** Capture Web Vitals (LCP, CLS). Default: false (opt-in) */
+    webVitals?: boolean;
+    /** Capture Chrome memory snapshots. Default: false (opt-in) */
+    memory?: boolean;
+    /** Advanced: network capture options */
+    networkOptions?: {
+        /** URL patterns to ignore (substrings). Defaults to dev-debug/ui-bridge endpoints. */
+        ignorePatterns?: string[];
+    };
+    /** Advanced: memory polling interval in ms. Default: 30000 */
+    memoryIntervalMs?: number;
+    /** Maximum buffer size. Default: 200 */
+    maxEntries?: number;
+}
+declare const DEFAULT_CAPTURE_CONFIG: Required<Pick<BrowserCaptureConfig, 'console' | 'network' | 'navigation' | 'longTasks' | 'longAnimationFrames' | 'resourceErrors' | 'wsDisconnections' | 'hmr' | 'webVitals' | 'memory' | 'memoryIntervalMs' | 'maxEntries'>>;
+
 /**
  * UI Bridge Core Types
  *
- * Defines the fundamental types used throughout the UI Bridge framework.
+ * Defines the fundamental types used throughout the UI Bridge framework,
+ * plus ui-bridge-specific types (WebSocket protocol, accessibility, extended workflow types).
  */
+
 /**
  * Element identification using multiple strategies
  */
@@ -63,6 +197,29 @@ interface ElementState {
  * Types of UI elements that can be registered
  */
 type ElementType = 'button' | 'input' | 'select' | 'checkbox' | 'radio' | 'link' | 'form' | 'textarea' | 'menu' | 'menuitem' | 'tab' | 'dialog' | 'custom' | 'switch' | 'slider' | 'combobox' | 'listbox' | 'option' | 'textbox' | 'generic';
+/**
+ * Types of static content elements (non-interactive)
+ */
+type ContentType = 'heading' | 'paragraph' | 'list-item' | 'table-cell' | 'table-header' | 'label' | 'caption' | 'blockquote' | 'code-block' | 'badge' | 'status-message' | 'metric-value' | 'description-text' | 'nav-text' | 'content-generic';
+/**
+ * Semantic role of content elements
+ */
+type ContentRole = 'heading' | 'body-text' | 'list-item' | 'table-cell' | 'table-header' | 'label' | 'caption' | 'quote' | 'code' | 'badge' | 'status' | 'metric' | 'description' | 'navigation' | 'generic';
+/**
+ * Metadata for content elements
+ */
+interface ContentMetadata {
+    /** Semantic role of the content */
+    contentRole: ContentRole;
+    /** Heading level (1-6) for heading content */
+    headingLevel?: number;
+    /** Whether the content is dynamically updated */
+    dynamic?: boolean;
+    /** Stable text prefix for identification when full text changes */
+    stableTextPrefix?: string;
+    /** Structural context (e.g., "table > tbody > tr:nth-child(2)") */
+    structuralContext?: string;
+}
 /**
  * Standard actions available on elements
  */
@@ -108,6 +265,10 @@ interface RegisteredElement {
     registeredAt: number;
     /** Whether this element is currently mounted */
     mounted: boolean;
+    /** Whether this is an interactive element or static content */
+    category?: 'interactive' | 'content';
+    /** Metadata for content elements */
+    contentMetadata?: ContentMetadata;
     /** Alternative names for natural language matching */
     aliases?: string[];
     /** Human-readable description for AI agents */
@@ -117,6 +278,10 @@ interface RegisteredElement {
     /** Purpose of the element */
     purpose?: string;
 }
+/**
+ * Generic state getter function
+ */
+type StateGetter<T = unknown> = () => T;
 /**
  * Component action definition
  */
@@ -150,6 +315,10 @@ interface RegisteredComponent {
     registeredAt: number;
     /** Whether this component is currently mounted */
     mounted: boolean;
+    /** State getter function */
+    getState?: StateGetter<Record<string, unknown>>;
+    /** Computed properties getter function */
+    getComputed?: () => Record<string, unknown>;
 }
 /**
  * Workflow step types
@@ -252,6 +421,25 @@ interface WorkflowStep {
     /** Log configuration (type: 'log') */
     logConfig?: LogConfig;
 }
+/**
+ * Extended workflow step with additional branch/loop/extract support
+ */
+interface ExtendedWorkflowStep extends WorkflowStep {
+    /** Branch condition (type: 'branch') */
+    branchCondition?: BranchCondition;
+    /** Steps to execute if branch condition is true */
+    thenSteps?: ExtendedWorkflowStep[];
+    /** Steps to execute if branch condition is false */
+    elseSteps?: ExtendedWorkflowStep[];
+    /** Loop configuration (type: 'loop') */
+    loopConfig?: LoopConfig;
+    /** Steps to execute in loop */
+    loopSteps?: ExtendedWorkflowStep[];
+    /** Extract configuration (type: 'extract') */
+    extractConfig?: ExtractConfig;
+    /** Log configuration (type: 'log') */
+    logConfig?: LogConfig;
+}
 /**
  * Workflow definition
  */
@@ -332,6 +520,69 @@ interface ActionResponse {
     durationMs: number;
     /** Timestamp when the action completed */
     timestamp: number;
+    /** Console errors/warnings captured during action execution */
+    consoleErrors?: CapturedError[];
+}
+/**
+ * Machine-readable error codes for action failures
+ */
+type ActionErrorCode = 'ELEMENT_NOT_FOUND' | 'ELEMENT_NOT_VISIBLE' | 'ELEMENT_NOT_ENABLED' | 'ELEMENT_NOT_INTERACTABLE' | 'ACTION_TIMEOUT' | 'ACTION_REJECTED' | 'STATE_NOT_REACHED' | 'NETWORK_ERROR' | 'PARSE_ERROR' | 'VALIDATION_ERROR' | 'AMBIGUOUS_MATCH' | 'LOW_CONFIDENCE' | 'UNSUPPORTED_ACTION' | 'UNKNOWN_ERROR';
+/**
+ * Partial element match found during search
+ */
+interface PartialMatch {
+    /** Element ID of the partial match */
+    elementId: string;
+    /** Match confidence score (0-1) */
+    confidence: number;
+    /** Reason for partial match */
+    reason: string;
+    /** Type of match */
+    type: string;
+    /** Description of the match */
+    description?: string;
+}
+/**
+ * Suggested recovery action
+ */
+interface RecoveryAction {
+    /** Human-readable suggestion */
+    suggestion: string;
+    /** Optional command to execute */
+    command?: string;
+    /** Confidence score (0-1) */
+    confidence: number;
+    /** Whether the original action can be retried */
+    retryable: boolean;
+}
+/**
+ * Structured error details for action failures
+ */
+interface ActionFailureDetails {
+    /** Machine-readable error code */
+    errorCode: ActionErrorCode;
+    /** Human-readable error message */
+    message: string;
+    /** Element ID that was targeted */
+    elementId?: string;
+    /** CSS selectors that were tried */
+    selectorsTried?: string[];
+    /** Partial matches found during element search */
+    partialMatches?: PartialMatch[];
+    /** Element state at time of failure */
+    elementState?: ElementState;
+    /** Screenshot context (base64 or URL) */
+    screenshotContext?: string;
+    /** Suggested recovery actions */
+    suggestedActions: RecoveryAction[];
+    /** Whether retrying is recommended */
+    retryRecommended: boolean;
+    /** Additional context */
+    context?: Record<string, unknown>;
+    /** Duration of the action in milliseconds */
+    durationMs?: number;
+    /** Timeout that was configured in milliseconds */
+    timeoutMs?: number;
 }
 /**
  * Snapshot of the entire UI bridge state
@@ -342,12 +593,14 @@ interface BridgeSnapshot {
     /** All registered elements */
     elements: Array<{
         id: string;
-        type: ElementType;
+        type: ElementType | string;
         label?: string;
         identifier: ElementIdentifier;
         state: ElementState;
         actions: StandardAction[];
         customActions?: string[];
+        category?: 'interactive' | 'content';
+        contentMetadata?: ContentMetadata;
     }>;
     /** All registered components */
     components: Array<{
@@ -365,6 +618,22 @@ interface BridgeSnapshot {
         stepCount: number;
     }>;
 }
+/**
+ * Event types emitted by the bridge
+ */
+type BridgeEventType = 'element:registered' | 'element:unregistered' | 'element:stateChanged' | 'component:registered' | 'component:unregistered' | 'action:started' | 'action:completed' | 'action:failed' | 'workflow:started' | 'workflow:stepCompleted' | 'workflow:completed' | 'workflow:failed' | 'render:snapshot' | 'error';
+/**
+ * Event payload structure
+ */
+interface BridgeEvent<T = unknown> {
+    type: BridgeEventType;
+    timestamp: number;
+    data: T;
+}
+/**
+ * Event listener function
+ */
+type BridgeEventListener<T = unknown> = (event: BridgeEvent<T>) => void;
 /**
  * UI Bridge feature flags
  */
@@ -394,23 +663,170 @@ interface UIBridgeConfig {
     maxLogEntries?: number;
     /** Enable verbose logging */
     verbose?: boolean;
+    /** Application info for discovery */
+    appInfo?: {
+        appId: string;
+        appName: string;
+        appType: 'web' | 'desktop' | 'mobile' | 'other';
+        framework?: string;
+    };
 }
 /**
- * Event types emitted by the bridge
+ * Computed property definition
  */
-type BridgeEventType = 'element:registered' | 'element:unregistered' | 'element:stateChanged' | 'component:registered' | 'component:unregistered' | 'action:started' | 'action:completed' | 'action:failed' | 'workflow:started' | 'workflow:stepCompleted' | 'workflow:completed' | 'workflow:failed' | 'render:snapshot' | 'error';
+interface ComputedProperty<T = unknown> {
+    /** Getter function for the computed value */
+    getter: () => T;
+    /** Description of what the computed property represents */
+    description?: string;
+}
 /**
- * Event payload structure
+ * Response from getting component state
  */
-interface BridgeEvent<T = unknown> {
-    type: BridgeEventType;
+interface ComponentStateResponse {
+    /** Current state values */
+    state: Record<string, unknown>;
+    /** Current computed property values */
+    computed: Record<string, unknown>;
+    /** Timestamp when the state was captured */
     timestamp: number;
-    data: T;
 }
 /**
- * Event listener function
+ * UI State definition
+ *
+ * Represents a distinct state in the UI (e.g., "LoginForm", "Dashboard", "Modal").
+ * States can be active or inactive, and can block other states from activating.
  */
-type BridgeEventListener<T = unknown> = (event: BridgeEvent<T>) => void;
+interface UIState {
+    /** Unique state identifier */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Element IDs belonging to this state */
+    elements: string[];
+    /** Optional function to detect if state is active */
+    activeWhen?: () => boolean;
+    /** If true, blocks other state activations (modal behavior) */
+    blocking?: boolean;
+    /** Specific state IDs this state blocks */
+    blocks?: string[];
+    /** State group membership */
+    group?: string;
+    /** Cost for pathfinding (default: 1.0) */
+    pathCost?: number;
+    /** Custom metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * State group - states that activate/deactivate atomically
+ *
+ * When a group is activated, all its states are activated together.
+ * When deactivated, all states are deactivated together.
+ */
+interface UIStateGroup {
+    /** Unique group identifier */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** State IDs belonging to this group */
+    states: string[];
+}
+/**
+ * State transition definition
+ *
+ * Defines how to move from one set of states to another,
+ * including any actions to execute during the transition.
+ */
+interface UITransition {
+    /** Unique transition identifier */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Precondition: at least one must be active */
+    fromStates: string[];
+    /** States to activate */
+    activateStates: string[];
+    /** States to deactivate */
+    exitStates: string[];
+    /** Groups to activate */
+    activateGroups?: string[];
+    /** Groups to deactivate */
+    exitGroups?: string[];
+    /** Actions to execute during transition */
+    actions?: WorkflowStep[];
+    /** Cost for pathfinding */
+    pathCost?: number;
+    /** Whether source states remain visible during transition */
+    staysVisible?: boolean;
+}
+/**
+ * Path result from pathfinding
+ *
+ * Returned when searching for a path to target states.
+ */
+interface PathResult {
+    /** Whether a path was found */
+    found: boolean;
+    /** Transition IDs in order to reach target */
+    transitions: string[];
+    /** Total cost of the path */
+    totalCost: number;
+    /** Target state IDs */
+    targetStates: string[];
+    /** Estimated number of steps */
+    estimatedSteps: number;
+}
+/**
+ * Transition execution result
+ */
+interface TransitionResult {
+    /** Whether the transition succeeded */
+    success: boolean;
+    /** States that were activated */
+    activatedStates: string[];
+    /** States that were deactivated */
+    deactivatedStates: string[];
+    /** Error message if failed */
+    error?: string;
+    /** Phase where failure occurred (if any) */
+    failedPhase?: string;
+    /** Duration of the transition in milliseconds */
+    durationMs: number;
+}
+/**
+ * Navigation result
+ *
+ * Returned after navigating to target states via pathfinding.
+ */
+interface NavigationResult {
+    /** Whether navigation succeeded */
+    success: boolean;
+    /** The path that was followed */
+    path: PathResult;
+    /** Transitions that were executed */
+    executedTransitions: string[];
+    /** Final active states after navigation */
+    finalActiveStates: string[];
+    /** Error message if failed */
+    error?: string;
+    /** Duration of the navigation in milliseconds */
+    durationMs: number;
+}
+/**
+ * State manager snapshot
+ */
+interface StateSnapshot {
+    /** Timestamp of the snapshot */
+    timestamp: number;
+    /** Currently active state IDs */
+    activeStates: string[];
+    /** All registered states */
+    states: UIState[];
+    /** All registered state groups */
+    groups: UIStateGroup[];
+    /** All registered transitions */
+    transitions: UITransition[];
+}
 /**
  * WebSocket message types from client to server
  */
@@ -436,11 +852,8 @@ interface WSMessageBase {
 interface WSSubscribeMessage extends WSMessageBase {
     type: 'subscribe';
     payload: {
-        /** Event types to subscribe to (empty = all events) */
         events?: BridgeEventType[];
-        /** Filter events by element ID */
         elementIds?: string[];
-        /** Filter events by component ID */
         componentIds?: string[];
     };
 }
@@ -450,7 +863,6 @@ interface WSSubscribeMessage extends WSMessageBase {
 interface WSUnsubscribeMessage extends WSMessageBase {
     type: 'unsubscribe';
     payload: {
-        /** Event types to unsubscribe from (empty = all) */
         events?: BridgeEventType[];
     };
 }
@@ -472,7 +884,7 @@ interface WSFindMessage extends WSMessageBase {
     };
 }
 /**
- * Client message: Discover elements
+ * Client message: Discover elements (deprecated)
  * @deprecated Use WSFindMessage instead
  */
 interface WSDiscoverMessage extends WSMessageBase {
@@ -506,7 +918,11 @@ interface WSExecuteActionMessage extends WSMessageBase {
     type: 'executeAction';
     payload: {
         elementId: string;
-        action: ActionRequest;
+        action: {
+            action: string;
+            params?: Record<string, unknown>;
+            waitOptions?: WaitOptions;
+        };
     };
 }
 /**
@@ -528,7 +944,6 @@ interface WSExecuteWorkflowMessage extends WSMessageBase {
     payload: {
         workflowId: string;
         params?: Record<string, unknown>;
-        /** Stream progress updates */
         streamProgress?: boolean;
     };
 }
@@ -542,11 +957,8 @@ type WSClientMessage = WSSubscribeMessage | WSUnsubscribeMessage | WSPingMessage
 interface WSWelcomeMessage extends WSMessageBase {
     type: 'welcome';
     payload: {
-        /** Server version */
         version: string;
-        /** Available features */
         features: UIBridgeFeatures;
-        /** Client ID assigned by server */
         clientId: string;
     };
 }
@@ -562,7 +974,6 @@ interface WSPongMessage extends WSMessageBase {
 interface WSSubscribedMessage extends WSMessageBase {
     type: 'subscribed';
     payload: {
-        /** Events now subscribed to */
         events: BridgeEventType[];
     };
 }
@@ -572,7 +983,6 @@ interface WSSubscribedMessage extends WSMessageBase {
 interface WSUnsubscribedMessage extends WSMessageBase {
     type: 'unsubscribed';
     payload: {
-        /** Events unsubscribed from */
         events: BridgeEventType[];
     };
 }
@@ -588,7 +998,6 @@ interface WSEventMessage extends WSMessageBase {
  */
 interface WSResponseMessage<T = unknown> extends WSMessageBase {
     type: 'response';
-    /** ID of the request this responds to */
     requestId: string;
     payload: {
         success: boolean;
@@ -601,7 +1010,6 @@ interface WSResponseMessage<T = unknown> extends WSMessageBase {
  */
 interface WSErrorMessage extends WSMessageBase {
     type: 'error';
-    /** ID of the request that caused the error (if applicable) */
     requestId?: string;
     payload: {
         code: string;
@@ -614,23 +1022,17 @@ interface WSErrorMessage extends WSMessageBase {
  */
 interface WSWorkflowProgressMessage extends WSMessageBase {
     type: 'workflowProgress';
-    /** ID of the workflow execution request */
     requestId: string;
     payload: {
         workflowId: string;
-        /** Current step index (0-based) */
         currentStep: number;
-        /** Total number of steps */
         totalSteps: number;
-        /** Current step info */
         step: {
             id: string;
-            type: WorkflowStep['type'];
+            type: string;
             status: 'pending' | 'running' | 'completed' | 'failed';
         };
-        /** Result of the current step (if completed) */
         stepResult?: unknown;
-        /** Error (if failed) */
         error?: string;
     };
 }
@@ -671,140 +1073,105 @@ interface WSSubscriptionOptions {
     componentIds?: string[];
 }
 /**
- * UI State definition
- *
- * Represents a distinct state in the UI (e.g., "LoginForm", "Dashboard", "Modal").
- * States can be active or inactive, and can block other states from activating.
+ * ARIA checked state (can be boolean or 'mixed' for indeterminate)
  */
-interface UIState {
-    /** Unique state identifier */
-    id: string;
-    /** Human-readable name */
-    name: string;
-    /** Element IDs belonging to this state */
-    elements: string[];
-    /** Optional function to detect if state is active */
-    activeWhen?: () => boolean;
-    /** If true, blocks other state activations (modal behavior) */
-    blocking?: boolean;
-    /** Specific state IDs this state blocks */
-    blocks?: string[];
-    /** State group membership */
-    group?: string;
-    /** Cost for pathfinding (default: 1.0) */
-    pathCost?: number;
-    /** Custom metadata */
-    metadata?: Record<string, unknown>;
-}
+type AriaCheckedState = boolean | 'mixed';
 /**
- * State group - states that activate/deactivate atomically
- *
- * When a group is activated, all its states are activated together.
- * When deactivated, all states are deactivated together.
+ * Accessibility information for a UI element
  */
-interface UIStateGroup {
-    /** Unique group identifier */
-    id: string;
-    /** Human-readable name */
-    name: string;
-    /** State IDs belonging to this group */
-    states: string[];
+interface ElementAccessibility {
+    /** The element's computed role (explicit or implicit) */
+    role: string;
+    /** Computed accessible name following ARIA name computation */
+    accessibleName?: string;
+    /** Computed accessible description */
+    accessibleDescription?: string;
+    /** Value of aria-label attribute */
+    ariaLabel?: string;
+    /** Value of aria-labelledby attribute */
+    ariaLabelledBy?: string;
+    /** Value of aria-describedby attribute */
+    ariaDescribedBy?: string;
+    /** Whether element is expanded (for expandable elements) */
+    ariaExpanded?: boolean;
+    /** Whether element is selected (for selectable elements) */
+    ariaSelected?: boolean;
+    /** Checked state (for checkboxes, can be true/false/'mixed') */
+    ariaChecked?: AriaCheckedState;
+    /** Whether element is hidden from accessibility tree */
+    ariaHidden?: boolean;
+    /** Whether element is disabled via aria-disabled */
+    ariaDisabled?: boolean;
+    /** Whether element is required (for form inputs) */
+    ariaRequired?: boolean;
+    /** Current aria-live value for live regions */
+    ariaLive?: 'off' | 'polite' | 'assertive';
+    /** Tab index value */
+    tabIndex: number;
+    /** Whether element is in the tab order (tabindex >= 0 or naturally focusable) */
+    isInTabOrder: boolean;
+    /** Whether element can receive keyboard focus */
+    isKeyboardAccessible: boolean;
+    /** The implicit role based on element type (before explicit role override) */
+    implicitRole?: string;
+    /** Whether element has an explicit role attribute */
+    hasExplicitRole: boolean;
 }
 /**
- * State transition definition
- *
- * Defines how to move from one set of states to another,
- * including any actions to execute during the transition.
+ * WCAG conformance level
  */
-interface UITransition {
-    /** Unique transition identifier */
-    id: string;
-    /** Human-readable name */
-    name: string;
-    /** Precondition: at least one must be active */
-    fromStates: string[];
-    /** States to activate */
-    activateStates: string[];
-    /** States to deactivate */
-    exitStates: string[];
-    /** Groups to activate */
-    activateGroups?: string[];
-    /** Groups to deactivate */
-    exitGroups?: string[];
-    /** Actions to execute during transition */
-    actions?: WorkflowStep[];
-    /** Cost for pathfinding */
-    pathCost?: number;
-    /** Whether source states remain visible during transition */
-    staysVisible?: boolean;
-}
-/**
- * Path result from pathfinding
- *
- * Returned when searching for a path to target states.
- */
-interface PathResult {
-    /** Whether a path was found */
-    found: boolean;
-    /** Transition IDs in order to reach target */
-    transitions: string[];
-    /** Total cost of the path */
-    totalCost: number;
-    /** Target state IDs */
-    targetStates: string[];
-    /** Estimated number of steps */
-    estimatedSteps: number;
-}
+type WCAGLevel = 'A' | 'AA' | 'AAA';
 /**
- * Transition execution result
+ * Accessibility issue severity
  */
-interface TransitionResult {
-    /** Whether the transition succeeded */
-    success: boolean;
-    /** States that were activated */
-    activatedStates: string[];
-    /** States that were deactivated */
-    deactivatedStates: string[];
-    /** Error message if failed */
-    error?: string;
-    /** Phase where failure occurred (if any) */
-    failedPhase?: string;
-    /** Duration of the transition in milliseconds */
-    durationMs: number;
-}
+type AccessibilitySeverity = 'critical' | 'serious' | 'moderate' | 'minor';
 /**
- * Navigation result
- *
- * Returned after navigating to target states via pathfinding.
+ * An accessibility issue found during validation
  */
-interface NavigationResult {
-    /** Whether navigation succeeded */
-    success: boolean;
-    /** The path that was followed */
-    path: PathResult;
-    /** Transitions that were executed */
-    executedTransitions: string[];
-    /** Final active states after navigation */
-    finalActiveStates: string[];
-    /** Error message if failed */
-    error?: string;
-    /** Duration of the navigation in milliseconds */
-    durationMs: number;
+interface AccessibilityIssue {
+    /** Unique identifier for this issue instance */
+    id: string;
+    /** The WCAG success criterion this issue relates to (e.g., "4.1.2") */
+    wcagCriterion: string;
+    /** How severe this issue is */
+    severity: AccessibilitySeverity;
+    /** WCAG conformance level this criterion belongs to */
+    level: WCAGLevel;
+    /** Human-readable description of the issue */
+    message: string;
+    /** ID of the element with the issue */
+    elementId: string;
+    /** Selector to find the element */
+    elementSelector?: string;
+    /** Suggested fix for the issue */
+    suggestion: string;
+    /** The rule ID that detected this issue */
+    ruleId: string;
 }
 /**
- * State manager snapshot
+ * Accessibility validation report
  */
-interface StateSnapshot {
-    /** Timestamp of the snapshot */
+interface AccessibilityReport {
+    /** When the validation was performed */
     timestamp: number;
-    /** Currently active state IDs */
-    activeStates: string[];
-    /** All registered states */
-    states: UIState[];
-    /** All registered state groups */
-    groups: UIStateGroup[];
-    /** All registered transitions */
-    transitions: UITransition[];
+    /** URL of the page that was validated */
+    url: string;
+    /** Number of elements that were scanned */
+    elementsScanned: number;
+    /** All issues found during validation */
+    issues: AccessibilityIssue[];
+    /** Number of checks that passed */
+    passedCount: number;
+    /** Number of checks that failed */
+    failedCount: number;
+    /** Whether the page meets WCAG 2.1 Level A */
+    meetsWCAG_A: boolean;
+    /** Whether the page meets WCAG 2.1 Level AA */
+    meetsWCAG_AA: boolean;
+    /** Human-readable summary of the validation */
+    summary: string;
+    /** Duration of the validation in milliseconds */
+    durationMs: number;
 }
 
-export type { WSWorkflowProgressMessage as $, ActionHandler as A, BranchCondition as B, ComponentAction as C, WSFindMessage as D, ElementIdentifier as E, WSGetElementMessage as F, WSGetSnapshotMessage as G, WSMessageBase as H, WSPingMessage as I, WSPongMessage as J, WSResponseMessage as K, LogConfig as L, WSServerMessage as M, NavigationResult as N, WSServerMessageType as O, PathResult as P, WSSubscribeMessage as Q, RegisteredComponent as R, StandardAction as S, TransitionResult as T, UIBridgeConfig as U, WSSubscribedMessage as V, WSClientConfig as W, WSSubscriptionOptions as X, WSUnsubscribeMessage as Y, WSUnsubscribedMessage as Z, WSWelcomeMessage as _, ActionRequest as a, WaitOptions as a0, Workflow as a1, WorkflowStep as a2, WorkflowStepType as a3, ActionResponse as b, BridgeEvent as c, BridgeEventListener as d, BridgeEventType as e, BridgeSnapshot as f, CustomAction as g, ElementState as h, ElementType as i, ExtractConfig as j, LoopConfig as k, RegisteredElement as l, StateSnapshot as m, UIBridgeFeatures as n, UIState as o, UIStateGroup as p, UITransition as q, WSClientMessage as r, WSClientMessageType as s, WSConnectionState as t, WSDiscoverMessage as u, WSErrorMessage as v, WSEventMessage as w, WSExecuteActionMessage as x, WSExecuteComponentActionMessage as y, WSExecuteWorkflowMessage as z };
+export { type StateSnapshot as $, type AccessibilityIssue as A, type BranchCondition as B, type CapturedError as C, DEFAULT_CAPTURE_CONFIG as D, type ElementAccessibility as E, type ElementType as F, type ExtendedWorkflowStep as G, type ExtractConfig as H, type HmrCapturedEvent as I, type LongTaskCapturedEvent as J, type LoopConfig as K, type LogConfig as L, type MemoryCapturedEvent as M, type NavigationCapturedEvent as N, type NavigationResult as O, type NetworkCapturedEvent as P, type OnBrowserEventCallback as Q, type OnCaptureCallback as R, type PartialMatch as S, type PathResult as T, type ReactErrorCapturedEvent as U, type RecoveryAction as V, type RegisteredComponent as W, type RegisteredElement as X, type ResourceErrorCapturedEvent as Y, type StandardAction as Z, type StateGetter as _, type AccessibilityReport as a, type TransitionResult as a0, type UIBridgeConfig as a1, type UIBridgeFeatures as a2, type UIState as a3, type UIStateGroup as a4, type UITransition as a5, type WCAGLevel as a6, type WSClientConfig as a7, type WSClientMessage as a8, type WSClientMessageType as a9, type WorkflowStep as aA, type WorkflowStepType as aB, type WsDisconnectionCapturedEvent as aC, type WSConnectionState as aa, type WSDiscoverMessage as ab, type WSErrorMessage as ac, type WSEventMessage as ad, type WSExecuteActionMessage as ae, type WSExecuteComponentActionMessage as af, type WSExecuteWorkflowMessage as ag, type WSFindMessage as ah, type WSGetElementMessage as ai, type WSGetSnapshotMessage as aj, type WSMessageBase as ak, type WSPingMessage as al, type WSPongMessage as am, type WSResponseMessage as an, type WSServerMessage as ao, type WSServerMessageType as ap, type WSSubscribeMessage as aq, type WSSubscribedMessage as ar, type WSSubscriptionOptions as as, type WSUnsubscribeMessage as at, type WSUnsubscribedMessage as au, type WSWelcomeMessage as av, type WSWorkflowProgressMessage as aw, type WaitOptions as ax, type WebVitalCapturedEvent as ay, type Workflow as az, type AccessibilitySeverity as b, type ActionErrorCode as c, type ActionFailureDetails as d, type ActionHandler as e, type ActionRequest as f, type ActionResponse as g, type AnyCapturedEvent as h, type AriaCheckedState as i, type BridgeEvent as j, type BridgeEventListener as k, type BridgeEventType as l, type BridgeSnapshot as m, type BrowserCaptureConfig as n, type BrowserCapturedEvent as o, type BrowserEventType as p, type ComponentAction as q, type ComponentStateResponse as r, type ComputedProperty as s, type ConsoleCapturedEvent as t, type ContentMetadata as u, type ContentRole as v, type ContentType as w, type CustomAction as x, type ElementIdentifier as y, type ElementState as z };