eaa-kit 0.2.0 → 0.3.0

package/dist/{baseline-CgBmzFTr.js → baseline-s9F3fXTN.js}

@@ -1,5 +1,6 @@
 import { _ as withDefault, c as object, f as safeParse, i as isoDate$1, l as optional, o as nullable, p as string, s as number, t as array } from "./schema-CMZ8ItGk.js";
 import { t as elementFingerprint } from "./fingerprint-DRoneAjj.js";
+import { r as findingElements } from "./result-DLxd2Eip.js";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import path from "node:path";
 /** Default filename, used by the CLI when no path is given. */
@@ -37,12 +38,10 @@ var BaselineError = class extends Error {
 */
 function applyBaseline(audits, baseline, options = {}) {
 	const today = isoDate(options.today ?? /* @__PURE__ */ new Date());
-	const expired = baseline.entries.filter((entry) => entry.expiresOn !== void 0 && entry.expiresOn < today);
+	const expired = [];
 	const live = /* @__PURE__ */ new Map();
-	for (const entry of baseline.entries) {
-		if (entry.expiresOn !== void 0 && entry.expiresOn < today) continue;
-		live.set(key(entry.page, entry.ruleId, entry.fingerprint), entry);
-	}
+	for (const entry of baseline.entries) if (entry.expiresOn !== void 0 && entry.expiresOn < today) expired.push(entry);
+	else live.set(key(entry.page, entry.ruleId, entry.fingerprint), entry);
 	const matched = /* @__PURE__ */ new Set();
 	let accepted = 0;
 	const next = audits.map((audit) => {
@@ -90,7 +89,7 @@ function applyBaseline(audits, baseline, options = {}) {
 	return {
 		audits: next,
 		stale: [...live.entries()].filter(([id, entry]) => !matched.has(id) && audited.has(entry.page)).map(([, entry]) => entry).sort(byEntry),
-		expired: [...expired].sort(byEntry),
+		expired: expired.sort(byEntry),
 		accepted
 	};
 }
@@ -98,26 +97,17 @@ function applyBaseline(audits, baseline, options = {}) {
 function buildBaseline(audits, options = {}) {
 	const acceptedOn = isoDate(options.today ?? /* @__PURE__ */ new Date());
 	const entries = [];
-	for (const audit of audits) for (const finding of audit.violations) {
-		const nodes = finding.nodes.length > 0 ? finding.nodes.map((node) => ({
-			selector: node.target.join(" "),
-			html: node.html
-		})) : [{
-			selector: "",
-			html: ""
-		}];
-		for (const node of nodes) entries.push({
-			page: audit.relativePath,
-			ruleId: finding.ruleId,
-			fingerprint: elementFingerprint(finding.ruleId, node.selector, node.html),
-			selector: node.selector,
-			help: finding.help,
-			impact: finding.impact ?? null,
-			acceptedOn,
-			...options.expiresOn ? { expiresOn: options.expiresOn } : {},
-			...options.note ? { note: options.note } : {}
-		});
-	}
+	for (const audit of audits) for (const finding of audit.violations) for (const node of findingElements(finding)) entries.push({
+		page: audit.relativePath,
+		ruleId: finding.ruleId,
+		fingerprint: elementFingerprint(finding.ruleId, node.selector, node.html),
+		selector: node.selector,
+		help: finding.help,
+		impact: finding.impact ?? null,
+		acceptedOn,
+		...options.expiresOn ? { expiresOn: options.expiresOn } : {},
+		...options.note ? { note: options.note } : {}
+	});
 	return {
 		schemaVersion: 1,
 		createdOn: acceptedOn,

package/dist/cli/index.js

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
-import { l as STATEMENT_LOCALES, o as COUNTRIES, r as loadConfig, s as ConfigError } from "../load-sCkKsvGQ.js";
-import { i as readAuditReport, o as StatementError, t as renderStatement } from "../render-BO0nVrrZ.js";
-import { i as isImpactLevel, n as IMPACT_LEVELS, t as DEFAULT_FAIL_ON } from "../impact-DvgBjupx.js";
+import { l as STATEMENT_LOCALES, o as COUNTRIES, r as loadConfig, s as ConfigError } from "../load-UYXLqGV9.js";
+import { i as readAuditReport, o as StatementError, t as renderStatement } from "../render-DI_aCnAZ.js";
+import { n as IMPACT_LEVELS, t as DEFAULT_FAIL_ON } from "../impact-YdoOtFqm.js";
+import { n as count } from "../text-BFmNtMsV.js";
 import { t as TOOL_VERSION } from "../version-B3v4rNoG.js";
-import { i as buildBaseline, n as DEFAULT_BASELINE_FILE, s as writeBaseline, t as BaselineError } from "../baseline-CgBmzFTr.js";
-import { i as resolvePages, n as isOutputFormat, r as runAuditCommand, t as OUTPUT_FORMATS } from "../audit-D4gju2BT.js";
-import { mkdir, writeFile } from "node:fs/promises";
+import { i as buildBaseline, n as DEFAULT_BASELINE_FILE, s as writeBaseline, t as BaselineError } from "../baseline-s9F3fXTN.js";
+import { n as runAuditCommand, r as resolvePages, t as OUTPUT_FORMATS } from "../audit-DcL73mOC.js";
+import { a as runEngine, i as note, n as emitDocument, r as fail, t as advise } from "../command-Dxpa00Ha.js";
 import path from "node:path";
 import { Command, InvalidArgumentError } from "commander";
-import pc from "picocolors";
 //#region src/cli/baseline.ts
 /**
 * `eaa-kit baseline [dir]`.
@@ -33,37 +33,23 @@ async function runBaselineCommand(dir, options = {}) {
 		exitCode: 2
 	};
 	const { pages, origin, label } = resolved;
-	process.stderr.write(pc.dim(`Auditing ${pages.length} ${pages.length === 1 ? "page" : "pages"} in ${label}…\n`));
-	const effectiveBaseUrl = options.baseUrl ?? origin;
-	const runnerOptions = {
-		...effectiveBaseUrl === void 0 ? {} : { baseUrl: effectiveBaseUrl },
-		...options.timeoutMs === void 0 ? {} : { timeoutMs: options.timeoutMs }
+	note(`Auditing ${count(pages.length, "page")} in ${label}…`);
+	const baseUrl = options.baseUrl ?? origin;
+	const audits = await runEngine(pages, {
+		cwd,
+		...baseUrl === void 0 ? {} : { baseUrl },
+		...options.timeoutMs === void 0 ? {} : { timeoutMs: options.timeoutMs },
+		...options.browser ? { browser: true } : {},
+		...options.concurrency === void 0 ? {} : { concurrency: options.concurrency },
+		...options.url === void 0 ? { directory: path.resolve(cwd, dir) } : {}
+	});
+	if (!audits) return {
+		entries: 0,
+		exitCode: 2
 	};
-	let audits;
-	if (options.browser) {
-		const { BrowserUnavailableError, runBrowserAudit } = await import("../playwright-DWux49V3.js");
-		try {
-			audits = await runBrowserAudit(options.url === void 0 ? path.resolve(cwd, dir) : void 0, pages, runnerOptions);
-		} catch (cause) {
-			if (cause instanceof BrowserUnavailableError) {
-				process.stderr.write(`${pc.red("error")} ${cause.message}\n`);
-				return {
-					entries: 0,
-					exitCode: 2
-				};
-			}
-			throw cause;
-		}
-	} else {
-		const { runPooledAudit } = await import("../pool-DixLeu8L.js");
-		audits = await runPooledAudit(pages, {
-			...runnerOptions,
-			...options.concurrency === void 0 ? {} : { concurrency: options.concurrency }
-		});
-	}
 	const unaudited = audits.filter((audit) => audit.error);
 	if (unaudited.length > 0) {
-		process.stderr.write(`${pc.red("error")} ${unaudited.length} of ${audits.length} pages could not be audited, so no baseline was written\n`);
+		fail(`${unaudited.length} of ${audits.length} pages could not be audited, so no baseline was written`);
 		return {
 			entries: 0,
 			exitCode: 2
@@ -78,7 +64,7 @@ async function runBaselineCommand(dir, options = {}) {
 		await writeBaseline(target, baseline, cwd);
 	} catch (cause) {
 		if (cause instanceof BaselineError) {
-			process.stderr.write(`${pc.red("error")} ${cause.message}\n`);
+			fail(cause.message);
 			return {
 				entries: 0,
 				exitCode: 2
@@ -86,11 +72,11 @@ async function runBaselineCommand(dir, options = {}) {
 		}
 		throw cause;
 	}
-	const count = baseline.entries.length;
-	process.stderr.write(pc.dim(`Wrote ${count} ${count === 1 ? "entry" : "entries"} to ${target}\n`));
-	if (count > 0) process.stderr.write(pc.yellow("These are barriers, not exceptions. Commit the file, then work the list down.\n"));
+	const entries = baseline.entries.length;
+	note(`Wrote ${entries} ${entries === 1 ? "entry" : "entries"} to ${target}`);
+	if (entries > 0) advise("These are barriers, not exceptions. Commit the file, then work the list down.");
 	return {
-		entries: count,
+		entries,
 		exitCode: 0
 	};
 }
@@ -98,9 +84,6 @@ async function runBaselineCommand(dir, options = {}) {
 //#region src/cli/statement.ts
 /** Markdown for a content directory, HTML for dropping straight onto a site. */
 const STATEMENT_FORMATS = ["markdown", "html"];
-function isStatementFormat(value) {
-	return STATEMENT_FORMATS.includes(value);
-}
 /**
 * `eaa-kit statement`.
 *
@@ -121,19 +104,16 @@ async function runStatementCommand(options = {}) {
 			...options.country ? { country: options.country } : {},
 			...audit ? { audit } : {}
 		});
-		process.stderr.write(pc.dim(`Statement for ${config.site.url} from ${path.basename(configPath)} (${statement.template}, ${format})\n`));
+		note(`Statement for ${config.site.url} from ${path.basename(configPath)} (${statement.template}, ${format})`);
 		if (audit) {
-			process.stderr.write(pc.dim(`${audit.findings.length} ${audit.findings.length === 1 ? "barrier" : "barriers"} taken from ${path.basename(options.audit ?? "")}\n`));
-			if (audit.findings.length > 0) process.stderr.write(pc.yellow("Rewrite those descriptions in your own words before publishing.\n"));
+			const from = path.basename(options.audit ?? "");
+			note(`${count(audit.findings.length, "barrier")} taken from ${from}`);
+			if (audit.findings.length > 0) advise("Rewrite those descriptions in your own words before publishing.");
 		}
 		const document = format === "html" ? statement.html : statement.markdown;
-		if (options.output) {
-			const target = path.resolve(options.cwd ?? process.cwd(), options.output);
-			await mkdir(path.dirname(target), { recursive: true });
-			await writeFile(target, document, "utf8");
-			process.stderr.write(pc.dim(`Written to ${options.output}\n`));
-		} else process.stdout.write(document);
-		process.stderr.write(pc.yellow("Review before publishing. This is a draft, not legal advice.\n"));
+		await emitDocument(document, options.output, options.cwd ?? process.cwd());
+		if (options.output !== void 0) note(`Written to ${options.output}`);
+		advise("Review before publishing. This is a draft, not legal advice.");
 		return {
 			document,
 			format,
@@ -141,8 +121,8 @@ async function runStatementCommand(options = {}) {
 		};
 	} catch (cause) {
 		if (cause instanceof ConfigError || cause instanceof StatementError) {
-			process.stderr.write(`${pc.red("error")} ${cause.message}\n`);
-			if (cause instanceof ConfigError) for (const issue of cause.issues) process.stderr.write(pc.dim(`  ${issue}\n`));
+			fail(cause.message);
+			if (cause instanceof ConfigError) for (const issue of cause.issues) note(`  ${issue}`);
 			return {
 				document: "",
 				format,
@@ -162,109 +142,67 @@ function formatFor(output) {
 }
 //#endregion
 //#region src/cli/index.ts
+/**
+* A parser for a fixed set of words, listing them when the answer is not one.
+*
+* `normalise` is for `--country de`, where the accepted spelling differs from
+* what somebody types.
+*/
+function oneOf(values, normalise = (value) => value) {
+	return (value) => {
+		const candidate = normalise(value);
+		if (!values.includes(candidate)) throw new InvalidArgumentError(`expected one of ${values.join(", ")}`);
+		return candidate;
+	};
+}
+/** A whole number no smaller than `min`. Depth allows 0: audit the entry page alone. */
+function wholeNumber(min) {
+	return (value) => {
+		const parsed = Number(value);
+		if (!Number.isInteger(parsed) || parsed < min) throw new InvalidArgumentError(`expected a whole number of ${min} or more`);
+		return parsed;
+	};
+}
+function parseDate(value) {
+	if (!/^\d{4}-\d{2}-\d{2}$/.test(value) || Number.isNaN(Date.parse(`${value}T00:00:00Z`))) throw new InvalidArgumentError("expected an ISO date, e.g. 2026-12-31");
+	return value;
+}
+const parseLocale = oneOf(STATEMENT_LOCALES);
+const parseCountry = oneOf(COUNTRIES, (value) => value.toUpperCase());
+const parseStatementFormat = oneOf(STATEMENT_FORMATS);
+const parseImpact = oneOf(IMPACT_LEVELS);
+const parseFormat = oneOf(OUTPUT_FORMATS);
+const parsePositive = wholeNumber(1);
+const parseDepth = wholeNumber(0);
+const parseConcurrency = wholeNumber(1);
 const program = new Command();
 program.exitOverride();
 program.name("eaa-kit").description("WCAG 2.2 AA auditor and EU accessibility statement generator for static sites.\nNot legal advice.").version(TOOL_VERSION, "-v, --version");
-program.command("audit").description("Audit built HTML against WCAG 2.2 AA").argument("[dir]", "directory holding the built site (default: found automatically)").option("--include <globs...>", "glob patterns to audit, relative to dir").option("--exclude <globs...>", "glob patterns to skip").option("--base-url <url>", "audit pages under their real site URL").option("--url <url>", "audit a running site instead of a build directory").option("--no-build", "never run the project build or start its server").option("--per-page", "also list every page and its result").option("--allow-remote", "allow --url to crawl a host that is not localhost").option("--ignore-robots", "crawl paths robots.txt disallows").option("--max-pages <n>", "stop the crawl after this many pages", parsePositive).option("--max-depth <n>", "how far from the entry URL to follow links", parseDepth).option("--fail-on <impact>", `exit 1 on violations at or above this impact (${IMPACT_LEVELS.join("|")})`, parseImpact, DEFAULT_FAIL_ON).option("--format <format>", `output format (${OUTPUT_FORMATS.join("|")})`, parseFormat, "console").option("--output <path>", "write the report to a file instead of stdout").option("--browser", "audit in real Chromium, covering the rules jsdom cannot evaluate").option("--concurrency <n>", "worker threads to audit with, or 1 for none (default: from the page and core count)", parseConcurrency).option("--baseline <path>", "accept the violations recorded in this file; fail only on new ones").action(async (dir, options) => {
+program.command("audit").description("Audit built HTML against WCAG 2.2 AA").argument("[dir]", "directory holding the built site (default: found automatically)").option("--include <globs...>", "glob patterns to audit, relative to dir").option("--exclude <globs...>", "glob patterns to skip").option("--base-url <url>", "audit pages under their real site URL").option("--url <url>", "audit a running site instead of a build directory").option("--no-build", "never run the project build or start its server").option("--per-page", "also list every page and its result").option("--manual", "what to check by hand for the rules this engine cannot evaluate").option("--allow-remote", "allow --url to crawl a host that is not localhost").option("--ignore-robots", "crawl paths robots.txt disallows").option("--max-pages <n>", "stop the crawl after this many pages", parsePositive).option("--max-depth <n>", "how far from the entry URL to follow links", parseDepth).option("--fail-on <impact>", `exit 1 on violations at or above this impact (${IMPACT_LEVELS.join("|")})`, parseImpact, DEFAULT_FAIL_ON).option("--format <format>", `output format (${OUTPUT_FORMATS.join("|")})`, parseFormat, "console").option("--output <path>", "write the report to a file instead of stdout").option("--browser", "audit in real Chromium, covering the rules jsdom cannot evaluate").option("--concurrency <n>", "worker threads to audit with, or 1 for none (default: from the page and core count)", parseConcurrency).option("--baseline <path>", "accept the violations recorded in this file; fail only on new ones").action(async (dir, flags) => {
+	const { build, ...options } = flags;
 	const { exitCode } = await runAuditCommand(dir, {
-		...options["build"] === false ? { noBuild: true } : {},
-		...options["perPage"] === true ? { perPage: true } : {},
-		...Array.isArray(options["include"]) ? { include: options["include"] } : {},
-		...Array.isArray(options["exclude"]) ? { exclude: options["exclude"] } : {},
-		...typeof options["baseUrl"] === "string" ? { baseUrl: options["baseUrl"] } : {},
-		failOn: options["failOn"],
-		format: options["format"],
-		...typeof options["output"] === "string" ? { output: options["output"] } : {},
-		...options["browser"] === true ? { browser: true } : {},
-		...typeof options["concurrency"] === "number" ? { concurrency: options["concurrency"] } : {},
-		...typeof options["baseline"] === "string" ? { baseline: options["baseline"] } : {},
-		...typeof options["url"] === "string" ? { url: options["url"] } : {},
-		...options["allowRemote"] === true ? { allowRemote: true } : {},
-		...options["ignoreRobots"] === true ? { ignoreRobots: true } : {},
-		...typeof options["maxPages"] === "number" ? { maxPages: options["maxPages"] } : {},
-		...typeof options["maxDepth"] === "number" ? { maxDepth: options["maxDepth"] } : {}
+		...options,
+		...build === false ? { noBuild: true } : {}
 	});
 	process.exitCode = exitCode;
 });
-program.command("baseline").description("Record the violations a build already has, so later runs fail only on new ones").argument("[dir]", "directory holding the built site", "./dist").option("--include <globs...>", "glob patterns to audit, relative to dir").option("--exclude <globs...>", "glob patterns to skip").option("--base-url <url>", "audit pages under their real site URL").option("--url <url>", "record a baseline from a running site instead of a directory").option("--allow-remote", "allow --url to crawl a host that is not localhost").option("--ignore-robots", "crawl paths robots.txt disallows").option("--max-pages <n>", "stop the crawl after this many pages", parsePositive).option("--max-depth <n>", "how far from the entry URL to follow links", parseDepth).option("--output <path>", `where to write it (default: ${DEFAULT_BASELINE_FILE})`).option("--note <text>", "recorded on every entry, for whoever reads the file").option("--expires-on <date>", "ISO date after which the entries stop suppressing", parseDate).option("--browser", "audit in real Chromium instead of jsdom").option("--concurrency <n>", "worker threads to audit with, or 1 for none", parseConcurrency).action(async (dir, options) => {
-	const { exitCode } = await runBaselineCommand(dir, {
-		...Array.isArray(options["include"]) ? { include: options["include"] } : {},
-		...Array.isArray(options["exclude"]) ? { exclude: options["exclude"] } : {},
-		...typeof options["baseUrl"] === "string" ? { baseUrl: options["baseUrl"] } : {},
-		...typeof options["output"] === "string" ? { output: options["output"] } : {},
-		...typeof options["note"] === "string" ? { note: options["note"] } : {},
-		...typeof options["expiresOn"] === "string" ? { expiresOn: options["expiresOn"] } : {},
-		...options["browser"] === true ? { browser: true } : {},
-		...typeof options["concurrency"] === "number" ? { concurrency: options["concurrency"] } : {},
-		...typeof options["url"] === "string" ? { url: options["url"] } : {},
-		...options["allowRemote"] === true ? { allowRemote: true } : {},
-		...options["ignoreRobots"] === true ? { ignoreRobots: true } : {},
-		...typeof options["maxPages"] === "number" ? { maxPages: options["maxPages"] } : {},
-		...typeof options["maxDepth"] === "number" ? { maxDepth: options["maxDepth"] } : {}
-	});
+program.command("baseline").description("Record the violations a build already has, so later runs fail only on new ones").argument("[dir]", "directory holding the built site", "./dist").option("--include <globs...>", "glob patterns to audit, relative to dir").option("--exclude <globs...>", "glob patterns to skip").option("--base-url <url>", "audit pages under their real site URL").option("--url <url>", "record a baseline from a running site instead of a directory").option("--allow-remote", "allow --url to crawl a host that is not localhost").option("--ignore-robots", "crawl paths robots.txt disallows").option("--max-pages <n>", "stop the crawl after this many pages", parsePositive).option("--max-depth <n>", "how far from the entry URL to follow links", parseDepth).option("--output <path>", `where to write it (default: ${DEFAULT_BASELINE_FILE})`).option("--note <text>", "recorded on every entry, for whoever reads the file").option("--expires-on <date>", "ISO date after which the entries stop suppressing", parseDate).option("--browser", "audit in real Chromium instead of jsdom").option("--concurrency <n>", "worker threads to audit with, or 1 for none", parseConcurrency).action(async (dir, flags) => {
+	const { exitCode } = await runBaselineCommand(dir, flags);
 	process.exitCode = exitCode;
 });
-program.command("init").description("Write an eaa.config.json to generate statements from").option("--output <path>", "write here instead of eaa.config.json").option("--force", "overwrite a config that is already there").option("-y, --yes", "take every default without asking").action(async (options) => {
-	const { runInitCommand } = await import("../init-DRKIdpK1.js");
-	const { exitCode } = await runInitCommand({
-		...typeof options["output"] === "string" ? { output: options["output"] } : {},
-		...options["force"] === true ? { force: true } : {},
-		...options["yes"] === true ? { yes: true } : {}
-	});
+program.command("init").description("Write an eaa.config.json to generate statements from").option("--output <path>", "write here instead of eaa.config.json").option("--force", "overwrite a config that is already there").option("-y, --yes", "take every default without asking").action(async (flags) => {
+	const { runInitCommand } = await import("../init-DiLiYvN1.js");
+	const { exitCode } = await runInitCommand(flags);
 	process.exitCode = exitCode;
 });
-program.command("statement").description("Generate an EU accessibility statement from eaa.config").option("--config <path>", "path to the config file, otherwise it is searched for").option("--lang <locale>", `statement language (${STATEMENT_LOCALES.join("|")})`, parseLocale).option("--country <code>", `override the country template (${COUNTRIES.join("|")})`, parseCountry).option("--audit <path>", "list the barriers from an eaa-kit audit --format json report").option("--format <format>", `output format (${STATEMENT_FORMATS.join("|")}), otherwise from the --output extension`, parseStatementFormat).option("--output <path>", "write the statement to a file instead of stdout").action(async (options) => {
+program.command("statement").description("Generate an EU accessibility statement from eaa.config").option("--config <path>", "path to the config file, otherwise it is searched for").option("--lang <locale>", `statement language (${STATEMENT_LOCALES.join("|")})`, parseLocale).option("--country <code>", `override the country template (${COUNTRIES.join("|")})`, parseCountry).option("--audit <path>", "list the barriers from an eaa-kit audit --format json report").option("--format <format>", `output format (${STATEMENT_FORMATS.join("|")}), otherwise from the --output extension`, parseStatementFormat).option("--output <path>", "write the statement to a file instead of stdout").action(async (flags) => {
+	const { lang, ...options } = flags;
 	const { exitCode } = await runStatementCommand({
-		...typeof options["config"] === "string" ? { config: options["config"] } : {},
-		...options["lang"] ? { locale: options["lang"] } : {},
-		...options["country"] ? { country: options["country"] } : {},
-		...typeof options["audit"] === "string" ? { audit: options["audit"] } : {},
-		...options["format"] ? { format: options["format"] } : {},
-		...typeof options["output"] === "string" ? { output: options["output"] } : {}
+		...options,
+		...lang === void 0 ? {} : { locale: lang }
 	});
 	process.exitCode = exitCode;
 });
-function parseLocale(value) {
-	if (!STATEMENT_LOCALES.includes(value)) throw new InvalidArgumentError(`expected one of ${STATEMENT_LOCALES.join(", ")}`);
-	return value;
-}
-function parseCountry(value) {
-	const upper = value.toUpperCase();
-	if (!COUNTRIES.includes(upper)) throw new InvalidArgumentError(`expected one of ${COUNTRIES.join(", ")}`);
-	return upper;
-}
-function parseStatementFormat(value) {
-	if (!isStatementFormat(value)) throw new InvalidArgumentError(`expected one of ${STATEMENT_FORMATS.join(", ")}`);
-	return value;
-}
-function parseDate(value) {
-	if (!/^\d{4}-\d{2}-\d{2}$/.test(value) || Number.isNaN(Date.parse(`${value}T00:00:00Z`))) throw new InvalidArgumentError("expected an ISO date, e.g. 2026-12-31");
-	return value;
-}
-function parsePositive(value) {
-	const parsed = Number(value);
-	if (!Number.isInteger(parsed) || parsed < 1) throw new InvalidArgumentError("expected a whole number of 1 or more");
-	return parsed;
-}
-/** Depth 0 is meaningful here: audit only the entry page. */
-function parseDepth(value) {
-	const parsed = Number(value);
-	if (!Number.isInteger(parsed) || parsed < 0) throw new InvalidArgumentError("expected a whole number of 0 or more");
-	return parsed;
-}
-function parseConcurrency(value) {
-	const parsed = Number(value);
-	if (!Number.isInteger(parsed) || parsed < 1) throw new InvalidArgumentError("expected a whole number of 1 or more");
-	return parsed;
-}
-function parseImpact(value) {
-	if (!isImpactLevel(value)) throw new InvalidArgumentError(`expected one of ${IMPACT_LEVELS.join(", ")}`);
-	return value;
-}
-function parseFormat(value) {
-	if (!isOutputFormat(value)) throw new InvalidArgumentError(`expected one of ${OUTPUT_FORMATS.join(", ")}`);
-	return value;
-}
 try {
 	await program.parseAsync(process.argv);
 } catch (cause) {

package/dist/collect-BkAQ0viT.js

@@ -0,0 +1,123 @@
+import { i as toPosix, t as exists } from "./fs-BmPtmFke.js";
+import { readFile, stat } from "node:fs/promises";
+import path from "node:path";
+import { glob } from "tinyglobby";
+//#region src/audit/collect.ts
+/** Every HTML document a static build is expected to emit. */
+const DEFAULT_INCLUDE = ["**/*.html", "**/*.htm"];
+/** Vendored and tooling directories are never part of the shipped site. */
+const DEFAULT_EXCLUDE = ["**/node_modules/**", "**/.git/**"];
+/** Number of files read in parallel; keeps large builds under the fd limit. */
+const READ_CONCURRENCY = 24;
+/** A UTF-8 byte-order mark is not markup, and jsdom treats it as text. */
+function stripBom(html) {
+	return html.charCodeAt(0) === 65279 ? html.slice(1) : html;
+}
+/**
+* Thrown when the build directory itself is unusable. A missing or wrong
+* `dist/` is a user mistake worth reporting loudly, unlike a directory that
+* simply holds no HTML.
+*/
+var BuildDirectoryError = class extends Error {
+	dir;
+	name = "BuildDirectoryError";
+	constructor(message, dir) {
+		super(message);
+		this.dir = dir;
+	}
+};
+/**
+* Glob HTML files out of a build directory and read them.
+*
+* Returns pages sorted by relative path so reports and snapshots are stable
+* across platforms. An empty array means "no HTML found" — the caller decides
+* whether that is an error.
+*/
+async function collectPages(dir, options = {}) {
+	const root = path.resolve(dir);
+	await assertDirectory(root, dir);
+	const relativePaths = (await glob(options.include ?? DEFAULT_INCLUDE, {
+		cwd: root,
+		ignore: options.exclude ?? DEFAULT_EXCLUDE,
+		onlyFiles: true,
+		dot: false,
+		absolute: false
+	})).map(toPosix).sort();
+	const pages = [];
+	for (let i = 0; i < relativePaths.length; i += READ_CONCURRENCY) {
+		const batch = relativePaths.slice(i, i + READ_CONCURRENCY);
+		pages.push(...await Promise.all(batch.map((relativePath) => readPage(root, relativePath))));
+	}
+	return pages;
+}
+async function assertDirectory(root, original) {
+	let stats;
+	try {
+		stats = await stat(root);
+	} catch (cause) {
+		if (cause.code === "ENOENT") throw new BuildDirectoryError(`Build directory not found: ${original}`, root);
+		throw new BuildDirectoryError(`Build directory is not readable: ${original} (${cause.message})`, root);
+	}
+	if (!stats.isDirectory()) throw new BuildDirectoryError(`Build path is not a directory: ${original}`, root);
+}
+async function readPage(root, relativePath) {
+	const absolutePath = path.join(root, relativePath);
+	return {
+		absolutePath,
+		relativePath,
+		html: stripBom(await readFile(absolutePath, "utf8"))
+	};
+}
+/**
+* What to suggest when a directory holds no HTML, or is not there at all.
+*
+* Nearly always the wrong directory rather than a site with no pages, and the
+* commonest way to arrive is a framework whose build emits no browsable HTML —
+* so rather than repeating "check the path", this works out what the project is
+* and names the next step for it. Where static output is not possible at all,
+* that step is `--url` rather than advice that cannot apply.
+*/
+async function emptyDirectoryHint(dir, cwd = process.cwd()) {
+	const head = await exists(dir, cwd) ? `${dir} holds no HTML files.` : `${dir} does not exist.`;
+	const { detectFramework } = await import("./frameworks-DaDqrJOw.js");
+	const { readPackageJson } = await import("./project-DW08TseF.js");
+	const detected = await detectFramework(cwd, await readPackageJson(cwd));
+	if (detected !== void 0) return frameworkAdvice(head, detected, cwd, dir);
+	return await siblingAdvice(head, cwd, dir) ?? generic(head);
+}
+/** Advice built from what the registry knows about this framework. */
+async function frameworkAdvice(head, detected, cwd, dir) {
+	const { framework, outputs } = detected;
+	const given = dir.replace(/^\.\//, "");
+	for (const output of outputs) if (output !== given && await exists(output, cwd)) return `${head} ${framework.name} writes to ${output}/, not ${dir}.\n  Try: eaa-kit audit ./${output}`;
+	const lines = [`${head} This is ${article(framework.name)} ${framework.name} project.`];
+	if (framework.staticOutput !== void 0) lines.push(`  Static output takes ${framework.staticOutput.needs} — ${framework.staticOutput.how},`, `  then: eaa-kit audit ./${outputs[0]}`);
+	else if (outputs.length === 1 && outputs[0] === given) lines.push(`  That is where it writes, so the build has not run yet — or it failed.`);
+	else lines.push(`  It writes to ${outputs.map((output) => `${output}/`).join(" or ")}. Run your build, then:`, `    eaa-kit audit ./${outputs[0]}`);
+	if (framework.serves) lines.push("  A site that renders on a server cannot be written to disk at all. Audit it", "  running instead:", "    eaa-kit audit --url http://localhost:3000");
+	return lines.join("\n");
+}
+/** Naming a build directory that is actually there beats listing the usual ones. */
+async function siblingAdvice(head, cwd, dir) {
+	const { FALLBACK_OUTPUTS } = await import("./frameworks-DaDqrJOw.js");
+	const given = dir.replace(/^\.\//, "");
+	const others = (await Promise.all(FALLBACK_OUTPUTS.map(async (name) => name !== given && await exists(name, cwd) ? name : void 0))).filter((name) => name !== void 0);
+	if (others.length === 0) return void 0;
+	return `${head} This project also has ${others.map((name) => `${name}/`).join(", ")} — try one of those.`;
+}
+function generic(head) {
+	return `${head} Point eaa-kit at the directory your build fills with .html files —\n  commonly dist/, build/, out/ or _site/, depending on the builder.
+  If your site renders on a server and never writes HTML, audit it running:
+    eaa-kit audit --url http://localhost:3000`;
+}
+/**
+* "a Next.js project", "an Eleventy project".
+*
+* By letter rather than by sound, which is wrong for words like "hour" and
+* right for every framework name in the registry.
+*/
+function article(name) {
+	return /^[aeiou]/i.test(name) ? "an" : "a";
+}
+//#endregion
+export { stripBom as i, collectPages as n, emptyDirectoryHint as r, BuildDirectoryError as t };

package/dist/command-Dxpa00Ha.js

@@ -0,0 +1,77 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import pc from "picocolors";
+//#region src/cli/command.ts
+/**
+* What every command does around the audit itself: say what is happening, run
+* the engine, and put the document somewhere.
+*
+* `audit` and `baseline` are siblings — one reports what a run found and the
+* other writes it down — so they take the same flags, choose between the same
+* two engines and fail on the same setup problems. Keeping that in one place is
+* what stops the two commands drifting into disagreeing about what a run is.
+*/
+/** Progress and diagnostics go to stderr, so the report can be piped away. */
+function note(message) {
+	process.stderr.write(pc.dim(`${message}\n`));
+}
+function warn(message) {
+	process.stderr.write(`${pc.yellow("warning")} ${message}\n`);
+}
+function fail(message) {
+	process.stderr.write(`${pc.red("error")} ${message}\n`);
+}
+/**
+* Advice the reader should not miss, without the `warning` prefix: nothing has
+* gone wrong, but what happens next is theirs to get right.
+*/
+function advise(message) {
+	process.stderr.write(pc.yellow(`${message}\n`));
+}
+/**
+* Audit the pages with whichever engine was asked for.
+*
+* Returns undefined when the browser was asked for and is not usable, having
+* already said so: Playwright missing is a setup problem with a specific fix,
+* not a crash, and both commands turn it into exit 2.
+*/
+async function runEngine(pages, options) {
+	const runnerOptions = {
+		cwd: options.cwd,
+		...options.baseUrl === void 0 ? {} : { baseUrl: options.baseUrl },
+		...options.timeoutMs === void 0 ? {} : { timeoutMs: options.timeoutMs }
+	};
+	if (!options.browser) {
+		const { runPooledAudit } = await import("./pool-BWkWZiJW.js");
+		return runPooledAudit(pages, {
+			...runnerOptions,
+			...options.concurrency === void 0 ? {} : { concurrency: options.concurrency }
+		});
+	}
+	const { BrowserUnavailableError, runBrowserAudit } = await import("./playwright-DYFsGUNd.js");
+	try {
+		return await runBrowserAudit(options.directory, pages, runnerOptions);
+	} catch (cause) {
+		if (cause instanceof BrowserUnavailableError) {
+			fail(cause.message);
+			return;
+		}
+		throw cause;
+	}
+}
+/**
+* Write a document to `output`, or to stdout when there is none. Parent
+* directories are created, since a report path in CI usually names one that is
+* not there yet.
+*/
+async function emitDocument(body, output, cwd) {
+	if (output === void 0) {
+		process.stdout.write(body);
+		return;
+	}
+	const target = path.resolve(cwd, output);
+	await mkdir(path.dirname(target), { recursive: true });
+	await writeFile(target, body, "utf8");
+}
+//#endregion
+export { runEngine as a, note as i, emitDocument as n, warn as o, fail as r, advise as t };