@qontinui/ui-bridge 0.1.1 → 0.3.0

package/dist/{registry-CT6BVVKr.d.mts → registry-BKLEm-yk.d.ts}

@@ -1,4 +1,5 @@
-import { d as BridgeEventListener, e as BridgeEventType, i as ElementType, S as StandardAction, g as CustomAction, l as RegisteredElement, R as RegisteredComponent, a1 as Workflow, o as UIState, p as UIStateGroup, q as UITransition, T as TransitionResult, P as PathResult, N as NavigationResult, m as StateSnapshot, f as BridgeSnapshot } from './types-BpvpStn3.mjs';
+import { j as BridgeEventListener, k as BridgeEventType, r as ElementType, S as StandardAction, o as CustomAction, x as RegisteredElement, y as StateGetter, w as RegisteredComponent, m as ComponentStateResponse, af as Workflow, F as UIState, G as UIStateGroup, H as UITransition, T as TransitionResult, v as PathResult, N as NavigationResult, z as StateSnapshot, l as BridgeSnapshot } from './types-jKVgTI6_.js';
+import { S as SearchCriteria, o as SearchResult } from './types-DfPqwU-i.js';
 
 /**
  * Element and Component Registry
@@ -69,6 +70,26 @@ declare class UIBridgeRegistry {
      * Find element by DOM element reference
      */
     findByDOMElement(element: HTMLElement): RegisteredElement | undefined;
+    /**
+     * Search for elements using AI search criteria
+     */
+    searchElements(criteria: SearchCriteria): SearchResult[];
+    /**
+     * Find element by visible text
+     */
+    findByText(text: string, fuzzy?: boolean): RegisteredElement | undefined;
+    /**
+     * Find element by accessible name
+     */
+    findByAccessibleName(name: string): RegisteredElement | undefined;
+    /**
+     * Generate aliases for an element
+     */
+    private generateElementAliases;
+    /**
+     * Infer ARIA role from element type
+     */
+    private inferRole;
     /**
      * Register a component
      */
@@ -82,6 +103,8 @@ declare class UIBridgeRegistry {
             handler: (params?: unknown) => unknown | Promise<unknown>;
         }>;
         elementIds?: string[];
+        getState?: StateGetter<Record<string, unknown>>;
+        getComputed?: () => Record<string, unknown>;
     }): RegisteredComponent;
     /**
      * Unregister a component
@@ -95,6 +118,10 @@ declare class UIBridgeRegistry {
      * Get all registered components
      */
     getAllComponents(): RegisteredComponent[];
+    /**
+     * Get the current state and computed properties of a component
+     */
+    getComponentState(id: string): ComponentStateResponse | null;
     /**
      * Register a workflow
      */
@@ -237,17 +264,5 @@ declare class UIBridgeRegistry {
         activeStateCount: number;
     };
 }
-/**
- * Get or create the global registry
- */
-declare function getGlobalRegistry(): UIBridgeRegistry;
-/**
- * Set the global registry
- */
-declare function setGlobalRegistry(registry: UIBridgeRegistry): void;
-/**
- * Reset the global registry
- */
-declare function resetGlobalRegistry(): void;
 
-export { type RegistryOptions as R, UIBridgeRegistry as U, getGlobalRegistry as g, resetGlobalRegistry as r, setGlobalRegistry as s };
+export { UIBridgeRegistry as U };

package/dist/{registry-D4mQ01B3.d.ts → registry-BmZgyCz8.d.mts}

@@ -1,4 +1,5 @@
-import { d as BridgeEventListener, e as BridgeEventType, i as ElementType, S as StandardAction, g as CustomAction, l as RegisteredElement, R as RegisteredComponent, a1 as Workflow, o as UIState, p as UIStateGroup, q as UITransition, T as TransitionResult, P as PathResult, N as NavigationResult, m as StateSnapshot, f as BridgeSnapshot } from './types-BpvpStn3.js';
+import { j as BridgeEventListener, k as BridgeEventType, r as ElementType, S as StandardAction, o as CustomAction, x as RegisteredElement, y as StateGetter, w as RegisteredComponent, m as ComponentStateResponse, af as Workflow, F as UIState, G as UIStateGroup, H as UITransition, T as TransitionResult, v as PathResult, N as NavigationResult, z as StateSnapshot, l as BridgeSnapshot } from './types-jKVgTI6_.mjs';
+import { S as SearchCriteria, o as SearchResult } from './types-B5Q0GVo0.mjs';
 
 /**
  * Element and Component Registry
@@ -69,6 +70,26 @@ declare class UIBridgeRegistry {
      * Find element by DOM element reference
      */
     findByDOMElement(element: HTMLElement): RegisteredElement | undefined;
+    /**
+     * Search for elements using AI search criteria
+     */
+    searchElements(criteria: SearchCriteria): SearchResult[];
+    /**
+     * Find element by visible text
+     */
+    findByText(text: string, fuzzy?: boolean): RegisteredElement | undefined;
+    /**
+     * Find element by accessible name
+     */
+    findByAccessibleName(name: string): RegisteredElement | undefined;
+    /**
+     * Generate aliases for an element
+     */
+    private generateElementAliases;
+    /**
+     * Infer ARIA role from element type
+     */
+    private inferRole;
     /**
      * Register a component
      */
@@ -82,6 +103,8 @@ declare class UIBridgeRegistry {
             handler: (params?: unknown) => unknown | Promise<unknown>;
         }>;
         elementIds?: string[];
+        getState?: StateGetter<Record<string, unknown>>;
+        getComputed?: () => Record<string, unknown>;
     }): RegisteredComponent;
     /**
      * Unregister a component
@@ -95,6 +118,10 @@ declare class UIBridgeRegistry {
      * Get all registered components
      */
     getAllComponents(): RegisteredComponent[];
+    /**
+     * Get the current state and computed properties of a component
+     */
+    getComponentState(id: string): ComponentStateResponse | null;
     /**
      * Register a workflow
      */
@@ -237,17 +264,5 @@ declare class UIBridgeRegistry {
         activeStateCount: number;
     };
 }
-/**
- * Get or create the global registry
- */
-declare function getGlobalRegistry(): UIBridgeRegistry;
-/**
- * Set the global registry
- */
-declare function setGlobalRegistry(registry: UIBridgeRegistry): void;
-/**
- * Reset the global registry
- */
-declare function resetGlobalRegistry(): void;
 
-export { type RegistryOptions as R, UIBridgeRegistry as U, getGlobalRegistry as g, resetGlobalRegistry as r, setGlobalRegistry as s };
+export { UIBridgeRegistry as U };

package/dist/render-log/index.d.mts

@@ -1,4 +1,4 @@
-import { E as ElementIdentifier, h as ElementState } from '../types-BpvpStn3.mjs';
+import { p as ElementIdentifier, q as ElementState } from '../types-jKVgTI6_.mjs';
 
 /**
  * DOM Capture Module

package/dist/render-log/index.d.ts

@@ -1,4 +1,4 @@
-import { E as ElementIdentifier, h as ElementState } from '../types-BpvpStn3.js';
+import { p as ElementIdentifier, q as ElementState } from '../types-jKVgTI6_.js';
 
 /**
  * DOM Capture Module

package/dist/server/express.d.mts

@@ -0,0 +1,36 @@
+import { Router } from 'express';
+import { U as UIBridgeServerConfig, c as UIBridgeServerHandlers } from '../types-CEQLnFMv.mjs';
+import '../types-jKVgTI6_.mjs';
+import '../types-B7J7noLK.mjs';
+import '../types-B5Q0GVo0.mjs';
+import '../render-log/index.mjs';
+
+/**
+ * Express Adapter
+ *
+ * Express.js middleware for UI Bridge server.
+ */
+
+/**
+ * Express-specific configuration
+ */
+interface ExpressAdapterConfig extends UIBridgeServerConfig {
+    /** Use JSON body parser (if not already configured) */
+    useBodyParser?: boolean;
+}
+/**
+ * Create Express router with UI Bridge routes
+ */
+declare function createExpressRouter(handlers: UIBridgeServerHandlers, config?: ExpressAdapterConfig): Router;
+/**
+ * Create Express app with UI Bridge routes
+ *
+ * Convenience function that creates a complete Express app with UI Bridge.
+ */
+declare function createExpressApp(handlers: UIBridgeServerHandlers, config?: ExpressAdapterConfig): unknown;
+/**
+ * Express middleware that adds UI Bridge to an existing app
+ */
+declare function uiBridgeMiddleware(handlers: UIBridgeServerHandlers, config?: ExpressAdapterConfig): Router;
+
+export { type ExpressAdapterConfig, createExpressApp, createExpressRouter, uiBridgeMiddleware };

package/dist/server/express.d.ts

@@ -0,0 +1,36 @@
+import { Router } from 'express';
+import { U as UIBridgeServerConfig, c as UIBridgeServerHandlers } from '../types-CHnlwiTK.js';
+import '../types-jKVgTI6_.js';
+import '../types-BkNRILUa.js';
+import '../types-DfPqwU-i.js';
+import '../render-log/index.js';
+
+/**
+ * Express Adapter
+ *
+ * Express.js middleware for UI Bridge server.
+ */
+
+/**
+ * Express-specific configuration
+ */
+interface ExpressAdapterConfig extends UIBridgeServerConfig {
+    /** Use JSON body parser (if not already configured) */
+    useBodyParser?: boolean;
+}
+/**
+ * Create Express router with UI Bridge routes
+ */
+declare function createExpressRouter(handlers: UIBridgeServerHandlers, config?: ExpressAdapterConfig): Router;
+/**
+ * Create Express app with UI Bridge routes
+ *
+ * Convenience function that creates a complete Express app with UI Bridge.
+ */
+declare function createExpressApp(handlers: UIBridgeServerHandlers, config?: ExpressAdapterConfig): unknown;
+/**
+ * Express middleware that adds UI Bridge to an existing app
+ */
+declare function uiBridgeMiddleware(handlers: UIBridgeServerHandlers, config?: ExpressAdapterConfig): Router;
+
+export { type ExpressAdapterConfig, createExpressApp, createExpressRouter, uiBridgeMiddleware };

package/dist/server/express.js

@@ -0,0 +1,196 @@
+'use strict';
+
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/server/types.ts
+var UI_BRIDGE_ROUTES = [
+  // Render log
+  { method: "GET", path: "/render-log", handler: "getRenderLog" },
+  { method: "DELETE", path: "/render-log", handler: "clearRenderLog" },
+  { method: "POST", path: "/render-log/snapshot", handler: "captureSnapshot" },
+  { method: "GET", path: "/render-log/path", handler: "getRenderLogPath" },
+  // Control - Elements
+  { method: "GET", path: "/control/elements", handler: "getElements" },
+  { method: "GET", path: "/control/element/:id", handler: "getElement", params: ["id"] },
+  { method: "GET", path: "/control/element/:id/state", handler: "getElementState", params: ["id"] },
+  {
+    method: "POST",
+    path: "/control/element/:id/action",
+    handler: "executeElementAction",
+    params: ["id"],
+    bodyRequired: true
+  },
+  // Control - Components
+  { method: "GET", path: "/control/components", handler: "getComponents" },
+  { method: "GET", path: "/control/component/:id", handler: "getComponent", params: ["id"] },
+  { method: "GET", path: "/control/component/:id/state", handler: "getComponentState", params: ["id"] },
+  {
+    method: "POST",
+    path: "/control/component/:id/action/:actionId",
+    handler: "executeComponentAction",
+    params: ["id", "actionId"],
+    bodyRequired: true
+  },
+  // Find (formerly Discovery)
+  { method: "POST", path: "/control/find", handler: "find" },
+  { method: "POST", path: "/control/discover", handler: "discover" },
+  // @deprecated Use /control/find
+  { method: "GET", path: "/control/snapshot", handler: "getControlSnapshot" },
+  // Workflows
+  { method: "GET", path: "/control/workflows", handler: "getWorkflows" },
+  { method: "POST", path: "/control/workflow/:id/run", handler: "runWorkflow", params: ["id"] },
+  {
+    method: "GET",
+    path: "/control/workflow/:runId/status",
+    handler: "getWorkflowStatus",
+    params: ["runId"]
+  },
+  // Debug
+  { method: "GET", path: "/debug/action-history", handler: "getActionHistory" },
+  { method: "GET", path: "/debug/metrics", handler: "getMetrics" },
+  { method: "POST", path: "/debug/highlight/:id", handler: "highlightElement", params: ["id"] },
+  { method: "GET", path: "/debug/element-tree", handler: "getElementTree" },
+  // AI-native endpoints
+  { method: "POST", path: "/ai/search", handler: "aiSearch", bodyRequired: true },
+  { method: "POST", path: "/ai/execute", handler: "aiExecute", bodyRequired: true },
+  { method: "POST", path: "/ai/assert", handler: "aiAssert", bodyRequired: true },
+  { method: "POST", path: "/ai/assert/batch", handler: "aiAssertBatch", bodyRequired: true },
+  { method: "GET", path: "/ai/snapshot", handler: "getSemanticSnapshot" },
+  { method: "GET", path: "/ai/diff", handler: "getSemanticDiff" },
+  { method: "GET", path: "/ai/summary", handler: "getPageSummary" },
+  { method: "POST", path: "/ai/semantic-search", handler: "aiSemanticSearch", bodyRequired: true }
+];
+
+// src/server/express.ts
+function createCORSMiddleware(options) {
+  const corsOptions = typeof options === "boolean" ? { origin: options, methods: ["GET", "POST", "PUT", "DELETE", "PATCH", "OPTIONS"] } : options;
+  return (req, res, next) => {
+    if (corsOptions.origin === true) {
+      res.setHeader("Access-Control-Allow-Origin", "*");
+    } else if (typeof corsOptions.origin === "string") {
+      res.setHeader("Access-Control-Allow-Origin", corsOptions.origin);
+    } else if (Array.isArray(corsOptions.origin)) {
+      const origin = req.headers.origin;
+      if (origin && corsOptions.origin.includes(origin)) {
+        res.setHeader("Access-Control-Allow-Origin", origin);
+      }
+    }
+    if (corsOptions.methods) {
+      res.setHeader("Access-Control-Allow-Methods", corsOptions.methods.join(", "));
+    }
+    if (corsOptions.headers) {
+      res.setHeader("Access-Control-Allow-Headers", corsOptions.headers.join(", "));
+    } else {
+      res.setHeader(
+        "Access-Control-Allow-Headers",
+        "Content-Type, Authorization, X-Requested-With"
+      );
+    }
+    if (corsOptions.credentials) {
+      res.setHeader("Access-Control-Allow-Credentials", "true");
+    }
+    if (corsOptions.maxAge) {
+      res.setHeader("Access-Control-Max-Age", String(corsOptions.maxAge));
+    }
+    if (req.method === "OPTIONS") {
+      res.status(204).end();
+      return;
+    }
+    next();
+  };
+}
+function wrapError(error, code) {
+  return {
+    success: false,
+    error: typeof error === "string" ? error : error.message,
+    code,
+    timestamp: Date.now()
+  };
+}
+function createExpressRouter(handlers, config = {}) {
+  const express = __require("express");
+  const router = express.Router();
+  if (config.cors) {
+    router.use(createCORSMiddleware(config.cors));
+  }
+  if (config.useBodyParser) {
+    router.use(express.json());
+  }
+  if (config.authenticate) {
+    router.use(async (req, res, next) => {
+      try {
+        const authenticated = await config.authenticate(req);
+        if (!authenticated) {
+          res.status(401).json(wrapError("Unauthorized", "UNAUTHORIZED"));
+          return;
+        }
+        next();
+      } catch (error) {
+        res.status(500).json(wrapError(error, "AUTH_ERROR"));
+      }
+    });
+  }
+  for (const route of UI_BRIDGE_ROUTES) {
+    const method = route.method.toLowerCase();
+    const path = route.path;
+    const handlerName = route.handler;
+    const handler = handlers[handlerName];
+    if (!handler) {
+      console.warn(`Handler not found for route: ${route.method} ${route.path}`);
+      continue;
+    }
+    router[method](
+      path,
+      createRouteHandler(route, handler)
+    );
+  }
+  return router;
+}
+function createRouteHandler(route, handler) {
+  return async (req, res) => {
+    try {
+      const args = [];
+      if (route.params) {
+        for (const param of route.params) {
+          args.push(req.params[param]);
+        }
+      }
+      if (route.bodyRequired || route.method === "POST") {
+        args.push(req.body);
+      }
+      if (route.method === "GET" && Object.keys(req.query).length > 0) {
+        args.push(req.query);
+      }
+      const result = await handler(...args);
+      res.json(result);
+    } catch (error) {
+      res.status(500).json(wrapError(error, "INTERNAL_ERROR"));
+    }
+  };
+}
+function createExpressApp(handlers, config = {}) {
+  const express = __require("express");
+  const app = express();
+  app.use(express.json());
+  const basePath = config.basePath || "/ui-bridge";
+  const router = createExpressRouter(handlers, { ...config, useBodyParser: false });
+  app.use(basePath, router);
+  app.get("/health", (_req, res) => {
+    res.json({ status: "ok", timestamp: Date.now() });
+  });
+  return app;
+}
+function uiBridgeMiddleware(handlers, config = {}) {
+  return createExpressRouter(handlers, config);
+}
+
+exports.createExpressApp = createExpressApp;
+exports.createExpressRouter = createExpressRouter;
+exports.uiBridgeMiddleware = uiBridgeMiddleware;
+//# sourceMappingURL=express.js.map
+//# sourceMappingURL=express.js.map

package/dist/server/express.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/server/types.ts","../../src/server/express.ts"],"names":[],"mappings":"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","file":"express.js","sourcesContent":["/**\n * UI Bridge Server Types\n *\n * Shared types for server adapters.\n */\n\nimport type { UIBridgeConfig } from '../core';\nimport type {\n  ControlActionRequest,\n  ControlActionResponse,\n  ComponentActionRequest,\n  ComponentActionResponse,\n  FindRequest,\n  FindResponse,\n  ControlSnapshot,\n  WorkflowRunRequest,\n  WorkflowRunResponse,\n} from '../control';\nimport type { RenderLogEntry, RenderLogEntryType } from '../render-log';\nimport type {\n  SearchCriteria,\n  SearchResponse,\n  NLActionRequest,\n  NLActionResponse,\n  AssertionRequest,\n  AssertionResult,\n  BatchAssertionRequest,\n  BatchAssertionResult,\n  SemanticSnapshot,\n  SemanticDiff,\n  SemanticSearchCriteria,\n  SemanticSearchResponse,\n} from '../ai';\n\n/**\n * Server configuration\n */\nexport interface UIBridgeServerConfig extends UIBridgeConfig {\n  /** Base path for API routes */\n  basePath?: string;\n  /** Enable CORS */\n  cors?: boolean | CORSOptions;\n  /** Authentication middleware */\n  authenticate?: (req: unknown) => boolean | Promise<boolean>;\n  /** Rate limiting */\n  rateLimit?: RateLimitOptions;\n}\n\n/**\n * CORS options\n */\nexport interface CORSOptions {\n  /** Allowed origins */\n  origin?: string | string[] | boolean;\n  /** Allowed methods */\n  methods?: string[];\n  /** Allowed headers */\n  headers?: string[];\n  /** Expose headers */\n  exposeHeaders?: string[];\n  /** Allow credentials */\n  credentials?: boolean;\n  /** Max age for preflight cache */\n  maxAge?: number;\n}\n\n/**\n * Rate limit options\n */\nexport interface RateLimitOptions {\n  /** Time window in milliseconds */\n  windowMs?: number;\n  /** Max requests per window */\n  max?: number;\n  /** Message when rate limited */\n  message?: string;\n}\n\n/**\n * API response wrapper\n */\nexport interface APIResponse<T = unknown> {\n  /** Whether the request succeeded */\n  success: boolean;\n  /** Response data */\n  data?: T;\n  /** Error message if failed */\n  error?: string;\n  /** Error code */\n  code?: string;\n  /** Request timestamp */\n  timestamp: number;\n}\n\n/**\n * Render log query parameters\n */\nexport interface RenderLogQuery {\n  /** Filter by entry type */\n  type?: RenderLogEntryType;\n  /** Filter entries since timestamp */\n  since?: number;\n  /** Filter entries until timestamp */\n  until?: number;\n  /** Limit number of results */\n  limit?: number;\n}\n\n/**\n * Server handler interface\n *\n * Implementations provide these handlers for different frameworks.\n */\nexport interface UIBridgeServerHandlers {\n  // Render log endpoints\n  getRenderLog: (query?: RenderLogQuery) => Promise<APIResponse<RenderLogEntry[]>>;\n  clearRenderLog: () => Promise<APIResponse<void>>;\n  captureSnapshot: () => Promise<APIResponse<unknown>>;\n  getRenderLogPath: () => Promise<APIResponse<{ path: string }>>;\n\n  // Control endpoints\n  getElements: () => Promise<APIResponse<ControlSnapshot['elements']>>;\n  getElement: (id: string) => Promise<APIResponse<ControlSnapshot['elements'][0]>>;\n  getElementState: (id: string) => Promise<APIResponse<unknown>>;\n  executeElementAction: (\n    id: string,\n    request: ControlActionRequest\n  ) => Promise<APIResponse<ControlActionResponse>>;\n\n  // Component endpoints\n  getComponents: () => Promise<APIResponse<ControlSnapshot['components']>>;\n  getComponent: (id: string) => Promise<APIResponse<ControlSnapshot['components'][0]>>;\n  getComponentState: (id: string) => Promise<APIResponse<{ state: Record<string, unknown>; computed: Record<string, unknown>; timestamp: number }>>;\n  executeComponentAction: (\n    id: string,\n    request: ComponentActionRequest\n  ) => Promise<APIResponse<ComponentActionResponse>>;\n\n  // Find endpoints\n  find: (request?: FindRequest) => Promise<APIResponse<FindResponse>>;\n  /**\n   * @deprecated Use find() instead\n   */\n  discover: (request?: FindRequest) => Promise<APIResponse<FindResponse>>;\n  getControlSnapshot: () => Promise<APIResponse<ControlSnapshot>>;\n\n  // Workflow endpoints\n  getWorkflows: () => Promise<APIResponse<ControlSnapshot['workflows']>>;\n  runWorkflow: (\n    id: string,\n    request?: WorkflowRunRequest\n  ) => Promise<APIResponse<WorkflowRunResponse>>;\n  getWorkflowStatus: (runId: string) => Promise<APIResponse<WorkflowRunResponse>>;\n\n  // Debug endpoints\n  getActionHistory: (limit?: number) => Promise<APIResponse<unknown[]>>;\n  getMetrics: () => Promise<APIResponse<unknown>>;\n  highlightElement: (id: string) => Promise<APIResponse<void>>;\n  getElementTree: () => Promise<APIResponse<unknown>>;\n\n  // AI-native endpoints\n  aiSearch: (criteria: SearchCriteria) => Promise<APIResponse<SearchResponse>>;\n  aiExecute: (request: NLActionRequest) => Promise<APIResponse<NLActionResponse>>;\n  aiAssert: (request: AssertionRequest) => Promise<APIResponse<AssertionResult>>;\n  aiAssertBatch: (request: BatchAssertionRequest) => Promise<APIResponse<BatchAssertionResult>>;\n  getSemanticSnapshot: () => Promise<APIResponse<SemanticSnapshot>>;\n  getSemanticDiff: (since?: number) => Promise<APIResponse<SemanticDiff | null>>;\n  getPageSummary: () => Promise<APIResponse<string>>;\n\n  // Semantic search (embedding-based)\n  aiSemanticSearch: (criteria: SemanticSearchCriteria) => Promise<APIResponse<SemanticSearchResponse>>;\n}\n\n/**\n * Route definition\n */\nexport interface RouteDefinition {\n  method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';\n  path: string;\n  handler: string; // Key in UIBridgeServerHandlers\n  params?: string[]; // URL params to extract\n  bodyRequired?: boolean;\n}\n\n/**\n * All UI Bridge routes\n */\nexport const UI_BRIDGE_ROUTES: RouteDefinition[] = [\n  // Render log\n  { method: 'GET', path: '/render-log', handler: 'getRenderLog' },\n  { method: 'DELETE', path: '/render-log', handler: 'clearRenderLog' },\n  { method: 'POST', path: '/render-log/snapshot', handler: 'captureSnapshot' },\n  { method: 'GET', path: '/render-log/path', handler: 'getRenderLogPath' },\n\n  // Control - Elements\n  { method: 'GET', path: '/control/elements', handler: 'getElements' },\n  { method: 'GET', path: '/control/element/:id', handler: 'getElement', params: ['id'] },\n  { method: 'GET', path: '/control/element/:id/state', handler: 'getElementState', params: ['id'] },\n  {\n    method: 'POST',\n    path: '/control/element/:id/action',\n    handler: 'executeElementAction',\n    params: ['id'],\n    bodyRequired: true,\n  },\n\n  // Control - Components\n  { method: 'GET', path: '/control/components', handler: 'getComponents' },\n  { method: 'GET', path: '/control/component/:id', handler: 'getComponent', params: ['id'] },\n  { method: 'GET', path: '/control/component/:id/state', handler: 'getComponentState', params: ['id'] },\n  {\n    method: 'POST',\n    path: '/control/component/:id/action/:actionId',\n    handler: 'executeComponentAction',\n    params: ['id', 'actionId'],\n    bodyRequired: true,\n  },\n\n  // Find (formerly Discovery)\n  { method: 'POST', path: '/control/find', handler: 'find' },\n  { method: 'POST', path: '/control/discover', handler: 'discover' }, // @deprecated Use /control/find\n  { method: 'GET', path: '/control/snapshot', handler: 'getControlSnapshot' },\n\n  // Workflows\n  { method: 'GET', path: '/control/workflows', handler: 'getWorkflows' },\n  { method: 'POST', path: '/control/workflow/:id/run', handler: 'runWorkflow', params: ['id'] },\n  {\n    method: 'GET',\n    path: '/control/workflow/:runId/status',\n    handler: 'getWorkflowStatus',\n    params: ['runId'],\n  },\n\n  // Debug\n  { method: 'GET', path: '/debug/action-history', handler: 'getActionHistory' },\n  { method: 'GET', path: '/debug/metrics', handler: 'getMetrics' },\n  { method: 'POST', path: '/debug/highlight/:id', handler: 'highlightElement', params: ['id'] },\n  { method: 'GET', path: '/debug/element-tree', handler: 'getElementTree' },\n\n  // AI-native endpoints\n  { method: 'POST', path: '/ai/search', handler: 'aiSearch', bodyRequired: true },\n  { method: 'POST', path: '/ai/execute', handler: 'aiExecute', bodyRequired: true },\n  { method: 'POST', path: '/ai/assert', handler: 'aiAssert', bodyRequired: true },\n  { method: 'POST', path: '/ai/assert/batch', handler: 'aiAssertBatch', bodyRequired: true },\n  { method: 'GET', path: '/ai/snapshot', handler: 'getSemanticSnapshot' },\n  { method: 'GET', path: '/ai/diff', handler: 'getSemanticDiff' },\n  { method: 'GET', path: '/ai/summary', handler: 'getPageSummary' },\n  { method: 'POST', path: '/ai/semantic-search', handler: 'aiSemanticSearch', bodyRequired: true },\n];\n\n/**\n * WebSocket message types\n */\nexport type WebSocketMessageType =\n  | 'subscribe'\n  | 'unsubscribe'\n  | 'event'\n  | 'snapshot'\n  | 'action'\n  | 'error';\n\n/**\n * WebSocket message\n */\nexport interface WebSocketMessage<T = unknown> {\n  type: WebSocketMessageType;\n  channel?: string;\n  data?: T;\n  error?: string;\n  timestamp: number;\n}\n","/**\n * Express Adapter\n *\n * Express.js middleware for UI Bridge server.\n */\n\nimport type { Router, Request, Response, NextFunction } from 'express';\nimport type {\n  UIBridgeServerConfig,\n  UIBridgeServerHandlers,\n  APIResponse,\n  RouteDefinition,\n  CORSOptions,\n} from './types';\nimport { UI_BRIDGE_ROUTES } from './types';\n\n/**\n * Express-specific configuration\n */\nexport interface ExpressAdapterConfig extends UIBridgeServerConfig {\n  /** Use JSON body parser (if not already configured) */\n  useBodyParser?: boolean;\n}\n\n/**\n * Create CORS middleware\n */\nfunction createCORSMiddleware(options: CORSOptions | boolean) {\n  const corsOptions: CORSOptions =\n    typeof options === 'boolean'\n      ? { origin: options, methods: ['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'OPTIONS'] }\n      : options;\n\n  return (req: Request, res: Response, next: NextFunction) => {\n    // Origin\n    if (corsOptions.origin === true) {\n      res.setHeader('Access-Control-Allow-Origin', '*');\n    } else if (typeof corsOptions.origin === 'string') {\n      res.setHeader('Access-Control-Allow-Origin', corsOptions.origin);\n    } else if (Array.isArray(corsOptions.origin)) {\n      const origin = req.headers.origin;\n      if (origin && corsOptions.origin.includes(origin)) {\n        res.setHeader('Access-Control-Allow-Origin', origin);\n      }\n    }\n\n    // Methods\n    if (corsOptions.methods) {\n      res.setHeader('Access-Control-Allow-Methods', corsOptions.methods.join(', '));\n    }\n\n    // Headers\n    if (corsOptions.headers) {\n      res.setHeader('Access-Control-Allow-Headers', corsOptions.headers.join(', '));\n    } else {\n      res.setHeader(\n        'Access-Control-Allow-Headers',\n        'Content-Type, Authorization, X-Requested-With'\n      );\n    }\n\n    // Credentials\n    if (corsOptions.credentials) {\n      res.setHeader('Access-Control-Allow-Credentials', 'true');\n    }\n\n    // Max age\n    if (corsOptions.maxAge) {\n      res.setHeader('Access-Control-Max-Age', String(corsOptions.maxAge));\n    }\n\n    // Handle preflight\n    if (req.method === 'OPTIONS') {\n      res.status(204).end();\n      return;\n    }\n\n    next();\n  };\n}\n\n/**\n * Wrap error in API format\n */\nfunction wrapError(error: Error | string, code?: string): APIResponse<never> {\n  return {\n    success: false,\n    error: typeof error === 'string' ? error : error.message,\n    code,\n    timestamp: Date.now(),\n  };\n}\n\n/**\n * Create Express router with UI Bridge routes\n */\nexport function createExpressRouter(\n  handlers: UIBridgeServerHandlers,\n  config: ExpressAdapterConfig = {}\n): Router {\n  // Dynamic import to avoid bundling Express if not used\n  // eslint-disable-next-line @typescript-eslint/no-var-requires\n  const express = require('express');\n  const router: Router = express.Router();\n\n  // Add CORS middleware if configured\n  if (config.cors) {\n    router.use(createCORSMiddleware(config.cors));\n  }\n\n  // Add body parser if requested\n  if (config.useBodyParser) {\n    router.use(express.json());\n  }\n\n  // Add authentication middleware if configured\n  if (config.authenticate) {\n    router.use(async (req: Request, res: Response, next: NextFunction) => {\n      try {\n        const authenticated = await config.authenticate!(req);\n        if (!authenticated) {\n          res.status(401).json(wrapError('Unauthorized', 'UNAUTHORIZED'));\n          return;\n        }\n        next();\n      } catch (error) {\n        res.status(500).json(wrapError(error as Error, 'AUTH_ERROR'));\n      }\n    });\n  }\n\n  // Register routes\n  for (const route of UI_BRIDGE_ROUTES) {\n    const method = route.method.toLowerCase() as 'get' | 'post' | 'put' | 'delete' | 'patch';\n    const path = route.path;\n    const handlerName = route.handler as keyof UIBridgeServerHandlers;\n    const handler = handlers[handlerName];\n\n    if (!handler) {\n      console.warn(`Handler not found for route: ${route.method} ${route.path}`);\n      continue;\n    }\n\n    router[method](\n      path,\n      createRouteHandler(route, handler as (...args: unknown[]) => Promise<APIResponse<unknown>>)\n    );\n  }\n\n  return router;\n}\n\n/**\n * Create a route handler from a route definition\n */\nfunction createRouteHandler(\n  route: RouteDefinition,\n  handler: (...args: unknown[]) => Promise<APIResponse<unknown>>\n) {\n  return async (req: Request, res: Response) => {\n    try {\n      // Extract params\n      const args: unknown[] = [];\n\n      if (route.params) {\n        for (const param of route.params) {\n          args.push(req.params[param]);\n        }\n      }\n\n      // Add body if required\n      if (route.bodyRequired || route.method === 'POST') {\n        args.push(req.body);\n      }\n\n      // Add query params for GET requests\n      if (route.method === 'GET' && Object.keys(req.query).length > 0) {\n        args.push(req.query);\n      }\n\n      const result = await handler(...args);\n      res.json(result);\n    } catch (error) {\n      res.status(500).json(wrapError(error as Error, 'INTERNAL_ERROR'));\n    }\n  };\n}\n\n/**\n * Create Express app with UI Bridge routes\n *\n * Convenience function that creates a complete Express app with UI Bridge.\n */\nexport function createExpressApp(\n  handlers: UIBridgeServerHandlers,\n  config: ExpressAdapterConfig = {}\n): unknown {\n  // eslint-disable-next-line @typescript-eslint/no-var-requires\n  const express = require('express');\n  const app = express();\n\n  app.use(express.json());\n\n  const basePath = config.basePath || '/ui-bridge';\n  const router = createExpressRouter(handlers, { ...config, useBodyParser: false });\n\n  app.use(basePath, router);\n\n  // Health check\n  app.get('/health', (_req: Request, res: Response) => {\n    res.json({ status: 'ok', timestamp: Date.now() });\n  });\n\n  return app;\n}\n\n/**\n * Express middleware that adds UI Bridge to an existing app\n */\nexport function uiBridgeMiddleware(\n  handlers: UIBridgeServerHandlers,\n  config: ExpressAdapterConfig = {}\n): Router {\n  return createExpressRouter(handlers, config);\n}\n"]}