tessera-learn 0.0.10 → 0.0.13

package/src/plugin/a11y/contrast.ts

@@ -0,0 +1,67 @@
+/**
+ * Pure-JS WCAG contrast helpers. App.svelte's parseColor is canvas-based and
+ * browser-only; this runs at build time in the linter (rule 1.7). Only opaque
+ * #hex (3/4/6/8) is parsed — other CSS color forms and translucent hex return
+ * null and fall through to the Tier-2 axe audit, which uses the browser's own
+ * parser.
+ */
+
+function parseHex(
+  input: string,
+): { r: number; g: number; b: number; a: number } | null {
+  const v = input.trim();
+  const m = /^#([0-9a-fA-F]{3,8})$/.exec(v);
+  if (!m) return null;
+  const h = m[1];
+  let r: number,
+    g: number,
+    b: number,
+    a = 255;
+  if (h.length === 3 || h.length === 4) {
+    r = parseInt(h[0] + h[0], 16);
+    g = parseInt(h[1] + h[1], 16);
+    b = parseInt(h[2] + h[2], 16);
+    if (h.length === 4) a = parseInt(h[3] + h[3], 16);
+  } else if (h.length === 6 || h.length === 8) {
+    r = parseInt(h.slice(0, 2), 16);
+    g = parseInt(h.slice(2, 4), 16);
+    b = parseInt(h.slice(4, 6), 16);
+    if (h.length === 8) a = parseInt(h.slice(6, 8), 16);
+  } else {
+    return null; // 5/7 hex digits are not a valid color
+  }
+  return { r, g, b, a };
+}
+
+function linearize(channel: number): number {
+  const c = channel / 255;
+  return c <= 0.03928 ? c / 12.92 : Math.pow((c + 0.055) / 1.055, 2.4);
+}
+
+/** sRGB hex → relative luminance (0–1), or null if not a parseable opaque hex. */
+export function relativeLuminance(hex: string): number | null {
+  const rgb = parseHex(hex);
+  if (!rgb) return null;
+  // A translucent color's on-screen luminance depends on the backdrop; defer
+  // those to the in-browser Tier-2 audit rather than guess a composite.
+  if (rgb.a !== 255) return null;
+  return (
+    0.2126 * linearize(rgb.r) +
+    0.7152 * linearize(rgb.g) +
+    0.0722 * linearize(rgb.b)
+  );
+}
+
+/**
+ * WCAG contrast ratio between two colors. Order-independent — the lighter/darker
+ * ordering is handled internally, so callers may pass the colors in any order.
+ * Returns null if either color isn't a parseable hex.
+ */
+export function contrastRatio(a: string, b: string): number | null {
+  const la = relativeLuminance(a);
+  const lb = relativeLuminance(b);
+  if (la === null || lb === null) return null;
+  const lighter = Math.max(la, lb);
+  const darker = Math.min(la, lb);
+  return (lighter + 0.05) / (darker + 0.05);
+}

package/src/plugin/a11y-cli.ts

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+import { runAudit, type ImpactLevel } from './a11y/audit.js';
+
+const VALID_THRESHOLDS: ImpactLevel[] = [
+  'minor',
+  'moderate',
+  'serious',
+  'critical',
+];
+
+const args = process.argv.slice(2);
+let threshold: ImpactLevel | undefined;
+let rebuild = false;
+
+for (let i = 0; i < args.length; i++) {
+  const arg = args[i];
+  if (arg === '--threshold') {
+    const value = args[++i] as ImpactLevel;
+    if (!VALID_THRESHOLDS.includes(value)) {
+      console.error(
+        `[tessera a11y] --threshold must be one of: ${VALID_THRESHOLDS.join(', ')}`,
+      );
+      process.exit(1);
+    }
+    threshold = value;
+  } else if (arg === '--build') {
+    rebuild = true;
+  } else {
+    console.error(`[tessera a11y] Unknown argument: ${arg}`);
+    process.exit(1);
+  }
+}
+
+const code = await runAudit(process.cwd(), { threshold, rebuild });
+process.exit(code);

package/src/plugin/cli.ts

@@ -1,15 +1,10 @@
 #!/usr/bin/env node
-import { validateProject } from './validation.js';
+import { validateProject, reportValidationIssues } from './validation.js';
 
 const projectRoot = process.cwd();
 const { errors, warnings } = validateProject(projectRoot);
 
-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 =
@@ -22,9 +17,12 @@ if (errors.length > 0) {
 
 if (warnings.length > 0) {
   console.log(
-    `\n\x1b[33mValidation passed with ${warnings.length} warning(s).\x1b[0m`
+    `\n\x1b[33mValidation passed with ${warnings.length} warning(s).\x1b[0m`,
   );
 } else {
   console.log('\x1b[32m[tessera]\x1b[0m Validation passed — no issues found.');
 }
+console.log(
+  '\x1b[2m[tessera] Static checks only. For a full runtime accessibility audit, run: npm run accessibility-check\x1b[0m',
+);
 process.exit(0);

package/src/plugin/export.ts

@@ -1,4 +1,10 @@
-import { existsSync, readdirSync, statSync, writeFileSync, unlinkSync } from 'node:fs';
+import {
+  existsSync,
+  readdirSync,
+  statSync,
+  writeFileSync,
+  unlinkSync,
+} from 'node:fs';
 import { resolve } from 'node:path';
 import { createWriteStream } from 'node:fs';
 import { createHash } from 'node:crypto';
@@ -106,7 +112,7 @@ const SCORM_DIALECTS: Record<'1.2' | '2004', ScormManifestDialect> = {
 export function generateScormManifest(
   version: '1.2' | '2004',
   config: ExportConfig,
-  distDir: string
+  distDir: string,
 ): string {
   const dialect = SCORM_DIALECTS[version];
   const title = escapeXml(config.title || 'Tessera Course');
@@ -143,14 +149,14 @@ ${fileElements}
 
 export function generateSCORM12Manifest(
   config: ExportConfig,
-  distDir: string
+  distDir: string,
 ): string {
   return generateScormManifest('1.2', config, distDir);
 }
 
 export function generateSCORM2004Manifest(
   config: ExportConfig,
-  distDir: string
+  distDir: string,
 ): string {
   return generateScormManifest('2004', config, distDir);
 }
@@ -164,7 +170,7 @@ export function generateCMI5Xml(config: ExportConfig): string {
   const auId = stableUrn('au', `tessera-au:${config.title || ''}`);
   // cmi5 §10.2.4 caps masteryScore at 4 decimals; avoid float drift like 0.7000000000000001.
   const masteryScore = Number(
-    ((config.scoring?.passingScore ?? 70) / 100).toFixed(4)
+    ((config.scoring?.passingScore ?? 70) / 100).toFixed(4),
   );
   // cmi5 §13.1.4 — `moveOn` decides which verb(s) the LMS treats as
   // satisfying the AU. For graded courses (completion gated on a quiz)
@@ -193,7 +199,7 @@ export function generateCMI5Xml(config: ExportConfig): string {
 
 export async function createZip(
   distDir: string,
-  outputPath: string
+  outputPath: string,
 ): Promise<number> {
   return new Promise((res, reject) => {
     const output = createWriteStream(outputPath);
@@ -207,7 +213,7 @@ export async function createZip(
 
     archive.pipe(output);
     archive.directory(distDir, false);
-    archive.finalize();
+    void archive.finalize();
   });
 }
 
@@ -222,15 +228,43 @@ function cleanOldZips(projectRoot: string, slug: string): void {
   try {
     for (const f of readdirSync(projectRoot)) {
       if (f.startsWith(`${slug}-`) && f.endsWith('.zip')) {
-        try { unlinkSync(resolve(projectRoot, f)); } catch {}
+        try {
+          unlinkSync(resolve(projectRoot, f));
+        } catch {}
       }
     }
   } catch {}
 }
 
+/** Packaged (zipped) export targets: which manifest file to write and how. */
+const PACKAGED_EXPORTS: Record<
+  'scorm12' | 'scorm2004' | 'cmi5',
+  {
+    manifestFile: string;
+    label: string;
+    generate: (config: ExportConfig, distDir: string) => string;
+  }
+> = {
+  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),
+  },
+};
+
 export async function runExport(
   projectRoot: string,
-  config: ExportConfig
+  config: ExportConfig,
 ): Promise<void> {
   const distDir = resolve(projectRoot, 'dist');
   const standard = config.export?.standard || 'web';
@@ -239,47 +273,23 @@ export async function runExport(
   const zipName = `${slug}-${version}.zip`;
   const zipPath = resolve(projectRoot, zipName);
 
-  switch (standard) {
-    case 'web': {
-      // Compute dist size
-      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;
-    }
+  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;
+  }
 
-    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;
-    }
+  const spec = PACKAGED_EXPORTS[standard as keyof typeof PACKAGED_EXPORTS];
+  if (!spec) return; // unknown standard — the validator rejects these upstream
 
-    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;
-    }
-  }
+  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)})`);
 }