Use typing

[t20100]

Let's add typing to the API and leverage it in the documentation with sphinx-autodoc-typehints

[vasole]

I know some people like it, but I find the code less readable.