minor #3097 [Toolkit] Delay/hide the "Community Kits" feature, minor fixes (Kocal)

This PR was merged into the 2.x branch.

Discussion
----------

[Toolkit] Delay/hide the "Community Kits" feature, minor fixes

| Q              | A
| -------------- | ---
| Bug fix?       | yes
| New feature?   | no <!-- please update src/**/CHANGELOG.md files -->
| Deprecations?  | no <!-- if yes, also update UPGRADE-*.md and src/**/CHANGELOG.md -->
| Documentation? | no <!-- required for new features, or documentation updates -->
| Issues         | Fix #... <!-- prefix each issue number with "Fix #", no need to create an issue if none exist, explain below instead -->
| License        | MIT

I would like to improve the DX for community kit before releasing it, with a preview system based on custom glue and Storybook.

Thus, I prefer to hide/mark it in "WIP" the time the DX is improved, but nothing prevent developers to create their own custom kit if they want (through the dedicated command), it's just not correctly documented.
<img width="1511" height="368" alt="image" src="https://github.com/user-attachments/assets/e3b097af-eca8-449a-a580-a7b4d1e4d0c0" />

I also removed the `doc/index.rst` file, the website speak for itself, and the documentation about "create your kit" will be found in the fresh README.md when creating a kit. The documentation on symfony.com is useless IMO.

Commits
-------

5d18e80 [Toolkit] Delay/hide the "Community Kits" feature, minor fixes

Author: Kocal

src/Toolkit/README.md

@@ -10,7 +10,7 @@ https://github.com/symfony/ux to create issues or submit pull requests.
 
 ## Resources
 
--   [Documentation](https://symfony.com/bundles/ux-toolkit/current/index.html)
+-   [Documentation](https://ux.symfony.com/bundles/toolkit)
 -   [Report issues](https://github.com/symfony/ux/issues) and
     [send Pull Requests](https://github.com/symfony/ux/pulls)
     in the [main Symfony UX repository](https://github.com/symfony/ux)

src/Toolkit/doc/index.rst

@@ -1,7 +1,7 @@
 {
     "$schema": "../../../schema-kit-recipe-v1.json",
     "type": "component",
-    "name": "AlertDialog",
+    "name": "Alert Dialog",
     "description": "A modal dialog that interrupts the user with important content and expects a response.",
     "copy-files": {
         "assets/": "assets/",

src/Toolkit/kits/shadcn/AlertDialog/manifest.json

@@ -1,7 +1,7 @@
 {
     "$schema": "../../../schema-kit-recipe-v1.json",
     "type": "component",
-    "name": "AspectRatio",
+    "name": "Aspect Ratio",
     "description": "A container that maintains a specific width-to-height ratio for its content.",
     "copy-files": {
         "templates/": "templates/"

src/Toolkit/kits/shadcn/AspectRatio/manifest.json

@@ -98,5 +98,3 @@ In your `assets/styles/app.css`, after the TailwindCSS imports, add the followin
     }
 }
 ```
-
-And voilà! You are now ready to use Shadcn components in your Symfony project.

src/Toolkit/kits/shadcn/INSTALL.md

@@ -106,7 +106,7 @@ protected function execute(InputInterface $input, OutputInterface $output): int
             }
             // If more than one kit is available, we ask the user which one to use
             if (($availableKitsCount = \count($availableKits)) > 1) {
-                $kitName = $io->choice(null === $recipeName ? 'Which kit do you want to use?' : \sprintf('The recipe "%s" exists in multiple kits. Which one do you want to use?', $recipeName), array_map(fn (Kit $kit) => $kit->manifest->name, $availableKits));
+                $kitName = $io->choice(null === $recipeName ? 'Which Kit do you want to use?' : \sprintf('The recipe "%s" exists in multiple Kits. Which one do you want to use?', $recipeName), array_map(fn (Kit $kit) => $kit->manifest->name, $availableKits));
 
                 foreach ($availableKits as $availableKit) {
                     if ($availableKit->manifest->name === $kitName) {
@@ -117,11 +117,12 @@ protected function execute(InputInterface $input, OutputInterface $output): int
             } elseif (1 === $availableKitsCount) {
                 $kit = $availableKits[0];
             } else {
-                $io->error(
-                    null === $recipeName
-                    ? 'It seems that no local kits are available and it should not happens. Please open an issue on https://github.com/symfony/ux to report this.'
-                    : \sprintf("The recipe \"%s\" does not exist in any official kits.\n\nYou can try to run one of the following commands to interactively install recipes:\n%s\n\nOr you can try one of the community kits https://github.com/search?q=topic:ux-toolkit&type=repositories", $recipeName, implode("\n", array_map(fn (string $availableKitName) => \sprintf('$ bin/console %s --kit %s', $this->getName(), $availableKitName), $availableKitNames)))
-                );
+                if (null === $recipeName) {
+                    $io->error('It seems that no official kits are available and it should not happens. Please open an issue on https://github.com/symfony/ux to report this.');
+                } else {
+                    $io->error(\sprintf('The recipe "%s" does not exist in any official kits.', $recipeName));
+                    // $io->error(\sprintf("The recipe \"%s\" does not exist in any official kits.\n\nYou can try to run one of the following commands to interactively install recipes:\n%s\n\nOr you can try one of the community kits https://github.com/search?q=topic:ux-toolkit&type=repositories", $recipeName, implode("\n", array_map(fn (string $availableKitName) => \sprintf('$ bin/console %s --kit %s', $this->getName(), $availableKitName), $availableKitNames))));
+                }
 
                 return Command::FAILURE;
             }

src/Toolkit/src/Command/InstallCommand.php

@@ -76,7 +76,7 @@ public function testShouldFailAndSuggestAlternativeRecipesWhenKitIsExplicit()
             ->execute()
             ->assertFaulty()
             ->assertOutputContains('[WARNING] The recipe "A" does not exist')
-            ->assertOutputContains('Possible alternatives: "Alert", "AlertDialog", "AspectRatio"')
+            ->assertOutputContains('Possible alternatives: "Alert", "Alert Dialog", "Aspect Ratio"')
         ;
     }
 

src/Toolkit/tests/Command/InstallCommandTest.php

@@ -14,17 +14,22 @@
 use Spatie\Snapshots\Drivers\HtmlDriver;
 use Spatie\Snapshots\MatchesSnapshots;
 use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;
+use Symfony\Component\Filesystem\Filesystem;
 use Symfony\Component\Filesystem\Path;
-use Symfony\Component\Finder\Finder;
 use Symfony\UX\Toolkit\Kit\Kit;
 use Symfony\UX\Toolkit\Kit\KitContextRunner;
 use Symfony\UX\Toolkit\Kit\KitFactory;
+use Symfony\UX\Toolkit\Kit\KitSynchronizer;
 use Symfony\UX\Toolkit\Recipe\Recipe;
+use Symfony\UX\Toolkit\Recipe\RecipeSynchronizer;
+use Symfony\UX\Toolkit\Recipe\RecipeType;
 use Symfony\UX\Toolkit\Registry\LocalRegistry;
+use Symfony\UX\Toolkit\Tests\TestHelperTrait;
 
 class ComponentsRenderingTest extends WebTestCase
 {
     use MatchesSnapshots;
+    use TestHelperTrait;
 
     private const KITS_DIR = __DIR__.'/../../kits';
 
@@ -33,20 +38,23 @@ class ComponentsRenderingTest extends WebTestCase
      */
     public static function provideTestComponentRendering(): iterable
     {
+        $filesystem = new Filesystem();
+        $kitSynchronizer = new KitSynchronizer($filesystem, new RecipeSynchronizer());
+
         foreach (LocalRegistry::getAvailableKitsName() as $kitName) {
-            $kitDir = Path::join(__DIR__, '../../kits', $kitName);
-            $docsFinder = (new Finder())->files()->name('EXAMPLES.md')->in($kitDir)->depth(1);
+            $kit = self::createLocalKit($kitName);
+            $kitSynchronizer->synchronize($kit);
 
-            foreach ($docsFinder as $docFile) {
-                $componentName = $docFile->getRelativePath();
+            foreach ($kit->getRecipes(RecipeType::Component) as $recipe) {
+                $examplesFilePath = Path::join($recipe->absolutePath, 'EXAMPLES.md');
 
-                $codeBlockMatchesResult = preg_match_all('/```twig.*?\n(?P<code>.+?)```/s', $docFile->getContents(), $codeBlockMatches);
+                $codeBlockMatchesResult = preg_match_all('/```twig.*?\n(?P<code>.+?)```/s', file_get_contents($examplesFilePath), $codeBlockMatches);
                 if (false === $codeBlockMatchesResult || 0 === $codeBlockMatchesResult) {
-                    throw new \RuntimeException(\sprintf('No Twig code blocks found in file "%s"', $docFile->getRelativePathname()));
+                    throw new \RuntimeException(\sprintf('No Twig code blocks found in file "%s"', $examplesFilePath));
                 }
 
                 foreach ($codeBlockMatches['code'] as $i => $code) {
-                    yield \sprintf('Kit %s, component %s, code #%d', $kitName, $componentName, $i + 1) => [$kitName, $componentName, $code];
+                    yield \sprintf('Kit %s, component %s, code #%d', $kitName, $recipe->manifest->name, $i + 1) => [$kitName, $recipe->manifest->name, $code];
                 }
             }
         }

src/Toolkit/tests/Functional/ComponentsRenderingTest.php

@@ -1,6 +1,6 @@
 <!--
 - Kit: Shadcn UI
-- Component: AlertDialog
+- Component: Alert Dialog
 - Code:
 ```twig
 <twig:AlertDialog id="delete_account">

src/Toolkit/tests/Functional/__snapshots__/ComponentsRenderingTest__testComponentRendering with data set Kit shadcn, component AlertDialog, code 1__1.html renamed to src/Toolkit/tests/Functional/__snapshots__/ComponentsRenderingTest__testComponentRendering with data set Kit shadcn, component Alert Dialog, code 1__1.html

@@ -1,6 +1,6 @@
 <!--
 - Kit: Shadcn UI
-- Component: AlertDialog
+- Component: Alert Dialog
 - Code:
 ```twig
 <twig:AlertDialog id="delete_account" open>