[TASK] Make TextRoleFactory exchangable

Author: linawolf

packages/guides-restructured-text/src/RestructuredText/DependencyInjection/Compiler/TextRolePass.php

@@ -4,7 +4,7 @@
 
 namespace phpDocumentor\Guides\RestructuredText\DependencyInjection\Compiler;
 
-use phpDocumentor\Guides\RestructuredText\TextRoles\DefaultTextRoleFactory;
+use phpDocumentor\Guides\RestructuredText\TextRoles\TextRoleFactory;
 use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
 use Symfony\Component\DependencyInjection\ContainerBuilder;
 use Symfony\Component\DependencyInjection\Reference;
@@ -13,7 +13,7 @@ class TextRolePass implements CompilerPassInterface
 {
     public function process(ContainerBuilder $container): void
     {
-        $textRoleFactory = $container->findDefinition(DefaultTextRoleFactory::class);
+        $textRoleFactory = $container->findDefinition(TextRoleFactory::class);
         $domains = [];
         $textRoles = [];
 

packages/guides-restructured-text/src/RestructuredText/Directives/DefaultRoleDirective.php

@@ -16,7 +16,7 @@
 use phpDocumentor\Guides\Nodes\Node;
 use phpDocumentor\Guides\RestructuredText\Parser\Directive;
 use phpDocumentor\Guides\RestructuredText\Parser\DocumentParserContext;
-use phpDocumentor\Guides\RestructuredText\TextRoles\DefaultTextRoleFactory;
+use phpDocumentor\Guides\RestructuredText\TextRoles\TextRoleFactory;
 
 /**
  * sets the default interpreted text role, the role that is used for interpreted text without an explicit role.
@@ -26,7 +26,7 @@
 class DefaultRoleDirective extends BaseDirective
 {
     public function __construct(
-        private readonly DefaultTextRoleFactory $textRoleFactory,
+        private readonly TextRoleFactory $textRoleFactory,
     ) {
     }
 

packages/guides-restructured-text/src/RestructuredText/Directives/RoleDirective.php

@@ -17,8 +17,8 @@
 use phpDocumentor\Guides\RestructuredText\Parser\Directive;
 use phpDocumentor\Guides\RestructuredText\Parser\DocumentParserContext;
 use phpDocumentor\Guides\RestructuredText\TextRoles\BaseTextRole;
-use phpDocumentor\Guides\RestructuredText\TextRoles\DefaultTextRoleFactory;
 use phpDocumentor\Guides\RestructuredText\TextRoles\GenericTextRole;
+use phpDocumentor\Guides\RestructuredText\TextRoles\TextRoleFactory;
 use Psr\Log\LoggerInterface;
 
 use function is_string;
@@ -34,7 +34,7 @@ class RoleDirective extends BaseDirective
 {
     public function __construct(
         private readonly LoggerInterface $logger,
-        private readonly DefaultTextRoleFactory $textRoleFactory,
+        private readonly TextRoleFactory $textRoleFactory,
     ) {
     }
 

packages/guides-restructured-text/src/RestructuredText/Parser/Productions/InlineRules/DefaultTextRoleRule.php

@@ -9,14 +9,14 @@
 use phpDocumentor\Guides\Nodes\Inline\LiteralInlineNode;
 use phpDocumentor\Guides\RestructuredText\Parser\DocumentParserContext;
 use phpDocumentor\Guides\RestructuredText\Parser\InlineLexer;
-use phpDocumentor\Guides\RestructuredText\TextRoles\DefaultTextRoleFactory;
+use phpDocumentor\Guides\RestructuredText\TextRoles\TextRoleFactory;
 
 /**
  * Rule to parse for default text roles such as `something`
  */
 class DefaultTextRoleRule extends AbstractInlineRule
 {
-    public function __construct(private readonly DefaultTextRoleFactory $textRoleFactory)
+    public function __construct(private readonly TextRoleFactory $textRoleFactory)
     {
     }
 

packages/guides-restructured-text/src/RestructuredText/TextRoles/TextRoleFactory.php

@@ -7,4 +7,12 @@
 interface TextRoleFactory
 {
     public function getTextRole(string $name, string|null $domain = null): TextRole;
+
+    public function registerTextRole(TextRole $textRole): void;
+
+    public function replaceTextRole(TextRole $newTextRole): void;
+
+    public function setDefaultTextRole(string $roleName): void;
+
+    public function getDefaultTextRole(): TextRole;
 }