fix(map): support fullscreen on iOS Safari

[km-git007]

fix(map): support fullscreen on iOS Safari

Goal

Adds a reliable fullscreen toggle for map controls, including browsers without the standard Fullscreen API.

Fixes #51.

What changed

• Fullscreen entry prefers the standards API, then the WebKit-prefixed API, then MapLibre's pseudo-fullscreen CSS fallback.
• The control stays synchronized and accessible as native fullscreen changes, and preserves fullscreen state through control child remounts/style replacement.
• Pseudo-fullscreen restores the exact prior body.style.overflow when maps are destroyed, and keeps the body locked until the final pseudo-fullscreen owner exits when multiple maps are active.
• Fullscreen transitions schedule safe map resizes and cancel pending resize work on removal.

Scope

No public props, dependencies, custom fullscreen CSS, or unrelated refactors were added.

Stack

Depends on #69. This branch starts from PR #69's head; once #69 merges, the effective diff is only this fullscreen commit.

Validation

• Desktop Chromium: direct local-style harness covered CSS fallback enter/exit/Escape, viewport fill, accessible label and aria-pressed, rejection fallback, pending transition locking, remount/style replacement, map destruction cleanup, multi-map ownership, and removal before scheduled resize. The follow-up harness also verified topmost multi-map Escape, Escape after the first map's controls unmounted, and duplicate-control label/aria-pressed synchronization.
• Playwright WebKit with iPhone 15-like emulation: the engine exposed no element fullscreen APIs, so the standards/WebKit calls and native-change synchronization were exercised with a page-level shim; this is mocked API coverage, not device Safari validation.
• Chromium with Pixel 7-like emulation: CSS fallback entered/exited and the map canvas remained interactive through a wheel gesture.
• Docs /docs/controls: preview mounted; dark/light toggles retained the map and fullscreen control.
• Static/touched checks: touched-file ESLint (src/registry/map.tsx and both modified docs pages), tsc --noEmit --incremental false, production build, deterministic registry rebuild comparison, and diff checks passed.

Physical iPhone Safari validation: pending.

This should remain a draft while the dependency and physical-device validation are pending.

[vercel]

@km-git007 is attempting to deploy a commit to the mapcn oss program Team on Vercel.

A member of the Team first needs to authorize it.

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 8a79a6ab-015b-4b98-98b2-ac108c8a408a

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}