@sungen/driver-ui 3.2.35 → 3.3.0-alpha.10

package/dist/trace-identity/aria-snapshot-head.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The head line of a Playwright `locator.ariaSnapshot()` → role, accessible name, heading level.
+ *
+ * Owned here on purpose (G5): the spike loaded Playwright's private aria-YAML parser by absolute
+ * path, which breaks on any internal move. We only ever need the FIRST node of a single element's
+ * snapshot, whose grammar is small and documented in Playwright's aria snapshot docs:
+ *
+ *   - button "Login"
+ *   - heading "My Account" [level=1]
+ *   - textbox "Email": test@playground.dev      (a value after the colon)
+ *   - link "Products":                           (children on the next lines)
+ *   - text: Hi, Jane                             (a bare text node — no role)
+ *
+ * More than one top-level node (a fragment) has no single identity.
+ */
+export interface AriaHead {
+    role: string;
+    name: string;
+    level?: number;
+    note?: string;
+}
+export declare function parseAriaHead(yaml: string): AriaHead;
+//# sourceMappingURL=aria-snapshot-head.d.ts.map

package/dist/trace-identity/aria-snapshot-head.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aria-snapshot-head.d.ts","sourceRoot":"","sources":["../../src/trace-identity/aria-snapshot-head.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,QAAQ;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;AAQvF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CASpD"}

package/dist/trace-identity/aria-snapshot-head.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseAriaHead = parseAriaHead;
+const LINE = /^- ([a-zA-Z]+)(?: "((?:[^"\\]|\\.)*)")?((?: \[[^\]]*\])*)(?::.*)?$/;
+function unescape(raw) {
+    try {
+        return JSON.parse(`"${raw}"`);
+    }
+    catch {
+        return raw.replace(/\\"/g, '"');
+    }
+}
+function parseAriaHead(yaml) {
+    const top = yaml.split(/\r?\n/).filter((l) => l.startsWith('- '));
+    if (top.length !== 1)
+        return { role: 'generic', name: '', note: `fragment of ${top.length}` };
+    const m = LINE.exec(top[0].trimEnd());
+    if (!m)
+        return { role: 'generic', name: '', note: `unparsed: ${top[0].slice(0, 60)}` };
+    const role = m[1];
+    if (role === 'text')
+        return { role: 'text', name: '', note: 'text node' };
+    const level = /\[level=(\d)\]/.exec(m[3] ?? '')?.[1];
+    return { role, name: m[2] === undefined ? '' : unescape(m[2]), ...(level ? { level: Number(level) } : {}) };
+}
+//# sourceMappingURL=aria-snapshot-head.js.map

package/dist/trace-identity/aria-snapshot-head.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aria-snapshot-head.js","sourceRoot":"","sources":["../../src/trace-identity/aria-snapshot-head.ts"],"names":[],"mappings":";;AAuBA,sCASC;AAfD,MAAM,IAAI,GAAG,oEAAoE,CAAC;AAElF,SAAS,QAAQ,CAAC,GAAW;IAC3B,IAAI,CAAC;QAAC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,GAAG,CAAW,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAAC,CAAC;AAC7F,CAAC;AAED,SAAgB,aAAa,CAAC,IAAY;IACxC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAClE,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,eAAe,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;IAC9F,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACtC,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;IACvF,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAClB,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAC1E,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACrD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAC9G,CAAC"}

package/dist/trace-identity/playwright-identity-resolver.d.ts

@@ -0,0 +1,10 @@
+import type { CapabilityDescriptor } from '@sun-asterisk/sungen';
+type Resolver = NonNullable<CapabilityDescriptor['traceIdentity']>;
+type Input = Parameters<Resolver>[0];
+type Output = Awaited<ReturnType<Resolver>>;
+export declare const RESOLVER_ID = "driver-ui/playwright-aria@1";
+/** At most this many snapshots per call — a bound on work, not a sampling. */
+export declare const MAX_REQUESTS = 2000;
+export declare function resolveTraceIdentities(input: Input): Promise<Output>;
+export {};
+//# sourceMappingURL=playwright-identity-resolver.d.ts.map

package/dist/trace-identity/playwright-identity-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright-identity-resolver.d.ts","sourceRoot":"","sources":["../../src/trace-identity/playwright-identity-resolver.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAGjE,KAAK,QAAQ,GAAG,WAAW,CAAC,oBAAoB,CAAC,eAAe,CAAC,CAAC,CAAC;AACnE,KAAK,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AACrC,KAAK,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;AAM5C,eAAO,MAAM,WAAW,gCAAgC,CAAC;AAEzD,8EAA8E;AAC9E,eAAO,MAAM,YAAY,OAAO,CAAC;AAkEjC,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAyB1E"}

package/dist/trace-identity/playwright-identity-resolver.js

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_REQUESTS = exports.RESOLVER_ID = void 0;
+exports.resolveTraceIdentities = resolveTraceIdentities;
+/**
+ * `traceIdentity` for the UI capability (SPI §4.5, DOS-14.5): who a recorded action was aimed at,
+ * from Playwright's OWN accessibility engine on the replayed snapshot — the phase 07 method that
+ * agreed with the test's locator on 98/98 oracle-bearing actions over two real sites.
+ *
+ *   replay     the inert HTML core rendered, in a context with JavaScript disabled, offline,
+ *              service workers blocked, every request routed to abort AND Chromium's network
+ *              blocklist set to `*` (non-http schemes too) — nothing leaves the machine
+ *   identity   role + name from `ariaSnapshot()` of the element Playwright marked, re-resolved with
+ *              `getByRole(role, { name, exact })`: it must land on exactly that element
+ *   G3         if role+name matches several elements, look for a named scope (row, landmark,
+ *              dialog, card…) inside which it is unique; none → `low` (ambiguous)
+ *   low        any reason at all: core's caps (missing CSS, broken refs), no semantic role, empty
+ *              name, getByRole missing the target, ambiguity, a failed snapshot
+ * A missing browser is an ERROR, never a silent `low` for everything.
+ */
+const test_1 = require("@playwright/test");
+const aria_snapshot_head_1 = require("./aria-snapshot-head");
+const NAMELESS = new Set(['generic', 'none', 'presentation', 'text', 'fragment', 'paragraph']);
+const SCOPE_ROLES = ['row', 'listitem', 'article', 'dialog', 'alertdialog', 'form', 'group', 'tabpanel', 'region', 'navigation', 'complementary', 'search', 'banner', 'contentinfo', 'main', 'menu', 'list', 'table', 'grid'];
+exports.RESOLVER_ID = 'driver-ui/playwright-aria@1';
+/** At most this many snapshots per call — a bound on work, not a sampling. */
+exports.MAX_REQUESTS = 2000;
+async function launch() {
+    try {
+        return await test_1.chromium.launch({ headless: true });
+    }
+    catch (e) {
+        throw new Error(`trace identity needs Chromium for Playwright — run \`npx playwright install chromium\` (${e.message.split('\n')[0]})`);
+    }
+}
+/** A fresh page in a fresh isolated context: JS off, offline, SW blocked, every request aborted, CDP blocklist `*`. */
+async function isolatedPage(browser, counter) {
+    const context = await browser.newContext({ javaScriptEnabled: false, offline: true, serviceWorkers: 'block' });
+    await context.route('**/*', (route) => route.abort('blockedbyclient'));
+    const page = await context.newPage();
+    page.on('request', () => { counter.blocked++; });
+    const cdp = await context.newCDPSession(page);
+    await cdp.send('Network.enable');
+    await cdp.send('Network.setBlockedURLs', { urls: ['*'] });
+    return page;
+}
+const byRole = (root, role, name, level) => root.getByRole(role, { ...(name ? { name, exact: true } : {}), ...(level ? { level } : {}) });
+/** A named container in which role+name is unique and lands on the target (G3). */
+async function scopeFor(page, target, role, name, level) {
+    for (const scopeRole of SCOPE_ROLES) {
+        const holders = byRole(page, scopeRole, '').filter({ has: target });
+        const n = await holders.count();
+        if (!n)
+            continue;
+        const head = (0, aria_snapshot_head_1.parseAriaHead)((await holders.nth(n - 1).ariaSnapshot({ timeout: 3000 }).catch(() => '')).split('\n')[0]);
+        if (!head.name)
+            continue;
+        const scoped = byRole(byRole(page, scopeRole, head.name), role, name, level);
+        if ((await scoped.count()) === 1 && (await scoped.and(target).count()) === 1)
+            return { role: scopeRole, name: head.name };
+    }
+    return undefined;
+}
+const lowResult = (key, reasons) => ({ key, role: 'generic', name: '', identityConfidence: 'low', reasons });
+async function identify(page, req) {
+    const low = (reasons) => lowResult(req.key, reasons);
+    await page.setViewportSize({ width: Math.max(1, req.viewport.width), height: Math.max(1, req.viewport.height) });
+    await page.setContent(req.html, { waitUntil: 'domcontentloaded', timeout: 10000 });
+    const target = page.locator(req.targetSelector);
+    const marked = await target.count();
+    if (marked !== 1)
+        return low([...req.capReasons, `marked-elements=${marked}`]);
+    let aria;
+    try {
+        aria = await target.ariaSnapshot({ timeout: 3000 });
+    }
+    catch (e) {
+        return low([...req.capReasons, `ariaSnapshot-failed: ${e.message.split('\n')[0]}`]);
+    }
+    const head = (0, aria_snapshot_head_1.parseAriaHead)(aria);
+    const id = { role: head.role, name: head.name, ...(head.level ? { level: head.level } : {}) };
+    const reasons = [...req.capReasons];
+    if (NAMELESS.has(head.role))
+        reasons.push(`no-semantic-role(${head.role})`);
+    if (!head.name)
+        reasons.push('empty-name');
+    let scope;
+    if (!NAMELESS.has(head.role)) {
+        const all = byRole(page, head.role, head.name, head.level);
+        const count = await all.count();
+        if ((await all.and(target).count()) !== 1)
+            reasons.push('getByRole-misses-target');
+        else if (count > 1) {
+            scope = head.name ? await scopeFor(page, target, head.role, head.name, head.level) : undefined;
+            if (!scope)
+                reasons.push(`ambiguous(${count})`);
+        }
+    }
+    return reasons.length ? { key: req.key, ...id, identityConfidence: 'low', reasons } : { key: req.key, ...id, ...(scope ? { scope } : {}), identityConfidence: 'high', reasons: [] };
+}
+async function resolveTraceIdentities(input) {
+    const requests = Array.isArray(input?.requests) ? input.requests : [];
+    if (requests.length > exports.MAX_REQUESTS)
+        throw new Error(`trace identity: ${requests.length} snapshots in one call (max ${exports.MAX_REQUESTS})`);
+    const browser = await launch();
+    try {
+        const counter = { blocked: 0 };
+        let page = await isolatedPage(browser, counter);
+        const results = [];
+        for (const req of requests) {
+            try {
+                results.push(await identify(page, req));
+            }
+            catch (e) {
+                // One bad snapshot is a `low` answer for that snapshot, never a crash of the whole check.
+                const why = e.message.split('\n')[0].slice(0, 200);
+                results.push(lowResult(req.key, [`replay-failed: ${why}`]));
+                if (page.isClosed() || /closed/i.test(why)) {
+                    await page.context().close().catch(() => undefined);
+                    page = await isolatedPage(browser, counter);
+                }
+            }
+        }
+        return { resolver: exports.RESOLVER_ID, browser: `chromium ${browser.version()}`, results, blockedRequests: counter.blocked };
+    }
+    finally {
+        await browser.close();
+    }
+}
+//# sourceMappingURL=playwright-identity-resolver.js.map

package/dist/trace-identity/playwright-identity-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright-identity-resolver.js","sourceRoot":"","sources":["../../src/trace-identity/playwright-identity-resolver.ts"],"names":[],"mappings":"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"}

package/dist/trace-identity/trace-run-record-reporter.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Playwright reporter that records sungen's own RUN RECORD for trace conformance (DOS-14.6, G5).
+ *
+ * A Playwright trace carries no run id and no hash of the code that produced it, so a good trace of
+ * another test — or of the same test before the code was weakened — could be swapped in. This
+ * reporter writes, next to the traces it vouches for (`<outputDir>/sungen-run-record[.shard-i-of-n].json`):
+ *
+ *   runId        SUNGEN_RUN_ID when set (one id across CI shards), else a fresh UUID
+ *   specs        sha256 of every test file at run START (the code that ran)
+ *   contract     sha256 of every `.feature` and `contracts.lock.yaml` under `qa/` at run START (schema 2,
+ *                #967): the contract the run saw. A trace proves a contract only while those bytes still
+ *                hold — compared by content, so a touch, a checkout or a fresh clone stales nothing
+ *   attempts     per test attempt: testId, retry, status, window, and the sha256 of its trace.zip
+ *   report       where the JSON reporter wrote its report — traces are mapped THROUGH that report
+ *                (merge-reports renames trace files; their content, and so the sha256, stays)
+ *
+ * The outputDir is wiped at the start of every Playwright run, so a record and its traces always
+ * come from the same run. Enable it for free / impl:code tests together with `trace: 'on'`, in a
+ * config with its OWN outputDir — the compiled suite clears `test-results/` on every run (#941):
+ *
+ *   outputDir: 'test-results-free',
+ *   reporter: [['json', { outputFile: 'test-results-free/results.json' }],
+ *              ['@sungen/driver-ui/dist/trace-identity/trace-run-record-reporter.js']],
+ *   (the compiled file — Playwright does not transpile TypeScript inside node_modules; `prepack` builds it)
+ *   use: { trace: 'on' },
+ */
+import type { FullConfig, Reporter, Suite, TestCase, TestResult } from '@playwright/test/reporter';
+/**
+ * sha256 of every contract file under `<root>/qa` — each `*.feature` and `contracts.lock.yaml` — keyed
+ * by its posix path from `root`, sorted. Dot-directories, node_modules and symlinks are not followed.
+ */
+export declare function contractContent(root: string): Record<string, string>;
+declare class TraceRunRecordReporter implements Reporter {
+    private config?;
+    private root;
+    private runId;
+    private startedAt;
+    private specs;
+    private contract;
+    private results;
+    printsToStdio(): boolean;
+    onBegin(config: FullConfig, suite: Suite): void;
+    onTestEnd(test: TestCase, result: TestResult): void;
+    onEnd(): Promise<void>;
+    /** The JSON reporter's output file, as the reporter itself resolves it (option, then env). */
+    private jsonReportPath;
+    private rel;
+}
+export default TraceRunRecordReporter;
+//# sourceMappingURL=trace-run-record-reporter.d.ts.map

package/dist/trace-identity/trace-run-record-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-run-record-reporter.d.ts","sourceRoot":"","sources":["../../src/trace-identity/trace-run-record-reporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAgBnG;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAcpE;AAED,cAAM,sBAAuB,YAAW,QAAQ;IAC9C,OAAO,CAAC,MAAM,CAAC,CAAa;IAC5B,OAAO,CAAC,IAAI,CAAiB;IAC7B,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,OAAO,CAAqD;IAEpE,aAAa,IAAI,OAAO;IAExB,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAU/C,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI;IAI7C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B5B,8FAA8F;IAC9F,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,GAAG;CAIZ;AAED,eAAe,sBAAsB,CAAC"}

package/dist/trace-identity/trace-run-record-reporter.js

@@ -0,0 +1,146 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.contractContent = contractContent;
+const node_crypto_1 = require("node:crypto");
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const sha256File = (file) => {
+    try {
+        return (0, node_crypto_1.createHash)('sha256').update(fs.readFileSync(file)).digest('hex');
+    }
+    catch {
+        return null;
+    }
+};
+const posix = (p) => p.split(path.sep).join('/');
+const isContractFile = (name) => name.endsWith('.feature') || name === 'contracts.lock.yaml';
+/**
+ * sha256 of every contract file under `<root>/qa` — each `*.feature` and `contracts.lock.yaml` — keyed
+ * by its posix path from `root`, sorted. Dot-directories, node_modules and symlinks are not followed.
+ */
+function contractContent(root) {
+    const found = [];
+    const walk = (dir) => {
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            const full = path.join(dir, e.name);
+            if (e.isDirectory()) {
+                if (!e.name.startsWith('.') && e.name !== 'node_modules')
+                    walk(full);
+                continue;
+            }
+            const sha = e.isFile() && isContractFile(e.name) ? sha256File(full) : null;
+            if (sha)
+                found.push([posix(path.relative(root, full)), sha]);
+        }
+    };
+    walk(path.join(root, 'qa'));
+    return Object.fromEntries(found.sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0)));
+}
+class TraceRunRecordReporter {
+    constructor() {
+        this.root = process.cwd();
+        this.runId = process.env.SUNGEN_RUN_ID || (0, node_crypto_1.randomUUID)();
+        this.startedAt = new Date().toISOString();
+        this.specs = {};
+        this.contract = {};
+        this.results = [];
+    }
+    printsToStdio() { return false; }
+    onBegin(config, suite) {
+        this.config = config;
+        if (config.configFile)
+            this.root = path.dirname(config.configFile);
+        this.contract = contractContent(this.root);
+        for (const test of suite.allTests()) {
+            const rel = this.rel(test.location.file);
+            if (this.specs[rel] === undefined)
+                this.specs[rel] = sha256File(test.location.file) ?? '';
+        }
+    }
+    onTestEnd(test, result) {
+        this.results.push({ test, result });
+    }
+    async onEnd() {
+        if (!this.config)
+            return;
+        const attempts = this.results.map(({ test, result }) => {
+            const trace = result.attachments.find((a) => a.name === 'trace' && a.path);
+            const sha = trace?.path ? sha256File(trace.path) : null;
+            return {
+                testId: test.id, file: this.rel(test.location.file), title: test.title, retry: result.retry, status: result.status,
+                startTime: result.startTime.toISOString(), duration: result.duration, trace: sha ? { sha256: sha } : null,
+            };
+        });
+        const shard = this.config.shard;
+        const record = {
+            schema: 2, tool: 'sungen-trace-run-record', runId: this.runId, startedAt: this.startedAt,
+            playwrightVersion: this.config.version, shard: shard ? `${shard.current}/${shard.total}` : null,
+            report: this.jsonReportPath(), specs: this.specs, contract: this.contract, attempts,
+        };
+        const outDir = this.config.projects[0]?.outputDir ?? path.join(this.root, 'test-results');
+        const name = shard ? `sungen-run-record.shard-${shard.current}-of-${shard.total}.json` : 'sungen-run-record.json';
+        try {
+            fs.mkdirSync(outDir, { recursive: true });
+            fs.writeFileSync(path.join(outDir, name), JSON.stringify(record, null, 2));
+        }
+        catch (e) {
+            // A missing record makes every free / impl:code test `unproven` — say so instead of hiding it.
+            console.error(`[sungen] could not write the trace run record: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    /** The JSON reporter's output file, as the reporter itself resolves it (option, then env). */
+    jsonReportPath() {
+        const json = this.config?.reporter.find(([name]) => name === 'json');
+        const opt = json && typeof json[1]?.outputFile === 'string' ? json[1].outputFile : undefined;
+        const fromEnv = process.env.PLAYWRIGHT_JSON_OUTPUT_FILE
+            ?? (process.env.PLAYWRIGHT_JSON_OUTPUT_NAME ? path.join(process.env.PLAYWRIGHT_JSON_OUTPUT_DIR ?? '', process.env.PLAYWRIGHT_JSON_OUTPUT_NAME) : undefined);
+        const chosen = opt ? path.resolve(this.root, opt) : fromEnv ? path.resolve(process.cwd(), fromEnv) : undefined;
+        return chosen ? this.rel(chosen) : null;
+    }
+    rel(file) {
+        const r = path.relative(this.root, file);
+        return posix(r.startsWith('..') || path.isAbsolute(r) ? path.basename(file) : r);
+    }
+}
+exports.default = TraceRunRecordReporter;
+//# sourceMappingURL=trace-run-record-reporter.js.map

package/dist/trace-identity/trace-run-record-reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-run-record-reporter.js","sourceRoot":"","sources":["../../src/trace-identity/trace-run-record-reporter.ts"],"names":[],"mappings":"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"}

package/dist/utils/column-header.d.ts

@@ -0,0 +1,37 @@
+import { PatternContext } from '@sun-asterisk/sungen';
+/** The `columns:` map as it reaches a pattern from a resolved TABLE entry. */
+interface ColumnsCarrier {
+    columns?: Record<string, {
+        index?: number;
+        header?: string;
+    } | undefined>;
+}
+/**
+ * The DOM accessible name of a table COLUMN HEADER (issue #674).
+ *
+ * `see [Category] column in [Article List] table` used to bake the bracket label straight into
+ * `getByRole('columnheader', { name: … })`. Only the TABLE went through resolveSelector; the column
+ * never did. On a Japanese DOM the header reads 記事分類, so the step could not pass and there was
+ * no override — QA's only escape was to rename the Gherkin reference to the Japanese header text.
+ * That reference is what ships in the delivered test case, and it has to stay readable in the
+ * project's working language: the DOM text is a property of the PAGE, the label is a property of
+ * the TEST. They are allowed to differ, so both need a home.
+ *
+ * Most specific declaration first:
+ *   1. the table entry's `columns: { <col>: { header: … } }` — scoped to this one table, and the
+ *      same map the row-scoped cell steps already index by, so a column is described in one place;
+ *   2. a `<col>--columnheader` entry's `name:` — the column key's own selector, which is already
+ *      how `click [Name] columnheader` and `[Name] columnheader is sorted …` resolve. Reading it
+ *      here is what makes the whole columnheader surface behave the same way;
+ *   3. the bracket label verbatim — the historical behaviour, so an undeclared column compiles
+ *      byte-identically to before.
+ *
+ * (2) accepts the entry ONLY when it actually resolved to a columnheader role. resolveSelector
+ * falls back to the BASE key when no `--columnheader` key matches, so an unrelated `category`
+ * combobox on the same screen would otherwise hand its accessible name to the column step — a
+ * silent wrong locator, worse than the bug being fixed. Auto-infer reaches this branch too, but it
+ * names the role after the label, so it returns exactly what (3) would.
+ */
+export declare function resolveColumnHeaderName(columnLabel: string, context: PatternContext, tableResolved?: ColumnsCarrier): string;
+export {};
+//# sourceMappingURL=column-header.d.ts.map

package/dist/utils/column-header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-header.d.ts","sourceRoot":"","sources":["../../src/utils/column-header.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAqB,MAAM,sBAAsB,CAAC;AAEzE,8EAA8E;AAC9E,UAAU,cAAc;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC,CAAC;CAC3E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,EACvB,aAAa,CAAC,EAAE,cAAc,GAC7B,MAAM,CAgBR"}

package/dist/utils/column-header.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveColumnHeaderName = resolveColumnHeaderName;
+const sungen_1 = require("@sun-asterisk/sungen");
+/**
+ * The DOM accessible name of a table COLUMN HEADER (issue #674).
+ *
+ * `see [Category] column in [Article List] table` used to bake the bracket label straight into
+ * `getByRole('columnheader', { name: … })`. Only the TABLE went through resolveSelector; the column
+ * never did. On a Japanese DOM the header reads 記事分類, so the step could not pass and there was
+ * no override — QA's only escape was to rename the Gherkin reference to the Japanese header text.
+ * That reference is what ships in the delivered test case, and it has to stay readable in the
+ * project's working language: the DOM text is a property of the PAGE, the label is a property of
+ * the TEST. They are allowed to differ, so both need a home.
+ *
+ * Most specific declaration first:
+ *   1. the table entry's `columns: { <col>: { header: … } }` — scoped to this one table, and the
+ *      same map the row-scoped cell steps already index by, so a column is described in one place;
+ *   2. a `<col>--columnheader` entry's `name:` — the column key's own selector, which is already
+ *      how `click [Name] columnheader` and `[Name] columnheader is sorted …` resolve. Reading it
+ *      here is what makes the whole columnheader surface behave the same way;
+ *   3. the bracket label verbatim — the historical behaviour, so an undeclared column compiles
+ *      byte-identically to before.
+ *
+ * (2) accepts the entry ONLY when it actually resolved to a columnheader role. resolveSelector
+ * falls back to the BASE key when no `--columnheader` key matches, so an unrelated `category`
+ * combobox on the same screen would otherwise hand its accessible name to the column step — a
+ * silent wrong locator, worse than the bug being fixed. Auto-infer reaches this branch too, but it
+ * names the role after the label, so it returns exactly what (3) would.
+ */
+function resolveColumnHeaderName(columnLabel, context, tableResolved) {
+    const declared = tableResolved?.columns?.[(0, sungen_1.normalizeRefLabel)(columnLabel)]?.header;
+    if (declared && declared.trim())
+        return declared.trim();
+    try {
+        const resolved = context.selectorResolver.resolveSelector(columnLabel, context.featureName, 'column', 0);
+        if (resolved.role === 'columnheader' && resolved.name && resolved.name.trim()) {
+            return resolved.name.trim();
+        }
+    }
+    catch {
+        // No entry for the column key and auto-infer declined — the label is the header.
+    }
+    return columnLabel;
+}
+//# sourceMappingURL=column-header.js.map

package/dist/utils/column-header.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-header.js","sourceRoot":"","sources":["../../src/utils/column-header.ts"],"names":[],"mappings":";;AAiCA,0DAoBC;AArDD,iDAAyE;AAOzE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,SAAgB,uBAAuB,CACrC,WAAmB,EACnB,OAAuB,EACvB,aAA8B;IAE9B,MAAM,QAAQ,GAAG,aAAa,EAAE,OAAO,EAAE,CAAC,IAAA,0BAAiB,EAAC,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC;IAClF,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE;QAAE,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;IAExD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC,eAAe,CACvD,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,QAAQ,EAAE,CAAC,CAC9C,CAAC;QACF,IAAI,QAAQ,CAAC,IAAI,KAAK,cAAc,IAAI,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YAC9E,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC9B,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,iFAAiF;IACnF,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/utils/row-index.d.ts

@@ -0,0 +1,18 @@
+import { PatternContext } from '@sun-asterisk/sungen';
+/**
+ * Positional-row index expression for `… table row {{n}}` steps (FR2, issue #468).
+ *
+ * QA counts rows from `conventions.table.row_base` (default 1) and the header <tr>
+ * usually carries role=row at getByRole('row') index 0 (`header_is_row: false`), so:
+ *   nth index = n + (header_is_row ? 0 : 1) - row_base
+ *
+ * `rowToken` is the literal number or `{{var}}` from the step text. A runtime marker
+ * becomes `Number(testData.get('var'))` via the runtime-data transform, so the offset
+ * is emitted as ` + k` / ` - k` around it.
+ */
+export declare function rowIndexExpr(rowToken: string, context: PatternContext, opts?: {
+    headerInRows?: boolean;
+}): string;
+/** Matches `table row 2` / `table row {{n}}` and captures the row token. */
+export declare const TABLE_ROW_NTH: RegExp;
+//# sourceMappingURL=row-index.d.ts.map

package/dist/utils/row-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"row-index.d.ts","sourceRoot":"","sources":["../../src/utils/row-index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,GAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/E,MAAM,CAmBR;AAED,4EAA4E;AAC5E,eAAO,MAAM,aAAa,QAAyC,CAAC"}

package/dist/utils/row-index.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TABLE_ROW_NTH = void 0;
+exports.rowIndexExpr = rowIndexExpr;
+/**
+ * Positional-row index expression for `… table row {{n}}` steps (FR2, issue #468).
+ *
+ * QA counts rows from `conventions.table.row_base` (default 1) and the header <tr>
+ * usually carries role=row at getByRole('row') index 0 (`header_is_row: false`), so:
+ *   nth index = n + (header_is_row ? 0 : 1) - row_base
+ *
+ * `rowToken` is the literal number or `{{var}}` from the step text. A runtime marker
+ * becomes `Number(testData.get('var'))` via the runtime-data transform, so the offset
+ * is emitted as ` + k` / ` - k` around it.
+ */
+function rowIndexExpr(rowToken, context, opts = {}) {
+    const rowBase = context.appProfile?.tableRowBase ?? 1;
+    // `headerInRows: false` — the table declares a row SHAPE (`rows: 'div.job-row'`, issue #688), and a
+    // shape never matches the header, so `header_is_row` has nothing to correct for.
+    const headerInRows = opts.headerInRows ?? true;
+    const headerOffset = headerInRows && !context.appProfile?.tableHeaderIsRow ? 1 : 0;
+    const offset = headerOffset - rowBase;
+    const varMatch = rowToken.match(/^\{\{([^}]+)\}\}$/);
+    if (!varMatch)
+        return String(Number(rowToken) + offset);
+    // No fallback to the placeholder text. This value is spliced RAW into `.nth({{{rowIndexExpr}}})`,
+    // so `${n}` landed as a bare expression outside any template literal — a syntax error that took
+    // the whole spec file at parse time, not just the step, and named nothing useful. The throw
+    // reaches StepMapper.mapStep and becomes SG-E038 against this step alone (#781).
+    const expr = context.dataResolver.resolveData(varMatch[1].trim(), context.featureName);
+    if (/^\d+$/.test(expr))
+        return String(Number(expr) + offset); // inline-data mode
+    if (offset === 0)
+        return expr;
+    return offset > 0 ? `${expr} + ${offset}` : `${expr} - ${-offset}`;
+}
+/** Matches `table row 2` / `table row {{n}}` and captures the row token. */
+exports.TABLE_ROW_NTH = /\btable\s+row\s+(\d+|\{\{[^}]+\}\})/i;
+//# sourceMappingURL=row-index.js.map

package/dist/utils/row-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"row-index.js","sourceRoot":"","sources":["../../src/utils/row-index.ts"],"names":[],"mappings":";;;AAaA,oCAqBC;AAhCD;;;;;;;;;;GAUG;AACH,SAAgB,YAAY,CAC1B,QAAgB,EAAE,OAAuB,EAAE,OAAmC,EAAE;IAEhF,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,EAAE,YAAY,IAAI,CAAC,CAAC;IACtD,oGAAoG;IACpG,iFAAiF;IACjF,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC;IAC/C,MAAM,YAAY,GAAG,YAAY,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,MAAM,MAAM,GAAG,YAAY,GAAG,OAAO,CAAC;IAEtC,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACrD,IAAI,CAAC,QAAQ;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,CAAC;IAExD,kGAAkG;IAClG,gGAAgG;IAChG,4FAA4F;IAC5F,iFAAiF;IACjF,MAAM,IAAI,GAAW,OAAO,CAAC,YAAY,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/F,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,mBAAmB;IACjF,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9B,OAAO,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;AACrE,CAAC;AAED,4EAA4E;AAC/D,QAAA,aAAa,GAAG,sCAAsC,CAAC"}