From cca538efed288026ca67d2bf1bc9503ea097bd9d Mon Sep 17 00:00:00 2001
From: AhJ <amirhosseinjafari8228@gmail.com>
Date: Wed, 24 Jul 2024 12:11:07 +0330
Subject: [PATCH] Add TemplateCovariant tag

---
 src/DocBlock/Tags/TemplateCovariant.php | 51 +++++++++++++++++++++++++
 1 file changed, 51 insertions(+)
 create mode 100644 src/DocBlock/Tags/TemplateCovariant.php

diff --git a/src/DocBlock/Tags/TemplateCovariant.php b/src/DocBlock/Tags/TemplateCovariant.php
new file mode 100644
index 0000000..d5d5098
--- /dev/null
+++ b/src/DocBlock/Tags/TemplateCovariant.php
@@ -0,0 +1,51 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * This file is part of phpDocumentor.
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ *
+ * @link      http://phpdoc.org
+ */
+
+namespace phpDocumentor\Reflection\DocBlock\Tags;
+
+use phpDocumentor\Reflection\DocBlock\Description;
+use phpDocumentor\Reflection\DocBlock\DescriptionFactory;
+use phpDocumentor\Reflection\Type;
+use phpDocumentor\Reflection\TypeResolver;
+use phpDocumentor\Reflection\Types\Context as TypeContext;
+use Webmozart\Assert\Assert;
+
+/**
+ * Reflection class for a {@}template-covariant tag in a Docblock.
+ */
+final class TemplateCovariant extends TagWithType implements Factory\StaticMethod
+{
+    public function __construct(Type $type, ?Description $description = null)
+    {
+        $this->name        = 'template-covariant';
+        $this->type        = $type;
+        $this->description = $description;
+    }
+
+    public static function create(
+        string $body,
+        ?TypeResolver $typeResolver = null,
+        ?DescriptionFactory $descriptionFactory = null,
+        ?TypeContext $context = null
+    ): self {
+        Assert::notNull($typeResolver);
+        Assert::notNull($descriptionFactory);
+
+        [$type, $description] = self::extractTypeFromBody($body);
+
+        $type        = $typeResolver->resolve($type, $context);
+        $description = $descriptionFactory->create($description, $context);
+
+        return new static($type, $description);
+    }
+}