equall-cli 0.1.4 → 0.1.5

package/README.md

@@ -23,12 +23,18 @@ equall scan .
   33 files scanned  ·  15 WCAG violations · 19 best-practice issues
   2 critical  11 serious  19 moderate  0 minor
   2 issues ignored via equall-ignore
-  Score 56/100  ·  18/30 Level A criteria checked (60%)  ·  5 failed
-                   29/57 Level AA criteria checked (51%)  ·  6 failed
+  Score 56/100  ·  18/32 Level A criteria checked (56%)  ·  5 failed
+                   29/56 Level AA criteria checked (52%)  ·  6 failed
 
   ⓘ You're failing 5 Level A criteria (1.3.1, 2.1.1, 2.4.2, 2.4.4, 4.1.2).
     Level A is the legal minimum — fix these first.
 
+  Best Practices
+  ● region — 26 issues  Landmarks help screen reader users navigate page sections
+    src/app/layout.tsx
+    src/components/Navigation.tsx
+    ... and 24 more (use --verbose to see all)
+
   Scanners: axe-core@4.11.1 (23 issues), eslint-jsx-a11y@6.10.2 (13 issues)
   Completed in 0.8s
 ```
@@ -75,11 +81,14 @@ equall scan . --json             # pipe to other tools
 equall scan . --json > report.json
 ```
 
-### Filter files
+### Options
 
 ```bash
 equall scan . --include "src/**/*.tsx"
 equall scan . --exclude "**/*.stories.*"
+equall scan . --verbose              # show all files per best-practice rule
+equall scan . --show-ignored         # show ignored issues
+equall scan . --show-manual          # list untested criteria needing manual review
 equall scan . --no-color             # disable colored output
 ```
 

package/dist/{chunk-CMP4ST3J.js → chunk-OQXPOPP6.js}

@@ -68717,7 +68717,7 @@ var MAX_PENALTY_PER_CRITERION = 15;
 function computeScanResult(issues, filesScanned, scannersUsed, durationMs, targetLevel = "AA", criteriaCovered = [], criteriaTotal = 0) {
   const summary = computeSummary(issues, filesScanned);
   const score = computeScore(issues, filesScanned);
-  const pourScores = computePourScores(issues, filesScanned);
+  const pourScores = computePourScores(issues, filesScanned, criteriaCovered);
   const conformanceLevel = computeConformanceLevel(issues, summary, targetLevel);
   return {
     score,
@@ -68782,32 +68782,33 @@ function computeScore(issues, filesScanned) {
   const score = 100 * Math.exp(-k * scaledPenalty);
   return Math.max(0, Math.round(score));
 }
-function computePourScores(issues, filesScanned) {
+function computePourScores(issues, filesScanned, criteriaCovered = []) {
   const pourIssues = {
     perceivable: [],
     operable: [],
     understandable: [],
     robust: []
   };
-  const pourCriteria = {
-    perceivable: /* @__PURE__ */ new Set(),
-    operable: /* @__PURE__ */ new Set(),
-    understandable: /* @__PURE__ */ new Set(),
-    robust: /* @__PURE__ */ new Set()
+  const POUR_BY_PREFIX = { "1": "perceivable", "2": "operable", "3": "understandable", "4": "robust" };
+  const pourCovered = {
+    perceivable: false,
+    operable: false,
+    understandable: false,
+    robust: false
   };
+  for (const c of criteriaCovered) {
+    const principle = POUR_BY_PREFIX[c[0]];
+    if (principle) pourCovered[principle] = true;
+  }
   for (const issue of issues) {
     if (!issue.pour) continue;
     pourIssues[issue.pour].push(issue);
-    for (const c of issue.wcag_criteria) {
-      pourCriteria[issue.pour].add(c);
-    }
   }
   const scaleFactor = 1 / (1 + Math.log10(Math.max(1, filesScanned)));
   const k = 0.02;
   function pourScore(principle) {
     const principleIssues = pourIssues[principle];
-    const criteriaCount = pourCriteria[principle].size;
-    if (criteriaCount === 0 && principleIssues.length === 0) return null;
+    if (!pourCovered[principle] && principleIssues.length === 0) return null;
     if (principleIssues.length === 0) return 100;
     const penaltyByCriterion = /* @__PURE__ */ new Map();
     for (const issue of principleIssues) {
@@ -88388,8 +88389,8 @@ async function runScan(options = {}) {
   const deduped = deduplicateIssues(allIssues);
   const { active, ignored } = applyIgnoreComments(deduped, files);
   const criteriaCovered = [...new Set(scanners.flatMap((s) => s.coveredCriteria))].sort();
-  const WCAG_TOTAL = { A: 30, AA: 57, AAA: 78 };
-  const criteriaTotal = WCAG_TOTAL[scanOptions.wcag_level] ?? 57;
+  const WCAG_TOTAL = { A: 32, AA: 56, AAA: 86 };
+  const criteriaTotal = WCAG_TOTAL[scanOptions.wcag_level] ?? 56;
   const durationMs = Date.now() - startTime;
   const result = computeScanResult(active, files.length, scannersUsed, durationMs, scanOptions.wcag_level, criteriaCovered, criteriaTotal);
   result.issues = [...active, ...ignored];

package/dist/cli.js

@@ -7,7 +7,7 @@ import {
   __toESM,
   globby,
   runScan
-} from "./chunk-CMP4ST3J.js";
+} from "./chunk-OQXPOPP6.js";
 
 // node_modules/commander/lib/error.js
 var require_error = __commonJS({
@@ -6412,6 +6412,107 @@ function ora(options) {
   return new Ora(options);
 }
 
+// src/wcag-catalog.ts
+var WCAG_CATALOG = [
+  // Principle 1 — Perceivable
+  { id: "1.1.1", name: "Non-text Content", level: "A", pour: "perceivable" },
+  { id: "1.2.1", name: "Audio-only and Video-only (Prerecorded)", level: "A", pour: "perceivable" },
+  { id: "1.2.2", name: "Captions (Prerecorded)", level: "A", pour: "perceivable" },
+  { id: "1.2.3", name: "Audio Description or Media Alternative", level: "A", pour: "perceivable" },
+  { id: "1.2.4", name: "Captions (Live)", level: "AA", pour: "perceivable" },
+  { id: "1.2.5", name: "Audio Description (Prerecorded)", level: "AA", pour: "perceivable" },
+  { id: "1.2.6", name: "Sign Language (Prerecorded)", level: "AAA", pour: "perceivable" },
+  { id: "1.2.7", name: "Extended Audio Description (Prerecorded)", level: "AAA", pour: "perceivable" },
+  { id: "1.2.8", name: "Media Alternative (Prerecorded)", level: "AAA", pour: "perceivable" },
+  { id: "1.2.9", name: "Audio-only (Live)", level: "AAA", pour: "perceivable" },
+  { id: "1.3.1", name: "Info and Relationships", level: "A", pour: "perceivable" },
+  { id: "1.3.2", name: "Meaningful Sequence", level: "A", pour: "perceivable" },
+  { id: "1.3.3", name: "Sensory Characteristics", level: "A", pour: "perceivable" },
+  { id: "1.3.4", name: "Orientation", level: "AA", pour: "perceivable" },
+  { id: "1.3.5", name: "Identify Input Purpose", level: "AA", pour: "perceivable" },
+  { id: "1.3.6", name: "Identify Purpose", level: "AAA", pour: "perceivable" },
+  { id: "1.4.1", name: "Use of Color", level: "A", pour: "perceivable" },
+  { id: "1.4.2", name: "Audio Control", level: "A", pour: "perceivable" },
+  { id: "1.4.3", name: "Contrast (Minimum)", level: "AA", pour: "perceivable" },
+  { id: "1.4.4", name: "Resize Text", level: "AA", pour: "perceivable" },
+  { id: "1.4.5", name: "Images of Text", level: "AA", pour: "perceivable" },
+  { id: "1.4.6", name: "Contrast (Enhanced)", level: "AAA", pour: "perceivable" },
+  { id: "1.4.7", name: "Low or No Background Audio", level: "AAA", pour: "perceivable" },
+  { id: "1.4.8", name: "Visual Presentation", level: "AAA", pour: "perceivable" },
+  { id: "1.4.9", name: "Images of Text (No Exception)", level: "AAA", pour: "perceivable" },
+  { id: "1.4.10", name: "Reflow", level: "AA", pour: "perceivable" },
+  { id: "1.4.11", name: "Non-text Contrast", level: "AA", pour: "perceivable" },
+  { id: "1.4.12", name: "Text Spacing", level: "AA", pour: "perceivable" },
+  { id: "1.4.13", name: "Content on Hover or Focus", level: "AA", pour: "perceivable" },
+  // Principle 2 — Operable
+  { id: "2.1.1", name: "Keyboard", level: "A", pour: "operable" },
+  { id: "2.1.2", name: "No Keyboard Trap", level: "A", pour: "operable" },
+  { id: "2.1.3", name: "Keyboard (No Exception)", level: "AAA", pour: "operable" },
+  { id: "2.1.4", name: "Character Key Shortcuts", level: "A", pour: "operable" },
+  { id: "2.2.1", name: "Timing Adjustable", level: "A", pour: "operable" },
+  { id: "2.2.2", name: "Pause, Stop, Hide", level: "A", pour: "operable" },
+  { id: "2.2.3", name: "No Timing", level: "AAA", pour: "operable" },
+  { id: "2.2.4", name: "Interruptions", level: "AAA", pour: "operable" },
+  { id: "2.2.5", name: "Re-authenticating", level: "AAA", pour: "operable" },
+  { id: "2.2.6", name: "Timeouts", level: "AAA", pour: "operable" },
+  { id: "2.3.1", name: "Three Flashes or Below Threshold", level: "A", pour: "operable" },
+  { id: "2.3.2", name: "Three Flashes", level: "AAA", pour: "operable" },
+  { id: "2.3.3", name: "Animation from Interactions", level: "AAA", pour: "operable" },
+  { id: "2.4.1", name: "Bypass Blocks", level: "A", pour: "operable" },
+  { id: "2.4.2", name: "Page Titled", level: "A", pour: "operable" },
+  { id: "2.4.3", name: "Focus Order", level: "A", pour: "operable" },
+  { id: "2.4.4", name: "Link Purpose (In Context)", level: "A", pour: "operable" },
+  { id: "2.4.5", name: "Multiple Ways", level: "AA", pour: "operable" },
+  { id: "2.4.6", name: "Headings and Labels", level: "AA", pour: "operable" },
+  { id: "2.4.7", name: "Focus Visible", level: "AA", pour: "operable" },
+  { id: "2.4.8", name: "Location", level: "AAA", pour: "operable" },
+  { id: "2.4.9", name: "Link Purpose (Link Only)", level: "AAA", pour: "operable" },
+  { id: "2.4.10", name: "Section Headings", level: "AAA", pour: "operable" },
+  { id: "2.4.11", name: "Focus Not Obscured (Minimum)", level: "AA", pour: "operable" },
+  { id: "2.4.12", name: "Focus Not Obscured (Enhanced)", level: "AAA", pour: "operable" },
+  { id: "2.4.13", name: "Focus Appearance", level: "AAA", pour: "operable" },
+  { id: "2.5.1", name: "Pointer Gestures", level: "A", pour: "operable" },
+  { id: "2.5.2", name: "Pointer Cancellation", level: "A", pour: "operable" },
+  { id: "2.5.3", name: "Label in Name", level: "A", pour: "operable" },
+  { id: "2.5.4", name: "Motion Actuation", level: "A", pour: "operable" },
+  { id: "2.5.5", name: "Target Size (Enhanced)", level: "AAA", pour: "operable" },
+  { id: "2.5.6", name: "Concurrent Input Mechanisms", level: "A", pour: "operable" },
+  { id: "2.5.7", name: "Dragging Movements", level: "AA", pour: "operable" },
+  { id: "2.5.8", name: "Target Size (Minimum)", level: "AA", pour: "operable" },
+  // Principle 3 — Understandable
+  { id: "3.1.1", name: "Language of Page", level: "A", pour: "understandable" },
+  { id: "3.1.2", name: "Language of Parts", level: "AA", pour: "understandable" },
+  { id: "3.1.3", name: "Unusual Words", level: "AAA", pour: "understandable" },
+  { id: "3.1.4", name: "Abbreviations", level: "AAA", pour: "understandable" },
+  { id: "3.1.5", name: "Reading Level", level: "AAA", pour: "understandable" },
+  { id: "3.1.6", name: "Pronunciation", level: "AAA", pour: "understandable" },
+  { id: "3.2.1", name: "On Focus", level: "A", pour: "understandable" },
+  { id: "3.2.2", name: "On Input", level: "A", pour: "understandable" },
+  { id: "3.2.3", name: "Consistent Navigation", level: "AA", pour: "understandable" },
+  { id: "3.2.4", name: "Consistent Identification", level: "AA", pour: "understandable" },
+  { id: "3.2.5", name: "Change on Request", level: "AAA", pour: "understandable" },
+  { id: "3.2.6", name: "Consistent Help", level: "A", pour: "understandable" },
+  { id: "3.3.1", name: "Error Identification", level: "A", pour: "understandable" },
+  { id: "3.3.2", name: "Labels or Instructions", level: "A", pour: "understandable" },
+  { id: "3.3.3", name: "Error Suggestion", level: "AA", pour: "understandable" },
+  { id: "3.3.4", name: "Error Prevention (Legal, Financial, Data)", level: "AA", pour: "understandable" },
+  { id: "3.3.5", name: "Help", level: "AAA", pour: "understandable" },
+  { id: "3.3.6", name: "Error Prevention (All)", level: "AAA", pour: "understandable" },
+  { id: "3.3.7", name: "Redundant Entry", level: "A", pour: "understandable" },
+  { id: "3.3.8", name: "Accessible Authentication (Minimum)", level: "AA", pour: "understandable" },
+  { id: "3.3.9", name: "Accessible Authentication (Enhanced)", level: "AAA", pour: "understandable" },
+  // Principle 4 — Robust
+  { id: "4.1.2", name: "Name, Role, Value", level: "A", pour: "robust" },
+  { id: "4.1.3", name: "Status Messages", level: "AA", pour: "robust" }
+];
+var LEVEL_RANK = { A: 1, AA: 2, AAA: 3 };
+var catalogMap = /* @__PURE__ */ new Map();
+for (const c of WCAG_CATALOG) catalogMap.set(c.id, c);
+function getCriteriaForLevel(level) {
+  const maxRank = LEVEL_RANK[level];
+  return WCAG_CATALOG.filter((c) => LEVEL_RANK[c.level] <= maxRank);
+}
+
 // src/output/terminal.ts
 var WCAG_A_CRITERIA = /* @__PURE__ */ new Set([
   "1.1.1",
@@ -6437,15 +6538,17 @@ var WCAG_A_CRITERIA = /* @__PURE__ */ new Set([
   "2.5.2",
   "2.5.3",
   "2.5.4",
+  "2.5.6",
   "3.1.1",
   "3.2.1",
   "3.2.2",
   "3.2.6",
   "3.3.1",
+  "3.3.2",
   "3.3.7",
   "4.1.2"
 ]);
-var WCAG_A_TOTAL = 30;
+var WCAG_A_TOTAL = 32;
 var BP_HINTS = {
   "region": "Landmarks help screen reader users navigate page sections",
   "landmark-main-is-top-level": "Nested landmarks confuse assistive technology",
@@ -6601,6 +6704,22 @@ function printResult(result, options = {}) {
       const hint = BP_HINTS[criterion];
       const hintSuffix = hint ? `  ${DIM}${hint}${RESET}` : "";
       console.log(`  ${severityIcon(topSeverity)} ${BOLD}${criterion}${RESET} ${DIM}\u2014 ${group.issues.length} issue${group.issues.length > 1 ? "s" : ""}${RESET}${hintSuffix}`);
+      const maxFiles = options.verbose ? group.issues.length : 2;
+      const seen = /* @__PURE__ */ new Set();
+      const uniqueIssues = [];
+      for (const issue of group.issues) {
+        if (!seen.has(issue.file_path)) {
+          seen.add(issue.file_path);
+          uniqueIssues.push(issue);
+        }
+      }
+      for (const issue of uniqueIssues.slice(0, maxFiles)) {
+        const location = issue.line ? `:${issue.line}` : "";
+        console.log(`    ${DIM}${issue.file_path}${location}${RESET}`);
+      }
+      if (!options.verbose && uniqueIssues.length > 2) {
+        console.log(`    ${DIM}... and ${uniqueIssues.length - 2} more (use --verbose to see all)${RESET}`);
+      }
     }
     console.log();
   }
@@ -6615,6 +6734,20 @@ function printResult(result, options = {}) {
       console.log();
     }
   }
+  if (options.showManual) {
+    const level = options.targetLevel ?? "AA";
+    const allForLevel = getCriteriaForLevel(level);
+    const coveredSet = new Set(result.criteria_covered);
+    const untested = allForLevel.filter((c) => !coveredSet.has(c.id));
+    if (untested.length > 0) {
+      console.log(`  ${BOLD}Manual review needed${RESET} ${DIM}(${untested.length} criteria)${RESET}`);
+      for (const c of untested) {
+        const principle = c.pour.charAt(0).toUpperCase() + c.pour.slice(1);
+        console.log(`  ${DIM}${c.id}${RESET}  ${c.name} ${DIM}\u2014 ${principle}${RESET}`);
+      }
+      console.log();
+    }
+  }
   console.log(`  ${DIM}Scanners: ${scanners_used.map((s) => `${s.name}@${s.version} (${s.issues_found} issues)`).join(", ")}${RESET}`);
   console.log(`  ${DIM}Completed in ${(duration_ms / 1e3).toFixed(1)}s${RESET}`);
   console.log();
@@ -6837,7 +6970,7 @@ var __dir = resolve2(fileURLToPath(import.meta.url), "..");
 var pkg = JSON.parse(readFileSync(resolve2(__dir, "..", "package.json"), "utf-8"));
 var program2 = new Command();
 program2.name("equall").description("Open-source accessibility scoring \u2014 aggregates axe-core, eslint-plugin-jsx-a11y, and more.").version(pkg.version);
-program2.command("scan").description("Scan a project for accessibility issues").argument("[path]", "Path to project root", ".").option("-l, --level <level>", "WCAG conformance target: A, AA, or AAA", "AA").option("--include <patterns...>", "Glob patterns to include").option("--exclude <patterns...>", "Glob patterns to exclude").option("--json", "Output results as JSON").option("-i, --show-ignored", "Show ignored issues in output").option("--no-color", "Disable colored output").action(async (path, opts) => {
+program2.command("scan").description("Scan a project for accessibility issues").argument("[path]", "Path to project root", ".").option("-l, --level <level>", "WCAG conformance target: A, AA, or AAA", "AA").option("--include <patterns...>", "Glob patterns to include").option("--exclude <patterns...>", "Glob patterns to exclude").option("--json", "Output results as JSON").option("-i, --show-ignored", "Show ignored issues in output").option("-v, --verbose", "Show all occurrences for best-practice issues").option("-m, --show-manual", "List WCAG criteria that require manual review").option("--no-color", "Disable colored output").action(async (path, opts) => {
   const level = opts.level.toUpperCase();
   if (!["A", "AA", "AAA"].includes(level)) {
     console.error(`Invalid level "${opts.level}". Use A, AA, or AAA.`);
@@ -6865,7 +6998,7 @@ program2.command("scan").description("Scan a project for accessibility issues").
     if (opts.json) {
       printJson(result);
     } else {
-      printResult(result, { showIgnored: opts.showIgnored });
+      printResult(result, { showIgnored: opts.showIgnored, verbose: opts.verbose, showManual: opts.showManual, targetLevel: level });
     }
     if (result.score < 50) process.exit(1);
   } catch (error2) {

package/dist/index.js

@@ -2,7 +2,7 @@ import { createRequire as __createRequire } from 'module'; import { fileURLToPat
 import {
   computeScanResult,
   runScan
-} from "./chunk-CMP4ST3J.js";
+} from "./chunk-OQXPOPP6.js";
 export {
   computeScanResult,
   runScan

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "equall-cli",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Open-source accessibility scoring CLI — aggregates axe-core, eslint-plugin-jsx-a11y, and more into a unified score.",
   "keywords": [
     "accessibility",