@qanalyzer/forge-playwright 1.1.2 → 1.2.0

package/dist/helpers.d.ts

@@ -1,6 +1,6 @@
 /**
  * Programmatic helpers for Playwright tests (FR111).
- * Prefer Jira issue keys in `test('AUTH-101 ...')` titles (FR43).
+ * Prefer `qa.issueKey()` / `qa.issueKeys()` for FR43 (title keys remain a fallback).
  *
  * Steps: use Playwright native `test.step()` — do **not** use `qa.step` (FR112).
  *
@@ -16,6 +16,10 @@ export type QaHelpers = {
     suite(value: string): void;
     fields(values: Record<string, string>): void;
     parameters(values: Record<string, string>): void;
+    /** Explicit FR43 issue key (preferred over embedding in titles). */
+    issueKey(key: string): void;
+    /** Explicit FR43 issue keys (preferred over embedding in titles). */
+    issueKeys(keys: string[]): void;
     ignore(): void;
     /** Attach metadata; with content/path, attempts Forge upload (FR119). */
     attach(attach: {

package/dist/helpers.js

@@ -1,7 +1,7 @@
 "use strict";
 /**
  * Programmatic helpers for Playwright tests (FR111).
- * Prefer Jira issue keys in `test('AUTH-101 ...')` titles (FR43).
+ * Prefer `qa.issueKey()` / `qa.issueKeys()` for FR43 (title keys remain a fallback).
  *
  * Steps: use Playwright native `test.step()` — do **not** use `qa.step` (FR112).
  *
@@ -69,6 +69,12 @@ exports.qa = {
     parameters(values) {
         pushMeta('qa-parameters', values, { parameters: values });
     },
+    issueKey(key) {
+        pushMeta('qa-issue-key', key, { issueKeys: [key] });
+    },
+    issueKeys(keys) {
+        pushMeta('qa-issue-keys', keys, { issueKeys: keys });
+    },
     ignore() {
         pushMeta('qa-ignore', true, { ignore: true });
     },

package/dist/metadata-from-result.js

@@ -32,6 +32,9 @@ function buildQaMetaFromResult(input) {
             if (message.parameters) {
                 (0, forge_commons_1.applyQaAnnotation)(acc, { type: 'qa-parameters', body: message.parameters });
             }
+            if (message.issueKeys?.length) {
+                (0, forge_commons_1.applyQaAnnotation)(acc, { type: 'qa-issue-keys', body: message.issueKeys });
+            }
             if (message.ignore)
                 (0, forge_commons_1.applyQaAnnotation)(acc, { type: 'qa-ignore', body: true });
             for (const att of message.attachments ?? []) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qanalyzer/forge-playwright",
-  "version": "1.1.2",
-  "description": "QAnalyzer Playwright reporter \u2014 ingest or file modes via @qanalyzer/forge-commons",
+  "version": "1.2.0",
+  "description": "QAnalyzer Playwright reporter — ingest or file modes via @qanalyzer/forge-commons",
   "keywords": [
     "qanalyzer",
     "playwright",