@wcag-checkr/ci 1.0.0-rc.140 → 1.0.0-rc.141

package/dist/manifest.json

@@ -2,8 +2,8 @@
   "manifest_version": 3,
   "name": "wcagcheckr",
   "description": "Audit components across hover, focus, dark mode, forced colors, RTL — every state your users actually encounter. Per-component baselines surface only NEW violations.",
-  "version": "1.0.0.140",
-  "version_name": "1.0.0-rc.140",
+  "version": "1.0.0.141",
+  "version_name": "1.0.0-rc.141",
   "author": "Locustware",
   "homepage_url": "https://wcagcheckr.com",
   "icons": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wcag-checkr/ci",
-  "version": "1.0.0-rc.140",
+  "version": "1.0.0-rc.141",
   "private": false,
   "description": "Headless wcagcheckr accessibility audit runner for CI/CD pipelines. Drives the wcagcheckr Chrome extension via Playwright, runs full-page audits across the state matrix (108 combinations: hover, focus, dark mode, RTL, breakpoints), outputs JSON / SARIF / JUnit, exits with severity-aware codes.",
   "license": "UNLICENSED",

package/wcagcheckr-ci.mjs

@@ -76,6 +76,9 @@ function parseArgs(argv) {
     else if (a === '--quiet') args.quiet = true;
     else if (a === '--license') args.license = argv[++i];
     else if (a === '--public-key-url') args.publicKeyUrl = argv[++i];
+    else if (a === '--watch') args.watch = true;
+    else if (a === '--watch-dir') args.watchDir = argv[++i];
+    else if (a === '--watch-debounce') args.watchDebounce = parseInt(argv[++i], 10);
     else if (a === '--help' || a === '-h') args.help = true;
   }
   return args;
@@ -97,6 +100,12 @@ audit options:
   --timeout <ms>                  Audit timeout (default: 120000)
   --license <token>               Activate this license token before auditing
                                   (gates paid features like forensic anchoring)
+  --watch                         Stay open after the initial audit and re-run
+                                  whenever a file under --watch-dir changes
+  --watch-dir <path>              Directory to watch when --watch is on
+                                  (default: current working directory)
+  --watch-debounce <ms>           Debounce window after a change before
+                                  re-auditing (default: 1500)
   --quiet                         Suppress progress output
 
 verify options:
@@ -162,6 +171,9 @@ if (!['none', 'critical', 'serious', 'moderate', 'minor'].includes(args.threshol
 
 log(`Loading extension from ${EXT_DIR}`);
 log(`Auditing ${args.url} (threshold: ${args.threshold}, format: ${args.format})`);
+if (args.watch) {
+  log(`watch mode ON — re-audits on file changes under ${args.watchDir ?? process.cwd()}`);
+}
 
 // Chrome extensions cannot load in legacy `headless: true` mode, so we
 // pass `--headless=new` as a Chromium arg (the modern headless mode that
@@ -179,8 +191,10 @@ const context = await chromium.launchPersistentContext('', {
 });
 
 let exitCode = 0;
+let targetPage;
+let sidePanel;
 try {
-  const [targetPage] = context.pages();
+  [targetPage] = context.pages();
   await targetPage.goto(args.url, { waitUntil: 'domcontentloaded', timeout: 30_000 });
   log('target page loaded');
 
@@ -193,7 +207,7 @@ try {
   if (!extId) throw new Error('extension SW did not register within 10s');
   log(`extension loaded (id: ${extId.slice(0, 8)}…)`);
 
-  const sidePanel = await context.newPage();
+  sidePanel = await context.newPage();
   await sidePanel.goto(`chrome-extension://${extId}/side-panel/side-panel.html`);
 
   // Headless persona — pick dev mode if wizard appears.
@@ -255,21 +269,43 @@ try {
     break;
   }
 
-  await sidePanel.getByLabel('Audit mode').selectOption('full-page');
-  await targetPage.bringToFront();
-  await targetPage.waitForTimeout(500);
-  await sidePanel.bringToFront();
-  await sidePanel.waitForTimeout(300);
-  await sidePanel.getByRole('button', { name: /Scan page|Auditing/ }).click();
-  log('audit started');
+  // The per-audit work: navigate target (re-load on subsequent runs to
+  // pick up code changes), kick off the scan, wait for completion, export,
+  // print, threshold-check. Returns the exit code that THIS audit pass
+  // should produce — the watch loop overall stays at 0 until Ctrl+C.
+  async function runOneAudit() {
+    // On re-runs, navigate the target page again so it picks up source
+    // changes (assumes the dev server hot-reloads or the URL serves fresh
+    // content).
+    await targetPage.bringToFront();
+    await targetPage.reload({ waitUntil: 'domcontentloaded', timeout: 30_000 });
+    await targetPage.waitForTimeout(500);
+    await sidePanel.bringToFront();
+    await sidePanel.waitForTimeout(300);
+
+    await sidePanel.getByLabel('Audit mode').selectOption('full-page');
+    await sidePanel.getByRole('button', { name: /Scan page|Auditing/ }).click();
+    log('audit started');
+
+    await sidePanel
+      .getByText(/\d+\s+states?\s+·\s+\d+\s+unique\s+violations?/, { exact: false })
+      .waitFor({ timeout: args.timeout });
+    log('audit completed');
+
+    return await collectResults();
+  }
+
+  // Result-export + threshold-check, extracted so runOneAudit returns the
+  // exit code suggestion. Closure over `args`, `sidePanel`, etc.
+  async function collectResults() {
+    return await doExportAndThresholdCheck();
+  }
 
-  await sidePanel
-    .getByText(/\d+\s+states?\s+·\s+\d+\s+unique\s+violations?/, { exact: false })
-    .waitFor({ timeout: args.timeout });
-  log('audit completed');
+  await runOneAudit();
 
   // Trigger the existing export pipeline. The SW handles EXPORT_REQUEST and
   // returns the formatted content for the requested format.
+  async function doExportAndThresholdCheck() {
   const formatMap = { json: 'json', sarif: 'sarif', junit: 'junit' };
   const exportFormat = formatMap[args.format];
 
@@ -353,6 +389,61 @@ try {
       log(`✓ threshold not exceeded (--threshold=${args.threshold})`);
     }
   }
+  } // end doExportAndThresholdCheck
+
+  // Watch mode: keep the browser open, watch the directory tree, re-audit
+  // on change (debounced). Ctrl+C exits.
+  if (args.watch) {
+    const watchDir = args.watchDir ?? process.cwd();
+    const debounceMs = args.watchDebounce ?? 1500;
+    const { watch } = await import('node:fs');
+    log(`watching ${watchDir} (debounce ${debounceMs}ms) — Ctrl+C to exit`);
+    let pending = false;
+    let inFlight = false;
+    let runCount = 1;
+    function trigger() {
+      if (inFlight) {
+        pending = true;
+        return;
+      }
+      inFlight = true;
+      setTimeout(async () => {
+        try {
+          runCount++;
+          log(`\n── Re-audit #${runCount} ──`);
+          await runOneAudit();
+          if (pending) {
+            pending = false;
+            inFlight = false;
+            trigger();
+          } else {
+            inFlight = false;
+          }
+        } catch (err) {
+          log(`re-audit failed: ${err.message}`);
+          inFlight = false;
+        }
+      }, debounceMs);
+    }
+    try {
+      watch(watchDir, { recursive: true }, (eventType, filename) => {
+        // Skip noise: node_modules, dist artifacts, .git, dotfiles other
+        // than the typical source files.
+        if (!filename) return;
+        const f = String(filename);
+        if (f.includes('node_modules')) return;
+        if (f.includes('.git')) return;
+        if (f.includes('/dist/') || f.startsWith('dist/') || f.includes('\\dist\\') || f.startsWith('dist\\')) return;
+        log(`change: ${f}`);
+        trigger();
+      });
+    } catch (err) {
+      log(`fs.watch failed (recursive may not be supported on this platform): ${err.message}`);
+      log('watch mode disabled; exiting after this audit.');
+    }
+    // Block forever until the user kills the process.
+    await new Promise(() => {});
+  }
 } catch (err) {
   console.error(`✗ ${err.message}`);
   if (err.stack && !args.quiet) console.error(err.stack);