TYP: freq and na_value (pandas-dev#47729)

* TYP: freq and na_value

* _simple_new

Author: twoertwein

pandas/core/arrays/datetimelike.py

@@ -2202,7 +2202,9 @@ def validate_periods(periods: int | float | None) -> int | None:
     return periods  # type: ignore[return-value]
 
 
-def validate_inferred_freq(freq, inferred_freq, freq_infer):
+def validate_inferred_freq(
+    freq, inferred_freq, freq_infer
+) -> tuple[BaseOffset | None, bool]:
     """
     If the user passes a freq and another freq is inferred from passed data,
     require that they match.

pandas/core/arrays/datetimes.py

@@ -264,7 +264,10 @@ def _validate_dtype(cls, values, dtype):
     # error: Signature of "_simple_new" incompatible with supertype "NDArrayBacked"
     @classmethod
     def _simple_new(  # type: ignore[override]
-        cls, values: np.ndarray, freq: BaseOffset | None = None, dtype=DT64NS_DTYPE
+        cls,
+        values: np.ndarray,
+        freq: BaseOffset | None = None,
+        dtype=DT64NS_DTYPE,
     ) -> DatetimeArray:
         assert isinstance(values, np.ndarray)
         assert dtype.kind == "M"
@@ -291,7 +294,7 @@ def _from_sequence_not_strict(
         dtype=None,
         copy: bool = False,
         tz=None,
-        freq=lib.no_default,
+        freq: str | BaseOffset | lib.NoDefault | None = lib.no_default,
         dayfirst: bool = False,
         yearfirst: bool = False,
         ambiguous="raise",

pandas/core/frame.py

@@ -1746,7 +1746,7 @@ def to_numpy(
         self,
         dtype: npt.DTypeLike | None = None,
         copy: bool = False,
-        na_value=lib.no_default,
+        na_value: object = lib.no_default,
     ) -> np.ndarray:
         """
         Convert the DataFrame to a NumPy array.

pandas/core/indexes/datetimes.py

@@ -25,6 +25,7 @@
     lib,
 )
 from pandas._libs.tslibs import (
+    BaseOffset,
     Resolution,
     periods_per_day,
     timezones,
@@ -312,7 +313,7 @@ def isocalendar(self) -> DataFrame:
     def __new__(
         cls,
         data=None,
-        freq=lib.no_default,
+        freq: str | BaseOffset | lib.NoDefault = lib.no_default,
         tz=None,
         normalize: bool = False,
         closed=None,

pandas/core/internals/array_manager.py

@@ -1132,7 +1132,7 @@ def as_array(
         self,
         dtype=None,
         copy: bool = False,
-        na_value=lib.no_default,
+        na_value: object = lib.no_default,
     ) -> np.ndarray:
         """
         Convert the blockmanager data into an numpy array.