tessera-learn 0.0.10 → 0.0.13

package/dist/plugin/index.js

@@ -1,11 +1,12 @@
-import { n as extractDefaultExportObjectLiteral, r as generateManifest, t as validateProject } from "../validation-BxWAMMnJ.js";
+import { a as validateProject, i as reportValidationIssues, n as isPlausibleLanguageTag, o as generateManifest, r as normalizeA11y, s as readCourseConfig, t as isIgnored } from "../validation-B-xTvM9B.js";
+import { n as runAudit, t as AUDIT_ENV_FLAG } from "../audit-BBJpQGqb.js";
 import { svelte } from "@sveltejs/vite-plugin-svelte";
 import { fileURLToPath } from "node:url";
-import { dirname, resolve } from "node:path";
-import { cpSync, createWriteStream, existsSync, mkdirSync, readFileSync, readdirSync, statSync, unlinkSync, writeFileSync } from "node:fs";
-import JSON5 from "json5";
+import { dirname, isAbsolute, relative, resolve } from "node:path";
+import { cpSync, createWriteStream, existsSync, mkdirSync, readdirSync, statSync, unlinkSync, writeFileSync } from "node:fs";
 import { createHash } from "node:crypto";
 import { ZipArchive } from "archiver";
+import { normalizePath } from "vite";
 //#region src/runtime/slugify.ts
 /**
 * Slugify a string for use as a URL-safe / filename-safe identifier.
@@ -151,77 +152,78 @@ function cleanOldZips(projectRoot, slug) {
 		} catch {}
 	} catch {}
 }
+/** Packaged (zipped) export targets: which manifest file to write and how. */
+const PACKAGED_EXPORTS = {
+	scorm12: {
+		manifestFile: "imsmanifest.xml",
+		label: "SCORM 1.2",
+		generate: generateSCORM12Manifest
+	},
+	scorm2004: {
+		manifestFile: "imsmanifest.xml",
+		label: "SCORM 2004",
+		generate: generateSCORM2004Manifest
+	},
+	cmi5: {
+		manifestFile: "cmi5.xml",
+		label: "CMI5",
+		generate: (config) => generateCMI5Xml(config)
+	}
+};
 async function runExport(projectRoot, config) {
 	const distDir = resolve(projectRoot, "dist");
 	const standard = config.export?.standard || "web";
 	const slug = slugify(config.title || "tessera-course") || "tessera-course";
 	const zipName = `${slug}-${config.version || "1.0.0"}.zip`;
 	const zipPath = resolve(projectRoot, zipName);
-	switch (standard) {
-		case "web": {
-			const files = collectFiles(distDir);
-			let totalSize = 0;
-			for (const f of files) totalSize += statSync(resolve(distDir, f)).size;
-			console.log(`✓ Web export: dist/ (${formatSize(totalSize)})`);
-			break;
-		}
-		case "scorm12": {
-			const manifest = generateSCORM12Manifest(config, distDir);
-			writeFileSync(resolve(distDir, "imsmanifest.xml"), manifest, "utf-8");
-			cleanOldZips(projectRoot, slug);
-			const zipSize = await createZip(distDir, zipPath);
-			console.log(`✓ SCORM 1.2 export: ${zipName} (${formatSize(zipSize)})`);
-			break;
-		}
-		case "scorm2004": {
-			const manifest = generateSCORM2004Manifest(config, distDir);
-			writeFileSync(resolve(distDir, "imsmanifest.xml"), manifest, "utf-8");
-			cleanOldZips(projectRoot, slug);
-			const zipSize = await createZip(distDir, zipPath);
-			console.log(`✓ SCORM 2004 export: ${zipName} (${formatSize(zipSize)})`);
-			break;
-		}
-		case "cmi5": {
-			const xml = generateCMI5Xml(config);
-			writeFileSync(resolve(distDir, "cmi5.xml"), xml, "utf-8");
-			cleanOldZips(projectRoot, slug);
-			const zipSize = await createZip(distDir, zipPath);
-			console.log(`✓ CMI5 export: ${zipName} (${formatSize(zipSize)})`);
-			break;
-		}
+	if (standard === "web") {
+		const files = collectFiles(distDir);
+		let totalSize = 0;
+		for (const f of files) totalSize += statSync(resolve(distDir, f)).size;
+		console.log(`✓ Web export: dist/ (${formatSize(totalSize)})`);
+		return;
 	}
+	const spec = PACKAGED_EXPORTS[standard];
+	if (!spec) return;
+	writeFileSync(resolve(distDir, spec.manifestFile), spec.generate(config, distDir), "utf-8");
+	cleanOldZips(projectRoot, slug);
+	const zipSize = await createZip(distDir, zipPath);
+	console.log(`✓ ${spec.label} export: ${zipName} (${formatSize(zipSize)})`);
 }
 //#endregion
-//#region src/plugin/layout.ts
-const VIRTUAL_LAYOUT_ID = "virtual:tessera-layout";
-const RESOLVED_LAYOUT_ID = "\0" + VIRTUAL_LAYOUT_ID;
-function tesseraLayoutPlugin() {
-	let projectRoot;
+//#region src/plugin/override-plugin.ts
+/**
+* A virtual module that resolves to a project-root override file when present,
+* and to the built-in (or a null export) otherwise. Shared by the layout and
+* quiz plugins — they differ only in the virtual id, file name, and built-in.
+*/
+function createOverridePlugin({ name, virtualId, projectFile, builtinFile }) {
+	const resolvedId = "\0" + virtualId;
+	const fallback = builtinFile ? `export { default } from '${normalizePath(builtinFile)}';` : "export default null;";
+	let filePath;
 	return {
-		name: "tessera:layout",
+		name,
 		enforce: "pre",
 		configResolved(config) {
-			projectRoot = config.root;
+			filePath = resolve(config.root, projectFile);
 		},
 		resolveId(id) {
-			if (id === VIRTUAL_LAYOUT_ID) return RESOLVED_LAYOUT_ID;
+			if (id === virtualId) return resolvedId;
 			return null;
 		},
 		load(id) {
-			if (id !== RESOLVED_LAYOUT_ID) return null;
-			const layoutPath = resolve(projectRoot, "layout.svelte");
-			if (existsSync(layoutPath)) {
-				this.addWatchFile(layoutPath);
-				return `export { default } from '${layoutPath.replace(/\\/g, "/")}';`;
+			if (id !== resolvedId) return null;
+			if (existsSync(filePath)) {
+				this.addWatchFile(filePath);
+				return `export { default } from '${normalizePath(filePath)}';`;
 			}
-			return `export default null;`;
+			return fallback;
 		},
 		configureServer(server) {
-			const layoutPath = resolve(projectRoot, "layout.svelte");
-			server.watcher.on("all", (event, filePath) => {
-				if (filePath !== layoutPath) return;
+			server.watcher.on("all", (event, changed) => {
+				if (changed !== filePath) return;
 				if (event !== "add" && event !== "unlink") return;
-				const mod = server.moduleGraph.getModuleById(RESOLVED_LAYOUT_ID);
+				const mod = server.moduleGraph.getModuleById(resolvedId);
 				if (mod) server.moduleGraph.invalidateModule(mod);
 				server.ws.send({ type: "full-reload" });
 			});
@@ -229,51 +231,30 @@ function tesseraLayoutPlugin() {
 	};
 }
 //#endregion
+//#region src/plugin/layout.ts
+function tesseraLayoutPlugin() {
+	return createOverridePlugin({
+		name: "tessera:layout",
+		virtualId: "virtual:tessera-layout",
+		projectFile: "layout.svelte"
+	});
+}
+//#endregion
 //#region src/plugin/quiz.ts
-const VIRTUAL_QUIZ_ID = "virtual:tessera-quiz";
-const RESOLVED_QUIZ_ID = "\0" + VIRTUAL_QUIZ_ID;
 const __dirname$1 = dirname(fileURLToPath(import.meta.url));
-/**
-* Resolve the project's quiz shell.
-* `projectRoot/quiz.svelte` overrides the built-in `<Quiz>` if it exists,
-* otherwise the built-in is used. Mirrors `tesseraLayoutPlugin` (Phase 3A).
-*/
 function tesseraQuizPlugin() {
-	let projectRoot;
-	const builtinQuiz = resolve(resolve(__dirname$1, "..", ".."), "src", "components", "Quiz.svelte");
-	return {
+	return createOverridePlugin({
 		name: "tessera:quiz",
-		enforce: "pre",
-		configResolved(config) {
-			projectRoot = config.root;
-		},
-		resolveId(id) {
-			if (id === VIRTUAL_QUIZ_ID) return RESOLVED_QUIZ_ID;
-			return null;
-		},
-		load(id) {
-			if (id !== RESOLVED_QUIZ_ID) return null;
-			const userQuizPath = resolve(projectRoot, "quiz.svelte");
-			if (existsSync(userQuizPath)) {
-				this.addWatchFile(userQuizPath);
-				return `export { default } from '${userQuizPath.replace(/\\/g, "/")}';`;
-			}
-			return `export { default } from '${builtinQuiz.replace(/\\/g, "/")}';`;
-		},
-		configureServer(server) {
-			const userQuizPath = resolve(projectRoot, "quiz.svelte");
-			server.watcher.on("all", (event, filePath) => {
-				if (filePath !== userQuizPath) return;
-				if (event !== "add" && event !== "unlink") return;
-				const mod = server.moduleGraph.getModuleById(RESOLVED_QUIZ_ID);
-				if (mod) server.moduleGraph.invalidateModule(mod);
-				server.ws.send({ type: "full-reload" });
-			});
-		}
-	};
+		virtualId: "virtual:tessera-quiz",
+		projectFile: "quiz.svelte",
+		builtinFile: resolve(resolve(__dirname$1, "..", ".."), "src", "components", "Quiz.svelte")
+	});
 }
 //#endregion
 //#region src/plugin/index.ts
+function isAuditBuild() {
+	return process.env[AUDIT_ENV_FLAG] === "1";
+}
 const __dirname = dirname(fileURLToPath(import.meta.url));
 function resolveRuntimeDir() {
 	return resolve(resolve(__dirname, "..", ".."), "src", "runtime");
@@ -281,13 +262,44 @@ function resolveRuntimeDir() {
 function resolveStylesDir() {
 	return resolve(resolve(__dirname, "..", ".."), "styles");
 }
+function projectFileRel(filename, projectRoot) {
+	if (!filename || !projectRoot) return null;
+	if (filename.startsWith("\0") || filename.includes("virtual:") || filename.includes("node_modules")) return null;
+	const rel = relative(projectRoot, isAbsolute(filename) ? filename : resolve(projectRoot, filename));
+	if (rel.startsWith("..") || isAbsolute(rel) || rel.includes("node_modules")) return null;
+	return rel;
+}
 function tesseraPlugin() {
 	const manifestRef = {
 		current: null,
 		root: ""
 	};
+	const a11y = {
+		warnings: [],
+		projectRoot: "",
+		isBuild: false,
+		settings: normalizeA11y(void 0)
+	};
 	return [
-		svelte({ compilerOptions: { css: "external" } }),
+		svelte({
+			compilerOptions: { css: "external" },
+			onwarn(warning, defaultHandler) {
+				if (warning.code?.startsWith("a11y")) {
+					const rel = projectFileRel(warning.filename, a11y.projectRoot);
+					if (rel !== null) {
+						const msg = `[${warning.code}] ${rel}: ${warning.message}`;
+						if (a11y.isBuild) a11y.warnings.push(msg);
+						else if (!a11y.settings.ignore.includes(warning.code)) reportValidationIssues({
+							errors: [],
+							warnings: [msg]
+						});
+					}
+					return;
+				}
+				defaultHandler?.(warning);
+			}
+		}),
+		tesseraA11yCompilerPlugin(a11y),
 		tesseraValidationPlugin(),
 		tesseraEntryPlugin(),
 		tesseraConfigPlugin(),
@@ -310,16 +322,18 @@ function tesseraEntryPlugin() {
 	const stylesDir = resolveStylesDir();
 	const appSveltePath = resolve(runtimeDir, "App.svelte");
 	let projectRoot;
+	let outDir;
 	let isBuild = false;
 	return {
 		name: "tessera:entry",
 		enforce: "pre",
 		configResolved(config) {
 			projectRoot = config.root;
+			outDir = resolve(config.root, config.build.outDir);
 			isBuild = config.command === "build";
 		},
 		buildStart() {
-			if (isBuild) writeFileSync(resolve(projectRoot, "index.html"), generateIndexHtml(), "utf-8");
+			if (isBuild) writeFileSync(resolve(projectRoot, "index.html"), generateIndexHtml(readLanguage(projectRoot)), "utf-8");
 		},
 		closeBundle() {
 			if (isBuild) {
@@ -328,7 +342,7 @@ function tesseraEntryPlugin() {
 					unlinkSync(htmlPath);
 				} catch {}
 				const assetsDir = resolve(projectRoot, "assets");
-				const distAssetsDir = resolve(projectRoot, "dist", "assets");
+				const distAssetsDir = resolve(outDir, "assets");
 				if (existsSync(assetsDir)) {
 					mkdirSync(distAssetsDir, { recursive: true });
 					cpSync(assetsDir, distAssetsDir, { recursive: true });
@@ -339,7 +353,7 @@ function tesseraEntryPlugin() {
 			return () => {
 				server.middlewares.use(async (req, res, next) => {
 					if (req.url === "/" || req.url === "/index.html") {
-						const html = generateIndexHtml();
+						const html = generateIndexHtml(readLanguage(projectRoot));
 						const transformed = await server.transformIndexHtml(req.url, html);
 						res.setHeader("Content-Type", "text/html");
 						res.statusCode = 200;
@@ -361,9 +375,14 @@ function tesseraEntryPlugin() {
 		}
 	};
 }
-function generateIndexHtml() {
+function readLanguage(projectRoot) {
+	const read = readCourseConfig(projectRoot);
+	const lang = read.ok ? read.config.language : void 0;
+	return isPlausibleLanguageTag(lang) ? lang : "en";
+}
+function generateIndexHtml(lang) {
 	return `<!DOCTYPE html>
-<html lang="en">
+<html lang="${lang}">
 <head>
   <meta charset="UTF-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
@@ -421,7 +440,8 @@ function tesseraConfigPlugin() {
 		config(config) {
 			return {
 				base: "./",
-				resolve: { alias: { "$assets": resolve(config.root || process.cwd(), "assets") } },
+				build: { assetsDir: "tessera" },
+				resolve: { alias: { $assets: resolve(config.root || process.cwd(), "assets") } },
 				optimizeDeps: { exclude: ["tessera-learn"] }
 			};
 		},
@@ -435,14 +455,9 @@ function tesseraConfigPlugin() {
 		load(id) {
 			if (id === RESOLVED_CONFIG_ID) {
 				const configPath = resolve(projectRoot, "course.config.js");
-				let userConfig = {};
-				if (existsSync(configPath)) {
-					this.addWatchFile(configPath);
-					const objectStr = extractDefaultExportObjectLiteral(readFileSync(configPath, "utf-8"));
-					if (objectStr) try {
-						userConfig = JSON5.parse(objectStr);
-					} catch {}
-				}
+				if (existsSync(configPath)) this.addWatchFile(configPath);
+				const read = readCourseConfig(projectRoot);
+				const userConfig = read.ok ? read.config : {};
 				const { completion, passingScore } = completionDefaults(userConfig.completion?.mode);
 				const merged = {
 					title: userConfig.title || "Untitled Course",
@@ -516,13 +531,40 @@ function tesseraValidationPlugin() {
 		}
 	};
 }
+function tesseraA11yCompilerPlugin(a11y) {
+	return {
+		name: "tessera:a11y-compiler",
+		enforce: "pre",
+		configResolved(config) {
+			a11y.projectRoot = config.root;
+			a11y.isBuild = config.command === "build";
+			const read = readCourseConfig(config.root);
+			a11y.settings = normalizeA11y(read.ok ? read.config.a11y : void 0);
+		},
+		buildEnd() {
+			if (!a11y.isBuild || a11y.warnings.length === 0) return;
+			const ignored = new Set(a11y.settings.ignore);
+			const warnings = a11y.warnings.filter((msg) => !isIgnored(msg, ignored));
+			a11y.warnings = [];
+			if (warnings.length === 0) return;
+			if (a11y.settings.level === "error") {
+				reportValidationIssues({
+					errors: warnings,
+					warnings: []
+				});
+				throw new Error(`Tessera: ${warnings.length} a11y issue(s) with a11y.level: 'error'. Fix the errors above to continue.`);
+			}
+			reportValidationIssues({
+				errors: [],
+				warnings
+			});
+		}
+	};
+}
 function runValidation(projectRoot) {
-	const { errors, warnings } = validateProject(projectRoot);
-	for (const warning of warnings) console.warn(`\x1b[33m[tessera warning]\x1b[0m ${warning}`);
-	if (errors.length > 0) {
-		for (const error of errors) console.error(`\x1b[31m[tessera error]\x1b[0m ${error}`);
-		throw new Error(`Tessera validation failed with ${errors.length} error(s). Fix the errors above to continue.`);
-	}
+	const result = validateProject(projectRoot);
+	reportValidationIssues(result);
+	if (result.errors.length > 0) throw new Error(`Tessera validation failed with ${result.errors.length} error(s). Fix the errors above to continue.`);
 }
 function tesseraExportPlugin() {
 	let projectRoot;
@@ -536,17 +578,14 @@ function tesseraExportPlugin() {
 		},
 		async closeBundle() {
 			if (!isBuild) return;
-			const configPath = resolve(projectRoot, "course.config.js");
-			if (!existsSync(configPath)) throw new Error("[tessera:export] course.config.js not found at closeBundle. The file must exist for the export step to run.");
-			const objectStr = extractDefaultExportObjectLiteral(readFileSync(configPath, "utf-8"));
-			if (!objectStr) throw new Error("[tessera:export] course.config.js: could not locate `export default { ... }`. Cannot determine export.standard.");
-			let config;
-			try {
-				config = JSON5.parse(objectStr);
-			} catch (err) {
-				throw new Error(`[tessera:export] course.config.js: failed to parse export-default object literal — ${err.message}`);
+			if (isAuditBuild()) return;
+			const read = readCourseConfig(projectRoot);
+			if (!read.ok) {
+				if (read.reason === "missing") throw new Error("[tessera:export] course.config.js not found at closeBundle. The file must exist for the export step to run.");
+				if (read.reason === "no-export") throw new Error("[tessera:export] course.config.js: could not locate `export default { ... }`. Cannot determine export.standard.");
+				throw new Error(`[tessera:export] course.config.js: failed to parse export-default object literal — ${read.error.message}`);
 			}
-			await runExport(projectRoot, config);
+			await runExport(projectRoot, read.config);
 		}
 	};
 }
@@ -620,14 +659,9 @@ function tesseraAdapterPlugin() {
 			if (id !== RESOLVED_ADAPTER_ID) return null;
 			if (!isBuild) return `export { createAdapter } from 'tessera-learn/runtime/adapters/index.js';`;
 			let standard = "web";
-			const configPath = resolve(projectRoot, "course.config.js");
-			if (existsSync(configPath)) {
-				const objectStr = extractDefaultExportObjectLiteral(readFileSync(configPath, "utf-8"));
-				if (objectStr) try {
-					const parsed = JSON5.parse(objectStr);
-					if (typeof parsed?.export?.standard === "string") standard = parsed.export.standard;
-				} catch {}
-			}
+			const read = readCourseConfig(projectRoot);
+			if (read.ok && typeof read.config.export?.standard === "string") standard = read.config.export.standard;
+			if (isAuditBuild()) standard = "web";
 			switch (standard) {
 				case "scorm12": return `
 import { SCORM12Adapter } from 'tessera-learn/runtime/adapters/scorm12.js';
@@ -687,16 +721,13 @@ function tesseraXAPISetupPlugin() {
 		load(id) {
 			if (id !== RESOLVED_XAPI_SETUP_ID) return null;
 			if (!isBuild) return `export { buildXAPIClient } from 'tessera-learn/runtime/xapi/setup.js';`;
+			if (isAuditBuild()) return `export async function buildXAPIClient() { return null; }`;
 			let standard = "web";
 			let hasXapi = false;
-			const configPath = resolve(projectRoot, "course.config.js");
-			if (existsSync(configPath)) {
-				const objectStr = extractDefaultExportObjectLiteral(readFileSync(configPath, "utf-8"));
-				if (objectStr) try {
-					const parsed = JSON5.parse(objectStr);
-					if (typeof parsed?.export?.standard === "string") standard = parsed.export.standard;
-					hasXapi = parsed?.xapi != null;
-				} catch {}
+			const read = readCourseConfig(projectRoot);
+			if (read.ok) {
+				if (typeof read.config.export?.standard === "string") standard = read.config.export.standard;
+				hasXapi = read.config.xapi != null;
 			}
 			if (hasXapi || standard === "cmi5") return `export { buildXAPIClient } from 'tessera-learn/runtime/xapi/setup.js';`;
 			return `export async function buildXAPIClient() { return null; }`;
@@ -728,6 +759,6 @@ function tesseraFirstPagePreloadPlugin(manifestRef) {
 	};
 }
 //#endregion
-export { tesseraPlugin };
+export { runAudit, tesseraPlugin };
 
 //# sourceMappingURL=index.js.map