feat: #983 new TypeVar, following #990 (comment)

Author: cmp0xff

pandas-stubs/core/indexes/base.pyi

@@ -18,6 +18,7 @@ from typing import (
 )
 
 import numpy as np
+from numpy import typing as npt
 from pandas import (
     DataFrame,
     DatetimeIndex,
@@ -260,7 +261,7 @@ class Index(IndexOpsMixin[S1]):
         **kwargs,
     ) -> Self: ...
     @property
-    def str(self) -> StringMethods[Self, MultiIndex]: ...
+    def str(self) -> StringMethods[Self, MultiIndex, npt.NDArray[np.bool_]]: ...
     def is_(self, other) -> bool: ...
     def __len__(self) -> int: ...
     def __array__(self, dtype=...) -> np.ndarray: ...

pandas-stubs/core/series.pyi

@@ -1163,7 +1163,7 @@ class Series(IndexOpsMixin[S1], NDFrame):
     ) -> Series[S1]: ...
     def to_period(self, freq: _str | None = ..., copy: _bool = ...) -> DataFrame: ...
     @property
-    def str(self) -> StringMethods[Series, DataFrame]: ...
+    def str(self) -> StringMethods[Series, DataFrame, Series[bool]]: ...
     @property
     def dt(self) -> CombinedDatetimelikeProperties: ...
     @property

pandas-stubs/core/strings.pyi

@@ -12,6 +12,7 @@ from typing import (
 )
 
 import numpy as np
+from numpy import typing as npt
 import pandas as pd
 from pandas import (
     DataFrame,
@@ -27,8 +28,10 @@ from pandas._typing import (
 
 # The _TS type is what is used for the result of str.split with expand=True
 _TS = TypeVar("_TS", DataFrame, MultiIndex)
+# The _TM type is what is used for the result of str.match
+_TM = TypeVar("_TM", Series[bool], npt.NDArray[np.bool_])
 
-class StringMethods(NoNewAttributesMixin, Generic[T, _TS]):
+class StringMethods(NoNewAttributesMixin, Generic[T, _TS, _TM]):
     def __init__(self, data: T) -> None: ...
     def __getitem__(self, key: slice | int) -> T: ...
     def __iter__(self) -> T: ...
@@ -100,7 +103,7 @@ class StringMethods(NoNewAttributesMixin, Generic[T, _TS]):
     ) -> Series[bool]: ...
     def match(
         self, pat: str, case: bool = ..., flags: int = ..., na: Any = ...
-    ) -> Series[bool]: ...
+    ) -> _TM: ...
     def replace(
         self,
         pat: str,