feat apilinks.json generator

[flakey5]

Closes #152

Opening this as a draft currently to get feedback on the approach since it's a bit non-trivial relative to the other generators. The apilinks.json file maps things exported by modules to their source locations on Github.

Example:

{
  "SomeClass.prototype.var": "github.com/nodejs/node/tree/<hash>/lib/file.js#L100"
}

This means we need to parse the module's javascript source in addition to its markdown.

What the current approach does is doing:

• Adds another loading & parsing step for the js source files
  • acorn is used for parsing the source files
  • This intakes .js files, so to run it you need to do pass in node/lib/*.js as the input
  • This is dependent on the Markdown source parsing since it uses the source_link metadata in the docs
• Exposes the parsed js ast to other generators by adding the ast-js generator
• api-links generator is based off of the ast-js result

[ovflowd]

@flakey5 do you need review here? I think I forgot to review this PR!

[flakey5]

do you need review here

As far as the approach yes please

[ovflowd]

Approach in general sounds good; Just, some of these utilities are way too complex and big and the git manipulation scripts are possibly dangerous or at least an easy vulnerability hell.

[ovflowd]

Also, @flakey5 this https://github.com/syntax-tree/estree-util-visit is what I was referring to use to walk through the Nodes of the source code. Since acorn generates an AST that is compatible with estree.

[ovflowd]

@flakey5 there are PR conflicts. Could you fix'em?

[ovflowd]

So far looking good. Left more comments, will review more once they are addressed-

[ovflowd]

Hey @flakey5 friendly bump :D

[ovflowd]

LGTM! Left minor comments but the work you've done here is impressive and surely should be remarked.

[AugustinMauroy]

LGMT !

[ovflowd]

I think code sat long enough here. Whilst I believe some pieces can still be broken down even further (there are some huge switch statements within some methods that I believe can be moved to dedicated functions and even different files)... this is LGTM and we should get going to unblock our own work!

We can always iterate on this, cc @flakey5

Anyhow, just wanted to point out the amazing work you've done here!