// Canonical severity level definitions and cross-domain mapping for web, document, and markdown audits. Score impact ranges, WCAG conformance alignment, and cross-format normalization.
Compute web accessibility scores (0-100, A-F grades) with severity scoring, confidence levels, and remediation tracking across audits.
Audit and fix markdown for accessibility. Covers ambiguous links, anchors, emoji (remove/translate), Mermaid/ASCII templates, heading hierarchy, table descriptions, and severity scoring.
Cross-format accessibility rule reference with WCAG 2.2 mapping for Word, Excel, PowerPoint, and PDF documents.
CI/CD accessibility pipeline patterns with axe-core CLI, SARIF output, PR annotations, baseline management, and multi-platform CI templates.
Review UI for cognitive load, plain language clarity, and WCAG 2.2 cognitive SC (3.3.7, 3.3.8, 3.3.9). Includes COGA guidance, reading level, auth patterns, and timeout warnings.
Audit charts and graphs for accessibility: SVG ARIA, data table alternatives, keyboard interaction, color-safe palettes, and library APIs.
| name | severity-mapping |
| description | Canonical severity level definitions and cross-domain mapping for web, document, and markdown audits. Score impact ranges, WCAG conformance alignment, and cross-format normalization. |
Canonical severity definitions shared across web, document, and markdown audit domains.
| Level | Definition | WCAG Conformance | Score Impact |
|---|---|---|---|
| Critical | Blocks access entirely for one or more user groups. No workaround exists. | Fails Level A | -15 to -22 points |
| Serious | Severely impairs access; a workaround may exist but is unreasonable. | Fails Level A or AA | -5 to -10 points |
| Moderate | Causes friction or confusion; most users can still complete the task. | Fails Level AA (advisory) | -2 to -4 points |
| Minor | Polish issue; no meaningful barrier for most users. | Technique deviation | -1 point |
| Canonical Level | Web (axe-core / Playwright) | Document (Office/PDF) | Markdown |
|---|---|---|---|
| Critical | critical (axe-core) | Missing document title; untagged PDF; missing heading structure | Broken anchor link leading to dead navigation |
| Serious | serious (axe-core) | Missing alt text on informational image; table has no headers | Ambiguous link text (e.g., "click here"); missing alt text on image |
| Moderate | moderate (axe-core) | Merged table cells; color-only data encoding | Skipped heading level; missing table caption |
| Minor | minor (axe-core) | Decorative image with non-empty alt; redundant bookmark | Emoji in heading; em-dash used as list separator |
Score impacts listed above are additive per finding. When the same issue recurs across many elements:
When generating a unified report that combines web, document, and markdown findings:
For web audits, confidence level modifies the base deduction:
| Confidence | Multiplier | Source Signals |
|---|---|---|
| Confirmed | 1.2x | axe-core + agent code review + Playwright behavioral test |
| High (two sources) | 1.0x | Any two of the three sources above |
| High (one source) | 1.0x (reduced base) | Single automated tool, high rule reliability |
| Medium | 0.7x | Single source, medium rule reliability |
| Low | 0.3x | Single source, low rule reliability or heuristic |
Document and markdown audits do not use confidence multipliers -- they use the base score impact only.