✨: add HasArrayIMatmul protocol to support in-place matrix multiplication operator for array classes

Author: nstarman

src/array_api_typing/_array.py

@@ -304,6 +304,22 @@ def __matmul__(self, other: Self, /) -> Self:
         ...
 
 
+class HasArrayIMatmul(Protocol):
+    """Protocol for array classes that support the in-place matrix multiplication operator."""  # noqa: E501
+
+    def __imatmul__(self, other: Self, /) -> Self:
+        """Calculates the in-place matrix product for each element of an array instance with the respective element of the array other.
+
+        Args:
+            other: multiplicand array. Must be compatible with self (see Broadcasting). Should have a numeric data type.
+
+        Returns:
+            self, after performing the in-place matrix multiplication.
+
+        """  # noqa: E501
+        ...
+
+
 class HasArrayInvert(Protocol):
     """Protocol for array classes that support the inverse operator."""
 
@@ -513,6 +529,7 @@ class Array(
     HasArrayPow,
     HasArrayIPow,
     HasArrayMatmul,
+    HasArrayIMatmul,
     HasArrayInvert,
     HasArrayAnd,
     HasArrayOr,