How likebloodmoon/eaa-kit works
eaa-kit is a build-time WCAG 2.2 AA auditor and accessibility-statement generator. Its principal workflow discovers a project or accepts a build/URL, collects pages, audits them, and emits reports; optional review records and baselines add human checks and regression comparisons. Separate capabilities generate country-specific statements and integrate audits into build tools. The README documents several workflows whose implementation was not sampled; those edges cite the README, and no unsampled source is treated as inspected.
Main entry points: audit.ts Audit command · pages.ts Page resolution · index.ts CLI dispatcher · statement.ts Statement command
Components 25
CLI workflows
- CLI dispatcher
src/cli/index.ts - Audit command
src/cli/audit.ts - Config validation
src/config/define.ts
Project discovery
- Project detection
src/audit/project.ts - Stack detection
src/audit/frameworks.ts - Route discovery
src/audit/routes.ts - Page resolution
src/cli/pages.ts - Filesystem helpers
src/fs.ts
Audit and analysis
- HTML collection
src/audit/collect.ts - Running-site crawl
src/audit/crawl.ts - Browserless engine
src/audit/runners/jsdom.ts - Chromium engine
src/audit/runners/playwright.ts - Finding shaping
src/audit/result.ts - WCAG coverage
src/audit/coverage.ts - Severity thresholds
src/audit/impact.ts
Reports and assurance
- Manual review
src/audit/review.ts - Regression baseline
src/audit/baseline.ts - Page cache
src/audit/cache.ts - Fix guidance
src/audit/remediation.ts - Audit reports
src/audit/report
Statements and integrations
- Statement command
src/cli/statement.ts - Statement rendering
src/statement/render.ts - Country rules
src/config/countries.ts - Build integrations
src/integration/run.ts
Other components
- Site maintainer
Connections 25
- Site maintainer → CLI dispatcher: runs command
README.md - CLI dispatcher → Audit command: dispatches
src/cli/index.ts - CLI dispatcher → Statement command: dispatches
src/cli/index.ts - Audit command → Page resolution: resolves pages
src/cli/audit.ts - Page resolution → Project detection: detects project
src/cli/pages.ts - Project detection → Stack detection: detects stack
src/audit/project.ts - Page resolution → Running-site crawl: crawls running site
src/cli/pages.ts - Page resolution → HTML collection: collects build HTML
src/cli/pages.ts - HTML collection → Filesystem helpers: checks paths
src/audit/collect.ts - Audit command → Browserless engine: runs audit
src/cli/audit.ts - Audit command → Chromium engine: selects browser engine
src/cli/command.ts - Browserless engine → Finding shaping: shapes findings
src/audit/runners/jsdom.ts - Audit command → WCAG coverage: reports coverage
README.md - Audit command → Severity thresholds: applies threshold
src/cli/audit.ts - Audit command → Manual review: reads review
src/cli/audit.ts - Audit command → Regression baseline: checks regressions
README.md - Audit command → Page cache: reuses unchanged pages
README.md - Finding shaping → Fix guidance: adds fix guidance
README.md - Audit command → Audit reports: writes reports
src/cli/audit.ts - Statement command → Config validation: loads configuration
- Statement command → Statement rendering: generates statement
README.md - Statement rendering → Country rules: selects country text
src/config/countries.ts - Statement rendering → Manual review: includes review evidence
src/statement/render.ts - Build integrations → Audit command: runs build audit
src/integration/run.ts - Site maintainer → Build integrations: configures build hook
README.md