refactor: migrate Coordinates and Ellipsoid to typescript

[Desplandis]

Description

This PR includes:

• Migration of Coordinates from javascript to typescript
• Migration of Ellipsoid from javascript to typescript
• Add missing types
• Code formatting
• TSDoc compliant documentation

Proposed breaking type changes:

• For simplification and alignment with Three.Vector3, I propose that the constructor of Coordinates only accepts numbers as parameters. We could set from array, coordinates-like objects from corresponding methods setFromArray() or setFromVector3. Note that for js users, we would not for now break compatibility (maybe add a depreciation notice).

Motivation and Context

As described in proposal #2396, we aim to gradually migrate our entire codebase (with the exception of deprecated modules) from javascript to typescript. We choose to start with modules with no-dependency and move up in the dependency tree.

This PR is the second step of Migrate geographic modules, migrating the both co-dependent modules Coordinates and Ellipsoid. This PR is a follow-up of #2436.

[AnthonyGlt]

Thanks for the MR, well done :D

Should we not specified the return type of the different function of these new TS files ?
For example, for the function cartesianToCartographic of Ellipsoid
In the JS doc, we were specifying the return type, it was helping while reading the code.
I get that TypeScript is capable of inferring the return type but could be nice to still write it, like you did in Coordinates.ts. WDYT ?

[AnthonyGlt]

Suggested change

	if ((v0 as any).length > 0) { // deepscan-disable-line
	if ((x as any).length > 0) { // deepscan-disable-line

?

[Desplandis]

I would like to remove the instanciation of Coordinates with an array or a vector3 for typescript users but not break the API for javascript users until a major version bump. However, it seems the deepscan static checker can infer that x (even if cast as any) has no property length and the CI failed. This is will be removed with the next major version bump.

[AnthonyGlt]

I don't understand why we do the condition on v0 though ? It's not given by the user , isn't ?

[Desplandis]

Holy crap, I shall read more carefully, this is a suggested change, thought it was my code. xD
I indeed intended to check the value of x, will fix it!

[Desplandis]

@AnthonyGlt Return types in Ellipsoid are now explicit!

[Desplandis]

@AnthonyGlt All good!