first save

.venv/lib/python3.12/site-packages/_mpy_shed/mp_available.pyi

@@ -0,0 +1,32 @@
+from typing import Callable, Iterable, Tuple, TypeVar, Union
+
+"""
+Decorator to annotate objects with the MicroPython ports they are available on.
+
+Usage:
+    @mp_available(port="esp32")
+    def foo(): ...
+
+    @mp_available(port=["esp32", "rp2"])
+    class Bar: ...
+"""
+
+
+__all__ = ["mp_available"]
+
+T = TypeVar("T")  # Works for functions, classes, and other callables
+
+def mp_available(
+        *, 
+        port: Union[str, Iterable[str]] =["*"], 
+        version: Union[str, Iterable[str]] =["*"], 
+        macro: Union[str, Iterable[str]] =["*"], 
+    ) -> Callable[[T], T]:
+    """
+    Decorator factory that marks an object as available on the given MicroPython ports.
+    The ports list is stored on the decorated object as __mp_available_ports__.
+    """
+    def decorator(obj: T) -> T:
+        return obj
+    return decorator
+