Back when TypeScript was v0.9.1 there was no need to order overloads in typing files. Then come 0.9.5 there was this breaking change:
Overload resolution rules simplified
Description: Overload resolution now follows a much simpler algorithm. When multiple overloads fit for a given call, we pick the first fit rather than the trying to find the "best fit".
This means that code with overloads should now be manually sorted from the tightest/more-specific overload to loosest. The one exception is that an 'any' in the callee will try to match an 'any' in the caller.
I understand the reasons for this but speaking as someone involved with the Definitely Typed project I would love to see a return to the previous functionality where ordering was no longer so key. It's easy to get wrong and frustrating to tweak it until everything
lines up as you would hope.
Is this something you might consider in a post v1.0 world? Could we have the "best fit" functionality back?