Add "@inheritdoc" tag support

Author: SerafimArts

Diff for: src/DocBlock/Tag/InheritDocTag/InheritDocTag.php

@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace TypeLang\PHPDoc\DocBlock\Tag\InheritDocTag;
+
+use TypeLang\PHPDoc\DocBlock\Tag\Tag;
+
+/**
+ * Used to directly inherit the long description from the parent
+ * class in child classes.
+ *
+ * ```
+ * "@inheritDoc" [<description>]
+ * ```
+ */
+final class InheritDocTag extends Tag
+{
+    public function __construct(
+        string $name,
+        \Stringable|string|null $description = null,
+    ) {
+        parent::__construct($name, $description);
+    }
+}

Diff for: src/DocBlock/Tag/InheritDocTag/InheritDocTagFactory.php

@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace TypeLang\PHPDoc\DocBlock\Tag\InheritDocTag;
+
+use TypeLang\PHPDoc\DocBlock\Tag\Factory\TagFactoryInterface;
+use TypeLang\PHPDoc\Parser\Content\Stream;
+use TypeLang\PHPDoc\Parser\Description\DescriptionParserInterface;
+
+/**
+ * This class is responsible for creating "`@inheritDoc`" tags.
+ *
+ * See {@see InheritDocTag} for details about this tag.
+ */
+final class InheritDocTagFactory implements TagFactoryInterface
+{
+    public function create(string $tag, string $content, DescriptionParserInterface $descriptions): InheritDocTag
+    {
+        $stream = new Stream($tag, $content);
+
+        return new InheritDocTag(
+            name: $tag,
+            description: $stream->toOptionalDescription($descriptions),
+        );
+    }
+}

Diff for: src/Platform/StandardPlatform.php

@@ -9,6 +9,7 @@
 use TypeLang\PHPDoc\DocBlock\Tag\Factory\TagFactoryInterface;
 use TypeLang\PHPDoc\DocBlock\Tag\FinalTag\FinalTagFactory;
 use TypeLang\PHPDoc\DocBlock\Tag\IgnoreTag\IgnoreTagFactory;
+use TypeLang\PHPDoc\DocBlock\Tag\InheritDocTag\InheritDocTagFactory;
 use TypeLang\PHPDoc\DocBlock\Tag\LinkTag\LinkTagFactory;
 use TypeLang\PHPDoc\DocBlock\Tag\MethodTag\MethodTagFactory;
 use TypeLang\PHPDoc\DocBlock\Tag\NoNamedArgumentsTag\NoNamedArgumentsTagFactory;
@@ -39,6 +40,7 @@ protected function load(TypesParserInterface $types): iterable
         yield 'extends' => new TemplateExtendsTagFactory($types);
         yield 'final' => new FinalTagFactory();
         yield 'implements' => new TemplateImplementsTagFactory($types);
+        yield 'inheritdoc' => new InheritDocTagFactory();
         yield 'ignore' => new IgnoreTagFactory();
         yield 'link' => new LinkTagFactory();
         yield 'method' => new MethodTagFactory($types);