@piwitests/reporter 0.47.0 → 0.49.0

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

@@ -57,7 +57,7 @@ __export(capture_fixtures_exports, {
   stopResourceLedger: () => stopResourceLedger
 });
 module.exports = __toCommonJS(capture_fixtures_exports);
-var path12 = __toESM(require("path"));
+var path13 = __toESM(require("path"));
 var import_node_zlib2 = require("zlib");
 
 // ../picker-dom/src/probe.ts
@@ -1120,6 +1120,83 @@ function showPickerChoices(arg) {
   doc.body.appendChild(wrap);
 }
 
+// ../picker-dom/src/overlay-pause.ts
+function showPauseBar(arg) {
+  const g = globalThis;
+  const doc = g.document;
+  delete g.__piwiPauseState;
+  if (!doc || !doc.body) {
+    g.__piwiPauseState = "resume";
+    return;
+  }
+  if (typeof g.__piwiPauseCleanup === "function") g.__piwiPauseCleanup();
+  const Z = 2147483600;
+  const bar = doc.createElement("div");
+  bar.id = "__piwi-pause-bar";
+  bar.setAttribute("role", "toolbar");
+  bar.setAttribute("aria-label", "Piwi: test paused");
+  bar.style.cssText = `position:fixed;top:0;left:0;right:0;z-index:${Z + 4};display:flex;align-items:center;gap:12px;flex-wrap:wrap;padding:8px 12px;background:#111827;color:#f9fafb;border-bottom:2px solid #a78bfa;box-shadow:0 4px 20px rgba(0,0,0,.35);font:13px/1.5 system-ui,sans-serif;`;
+  const where = doc.createElement("div");
+  where.style.cssText = "font-weight:600;white-space:nowrap;";
+  where.textContent = `Paused at ${arg.place}${arg.attempt ? ` \xB7 attempt ${arg.attempt}` : ""}`;
+  const what = doc.createElement("code");
+  what.style.cssText = "flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;color:#d8b4fe;font:12px/1.5 ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;";
+  what.textContent = arg.locator ? `${arg.action} \xB7 ${arg.locator}` : arg.action;
+  what.title = what.textContent;
+  bar.appendChild(where);
+  bar.appendChild(what);
+  const done = (choice) => {
+    cleanup();
+    g.__piwiPauseState = choice;
+  };
+  const onKey = (e) => {
+    if (e.key !== "Escape") return;
+    e.preventDefault();
+    e.stopImmediatePropagation();
+    done("resume");
+  };
+  const cleanup = () => {
+    doc.removeEventListener("keydown", onKey, true);
+    bar.remove();
+    delete g.__piwiPauseCleanup;
+  };
+  const buttons = [
+    ["Resume", "resume", "Run on to the next breakpoint (Esc)", true],
+    ["Step", "step", "Pause again at the next action", false],
+    ["Pick a locator", "pick", "Pick an element on the page and confirm a locator for it", false],
+    ["Finish", "finish", "Run on and pause no more in this test", false]
+  ];
+  for (const [label, choice, hint, primary] of buttons) {
+    const btn = doc.createElement("button");
+    btn.type = "button";
+    btn.textContent = label;
+    btn.title = hint;
+    btn.style.cssText = "border-radius:6px;padding:4px 12px;cursor:pointer;font:600 12px/1.5 system-ui,sans-serif;" + (primary ? "background:#7c3aed;color:#fff;border:1px solid #7c3aed;" : "background:#1f2937;color:#f3f4f6;border:1px solid #374151;");
+    btn.addEventListener("click", (e) => {
+      e.preventDefault();
+      e.stopImmediatePropagation();
+      done(choice);
+    });
+    bar.appendChild(btn);
+  }
+  g.__piwiPauseCleanup = cleanup;
+  doc.addEventListener("keydown", onKey, true);
+  doc.body.appendChild(bar);
+}
+function pauseAnswered() {
+  const g = globalThis;
+  if (g.__piwiPauseState !== void 0) return true;
+  return !g.document?.getElementById("__piwi-pause-bar");
+}
+function takePauseState() {
+  const g = globalThis;
+  const state = g.__piwiPauseState;
+  if (typeof g.__piwiPauseCleanup === "function") g.__piwiPauseCleanup();
+  delete g.__piwiPauseCleanup;
+  delete g.__piwiPauseState;
+  return typeof state === "string" ? state : null;
+}
+
 // ../core/src/locator-generation.ts
 var TAG_TO_ROLE = {
   a: "link",
@@ -2035,8 +2112,8 @@ function inventoryPageKey(url) {
 // ../core/src/page-key.ts
 function normalizeRoute(url) {
   try {
-    const parsed = new URL(url);
-    let pathname = parsed.pathname;
+    const parsed2 = new URL(url);
+    let pathname = parsed2.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");
@@ -2044,8 +2121,8 @@ function normalizeRoute(url) {
     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);
+    if (parsed2.search) {
+      const params = new URLSearchParams(parsed2.search);
       const redacted = new URLSearchParams();
       for (const [key] of params) {
         redacted.set(key, "<redacted>");
@@ -2158,7 +2235,7 @@ var DEFAULTS = {
   defaultCapture: true,
   checkBaseUrl: false,
   streaming: true,
-  streamingBatchSize: 5,
+  streamingBatchSize: 20,
   streamingBatchDelay: 2e3,
   maxStreamBufferBytes: 100 * 1024 * 1024,
   submitTimeout: 15 * 60 * 1e3,
@@ -2212,6 +2289,10 @@ var PIWI_ENV_KEYS = {
   aiResponseWaitTimeout: "PIWI_AI_RESPONSE_WAIT_TIMEOUT",
   aiScreenshotFallback: "PIWI_AI_SCREENSHOT_FALLBACK"
 };
+var PIWI_LOCAL_DEBUG_ENV = {
+  pauseAt: "PIWI_PAUSE_AT",
+  editorSend: "PIWI_EDITOR_SEND"
+};
 var PIWI_PROBE_ENV = {
   flag: "PIWI_PROBE",
   plan: "PIWI_PROBE_PLAN",
@@ -2265,8 +2346,8 @@ function parseRouteKey(routeKey2) {
   return { method: routeKey2.slice(0, space).toUpperCase(), pattern: routeKey2.slice(space + 1) };
 }
 function patternToRegex(pattern) {
-  const path13 = pattern.split("?")[0] ?? pattern;
-  const escaped = path13.replace(/[.*+?^${}()|[\]\\]/g, "\\$&").replace(/:[A-Za-z0-9_]+/g, "[^/]+");
+  const path14 = pattern.split("?")[0] ?? pattern;
+  const escaped = path14.replace(/[.*+?^${}()|[\]\\]/g, "\\$&").replace(/:[A-Za-z0-9_]+/g, "[^/]+");
   return new RegExp(`^${escaped}$`);
 }
 function suitePathEqual(a, b) {
@@ -2289,13 +2370,13 @@ function matchProbeItem(plan, test) {
 function requestMatchesRoute(method, url, routeKey2) {
   const { method: rm, pattern } = parseRouteKey(routeKey2);
   if (rm && rm !== method.toUpperCase()) return false;
-  let path13;
+  let path14;
   try {
-    path13 = new URL(url).pathname;
+    path14 = new URL(url).pathname;
   } catch {
-    path13 = url.split("?")[0] ?? url;
+    path14 = url.split("?")[0] ?? url;
   }
-  return patternToRegex(pattern).test(path13);
+  return patternToRegex(pattern).test(path14);
 }
 function createProbeState() {
   return { navigated: false, matches: 0 };
@@ -2317,10 +2398,10 @@ function isProbeMode() {
 function loadPlan() {
   if (planCache !== void 0) return planCache;
   planCache = null;
-  const path13 = process.env[PIWI_PROBE_ENV.plan];
-  if (path13) {
+  const path14 = process.env[PIWI_PROBE_ENV.plan];
+  if (path14) {
     try {
-      planCache = JSON.parse(fs2.readFileSync(path13, "utf8"));
+      planCache = JSON.parse(fs2.readFileSync(path14, "utf8"));
     } catch {
       planCache = null;
     }
@@ -2342,10 +2423,10 @@ function outcomeFromStatus(status, applied) {
   return status === "failed" || status === "timedOut" || status === "interrupted" ? "noticed" : "not-noticed";
 }
 function recordProbeOutcome(line) {
-  const path13 = process.env[PIWI_PROBE_ENV.results];
-  if (!path13) return;
+  const path14 = process.env[PIWI_PROBE_ENV.results];
+  if (!path14) return;
   try {
-    fs2.appendFileSync(path13, `${JSON.stringify(line)}
+    fs2.appendFileSync(path14, `${JSON.stringify(line)}
 `);
   } catch {
   }
@@ -2376,24 +2457,24 @@ function faultRouteAction(fault) {
   return fault === "slow" ? { kind: "delay", ms: SLOW_FAULT_DELAY_MS } : null;
 }
 function dropOneField(body) {
-  let parsed;
+  let parsed2;
   try {
-    parsed = JSON.parse(body);
+    parsed2 = JSON.parse(body);
   } catch {
     return body;
   }
-  if (Array.isArray(parsed)) {
+  if (Array.isArray(parsed2)) {
     let key;
-    for (const el of parsed) {
+    for (const el of parsed2) {
       if (el && typeof el === "object" && !Array.isArray(el)) {
         key ??= Object.keys(el)[0];
         if (key) delete el[key];
       }
     }
-    return JSON.stringify(parsed);
+    return JSON.stringify(parsed2);
   }
-  if (parsed && typeof parsed === "object") {
-    const obj = parsed;
+  if (parsed2 && typeof parsed2 === "object") {
+    const obj = parsed2;
     const key = Object.keys(obj)[0];
     if (key) delete obj[key];
     return JSON.stringify(obj);
@@ -3391,11 +3472,11 @@ function deriveFailedLocator(testInfo) {
 ${err.stack ?? ""}`.replace(ANSI_RE2, "");
     const line = /^\s*Locator:\s*(.+)$/m.exec(text);
     if (!line) continue;
-    const parsed = parseLeafLocatorExpression(line[1].trim());
-    if (!parsed) continue;
+    const parsed2 = parseLeafLocatorExpression(line[1].trim());
+    if (!parsed2) continue;
     const loc = err.location;
     const location = loc ? `${path5.relative(process.cwd(), loc.file).split(path5.sep).join("/")}:${loc.line}:${loc.column}` : null;
-    return { method: parsed.method, args: parsed.args, location };
+    return { method: parsed2.method, args: parsed2.args, location };
   }
   return null;
 }
@@ -3417,25 +3498,16 @@ async function cleanupPicker(page) {
   } catch {
   }
 }
-async function runLocatorPicker(page, testInfo, failed, probe) {
+async function pickLocator(page, probe, failing) {
   try {
-    testInfo.setTimeout(0);
-    const rendered = failed ? renderFailing(failed) : null;
-    console.log(
-      `
-[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).`
-    );
-    const overlayArg = { transport: "global", failing: rendered };
+    const overlayArg = { transport: "global", failing };
     await page.evaluate(installPickerOverlay, overlayArg);
     await page.waitForFunction(() => globalThis.__piwiPickState !== void 0, void 0, {
       timeout: 0,
       polling: 250
     });
     const state = await page.evaluate(() => globalThis.__piwiPickState);
-    if (state !== "picked") {
-      await cleanupPicker(page);
-      return null;
-    }
+    if (state !== "picked") return null;
     const handle = await page.evaluateHandle(() => globalThis.__piwiPickedElement);
     const attrs = await handle.evaluate(probe.fn, probe.arg);
     await handle.dispose();
@@ -3473,11 +3545,10 @@ async function runLocatorPicker(page, testInfo, failed, probe) {
     );
     if (ranked.length === 0) {
       console.log("[piwi] No stable locator could be generated for the picked element \u2014 nothing recorded.");
-      await cleanupPicker(page);
       return null;
     }
     await page.evaluate(showPickerChoices, {
-      failing: rendered,
+      failing,
       choices: ranked.map((r) => ({ locator: r.locator, score: r.score }))
     });
     await page.waitForFunction(() => globalThis.__piwiPickChoice !== void 0, void 0, {
@@ -3485,31 +3556,45 @@ async function runLocatorPicker(page, testInfo, failed, probe) {
       polling: 250
     });
     const choice = await page.evaluate(() => globalThis.__piwiPickChoice);
-    await cleanupPicker(page);
     if (typeof choice !== "number" || choice < 0 || choice >= ranked.length) return null;
     const picked = { ...ranked[choice], pickedByUser: true };
-    const alternatives = [picked, ...ranked.filter((_, i) => i !== choice)];
-    const element = {
-      tagName: attrs.tagName,
-      attributes: attrs.attributes,
-      textContent: attrs.textContent,
-      accessibleName,
-      center: attrs.center,
-      ...attrs.rolePosition ? { rolePosition: attrs.rolePosition } : {},
-      ...attrs.ancestors && attrs.ancestors.length > 0 ? { ancestors: attrs.ancestors } : {}
+    return {
+      picked,
+      alternatives: [picked, ...ranked.filter((_, i) => i !== choice)],
+      element: {
+        tagName: attrs.tagName,
+        attributes: attrs.attributes,
+        textContent: attrs.textContent,
+        accessibleName,
+        center: attrs.center,
+        ...attrs.rolePosition ? { rolePosition: attrs.rolePosition } : {},
+        ...attrs.ancestors && attrs.ancestors.length > 0 ? { ancestors: attrs.ancestors } : {}
+      },
+      ...anchors.length > 0 ? { anchors } : {}
     };
+  } finally {
+    await cleanupPicker(page);
+  }
+}
+async function runLocatorPicker(page, testInfo, failed, probe) {
+  try {
+    testInfo.setTimeout(0);
+    const rendered = failed ? renderFailing(failed) : null;
+    console.log(
+      `
+[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).`
+    );
+    const pick = await pickLocator(page, probe, rendered);
+    if (!pick) return null;
     const location = failed?.location ?? null;
     console.log(
       failed ? `[piwi] Replacement picked for ${rendered}${location ? ` at ${location}` : ""}:
-[piwi]   ${picked.locator}` : `[piwi] Locator picked while inspecting:
-[piwi]   ${picked.locator}`
+[piwi]   ${pick.picked.locator}` : `[piwi] Locator picked while inspecting:
+[piwi]   ${pick.picked.locator}`
     );
     return {
       failing: failed ? { method: failed.method, args: failed.args, rendered, location } : null,
-      picked,
-      alternatives,
-      element,
-      ...anchors.length > 0 ? { anchors } : {}
+      ...pick
     };
   } catch {
     return null;
@@ -3542,8 +3627,205 @@ function applyPickToSnapshots(snapshots, pick) {
   return true;
 }
 
-// src/internal/support/aria-sampling.ts
+// src/internal/capture/pause-at.ts
 var path6 = __toESM(require("path"));
+
+// ../core/src/editor-send.ts
+var LOOPBACK_HOSTS = /* @__PURE__ */ new Set(["127.0.0.1", "localhost", "[::1]"]);
+function parsePairing(text) {
+  const trimmed = text.trim();
+  const hash = trimmed.indexOf("#");
+  if (hash < 0) return null;
+  const url = trimmed.slice(0, hash);
+  const token = trimmed.slice(hash + 1);
+  if (!/^[A-Za-z0-9_-]{16,}$/.test(token)) return null;
+  let parsed2;
+  try {
+    parsed2 = new URL(url);
+  } catch {
+    return null;
+  }
+  if (parsed2.protocol !== "http:" || !LOOPBACK_HOSTS.has(parsed2.hostname) || !parsed2.port) return null;
+  return { url: `${parsed2.origin}${parsed2.pathname}`, token };
+}
+function isInsidePath(file) {
+  if (!file || file.length > 1e3 || file.includes("\0")) return false;
+  if (file.startsWith("/") || file.startsWith("\\") || /^[A-Za-z]:/.test(file)) return false;
+  return file.split(/[\\/]/).every((part) => part !== "..");
+}
+
+// src/internal/capture/pause-at.ts
+var PauseSet = class {
+  constructor(lines) {
+    this.lines = lines;
+  }
+  get size() {
+    return this.lines.size;
+  }
+  /** Whether a call site (`file:line:col`, as `captureCallerLocation` writes it) is on one of the lines. */
+  matches(callerLocation) {
+    if (!callerLocation) return false;
+    const col = callerLocation.lastIndexOf(":");
+    return col > 0 && this.lines.has(callerLocation.slice(0, col));
+  }
+};
+var EMPTY = new PauseSet(/* @__PURE__ */ new Set());
+function callSiteFile(file, cwd) {
+  const slashed = file.replace(/\\/g, "/");
+  const absolute = path6.isAbsolute(file) || path6.isAbsolute(slashed) || /^[A-Za-z]:\//.test(slashed);
+  let rel = absolute ? path6.relative(cwd, file) : path6.normalize(slashed);
+  rel = rel.split(path6.sep).join("/").replace(/\\/g, "/");
+  if (rel.startsWith("./")) rel = rel.slice(2);
+  return rel;
+}
+var ignoredLogged = /* @__PURE__ */ new Set();
+function parsePauseAt(value, cwd = process.cwd()) {
+  if (!value?.trim()) return EMPTY;
+  const lines = /* @__PURE__ */ new Set();
+  for (const raw of value.split(";")) {
+    const entry = raw.trim();
+    if (!entry) continue;
+    const m = /^(.+):(\d+)$/.exec(entry);
+    const line = m ? Number(m[2]) : 0;
+    if (!m?.[1] || line < 1) {
+      if (!ignoredLogged.has(entry)) {
+        ignoredLogged.add(entry);
+        console.log(`[piwi] ${PIWI_LOCAL_DEBUG_ENV.pauseAt}: ignoring "${entry}": expected file:line`);
+      }
+      continue;
+    }
+    lines.add(`${callSiteFile(m[1], cwd)}:${line}`);
+  }
+  return lines.size ? new PauseSet(lines) : EMPTY;
+}
+var parsed = null;
+function currentPauseSet() {
+  const value = process.env[PIWI_LOCAL_DEBUG_ENV.pauseAt];
+  if (!parsed || parsed.value !== value) parsed = { value, set: parsePauseAt(value) };
+  return parsed.set;
+}
+function pauseGateFromTestInfo(testInfo) {
+  const use = testInfo.project?.use ?? {};
+  return { ci: process.env.CI, headless: use.headless };
+}
+function pauseSkipReason(gate) {
+  if (isCi(gate.ci)) return "running under CI \u2014 breakpoints pause local runs only";
+  if (gate.headless !== false)
+    return "the browser is headless \u2014 re-run with --headed (or set use: { headless: false })";
+  return null;
+}
+function rearmedTimeout(before, pausedMs) {
+  return before > 0 ? before + Math.max(0, Math.round(pausedMs)) : 0;
+}
+function pausePlace(callerLocation) {
+  const col = callerLocation.lastIndexOf(":");
+  const fileLine = col > 0 ? callerLocation.slice(0, col) : callerLocation;
+  return fileLine.slice(fileLine.lastIndexOf("/") + 1);
+}
+function assertionLabel(expression, isNot) {
+  const [first = "", ...rest] = expression.split(".").filter(Boolean);
+  const name = first + rest.map((p) => p.charAt(0).toUpperCase() + p.slice(1)).join("");
+  return `${isNot ? "not." : ""}${name || "expect"}`;
+}
+function pickPlace(callerLocation) {
+  const m = /^(.+):(\d+):\d+$/.exec(callerLocation);
+  if (!m) return null;
+  const file = m[1];
+  if (!isInsidePath(file)) return null;
+  return { file, line: Number(m[2]) };
+}
+function pickPayload(locator, callerLocation) {
+  const at = pickPlace(callerLocation);
+  return at ? { kind: "locator", text: locator, at } : { kind: "locator", text: locator };
+}
+var postFailureLogged = false;
+async function postPickToEditor(pairingAddress, payload, fetchImpl = fetch) {
+  if (!pairingAddress) return false;
+  const logOnce = (why) => {
+    if (postFailureLogged) return;
+    postFailureLogged = true;
+    console.log(`[piwi] Could not send the picked locator to the editor: ${why}.`);
+  };
+  const pairing = parsePairing(pairingAddress);
+  if (!pairing) {
+    logOnce(`${PIWI_LOCAL_DEBUG_ENV.editorSend} is not a pairing address`);
+    return false;
+  }
+  try {
+    const response = await fetchImpl(pairing.url, {
+      method: "POST",
+      headers: { Authorization: `Bearer ${pairing.token}`, "Content-Type": "application/json" },
+      body: JSON.stringify(payload),
+      signal: AbortSignal.timeout(5e3)
+    });
+    if (response.ok) return true;
+    logOnce(`the editor answered ${response.status}`);
+  } catch (error) {
+    logOnce(error instanceof Error ? error.message : String(error));
+  }
+  return false;
+}
+var skipLogged = false;
+function logPauseSkipOnce(reason) {
+  if (skipLogged) return;
+  skipLogged = true;
+  console.log(`[piwi] ${PIWI_LOCAL_DEBUG_ENV.pauseAt} is set but breakpoints are skipped: ${reason}`);
+}
+var HIGHLIGHT_MS = 2e3;
+async function pauseHere(page, testInfo, point, probe, onPick) {
+  const before = testInfo.timeout;
+  const started = Date.now();
+  let shown = null;
+  try {
+    testInfo.setTimeout(0);
+    const highlight = point.target?.highlight;
+    if (typeof highlight === "function") {
+      let timer;
+      shown = await Promise.race([
+        Promise.resolve().then(() => highlight.call(point.target)).catch(() => null),
+        new Promise((resolve3) => {
+          timer = setTimeout(() => resolve3(null), HIGHLIGHT_MS);
+        })
+      ]);
+      clearTimeout(timer);
+    }
+    const arg = {
+      place: pausePlace(point.location),
+      attempt: testInfo.retry > 0 ? testInfo.retry + 1 : null,
+      action: point.action,
+      locator: point.locator
+    };
+    console.log(
+      `[piwi] Paused at ${point.location} before ${point.locator ? `${point.action} \xB7 ${point.locator}` : point.action}: Resume, Step, Pick a locator or Finish in the browser (Esc resumes).`
+    );
+    for (; ; ) {
+      await page.evaluate(showPauseBar, arg);
+      await page.waitForFunction(pauseAnswered, void 0, { timeout: 0, polling: 250 });
+      const choice = await page.evaluate(takePauseState);
+      if (choice === "resume" || choice === "step" || choice === "finish") return choice;
+      if (choice !== "pick") continue;
+      const picked = await pickLocator(page, probe, null).catch(() => null);
+      if (picked) await onPick(picked);
+    }
+  } catch {
+    return "resume";
+  } finally {
+    try {
+      const dispose = shown?.dispose;
+      const hide = page.hideHighlight;
+      if (typeof dispose === "function") await dispose.call(shown);
+      else if (typeof hide === "function") await hide.call(page);
+    } catch {
+    }
+    try {
+      testInfo.setTimeout(rearmedTimeout(before, Date.now() - started));
+    } catch {
+    }
+  }
+}
+
+// src/internal/support/aria-sampling.ts
+var path7 = __toESM(require("path"));
 var os3 = __toESM(require("os"));
 var fs4 = __toESM(require("fs"));
 
@@ -3559,7 +3841,7 @@ function ariaSampleIdentity(filePath, title) {
   return `${filePath}\0${title}`;
 }
 function getAriaSampleFilePath(projectName) {
-  return path6.join(os3.tmpdir(), `piwi-dashboard-aria-sample-${hashForProject(projectName)}.json`);
+  return path7.join(os3.tmpdir(), `piwi-dashboard-aria-sample-${hashForProject(projectName)}.json`);
 }
 var cachedSets = /* @__PURE__ */ new Map();
 function loadAriaSampleSet(projectName) {
@@ -3567,9 +3849,9 @@ function loadAriaSampleSet(projectName) {
   let set = null;
   try {
     const raw = fs4.readFileSync(getAriaSampleFilePath(projectName), "utf8");
-    const parsed = JSON.parse(raw);
-    if (parsed.projectName === projectName && Array.isArray(parsed.identities)) {
-      set = new Set(parsed.identities.filter((x) => typeof x === "string"));
+    const parsed2 = JSON.parse(raw);
+    if (parsed2.projectName === projectName && Array.isArray(parsed2.identities)) {
+      set = new Set(parsed2.identities.filter((x) => typeof x === "string"));
     }
   } catch {
     set = null;
@@ -3578,7 +3860,7 @@ function loadAriaSampleSet(projectName) {
   return set;
 }
 function relativeTestFile2(file) {
-  return path6.relative(process.cwd(), file).split(path6.sep).join("/");
+  return path7.relative(process.cwd(), file).split(path7.sep).join("/");
 }
 function isDueForAriaSample(testInfo) {
   const projectName = process.env.PIWI_PROJECT_NAME;
@@ -3590,20 +3872,20 @@ function isDueForAriaSample(testInfo) {
 
 // src/internal/capture/quiet-capture.ts
 var import_node_module = require("module");
-var path8 = __toESM(require("path"));
+var path9 = __toESM(require("path"));
 
 // src/internal/support/reporter-version.ts
 var fs5 = __toESM(require("fs"));
-var path7 = __toESM(require("path"));
+var path8 = __toESM(require("path"));
 var CANDIDATE_OFFSETS = ["..", "../../.."];
 function findOwnPackageJson(fromDir) {
   for (const offset of CANDIDATE_OFFSETS) {
     try {
-      const pkgPath = path7.resolve(fromDir, offset, "package.json");
+      const pkgPath = path8.resolve(fromDir, offset, "package.json");
       const pkg = JSON.parse(fs5.readFileSync(pkgPath, "utf-8"));
       const { name, version } = pkg;
       if (name === "@piwitests/reporter" && typeof version === "string")
-        return { version, root: path7.dirname(pkgPath) };
+        return { version, root: path8.dirname(pkgPath) };
     } catch {
     }
   }
@@ -3647,7 +3929,7 @@ function resolveBoxing() {
       if (typeof set !== "function") continue;
       return {
         set,
-        prefixes: [path8.dirname(playwrightPackageJson), path8.join(root, "dist") + path8.sep]
+        prefixes: [path9.dirname(playwrightPackageJson), path9.join(root, "dist") + path9.sep]
       };
     }
   } catch {
@@ -3675,7 +3957,7 @@ function internalCall(owner, run) {
 // src/internal/capture/code-reach.ts
 var crypto2 = __toESM(require("crypto"));
 var fs6 = __toESM(require("fs"));
-var path9 = __toESM(require("path"));
+var path10 = __toESM(require("path"));
 var import_node_child_process = require("child_process");
 
 // ../core/src/source-map.ts
@@ -3938,12 +4220,12 @@ function repositoryRoot(from) {
     }).trim();
   } catch {
   }
-  cachedRepoRoot = { from, root: path9.resolve(root) };
+  cachedRepoRoot = { from, root: path10.resolve(root) };
   return cachedRepoRoot.root;
 }
 function codeReachRoots(configDir, configured) {
   const repoRoot = repositoryRoot(configDir);
-  const roots = configured?.length ? configured.map((r) => path9.resolve(configDir, r)) : [configDir];
+  const roots = configured?.length ? configured.map((r) => path10.resolve(configDir, r)) : [configDir];
   return { roots: [.../* @__PURE__ */ new Set([...roots, repoRoot])], repoRoot };
 }
 function isFile(file) {
@@ -3956,10 +4238,10 @@ function isFile(file) {
 function resolveSourcePath(source, roots) {
   const normalized = normalizeSourcePath(source);
   if (!normalized || /(?:^|\/)node_modules\//.test(normalized)) return null;
-  if (path9.isAbsolute(normalized) && isFile(normalized)) return path9.resolve(normalized);
-  const relative8 = normalized.replace(/^\/+/, "");
+  if (path10.isAbsolute(normalized) && isFile(normalized)) return path10.resolve(normalized);
+  const relative9 = normalized.replace(/^\/+/, "");
   for (const root of roots) {
-    const candidate = path9.resolve(root, relative8);
+    const candidate = path10.resolve(root, relative9);
     if (isFile(candidate)) return candidate;
   }
   return null;
@@ -3975,10 +4257,10 @@ function viteBases(entries) {
 function fileForUrl(url, roots, bases) {
   let pathname;
   try {
-    const parsed = new URL(url);
-    if (parsed.protocol !== "http:" && parsed.protocol !== "https:" && parsed.protocol !== "file:") return null;
-    pathname = parsed.pathname;
-    const base = bases.get(parsed.origin);
+    const parsed2 = new URL(url);
+    if (parsed2.protocol !== "http:" && parsed2.protocol !== "https:" && parsed2.protocol !== "file:") return null;
+    pathname = parsed2.pathname;
+    const base = bases.get(parsed2.origin);
     if (base && pathname.startsWith(base)) pathname = pathname.slice(base.length - 1);
   } catch {
     return null;
@@ -3991,7 +4273,7 @@ function fileForUrl(url, roots, bases) {
   return file;
 }
 function relativeToRepo(file, repoRoot) {
-  return path9.relative(repoRoot, file).split(path9.sep).join("/");
+  return path10.relative(repoRoot, file).split(path10.sep).join("/");
 }
 function scriptHash(entry) {
   return crypto2.createHash("sha1").update(entry.source ?? "").digest("hex");
@@ -4111,7 +4393,7 @@ async function stopCodeReach(page) {
 
 // src/internal/capture/resource-ledger.ts
 var fs8 = __toESM(require("fs"));
-var path11 = __toESM(require("path"));
+var path12 = __toESM(require("path"));
 var import_node_module2 = require("module");
 
 // src/internal/capture/worker-metrics.ts
@@ -4119,7 +4401,7 @@ var import_node_perf_hooks = require("perf_hooks");
 
 // src/internal/support/system-readers.ts
 var fs7 = __toESM(require("fs"));
-var path10 = __toESM(require("path"));
+var path11 = __toESM(require("path"));
 var CLK_TCK = 100;
 function readText(file) {
   try {
@@ -4205,7 +4487,7 @@ var ProcFs = class {
   }
   /** Whether this looks like a Linux `/proc` at all. */
   available() {
-    return fs7.existsSync(path10.join(this.root, "stat"));
+    return fs7.existsSync(path11.join(this.root, "stat"));
   }
   /** Every process, keyed by pid. */
   table() {
@@ -4218,32 +4500,32 @@ var ProcFs = class {
     }
     for (const name of names) {
       if (!/^\d+$/.test(name)) continue;
-      const text = readText(path10.join(this.root, name, "stat"));
+      const text = readText(path11.join(this.root, name, "stat"));
       const stat = text ? parseProcStat(Number(name), text) : null;
       if (stat) out.set(stat.pid, stat);
     }
     return out;
   }
   stat(pid) {
-    const text = readText(path10.join(this.root, String(pid), "stat"));
+    const text = readText(path11.join(this.root, String(pid), "stat"));
     return text ? parseProcStat(pid, text) : null;
   }
   runWaitMs(pid) {
-    const text = readText(path10.join(this.root, String(pid), "schedstat"));
+    const text = readText(path11.join(this.root, String(pid), "schedstat"));
     return text ? parseSchedstat(text) : null;
   }
   cmdline(pid) {
-    return (readText(path10.join(this.root, String(pid), "cmdline")) ?? "").split("\0").join(" ").trim();
+    return (readText(path11.join(this.root, String(pid), "cmdline")) ?? "").split("\0").join(" ").trim();
   }
   /** A field of `/proc/<pid>/status`, in kB: `VmRSS`, `VmHWM`. */
   statusKb(pid, key) {
-    const text = readText(path10.join(this.root, String(pid), "status"));
+    const text = readText(path11.join(this.root, String(pid), "status"));
     return text ? parseKbField(text, key) : null;
   }
   /** Proportional set size: shared pages split between the processes sharing them, so a sum counts them once. */
   async pssKb(pid) {
     try {
-      return parseKbField(await fs7.promises.readFile(path10.join(this.root, String(pid), "smaps_rollup"), "utf8"), "Pss");
+      return parseKbField(await fs7.promises.readFile(path11.join(this.root, String(pid), "smaps_rollup"), "utf8"), "Pss");
     } catch {
       return null;
     }
@@ -4251,29 +4533,29 @@ var ProcFs = class {
   /** Reset a process's peak RSS (`VmHWM`) to its current RSS. */
   resetPeakRss(pid) {
     try {
-      fs7.writeFileSync(path10.join(this.root, String(pid), "clear_refs"), "5");
+      fs7.writeFileSync(path11.join(this.root, String(pid), "clear_refs"), "5");
       return true;
     } catch {
       return false;
     }
   }
   cpuTicks() {
-    const text = readText(path10.join(this.root, "stat"));
+    const text = readText(path11.join(this.root, "stat"));
     return text ? parseCpuTicks(text) : null;
   }
   /** Total stall time of a resource's pressure file, in µs. */
   pressureUs(resource) {
-    const text = readText(path10.join(this.root, "pressure", resource));
+    const text = readText(path11.join(this.root, "pressure", resource));
     return text ? parsePsiTotal(text) : null;
   }
   memAvailableKb() {
-    const text = readText(path10.join(this.root, "meminfo"));
+    const text = readText(path11.join(this.root, "meminfo"));
     return text ? parseKbField(text, "MemAvailable") : null;
   }
   /** Open file descriptors of a process. */
   fdCount(pid) {
     try {
-      return fs7.readdirSync(path10.join(this.root, String(pid), "fd")).length;
+      return fs7.readdirSync(path11.join(this.root, String(pid), "fd")).length;
     } catch {
       return null;
     }
@@ -4435,10 +4717,10 @@ var PAGE_READ_TIMEOUT_MS = 1e3;
 var HOOK_PHASES = /* @__PURE__ */ new Set(["beforeAll", "afterAll", "beforeEach", "afterEach"]);
 var KIND_ORDER = { browser: 0, context: 1, page: 2, request: 3 };
 function relativePath(file) {
-  return path11.relative(process.cwd(), file.replace(/^file:\/\//, "")).split(path11.sep).join("/");
+  return path12.relative(process.cwd(), file.replace(/^file:\/\//, "")).split(path12.sep).join("/");
 }
 function isLibraryFile(file) {
-  return file.startsWith("node:") || file.startsWith("internal/") || file.includes(`${path11.sep}node_modules${path11.sep}`) || file.includes("/node_modules/") || file === __filename;
+  return file.startsWith("node:") || file.startsWith("internal/") || file.includes(`${path12.sep}node_modules${path12.sep}`) || file.includes("/node_modules/") || file === __filename;
 }
 function userSite(stack) {
   for (const line of (stack ?? "").split("\n").slice(1)) {
@@ -4486,7 +4768,7 @@ function playwrightTestInfoSource() {
   try {
     const packageJson = resolvePlaywrightPackageJson();
     if (!packageJson) return () => null;
-    const globals = (0, import_node_module2.createRequire)(packageJson)(path11.join(path11.dirname(packageJson), "lib", "globals.js"));
+    const globals = (0, import_node_module2.createRequire)(packageJson)(path12.join(path12.dirname(packageJson), "lib", "globals.js"));
     const read = globals.currentTestInfo;
     if (typeof read !== "function") return () => null;
     return () => {
@@ -5026,6 +5308,7 @@ function createSink() {
     flake: null,
     pickOffered: false,
     userPick: null,
+    pause: null,
     locatorPages: new LocatorPageLog(),
     codeReach: null
   };
@@ -5042,11 +5325,11 @@ function configuredCodeReachRoots() {
   const raw = process.env.PIWI_CODE_REACH_ROOTS?.trim();
   if (!raw) return null;
   try {
-    const parsed = JSON.parse(raw);
-    if (Array.isArray(parsed)) return parsed.filter((r) => typeof r === "string" && r !== "");
+    const parsed2 = JSON.parse(raw);
+    if (Array.isArray(parsed2)) return parsed2.filter((r) => typeof r === "string" && r !== "");
   } catch {
   }
-  return raw.split(path12.delimiter).filter(Boolean);
+  return raw.split(path13.delimiter).filter(Boolean);
 }
 async function stopSinkCodeReach(sink, closing) {
   const session = sink.codeReach;
@@ -5061,7 +5344,7 @@ async function stopSinkCodeReach(sink, closing) {
     if (!entries) return;
     const info = sink.testInfo;
     const configFile = info?.config.configFile;
-    const configDir = configFile ? path12.dirname(configFile) : info?.config.rootDir ?? process.cwd();
+    const configDir = configFile ? path13.dirname(configFile) : info?.config.rootDir ?? process.cwd();
     session.files = await resolveCodeReach(
       entries,
       codeReachRoots(configDir, configuredCodeReachRoots()),
@@ -5480,6 +5763,53 @@ function recordLocatorPage(sink, page, locator, location, arrival) {
   } catch {
   }
 }
+function pausesAt(pause, callerLocation) {
+  return !pause.finished && (pause.next || pause.set.matches(callerLocation));
+}
+function locatorSource(target, method, args) {
+  try {
+    const text = String(target);
+    if (text && !text.startsWith("[object")) return text;
+  } catch {
+  }
+  return renderFailing({ method, args });
+}
+async function pauseBefore(sink, page, target, callerLocation, action, origin) {
+  const pause = sink.pause;
+  const testInfo = sink.testInfo;
+  if (!pause || !testInfo || !callerLocation) return;
+  pause.next = false;
+  try {
+    const locator = locatorSource(target, origin.method, origin.args);
+    const onPick = async (picked) => {
+      const pick = {
+        failing: { method: origin.method, args: origin.args, rendered: locator, location: callerLocation },
+        ...picked
+      };
+      applyPickToSnapshots(sink.capturedLocators, pick);
+      sink.probedLocations.add(callerLocation);
+      const place = callerLocation.slice(0, callerLocation.lastIndexOf(":"));
+      console.log(`[piwi] Locator picked at ${place}: ${picked.picked.locator}`);
+      await postPickToEditor(
+        process.env[PIWI_LOCAL_DEBUG_ENV.editorSend],
+        pickPayload(picked.picked.locator, callerLocation)
+      );
+    };
+    const choice = await internalCall(
+      page,
+      () => pauseHere(
+        page,
+        testInfo,
+        { location: callerLocation, action, locator, target },
+        { fn: probeElementAttrs, arg: CAPTURED_ATTRS_ARG },
+        onPick
+      )
+    );
+    if (choice === "step") pause.next = true;
+    else if (choice === "finish") pause.finished = true;
+  } catch {
+  }
+}
 function wrapLocator(page, locator, originMethod, originArgs) {
   return new Proxy(locator, {
     get(target, prop) {
@@ -5501,6 +5831,12 @@ function wrapLocator(page, locator, originMethod, originArgs) {
           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?.pause && pausesAt(sink.pause, callerLocation)) {
+            await pauseBefore(sink, page, target, callerLocation, assertionLabel(expression, isNot), {
+              method: originMethod,
+              args: originArgs
+            });
+          }
           if (!sink || isNot || !EXPECT_CAPTURE_EXPRESSIONS.has(expression)) {
             return callMethod(target, prop, callArgs);
           }
@@ -5539,6 +5875,9 @@ function wrapLocator(page, locator, originMethod, originArgs) {
           args: originArgs,
           raw: `${originMethod}(${JSON.stringify(originArgs)})`
         };
+        if (sink.pause && pausesAt(sink.pause, callerLocation)) {
+          await pauseBefore(sink, page, target, callerLocation, String(prop), used);
+        }
         const alreadyProbed = callerLocation !== null && sink.probedLocations.has(callerLocation);
         let seq = -1;
         if (!alreadyProbed) {
@@ -5999,6 +6338,12 @@ var piwiFixtures = {
       if (conflict) throw new Error(conflict);
       const sink = createSink();
       sink.testInfo = testInfo;
+      const pauseSet = currentPauseSet();
+      if (pauseSet.size) {
+        const reason = pauseSkipReason(pauseGateFromTestInfo(testInfo));
+        if (reason) logPauseSkipOnce(reason);
+        else sink.pause = { set: pauseSet, next: false, finished: false };
+      }
       if (isFlakeMode()) {
         const plan = loadFlakePlan();
         const role = flakeRoleForTest(plan, {