Make tags case-insensitive

Author: Kirill Nesmeyanov

src/DocBlock/Tag/Factory/MutableTagFactoryInterface.php

@@ -14,7 +14,7 @@ interface MutableTagFactoryInterface extends TagFactoryInterface
      * the custom {@see TagFactoryInterface} to which processing of this tag will
      * be delegated.
      *
-     * @param non-empty-string|list<non-empty-string> $tags
+     * @param non-empty-lowercase-string|list<non-empty-lowercase-string> $tags
      */
     public function register(string|array $tags, TagFactoryInterface $delegate): void;
 }

src/DocBlock/Tag/Factory/TagFactory.php

@@ -14,12 +14,12 @@
 final class TagFactory implements MutableTagFactoryInterface
 {
     /**
-     * @var array<non-empty-string, TagFactoryInterface>
+     * @var array<non-empty-lowercase-string, TagFactoryInterface>
      */
     private array $factories;
 
     /**
-     * @param iterable<non-empty-string, TagFactoryInterface> $factories
+     * @param iterable<non-empty-lowercase-string, TagFactoryInterface> $factories
      */
     public function __construct(iterable $factories = [])
     {
@@ -32,14 +32,18 @@ public function __construct(iterable $factories = [])
 
     public function register(array|string $tags, TagFactoryInterface $delegate): void
     {
-        foreach ((array) $tags as $tag) {
+        if (\is_string($tags)) {
+            $tags = [$tags];
+        }
+
+        foreach ($tags as $tag) {
             $this->factories[$tag] = $delegate;
         }
     }
 
     public function create(string $tag, string $content, DescriptionParserInterface $descriptions): TagInterface
     {
-        $delegate = $this->factories[$tag] ?? null;
+        $delegate = $this->factories[\strtolower($tag)] ?? null;
 
         if ($delegate !== null) {
             try {