`Intl.CollatorOptions['collation']` is missing value `'default'`

[quisido]

🔎 Search Terms

• Intl.CollatorOptions
• collation

🕗 Version & Regression Information

• This is the behavior in every version I tried, and I reviewed the FAQ for entries about collation.

⏯ Playground Link

https://www.typescriptlang.org/play/?#code/HYUw7gBAksAuA2A6Awge3vAhrVAnAFANoC6ANBAN4BQEEAxulrAJarABcEA5ACYgBmmAK7xYXUlQC+ASgDcVIA

💻 Code

new Intl.Collator([], {
  collation: 'default',
});

🙁 Actual behavior

Type '"default"' is not assignable to type ...

🙂 Expected behavior

'default' should be a valid value for collation.

Additional information about the issue

MDN documentation

[IllusionMH]

Is that real value that users are supposed to pass or it's just syntatically valid, but result in same value in the end because it fallbacks to "default"?

List of supported collations doesn't have default https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/supportedValuesOf#supported_collation_types

But following link in that paragraph leads to page with

For example, new Intl.DateTimeFormat("default") uses the implementation's default locale only because "default" is syntactically valid but not recognized as any locale.

https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl#locales_argument

[RyanCavanaugh]

It's a little confusing since new Intl.Collator([], { collation: 'default' }); is indeed a fallback the same new Intl.Collator([], { collation: 'blah' }); is, but the resolvedOptions() shows this as "default" so it seems entirely sensible to allow it as input.