Use @link references that TypeDoc can understand

[yokuze]

The JSDoc documentation in this repo uses this format when @linking to code in its comments: {@link EventEmitterMixin#on}, where a # symbol separates the interface/class name and the interface/class's member:

event-emitter/src/types/index.d.ts

Line 13 in 32e131f

* the optional `context` parameter on the {@link EventEmitterMixin#on} method to do so

JSDoc supports this syntax, although it is not well documented. Note the example of it under the "Example" heading here, but no formal documentation on how to reference class members.

It seems that using a . character instead of # is equally valid. TypeScript, VS Code, and other tools like TypeDoc that parse JSDoc comments recognize the . convention. However, TypeDoc does not recognize the # convention, which leads to broken links in documentation sites generated with TypeDoc.

We should switch to using the . format that's supported by the most tooling.

Additionally, the TS types in this project reference the EventEmitterMixin symbol when is should be referencing the IEventEmitter interface.