@adminforth/i18n 2.4.0 → 2.5.0

package/base.ts

@@ -11,19 +11,21 @@ const REGION_CODE_RE = /^[A-Z]{2}$/;
 export const SOURCE_LANGUAGE = 'en';
 export const PLURAL_SEPARATOR = '|';
 export const SLAVIC_PLURAL_FORMS = 4;
+export const SLAVIC_PLURAL_FORMS_HINT = 'zero | singular | 2-4 | 5+';
 
+// forms in SLAVIC_PLURAL_FORMS_HINT order
 export const SLAVIC_PLURAL_EXAMPLES = {
-  uk: 'яблук | яблуко | яблука | яблук', // zero | singular | 2-4 | 5+
-  bg: 'ябълки | ябълка | ябълки | ябълки', // zero | singular | 2-4 | 5+
-  cs: 'jablek | jablko | jablka | jablek', // zero | singular | 2-4 | 5+
-  hr: 'jabuka | jabuka | jabuke | jabuka', // zero | singular | 2-4 | 5+
-  mk: 'јаболка | јаболко | јаболка | јаболка', // zero | singular | 2-4 | 5+
-  pl: 'jabłek | jabłko | jabłka | jabłek', // zero | singular | 2-4 | 5+
-  sk: 'jabĺk | jablko | jablká | jabĺk', // zero | singular | 2-4 | 5+
-  sl: 'jabolk | jabolko | jabolka | jabolk', // zero | singular | 2-4 | 5+
-  sr: 'јабука | јабука | јабуке | јабука', // zero | singular | 2-4 | 5+
-  be: 'яблыкаў | яблык | яблыкі | яблыкаў', // zero | singular | 2-4 | 5+
-  ru: 'яблок | яблоко | яблока | яблок', // zero | singular | 2-4 | 5+
+  uk: 'яблук | яблуко | яблука | яблук',
+  bg: 'ябълки | ябълка | ябълки | ябълки',
+  cs: 'jablek | jablko | jablka | jablek',
+  hr: 'jabuka | jabuka | jabuke | jabuka',
+  mk: 'јаболка | јаболко | јаболка | јаболка',
+  pl: 'jabłek | jabłko | jabłka | jabłek',
+  sk: 'jabĺk | jablko | jablká | jabĺk',
+  sl: 'jabolk | jabolko | jabolka | jabolk',
+  sr: 'јабука | јабука | јабуке | јабука',
+  be: 'яблыкаў | яблык | яблыкі | яблыкаў',
+  ru: 'яблок | яблоко | яблока | яблок',
 };
 
 const countryISO31661ByLangISO6391 = {
@@ -36,7 +38,142 @@ const countryISO31661ByLangISO6391 = {
   uk: 'ua', // Ukrainian → Ukraine
   ur: 'pk', // Urdu → Pakistan
   sr: 'rs', // Serbian → Serbia
-  da: 'dk' // Danish → Denmark
+  da: 'dk', // Danish → Denmark
+  sv: 'se', // Swedish → Sweden
+  he: 'il', // Hebrew → Israel
+  el: 'gr', // Greek → Greece
+  cs: 'cz', // Czech → Czech Republic
+  vi: 'vn', // Vietnamese → Vietnam
+  aa: 'et', // Afar → Ethiopia
+  ab: 'ge', // Abkhaz → Georgia
+  ae: 'ir', // Avestan → Iran
+  af: 'za', // Afrikaans → South Africa
+  ak: 'gh', // Akan → Ghana
+  am: 'et', // Amharic → Ethiopia
+  an: 'es', // Aragonese → Spain
+  as: 'in', // Assamese → India
+  av: 'ru', // Avaric → Russia
+  ay: 'bo', // Aymara → Bolivia
+  ba: 'ru', // Bashkir → Russia
+  be: 'by', // Belarusian → Belarus
+  bi: 'vu', // Bislama → Vanuatu
+  bm: 'ml', // Bambara → Mali
+  bn: 'bd', // Bengali → Bangladesh
+  bo: 'cn', // Tibetan → China
+  br: 'fr', // Breton → France
+  bs: 'ba', // Bosnian → Bosnia & Herzegovina
+  ca: 'es', // Catalan → Spain
+  ce: 'ru', // Chechen → Russia
+  ch: 'gu', // Chamorro → Guam
+  co: 'fr', // Corsican → France
+  cr: 'ca', // Cree → Canada
+  cu: 'ru', // Old Church Slavonic → Russia
+  cv: 'ru', // Chuvash → Russia
+  cy: 'gb', // Welsh → United Kingdom
+  dv: 'mv', // Divehi → Maldives
+  dz: 'bt', // Dzongkha → Bhutan
+  ee: 'gh', // Ewe → Ghana
+  et: 'ee', // Estonian → Estonia
+  eu: 'es', // Basque → Spain
+  fa: 'ir', // Persian → Iran
+  ff: 'sn', // Fula → Senegal
+  fy: 'nl', // Western Frisian → Netherlands
+  ga: 'ie', // Irish → Ireland
+  gd: 'gb', // Scottish Gaelic → United Kingdom
+  gl: 'es', // Galician → Spain
+  gn: 'py', // Guaraní → Paraguay
+  gu: 'in', // Gujarati → India
+  gv: 'im', // Manx → Isle of Man
+  ha: 'ng', // Hausa → Nigeria
+  ho: 'pg', // Hiri Motu → Papua New Guinea
+  hy: 'am', // Armenian → Armenia
+  hz: 'na', // Herero → Namibia
+  ie: 'ee', // Interlingue → Estonia
+  ig: 'ng', // Igbo → Nigeria
+  ii: 'cn', // Nuosu → China
+  ik: 'us', // Inupiaq → United States
+  iu: 'ca', // Inuktitut → Canada
+  jv: 'id', // Javanese → Indonesia
+  ka: 'ge', // Georgian → Georgia
+  kg: 'cd', // Kongo → Congo - Kinshasa
+  ki: 'ke', // Kikuyu → Kenya
+  kj: 'na', // Kwanyama → Namibia
+  kk: 'kz', // Kazakh → Kazakhstan
+  kl: 'gl', // Kalaallisut → Greenland
+  km: 'kh', // Khmer → Cambodia
+  kn: 'in', // Kannada → India
+  kr: 'ng', // Kanuri → Nigeria
+  ks: 'in', // Kashmiri → India
+  ku: 'tr', // Kurdish → Türkiye
+  kv: 'ru', // Komi → Russia
+  kw: 'gb', // Cornish → United Kingdom
+  ky: 'kg', // Kyrgyz → Kyrgyzstan
+  la: 'va', // Latin → Vatican City
+  lb: 'lu', // Luxembourgish → Luxembourg
+  lg: 'ug', // Ganda → Uganda
+  li: 'nl', // Limburgish → Netherlands
+  ln: 'cd', // Lingala → Congo - Kinshasa
+  lo: 'la', // Lao → Laos
+  lu: 'cd', // Luba-Katanga → Congo - Kinshasa
+  mi: 'nz', // Māori → New Zealand
+  ml: 'in', // Malayalam → India
+  mr: 'in', // Marathi → India
+  ms: 'my', // Malay → Malaysia
+  my: 'mm', // Burmese → Myanmar (Burma)
+  na: 'nr', // Nauru → Nauru
+  nb: 'no', // Norwegian Bokmål → Norway
+  nd: 'zw', // Northern Ndebele → Zimbabwe
+  ne: 'np', // Nepali → Nepal
+  ng: 'na', // Ndonga → Namibia
+  nn: 'no', // Norwegian Nynorsk → Norway
+  nr: 'za', // Southern Ndebele → South Africa
+  nv: 'us', // Navajo → United States
+  ny: 'mw', // Chichewa → Malawi
+  oc: 'fr', // Occitan → France
+  oj: 'ca', // Ojibwe → Canada
+  om: 'et', // Oromo → Ethiopia
+  or: 'in', // Oriya → India
+  os: 'ge', // Ossetian → Georgia
+  pa: 'in', // Panjabi → India
+  pi: 'gb', // Pāli → United Kingdom
+  ps: 'af', // Pashto → Afghanistan
+  qu: 'pe', // Quechua → Peru
+  rm: 'ch', // Romansh → Switzerland
+  rn: 'bi', // Kirundi → Burundi
+  sa: 'in', // Sanskrit → India
+  sc: 'it', // Sardinian → Italy
+  sd: 'pk', // Sindhi → Pakistan
+  se: 'no', // Northern Sami → Norway
+  sg: 'cf', // Sango → Central African Republic
+  si: 'lk', // Sinhala → Sri Lanka
+  sl: 'si', // Slovenian → Slovenia
+  sm: 'ws', // Samoan → Samoa
+  sn: 'zw', // Shona → Zimbabwe
+  sq: 'al', // Albanian → Albania
+  ss: 'za', // Swati → South Africa
+  st: 'za', // Southern Sotho → South Africa
+  su: 'id', // Sundanese → Indonesia
+  sw: 'tz', // Swahili → Tanzania
+  ta: 'in', // Tamil → India
+  te: 'in', // Telugu → India
+  tg: 'tj', // Tajik → Tajikistan
+  ti: 'et', // Tigrinya → Ethiopia
+  tk: 'tm', // Turkmen → Turkmenistan
+  tl: 'ph', // Tagalog → Philippines
+  tn: 'za', // Tswana → South Africa
+  ts: 'za', // Tsonga → South Africa
+  tt: 'ru', // Tatar → Russia
+  tw: 'gh', // Twi → Ghana
+  ty: 'pf', // Tahitian → French Polynesia
+  ug: 'cn', // Uyghur → China
+  ve: 'za', // Venda → South Africa
+  wa: 'be', // Walloon → Belgium
+  wo: 'sn', // Wolof → Senegal
+  xh: 'za', // Xhosa → South Africa
+  yi: 'ua', // Yiddish → Ukraine
+  yo: 'ng', // Yoruba → Nigeria
+  za: 'cn', // Zhuang → China
+  zu: 'za', // Zulu → South Africa
 };
 
 export function getCountryCodeFromLangCode(lang: SupportedLanguage) {
@@ -98,6 +235,31 @@ export abstract class I18nBase<O extends I18nBaseOptions = I18nBaseOptions> exte
 
   abstract getCategoryTranslations(category: string, lang: string): Promise<Record<string, string>>;
 
+  // languages translations are written for: strings in source language are the keys themselves
+  targetLanguages(): SupportedLanguage[] {
+    return this.options.supportedLanguages.filter((lang) => lang !== SOURCE_LANGUAGE);
+  }
+
+  // empty translation means "not translated yet", original string is shown instead
+  fallbackToOriginal(messages: Record<string, string>): Record<string, string> {
+    return Object.fromEntries(Object.entries(messages).map(([key, value]) => [key, value || key]));
+  }
+
+  /**
+   * Translates backend strings (menu, resource labels, errors) with adminforth.tr,
+   * subclass provides only translation lookup in its storage for already resolved language
+   */
+  installBackendTranslator(adminforth: IAdminForth, lookup: (msg: string, category: string, lang: string) => Promise<string | undefined>) {
+    adminforth.tr = async (msg, category, lang, params, pluralizationNumber) => {
+      if (!msg) {
+        return msg;
+      }
+      const resolvedLang = this.resolveLanguage(lang);
+      const translation = await lookup(msg, category, resolvedLang);
+      return this.formatTranslation(msg, translation || msg, resolvedLang, params, pluralizationNumber);
+    };
+  }
+
   // validate each supported language: ISO 639-1 or BCP-47 with region (e.g., en-GB)
   validateSupportedLanguages() {
     this.options.supportedLanguages.forEach((lang) => {
@@ -118,6 +280,7 @@ export abstract class I18nBase<O extends I18nBaseOptions = I18nBaseOptions> exte
           code: lang,
           // lang name on on language native name
           name: iso6391.getNativeName(getPrimaryLanguageCode(lang)),
+          countryCode: getCountryCodeFromLangCode(lang),
         }
       ))
     };

package/build.log

@@ -20,5 +20,5 @@ custom/package.json
 custom/pnpm-lock.yaml
 custom/tsconfig.json
 
-sent 48,201 bytes  received 305 bytes  32,337.33 bytes/sec
-total size is 47,033  speedup is 0.97
+sent 47,235 bytes  received 305 bytes  95,080.00 bytes/sec
+total size is 46,083  speedup is 0.97

package/custom/BulkActionButton.vue

@@ -41,7 +41,7 @@
         <div class="group hover:bg-gray-100 dark:hover:bg-gray-600 px-2 py-2 flex items-center cursor-pointer" v-for="(index, lang) in checkedLanguages" :key="lang" @click="toggleLanguage(lang)">
           <Checkbox v-model="checkedLanguages[lang]" /> 
           <span class="flag-icon mr-2"
-            :class="`flag-icon-${getCountryCodeFromLangCode(lang)}`"
+            :class="`flag-icon-${props.meta.countryCodes[lang]}`"
           ></span>
           <span class="group-hover:text-gray-900 text-gray-600 dark:text-white dark:group-hover:text-gray-200">{{ ISO6391.getName(lang.slice(0,2)) }} ({{ lang }})</span>
         </div>
@@ -58,7 +58,6 @@
   import { computed, onMounted, ref, onUnmounted } from 'vue';
   import { callAdminForthApi } from '@/utils';
   import { useAdminforth } from '@/adminforth';
-  import { getCountryCodeFromLangCode } from './langCommon';
   import { getName, overwrite } from 'country-list';
   import ISO6391 from 'iso-639-1';
   import 'flag-icon-css/css/flag-icons.min.css';
@@ -82,6 +81,7 @@
     adminUser: Record<string, any>;
     meta: {
       supportedLanguages: string[];
+      countryCodes: Record<string, string>;
       pluginInstanceId: string;
     };
     clearCheckboxes: () => void;

package/custom/LanguageInUserMenu.vue

@@ -10,7 +10,7 @@
       <div>
         <span class="mr-1">
           <span class="flag-icon"
-            :class="`flag-icon-${getCountryCodeFromLangCode(selectedOption.value)}`"
+            :class="`flag-icon-${selectedOption.countryCode}`"
           ></span>
         </span>
         <span>{{ selectedOption.label }}</span>
@@ -32,7 +32,7 @@
       >
         <span class="mr-1">
           <span class="flag-icon"
-            :class="`flag-icon-${getCountryCodeFromLangCode(option.value)}`"
+            :class="`flag-icon-${option.countryCode}`"
           ></span>
         </span>
         <span>{{ option.label }}</span>
@@ -48,7 +48,7 @@
 import 'flag-icon-css/css/flag-icons.min.css';
 import { IconCaretDownSolid } from '@iconify-prerendered/vue-flowbite';
 
-import { setLang, getCountryCodeFromLangCode, getLocalLang, setLocalLang } from './langCommon';
+import { setLang, getLocalLang, setLocalLang, getLanguageOptions } from './langCommon';
 
 import { computed, ref, onMounted, watch } from 'vue';
 import { useI18n } from 'vue-i18n';
@@ -68,15 +68,7 @@ function doChangeLang(lang) {
 }
 
 
-const options = computed(() => {
-  return props.meta.supportedLanguages.map((lang) => {
-    const region = String(lang.code).split('-')[1]?.toUpperCase();
-    return {
-      value: lang.code,
-      label: region ? `${lang.name} (${region})` : lang.name,
-    };
-  });
-});
+const options = computed(() => getLanguageOptions(props.meta.supportedLanguages));
 
 const selectedOption = computed(() => {
   const val = options.value.find((option) => option.value === selectedLanguage.value);

package/custom/LanguageUnderLogin.vue

@@ -9,7 +9,7 @@
       <template #item="{ option }">
         <span class="mr-1">
           <span class="flag-icon"
-            :class="`flag-icon-${getCountryCodeFromLangCode(option.value)}`"
+            :class="`flag-icon-${option.countryCode}`"
           ></span> 
 
         </span>
@@ -19,7 +19,7 @@
       <template #selected-item="{option}">
         <span class="mr-1">
           <span class="flag-icon"
-            :class="`flag-icon-${getCountryCodeFromLangCode(option.value)}`"
+            :class="`flag-icon-${option.countryCode}`"
           ></span>
         </span>
         <span>{{ option.label }}</span>
@@ -31,7 +31,7 @@
 <script setup>
 import Select from '@/afcl/Select.vue';
 import 'flag-icon-css/css/flag-icons.min.css';
-import { setLang, getCountryCodeFromLangCode, getLocalLang } from './langCommon';
+import { setLang, getLocalLang, getLanguageOptions } from './langCommon';
 import { useCoreStore } from '@/stores/core';
 
 import { computed, ref, onMounted, watch } from 'vue';
@@ -52,15 +52,7 @@ watch(() => selectedLanguage.value, async (newVal) => {
 });
 
 
-const options = computed(() => {
-  return props.meta.supportedLanguages.map((lang) => {
-    const region = String(lang.code).split('-')[1]?.toUpperCase();
-    return {
-      value: lang.code,
-      label: region ? `${lang.name} (${region})` : lang.name,
-    };
-  });
-});
+const options = computed(() => getLanguageOptions(props.meta.supportedLanguages));
 
 onMounted(() => {
   selectedLanguage.value = getLocalLang(props.meta.supportedLanguages, props.meta.primaryLanguage);

package/custom/TranslationJobViewComponent.vue

@@ -22,7 +22,7 @@
         </span>
         <div class="flex items-center gap-2 shrink-0">
           <span class="flag-icon"
-            :class="`flag-icon-${getCountryCodeFromLangCode(task.state?.lang)}`"
+            :class="`flag-icon-${task.state?.countryCode}`"
           ></span>
           <component
             :is="getCustomComponent({file: '@@/plugins/BackgroundJobsPlugin/StateToIcon.vue'})"
@@ -61,7 +61,6 @@
 import { useI18n } from 'vue-i18n'
 import { computed, onMounted, onUnmounted, ref } from 'vue';
 import websocket from '@/websocket';
-import { getCountryCodeFromLangCode } from './langCommon';
 import { getCustomComponent } from '@/utils';
 import { Button, Spinner } from '@/afcl';
 import { IconAngleLeftOutline, IconAngleRightOutline } from '@iconify-prerendered/vue-flowbite';
@@ -106,7 +105,7 @@ async function loadPage(targetPage: number) {
   try {
     for (let retry = 0; retry < retries; retry++) {
       try {
-        const res = await props.getJobTasks(PAGE_SIZE, targetPage * PAGE_SIZE, ['lang', 'error', 'taskName', 'failedToTranslate']);
+        const res = await props.getJobTasks(PAGE_SIZE, targetPage * PAGE_SIZE, ['lang', 'countryCode', 'error', 'taskName', 'failedToTranslate']);
         if (res && res.length > 0) {
           translationTasks.value = res;
           page.value = targetPage;

package/custom/langCommon.ts

@@ -65,32 +65,20 @@ export async function setLang({ setLocaleMessage, locale }: any, pluginInstanceI
     setLocalLang(langIso);
 }
 
-// only remap the country code for the languages where language code is different from the country code
-// don't include es: es, fr: fr, etc, only include the ones where language code is different from the country code
-const countryISO31661ByLangISO6391 = {
-    en: 'us', // English → United States
-    zh: 'cn', // Chinese → China
-    hi: 'in', // Hindi → India
-    ar: 'sa', // Arabic → Saudi Arabia
-    ko: 'kr', // Korean → South Korea
-    ja: 'jp', // Japanese → Japan
-    uk: 'ua', // Ukrainian → Ukraine
-    ur: 'pk', // Urdu → Pakistan
-    sr: 'rs', // Serbian → Serbia
-    da: 'dk' // Danish → Denmark
-};
-
-export function getCountryCodeFromLangCode(langCode) {
-    const [primary, region] = String(langCode).split('-');
-    if (region && /^[A-Za-z]{2}$/.test(region)) {
-        return region.toLowerCase();
-    }
-    return countryISO31661ByLangISO6391[primary] || primary;
-}
-
-
 const LS_LANG_KEY = `afLanguage`;
 
+// options for language selectors, region of BCP-47 tag is added to native language name, e.g. "Português (BR)"
+export function getLanguageOptions(supportedLanguages: { code: string, name: string, countryCode: string }[]) {
+    return supportedLanguages.map((lang) => {
+        const region = String(lang.code).split('-')[1]?.toUpperCase();
+        return {
+            value: lang.code,
+            countryCode: lang.countryCode,
+            label: region ? `${lang.name} (${region})` : lang.name,
+        };
+    });
+}
+
 export function getLocalLang(supportedLanguages: {code}[], primaryLanguage?: SupportedLanguage): string {
     let lsLang = localStorage.getItem(LS_LANG_KEY);
     // if someone screwed up the local storage or we stopped language support, lets check if it is in supported languages

package/dist/base.d.ts

@@ -4,6 +4,7 @@ import type { I18nBaseOptions, SupportedLanguage } from './types.js';
 export declare const SOURCE_LANGUAGE = "en";
 export declare const PLURAL_SEPARATOR = "|";
 export declare const SLAVIC_PLURAL_FORMS = 4;
+export declare const SLAVIC_PLURAL_FORMS_HINT = "zero | singular | 2-4 | 5+";
 export declare const SLAVIC_PLURAL_EXAMPLES: {
     uk: string;
     bg: string;
@@ -34,6 +35,13 @@ export declare abstract class I18nBase<O extends I18nBaseOptions = I18nBaseOptio
     constructor(options: O);
     instanceUniqueRepresentation(): string;
     abstract getCategoryTranslations(category: string, lang: string): Promise<Record<string, string>>;
+    targetLanguages(): SupportedLanguage[];
+    fallbackToOriginal(messages: Record<string, string>): Record<string, string>;
+    /**
+     * Translates backend strings (menu, resource labels, errors) with adminforth.tr,
+     * subclass provides only translation lookup in its storage for already resolved language
+     */
+    installBackendTranslator(adminforth: IAdminForth, lookup: (msg: string, category: string, lang: string) => Promise<string | undefined>): void;
     validateSupportedLanguages(): void;
     injectLanguageSelectors(adminforth: IAdminForth): void;
     resolveLanguage(lang: string): string;

package/dist/base.js

@@ -16,18 +16,20 @@ const REGION_CODE_RE = /^[A-Z]{2}$/;
 export const SOURCE_LANGUAGE = 'en';
 export const PLURAL_SEPARATOR = '|';
 export const SLAVIC_PLURAL_FORMS = 4;
+export const SLAVIC_PLURAL_FORMS_HINT = 'zero | singular | 2-4 | 5+';
+// forms in SLAVIC_PLURAL_FORMS_HINT order
 export const SLAVIC_PLURAL_EXAMPLES = {
-    uk: 'яблук | яблуко | яблука | яблук', // zero | singular | 2-4 | 5+
-    bg: 'ябълки | ябълка | ябълки | ябълки', // zero | singular | 2-4 | 5+
-    cs: 'jablek | jablko | jablka | jablek', // zero | singular | 2-4 | 5+
-    hr: 'jabuka | jabuka | jabuke | jabuka', // zero | singular | 2-4 | 5+
-    mk: 'јаболка | јаболко | јаболка | јаболка', // zero | singular | 2-4 | 5+
-    pl: 'jabłek | jabłko | jabłka | jabłek', // zero | singular | 2-4 | 5+
-    sk: 'jabĺk | jablko | jablká | jabĺk', // zero | singular | 2-4 | 5+
-    sl: 'jabolk | jabolko | jabolka | jabolk', // zero | singular | 2-4 | 5+
-    sr: 'јабука | јабука | јабуке | јабука', // zero | singular | 2-4 | 5+
-    be: 'яблыкаў | яблык | яблыкі | яблыкаў', // zero | singular | 2-4 | 5+
-    ru: 'яблок | яблоко | яблока | яблок', // zero | singular | 2-4 | 5+
+    uk: 'яблук | яблуко | яблука | яблук',
+    bg: 'ябълки | ябълка | ябълки | ябълки',
+    cs: 'jablek | jablko | jablka | jablek',
+    hr: 'jabuka | jabuka | jabuke | jabuka',
+    mk: 'јаболка | јаболко | јаболка | јаболка',
+    pl: 'jabłek | jabłko | jabłka | jabłek',
+    sk: 'jabĺk | jablko | jablká | jabĺk',
+    sl: 'jabolk | jabolko | jabolka | jabolk',
+    sr: 'јабука | јабука | јабуке | јабука',
+    be: 'яблыкаў | яблык | яблыкі | яблыкаў',
+    ru: 'яблок | яблоко | яблока | яблок',
 };
 const countryISO31661ByLangISO6391 = {
     en: 'us', // English → United States
@@ -39,7 +41,142 @@ const countryISO31661ByLangISO6391 = {
     uk: 'ua', // Ukrainian → Ukraine
     ur: 'pk', // Urdu → Pakistan
     sr: 'rs', // Serbian → Serbia
-    da: 'dk' // Danish → Denmark
+    da: 'dk', // Danish → Denmark
+    sv: 'se', // Swedish → Sweden
+    he: 'il', // Hebrew → Israel
+    el: 'gr', // Greek → Greece
+    cs: 'cz', // Czech → Czech Republic
+    vi: 'vn', // Vietnamese → Vietnam
+    aa: 'et', // Afar → Ethiopia
+    ab: 'ge', // Abkhaz → Georgia
+    ae: 'ir', // Avestan → Iran
+    af: 'za', // Afrikaans → South Africa
+    ak: 'gh', // Akan → Ghana
+    am: 'et', // Amharic → Ethiopia
+    an: 'es', // Aragonese → Spain
+    as: 'in', // Assamese → India
+    av: 'ru', // Avaric → Russia
+    ay: 'bo', // Aymara → Bolivia
+    ba: 'ru', // Bashkir → Russia
+    be: 'by', // Belarusian → Belarus
+    bi: 'vu', // Bislama → Vanuatu
+    bm: 'ml', // Bambara → Mali
+    bn: 'bd', // Bengali → Bangladesh
+    bo: 'cn', // Tibetan → China
+    br: 'fr', // Breton → France
+    bs: 'ba', // Bosnian → Bosnia & Herzegovina
+    ca: 'es', // Catalan → Spain
+    ce: 'ru', // Chechen → Russia
+    ch: 'gu', // Chamorro → Guam
+    co: 'fr', // Corsican → France
+    cr: 'ca', // Cree → Canada
+    cu: 'ru', // Old Church Slavonic → Russia
+    cv: 'ru', // Chuvash → Russia
+    cy: 'gb', // Welsh → United Kingdom
+    dv: 'mv', // Divehi → Maldives
+    dz: 'bt', // Dzongkha → Bhutan
+    ee: 'gh', // Ewe → Ghana
+    et: 'ee', // Estonian → Estonia
+    eu: 'es', // Basque → Spain
+    fa: 'ir', // Persian → Iran
+    ff: 'sn', // Fula → Senegal
+    fy: 'nl', // Western Frisian → Netherlands
+    ga: 'ie', // Irish → Ireland
+    gd: 'gb', // Scottish Gaelic → United Kingdom
+    gl: 'es', // Galician → Spain
+    gn: 'py', // Guaraní → Paraguay
+    gu: 'in', // Gujarati → India
+    gv: 'im', // Manx → Isle of Man
+    ha: 'ng', // Hausa → Nigeria
+    ho: 'pg', // Hiri Motu → Papua New Guinea
+    hy: 'am', // Armenian → Armenia
+    hz: 'na', // Herero → Namibia
+    ie: 'ee', // Interlingue → Estonia
+    ig: 'ng', // Igbo → Nigeria
+    ii: 'cn', // Nuosu → China
+    ik: 'us', // Inupiaq → United States
+    iu: 'ca', // Inuktitut → Canada
+    jv: 'id', // Javanese → Indonesia
+    ka: 'ge', // Georgian → Georgia
+    kg: 'cd', // Kongo → Congo - Kinshasa
+    ki: 'ke', // Kikuyu → Kenya
+    kj: 'na', // Kwanyama → Namibia
+    kk: 'kz', // Kazakh → Kazakhstan
+    kl: 'gl', // Kalaallisut → Greenland
+    km: 'kh', // Khmer → Cambodia
+    kn: 'in', // Kannada → India
+    kr: 'ng', // Kanuri → Nigeria
+    ks: 'in', // Kashmiri → India
+    ku: 'tr', // Kurdish → Türkiye
+    kv: 'ru', // Komi → Russia
+    kw: 'gb', // Cornish → United Kingdom
+    ky: 'kg', // Kyrgyz → Kyrgyzstan
+    la: 'va', // Latin → Vatican City
+    lb: 'lu', // Luxembourgish → Luxembourg
+    lg: 'ug', // Ganda → Uganda
+    li: 'nl', // Limburgish → Netherlands
+    ln: 'cd', // Lingala → Congo - Kinshasa
+    lo: 'la', // Lao → Laos
+    lu: 'cd', // Luba-Katanga → Congo - Kinshasa
+    mi: 'nz', // Māori → New Zealand
+    ml: 'in', // Malayalam → India
+    mr: 'in', // Marathi → India
+    ms: 'my', // Malay → Malaysia
+    my: 'mm', // Burmese → Myanmar (Burma)
+    na: 'nr', // Nauru → Nauru
+    nb: 'no', // Norwegian Bokmål → Norway
+    nd: 'zw', // Northern Ndebele → Zimbabwe
+    ne: 'np', // Nepali → Nepal
+    ng: 'na', // Ndonga → Namibia
+    nn: 'no', // Norwegian Nynorsk → Norway
+    nr: 'za', // Southern Ndebele → South Africa
+    nv: 'us', // Navajo → United States
+    ny: 'mw', // Chichewa → Malawi
+    oc: 'fr', // Occitan → France
+    oj: 'ca', // Ojibwe → Canada
+    om: 'et', // Oromo → Ethiopia
+    or: 'in', // Oriya → India
+    os: 'ge', // Ossetian → Georgia
+    pa: 'in', // Panjabi → India
+    pi: 'gb', // Pāli → United Kingdom
+    ps: 'af', // Pashto → Afghanistan
+    qu: 'pe', // Quechua → Peru
+    rm: 'ch', // Romansh → Switzerland
+    rn: 'bi', // Kirundi → Burundi
+    sa: 'in', // Sanskrit → India
+    sc: 'it', // Sardinian → Italy
+    sd: 'pk', // Sindhi → Pakistan
+    se: 'no', // Northern Sami → Norway
+    sg: 'cf', // Sango → Central African Republic
+    si: 'lk', // Sinhala → Sri Lanka
+    sl: 'si', // Slovenian → Slovenia
+    sm: 'ws', // Samoan → Samoa
+    sn: 'zw', // Shona → Zimbabwe
+    sq: 'al', // Albanian → Albania
+    ss: 'za', // Swati → South Africa
+    st: 'za', // Southern Sotho → South Africa
+    su: 'id', // Sundanese → Indonesia
+    sw: 'tz', // Swahili → Tanzania
+    ta: 'in', // Tamil → India
+    te: 'in', // Telugu → India
+    tg: 'tj', // Tajik → Tajikistan
+    ti: 'et', // Tigrinya → Ethiopia
+    tk: 'tm', // Turkmen → Turkmenistan
+    tl: 'ph', // Tagalog → Philippines
+    tn: 'za', // Tswana → South Africa
+    ts: 'za', // Tsonga → South Africa
+    tt: 'ru', // Tatar → Russia
+    tw: 'gh', // Twi → Ghana
+    ty: 'pf', // Tahitian → French Polynesia
+    ug: 'cn', // Uyghur → China
+    ve: 'za', // Venda → South Africa
+    wa: 'be', // Walloon → Belgium
+    wo: 'sn', // Wolof → Senegal
+    xh: 'za', // Xhosa → South Africa
+    yi: 'ua', // Yiddish → Ukraine
+    yo: 'ng', // Yoruba → Nigeria
+    za: 'cn', // Zhuang → China
+    zu: 'za', // Zulu → South Africa
 };
 export function getCountryCodeFromLangCode(lang) {
     const [langCode, region] = String(lang).split('-');
@@ -87,6 +224,28 @@ export class I18nBase extends AdminForthPlugin {
     instanceUniqueRepresentation() {
         return 'single';
     }
+    // languages translations are written for: strings in source language are the keys themselves
+    targetLanguages() {
+        return this.options.supportedLanguages.filter((lang) => lang !== SOURCE_LANGUAGE);
+    }
+    // empty translation means "not translated yet", original string is shown instead
+    fallbackToOriginal(messages) {
+        return Object.fromEntries(Object.entries(messages).map(([key, value]) => [key, value || key]));
+    }
+    /**
+     * Translates backend strings (menu, resource labels, errors) with adminforth.tr,
+     * subclass provides only translation lookup in its storage for already resolved language
+     */
+    installBackendTranslator(adminforth, lookup) {
+        adminforth.tr = (msg, category, lang, params, pluralizationNumber) => __awaiter(this, void 0, void 0, function* () {
+            if (!msg) {
+                return msg;
+            }
+            const resolvedLang = this.resolveLanguage(lang);
+            const translation = yield lookup(msg, category, resolvedLang);
+            return this.formatTranslation(msg, translation || msg, resolvedLang, params, pluralizationNumber);
+        });
+    }
     // validate each supported language: ISO 639-1 or BCP-47 with region (e.g., en-GB)
     validateSupportedLanguages() {
         this.options.supportedLanguages.forEach((lang) => {
@@ -105,6 +264,7 @@ export class I18nBase extends AdminForthPlugin {
                 code: lang,
                 // lang name on on language native name
                 name: iso6391.getNativeName(getPrimaryLanguageCode(lang)),
+                countryCode: getCountryCodeFromLangCode(lang),
             }))
         };
         adminforth.config.customization.loginPageInjections.underLoginButton.push({