feature #460 [Twig] add a component name/template : "namespace" notation (kbond)

This PR was merged into the 2.x branch.

Discussion
----------

[Twig] add a component name/template `:` "namespace" notation

| Q             | A
| ------------- | ---
| Bug fix?      | no
| New feature?  | yes
| Tickets       | #108
| License       | MIT

Proposes `:` as a namespace separator for component names. The default template replaces the `:` with `/` to create sub-directories. A component with the name `form:input`'s default template would be `templates/components/form/input.html.twig`.

Don't believe this would be a BC break. If someone is using the `:` notation already, they likely would have customized the template.

Commits
-------

b9e1554 [Twig] add a component name/template "namespace" notation

Author: weaverryan

src/TwigComponent/src/DependencyInjection/Compiler/TwigComponentPass.php

@@ -41,7 +41,7 @@ public function process(ContainerBuilder $container): void
 
                 $tag['service_id'] = $id;
                 $tag['class'] = $definition->getClass();
-                $tag['template'] = $tag['template'] ?? "components/{$tag['key']}.html.twig";
+                $tag['template'] = $tag['template'] ?? sprintf('components/%s.html.twig', str_replace(':', '/', $tag['key']));
                 $componentConfig[$tag['key']] = $tag;
             }
         }

src/TwigComponent/src/Resources/doc/index.rst

@@ -190,6 +190,13 @@ as the second argument to the ``AsTwigComponent`` attribute:
           // ...
       }
 
+Twig Template Namespaces
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+You can use a ``:`` in your component's name to indicate a namespace. The default
+template will replace the ``:`` with ``/``. For example, a component with the name
+``form:input`` will look for a template in ``templates/components/form/input.html.twig``.
+
 The mount() Method
 ~~~~~~~~~~~~~~~~~~
 

src/TwigComponent/tests/Fixtures/Component/NamespacedComponent.php

@@ -0,0 +1,19 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\UX\TwigComponent\Tests\Fixtures\Component;
+
+use Symfony\UX\TwigComponent\Attribute\AsTwigComponent;
+
+#[AsTwigComponent('foo:bar:baz')]
+final class NamespacedComponent
+{
+}

src/TwigComponent/tests/Fixtures/templates/components/foo/bar/baz.html.twig

@@ -0,0 +1 @@
+Content...

src/TwigComponent/tests/Integration/ComponentExtensionTest.php

@@ -130,6 +130,13 @@ public function testCanRenderEmbeddedComponent(): void
         $this->assertStringContainsString('custom td (1)', $output);
     }
 
+    public function testComponentWithNamespace(): void
+    {
+        $output = $this->renderComponent('foo:bar:baz');
+
+        $this->assertStringContainsString('Content...', $output);
+    }
+
     private function renderComponent(string $name, array $data = []): string
     {
         return self::getContainer()->get(Environment::class)->render('render_component.html.twig', [