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?

Issue の warnings.deprecated と TYPE_CHECKING の例から始め、typing 仕様が非推奨メタデータとデコレータシグネチャをどのように表現しているかを確認します。packaging.Version メタデータを受け入れつつ、型システムが正しく動作する設計について合意できれば完了です。この issue では特定のファイルやテストは指定されていません。