@formatjs/intl-supportedvaluesof 2.1.2

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@formatjs/intl-supportedvaluesof",
+  "description": "Intl.supportedValuesOf polyfill",
+  "version": "2.1.2",
+  "license": "MIT",
+  "author": "Michele Riva <ciao@micheleriva.it>",
+  "type": "module",
+  "types": "index.d.ts",
+  "exports": {
+    ".": "./index.js",
+    "./polyfill.js": "./polyfill.js",
+    "./polyfill-force.js": "./polyfill-force.js",
+    "./should-polyfill.js": "./should-polyfill.js"
+  },
+  "dependencies": {
+    "@formatjs/ecma402-abstract": "workspace:*",
+    "@formatjs/fast-memoize": "workspace:*",
+    "tslib": "^2.8.1"
+  },
+  "bugs": "https://github.com/formatjs/formatjs/issues",
+  "homepage": "https://github.com/formatjs/formatjs#readme",
+  "keywords": [
+    "ecma402",
+    "enumerator",
+    "formatjs",
+    "i18n",
+    "intl",
+    "react-intl",
+    "supportedvaluesof",
+    "tc39"
+  ],
+  "repository": "formatjs/formatjs.git"
+}

package/polyfill-force.ts

@@ -0,0 +1,8 @@
+import {supportedValuesOf} from './src'
+
+Object.defineProperty(Intl, 'supportedValuesOf', {
+  value: supportedValuesOf,
+  enumerable: true,
+  writable: false,
+  configurable: false,
+})

package/polyfill.ts

@@ -0,0 +1,11 @@
+import {shouldPolyfill} from './should-polyfill.js'
+import {supportedValuesOf} from './src'
+
+if (shouldPolyfill()) {
+  Object.defineProperty(Intl, 'supportedValuesOf', {
+    value: supportedValuesOf,
+    enumerable: true,
+    writable: false,
+    configurable: false,
+  })
+}

package/scripts/calendars.ts

@@ -0,0 +1,21 @@
+import minimist from 'minimist'
+import {outputFileSync} from 'fs-extra/esm'
+import {keyword} from 'cldr-bcp47/bcp47/calendar.json'
+function main(args: minimist.ParsedArgs) {
+  const {out} = args
+  const calendars = Object.keys(keyword.u.ca).filter(k => !k.startsWith('_'))
+
+  // Output numbering systems file
+  outputFileSync(
+    out,
+    `/* @generated */
+// prettier-ignore
+export const calendars = ${JSON.stringify(calendars)} as const
+export type Calendar = typeof calendars[number]
+    `
+  )
+}
+
+if (require.main === module) {
+  main(minimist(process.argv))
+}

package/scripts/collations.ts

@@ -0,0 +1,21 @@
+import minimist from 'minimist'
+import {outputFileSync} from 'fs-extra/esm'
+import {keyword} from 'cldr-bcp47/bcp47/collation.json'
+function main(args: minimist.ParsedArgs) {
+  const {out} = args
+  const collations = Object.keys(keyword.u.co).filter(k => !k.startsWith('_'))
+
+  // Output numbering systems file
+  outputFileSync(
+    out,
+    `/* @generated */
+// prettier-ignore
+export const collations = ${JSON.stringify(collations)} as const
+export type Collation = typeof collations[number]
+    `
+  )
+}
+
+if (require.main === module) {
+  main(minimist(process.argv))
+}

package/scripts/currencies.ts

@@ -0,0 +1,21 @@
+import minimist from 'minimist'
+import {outputFileSync} from 'fs-extra/esm'
+import {main as data} from 'cldr-numbers-full/main/en/currencies.json'
+function main(args: minimist.ParsedArgs) {
+  const {out} = args
+  const currencies = Object.keys(data.en.numbers.currencies)
+
+  // Output numbering systems file
+  outputFileSync(
+    out,
+    `/* @generated */
+// prettier-ignore
+export const currencies = ${JSON.stringify(currencies)} as const
+export type Currency = typeof currencies[number]
+    `
+  )
+}
+
+if (require.main === module) {
+  main(minimist(process.argv))
+}

package/scripts/timezones.ts

@@ -0,0 +1,22 @@
+import minimist from 'minimist'
+import {outputFileSync} from 'fs-extra/esm'
+interface Args extends minimist.ParsedArgs {
+  zone: string[]
+}
+function main(args: Args) {
+  const {out, zone: timezones} = args
+
+  // Output numbering systems file
+  outputFileSync(
+    out,
+    `/* @generated */
+// prettier-ignore
+export const timezones = ${JSON.stringify(timezones)} as const
+export type Timezone = typeof timezones[number]
+    `
+  )
+}
+
+if (require.main === module) {
+  main(minimist<Args>(process.argv))
+}

package/scripts/units.ts

@@ -0,0 +1,23 @@
+import minimist from 'minimist'
+import {outputFileSync} from 'fs-extra/esm'
+import {SIMPLE_UNITS} from '@formatjs/ecma402-abstract'
+
+interface Args extends minimist.ParsedArgs {
+  zone: string[]
+}
+
+function main(args: Args) {
+  const {out} = args
+
+  outputFileSync(
+    out,
+    `/* @generated */
+// prettier-ignore
+export const units = ${JSON.stringify(SIMPLE_UNITS)} as const
+export type Unit = typeof units[number]`
+  )
+}
+
+if (require.main === module) {
+  main(minimist<Args>(process.argv))
+}

package/should-polyfill.ts

@@ -0,0 +1,3 @@
+export function shouldPolyfill(): boolean {
+  return !('supportedValuesOf' in Intl)
+}

package/src/calendars.generated.ts

@@ -0,0 +1,4 @@
+/* @generated */
+// prettier-ignore
+export const calendars = ["buddhist","chinese","coptic","dangi","ethioaa","ethiopic","gregory","hebrew","indian","islamic","islamic-civil","islamic-rgsa","islamic-tbla","islamic-umalqura","islamicc","iso8601","japanese","persian","roc"] as const
+export type Calendar = (typeof calendars)[number]

package/src/collations.generated.ts

@@ -0,0 +1,4 @@
+/* @generated */
+// prettier-ignore
+export const collations = ["big5han","compat","dict","direct","ducet","emoji","eor","gb2312","phonebk","phonetic","pinyin","reformed","search","searchjl","standard","stroke","trad","unihan","zhuyin"] as const
+export type Collation = (typeof collations)[number]

package/src/currencies.generated.ts

@@ -0,0 +1,4 @@
+/* @generated */
+// prettier-ignore
+export const currencies = ["ADP","AED","AFA","AFN","ALK","ALL","AMD","ANG","AOA","AOK","AON","AOR","ARA","ARL","ARM","ARP","ARS","ATS","AUD","AWG","AZM","AZN","BAD","BAM","BAN","BBD","BDT","BEC","BEF","BEL","BGL","BGM","BGN","BGO","BHD","BIF","BMD","BND","BOB","BOL","BOP","BOV","BRB","BRC","BRE","BRL","BRN","BRR","BRZ","BSD","BTN","BUK","BWP","BYB","BYN","BYR","BZD","CAD","CDF","CHE","CHF","CHW","CLE","CLF","CLP","CNH","CNX","CNY","COP","COU","CRC","CSD","CSK","CUC","CUP","CVE","CYP","CZK","DDM","DEM","DJF","DKK","DOP","DZD","ECS","ECV","EEK","EGP","ERN","ESA","ESB","ESP","ETB","EUR","FIM","FJD","FKP","FRF","GBP","GEK","GEL","GHC","GHS","GIP","GMD","GNF","GNS","GQE","GRD","GTQ","GWE","GWP","GYD","HKD","HNL","HRD","HRK","HTG","HUF","IDR","IEP","ILP","ILR","ILS","INR","IQD","IRR","ISJ","ISK","ITL","JMD","JOD","JPY","KES","KGS","KHR","KMF","KPW","KRH","KRO","KRW","KWD","KYD","KZT","LAK","LBP","LKR","LRD","LSL","LTL","LTT","LUC","LUF","LUL","LVL","LVR","LYD","MAD","MAF","MCF","MDC","MDL","MGA","MGF","MKD","MKN","MLF","MMK","MNT","MOP","MRO","MRU","MTL","MTP","MUR","MVP","MVR","MWK","MXN","MXP","MXV","MYR","MZE","MZM","MZN","NAD","NGN","NIC","NIO","NLG","NOK","NPR","NZD","OMR","PAB","PEI","PEN","PES","PGK","PHP","PKR","PLN","PLZ","PTE","PYG","QAR","RHD","ROL","RON","RSD","RUB","RUR","RWF","SAR","SBD","SCR","SDD","SDG","SDP","SEK","SGD","SHP","SIT","SKK","SLE","SLL","SOS","SRD","SRG","SSP","STD","STN","SUR","SVC","SYP","SZL","THB","TJR","TJS","TMM","TMT","TND","TOP","TPE","TRL","TRY","TTD","TWD","TZS","UAH","UAK","UGS","UGX","USD","USN","USS","UYI","UYP","UYU","UYW","UZS","VEB","VED","VEF","VES","VND","VNN","VUV","WST","XAF","XAG","XAU","XBA","XBB","XBC","XBD","XCD","XCG","XDR","XEU","XFO","XFU","XOF","XPD","XPF","XPT","XRE","XSU","XTS","XUA","XXX","YDD","YER","YUD","YUM","YUN","YUR","ZAL","ZAR","ZMK","ZMW","ZRN","ZRZ","ZWD","ZWG","ZWL","ZWR"] as const
+export type Currency = (typeof currencies)[number]

package/src/get-supported-calendars.ts

@@ -0,0 +1,32 @@
+import {createMemoizedDateTimeFormat} from './memoize.js'
+import type {Calendar} from './calendars.generated.js'
+import {calendars} from './calendars.generated.js'
+
+/**
+ * Implementation: Tests if a calendar is supported by attempting to create
+ * a DateTimeFormat with that calendar and verifying it was accepted.
+ *
+ * CLDR Data: Candidate values come from CLDR calendar types
+ */
+function isSupportedCalendar(item: Calendar): boolean {
+  try {
+    // Always use 'en' for testing
+    const dateTimeFormat = createMemoizedDateTimeFormat(`en-u-ca-${item}`)
+    const options = dateTimeFormat.resolvedOptions().calendar
+
+    // Verify the calendar was actually accepted (resolved calendar matches requested)
+    return options === item
+  } catch {}
+
+  return false
+}
+
+/**
+ * ECMA-402 Spec: Returns supported calendar identifiers
+ * ECMA-402 Spec: Results must be sorted lexicographically
+ *
+ * Implementation: Filters CLDR list against actual runtime support
+ */
+export function getSupportedCalendars(): Calendar[] {
+  return calendars.filter(isSupportedCalendar).sort()
+}

package/src/get-supported-collations.ts

@@ -0,0 +1,30 @@
+import type {Collation} from './collations.generated.js'
+import {collations} from './collations.generated.js'
+
+/**
+ * Implementation: Tests if a collation is supported by attempting to create
+ * a Collator with that collation and verifying it was accepted.
+ *
+ * CLDR Data: Candidate values come from CLDR collation types
+ */
+function isSupportedCollation(collation: Collation): boolean {
+  try {
+    // Always use 'en' for testing
+    return (
+      Intl.Collator(`en-u-co-${collation}`).resolvedOptions().collation ===
+      collation
+    )
+  } catch {}
+
+  return false
+}
+
+/**
+ * ECMA-402 Spec: Returns supported collation identifiers
+ * ECMA-402 Spec: Results must be sorted lexicographically
+ *
+ * Implementation: Filters CLDR list against actual runtime support
+ */
+export function getSupportedCollations(): Collation[] {
+  return collations.filter(isSupportedCollation).sort()
+}

package/src/get-supported-currencies.ts

@@ -0,0 +1,62 @@
+import {createMemoizedNumberFormat} from '@formatjs/ecma402-abstract'
+import type {Currency} from './currencies.generated.js'
+import {currencies} from './currencies.generated.js'
+
+/**
+ * Implementation: Tests if a currency is supported by attempting to create
+ * a NumberFormat with that currency and verifying it was accepted.
+ *
+ * CLDR Data: Candidate values come from CLDR currency codes (ISO 4217)
+ */
+function isSupportedCurrency(currency: Currency): boolean {
+  try {
+    // Always use 'en' for testing
+    const numberFormat = createMemoizedNumberFormat('en', {
+      style: 'currency',
+      currencyDisplay: 'name',
+      currency,
+    })
+
+    const format = numberFormat.format(123)
+
+    if (
+      format.substring(0, 3) !== currency &&
+      format.substring(format.length - 3) !== currency
+    ) {
+      return true
+    }
+  } catch {}
+
+  return false
+}
+
+/**
+ * ECMA-402 Spec: Returns supported currency identifiers
+ * ECMA-402 Spec: Results must be sorted lexicographically
+ *
+ * Implementation: Filters CLDR list against actual runtime support
+ */
+export function getSupportedCurrencies(): Currency[] {
+  const ATOZ = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ'
+  const supportedCurrencies: Currency[] = []
+
+  for (const currency of currencies) {
+    if (currency.length === 3) {
+      if (isSupportedCurrency(currency)) {
+        supportedCurrencies.push(currency)
+      }
+    } else if (currency.length === 5 && currency[3] === '~') {
+      const start = ATOZ.indexOf(currency[2])
+      const end = ATOZ.indexOf(currency[4])
+
+      for (let i = start; i <= end; i++) {
+        const currentCurrency = (currency.substring(0, 2) + ATOZ[i]) as Currency
+        if (isSupportedCurrency(currentCurrency)) {
+          supportedCurrencies.push(currentCurrency)
+        }
+      }
+    }
+  }
+
+  return supportedCurrencies.sort()
+}

package/src/get-supported-numbering-systems.ts

@@ -0,0 +1,35 @@
+import {createMemoizedNumberFormat} from '@formatjs/ecma402-abstract'
+import {numberingSystemNames} from './numbering-systems.generated.js'
+
+/**
+ * Implementation: Tests if a numbering system is supported by attempting to create
+ * a NumberFormat with that numbering system and verifying it was accepted.
+ *
+ * CLDR Data: Candidate values come from CLDR numbering system types
+ */
+function isSupportedNumberingSystem(system: string): boolean {
+  try {
+    // Always use 'en' for testing
+    const numberFormat = createMemoizedNumberFormat(`en-u-nu-${system}`)
+    const options = numberFormat.resolvedOptions().numberingSystem
+
+    if (
+      (options === system && system === 'latn') ||
+      numberFormat.format(123) !== '123'
+    ) {
+      return true
+    }
+  } catch {}
+
+  return false
+}
+
+/**
+ * ECMA-402 Spec: Returns supported numbering system identifiers
+ * ECMA-402 Spec: Results must be sorted lexicographically
+ *
+ * Implementation: Filters CLDR list against actual runtime support
+ */
+export function getSupportedNumberingSystems(): string[] {
+  return numberingSystemNames.filter(isSupportedNumberingSystem).sort()
+}

package/src/get-supported-timezones.ts

@@ -0,0 +1,29 @@
+import {createMemoizedDateTimeFormat} from './memoize.js'
+import type {Timezone} from './timezones.generated.js'
+import {timezones} from './timezones.generated.js'
+
+/**
+ * Implementation: Tests if a timezone is supported by attempting to create
+ * a DateTimeFormat with that timezone and verifying it was accepted.
+ *
+ * CLDR Data: Candidate values come from IANA Time Zone Database
+ */
+function isSupportedTimeZone(timeZone: Timezone): boolean {
+  try {
+    // Always use 'en' for testing
+    const formatter = createMemoizedDateTimeFormat('en', {timeZone})
+    return formatter.resolvedOptions().timeZone === timeZone
+  } catch {}
+
+  return false
+}
+
+/**
+ * ECMA-402 Spec: Returns supported timezone identifiers
+ * ECMA-402 Spec: Results must be sorted lexicographically
+ *
+ * Implementation: Filters CLDR list against actual runtime support
+ */
+export function getSupportedTimeZones(): Timezone[] {
+  return timezones.filter(isSupportedTimeZone).sort()
+}

package/src/get-supported-units.ts

@@ -0,0 +1,73 @@
+import {createMemoizedNumberFormat} from '@formatjs/ecma402-abstract'
+import type {Unit} from './units.generated.js'
+import {units} from './units.generated.js'
+
+/**
+ * Implementation: Tests if a unit is supported by attempting to create
+ * a NumberFormat with that unit and verifying it was accepted.
+ *
+ * CLDR Data: Candidate values come from CLDR unit types
+ */
+function isSupportedUnit(unit: Unit): boolean {
+  try {
+    // Always use 'en' for testing
+    const formatter = createMemoizedNumberFormat('en', {style: 'unit', unit})
+    return formatter.resolvedOptions().unit === unit
+  } catch {}
+
+  return false
+}
+
+/**
+ * ECMA-402 Spec: Returns supported unit identifiers
+ * ECMA-402 Spec: Results must be sorted lexicographically
+ *
+ * Implementation: Filters CLDR list against actual runtime support
+ */
+export function getSupportedUnits(): (
+  | 'degree'
+  | 'acre'
+  | 'hectare'
+  | 'percent'
+  | 'bit'
+  | 'byte'
+  | 'gigabit'
+  | 'gigabyte'
+  | 'kilobit'
+  | 'kilobyte'
+  | 'megabit'
+  | 'megabyte'
+  | 'petabyte'
+  | 'terabit'
+  | 'terabyte'
+  | 'day'
+  | 'hour'
+  | 'millisecond'
+  | 'minute'
+  | 'month'
+  | 'second'
+  | 'week'
+  | 'year'
+  | 'centimeter'
+  | 'foot'
+  | 'inch'
+  | 'kilometer'
+  | 'meter'
+  | 'mile-scandinavian'
+  | 'mile'
+  | 'millimeter'
+  | 'yard'
+  | 'gram'
+  | 'kilogram'
+  | 'ounce'
+  | 'pound'
+  | 'stone'
+  | 'celsius'
+  | 'fahrenheit'
+  | 'fluid-ounce'
+  | 'gallon'
+  | 'liter'
+  | 'milliliter'
+)[] {
+  return units.filter(isSupportedUnit).sort()
+}

package/src/index.ts

@@ -0,0 +1,75 @@
+import {getSupportedCalendars} from './get-supported-calendars.js'
+import {getSupportedCollations} from './get-supported-collations.js'
+import {getSupportedCurrencies} from './get-supported-currencies.js'
+import {getSupportedNumberingSystems} from './get-supported-numbering-systems.js'
+import {getSupportedTimeZones} from './get-supported-timezones.js'
+import {getSupportedUnits} from './get-supported-units.js'
+
+/**
+ * ECMA-402 Spec: Intl.supportedValuesOf
+ * https://tc39.es/ecma402/#sec-intl.supportedvaluesof
+ */
+declare global {
+  namespace Intl {
+    /**
+     * Returns an array containing the supported values for the given key.
+     * @param key - The category of values to return
+     * @returns A sorted array of strings
+     */
+    function supportedValuesOf(
+      key:
+        | 'calendar'
+        | 'collation'
+        | 'currency'
+        | 'numberingSystem'
+        | 'timeZone'
+        | 'unit'
+    ): string[]
+  }
+}
+
+/**
+ * ECMA-402 Spec: Supported value categories
+ */
+export type SupportedValuesOf =
+  | 'calendar'
+  | 'collation'
+  | 'currency'
+  | 'numberingSystem'
+  | 'timeZone'
+  | 'unit'
+
+/**
+ * ECMA-402 Spec: Intl.supportedValuesOf(key)
+ * https://tc39.es/ecma402/#sec-intl.supportedvaluesof
+ *
+ * Returns an array containing the supported calendar, collation, currency,
+ * numbering systems, time zone, or unit values supported by the implementation.
+ *
+ * Implementation: We validate candidate values from CLDR against the actual
+ * Intl formatters to determine runtime support rather than using static lists.
+ * This ensures accuracy across different JavaScript engines and runtimes.
+ *
+ * @param key - The category of values to return
+ * @returns A sorted array of unique string values
+ */
+export function supportedValuesOf(key: SupportedValuesOf): string[] {
+  // ECMA-402 Spec: Dispatch to appropriate getter based on key
+  switch (key) {
+    case 'calendar':
+      return getSupportedCalendars()
+    case 'collation':
+      return getSupportedCollations()
+    case 'currency':
+      return getSupportedCurrencies()
+    case 'numberingSystem':
+      return getSupportedNumberingSystems()
+    case 'timeZone':
+      return getSupportedTimeZones()
+    case 'unit':
+      return getSupportedUnits()
+    default:
+      // ECMA-402 Spec: Throw RangeError for invalid keys
+      throw RangeError('Invalid key: ' + key)
+  }
+}

package/src/memoize.ts

@@ -0,0 +1,19 @@
+import {memoize, strategies} from '@formatjs/fast-memoize'
+
+/**
+ * Implementation: Memoized factory for Intl.DateTimeFormat instances
+ *
+ * Creates and caches DateTimeFormat instances to avoid repeated instantiation overhead.
+ * This is critical for performance since we test many candidate values against formatters.
+ *
+ * Uses variadic memoization strategy to handle varying numbers of constructor arguments.
+ */
+export const createMemoizedDateTimeFormat: (
+  ...args: ConstructorParameters<typeof Intl.DateTimeFormat>
+) => Intl.DateTimeFormat = memoize(
+  (...args: ConstructorParameters<typeof Intl.DateTimeFormat>) =>
+    new Intl.DateTimeFormat(...args),
+  {
+    strategy: strategies.variadic,
+  }
+)

package/src/numbering-systems.generated.ts

@@ -0,0 +1,99 @@
+export const numberingSystemNames: ReadonlyArray<string> = [
+  'adlm',
+  'ahom',
+  'arab',
+  'arabext',
+  'armn',
+  'armnlow',
+  'bali',
+  'beng',
+  'bhks',
+  'brah',
+  'cakm',
+  'cham',
+  'cyrl',
+  'deva',
+  'diak',
+  'ethi',
+  'fullwide',
+  'gara',
+  'geor',
+  'gong',
+  'gonm',
+  'grek',
+  'greklow',
+  'gujr',
+  'gukh',
+  'guru',
+  'hanidays',
+  'hanidec',
+  'hans',
+  'hansfin',
+  'hant',
+  'hantfin',
+  'hebr',
+  'hmng',
+  'hmnp',
+  'java',
+  'jpan',
+  'jpanfin',
+  'jpanyear',
+  'kali',
+  'kawi',
+  'khmr',
+  'knda',
+  'krai',
+  'lana',
+  'lanatham',
+  'laoo',
+  'latn',
+  'lepc',
+  'limb',
+  'mathbold',
+  'mathdbl',
+  'mathmono',
+  'mathsanb',
+  'mathsans',
+  'mlym',
+  'modi',
+  'mong',
+  'mroo',
+  'mtei',
+  'mymr',
+  'mymrepka',
+  'mymrpao',
+  'mymrshan',
+  'mymrtlng',
+  'nagm',
+  'newa',
+  'nkoo',
+  'olck',
+  'onao',
+  'orya',
+  'osma',
+  'outlined',
+  'rohg',
+  'roman',
+  'romanlow',
+  'saur',
+  'segment',
+  'shrd',
+  'sind',
+  'sinh',
+  'sora',
+  'sund',
+  'sunu',
+  'takr',
+  'talu',
+  'taml',
+  'tamldec',
+  'telu',
+  'thai',
+  'tibt',
+  'tirh',
+  'tnsa',
+  'tols',
+  'vaii',
+  'wara',
+  'wcho',
+]