@terra-symposium/standards-quality 0.8.0 → 0.9.0

package/README.md

@@ -46,6 +46,14 @@ pnpm exec terra-quality quality --all --warn
 
 The normal scope is changed and untracked files in a Git worktree. `--all` selects every file under `sourceRoots`; `--warn` disables autofixes and runs dead-code analysis once without a temporary fix preview. It reports rule-level fix candidates; fix mode then type-checks proposed dead-code edits before writing and may reject a candidate. Configured quality commands still run unless you pass `--skip-commands`.
 
+## Output order and tests
+
+The runner controls a fixed phase order: **Format → Static quality → Tests → Framework / type checks → Build → Repository health**. `quality.json` selects enabled checks and commands; it does not define phase order or test categories. Commands in ordinary phases keep their configured order; tests keep their configured order within each category.
+
+Selected test commands are grouped as **Unit / Contract**, **Integration**, **Browser / Cloud**, or **Other tests**. Each suite has a 24-cell progress bar. Node and Playwright suites also report individual case progress; other runners receive suite-level progress only. The runner suppresses native child test output when its custom case reporter owns the output, preventing duplicate case listings.
+
+Dead-code is reported as one group. Fix mode shows **Safe fixes** (Knip import consumers, ESLint unused declarations, single-use declaration/reference scans, classification, then only proven edits) followed by **Verification** (Knip reachability, final ESLint and single-use results, and TypeScript safety for candidate edits). Manual findings appear in stable path/line/rule/name order and fail by default; set `"manualWarnings": "warning"` to make them non-blocking. All configured checks finish before the run returns failure.
+
 ## What it does
 
 Terra Quality combines source checks such as documentation, import resolution, naming, forwarding, security, and configured UI-pattern checks with repository-owned tools and commands. Safe transformations can maintain layout, apply tool fixes, and rewrite supported syntax. Findings that require domain or runtime judgment remain for review.

package/dist/index.d.ts

@@ -10,10 +10,14 @@ export * from './imports.js';
 export * from './inline-if.js';
 export * from './documentation.js';
 export * from './naming.js';
+export { qualityNodeReporter } from './node-reporter.js';
 export * from './object-forwarding.js';
 export * from './port.js';
 export * from './runner.js';
 export * from './single-use.js';
 export * from './security.js';
 export * from './patterns.js';
+export * from './ui-recommendations.js';
+export { default as QualityPlaywrightReporter } from './playwright-reporter.js';
+export type { QualityPlaywrightReporterOptions } from './playwright-reporter.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,cAAc,wBAAwB,CAAC;AACvC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,OAAO,IAAI,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAChF,YAAY,EAAE,gCAAgC,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -10,10 +10,13 @@ export * from './imports.js';
 export * from './inline-if.js';
 export * from './documentation.js';
 export * from './naming.js';
+export { qualityNodeReporter } from './node-reporter.js';
 export * from './object-forwarding.js';
 export * from './port.js';
 export * from './runner.js';
 export * from './single-use.js';
 export * from './security.js';
 export * from './patterns.js';
+export * from './ui-recommendations.js';
+export { default as QualityPlaywrightReporter } from './playwright-reporter.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,cAAc,wBAAwB,CAAC;AACvC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,OAAO,IAAI,yBAAyB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/node-reporter.d.ts

@@ -0,0 +1,79 @@
+/**
+ * packages/quality/src/node-reporter.ts
+ * Per-case progress reporter for the Node.js test runner.
+ */
+/**
+ * Describes the subset of Node test events used for progress and case summaries.
+ */
+type NodeTestE = {
+    type: string;
+    data?: {
+        name?: string;
+        nesting?: number;
+        type?: string;
+        testId?: number;
+        testNumber?: number;
+        file?: string;
+        line?: number;
+        skip?: boolean | string;
+        todo?: boolean | string;
+        counts?: {
+            tests?: number;
+            passed?: number;
+            failed?: number;
+            skipped?: number;
+            todo?: number;
+            cancelled?: number;
+        };
+        details?: {
+            type?: string;
+            passed?: boolean;
+            skip?: boolean | string;
+            todo?: boolean | string;
+            error?: {
+                message?: string;
+            } | string;
+        };
+    };
+};
+/**
+ * Replaces any inherited Node test reporter with the shared quality reporter.
+ *
+ * @param curr Existing `NODE_OPTIONS`, if set.
+ * @param reporterUrl URL of the compiled shared reporter.
+ *
+ * @return Node options that retain unrelated flags and select one quality reporter.
+ */
+export declare function qualityNodeReporterOptions(curr: string | undefined, reporterUrl: string): string;
+/**
+ * Node.js custom test reporter with one progress unit per non-suite test.
+ *
+ * Node 24's `test:complete` events provide execution-order progress and
+ * file-scoped test IDs. The reporter also handles Node 18's older enqueue
+ * events, which omit test IDs and suite types, by correlating source metadata
+ * with terminal events. Discovery can continue while earlier files finish, so
+ * live updates leave the line open and finalize once the event stream ends.
+ * Test stdout, stderr, and diagnostics are intentionally ignored to avoid
+ * replaying output already written by child processes.
+ *
+ * @param src Node.js test event stream.
+ * @param opts Optional writer used by focused tests; opaque reporter arguments are ignored.
+ *
+ * @return The per-case result lines accepted by the Node reporter API.
+ */
+export declare function qualityNodeReporter(src: AsyncIterable<NodeTestE>, opts?: unknown): AsyncGenerator<string>;
+/**
+ * Uses the shared reporter once in each test-runner process tree.
+ *
+ * Node propagates NODE_OPTIONS to isolated test workers and nested child
+ * processes. The first runner owns progress; nested runners drain their event
+ * streams so they cannot replay the same suite output.
+ *
+ * @param src Node.js test event stream.
+ * @param opts Optional writer used by focused tests; opaque reporter arguments are ignored.
+ *
+ * @return The per-case result lines accepted by the Node reporter API.
+ */
+declare function defaultQualityNodeReporter(src: AsyncIterable<NodeTestE>, opts?: unknown): AsyncGenerator<string>;
+export default defaultQualityNodeReporter;
+//# sourceMappingURL=node-reporter.d.ts.map

package/dist/node-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-reporter.d.ts","sourceRoot":"","sources":["../src/node-reporter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH;;GAEG;AACH,KAAK,SAAS,GAAG;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;QACxB,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;QACxB,MAAM,CAAC,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACnH,OAAO,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,OAAO,CAAC;YAAC,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE;gBAAE,OAAO,CAAC,EAAE,MAAM,CAAA;aAAE,GAAG,MAAM,CAAA;SAAE,CAAC;KACvI,CAAC;CACF,CAAC;AAMF;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAahG;AA2BD;;;;;;;;;;;;;;;GAeG;AACH,wBAAuB,mBAAmB,CAAC,GAAG,EAAE,aAAa,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,CAoGhH;AAED;;;;;;;;;;;GAWG;AACH,iBAAgB,0BAA0B,CAAC,GAAG,EAAE,aAAa,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,CAShH;AACD,eAAe,0BAA0B,CAAC"}

package/dist/node-reporter.js

@@ -0,0 +1,217 @@
+/**
+ * packages/quality/src/node-reporter.ts
+ * Per-case progress reporter for the Node.js test runner.
+ */
+/*//////////////////////////////////////////////////
+IMPORTS
+//////////////////////////////////////////////////*/
+// API
+import { qualityProgress } from './progress.js';
+/*//////////////////////////////////////////////////
+OPTIONS
+//////////////////////////////////////////////////*/
+/**
+ * Replaces any inherited Node test reporter with the shared quality reporter.
+ *
+ * @param curr Existing `NODE_OPTIONS`, if set.
+ * @param reporterUrl URL of the compiled shared reporter.
+ *
+ * @return Node options that retain unrelated flags and select one quality reporter.
+ */
+export function qualityNodeReporterOptions(curr, reporterUrl) {
+    const opts = curr?.match(/(?:[^\s"'=]+=)?(?:"[^"]*"|'[^']*'|[^\s]+)/gu) ?? [];
+    const retained = [];
+    for (let idx = 0; idx < opts.length; idx++) {
+        const opt = opts[idx];
+        if (opt === '--test-reporter' || opt === '--test-reporter-destination') {
+            idx++;
+            continue;
+        }
+        if (opt.startsWith('--test-reporter=') || opt.startsWith('--test-reporter-destination='))
+            continue;
+        retained.push(opt);
+    }
+    return [...retained, `--test-reporter=${reporterUrl}`, '--test-reporter-destination=stdout'].join(' ');
+}
+/*//////////////////////////////////////////////////
+HELPERS
+//////////////////////////////////////////////////*/
+/**
+ * Formats one terminal Node test result without forwarding child output.
+ *
+ * @param e Terminal pass or fail event from node:test.
+ * @param status Normalized status for the test case.
+ *
+ * @return One stable, single-line result.
+ */
+function fmtNodeResult(e, status) {
+    const data = e.data;
+    const nesting = Math.max(0, data?.nesting ?? 0);
+    const err = data?.details?.error;
+    const msg = typeof err === 'string' ? err : err?.message;
+    const detail = status === 'FAIL' && msg ? ` — ${msg.replace(/\s+/gu, ' ').trim()}` : '';
+    return `${'  '.repeat(nesting)}[${status}] ${data?.name ?? 'unnamed test'}${detail}\n`;
+}
+/*//////////////////////////////////////////////////
+REPORTER
+//////////////////////////////////////////////////*/
+/**
+ * Node.js custom test reporter with one progress unit per non-suite test.
+ *
+ * Node 24's `test:complete` events provide execution-order progress and
+ * file-scoped test IDs. The reporter also handles Node 18's older enqueue
+ * events, which omit test IDs and suite types, by correlating source metadata
+ * with terminal events. Discovery can continue while earlier files finish, so
+ * live updates leave the line open and finalize once the event stream ends.
+ * Test stdout, stderr, and diagnostics are intentionally ignored to avoid
+ * replaying output already written by child processes.
+ *
+ * @param src Node.js test event stream.
+ * @param opts Optional writer used by focused tests; opaque reporter arguments are ignored.
+ *
+ * @return The per-case result lines accepted by the Node reporter API.
+ */
+export async function* qualityNodeReporter(src, opts) {
+    const reportProgress = typeof opts === 'function' ? opts : (text) => void process.stderr.write(text);
+    let enqueued = 0;
+    let completed = 0;
+    const counts = { PASS: 0, FAIL: 0, SKIP: 0 };
+    let hasProgress = false;
+    let lastProgressCompleted = -1;
+    let lastProgressTotal = -1;
+    let terminalProtocol;
+    let summaryCounts;
+    const pendingByIdentity = new Map();
+    const seenTerminal = new Set();
+    const identity = (data, terminal = false) => {
+        const file = data?.file ?? '';
+        if (data?.testId !== undefined)
+            return JSON.stringify([file, 'id', data.testId]) ?? '';
+        if (terminal && data?.testNumber !== undefined)
+            return JSON.stringify([file, 'number', data.testNumber]) ?? '';
+        return JSON.stringify([file, 'source', data?.line ?? null, data?.nesting ?? 0, data?.name ?? 'unnamed test']) ?? '';
+    };
+    const isFileSuite = (data) => {
+        if (data?.nesting !== 0 || !data.name)
+            return false;
+        const normPath = (path) => path.replace(/^file:\/\//u, '').replace(/\\/gu, '/');
+        const basename = (path) => normPath(path).split('/').at(-1) ?? '';
+        const fileLikeName = /(?:^|[/\\])[^/\\]+\.(?:test|spec)\.(?:[cm]?js|tsx?)$/u.test(data.name);
+        return data.name === data.file || (data.file !== undefined && basename(data.name) === basename(data.file)) || (fileLikeName && (data.file === undefined || data.line === 1));
+    };
+    const liveProgress = () => {
+        lastProgressCompleted = completed;
+        lastProgressTotal = Math.max(completed, enqueued);
+        qualityProgress('Cases', lastProgressCompleted, lastProgressTotal, reportProgress, { finalize: false });
+    };
+    const rememberPending = (data, counted) => {
+        const key = identity(data);
+        pendingByIdentity.set(key, [...(pendingByIdentity.get(key) ?? []), { counted }]);
+    };
+    const takePending = (data) => {
+        const key = identity(data);
+        const entries = pendingByIdentity.get(key) ?? [];
+        const [pending] = entries.splice(0, 1);
+        if (entries.length)
+            pendingByIdentity.set(key, entries);
+        else
+            pendingByIdentity.delete(key);
+        return pending;
+    };
+    for await (const e of src) {
+        if (e.type === 'test:summary') {
+            const data = e.data;
+            if (data?.file === undefined && data?.counts)
+                summaryCounts = data.counts;
+            continue;
+        }
+        if (e.type === 'test:enqueue') {
+            if (isFileSuite(e.data))
+                continue;
+            const counted = e.data?.type !== 'suite';
+            if (counted)
+                enqueued += 1;
+            rememberPending(e.data, counted);
+            continue;
+        }
+        if (e.type !== 'test:complete' && e.type !== 'test:pass' && e.type !== 'test:fail')
+            continue;
+        const protocol = e.type === 'test:complete' ? 'complete' : 'legacy';
+        terminalProtocol ??= protocol;
+        if (protocol !== terminalProtocol)
+            continue;
+        const data = e.data;
+        if (isFileSuite(data))
+            continue;
+        const details = data?.details;
+        const isSuite = details?.type === 'suite' || data?.type === 'suite';
+        const terminalKey = identity(data, true);
+        if (seenTerminal.has(terminalKey))
+            continue;
+        seenTerminal.add(terminalKey);
+        const pending = takePending(data);
+        if (isSuite) {
+            if (pending?.counted) {
+                enqueued = Math.max(completed, enqueued - 1);
+                if (hasProgress)
+                    liveProgress();
+            }
+            continue;
+        }
+        if (pending && !pending.counted)
+            enqueued += 1;
+        completed += 1;
+        liveProgress();
+        hasProgress = true;
+        const failed = e.type === 'test:fail' || (e.type === 'test:complete' && details?.passed === false);
+        const skip = details?.skip ?? data?.skip;
+        const todo = details?.todo ?? data?.todo;
+        const isExpectedTodoFailure = todo && failed;
+        const status = skip || isExpectedTodoFailure ? 'SKIP' : failed ? 'FAIL' : 'PASS';
+        counts[status] += 1;
+        if (status !== 'PASS')
+            yield fmtNodeResult(e, status);
+    }
+    const total = summaryCounts?.tests ?? enqueued;
+    const finalCompleted = summaryCounts?.tests ?? completed;
+    if (summaryCounts) {
+        counts.PASS = summaryCounts.passed ?? counts.PASS;
+        counts.FAIL = summaryCounts.failed ?? counts.FAIL;
+        counts.SKIP = (summaryCounts.skipped ?? 0) + (summaryCounts.todo ?? 0) + (summaryCounts.cancelled ?? 0);
+    }
+    if (!hasProgress && total === 0)
+        qualityProgress('Cases', 0, 0, reportProgress, { finalize: true });
+    else if (lastProgressCompleted === finalCompleted && lastProgressTotal === total)
+        reportProgress('\n');
+    else
+        qualityProgress('Cases', finalCompleted, total, reportProgress, { finalize: true });
+    if (finalCompleted < total)
+        yield `Node tests incomplete: ${total - finalCompleted} enqueued cases did not report a result\n`;
+    yield `Node tests: ${counts.PASS} passed, ${counts.FAIL} failed, ${counts.SKIP} skipped\n`;
+}
+/**
+ * Uses the shared reporter once in each test-runner process tree.
+ *
+ * Node propagates NODE_OPTIONS to isolated test workers and nested child
+ * processes. The first runner owns progress; nested runners drain their event
+ * streams so they cannot replay the same suite output.
+ *
+ * @param src Node.js test event stream.
+ * @param opts Optional writer used by focused tests; opaque reporter arguments are ignored.
+ *
+ * @return The per-case result lines accepted by the Node reporter API.
+ */
+async function* defaultQualityNodeReporter(src, opts) {
+    const isTestWorker = process.env.NODE_TEST_CONTEXT === 'child-v8';
+    const ownsReporter = process.env.TERRA_QUALITY_NODE_REPORTER_OWNER === '1' && !isTestWorker;
+    if (isTestWorker)
+        delete process.env.TERRA_QUALITY_NODE_REPORTER_OWNER;
+    if (!ownsReporter) {
+        for await (const _event of src)
+            void _event;
+        return;
+    }
+    yield* qualityNodeReporter(src, opts);
+}
+export default defaultQualityNodeReporter;
+//# sourceMappingURL=node-reporter.js.map

package/dist/node-reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-reporter.js","sourceRoot":"","sources":["../src/node-reporter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;oDAEoD;AAEpD,MAAM;AACN,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AA0BhD;;oDAEoD;AAEpD;;;;;;;GAOG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAwB,EAAE,WAAmB;IACvF,MAAM,IAAI,GAAG,IAAI,EAAE,KAAK,CAAC,6CAA6C,CAAC,IAAI,EAAE,CAAC;IAC9E,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC;QAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAE,CAAC;QACvB,IAAI,GAAG,KAAK,iBAAiB,IAAI,GAAG,KAAK,6BAA6B,EAAE,CAAC;YACxE,GAAG,EAAE,CAAC;YACN,SAAS;QACV,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,kBAAkB,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,8BAA8B,CAAC;YAAE,SAAS;QACnG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,CAAC,GAAG,QAAQ,EAAE,mBAAmB,WAAW,EAAE,EAAE,oCAAoC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACxG,CAAC;AAED;;oDAEoD;AAEpD;;;;;;;GAOG;AACH,SAAS,aAAa,CAAC,CAAY,EAAE,MAAgC;IACpE,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;IACpB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,IAAI,CAAC,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC;IACjC,MAAM,GAAG,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,OAAO,CAAC;IACzD,MAAM,MAAM,GAAG,MAAM,KAAK,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACxF,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,KAAK,IAAI,EAAE,IAAI,IAAI,cAAc,GAAG,MAAM,IAAI,CAAC;AACxF,CAAC;AAED;;oDAEoD;AAEpD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,mBAAmB,CAAC,GAA6B,EAAE,IAAc;IACvF,MAAM,cAAc,GAAG,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAE,IAA+B,CAAC,CAAC,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzI,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,MAAM,MAAM,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAC7C,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,qBAAqB,GAAG,CAAC,CAAC,CAAC;IAC/B,IAAI,iBAAiB,GAAG,CAAC,CAAC,CAAC;IAC3B,IAAI,gBAAmD,CAAC;IACxD,IAAI,aAAuD,CAAC;IAG5D,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAqB,CAAC;IACvD,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IACvC,MAAM,QAAQ,GAAG,CAAC,IAAuB,EAAE,QAAQ,GAAG,KAAK,EAAU,EAAE;QACtE,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;QAC9B,IAAI,IAAI,EAAE,MAAM,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACvF,IAAI,QAAQ,IAAI,IAAI,EAAE,UAAU,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/G,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,IAAI,EAAE,OAAO,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,cAAc,CAAC,CAAC,IAAI,EAAE,CAAC;IACrH,CAAC,CAAC;IACF,MAAM,WAAW,GAAG,CAAC,IAAuB,EAAW,EAAE;QACxD,IAAI,IAAI,EAAE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QACpD,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAChG,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAClF,MAAM,YAAY,GAAG,uDAAuD,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7F,OAAO,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9K,CAAC,CAAC;IACF,MAAM,YAAY,GAAG,GAAS,EAAE;QAC/B,qBAAqB,GAAG,SAAS,CAAC;QAClC,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAClD,eAAe,CAAC,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,cAAc,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IACzG,CAAC,CAAC;IACF,MAAM,eAAe,GAAG,CAAC,IAAuB,EAAE,OAAgB,EAAQ,EAAE;QAC3E,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC3B,iBAAiB,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAClF,CAAC,CAAC;IACF,MAAM,WAAW,GAAG,CAAC,IAAuB,EAAuB,EAAE;QACpE,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC3B,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACjD,MAAM,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACvC,IAAI,OAAO,CAAC,MAAM;YAAE,iBAAiB,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;;YACnD,iBAAiB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACnC,OAAO,OAAO,CAAC;IAChB,CAAC,CAAC;IACF,IAAI,KAAK,EAAE,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;QAC3B,IAAI,CAAC,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;YACpB,IAAI,IAAI,EAAE,IAAI,KAAK,SAAS,IAAI,IAAI,EAAE,MAAM;gBAAE,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC;YAC1E,SAAS;QACV,CAAC;QACD,IAAI,CAAC,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAC/B,IAAI,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;gBAAE,SAAS;YAClC,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC;YACzC,IAAI,OAAO;gBAAE,QAAQ,IAAI,CAAC,CAAC;YAC3B,eAAe,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACjC,SAAS;QACV,CAAC;QACD,IAAI,CAAC,CAAC,IAAI,KAAK,eAAe,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW;YAAE,SAAS;QAC7F,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC;QACpE,gBAAgB,KAAK,QAAQ,CAAC;QAC9B,IAAI,QAAQ,KAAK,gBAAgB;YAAE,SAAS;QAC5C,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;QACpB,IAAI,WAAW,CAAC,IAAI,CAAC;YAAE,SAAS;QAChC,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC;QAC9B,MAAM,OAAO,GAAG,OAAO,EAAE,IAAI,KAAK,OAAO,IAAI,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC;QACpE,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACzC,IAAI,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC;YAAE,SAAS;QAC5C,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC9B,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,OAAO,EAAE,CAAC;YACb,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC;gBACtB,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC;gBAC7C,IAAI,WAAW;oBAAE,YAAY,EAAE,CAAC;YACjC,CAAC;YACD,SAAS;QACV,CAAC;QACD,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,QAAQ,IAAI,CAAC,CAAC;QAC/C,SAAS,IAAI,CAAC,CAAC;QACf,YAAY,EAAE,CAAC;QACf,WAAW,GAAG,IAAI,CAAC;QACnB,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,eAAe,IAAI,OAAO,EAAE,MAAM,KAAK,KAAK,CAAC,CAAC;QACnG,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,IAAI,EAAE,IAAI,CAAC;QACzC,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,IAAI,EAAE,IAAI,CAAC;QACzC,MAAM,qBAAqB,GAAG,IAAI,IAAI,MAAM,CAAC;QAC7C,MAAM,MAAM,GAAG,IAAI,IAAI,qBAAqB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;QACjF,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACpB,IAAI,MAAM,KAAK,MAAM;YAAE,MAAM,aAAa,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACvD,CAAC;IACD,MAAM,KAAK,GAAG,aAAa,EAAE,KAAK,IAAI,QAAQ,CAAC;IAC/C,MAAM,cAAc,GAAG,aAAa,EAAE,KAAK,IAAI,SAAS,CAAC;IACzD,IAAI,aAAa,EAAE,CAAC;QACnB,MAAM,CAAC,IAAI,GAAG,aAAa,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC;QAClD,MAAM,CAAC,IAAI,GAAG,aAAa,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC;QAClD,MAAM,CAAC,IAAI,GAAG,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC;IACzG,CAAC;IACD,IAAI,CAAC,WAAW,IAAI,KAAK,KAAK,CAAC;QAAE,eAAe,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;SAC/F,IAAI,qBAAqB,KAAK,cAAc,IAAI,iBAAiB,KAAK,KAAK;QAAE,cAAc,CAAC,IAAI,CAAC,CAAC;;QAClG,eAAe,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACzF,IAAI,cAAc,GAAG,KAAK;QAAE,MAAM,0BAA0B,KAAK,GAAG,cAAc,2CAA2C,CAAC;IAC9H,MAAM,eAAe,MAAM,CAAC,IAAI,YAAY,MAAM,CAAC,IAAI,YAAY,MAAM,CAAC,IAAI,YAAY,CAAC;AAC5F,CAAC;AAED;;;;;;;;;;;GAWG;AACH,KAAK,SAAS,CAAC,CAAC,0BAA0B,CAAC,GAA6B,EAAE,IAAc;IACvF,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,UAAU,CAAC;IAClE,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,iCAAiC,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC;IAC5F,IAAI,YAAY;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC;IACvE,IAAI,CAAC,YAAY,EAAE,CAAC;QACnB,IAAI,KAAK,EAAE,MAAM,MAAM,IAAI,GAAG;YAAE,KAAK,MAAM,CAAC;QAC5C,OAAO;IACR,CAAC;IACD,KAAK,CAAC,CAAC,mBAAmB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AACvC,CAAC;AACD,eAAe,0BAA0B,CAAC"}

package/dist/playwright-reporter.d.ts

@@ -0,0 +1,107 @@
+/**
+ * packages/quality/src/playwright-reporter.ts
+ * Structural Playwright reporter for per-test progress and final results.
+ */
+/**
+ * Status values reported by Playwright for an individual test attempt.
+ */
+type PlaywrightStatus = 'passed' | 'failed' | 'timedOut' | 'skipped' | 'interrupted';
+/**
+ * Result data retained for one Playwright test attempt.
+ */
+type PlaywrightTestResult = {
+    status: PlaywrightStatus;
+    retry: number;
+    error?: {
+        message?: string;
+    };
+};
+/**
+ * Structural test data needed to report progress without importing Playwright.
+ */
+type PlaywrightTestCase = {
+    title: string;
+    titlePath?: () => string[];
+    expectedStatus?: PlaywrightStatus;
+    retries?: number;
+    results?: PlaywrightTestResult[];
+    outcome?: () => 'skipped' | 'expected' | 'unexpected' | 'flaky';
+};
+/**
+ * Minimal Playwright suite contract used to enumerate discovered tests.
+ */
+type PlaywrightSuite = {
+    allTests(): PlaywrightTestCase[];
+};
+/**
+ * Final run status passed to the Playwright reporter's `onEnd` callback.
+ */
+type PlaywrightFullResult = {
+    status: 'passed' | 'failed' | 'timedout' | 'interrupted';
+};
+/**
+ * Optional output sinks for the Playwright progress reporter.
+ */
+export type QualityPlaywrightReporterOptions = {
+    write?: (text: string) => void;
+    writeProgress?: (text: string) => void;
+};
+/**
+ * Playwright reporter that counts tests once and prints final results in
+ * discovery order. Playwright is structural here and remains a peer runtime
+ * supplied by the consuming project.
+ */
+export default class QualityPlaywrightReporter {
+    private readonly write;
+    private readonly writeProgress;
+    private tests;
+    private readonly started;
+    private readonly finished;
+    private readonly lastResults;
+    /**
+     * Creates a reporter with optional output sinks.
+     *
+     * @param opts Optional sinks for output and progress.
+     */
+    constructor(opts?: QualityPlaywrightReporterOptions);
+    /**
+     * Initializes progress from the discovered test cases.
+     *
+     * @param _config Playwright's resolved configuration.
+     * @param suite Root test suite supplied by Playwright.
+     */
+    onBegin(_config: unknown, suite: PlaywrightSuite): void;
+    /**
+     * Records that a test has started; retries reuse the same test identity.
+     *
+     * @param test Playwright test case.
+     */
+    onTestBegin(test: PlaywrightTestCase): void;
+    /**
+     * Stores the latest attempt and advances progress only when no retry remains.
+     *
+     * @param test Playwright test case.
+     * @param result Result for this attempt.
+     */
+    onTestEnd(test: PlaywrightTestCase, result: PlaywrightTestResult): void;
+    /**
+     * Resolves tests not observed in onTestEnd, then emits one ordered result and summary.
+     *
+     * @param result Final Playwright run result.
+     */
+    onEnd(result: PlaywrightFullResult): void;
+    /**
+     * Confirms this reporter owns terminal output so Playwright does not add another reporter.
+     *
+     * @return True because this reporter writes result lines and a summary.
+     */
+    printsToStdio(): boolean;
+    /**
+     * Adds a test to the completed set once and updates the shared progress bar.
+     *
+     * @param test Completed Playwright test case.
+     */
+    private finish;
+}
+export {};
+//# sourceMappingURL=playwright-reporter.d.ts.map

package/dist/playwright-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright-reporter.d.ts","sourceRoot":"","sources":["../src/playwright-reporter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH;;GAEG;AACH,KAAK,gBAAgB,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,aAAa,CAAC;AAKrF;;GAEG;AACH,KAAK,oBAAoB,GAAG;IAAE,MAAM,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AACtG;;GAEG;AACH,KAAK,kBAAkB,GAAG;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,MAAM,EAAE,CAAC;IAC3B,cAAc,CAAC,EAAE,gBAAgB,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,OAAO,CAAC;CAChE,CAAC;AACF;;GAEG;AACH,KAAK,eAAe,GAAG;IAAE,QAAQ,IAAI,kBAAkB,EAAE,CAAA;CAAE,CAAC;AAC5D;;GAEG;AACH,KAAK,oBAAoB,GAAG;IAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,aAAa,CAAA;CAAE,CAAC;AACzF;;GAEG;AACH,MAAM,MAAM,gCAAgC,GAAG;IAAE,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,CAAC;AAwC1H;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,yBAAyB;IAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAC/C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyB;IACvD,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;IAC1D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuD;IAEnF;;;;OAIG;gBACS,IAAI,GAAE,gCAAqC;IAKvD;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI;IAKvD;;;;OAIG;IACH,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI;IAI3C;;;;;OAKG;IACH,SAAS,CAAC,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,oBAAoB,GAAG,IAAI;IAMvE;;;;OAIG;IACH,KAAK,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI;IAazC;;;;OAIG;IACH,aAAa,IAAI,OAAO;IAIxB;;;;OAIG;IACH,OAAO,CAAC,MAAM;CAKd"}

package/dist/playwright-reporter.js

@@ -0,0 +1,138 @@
+/**
+ * packages/quality/src/playwright-reporter.ts
+ * Structural Playwright reporter for per-test progress and final results.
+ */
+/*//////////////////////////////////////////////////
+IMPORTS
+//////////////////////////////////////////////////*/
+// API
+import { qualityProgress } from './progress.js';
+/*//////////////////////////////////////////////////
+HELPERS
+//////////////////////////////////////////////////*/
+/**
+ * Resolves a completed Playwright test to one of the supported case statuses.
+ *
+ * @param test Playwright test case.
+ * @param result Last result recorded for the test, if it ran.
+ *
+ * @return Normalized pass, fail, or skip status.
+ */
+function qualityStatus(test, result) {
+    if (!result || result.status === 'skipped' || test.expectedStatus === 'skipped')
+        return 'SKIP';
+    const outcome = test.outcome?.();
+    if (outcome === 'skipped')
+        return 'SKIP';
+    if (outcome === 'expected' || outcome === 'flaky')
+        return 'PASS';
+    if (outcome === 'unexpected')
+        return 'FAIL';
+    if (result.status === (test.expectedStatus ?? 'passed'))
+        return 'PASS';
+    return result.status === 'passed' || result.status === 'failed' || result.status === 'timedOut' || result.status === 'interrupted' ? 'FAIL' : 'SKIP';
+}
+/**
+ * Returns a stable display name for a test, including its suite path when present.
+ *
+ * @param test Playwright test case.
+ *
+ * @return A deterministic display name.
+ */
+function testName(test) {
+    const titlePath = test.titlePath?.();
+    return titlePath?.length ? titlePath.join(' › ') : test.title;
+}
+/*//////////////////////////////////////////////////
+REPORTER
+//////////////////////////////////////////////////*/
+/**
+ * Playwright reporter that counts tests once and prints final results in
+ * discovery order. Playwright is structural here and remains a peer runtime
+ * supplied by the consuming project.
+ */
+export default class QualityPlaywrightReporter {
+    write;
+    writeProgress;
+    tests = [];
+    started = new Set();
+    finished = new Set();
+    lastResults = new Map();
+    /**
+     * Creates a reporter with optional output sinks.
+     *
+     * @param opts Optional sinks for output and progress.
+     */
+    constructor(opts = {}) {
+        this.write = opts.write ?? ((text) => void process.stdout.write(text));
+        this.writeProgress = opts.writeProgress ?? ((text) => void process.stderr.write(text));
+    }
+    /**
+     * Initializes progress from the discovered test cases.
+     *
+     * @param _config Playwright's resolved configuration.
+     * @param suite Root test suite supplied by Playwright.
+     */
+    onBegin(_config, suite) {
+        this.tests = suite.allTests();
+        qualityProgress('Cases', 0, this.tests.length, this.writeProgress);
+    }
+    /**
+     * Records that a test has started; retries reuse the same test identity.
+     *
+     * @param test Playwright test case.
+     */
+    onTestBegin(test) {
+        this.started.add(test);
+    }
+    /**
+     * Stores the latest attempt and advances progress only when no retry remains.
+     *
+     * @param test Playwright test case.
+     * @param result Result for this attempt.
+     */
+    onTestEnd(test, result) {
+        this.lastResults.set(test, result);
+        const canRetry = (result.status === 'failed' || result.status === 'timedOut') && result.retry < (test.retries ?? 0) && test.expectedStatus !== result.status;
+        if (!canRetry)
+            this.finish(test);
+    }
+    /**
+     * Resolves tests not observed in onTestEnd, then emits one ordered result and summary.
+     *
+     * @param result Final Playwright run result.
+     */
+    onEnd(result) {
+        const counts = { PASS: 0, FAIL: 0, SKIP: 0 };
+        for (const test of this.tests) {
+            const latestResult = this.lastResults.get(test) ?? test.results?.at(-1);
+            const status = this.started.has(test) && !latestResult ? 'FAIL' : qualityStatus(test, latestResult);
+            counts[status] += 1;
+            const msg = status === 'FAIL' ? latestResult?.error?.message?.replace(/\s+/gu, ' ').trim() : undefined;
+            if (status !== 'PASS')
+                this.write(`  [${status}] ${testName(test)}${msg ? ` — ${msg}` : ''}\n`);
+            this.finish(test);
+        }
+        this.write(`Playwright ${result.status}: ${counts.PASS} passed, ${counts.FAIL} failed, ${counts.SKIP} skipped\n`);
+    }
+    /**
+     * Confirms this reporter owns terminal output so Playwright does not add another reporter.
+     *
+     * @return True because this reporter writes result lines and a summary.
+     */
+    printsToStdio() {
+        return true;
+    }
+    /**
+     * Adds a test to the completed set once and updates the shared progress bar.
+     *
+     * @param test Completed Playwright test case.
+     */
+    finish(test) {
+        if (this.finished.has(test))
+            return;
+        this.finished.add(test);
+        qualityProgress('Cases', this.finished.size, this.tests.length, this.writeProgress);
+    }
+}
+//# sourceMappingURL=playwright-reporter.js.map

package/dist/playwright-reporter.js.map

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

package/dist/progress.d.ts

@@ -9,8 +9,11 @@
  * @param curr Number of completed units.
  * @param total Total units, or zero when there is no work to process.
  * @param write Optional output writer used by tests; production writes to standard error.
+ * @param opts Optional line-finalization policy for streams with late discoveries.
  *
- * @return Nothing; the progress bar is written to standard error and finalized with one newline.
+ * @return Nothing; the progress bar is written to standard error and may end with a newline.
  */
-export declare function qualityProgress(label: string, curr: number, total: number, write?: (text: string) => void): void;
+export declare function qualityProgress(label: string, curr: number, total: number, write?: (text: string) => void, opts?: {
+    finalize?: boolean;
+}): void;
 //# sourceMappingURL=progress.d.ts.map