# Accessibility Acceptance Check

This file records the manual screen-reader acceptance check for release
readiness.
Automated tests cover focus policy, labels, localisation, and review
state logic, but they cannot verify actual screen-reader speech.

## Target Environment

- Platform: Windows 11 25H2, AMD64, build 26200.8457
- Screen reader: NVDA 2026.1 (2026.1.0.55743)
- Application revision: current tip at the time of each release readiness check
- Latest recorded manual validation: 2026-05-18
- Languages checked: English, Spanish, and Galician
- Input method: keyboard only
- Usage basis: daily screen-reader use, plus focused checks of newer workflows

## Current Pre-Release Manual Check

The current release-candidate workflows have received a focused Windows/NVDA
check in the maintained languages where practical. The manual release checklist
has been completed for this pass except for the corrupt-database scenario,
which still needs a deliberate corrupt database fixture or manual setup:

- timed exam setup, timeout and exam-finished notices, progress tones,
  grading/review, and summary
- quiz setup, question choices, delayed answer review, and summary
- reorganised File, Deck, Card, Study, Tools, View, and Help menus
- sectioned learning dashboard, Copy to Clipboard, and Save Report
- `Tools -> Generate Audio` availability after metadata edits and when
  `audio_generation=disabled` protects a manual-audio deck
- full deck export, full deck backup, and export with study history dialogues

## Accepted Behaviour

### Screen Reader and Keyboard

- On startup, focus lands on the ready-screen summary.
- The ready-screen summary reports deck size, scheduled cards, minimum session
  size, and the review database path.
- If minimum-fill cards are included, the ready-screen summary reports the due
  count in parentheses after the scheduled count.
- The prompt list is reachable from the keyboard and supports arrow-key
  navigation.
- Ready-list filtering and sorting remain reachable without trapping focus.
- Ready-list filtering, sorting, card editing, and reverse-card changes keep
  the same card selected when that card remains visible; adding a card selects
  the newly added card; deleting a card selects the next visible card in the
  current list order.
- Pressing Alt+Enter on a selected prompt-list item opens the card details
  dialogue.
- `Alt-S` starts a scheduled session from the ready screen in English.
- `Alt-M` starts a scheduled session from the ready screen in Spanish.
- `Alt-T` starts an unscheduled full-deck session from the ready screen in English.
- `Alt-F` starts an unscheduled full-deck session from the ready screen in Spanish.
- `Alt-Q` quits from the ready screen in English.
- `Alt-S` quits from the ready screen in Spanish.
- `Alt-A` opens the add-card dialogue in English.
- `Alt-D` opens the add-card dialogue in Spanish.
- `Alt-E` opens the edit-card dialogue for the selected card.
- `Delete` opens removal for the selected card when focus is in the prompt
  list.
- `Ctrl-F` flags or unflags the selected prompt-list card, and flags or
  unflags the current card during review.
- The prompt-list context menu and Card menu expose Flag/Unflag for the
  selected card, and review exposes a tabbable Flag/Unflag button after the
  confidence and recall rating buttons.
- Add, edit, remove, options, and statistics dialogues expose usable labels,
  focus order, and keyboard paths.
- Pressing Enter accepts the options dialogue when appropriate.
- Pressing Enter activates Continue on the statistics dialogue.
- During review, prompt text is focusable before the pre-response rating.
- Number keys `1` through `4` activate the pre-response rating controls.
- Space activates Reveal Response and skips the pre-response rating.
- Response text is focusable before the recall feedback rating.
- Number keys `1` through `4` activate the recall feedback controls.
- `e` opens the edit-card dialogue after the response is revealed, and focus
  returns to the previously focused post-response control afterwards.
- `0` ends the current session early from either rating phase.
- After Continue from session statistics, focus returns to the prompt list.
- English, Spanish, and Galician UI strings are understandable and retain the
  expected keyboard paths.
- `Deck -> Edit Deck Metadata` remains usable with a screen reader, including
  deck metadata fields, prompt and response voice fields, and voice engine
  selection.
- `Tools -> Generate Audio` is disabled when required deck voice metadata is
  absent or when the deck is marked as manual audio, becomes available after
  complete metadata is saved and generation is allowed, and exposes a progress
  bar that NVDA can track without verbose repeated status text.
- The ready-list `Play/Stop Audio` control and `Ctrl+P` preview the selected
  card's prompt and response audio and remain usable with keyboard and screen
  reader.

### Sighted Low-Vision Use

The visual-accessibility pass should be checked with the application in both
ordinary light/dark Windows themes and Windows high contrast themes. Cosimo
should keep native widget colours rather than hard-coded foreground or
background colours, so system contrast settings remain in control.

- Text, list, and review controls should remain legible at the default Windows
  text scale and at increased text scale.
- The prompt and response areas should be close enough together during review
  that a magnifier user does not need excessive vertical navigation between the
  active question, response, and rating controls.
- Rating controls should be grouped in a compact grid with stable tab order:
  `0`, `1`, `2`, `3`, `4`, then the secondary review actions.
- On a maximised window, rating controls should remain clustered rather than
  stretching across the whole display, so a magnifier user does not need to
  scan from the far left to the far right to find related actions.
- Review buttons should have larger hit targets and should not rely on colour
  alone to communicate meaning.
- Main-window controls should remain usable when the window is maximised and
  when inspected through a screen magnifier.
- The ready-screen top status line should remain short enough to fit ordinary
  window widths; longer review database details belong in the ready summary.
- Statistics, card details, and learning dashboard dialogues should use the
  same larger report text and button targets while retaining native colours.

## Accepted Known Issue

When tabbing or shift-tabbing into the ready-screen prompt list, NVDA may
announce the selected item twice. Arrow-key navigation inside the list,
selection, editing, removal, and review startup remain functional. This is
accepted as a native list-control announcement defect rather than a blocker.

## Release Rule

Any regression in keyboard-only operation, focus order, accessible naming,
dialogue acceptance, rating shortcuts, or the accepted screen-reader flow should
block release until fixed or explicitly recorded here as an accepted known
issue. New language flows should receive the same manual check before release.
