tessera-learn 0.0.13 → 0.1.0

package/src/runtime/xapi/derive-actor.ts

@@ -3,54 +3,48 @@ import type { SCORM12API } from '../adapters/scorm12.js';
 import type { SCORM2004API } from '../adapters/scorm2004.js';
 
 /**
- * Compute the default SCORM-derived `account.homePage` from the activity
- * IRI. Returns the URL origin when `activityId` is an http(s) URL,
- * otherwise null. Callers that get null and have no `actorAccountHomePage`
- * override should treat it as a config error (the build-time validator
- * already enforces this; this is a runtime fallback for completeness).
+ * Origin of an http(s) URL, else null. Shared with the config validator, which
+ * predicts this result to know when `actorAccountHomePage` becomes required —
+ * one helper keeps the two in lockstep.
  */
-export function defaultAccountHomePage(activityId: string): string | null {
+export function httpOrigin(url: string): string | null {
   try {
-    const url = new URL(activityId);
-    if (url.protocol === 'http:' || url.protocol === 'https:') {
-      return url.origin;
-    }
-    return null;
+    const parsed = new URL(url);
+    return parsed.protocol === 'http:' || parsed.protocol === 'https:'
+      ? parsed.origin
+      : null;
   } catch {
     return null;
   }
 }
 
 /**
- * Synthesize an Identified Agent for SCORM 1.2 from the LMS data model.
+ * Synthesize an Identified Agent from the SCORM learner fields.
  *
- *   { account: { homePage, name: cmi.core.student_id },
- *     name: cmi.core.student_name,
- *     objectType: 'Agent' }
+ *   { account: { homePage, name: <id> }, name: <name>, objectType: 'Agent' }
  *
  * The `account` IFI satisfies xAPI's Identified Agent rule. `homePage`
- * defaults to the activityId origin so analytics keyed on actor identity
- * stay stable across LMS hosts; the author's `actorAccountHomePage`
- * overrides when the authority namespace is elsewhere.
- *
- * Returns null if `student_id` is missing — caller should not construct
- * a publisher in that case (the LRS would 400 on every send anyway).
+ * defaults to the activityId origin so analytics keyed on actor identity stay
+ * stable across LMS hosts; the author's `actorAccountHomePage` overrides when
+ * the authority namespace is elsewhere. Returns null if the id is missing —
+ * the caller should not construct a publisher (the LRS would 400 every send).
  */
-export function synthesizeSCORM12Actor(
-  api: SCORM12API,
+function synthesizeActor(
+  readId: () => string,
+  readName: () => string,
   activityId: string,
   actorAccountHomePage?: string,
 ): XAPIAgent | null {
   let id = '';
   let name = '';
   try {
-    id = api.LMSGetValue('cmi.core.student_id') || '';
+    id = readId() || '';
   } catch {}
   try {
-    name = api.LMSGetValue('cmi.core.student_name') || '';
+    name = readName() || '';
   } catch {}
   if (!id) return null;
-  const homePage = actorAccountHomePage ?? defaultAccountHomePage(activityId);
+  const homePage = actorAccountHomePage ?? httpOrigin(activityId);
   if (!homePage) return null;
   const agent: XAPIAgent = {
     account: { homePage, name: id },
@@ -60,31 +54,30 @@ export function synthesizeSCORM12Actor(
   return agent;
 }
 
-/**
- * Synthesize an Identified Agent for SCORM 2004 from the LMS data model.
- * Same structure as SCORM 1.2 but reads from `cmi.learner_id` /
- * `cmi.learner_name` (the renamed 2004 fields).
- */
+/** SCORM 1.2 actor from `cmi.core.student_id` / `cmi.core.student_name`. */
+export function synthesizeSCORM12Actor(
+  api: SCORM12API,
+  activityId: string,
+  actorAccountHomePage?: string,
+): XAPIAgent | null {
+  return synthesizeActor(
+    () => api.LMSGetValue('cmi.core.student_id'),
+    () => api.LMSGetValue('cmi.core.student_name'),
+    activityId,
+    actorAccountHomePage,
+  );
+}
+
+/** SCORM 2004 actor from `cmi.learner_id` / `cmi.learner_name` (renamed 2004 fields). */
 export function synthesizeSCORM2004Actor(
   api: SCORM2004API,
   activityId: string,
   actorAccountHomePage?: string,
 ): XAPIAgent | null {
-  let id = '';
-  let name = '';
-  try {
-    id = api.GetValue('cmi.learner_id') || '';
-  } catch {}
-  try {
-    name = api.GetValue('cmi.learner_name') || '';
-  } catch {}
-  if (!id) return null;
-  const homePage = actorAccountHomePage ?? defaultAccountHomePage(activityId);
-  if (!homePage) return null;
-  const agent: XAPIAgent = {
-    account: { homePage, name: id },
-    objectType: 'Agent',
-  };
-  if (name) agent.name = name;
-  return agent;
+  return synthesizeActor(
+    () => api.GetValue('cmi.learner_id'),
+    () => api.GetValue('cmi.learner_name'),
+    activityId,
+    actorAccountHomePage,
+  );
 }

package/src/runtime/xapi/publisher.ts

@@ -482,18 +482,22 @@ export class XAPIPublisher {
       }));
   }
 
+  #buildHeaders(token: string): Headers {
+    const headers = new Headers();
+    if (token) headers.set('Authorization', `Basic ${token}`);
+    headers.set('X-Experience-API-Version', X_API_VERSION);
+    headers.set('Content-Type', 'application/json');
+    return headers;
+  }
+
   #fetchWithToken(
     token: string,
     body: string,
     keepalive: boolean,
   ): Promise<SendOutcome> {
-    const headers = new Headers();
-    if (token) headers.set('Authorization', `Basic ${token}`);
-    headers.set('X-Experience-API-Version', X_API_VERSION);
-    headers.set('Content-Type', 'application/json');
     return fetch(this.#statementsUrl, {
       method: 'POST',
-      headers,
+      headers: this.#buildHeaders(token),
       body,
       keepalive,
     })
@@ -521,18 +525,14 @@ export class XAPIPublisher {
     ) {
       this.#cachedAuth = null;
       return this.#resolveAuth(true)
-        .then((newToken) => {
-          const retryHeaders = new Headers();
-          if (newToken) retryHeaders.set('Authorization', `Basic ${newToken}`);
-          retryHeaders.set('X-Experience-API-Version', X_API_VERSION);
-          retryHeaders.set('Content-Type', 'application/json');
-          return fetch(this.#statementsUrl, {
+        .then((newToken) =>
+          fetch(this.#statementsUrl, {
             method: 'POST',
-            headers: retryHeaders,
+            headers: this.#buildHeaders(newToken),
             body,
             keepalive,
-          });
-        })
+          }),
+        )
         .then((retryResp): SendOutcome => {
           if (retryResp.ok || retryResp.status === 409) {
             return { ok: true, status: retryResp.status };

package/src/runtime/xapi/setup.ts

@@ -90,6 +90,10 @@ function makeSCORMDevFallbackPublisher(
  * adapter present in non-cmi5 export modes — the validator should have
  * caught this at build time).
  */
+type ActorResolution =
+  | { kind: 'actor'; value: XAPIAgent | (() => XAPIAgent | Promise<XAPIAgent>) }
+  | { kind: 'scorm-fallback'; standard: 'scorm12' | 'scorm2004' };
+
 function resolveDestination(
   entry: XAPIConfig,
   config: CourseConfig,
@@ -114,24 +118,18 @@ function resolveDestination(
 
   // Explicit endpoint.
   const explicit = entry as XAPIExplicitConfig;
-  const actorOrResolver = resolveExplicitActor(explicit, config, adapter);
-  if (actorOrResolver === null) return null;
-  if (
-    typeof actorOrResolver === 'object' &&
-    (actorOrResolver as { __scormDevFallback?: 'scorm12' | 'scorm2004' })
-      .__scormDevFallback
-  ) {
-    const std = (
-      actorOrResolver as { __scormDevFallback: 'scorm12' | 'scorm2004' }
-    ).__scormDevFallback;
-    return { kind: 'explicit', publisher: makeSCORMDevFallbackPublisher(std) };
+  const resolution = resolveExplicitActor(explicit, config, adapter);
+  if (resolution === null) return null;
+  if (resolution.kind === 'scorm-fallback') {
+    return {
+      kind: 'explicit',
+      publisher: makeSCORMDevFallbackPublisher(resolution.standard),
+    };
   }
   const publisher = new XAPIPublisher({
     endpoint: explicit.endpoint,
     auth: explicit.auth,
-    actor: actorOrResolver as
-      | XAPIAgent
-      | (() => XAPIAgent | Promise<XAPIAgent>),
+    actor: resolution.value,
     activityId: explicit.activityId,
     registration: explicit.registration,
   });
@@ -149,50 +147,45 @@ function resolveExplicitActor(
   explicit: XAPIExplicitConfig,
   config: CourseConfig,
   adapter: PersistenceAdapter | null,
-):
-  | XAPIAgent
-  | (() => XAPIAgent | Promise<XAPIAgent>)
-  | { __scormDevFallback: 'scorm12' | 'scorm2004' }
-  | null {
-  if (explicit.actor !== undefined) return explicit.actor;
-  // No author-supplied actor — try mode-specific derivation.
+): ActorResolution | null {
+  if (explicit.actor !== undefined) {
+    return { kind: 'actor', value: explicit.actor };
+  }
   if (config.export?.standard === 'cmi5' && adapter instanceof CMI5Adapter) {
     const inner = adapter.getPublisher();
-    if (inner) {
-      // The cmi5 adapter's publisher has the launch actor cached.
-      try {
-        return inner.getActor();
-      } catch {
-        return null;
-      }
+    if (!inner) return null;
+    try {
+      return { kind: 'actor', value: inner.getActor() };
+    } catch {
+      return null;
     }
-    return null;
   }
   if (config.export?.standard === 'scorm12') {
     if (adapter instanceof SCORM12Adapter) {
-      return synthesizeSCORM12Actor(
-        adapter.getAPI(),
-        explicit.activityId,
-        explicit.actorAccountHomePage,
-      );
+      return {
+        kind: 'actor',
+        value: synthesizeSCORM12Actor(
+          adapter.getAPI(),
+          explicit.activityId,
+          explicit.actorAccountHomePage,
+        ) as XAPIAgent,
+      };
     }
-    // Adapter is the WebAdapter dev fallback. Mirror the cmi5 'lms'
-    // dev-fallback path: install a stub publisher that surfaces an
-    // explicit error rather than silently no-oping. Authors get the
-    // same dev/prod parity in SCORM that they get in cmi5.
-    return { __scormDevFallback: 'scorm12' };
+    return { kind: 'scorm-fallback', standard: 'scorm12' };
   }
   if (config.export?.standard === 'scorm2004') {
     if (adapter instanceof SCORM2004Adapter) {
-      return synthesizeSCORM2004Actor(
-        adapter.getAPI(),
-        explicit.activityId,
-        explicit.actorAccountHomePage,
-      );
+      return {
+        kind: 'actor',
+        value: synthesizeSCORM2004Actor(
+          adapter.getAPI(),
+          explicit.activityId,
+          explicit.actorAccountHomePage,
+        ) as XAPIAgent,
+      };
     }
-    return { __scormDevFallback: 'scorm2004' };
+    return { kind: 'scorm-fallback', standard: 'scorm2004' };
   }
-  // Web export with no actor — build-time validator should have errored.
   console.warn(
     'Tessera xAPI: explicit destination has no actor and no derivation source — skipping.',
   );

package/dist/audit-BBJpQGqb.js

@@ -1,204 +0,0 @@
-import { o as generateManifest, r as normalizeA11y, s as readCourseConfig } from "./validation-B-xTvM9B.js";
-import { resolve } from "node:path";
-import { existsSync, writeFileSync } from "node:fs";
-//#region src/plugin/a11y/audit.ts
-const IMPACT_RANK = {
-	minor: 1,
-	moderate: 2,
-	serious: 3,
-	critical: 4
-};
-const AUDIT_ENV_FLAG = "TESSERA_A11Y_AUDIT";
-/** Map the `a11y.standard` enum to axe's cumulative `runOnly` tag list. */
-function axeTags(standard) {
-	switch (standard) {
-		case "wcag2a": return ["wcag2a"];
-		case "wcag21aa": return [
-			"wcag2a",
-			"wcag2aa",
-			"wcag21a",
-			"wcag21aa"
-		];
-		default: return ["wcag2a", "wcag2aa"];
-	}
-}
-/** axe-applicable ignore entries: drop the Tier-1a/1b namespaces. */
-function axeIgnoreRules(ignore) {
-	return ignore.filter((id) => !id.startsWith("tessera/") && !id.startsWith("a11y_"));
-}
-function isFailing(v, thresholdRank) {
-	return !v.impact || IMPACT_RANK[v.impact] >= thresholdRank;
-}
-async function tryImport(specifier) {
-	return import(specifier);
-}
-async function loadDeps() {
-	let chromium;
-	for (const spec of ["playwright", "@playwright/test"]) try {
-		const mod = await tryImport(spec);
-		if (mod.chromium) {
-			chromium = mod.chromium;
-			break;
-		}
-	} catch {}
-	if (!chromium) return {
-		ok: false,
-		missing: "playwright"
-	};
-	try {
-		const mod = await tryImport("@axe-core/playwright");
-		if (!mod.default) return {
-			ok: false,
-			missing: "@axe-core/playwright"
-		};
-		return {
-			ok: true,
-			deps: {
-				chromium,
-				AxeBuilder: mod.default
-			}
-		};
-	} catch {
-		return {
-			ok: false,
-			missing: "@axe-core/playwright"
-		};
-	}
-}
-/**
-* Run the Tier-2 runtime accessibility audit against a built course. Builds (or
-* reuses) dist/, serves it, drives Playwright + axe-core over each page, writes
-* a11y-report.json, and returns a process exit code (0 pass, 1 fail/error).
-*/
-async function runAudit(projectRoot, options = {}) {
-	const threshold = options.threshold ?? "serious";
-	const deps = await loadDeps();
-	if (!deps.ok) {
-		console.error("\x1B[31m[tessera a11y]\x1B[0m Tier 2 needs Playwright + axe-core, which aren't installed.\n  Install them to run the runtime audit:\n    npm i -D playwright @axe-core/playwright\n    npx playwright install chromium");
-		return 1;
-	}
-	const { chromium, AxeBuilder } = deps.deps;
-	const read = readCourseConfig(projectRoot);
-	const settings = normalizeA11y(read.ok ? read.config.a11y : void 0);
-	const tags = axeTags(settings.standard);
-	const disableRules = axeIgnoreRules(settings.ignore);
-	const manifest = generateManifest(resolve(projectRoot, "pages"));
-	const vite = await import("vite");
-	const auditDist = resolve(projectRoot, "node_modules", ".tessera-a11y");
-	const distHtml = resolve(auditDist, "index.html");
-	const prevEnv = process.env[AUDIT_ENV_FLAG];
-	process.env[AUDIT_ENV_FLAG] = "1";
-	let server;
-	try {
-		if (options.rebuild || !existsSync(distHtml)) {
-			console.log("[tessera a11y] Building course…");
-			await vite.build({
-				root: projectRoot,
-				build: {
-					outDir: auditDist,
-					emptyOutDir: true
-				},
-				logLevel: "warn"
-			});
-		}
-		server = await vite.preview({
-			root: projectRoot,
-			build: { outDir: auditDist },
-			preview: {
-				port: 0,
-				host: "127.0.0.1"
-			},
-			logLevel: "warn"
-		});
-		const baseUrl = server.resolvedUrls?.local?.[0];
-		if (!baseUrl) {
-			console.error("[tessera a11y] Could not determine preview server URL.");
-			return 1;
-		}
-		const browser = await chromium.launch();
-		const pages = [];
-		try {
-			const page = await (await browser.newContext()).newPage();
-			const auditUrl = new URL(baseUrl);
-			auditUrl.searchParams.set("__tessera_audit", "1");
-			await page.goto(auditUrl.href, { waitUntil: "networkidle" });
-			await page.waitForSelector("#tessera-app", { timeout: 2e4 });
-			const scan = async () => {
-				const builder = new AxeBuilder({ page }).withTags(tags);
-				if (disableRules.length > 0) builder.disableRules(disableRules);
-				return (await builder.analyze()).violations.map((v) => ({
-					id: v.id,
-					impact: v.impact ?? null,
-					help: v.help,
-					helpUrl: v.helpUrl,
-					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,
-					title,
-					violations: await scan()
-				});
-			}
-		} finally {
-			await browser.close();
-		}
-		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++;
-		}
-		const report = {
-			standard: settings.standard,
-			threshold,
-			pages,
-			totalViolations,
-			failingViolations,
-			passed: failingViolations === 0
-		};
-		const reportPath = resolve(projectRoot, "a11y-report.json");
-		writeFileSync(reportPath, JSON.stringify(report, null, 2), "utf-8");
-		printSummary(report, reportPath);
-		return report.passed ? 0 : 1;
-	} catch (err) {
-		console.error(`\x1b[31m[tessera a11y]\x1b[0m Audit could not complete: ${err instanceof Error ? err.message : String(err)}`);
-		return 1;
-	} finally {
-		server?.httpServer?.close?.();
-		if (prevEnv === void 0) delete process.env[AUDIT_ENV_FLAG];
-		else process.env[AUDIT_ENV_FLAG] = prevEnv;
-	}
-}
-function printSummary(report, reportPath) {
-	const thresholdRank = IMPACT_RANK[report.threshold];
-	for (const p of report.pages) {
-		if (p.violations.length === 0) {
-			console.log(`\x1b[32m  ✓\x1b[0m ${p.title}`);
-			continue;
-		}
-		const mark = p.violations.some((v) => isFailing(v, thresholdRank)) ? "\x1B[31m  ✗\x1B[0m" : "\x1B[33m  ⚠\x1B[0m";
-		console.log(`${mark} ${p.title}`);
-		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.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).`);
-}
-//#endregion
-export { runAudit as n, AUDIT_ENV_FLAG as t };
-
-//# sourceMappingURL=audit-BBJpQGqb.js.map

package/dist/audit-BBJpQGqb.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"audit-BBJpQGqb.js","names":[],"sources":["../src/plugin/a11y/audit.ts"],"sourcesContent":["import { existsSync, writeFileSync } from 'node:fs';\nimport { resolve } from 'node:path';\nimport { generateManifest, readCourseConfig } from '../manifest.js';\nimport { normalizeA11y, type A11ySettings } from '../validation.js';\n\nexport interface AuditOptions {\n  /** Minimum violation impact that fails the run (CI gate). Default 'serious'. */\n  threshold?: ImpactLevel;\n  /** Force a fresh `vite build` even if dist/ exists. */\n  rebuild?: boolean;\n}\n\nexport type ImpactLevel = 'minor' | 'moderate' | 'serious' | 'critical';\n\nconst IMPACT_RANK: Record<ImpactLevel, number> = {\n  minor: 1,\n  moderate: 2,\n  serious: 3,\n  critical: 4,\n};\n\n// Set by runAudit during its build/preview; the plugin forces the WebAdapter,\n// skips export packaging, and stubs xAPI while it's set. See plugin/index.ts.\nexport const AUDIT_ENV_FLAG = 'TESSERA_A11Y_AUDIT';\n\ninterface AxeViolation {\n  id: string;\n  impact: ImpactLevel | null;\n  help: string;\n  helpUrl: string;\n  nodes: number;\n}\n\ninterface PageAuditResult {\n  index: number;\n  title: string;\n  violations: AxeViolation[];\n}\n\ninterface AuditReport {\n  standard: A11ySettings['standard'];\n  threshold: ImpactLevel;\n  pages: PageAuditResult[];\n  totalViolations: number;\n  failingViolations: number;\n  passed: boolean;\n}\n\n/** Map the `a11y.standard` enum to axe's cumulative `runOnly` tag list. */\nexport function axeTags(standard: A11ySettings['standard']): string[] {\n  switch (standard) {\n    case 'wcag2a':\n      return ['wcag2a'];\n    case 'wcag21aa':\n      return ['wcag2a', 'wcag2aa', 'wcag21a', 'wcag21aa'];\n    case 'wcag2aa':\n    default:\n      return ['wcag2a', 'wcag2aa'];\n  }\n}\n\n/** axe-applicable ignore entries: drop the Tier-1a/1b namespaces. */\nexport function axeIgnoreRules(ignore: string[]): string[] {\n  return ignore.filter(\n    (id) => !id.startsWith('tessera/') && !id.startsWith('a11y_'),\n  );\n}\n\n// A violation with no impact is treated as failing rather than slipping the\n// gate at every threshold.\nfunction isFailing(v: AxeViolation, thresholdRank: number): boolean {\n  return !v.impact || IMPACT_RANK[v.impact] >= thresholdRank;\n}\n\n// Optional deps loaded by variable specifier so tsc doesn't require them to be\n// installed — Tier 2 is opt-in and the absence is handled with a clear message.\nasync function tryImport(specifier: string): Promise<unknown> {\n  return import(specifier);\n}\n\ninterface LoadedDeps {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  chromium: any;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  AxeBuilder: any;\n}\n\nasync function loadDeps(): Promise<\n  { ok: true; deps: LoadedDeps } | { ok: false; missing: string }\n> {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let chromium: any;\n  for (const spec of ['playwright', '@playwright/test']) {\n    try {\n      const mod = (await tryImport(spec)) as { chromium?: unknown };\n      if (mod.chromium) {\n        chromium = mod.chromium;\n        break;\n      }\n    } catch {\n      // try the next specifier\n    }\n  }\n  if (!chromium) return { ok: false, missing: 'playwright' };\n\n  try {\n    const mod = (await tryImport('@axe-core/playwright')) as {\n      default?: unknown;\n    };\n    if (!mod.default) return { ok: false, missing: '@axe-core/playwright' };\n    return { ok: true, deps: { chromium, AxeBuilder: mod.default } };\n  } catch {\n    return { ok: false, missing: '@axe-core/playwright' };\n  }\n}\n\n/**\n * Run the Tier-2 runtime accessibility audit against a built course. Builds (or\n * reuses) dist/, serves it, drives Playwright + axe-core over each page, writes\n * a11y-report.json, and returns a process exit code (0 pass, 1 fail/error).\n */\nexport async function runAudit(\n  projectRoot: string,\n  options: AuditOptions = {},\n): Promise<number> {\n  const threshold: ImpactLevel = options.threshold ?? 'serious';\n\n  const deps = await loadDeps();\n  if (!deps.ok) {\n    console.error(\n      `\\x1b[31m[tessera a11y]\\x1b[0m Tier 2 needs Playwright + axe-core, which aren't installed.\\n` +\n        `  Install them to run the runtime audit:\\n` +\n        `    npm i -D playwright @axe-core/playwright\\n` +\n        `    npx playwright install chromium`,\n    );\n    return 1;\n  }\n  const { chromium, AxeBuilder } = deps.deps;\n\n  const read = readCourseConfig(projectRoot);\n  const settings = normalizeA11y(read.ok ? read.config.a11y : undefined);\n  const tags = axeTags(settings.standard);\n  const disableRules = axeIgnoreRules(settings.ignore);\n\n  const manifest = generateManifest(resolve(projectRoot, 'pages'));\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const vite = (await import('vite')) as any;\n\n  // A throwaway web build, kept out of dist/ so a real LMS export is untouched.\n  const auditDist = resolve(projectRoot, 'node_modules', '.tessera-a11y');\n  const distHtml = resolve(auditDist, 'index.html');\n\n  const prevEnv = process.env[AUDIT_ENV_FLAG];\n  process.env[AUDIT_ENV_FLAG] = '1';\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let server: any;\n  try {\n    if (options.rebuild || !existsSync(distHtml)) {\n      console.log('[tessera a11y] Building course…');\n      await vite.build({\n        root: projectRoot,\n        build: { outDir: auditDist, emptyOutDir: true },\n        logLevel: 'warn',\n      });\n    }\n\n    server = await vite.preview({\n      root: projectRoot,\n      build: { outDir: auditDist },\n      preview: { port: 0, host: '127.0.0.1' },\n      logLevel: 'warn',\n    });\n    const baseUrl: string | undefined = server.resolvedUrls?.local?.[0];\n    if (!baseUrl) {\n      console.error('[tessera a11y] Could not determine preview server URL.');\n      return 1;\n    }\n\n    const browser = await chromium.launch();\n    const pages: PageAuditResult[] = [];\n    try {\n      // axe-core/playwright requires a page from an explicit context.\n      const context = await browser.newContext();\n      const page = await context.newPage();\n      // ?__tessera_audit unlocks navigation so quiz-gated pages can be scanned.\n      const auditUrl = new URL(baseUrl);\n      auditUrl.searchParams.set('__tessera_audit', '1');\n      await page.goto(auditUrl.href, { waitUntil: 'networkidle' });\n      await page.waitForSelector('#tessera-app', { timeout: 20_000 });\n\n      const scan = async (): Promise<AxeViolation[]> => {\n        const builder = new AxeBuilder({ page }).withTags(tags);\n        if (disableRules.length > 0) builder.disableRules(disableRules);\n        const out = await builder.analyze();\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        return out.violations.map((v: any) => ({\n          id: v.id,\n          impact: v.impact ?? null,\n          help: v.help,\n          helpUrl: v.helpUrl,\n          nodes: v.nodes.length,\n        }));\n      };\n\n      const navCount = await page.locator('button.tessera-nav-page').count();\n      if (navCount === 0) {\n        // No sidebar (custom chrome) — audit whatever is rendered at the entry.\n        pages.push({\n          index: 0,\n          title: manifest.pages[0]?.title ?? '(entry)',\n          violations: await scan(),\n        });\n      } else {\n        for (let i = 0; i < navCount; i++) {\n          const btn = page.locator('button.tessera-nav-page').nth(i);\n          const title = (await btn.textContent())?.trim() || `Page ${i + 1}`;\n          await btn.click();\n          await page.waitForFunction(\n            (idx: number) =>\n              document\n                .querySelectorAll('button.tessera-nav-page')\n                [idx]?.getAttribute('aria-current') === 'page',\n            i,\n            { timeout: 20_000 },\n          );\n          await page.waitForLoadState('networkidle');\n          pages.push({ index: i, title, violations: await scan() });\n        }\n      }\n    } finally {\n      await browser.close();\n    }\n\n    const thresholdRank = IMPACT_RANK[threshold];\n    let totalViolations = 0;\n    let failingViolations = 0;\n    for (const p of pages) {\n      for (const v of p.violations) {\n        totalViolations++;\n        if (isFailing(v, thresholdRank)) failingViolations++;\n      }\n    }\n\n    const report: AuditReport = {\n      standard: settings.standard,\n      threshold,\n      pages,\n      totalViolations,\n      failingViolations,\n      passed: failingViolations === 0,\n    };\n    const reportPath = resolve(projectRoot, 'a11y-report.json');\n    writeFileSync(reportPath, JSON.stringify(report, null, 2), 'utf-8');\n\n    printSummary(report, reportPath);\n    return report.passed ? 0 : 1;\n  } catch (err) {\n    console.error(\n      `\\x1b[31m[tessera a11y]\\x1b[0m Audit could not complete: ${\n        err instanceof Error ? err.message : String(err)\n      }`,\n    );\n    return 1;\n  } finally {\n    server?.httpServer?.close?.();\n    if (prevEnv === undefined) delete process.env[AUDIT_ENV_FLAG];\n    else process.env[AUDIT_ENV_FLAG] = prevEnv;\n  }\n}\n\nfunction printSummary(report: AuditReport, reportPath: string): void {\n  const thresholdRank = IMPACT_RANK[report.threshold];\n  for (const p of report.pages) {\n    if (p.violations.length === 0) {\n      console.log(`\\x1b[32m  ✓\\x1b[0m ${p.title}`);\n      continue;\n    }\n    const failing = p.violations.some((v) => isFailing(v, thresholdRank));\n    const mark = failing ? '\\x1b[31m  ✗\\x1b[0m' : '\\x1b[33m  ⚠\\x1b[0m';\n    console.log(`${mark} ${p.title}`);\n    for (const v of p.violations) {\n      console.log(\n        `      [${v.impact ?? 'n/a'}] ${v.id} — ${v.help} (${v.nodes} node${v.nodes === 1 ? '' : 's'})`,\n      );\n    }\n  }\n  console.log(`\\n[tessera a11y] Report written to ${reportPath}`);\n  if (report.passed) {\n    console.log(\n      `\\x1b[32m[tessera a11y] Passed\\x1b[0m — ${report.totalViolations} total finding(s), none at/above \"${report.threshold}\".`,\n    );\n  } else {\n    console.log(\n      `\\x1b[31m[tessera a11y] Failed\\x1b[0m — ${report.failingViolations} finding(s) at/above \"${report.threshold}\" (of ${report.totalViolations} total).`,\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/plugin/a11y-cli.d.ts

@@ -1 +0,0 @@
-export { };

package/dist/plugin/a11y-cli.js

@@ -1,36 +0,0 @@
-#!/usr/bin/env node
-import { n as runAudit } from "../audit-BBJpQGqb.js";
-//#region src/plugin/a11y-cli.ts
-const VALID_THRESHOLDS = [
-	"minor",
-	"moderate",
-	"serious",
-	"critical"
-];
-const args = process.argv.slice(2);
-let threshold;
-let rebuild = false;
-for (let i = 0; i < args.length; i++) {
-	const arg = args[i];
-	if (arg === "--threshold") {
-		const value = args[++i];
-		if (!VALID_THRESHOLDS.includes(value)) {
-			console.error(`[tessera a11y] --threshold must be one of: ${VALID_THRESHOLDS.join(", ")}`);
-			process.exit(1);
-		}
-		threshold = value;
-	} else if (arg === "--build") rebuild = true;
-	else {
-		console.error(`[tessera a11y] Unknown argument: ${arg}`);
-		process.exit(1);
-	}
-}
-const code = await runAudit(process.cwd(), {
-	threshold,
-	rebuild
-});
-process.exit(code);
-//#endregion
-export {};
-
-//# sourceMappingURL=a11y-cli.js.map

package/dist/plugin/a11y-cli.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"a11y-cli.js","names":[],"sources":["../../src/plugin/a11y-cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { runAudit, type ImpactLevel } from './a11y/audit.js';\n\nconst VALID_THRESHOLDS: ImpactLevel[] = [\n  'minor',\n  'moderate',\n  'serious',\n  'critical',\n];\n\nconst args = process.argv.slice(2);\nlet threshold: ImpactLevel | undefined;\nlet rebuild = false;\n\nfor (let i = 0; i < args.length; i++) {\n  const arg = args[i];\n  if (arg === '--threshold') {\n    const value = args[++i] as ImpactLevel;\n    if (!VALID_THRESHOLDS.includes(value)) {\n      console.error(\n        `[tessera a11y] --threshold must be one of: ${VALID_THRESHOLDS.join(', ')}`,\n      );\n      process.exit(1);\n    }\n    threshold = value;\n  } else if (arg === '--build') {\n    rebuild = true;\n  } else {\n    console.error(`[tessera a11y] Unknown argument: ${arg}`);\n    process.exit(1);\n  }\n}\n\nconst code = await runAudit(process.cwd(), { threshold, rebuild });\nprocess.exit(code);\n"],"mappings":";;;AAGA,MAAM,mBAAkC;CACtC;CACA;CACA;CACA;CACD;AAED,MAAM,OAAO,QAAQ,KAAK,MAAM,EAAE;AAClC,IAAI;AACJ,IAAI,UAAU;AAEd,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;CACpC,MAAM,MAAM,KAAK;CACjB,IAAI,QAAQ,eAAe;EACzB,MAAM,QAAQ,KAAK,EAAE;EACrB,IAAI,CAAC,iBAAiB,SAAS,MAAM,EAAE;GACrC,QAAQ,MACN,8CAA8C,iBAAiB,KAAK,KAAK,GAC1E;GACD,QAAQ,KAAK,EAAE;;EAEjB,YAAY;QACP,IAAI,QAAQ,WACjB,UAAU;MACL;EACL,QAAQ,MAAM,oCAAoC,MAAM;EACxD,QAAQ,KAAK,EAAE;;;AAInB,MAAM,OAAO,MAAM,SAAS,QAAQ,KAAK,EAAE;CAAE;CAAW;CAAS,CAAC;AAClE,QAAQ,KAAK,KAAK"}