[Map] Rename render_map Twig function ux_map

src/Map/CHANGELOG.md

@@ -2,4 +2,9 @@
 
 ## Unreleased
 
+-   Rename `render_map` Twig function `ux_map`
+-   Deprecate `render_map` Twig function
+
+## 2.19
+
 -   Component added

src/Map/doc/index.rst

@@ -120,14 +120,14 @@ A map is created by calling ``new Map()``. You can configure the center, zoom, a
         }
     }
 
-To render a map in your Twig template, use the ``render_map`` Twig function, e.g.:
+To render a map in your Twig template, use the ``ux_map`` Twig function, e.g.:
 
 .. code-block:: twig
 
-    {{ render_map(my_map) }}
+    {{ ux_map(my_map) }}
 
     {# or with custom attributes #}
-    {{ render_map(my_map, { style: 'height: 300px' }) }}
+    {{ ux_map(my_map, { style: 'height: 300px' }) }}
 
 Extend the default behavior
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -207,7 +207,7 @@ Then, you can use this controller in your template:
 
 .. code-block:: twig
 
-    {{ render_map(my_map, { 'data-controller': 'mymap', style: 'height: 300px' }) }}
+    {{ ux_map(my_map, { 'data-controller': 'mymap', style: 'height: 300px' }) }}
 
 Backward Compatibility promise
 ------------------------------

src/Map/src/Bridge/Google/README.md

@@ -90,7 +90,7 @@ A common use case is to customize the marker. You can listen to the `ux:map:mark
 
 Assuming you have a map with a custom controller:
 ```twig
-{{ render_map(map, {'data-controller': 'my-map' }) }}
+{{ ux_map(map, {'data-controller': 'my-map' }) }}
 ```
 
 You can create a Stimulus controller to customize the markers before they are created:

src/Map/src/Bridge/Leaflet/README.md

@@ -47,7 +47,7 @@ A common use case is to customize the marker. You can listen to the `ux:map:mark
 
 Assuming you have a map with a custom controller:
 ```twig
-{{ render_map(map, {'data-controller': 'my-map' }) }}
+{{ ux_map(map, {'data-controller': 'my-map' }) }}
 ```
 
 You can create a Stimulus controller to customize the markers before they are created:

src/Map/src/Twig/MapExtension.php

@@ -24,6 +24,12 @@ final class MapExtension extends AbstractExtension
 {
     public function getFunctions(): iterable
     {
-        yield new TwigFunction('render_map', [Renderers::class, 'renderMap'], ['is_safe' => ['html']]);
+        yield new TwigFunction('render_map', [Renderers::class, 'renderMap'], [
+            'is_safe' => ['html'],
+            'deprecated' => '2.20',
+            'deprecating_package' => 'symfony/ux-map',
+            'alternative' => 'ux_map',
+        ]);
+        yield new TwigFunction('ux_map', [Renderers::class, 'renderMap'], ['is_safe' => ['html']]);
     }
 }

src/Map/tests/TwigTest.php

@@ -44,7 +44,7 @@ public function testRenderMap(): void
         $twig = self::getContainer()->get('twig');
         $twig->setLoader(new ChainLoader([
             new ArrayLoader([
-                'test' => '{{ render_map(map, attributes) }}',
+                'test' => '{{ ux_map(map, attributes) }}',
             ]),
             $twig->getLoader(),
         ]));