tessera-learn 0.2.0 → 0.2.1

package/AGENTS.md

@@ -37,7 +37,7 @@ pnpm tessera export <name>  # each course exports independently to its own LMS p
 cd courses/<name> && pnpm exec tessera export   # …this works for every command, not just dev
 ```
 
-A **bare command at the workspace root errors** and lists the available courses — it never silently picks one, so its meaning can't change as you add courses. Name the course, or `cd` into its folder. (The scaffolded root scripts — `pnpm dev`, `pnpm export`, … — target the seed course `starter-course`.)
+A **bare command at the workspace root errors** and lists the available courses — it never silently picks one, so its meaning can't change as you add courses. Name the course, or `cd` into its folder. (The scaffolded root scripts — `pnpm dev`, `pnpm export`, … — pass straight through, so `pnpm dev <course>` runs that course and a bare `pnpm dev` errors just the same.)
 
 ### Sharing across courses with `$shared`
 
@@ -58,21 +58,21 @@ A **bare command at the workspace root errors** and lists the available courses
 
 ## Running the project
 
-From the project root (the project is set up for `pnpm` — Node's corepack provisions it automatically):
+From the workspace root (set up for `pnpm` — Node's corepack provisions it automatically). The `dev`/`export`/`validate`/`check` scripts take the course to run; a bare command lists the workspace's courses rather than picking one:
 
 ```bash
 pnpm install              # first time only
-pnpm dev                  # dev server at http://localhost:5173 (Ctrl+C to stop)
-pnpm export               # build + package for the LMS standard configured in course.config.js
-pnpm validate             # run project validation only — no server, no bundle
-pnpm check                # validate, then the runtime accessibility audit (axe) over the built course
+pnpm dev <course>         # dev server at http://localhost:5173 (Ctrl+C to stop)
+pnpm export <course>      # build + package for the LMS standard configured in course.config.js
+pnpm validate <course>    # run project validation only — no server, no bundle
+pnpm check <course>       # validate, then the runtime accessibility audit (axe) over the built course
 ```
 
 The dev server hot-reloads as you edit pages, layouts, components, and `course.config.js`. The `export` command produces a SCORM 1.2, SCORM 2004, cmi5, or static-web bundle depending on `course.config.js`.
 
-`pnpm validate` runs the same checks as `dev` and `export` (page syntax, manifest shape, `pageConfig`, question components, asset references, LMS data-contract bypass, and the static accessibility rules) and exits non-zero if any fail. Use it as a fast feedback loop after editing — it's the quickest way to confirm a change is structurally sound.
+`pnpm validate <course>` runs the same checks as `dev` and `export` (page syntax, manifest shape, `pageConfig`, question components, asset references, LMS data-contract bypass, and the static accessibility rules) and exits non-zero if any fail. Use it as a fast feedback loop after editing — it's the quickest way to confirm a change is structurally sound.
 
-`pnpm check` runs `validate` and then the deeper, opt-in pass (`tessera a11y`): it builds the course, renders every page in a headless browser, and runs [axe-core](https://github.com/dequelabs/axe-core) to catch issues a static scan can't see (computed ARIA, real rendered contrast). The runtime audit drives Playwright, which needs a browser binary once per machine:
+`pnpm check <course>` runs `validate` and then the deeper, opt-in pass (`tessera a11y`): it builds the course, renders every page in a headless browser, and runs [axe-core](https://github.com/dequelabs/axe-core) to catch issues a static scan can't see (computed ARIA, real rendered contrast). The runtime audit drives Playwright, which needs a browser binary once per machine:
 
 ```bash
 pnpm exec playwright install chromium
@@ -892,7 +892,7 @@ export default {
 
 ### Build output
 
-`pnpm export` (which wraps `vite build`) writes:
+`pnpm export <course>` (which wraps `vite build`) writes:
 
 | `export.standard` | What ships                            | Where                                    |
 | ----------------- | ------------------------------------- | ---------------------------------------- |
@@ -905,7 +905,7 @@ For LMS exports, upload the zip via your LMS's import flow. For web export, the
 
 ### Validation
 
-The Vite plugin runs project validation on every dev start and build (page syntax, manifest shape, `pageConfig` parseability, question components, asset references, LMS data-contract bypass, etc.). Errors abort the build and print as `[tessera error] ...`; warnings print as `[tessera warning] ...` and don't block. Run `pnpm validate` to check without building.
+The Vite plugin runs project validation on every dev start and build (page syntax, manifest shape, `pageConfig` parseability, question components, asset references, LMS data-contract bypass, etc.). Errors abort the build and print as `[tessera error] ...`; warnings print as `[tessera warning] ...` and don't block. Run `pnpm validate <course>` to check without building.
 
 ---
 
@@ -915,7 +915,7 @@ Tessera checks accessibility in two passes, plus components that are accessible
 
 **Static checks** run inside `validate`, `dev`, and `export` — no extra setup. They cover what's visible in your source: `<Image>` alt-or-`decorative`, `<Video>`/`<Audio>` `title` + captions/transcript, empty question option/answer labels, skipped heading levels (e.g. `h2` → `h4`), `branding.primaryColor` contrast against white, and a well-formed `language` tag. They also route the Svelte compiler's own `a11y_*` warnings through the reporter. Each diagnostic carries a rule ID in brackets (e.g. `[tessera/image-alt]`, `[a11y_missing_attribute]`) — that ID is what `a11y.ignore` and `a11y.level` match.
 
-**Runtime audit** is the opt-in deep pass: `pnpm a11y` (run it directly, or via `pnpm check`, which runs `validate` first) builds the course, renders **every** page in a headless browser (including pages gated behind a quiz), runs [axe-core](https://github.com/dequelabs/axe-core), writes `a11y-report.json`, and exits non-zero on any violation at or above an impact threshold (default `serious`). It catches what a static scan can't — computed ARIA, focus order, real rendered contrast.
+**Runtime audit** is the opt-in deep pass: `pnpm a11y <course>` (run it directly, or via `pnpm check <course>`, which runs `validate` first) builds the course, renders **every** page in a headless browser (including pages gated behind a quiz), runs [axe-core](https://github.com/dequelabs/axe-core), writes `a11y-report.json`, and exits non-zero on any violation at or above an impact threshold (default `serious`). It catches what a static scan can't — computed ARIA, focus order, real rendered contrast.
 
 The runtime audit drives Playwright, which needs a browser binary once per machine:
 

package/dist/{audit-BA5o0ick.js → audit-BNrvFHq_.js}

@@ -1446,7 +1446,7 @@ async function runAudit(projectRoot, workspaceRoot, options = {}) {
 	const disableRules = axeIgnoreRules(settings.ignore);
 	const manifest = generateManifest(resolve(projectRoot, "pages"));
 	const vite = await import("vite");
-	const { resolveTesseraConfig } = await import("./inline-config-CroQ-_2Y.js");
+	const { resolveTesseraConfig } = await import("./inline-config-Dudu5r8w.js");
 	const auditBaseConfig = await resolveTesseraConfig(projectRoot, workspaceRoot, {
 		command: "build",
 		mode: "production"
@@ -1510,23 +1510,29 @@ async function runAudit(projectRoot, workspaceRoot, options = {}) {
 					nodes: v.nodes.length
 				}));
 			};
-			const navCount = await page.locator("button.tessera-nav-page").count();
-			if (navCount === 0) pages.push({
-				index: 0,
-				title: manifest.pages[0]?.title ?? "(entry)",
-				violations: await scan()
-			});
-			else for (let i = 0; i < navCount; i++) {
-				const btn = page.locator("button.tessera-nav-page").nth(i);
-				const title = (await btn.textContent())?.trim() || `Page ${i + 1}`;
-				await btn.click();
-				await page.waitForFunction((idx) => document.querySelectorAll("button.tessera-nav-page")[idx]?.getAttribute("aria-current") === "page", i, { timeout: 2e4 });
-				await page.waitForLoadState("networkidle");
-				pages.push({
-					index: i,
+			const recordPage = async (index, title) => {
+				const loadFailed = await page.evaluate(() => document.getElementById("tessera-app")?.dataset.tesseraPageError === "true");
+				if (loadFailed) return {
+					index,
+					title,
+					violations: [],
+					loadFailed
+				};
+				return {
+					index,
 					title,
 					violations: await scan()
-				});
+				};
+			};
+			const totalPages = manifest.pages.length;
+			if (!await page.evaluate(() => typeof window.__tesseraAudit?.goToIndex === "function")) {
+				if (totalPages > 1) console.warn(`\x1b[33m[tessera a11y]\x1b[0m Could not enumerate pages; auditing the entry page only (1 of ${totalPages}). The report records the reduced scope.`);
+				pages.push(await recordPage(0, manifest.pages[0]?.title ?? "(entry)"));
+			} else for (let i = 0; i < totalPages; i++) {
+				await page.evaluate((idx) => window.__tesseraAudit.goToIndex(idx), i);
+				await page.waitForFunction((idx) => document.getElementById("tessera-app")?.dataset.tesseraPageIndex === String(idx), i, { timeout: 2e4 });
+				await page.waitForLoadState("networkidle");
+				pages.push(await recordPage(i, manifest.pages[i]?.title ?? `Page ${i + 1}`));
 			}
 		} finally {
 			await browser.close();
@@ -1534,17 +1540,24 @@ async function runAudit(projectRoot, workspaceRoot, options = {}) {
 		const thresholdRank = IMPACT_RANK[threshold];
 		let totalViolations = 0;
 		let failingViolations = 0;
-		for (const p of pages) for (const v of p.violations) {
-			totalViolations++;
-			if (isFailing(v, thresholdRank)) failingViolations++;
+		let pagesFailedToLoad = 0;
+		for (const p of pages) {
+			if (p.loadFailed) pagesFailedToLoad++;
+			for (const v of p.violations) {
+				totalViolations++;
+				if (isFailing(v, thresholdRank)) failingViolations++;
+			}
 		}
 		const report = {
 			standard: settings.standard,
 			threshold,
 			pages,
+			pagesAudited: pages.length,
+			totalPages: manifest.pages.length,
+			pagesFailedToLoad,
 			totalViolations,
 			failingViolations,
-			passed: failingViolations === 0
+			passed: failingViolations === 0 && pagesFailedToLoad === 0
 		};
 		const reportPath = resolve(projectRoot, "a11y-report.json");
 		writeFileSync(reportPath, JSON.stringify(report, null, 2), "utf-8");
@@ -1562,6 +1575,10 @@ async function runAudit(projectRoot, workspaceRoot, options = {}) {
 function printSummary(report, reportPath) {
 	const thresholdRank = IMPACT_RANK[report.threshold];
 	for (const p of report.pages) {
+		if (p.loadFailed) {
+			console.log(`\x1b[31m  ✗\x1b[0m ${p.title} — failed to load`);
+			continue;
+		}
 		if (p.violations.length === 0) {
 			console.log(`\x1b[32m  ✓\x1b[0m ${p.title}`);
 			continue;
@@ -1571,10 +1588,20 @@ function printSummary(report, reportPath) {
 		for (const v of p.violations) console.log(`      [${v.impact ?? "n/a"}] ${v.id} — ${v.help} (${v.nodes} node${v.nodes === 1 ? "" : "s"})`);
 	}
 	console.log(`\n[tessera a11y] Report written to ${reportPath}`);
+	if (report.pagesAudited < report.totalPages) console.log(`\x1b[33m[tessera a11y] Covered ${report.pagesAudited} of ${report.totalPages} page(s)\x1b[0m — reduced scope, the rest were not audited.`);
+	else if (report.pagesFailedToLoad > 0) {
+		const scanned = report.pagesAudited - report.pagesFailedToLoad;
+		console.log(`[tessera a11y] Reached all ${report.totalPages} page(s); scanned ${scanned}, ${report.pagesFailedToLoad} failed to load.`);
+	} else console.log(`[tessera a11y] Covered all ${report.totalPages} page(s).`);
 	if (report.passed) console.log(`\x1b[32m[tessera a11y] Passed\x1b[0m — ${report.totalViolations} total finding(s), none at/above "${report.threshold}".`);
-	else console.log(`\x1b[31m[tessera a11y] Failed\x1b[0m — ${report.failingViolations} finding(s) at/above "${report.threshold}" (of ${report.totalViolations} total).`);
+	else {
+		const reasons = [];
+		if (report.failingViolations > 0) reasons.push(`${report.failingViolations} finding(s) at/above "${report.threshold}" (of ${report.totalViolations} total)`);
+		if (report.pagesFailedToLoad > 0) reasons.push(`${report.pagesFailedToLoad} page(s) failed to load`);
+		console.log(`\x1b[31m[tessera a11y] Failed\x1b[0m — ${reasons.join("; ")}.`);
+	}
 }
 //#endregion
 export { isPlausibleLanguageTag as a, validateProject as c, isIgnored as i, generateManifest as l, runAudit as n, normalizeA11y as o, resolvePackageRoot as r, reportValidationIssues as s, AUDIT_ENV_FLAG as t, readCourseConfig as u };
 
-//# sourceMappingURL=audit-BA5o0ick.js.map
+//# sourceMappingURL=audit-BNrvFHq_.js.map