[Map] Reword PHPDoc about "extra" properties

Author: Kocal

src/Map/src/Circle.php

@@ -21,7 +21,9 @@
 final class Circle implements Element
 {
     /**
-     * @param array<string, mixed> $extra  Extra data, can be used by the developer to store additional information and use them later JavaScript side
+     * @param array<string, mixed> $extra  Extra data forwarded to the JavaScript side. It can be used in your custom
+     *                                     Stimulus controller to benefit from greater flexibility and customization.
+     *                                     These data must be serializable to JSON. These data are not used by UX Map.
      * @param float                $radius The radius of the circle in meters
      */
     public function __construct(

src/Map/src/Marker.php

@@ -13,7 +13,6 @@
 
 use Symfony\UX\Map\Exception\InvalidArgumentException;
 use Symfony\UX\Map\Icon\Icon;
-use Symfony\UX\Map\Icon\IconType;
 
 /**
  * Represents a marker on a map.
@@ -23,8 +22,9 @@
 final class Marker implements Element
 {
     /**
-     * @param array<string, mixed> $extra Extra data, can be used by the developer to store additional information and
-     *                                    use them later JavaScript side
+     * @param array<string, mixed> $extra Extra data forwarded to the JavaScript side. It can be used in your custom
+     *                                    Stimulus controller to benefit from greater flexibility and customization.
+     *                                    These data must be serializable to JSON. These data are not used by UX Map.
      */
     public function __construct(
         public readonly Point $position,

src/Map/src/Polygon.php

@@ -22,7 +22,9 @@ final class Polygon implements Element
 {
     /**
      * @param array<Point>|array<array<Point>> $points a list of point representing the polygon, or a list of paths (each path is an array of points) representing a polygon with holes
-     * @param array<string, mixed>             $extra  Extra data, can be used by the developer to store additional information and use them later JavaScript side
+     * @param array<string, mixed>             $extra  Extra data forwarded to the JavaScript side. It can be used in your custom
+     *                                                 Stimulus controller to benefit from greater flexibility and customization.
+     *                                                 These data must be serializable to JSON. These data are not used by UX Map.
      */
     public function __construct(
         private readonly array $points,

src/Map/src/Polyline.php

@@ -21,7 +21,9 @@
 final class Polyline implements Element
 {
     /**
-     * @param array<string, mixed> $extra Extra data, can be used by the developer to store additional information and use them later JavaScript side
+     * @param array<string, mixed> $extra Extra data forwarded to the JavaScript side. It can be used in your custom
+     *                                    Stimulus controller to benefit from greater flexibility and customization.
+     *                                    These data must be serializable to JSON. These data are not used by UX Map.
      */
     public function __construct(
         private readonly array $points,

src/Map/src/Rectangle.php

@@ -20,6 +20,11 @@
  */
 final class Rectangle implements Element
 {
+    /**
+     * @param array<string, mixed> $extra Extra data forwarded to the JavaScript side. It can be used in your custom
+     *                                    Stimulus controller to benefit from greater flexibility and customization.
+     *                                    These data must be serializable to JSON. These data are not used by UX Map.
+     */
     public function __construct(
         public readonly Point $southWest,
         public readonly Point $northEast,