maint: improve type annotations

[yozachar]

• prefer type inference over explicit typing for function returns
• removes unsettling code in comments from between.py
• uses local instead of project to refer local imports