wcag-a11y 0.4.1 → 0.4.3

package/README.md

@@ -87,6 +87,12 @@ wcag-a11y scan -u http://localhost:3000
 
 Add `--pages / /about /contact` to scan specific routes, or `--crawl` to follow links automatically.
 
+**Optional — set your framework once:** The tool auto-detects common frameworks at runtime. If detection fails (e.g. scanning a staging URL, or using Astro/SvelteKit), set it in your config so every run uses the right syntax:
+
+```bash
+wcag-a11y init --framework next    # or react, vue, angular, svelte, astro, …
+```
+
 ---
 
 ## Commands
@@ -116,6 +122,7 @@ wcag-a11y scan -u http://localhost:3000 --terminal --fast-mode
 | `--group <strategy>` | `rule` | `rule`: one prompt per rule type. `none`: one prompt per element |
 | `--ci` | off | Exit with code `1` if any violations are found |
 | `--provider <name>` | from config | Override AI provider for this run |
+| `--framework <name>` | from config | *(optional)* Override framework for this run. Auto-detected by default; use this when scanning staging URLs or for frameworks outside the detection list |
 
 ---
 
@@ -159,6 +166,7 @@ wcag-a11y fix --from-report --apply       # patches files from that report, no s
 | `--from-report [path]` | `a11y-report.md` | Load violations from an existing report instead of rescanning |
 | `--apply` | off | Write fixes to disk (dry-run without this flag) |
 | `--provider <name>` | from config | Override AI provider for this run |
+| `--framework <name>` | from config | *(optional)* Override framework for this run. Auto-detected by default; use this when scanning staging URLs or for frameworks outside the detection list |
 
 ---
 
@@ -167,13 +175,19 @@ wcag-a11y fix --from-report --apply       # patches files from that report, no s
 Create `a11y.config.json` pre-configured for your chosen provider.
 
 ```bash
-wcag-a11y init                          # Gemini (free, default)
+wcag-a11y init                                      # Gemini (free, default)
 wcag-a11y init --provider openai
-wcag-a11y init --provider anthropic
-wcag-a11y init --provider ollama        # local — no API key needed
-# … and 8 more providers
+wcag-a11y init --provider ollama                    # local — no API key needed
+wcag-a11y init --provider openai --framework next   # optional: save framework too
 ```
 
+| Flag | Description |
+|---|---|
+| `--provider <name>` | AI provider. Default: `gemini`. See [AI Providers](#ai-providers) for all options |
+| `--framework <name>` | *(optional)* Your project framework — saved to config so every scan uses it automatically. The tool auto-detects common frameworks; use this flag when scanning staging URLs or using a framework not in the detection list |
+
+Accepted framework values: `next`, `react`, `vue`, `nuxt`, `angular`, `svelte`, `gatsby`, `remix`, `astro` — or any free-form string. You can also add `"framework": "next"` directly to `a11y.config.json` at any time.
+
 ---
 
 ### `wcag-a11y demo`
@@ -221,6 +235,16 @@ Run `wcag-a11y init` to generate `a11y.config.json`. Only fill in the fields for
 }
 ```
 
+`"framework"` is optional — add it if auto-detection fails for your setup:
+
+```json
+{
+  "provider": "gemini",
+  "apiKey": "YOUR_GEMINI_API_KEY",
+  "framework": "next"
+}
+```
+
 <details>
 <summary>Full config reference (all 12 providers)</summary>
 

package/dist/cli.js

@@ -13,13 +13,14 @@ const program = new Command();
 program
     .name('wcag-a11y')
     .description('WCAG 2.1/2.2 accessibility auditor with AI-powered fixes')
-    .version('0.4.1');
+    .version('0.4.3');
 program
     .command('init')
     .description('Create a11y.config.json in the current directory')
     .option('--provider <name>', 'AI provider to configure (gemini|openai|ollama|anthropic|mistral|groq|cohere|xai|deepseek|together|perplexity|azure-openai)', 'gemini')
+    .option('--framework <name>', 'Your project framework — saves to config so every run uses it automatically (e.g. next, react, vue, angular, svelte, astro)')
     .action((opts) => {
-    initConfig(opts.provider);
+    initConfig(opts.provider, opts.framework);
 });
 program
     .command('scan')
@@ -35,10 +36,11 @@ program
     .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|anthropic|mistral|groq|cohere|xai|deepseek|together|perplexity|azure-openai)')
+    .option('--framework <name>', 'Override framework detection for this run (e.g. next, react, vue, angular, svelte, astro)')
     .action(async (opts) => {
     try {
         console.log(`\nScanning ${opts.url}...`);
-        const result = await crawl({ url: opts.url, pages: opts.pages, crawl: opts.crawl });
+        const result = await crawl({ url: opts.url, pages: opts.pages, crawl: opts.crawl, framework: opts.framework });
         if (opts.terminal && !opts.fastMode) {
             printTerminalReport(result);
         }
@@ -51,10 +53,11 @@ program
             const provider = createAIProvider(config);
             const allViolations = result.pages.flatMap((p) => p.violations);
             const ruleGroups = groupViolations(allViolations, strategy);
+            const framework = result.framework ?? config.framework;
             if (!opts.fastMode) {
                 console.log(`\nGenerating AI fixes for ${ruleGroups.length} rule groups (${allViolations.length} violations)...`);
             }
-            const fixes = await provider.generateFixes(allViolations, strategy, result.framework);
+            const fixes = await provider.generateFixes(allViolations, strategy, framework);
             if (opts.terminal) {
                 printAIPrompts(fixes, { explain: opts.explain, fastMode: opts.fastMode });
             }
@@ -83,6 +86,7 @@ program
     .option('--from-report [path]', 'Use an existing report instead of scanning (default: a11y-report.md)')
     .option('--apply', 'Write fixes to source files (default: dry-run, shows diff only)', false)
     .option('--provider <name>', 'Override the AI provider from config (gemini|openai|ollama|anthropic|mistral|groq|cohere|xai|deepseek|together|perplexity|azure-openai)')
+    .option('--framework <name>', 'Override framework detection for this run (e.g. next, react, vue, angular, svelte, astro)')
     .action(async (opts) => {
     if (!opts.url && !opts.fromReport) {
         console.error('\nError: provide --url <url> to scan, or --from-report [path] to load an existing report.');
@@ -104,6 +108,7 @@ program
             apply: opts.apply,
             provider,
             srcDir: resolve(process.cwd(), 'src'),
+            framework: opts.framework ?? config.framework,
         });
     }
     catch (err) {

package/dist/config.js

@@ -82,13 +82,14 @@ const STARTER_CONFIGS = {
         `Created ${CONFIG_FILE} — fill in your Azure OpenAI endpoint, deployment, and API key from https://portal.azure.com`,
     ],
 };
-export function initConfig(provider = 'gemini') {
+export function initConfig(provider = 'gemini', framework) {
     const configPath = join(process.cwd(), CONFIG_FILE);
     if (existsSync(configPath)) {
         console.log(`${CONFIG_FILE} already exists.`);
         return;
     }
     const [starter, message] = STARTER_CONFIGS[provider];
-    writeFileSync(configPath, JSON.stringify(starter, null, 2));
+    const config = framework ? { ...starter, framework } : starter;
+    writeFileSync(configPath, JSON.stringify(config, null, 2));
     console.log(message);
 }

package/dist/crawler.js

@@ -61,7 +61,7 @@ export async function crawl(options) {
             }
         }
         const results = [];
-        let framework;
+        let framework = options.framework;
         for (const pageUrl of pagesToVisit) {
             const page = await context.newPage();
             try {

package/dist/fixer.js

@@ -18,11 +18,12 @@ export async function runFix(opts) {
             console.log(chalk.green('\nNo violations found in report.'));
             return;
         }
+        framework = opts.framework;
         console.log(`Found ${allViolations.length} violation(s) in report. Locating source files...\n`);
     }
     else {
         console.log(`\nScanning ${opts.url}...`);
-        const result = await crawl({ url: opts.url, pages: opts.pages, crawl: opts.crawl });
+        const result = await crawl({ url: opts.url, pages: opts.pages, crawl: opts.crawl, framework: opts.framework });
         framework = result.framework;
         if (result.totalViolations === 0) {
             console.log(chalk.green('\nNo violations found.'));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wcag-a11y",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "description": "WCAG 2.1/2.2 accessibility auditor with AI-powered fixes. Crawls your dev server with Playwright, runs 40+ checks, and uses AI (12 providers) to generate fix prompts or patch source files directly.",
   "keywords": [
     "wcag",