ref(api): Improve sentry_sdk.trace type hints

[szokeasaurusrex]

Type hints for sentry_sdk.trace decorator function now indicate that the decorator returns a function with the same signature as it was called with. Previously, the type hints indicated that the decorator could return Any, which caused users to lose type hints for decorated functions.

Before this change:

After this change:

Fixes GH-2460

[szokeasaurusrex]

@sentrivana Is docs the correct commit message scope here? It seems appropriate to me since type hints in Python aren't part of the code, but rather they serve only to document expected types. Or do you have a different idea?

[sentrivana]

@szokeasaurusrex Looking at sentry folks seem to usually either go with ref or fix for type hint fixes/changes so I'd probably pick one of those.