eaa-kit 0.5.0 → 0.7.0

package/dist/criteria-CnPJKGeb.js

@@ -0,0 +1,286 @@
+//#region src/audit/criteria.ts
+/**
+* WCAG 2.2 at Levels A and AA, which is what this tool audits against.
+*
+* 4.1.1 Parsing is deliberately absent: it was removed in WCAG 2.2 and counting
+* it would inflate the denominator with a criterion nobody has to meet.
+*/
+const WCAG22_AA_CRITERIA = [
+	{
+		number: "1.1.1",
+		title: "Non-text Content",
+		level: "A"
+	},
+	{
+		number: "1.2.1",
+		title: "Audio-only and Video-only (Prerecorded)",
+		level: "A"
+	},
+	{
+		number: "1.2.2",
+		title: "Captions (Prerecorded)",
+		level: "A"
+	},
+	{
+		number: "1.2.3",
+		title: "Audio Description or Media Alternative (Prerecorded)",
+		level: "A"
+	},
+	{
+		number: "1.2.4",
+		title: "Captions (Live)",
+		level: "AA"
+	},
+	{
+		number: "1.2.5",
+		title: "Audio Description (Prerecorded)",
+		level: "AA"
+	},
+	{
+		number: "1.3.1",
+		title: "Info and Relationships",
+		level: "A"
+	},
+	{
+		number: "1.3.2",
+		title: "Meaningful Sequence",
+		level: "A"
+	},
+	{
+		number: "1.3.3",
+		title: "Sensory Characteristics",
+		level: "A"
+	},
+	{
+		number: "1.3.4",
+		title: "Orientation",
+		level: "AA"
+	},
+	{
+		number: "1.3.5",
+		title: "Identify Input Purpose",
+		level: "AA"
+	},
+	{
+		number: "1.4.1",
+		title: "Use of Color",
+		level: "A"
+	},
+	{
+		number: "1.4.2",
+		title: "Audio Control",
+		level: "A"
+	},
+	{
+		number: "1.4.3",
+		title: "Contrast (Minimum)",
+		level: "AA"
+	},
+	{
+		number: "1.4.4",
+		title: "Resize Text",
+		level: "AA"
+	},
+	{
+		number: "1.4.5",
+		title: "Images of Text",
+		level: "AA"
+	},
+	{
+		number: "1.4.10",
+		title: "Reflow",
+		level: "AA"
+	},
+	{
+		number: "1.4.11",
+		title: "Non-text Contrast",
+		level: "AA"
+	},
+	{
+		number: "1.4.12",
+		title: "Text Spacing",
+		level: "AA"
+	},
+	{
+		number: "1.4.13",
+		title: "Content on Hover or Focus",
+		level: "AA"
+	},
+	{
+		number: "2.1.1",
+		title: "Keyboard",
+		level: "A"
+	},
+	{
+		number: "2.1.2",
+		title: "No Keyboard Trap",
+		level: "A"
+	},
+	{
+		number: "2.1.4",
+		title: "Character Key Shortcuts",
+		level: "A"
+	},
+	{
+		number: "2.2.1",
+		title: "Timing Adjustable",
+		level: "A"
+	},
+	{
+		number: "2.2.2",
+		title: "Pause, Stop, Hide",
+		level: "A"
+	},
+	{
+		number: "2.3.1",
+		title: "Three Flashes or Below Threshold",
+		level: "A"
+	},
+	{
+		number: "2.4.1",
+		title: "Bypass Blocks",
+		level: "A"
+	},
+	{
+		number: "2.4.2",
+		title: "Page Titled",
+		level: "A"
+	},
+	{
+		number: "2.4.3",
+		title: "Focus Order",
+		level: "A"
+	},
+	{
+		number: "2.4.4",
+		title: "Link Purpose (In Context)",
+		level: "A"
+	},
+	{
+		number: "2.4.5",
+		title: "Multiple Ways",
+		level: "AA"
+	},
+	{
+		number: "2.4.6",
+		title: "Headings and Labels",
+		level: "AA"
+	},
+	{
+		number: "2.4.7",
+		title: "Focus Visible",
+		level: "AA"
+	},
+	{
+		number: "2.4.11",
+		title: "Focus Not Obscured (Minimum)",
+		level: "AA"
+	},
+	{
+		number: "2.5.1",
+		title: "Pointer Gestures",
+		level: "A"
+	},
+	{
+		number: "2.5.2",
+		title: "Pointer Cancellation",
+		level: "A"
+	},
+	{
+		number: "2.5.3",
+		title: "Label in Name",
+		level: "A"
+	},
+	{
+		number: "2.5.4",
+		title: "Motion Actuation",
+		level: "A"
+	},
+	{
+		number: "2.5.7",
+		title: "Dragging Movements",
+		level: "AA"
+	},
+	{
+		number: "2.5.8",
+		title: "Target Size (Minimum)",
+		level: "AA"
+	},
+	{
+		number: "3.1.1",
+		title: "Language of Page",
+		level: "A"
+	},
+	{
+		number: "3.1.2",
+		title: "Language of Parts",
+		level: "AA"
+	},
+	{
+		number: "3.2.1",
+		title: "On Focus",
+		level: "A"
+	},
+	{
+		number: "3.2.2",
+		title: "On Input",
+		level: "A"
+	},
+	{
+		number: "3.2.3",
+		title: "Consistent Navigation",
+		level: "AA"
+	},
+	{
+		number: "3.2.4",
+		title: "Consistent Identification",
+		level: "AA"
+	},
+	{
+		number: "3.2.6",
+		title: "Consistent Help",
+		level: "A"
+	},
+	{
+		number: "3.3.1",
+		title: "Error Identification",
+		level: "A"
+	},
+	{
+		number: "3.3.2",
+		title: "Labels or Instructions",
+		level: "A"
+	},
+	{
+		number: "3.3.3",
+		title: "Error Suggestion",
+		level: "AA"
+	},
+	{
+		number: "3.3.4",
+		title: "Error Prevention (Legal, Financial, Data)",
+		level: "AA"
+	},
+	{
+		number: "3.3.7",
+		title: "Redundant Entry",
+		level: "A"
+	},
+	{
+		number: "3.3.8",
+		title: "Accessible Authentication (Minimum)",
+		level: "AA"
+	},
+	{
+		number: "4.1.2",
+		title: "Name, Role, Value",
+		level: "A"
+	},
+	{
+		number: "4.1.3",
+		title: "Status Messages",
+		level: "AA"
+	}
+];
+//#endregion
+export { WCAG22_AA_CRITERIA as t };

package/dist/eleventy/index.d.ts

@@ -1,4 +1,4 @@
-import { n as IntegrationOptions, t as BuildAuditError } from "../run-CtcEUhbe.js";
+import { n as IntegrationOptions, t as BuildAuditError } from "../run-BK2blxMI.js";
 //#region src/eleventy/index.d.ts
 /** What `eleventy.after` is given. Only two of its fields are read. */
 interface EleventyAfterEvent {

package/dist/eleventy/index.js

@@ -1,4 +1,4 @@
-import { n as auditBuild, r as stderrLogger, t as BuildAuditError } from "../run-C2nKFcb-.js";
+import { n as auditBuild, r as stderrLogger, t as BuildAuditError } from "../run-DrS0Komf.js";
 import path from "node:path";
 //#region src/eleventy/index.ts
 /**

package/dist/{html-C4vktg0A.js → html-BIxxF3FC.js}

@@ -1,10 +1,12 @@
-import { a as impactRank, i as impactLabel, r as countAtOrAbove } from "./impact-DZt2oBCP.js";
-import { i as escapeText, n as count, o as standardsReference, r as escapeAttribute, t as collapse } from "./text-CKKpzkYM.js";
+import { a as impactLabel, r as byImpactThenRule } from "./impact-luGCnN8F.js";
+import { i as escapeText, n as count, r as escapeAttribute, s as standardsReference, t as collapse } from "./text-BF1LHMiV.js";
 import { t as TOOL_VERSION } from "./version-B3v4rNoG.js";
-import { a as isShared, i as groupIssues, n as blindRules, o as discoveryLabel, r as coverageParts, s as missedParts, t as remediationFor } from "./remediation-CMBIrnpN.js";
-import { r as componentPath } from "./component-C3GL1Mnu.js";
-import { i as understandingUrl, r as manualCheckFor, t as buildCoverage } from "./coverage-B_Y6l-Ra.js";
-import { n as buildSummary } from "./json-DROX33kh.js";
+import { u as runEngine } from "./result-B7_zVxAX.js";
+import { l as reviewSentence } from "./review-CdMK2GpQ.js";
+import { a as isShared, c as missedParts, i as groupIssues, l as reusedPart, n as blindRules, o as issueTotals, r as coverageParts, s as discoveryLabel, t as remediationFor } from "./remediation-C0klJblu.js";
+import { r as componentPath } from "./component-ChisoFyY.js";
+import { a as manualCheckFor, o as understandingUrl, r as reviewSummary, t as buildCoverage } from "./coverage-cb5kPp48.js";
+import { n as buildSummary } from "./json-Bus6YhxB.js";
 import axe from "axe-core";
 //#region src/audit/report/html.ts
 /**
@@ -36,8 +38,8 @@ const MAX_NODES = 5;
 /** Longest element markup shown before it is truncated. */
 const MAX_SNIPPET = 200;
 function buildHtmlReport(audits, options) {
-	const engine = audits[0]?.engine ?? "jsdom";
-	const failing = countAtOrAbove(audits, options.failOn);
+	const engine = runEngine(audits);
+	const totals = buildSummary(audits, options.failOn);
 	const generatedAt = (options.now ?? /* @__PURE__ */ new Date()).toISOString();
 	const title = `Accessibility audit · ${options.directory}`;
 	return `<!doctype html>
@@ -54,15 +56,15 @@ ${STYLES}
 <body>
 <main>
 <h1>Accessibility audit</h1>
-${verdict(audits, failing, options)}
+${verdict(totals, options)}
 ${scoreboard(audits)}
 ${issues(audits, options)}
 ${runDetails(audits, engine, generatedAt, options)}
 ${notMeasured(options)}
-${summary(audits, failing, options)}
+${summary(totals, options)}
 ${pages(audits)}
 ${notEvaluated(audits)}
-${coverageSection(audits)}
+${coverageSection(audits, options)}
 ${footer()}
 </main>
 </body>
@@ -77,11 +79,11 @@ ${footer()}
 * which would be an embarrassing thing for this document in particular to get
 * wrong.
 */
-function verdict(audits, failing, options) {
-	const unaudited = audits.filter((audit) => audit.error).length;
+function verdict(totals, options) {
+	const unaudited = totals.pagesNotAudited;
 	if (unaudited > 0) return banner("broken", "Could not finish", `${count(unaudited, "page")} could not be audited, so this run reached no verdict.`);
-	if (failing > 0) return banner("fail", "Violations found", `${count(failing, "violation")} at or above ${escapeText(options.failOn)}.`);
-	const below = totalViolations(audits) - failing;
+	if (totals.failing > 0) return banner("fail", "Violations found", `${count(totals.failing, "violation")} at or above ${escapeText(options.failOn)}.`);
+	const below = totals.violations - totals.failing;
 	if (below > 0) return banner("pass", "No violations at the threshold", `${count(below, "violation")} below ${escapeText(options.failOn)}, which do not fail the run.`);
 	const completeness = options.completeness;
 	if (completeness && !completeness.complete) return banner("partial", "No violations found, but the whole site was not measured", `${escapeText(missedParts(completeness).join(", "))}. This report describes ${count(completeness.audited, "page")}, not the site.`);
@@ -101,6 +103,8 @@ function runDetails(audits, engine, generatedAt, options) {
 	];
 	if (options.baseUrl) rows.splice(1, 0, ["Base URL", options.baseUrl]);
 	if (options.completeness) rows.splice(2, 0, ["Pages found via", discoveryLabel(options.completeness.discovery)]);
+	const reused = options.completeness ? reusedPart(options.completeness) : void 0;
+	if (reused !== void 0) rows.push(["Reused", reused]);
 	return `<h2>The run</h2>\n<dl class="run">\n${rows.map(([term, value]) => `  <div><dt>${escapeText(term)}</dt><dd>${escapeText(value)}</dd></div>`).join("\n")}\n</dl>`;
 }
 /** Pages named individually before the rest are counted. */
@@ -137,13 +141,12 @@ function notMeasured(options) {
 * the kind of bug nobody notices until a client does, so there is one place
 * that counts.
 */
-function summary(audits, failing, options) {
-	const totals = buildSummary(audits, options.failOn);
+function summary(totals, options) {
 	const impacts = IMPACT_ORDER.filter((impact) => totals.byImpact[impact] > 0).map((impact) => `  <li><span class="badge ${escapeAttribute(impact)}">${escapeText(impact)}</span> ${totals.byImpact[impact]}</li>`).join("\n");
 	return `<h2>Summary</h2>
 <ul class="counts">
   <li><strong>${count(totals.violations, "violation")}</strong> on ${totals.pagesWithViolations} of ${count(totals.pages, "page")}, across ${count(totals.violatingElements, "element")}</li>
-  <li><strong>${failing}</strong> at or above ${escapeText(options.failOn)}</li>
+  <li><strong>${totals.failing}</strong> at or above ${escapeText(options.failOn)}</li>
   <li><strong>${totals.needsReview}</strong> ${totals.needsReview === 1 ? "rule needs" : "rules need"} manual review</li>
   <li><strong>${totals.notEvaluated}</strong> ${totals.notEvaluated === 1 ? "rule was" : "rules were"} not evaluated by this engine</li>
 ${totals.accepted > 0 ? `  <li><strong>${totals.accepted}</strong> ${totals.accepted === 1 ? "element is" : "elements are"} accepted by the baseline, and not counted above</li>` : ""}
@@ -236,8 +239,8 @@ ${manualBlock(ruleId, finding)}
 * majority of WCAG, and a percentage would present a limit of automated testing
 * as a property of this site.
 */
-function coverageSection(audits) {
-	const coverage = buildCoverage(audits);
+function coverageSection(audits, options) {
+	const coverage = buildCoverage(audits, void 0, options.review);
 	const rows = coverage.criteria.map((criterion) => {
 		const url = understandingUrl(criterion.number);
 		const name = escapeText(`${criterion.number} ${criterion.title}`);
@@ -245,7 +248,7 @@ function coverageSection(audits) {
 		return `  <tr class="${escapeAttribute(criterion.status)}">
     <td>${linked}</td>
     <td>${escapeText(criterion.level)}</td>
-    <td>${statusText(criterion)}</td>
+    <td>${statusText(criterion)}${reviewCell(criterion)}</td>
   </tr>`;
 	}).join("\n");
 	return `<h2>Coverage of WCAG 2.2 AA</h2>
@@ -263,6 +266,7 @@ function coverageSection(audits) {
   of WCAG cannot be automated, and a percentage here would present that limit of automated
   testing as though it were a measurement of this site.
 </p>
+${reviewParagraph(coverage)}
 <div class="scroll">
 <table class="coverage">
 <thead><tr><th>Success criterion</th><th>Level</th><th>This run</th></tr></thead>
@@ -272,6 +276,20 @@ ${rows}
 </table>
 </div>`;
 }
+/**
+* What a person recorded, where a review was supplied.
+*
+* Its own paragraph, under the four counts and visibly apart from them: the
+* counts are what an engine measured and this is what somebody says they
+* checked. This document is the one that leaves the building, so the difference
+* between the two has to survive being quoted.
+*/
+function reviewParagraph(coverage) {
+	const summary = reviewSummary(coverage);
+	if (summary === void 0) return "";
+	return `<p class="note review">${escapeText(summary)} eaa-kit cannot check that anything
+  recorded in a review is true; it reports it as the claim it is.</p>`;
+}
 function statusText(criterion) {
 	const browser = criterion.browserWouldAnswer ? " <em>(a real browser would answer this)</em>" : "";
 	switch (criterion.status) {
@@ -281,6 +299,16 @@ function statusText(criterion) {
 		case "no-automated-rule": return "No automated rule exists; a person must check it";
 	}
 }
+/**
+* What a person recorded about this criterion, in the cell that says what the
+* run reached. The same sentence the console report prints, from the same
+* function, so two documents of one run cannot word it differently.
+*/
+function reviewCell(criterion) {
+	const review = criterion.review;
+	if (review === void 0) return "";
+	return `<br><span class="reviewed">${escapeText(reviewSentence(review))}</span>`;
+}
 function footer() {
 	return `<hr>
 <footer>
@@ -303,12 +331,6 @@ function standards(finding) {
 function standardsText(finding) {
 	return escapeText(standardsReference(finding.successCriteria, finding.enClauses));
 }
-function totalViolations(audits) {
-	return audits.reduce((total, audit) => total + audit.violations.length, 0);
-}
-function byImpactThenRule(a, b) {
-	return impactRank(a.impact) - impactRank(b.impact) || a.ruleId.localeCompare(b.ruleId);
-}
 const STYLES = `:root { color-scheme: light dark; }
 body { margin: 0; background: #ffffff; color: #1a1a1a;
   font-family: system-ui, -apple-system, "Segoe UI", Roboto, sans-serif; line-height: 1.6; }
@@ -362,6 +384,8 @@ table.coverage tr.evaluated td:last-child { color: #216e39; }
 table.coverage em { font-style: normal; opacity: 0.75; }
 ul.unreachable li { margin-bottom: 0.2rem; overflow-wrap: anywhere; }
 code.selector { color: #4a4a4a; }
+.reviewed { color: #4a4a4a; font-size: 0.95em; }
+p.note.review { border-left: 3px solid #c9c9c9; padding-left: 0.75rem; }
 p.clean { color: #216e39; }
 p.note { font-size: 0.95rem; }
 hr { border: 0; border-top: 1px solid #d4d4d4; margin: 3rem 0 1.5rem; }
@@ -401,7 +425,8 @@ ul.page-list { margin: 0.35rem 0 0; padding-left: 1.25rem; }
   pre { background: #1e1e1e; }
   li.finding { border-color: #3a3a3a; }
   p.standards, p.coverage, .reason, li.more, code.selector, footer,
-  p.accepted-heading, ul.accepted { color: #b6b6b6; }
+  p.accepted-heading, ul.accepted, .reviewed { color: #b6b6b6; }
+  p.note.review { border-left-color: #555; }
   p.clean { color: #7ee2a8; }
   .verdict.pass { background: #10240f; border-color: #7ee2a8; }
   .verdict.fail { background: #2b1111; border-color: #ff9d9d; }
@@ -467,8 +492,7 @@ function scoreboard(audits) {
 function issues(audits, options) {
 	const found = groupIssues(audits);
 	if (found.length === 0) return "";
-	const elements = found.reduce((total, issue) => total + issue.elements.length, 0);
-	const occurrences = found.reduce((total, issue) => total + issue.occurrences, 0);
+	const { elements, occurrences } = issueTotals(found);
 	const intro = occurrences === elements ? `${count(elements, "distinct element")} to fix.` : `${count(occurrences, "violation")} across the site, from ${count(elements, "distinct element")}.`;
 	return `<h2 id="issues">What to fix</h2>
 <p class="intro">${escapeText(intro)}</p>

package/dist/{impact-DZt2oBCP.js → impact-luGCnN8F.js}

@@ -36,6 +36,16 @@ function impactRank(impact) {
 function impactLabel(impact) {
 	return impact !== null && isImpactLevel(impact) ? impact : "unclassified";
 }
+/**
+* Worst first, then by rule id so two runs of the same build agree.
+*
+* The order every format lists a page's findings in. Issues are sorted by
+* `bySeverityThenReach` instead, which adds the reach a grouped issue has and a
+* single page's findings do not.
+*/
+function byImpactThenRule(a, b) {
+	return impactRank(a.impact) - impactRank(b.impact) || a.ruleId.localeCompare(b.ruleId);
+}
 /** Violations at or above `threshold`, counted per rule per page. */
 function countAtOrAbove(audits, threshold) {
 	let total = 0;
@@ -43,4 +53,4 @@ function countAtOrAbove(audits, threshold) {
 	return total;
 }
 //#endregion
-export { impactRank as a, impactLabel as i, IMPACT_LEVELS as n, isImpactLevel as o, countAtOrAbove as r, meetsThreshold as s, DEFAULT_FAIL_ON as t };
+export { impactLabel as a, meetsThreshold as c, countAtOrAbove as i, IMPACT_LEVELS as n, impactRank as o, byImpactThenRule as r, isImpactLevel as s, DEFAULT_FAIL_ON as t };

package/dist/index.d.ts

@@ -136,12 +136,21 @@ declare const auditSchema: Schema<ObjectOf<{
   manual: OptionalSchema<boolean>;
   /** List every WCAG 2.2 A/AA criterion and what the run reached on it. */
   coverage: OptionalSchema<boolean>;
+  /** Path to a review record: what a person checked, for the criteria no engine reaches. */
+  review: OptionalSchema<string>;
+  /** Days after which a recorded review stops counting. */
+  reviewMaxAge: OptionalSchema<number>;
   /**
    * False is `--no-build`: never run the project's build or start its server to
    * find something to audit. Written in the positive because that is the state
    * being described, and because a config file has no flags to negate.
    */
   build: OptionalSchema<boolean>;
+  /**
+   * False is `--no-cache`: audit every page, reusing nothing an earlier run
+   * measured. Written in the positive for the same reason `build` is.
+   */
+  cache: OptionalSchema<boolean>;
 }>>;
 declare const configSchema: Schema<ObjectOf<{
   site: Schema<ObjectOf<{
@@ -232,12 +241,21 @@ declare const configSchema: Schema<ObjectOf<{
     manual: OptionalSchema<boolean>;
     /** List every WCAG 2.2 A/AA criterion and what the run reached on it. */
     coverage: OptionalSchema<boolean>;
+    /** Path to a review record: what a person checked, for the criteria no engine reaches. */
+    review: OptionalSchema<string>;
+    /** Days after which a recorded review stops counting. */
+    reviewMaxAge: OptionalSchema<number>;
     /**
      * False is `--no-build`: never run the project's build or start its server to
      * find something to audit. Written in the positive because that is the state
      * being described, and because a config file has no flags to negate.
      */
     build: OptionalSchema<boolean>;
+    /**
+     * False is `--no-cache`: audit every page, reusing nothing an earlier run
+     * measured. Written in the positive for the same reason `build` is.
+     */
+    cache: OptionalSchema<boolean>;
   }>>;
 }>>;
 /**
@@ -349,6 +367,24 @@ declare class StatementError extends Error {
   readonly name = "StatementError";
 }
 //#endregion
+//#region src/audit/review.d.ts
+declare const reviewSchema: Schema<ObjectOf<{
+  schemaVersion: Schema<number>;
+  /** Who carried out the review, for the record as a whole. */
+  reviewedBy: OptionalSchema<string>;
+  /** Keyed by success criterion number, e.g. '1.2.1'. */
+  criteria: DefaultedSchema<Record<string, ObjectOf<{
+    result: DefaultedSchema<"met" | "not-applicable" | "not-met" | "unreviewed">;
+    /** ISO date the check was done. Without it the entry cannot be aged. */
+    reviewedOn: OptionalSchema<string>;
+    /** Who did it, when that is not the person named on the record. */
+    reviewedBy: OptionalSchema<string>;
+    /** What was checked and what was found. Free text, for whoever reads it. */
+    note: OptionalSchema<string>;
+  }>>>;
+}>>;
+type ReviewRecord = Infer<typeof reviewSchema>;
+//#endregion
 //#region src/statement/findings.d.ts
 /** One rule that failed, folded across every page it failed on. */
 interface AuditFinding {
@@ -394,6 +430,47 @@ declare function summariseAuditReport(value: unknown, source?: string): AuditSum
 /** Read and summarise a report written by `eaa-kit audit --format json`. */
 declare function readAuditReport(file: string, cwd?: string): Promise<AuditSummary>;
 //#endregion
+//#region src/statement/evidence.d.ts
+/**
+ * Whether the statement's claim survives contact with the evidence beside it.
+ *
+ * The README has said since 0.1 that "a statement claiming full conformance for
+ * a site that is not conformant is worse than no statement at all", and until
+ * now the tool did nothing about it: `compliance.status` came out of the config
+ * file, the audit report came in through `--audit`, and nothing ever put the
+ * two in the same room. A run could print a document claiming full conformance
+ * directly above the list of barriers that disproves it.
+ *
+ * This is the check that was missing. It is deliberately narrow: it does not
+ * decide whether a site is accessible, and it cannot — most of WCAG is not
+ * automatable and the whole tool is built around saying so. It refuses only
+ * claims the evidence in hand already contradicts, and warns where a document
+ * is citing evidence that no longer describes the site.
+ *
+ * Nothing here needs an audit report. Given none, only the dates are checked,
+ * and a project that has never run one gets exactly the statement it always
+ * got — the tool cannot audit what it was not shown.
+ */
+/** How much a problem matters. `refuses` stops the statement being written. */
+type EvidenceSeverity = 'refuses' | 'warns';
+interface EvidenceProblem {
+  severity: EvidenceSeverity;
+  /** One sentence stating the contradiction, and one naming the fix. */
+  message: string;
+}
+interface EvidenceInput {
+  config: EaaConfig;
+  /** From `--audit`. Without it only the dates can be checked. */
+  audit?: AuditSummary;
+  /** From `--review`. Read for this check alone; it does not reach the text. */
+  review?: ReviewRecord;
+  /** Injectable so the ageing checks can be tested without waiting. */
+  today?: Date;
+}
+declare function checkStatementEvidence(input: EvidenceInput): EvidenceProblem[];
+/** Whether any problem is bad enough to stop the document being written. */
+declare function refuses(problems: readonly EvidenceProblem[]): boolean;
+//#endregion
 //#region src/statement/html.d.ts
 /**
  * Markdown-to-HTML for exactly the subset the statement templates emit, and
@@ -447,6 +524,15 @@ interface RenderStatementOptions {
    * config lists. Left out, the statement says only what the config says.
    */
   audit?: AuditSummary;
+  /**
+   * What a person checked, from `eaa-kit checklist`.
+   *
+   * Reaches the document as one fact — how many of WCAG's success criteria were
+   * checked by hand, and when — and never as a verdict. What a review concluded
+   * about a criterion is a claim by a person, and the place for a claim in a
+   * statement is the barrier list, which a person writes.
+   */
+  review?: ReviewRecord;
 }
 interface RenderedStatement {
   markdown: string;
@@ -466,4 +552,4 @@ interface RenderedStatement {
  */
 declare function renderStatement(config: EaaConfig, options?: RenderStatementOptions): Promise<RenderedStatement>;
 //#endregion
-export { ASSESSMENT_METHODS, type AssessmentMethod, type AuditFinding, type AuditSummary, COMPLIANCE_STATUSES, CONFIG_FILENAMES, COUNTRIES, type ComplianceStatus, ConfigError, type Country, type EaaConfig, type EaaConfigInput, type HtmlDocumentOptions, ISSUE_REASONS, type IssueReason, type KnownIssue, type LoadConfigOptions, type LoadedConfig, type RenderStatementOptions, type RenderedStatement, STATEMENT_LOCALES, StatementError, type StatementLocale, configSchema, defineConfig, findConfigFile, loadConfig, parseConfig, readAuditReport, renderStatement, summariseAuditReport, toHtmlBody, toHtmlDocument };
+export { ASSESSMENT_METHODS, type AssessmentMethod, type AuditFinding, type AuditSummary, COMPLIANCE_STATUSES, CONFIG_FILENAMES, COUNTRIES, type ComplianceStatus, ConfigError, type Country, type EaaConfig, type EaaConfigInput, type EvidenceInput, type EvidenceProblem, type EvidenceSeverity, type HtmlDocumentOptions, ISSUE_REASONS, type IssueReason, type KnownIssue, type LoadConfigOptions, type LoadedConfig, type RenderStatementOptions, type RenderedStatement, STATEMENT_LOCALES, StatementError, type StatementLocale, checkStatementEvidence, configSchema, defineConfig, findConfigFile, loadConfig, parseConfig, readAuditReport, refuses, renderStatement, summariseAuditReport, toHtmlBody, toHtmlDocument };

package/dist/index.js

@@ -1,3 +1,3 @@
-import { a as ASSESSMENT_METHODS, c as ConfigError, d as configSchema, f as defineConfig, i as loadConfig, l as ISSUE_REASONS, n as findConfigFile, o as COMPLIANCE_STATUSES, p as parseConfig, s as COUNTRIES, t as CONFIG_FILENAMES, u as STATEMENT_LOCALES } from "./load-yAR4wzez.js";
-import { a as summariseAuditReport, i as readAuditReport, n as toHtmlBody, o as StatementError, r as toHtmlDocument, t as renderStatement } from "./render-DbGOVmhx.js";
-export { ASSESSMENT_METHODS, COMPLIANCE_STATUSES, CONFIG_FILENAMES, COUNTRIES, ConfigError, ISSUE_REASONS, STATEMENT_LOCALES, StatementError, configSchema, defineConfig, findConfigFile, loadConfig, parseConfig, readAuditReport, renderStatement, summariseAuditReport, toHtmlBody, toHtmlDocument };
+import { a as ASSESSMENT_METHODS, c as ConfigError, d as configSchema, f as defineConfig, i as loadConfig, l as ISSUE_REASONS, n as findConfigFile, o as COMPLIANCE_STATUSES, p as parseConfig, s as COUNTRIES, t as CONFIG_FILENAMES, u as STATEMENT_LOCALES } from "./load-BaWMa-G_.js";
+import { a as summariseAuditReport, c as StatementError, i as readAuditReport, n as toHtmlBody, o as checkStatementEvidence, r as toHtmlDocument, s as refuses, t as renderStatement } from "./render-C1sUZZI_.js";
+export { ASSESSMENT_METHODS, COMPLIANCE_STATUSES, CONFIG_FILENAMES, COUNTRIES, ConfigError, ISSUE_REASONS, STATEMENT_LOCALES, StatementError, checkStatementEvidence, configSchema, defineConfig, findConfigFile, loadConfig, parseConfig, readAuditReport, refuses, renderStatement, summariseAuditReport, toHtmlBody, toHtmlDocument };

package/dist/{init-CW7LfGT5.js → init-DrFfzjvm.js}

@@ -1,7 +1,7 @@
-import { t as DEFAULT_FAIL_ON } from "./impact-DZt2oBCP.js";
-import { s as COUNTRIES, t as CONFIG_FILENAMES } from "./load-yAR4wzez.js";
+import { t as DEFAULT_FAIL_ON } from "./impact-luGCnN8F.js";
+import { s as COUNTRIES, t as CONFIG_FILENAMES } from "./load-BaWMa-G_.js";
 import { t as exists } from "./fs-BmPtmFke.js";
-import { l as warn, o as fail, s as note } from "./command-C3D7JWn6.js";
+import { l as warn, o as fail, s as note } from "./command-3r4fht5f.js";
 import { readFile, writeFile } from "node:fs/promises";
 import path from "node:path";
 import pc from "picocolors";

package/dist/jsdom-BUYuVJJm.js

@@ -0,0 +1,3 @@
+import "./result-B7_zVxAX.js";
+import { n as runJsdomAudit } from "./jsdom-CsW_xVcA.js";
+export { runJsdomAudit };