@piwitests/reporter 0.24.0 → 0.26.0

package/dist/index.js

@@ -37,6 +37,7 @@ __export(index_exports, {
   extendPiwiFixtures: () => extendPiwiFixtures,
   piwiAiFixtures: () => piwiAiFixtures,
   piwiFixtures: () => piwiFixtures,
+  resolveSelection: () => resolveSelection,
   wrapConfig: () => wrapConfig
 });
 module.exports = __toCommonJS(index_exports);
@@ -79,6 +80,7 @@ var DEFAULTS = {
   streaming: true,
   streamingBatchSize: 5,
   streamingBatchDelay: 2e3,
+  failOnFlakyTests: false,
   username: null,
   password: null,
   apiKey: null,
@@ -98,6 +100,7 @@ var PIWI_ENV_KEYS = {
   streamingBatchSize: "PIWI_STREAMING_BATCH_SIZE",
   streamingBatchDelay: "PIWI_STREAMING_BATCH_DELAY",
   liveFileUploads: "PIWI_LIVE_FILE_UPLOADS",
+  failOnFlakyTests: "PIWI_FAIL_ON_FLAKY_TESTS",
   uploadTraces: "PIWI_UPLOAD_TRACES",
   uploadReport: "PIWI_UPLOAD_REPORT",
   captureLocators: "PIWI_CAPTURE_LOCATORS",
@@ -116,6 +119,12 @@ var PIWI_ENV_KEYS = {
   aiScreenshotFallback: "PIWI_AI_SCREENSHOT_FALLBACK"
 };
 var PIWI_DESKTOP_CONFIG_ENV = "PIWI_DESKTOP_CONFIG";
+var PIWI_SELECTION_ENV = {
+  key: "PIWI_SELECTION",
+  version: "PIWI_SELECTION_VERSION",
+  hash: "PIWI_SELECTION_HASH",
+  count: "PIWI_SELECTION_COUNT"
+};
 function readBool(val) {
   if (val === void 0) return void 0;
   return val === "true";
@@ -133,6 +142,7 @@ var ENV_FALLBACK_SPECS = [
   { option: "streamingBatchSize", env: PIWI_ENV_KEYS.streamingBatchSize, kind: "number" },
   { option: "streamingBatchDelay", env: PIWI_ENV_KEYS.streamingBatchDelay, kind: "number" },
   { option: "liveFileUploads", env: PIWI_ENV_KEYS.liveFileUploads, kind: "bool" },
+  { option: "failOnFlakyTests", env: PIWI_ENV_KEYS.failOnFlakyTests, kind: "bool" },
   { option: "uploadTraces", env: PIWI_ENV_KEYS.uploadTraces, kind: "bool" },
   { option: "uploadReport", env: PIWI_ENV_KEYS.uploadReport, kind: "bool" },
   { option: "captureLocators", env: PIWI_ENV_KEYS.captureLocators, kind: "bool" },
@@ -430,8 +440,8 @@ function resolveOverallStatus(result, counters) {
   const STATUS_MAP = {
     passed: "passed",
     failed: "failed",
-    timedout: "failed",
-    interrupted: "failed"
+    timedout: "timedout",
+    interrupted: "interrupted"
   };
   if (result?.status) return STATUS_MAP[result.status] ?? "failed";
   if (counters.failedTests === 0 && counters.timedOutTests === 0 && counters.totalTests > 0) return "passed";
@@ -448,6 +458,7 @@ function toWireTestCase(tc) {
     timeout: rest.timeout ?? null,
     error: rest.error,
     retries: rest.retries,
+    attempts: rest.attempts || null,
     workerIndex: rest.workerIndex ?? null,
     shardIndex: rest.shardIndex ?? null,
     startedAt: rest.startedAt ?? null,
@@ -470,7 +481,9 @@ function toWireTestCase(tc) {
     testAnnotations: rest.testAnnotations ?? null,
     tags: rest.tags ?? null,
     testMeta: rest.testMeta ?? null,
-    locatorSnapshots: rest.locatorSnapshots || null
+    locatorSnapshots: rest.locatorSnapshots || null,
+    didNotRunReason: rest.didNotRunReason ?? null,
+    blockedBy: rest.blockedBy ?? null
   };
 }
 function serializeRun(payload, opts) {
@@ -523,8 +536,8 @@ var Uploader = class {
       auth
     );
     this.logger.info(`Successfully uploaded test results`);
-    if (response.testRunId) {
-      this.logger.info(`Test Run ID: ${response.testRunId}, Project ID: ${response.projectId}`);
+    if (response.runId) {
+      this.logger.info(`Test Run ID: ${response.runId}, Project ID: ${response.projectId}`);
     }
     return response;
   }
@@ -538,8 +551,8 @@ var Uploader = class {
     await this.appendFilesToForm(form, payload.testCases, reportOptions.uploadTraces);
     const response = await this.httpClient.postFormData("/api/test-runs/upload", form, auth);
     this.logger.info(`Successfully uploaded test results with files`);
-    if (response.testRunId) {
-      this.logger.info(`Test Run ID: ${response.testRunId}, Project ID: ${response.projectId}`);
+    if (response.runId) {
+      this.logger.info(`Test Run ID: ${response.runId}, Project ID: ${response.projectId}`);
     }
     if (response.reports) {
       for (const r of response.reports) this.logger.info(`${r.label}: ${r.path}`);
@@ -549,7 +562,7 @@ var Uploader = class {
   /** Upload report files for an already-submitted streaming run */
   async uploadReportsForStreamingRun(projectName, runId, reportOptions, startTime, auth) {
     const form = new import_form_data2.default();
-    form.append("testRunId", String(runId));
+    form.append("runId", String(runId));
     form.append("projectName", projectName);
     form.append(
       "testRun",
@@ -1012,6 +1025,39 @@ var FileHandler = class {
 
 // src/internal/collect/metadata-collector.ts
 var import_node_child_process = require("child_process");
+var DETACHED_HEAD = "HEAD";
+function resolveScmBranch(env, gitBranch) {
+  const pick = (...names) => {
+    for (const name of names) {
+      const value = env[name]?.trim();
+      if (value) return value;
+    }
+    return void 0;
+  };
+  const override = env.PIWI_BRANCH?.trim();
+  if (override) return override;
+  let provider;
+  if (env.JENKINS_URL) provider = pick("CHANGE_BRANCH", "BRANCH_NAME");
+  else if (env.GITHUB_ACTIONS) provider = pick("GITHUB_HEAD_REF", "GITHUB_REF_NAME");
+  else if (env.GITLAB_CI) provider = pick("CI_MERGE_REQUEST_SOURCE_BRANCH_NAME", "CI_COMMIT_REF_NAME");
+  else if (env.CIRCLECI) provider = pick("CIRCLE_BRANCH");
+  else if (env.TRAVIS) provider = pick("TRAVIS_PULL_REQUEST_BRANCH", "TRAVIS_BRANCH");
+  else if (env.TF_BUILD) provider = pick("SYSTEM_PULLREQUEST_SOURCEBRANCH", "BUILD_SOURCEBRANCHNAME");
+  else if (env.BITBUCKET_BUILD_NUMBER) provider = pick("BITBUCKET_BRANCH");
+  if (provider) return normalizeRef(provider);
+  const trimmed = gitBranch?.trim();
+  if (trimmed && trimmed !== DETACHED_HEAD) return trimmed;
+  return void 0;
+}
+function resolveScmPrNumber(env) {
+  const githubRef = env.GITHUB_ACTIONS ? env.GITHUB_REF?.match(/^refs\/pull\/(\d+)\/(?:merge|head)$/) : void 0;
+  const raw = githubRef?.[1] ?? env.CI_MERGE_REQUEST_IID ?? env.BITBUCKET_PR_ID ?? env.SYSTEM_PULLREQUEST_PULLREQUESTNUMBER ?? env.CHANGE_ID;
+  const trimmed = raw?.trim();
+  return trimmed && /^\d+$/.test(trimmed) ? trimmed : void 0;
+}
+function normalizeRef(ref) {
+  return ref.replace(/^refs\/heads\//, "");
+}
 var MetadataCollector = class {
   constructor(logger = new Logger()) {
     this.logger = logger;
@@ -1117,6 +1163,7 @@ var MetadataCollector = class {
   }
   collectScmInfo(_options) {
     const scm = {};
+    let gitBranch;
     try {
       const execOpts = {
         encoding: "utf8",
@@ -1125,7 +1172,7 @@ var MetadataCollector = class {
         stdio: ["ignore", "pipe", "ignore"]
       };
       scm.commit = (0, import_node_child_process.execSync)("git rev-parse HEAD", execOpts).trim();
-      scm.branch = (0, import_node_child_process.execSync)("git rev-parse --abbrev-ref HEAD", execOpts).trim();
+      gitBranch = (0, import_node_child_process.execSync)("git rev-parse --abbrev-ref HEAD", execOpts).trim();
       scm.author = (0, import_node_child_process.execSync)('git log -1 --pretty=format:"%an"', execOpts).trim();
       scm.commitMessage = (0, import_node_child_process.execSync)('git log -1 --pretty=format:"%s"', execOpts).trim();
       try {
@@ -1135,6 +1182,10 @@ var MetadataCollector = class {
     } catch (error) {
       this.logger.debug(`Git info not available: ${errorMessage(error)}`);
     }
+    const branch = resolveScmBranch(process.env, gitBranch);
+    if (branch) scm.branch = branch;
+    const prNumber = resolveScmPrNumber(process.env);
+    if (prNumber) scm.prNumber = prNumber;
     return Object.keys(scm).length > 0 ? scm : void 0;
   }
   collectCiInfo() {
@@ -1421,8 +1472,8 @@ var StreamManager = class {
         if (this.pendingBeginEvents.length > 0) {
           this.pendingEvents = [...this.pendingBeginEvents, ...this.pendingEvents];
           this.pendingBeginEvents = [];
-          this.flush();
         }
+        if (this.pendingEvents.length > 0) this.flush();
       }
     } catch (error) {
       if (error instanceof HttpError && (error.status === 401 || error.status === 403)) {
@@ -1934,6 +1985,17 @@ function detectCliFileFilters(argv = process.argv) {
   return files;
 }
 
+// src/internal/support/selection-env.ts
+function readSelectionStamp(env = process.env) {
+  const key = env[PIWI_SELECTION_ENV.key];
+  if (!key) return null;
+  const version = Number(env[PIWI_SELECTION_ENV.version]);
+  const resolvedCount = Number(env[PIWI_SELECTION_ENV.count]);
+  const resolvedHash = env[PIWI_SELECTION_ENV.hash] ?? "";
+  if (!Number.isFinite(version) || !Number.isFinite(resolvedCount) || !resolvedHash) return null;
+  return { key, version, resolvedHash, resolvedCount };
+}
+
 // src/public/global-setup.ts
 var path10 = __toESM(require("path"));
 var fs11 = __toESM(require("fs"));
@@ -2024,7 +2086,7 @@ function createGlobalSetup(options, userSetup) {
             projectName: opts.projectName
           })
         );
-        logger.debug(`Global setup: initialising run #${response.runId}`);
+        logger.debug(`Global setup: initializing run #${response.runId}`);
       }
     } catch (error) {
       logger.warn(`Could not register global setup: ${errorMessage(error)}`);
@@ -2067,8 +2129,12 @@ function wrapConfig(config, piwiOptions) {
     globalSetupModules.push(...orig);
   }
   globalSetupModules.push(resolveSetupModule());
+  const forwarded = {};
+  const failOnFlaky = piwiOptions?.failOnFlakyTests ?? readBool(process.env[PIWI_ENV_KEYS.failOnFlakyTests]);
+  if (failOnFlaky === true) forwarded.failOnFlakyTests = true;
   return {
     ...config,
+    ...forwarded,
     reporter: injectReporter(config.reporter, piwiOptions),
     globalSetup: globalSetupModules.length === 1 ? globalSetupModules[0] : globalSetupModules
   };
@@ -2093,6 +2159,45 @@ function classifyStatus(rawStatus, annotations) {
   const intentional = annotations.some((a) => a.type === "skip" || a.type === "fixme");
   return intentional ? "skipped" : "didnotrun";
 }
+function resolveUnrunReason(runStatus, opts) {
+  if (runStatus === "timedout") return "global-timeout";
+  if (opts.maxFailures > 0 && opts.failures >= opts.maxFailures) return "max-failures";
+  return "interrupted";
+}
+function fileOf(location) {
+  return location.replace(/:\d+:\d+$/, "");
+}
+function suiteKey(suitePath) {
+  return (suitePath ?? []).join("");
+}
+function sharedPrefixDepth(a, b) {
+  let depth = 0;
+  while (depth < a.length && depth < b.length && a[depth] === b[depth]) depth++;
+  return depth;
+}
+function linkBlockedTests(cases) {
+  const blockers = cases.filter((c) => c.status === "failed" || c.status === "timedOut" || c.status === "timedout");
+  if (blockers.length === 0) return;
+  for (const c of cases) {
+    if (c.didNotRunReason !== "previous-failure") continue;
+    const file = fileOf(c.location);
+    const inFile = blockers.filter((b) => fileOf(b.location) === file);
+    if (inFile.length === 0) continue;
+    const key = suiteKey(c.suitePath);
+    let blocker = inFile.find((b) => suiteKey(b.suitePath) === key);
+    if (!blocker) {
+      let bestDepth = 0;
+      for (const b of inFile) {
+        const depth = sharedPrefixDepth(c.suitePath ?? [], b.suitePath ?? []);
+        if (depth > bestDepth) {
+          bestDepth = depth;
+          blocker = b;
+        }
+      }
+    }
+    if (blocker) c.blockedBy = blocker.location;
+  }
+}
 
 // ../core/src/test-meta.ts
 var PIWI_ANNOTATION_PREFIX = "piwi:";
@@ -2462,7 +2567,7 @@ var RunSubmitter = class {
         auth
       );
       this.recovery.clear();
-      return { done: true, output: this.buildOutput(response?.testRunId, response?.projectId, run, overallStatus) };
+      return { done: true, output: this.buildOutput(response?.runId, response?.projectId, run, overallStatus) };
     } catch (error) {
       if (error instanceof HttpError && error.status === 401 && !auth) {
         this.logAuthRequired(run.options.serverUrl);
@@ -2478,7 +2583,7 @@ var RunSubmitter = class {
     try {
       const response = await this.uploader.uploadJSON(payload, auth);
       this.recovery.clear();
-      return { done: true, output: this.buildOutput(response?.testRunId, response?.projectId, run, overallStatus) };
+      return { done: true, output: this.buildOutput(response?.runId, response?.projectId, run, overallStatus) };
     } catch (error) {
       if (error instanceof HttpError && error.status === 401 && !auth) {
         this.logAuthRequired(run.options.serverUrl);
@@ -2505,7 +2610,7 @@ function testLocation(test) {
   const relativeFilePath = path14.relative(process.cwd(), test.location.file).split(path14.sep).join("/");
   return `${relativeFilePath}:${test.location.line}:${test.location.column}`;
 }
-var PiwiDashboardReporter = class {
+var PiwiDashboardReporter = class _PiwiDashboardReporter {
   constructor(rawOptions = {}) {
     this.testCases = [];
     this.startTime = null;
@@ -2521,11 +2626,15 @@ var PiwiDashboardReporter = class {
     this.plannedTests = [];
     /** Ids of tests that actually reported via `onTestEnd`, to find the ones that never ran. */
     this.reportedTestIds = /* @__PURE__ */ new Set();
+    /** Per-test attempt history, keyed by `test.id`; snapshotted onto every attempt's payload. */
+    this.attemptsByTest = /* @__PURE__ */ new Map();
     this.runLabel = null;
     this.shardInfo = null;
     this.metadata = {};
     this.isFullRun = true;
     this.filterDetails = null;
+    /** Configured `maxFailures` (0 = unlimited) — disambiguates an interrupted run's unrun reason. */
+    this.maxFailures = 0;
     this.streamManager = null;
     /** Track suite-level setup steps (beforeAll/afterAll) not tied to any test */
     this.setupSteps = [];
@@ -2573,6 +2682,7 @@ var PiwiDashboardReporter = class {
     }
     this.startTime = (/* @__PURE__ */ new Date()).toISOString();
     this.playwrightVersion = config.version;
+    this.maxFailures = config.maxFailures ?? 0;
     this.logger.info(
       `Starting test run for project: ${this.options.projectName} (Playwright v${this.playwrightVersion})`
     );
@@ -2582,14 +2692,18 @@ var PiwiDashboardReporter = class {
     const grep = grepRe && grepRe.source !== ".*" ? grepRe.source : void 0;
     const grepInvert = grepInvertRe?.source;
     const fileFilters = detectCliFileFilters();
-    if (grep || grepInvert || fileFilters.length > 0) {
+    const selection = readSelectionStamp();
+    if (grep || grepInvert || fileFilters.length > 0 || selection) {
       this.isFullRun = false;
       this.filterDetails = {
         ...grep ? { grep } : {},
         ...grepInvert ? { grepInvert } : {},
-        ...fileFilters.length > 0 ? { files: fileFilters } : {}
+        ...fileFilters.length > 0 ? { files: fileFilters } : {},
+        ...selection ? { selection } : {}
       };
-      this.logger.info("Partial run detected (filter active)");
+      this.logger.info(
+        selection ? `Selection run detected (${selection.key})` : "Partial run detected (filter active)"
+      );
     }
     this.metadata = this.metadataCollector.collect(config, suite, this.options);
     this.plannedTests = suite.allTests();
@@ -2626,11 +2740,19 @@ var PiwiDashboardReporter = class {
       this.streamManager.queueBeginEvent(toWireTestCase(beginEvent));
     }
   }
+  static {
+    /**
+     * Step categories streamed live while the run executes. `pw:assert` is
+     * excluded: it is the polling noise of `expect()`, not a step a human
+     * watches; the meaningful readout is the `pw:expect` wrapper around it.
+     */
+    this.LIVE_STEP_CATEGORIES = /* @__PURE__ */ new Set(["hook", "fixture", "pw:api", "pw:expect"]);
+  }
   /** Playwright reporter hook: called when a step (including hook/fixture) begins */
   onStepBegin(test, _result, step) {
-    if (!this.enabled || !this.streamManager?.enabled) return;
+    if (!this.enabled || !this.streamManager) return;
     const cat = step.category;
-    if (cat !== "hook" && cat !== "fixture") return;
+    if (!_PiwiDashboardReporter.LIVE_STEP_CATEGORIES.has(cat)) return;
     const event = {
       type: "step-begin",
       title: step.title,
@@ -2644,10 +2766,9 @@ var PiwiDashboardReporter = class {
   }
   /** Playwright reporter hook: called when a step (including hook/fixture) ends */
   onStepEnd(test, _result, step) {
+    if (!this.enabled || !this.streamManager) return;
     const cat = step.category;
-    if (cat === "pw:api") return;
-    if (!this.enabled || !this.streamManager?.enabled) return;
-    if (cat !== "hook" && cat !== "fixture") return;
+    if (!_PiwiDashboardReporter.LIVE_STEP_CATEGORIES.has(cat)) return;
     const workerIndex = workerIndexOf(_result);
     const startedAt = step.startTime instanceof Date ? step.startTime.getTime() : null;
     const event = {
@@ -2662,7 +2783,7 @@ var PiwiDashboardReporter = class {
       startedAt
     };
     this.streamManager?.queueEvent(event);
-    if (!test && startedAt) {
+    if (!test && startedAt && (cat === "hook" || cat === "fixture")) {
       this.setupSteps.push({
         title: step.title,
         category: cat,
@@ -2682,6 +2803,14 @@ var PiwiDashboardReporter = class {
     const annotations = mergeAnnotations(test, result);
     const status = classifyStatus(result.status, annotations);
     const tags = collectTestTags(test);
+    const attempts = this.attemptsByTest.get(test.id) ?? [];
+    attempts.push({
+      retry: result.retry,
+      status,
+      duration: result.duration,
+      startedAt: result.startTime ? result.startTime.getTime() : null
+    });
+    this.attemptsByTest.set(test.id, attempts);
     const testCase = {
       type: "complete",
       title: test.title,
@@ -2693,6 +2822,7 @@ var PiwiDashboardReporter = class {
       timeout: test.timeout ?? null,
       error: buildErrorText(result),
       retries: result.retry,
+      attempts: attempts.map((a) => ({ ...a })),
       workerIndex: workerIndexOf(result),
       shardIndex: this.shardInfo?.current ?? null,
       startedAt: result.startTime ? result.startTime.getTime() : null,
@@ -2702,7 +2832,10 @@ var PiwiDashboardReporter = class {
       suiteConfig,
       testAnnotations: annotations.length ? annotations : null,
       tags: tags.length ? tags : null,
-      testMeta: collectTestMetadata(annotations)
+      testMeta: collectTestMetadata(annotations),
+      // An annotation-less skip reclassified to `didnotrun` is a serial-group
+      // cascade: an earlier test failed and Playwright skipped the rest.
+      didNotRunReason: status === "didnotrun" ? "previous-failure" : null
     };
     if (result.status === "failed" || result.status === "timedOut") {
       const failingLine = extractFailingLine(testCase.error, test.location.file, test.location.line);
@@ -2746,6 +2879,7 @@ var PiwiDashboardReporter = class {
         break;
     }
     this.testCases.push(testCase);
+    if (status === "didnotrun") linkBlockedTests(this.testCases);
     if (this.streamManager) {
       this.streamManager.queueEvent(toWireTestCase(testCase));
       if (this.options.liveFileUploads) this.streamManager.scheduleLiveUpload(testCase);
@@ -2756,9 +2890,10 @@ var PiwiDashboardReporter = class {
    * (no `onTestEnd`) — typically because `maxFailures` cut the run short. These
    * carry no result, so they're emitted with zero duration and no error. In
    * streaming mode they're queued as complete events so the pre-finish drain
-   * sends them alongside the rest.
+   * sends them alongside the rest. The `reason` (global timeout / max failures /
+   * interrupted) is resolved once from the overall run status by the caller.
    */
-  materializeUnrunTests() {
+  materializeUnrunTests(reason) {
     for (const test of this.plannedTests) {
       if (this.reportedTestIds.has(test.id)) continue;
       const { suitePath, suiteConfig } = this.metadataCollector.getSuiteInfo(test);
@@ -2782,7 +2917,8 @@ var PiwiDashboardReporter = class {
         suiteConfig,
         testAnnotations: declaredAnnotations.length ? declaredAnnotations : null,
         tags: tags.length ? tags : null,
-        testMeta: collectTestMetadata(declaredAnnotations)
+        testMeta: collectTestMetadata(declaredAnnotations),
+        didNotRunReason: reason
       };
       this.testCases.push(testCase);
       this.totalTests++;
@@ -2795,7 +2931,11 @@ var PiwiDashboardReporter = class {
   /** Playwright reporter hook: called when the full test run finishes */
   async onEnd(result) {
     if (!this.enabled) return;
-    this.materializeUnrunTests();
+    const unrunReason = resolveUnrunReason(result?.status, {
+      maxFailures: this.maxFailures,
+      failures: this.failedTests + this.timedOutTests
+    });
+    this.materializeUnrunTests(unrunReason);
     await this.submitter.submit(
       {
         options: this.options,
@@ -2821,6 +2961,79 @@ var PiwiDashboardReporter = class {
   }
 };
 
+// src/internal/support/selection-client.ts
+function authHeaders(apiKey) {
+  return apiKey ? { "X-API-Key": apiKey } : {};
+}
+async function resolveProjectId(options) {
+  if (!options.project) throw new Error("No project \u2014 pass --project or set PIWI_PROJECT_NAME");
+  if (/^\d+$/.test(options.project)) return Number(options.project);
+  const res = await fetch(`${options.serverUrl}/api/projects/menu`, { headers: authHeaders(options.apiKey) });
+  if (!res.ok) throw new Error(`Could not list projects (dashboard returned ${res.status})`);
+  const body = await res.json();
+  const match = body.items?.find((p) => p.name.toLowerCase() === options.project.toLowerCase());
+  if (!match) throw new Error(`No project named "${options.project}" on this dashboard`);
+  return match.id;
+}
+async function fetchResolution(options, projectId) {
+  const params = new URLSearchParams({ format: options.format ?? "args" });
+  if (options.pkgRunner) params.set("pkgRunner", options.pkgRunner);
+  if (options.budgetMs != null) params.set("budgetMs", String(options.budgetMs));
+  if (options.shard) params.set("shard", options.shard);
+  if (options.order) params.set("order", options.order);
+  const url = `${options.serverUrl}/api/projects/${projectId}/selections/${encodeURIComponent(options.key)}/resolve?${params}`;
+  const res = await fetch(url, { headers: authHeaders(options.apiKey) });
+  if (!res.ok) {
+    const body = await res.json().catch(() => ({}));
+    throw new Error(body.message || `Dashboard returned ${res.status} resolving "${options.key}"`);
+  }
+  return await res.json();
+}
+
+// src/public/selection.ts
+async function resolveSelection(options = {}) {
+  const env = options.env ?? process.env;
+  const key = options.key ?? env[PIWI_SELECTION_ENV.key];
+  if (!key) return void 0;
+  const serverUrl = (options.serverUrl ?? env[PIWI_ENV_KEYS.serverUrl] ?? "").replace(/\/$/, "");
+  const apiKey = options.apiKey ?? env[PIWI_ENV_KEYS.apiKey] ?? null;
+  const project = options.project ?? env[PIWI_ENV_KEYS.projectName] ?? "";
+  if (!serverUrl) {
+    if (options.strict) throw new Error("resolveSelection: no dashboard URL (set PIWI_DASHBOARD_URL)");
+    return void 0;
+  }
+  const clientOptions = { serverUrl, apiKey, project, key, format: "grep", budgetMs: options.budgetMs ?? null };
+  try {
+    const projectId = await resolveProjectId(clientOptions);
+    const resolution = await fetchResolution(clientOptions, projectId);
+    if (resolution.estimate.count === 0) {
+      if (options.strict) throw new Error(`resolveSelection: "${key}" resolved to 0 tests`);
+      console.warn(`[Piwi Dashboard] selection "${key}" resolved to 0 tests \u2014 running the full suite`);
+      return void 0;
+    }
+    env[PIWI_SELECTION_ENV.key] = resolution.key ?? key;
+    env[PIWI_SELECTION_ENV.version] = String(resolution.version ?? 0);
+    env[PIWI_SELECTION_ENV.hash] = resolution.resolvedHash;
+    env[PIWI_SELECTION_ENV.count] = String(resolution.estimate.count);
+    const args = resolution.materialization.args;
+    const result = {
+      key: resolution.key ?? key,
+      version: resolution.version ?? 0,
+      resolvedHash: resolution.resolvedHash,
+      resolvedCount: resolution.estimate.count
+    };
+    if (args[0] === "--grep") result.grep = args[1];
+    else result.files = args;
+    return result;
+  } catch (e) {
+    if (options.strict) throw e;
+    console.warn(
+      `[Piwi Dashboard] selection "${key}" could not be resolved \u2014 running the full suite (${e.message})`
+    );
+    return void 0;
+  }
+}
+
 // src/internal/capture/capture-fixtures.ts
 var import_node_zlib = require("zlib");
 
@@ -3092,7 +3305,16 @@ function probeElementAttrs(el, arg) {
     }
   }
   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;
+  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;
+    }
+  }
   return {
     tagName: el.tagName?.toLowerCase?.() ?? "unknown",
     attributes: attrMap,
@@ -3796,6 +4018,7 @@ var CAPTURED_ATTRIBUTES = [
   "alt",
   "title",
   "aria-label",
+  "aria-labelledby",
   "aria-level",
   "role",
   "type",
@@ -4387,6 +4610,43 @@ function extractAccessibleName(ariaSnapshot) {
   if (match) return match[1];
   return null;
 }
+var FORM_FIELD_TAGS = /* @__PURE__ */ new Set(["input", "select", "textarea"]);
+var NAME_FROM_CONTENT_ROLES = /* @__PURE__ */ new Set([
+  "button",
+  "cell",
+  "checkbox",
+  "columnheader",
+  "gridcell",
+  "heading",
+  "link",
+  "menuitem",
+  "menuitemcheckbox",
+  "menuitemradio",
+  "option",
+  "radio",
+  "row",
+  "rowheader",
+  "switch",
+  "tab",
+  "tooltip",
+  "treeitem"
+]);
+var PROBE_TEXT_CAP = 80;
+var PROBE_LABEL_TEXT_CAP = 120;
+function exactAccessibleName(attrs, role) {
+  if (attrs.attributes["aria-labelledby"]) return null;
+  const ariaLabel = attrs.attributes["aria-label"];
+  if (ariaLabel) return ariaLabel;
+  if (FORM_FIELD_TAGS.has(attrs.tagName)) {
+    const labelText = attrs.labelText;
+    return labelText && labelText.length < PROBE_LABEL_TEXT_CAP ? labelText : null;
+  }
+  if (role && NAME_FROM_CONTENT_ROLES.has(role)) {
+    const text = attrs.textContent;
+    return text && text.length < PROBE_TEXT_CAP ? text : null;
+  }
+  return null;
+}
 var NAME_BASED_METHODS = /* @__PURE__ */ new Set([
   "getByText",
   "getByRole",
@@ -4831,7 +5091,7 @@ function createSink() {
     capturedLocators: [],
     capturePromises: [],
     failedLocators: [],
-    expectCapturedLocations: /* @__PURE__ */ new Set(),
+    probedLocations: /* @__PURE__ */ new Set(),
     lastActivePage: null,
     testInfo: null,
     stashedWebVitals: null,
@@ -5058,7 +5318,6 @@ var INSTRUMENTED_CONTEXTS = /* @__PURE__ */ new WeakSet();
 var PATCHED_BROWSERS = /* @__PURE__ */ new WeakSet();
 var CHAIN_METHOD_SET = new Set(CHAIN_METHODS);
 var ACTION_METHOD_SET = new Set(ACTION_METHODS);
-var FORM_FIELD_TAGS = /* @__PURE__ */ new Set(["input", "select", "textarea"]);
 var CAPTURED_ATTRS_ARG = {
   keep: [...CAPTURED_ATTRIBUTES],
   tagRoles: TAG_TO_ROLE,
@@ -5067,11 +5326,32 @@ 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); it derives
-  // the accessible name itself, so the probe's own labelText is unneeded.
+  // 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: false
+  includeLabelText: true
 };
+var PROBE_GLOBAL = "__piwiProbeElement";
+var PROBE_INIT_SCRIPT = `(() => {
+  const probe = ${probeElementAttrs.toString()};
+  const arg = ${JSON.stringify(CAPTURED_ATTRS_ARG)};
+  globalThis[${JSON.stringify(PROBE_GLOBAL)}] = (el) => probe(el, arg);
+})();`;
+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();
+  });
+}
 async function ariaSnapshotBestEffort(target, timeout) {
   if (typeof target.ariaSnapshot !== "function") return null;
   try {
@@ -5090,8 +5370,8 @@ async function ariaSnapshotBestEffort(target, timeout) {
     }
   }
 }
-function startElementCapture(sink, target, seq, callerLocation, used) {
-  const probe = target.evaluate(probeElementAttrs, CAPTURED_ATTRS_ARG);
+function startElementCapture(sink, page, target, seq, callerLocation, used) {
+  const probe = probeElement(page, target);
   const settledProbe = probe.then(
     () => void 0,
     () => void 0
@@ -5110,8 +5390,9 @@ function startElementCapture(sink, target, seq, callerLocation, used) {
       ]);
       const role = resolveAriaRole({ ...attrs, accessibleName: null });
       const isFormField = FORM_FIELD_TAGS.has(attrs.tagName);
-      const aria = role || isFormField ? await ariaSnapshotBestEffort(target, 500) : null;
-      const accessibleName = extractAccessibleName(aria) || approximateAccessibleName({ ...attrs, accessibleName: null });
+      const exactName = exactAccessibleName(attrs, role);
+      const aria = exactName === null && (role || isFormField) ? await ariaSnapshotBestEffort(target, 500) : null;
+      const accessibleName = exactName ?? (extractAccessibleName(aria) || approximateAccessibleName({ ...attrs, accessibleName: null }));
       sink.capturedLocators[seq] = {
         location: callerLocation,
         used,
@@ -5131,6 +5412,7 @@ function startElementCapture(sink, target, seq, callerLocation, used) {
         alternatives: generateAlternatives({ ...attrs, accessibleName })
       };
     } catch {
+      if (callerLocation) sink.probedLocations.delete(callerLocation);
     } finally {
       clearTimeout(deadline);
     }
@@ -5167,17 +5449,17 @@ function wrapLocator(page, locator, originMethod, originArgs) {
             args: originArgs,
             raw: `${originMethod}(${JSON.stringify(originArgs)})`
           };
-          const alreadyCaptured = callerLocation !== null && sink.expectCapturedLocations.has(callerLocation);
+          const alreadyProbed = callerLocation !== null && sink.probedLocations.has(callerLocation);
           let seq = -1;
-          if (!alreadyCaptured) {
+          if (!alreadyProbed) {
             seq = sink.capturedLocators.length;
             sink.capturedLocators.push({ location: callerLocation, used, element: null, alternatives: [] });
           }
           const result = await fn.apply(target, callArgs);
           const matches = result?.matches;
-          if (matches === true && !alreadyCaptured) {
-            if (callerLocation) sink.expectCapturedLocations.add(callerLocation);
-            startElementCapture(sink, target, seq, callerLocation, used);
+          if (matches === true && !alreadyProbed) {
+            if (callerLocation) sink.probedLocations.add(callerLocation);
+            startElementCapture(sink, page, target, seq, callerLocation, used);
           } else if (matches === false) {
             sink.failedLocators.push({ method: originMethod, args: originArgs, location: callerLocation });
           }
@@ -5189,19 +5471,23 @@ function wrapLocator(page, locator, originMethod, originArgs) {
         const sink = currentSink;
         if (!sink) return fn.apply(target, callArgs);
         sink.lastActivePage = page;
-        const seq = sink.capturedLocators.length;
         const callerLocation = captureCallerLocation();
         const used = {
           method: originMethod,
           args: originArgs,
           raw: `${originMethod}(${JSON.stringify(originArgs)})`
         };
-        sink.capturedLocators.push({
-          location: callerLocation,
-          used,
-          element: null,
-          alternatives: []
-        });
+        const alreadyProbed = callerLocation !== null && sink.probedLocations.has(callerLocation);
+        let seq = -1;
+        if (!alreadyProbed) {
+          seq = sink.capturedLocators.length;
+          sink.capturedLocators.push({
+            location: callerLocation,
+            used,
+            element: null,
+            alternatives: []
+          });
+        }
         let result;
         try {
           result = await fn.apply(target, callArgs);
@@ -5209,7 +5495,10 @@ function wrapLocator(page, locator, originMethod, originArgs) {
           sink.failedLocators.push({ method: originMethod, args: originArgs, location: callerLocation });
           throw error;
         }
-        startElementCapture(sink, target, seq, callerLocation, used);
+        if (!alreadyProbed) {
+          if (callerLocation) sink.probedLocations.add(callerLocation);
+          startElementCapture(sink, page, target, seq, callerLocation, used);
+        }
         return result;
       };
     }
@@ -5242,6 +5531,9 @@ function instrumentPage(page) {
         return wrapLocator(page, original(...args), method, args);
       };
     }
+    if (typeof page.on === "function") {
+      page.on("framenavigated", () => PROBE_UNSEEDED_PAGES.delete(page));
+    }
   }
   page.on("console", (msg) => {
     const sink = currentSink;
@@ -5306,6 +5598,10 @@ function instrumentPage(page) {
 function instrumentContext(context) {
   if (!context || INSTRUMENTED_CONTEXTS.has(context)) return;
   INSTRUMENTED_CONTEXTS.add(context);
+  if (process.env.PIWI_CAPTURE_LOCATORS !== "false" && typeof context.addInitScript === "function") {
+    void Promise.resolve(context.addInitScript({ content: PROBE_INIT_SCRIPT })).catch(() => {
+    });
+  }
   const originalNewPage = context.newPage.bind(context);
   context.newPage = async (...args) => {
     const page = await originalNewPage(...args);
@@ -6279,5 +6575,6 @@ var index_default = PiwiDashboardReporter;
   extendPiwiFixtures,
   piwiAiFixtures,
   piwiFixtures,
+  resolveSelection,
   wrapConfig
 });