feature #198 Improve the class directive code and add Symfony UX support (javiereguiluz)

This PR was merged into the main branch.

Discussion
----------

Improve the class directive code and add Symfony UX support

This addresses `@stof`'s comments about unoptimized code: #196 (comment) and adds support for Symfony UX classes too.

Commits
-------

bec9b30 Improve the class directive code and add Symfony UX support

Author: javiereguiluz

src/Reference/ClassReference.php

@@ -32,19 +32,33 @@ public function resolve(Environment $environment, string $data): ResolvedReferen
     {
         $className = u($data)->replace('\\\\', '\\');
 
+        /**
+         * Symfony AI classes require some special handling because of its monorepo structure. Example:
+         *
+         *     input: Symfony\AI\Agent\Memory\StaticMemoryProvider
+         *     output: https://github.com/symfony/ai/blob/main/src/agent/src/Memory/StaticMemoryProvider.php
+         */
         if (str_starts_with($className, 'Symfony\\AI\\')) {
-            // Example:
-            // input: Symfony\AI\Agent\Memory\StaticMemoryProvider
-            // output: https://github.com/symfony/ai/blob/main/src/agent/src/Memory/StaticMemoryProvider.php
-
             $classPath = $className->after('Symfony\\AI\\');
             [$monorepoSubRepository, $classRelativePath] = $classPath->split('\\', 2);
             // because of monorepo structure, the first part of the classpath needs to be slugged
             // 'Agent' -> 'agent', 'AiBundle' -> 'ai-bundle', etc.
-            $monorepoSubRepository = u($monorepoSubRepository)->snake('-')->lower();
-            $classRelativePath = u($classRelativePath)->replace('\\', '/');
+            $monorepoSubRepository = $monorepoSubRepository->snake('-')->lower();
+            $classRelativePath = $classRelativePath->replace('\\', '/');
 
             $url = \sprintf('https://github.com/symfony/ai/blob/main/src/%s/src/%s.php', $monorepoSubRepository, $classRelativePath);
+        /**
+         * Symfony UX classes require some special handling because of its monorepo structure. Example:
+         *
+         *     input: Symfony\UX\Chartjs\Twig\ChartExtension
+         *     output: https://github.com/symfony/ux/blob/2.x/src/Chartjs/src/Twig/ChartExtension.php
+         */
+        } elseif (str_starts_with($className, 'Symfony\\UX\\')) {
+            $classPath = $className->after('Symfony\\UX\\');
+            [$monorepoSubRepository, $classRelativePath] = $classPath->split('\\', 2);
+            $classRelativePath = $classRelativePath->replace('\\', '/');
+
+            $url = \sprintf('https://github.com/symfony/ux/blob/2.x/src/%s/src/%s.php', $monorepoSubRepository, $classRelativePath);
         } else {
             $url = sprintf('%s/%s.php', $this->symfonyRepositoryUrl, $className->replace('\\', '/'));
         }

tests/fixtures/expected/blocks/references/class.html

@@ -1,3 +1,5 @@
 <p><a href="https://github.com/symfony/symfony/blob/4.0/src/Symfony/Component/HttpKernel/DependencyInjection/ContainerAwareHttpKernel.php" class="reference external" title="Symfony\Component\HttpKernel\DependencyInjection\ContainerAwareHttpKernel" rel="external noopener noreferrer" target="_blank">ContainerAwareHttpKernel</a></p>
 
 <p><a href="https://github.com/symfony/ai/blob/main/src/agent/src/Memory/StaticMemoryProvider.php" class="reference external" title="Symfony\AI\Agent\Memory\StaticMemoryProvider" rel="external noopener noreferrer" target="_blank">StaticMemoryProvider</a></p>
+
+<p><a href="https://github.com/symfony/ux/blob/2.x/src/Chartjs/src/Twig/ChartExtension.php" class="reference external" title="Symfony\UX\Chartjs\Twig\ChartExtension" rel="external noopener noreferrer" target="_blank">ChartExtension</a></p>

tests/fixtures/source/blocks/references/class.rst

@@ -2,3 +2,5 @@
 :class:`Symfony\\Component\\HttpKernel\\DependencyInjection\\ContainerAwareHttpKernel`
 
 :class:`Symfony\\AI\\Agent\\Memory\\StaticMemoryProvider`
+
+:class:`Symfony\\UX\\Chartjs\\Twig\\ChartExtension`