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 未指定具体文件或测试。