added type hint for better IDE support
updated documentation
updated documentation, removed unused key from iteration
added type hinting for better IDE support, plus missing import
translator fix, plus additional unit test