@piwitests/reporter 0.23.0 → 0.25.0

package/dist/internal/capture/attachments.d.ts

@@ -14,6 +14,8 @@ declare const ATTACHMENT_NAMES: {
     readonly locatorSuggestion: "piwi-locator-suggestion";
     readonly pageState: "piwi-page-state";
     readonly userPick: "piwi-user-pick";
+    readonly aiUsage: "piwi-ai-usage";
+    readonly aiMeta: "piwi-ai-meta";
 };
 /** Set of every internal attachment name — used to skip them when collecting user attachments. */
 declare const INTERNAL_ATTACHMENT_NAMES: ReadonlySet<string>;

package/dist/internal/capture/attachments.js

@@ -34,7 +34,9 @@ var ATTACHMENT_NAMES = {
   webVitals: "piwi-web-vitals",
   locatorSuggestion: "piwi-locator-suggestion",
   pageState: "piwi-page-state",
-  userPick: "piwi-user-pick"
+  userPick: "piwi-user-pick",
+  aiUsage: "piwi-ai-usage",
+  aiMeta: "piwi-ai-meta"
 };
 var INTERNAL_ATTACHMENT_NAMES = new Set(Object.values(ATTACHMENT_NAMES));
 var LOCATOR_SUGGESTION_ANNOTATION = ATTACHMENT_NAMES.locatorSuggestion;

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

@@ -309,7 +309,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,
@@ -1013,6 +1022,7 @@ var CAPTURED_ATTRIBUTES = [
   "alt",
   "title",
   "aria-label",
+  "aria-labelledby",
   "aria-level",
   "role",
   "type",
@@ -1548,6 +1558,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",
@@ -1685,7 +1732,9 @@ var ATTACHMENT_NAMES = {
   webVitals: "piwi-web-vitals",
   locatorSuggestion: "piwi-locator-suggestion",
   pageState: "piwi-page-state",
-  userPick: "piwi-user-pick"
+  userPick: "piwi-user-pick",
+  aiUsage: "piwi-ai-usage",
+  aiMeta: "piwi-ai-meta"
 };
 var INTERNAL_ATTACHMENT_NAMES = new Set(Object.values(ATTACHMENT_NAMES));
 var LOCATOR_SUGGESTION_ANNOTATION = ATTACHMENT_NAMES.locatorSuggestion;
@@ -2007,7 +2056,7 @@ function createSink() {
     capturedLocators: [],
     capturePromises: [],
     failedLocators: [],
-    expectCapturedLocations: /* @__PURE__ */ new Set(),
+    probedLocations: /* @__PURE__ */ new Set(),
     lastActivePage: null,
     testInfo: null,
     stashedWebVitals: null,
@@ -2234,7 +2283,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,
@@ -2243,11 +2291,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 {
@@ -2266,8 +2335,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
@@ -2286,8 +2355,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,
@@ -2307,6 +2377,7 @@ function startElementCapture(sink, target, seq, callerLocation, used) {
         alternatives: generateAlternatives({ ...attrs, accessibleName })
       };
     } catch {
+      if (callerLocation) sink.probedLocations.delete(callerLocation);
     } finally {
       clearTimeout(deadline);
     }
@@ -2343,17 +2414,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 });
           }
@@ -2365,19 +2436,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);
@@ -2385,7 +2460,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;
       };
     }
@@ -2418,6 +2496,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;
@@ -2482,6 +2563,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);

package/dist/internal/capture/locator-healing.d.ts

@@ -83,6 +83,33 @@ declare const EXPECT_CAPTURE_EXPRESSIONS: ReadonlySet<string>;
  * Returns the first quoted string after the role, or null if none found.
  */
 declare function extractAccessibleName(ariaSnapshot: string | null): string | null;
+/** Tags whose accessible name comes from an associated `<label>`. */
+declare const FORM_FIELD_TAGS: ReadonlySet<string>;
+/**
+ * Roles whose accessible name is computed from the element's own content. For
+ * these, an element carrying neither `aria-label` nor `aria-labelledby` is
+ * named by its trimmed text — which the probe already returns.
+ */
+declare const NAME_FROM_CONTENT_ROLES: ReadonlySet<string>;
+/** The subset of a probe result the accessible-name shortcut reads. */
+interface NameSource {
+    tagName: string;
+    attributes: Record<string, string | null>;
+    textContent: string | null;
+    labelText?: string | null;
+}
+/**
+ * The accessible name when the probed attributes already settle it, or null
+ * when only the browser can. Capture consults this before spending an
+ * `ariaSnapshot()` round trip on an element: in each case below the name is
+ * what the accessible-name computation would return anyway, so the round trip
+ * would buy nothing.
+ *
+ * Deliberately narrow — anything outside these cases (an `aria-labelledby`
+ * reference, an image named by `alt`, an element with no text) still goes to
+ * the browser, because a wrong name here becomes a wrong `getByRole` locator.
+ */
+declare function exactAccessibleName(attrs: NameSource, role: string | null): string | null;
 /** A failed locator action, used to suggest a fresh locator from the live page. */
 interface FailedLocatorInfo {
     method: string;
@@ -126,4 +153,4 @@ declare function suggestLocatorsFromAria(failed: FailedLocatorInfo, ariaSnapshot
  */
 declare function captureCallerLocation(stack?: string): string | null;
 
-export { ACTION_METHODS, CHAIN_METHODS, EXPECT_CAPTURE_EXPRESSIONS, EXPECT_METHOD, type FailedLocatorInfo, LOCATOR_CREATING_CHAINS, LOCATOR_METHODS, type LocatorSuggestion, captureCallerLocation, dedupeSnapshotsByLocation, extractAccessibleName, renderFailing, suggestLocatorsFromAria };
+export { ACTION_METHODS, CHAIN_METHODS, EXPECT_CAPTURE_EXPRESSIONS, EXPECT_METHOD, FORM_FIELD_TAGS, type FailedLocatorInfo, LOCATOR_CREATING_CHAINS, LOCATOR_METHODS, type LocatorSuggestion, NAME_FROM_CONTENT_ROLES, type NameSource, captureCallerLocation, dedupeSnapshotsByLocation, exactAccessibleName, extractAccessibleName, renderFailing, suggestLocatorsFromAria };

package/dist/internal/capture/locator-healing.js

@@ -35,14 +35,17 @@ __export(locator_healing_exports, {
   CHAIN_METHODS: () => CHAIN_METHODS,
   EXPECT_CAPTURE_EXPRESSIONS: () => EXPECT_CAPTURE_EXPRESSIONS,
   EXPECT_METHOD: () => EXPECT_METHOD,
+  FORM_FIELD_TAGS: () => FORM_FIELD_TAGS,
   INPUT_TYPE_TO_ROLE: () => INPUT_TYPE_TO_ROLE,
   LOCATOR_CREATING_CHAINS: () => LOCATOR_CREATING_CHAINS,
   LOCATOR_METHODS: () => LOCATOR_METHODS,
+  NAME_FROM_CONTENT_ROLES: () => NAME_FROM_CONTENT_ROLES,
   TAG_TO_ROLE: () => TAG_TO_ROLE,
   approximateAccessibleName: () => approximateAccessibleName,
   captureCallerLocation: () => captureCallerLocation,
   classifyCssStability: () => classifyCssStability,
   dedupeSnapshotsByLocation: () => dedupeSnapshotsByLocation,
+  exactAccessibleName: () => exactAccessibleName,
   extractAccessibleName: () => extractAccessibleName,
   generateAlternatives: () => generateAlternatives,
   headingLevel: () => headingLevel,
@@ -195,6 +198,7 @@ var CAPTURED_ATTRIBUTES = [
   "alt",
   "title",
   "aria-label",
+  "aria-labelledby",
   "aria-level",
   "role",
   "type",
@@ -573,6 +577,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",
@@ -707,14 +748,17 @@ function captureCallerLocation(stack = new Error().stack ?? "") {
   CHAIN_METHODS,
   EXPECT_CAPTURE_EXPRESSIONS,
   EXPECT_METHOD,
+  FORM_FIELD_TAGS,
   INPUT_TYPE_TO_ROLE,
   LOCATOR_CREATING_CHAINS,
   LOCATOR_METHODS,
+  NAME_FROM_CONTENT_ROLES,
   TAG_TO_ROLE,
   approximateAccessibleName,
   captureCallerLocation,
   classifyCssStability,
   dedupeSnapshotsByLocation,
+  exactAccessibleName,
   extractAccessibleName,
   generateAlternatives,
   headingLevel,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@piwitests/reporter",
-  "version": "0.23.0",
+  "version": "0.25.0",
   "description": "Playwright reporter that streams results, traces and HTML reports to a Piwi Dashboard instance",
   "url": "https://github.com/PiwiTests/platform",
   "homepage": "https://piwitests.github.io",
@@ -51,6 +51,10 @@
     "reporter:test:coverage": "vitest run --coverage",
     "reporter:test:watch": "vitest",
     "reporter:test:integration": "npm run reporter:build && playwright test --config=tests/integration/playwright.config.ts",
+    "reporter:test:integration:ai": "npm run reporter:build && node tests/integration/ai/run.mjs",
+    "reporter:test:integration:ai:live": "npm run reporter:build && playwright test --config=tests/integration/ai/live.config.ts",
+    "reporter:bench": "npm run reporter:build && node tests/bench/run.mjs",
+    "reporter:bench:micro": "vitest bench --run",
     "test": "npm run reporter:test",
     "prepublishOnly": "npm run reporter:build"
   },
@@ -58,6 +62,9 @@
     "dist/",
     "templates/"
   ],
+  "engines": {
+    "node": ">=20"
+  },
   "peerDependencies": {
     "@playwright/test": "^1.61.1"
   },