[!!!TASK] Make all classes final

This library has a very large number of extension points via
interfaces and abstract classes. All other classes should not
be extended by users and shall theirfor be marked as final.

There are a few classes left that should also be marked as final
but those require some extra attention.

Author: jaapio

src/RestructuredText/DependencyInjection/Compiler/TextRolePass.php

@@ -18,7 +18,7 @@
 use Symfony\Component\DependencyInjection\ContainerBuilder;
 use Symfony\Component\DependencyInjection\Reference;
 
-class TextRolePass implements CompilerPassInterface
+final class TextRolePass implements CompilerPassInterface
 {
     public function process(ContainerBuilder $container): void
     {

src/RestructuredText/Directives/AdmonitionDirective.php

@@ -34,7 +34,7 @@
  *
  * @see https://docutils.sourceforge.io/docs/ref/rst/directives.html#generic-admonition
  */
-class AdmonitionDirective extends SubDirective
+final class AdmonitionDirective extends SubDirective
 {
     public function getName(): string
     {

src/RestructuredText/Directives/AttentionDirective.php

@@ -15,7 +15,7 @@
 
 use phpDocumentor\Guides\RestructuredText\Parser\Productions\Rule;
 
-class AttentionDirective extends AbstractAdmonitionDirective
+final class AttentionDirective extends AbstractAdmonitionDirective
 {
     public function __construct(protected Rule $startingRule)
     {

src/RestructuredText/Directives/BreadcrumbDirective.php

@@ -30,7 +30,7 @@
  * ..  breadcrumb::
  * ```
  */
-class BreadcrumbDirective extends BaseDirective
+final class BreadcrumbDirective extends BaseDirective
 {
     public function getName(): string
     {

src/RestructuredText/Directives/CautionDirective.php

@@ -15,7 +15,7 @@
 
 use phpDocumentor\Guides\RestructuredText\Parser\Productions\Rule;
 
-class CautionDirective extends AbstractAdmonitionDirective
+final class CautionDirective extends AbstractAdmonitionDirective
 {
     public function __construct(protected Rule $startingRule)
     {

src/RestructuredText/Directives/ClassDirective.php

@@ -25,7 +25,7 @@
 use function array_merge;
 use function explode;
 
-class ClassDirective extends SubDirective
+final class ClassDirective extends SubDirective
 {
     public function getName(): string
     {

src/RestructuredText/Directives/CodeBlockDirective.php

@@ -35,7 +35,7 @@
  *
  * @link https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#directive-code-block
  */
-class CodeBlockDirective extends BaseDirective
+final class CodeBlockDirective extends BaseDirective
 {
     /** @see https://regex101.com/r/I3KttH/1 */
     public const LINE_NUMBER_RANGES_REGEX = '/^\d+(-\d+)?(?:,\s*\d+(-\d+)?)*$/';

src/RestructuredText/Directives/ContainerDirective.php

@@ -24,7 +24,7 @@
  *
  * @link https://docutils.sourceforge.io/docs/ref/rst/directives.html#container
  */
-class ContainerDirective extends SubDirective
+final class ContainerDirective extends SubDirective
 {
     public function getName(): string
     {

src/RestructuredText/Directives/ContentsDirective.php

@@ -25,7 +25,7 @@
  *
  * Displays a table of content of the current page
  */
-class ContentsDirective extends BaseDirective
+final class ContentsDirective extends BaseDirective
 {
     public function __construct(
         private readonly DocumentNameResolverInterface $documentNameResolver,

src/RestructuredText/Directives/DangerDirective.php

@@ -15,7 +15,7 @@
 
 use phpDocumentor\Guides\RestructuredText\Parser\Productions\Rule;
 
-class DangerDirective extends AbstractAdmonitionDirective
+final class DangerDirective extends AbstractAdmonitionDirective
 {
     public function __construct(protected Rule $startingRule)
     {