wcag-a11y 0.2.0 → 0.3.1

package/README.md

@@ -87,14 +87,14 @@ Each command creates an `a11y.config.json` pre-wired for that provider. Fill in
 Scan a built-in page with 10 intentional violations. No dev server or config required — useful for trying the tool before pointing it at your own project.
 
 ```bash
-wcag-a11y demo                  # violations only
-wcag-a11y demo --ai             # violations + AI fixes (requires config)
-wcag-a11y demo --ai --report    # + save a11y-report.md
+wcag-a11y demo                  # violations + AI fixes (default, requires config)
+wcag-a11y demo --no-ai          # violations only, no AI — faster
+wcag-a11y demo --report         # + save a11y-report.md
 ```
 
 | Flag | Description |
 |---|---|
-| `--ai` | Generate AI fix explanations and prompts for each violation |
+| `--no-ai` | Skip AI fix generation — prints violations only, no prompts |
 | `-r, --report` | Save the full report to `a11y-report.md` in the current directory |
 
 ---
@@ -122,7 +122,7 @@ Scan a running dev server for accessibility violations.
 ```bash
 wcag-a11y scan -u http://localhost:3000
 wcag-a11y scan -u http://localhost:3000 --pages / /about /contact
-wcag-a11y scan -u http://localhost:3000 --crawl --ai --report
+wcag-a11y scan -u http://localhost:3000 --crawl --report
 wcag-a11y scan -u http://localhost:3000 --no-ai --ci
 ```
 
@@ -132,7 +132,7 @@ wcag-a11y scan -u http://localhost:3000 --no-ai --ci
 | `-p, --pages <pages...>` | `/` | One or more paths to scan. Separate with spaces: `--pages / /about /contact` |
 | `-c, --crawl` | off | Follow same-origin links and scan all reachable pages automatically |
 | `-r, --report` | off | Save the full scan output to `a11y-report.md` |
-| `--ai` / `--no-ai` | on | Generate AI fix explanations and prompts. Use `--no-ai` for a fast violation-only scan |
+| `--no-ai` | on | Skip AI fix generation — scan runs faster and prints violations only |
 | `--no-explain` | off | Print only the ready-to-paste prompt for each fix, without the AI explanation |
 | `--group <strategy>` | `rule` | `rule` (default) groups all violations of the same type into one fix prompt. `none` produces a separate prompt per element. Use `none` when violations of the same rule need different fixes |
 | `--ci` | off | Exit with code `1` if any violations are found. Use this to fail a CI pipeline |

package/dist/ai/fallback-explanation.js

@@ -0,0 +1,67 @@
+const EXPLANATIONS = {
+    // Text alternatives
+    'img-alt': 'Screen reader users hear nothing for this image — any information it conveys (branding, instructions, data) is completely invisible to them.',
+    'input-image-alt': 'Screen readers announce this button by its file name (e.g. "submit.png") instead of its purpose, so users cannot tell what the button does.',
+    'svg-title': 'Screen reader users receive no label for this SVG; if it conveys meaning (an icon, a chart), that meaning is entirely lost.',
+    'object-alt': 'Screen reader users receive no description for this embedded object; its content is skipped as if it does not exist.',
+    'role-img-alt': 'Elements marked with `role="img"` are announced as "image" with no label, giving screen reader users no context about what is depicted.',
+    'image-redundant-alt': 'Screen reader users hear the same text twice — once from the alt attribute and once from adjacent text — creating a disorienting, repetitive experience.',
+    // Tables
+    'table-headers': 'Screen reader users navigating a data table cell by cell hear only isolated values with no column or row context — like reading a spreadsheet with all headers removed.',
+    'table-scope-valid': 'Invalid `scope` values cause screen readers to misidentify which headers apply to which cells, giving users incorrect data relationships.',
+    'td-headers-attr': '`headers` attributes pointing to non-existent IDs are silently ignored, leaving table cells without any header association for screen reader users.',
+    'table-duplicate-name': 'When a table\'s caption and summary say the same thing, screen reader users hear the description twice, wasting time and causing confusion.',
+    // Structure
+    'heading-order': 'Skipping heading levels (e.g. h1 → h3) breaks the document outline; screen reader users navigating by headings lose the logical hierarchy and cannot tell which sections are sub-sections of others.',
+    'page-title': 'Screen reader users hear a blank or generic title when switching tabs and cannot identify the page without reading its full content.',
+    'landmark-one-main': 'Without a `<main>` landmark, screen reader users cannot skip directly to page content and must tab through all navigation on every single page load.',
+    'list-structure': 'Content that looks like a list but uses `<div>` or `<p>` instead of `<ul>`/`<li>` is read as plain text; screen readers won\'t announce item count or allow list-navigation shortcuts.',
+    'region-landmark': 'Content outside any landmark region is missed by screen reader users who navigate by landmarks — `<header>`, `<main>`, `<nav>`, `<footer>` etc.',
+    'duplicate-id': 'Duplicate IDs silently break ARIA relationships (`aria-labelledby`, `aria-describedby`): the wrong element may be read, or the association ignored entirely.',
+    'frame-title': 'Screen reader users hear "frame" with no description and cannot tell if a frame contains a cookie banner, an advertisement, or a critical widget without entering it.',
+    'meta-viewport': '`user-scalable=no` or `maximum-scale` prevents users with low vision from pinch-zooming — removing the browser\'s most basic accessibility tool for text size.',
+    'marquee': '`<marquee>` moves content automatically with no pause control; users with cognitive disabilities, ADHD, or vestibular disorders find it disorienting or impossible to read.',
+    'p-as-heading': 'Visual headings styled as bold `<p>` tags are not exposed as headings in the accessibility tree; screen reader users navigating by headings will skip this section entirely.',
+    // Media
+    'video-captions': 'Deaf and hard-of-hearing users cannot access any spoken content in the video — dialogue, narration, and audio cues are entirely unavailable to them.',
+    'audio-description': 'Blind users miss visual-only information in the video (on-screen text, actions, scene changes) that is never described in the audio track.',
+    'audio-transcript': 'Deaf users cannot access audio-only content (e.g. podcasts, voice instructions) without a text transcript; the content is completely inaccessible to them.',
+    // Links
+    'link-name': 'Screen reader users navigating by links hear only "link" with no destination — they cannot determine where it leads without reading the surrounding paragraph.',
+    'link-empty': 'An anchor with no text content is announced as an empty unlabeled link; screen reader users encounter a dead spot that provides no usable information.',
+    'identical-links-different-purpose': 'Multiple links that read the same (e.g. "Read more") but go to different destinations give screen reader users no way to distinguish them when browsing the links list.',
+    'link-new-window-warn': 'Links that silently open new tabs disorient keyboard and screen reader users — the Back button no longer works and the unexpected context shift is never announced.',
+    // Forms
+    'label-missing': 'Screen reader users tab to this field and hear only the input type (e.g. "text, edit"); they receive no indication of what information the field expects.',
+    'label-empty': 'The `<label>` exists but contains no text; screen reader users hear the input type only, with no indication of the field\'s purpose.',
+    'error-identification': 'Form validation errors are conveyed visually only; screen reader users receive no programmatic notification and cannot identify which fields failed or what went wrong.',
+    'autocomplete': 'Without the correct `autocomplete` attribute, password managers and browser autofill cannot identify the field, forcing users with motor disabilities to type credentials manually every time.',
+    'input-button-name': 'Screen reader users hear "button" with no label and cannot determine what action the button performs.',
+    'fieldset-legend': 'Related form controls have no group label; screen reader users navigating into the group have no context for what the inputs belong to (e.g. "Is this billing or shipping?").',
+    'form-field-required-label': 'Required fields are not programmatically marked as required; screen reader users are not warned the field is mandatory and may submit an incomplete form unexpectedly.',
+    // Language
+    'html-lang': 'Without a `lang` attribute, screen readers use the system language to read all content; foreign-language text is mispronounced and can be incomprehensible.',
+    'html-lang-valid': 'An unrecognized `lang` value causes screen readers to fall back to the system language, mispronouncing content and breaking language-specific text-to-speech features.',
+    // Color contrast
+    'color-contrast-text': 'Users with low vision or color blindness cannot distinguish this text from its background at the current contrast ratio; the text becomes difficult or impossible to read without assistive magnification.',
+    'color-contrast-large-text': 'Despite large text having a more relaxed contrast requirement, this element still fails that threshold; users with moderate low vision cannot read it reliably.',
+    // Keyboard
+    'no-positive-tabindex': 'Positive `tabindex` values override the natural tab order, causing keyboard users to jump erratically around the page instead of following its logical structure.',
+    'interactive-not-focusable': 'Keyboard users and screen reader users cannot reach this interactive element by tabbing — it is effectively invisible and unusable to anyone not using a mouse.',
+    'skip-link': 'Without a "skip to main content" link, keyboard users must tab through every navigation item on every page load before reaching the main content — often 20–40 tab presses on complex sites.',
+    'focus-visible': 'Keyboard users cannot see which element currently has focus; they lose their place on the page and cannot tell where their next keypress will act.',
+    'scrollable-region-focusable': 'A scrollable area that cannot receive keyboard focus traps keyboard users — they can see there is more content but cannot scroll to it without a mouse.',
+    'accesskey-unique': 'Duplicate `accesskey` values cause browsers to cycle through elements unpredictably; keyboard shortcut users cannot rely on the shortcut to reach the intended element.',
+    // ARIA
+    'aria-valid-role': 'An unrecognized ARIA role is ignored by assistive technologies; the element is presented without semantic meaning and screen reader users may navigate past it or interact with it incorrectly.',
+    'aria-required-attr': 'This ARIA widget is missing required attributes (e.g. `aria-checked` on `role="checkbox"`); screen readers cannot communicate the element\'s state, so users don\'t know if it is active, checked, or selected.',
+    'aria-hidden-focus': 'A focusable element inside `aria-hidden` receives keyboard focus but is invisible to screen readers; keyboard users land on an element and the screen reader announces nothing.',
+    'button-name': 'Screen reader users hear "button" with no label and cannot determine what action the button performs without exploring surrounding content visually.',
+    'aria-required-children': 'This ARIA container is missing required child roles (e.g. a `listbox` with no `option` children); screen readers either skip the widget or announce it in an unpredictable way.',
+    'aria-required-parent': 'This ARIA element is outside its required parent context; screen readers cannot establish the correct ownership relationship and may misreport the element\'s role or state.',
+    'aria-prohibited-attr': 'ARIA attributes applied where they are prohibited override the element\'s built-in semantics, causing screen readers to misannounce the element\'s role or state.',
+};
+export function fallbackExplanation(ruleId, description, wcag, level) {
+    return EXPLANATIONS[ruleId]
+        ?? `${description} — this prevents some users from accessing or understanding content on this page (WCAG 2.1 SC ${wcag}, Level ${level}).`;
+}

package/dist/ai/gemini.js

@@ -1,5 +1,6 @@
 import { buildPrompt } from './prompt.js';
 import { groupViolations } from './group.js';
+import { fallbackExplanation } from './fallback-explanation.js';
 export class GeminiProvider {
     apiKey;
     model;
@@ -45,15 +46,19 @@ export class GeminiProvider {
     }
     fallbackFix(g) {
         const v = g.representative;
-        const instanceNote = g.count > 1 ? ` There are ${g.count} similar instances at: ${g.selectors.join(', ')}.` : '';
+        const selectorList = g.selectors.map((s) => `- ${s}`).join('\n');
+        const explanation = fallbackExplanation(g.ruleId, g.description, g.wcag, g.level);
+        const prompt = g.count > 1
+            ? `Fix WCAG 2.1 SC ${g.wcag} (Level ${g.level}) — ${g.description}\n\nAffected elements (${g.count} instances):\n${selectorList}\n\nRepresentative HTML:\n\`${v.html.slice(0, 300)}\`\n\nApply the fix to all ${g.count} instances in the codebase to comply with WCAG 2.1 SC ${g.wcag}.`
+            : `Fix WCAG 2.1 SC ${g.wcag} (Level ${g.level}) — ${g.description}\n\nAffected element:\n- Selector: \`${g.selectors[0]}\`\n- HTML: \`${v.html.slice(0, 300)}\`\n\nApply the fix to comply with WCAG 2.1 SC ${g.wcag}.`;
         return {
             ruleId: g.ruleId,
             selectors: g.selectors,
             instanceCount: g.count,
-            explanation: g.description,
+            explanation,
             fixedCode: v.html,
             wcagReference: `WCAG 2.1 SC ${g.wcag}`,
-            optimalPrompt: `Fix this accessibility violation: The element \`${v.html.slice(0, 120)}\` at selector \`${g.selectors[0]}\` violates ${g.wcag} — ${g.description}.${instanceNote} Please fix it in the codebase.`,
+            optimalPrompt: prompt,
         };
     }
 }

package/dist/ai/ollama.js

@@ -1,5 +1,6 @@
 import { buildPrompt } from './prompt.js';
 import { groupViolations } from './group.js';
+import { fallbackExplanation } from './fallback-explanation.js';
 export class OllamaProvider {
     baseUrl;
     model;
@@ -43,15 +44,19 @@ export class OllamaProvider {
     }
     fallbackFix(g) {
         const v = g.representative;
-        const instanceNote = g.count > 1 ? ` There are ${g.count} similar instances at: ${g.selectors.join(', ')}.` : '';
+        const selectorList = g.selectors.map((s) => `- ${s}`).join('\n');
+        const explanation = fallbackExplanation(g.ruleId, g.description, g.wcag, g.level);
+        const prompt = g.count > 1
+            ? `Fix WCAG 2.1 SC ${g.wcag} (Level ${g.level}) — ${g.description}\n\nAffected elements (${g.count} instances):\n${selectorList}\n\nRepresentative HTML:\n\`${v.html.slice(0, 300)}\`\n\nApply the fix to all ${g.count} instances in the codebase to comply with WCAG 2.1 SC ${g.wcag}.`
+            : `Fix WCAG 2.1 SC ${g.wcag} (Level ${g.level}) — ${g.description}\n\nAffected element:\n- Selector: \`${g.selectors[0]}\`\n- HTML: \`${v.html.slice(0, 300)}\`\n\nApply the fix to comply with WCAG 2.1 SC ${g.wcag}.`;
         return {
             ruleId: g.ruleId,
             selectors: g.selectors,
             instanceCount: g.count,
-            explanation: g.description,
+            explanation,
             fixedCode: v.html,
             wcagReference: `WCAG 2.1 SC ${g.wcag}`,
-            optimalPrompt: `Fix this accessibility violation: The element \`${v.html.slice(0, 120)}\` at selector \`${g.selectors[0]}\` violates ${g.wcag} — ${g.description}.${instanceNote} Please fix it in the codebase.`,
+            optimalPrompt: prompt,
         };
     }
 }

package/dist/ai/openai.js

@@ -1,5 +1,6 @@
 import { buildPrompt } from './prompt.js';
 import { groupViolations } from './group.js';
+import { fallbackExplanation } from './fallback-explanation.js';
 export class OpenAIProvider {
     apiKey;
     model;
@@ -49,15 +50,19 @@ export class OpenAIProvider {
     }
     fallbackFix(g) {
         const v = g.representative;
-        const instanceNote = g.count > 1 ? ` There are ${g.count} similar instances at: ${g.selectors.join(', ')}.` : '';
+        const selectorList = g.selectors.map((s) => `- ${s}`).join('\n');
+        const explanation = fallbackExplanation(g.ruleId, g.description, g.wcag, g.level);
+        const prompt = g.count > 1
+            ? `Fix WCAG 2.1 SC ${g.wcag} (Level ${g.level}) — ${g.description}\n\nAffected elements (${g.count} instances):\n${selectorList}\n\nRepresentative HTML:\n\`${v.html.slice(0, 300)}\`\n\nApply the fix to all ${g.count} instances in the codebase to comply with WCAG 2.1 SC ${g.wcag}.`
+            : `Fix WCAG 2.1 SC ${g.wcag} (Level ${g.level}) — ${g.description}\n\nAffected element:\n- Selector: \`${g.selectors[0]}\`\n- HTML: \`${v.html.slice(0, 300)}\`\n\nApply the fix to comply with WCAG 2.1 SC ${g.wcag}.`;
         return {
             ruleId: g.ruleId,
             selectors: g.selectors,
             instanceCount: g.count,
-            explanation: g.description,
+            explanation,
             fixedCode: v.html,
             wcagReference: `WCAG 2.1 SC ${g.wcag}`,
-            optimalPrompt: `Fix this accessibility violation: The element \`${v.html.slice(0, 120)}\` at selector \`${g.selectors[0]}\` violates ${g.wcag} — ${g.description}.${instanceNote} Please fix it in the codebase.`,
+            optimalPrompt: prompt,
         };
     }
 }

package/dist/ai/prompt.js

@@ -11,10 +11,10 @@ export function buildPrompt(groups) {
 Each item must have:
 - "ruleId": the rule id from the input
 - "selectors": array of CSS selectors affected (copy from input)
-- "explanation": 1-2 sentences explaining why this matters for users with disabilities (plain English, no jargon)
+- "explanation": 1-2 sentences on concrete user impact — name exactly who is affected (e.g. "screen reader users", "keyboard-only users", "users with low vision") and what they cannot do because of this specific violation. Do not write generic statements like "users with disabilities may be affected."
 - "fixedCode": the corrected HTML snippet only (no explanation, just code)
-- "wcagReference": e.g. "WCAG 2.1 SC 1.1.1 — Non-text Content"
-- "optimalPrompt": a ready-to-paste prompt the developer can give to an AI coding assistant (Cursor, GitHub Copilot, Claude) to fix this issue in their codebase. Include the violating elements, what rule they break, how many instances there are, and exactly what change is needed. Be specific and actionable.
+- "wcagReference": the full criterion name, e.g. "WCAG 2.1 SC 1.1.1 Non-text Content (Level A)"
+- "optimalPrompt": a ready-to-paste prompt for an AI coding assistant (Cursor, Copilot, Claude). Structure it as: (1) state the WCAG 2.1/2.2 criterion being violated (e.g. "WCAG 2.1 SC 1.1.1 Non-text Content, Level A"), (2) list the affected selectors and HTML snippets, (3) state the exact code change needed to comply. Focus solely on the fix — do not explain why WCAG exists or what accessibility is. Be precise and actionable.
 
 Return ONLY a valid JSON array. No markdown, no code fences, no explanation outside the JSON.
 

package/dist/cli.js

@@ -3,6 +3,7 @@ import { Command } from 'commander';
 import { loadConfig, initConfig } from './config.js';
 import { crawl } from './crawler.js';
 import { createAIProvider } from './ai/index.js';
+import { groupViolations } from './ai/group.js';
 import { printTerminalReport, printAIPrompts } from './reporter/terminal.js';
 import { generateMarkdownReport } from './reporter/markdown.js';
 import { runDemo } from './demo.js';
@@ -10,7 +11,7 @@ const program = new Command();
 program
     .name('wcag-a11y')
     .description('WCAG 2.1/2.2 accessibility auditor with AI-powered fixes')
-    .version('0.2.0');
+    .version('0.3.0');
 program
     .command('init')
     .description('Create a11y.config.json in the current directory')
@@ -27,6 +28,8 @@ program
     .option('-r, --report', 'Save a full markdown report to a11y-report.md', false)
     .option('--no-ai', 'Skip AI fix generation (faster, violations only)')
     .option('--no-explain', 'Hide AI fix explanations in terminal output')
+    .option('--no-terminal', 'Suppress terminal output (violations summary)')
+    .option('--fast-mode', 'Output only AI fix prompts — no summaries or explanations', false)
     .option('--group <strategy>', 'Group violations by rule or show individually (rule|none)', 'rule')
     .option('--ci', 'Exit with code 1 if any violations are found (for CI/CD pipelines)', false)
     .option('--provider <name>', 'Override the AI provider from config (gemini|openai|ollama)')
@@ -34,7 +37,9 @@ program
     try {
         console.log(`\nScanning ${opts.url}...`);
         const result = await crawl({ url: opts.url, pages: opts.pages, crawl: opts.crawl });
-        printTerminalReport(result);
+        if (opts.terminal && !opts.fastMode) {
+            printTerminalReport(result);
+        }
         const strategy = opts.group === 'none' ? 'none' : 'rule';
         if (opts.ai && result.totalViolations > 0) {
             const config = loadConfig();
@@ -43,15 +48,20 @@ program
             }
             const provider = createAIProvider(config);
             const allViolations = result.pages.flatMap((p) => p.violations);
-            console.log(`\nGenerating AI fixes for ${allViolations.length} violations...`);
+            const ruleGroups = groupViolations(allViolations, strategy);
+            if (!opts.fastMode) {
+                console.log(`\nGenerating AI fixes for ${ruleGroups.length} rule groups (${allViolations.length} violations)...`);
+            }
             const fixes = await provider.generateFixes(allViolations, strategy);
-            printAIPrompts(fixes, { explain: opts.explain });
+            if (opts.terminal) {
+                printAIPrompts(fixes, { explain: opts.explain, fastMode: opts.fastMode });
+            }
             if (opts.report) {
-                generateMarkdownReport(result, fixes);
+                generateMarkdownReport(result, fixes, { fastMode: opts.fastMode });
             }
         }
         else if (opts.report) {
-            generateMarkdownReport(result, []);
+            generateMarkdownReport(result, [], { fastMode: opts.fastMode });
         }
         if (opts.ci && result.totalViolations > 0) {
             process.exit(1);

package/dist/reporter/markdown.js

@@ -5,7 +5,31 @@ const IMPACT_EMOJI = {
     moderate: '🟡',
     minor: '🟢',
 };
-export function generateMarkdownReport(result, fixes, outputPath = 'a11y-report.md') {
+export function generateMarkdownReport(result, fixes, opts = {}, outputPath = 'a11y-report.md') {
+    const lines = opts.fastMode
+        ? buildFastReport(fixes)
+        : buildFullReport(result, fixes);
+    writeFileSync(outputPath, lines.join('\n'), 'utf-8');
+    console.log(`\nReport saved → ${outputPath}`);
+}
+function buildFastReport(fixes) {
+    const lines = [
+        '# WCAG A11y — Fix Prompts',
+        `> Generated: ${new Date().toLocaleString()}`,
+        '',
+    ];
+    for (const fix of fixes) {
+        const countLabel = fix.instanceCount > 1 ? ` ×${fix.instanceCount}` : '';
+        lines.push(`## \`${fix.ruleId}\`${countLabel}`, '');
+        lines.push('**Selectors:**');
+        for (const sel of fix.selectors) {
+            lines.push(`- \`${sel}\``);
+        }
+        lines.push('', '```', fix.optimalPrompt, '```', '', '---', '');
+    }
+    return lines;
+}
+function buildFullReport(result, fixes) {
     const lines = [
         '# WCAG A11y Report',
         `> Generated: ${new Date().toLocaleString()}`,
@@ -37,6 +61,5 @@ export function generateMarkdownReport(result, fixes, outputPath = 'a11y-report.
             lines.push('---', '');
         }
     }
-    writeFileSync(outputPath, lines.join('\n'), 'utf-8');
-    console.log(`\nReport saved → ${outputPath}`);
+    return lines;
 }

package/dist/reporter/terminal.js

@@ -1,4 +1,5 @@
 import chalk from 'chalk';
+import { groupViolations } from '../ai/group.js';
 const IMPACT_COLOR = {
     critical: chalk.red,
     serious: chalk.yellow,
@@ -22,12 +23,17 @@ export function printTerminalReport(result) {
             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)}`);
+        const groups = groupViolations(page.violations, 'rule');
+        for (const g of groups) {
+            const color = IMPACT_COLOR[g.impact] ?? chalk.white;
+            const countSuffix = g.count > 1 ? chalk.gray(` ×${g.count}`) : '';
+            const tag = color(`[${g.impact.toUpperCase()}]`) + countSuffix;
+            const wcag = chalk.gray(`WCAG ${g.wcag}`);
+            console.log(`     ${tag} ${g.description}  ${wcag}`);
+            console.log(`     ${chalk.gray('→')} ${chalk.dim(g.selectors[0])}`);
+            if (g.count > 1) {
+                console.log(`     ${chalk.gray(`   …and ${g.count - 1} more`)}`);
+            }
         }
     }
     console.log('\n' + chalk.gray('─'.repeat(60)));
@@ -37,6 +43,15 @@ export function printTerminalReport(result) {
 export function printAIPrompts(fixes, opts) {
     if (fixes.length === 0)
         return;
+    if (opts.fastMode) {
+        for (let i = 0; i < fixes.length; i++) {
+            console.log(fixes[i].optimalPrompt);
+            if (i < fixes.length - 1)
+                console.log('\n' + chalk.gray('─'.repeat(60)));
+        }
+        console.log('');
+        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) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wcag-a11y",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "WCAG 2.1/2.2 accessibility auditor with AI-powered fixes",
   "type": "module",
   "bin": {