Use data type map instead of overloads

[Planeshifter]

Description

What is the purpose of this pull request?

This pull request:

• proposes changing the TypeScript definitions for packages accepting a dtype parameter and returning an array of the respective type to not use function overloads but instead a type map. This allows for cutting down on the resulting bloat and will make the codebase more maintainable, as adding support for a new data type would simply require updating the type map inside @stdlib/types.

One potential concern is Intellisense showing opaque type information, but I argue that this is a non-issue if we have appropriate TSDoc comments, as is the case in this example where we enumerate the possible values in the comment.

Furthermore, the current overloading strategy also is not ideal from an Intellisense point of view, since it forces users to manually step through the available overloads to see what inputs are allowed:

(there is a 1/12 stepper button in the bottom left to toggle between the overloads; covered by the Copilot interface for some reason but usually it's fully visible...)

Related Issues

Does this pull request have any related issues?

No.

Questions

Any questions for reviewers of this pull request?

No.

Other

Any other information relevant to this pull request? This may include screenshots, references, and/or implementation notes.

No.

Checklist

Please ensure the following tasks are completed before submitting this pull request.

• Read, understood, and followed the contributing guidelines.

---

@stdlib-js/reviewers

[kgryte]

@Planeshifter All in all, this is looking good. And the changes certainly condense declarations and better preserve type information. In general, I think we need to rename the type maps and do so using an existing naming convention. Personally, I don't have an issue with verbosity, given auto-complete and aliasing.

[Planeshifter]

@kgryte Feedback has been addressed, PR is now ready for another look!

[kgryte]

Thanks for the updates, @Planeshifter. Left a few comments concerning when to use DataTypeMap vs when to use NumericAndGenericDataTypeMap.

[kgryte]

LGTM. Thanks, @Planeshifter! Let's get this in. Any further updates can be addressed in follow-up PRs.