refactor: ♻️ update deprecated usage to use typing.deprecated

[Paillat-dev]

Summary

Fixes #1917
Redo of #2655

The previous version of the PR did not work correctly with type checkers, this one does, with the compromise of needing to use the @deprecated(deprecated_message(...)) syntax. This allows for type checkers to mark methods as deprecated and do some kind of strike trough like shown below:

Information

• This PR fixes an issue.
• This PR adds something new (e.g. new method or parameters).
• This PR is a breaking change (e.g. methods or parameters removed/renamed).
• This PR is not a code change (e.g. documentation, README, typehinting,
  examples, ...).

Checklist

• I have searched the open pull requests for duplicates.
• If code changes were made then they have been tested.
  • I have updated the documentation to reflect the changes.
• If type: ignore comments were used, a comment is also left explaining why.
• I have updated the changelog to include these changes.

[pullapprove4]

This pull request is in the In review step of the Pycord workflow.

Waiting for review from these teams:

• All Contributors (1 of 2 required)
  • Pending reviewers: @Paillat-dev, @plun1331
• Maintainers (0 of 1 required)
  • Pending reviewers: @plun1331

Waiting on these users to move the PR forward: @Paillat-dev, @ChickenDevs, @plun1331.