@oxy.so/core 1.1.2 → 1.2.0

package/dist/esm/index.js

@@ -91,7 +91,7 @@ export { TopicType, TopicSource } from './models/Topic.js';
 // ---------------------------------------------------------------------------
 // Languages
 // ---------------------------------------------------------------------------
-export { SUPPORTED_LANGUAGES, FALLBACK_LOCALE, getBaseLanguage, normalizeLocale, isSupportedLocale, getLanguageMetadata, getLanguageName, getNativeLanguageName, isRTLLocale, getUserLanguages, getPrimaryLanguage, } from './utils/languageUtils.js';
+export { SUPPORTED_LANGUAGES, FALLBACK_LOCALE, getBaseLanguage, normalizeLocale, isSupportedLocale, getLanguageMetadata, getLanguageName, getNativeLanguageName, isRTLLocale, getUserLanguages, getPrimaryLanguage, coerceToSupportedLocale, } from './utils/languageUtils.js';
 // ---------------------------------------------------------------------------
 // Platform detection
 // ---------------------------------------------------------------------------

package/dist/esm/utils/languageUtils.js

@@ -210,3 +210,28 @@ export function getUserLanguages(user) {
 export function getPrimaryLanguage(user) {
     return getUserLanguages(user)[0];
 }
+/**
+ * Coerce a locale down to one from a CALLER-provided catalog: an exact
+ * canonical match wins, else the closest entry sharing the same base
+ * language (an `es-MX` account reads a host app's `es-ES` catalog), else
+ * `fallback`.
+ *
+ * A host app's own shipped translation catalog is rarely {@link SUPPORTED_LANGUAGES}
+ * itself — Oxy's account-locale catalog is broader than any one app's
+ * translated strings — so this is the one place that gap is bridged. Every Oxy
+ * app was independently re-deriving this exact algorithm against its own
+ * catalog before it moved here.
+ */
+export function coerceToSupportedLocale(locale, supportedLocales, fallback) {
+    if (locale) {
+        const canonical = normalizeLocale(locale);
+        if (canonical && supportedLocales.includes(canonical)) {
+            return canonical;
+        }
+        const base = getBaseLanguage(locale);
+        const byBase = supportedLocales.find((entry) => getBaseLanguage(entry) === base);
+        if (byBase)
+            return byBase;
+    }
+    return fallback;
+}