@trailmark/core 0.1.0

package/dist/report/types.d.ts.map

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

package/dist/report/types.js

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

package/dist/report/types.js.map

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

package/dist/run.d.ts

@@ -0,0 +1,8 @@
+import { TrailmarkRun, TrailmarkToolInfo } from "./types";
+export declare const DEFAULT_TOOL_INFO: TrailmarkToolInfo;
+export declare function createEmptyRun(options?: {
+    metadata?: Record<string, unknown>;
+    tool?: TrailmarkToolInfo;
+    startedAt?: string;
+}): TrailmarkRun;
+//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAEzD,eAAO,MAAM,iBAAiB,EAAE,iBAI/B,CAAA;AAED,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,IAAI,CAAC,EAAE,iBAAiB,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,GAAG,YAAY,CASf"}

package/dist/run.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_TOOL_INFO = void 0;
+exports.createEmptyRun = createEmptyRun;
+exports.DEFAULT_TOOL_INFO = {
+    name: "trailmark",
+    version: "0.1.0",
+    scanner: "@axe-core/playwright",
+};
+function createEmptyRun(options) {
+    return {
+        version: 1,
+        startedAt: options?.startedAt ?? new Date().toISOString(),
+        tool: options?.tool ?? exports.DEFAULT_TOOL_INFO,
+        findings: [],
+        scanErrors: [],
+        metadata: options?.metadata,
+    };
+}
+//# sourceMappingURL=run.js.map

package/dist/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":";;;AAQA,wCAaC;AAnBY,QAAA,iBAAiB,GAAsB;IAClD,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,OAAO;IAChB,OAAO,EAAE,sBAAsB;CAChC,CAAA;AAED,SAAgB,cAAc,CAAC,OAI9B;IACC,OAAO;QACL,OAAO,EAAE,CAAC;QACV,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACzD,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,yBAAiB;QACxC,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,OAAO,EAAE,QAAQ;KAC5B,CAAA;AACH,CAAC"}

package/dist/scope.d.ts

@@ -0,0 +1,5 @@
+import { BaselineEntry, TrailmarkFindingMeta } from "./types";
+export declare function scopeKeyFromMeta(meta: TrailmarkFindingMeta | undefined): string;
+export declare function scopeKeyFromBaselineEntry(entry: Pick<BaselineEntry, "scopeKey" | "projectName">): string;
+export declare function scopedIssueKey(issueId: string, scopeKey: string): string;
+//# sourceMappingURL=scope.d.ts.map

package/dist/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../src/scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAY7D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,SAAS,GAAG,MAAM,CAE/E;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,GAAG,aAAa,CAAC,GACrD,MAAM,CAER;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExE"}

package/dist/scope.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scopeKeyFromMeta = scopeKeyFromMeta;
+exports.scopeKeyFromBaselineEntry = scopeKeyFromBaselineEntry;
+exports.scopedIssueKey = scopedIssueKey;
+const DEFAULT_SCOPE_KEY = "default";
+function normalizeScopeValue(value) {
+    const normalized = value?.trim().toLowerCase();
+    if (!normalized) {
+        return DEFAULT_SCOPE_KEY;
+    }
+    return normalized;
+}
+function scopeKeyFromMeta(meta) {
+    return normalizeScopeValue(meta?.projectName);
+}
+function scopeKeyFromBaselineEntry(entry) {
+    return normalizeScopeValue(entry.scopeKey ?? entry.projectName);
+}
+function scopedIssueKey(issueId, scopeKey) {
+    return `${scopeKey}::${issueId}`;
+}
+//# sourceMappingURL=scope.js.map

package/dist/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../src/scope.ts"],"names":[],"mappings":";;AAYA,4CAEC;AAED,8DAIC;AAED,wCAEC;AAtBD,MAAM,iBAAiB,GAAG,SAAS,CAAA;AAEnC,SAAS,mBAAmB,CAAC,KAAyB;IACpD,MAAM,UAAU,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAC9C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,iBAAiB,CAAA;IAC1B,CAAC;IACD,OAAO,UAAU,CAAA;AACnB,CAAC;AAED,SAAgB,gBAAgB,CAAC,IAAsC;IACrE,OAAO,mBAAmB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;AAC/C,CAAC;AAED,SAAgB,yBAAyB,CACvC,KAAsD;IAEtD,OAAO,mBAAmB,CAAC,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,WAAW,CAAC,CAAA;AACjE,CAAC;AAED,SAAgB,cAAc,CAAC,OAAe,EAAE,QAAgB;IAC9D,OAAO,GAAG,QAAQ,KAAK,OAAO,EAAE,CAAA;AAClC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,150 @@
+export type TrailmarkImpactKey = "minor" | "moderate" | "serious" | "critical" | "unknown";
+export type TrailmarkImpact = "minor" | "moderate" | "serious" | "critical" | null | undefined;
+export interface UrlRoutePattern {
+    match: string;
+    replace: string;
+}
+export interface UrlNormalizationOptions {
+    stripHash?: boolean;
+    stripQuery?: boolean | {
+        allow: string[];
+    };
+    routePatterns?: UrlRoutePattern[];
+}
+export interface TrailmarkFindingMeta {
+    testId?: string;
+    testTitle?: string;
+    testFile?: string;
+    projectName?: string;
+    scanLabel?: string;
+}
+export interface TrailmarkScanError {
+    pageUrl?: string;
+    pageKey?: string;
+    message: string;
+    stack?: string;
+    occurredAt: string;
+    meta?: TrailmarkFindingMeta;
+}
+export interface TrailmarkAttachment {
+    kind: string;
+    path?: string;
+    error?: string;
+}
+export interface TrailmarkFinding {
+    issueId: string;
+    relaxedIssueId: string;
+    ruleId: string;
+    impact?: TrailmarkImpact;
+    tags: string[];
+    help?: string;
+    helpUrl?: string;
+    pageUrl: string;
+    pageKey: string;
+    target: string[];
+    selectorHint?: string;
+    targetHash: string;
+    nodeHtml?: string;
+    failureSummary?: string;
+    failureHint?: string;
+    occurredAt?: string;
+    occurrenceId?: string;
+    attachments?: TrailmarkAttachment[];
+    meta?: TrailmarkFindingMeta;
+}
+export interface TrailmarkToolInfo {
+    name: string;
+    version: string;
+    scanner: string;
+}
+export interface TrailmarkRun {
+    version: 1;
+    startedAt: string;
+    finishedAt?: string;
+    tool: TrailmarkToolInfo;
+    findings: TrailmarkFinding[];
+    scanErrors: TrailmarkScanError[];
+    metadata?: Record<string, unknown>;
+}
+export interface BaselineEntry {
+    issueId: string;
+    scopeKey?: string;
+    projectName?: string;
+    relaxedIssueId: string;
+    ruleId: string;
+    impact?: TrailmarkImpact;
+    pageKey: string;
+    pageUrl: string;
+    targetHash: string;
+    selectorHint?: string;
+    sampleTarget?: string;
+    help?: string;
+    helpUrl?: string;
+    tags: string[];
+    failureHint?: string;
+    occurrences: number;
+    firstSeenAt: string;
+    lastSeenAt: string;
+}
+export interface BaselineFile {
+    version: 1;
+    createdAt: string;
+    tool: TrailmarkToolInfo;
+    configHash: string;
+    findings: Record<string, BaselineEntry>;
+}
+export interface DiffMatch {
+    finding: TrailmarkFinding;
+    matchedBy: "exact" | "relaxed";
+    baselineIssueId: string;
+    baselineScopeKey?: string;
+}
+export interface DiffStats {
+    totalCurrent: number;
+    totalBaseline: number;
+    newCount: number;
+    existingCount: number;
+    resolvedCount: number;
+    newByImpact: Record<string, number>;
+}
+export interface DiffResult {
+    newFindings: TrailmarkFinding[];
+    existing: DiffMatch[];
+    resolved: BaselineEntry[];
+    blockingNew: TrailmarkFinding[];
+    stats: DiffStats;
+}
+export interface DiffOptions {
+    failOnImpact?: string[];
+    onDebug?: (message: string, context?: Record<string, unknown>) => void;
+}
+export interface AxeNodeResult {
+    target: string[];
+    html?: string;
+    failureSummary?: string;
+}
+export interface AxeViolation {
+    id: string;
+    impact?: TrailmarkImpact;
+    tags?: string[];
+    help?: string;
+    helpUrl?: string;
+    nodes: AxeNodeResult[];
+}
+export interface AxeLikeResults {
+    violations: AxeViolation[];
+}
+export interface NormalizeInput {
+    results: AxeLikeResults;
+    pageUrl: string;
+    urlOptions?: UrlNormalizationOptions;
+    meta?: TrailmarkFindingMeta;
+    htmlMaxLength?: number;
+    failureSummaryMaxLength?: number;
+}
+export interface TargetFingerprintCanonical {
+    tag: string | null;
+    stableAttrs: Record<string, string>;
+    structuralHint: string | null;
+}
+//# 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":"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"}

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/dist/url.d.ts

@@ -0,0 +1,3 @@
+import { UrlNormalizationOptions } from "./types";
+export declare function normalizeUrlToPageKey(rawUrl: string, options?: UrlNormalizationOptions): string;
+//# sourceMappingURL=url.d.ts.map

package/dist/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../src/url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAA;AAqEjD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,uBAA4B,GACpC,MAAM,CA6BR"}

package/dist/url.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeUrlToPageKey = normalizeUrlToPageKey;
+const DEFAULT_OPTIONS = {
+    stripHash: true,
+    stripQuery: true,
+};
+function normalizeQuery(params, allow) {
+    const keys = Array.from(new Set(params.keys()))
+        .filter((key) => !allow || allow.has(key))
+        .sort((a, b) => a.localeCompare(b));
+    const pairs = [];
+    for (const key of keys) {
+        const values = params.getAll(key).sort((a, b) => a.localeCompare(b));
+        for (const value of values) {
+            pairs.push(`${encodeURIComponent(key)}=${encodeURIComponent(value)}`);
+        }
+    }
+    return pairs.join("&");
+}
+function stripQueryFromFallback(raw, stripQuery) {
+    if (stripQuery === true) {
+        return raw.replace(/\?.*$/, "");
+    }
+    if (stripQuery && typeof stripQuery === "object") {
+        const [base, rawQuery = ""] = raw.split("?");
+        if (!rawQuery) {
+            return base;
+        }
+        const allow = new Set(stripQuery.allow);
+        const params = new URLSearchParams(rawQuery);
+        const query = normalizeQuery(params, allow);
+        return query ? `${base}?${query}` : base;
+    }
+    return raw;
+}
+function applyRoutePatterns(pageKey, routePatterns) {
+    if (!routePatterns || routePatterns.length === 0) {
+        return pageKey;
+    }
+    let result = pageKey;
+    for (const pattern of routePatterns) {
+        try {
+            const matcher = new RegExp(pattern.match);
+            if (matcher.test(result)) {
+                result = result.replace(matcher, pattern.replace);
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return result;
+}
+function normalizeUrlToPageKey(rawUrl, options = {}) {
+    const merged = {
+        ...DEFAULT_OPTIONS,
+        ...options,
+    };
+    let pageKey;
+    try {
+        const parsed = new URL(rawUrl);
+        const host = parsed.host.toLowerCase();
+        const pathname = parsed.pathname || "/";
+        let query = "";
+        if (merged.stripQuery === false) {
+            query = normalizeQuery(parsed.searchParams);
+        }
+        else if (merged.stripQuery && typeof merged.stripQuery === "object") {
+            query = normalizeQuery(parsed.searchParams, new Set(merged.stripQuery.allow));
+        }
+        const hash = !merged.stripHash ? parsed.hash : "";
+        pageKey = `${host}${pathname}${query ? `?${query}` : ""}${hash}`;
+    }
+    catch {
+        const lowered = rawUrl.trim().toLowerCase();
+        const withoutHash = merged.stripHash ? lowered.replace(/#.*$/, "") : lowered;
+        pageKey = stripQueryFromFallback(withoutHash, merged.stripQuery);
+    }
+    return applyRoutePatterns(pageKey, merged.routePatterns);
+}
+//# sourceMappingURL=url.js.map

package/dist/url.js.map

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

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@trailmark/core",
+  "version": "0.1.0",
+  "main": "dist/index.js",
+  "types": "src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}

package/src/baseline.ts

@@ -0,0 +1,217 @@
+import { hashObject } from "./hash"
+import { IMPACT_ORDER } from "./impact"
+import { DEFAULT_TOOL_INFO } from "./run"
+import { scopedIssueKey, scopeKeyFromMeta } from "./scope"
+import { BaselineEntry, BaselineFile, TrailmarkImpact, TrailmarkRun } from "./types"
+import { z } from "zod"
+
+export const BASELINE_SCHEMA_VERSION = 1
+
+export class BaselineFormatError extends Error {
+  constructor(message: string) {
+    super(message)
+    this.name = "BaselineFormatError"
+  }
+}
+
+export function computeConfigHash(config: unknown): string {
+  return hashObject(config)
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value)
+}
+
+function normalizeTags(tags: string[]): string[] {
+  return Array.from(new Set(tags)).sort((a, b) => a.localeCompare(b))
+}
+
+const baselineEntrySchema: z.ZodType<BaselineEntry> = z.object({
+  issueId: z.string(),
+  scopeKey: z.string().optional(),
+  projectName: z.string().optional(),
+  relaxedIssueId: z.string(),
+  ruleId: z.string(),
+  impact: z
+    .enum(
+      IMPACT_ORDER.filter((value) => value !== "unknown") as [
+        NonNullable<TrailmarkImpact>,
+        ...NonNullable<TrailmarkImpact>[],
+      ],
+    )
+    .nullable()
+    .optional(),
+  pageKey: z.string(),
+  pageUrl: z.string(),
+  targetHash: z.string(),
+  selectorHint: z.string().optional(),
+  sampleTarget: z.string().optional(),
+  help: z.string().optional(),
+  helpUrl: z.string().optional(),
+  tags: z.array(z.string()).transform((tags) => normalizeTags(tags)),
+  failureHint: z.string().optional(),
+  occurrences: z.number().finite().min(0),
+  firstSeenAt: z.string(),
+  lastSeenAt: z.string(),
+})
+
+const baselineFileSchema: z.ZodType<BaselineFile> = z.object({
+  version: z.literal(BASELINE_SCHEMA_VERSION),
+  createdAt: z.string(),
+  tool: z.object({
+    name: z.string(),
+    version: z.string(),
+    scanner: z.string(),
+  }),
+  configHash: z.string(),
+  findings: z.record(z.string(), baselineEntrySchema),
+})
+
+function formatPath(path: (string | number)[]): string {
+  if (path.length === 0) {
+    return "baseline"
+  }
+
+  return path
+    .map((segment) => (typeof segment === "number" ? `[${String(segment)}]` : segment))
+    .join(".")
+}
+
+function comparableEntry(entry: BaselineEntry): Record<string, unknown> {
+  return {
+    issueId: entry.issueId,
+    scopeKey: entry.scopeKey,
+    projectName: entry.projectName,
+    relaxedIssueId: entry.relaxedIssueId,
+    ruleId: entry.ruleId,
+    impact: entry.impact,
+    pageKey: entry.pageKey,
+    pageUrl: entry.pageUrl,
+    targetHash: entry.targetHash,
+    selectorHint: entry.selectorHint,
+    sampleTarget: entry.sampleTarget,
+    help: entry.help,
+    helpUrl: entry.helpUrl,
+    tags: entry.tags,
+    failureHint: entry.failureHint,
+    occurrences: entry.occurrences,
+  }
+}
+
+function isUnchangedEntry(previous: BaselineEntry, next: BaselineEntry): boolean {
+  return hashObject(comparableEntry(previous)) === hashObject(comparableEntry(next))
+}
+
+export function parseBaselineFile(raw: string) {
+  let parsed: unknown
+  try {
+    parsed = JSON.parse(raw)
+  } catch {
+    return {
+      data: null,
+      error: true as const,
+      message: "trailmark: baseline file is not a valid JSON.",
+    }
+  }
+
+  if (
+    isRecord(parsed) &&
+    typeof parsed.version === "number" &&
+    parsed.version !== BASELINE_SCHEMA_VERSION
+  ) {
+    return {
+      data: null,
+      error: true as const,
+      message: `trailmark: unsupported baseline version ${parsed.version}. Expected ${BASELINE_SCHEMA_VERSION}.`,
+    }
+  }
+
+  const result = baselineFileSchema.safeParse(parsed)
+  if (!result.success) {
+    const issue = result.error.issues[0]
+    return {
+      data: null,
+      error: true as const,
+      message: `trailmark: invalid baseline format at "${formatPath(issue.path)}": ${issue.message}`,
+    }
+  }
+
+  return {
+    error: false as const,
+    data: result.data,
+  }
+}
+
+export function buildBaselineFromRun(
+  run: TrailmarkRun,
+  options: {
+    createdAt?: string
+    configHash: string
+    previousBaseline?: BaselineFile
+  },
+): BaselineFile {
+  const createdAt =
+    options.createdAt ?? options.previousBaseline?.createdAt ?? new Date().toISOString()
+  const previousFindings = options.previousBaseline?.findings ?? {}
+  const findings: Record<string, BaselineEntry> = {}
+
+  const sortedFindings = [...run.findings].sort((a, b) => {
+    const aKey = scopedIssueKey(a.issueId, scopeKeyFromMeta(a.meta))
+    const bKey = scopedIssueKey(b.issueId, scopeKeyFromMeta(b.meta))
+    return aKey.localeCompare(bKey)
+  })
+
+  for (const finding of sortedFindings) {
+    const scopeKey = scopeKeyFromMeta(finding.meta)
+    const entryKey = scopedIssueKey(finding.issueId, scopeKey)
+    const existing = findings[entryKey]
+    if (existing) {
+      existing.occurrences += 1
+      continue
+    }
+
+    const candidate: BaselineEntry = {
+      issueId: finding.issueId,
+      scopeKey,
+      projectName: finding.meta?.projectName,
+      relaxedIssueId: finding.relaxedIssueId,
+      ruleId: finding.ruleId,
+      impact: finding.impact,
+      pageKey: finding.pageKey,
+      pageUrl: finding.pageUrl,
+      targetHash: finding.targetHash,
+      selectorHint: finding.selectorHint,
+      sampleTarget: finding.target[0],
+      help: finding.help,
+      helpUrl: finding.helpUrl,
+      tags: normalizeTags([...finding.tags]),
+      failureHint: finding.failureHint,
+      occurrences: 1,
+      firstSeenAt: createdAt,
+      lastSeenAt: createdAt,
+    }
+
+    const previous = previousFindings[entryKey]
+    if (previous) {
+      candidate.firstSeenAt = previous.firstSeenAt
+      if (isUnchangedEntry(previous, candidate)) {
+        candidate.lastSeenAt = previous.lastSeenAt
+      }
+    }
+
+    findings[entryKey] = candidate
+  }
+
+  const orderedFindings: Record<string, BaselineEntry> = {}
+  for (const key of Object.keys(findings).sort((a, b) => a.localeCompare(b))) {
+    orderedFindings[key] = findings[key]
+  }
+
+  return {
+    version: BASELINE_SCHEMA_VERSION,
+    createdAt,
+    tool: run.tool ?? DEFAULT_TOOL_INFO,
+    configHash: options.configHash,
+    findings: orderedFindings,
+  }
+}