Sibling contract
Accessibility
Accessibility is structural: it shapes the first version rather than the last audit. This contract makes that principle machine-checkable.
Version 0.1.2 · provisional · machine export
Source authority
- Primary engine
- axe-core 4.13.0 (Deque Systems)
- Conformance standard
- W3C WCAG 2.2 (W3C Recommendation, 2023-10-05)
- Provenance layer
- W3C Accessibility Conformance Testing: act-rules.github.io
Conformance
- Conformance level
- WCAG 2.2 Level AA (includes all A and AA from WCAG 2.0, 2.1, 2.2)
- Ruleset export
axe ruleset --wcag22 designesy-a11y-ruleset.json
- Provenance chain
- axe rule → ACT rule ID → WCAG success criterion → WCAG principle → remediation hint
Verification
11 checks. PASS=1, WARN=0.5, FAIL=0, N/A=excluded. Score = (points/applicable) × 100. A≥90, B≥80, C≥70, D≥60, F<60.
01 a01 · No WCAG 2.2 AA violations (axe-core rules tagged wcag2a, wcag2aa, wcag21a, wcag21aa or wcag22aa) Pass 0 violations Fail Any violation
02 a02 · Color contrast passes AA 4.5:1 (normal), 3:1 (large) Pass All pass Fail Any fail
03 a03 · Keyboard navigation: tab order, focus-visible, no keyboard traps Pass All pass Fail Any fail
04 a04 · ARIA correctness: roles, labels, required children Pass All pass Fail Any fail
05 a05 · Form labels and error identification Pass All pass Fail Any fail N/A No forms
06 a06 · Heading hierarchy (h1 → h2 → h3, no skipped levels) Pass Correct Fail Skipped level
07 a07 · Landmarks present (main, nav, footer) Pass Present Fail Missing
08 a08 · Target Size Minimum 2.5.8 (24x24px or spacing exception) Pass All pass Fail Any fail
09 a09 · Focus Not Obscured 2.4.11 (focused element not hidden) Pass All pass Fail Any fail
10 a10 · prefers-reduced-motion stops movement: nothing translates, rotates, scales or pans for longer than 200 ms or in a loop. Opacity-only fades may continue. Demos whose motion is the content play on request (tiered, core §16.8; v0.1.1) Pass No movement under reduce Fail Movement continues under reduce
11 a11 · No internal control-plane names leaked onto public surfaces (brand boundary) Pass Clean Fail Found
Open questions
- Server-side execution: CDP (existing infrastructure) vs Playwright (axe native driver)?
- AAA targeting: which WCAG 2.2 AAA criteria should Designesy target selectively?
- BridgePCA: adopt as contrast algorithm, or keep WCAG 2.2 with documented deviation?
- Accessibility floor: raise from 60% to 70%?
- Second-source triangulation: run IBM Equal Access Checker alongside axe?
Sibling contract to the design system v0.4.6. Machine export at /contracts/a11y.json.