@piwitests/reporter 0.20.0 → 0.22.0

package/dist/internal/capture/capture-fixtures.js

@@ -41,758 +41,1267 @@ __export(capture_fixtures_exports, {
 module.exports = __toCommonJS(capture_fixtures_exports);
 var import_node_zlib = require("zlib");
 
-// src/internal/capture/locator-healing.ts
-var path = __toESM(require("path"));
-
-// ../packages/core/src/locator-fingerprint.ts
-var PRESENT_SIMILARITY = 0.8;
-var MATCH_SIMILARITY = 0.2;
-function parseAriaCandidates(ariaSnapshot) {
-  if (!ariaSnapshot) return [];
-  const out = [];
-  for (const line of ariaSnapshot.split("\n")) {
-    const m = line.match(/^\s*-\s+([a-z]+)(?:\s+"((?:[^"\\]|\\.)*)")?/i);
-    if (!m) continue;
-    const role = m[1];
-    const name = m[2] != null ? m[2].replace(/\\(.)/g, "$1") : null;
-    if (!name && (role === "generic" || role === "group" || role === "list" || role === "paragraph")) continue;
-    const levelMatch = line.slice(m[0].length).match(/\[level=(\d+)\]/);
-    const level = levelMatch ? Number(levelMatch[1]) : null;
-    out.push({ role, name, level });
-  }
-  return out;
-}
-function textSimilarity(a, b) {
-  const tok = (s) => new Set(
-    (s ?? "").toLowerCase().split(/[^a-z0-9]+/i).filter(Boolean)
-  );
-  const sa = tok(a);
-  const sb = tok(b);
-  if (sa.size === 0 && sb.size === 0) return 1;
-  if (sa.size === 0 || sb.size === 0) return 0;
-  let common = 0;
-  for (const t of sa) if (sb.has(t)) common++;
-  return 2 * common / (sa.size + sb.size);
-}
-function fingerprintPresent(fp, candidates) {
-  if (!fp.name) return false;
-  return candidates.some(
-    (c) => (!fp.role || c.role === fp.role) && textSimilarity(c.name, fp.name) >= PRESENT_SIMILARITY
-  );
-}
-function matchRenamedElement(fp, candidates) {
-  if (candidates.length === 0) return null;
-  const sameRole = fp.role ? candidates.filter((c) => c.role === fp.role) : candidates;
-  if (sameRole.length === 0) return null;
-  let pool = sameRole;
-  if (fp.level != null) {
-    const sameLevel = sameRole.filter((c) => c.level === fp.level);
-    if (sameLevel.length > 0) pool = sameLevel;
-  }
-  if (pool.length === 1) {
-    return { candidate: pool[0], confidence: 0.7 };
+// ../picker-dom/src/probe.ts
+function probeElementAttrs(el, arg) {
+  const { keep, tagRoles, inputRoles, roleSources, includeStructural, includeLabelText } = arg;
+  const attrMap = {};
+  for (const key of keep) {
+    const v = el.getAttribute(key) ?? el[key];
+    attrMap[key] = typeof v === "string" ? v.slice(0, 200) : v ? String(v).slice(0, 200) : null;
   }
-  let best = null;
-  let bestScore = -1;
-  for (const c of pool) {
-    const s = textSimilarity(c.name, fp.name);
-    if (s > bestScore) {
-      bestScore = s;
-      best = c;
+  const r = el.getBoundingClientRect();
+  const selectorCounts = {};
+  try {
+    const doc = el.ownerDocument;
+    const cssEsc = (s) => doc.defaultView.CSS.escape(s);
+    const count = (sel) => {
+      try {
+        return doc.querySelectorAll(sel).length;
+      } catch {
+        return void 0;
+      }
+    };
+    if (attrMap["data-testid"]) {
+      selectorCounts.testId = count(`[data-testid=${JSON.stringify(attrMap["data-testid"])}]`);
+    }
+    if (attrMap["id"]) selectorCounts.id = count(`#${cssEsc(attrMap["id"])}`);
+    if (attrMap["name"]) selectorCounts.name = count(`[name=${JSON.stringify(attrMap["name"])}]`);
+    if (attrMap["placeholder"]) {
+      selectorCounts.placeholder = count(`[placeholder=${JSON.stringify(attrMap["placeholder"])}]`);
+    }
+    if (attrMap["alt"]) selectorCounts.alt = count(`[alt=${JSON.stringify(attrMap["alt"])}]`);
+    if (attrMap["title"]) selectorCounts.title = count(`[title=${JSON.stringify(attrMap["title"])}]`);
+    const classList = (attrMap["class"] || "").split(/\s+/).filter((c) => c.length > 1).slice(0, 10);
+    if (classList.length > 0) {
+      const classCounts = {};
+      for (const cls of classList) {
+        const n = count(`.${cssEsc(cls)}`);
+        if (n !== void 0) classCounts[cls] = n;
+      }
+      selectorCounts.classes = classCounts;
     }
+  } catch {
   }
-  if (best && bestScore >= MATCH_SIMILARITY) return { candidate: best, confidence: bestScore };
-  const pos = fp.rolePosition;
-  if (pos && fp.role && pos.role === fp.role && sameRole.length >= 2 && sameRole.length === pos.count) {
-    const byIndex = sameRole[pos.index];
-    if (byIndex) return { candidate: byIndex, confidence: 0.5 };
+  let rolePosition = null;
+  const ancestors = [];
+  if (includeStructural && tagRoles && inputRoles && roleSources) {
+    try {
+      const doc = el.ownerDocument;
+      const cssEsc = (s) => doc.defaultView.CSS.escape(s);
+      const count = (sel) => {
+        try {
+          return doc.querySelectorAll(sel).length;
+        } catch {
+          return void 0;
+        }
+      };
+      const roleMemo = /* @__PURE__ */ new Map();
+      const textMemo = /* @__PURE__ */ new Map();
+      const roleOf = (n) => {
+        const cached = roleMemo.get(n);
+        if (cached !== void 0) return cached;
+        let role;
+        const explicit = n.getAttribute("role");
+        if (explicit) {
+          role = explicit;
+        } else {
+          const tag = (n.tagName || "").toLowerCase();
+          if (tag === "input") role = inputRoles[(n.getAttribute("type") || "text").toLowerCase()] ?? "textbox";
+          else if (tag === "select") role = n.getAttribute("multiple") != null ? "listbox" : "combobox";
+          else if (tag === "a") role = n.getAttribute("href") != null ? "link" : null;
+          else role = tagRoles[tag] ?? null;
+        }
+        roleMemo.set(n, role);
+        return role;
+      };
+      const levelOf = (n) => {
+        const m = /^h([1-6])$/.exec((n.tagName || "").toLowerCase());
+        if (m) return Number(m[1]);
+        const al = n.getAttribute("aria-level");
+        return al && /^\d+$/.test(al) ? Number(al) : null;
+      };
+      const targetRole = roleOf(el);
+      const targetLevel = targetRole === "heading" ? levelOf(el) : null;
+      const nameOf = (n) => {
+        const al = n.getAttribute("aria-label");
+        if (al) return al;
+        const txt = (n.textContent || "").replace(/\s+/g, " ").trim();
+        if (txt) return txt;
+        return n.getAttribute("title") || n.getAttribute("placeholder") || null;
+      };
+      const targetName = nameOf(el);
+      const targetText = (el.textContent || "").replace(/\s+/g, " ").trim();
+      const textNeedle = targetText ? targetText.toLowerCase() : null;
+      const normText = (n) => {
+        const cached = textMemo.get(n);
+        if (cached !== void 0) return cached;
+        const text = (n.textContent || "").replace(/\s+/g, " ").trim().toLowerCase();
+        textMemo.set(n, text);
+        return text;
+      };
+      const TEXT_COUNT_CAP = 2;
+      const countTextOwners = (root, cap) => {
+        if (!textNeedle) return -1;
+        const els = root.querySelectorAll("*");
+        if (els.length > cap) return -1;
+        let total = 0;
+        for (let i = 0; i < els.length; i++) {
+          const n = els[i];
+          if (normText(n).indexOf(textNeedle) === -1) continue;
+          let deeper = false;
+          const kids = n.children;
+          for (let j = 0; j < kids.length; j++) {
+            if (normText(kids[j]).indexOf(textNeedle) !== -1) {
+              deeper = true;
+              break;
+            }
+          }
+          if (!deeper) total++;
+          if (total >= TEXT_COUNT_CAP) return total;
+        }
+        return total;
+      };
+      const nodes = doc.querySelectorAll(roleSources);
+      const nodesUsable = nodes.length <= 4e3;
+      const rolesUsable = !!targetRole && nodesUsable;
+      if (rolesUsable) {
+        let roleCountAll = 0;
+        let index = -1;
+        let levelCount = 0;
+        let roleNameCount = 0;
+        for (let i = 0; i < nodes.length; i++) {
+          const n = nodes[i];
+          if (roleOf(n) !== targetRole) continue;
+          if (n === el) index = roleCountAll;
+          roleCountAll++;
+          if (targetLevel != null && levelOf(n) === targetLevel) levelCount++;
+          if (targetName != null && nameOf(n) === targetName) roleNameCount++;
+        }
+        if (targetName != null) selectorCounts.roleName = roleNameCount;
+        if (index !== -1) {
+          rolePosition = {
+            role: targetRole,
+            count: roleCountAll,
+            index,
+            ...targetLevel != null ? { levelCount } : {}
+          };
+        }
+      }
+      if (textNeedle) {
+        const textCount = countTextOwners(doc.body || doc.documentElement, 4e3);
+        if (textCount >= 0) selectorCounts.text = textCount;
+      }
+      if (rolesUsable || textNeedle) {
+        const CONTAINER_TAGS = ["form", "nav", "main", "article", "section", "dialog", "table", "li", "tr"];
+        const NOISY_DATA_ATTR = /^data-(v-[0-9a-f]+|reactid|react-checksum|svelte-\w+|ng-\w+|ember\w*)$/i;
+        const POSITIONAL_DATA_ATTR = /^data-(index|idx|i|key|row|rownum|col|column|position|pos|order|sort|offset|page)$/i;
+        const TEST_DATA_ATTRS2 = ["data-test", "data-test-id", "data-qa", "data-qa-id", "data-cy", "data-e2e"];
+        const usableDataAttr = (name, value) => {
+          if (!name || name.slice(0, 5) !== "data-" || name === "data-testid") return false;
+          if (NOISY_DATA_ATTR.test(name) || POSITIONAL_DATA_ATTR.test(name)) return false;
+          return !!value && value.length <= 120;
+        };
+        const stableDataAttr = (n) => {
+          const attrs = n.attributes;
+          if (!attrs) return null;
+          let fallback = null;
+          for (let i = 0; i < attrs.length; i++) {
+            const name = attrs[i].name;
+            const value = attrs[i].value;
+            if (!usableDataAttr(name, value)) continue;
+            if (TEST_DATA_ATTRS2.indexOf(name.toLowerCase()) !== -1) return { name, value };
+            if (!fallback) fallback = { name, value };
+          }
+          return fallback;
+        };
+        const docRoleCount = (role) => {
+          let c = 0;
+          for (let i = 0; i < nodes.length; i++) if (roleOf(nodes[i]) === role) c++;
+          return c;
+        };
+        const rawText = (n) => (n.textContent || "").replace(/\s+/g, " ").trim();
+        const namesRatherThanReports = (t) => {
+          const letters = t.replace(/[^A-Za-z]/g, "").length;
+          if (letters < 2) return false;
+          const digits = t.replace(/[^0-9]/g, "").length;
+          return digits <= letters;
+        };
+        const usableDiscriminator = (t) => !!t && t.length <= 60 && t !== targetText && namesRatherThanReports(t);
+        const discriminatingText = (anc) => {
+          const heading = anc.querySelector('h1,h2,h3,h4,h5,h6,[role="heading"]');
+          if (heading) {
+            const t = rawText(heading);
+            if (usableDiscriminator(t)) return t;
+          }
+          const els = anc.querySelectorAll("*");
+          if (els.length > 200) return null;
+          for (let i = 0; i < els.length; i++) {
+            const n = els[i];
+            if (n === el || n.children.length > 0) continue;
+            const t = rawText(n);
+            if (!usableDiscriminator(t)) continue;
+            return t;
+          }
+          return null;
+        };
+        const filterMatchCount = (role, text) => {
+          const needle = text.toLowerCase();
+          let c = 0;
+          for (let i = 0; i < nodes.length; i++) {
+            if (roleOf(nodes[i]) !== role) continue;
+            if (normText(nodes[i]).indexOf(needle) !== -1) c++;
+          }
+          return c;
+        };
+        let node = el.parentElement;
+        let depth = 0;
+        while (node && depth < 12 && ancestors.length < 4) {
+          depth++;
+          const tag = (node.tagName || "").toLowerCase();
+          if (tag === "body" || tag === "html") break;
+          const testId = node.getAttribute("data-testid");
+          const id = node.getAttribute("id");
+          const explicitRole = node.getAttribute("role");
+          const ariaLabel = node.getAttribute("aria-label");
+          const anchorRole = explicitRole || (CONTAINER_TAGS.includes(tag) ? tagRoles[tag] : null) || null;
+          const dataAttr = stableDataAttr(node);
+          if (testId || id || anchorRole || ariaLabel || dataAttr) {
+            let scopedRoleCount = -1;
+            if (rolesUsable) {
+              const scoped = node.querySelectorAll(roleSources);
+              if (scoped.length <= 2e3) {
+                scopedRoleCount = 0;
+                for (let i = 0; i < scoped.length; i++) {
+                  const n = scoped[i];
+                  if (roleOf(n) !== targetRole) continue;
+                  if (targetLevel != null && levelOf(n) !== targetLevel) continue;
+                  scopedRoleCount++;
+                }
+              }
+            }
+            const scopedTextCount = countTextOwners(node, 2e3);
+            let filterText = null;
+            try {
+              if (anchorRole && nodesUsable) filterText = discriminatingText(node);
+            } catch {
+              filterText = null;
+            }
+            ancestors.push({
+              tag,
+              depth,
+              testId: testId || null,
+              id: id || null,
+              role: explicitRole || null,
+              ariaLabel: ariaLabel || null,
+              ...scopedRoleCount >= 0 ? { scopedRoleCount } : {},
+              ...scopedTextCount >= 0 ? { scopedTextCount } : {},
+              ...testId ? { testIdCount: count(`[data-testid=${JSON.stringify(testId)}]`) } : {},
+              ...id ? { idCount: count(`#${cssEsc(id)}`) } : {},
+              ...anchorRole && nodesUsable ? { roleCount: docRoleCount(anchorRole) } : {},
+              ...filterText ? { filterText, filterRoleCount: filterMatchCount(anchorRole, filterText) } : {},
+              ...dataAttr ? { dataAttr, dataAttrCount: count(`[${dataAttr.name}=${JSON.stringify(dataAttr.value)}]`) } : {}
+            });
+          }
+          node = node.parentElement;
+        }
+      }
+    } catch {
+    }
   }
-  return null;
+  const hasLabel = !!(el.labels && el.labels.length > 0);
+  const labelText = includeLabelText ? hasLabel ? (el.labels[0].textContent || "").replace(/\s+/g, " ").trim().slice(0, 120) || null : null : void 0;
+  return {
+    tagName: el.tagName?.toLowerCase?.() ?? "unknown",
+    attributes: attrMap,
+    // Collapse whitespace so multi-line text can't produce a getByText
+    // suggestion with literal newlines in it.
+    textContent: (el.textContent || "").replace(/\s+/g, " ").trim().slice(0, 80),
+    center: {
+      x: Math.round(r.x + r.width / 2),
+      y: Math.round(r.y + r.height / 2)
+    },
+    hasLabel,
+    ...includeLabelText ? { labelText } : {},
+    selectorCounts,
+    ...includeStructural ? { rolePosition, ancestors } : {}
+  };
 }
 
-// ../packages/core/src/locator-methods.ts
-var LOCATOR_BUILDER_METHODS = [
-  "getByRole",
-  "getByTestId",
-  "getByText",
-  "getByLabel",
-  "getByPlaceholder",
-  "getByAltText",
-  "getByTitle",
-  "locator"
-];
-
-// ../packages/core/src/locator-generation.ts
-var TAG_TO_ROLE = {
-  a: "link",
-  button: "button",
-  nav: "navigation",
-  main: "main",
-  article: "article",
-  section: "region",
-  form: "form",
-  img: "img",
-  figure: "figure",
-  figcaption: "caption",
-  blockquote: "blockquote",
-  table: "table",
-  ul: "list",
-  ol: "list",
-  li: "listitem",
-  dialog: "dialog",
-  output: "status",
-  progress: "progressbar",
-  meter: "meter",
-  textarea: "textbox",
-  h1: "heading",
-  h2: "heading",
-  h3: "heading",
-  h4: "heading",
-  h5: "heading",
-  h6: "heading",
-  details: "group",
-  summary: "button",
-  search: "search"
-};
-var INPUT_TYPE_TO_ROLE = {
-  button: "button",
-  submit: "button",
-  reset: "button",
-  image: "button",
-  checkbox: "checkbox",
-  radio: "radio",
-  range: "slider",
-  search: "searchbox",
-  number: "spinbutton",
-  text: "textbox",
-  email: "textbox",
-  tel: "textbox",
-  url: "textbox",
-  password: "textbox"
-};
-var CAPTURED_ATTRIBUTES = [
-  "id",
-  "class",
-  "name",
-  "data-testid",
-  "placeholder",
-  "alt",
-  "title",
-  "aria-label",
-  "aria-level",
-  "role",
-  "type",
-  "href",
-  "multiple"
-];
-function resolveAriaRole(attrs) {
-  const explicit = attrs.attributes["role"];
-  if (explicit) return explicit;
-  const tag = attrs.tagName;
-  if (!tag) return null;
-  if (tag === "input") {
-    const type = (attrs.attributes["type"] ?? "text").toLowerCase();
-    return INPUT_TYPE_TO_ROLE[type] ?? "textbox";
-  }
-  if (tag === "select") {
-    return attrs.attributes["multiple"] != null ? "listbox" : "combobox";
-  }
-  if (tag === "a") {
-    return attrs.attributes["href"] != null ? "link" : null;
+// ../picker-dom/src/overlay-element.ts
+function installPickerOverlay(arg) {
+  const g = globalThis;
+  const doc = g.document;
+  if (!doc || !doc.body) {
+    if (arg.transport === "postMessage") g.parent.postMessage({ type: "pickerClosed" }, "*");
+    else g.__piwiPickState = "skipped";
+    return;
   }
-  return TAG_TO_ROLE[tag] ?? null;
-}
-function headingLevel(attrs, role) {
-  if (role !== "heading") return null;
-  const tagMatch = attrs.tagName.match(/^h([1-6])$/);
-  if (tagMatch) return Number(tagMatch[1]);
-  const ariaLevel = attrs.attributes["aria-level"];
-  if (ariaLevel && /^\d+$/.test(ariaLevel)) return Number(ariaLevel);
-  return null;
-}
-var attr = (a, key) => a.attributes[key] || null;
-var esc = (s) => s.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
-var escCssAttrValue = (s) => s.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
-var isCssSafeId = (id) => /^[A-Za-z][A-Za-z0-9_-]*$/.test(id);
-function classifyCssStability(className) {
-  if (/[a-f0-9]{8,}/i.test(className)) return 10;
-  if (/^(?:css|sc|emotion|styled)-/i.test(className)) return 15;
-  if (/^(bg|text|border|shadow|opacity|font|w-|h-|m[tblrxy]?-|p[tblrxy]?-|flex|grid|gap|rounded|absolute|relative|fixed|sticky|block|inline|hidden|overflow|z-|top-|right-|bottom-|left-|inset-|justify-|items-|self-|content-|order-|col-|row-)/.test(
-    className
-  ))
-    return 25;
-  if (/__/.test(className) || /--/.test(className)) return 35;
-  if (/^[a-z]+(-[a-z]+)+$/.test(className)) return 40;
-  if (/^[a-z]+[A-Z][a-zA-Z]+$/.test(className)) return 40;
-  if (className.includes("_")) return 15;
-  if (/^[a-z]+-[a-z0-9]{5,}$/.test(className) && /[0-9]/.test(className)) return 15;
-  return 15;
-}
-function isAutoGenerated(value) {
-  if (/^[a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12}$/i.test(value)) return true;
-  if (/^[a-f0-9]{8,}$/i.test(value)) return true;
-  if (/^[a-z]+-\d+$/.test(value)) return true;
-  if (/^(emotion-|styled-|css-|sc-)/.test(value)) return true;
-  if (value.startsWith("ng-")) return true;
-  if (/^(radix-|headlessui-|mui-|mantine-|chakra-)/i.test(value)) return true;
-  if (/^:r[0-9a-z]+:$/i.test(value) || /^«r[0-9a-z]+»$/i.test(value)) return true;
-  return false;
-}
-function generateAlternatives(attrs) {
-  const alts = [];
-  const seen = /* @__PURE__ */ new Set();
-  const add = (loc) => {
-    if (!seen.has(loc.locator)) {
-      seen.add(loc.locator);
-      alts.push(loc);
+  const Z = 2147483600;
+  const highlight = doc.createElement("div");
+  highlight.id = "__piwi_picker_highlight";
+  highlight.style.cssText = `position:fixed;pointer-events:none;z-index:${Z};display:none;box-sizing:border-box;border:2px solid #a855f7;background:rgba(168,85,247,.14);border-radius:4px;box-shadow:0 0 0 1px rgba(255,255,255,.9),0 0 0 3px rgba(59,7,100,.55),inset 0 0 0 1px rgba(255,255,255,.5);`;
+  const banner = doc.createElement("div");
+  banner.id = "__piwi_picker_banner";
+  banner.style.cssText = `position:fixed;top:12px;left:50%;transform:translateX(-50%);z-index:${Z + 2};background:#111827;color:#f9fafb;font:13px/1.5 system-ui,sans-serif;border:1px solid #312e81;padding:10px 16px;border-radius:10px;box-shadow:0 4px 24px rgba(0,0,0,.5);max-width:min(680px,86vw);`;
+  const hlTokens = (expr) => {
+    const escHtml = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+    const re = /('(?:\\.|[^'])*'|"(?:\\.|[^"])*")|([A-Za-z_$][\w$]*)(?=\s*\()|([A-Za-z_$][\w$]*)(?=\s*:)|(true|false|null|\d+)|([{}(),.])/g;
+    let html = "";
+    let last = 0;
+    let m;
+    while ((m = re.exec(expr)) !== null) {
+      if (m.index > last) html += escHtml(expr.slice(last, m.index));
+      const color = m[1] ? "#86efac" : m[2] ? "#d8b4fe" : m[3] ? "#93c5fd" : m[4] ? "#fcd34d" : "#9ca3af";
+      html += `<span style="color:${color}">${escHtml(m[0])}</span>`;
+      last = re.lastIndex;
     }
+    if (last < expr.length) html += escHtml(expr.slice(last));
+    return html;
   };
-  const { accessibleName } = attrs;
-  const tag = attrs.tagName;
-  const role = resolveAriaRole(attrs);
-  const counts = attrs.selectorCounts;
-  const isUnique = (n) => n == null || n <= 1;
-  const text = attrs.textContent ? attrs.textContent.replace(/\s+/g, " ").trim() : null;
-  const testId = attr(attrs, "data-testid");
-  if (testId && isUnique(counts?.testId)) {
-    add({
-      locator: `getByTestId('${esc(testId)}')`,
-      method: "getByTestId",
-      args: { testId },
-      score: 100
-    });
-  }
-  const level = headingLevel(attrs, role);
-  const levelPart = level != null ? `, level: ${level}` : "";
-  const withLevel = (base) => level != null ? { ...base, level } : base;
-  if (role && accessibleName) {
-    add({
-      locator: `getByRole('${role}', { name: '${esc(accessibleName)}'${levelPart} })`,
-      method: "getByRole",
-      args: withLevel({ role, name: accessibleName }),
-      score: 90
-    });
-  }
-  const ariaLabel = attr(attrs, "aria-label");
-  if (role && ariaLabel && ariaLabel !== accessibleName) {
-    add({
-      locator: `getByRole('${role}', { name: '${esc(ariaLabel)}'${levelPart} })`,
-      method: "getByRole",
-      args: withLevel({ role, name: ariaLabel }),
-      score: 85
-    });
-  }
-  if (accessibleName && ["input", "select", "textarea"].includes(tag)) {
-    const label = attr(attrs, "aria-label");
-    const labelBacked = attrs.hasLabel === void 0 ? true : attrs.hasLabel === true || label === accessibleName;
-    if (labelBacked) {
-      add({
-        locator: `getByLabel('${esc(accessibleName)}')`,
-        method: "getByLabel",
-        args: { label: accessibleName },
-        score: 85
-      });
+  const MONO = "ui-monospace,SFMono-Regular,Menlo,Consolas,monospace";
+  const hlLocator = (expr) => `<code style="font-family:${MONO}">${hlTokens(expr)}</code>`;
+  const head = doc.createElement("div");
+  head.innerHTML = arg.transport === "postMessage" ? "Click an element to generate locators" : arg.failing ? `Piwi locator picker \u2014 click the element that should replace ${hlLocator(arg.failing)}` : "Piwi inspector \u2014 click any element to generate locators for it";
+  const locatorLine = doc.createElement("div");
+  locatorLine.id = "__piwi_picker_locator";
+  locatorLine.style.cssText = `display:none;margin-top:7px;padding:5px 9px;border-radius:7px;background:#0b1120;border:1px solid #4c1d95;font:13.5px/1.55 ${MONO};word-break:break-word;overflow-wrap:anywhere;`;
+  const foot = doc.createElement("div");
+  foot.id = "__piwi_picker_foot";
+  foot.style.cssText = "color:#9ca3af;margin-top:6px;font-size:12px;";
+  foot.textContent = "\u2191 parent \xB7 \u2193 child \xB7 Esc skip";
+  banner.appendChild(head);
+  banner.appendChild(locatorLine);
+  banner.appendChild(foot);
+  const label = doc.createElement("div");
+  label.id = "__piwi_picker_label";
+  label.style.cssText = `position:fixed;pointer-events:none;z-index:${Z + 1};display:none;box-sizing:border-box;max-width:min(620px,92vw);background:#0b1120;color:#f9fafb;border:1px solid #7c3aed;border-radius:7px;padding:4px 8px;font:12.5px/1.45 ${MONO};white-space:nowrap;overflow:hidden;text-overflow:ellipsis;box-shadow:0 4px 18px rgba(0,0,0,.5);`;
+  doc.body.appendChild(highlight);
+  doc.body.appendChild(label);
+  doc.body.appendChild(banner);
+  const escJs = (s) => s.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
+  const describe = (el) => {
+    const tag = (el.tagName || "?").toLowerCase();
+    const testId = el.getAttribute && el.getAttribute("data-testid");
+    if (testId) return `getByTestId('${escJs(testId)}')`;
+    if (el.labels && el.labels.length > 0) {
+      const labelText = (el.labels[0].textContent || "").replace(/\s+/g, " ").trim().slice(0, 80);
+      if (labelText) return `getByLabel('${escJs(labelText)}')`;
     }
-  }
-  const placeholder = attr(attrs, "placeholder");
-  if (placeholder) {
-    add({
-      locator: `getByPlaceholder('${esc(placeholder)}')`,
-      method: "getByPlaceholder",
-      args: { placeholder },
-      score: 80
-    });
-  }
-  if (text && text.length < 80) {
-    add({
-      locator: `getByText('${esc(text)}')`,
-      method: "getByText",
-      args: { text },
-      score: 75
-    });
-  }
-  const id = attr(attrs, "id");
-  if (id && !isAutoGenerated(id) && isUnique(counts?.id)) {
-    const selector = isCssSafeId(id) ? `#${id}` : `[id="${escCssAttrValue(id)}"]`;
-    add({
-      locator: `locator('${esc(selector)}')`,
-      method: "locator",
-      args: { selector },
-      score: 65
-    });
-  }
-  const name = attr(attrs, "name");
-  if (name && isUnique(counts?.name)) {
-    const selector = `[name="${escCssAttrValue(name)}"]`;
-    add({
-      locator: `locator('${esc(selector)}')`,
-      method: "locator",
-      args: { selector },
-      score: 60
-    });
-  }
-  const alt = attr(attrs, "alt");
-  if (alt) {
-    add({
-      locator: `getByAltText('${esc(alt)}')`,
-      method: "getByAltText",
-      args: { text: alt },
-      score: 60
-    });
-  }
-  const title = attr(attrs, "title");
-  if (title) {
-    add({
-      locator: `getByTitle('${esc(title)}')`,
-      method: "getByTitle",
-      args: { title },
-      score: 50
-    });
-  }
-  const hasOwnTestId = !!(testId && isUnique(counts?.testId));
-  if (role && !hasOwnTestId) {
-    const rolePart = level != null ? `'${role}', { level: ${level} }` : `'${role}'`;
-    const leafArgs = withLevel({ role });
-    let testIdAnchorDone = false;
-    let idAnchorDone = false;
-    let roleAnchorDone = false;
-    for (const anc of attrs.ancestors ?? []) {
-      if (anc.scopedRoleCount !== 1) continue;
-      if (!testIdAnchorDone && anc.testId && anc.testIdCount === 1) {
-        testIdAnchorDone = true;
-        add({
-          locator: `getByTestId('${esc(anc.testId)}').getByRole(${rolePart})`,
-          method: "getByRole",
-          args: { ...leafArgs, anchorTestId: anc.testId },
-          score: 72
-        });
-      }
-      if (!idAnchorDone && anc.id && !isAutoGenerated(anc.id) && anc.idCount === 1) {
-        idAnchorDone = true;
-        const anchorSelector = isCssSafeId(anc.id) ? `#${anc.id}` : `[id="${escCssAttrValue(anc.id)}"]`;
-        add({
-          locator: `locator('${esc(anchorSelector)}').getByRole(${rolePart})`,
-          method: "getByRole",
-          args: { ...leafArgs, anchorSelector },
-          score: 64
-        });
-      }
-      const ancestorRole = anc.role || TAG_TO_ROLE[anc.tag] || null;
-      if (!roleAnchorDone && ancestorRole && ancestorRole !== role && anc.roleCount === 1) {
-        roleAnchorDone = true;
-        add({
-          locator: `getByRole('${esc(ancestorRole)}').getByRole(${rolePart})`,
-          method: "getByRole",
-          args: { ...leafArgs, anchorRole: ancestorRole },
-          score: 55
-        });
+    const ariaLabel = el.getAttribute && el.getAttribute("aria-label");
+    if (ariaLabel) return `getByLabel('${escJs(ariaLabel)}')`;
+    const placeholder = el.getAttribute && el.getAttribute("placeholder");
+    if (placeholder) return `getByPlaceholder('${escJs(placeholder)}')`;
+    const alt = el.getAttribute && el.getAttribute("alt");
+    if (alt) return `getByAltText('${escJs(alt)}')`;
+    const titleAttr = el.getAttribute && el.getAttribute("title");
+    if (titleAttr) return `getByTitle('${escJs(titleAttr)}')`;
+    if (el.id) return `locator('#${escJs(el.id)}')`;
+    const cls = (el.getAttribute && el.getAttribute("class") || "").split(/\s+/).find((c) => c.length > 1);
+    return cls ? `locator('.${escJs(cls)}')` : tag;
+  };
+  const buildChain = (raw) => {
+    const chain2 = [];
+    let node = raw;
+    while (node && chain2.length < 15) {
+      const tag = (node.tagName || "").toLowerCase();
+      if (tag === "body" || tag === "html") break;
+      chain2.push(node);
+      node = node.parentElement;
+    }
+    return chain2.length ? chain2 : [raw];
+  };
+  const ACTIONABLE_TAGS = ["button", "a", "input", "select", "textarea", "summary", "option"];
+  const snapIndex = (chain2) => {
+    for (let i = 0; i < Math.min(chain2.length, 4); i++) {
+      const el = chain2[i];
+      const tag = (el.tagName || "").toLowerCase();
+      if (ACTIONABLE_TAGS.includes(tag)) return i;
+      if (el.getAttribute && (el.getAttribute("role") || el.getAttribute("data-testid"))) return i;
+    }
+    return 0;
+  };
+  const locatorOf = (el) => {
+    const hook = g.__piwiDescribeElement;
+    if (typeof hook === "function") {
+      try {
+        const derived = hook(el);
+        if (typeof derived === "string" && derived) return derived;
+      } catch {
       }
     }
-    const pos = attrs.rolePosition;
-    if (pos && pos.role === role && (pos.count === 1 || level != null && pos.levelCount === 1)) {
-      add({
-        locator: `getByRole(${rolePart})`,
-        method: "getByRole",
-        args: leafArgs,
-        score: 58
-      });
+    return describe(el);
+  };
+  let chain = [];
+  let idx = 0;
+  let lastRaw = null;
+  let labeled = null;
+  const placeLabel = (r) => {
+    label.style.display = "block";
+    const lr = label.getBoundingClientRect();
+    const vw = g.innerWidth || doc.documentElement.clientWidth || 0;
+    const vh = g.innerHeight || doc.documentElement.clientHeight || 0;
+    let top = r.top - lr.height - 6;
+    if (top < 4) top = r.bottom + 6;
+    if (top + lr.height > vh - 4) top = Math.max(4, vh - lr.height - 4);
+    let left = r.left;
+    if (left + lr.width > vw - 6) left = vw - lr.width - 6;
+    if (left < 6) left = 6;
+    label.style.left = left + "px";
+    label.style.top = top + "px";
+  };
+  const current = () => chain[idx] ?? null;
+  const refresh = () => {
+    const el = current();
+    if (!el) {
+      highlight.style.display = "none";
+      label.style.display = "none";
+      return;
     }
-  }
-  const clsStr = attr(attrs, "class");
-  if (clsStr) {
-    const countsClasses = counts?.classes;
-    const classes = clsStr.split(/\s+/).filter((c) => c.length > 1 && /^[A-Za-z_-][A-Za-z0-9_-]*$/.test(c) && isUnique(countsClasses?.[c])).map((cls) => ({ cls, score: classifyCssStability(cls) })).sort((a, b) => b.score - a.score).slice(0, 3);
-    for (const { cls, score } of classes) {
-      add({
-        locator: `locator('.${esc(cls)}')`,
-        method: "locator",
-        args: { selector: `.${cls}` },
-        score
-      });
+    const r = el.getBoundingClientRect();
+    highlight.style.display = "block";
+    highlight.style.left = r.left + "px";
+    highlight.style.top = r.top + "px";
+    highlight.style.width = r.width + "px";
+    highlight.style.height = r.height + "px";
+    if (el !== labeled) {
+      labeled = el;
+      const tag = (el.tagName || "?").toLowerCase();
+      const locatorHtml = hlTokens(locatorOf(el));
+      label.innerHTML = `<span style="color:#c4b5fd">&lt;${tag}&gt;</span> ${locatorHtml}`;
+      locatorLine.innerHTML = locatorHtml;
+      locatorLine.style.display = "block";
     }
-  }
-  return alts.sort((a, b) => b.score - a.score);
-}
-function approximateAccessibleName(attrs) {
-  const a = attrs.attributes;
-  const ariaLabel = a["aria-label"];
-  if (ariaLabel) return ariaLabel;
-  if (attrs.textContent) return attrs.textContent;
-  const title = a["title"];
-  if (title) return title;
-  const placeholder = a["placeholder"];
-  if (placeholder) return placeholder;
-  return null;
-}
-
-// src/internal/capture/locator-healing.ts
-function dedupeSnapshotsByLocation(snaps) {
-  const lastWithElement = /* @__PURE__ */ new Map();
-  const lastAny = /* @__PURE__ */ new Map();
-  snaps.forEach((s, i) => {
-    if (!s.location) return;
-    lastAny.set(s.location, i);
-    if (s.element) lastWithElement.set(s.location, i);
-  });
-  return snaps.filter((s, i) => {
-    if (!s.location) return true;
-    return (lastWithElement.get(s.location) ?? lastAny.get(s.location)) === i;
-  });
-}
-var LOCATOR_METHODS = [...LOCATOR_BUILDER_METHODS];
-var CHAIN_METHODS = [
-  "first",
-  "nth",
-  "last",
-  "filter",
-  "and",
-  "or",
-  "locator",
-  "getByRole",
-  "getByTestId",
-  "getByText",
-  "getByLabel",
-  "getByPlaceholder",
-  "getByAltText",
-  "getByTitle"
-];
-var ACTION_METHODS = [
-  "click",
-  "fill",
-  "check",
-  "uncheck",
-  "selectOption",
-  "dblclick",
-  "tap",
-  "hover",
-  "press",
-  "type",
-  "pressSequentially",
-  "clear",
-  "setInputFiles",
-  "dragTo",
-  "focus",
-  "blur",
-  "scrollIntoViewIfNeeded",
-  "dispatchEvent",
-  "selectText",
-  // Not an action, but a successful waitFor proves the element resolved — the
-  // closest capture hook available for assertion-style usage of a locator.
-  "waitFor"
-];
-var LOCATOR_CREATING_CHAINS = new Set(LOCATOR_METHODS);
-var EXPECT_METHOD = "_expect";
-var EXPECT_CAPTURE_EXPRESSIONS = /* @__PURE__ */ new Set([
-  "to.be.attached",
-  "to.be.checked",
-  "to.be.disabled",
-  "to.be.editable",
-  "to.be.empty",
-  "to.be.enabled",
-  "to.be.focused",
-  "to.be.in.viewport",
-  "to.be.readonly",
-  "to.be.visible",
-  "to.contain.class",
-  "to.contain.text",
-  "to.have.accessible.description",
-  "to.have.accessible.error.message",
-  "to.have.accessible.name",
-  "to.have.attribute",
-  "to.have.attribute.value",
-  "to.have.class",
-  "to.have.css",
-  "to.have.id",
-  "to.have.js.property",
-  "to.have.role",
-  "to.have.text",
-  "to.have.value",
-  "to.match.aria"
-]);
-function extractAccessibleName(ariaSnapshot) {
-  if (!ariaSnapshot) return null;
-  const match = ariaSnapshot.match(/- \w+ "([^"]+)"/);
-  if (match) return match[1];
-  return null;
-}
-var NAME_BASED_METHODS = /* @__PURE__ */ new Set([
-  "getByText",
-  "getByRole",
-  "getByLabel",
-  "getByPlaceholder",
-  "getByTitle",
-  "getByAltText"
-]);
-var escAttr = (s) => s.replaceAll("\\", "\\\\").replaceAll("'", "\\'");
-var SUGG_TEXT_ROLES = /* @__PURE__ */ new Set([
-  "button",
-  "link",
-  "heading",
-  "menuitem",
-  "tab",
-  "option",
-  "cell",
-  "columnheader",
-  "rowheader",
-  "gridcell",
-  "treeitem",
-  "listitem",
-  "checkbox",
-  "radio",
-  "switch"
-]);
-var SUGG_FIELD_ROLES = /* @__PURE__ */ new Set(["textbox", "combobox", "searchbox", "spinbutton", "slider"]);
-function failedNameAndRole(failed) {
-  if (failed.method === "getByRole") {
-    const role = typeof failed.args[0] === "string" ? failed.args[0] : null;
-    const opts = failed.args[1];
-    const name = opts && typeof opts.name === "string" ? opts.name : null;
-    const level = opts && typeof opts.level === "number" ? opts.level : null;
-    return { role, name, level };
-  }
-  const first = failed.args.find((a) => typeof a === "string");
-  return { role: null, name: typeof first === "string" ? first : null, level: null };
-}
-function renderFailing(failed) {
-  const { role, name } = failedNameAndRole(failed);
-  if (failed.method === "getByRole") {
-    return name ? `getByRole('${escAttr(role ?? "")}', { name: '${escAttr(name)}' })` : `getByRole('${escAttr(role ?? "")}')`;
-  }
-  return `${failed.method}('${escAttr(name ?? "")}')`;
-}
-function freshSuggestions(candidate, failedMethod) {
-  const out = [];
-  const role = candidate.role;
-  const name = candidate.name;
-  const push = (s) => {
-    if (!out.includes(s)) out.push(s);
+    placeLabel(r);
+    foot.textContent = "click to pick \xB7 \u2191 parent \xB7 \u2193 child \xB7 Esc skip";
   };
-  const levelPart = candidate.level != null ? `, level: ${candidate.level}` : "";
-  const roleLoc = `getByRole('${escAttr(role)}', { name: '${escAttr(name)}'${levelPart} })`;
-  const textLoc = `getByText('${escAttr(name)}')`;
-  const labelLoc = `getByLabel('${escAttr(name)}')`;
-  if (failedMethod === "getByText" && SUGG_TEXT_ROLES.has(role)) push(textLoc);
-  if (failedMethod === "getByLabel" && SUGG_FIELD_ROLES.has(role)) push(labelLoc);
-  push(roleLoc);
-  if (SUGG_TEXT_ROLES.has(role)) push(textLoc);
-  else if (SUGG_FIELD_ROLES.has(role)) push(labelLoc);
-  return out;
-}
-function suggestLocatorsFromAria(failed, ariaSnapshot) {
-  if (!ariaSnapshot || !NAME_BASED_METHODS.has(failed.method)) return null;
-  const { role, name, level } = failedNameAndRole(failed);
-  if (!name) return null;
-  const candidates = parseAriaCandidates(ariaSnapshot);
-  if (candidates.length === 0) return null;
-  const fingerprint = { role, name, level };
-  if (fingerprintPresent(fingerprint, candidates)) return null;
-  const best = matchRenamedElement(fingerprint, candidates)?.candidate;
-  if (!best || !best.name) return null;
-  const suggestions = freshSuggestions({ role: best.role, name: best.name, level: best.level }, failed.method);
-  if (suggestions.length === 0) return null;
-  return { failing: renderFailing(failed), suggestions };
-}
-function captureCallerLocation(stack = new Error().stack ?? "") {
-  const lines = stack.split("\n");
-  let prevWasCaptureModule = false;
-  let selfFile = null;
-  for (let i = 1; i < lines.length; i++) {
-    const line = lines[i].trim();
-    if (!line.startsWith("at")) continue;
-    const m = line.match(/^at\s+(?:(.+?)\s+\()?(.+?):(\d+):(\d+)\)?$/);
-    if (!m) {
-      prevWasCaptureModule = false;
-      continue;
+  const stop = (e) => {
+    e.preventDefault();
+    e.stopImmediatePropagation();
+  };
+  const isOwn = (el) => el === banner || el === highlight || el === label || banner.contains && banner.contains(el) || !!(el && el.__piwiHint);
+  let bannerDocked = "top";
+  const dockBanner = (side) => {
+    if (bannerDocked === side) return;
+    bannerDocked = side;
+    if (side === "bottom") {
+      banner.style.top = "auto";
+      banner.style.bottom = "12px";
+    } else {
+      banner.style.top = "12px";
+      banner.style.bottom = "auto";
+    }
+  };
+  const onMove = (e) => {
+    const raw = e.target;
+    if (!raw || isOwn(raw)) {
+      highlight.style.display = "none";
+      label.style.display = "none";
+      return;
+    }
+    if (raw !== lastRaw) {
+      lastRaw = raw;
+      chain = buildChain(raw);
+      idx = snapIndex(chain);
+    }
+    refresh();
+    const el = current();
+    if (el) {
+      const r = el.getBoundingClientRect();
+      const br = banner.getBoundingClientRect();
+      const margin = 8;
+      if (r.left < br.right + margin && r.right > br.left - margin && r.top < br.bottom + margin && r.bottom > br.top - margin) {
+        dockBanner(bannerDocked === "top" ? "bottom" : "top");
+      }
+    }
+  };
+  const suppressed = ["mousedown", "mouseup", "pointerdown", "pointerup", "auxclick", "dblclick"];
+  const removePickingListeners = () => {
+    doc.removeEventListener("mousemove", onMove, true);
+    doc.removeEventListener("click", onClick, true);
+    doc.removeEventListener("keydown", onKey, true);
+    if (arg.transport === "postMessage") g.removeEventListener("message", onParentMsg, false);
+  };
+  const removeSuppressed = () => {
+    for (const t of suppressed) doc.removeEventListener(t, stop, true);
+  };
+  const cleanup = () => {
+    highlight.remove();
+    label.remove();
+    banner.remove();
+  };
+  const reportPicked = (el) => {
+    removePickingListeners();
+    highlight.style.display = "none";
+    label.style.display = "none";
+    if (arg.transport === "postMessage") {
+      const probeFn = g.__piwiProbe;
+      const attrs = typeof probeFn === "function" ? probeFn(el, arg.probeArg) : null;
+      g.__piwiSnapshotExtras?.onPick?.();
+      doc.addEventListener("click", stop, true);
+      doc.addEventListener("keydown", stop, true);
+      foot.textContent = "Analyzing element\u2026";
+      g.parent.postMessage({ type: "elementPicked", attrs }, "*");
+    } else {
+      removeSuppressed();
+      g.__piwiPickedElement = el;
+      g.__piwiPickState = "picked";
+      foot.textContent = "Analyzing element\u2026";
+    }
+  };
+  const reportSkipped = () => {
+    removePickingListeners();
+    if (arg.transport === "postMessage") {
+      doc.removeEventListener("click", stop, true);
+      doc.removeEventListener("keydown", stop, true);
+      removeSuppressed();
+      g.__piwiSnapshotExtras?.onClose?.();
+      cleanup();
+      g.parent.postMessage({ type: "pickerClosed" }, "*");
+    } else {
+      removeSuppressed();
+      g.__piwiPickState = "skipped";
+      cleanup();
     }
-    let file = m[2];
-    if (!file || file.startsWith("node:")) {
-      prevWasCaptureModule = false;
-      continue;
+  };
+  const onClick = (e) => {
+    stop(e);
+    const el = current();
+    if (!el || isOwn(e.target)) return;
+    reportPicked(el);
+  };
+  const onKey = (e) => {
+    if (e.key === "Escape") {
+      stop(e);
+      reportSkipped();
+      return;
     }
-    file = file.replace(/^file:\/\/\/?/, "");
-    if (!/\.[a-z]+$/i.test(file)) {
-      prevWasCaptureModule = false;
-      continue;
+    if (e.key === "ArrowUp" || e.key === "ArrowDown") {
+      stop(e);
+      if (e.key === "ArrowUp") idx = Math.min(idx + 1, chain.length - 1);
+      else idx = Math.max(idx - 1, 0);
+      refresh();
     }
-    if (selfFile === null || file === selfFile) {
-      selfFile ??= file;
-      prevWasCaptureModule = /[\\/]locator-healing\.[a-z]+$/i.test(file);
-      continue;
+  };
+  const onParentMsg = (e) => {
+    const d = e.data;
+    if (!d || typeof d.type !== "string" || d.type !== "piwiPickerKey" || typeof d.key !== "string") return;
+    onKey({
+      key: d.key,
+      preventDefault() {
+      },
+      stopImmediatePropagation() {
+      }
+    });
+  };
+  g.__piwiPickCleanup = cleanup;
+  doc.addEventListener("mousemove", onMove, true);
+  doc.addEventListener("click", onClick, true);
+  doc.addEventListener("keydown", onKey, true);
+  for (const t of suppressed) doc.addEventListener(t, stop, true);
+  if (arg.transport === "postMessage") {
+    g.addEventListener("message", onParentMsg, false);
+    g.parent.postMessage({ type: "pickerReady" }, "*");
+  }
+}
+
+// ../picker-dom/src/overlay-anchors.ts
+function showAnchorPicker(arg) {
+  const g = globalThis;
+  const doc = g.document;
+  const el = g.__piwiPickedElement;
+  if (!doc || !doc.body || !el) {
+    g.__piwiAnchorState = "skipped";
+    return;
+  }
+  const Z = 2147483600;
+  const { tagRoles, inputRoles, roleSources, leafRole, leafLevel, leafTestId } = arg;
+  const roleOf = (n) => {
+    const explicit = n.getAttribute && n.getAttribute("role");
+    if (explicit) return explicit;
+    const tag = (n.tagName || "").toLowerCase();
+    if (tag === "input") return inputRoles[(n.getAttribute("type") || "text").toLowerCase()] ?? "textbox";
+    if (tag === "select") return n.getAttribute("multiple") != null ? "listbox" : "combobox";
+    if (tag === "a") return n.getAttribute("href") != null ? "link" : null;
+    return tagRoles[tag] ?? null;
+  };
+  const levelOf = (n) => {
+    const m = /^h([1-6])$/.exec((n.tagName || "").toLowerCase());
+    if (m) return Number(m[1]);
+    const al = n.getAttribute && n.getAttribute("aria-level");
+    return al && /^\d+$/.test(al) ? Number(al) : null;
+  };
+  const leafMatches = (scope) => {
+    try {
+      if (leafTestId) return scope.querySelectorAll(`[data-testid=${JSON.stringify(leafTestId)}]`).length;
+      const nodes = scope.querySelectorAll(roleSources);
+      if (nodes.length > 2e3) return -1;
+      let matched = 0;
+      for (let i = 0; i < nodes.length; i++) {
+        const n = nodes[i];
+        if (roleOf(n) !== leafRole) continue;
+        if (leafLevel != null && levelOf(n) !== leafLevel) continue;
+        matched++;
+      }
+      return matched;
+    } catch {
+      return -1;
     }
-    if (/[\\/]locator-healing\.[a-z]+$/i.test(file)) {
-      prevWasCaptureModule = true;
-      continue;
+  };
+  let roleNodes = [];
+  try {
+    const all = doc.querySelectorAll(roleSources);
+    if (all.length <= 4e3) roleNodes = Array.from(all);
+  } catch {
+    roleNodes = [];
+  }
+  const count = (sel) => {
+    try {
+      return doc.querySelectorAll(sel).length;
+    } catch {
+      return void 0;
     }
-    if (prevWasCaptureModule && /[\\/](?:capture-)?fixtures\.[a-z]+$/i.test(file)) {
-      prevWasCaptureModule = false;
-      continue;
+  };
+  const rows = [];
+  let node = el.parentElement;
+  let depth = 0;
+  while (node && depth < 12) {
+    depth++;
+    const tag = (node.tagName || "").toLowerCase();
+    if (tag === "body" || tag === "html") break;
+    const testId = node.getAttribute("data-testid");
+    const id = node.getAttribute("id");
+    const ariaLabel = node.getAttribute("aria-label");
+    const role = roleOf(node);
+    const info = { tag, depth, testId: testId || null, id: id || null, ariaLabel: ariaLabel || null, role };
+    if (testId) info.testIdCount = count(`[data-testid=${JSON.stringify(testId)}]`);
+    if (id) {
+      try {
+        info.idCount = count(`#${doc.defaultView.CSS.escape(id)}`);
+      } catch {
+      }
     }
-    if (/[\\/]node_modules[\\/]/.test(file)) {
-      prevWasCaptureModule = false;
-      continue;
+    if (role) {
+      let roleCount = 0;
+      let labeledCount = 0;
+      for (const n of roleNodes) {
+        if (roleOf(n) !== role) continue;
+        roleCount++;
+        if (ariaLabel && n.getAttribute && n.getAttribute("aria-label") === ariaLabel) labeledCount++;
+      }
+      info.roleCount = roleCount;
+      if (ariaLabel) info.labeledRoleCount = labeledCount;
     }
-    let rel = file;
+    info.scopedLeafCount = leafMatches(node);
+    const hookLabel = testId ? `data-testid="${testId}"` : id ? `#${id}` : ariaLabel && role ? `${role} "${ariaLabel}"` : role ? `role ${role}` : "no stable hook";
+    rows.push({
+      node,
+      info,
+      hookLabel,
+      selectable: !!(testId || id || role && (ariaLabel || info.roleCount === 1))
+    });
+    node = node.parentElement;
+  }
+  if (rows.length === 0) {
+    g.__piwiAnchorState = "skipped";
+    return;
+  }
+  const MONO = "ui-monospace,SFMono-Regular,Menlo,Consolas,monospace";
+  const outline = doc.createElement("div");
+  outline.style.cssText = `position:fixed;pointer-events:none;z-index:${Z};box-sizing:border-box;border:2px solid #22c55e;background:rgba(34,197,94,.10);border-radius:4px;display:none;box-shadow:0 0 0 1px rgba(255,255,255,.9),0 0 0 3px rgba(5,46,22,.5);`;
+  const outlineLabel = doc.createElement("div");
+  outlineLabel.style.cssText = `position:fixed;pointer-events:none;z-index:${Z + 1};display:none;box-sizing:border-box;max-width:min(420px,90vw);background:#0b1120;color:#f9fafb;border:1px solid #22c55e;border-radius:6px;padding:3px 7px;font:12px/1.45 ${MONO};white-space:nowrap;overflow:hidden;text-overflow:ellipsis;box-shadow:0 4px 18px rgba(0,0,0,.5);`;
+  const pickedOutline = doc.createElement("div");
+  const pr = el.getBoundingClientRect();
+  pickedOutline.style.cssText = `position:fixed;pointer-events:none;z-index:${Z};box-sizing:border-box;border:2px solid #a855f7;background:rgba(168,85,247,.14);border-radius:4px;box-shadow:0 0 0 1px rgba(255,255,255,.9),0 0 0 3px rgba(59,7,100,.55);left:${pr.left}px;top:${pr.top}px;width:${pr.width}px;height:${pr.height}px;`;
+  const panel = doc.createElement("div");
+  panel.style.cssText = `position:fixed;top:12px;right:12px;z-index:${Z + 3};width:340px;max-height:82vh;overflow:auto;background:#111827;color:#f9fafb;border-radius:10px;padding:16px;font:12px/1.5 system-ui,sans-serif;box-shadow:0 8px 40px rgba(0,0,0,.5);`;
+  const title = doc.createElement("div");
+  title.style.cssText = "font-weight:600;font-size:13px;margin-bottom:2px;";
+  title.textContent = "Scope to stable parents (optional)";
+  const sub = doc.createElement("div");
+  sub.style.cssText = "color:#9ca3af;margin-bottom:10px;";
+  sub.textContent = "Pick one or more parents to anchor the locator to. Hover a row to see the parent.";
+  panel.appendChild(title);
+  panel.appendChild(sub);
+  const selected = /* @__PURE__ */ new Set();
+  const footer = doc.createElement("div");
+  footer.style.cssText = "margin:10px 0;font-weight:600;";
+  const segMatches = (scope, info) => {
     try {
-      rel = path.relative(process.cwd(), file);
+      if (info.testId) return Array.from(scope.querySelectorAll(`[data-testid=${JSON.stringify(info.testId)}]`));
+      if (info.id) return Array.from(scope.querySelectorAll(`#${doc.defaultView.CSS.escape(info.id)}`));
+      const nodes = Array.from(scope.querySelectorAll(roleSources));
+      if (nodes.length > 2e3) return [];
+      return nodes.filter(
+        (n) => roleOf(n) === info.role && (!info.ariaLabel || n.getAttribute && n.getAttribute("aria-label") === info.ariaLabel)
+      );
     } catch {
+      return [];
     }
-    rel = rel.split(path.sep).join("/");
-    if (rel.startsWith("./")) rel = rel.slice(2);
-    return `${rel}:${m[3]}:${m[4]}`;
-  }
-  return null;
+  };
+  const chainCount = () => {
+    const chosen = rows.filter((_, i) => selected.has(i)).sort((a, b) => b.info.depth - a.info.depth);
+    if (chosen.length === 0) return -1;
+    let scopes = [doc];
+    for (const row of chosen) {
+      const next = [];
+      for (const s of scopes) next.push(...segMatches(s, row.info));
+      scopes = next.slice(0, 200);
+      if (scopes.length === 0) return 0;
+    }
+    let total = 0;
+    for (const s of scopes) {
+      const c = leafMatches(s);
+      if (c > 0) total += c;
+      if (total > 50) return total;
+    }
+    return total;
+  };
+  const refreshFooter = () => {
+    if (selected.size === 0) {
+      footer.textContent = "No parents selected \u2014 standard alternatives only.";
+      footer.style.color = "#9ca3af";
+      g.__piwiPickChainCount = void 0;
+      return;
+    }
+    const c = chainCount();
+    g.__piwiPickChainCount = c;
+    if (c === 1) {
+      footer.textContent = "\u2713 Selection matches exactly 1 element";
+      footer.style.color = "#4ade80";
+    } else {
+      footer.textContent = c < 0 ? "Match count unavailable" : `\u2717 Selection matches ${c} elements`;
+      footer.style.color = "#fbbf24";
+    }
+  };
+  rows.forEach((row, i) => {
+    const line = doc.createElement("label");
+    line.style.cssText = `display:flex;align-items:center;gap:8px;padding:6px 8px;border:1px solid #374151;border-radius:6px;margin-bottom:6px;cursor:${row.selectable ? "pointer" : "default"};opacity:${row.selectable ? "1" : ".45"};`;
+    const box = doc.createElement("input");
+    box.type = "checkbox";
+    box.disabled = !row.selectable;
+    const text = doc.createElement("span");
+    text.style.cssText = "flex:1;min-width:0;";
+    const code = doc.createElement("code");
+    code.style.cssText = `display:block;font:12px ${MONO};color:#f3f4f6;word-break:break-all;`;
+    code.textContent = `<${row.info.tag}> ${row.hookLabel}`;
+    const hint = doc.createElement("span");
+    hint.style.cssText = "color:#9ca3af;";
+    hint.textContent = row.selectable ? row.info.scopedLeafCount === 1 ? "contains exactly 1 matching element" : `contains ${row.info.scopedLeafCount ?? "?"} matching elements` : "add a data-testid to make this usable";
+    text.appendChild(code);
+    text.appendChild(hint);
+    line.appendChild(box);
+    line.appendChild(text);
+    line.addEventListener("mouseenter", () => {
+      const r = row.node.getBoundingClientRect();
+      outline.style.display = "block";
+      outline.style.left = r.left + "px";
+      outline.style.top = r.top + "px";
+      outline.style.width = r.width + "px";
+      outline.style.height = r.height + "px";
+      outlineLabel.textContent = `<${row.info.tag}> ${row.hookLabel}`;
+      outlineLabel.style.display = "block";
+      const lr = outlineLabel.getBoundingClientRect();
+      const vw = g.innerWidth || doc.documentElement.clientWidth || 0;
+      const top = r.top - lr.height - 6 < 4 ? r.bottom + 6 : r.top - lr.height - 6;
+      outlineLabel.style.left = Math.max(6, Math.min(r.left, vw - lr.width - 6)) + "px";
+      outlineLabel.style.top = top + "px";
+    });
+    line.addEventListener("mouseleave", () => {
+      outline.style.display = "none";
+      outlineLabel.style.display = "none";
+    });
+    box.addEventListener("change", () => {
+      if (box.checked) selected.add(i);
+      else selected.delete(i);
+      refreshFooter();
+    });
+    panel.appendChild(line);
+  });
+  panel.appendChild(footer);
+  const cleanup = () => {
+    doc.removeEventListener("keydown", onKey, true);
+    panel.remove();
+    outline.remove();
+    outlineLabel.remove();
+    pickedOutline.remove();
+  };
+  const done = (state) => {
+    g.__piwiPickAnchors = state === "done" ? rows.filter((_, i) => selected.has(i)).map((r) => r.info) : [];
+    g.__piwiAnchorState = state;
+    cleanup();
+  };
+  const onKey = (e) => {
+    if (e.key !== "Escape") return;
+    e.preventDefault();
+    e.stopImmediatePropagation();
+    done("skipped");
+  };
+  const buttonRow = doc.createElement("div");
+  buttonRow.style.cssText = "display:flex;gap:8px;margin-top:4px;";
+  const useBtn = doc.createElement("button");
+  useBtn.style.cssText = "flex:1;background:#7c3aed;color:#fff;border:none;border-radius:6px;padding:8px;cursor:pointer;font:600 12px system-ui;";
+  useBtn.textContent = "Use selected parents";
+  useBtn.addEventListener("click", (e) => {
+    e.preventDefault();
+    e.stopImmediatePropagation();
+    done(selected.size > 0 ? "done" : "skipped");
+  });
+  const skipBtn = doc.createElement("button");
+  skipBtn.style.cssText = "background:none;border:1px solid #374151;color:#9ca3af;border-radius:6px;padding:8px 10px;cursor:pointer;font:12px system-ui;";
+  skipBtn.textContent = "Skip (Esc)";
+  skipBtn.addEventListener("click", (e) => {
+    e.preventDefault();
+    e.stopImmediatePropagation();
+    done("skipped");
+  });
+  buttonRow.appendChild(useBtn);
+  buttonRow.appendChild(skipBtn);
+  panel.appendChild(buttonRow);
+  refreshFooter();
+  g.__piwiAnchorCleanup = cleanup;
+  doc.addEventListener("keydown", onKey, true);
+  doc.body.appendChild(pickedOutline);
+  doc.body.appendChild(outline);
+  doc.body.appendChild(outlineLabel);
+  doc.body.appendChild(panel);
 }
 
-// src/internal/capture/attachments.ts
-var ATTACHMENT_NAMES = {
-  locators: "piwi-locators",
-  ariaSnapshot: "piwi-aria-snapshot",
-  console: "piwi-console",
-  network: "piwi-network",
-  webVitals: "piwi-web-vitals",
-  locatorSuggestion: "piwi-locator-suggestion",
-  pageState: "piwi-page-state",
-  userPick: "piwi-user-pick"
-};
-var INTERNAL_ATTACHMENT_NAMES = new Set(Object.values(ATTACHMENT_NAMES));
-var LOCATOR_SUGGESTION_ANNOTATION = ATTACHMENT_NAMES.locatorSuggestion;
-var USER_PICK_ANNOTATION = ATTACHMENT_NAMES.userPick;
-
-// src/internal/capture/inspect-on-failure.ts
-function isCi(ci) {
-  return ci !== void 0 && ci !== "" && ci !== "false";
-}
-function shouldInspectOnFailure(gate) {
-  if (gate.enabled !== "true") return false;
-  if (isCi(gate.ci)) return false;
-  if (gate.headless !== false) return false;
-  if (gate.status !== "failed" && gate.status !== "timedOut") return false;
-  if (gate.status === gate.expectedStatus) return false;
-  return gate.retry >= gate.retries;
-}
-function environmentalSkipReason(gate) {
-  if (gate.enabled !== "true") return null;
-  if (gate.status !== "failed" && gate.status !== "timedOut") return null;
-  if (gate.status === gate.expectedStatus) return null;
-  if (isCi(gate.ci)) return "running under CI \u2014 this is a headed, local-only feature";
-  if (gate.headless !== false) {
-    return "the browser is headless \u2014 re-run with --headed (or set use: { headless: false })";
+// ../picker-dom/src/overlay-confirm.ts
+function showPickerChoices(arg) {
+  const g = globalThis;
+  const doc = g.document;
+  if (!doc || !doc.body) {
+    g.__piwiPickChoice = -1;
+    return;
   }
-  return null;
-}
-function inspectionGateFromTestInfo(testInfo, enabled = process.env.PIWI_INSPECT_ON_FAIL) {
-  const use = testInfo.project?.use ?? {};
-  return {
-    enabled,
-    ci: process.env.CI,
-    status: testInfo.status,
-    expectedStatus: testInfo.expectedStatus,
-    headless: use.headless,
-    retry: testInfo.retry,
-    retries: testInfo.project?.retries ?? 0
+  const Z = 2147483600;
+  const wrap = doc.createElement("div");
+  wrap.style.cssText = `position:fixed;inset:0;z-index:${Z + 3};background:rgba(0,0,0,.45);display:flex;align-items:center;justify-content:center;font:13px/1.5 system-ui,sans-serif;`;
+  const panel = doc.createElement("div");
+  panel.style.cssText = "background:#111827;color:#f9fafb;border-radius:10px;padding:20px;max-width:640px;width:90vw;max-height:70vh;overflow:auto;box-shadow:0 8px 40px rgba(0,0,0,.5);";
+  const hlLocator = (expr) => {
+    const escHtml = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+    const re = /('(?:\\.|[^'])*'|"(?:\\.|[^"])*")|([A-Za-z_$][\w$]*)(?=\s*\()|([A-Za-z_$][\w$]*)(?=\s*:)|(true|false|null|\d+)|([{}(),.])/g;
+    let html = "";
+    let last = 0;
+    let m;
+    while ((m = re.exec(expr)) !== null) {
+      if (m.index > last) html += escHtml(expr.slice(last, m.index));
+      const color = m[1] ? "#86efac" : m[2] ? "#d8b4fe" : m[3] ? "#93c5fd" : m[4] ? "#fcd34d" : "#9ca3af";
+      html += `<span style="color:${color}">${escHtml(m[0])}</span>`;
+      last = re.lastIndex;
+    }
+    if (last < expr.length) html += escHtml(expr.slice(last));
+    return html;
+  };
+  const title = doc.createElement("div");
+  title.style.cssText = "font-weight:600;margin-bottom:4px;";
+  title.textContent = arg.failing ? "Pick a replacement locator" : "Pick a locator";
+  const sub = doc.createElement("div");
+  sub.style.cssText = "color:#9ca3af;margin-bottom:12px;";
+  if (arg.failing) {
+    sub.innerHTML = `Replaces <code style="font-family:ui-monospace,Menlo,monospace">${hlLocator(arg.failing)}</code> \u2014 ranked by stability score.`;
+  } else {
+    sub.textContent = "For the element you picked \u2014 ranked by stability score.";
+  }
+  panel.appendChild(title);
+  panel.appendChild(sub);
+  const done = (choice) => {
+    g.__piwiPickChoice = choice;
+    doc.removeEventListener("keydown", onKey, true);
+    wrap.remove();
+  };
+  const onKey = (e) => {
+    if (e.key !== "Escape") return;
+    e.preventDefault();
+    e.stopImmediatePropagation();
+    done(-1);
   };
+  arg.choices.forEach((c, i) => {
+    const btn = doc.createElement("button");
+    btn.style.cssText = "display:flex;justify-content:space-between;align-items:center;gap:12px;width:100%;text-align:left;background:#0b1120;color:#f3f4f6;border:1px solid #374151;border-radius:6px;padding:8px 12px;margin:0 0 8px;cursor:pointer;font:13px/1.55 ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;";
+    const code = doc.createElement("span");
+    code.innerHTML = hlLocator(c.locator);
+    code.style.cssText = "word-break:break-all;";
+    const score = doc.createElement("span");
+    score.textContent = String(c.score);
+    score.style.cssText = "color:#c4b5fd;flex-shrink:0;font-variant-numeric:tabular-nums;";
+    btn.appendChild(code);
+    btn.appendChild(score);
+    btn.addEventListener("click", (e) => {
+      e.preventDefault();
+      e.stopImmediatePropagation();
+      done(i);
+    });
+    panel.appendChild(btn);
+  });
+  const skip = doc.createElement("button");
+  skip.style.cssText = "background:none;border:none;color:#9ca3af;cursor:pointer;padding:6px 0 0;font:12px system-ui,sans-serif;";
+  skip.textContent = "Skip \u2014 keep the failure as-is (Esc)";
+  skip.addEventListener("click", (e) => {
+    e.preventDefault();
+    e.stopImmediatePropagation();
+    done(-1);
+  });
+  panel.appendChild(skip);
+  doc.addEventListener("keydown", onKey, true);
+  wrap.appendChild(panel);
+  doc.body.appendChild(wrap);
 }
 
-// src/internal/capture/pick-on-failure.ts
-var path2 = __toESM(require("path"));
-var ANSI_RE = /\[[0-9;]*m/g;
-function endOfString(s, start) {
-  const q = s[start];
-  for (let i = start + 1; i < s.length; i++) {
-    if (s[i] === "\\") {
-      i++;
-      continue;
-    }
-    if (s[i] === q) return i;
+// ../core/src/locator-generation.ts
+var TAG_TO_ROLE = {
+  a: "link",
+  button: "button",
+  nav: "navigation",
+  main: "main",
+  article: "article",
+  section: "region",
+  form: "form",
+  img: "img",
+  figure: "figure",
+  figcaption: "caption",
+  blockquote: "blockquote",
+  table: "table",
+  caption: "caption",
+  thead: "rowgroup",
+  tbody: "rowgroup",
+  tfoot: "rowgroup",
+  tr: "row",
+  td: "cell",
+  ul: "list",
+  ol: "list",
+  li: "listitem",
+  dialog: "dialog",
+  output: "status",
+  progress: "progressbar",
+  meter: "meter",
+  textarea: "textbox",
+  h1: "heading",
+  h2: "heading",
+  h3: "heading",
+  h4: "heading",
+  h5: "heading",
+  h6: "heading",
+  details: "group",
+  summary: "button",
+  search: "search"
+};
+var INPUT_TYPE_TO_ROLE = {
+  button: "button",
+  submit: "button",
+  reset: "button",
+  image: "button",
+  checkbox: "checkbox",
+  radio: "radio",
+  range: "slider",
+  search: "searchbox",
+  number: "spinbutton",
+  text: "textbox",
+  email: "textbox",
+  tel: "textbox",
+  url: "textbox",
+  password: "textbox"
+};
+var CAPTURED_ATTRIBUTES = [
+  "id",
+  "class",
+  "name",
+  "data-testid",
+  "placeholder",
+  "alt",
+  "title",
+  "aria-label",
+  "aria-level",
+  "role",
+  "type",
+  "href",
+  "multiple"
+];
+function resolveAriaRole(attrs) {
+  const explicit = attrs.attributes["role"];
+  if (explicit) return explicit;
+  const tag = attrs.tagName;
+  if (!tag) return null;
+  if (tag === "input") {
+    const type = (attrs.attributes["type"] ?? "text").toLowerCase();
+    return INPUT_TYPE_TO_ROLE[type] ?? "textbox";
   }
-  return s.length - 1;
+  if (tag === "select") {
+    return attrs.attributes["multiple"] != null ? "listbox" : "combobox";
+  }
+  if (tag === "a") {
+    return attrs.attributes["href"] != null ? "link" : null;
+  }
+  return TAG_TO_ROLE[tag] ?? null;
+}
+function headingLevel(attrs, role) {
+  if (role !== "heading") return null;
+  const tagMatch = attrs.tagName.match(/^h([1-6])$/);
+  if (tagMatch) return Number(tagMatch[1]);
+  const ariaLevel = attrs.attributes["aria-level"];
+  if (ariaLevel && /^\d+$/.test(ariaLevel)) return Number(ariaLevel);
+  return null;
 }
-function matchBrace(s, start) {
-  let depth = 0;
-  for (let i = start; i < s.length; i++) {
-    if (s[i] === "{") depth++;
-    else if (s[i] === "}" && --depth === 0) return i;
-  }
-  return s.length - 1;
+var attr = (a, key) => a.attributes[key] || null;
+var esc = (s) => s.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
+var escCssAttrValue = (s) => s.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+var isCssSafeId = (id) => /^[A-Za-z][A-Za-z0-9_-]*$/.test(id);
+function classifyCssStability(className) {
+  if (/[a-f0-9]{8,}/i.test(className)) return 10;
+  if (/^(?:css|sc|emotion|styled)-/i.test(className)) return 15;
+  if (/^(bg|text|border|shadow|opacity|font|w-|h-|m[tblrxy]?-|p[tblrxy]?-|flex|grid|gap|rounded|absolute|relative|fixed|sticky|block|inline|hidden|overflow|z-|top-|right-|bottom-|left-|inset-|justify-|items-|self-|content-|order-|col-|row-)/.test(
+    className
+  ))
+    return 25;
+  if (/__/.test(className) || /--/.test(className)) return 35;
+  if (/^[a-z]+(-[a-z]+)+$/.test(className)) return 40;
+  if (/^[a-z]+[A-Z][a-zA-Z]+$/.test(className)) return 40;
+  if (className.includes("_")) return 15;
+  if (/^[a-z]+-[a-z0-9]{5,}$/.test(className) && /[0-9]/.test(className)) return 15;
+  return 15;
 }
-function parseOptions(src) {
-  const obj = {};
-  const re = /(\w+)\s*:\s*('(?:\\.|[^'])*'|"(?:\\.|[^"])*"|true|false|-?\d+)/g;
-  let m;
-  while ((m = re.exec(src)) !== null) {
-    const key = m[1];
-    const raw = m[2];
-    if (raw === "true") obj[key] = true;
-    else if (raw === "false") obj[key] = false;
-    else if (/^-?\d+$/.test(raw)) obj[key] = Number(raw);
-    else obj[key] = raw.slice(1, -1).replace(/\\(.)/g, "$1");
+function isAutoGenerated(value) {
+  if (/^[a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12}$/i.test(value)) return true;
+  if (/^[a-f0-9]{8,}$/i.test(value)) return true;
+  if (/^[a-z]+-\d{4,}$/.test(value)) return true;
+  if (/^(tab|panel|input|select|option|dialog|modal|popup|tooltip|menu|listbox|combobox|checkbox|radio|textarea|button|field|label|accordion|collapse|step|slider|toggle|switch|dropdown|overlay|portal|layer)-\d+$/i.test(
+    value
+  )) {
+    return true;
   }
-  return obj;
+  if (/^(emotion-|styled-|css-|sc-)/.test(value)) return true;
+  if (value.startsWith("ng-")) return true;
+  if (/^(radix-|headlessui-|mui-|mantine-|chakra-)/i.test(value)) return true;
+  if (/^:r[0-9a-z]+:$/i.test(value) || /^«r[0-9a-z]+»$/i.test(value)) return true;
+  return false;
 }
-function parseArgs(inner) {
-  const args = [];
-  let i = 0;
-  while (i < inner.length) {
-    const c = inner[i];
-    if (c === " " || c === ",") {
-      i++;
-      continue;
-    }
-    if (c === "'" || c === '"') {
-      const end = endOfString(inner, i);
-      args.push(inner.slice(i + 1, end).replace(/\\(.)/g, "$1"));
-      i = end + 1;
-      continue;
+var TEST_DATA_ATTRS = /* @__PURE__ */ new Set(["data-test", "data-test-id", "data-qa", "data-qa-id", "data-cy", "data-e2e"]);
+function generateAlternatives(attrs) {
+  const alts = [];
+  const seen = /* @__PURE__ */ new Set();
+  const add = (loc) => {
+    if (!seen.has(loc.locator)) {
+      seen.add(loc.locator);
+      alts.push(loc);
     }
-    if (c === "{") {
-      const end = matchBrace(inner, i);
-      args.push(parseOptions(inner.slice(i, end + 1)));
-      i = end + 1;
-      continue;
+  };
+  const { accessibleName } = attrs;
+  const tag = attrs.tagName;
+  const role = resolveAriaRole(attrs);
+  const counts = attrs.selectorCounts;
+  const isUnique = (n) => n == null || n <= 1;
+  const ambiguityPenalty = (n) => n != null && n > 1 ? 45 : 0;
+  const text = attrs.textContent ? attrs.textContent.replace(/\s+/g, " ").trim() : null;
+  const testId = attr(attrs, "data-testid");
+  if (testId && isUnique(counts?.testId)) {
+    add({
+      locator: `getByTestId('${esc(testId)}')`,
+      method: "getByTestId",
+      args: { testId },
+      score: 100
+    });
+  }
+  const level = headingLevel(attrs, role);
+  const levelPart = level != null ? `, level: ${level}` : "";
+  const withLevel = (base) => level != null ? { ...base, level } : base;
+  if (role && accessibleName) {
+    add({
+      locator: `getByRole('${role}', { name: '${esc(accessibleName)}'${levelPart} })`,
+      method: "getByRole",
+      args: withLevel({ role, name: accessibleName }),
+      score: 90 - ambiguityPenalty(counts?.roleName)
+    });
+  }
+  const ariaLabel = attr(attrs, "aria-label");
+  if (role && ariaLabel && ariaLabel !== accessibleName) {
+    add({
+      locator: `getByRole('${role}', { name: '${esc(ariaLabel)}'${levelPart} })`,
+      method: "getByRole",
+      args: withLevel({ role, name: ariaLabel }),
+      score: 85 - ambiguityPenalty(counts?.roleName)
+    });
+  }
+  if (accessibleName && ["input", "select", "textarea"].includes(tag)) {
+    const label = attr(attrs, "aria-label");
+    const labelBacked = attrs.hasLabel === void 0 ? true : attrs.hasLabel === true || label === accessibleName;
+    if (labelBacked) {
+      add({
+        locator: `getByLabel('${esc(accessibleName)}')`,
+        method: "getByLabel",
+        args: { label: accessibleName },
+        score: 85
+      });
     }
-    i++;
   }
-  return args;
-}
-function leafExpression(expr) {
-  let depth = 0;
-  let leafStart = 0;
-  for (let i = 0; i < expr.length - 1; i++) {
-    const c = expr[i];
-    if (c === "'" || c === '"') {
-      i = endOfString(expr, i);
-      continue;
+  const placeholder = attr(attrs, "placeholder");
+  if (placeholder) {
+    add({
+      locator: `getByPlaceholder('${esc(placeholder)}')`,
+      method: "getByPlaceholder",
+      args: { placeholder },
+      score: 80 - ambiguityPenalty(counts?.placeholder)
+    });
+  }
+  if (text && text.length < 80) {
+    add({
+      locator: `getByText('${esc(text)}')`,
+      method: "getByText",
+      args: { text },
+      score: 75 - ambiguityPenalty(counts?.text)
+    });
+  }
+  const id = attr(attrs, "id");
+  if (id && !isAutoGenerated(id) && isUnique(counts?.id)) {
+    const selector = isCssSafeId(id) ? `#${id}` : `[id="${escCssAttrValue(id)}"]`;
+    add({
+      locator: `locator('${esc(selector)}')`,
+      method: "locator",
+      args: { selector },
+      score: 65
+    });
+  }
+  const name = attr(attrs, "name");
+  if (name && isUnique(counts?.name)) {
+    const selector = `[name="${escCssAttrValue(name)}"]`;
+    add({
+      locator: `locator('${esc(selector)}')`,
+      method: "locator",
+      args: { selector },
+      score: 60
+    });
+  }
+  const alt = attr(attrs, "alt");
+  if (alt) {
+    add({
+      locator: `getByAltText('${esc(alt)}')`,
+      method: "getByAltText",
+      args: { text: alt },
+      score: 60 - ambiguityPenalty(counts?.alt)
+    });
+  }
+  const title = attr(attrs, "title");
+  if (title) {
+    add({
+      locator: `getByTitle('${esc(title)}')`,
+      method: "getByTitle",
+      args: { title },
+      score: 50 - ambiguityPenalty(counts?.title)
+    });
+  }
+  const hasOwnTestId = !!(testId && isUnique(counts?.testId));
+  const addAnchoredChains = (leaf, scopedCount, scores) => {
+    let testIdAnchorDone = false;
+    let idAnchorDone = false;
+    let roleAnchorDone = false;
+    let dataAnchorDone = false;
+    let filterAnchorDone = false;
+    for (const anc of attrs.ancestors ?? []) {
+      if (scopedCount(anc) !== 1) continue;
+      if (!testIdAnchorDone && anc.testId && anc.testIdCount === 1) {
+        testIdAnchorDone = true;
+        add({
+          locator: `getByTestId('${esc(anc.testId)}').${leaf.expr}`,
+          method: leaf.method,
+          args: { ...leaf.args, anchorTestId: anc.testId },
+          score: scores.testId
+        });
+      }
+      if (!idAnchorDone && anc.id && !isAutoGenerated(anc.id) && anc.idCount === 1) {
+        idAnchorDone = true;
+        const anchorSelector = isCssSafeId(anc.id) ? `#${anc.id}` : `[id="${escCssAttrValue(anc.id)}"]`;
+        add({
+          locator: `locator('${esc(anchorSelector)}').${leaf.expr}`,
+          method: leaf.method,
+          args: { ...leaf.args, anchorSelector },
+          score: scores.id
+        });
+      }
+      if (!dataAnchorDone && anc.dataAttr && anc.dataAttrCount === 1) {
+        dataAnchorDone = true;
+        const { name: name2, value } = anc.dataAttr;
+        const anchorSelector = `[${name2}="${escCssAttrValue(value)}"]`;
+        add({
+          locator: `locator('${esc(anchorSelector)}').${leaf.expr}`,
+          method: leaf.method,
+          args: { ...leaf.args, anchorSelector },
+          score: TEST_DATA_ATTRS.has(name2) ? scores.testData : scores.data
+        });
+      }
+      const ancestorRole = anc.role || TAG_TO_ROLE[anc.tag] || null;
+      if (!roleAnchorDone && ancestorRole && ancestorRole !== leaf.role && anc.roleCount === 1) {
+        roleAnchorDone = true;
+        add({
+          locator: `getByRole('${esc(ancestorRole)}').${leaf.expr}`,
+          method: leaf.method,
+          args: { ...leaf.args, anchorRole: ancestorRole },
+          score: scores.role
+        });
+      }
+      if (!filterAnchorDone && ancestorRole && anc.filterText && anc.filterRoleCount === 1) {
+        filterAnchorDone = true;
+        add({
+          locator: `getByRole('${esc(ancestorRole)}').filter({ hasText: '${esc(anc.filterText)}' }).${leaf.expr}`,
+          method: leaf.method,
+          args: { ...leaf.args, anchorRole: ancestorRole, anchorHasText: anc.filterText },
+          score: scores.filter
+        });
+      }
     }
-    if (c === "(") depth++;
-    else if (c === ")") {
-      depth--;
-      if (depth === 0 && expr[i + 1] === ".") leafStart = i + 2;
+  };
+  if (role && !hasOwnTestId) {
+    const rolePart = level != null ? `'${role}', { level: ${level} }` : `'${role}'`;
+    const leafArgs = withLevel({ role });
+    addAnchoredChains(
+      { expr: `getByRole(${rolePart})`, method: "getByRole", args: leafArgs, role },
+      (anc) => anc.scopedRoleCount,
+      { testId: 72, testData: 70, id: 64, data: 60, role: 55, filter: 53 }
+    );
+    const pos = attrs.rolePosition;
+    if (pos && pos.role === role && (pos.count === 1 || level != null && pos.levelCount === 1)) {
+      add({
+        locator: `getByRole(${rolePart})`,
+        method: "getByRole",
+        args: leafArgs,
+        score: 58
+      });
     }
+  } else if (!role && text && text.length < 80 && !hasOwnTestId) {
+    addAnchoredChains(
+      { expr: `getByText('${esc(text)}')`, method: "getByText", args: { text }, role: null },
+      (anc) => anc.scopedTextCount,
+      { testId: 68, testData: 66, id: 60, data: 56, role: 51, filter: 49 }
+    );
   }
-  return expr.slice(leafStart);
-}
-function parseLeafLocatorExpression(rawExpr) {
-  const expr = leafExpression(rawExpr.trim());
-  const m = /^([A-Za-z]+)\((.*)\)$/s.exec(expr);
-  if (!m) return null;
-  return { method: m[1], args: parseArgs(m[2].trim()) };
-}
-function deriveFailedLocator(testInfo) {
-  const info = testInfo;
-  const errors = info.errors && info.errors.length > 0 ? info.errors : info.error ? [info.error] : [];
-  for (const err of errors) {
-    const text = `${err.message ?? ""}
-${err.stack ?? ""}`.replace(ANSI_RE, "");
-    const line = /^\s*Locator:\s*(.+)$/m.exec(text);
-    if (!line) continue;
-    const parsed = parseLeafLocatorExpression(line[1].trim());
-    if (!parsed) continue;
-    const loc = err.location;
-    const location = loc ? `${path2.relative(process.cwd(), loc.file).split(path2.sep).join("/")}:${loc.line}:${loc.column}` : null;
-    return { method: parsed.method, args: parsed.args, location };
+  const clsStr = attr(attrs, "class");
+  if (clsStr) {
+    const countsClasses = counts?.classes;
+    const classes = clsStr.split(/\s+/).filter((c) => c.length > 1 && /^[A-Za-z_-][A-Za-z0-9_-]*$/.test(c) && isUnique(countsClasses?.[c])).map((cls) => ({ cls, score: classifyCssStability(cls) })).sort((a, b) => b.score - a.score).slice(0, 3);
+    for (const { cls, score } of classes) {
+      add({
+        locator: `locator('.${esc(cls)}')`,
+        method: "locator",
+        args: { selector: `.${cls}` },
+        score
+      });
+    }
   }
+  return alts.sort((a, b) => b.score - a.score);
+}
+function approximateAccessibleName(attrs) {
+  const a = attrs.attributes;
+  const ariaLabel = a["aria-label"];
+  if (ariaLabel) return ariaLabel;
+  if (attrs.textContent) return attrs.textContent;
+  const title = a["title"];
+  if (title) return title;
+  const placeholder = a["placeholder"];
+  if (placeholder) return placeholder;
   return null;
 }
+
+// ../picker-dom/src/anchor-alternatives.ts
 var escStr = (s) => s.replaceAll("\\", "\\\\").replaceAll("'", "\\'");
 var cssIdSelector = (id) => /^[A-Za-z_][A-Za-z0-9_-]*$/.test(id) ? `#${id}` : `[id="${id.replaceAll("\\", "\\\\").replaceAll('"', '\\"')}"]`;
 var ANCHOR_KIND_SCORES = { testid: 80, id: 74, labeledRole: 68, role: 62 };
@@ -867,511 +1376,455 @@ function mergeCandidates(base, extra) {
   }
   return merged.sort((a, b) => b.score - a.score);
 }
-function installPickerOverlay(arg) {
-  const g = globalThis;
-  const doc = g.document;
-  if (!doc || !doc.body) {
-    g.__piwiPickState = "skipped";
-    return;
+
+// src/internal/capture/locator-healing.ts
+var path = __toESM(require("path"));
+
+// ../core/src/locator-fingerprint.ts
+var PRESENT_SIMILARITY = 0.8;
+var MATCH_SIMILARITY = 0.2;
+function parseAriaCandidates(ariaSnapshot) {
+  if (!ariaSnapshot) return [];
+  const out = [];
+  for (const line of ariaSnapshot.split("\n")) {
+    const m = line.match(/^\s*-\s+([a-z]+)(?:\s+"((?:[^"\\]|\\.)*)")?/i);
+    if (!m) continue;
+    const role = m[1];
+    const name = m[2] != null ? m[2].replace(/\\(.)/g, "$1") : null;
+    if (!name && (role === "generic" || role === "group" || role === "list" || role === "paragraph")) continue;
+    const levelMatch = line.slice(m[0].length).match(/\[level=(\d+)\]/);
+    const level = levelMatch ? Number(levelMatch[1]) : null;
+    out.push({ role, name, level });
   }
-  const Z = 2147483600;
-  const highlight = doc.createElement("div");
-  highlight.style.cssText = `position:fixed;pointer-events:none;z-index:${Z};display:none;box-sizing:border-box;border:2px solid #7c3aed;background:rgba(124,58,237,.12);border-radius:3px;`;
-  const banner = doc.createElement("div");
-  banner.style.cssText = `position:fixed;top:12px;left:50%;transform:translateX(-50%);z-index:${Z + 2};background:#111827;color:#f9fafb;font:13px/1.5 system-ui,sans-serif;padding:10px 16px;border-radius:8px;box-shadow:0 4px 24px rgba(0,0,0,.4);max-width:80vw;`;
-  const hlLocator = (expr) => {
-    const escHtml = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
-    const re = /('(?:\\.|[^'])*'|"(?:\\.|[^"])*")|([A-Za-z_$][\w$]*)(?=\s*\()|([A-Za-z_$][\w$]*)(?=\s*:)|(true|false|null|\d+)|([{}(),.])/g;
-    let html = "";
-    let last = 0;
-    let m;
-    while ((m = re.exec(expr)) !== null) {
-      if (m.index > last) html += escHtml(expr.slice(last, m.index));
-      const color = m[1] ? "#4ade80" : m[2] ? "#c084fc" : m[3] ? "#93c5fd" : m[4] ? "#fbbf24" : "#9ca3af";
-      html += `<span style="color:${color}">${escHtml(m[0])}</span>`;
-      last = re.lastIndex;
-    }
-    if (last < expr.length) html += escHtml(expr.slice(last));
-    return `<code style="font-family:ui-monospace,SFMono-Regular,Menlo,monospace">${html}</code>`;
-  };
-  const head = doc.createElement("div");
-  head.innerHTML = arg.failing ? `Piwi locator picker \u2014 click the element that should replace ${hlLocator(arg.failing)}` : "Piwi inspector \u2014 click any element to generate locators for it";
-  const foot = doc.createElement("div");
-  foot.style.cssText = "color:#9ca3af;margin-top:3px;";
-  foot.textContent = "\u2191 parent \xB7 \u2193 child \xB7 Esc skip";
-  banner.appendChild(head);
-  banner.appendChild(foot);
-  doc.body.appendChild(highlight);
-  doc.body.appendChild(banner);
-  const escJs = (s) => s.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
-  const describe = (el) => {
-    const tag = (el.tagName || "?").toLowerCase();
-    const testId = el.getAttribute && el.getAttribute("data-testid");
-    if (testId) return `getByTestId('${escJs(testId)}')`;
-    if (el.labels && el.labels.length > 0) {
-      const labelText = (el.labels[0].textContent || "").replace(/\s+/g, " ").trim().slice(0, 80);
-      if (labelText) return `getByLabel('${escJs(labelText)}')`;
-    }
-    const ariaLabel = el.getAttribute && el.getAttribute("aria-label");
-    if (ariaLabel) return `getByLabel('${escJs(ariaLabel)}')`;
-    const placeholder = el.getAttribute && el.getAttribute("placeholder");
-    if (placeholder) return `getByPlaceholder('${escJs(placeholder)}')`;
-    const alt = el.getAttribute && el.getAttribute("alt");
-    if (alt) return `getByAltText('${escJs(alt)}')`;
-    const titleAttr = el.getAttribute && el.getAttribute("title");
-    if (titleAttr) return `getByTitle('${escJs(titleAttr)}')`;
-    if (el.id) return `locator('#${escJs(el.id)}')`;
-    const cls = (el.getAttribute && el.getAttribute("class") || "").split(/\s+/).find((c) => c.length > 1);
-    return cls ? `locator('.${escJs(cls)}')` : tag;
-  };
-  const buildChain = (raw) => {
-    const chain2 = [];
-    let node = raw;
-    while (node && chain2.length < 15) {
-      const tag = (node.tagName || "").toLowerCase();
-      if (tag === "body" || tag === "html") break;
-      chain2.push(node);
-      node = node.parentElement;
-    }
-    return chain2.length ? chain2 : [raw];
-  };
-  const ACTIONABLE_TAGS = ["button", "a", "input", "select", "textarea", "summary", "option"];
-  const snapIndex = (chain2) => {
-    for (let i = 0; i < Math.min(chain2.length, 4); i++) {
-      const el = chain2[i];
-      const tag = (el.tagName || "").toLowerCase();
-      if (ACTIONABLE_TAGS.includes(tag)) return i;
-      if (el.getAttribute && (el.getAttribute("role") || el.getAttribute("data-testid"))) return i;
-    }
-    return 0;
-  };
-  let chain = [];
-  let idx = 0;
-  let lastRaw = null;
-  const current = () => chain[idx] ?? null;
-  const refresh = () => {
-    const el = current();
-    if (!el) {
-      highlight.style.display = "none";
-      return;
-    }
-    const r = el.getBoundingClientRect();
-    highlight.style.display = "block";
-    highlight.style.left = r.left + "px";
-    highlight.style.top = r.top + "px";
-    highlight.style.width = r.width + "px";
-    highlight.style.height = r.height + "px";
-    foot.textContent = `${describe(el)} \u2014 click to pick \xB7 \u2191 parent \xB7 \u2193 child \xB7 Esc skip`;
-  };
-  const stop = (e) => {
-    e.preventDefault();
-    e.stopImmediatePropagation();
-  };
-  const isOwn = (el) => el === banner || el === highlight || banner.contains && banner.contains(el);
-  let bannerDocked = "top";
-  const dockBanner = (side) => {
-    if (bannerDocked === side) return;
-    bannerDocked = side;
-    if (side === "bottom") {
-      banner.style.top = "auto";
-      banner.style.bottom = "12px";
-    } else {
-      banner.style.top = "12px";
-      banner.style.bottom = "auto";
-    }
-  };
-  const onMove = (e) => {
-    const raw = e.target;
-    if (!raw || isOwn(raw)) {
-      highlight.style.display = "none";
-      return;
-    }
-    if (raw !== lastRaw) {
-      lastRaw = raw;
-      chain = buildChain(raw);
-      idx = snapIndex(chain);
-    }
-    refresh();
-    const el = current();
-    if (el) {
-      const r = el.getBoundingClientRect();
-      const br = banner.getBoundingClientRect();
-      const margin = 8;
-      if (r.left < br.right + margin && r.right > br.left - margin && r.top < br.bottom + margin && r.bottom > br.top - margin) {
-        dockBanner(bannerDocked === "top" ? "bottom" : "top");
-      }
-    }
-  };
-  const onClick = (e) => {
-    stop(e);
-    const el = current();
-    if (!el || isOwn(e.target)) return;
-    g.__piwiPickedElement = el;
-    g.__piwiPickState = "picked";
-    removeListeners();
-    highlight.style.display = "none";
-    foot.textContent = "Analyzing element\u2026";
-  };
-  const onKey = (e) => {
-    if (e.key === "Escape") {
-      stop(e);
-      g.__piwiPickState = "skipped";
-      cleanup();
-      return;
-    }
-    if (e.key === "ArrowUp" || e.key === "ArrowDown") {
-      stop(e);
-      if (e.key === "ArrowUp") idx = Math.min(idx + 1, chain.length - 1);
-      else idx = Math.max(idx - 1, 0);
-      refresh();
+  return out;
+}
+function textSimilarity(a, b) {
+  const tok = (s) => new Set(
+    (s ?? "").toLowerCase().split(/[^a-z0-9]+/i).filter(Boolean)
+  );
+  const sa = tok(a);
+  const sb = tok(b);
+  if (sa.size === 0 && sb.size === 0) return 1;
+  if (sa.size === 0 || sb.size === 0) return 0;
+  let common = 0;
+  for (const t of sa) if (sb.has(t)) common++;
+  return 2 * common / (sa.size + sb.size);
+}
+function fingerprintPresent(fp, candidates) {
+  if (!fp.name) return false;
+  return candidates.some(
+    (c) => (!fp.role || c.role === fp.role) && textSimilarity(c.name, fp.name) >= PRESENT_SIMILARITY
+  );
+}
+function matchRenamedElement(fp, candidates) {
+  if (candidates.length === 0) return null;
+  const sameRole = fp.role ? candidates.filter((c) => c.role === fp.role) : candidates;
+  if (sameRole.length === 0) return null;
+  let pool = sameRole;
+  if (fp.level != null) {
+    const sameLevel = sameRole.filter((c) => c.level === fp.level);
+    if (sameLevel.length > 0) pool = sameLevel;
+  }
+  if (pool.length === 1) {
+    return { candidate: pool[0], confidence: 0.7 };
+  }
+  let best = null;
+  let bestScore = -1;
+  for (const c of pool) {
+    const s = textSimilarity(c.name, fp.name);
+    if (s > bestScore) {
+      bestScore = s;
+      best = c;
     }
-  };
-  const suppressed = ["mousedown", "mouseup", "pointerdown", "pointerup", "auxclick", "dblclick"];
-  const removeListeners = () => {
-    doc.removeEventListener("mousemove", onMove, true);
-    doc.removeEventListener("click", onClick, true);
-    doc.removeEventListener("keydown", onKey, true);
-    for (const t of suppressed) doc.removeEventListener(t, stop, true);
-  };
-  const cleanup = () => {
-    removeListeners();
-    highlight.remove();
-    banner.remove();
-  };
-  g.__piwiPickCleanup = cleanup;
-  doc.addEventListener("mousemove", onMove, true);
-  doc.addEventListener("click", onClick, true);
-  doc.addEventListener("keydown", onKey, true);
-  for (const t of suppressed) doc.addEventListener(t, stop, true);
+  }
+  if (best && bestScore >= MATCH_SIMILARITY) return { candidate: best, confidence: bestScore };
+  const pos = fp.rolePosition;
+  if (pos && fp.role && pos.role === fp.role && sameRole.length >= 2 && sameRole.length === pos.count) {
+    const byIndex = sameRole[pos.index];
+    if (byIndex) return { candidate: byIndex, confidence: 0.5 };
+  }
+  return null;
+}
+
+// ../core/src/locator-methods.ts
+var LOCATOR_BUILDER_METHODS = [
+  "getByRole",
+  "getByTestId",
+  "getByText",
+  "getByLabel",
+  "getByPlaceholder",
+  "getByAltText",
+  "getByTitle",
+  "locator"
+];
+
+// src/internal/capture/locator-healing.ts
+function dedupeSnapshotsByLocation(snaps) {
+  const lastWithElement = /* @__PURE__ */ new Map();
+  const lastAny = /* @__PURE__ */ new Map();
+  snaps.forEach((s, i) => {
+    if (!s.location) return;
+    lastAny.set(s.location, i);
+    if (s.element) lastWithElement.set(s.location, i);
+  });
+  return snaps.filter((s, i) => {
+    if (!s.location) return true;
+    return (lastWithElement.get(s.location) ?? lastAny.get(s.location)) === i;
+  });
 }
-function showAnchorPicker(arg) {
-  const g = globalThis;
-  const doc = g.document;
-  const el = g.__piwiPickedElement;
-  if (!doc || !doc.body || !el) {
-    g.__piwiAnchorState = "skipped";
-    return;
+var LOCATOR_METHODS = [...LOCATOR_BUILDER_METHODS];
+var CHAIN_METHODS = [
+  "first",
+  "nth",
+  "last",
+  "filter",
+  "and",
+  "or",
+  "locator",
+  "getByRole",
+  "getByTestId",
+  "getByText",
+  "getByLabel",
+  "getByPlaceholder",
+  "getByAltText",
+  "getByTitle"
+];
+var ACTION_METHODS = [
+  "click",
+  "fill",
+  "check",
+  "uncheck",
+  "selectOption",
+  "dblclick",
+  "tap",
+  "hover",
+  "press",
+  "type",
+  "pressSequentially",
+  "clear",
+  "setInputFiles",
+  "dragTo",
+  "focus",
+  "blur",
+  "scrollIntoViewIfNeeded",
+  "dispatchEvent",
+  "selectText",
+  // Not an action, but a successful waitFor proves the element resolved — the
+  // closest capture hook available for assertion-style usage of a locator.
+  "waitFor"
+];
+var LOCATOR_CREATING_CHAINS = new Set(LOCATOR_METHODS);
+var EXPECT_METHOD = "_expect";
+var EXPECT_CAPTURE_EXPRESSIONS = /* @__PURE__ */ new Set([
+  "to.be.attached",
+  "to.be.checked",
+  "to.be.disabled",
+  "to.be.editable",
+  "to.be.empty",
+  "to.be.enabled",
+  "to.be.focused",
+  "to.be.in.viewport",
+  "to.be.readonly",
+  "to.be.visible",
+  "to.contain.class",
+  "to.contain.text",
+  "to.have.accessible.description",
+  "to.have.accessible.error.message",
+  "to.have.accessible.name",
+  "to.have.attribute",
+  "to.have.attribute.value",
+  "to.have.class",
+  "to.have.css",
+  "to.have.id",
+  "to.have.js.property",
+  "to.have.role",
+  "to.have.text",
+  "to.have.value",
+  "to.match.aria"
+]);
+function extractAccessibleName(ariaSnapshot) {
+  if (!ariaSnapshot) return null;
+  const match = ariaSnapshot.match(/- \w+ "([^"]+)"/);
+  if (match) return match[1];
+  return null;
+}
+var NAME_BASED_METHODS = /* @__PURE__ */ new Set([
+  "getByText",
+  "getByRole",
+  "getByLabel",
+  "getByPlaceholder",
+  "getByTitle",
+  "getByAltText"
+]);
+var escAttr = (s) => s.replaceAll("\\", "\\\\").replaceAll("'", "\\'");
+var SUGG_TEXT_ROLES = /* @__PURE__ */ new Set([
+  "button",
+  "link",
+  "heading",
+  "menuitem",
+  "tab",
+  "option",
+  "cell",
+  "columnheader",
+  "rowheader",
+  "gridcell",
+  "treeitem",
+  "listitem",
+  "checkbox",
+  "radio",
+  "switch"
+]);
+var SUGG_FIELD_ROLES = /* @__PURE__ */ new Set(["textbox", "combobox", "searchbox", "spinbutton", "slider"]);
+function failedNameAndRole(failed) {
+  if (failed.method === "getByRole") {
+    const role = typeof failed.args[0] === "string" ? failed.args[0] : null;
+    const opts = failed.args[1];
+    const name = opts && typeof opts.name === "string" ? opts.name : null;
+    const level = opts && typeof opts.level === "number" ? opts.level : null;
+    return { role, name, level };
   }
-  const Z = 2147483600;
-  const { tagRoles, inputRoles, roleSources, leafRole, leafLevel, leafTestId } = arg;
-  const roleOf = (n) => {
-    const explicit = n.getAttribute && n.getAttribute("role");
-    if (explicit) return explicit;
-    const tag = (n.tagName || "").toLowerCase();
-    if (tag === "input") return inputRoles[(n.getAttribute("type") || "text").toLowerCase()] ?? "textbox";
-    if (tag === "select") return n.getAttribute("multiple") != null ? "listbox" : "combobox";
-    if (tag === "a") return n.getAttribute("href") != null ? "link" : null;
-    return tagRoles[tag] ?? null;
-  };
-  const levelOf = (n) => {
-    const m = /^h([1-6])$/.exec((n.tagName || "").toLowerCase());
-    if (m) return Number(m[1]);
-    const al = n.getAttribute && n.getAttribute("aria-level");
-    return al && /^\d+$/.test(al) ? Number(al) : null;
-  };
-  const leafMatches = (scope) => {
-    try {
-      if (leafTestId) return scope.querySelectorAll(`[data-testid=${JSON.stringify(leafTestId)}]`).length;
-      const nodes = scope.querySelectorAll(roleSources);
-      if (nodes.length > 2e3) return -1;
-      let matched = 0;
-      for (let i = 0; i < nodes.length; i++) {
-        const n = nodes[i];
-        if (roleOf(n) !== leafRole) continue;
-        if (leafLevel != null && levelOf(n) !== leafLevel) continue;
-        matched++;
-      }
-      return matched;
-    } catch {
-      return -1;
-    }
-  };
-  let roleNodes = [];
-  try {
-    const all = doc.querySelectorAll(roleSources);
-    if (all.length <= 4e3) roleNodes = Array.from(all);
-  } catch {
-    roleNodes = [];
+  const first = failed.args.find((a) => typeof a === "string");
+  return { role: null, name: typeof first === "string" ? first : null, level: null };
+}
+function renderFailing(failed) {
+  const { role, name } = failedNameAndRole(failed);
+  if (failed.method === "getByRole") {
+    return name ? `getByRole('${escAttr(role ?? "")}', { name: '${escAttr(name)}' })` : `getByRole('${escAttr(role ?? "")}')`;
   }
-  const count = (sel) => {
-    try {
-      return doc.querySelectorAll(sel).length;
-    } catch {
-      return void 0;
-    }
+  return `${failed.method}('${escAttr(name ?? "")}')`;
+}
+function freshSuggestions(candidate, failedMethod) {
+  const out = [];
+  const role = candidate.role;
+  const name = candidate.name;
+  const push = (s) => {
+    if (!out.includes(s)) out.push(s);
   };
-  const rows = [];
-  let node = el.parentElement;
-  let depth = 0;
-  while (node && depth < 12) {
-    depth++;
-    const tag = (node.tagName || "").toLowerCase();
-    if (tag === "body" || tag === "html") break;
-    const testId = node.getAttribute("data-testid");
-    const id = node.getAttribute("id");
-    const ariaLabel = node.getAttribute("aria-label");
-    const role = roleOf(node);
-    const info = { tag, depth, testId: testId || null, id: id || null, ariaLabel: ariaLabel || null, role };
-    if (testId) info.testIdCount = count(`[data-testid=${JSON.stringify(testId)}]`);
-    if (id) {
-      try {
-        info.idCount = count(`#${doc.defaultView.CSS.escape(id)}`);
-      } catch {
-      }
+  const levelPart = candidate.level != null ? `, level: ${candidate.level}` : "";
+  const roleLoc = `getByRole('${escAttr(role)}', { name: '${escAttr(name)}'${levelPart} })`;
+  const textLoc = `getByText('${escAttr(name)}')`;
+  const labelLoc = `getByLabel('${escAttr(name)}')`;
+  if (failedMethod === "getByText" && SUGG_TEXT_ROLES.has(role)) push(textLoc);
+  if (failedMethod === "getByLabel" && SUGG_FIELD_ROLES.has(role)) push(labelLoc);
+  push(roleLoc);
+  if (SUGG_TEXT_ROLES.has(role)) push(textLoc);
+  else if (SUGG_FIELD_ROLES.has(role)) push(labelLoc);
+  return out;
+}
+function suggestLocatorsFromAria(failed, ariaSnapshot) {
+  if (!ariaSnapshot || !NAME_BASED_METHODS.has(failed.method)) return null;
+  const { role, name, level } = failedNameAndRole(failed);
+  if (!name) return null;
+  const candidates = parseAriaCandidates(ariaSnapshot);
+  if (candidates.length === 0) return null;
+  const fingerprint = { role, name, level };
+  if (fingerprintPresent(fingerprint, candidates)) return null;
+  const best = matchRenamedElement(fingerprint, candidates)?.candidate;
+  if (!best || !best.name) return null;
+  const suggestions = freshSuggestions({ role: best.role, name: best.name, level: best.level }, failed.method);
+  if (suggestions.length === 0) return null;
+  return { failing: renderFailing(failed), suggestions };
+}
+function captureCallerLocation(stack = new Error().stack ?? "") {
+  const lines = stack.split("\n");
+  let prevWasCaptureModule = false;
+  let selfFile = null;
+  for (let i = 1; i < lines.length; i++) {
+    const line = lines[i].trim();
+    if (!line.startsWith("at")) continue;
+    const m = line.match(/^at\s+(?:(.+?)\s+\()?(.+?):(\d+):(\d+)\)?$/);
+    if (!m) {
+      prevWasCaptureModule = false;
+      continue;
     }
-    if (role) {
-      let roleCount = 0;
-      let labeledCount = 0;
-      for (const n of roleNodes) {
-        if (roleOf(n) !== role) continue;
-        roleCount++;
-        if (ariaLabel && n.getAttribute && n.getAttribute("aria-label") === ariaLabel) labeledCount++;
-      }
-      info.roleCount = roleCount;
-      if (ariaLabel) info.labeledRoleCount = labeledCount;
+    let file = m[2];
+    if (!file || file.startsWith("node:")) {
+      prevWasCaptureModule = false;
+      continue;
+    }
+    file = file.replace(/^file:\/\/\/?/, "");
+    if (!/\.[a-z]+$/i.test(file)) {
+      prevWasCaptureModule = false;
+      continue;
     }
-    info.scopedLeafCount = leafMatches(node);
-    const hookLabel = testId ? `data-testid="${testId}"` : id ? `#${id}` : ariaLabel && role ? `${role} "${ariaLabel}"` : role ? `role ${role}` : "no stable hook";
-    rows.push({
-      node,
-      info,
-      hookLabel,
-      selectable: !!(testId || id || role && (ariaLabel || info.roleCount === 1))
-    });
-    node = node.parentElement;
-  }
-  if (rows.length === 0) {
-    g.__piwiAnchorState = "skipped";
-    return;
-  }
-  const outline = doc.createElement("div");
-  outline.style.cssText = `position:fixed;pointer-events:none;z-index:${Z};box-sizing:border-box;border:2px solid #22c55e;border-radius:3px;display:none;`;
-  const pickedOutline = doc.createElement("div");
-  const pr = el.getBoundingClientRect();
-  pickedOutline.style.cssText = `position:fixed;pointer-events:none;z-index:${Z};box-sizing:border-box;border:2px solid #7c3aed;background:rgba(124,58,237,.10);border-radius:3px;left:${pr.left}px;top:${pr.top}px;width:${pr.width}px;height:${pr.height}px;`;
-  const panel = doc.createElement("div");
-  panel.style.cssText = `position:fixed;top:12px;right:12px;z-index:${Z + 3};width:340px;max-height:82vh;overflow:auto;background:#111827;color:#f9fafb;border-radius:10px;padding:16px;font:12px/1.5 system-ui,sans-serif;box-shadow:0 8px 40px rgba(0,0,0,.5);`;
-  const title = doc.createElement("div");
-  title.style.cssText = "font-weight:600;font-size:13px;margin-bottom:2px;";
-  title.textContent = "Scope to stable parents (optional)";
-  const sub = doc.createElement("div");
-  sub.style.cssText = "color:#9ca3af;margin-bottom:10px;";
-  sub.textContent = "Pick one or more parents to anchor the locator to. Hover a row to see the parent.";
-  panel.appendChild(title);
-  panel.appendChild(sub);
-  const selected = /* @__PURE__ */ new Set();
-  const footer = doc.createElement("div");
-  footer.style.cssText = "margin:10px 0;font-weight:600;";
-  const segMatches = (scope, info) => {
-    try {
-      if (info.testId) return Array.from(scope.querySelectorAll(`[data-testid=${JSON.stringify(info.testId)}]`));
-      if (info.id) return Array.from(scope.querySelectorAll(`#${doc.defaultView.CSS.escape(info.id)}`));
-      const nodes = Array.from(scope.querySelectorAll(roleSources));
-      if (nodes.length > 2e3) return [];
-      return nodes.filter(
-        (n) => roleOf(n) === info.role && (!info.ariaLabel || n.getAttribute && n.getAttribute("aria-label") === info.ariaLabel)
-      );
-    } catch {
-      return [];
+    if (selfFile === null || file === selfFile) {
+      selfFile ??= file;
+      prevWasCaptureModule = /[\\/]locator-healing\.[a-z]+$/i.test(file);
+      continue;
     }
-  };
-  const chainCount = () => {
-    const chosen = rows.filter((_, i) => selected.has(i)).sort((a, b) => b.info.depth - a.info.depth);
-    if (chosen.length === 0) return -1;
-    let scopes = [doc];
-    for (const row of chosen) {
-      const next = [];
-      for (const s of scopes) next.push(...segMatches(s, row.info));
-      scopes = next.slice(0, 200);
-      if (scopes.length === 0) return 0;
+    if (/[\\/]locator-healing\.[a-z]+$/i.test(file)) {
+      prevWasCaptureModule = true;
+      continue;
     }
-    let total = 0;
-    for (const s of scopes) {
-      const c = leafMatches(s);
-      if (c > 0) total += c;
-      if (total > 50) return total;
+    if (prevWasCaptureModule && /[\\/](?:capture-)?fixtures\.[a-z]+$/i.test(file)) {
+      prevWasCaptureModule = false;
+      continue;
     }
-    return total;
-  };
-  const refreshFooter = () => {
-    if (selected.size === 0) {
-      footer.textContent = "No parents selected \u2014 standard alternatives only.";
-      footer.style.color = "#9ca3af";
-      g.__piwiPickChainCount = void 0;
-      return;
+    if (/[\\/]node_modules[\\/]/.test(file)) {
+      prevWasCaptureModule = false;
+      continue;
     }
-    const c = chainCount();
-    g.__piwiPickChainCount = c;
-    if (c === 1) {
-      footer.textContent = "\u2713 Selection matches exactly 1 element";
-      footer.style.color = "#4ade80";
-    } else {
-      footer.textContent = c < 0 ? "Match count unavailable" : `\u2717 Selection matches ${c} elements`;
-      footer.style.color = "#fbbf24";
+    let rel = file;
+    try {
+      rel = path.relative(process.cwd(), file);
+    } catch {
     }
+    rel = rel.split(path.sep).join("/");
+    if (rel.startsWith("./")) rel = rel.slice(2);
+    return `${rel}:${m[3]}:${m[4]}`;
+  }
+  return null;
+}
+
+// src/internal/capture/attachments.ts
+var ATTACHMENT_NAMES = {
+  locators: "piwi-locators",
+  ariaSnapshot: "piwi-aria-snapshot",
+  console: "piwi-console",
+  network: "piwi-network",
+  webVitals: "piwi-web-vitals",
+  locatorSuggestion: "piwi-locator-suggestion",
+  pageState: "piwi-page-state",
+  userPick: "piwi-user-pick"
+};
+var INTERNAL_ATTACHMENT_NAMES = new Set(Object.values(ATTACHMENT_NAMES));
+var LOCATOR_SUGGESTION_ANNOTATION = ATTACHMENT_NAMES.locatorSuggestion;
+var USER_PICK_ANNOTATION = ATTACHMENT_NAMES.userPick;
+
+// src/internal/capture/inspect-on-failure.ts
+function isCi(ci) {
+  return ci !== void 0 && ci !== "" && ci !== "false";
+}
+function shouldInspectOnFailure(gate) {
+  if (gate.enabled !== "true") return false;
+  if (isCi(gate.ci)) return false;
+  if (gate.headless !== false) return false;
+  if (gate.status !== "failed" && gate.status !== "timedOut") return false;
+  if (gate.status === gate.expectedStatus) return false;
+  return gate.retry >= gate.retries;
+}
+function environmentalSkipReason(gate) {
+  if (gate.enabled !== "true") return null;
+  if (gate.status !== "failed" && gate.status !== "timedOut") return null;
+  if (gate.status === gate.expectedStatus) return null;
+  if (isCi(gate.ci)) return "running under CI \u2014 this is a headed, local-only feature";
+  if (gate.headless !== false) {
+    return "the browser is headless \u2014 re-run with --headed (or set use: { headless: false })";
+  }
+  return null;
+}
+function inspectionGateFromTestInfo(testInfo, enabled = process.env.PIWI_INSPECT_ON_FAIL) {
+  const use = testInfo.project?.use ?? {};
+  return {
+    enabled,
+    ci: process.env.CI,
+    status: testInfo.status,
+    expectedStatus: testInfo.expectedStatus,
+    headless: use.headless,
+    retry: testInfo.retry,
+    retries: testInfo.project?.retries ?? 0
   };
-  rows.forEach((row, i) => {
-    const line = doc.createElement("label");
-    line.style.cssText = `display:flex;align-items:center;gap:8px;padding:6px 8px;border:1px solid #374151;border-radius:6px;margin-bottom:6px;cursor:${row.selectable ? "pointer" : "default"};opacity:${row.selectable ? "1" : ".45"};`;
-    const box = doc.createElement("input");
-    box.type = "checkbox";
-    box.disabled = !row.selectable;
-    const text = doc.createElement("span");
-    text.style.cssText = "flex:1;min-width:0;";
-    const code = doc.createElement("code");
-    code.style.cssText = "display:block;font:11px ui-monospace,monospace;color:#e5e7eb;word-break:break-all;";
-    code.textContent = `<${row.info.tag}> ${row.hookLabel}`;
-    const hint = doc.createElement("span");
-    hint.style.cssText = "color:#9ca3af;";
-    hint.textContent = row.selectable ? row.info.scopedLeafCount === 1 ? "contains exactly 1 matching element" : `contains ${row.info.scopedLeafCount ?? "?"} matching elements` : "add a data-testid to make this usable";
-    text.appendChild(code);
-    text.appendChild(hint);
-    line.appendChild(box);
-    line.appendChild(text);
-    line.addEventListener("mouseenter", () => {
-      const r = row.node.getBoundingClientRect();
-      outline.style.display = "block";
-      outline.style.left = r.left + "px";
-      outline.style.top = r.top + "px";
-      outline.style.width = r.width + "px";
-      outline.style.height = r.height + "px";
-    });
-    line.addEventListener("mouseleave", () => {
-      outline.style.display = "none";
-    });
-    box.addEventListener("change", () => {
-      if (box.checked) selected.add(i);
-      else selected.delete(i);
-      refreshFooter();
-    });
-    panel.appendChild(line);
-  });
-  panel.appendChild(footer);
-  const cleanup = () => {
-    doc.removeEventListener("keydown", onKey, true);
-    panel.remove();
-    outline.remove();
-    pickedOutline.remove();
-  };
-  const done = (state) => {
-    g.__piwiPickAnchors = state === "done" ? rows.filter((_, i) => selected.has(i)).map((r) => r.info) : [];
-    g.__piwiAnchorState = state;
-    cleanup();
-  };
-  const onKey = (e) => {
-    if (e.key !== "Escape") return;
-    e.preventDefault();
-    e.stopImmediatePropagation();
-    done("skipped");
-  };
-  const buttonRow = doc.createElement("div");
-  buttonRow.style.cssText = "display:flex;gap:8px;margin-top:4px;";
-  const useBtn = doc.createElement("button");
-  useBtn.style.cssText = "flex:1;background:#7c3aed;color:#fff;border:none;border-radius:6px;padding:8px;cursor:pointer;font:600 12px system-ui;";
-  useBtn.textContent = "Use selected parents";
-  useBtn.addEventListener("click", (e) => {
-    e.preventDefault();
-    e.stopImmediatePropagation();
-    done(selected.size > 0 ? "done" : "skipped");
-  });
-  const skipBtn = doc.createElement("button");
-  skipBtn.style.cssText = "background:none;border:1px solid #374151;color:#9ca3af;border-radius:6px;padding:8px 10px;cursor:pointer;font:12px system-ui;";
-  skipBtn.textContent = "Skip (Esc)";
-  skipBtn.addEventListener("click", (e) => {
-    e.preventDefault();
-    e.stopImmediatePropagation();
-    done("skipped");
-  });
-  buttonRow.appendChild(useBtn);
-  buttonRow.appendChild(skipBtn);
-  panel.appendChild(buttonRow);
-  refreshFooter();
-  g.__piwiAnchorCleanup = cleanup;
-  doc.addEventListener("keydown", onKey, true);
-  doc.body.appendChild(pickedOutline);
-  doc.body.appendChild(outline);
-  doc.body.appendChild(panel);
 }
-function showPickerChoices(arg) {
-  const g = globalThis;
-  const doc = g.document;
-  if (!doc || !doc.body) {
-    g.__piwiPickChoice = -1;
-    return;
+
+// src/internal/capture/pick-on-failure.ts
+var path2 = __toESM(require("path"));
+var ANSI_RE = /\[[0-9;]*m/g;
+function endOfString(s, start) {
+  const q = s[start];
+  for (let i = start + 1; i < s.length; i++) {
+    if (s[i] === "\\") {
+      i++;
+      continue;
+    }
+    if (s[i] === q) return i;
+  }
+  return s.length - 1;
+}
+function matchBrace(s, start) {
+  let depth = 0;
+  for (let i = start; i < s.length; i++) {
+    if (s[i] === "{") depth++;
+    else if (s[i] === "}" && --depth === 0) return i;
+  }
+  return s.length - 1;
+}
+function parseOptions(src) {
+  const obj = {};
+  const re = /(\w+)\s*:\s*('(?:\\.|[^'])*'|"(?:\\.|[^"])*"|true|false|-?\d+)/g;
+  let m;
+  while ((m = re.exec(src)) !== null) {
+    const key = m[1];
+    const raw = m[2];
+    if (raw === "true") obj[key] = true;
+    else if (raw === "false") obj[key] = false;
+    else if (/^-?\d+$/.test(raw)) obj[key] = Number(raw);
+    else obj[key] = raw.slice(1, -1).replace(/\\(.)/g, "$1");
+  }
+  return obj;
+}
+function parseArgs(inner) {
+  const args = [];
+  let i = 0;
+  while (i < inner.length) {
+    const c = inner[i];
+    if (c === " " || c === ",") {
+      i++;
+      continue;
+    }
+    if (c === "'" || c === '"') {
+      const end = endOfString(inner, i);
+      args.push(inner.slice(i + 1, end).replace(/\\(.)/g, "$1"));
+      i = end + 1;
+      continue;
+    }
+    if (c === "{") {
+      const end = matchBrace(inner, i);
+      args.push(parseOptions(inner.slice(i, end + 1)));
+      i = end + 1;
+      continue;
+    }
+    i++;
   }
-  const Z = 2147483600;
-  const wrap = doc.createElement("div");
-  wrap.style.cssText = `position:fixed;inset:0;z-index:${Z + 3};background:rgba(0,0,0,.45);display:flex;align-items:center;justify-content:center;font:13px/1.5 system-ui,sans-serif;`;
-  const panel = doc.createElement("div");
-  panel.style.cssText = "background:#111827;color:#f9fafb;border-radius:10px;padding:20px;max-width:640px;width:90vw;max-height:70vh;overflow:auto;box-shadow:0 8px 40px rgba(0,0,0,.5);";
-  const hlLocator = (expr) => {
-    const escHtml = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
-    const re = /('(?:\\.|[^'])*'|"(?:\\.|[^"])*")|([A-Za-z_$][\w$]*)(?=\s*\()|([A-Za-z_$][\w$]*)(?=\s*:)|(true|false|null|\d+)|([{}(),.])/g;
-    let html = "";
-    let last = 0;
-    let m;
-    while ((m = re.exec(expr)) !== null) {
-      if (m.index > last) html += escHtml(expr.slice(last, m.index));
-      const color = m[1] ? "#4ade80" : m[2] ? "#c084fc" : m[3] ? "#93c5fd" : m[4] ? "#fbbf24" : "#9ca3af";
-      html += `<span style="color:${color}">${escHtml(m[0])}</span>`;
-      last = re.lastIndex;
+  return args;
+}
+function leafExpression(expr) {
+  let depth = 0;
+  let leafStart = 0;
+  for (let i = 0; i < expr.length - 1; i++) {
+    const c = expr[i];
+    if (c === "'" || c === '"') {
+      i = endOfString(expr, i);
+      continue;
+    }
+    if (c === "(") depth++;
+    else if (c === ")") {
+      depth--;
+      if (depth === 0 && expr[i + 1] === ".") leafStart = i + 2;
     }
-    if (last < expr.length) html += escHtml(expr.slice(last));
-    return html;
-  };
-  const title = doc.createElement("div");
-  title.style.cssText = "font-weight:600;margin-bottom:4px;";
-  title.textContent = arg.failing ? "Pick a replacement locator" : "Pick a locator";
-  const sub = doc.createElement("div");
-  sub.style.cssText = "color:#9ca3af;margin-bottom:12px;";
-  if (arg.failing) {
-    sub.innerHTML = `Replaces <code style="font-family:ui-monospace,Menlo,monospace">${hlLocator(arg.failing)}</code> \u2014 ranked by stability score.`;
-  } else {
-    sub.textContent = "For the element you picked \u2014 ranked by stability score.";
   }
-  panel.appendChild(title);
-  panel.appendChild(sub);
-  const done = (choice) => {
-    g.__piwiPickChoice = choice;
-    doc.removeEventListener("keydown", onKey, true);
-    wrap.remove();
-  };
-  const onKey = (e) => {
-    if (e.key !== "Escape") return;
-    e.preventDefault();
-    e.stopImmediatePropagation();
-    done(-1);
-  };
-  arg.choices.forEach((c, i) => {
-    const btn = doc.createElement("button");
-    btn.style.cssText = "display:flex;justify-content:space-between;align-items:center;gap:12px;width:100%;text-align:left;background:#1f2937;color:#e5e7eb;border:1px solid #374151;border-radius:6px;padding:8px 12px;margin:0 0 8px;cursor:pointer;font:12px/1.5 ui-monospace,SFMono-Regular,Menlo,monospace;";
-    const code = doc.createElement("span");
-    code.innerHTML = hlLocator(c.locator);
-    code.style.cssText = "word-break:break-all;";
-    const score = doc.createElement("span");
-    score.textContent = String(c.score);
-    score.style.cssText = "color:#a78bfa;flex-shrink:0;";
-    btn.appendChild(code);
-    btn.appendChild(score);
-    btn.addEventListener("click", (e) => {
-      e.preventDefault();
-      e.stopImmediatePropagation();
-      done(i);
-    });
-    panel.appendChild(btn);
-  });
-  const skip = doc.createElement("button");
-  skip.style.cssText = "background:none;border:none;color:#9ca3af;cursor:pointer;padding:6px 0 0;font:12px system-ui,sans-serif;";
-  skip.textContent = "Skip \u2014 keep the failure as-is (Esc)";
-  skip.addEventListener("click", (e) => {
-    e.preventDefault();
-    e.stopImmediatePropagation();
-    done(-1);
-  });
-  panel.appendChild(skip);
-  doc.addEventListener("keydown", onKey, true);
-  wrap.appendChild(panel);
-  doc.body.appendChild(wrap);
+  return expr.slice(leafStart);
+}
+function parseLeafLocatorExpression(rawExpr) {
+  const expr = leafExpression(rawExpr.trim());
+  const m = /^([A-Za-z]+)\((.*)\)$/s.exec(expr);
+  if (!m) return null;
+  return { method: m[1], args: parseArgs(m[2].trim()) };
+}
+function deriveFailedLocator(testInfo) {
+  const info = testInfo;
+  const errors = info.errors && info.errors.length > 0 ? info.errors : info.error ? [info.error] : [];
+  for (const err of errors) {
+    const text = `${err.message ?? ""}
+${err.stack ?? ""}`.replace(ANSI_RE, "");
+    const line = /^\s*Locator:\s*(.+)$/m.exec(text);
+    if (!line) continue;
+    const parsed = parseLeafLocatorExpression(line[1].trim());
+    if (!parsed) continue;
+    const loc = err.location;
+    const location = loc ? `${path2.relative(process.cwd(), loc.file).split(path2.sep).join("/")}:${loc.line}:${loc.column}` : null;
+    return { method: parsed.method, args: parsed.args, location };
+  }
+  return null;
 }
 async function cleanupPicker(page) {
   try {
@@ -1399,7 +1852,8 @@ async function runLocatorPicker(page, testInfo, failed, probe) {
       `
 [piwi] "${testInfo.title}" ${testInfo.status} \u2014 ${rendered ? "locator picker" : "inspector"} open in the browser: ${rendered ? `click the element that should replace ${rendered}` : "click any element to generate locators for it"} (\u2191/\u2193 to select a parent/child, Esc to skip).`
     );
-    await page.evaluate(installPickerOverlay, { failing: rendered });
+    const overlayArg = { transport: "global", failing: rendered };
+    await page.evaluate(installPickerOverlay, overlayArg);
     await page.waitForFunction(() => globalThis.__piwiPickState !== void 0, void 0, {
       timeout: 0,
       polling: 250
@@ -1420,9 +1874,9 @@ async function runLocatorPicker(page, testInfo, failed, probe) {
     if (role) {
       const probeArg = probe.arg;
       await page.evaluate(showAnchorPicker, {
-        tagRoles: probeArg.tagRoles,
-        inputRoles: probeArg.inputRoles,
-        roleSources: probeArg.roleSources,
+        tagRoles: probeArg.tagRoles ?? {},
+        inputRoles: probeArg.inputRoles ?? {},
+        roleSources: probeArg.roleSources ?? "",
         leafRole: role,
         leafLevel: level,
         leafTestId: attrs.attributes["data-testid"] ?? null
@@ -1787,7 +2241,12 @@ var CAPTURED_ATTRS_ARG = {
   inputRoles: INPUT_TYPE_TO_ROLE,
   // '[role]' plus every tag the maps can resolve (input/select are handled by
   // special-cased logic in the probe, so add them explicitly).
-  roleSources: [.../* @__PURE__ */ new Set(["[role]", "input", "select", ...Object.keys(TAG_TO_ROLE)])].join(",")
+  roleSources: [.../* @__PURE__ */ new Set(["[role]", "input", "select", ...Object.keys(TAG_TO_ROLE)])].join(","),
+  // The reporter always wants ancestor-anchored alternatives (the picker's
+  // anchors step and generateAnchoredAlternatives both need them); it derives
+  // the accessible name itself, so the probe's own labelText is unneeded.
+  includeStructural: true,
+  includeLabelText: false
 };
 async function ariaSnapshotBestEffort(target, timeout) {
   if (typeof target.ariaSnapshot !== "function") return null;
@@ -1807,156 +2266,6 @@ async function ariaSnapshotBestEffort(target, timeout) {
     }
   }
 }
-function probeElementAttrs(el, arg) {
-  const { keep, tagRoles, inputRoles, roleSources } = arg;
-  const attrMap = {};
-  for (const key of keep) {
-    const v = el.getAttribute(key) ?? el[key];
-    attrMap[key] = typeof v === "string" ? v.slice(0, 200) : v ? String(v).slice(0, 200) : null;
-  }
-  const r = el.getBoundingClientRect();
-  const selectorCounts = {};
-  try {
-    const doc = el.ownerDocument;
-    const cssEsc = (s) => doc.defaultView.CSS.escape(s);
-    const count = (sel) => {
-      try {
-        return doc.querySelectorAll(sel).length;
-      } catch {
-        return void 0;
-      }
-    };
-    if (attrMap["data-testid"]) {
-      selectorCounts.testId = count(`[data-testid=${JSON.stringify(attrMap["data-testid"])}]`);
-    }
-    if (attrMap["id"]) selectorCounts.id = count(`#${cssEsc(attrMap["id"])}`);
-    if (attrMap["name"]) selectorCounts.name = count(`[name=${JSON.stringify(attrMap["name"])}]`);
-    const classList = (attrMap["class"] || "").split(/\s+/).filter((c) => c.length > 1).slice(0, 10);
-    if (classList.length > 0) {
-      const classCounts = {};
-      for (const cls of classList) {
-        const n = count(`.${cssEsc(cls)}`);
-        if (n !== void 0) classCounts[cls] = n;
-      }
-      selectorCounts.classes = classCounts;
-    }
-  } catch {
-  }
-  let rolePosition = null;
-  const ancestors = [];
-  try {
-    const doc = el.ownerDocument;
-    const cssEsc = (s) => doc.defaultView.CSS.escape(s);
-    const count = (sel) => {
-      try {
-        return doc.querySelectorAll(sel).length;
-      } catch {
-        return void 0;
-      }
-    };
-    const roleOf = (n) => {
-      const explicit = n.getAttribute("role");
-      if (explicit) return explicit;
-      const tag = (n.tagName || "").toLowerCase();
-      if (tag === "input") return inputRoles[(n.getAttribute("type") || "text").toLowerCase()] ?? "textbox";
-      if (tag === "select") return n.getAttribute("multiple") != null ? "listbox" : "combobox";
-      if (tag === "a") return n.getAttribute("href") != null ? "link" : null;
-      return tagRoles[tag] ?? null;
-    };
-    const levelOf = (n) => {
-      const m = /^h([1-6])$/.exec((n.tagName || "").toLowerCase());
-      if (m) return Number(m[1]);
-      const al = n.getAttribute("aria-level");
-      return al && /^\d+$/.test(al) ? Number(al) : null;
-    };
-    const targetRole = roleOf(el);
-    const targetLevel = targetRole === "heading" ? levelOf(el) : null;
-    if (targetRole) {
-      const nodes = doc.querySelectorAll(roleSources);
-      if (nodes.length <= 4e3) {
-        let roleCountAll = 0;
-        let index = -1;
-        let levelCount = 0;
-        for (let i = 0; i < nodes.length; i++) {
-          const n = nodes[i];
-          if (roleOf(n) !== targetRole) continue;
-          if (n === el) index = roleCountAll;
-          roleCountAll++;
-          if (targetLevel != null && levelOf(n) === targetLevel) levelCount++;
-        }
-        if (index !== -1) {
-          rolePosition = {
-            role: targetRole,
-            count: roleCountAll,
-            index,
-            ...targetLevel != null ? { levelCount } : {}
-          };
-        }
-        const CONTAINER_TAGS = ["form", "nav", "main", "article", "section", "dialog", "table"];
-        const docRoleCount = (role) => {
-          let c = 0;
-          for (let i = 0; i < nodes.length; i++) if (roleOf(nodes[i]) === role) c++;
-          return c;
-        };
-        let node = el.parentElement;
-        let depth = 0;
-        while (node && depth < 12 && ancestors.length < 4) {
-          depth++;
-          const tag = (node.tagName || "").toLowerCase();
-          if (tag === "body" || tag === "html") break;
-          const testId = node.getAttribute("data-testid");
-          const id = node.getAttribute("id");
-          const explicitRole = node.getAttribute("role");
-          const ariaLabel = node.getAttribute("aria-label");
-          const anchorRole = explicitRole || (CONTAINER_TAGS.includes(tag) ? tagRoles[tag] : null) || null;
-          if (testId || id || anchorRole || ariaLabel) {
-            const scoped = node.querySelectorAll(roleSources);
-            let scopedRoleCount = 0;
-            if (scoped.length <= 2e3) {
-              for (let i = 0; i < scoped.length; i++) {
-                const n = scoped[i];
-                if (roleOf(n) !== targetRole) continue;
-                if (targetLevel != null && levelOf(n) !== targetLevel) continue;
-                scopedRoleCount++;
-              }
-            } else {
-              scopedRoleCount = -1;
-            }
-            ancestors.push({
-              tag,
-              depth,
-              testId: testId || null,
-              id: id || null,
-              role: explicitRole || null,
-              ariaLabel: ariaLabel || null,
-              ...scopedRoleCount >= 0 ? { scopedRoleCount } : {},
-              ...testId ? { testIdCount: count(`[data-testid=${JSON.stringify(testId)}]`) } : {},
-              ...id ? { idCount: count(`#${cssEsc(id)}`) } : {},
-              ...anchorRole ? { roleCount: docRoleCount(anchorRole) } : {}
-            });
-          }
-          node = node.parentElement;
-        }
-      }
-    }
-  } catch {
-  }
-  return {
-    tagName: el.tagName?.toLowerCase?.() ?? "unknown",
-    attributes: attrMap,
-    // Collapse whitespace so multi-line text can't produce a getByText
-    // suggestion with literal newlines in it.
-    textContent: (el.textContent || "").replace(/\s+/g, " ").trim().slice(0, 80),
-    center: {
-      x: Math.round(r.x + r.width / 2),
-      y: Math.round(r.y + r.height / 2)
-    },
-    hasLabel: !!(el.labels && el.labels.length > 0),
-    selectorCounts,
-    rolePosition,
-    ancestors
-  };
-}
 function startElementCapture(sink, target, seq, callerLocation, used) {
   const probe = target.evaluate(probeElementAttrs, CAPTURED_ATTRS_ARG);
   const settledProbe = probe.then(