@react-aria/i18n 3.0.0-nightly-641446f65-240905

package/src/useLocalizedStringFormatter.ts

@@ -0,0 +1,44 @@
+/*
+ * Copyright 2022 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+import {LocalizedString, LocalizedStringDictionary, LocalizedStringFormatter, LocalizedStrings} from '@internationalized/string';
+import {useLocale} from './context';
+import {useMemo} from 'react';
+
+const cache = new WeakMap();
+function getCachedDictionary<K extends string, T extends LocalizedString>(strings: LocalizedStrings<K, T>): LocalizedStringDictionary<K, T> {
+  let dictionary = cache.get(strings);
+  if (!dictionary) {
+    dictionary = new LocalizedStringDictionary(strings);
+    cache.set(strings, dictionary);
+  }
+
+  return dictionary;
+}
+
+/**
+ * Returns a cached LocalizedStringDictionary for the given strings.
+ */
+export function useLocalizedStringDictionary<K extends string = string, T extends LocalizedString = string>(strings: LocalizedStrings<K, T>, packageName?: string): LocalizedStringDictionary<K, T> {
+  return (packageName && LocalizedStringDictionary.getGlobalDictionaryForPackage(packageName)) || getCachedDictionary(strings);
+}
+
+/**
+ * Provides localized string formatting for the current locale. Supports interpolating variables,
+ * selecting the correct pluralization, and formatting numbers. Automatically updates when the locale changes.
+ * @param strings - A mapping of languages to localized strings by key.
+ */
+export function useLocalizedStringFormatter<K extends string = string, T extends LocalizedString = string>(strings: LocalizedStrings<K, T>, packageName?: string): LocalizedStringFormatter<K, T> {
+  let {locale} = useLocale();
+  let dictionary = useLocalizedStringDictionary(strings, packageName);
+  return useMemo(() => new LocalizedStringFormatter(locale, dictionary), [locale, dictionary]);
+}

package/src/useMessageFormatter.ts

@@ -0,0 +1,41 @@
+/*
+ * Copyright 2020 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+import {LocalizedStrings, MessageDictionary, MessageFormatter} from '@internationalized/message';
+import {useCallback, useMemo} from 'react';
+import {useLocale} from './context';
+
+export type FormatMessage = (key: string, variables?: {[key: string]: any}) => string;
+
+const cache = new WeakMap();
+function getCachedDictionary(strings: LocalizedStrings) {
+  let dictionary = cache.get(strings);
+  if (!dictionary) {
+    dictionary = new MessageDictionary(strings);
+    cache.set(strings, dictionary);
+  }
+
+  return dictionary;
+}
+
+/**
+ * Handles formatting ICU Message strings to create localized strings for the current locale.
+ * Automatically updates when the locale changes, and handles caching of messages for performance.
+ * @param strings - A mapping of languages to strings by key.
+ * @deprecated - use useLocalizedStringFormatter instead.
+ */
+export function useMessageFormatter(strings: LocalizedStrings): FormatMessage {
+  let {locale} = useLocale();
+  let dictionary = useMemo(() => getCachedDictionary(strings), [strings]);
+  let formatter = useMemo(() => new MessageFormatter(locale, dictionary), [locale, dictionary]);
+  return useCallback((key, variables) => formatter.format(key, variables), [formatter]);
+}

package/src/useNumberFormatter.ts

@@ -0,0 +1,25 @@
+/*
+ * Copyright 2020 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+import {NumberFormatOptions, NumberFormatter} from '@internationalized/number';
+import {useLocale} from './context';
+import {useMemo} from 'react';
+
+/**
+ * Provides localized number formatting for the current locale. Automatically updates when the locale changes,
+ * and handles caching of the number formatter for performance.
+ * @param options - Formatting options.
+ */
+export function useNumberFormatter(options: NumberFormatOptions = {}): Intl.NumberFormat {
+  let {locale} = useLocale();
+  return useMemo(() => new NumberFormatter(locale, options), [locale, options]);
+}

package/src/utils.ts

@@ -0,0 +1,44 @@
+/*
+ * Copyright 2020 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+// https://en.wikipedia.org/wiki/Right-to-left
+const RTL_SCRIPTS = new Set(['Arab', 'Syrc', 'Samr', 'Mand', 'Thaa', 'Mend', 'Nkoo', 'Adlm', 'Rohg', 'Hebr']);
+const RTL_LANGS = new Set(['ae', 'ar', 'arc', 'bcc', 'bqi', 'ckb', 'dv', 'fa', 'glk', 'he', 'ku', 'mzn', 'nqo', 'pnb', 'ps', 'sd', 'ug', 'ur', 'yi']);
+
+/**
+ * Determines if a locale is read right to left using [Intl.Locale]{@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale}.
+ */
+export function isRTL(localeString: string) {
+  // If the Intl.Locale API is available, use it to get the locale's text direction.
+  // @ts-ignore
+  if (Intl.Locale) {
+    let locale = new Intl.Locale(localeString).maximize();
+
+    // Use the text info object to get the direction if possible.
+    // @ts-ignore - this was implemented as a property by some browsers before it was standardized as a function.
+    // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/getTextInfo
+    let textInfo = typeof locale.getTextInfo === 'function' ? locale.getTextInfo() : locale.textInfo;
+    if (textInfo) {
+      return textInfo.direction === 'rtl';
+    }
+
+    // Fallback: guess using the script.
+    // This is more accurate than guessing by language, since languages can be written in multiple scripts.
+    if (locale.script) {
+      return RTL_SCRIPTS.has(locale.script);
+    }
+  }
+
+  // If not, just guess by the language (first part of the locale)
+  let lang = localeString.split('-')[0];
+  return RTL_LANGS.has(lang);
+}