Major Refactor 2024

[smack0007]

Before the release of SDL 3 is upon us there are a few things I would like to implement. These points will be implemented as a series of pull requests in no specific order.

• Automatic error checking in functions.

  • Error codes should be checked automatically and throw an exception if needed. Infrastructure should be implemented but may not be enabled in all functions due to lacking tests.

• Output parameters should be returned as tuples.

  • Functions like SDL_CreateWindowAndRenderer should return the output parameters (i.e. window and renderer in this case) as a tuple instead of having to create Box(es) and giving them to the functions.

• Remove custom number types (u8, i32, etc.) and instead just use the same types as SDL (Uint8, int).

  • Currently the names of some types from SDL are being mapped to names in SDL_ts. This is just confusing and unnecessary. Just leave the names of the types the same as in SDL and create types in SDL_ts with the same name. (i.e. export type Uint8 = number;)

• Make Box<T> of private. Don't export it.

  • Once points 1 and 2 are implemented Box<T> should become unnecessary for consumers of the API.

• Remove Memory.

  • Once points 1 and 2 are implemented Memory should become unnecessary for consumers of the API.

• Investigate removing or making private Pointer<T> .

  • Similar to the previous point, once 1 and 2 are implemented Pointer<T> should start to slowly become irrelevant for consumers of the API.

• BoxArray => StructArray

  • BoxArray was really only necessary in order to be able to send multiple structs to the native side.

• Make Opaque Structs just simple branded types again.

  • Opaque Struct(s) should just be a branded type instead of a complete class definition.