Bump readme version; clean up return type hinting