@qontinui/ui-bridge 0.2.0 → 0.3.1

package/dist/standalone-B6GLIEmR.d.ts

@@ -0,0 +1,216 @@
+import { c as UIBridgeServerHandlers, U as UIBridgeServerConfig, W as WebSocketMessage } from './types-B2EfvEaq.js';
+import { j as BridgeEvent } from './types-suaYwWWg.js';
+
+/**
+ * WebSocket Handler for UI Bridge Server
+ *
+ * Handles WebSocket connections and message routing.
+ */
+
+/**
+ * WebSocket-like interface for compatibility
+ */
+interface WebSocketLike {
+    send(data: string): void;
+    close(): void;
+    readyState: number;
+    onmessage?: ((event: {
+        data: string;
+    }) => void) | null;
+    onclose?: (() => void) | null;
+    onerror?: ((error: unknown) => void) | null;
+}
+/**
+ * WebSocket handler for UI Bridge server
+ */
+declare class UIBridgeWSHandler {
+    private handlers;
+    private clients;
+    private verbose;
+    private log;
+    constructor(handlers: UIBridgeServerHandlers, options?: {
+        verbose?: boolean;
+        log?: (message: string) => void;
+    });
+    /**
+     * Handle new WebSocket connection
+     */
+    handleConnection(ws: WebSocketLike): string;
+    /**
+     * Handle client disconnect
+     */
+    handleDisconnect(clientId: string): void;
+    /**
+     * Handle incoming message
+     */
+    private handleMessage;
+    /**
+     * Handle ping message
+     */
+    private handlePing;
+    /**
+     * Handle subscribe message
+     */
+    private handleSubscribe;
+    /**
+     * Handle unsubscribe message
+     */
+    private handleUnsubscribe;
+    /**
+     * Handle find message
+     */
+    private handleFind;
+    /**
+     * Handle getElement message
+     */
+    private handleGetElement;
+    /**
+     * Handle getSnapshot message
+     */
+    private handleGetSnapshot;
+    /**
+     * Handle executeAction message
+     */
+    private handleExecuteAction;
+    /**
+     * Handle executeComponentAction message
+     */
+    private handleExecuteComponentAction;
+    /**
+     * Handle executeWorkflow message
+     */
+    private handleExecuteWorkflow;
+    /**
+     * Broadcast event to all subscribed clients
+     */
+    broadcastEvent(event: BridgeEvent): void;
+    /**
+     * Send message to specific client
+     */
+    private sendToClient;
+    /**
+     * Send response message
+     */
+    private sendResponse;
+    /**
+     * Send error message
+     */
+    private sendError;
+    /**
+     * Get connected client count
+     */
+    get clientCount(): number;
+    /**
+     * Get all connected client IDs
+     */
+    get clientIds(): string[];
+    /**
+     * Disconnect all clients
+     */
+    disconnectAll(): void;
+}
+
+/**
+ * Standalone Server
+ *
+ * Standalone HTTP server for UI Bridge that can run independently.
+ * Supports both HTTP and WebSocket connections.
+ */
+
+/**
+ * Standalone server configuration
+ */
+interface StandaloneServerConfig extends UIBridgeServerConfig {
+    /** Host to bind to */
+    host?: string;
+    /** Port to listen on */
+    port?: number;
+    /** Enable WebSocket support */
+    websocket?: boolean;
+    /** WebSocket port (defaults to port) */
+    websocketPort?: number;
+    /** Logging function */
+    log?: (message: string) => void;
+}
+/**
+ * Simple HTTP server implementation using Node.js built-in http module
+ * with optional WebSocket support.
+ */
+declare class StandaloneServer {
+    private server;
+    private wsServer;
+    private config;
+    private handlers;
+    private wsHandler;
+    private wsConnections;
+    constructor(handlers: UIBridgeServerHandlers, config?: StandaloneServerConfig);
+    /**
+     * Get enabled capabilities based on handlers
+     */
+    private getCapabilities;
+    /**
+     * Start the server
+     */
+    start(): Promise<void>;
+    /**
+     * Start WebSocket server
+     */
+    private startWebSocketServer;
+    /**
+     * Stop the server
+     */
+    stop(): Promise<void>;
+    /**
+     * Handle an HTTP request
+     */
+    private handleRequest;
+    /**
+     * Find a matching route
+     */
+    private findRoute;
+    /**
+     * Extract params from path
+     */
+    private extractParams;
+    /**
+     * Parse request body
+     */
+    private parseBody;
+    /**
+     * Send JSON response
+     */
+    private sendJSON;
+    /**
+     * Broadcast a message to all WebSocket connections (legacy)
+     */
+    broadcast(message: WebSocketMessage): void;
+    /**
+     * Broadcast an event to all subscribed WebSocket clients
+     */
+    broadcastEvent(event: BridgeEvent): void;
+    /**
+     * Get WebSocket handler for direct access
+     */
+    getWSHandler(): UIBridgeWSHandler | null;
+    /**
+     * Get number of connected WebSocket clients
+     */
+    get wsClientCount(): number;
+    /**
+     * Get the server address
+     */
+    getAddress(): {
+        host: string;
+        port: number;
+    } | null;
+}
+/**
+ * Create and start a standalone server
+ */
+declare function createStandaloneServer(handlers: UIBridgeServerHandlers, config?: StandaloneServerConfig): Promise<StandaloneServer>;
+/**
+ * CLI entry point
+ */
+declare function startCLI(handlers: UIBridgeServerHandlers, args?: string[]): Promise<void>;
+
+export { StandaloneServer as S, UIBridgeWSHandler as U, type WebSocketLike as W, type StandaloneServerConfig as a, createStandaloneServer as c, startCLI as s };

package/dist/standalone-CjdYqj3P.d.mts

@@ -0,0 +1,216 @@
+import { c as UIBridgeServerHandlers, U as UIBridgeServerConfig, W as WebSocketMessage } from './types-gO696T_t.mjs';
+import { j as BridgeEvent } from './types-suaYwWWg.mjs';
+
+/**
+ * WebSocket Handler for UI Bridge Server
+ *
+ * Handles WebSocket connections and message routing.
+ */
+
+/**
+ * WebSocket-like interface for compatibility
+ */
+interface WebSocketLike {
+    send(data: string): void;
+    close(): void;
+    readyState: number;
+    onmessage?: ((event: {
+        data: string;
+    }) => void) | null;
+    onclose?: (() => void) | null;
+    onerror?: ((error: unknown) => void) | null;
+}
+/**
+ * WebSocket handler for UI Bridge server
+ */
+declare class UIBridgeWSHandler {
+    private handlers;
+    private clients;
+    private verbose;
+    private log;
+    constructor(handlers: UIBridgeServerHandlers, options?: {
+        verbose?: boolean;
+        log?: (message: string) => void;
+    });
+    /**
+     * Handle new WebSocket connection
+     */
+    handleConnection(ws: WebSocketLike): string;
+    /**
+     * Handle client disconnect
+     */
+    handleDisconnect(clientId: string): void;
+    /**
+     * Handle incoming message
+     */
+    private handleMessage;
+    /**
+     * Handle ping message
+     */
+    private handlePing;
+    /**
+     * Handle subscribe message
+     */
+    private handleSubscribe;
+    /**
+     * Handle unsubscribe message
+     */
+    private handleUnsubscribe;
+    /**
+     * Handle find message
+     */
+    private handleFind;
+    /**
+     * Handle getElement message
+     */
+    private handleGetElement;
+    /**
+     * Handle getSnapshot message
+     */
+    private handleGetSnapshot;
+    /**
+     * Handle executeAction message
+     */
+    private handleExecuteAction;
+    /**
+     * Handle executeComponentAction message
+     */
+    private handleExecuteComponentAction;
+    /**
+     * Handle executeWorkflow message
+     */
+    private handleExecuteWorkflow;
+    /**
+     * Broadcast event to all subscribed clients
+     */
+    broadcastEvent(event: BridgeEvent): void;
+    /**
+     * Send message to specific client
+     */
+    private sendToClient;
+    /**
+     * Send response message
+     */
+    private sendResponse;
+    /**
+     * Send error message
+     */
+    private sendError;
+    /**
+     * Get connected client count
+     */
+    get clientCount(): number;
+    /**
+     * Get all connected client IDs
+     */
+    get clientIds(): string[];
+    /**
+     * Disconnect all clients
+     */
+    disconnectAll(): void;
+}
+
+/**
+ * Standalone Server
+ *
+ * Standalone HTTP server for UI Bridge that can run independently.
+ * Supports both HTTP and WebSocket connections.
+ */
+
+/**
+ * Standalone server configuration
+ */
+interface StandaloneServerConfig extends UIBridgeServerConfig {
+    /** Host to bind to */
+    host?: string;
+    /** Port to listen on */
+    port?: number;
+    /** Enable WebSocket support */
+    websocket?: boolean;
+    /** WebSocket port (defaults to port) */
+    websocketPort?: number;
+    /** Logging function */
+    log?: (message: string) => void;
+}
+/**
+ * Simple HTTP server implementation using Node.js built-in http module
+ * with optional WebSocket support.
+ */
+declare class StandaloneServer {
+    private server;
+    private wsServer;
+    private config;
+    private handlers;
+    private wsHandler;
+    private wsConnections;
+    constructor(handlers: UIBridgeServerHandlers, config?: StandaloneServerConfig);
+    /**
+     * Get enabled capabilities based on handlers
+     */
+    private getCapabilities;
+    /**
+     * Start the server
+     */
+    start(): Promise<void>;
+    /**
+     * Start WebSocket server
+     */
+    private startWebSocketServer;
+    /**
+     * Stop the server
+     */
+    stop(): Promise<void>;
+    /**
+     * Handle an HTTP request
+     */
+    private handleRequest;
+    /**
+     * Find a matching route
+     */
+    private findRoute;
+    /**
+     * Extract params from path
+     */
+    private extractParams;
+    /**
+     * Parse request body
+     */
+    private parseBody;
+    /**
+     * Send JSON response
+     */
+    private sendJSON;
+    /**
+     * Broadcast a message to all WebSocket connections (legacy)
+     */
+    broadcast(message: WebSocketMessage): void;
+    /**
+     * Broadcast an event to all subscribed WebSocket clients
+     */
+    broadcastEvent(event: BridgeEvent): void;
+    /**
+     * Get WebSocket handler for direct access
+     */
+    getWSHandler(): UIBridgeWSHandler | null;
+    /**
+     * Get number of connected WebSocket clients
+     */
+    get wsClientCount(): number;
+    /**
+     * Get the server address
+     */
+    getAddress(): {
+        host: string;
+        port: number;
+    } | null;
+}
+/**
+ * Create and start a standalone server
+ */
+declare function createStandaloneServer(handlers: UIBridgeServerHandlers, config?: StandaloneServerConfig): Promise<StandaloneServer>;
+/**
+ * CLI entry point
+ */
+declare function startCLI(handlers: UIBridgeServerHandlers, args?: string[]): Promise<void>;
+
+export { StandaloneServer as S, UIBridgeWSHandler as U, type WebSocketLike as W, type StandaloneServerConfig as a, createStandaloneServer as c, startCLI as s };

package/dist/swc-plugin/index.d.mts

@@ -0,0 +1,79 @@
+/**
+ * UI Bridge SWC Plugin Configuration
+ */
+interface UIBridgeSwcPluginConfig {
+    /**
+     * Elements to automatically instrument
+     * @default ['button', 'input', 'select', 'textarea', 'a', 'form']
+     */
+    elements?: string[];
+    /**
+     * Prefix for generated IDs
+     * @default 'ui'
+     */
+    idPrefix?: string;
+    /**
+     * Attribute name for the generated ID
+     * @default 'data-ui-id'
+     */
+    idAttribute?: string;
+    /**
+     * Attribute name for aliases
+     * @default 'data-ui-aliases'
+     */
+    aliasesAttribute?: string;
+    /**
+     * Attribute name for element type
+     * @default 'data-ui-type'
+     */
+    typeAttribute?: string;
+    /**
+     * Generate aliases from text content
+     * @default true
+     */
+    generateAliases?: boolean;
+    /**
+     * Include component name in generated ID
+     * @default true
+     */
+    includeComponentName?: boolean;
+    /**
+     * Include file path in generated ID
+     * @default false
+     */
+    includeFilePath?: boolean;
+    /**
+     * Hash the generated ID for shorter strings
+     * @default false
+     */
+    hashIds?: boolean;
+    /**
+     * Maximum alias count per element
+     * @default 5
+     */
+    maxAliases?: number;
+    /**
+     * Skip elements that already have data-ui-id
+     * @default true
+     */
+    skipExisting?: boolean;
+    /**
+     * Only instrument elements inside components with specific names
+     * @default []
+     */
+    onlyInComponents?: string[];
+    /**
+     * Skip instrumentation for elements inside these components
+     * @default []
+     */
+    skipInComponents?: string[];
+    /**
+     * Enable verbose logging during build
+     * @default false
+     */
+    verbose?: boolean;
+}
+
+declare const pluginPath: string;
+
+export { type UIBridgeSwcPluginConfig, pluginPath as default };

package/dist/swc-plugin/index.d.ts

@@ -0,0 +1,79 @@
+/**
+ * UI Bridge SWC Plugin Configuration
+ */
+interface UIBridgeSwcPluginConfig {
+    /**
+     * Elements to automatically instrument
+     * @default ['button', 'input', 'select', 'textarea', 'a', 'form']
+     */
+    elements?: string[];
+    /**
+     * Prefix for generated IDs
+     * @default 'ui'
+     */
+    idPrefix?: string;
+    /**
+     * Attribute name for the generated ID
+     * @default 'data-ui-id'
+     */
+    idAttribute?: string;
+    /**
+     * Attribute name for aliases
+     * @default 'data-ui-aliases'
+     */
+    aliasesAttribute?: string;
+    /**
+     * Attribute name for element type
+     * @default 'data-ui-type'
+     */
+    typeAttribute?: string;
+    /**
+     * Generate aliases from text content
+     * @default true
+     */
+    generateAliases?: boolean;
+    /**
+     * Include component name in generated ID
+     * @default true
+     */
+    includeComponentName?: boolean;
+    /**
+     * Include file path in generated ID
+     * @default false
+     */
+    includeFilePath?: boolean;
+    /**
+     * Hash the generated ID for shorter strings
+     * @default false
+     */
+    hashIds?: boolean;
+    /**
+     * Maximum alias count per element
+     * @default 5
+     */
+    maxAliases?: number;
+    /**
+     * Skip elements that already have data-ui-id
+     * @default true
+     */
+    skipExisting?: boolean;
+    /**
+     * Only instrument elements inside components with specific names
+     * @default []
+     */
+    onlyInComponents?: string[];
+    /**
+     * Skip instrumentation for elements inside these components
+     * @default []
+     */
+    skipInComponents?: string[];
+    /**
+     * Enable verbose logging during build
+     * @default false
+     */
+    verbose?: boolean;
+}
+
+declare const pluginPath: string;
+
+export { type UIBridgeSwcPluginConfig, pluginPath as default };

package/dist/swc-plugin/index.js

@@ -0,0 +1,15 @@
+'use strict';
+
+var path = require('path');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var path__default = /*#__PURE__*/_interopDefault(path);
+
+// src/swc-plugin/index.ts
+var pluginPath = path__default.default.join(__dirname, "..", "..", "swc-plugin-wasm", "ui_bridge_swc_plugin.wasm");
+var swc_plugin_default = pluginPath;
+
+module.exports = swc_plugin_default;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/swc-plugin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/swc-plugin/index.ts"],"names":["path"],"mappings":";;;;;;;;;AAqBA,IAAM,aAAaA,qBAAA,CAAK,IAAA,CAAK,WAAW,IAAA,EAAM,IAAA,EAAM,mBAAmB,2BAA2B,CAAA;AAElG,IAAO,kBAAA,GAAQ","file":"index.js","sourcesContent":["/**\n * SWC Plugin for UI Bridge\n *\n * Provides the path to the pre-built WASM plugin binary.\n *\n * @example\n * ```js\n * // next.config.js\n * const swcPluginPath = require('@qontinui/ui-bridge/swc-plugin').default;\n *\n * module.exports = {\n *   experimental: {\n *     swcPlugins: [[swcPluginPath, { elements: ['button', 'input'] }]]\n *   }\n * };\n * ```\n */\nimport path from 'path';\n\nexport type { UIBridgeSwcPluginConfig } from './types';\n\nconst pluginPath = path.join(__dirname, '..', '..', 'swc-plugin-wasm', 'ui_bridge_swc_plugin.wasm');\n\nexport default pluginPath;\n"]}

package/dist/swc-plugin/index.mjs

@@ -0,0 +1,9 @@
+import path from 'path';
+
+// src/swc-plugin/index.ts
+var pluginPath = path.join(__dirname, "..", "..", "swc-plugin-wasm", "ui_bridge_swc_plugin.wasm");
+var swc_plugin_default = pluginPath;
+
+export { swc_plugin_default as default };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/swc-plugin/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/swc-plugin/index.ts"],"names":[],"mappings":";;;AAqBA,IAAM,aAAa,IAAA,CAAK,IAAA,CAAK,WAAW,IAAA,EAAM,IAAA,EAAM,mBAAmB,2BAA2B,CAAA;AAElG,IAAO,kBAAA,GAAQ","file":"index.mjs","sourcesContent":["/**\n * SWC Plugin for UI Bridge\n *\n * Provides the path to the pre-built WASM plugin binary.\n *\n * @example\n * ```js\n * // next.config.js\n * const swcPluginPath = require('@qontinui/ui-bridge/swc-plugin').default;\n *\n * module.exports = {\n *   experimental: {\n *     swcPlugins: [[swcPluginPath, { elements: ['button', 'input'] }]]\n *   }\n * };\n * ```\n */\nimport path from 'path';\n\nexport type { UIBridgeSwcPluginConfig } from './types';\n\nconst pluginPath = path.join(__dirname, '..', '..', 'swc-plugin-wasm', 'ui_bridge_swc_plugin.wasm');\n\nexport default pluginPath;\n"]}