nfunc-mcp 0.4.0 → 0.5.0

package/dist/mappers/runComparator.js

@@ -0,0 +1,165 @@
+/**
+ * Before-and-after comparison of two runs.
+ *
+ * A snapshot answers "what is wrong with this page". A developer about to open
+ * a PR has a different question: "did my fix work, and did I break anything?"
+ * Those are not the same question, and a count cannot distinguish them.
+ *
+ * Measured case, from a page where an `alt` attribute and an `aria-label` were
+ * added to fix a missing-alt-text blocker:
+ *
+ *   before: 2 violations — image-alt (P1), color-contrast (P3)
+ *   after:  2 violations — aria-valid-attr-value (P2), color-contrast (P3)
+ *
+ * Identical totals. The P1 was genuinely fixed, and the fix introduced a new
+ * defect, because the aria-labelledby it added pointed at an id that did not
+ * exist. Anyone reading "2 before, 2 after" concludes the change did nothing.
+ * `newly_introduced` is the half of this module that earns its keep.
+ */
+const key = (d) => `${d.url}|${d.variant}|${d.id}`;
+const runKey = (d) => `${d.url}|${d.variant}`;
+const RANK = { P1: 0, P2: 1, P3: 2 };
+function worst(items) {
+    if (items.length === 0)
+        return null;
+    return items.reduce((acc, i) => (RANK[i.priority] < RANK[acc] ? i.priority : acc), "P3");
+}
+function describe(verdict, fixed, broke, remaining, worstNew) {
+    // The "totals hid it" warning only belongs where the totals actually hid it.
+    // Claiming a count looked unchanged when it went 6 to 2 is the same kind of
+    // imprecision this module exists to remove.
+    const before = fixed + remaining;
+    const after = remaining + broke;
+    const totalsMask = before === after;
+    switch (verdict) {
+        case "clean":
+            return fixed > 0
+                ? `All clear — ${fixed} defect(s) fixed and nothing failing now.`
+                : "All clear — nothing failing in either run.";
+        case "improved":
+            return `${fixed} defect(s) fixed, none introduced. ${remaining} still failing.`;
+        case "mixed":
+            return (`${fixed} defect(s) fixed, but ${broke} newly introduced` +
+                `${worstNew ? ` (worst: ${worstNew})` : ""}. ` +
+                (totalsMask
+                    ? `The total is unchanged at ${after}, so the count alone would suggest nothing happened — ` +
+                        `check newly_introduced before treating this as a clean fix.`
+                    : `Total went ${before} to ${after}; the drop is real but incomplete — ` +
+                        `check newly_introduced before treating this as a clean fix.`));
+        case "regression":
+            return (`${broke} defect(s) newly introduced` +
+                `${worstNew ? ` (worst: ${worstNew})` : ""} and none fixed. This change made things worse.`);
+        case "unchanged":
+            return `No change — ${remaining} defect(s) failing in both runs.`;
+    }
+}
+/**
+ * Compare two defect sets.
+ *
+ * Comparison is per (url, variant, defect id). A defect that moved priority
+ * between runs counts as still failing rather than as fixed-and-reintroduced,
+ * since it is the same defect on the same element — the priority shift shows up
+ * in `still_failing`.
+ */
+export function compareRuns(baselineDir, baseline, current, options = {}) {
+    const warnings = [];
+    const baseByKey = new Map(baseline.map((d) => [key(d), d]));
+    const curByKey = new Map(current.map((d) => [key(d), d]));
+    // Only compare runs both sides actually covered; anything else would report
+    // a "fix" that is really an absence of measurement.
+    const baseRuns = new Set(baseline.map(runKey));
+    const curRuns = new Set(current.map(runKey));
+    const comparableRuns = new Set([...curRuns].filter((r) => baseRuns.has(r)));
+    const notInBaseline = [...curRuns].filter((r) => !baseRuns.has(r));
+    const notInCurrent = [...baseRuns].filter((r) => !curRuns.has(r));
+    const fixed = [];
+    const stillFailing = [];
+    const newlyIntroduced = [];
+    for (const [k, d] of baseByKey) {
+        if (!comparableRuns.has(runKey(d)))
+            continue;
+        if (curByKey.has(k)) {
+            const now = curByKey.get(k);
+            stillFailing.push({ url: d.url, variant: d.variant, id: d.id, priority: now.priority, title: now.title });
+        }
+        else {
+            fixed.push({ url: d.url, variant: d.variant, id: d.id, was: d.priority, title: d.title });
+        }
+    }
+    for (const [k, d] of curByKey) {
+        if (!comparableRuns.has(runKey(d)))
+            continue;
+        if (!baseByKey.has(k)) {
+            newlyIntroduced.push({ url: d.url, variant: d.variant, id: d.id, priority: d.priority, title: d.title });
+        }
+    }
+    const sortByPriority = (items) => items.sort((a, b) => RANK[(a.priority ?? a.was)] - RANK[(b.priority ?? b.was)]);
+    sortByPriority(fixed);
+    sortByPriority(stillFailing);
+    sortByPriority(newlyIntroduced);
+    let verdict;
+    if (newlyIntroduced.length > 0 && fixed.length > 0)
+        verdict = "mixed";
+    else if (newlyIntroduced.length > 0)
+        verdict = "regression";
+    else if (fixed.length > 0)
+        verdict = stillFailing.length === 0 ? "clean" : "improved";
+    else
+        verdict = stillFailing.length === 0 ? "clean" : "unchanged";
+    if (notInBaseline.length > 0) {
+        warnings.push(`${notInBaseline.length} run(s) have no baseline to compare against and were excluded. ` +
+            "Their findings are in the report but not in this comparison.");
+    }
+    if (notInCurrent.length > 0) {
+        warnings.push(`${notInCurrent.length} run(s) in the baseline were not re-tested. A defect can only be ` +
+            "counted as fixed if the page was measured again.");
+    }
+    if (comparableRuns.size === 0) {
+        warnings.push("No run appears in both the baseline and this run, so nothing could be compared. " +
+            "Check that baseline_dir points at an index for the same URLs.");
+    }
+    // Score deltas, where the tool supplies them. Only for comparable runs, and
+    // only where both sides scored the category.
+    let scoreChanges;
+    if (options.baselineScores && options.currentScores) {
+        scoreChanges = [];
+        for (const runId of comparableRuns) {
+            const before = options.baselineScores.get(runId);
+            const after = options.currentScores.get(runId);
+            if (!before || !after)
+                continue;
+            const [url, variant] = runId.split("|");
+            for (const [category, afterScore] of Object.entries(after)) {
+                const beforeScore = before[category];
+                if (typeof beforeScore !== "number" || beforeScore === afterScore)
+                    continue;
+                scoreChanges.push({
+                    url,
+                    variant,
+                    category,
+                    before: beforeScore,
+                    after: afterScore,
+                    delta: afterScore - beforeScore,
+                });
+            }
+        }
+        scoreChanges.sort((a, b) => a.delta - b.delta);
+        if (scoreChanges.length === 0)
+            scoreChanges = undefined;
+    }
+    return {
+        baseline_dir: baselineDir,
+        baseline_runs: baseRuns.size,
+        current_runs: curRuns.size,
+        verdict,
+        summary: describe(verdict, fixed.length, newlyIntroduced.length, stillFailing.length, worst(newlyIntroduced)),
+        fixed,
+        still_failing: stillFailing,
+        newly_introduced: newlyIntroduced,
+        ...(scoreChanges ? { score_changes: scoreChanges } : {}),
+        not_in_baseline: notInBaseline,
+        not_in_current: notInCurrent,
+        warnings,
+    };
+}
+//# sourceMappingURL=runComparator.js.map

package/dist/mappers/runComparator.js.map

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

package/dist/mappers/wcagLevels.d.ts

@@ -0,0 +1,73 @@
+/**
+ * WCAG 2.1 success criteria, their conformance levels, and how to get from a
+ * pa11y finding back to one.
+ *
+ * Levels are transcribed from the specification (https://www.w3.org/TR/WCAG21/)
+ * rather than inferred, because the whole priority scheme now rests on them: a
+ * criterion placed at the wrong level moves a finding between "blocks
+ * conformance" and "enhancement beyond the committed target", which is the
+ * difference between a release blocker and a backlog item.
+ *
+ * Levels are cumulative. AA conformance requires every Level A criterion *and*
+ * every Level AA one, so a single Level A failure makes AA conformance
+ * impossible no matter how clean the AA-specific criteria are. That is why a
+ * Level A failure outranks everything else here.
+ */
+export type WcagConformanceLevel = "A" | "AA" | "AAA";
+export type TargetLevel = WcagConformanceLevel;
+export interface Criterion {
+    number: string;
+    name: string;
+    level: WcagConformanceLevel;
+}
+/** All 78 WCAG 2.1 success criteria. */
+declare const CRITERIA: Criterion[];
+export declare function criterionByNumber(number: string): Criterion | null;
+/**
+ * Pull the criterion out of an HTML_CodeSniffer code.
+ *
+ * htmlcs encodes it directly: "WCAG2AA.Principle1.Guideline1_1.1_1_1.H37"
+ * carries "1_1_1", which is criterion 1.1.1. Note the "WCAG2AA" prefix names
+ * the *standard being tested against*, not the criterion's level — reading it
+ * as a level is a mistake that would mark every finding AA.
+ */
+export declare function criterionFromHtmlcsCode(code: string): Criterion | null;
+export declare function criterionFromAxeRule(ruleId: string): Criterion | null;
+/** Resolve whichever engine produced the finding to a criterion. */
+export declare function criterionFor(code: string, runner: "htmlcs" | "axe"): Criterion | null;
+/** True when the criterion must be met to claim conformance at `target`. */
+export declare function isRequiredFor(level: WcagConformanceLevel, target: TargetLevel): boolean;
+export declare function levelRank(level: WcagConformanceLevel): number;
+export { CRITERIA };
+export interface FailedCriterion {
+    criterion: string;
+    name: string;
+    level: WcagConformanceLevel;
+    findings: number;
+    blocks_target: boolean;
+}
+export interface ConformanceSummary {
+    target_level: TargetLevel;
+    conformant: boolean;
+    /** Distinct criteria failing, by level. Findings can be many per criterion. */
+    failing_criteria: Record<WcagConformanceLevel, number>;
+    /** Criteria above the committed target — enhancements, not gaps. */
+    beyond_target: number;
+    /** Findings that map to no success criterion at all. */
+    best_practice_only: number;
+    failed_criteria: FailedCriterion[];
+    summary: string;
+}
+interface FindingLike {
+    evidence: Record<string, unknown>;
+}
+/**
+ * Roll findings up into a conformance verdict.
+ *
+ * The unit is the **criterion**, not the finding. Twelve findings against one
+ * criterion is one thing to fix and one line in a conformance statement; the
+ * finding count answers "how much work", the criterion count answers "are we
+ * conformant". Reporting only the former is how a report ends up saying a page
+ * has 22 accessibility issues when it fails five criteria.
+ */
+export declare function summariseConformance(findings: FindingLike[], target: TargetLevel): ConformanceSummary;

package/dist/mappers/wcagLevels.js

@@ -0,0 +1,320 @@
+/**
+ * WCAG 2.1 success criteria, their conformance levels, and how to get from a
+ * pa11y finding back to one.
+ *
+ * Levels are transcribed from the specification (https://www.w3.org/TR/WCAG21/)
+ * rather than inferred, because the whole priority scheme now rests on them: a
+ * criterion placed at the wrong level moves a finding between "blocks
+ * conformance" and "enhancement beyond the committed target", which is the
+ * difference between a release blocker and a backlog item.
+ *
+ * Levels are cumulative. AA conformance requires every Level A criterion *and*
+ * every Level AA one, so a single Level A failure makes AA conformance
+ * impossible no matter how clean the AA-specific criteria are. That is why a
+ * Level A failure outranks everything else here.
+ */
+/** All 78 WCAG 2.1 success criteria. */
+const CRITERIA = [
+    { number: "1.1.1", name: "Non-text Content", level: "A" },
+    { number: "1.2.1", name: "Audio-only and Video-only (Prerecorded)", level: "A" },
+    { number: "1.2.2", name: "Captions (Prerecorded)", level: "A" },
+    { number: "1.2.3", name: "Audio Description or Media Alternative (Prerecorded)", level: "A" },
+    { number: "1.2.4", name: "Captions (Live)", level: "AA" },
+    { number: "1.2.5", name: "Audio Description (Prerecorded)", level: "AA" },
+    { number: "1.2.6", name: "Sign Language (Prerecorded)", level: "AAA" },
+    { number: "1.2.7", name: "Extended Audio Description (Prerecorded)", level: "AAA" },
+    { number: "1.2.8", name: "Media Alternative (Prerecorded)", level: "AAA" },
+    { number: "1.2.9", name: "Audio-only (Live)", level: "AAA" },
+    { number: "1.3.1", name: "Info and Relationships", level: "A" },
+    { number: "1.3.2", name: "Meaningful Sequence", level: "A" },
+    { number: "1.3.3", name: "Sensory Characteristics", level: "A" },
+    { number: "1.3.4", name: "Orientation", level: "AA" },
+    { number: "1.3.5", name: "Identify Input Purpose", level: "AA" },
+    { number: "1.3.6", name: "Identify Purpose", level: "AAA" },
+    { number: "1.4.1", name: "Use of Color", level: "A" },
+    { number: "1.4.2", name: "Audio Control", level: "A" },
+    { number: "1.4.3", name: "Contrast (Minimum)", level: "AA" },
+    { number: "1.4.4", name: "Resize Text", level: "AA" },
+    { number: "1.4.5", name: "Images of Text", level: "AA" },
+    { number: "1.4.6", name: "Contrast (Enhanced)", level: "AAA" },
+    { number: "1.4.7", name: "Low or No Background Audio", level: "AAA" },
+    { number: "1.4.8", name: "Visual Presentation", level: "AAA" },
+    { number: "1.4.9", name: "Images of Text (No Exception)", level: "AAA" },
+    { number: "1.4.10", name: "Reflow", level: "AA" },
+    { number: "1.4.11", name: "Non-text Contrast", level: "AA" },
+    { number: "1.4.12", name: "Text Spacing", level: "AA" },
+    { number: "1.4.13", name: "Content on Hover or Focus", level: "AA" },
+    { number: "2.1.1", name: "Keyboard", level: "A" },
+    { number: "2.1.2", name: "No Keyboard Trap", level: "A" },
+    { number: "2.1.3", name: "Keyboard (No Exception)", level: "AAA" },
+    { number: "2.1.4", name: "Character Key Shortcuts", level: "A" },
+    { number: "2.2.1", name: "Timing Adjustable", level: "A" },
+    { number: "2.2.2", name: "Pause, Stop, Hide", level: "A" },
+    { number: "2.2.3", name: "No Timing", level: "AAA" },
+    { number: "2.2.4", name: "Interruptions", level: "AAA" },
+    { number: "2.2.5", name: "Re-authenticating", level: "AAA" },
+    { number: "2.2.6", name: "Timeouts", level: "AAA" },
+    { number: "2.3.1", name: "Three Flashes or Below Threshold", level: "A" },
+    { number: "2.3.2", name: "Three Flashes", level: "AAA" },
+    { number: "2.3.3", name: "Animation from Interactions", level: "AAA" },
+    { number: "2.4.1", name: "Bypass Blocks", level: "A" },
+    { number: "2.4.2", name: "Page Titled", level: "A" },
+    { number: "2.4.3", name: "Focus Order", level: "A" },
+    { number: "2.4.4", name: "Link Purpose (In Context)", level: "A" },
+    { number: "2.4.5", name: "Multiple Ways", level: "AA" },
+    { number: "2.4.6", name: "Headings and Labels", level: "AA" },
+    { number: "2.4.7", name: "Focus Visible", level: "AA" },
+    { number: "2.4.8", name: "Location", level: "AAA" },
+    { number: "2.4.9", name: "Link Purpose (Link Only)", level: "AAA" },
+    { number: "2.4.10", name: "Section Headings", level: "AAA" },
+    { number: "2.5.1", name: "Pointer Gestures", level: "A" },
+    { number: "2.5.2", name: "Pointer Cancellation", level: "A" },
+    { number: "2.5.3", name: "Label in Name", level: "A" },
+    { number: "2.5.4", name: "Motion Actuation", level: "A" },
+    { number: "2.5.5", name: "Target Size", level: "AAA" },
+    { number: "2.5.6", name: "Concurrent Input Mechanisms", level: "AAA" },
+    { number: "3.1.1", name: "Language of Page", level: "A" },
+    { number: "3.1.2", name: "Language of Parts", level: "AA" },
+    { number: "3.1.3", name: "Unusual Words", level: "AAA" },
+    { number: "3.1.4", name: "Abbreviations", level: "AAA" },
+    { number: "3.2.1", name: "On Focus", level: "A" },
+    { number: "3.2.2", name: "On Input", level: "A" },
+    { number: "3.2.3", name: "Consistent Navigation", level: "AA" },
+    { number: "3.2.4", name: "Consistent Identification", level: "AA" },
+    { number: "3.2.5", name: "Change on Request", level: "AAA" },
+    { number: "3.3.1", name: "Error Identification", level: "A" },
+    { number: "3.3.2", name: "Labels or Instructions", level: "A" },
+    { number: "3.3.3", name: "Error Suggestion", level: "AA" },
+    { number: "3.3.4", name: "Error Prevention (Legal, Financial, Data)", level: "AA" },
+    { number: "3.3.5", name: "Help", level: "AAA" },
+    { number: "3.3.6", name: "Error Prevention (All)", level: "AAA" },
+    { number: "4.1.1", name: "Parsing", level: "A" },
+    { number: "4.1.2", name: "Name, Role, Value", level: "A" },
+    { number: "4.1.3", name: "Status Messages", level: "AA" },
+];
+const BY_NUMBER = new Map(CRITERIA.map((c) => [c.number, c]));
+export function criterionByNumber(number) {
+    return BY_NUMBER.get(number) ?? null;
+}
+/**
+ * axe rule id → the success criterion it tests.
+ *
+ * pa11y's axe output carries `impact` and `needsFurtherReview` but **not** the
+ * WCAG tags axe itself attaches, so the mapping has to live here. Rules axe
+ * classifies as best-practice rather than as a WCAG criterion are mapped to
+ * null deliberately: reporting a best-practice rule as a conformance failure
+ * would overstate the legal position, which is the one thing a compliance
+ * report must not do.
+ *
+ * axe rule ids are identical to Lighthouse's accessibility audit ids, because
+ * Lighthouse runs axe internally — so this table serves both engines.
+ */
+const AXE_RULE_TO_CRITERION = {
+    // 1.1.1 Non-text Content
+    "image-alt": "1.1.1",
+    "input-image-alt": "1.1.1",
+    "area-alt": "1.1.1",
+    "object-alt": "1.1.1",
+    "svg-img-alt": "1.1.1",
+    "role-img-alt": "1.1.1",
+    "image-redundant-alt": null, // best practice
+    // 1.2.x media
+    "video-caption": "1.2.2",
+    "audio-caption": "1.2.1",
+    // 1.3.1 Info and Relationships
+    "aria-required-children": "1.3.1",
+    "aria-required-parent": "1.3.1",
+    list: "1.3.1",
+    listitem: "1.3.1",
+    "definition-list": "1.3.1",
+    dlitem: "1.3.1",
+    "td-headers-attr": "1.3.1",
+    "th-has-data-cells": "1.3.1",
+    "table-fake-caption": "1.3.1",
+    "td-has-header": "1.3.1",
+    // 1.3.4 / 1.3.5
+    "css-orientation-lock": "1.3.4",
+    "autocomplete-valid": "1.3.5",
+    // 1.4.x contrast and text
+    "link-in-text-block": "1.4.1",
+    "color-contrast": "1.4.3",
+    "color-contrast-enhanced": "1.4.6",
+    "meta-viewport": "1.4.4",
+    "meta-viewport-large": null, // best practice
+    "avoid-inline-spacing": "1.4.12",
+    // 2.1.x keyboard
+    accesskeys: null, // best practice
+    "scrollable-region-focusable": "2.1.1",
+    "frame-focusable-content": "2.1.1",
+    "server-side-image-map": "2.1.1",
+    // 2.2.x timing
+    "meta-refresh": "2.2.1",
+    "meta-refresh-no-exceptions": "2.2.4",
+    marquee: "2.2.2",
+    blink: "2.2.2",
+    // 2.4.x navigation
+    bypass: "2.4.1",
+    "document-title": "2.4.2",
+    "link-name": "2.4.4",
+    "frame-title": "4.1.2",
+    "frame-title-unique": "4.1.2",
+    "landmark-one-main": null, // best practice
+    region: null, // best practice
+    "page-has-heading-one": null, // best practice
+    "heading-order": null, // best practice
+    "empty-heading": null, // best practice
+    "identical-links-same-purpose": "2.4.9",
+    // 2.5.x input modality
+    "label-content-name-mismatch": "2.5.3",
+    "target-size": "2.5.5", // AAA in WCAG 2.1 — see note in levelForAxeRule
+    // 3.1.x language
+    "html-has-lang": "3.1.1",
+    "html-lang-valid": "3.1.1",
+    "html-xml-lang-mismatch": "3.1.1",
+    "valid-lang": "3.1.2",
+    // 3.3.x forms
+    "form-field-multiple-labels": "3.3.2",
+    label: "4.1.2",
+    "label-title-only": null, // best practice
+    // 4.1.x robust
+    "duplicate-id": "4.1.1",
+    "duplicate-id-active": "4.1.1",
+    "duplicate-id-aria": "4.1.1",
+    "aria-allowed-attr": "4.1.2",
+    "aria-allowed-role": null, // best practice
+    "aria-prohibited-attr": "4.1.2",
+    "aria-required-attr": "4.1.2",
+    "aria-roles": "4.1.2",
+    "aria-valid-attr": "4.1.2",
+    "aria-valid-attr-value": "4.1.2",
+    "aria-hidden-body": "4.1.2",
+    "aria-hidden-focus": "4.1.2",
+    "aria-input-field-name": "4.1.2",
+    "aria-toggle-field-name": "4.1.2",
+    "aria-command-name": "4.1.2",
+    "aria-meter-name": "4.1.2",
+    "aria-progressbar-name": "4.1.2",
+    "aria-tooltip-name": "4.1.2",
+    "aria-dialog-name": "4.1.2",
+    "aria-text": "4.1.2",
+    "aria-treeitem-name": "4.1.2",
+    "button-name": "4.1.2",
+    "select-name": "4.1.2",
+    "input-button-name": "4.1.2",
+    "nested-interactive": "4.1.2",
+    "presentation-role-conflict": null, // best practice
+    "aria-braille-equivalent": null, // best practice
+    "empty-table-header": null, // best practice
+    "frame-tested": null, // not a criterion
+    "aria-status": "4.1.3",
+};
+/**
+ * Pull the criterion out of an HTML_CodeSniffer code.
+ *
+ * htmlcs encodes it directly: "WCAG2AA.Principle1.Guideline1_1.1_1_1.H37"
+ * carries "1_1_1", which is criterion 1.1.1. Note the "WCAG2AA" prefix names
+ * the *standard being tested against*, not the criterion's level — reading it
+ * as a level is a mistake that would mark every finding AA.
+ */
+export function criterionFromHtmlcsCode(code) {
+    const match = /Guideline\d+_\d+\.(\d+)_(\d+)_(\d+)/.exec(code);
+    if (!match)
+        return null;
+    return criterionByNumber(`${match[1]}.${match[2]}.${match[3]}`);
+}
+export function criterionFromAxeRule(ruleId) {
+    const number = AXE_RULE_TO_CRITERION[ruleId];
+    if (!number)
+        return null;
+    return criterionByNumber(number);
+}
+/** Resolve whichever engine produced the finding to a criterion. */
+export function criterionFor(code, runner) {
+    return runner === "axe" ? criterionFromAxeRule(code) : criterionFromHtmlcsCode(code);
+}
+const ORDER = { A: 0, AA: 1, AAA: 2 };
+/** True when the criterion must be met to claim conformance at `target`. */
+export function isRequiredFor(level, target) {
+    return ORDER[level] <= ORDER[target];
+}
+export function levelRank(level) {
+    return ORDER[level];
+}
+export { CRITERIA };
+/**
+ * Roll findings up into a conformance verdict.
+ *
+ * The unit is the **criterion**, not the finding. Twelve findings against one
+ * criterion is one thing to fix and one line in a conformance statement; the
+ * finding count answers "how much work", the criterion count answers "are we
+ * conformant". Reporting only the former is how a report ends up saying a page
+ * has 22 accessibility issues when it fails five criteria.
+ */
+export function summariseConformance(findings, target) {
+    const byCriterion = new Map();
+    let bestPracticeOnly = 0;
+    for (const finding of findings) {
+        const number = finding.evidence["wcag_criterion"];
+        if (typeof number !== "string") {
+            bestPracticeOnly++;
+            continue;
+        }
+        const criterion = criterionByNumber(number);
+        if (!criterion) {
+            bestPracticeOnly++;
+            continue;
+        }
+        const existing = byCriterion.get(number);
+        if (existing)
+            existing.findings++;
+        else
+            byCriterion.set(number, {
+                criterion: number,
+                name: criterion.name,
+                level: criterion.level,
+                findings: 1,
+                blocks_target: isRequiredFor(criterion.level, target),
+            });
+    }
+    const failed = [...byCriterion.values()].sort((a, b) => ORDER[a.level] - ORDER[b.level] || a.criterion.localeCompare(b.criterion));
+    const blocking = failed.filter((f) => f.blocks_target);
+    const failing = { A: 0, AA: 0, AAA: 0 };
+    for (const f of blocking)
+        failing[f.level]++;
+    const beyond = failed.length - blocking.length;
+    const conformant = blocking.length === 0;
+    const criteria = (n) => (n === 1 ? "criterion" : "criteria");
+    let summary;
+    if (conformant) {
+        summary =
+            `No Level ${target} conformance failures detected by automated testing. ` +
+                `This is not the same as being conformant — automated tools cover roughly a third of ` +
+                `WCAG criteria, and the rest need manual verification.`;
+    }
+    else if (failing.A > 0) {
+        summary =
+            `Not Level ${target} conformant. ${failing.A} Level A ${criteria(failing.A)} ` +
+                `${failing.A === 1 ? "fails" : "fail"}` +
+                (failing.AA > 0 ? `, plus ${failing.AA} at Level AA` : "") +
+                `. Level A is the floor — while any Level A criterion fails, Level ${target} conformance is ` +
+                `unreachable no matter how the remaining criteria score, so fix those first.`;
+    }
+    else {
+        summary =
+            `Not Level ${target} conformant. Level A is fully met, but ${failing.AA} Level AA ` +
+                `${criteria(failing.AA)} ${failing.AA === 1 ? "fails" : "fail"}.`;
+    }
+    if (beyond > 0) {
+        summary += ` ${beyond} ${criteria(beyond)} above Level ${target} also failed; those are enhancements, not gaps.`;
+    }
+    return {
+        target_level: target,
+        conformant,
+        failing_criteria: failing,
+        beyond_target: beyond,
+        best_practice_only: bestPracticeOnly,
+        failed_criteria: failed,
+        summary,
+    };
+}
+//# sourceMappingURL=wcagLevels.js.map

package/dist/mappers/wcagLevels.js.map

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

package/dist/tools/accessibility.d.ts

@@ -1,2 +1,3 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export type A11yFormFactor = "desktop" | "mobile";
 export declare function registerAccessibilityTool(server: McpServer): void;