@qontinui/ui-bridge 0.3.0 → 0.3.1

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

@@ -1,9 +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,
  * plus ui-bridge-specific types (WebSocket protocol, accessibility, extended workflow types).
  */
+
 /**
  * Element identification using multiple strategies
  */
@@ -64,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
  */
@@ -109,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 */
@@ -360,6 +520,8 @@ 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
@@ -431,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<{
@@ -499,6 +663,13 @@ 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;
+    };
 }
 /**
  * Computed property definition
@@ -1003,4 +1174,4 @@ interface AccessibilityReport {
     durationMs: number;
 }
 
-export type { WSGetElementMessage as $, AccessibilityIssue as A, BranchCondition as B, ComponentAction as C, UIBridgeFeatures as D, ElementAccessibility as E, UIState as F, UIStateGroup as G, UITransition as H, WSClientConfig as I, WSClientMessage as J, WSClientMessageType as K, LogConfig as L, WSConnectionState as M, NavigationResult as N, WSDiscoverMessage as O, PartialMatch as P, WSErrorMessage as Q, RecoveryAction as R, StandardAction as S, TransitionResult as T, UIBridgeConfig as U, WSEventMessage as V, WCAGLevel as W, WSExecuteActionMessage as X, WSExecuteComponentActionMessage as Y, WSExecuteWorkflowMessage as Z, WSFindMessage as _, AccessibilityReport as a, WSGetSnapshotMessage as a0, WSMessageBase as a1, WSPingMessage as a2, WSPongMessage as a3, WSResponseMessage as a4, WSServerMessage as a5, WSServerMessageType as a6, WSSubscribeMessage as a7, WSSubscribedMessage as a8, WSSubscriptionOptions as a9, WSUnsubscribeMessage as aa, WSUnsubscribedMessage as ab, WSWelcomeMessage as ac, WSWorkflowProgressMessage as ad, WaitOptions as ae, Workflow as af, WorkflowStep as ag, WorkflowStepType as ah, AccessibilitySeverity as b, ActionErrorCode as c, ActionFailureDetails as d, ActionHandler as e, ActionRequest as f, ActionResponse as g, AriaCheckedState as h, BridgeEvent as i, BridgeEventListener as j, BridgeEventType as k, BridgeSnapshot as l, ComponentStateResponse as m, ComputedProperty as n, CustomAction as o, ElementIdentifier as p, ElementState as q, ElementType as r, ExtendedWorkflowStep as s, ExtractConfig as t, LoopConfig as u, PathResult as v, RegisteredComponent as w, RegisteredElement as x, StateGetter as y, StateSnapshot 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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qontinui/ui-bridge",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "UI Bridge Framework - React hooks and providers for UI observation, control, and debugging",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -41,6 +41,21 @@
       "import": "./dist/ai/index.mjs",
       "require": "./dist/ai/index.js"
     },
+    "./annotations": {
+      "types": "./dist/annotations/index.d.ts",
+      "import": "./dist/annotations/index.mjs",
+      "require": "./dist/annotations/index.js"
+    },
+    "./specs": {
+      "types": "./dist/specs/index.d.ts",
+      "import": "./dist/specs/index.mjs",
+      "require": "./dist/specs/index.js"
+    },
+    "./discovery": {
+      "types": "./dist/discovery/index.d.ts",
+      "import": "./dist/discovery/index.mjs",
+      "require": "./dist/discovery/index.js"
+    },
     "./server": {
       "types": "./dist/server/index.d.ts",
       "import": "./dist/server/index.mjs",
@@ -104,7 +119,8 @@
       "types": "./dist/native/debug/index.d.ts",
       "import": "./dist/native/debug/index.mjs",
       "require": "./dist/native/debug/index.js"
-    }
+    },
+    "./swc-plugin-wasm/ui_bridge_swc_plugin.wasm": "./swc-plugin-wasm/ui_bridge_swc_plugin.wasm"
   },
   "files": [
     "dist",