tessera-learn 0.0.1 → 0.0.2

package/dist/plugin/index.js

@@ -6,6 +6,10 @@ import JSON5 from "json5";
 import { createHash } from "node:crypto";
 import { ZipArchive } from "archiver";
 //#region src/plugin/manifest.ts
+/** Append `.svelte` if not already present. Both bare and suffixed names are accepted in author config. */
+function ensureSvelteSuffix(name) {
+	return name.endsWith(".svelte") ? name : `${name}.svelte`;
+}
 /**
 * Module-level cache of source file contents keyed by absolute path with
 * mtime invalidation. Both `validateProject` and `generateManifest` read the
@@ -71,25 +75,34 @@ function readMetaFile(metaPath) {
 		return {};
 	}
 }
-/**
-* Extract pageConfig from a .svelte file's module script block.
-*/
-function extractPageConfig(filePath) {
-	const moduleScriptMatch = readSourceFileCached(filePath).match(MODULE_SCRIPT_RE);
-	if (!moduleScriptMatch) return {};
+/** Source-level pageConfig extraction shared by manifest generation and build-time validation. */
+function parsePageConfigFromSource(content) {
+	const moduleScriptMatch = content.match(MODULE_SCRIPT_RE);
+	if (!moduleScriptMatch) return { kind: "none" };
 	const scriptContent = moduleScriptMatch[1];
 	const configMatch = scriptContent.match(PAGE_CONFIG_EXPORT_RE);
-	if (!configMatch || configMatch.index === void 0) return {};
+	if (!configMatch || configMatch.index === void 0) return { kind: "none" };
+	if (!scriptContent.slice(configMatch.index + configMatch[0].length).trimStart().startsWith("{")) return { kind: "invalid" };
 	const startIndex = scriptContent.indexOf("{", configMatch.index + configMatch[0].length);
-	if (startIndex < 0) return {};
+	if (startIndex < 0) return { kind: "invalid" };
 	const objectStr = extractObjectLiteral(scriptContent, startIndex);
-	if (!objectStr) return {};
+	if (!objectStr) return { kind: "invalid" };
 	try {
-		return JSON5.parse(objectStr);
+		return {
+			kind: "ok",
+			value: JSON5.parse(objectStr)
+		};
 	} catch {
-		throw new Error(`${filePath}: pageConfig must be a static object literal (no variables, function calls, or computed values)`);
+		return { kind: "invalid" };
 	}
 }
+/** Extract pageConfig from a .svelte file. Throws on parse failure. */
+function extractPageConfig(filePath) {
+	const result = parsePageConfigFromSource(readSourceFileCached(filePath));
+	if (result.kind === "ok") return result.value;
+	if (result.kind === "invalid") throw new Error(`${filePath}: pageConfig must be a static object literal (no variables, function calls, or computed values)`);
+	return {};
+}
 /**
 * Extract an object literal from source starting at the opening brace.
 * Tracks brace depth to find the matching closing brace.
@@ -215,7 +228,7 @@ function generateManifest(pagesDir) {
 */
 function orderPageFiles(allFiles, pagesArray) {
 	if (!pagesArray || pagesArray.length === 0) return allFiles;
-	const listed = pagesArray.map((name) => name.endsWith(".svelte") ? name : `${name}.svelte`);
+	const listed = pagesArray.map(ensureSvelteSuffix);
 	const listedSet = new Set(listed);
 	const unlisted = allFiles.filter((f) => !listedSet.has(f)).sort();
 	return [...listed.filter((f) => allFiles.includes(f)), ...unlisted];
@@ -441,7 +454,7 @@ function validateSingleXAPIEntry(entry, label, standard, errors, warnings) {
 	if (actor === void 0) {
 		if (standard === "web") errors.push(`course.config.js: ${label}.actor is required for web export — there is no LMS to derive a learner identity from. Provide either a static actor object or a function that resolves one (e.g. from your auth system).`);
 	} else if (typeof actor === "object" && actor !== null) {
-		const err = validateStaticAgent(actor);
+		const err = validateAgent(actor);
 		if (err) {
 			const joined = err.startsWith(".") ? `${label}.actor${err}` : `${label}.actor ${err}`;
 			errors.push(`course.config.js: ${joined}`);
@@ -474,18 +487,13 @@ function validateSingleXAPIEntry(entry, label, standard, errors, warnings) {
 		if (standard !== "cmi5") warnings.push(`course.config.js: ${label}.registration is a cmi5 concept; the LRS will accept it under "${standard}" but most analytics tools won't know what to do with it.`);
 	}
 }
-/**
-* Build-time alias for the shared `validateAgent` rules. Suffixes are already
-* prefix-friendly (no leading "actor"), so this is a straight pass-through —
-* kept named so the call sites in this file stay readable.
-*/
-const validateStaticAgent = validateAgent;
 function validatePages(pagesDir, assetsDir, projectRoot) {
 	const errors = [];
 	const warnings = [];
 	let totalPages = 0;
 	let totalQuizzes = 0;
 	let hasGradedQuiz = false;
+	const assetExistsCache = /* @__PURE__ */ new Map();
 	if (!existsSync(pagesDir)) {
 		errors.push("No pages found. Create at least one section with a lesson and page in pages/");
 		return {
@@ -527,7 +535,7 @@ function validatePages(pagesDir, assetsDir, projectRoot) {
 			return name.endsWith(".svelte") && statSync(full).isFile();
 		}).sort();
 		if (sectionMeta?.pages) for (const pageName of sectionMeta.pages) {
-			const fileName = pageName.endsWith(".svelte") ? pageName : `${pageName}.svelte`;
+			const fileName = ensureSvelteSuffix(pageName);
 			if (!sectionSvelteFiles.includes(fileName)) {
 				const metaRel = relative(projectRoot, resolve(sectionPath, "_meta.js"));
 				errors.push(`${metaRel}: pages array lists "${pageName}" but ${fileName} not found in this directory`);
@@ -544,7 +552,7 @@ function validatePages(pagesDir, assetsDir, projectRoot) {
 				validateQuizConfig(pageConfig.quiz, fileRel, errors);
 				if (pageConfig.quiz.graded === true) hasGradedQuiz = true;
 			}
-			validateAssetRefs(content, fileRel, assetsDir, warnings);
+			validateAssetRefs(content, fileRel, assetsDir, warnings, assetExistsCache);
 		}
 		const lessonDirs = sectionEntries.filter((name) => {
 			return statSync(resolve(sectionPath, name)).isDirectory() && !name.startsWith(".");
@@ -555,14 +563,14 @@ function validatePages(pagesDir, assetsDir, projectRoot) {
 			const meta = validateMetaFile(resolve(lessonPath, "_meta.js"), lessonRel, errors);
 			const svelteFiles = readdirSync(lessonPath).filter((name) => name.endsWith(".svelte")).sort();
 			if (meta?.pages) for (const pageName of meta.pages) {
-				const fileName = pageName.endsWith(".svelte") ? pageName : `${pageName}.svelte`;
+				const fileName = ensureSvelteSuffix(pageName);
 				if (!svelteFiles.includes(fileName)) {
 					const metaRel = relative(projectRoot, resolve(lessonPath, "_meta.js"));
 					errors.push(`${metaRel}: pages array lists "${pageName}" but ${fileName} not found in this directory`);
 				}
 			}
 			if (meta?.pages && meta.pages.length > 0) {
-				const listedSet = new Set(meta.pages.map((p) => p.endsWith(".svelte") ? p : `${p}.svelte`));
+				const listedSet = new Set(meta.pages.map(ensureSvelteSuffix));
 				for (const file of svelteFiles) if (!listedSet.has(file)) {
 					const relPath = relative(projectRoot, resolve(lessonPath, file));
 					warnings.push(`${relPath}: not listed in _meta.js pages array — will be appended at end`);
@@ -579,7 +587,7 @@ function validatePages(pagesDir, assetsDir, projectRoot) {
 					validateQuizConfig(pageConfig.quiz, fileRel, errors);
 					if (pageConfig.quiz.graded === true) hasGradedQuiz = true;
 				}
-				validateAssetRefs(content, fileRel, assetsDir, warnings);
+				validateAssetRefs(content, fileRel, assetsDir, warnings, assetExistsCache);
 			}
 		}
 	}
@@ -611,26 +619,10 @@ function validateMetaFile(metaPath, parentRel, errors) {
 	return meta;
 }
 function validatePageConfig(content, fileRel, errors) {
-	const moduleScriptMatch = content.match(MODULE_SCRIPT_RE);
-	if (!moduleScriptMatch) return null;
-	const scriptContent = moduleScriptMatch[1];
-	const exportMatch = scriptContent.match(PAGE_CONFIG_EXPORT_RE);
-	if (!exportMatch || exportMatch.index === void 0) return null;
-	if (!scriptContent.slice(exportMatch.index + exportMatch[0].length).trimStart().startsWith("{")) {
-		errors.push(`${fileRel}: pageConfig must be a static object literal (no variables, function calls, or computed values)`);
-		return null;
-	}
-	const objectStr = extractObjectLiteral(scriptContent, scriptContent.indexOf("{", exportMatch.index + exportMatch[0].length));
-	if (!objectStr) {
-		errors.push(`${fileRel}: pageConfig must be a static object literal (no variables, function calls, or computed values)`);
-		return null;
-	}
-	try {
-		return JSON5.parse(objectStr);
-	} catch {
-		errors.push(`${fileRel}: pageConfig must be a static object literal (no variables, function calls, or computed values)`);
-		return null;
-	}
+	const result = parsePageConfigFromSource(content);
+	if (result.kind === "ok") return result.value;
+	if (result.kind === "invalid") errors.push(`${fileRel}: pageConfig must be a static object literal (no variables, function calls, or computed values)`);
+	return null;
 }
 function validateQuizConfig(quiz, fileRel, errors) {
 	if (!quiz || typeof quiz !== "object") return;
@@ -641,12 +633,24 @@ function validateQuizConfig(quiz, fileRel, errors) {
 	}
 	if (cfg.graded !== void 0 && typeof cfg.graded !== "boolean") errors.push(`${fileRel}: quiz.graded must be a boolean, got ${typeof cfg.graded}`);
 }
-function validateAssetRefs(content, fileRel, assetsDir, warnings) {
-	const assetRefPattern = /\$assets\/([^\s"'`)]+)/g;
+const ASSET_REF_RE = /\$assets\/([^\s"'`)]+)/g;
+/** Match $assets/... refs in any context (src attrs, import statements, url() etc) and dedupe. */
+function collectAssetRefs(content) {
+	const seen = /* @__PURE__ */ new Set();
 	let match;
-	while ((match = assetRefPattern.exec(content)) !== null) {
-		const assetPath = match[1];
-		if (!existsSync(resolve(assetsDir, assetPath))) warnings.push(`${fileRel}: "$assets/${assetPath}" not found in assets/ directory`);
+	ASSET_REF_RE.lastIndex = 0;
+	while ((match = ASSET_REF_RE.exec(content)) !== null) seen.add(match[1]);
+	return [...seen];
+}
+function validateAssetRefs(content, fileRel, assetsDir, warnings, existsCache) {
+	for (const assetPath of collectAssetRefs(content)) {
+		const fullAssetPath = resolve(assetsDir, assetPath);
+		let exists = existsCache.get(fullAssetPath);
+		if (exists === void 0) {
+			exists = existsSync(fullAssetPath);
+			existsCache.set(fullAssetPath, exists);
+		}
+		if (!exists) warnings.push(`${fileRel}: "$assets/${assetPath}" not found in assets/ directory`);
 	}
 }
 function crossValidate(config, pageResults, errors, warnings) {
@@ -712,15 +716,31 @@ function formatSize(bytes) {
 	if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
 	return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
 }
-function generateSCORM12Manifest(config, distDir) {
+const SCORM_DIALECTS = {
+	"1.2": {
+		rootNs: "http://www.imsproject.org/xsd/imscp_rootv1p1p2",
+		adlcpNs: "http://www.adlnet.org/xsd/adlcp_rootv1p2",
+		schemaversion: "1.2",
+		scormTypeAttr: "scormtype"
+	},
+	"2004": {
+		rootNs: "http://www.imsglobal.org/xsd/imscp_v1p1",
+		adlcpNs: "http://www.adlnet.org/xsd/adlcp_v1p3",
+		schemaversion: "2004 4th Edition",
+		scormTypeAttr: "scormType"
+	}
+};
+function generateScormManifest(version, config, distDir) {
+	const dialect = SCORM_DIALECTS[version];
 	const title = escapeXml(config.title || "Tessera Course");
+	const fileElements = collectFiles(distDir).map((f) => `      <file href="${escapeXml(f)}" />`).join("\n");
 	return `<?xml version="1.0" encoding="UTF-8"?>
 <manifest identifier="tessera-course" version="1.0"
-  xmlns="http://www.imsproject.org/xsd/imscp_rootv1p1p2"
-  xmlns:adlcp="http://www.adlnet.org/xsd/adlcp_rootv1p2">
+  xmlns="${dialect.rootNs}"
+  xmlns:adlcp="${dialect.adlcpNs}">
   <metadata>
     <schema>ADL SCORM</schema>
-    <schemaversion>1.2</schemaversion>
+    <schemaversion>${dialect.schemaversion}</schemaversion>
   </metadata>
   <organizations default="org-1">
     <organization identifier="org-1">
@@ -731,36 +751,17 @@ function generateSCORM12Manifest(config, distDir) {
     </organization>
   </organizations>
   <resources>
-    <resource identifier="res-1" type="webcontent" adlcp:scormtype="sco" href="index.html">
-${collectFiles(distDir).map((f) => `      <file href="${escapeXml(f)}" />`).join("\n")}
+    <resource identifier="res-1" type="webcontent" adlcp:${dialect.scormTypeAttr}="sco" href="index.html">
+${fileElements}
     </resource>
   </resources>
 </manifest>`;
 }
+function generateSCORM12Manifest(config, distDir) {
+	return generateScormManifest("1.2", config, distDir);
+}
 function generateSCORM2004Manifest(config, distDir) {
-	const title = escapeXml(config.title || "Tessera Course");
-	return `<?xml version="1.0" encoding="UTF-8"?>
-<manifest identifier="tessera-course" version="1.0"
-  xmlns="http://www.imsglobal.org/xsd/imscp_v1p1"
-  xmlns:adlcp="http://www.adlnet.org/xsd/adlcp_v1p3">
-  <metadata>
-    <schema>ADL SCORM</schema>
-    <schemaversion>2004 4th Edition</schemaversion>
-  </metadata>
-  <organizations default="org-1">
-    <organization identifier="org-1">
-      <title>${title}</title>
-      <item identifier="item-1" identifierref="res-1">
-        <title>${title}</title>
-      </item>
-    </organization>
-  </organizations>
-  <resources>
-    <resource identifier="res-1" type="webcontent" adlcp:scormType="sco" href="index.html">
-${collectFiles(distDir).map((f) => `      <file href="${escapeXml(f)}" />`).join("\n")}
-    </resource>
-  </resources>
-</manifest>`;
+	return generateScormManifest("2004", config, distDir);
 }
 function generateCMI5Xml(config) {
 	const title = escapeXml(config.title || "Tessera Course");