restore DateOffset

Author: MarcoGorelli

pandas-stubs/_libs/tslibs/period.pyi

@@ -15,7 +15,10 @@ from pandas import (
 from typing_extensions import TypeAlias
 
 from pandas._libs.tslibs import NaTType
-from pandas._libs.tslibs.offsets import BaseOffset
+from pandas._libs.tslibs.offsets import (
+    BaseOffset,
+    DateOffset,
+)
 from pandas._libs.tslibs.timestamps import Timestamp
 from pandas._typing import (
     Frequency,
@@ -233,6 +236,6 @@ class Period(PeriodMixin):
     def strftime(self, fmt: str) -> str: ...
     def to_timestamp(
         self,
-        freq: Frequency | None = ...,
+        freq: str | DateOffset | None = ...,
         how: _PeriodToTimestampHow = "S",
     ) -> Timestamp: ...

pandas-stubs/core/arrays/period.pyi

@@ -6,6 +6,7 @@ from pandas.core.arrays.datetimelike import (
 )
 
 from pandas._libs.tslibs import Timestamp
+from pandas._libs.tslibs.offsets import DateOffset
 from pandas._libs.tslibs.period import Period
 
 class PeriodArray(DatetimeLikeArrayMixin, DatelikeOps):
@@ -37,6 +38,8 @@ class PeriodArray(DatetimeLikeArrayMixin, DatelikeOps):
     def start_time(self) -> Timestamp: ...
     @property
     def end_time(self) -> Timestamp: ...
-    def to_timestamp(self, freq: str | None = ..., how: str = ...) -> Timestamp: ...
+    def to_timestamp(
+        self, freq: str | DateOffset | None = None, how: str = ...
+    ) -> Timestamp: ...
     def asfreq(self, freq: str | None = ..., how: str = "E") -> Period: ...
     def astype(self, dtype, copy: bool = True): ...

pandas-stubs/core/series.pyi

@@ -1237,7 +1237,7 @@ class Series(IndexOpsMixin[S1], NDFrame):
     ) -> Series[S1]: ...
     def to_timestamp(
         self,
-        freq: Frequency | None = None,
+        freq: str | DateOffset | None = None,
         how: ToTimestampHow = "start",
         copy: _bool = True,
     ) -> Series[S1]: ...