equall-cli 0.1.3 → 0.1.5

package/dist/cli.js

@@ -7,7 +7,7 @@ import {
   __toESM,
   globby,
   runScan
-} from "./chunk-5YPLWCOT.js";
+} from "./chunk-OQXPOPP6.js";
 
 // node_modules/commander/lib/error.js
 var require_error = __commonJS({
@@ -3011,6 +3011,8 @@ var require_commander = __commonJS({
 
 // src/cli.ts
 import { resolve as resolve2, basename } from "path";
+import { readFileSync, existsSync, statSync } from "fs";
+import { fileURLToPath } from "url";
 
 // node_modules/commander/esm.mjs
 var import_index = __toESM(require_commander(), 1);
@@ -6410,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",
@@ -6435,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",
@@ -6599,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();
   }
@@ -6613,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();
@@ -6716,6 +6851,28 @@ async function findIgnores(rootPath) {
   }
   return entries.sort((a, b) => a.file_path.localeCompare(b.file_path) || a.line - b.line);
 }
+async function addIgnoreFile(rootPath, filePath) {
+  const absolutePath = resolve(rootPath, filePath);
+  let content;
+  try {
+    content = await readFile(absolutePath, "utf-8");
+  } catch {
+    return null;
+  }
+  const lines = content.split("\n");
+  if (lines.slice(0, 5).some((l) => l.includes("equall-ignore-file"))) {
+    return null;
+  }
+  const ext = filePath.split(".").pop()?.toLowerCase();
+  let comment;
+  if (ext === "html" || ext === "htm") {
+    comment = "<!-- equall-ignore-file -->";
+  } else {
+    comment = "// equall-ignore-file";
+  }
+  await writeFile(absolutePath, comment + "\n" + content, "utf-8");
+  return { file: filePath, comment };
+}
 async function removeIgnore(rootPath, target) {
   const ignores = await findIgnores(rootPath);
   const colonIdx = target.lastIndexOf(":");
@@ -6809,9 +6966,11 @@ async function clearAllIgnores(rootPath) {
 }
 
 // src/cli.ts
+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("0.1.0");
-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.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("-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.`);
@@ -6839,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) {
@@ -6895,6 +7054,21 @@ program2.command("ignore").description("Add, list, or remove equall-ignore comme
     console.log(`
   ${GREEN2}Added${RESET2} ${result.file}:${result.line}`);
     console.log(`  ${DIM2}${result.comment.trim()}${RESET2}
+`);
+    return;
+  }
+  const isDirectory = target && existsSync(resolve2(rootPath, target)) && statSync(resolve2(rootPath, target)).isDirectory();
+  if (target && !isDirectory && (target.includes("/") || target.match(/\.\w+$/))) {
+    const result = await addIgnoreFile(rootPath, target);
+    if (!result) {
+      console.error(`
+  Could not ignore ${target}. File not found or already ignored.
+`);
+      process.exit(1);
+    }
+    console.log(`
+  ${GREEN2}Added${RESET2} ${result.file}`);
+    console.log(`  ${DIM2}${result.comment}${RESET2}
 `);
     return;
   }

package/dist/index.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "equall-cli",
-  "version": "0.1.3",
+  "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",
@@ -51,12 +51,14 @@
     "@types/jsdom": "^21.1.7",
     "@types/node": "^22.0.0",
     "axe-core": "^4.10.0",
+    "cheerio": "^1.2.0",
     "commander": "^12.1.0",
     "eslint": "^9.0.0",
     "eslint-plugin-jsx-a11y": "^6.10.0",
     "globby": "^14.0.0",
     "jsdom": "^25.0.0",
     "ora": "^9.3.0",
+    "text-readability": "^1.1.1",
     "tsup": "^8.0.0",
     "tsx": "^4.0.0",
     "typescript": "^5.9.3",