@usecrow/client 0.1.36 → 0.1.37

package/dist/{PageController-BweWYS-Z.js → PageController-D3uwrwlG.js}

@@ -2,14 +2,14 @@ async function waitFor(e) {
   await new Promise((n) => setTimeout(n, e * 1e3));
 }
 async function movePointerToElement(e) {
-  const n = e.getBoundingClientRect(), s = n.left + n.width / 2, o = n.top + n.height / 2;
-  window.dispatchEvent(new CustomEvent("PageAgent::MovePointerTo", { detail: { x: s, y: o } })), await waitFor(0.3);
+  const n = e.getBoundingClientRect(), i = n.left + n.width / 2, o = n.top + n.height / 2;
+  window.dispatchEvent(new CustomEvent("PageAgent::MovePointerTo", { detail: { x: i, y: o } })), await waitFor(0.3);
 }
 function getElementByIndex(e, n) {
-  const s = e.get(n);
-  if (!s)
+  const i = e.get(n);
+  if (!i)
     throw new Error(`No interactive element found at index ${n}`);
-  const o = s.ref;
+  const o = i.ref;
   if (!o)
     throw new Error(`Element at index ${n} does not have a reference`);
   if (!(o instanceof HTMLElement))
@@ -38,19 +38,22 @@ function getNativeTextAreaValueSetter() {
     "value"
   ).set), _nativeTextAreaValueSetter;
 }
+async function createSyntheticInputEvent(e, n) {
+  e.dispatchEvent(new KeyboardEvent("keydown", { bubbles: !0, cancelable: !0, key: n })), await waitFor(0.01), (e instanceof HTMLInputElement || e instanceof HTMLTextAreaElement) && (e.dispatchEvent(new Event("beforeinput", { bubbles: !0 })), await waitFor(0.01), e.dispatchEvent(new Event("input", { bubbles: !0 })), await waitFor(0.01)), e.dispatchEvent(new KeyboardEvent("keyup", { bubbles: !0, cancelable: !0, key: n }));
+}
 async function inputTextElement(e, n) {
   if (!(e instanceof HTMLInputElement || e instanceof HTMLTextAreaElement))
     throw new Error("Element is not an input or textarea");
   await clickElement(e), e instanceof HTMLTextAreaElement ? getNativeTextAreaValueSetter().call(e, n) : getNativeInputValueSetter().call(e, n);
-  const s = new Event("input", { bubbles: !0 });
-  e.dispatchEvent(s), await waitFor(0.1), blurLastClickedElement();
+  const i = new Event("input", { bubbles: !0 });
+  e.dispatchEvent(i), await waitFor(0.1), blurLastClickedElement();
 }
 async function selectOptionElement(e, n) {
   if (!(e instanceof HTMLSelectElement))
     throw new Error("Element is not a select element");
-  const o = Array.from(e.options).find((w) => {
+  const o = Array.from(e.options).find((f) => {
     var d;
-    return ((d = w.textContent) == null ? void 0 : d.trim()) === n.trim();
+    return ((d = f.textContent) == null ? void 0 : d.trim()) === n.trim();
   });
   if (!o)
     throw new Error(`Option with text "${n}" not found in select element`);
@@ -60,16 +63,16 @@ async function scrollIntoViewIfNeeded(e) {
   const n = e;
   n.scrollIntoViewIfNeeded ? n.scrollIntoViewIfNeeded() : n.scrollIntoView({ behavior: "auto", block: "center", inline: "nearest" });
 }
-async function scrollVertically(e, n, s) {
-  if (s) {
-    const l = s;
+async function scrollVertically(e, n, i) {
+  if (i) {
+    const l = i;
     console.log(
       "[SCROLL DEBUG] Starting direct container scroll for element:",
       l.tagName
     );
-    let h = l, T = !1, b = null, u = 0, f = 0;
-    const N = n;
-    for (; h && f < 10; ) {
+    let h = l, T = !1, b = null, u = 0, g = 0;
+    const S = n;
+    for (; h && g < 10; ) {
       const D = window.getComputedStyle(h), z = /(auto|scroll|overlay)/.test(D.overflowY), _ = h.scrollHeight > h.clientHeight;
       if (console.log(
         "[SCROLL DEBUG] Checking element:",
@@ -83,66 +86,66 @@ async function scrollVertically(e, n, s) {
         "clientHeight:",
         h.clientHeight
       ), z && _) {
-        const R = h.scrollTop, U = h.scrollHeight - h.clientHeight;
-        let H = N / 3;
-        H > 0 ? H = Math.min(H, U - R) : H = Math.max(H, -R), h.scrollTop = R + H;
-        const V = h.scrollTop, O = V - R;
+        const H = h.scrollTop, U = h.scrollHeight - h.clientHeight;
+        let R = S / 3;
+        R > 0 ? R = Math.min(R, U - H) : R = Math.max(R, -H), h.scrollTop = H + R;
+        const W = h.scrollTop, B = W - H;
         if (console.log(
           "[SCROLL DEBUG] Scroll attempt:",
           h.tagName,
           "before:",
-          R,
+          H,
           "after:",
-          V,
+          W,
           "delta:",
-          O
-        ), Math.abs(O) > 0.5) {
-          T = !0, b = h, u = O, console.log(
+          B
+        ), Math.abs(B) > 0.5) {
+          T = !0, b = h, u = B, console.log(
             "[SCROLL DEBUG] Successfully scrolled container:",
             h.tagName,
             "delta:",
-            O
+            B
           );
           break;
         }
       }
       if (h === document.body || h === document.documentElement)
         break;
-      h = h.parentElement, f++;
+      h = h.parentElement, g++;
     }
     return T ? `Scrolled container (${b == null ? void 0 : b.tagName}) by ${u}px` : `No scrollable container found for element (${l.tagName})`;
   }
-  const o = n, w = (l) => l.clientHeight >= window.innerHeight * 0.5, d = (l) => l && /(auto|scroll|overlay)/.test(getComputedStyle(l).overflowY) && l.scrollHeight > l.clientHeight && w(l);
-  let r = document.activeElement;
-  for (; r && !d(r) && r !== document.body; ) r = r.parentElement;
-  if (r = d(r) ? r : Array.from(document.querySelectorAll("*")).find(d) || document.scrollingElement || document.documentElement, r === document.scrollingElement || r === document.documentElement || r === document.body) {
+  const o = n, f = (l) => l.clientHeight >= window.innerHeight * 0.5, d = (l) => l && /(auto|scroll|overlay)/.test(getComputedStyle(l).overflowY) && l.scrollHeight > l.clientHeight && f(l);
+  let s = document.activeElement;
+  for (; s && !d(s) && s !== document.body; ) s = s.parentElement;
+  if (s = d(s) ? s : Array.from(document.querySelectorAll("*")).find(d) || document.scrollingElement || document.documentElement, s === document.scrollingElement || s === document.documentElement || s === document.body) {
     const l = window.scrollY, h = document.documentElement.scrollHeight - window.innerHeight;
     window.scrollBy(0, o);
     const T = window.scrollY, b = T - l;
     if (Math.abs(b) < 1)
       return o > 0 ? "⚠️ Already at the bottom of the page, cannot scroll down further." : "⚠️ Already at the top of the page, cannot scroll up further.";
-    const u = o > 0 && T >= h - 1, f = o < 0 && T <= 1;
-    return u ? `✅ Scrolled page by ${b}px. Reached the bottom of the page.` : f ? `✅ Scrolled page by ${b}px. Reached the top of the page.` : `✅ Scrolled page by ${b}px.`;
+    const u = o > 0 && T >= h - 1, g = o < 0 && T <= 1;
+    return u ? `✅ Scrolled page by ${b}px. Reached the bottom of the page.` : g ? `✅ Scrolled page by ${b}px. Reached the top of the page.` : `✅ Scrolled page by ${b}px.`;
   } else {
-    const l = r.scrollTop, h = r.scrollHeight - r.clientHeight;
-    r.scrollBy({ top: o, behavior: "smooth" }), await waitFor(0.1);
-    const T = r.scrollTop, b = T - l;
+    const l = s.scrollTop, h = s.scrollHeight - s.clientHeight;
+    s.scrollBy({ top: o, behavior: "smooth" }), await waitFor(0.1);
+    const T = s.scrollTop, b = T - l;
     if (Math.abs(b) < 1)
-      return o > 0 ? `⚠️ Already at the bottom of container (${r.tagName}), cannot scroll down further.` : `⚠️ Already at the top of container (${r.tagName}), cannot scroll up further.`;
-    const u = o > 0 && T >= h - 1, f = o < 0 && T <= 1;
-    return u ? `✅ Scrolled container (${r.tagName}) by ${b}px. Reached the bottom.` : f ? `✅ Scrolled container (${r.tagName}) by ${b}px. Reached the top.` : `✅ Scrolled container (${r.tagName}) by ${b}px.`;
+      return o > 0 ? `⚠️ Already at the bottom of container (${s.tagName}), cannot scroll down further.` : `⚠️ Already at the top of container (${s.tagName}), cannot scroll up further.`;
+    const u = o > 0 && T >= h - 1, g = o < 0 && T <= 1;
+    return u ? `✅ Scrolled container (${s.tagName}) by ${b}px. Reached the bottom.` : g ? `✅ Scrolled container (${s.tagName}) by ${b}px. Reached the top.` : `✅ Scrolled container (${s.tagName}) by ${b}px.`;
   }
 }
-async function scrollHorizontally(e, n, s) {
-  if (s) {
-    const l = s;
+async function scrollHorizontally(e, n, i) {
+  if (i) {
+    const l = i;
     console.log(
       "[SCROLL DEBUG] Starting direct container scroll for element:",
       l.tagName
     );
-    let h = l, T = !1, b = null, u = 0, f = 0;
-    const N = e ? n : -n;
-    for (; h && f < 10; ) {
+    let h = l, T = !1, b = null, u = 0, g = 0;
+    const S = e ? n : -n;
+    for (; h && g < 10; ) {
       const D = window.getComputedStyle(h), z = /(auto|scroll|overlay)/.test(D.overflowX), _ = h.scrollWidth > h.clientWidth;
       if (console.log(
         "[SCROLL DEBUG] Checking element:",
@@ -156,54 +159,54 @@ async function scrollHorizontally(e, n, s) {
         "clientWidth:",
         h.clientWidth
       ), z && _) {
-        const R = h.scrollLeft, U = h.scrollWidth - h.clientWidth;
-        let H = N / 3;
-        H > 0 ? H = Math.min(H, U - R) : H = Math.max(H, -R), h.scrollLeft = R + H;
-        const V = h.scrollLeft, O = V - R;
+        const H = h.scrollLeft, U = h.scrollWidth - h.clientWidth;
+        let R = S / 3;
+        R > 0 ? R = Math.min(R, U - H) : R = Math.max(R, -H), h.scrollLeft = H + R;
+        const W = h.scrollLeft, B = W - H;
         if (console.log(
           "[SCROLL DEBUG] Scroll attempt:",
           h.tagName,
           "before:",
-          R,
+          H,
           "after:",
-          V,
+          W,
           "delta:",
-          O
-        ), Math.abs(O) > 0.5) {
-          T = !0, b = h, u = O, console.log(
+          B
+        ), Math.abs(B) > 0.5) {
+          T = !0, b = h, u = B, console.log(
             "[SCROLL DEBUG] Successfully scrolled container:",
             h.tagName,
             "delta:",
-            O
+            B
           );
           break;
         }
       }
       if (h === document.body || h === document.documentElement)
         break;
-      h = h.parentElement, f++;
+      h = h.parentElement, g++;
     }
     return T ? `Scrolled container (${b == null ? void 0 : b.tagName}) horizontally by ${u}px` : `No horizontally scrollable container found for element (${l.tagName})`;
   }
-  const o = e ? n : -n, w = (l) => l.clientWidth >= window.innerWidth * 0.5, d = (l) => l && /(auto|scroll|overlay)/.test(getComputedStyle(l).overflowX) && l.scrollWidth > l.clientWidth && w(l);
-  let r = document.activeElement;
-  for (; r && !d(r) && r !== document.body; ) r = r.parentElement;
-  if (r = d(r) ? r : Array.from(document.querySelectorAll("*")).find(d) || document.scrollingElement || document.documentElement, r === document.scrollingElement || r === document.documentElement || r === document.body) {
+  const o = e ? n : -n, f = (l) => l.clientWidth >= window.innerWidth * 0.5, d = (l) => l && /(auto|scroll|overlay)/.test(getComputedStyle(l).overflowX) && l.scrollWidth > l.clientWidth && f(l);
+  let s = document.activeElement;
+  for (; s && !d(s) && s !== document.body; ) s = s.parentElement;
+  if (s = d(s) ? s : Array.from(document.querySelectorAll("*")).find(d) || document.scrollingElement || document.documentElement, s === document.scrollingElement || s === document.documentElement || s === document.body) {
     const l = window.scrollX, h = document.documentElement.scrollWidth - window.innerWidth;
     window.scrollBy(o, 0);
     const T = window.scrollX, b = T - l;
     if (Math.abs(b) < 1)
       return o > 0 ? "⚠️ Already at the right edge of the page, cannot scroll right further." : "⚠️ Already at the left edge of the page, cannot scroll left further.";
-    const u = o > 0 && T >= h - 1, f = o < 0 && T <= 1;
-    return u ? `✅ Scrolled page by ${b}px. Reached the right edge of the page.` : f ? `✅ Scrolled page by ${b}px. Reached the left edge of the page.` : `✅ Scrolled page horizontally by ${b}px.`;
+    const u = o > 0 && T >= h - 1, g = o < 0 && T <= 1;
+    return u ? `✅ Scrolled page by ${b}px. Reached the right edge of the page.` : g ? `✅ Scrolled page by ${b}px. Reached the left edge of the page.` : `✅ Scrolled page horizontally by ${b}px.`;
   } else {
-    const l = r.scrollLeft, h = r.scrollWidth - r.clientWidth;
-    r.scrollBy({ left: o, behavior: "smooth" }), await waitFor(0.1);
-    const T = r.scrollLeft, b = T - l;
+    const l = s.scrollLeft, h = s.scrollWidth - s.clientWidth;
+    s.scrollBy({ left: o, behavior: "smooth" }), await waitFor(0.1);
+    const T = s.scrollLeft, b = T - l;
     if (Math.abs(b) < 1)
-      return o > 0 ? `⚠️ Already at the right edge of container (${r.tagName}), cannot scroll right further.` : `⚠️ Already at the left edge of container (${r.tagName}), cannot scroll left further.`;
-    const u = o > 0 && T >= h - 1, f = o < 0 && T <= 1;
-    return u ? `✅ Scrolled container (${r.tagName}) by ${b}px. Reached the right edge.` : f ? `✅ Scrolled container (${r.tagName}) by ${b}px. Reached the left edge.` : `✅ Scrolled container (${r.tagName}) horizontally by ${b}px.`;
+      return o > 0 ? `⚠️ Already at the right edge of container (${s.tagName}), cannot scroll right further.` : `⚠️ Already at the left edge of container (${s.tagName}), cannot scroll left further.`;
+    const u = o > 0 && T >= h - 1, g = o < 0 && T <= 1;
+    return u ? `✅ Scrolled container (${s.tagName}) by ${b}px. Reached the right edge.` : g ? `✅ Scrolled container (${s.tagName}) by ${b}px. Reached the left edge.` : `✅ Scrolled container (${s.tagName}) horizontally by ${b}px.`;
   }
 }
 const VIEWPORT_EXPANSION = -1, domTree = (e = {
@@ -221,52 +224,52 @@ const VIEWPORT_EXPANSION = -1, domTree = (e = {
   highlightOpacity: 0.1,
   highlightLabelOpacity: 0.5
 }) => {
-  const { interactiveBlacklist: n, interactiveWhitelist: s, highlightOpacity: o, highlightLabelOpacity: w } = e, { doHighlightElements: d, focusHighlightIndex: r, viewportExpansion: l, debugMode: h } = e;
+  const { interactiveBlacklist: n, interactiveWhitelist: i, highlightOpacity: o, highlightLabelOpacity: f } = e, { doHighlightElements: d, focusHighlightIndex: s, viewportExpansion: l, debugMode: h } = e;
   let T = 0;
   const b = /* @__PURE__ */ new WeakMap();
-  function u(t, i) {
-    !t || t.nodeType !== Node.ELEMENT_NODE || b.set(t, { ...b.get(t), ...i });
+  function u(t, r) {
+    !t || t.nodeType !== Node.ELEMENT_NODE || b.set(t, { ...b.get(t), ...r });
   }
-  const f = {
+  const g = {
     boundingRects: /* @__PURE__ */ new WeakMap(),
     clientRects: /* @__PURE__ */ new WeakMap(),
     computedStyles: /* @__PURE__ */ new WeakMap(),
     clearCache: () => {
-      f.boundingRects = /* @__PURE__ */ new WeakMap(), f.clientRects = /* @__PURE__ */ new WeakMap(), f.computedStyles = /* @__PURE__ */ new WeakMap();
+      g.boundingRects = /* @__PURE__ */ new WeakMap(), g.clientRects = /* @__PURE__ */ new WeakMap(), g.computedStyles = /* @__PURE__ */ new WeakMap();
     }
   };
-  function N(t) {
+  function S(t) {
     if (!t) return null;
-    if (f.boundingRects.has(t))
-      return f.boundingRects.get(t);
-    const i = t.getBoundingClientRect();
-    return i && f.boundingRects.set(t, i), i;
+    if (g.boundingRects.has(t))
+      return g.boundingRects.get(t);
+    const r = t.getBoundingClientRect();
+    return r && g.boundingRects.set(t, r), r;
   }
   function D(t) {
     if (!t) return null;
-    if (f.computedStyles.has(t))
-      return f.computedStyles.get(t);
-    const i = window.getComputedStyle(t);
-    return i && f.computedStyles.set(t, i), i;
+    if (g.computedStyles.has(t))
+      return g.computedStyles.get(t);
+    const r = window.getComputedStyle(t);
+    return r && g.computedStyles.set(t, r), r;
   }
   function z(t) {
     if (!t) return null;
-    if (f.clientRects.has(t))
-      return f.clientRects.get(t);
-    const i = t.getClientRects();
-    return i && f.clientRects.set(t, i), i;
+    if (g.clientRects.has(t))
+      return g.clientRects.get(t);
+    const r = t.getClientRects();
+    return r && g.clientRects.set(t, r), r;
   }
-  const _ = {}, R = { current: 0 }, U = "playwright-highlight-container";
-  function H(t, i, p = null) {
-    if (!t) return i;
+  const _ = {}, H = { current: 0 }, U = "playwright-highlight-container";
+  function R(t, r, m = null) {
+    if (!t) return r;
     const c = [];
     let a = null, x = 20, E = 16, I = null;
     try {
-      let m = document.getElementById(U);
-      m || (m = document.createElement("div"), m.id = U, m.style.position = "fixed", m.style.pointerEvents = "none", m.style.top = "0", m.style.left = "0", m.style.width = "100%", m.style.height = "100%", m.style.zIndex = "2147483640", m.style.backgroundColor = "transparent", document.body.appendChild(m));
-      const A = t.getClientRects();
-      if (!A || A.length === 0) return i;
-      const $ = [
+      let w = document.getElementById(U);
+      w || (w = document.createElement("div"), w.id = U, w.style.position = "fixed", w.style.pointerEvents = "none", w.style.top = "0", w.style.left = "0", w.style.width = "100%", w.style.height = "100%", w.style.zIndex = "2147483640", w.style.backgroundColor = "transparent", document.body.appendChild(w));
+      const $ = t.getClientRects();
+      if (!$ || $.length === 0) return r;
+      const A = [
         "#FF0000",
         "#00FF00",
         "#0000FF",
@@ -279,94 +282,94 @@ const VIEWPORT_EXPANSION = -1, domTree = (e = {
         "#2E8B57",
         "#DC143C",
         "#4682B4"
-      ], g = i % $.length;
-      let y = $[g];
-      const C = y + Math.floor(o * 255).toString(16).padStart(2, "0");
-      y = y + Math.floor(w * 255).toString(16).padStart(2, "0");
-      let M = { x: 0, y: 0 };
-      if (p) {
-        const S = p.getBoundingClientRect();
-        M.x = S.left, M.y = S.top;
+      ], p = r % A.length;
+      let y = A[p];
+      const M = y + Math.floor(o * 255).toString(16).padStart(2, "0");
+      y = y + Math.floor(f * 255).toString(16).padStart(2, "0");
+      let C = { x: 0, y: 0 };
+      if (m) {
+        const k = m.getBoundingClientRect();
+        C.x = k.left, C.y = k.top;
       }
-      const B = document.createDocumentFragment();
-      for (const S of A) {
-        if (S.width === 0 || S.height === 0) continue;
-        const k = document.createElement("div");
-        k.style.position = "fixed", k.style.border = `2px solid ${y}`, k.style.backgroundColor = C, k.style.pointerEvents = "none", k.style.boxSizing = "border-box";
-        const v = S.top + M.y, W = S.left + M.x;
-        k.style.top = `${v}px`, k.style.left = `${W}px`, k.style.width = `${S.width}px`, k.style.height = `${S.height}px`, B.appendChild(k), c.push({ element: k, initialRect: S });
+      const V = document.createDocumentFragment();
+      for (const k of $) {
+        if (k.width === 0 || k.height === 0) continue;
+        const N = document.createElement("div");
+        N.style.position = "fixed", N.style.border = `2px solid ${y}`, N.style.backgroundColor = M, N.style.pointerEvents = "none", N.style.boxSizing = "border-box";
+        const v = k.top + C.y, F = k.left + C.x;
+        N.style.top = `${v}px`, N.style.left = `${F}px`, N.style.width = `${k.width}px`, N.style.height = `${k.height}px`, V.appendChild(N), c.push({ element: N, initialRect: k });
       }
-      const G = A[0];
-      if (w > 0) {
-        a = document.createElement("div"), a.className = "playwright-highlight-label", a.style.position = "fixed", a.style.background = y, a.style.color = "white", a.style.padding = "1px 4px", a.style.borderRadius = "4px", a.style.fontSize = `${Math.min(12, Math.max(8, G.height / 2))}px`, a.textContent = i.toString(), x = a.offsetWidth > 0 ? a.offsetWidth : x, E = a.offsetHeight > 0 ? a.offsetHeight : E;
-        const S = G.top + M.y, k = G.left + M.x;
-        let v = S + 2, W = k + G.width - x - 2;
-        (G.width < x + 4 || G.height < E + 4) && (v = S - E - 2, W = k + G.width - x, W < M.x && (W = k)), v = Math.max(0, Math.min(v, window.innerHeight - E)), W = Math.max(0, Math.min(W, window.innerWidth - x)), a.style.top = `${v}px`, a.style.left = `${W}px`, B.appendChild(a);
+      const G = $[0];
+      if (f > 0) {
+        a = document.createElement("div"), a.className = "playwright-highlight-label", a.style.position = "fixed", a.style.background = y, a.style.color = "white", a.style.padding = "1px 4px", a.style.borderRadius = "4px", a.style.fontSize = `${Math.min(12, Math.max(8, G.height / 2))}px`, a.textContent = r.toString(), x = a.offsetWidth > 0 ? a.offsetWidth : x, E = a.offsetHeight > 0 ? a.offsetHeight : E;
+        const k = G.top + C.y, N = G.left + C.x;
+        let v = k + 2, F = N + G.width - x - 2;
+        (G.width < x + 4 || G.height < E + 4) && (v = k - E - 2, F = N + G.width - x, F < C.x && (F = N)), v = Math.max(0, Math.min(v, window.innerHeight - E)), F = Math.max(0, Math.min(F, window.innerWidth - x)), a.style.top = `${v}px`, a.style.left = `${F}px`, V.appendChild(a);
       }
-      const j = ((S, k) => {
+      const j = ((k, N) => {
         let v = 0;
-        return (...W) => {
+        return (...F) => {
           const P = performance.now();
-          if (!(P - v < k))
-            return v = P, S(...W);
+          if (!(P - v < N))
+            return v = P, k(...F);
         };
       })(() => {
-        const S = t.getClientRects();
-        let k = { x: 0, y: 0 };
-        if (p) {
-          const v = p.getBoundingClientRect();
-          k.x = v.left, k.y = v.top;
+        const k = t.getClientRects();
+        let N = { x: 0, y: 0 };
+        if (m) {
+          const v = m.getBoundingClientRect();
+          N.x = v.left, N.y = v.top;
         }
-        if (c.forEach((v, W) => {
-          if (W < S.length) {
-            const P = S[W], Z = P.top + k.y, J = P.left + k.x;
-            v.element.style.top = `${Z}px`, v.element.style.left = `${J}px`, v.element.style.width = `${P.width}px`, v.element.style.height = `${P.height}px`, v.element.style.display = P.width === 0 || P.height === 0 ? "none" : "block";
+        if (c.forEach((v, F) => {
+          if (F < k.length) {
+            const P = k[F], Z = P.top + N.y, K = P.left + N.x;
+            v.element.style.top = `${Z}px`, v.element.style.left = `${K}px`, v.element.style.width = `${P.width}px`, v.element.style.height = `${P.height}px`, v.element.style.display = P.width === 0 || P.height === 0 ? "none" : "block";
           } else
             v.element.style.display = "none";
-        }), S.length < c.length)
-          for (let v = S.length; v < c.length; v++)
+        }), k.length < c.length)
+          for (let v = k.length; v < c.length; v++)
             c[v].element.style.display = "none";
-        if (a && S.length > 0) {
-          const v = S[0], W = v.top + k.y, P = v.left + k.x;
-          let Z = W + 2, J = P + v.width - x - 2;
-          (v.width < x + 4 || v.height < E + 4) && (Z = W - E - 2, J = P + v.width - x, J < k.x && (J = P)), Z = Math.max(0, Math.min(Z, window.innerHeight - E)), J = Math.max(0, Math.min(J, window.innerWidth - x)), a.style.top = `${Z}px`, a.style.left = `${J}px`, a.style.display = "block";
+        if (a && k.length > 0) {
+          const v = k[0], F = v.top + N.y, P = v.left + N.x;
+          let Z = F + 2, K = P + v.width - x - 2;
+          (v.width < x + 4 || v.height < E + 4) && (Z = F - E - 2, K = P + v.width - x, K < N.x && (K = P)), Z = Math.max(0, Math.min(Z, window.innerHeight - E)), K = Math.max(0, Math.min(K, window.innerWidth - x)), a.style.top = `${Z}px`, a.style.left = `${K}px`, a.style.display = "block";
         } else a && (a.style.display = "none");
       }, 16);
       return window.addEventListener("scroll", j, !0), window.addEventListener("resize", j), I = () => {
-        window.removeEventListener("scroll", j, !0), window.removeEventListener("resize", j), c.forEach((S) => S.element.remove()), a && a.remove();
-      }, m.appendChild(B), i + 1;
+        window.removeEventListener("scroll", j, !0), window.removeEventListener("resize", j), c.forEach((k) => k.element.remove()), a && a.remove();
+      }, w.appendChild(V), r + 1;
     } finally {
       I && (window._highlightCleanupFunctions = window._highlightCleanupFunctions || []).push(
         I
       );
     }
   }
-  function V(t) {
+  function W(t) {
     if (!t || t.nodeType !== Node.ELEMENT_NODE)
       return null;
-    const i = D(t);
-    if (!i) return null;
-    const p = i.display;
-    if (p === "inline" || p === "inline-block")
+    const r = D(t);
+    if (!r) return null;
+    const m = r.display;
+    if (m === "inline" || m === "inline-block")
       return null;
-    const c = i.overflowX, a = i.overflowY, x = c === "auto" || c === "scroll", E = a === "auto" || a === "scroll";
+    const c = r.overflowX, a = r.overflowY, x = c === "auto" || c === "scroll", E = a === "auto" || a === "scroll";
     if (!x && !E)
       return null;
-    const I = t.scrollWidth - t.clientWidth, m = t.scrollHeight - t.clientHeight, A = 4;
-    if (I < A && m < A || !E && I < A || !x && m < A)
+    const I = t.scrollWidth - t.clientWidth, w = t.scrollHeight - t.clientHeight, $ = 4;
+    if (I < $ && w < $ || !E && I < $ || !x && w < $)
       return null;
-    const $ = t.scrollTop, g = t.scrollLeft, y = t.scrollWidth - t.clientWidth - t.scrollLeft, C = t.scrollHeight - t.clientHeight - t.scrollTop, M = {
-      top: $,
+    const A = t.scrollTop, p = t.scrollLeft, y = t.scrollWidth - t.clientWidth - t.scrollLeft, M = t.scrollHeight - t.clientHeight - t.scrollTop, C = {
+      top: A,
       right: y,
-      bottom: C,
-      left: g
+      bottom: M,
+      left: p
     };
     return u(t, {
       scrollable: !0,
-      scrollData: M
-    }), M;
+      scrollData: C
+    }), C;
   }
-  function O(t) {
+  function B(t) {
     try {
       if (l === -1) {
         const E = t.parentElement;
@@ -377,17 +380,17 @@ const VIEWPORT_EXPANSION = -1, domTree = (e = {
             checkVisibilityCSS: !0
           });
         } catch {
-          const m = window.getComputedStyle(E);
-          return m.display !== "none" && m.visibility !== "hidden" && m.opacity !== "0";
+          const w = window.getComputedStyle(E);
+          return w.display !== "none" && w.visibility !== "hidden" && w.opacity !== "0";
         }
       }
-      const i = document.createRange();
-      i.selectNodeContents(t);
-      const p = i.getClientRects();
-      if (!p || p.length === 0)
+      const r = document.createRange();
+      r.selectNodeContents(t);
+      const m = r.getClientRects();
+      if (!m || m.length === 0)
         return !1;
       let c = !1, a = !1;
-      for (const E of p)
+      for (const E of m)
         if (E.width > 0 && E.height > 0 && (c = !0, !(E.bottom < -l || E.top > window.innerHeight + l || E.right < -l || E.left > window.innerWidth + l))) {
           a = !0;
           break;
@@ -405,13 +408,13 @@ const VIEWPORT_EXPANSION = -1, domTree = (e = {
         const I = window.getComputedStyle(x);
         return I.display !== "none" && I.visibility !== "hidden" && I.opacity !== "0";
       }
-    } catch (i) {
-      return console.warn("Error checking text node visibility:", i), !1;
+    } catch (r) {
+      return console.warn("Error checking text node visibility:", r), !1;
     }
   }
   function it(t) {
     if (!t || !t.tagName) return !1;
-    const i = /* @__PURE__ */ new Set([
+    const r = /* @__PURE__ */ new Set([
       "body",
       "div",
       "main",
@@ -420,8 +423,8 @@ const VIEWPORT_EXPANSION = -1, domTree = (e = {
       "nav",
       "header",
       "footer"
-    ]), p = t.tagName.toLowerCase();
-    return i.has(p) ? !0 : !(/* @__PURE__ */ new Set([
+    ]), m = t.tagName.toLowerCase();
+    return r.has(m) ? !0 : !(/* @__PURE__ */ new Set([
       "svg",
       "script",
       "style",
@@ -429,19 +432,19 @@ const VIEWPORT_EXPANSION = -1, domTree = (e = {
       "meta",
       "noscript",
       "template"
-    ])).has(p);
+    ])).has(m);
   }
   function X(t) {
-    const i = D(t);
-    return t.offsetWidth > 0 && t.offsetHeight > 0 && (i == null ? void 0 : i.visibility) !== "hidden" && (i == null ? void 0 : i.display) !== "none";
+    const r = D(t);
+    return t.offsetWidth > 0 && t.offsetHeight > 0 && (r == null ? void 0 : r.visibility) !== "hidden" && (r == null ? void 0 : r.display) !== "none";
   }
   function L(t) {
-    var C, M;
+    var M, C;
     if (!t || t.nodeType !== Node.ELEMENT_NODE || n.includes(t))
       return !1;
-    if (s.includes(t))
+    if (i.includes(t))
       return !0;
-    const i = t.tagName.toLowerCase(), p = D(t), c = /* @__PURE__ */ new Set([
+    const r = t.tagName.toLowerCase(), m = D(t), c = /* @__PURE__ */ new Set([
       "pointer",
       // Link/clickable elements
       "move",
@@ -518,8 +521,8 @@ const VIEWPORT_EXPANSION = -1, domTree = (e = {
       // 'default',     // Default cursor
       // 'auto',        // Browser default
     ]);
-    function x(B) {
-      return B.tagName.toLowerCase() === "html" ? !1 : !!(p != null && p.cursor && c.has(p.cursor));
+    function x(V) {
+      return V.tagName.toLowerCase() === "html" ? !1 : !!(m != null && m.cursor && c.has(m.cursor));
     }
     if (x(t))
       return !0;
@@ -548,7 +551,7 @@ const VIEWPORT_EXPANSION = -1, domTree = (e = {
       // Form fieldsets (can be interactive with legend)
       "legend"
       // Fieldset legends
-    ]), m = /* @__PURE__ */ new Set([
+    ]), w = /* @__PURE__ */ new Set([
       "disabled",
       // Standard disabled attribute
       // 'aria-disabled',      // ARIA disabled state
@@ -562,18 +565,18 @@ const VIEWPORT_EXPANSION = -1, domTree = (e = {
       // 'tabindex="-1"',     // Removed from tab order
       // 'aria-hidden="true"' // Hidden from screen readers
     ]);
-    if (I.has(i)) {
-      if (p != null && p.cursor && a.has(p.cursor))
+    if (I.has(r)) {
+      if (m != null && m.cursor && a.has(m.cursor))
         return !1;
-      for (const B of m)
-        if (t.hasAttribute(B) || t.getAttribute(B) === "true" || t.getAttribute(B) === "")
+      for (const V of w)
+        if (t.hasAttribute(V) || t.getAttribute(V) === "true" || t.getAttribute(V) === "")
           return !1;
       return !(t.disabled || t.readOnly || t.inert);
     }
-    const A = t.getAttribute("role"), $ = t.getAttribute("aria-role");
+    const $ = t.getAttribute("role"), A = t.getAttribute("aria-role");
     if (t.getAttribute("contenteditable") === "true" || t.isContentEditable || t.classList && (t.classList.contains("button") || t.classList.contains("dropdown-toggle") || t.getAttribute("data-index") || t.getAttribute("data-toggle") === "dropdown" || t.getAttribute("aria-haspopup") === "true"))
       return !0;
-    const g = /* @__PURE__ */ new Set([
+    const p = /* @__PURE__ */ new Set([
       "button",
       // Directly clickable element
       // 'link',            // Clickable link
@@ -612,7 +615,7 @@ const VIEWPORT_EXPANSION = -1, domTree = (e = {
       "scrollbar"
       // Scrollable control
     ]);
-    if (I.has(i) || A && g.has(A) || $ && g.has($)) return !0;
+    if (I.has(r) || $ && p.has($) || A && p.has(A)) return !0;
     try {
       if (typeof getEventListeners == "function") {
         const q = getEventListeners(t), nt = ["click", "mousedown", "mouseup", "dblclick"];
@@ -620,9 +623,9 @@ const VIEWPORT_EXPANSION = -1, domTree = (e = {
           if (q[j] && q[j].length > 0)
             return !0;
       }
-      const B = ((M = (C = t == null ? void 0 : t.ownerDocument) == null ? void 0 : C.defaultView) == null ? void 0 : M.getEventListenersForNode) || window.getEventListenersForNode;
-      if (typeof B == "function") {
-        const q = B(t), nt = [
+      const V = ((C = (M = t == null ? void 0 : t.ownerDocument) == null ? void 0 : M.defaultView) == null ? void 0 : C.getEventListenersForNode) || window.getEventListenersForNode;
+      if (typeof V == "function") {
+        const q = V(t), nt = [
           "click",
           "mousedown",
           "mouseup",
@@ -635,8 +638,8 @@ const VIEWPORT_EXPANSION = -1, domTree = (e = {
           "blur"
         ];
         for (const j of nt)
-          for (const S of q)
-            if (S.type === j)
+          for (const k of q)
+            if (k.type === j)
               return !0;
       }
       const G = ["onclick", "onmousedown", "onmouseup", "ondblclick"];
@@ -645,38 +648,38 @@ const VIEWPORT_EXPANSION = -1, domTree = (e = {
           return !0;
     } catch {
     }
-    return !!V(t);
+    return !!W(t);
   }
   function et(t) {
     if (l === -1)
       return !0;
-    const i = z(t);
-    if (!i || i.length === 0)
+    const r = z(t);
+    if (!r || r.length === 0)
       return !1;
-    let p = !1;
-    for (const m of i)
-      if (m.width > 0 && m.height > 0 && !// Only check non-empty rects
-      (m.bottom < -l || m.top > window.innerHeight + l || m.right < -l || m.left > window.innerWidth + l)) {
-        p = !0;
+    let m = !1;
+    for (const w of r)
+      if (w.width > 0 && w.height > 0 && !// Only check non-empty rects
+      (w.bottom < -l || w.top > window.innerHeight + l || w.right < -l || w.left > window.innerWidth + l)) {
+        m = !0;
         break;
       }
-    if (!p)
+    if (!m)
       return !1;
     if (t.ownerDocument !== window.document)
       return !0;
-    let a = Array.from(i).find((m) => m.width > 0 && m.height > 0);
+    let a = Array.from(r).find((w) => w.width > 0 && w.height > 0);
     if (!a)
       return !1;
     const x = t.getRootNode();
     if (x instanceof ShadowRoot) {
-      const m = a.left + a.width / 2, A = a.top + a.height / 2;
+      const w = a.left + a.width / 2, $ = a.top + a.height / 2;
       try {
-        const $ = x.elementFromPoint(m, A);
-        if (!$) return !1;
-        let g = $;
-        for (; g && g !== x; ) {
-          if (g === t) return !0;
-          g = g.parentElement;
+        const A = x.elementFromPoint(w, $);
+        if (!A) return !1;
+        let p = A;
+        for (; p && p !== x; ) {
+          if (p === t) return !0;
+          p = p.parentElement;
         }
         return !1;
       } catch {
@@ -693,14 +696,14 @@ const VIEWPORT_EXPANSION = -1, domTree = (e = {
       // { x: rect.left + margin, y: rect.bottom - margin },  // bottom left
       { x: a.right - E, y: a.bottom - E }
       // bottom right
-    ].some(({ x: m, y: A }) => {
+    ].some(({ x: w, y: $ }) => {
       try {
-        const $ = document.elementFromPoint(m, A);
-        if (!$) return !1;
-        let g = $;
-        for (; g && g !== document.documentElement; ) {
-          if (g === t) return !0;
-          g = g.parentElement;
+        const A = document.elementFromPoint(w, $);
+        if (!A) return !1;
+        let p = A;
+        for (; p && p !== document.documentElement; ) {
+          if (p === t) return !0;
+          p = p.parentElement;
         }
         return !1;
       } catch {
@@ -708,22 +711,22 @@ const VIEWPORT_EXPANSION = -1, domTree = (e = {
       }
     });
   }
-  function ot(t, i) {
-    if (i === -1)
+  function ot(t, r) {
+    if (r === -1)
       return !0;
-    const p = t.getClientRects();
-    if (!p || p.length === 0) {
-      const c = N(t);
-      return !c || c.width === 0 || c.height === 0 ? !1 : !(c.bottom < -i || c.top > window.innerHeight + i || c.right < -i || c.left > window.innerWidth + i);
+    const m = t.getClientRects();
+    if (!m || m.length === 0) {
+      const c = S(t);
+      return !c || c.width === 0 || c.height === 0 ? !1 : !(c.bottom < -r || c.top > window.innerHeight + r || c.right < -r || c.left > window.innerWidth + r);
     }
-    for (const c of p)
-      if (!(c.width === 0 || c.height === 0) && !(c.bottom < -i || c.top > window.innerHeight + i || c.right < -i || c.left > window.innerWidth + i))
+    for (const c of m)
+      if (!(c.width === 0 || c.height === 0) && !(c.bottom < -r || c.top > window.innerHeight + r || c.right < -r || c.left > window.innerWidth + r))
         return !0;
     return !1;
   }
-  function F(t) {
+  function O(t) {
     if (!t || t.nodeType !== Node.ELEMENT_NODE) return !1;
-    const i = t.tagName.toLowerCase();
+    const r = t.tagName.toLowerCase();
     return (/* @__PURE__ */ new Set([
       "a",
       "button",
@@ -733,7 +736,7 @@ const VIEWPORT_EXPANSION = -1, domTree = (e = {
       "details",
       "summary",
       "label"
-    ])).has(i) ? !0 : t.hasAttribute("onclick") || t.hasAttribute("role") || t.hasAttribute("tabindex") || t.hasAttribute("aria-") || t.hasAttribute("data-action") || t.getAttribute("contenteditable") === "true";
+    ])).has(r) ? !0 : t.hasAttribute("onclick") || t.hasAttribute("role") || t.hasAttribute("tabindex") || t.hasAttribute("aria-") || t.hasAttribute("data-action") || t.getAttribute("contenteditable") === "true";
   }
   const Y = /* @__PURE__ */ new Set([
     "a",
@@ -745,7 +748,7 @@ const VIEWPORT_EXPANSION = -1, domTree = (e = {
     "details",
     "label",
     "option"
-  ]), K = /* @__PURE__ */ new Set([
+  ]), J = /* @__PURE__ */ new Set([
     "button",
     "link",
     "menuitem",
@@ -766,22 +769,22 @@ const VIEWPORT_EXPANSION = -1, domTree = (e = {
   ]);
   function tt(t) {
     if (!t || t.nodeType !== Node.ELEMENT_NODE || !X(t)) return !1;
-    const i = t.hasAttribute("role") || t.hasAttribute("tabindex") || t.hasAttribute("onclick") || typeof t.onclick == "function", p = /\b(btn|clickable|menu|item|entry|link)\b/i.test(
+    const r = t.hasAttribute("role") || t.hasAttribute("tabindex") || t.hasAttribute("onclick") || typeof t.onclick == "function", m = /\b(btn|clickable|menu|item|entry|link)\b/i.test(
       t.className || ""
     ), c = !!t.closest('button,a,[role="button"],.menu,.dropdown,.list,.toolbar'), a = [...t.children].some(X), x = t.parentElement && t.parentElement.isSameNode(document.body);
-    return (L(t) || i || p) && a && c && !x;
+    return (L(t) || r || m) && a && c && !x;
   }
   function rt(t) {
     var c, a;
     if (!t || t.nodeType !== Node.ELEMENT_NODE)
       return !1;
-    const i = t.tagName.toLowerCase(), p = t.getAttribute("role");
-    if (i === "iframe" || Y.has(i) || p && K.has(p) || t.isContentEditable || t.getAttribute("contenteditable") === "true" || t.hasAttribute("data-testid") || t.hasAttribute("data-cy") || t.hasAttribute("data-test") || t.hasAttribute("onclick") || typeof t.onclick == "function")
+    const r = t.tagName.toLowerCase(), m = t.getAttribute("role");
+    if (r === "iframe" || Y.has(r) || m && J.has(m) || t.isContentEditable || t.getAttribute("contenteditable") === "true" || t.hasAttribute("data-testid") || t.hasAttribute("data-cy") || t.hasAttribute("data-test") || t.hasAttribute("onclick") || typeof t.onclick == "function")
       return !0;
     try {
       const x = ((a = (c = t == null ? void 0 : t.ownerDocument) == null ? void 0 : c.defaultView) == null ? void 0 : a.getEventListenersForNode) || window.getEventListenersForNode;
       if (typeof x == "function") {
-        const I = x(t), m = [
+        const I = x(t), w = [
           "click",
           "mousedown",
           "mouseup",
@@ -793,9 +796,9 @@ const VIEWPORT_EXPANSION = -1, domTree = (e = {
           "focus",
           "blur"
         ];
-        for (const A of m)
-          for (const $ of I)
-            if ($.type === A)
+        for (const $ of w)
+          for (const A of I)
+            if (A.type === $)
               return !0;
       }
       if ([
@@ -814,50 +817,50 @@ const VIEWPORT_EXPANSION = -1, domTree = (e = {
     }
     return !!tt(t);
   }
-  function st(t, i, p, c) {
+  function st(t, r, m, c) {
     if (!t.isInteractive) return !1;
     let a = !1;
-    return c ? rt(i) ? a = !0 : a = !1 : a = !0, a && (t.isInViewport = ot(i, l), (t.isInViewport || l === -1) && (t.highlightIndex = T++, d)) ? (r >= 0 ? r === t.highlightIndex && H(i, t.highlightIndex, p) : H(i, t.highlightIndex, p), !0) : !1;
+    return c ? rt(r) ? a = !0 : a = !1 : a = !0, a && (t.isInViewport = ot(r, l), (t.isInViewport || l === -1) && (t.highlightIndex = T++, d)) ? (s >= 0 ? s === t.highlightIndex && R(r, t.highlightIndex, m) : R(r, t.highlightIndex, m), !0) : !1;
   }
-  function Q(t, i = null, p = !1) {
-    var E, I, m, A, $;
+  function Q(t, r = null, m = !1) {
+    var E, I, w, $, A;
     if (!t || t.id === U || t.nodeType !== Node.ELEMENT_NODE && t.nodeType !== Node.TEXT_NODE || !t || t.id === U || ((E = t.dataset) == null ? void 0 : E.browserUseIgnore) === "true" || t.getAttribute && t.getAttribute("aria-hidden") === "true")
       return null;
     if (t === document.body) {
-      const g = {
+      const p = {
         tagName: "body",
         attributes: {},
         xpath: "/body",
         children: []
       };
-      for (const C of t.childNodes) {
-        const M = Q(C, i, !1);
-        M && g.children.push(M);
+      for (const M of t.childNodes) {
+        const C = Q(M, r, !1);
+        C && p.children.push(C);
       }
-      const y = `${R.current++}`;
-      return _[y] = g, y;
+      const y = `${H.current++}`;
+      return _[y] = p, y;
     }
     if (t.nodeType !== Node.ELEMENT_NODE && t.nodeType !== Node.TEXT_NODE)
       return null;
     if (t.nodeType === Node.TEXT_NODE) {
-      const g = (I = t.textContent) == null ? void 0 : I.trim();
-      if (!g)
+      const p = (I = t.textContent) == null ? void 0 : I.trim();
+      if (!p)
         return null;
       const y = t.parentElement;
       if (!y || y.tagName.toLowerCase() === "script")
         return null;
-      const C = `${R.current++}`;
-      return _[C] = {
+      const M = `${H.current++}`;
+      return _[M] = {
         type: "TEXT_NODE",
-        text: g,
-        isVisible: O(t)
-      }, C;
+        text: p,
+        isVisible: B(t)
+      }, M;
     }
     if (t.nodeType === Node.ELEMENT_NODE && !it(t))
       return null;
     if (l !== -1 && !t.shadowRoot) {
-      const g = N(t), y = D(t), C = y && (y.position === "fixed" || y.position === "sticky"), M = t.offsetWidth > 0 || t.offsetHeight > 0;
-      if (!g || !C && !M && (g.bottom < -l || g.top > window.innerHeight + l || g.right < -l || g.left > window.innerWidth + l))
+      const p = S(t), y = D(t), M = y && (y.position === "fixed" || y.position === "sticky"), C = t.offsetWidth > 0 || t.offsetHeight > 0;
+      if (!p || !M && !C && (p.bottom < -l || p.top > window.innerHeight + l || p.right < -l || p.left > window.innerWidth + l))
         return null;
     }
     const c = {
@@ -869,92 +872,92 @@ const VIEWPORT_EXPANSION = -1, domTree = (e = {
       // xpath: getXPathTree(node, true),
       children: []
     };
-    if (F(t) || t.tagName.toLowerCase() === "iframe" || t.tagName.toLowerCase() === "body") {
-      const g = ((m = t.getAttributeNames) == null ? void 0 : m.call(t)) || [];
-      for (const y of g) {
-        const C = t.getAttribute(y);
-        c.attributes[y] = C;
+    if (O(t) || t.tagName.toLowerCase() === "iframe" || t.tagName.toLowerCase() === "body") {
+      const p = ((w = t.getAttributeNames) == null ? void 0 : w.call(t)) || [];
+      for (const y of p) {
+        const M = t.getAttribute(y);
+        c.attributes[y] = M;
       }
       t.tagName.toLowerCase() === "input" && (t.type === "checkbox" || t.type === "radio") && (c.attributes.checked = t.checked ? "true" : "false");
     }
     let a = !1;
     if (t.nodeType === Node.ELEMENT_NODE && (c.isVisible = X(t), c.isVisible)) {
       c.isTopElement = et(t);
-      const g = t.getAttribute("role"), y = g === "menu" || g === "menubar" || g === "listbox";
-      (c.isTopElement || y) && (c.isInteractive = L(t), a = st(c, t, i, p), c.ref = t);
+      const p = t.getAttribute("role"), y = p === "menu" || p === "menubar" || p === "listbox";
+      (c.isTopElement || y) && (c.isInteractive = L(t), a = st(c, t, r, m), c.ref = t);
     }
     if (t.tagName) {
-      const g = t.tagName.toLowerCase();
-      if (g === "iframe")
+      const p = t.tagName.toLowerCase();
+      if (p === "iframe")
         try {
-          const y = t.contentDocument || ((A = t.contentWindow) == null ? void 0 : A.document);
+          const y = t.contentDocument || (($ = t.contentWindow) == null ? void 0 : $.document);
           if (y)
-            for (const C of y.childNodes) {
-              const M = Q(C, t, !1);
-              M && c.children.push(M);
+            for (const M of y.childNodes) {
+              const C = Q(M, t, !1);
+              C && c.children.push(C);
             }
         } catch (y) {
           console.warn("Unable to access iframe:", y);
         }
-      else if (t.isContentEditable || t.getAttribute("contenteditable") === "true" || t.id === "tinymce" || t.classList.contains("mce-content-body") || g === "body" && (($ = t.getAttribute("data-id")) != null && $.startsWith("mce_")))
+      else if (t.isContentEditable || t.getAttribute("contenteditable") === "true" || t.id === "tinymce" || t.classList.contains("mce-content-body") || p === "body" && ((A = t.getAttribute("data-id")) != null && A.startsWith("mce_")))
         for (const y of t.childNodes) {
-          const C = Q(y, i, a);
-          C && c.children.push(C);
+          const M = Q(y, r, a);
+          M && c.children.push(M);
         }
       else {
         if (t.shadowRoot) {
           c.shadowRoot = !0;
           for (const y of t.shadowRoot.childNodes) {
-            const C = Q(y, i, a);
-            C && c.children.push(C);
+            const M = Q(y, r, a);
+            M && c.children.push(M);
           }
         }
         for (const y of t.childNodes) {
-          const M = Q(y, i, a || p);
-          M && c.children.push(M);
+          const C = Q(y, r, a || m);
+          C && c.children.push(C);
         }
       }
     }
     if (c.tagName === "a" && c.children.length === 0 && !c.attributes.href) {
-      const g = N(t);
-      if (!(g && g.width > 0 && g.height > 0 || t.offsetWidth > 0 || t.offsetHeight > 0))
+      const p = S(t);
+      if (!(p && p.width > 0 && p.height > 0 || t.offsetWidth > 0 || t.offsetHeight > 0))
         return null;
     }
     c.extra = b.get(t) || null;
-    const x = `${R.current++}`;
+    const x = `${H.current++}`;
     return _[x] = c, x;
   }
   const lt = Q(document.body);
-  return f.clearCache(), { rootId: lt, map: _ };
+  return g.clearCache(), { rootId: lt, map: _ };
 }, newElementsCache = /* @__PURE__ */ new WeakMap();
 function getFlatTree(e) {
   const n = [];
   for (const d of e.interactiveBlacklist || [])
     typeof d == "function" ? n.push(d()) : n.push(d);
-  const s = [];
+  const i = [];
   for (const d of e.interactiveWhitelist || [])
-    typeof d == "function" ? s.push(d()) : s.push(d);
+    typeof d == "function" ? i.push(d()) : i.push(d);
   const o = domTree({
     doHighlightElements: !0,
     debugMode: !0,
     focusHighlightIndex: -1,
     viewportExpansion: VIEWPORT_EXPANSION,
     interactiveBlacklist: n,
-    interactiveWhitelist: s,
+    interactiveWhitelist: i,
     highlightOpacity: e.highlightOpacity ?? 0,
     highlightLabelOpacity: e.highlightLabelOpacity ?? 0.1
-  }), w = window.location.href;
+  }), f = window.location.href;
   for (const d in o.map) {
-    const r = o.map[d];
-    if (r.isInteractive && r.ref) {
-      const l = r.ref;
-      newElementsCache.has(l) || (newElementsCache.set(l, w), r.isNew = !0);
+    const s = o.map[d];
+    if (s.isInteractive && s.ref) {
+      const l = s.ref;
+      newElementsCache.has(l) || (newElementsCache.set(l, f), s.isNew = !0);
     }
   }
   return o;
 }
 function flatTreeToString(e, n) {
-  const s = [
+  const i = [
     "title",
     "type",
     "checked",
@@ -977,140 +980,140 @@ function flatTreeToString(e, n) {
     "aria-haspopup",
     "aria-controls",
     "aria-owns"
-  ], o = [...n || [], ...s], w = (u, f) => u.length > f ? u.substring(0, f) + "..." : u, d = (u) => {
-    const f = e.map[u];
-    if (!f) return null;
-    if (f.type === "TEXT_NODE") {
-      const N = f;
+  ], o = [...n || [], ...i], f = (u, g) => u.length > g ? u.substring(0, g) + "..." : u, d = (u) => {
+    const g = e.map[u];
+    if (!g) return null;
+    if (g.type === "TEXT_NODE") {
+      const S = g;
       return {
         type: "text",
-        text: N.text,
-        isVisible: N.isVisible,
+        text: S.text,
+        isVisible: S.isVisible,
         parent: null,
         children: []
       };
     } else {
-      const N = f, D = [];
-      if (N.children)
-        for (const z of N.children) {
+      const S = g, D = [];
+      if (S.children)
+        for (const z of S.children) {
           const _ = d(z);
           _ && (_.parent = null, D.push(_));
         }
       return {
         type: "element",
-        tagName: N.tagName,
-        attributes: N.attributes ?? {},
-        isVisible: N.isVisible ?? !1,
-        isInteractive: N.isInteractive ?? !1,
-        isTopElement: N.isTopElement ?? !1,
-        isNew: N.isNew ?? !1,
-        highlightIndex: N.highlightIndex,
+        tagName: S.tagName,
+        attributes: S.attributes ?? {},
+        isVisible: S.isVisible ?? !1,
+        isInteractive: S.isInteractive ?? !1,
+        isTopElement: S.isTopElement ?? !1,
+        isNew: S.isNew ?? !1,
+        highlightIndex: S.highlightIndex,
         parent: null,
         children: D,
-        extra: N.extra ?? {}
+        extra: S.extra ?? {}
       };
     }
-  }, r = (u, f = null) => {
-    u.parent = f;
-    for (const N of u.children)
-      r(N, u);
+  }, s = (u, g = null) => {
+    u.parent = g;
+    for (const S of u.children)
+      s(S, u);
   }, l = d(e.rootId);
   if (!l) return "";
-  r(l);
+  s(l);
   const h = (u) => {
-    let f = u.parent;
-    for (; f; ) {
-      if (f.type === "element" && f.highlightIndex !== void 0)
+    let g = u.parent;
+    for (; g; ) {
+      if (g.type === "element" && g.highlightIndex !== void 0)
         return !0;
-      f = f.parent;
+      g = g.parent;
     }
     return !1;
-  }, T = (u, f, N) => {
-    var _, R, U, H;
-    let D = f;
-    const z = "	".repeat(f);
+  }, T = (u, g, S) => {
+    var _, H, U, R;
+    let D = g;
+    const z = "	".repeat(g);
     if (u.type === "element") {
       if (u.highlightIndex !== void 0) {
         D += 1;
-        const V = getAllTextTillNextClickableElement(u);
-        let O = "";
+        const W = getAllTextTillNextClickableElement(u);
+        let B = "";
         if (o.length > 0 && u.attributes) {
           const L = {};
-          for (const F of o) {
-            const Y = u.attributes[F];
-            Y && Y.trim() !== "" && (L[F] = Y.trim());
+          for (const O of o) {
+            const Y = u.attributes[O];
+            Y && Y.trim() !== "" && (L[O] = Y.trim());
           }
-          const et = o.filter((F) => F in L);
+          const et = o.filter((O) => O in L);
           if (et.length > 1) {
-            const F = /* @__PURE__ */ new Set(), Y = {};
-            for (const K of et) {
-              const tt = L[K];
-              tt.length > 5 && (tt in Y ? F.add(K) : Y[tt] = K);
+            const O = /* @__PURE__ */ new Set(), Y = {};
+            for (const J of et) {
+              const tt = L[J];
+              tt.length > 5 && (tt in Y ? O.add(J) : Y[tt] = J);
             }
-            for (const K of F)
-              delete L[K];
+            for (const J of O)
+              delete L[J];
           }
           L.role === u.tagName && delete L.role;
           const ot = ["aria-label", "placeholder", "title"];
-          for (const F of ot)
-            L[F] && L[F].toLowerCase().trim() === V.toLowerCase().trim() && delete L[F];
-          Object.keys(L).length > 0 && (O = Object.entries(L).map(([F, Y]) => `${F}=${w(Y, 20)}`).join(" "));
+          for (const O of ot)
+            L[O] && L[O].toLowerCase().trim() === W.toLowerCase().trim() && delete L[O];
+          Object.keys(L).length > 0 && (B = Object.entries(L).map(([O, Y]) => `${O}=${f(Y, 20)}`).join(" "));
         }
         const it = u.isNew ? `*[${u.highlightIndex}]` : `[${u.highlightIndex}]`;
         let X = `${z}${it}<${u.tagName ?? ""}`;
-        if (O && (X += ` ${O}`), u.extra && u.extra.scrollable) {
+        if (B && (X += ` ${B}`), u.extra && u.extra.scrollable) {
           let L = "";
-          (_ = u.extra.scrollData) != null && _.left && (L += `left=${u.extra.scrollData.left}, `), (R = u.extra.scrollData) != null && R.top && (L += `top=${u.extra.scrollData.top}, `), (U = u.extra.scrollData) != null && U.right && (L += `right=${u.extra.scrollData.right}, `), (H = u.extra.scrollData) != null && H.bottom && (L += `bottom=${u.extra.scrollData.bottom}`), X += ` data-scrollable="${L}"`;
+          (_ = u.extra.scrollData) != null && _.left && (L += `left=${u.extra.scrollData.left}, `), (H = u.extra.scrollData) != null && H.top && (L += `top=${u.extra.scrollData.top}, `), (U = u.extra.scrollData) != null && U.right && (L += `right=${u.extra.scrollData.right}, `), (R = u.extra.scrollData) != null && R.bottom && (L += `bottom=${u.extra.scrollData.bottom}`), X += ` data-scrollable="${L}"`;
         }
-        if (V) {
-          const L = V.trim();
-          O || (X += " "), X += `>${L}`;
-        } else O || (X += " ");
-        X += " />", N.push(X);
+        if (W) {
+          const L = W.trim();
+          B || (X += " "), X += `>${L}`;
+        } else B || (X += " ");
+        X += " />", S.push(X);
       }
-      for (const V of u.children)
-        T(V, D, N);
+      for (const W of u.children)
+        T(W, D, S);
     } else if (u.type === "text") {
       if (h(u))
         return;
-      u.parent && u.parent.type === "element" && u.parent.isVisible && u.parent.isTopElement && N.push(`${z}${u.text ?? ""}`);
+      u.parent && u.parent.type === "element" && u.parent.isVisible && u.parent.isTopElement && S.push(`${z}${u.text ?? ""}`);
     }
   }, b = [];
   return T(l, 0, b), b.join(`
 `);
 }
 const getAllTextTillNextClickableElement = (e, n = -1) => {
-  const s = [], o = (w, d) => {
-    if (!(n !== -1 && d > n) && !(w.type === "element" && w !== e && w.highlightIndex !== void 0)) {
-      if (w.type === "text" && w.text)
-        s.push(w.text);
-      else if (w.type === "element")
-        for (const r of w.children)
-          o(r, d + 1);
+  const i = [], o = (f, d) => {
+    if (!(n !== -1 && d > n) && !(f.type === "element" && f !== e && f.highlightIndex !== void 0)) {
+      if (f.type === "text" && f.text)
+        i.push(f.text);
+      else if (f.type === "element")
+        for (const s of f.children)
+          o(s, d + 1);
     }
   };
-  return o(e, 0), s.join(`
+  return o(e, 0), i.join(`
 `).trim();
 };
 function getSelectorMap(e) {
-  const n = /* @__PURE__ */ new Map(), s = Object.keys(e.map);
-  for (const o of s) {
-    const w = e.map[o];
-    w.isInteractive && typeof w.highlightIndex == "number" && n.set(w.highlightIndex, w);
+  const n = /* @__PURE__ */ new Map(), i = Object.keys(e.map);
+  for (const o of i) {
+    const f = e.map[o];
+    f.isInteractive && typeof f.highlightIndex == "number" && n.set(f.highlightIndex, f);
   }
   return n;
 }
 function getElementTextMap(e) {
   const n = e.split(`
-`).map((o) => o.trim()).filter((o) => o.length > 0), s = /* @__PURE__ */ new Map();
+`).map((o) => o.trim()).filter((o) => o.length > 0), i = /* @__PURE__ */ new Map();
   for (const o of n) {
     const d = /^\[(\d+)\]<[^>]+>([^<]*)/.exec(o);
     if (d) {
-      const r = parseInt(d[1], 10);
-      s.set(r, o);
+      const s = parseInt(d[1], 10);
+      i.set(s, o);
     }
   }
-  return s;
+  return i;
 }
 function cleanUpHighlights() {
   const e = window._highlightCleanupFunctions || [];
@@ -1139,27 +1142,27 @@ else {
   }, 500);
 }
 function getPageInfo() {
-  const e = window.innerWidth, n = window.innerHeight, s = Math.max(document.documentElement.scrollWidth, document.body.scrollWidth || 0), o = Math.max(
+  const e = window.innerWidth, n = window.innerHeight, i = Math.max(document.documentElement.scrollWidth, document.body.scrollWidth || 0), o = Math.max(
     document.documentElement.scrollHeight,
     document.body.scrollHeight || 0
-  ), w = window.scrollX || window.pageXOffset || document.documentElement.scrollLeft || 0, d = window.scrollY || window.pageYOffset || document.documentElement.scrollTop || 0, r = Math.max(0, o - (window.innerHeight + d)), l = Math.max(0, s - (window.innerWidth + w));
+  ), f = window.scrollX || window.pageXOffset || document.documentElement.scrollLeft || 0, d = window.scrollY || window.pageYOffset || document.documentElement.scrollTop || 0, s = Math.max(0, o - (window.innerHeight + d)), l = Math.max(0, i - (window.innerWidth + f));
   return {
     // Current viewport dimensions
     viewport_width: e,
     viewport_height: n,
     // Total page dimensions
-    page_width: s,
+    page_width: i,
     page_height: o,
     // Current scroll position
-    scroll_x: w,
+    scroll_x: f,
     scroll_y: d,
     pixels_above: d,
-    pixels_below: r,
+    pixels_below: s,
     pages_above: n > 0 ? d / n : 0,
-    pages_below: n > 0 ? r / n : 0,
+    pages_below: n > 0 ? s / n : 0,
     total_pages: n > 0 ? o / n : 0,
     current_page_position: d / Math.max(1, o - n),
-    pixels_left: w,
+    pixels_left: f,
     pixels_right: l
   };
 }
@@ -1167,8 +1170,8 @@ function patchReact(e) {
   const n = document.querySelectorAll(
     '[data-reactroot], [data-reactid], [data-react-checksum], #root, #app, [id^="root-"], [id^="app-"], #adex-wrapper, #adex-root'
   );
-  for (const s of n)
-    s.setAttribute("data-page-agent-not-interactive", "true");
+  for (const i of n)
+    i.setAttribute("data-page-agent-not-interactive", "true");
 }
 class PageController extends EventTarget {
   constructor(e = {}) {
@@ -1201,15 +1204,15 @@ class PageController extends EventTarget {
    * Automatically calls updateTree() to refresh the DOM state.
    */
   async getBrowserState() {
-    const e = window.location.href, n = document.title, s = getPageInfo(), o = this.config.viewportExpansion ?? VIEWPORT_EXPANSION;
+    const e = window.location.href, n = document.title, i = getPageInfo(), o = this.config.viewportExpansion ?? VIEWPORT_EXPANSION;
     await this.updateTree();
-    const w = this.simplifiedHTML, d = `Current Page: [${n}](${e})`, r = `Page info: ${s.viewport_width}x${s.viewport_height}px viewport, ${s.page_width}x${s.page_height}px total page size, ${s.pages_above.toFixed(1)} pages above, ${s.pages_below.toFixed(1)} pages below, ${s.total_pages.toFixed(1)} total pages, at ${(s.current_page_position * 100).toFixed(0)}% of page`, l = o === -1 ? "Interactive elements from top layer of the current page (full page):" : "Interactive elements from top layer of the current page inside the viewport:", T = s.pixels_above > 4 && o !== -1 ? `... ${s.pixels_above} pixels above (${s.pages_above.toFixed(1)} pages) - scroll to see more ...` : "[Start of page]", b = `${d}
-${r}
+    const f = this.simplifiedHTML, d = `Current Page: [${n}](${e})`, s = `Page info: ${i.viewport_width}x${i.viewport_height}px viewport, ${i.page_width}x${i.page_height}px total page size, ${i.pages_above.toFixed(1)} pages above, ${i.pages_below.toFixed(1)} pages below, ${i.total_pages.toFixed(1)} total pages, at ${(i.current_page_position * 100).toFixed(0)}% of page`, l = o === -1 ? "Interactive elements from top layer of the current page (full page):" : "Interactive elements from top layer of the current page inside the viewport:", T = i.pixels_above > 4 && o !== -1 ? `... ${i.pixels_above} pixels above (${i.pages_above.toFixed(1)} pages) - scroll to see more ...` : "[Start of page]", b = `${d}
+${s}
 
 ${l}
 
-${T}`, f = s.pixels_below > 4 && o !== -1 ? `... ${s.pixels_below} pixels below (${s.pages_below.toFixed(1)} pages) - scroll to see more ...` : "[End of page]";
-    return { url: e, title: n, header: b, content: w, footer: f };
+${T}`, g = i.pixels_below > 4 && o !== -1 ? `... ${i.pixels_below} pixels below (${i.pages_below.toFixed(1)} pages) - scroll to see more ...` : "[End of page]";
+    return { url: e, title: n, header: b, content: f, footer: g };
   }
   // ======= DOM Tree Operations =======
   /**
@@ -1249,13 +1252,13 @@ ${T}`, f = s.pixels_below > 4 && o !== -1 ? `... ${s.pixels_below} pixels below
   async clickElement(e) {
     try {
       this.assertIndexed();
-      const n = getElementByIndex(this.selectorMap, e), s = this.elementTextMap.get(e);
+      const n = getElementByIndex(this.selectorMap, e), i = this.elementTextMap.get(e);
       return await clickElement(n), n instanceof HTMLAnchorElement && n.target === "_blank" ? {
         success: !0,
-        message: `✅ Clicked element (${s ?? e}). ⚠️ Link opens in a new tab. You are not capable of reading new tabs.`
+        message: `✅ Clicked element (${i ?? e}). ⚠️ Link opens in a new tab. You are not capable of reading new tabs.`
       } : {
         success: !0,
-        message: `✅ Clicked element (${s ?? e}).`
+        message: `✅ Clicked element (${i ?? e}).`
       };
     } catch (n) {
       return {
@@ -1270,15 +1273,15 @@ ${T}`, f = s.pixels_below > 4 && o !== -1 ? `... ${s.pixels_below} pixels below
   async inputText(e, n) {
     try {
       this.assertIndexed();
-      const s = getElementByIndex(this.selectorMap, e), o = this.elementTextMap.get(e);
-      return await inputTextElement(s, n), {
+      const i = getElementByIndex(this.selectorMap, e), o = this.elementTextMap.get(e);
+      return await inputTextElement(i, n), {
         success: !0,
         message: `✅ Input text (${n}) into element (${o ?? e}).`
       };
-    } catch (s) {
+    } catch (i) {
       return {
         success: !1,
-        message: `❌ Failed to input text: ${s}`
+        message: `❌ Failed to input text: ${i}`
       };
     }
   }
@@ -1288,15 +1291,15 @@ ${T}`, f = s.pixels_below > 4 && o !== -1 ? `... ${s.pixels_below} pixels below
   async selectOption(e, n) {
     try {
       this.assertIndexed();
-      const s = getElementByIndex(this.selectorMap, e), o = this.elementTextMap.get(e);
-      return await selectOptionElement(s, n), {
+      const i = getElementByIndex(this.selectorMap, e), o = this.elementTextMap.get(e);
+      return await selectOptionElement(i, n), {
         success: !0,
         message: `✅ Selected option (${n}) in element (${o ?? e}).`
       };
-    } catch (s) {
+    } catch (i) {
       return {
         success: !1,
-        message: `❌ Failed to select option: ${s}`
+        message: `❌ Failed to select option: ${i}`
       };
     }
   }
@@ -1305,12 +1308,12 @@ ${T}`, f = s.pixels_below > 4 && o !== -1 ? `... ${s.pixels_below} pixels below
    */
   async scroll(e) {
     try {
-      const { down: n, numPages: s, pixels: o, index: w } = e;
+      const { down: n, numPages: i, pixels: o, index: f } = e;
       this.assertIndexed();
-      const d = o ?? s * (n ? 1 : -1) * window.innerHeight, r = w !== void 0 ? getElementByIndex(this.selectorMap, w) : null;
+      const d = o ?? i * (n ? 1 : -1) * window.innerHeight, s = f !== void 0 ? getElementByIndex(this.selectorMap, f) : null;
       return {
         success: !0,
-        message: await scrollVertically(n, d, r)
+        message: await scrollVertically(n, d, s)
       };
     } catch (n) {
       return {
@@ -1324,12 +1327,12 @@ ${T}`, f = s.pixels_below > 4 && o !== -1 ? `... ${s.pixels_below} pixels below
    */
   async scrollHorizontally(e) {
     try {
-      const { right: n, pixels: s, index: o } = e;
+      const { right: n, pixels: i, index: o } = e;
       this.assertIndexed();
-      const w = s * (n ? 1 : -1), d = o !== void 0 ? getElementByIndex(this.selectorMap, o) : null;
+      const f = i * (n ? 1 : -1), d = o !== void 0 ? getElementByIndex(this.selectorMap, o) : null;
       return {
         success: !0,
-        message: await scrollHorizontally(n, w, d)
+        message: await scrollHorizontally(n, f, d)
       };
     } catch (n) {
       return {
@@ -1355,6 +1358,209 @@ ${T}`, f = s.pixels_below > 4 && o !== -1 ? `... ${s.pixels_below} pixels below
       };
     }
   }
+  // ======= Workflow Element Finding =======
+  /**
+   * Find an interactive element index by visible text (exact match).
+   * Scans the elementTextMap for a match.
+   */
+  findElementByText(e, n = !0) {
+    const i = e.trim().toLowerCase();
+    for (const [o, f] of this.elementTextMap.entries()) {
+      const d = f.trim().toLowerCase();
+      if (n) {
+        if (d === i || d.includes(i))
+          return o;
+      } else if (d.includes(i) || i.includes(d))
+        return o;
+    }
+    return null;
+  }
+  /**
+   * Find an interactive element index by CSS selector.
+   * Queries the DOM, then reverse-looks up in selectorMap.
+   */
+  findElementBySelector(e) {
+    try {
+      const n = document.querySelector(e);
+      if (!n) return null;
+      for (const [o, f] of this.selectorMap.entries())
+        if (f.ref === n) return o;
+      let i = n.parentElement;
+      for (; i && i !== document.body; ) {
+        for (const [o, f] of this.selectorMap.entries())
+          if (f.ref === i) return o;
+        i = i.parentElement;
+      }
+      return null;
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * Find an interactive element index by XPath.
+   * Evaluates the XPath, then reverse-looks up in selectorMap.
+   */
+  findElementByXPath(e) {
+    try {
+      const i = document.evaluate(
+        e,
+        document,
+        null,
+        XPathResult.FIRST_ORDERED_NODE_TYPE,
+        null
+      ).singleNodeValue;
+      if (!i) return null;
+      for (const [o, f] of this.selectorMap.entries())
+        if (f.ref === i) return o;
+      return null;
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * Find an interactive element index by aria-label attribute.
+   */
+  findElementByAriaLabel(e) {
+    return this.findElementBySelector(`[aria-label="${CSS.escape(e)}"]`);
+  }
+  /**
+   * Find an interactive element index by placeholder text.
+   */
+  findElementByPlaceholder(e) {
+    return this.findElementBySelector(`[placeholder="${CSS.escape(e)}"]`);
+  }
+  /**
+   * Multi-strategy element finder. Tries strategies in priority order.
+   * Returns the index of the first match, or null if nothing found.
+   */
+  findElementByStrategies(e) {
+    const n = [...e].sort((i, o) => i.priority - o.priority);
+    for (const i of n) {
+      let o = null;
+      switch (i.type) {
+        case "text_exact":
+          o = this.findElementByText(i.value, !0);
+          break;
+        case "text_contains":
+          o = this.findElementByText(i.value, !1);
+          break;
+        case "aria_label":
+          o = this.findElementByAriaLabel(i.value);
+          break;
+        case "placeholder":
+          o = this.findElementByPlaceholder(i.value);
+          break;
+        case "css":
+          o = this.findElementBySelector(i.value);
+          break;
+        case "xpath":
+          o = this.findElementByXPath(i.value);
+          break;
+      }
+      if (o !== null) return o;
+    }
+    return null;
+  }
+  // ======= New Workflow Actions =======
+  /**
+   * Press a key on an element (or the active element if no index provided).
+   */
+  async pressKey(e, n) {
+    try {
+      let i;
+      return n !== void 0 ? (this.assertIndexed(), i = getElementByIndex(this.selectorMap, n)) : i = document.activeElement || document.body, await createSyntheticInputEvent(i, e), {
+        success: !0,
+        message: `✅ Pressed key "${e}" on element.`
+      };
+    } catch (i) {
+      return {
+        success: !1,
+        message: `❌ Failed to press key: ${i}`
+      };
+    }
+  }
+  /**
+   * Navigate to a URL. Restricts to same-origin http(s) URLs for security.
+   */
+  async navigateToUrl(e) {
+    try {
+      const n = new URL(e, window.location.origin);
+      return n.protocol !== "http:" && n.protocol !== "https:" ? {
+        success: !1,
+        message: `❌ Blocked navigation to disallowed scheme: ${n.protocol}`
+      } : n.origin !== window.location.origin ? {
+        success: !1,
+        message: `❌ Blocked cross-origin navigation to ${n.origin}`
+      } : (window.location.href = n.href, {
+        success: !0,
+        message: `✅ Navigating to ${n.href}`
+      });
+    } catch (n) {
+      return {
+        success: !1,
+        message: `❌ Failed to navigate: ${n}`
+      };
+    }
+  }
+  /**
+   * Go back in browser history.
+   */
+  async goBack() {
+    try {
+      return window.history.back(), {
+        success: !0,
+        message: "✅ Navigated back."
+      };
+    } catch (e) {
+      return {
+        success: !1,
+        message: `❌ Failed to go back: ${e}`
+      };
+    }
+  }
+  /**
+   * Go forward in browser history.
+   */
+  async goForward() {
+    try {
+      return window.history.forward(), {
+        success: !0,
+        message: "✅ Navigated forward."
+      };
+    } catch (e) {
+      return {
+        success: !1,
+        message: `❌ Failed to go forward: ${e}`
+      };
+    }
+  }
+  /**
+   * Wait until an element matching the given strategies appears in the DOM,
+   * or until the timeout is reached. Refreshes the DOM tree on each poll.
+   */
+  async waitForElement(e, n = 3e3, i = 300) {
+    const o = Date.now();
+    for (; Date.now() - o < n; ) {
+      await this.updateTree();
+      const f = this.findElementByStrategies(e);
+      if (f !== null) return f;
+      await new Promise((d) => setTimeout(d, i));
+    }
+    return null;
+  }
+  // ======= Accessors for WorkflowExecutor =======
+  /**
+   * Get the current selectorMap (for external use like WorkflowExecutor).
+   */
+  getSelectorMap() {
+    return this.selectorMap;
+  }
+  /**
+   * Get the current elementTextMap (for external use like WorkflowExecutor).
+   */
+  getElementTextMap() {
+    return this.elementTextMap;
+  }
   // ======= Mask Operations =======
   /**
    * Show the visual mask overlay.