feat: improve deprecation warnings - PEP-387

[jkowalleck]

see also: https://peps.python.org/pep-0387/

goal: improve backwards compatibility, while improving Developer experience.

solution

• use DeprecationWarning instead of warnings.
• annotate deprecated symbols

requires py8.13

implementation

• use for annotation of symbols: https://typing-extensions.readthedocs.io/en/latest/#typing_extensions.deprecated