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

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'] ?? self::normalizeDefaultTemplatePath($tag['key']);
                 $componentConfig[$tag['key']] = $tag;
             }
         }
@@ -50,4 +50,9 @@ public function process(ContainerBuilder $container): void
             ->setArgument(2, $componentConfig)
         ;
     }
+
+    private static function normalizeDefaultTemplatePath(string $name): string
+    {
+        return sprintf('components/%s.html.twig', str_replace(':', '/', $name));
+    }
 }

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

@@ -190,6 +190,14 @@ 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', [