@enricai/barnacle 1.9.11 → 1.10.0

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

@@ -0,0 +1,44 @@
+/**
+ * Shared browser-context click-activation snippet. Three primitives —
+ * `buildClickFrameCandidateExpr` (`deep-locator-scan.ts`),
+ * `buildDeepSubmitClickExpr` (`deep-query.ts`), and `buildClickByDeepIndexExpr`
+ * (`submit-control.ts`) — each need to activate a resolved element from inside
+ * a `page.evaluate`/`Frame.evaluate` string. They used to dispatch bare
+ * `new Event("mousedown"/"mouseup"/"click", { bubbles: true })`, which BUBBLES
+ * (so analytics/telemetry listeners fire) but is NOT a `MouseEvent`/`PointerEvent`
+ * instance — React's synthetic-event system and design-system widgets (Base Web,
+ * etc.) refuse a bare `Event` as a real user activation. The observed symptom on
+ * a markerless multi-select wizard: an option/toggle click reached the element
+ * and its analytics pixel recorded the click, yet the widget's "N selected"
+ * counter stayed flat because the selection never registered. This snippet
+ * dispatches a realistic `PointerEvent`/`MouseEvent` gesture
+ * (`pointerdown → mousedown → pointerup → mouseup`) and then triggers the
+ * activation with EXACTLY ONE click: native `el.click()` when the element has it
+ * (the trusted-path activation a `<button>` toggle listens for), else a single
+ * synthetic `MouseEvent("click")`. It must never do BOTH — a synthetic `click`
+ * dispatch plus a native `click()` fires a toggle handler twice
+ * (select → deselect = net zero), re-creating the very phantom this snippet
+ * exists to cure. Kept as a single interpolated string so all four primitives
+ * stay identical (DRY) rather than drifting copies.
+ */
+/**
+ * Emits a browser-context statement block that activates the element bound to
+ * `elVar`: focus, then a `pointerdown → mousedown → pointerup → mouseup` gesture
+ * using real `MouseEvent`/`PointerEvent` constructors (feature-detecting
+ * `PointerEvent`, since a non-pointer environment still has `MouseEvent`),
+ * followed by EXACTLY ONE click activation.
+ *
+ * `elVar` is interpolated verbatim as an already-in-scope identifier — the
+ * caller resolves the element (e.g. `const el = matches[index]`) before
+ * interpolating this block. The single click is delivered via native
+ * `elVar.click()` when the element exposes one (every `HTMLElement` does; it is
+ * the trusted-path activation that drives React/Base Web toggle state), and via
+ * one synthetic `MouseEvent("click")` ONLY as the `else` for a non-`HTMLElement`
+ * that has no native `click()`. The two paths are mutually exclusive on purpose:
+ * dispatching a synthetic `click` AND calling native `click()` would fire the
+ * element's handler twice, and on a toggle that is select → deselect = net zero.
+ * The gesture events (down/up) are not click activations, so they never
+ * double-fire the handler.
+ */
+export declare function clickActivationExpr(elVar: string): string;
+//# sourceMappingURL=browser-click-expr.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser-click-expr.d.ts","sourceRoot":"","sources":["../../src/scraper/browser-click-expr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAsBzD"}

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

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * Shared browser-context click-activation snippet. Three primitives —
+ * `buildClickFrameCandidateExpr` (`deep-locator-scan.ts`),
+ * `buildDeepSubmitClickExpr` (`deep-query.ts`), and `buildClickByDeepIndexExpr`
+ * (`submit-control.ts`) — each need to activate a resolved element from inside
+ * a `page.evaluate`/`Frame.evaluate` string. They used to dispatch bare
+ * `new Event("mousedown"/"mouseup"/"click", { bubbles: true })`, which BUBBLES
+ * (so analytics/telemetry listeners fire) but is NOT a `MouseEvent`/`PointerEvent`
+ * instance — React's synthetic-event system and design-system widgets (Base Web,
+ * etc.) refuse a bare `Event` as a real user activation. The observed symptom on
+ * a markerless multi-select wizard: an option/toggle click reached the element
+ * and its analytics pixel recorded the click, yet the widget's "N selected"
+ * counter stayed flat because the selection never registered. This snippet
+ * dispatches a realistic `PointerEvent`/`MouseEvent` gesture
+ * (`pointerdown → mousedown → pointerup → mouseup`) and then triggers the
+ * activation with EXACTLY ONE click: native `el.click()` when the element has it
+ * (the trusted-path activation a `<button>` toggle listens for), else a single
+ * synthetic `MouseEvent("click")`. It must never do BOTH — a synthetic `click`
+ * dispatch plus a native `click()` fires a toggle handler twice
+ * (select → deselect = net zero), re-creating the very phantom this snippet
+ * exists to cure. Kept as a single interpolated string so all four primitives
+ * stay identical (DRY) rather than drifting copies.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clickActivationExpr = clickActivationExpr;
+/**
+ * Emits a browser-context statement block that activates the element bound to
+ * `elVar`: focus, then a `pointerdown → mousedown → pointerup → mouseup` gesture
+ * using real `MouseEvent`/`PointerEvent` constructors (feature-detecting
+ * `PointerEvent`, since a non-pointer environment still has `MouseEvent`),
+ * followed by EXACTLY ONE click activation.
+ *
+ * `elVar` is interpolated verbatim as an already-in-scope identifier — the
+ * caller resolves the element (e.g. `const el = matches[index]`) before
+ * interpolating this block. The single click is delivered via native
+ * `elVar.click()` when the element exposes one (every `HTMLElement` does; it is
+ * the trusted-path activation that drives React/Base Web toggle state), and via
+ * one synthetic `MouseEvent("click")` ONLY as the `else` for a non-`HTMLElement`
+ * that has no native `click()`. The two paths are mutually exclusive on purpose:
+ * dispatching a synthetic `click` AND calling native `click()` would fire the
+ * element's handler twice, and on a toggle that is select → deselect = net zero.
+ * The gesture events (down/up) are not click activations, so they never
+ * double-fire the handler.
+ */
+function clickActivationExpr(elVar) {
+    return `{
+    if (typeof ${elVar}.focus === "function") { try { ${elVar}.focus(); } catch (e) {} }
+    const __ceOpts = { bubbles: true, cancelable: true, composed: true, view: (typeof window !== "undefined" ? window : undefined), button: 0 };
+    const __mouse = (type, buttons) => {
+      try { return new MouseEvent(type, Object.assign({}, __ceOpts, { buttons: buttons })); }
+      catch (e) { return new Event(type, { bubbles: true, cancelable: true }); }
+    };
+    const __pointer = (type, buttons) => {
+      if (typeof PointerEvent === "function") {
+        try { return new PointerEvent(type, Object.assign({}, __ceOpts, { buttons: buttons, pointerType: "mouse", isPrimary: true })); }
+        catch (e) {}
+      }
+      return __mouse(type, buttons);
+    };
+    ${elVar}.dispatchEvent(__pointer("pointerdown", 1));
+    ${elVar}.dispatchEvent(__mouse("mousedown", 1));
+    ${elVar}.dispatchEvent(__pointer("pointerup", 0));
+    ${elVar}.dispatchEvent(__mouse("mouseup", 0));
+    if (typeof ${elVar}.click === "function") { try { ${elVar}.click(); } catch (e) {} }
+    else { ${elVar}.dispatchEvent(__mouse("click", 0)); }
+  }`;
+}
+//# sourceMappingURL=browser-click-expr.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser-click-expr.js","sourceRoot":"","sources":["../../src/scraper/browser-click-expr.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,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"}

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

@@ -34,6 +34,21 @@ export interface DeepLocatorTimeoutOptions {
      * probe.
      */
     frameTarget?: FrameTarget;
+    /**
+     * Forces {@link clickDeepLocatorCandidate} to skip the batched in-page
+     * synthetic click ({@link buildClickFrameCandidateExpr}, `isTrusted=false`)
+     * and activate ONLY via the trusted CDP `deepLocator().nth(index).click()`
+     * (`Input.dispatchMouseEvent`, `isTrusted=true`). The synthetic fast path is
+     * the default because it collapses the `index + 1` per-index resolve
+     * round-trips; a caller sets this ONLY on the phantom-driven retry, where the
+     * prior synthetic click already fired without effect and the per-index cost
+     * is worth paying to deliver a click a React/design-system handler accepts.
+     * Omitted/false everywhere else so throughput is unchanged for the common
+     * case. Does NOT suppress the not-actionable probe: an unrendered node still
+     * throws {@link isNodeNotActionableError} rather than paying a scaled-timeout
+     * CDP click.
+     */
+    preferTrustedClick?: boolean;
 }
 /**
  * One candidate element `page.deepLocator()` resolved inside a scoped frame.
@@ -59,6 +74,15 @@ export interface DeepLocatorCandidate {
      * enumeration fallback.
      */
     accessibleText: string;
+    /**
+     * `true` when the batched scan flagged this candidate as a navigation/advance
+     * control (BACK/Next/Cancel — see {@link IS_NAV_CANDIDATE_EXPR}). Feeds
+     * {@link scoreCandidate}'s nav-demotion tier so a "select '<option>'" step
+     * never resolves to the wizard's back/next button. Always `false` on the
+     * legacy per-candidate path (which can't read `data-testid`); there
+     * {@link scoreCandidate} re-derives the text-based portion of the nav check.
+     */
+    isNav: boolean;
 }
 /** One quoted phrase from an instruction, tagged with whether a negation marker (`NEGATION_MARKERS`) governs it. See {@link extractTaggedPhrases}. */
 export interface TaggedPhrase {
@@ -82,18 +106,41 @@ export interface TaggedPhrase {
 export declare function extractTaggedPhrases(instruction: string): TaggedPhrase[];
 /**
  * Scores one candidate's relevance to `instruction`'s tagged phrases, higher
- * is more relevant. Parallels `submit-control.ts`'s tiered-ranking shape:
- * negative signal is checked first and wins outright (a candidate matching
- * ANY negated phrase is actively demoted below "no match" — a decoy sibling
- * button is worse than an unrelated structural node), then positive
- * exact/substring match tiers, falling through to 0 for empty or
- * unrelated text so a structural container with no accessible text can
- * never outrank a candidate whose text actually matches the instruction.
- * Exported so `flow-runner.ts` can detect a tie for the top rank among
- * `resolveDeepLocatorCandidates`'s already-sorted output (see
- * {@link extractTaggedPhrases}'s docblock).
+ * is more relevant. Parallels `submit-control.ts`'s tiered-ranking shape but
+ * adds two tiers the markerless-widget bug report needs: a nav/back demotion
+ * (so a "select '<option>'" step never lands on the wizard's BACK/Next button,
+ * whose own text may exact-match nothing OR be empty) and an ends-with tier (so
+ * an option whose accessible name is polluted by a leading icon-glyph name —
+ * an icon-font/`<svg><title>` prefix rendering as `"<IconName><Label>"` — still
+ * beats a bare exact-text decoy by matching on the trailing label).
+ *
+ * Strict-priority tiers, first match wins:
+ * - negated-phrase match → `-2` (worst: a decoy sibling is worse than an
+ *   unrelated structural node — the invariant the original tiering established),
+ * - exact positive → `4`,
+ * - ends-with a positive → `3` (the icon-glyph suffix case),
+ * - contains a positive (either direction) → `2`,
+ * - nav/back control with NO positive textual match → `-1`,
+ * - else → `0`.
+ *
+ * Crucially, the nav/back demotion sits BELOW the positive tiers, not above
+ * them: it only sinks a candidate that would otherwise score `0` (no phrase
+ * match at all) — the empty BACK button, or a bare "Next"/"Cancel" chrome
+ * button the instruction doesn't name. A candidate that positively matches the
+ * instruction phrase — exact, ends-with, or contains — is the control the step
+ * named and keeps its positive score even if its label happens to contain a nav
+ * word (`select 'Next'` → the "Next" option scores 4; "primary Next" whose step
+ * quotes 'Next' scores 2 via containment). This makes the demotion a tie-breaker
+ * against chrome, never an override of a real target.
+ *
+ * `isNav` comes from the batched scan (`data-testid` + empty-text signals it
+ * alone can see); the text-word portion is re-derived here via
+ * {@link matchesNavText} so the legacy per-candidate path (always `isNav=false`)
+ * still demotes a bare "Back"/"Next". Exported so `flow-runner.ts` can detect a
+ * tie for the top rank among `resolveDeepLocatorCandidates`'s already-sorted
+ * output (see {@link extractTaggedPhrases}'s docblock).
  */
-export declare function scoreCandidate(accessibleText: string, phrases: TaggedPhrase[]): number;
+export declare function scoreCandidate(accessibleText: string, phrases: TaggedPhrase[], isNav?: boolean): number;
 /**
  * Enumerates every element `page.deepLocator()` matches inside the frame
  * scoped by `frameSelector`, ranked by relevance to `instruction` (highest
@@ -138,19 +185,34 @@ export declare function resolveDeepLocatorCandidates(page: Page, frameSelector:
  * must infer the outcome from whether this call throws plus their own
  * downstream DOM verification, not from a returned boolean.
  *
- * Prefers the one-round-trip {@link clickCandidateBatched} fast path when a
- * frame seam is available (`timeoutOptions.frameTarget`, or one resolved
- * internally the same way {@link scanFrameCandidatesBatched} does), falling
- * back to the legacy `DeepLocatorDelegate.click()` — which never reports
- * success via a return value, only via not rejecting — when no seam is
- * available, the batched call fails/degrades, or it reports the index
- * stale (`reason: "out-of-range"`). A batched `reason: "not-actionable"`
- * result throws an error {@link isNodeNotActionableError} classifies, the
- * same contract a real click against an unrendered node rejects with via the
- * CDP `-32000 Node does not have a layout object` error, so a caller
- * cascading through candidates treats both paths identically.
+ * By default, prefers the one-round-trip {@link clickCandidateBatched} fast
+ * path when a frame seam is available (`timeoutOptions.frameTarget`, or one
+ * resolved internally the same way {@link scanFrameCandidatesBatched} does):
+ * that batched click is a SYNTHETIC (`isTrusted=false`) activation, but it
+ * collapses the `index + 1` serial `nth(index)` resolve round-trips and works
+ * for the overwhelmingly common control. It falls back to the trusted
+ * `deepLocator().nth(index).click()` (understudy `Input.dispatchMouseEvent`,
+ * `isTrusted=true`) — which never reports success via a return value, only via
+ * not rejecting — when no seam is available, the batched call fails/degrades, or
+ * it reports the index stale (`reason: "out-of-range"`). A batched
+ * `reason: "not-actionable"` result throws an error {@link isNodeNotActionableError}
+ * classifies, the same contract a real click against an unrendered node rejects
+ * with via the CDP `-32000 Node does not have a layout object` error, so a
+ * caller cascading through candidates treats both paths identically.
+ *
+ * When `timeoutOptions.preferTrustedClick` is set, the synthetic batched click
+ * is SKIPPED entirely and activation goes straight to the trusted CDP
+ * `nth(index).click()` — the escalation a phantom-driven retry uses after a
+ * synthetic click fired without effect (a React/design-system handler that
+ * ignores untrusted activation). A cheap not-actionable probe still runs first
+ * so an unrendered candidate is skipped without paying the scaled-timeout CDP
+ * click.
+ *
+ * Resolves on success and rejects on failure — the caller must infer the
+ * outcome from whether this call throws plus their own downstream DOM
+ * verification, not from a returned boolean.
  *
- * The legacy fallback's watchdog scales with `index` (see
+ * The trusted-fallback watchdog scales with `index` (see
  * {@link DEEP_LOCATOR_CLICK_INDEX_ROUND_TRIP_MS}) so a legitimately-reachable
  * candidate isn't killed by a budget sized for a single round-trip. A
  * `click()` that still exceeds that scaled budget (a wedged CDP round-trip

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;CAC3B;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;CACxB;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;AAOD;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAStF;AA6JD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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;AAqDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;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,CAwBf;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;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"}

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

@@ -89,31 +89,82 @@ function extractTaggedPhrases(instruction) {
 function normalize(text) {
     return text.replace(/\s+/g, " ").trim().toLowerCase();
 }
+/**
+ * Nav/advance words that mark a control as chrome (BACK/Next/Cancel), matched
+ * with the same word-boundary predicate SHAPE `submit-control.ts`'s
+ * `NEGATIVE_TEXT_EXPR` uses, over a nav-word list that adds `"next"` (an advance
+ * button a "select '<option>'" step must be de-prioritized against). Kept here
+ * (not imported from that browser-context string) so {@link scoreCandidate} can
+ * re-derive the text portion of the nav check on the legacy per-candidate path,
+ * which can't read `data-testid` and so always arrives with `isNav === false`.
+ */
+const NAV_TEXT_WORDS = [
+    "back",
+    "cancel",
+    "previous",
+    "next",
+    "close",
+    "save draft",
+    "save for later",
+];
+/** True when `normalizedText` is one of {@link NAV_TEXT_WORDS} (whole-word / edge match), the text-only half of the scan's `IS_NAV_CANDIDATE_EXPR`. */
+function matchesNavText(normalizedText) {
+    return NAV_TEXT_WORDS.some((n) => normalizedText === n || normalizedText.startsWith(`${n} `) || normalizedText.endsWith(` ${n}`));
+}
 /**
  * Scores one candidate's relevance to `instruction`'s tagged phrases, higher
- * is more relevant. Parallels `submit-control.ts`'s tiered-ranking shape:
- * negative signal is checked first and wins outright (a candidate matching
- * ANY negated phrase is actively demoted below "no match" — a decoy sibling
- * button is worse than an unrelated structural node), then positive
- * exact/substring match tiers, falling through to 0 for empty or
- * unrelated text so a structural container with no accessible text can
- * never outrank a candidate whose text actually matches the instruction.
- * Exported so `flow-runner.ts` can detect a tie for the top rank among
- * `resolveDeepLocatorCandidates`'s already-sorted output (see
- * {@link extractTaggedPhrases}'s docblock).
+ * is more relevant. Parallels `submit-control.ts`'s tiered-ranking shape but
+ * adds two tiers the markerless-widget bug report needs: a nav/back demotion
+ * (so a "select '<option>'" step never lands on the wizard's BACK/Next button,
+ * whose own text may exact-match nothing OR be empty) and an ends-with tier (so
+ * an option whose accessible name is polluted by a leading icon-glyph name —
+ * an icon-font/`<svg><title>` prefix rendering as `"<IconName><Label>"` — still
+ * beats a bare exact-text decoy by matching on the trailing label).
+ *
+ * Strict-priority tiers, first match wins:
+ * - negated-phrase match → `-2` (worst: a decoy sibling is worse than an
+ *   unrelated structural node — the invariant the original tiering established),
+ * - exact positive → `4`,
+ * - ends-with a positive → `3` (the icon-glyph suffix case),
+ * - contains a positive (either direction) → `2`,
+ * - nav/back control with NO positive textual match → `-1`,
+ * - else → `0`.
+ *
+ * Crucially, the nav/back demotion sits BELOW the positive tiers, not above
+ * them: it only sinks a candidate that would otherwise score `0` (no phrase
+ * match at all) — the empty BACK button, or a bare "Next"/"Cancel" chrome
+ * button the instruction doesn't name. A candidate that positively matches the
+ * instruction phrase — exact, ends-with, or contains — is the control the step
+ * named and keeps its positive score even if its label happens to contain a nav
+ * word (`select 'Next'` → the "Next" option scores 4; "primary Next" whose step
+ * quotes 'Next' scores 2 via containment). This makes the demotion a tie-breaker
+ * against chrome, never an override of a real target.
+ *
+ * `isNav` comes from the batched scan (`data-testid` + empty-text signals it
+ * alone can see); the text-word portion is re-derived here via
+ * {@link matchesNavText} so the legacy per-candidate path (always `isNav=false`)
+ * still demotes a bare "Back"/"Next". Exported so `flow-runner.ts` can detect a
+ * tie for the top rank among `resolveDeepLocatorCandidates`'s already-sorted
+ * output (see {@link extractTaggedPhrases}'s docblock).
  */
-function scoreCandidate(accessibleText, phrases) {
+function scoreCandidate(accessibleText, phrases, isNav = false) {
     const normalizedText = normalize(accessibleText);
-    if (!normalizedText)
-        return 0;
     const positives = phrases.filter((p) => !p.negated).map((p) => normalize(p.text));
     const negatives = phrases.filter((p) => p.negated).map((p) => normalize(p.text));
-    if (negatives.some((n) => n === normalizedText || normalizedText.includes(n)))
+    if (normalizedText.length > 0 &&
+        negatives.some((n) => n === normalizedText || normalizedText.includes(n))) {
+        return -2;
+    }
+    if (normalizedText.length > 0) {
+        if (positives.some((p) => p === normalizedText))
+            return 4;
+        if (positives.some((p) => normalizedText.endsWith(p)))
+            return 3;
+        if (positives.some((p) => normalizedText.includes(p) || p.includes(normalizedText)))
+            return 2;
+    }
+    if (isNav || matchesNavText(normalizedText))
         return -1;
-    if (positives.some((p) => p === normalizedText))
-        return 3;
-    if (positives.some((p) => normalizedText.includes(p) || p.includes(normalizedText)))
-        return 2;
     return 0;
 }
 /**
@@ -200,6 +251,7 @@ async function scanFrameCandidatesBatched(page, frameSelector, innerSelector, ho
         index: entry.index,
         selector: candidateSelector(hopSelector, entry.index),
         accessibleText: entry.text.trim(),
+        isNav: entry.isNav === true,
     }));
 }
 /**
@@ -238,6 +290,7 @@ async function enumerateCandidatesViaLegacyLoop(delegate, hopSelector, callTimeo
             index,
             selector: candidateSelector(hopSelector, index),
             accessibleText: accessibleText.trim(),
+            isNav: false,
         });
     }
     return candidates;
@@ -297,7 +350,7 @@ async function resolveDeepLocatorCandidates(page, frameSelector, innerSelector,
         .map((candidate, originalOrder) => ({
         candidate,
         originalOrder,
-        score: scoreCandidate(candidate.accessibleText, phrases),
+        score: scoreCandidate(candidate.accessibleText, phrases, candidate.isNav),
     }))
         .sort((a, b) => b.score - a.score || a.originalOrder - b.originalOrder)
         .map(({ candidate }) => candidate);
@@ -317,10 +370,13 @@ function isFrameCandidateClickResult(entry) {
  * Batched-click fast path: one `frameTarget.evaluate(buildClickFrameCandidateExpr(innerSelector, index))`
  * round-trip replaces the legacy `nth(index).click()`, which (per
  * {@link DEEP_LOCATOR_CLICK_INDEX_ROUND_TRIP_MS}'s docs) pays `index + 1`
- * serial CDP round-trips through `resolveAtIndex`. Returns `null` (never
- * throws) when no frame seam is available, the evaluate call rejects, or the
- * resolved payload doesn't conform to {@link FrameCandidateClickResult} —
- * every one of those degrades the caller to the legacy `nth(index).click()`
+ * serial CDP round-trips through `resolveAtIndex`. The batched click is a
+ * SYNTHETIC (`isTrusted=false`) activation; {@link clickDeepLocatorCandidate}
+ * escalates to the trusted CDP click only when this reports the index stale or
+ * the caller set `preferTrustedClick` (a phantom-driven retry). Returns `null`
+ * (never throws) when no frame seam is available, the evaluate call rejects, or
+ * the resolved payload doesn't conform to {@link FrameCandidateClickResult} —
+ * every one of those degrades the caller to the trusted `nth(index).click()`
  * path instead of losing the click, paralleling {@link scanFrameCandidatesBatched}'s
  * degrade contract on the enumeration side.
  */
@@ -351,19 +407,34 @@ async function clickCandidateBatched(page, frameSelector, innerSelector, index,
  * must infer the outcome from whether this call throws plus their own
  * downstream DOM verification, not from a returned boolean.
  *
- * Prefers the one-round-trip {@link clickCandidateBatched} fast path when a
- * frame seam is available (`timeoutOptions.frameTarget`, or one resolved
- * internally the same way {@link scanFrameCandidatesBatched} does), falling
- * back to the legacy `DeepLocatorDelegate.click()` — which never reports
- * success via a return value, only via not rejecting — when no seam is
- * available, the batched call fails/degrades, or it reports the index
- * stale (`reason: "out-of-range"`). A batched `reason: "not-actionable"`
- * result throws an error {@link isNodeNotActionableError} classifies, the
- * same contract a real click against an unrendered node rejects with via the
- * CDP `-32000 Node does not have a layout object` error, so a caller
- * cascading through candidates treats both paths identically.
+ * By default, prefers the one-round-trip {@link clickCandidateBatched} fast
+ * path when a frame seam is available (`timeoutOptions.frameTarget`, or one
+ * resolved internally the same way {@link scanFrameCandidatesBatched} does):
+ * that batched click is a SYNTHETIC (`isTrusted=false`) activation, but it
+ * collapses the `index + 1` serial `nth(index)` resolve round-trips and works
+ * for the overwhelmingly common control. It falls back to the trusted
+ * `deepLocator().nth(index).click()` (understudy `Input.dispatchMouseEvent`,
+ * `isTrusted=true`) — which never reports success via a return value, only via
+ * not rejecting — when no seam is available, the batched call fails/degrades, or
+ * it reports the index stale (`reason: "out-of-range"`). A batched
+ * `reason: "not-actionable"` result throws an error {@link isNodeNotActionableError}
+ * classifies, the same contract a real click against an unrendered node rejects
+ * with via the CDP `-32000 Node does not have a layout object` error, so a
+ * caller cascading through candidates treats both paths identically.
  *
- * The legacy fallback's watchdog scales with `index` (see
+ * When `timeoutOptions.preferTrustedClick` is set, the synthetic batched click
+ * is SKIPPED entirely and activation goes straight to the trusted CDP
+ * `nth(index).click()` — the escalation a phantom-driven retry uses after a
+ * synthetic click fired without effect (a React/design-system handler that
+ * ignores untrusted activation). A cheap not-actionable probe still runs first
+ * so an unrendered candidate is skipped without paying the scaled-timeout CDP
+ * click.
+ *
+ * Resolves on success and rejects on failure — the caller must infer the
+ * outcome from whether this call throws plus their own downstream DOM
+ * verification, not from a returned boolean.
+ *
+ * The trusted-fallback watchdog scales with `index` (see
  * {@link DEEP_LOCATOR_CLICK_INDEX_ROUND_TRIP_MS}) so a legitimately-reachable
  * candidate isn't killed by a budget sized for a single round-trip. A
  * `click()` that still exceeds that scaled budget (a wedged CDP round-trip
@@ -374,11 +445,20 @@ async function clickCandidateBatched(page, frameSelector, innerSelector, index,
 async function clickDeepLocatorCandidate(page, frameSelector, innerSelector, index, timeoutOptions = {}) {
     const callTimeoutMs = timeoutOptions.callTimeoutMs ?? DEFAULT_DEEP_LOCATOR_CALL_TIMEOUT_MS;
     const hopSelector = (0, frame_target_1.buildHopSelector)(frameSelector, innerSelector);
-    const batchedResult = await clickCandidateBatched(page, frameSelector, innerSelector, index, hopSelector, timeoutOptions);
-    if (batchedResult?.clicked)
-        return;
-    if (batchedResult?.reason === "not-actionable") {
-        throw new Error(`deepLocator batched click for ${hopSelector} nth=${index}: node does not have a layout object`);
+    // The synthetic batched click is skipped when a trusted click is demanded —
+    // running BOTH would activate the element twice (on a toggle: select →
+    // deselect = net zero, the exact double-fire hazard browser-click-expr.ts
+    // warns about). Under preferTrustedClick the trusted `nth().click()` below is
+    // the sole activation, and an unrendered node surfaces as the CDP `-32000`
+    // error `isNodeNotActionableError` classifies rather than the batched probe's
+    // not-actionable reason.
+    if (!timeoutOptions.preferTrustedClick) {
+        const batchedResult = await clickCandidateBatched(page, frameSelector, innerSelector, index, hopSelector, timeoutOptions);
+        if (batchedResult?.reason === "not-actionable") {
+            throw new Error(`deepLocator batched click for ${hopSelector} nth=${index}: node does not have a layout object`);
+        }
+        if (batchedResult?.clicked)
+            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(), {

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-click.d.ts

@@ -39,20 +39,45 @@ export declare const DEFAULT_CLICK_CANDIDATE_ATTEMPT_CAP = 5;
 export type ClickCandidateFn = (candidate: DeepLocatorCandidate) => Promise<void>;
 /** Refuses a candidate before it's clicked — e.g. `flow-runner.ts`'s `isWizardExitAction` deny-list, injected so this module stays site-agnostic. */
 export type DenyCandidatePredicate = (candidate: DeepLocatorCandidate) => boolean;
+/**
+ * Reads the running "N selected" counter AFTER a candidate's click resolved,
+ * returning the current count or `null` when no counter is exposed. Injected so
+ * this module stays site-agnostic and `Page`-free — `flow-runner.ts` supplies a
+ * reader that re-snapshots the frame and parses the count via
+ * `selectionCountFromSignature`. See {@link ClickCandidateCascadeOptions.readSelectionCount}.
+ */
+export type ReadSelectionCountFn = () => Promise<number | null>;
 export interface ClickCandidateCascadeOptions {
     /** Skips a candidate without clicking it when this returns `true`. Optional — omit to click every non-not-actionable candidate in rank order. */
     denyCandidate?: DenyCandidatePredicate;
     /** Overrides {@link DEFAULT_CLICK_CANDIDATE_ATTEMPT_CAP}. */
     attemptCap?: number;
+    /**
+     * When supplied (alongside a numeric {@link baselineSelectionCount}), a
+     * candidate whose click RESOLVED but did not raise the selection count above
+     * the baseline is treated like a not-actionable rejection: the walk keeps
+     * going to the next candidate instead of reporting success. This is the
+     * next-best-candidate recovery for a markerless multi-select phantom (the
+     * #163/#164 counter veto knows the click didn't register; this feeds that
+     * back into re-resolution before a replan is spent). A `null` read means "no
+     * counter exposed" and never vetoes, mirroring `isSelectionCounterStalled`'s
+     * null-safety. Omit for non-selection steps — the walk then behaves exactly
+     * as before.
+     */
+    readSelectionCount?: ReadSelectionCountFn;
+    /** The pre-walk selection count; a post-click read at or below this counts as "did not register". Ignored unless {@link readSelectionCount} is set. `null` disables the check (counter-less widget). */
+    baselineSelectionCount?: number | null;
 }
 /** Outcome of a {@link clickFirstActionableCandidate} walk. */
 export interface ClickCandidateCascadeOutcome {
-    /** `true` only when a candidate's click resolved (didn't reject). */
+    /** `true` only when a candidate's click resolved (didn't reject) AND, when a selection-count check is wired, registered the selection. */
     clicked: boolean;
     /** The candidate that was clicked, or `null` when the walk exhausted the list/cap without a successful click. */
     candidate: DeepLocatorCandidate | null;
     /** Selectors of every candidate this walk actually clicked (attempted), in attempt order — denied candidates are excluded since they were never clicked. */
     triedSelectors: string[];
+    /** Selectors of candidates that clicked cleanly but were rejected because the selection counter did not rise (a subset of {@link triedSelectors}). Empty unless {@link ClickCandidateCascadeOptions.readSelectionCount} vetoed at least one — lets the caller emit a "clicked but nothing registered" failure reason distinct from not-actionable. */
+    counterStalledSelectors: string[];
 }
 /**
  * Walks `candidates` in rank order, clicking each via `click` until one
@@ -65,7 +90,20 @@ export interface ClickCandidateCascadeOutcome {
  * with actionability (a detached frame, a wedged click's
  * `WatchdogTimeoutError`). Never throws on exhaustion — an exhausted list
  * (every candidate denied or not-actionable, or the cap reached) resolves to
- * `{ clicked: false, candidate: null, triedSelectors }` instead.
+ * `{ clicked: false, candidate: null, triedSelectors, counterStalledSelectors }`
+ * instead.
+ *
+ * When `readSelectionCount`/`baselineSelectionCount` are supplied, a click that
+ * RESOLVED but left the selection count at or below the baseline is treated
+ * like a not-actionable rejection — the walk advances to the next candidate
+ * instead of reporting a phantom success. A count that rose returns immediately
+ * (so a click that DID register never triggers a second click — the
+ * toggle-double-click guard), and a `null` read is never a veto (counter-less
+ * widget). Because the check runs after `click` already awaited its own settle,
+ * a synchronously-updated counter is visible; the only residual is a genuinely-
+ * registered click whose counter lags, which is the same false-negative the
+ * caller's late counter veto already tolerates today — behaviour is no worse,
+ * and now recovers via the next candidate.
  */
 export declare function clickFirstActionableCandidate(candidates: readonly DeepLocatorCandidate[], click: ClickCandidateFn, options?: ClickCandidateCascadeOptions): Promise<ClickCandidateCascadeOutcome>;
 //# sourceMappingURL=deep-locator-click.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"deep-locator-click.d.ts","sourceRoot":"","sources":["../../src/scraper/deep-locator-click.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAG9E;;;;;;;;;GASG;AACH,eAAO,MAAM,mCAAmC,IAAI,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,SAAS,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAElF,qJAAqJ;AACrJ,MAAM,MAAM,sBAAsB,GAAG,CAAC,SAAS,EAAE,oBAAoB,KAAK,OAAO,CAAC;AAElF,MAAM,WAAW,4BAA4B;IAC3C,iJAAiJ;IACjJ,aAAa,CAAC,EAAE,sBAAsB,CAAC;IACvC,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,+DAA+D;AAC/D,MAAM,WAAW,4BAA4B;IAC3C,qEAAqE;IACrE,OAAO,EAAE,OAAO,CAAC;IACjB,iHAAiH;IACjH,SAAS,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACvC,4JAA4J;IAC5J,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,6BAA6B,CACjD,UAAU,EAAE,SAAS,oBAAoB,EAAE,EAC3C,KAAK,EAAE,gBAAgB,EACvB,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,4BAA4B,CAAC,CAoBvC"}
+{"version":3,"file":"deep-locator-click.d.ts","sourceRoot":"","sources":["../../src/scraper/deep-locator-click.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAG9E;;;;;;;;;GASG;AACH,eAAO,MAAM,mCAAmC,IAAI,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,SAAS,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAElF,qJAAqJ;AACrJ,MAAM,MAAM,sBAAsB,GAAG,CAAC,SAAS,EAAE,oBAAoB,KAAK,OAAO,CAAC;AAElF;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAEhE,MAAM,WAAW,4BAA4B;IAC3C,iJAAiJ;IACjJ,aAAa,CAAC,EAAE,sBAAsB,CAAC;IACvC,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;;;;;OAWG;IACH,kBAAkB,CAAC,EAAE,oBAAoB,CAAC;IAC1C,wMAAwM;IACxM,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC;AAED,+DAA+D;AAC/D,MAAM,WAAW,4BAA4B;IAC3C,0IAA0I;IAC1I,OAAO,EAAE,OAAO,CAAC;IACjB,iHAAiH;IACjH,SAAS,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACvC,4JAA4J;IAC5J,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,sVAAsV;IACtV,uBAAuB,EAAE,MAAM,EAAE,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,6BAA6B,CACjD,UAAU,EAAE,SAAS,oBAAoB,EAAE,EAC3C,KAAK,EAAE,gBAAgB,EACvB,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,4BAA4B,CAAC,CAmCvC"}