@cuekit-ai/react 1.3.1 → 1.3.3

package/dist/{chunk-PLOG3DEN.mjs → chunk-ZGHSIEXZ.mjs}

@@ -4,7 +4,13 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __commonJS = (cb, mod) => function __require() {
+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');
+});
+var __commonJS = (cb, mod) => function __require2() {
   return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
 };
 var __export = (target, all) => {
@@ -22670,49 +22676,6 @@ var setWebRTCConnectionState = (state) => {
 // src/constants/index.ts
 var WEBRTC_BACKEND_SERVER_URL = "https://api-webrtc-dev.ansyr.ai";
 
-// src/utils/jsx-encoder.ts
-function generateStableDOMId(element) {
-  const tagName = element.tagName.toLowerCase();
-  const text = (element.textContent || "").trim().substring(0, 50);
-  let sibling = element.previousElementSibling;
-  let position = 1;
-  while (sibling) {
-    if (sibling.tagName === element.tagName) {
-      position++;
-    }
-    sibling = sibling.previousElementSibling;
-  }
-  const path = getElementPath(element);
-  const idString = `${tagName}[${position}]_(${text})_${path}`;
-  let hash = 0;
-  for (let i = 0; i < idString.length; i++) {
-    const char = idString.charCodeAt(i);
-    hash = (hash << 5) - hash + char;
-    hash |= 0;
-  }
-  return hash.toString(36);
-}
-function getElementPath(element) {
-  if (element.id) {
-    return `id(${element.id})`;
-  }
-  if (element.tagName.toLowerCase() === "body") {
-    return "/body";
-  }
-  let ix = 0;
-  const siblings = element.parentNode?.children || new HTMLCollection();
-  for (let i = 0; i < siblings.length; i++) {
-    const sibling = siblings[i];
-    if (sibling === element) {
-      return `${getElementPath(element.parentNode)}/${element.tagName}[${ix + 1}]`;
-    }
-    if (sibling.nodeType === 1 && sibling.tagName === element.tagName) {
-      ix++;
-    }
-  }
-  return "not_found";
-}
-
 // src/core/intent-store.ts
 var store = {
   screenMetadata: {},
@@ -22743,18 +22706,14 @@ var GlobalStore = {
   setElement(elementData) {
     const index = store.allElementsData.findIndex((e2) => e2.elementId === elementData.elementId);
     if (index >= 0) {
-      console.log("Updating existing element");
       store.allElementsData[index] = elementData;
     } else {
-      console.log("Adding new element");
       store.allElementsData.push(elementData);
     }
   },
   getElementById(elementId) {
     const match = store.allElementsData.find((e2) => e2.elementId === elementId);
     if (!match) {
-      console.warn(`[GlobalStore] No element found for ID: ${elementId}`);
-      console.log("All elements in store:", store.allElementsData);
     }
     return match;
   },
@@ -22779,7 +22738,6 @@ function navigate(path, params) {
     try {
       navigationHandler(absolutePath, safeParams);
     } catch (error) {
-      console.error("[CueKit] navigation handler failed, falling back to default:", error);
     }
     return;
   }
@@ -22810,7 +22768,6 @@ var safeNavigate = (name, params = {}) => {
   if (name) {
     navigate(name, params);
   } else {
-    console.warn("[CueKit] route name not provided");
   }
 };
 function getCurrentScreenName() {
@@ -22845,7 +22802,6 @@ function onStateChange() {
       const metadata = JSON.parse(params.metadata);
       GlobalStore.setMetadata(routeName, metadata);
     } catch (error) {
-      console.error("Failed to parse metadata from URL:", error);
     }
   }
 }
@@ -22868,7 +22824,7 @@ var handleNavigationAndClick = (routeName, elementHash) => {
             }
             sibling = sibling.previousElementSibling;
           }
-          const path = getElementPath2(element);
+          const path = getElementPath(element);
           const idString = `${tagName}[${position}]_(${text})_${path}`;
           let hash = 0;
           for (let i = 0; i < idString.length; i++) {
@@ -22891,7 +22847,7 @@ var handleNavigationAndClick = (routeName, elementHash) => {
   });
   observer.observe(document.body, { childList: true, subtree: true });
 };
-function getElementPath2(element) {
+function getElementPath(element) {
   if (element.id) {
     return `id(${element.id})`;
   }
@@ -22912,10 +22868,54 @@ function getElementPath2(element) {
   return path.join("/");
 }
 
+// src/utils/jsx-encoder.ts
+function generateStableDOMId(element) {
+  const tagName = element.tagName.toLowerCase();
+  const text = (element.textContent || "").trim().substring(0, 50);
+  let sibling = element.previousElementSibling;
+  let position = 1;
+  while (sibling) {
+    if (sibling.tagName === element.tagName) {
+      position++;
+    }
+    sibling = sibling.previousElementSibling;
+  }
+  const path = getElementPath2(element);
+  const idString = `${tagName}[${position}]_(${text})_${path}`;
+  let hash = 0;
+  for (let i = 0; i < idString.length; i++) {
+    const char = idString.charCodeAt(i);
+    hash = (hash << 5) - hash + char;
+    hash |= 0;
+  }
+  return hash.toString(36);
+}
+function getElementPath2(element) {
+  if (element.id) {
+    return `id(${element.id})`;
+  }
+  if (element.tagName.toLowerCase() === "body") {
+    return "/body";
+  }
+  let ix = 0;
+  const siblings = element.parentNode?.children || new HTMLCollection();
+  for (let i = 0; i < siblings.length; i++) {
+    const sibling = siblings[i];
+    if (sibling === element) {
+      return `${getElementPath2(element.parentNode)}/${element.tagName}[${ix + 1}]`;
+    }
+    if (sibling.nodeType === 1 && sibling.tagName === element.tagName) {
+      ix++;
+    }
+  }
+  return "not_found";
+}
+
 // src/utils/element-service.ts
-var INTERACTIVE_ELEMENT_SELECTOR = 'a, button, input, textarea, select, [role="button"], [onclick]';
+var INTERACTIVE_ELEMENT_SELECTOR = 'a, button, input, textarea, select, [role="button"], [onclick], [data-ansyr-static], [data-ansyr-dynamic]';
 function getInteractiveElements() {
-  return document.querySelectorAll(INTERACTIVE_ELEMENT_SELECTOR);
+  const elements = document.querySelectorAll(INTERACTIVE_ELEMENT_SELECTOR);
+  return Array.from(new Set(Array.from(elements)));
 }
 function getImmediateText(element) {
   let text = "";
@@ -22929,38 +22929,56 @@ function getImmediateText(element) {
   return text.trim();
 }
 function captureFullDOMStructure() {
-  console.log("\u{1F333} Capturing full DOM structure...");
-  const components = [];
-  const interactiveElements = getInteractiveElements();
-  interactiveElements.forEach((element) => {
-    if (element instanceof HTMLElement && !element.closest("[data-cuekit-ignore]")) {
-      const nodeData = buildFlatDOMNode(element);
-      if (nodeData) {
-        components.push(nodeData);
-      }
+  console.log("\u{1F333} Capturing full DOM structure for Cuekit...");
+  const interactiveElements = [];
+  const descriptionsMap = /* @__PURE__ */ new Map();
+  document.querySelectorAll("[data-for]").forEach((el) => {
+    const targetId = el.getAttribute("data-for");
+    if (!targetId) return;
+    const tags = [];
+    const description = el.getAttribute("data-ansyr-description");
+    if (description) {
+      tags.push(description);
+    }
+    if (el.textContent) {
+      tags.push(el.textContent.trim());
+    }
+    if (tags.length > 0) {
+      const existingTags = descriptionsMap.get(targetId) || [];
+      descriptionsMap.set(targetId, [...existingTags, ...tags]);
     }
   });
-  const result = { components };
+  const allElements = getInteractiveElements();
+  allElements.forEach((element) => {
+    const style = getComputedStyle(element);
+    if (element.closest("[data-cuekit-ignore]") || !isElementClickable(element) || element.tagName.toLowerCase() === "script" || style.display === "none" || style.visibility === "hidden") {
+      return;
+    }
+    const staticId = element.getAttribute("data-ansyr-static");
+    const dynamicId = element.getAttribute("data-ansyr-dynamic");
+    const id = staticId || dynamicId;
+    const tags = [];
+    const directDescription = element.getAttribute("data-ansyr-description");
+    if (directDescription) {
+      tags.push(directDescription);
+    }
+    if (id && descriptionsMap.has(id)) {
+      tags.push(...descriptionsMap.get(id) || []);
+    }
+    const dto = {
+      testID: id || generateStableDOMId(element),
+      type: element.tagName.toLowerCase(),
+      textContent: getImmediateText(element) || element.textContent?.trim() || "",
+      tags
+    };
+    interactiveElements.push(dto);
+  });
+  const result = {
+    components: interactiveElements
+  };
   console.log("\u{1F333} Full DOM structure captured:", result);
   return result;
 }
-function buildFlatDOMNode(element) {
-  if (element.tagName.toLowerCase() === "script" || element.hasAttribute("data-cuekit-ignore") || element.style.display === "none" || element.style.visibility === "hidden") {
-    return null;
-  }
-  const hash = generateStableDOMId(element);
-  const text = getImmediateText(element).substring(0, 100);
-  const isClickable = isElementClickable(element);
-  const componentType = element.tagName.toLowerCase();
-  return {
-    hash,
-    text,
-    isClickable,
-    componentType,
-    children: []
-    // No children in a flat structure
-  };
-}
 function isElementClickable(element) {
   const interactiveSelectors = [
     "button",
@@ -23014,34 +23032,23 @@ function executeAction(action) {
   }
 }
 function getFullDOMStructure() {
-  console.log("\u{1F333} ElementService: Getting full DOM structure...");
   return captureFullDOMStructure();
 }
 function clickElement(elementId) {
   if (!elementId) {
-    console.warn("\u26A0\uFE0F No element ID provided for click action");
     return false;
   }
-  const domStructure = getFullDOMStructure();
-  const elementToClick = findElementById(domStructure, elementId);
-  if (elementToClick) {
-    console.log(`\u{1F3AF} Clicking element: ${elementId}`);
-    const domElement = findDOMElementById(elementId);
-    if (domElement) {
-      domElement.click();
-      return true;
-    }
-  } else {
-    console.warn(`\u26A0\uFE0F Element not found: ${elementId}`);
+  const domElement = findDOMElementById(elementId);
+  if (domElement) {
+    domElement.click();
+    return true;
   }
   return false;
 }
 function navigateToElement(target) {
   if (!target) {
-    console.warn("\u26A0\uFE0F No target provided for navigation action");
     return false;
   }
-  console.log(`\u{1F9ED} Navigating to: ${target}`);
   if (target.includes("/") || target.startsWith("http")) {
     safeNavigate(target, {});
   } else {
@@ -23051,27 +23058,22 @@ function navigateToElement(target) {
 }
 function focusElement(elementId) {
   if (!elementId) {
-    console.warn("\u26A0\uFE0F No element ID provided for focus action");
     return false;
   }
   const domElement = findDOMElementById(elementId);
   if (domElement instanceof HTMLInputElement || domElement instanceof HTMLTextAreaElement || domElement instanceof HTMLSelectElement) {
-    console.log(`\u{1F4DD} Focusing element: ${elementId}`);
     domElement.focus();
     return true;
   } else {
-    console.warn(`\u26A0\uFE0F Focusable element not found: ${elementId}`);
     return false;
   }
 }
 function toggleElement(elementId) {
   if (!elementId) {
-    console.warn("\u26A0\uFE0F No element ID provided for toggle action");
     return false;
   }
   const domElement = findDOMElementById(elementId);
   if (domElement instanceof HTMLElement) {
-    console.log(`\u{1F504} Toggling element: ${elementId}`);
     if (domElement instanceof HTMLInputElement) {
       if (domElement.type === "checkbox") {
         domElement.checked = !domElement.checked;
@@ -23084,34 +23086,20 @@ function toggleElement(elementId) {
     }
     return true;
   } else {
-    console.warn(`\u26A0\uFE0F Toggleable element not found: ${elementId}`);
     return false;
   }
 }
-function findElementById(domStructure, elementId) {
-  const searchInComponents = (components) => {
-    for (const component of components) {
-      if (component.hash === elementId) {
-        return component;
-      }
-      if (component.children.length > 0) {
-        const found = searchInComponents(component.children);
-        if (found) return found;
-      }
-    }
-    return null;
-  };
-  return searchInComponents(domStructure.components);
-}
 function findDOMElementById(elementId) {
+  if (!elementId) {
+    return null;
+  }
   const interactiveElements = getInteractiveElements();
   for (const element of interactiveElements) {
     if (element instanceof HTMLElement) {
-      console.log("\u{1F50D} Checking element:", element);
-      const hash = generateStableDOMId(element);
-      console.log("\u{1F50D} Generated hash:", hash);
-      if (hash === elementId) {
-        console.log("\u{1F50D} Found element:", element);
+      const staticId = element.getAttribute("data-ansyr-static");
+      const dynamicId = element.getAttribute("data-ansyr-dynamic");
+      const currentElementId = staticId || dynamicId || generateStableDOMId(element);
+      if (currentElementId === elementId) {
         return element;
       }
     }
@@ -23139,31 +23127,29 @@ function setWebRTCCallbacks(newCallbacks) {
 }
 async function authenticate(userIdentity, apiKey, appId) {
   try {
-    console.log("\u{1F3A4} WebRTCService: Authenticating user...", { userIdentity });
+    const authPayload = {
+      user_identity: userIdentity,
+      app_id: appId || _appId
+    };
     const response = await fetch(`${serverUrl}/auth/login`, {
       method: "POST",
       headers: {
         "Content-Type": "application/json",
         "X-API-Key": apiKey
       },
-      body: JSON.stringify({
-        user_identity: userIdentity,
-        app_id: appId || _appId
-      })
+      body: JSON.stringify(authPayload)
     });
     if (!response.ok) {
       const errorData = await response.json();
       throw new Error(errorData.detail || "Authentication failed");
     }
     const authData = await response.json();
-    console.log("\u{1F3A4} WebRTCService: Authentication successful:", authData);
     livekitUrl = authData.livekit_url;
     token = authData.livekit_token;
     roomName = authData.room_name;
     userIdentity = authData.user_identity;
     return authData;
   } catch (error) {
-    console.error("\u{1F3A4} WebRTCService: Authentication failed:", error);
     throw error;
   }
 }
@@ -23173,7 +23159,6 @@ async function connectToRoom(newLivekitUrl, newToken) {
   if (!url || !authToken) {
     throw new Error("Missing LiveKit URL or token. Please authenticate first.");
   }
-  console.log("\u{1F3A4} WebRTCService: Connecting to room...", { url, hasToken: !!authToken });
   try {
     setWebRTCConnectionState({ isConnected: false, isConnecting: true });
     room = new Room({
@@ -23182,17 +23167,13 @@ async function connectToRoom(newLivekitUrl, newToken) {
     });
     setupEventListeners();
     await room.connect(url, authToken);
-    console.log("\u{1F3A4} WebRTCService: Successfully connected to room:", room.name);
     setWebRTCConnectionState({ isConnected: true, isConnecting: false });
     try {
       await room.localParticipant.setMicrophoneEnabled(true);
-      console.log("\u{1F3A4} WebRTCService: Microphone enabled");
     } catch (micError) {
-      console.warn("\u{1F3A4} WebRTCService: Failed to enable microphone:", micError);
     }
     return { success: true };
   } catch (error) {
-    console.error("\u{1F3A4} WebRTCService: Failed to connect to room:", error);
     setWebRTCConnectionState({ isConnected: false, isConnecting: false });
     throw error;
   }
@@ -23200,23 +23181,17 @@ async function connectToRoom(newLivekitUrl, newToken) {
 function setupEventListeners() {
   if (!room) return;
   room.on(RoomEvent.ConnectionStateChanged, (state) => {
-    console.log("\u{1F3A4} WebRTCService: Connection state changed:", state);
     callbacks.onConnectionStateChange?.(state);
     if (state === ConnectionState.Connected) {
-      console.log("\u{1F3A4} WebRTCService: Successfully connected to room");
       setWebRTCConnectionState({ isConnected: true, isConnecting: false });
     } else if (state === ConnectionState.Disconnected) {
-      console.log("\u{1F3A4} WebRTCService: Disconnected from room");
       setWebRTCConnectionState({ isConnected: false, isConnecting: false });
     } else if (state === ConnectionState.Connecting) {
-      console.log("\u{1F3A4} WebRTCService: Connecting to room...");
       setWebRTCConnectionState({ isConnected: false, isConnecting: true });
     }
   }).on(RoomEvent.ParticipantConnected, (participant) => {
-    console.log("\u{1F3A4} WebRTCService: Participant connected:", participant.identity);
     updateParticipantsList();
   }).on(RoomEvent.ParticipantDisconnected, (participant) => {
-    console.log("\u{1F3A4} WebRTCService: Participant disconnected:", participant.identity);
     updateParticipantsList();
   }).on(RoomEvent.TrackSubscribed, (track, publication, participant) => {
     if (track.kind === Track.Kind.Audio && !participant.isLocal) {
@@ -23228,9 +23203,8 @@ function setupEventListeners() {
           if (element instanceof HTMLAudioElement) {
             const trackId = track.sid || `track_${Date.now()}_${Math.random()}`;
             callbacks.onAISpeechStart?.(trackId);
-            element.play().catch(
-              (error) => console.warn("\u{1F3A4} WebRTCService: Failed to auto-play audio:", error)
-            );
+            element.play().catch((error) => {
+            });
             element.addEventListener("ended", () => callbacks.onAISpeechEnd?.(trackId));
             element.addEventListener("pause", () => callbacks.onAISpeechEnd?.(trackId));
           }
@@ -23240,13 +23214,12 @@ function setupEventListeners() {
   }).on(RoomEvent.TrackUnsubscribed, (track) => {
     track.detach().forEach((element) => element.remove());
   }).on(RoomEvent.DataReceived, (payload, participant) => {
-    console.log("\u{1F4E1} LiveKit data received:", new TextDecoder().decode(payload));
+    const decodedPayload = new TextDecoder().decode(payload);
     try {
-      const message = JSON.parse(new TextDecoder().decode(payload));
-      console.log("\u{1F4E1} LiveKit data received:", message);
+      const message = JSON.parse(decodedPayload);
       callbacks.onNavigationCommand?.(message);
     } catch (error) {
-      const message = new TextDecoder().decode(payload);
+      const message = decodedPayload;
       callbacks.onNavigationCommand?.({ type: "raw_text", data: message });
     }
   }).on(RoomEvent.Disconnected, () => {
@@ -23265,26 +23238,25 @@ function updateParticipantsList() {
 async function sendData(data, reliable = true) {
   if (!room) throw new Error("Not connected to room");
   try {
-    console.log("\u{1F4E1} LiveKit data sending:", data);
+    console.log("\u2B06\uFE0F Sending data to backend [DataChannel]:", data);
     const encoder = new TextEncoder();
     const encodedData = encoder.encode(data);
     await room.localParticipant.publishData(encodedData, {
       reliable
     });
   } catch (error) {
-    console.error("Error sending data:", error);
     throw error;
   }
 }
 async function sendScreenStatus(screenData) {
   try {
+    console.log("\u2B06\uFE0F Sending to backend [/ai/data]:", JSON.stringify(screenData, null, 2));
     await fetch(`${serverUrl}/ai/data`, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify(screenData)
     });
   } catch (error) {
-    console.error("Error sending screen status:", error);
     throw error;
   }
 }
@@ -23299,12 +23271,10 @@ function getParticipants() {
 }
 async function sendUserCommand(command) {
   if (!room) return;
-  console.log(`\u{1F4AC} Sending user command: "${command}"`);
   await sendData(command);
 }
 async function sendRuntimeData() {
   if (!room) {
-    console.error("\u274C Cannot send runtime data without a room connection");
     return;
   }
   try {
@@ -23317,28 +23287,28 @@ async function sendRuntimeData() {
         current_screen: screenName
       }
     };
-    console.log("\u{1F4E6} Sending runtime data response");
     await sendData(JSON.stringify(response));
-    console.log("\u{1F4E6} Runtime data sent successfully");
   } catch (error) {
-    console.error("\u274C Failed to send runtime data:", error);
   }
 }
 async function sendStaticData(componentData, appId = "default") {
   try {
+    const staticDataPayload = {
+      type: "dashboard_data",
+      app_id: appId,
+      data: componentData
+    };
+    console.log("\u2B06\uFE0F Sending to backend [/ai/data]:", JSON.stringify(staticDataPayload, null, 2));
     const response = await fetch(`${serverUrl}/ai/data`, {
       method: "POST",
       headers: {
         "Content-Type": "application/json"
       },
-      body: JSON.stringify({
-        type: "dashboard_data",
-        app_id: appId,
-        data: componentData
-      })
+      body: JSON.stringify(staticDataPayload)
     });
     if (response.ok) {
       const result = await response.json();
+      console.log("\u2B07\uFE0F Received from backend [/ai/data]:", JSON.stringify(result, null, 2));
       return { success: true, data: result };
     } else {
       const errorText = await response.text();
@@ -23368,6 +23338,7 @@ function getRoom() {
 }
 
 export {
+  __require,
   __commonJS,
   __export,
   __toESM,
@@ -23384,7 +23355,6 @@ export {
   ParticipantEvent,
   Track,
   createAudioAnalyser,
-  Participant,
   ConnectionState,
   captureFullDOMStructure,
   executeAction,

package/dist/index.d.mts

@@ -254,21 +254,20 @@ declare const initWebRTCWithDeployedBackend: (apiKey: string, customConfig?: Par
  */
 declare const initWebRTC: (apiKey: string) => WebRTCServerConfig;
 
-type DOMNodeData = {
-    hash: string;
-    text: string;
-    isClickable: boolean;
-    componentType: string;
-    children: DOMNodeData[];
-};
-type FullDOMStructure = {
-    components: DOMNodeData[];
-};
+interface InteractiveElementDto {
+    testID: string;
+    type: string;
+    textContent: string;
+    tags: string[];
+}
+interface DOMStructurePayload {
+    components: InteractiveElementDto[];
+}
 
 /**
  * Capture the full DOM structure as a flat list of interactive elements
  */
-declare function captureFullDOMStructure(): FullDOMStructure;
+declare function captureFullDOMStructure(): DOMStructurePayload;
 interface ElementAction {
     action_type: 'click' | 'navigate' | 'input' | 'focus' | 'toggle';
     target_element?: string;
@@ -276,6 +275,16 @@ interface ElementAction {
     instruction?: string;
 }
 declare function executeAction(action: ElementAction): boolean;
-declare function getFullDOMStructure(): FullDOMStructure;
+declare function getFullDOMStructure(): DOMStructurePayload;
+
+/**
+ * Generates a stable, unique 8-character ID for an interactive element.
+ *
+ * @param routePath The path of the current route (e.g., from useLocation().pathname).
+ * @param elementIdentifier A stable, developer-defined string that uniquely identifies
+ *                          the element within its dynamic context (e.g., `van-link-${van.id}`).
+ * @returns An 8-character hexadecimal string.
+ */
+declare function generateDynamicId(routePath: string, elementIdentifier: string): string;
 
-export { BorderGlow, ChatPopup, type ChatPopupProps, CuekitProvider, type DOMNodeData, type ElementAction, type FullDOMStructure, InitCuekit, MicButton, type MicButtonProps, type MicState$1 as MicState, type NavigationCommand, type ServerConfig, type TokenRequest, type TokenResponse, VoiceIntensityVisualizer, type WebRTCServerConfig, captureFullDOMStructure, configureWebRTCServer, executeAction, getFullDOMStructure, getWebRTCServerConfig, initWebRTC, initWebRTCWithDeployedBackend, useCuekit, useQubeContext, useWebRTC };
+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 };

package/dist/index.d.ts

@@ -254,21 +254,20 @@ declare const initWebRTCWithDeployedBackend: (apiKey: string, customConfig?: Par
  */
 declare const initWebRTC: (apiKey: string) => WebRTCServerConfig;
 
-type DOMNodeData = {
-    hash: string;
-    text: string;
-    isClickable: boolean;
-    componentType: string;
-    children: DOMNodeData[];
-};
-type FullDOMStructure = {
-    components: DOMNodeData[];
-};
+interface InteractiveElementDto {
+    testID: string;
+    type: string;
+    textContent: string;
+    tags: string[];
+}
+interface DOMStructurePayload {
+    components: InteractiveElementDto[];
+}
 
 /**
  * Capture the full DOM structure as a flat list of interactive elements
  */
-declare function captureFullDOMStructure(): FullDOMStructure;
+declare function captureFullDOMStructure(): DOMStructurePayload;
 interface ElementAction {
     action_type: 'click' | 'navigate' | 'input' | 'focus' | 'toggle';
     target_element?: string;
@@ -276,6 +275,16 @@ interface ElementAction {
     instruction?: string;
 }
 declare function executeAction(action: ElementAction): boolean;
-declare function getFullDOMStructure(): FullDOMStructure;
+declare function getFullDOMStructure(): DOMStructurePayload;
+
+/**
+ * Generates a stable, unique 8-character ID for an interactive element.
+ *
+ * @param routePath The path of the current route (e.g., from useLocation().pathname).
+ * @param elementIdentifier A stable, developer-defined string that uniquely identifies
+ *                          the element within its dynamic context (e.g., `van-link-${van.id}`).
+ * @returns An 8-character hexadecimal string.
+ */
+declare function generateDynamicId(routePath: string, elementIdentifier: string): string;
 
-export { BorderGlow, ChatPopup, type ChatPopupProps, CuekitProvider, type DOMNodeData, type ElementAction, type FullDOMStructure, InitCuekit, MicButton, type MicButtonProps, type MicState$1 as MicState, type NavigationCommand, type ServerConfig, type TokenRequest, type TokenResponse, VoiceIntensityVisualizer, type WebRTCServerConfig, captureFullDOMStructure, configureWebRTCServer, executeAction, getFullDOMStructure, getWebRTCServerConfig, initWebRTC, initWebRTCWithDeployedBackend, useCuekit, useQubeContext, useWebRTC };
+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 };