✨: add CanArrayIMod protocol

Support in-place modulo operator for array classes

Author: nstarman

src/array_api_typing/_array.py

@@ -271,6 +271,22 @@ def __mod__(self, other: Self | int | float, /) -> Self:
         ...
 
 
+class CanArrayIMod(Protocol):
+    """Protocol for array classes that support the in-place modulo operator."""
+
+    def __imod__(self, other: Self | int | float, /) -> Self:
+        """Evaluates `self_i % other_i` for each element of an array instance with the respective element of the array `other`.
+
+        Args:
+            other: divisor array. Must be compatible with self (see Broadcasting). Should have a numeric data type.
+
+        Returns:
+            self, after performing the in-place modulo operation.
+
+        """  # noqa: E501
+        ...
+
+
 class CanArrayPow(Protocol):
     """Protocol for array classes that support the power operator."""
 
@@ -317,6 +333,7 @@ class Array(
     CanArrayFloorDiv,
     CanArrayIFloorDiv,
     CanArrayMod,
+    CanArrayIMod,
     CanArrayPow,
     CanArrayIPow,
     Protocol,