feat: linkify attributes

Author: innocenzi

src/Markdown/MarkdownInitializer.php

@@ -6,13 +6,14 @@
 
 use App\Markdown\Alerts\AlertExtension;
 use App\Markdown\CodeBlockRenderer;
+use App\Markdown\Symbols\AttributeParser;
+use App\Markdown\Symbols\FqcnParser;
 use League\CommonMark\Environment\Environment;
 use League\CommonMark\Extension\CommonMark\CommonMarkCoreExtension;
 use League\CommonMark\Extension\CommonMark\Node\Block\FencedCode;
 use League\CommonMark\Extension\CommonMark\Node\Block\Heading;
 use League\CommonMark\Extension\CommonMark\Node\Inline\Code;
 use League\CommonMark\Extension\FrontMatter\FrontMatterExtension;
-use League\CommonMark\Extension\HeadingPermalink\HeadingPermalinkExtension;
 use League\CommonMark\MarkdownConverter;
 use Tempest\Container\Container;
 use Tempest\Container\Initializer;
@@ -34,6 +35,7 @@ public function initialize(Container $container): MarkdownConverter
             ->addExtension(new AlertExtension())
             ->addInlineParser(new TempestPackageParser())
             ->addInlineParser(new FqcnParser())
+            ->addInlineParser(new AttributeParser())
             ->addInlineParser(new HandleParser())
             ->addRenderer(FencedCode::class, new CodeBlockRenderer($highlighter))
             ->addRenderer(Code::class, new InlineCodeBlockRenderer($highlighter))

src/Markdown/Symbols/AttributeParser.php

@@ -0,0 +1,55 @@
+<?php
+
+namespace App\Markdown\Symbols;
+
+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 function Tempest\Support\str;
+use function Tempest\Support\Str\class_basename;
+use function Tempest\Support\Str\strip_start;
+
+final readonly class AttributeParser implements InlineParserInterface
+{
+    #[\Override]
+    public function getMatchDefinition(): InlineParserMatch
+    {
+        return InlineParserMatch::regex("{(b)?`#\[((?:\\\{1,2}\w+|\w+\\\{1,2})(?:\w+\\\{0,2})+)\]`}");
+    }
+
+    #[\Override]
+    public function parse(InlineParserContext $inlineContext): bool
+    {
+        $cursor = $inlineContext->getCursor();
+        $previousChar = $cursor->peek(-1);
+
+        if ($previousChar !== null && $previousChar !== ' ') {
+            return false;
+        }
+
+        $cursor->advanceBy($inlineContext->getFullMatchLength());
+
+        [$flag, $fqcn] = $inlineContext->getSubMatches();
+        $url = str($fqcn)
+            ->stripStart(['\\Tempest\\', 'Tempest\\'])
+            ->replaceRegex("/^(\w+)/", 'src/Tempest/$0/src')
+            ->replace('\\', '/')
+            ->prepend('https://github.com/tempestphp/tempest-framework/blob/main/')
+            ->append('.php');
+
+        $attribute = str($fqcn)
+            ->stripStart('\\')
+            ->when($flag === 'b', fn ($s) => $s->classBasename())
+            ->wrap(before: '#[', after: ']')
+            ->toString();
+
+        $link = new Link($url);
+        $link->appendChild(new Code($attribute));
+        $inlineContext->getContainer()->appendChild($link);
+
+        return true;
+    }
+}

src/Markdown/FqcnParser.php src/Markdown/Symbols/FqcnParser.phpsrc/Markdown/FqcnParser.php renamed to src/Markdown/Symbols/FqcnParser.php

@@ -1,17 +1,14 @@
 <?php
 
-namespace App\Markdown;
+namespace App\Markdown\Symbols;
 
 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 function Tempest\Support\Namespace\to_base_class_name;
-use function Tempest\Support\Namespace\to_namespace;
 use function Tempest\Support\str;
-use function Tempest\Support\Str\after_last;
 use function Tempest\Support\Str\class_basename;
 use function Tempest\Support\Str\strip_start;