Scope#
WS11-006 upgrades ISIS web interaction ergonomics from baseline keyboard focus
support to a keyboard-first model for power users with explicit accessibility
parity patterns.
Research and Existing Implementation Alignment#
Implementation aligns with:
- existing ISIS shell/navigation baseline:
apps/isis/web/src/components/AppLayout.tsx,apps/isis/web/src/components/AppLayout.css - primary creative workspaces with first-action search/refresh controls:
DashboardPage,WorkflowsPage,JobsPage,OutputsPage - current ISIS v2 creative-suite ergonomics contract from prior WS11 tasks.
Reference interaction guidance used:
- WAI-ARIA Authoring Practices: keyboard interface conventions and tab patterns (https://www.w3.org/WAI/ARIA/apg/practices/keyboard-interface/, https://www.w3.org/WAI/ARIA/apg/patterns/tabs/)
- MDN reference for
aria-keyshortcuts(https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-keyshortcuts)
Deliverables#
- Added global keyboard-first interaction model in
AppLayout:
?toggles an accessible keyboard shortcuts dialog,/focuses the active page primary search control,Shift+Rtriggers active page primary refresh action,gchord navigation (gthen route key) for fast page switching,- polite live announcements for assistive technology feedback.
- Added keyboard parity for structure navigation:
- context tabs now support
Arrow,Home,End, and activation keys, - primary nav links now support roving
Arrowtraversal andHome/End.
- Added discoverability + accessibility surfaces:
- inline shortcut hint strip in context switcher,
- modal shortcuts guide (
role="dialog",aria-modal), - keycap visual tokens and visually hidden live-region utility.
- Bound page-level shortcut targets on core workspaces:
DashboardPage: primary refresh target,WorkflowsPage: primary focus + refresh targets,JobsPage: primary focus + refresh targets,OutputsPage: primary focus + refresh targets,- all bound controls now expose
aria-keyshortcuts.
- Added focused keyboard interaction test coverage:
apps/isis/web/src/components/AppLayout.spec.tsxnow verifies: skip link + landmarks,/focus shortcut,Shift+Rrefresh shortcut, shortcut guide open/close behavior, andg + wnavigation chord behavior.
Verification Commands#
bash
pnpm --filter @isis/web exec vitest run src/components/AppLayout.spec.tsx src/components/CreativeWorkflowFrame.spec.tsx src/components/IsisLoadingState.spec.tsx src/components/IsisEmptyState.spec.tsx --reporter=dot
pnpm --filter @isis/web run typecheck
node scripts/isis/generate-remediation-backlog-v2.mjs
node scripts/isis/validate-v2-compliance-gate.mjs
Verification Notes#
- Targeted keyboard/accessibility behavior tests pass.
- Workspace typecheck remains red due pre-existing unrelated cross-package and rootDir/type drift issues in baseline repository state.