docutils: Address feeback by Jelle

stubs/docutils/@tests/stubtest_allowlist.txt

@@ -15,4 +15,6 @@ docutils.parsers.rst.Directive.__getattr__
 docutils.transforms.Transform.__getattr__
 docutils.transforms.Transformer.__getattr__
 docutils.utils.Reporter.__getattr__
+
+# the constructor appears to be mostly internal API, public API users are meant to use docutils.utils.new_reporter instead
 docutils.utils.Reporter.__init__

stubs/docutils/docutils/languages/__init__.pyi

@@ -1,8 +1,8 @@
-from typing import Any
+from typing import Any, Protocol
 
 from docutils.utils import Reporter
 
-class _LanguageModule:
+class _LanguageModule(Protocol):
     labels: dict[str, str]
     author_separators: list[str]
     bibliographic_fields: list[str]

stubs/docutils/docutils/parsers/__init__.pyi

@@ -1,15 +1,15 @@
 from typing import Any, ClassVar
 
 from docutils import Component
-from docutils.nodes import document
+from docutils.nodes import document as _document
 
 class Parser(Component):
     component_type: ClassVar[str]
     config_section: ClassVar[str]
     inputstring: Any  # defined after call to setup_parse()
     document: Any  # defined after call to setup_parse()
-    def parse(self, inputstring: str, document: document) -> None: ...
-    def setup_parse(self, inputstring: str, document: document) -> None: ...
+    def parse(self, inputstring: str, document: _document) -> None: ...
+    def setup_parse(self, inputstring: str, document: _document) -> None: ...
     def finish_parse(self) -> None: ...
 
 _parser_aliases: dict[str, str]

stubs/docutils/docutils/parsers/rst/directives/__init__.pyi

@@ -8,5 +8,5 @@ from docutils.utils import SystemMessage
 def register_directive(name: str, directive: type[Directive]) -> None: ...
 def directive(
     directive_name: str, language_module: _LanguageModule, document: document
-) -> tuple[type[Directive], list[SystemMessage]]: ...
+) -> tuple[type[Directive] | None, list[SystemMessage]]: ...
 def __getattr__(name: str) -> Any: ...  # incomplete