Design-system accessibility profiles

design-system specs/design-system/a11y-profiles.kmd

Defines the named accessibility PROFILES a design-system manifest may declare in `[a11y].profiles` — what each ("emag-3.1", "forced-colors", "libras") requires on top of the universal WCAG 2.2 AA baseline — and anchors the gov.br DS profile (WCAG 2.2 AA + eMAG 3.1 + LBI + Libras). Gives the manifest's bare profile strings a normative meaning the conformance gate (stack#413) can validate. Delegates the WCAG/eMAG/LBI mapping to conformance-br.kmd — it does not restate it.

Quando esta spec se aplica

Triggers primários

Todos os triggers

Design-system accessibility profiles

R1 — Baseline + additive profiles

Every DS builds to one technical baseline — WCAG 2.2 Level AA — declared as [a11y].baseline = "wcag-2.2-aa" (manifest.kmd; the floor is non-negotiable, no DS declares less). A DS then adds profiles — named, additive extensions listed in [a11y].profiles — each of which layers requirements on top of the baseline. A profile never lowers the baseline; it only adds. The conformance gate (stack#413) reads baseline + each declared profile and validates them.

R2 — The named profiles

ProfileWhat it adds over WCAG 2.2 AABinds to
emag-3.1The BR-government layer: the eMAG 3.1 recommendations + LBI (Lei 13.146) obligations that WCAG AA does not cover — an accessibility-statement page, plain-language communication, and Libras/text alternatives on public institutional content.conformance-br.kmd R2 (matrix) + R3 (BR additions) + R4 (declaration artifact)
forced-colorsSupport for OS forced-colors / high-contrast: honour forced-colors: active, keep meaning without colour, no color-only signalling, visible focus in the forced palette.themes/light-dark.kmd (contrast) + WCAG 1.4.1/1.4.11
librasA Libras (Brazilian Sign Language) interpreter track on video/media surfaces, alongside captions + transcript.stack#409 (accessibility/media.kmd)

emag-3.1 implies the Libras/captions obligation for public institutional video (conformance-br.kmd R3); a DS whose surfaces carry such video SHOULD also declare libras so the gate checks the interpreter track explicitly.

R3 — The gov.br DS profile (exemplar)

The govbr DS (koder.designsystem.toml) declares:

[a11y]
baseline = "wcag-2.2-aa"
profiles = ["forced-colors", "emag-3.1"]   # + "libras" where the surface carries institutional video

That is the full BR federal a11y contract: WCAG 2.2 AA + eMAG 3.1 + LBI, with the federal components meeting it (the eMAG skip-link, the accessibility-statement page, the plain-language microcopy) — see govbr-federal-pack.kmd R5. Libras is added on media surfaces (stack#409). This profile is what makes a gov.br surface conformant for federal publication, not merely WCAG-AA-green.

R4 — Validation

The conformance gate (stack#413) is the enforcement point: for a DS it validates the wcag-2.2-aa baseline (machine-checkable subset via an axe-core-class scan, per conformance-br.kmd R5) plus each declared profile's additional requirements. The machine-uncheckable parts (statement page present, Libras track present, plain-language review) are the profile's manual checklist, surfaced by the gate as required evidence, not silently passed.

Não-escopo

  • The WCAG ↔ eMAG ↔ LBI mapping and the declaration-artifact format — owned by conformance-br.kmd (R2/R4); this spec binds to it, does not restate it.
  • The Libras/captions media contract — stack#409 (accessibility/media.kmd).
  • The federal components that meet the profile — govbr-federal-pack.kmd.
  • The [a11y] TOML schema itself — manifest.kmd.

Referências