eaa-kit 0.3.0 → 0.5.0

package/dist/jsdom-BjpF-2V-.js

@@ -1,158 +0,0 @@
-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
-/**
-* Rules this engine structurally cannot decide.
-*
-* jsdom has no layout: every element reports a 0x0 box, computed style is
-* limited to the inline cascade, and nothing is ever fetched. axe-core does not
-* know that, so it happily returns `pass` for some of these — `target-size`
-* passes on any page because a 0x0 target gets measured against nothing, and
-* `color-contrast` passes on pages whose colours were never computed. Both were
-* observed on real sites. Reporting either as a pass would be a false clean
-* bill of health, so every rule listed here is force-reported as incomplete no
-* matter which bucket axe-core put it in.
-*
-* The browser runner passes an empty map instead: with real layout these rules
-* are exactly the ones it exists to answer.
-*
-* Rules tagged `experimental` are listed for completeness but filtered out at
-* scope time: axe-core does not run them by default, so a browser run would not
-* evaluate them either and telling the user to re-run with --browser would be
-* misleading.
-*/
-const ENGINE_BLIND_RULES = {
-	"color-contrast": {
-		detail: "needs rendered foreground and background colours",
-		applicabilityUnreliable: false
-	},
-	"color-contrast-enhanced": {
-		detail: "needs rendered foreground and background colours",
-		applicabilityUnreliable: false
-	},
-	"target-size": {
-		detail: "needs element geometry; every box is 0x0 without layout",
-		applicabilityUnreliable: false
-	},
-	"scrollable-region-focusable": {
-		detail: "needs computed overflow",
-		applicabilityUnreliable: true
-	},
-	"link-in-text-block": {
-		detail: "needs rendered colours and text decoration",
-		applicabilityUnreliable: true
-	},
-	"no-autoplay-audio": {
-		detail: "needs media duration, and media is never loaded",
-		applicabilityUnreliable: true
-	},
-	"avoid-inline-spacing": {
-		detail: "needs computed spacing after the full cascade",
-		applicabilityUnreliable: false
-	},
-	"p-as-heading": {
-		detail: "needs computed font size and weight",
-		applicabilityUnreliable: false
-	},
-	"css-orientation-lock": {
-		detail: "needs CSS media query evaluation",
-		applicabilityUnreliable: true
-	}
-};
-/** Per-page ceiling; one pathological document must not stall a CI run. */
-const DEFAULT_TIMEOUT_MS = 3e4;
-/**
-* Audit collected pages with axe-core inside jsdom.
-*
-* Pages are processed sequentially: jsdom parsing and axe-core are both
-* CPU-bound on the main thread, so concurrency buys nothing here. A page that
-* throws or times out is recorded with an `error` and the run continues.
-*/
-async function runJsdomAudit(pages, options = {}) {
-	const audits = [];
-	for (const page of pages) audits.push(await auditPage(page, options));
-	return audits;
-}
-async function auditPage(page, options = {}) {
-	const tags = options.tags ?? DEFAULT_TAGS;
-	const url = pageUrl(page, options.baseUrl);
-	const startedAt = Date.now();
-	const identity = {
-		relativePath: page.relativePath,
-		absolutePath: page.absolutePath,
-		url,
-		engine: "jsdom"
-	};
-	let dom;
-	try {
-		dom = createDom(page.html, url);
-		injectAxe(dom);
-		const { axe: pageAxe } = dom.window;
-		const results = await withTimeout(pageAxe.run(dom.window.document, runOptions(tags)), options.timeoutMs ?? DEFAULT_TIMEOUT_MS);
-		return shapeResults(results, {
-			...identity,
-			durationMs: Date.now() - startedAt,
-			blind: blindRulesInScope(tags)
-		});
-	} catch (cause) {
-		return failedPage({
-			...identity,
-			durationMs: Date.now() - startedAt
-		}, cause instanceof Error ? cause.message : String(cause));
-	} finally {
-		dom?.window.close();
-	}
-}
-function createDom(html, url) {
-	const virtualConsole = new VirtualConsole();
-	virtualConsole.on("jsdomError", () => {});
-	return new JSDOM(html, {
-		url,
-		virtualConsole,
-		runScripts: "outside-only",
-		pretendToBeVisual: true
-	});
-}
-/**
-* axe-core is 1.3 MB of source. Compiling it once and re-running the compiled
-* script in each window's context avoids re-parsing it for every page.
-*/
-let axeScript;
-function injectAxe(dom) {
-	axeScript ??= new Script(axe.source, { filename: "axe-core.js" });
-	axeScript.runInContext(dom.getInternalVMContext());
-}
-const blindScopeCache = /* @__PURE__ */ new Map();
-/**
-* Blind rules the requested tag filter would actually have run. Experimental
-* rules are excluded: axe-core leaves them off by default, so a browser run
-* would not have evaluated them either.
-*/
-function blindRulesInScope(tags) {
-	const key = [...tags].sort().join(",");
-	const cached = blindScopeCache.get(key);
-	if (cached) return cached;
-	const inScope = /* @__PURE__ */ new Map();
-	for (const rule of axe.getRules([...tags])) {
-		if (rule.tags.includes("experimental")) continue;
-		const blind = ENGINE_BLIND_RULES[rule.ruleId];
-		if (blind) inScope.set(rule.ruleId, blind);
-	}
-	blindScopeCache.set(key, inScope);
-	return inScope;
-}
-async function withTimeout(promise, ms) {
-	promise.catch(() => {});
-	let timer;
-	try {
-		return await Promise.race([promise, new Promise((_resolve, reject) => {
-			timer = setTimeout(() => reject(/* @__PURE__ */ new Error(`axe-core timed out after ${ms}ms`)), ms);
-		})]);
-	} finally {
-		clearTimeout(timer);
-	}
-}
-//#endregion
-export { runJsdomAudit as i, auditPage as n, blindRulesInScope as r, ENGINE_BLIND_RULES as t };

package/dist/jsdom-X4KYfTp8.js

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

package/dist/manual-Vz-oX1I_.js

@@ -1,239 +0,0 @@
-import { a as impactRank } from "./impact-YdoOtFqm.js";
-import { t as elementFingerprint } from "./fingerprint-DRoneAjj.js";
-import { r as findingElements } from "./result-DLxd2Eip.js";
-/** Whether this element looks like one component rendered on many pages. */
-function isShared(element) {
-	return element.pages.length >= 3;
-}
-/**
-* Fold a run's violations into one entry per rule, and one per element within it.
-*
-* Accepted violations are not included: a baseline moves them out of what fails
-* the build, and this is a view of what fails.
-*/
-function groupIssues(audits) {
-	const byRule = /* @__PURE__ */ new Map();
-	for (const audit of audits) for (const finding of audit.violations) {
-		let issue = byRule.get(finding.ruleId);
-		if (issue === void 0) {
-			issue = {
-				ruleId: finding.ruleId,
-				help: finding.help,
-				impact: finding.impact ?? null,
-				successCriteria: finding.successCriteria,
-				enClauses: finding.enClauses,
-				helpUrl: finding.helpUrl,
-				elements: [],
-				pages: [],
-				occurrences: 0
-			};
-			byRule.set(finding.ruleId, issue);
-		}
-		if (!issue.pages.includes(audit.relativePath)) issue.pages.push(audit.relativePath);
-		for (const node of findingElements(finding)) {
-			issue.occurrences += 1;
-			const fingerprint = elementFingerprint(finding.ruleId, node.selector, node.html);
-			const existing = issue.elements.find((element) => element.fingerprint === fingerprint);
-			if (existing) {
-				if (!existing.pages.includes(audit.relativePath)) existing.pages.push(audit.relativePath);
-				continue;
-			}
-			issue.elements.push({
-				fingerprint,
-				selector: node.selector,
-				html: node.html,
-				pages: [audit.relativePath]
-			});
-		}
-	}
-	const issues = [...byRule.values()];
-	for (const issue of issues) {
-		issue.pages.sort();
-		for (const element of issue.elements) element.pages.sort();
-		issue.elements.sort(byReachThenSelector);
-	}
-	issues.sort(bySeverityThenReach);
-	return issues;
-}
-/**
-* Unevaluated rules folded across the site, sorted by rule id.
-*
-* Both reports list these once at the end rather than under every page: on a
-* large site the same handful recurs on each one, and a wall of "not evaluated"
-* would bury the findings that are real.
-*/
-function blindRules(audits) {
-	const byRule = /* @__PURE__ */ new Map();
-	for (const audit of audits) for (const finding of audit.incomplete) {
-		if (finding.reason !== "engine-limitation") continue;
-		const entry = byRule.get(finding.ruleId);
-		if (entry) entry.pages += 1;
-		else byRule.set(finding.ruleId, {
-			ruleId: finding.ruleId,
-			pages: 1,
-			finding
-		});
-	}
-	return [...byRule.values()].sort((a, b) => a.ruleId.localeCompare(b.ruleId));
-}
-/**
-* What one page's result actually rests on, as phrases both reports print.
-*
-* The counts stay separate on purpose. Only `passed` is evidence that a
-* criterion was met here; `not applicable` means the rule found nothing to
-* check, and adding the two together would turn an empty page into a
-* near-perfect score.
-*/
-function coverageParts(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 parts;
-}
-/** Widest reach first, then by selector so two runs agree. */
-function byReachThenSelector(a, b) {
-	return b.pages.length - a.pages.length || a.selector.localeCompare(b.selector);
-}
-/** Worst first, then widest reach, then by rule id. */
-function bySeverityThenReach(a, b) {
-	return impactRank(a.impact) - impactRank(b.impact) || b.pages.length - a.pages.length || a.ruleId.localeCompare(b.ruleId);
-}
-//#endregion
-//#region src/audit/manual.ts
-/**
-* What a person has to check, and where to read about it.
-*
-* Automated testing finds a minority of accessibility barriers. This tool says
-* so everywhere, and saying so is not much use on its own: a reader told that
-* six rules "could not be evaluated" is left knowing there is a gap and not
-* what to do about it.
-*
-* So each rule the browserless engine cannot decide carries the check somebody
-* would do by hand, and each success criterion carries a link to what it
-* actually requires. The point is to turn the honest disclaimer into the part
-* of the report with the most work in it.
-*/
-/**
-* WCAG 2.2 Understanding pages, by success criterion.
-*
-* The Understanding document rather than the criterion text: the text says what
-* conformance is, and the Understanding page says what it is for and how to
-* meet it, which is what somebody reading a report needs.
-*
-* Level A and AA only, since that is what this tool audits against.
-*/
-const UNDERSTANDING = {
-	"1.1.1": "non-text-content",
-	"1.2.1": "audio-only-and-video-only-prerecorded",
-	"1.2.2": "captions-prerecorded",
-	"1.2.3": "audio-description-or-media-alternative-prerecorded",
-	"1.2.4": "captions-live",
-	"1.2.5": "audio-description-prerecorded",
-	"1.3.1": "info-and-relationships",
-	"1.3.2": "meaningful-sequence",
-	"1.3.3": "sensory-characteristics",
-	"1.3.4": "orientation",
-	"1.3.5": "identify-input-purpose",
-	"1.4.1": "use-of-color",
-	"1.4.2": "audio-control",
-	"1.4.3": "contrast-minimum",
-	"1.4.4": "resize-text",
-	"1.4.5": "images-of-text",
-	"1.4.10": "reflow",
-	"1.4.11": "non-text-contrast",
-	"1.4.12": "text-spacing",
-	"1.4.13": "content-on-hover-or-focus",
-	"2.1.1": "keyboard",
-	"2.1.2": "no-keyboard-trap",
-	"2.1.4": "character-key-shortcuts",
-	"2.2.1": "timing-adjustable",
-	"2.2.2": "pause-stop-hide",
-	"2.3.1": "three-flashes-or-below-threshold",
-	"2.4.1": "bypass-blocks",
-	"2.4.2": "page-titled",
-	"2.4.3": "focus-order",
-	"2.4.4": "link-purpose-in-context",
-	"2.4.5": "multiple-ways",
-	"2.4.6": "headings-and-labels",
-	"2.4.7": "focus-visible",
-	"2.4.11": "focus-not-obscured-minimum",
-	"2.5.1": "pointer-gestures",
-	"2.5.2": "pointer-cancellation",
-	"2.5.3": "label-in-name",
-	"2.5.4": "motion-actuation",
-	"2.5.7": "dragging-movements",
-	"2.5.8": "target-size-minimum",
-	"3.1.1": "language-of-page",
-	"3.1.2": "language-of-parts",
-	"3.2.1": "on-focus",
-	"3.2.2": "on-input",
-	"3.2.3": "consistent-navigation",
-	"3.2.4": "consistent-identification",
-	"3.2.6": "consistent-help",
-	"3.3.1": "error-identification",
-	"3.3.2": "labels-or-instructions",
-	"3.3.3": "error-suggestion",
-	"3.3.4": "error-prevention-legal-financial-data",
-	"3.3.7": "redundant-entry",
-	"3.3.8": "accessible-authentication-minimum",
-	"4.1.2": "name-role-value",
-	"4.1.3": "status-messages"
-};
-/** Where to read what a success criterion requires, or undefined if unknown. */
-function understandingUrl(criterion) {
-	const slug = UNDERSTANDING[criterion];
-	return slug === void 0 ? void 0 : `https://www.w3.org/WAI/WCAG22/Understanding/${slug}.html`;
-}
-/**
-* The check a person does for a rule this engine could not decide.
-*
-* Written as an action rather than a restatement of the criterion. "Ensure
-* sufficient contrast" tells somebody nothing they did not already know; the
-* useful sentence names what to open and what to look at.
-*/
-const MANUAL_CHECKS = {
-	"color-contrast": {
-		check: "Open the page and check text against its background with a contrast checker. Body text needs 4.5:1, and large or bold text 3:1. Check the states too — hover, focus, visited, disabled and placeholder text are the ones usually missed.",
-		browserAnswers: true
-	},
-	"color-contrast-enhanced": {
-		check: "Only needed if you are claiming AAA. Body text needs 7:1 and large text 4.5:1.",
-		browserAnswers: true
-	},
-	"target-size": {
-		check: "Measure the clickable area of buttons, icon links and form controls: 24×24 CSS pixels at minimum, unless they are inline in a sentence or have that much clear space around them. Icon-only controls in a header or a media player are where this usually fails.",
-		browserAnswers: true
-	},
-	"scrollable-region-focusable": {
-		check: "Find anything that scrolls inside the page — a code block, a wide table, a long list — and try reaching it with the Tab key alone. If it cannot take focus, a keyboard user cannot scroll it.",
-		browserAnswers: true
-	},
-	"link-in-text-block": {
-		check: "Look at links inside paragraphs. If the only thing distinguishing them from the surrounding text is colour, they need an underline or a 3:1 contrast difference against that text as well.",
-		browserAnswers: true
-	},
-	"no-autoplay-audio": {
-		check: "Load the page and listen. Anything that plays for more than three seconds on its own needs a pause or stop control, or a volume control independent of the system volume.",
-		browserAnswers: false
-	},
-	"avoid-inline-spacing": {
-		check: "Override line height to 1.5×, paragraph spacing to 2×, letter spacing to 0.12× and word spacing to 0.16× the font size, then check nothing is clipped or overlapping. Inline styles that set spacing with !important are what break this.",
-		browserAnswers: true
-	},
-	"p-as-heading": {
-		check: "Look for paragraphs styled to look like headings. A screen reader reads them as body text, so they are invisible to anyone navigating by heading.",
-		browserAnswers: false
-	},
-	"css-orientation-lock": {
-		check: "Rotate a phone or tablet. The content should work in both orientations unless one is essential, which is rare outside games and instruments.",
-		browserAnswers: false
-	}
-};
-/** The check for a rule, if there is one written for it. */
-function manualCheckFor(ruleId) {
-	return MANUAL_CHECKS[ruleId];
-}
-//#endregion
-export { groupIssues as a, coverageParts as i, understandingUrl as n, isShared as o, blindRules as r, manualCheckFor as t };

package/dist/routes-C2Cgf6Ko.js

@@ -1,119 +0,0 @@
-import { i as toPosix, n as isDirectory } from "./fs-BmPtmFke.js";
-import path from "node:path";
-import { glob } from "tinyglobby";
-//#region src/audit/routes.ts
-/** Route file conventions, most specific first. */
-const CONVENTIONS = [
-	{
-		framework: "next-app",
-		dir: "app",
-		pattern: "**/page.{tsx,ts,jsx,js,mdx}"
-	},
-	{
-		framework: "next-app",
-		dir: "src/app",
-		pattern: "**/page.{tsx,ts,jsx,js,mdx}"
-	},
-	{
-		framework: "next-pages",
-		dir: "pages",
-		pattern: "**/*.{tsx,ts,jsx,js,mdx}"
-	},
-	{
-		framework: "next-pages",
-		dir: "src/pages",
-		pattern: "**/*.{tsx,ts,jsx,js,mdx}"
-	},
-	{
-		framework: "astro",
-		dir: "src/pages",
-		pattern: "**/*.{astro,md,mdx}"
-	},
-	{
-		framework: "nuxt",
-		dir: "pages",
-		pattern: "**/*.vue"
-	},
-	{
-		framework: "sveltekit",
-		dir: "src/routes",
-		pattern: "**/+page.{svelte,ts,js}"
-	}
-];
-/**
-* The URL path a route file serves.
-*
-* Returns undefined for anything that is not a page: a Next.js route group
-* `(marketing)` contributes no segment, a private folder `_lib` contributes no
-* route at all, and a dynamic segment `[slug]` cannot be resolved to one path
-* without knowing the data behind it.
-*/
-function routePathFor(relativeFile, framework) {
-	let route = toPosix(relativeFile);
-	if (framework === "next-app" || framework === "sveltekit") route = route.includes("/") ? route.replace(/\/[^/]+$/, "") : "";
-	else {
-		route = route.replace(/\.[^./]+$/, "");
-		route = route.replace(/\/index$/, "");
-		if (route === "index") route = "";
-	}
-	const segments = route.split("/").filter((segment) => segment !== "");
-	const kept = [];
-	for (const segment of segments) {
-		if (/^[[(]|^_|^@/.test(segment)) {
-			if (/^\(.*\)$/.test(segment)) continue;
-			return;
-		}
-		kept.push(segment);
-	}
-	return kept.join("/");
-}
-/** Every page path a build could have emitted for one route. */
-function emittedPathsFor(route) {
-	if (route === "") return [
-		"/",
-		"index.html",
-		"index.htm"
-	];
-	return [
-		route,
-		`${route}/`,
-		`${route}.html`,
-		`${route}/index.html`
-	];
-}
-/**
-* Build a page-to-source map by reading the project's route files.
-*
-* Returns undefined when the project uses no convention this understands, which
-* is not a failure — most builds are not framework projects.
-*/
-async function buildRouteMap(cwd) {
-	for (const convention of CONVENTIONS) {
-		const directory = path.join(cwd, convention.dir);
-		if (!await isDirectory(directory)) continue;
-		const files = await glob([convention.pattern], {
-			cwd: directory,
-			ignore: ["**/node_modules/**"],
-			onlyFiles: true
-		});
-		if (files.length === 0) continue;
-		const sources = /* @__PURE__ */ new Map();
-		for (const file of files) {
-			const route = routePathFor(file, convention.framework);
-			if (route === void 0) continue;
-			const source = `${convention.dir}/${toPosix(file)}`;
-			for (const emitted of emittedPathsFor(route)) if (!sources.has(emitted)) sources.set(emitted, source);
-		}
-		if (sources.size > 0) return {
-			framework: convention.framework,
-			sources
-		};
-	}
-}
-/** The source file for an audited page, if the map knows one. */
-function sourceFor(map, pagePath) {
-	if (map === void 0) return void 0;
-	return map.sources.get(pagePath) ?? map.sources.get(pagePath.replace(/^\//, ""));
-}
-//#endregion
-export { buildRouteMap, sourceFor };