tessera-learn 0.2.2 → 0.2.3

package/src/plugin/a11y/audit.ts

@@ -1,5 +1,5 @@
 import { spawn, type SpawnOptions } from 'node:child_process';
-import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { readFileSync, writeFileSync } from 'node:fs';
 import { createRequire } from 'node:module';
 import { dirname, resolve } from 'node:path';
 import { generateManifest, readCourseConfig } from '../manifest.js';
@@ -8,8 +8,6 @@ import { normalizeA11y, type A11ySettings } from '../validation.js';
 export interface AuditOptions {
   /** Minimum violation impact that fails the run (CI gate). Default 'serious'. */
   threshold?: ImpactLevel;
-  /** Force a fresh `vite build` even if dist/ exists. */
-  rebuild?: boolean;
 }
 
 export type ImpactLevel = 'minor' | 'moderate' | 'serious' | 'critical';
@@ -378,7 +376,6 @@ export async function runAudit(
 
   // A throwaway web build, kept out of dist/ so a real LMS export is untouched.
   const auditDist = resolve(projectRoot, 'node_modules', '.tessera-a11y');
-  const distHtml = resolve(auditDist, 'index.html');
 
   const prevEnv = process.env[AUDIT_ENV_FLAG];
   process.env[AUDIT_ENV_FLAG] = '1';
@@ -386,15 +383,13 @@ export async function runAudit(
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   let server: any;
   try {
-    if (options.rebuild || !existsSync(distHtml)) {
-      console.log('[tessera a11y] Building course…');
-      await vite.build(
-        vite.mergeConfig(auditBaseConfig, {
-          build: { outDir: auditDist, emptyOutDir: true },
-          logLevel: 'warn',
-        }),
-      );
-    }
+    console.log('[tessera a11y] Building course…');
+    await vite.build(
+      vite.mergeConfig(auditBaseConfig, {
+        build: { outDir: auditDist, emptyOutDir: true },
+        logLevel: 'warn',
+      }),
+    );
 
     server = await vite.preview({
       root: projectRoot,

package/src/plugin/a11y-cli.ts

@@ -13,7 +13,6 @@ export type ParsedA11yArgs =
 
 export function parseA11yArgs(argv: string[]): ParsedA11yArgs {
   let threshold: ImpactLevel | undefined;
-  let rebuild = false;
 
   for (let i = 0; i < argv.length; i++) {
     const arg = argv[i];
@@ -26,14 +25,12 @@ export function parseA11yArgs(argv: string[]): ParsedA11yArgs {
         };
       }
       threshold = value;
-    } else if (arg === '--build') {
-      rebuild = true;
     } else {
       return { ok: false, error: `Unknown argument: ${arg}` };
     }
   }
 
-  const args: AuditOptions = { rebuild };
+  const args: AuditOptions = {};
   if (threshold !== undefined) args.threshold = threshold;
   return { ok: true, args };
 }

package/src/plugin/cli.ts

@@ -19,8 +19,7 @@ Commands:
 Run a command from inside a course folder, or name the course explicitly.
 
 a11y/check options:
-  --threshold <minor|moderate|serious|critical>   Failing impact (default: serious)
-  --build                                          Force a fresh build first`;
+  --threshold <minor|moderate|serious|critical>   Failing impact (default: serious)`;
 
 // The course is a leading positional: `tessera <cmd> [course] [flags]`. Only the
 // first token can be the course, and only when it isn't a flag — otherwise a flag
@@ -74,7 +73,7 @@ export async function main(
         case 'validate':
           return runValidate(courseRoot);
         case 'check': {
-          const validateCode = runValidate(courseRoot);
+          const validateCode = runValidate(courseRoot, { showA11yTip: false });
           if (validateCode !== 0) return validateCode;
           return runA11y(courseRoot, workspaceRoot, flags);
         }

package/src/plugin/validate-cli.ts

@@ -1,6 +1,10 @@
+import { basename } from 'node:path';
 import { validateProject, reportValidationIssues } from './validation.js';
 
-export function runValidate(projectRoot: string): number {
+export function runValidate(
+  projectRoot: string,
+  { showA11yTip = true }: { showA11yTip?: boolean } = {},
+): number {
   const { errors, warnings } = validateProject(projectRoot);
 
   reportValidationIssues({ errors, warnings });
@@ -23,8 +27,10 @@ export function runValidate(projectRoot: string): number {
       '\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: pnpm exec tessera a11y\x1b[0m',
-  );
+  if (showA11yTip) {
+    console.log(
+      `\x1b[2m[tessera] Static checks only. For a full runtime accessibility audit, run: pnpm a11y ${basename(projectRoot)}\x1b[0m`,
+    );
+  }
   return 0;
 }