tessera-learn 0.0.13 → 0.2.0

package/src/plugin/index.ts

@@ -1,7 +1,6 @@
 import type { Plugin, ResolvedConfig, ViteDevServer } from 'vite';
 import { svelte } from '@sveltejs/vite-plugin-svelte';
-import { fileURLToPath } from 'node:url';
-import { dirname, resolve, relative, isAbsolute } from 'node:path';
+import { resolve, relative, isAbsolute } from 'node:path';
 import {
   existsSync,
   readdirSync,
@@ -14,6 +13,10 @@ import {
 import { generateManifest, readCourseConfig } from './manifest.js';
 import type { Manifest } from './manifest.js';
 import type { CourseConfig } from '../runtime/types.js';
+import {
+  DEFAULT_PASSING_SCORE,
+  DEFAULT_PERCENTAGE_THRESHOLD,
+} from '../runtime/defaults.js';
 import {
   validateProject,
   reportValidationIssues,
@@ -25,6 +28,7 @@ import {
 import { runExport } from './export.js';
 import { tesseraLayoutPlugin } from './layout.js';
 import { tesseraQuizPlugin } from './quiz.js';
+import { resolvePackageRoot } from './package-root.js';
 
 import { AUDIT_ENV_FLAG } from './a11y/audit.js';
 
@@ -35,19 +39,14 @@ function isAuditBuild(): boolean {
   return process.env[AUDIT_ENV_FLAG] === '1';
 }
 
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
 // Resolve the runtime directory where App.svelte lives
 function resolveRuntimeDir(): string {
-  const packageRoot = resolve(__dirname, '..', '..');
-  return resolve(packageRoot, 'src', 'runtime');
+  return resolve(resolvePackageRoot(), 'src', 'runtime');
 }
 
 // Resolve the framework styles directory
 function resolveStylesDir(): string {
-  const packageRoot = resolve(__dirname, '..', '..');
-  return resolve(packageRoot, 'styles');
+  return resolve(resolvePackageRoot(), 'styles');
 }
 
 // Tier-1a state shared between the svelte() onwarn handler and the sibling
@@ -84,6 +83,37 @@ function projectFileRel(
   return rel;
 }
 
+type VirtualLoadCtx = { projectRoot: string; isBuild: boolean };
+
+function virtualModule(
+  name: string,
+  virtualId: string,
+  load: (
+    this: import('vite').Rollup.PluginContext,
+    ctx: VirtualLoadCtx,
+  ) => string | null,
+): Plugin {
+  const resolvedId = '\0' + virtualId;
+  let projectRoot = '';
+  let isBuild = false;
+  return {
+    name,
+    enforce: 'pre',
+    configResolved(config: ResolvedConfig) {
+      projectRoot = config.root;
+      isBuild = config.command === 'build';
+    },
+    resolveId(id) {
+      return id === virtualId ? resolvedId : null;
+    },
+    load(id) {
+      return id === resolvedId
+        ? load.call(this, { projectRoot, isBuild })
+        : null;
+    },
+  };
+}
+
 export function tesseraPlugin() {
   const manifestRef: { current: Manifest | null; root: string } = {
     current: null,
@@ -117,6 +147,7 @@ export function tesseraPlugin() {
     tesseraA11yCompilerPlugin(a11y),
     tesseraValidationPlugin(),
     tesseraEntryPlugin(),
+    tesseraConfigDefaultsPlugin(),
     tesseraConfigPlugin(),
     tesseraPagesPlugin(),
     tesseraManifestPlugin(manifestRef),
@@ -287,7 +318,6 @@ mount(App, {
 // ---------- Config Plugin ----------
 
 const VIRTUAL_CONFIG_ID = 'virtual:tessera-config';
-const RESOLVED_CONFIG_ID = '\0' + VIRTUAL_CONFIG_ID;
 
 function completionDefaults(mode: string | undefined): {
   completion: Record<string, unknown>;
@@ -297,72 +327,55 @@ function completionDefaults(mode: string | undefined): {
     return { completion: { mode: 'manual' }, passingScore: 0 };
   }
   return {
-    completion: { mode: 'percentage', percentageThreshold: 100 },
-    passingScore: 70,
+    completion: {
+      mode: 'percentage',
+      percentageThreshold: DEFAULT_PERCENTAGE_THRESHOLD,
+    },
+    passingScore: DEFAULT_PASSING_SCORE,
   };
 }
 
-function tesseraConfigPlugin(): Plugin {
-  let projectRoot: string;
-
+function tesseraConfigDefaultsPlugin(): Plugin {
   return {
-    name: 'tessera:config',
+    name: 'tessera:config-defaults',
     enforce: 'pre',
-
     config(config) {
       const root = config.root || process.cwd();
-
       return {
         base: './',
-        build: {
-          assetsDir: 'tessera',
-        },
-        resolve: {
-          alias: {
-            $assets: resolve(root, 'assets'),
-          },
-        },
+        build: { assetsDir: 'tessera' },
+        resolve: { alias: { $assets: resolve(root, 'assets') } },
         // tessera-learn ships .ts/.svelte.ts source; Vite's dep optimizer
         // doesn't run vite-plugin-svelte's preprocessor, so skip pre-bundling.
-        optimizeDeps: {
-          exclude: ['tessera-learn'],
-        },
+        optimizeDeps: { exclude: ['tessera-learn'] },
       };
     },
+  };
+}
 
-    configResolved(config: ResolvedConfig) {
-      projectRoot = config.root;
-    },
-
-    resolveId(id) {
-      if (id === VIRTUAL_CONFIG_ID) return RESOLVED_CONFIG_ID;
-      return null;
-    },
-
-    load(id) {
-      if (id === RESOLVED_CONFIG_ID) {
-        const configPath = resolve(projectRoot, 'course.config.js');
-        if (existsSync(configPath)) this.addWatchFile(configPath);
-        const read = readCourseConfig(projectRoot);
-        const userConfig: Partial<CourseConfig> = read.ok ? read.config : {};
-
-        const { completion, passingScore } = completionDefaults(
-          userConfig.completion?.mode,
-        );
-        const merged = {
-          title: userConfig.title || 'Untitled Course',
-          ...userConfig,
-          navigation: { mode: 'free', ...userConfig.navigation },
-          completion: { ...completion, ...userConfig.completion },
-          scoring: { passingScore, ...userConfig.scoring },
-          export: { standard: 'web', ...userConfig.export },
-        };
-
-        return `export default ${JSON.stringify(merged)};`;
-      }
-      return null;
+function tesseraConfigPlugin(): Plugin {
+  return virtualModule(
+    'tessera:config',
+    VIRTUAL_CONFIG_ID,
+    function ({ projectRoot }) {
+      const configPath = resolve(projectRoot, 'course.config.js');
+      if (existsSync(configPath)) this.addWatchFile(configPath);
+      const read = readCourseConfig(projectRoot);
+      const userConfig: Partial<CourseConfig> = read.ok ? read.config : {};
+      const { completion, passingScore } = completionDefaults(
+        userConfig.completion?.mode,
+      );
+      const merged = {
+        title: userConfig.title || 'Untitled Course',
+        ...userConfig,
+        navigation: { mode: 'free', ...userConfig.navigation },
+        completion: { ...completion, ...userConfig.completion },
+        scoring: { passingScore, ...userConfig.scoring },
+        export: { standard: 'web', ...userConfig.export },
+      };
+      return `export default ${JSON.stringify(merged)};`;
     },
-  };
+  );
 }
 
 // ---------- Manifest Watch Helpers ----------
@@ -386,7 +399,6 @@ function addWatchFiles(
 // ---------- Pages Plugin ----------
 
 const VIRTUAL_PAGES_ID = 'virtual:tessera-pages';
-const RESOLVED_PAGES_ID = '\0' + VIRTUAL_PAGES_ID;
 
 /**
  * Provides a virtual module that exports an import.meta.glob map for all .svelte
@@ -394,22 +406,9 @@ const RESOLVED_PAGES_ID = '\0' + VIRTUAL_PAGES_ID;
  * pages/ directory, and Vite can statically analyze it for code splitting.
  */
 function tesseraPagesPlugin(): Plugin {
-  return {
-    name: 'tessera:pages',
-    enforce: 'pre',
-
-    resolveId(id) {
-      if (id === VIRTUAL_PAGES_ID) return RESOLVED_PAGES_ID;
-      return null;
-    },
-
-    load(id) {
-      if (id === RESOLVED_PAGES_ID) {
-        return `export default import.meta.glob('/pages/**/*.svelte');`;
-      }
-      return null;
-    },
-  };
+  return virtualModule('tessera:pages', VIRTUAL_PAGES_ID, () => {
+    return `export default import.meta.glob('/pages/**/*.svelte');`;
+  });
 }
 
 // ---------- Validation Plugin ----------
@@ -620,29 +619,12 @@ function tesseraManifestPlugin(manifestRef: {
 }
 
 const VIRTUAL_ADAPTER_ID = 'virtual:tessera-adapter';
-const RESOLVED_ADAPTER_ID = '\0' + VIRTUAL_ADAPTER_ID;
 
 function tesseraAdapterPlugin(): Plugin {
-  let projectRoot: string;
-  let isBuild = false;
-
-  return {
-    name: 'tessera:adapter',
-    enforce: 'pre',
-
-    configResolved(config: ResolvedConfig) {
-      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;
-
+  return virtualModule(
+    'tessera:adapter',
+    VIRTUAL_ADAPTER_ID,
+    ({ projectRoot, isBuild }) => {
       // In dev, defer to the runtime selector so its WebAdapter fallback
       // for unreachable LMS APIs keeps working.
       if (!isBuild) {
@@ -701,33 +683,16 @@ export function createAdapter(config) {
 `;
       }
     },
-  };
+  );
 }
 
 const VIRTUAL_XAPI_SETUP_ID = 'virtual:tessera-xapi-setup';
-const RESOLVED_XAPI_SETUP_ID = '\0' + VIRTUAL_XAPI_SETUP_ID;
 
 function tesseraXAPISetupPlugin(): Plugin {
-  let projectRoot: string;
-  let isBuild = false;
-
-  return {
-    name: 'tessera:xapi-setup',
-    enforce: 'pre',
-
-    configResolved(config: ResolvedConfig) {
-      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;
-
+  return virtualModule(
+    'tessera:xapi-setup',
+    VIRTUAL_XAPI_SETUP_ID,
+    ({ projectRoot, isBuild }) => {
       if (!isBuild) {
         return `export { buildXAPIClient } from 'tessera-learn/runtime/xapi/setup.js';`;
       }
@@ -754,7 +719,7 @@ function tesseraXAPISetupPlugin(): Plugin {
 
       return `export async function buildXAPIClient() { return null; }`;
     },
-  };
+  );
 }
 
 function tesseraFirstPagePreloadPlugin(manifestRef: {

package/src/plugin/inline-config.ts

@@ -0,0 +1,54 @@
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import type { ConfigEnv, InlineConfig } from 'vite';
+import { tesseraPlugin } from './index.js';
+
+// Base Vite config for every Tessera command (dev, export, a11y build).
+// configFile:false disables Vite's own discovery — there is no vite.config.js —
+// and tesseraPlugin() supplies the Svelte compiler, so this is the full plugin set.
+//
+// $shared points at the workspace-level design system, which lives outside the
+// per-course Vite root, so it is wired here (where workspaceRoot is known) rather
+// than next to $assets in the plugin. server.fs.allow must list workspaceRoot or
+// the dev server's fs.strict gate refuses to serve $shared files.
+export function buildInlineConfig(
+  projectRoot: string,
+  workspaceRoot: string,
+): InlineConfig {
+  return {
+    root: projectRoot,
+    configFile: false,
+    plugins: [tesseraPlugin()],
+    resolve: { alias: { $shared: resolve(workspaceRoot, 'shared') } },
+    server: { fs: { allow: [workspaceRoot] } },
+  };
+}
+
+// Optional author-owned escape hatch, never scaffolded or reconciled. A *partial*
+// Vite config the caller merges on top of buildInlineConfig(), so tesseraPlugin()
+// stays wired in and the author only writes the delta.
+export async function loadUserConfig(
+  projectRoot: string,
+  env: ConfigEnv,
+): Promise<InlineConfig | null> {
+  const configPath = resolve(projectRoot, 'tessera.config.js');
+  if (!existsSync(configPath)) return null;
+  const mod = await import(pathToFileURL(configPath).href);
+  const config = mod.default ?? mod;
+  // mergeConfig throws on a function, so resolve Vite's callback form first.
+  return (
+    typeof config === 'function' ? await config(env) : config
+  ) as InlineConfig;
+}
+
+export async function resolveTesseraConfig(
+  projectRoot: string,
+  workspaceRoot: string,
+  env: ConfigEnv,
+): Promise<InlineConfig> {
+  const vite = await import('vite');
+  const base = buildInlineConfig(projectRoot, workspaceRoot);
+  const user = await loadUserConfig(projectRoot, env);
+  return user ? vite.mergeConfig(base, user) : base;
+}