eaa-kit 0.2.1 → 0.3.0

package/dist/{html-BLEuzep6.js → html-DKiI_3gs.js}

@@ -1,6 +1,8 @@
-import { i as isImpactLevel, r as countAtOrAbove } from "./impact-DvgBjupx.js";
-import { n as escapeText, t as escapeAttribute } from "./escape-Dm1o_RAk.js";
+import { a as impactRank, i as impactLabel, r as countAtOrAbove } from "./impact-YdoOtFqm.js";
+import { a as standardsReference, i as escapeText, n as count, r as escapeAttribute, t as collapse } from "./text-BFmNtMsV.js";
 import { t as TOOL_VERSION } from "./version-B3v4rNoG.js";
+import { a as groupIssues, i as coverageParts, n as understandingUrl, o as isShared, r as blindRules, t as manualCheckFor } from "./manual-Vz-oX1I_.js";
+import { n as buildSummary } from "./json-Cnv9nd6U.js";
 import axe from "axe-core";
 //#region src/audit/report/html.ts
 /**
@@ -19,6 +21,14 @@ import axe from "axe-core";
 * found, which is not the same as a site being accessible, and the document
 * says so in its own footer rather than leaving the reader to infer it.
 */
+/** Severity levels, worst first, as both the scoreboard and the summary list them. */
+const IMPACT_ORDER = [
+	"critical",
+	"serious",
+	"moderate",
+	"minor",
+	"unclassified"
+];
 /** Elements listed per rule before the rest are summarised. */
 const MAX_NODES = 5;
 /** Longest element markup shown before it is truncated. */
@@ -43,6 +53,8 @@ ${STYLES}
 <main>
 <h1>Accessibility audit</h1>
 ${verdict(audits, failing, options)}
+${scoreboard(audits)}
+${issues(audits, options)}
 ${runDetails(audits, engine, generatedAt, options)}
 ${summary(audits, failing, options)}
 ${pages(audits)}
@@ -84,45 +96,27 @@ function runDetails(audits, engine, generatedAt, options) {
 	if (options.baseUrl) rows.splice(1, 0, ["Base URL", options.baseUrl]);
 	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>`;
 }
+/**
+* The counts, taken from the JSON report's own tally rather than recomputed.
+*
+* Two reports of one run disagreeing about how many violations there were is
+* the kind of bug nobody notices until a client does, so there is one place
+* that counts.
+*/
 function summary(audits, failing, options) {
-	const byImpact = /* @__PURE__ */ new Map();
-	let needsReview = 0;
-	let blind = 0;
-	let passes = 0;
-	let inapplicable = 0;
-	let elements = 0;
-	let accepted = 0;
-	for (const audit of audits) {
-		for (const finding of audit.accepted ?? []) accepted += finding.nodes.length;
-		for (const finding of audit.violations) {
-			const impact = finding.impact && isImpactLevel(finding.impact) ? finding.impact : "unclassified";
-			byImpact.set(impact, (byImpact.get(impact) ?? 0) + 1);
-			elements += finding.nodes.length;
-		}
-		for (const finding of audit.incomplete) if (finding.reason === "engine-limitation") blind += 1;
-		else needsReview += 1;
-		passes += audit.passes.length;
-		inapplicable += audit.inapplicable.length;
-	}
-	const impacts = [
-		"critical",
-		"serious",
-		"moderate",
-		"minor",
-		"unclassified"
-	].filter((impact) => (byImpact.get(impact) ?? 0) > 0).map((impact) => `  <li><span class="badge ${escapeAttribute(impact)}">${escapeText(impact)}</span> ${byImpact.get(impact)}</li>`).join("\n");
-	const withViolations = audits.filter((audit) => audit.violations.length > 0).length;
+	const totals = buildSummary(audits, options.failOn);
+	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(totalViolations(audits), "violation")}</strong> on ${withViolations} of ${count(audits.length, "page")}, across ${count(elements, "element")}</li>
+  <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>${needsReview}</strong> ${needsReview === 1 ? "rule needs" : "rules need"} manual review</li>
-  <li><strong>${blind}</strong> ${blind === 1 ? "rule was" : "rules were"} not evaluated by this engine</li>
-${accepted > 0 ? `  <li><strong>${accepted}</strong> ${accepted === 1 ? "element is" : "elements are"} accepted by the baseline, and not counted above</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>` : ""}
 </ul>
 ${impacts ? `<ul class="impacts">\n${impacts}\n</ul>` : ""}
 <p class="note">
-  <strong>${passes}</strong> rule results were checked and met, and <strong>${inapplicable}</strong>
+  <strong>${totals.passes}</strong> rule results were checked and met, and <strong>${totals.inapplicable}</strong>
   found nothing on the page to check. Those two are counted separately and never added
   together: a rule with nothing to check is not a rule that passed, and a page with no
   images proves nothing about image alternatives.
@@ -155,12 +149,12 @@ function pageSection(audit) {
 	return parts.join("\n");
 }
 function violation(finding) {
-	const impact = finding.impact && isImpactLevel(finding.impact) ? finding.impact : "unclassified";
+	const impact = impactLabel(finding.impact);
 	const shown = finding.nodes.slice(0, MAX_NODES);
 	const remaining = finding.nodes.length - shown.length;
 	const nodes = shown.map((node) => `    <li>
       <code class="selector">${escapeText(node.target.join(" "))}</code>
-      <pre><code>${escapeText(snippet(node.html))}</code></pre>
+      <pre><code>${escapeText(collapse(node.html, MAX_SNIPPET))}</code></pre>
     </li>`).join("\n");
 	const more = remaining > 0 ? `\n    <li class="more">and ${count(remaining, "more element")}</li>` : "";
 	return `  <li class="finding">
@@ -175,19 +169,8 @@ ${nodes}${more}
     </ul>
   </li>`;
 }
-/**
-* What this page's result rests on.
-*
-* The four counts stay apart for the same reason they do everywhere else: only
-* `passed` is evidence that anything was met here.
-*/
 function coverage(audit) {
-	const blind = audit.incomplete.filter((finding) => finding.reason === "engine-limitation").length;
-	const review = audit.incomplete.length - blind;
-	const parts = [`${audit.passes.length} passed`, `${audit.inapplicable.length} not applicable`];
-	if (review > 0) parts.push(`${review} to review`);
-	if (blind > 0) parts.push(`${blind} not evaluated`);
-	return `<p class="coverage">${escapeText(parts.join(" · "))}</p>`;
+	return `<p class="coverage">${escapeText(coverageParts(audit).join(" · "))}</p>`;
 }
 /**
 * Rules this engine reached no verdict on, listed once at the end.
@@ -196,24 +179,17 @@ function coverage(audit) {
 * the reader take the rest of the document for full coverage.
 */
 function notEvaluated(audits) {
-	const byRule = /* @__PURE__ */ new Map();
-	for (const audit of audits) for (const finding of audit.incomplete) {
-		if (finding.reason !== "engine-limitation") continue;
-		const existing = byRule.get(finding.ruleId);
-		if (existing) existing.pages += 1;
-		else byRule.set(finding.ruleId, {
-			pages: 1,
-			detail: finding.reasonDetail,
-			finding
-		});
-	}
-	if (byRule.size === 0) return "";
+	const blind = blindRules(audits);
+	if (blind.length === 0) return "";
 	return `<h2>Not evaluated</h2>
-<p>This engine reached no verdict on these rules. They are never reported as passing.</p>
+<p>This engine reached no verdict on these rules. They are never reported as passing.
+Each one below says what to check by hand, because automated testing finds a minority of
+accessibility barriers and this is where the rest of them are.</p>
 <ul class="not-evaluated">
-${[...byRule.entries()].sort(([a], [b]) => a.localeCompare(b)).map(([ruleId, entry]) => `  <li>
-    <code>${escapeText(ruleId)}</code> on ${count(entry.pages, "page")}${standards(entry.finding)}
-    <span class="reason">${escapeText(entry.detail)}</span>
+${blind.map(({ ruleId, pages, finding }) => `  <li>
+    <code>${escapeText(ruleId)}</code> on ${count(pages, "page")}${standards(finding)}
+    <span class="reason">${escapeText(finding.reasonDetail)}</span>
+${manualBlock(ruleId, finding)}
   </li>`).join("\n")}
 </ul>`;
 }
@@ -237,33 +213,13 @@ function standards(finding) {
 	return text ? ` — ${text}` : "";
 }
 function standardsText(finding) {
-	const parts = [...finding.successCriteria.map((criterion) => `WCAG ${criterion}`), ...finding.enClauses.map((clause) => `EN 301 549 ${clause}`)];
-	return escapeText(parts.join(", "));
-}
-/** Element markup, on one line and bounded, so one minified page cannot fill the report. */
-function snippet(html) {
-	const collapsed = html.replace(/\s+/g, " ").trim();
-	return collapsed.length > MAX_SNIPPET ? `${collapsed.slice(0, 199)}…` : collapsed;
+	return escapeText(standardsReference(finding.successCriteria, finding.enClauses));
 }
 function totalViolations(audits) {
 	return audits.reduce((total, audit) => total + audit.violations.length, 0);
 }
 function byImpactThenRule(a, b) {
-	const order = [
-		"critical",
-		"serious",
-		"moderate",
-		"minor"
-	];
-	const rank = (finding) => {
-		const index = finding.impact ? order.indexOf(finding.impact) : -1;
-		return index === -1 ? -1 : index;
-	};
-	const difference = rank(a) - rank(b);
-	return difference === 0 ? a.ruleId.localeCompare(b.ruleId) : difference;
-}
-function count(value, noun) {
-	return `${value} ${noun}${value === 1 ? "" : "s"}`;
+	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;
@@ -310,6 +266,34 @@ p.clean { color: #216e39; }
 p.note { font-size: 0.95rem; }
 hr { border: 0; border-top: 1px solid #d4d4d4; margin: 3rem 0 1.5rem; }
 footer { color: #4a4a4a; font-size: 0.9rem; }
+.scoreboard { list-style: none; display: flex; flex-wrap: wrap; gap: 0.75rem;
+  padding: 0; margin: 1.25rem 0 2rem; }
+.tile { flex: 1 1 8rem; padding: 0.75rem 1rem; border: 1px solid; border-radius: 6px; }
+.tile .figure { display: block; font-size: 1.75rem; font-weight: 700; line-height: 1.1; }
+.tile .label { font-size: 0.85rem; }
+.tile.critical { background: #fdeeee; border-color: #a01b1b; color: #7a1414; }
+.tile.serious { background: #fdf1e8; border-color: #a4531b; color: #7d3f14; }
+.tile.moderate { background: #fdf9e3; border-color: #7a6100; color: #5c4900; }
+.tile.minor { background: #eef2f8; border-color: #40556f; color: #33455a; }
+.tile.unclassified { background: #f1f1f1; border-color: #565656; color: #444444; }
+.tile.none { background: #eef7ee; border-color: #216e39; color: #17512a; }
+.tile.unchecked { background: #f4f4f5; border-color: #565656; color: #444444; }
+p.intro { color: #4a4a4a; }
+p.manual { margin: 0.35rem 0; }
+p.manual.browser, p.criteria { margin: 0.35rem 0; font-size: 0.9rem; color: #4a4a4a; }
+ol.issues { list-style: none; padding: 0; }
+li.issue { border: 1px solid #d7d7d7; border-radius: 6px; padding: 0.75rem 1rem;
+  margin: 0 0 1rem; }
+li.issue h3 { margin: 0 0 0.25rem; font-size: 1rem; display: flex; flex-wrap: wrap;
+  gap: 0.5rem; align-items: baseline; }
+li.issue .wcag { color: #4a4a4a; font-size: 0.85rem; font-weight: 400; }
+p.help { margin: 0 0 0.75rem; }
+.element { border-top: 1px solid #e6e6e6; padding-top: 0.75rem; margin-top: 0.75rem; }
+.element:first-of-type { border-top: 0; padding-top: 0; margin-top: 0; }
+p.reach, p.sources, p.selector, p.more, p.written-in { margin: 0.35rem 0; font-size: 0.9rem; color: #4a4a4a; }
+.element details { font-size: 0.9rem; color: #4a4a4a; }
+.element summary { cursor: pointer; }
+ul.page-list { margin: 0.35rem 0 0; padding-left: 1.25rem; }
 @media (prefers-color-scheme: dark) {
   body { background: #121212; color: #ededed; }
   a { color: #9ec1ff; }
@@ -322,6 +306,17 @@ footer { color: #4a4a4a; font-size: 0.9rem; }
   .verdict.pass { background: #10240f; border-color: #7ee2a8; }
   .verdict.fail { background: #2b1111; border-color: #ff9d9d; }
   .verdict.broken { background: #2b2310; border-color: #ffd28a; }
+  .tile.critical { background: #2b1111; border-color: #ff9d9d; color: #ffc9c9; }
+  .tile.serious { background: #2b1d11; border-color: #ffb98a; color: #ffd7bd; }
+  .tile.moderate { background: #2b2610; border-color: #f0d264; color: #f5e3a4; }
+  .tile.minor { background: #161c25; border-color: #9db6d6; color: #c6d6ea; }
+  .tile.unclassified { background: #1f1f1f; border-color: #9a9a9a; color: #d0d0d0; }
+  .tile.none { background: #10240f; border-color: #7ee2a8; color: #b6f0cd; }
+  .tile.unchecked { background: #1e1e1e; border-color: #9a9a9a; color: #d0d0d0; }
+  p.intro, li.issue .wcag, p.reach, p.sources, p.selector, .element details,
+  p.manual.browser, p.criteria { color: #b6b6b6; }
+  li.issue { border-color: #3a3a3a; }
+  .element { border-top-color: #2e2e2e; }
   .badge.critical { background: #2b1111; border-color: #ff9d9d; color: #ffc9c9; }
   .badge.serious { background: #2b1c11; border-color: #ffbb8a; color: #ffd9bd; }
   .badge.moderate { background: #262110; border-color: #ffe08a; color: #ffeec2; }
@@ -333,5 +328,91 @@ footer { color: #4a4a4a; font-size: 0.9rem; }
   main { max-width: none; }
   a { color: #000000; }
 }`;
+/**
+* The counts, worst first, with what was never checked beside them.
+*
+* A row of severity totals is the first thing anybody reads, and on its own it
+* is the one place this document could mislead: a client seeing "0 critical, 0
+* serious" concludes the site is fine, when the honest reading of that same run
+* may be that six whole rule categories could not be evaluated at all. So the
+* unevaluated count sits in the same row, in the same type size, rather than in
+* a section further down that nobody scrolls to.
+*/
+function scoreboard(audits) {
+	const counted = /* @__PURE__ */ new Map();
+	for (const issue of groupIssues(audits)) {
+		const key = impactLabel(issue.impact);
+		counted.set(key, (counted.get(key) ?? 0) + issue.occurrences);
+	}
+	const blind = blindRules(audits);
+	const tiles = IMPACT_ORDER.filter((level) => (counted.get(level) ?? 0) > 0).map((level) => `<li class="tile ${level}"><span class="figure">${counted.get(level)}</span> <span class="label">${level}</span></li>`);
+	if (tiles.length === 0) tiles.push("<li class=\"tile none\"><span class=\"figure\">0</span> <span class=\"label\">violations</span></li>");
+	if (blind.length > 0) tiles.push(`<li class="tile unchecked"><span class="figure">${blind.length}</span> <span class="label">not evaluated</span></li>`);
+	return `<ul class="scoreboard">\n${tiles.join("\n")}\n</ul>`;
+}
+/**
+* What is broken, once per element rather than once per page.
+*
+* The page-by-page listing further down is the same information keyed the other
+* way round. It is the right shape for working through one page and the wrong
+* shape for deciding what to do: on a site built from components one broken
+* header is one line in one file, and a per-page listing reports it as many
+* findings without ever saying they are the same defect.
+*/
+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 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>
+<ol class="issues">
+${found.map((issue) => issueSection(issue, options)).join("\n")}
+</ol>`;
+}
+function issueSection(issue, options) {
+	const impact = impactLabel(issue.impact);
+	const criteria = issue.successCriteria.length > 0 ? `<span class="wcag">WCAG ${escapeText(issue.successCriteria.join(" "))}</span>` : "";
+	return `<li class="issue">
+<h3><span class="badge ${impact}">${impact}</span> <code>${escapeText(issue.ruleId)}</code> ${criteria}</h3>
+<p class="help">${escapeText(issue.help)}</p>
+${issue.elements.slice(0, MAX_NODES).map((element) => issueElement(element, options)).join("\n")}
+${issue.elements.length > MAX_NODES ? `<p class="more">…and ${count(issue.elements.length - MAX_NODES, "more element")}</p>` : ""}
+</li>`;
+}
+function issueElement(element, options) {
+	const sources = [...new Set(element.pages.map((page) => options.sourceFor?.(page)).filter((source) => source !== void 0))];
+	const list = element.pages.map((page) => `<li>${escapeText(page)}</li>`).join("");
+	const component = options.componentFor?.(element.html);
+	return `<div class="element">
+<pre><code>${escapeText(collapse(element.html, MAX_SNIPPET))}</code></pre>
+${component === void 0 ? "" : `<p class="written-in">Written in <code>${escapeText(component)}</code></p>`}
+${element.selector === "" ? "" : `<p class="selector"><code>${escapeText(element.selector)}</code></p>`}
+<p class="reach">Found on ${count(element.pages.length, "page")}.${isShared(element) ? " <strong>Identical on each — likely one shared component.</strong>" : ""}</p>
+${sources.length > 0 ? `<p class="sources">Source: ${sources.map((source) => `<code>${escapeText(source)}</code>`).join(", ")}</p>` : ""}
+<details><summary>${count(element.pages.length, "page")}</summary><ul class="page-list">${list}</ul></details>
+</div>`;
+}
+/**
+* The manual check for a rule, and where to read what the criterion requires.
+*
+* Unconditional here, unlike the console report, which hides it behind a flag.
+* This document is read once by somebody deciding what to do, not printed on
+* every run by somebody who has read it before.
+*/
+function manualBlock(ruleId, finding) {
+	const manual = manualCheckFor(ruleId);
+	const links = finding.successCriteria.map((criterion) => {
+		const url = understandingUrl(criterion);
+		return url === void 0 ? void 0 : `<a href="${escapeAttribute(url)}">WCAG ${escapeText(criterion)}</a>`;
+	}).filter((link) => link !== void 0);
+	if (manual === void 0 && links.length === 0) return "";
+	return [
+		manual === void 0 ? "" : `    <p class="manual">${escapeText(manual.check)}</p>`,
+		manual?.browserAnswers === true ? "    <p class=\"manual browser\">Or run the audit again with <code>--browser</code>.</p>" : "",
+		links.length === 0 ? "" : `    <p class="criteria">${links.join(" · ")}</p>`
+	].filter((line) => line !== "").join("\n");
+}
 //#endregion
 export { buildHtmlReport };

package/dist/{impact-DvgBjupx.js → impact-YdoOtFqm.js}

@@ -22,6 +22,20 @@ function meetsThreshold(impact, threshold) {
 	if (impact === null || !isImpactLevel(impact)) return true;
 	return IMPACT_LEVELS.indexOf(impact) >= IMPACT_LEVELS.indexOf(threshold);
 }
+/**
+* Where an impact sorts, most severe first.
+*
+* An unclassified impact ranks with the most severe, on the same reasoning as
+* `--fail-on`: not knowing how bad a barrier is is not evidence that it is mild.
+*/
+function impactRank(impact) {
+	if (impact === null || !isImpactLevel(impact)) return 0;
+	return IMPACT_LEVELS.length - IMPACT_LEVELS.indexOf(impact);
+}
+/** The impact as a word, naming the gap rather than hiding it. */
+function impactLabel(impact) {
+	return impact !== null && isImpactLevel(impact) ? impact : "unclassified";
+}
 /** Violations at or above `threshold`, counted per rule per page. */
 function countAtOrAbove(audits, threshold) {
 	let total = 0;
@@ -29,4 +43,4 @@ function countAtOrAbove(audits, threshold) {
 	return total;
 }
 //#endregion
-export { isImpactLevel as i, IMPACT_LEVELS as n, countAtOrAbove as r, DEFAULT_FAIL_ON as t };
+export { impactRank as a, impactLabel as i, IMPACT_LEVELS as n, isImpactLevel as o, countAtOrAbove as r, DEFAULT_FAIL_ON as t };

package/dist/index.js

@@ -1,3 +1,3 @@
-import { a as COMPLIANCE_STATUSES, c as ISSUE_REASONS, d as defineConfig, f as parseConfig, i as ASSESSMENT_METHODS, l as STATEMENT_LOCALES, n as findConfigFile, o as COUNTRIES, r as loadConfig, s as ConfigError, t as CONFIG_FILENAMES, u as configSchema } from "./load-sCkKsvGQ.js";
-import { a as summariseAuditReport, i as readAuditReport, n as toHtmlBody, o as StatementError, r as toHtmlDocument, t as renderStatement } from "./render-BO0nVrrZ.js";
+import { a as COMPLIANCE_STATUSES, c as ISSUE_REASONS, d as defineConfig, f as parseConfig, i as ASSESSMENT_METHODS, l as STATEMENT_LOCALES, n as findConfigFile, o as COUNTRIES, r as loadConfig, s as ConfigError, t as CONFIG_FILENAMES, u as configSchema } from "./load-UYXLqGV9.js";
+import { a as summariseAuditReport, i as readAuditReport, n as toHtmlBody, o as StatementError, r as toHtmlDocument, t as renderStatement } from "./render-DI_aCnAZ.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 };

package/dist/{init-DRKIdpK1.js → init-DiLiYvN1.js}

@@ -1,5 +1,7 @@
-import { o as COUNTRIES, t as CONFIG_FILENAMES } from "./load-sCkKsvGQ.js";
-import { readFile, stat, writeFile } from "node:fs/promises";
+import { o as COUNTRIES, t as CONFIG_FILENAMES } from "./load-UYXLqGV9.js";
+import { t as exists } from "./fs-BmPtmFke.js";
+import { i as note, o as warn, r as fail } from "./command-Dxpa00Ha.js";
+import { readFile, writeFile } from "node:fs/promises";
 import path from "node:path";
 import pc from "picocolors";
 import { createInterface } from "node:readline/promises";
@@ -26,10 +28,7 @@ async function detectDefaults(cwd) {
 }
 /** Whether a config is already there, so init never overwrites one silently. */
 async function existingConfig(cwd) {
-	for (const name of CONFIG_FILENAMES) try {
-		await stat(path.join(cwd, name));
-		return name;
-	} catch {}
+	for (const name of CONFIG_FILENAMES) if (await exists(path.join(cwd, name))) return name;
 }
 /** Reads answers, showing what each will be if the reader just hits enter. */
 function terminalPrompt() {
@@ -51,7 +50,7 @@ async function runInitCommand(options = {}) {
 	const target = path.resolve(cwd, options.output ?? "eaa.config.json");
 	const already = await existingConfig(cwd);
 	if (already !== void 0 && !options.force) {
-		process.stderr.write(`${pc.yellow("warning")} ${already} already exists. Pass --force to overwrite it.\n`);
+		warn(`${already} already exists. Pass --force to overwrite it.`);
 		return { exitCode: 1 };
 	}
 	const detected = await detectDefaults(cwd);
@@ -89,13 +88,17 @@ async function runInitCommand(options = {}) {
 	try {
 		await writeFile(target, `${JSON.stringify(config, null, 2)}\n`, "utf8");
 	} catch (cause) {
-		process.stderr.write(`${pc.red("error")} Could not write ${path.basename(target)}: ${cause instanceof Error ? cause.message : String(cause)}\n`);
+		const reason = cause instanceof Error ? cause.message : String(cause);
+		fail(`Could not write ${path.basename(target)}: ${reason}`);
 		return { exitCode: 2 };
 	}
 	process.stderr.write(`Wrote ${path.relative(cwd, target) || path.basename(target)}\n`);
 	const missing = [name === "" ? "site.name" : void 0, email === "" ? "provider.email" : void 0].filter((field) => field !== void 0);
-	if (missing.length > 0) process.stderr.write(`${pc.yellow("warning")} ${missing.join(" and ")} ${missing.length === 1 ? "is" : "are"} empty and required. Fill ${missing.length === 1 ? "it" : "them"} in before generating a statement.\n`);
-	process.stderr.write(pc.dim("Read it before publishing anything from it: status is partially-compliant,\nwhich is the honest default before an audit has run.\n\nNext:  eaa-kit audit  ·  eaa-kit statement\n"));
+	if (missing.length > 0) {
+		const [verb, pronoun] = missing.length === 1 ? ["is", "it"] : ["are", "them"];
+		warn(`${missing.join(" and ")} ${verb} empty and required. Fill ${pronoun} in before generating a statement.`);
+	}
+	note("Read it before publishing anything from it: status is partially-compliant,\nwhich is the honest default before an audit has run.\n\nNext:  eaa-kit audit  ·  eaa-kit statement");
 	return {
 		file: target,
 		exitCode: 0

package/dist/{jsdom-BEu6Ra_2.js → jsdom-BjpF-2V-.js}

@@ -1,7 +1,6 @@
-import { i as shapeResults, n as failedPage, r as runOptions, t as DEFAULT_TAGS } from "./result-2aZPfM8w.js";
-import { pathToFileURL } from "node:url";
-import { Script } from "node:vm";
+import { i as pageUrl, n as failedPage, o as runOptions, s as shapeResults, t as DEFAULT_TAGS } from "./result-DLxd2Eip.js";
 import axe from "axe-core";
+import { Script } from "node:vm";
 import { JSDOM, VirtualConsole } from "jsdom";
 //#region src/audit/runners/jsdom.ts
 /**
@@ -144,10 +143,6 @@ function blindRulesInScope(tags) {
 	blindScopeCache.set(key, inScope);
 	return inScope;
 }
-function pageUrl(page, baseUrl) {
-	if (!baseUrl) return pathToFileURL(page.absolutePath).href;
-	return new URL(page.relativePath, baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`).href;
-}
 async function withTimeout(promise, ms) {
 	promise.catch(() => {});
 	let timer;

package/dist/jsdom-X4KYfTp8.js

@@ -0,0 +1,3 @@
+import "./result-DLxd2Eip.js";
+import { i as runJsdomAudit } from "./jsdom-BjpF-2V-.js";
+export { runJsdomAudit };

package/dist/json-B0Y7rNjt.js

@@ -0,0 +1,2 @@
+import { r as serialiseJsonReport, t as buildJsonReport } from "./json-Cnv9nd6U.js";
+export { buildJsonReport, serialiseJsonReport };

package/dist/{json-C9xS1PNC.js → json-Cnv9nd6U.js}

@@ -1,5 +1,6 @@
-import { i as isImpactLevel, r as countAtOrAbove } from "./impact-DvgBjupx.js";
+import { i as impactLabel, o as isImpactLevel, r as countAtOrAbove } from "./impact-YdoOtFqm.js";
 import { t as TOOL_VERSION } from "./version-B3v4rNoG.js";
+import { a as ruleOutcomes } from "./result-DLxd2Eip.js";
 import axe from "axe-core";
 /**
 * Build the machine-readable report.
@@ -36,23 +37,14 @@ function buildJsonReport(audits, options) {
 /** Every rule mentioned by any page, keyed by id and sorted for stable diffs. */
 function buildRuleIndex(audits) {
 	const index = /* @__PURE__ */ new Map();
-	for (const audit of audits) {
-		const outcomes = [
-			...audit.violations,
-			...audit.accepted ?? [],
-			...audit.incomplete,
-			...audit.passes,
-			...audit.inapplicable
-		];
-		for (const outcome of outcomes) {
-			if (index.has(outcome.ruleId)) continue;
-			index.set(outcome.ruleId, {
-				help: outcome.help,
-				helpUrl: outcome.helpUrl,
-				successCriteria: outcome.successCriteria,
-				en301549: outcome.enClauses
-			});
-		}
+	for (const audit of audits) for (const outcome of ruleOutcomes(audit)) {
+		if (index.has(outcome.ruleId)) continue;
+		index.set(outcome.ruleId, {
+			help: outcome.help,
+			helpUrl: outcome.helpUrl,
+			successCriteria: outcome.successCriteria,
+			en301549: outcome.enClauses
+		});
 	}
 	return Object.fromEntries([...index].sort(([a], [b]) => a.localeCompare(b)));
 }
@@ -60,6 +52,7 @@ function buildRuleIndex(audits) {
 function serialiseJsonReport(report) {
 	return `${JSON.stringify(report, null, 2)}\n`;
 }
+/** The run's tally, exported so the HTML report reads the same numbers. */
 function buildSummary(audits, failOn) {
 	const byImpact = {
 		critical: 0,
@@ -80,8 +73,7 @@ function buildSummary(audits, failOn) {
 		for (const finding of audit.violations) {
 			violations += 1;
 			violatingElements += finding.nodes.length;
-			const impact = finding.impact;
-			byImpact[impact && isImpactLevel(impact) ? impact : "unclassified"] += 1;
+			byImpact[impactLabel(finding.impact)] += 1;
 		}
 		for (const finding of audit.incomplete) if (finding.reason === "engine-limitation") notEvaluated += 1;
 		else needsReview += 1;
@@ -138,4 +130,4 @@ function byRuleId(a, b) {
 	return a.ruleId.localeCompare(b.ruleId);
 }
 //#endregion
-export { buildJsonReport, serialiseJsonReport };
+export { buildSummary as n, serialiseJsonReport as r, buildJsonReport as t };

package/dist/{load-sCkKsvGQ.js → load-UYXLqGV9.js}

@@ -1,5 +1,6 @@
 import { _ as withDefault, c as object, f as safeParse, g as url, h as union, i as isoDate, l as optional, m as transform, n as email, p as string, r as enumeration, t as array, u as pipe } from "./schema-CMZ8ItGk.js";
-import { readFile, stat } from "node:fs/promises";
+import { r as isFile } from "./fs-BmPtmFke.js";
+import { readFile } from "node:fs/promises";
 import path from "node:path";
 import { pathToFileURL } from "node:url";
 //#region src/config/define.ts
@@ -181,12 +182,5 @@ async function importModule(file) {
 	if (module.default === void 0) throw new ConfigError(`${path.basename(file)} has no default export`, ["Expected: export default defineConfig({ … })"]);
 	return module.default;
 }
-async function isFile(candidate) {
-	try {
-		return (await stat(candidate)).isFile();
-	} catch {
-		return false;
-	}
-}
 //#endregion
 export { COMPLIANCE_STATUSES as a, ISSUE_REASONS as c, defineConfig as d, parseConfig as f, ASSESSMENT_METHODS as i, STATEMENT_LOCALES as l, findConfigFile as n, COUNTRIES as o, loadConfig as r, ConfigError as s, CONFIG_FILENAMES as t, configSchema as u };