Add jsdoc type annotation to rules

[bmish]

Supported by VSCode/Webstorm/other code editors. Uses TypeScript declaration to give JavaScript hints so code editors can provide information/autocomplete about various rule fields.

https://www.typescriptlang.org/docs/handbook/jsdoc-supported-types.html#type

Idea from: eslint/generator-eslint#113

[coveralls]

Coverage remained the same at 100.0% when pulling a9352fb on bmish:jsdoc-type-rules into f1b6258 on platinumazure:master.

[platinumazure]

Thanks @bmish for putting this together! Need to review and merge when time allows but I wanted to say I appreciate the contribution.

[platinumazure]

This looks good, but I'm wondering if there's a way to test for this. I would hate to forget the type annotation in new rules... If that's too difficult, we can merge this as is, but I wanted to ask. Thanks!

[bmish]

@platinumazure sure, I added a test.

[platinumazure]

Thanks for contributing!