tessera-learn 0.0.11 → 0.0.13

package/src/plugin/index.ts

@@ -1,15 +1,40 @@
 import type { Plugin, ResolvedConfig, ViteDevServer } from 'vite';
 import { svelte } from '@sveltejs/vite-plugin-svelte';
 import { fileURLToPath } from 'node:url';
-import { dirname, resolve } from 'node:path';
-import { existsSync, readdirSync, statSync, writeFileSync, unlinkSync, cpSync, mkdirSync } from 'node:fs';
+import { dirname, resolve, relative, isAbsolute } from 'node:path';
+import {
+  existsSync,
+  readdirSync,
+  statSync,
+  writeFileSync,
+  unlinkSync,
+  cpSync,
+  mkdirSync,
+} from 'node:fs';
 import { generateManifest, readCourseConfig } from './manifest.js';
 import type { Manifest } from './manifest.js';
-import { validateProject, reportValidationIssues } from './validation.js';
+import type { CourseConfig } from '../runtime/types.js';
+import {
+  validateProject,
+  reportValidationIssues,
+  normalizeA11y,
+  isPlausibleLanguageTag,
+  isIgnored,
+  type A11ySettings,
+} from './validation.js';
 import { runExport } from './export.js';
 import { tesseraLayoutPlugin } from './layout.js';
 import { tesseraQuizPlugin } from './quiz.js';
 
+import { AUDIT_ENV_FLAG } from './a11y/audit.js';
+
+export { runAudit } from './a11y/audit.js';
+export type { AuditOptions, ImpactLevel } from './a11y/audit.js';
+
+function isAuditBuild(): boolean {
+  return process.env[AUDIT_ENV_FLAG] === '1';
+}
+
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
@@ -25,12 +50,71 @@ function resolveStylesDir(): string {
   return resolve(packageRoot, 'styles');
 }
 
+// Tier-1a state shared between the svelte() onwarn handler and the sibling
+// gate plugin. onwarn fires during transform (after the Tier-1b buildStart
+// gate), so a11y warnings are collected here and flushed/gated at buildEnd.
+interface A11yCompilerState {
+  warnings: string[];
+  projectRoot: string;
+  isBuild: boolean;
+  settings: A11ySettings;
+}
+
+// Svelte's onwarn filename is relative to the vite root (e.g. `pages/x.svelte`)
+// in build and may be absolute or a virtual id elsewhere. Return the
+// project-relative path for a real author file, or null to skip framework /
+// node_modules / virtual modules — Tier 0 owns the framework's own warnings.
+function projectFileRel(
+  filename: string | undefined,
+  projectRoot: string,
+): string | null {
+  if (!filename || !projectRoot) return null;
+  if (
+    filename.startsWith('\0') ||
+    filename.includes('virtual:') ||
+    filename.includes('node_modules')
+  ) {
+    return null;
+  }
+  const abs = isAbsolute(filename) ? filename : resolve(projectRoot, filename);
+  const rel = relative(projectRoot, abs);
+  if (rel.startsWith('..') || isAbsolute(rel) || rel.includes('node_modules')) {
+    return null;
+  }
+  return rel;
+}
+
 export function tesseraPlugin() {
-  const manifestRef: { current: Manifest | null; root: string } = { current: null, root: '' };
+  const manifestRef: { current: Manifest | null; root: string } = {
+    current: null,
+    root: '',
+  };
+  const a11y: A11yCompilerState = {
+    warnings: [],
+    projectRoot: '',
+    isBuild: false,
+    settings: normalizeA11y(undefined),
+  };
   return [
     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; // suppress the raw Vite print; we re-emit via the reporter
+        }
+        defaultHandler?.(warning);
+      },
     }),
+    tesseraA11yCompilerPlugin(a11y),
     tesseraValidationPlugin(),
     tesseraEntryPlugin(),
     tesseraConfigPlugin(),
@@ -57,6 +141,7 @@ function tesseraEntryPlugin(): Plugin {
   const stylesDir = resolveStylesDir();
   const appSveltePath = resolve(runtimeDir, 'App.svelte');
   let projectRoot: string;
+  let outDir: string;
   let isBuild = false;
 
   return {
@@ -65,13 +150,18 @@ function tesseraEntryPlugin(): Plugin {
 
     configResolved(config: ResolvedConfig) {
       projectRoot = config.root;
+      outDir = resolve(config.root, config.build.outDir);
       isBuild = config.command === 'build';
     },
 
     // For build mode: write index.html so Rollup can find it
     buildStart() {
       if (isBuild) {
-        writeFileSync(resolve(projectRoot, 'index.html'), generateIndexHtml(), 'utf-8');
+        writeFileSync(
+          resolve(projectRoot, 'index.html'),
+          generateIndexHtml(readLanguage(projectRoot)),
+          'utf-8',
+        );
       }
     },
 
@@ -80,12 +170,14 @@ function tesseraEntryPlugin(): Plugin {
       if (isBuild) {
         const htmlPath = resolve(projectRoot, 'index.html');
         if (existsSync(htmlPath)) {
-          try { unlinkSync(htmlPath); } catch {}
+          try {
+            unlinkSync(htmlPath);
+          } catch {}
         }
 
-        // Copy assets/ directory to dist/assets/ so $assets/ references resolve
+        // Copy assets/ into the build's assets/ so $assets/ references resolve
         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 });
@@ -98,7 +190,7 @@ function tesseraEntryPlugin(): Plugin {
       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;
@@ -112,7 +204,8 @@ function tesseraEntryPlugin(): Plugin {
 
     resolveId(id) {
       if (id === VIRTUAL_ENTRY_ID) return RESOLVED_ENTRY_ID;
-      if (id === VIRTUAL_MAIN_ID || id === 'virtual:tessera-main') return RESOLVED_MAIN_ID;
+      if (id === VIRTUAL_MAIN_ID || id === 'virtual:tessera-main')
+        return RESOLVED_MAIN_ID;
       return null;
     },
 
@@ -125,9 +218,18 @@ function tesseraEntryPlugin(): Plugin {
   };
 }
 
-function generateIndexHtml(): string {
+// 'en' fallback applied here: the config default-merge runs later than buildStart.
+// Only a validated BCP-47 tag is interpolated into <html lang>, so a malformed
+// value (caught separately as a warning) can't ship a broken attribute.
+function readLanguage(projectRoot: string): string {
+  const read = readCourseConfig(projectRoot);
+  const lang = read.ok ? read.config.language : undefined;
+  return isPlausibleLanguageTag(lang) ? lang : 'en';
+}
+
+function generateIndexHtml(lang: string): string {
   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" />
@@ -140,15 +242,19 @@ function generateIndexHtml(): string {
 </html>`;
 }
 
-function generateEntryScript(appSveltePath: string, frameworkStylesDir: string, projectRoot: string): string {
+function generateEntryScript(
+  appSveltePath: string,
+  frameworkStylesDir: string,
+  projectRoot: string,
+): string {
   const normalizedPath = appSveltePath.replace(/\\/g, '/');
 
   // Framework CSS imports (theme → base → layout)
   const frameworkCssOrder = ['theme.css', 'base.css', 'layout.css'];
   const frameworkImports = frameworkCssOrder
-    .map(file => resolve(frameworkStylesDir, file).replace(/\\/g, '/'))
-    .filter(path => existsSync(path))
-    .map(path => `import '${path}';`)
+    .map((file) => resolve(frameworkStylesDir, file).replace(/\\/g, '/'))
+    .filter((path) => existsSync(path))
+    .map((path) => `import '${path}';`)
     .join('\n');
 
   // User CSS imports from project's styles/ directory
@@ -156,11 +262,11 @@ function generateEntryScript(appSveltePath: string, frameworkStylesDir: string,
   let userImports = '';
   if (existsSync(userStylesDir)) {
     const userCssFiles = readdirSync(userStylesDir)
-      .filter(f => f.endsWith('.css'))
+      .filter((f) => f.endsWith('.css'))
       .sort();
     userImports = userCssFiles
-      .map(f => resolve(userStylesDir, f).replace(/\\/g, '/'))
-      .map(path => `import '${path}';`)
+      .map((f) => resolve(userStylesDir, f).replace(/\\/g, '/'))
+      .map((path) => `import '${path}';`)
       .join('\n');
   }
 
@@ -190,7 +296,10 @@ function completionDefaults(mode: string | undefined): {
   if (mode === 'manual') {
     return { completion: { mode: 'manual' }, passingScore: 0 };
   }
-  return { completion: { mode: 'percentage', percentageThreshold: 100 }, passingScore: 70 };
+  return {
+    completion: { mode: 'percentage', percentageThreshold: 100 },
+    passingScore: 70,
+  };
 }
 
 function tesseraConfigPlugin(): Plugin {
@@ -210,7 +319,7 @@ function tesseraConfigPlugin(): Plugin {
         },
         resolve: {
           alias: {
-            '$assets': resolve(root, 'assets'),
+            $assets: resolve(root, 'assets'),
           },
         },
         // tessera-learn ships .ts/.svelte.ts source; Vite's dep optimizer
@@ -235,9 +344,11 @@ function tesseraConfigPlugin(): Plugin {
         const configPath = resolve(projectRoot, 'course.config.js');
         if (existsSync(configPath)) this.addWatchFile(configPath);
         const read = readCourseConfig(projectRoot);
-        const userConfig: Record<string, any> = read.ok ? read.config : {};
+        const userConfig: Partial<CourseConfig> = read.ok ? read.config : {};
 
-        const { completion, passingScore } = completionDefaults(userConfig.completion?.mode);
+        const { completion, passingScore } = completionDefaults(
+          userConfig.completion?.mode,
+        );
         const merged = {
           title: userConfig.title || 'Untitled Course',
           ...userConfig,
@@ -257,7 +368,10 @@ function tesseraConfigPlugin(): Plugin {
 // ---------- Manifest Watch Helpers ----------
 
 /** Register all _meta.js and .svelte files under pagesDir as watch files for build mode. */
-function addWatchFiles(ctx: { addWatchFile(id: string): void }, dir: string): void {
+function addWatchFiles(
+  ctx: { addWatchFile(id: string): void },
+  dir: string,
+): void {
   if (!existsSync(dir)) return;
   for (const entry of readdirSync(dir)) {
     const full = resolve(dir, entry);
@@ -326,12 +440,44 @@ function tesseraValidationPlugin(): Plugin {
   };
 }
 
+// Tier 1a: flush + gate the Svelte compiler's a11y warnings at buildEnd, after
+// every module is transformed. svelte() accepts `onwarn` but not arbitrary
+// Rollup hooks, so the gate lives here and shares the onwarn closure.
+function tesseraA11yCompilerPlugin(a11y: A11yCompilerState): Plugin {
+  return {
+    name: 'tessera:a11y-compiler',
+    enforce: 'pre',
+
+    configResolved(config: ResolvedConfig) {
+      a11y.projectRoot = config.root;
+      a11y.isBuild = config.command === 'build';
+      const read = readCourseConfig(config.root);
+      a11y.settings = normalizeA11y(read.ok ? read.config.a11y : undefined);
+    },
+
+    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: string): void {
   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.`
+      `Tessera validation failed with ${result.errors.length} error(s). Fix the errors above to continue.`,
     );
   }
 }
@@ -353,6 +499,7 @@ function tesseraExportPlugin(): Plugin {
 
     async closeBundle() {
       if (!isBuild) return;
+      if (isAuditBuild()) return;
 
       const read = readCourseConfig(projectRoot);
       if (!read.ok) {
@@ -361,20 +508,23 @@ function tesseraExportPlugin(): Plugin {
         // rather than shipping a bundle with no LMS export silently.
         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.'
+            '[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.'
+            '[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 as Error).message}`
+          `[tessera:export] course.config.js: failed to parse export-default object literal — ${(read.error as Error).message}`,
         );
       }
 
-      await runExport(projectRoot, read.config as Parameters<typeof runExport>[1]);
+      await runExport(
+        projectRoot,
+        read.config as Parameters<typeof runExport>[1],
+      );
     },
   };
 }
@@ -384,10 +534,12 @@ function tesseraExportPlugin(): Plugin {
 const VIRTUAL_MANIFEST_ID = 'virtual:tessera-manifest';
 const RESOLVED_MANIFEST_ID = '\0' + VIRTUAL_MANIFEST_ID;
 
-function tesseraManifestPlugin(manifestRef: { current: Manifest | null; root: string }): Plugin {
+function tesseraManifestPlugin(manifestRef: {
+  current: Manifest | null;
+  root: string;
+}): Plugin {
   let projectRoot: string;
   let pagesDir: string;
-  let server: ViteDevServer | null = null;
 
   function buildManifest(): Manifest {
     const m = generateManifest(pagesDir);
@@ -406,8 +558,6 @@ function tesseraManifestPlugin(manifestRef: { current: Manifest | null; root: st
     },
 
     configureServer(devServer: ViteDevServer) {
-      server = devServer;
-
       // Watch the pages directory for changes
       devServer.watcher.on('all', (event, filePath) => {
         if (!filePath.startsWith(pagesDir)) return;
@@ -429,7 +579,9 @@ function tesseraManifestPlugin(manifestRef: { current: Manifest | null; root: st
             devServer.ws.send({ type: 'full-reload' });
           }
 
-          console.log(`[tessera] Manifest rebuilt (${event}: ${filePath.replace(projectRoot, '')})`);
+          console.log(
+            `[tessera] Manifest rebuilt (${event}: ${filePath.replace(projectRoot, '')})`,
+          );
         }
       });
     },
@@ -457,7 +609,7 @@ function tesseraManifestPlugin(manifestRef: { current: Manifest | null; root: st
         // scanning .svelte importPath strings as module imports.
         // Replace Infinity with 1e9 since JSON.stringify drops it.
         const json = JSON.stringify(manifestRef.current, (_key, value) =>
-          value === Infinity ? 1e9 : value
+          value === Infinity ? 1e9 : value,
         );
         const b64 = Buffer.from(json).toString('base64');
         return `export default JSON.parse(atob("${b64}"));`;
@@ -503,6 +655,10 @@ function tesseraAdapterPlugin(): Plugin {
         standard = read.config.export.standard;
       }
 
+      // The audit renders headless with no LMS in the frame chain; the SCORM/
+      // cmi5 adapters throw when their API is absent, so render with WebAdapter.
+      if (isAuditBuild()) standard = 'web';
+
       switch (standard) {
         case 'scorm12':
           return `
@@ -576,11 +732,17 @@ function tesseraXAPISetupPlugin(): Plugin {
         return `export { buildXAPIClient } from 'tessera-learn/runtime/xapi/setup.js';`;
       }
 
+      // The audit runs offline — don't wire real LRS destinations into it.
+      if (isAuditBuild()) {
+        return `export async function buildXAPIClient() { return null; }`;
+      }
+
       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;
+        if (typeof read.config.export?.standard === 'string')
+          standard = read.config.export.standard;
         hasXapi = read.config.xapi != null;
       }
 
@@ -595,7 +757,10 @@ function tesseraXAPISetupPlugin(): Plugin {
   };
 }
 
-function tesseraFirstPagePreloadPlugin(manifestRef: { current: Manifest | null; root: string }): Plugin {
+function tesseraFirstPagePreloadPlugin(manifestRef: {
+  current: Manifest | null;
+  root: string;
+}): Plugin {
   return {
     name: 'tessera:first-page-preload',
     apply: 'build',
@@ -604,17 +769,24 @@ function tesseraFirstPagePreloadPlugin(manifestRef: { current: Manifest | null;
       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 normalized = resolve(
+          manifestRef.root,
+          firstPagePath.replace(/^\//, ''),
+        ).replace(/\\/g, '/');
         const chunk = Object.values(ctx.bundle).find(
           (c): c is import('vite').Rollup.OutputChunk =>
-            c.type === 'chunk' && !!c.facadeModuleId && c.facadeModuleId.replace(/\\/g, '/') === normalized
+            c.type === 'chunk' &&
+            !!c.facadeModuleId &&
+            c.facadeModuleId.replace(/\\/g, '/') === normalized,
         );
         if (!chunk) return;
-        return [{
-          tag: 'link',
-          attrs: { rel: 'modulepreload', href: `./${chunk.fileName}` },
-          injectTo: 'head',
-        }];
+        return [
+          {
+            tag: 'link',
+            attrs: { rel: 'modulepreload', href: `./${chunk.fileName}` },
+            injectTo: 'head',
+          },
+        ];
       },
     },
   };

package/src/plugin/manifest.ts

@@ -1,7 +1,7 @@
 import { readdirSync, readFileSync, existsSync, statSync } from 'node:fs';
 import { resolve, basename, extname } from 'node:path';
 import JSON5 from 'json5';
-import type { QuizConfig } from '../runtime/types.js';
+import type { CourseConfig, QuizConfig } from '../runtime/types.js';
 
 // ---------- Types ----------
 
@@ -48,7 +48,10 @@ export function ensureSvelteSuffix(name: string): string {
  * sharing the read avoids the second disk hit (and matters most on cold-cache
  * CI runs and large courses).
  */
-const fileContentCache = new Map<string, { mtimeMs: number; content: string }>();
+const fileContentCache = new Map<
+  string,
+  { mtimeMs: number; content: string }
+>();
 
 export function readSourceFileCached(filePath: string): string {
   const stat = statSync(filePath);
@@ -70,7 +73,7 @@ export function stripPrefix(name: string): string {
 export function titleCase(slug: string): string {
   return slug
     .split('-')
-    .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
     .join(' ');
 }
 
@@ -97,7 +100,9 @@ const DEFAULT_EXPORT_RE = /export\s+default\s*/;
  * or null if no balanced object literal follows the `export default` keyword.
  * Used by both manifest extraction and project validation.
  */
-export function extractDefaultExportObjectLiteral(source: string): string | null {
+export function extractDefaultExportObjectLiteral(
+  source: string,
+): string | null {
   const match = source.match(DEFAULT_EXPORT_RE);
   if (!match || match.index === undefined) return null;
   const startIndex = source.indexOf('{', match.index);
@@ -106,8 +111,12 @@ export function extractDefaultExportObjectLiteral(source: string): string | null
 }
 
 export type CourseConfigRead =
-  | { ok: true; config: Record<string, any> }
-  | { ok: false; reason: 'missing' | 'no-export' | 'parse-error'; error?: unknown };
+  | { ok: true; config: Partial<CourseConfig> }
+  | {
+      ok: false;
+      reason: 'missing' | 'no-export' | 'parse-error';
+      error?: unknown;
+    };
 
 /**
  * Read and JSON5-parse the `export default { ... }` literal from a project's
@@ -119,7 +128,9 @@ export type CourseConfigRead =
 export function readCourseConfig(projectRoot: string): CourseConfigRead {
   const configPath = resolve(projectRoot, 'course.config.js');
   if (!existsSync(configPath)) return { ok: false, reason: 'missing' };
-  const objectStr = extractDefaultExportObjectLiteral(readSourceFileCached(configPath));
+  const objectStr = extractDefaultExportObjectLiteral(
+    readSourceFileCached(configPath),
+  );
   if (!objectStr) return { ok: false, reason: 'no-export' };
   try {
     return { ok: true, config: JSON5.parse(objectStr) };
@@ -133,10 +144,15 @@ export function readCourseConfig(projectRoot: string): CourseConfigRead {
  * Uses the same JSON5 approach as pageConfig extraction — find the object literal
  * after `export default` and parse it.
  */
-export function readMetaFile(metaPath: string): { title?: string; pages?: string[] } {
+export function readMetaFile(metaPath: string): {
+  title?: string;
+  pages?: string[];
+} {
   if (!existsSync(metaPath)) return {};
 
-  const objectStr = extractDefaultExportObjectLiteral(readSourceFileCached(metaPath));
+  const objectStr = extractDefaultExportObjectLiteral(
+    readSourceFileCached(metaPath),
+  );
   if (!objectStr) return {};
 
   try {
@@ -151,12 +167,17 @@ export type PageConfigParseResult =
   /** No module script, or no `pageConfig =` export. Treat as "no config". */
   | { kind: 'none' }
   /** Found and successfully parsed. */
-  | { kind: 'ok'; value: { title?: string; quiz?: QuizConfig; completesOn?: 'view' } }
+  | {
+      kind: 'ok';
+      value: { title?: string; quiz?: QuizConfig; completesOn?: 'view' };
+    }
   /** Found but couldn't parse as a static object literal — non-literal RHS or JSON5 failure. */
   | { kind: 'invalid' };
 
 /** Source-level pageConfig extraction shared by manifest generation and build-time validation. */
-export function parsePageConfigFromSource(content: string): PageConfigParseResult {
+export function parsePageConfigFromSource(
+  content: string,
+): PageConfigParseResult {
   const moduleScriptMatch = content.match(MODULE_SCRIPT_RE);
   if (!moduleScriptMatch) return { kind: 'none' };
 
@@ -171,7 +192,10 @@ export function parsePageConfigFromSource(content: string): PageConfigParseResul
   // pageConfig assigned to something other than an object literal — flag as invalid.
   if (!afterExport.startsWith('{')) return { kind: 'invalid' };
 
-  const startIndex = scriptContent.indexOf('{', configMatch.index + configMatch[0].length);
+  const startIndex = scriptContent.indexOf(
+    '{',
+    configMatch.index + configMatch[0].length,
+  );
   if (startIndex < 0) return { kind: 'invalid' };
   const objectStr = extractObjectLiteral(scriptContent, startIndex);
   if (!objectStr) return { kind: 'invalid' };
@@ -184,12 +208,16 @@ export function parsePageConfigFromSource(content: string): PageConfigParseResul
 }
 
 /** Extract pageConfig from a .svelte file. Throws on parse failure. */
-export function extractPageConfig(filePath: string): { title?: string; quiz?: QuizConfig; completesOn?: 'view' } {
+export function extractPageConfig(filePath: string): {
+  title?: string;
+  quiz?: QuizConfig;
+  completesOn?: 'view';
+} {
   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)`
+      `${filePath}: pageConfig must be a static object literal (no variables, function calls, or computed values)`,
     );
   }
   return {};
@@ -201,7 +229,10 @@ export function extractPageConfig(filePath: string): { title?: string; quiz?: Qu
  * the open char is wrong or no matching close is found. Shared by manifest
  * extraction, _meta/pageConfig parsing, and the validator's tag-prop parser.
  */
-export function extractObjectLiteral(source: string, startIndex: number): string | null {
+export function extractObjectLiteral(
+  source: string,
+  startIndex: number,
+): string | null {
   const open = source[startIndex];
   if (open !== '{' && open !== '[') return null;
 
@@ -266,7 +297,7 @@ export function extractObjectLiteral(source: string, startIndex: number): string
 function getSortedDirs(dirPath: string): string[] {
   if (!existsSync(dirPath)) return [];
   return readdirSync(dirPath)
-    .filter(name => {
+    .filter((name) => {
       const full = resolve(dirPath, name);
       return statSync(full).isDirectory() && !name.startsWith('.');
     })
@@ -279,7 +310,7 @@ function getSortedDirs(dirPath: string): string[] {
 function getSvelteFiles(dirPath: string): string[] {
   if (!existsSync(dirPath)) return [];
   return readdirSync(dirPath)
-    .filter(name => name.endsWith('.svelte'))
+    .filter((name) => name.endsWith('.svelte'))
     .sort();
 }
 
@@ -327,7 +358,11 @@ export function generateManifest(pagesDir: string): Manifest {
         const filePath = resolve(lessonPath, fileName);
         const pageSlug = deriveSlug(fileName, true);
 
-        let pageConfig: { title?: string; quiz?: QuizConfig; completesOn?: 'view' } = {};
+        let pageConfig: {
+          title?: string;
+          quiz?: QuizConfig;
+          completesOn?: 'view';
+        } = {};
         try {
           pageConfig = extractPageConfig(filePath);
         } catch (e) {
@@ -344,7 +379,9 @@ export function generateManifest(pagesDir: string): Manifest {
           slug: pageSlug,
           importPath: relativePath,
           quiz: pageConfig.quiz || null,
-          ...(pageConfig.completesOn === 'view' ? { completesOn: 'view' as const } : {}),
+          ...(pageConfig.completesOn === 'view'
+            ? { completesOn: 'view' as const }
+            : {}),
         };
 
         lesson.pages.push(page);
@@ -368,17 +405,20 @@ export function generateManifest(pagesDir: string): Manifest {
 /**
  * Order .svelte files: listed in `pages` array first (in order), then unlisted appended alphabetically.
  */
-export function orderPageFiles(allFiles: string[], pagesArray?: string[]): string[] {
+export function orderPageFiles(
+  allFiles: string[],
+  pagesArray?: string[],
+): string[] {
   if (!pagesArray || pagesArray.length === 0) {
     return allFiles;
   }
 
   const listed = pagesArray.map(ensureSvelteSuffix);
   const listedSet = new Set(listed);
-  const unlisted = allFiles.filter(f => !listedSet.has(f)).sort();
+  const unlisted = allFiles.filter((f) => !listedSet.has(f)).sort();
 
   // Only include listed files that actually exist
-  const validListed = listed.filter(f => allFiles.includes(f));
+  const validListed = listed.filter((f) => allFiles.includes(f));
 
   return [...validListed, ...unlisted];
 }