Specify whether the order of insertion is preserved or not

[Masterxilo]

Can you please comment on the order in which keys and values will be returned when iterating this?

JavaScript Map for instance guarantees that iterating over the map returns the keys in the order in which they where inserted.

I assume this library just preserves the order in which the keys where first inserted, and on enumerating keys and values, all values for a fixed key are returned before the key changes.

But you don't specify any guarantees about order anywhere.

This makes it hard to judge whether we can rely on any ordering or not.

In my use case, I absolutely require that the order in which values for the same key are inserted is preserved...

[KoryNunn]

Hey @Masterxilo, From reading the implementation I'd be pretty confident to state that the order of insersion is preserved, however, that's not 'speccd' anywhere. It would be good to add a test and documentation that asserts this.