fix(a11y): return focus after dismissing map-screen reference-overlay error

[luandro]

Closes #390

What

• src/screens/MapScreen/MapScreen.tsx: dismissing the map-surface reference-overlay error (reference-overlay-map-error alert) no longer drops keyboard focus to <body>. The dismiss handler now calls requestAnimationFrame(() => mapPanelRef.current?.focus()), mirroring the idiom established in fix(map): restore authored layer error dismissal + maplibre-gl 6.x security upgrade #361 (AuthoredLayersControl.tsx).
• Focus target: the map panel container div, given ref + tabIndex={-1} (programmatic-focus-only; not added to tab order). The MapLibre canvas is re-created by the map engine, so it is not a reliable programmatic focus target.
• New regression test in tests/unit/screens/MapScreen/MapScreen.test.tsx (RED-first: verified failing pre-fix with activeElement === body), asserting focus lands on the map panel after dismissal.

Audit (per issue)

• Controls-surface dismissal (AuthoredLayersControl) already returns focus internally (fix(map): restore authored layer error dismissal + maplibre-gl 6.x security upgrade #361).
• Other MapScreen alerts have no dismiss button; shared toasts use Radix focus handling. The map-surface alert was the only unfixed instance.

Review

• Codex (gpt-6-astra) review: PASS, 0 P1/P2. One P3 (comment wording — canvas is focusable but unreliable as a target) applied verbatim in the amended commit. Reviewer's 3 local test failures were the known node-storage environment artifact; verified 36/36 green under Node 22.

Confidence Score: 5/5

The PR appears safe to merge; the focus-restoration behavior is narrowly implemented and covered by a targeted regression test.

Summary

This PR restores keyboard focus after dismissing the map-surface reference-overlay error.

• Adds a stable, programmatic-focus-only map panel target.
• Schedules focus restoration after the dismiss state update removes the alert.
• Adds a regression test confirming focus returns to the map panel rather than the document body.

_{Reviews (2) · Last reviewed commit: "Merge remote-tracking branch 'origin/mai..."}

[github-actions]

React Doctor found 1 new issue in 1 file · 1 warning · score 91 / 100 (Great) · 1 fixed · vs main

1 warning

src/screens/MapScreen/MapScreen.tsx

• ⚠️ L162 React function has high control-flow complexity no-high-complexity-react-function

_{Reviewed by React Doctor for commit 345923f. See inline comments for fixes.}

[github-actions]

Preview deployment ready: https://agent-comapeo-cloud-app-issu-vmlv.comapeo-cloud-app.pages.dev

Commit: b5feda1