Add new @enum tag

Hi!

Current JSDoc spec allows documenting plain objects as enumerables. This is very helpful when restricting argument types.

An abstract example:

//Season.js
/**
 * @enum {String}
 */
const Season = {
    SPRING: 'SPRING',
    SUMMER: 'SUMMER',
    AUTUMN: 'AUTUMN',
    WINTER: 'WINTER'
};

export default Season;

//Forecast.js
export default class Forecast {
    /**
     * @param {Season} season
     */
    generate(season) {
        //implementation
    }
}

//test.js
import Season from './Season.js';
import Forecast from './Forecast.js';

let forecast = new Forecast();
forecast.generate(Season.SUMMER);

Current implementation of ESDoc treats season argument of Forecast#generate as a variable import Season from './Season.js' instead of const Season inside Season.js.

Is it planned to support @enum annotations similar to @typedef?

[pronebird]

We use them a lot

[elashpear]

@raveclassic That sounds like a great idea - would love some tips on how to do this. I was able to get ESDoc up and running super easily but I have been unable to figure out how to do the same with typedoc, it just spits out an empty template page.