wcag-a11y 0.1.0

package/dist/reporter/markdown.js

@@ -0,0 +1,42 @@
+import { writeFileSync } from 'fs';
+const IMPACT_EMOJI = {
+    critical: '🔴',
+    serious: '🟠',
+    moderate: '🟡',
+    minor: '🟢',
+};
+export function generateMarkdownReport(result, fixes, outputPath = 'a11y-report.md') {
+    const lines = [
+        '# WCAG A11y Report',
+        `> Generated: ${new Date().toLocaleString()}`,
+        '',
+        '## Summary',
+        '',
+        `| Impact | Count |`,
+        `|--------|-------|`,
+        `| 🔴 Critical | ${result.criticalCount} |`,
+        `| 🟠 Serious  | ${result.seriousCount} |`,
+        `| 🟡 Moderate | ${result.moderateCount} |`,
+        `| 🟢 Minor    | ${result.minorCount} |`,
+        '',
+        '---',
+        '',
+    ];
+    for (const page of result.pages) {
+        lines.push(`## Page: ${page.url}`, '');
+        if (page.violations.length === 0) {
+            lines.push('✅ No violations found.', '', '---', '');
+            continue;
+        }
+        for (const v of page.violations) {
+            const fix = fixes.find((f) => f.ruleId === v.ruleId && v.selector.includes(f.selector?.split(' ')[0] ?? ''));
+            lines.push(`### ${IMPACT_EMOJI[v.impact] ?? '⚪'} [${v.impact.toUpperCase()}] ${v.description}`, '', `**Rule:** \`${v.ruleId}\`  `, `**WCAG:** ${fix?.wcagReference ?? `SC ${v.wcag} (Level ${v.level})`}  `, `**Selector:** \`${v.selector}\``, '', '**Violating element:**', '```html', v.html, '```', '');
+            if (fix) {
+                lines.push('**Why it matters:**', fix.explanation, '', '**Fixed code:**', '```html', fix.fixedCode, '```', '', '**📋 Prompt for your AI assistant (Cursor / Copilot / Claude):**', '```', fix.optimalPrompt, '```', '');
+            }
+            lines.push('---', '');
+        }
+    }
+    writeFileSync(outputPath, lines.join('\n'), 'utf-8');
+    console.log(`\nReport saved → ${outputPath}`);
+}

package/dist/reporter/terminal.js

@@ -0,0 +1,55 @@
+import chalk from 'chalk';
+const IMPACT_COLOR = {
+    critical: chalk.red,
+    serious: chalk.yellow,
+    moderate: chalk.blue,
+    minor: chalk.gray,
+};
+export function printTerminalReport(result) {
+    console.log('\n' + chalk.bold('WCAG A11y') + ' — scan complete\n' + chalk.gray('─'.repeat(60)));
+    for (const page of result.pages) {
+        const url = chalk.cyan(page.url);
+        if (page.violations.length === 0) {
+            console.log(`\n  ${chalk.green('✔')}  ${url}  ${chalk.green('No violations found')}`);
+            continue;
+        }
+        const c = page.violations.filter((v) => v.impact === 'critical').length;
+        const s = page.violations.filter((v) => v.impact === 'serious').length;
+        const m = page.violations.filter((v) => v.impact === 'moderate').length;
+        const counts = [
+            c > 0 ? chalk.red(`${c} critical`) : '',
+            s > 0 ? chalk.yellow(`${s} serious`) : '',
+            m > 0 ? chalk.blue(`${m} moderate`) : '',
+        ].filter(Boolean).join('  ');
+        console.log(`\n  ${chalk.red('✖')}  ${url}  ${counts}`);
+        for (const v of page.violations) {
+            const color = IMPACT_COLOR[v.impact] ?? chalk.white;
+            const tag = color(`[${v.impact.toUpperCase()}]`);
+            const wcag = chalk.gray(`WCAG ${v.wcag}`);
+            console.log(`     ${tag} ${v.description}  ${wcag}`);
+            console.log(`     ${chalk.gray('→')} ${chalk.dim(v.selector)}`);
+        }
+    }
+    console.log('\n' + chalk.gray('─'.repeat(60)));
+    console.log(`Total: ${chalk.red(result.criticalCount + ' critical')} · ${chalk.yellow(result.seriousCount + ' serious')} · ${chalk.blue(result.moderateCount + ' moderate')}`);
+    console.log(chalk.gray('Run with --report to save a full markdown report with AI fix suggestions.\n'));
+}
+export function printAIPrompts(fixes) {
+    if (fixes.length === 0)
+        return;
+    console.log('\n' + chalk.bold.magenta('AI Fix Prompts') + chalk.gray(' — paste any of these into Cursor, Copilot, or Claude'));
+    console.log(chalk.gray('─'.repeat(60)));
+    for (const fix of fixes) {
+        const header = chalk.bold(`[${fix.ruleId}]`) + (fix.selector ? chalk.gray(` ${fix.selector}`) : '');
+        console.log('\n' + header);
+        if (fix.explanation) {
+            console.log(chalk.gray(fix.explanation));
+        }
+        console.log(chalk.cyan('┌─ Copy this prompt ──────────────────────────────────────'));
+        for (const line of fix.optimalPrompt.split('\n')) {
+            console.log(chalk.cyan('│ ') + line);
+        }
+        console.log(chalk.cyan('└─────────────────────────────────────────────────────────'));
+    }
+    console.log('');
+}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "wcag-a11y",
+  "version": "0.1.0",
+  "description": "WCAG 2.1/2.2 accessibility auditor with AI-powered fixes",
+  "type": "module",
+  "bin": {
+    "wcag-a11y": "dist/cli.js"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli.ts",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "commander": "^14.0.0",
+    "playwright": "^1.60.0",
+    "chalk": "^5.6.0"
+  },
+  "devDependencies": {
+    "typescript": "^6.0.0",
+    "@types/node": "^25.9.0",
+    "vitest": "^4.1.0",
+    "tsx": "^4.22.0"
+  }
+}