@qontinui/ui-bridge 0.1.1 → 0.3.0

package/dist/core/index.d.mts

@@ -1,52 +1,125 @@
-import { E as ElementIdentifier } from '../types-BpvpStn3.mjs';
-export { A as ActionHandler, a as ActionRequest, b as ActionResponse, B as BranchCondition, c as BridgeEvent, d as BridgeEventListener, e as BridgeEventType, f as BridgeSnapshot, C as ComponentAction, g as CustomAction, h as ElementState, i as ElementType, j as ExtractConfig, L as LogConfig, k as LoopConfig, N as NavigationResult, P as PathResult, R as RegisteredComponent, l as RegisteredElement, S as StandardAction, m as StateSnapshot, T as TransitionResult, U as UIBridgeConfig, n as UIBridgeFeatures, o as UIState, p as UIStateGroup, q as UITransition, W as WSClientConfig, r as WSClientMessage, s as WSClientMessageType, t as WSConnectionState, u as WSDiscoverMessage, v as WSErrorMessage, w as WSEventMessage, x as WSExecuteActionMessage, y as WSExecuteComponentActionMessage, z as WSExecuteWorkflowMessage, D as WSFindMessage, F as WSGetElementMessage, G as WSGetSnapshotMessage, H as WSMessageBase, I as WSPingMessage, J as WSPongMessage, K as WSResponseMessage, M as WSServerMessage, O as WSServerMessageType, Q as WSSubscribeMessage, V as WSSubscribedMessage, X as WSSubscriptionOptions, Y as WSUnsubscribeMessage, Z as WSUnsubscribedMessage, _ as WSWelcomeMessage, $ as WSWorkflowProgressMessage, a0 as WaitOptions, a1 as Workflow, a2 as WorkflowStep, a3 as WorkflowStepType } from '../types-BpvpStn3.mjs';
-export { R as RegistryOptions, U as UIBridgeRegistry, g as getGlobalRegistry, r as resetGlobalRegistry, s as setGlobalRegistry } from '../registry-CT6BVVKr.mjs';
-export { U as UIBridgeWSClient, c as createWSClient } from '../websocket-client-B2LC9CYc.mjs';
+import { I as WSClientConfig, M as WSConnectionState, a9 as WSSubscriptionOptions, k as BridgeEventType, l as BridgeSnapshot, f as ActionRequest, g as ActionResponse, i as BridgeEvent } from '../types-jKVgTI6_.mjs';
+export { A as AccessibilityIssue, a as AccessibilityReport, b as AccessibilitySeverity, c as ActionErrorCode, d as ActionFailureDetails, e as ActionHandler, h as AriaCheckedState, B as BranchCondition, j as BridgeEventListener, C as ComponentAction, m as ComponentStateResponse, n as ComputedProperty, o as CustomAction, E as ElementAccessibility, p as ElementIdentifier, q as ElementState, r as ElementType, s as ExtendedWorkflowStep, t as ExtractConfig, L as LogConfig, u as LoopConfig, N as NavigationResult, P as PartialMatch, v as PathResult, R as RecoveryAction, w as RegisteredComponent, x as RegisteredElement, S as StandardAction, y as StateGetter, z as StateSnapshot, T as TransitionResult, U as UIBridgeConfig, D as UIBridgeFeatures, F as UIState, G as UIStateGroup, H as UITransition, W as WCAGLevel, J as WSClientMessage, K as WSClientMessageType, O as WSDiscoverMessage, Q as WSErrorMessage, V as WSEventMessage, X as WSExecuteActionMessage, Y as WSExecuteComponentActionMessage, Z as WSExecuteWorkflowMessage, _ as WSFindMessage, $ as WSGetElementMessage, a0 as WSGetSnapshotMessage, a1 as WSMessageBase, a2 as WSPingMessage, a3 as WSPongMessage, a4 as WSResponseMessage, a5 as WSServerMessage, a6 as WSServerMessageType, a7 as WSSubscribeMessage, a8 as WSSubscribedMessage, aa as WSUnsubscribeMessage, ab as WSUnsubscribedMessage, ac as WSWelcomeMessage, ad as WSWorkflowProgressMessage, ae as WaitOptions, af as Workflow, ag as WorkflowStep, ah as WorkflowStepType } from '../types-jKVgTI6_.mjs';
 
 /**
- * Element Identification Module
+ * WebSocket Client for UI Bridge
  *
- * Provides utilities for identifying DOM elements using multiple strategies:
- * 1. data-ui-id (explicit UI Bridge identifier - preferred)
- * 2. data-testid (testing library convention)
- * 3. data-awas-element (legacy support)
- * 4. id (HTML id attribute)
- * 5. Generated XPath/CSS selector (fallback)
+ * Provides real-time communication with UI Bridge server.
  */
 
 /**
- * Data attributes used for element identification (in priority order)
+ * WebSocket client for UI Bridge
  */
-declare const ID_ATTRIBUTES: readonly ["data-ui-id", "data-testid", "data-awas-element", "id"];
+declare class UIBridgeWSClient {
+    private ws;
+    private config;
+    private state;
+    private clientId;
+    private reconnectAttempts;
+    private reconnectTimer;
+    private pingTimer;
+    private pendingRequests;
+    private connectionListeners;
+    private eventListeners;
+    private errorListeners;
+    private subscriptions;
+    constructor(config: WSClientConfig);
+    /**
+     * Get current connection state
+     */
+    get connectionState(): WSConnectionState;
+    /**
+     * Get assigned client ID
+     */
+    get id(): string | null;
+    /**
+     * Connect to the WebSocket server
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the server
+     */
+    disconnect(): void;
+    /**
+     * Subscribe to events
+     */
+    subscribe(options: WSSubscriptionOptions): Promise<BridgeEventType[]>;
+    /**
+     * Unsubscribe from events
+     */
+    unsubscribe(events?: BridgeEventType[]): Promise<BridgeEventType[]>;
+    /**
+     * Find elements
+     */
+    find(options?: {
+        interactiveOnly?: boolean;
+        includeState?: boolean;
+        selector?: string;
+    }): Promise<BridgeSnapshot['elements']>;
+    /**
+     * Discover elements
+     * @deprecated Use find() instead
+     */
+    discover(options?: {
+        interactiveOnly?: boolean;
+        includeState?: boolean;
+        selector?: string;
+    }): Promise<BridgeSnapshot['elements']>;
+    /**
+     * Get element details
+     */
+    getElement(elementId: string, includeState?: boolean): Promise<BridgeSnapshot['elements'][0] | null>;
+    /**
+     * Get full snapshot
+     */
+    getSnapshot(): Promise<BridgeSnapshot>;
+    /**
+     * Execute action on an element
+     */
+    executeAction(elementId: string, action: ActionRequest): Promise<ActionResponse>;
+    /**
+     * Execute component action
+     */
+    executeComponentAction(componentId: string, action: string, params?: Record<string, unknown>): Promise<ActionResponse>;
+    /**
+     * Execute workflow with optional progress streaming
+     */
+    executeWorkflow(workflowId: string, params?: Record<string, unknown>, onProgress?: (progress: {
+        currentStep: number;
+        totalSteps: number;
+        step: {
+            id: string;
+            status: string;
+        };
+    }) => void): Promise<{
+        success: boolean;
+        results: unknown[];
+    }>;
+    /**
+     * Add connection state listener
+     */
+    onConnectionChange(listener: (state: WSConnectionState) => void): () => void;
+    /**
+     * Add event listener
+     */
+    onEvent(eventType: BridgeEventType | '*', listener: (event: BridgeEvent) => void): () => void;
+    /**
+     * Add error listener
+     */
+    onError(listener: (error: Error) => void): () => void;
+    private setState;
+    private handleMessage;
+    private handleResponse;
+    private notifyEvent;
+    private notifyError;
+    private sendRequest;
+    private scheduleReconnect;
+    private startPingInterval;
+    private stopPingInterval;
+}
 /**
- * Generate a unique XPath for an element
+ * Create a WebSocket client instance
  */
-declare function generateXPath(element: HTMLElement): string;
-/**
- * Generate a unique CSS selector for an element
- */
-declare function generateCSSSelector(element: HTMLElement): string;
-/**
- * Get the best identifier for an element based on available attributes
- */
-declare function getBestIdentifier(element: HTMLElement): string;
-/**
- * Create a full ElementIdentifier object for an element
- */
-declare function createElementIdentifier(element: HTMLElement): ElementIdentifier;
-/**
- * Find an element by its identifier
- *
- * Tries each identification method in priority order
- */
-declare function findElementByIdentifier(identifier: string | ElementIdentifier, root?: ParentNode): HTMLElement | null;
-/**
- * Find all elements matching an identifier pattern
- */
-declare function findAllElementsByIdentifier(pattern: string, root?: ParentNode): HTMLElement[];
-/**
- * Check if an element matches an identifier
- */
-declare function elementMatchesIdentifier(element: HTMLElement, identifier: string | ElementIdentifier): boolean;
+declare function createWSClient(config: WSClientConfig): UIBridgeWSClient;
 
-export { ElementIdentifier, ID_ATTRIBUTES, createElementIdentifier, elementMatchesIdentifier, findAllElementsByIdentifier, findElementByIdentifier, generateCSSSelector, generateXPath, getBestIdentifier };
+export { ActionRequest, ActionResponse, BridgeEvent, BridgeEventType, BridgeSnapshot, UIBridgeWSClient, WSClientConfig, WSConnectionState, WSSubscriptionOptions, createWSClient };

package/dist/core/index.d.ts

@@ -1,52 +1,125 @@
-import { E as ElementIdentifier } from '../types-BpvpStn3.js';
-export { A as ActionHandler, a as ActionRequest, b as ActionResponse, B as BranchCondition, c as BridgeEvent, d as BridgeEventListener, e as BridgeEventType, f as BridgeSnapshot, C as ComponentAction, g as CustomAction, h as ElementState, i as ElementType, j as ExtractConfig, L as LogConfig, k as LoopConfig, N as NavigationResult, P as PathResult, R as RegisteredComponent, l as RegisteredElement, S as StandardAction, m as StateSnapshot, T as TransitionResult, U as UIBridgeConfig, n as UIBridgeFeatures, o as UIState, p as UIStateGroup, q as UITransition, W as WSClientConfig, r as WSClientMessage, s as WSClientMessageType, t as WSConnectionState, u as WSDiscoverMessage, v as WSErrorMessage, w as WSEventMessage, x as WSExecuteActionMessage, y as WSExecuteComponentActionMessage, z as WSExecuteWorkflowMessage, D as WSFindMessage, F as WSGetElementMessage, G as WSGetSnapshotMessage, H as WSMessageBase, I as WSPingMessage, J as WSPongMessage, K as WSResponseMessage, M as WSServerMessage, O as WSServerMessageType, Q as WSSubscribeMessage, V as WSSubscribedMessage, X as WSSubscriptionOptions, Y as WSUnsubscribeMessage, Z as WSUnsubscribedMessage, _ as WSWelcomeMessage, $ as WSWorkflowProgressMessage, a0 as WaitOptions, a1 as Workflow, a2 as WorkflowStep, a3 as WorkflowStepType } from '../types-BpvpStn3.js';
-export { R as RegistryOptions, U as UIBridgeRegistry, g as getGlobalRegistry, r as resetGlobalRegistry, s as setGlobalRegistry } from '../registry-D4mQ01B3.js';
-export { U as UIBridgeWSClient, c as createWSClient } from '../websocket-client-DupH0X7B.js';
+import { I as WSClientConfig, M as WSConnectionState, a9 as WSSubscriptionOptions, k as BridgeEventType, l as BridgeSnapshot, f as ActionRequest, g as ActionResponse, i as BridgeEvent } from '../types-jKVgTI6_.js';
+export { A as AccessibilityIssue, a as AccessibilityReport, b as AccessibilitySeverity, c as ActionErrorCode, d as ActionFailureDetails, e as ActionHandler, h as AriaCheckedState, B as BranchCondition, j as BridgeEventListener, C as ComponentAction, m as ComponentStateResponse, n as ComputedProperty, o as CustomAction, E as ElementAccessibility, p as ElementIdentifier, q as ElementState, r as ElementType, s as ExtendedWorkflowStep, t as ExtractConfig, L as LogConfig, u as LoopConfig, N as NavigationResult, P as PartialMatch, v as PathResult, R as RecoveryAction, w as RegisteredComponent, x as RegisteredElement, S as StandardAction, y as StateGetter, z as StateSnapshot, T as TransitionResult, U as UIBridgeConfig, D as UIBridgeFeatures, F as UIState, G as UIStateGroup, H as UITransition, W as WCAGLevel, J as WSClientMessage, K as WSClientMessageType, O as WSDiscoverMessage, Q as WSErrorMessage, V as WSEventMessage, X as WSExecuteActionMessage, Y as WSExecuteComponentActionMessage, Z as WSExecuteWorkflowMessage, _ as WSFindMessage, $ as WSGetElementMessage, a0 as WSGetSnapshotMessage, a1 as WSMessageBase, a2 as WSPingMessage, a3 as WSPongMessage, a4 as WSResponseMessage, a5 as WSServerMessage, a6 as WSServerMessageType, a7 as WSSubscribeMessage, a8 as WSSubscribedMessage, aa as WSUnsubscribeMessage, ab as WSUnsubscribedMessage, ac as WSWelcomeMessage, ad as WSWorkflowProgressMessage, ae as WaitOptions, af as Workflow, ag as WorkflowStep, ah as WorkflowStepType } from '../types-jKVgTI6_.js';
 
 /**
- * Element Identification Module
+ * WebSocket Client for UI Bridge
  *
- * Provides utilities for identifying DOM elements using multiple strategies:
- * 1. data-ui-id (explicit UI Bridge identifier - preferred)
- * 2. data-testid (testing library convention)
- * 3. data-awas-element (legacy support)
- * 4. id (HTML id attribute)
- * 5. Generated XPath/CSS selector (fallback)
+ * Provides real-time communication with UI Bridge server.
  */
 
 /**
- * Data attributes used for element identification (in priority order)
+ * WebSocket client for UI Bridge
  */
-declare const ID_ATTRIBUTES: readonly ["data-ui-id", "data-testid", "data-awas-element", "id"];
+declare class UIBridgeWSClient {
+    private ws;
+    private config;
+    private state;
+    private clientId;
+    private reconnectAttempts;
+    private reconnectTimer;
+    private pingTimer;
+    private pendingRequests;
+    private connectionListeners;
+    private eventListeners;
+    private errorListeners;
+    private subscriptions;
+    constructor(config: WSClientConfig);
+    /**
+     * Get current connection state
+     */
+    get connectionState(): WSConnectionState;
+    /**
+     * Get assigned client ID
+     */
+    get id(): string | null;
+    /**
+     * Connect to the WebSocket server
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the server
+     */
+    disconnect(): void;
+    /**
+     * Subscribe to events
+     */
+    subscribe(options: WSSubscriptionOptions): Promise<BridgeEventType[]>;
+    /**
+     * Unsubscribe from events
+     */
+    unsubscribe(events?: BridgeEventType[]): Promise<BridgeEventType[]>;
+    /**
+     * Find elements
+     */
+    find(options?: {
+        interactiveOnly?: boolean;
+        includeState?: boolean;
+        selector?: string;
+    }): Promise<BridgeSnapshot['elements']>;
+    /**
+     * Discover elements
+     * @deprecated Use find() instead
+     */
+    discover(options?: {
+        interactiveOnly?: boolean;
+        includeState?: boolean;
+        selector?: string;
+    }): Promise<BridgeSnapshot['elements']>;
+    /**
+     * Get element details
+     */
+    getElement(elementId: string, includeState?: boolean): Promise<BridgeSnapshot['elements'][0] | null>;
+    /**
+     * Get full snapshot
+     */
+    getSnapshot(): Promise<BridgeSnapshot>;
+    /**
+     * Execute action on an element
+     */
+    executeAction(elementId: string, action: ActionRequest): Promise<ActionResponse>;
+    /**
+     * Execute component action
+     */
+    executeComponentAction(componentId: string, action: string, params?: Record<string, unknown>): Promise<ActionResponse>;
+    /**
+     * Execute workflow with optional progress streaming
+     */
+    executeWorkflow(workflowId: string, params?: Record<string, unknown>, onProgress?: (progress: {
+        currentStep: number;
+        totalSteps: number;
+        step: {
+            id: string;
+            status: string;
+        };
+    }) => void): Promise<{
+        success: boolean;
+        results: unknown[];
+    }>;
+    /**
+     * Add connection state listener
+     */
+    onConnectionChange(listener: (state: WSConnectionState) => void): () => void;
+    /**
+     * Add event listener
+     */
+    onEvent(eventType: BridgeEventType | '*', listener: (event: BridgeEvent) => void): () => void;
+    /**
+     * Add error listener
+     */
+    onError(listener: (error: Error) => void): () => void;
+    private setState;
+    private handleMessage;
+    private handleResponse;
+    private notifyEvent;
+    private notifyError;
+    private sendRequest;
+    private scheduleReconnect;
+    private startPingInterval;
+    private stopPingInterval;
+}
 /**
- * Generate a unique XPath for an element
+ * Create a WebSocket client instance
  */
-declare function generateXPath(element: HTMLElement): string;
-/**
- * Generate a unique CSS selector for an element
- */
-declare function generateCSSSelector(element: HTMLElement): string;
-/**
- * Get the best identifier for an element based on available attributes
- */
-declare function getBestIdentifier(element: HTMLElement): string;
-/**
- * Create a full ElementIdentifier object for an element
- */
-declare function createElementIdentifier(element: HTMLElement): ElementIdentifier;
-/**
- * Find an element by its identifier
- *
- * Tries each identification method in priority order
- */
-declare function findElementByIdentifier(identifier: string | ElementIdentifier, root?: ParentNode): HTMLElement | null;
-/**
- * Find all elements matching an identifier pattern
- */
-declare function findAllElementsByIdentifier(pattern: string, root?: ParentNode): HTMLElement[];
-/**
- * Check if an element matches an identifier
- */
-declare function elementMatchesIdentifier(element: HTMLElement, identifier: string | ElementIdentifier): boolean;
+declare function createWSClient(config: WSClientConfig): UIBridgeWSClient;
 
-export { ElementIdentifier, ID_ATTRIBUTES, createElementIdentifier, elementMatchesIdentifier, findAllElementsByIdentifier, findElementByIdentifier, generateCSSSelector, generateXPath, getBestIdentifier };
+export { ActionRequest, ActionResponse, BridgeEvent, BridgeEventType, BridgeSnapshot, UIBridgeWSClient, WSClientConfig, WSConnectionState, WSSubscriptionOptions, createWSClient };