[Map] Add extra data to Map

[Kocal]

Q	A
Bug fix?	no
New feature?	yes
Docs?	yes
Issues	Fix #...
License	MIT

Replace #2810

Like for Marker and cie, extra data can now be defined on the Map in order to pass extra data from your PHP code to your custom Stimulus Controller, through ux:map:pre-connect and ux:map:connect events.

Combo-ed with bridgeOptions from #2861, it means that you can fully customize the Map creation given extra data given your PHP code (e.g.: injecting some API keys):

$map = new Map(extra: ['vector_layer_api_key' => 'bar']); // or $map->extra(['foo' => 'bar']);

this.element.addEventListener('ux:map:pre-connect', (event) => { const { detail } = event; console.log(detail.extra); // {'foo': 'bar'}  if (detail.extra.foo === 'bar') { detail.extra.bridgeOptions = { a_bridge_specific_option: 'foobar' }; } });

[github-actions]

📊 Packages dist files size difference

Thanks for the PR! Here is the difference in size of the packages dist files between the base branch and the PR.
Please review the changes and make sure they are expected.

File	Before (Size / Gzip)	After (Size / Gzip)
Map
abstract_map_controller.d.ts	7.35 kB / 1.38 kB	7.45 kB+1% 📈 / 1.41 kB+3% 📈
abstract_map_controller.js	5.35 kB / 1.35 kB	5.47 kB+2% 📈 / 1.38 kB+2% 📈
Map (Bridge Google)
map_controller.js	14.1 kB / 3.01 kB	14.22 kB+1% 📈 / 3.04 kB+1% 📈
Map (Bridge Leaflet)
map_controller.js	13.24 kB / 3.2 kB	13.36 kB+1% 📈 / 3.22 kB+1% 📈

[Kocal]

The null from Map::toState() makes the attribute data-...-extra-value not being rendered, so we use this.hasExtraValue to ensure something was defined or not