@trailmark/playwright 0.1.0

package/dist/reporter/output.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.summarizeRunEnvelope = summarizeRunEnvelope;
+exports.summarizeScanErrors = summarizeScanErrors;
+exports.summarizeNewFindings = summarizeNewFindings;
+function impactWeight(impact) {
+    switch ((impact ?? "unknown").toLowerCase()) {
+        case "critical":
+            return 0;
+        case "serious":
+            return 1;
+        case "moderate":
+            return 2;
+        case "minor":
+            return 3;
+        default:
+            return 4;
+    }
+}
+function summarizeRunEnvelope(sourceRuns, findingsCount) {
+    if (sourceRuns === 0) {
+        console.log("trailmark: 0 scans / no findings.");
+        return;
+    }
+    if (findingsCount === 0) {
+        console.log(`trailmark: ${sourceRuns} scan run(s), 0 findings.`);
+    }
+}
+function summarizeScanErrors(scanErrors) {
+    if (scanErrors.length === 0) {
+        return;
+    }
+    console.error(`trailmark: ${scanErrors.length} scan error(s) captured during run.`);
+    for (const scanError of scanErrors.slice(0, 10)) {
+        const location = scanError.pageKey ?? scanError.pageUrl ?? "<unknown-page>";
+        console.error(`- ${location} :: ${scanError.message}`);
+    }
+}
+function summarizeNewFindings(diff) {
+    if (diff.newFindings.length === 0) {
+        console.log("trailmark: no new accessibility violations compared to baseline.");
+        return;
+    }
+    const byImpact = Object.entries(diff.stats.newByImpact)
+        .sort((left, right) => impactWeight(left[0]) - impactWeight(right[0]))
+        .map(([impact, count]) => `${impact}:${count}`)
+        .join(", ");
+    const ruleCounts = new Map();
+    for (const finding of diff.newFindings) {
+        ruleCounts.set(finding.ruleId, (ruleCounts.get(finding.ruleId) ?? 0) + 1);
+    }
+    const topRules = Array.from(ruleCounts.entries())
+        .sort((left, right) => {
+        const countDiff = right[1] - left[1];
+        if (countDiff !== 0) {
+            return countDiff;
+        }
+        return left[0].localeCompare(right[0]);
+    })
+        .slice(0, 5)
+        .map(([ruleId, count]) => `${ruleId}:${count}`)
+        .join(", ");
+    console.log(`trailmark: new=${diff.stats.newCount} existing=${diff.stats.existingCount} resolved=${diff.stats.resolvedCount}.`);
+    console.log(`trailmark: new by impact -> ${byImpact || "none"}`);
+    console.log(`trailmark: top new rules -> ${topRules || "none"}`);
+    const sortedFindings = [...diff.newFindings].sort((left, right) => {
+        const impactDiff = impactWeight(left.impact) -
+            impactWeight(right.impact);
+        if (impactDiff !== 0) {
+            return impactDiff;
+        }
+        const ruleDiff = left.ruleId.localeCompare(right.ruleId);
+        if (ruleDiff !== 0) {
+            return ruleDiff;
+        }
+        const pageDiff = left.pageKey.localeCompare(right.pageKey);
+        if (pageDiff !== 0) {
+            return pageDiff;
+        }
+        const leftSelector = left.target[0] ?? left.selectorHint ?? "";
+        const rightSelector = right.target[0] ?? right.selectorHint ?? "";
+        return leftSelector.localeCompare(rightSelector);
+    });
+    for (const finding of sortedFindings) {
+        const impact = (finding.impact ?? "unknown").toLowerCase();
+        const selector = finding.target[0] ?? finding.selectorHint ?? "<unknown-target>";
+        console.log(`- ${impact} | ${finding.ruleId} | ${finding.pageKey} | ${selector}`);
+    }
+}
+//# sourceMappingURL=output.js.map

package/dist/reporter/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/reporter/output.ts"],"names":[],"mappings":";;AAiBA,oDASC;AAED,kDAUC;AAED,oDA8DC;AApGD,SAAS,YAAY,CAAC,MAA0B;IAC9C,QAAQ,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QAC5C,KAAK,UAAU;YACb,OAAO,CAAC,CAAA;QACV,KAAK,SAAS;YACZ,OAAO,CAAC,CAAA;QACV,KAAK,UAAU;YACb,OAAO,CAAC,CAAA;QACV,KAAK,OAAO;YACV,OAAO,CAAC,CAAA;QACV;YACE,OAAO,CAAC,CAAA;IACZ,CAAC;AACH,CAAC;AAED,SAAgB,oBAAoB,CAAC,UAAkB,EAAE,aAAqB;IAC5E,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAA;QAChD,OAAM;IACR,CAAC;IAED,IAAI,aAAa,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,cAAc,UAAU,2BAA2B,CAAC,CAAA;IAClE,CAAC;AACH,CAAC;AAED,SAAgB,mBAAmB,CAAC,UAAsC;IACxE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAM;IACR,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,cAAc,UAAU,CAAC,MAAM,qCAAqC,CAAC,CAAA;IACnF,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QAChD,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC,OAAO,IAAI,gBAAgB,CAAA;QAC3E,OAAO,CAAC,KAAK,CAAC,KAAK,QAAQ,OAAO,SAAS,CAAC,OAAO,EAAE,CAAC,CAAA;IACxD,CAAC;AACH,CAAC;AAED,SAAgB,oBAAoB,CAAC,IAAgB;IACnD,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,kEAAkE,CAAC,CAAA;QAC/E,OAAM;IACR,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC;SACpD,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;SACrE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,IAAI,KAAK,EAAE,CAAC;SAC9C,IAAI,CAAC,IAAI,CAAC,CAAA;IAEb,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAA;IAC5C,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACvC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;IAC3E,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;SAC9C,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;QACpC,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;YACpB,OAAO,SAAS,CAAA;QAClB,CAAC;QACD,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IACxC,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,IAAI,KAAK,EAAE,CAAC;SAC9C,IAAI,CAAC,IAAI,CAAC,CAAA;IAEb,OAAO,CAAC,GAAG,CACT,kBAAkB,IAAI,CAAC,KAAK,CAAC,QAAQ,aAAa,IAAI,CAAC,KAAK,CAAC,aAAa,aAAa,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,CACnH,CAAA;IACD,OAAO,CAAC,GAAG,CAAC,+BAA+B,QAAQ,IAAI,MAAM,EAAE,CAAC,CAAA;IAChE,OAAO,CAAC,GAAG,CAAC,+BAA+B,QAAQ,IAAI,MAAM,EAAE,CAAC,CAAA;IAEhE,MAAM,cAAc,GAAG,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAChE,MAAM,UAAU,GACd,YAAY,CAAC,IAAI,CAAC,MAA4B,CAAC;YAC/C,YAAY,CAAC,KAAK,CAAC,MAA4B,CAAC,CAAA;QAClD,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;YACrB,OAAO,UAAU,CAAA;QACnB,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QACxD,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;YACnB,OAAO,QAAQ,CAAA;QACjB,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAC1D,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;YACnB,OAAO,QAAQ,CAAA;QACjB,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,YAAY,IAAI,EAAE,CAAA;QAC9D,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,YAAY,IAAI,EAAE,CAAA;QACjE,OAAO,YAAY,CAAC,aAAa,CAAC,aAAa,CAAC,CAAA;IAClD,CAAC,CAAC,CAAA;IAEF,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC,WAAW,EAAE,CAAA;QAC1D,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,YAAY,IAAI,kBAAkB,CAAA;QAChF,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,MAAM,OAAO,CAAC,MAAM,MAAM,OAAO,CAAC,OAAO,MAAM,QAAQ,EAAE,CAAC,CAAA;IACnF,CAAC;AACH,CAAC"}

package/dist/reporter/run.d.ts

@@ -0,0 +1,4 @@
+import { TrailmarkFindingMeta, TrailmarkRun } from "@trailmark/core";
+export declare function withRunShape(run: TrailmarkRun): TrailmarkRun;
+export declare function scopeKeyFromMetaLocal(meta: TrailmarkFindingMeta | undefined): string;
+//# sourceMappingURL=run.d.ts.map

package/dist/reporter/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/reporter/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEpE,wBAAgB,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY,CAS5D;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,oBAAoB,GAAG,SAAS,GAAG,MAAM,CAGpF"}

package/dist/reporter/run.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withRunShape = withRunShape;
+exports.scopeKeyFromMetaLocal = scopeKeyFromMetaLocal;
+function withRunShape(run) {
+    if (Array.isArray(run.scanErrors)) {
+        return run;
+    }
+    return {
+        ...run,
+        scanErrors: [],
+    };
+}
+function scopeKeyFromMetaLocal(meta) {
+    const normalized = meta?.projectName?.trim().toLowerCase();
+    return normalized || "default";
+}
+//# sourceMappingURL=run.js.map

package/dist/reporter/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/reporter/run.ts"],"names":[],"mappings":";;AAEA,oCASC;AAED,sDAGC;AAdD,SAAgB,YAAY,CAAC,GAAiB;IAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QAClC,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,OAAO;QACL,GAAG,GAAG;QACN,UAAU,EAAE,EAAE;KACf,CAAA;AACH,CAAC;AAED,SAAgB,qBAAqB,CAAC,IAAsC;IAC1E,MAAM,UAAU,GAAG,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAC1D,OAAO,UAAU,IAAI,SAAS,CAAA;AAChC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,48 @@
+import { Page } from "@playwright/test";
+import { TrailmarkFindingMeta, TrailmarkRun, UrlNormalizationOptions } from "@trailmark/core";
+export interface TrailmarkAxeOptions {
+    include?: string[];
+    exclude?: string[];
+    tags?: string[];
+    rules?: Record<string, {
+        enabled: boolean;
+    }>;
+    disableRules?: string[];
+}
+export type TrailmarkArtifactCaptureMode = "new-only" | "all";
+export interface TrailmarkArtifactOptions {
+    enabled?: boolean;
+    outputDir?: string;
+    limitPerRun?: number;
+    capture?: TrailmarkArtifactCaptureMode;
+    includeViewport?: boolean;
+    includeElement?: boolean;
+}
+export interface ScanOptions {
+    enabled?: boolean;
+    continueOnError?: boolean;
+    axe?: TrailmarkAxeOptions;
+    url?: UrlNormalizationOptions;
+    artifacts?: TrailmarkArtifactOptions;
+    meta?: Partial<TrailmarkFindingMeta>;
+    scanLabel?: string;
+}
+export interface TrailmarkFixture {
+    scan(page: Page, opts?: ScanOptions): Promise<void>;
+    getRun(): TrailmarkRun;
+}
+export type TrailmarkMode = "baseline" | "check";
+export type TrailmarkModeOptions = {
+    mode?: TrailmarkMode;
+};
+export type TrailmarkReporterOptions = {
+    baselinePath?: string;
+    reportPath?: string;
+    failOnImpact?: string[];
+    failOnScanError?: boolean;
+    onConfigMismatch?: "warn" | "error" | "ignore";
+    verbose?: boolean;
+    url?: UrlNormalizationOptions;
+    artifacts?: TrailmarkArtifactOptions;
+} & TrailmarkModeOptions;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AACvC,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAA;AAE7F,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IAC5C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CACxB;AAED,MAAM,MAAM,4BAA4B,GAAG,UAAU,GAAG,KAAK,CAAA;AAE7D,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,4BAA4B,CAAA;IACtC,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,GAAG,CAAC,EAAE,mBAAmB,CAAA;IACzB,GAAG,CAAC,EAAE,uBAAuB,CAAA;IAC7B,SAAS,CAAC,EAAE,wBAAwB,CAAA;IACpC,IAAI,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAA;IACpC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACnD,MAAM,IAAI,YAAY,CAAA;CACvB;AAED,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,OAAO,CAAA;AAEhD,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,CAAC,EAAE,aAAa,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAA;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,GAAG,CAAC,EAAE,uBAAuB,CAAA;IAC7B,SAAS,CAAC,EAAE,wBAAwB,CAAA;CACrC,GAAG,oBAAoB,CAAA"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/integration/app/base.html

@@ -0,0 +1,16 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>Trailmark Sample Base</title>
+  </head>
+  <body>
+    <main>
+      <h1>Checkout</h1>
+      <p>Sample page used for Trailmark integration tests.</p>
+      <img data-testid="hero-image" src="hero.jpg" />
+      <button data-testid="continue-btn" aria-label="Continue to payment">Continue</button>
+    </main>
+  </body>
+</html>

package/integration/app/extra.html

@@ -0,0 +1,17 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>Trailmark Sample Extra</title>
+  </head>
+  <body>
+    <main>
+      <h1>Checkout</h1>
+      <p>Sample page used for Trailmark integration tests.</p>
+      <img data-testid="hero-image" src="hero.jpg" />
+      <button data-testid="continue-btn" aria-label="Continue to payment">Continue</button>
+      <button data-testid="unnamed-action"></button>
+    </main>
+  </body>
+</html>

package/integration/playwright.config.ts

@@ -0,0 +1,44 @@
+import path from "node:path"
+import { defineConfig } from "@playwright/test"
+
+const mode = (process.env.TRAILMARK_IT_MODE as "baseline" | "check" | undefined) ?? "check"
+
+export default defineConfig({
+  testDir: path.resolve(__dirname, "specs"),
+  fullyParallel: false,
+  workers: 1,
+  timeout: 30_000,
+  reporter: [
+    ["line"],
+    [
+      path.resolve(__dirname, "../dist/reporter/index.js"),
+      {
+        baselinePath: path.resolve(__dirname, "tmp", "baseline.json"),
+        reportPath: path.resolve(__dirname, "tmp", "report.json"),
+        mode,
+        failOnImpact: ["minor", "moderate", "serious", "critical", "unknown"],
+        url: {
+          stripHash: true,
+          stripQuery: true,
+          routePatterns: [
+            {
+              match: "^.*\\/integration\\/app\\/(base|extra)\\.html$",
+              replace: "sample-app/page.html",
+            },
+          ],
+        },
+      },
+    ],
+  ],
+  use: {
+    headless: true,
+  },
+  projects: [
+    {
+      name: "chromium",
+      use: {
+        browserName: "chromium",
+      },
+    },
+  ],
+})

package/integration/specs/sample.spec.ts

@@ -0,0 +1,15 @@
+import path from "node:path"
+import { pathToFileURL } from "node:url"
+import { test, expect } from "../../src"
+
+const targetPage = process.env.TRAILMARK_TARGET ?? "base"
+
+test("trailmark sample app scan", async ({ page, trailmark }) => {
+  const appPath = path.resolve(__dirname, "..", "app", `${targetPage}.html`)
+  await page.goto(pathToFileURL(appPath).href)
+
+  await trailmark.scan(page)
+
+  const run = trailmark.getRun()
+  expect(run.findings.length).toBeGreaterThan(0)
+})

package/integration/tmp/baseline.json

@@ -0,0 +1,46 @@
+{
+  "version": 1,
+  "createdAt": "2026-02-08T19:53:46.892Z",
+  "tool": {
+    "name": "trailmark",
+    "version": "0.1.0",
+    "scanner": "@axe-core/playwright"
+  },
+  "configHash": "bf23043ed4b93b2119d6c9048bc54afdcfa1b9b9",
+  "findings": {
+    "chromium::afbdf52e9915d0b0e73041501018ec09de569a5b": {
+      "issueId": "afbdf52e9915d0b0e73041501018ec09de569a5b",
+      "scopeKey": "chromium",
+      "projectName": "chromium",
+      "relaxedIssueId": "85362a09993122b59cdcb30d0d1682654e2bf705",
+      "ruleId": "image-alt",
+      "impact": "critical",
+      "pageKey": "sample-app/page.html",
+      "pageUrl": "file:///Users/dmitrijsminajevs/dev/axe/packages/trailmark-playwright/integration/app/base.html",
+      "targetHash": "affe482b172ca2ef1a2ef338d49db47e91b1f05e",
+      "selectorHint": "img",
+      "sampleTarget": "img",
+      "help": "Images must have alternative text",
+      "helpUrl": "https://dequeuniversity.com/rules/axe/4.11/image-alt?application=playwright",
+      "tags": [
+        "ACT",
+        "cat.text-alternatives",
+        "EN-301-549",
+        "EN-9.1.1.1",
+        "RGAA-1.1.1",
+        "RGAAv4",
+        "section508",
+        "section508.22.a",
+        "TT7.a",
+        "TT7.b",
+        "TTv5",
+        "wcag111",
+        "wcag2a"
+      ],
+      "failureHint": "fix any of the following: element does not have an alt attribute aria-label attribute does not exist or is empty aria-labelledby attribute does not exist, references elements that do not exist or references elements that are empty element has no title attribute elements default semantics were not overridden with role=none or role=presentation",
+      "occurrences": 1,
+      "firstSeenAt": "2026-02-08T19:53:46.892Z",
+      "lastSeenAt": "2026-02-08T19:53:46.892Z"
+    }
+  }
+}

package/integration/tmp/report.json

@@ -0,0 +1,97 @@
+{
+  "run": {
+    "reportVersion": 2,
+    "mode": "check",
+    "createdAt": "2026-02-08T20:11:55.645Z",
+    "startedAt": "2026-02-08T20:11:53.970Z",
+    "finishedAt": "2026-02-08T20:11:55.643Z",
+    "configHash": "bf23043ed4b93b2119d6c9048bc54afdcfa1b9b9",
+    "tool": {
+      "name": "trailmark",
+      "version": "0.1.0",
+      "scanner": "@axe-core/playwright"
+    },
+    "engine": {
+      "scanner": "@axe-core/playwright",
+      "runtime": "playwright"
+    },
+    "metadata": {
+      "sourceRuns": 1,
+      "artifactRunIds": [
+        "20260208T201155296Z"
+      ],
+      "artifactWarnings": [],
+      "artifactIndex": {
+        "byOccurrenceId": {},
+        "byIssueId": {}
+      },
+      "scanCount": 1,
+      "skippedScanCount": 0
+    }
+  },
+  "summary": {
+    "scannedPages": 1,
+    "totalIssues": 1,
+    "totalOccurrences": 1,
+    "scanErrors": 0,
+    "newIssues": 0,
+    "existingIssues": 1,
+    "resolvedIssues": 0,
+    "byImpact": {
+      "critical": 1
+    },
+    "byRuleId": {
+      "image-alt": 1
+    },
+    "byPageKey": {
+      "sample-app/page.html": 1
+    }
+  },
+  "issues": [
+    {
+      "issueId": "afbdf52e9915d0b0e73041501018ec09de569a5b",
+      "ruleId": "image-alt",
+      "impact": "critical",
+      "tags": [
+        "ACT",
+        "cat.text-alternatives",
+        "EN-301-549",
+        "EN-9.1.1.1",
+        "RGAA-1.1.1",
+        "RGAAv4",
+        "section508",
+        "section508.22.a",
+        "TT7.a",
+        "TT7.b",
+        "TTv5",
+        "wcag111",
+        "wcag2a"
+      ],
+      "pageKey": "sample-app/page.html",
+      "url": "file:///Users/dmitrijsminajevs/dev/axe/packages/trailmark-playwright/integration/app/base.html",
+      "target": [
+        "img"
+      ],
+      "selectorHint": "img",
+      "failureSummary": "Fix any of the following:\n  Element does not have an alt attribute\n  aria-label attribute does not exist or is empty\n  aria-labelledby attribute does not exist, references elements that do not exist or references elements that are empty\n  Element has no title attribute\n  Element's default semantics were not overridden with role=\"none\" or role=\"presentation\"",
+      "occurrences": [
+        {
+          "occurrenceId": "3473dff9eb8fb607ca9dcb0f558fb82305e1a033",
+          "testId": "b92766bcf73bd5c029a8-4f0088c96308a9a97a42",
+          "projectName": "chromium",
+          "url": "file:///Users/dmitrijsminajevs/dev/axe/packages/trailmark-playwright/integration/app/base.html",
+          "timestamp": "2026-02-08T20:11:55.607Z",
+          "attachments": []
+        }
+      ]
+    }
+  ],
+  "diff": {
+    "newIssueIds": [],
+    "existingIssueIds": [
+      "afbdf52e9915d0b0e73041501018ec09de569a5b"
+    ],
+    "resolvedIssueIds": [],
+    "newIssues": []
+  }
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@trailmark/playwright",
+  "version": "0.1.0",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./reporter": {
+      "types": "./dist/reporter/index.d.ts",
+      "default": "./dist/reporter/index.js"
+    }
+  },
+  "dependencies": {
+    "@axe-core/playwright": "^4.10.2",
+    "@trailmark/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.49.1",
+    "@types/node": "^22.10.5"
+  },
+  "peerDependencies": {
+    "@playwright/test": ">=1.40.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "pnpm -r build && vitest run --passWithNoTests --exclude test/reporter.integration.test.ts --exclude integration/specs/**",
+    "test:integration": "pnpm -r build && vitest run test/reporter.integration.test.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "sample:baseline": "pnpm -r build && TRAILMARK_MODE=baseline playwright test -c integration/playwright.config.ts integration/specs/sample.spec.ts",
+    "sample:check": "pnpm -r build && playwright test -c integration/playwright.config.ts integration/specs/sample.spec.ts"
+  }
+}

package/src/artifacts/artifactManager.ts

@@ -0,0 +1,178 @@
+import { mkdirSync } from "node:fs"
+import path from "node:path"
+import { Page } from "@playwright/test"
+import { TrailmarkAttachment, TrailmarkFinding } from "@trailmark/core"
+import { captureElementScreenshot, captureViewportScreenshot } from "./capture"
+import { ResolvedTrailmarkArtifactOptions } from "./options"
+
+function impactKey(impact: TrailmarkFinding["impact"]): string {
+  if (!impact) {
+    return "unknown"
+  }
+
+  return String(impact).toLowerCase()
+}
+
+export function sanitizeArtifactSegment(input: string, maxLength = 60): string {
+  const cleaned = input
+    .toLowerCase()
+    .replace(/[^a-z0-9._-]+/g, "_")
+    .replace(/_+/g, "_")
+    .replace(/^_+|_+$/g, "")
+
+  if (!cleaned) {
+    return "unknown"
+  }
+
+  return cleaned.slice(0, maxLength)
+}
+
+function toPosixPath(filePath: string): string {
+  return filePath.split(path.sep).join(path.posix.sep)
+}
+
+function toRelativeArtifactPath(absolutePath: string): string {
+  const relative = path.relative(process.cwd(), absolutePath)
+  return toPosixPath(relative)
+}
+
+export function createArtifactRunId(date: Date = new Date()): string {
+  const iso = date.toISOString()
+  return iso.replace(/[-:.]/g, "").replace(".000", "")
+}
+
+export interface ArtifactManagerOptions extends ResolvedTrailmarkArtifactOptions {
+  runId: string
+}
+
+export interface ArtifactCaptureContext {
+  page: Page
+  finding: TrailmarkFinding
+}
+
+export interface ArtifactCaptureResult {
+  attachments: TrailmarkAttachment[]
+  skipped: boolean
+}
+
+export class ArtifactManager {
+  private readonly runDir: string
+
+  private readonly stemCounters = new Map<string, number>()
+
+  private capturedIssues = 0
+
+  private limitWarningEmitted = false
+
+  private readonly warnings: string[] = []
+
+  constructor(private readonly options: ArtifactManagerOptions) {
+    this.runDir = path.resolve(options.outputDir, options.runId)
+    if (options.enabled && (options.includeViewport || options.includeElement)) {
+      mkdirSync(this.runDir, { recursive: true })
+    }
+  }
+
+  getRunId(): string {
+    return this.options.runId
+  }
+
+  getWarnings(): string[] {
+    return [...this.warnings]
+  }
+
+  private nextStem(finding: TrailmarkFinding): string {
+    const baseStem = [
+      sanitizeArtifactSegment(impactKey(finding.impact)),
+      sanitizeArtifactSegment(finding.ruleId),
+      sanitizeArtifactSegment(finding.pageKey),
+      sanitizeArtifactSegment(finding.issueId.slice(0, 12)),
+    ].join("__")
+
+    const currentCount = (this.stemCounters.get(baseStem) ?? 0) + 1
+    this.stemCounters.set(baseStem, currentCount)
+
+    if (currentCount === 1) {
+      return baseStem
+    }
+
+    return `${baseStem}__${currentCount}`
+  }
+
+  private canCaptureIssue(): boolean {
+    if (!this.options.enabled) {
+      return false
+    }
+
+    if (this.capturedIssues < this.options.limitPerRun) {
+      return true
+    }
+
+    if (!this.limitWarningEmitted) {
+      this.limitWarningEmitted = true
+      this.warnings.push(
+        `trailmark: artifact capture limit reached (${this.options.limitPerRun}); skipping remaining captures.`,
+      )
+    }
+
+    return false
+  }
+
+  async captureForIssue(context: ArtifactCaptureContext): Promise<ArtifactCaptureResult> {
+    if (!this.canCaptureIssue()) {
+      return { attachments: [], skipped: true }
+    }
+
+    this.capturedIssues += 1
+
+    const attachments: TrailmarkAttachment[] = []
+    const stem = this.nextStem(context.finding)
+
+    if (this.options.includeViewport) {
+      const outputPath = path.join(this.runDir, `${stem}__viewport.png`)
+
+      try {
+        await captureViewportScreenshot(context.page, outputPath)
+        attachments.push({
+          kind: "viewport",
+          path: toRelativeArtifactPath(outputPath),
+        })
+      } catch (error) {
+        attachments.push({
+          kind: "viewport",
+          error: error instanceof Error ? error.message : String(error),
+        })
+      }
+    }
+
+    if (this.options.includeElement) {
+      const selector = context.finding.target[0] ?? context.finding.selectorHint
+      if (!selector) {
+        attachments.push({
+          kind: "element",
+          error: "No selector available for element screenshot capture.",
+        })
+      } else {
+        const outputPath = path.join(this.runDir, `${stem}__element.png`)
+
+        try {
+          await captureElementScreenshot(context.page, selector, outputPath)
+          attachments.push({
+            kind: "element",
+            path: toRelativeArtifactPath(outputPath),
+          })
+        } catch (error) {
+          attachments.push({
+            kind: "element",
+            error: error instanceof Error ? error.message : String(error),
+          })
+        }
+      }
+    }
+
+    return {
+      attachments,
+      skipped: false,
+    }
+  }
+}

package/src/artifacts/capture.ts

@@ -0,0 +1,18 @@
+import { Page } from "@playwright/test"
+
+export async function captureViewportScreenshot(page: Page, outputPath: string): Promise<void> {
+  await page.screenshot({
+    path: outputPath,
+    fullPage: true,
+  })
+}
+
+export async function captureElementScreenshot(
+  page: Page,
+  selector: string,
+  outputPath: string,
+): Promise<void> {
+  await page.locator(selector).first().screenshot({
+    path: outputPath,
+  })
+}