@cuekit-ai/react 1.3.4 → 1.4.0

package/dist/index.d.ts

@@ -129,25 +129,15 @@ interface ServerConfig {
     token_ttl_seconds: number;
     server_version: string;
 }
+interface AIIntentData {
+    actionType: 'navigate' | 'click' | 'input' | 'scroll';
+    routeName?: string;
+    elementId?: string;
+}
 interface NavigationCommand {
-    type: 'static_data_ready' | 'ai_intent' | 'user_speech_text' | 'ai_speech_text';
-    data?: {
-        app_id?: string;
-        components?: any[];
-        intents?: any[];
-        pages_count?: number;
-        elements_count?: number;
-    };
-    intent?: string;
-    actionType?: string;
-    text?: string;
-    confidence?: number;
-    target_element?: string;
-    current_page?: string;
-    user_input?: string;
-    speaker?: 'user' | 'ai';
-    duration?: number;
+    type: 'ai_intent';
     timestamp?: number;
+    data: AIIntentData;
 }
 declare function sendData(data: string, reliable?: boolean): Promise<void>;
 declare function sendScreenStatus(screenData: any): Promise<void>;
@@ -254,20 +244,13 @@ declare const initWebRTCWithDeployedBackend: (apiKey: string, customConfig?: Par
  */
 declare const initWebRTC: (apiKey: string) => WebRTCServerConfig;
 
-interface InteractiveElementDto {
-    testID: string;
-    type: string;
-    textContent: string;
-    tags: string[];
-}
+type InteractiveElement = {
+    [btnId: string]: string[];
+};
 interface DOMStructurePayload {
-    components: InteractiveElementDto[];
+    components: InteractiveElement;
 }
 
-/**
- * Capture the full DOM structure as a flat list of interactive elements
- */
-declare function captureFullDOMStructure(): DOMStructurePayload;
 interface ElementAction {
     action_type: 'click' | 'navigate' | 'input' | 'focus' | 'toggle';
     target_element?: string;
@@ -275,7 +258,23 @@ interface ElementAction {
     instruction?: string;
 }
 declare function executeAction(action: ElementAction): boolean;
-declare function getFullDOMStructure(): DOMStructurePayload;
+/**
+ * Captures ALL interactive elements on the page.
+ * Uses pre-assigned IDs (data-ansyr-static, data-ansyr-dynamic) when available,
+ * otherwise calculates stable DOM IDs for elements without pre-assigned IDs.
+ *
+ * This ensures comprehensive coverage of all interactive elements for AI interaction.
+ */
+declare function captureAllInteractiveElements(): DOMStructurePayload;
+/**
+ * Clears the element cache. Call this when the DOM structure changes significantly.
+ */
+declare function clearElementCache(): void;
+/**
+ * Validates dynamic elements in development mode.
+ * Checks for duplicate IDs and provides warnings.
+ */
+declare function validateDynamicElements(): void;
 
 /**
  * Generates a stable, unique 8-character ID for an interactive element.
@@ -287,4 +286,15 @@ declare function getFullDOMStructure(): DOMStructurePayload;
  */
 declare function generateDynamicId(routePath: string, elementIdentifier: string): string;
 
-export { BorderGlow, ChatPopup, type ChatPopupProps, CuekitProvider, type DOMStructurePayload, type ElementAction, InitCuekit, type InteractiveElementDto, MicButton, type MicButtonProps, type MicState$1 as MicState, type NavigationCommand, type ServerConfig, type TokenRequest, type TokenResponse, VoiceIntensityVisualizer, type WebRTCServerConfig, captureFullDOMStructure, configureWebRTCServer, executeAction, generateDynamicId, getFullDOMStructure, getWebRTCServerConfig, initWebRTC, initWebRTCWithDeployedBackend, useCuekit, useQubeContext, useWebRTC };
+/**
+ * Extracts route parameters from the current URL path.
+ * For routes like /form/:id, extracts { id: "123" } from /form/123
+ */
+declare function getCurrentPathParams(): Record<string, string>;
+/**
+ * Resolves a route path with parameters.
+ * Example: resolveRoutePath('/form/:id', { id: '123' }) -> '/form/123'
+ */
+declare function resolveRoutePath(routePath: string, params: Record<string, string>): string;
+
+export { BorderGlow, ChatPopup, type ChatPopupProps, CuekitProvider, type DOMStructurePayload, type ElementAction, InitCuekit, type InteractiveElement, MicButton, type MicButtonProps, type MicState$1 as MicState, type NavigationCommand, type ServerConfig, type TokenRequest, type TokenResponse, VoiceIntensityVisualizer, type WebRTCServerConfig, captureAllInteractiveElements, clearElementCache, configureWebRTCServer, executeAction, generateDynamicId, getCurrentPathParams, getWebRTCServerConfig, initWebRTC, initWebRTCWithDeployedBackend, resolveRoutePath, useCuekit, useQubeContext, useWebRTC, validateDynamicElements };