feat: improve deprecation warnings - PEP-387

[jkowalleck]

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

goal: improve backwards compatibility, while improving Developer experience.

solution

• move deprecated property warnings to setters
  • via fix: issue DeprecationWarnings for deprecated properties properly #838
• annotate deprecated symbols
  • via feat: decorate deprecated symbols #839
• use DeprecationWarning instead of warnings. -- DEBATABLE -- see below
  • requires py8.13

important

we dont have any intention to remove deprecated properties, unless we have a backwards-compatibility layer that guarantees that all supported versions of CycloneDX spec are serializable and deserializable.

implementation

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