Update for typescript v3.1.x

[ahocevar]

I am trying to update TypeDoc to use typescript@next, which has some new features that we will be relying on in OpenLayers (see openlayers/openlayers#8449).

I think I was able to update the code properly, but I'm struggling with one failing test:

One thing I noticed is that none of the specs have the isExported: true flag set any more when regenerated with my code. Maybe that's related?

Any help here would be much appreciated.

I'm also willing to continue working on this pull request if there are more requirements for updating to a newer version that I might be missing. I'd be thankful for any comments or reviews.

Fixes #822.

[ahocevar]

Thanks to looking at #825, I was able to fix the isExported issue. All test pass now.

[VictorQueiroz]

This is a must have, we can't generate docs for projects with lower version of TypeScript right now. What's missing to accept this PR?

[lf94]

I too need this. Lets do anything we need to get this in.

[cedx]

TypeDoc should try to use the local TypeScript package (i.e. declared in package.json file), if any one is already installed. Relying on a development version of TypeScript is not a good idea from my point of view...

[lf94]

TypeDoc should try to use the local TypeScript package (i.e. declared in package.json file), if any one is already installed. Relying on a development version of TypeScript is not a good idea from my point of view...

Agreed for everything. IMO your suggestion should be another MR.

This MR should still be merged to encourage people to update. Typescript 3 - Typescript ~2.5 or whichever version typedoc is on, is not a huge difference. Actually it turns out I don't need this MR to get my stuff to work, but regardless, it would be nice.

Who do we poke to move this forward?

[ahocevar]

When merged, this could simply be published as typedoc@next.

[aciccarello]

@lf94 you poke me. I made some testing updates yesterday. I hope to get dependencies updated soon

[ahocevar]

I'm not entirely sure, but it looks like even with this update the @enum and @typedef JSDoc annotations that TypeScript supports now do not generate correct output:

The above was generated from

/** @typedef {Array<number>} Coordinate */

/** @enum {number} */
export const Source = {
  UNKNOWN: 0,
  GPS: 1,
  MANUAL: 2
};