tessera-learn 0.0.9 → 0.0.11

package/dist/plugin/cli.js

@@ -1,9 +1,11 @@
 #!/usr/bin/env node
-import { t as validateProject } from "../validation-BxWAMMnJ.js";
+import { n as validateProject, t as reportValidationIssues } from "../validation-D9DXlqNP.js";
 //#region src/plugin/cli.ts
 const { errors, warnings } = validateProject(process.cwd());
-for (const warning of warnings) console.warn(`\x1b[33m[tessera warning]\x1b[0m ${warning}`);
-for (const error of errors) console.error(`\x1b[31m[tessera error]\x1b[0m ${error}`);
+reportValidationIssues({
+	errors,
+	warnings
+});
 if (errors.length > 0) {
 	const summary = `Validation failed with ${errors.length} error(s)` + (warnings.length > 0 ? ` and ${warnings.length} warning(s)` : "") + ".";
 	console.error(`\n\x1b[31m${summary}\x1b[0m`);

package/dist/plugin/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","names":[],"sources":["../../src/plugin/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { validateProject } from './validation.js';\n\nconst projectRoot = process.cwd();\nconst { errors, warnings } = validateProject(projectRoot);\n\nfor (const warning of warnings) {\n  console.warn(`\\x1b[33m[tessera warning]\\x1b[0m ${warning}`);\n}\nfor (const error of errors) {\n  console.error(`\\x1b[31m[tessera error]\\x1b[0m ${error}`);\n}\n\nif (errors.length > 0) {\n  const summary =\n    `Validation failed with ${errors.length} error(s)` +\n    (warnings.length > 0 ? ` and ${warnings.length} warning(s)` : '') +\n    '.';\n  console.error(`\\n\\x1b[31m${summary}\\x1b[0m`);\n  process.exit(1);\n}\n\nif (warnings.length > 0) {\n  console.log(\n    `\\n\\x1b[33mValidation passed with ${warnings.length} warning(s).\\x1b[0m`\n  );\n} else {\n  console.log('\\x1b[32m[tessera]\\x1b[0m Validation passed — no issues found.');\n}\nprocess.exit(0);\n"],"mappings":";;;AAIA,MAAM,EAAE,QAAQ,aAAa,gBADT,QAAQ,KAC4B,CAAC;AAEzD,KAAK,MAAM,WAAW,UACpB,QAAQ,KAAK,oCAAoC,UAAU;AAE7D,KAAK,MAAM,SAAS,QAClB,QAAQ,MAAM,kCAAkC,QAAQ;AAG1D,IAAI,OAAO,SAAS,GAAG;CACrB,MAAM,UACJ,0BAA0B,OAAO,OAAO,cACvC,SAAS,SAAS,IAAI,QAAQ,SAAS,OAAO,eAAe,MAC9D;CACF,QAAQ,MAAM,aAAa,QAAQ,SAAS;CAC5C,QAAQ,KAAK,EAAE;;AAGjB,IAAI,SAAS,SAAS,GACpB,QAAQ,IACN,oCAAoC,SAAS,OAAO,qBACrD;KAED,QAAQ,IAAI,gEAAgE;AAE9E,QAAQ,KAAK,EAAE"}
+{"version":3,"file":"cli.js","names":[],"sources":["../../src/plugin/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { validateProject, reportValidationIssues } from './validation.js';\n\nconst projectRoot = process.cwd();\nconst { errors, warnings } = validateProject(projectRoot);\n\nreportValidationIssues({ errors, warnings });\n\nif (errors.length > 0) {\n  const summary =\n    `Validation failed with ${errors.length} error(s)` +\n    (warnings.length > 0 ? ` and ${warnings.length} warning(s)` : '') +\n    '.';\n  console.error(`\\n\\x1b[31m${summary}\\x1b[0m`);\n  process.exit(1);\n}\n\nif (warnings.length > 0) {\n  console.log(\n    `\\n\\x1b[33mValidation passed with ${warnings.length} warning(s).\\x1b[0m`\n  );\n} else {\n  console.log('\\x1b[32m[tessera]\\x1b[0m Validation passed — no issues found.');\n}\nprocess.exit(0);\n"],"mappings":";;;AAIA,MAAM,EAAE,QAAQ,aAAa,gBADT,QAAQ,KAC4B,CAAC;AAEzD,uBAAuB;CAAE;CAAQ;CAAU,CAAC;AAE5C,IAAI,OAAO,SAAS,GAAG;CACrB,MAAM,UACJ,0BAA0B,OAAO,OAAO,cACvC,SAAS,SAAS,IAAI,QAAQ,SAAS,OAAO,eAAe,MAC9D;CACF,QAAQ,MAAM,aAAa,QAAQ,SAAS;CAC5C,QAAQ,KAAK,EAAE;;AAGjB,IAAI,SAAS,SAAS,GACpB,QAAQ,IACN,oCAAoC,SAAS,OAAO,qBACrD;KAED,QAAQ,IAAI,gEAAgE;AAE9E,QAAQ,KAAK,EAAE"}

package/dist/plugin/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/plugin/index.ts"],"mappings":";;;iBA4BgB,aAAA,CAAA,IAAa,MAAA,QAAA,MAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/plugin/index.ts"],"mappings":";;;iBA2BgB,aAAA,CAAA,IAAa,MAAA,QAAA,MAAA"}

package/dist/plugin/index.js

@@ -1,11 +1,11 @@
-import { n as extractDefaultExportObjectLiteral, r as generateManifest, t as validateProject } from "../validation-BxWAMMnJ.js";
+import { i as readCourseConfig, n as validateProject, r as generateManifest, t as reportValidationIssues } from "../validation-D9DXlqNP.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 { 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 +151,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,48 +230,24 @@ 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
@@ -282,15 +259,22 @@ function resolveStylesDir() {
 	return resolve(resolve(__dirname, "..", ".."), "styles");
 }
 function tesseraPlugin() {
+	const manifestRef = {
+		current: null,
+		root: ""
+	};
 	return [
-		svelte({ compilerOptions: { css: "injected" } }),
+		svelte({ compilerOptions: { css: "external" } }),
 		tesseraValidationPlugin(),
 		tesseraEntryPlugin(),
 		tesseraConfigPlugin(),
 		tesseraPagesPlugin(),
-		tesseraManifestPlugin(),
+		tesseraManifestPlugin(manifestRef),
 		tesseraLayoutPlugin(),
 		tesseraQuizPlugin(),
+		tesseraAdapterPlugin(),
+		tesseraXAPISetupPlugin(),
+		tesseraFirstPagePreloadPlugin(manifestRef),
 		tesseraExportPlugin()
 	];
 }
@@ -414,6 +398,7 @@ function tesseraConfigPlugin() {
 		config(config) {
 			return {
 				base: "./",
+				build: { assetsDir: "tessera" },
 				resolve: { alias: { "$assets": resolve(config.root || process.cwd(), "assets") } },
 				optimizeDeps: { exclude: ["tessera-learn"] }
 			};
@@ -428,14 +413,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",
@@ -510,12 +490,9 @@ function tesseraValidationPlugin() {
 	};
 }
 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;
@@ -529,29 +506,25 @@ 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}`);
+			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);
 		}
 	};
 }
 const VIRTUAL_MANIFEST_ID = "virtual:tessera-manifest";
 const RESOLVED_MANIFEST_ID = "\0" + VIRTUAL_MANIFEST_ID;
-function tesseraManifestPlugin() {
+function tesseraManifestPlugin(manifestRef) {
 	let projectRoot;
 	let pagesDir;
-	let currentManifest = null;
 	function buildManifest() {
-		currentManifest = generateManifest(pagesDir);
-		return currentManifest;
+		const m = generateManifest(pagesDir);
+		manifestRef.current = m;
+		return m;
 	}
 	return {
 		name: "tessera:manifest",
@@ -559,12 +532,13 @@ function tesseraManifestPlugin() {
 		configResolved(config) {
 			projectRoot = config.root;
 			pagesDir = resolve(projectRoot, "pages");
+			manifestRef.root = projectRoot;
 		},
 		configureServer(devServer) {
 			devServer.watcher.on("all", (event, filePath) => {
 				if (!filePath.startsWith(pagesDir)) return;
 				if (filePath.endsWith(".svelte") || filePath.endsWith("_meta.js") || event === "addDir" || event === "unlinkDir") {
-					currentManifest = null;
+					manifestRef.current = null;
 					const mod = devServer.moduleGraph.getModuleById(RESOLVED_MANIFEST_ID);
 					if (mod) {
 						devServer.moduleGraph.invalidateModule(mod);
@@ -583,15 +557,132 @@ function tesseraManifestPlugin() {
 		},
 		load(id) {
 			if (id === RESOLVED_MANIFEST_ID) {
-				if (!currentManifest) buildManifest();
+				if (!manifestRef.current) buildManifest();
 				addWatchFiles(this, pagesDir);
-				const json = JSON.stringify(currentManifest, (_key, value) => value === Infinity ? 1e9 : value);
+				const json = JSON.stringify(manifestRef.current, (_key, value) => value === Infinity ? 1e9 : value);
 				return `export default JSON.parse(atob("${Buffer.from(json).toString("base64")}"));`;
 			}
 			return null;
 		}
 	};
 }
+const VIRTUAL_ADAPTER_ID = "virtual:tessera-adapter";
+const RESOLVED_ADAPTER_ID = "\0" + VIRTUAL_ADAPTER_ID;
+function tesseraAdapterPlugin() {
+	let projectRoot;
+	let isBuild = false;
+	return {
+		name: "tessera:adapter",
+		enforce: "pre",
+		configResolved(config) {
+			projectRoot = config.root;
+			isBuild = config.command === "build";
+		},
+		resolveId(id) {
+			if (id === VIRTUAL_ADAPTER_ID) return RESOLVED_ADAPTER_ID;
+			return null;
+		},
+		load(id) {
+			if (id !== RESOLVED_ADAPTER_ID) return null;
+			if (!isBuild) return `export { createAdapter } from 'tessera-learn/runtime/adapters/index.js';`;
+			let standard = "web";
+			const read = readCourseConfig(projectRoot);
+			if (read.ok && typeof read.config.export?.standard === "string") standard = read.config.export.standard;
+			switch (standard) {
+				case "scorm12": return `
+import { SCORM12Adapter } from 'tessera-learn/runtime/adapters/scorm12.js';
+import { findSCORM12API } from 'tessera-learn/runtime/adapters/discovery.js';
+import { LMSAdapterError } from 'tessera-learn/runtime/adapters/index.js';
+export function createAdapter() {
+  const api = findSCORM12API();
+  if (!api) throw new LMSAdapterError('scorm12', 'Tessera: SCORM 1.2 API not found in window.parent/opener chain. Course must be launched from a SCORM 1.2 LMS.');
+  return new SCORM12Adapter(api);
+}
+`;
+				case "scorm2004": return `
+import { SCORM2004Adapter } from 'tessera-learn/runtime/adapters/scorm2004.js';
+import { findSCORM2004API } from 'tessera-learn/runtime/adapters/discovery.js';
+import { LMSAdapterError } from 'tessera-learn/runtime/adapters/index.js';
+export function createAdapter() {
+  const api = findSCORM2004API();
+  if (!api) throw new LMSAdapterError('scorm2004', 'Tessera: SCORM 2004 API not found in window.parent/opener chain. Course must be launched from a SCORM 2004 LMS.');
+  return new SCORM2004Adapter(api);
+}
+`;
+				case "cmi5": return `
+import { CMI5Adapter } from 'tessera-learn/runtime/adapters/cmi5.js';
+import { hasCMI5LaunchParams } from 'tessera-learn/runtime/adapters/discovery.js';
+import { LMSAdapterError } from 'tessera-learn/runtime/adapters/index.js';
+export function createAdapter() {
+  if (!hasCMI5LaunchParams()) throw new LMSAdapterError('cmi5', 'Tessera: cmi5 launch parameters not present on URL. Course must be launched from a cmi5-compliant LMS.');
+  return new CMI5Adapter();
+}
+`;
+				default: return `
+import { WebAdapter } from 'tessera-learn/runtime/adapters/web.js';
+export function createAdapter(config) {
+  return new WebAdapter(config);
+}
+`;
+			}
+		}
+	};
+}
+const VIRTUAL_XAPI_SETUP_ID = "virtual:tessera-xapi-setup";
+const RESOLVED_XAPI_SETUP_ID = "\0" + VIRTUAL_XAPI_SETUP_ID;
+function tesseraXAPISetupPlugin() {
+	let projectRoot;
+	let isBuild = false;
+	return {
+		name: "tessera:xapi-setup",
+		enforce: "pre",
+		configResolved(config) {
+			projectRoot = config.root;
+			isBuild = config.command === "build";
+		},
+		resolveId(id) {
+			if (id === VIRTUAL_XAPI_SETUP_ID) return RESOLVED_XAPI_SETUP_ID;
+			return null;
+		},
+		load(id) {
+			if (id !== RESOLVED_XAPI_SETUP_ID) return null;
+			if (!isBuild) return `export { buildXAPIClient } from 'tessera-learn/runtime/xapi/setup.js';`;
+			let standard = "web";
+			let hasXapi = false;
+			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; }`;
+		}
+	};
+}
+function tesseraFirstPagePreloadPlugin(manifestRef) {
+	return {
+		name: "tessera:first-page-preload",
+		apply: "build",
+		transformIndexHtml: {
+			order: "post",
+			handler(_html, ctx) {
+				const firstPagePath = manifestRef.current?.pages[0]?.importPath;
+				if (!firstPagePath || !ctx.bundle) return;
+				const normalized = resolve(manifestRef.root, firstPagePath.replace(/^\//, "")).replace(/\\/g, "/");
+				const chunk = Object.values(ctx.bundle).find((c) => c.type === "chunk" && !!c.facadeModuleId && c.facadeModuleId.replace(/\\/g, "/") === normalized);
+				if (!chunk) return;
+				return [{
+					tag: "link",
+					attrs: {
+						rel: "modulepreload",
+						href: `./${chunk.fileName}`
+					},
+					injectTo: "head"
+				}];
+			}
+		}
+	};
+}
 //#endregion
 export { tesseraPlugin };