basedpyright 1.31.5 → 1.31.6

package/dist/typeshed-fallback/stubs/docutils/docutils/nodes.pyi

@@ -1,16 +1,22 @@
 import sys
 import xml.dom.minidom
+from _typeshed import Incomplete
 from abc import abstractmethod
 from collections import Counter
 from collections.abc import Callable, Generator, Iterable, Iterator, Mapping, Sequence
 from typing import Any, ClassVar, Final, Literal, Protocol, SupportsIndex, TypeVar, overload, type_check_only
-from typing_extensions import Self, TypeAlias
+from typing_extensions import Self, TypeAlias, deprecated
 
 from docutils.frontend import Values
 from docutils.transforms import Transform, Transformer
 from docutils.utils import Reporter
 
 _N = TypeVar("_N", bound=Node)
+_ElementLikeType: TypeAlias = type[Element | Text | Body | Bibliographic | Inline]
+_ContentModelCategory: TypeAlias = _ElementLikeType | tuple[_ElementLikeType, ...]
+_ContentModelQuantifier: TypeAlias = Literal[".", "?", "+", "*"]
+_ContentModelItem: TypeAlias = tuple[_ContentModelCategory, _ContentModelQuantifier]
+_ContentModelTuple: TypeAlias = tuple[_ContentModelItem, ...]
 
 @type_check_only
 class _DomModule(Protocol):
@@ -34,7 +40,9 @@ class Node:
     @document.setter
     def document(self, value: document) -> None: ...
     def __bool__(self) -> Literal[True]: ...
-    def asdom(self, dom: _DomModule | None = None) -> xml.dom.minidom.Element: ...
+    def asdom(
+        self, dom: _DomModule | None = None
+    ) -> xml.dom.minidom.Document | xml.dom.minidom.Element | xml.dom.minidom.Text: ...
     # While docutils documents the Node class to be abstract it does not
     # actually use the ABCMeta metaclass. We still set @abstractmethod here
     # (although it's not used in the docutils implementation) because it
@@ -53,7 +61,7 @@ class Node:
     @overload
     def findall(
         self, condition: type[_N], include_self: bool = True, descend: bool = True, siblings: bool = False, ascend: bool = False
-    ) -> Generator[_N, None, None]: ...
+    ) -> Generator[_N]: ...
     @overload
     def findall(
         self,
@@ -62,12 +70,14 @@ class Node:
         descend: bool = True,
         siblings: bool = False,
         ascend: bool = False,
-    ) -> Generator[Node, None, None]: ...
+    ) -> Generator[Node]: ...
     @overload
+    @deprecated("The `nodes.Node.traverse()` is deprecated. Use `Node.findall()` instead.")
     def traverse(
         self, condition: type[_N], include_self: bool = True, descend: bool = True, siblings: bool = False, ascend: bool = False
     ) -> list[_N]: ...
     @overload
+    @deprecated("The `nodes.Node.traverse()` is deprecated. Use `Node.findall()` instead.")
     def traverse(
         self,
         condition: Callable[[Node], bool] | None = None,
@@ -89,6 +99,8 @@ class Node:
         siblings: bool = False,
         ascend: bool = False,
     ) -> Node: ...
+    def validate(self, recursive: bool = True) -> None: ...
+    def validate_position(self) -> None: ...
 
 # Left out
 # - def ensure_str (deprecated)
@@ -101,7 +113,6 @@ class Text(Node, str):
 
     # we omit the rawsource parameter because it has been deprecated and is ignored
     def __new__(cls, data: str) -> Self: ...
-    def __init__(self, data: str) -> None: ...
     def shortrepr(self, maxlen: int = 18) -> str: ...
     def copy(self) -> Self: ...
     def deepcopy(self) -> Self: ...
@@ -114,9 +125,12 @@ _T = TypeVar("_T")
 
 class Element(Node):
     local_attributes: ClassVar[Sequence[str]]
+    valid_attributes: ClassVar[Sequence[str]]
+    common_attributes: ClassVar[Sequence[str]]
     basic_attributes: ClassVar[Sequence[str]]
     list_attributes: ClassVar[Sequence[str]]
     known_attributes: ClassVar[Sequence[str]]
+    content_model: ClassVar[_ContentModelTuple]
     tagname: str
     child_text_separator: ClassVar[str]
     attributes: dict[str, Any]
@@ -167,6 +181,7 @@ class Element(Node):
     def remove(self, item: Node) -> None: ...
     def index(self, item: Node, start: int = 0, stop: int = sys.maxsize) -> int: ...
     def previous_sibling(self) -> Node | None: ...
+    def section_hierarchy(self) -> list[section]: ...
     def is_not_default(self, key: str) -> bool: ...
     def update_basic_atts(self, dict_: Mapping[str, Any] | Node) -> None: ...
     def append_attr_list(self, attr: str, values: Iterable[Any]) -> None: ...
@@ -205,12 +220,15 @@ class Element(Node):
     def pformat(self, indent: str = "    ", level: int = 0) -> str: ...
     def copy(self) -> Self: ...
     def deepcopy(self) -> Self: ...
-    def set_class(self, name: str) -> None: ...
     def note_referenced_by(self, name: str | None = None, id: str | None = None) -> None: ...
     @classmethod
     def is_not_list_attribute(cls, attr: str) -> bool: ...
     @classmethod
     def is_not_known_attribute(cls, attr: str) -> bool: ...
+    def validate_attributes(self) -> None: ...
+    def validate_content(
+        self, model: _ContentModelTuple | None = None, elements: Sequence[Incomplete] | None = None
+    ) -> list[Incomplete]: ...
 
     # '__iter__' is added as workaround, since mypy doesn't support classes that are iterable via '__getitem__'
     # see https://github.com/python/typeshed/pull/10099#issuecomment-1528789395
@@ -220,6 +238,7 @@ class TextElement(Element):
     def __init__(self, rawsource: str = "", text: str = "", *children: Node, **attributes) -> None: ...
 
 class FixedTextElement(TextElement): ...
+class PureTextElement(TextElement): ...
 
 # Mixins
 
@@ -227,6 +246,8 @@ class Resolvable:
     resolved: int
 
 class BackLinkable:
+    list_attributes: ClassVar[Sequence[str]]
+    valid_attributes: ClassVar[Sequence[str]]
     def add_backref(self, refid: str) -> None: ...
 
 # Element Categories
@@ -235,12 +256,19 @@ class Root: ...
 class Titular: ...
 class PreBibliographic: ...
 class Bibliographic: ...
-class Decorative(PreBibliographic): ...
+
+class Decorative(PreBibliographic):
+    content_model: ClassVar[_ContentModelTuple]
+
 class Structural: ...
+class SubStructural: ...
 class Body: ...
 class General(Body): ...
 class Sequential(Body): ...
-class Admonition(Body): ...
+
+class Admonition(Body):
+    content_model: ClassVar[_ContentModelTuple]
+
 class Special(Body): ...
 class Invisible(PreBibliographic): ...
 class Part: ...
@@ -290,7 +318,7 @@ class document(Root, Structural, Element):
     def __init__(self, settings: Values, reporter: Reporter, *args: Node, **kwargs: Any) -> None: ...
     def asdom(self, dom: Any | None = None) -> Any: ...
     def set_id(self, node: Element, msgnode: Element | None = None, suggested_prefix: str = "") -> str: ...
-    def set_name_id_map(self, node: Element, id: str, msgnode: Element | None = None, explicit: bool | None = None) -> None: ...
+    def set_name_id_map(self, node: Element, id: str, msgnode: Element | None = None, explicit: bool = False) -> None: ...
     def set_duplicate_name_id(self, node: Element, id: str, name: str, msgnode: Element, explicit: bool) -> None: ...
     def has_name(self, name: str) -> bool: ...
     def note_implicit_target(self, target: Element, msgnode: Element | None = None) -> None: ...
@@ -412,7 +440,10 @@ class caption(Part, TextElement): ...
 class legend(Part, Element): ...
 class table(General, Element): ...
 class tgroup(Part, Element): ...
-class colspec(Part, Element): ...
+
+class colspec(Part, Element):
+    def propwidth(self) -> float: ...
+
 class thead(Part, Element): ...
 class tbody(Part, Element): ...
 class row(Part, Element): ...
@@ -683,6 +714,9 @@ class TreeCopyVisitor(GenericNodeVisitor):
     parent: list[Node]
     def get_tree_copy(self) -> Node: ...
 
+class ValidationError(ValueError):
+    def __init__(self, msg: str, problematic_element: Element | None = None) -> None: ...
+
 class TreePruningException(Exception): ...
 class SkipChildren(TreePruningException): ...
 class SkipSiblings(TreePruningException): ...
@@ -696,4 +730,17 @@ def dupname(node: Node, name: str) -> None: ...
 def fully_normalize_name(name: str) -> str: ...
 def whitespace_normalize_name(name: str) -> str: ...
 def serial_escape(value: str) -> str: ...
+def split_name_list(s: str) -> list[str]: ...
 def pseudo_quoteattr(value: str) -> str: ...
+def parse_measure(measure: str, unit_pattern: str = "[a-zA-Zµ]*|%?") -> tuple[float, str]: ...
+def create_keyword_validator(*keywords: str) -> Callable[[str], str]: ...
+def validate_identifier(value: str) -> str: ...
+def validate_identifier_list(value: str | list[str]) -> list[str]: ...
+def validate_measure(measure: str) -> str: ...
+def validate_colwidth(measure: str | float) -> float: ...
+def validate_NMTOKEN(value: str) -> str: ...
+def validate_NMTOKENS(value: str | list[str]) -> list[str]: ...
+def validate_refname_list(value: str | list[str]) -> list[str]: ...
+def validate_yesorno(value: str | int | bool) -> bool: ...
+
+ATTRIBUTE_VALIDATORS: dict[str, Callable[[str], Any]]

package/dist/typeshed-fallback/stubs/docutils/docutils/parsers/__init__.pyi

@@ -14,6 +14,6 @@ class Parser(Component):
     def setup_parse(self, inputstring: str, document: _Document) -> None: ...
     def finish_parse(self) -> None: ...
 
-_parser_aliases: dict[str, str]
+PARSER_ALIASES: Final[dict[str, str]]
 
 def get_parser_class(parser_name: str) -> type[Parser]: ...

package/dist/typeshed-fallback/stubs/docutils/docutils/parsers/docutils_xml.pyi

@@ -0,0 +1,16 @@
+import xml.etree.ElementTree as ET
+from typing import ClassVar, Final
+
+from docutils import nodes, parsers
+
+__docformat__: Final = "reStructuredText"
+
+class Parser(parsers.Parser):
+    config_section_dependencies: ClassVar[tuple[str, ...]]
+    settings_default_overrides: ClassVar[dict[str, bool]]
+
+class Unknown(nodes.Special, nodes.Inline, nodes.Element): ...
+
+def parse_element(inputstring: str, document: nodes.document | None = None) -> nodes.Element: ...
+def element2node(element: ET.Element | None, document: nodes.document | None = None, unindent: bool = True) -> nodes.Element: ...
+def append_text(node: nodes.Element, text: str | None, unindent: bool | None) -> None: ...

package/dist/typeshed-fallback/stubs/docutils/docutils/parsers/null.pyi

@@ -1,7 +1,9 @@
-from typing import ClassVar
+from typing import ClassVar, Final
 
 from docutils import parsers
 
+__docformat__: Final = "reStructuredText"
+
 class Parser(parsers.Parser):
     supported: ClassVar[tuple[str, ...]]
     config_section_dependencies: ClassVar[tuple[str, ...]]

package/dist/typeshed-fallback/stubs/docutils/docutils/parsers/recommonmark_wrapper.pyi

@@ -1,15 +1,18 @@
 from types import ModuleType
 from typing import ClassVar
+from typing_extensions import deprecated
 
 from docutils import nodes
 from docutils.transforms import Transform
 
+@deprecated("The `recommonmark` package is unmaintained and deprecated; will be removed in Docutils 1.0.")
 class pending_xref(nodes.Inline, nodes.Element): ...
 
 sphinx: ModuleType
 
+@deprecated("The `recommonmark` package is unmaintained and deprecated; will be removed in Docutils 1.0.")
 def is_literal(node: nodes.Node) -> bool: ...
-
+@deprecated("The `recommonmark` package is unmaintained and deprecated; will be removed in Docutils 1.0.")
 class _CommonMarkParser:
     default_config: ClassVar[dict[str, None]]
     def __init__(self) -> None: ...
@@ -40,6 +43,7 @@ class _CommonMarkParser:
     def add_section(self, section, level): ...
     def is_section_level(self, level, section): ...
 
+@deprecated("The `recommonmark` package is unmaintained and deprecated; will be removed in Docutils 1.0.")
 class Parser(_CommonMarkParser):
     supported: ClassVar[tuple[str, ...]]
     config_section: ClassVar[str]

package/dist/typeshed-fallback/stubs/docutils/docutils/parsers/rst/directives/__init__.pyi

@@ -21,6 +21,7 @@ def uri(argument: str) -> str: ...
 def nonnegative_int(argument: str) -> int: ...
 def percentage(argument: str) -> int: ...
 
+CSS3_LENGTH_UNITS: Final[tuple[str, ...]]
 length_units: Final[list[str]]
 
 def get_measure(argument: str, units: Iterable[str]) -> str: ...

package/dist/typeshed-fallback/stubs/docutils/docutils/parsers/rst/directives/misc.pyi

@@ -3,15 +3,21 @@ from pathlib import Path
 from re import Match, Pattern
 from typing import ClassVar, Final
 
+from docutils import nodes
 from docutils.parsers.rst import Directive
 from docutils.parsers.rst.states import SpecializedBody
 
 __docformat__: Final = "reStructuredText"
 
-def adapt_path(path: str, source: StrPath = "", root_prefix: StrPath = "/") -> str: ...
+def adapt_path(path: str, source: StrPath = "", root_prefix: StrPath = "") -> str: ...
 
 class Include(Directive):
     standard_include_path: Path
+    def read_file(self, path: StrPath) -> str: ...
+    def as_literal_block(self, text: str) -> list[nodes.literal_block]: ...
+    def as_code_block(self, text: str) -> list[nodes.literal_block]: ...
+    def custom_parse(self, text: str) -> list[nodes.Node]: ...
+    def insert_into_input_lines(self, text: str) -> None: ...
 
 class Raw(Directive): ...
 class Replace(Directive): ...

package/dist/typeshed-fallback/stubs/docutils/docutils/parsers/rst/directives/tables.pyi

@@ -2,6 +2,7 @@ import csv
 from _typeshed import Incomplete
 from collections.abc import Callable, Sequence
 from typing import ClassVar, Final
+from typing_extensions import deprecated
 
 from docutils import nodes
 from docutils.parsers.rst import Directive
@@ -35,6 +36,7 @@ class CSVTable(Table):
         escapechar: Incomplete
         def __init__(self, options) -> None: ...
 
+    @deprecated("Deprecated and will be removed in Docutils 1.0.")
     class HeaderDialect(csv.Dialect):
         delimiter: str
         quotechar: str
@@ -47,14 +49,11 @@ class CSVTable(Table):
         def __init__(self) -> None: ...
 
     @staticmethod
+    @deprecated("Deprecated and not required with Python 3; will be removed in Docutils 0.22.")
     def check_requirements() -> None: ...
     def process_header_option(self): ...
     def run(self) -> Sequence[nodes.table | nodes.system_message]: ...
     def get_csv_data(self): ...
-    @staticmethod
-    def decode_from_csv(s): ...
-    @staticmethod
-    def encode_for_csv(s): ...
     def parse_csv_data_into_rows(self, csv_data, dialect, source): ...
 
 class ListTable(Table):

package/dist/typeshed-fallback/stubs/docutils/docutils/parsers/rst/roles.pyi

@@ -1,6 +1,6 @@
 from collections.abc import Callable, Mapping, Sequence
 from typing import Any, Final
-from typing_extensions import TypeAlias
+from typing_extensions import TypeAlias, deprecated
 
 import docutils.parsers.rst.states
 from docutils import nodes
@@ -128,5 +128,8 @@ def unimplemented_role(
     options: Mapping[str, Any] | None = None,
     content: Sequence[str] | None = None,
 ) -> tuple[list[Node], list[system_message]]: ...
+@deprecated("Deprecated and will be removed in Docutils 2.0, Use `roles.normalize_options()` instead.")
 def set_classes(options: dict[str, str]) -> None: ...
+@deprecated("Deprecated and will be removed in Docutils 2.0, Use `roles.normalize_options()` instead.")
 def normalized_role_options(options: Mapping[str, Any] | None) -> dict[str, Any]: ...
+def normalize_options(options: Mapping[str, Any] | None) -> dict[str, Any]: ...

package/dist/typeshed-fallback/stubs/docutils/docutils/parsers/rst/states.pyi

@@ -1,7 +1,7 @@
 from _typeshed import Incomplete
 from collections.abc import Callable, Iterable, Sequence
 from re import Match, Pattern
-from types import ModuleType
+from types import ModuleType, SimpleNamespace as Struct
 from typing import Any, ClassVar, Final, NoReturn
 from typing_extensions import TypeAlias
 
@@ -19,9 +19,6 @@ class InterpretedRoleNotImplementedError(DataError): ...
 class ParserError(ApplicationError): ...
 class MarkupMismatch(Exception): ...
 
-class Struct:
-    def __init__(self, **keywordargs) -> None: ...
-
 class RSTStateMachine(StateMachineWS[list[str]]):
     language: _RstLanguageModule
     match_titles: bool
@@ -29,6 +26,7 @@ class RSTStateMachine(StateMachineWS[list[str]]):
     document: nodes.document
     reporter: Reporter
     node: nodes.document | None
+    section_level_offset: int
     def run(  # type: ignore[override]
         self,
         input_lines: Sequence[str] | StringList,
@@ -38,13 +36,9 @@ class RSTStateMachine(StateMachineWS[list[str]]):
         inliner: Inliner | None = None,
     ) -> None: ...
 
-class NestedStateMachine(StateMachineWS[list[str]]):
-    match_titles: bool
-    memo: Incomplete
-    document: nodes.document
-    reporter: Reporter
-    language: Incomplete
-    node: Incomplete
+class NestedStateMachine(RSTStateMachine):
+    parent_state_machine: Incomplete | None
+    def __init__(self, state_classes, initial_state, debug: bool = False, parent_state_machine=None) -> None: ...
     def run(  # type: ignore[override]
         self, input_lines: Sequence[str] | StringList, input_offset: int, memo, node, match_titles: bool = True
     ) -> list[str]: ...
@@ -64,13 +58,13 @@ class RSTState(StateWS[list[str]]):
     def bof(self, context: list[str]): ...
     def nested_parse(
         self,
-        block,
+        block: StringList,
         input_offset: int,
-        node,
+        node: nodes.Element | None = None,
         match_titles: bool = False,
-        state_machine_class: type[StateMachine[list[str]]] | None = None,
-        state_machine_kwargs=None,
-    ): ...
+        state_machine_class: StateMachineWS[Incomplete] | None = None,
+        state_machine_kwargs: dict[Incomplete, Incomplete] | None = None,
+    ) -> int: ...
     def nested_list_parse(
         self,
         block,
@@ -92,7 +86,7 @@ class RSTState(StateWS[list[str]]):
     def inline_text(self, text: str, lineno: int) -> tuple[list[Node], list[system_message]]: ...
     def unindent_warning(self, node_name: str): ...
 
-def build_regexp(definition, compile: bool = True): ...
+def build_regexp(definition, compile_patterns: bool | None = True): ...
 
 _BasicDefinition: TypeAlias = tuple[str, str, str, list[Pattern[str]]]
 _DefinitionParts: TypeAlias = tuple[str, str, str, list[Pattern[str] | _BasicDefinition]]

package/dist/typeshed-fallback/stubs/docutils/docutils/readers/doctree.pyi

@@ -1,8 +1,10 @@
-from typing import ClassVar, TypeVar
+from typing import ClassVar, Final, TypeVar
 
 from docutils import readers
 
 _S = TypeVar("_S", bound=str | bytes)
 
+__docformat__: Final = "reStructuredText"
+
 class Reader(readers.ReReader[_S]):
     config_section_dependencies: ClassVar[tuple[str, ...]]

package/dist/typeshed-fallback/stubs/docutils/docutils/transforms/references.pyi

@@ -62,6 +62,10 @@ class TargetNotes(Transform):
     def apply(self) -> None: ...
     def make_target_footnote(self, refuri: str, refs: list[Incomplete], notes: dict[Incomplete, Incomplete]): ...
 
+class CitationReferences(Transform):
+    default_priority: ClassVar[int]
+    def apply(self) -> None: ...
+
 class DanglingReferences(Transform):
     default_priority: ClassVar[int]
     def apply(self) -> None: ...

package/dist/typeshed-fallback/stubs/docutils/docutils/transforms/universal.pyi

@@ -43,10 +43,14 @@ class StripClassesAndElements(Transform):
 
 class SmartQuotes(Transform):
     default_priority: ClassVar[int]
-    nodes_to_skip: ClassVar[tuple[type[nodes.Node], ...]]
+    nodes_to_skip: ClassVar[tuple[type[nodes.Node | nodes.Special], ...]]
     literal_nodes: ClassVar[tuple[type[nodes.Node | nodes.Body], ...]]
     smartquotes_action: ClassVar[str]
     unsupported_languages: set[str]
     def __init__(self, document: nodes.document, startnode: nodes.Node | None) -> None: ...
     def get_tokens(self, txtnodes: Iterable[nodes.Node]) -> Generator[tuple[Literal["literal", "plain"], str]]: ...
     def apply(self) -> None: ...
+
+class Validate(Transform):
+    default_priority: ClassVar[int]
+    def apply(self) -> None: ...

package/dist/typeshed-fallback/stubs/docutils/docutils/transforms/writer_aux.pyi

@@ -1,17 +1,9 @@
 from typing import ClassVar, Final
-from typing_extensions import deprecated
 
-from docutils import nodes
 from docutils.transforms import Transform
 
 __docformat__: Final = "reStructuredText"
 
-@deprecated("docutils.transforms.writer_aux.Compound is deprecated and will be removed in Docutils 0.21 or later.")
-class Compound(Transform):
-    default_priority: ClassVar[int]
-    def __init__(self, document: nodes.document, startnode: nodes.Node | None = None) -> None: ...
-    def apply(self) -> None: ...
-
 class Admonitions(Transform):
     default_priority: ClassVar[int]
     def apply(self) -> None: ...

package/dist/typeshed-fallback/stubs/docutils/docutils/utils/__init__.pyi

@@ -1,9 +1,9 @@
 import optparse
-from _typeshed import StrPath, SupportsWrite, Unused
-from collections.abc import Callable, Iterable, Mapping
+from _typeshed import StrPath, SupportsWrite
+from collections.abc import Callable, Iterable, Mapping, Sequence
 from re import Pattern
 from typing import Any, Final, Literal, TypeVar
-from typing_extensions import TypeAlias
+from typing_extensions import TypeAlias, deprecated
 
 from docutils import ApplicationError, DataError, nodes
 from docutils.frontend import Values
@@ -27,13 +27,14 @@ class DependencyList:
 class SystemMessagePropagation(ApplicationError): ...
 
 class Reporter:
-    levels: list[str]
+    get_source_and_line: Callable[[int | None], tuple[StrPath | None, int | None]]
+    levels: Final[Sequence[str]]
 
-    DEBUG_LEVEL: Literal[0]
-    INFO_LEVEL: Literal[1]
-    WARNING_LEVEL: Literal[2]
-    ERROR_LEVEL: Literal[3]
-    SEVERE_LEVEL: Literal[4]
+    DEBUG_LEVEL: Final = 0
+    INFO_LEVEL: Final = 1
+    WARNING_LEVEL: Final = 2
+    ERROR_LEVEL: Final = 3
+    SEVERE_LEVEL: Final = 4
 
     stream: ErrorOutput
     encoding: str
@@ -55,14 +56,6 @@ class Reporter:
     debug_flag: bool
     report_level: _SystemMessageLevel
     halt_level: int
-    def set_conditions(
-        self,
-        category: Unused,
-        report_level: int,
-        halt_level: int,
-        stream: SupportsWrite[str] | SupportsWrite[bytes] | None = None,
-        debug: bool = False,
-    ) -> None: ...
     def attach_observer(self, observer: _Observer) -> None: ...
     def detach_observer(self, observer: _Observer) -> None: ...
     def notify_observers(self, message: nodes.system_message) -> None: ...
@@ -113,11 +106,13 @@ def assemble_option_dict(
 
 class NameValueError(DataError): ...
 
+@deprecated("Deprecated and will be removed in Docutils 1.0.")
 def decode_path(path: str) -> str: ...
 def extract_name_value(line: str) -> list[tuple[str, str]]: ...
 def clean_rcs_keywords(paragraph: nodes.paragraph, keyword_substitutions: Iterable[tuple[Pattern[str], str]]) -> None: ...
 def relative_path(source: StrPath | None, target: StrPath) -> str: ...
-def get_stylesheet_reference(settings: Values, relative_to: str | None = None) -> str: ...
+@deprecated("Deprecated and will be removed in Docutils 1.0. Use `get_stylesheet_list()` instead.")
+def get_stylesheet_reference(settings: Values, relative_to: StrPath | None = None) -> str: ...
 def get_stylesheet_list(settings: Values) -> list[str]: ...
 def find_file_in_dirs(path: StrPath, dirs: Iterable[StrPath]) -> str: ...
 def get_trim_footnote_ref_space(settings: Values) -> bool: ...
@@ -134,7 +129,3 @@ def column_width(text: str) -> int: ...
 def uniq(L: list[_T]) -> list[_T]: ...
 def normalize_language_tag(tag: str) -> list[str]: ...
 def xml_declaration(encoding: str | None = None) -> str: ...
-
-release_level_abbreviations: dict[str, str]
-
-def version_identifier(version_info: tuple[int, int, int, str, int, bool] | None = None) -> str: ...

package/dist/typeshed-fallback/stubs/docutils/docutils/utils/_roman_numerals.pyi

@@ -0,0 +1,30 @@
+from typing import Final, final
+from typing_extensions import Self
+
+__all__ = ("MAX", "MIN", "InvalidRomanNumeralError", "OutOfRangeError", "RomanNumeral")
+
+MIN: Final = 1
+MAX: Final = 4_999
+
+@final
+class OutOfRangeError(TypeError): ...
+
+@final
+class InvalidRomanNumeralError(ValueError):
+    def __init__(self, value: str, *args: object) -> None: ...
+
+@final
+class RomanNumeral:
+    __slots__ = ("_value",)
+    def __init__(self, value: int, /) -> None: ...
+    def __int__(self) -> int: ...
+    def __eq__(self, other: object) -> bool: ...
+    def __lt__(self, other: object) -> bool: ...
+    def __hash__(self) -> int: ...
+    def __setattr__(self, key: str, value: object) -> None: ...
+    def to_uppercase(self) -> str: ...
+    def to_lowercase(self) -> str: ...
+    @classmethod
+    def from_string(cls, string: str, /) -> Self: ...
+
+_ROMAN_NUMERAL_PREFIXES: Final[list[tuple[int, str, str]]]

package/dist/typeshed-fallback/stubs/docutils/docutils/utils/code_analyzer.pyi

@@ -1,11 +1,12 @@
 from collections.abc import Generator, Iterable
-from typing import Literal
+from typing import Final, Literal
 from typing_extensions import TypeAlias
 
 from docutils import ApplicationError
 
 _TokenNames: TypeAlias = Literal["long", "short", "none"]
 
+__docformat__: Final = "reStructuredText"
 with_pygments: bool
 unstyled_tokens: list[str]
 

package/dist/typeshed-fallback/stubs/docutils/docutils/utils/math/__init__.pyi

@@ -1,7 +1,9 @@
-from typing import Literal
+from typing import Final, Literal
 
 from docutils.nodes import Node
 
+__docformat__: Final = "reStructuredText"
+
 class MathError(ValueError):
     details: list[Node]
     def __init__(self, msg: object, details: list[Node] = []) -> None: ...

package/dist/typeshed-fallback/stubs/docutils/docutils/utils/math/math2html.pyi

@@ -4,6 +4,7 @@ from typing import ClassVar, Final, TextIO, TypeVar
 
 _T = TypeVar("_T")
 
+__docformat__: Final = "reStructuredText"
 __version__: Final[str]
 
 class Trace:
@@ -88,7 +89,7 @@ class ContainerExtractor:
     extracted: Incomplete
     def __init__(self, config) -> None: ...
     def extract(self, container): ...
-    def process(self, container, list) -> None: ...
+    def process(self, container, lst) -> None: ...
     def safeclone(self, container): ...
 
 class Parser:

package/dist/typeshed-fallback/stubs/docutils/docutils/utils/math/mathml_elements.pyi

@@ -4,6 +4,7 @@ from collections.abc import Iterable
 from typing import ClassVar, Final, SupportsIndex, overload
 from typing_extensions import Self
 
+__docformat__: Final = "reStructuredText"
 GLOBAL_ATTRIBUTES: Final[tuple[str, ...]]
 
 class MathElement(ET.Element):

package/dist/typeshed-fallback/stubs/docutils/docutils/utils/math/tex2mathml_extern.pyi

@@ -1,5 +1,6 @@
 from typing import Final
 
+__docformat__: Final = "reStructuredText"
 document_template: Final[str]
 
 def blahtexml(math_code: str, as_block: bool = False) -> str: ...

package/dist/typeshed-fallback/stubs/docutils/docutils/writers/__init__.pyi

@@ -1,7 +1,10 @@
+from _typeshed import StrPath
+from pathlib import Path
 from typing import Any, Final, Generic, TypedDict, TypeVar, type_check_only
 from typing_extensions import Required
 
 from docutils import Component, nodes
+from docutils.frontend import Values
 from docutils.io import Output
 from docutils.languages import LanguageImporter
 
@@ -79,4 +82,11 @@ class Writer(Component, Generic[_S]):
 
 class UnfilteredWriter(Writer[_S]): ...
 
+class DoctreeTranslator(nodes.NodeVisitor):
+    settings: Values
+    def __init__(self, document: nodes.document) -> None: ...
+    def uri2path(self, uri: str, output_path: StrPath | None = None) -> Path: ...
+
+WRITER_ALIASES: Final[dict[str, str]]
+
 def get_writer_class(writer_name: str) -> type[Writer[Any]]: ...