eaa-kit 0.1.0 → 0.1.1

package/README.md

@@ -22,8 +22,9 @@ npx eaa-kit statement             # Barrierefreiheitserklärung from eaa.config
 pnpm add -D eaa-kit    # npm i -D eaa-kit
 ```
 
-Node 22.22 or newer. jsdom, which the browserless engine is built on, does not support
-Node 20.
+Node 22.22, 24.15 or 26 and newer. jsdom, which the browserless engine is built on,
+supports only the even-numbered release lines, so the odd-numbered ones (23, 25) are not
+supported here either.
 
 ## What it does
 

package/dist/astro/index.js

@@ -18,7 +18,7 @@ function eaaKit(options = {}) {
 				logger.info("skipped (enabled: false)");
 				return;
 			}
-			const { runAuditCommand } = await import("../audit-VtuUOuyX.js");
+			const { runAuditCommand } = await import("../audit-47fMewVm.js");
 			const { exitCode } = await runAuditCommand(fileURLToPath(dir), {
 				...options.failOn ? { failOn: options.failOn } : {},
 				...options.include ? { include: options.include } : {},

package/dist/audit-47fMewVm.js

@@ -0,0 +1,2 @@
+import { r as runAuditCommand } from "./audit-CApiPaiG.js";
+export { runAuditCommand };

package/dist/{audit-6gbV0Zjd.js → audit-CApiPaiG.js}

@@ -69,6 +69,30 @@ async function readPage(root, relativePath) {
 function toPosix(filePath) {
 	return filePath.split(path.sep).join("/");
 }
+/**
+* What to suggest when a directory exists but holds no HTML.
+*
+* Nearly always the wrong directory rather than a site with no pages, and the
+* commonest way to arrive here is a framework whose build does not emit browsable
+* HTML at all. Naming the one in front of the user beats a generic "check the
+* path", so the project is sniffed for the frameworks that mislead people this
+* way — `./dist` is every tutorial's answer and is wrong for all of them.
+*/
+async function emptyDirectoryHint(dir, cwd = process.cwd()) {
+	const has = async (name) => {
+		try {
+			await stat(path.resolve(cwd, name));
+			return true;
+		} catch {
+			return false;
+		}
+	};
+	if (await has("next.config.js") || await has("next.config.mjs") || await has("next.config.ts")) return `${dir} holds no HTML, and a Next.js build does not put any there.\n  Static export writes to out/: set output: 'export' in next.config, run next build,
+  then: eaa-kit audit ./out
+  A site with SSR, API routes or middleware cannot be exported this way.`;
+	if (await has("nuxt.config.ts")) return `${dir} holds no HTML. Nuxt writes a static build to .output/public — try: eaa-kit audit ./.output/public`;
+	return `${dir} holds no HTML. Point eaa-kit at the directory your build fills with .html files\n  — commonly dist/, build/, out/ or _site/, depending on the builder.`;
+}
 //#endregion
 //#region src/audit/report/console.ts
 const DEFAULT_MAX_NODES = 3;
@@ -436,7 +460,7 @@ async function runAuditCommand(dir, options = {}) {
 		throw cause;
 	}
 	if (pages.length === 0) {
-		process.stderr.write(`${pc.yellow("warning")} No HTML files found in ${dir}\n`);
+		process.stderr.write(`${pc.yellow("warning")} ${await emptyDirectoryHint(dir, options.cwd ?? process.cwd())}\n`);
 		return {
 			audits: [],
 			exitCode: 2
@@ -579,4 +603,4 @@ async function renderReport(audits, dir, failOn, format, toFile, options) {
 	}
 }
 //#endregion
-export { collectPages as a, BuildDirectoryError as i, isOutputFormat as n, runAuditCommand as r, OUTPUT_FORMATS as t };
+export { collectPages as a, BuildDirectoryError as i, isOutputFormat as n, emptyDirectoryHint as o, runAuditCommand as r, OUTPUT_FORMATS as t };

package/dist/cli/index.js

@@ -3,7 +3,7 @@ import { f as COUNTRIES, h as STATEMENT_LOCALES, i as readAuditReport, l as load
 import { i as isImpactLevel, n as IMPACT_LEVELS, t as DEFAULT_FAIL_ON } from "../impact-DvgBjupx.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-DQTnNlc4.js";
-import { a as collectPages, i as BuildDirectoryError, n as isOutputFormat, r as runAuditCommand, t as OUTPUT_FORMATS } from "../audit-6gbV0Zjd.js";
+import { a as collectPages, i as BuildDirectoryError, n as isOutputFormat, o as emptyDirectoryHint, r as runAuditCommand, t as OUTPUT_FORMATS } from "../audit-CApiPaiG.js";
 import { mkdir, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { Command, InvalidArgumentError } from "commander";
@@ -40,7 +40,7 @@ async function runBaselineCommand(dir, options = {}) {
 		throw cause;
 	}
 	if (pages.length === 0) {
-		process.stderr.write(`${pc.yellow("warning")} No HTML files found in ${dir}\n`);
+		process.stderr.write(`${pc.yellow("warning")} ${await emptyDirectoryHint(dir, options.cwd ?? process.cwd())}\n`);
 		return {
 			entries: 0,
 			exitCode: 2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eaa-kit",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Build-time WCAG 2.2 AA auditor and EU accessibility statement generator for static sites (EAA / BFSG / BaFG, DACH-localised).",
   "type": "module",
   "license": "MIT",
@@ -23,7 +23,7 @@
     "cli"
   ],
   "engines": {
-    "node": ">=22.22.2"
+    "node": "^22.22.2 || ^24.15.0 || >=26.0.0"
   },
   "packageManager": "pnpm@10.28.0",
   "bin": {
@@ -53,7 +53,7 @@
     "typecheck": "tsc --noEmit",
     "lint": "biome check .",
     "format": "biome check --write .",
-    "smoke": "pnpm build && node dist/cli/index.js audit tests/fixtures/site --include about/** --format json && node dist/cli/index.js audit tests/fixtures/site --include 'about/**' 'blog/**' 'drafts/**' 'legacy.htm' --concurrency 2 && node dist/cli/index.js audit tests/fixtures/site --include about/** --format html && node dist/cli/index.js audit tests/fixtures/site --baseline examples/baseline.json && node -e \"import('./dist/astro/index.js').then(m => { const i = m.default(); if (i.name !== 'eaa-kit' || typeof i.hooks['astro:build:done'] !== 'function') { throw new Error('astro entry point is not an integration') } console.log('astro entry ok') })\" && node dist/cli/index.js statement --config examples/eaa.config.json && node dist/cli/index.js statement --config examples/eaa.config.json --audit examples/report.json --format html",
+    "smoke": "pnpm build && node dist/cli/index.js audit tests/fixtures/site --include about/** --format json && node dist/cli/index.js audit tests/fixtures/site --include \"about/**\" \"blog/**\" \"drafts/**\" \"legacy.htm\" --concurrency 2 && node dist/cli/index.js audit tests/fixtures/site --include about/** --format html && node dist/cli/index.js audit tests/fixtures/site --baseline examples/baseline.json && node -e \"import('./dist/astro/index.js').then(m => { const i = m.default(); if (i.name !== 'eaa-kit' || typeof i.hooks['astro:build:done'] !== 'function') { throw new Error('astro entry point is not an integration') } console.log('astro entry ok') })\" && node dist/cli/index.js statement --config examples/eaa.config.json && node dist/cli/index.js statement --config examples/eaa.config.json --audit examples/report.json --format html",
     "examples": "pnpm build && node scripts/generate-examples.mjs"
   },
   "peerDependencies": {

package/dist/audit-VtuUOuyX.js

@@ -1,2 +0,0 @@
-import { r as runAuditCommand } from "./audit-6gbV0Zjd.js";
-export { runAuditCommand };