Add "@copyright" tag support

Author: Kirill Nesmeyanov

README.md

@@ -36,7 +36,7 @@ composer require type-lang/phpdoc
 - [x] `@api` - Highlight _Symbol_ as being part of the public API
 - [ ] `@author` - TODO
 - [ ] `@category` - TODO
-- [ ] `@copyright` - TODO
+- [x] `@copyright` - Used to document the copyright information of any _Symbol_.
 - [ ] `@deprecated` - TODO
 - [ ] `@example` - TODO
 - [x] `@extends` - Allows to extend templated classes and interfaces

src/DocBlock/Tag/CopyrightTag/CopyrightTag.php

@@ -0,0 +1,32 @@
+<?php
+
+declare(strict_types=1);
+
+namespace TypeLang\PHPDoc\DocBlock\Tag\CopyrightTag;
+
+use TypeLang\PHPDoc\DocBlock\Tag\Tag;
+
+/**
+ * Used to document the copyright information of any _Symbol_.
+ *
+ * The "`@copyright`" tag defines who holds the copyright over the _Symbol_.
+ * The copyright indicated with this tag applies to the _Symbol_ with which
+ * it is associated and all child elements unless otherwise noted.
+ *
+ * The format of the description is governed by the coding standard of each
+ * individual project. It is RECOMMENDED to mention the year or years which
+ * are covered by this copyright and the organization involved.
+ *
+ * ```
+ * "@copyright" [<description>]
+ * ```
+ */
+final class CopyrightTag extends Tag
+{
+    public function __construct(
+        string $name,
+        \Stringable|string|null $description = null,
+    ) {
+        parent::__construct($name, $description);
+    }
+}

src/DocBlock/Tag/CopyrightTag/CopyrightTagFactory.php

@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace TypeLang\PHPDoc\DocBlock\Tag\CopyrightTag;
+
+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 "`@copyright`" tags.
+ *
+ * See {@see CopyrightTag} for details about this tag.
+ */
+final class CopyrightTagFactory implements TagFactoryInterface
+{
+    public function create(string $tag, string $content, DescriptionParserInterface $descriptions): CopyrightTag
+    {
+        $stream = new Stream($tag, $content);
+
+        return new CopyrightTag(
+            name: $tag,
+            description: $stream->toOptionalDescription($descriptions),
+        );
+    }
+}

src/Platform/StandardPlatform.php

@@ -7,6 +7,7 @@
 use TypeLang\Parser\ParserInterface as TypesParserInterface;
 use TypeLang\PHPDoc\DocBlock\Tag\AbstractTag\AbstractTagFactory;
 use TypeLang\PHPDoc\DocBlock\Tag\ApiTag\ApiTagFactory;
+use TypeLang\PHPDoc\DocBlock\Tag\CopyrightTag\CopyrightTagFactory;
 use TypeLang\PHPDoc\DocBlock\Tag\Factory\TagFactoryInterface;
 use TypeLang\PHPDoc\DocBlock\Tag\FinalTag\FinalTagFactory;
 use TypeLang\PHPDoc\DocBlock\Tag\IgnoreTag\IgnoreTagFactory;
@@ -41,6 +42,7 @@ protected function load(TypesParserInterface $types): iterable
     {
         yield 'abstract' => new AbstractTagFactory();
         yield 'api' => new ApiTagFactory();
+        yield 'copyright' => new CopyrightTagFactory();
         yield 'extends' => new TemplateExtendsTagFactory($types);
         yield 'final' => new FinalTagFactory();
         yield 'implements' => new TemplateImplementsTagFactory($types);