I'd rather have a typescript interface if we know the form that the function assumes the input will take. :) 
For typescript code, we should provide types, not closure style comments.