Tried to provide some type hints ...
That seems to be a bit early. However, adding some type hints here and there is also nice for documentation. But making the check program (e.g. in vs code) happy is a bit challenging. Just do it for now for new things, or where it is useful, but don't worry about the checker programs.