Documentation tidyup/updates

[bsian03]

Continuation of #957 (or rather another attempt)

See here for old stuff

I haven't done JSDoc this time round, however have done the structure changes:

From inside the namespace, the order is as follows)

• Constants - Constants and VERSION
• Types - grouped together, alphabetical order of group name and in each group (i haven't included group name)
• Interfaces, also as above (Exception being Events and Constants, of which are at the bottom of their respective group)
• Classes, in alphabetical order

Each category has 2 newline separations, with each group, or each class with a single newline separation

I'll also fill in missing docs for JSDoc

Invite.guild also now gets the relevant guild
Invite.channel now gets the relevant guild channel if the guild is cached. if group channel or not cached this will still be an object

(note for abal, please don't merge this with the other PRs since there's bound to be conflicts once the other PRs get merged)

Documentation/codebase layout changes

• Everything is now in alphabetical order, this includes all docs (including TypeScript) and methods/props.
• Added a linter to enforce the above (classes only)
• Added missing and corrected incorrect docs
• Consistency in JSDoc types
• Removed superclass props from JSDoc
• Invite#guild and Invite#channel will now fetch their respective instances. If Invite#guild is not cached, this will still be an object. If Invite#guild is not cached or Invite#channel is a GroupChannel, this will also still be an object. (this should really be in its own PR but too late)
• Deprecate supplying userID parameter for messageReactionAdd and messageReactionRemove for DMs (Anything other than "@me" will error)
• Update to TypeScript v4!

TypeScript v4

• Updated typescript eslint parser and plugin
• Slight change to types to respect TypeScript v4 rules
• Add deprecation flag to deprecated properties/getters/methods! (This also works for overloads)

Warning may be shown in the console of the CI, this can be disregarded, see here

Resolves #1003
Resolves #1004

[bsian03]

Should I reorder JSDoc?

[bsian03]

Turns out some of the events typings are incorrect, I'm going through them now

[Dragory]

The following properties are missing from index.d.ts for Message, could be included in this PR:

• application
• messageReference
• activity
• flags

[Runi-c]

This could go in this PR too:
The documentation on the event webhooksUpdate is wrong, channelID and guildID should be given as properties of data, not as separate parameters.

~Shard.js:1625

[DonovanDMC]

An update for webhooks returning Message<GuildTextableChannel> can be shoved in, considering webhooks only exist in guilds

[bsian03]

That's already been done

[DonovanDMC]

need OldGuildChannel.position to be changed to number from string (I don't know how to suggest changes on pr's, or if I even can)

[jtsshieh]

@DonovanDMC pr on bsian's fork for free pr :)

[DonovanDMC]

true true (done that 👍)

[bsian03]

@DonovanDMC btw it's File changes (whatever the last tab is called), go to index.d.t.s and find OldGuildChannel, then click on the blue "+" and click on that small file icon - it should load the text input with a codeblock prefixed suggestion

[abalabahaha]

This better work