@qontinui/ui-bridge 0.2.0 → 0.3.1

package/dist/types-B2EfvEaq.d.ts

@@ -0,0 +1,236 @@
+import { a1 as UIBridgeConfig, C as CapturedError, a3 as UIState, a4 as UIStateGroup, a5 as UITransition, a0 as TransitionResult, T as PathResult, O as NavigationResult, $ as StateSnapshot } from './types-suaYwWWg.js';
+import { d as ControlSnapshot, b as ControlActionRequest, c as ControlActionResponse, C as ComponentActionRequest, a as ComponentActionResponse, F as FindRequest, h as FindResponse, l as WorkflowRunRequest, m as WorkflowRunResponse, i as PageNavigationResponse, P as PageNavigateRequest } from './types-C7gVYRnF.js';
+import { a8 as SearchCriteria, a9 as SearchResponse, X as NLActionRequest, Y as NLActionResponse, d as AssertionRequest, e as AssertionResult, B as BatchAssertionRequest, g as BatchAssertionResult, af as SemanticSnapshot, ab as SemanticDiff, ac as SemanticSearchCriteria, ad as SemanticSearchResponse, M as IntentExecutionResult, O as IntentSearchResponse, L as Intent, a4 as RecoveryAttemptRequest, a5 as RecoveryAttemptResult, a0 as PageDataMap, a2 as PageRegionMap, ai as StructuredDataExtraction, i as ComponentInfo, m as CrossAppComparisonReport } from './types-CebMQj76.js';
+import { RenderLogEntryType, RenderLogEntry } from './render-log/index.js';
+import { E as ElementAnnotation, a as AnnotationConfig, b as AnnotationCoverage } from './types-UBtp7R0u.js';
+
+/**
+ * UI Bridge Server Types
+ *
+ * Shared types for server adapters.
+ */
+
+/**
+ * Server configuration
+ */
+interface UIBridgeServerConfig extends UIBridgeConfig {
+    /** Base path for API routes */
+    basePath?: string;
+    /** Enable CORS */
+    cors?: boolean | CORSOptions;
+    /** Authentication middleware */
+    authenticate?: (req: unknown) => boolean | Promise<boolean>;
+    /** Rate limiting */
+    rateLimit?: RateLimitOptions;
+}
+/**
+ * CORS options
+ */
+interface CORSOptions {
+    /** Allowed origins */
+    origin?: string | string[] | boolean;
+    /** Allowed methods */
+    methods?: string[];
+    /** Allowed headers */
+    headers?: string[];
+    /** Expose headers */
+    exposeHeaders?: string[];
+    /** Allow credentials */
+    credentials?: boolean;
+    /** Max age for preflight cache */
+    maxAge?: number;
+}
+/**
+ * Rate limit options
+ */
+interface RateLimitOptions {
+    /** Time window in milliseconds */
+    windowMs?: number;
+    /** Max requests per window */
+    max?: number;
+    /** Message when rate limited */
+    message?: string;
+}
+/**
+ * API response wrapper
+ */
+interface APIResponse<T = unknown> {
+    /** Whether the request succeeded */
+    success: boolean;
+    /** Response data */
+    data?: T;
+    /** Error message if failed */
+    error?: string;
+    /** Error code */
+    code?: string;
+    /** Request timestamp */
+    timestamp: number;
+}
+/**
+ * Render log query parameters
+ */
+interface RenderLogQuery {
+    /** Filter by entry type */
+    type?: RenderLogEntryType;
+    /** Filter entries since timestamp */
+    since?: number;
+    /** Filter entries until timestamp */
+    until?: number;
+    /** Limit number of results */
+    limit?: number;
+}
+/**
+ * Server handler interface
+ *
+ * Implementations provide these handlers for different frameworks.
+ */
+interface UIBridgeServerHandlers {
+    getRenderLog: (query?: RenderLogQuery) => Promise<APIResponse<RenderLogEntry[]>>;
+    clearRenderLog: () => Promise<APIResponse<void>>;
+    captureSnapshot: () => Promise<APIResponse<unknown>>;
+    getRenderLogPath: () => Promise<APIResponse<{
+        path: string;
+    }>>;
+    getElements: () => Promise<APIResponse<ControlSnapshot['elements']>>;
+    getElement: (id: string) => Promise<APIResponse<ControlSnapshot['elements'][0]>>;
+    getElementState: (id: string) => Promise<APIResponse<unknown>>;
+    executeElementAction: (id: string, request: ControlActionRequest) => Promise<APIResponse<ControlActionResponse>>;
+    getComponents: () => Promise<APIResponse<ControlSnapshot['components']>>;
+    getComponent: (id: string) => Promise<APIResponse<ControlSnapshot['components'][0]>>;
+    getComponentState: (id: string) => Promise<APIResponse<{
+        state: Record<string, unknown>;
+        computed: Record<string, unknown>;
+        timestamp: number;
+    }>>;
+    executeComponentAction: (id: string, request: ComponentActionRequest) => Promise<APIResponse<ComponentActionResponse>>;
+    find: (request?: FindRequest) => Promise<APIResponse<FindResponse>>;
+    /**
+     * @deprecated Use find() instead
+     */
+    discover: (request?: FindRequest) => Promise<APIResponse<FindResponse>>;
+    getControlSnapshot: () => Promise<APIResponse<ControlSnapshot>>;
+    getWorkflows: () => Promise<APIResponse<ControlSnapshot['workflows']>>;
+    runWorkflow: (id: string, request?: WorkflowRunRequest) => Promise<APIResponse<WorkflowRunResponse>>;
+    getWorkflowStatus: (runId: string) => Promise<APIResponse<WorkflowRunResponse>>;
+    getActionHistory: (limit?: number) => Promise<APIResponse<unknown[]>>;
+    getMetrics: () => Promise<APIResponse<unknown>>;
+    highlightElement: (id: string) => Promise<APIResponse<void>>;
+    getElementTree: () => Promise<APIResponse<unknown>>;
+    getConsoleErrors: (params?: {
+        since?: number;
+        limit?: number;
+    }) => Promise<APIResponse<{
+        errors: CapturedError[];
+        count: number;
+    }>>;
+    clearConsoleErrors: () => Promise<APIResponse<{
+        cleared: boolean;
+    }>>;
+    aiSearch: (criteria: SearchCriteria) => Promise<APIResponse<SearchResponse>>;
+    aiExecute: (request: NLActionRequest) => Promise<APIResponse<NLActionResponse>>;
+    aiAssert: (request: AssertionRequest) => Promise<APIResponse<AssertionResult>>;
+    aiAssertBatch: (request: BatchAssertionRequest) => Promise<APIResponse<BatchAssertionResult>>;
+    getSemanticSnapshot: () => Promise<APIResponse<SemanticSnapshot>>;
+    getSemanticDiff: (since?: number) => Promise<APIResponse<SemanticDiff | null>>;
+    getPageSummary: () => Promise<APIResponse<string>>;
+    aiSemanticSearch: (criteria: SemanticSearchCriteria) => Promise<APIResponse<SemanticSearchResponse>>;
+    getStates: () => Promise<APIResponse<UIState[]>>;
+    getState: (id: string) => Promise<APIResponse<UIState>>;
+    getActiveStates: () => Promise<APIResponse<UIState[]>>;
+    activateState: (id: string) => Promise<APIResponse<void>>;
+    deactivateState: (id: string) => Promise<APIResponse<void>>;
+    getStateGroups: () => Promise<APIResponse<UIStateGroup[]>>;
+    activateStateGroup: (id: string) => Promise<APIResponse<void>>;
+    deactivateStateGroup: (id: string) => Promise<APIResponse<void>>;
+    getTransitions: () => Promise<APIResponse<UITransition[]>>;
+    canExecuteTransition: (id: string) => Promise<APIResponse<{
+        canExecute: boolean;
+        reason?: string;
+    }>>;
+    executeTransition: (id: string) => Promise<APIResponse<TransitionResult>>;
+    findPath: (request: {
+        targetStates: string[];
+    }) => Promise<APIResponse<PathResult>>;
+    navigateTo: (request: {
+        targetStates: string[];
+    }) => Promise<APIResponse<NavigationResult>>;
+    getStateSnapshot: () => Promise<APIResponse<StateSnapshot>>;
+    executeIntent: (request: {
+        intentId: string;
+        params?: Record<string, unknown>;
+    }) => Promise<APIResponse<IntentExecutionResult>>;
+    findIntent: (request: {
+        query: string;
+    }) => Promise<APIResponse<IntentSearchResponse>>;
+    listIntents: () => Promise<APIResponse<Intent[]>>;
+    registerIntent: (intent: Intent) => Promise<APIResponse<Intent>>;
+    executeIntentFromQuery: (request: {
+        query: string;
+        params?: Record<string, unknown>;
+    }) => Promise<APIResponse<IntentExecutionResult>>;
+    attemptRecovery: (request: RecoveryAttemptRequest) => Promise<APIResponse<RecoveryAttemptResult>>;
+    analyzePageData: () => Promise<APIResponse<PageDataMap>>;
+    analyzePageRegions: () => Promise<APIResponse<PageRegionMap>>;
+    analyzeStructuredData: () => Promise<APIResponse<StructuredDataExtraction>>;
+    crossAppCompare: (request: {
+        sourceSnapshot: SemanticSnapshot;
+        targetSnapshot: SemanticSnapshot;
+        sourceComponents?: ComponentInfo[];
+        targetComponents?: ComponentInfo[];
+    }) => Promise<APIResponse<CrossAppComparisonReport>>;
+    pageRefresh: () => Promise<APIResponse<PageNavigationResponse>>;
+    pageNavigate: (request: PageNavigateRequest) => Promise<APIResponse<PageNavigationResponse>>;
+    pageGoBack: () => Promise<APIResponse<PageNavigationResponse>>;
+    pageGoForward: () => Promise<APIResponse<PageNavigationResponse>>;
+    getAnnotations: () => Promise<APIResponse<Record<string, ElementAnnotation>>>;
+    getAnnotation: (id: string) => Promise<APIResponse<ElementAnnotation>>;
+    setAnnotation: (id: string, annotation: ElementAnnotation) => Promise<APIResponse<ElementAnnotation>>;
+    deleteAnnotation: (id: string) => Promise<APIResponse<void>>;
+    importAnnotations: (config: AnnotationConfig) => Promise<APIResponse<{
+        count: number;
+    }>>;
+    exportAnnotations: () => Promise<APIResponse<AnnotationConfig>>;
+    getAnnotationCoverage: () => Promise<APIResponse<AnnotationCoverage>>;
+    getPerformanceEntries: () => Promise<APIResponse<unknown>>;
+    clearPerformanceEntries: () => Promise<APIResponse<{
+        cleared: boolean;
+    }>>;
+    getBrowserEvents: (params?: {
+        type?: string;
+        since?: number;
+        limit?: number;
+    }) => Promise<APIResponse<{
+        events: unknown[];
+        count: number;
+    }>>;
+}
+/**
+ * Route definition
+ */
+interface RouteDefinition {
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    path: string;
+    handler: string;
+    params?: string[];
+    bodyRequired?: boolean;
+}
+/**
+ * All UI Bridge routes
+ */
+declare const UI_BRIDGE_ROUTES: RouteDefinition[];
+/**
+ * WebSocket message types
+ */
+type WebSocketMessageType = 'subscribe' | 'unsubscribe' | 'event' | 'snapshot' | 'action' | 'error';
+/**
+ * WebSocket message
+ */
+interface WebSocketMessage<T = unknown> {
+    type: WebSocketMessageType;
+    channel?: string;
+    data?: T;
+    error?: string;
+    timestamp: number;
+}
+
+export { type APIResponse as A, type CORSOptions as C, type RateLimitOptions as R, type UIBridgeServerConfig as U, type WebSocketMessage as W, type RenderLogQuery as a, type RouteDefinition as b, type UIBridgeServerHandlers as c, UI_BRIDGE_ROUTES as d, type WebSocketMessageType as e };

package/dist/{types-Dr6tH-bm.d.mts → types-C7gVYRnF.d.ts}

@@ -1,4 +1,4 @@
-import { h as ElementState, a as ActionRequest, b as ActionResponse, a0 as WaitOptions } from './types-CPMbN_Iw.mjs';
+import { z as ElementState, u as ContentMetadata, f as ActionRequest, g as ActionResponse, ax as WaitOptions } from './types-suaYwWWg.js';
 
 /**
  * Control Module Types
@@ -153,6 +153,10 @@ interface DiscoveredElement {
     state: ElementState;
     /** Whether registered with UI Bridge */
     registered: boolean;
+    /** Whether this is an interactive element or static content */
+    category?: 'interactive' | 'content';
+    /** Metadata for content elements */
+    contentMetadata?: ContentMetadata;
 }
 /**
  * Find request options
@@ -172,6 +176,12 @@ interface FindRequest {
     types?: string[];
     /** Filter by selector */
     selector?: string;
+    /** Include content (non-interactive) elements in results */
+    includeContent?: boolean;
+    /** Only return content elements */
+    contentOnly?: boolean;
+    /** Filter by content role */
+    contentRole?: string;
 }
 /**
  * Find response
@@ -209,6 +219,8 @@ interface ControlSnapshot {
         label?: string;
         actions: string[];
         state: ElementState;
+        category?: 'interactive' | 'content';
+        contentMetadata?: ContentMetadata;
     }>;
     /** All registered components */
     components: Array<{
@@ -247,6 +259,46 @@ interface KeyboardAction {
     /** Hold duration for key press */
     holdDuration?: number;
 }
+/**
+ * Drag action parameters
+ *
+ * Drags the source element to a target element or position by dispatching
+ * a sequence of mouse events: mousedown → mousemove × N → mouseup.
+ * Optionally dispatches HTML5 drag events (dragstart, dragover, drop, dragend)
+ * for applications that listen to those instead of mouse events.
+ */
+interface DragAction {
+    /** Target element to drag to (resolved via registry or DOM query) */
+    target?: {
+        /** UI Bridge element ID (checked in registry first) */
+        elementId?: string;
+        /** CSS selector */
+        selector?: string;
+    };
+    /** Target coordinates (absolute client position, alternative to target element) */
+    targetPosition?: {
+        x: number;
+        y: number;
+    };
+    /** Source offset from element center in pixels (default: element center) */
+    sourceOffset?: {
+        x: number;
+        y: number;
+    };
+    /** Target offset from target element center in pixels (default: element center) */
+    targetOffset?: {
+        x: number;
+        y: number;
+    };
+    /** Number of intermediate mousemove steps (default: 10) */
+    steps?: number;
+    /** Delay in ms between mousedown and first move (default: 100) */
+    holdDelay?: number;
+    /** Delay in ms after mouseup (default: 50) */
+    releaseDelay?: number;
+    /** Also dispatch HTML5 drag events (dragstart/dragover/drop/dragend) alongside mouse events (default: false) */
+    html5?: boolean;
+}
 /**
  * Action types for mouse input
  */
@@ -318,6 +370,24 @@ interface WaitResult {
     /** Error if timed out */
     error?: string;
 }
+/**
+ * Page navigation request
+ */
+interface PageNavigateRequest {
+    /** URL to navigate to */
+    url: string;
+}
+/**
+ * Page navigation response
+ */
+interface PageNavigationResponse {
+    /** Whether the navigation succeeded */
+    success: boolean;
+    /** Current URL after navigation */
+    url?: string;
+    /** Timestamp */
+    timestamp: number;
+}
 /**
  * Action executor interface
  */
@@ -351,4 +421,4 @@ interface WorkflowEngine {
     listActiveRuns(): Promise<WorkflowRunResponse[]>;
 }
 
-export type { ActionExecutor as A, ComponentActionRequest as C, DiscoveredElement as D, FindRequest as F, KeyboardAction as K, MouseAction as M, ScrollAction as S, TypeAction as T, WaitResult as W, ComponentActionResponse as a, ControlActionRequest as b, ControlActionResponse as c, ControlSnapshot as d, DiscoveryRequest as e, DiscoveryResponse as f, FindResponse as g, SelectAction as h, WorkflowEngine as i, WorkflowRunRequest as j, WorkflowRunResponse as k, WorkflowRunStatus as l, WorkflowStepResult as m };
+export type { ActionExecutor as A, ComponentActionRequest as C, DiscoveredElement as D, FindRequest as F, KeyboardAction as K, MouseAction as M, PageNavigateRequest as P, ScrollAction as S, TypeAction as T, WaitResult as W, ComponentActionResponse as a, ControlActionRequest as b, ControlActionResponse as c, ControlSnapshot as d, DiscoveryRequest as e, DiscoveryResponse as f, DragAction as g, FindResponse as h, PageNavigationResponse as i, SelectAction as j, WorkflowEngine as k, WorkflowRunRequest as l, WorkflowRunResponse as m, WorkflowRunStatus as n, WorkflowStepResult as o };

package/dist/{types-oCTrRxSw.d.ts → types-CJGrBEhC.d.mts}

@@ -1,4 +1,4 @@
-import { h as ElementState, a as ActionRequest, b as ActionResponse, a0 as WaitOptions } from './types-CPMbN_Iw.js';
+import { z as ElementState, u as ContentMetadata, f as ActionRequest, g as ActionResponse, ax as WaitOptions } from './types-suaYwWWg.mjs';
 
 /**
  * Control Module Types
@@ -153,6 +153,10 @@ interface DiscoveredElement {
     state: ElementState;
     /** Whether registered with UI Bridge */
     registered: boolean;
+    /** Whether this is an interactive element or static content */
+    category?: 'interactive' | 'content';
+    /** Metadata for content elements */
+    contentMetadata?: ContentMetadata;
 }
 /**
  * Find request options
@@ -172,6 +176,12 @@ interface FindRequest {
     types?: string[];
     /** Filter by selector */
     selector?: string;
+    /** Include content (non-interactive) elements in results */
+    includeContent?: boolean;
+    /** Only return content elements */
+    contentOnly?: boolean;
+    /** Filter by content role */
+    contentRole?: string;
 }
 /**
  * Find response
@@ -209,6 +219,8 @@ interface ControlSnapshot {
         label?: string;
         actions: string[];
         state: ElementState;
+        category?: 'interactive' | 'content';
+        contentMetadata?: ContentMetadata;
     }>;
     /** All registered components */
     components: Array<{
@@ -247,6 +259,46 @@ interface KeyboardAction {
     /** Hold duration for key press */
     holdDuration?: number;
 }
+/**
+ * Drag action parameters
+ *
+ * Drags the source element to a target element or position by dispatching
+ * a sequence of mouse events: mousedown → mousemove × N → mouseup.
+ * Optionally dispatches HTML5 drag events (dragstart, dragover, drop, dragend)
+ * for applications that listen to those instead of mouse events.
+ */
+interface DragAction {
+    /** Target element to drag to (resolved via registry or DOM query) */
+    target?: {
+        /** UI Bridge element ID (checked in registry first) */
+        elementId?: string;
+        /** CSS selector */
+        selector?: string;
+    };
+    /** Target coordinates (absolute client position, alternative to target element) */
+    targetPosition?: {
+        x: number;
+        y: number;
+    };
+    /** Source offset from element center in pixels (default: element center) */
+    sourceOffset?: {
+        x: number;
+        y: number;
+    };
+    /** Target offset from target element center in pixels (default: element center) */
+    targetOffset?: {
+        x: number;
+        y: number;
+    };
+    /** Number of intermediate mousemove steps (default: 10) */
+    steps?: number;
+    /** Delay in ms between mousedown and first move (default: 100) */
+    holdDelay?: number;
+    /** Delay in ms after mouseup (default: 50) */
+    releaseDelay?: number;
+    /** Also dispatch HTML5 drag events (dragstart/dragover/drop/dragend) alongside mouse events (default: false) */
+    html5?: boolean;
+}
 /**
  * Action types for mouse input
  */
@@ -318,6 +370,24 @@ interface WaitResult {
     /** Error if timed out */
     error?: string;
 }
+/**
+ * Page navigation request
+ */
+interface PageNavigateRequest {
+    /** URL to navigate to */
+    url: string;
+}
+/**
+ * Page navigation response
+ */
+interface PageNavigationResponse {
+    /** Whether the navigation succeeded */
+    success: boolean;
+    /** Current URL after navigation */
+    url?: string;
+    /** Timestamp */
+    timestamp: number;
+}
 /**
  * Action executor interface
  */
@@ -351,4 +421,4 @@ interface WorkflowEngine {
     listActiveRuns(): Promise<WorkflowRunResponse[]>;
 }
 
-export type { ActionExecutor as A, ComponentActionRequest as C, DiscoveredElement as D, FindRequest as F, KeyboardAction as K, MouseAction as M, ScrollAction as S, TypeAction as T, WaitResult as W, ComponentActionResponse as a, ControlActionRequest as b, ControlActionResponse as c, ControlSnapshot as d, DiscoveryRequest as e, DiscoveryResponse as f, FindResponse as g, SelectAction as h, WorkflowEngine as i, WorkflowRunRequest as j, WorkflowRunResponse as k, WorkflowRunStatus as l, WorkflowStepResult as m };
+export type { ActionExecutor as A, ComponentActionRequest as C, DiscoveredElement as D, FindRequest as F, KeyboardAction as K, MouseAction as M, PageNavigateRequest as P, ScrollAction as S, TypeAction as T, WaitResult as W, ComponentActionResponse as a, ControlActionRequest as b, ControlActionResponse as c, ControlSnapshot as d, DiscoveryRequest as e, DiscoveryResponse as f, DragAction as g, FindResponse as h, PageNavigationResponse as i, SelectAction as j, WorkflowEngine as k, WorkflowRunRequest as l, WorkflowRunResponse as m, WorkflowRunStatus as n, WorkflowStepResult as o };