@diegovelasquezweb/a11y-engine 0.10.2 → 0.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (13) hide show
  1. package/CHANGELOG.md +16 -0
  2. package/assets/remediation/intelligence.mjs +4818 -1
  3. package/assets/scanning/cdp-checks.mjs +60 -1
  4. package/docs/api-reference.md +22 -2
  5. package/docs/architecture.md +24 -1
  6. package/docs/intelligence.md +2 -2
  7. package/docs/outputs.md +5 -1
  8. package/package.json +1 -1
  9. package/src/ai/claude.mjs +66 -5
  10. package/src/enrichment/analyzer.mjs +30 -0
  11. package/src/index.d.mts +56 -1
  12. package/src/index.mjs +10 -1
  13. package/src/pipeline/dom-scanner.mjs +242 -21
package/CHANGELOG.md CHANGED
@@ -5,6 +5,22 @@ All notable changes to this project will be documented in this file.
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
 
8
+ ## [0.10.3] — 2026-03-16
9
+
10
+ ### Added
11
+
12
+ - **3 new CDP checks** — `cdp-autoplay-media` (WCAG 1.4.2, 2.2.2 — serious), `cdp-missing-main-landmark` (WCAG 1.3.1 — moderate), `cdp-missing-skip-link` (WCAG 2.4.1 — moderate). These use `page.evaluate()` DOM inspection and complement the existing accessibility-tree-based CDP checks.
13
+ - **Intelligence entries for the 3 new CDP checks** — full fix descriptions, fix code, framework notes (React, Vue, Angular, Svelte, Astro), CMS notes (Shopify, WordPress, Drupal), and guardrails added to `assets/remediation/intelligence.mjs`.
14
+ - **`best-practice` and `ACT` as opt-in `axeTags`** — documented in API reference and type declarations. Pass `axeTags: ["wcag2a", "wcag2aa", "best-practice", "ACT"]` to include non-WCAG best practices and W3C ACT rules.
15
+ - **`passesCount`, `incompleteCount`, `inapplicableCount` in `ScanPayload.metadata`** — axe-core passes, incomplete, and inapplicable counts are now exposed as numeric fields in the metadata object.
16
+ - **`cdp-checks.test.mjs`** — new dedicated test file for DOM-eval CDP check logic.
17
+ - **pa11y shared Puppeteer browser** — a single Puppeteer browser is now launched once per scan and shared across all pa11y route invocations. Eliminates Chrome cold-start overhead (1-3s) per route. Falls back to per-route launch if Puppeteer is unavailable.
18
+ - **pa11y parallelized with axe+CDP** — pa11y now starts in parallel with the axe→CDP sequence instead of running sequentially after them. Since pa11y uses its own browser and receives only the URL, it is fully independent. This hides pa11y's latency behind axe+CDP, reducing per-route scan time.
19
+ - **`clearCache` option** — new `RunAuditOptions.clearCache` (default `false`). When `true`, clears browser cache via CDP `Network.clearBrowserCache` + `Network.setCacheDisabled` before each page navigation. Ensures fresh scan results on repeated scans of the same domain. Also available as `--clear-cache` CLI flag.
20
+ - **`serverMode` option** — new `RunAuditOptions.serverMode` (default `false`). When `true`, passes EC2/Docker-optimized Chrome launch flags to Playwright: `--no-sandbox`, `--disable-setuid-sandbox`, `--disable-dev-shm-usage`, `--disable-gpu`, `--no-zygote`, `--disable-accelerated-2d-canvas`. Use in CI, Docker, or EC2 environments. Also available as `--server-mode` CLI flag.
21
+
22
+ ---
23
+
8
24
  ## [0.9.0] — 2026-03-16
9
25
 
10
26
  ### Changed