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

Author: kbond

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 template namespace.
+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 <[email protected]>
+ *
+ * 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', [