@cuekit-ai/react 1.3.4 → 1.5.0

package/dist/index.d.mts

@@ -62,47 +62,6 @@ type MicButtonProps = {
 
 declare const MicButton: React__default.FC<MicButtonProps>;
 
-interface ChatPopupProps {
-    isOpen: boolean;
-    isMinimized: boolean;
-    onClose: () => void;
-    onMinimize: () => void;
-    onRestore: () => void;
-    onSendText: (text: string) => Promise<any>;
-    onEndCall?: () => Promise<void>;
-    messages: Array<{
-        text: string;
-        sender: 'user' | 'assistant';
-    }>;
-    isConnected: boolean;
-    micState: string;
-    participants: string[];
-    error?: string | null;
-    currentTheme?: 'light' | 'dark';
-    onThemeToggle?: (theme: 'light' | 'dark') => void;
-    status?: string;
-    anchor?: {
-        position: 'bottom-right' | 'bottom-left' | 'bottom-center';
-        bottom: number;
-        size: number;
-    };
-}
-declare const ChatPopup: React__default.FC<ChatPopupProps>;
-
-interface BorderGlowProps {
-    isActive: boolean;
-}
-declare const BorderGlow: ({ isActive }: BorderGlowProps) => React__default.JSX.Element | null;
-
-interface VoiceIntensityVisualizerProps {
-    isActive: boolean;
-    barCount?: number;
-    minHeight?: number;
-    className?: string;
-    buttonSize?: number;
-}
-declare const VoiceIntensityVisualizer: React__default.FC<VoiceIntensityVisualizerProps>;
-
 interface AuthResponse {
     session_id: string;
     api_key: string;
@@ -129,25 +88,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>;
@@ -170,6 +119,10 @@ interface ChatMessage {
     timestamp: string;
 }
 type MicState = 'idle' | 'listening' | 'thinking' | 'replying';
+interface MuteState {
+    isMuted: boolean;
+    canMute: boolean;
+}
 declare const useCuekit: (options?: {
     onNavigationCommand?: (command: NavigationCommand) => void;
     onConnectionStateChange?: (state: ConnectionState) => void;
@@ -185,6 +138,10 @@ declare const useCuekit: (options?: {
     setStatus: React.Dispatch<React.SetStateAction<string>>;
     connect: (identity: string, apiKey?: string, appId?: string) => Promise<void>;
     disconnect: () => Promise<void>;
+    muteState: MuteState;
+    toggleMute: () => Promise<void>;
+    setMute: (muted: boolean) => Promise<void>;
+    sendChatMessage: (message: string) => Promise<void>;
     isConnected: boolean;
     isConnecting: boolean;
     connectionState: ConnectionState | null;
@@ -199,6 +156,49 @@ declare const useCuekit: (options?: {
     audioContainerRef: React.RefObject<HTMLDivElement>;
 };
 
+interface ChatPopupProps {
+    isOpen: boolean;
+    isMinimized: boolean;
+    onClose: () => void;
+    onMinimize: () => void;
+    onRestore: () => void;
+    onSendText: (text: string) => Promise<any>;
+    onEndCall?: () => Promise<void>;
+    messages: Array<{
+        text: string;
+        sender: 'user' | 'assistant';
+    }>;
+    isConnected: boolean;
+    micState: string;
+    participants: string[];
+    error?: string | null;
+    currentTheme?: 'light' | 'dark';
+    onThemeToggle?: (theme: 'light' | 'dark') => void;
+    status?: string;
+    anchor?: {
+        position: 'bottom-right' | 'bottom-left' | 'bottom-center';
+        bottom: number;
+        size: number;
+    };
+    muteState?: MuteState;
+    onToggleMute?: () => Promise<void>;
+}
+declare const ChatPopup: React__default.FC<ChatPopupProps>;
+
+interface BorderGlowProps {
+    isActive: boolean;
+}
+declare const BorderGlow: ({ isActive }: BorderGlowProps) => React__default.JSX.Element | null;
+
+interface VoiceIntensityVisualizerProps {
+    isActive: boolean;
+    barCount?: number;
+    minHeight?: number;
+    className?: string;
+    buttonSize?: number;
+}
+declare const VoiceIntensityVisualizer: React__default.FC<VoiceIntensityVisualizerProps>;
+
 declare const useWebRTC: (options?: {
     onNavigationCommand?: (command: NavigationCommand) => void;
     onConnectionStateChange?: (state: ConnectionState) => void;
@@ -254,20 +254,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 +268,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 +296,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 MuteState, 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 };

package/dist/index.d.ts

@@ -62,47 +62,6 @@ type MicButtonProps = {
 
 declare const MicButton: React__default.FC<MicButtonProps>;
 
-interface ChatPopupProps {
-    isOpen: boolean;
-    isMinimized: boolean;
-    onClose: () => void;
-    onMinimize: () => void;
-    onRestore: () => void;
-    onSendText: (text: string) => Promise<any>;
-    onEndCall?: () => Promise<void>;
-    messages: Array<{
-        text: string;
-        sender: 'user' | 'assistant';
-    }>;
-    isConnected: boolean;
-    micState: string;
-    participants: string[];
-    error?: string | null;
-    currentTheme?: 'light' | 'dark';
-    onThemeToggle?: (theme: 'light' | 'dark') => void;
-    status?: string;
-    anchor?: {
-        position: 'bottom-right' | 'bottom-left' | 'bottom-center';
-        bottom: number;
-        size: number;
-    };
-}
-declare const ChatPopup: React__default.FC<ChatPopupProps>;
-
-interface BorderGlowProps {
-    isActive: boolean;
-}
-declare const BorderGlow: ({ isActive }: BorderGlowProps) => React__default.JSX.Element | null;
-
-interface VoiceIntensityVisualizerProps {
-    isActive: boolean;
-    barCount?: number;
-    minHeight?: number;
-    className?: string;
-    buttonSize?: number;
-}
-declare const VoiceIntensityVisualizer: React__default.FC<VoiceIntensityVisualizerProps>;
-
 interface AuthResponse {
     session_id: string;
     api_key: string;
@@ -129,25 +88,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>;
@@ -170,6 +119,10 @@ interface ChatMessage {
     timestamp: string;
 }
 type MicState = 'idle' | 'listening' | 'thinking' | 'replying';
+interface MuteState {
+    isMuted: boolean;
+    canMute: boolean;
+}
 declare const useCuekit: (options?: {
     onNavigationCommand?: (command: NavigationCommand) => void;
     onConnectionStateChange?: (state: ConnectionState) => void;
@@ -185,6 +138,10 @@ declare const useCuekit: (options?: {
     setStatus: React.Dispatch<React.SetStateAction<string>>;
     connect: (identity: string, apiKey?: string, appId?: string) => Promise<void>;
     disconnect: () => Promise<void>;
+    muteState: MuteState;
+    toggleMute: () => Promise<void>;
+    setMute: (muted: boolean) => Promise<void>;
+    sendChatMessage: (message: string) => Promise<void>;
     isConnected: boolean;
     isConnecting: boolean;
     connectionState: ConnectionState | null;
@@ -199,6 +156,49 @@ declare const useCuekit: (options?: {
     audioContainerRef: React.RefObject<HTMLDivElement>;
 };
 
+interface ChatPopupProps {
+    isOpen: boolean;
+    isMinimized: boolean;
+    onClose: () => void;
+    onMinimize: () => void;
+    onRestore: () => void;
+    onSendText: (text: string) => Promise<any>;
+    onEndCall?: () => Promise<void>;
+    messages: Array<{
+        text: string;
+        sender: 'user' | 'assistant';
+    }>;
+    isConnected: boolean;
+    micState: string;
+    participants: string[];
+    error?: string | null;
+    currentTheme?: 'light' | 'dark';
+    onThemeToggle?: (theme: 'light' | 'dark') => void;
+    status?: string;
+    anchor?: {
+        position: 'bottom-right' | 'bottom-left' | 'bottom-center';
+        bottom: number;
+        size: number;
+    };
+    muteState?: MuteState;
+    onToggleMute?: () => Promise<void>;
+}
+declare const ChatPopup: React__default.FC<ChatPopupProps>;
+
+interface BorderGlowProps {
+    isActive: boolean;
+}
+declare const BorderGlow: ({ isActive }: BorderGlowProps) => React__default.JSX.Element | null;
+
+interface VoiceIntensityVisualizerProps {
+    isActive: boolean;
+    barCount?: number;
+    minHeight?: number;
+    className?: string;
+    buttonSize?: number;
+}
+declare const VoiceIntensityVisualizer: React__default.FC<VoiceIntensityVisualizerProps>;
+
 declare const useWebRTC: (options?: {
     onNavigationCommand?: (command: NavigationCommand) => void;
     onConnectionStateChange?: (state: ConnectionState) => void;
@@ -254,20 +254,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 +268,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 +296,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 MuteState, 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 };