diff --git a/FOLLOWUPS.md b/FOLLOWUPS.md new file mode 100644 index 0000000..d268f06 --- /dev/null +++ b/FOLLOWUPS.md @@ -0,0 +1,53 @@ +# Follow-ups + +Tracked work that was deferred during the multi-round UI/UX review pass. +Each item has a clear acceptance criterion so a future pass can land it +without re-deriving the context. + +## A11y — assistive-tech containment inside modals + +**Problem.** Open modals (LightboxModal, ConfirmSheet, Modal, OnboardingGuide, +join PIN modal, account data-mode sheet, export HTML guide) trap keyboard Tab +via `focusTrap`, but VoiceOver rotor / TalkBack arrow-key navigation can still +escape into the page content behind the dialog. Screen-reader users hear the +wrong context. + +**Why deferred.** A naive sibling-walk that sets `inert` on direct children of +the modal's parent silences the global `` (`aria-live="polite"` region +mounted in `+layout.svelte`) and the `` while a modal is open — +breaking toast announcements and the visible nav state. SvelteKit has no +built-in portal mechanism, so dialogs render inside the route tree alongside +the Toaster. + +**Acceptance criterion.** With any modal open: +- VoiceOver rotor (iOS Safari) and TalkBack swipe navigation (Android Chrome) + cannot leave the dialog subtree. +- Toasts that fire while a modal is open are still announced. +- Nested modals (e.g. ConfirmSheet opened from inside ContextSheet) maintain + correct containment when the inner closes. + +**Sketch of an approach.** One of: +1. **Portal pattern.** Render dialogs into a dedicated `