add missing phpdoc and fix signature type hint
really fix the phpdoc :p