Add JSDocs to generated projects

[frandiox]

WHY are these changes introduced?

We already have GraphQL Codegen for TypeScript but JS projects are not getting any benefits from it. This adds JSDocs to the generated JS projects.

WHAT is this pull request doing?

This uses ts-morph to transpile TS => JS and also generate JSDocs at the same time from the TS types.

First, it adds typedefs for each type at the bottom:

Then, it annotates each function using the types defined:

HOW to test your changes?

In the templates folder, run:

h2 init --path jsdocs --language js --force --styling none --mock-shop --no-shortcut --markets domains --no-install-deps --routes && cd jsdocs && ln -s ../../node_modules node_modules

Check that the generated project has JSDocs and works with Codegen. You might need to >TypeScript: Restart TS Server in VSCode at times.

Post-merge steps

Checklist

• I've read the Contributing Guidelines
• I've considered possible cross-platform impacts (Mac, Linux, Windows)
• I've added a changeset if this PR contains user-facing or noteworthy changes
• I've added tests to cover my changes
• I've added or updated the documentation

[benjaminsehl]

LGTM! 🚀🦐

[blittle]

FWIW ts-morph adds about 13mb to the install: https://pkg-size.dev/ts-morph

[frandiox]

Yeah, but it replaces typescript, which is 41mb. Creating a new Hydrogen project (i.e. installing the CLI globally) should now download 28mb less than before 😄

[frandiox]

@blittle just to double check, do you think it's OK to include this license here in this file?

[blittle]

Hmmm, looks like it should be okay, as long as we keep the copyright notice: https://memgraph.com/blog/what-is-mit-license#:~:text=2.%20Does%20the%20MIT%20License%20allow%20commercial%20use%3F