@piwitests/reporter 0.18.1 → 0.19.0

package/dist/index.js

@@ -40,7 +40,27 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/public/reporter.ts
-var path13 = __toESM(require("path"));
+var path14 = __toESM(require("path"));
+
+// src/internal/config/desktop.ts
+var fs = __toESM(require("fs"));
+var os = __toESM(require("os"));
+var path = __toESM(require("path"));
+function defaultDesktopConfigPath() {
+  return path.join(os.homedir(), ".piwi", "desktop.json");
+}
+function readDesktopConfig(filePath) {
+  try {
+    const parsed = JSON.parse(fs.readFileSync(filePath, "utf8"));
+    const url = parsed?.url;
+    const token = parsed?.token;
+    if (typeof url !== "string" || !url) return null;
+    if (typeof token !== "string" || !token) return null;
+    return { url, token };
+  } catch {
+    return null;
+  }
+}
 
 // src/internal/config/env.ts
 var DEFAULTS = {
@@ -85,6 +105,7 @@ var PIWI_ENV_KEYS = {
   pickLocatorOnFailure: "PIWI_PICK_LOCATOR_ON_FAIL",
   outputFile: "PIWI_OUTPUT_FILE"
 };
+var PIWI_DESKTOP_CONFIG_ENV = "PIWI_DESKTOP_CONFIG";
 function readBool(val) {
   if (val === void 0) return void 0;
   return val === "true";
@@ -111,6 +132,10 @@ var ENV_FALLBACK_SPECS = [
   { option: "pickLocatorOnFailure", env: PIWI_ENV_KEYS.pickLocatorOnFailure, kind: "bool" },
   { option: "outputFile", env: PIWI_ENV_KEYS.outputFile, kind: "string" }
 ];
+var desktopDiscovered = false;
+function usedDesktopDiscovery() {
+  return desktopDiscovered;
+}
 function resolveOptions(raw) {
   const env = process.env;
   const mergedRaw = { ...raw };
@@ -123,6 +148,17 @@ function resolveOptions(raw) {
       mergedRaw[spec.option] = spec.kind === "number" ? Number(value) : value;
     }
   }
+  desktopDiscovered = false;
+  const serverUrlUnset = mergedRaw.serverUrl === void 0;
+  const apiKeyUnset = mergedRaw.apiKey === void 0 || mergedRaw.apiKey === null;
+  if (serverUrlUnset && apiKeyUnset) {
+    const desktop = readDesktopConfig(env[PIWI_DESKTOP_CONFIG_ENV] || defaultDesktopConfigPath());
+    if (desktop) {
+      mergedRaw.serverUrl = desktop.url;
+      mergedRaw.apiKey = desktop.token;
+      desktopDiscovered = true;
+    }
+  }
   const opts = { ...DEFAULTS, ...mergedRaw };
   if (env[PIWI_ENV_KEYS.verbose] !== void 0) opts.verbose = env[PIWI_ENV_KEYS.verbose] === "true";
   return opts;
@@ -337,8 +373,8 @@ var HttpClient = class {
 };
 
 // src/internal/submit/uploader.ts
-var fs = __toESM(require("fs"));
-var path = __toESM(require("path"));
+var fs2 = __toESM(require("fs"));
+var path2 = __toESM(require("path"));
 var import_form_data2 = __toESM(require("form-data"));
 
 // src/internal/submit/serializer.ts
@@ -383,6 +419,8 @@ function toWireTestCase(tc) {
     suitePath: rest.suitePath ?? null,
     suiteConfig: rest.suiteConfig ?? null,
     testAnnotations: rest.testAnnotations ?? null,
+    tags: rest.tags ?? null,
+    testMeta: rest.testMeta ?? null,
     locatorSnapshots: rest.locatorSnapshots || null
   };
 }
@@ -521,8 +559,8 @@ var Uploader = class {
       if (traceInfo) {
         form.append("trace_hash", traceInfo.hash);
         if (includeTraceFile2) {
-          form.append("trace", fs.createReadStream(traceInfo.tracePath), {
-            filename: path.basename(traceInfo.tracePath)
+          form.append("trace", fs2.createReadStream(traceInfo.tracePath), {
+            filename: path2.basename(traceInfo.tracePath)
           });
         }
       }
@@ -534,7 +572,7 @@ var Uploader = class {
           )
         );
         for (const a of attachments) {
-          form.append("attach_file", fs.createReadStream(a.path), { filename: a.originalName });
+          form.append("attach_file", fs2.createReadStream(a.path), { filename: a.originalName });
         }
       }
       return form;
@@ -587,7 +625,7 @@ var Uploader = class {
         )
       );
       for (const a of attachments) {
-        form.append(`attach_file_${i}`, fs.createReadStream(a.path), { filename: a.originalName });
+        form.append(`attach_file_${i}`, fs2.createReadStream(a.path), { filename: a.originalName });
         attachmentCount++;
       }
     }
@@ -596,8 +634,8 @@ var Uploader = class {
     let traceCount = 0;
     for (const [i, tc] of testCases.entries()) {
       for (const tp of this.fileHandler.findTraceFiles(tc)) {
-        if (fs.existsSync(tp)) {
-          form.append(`trace_${i}`, fs.createReadStream(tp), { filename: path.basename(tp) });
+        if (fs2.existsSync(tp)) {
+          form.append(`trace_${i}`, fs2.createReadStream(tp), { filename: path2.basename(tp) });
           traceCount++;
         }
       }
@@ -607,40 +645,40 @@ var Uploader = class {
 };
 
 // src/internal/streaming/stream-buffer.ts
-var path2 = __toESM(require("path"));
-var os2 = __toESM(require("os"));
-var fs2 = __toESM(require("fs"));
+var path3 = __toESM(require("path"));
+var os3 = __toESM(require("os"));
+var fs3 = __toESM(require("fs"));
 
 // src/internal/support/instance-id.ts
 var crypto = __toESM(require("crypto"));
-var os = __toESM(require("os"));
+var os2 = __toESM(require("os"));
 function hashForProject(projectName) {
   return crypto.createHash("sha1").update(projectName).digest("hex").slice(0, 16);
 }
 function computeInstanceId(projectName, runLabel) {
-  const seed = runLabel ? `${projectName}|${runLabel}` : `${os.hostname()}|${projectName}`;
+  const seed = runLabel ? `${projectName}|${runLabel}` : `${os2.hostname()}|${projectName}`;
   return crypto.createHash("sha256").update(seed).digest("hex").slice(0, 16);
 }
 
 // src/internal/streaming/stream-buffer.ts
 var StreamBuffer = class {
   constructor(projectName) {
-    this.filePath = path2.join(os2.tmpdir(), `piwi-dashboard-stream-${hashForProject(projectName)}.jsonl`);
+    this.filePath = path3.join(os3.tmpdir(), `piwi-dashboard-stream-${hashForProject(projectName)}.jsonl`);
   }
   /** Append one or more events to the on-disk buffer */
   append(events) {
     if (events.length === 0) return;
     try {
       const lines = events.map((e) => JSON.stringify(e) + "\n").join("");
-      fs2.appendFileSync(this.filePath, lines, "utf8");
+      fs3.appendFileSync(this.filePath, lines, "utf8");
     } catch {
     }
   }
   /** Load all buffered events from disk, clearing the file */
   load() {
     try {
-      if (fs2.existsSync(this.filePath)) {
-        const content = fs2.readFileSync(this.filePath, "utf8");
+      if (fs3.existsSync(this.filePath)) {
+        const content = fs3.readFileSync(this.filePath, "utf8");
         return content.split("\n").filter(Boolean).map((line) => JSON.parse(line));
       }
     } catch {
@@ -650,17 +688,17 @@ var StreamBuffer = class {
   /** Delete the buffer file from disk */
   clear() {
     try {
-      if (fs2.existsSync(this.filePath)) fs2.unlinkSync(this.filePath);
+      if (fs3.existsSync(this.filePath)) fs3.unlinkSync(this.filePath);
     } catch {
     }
   }
   /** Remove the buffer file if it is older than `maxAgeMs` (default 2 hours). Used on startup to discard orphaned data. */
   clearStale(maxAgeMs = 72e5) {
     try {
-      if (fs2.existsSync(this.filePath)) {
-        const stats = fs2.statSync(this.filePath);
+      if (fs3.existsSync(this.filePath)) {
+        const stats = fs3.statSync(this.filePath);
         if (Date.now() - stats.mtimeMs > maxAgeMs) {
-          fs2.unlinkSync(this.filePath);
+          fs3.unlinkSync(this.filePath);
         }
       }
     } catch {
@@ -669,7 +707,7 @@ var StreamBuffer = class {
 };
 
 // src/internal/streaming/crash-recovery.ts
-var path3 = __toESM(require("path"));
+var path4 = __toESM(require("path"));
 
 // src/internal/support/errors.ts
 function errorMessage(error) {
@@ -678,8 +716,8 @@ function errorMessage(error) {
 }
 
 // src/internal/streaming/crash-recovery.ts
-var os3 = __toESM(require("os"));
-var fs3 = __toESM(require("fs"));
+var os4 = __toESM(require("os"));
+var fs4 = __toESM(require("fs"));
 var CrashRecovery = class {
   /**
    * @param projectName Used to derive the temp-file name so recovery data is project-scoped.
@@ -687,12 +725,12 @@ var CrashRecovery = class {
    */
   constructor(projectName, logger = new Logger()) {
     this.logger = logger;
-    this.filePath = path3.join(os3.tmpdir(), `piwi-dashboard-recovery-${hashForProject(projectName)}.json`);
+    this.filePath = path4.join(os4.tmpdir(), `piwi-dashboard-recovery-${hashForProject(projectName)}.json`);
   }
   /** Serialise the payload to a temp file for later retry */
   save(data) {
     try {
-      fs3.writeFileSync(this.filePath, JSON.stringify(data), "utf8");
+      fs4.writeFileSync(this.filePath, JSON.stringify(data), "utf8");
       this.logger.info("Saved recovery data for later upload");
     } catch (error) {
       this.logger.error(`Failed to save recovery data: ${errorMessage(error)}`);
@@ -701,7 +739,7 @@ var CrashRecovery = class {
   /** Read the saved payload from disk, or return `null` if none exists */
   load() {
     try {
-      if (fs3.existsSync(this.filePath)) return JSON.parse(fs3.readFileSync(this.filePath, "utf8"));
+      if (fs4.existsSync(this.filePath)) return JSON.parse(fs4.readFileSync(this.filePath, "utf8"));
     } catch {
     }
     return null;
@@ -709,7 +747,7 @@ var CrashRecovery = class {
   /** Delete the recovery file from disk */
   clear() {
     try {
-      if (fs3.existsSync(this.filePath)) fs3.unlinkSync(this.filePath);
+      if (fs4.existsSync(this.filePath)) fs4.unlinkSync(this.filePath);
     } catch {
     }
   }
@@ -730,24 +768,24 @@ var CrashRecovery = class {
 };
 
 // src/internal/files/file-handler.ts
-var fs5 = __toESM(require("fs"));
-var path5 = __toESM(require("path"));
+var fs6 = __toESM(require("fs"));
+var path6 = __toESM(require("path"));
 var crypto2 = __toESM(require("crypto"));
 
 // src/internal/files/compression.ts
-var fs4 = __toESM(require("fs"));
-var path4 = __toESM(require("path"));
+var fs5 = __toESM(require("fs"));
+var path5 = __toESM(require("path"));
 var zlib = __toESM(require("zlib"));
 var import_node_util = require("util");
 var gzipAsync = (0, import_node_util.promisify)(zlib.gzip);
 async function compressDirectory(sourceDir) {
   const files = [];
   function collect(dir, baseDir = "") {
-    for (const entry of fs4.readdirSync(dir, { withFileTypes: true })) {
-      const full = path4.join(dir, entry.name);
-      const rel = path4.join(baseDir, entry.name);
+    for (const entry of fs5.readdirSync(dir, { withFileTypes: true })) {
+      const full = path5.join(dir, entry.name);
+      const rel = path5.join(baseDir, entry.name);
       if (entry.isDirectory()) collect(full, rel);
-      else if (entry.isFile()) files.push({ path: rel, content: fs4.readFileSync(full) });
+      else if (entry.isFile()) files.push({ path: rel, content: fs5.readFileSync(full) });
     }
   }
   collect(sourceDir);
@@ -785,19 +823,19 @@ var FileHandler = class {
   }
   /** Locate a Playwright HTML report directory containing `index.html`. Optionally override the search path. */
   findHTMLReportDirectory(customDir) {
-    const possibleDirs = customDir ? [customDir, path5.join(process.cwd(), customDir)] : ["playwright-report", "./playwright-report", path5.join(process.cwd(), "playwright-report")];
+    const possibleDirs = customDir ? [customDir, path6.join(process.cwd(), customDir)] : ["playwright-report", "./playwright-report", path6.join(process.cwd(), "playwright-report")];
     for (const reportDir of possibleDirs) {
-      if (fs5.existsSync(reportDir) && fs5.statSync(reportDir).isDirectory()) {
-        if (fs5.existsSync(path5.join(reportDir, "index.html"))) return reportDir;
+      if (fs6.existsSync(reportDir) && fs6.statSync(reportDir).isDirectory()) {
+        if (fs6.existsSync(path6.join(reportDir, "index.html"))) return reportDir;
       }
     }
     return null;
   }
   /** Check if `dir` exists and is a directory; also checks `path.join(process.cwd(), dir)` */
   findReportDirectory(dir) {
-    const candidates = [dir, path5.join(process.cwd(), dir)];
+    const candidates = [dir, path6.join(process.cwd(), dir)];
     for (const candidate of candidates) {
-      if (fs5.existsSync(candidate) && fs5.statSync(candidate).isDirectory()) return candidate;
+      if (fs6.existsSync(candidate) && fs6.statSync(candidate).isDirectory()) return candidate;
     }
     return null;
   }
@@ -815,7 +853,7 @@ var FileHandler = class {
     const set = /* @__PURE__ */ new Set();
     if (testCase.attachments) {
       for (const a of testCase.attachments) {
-        if (a.name === "trace" && a.path) set.add(path5.resolve(a.path));
+        if (a.name === "trace" && a.path) set.add(path6.resolve(a.path));
       }
     }
     return Array.from(set);
@@ -827,12 +865,12 @@ var FileHandler = class {
       for (const a of testCase.attachments) {
         if (a.name === "trace") continue;
         if (a.name && INTERNAL_ATTACHMENT_NAMES.has(a.name)) continue;
-        if (a.path && fs5.existsSync(a.path)) {
+        if (a.path && fs6.existsSync(a.path)) {
           result.push({
             name: a.name || "attachment",
-            path: path5.resolve(a.path),
+            path: path6.resolve(a.path),
             contentType: a.contentType || "application/octet-stream",
-            originalName: path5.basename(a.path)
+            originalName: path6.basename(a.path)
           });
         }
       }
@@ -887,17 +925,17 @@ var FileHandler = class {
     const tracePaths = this.findTraceFiles(testCase);
     let lastPath = null;
     for (const tp of tracePaths) {
-      if (fs5.existsSync(tp)) lastPath = tp;
+      if (fs6.existsSync(tp)) lastPath = tp;
     }
     if (!lastPath) return null;
     const hash = crypto2.createHash("sha256");
     await new Promise((resolve5, reject) => {
-      fs5.createReadStream(lastPath).on("data", (chunk) => hash.update(chunk)).on("end", resolve5).on("error", reject);
+      fs6.createReadStream(lastPath).on("data", (chunk) => hash.update(chunk)).on("end", resolve5).on("error", reject);
     });
     return {
       tracePath: lastPath,
       hash: hash.digest("hex"),
-      size: fs5.statSync(lastPath).size
+      size: fs6.statSync(lastPath).size
     };
   }
   /** Ask the server which trace hashes it already has, returning the set of hashes that are missing */
@@ -1115,7 +1153,7 @@ var MetadataCollector = class {
 };
 
 // src/internal/streaming/stream-manager.ts
-var fs7 = __toESM(require("fs"));
+var fs8 = __toESM(require("fs"));
 
 // src/internal/support/limiter.ts
 function createLimiter(maxConcurrent) {
@@ -1140,18 +1178,18 @@ function createLimiter(maxConcurrent) {
 }
 
 // src/internal/support/setup-file.ts
-var path6 = __toESM(require("path"));
-var os4 = __toESM(require("os"));
-var fs6 = __toESM(require("fs"));
+var path7 = __toESM(require("path"));
+var os5 = __toESM(require("os"));
+var fs7 = __toESM(require("fs"));
 function getSetupFilePath(projectName) {
-  return path6.join(os4.tmpdir(), `piwi-dashboard-setup-${hashForProject(projectName)}.json`);
+  return path7.join(os5.tmpdir(), `piwi-dashboard-setup-${hashForProject(projectName)}.json`);
 }
 function readSetupInfo(projectName) {
   const setupFile = getSetupFilePath(projectName);
   try {
-    if (fs6.existsSync(setupFile)) {
-      const info = JSON.parse(fs6.readFileSync(setupFile, "utf8"));
-      fs6.unlinkSync(setupFile);
+    if (fs7.existsSync(setupFile)) {
+      const info = JSON.parse(fs7.readFileSync(setupFile, "utf8"));
+      fs7.unlinkSync(setupFile);
       if (info.projectName === projectName) return info;
     }
   } catch {
@@ -1470,7 +1508,7 @@ var StreamManager = class {
   }
   /** Schedule a live upload of trace and attachment files for a test case. Skips cases with no files. Concurrency is limited to 2 simultaneous uploads. */
   scheduleLiveUpload(tc) {
-    const hasTrace = !!this.options.uploadTraces && this.fileHandler.findTraceFiles(tc).some((p) => fs7.existsSync(p));
+    const hasTrace = !!this.options.uploadTraces && this.fileHandler.findTraceFiles(tc).some((p) => fs8.existsSync(p));
     const hasAttachments = this.fileHandler.findAllAttachments(tc).length > 0;
     if (!hasTrace && !hasAttachments) return;
     const promise = (async () => {
@@ -1534,7 +1572,7 @@ var StreamManager = class {
   }
 };
 
-// src/internal/collect/step-analyzer.ts
+// ../packages/core/src/step-analysis.ts
 function categorizeStep(title, pwCategory) {
   if (!title) return "other";
   if (pwCategory === "hook" || pwCategory === "fixture") return pwCategory;
@@ -1595,8 +1633,8 @@ function collectStepMetrics(steps) {
 }
 function percentile(sortedArr, p) {
   if (sortedArr.length === 0) return 0;
-  const index = Math.ceil(p / 100 * sortedArr.length) - 1;
-  return sortedArr[Math.max(0, index)];
+  const index = Math.min(sortedArr.length - 1, Math.max(0, Math.ceil(p / 100 * sortedArr.length) - 1));
+  return sortedArr[index];
 }
 function computePerformanceSummary(testCases) {
   const durations = testCases.filter((tc) => tc.duration != null).map((tc) => tc.duration);
@@ -1671,15 +1709,15 @@ function extractWaitEvents(steps, insideWait = false) {
 }
 
 // src/internal/support/reporter-version.ts
-var fs8 = __toESM(require("fs"));
-var path7 = __toESM(require("path"));
+var fs9 = __toESM(require("fs"));
+var path8 = __toESM(require("path"));
 var cachedVersion = null;
 var CANDIDATE_OFFSETS = ["..", "../../.."];
 function findOwnPackageJson(fromDir) {
   for (const offset of CANDIDATE_OFFSETS) {
     try {
-      const pkgPath = path7.resolve(fromDir, offset, "package.json");
-      const pkg = JSON.parse(fs8.readFileSync(pkgPath, "utf-8"));
+      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 };
     } catch {
@@ -1694,11 +1732,11 @@ function getReporterVersion() {
 }
 
 // src/internal/support/source-snippet.ts
-var fs9 = __toESM(require("fs"));
-var path8 = __toESM(require("path"));
+var fs10 = __toESM(require("fs"));
+var path9 = __toESM(require("path"));
 function readSourceSnippet(file, declLine, context, failingLine) {
   try {
-    const content = fs9.readFileSync(file, "utf-8");
+    const content = fs10.readFileSync(file, "utf-8");
     const lines = content.split("\n");
     const anchor = failingLine ?? declLine;
     const start = Math.max(0, anchor - context - 1);
@@ -1735,18 +1773,18 @@ function collectSourceFrames(errorText, testFile, declLine, opts = {}) {
     while ((m = stackRe.exec(errorText)) !== null && picked.length < maxFrames) {
       let abs;
       try {
-        abs = path8.resolve(m[1]);
+        abs = path9.resolve(m[1]);
       } catch {
         continue;
       }
-      if (abs.includes(`${path8.sep}node_modules${path8.sep}`)) continue;
-      const rel = path8.relative(projectRoot, abs);
-      if (rel.startsWith("..") || path8.isAbsolute(rel)) continue;
+      if (abs.includes(`${path9.sep}node_modules${path9.sep}`)) continue;
+      const rel = path9.relative(projectRoot, abs);
+      if (rel.startsWith("..") || path9.isAbsolute(rel)) continue;
       const line = parseInt(m[2], 10);
       if (!isNaN(line)) add(abs, line);
     }
   }
-  const absTest = path8.resolve(testFile);
+  const absTest = path9.resolve(testFile);
   if (!picked.some((p) => p.absFile === absTest)) {
     add(absTest, extractFailingLine(errorText, testFile, declLine));
   }
@@ -1754,19 +1792,19 @@ function collectSourceFrames(errorText, testFile, declLine, opts = {}) {
   for (const p of picked.slice(0, maxFrames)) {
     const snippet = readSourceSnippet(p.absFile, p.line, context, p.line);
     if (snippet) {
-      frames.push({ file: path8.relative(projectRoot, p.absFile) || path8.basename(p.absFile), line: p.line, snippet });
+      frames.push({ file: path9.relative(projectRoot, p.absFile) || path9.basename(p.absFile), line: p.line, snippet });
     }
   }
   return frames;
 }
 function extractFailingLine(errorText, testFile, declarationLine) {
   if (!errorText) return declarationLine;
-  const expectedFile = path8.resolve(testFile);
+  const expectedFile = path9.resolve(testFile);
   const stackRe = /^\s+at (?:[^(]*\()?(.+?):(\d+):\d+\)?\s*$/gm;
   let m;
   while ((m = stackRe.exec(errorText)) !== null) {
     try {
-      const frameFile = path8.resolve(m[1]);
+      const frameFile = path9.resolve(m[1]);
       if (frameFile === expectedFile) {
         const line = parseInt(m[2], 10);
         if (!isNaN(line)) return line;
@@ -1839,18 +1877,29 @@ function detectCliFileFilters(argv = process.argv) {
 }
 
 // src/public/global-setup.ts
-var path9 = __toESM(require("path"));
-var fs10 = __toESM(require("fs"));
+var path10 = __toESM(require("path"));
+var fs11 = __toESM(require("fs"));
+
+// src/internal/support/run-mode.ts
+var PW_UI_FLAGS = ["--ui", "--ui-host", "--ui-port"];
+function isUiMode(argv = process.argv) {
+  const args = argv.slice(2);
+  const testIdx = args.indexOf("test");
+  const rest = testIdx >= 0 ? args.slice(testIdx + 1) : args;
+  return rest.some((tok) => PW_UI_FLAGS.some((flag) => tok === flag || tok.startsWith(`${flag}=`)));
+}
+
+// src/public/global-setup.ts
 function createGlobalSetup(options, userSetup) {
   return async function globalSetupFn(config) {
-    const piwiReporterPath = path9.resolve(__dirname, "./index.js");
+    const piwiReporterPath = path10.resolve(__dirname, "./index.js");
     let inlineReporterOptions = {};
     if (Array.isArray(config?.reporter)) {
       for (const r of config.reporter) {
         if (!Array.isArray(r) || typeof r[0] !== "string") continue;
         const isPiwi = r[0].toLowerCase().includes("piwi") || (() => {
           try {
-            return path9.resolve(require.resolve(r[0])) === piwiReporterPath;
+            return path10.resolve(require.resolve(r[0])) === piwiReporterPath;
           } catch {
             return false;
           }
@@ -1863,6 +1912,11 @@ function createGlobalSetup(options, userSetup) {
     }
     const opts = resolveOptions({ ...inlineReporterOptions, ...options });
     const logger = new Logger(opts.verbose ?? false);
+    if (isUiMode()) {
+      logger.debug("UI mode detected \u2014 skipping run registration.");
+      if (userSetup) return userSetup(config);
+      return;
+    }
     if (opts.enabled === false || !opts.serverUrl) {
       logger.info("Not enabled \u2014 set PIWI_DASHBOARD_URL or serverUrl to enable.");
       if (userSetup) return userSetup(config);
@@ -1872,7 +1926,7 @@ function createGlobalSetup(options, userSetup) {
       if (!Array.isArray(r) || typeof r[0] !== "string") return false;
       if (r[0].toLowerCase().includes("piwi")) return true;
       try {
-        return path9.resolve(require.resolve(r[0])) === piwiReporterPath;
+        return path10.resolve(require.resolve(r[0])) === piwiReporterPath;
       } catch {
         return false;
       }
@@ -1904,7 +1958,7 @@ function createGlobalSetup(options, userSetup) {
         auth
       );
       if (response?.runId && response?.setupToken) {
-        fs10.writeFileSync(
+        fs11.writeFileSync(
           getSetupFilePath(opts.projectName),
           JSON.stringify({
             runId: response.runId,
@@ -1922,8 +1976,8 @@ function createGlobalSetup(options, userSetup) {
 }
 
 // src/public/config-wrapper.ts
-var path10 = __toESM(require("path"));
-var fs11 = __toESM(require("fs"));
+var path11 = __toESM(require("path"));
+var fs12 = __toESM(require("fs"));
 var PIWI_MODULE = "@piwitests/reporter";
 function isPiwiReporterEntry(entry) {
   if (typeof entry === "string") return entry.toLowerCase().includes("piwi");
@@ -1941,11 +1995,11 @@ function injectReporter(reporter, piwiOptions) {
 }
 function resolveSetupModule() {
   const candidates = [
-    path10.join(__dirname, "global-setup-module.js"),
-    path10.join(__dirname, "..", "global-setup-module.js"),
-    path10.join(__dirname, "..", "global-setup-module.ts")
+    path11.join(__dirname, "global-setup-module.js"),
+    path11.join(__dirname, "..", "global-setup-module.js"),
+    path11.join(__dirname, "..", "global-setup-module.ts")
   ];
-  return candidates.find((candidate) => fs11.existsSync(candidate)) ?? candidates[0];
+  return candidates.find((candidate) => fs12.existsSync(candidate)) ?? candidates[0];
 }
 function wrapConfig(config, piwiOptions) {
   if (piwiOptions) applyOptionsToEnv(piwiOptions);
@@ -1962,7 +2016,7 @@ function wrapConfig(config, piwiOptions) {
   };
 }
 
-// src/internal/collect/skip-classify.ts
+// ../packages/core/src/status-classify.ts
 function mergeAnnotations(test, result) {
   const out = [];
   const seen = /* @__PURE__ */ new Set();
@@ -1982,13 +2036,99 @@ function classifyStatus(rawStatus, annotations) {
   return intentional ? "skipped" : "didnotrun";
 }
 
+// ../packages/core/src/test-meta.ts
+var PIWI_ANNOTATION_PREFIX = "piwi:";
+var TEST_PRIORITIES = ["critical", "high", "medium", "low"];
+var MAX_TEST_TAGS = 20;
+var MAX_TEST_TAG_CHARS = 60;
+var MAX_TEST_META_CHARS = 120;
+var MAX_TEST_LINK_CHARS = 500;
+var PRIORITY_SET = new Set(TEST_PRIORITIES);
+function cleanString(value, maxChars) {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  if (!trimmed) return void 0;
+  return trimmed.slice(0, maxChars);
+}
+function normalizeTestTags(raw) {
+  if (!Array.isArray(raw)) return [];
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const entry of raw) {
+    if (typeof entry !== "string") continue;
+    const tag = entry.trim().replace(/^@+/, "").trim().slice(0, MAX_TEST_TAG_CHARS);
+    if (!tag || seen.has(tag)) continue;
+    seen.add(tag);
+    out.push(tag);
+    if (out.length >= MAX_TEST_TAGS) break;
+  }
+  return out;
+}
+function normalizeLink(value) {
+  const raw = cleanString(value, MAX_TEST_LINK_CHARS);
+  if (!raw) return void 0;
+  try {
+    const { protocol } = new URL(raw);
+    return protocol === "http:" || protocol === "https:" ? raw : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function parseTestMetadata(annotations) {
+  if (!Array.isArray(annotations)) return null;
+  const meta = {};
+  for (const entry of annotations) {
+    if (!entry || typeof entry !== "object") continue;
+    const { type, description } = entry;
+    if (typeof type !== "string") continue;
+    const lower = type.trim().toLowerCase();
+    if (!lower.startsWith(PIWI_ANNOTATION_PREFIX)) continue;
+    const field = lower.slice(PIWI_ANNOTATION_PREFIX.length);
+    switch (field) {
+      case "owner": {
+        const value = cleanString(description, MAX_TEST_META_CHARS);
+        if (value) meta.owner = value;
+        break;
+      }
+      case "priority": {
+        const value = cleanString(description, MAX_TEST_META_CHARS)?.toLowerCase();
+        if (value && PRIORITY_SET.has(value)) meta.priority = value;
+        break;
+      }
+      case "feature": {
+        const value = cleanString(description, MAX_TEST_META_CHARS);
+        if (value) meta.feature = value;
+        break;
+      }
+      case "link": {
+        const value = normalizeLink(description);
+        if (value) meta.link = value;
+        break;
+      }
+      default:
+        break;
+    }
+  }
+  return Object.keys(meta).length > 0 ? meta : null;
+}
+
+// src/internal/collect/test-meta.ts
+function collectTestTags(test) {
+  return normalizeTestTags(test.tags);
+}
+function collectTestMetadata(annotations) {
+  return parseTestMetadata(annotations);
+}
+
 // src/internal/collect/error-text.ts
-var path11 = __toESM(require("path"));
-function buildErrorText(result) {
-  if (!result.errors || result.errors.length === 0) return null;
+var path12 = __toESM(require("path"));
+
+// ../packages/core/src/error-text.ts
+function joinErrorMessages(errors) {
+  if (!errors || errors.length === 0) return null;
   const seen = /* @__PURE__ */ new Set();
   const parts = [];
-  for (const err of result.errors) {
+  for (const err of errors) {
     const msg = err.message ?? "";
     if (!msg) continue;
     const dedupeKey = msg.trim().slice(0, 200);
@@ -1996,21 +2136,27 @@ function buildErrorText(result) {
     seen.add(dedupeKey);
     parts.push(msg);
   }
-  let text = parts.join("\n---\n");
+  return parts.join("\n---\n") || null;
+}
+function appendErrorLocation(text, location) {
+  if (!location?.file || /\n\s+at\s/.test(text)) return text;
+  return `${text}
+    at ${location.file}:${location.line}:${location.column}`;
+}
+
+// src/internal/collect/error-text.ts
+function buildErrorText(result) {
+  const text = joinErrorMessages(result.errors);
   if (!text) return null;
-  const primary = result.error;
-  const loc = primary?.location;
-  if (loc?.file && !/\n\s+at\s/.test(text)) {
-    const rel = path11.relative(process.cwd(), loc.file).split(path11.sep).join("/");
-    text += `
-    at ${rel}:${loc.line}:${loc.column}`;
-  }
-  return text;
+  const loc = result.error?.location;
+  if (!loc?.file) return text;
+  const rel = path12.relative(process.cwd(), loc.file).split(path12.sep).join("/");
+  return appendErrorLocation(text, { file: rel, line: loc.line, column: loc.column });
 }
 
 // src/internal/support/ci-output.ts
-var fs12 = __toESM(require("fs"));
-var path12 = __toESM(require("path"));
+var fs13 = __toESM(require("fs"));
+var path13 = __toESM(require("path"));
 function emitRunOutputs(output, logger, outputFile, env = process.env) {
   logger.info(`View run: ${output.runUrl}`);
   if (outputFile) writeOutputFile(outputFile, output, logger);
@@ -2019,9 +2165,9 @@ function emitRunOutputs(output, logger, outputFile, env = process.env) {
 }
 function writeOutputFile(file, output, logger) {
   try {
-    const dir = path12.dirname(file);
-    if (dir && dir !== ".") fs12.mkdirSync(dir, { recursive: true });
-    fs12.writeFileSync(
+    const dir = path13.dirname(file);
+    if (dir && dir !== ".") fs13.mkdirSync(dir, { recursive: true });
+    fs13.writeFileSync(
       file,
       JSON.stringify(
         {
@@ -2073,7 +2219,7 @@ function emitGitLabDotenv(output, env, logger) {
   if (output.projectId != null) lines.push(`PIWI_PROJECT_ID=${output.projectId}`);
   if (output.ciBuildUrl) lines.push(`PIWI_CI_BUILD_URL=${output.ciBuildUrl}`);
   try {
-    fs12.writeFileSync(file, lines.join("\n") + "\n");
+    fs13.writeFileSync(file, lines.join("\n") + "\n");
     logger.info(`Wrote GitLab dotenv report to ${file} (declare it as artifacts:reports:dotenv)`);
   } catch (error) {
     logger.warn(`Failed to write GitLab dotenv file '${file}': ${errorMessage(error)}`);
@@ -2081,7 +2227,7 @@ function emitGitLabDotenv(output, env, logger) {
 }
 function appendFileLines(file, lines, logger, label) {
   try {
-    fs12.appendFileSync(file, lines.join("\n") + "\n");
+    fs13.appendFileSync(file, lines.join("\n") + "\n");
   } catch (error) {
     logger.warn(`Failed to write GitHub Actions ${label}: ${errorMessage(error)}`);
   }
@@ -2298,7 +2444,7 @@ var RunSubmitter = class {
 
 // src/public/reporter.ts
 function testLocation(test) {
-  const relativeFilePath = path13.relative(process.cwd(), test.location.file).split(path13.sep).join("/");
+  const relativeFilePath = path14.relative(process.cwd(), test.location.file).split(path14.sep).join("/");
   return `${relativeFilePath}:${test.location.line}:${test.location.column}`;
 }
 var PiwiDashboardReporter = class {
@@ -2327,6 +2473,7 @@ var PiwiDashboardReporter = class {
     this.setupSteps = [];
     this.options = resolveOptions(rawOptions);
     this.enabled = this.options.enabled !== false && !!this.options.serverUrl;
+    this.viaDesktopApp = usedDesktopDiscovery();
     this.runLabel = this.options.runLabel || detectCiRunLabel();
     this.instanceId = computeInstanceId(this.options.projectName, this.runLabel);
     const logger = new Logger(this.options.verbose ?? false);
@@ -2363,6 +2510,9 @@ var PiwiDashboardReporter = class {
       this.logger.info("Not enabled \u2014 set PIWI_DASHBOARD_URL or serverUrl to enable.");
       return;
     }
+    if (this.viaDesktopApp) {
+      this.logger.info(`Using the desktop app running at ${this.options.serverUrl} (no serverUrl configured).`);
+    }
     this.startTime = (/* @__PURE__ */ new Date()).toISOString();
     this.playwrightVersion = config.version;
     this.logger.info(
@@ -2473,6 +2623,7 @@ var PiwiDashboardReporter = class {
     const { suitePath, suiteConfig } = this.metadataCollector.getSuiteInfo(test);
     const annotations = mergeAnnotations(test, result);
     const status = classifyStatus(result.status, annotations);
+    const tags = collectTestTags(test);
     const testCase = {
       type: "complete",
       title: test.title,
@@ -2491,7 +2642,9 @@ var PiwiDashboardReporter = class {
       browser: this.metadataCollector.getBrowserConfig(test) || void 0,
       suitePath,
       suiteConfig,
-      testAnnotations: annotations.length ? annotations : null
+      testAnnotations: annotations.length ? annotations : null,
+      tags: tags.length ? tags : null,
+      testMeta: collectTestMetadata(annotations)
     };
     if (result.status === "failed" || result.status === "timedOut") {
       const failingLine = extractFailingLine(testCase.error, test.location.file, test.location.line);
@@ -2551,6 +2704,8 @@ var PiwiDashboardReporter = class {
     for (const test of this.plannedTests) {
       if (this.reportedTestIds.has(test.id)) continue;
       const { suitePath, suiteConfig } = this.metadataCollector.getSuiteInfo(test);
+      const declaredAnnotations = test.annotations ?? [];
+      const tags = collectTestTags(test);
       const testCase = {
         type: "complete",
         title: test.title,
@@ -2567,7 +2722,9 @@ var PiwiDashboardReporter = class {
         browser: this.metadataCollector.getBrowserConfig(test) || void 0,
         suitePath,
         suiteConfig,
-        testAnnotations: test.annotations?.length ? test.annotations : null
+        testAnnotations: declaredAnnotations.length ? declaredAnnotations : null,
+        tags: tags.length ? tags : null,
+        testMeta: collectTestMetadata(declaredAnnotations)
       };
       this.testCases.push(testCase);
       this.totalTests++;
@@ -2610,7 +2767,7 @@ var PiwiDashboardReporter = class {
 var import_node_zlib = require("zlib");
 
 // src/internal/capture/locator-healing.ts
-var path14 = __toESM(require("path"));
+var path15 = __toESM(require("path"));
 
 // ../packages/core/src/locator-fingerprint.ts
 var PRESENT_SIMILARITY = 0.8;
@@ -3049,6 +3206,34 @@ var ACTION_METHODS = [
   "waitFor"
 ];
 var LOCATOR_CREATING_CHAINS = new Set(LOCATOR_METHODS);
+var EXPECT_METHOD = "_expect";
+var EXPECT_CAPTURE_EXPRESSIONS = /* @__PURE__ */ new Set([
+  "to.be.attached",
+  "to.be.checked",
+  "to.be.disabled",
+  "to.be.editable",
+  "to.be.empty",
+  "to.be.enabled",
+  "to.be.focused",
+  "to.be.in.viewport",
+  "to.be.readonly",
+  "to.be.visible",
+  "to.contain.class",
+  "to.contain.text",
+  "to.have.accessible.description",
+  "to.have.accessible.error.message",
+  "to.have.accessible.name",
+  "to.have.attribute",
+  "to.have.attribute.value",
+  "to.have.class",
+  "to.have.css",
+  "to.have.id",
+  "to.have.js.property",
+  "to.have.role",
+  "to.have.text",
+  "to.have.value",
+  "to.match.aria"
+]);
 function extractAccessibleName(ariaSnapshot) {
   if (!ariaSnapshot) return null;
   const match = ariaSnapshot.match(/- \w+ "([^"]+)"/);
@@ -3135,6 +3320,7 @@ function suggestLocatorsFromAria(failed, ariaSnapshot) {
 function captureCallerLocation(stack = new Error().stack ?? "") {
   const lines = stack.split("\n");
   let prevWasCaptureModule = false;
+  let selfFile = null;
   for (let i = 1; i < lines.length; i++) {
     const line = lines[i].trim();
     if (!line.startsWith("at")) continue;
@@ -3153,6 +3339,11 @@ function captureCallerLocation(stack = new Error().stack ?? "") {
       prevWasCaptureModule = false;
       continue;
     }
+    if (selfFile === null || file === selfFile) {
+      selfFile ??= file;
+      prevWasCaptureModule = /[\\/]locator-healing\.[a-z]+$/i.test(file);
+      continue;
+    }
     if (/[\\/]locator-healing\.[a-z]+$/i.test(file)) {
       prevWasCaptureModule = true;
       continue;
@@ -3167,10 +3358,10 @@ function captureCallerLocation(stack = new Error().stack ?? "") {
     }
     let rel = file;
     try {
-      rel = path14.relative(process.cwd(), file);
+      rel = path15.relative(process.cwd(), file);
     } catch {
     }
-    rel = rel.split(path14.sep).join("/");
+    rel = rel.split(path15.sep).join("/");
     if (rel.startsWith("./")) rel = rel.slice(2);
     return `${rel}:${m[3]}:${m[4]}`;
   }
@@ -3213,7 +3404,7 @@ function inspectionGateFromTestInfo(testInfo, enabled = process.env.PIWI_INSPECT
 }
 
 // src/internal/capture/pick-on-failure.ts
-var path15 = __toESM(require("path"));
+var path16 = __toESM(require("path"));
 var ANSI_RE = /\[[0-9;]*m/g;
 function endOfString(s, start) {
   const q = s[start];
@@ -3307,7 +3498,7 @@ ${err.stack ?? ""}`.replace(ANSI_RE, "");
     const parsed = parseLeafLocatorExpression(line[1].trim());
     if (!parsed) continue;
     const loc = err.location;
-    const location = loc ? `${path15.relative(process.cwd(), loc.file).split(path15.sep).join("/")}:${loc.line}:${loc.column}` : null;
+    const location = loc ? `${path16.relative(process.cwd(), loc.file).split(path16.sep).join("/")}:${loc.line}:${loc.column}` : null;
     return { method: parsed.method, args: parsed.args, location };
   }
   return null;
@@ -4072,6 +4263,7 @@ function createSink() {
     capturedLocators: [],
     capturePromises: [],
     failedLocators: [],
+    expectCapturedLocations: /* @__PURE__ */ new Set(),
     lastActivePage: null,
     testInfo: null,
     stashedWebVitals: null,
@@ -4475,6 +4667,53 @@ function probeElementAttrs(el, arg) {
     ancestors
   };
 }
+function startElementCapture(sink, target, seq, callerLocation, used) {
+  const probe = target.evaluate(probeElementAttrs, CAPTURED_ATTRS_ARG);
+  const settledProbe = probe.then(
+    () => void 0,
+    () => void 0
+  );
+  PENDING_PROBES.add(settledProbe);
+  settledProbe.then(() => PENDING_PROBES.delete(settledProbe));
+  sink.capturePromises.push(settledProbe);
+  const resolveAttrs = (async () => {
+    let deadline;
+    try {
+      const attrs = await Promise.race([
+        probe,
+        new Promise((_, reject) => {
+          deadline = setTimeout(() => reject(new Error("locator capture timeout")), 500);
+        })
+      ]);
+      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 });
+      sink.capturedLocators[seq] = {
+        location: callerLocation,
+        used,
+        // hasLabel/selectorCounts inform alternative generation only —
+        // keep the stored element to the wire shape. rolePosition and
+        // ancestors ARE wire fields: the server's renamed-element match
+        // uses them at heal time.
+        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 } : {}
+        },
+        alternatives: generateAlternatives({ ...attrs, accessibleName })
+      };
+    } catch {
+    } finally {
+      clearTimeout(deadline);
+    }
+  })();
+  sink.capturePromises.push(resolveAttrs);
+}
 function wrapLocator(page, locator, originMethod, originArgs) {
   return new Proxy(locator, {
     get(target, prop) {
@@ -4490,6 +4729,38 @@ function wrapLocator(page, locator, originMethod, originArgs) {
           return wrapLocator(page, next, originMethod, originArgs);
         };
       }
+      if (prop === EXPECT_METHOD) {
+        return async (...callArgs) => {
+          const sink = currentSink;
+          const expression = typeof callArgs[0] === "string" ? callArgs[0] : "";
+          const isNot = Boolean(callArgs[1]?.isNot);
+          if (!sink || isNot || !EXPECT_CAPTURE_EXPRESSIONS.has(expression)) {
+            return fn.apply(target, callArgs);
+          }
+          sink.lastActivePage = page;
+          const callerLocation = captureCallerLocation();
+          const used = {
+            method: originMethod,
+            args: originArgs,
+            raw: `${originMethod}(${JSON.stringify(originArgs)})`
+          };
+          const alreadyCaptured = callerLocation !== null && sink.expectCapturedLocations.has(callerLocation);
+          let seq = -1;
+          if (!alreadyCaptured) {
+            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);
+          } else if (matches === false) {
+            sink.failedLocators.push({ method: originMethod, args: originArgs, location: callerLocation });
+          }
+          return result;
+        };
+      }
       if (!ACTION_METHOD_SET.has(prop)) return original;
       return async (...callArgs) => {
         const sink = currentSink;
@@ -4515,51 +4786,7 @@ function wrapLocator(page, locator, originMethod, originArgs) {
           sink.failedLocators.push({ method: originMethod, args: originArgs, location: callerLocation });
           throw error;
         }
-        const probe = target.evaluate(probeElementAttrs, CAPTURED_ATTRS_ARG);
-        const settledProbe = probe.then(
-          () => void 0,
-          () => void 0
-        );
-        PENDING_PROBES.add(settledProbe);
-        settledProbe.then(() => PENDING_PROBES.delete(settledProbe));
-        sink.capturePromises.push(settledProbe);
-        const resolveAttrs = (async () => {
-          let deadline;
-          try {
-            const attrs = await Promise.race([
-              probe,
-              new Promise((_, reject) => {
-                deadline = setTimeout(() => reject(new Error("locator capture timeout")), 500);
-              })
-            ]);
-            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 });
-            sink.capturedLocators[seq] = {
-              location: callerLocation,
-              used,
-              // hasLabel/selectorCounts inform alternative generation only —
-              // keep the stored element to the wire shape. rolePosition and
-              // ancestors ARE wire fields: the server's renamed-element match
-              // uses them at heal time.
-              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 } : {}
-              },
-              alternatives: generateAlternatives({ ...attrs, accessibleName })
-            };
-          } catch {
-          } finally {
-            clearTimeout(deadline);
-          }
-        })();
-        sink.capturePromises.push(resolveAttrs);
+        startElementCapture(sink, target, seq, callerLocation, used);
         return result;
       };
     }