Use correct version in docs (#106)

Author: brendt

src/Markdown/MarkdownInitializer.php

@@ -14,6 +14,7 @@
 use App\Markdown\Symbols\FqcnParser;
 use App\Markdown\Symbols\FunctionParser;
 use App\Markdown\Symbols\HandleParser;
+use App\Web\Documentation\Version;
 use League\CommonMark\Environment\Environment;
 use League\CommonMark\Extension\Attributes\AttributesExtension;
 use League\CommonMark\Extension\CommonMark\CommonMarkCoreExtension;
@@ -39,17 +40,18 @@ public function initialize(Container $container): MarkdownConverter
         $highlighter = $container->get(Highlighter::class, tag: 'project');
 
         $codeBlockRenderer = new CodeBlockRenderer($highlighter);
+        $version = $container->get(Version::class);
 
         $environment
             ->addExtension(new CommonMarkCoreExtension())
             ->addExtension(new FrontMatterExtension())
             ->addExtension(new AttributesExtension())
             ->addExtension(new AlertExtension())
             ->addExtension(new CodeGroupExtension())
-            ->addInlineParser(new TempestPackageParser())
-            ->addInlineParser(new FqcnParser())
-            ->addInlineParser(new AttributeParser())
-            ->addInlineParser(new FunctionParser())
+            ->addInlineParser(new TempestPackageParser($version))
+            ->addInlineParser(new FqcnParser($version))
+            ->addInlineParser(new AttributeParser($version))
+            ->addInlineParser(new FunctionParser($version))
             ->addInlineParser(new HandleParser())
             ->addRenderer(FencedCode::class, $codeBlockRenderer)
             ->addRenderer(Code::class, new InlineCodeBlockRenderer($highlighter))

src/Markdown/Symbols/AttributeParser.php

@@ -4,19 +4,21 @@
 
 namespace App\Markdown\Symbols;
 
+use App\Web\Documentation\Version;
 use League\CommonMark\Extension\CommonMark\Node\Inline\Code;
 use League\CommonMark\Extension\CommonMark\Node\Inline\Link;
 use League\CommonMark\Parser\Inline\InlineParserInterface;
 use League\CommonMark\Parser\Inline\InlineParserMatch;
 use League\CommonMark\Parser\InlineParserContext;
 use Override;
-use Tempest\Support\Str;
 
 use function Tempest\Support\str;
 use function Tempest\Support\Str\to_kebab_case;
 
 final readonly class AttributeParser implements InlineParserInterface
 {
+    public function __construct(private Version $version) {}
+
     #[Override]
     public function getMatchDefinition(): InlineParserMatch
     {
@@ -41,7 +43,7 @@ public function parse(InlineParserContext $inlineContext): bool
             ->replaceRegex("/^(\w+)/", static fn (array $matches) => sprintf('packages/%s/src', to_kebab_case($matches[0])))
             ->replaceEvery(['date-time' => 'datetime'])
             ->replace('\\', '/')
-            ->prepend('https://github.com/tempestphp/tempest-framework/blob/main/')
+            ->prepend('https://github.com/tempestphp/tempest-framework/blob/' . $this->version->getBranch() . '/')
             ->append('.php')
             ->toString();
 

src/Markdown/Symbols/FqcnParser.php

@@ -4,6 +4,7 @@
 
 namespace App\Markdown\Symbols;
 
+use App\Web\Documentation\Version;
 use League\CommonMark\Extension\CommonMark\Node\Inline\Code;
 use League\CommonMark\Extension\CommonMark\Node\Inline\Link;
 use League\CommonMark\Parser\Inline\InlineParserInterface;
@@ -19,6 +20,8 @@
 
 final readonly class FqcnParser implements InlineParserInterface
 {
+    public function __construct(private Version $version) {}
+
     #[Override]
     public function getMatchDefinition(): InlineParserMatch
     {
@@ -43,7 +46,7 @@ public function parse(InlineParserContext $inlineContext): bool
             ->replaceRegex("/^(\w+)/", static fn (array $matches) => sprintf('packages/%s/src', to_kebab_case($matches[0])))
             ->replaceEvery(['date-time' => 'datetime'])
             ->replace('\\', '/')
-            ->prepend('https://github.com/tempestphp/tempest-framework/blob/main/')
+            ->prepend('https://github.com/tempestphp/tempest-framework/blob/' . $this->version->getBranch() . '/')
             ->append('.php')
             ->toString();
 

src/Markdown/Symbols/FunctionParser.php

@@ -4,6 +4,7 @@
 
 namespace App\Markdown\Symbols;
 
+use App\Web\Documentation\Version;
 use League\CommonMark\Extension\CommonMark\Node\Inline\Code;
 use League\CommonMark\Extension\CommonMark\Node\Inline\Link;
 use League\CommonMark\Parser\Inline\InlineParserInterface;
@@ -18,6 +19,8 @@
 
 final readonly class FunctionParser implements InlineParserInterface
 {
+    public function __construct(private Version $version) {}
+
     #[Override]
     public function getMatchDefinition(): InlineParserMatch
     {
@@ -53,7 +56,7 @@ public function parse(InlineParserContext $inlineContext): bool
 
         $url = str($reflection->getFileName())
             ->afterLast('tempest/framework/')
-            ->prepend('https://github.com/tempestphp/tempest-framework/blob/main/')
+            ->prepend('https://github.com/tempestphp/tempest-framework/blob/' . $this->version->getBranch() . '/')
             ->append("#L{$reflection->getStartLine()}-L{$reflection->getEndLine()}")
             ->toString();
 

src/Markdown/TempestPackageParser.php

@@ -4,6 +4,7 @@
 
 namespace App\Markdown;
 
+use App\Web\Documentation\Version;
 use League\CommonMark\Extension\CommonMark\Node\Inline\Code;
 use League\CommonMark\Extension\CommonMark\Node\Inline\Link;
 use League\CommonMark\Parser\Inline\InlineParserInterface;
@@ -15,6 +16,8 @@
 
 final readonly class TempestPackageParser implements InlineParserInterface
 {
+    public function __construct(private Version $version) {}
+
     #[Override]
     public function getMatchDefinition(): InlineParserMatch
     {
@@ -37,9 +40,9 @@ public function parse(InlineParserContext $inlineContext): bool
 
         $url = match ($package) {
             'app' => 'https://github.com/tempestphp/tempest-app',
-            default => $url = str($package)
+            default => str($package)
                 ->kebab()
-                ->prepend('https://github.com/tempestphp/tempest-framework/tree/main/packages/')
+                ->prepend('https://github.com/tempestphp/tempest-framework/tree/' . $this->version->getBranch() . '/packages/')
                 ->toString(),
         };
 

src/Web/Documentation/VersionInitializer.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace App\Web\Documentation;
+
+use Tempest\Container\Container;
+use Tempest\Container\Initializer;
+use Tempest\Router\MatchedRoute;
+
+final class VersionInitializer implements Initializer
+{
+    public function initialize(Container $container): Version
+    {
+        $version = $container->get(MatchedRoute::class)?->params['version'] ?? null;
+
+        if (! $version) {
+            return Version::default();
+        }
+
+        return Version::tryFromString($version) ?? Version::default();
+    }
+}