@formatjs/intl-localematcher 0.2.25 → 0.2.29

package/BUILD

@@ -0,0 +1,73 @@
+load("@aspect_bazel_lib//lib:write_source_files.bzl", "write_source_files")
+load("@aspect_rules_js//npm/private:npm_package.bzl", "npm_package")
+load("@aspect_rules_ts//ts:defs.bzl", "ts_project")
+load("//tools:index.bzl", "check_format", "package_json_test", "ts_compile")
+load("//tools:jest.bzl", "jest_test")
+
+PACKAGE_NAME = "intl-localematcher"
+
+npm_package(
+    name = PACKAGE_NAME,
+    srcs = [
+        "LICENSE.md",
+        "README.md",
+        "package.json",
+        ":dist",
+    ],
+    package = "@formatjs/%s" % PACKAGE_NAME,
+    visibility = ["//visibility:public"],
+)
+
+SRCS = glob(
+    ["**/*.ts"],
+    exclude = ["tests/*"],
+)
+
+ts_compile(
+    name = "dist",
+    srcs = SRCS,
+    package = "@formatjs/%s" % PACKAGE_NAME,
+    skip_esm = False,
+)
+
+jest_test(
+    name = "unit",
+    srcs = SRCS + glob([
+        "tests/**/*.ts",
+        "tests/**/*.tsx",
+        "tests/**/*.snap",
+    ]),
+)
+
+# Test262
+ts_project(
+    name = "test262-main-bundle",
+    srcs = SRCS,
+    declaration = True,
+    declaration_map = True,
+    extends = "//:tsconfig",
+    out_dir = "test262",
+    resolve_json_module = True,
+    tsconfig = "//:tsconfig.es6",
+)
+
+write_source_files(
+    name = "tsconfig_json",
+    files = {"tsconfig.json": "//tools:tsconfig.golden.json"},
+)
+
+check_format(
+    name = "prettier",
+    srcs = glob(
+        [
+            "**/*",
+        ],
+        exclude = [
+            "CHANGELOG.md",
+        ],
+    ),
+)
+
+package_json_test(
+    name = "package_json_test",
+)

package/CHANGELOG.md

@@ -0,0 +1,150 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+## [0.2.29](https://github.com/formatjs/formatjs/compare/@formatjs/intl-localematcher@0.2.28...@formatjs/intl-localematcher@0.2.29) (2022-08-18)
+
+**Note:** Version bump only for package @formatjs/intl-localematcher
+
+## [0.2.28](https://github.com/formatjs/formatjs/compare/@formatjs/intl-localematcher@0.2.27...@formatjs/intl-localematcher@0.2.28) (2022-06-06)
+
+**Note:** Version bump only for package @formatjs/intl-localematcher
+
+## [0.2.27](https://github.com/formatjs/formatjs/compare/@formatjs/intl-localematcher@0.2.26...@formatjs/intl-localematcher@0.2.27) (2022-05-19)
+
+**Note:** Version bump only for package @formatjs/intl-localematcher
+
+## [0.2.26](https://github.com/formatjs/formatjs/compare/@formatjs/intl-localematcher@0.2.25...@formatjs/intl-localematcher@0.2.26) (2022-05-19)
+
+### Bug Fixes
+
+* **react-intl:** fix type issue with react18, fix [#3550](https://github.com/formatjs/formatjs/issues/3550) ([2567b93](https://github.com/formatjs/formatjs/commit/2567b932c5d18b097a43842563046c20ce0c49f1))
+
+## [0.2.25](https://github.com/formatjs/formatjs/compare/@formatjs/intl-localematcher@0.2.24...@formatjs/intl-localematcher@0.2.25) (2022-03-26)
+
+### Bug Fixes
+
+* **@formatjs/intl-localematcher:** adds module field to package.json, fixes [#3456](https://github.com/formatjs/formatjs/issues/3456) ([#3457](https://github.com/formatjs/formatjs/issues/3457)) ([e805d9e](https://github.com/formatjs/formatjs/commit/e805d9e29bae0298a081f760e90c8c5d2dd1aa7c))
+
+## [0.2.24](https://github.com/formatjs/formatjs/compare/@formatjs/intl-localematcher@0.2.23...@formatjs/intl-localematcher@0.2.24) (2022-02-06)
+
+### Bug Fixes
+
+* **@formatjs/intl-localematcher:** prioritize locale in front of canonicalized/minimized locale, fix [#3405](https://github.com/formatjs/formatjs/issues/3405) ([81fa22a](https://github.com/formatjs/formatjs/commit/81fa22a87d42362f4d4d8406429f3161a977cd42))
+
+## [0.2.23](https://github.com/formatjs/formatjs/compare/@formatjs/intl-localematcher@0.2.22...@formatjs/intl-localematcher@0.2.23) (2022-01-24)
+
+### Bug Fixes
+
+* **@formatjs/intl-localematcher:** fix best fit to account for canonicalization ([cacad92](https://github.com/formatjs/formatjs/commit/cacad921ed4eb2f608979fe03b8cdcd3d1719766))
+
+## [0.2.22](https://github.com/formatjs/formatjs/compare/@formatjs/intl-localematcher@0.2.21...@formatjs/intl-localematcher@0.2.22) (2022-01-03)
+
+### Bug Fixes
+
+* **@formatjs/intl-localematcher:** iterate through set instead of Array.from so we dont rely on polyfill ([2114518](https://github.com/formatjs/formatjs/commit/211451805d09aae543a8a0aeae1b62a179aaae07))
+
+## [0.2.21](https://github.com/formatjs/formatjs/compare/@formatjs/intl-localematcher@0.2.20...@formatjs/intl-localematcher@0.2.21) (2021-09-27)
+
+**Note:** Version bump only for package @formatjs/intl-localematcher
+
+## [0.2.20](https://github.com/formatjs/formatjs/compare/@formatjs/intl-localematcher@0.2.19...@formatjs/intl-localematcher@0.2.20) (2021-08-15)
+
+**Note:** Version bump only for package @formatjs/intl-localematcher
+
+## [0.2.19](https://github.com/formatjs/formatjs/compare/@formatjs/intl-localematcher@0.2.18...@formatjs/intl-localematcher@0.2.19) (2021-08-06)
+
+**Note:** Version bump only for package @formatjs/intl-localematcher
+
+## [0.2.18](https://github.com/formatjs/formatjs/compare/@formatjs/intl-localematcher@0.2.17...@formatjs/intl-localematcher@0.2.18) (2021-07-24)
+
+### Bug Fixes
+
+* **@formatjs/intl-localematcher:** fix best fit algo, fix [#3058](https://github.com/formatjs/formatjs/issues/3058) ([c9dad00](https://github.com/formatjs/formatjs/commit/c9dad0081ba57792b3cdcf6bc1a02c5dc3f57dc1))
+* **@formatjs/intl-localematcher:** refactor and consolidate files ([1d1a4bc](https://github.com/formatjs/formatjs/commit/1d1a4bc6e5ccbf7be774d4f0f4b2ef2c7fa334b5))
+
+## [0.2.17](https://github.com/formatjs/formatjs/compare/@formatjs/intl-localematcher@0.2.16...@formatjs/intl-localematcher@0.2.17) (2021-07-20)
+
+### Bug Fixes
+
+* **@formatjs/intl-localematcher:** Correct path to main file for @formatjs/intl-localematcher ([#3057](https://github.com/formatjs/formatjs/issues/3057)) ([e2267bb](https://github.com/formatjs/formatjs/commit/e2267bbc2645d007ccbae8dfa77bc7ad422cfde2))
+
+## [0.2.16](https://github.com/formatjs/formatjs/compare/@formatjs/intl-localematcher@0.2.15...@formatjs/intl-localematcher@0.2.16) (2021-06-26)
+
+**Note:** Version bump only for package @formatjs/intl-localematcher
+
+## [0.2.15](https://github.com/formatjs/formatjs/compare/@formatjs/intl-localematcher@0.2.14...@formatjs/intl-localematcher@0.2.15) (2021-06-05)
+
+**Note:** Version bump only for package @formatjs/intl-localematcher
+
+## [0.2.14](https://github.com/formatjs/formatjs/compare/@formatjs/intl-localematcher@0.2.13...@formatjs/intl-localematcher@0.2.14) (2021-06-01)
+
+**Note:** Version bump only for package @formatjs/intl-localematcher
+
+## [0.2.13](https://github.com/formatjs/formatjs/compare/@formatjs/intl-localematcher@0.2.12...@formatjs/intl-localematcher@0.2.13) (2021-05-23)
+
+**Note:** Version bump only for package @formatjs/intl-localematcher
+
+## [0.2.12](https://github.com/formatjs/formatjs/compare/@formatjs/intl-localematcher@0.2.11...@formatjs/intl-localematcher@0.2.12) (2021-05-20)
+
+**Note:** Version bump only for package @formatjs/intl-localematcher
+
+## [0.2.11](https://github.com/formatjs/formatjs/compare/@formatjs/intl-localematcher@0.2.10...@formatjs/intl-localematcher@0.2.11) (2021-05-17)
+
+**Note:** Version bump only for package @formatjs/intl-localematcher
+
+## [0.2.10](https://github.com/formatjs/formatjs/compare/@formatjs/intl-localematcher@0.2.9...@formatjs/intl-localematcher@0.2.10) (2021-05-10)
+
+**Note:** Version bump only for package @formatjs/intl-localematcher
+
+## [0.2.9](https://github.com/formatjs/formatjs/compare/@formatjs/intl-localematcher@0.2.8...@formatjs/intl-localematcher@0.2.9) (2021-04-26)
+
+**Note:** Version bump only for package @formatjs/intl-localematcher
+
+## [0.2.8](https://github.com/formatjs/formatjs/compare/@formatjs/intl-localematcher@0.2.7...@formatjs/intl-localematcher@0.2.8) (2021-04-12)
+
+**Note:** Version bump only for package @formatjs/intl-localematcher
+
+## [0.2.7](https://github.com/formatjs/formatjs/compare/@formatjs/intl-localematcher@0.2.6...@formatjs/intl-localematcher@0.2.7) (2021-03-26)
+
+**Note:** Version bump only for package @formatjs/intl-localematcher
+
+## [0.2.6](https://github.com/formatjs/formatjs/compare/@formatjs/intl-localematcher@0.2.5...@formatjs/intl-localematcher@0.2.6) (2021-03-15)
+
+**Note:** Version bump only for package @formatjs/intl-localematcher
+
+## [0.2.5](https://github.com/formatjs/formatjs/compare/@formatjs/intl-localematcher@0.2.4...@formatjs/intl-localematcher@0.2.5) (2021-03-01)
+
+**Note:** Version bump only for package @formatjs/intl-localematcher
+
+## [0.2.4](https://github.com/formatjs/formatjs/compare/@formatjs/intl-localematcher@0.2.3...@formatjs/intl-localematcher@0.2.4) (2021-02-25)
+
+### Bug Fixes
+
+* bump tslib version dep ([37577d2](https://github.com/formatjs/formatjs/commit/37577d22bf28d23de1d8013ba0047cf221ad8840)), closes [#2645](https://github.com/formatjs/formatjs/issues/2645)
+
+## [0.2.3](https://github.com/formatjs/formatjs/compare/@formatjs/intl-localematcher@0.2.2...@formatjs/intl-localematcher@0.2.3) (2021-02-25)
+
+**Note:** Version bump only for package @formatjs/intl-localematcher
+
+## [0.2.2](https://github.com/formatjs/formatjs/compare/@formatjs/intl-localematcher@0.2.1...@formatjs/intl-localematcher@0.2.2) (2021-02-22)
+
+**Note:** Version bump only for package @formatjs/intl-localematcher
+
+## [0.2.1](https://github.com/formatjs/formatjs/compare/@formatjs/intl-localematcher@0.2.0...@formatjs/intl-localematcher@0.2.1) (2021-02-21)
+
+**Note:** Version bump only for package @formatjs/intl-localematcher
+
+# [0.2.0](https://github.com/formatjs/formatjs/compare/@formatjs/intl-localematcher@0.1.0...@formatjs/intl-localematcher@0.2.0) (2021-02-08)
+
+### Features
+
+* **@formatjs/intl-localematcher:** switch entry point to prepackaged UMD file ([a0481cc](https://github.com/formatjs/formatjs/commit/a0481cc79e95960b540cafc541d555a5c228851f))
+
+# 0.1.0 (2021-02-08)
+
+### Features
+
+* **@formatjs/intl-localematcher:** add ponyfill for Intl.LocaleMatcher ([e479543](https://github.com/formatjs/formatjs/commit/e479543e92e9b6c6d08f68848f25bcb9ba558ab3))
+* **@formatjs/intl-localematcher:** reset version ([7684b54](https://github.com/formatjs/formatjs/commit/7684b543fa7c3db3aad839bae8485ec7de4ee495))

package/abstract/BestAvailableLocale.ts

@@ -0,0 +1,24 @@
+/**
+ * https://tc39.es/ecma402/#sec-bestavailablelocale
+ * @param availableLocales
+ * @param locale
+ */
+export function BestAvailableLocale(
+  availableLocales: Set<String>,
+  locale: string
+) {
+  let candidate = locale
+  while (true) {
+    if (availableLocales.has(candidate)) {
+      return candidate
+    }
+    let pos = candidate.lastIndexOf('-')
+    if (!~pos) {
+      return undefined
+    }
+    if (pos >= 2 && candidate[pos - 2] === '-') {
+      pos -= 2
+    }
+    candidate = candidate.slice(0, pos)
+  }
+}

package/abstract/BestFitMatcher.ts

@@ -0,0 +1,80 @@
+import {BestAvailableLocale} from './BestAvailableLocale'
+import {LookupMatcherResult} from './types'
+import {UNICODE_EXTENSION_SEQUENCE_REGEX} from './utils'
+
+/**
+ * https://tc39.es/ecma402/#sec-bestfitmatcher
+ * @param availableLocales
+ * @param requestedLocales
+ * @param getDefaultLocale
+ */
+export function BestFitMatcher(
+  availableLocales: Set<string>,
+  requestedLocales: string[],
+  getDefaultLocale: () => string
+): LookupMatcherResult {
+  const minimizedAvailableLocaleMap: Record<string, string> = {}
+  const availableLocaleMap: Record<string, string> = {}
+  const canonicalizedLocaleMap: Record<string, string> = {}
+  const minimizedAvailableLocales: Set<string> = new Set()
+  availableLocales.forEach(locale => {
+    const minimizedLocale = new (Intl as any).Locale(locale)
+      .minimize()
+      .toString()
+
+    const canonicalizedLocale =
+      (Intl as any).getCanonicalLocales(locale)[0] || locale
+
+    minimizedAvailableLocaleMap[minimizedLocale] = locale
+    availableLocaleMap[locale] = locale
+    canonicalizedLocaleMap[canonicalizedLocale] = locale
+    minimizedAvailableLocales.add(minimizedLocale)
+    minimizedAvailableLocales.add(locale)
+    minimizedAvailableLocales.add(canonicalizedLocale)
+  })
+
+  let foundLocale: string | undefined
+  for (const l of requestedLocales) {
+    if (foundLocale) {
+      break
+    }
+    const noExtensionLocale = l.replace(UNICODE_EXTENSION_SEQUENCE_REGEX, '')
+
+    if (availableLocales.has(noExtensionLocale)) {
+      foundLocale = noExtensionLocale
+      break
+    }
+
+    if (minimizedAvailableLocales.has(noExtensionLocale)) {
+      foundLocale = noExtensionLocale
+      break
+    }
+
+    const locale = new (Intl as any).Locale(noExtensionLocale)
+
+    const maximizedRequestedLocale = locale.maximize().toString()
+    const minimizedRequestedLocale = locale.minimize().toString()
+
+    // Check minimized locale
+    if (minimizedAvailableLocales.has(minimizedRequestedLocale)) {
+      foundLocale = minimizedRequestedLocale
+      break
+    }
+
+    // Lookup algo on maximized locale
+    foundLocale = BestAvailableLocale(
+      minimizedAvailableLocales,
+      maximizedRequestedLocale
+    )
+  }
+  if (!foundLocale) {
+    return {locale: getDefaultLocale()}
+  }
+  return {
+    locale:
+      availableLocaleMap[foundLocale] ||
+      canonicalizedLocaleMap[foundLocale] ||
+      minimizedAvailableLocaleMap[foundLocale] ||
+      foundLocale,
+  }
+}

package/abstract/CanonicalizeLocaleList.ts

@@ -0,0 +1,8 @@
+/**
+ * http://ecma-international.org/ecma-402/7.0/index.html#sec-canonicalizelocalelist
+ * @param locales
+ */
+export function CanonicalizeLocaleList(locales?: string | string[]): string[] {
+  // TODO
+  return ((Intl as any).getCanonicalLocales as any)(locales)
+}

package/abstract/LookupMatcher.ts

@@ -0,0 +1,39 @@
+import {UNICODE_EXTENSION_SEQUENCE_REGEX} from './utils'
+import {BestAvailableLocale} from './BestAvailableLocale'
+import {LookupMatcherResult} from './types'
+
+/**
+ * https://tc39.es/ecma402/#sec-lookupmatcher
+ * @param availableLocales
+ * @param requestedLocales
+ * @param getDefaultLocale
+ */
+export function LookupMatcher(
+  availableLocales: Set<string>,
+  requestedLocales: string[],
+  getDefaultLocale: () => string
+): LookupMatcherResult {
+  const result: LookupMatcherResult = {locale: ''}
+  for (const locale of requestedLocales) {
+    const noExtensionLocale = locale.replace(
+      UNICODE_EXTENSION_SEQUENCE_REGEX,
+      ''
+    )
+    const availableLocale = BestAvailableLocale(
+      availableLocales,
+      noExtensionLocale
+    )
+    if (availableLocale) {
+      result.locale = availableLocale
+      if (locale !== noExtensionLocale) {
+        result.extension = locale.slice(
+          noExtensionLocale.length + 1,
+          locale.length
+        )
+      }
+      return result
+    }
+  }
+  result.locale = getDefaultLocale()
+  return result
+}

package/abstract/LookupSupportedLocales.ts

@@ -0,0 +1,28 @@
+import {UNICODE_EXTENSION_SEQUENCE_REGEX} from './utils'
+import {BestAvailableLocale} from './BestAvailableLocale'
+
+/**
+ * https://tc39.es/ecma402/#sec-lookupsupportedlocales
+ * @param availableLocales
+ * @param requestedLocales
+ */
+export function LookupSupportedLocales(
+  availableLocales: Set<string>,
+  requestedLocales: string[]
+) {
+  const subset: string[] = []
+  for (const locale of requestedLocales) {
+    const noExtensionLocale = locale.replace(
+      UNICODE_EXTENSION_SEQUENCE_REGEX,
+      ''
+    )
+    const availableLocale = BestAvailableLocale(
+      availableLocales,
+      noExtensionLocale
+    )
+    if (availableLocale) {
+      subset.push(availableLocale)
+    }
+  }
+  return subset
+}

package/abstract/ResolveLocale.ts

@@ -0,0 +1,100 @@
+import {LookupMatcherResult} from './types'
+import {LookupMatcher} from './LookupMatcher'
+import {BestFitMatcher} from './BestFitMatcher'
+import {invariant} from './utils'
+import {UnicodeExtensionValue} from './UnicodeExtensionValue'
+
+export interface ResolveLocaleResult {
+  locale: string
+  dataLocale: string
+  [k: string]: any
+}
+
+/**
+ * https://tc39.es/ecma402/#sec-resolvelocale
+ */
+export function ResolveLocale<K extends string, D extends {[k in K]: any}>(
+  availableLocales: Set<string>,
+  requestedLocales: string[],
+  options: {localeMatcher: string; [k: string]: string},
+  relevantExtensionKeys: K[],
+  localeData: Record<string, D | undefined>,
+  getDefaultLocale: () => string
+): ResolveLocaleResult {
+  const matcher = options.localeMatcher
+  let r: LookupMatcherResult
+  if (matcher === 'lookup') {
+    r = LookupMatcher(availableLocales, requestedLocales, getDefaultLocale)
+  } else {
+    r = BestFitMatcher(availableLocales, requestedLocales, getDefaultLocale)
+  }
+  let foundLocale = r.locale
+  const result: ResolveLocaleResult = {locale: '', dataLocale: foundLocale}
+  let supportedExtension = '-u'
+  for (const key of relevantExtensionKeys) {
+    invariant(
+      foundLocale in localeData,
+      `Missing locale data for ${foundLocale}`
+    )
+    const foundLocaleData = localeData[foundLocale]
+    invariant(
+      typeof foundLocaleData === 'object' && foundLocaleData !== null,
+      `locale data ${key} must be an object`
+    )
+    const keyLocaleData = foundLocaleData[key]
+    invariant(
+      Array.isArray(keyLocaleData),
+      `keyLocaleData for ${key} must be an array`
+    )
+    let value = keyLocaleData[0]
+    invariant(
+      typeof value === 'string' || value === null,
+      `value must be string or null but got ${typeof value} in key ${key}`
+    )
+    let supportedExtensionAddition = ''
+    if (r.extension) {
+      const requestedValue = UnicodeExtensionValue(r.extension, key)
+      if (requestedValue !== undefined) {
+        if (requestedValue !== '') {
+          if (~keyLocaleData.indexOf(requestedValue)) {
+            value = requestedValue
+            supportedExtensionAddition = `-${key}-${value}`
+          }
+        } else if (~requestedValue.indexOf('true')) {
+          value = 'true'
+          supportedExtensionAddition = `-${key}`
+        }
+      }
+    }
+    if (key in options) {
+      const optionsValue = options[key]
+      invariant(
+        typeof optionsValue === 'string' ||
+          typeof optionsValue === 'undefined' ||
+          optionsValue === null,
+        'optionsValue must be String, Undefined or Null'
+      )
+      if (~keyLocaleData.indexOf(optionsValue)) {
+        if (optionsValue !== value) {
+          value = optionsValue
+          supportedExtensionAddition = ''
+        }
+      }
+    }
+    result[key] = value
+    supportedExtension += supportedExtensionAddition
+  }
+  if (supportedExtension.length > 2) {
+    const privateIndex = foundLocale.indexOf('-x-')
+    if (privateIndex === -1) {
+      foundLocale = foundLocale + supportedExtension
+    } else {
+      const preExtension = foundLocale.slice(0, privateIndex)
+      const postExtension = foundLocale.slice(privateIndex, foundLocale.length)
+      foundLocale = preExtension + supportedExtension + postExtension
+    }
+    foundLocale = (Intl as any).getCanonicalLocales(foundLocale)[0]
+  }
+  result.locale = foundLocale
+  return result
+}

package/abstract/UnicodeExtensionValue.ts

@@ -0,0 +1,44 @@
+import {invariant} from './utils'
+
+/**
+ * https://tc39.es/ecma402/#sec-unicodeextensionvalue
+ * @param extension
+ * @param key
+ */
+export function UnicodeExtensionValue(extension: string, key: string) {
+  invariant(key.length === 2, 'key must have 2 elements')
+  const size = extension.length
+  let searchValue = `-${key}-`
+  let pos = extension.indexOf(searchValue)
+  if (pos !== -1) {
+    const start = pos + 4
+    let end = start
+    let k = start
+    let done = false
+    while (!done) {
+      const e = extension.indexOf('-', k)
+      let len
+      if (e === -1) {
+        len = size - k
+      } else {
+        len = e - k
+      }
+      if (len === 2) {
+        done = true
+      } else if (e === -1) {
+        end = size
+        done = true
+      } else {
+        end = e
+        k = e + 1
+      }
+    }
+    return extension.slice(start, end)
+  }
+  searchValue = `-${key}`
+  pos = extension.indexOf(searchValue)
+  if (pos !== -1 && pos + 3 === size) {
+    return ''
+  }
+  return undefined
+}

package/abstract/types.ts

@@ -0,0 +1,5 @@
+export interface LookupMatcherResult {
+  locale: string
+  extension?: string
+  nu?: string
+}

package/abstract/utils.ts

@@ -0,0 +1,11 @@
+export const UNICODE_EXTENSION_SEQUENCE_REGEX = /-u(?:-[0-9a-z]{2,8})+/gi
+
+export function invariant(
+  condition: boolean,
+  message: string,
+  Err: any = Error
+): asserts condition {
+  if (!condition) {
+    throw new Err(message)
+  }
+}

package/index.ts

@@ -0,0 +1,32 @@
+import {CanonicalizeLocaleList} from './abstract/CanonicalizeLocaleList'
+import {ResolveLocale} from './abstract/ResolveLocale'
+
+export interface Opts {
+  algorithm: 'lookup' | 'best fit'
+}
+
+export function match(
+  requestedLocales: string[],
+  availableLocales: string[],
+  defaultLocale: string,
+  opts?: Opts
+): string {
+  const locales = availableLocales.reduce((all, l) => {
+    all.add(l)
+    return all
+  }, new Set<string>())
+
+  return ResolveLocale(
+    locales,
+    CanonicalizeLocaleList(requestedLocales),
+    {
+      localeMatcher: opts?.algorithm || 'best fit',
+    },
+    [],
+    {},
+    () => defaultLocale
+  ).locale
+}
+
+export {LookupSupportedLocales} from './abstract/LookupSupportedLocales'
+export {ResolveLocale} from './abstract/ResolveLocale'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@formatjs/intl-localematcher",
-  "version": "0.2.25",
+  "version": "0.2.29",
   "description": "Intl.LocaleMatcher ponyfill",
   "keywords": [
     "intl",
@@ -25,6 +25,6 @@
     "url": "https://github.com/formatjs/formatjs/issues"
   },
   "dependencies": {
-    "tslib": "^2.1.0"
+    "tslib": "2.4.0"
   }
-}
+}

package/tests/BestFitMatcher.test.ts

@@ -0,0 +1,23 @@
+import {BestFitMatcher} from '../abstract/BestFitMatcher'
+
+test('BestFitMatcher', function () {
+  expect(
+    BestFitMatcher(new Set(['fr', 'en']), ['fr-XX', 'en'], () => 'en')
+  ).toEqual({
+    locale: 'fr',
+  })
+})
+
+test('BestFitMatcher zh-TW', function () {
+  expect(
+    BestFitMatcher(new Set(['zh', 'zh-Hant']), ['zh-TW'], () => 'en')
+  ).toEqual({
+    locale: 'zh-Hant',
+  })
+})
+
+test('BestFitMatcher en', function () {
+  expect(BestFitMatcher(new Set(['en', 'und']), ['en'], () => 'en')).toEqual({
+    locale: 'en',
+  })
+})

package/tests/LookupMatcher.test.ts

@@ -0,0 +1,17 @@
+import {LookupMatcher} from '../abstract/LookupMatcher'
+
+test('LookupMatcher', function () {
+  expect(
+    LookupMatcher(new Set(['fr', 'en']), ['fr-XX', 'en'], () => 'en')
+  ).toEqual({
+    locale: 'fr',
+  })
+})
+
+test('LookupMatcher', function () {
+  expect(
+    LookupMatcher(new Set(['zh', 'zh-Hant']), ['zh-Hans'], () => 'en')
+  ).toEqual({
+    locale: 'zh',
+  })
+})