API: Expose api.typing.FrozenList for typing (#58237)

Author: mroeschke

doc/source/whatsnew/v3.0.0.rst

@@ -28,6 +28,7 @@ enhancement2
 
 Other enhancements
 ^^^^^^^^^^^^^^^^^^
+- :class:`pandas.api.typing.FrozenList` is available for typing the outputs of :attr:`MultiIndex.names`, :attr:`MultiIndex.codes` and :attr:`MultiIndex.levels` (:issue:`58237`)
 - :func:`DataFrame.to_excel` now raises an ``UserWarning`` when the character count in a cell exceeds Excel's limitation of 32767 characters (:issue:`56954`)
 - :func:`read_stata` now returns ``datetime64`` resolutions better matching those natively stored in the stata format (:issue:`55642`)
 - :meth:`Styler.set_tooltips` provides alternative method to storing tooltips by using title attribute of td elements. (:issue:`56981`)

pandas/api/typing/__init__.py

@@ -9,6 +9,7 @@
     DataFrameGroupBy,
     SeriesGroupBy,
 )
+from pandas.core.indexes.frozen import FrozenList
 from pandas.core.resample import (
     DatetimeIndexResamplerGroupby,
     PeriodIndexResamplerGroupby,
@@ -38,6 +39,7 @@
     "ExpandingGroupby",
     "ExponentialMovingWindow",
     "ExponentialMovingWindowGroupby",
+    "FrozenList",
     "JsonReader",
     "NaTType",
     "NAType",

pandas/tests/api/test_api.py

@@ -257,6 +257,7 @@ class TestApi(Base):
         "ExpandingGroupby",
         "ExponentialMovingWindow",
         "ExponentialMovingWindowGroupby",
+        "FrozenList",
         "JsonReader",
         "NaTType",
         "NAType",