@qontinui/ui-bridge 0.2.0 → 0.3.1

package/dist/browser-capture-CsTU29mb.d.ts

@@ -0,0 +1,47 @@
+import { n as BrowserCaptureConfig, Q as OnBrowserEventCallback, h as AnyCapturedEvent, p as BrowserEventType, C as CapturedError } from './types-suaYwWWg.js';
+
+/**
+ * Browser Event Capture Orchestrator
+ *
+ * Single entry point that delegates to focused sub-modules.
+ * Replaces the old ConsoleCapture class with unified event capture.
+ */
+
+declare class BrowserEventCapture {
+    private buffer;
+    private maxEntries;
+    private installed;
+    private cleanups;
+    private onEvent;
+    private config;
+    constructor(config?: BrowserCaptureConfig);
+    setOnEvent(cb: OnBrowserEventCallback | null): void;
+    /**
+     * Install all enabled capture sub-modules.
+     * Safe to call multiple times (no-ops if already installed).
+     */
+    install(): void;
+    /**
+     * Uninstall all capture sub-modules.
+     */
+    uninstall(): void;
+    reportReactError(error: Error, errorInfo: {
+        componentStack?: string;
+    }): void;
+    reportWsStateChange(prev: string, next: string, reconnectAttempt?: number): void;
+    getSince(ts: number): AnyCapturedEvent[];
+    getRecent(n?: number): AnyCapturedEvent[];
+    getByType(type: BrowserEventType): AnyCapturedEvent[];
+    /**
+     * Get console errors since a timestamp (backward-compat for ActionExecutor).
+     */
+    getConsoleSince(ts: number): CapturedError[];
+    /**
+     * Get recent console errors (backward-compat for ActionExecutor).
+     */
+    getConsoleRecent(n?: number): CapturedError[];
+    clear(): void;
+    private trim;
+}
+
+export { BrowserEventCapture as B };

package/dist/control/index.d.mts

@@ -1,8 +1,9 @@
-import { A as ActionExecutor, b as ControlActionRequest, c as ControlActionResponse, C as ComponentActionRequest, a as ComponentActionResponse, W as WaitResult, F as FindRequest, g as FindResponse, d as ControlSnapshot, i as WorkflowEngine, j as WorkflowRunRequest, k as WorkflowRunResponse } from '../types-Dr6tH-bm.mjs';
-export { D as DiscoveredElement, e as DiscoveryRequest, f as DiscoveryResponse, K as KeyboardAction, M as MouseAction, S as ScrollAction, h as SelectAction, T as TypeAction, l as WorkflowRunStatus, m as WorkflowStepResult } from '../types-Dr6tH-bm.mjs';
-import { U as UIBridgeRegistry } from '../registry-SsSDq46X.mjs';
-import { a0 as WaitOptions } from '../types-CPMbN_Iw.mjs';
-import '../types-CFT3Dnx4.mjs';
+import { A as ActionExecutor, b as ControlActionRequest, c as ControlActionResponse, C as ComponentActionRequest, a as ComponentActionResponse, W as WaitResult, F as FindRequest, h as FindResponse, d as ControlSnapshot, k as WorkflowEngine, l as WorkflowRunRequest, m as WorkflowRunResponse } from '../types-CJGrBEhC.mjs';
+export { D as DiscoveredElement, e as DiscoveryRequest, f as DiscoveryResponse, g as DragAction, K as KeyboardAction, M as MouseAction, P as PageNavigateRequest, i as PageNavigationResponse, S as ScrollAction, j as SelectAction, T as TypeAction, n as WorkflowRunStatus, o as WorkflowStepResult } from '../types-CJGrBEhC.mjs';
+import { U as UIBridgeRegistry } from '../registry-POtcxnal.mjs';
+import { ax as WaitOptions } from '../types-suaYwWWg.mjs';
+import { B as BrowserEventCapture } from '../browser-capture-Bms60T6f.mjs';
+import '../types-D_ypYl3T.mjs';
 
 /**
  * Action Executor
@@ -15,7 +16,8 @@ import '../types-CFT3Dnx4.mjs';
  */
 declare class DefaultActionExecutor implements ActionExecutor {
     private registry;
-    constructor(registry: UIBridgeRegistry);
+    private consoleCapture?;
+    constructor(registry: UIBridgeRegistry, consoleCapture?: BrowserEventCapture | undefined);
     /**
      * Execute an action on an element
      */
@@ -61,6 +63,23 @@ declare class DefaultActionExecutor implements ActionExecutor {
     private performScroll;
     private performCheck;
     private performToggle;
+    private performSetValue;
+    private performSubmit;
+    private performReset;
+    /**
+     * Perform a drag operation by dispatching a sequence of mouse events.
+     *
+     * Follows the same composite pattern as the qontinui core library:
+     * mousedown on source → wait → mousemove × N along path → mouseup on target.
+     *
+     * Optionally dispatches HTML5 drag events (dragstart/dragover/drop/dragend)
+     * for apps that use the HTML5 Drag and Drop API instead of mouse events.
+     */
+    private performDrag;
+    /**
+     * Resolve a drag target element from a target descriptor.
+     */
+    private resolveTargetElement;
     private getElementId;
     private getElementLabel;
     private getAccessibleName;
@@ -70,7 +89,7 @@ declare class DefaultActionExecutor implements ActionExecutor {
 /**
  * Create an action executor
  */
-declare function createActionExecutor(registry: UIBridgeRegistry): ActionExecutor;
+declare function createActionExecutor(registry: UIBridgeRegistry, consoleCapture?: BrowserEventCapture): ActionExecutor;
 
 /**
  * Workflow Engine

package/dist/control/index.d.ts

@@ -1,8 +1,9 @@
-import { A as ActionExecutor, b as ControlActionRequest, c as ControlActionResponse, C as ComponentActionRequest, a as ComponentActionResponse, W as WaitResult, F as FindRequest, g as FindResponse, d as ControlSnapshot, i as WorkflowEngine, j as WorkflowRunRequest, k as WorkflowRunResponse } from '../types-oCTrRxSw.js';
-export { D as DiscoveredElement, e as DiscoveryRequest, f as DiscoveryResponse, K as KeyboardAction, M as MouseAction, S as ScrollAction, h as SelectAction, T as TypeAction, l as WorkflowRunStatus, m as WorkflowStepResult } from '../types-oCTrRxSw.js';
-import { U as UIBridgeRegistry } from '../registry-CIEDjbQ9.js';
-import { a0 as WaitOptions } from '../types-CPMbN_Iw.js';
-import '../types-BvCfFuEV.js';
+import { A as ActionExecutor, b as ControlActionRequest, c as ControlActionResponse, C as ComponentActionRequest, a as ComponentActionResponse, W as WaitResult, F as FindRequest, h as FindResponse, d as ControlSnapshot, k as WorkflowEngine, l as WorkflowRunRequest, m as WorkflowRunResponse } from '../types-C7gVYRnF.js';
+export { D as DiscoveredElement, e as DiscoveryRequest, f as DiscoveryResponse, g as DragAction, K as KeyboardAction, M as MouseAction, P as PageNavigateRequest, i as PageNavigationResponse, S as ScrollAction, j as SelectAction, T as TypeAction, n as WorkflowRunStatus, o as WorkflowStepResult } from '../types-C7gVYRnF.js';
+import { U as UIBridgeRegistry } from '../registry-C6dDtn1v.js';
+import { ax as WaitOptions } from '../types-suaYwWWg.js';
+import { B as BrowserEventCapture } from '../browser-capture-CsTU29mb.js';
+import '../types-CebMQj76.js';
 
 /**
  * Action Executor
@@ -15,7 +16,8 @@ import '../types-BvCfFuEV.js';
  */
 declare class DefaultActionExecutor implements ActionExecutor {
     private registry;
-    constructor(registry: UIBridgeRegistry);
+    private consoleCapture?;
+    constructor(registry: UIBridgeRegistry, consoleCapture?: BrowserEventCapture | undefined);
     /**
      * Execute an action on an element
      */
@@ -61,6 +63,23 @@ declare class DefaultActionExecutor implements ActionExecutor {
     private performScroll;
     private performCheck;
     private performToggle;
+    private performSetValue;
+    private performSubmit;
+    private performReset;
+    /**
+     * Perform a drag operation by dispatching a sequence of mouse events.
+     *
+     * Follows the same composite pattern as the qontinui core library:
+     * mousedown on source → wait → mousemove × N along path → mouseup on target.
+     *
+     * Optionally dispatches HTML5 drag events (dragstart/dragover/drop/dragend)
+     * for apps that use the HTML5 Drag and Drop API instead of mouse events.
+     */
+    private performDrag;
+    /**
+     * Resolve a drag target element from a target descriptor.
+     */
+    private resolveTargetElement;
     private getElementId;
     private getElementLabel;
     private getAccessibleName;
@@ -70,7 +89,7 @@ declare class DefaultActionExecutor implements ActionExecutor {
 /**
  * Create an action executor
  */
-declare function createActionExecutor(registry: UIBridgeRegistry): ActionExecutor;
+declare function createActionExecutor(registry: UIBridgeRegistry, consoleCapture?: BrowserEventCapture): ActionExecutor;
 
 /**
  * Workflow Engine

package/dist/control/index.js

@@ -105,6 +105,10 @@ function getElementState(element) {
       pointerEvents: style.pointerEvents
     }
   };
+  const rawText = element.textContent?.trim();
+  if (rawText) {
+    state.textContent = rawText.replace(/\s+/g, " ").slice(0, 500);
+  }
   if (element instanceof HTMLInputElement) {
     state.value = element.value;
     if (element.type === "checkbox" || element.type === "radio") {
@@ -146,9 +150,25 @@ function createMouseEvent(type, element, options) {
     clientY: rect.top + y
   });
 }
+function elementFromPointSafe(x, y) {
+  if (typeof document.elementFromPoint === "function") {
+    return document.elementFromPoint(x, y);
+  }
+  return null;
+}
+function createMouseEventAt(type, clientX, clientY) {
+  return new MouseEvent(type, {
+    bubbles: true,
+    cancelable: true,
+    button: 0,
+    clientX,
+    clientY
+  });
+}
 var DefaultActionExecutor = class {
-  constructor(registry) {
+  constructor(registry, consoleCapture) {
     this.registry = registry;
+    this.consoleCapture = consoleCapture;
   }
   /**
    * Execute an action on an element
@@ -185,11 +205,19 @@ var DefaultActionExecutor = class {
           };
         }
       }
+      const actionStartTime = Date.now();
       const result = await this.performAction(element, request.action, request.params);
+      let consoleErrors;
+      if (this.consoleCapture) {
+        await sleep(50);
+        const errors = this.consoleCapture.getConsoleSince(actionStartTime);
+        if (errors.length > 0) consoleErrors = errors;
+      }
       return {
         success: true,
         elementState: getElementState(element),
         result,
+        consoleErrors,
         durationMs: performance.now() - startTime,
         timestamp: Date.now(),
         requestId: request.requestId,
@@ -281,47 +309,76 @@ var DefaultActionExecutor = class {
       const rootEl = document.querySelector(options.root);
       if (rootEl) root = rootEl;
     }
-    const interactiveSelectors = [
-      "a[href]",
-      "button",
-      "input",
-      "select",
-      "textarea",
-      "[onclick]",
-      '[role="button"]',
-      '[role="link"]',
-      '[role="checkbox"]',
-      '[role="radio"]',
-      '[role="menuitem"]',
-      '[role="tab"]',
-      '[role="switch"]',
-      '[tabindex]:not([tabindex="-1"])',
-      '[contenteditable="true"]',
-      "[data-ui-id]",
-      "[data-testid]"
-    ];
-    const selector = options?.selector || interactiveSelectors.join(", ");
-    const foundElements = root.querySelectorAll(selector);
-    for (const el of foundElements) {
-      if (options?.limit && elements.length >= options.limit) break;
-      const state = getElementState(el);
-      if (!options?.includeHidden && !state.visible) continue;
-      if (options?.types) {
-        const type = this.inferElementType(el);
-        if (!options.types.includes(type)) continue;
-      }
-      const registered = this.registry.findByDOMElement(el);
-      elements.push({
-        id: registered?.id || this.getElementId(el),
-        type: registered?.type || this.inferElementType(el),
-        label: registered?.label || this.getElementLabel(el),
-        tagName: el.tagName.toLowerCase(),
-        role: el.getAttribute("role") || void 0,
-        accessibleName: this.getAccessibleName(el),
-        actions: registered?.actions || this.inferActions(el),
-        state,
-        registered: !!registered
-      });
+    if (!options?.contentOnly) {
+      const interactiveSelectors = [
+        "a[href]",
+        "button",
+        "input",
+        "select",
+        "textarea",
+        "[onclick]",
+        '[role="button"]',
+        '[role="link"]',
+        '[role="checkbox"]',
+        '[role="radio"]',
+        '[role="menuitem"]',
+        '[role="tab"]',
+        '[role="switch"]',
+        '[tabindex]:not([tabindex="-1"])',
+        '[contenteditable="true"]',
+        "[data-ui-element]",
+        "[data-ui-id]",
+        "[data-testid]"
+      ];
+      const selector = options?.selector || interactiveSelectors.join(", ");
+      const foundElements = root.querySelectorAll(selector);
+      for (const el of foundElements) {
+        if (options?.limit && elements.length >= options.limit) break;
+        const state = getElementState(el);
+        if (!options?.includeHidden && !state.visible) continue;
+        if (options?.types) {
+          const type = this.inferElementType(el);
+          if (!options.types.includes(type)) continue;
+        }
+        const registered = this.registry.findByDOMElement(el);
+        elements.push({
+          id: registered?.id || this.getElementId(el),
+          type: registered?.type || this.inferElementType(el),
+          label: registered?.label || this.getElementLabel(el),
+          tagName: el.tagName.toLowerCase(),
+          role: el.getAttribute("role") || void 0,
+          accessibleName: this.getAccessibleName(el),
+          actions: registered?.actions || this.inferActions(el),
+          state,
+          registered: !!registered,
+          category: registered?.category || "interactive",
+          contentMetadata: registered?.contentMetadata
+        });
+      }
+    }
+    if (options?.includeContent || options?.contentOnly) {
+      const contentElements = this.registry.getAllContentElements();
+      for (const el of contentElements) {
+        if (options?.limit && elements.length >= options.limit) break;
+        const state = el.getState();
+        if (!options?.includeHidden && !state.visible) continue;
+        if (options?.contentRole && el.contentMetadata?.contentRole !== options.contentRole) {
+          continue;
+        }
+        elements.push({
+          id: el.id,
+          type: el.type,
+          label: el.label,
+          tagName: el.element.tagName.toLowerCase(),
+          role: el.element.getAttribute("role") || void 0,
+          accessibleName: el.label || state.textContent?.trim(),
+          actions: [],
+          state,
+          registered: true,
+          category: "content",
+          contentMetadata: el.contentMetadata
+        });
+      }
     }
     return {
       elements,
@@ -351,7 +408,9 @@ var DefaultActionExecutor = class {
         type: el.type,
         label: el.label,
         actions: [...el.actions, ...el.customActions ? Object.keys(el.customActions) : []],
-        state: el.getState()
+        state: el.getState(),
+        category: el.category,
+        contentMetadata: el.contentMetadata
       })),
       components: components.map((comp) => ({
         id: comp.id,
@@ -435,6 +494,14 @@ var DefaultActionExecutor = class {
         return this.performCheck(element, false);
       case "toggle":
         return this.performToggle(element);
+      case "drag":
+        return this.performDrag(element, params);
+      case "setValue":
+        return this.performSetValue(element, params);
+      case "submit":
+        return this.performSubmit(element);
+      case "reset":
+        return this.performReset(element);
       default: {
         const registered = this.registry.findByDOMElement(element);
         if (registered?.customActions?.[action]) {
@@ -464,15 +531,26 @@ var DefaultActionExecutor = class {
     if (!(element instanceof HTMLInputElement || element instanceof HTMLTextAreaElement)) {
       throw new Error("Type action requires an input or textarea element");
     }
+    const proto = element instanceof HTMLTextAreaElement ? HTMLTextAreaElement.prototype : HTMLInputElement.prototype;
+    const nativeSetter = Object.getOwnPropertyDescriptor(proto, "value")?.set;
     element.focus();
     if (options?.clear) {
-      element.value = "";
+      if (nativeSetter) {
+        nativeSetter.call(element, "");
+      } else {
+        element.value = "";
+      }
       element.dispatchEvent(new Event("input", { bubbles: true }));
     }
     const text = options?.text || "";
     const delay = options?.delay || 0;
     for (const char of text) {
-      element.value += char;
+      const current = element.value;
+      if (nativeSetter) {
+        nativeSetter.call(element, current + char);
+      } else {
+        element.value = current + char;
+      }
       if (options?.triggerEvents !== false) {
         element.dispatchEvent(new Event("input", { bubbles: true }));
       }
@@ -486,7 +564,13 @@ var DefaultActionExecutor = class {
   }
   performClear(element) {
     if (element instanceof HTMLInputElement || element instanceof HTMLTextAreaElement) {
-      element.value = "";
+      const proto = element instanceof HTMLTextAreaElement ? HTMLTextAreaElement.prototype : HTMLInputElement.prototype;
+      const nativeSetter = Object.getOwnPropertyDescriptor(proto, "value")?.set;
+      if (nativeSetter) {
+        nativeSetter.call(element, "");
+      } else {
+        element.value = "";
+      }
       element.dispatchEvent(new Event("input", { bubbles: true }));
       element.dispatchEvent(new Event("change", { bubbles: true }));
     }
@@ -568,6 +652,150 @@ var DefaultActionExecutor = class {
       element.dispatchEvent(new Event("change", { bubbles: true }));
     }
   }
+  performSetValue(element, params) {
+    const value = params?.value;
+    if (value === void 0) {
+      throw new Error('setValue requires a "value" parameter');
+    }
+    if (element instanceof HTMLInputElement || element instanceof HTMLTextAreaElement) {
+      const nativeSetter = Object.getOwnPropertyDescriptor(
+        element instanceof HTMLTextAreaElement ? HTMLTextAreaElement.prototype : HTMLInputElement.prototype,
+        "value"
+      )?.set;
+      if (nativeSetter) {
+        nativeSetter.call(element, value);
+      } else {
+        element.value = value;
+      }
+      element.dispatchEvent(new Event("input", { bubbles: true }));
+      element.dispatchEvent(new Event("change", { bubbles: true }));
+    } else if (element instanceof HTMLSelectElement) {
+      element.value = value;
+      element.dispatchEvent(new Event("change", { bubbles: true }));
+    }
+  }
+  performSubmit(element) {
+    const form = element instanceof HTMLFormElement ? element : element.closest("form");
+    if (form) {
+      const submitEvent = new Event("submit", { bubbles: true, cancelable: true });
+      if (form.dispatchEvent(submitEvent)) {
+        form.requestSubmit();
+      }
+    } else {
+      throw new Error("No form found for submit action");
+    }
+  }
+  performReset(element) {
+    const form = element instanceof HTMLFormElement ? element : element.closest("form");
+    if (form) {
+      form.reset();
+      form.dispatchEvent(new Event("reset", { bubbles: true }));
+    } else {
+      throw new Error("No form found for reset action");
+    }
+  }
+  /**
+   * Perform a drag operation by dispatching a sequence of mouse events.
+   *
+   * Follows the same composite pattern as the qontinui core library:
+   * mousedown on source → wait → mousemove × N along path → mouseup on target.
+   *
+   * Optionally dispatches HTML5 drag events (dragstart/dragover/drop/dragend)
+   * for apps that use the HTML5 Drag and Drop API instead of mouse events.
+   */
+  async performDrag(sourceElement, options) {
+    const sourceRect = sourceElement.getBoundingClientRect();
+    const sourceX = sourceRect.left + (options?.sourceOffset?.x ?? sourceRect.width / 2);
+    const sourceY = sourceRect.top + (options?.sourceOffset?.y ?? sourceRect.height / 2);
+    let targetX;
+    let targetY;
+    if (options?.targetPosition) {
+      targetX = options.targetPosition.x;
+      targetY = options.targetPosition.y;
+    } else if (options?.target) {
+      const targetElement = this.resolveTargetElement(options.target);
+      if (!targetElement) {
+        throw new Error(`Drag target element not found: ${JSON.stringify(options.target)}`);
+      }
+      const targetRect = targetElement.getBoundingClientRect();
+      targetX = targetRect.left + (options?.targetOffset?.x ?? targetRect.width / 2);
+      targetY = targetRect.top + (options?.targetOffset?.y ?? targetRect.height / 2);
+    } else {
+      throw new Error("Drag requires either target or targetPosition");
+    }
+    const steps = options?.steps ?? 10;
+    const holdDelay = options?.holdDelay ?? 100;
+    const releaseDelay = options?.releaseDelay ?? 50;
+    sourceElement.dispatchEvent(createMouseEventAt("mousedown", sourceX, sourceY));
+    const canHTML5 = options?.html5 && typeof DragEvent !== "undefined";
+    if (canHTML5) {
+      sourceElement.dispatchEvent(
+        new DragEvent("dragstart", {
+          bubbles: true,
+          cancelable: true,
+          clientX: sourceX,
+          clientY: sourceY
+        })
+      );
+    }
+    if (holdDelay > 0) {
+      await sleep(holdDelay);
+    }
+    for (let i = 1; i <= steps; i++) {
+      const progress = i / steps;
+      const currentX = sourceX + (targetX - sourceX) * progress;
+      const currentY = sourceY + (targetY - sourceY) * progress;
+      const dispatchTarget = elementFromPointSafe(currentX, currentY) || sourceElement;
+      dispatchTarget.dispatchEvent(createMouseEventAt("mousemove", currentX, currentY));
+      if (canHTML5) {
+        dispatchTarget.dispatchEvent(
+          new DragEvent("dragover", {
+            bubbles: true,
+            cancelable: true,
+            clientX: currentX,
+            clientY: currentY
+          })
+        );
+      }
+    }
+    const dropTarget = elementFromPointSafe(targetX, targetY) || sourceElement;
+    dropTarget.dispatchEvent(createMouseEventAt("mouseup", targetX, targetY));
+    if (canHTML5) {
+      dropTarget.dispatchEvent(
+        new DragEvent("drop", {
+          bubbles: true,
+          cancelable: true,
+          clientX: targetX,
+          clientY: targetY
+        })
+      );
+      sourceElement.dispatchEvent(
+        new DragEvent("dragend", {
+          bubbles: true,
+          cancelable: true,
+          clientX: targetX,
+          clientY: targetY
+        })
+      );
+    }
+    if (releaseDelay > 0) {
+      await sleep(releaseDelay);
+    }
+  }
+  /**
+   * Resolve a drag target element from a target descriptor.
+   */
+  resolveTargetElement(target) {
+    if (target.elementId) {
+      const registered = this.registry.getElement(target.elementId);
+      if (registered?.element) return registered.element;
+      return findElementByIdentifier(target.elementId);
+    }
+    if (target.selector) {
+      return document.querySelector(target.selector);
+    }
+    return null;
+  }
   getElementId(element) {
     return element.getAttribute("data-ui-id") || element.getAttribute("data-testid") || element.id || `${element.tagName.toLowerCase()}-${Math.random().toString(36).substr(2, 8)}`;
   }
@@ -663,8 +891,8 @@ var DefaultActionExecutor = class {
     }
   }
 };
-function createActionExecutor(registry) {
-  return new DefaultActionExecutor(registry);
+function createActionExecutor(registry, consoleCapture) {
+  return new DefaultActionExecutor(registry, consoleCapture);
 }
 
 // src/control/workflow-engine.ts