[feature] Type Hints in Conan API

[stackfun]

What is your suggestion?

Hi! I started migrating our codebase from Conan v1 to Conan v2 and the python interface is a lot nicer for sure.

It would be even more awesome if the API's had type hints! It will likely increase productivity of your team (definitely for developers like me), and would also eliminate a whole class of bugs 👍

Have you read the CONTRIBUTING guide?

• [X] I've read the CONTRIBUTING guide