Add lint "no-deprecated" rule based on @deprecated JSDoc tag

[harrytruong]

Cross-posting issue from gajus/eslint-plugin-flowtype#367
Not sure if this is best implemented as part of flow, or eslint-plugin-flowtype?

---

I'd like to add a new lint to https://flow.org/en/docs/linting/rule-reference/

This is similar to the existing tslint rule deprecation:

• https://palantir.github.io/tslint/rules/deprecation/
• Add a warning when using a JSDoc deprecated method palantir/tslint#825

I'm willing to do the work and submit a PR, if there's any interest in this?

---

Implementation Goals

• implement lint warning on @deprecated functions/methods

  // @deprecated 
  function foo(): void;
  // @deprecated use baz instead
  function bar(): void;
  /**
   * @deprecated see http://example.com/1234
   */
  function baz(): void;

  foo(); // Warning: 'foo' is deprecated.
  bar(); // Warning: 'bar' is deprecated. use baz instead
  baz(); // Warning: 'baz' is deprecated. see http://example.com/1234

• implement lint warning on @deprecated type declarations

  // @deprecated use Foozy in new code.
  type Foo = string;
  type Foozy = 'foo' | 'bar' | 'baz';

  declare var foo: Foo; // Warning: type 'Foo' is deprecated. use Foozy in new code

• implement lint warning on @deprecated modules

  // from misc.js
  /**
   * Collection of misc utility functions
   * @deprecated use `foo` and `bar` modules instead.
   */
  const foo = () => ...;
  const bar = () => ...;
  export default { foo, bar };


  // from `otherFile.js`
  import utils from 'misc'; // Warning: 'misc' is deprecated. use `foo` and `bar` modules instead.

[harrytruong]

closing issue. I found that import/no-deprecated works well enough for my needs!