@xbrowser/cli 1.2.2 → 1.3.1

package/dist/{browser-CWI6BXYK.js → browser-ALV2PLW4.js}

@@ -20,8 +20,8 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-SLQR57XZ.js";
-import "./chunk-QFROODUU.js";
+} from "./chunk-7OGKQWXE.js";
+import "./chunk-N4PIGZDG.js";
 import "./chunk-TNEN6VQ2.js";
 import "./chunk-GDKLH7ZY.js";
 import "./chunk-KFQGP6VL.js";

package/dist/{browser-PZX7PO23.js → browser-VKZVOOVV.js}

@@ -20,7 +20,7 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-MNFOCOL6.js";
+} from "./chunk-TLOHV3FP.js";
 import "./chunk-TNEN6VQ2.js";
 import "./chunk-GDKLH7ZY.js";
 import "./chunk-KFQGP6VL.js";

package/dist/{browser-JP2LFPR2.js → browser-WMQRPYXX.js}

@@ -20,8 +20,8 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-6V57JME6.js";
-import "./chunk-QFROODUU.js";
+} from "./chunk-UZQYMXR5.js";
+import "./chunk-N4PIGZDG.js";
 import "./chunk-TNEN6VQ2.js";
 import "./chunk-GDKLH7ZY.js";
 import "./chunk-ABXMBNQ6.js";

package/dist/{cdp-driver-S5STYUZZ.js → cdp-driver-72HOBP4C.js}

@@ -14,7 +14,7 @@ import {
   scrollIntoView,
   waitForActionable,
   waitForNetworkIdle
-} from "./chunk-QFROODUU.js";
+} from "./chunk-N4PIGZDG.js";
 import {
   connectToCDP,
   findChrome,

package/dist/{cdp-driver-RPUNQBGM.js → cdp-driver-JZPU5YXY.js}

@@ -1358,7 +1358,26 @@ Last error: ${lastError.message}` : "";
     return this.locator(`xpath=//*[contains(text(),'${escaped}')]`);
   }
   getByRole(role, opts) {
-    let sel = `[role="${role}"]`;
+    const ROLE_TO_TAGS = {
+      button: ["button"],
+      link: ["a[href]"],
+      heading: ["h1", "h2", "h3", "h4", "h5", "h6"],
+      textbox: ['input[type="text"]', "input:not([type])", "textarea"],
+      checkbox: ['input[type="checkbox"]'],
+      radio: ['input[type="radio"]'],
+      searchbox: ['input[type="search"]'],
+      combobox: ["select"],
+      img: ["img"],
+      navigation: ["nav"],
+      article: ["article"],
+      banner: ["header"],
+      contentinfo: ["footer"],
+      main: ["main"],
+      complementary: ["aside"]
+    };
+    const tags = ROLE_TO_TAGS[role] || [];
+    const tagSel = tags.length > 0 ? tags.join(",") + "," : "";
+    let sel = `${tagSel}[role="${role}"]`;
     if (opts?.name) {
       sel += opts.exact ? `[aria-label="${opts.name}"]` : `[aria-label*="${opts.name}"]`;
     }
@@ -1601,6 +1620,35 @@ Last error: ${lastError.message}` : "";
   frames() {
     return [this.mainFrame()];
   }
+  /**
+   * Discover all frames (main + iframes) via CDP Page.getFrameTree.
+   * This is async because CDP doesn't maintain a frame list client-side.
+   */
+  async discoverFrames() {
+    try {
+      const result = await this.conn.send("Page.getFrameTree", void 0, this.sessionId);
+      const frames = [];
+      const collect = (node) => {
+        frames.push({
+          name: () => node.frame.name || "",
+          url: () => node.frame.url,
+          // Helper for frame.ts to pick by index
+          childFrames: () => (node.childFrames || []).map((c) => ({
+            name: () => c.frame.name || "",
+            url: () => c.frame.url,
+            childFrames: () => []
+          }))
+        });
+        for (const child of node.childFrames || []) {
+          collect({ frame: child.frame, childFrames: [] });
+        }
+      };
+      collect(result.frameTree);
+      return frames;
+    } catch {
+      return [this.mainFrame()];
+    }
+  }
   // ── CDP helpers exposed for locator/element ─────────────────
   /** Query a single element, returns CDP nodeId or 0 if not found */
   async querySelector(selector) {

package/dist/{chunk-PHBK3TRN.js → chunk-2QQDTXDL.js}

@@ -399,8 +399,10 @@ var XBrowserPluginLoader = class {
           const instance = await this.loadPlugin(indexPath, entry.name);
           loaded.push(instance);
         } catch (err) {
-          if (process.env.XBROWSER_DEBUG) {
-            console.warn(`\u26A0\uFE0F  Plugin "${entry.name}" load failed: ${err instanceof Error ? err.message : String(err)}`);
+          const errMsg = err instanceof Error ? err.message : String(err);
+          console.warn(`\u26A0\uFE0F  Plugin "${entry.name}" load failed: ${errMsg}`);
+          if (errMsg.includes("Cannot find module") && errMsg.includes("shared/")) {
+            console.warn(`   \u{1F4A1} This plugin needs shared/ dependencies. Try: xbrowser plugin install shared`);
           }
         }
       }

package/dist/{chunk-SLQR57XZ.js → chunk-7OGKQWXE.js}

@@ -1,6 +1,6 @@
 import {
   launch
-} from "./chunk-QFROODUU.js";
+} from "./chunk-N4PIGZDG.js";
 import {
   errMsg
 } from "./chunk-GDKLH7ZY.js";

package/dist/{chunk-AT4PHAJY.js → chunk-GJAV3QGG.js}

@@ -24,9 +24,9 @@ var DEFAULT_EXCLUDE_TYPES = [
 function filterRecording(inputPath, outputPath, excludeTypes) {
   const content = fs.readFileSync(inputPath, "utf-8");
   const recording = yaml.parse(content);
-  const exclude = excludeTypes || DEFAULT_EXCLUDE_TYPES;
-  const events = recording.events || [];
+  const events = recording.actions || recording.events || [];
   const originalCount = events.length;
+  const exclude = excludeTypes || DEFAULT_EXCLUDE_TYPES;
   const filteredEvents = events.filter((event) => {
     return !exclude.includes(event.type);
   });

package/dist/{chunk-L53IDAWK.js → chunk-MJFYLKGL.js}

@@ -4,9 +4,10 @@ import * as yaml from "yaml";
 function extractRecording(filePath) {
   const content = fs.readFileSync(filePath, "utf-8");
   const recording = yaml.parse(content);
+  const events = recording.actions || recording.events || [];
   const keyEvents = [];
   const eventTypes = {};
-  for (const event of recording.events || []) {
+  for (const event of events) {
     const type = event.type;
     eventTypes[type] = (eventTypes[type] || 0) + 1;
     if (["click", "input", "type", "keydown", "keypress", "hover", "hover_enter", "hover_leave"].includes(type)) {
@@ -25,7 +26,7 @@ function extractRecording(filePath) {
   }
   return {
     startUrl: recording.startUrl,
-    totalEvents: (recording.events || []).length,
+    totalEvents: events.length,
     keyEventsCount: keyEvents.length,
     eventTypes,
     operations: keyEvents.map((e, i) => ({

package/dist/{chunk-QFROODUU.js → chunk-N4PIGZDG.js}

@@ -1357,7 +1357,26 @@ Last error: ${lastError.message}` : "";
     return this.locator(`xpath=//*[contains(text(),'${escaped}')]`);
   }
   getByRole(role, opts) {
-    let sel = `[role="${role}"]`;
+    const ROLE_TO_TAGS = {
+      button: ["button"],
+      link: ["a[href]"],
+      heading: ["h1", "h2", "h3", "h4", "h5", "h6"],
+      textbox: ['input[type="text"]', "input:not([type])", "textarea"],
+      checkbox: ['input[type="checkbox"]'],
+      radio: ['input[type="radio"]'],
+      searchbox: ['input[type="search"]'],
+      combobox: ["select"],
+      img: ["img"],
+      navigation: ["nav"],
+      article: ["article"],
+      banner: ["header"],
+      contentinfo: ["footer"],
+      main: ["main"],
+      complementary: ["aside"]
+    };
+    const tags = ROLE_TO_TAGS[role] || [];
+    const tagSel = tags.length > 0 ? tags.join(",") + "," : "";
+    let sel = `${tagSel}[role="${role}"]`;
     if (opts?.name) {
       sel += opts.exact ? `[aria-label="${opts.name}"]` : `[aria-label*="${opts.name}"]`;
     }
@@ -1600,6 +1619,35 @@ Last error: ${lastError.message}` : "";
   frames() {
     return [this.mainFrame()];
   }
+  /**
+   * Discover all frames (main + iframes) via CDP Page.getFrameTree.
+   * This is async because CDP doesn't maintain a frame list client-side.
+   */
+  async discoverFrames() {
+    try {
+      const result = await this.conn.send("Page.getFrameTree", void 0, this.sessionId);
+      const frames = [];
+      const collect = (node) => {
+        frames.push({
+          name: () => node.frame.name || "",
+          url: () => node.frame.url,
+          // Helper for frame.ts to pick by index
+          childFrames: () => (node.childFrames || []).map((c) => ({
+            name: () => c.frame.name || "",
+            url: () => c.frame.url,
+            childFrames: () => []
+          }))
+        });
+        for (const child of node.childFrames || []) {
+          collect({ frame: child.frame, childFrames: [] });
+        }
+      };
+      collect(result.frameTree);
+      return frames;
+    } catch {
+      return [this.mainFrame()];
+    }
+  }
   // ── CDP helpers exposed for locator/element ─────────────────
   /** Query a single element, returns CDP nodeId or 0 if not found */
   async querySelector(selector) {

package/dist/{chunk-MNFOCOL6.js → chunk-TLOHV3FP.js}

@@ -1363,7 +1363,26 @@ Last error: ${lastError.message}` : "";
     return this.locator(`xpath=//*[contains(text(),'${escaped}')]`);
   }
   getByRole(role, opts) {
-    let sel = `[role="${role}"]`;
+    const ROLE_TO_TAGS = {
+      button: ["button"],
+      link: ["a[href]"],
+      heading: ["h1", "h2", "h3", "h4", "h5", "h6"],
+      textbox: ['input[type="text"]', "input:not([type])", "textarea"],
+      checkbox: ['input[type="checkbox"]'],
+      radio: ['input[type="radio"]'],
+      searchbox: ['input[type="search"]'],
+      combobox: ["select"],
+      img: ["img"],
+      navigation: ["nav"],
+      article: ["article"],
+      banner: ["header"],
+      contentinfo: ["footer"],
+      main: ["main"],
+      complementary: ["aside"]
+    };
+    const tags = ROLE_TO_TAGS[role] || [];
+    const tagSel = tags.length > 0 ? tags.join(",") + "," : "";
+    let sel = `${tagSel}[role="${role}"]`;
     if (opts?.name) {
       sel += opts.exact ? `[aria-label="${opts.name}"]` : `[aria-label*="${opts.name}"]`;
     }
@@ -1606,6 +1625,35 @@ Last error: ${lastError.message}` : "";
   frames() {
     return [this.mainFrame()];
   }
+  /**
+   * Discover all frames (main + iframes) via CDP Page.getFrameTree.
+   * This is async because CDP doesn't maintain a frame list client-side.
+   */
+  async discoverFrames() {
+    try {
+      const result = await this.conn.send("Page.getFrameTree", void 0, this.sessionId);
+      const frames = [];
+      const collect = (node) => {
+        frames.push({
+          name: () => node.frame.name || "",
+          url: () => node.frame.url,
+          // Helper for frame.ts to pick by index
+          childFrames: () => (node.childFrames || []).map((c) => ({
+            name: () => c.frame.name || "",
+            url: () => c.frame.url,
+            childFrames: () => []
+          }))
+        });
+        for (const child of node.childFrames || []) {
+          collect({ frame: child.frame, childFrames: [] });
+        }
+      };
+      collect(result.frameTree);
+      return frames;
+    } catch {
+      return [this.mainFrame()];
+    }
+  }
   // ── CDP helpers exposed for locator/element ─────────────────
   /** Query a single element, returns CDP nodeId or 0 if not found */
   async querySelector(selector) {

package/dist/{chunk-6V57JME6.js → chunk-UZQYMXR5.js}

@@ -1,6 +1,6 @@
 import {
   launch
-} from "./chunk-QFROODUU.js";
+} from "./chunk-N4PIGZDG.js";
 import {
   errMsg
 } from "./chunk-GDKLH7ZY.js";