@enricai/barnacle 1.12.78 → 1.12.80

package/dist/scraper/actionable-visibility-expr.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ACTIONABLE_VISIBILITY_EXPR = void 0;
+/**
+ * Single browser-context predicate (as an evaluable function-expression
+ * string) deciding whether an element is a legitimate click target. It
+ * exists so every click-target consumer shares one definition: an
+ * `aria-hidden="true"` decorative duplicate sharing text with the real
+ * control must never be scanned, ranked or clicked. Only the element's own
+ * attribute is checked — ancestors commonly carry `aria-hidden` on app-root
+ * containers behind modals — and `tabindex="-1"` is deliberately not
+ * excluded because focus-managed custom controls use it legitimately.
+ */
+exports.ACTIONABLE_VISIBILITY_EXPR = `((el) => {
+  if (!el) return false;
+  if (el.getAttribute("aria-hidden") === "true") return false;
+  const rect = el.getBoundingClientRect();
+  if (rect.width === 0 && rect.height === 0) return false;
+  const style = getComputedStyle(el);
+  return style.display !== "none" && style.visibility !== "hidden";
+})`;
+//# sourceMappingURL=actionable-visibility-expr.js.map

package/dist/scraper/actionable-visibility-expr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionable-visibility-expr.js","sourceRoot":"","sources":["../../src/scraper/actionable-visibility-expr.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;GASG;AACU,QAAA,0BAA0B,GAAG;;;;;;;GAOvC,CAAC"}

package/dist/scraper/active-page.d.ts

@@ -0,0 +1,18 @@
+export interface FollowablePage {
+    waitForLoadState?(state: "domcontentloaded", timeoutMs?: number): Promise<void>;
+    url?(): string;
+    close?(): Promise<void>;
+}
+export interface FollowableContext<P extends FollowablePage> {
+    pages(): P[];
+    setActivePage?(page: P): void;
+}
+/**
+ * Single source of truth for which page the run drives after a click: when the
+ * click opened a new browsing context (non-self anchor target or window.open),
+ * adopts the newest page, waits boundedly for it to load, closes the stale
+ * tab so the context keeps a single driven tab, and returns the adopted page.
+ * Returns `current` unchanged when no page appeared, so repeat calls are idempotent.
+ */
+export declare function followNewPage<P extends FollowablePage>(context: FollowableContext<P>, current: P, pagesBefore: readonly P[], discoverWaitMs?: number): Promise<P>;
+//# sourceMappingURL=active-page.d.ts.map

package/dist/scraper/active-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-page.d.ts","sourceRoot":"","sources":["../../src/scraper/active-page.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,gBAAgB,CAAC,CAAC,KAAK,EAAE,kBAAkB,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChF,GAAG,CAAC,IAAI,MAAM,CAAC;IACf,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,cAAc;IACzD,KAAK,IAAI,CAAC,EAAE,CAAC;IACb,aAAa,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;CAC/B;AAgBD;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,CAAC,SAAS,cAAc,EAC1D,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC7B,OAAO,EAAE,CAAC,EACV,WAAW,EAAE,SAAS,CAAC,EAAE,EACzB,cAAc,GAAE,MAAyB,GACxC,OAAO,CAAC,CAAC,CAAC,CA+BZ"}

package/dist/scraper/active-page.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.followNewPage = followNewPage;
+const frame_target_1 = require("./frame-target");
+const LOAD_WAIT_MS = 10000;
+const DISCOVER_POLL_MS = 100;
+const DISCOVER_WAIT_MS = 1500;
+const BLANK_URL_WAIT_MS = 5000;
+const isBlankUrl = (page) => {
+    try {
+        const url = page.url?.() ?? "";
+        return url === "" || url === "about:blank";
+    }
+    catch {
+        return false;
+    }
+};
+/**
+ * Single source of truth for which page the run drives after a click: when the
+ * click opened a new browsing context (non-self anchor target or window.open),
+ * adopts the newest page, waits boundedly for it to load, closes the stale
+ * tab so the context keeps a single driven tab, and returns the adopted page.
+ * Returns `current` unchanged when no page appeared, so repeat calls are idempotent.
+ */
+async function followNewPage(context, current, pagesBefore, discoverWaitMs = DISCOVER_WAIT_MS) {
+    const known = new Set(pagesBefore);
+    const findNew = () => context
+        .pages()
+        .filter((p) => !known.has(p))
+        .at(-1);
+    const polls = Math.max(0, Math.ceil(discoverWaitMs / DISCOVER_POLL_MS));
+    let opened = findNew();
+    for (let i = 0; !opened && i < polls; i++) {
+        await (0, frame_target_1.sleep)(DISCOVER_POLL_MS);
+        opened = findNew();
+    }
+    if (!opened || opened === current)
+        return current;
+    await Promise.race([
+        opened.waitForLoadState?.("domcontentloaded", LOAD_WAIT_MS).catch(() => undefined),
+        (0, frame_target_1.sleep)(LOAD_WAIT_MS),
+    ]);
+    // A new tab starts at about:blank before its navigation commits; adopting it
+    // then would verify and capture an empty document.
+    for (let waited = 0; isBlankUrl(opened) && waited < BLANK_URL_WAIT_MS; waited += DISCOVER_POLL_MS) {
+        await (0, frame_target_1.sleep)(DISCOVER_POLL_MS);
+    }
+    // Closing first lets the context re-pick its active page before we pin ours.
+    await current.close?.().catch(() => undefined);
+    context.setActivePage?.(opened);
+    return opened;
+}
+//# sourceMappingURL=active-page.js.map

package/dist/scraper/active-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-page.js","sourceRoot":"","sources":["../../src/scraper/active-page.ts"],"names":[],"mappings":";;;AAAA,yDAA+C;AAa/C,MAAM,YAAY,GAAG,KAAK,CAAC;AAC3B,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAC7B,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAC9B,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAE/B,MAAM,UAAU,GAAG,CAAC,IAAoB,EAAW,EAAE;IACnD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC;QAC/B,OAAO,GAAG,KAAK,EAAE,IAAI,GAAG,KAAK,aAAa,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;GAMG;AACI,KAAK,wBACV,OAA6B,EAC7B,OAAU,EACV,WAAyB,EACzB,cAAc,GAAW,gBAAgB;IAEzC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAI,WAAW,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,GAAkB,EAAE,CAClC,OAAO;SACJ,KAAK,EAAE;SACP,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;SAC5B,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACZ,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc,GAAG,gBAAgB,CAAC,CAAC,CAAC;IACxE,IAAI,MAAM,GAAG,OAAO,EAAE,CAAC;IACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,IAAA,oBAAK,EAAC,gBAAgB,CAAC,CAAC;QAC9B,MAAM,GAAG,OAAO,EAAE,CAAC;IACrB,CAAC;IACD,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IAClD,MAAM,OAAO,CAAC,IAAI,CAAC;QACjB,MAAM,CAAC,gBAAgB,EAAE,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;QAClF,IAAA,oBAAK,EAAC,YAAY,CAAC;KACpB,CAAC,CAAC;IACH,6EAA6E;IAC7E,mDAAmD;IACnD,KACE,IAAI,MAAM,GAAG,CAAC,EACd,UAAU,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,iBAAiB,EAChD,MAAM,IAAI,gBAAgB,EAC1B,CAAC;QACD,MAAM,IAAA,oBAAK,EAAC,gBAAgB,CAAC,CAAC;IAChC,CAAC;IACD,6EAA6E;IAC7E,MAAM,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC/C,OAAO,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC,CAAC;IAChC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/scraper/browser-click-expr.d.ts

@@ -160,7 +160,7 @@ export declare const DEEP_ELEMENTS_EXPR = "((root) => {\n  const out = [];\n  co
  * descendant qualifies, so the caller falls back unchanged to clicking
  * `host` itself.
  */
-export declare const RESOLVE_SHADOW_INTERACTIVE_DESCENDANT_EXPR = "((host) => {\n  if (!host || !host.shadowRoot) return null;\n  const isVisible = (el) => {\n    const rect = el.getBoundingClientRect();\n    if (rect.width === 0 && rect.height === 0) return false;\n    const style = getComputedStyle(el);\n    return style.display !== \"none\" && style.visibility !== \"hidden\";\n  };\n  const isDisabled = (el) =>\n    el.disabled === true || el.getAttribute(\"aria-disabled\") === \"true\";\n  const isInteractive = (el) => {\n    const tag = (el.tagName || \"\").toLowerCase();\n    const role = (el.getAttribute(\"role\") || \"\").toLowerCase();\n    if (tag === \"button\" || tag === \"select\" || tag === \"textarea\") return true;\n    if (tag === \"a\" && el.hasAttribute(\"href\")) return true;\n    if (tag === \"input\" && ![\"hidden\"].includes((el.getAttribute(\"type\") || \"\").toLowerCase())) return true;\n    if (role === \"button\" || role === \"link\" || role === \"checkbox\" || role === \"radio\" || role === \"menuitem\")\n      return true;\n    if (el.hasAttribute(\"onclick\")) return true;\n    const tabIndex = el.getAttribute(\"tabindex\");\n    return tabIndex !== null && Number(tabIndex) >= 0;\n  };\n  const deepElements = ((root) => {\n  const out = [];\n  const walk = (node) => {\n    const kids = node.querySelectorAll ? Array.from(node.querySelectorAll(\"*\")) : [];\n    for (const el of kids) {\n      out.push(el);\n      if (el.shadowRoot) walk(el.shadowRoot);\n    }\n  };\n  walk(root);\n  return out;\n})(host.shadowRoot);\n  for (const el of deepElements) {\n    if (isInteractive(el) && isVisible(el) && !isDisabled(el)) return el;\n  }\n  return null;\n})";
+export declare const RESOLVE_SHADOW_INTERACTIVE_DESCENDANT_EXPR = "((host) => {\n  if (!host || !host.shadowRoot) return null;\n  const isVisible = ((el) => {\n  if (!el) return false;\n  if (el.getAttribute(\"aria-hidden\") === \"true\") return false;\n  const rect = el.getBoundingClientRect();\n  if (rect.width === 0 && rect.height === 0) return false;\n  const style = getComputedStyle(el);\n  return style.display !== \"none\" && style.visibility !== \"hidden\";\n});\n  const isDisabled = (el) =>\n    el.disabled === true || el.getAttribute(\"aria-disabled\") === \"true\";\n  const isInteractive = (el) => {\n    const tag = (el.tagName || \"\").toLowerCase();\n    const role = (el.getAttribute(\"role\") || \"\").toLowerCase();\n    if (tag === \"button\" || tag === \"select\" || tag === \"textarea\") return true;\n    if (tag === \"a\" && el.hasAttribute(\"href\")) return true;\n    if (tag === \"input\" && ![\"hidden\"].includes((el.getAttribute(\"type\") || \"\").toLowerCase())) return true;\n    if (role === \"button\" || role === \"link\" || role === \"checkbox\" || role === \"radio\" || role === \"menuitem\")\n      return true;\n    if (el.hasAttribute(\"onclick\")) return true;\n    const tabIndex = el.getAttribute(\"tabindex\");\n    return tabIndex !== null && Number(tabIndex) >= 0;\n  };\n  const deepElements = ((root) => {\n  const out = [];\n  const walk = (node) => {\n    const kids = node.querySelectorAll ? Array.from(node.querySelectorAll(\"*\")) : [];\n    for (const el of kids) {\n      out.push(el);\n      if (el.shadowRoot) walk(el.shadowRoot);\n    }\n  };\n  walk(root);\n  return out;\n})(host.shadowRoot);\n  for (const el of deepElements) {\n    if (isInteractive(el) && isVisible(el) && !isDisabled(el)) return el;\n  }\n  return null;\n})";
 /**
  * Result shape `buildMarkShadowInteractiveDescendantExpr`'s `page.evaluate`
  * call resolves to.

package/dist/scraper/browser-click-expr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser-click-expr.d.ts","sourceRoot":"","sources":["../../src/scraper/browser-click-expr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,UAOlC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,qCAAqC,QAA+B,CAAC;AAElF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,sCAAsC,0EACsB,CAAC;AAE1E;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,mCAAmC,sIAC6E,CAAC;AAE9H;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAoCvF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAsBzD;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,0SAW5B,CAAC;AAEJ;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,0CAA0C,4mDA2BpD,CAAC;AAEJ;;;GAGG;AACH,MAAM,WAAW,qCAAqC;IACpD,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,wCAAwC,CACtD,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,MAAM,CAWR;AAED;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,MAAM,CAQR"}
+{"version":3,"file":"browser-click-expr.d.ts","sourceRoot":"","sources":["../../src/scraper/browser-click-expr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH;;;;;;;;;;;;;;;;;;GAkBG;AACH;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,UAOlC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,qCAAqC,QAA+B,CAAC;AAElF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,sCAAsC,0EACsB,CAAC;AAE1E;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,mCAAmC,sIAC6E,CAAC;AAE9H;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAoCvF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAsBzD;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,0SAW5B,CAAC;AAEJ;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,0CAA0C,ksDAsBpD,CAAC;AAEJ;;;GAGG;AACH,MAAM,WAAW,qCAAqC;IACpD,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,wCAAwC,CACtD,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,MAAM,CAWR;AAED;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,MAAM,CAQR"}

package/dist/scraper/browser-click-expr.js

@@ -27,6 +27,7 @@ exports.retargetToSelectionMarkerExpr = retargetToSelectionMarkerExpr;
 exports.clickActivationExpr = clickActivationExpr;
 exports.buildMarkShadowInteractiveDescendantExpr = buildMarkShadowInteractiveDescendantExpr;
 exports.buildUnmarkShadowDescendantExpr = buildUnmarkShadowDescendantExpr;
+const actionable_visibility_expr_1 = require("./actionable-visibility-expr");
 /**
  * Emits a browser-context statement block that activates the element bound to
  * `elVar`: focus, then a `pointerdown → mousedown → pointerup → mouseup` gesture
@@ -245,12 +246,7 @@ exports.DEEP_ELEMENTS_EXPR = `((root) => {
  */
 exports.RESOLVE_SHADOW_INTERACTIVE_DESCENDANT_EXPR = `((host) => {
   if (!host || !host.shadowRoot) return null;
-  const isVisible = (el) => {
-    const rect = el.getBoundingClientRect();
-    if (rect.width === 0 && rect.height === 0) return false;
-    const style = getComputedStyle(el);
-    return style.display !== "none" && style.visibility !== "hidden";
-  };
+  const isVisible = ${actionable_visibility_expr_1.ACTIONABLE_VISIBILITY_EXPR};
   const isDisabled = (el) =>
     el.disabled === true || el.getAttribute("aria-disabled") === "true";
   const isInteractive = (el) => {

package/dist/scraper/browser-click-expr.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser-click-expr.js","sourceRoot":"","sources":["../../src/scraper/browser-click-expr.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;;;;;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH;;;;;GAKG;AACU,QAAA,sBAAsB,GAAG;IACpC,QAAQ;IACR,KAAK;IACL,QAAQ;IACR,OAAO;IACP,UAAU;IACV,kBAAkB;CACnB,CAAC;AAEF;;;;;;GAMG;AACU,QAAA,qCAAqC,GAAG,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAElF;;;;;;;;;;;;;;;;;GAiBG;AACU,QAAA,sCAAsC,GACjD,uEAAuE,CAAC;AAE1E;;;;;;;;;;;;;;;;;GAiBG;AACU,QAAA,mCAAmC,GAC9C,2HAA2H,CAAC;AAE9H;;;;;;;GAOG;AACU,QAAA,4BAA4B,GAAG,CAAC,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,uCAA8C,KAAa,EAAE,UAAkB;IAC7E,OAAO;gCACuB,IAAI,CAAC,SAAS,CAAC,QAAA,sBAAsB,CAAC;yBAC7C,IAAI,CAAC,SAAS,CAAC,QAAA,qCAAqC,CAAC;0BACpD,QAAA,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;qBA0B3C,KAAK;0CACgB,QAAA,4BAA4B;uCAC/B,KAAK,gBAAgB,UAAU;;;IAGlE,CAAC;AACL,CAAC;AAED,6BAAoC,KAAa;IAC/C,OAAO;iBACQ,KAAK,kCAAkC,KAAK;;;;;;;;;;;;;MAavD,KAAK;MACL,KAAK;MACL,KAAK;MACL,KAAK;iBACM,KAAK,kCAAkC,KAAK;aAChD,KAAK;IACd,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACU,QAAA,kBAAkB,GAAG;;;;;;;;;;;GAW/B,CAAC;AAEJ;;;;;;;;;;;;;;;;;;;;;GAqBG;AACU,QAAA,0CAA0C,GAAG;;;;;;;;;;;;;;;;;;;;;;yBAsBjC,QAAA,kBAAkB;;;;;GAKxC,CAAC;AAUJ;;;;;;;;;;;;;;;;GAgBG;AACH,kDACE,SAAiB,EACjB,UAAkB,EAClB,WAAmB;IAEnB,OAAO;kCACyB,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;;;iDAGV,QAAA,0CAA0C;;;8BAG7D,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;;OAEjF,CAAC;AACR,CAAC;AAED;;;;;;;;GAQG;AACH,yCACE,SAAiB,EACjB,UAAkB,EAClB,WAAmB;IAEnB,OAAO;kCACyB,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;;;mDAGR,IAAI,CAAC,SAAS,CAAC,IAAI,UAAU,KAAK,WAAW,IAAI,CAAC;yCAC5D,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;OAC5D,CAAC;AACR,CAAC"}
+{"version":3,"file":"browser-click-expr.js","sourceRoot":"","sources":["../../src/scraper/browser-click-expr.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;;;;;AAEH,qFAAkF;AAElF;;;;;;;;;;;;;;;;;;GAkBG;AACH;;;;;GAKG;AACU,QAAA,sBAAsB,GAAG;IACpC,QAAQ;IACR,KAAK;IACL,QAAQ;IACR,OAAO;IACP,UAAU;IACV,kBAAkB;CACnB,CAAC;AAEF;;;;;;GAMG;AACU,QAAA,qCAAqC,GAAG,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAElF;;;;;;;;;;;;;;;;;GAiBG;AACU,QAAA,sCAAsC,GACjD,uEAAuE,CAAC;AAE1E;;;;;;;;;;;;;;;;;GAiBG;AACU,QAAA,mCAAmC,GAC9C,2HAA2H,CAAC;AAE9H;;;;;;;GAOG;AACU,QAAA,4BAA4B,GAAG,CAAC,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,uCAA8C,KAAa,EAAE,UAAkB;IAC7E,OAAO;gCACuB,IAAI,CAAC,SAAS,CAAC,QAAA,sBAAsB,CAAC;yBAC7C,IAAI,CAAC,SAAS,CAAC,QAAA,qCAAqC,CAAC;0BACpD,QAAA,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;qBA0B3C,KAAK;0CACgB,QAAA,4BAA4B;uCAC/B,KAAK,gBAAgB,UAAU;;;IAGlE,CAAC;AACL,CAAC;AAED,6BAAoC,KAAa;IAC/C,OAAO;iBACQ,KAAK,kCAAkC,KAAK;;;;;;;;;;;;;MAavD,KAAK;MACL,KAAK;MACL,KAAK;MACL,KAAK;iBACM,KAAK,kCAAkC,KAAK;aAChD,KAAK;IACd,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACU,QAAA,kBAAkB,GAAG;;;;;;;;;;;GAW/B,CAAC;AAEJ;;;;;;;;;;;;;;;;;;;;;GAqBG;AACU,QAAA,0CAA0C,GAAG;;sBAEpC,uDAA0B;;;;;;;;;;;;;;;yBAevB,QAAA,kBAAkB;;;;;GAKxC,CAAC;AAUJ;;;;;;;;;;;;;;;;GAgBG;AACH,kDACE,SAAiB,EACjB,UAAkB,EAClB,WAAmB;IAEnB,OAAO;kCACyB,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;;;iDAGV,QAAA,0CAA0C;;;8BAG7D,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;;OAEjF,CAAC;AACR,CAAC;AAED;;;;;;;;GAQG;AACH,yCACE,SAAiB,EACjB,UAAkB,EAClB,WAAmB;IAEnB,OAAO;kCACyB,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;;;mDAGR,IAAI,CAAC,SAAS,CAAC,IAAI,UAAU,KAAK,WAAW,IAAI,CAAC;yCAC5D,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;OAC5D,CAAC;AACR,CAAC"}

package/dist/scraper/click-settle.d.ts

@@ -0,0 +1,19 @@
+export interface SettlePage {
+    waitForTimeout(ms: number): Promise<void>;
+}
+export interface SettleCounter {
+    n: number;
+}
+/**
+ * Waits for a click's network activity to settle so the verification snapshot
+ * reflects the post-click page rather than a fixed-delay guess. Elapsed time is
+ * accumulated from poll counts so fake pages and timers stay deterministic.
+ * When `readText` is given, visible-text movement since the pre-click baseline
+ * also counts as activity, so a DOM-only re-render that lands after the first
+ * change is not snapshotted half-transitioned; the wait ends once activity has been quiet for the quiet window and is
+ * bounded by the MAX_MS ceiling so a never-quiet page still terminates.
+ * Only submit-shaped steps keep the long idle wait for a slow round-trip to start;
+ * any other click that shows no activity after one quiet poll gives up.
+ */
+export declare function settleAfterClick(page: SettlePage, counter: SettleCounter, preCount: number, submitShaped: boolean, readText?: () => Promise<string>, preText?: string): Promise<void>;
+//# sourceMappingURL=click-settle.d.ts.map

package/dist/scraper/click-settle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"click-settle.d.ts","sourceRoot":"","sources":["../../src/scraper/click-settle.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,MAAM,CAAC;CACX;AAQD;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,OAAO,EACrB,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,EAChC,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAwCf"}

package/dist/scraper/click-settle.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.settleAfterClick = settleAfterClick;
+const POLL_MS = 1000;
+const QUIET_POLLS = 3;
+const IDLE_GIVE_UP_MS = 14000;
+const TEXT_QUIET_POLLS = 9;
+const MAX_MS = 60000;
+/**
+ * Waits for a click's network activity to settle so the verification snapshot
+ * reflects the post-click page rather than a fixed-delay guess. Elapsed time is
+ * accumulated from poll counts so fake pages and timers stay deterministic.
+ * When `readText` is given, visible-text movement since the pre-click baseline
+ * also counts as activity, so a DOM-only re-render that lands after the first
+ * change is not snapshotted half-transitioned; the wait ends once activity has been quiet for the quiet window and is
+ * bounded by the MAX_MS ceiling so a never-quiet page still terminates.
+ * Only submit-shaped steps keep the long idle wait for a slow round-trip to start;
+ * any other click that shows no activity after one quiet poll gives up.
+ */
+async function settleAfterClick(page, counter, preCount, submitShaped, readText, preText) {
+    const safeRead = async () => {
+        if (!readText)
+            return undefined;
+        try {
+            return await readText();
+        }
+        catch {
+            return undefined;
+        }
+    };
+    const startText = await safeRead();
+    let lastText = preText ?? startText;
+    let textMoved = preText !== undefined && startText !== undefined && startText !== preText;
+    let seen = counter.n > preCount || textMoved;
+    let last = counter.n;
+    let quiet = 0;
+    let elapsed = 0;
+    while (elapsed < MAX_MS) {
+        await page.waitForTimeout(POLL_MS);
+        elapsed += POLL_MS;
+        const text = await safeRead();
+        if (text !== undefined && lastText !== undefined && text !== lastText) {
+            lastText = text;
+            textMoved = true;
+            seen = true;
+            quiet = 0;
+            continue;
+        }
+        if (counter.n !== last) {
+            last = counter.n;
+            seen = true;
+            quiet = 0;
+            continue;
+        }
+        if (seen) {
+            quiet += 1;
+            if (quiet >= (textMoved ? TEXT_QUIET_POLLS : QUIET_POLLS))
+                return;
+            continue;
+        }
+        if (!submitShaped || elapsed >= IDLE_GIVE_UP_MS)
+            return;
+    }
+}
+//# sourceMappingURL=click-settle.js.map

package/dist/scraper/click-settle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"click-settle.js","sourceRoot":"","sources":["../../src/scraper/click-settle.ts"],"names":[],"mappings":";;;AAQA,MAAM,OAAO,GAAG,IAAI,CAAC;AACrB,MAAM,WAAW,GAAG,CAAC,CAAC;AACtB,MAAM,eAAe,GAAG,KAAK,CAAC;AAC9B,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAC3B,MAAM,MAAM,GAAG,KAAK,CAAC;AAErB;;;;;;;;;;GAUG;AACI,KAAK,2BACV,IAAgB,EAChB,OAAsB,EACtB,QAAgB,EAChB,YAAqB,EACrB,QAAgC,EAChC,OAAgB;IAEhB,MAAM,QAAQ,GAAG,KAAK,IAAiC,EAAE;QACvD,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAS,CAAC;QAChC,IAAI,CAAC;YACH,OAAO,MAAM,QAAQ,EAAE,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC,CAAC;IACF,MAAM,SAAS,GAAG,MAAM,QAAQ,EAAE,CAAC;IACnC,IAAI,QAAQ,GAAG,OAAO,IAAI,SAAS,CAAC;IACpC,IAAI,SAAS,GAAG,OAAO,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,OAAO,CAAC;IAC1F,IAAI,IAAI,GAAG,OAAO,CAAC,CAAC,GAAG,QAAQ,IAAI,SAAS,CAAC;IAC7C,IAAI,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC;IACrB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,OAAO,OAAO,GAAG,MAAM,EAAE,CAAC;QACxB,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QACnC,OAAO,IAAI,OAAO,CAAC;QACnB,MAAM,IAAI,GAAG,MAAM,QAAQ,EAAE,CAAC;QAC9B,IAAI,IAAI,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtE,QAAQ,GAAG,IAAI,CAAC;YAChB,SAAS,GAAG,IAAI,CAAC;YACjB,IAAI,GAAG,IAAI,CAAC;YACZ,KAAK,GAAG,CAAC,CAAC;YACV,SAAS;QACX,CAAC;QACD,IAAI,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACvB,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC;YACjB,IAAI,GAAG,IAAI,CAAC;YACZ,KAAK,GAAG,CAAC,CAAC;YACV,SAAS;QACX,CAAC;QACD,IAAI,IAAI,EAAE,CAAC;YACT,KAAK,IAAI,CAAC,CAAC;YACX,IAAI,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,WAAW,CAAC;gBAAE,OAAO;YAClE,SAAS;QACX,CAAC;QACD,IAAI,CAAC,YAAY,IAAI,OAAO,IAAI,eAAe;YAAE,OAAO;IAC1D,CAAC;AACH,CAAC"}

package/dist/scraper/deep-locator-candidates.d.ts

@@ -97,7 +97,8 @@ export interface TaggedPhrase {
  * boundary (`.`/`;`) between the marker and the phrase ends the negation's
  * reach. Parallels the quoted-phrase extraction convention in
  * `parseSelectStep`/`parseRadioStep` (`flow-runner.ts`) — same
- * `/'([^']+)'/g` shape — but here we need ALL quoted phrases plus their
+ * apostrophe-aware tokenizer (`quoted-spans.ts`), so a letter-flanked
+ * apostrophe never ends a phrase — but here we need ALL quoted phrases plus their
  * polarity, not just one option/label pair. Exported so `flow-runner.ts` can
  * re-derive the exact same ranking {@link scoreCandidate} used to sort
  * `deepLocatorCandidates`, to detect a tie for the top rank rather than
@@ -141,6 +142,24 @@ export declare function extractTaggedPhrases(instruction: string): TaggedPhrase[
  * output (see {@link extractTaggedPhrases}'s docblock).
  */
 export declare function scoreCandidate(accessibleText: string, phrases: TaggedPhrase[], isNav?: boolean): number;
+/** Outcome of {@link vetObserveCandidates}: the best-scoring candidate, its score, and whether the caller should refuse to act on it. */
+export interface ObserveCandidateVerdict<T extends {
+    description: string;
+}> {
+    candidate: T | undefined;
+    score: number;
+    refuse: boolean;
+}
+/**
+ * Picks the best observe() candidate for the step's quoted phrases and decides
+ * whether acting on it would hit a control the step did not name. Reuses
+ * {@link scoreCandidate} so the veto can never drift from the ranking tiers;
+ * a lone candidate is enough to refuse, since observe() returns its best
+ * guess even when nothing matches.
+ */
+export declare function vetObserveCandidates<T extends {
+    description: string;
+}>(candidates: T[], phrases: TaggedPhrase[]): ObserveCandidateVerdict<T>;
 /**
  * Enumerates every element `page.deepLocator()` matches inside the frame
  * scoped by `frameSelector`, ranked by relevance to `instruction` (highest

package/dist/scraper/deep-locator-candidates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deep-locator-candidates.d.ts","sourceRoot":"","sources":["../../src/scraper/deep-locator-candidates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAWrD,OAAO,EAEL,KAAK,WAAW,EAEjB,MAAM,wBAAwB,CAAC;AA2BhC,sJAAsJ;AACtJ,MAAM,WAAW,yBAAyB;IACxC,mIAAmI;IACnI,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uJAAuJ;IACvJ,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;;;;;;;;;;;;OAgBG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B;;;;;;;;;;;;;OAaG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAKD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,oBAAoB;IACnC,kJAAkJ;IAClJ,KAAK,EAAE,MAAM,CAAC;IACd,gLAAgL;IAChL,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;;;;;;OAOG;IACH,KAAK,EAAE,OAAO,CAAC;CAChB;AAsBD,sJAAsJ;AACtJ,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,EAAE,CAaxE;AAkCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,cAAc,CAC5B,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,YAAY,EAAE,EACvB,KAAK,UAAQ,GACZ,MAAM,CAiBR;AA+JD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,IAAI,EACV,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACxC,aAAa,EAAE,MAAM,EACrB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,EAC3B,cAAc,GAAE,yBAA8B,GAC7C,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAuCjC;AAwDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,IAAI,EACV,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACxC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EACb,cAAc,GAAE,yBAA8B,GAC7C,OAAO,CAAC,IAAI,CAAC,CAiCf;AAED;;;;;;;;GAQG"}
+{"version":3,"file":"deep-locator-candidates.d.ts","sourceRoot":"","sources":["../../src/scraper/deep-locator-candidates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAYrD,OAAO,EAEL,KAAK,WAAW,EAEjB,MAAM,wBAAwB,CAAC;AAiChC,sJAAsJ;AACtJ,MAAM,WAAW,yBAAyB;IACxC,mIAAmI;IACnI,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uJAAuJ;IACvJ,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;;;;;;;;;;;;OAgBG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B;;;;;;;;;;;;;OAaG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAKD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,oBAAoB;IACnC,kJAAkJ;IAClJ,KAAK,EAAE,MAAM,CAAC;IACd,gLAAgL;IAChL,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;;;;;;OAOG;IACH,KAAK,EAAE,OAAO,CAAC;CAChB;AAsBD,sJAAsJ;AACtJ,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,EAAE,CAYxE;AAkCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,cAAc,CAC5B,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,YAAY,EAAE,EACvB,KAAK,UAAQ,GACZ,MAAM,CAiBR;AAED,yIAAyI;AACzI,MAAM,WAAW,uBAAuB,CAAC,CAAC,SAAS;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE;IACxE,SAAS,EAAE,CAAC,GAAG,SAAS,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,EACpE,UAAU,EAAE,CAAC,EAAE,EACf,OAAO,EAAE,YAAY,EAAE,GACtB,uBAAuB,CAAC,CAAC,CAAC,CAoB5B;AAsMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,IAAI,EACV,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACxC,aAAa,EAAE,MAAM,EACrB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,EAC3B,cAAc,GAAE,yBAA8B,GAC7C,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAoCjC;AAwDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,IAAI,EACV,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACxC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EACb,cAAc,GAAE,yBAA8B,GAC7C,OAAO,CAAC,IAAI,CAAC,CAwCf;AAqCD;;;;;;;;GAQG"}

package/dist/scraper/deep-locator-candidates.js

@@ -12,12 +12,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.extractTaggedPhrases = extractTaggedPhrases;
 exports.scoreCandidate = scoreCandidate;
+exports.vetObserveCandidates = vetObserveCandidates;
 exports.resolveDeepLocatorCandidates = resolveDeepLocatorCandidates;
 exports.clickDeepLocatorCandidate = clickDeepLocatorCandidate;
 const errors_1 = require("../lib/errors");
 const logging_1 = require("../lib/logging");
 const deep_locator_scan_1 = require("./deep-locator-scan");
 const frame_target_1 = require("./frame-target");
+const quoted_spans_1 = require("./quoted-spans");
+const trusted_click_1 = require("./trusted-click");
 const watchdog_1 = require("./watchdog");
 const logger = (0, logging_1.getLogger)({ name: "scraper/deep-locator-candidates" });
 /**
@@ -66,23 +69,23 @@ const NEGATION_MARKERS = /\b(?:do\s+not|don't|never|avoid)\b/gi;
  * boundary (`.`/`;`) between the marker and the phrase ends the negation's
  * reach. Parallels the quoted-phrase extraction convention in
  * `parseSelectStep`/`parseRadioStep` (`flow-runner.ts`) — same
- * `/'([^']+)'/g` shape — but here we need ALL quoted phrases plus their
+ * apostrophe-aware tokenizer (`quoted-spans.ts`), so a letter-flanked
+ * apostrophe never ends a phrase — but here we need ALL quoted phrases plus their
  * polarity, not just one option/label pair. Exported so `flow-runner.ts` can
  * re-derive the exact same ranking {@link scoreCandidate} used to sort
  * `deepLocatorCandidates`, to detect a tie for the top rank rather than
  * duplicating this logic.
  */
 function extractTaggedPhrases(instruction) {
-    const negationStarts = [...instruction.matchAll(NEGATION_MARKERS)].map((m) => m.index);
-    const quoted = [...instruction.matchAll(/'([^']+)'/g)];
-    return quoted.map((m) => {
-        // biome-ignore lint/style/noNonNullAssertion: m.index is always defined for matchAll results
-        const phraseStart = m.index;
-        const nearestNegationBefore = negationStarts.filter((idx) => idx < phraseStart).at(-1);
+    const spans = (0, quoted_spans_1.findQuotedSpans)(instruction);
+    const negationStarts = [...instruction.matchAll(NEGATION_MARKERS)]
+        .map((m) => m.index)
+        .filter((idx) => !spans.some((span) => idx >= span.start && idx < span.end));
+    return spans.map((span) => {
+        const nearestNegationBefore = negationStarts.filter((idx) => idx < span.start).at(-1);
         const negated = nearestNegationBefore !== undefined &&
-            !/[.;]/.test(instruction.slice(nearestNegationBefore, phraseStart));
-        // biome-ignore lint/style/noNonNullAssertion: capture group 1 is required by the pattern, so it is present on every match
-        return { text: m[1].trim(), negated };
+            !/[.;]/.test(instruction.slice(nearestNegationBefore, span.start));
+        return { text: span.text.trim(), negated };
     });
 }
 /** Normalizes text for relevance comparison: lowercase, whitespace-collapsed. */
@@ -167,6 +170,36 @@ function scoreCandidate(accessibleText, phrases, isNav = false) {
         return -1;
     return 0;
 }
+/**
+ * Picks the best observe() candidate for the step's quoted phrases and decides
+ * whether acting on it would hit a control the step did not name. Reuses
+ * {@link scoreCandidate} so the veto can never drift from the ranking tiers;
+ * a lone candidate is enough to refuse, since observe() returns its best
+ * guess even when nothing matches.
+ */
+function vetObserveCandidates(candidates, phrases) {
+    const first = candidates[0];
+    if (!first || phrases.length === 0)
+        return { candidate: first, score: 0, refuse: false };
+    const scored = candidates.map((candidate) => ({
+        candidate,
+        score: scoreCandidate(candidate.description, phrases),
+    }));
+    const best = scored.reduce((a, b) => (b.score > a.score ? b : a));
+    if (best.score < 0)
+        return { candidate: best.candidate, score: best.score, refuse: true };
+    if (best.score > 0)
+        return { candidate: best.candidate, score: best.score, refuse: false };
+    const positives = phrases.filter((p) => !p.negated).map((p) => normalize(p.text));
+    const text = normalize(best.candidate.description);
+    const betterExists = scored.some((s) => s.score > 0);
+    // A context phrase ("under the text 'X'") adds a second positive, so require the
+    // candidate to overlap none of them rather than exactly one.
+    const namesNone = positives.length > 0 &&
+        text.length > 0 &&
+        positives.every((p) => !text.includes(p) && !p.includes(text));
+    return { candidate: best.candidate, score: 0, refuse: betterExists || namesNone };
+}
 /**
  * Resolves the `FrameTarget` the batched scan should evaluate against:
  * `timeoutOptions.frameTarget` when the caller already resolved one, else a
@@ -223,36 +256,56 @@ function isFrameCandidateScanResult(entry) {
  * so a frame whose every node reports unrendered doesn't silently look like
  * an empty frame.
  */
-async function scanFrameCandidatesBatched(page, frameSelector, innerSelector, hopSelector, timeoutOptions) {
-    const frameTarget = await resolveScanFrameTarget(page, frameSelector, timeoutOptions);
+async function scanFrameCandidatesBatched(frameTarget, innerSelector, hopSelector) {
     if (!frameTarget)
-        return null;
+        return { candidates: null, seamResponsive: false };
     let scanResults;
     try {
         scanResults = await frameTarget.evaluate((0, deep_locator_scan_1.buildScanFrameCandidatesExpr)(innerSelector));
     }
     catch (err) {
         logger.warn(`deepLocator batched scan for ${hopSelector} failed, degrading to per-candidate enumeration: ${(0, errors_1.toErrorMessage)(err)}`);
-        return null;
+        return { candidates: null, seamResponsive: false };
     }
     if (!Array.isArray(scanResults) || !scanResults.every(isFrameCandidateScanResult)) {
         logger.warn(`deepLocator batched scan for ${hopSelector} returned a non-conforming payload, degrading to per-candidate enumeration`);
-        return null;
+        return { candidates: null, seamResponsive: false };
     }
     if (scanResults.length === 0) {
         logger.warn(`deepLocator batched scan for ${hopSelector} matched zero elements, degrading to per-candidate enumeration in case a shadow-DOM control was missed`);
-        return null;
+        return { candidates: null, seamResponsive: true };
     }
     const visibleResults = scanResults.filter((entry) => entry.visible);
     if (visibleResults.length < scanResults.length) {
         logger.warn(`deepLocator batched scan for ${hopSelector} dropped ${scanResults.length - visibleResults.length} unrendered candidate(s)`);
     }
-    return visibleResults.map((entry) => ({
+    const candidates = visibleResults.map((entry) => ({
         index: entry.index,
         selector: candidateSelector(hopSelector, entry.index),
         accessibleText: entry.text.trim(),
         isNav: entry.isNav === true,
     }));
+    return { candidates, seamResponsive: true };
+}
+/**
+ * One frame evaluate naming the match indices that fail the shared
+ * actionable-visibility predicate, for the legacy loop: a Stagehand `Locator`
+ * has no per-element evaluate (and `isVisible()` ignores `aria-hidden`), so an
+ * `aria-hidden` decoy can only be recognised from the frame. Returns an empty
+ * set (never throws) when there is no frame seam or the read fails, which
+ * leaves the loop's behavior as it was without a seam.
+ */
+async function readNonActionableIndices(frameTarget, innerSelector, hopSelector) {
+    if (!frameTarget)
+        return new Set();
+    try {
+        const indices = await frameTarget.evaluate((0, deep_locator_scan_1.buildNonActionableIndicesExpr)(innerSelector));
+        return new Set(Array.isArray(indices) ? indices.filter((i) => typeof i === "number") : []);
+    }
+    catch (err) {
+        logger.warn(`deepLocator non-actionable read for ${hopSelector} failed, enumerating without it: ${(0, errors_1.toErrorMessage)(err)}`);
+        return new Set();
+    }
 }
 /**
  * Legacy fallback: `count()` then one `nth(index).textContent()` round-trip
@@ -265,7 +318,7 @@ async function scanFrameCandidatesBatched(page, frameSelector, innerSelector, ho
  * (detached frame, navigated-away element) or either call exceeding its
  * watchdog budget degrades to `[]`/an empty `accessibleText`.
  */
-async function enumerateCandidatesViaLegacyLoop(delegate, hopSelector, callTimeoutMs, enumerationBudgetMs) {
+async function enumerateCandidatesViaLegacyLoop(delegate, frameTarget, innerSelector, hopSelector, callTimeoutMs, enumerationBudgetMs) {
     const count = await (0, watchdog_1.withWatchdog)(() => delegate.count(), {
         timeoutMs: callTimeoutMs,
         label: `deepLocator count() for ${hopSelector}`,
@@ -275,6 +328,7 @@ async function enumerateCandidatesViaLegacyLoop(delegate, hopSelector, callTimeo
     });
     if (count === 0)
         return [];
+    const nonActionable = await readNonActionableIndices(frameTarget, innerSelector, hopSelector);
     const candidates = [];
     const enumerationDeadline = Date.now() + enumerationBudgetMs;
     for (let index = 0; index < count; index++) {
@@ -282,6 +336,8 @@ async function enumerateCandidatesViaLegacyLoop(delegate, hopSelector, callTimeo
             logger.warn(`deepLocator enumeration for ${hopSelector} aborted after exceeding ${enumerationBudgetMs}ms budget at candidate ${index}/${count}`);
             break;
         }
+        if (nonActionable.has(index))
+            continue;
         const accessibleText = await (0, watchdog_1.withWatchdog)(() => delegate.nth(index).textContent(), {
             timeoutMs: callTimeoutMs,
             label: `deepLocator textContent() for ${hopSelector} nth=${index}`,
@@ -338,9 +394,10 @@ async function resolveDeepLocatorCandidates(page, frameSelector, innerSelector,
         logger.warn(`deepLocator() is unavailable on this page for ${hopSelector}`);
         return [];
     }
-    const batchedCandidates = await scanFrameCandidatesBatched(page, frameSelector, innerSelector, hopSelector, timeoutOptions);
-    const candidates = batchedCandidates ??
-        (await enumerateCandidatesViaLegacyLoop(delegate, hopSelector, callTimeoutMs, enumerationBudgetMs));
+    const frameTarget = await resolveScanFrameTarget(page, frameSelector, timeoutOptions);
+    const scan = await scanFrameCandidatesBatched(frameTarget, innerSelector, hopSelector);
+    const candidates = scan.candidates ??
+        (await enumerateCandidatesViaLegacyLoop(delegate, scan.seamResponsive ? frameTarget : null, innerSelector, hopSelector, callTimeoutMs, enumerationBudgetMs));
     if (!instruction)
         return candidates;
     const phrases = extractTaggedPhrases(instruction);
@@ -461,11 +518,42 @@ async function clickDeepLocatorCandidate(page, frameSelector, innerSelector, ind
             return;
     }
     const scaledCallTimeoutMs = callTimeoutMs + index * deep_locator_scan_1.DEEP_LOCATOR_CLICK_INDEX_ROUND_TRIP_MS;
-    await (0, watchdog_1.withWatchdog)(() => page.deepLocator(hopSelector).nth(index).click(), {
+    await (0, watchdog_1.withWatchdog)(() => clickLocatorCentred(page.deepLocator(hopSelector).nth(index), `${hopSelector} nth=${index}`), {
         timeoutMs: scaledCallTimeoutMs,
         label: `deepLocator click() for ${hopSelector} nth=${index}`,
     });
 }
+/**
+ * Centres the deep-locator target and hit-tests its click point before the
+ * trusted click, via `resolveNode().objectId` + `Runtime.callFunctionOn` (the
+ * top-window helper cannot reach an iframe/OOPIF). A locator exposing no
+ * resolvable node or session degrades to a plain `click()`.
+ */
+async function clickLocatorCentred(locator, label) {
+    const session = locator.frame?.session;
+    const resolveNode = locator.resolveNode?.bind(locator);
+    if (!resolveNode || !session) {
+        await locator.click();
+        return;
+    }
+    const evaluateOnElement = async (functionDeclaration) => {
+        const { objectId } = await resolveNode();
+        if (!objectId)
+            return { state: "missing" };
+        try {
+            const res = (await session.send("Runtime.callFunctionOn", {
+                objectId,
+                functionDeclaration,
+                returnByValue: true,
+            }));
+            return res.result?.value ?? { state: "missing" };
+        }
+        finally {
+            await session.send("Runtime.releaseObject", { objectId }).catch(() => undefined);
+        }
+    };
+    await (0, trusted_click_1.clickAfterCentredHitTest)(locator, evaluateOnElement, { label });
+}
 /**
  * `fillDeepLocatorCandidate`/`selectDeepLocatorCandidateOption` live in
  * `deep-locator-actuate.ts`, not here — that module's `writeAndVerify` wraps

package/dist/scraper/deep-locator-candidates.js.map

@@ -1 +1 @@
-{"version":3,"file":"deep-locator-candidates.js","sourceRoot":"","sources":["../../src/scraper/deep-locator-candidates.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"deep-locator-candidates.js","sourceRoot":"","sources":["../../src/scraper/deep-locator-candidates.ts"],"names":[],"mappings":"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"}

package/dist/scraper/deep-locator-scan.d.ts

@@ -100,6 +100,18 @@ export declare const DEEP_LOCATOR_CLICK_INDEX_ROUND_TRIP_MS = 1000;
  * `buildRankSubmitCandidatesExpr`'s contract in `submit-control.ts`).
  */
 export declare function buildScanFrameCandidatesExpr(innerSelector: string, root?: string): string;
+/**
+ * Builds an evaluate expression returning the indices (into the shadow-piercing
+ * match order of `innerSelector`) of every match that fails
+ * {@link ACTIONABLE_VISIBILITY_EXPR}. Exists for the legacy per-candidate
+ * enumeration, whose Stagehand `Locator` exposes no per-element evaluate and
+ * whose `isVisible()` ignores `aria-hidden`, so the decoy filter must be read
+ * from the frame instead. Traversal mirrors Stagehand's
+ * `resolveCssSelectorPierce` (document first, then each open shadow root
+ * breadth-first, de-duplicating elements) so an index lines up with
+ * `deepLocator(hop).nth(index)` even when the light-DOM query missed the node.
+ */
+export declare function buildNonActionableIndicesExpr(innerSelector: string, root?: string): string;
 /** One candidate {@link buildScanFrameCandidatesExpr}'s evaluate call returns. */
 export interface FrameCandidateScanResult {
     /** Position in `querySelectorAll(innerSelector)`'s match order — aligns with `deepLocator(hop).nth(index)` and with {@link buildClickFrameCandidateExpr}'s `index` argument, subject to the shadow-piercing divergence documented on {@link buildScanFrameCandidatesExpr}. */