Fix SphinxJS/TypeDoc integration

[raucao]

The new version of SphinxJS has been released, and it has official TypeDoc support now. I successfully got it running on my machine. But I had to refactor the last remaining non-native classes/functions for the autofunction lookups to work.

closes #1192

[raucao]

Something is still wrong with ReadTheDocs' TypeScript/TypeDoc setup: https://readthedocs.org/projects/remotestoragejs/builds/11943970/

It's missing our npm type dependencies apparently, and it looks like it's also using outdated TS. I'm having a look.

[raucao]

I couldn't make it work so far. Looking at a raw build log, it seems to me like RTD is not actually running npm i during the build process, so we'd have to check in and push the node_modules folder.

Improved some other things on the way, like e.g. having more than just master/latest being published. v1.2.3 is now published explicitly in addition, and used as default redirect. Visitors can then switch to "latest" if they choose so.

Edit: I found that they actually have a support team and contact, so I wrote them an email about our problem.

[raucao]

Eric from RTD got back to me and suggested to just hackfix the pre-build step by shelling out from conf.py, which is a Python file that is being executed before the build. So I tried that, and it worked immediately:

https://remotestoragejs--1199.org.readthedocs.build/en/1199/contributing/docs.html

Everything ready to merge now, and it will publish the new docs as "latest", as soon as this PR lands in master. (New default then still being "v1.2.3"/stable.)

[galfert]

Documentation builds are working for me.

For the autobuilding I first tried running npm run doc, because that's the first task I found in the package.json.

But that task faild with an error:

sphinx-autobuild: error: unrecognized arguments: -i -i -i #*# . _build/html

Looks like the shorthand version for the --ignore argument isn't supported anymore by sphinx-autobuild.

But then I noticed that the documentation documentation (doc/contributing/docs.rst) mentions the task autobuild-docs instead. It's the same as the doc task, just without the ignore arguments. So I removed the doc task to prevent any further confusion.

In the doc builds themselves I noticed that all number arguments have the type unknown now:

But I guess that can be fixed as part of #1201.

[raucao]

In the doc builds themselves I noticed that all number arguments have the type unknown now:

We'll have to find a solution for that, because the type is actually supposed to be "unknown" in the code, so that TypeScript forces us to validate the unknown input from app authors/code. But yeah, I agree that we can handle that later.

[raucao]

I couldn't find a solution for the unknown type problem, so I created an issue about it here: TypeStrong/typedoc#1370

[raucao]

Talked about it with @galfert and we came to the conclusion that using normal types instead of unknown is the best solution here. Losing the type safety isn't worth the effort in this case.

[raucao]

I just pushed some commits to address the last documentation issue (unknown argument types). Ready to merge AFAICS.

/cc @galfert

[galfert]

Looks good to me 👍