improve type annotations in 'docutils.readers.pep'

stubs/docutils/@tests/stubtest_allowlist.txt

@@ -12,6 +12,7 @@ docutils.nodes.Text.__new__
 docutils.parsers.recommonmark_wrapper
 docutils.parsers.rst.directives.admonitions.BaseAdmonition.node_class  # must be overridden by base classes (pseudo-abstract)
 docutils.parsers.rst.directives.misc.MetaBody.__getattr__
+docutils.readers.standalone.Reader.document
 docutils.statemachine.State.nested_sm  # is initialised in __init__
 docutils.statemachine.State.nested_sm_kwargs  # is initialised in __init__
 docutils.statemachine.ViewList.__iter__ # doesn't exist at runtime, but the class is iterable due to __getitem__

stubs/docutils/docutils/readers/pep.pyi

@@ -1,3 +1,17 @@
-from _typeshed import Incomplete
+__docformat__: str
 
-def __getattr__(name: str) -> Incomplete: ...
+from typing import ClassVar, TypeVar
+
+from docutils.parsers import Parser
+from docutils.parsers.rst.states import Inliner
+from docutils.readers import standalone
+
+_S = TypeVar("_S")
+
+class Reader(standalone.Reader[_S]):
+
+    settings_default_overrides: ClassVar[dict[str, int]]
+
+    inliner_class: ClassVar[type[Inliner]]
+
+    def __init__(self, parser: Parser | None = None, parser_name: str | None = None): ...

stubs/docutils/docutils/readers/standalone.pyi

@@ -1,3 +1,13 @@
-from _typeshed import Incomplete
+__docformat__: str
 
-def __getattr__(name: str) -> Incomplete: ...
+from typing import ClassVar, TypeVar
+
+from docutils import readers
+
+_S = TypeVar("_S")
+
+class Reader(readers.Reader[_S]):
+
+    supported: ClassVar[tuple[str]]
+
+    config_section_dependencies: ClassVar[tuple[str]]