feat(mapbox): Add widget support to MapboxOverlay via IControl adapter

[chrisgervang]

Closes #9962

Background

Enable deck widgets to coexist with native Mapbox/MapLibre controls without DOM overlap by rendering widgets with viewId: 'mapbox' into the map's control container system via the new _container prop.

Change List

• Add DeckWidgetControl class that wraps deck widgets as Mapbox IControls
• Process widgets with viewId: 'mapbox' in MapboxOverlay, automatically wrapping them as IControls
• Set widget.props._container to Mapbox-positioned element so WidgetManager appends there
• Widgets stack correctly with native controls in the same DOM container, preventing overlap

---

Note

Medium Risk
Touches overlay lifecycle, map control registration, and widget DOM mounting; mistakes could leak controls or break widget updates on setProps/remove.

Overview
MapboxOverlay can now place deck.gl widgets in the same control stack as native Mapbox/MapLibre UI (e.g. NavigationControl) so they do not overlap deck’s overlay container.

Widgets with viewId: 'mapbox' are wrapped as IControl instances via a new DeckWidgetControl. MapboxOverlay registers those controls on the map, sets each widget’s _container before Deck / WidgetManager run, and reuses controls when setProps passes new widget instances with the same id and placement. Overlay removal avoids mutating the map’s control list during map.remove() iteration.

Widget CSS drops extra margin when widgets sit inside deck-widget-ctrl. Docs describe default vs map-positioned widgets and limitations (view controls, screenshot in interleaved mode, fullscreen container). Tests and the Map mock cover control lifecycle, placement, and cleanup.

^{Reviewed by Cursor Bugbot for commit 5474ab7. Bugbot is set up for automated code reviews on this repo. Configure here.}

[coveralls]

coverage: 83.789% (+0.04%) from 83.752% — chr/mapbox-widget-support into master

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

There are 3 total unresolved issues (including 2 from previous reviews).

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit afec60a. Configure here.}