test, docs: ensure get_bright_perc returns expected types

test, docs: ensure get_bright_perc returns expected types #42