DOC: Update MultiIndex.take and MultiIndex.repeat docstring examples to use MultiIndex (pandas-dev#62809)

Author: Starlessnightx

pandas/core/indexes/multi.py

@@ -3460,6 +3460,23 @@ def maybe_mi_droplevels(indexer, levels):
 
             return new_index
 
+        # type-check key against level(s), raise error if mismatch
+        if isinstance(key, tuple):
+            for i, k in enumerate(key):
+                if not self._is_key_type_compatible(k, i):
+                    raise TypeError(
+                        f"Type mismatch at index level {i}: "
+                        f"expected {type(self.levels[i][0]).__name__}, "
+                        f"got {type(k).__name__}"
+                    )
+        else:
+            if not self._is_key_type_compatible(key, level):
+                raise TypeError(
+                    f"Type mismatch at index level {level}: "
+                    f"expected {type(self.levels[level][0]).__name__}, "
+                    f"got {type(key).__name__}"
+                )
+
         if isinstance(level, (tuple, list)):
             if len(key) != len(level):
                 raise AssertionError(
@@ -3591,6 +3608,18 @@ def maybe_mi_droplevels(indexer, levels):
 
             return indexer, result_index
 
+    def _is_key_type_compatible(self, key, level):
+        """
+        Return True if the key type is compatible with the type of the level's values.
+        """
+        if len(self.levels[level]) == 0:
+            return True  # nothing to compare
+        level_type = type(self.levels[level][0])
+
+        # Same type → OK
+        if isinstance(key, level_type):
+            return True
+
     def _get_level_indexer(
         self, key, level: int = 0, indexer: npt.NDArray[np.bool_] | None = None
     ):

pandas/tests/indexes/multi/test_datetime_indexing.py

@@ -0,0 +1,15 @@
+import datetime
+
+import numpy as np
+import pytest
+
+import pandas as pd
+
+
+def test_multiindex_date_npdatetime_mismatch_raises():
+    idx = pd.MultiIndex.from_product(
+        [[datetime.date(2023, 11, 1)], ["A"], ["C"]], names=["date", "t1", "t2"]
+    )
+    df = pd.DataFrame({"vals": [1]}, index=idx)
+    with pytest.raises(TypeError, match="Type mismatch"):
+        df.loc[(np.datetime64("2023-11-01"), "A", "C")]