Add "@OverRide" and "@phan-override" tags support

Author: Kirill Nesmeyanov

README.md

@@ -57,7 +57,7 @@ composer require type-lang/phpdoc
 - [x] `@no-named-arguments` - Indicates that argument names may be 
       changed in the future.
 - [ ] `@package` - TODO
-- [ ] `@override` - TODO
+- [x] `@override` - Mention to see if the method is actually overriding a definition
 - [x] `@param` - Used to document a single argument of a function or method
 - [ ] `@param-closure-this` - TODO
 - [ ] `@param-immediately-invoked-callable` - TODO
@@ -226,7 +226,7 @@ composer require type-lang/phpdoc
 - [x] `@phan-method` - Vendor-specific `@method` alias
 - [ ] `@phan-mixin` - TODO
 - [ ] `@phan-output-reference` - TODO
-- [ ] `@phan-override` - TODO
+- [x] `@phan-override` - Vendor-specific `@override` alias
 - [x] `@phan-param` - Vendor-specific `@param` alias
 - [x] `@phan-property` - Vendor-specific `@property` alias
 - [x] `@phan-property-read` - Vendor-specific `@property-read` alias

src/DocBlock/Tag/OverrideTag/OverrideTag.php

@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace TypeLang\PHPDoc\DocBlock\Tag\OverrideTag;
+
+use TypeLang\PHPDoc\DocBlock\Tag\Tag;
+
+/**
+ * Used is mention to see if the method is actually overriding a definition
+ * or implementing an abstract method (Or a phpdoc "`@method`")
+ * in an ancestor class/trait/interface.
+ *
+ * ```
+ * "@override" [<description>]
+ * ```
+ */
+final class OverrideTag extends Tag
+{
+    public function __construct(
+        string $name,
+        \Stringable|string|null $description = null,
+    ) {
+        parent::__construct($name, $description);
+    }
+}

src/DocBlock/Tag/OverrideTag/OverrideTagFactory.php

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

src/Platform/PhanPlatform.php

@@ -7,6 +7,7 @@
 use TypeLang\Parser\ParserInterface as TypesParserInterface;
 use TypeLang\PHPDoc\DocBlock\Tag\AbstractTag\AbstractTagFactory;
 use TypeLang\PHPDoc\DocBlock\Tag\MethodTag\MethodTagFactory;
+use TypeLang\PHPDoc\DocBlock\Tag\OverrideTag\OverrideTagFactory;
 use TypeLang\PHPDoc\DocBlock\Tag\ParamTag\ParamTagFactory;
 use TypeLang\PHPDoc\DocBlock\Tag\PropertyTag\PropertyReadTagFactory;
 use TypeLang\PHPDoc\DocBlock\Tag\PropertyTag\PropertyTagFactory;
@@ -27,6 +28,7 @@ protected function load(TypesParserInterface $types): iterable
     {
         yield 'phan-abstract' => new AbstractTagFactory();
         yield 'phan-method' => new MethodTagFactory($types);
+        yield 'phan-override' => new OverrideTagFactory();
         yield 'phan-param' => new ParamTagFactory($types);
         yield 'phan-property' => new PropertyTagFactory($types);
         yield 'phan-property-read' => new PropertyReadTagFactory($types);

src/Platform/StandardPlatform.php

@@ -15,6 +15,7 @@
 use TypeLang\PHPDoc\DocBlock\Tag\LinkTag\LinkTagFactory;
 use TypeLang\PHPDoc\DocBlock\Tag\MethodTag\MethodTagFactory;
 use TypeLang\PHPDoc\DocBlock\Tag\NoNamedArgumentsTag\NoNamedArgumentsTagFactory;
+use TypeLang\PHPDoc\DocBlock\Tag\OverrideTag\OverrideTagFactory;
 use TypeLang\PHPDoc\DocBlock\Tag\ParamTag\ParamTagFactory;
 use TypeLang\PHPDoc\DocBlock\Tag\PropertyTag\PropertyReadTagFactory;
 use TypeLang\PHPDoc\DocBlock\Tag\PropertyTag\PropertyTagFactory;
@@ -49,6 +50,7 @@ protected function load(TypesParserInterface $types): iterable
         yield 'link' => new LinkTagFactory();
         yield 'method' => new MethodTagFactory($types);
         yield 'no-named-arguments' => new NoNamedArgumentsTagFactory();
+        yield 'override' => new OverrideTagFactory();
         yield 'param' => new ParamTagFactory($types);
         yield 'property' => new PropertyTagFactory($types);
         yield 'property-read' => new PropertyReadTagFactory($types);
@@ -70,9 +72,8 @@ protected function load(TypesParserInterface $types): iterable
      */
     protected function loadAliases(TypesParserInterface $types): iterable
     {
-        yield 'inherits' => $extends = new TemplateExtendsTagFactory($types);
         yield 'returns' => new ReturnTagFactory($types);
-        yield 'template-extends' => $extends;
+        yield ['template-extends', 'inherits'] => new TemplateExtendsTagFactory($types);
         yield 'template-implements' => new TemplateImplementsTagFactory($types);
         yield 'template-use' => new TemplateExtendsTagFactory($types);
         yield 'throw' => new ThrowsTagFactory($types);