@piwitests/reporter 0.38.0 → 0.40.0

package/dist/index.js

@@ -568,6 +568,7 @@ function toWireTestCase(tc) {
     locks: rest.locks ?? null,
     testMeta: rest.testMeta ?? null,
     locatorSnapshots: rest.locatorSnapshots || null,
+    locatorPages: rest.locatorPages || null,
     didNotRunReason: rest.didNotRunReason ?? null,
     blockedBy: rest.blockedBy ?? null
   };
@@ -996,6 +997,7 @@ var ATTACHMENT_NAMES = {
   dialogs: "piwi-dialogs",
   network: "piwi-network",
   pageInventory: "piwi-page-inventory",
+  locatorPages: "piwi-locator-pages",
   webVitals: "piwi-web-vitals",
   locatorSuggestion: "piwi-locator-suggestion",
   pageState: "piwi-page-state",
@@ -1382,7 +1384,7 @@ var MetadataCollector = class {
   /**
    * Walk the test's parent `describe` suites to extract the suite path (titles)
    * and per-level config (parallel mode + annotations). Reaches into Playwright
-   * suite internals (`_parallelMode`, `_annotations`) — kept here next to
+   * suite internals (`_parallelMode`, `_staticAnnotations`) — kept here next to
    * `getBrowserConfig` so all such access is guarded behind one class.
    */
   getSuiteInfo(test) {
@@ -1399,7 +1401,10 @@ var MetadataCollector = class {
       suitePath.push(s.title);
       const rawMode = s._parallelMode;
       const mode = rawMode === "parallel" ? "parallel" : rawMode === "serial" ? "serial" : "default";
-      const annotations = s._annotations ?? [];
+      const staticAnnotations = s._staticAnnotations ?? [];
+      const annotations = staticAnnotations.map(
+        (a) => a.description === void 0 ? { type: a.type } : { type: a.type, description: a.description }
+      );
       suiteConfig.push({ mode, annotations });
     }
     return { suitePath, suiteConfig };
@@ -1497,6 +1502,8 @@ var MetadataCollector = class {
           // The origin of `baseURL` is what the graph treats as the run's own
           // surface, so only requests to it become route nodes.
           baseURL: p.use?.baseURL,
+          // The attribute `getByTestId` reads, so the locator index can resolve those locators on a live page.
+          testIdAttribute: p.use?.testIdAttribute,
           viewport: p.use?.viewport,
           deviceScaleFactor: p.use?.deviceScaleFactor
         }
@@ -2141,11 +2148,14 @@ var MAX_STEP_PARAM_VALUE_CHARS = 200;
 function capStepValue(value, max) {
   return value.length > max ? `${value.slice(0, Math.max(0, max - 1))}\u2026` : value;
 }
+var HTTP_METHOD_TITLE_RE = /^(?:get|post|put|patch|delete|head|options|fetch)$/i;
 function categorizeStep(title, pwCategory, params) {
   if (!title) return "other";
-  if (pwCategory === "hook" || pwCategory === "fixture") return pwCategory;
+  if (pwCategory === "hook" || pwCategory === "fixture" || pwCategory === "test.step") return pwCategory;
   if (pwCategory === "expect") return "assertion";
+  if (pwCategory === "test.attach") return "attach";
   const lower = title.toLowerCase();
+  if (HTTP_METHOD_TITLE_RE.test(title.trim())) return "api";
   if (lower.startsWith("wait for") || lower.startsWith("locator.waitfor") || lower.startsWith("page.waitfor") || lower.startsWith("frame.waitfor"))
     return "wait";
   if (typeof params?.url === "string" && pwCategory !== "expect") return "navigation";
@@ -2183,13 +2193,14 @@ function normalizeStepParams(raw) {
   }
   return count > 0 ? out : void 0;
 }
-function flattenSteps(steps) {
+function flattenSteps(steps, depth = 0) {
   const result = [];
   for (const step of steps) {
     const flat = {
       title: step.title,
       duration: step.duration,
-      category: categorizeStep(step.title, step.category, step.params)
+      category: categorizeStep(step.title, step.category, step.params),
+      depth
     };
     if (typeof step.subtitle === "string" && step.subtitle.length > 0) flat.subtitle = maskTokenLike(step.subtitle);
     const params = normalizeStepParams(step.params);
@@ -2201,7 +2212,7 @@ function flattenSteps(steps) {
     if (step.location) flat.location = `${step.location.file}:${step.location.line}:${step.location.column}`;
     if (step.startTime) flat.startTime = step.startTime instanceof Date ? step.startTime.getTime() : step.startTime;
     result.push(flat);
-    if (step.steps?.length > 0) result.push(...flattenSteps(step.steps));
+    if (step.steps?.length > 0) result.push(...flattenSteps(step.steps, depth + 1));
   }
   return result;
 }
@@ -2313,7 +2324,8 @@ function findOwnPackageJson(fromDir) {
       const pkgPath = path8.resolve(fromDir, offset, "package.json");
       const pkg = JSON.parse(fs9.readFileSync(pkgPath, "utf-8"));
       const { name, version } = pkg;
-      if (name === "@piwitests/reporter" && typeof version === "string") return { version };
+      if (name === "@piwitests/reporter" && typeof version === "string")
+        return { version, root: path8.dirname(pkgPath) };
     } catch {
     }
   }
@@ -2767,8 +2779,8 @@ function parseRouteKey(routeKey) {
   return { method: routeKey.slice(0, space).toUpperCase(), pattern: routeKey.slice(space + 1) };
 }
 function patternToRegex(pattern) {
-  const path23 = pattern.split("?")[0] ?? pattern;
-  const escaped = path23.replace(/[.*+?^${}()|[\]\\]/g, "\\$&").replace(/:[A-Za-z0-9_]+/g, "[^/]+");
+  const path24 = pattern.split("?")[0] ?? pattern;
+  const escaped = path24.replace(/[.*+?^${}()|[\]\\]/g, "\\$&").replace(/:[A-Za-z0-9_]+/g, "[^/]+");
   return new RegExp(`^${escaped}$`);
 }
 function suitePathEqual(a, b) {
@@ -2791,13 +2803,13 @@ function matchProbeItem(plan, test) {
 function requestMatchesRoute(method, url, routeKey) {
   const { method: rm, pattern } = parseRouteKey(routeKey);
   if (rm && rm !== method.toUpperCase()) return false;
-  let path23;
+  let path24;
   try {
-    path23 = new URL(url).pathname;
+    path24 = new URL(url).pathname;
   } catch {
-    path23 = url.split("?")[0] ?? url;
+    path24 = url.split("?")[0] ?? url;
   }
-  return patternToRegex(pattern).test(path23);
+  return patternToRegex(pattern).test(path24);
 }
 function createProbeState() {
   return { navigated: false, matches: 0 };
@@ -2819,10 +2831,10 @@ function isProbeMode() {
 function loadPlan() {
   if (planCache !== void 0) return planCache;
   planCache = null;
-  const path23 = process.env[PIWI_PROBE_ENV.plan];
-  if (path23) {
+  const path24 = process.env[PIWI_PROBE_ENV.plan];
+  if (path24) {
     try {
-      planCache = JSON.parse(fs14.readFileSync(path23, "utf8"));
+      planCache = JSON.parse(fs14.readFileSync(path24, "utf8"));
     } catch {
       planCache = null;
     }
@@ -2844,10 +2856,10 @@ function outcomeFromStatus(status, applied) {
   return status === "failed" || status === "timedOut" || status === "interrupted" ? "noticed" : "not-noticed";
 }
 function recordProbeOutcome(line) {
-  const path23 = process.env[PIWI_PROBE_ENV.results];
-  if (!path23) return;
+  const path24 = process.env[PIWI_PROBE_ENV.results];
+  if (!path24) return;
   try {
-    fs14.appendFileSync(path23, `${JSON.stringify(line)}
+    fs14.appendFileSync(path24, `${JSON.stringify(line)}
 `);
   } catch {
   }
@@ -4084,12 +4096,20 @@ function readUrl(text, callLog, received) {
   }
   return null;
 }
+var MATCHER_LINE_RE = /^(?:expect[.(]|Timed out\b|Expected\b|Received\b|Locator\b)/;
+function readCustomMessage(messageHead) {
+  const lines = messageHead.split("\n").map((line) => line.trim()).filter(Boolean);
+  if (lines.length < 2) return null;
+  const first = lines[0].replace(/^Error:\s*/, "");
+  if (!first || MATCHER_LINE_RE.test(first)) return null;
+  return /^(?:expect[.(]|Timed out\b)/.test(lines[1]) ? first : null;
+}
 function parsePlaywrightError(raw, context) {
   const clean = stripAnsi(raw ?? "").replace(/\r\n?/g, "\n");
   const text = withoutStackFrames(clean);
   const messageHead = extractMessageHead(clean);
-  const firstLine = messageHead.split("\n")[0] ?? "";
-  const errorName = ERROR_NAME_RE.exec(firstLine)?.[1] ?? null;
+  const firstLine2 = messageHead.split("\n")[0] ?? "";
+  const errorName = ERROR_NAME_RE.exec(firstLine2)?.[1] ?? null;
   const strict = STRICT_RE.exec(text);
   const call = CALL_RE.exec(text);
   const callLog = readCallLog(text);
@@ -4159,12 +4179,134 @@ function parsePlaywrightError(raw, context) {
     lastCallLogLine: callLog.lastLine,
     lastStateLine: callLog.stateLine,
     messageHead,
+    customMessage: isAssertion ? readCustomMessage(messageHead) : null,
     topFrame: frame ? `${frame.file}:${frame.line}` : null,
     isNavigationFailure,
     isLocatorResolutionFailure
   };
 }
 
+// ../core/src/step-tree.ts
+var SPAN_TOLERANCE_MS = 1;
+var SETUP_CONTAINER_RE = /^before hooks$/i;
+var TEARDOWN_CONTAINER_RE = /^(?:after hooks|worker cleanup|worker teardown)$/i;
+var NAMED_HOOK_RE = /^(before|after)(each|all) hook$/i;
+var FIXTURE_TITLE_RE = /^fixture\s+["“](.+)["”]$/i;
+var CAPTURE_ATTACH_RE = /^attach\s+["“]piwi-/i;
+var CAPTURE_FIXTURE_RE = /^fixture\s+["“]piwiCapture["”]$/i;
+var CAPTURE_PROBE_TITLE_RE = /^(?:evaluate|aria snapshot|locator\.(?:evaluate|ariasnapshot)|page\.evaluate)\b/i;
+var REPORTER_BUNDLE_RE = /[\\/](?:@piwitests[\\/]reporter|packages[\\/]reporter)[\\/]dist[\\/]/;
+function str(value) {
+  return typeof value === "string" ? value : "";
+}
+function num(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function errorMessage2(step) {
+  const error = step.error;
+  if (typeof error === "string") return error;
+  return str(error?.message);
+}
+function isFailedStep(step) {
+  return step.failed === true || errorMessage2(step).trim().length > 0;
+}
+function isCaptureStep(step) {
+  const title = str(step.title).trim();
+  if (CAPTURE_ATTACH_RE.test(title) || CAPTURE_FIXTURE_RE.test(title)) return true;
+  return CAPTURE_PROBE_TITLE_RE.test(title) && REPORTER_BUNDLE_RE.test(str(step.location));
+}
+function isPhaseContainer(step) {
+  const title = str(step.title).trim();
+  return SETUP_CONTAINER_RE.test(title) || TEARDOWN_CONTAINER_RE.test(title);
+}
+function stepParents(steps) {
+  const parents = steps.map(() => -1);
+  if (steps.length === 0) return parents;
+  if (steps.every((s) => num(s.depth) !== null)) {
+    const stack = [];
+    steps.forEach((step, i) => {
+      const depth = num(step.depth);
+      while (stack.length > 0 && num(steps[stack[stack.length - 1]].depth) >= depth) stack.pop();
+      parents[i] = stack.length > 0 ? stack[stack.length - 1] : -1;
+      stack.push(i);
+    });
+    return parents;
+  }
+  if (steps.every((s) => num(s.startTime) !== null && num(s.duration) !== null)) {
+    const start = (i) => num(steps[i].startTime);
+    const end = (i) => start(i) + Math.max(0, num(steps[i].duration));
+    const contains = (a, b) => end(a) > start(a) && start(b) >= start(a) - SPAN_TOLERANCE_MS && start(b) < end(a) && end(b) <= end(a) + SPAN_TOLERANCE_MS;
+    const stack = [];
+    steps.forEach((_, i) => {
+      while (stack.length > 0 && !contains(stack[stack.length - 1], i)) stack.pop();
+      parents[i] = stack.length > 0 ? stack[stack.length - 1] : -1;
+      stack.push(i);
+    });
+  }
+  return parents;
+}
+function isDescendant(descendant, ancestor, parents) {
+  for (let p = parents[descendant] ?? -1; p !== -1; p = parents[p] ?? -1) {
+    if (p === ancestor) return true;
+  }
+  return false;
+}
+function topAncestor(index, parents) {
+  let top = index;
+  while ((parents[top] ?? -1) !== -1) top = parents[top];
+  return top;
+}
+function stepPhases(steps, parents = stepParents(steps)) {
+  return steps.map((_, i) => {
+    const top = str(steps[topAncestor(i, parents)].title).trim();
+    if (SETUP_CONTAINER_RE.test(top)) return "setup";
+    if (TEARDOWN_CONTAINER_RE.test(top)) return "teardown";
+    return "body";
+  });
+}
+function failingStepIndex(steps, parents = stepParents(steps)) {
+  const candidates = [];
+  steps.forEach((step, i) => {
+    if (isFailedStep(step) && !isCaptureStep(step)) candidates.push(i);
+  });
+  if (candidates.length === 0) return null;
+  let current = candidates[0];
+  for (; ; ) {
+    const inner = candidates.find((c) => c > current && isDescendant(c, current, parents));
+    if (inner === void 0) return current;
+    current = inner;
+  }
+}
+function stepHookName(step) {
+  const title = str(step.title).trim();
+  const category = str(step.category);
+  const named = NAMED_HOOK_RE.exec(title);
+  if (named) return `${named[1].toLowerCase()}${named[2][0].toUpperCase()}${named[2].slice(1).toLowerCase()}`;
+  const fixture = FIXTURE_TITLE_RE.exec(title);
+  if (fixture) return `fixture "${fixture[1]}"`;
+  if (category === "fixture") return title ? `fixture "${title.replace(/^fixture:\s*/i, "")}"` : null;
+  if (category === "hook" && title && !isPhaseContainer(step)) return `hook "${title}"`;
+  return null;
+}
+function firstLine(message) {
+  return stripAnsi(str(message)).split("\n")[0].trim();
+}
+function failureHookContext(steps, error, parents = stepParents(steps)) {
+  const index = failingStepIndex(steps, parents);
+  if (index === null) return null;
+  const phase = stepPhases(steps, parents)[index];
+  if (phase === "body") return null;
+  if (error != null) {
+    const stepError = firstLine(errorMessage2(steps[index]));
+    if (stepError && firstLine(error) !== stepError) return null;
+  }
+  for (let i = index; i !== -1; i = parents[i] ?? -1) {
+    const name = stepHookName(steps[i]);
+    if (name) return { phase, hook: name };
+  }
+  return { phase, hook: phase };
+}
+
 // ../core/src/describe-failure.ts
 var HEADLINE_MAX_CHARS = 120;
 var VALUE_MAX_CHARS = 40;
@@ -4511,7 +4653,27 @@ function buildCrash(parsed, opts) {
   }
   return line.text(what);
 }
+var CUSTOM_MESSAGE_MAX_CHARS = 60;
+var SENTENCE_CASE_WORD_RE = /^[A-Z][a-z]*(?![A-Za-z])/;
+function withLeads(line, parsed, ctx) {
+  const hook = ctx?.failedIn && !parsed.timeoutPhase ? ctx.failedIn.hook : null;
+  const message = parsed.customMessage ? truncateValue(parsed.customMessage, CUSTOM_MESSAGE_MAX_CHARS) : null;
+  if (!hook && !message) return line;
+  const led = new Line();
+  if (hook) led.text(`In ${hook}${message ? ", " : ": "}`);
+  if (message) led.text(`"${message}" failed: `);
+  line.parts.forEach((part, i) => {
+    const text = i === 0 && part.kind === "text" && SENTENCE_CASE_WORD_RE.test(part.text) ? part.text[0].toLowerCase() + part.text.slice(1) : part.text;
+    if (part.kind === "text") led.text(text);
+    else if (part.kind === "locator") led.locator(text);
+    else led.value(text);
+  });
+  return led;
+}
 function build(parsed, opts, ctx) {
+  return withLeads(buildLine(parsed, opts, ctx), parsed, ctx);
+}
+function buildLine(parsed, opts, ctx) {
   switch (parsed.kind) {
     case "action-timeout":
       return buildActionTimeout(parsed, opts);
@@ -4597,15 +4759,36 @@ function describeFailureText(raw, ctx) {
   if (!raw || !raw.trim()) return null;
   return describeFailure(parsePlaywrightError(raw, { stepParams: ctx?.stepParams }), ctx);
 }
-function lastStepTitle(steps) {
+function headlineStep(steps) {
   if (!steps || steps.length === 0) return null;
-  const failed = steps.find((s) => s.failed);
-  return (failed ?? steps[steps.length - 1])?.title ?? null;
+  const parents = stepParents(steps);
+  const failed = failingStepIndex(steps, parents);
+  if (failed !== null) return steps[failed];
+  const phases = stepPhases(steps, parents);
+  for (let i = steps.length - 1; i >= 0; i--) {
+    const step = steps[i];
+    if (phases[i] === "body" && !isCaptureStep(step) && !isPhaseContainer(step)) return step;
+  }
+  return steps[steps.length - 1];
+}
+function lastStepTitle(steps) {
+  const title = headlineStep(steps)?.title;
+  return typeof title === "string" ? title : null;
+}
+function failingStepParams(steps) {
+  return headlineStep(steps)?.params ?? null;
+}
+function stepHeadlineContext(steps, error) {
+  return {
+    lastStepTitle: lastStepTitle(steps),
+    stepParams: failingStepParams(steps),
+    failedIn: steps && steps.length > 0 ? failureHookContext(steps, error ?? null) : null
+  };
 }
 
 // src/internal/support/failure-links.ts
 function failureHeadline(error, steps) {
-  return describeFailureText(error, { lastStepTitle: lastStepTitle(steps) })?.headline ?? null;
+  return describeFailureText(error, stepHeadlineContext(steps, error))?.headline ?? null;
 }
 function caseLocateUrl(serverUrl, runId, test) {
   const params = [
@@ -4941,6 +5124,13 @@ var PiwiDashboardReporter = class _PiwiDashboardReporter {
         } catch {
         }
       }
+      const pagesAttachment = this.options.captureLocators !== false ? result.attachments.find((a) => a.name === ATTACHMENT_NAMES.locatorPages) : void 0;
+      if (pagesAttachment?.body) {
+        try {
+          testCase.locatorPages = JSON.parse(pagesAttachment.body.toString());
+        } catch {
+        }
+      }
     }
     switch (status) {
       case "passed":
@@ -5138,7 +5328,30 @@ var import_node_zlib2 = require("zlib");
 
 // ../picker-dom/src/probe.ts
 function probeElementAttrs(el, arg) {
-  const { keep, tagRoles, inputRoles, roleSources, includeStructural, includeLabelText } = arg;
+  const { keep, tagRoles, inputRoles, roleSources, includeStructural } = arg;
+  const FIELD_TAGS = ["input", "select", "textarea"];
+  const textWithout = (root, skip) => {
+    if (root === skip) return "";
+    if (root.nodeType === 3) return root.nodeValue || "";
+    let text = "";
+    const kids = root.childNodes || [];
+    for (let i = 0; i < kids.length; i++) text += textWithout(kids[i], skip);
+    return text;
+  };
+  const labelTextOf = (n) => {
+    try {
+      const ids = (n.getAttribute("aria-labelledby") || "").split(/\s+/).filter(Boolean);
+      let text = "";
+      for (const id of ids) {
+        const ref = n.ownerDocument.getElementById(id);
+        if (ref) text += ` ${textWithout(ref, n)}`;
+      }
+      if (!text.trim() && n.labels && n.labels.length > 0) text = textWithout(n.labels[0], n);
+      return text.replace(/\s+/g, " ").trim().slice(0, 120) || null;
+    } catch {
+      return null;
+    }
+  };
   const attrMap = {};
   for (const key of keep) {
     const v = el.getAttribute(key) ?? el[key];
@@ -5218,10 +5431,18 @@ function probeElementAttrs(el, arg) {
       const targetRole = roleOf(el);
       const targetLevel = targetRole === "heading" ? levelOf(el) : null;
       const nameOf = (n) => {
+        const labelledBy = !!n.getAttribute("aria-labelledby");
+        const isField = FIELD_TAGS.indexOf((n.tagName || "").toLowerCase()) !== -1;
+        const lt = labelledBy || isField ? labelTextOf(n) : null;
+        if (lt && labelledBy) return lt;
         const al = n.getAttribute("aria-label");
         if (al) return al;
-        const txt = (n.textContent || "").replace(/\s+/g, " ").trim();
-        if (txt) return txt;
+        if (isField) {
+          if (lt) return lt;
+        } else {
+          const txt = (n.textContent || "").replace(/\s+/g, " ").trim();
+          if (txt) return txt;
+        }
         return n.getAttribute("title") || n.getAttribute("placeholder") || null;
       };
       const targetName = nameOf(el);
@@ -5413,16 +5634,7 @@ function probeElementAttrs(el, arg) {
     }
   }
   const hasLabel = !!(el.labels && el.labels.length > 0);
-  let labelText;
-  if (includeLabelText) {
-    labelText = null;
-    try {
-      const label = hasLabel ? el.labels[0] : null;
-      labelText = (label && label.textContent || "").replace(/\s+/g, " ").trim().slice(0, 120) || null;
-    } catch {
-      labelText = null;
-    }
-  }
+  const labelText = labelTextOf(el);
   return {
     tagName: el.tagName?.toLowerCase?.() ?? "unknown",
     attributes: attrMap,
@@ -5434,7 +5646,7 @@ function probeElementAttrs(el, arg) {
       y: Math.round(r.y + r.height / 2)
     },
     hasLabel,
-    ...includeLabelText ? { labelText } : {},
+    labelText,
     selectorCounts,
     ...includeStructural ? { rolePosition, ancestors } : {}
   };
@@ -6405,9 +6617,15 @@ function generateAlternatives(attrs) {
 }
 function approximateAccessibleName(attrs) {
   const a = attrs.attributes;
+  const labelText = attrs.labelText || null;
+  if (a["aria-labelledby"] && labelText) return labelText;
   const ariaLabel = a["aria-label"];
   if (ariaLabel) return ariaLabel;
-  if (attrs.textContent) return attrs.textContent;
+  if (["input", "select", "textarea"].includes(attrs.tagName)) {
+    if (labelText) return labelText;
+  } else if (attrs.textContent) {
+    return attrs.textContent;
+  }
   const title = a["title"];
   if (title) return title;
   const placeholder = a["placeholder"];
@@ -6987,6 +7205,94 @@ function inventoryPageKey(url) {
   }
 }
 
+// ../core/src/page-key.ts
+function normalizeRoute(url) {
+  try {
+    const parsed = new URL(url);
+    let pathname = parsed.pathname;
+    pathname = pathname.replace(/\/eyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+(?=\/|$)/g, "/:jwt");
+    pathname = pathname.replace(/\/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}(?=\/|$)/gi, "/:uuid");
+    pathname = pathname.replace(/\/[0-9ABCDEFGHJKMNPQRSTVWXYZ]{26}(?=\/|$)/gi, "/:ulid");
+    pathname = pathname.replace(/\/[A-Za-z0-9_-]{40,}(?=\/|$)/g, "/:token");
+    pathname = pathname.replace(/\/[0-9a-f]{32,}(?=\/|$)/gi, "/:token");
+    pathname = pathname.replace(/\/\d+(?=\/|$)/g, "/:id");
+    let queryString = "";
+    if (parsed.search) {
+      const params = new URLSearchParams(parsed.search);
+      const redacted = new URLSearchParams();
+      for (const [key] of params) {
+        redacted.set(key, "<redacted>");
+      }
+      queryString = "?" + redacted.toString();
+    }
+    return `${pathname}${queryString}`;
+  } catch {
+    return url;
+  }
+}
+var PATH_ANCHOR_HOST = "piwi.invalid";
+function pageKey(url) {
+  const hasScheme = /^[a-z][a-z0-9+.-]*:/i.test(url);
+  if (hasScheme && !/^https?:\/\//i.test(url)) return null;
+  const absolute = /^https?:\/\//i.test(url) ? url : `http://${PATH_ANCHOR_HOST}${url.startsWith("/") ? "" : "/"}${url}`;
+  const normalized = normalizeRoute(absolute);
+  const q = normalized.indexOf("?");
+  return q < 0 ? normalized : normalized.slice(0, q);
+}
+
+// src/internal/capture/locator-pages.ts
+var MAX_LOCATOR_PAGE_ENTRIES = 1e3;
+var MAX_LOCATOR_CHARS = 1e3;
+var NON_INTERACTIONS = /* @__PURE__ */ new Set(["waitFor"]);
+var interactions = /* @__PURE__ */ new WeakMap();
+function noteNavigation(page) {
+  interactions.set(page, 0);
+}
+function isOnArrival(page) {
+  return (interactions.get(page) ?? 0) === 0;
+}
+function noteLocatorCall(page, method, assertion = false) {
+  const arrival = isOnArrival(page);
+  if (!assertion && !NON_INTERACTIONS.has(method)) interactions.set(page, (interactions.get(page) ?? 0) + 1);
+  return arrival;
+}
+function pageOf(url) {
+  const key = pageKey(url);
+  if (key === null) return null;
+  try {
+    const origin = new URL(url).origin;
+    return origin && origin !== "null" ? { origin, page: key } : null;
+  } catch {
+    return null;
+  }
+}
+var LocatorPageLog = class {
+  constructor() {
+    this.entries = /* @__PURE__ */ new Map();
+  }
+  /** Record one call. Silently skipped without a call site, off an http(s) page, or past the limits. */
+  record(call) {
+    if (!call.location || !call.locator || call.locator.length > MAX_LOCATOR_CHARS) return;
+    const where = pageOf(call.url);
+    if (!where) return;
+    const key = `${call.location}\0${call.locator}\0${where.origin}\0${where.page}`;
+    const existing = this.entries.get(key);
+    if (existing) {
+      existing.arrival ||= call.arrival;
+      return;
+    }
+    if (this.entries.size >= MAX_LOCATOR_PAGE_ENTRIES) return;
+    this.entries.set(key, { location: call.location, locator: call.locator, ...where, arrival: call.arrival });
+  }
+  get size() {
+    return this.entries.size;
+  }
+  /** The entries in the order the calls first happened. */
+  list() {
+    return [...this.entries.values()];
+  }
+};
+
 // src/internal/probe/interception.ts
 var import_node_zlib = require("zlib");
 
@@ -7375,6 +7681,59 @@ function applyPickToSnapshots(snapshots, pick) {
   return true;
 }
 
+// src/internal/capture/quiet-capture.ts
+var import_node_module = require("module");
+var path20 = __toESM(require("path"));
+var BOXED_PREFIX_EXPORTS = [
+  [
+    "playwright-core/lib/coreBundle",
+    (mod) => mod?.utils?.setBoxedStackPrefixes
+  ],
+  ["playwright-core/lib/utils", (mod) => mod?.setBoxedStackPrefixes]
+];
+var boxing;
+function resolveBoxing() {
+  try {
+    const root = findOwnPackageJson(__dirname)?.root;
+    if (!root) return null;
+    const testPackageJson = (0, import_node_module.createRequire)(__filename).resolve("@playwright/test/package.json");
+    const playwrightPackageJson = (0, import_node_module.createRequire)(testPackageJson).resolve("playwright/package.json");
+    const requireFromPlaywright = (0, import_node_module.createRequire)(playwrightPackageJson);
+    for (const [moduleId, pick] of BOXED_PREFIX_EXPORTS) {
+      let set;
+      try {
+        set = pick(requireFromPlaywright(moduleId));
+      } catch {
+        continue;
+      }
+      if (typeof set !== "function") continue;
+      return {
+        set,
+        prefixes: [path20.dirname(playwrightPackageJson), path20.join(root, "dist") + path20.sep]
+      };
+    }
+  } catch {
+  }
+  return null;
+}
+function boxCaptureFrames(extraPrefixes = []) {
+  const first = boxing === void 0;
+  if (first) boxing = resolveBoxing();
+  if (!boxing) return;
+  const added = extraPrefixes.filter((prefix) => !boxing.prefixes.includes(prefix));
+  if (!first && added.length === 0) return;
+  boxing.prefixes.push(...added);
+  try {
+    boxing.set([...boxing.prefixes]);
+  } catch {
+  }
+}
+function internalCall(owner, run) {
+  const wrap = owner?._wrapApiCall;
+  if (typeof wrap !== "function") return run();
+  return wrap.call(owner, run, { internal: true, title: "Piwi capture" });
+}
+
 // src/internal/capture/capture-fixtures.ts
 function computeCoreVitals(lcpEntries, shiftEntries, eventEntries) {
   const lastLcp = lcpEntries && lcpEntries.length > 0 ? lcpEntries[lcpEntries.length - 1] : null;
@@ -7425,7 +7784,8 @@ function createSink() {
     probeItem: null,
     probeInterception: null,
     pickOffered: false,
-    userPick: null
+    userPick: null,
+    locatorPages: new LocatorPageLog()
   };
 }
 var currentSink = null;
@@ -7644,7 +8004,7 @@ async function recordPageWindow(sink, page) {
   if (sink.pageInventories.length >= MAX_PAGE_INVENTORY_WINDOWS) return;
   if (key && !inventoriedPageKeys.has(key)) {
     inventoriedPageKeys.add(key);
-    const content = await readPageInventory(page);
+    const content = await internalCall(page, () => readPageInventory(page));
     if (sink.pageInventories.length >= MAX_PAGE_INVENTORY_WINDOWS) return;
     sink.pageInventories.push({
       url: content?.url ?? url,
@@ -7661,6 +8021,9 @@ async function stashPageState(sink, closing) {
   if (!page || isPageClosed(page)) return;
   const belongsToClosing = closing.page === page || closing.context !== void 0 && pageContext(page) === closing.context;
   if (!belongsToClosing) return;
+  await internalCall(page, () => readPageBeforeClose(sink, page));
+}
+async function readPageBeforeClose(sink, page) {
   const vitals = await readWebVitals(page);
   if (vitals) sink.stashedWebVitals = vitals;
   if (process.env.PIWI_CAPTURE_PAGE_STATE !== "false") {
@@ -7702,7 +8065,10 @@ async function maybeOpenPicker(sink, closing) {
     console.log("[piwi] locator picker: no failing locator could be identified in this failure \u2014 nothing to replace.");
     return;
   }
-  const pick = await runLocatorPicker(page, testInfo, failed, { fn: probeElementAttrs, arg: CAPTURED_ATTRS_ARG });
+  const pick = await internalCall(
+    page,
+    () => runLocatorPicker(page, testInfo, failed, { fn: probeElementAttrs, arg: CAPTURED_ATTRS_ARG })
+  );
   if (!pick) return;
   sink.userPick = pick;
   applyPickToSnapshots(sink.capturedLocators, pick);
@@ -7721,12 +8087,8 @@ var CAPTURED_ATTRS_ARG = {
   // special-cased logic in the probe, so add them explicitly).
   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). `labelText`
-  // is what names a form field, and the probe reads it from `el.labels` in the
-  // same pass — so asking for it here is free and settles the accessible name
-  // of a labeled field without a second round trip (`exactAccessibleName`).
-  includeStructural: true,
-  includeLabelText: true
+  // anchors step and generateAnchoredAlternatives both need them).
+  includeStructural: true
 };
 var PROBE_GLOBAL = "__piwiProbeElement";
 var PROBE_INIT_SCRIPT = `(() => {
@@ -7737,15 +8099,18 @@ var PROBE_INIT_SCRIPT = `(() => {
 var PROBE_UNSEEDED_PAGES = /* @__PURE__ */ new WeakSet();
 function probeElement(page, target) {
   const shipSource = () => target.evaluate(probeElementAttrs, CAPTURED_ATTRS_ARG);
-  if (!page || PROBE_UNSEEDED_PAGES.has(page)) return shipSource();
-  return target.evaluate((el, name) => {
-    const seeded = globalThis[name];
-    return typeof seeded === "function" ? seeded(el) : null;
-  }, PROBE_GLOBAL).then((attrs) => {
-    if (attrs) return attrs;
-    PROBE_UNSEEDED_PAGES.add(page);
-    return shipSource();
-  });
+  if (!page || PROBE_UNSEEDED_PAGES.has(page)) return internalCall(page, shipSource);
+  return internalCall(
+    page,
+    () => target.evaluate((el, name) => {
+      const seeded = globalThis[name];
+      return typeof seeded === "function" ? seeded(el) : null;
+    }, PROBE_GLOBAL).then((attrs) => {
+      if (attrs) return attrs;
+      PROBE_UNSEEDED_PAGES.add(page);
+      return shipSource();
+    })
+  );
 }
 async function ariaSnapshotBestEffort(target, timeout) {
   if (typeof target.ariaSnapshot !== "function") return null;
@@ -7796,7 +8161,7 @@ function startElementCapture(sink, page, target, seq, callerLocation, used) {
       const role = resolveAriaRole({ ...attrs, accessibleName: null });
       const isFormField = FORM_FIELD_TAGS.has(attrs.tagName);
       const exactName = exactAccessibleName(attrs, role);
-      const aria = exactName === null && (role || isFormField) ? await ariaSnapshotBestEffort(target, 500) : null;
+      const aria = exactName === null && (role || isFormField) ? await internalCall(page, () => ariaSnapshotBestEffort(target, 500)) : null;
       const accessibleName = exactName ?? (extractAccessibleName(aria) || approximateAccessibleName({ ...attrs, accessibleName: null }));
       sink.capturedLocators[seq] = {
         location: callerLocation,
@@ -7824,15 +8189,23 @@ function startElementCapture(sink, page, target, seq, callerLocation, used) {
   })();
   sink.capturePromises.push(resolveAttrs);
 }
+function callMethod(target, prop, args) {
+  return target[prop](...args);
+}
+function recordLocatorPage(sink, page, locator, location, arrival) {
+  try {
+    sink.locatorPages.record({ location, locator: String(locator), url: page.url(), arrival });
+  } catch {
+  }
+}
 function wrapLocator(page, locator, originMethod, originArgs) {
   return new Proxy(locator, {
     get(target, prop) {
       const original = Reflect.get(target, prop);
       if (typeof original !== "function") return original;
-      const fn = original;
       if (CHAIN_METHOD_SET.has(prop)) {
         return (...args) => {
-          const next = fn.apply(target, args);
+          const next = callMethod(target, prop, args);
           if (LOCATOR_CREATING_CHAINS.has(prop)) {
             return wrapLocator(page, next, String(prop), args);
           }
@@ -7844,11 +8217,12 @@ function wrapLocator(page, locator, originMethod, originArgs) {
           const sink = currentSink;
           const expression = typeof callArgs[0] === "string" ? callArgs[0] : "";
           const isNot = Boolean(callArgs[1]?.isNot);
+          const callerLocation = sink ? captureCallerLocation() : null;
+          if (sink) recordLocatorPage(sink, page, target, callerLocation, noteLocatorCall(page, EXPECT_METHOD, true));
           if (!sink || isNot || !EXPECT_CAPTURE_EXPRESSIONS.has(expression)) {
-            return fn.apply(target, callArgs);
+            return callMethod(target, prop, callArgs);
           }
           sink.lastActivePage = page;
-          const callerLocation = captureCallerLocation();
           const used = {
             method: originMethod,
             args: originArgs,
@@ -7860,7 +8234,7 @@ function wrapLocator(page, locator, originMethod, originArgs) {
             seq = sink.capturedLocators.length;
             sink.capturedLocators.push({ location: callerLocation, used, element: null, alternatives: [] });
           }
-          const result = await fn.apply(target, callArgs);
+          const result = await callMethod(target, prop, callArgs);
           const matches = result?.matches;
           if (matches === true && !alreadyProbed) {
             if (callerLocation) sink.probedLocations.add(callerLocation);
@@ -7874,9 +8248,10 @@ function wrapLocator(page, locator, originMethod, originArgs) {
       if (!ACTION_METHOD_SET.has(prop)) return original;
       return async (...callArgs) => {
         const sink = currentSink;
-        if (!sink) return fn.apply(target, callArgs);
+        if (!sink) return callMethod(target, prop, callArgs);
         sink.lastActivePage = page;
         const callerLocation = captureCallerLocation();
+        recordLocatorPage(sink, page, target, callerLocation, noteLocatorCall(page, String(prop)));
         const used = {
           method: originMethod,
           args: originArgs,
@@ -7895,7 +8270,7 @@ function wrapLocator(page, locator, originMethod, originArgs) {
         }
         let result;
         try {
-          result = await fn.apply(target, callArgs);
+          result = await callMethod(target, prop, callArgs);
         } catch (error) {
           sink.failedLocators.push({ method: originMethod, args: originArgs, location: callerLocation });
           throw error;
@@ -7914,11 +8289,10 @@ function wrapFrameLocator(page, frameLocator) {
     get(target, prop) {
       const original = Reflect.get(target, prop);
       if (typeof original !== "function") return original;
-      const fn = original;
       if (!LOCATOR_METHOD_SET.has(prop)) return original;
       return (...args) => {
         if (currentSink) currentSink.lastActivePage = page;
-        return wrapLocator(page, fn.apply(target, args), String(prop), args);
+        return wrapLocator(page, callMethod(target, prop, args), String(prop), args);
       };
     }
   });
@@ -7965,7 +8339,13 @@ function instrumentPage(page) {
       };
     }
     if (typeof page.on === "function") {
-      page.on("framenavigated", () => PROBE_UNSEEDED_PAGES.delete(page));
+      page.on("framenavigated", (frame) => {
+        PROBE_UNSEEDED_PAGES.delete(page);
+        try {
+          if (frame === page.mainFrame()) noteNavigation(page);
+        } catch {
+        }
+      });
     }
   }
   if (typeof page.on === "function" && process.env.PIWI_CAPTURE_PAGE_INVENTORY === "true") {
@@ -8104,6 +8484,12 @@ function patchBrowser(browser) {
     };
   }
 }
+function readRootAria(page) {
+  return internalCall(page, () => ariaSnapshotBestEffort(page.locator(":root")));
+}
+function readRootAriaJson(page) {
+  return internalCall(page, () => ariaSnapshotJSONBestEffort(page.locator(":root")));
+}
 async function flushSink(sink, testInfo) {
   await Promise.allSettled(sink.pendingHandlers);
   let drainDeadline;
@@ -8126,15 +8512,21 @@ async function flushSink(sink, testInfo) {
       body: Buffer.from(JSON.stringify(dedupeSnapshotsByLocation(sink.capturedLocators)))
     });
   }
+  if (sink.locatorPages.size > 0) {
+    await testInfo.attach(ATTACHMENT_NAMES.locatorPages, {
+      contentType: "application/json",
+      body: Buffer.from(JSON.stringify(sink.locatorPages.list()))
+    });
+  }
   if (testInfo.status !== "passed" && testInfo.status !== "skipped") {
     try {
-      const snapshot = (pageReadable ? await ariaSnapshotBestEffort(page.locator(":root")) : null) ?? sink.stashedAria;
+      const snapshot = (pageReadable ? await readRootAria(page) : null) ?? sink.stashedAria;
       if (snapshot) {
         await testInfo.attach(ATTACHMENT_NAMES.ariaSnapshot, {
           contentType: "text/plain",
           body: snapshot
         });
-        const snapshotJson = (pageReadable ? await ariaSnapshotJSONBestEffort(page.locator(":root")) : null) ?? sink.stashedAriaJson;
+        const snapshotJson = (pageReadable ? await readRootAriaJson(page) : null) ?? sink.stashedAriaJson;
         if (snapshotJson) {
           await testInfo.attach(ATTACHMENT_NAMES.ariaSnapshotJson, {
             contentType: "application/json",
@@ -8159,13 +8551,13 @@ async function flushSink(sink, testInfo) {
   }
   if (testInfo.status === "passed" && process.env.PIWI_SAMPLE_ARIA_ON_PASS !== "false" && isDueForAriaSample(testInfo)) {
     try {
-      const snapshot = (pageReadable ? await ariaSnapshotBestEffort(page.locator(":root")) : null) ?? sink.stashedAria;
+      const snapshot = (pageReadable ? await readRootAria(page) : null) ?? sink.stashedAria;
       if (snapshot) {
         await testInfo.attach(ATTACHMENT_NAMES.ariaSnapshot, {
           contentType: "text/plain",
           body: snapshot
         });
-        const snapshotJson = (pageReadable ? await ariaSnapshotJSONBestEffort(page.locator(":root")) : null) ?? sink.stashedAriaJson;
+        const snapshotJson = (pageReadable ? await readRootAriaJson(page) : null) ?? sink.stashedAriaJson;
         if (snapshotJson) {
           await testInfo.attach(ATTACHMENT_NAMES.ariaSnapshotJson, {
             contentType: "application/json",
@@ -8211,7 +8603,7 @@ async function flushSink(sink, testInfo) {
       body: Buffer.from(JSON.stringify(sink.networkRequests))
     });
   }
-  const webVitals = (pageReadable ? await readWebVitals(page) : null) ?? sink.stashedWebVitals;
+  const webVitals = (pageReadable ? await internalCall(page, () => readWebVitals(page)) : null) ?? sink.stashedWebVitals;
   if (webVitals) {
     await testInfo.attach(ATTACHMENT_NAMES.webVitals, {
       contentType: "application/json",
@@ -8219,7 +8611,7 @@ async function flushSink(sink, testInfo) {
     });
   }
   if (process.env.PIWI_CAPTURE_PAGE_STATE !== "false") {
-    const pageState = (pageReadable ? await readPageState(page) : null) ?? sink.stashedPageState;
+    const pageState = (pageReadable ? await internalCall(page, () => readPageState(page)) : null) ?? sink.stashedPageState;
     if (pageState) {
       await testInfo.attach(ATTACHMENT_NAMES.pageState, {
         contentType: "application/json",
@@ -8260,6 +8652,7 @@ var piwiFixtures = {
   // requested, so suites that never destructure `page` are still captured.
   piwiCapture: [
     async ({}, use, testInfo) => {
+      boxCaptureFrames();
       const sink = createSink();
       sink.testInfo = testInfo;
       if (isProbeMode())
@@ -8304,12 +8697,12 @@ function extendPiwiFixtures(test) {
 
 // src/internal/ai/ai-fixtures.ts
 var fs18 = __toESM(require("fs"));
-var path22 = __toESM(require("path"));
+var path23 = __toESM(require("path"));
 var import_test = require("@playwright/test");
 
 // src/internal/ai/artifact.ts
 var fs17 = __toESM(require("fs"));
-var path20 = __toESM(require("path"));
+var path21 = __toESM(require("path"));
 var ARTIFACT_VERSION = 1;
 var LOCATOR_METHOD_SET2 = new Set(LOCATOR_METHODS);
 var ACTION_METHOD_SET2 = new Set(ACTION_METHODS);
@@ -8413,7 +8806,7 @@ function writeEntry(file, entry) {
   const canonical = serializeEntry(entry);
   return withEntryLock(file, () => {
     if (fs17.existsSync(file) && fs17.readFileSync(file, "utf8") === canonical) return { written: false };
-    fs17.mkdirSync(path20.dirname(file), { recursive: true });
+    fs17.mkdirSync(path21.dirname(file), { recursive: true });
     const tmp = `${file}.${process.pid}.tmp`;
     fs17.writeFileSync(tmp, canonical);
     fs17.renameSync(tmp, file);
@@ -8422,7 +8815,7 @@ function writeEntry(file, entry) {
 }
 function withEntryLock(file, fn) {
   const lock = `${file}.lock`;
-  fs17.mkdirSync(path20.dirname(file), { recursive: true });
+  fs17.mkdirSync(path21.dirname(file), { recursive: true });
   const deadline = Date.now() + 5e3;
   for (; ; ) {
     try {
@@ -8451,7 +8844,7 @@ function withEntryLock(file, fn) {
 
 // src/internal/ai/keys.ts
 var crypto3 = __toESM(require("crypto"));
-var path21 = __toESM(require("path"));
+var path22 = __toESM(require("path"));
 var DEFAULT_AI_DIR = "__piwi__";
 function normalizeTemplate(template) {
   return template.trim().replace(/\s+/g, " ").toLowerCase();
@@ -8465,13 +8858,13 @@ function slug(text, maxLength = 40) {
   return (base || "x").slice(0, maxLength).replace(/-+$/g, "") || "x";
 }
 function entryDir(specFile, dir = DEFAULT_AI_DIR) {
-  return path21.join(path21.dirname(specFile), dir, path21.basename(specFile));
+  return path22.join(path22.dirname(specFile), dir, path22.basename(specFile));
 }
 function entryPath(params) {
   const basis = `${normalizeTemplate(params.testTitle)}::${normalizeTemplate(params.template)}`;
   const hash = hashTemplate(basis, params.ordinal ?? 0);
   const name = `${slug(params.testTitle)}.${slug(params.template)}.${hash}.json`;
-  return path21.join(entryDir(params.specFile, params.dir), name);
+  return path22.join(entryDir(params.specFile, params.dir), name);
 }
 function parseLocation(location) {
   const match = /:(\d+):(\d+)$/.exec(location);
@@ -8925,7 +9318,7 @@ function testIdentity(testInfo) {
   return titles.length > 0 ? titles.join(" \u203A ") : testInfo.title;
 }
 function relativeToCwd(file) {
-  return path22.relative(process.cwd(), file).split(path22.sep).join("/");
+  return path23.relative(process.cwd(), file).split(path23.sep).join("/");
 }
 function recordIntents(intents, entry) {
   const add = (locator, kind) => {