Revise @typedef, enforce namespaced singularity/uniqueness

This PR implements https://github.com/phpDocumentor/fig-standards/pull/54#issuecomment-52316149

Please keep the discussion on #54 and/or #7.
I am not sure why you rewrote the mentioned use cases and omitted number 3