I'm not overly fond of littering the source code with these sorts of inline type hinting. It looks nasty and only serves to help people with specific IDEs. In the past I found compatibility between Eclipse, Netbeans, and PHPStorm on these sorts of things to be patchy and in some cases (like array types) to be incompatible.

Anyway, in the tests it might not be so bad but I switched from actively doing this to actively **removing** these types of hints from all of my projects. (you may still run into it from time to time; if I find them, I blast them) If this makes your life miserable, convince me I'm wrong and that these are good and we can consider allowing them at least for the tests.