Marked classes/methods as @final and #[\Override] where applicable

Because we don't want to bump the major version for now, a hard `final` hasn't been
used here: `@final` will signal the problem to downstream projects using static
analysis.

We will move to a hard `final` later on.

Author: Ocramius

src/DocbookPage.php

@@ -15,7 +15,10 @@
 use function str_starts_with;
 use function strip_tags;
 
-/** @psalm-immutable */
+/**
+ * @psalm-immutable
+ * @final
+ */
 class DocbookPage
 {
     private const int DEFAULT_ORDER = 100;

src/Environment.php

@@ -10,6 +10,7 @@
 use function in_array;
 use function sprintf;
 
+/** @final */
 class Environment
 {
     /** @return non-empty-string */

src/Formatter/AggregatePageFormatter.php

@@ -4,8 +4,10 @@
 
 namespace Roave\DocbookTool\Formatter;
 
+use Override;
 use Roave\DocbookTool\DocbookPage;
 
+/** @final */
 class AggregatePageFormatter implements PageFormatter
 {
     /**
@@ -16,6 +18,7 @@ public function __construct(private array $formatters)
     {
     }
 
+    #[Override]
     public function __invoke(DocbookPage $page): DocbookPage
     {
         foreach ($this->formatters as $formatter) {

src/Formatter/ExtractFrontMatter.php

@@ -5,6 +5,7 @@
 namespace Roave\DocbookTool\Formatter;
 
 use InvalidArgumentException;
+use Override;
 use Psl\Regex;
 use Psl\Regex\Exception\ExceptionInterface;
 use Psl\Type;
@@ -27,6 +28,7 @@ public function __construct(private readonly LoggerInterface $logger)
      * @throws ExceptionInterface
      * @throws InvalidArgumentException
      */
+    #[Override]
     public function __invoke(DocbookPage $page): DocbookPage
     {
         $this->logger->debug(sprintf('[%s] Checking page "%s" for YAML front matter', self::class, $page->slug()));

src/Formatter/InlineCodeFromFile.php

@@ -4,6 +4,7 @@
 
 namespace Roave\DocbookTool\Formatter;
 
+use Override;
 use Psl\Regex;
 use Psr\Log\LoggerInterface;
 use Roave\DocbookTool\DocbookPage;
@@ -23,6 +24,7 @@ public function __construct(private string $contentPath, private readonly Logger
     {
     }
 
+    #[Override]
     public function __invoke(DocbookPage $page): DocbookPage
     {
         $this->logger->debug(sprintf('[%s] Checking if source code files can be inlined in %s', self::class, $page->slug()));

src/Formatter/InlineExternalImages.php

@@ -4,6 +4,7 @@
 
 namespace Roave\DocbookTool\Formatter;
 
+use Override;
 use Psl\Regex;
 use Psr\Log\LoggerInterface;
 use Roave\DocbookTool\DocbookPage;
@@ -27,6 +28,7 @@ public function __construct(private readonly LoggerInterface $logger, private Re
     }
 
     /** @throws RuntimeException */
+    #[Override]
     public function __invoke(DocbookPage $page): DocbookPage
     {
         $this->logger->debug(sprintf('[%s] Checking if external images can be inlined in %s', self::class, $page->slug()));

src/Formatter/InlineFeatureFile.php

@@ -4,6 +4,7 @@
 
 namespace Roave\DocbookTool\Formatter;
 
+use Override;
 use Psl\Regex;
 use Psr\Log\LoggerInterface;
 use Roave\DocbookTool\DocbookPage;
@@ -20,6 +21,7 @@ public function __construct(private string $featuresPath, private readonly Logge
     {
     }
 
+    #[Override]
     public function __invoke(DocbookPage $page): DocbookPage
     {
         $this->logger->debug(sprintf('[%s] Checking if feature files can be inlined in %s', self::class, $page->slug()));

src/Formatter/MarkdownToHtml.php

@@ -5,6 +5,7 @@
 namespace Roave\DocbookTool\Formatter;
 
 use Michelf\MarkdownExtra;
+use Override;
 use Psr\Log\LoggerInterface;
 use Roave\DocbookTool\DocbookPage;
 
@@ -26,6 +27,7 @@ public function __construct(private readonly LoggerInterface $logger)
         ini_set('pcre.backtrack_limit', 5_000_000);
     }
 
+    #[Override]
     public function __invoke(DocbookPage $page): DocbookPage
     {
         $this->logger->debug(sprintf('[%s] Converting MD to HTML in "%s"', self::class, $page->slug()));

src/Formatter/RenderPlantUmlDiagramInline.php

@@ -4,6 +4,7 @@
 
 namespace Roave\DocbookTool\Formatter;
 
+use Override;
 use Psl\Encoding;
 use Psl\Regex;
 use Psl\Shell\ErrorOutputBehavior;
@@ -32,6 +33,7 @@ public function __construct(private readonly LoggerInterface $logger)
     }
 
     /** @throws RuntimeException */
+    #[Override]
     public function __invoke(DocbookPage $page): DocbookPage
     {
         $this->logger->debug(sprintf('[%s] Checking if PlantUML diagrams can be rendered and inlined in %s', self::class, $page->slug()));

src/Formatter/ReplaceGithubMarkdownAlerts.php

@@ -4,6 +4,7 @@
 
 namespace Roave\DocbookTool\Formatter;
 
+use Override;
 use Psl\Regex;
 use Psr\Log\LoggerInterface;
 use Roave\DocbookTool\DocbookPage;
@@ -28,6 +29,7 @@ public function __construct(private readonly LoggerInterface $logger)
     {
     }
 
+    #[Override]
     public function __invoke(DocbookPage $page): DocbookPage
     {
         $this->logger->debug(sprintf('[%s] Making replacements for GFM alerts in %s', self::class, $page->slug()));