Convert core JS to Typescript

[askvortsov1]

This should be done in small, maximally isolated PRs: no more than a few files updated per PR so that we can slowly review and phase these in over time. Community contributions appreciated!

For overall progress, see the GitHub Project board: https://github.com/orgs/flarum/projects/21

[mihirgupta0900]

Hey maintainers!
I would love to take this issue up, looks like an amazing learning opportunity! I'm not very experienced with Typescript, but know the basics.

[askvortsov1]

That's great to hear, and we'd definitely appreciate the help! https://docs.flarum.org/contributing.html might be a good place to start for setup stuff (and reading a bit more about how flarum works). Our community forums and discord chat are also good resources if you have questions / run into issues.

[mihirgupta0900]

Great to hear! I've joined the discord chat and I'll go through the links in a few hours and get started soon!

[knoxd8256]

Is this a good issue for multiple contributors? I'd also like to work on this, and I've joined the discord so we might make sure not to double up on work.

[tankerkiller125]

@knoxd8256 this would be a great issue for multiple contributors, my recommendation would be to negotiate work being done via our discord chat and/or this issue so that we don't have repeat file updates.

[nina-py]

Can I confirm that the file naming conventions for TypeScript files are .ts for general code and .tsx for anything containing JSX-like syntax? The linked PRs seem to be following these naming conventions but the unconverted JS files are all .js. The reason I'm asking is that if .tsx files are the new norm for components and the like, this line in tsconfig.json needs to be updated to include them to get rid of certain warnings, i.e. the esModuleInterop one:

https://github.com/flarum/core/blob/9cb9097b24e0345816f2f8ef22789ab804e796f6/js/tsconfig.json#L2

[dsevillamartin]

@nina-py Yes, we use .tsx for JSX.

this line in tsconfig.json needs to be updated to include them to get rid of certain warnings, i.e. the esModuleInterop one:

Hm, if that's the source of the warning then that's a big 🤦 for me. Feel free to PR to that - it might be enough if you just add * after *.ts, can't remember if that works or not.

[askvortsov1]

Maybe that might also help with the ESDoc generation issue? Although I doubt it

[dsevillamartin]

@askvortsov1 Don't think so - that's a separate config file anyway.

[nina-py]

Thanks @datitisev, a PR is on the way.

Hm, if that's the source of the warning then that's a big facepalm for me. Feel free to PR to that - it might be enough if you just add * after *.ts, can't remember if that works or not.

According to the docs (see quote below), all that needs to be done is removing the .ts. file extension and it will automatically pick up only the converted files and not the entire codebase.

If a glob pattern doesn’t include a file extension, then only files with supported extensions are included (e.g. .ts, .tsx, and .d.ts by default, with .js and .jsx if allowJs is set to true).

https://www.typescriptlang.org/tsconfig#include