# Kalika Web Accessibility Audit

Audit date: 2026-04-28

Scope: Kalika notebook workbench, including the research shell, notebook
outline, cell inspector, command palette, LaTeX/math rendering, expression
explorer, canvas workspace, minimap, explicit dataflow controls, high-contrast
theme, reduced motion, reading font, and responsive mobile layout.

## Phase 113 Final Compliance Pass

- `e2e/phase-113-accessibility-compliance.spec.ts` is the final Phase 113.9.1.4
  gate. It inventories the primary Kalika workbench surfaces and verifies WCAG
  2.1 AA coverage for the default shell, command palette, research assistant,
  LaTeX/math editor, plotting surface, canvas/dataflow workspace, paper
  generation, citations, diagrams, share links, collaboration, and knowledge
  graph browser.
- The audit checks every visible interactive control in the workbench for a
  computed accessible name, keyboard focusability, and assistive-technology
  exposure. It samples visible focus indicators across linear and canvas modes
  so controls do not depend on sighted pointer interaction.
- Screen-reader math coverage uses Playwright ARIA snapshots for the live LaTeX
  preview, asserting that the browser accessibility tree exposes the spoken
  integral label, MathML-backed math node, expression explorer, plain language
  alternative, and Nemeth/UEB Braille alternatives.
- Keyboard-only coverage exercises command palette search, notebook outline
  selection, math palette open/close, math alternatives, research assistant
  open/close, canvas dataflow port connection, and workflow execution.
- The pass fixed two defects surfaced by the audit: default-theme muted metadata
  contrast on research-assistant and math-palette text, and canvas node keyboard
  bubbling that previously prevented focused child port buttons from receiving
  Enter activation.

## Automated Coverage

- `e2e/accessibility-audit.spec.ts` runs axe-core with WCAG 2.1 A/AA tags
  against the default shell, math cell, command palette, canvas/dataflow
  workspace, and high-contrast mobile preference state.
- `e2e/phase-113-accessibility-compliance.spec.ts` runs the expanded final audit
  described above, including visible-control inventory, focus affordance
  sampling, ARIA snapshot math signoff, and keyboard-only operation coverage.
- The same spec runs Pa11y against the core accessibility controls with both
  HTML_CodeSniffer and axe runners at `WCAG2AA` after applying high contrast,
  extra-large math/code text, and reduced motion.
- Screen-reader contracts are asserted in Playwright for math output:
  `aria-label`, `aria-live`, `role="application"`, MathJax-backed accessible
  rendering, spoken descriptions, expression explorer focus navigation, simple
  language alternatives, and Nemeth Braille output.
- Keyboard-only coverage verifies stage navigation, edit-mode entry/exit,
  command palette dialog semantics, combobox focus, and dataflow controls.
- Layout coverage verifies the high-contrast mobile viewport does not create
  horizontal overflow.

## Native Screen-Reader Checklist

Native screen-reader execution is not available in this Linux Codex/CI
environment, so VoiceOver and NVDA cannot be launched directly here. Before a
release signoff, run the following manual checks on the named operating systems:

1. VoiceOver on macOS Safari and Chrome:
   - Navigate the notebook outline, stage, command palette, and inspector using
     only keyboard plus VoiceOver commands.
   - Confirm the LaTeX preview announces the spoken math description and the
     expression explorer updates from integral to bounds, function, variable,
     and result.
   - Confirm simple-language and Nemeth Braille alternatives are reachable and
     announced as toggled controls.
2. NVDA on Windows Chrome and Firefox:
   - Repeat the notebook outline, stage, command palette, and inspector
     navigation pass.
   - Confirm MathJax-backed math output is exposed through the accessibility
     tree without duplicate decorative MathML announcements.
   - Confirm canvas nodes, ports, minimap, and dataflow connection summaries
     remain discoverable without pointer input.
3. High-contrast and reduced-motion pass:
   - Enable the Kalika high-contrast theme, extra-large math/code text, reading
     font, and reduced motion.
   - Confirm active controls preserve clear focus indication and readable text.
   - Confirm no interactive control is skipped, trapped, or announced without a
     usable name.

## Current Result

The automated WCAG 2.1 AA gate is enforced by the Kalika Playwright E2E suite.
Native VoiceOver/NVDA validation is documented above as a platform-bound manual
release check because those OS assistive technologies are unavailable in the
current Linux automation environment.
