8000 Accessibility: the rail, announcements, contrast · Issue #42 · kiran-brahma/writing-tool · GitHub
[go: up one dir, main page]

Skip to content

Accessibility: the rail, announcements, contrast #42

Closed

Description

@kiran-brahma

Parent

#34 — the Obelus v1.2 spec (docs/specs/obelus-v1.2.md). Covers stories 185–187.

Blocked by #35 — the Band control is the tablist this ticket wires up.

What to build

Three defects, all on the rail.

No tab-panel linkage. src/App.tsx renders role="tablist" with tabs carrying aria-selected,
but no panel has role="tabpanel", and there is no aria-controls / id pairing. After #35 the
Band control is the tablist; wire it properly.

Nothing is announced. A Run finishing, a Run failing and a Judge Verdict arriving all change the
screen silently. A Writer using a screen reader is left waiting on a spinner they cannot see. Add one
polite aria-live region and route those three events through it.

Contrast and size. Disabled Pass names use text-stone-400 on the rail's stone-100/60 — about
2.3:1, against a 4.5:1 minimum. Cost estimates are text-[11px] and held badges text-[10px]. Raise
both. Keep disabled Passes visibly distinct from enabled ones — the fix is legibility, not sameness.

Where

  • src/App.tsx — the Band control and its panels; the live region.
  • src/editor/ModelPassesPanel.tsx, RulePassesPanel.tsx, JudgePanel.tsx — the announced events
    and the two type sizes.
  • Tailwind classes throughout the rail.

Acceptance criteria

  • The Band control is a tablist; each Band's panel is a tabpanel with matching
    aria-controls and id. (story 185)
  • A polite aria-live region announces a Run finishing, a Run failing and a Verdict arriving.
    (story 186)
  • Every text/background pair on the rail meets 4.5:1, disabled Pass names included. (story 187)
  • No text on the rail is below 12px. (story 187)
  • A disabled Pass is still visibly distinguishable from an enabled one.
  • Keyboard focus is visible on every control the rail adds, and the Band control is operable by
    keyboard alone.

Verification

Compute the contrast ratios and record them in the closing comment — the pairs you changed, before
and after. The ARIA wiring and the announcements are an observable checklist, stated the same way.

No DOM layer. Do not add Testing Library, jsdom or an axe runner; a test layer needs its own ticket
and an ADR — see the spec's Testing Decisions.

Constitution

Unchanged. Nothing here inserts model-derived text. The live region announces that a Run finished; it
does not read model output aloud as advice.

Metadata

Metadata

Assignees

No one assigned

    Labels

    accessibilityBarrier affecting people with disabilitiesready-for-agentSpec is ready for an agent to implement

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions

      0