How to extend `warnings.deprecated`?

We need more metadata for our deprecation decorator, but the spec doesn’t say how deprecated marks an API. So the only way to mark something as deprecated it is by creating an API with the same exact signature and replace it with warnings.deprecated at the type level:

if TYPE_CHECKING:
    from warnings import deprecated
else:
    def deprecated[F](msg: str) -> Callable[[F], F]: ...

We need to define deprecated(msg: str, version: packaging.Version) and have it work with the type system. How?

Beginne mit den Beispielen warnings.deprecated und TYPE_CHECKING aus dem Issue und prüfe anschließend, wie die typing-Spezifikation Deprecation-Metadaten und Decorator-Signaturen darstellt. Als abgeschlossen gilt die Einigung auf ein Design zur Annahme von packaging.Version-Metadaten unter Beibehaltung des korrekten Verhaltens des Typsystems; das Issue nennt keine bestimmte Datei oder keinen bestimmten Test.