keycloakify 10.0.0-rc.10 → 10.0.0-rc.100

package/src/login/i18n/baseMessages/sk.ts

@@ -69,7 +69,7 @@ const messages= {
   "internal": "Interný ",
   "unknown": "Neznámy",
   "termsTitle": "Zmluvné podmienky",
-  "termsText": "<p>Zmluvné podmienky, ktoré sa majú definovať</p>",
+  "termsText": "",
   "termsPlainText": "Podmienky, ktoré sa majú definovať. ",
   "termsAcceptanceRequired": "Musíte súhlasiť s našimi podmienkami.",
   "acceptTerms": "Súhlasím s podmienkami",
@@ -437,7 +437,16 @@ const messages= {
   "logoutConfirmTitle": "Odhlásenie",
   "logoutConfirmHeader": "Chcete sa odhlásiť?",
   "doLogout": "Odhlásiť",
-  "readOnlyUsernameMessage": "Nemôžete aktualizovať svoje používateľské meno, pretože je iba na čítanie."
+  "readOnlyUsernameMessage": "Nemôžete aktualizovať svoje používateľské meno, pretože je iba na čítanie.",
+  "shouldBeEqual": "{0} by mal byť rovnaký ako {1}",
+  "shouldBeDifferent": "{0} by mal byť odlišný od {1}",
+  "shouldMatchPattern": "Vzor by mal zodpovedať: `/{0}/`",
+  "mustBeAnInteger": "Musí byť celé číslo",
+  "notAValidOption": "Nie je platná možnosť",
+  "selectAnOption": "Vyberte možnosť",
+  "remove": "Odstrániť",
+  "addValue": "Pridať hodnotu",
+  "languages": "Jazyky"
 };
 
 export default messages;

package/src/login/i18n/baseMessages/sv.ts

@@ -42,7 +42,7 @@ const messages= {
   "codeErrorTitle": "Felkod: {0}",
   "termsTitle": "Användarvillkor",
   "termsTitleHtml": "Användarvillkor",
-  "termsText": "<p>Användarvillkoren har ännu inte definierats</p>",
+  "termsText": "",
   "recaptchaFailed": "Ogiltig Recaptcha",
   "recaptchaNotConfigured": "Recaptcha krävs, men är inte inställd",
   "consentDenied": "Samtycke förnekat.",
@@ -191,7 +191,16 @@ const messages= {
   "clientDisabledMessage": "Klienten är inaktiverad.",
   "invalidParameterMessage": "Ogiltig parameter: {0}",
   "alreadyLoggedIn": "Du är redan inloggad.",
-  "loginAccountTitle": "Logga in till ditt konto"
+  "loginAccountTitle": "Logga in till ditt konto",
+  "shouldBeEqual": "{0} bör vara lika med {1}",
+  "shouldBeDifferent": "{0} bör vara annorlunda än {1}",
+  "shouldMatchPattern": "Mönstret bör matcha: `/{0}/`",
+  "mustBeAnInteger": "Måste vara ett heltal",
+  "notAValidOption": "Inte ett giltigt alternativ",
+  "selectAnOption": "Välj ett alternativ",
+  "remove": "Ta bort",
+  "addValue": "Lägg till värde",
+  "languages": "Språk"
 };
 
 export default messages;

package/src/login/i18n/baseMessages/th.ts

@@ -69,7 +69,7 @@ const messages= {
   "internal": "ภายใน",
   "unknown": "ไม่ทราบ",
   "termsTitle": "ข้อกำหนดและเงื่อนไข",
-  "termsText": "<p>ข้อกำหนดและเงื่อนไขที่จะกำหนด</p>",
+  "termsText": "",
   "termsPlainText": "ข้อกำหนดและเงื่อนไขที่จะกำหนด",
   "termsAcceptanceRequired": "คุณต้องยอมรับข้อกำหนดและเงื่อนไขของเรา",
   "acceptTerms": "ฉันยอมรับข้อกำหนดและเงื่อนไข",
@@ -433,7 +433,16 @@ const messages= {
   "logoutConfirmTitle": "กำลังออกจากระบบ",
   "logoutConfirmHeader": "คุณต้องการออกจากระบบหรือไม่?",
   "doLogout": "ออกจากระบบ",
-  "readOnlyUsernameMessage": "คุณไม่สามารถปรับปรุงชื่อผู้ใช้งานของคุณเนื่องจากเป็นข้อมูลแบบอ่านอย่างเดียว"
+  "readOnlyUsernameMessage": "คุณไม่สามารถปรับปรุงชื่อผู้ใช้งานของคุณเนื่องจากเป็นข้อมูลแบบอ่านอย่างเดียว",
+  "shouldBeEqual": "{0} ควรเท่ากับ {1}",
+  "shouldBeDifferent": "{0} ควรแตกต่างจาก {1}",
+  "shouldMatchPattern": "รูปแบบควรตรงกับ: `/{0}/`",
+  "mustBeAnInteger": "ต้องเป็นจำนวนเต็ม",
+  "notAValidOption": "ไม่ใช่ตัวเลือกที่ถูกต้อง",
+  "selectAnOption": "เลือกตัวเลือก",
+  "remove": "ลบ",
+  "addValue": "เพิ่มค่า",
+  "languages": "ภาษา"
 };
 
 export default messages;

package/src/login/i18n/baseMessages/tr.ts

@@ -46,7 +46,7 @@ const messages= {
   "browserContinuePrompt": "Tarayıcı aç ve girişe devam et? [e/h]:",
   "browserContinueAnswer": "h",
   "termsTitle": "Şartlar ve koşullar",
-  "termsText": "<p>Tanımlanacak şartlar ve koşullar</p>",
+  "termsText": "",
   "termsPlainText": "Tanımlanacak şartlar ve koşullar.",
   "recaptchaFailed": "Geçersiz Recaptcha",
   "recaptchaNotConfigured": "Recaptcha gerekli, ancak yapılandırılmamış",
@@ -260,7 +260,16 @@ const messages= {
   "console-email-code": "E-posta Kodu:",
   "console-accept-terms": "Şartları kabul et? [e/h]:",
   "console-accept": "e",
-  "readOnlyUsernameMessage": "Yazma korumalı olduğundan kullanıcı adınızı değiştiremezsiniz."
+  "readOnlyUsernameMessage": "Yazma korumalı olduğundan kullanıcı adınızı değiştiremezsiniz.",
+  "shouldBeEqual": "{0} {1} eşit olmalıdır",
+  "shouldBeDifferent": "{0} {1} farklı olmalıdır",
+  "shouldMatchPattern": "Desen eşleşmelidir: `/{0}/`",
+  "mustBeAnInteger": "Tam sayı olmalıdır",
+  "notAValidOption": "Geçerli bir seçenek değil",
+  "selectAnOption": "Bir seçenek seçin",
+  "remove": "Kaldır",
+  "addValue": "Değer ekle",
+  "languages": "Diller"
 };
 
 export default messages;

package/src/login/i18n/baseMessages/uk.ts

@@ -64,7 +64,7 @@ const messages= {
   "browserContinuePrompt": "Відкрити браузер і продовжити вхід? [y/n]:",
   "browserContinueAnswer": "y",
   "termsTitle": "Умови",
-  "termsText": "<p>Положення та умови повинні бути визначені</p>",
+  "termsText": "",
   "termsPlainText": "Положення та умови, які будуть визначені.",
   "termsAcceptanceRequired": "Ви повинні погодитися з умовами.",
   "acceptTerms": "Я погоджуюсь з умовами",
@@ -432,7 +432,16 @@ const messages= {
   "logoutConfirmTitle": "Вихід",
   "logoutConfirmHeader": "Ви бажаєте вийти?",
   "doLogout": "Вийти",
-  "readOnlyUsernameMessage": "Ви не можете оновити своє ім'я користувача, оскільки воно доступне лише для читання."
+  "readOnlyUsernameMessage": "Ви не можете оновити своє ім'я користувача, оскільки воно доступне лише для читання.",
+  "shouldBeEqual": "{0} повинно бути рівним {1}",
+  "shouldBeDifferent": "{0} повинно відрізнятися від {1}",
+  "shouldMatchPattern": "Шаблон повинен відповідати: `/{0}/`",
+  "mustBeAnInteger": "Повинно бути цілим числом",
+  "notAValidOption": "Не є дійсною опцією",
+  "selectAnOption": "Виберіть опцію",
+  "remove": "Видалити",
+  "addValue": "Додати значення",
+  "languages": "Мови"
 };
 
 export default messages;

package/src/login/i18n/baseMessages/zh-CN.ts

@@ -69,7 +69,7 @@ const messages= {
   "internal": "内部",
   "unknown": "未知",
   "termsTitle": "条款",
-  "termsText": "<p>需要确定的条款</p>",
+  "termsText": "",
   "termsPlainText": "需要确定的条款。",
   "termsAcceptanceRequired": "您必须同意我们的的服务条款。",
   "acceptTerms": "我同意服务条款",
@@ -346,7 +346,7 @@ const messages= {
   "locale_nl": "Nederlands",
   "locale_no": "Norsk",
   "locale_pl": "Polski",
-  "locale_pt_BR": "Português (Brasil)",
+  "locale_pt-BR": "Português (Brasil)",
   "locale_ru": "Русский",
   "locale_sk": "Slovenčina",
   "locale_sv": "Svenska",
@@ -461,7 +461,16 @@ const messages= {
   "logoutConfirmTitle": "注销",
   "logoutConfirmHeader": "您确定要注销吗？",
   "doLogout": "注销",
-  "readOnlyUsernameMessage": "由于用户名是只读的，您无法更新用户名。"
+  "readOnlyUsernameMessage": "由于用户名是只读的，您无法更新用户名。",
+  "shouldBeEqual": "{0} 应该等于 {1}",
+  "shouldBeDifferent": "{0} 应该不同于 {1}",
+  "shouldMatchPattern": "模式应匹配: `/{0}/`",
+  "mustBeAnInteger": "必须是整数",
+  "notAValidOption": "不是有效选项",
+  "selectAnOption": "选择一个选项",
+  "remove": "移除",
+  "addValue": "添加值",
+  "languages": "语言"
 };
 
 export default messages;

package/src/login/i18n/i18n.tsx

@@ -1,24 +1,24 @@
-import "minimal-polyfills/Object.fromEntries";
-//NOTE for later: https://github.com/remarkjs/react-markdown/blob/236182ecf30bd89c1e5a7652acaf8d0bf81e6170/src/renderers.js#L7-L35
-import { useEffect, useState, useRef } from "react";
-import fallbackMessages from "./baseMessages/en";
-import { getMessages } from "./baseMessages";
+import "keycloakify/tools/Object.fromEntries";
 import { assert } from "tsafe/assert";
-import type { KcContext } from "../kcContext/KcContext";
-import { Markdown } from "keycloakify/tools/Markdown";
-
-export const fallbackLanguageTag = "en";
+import messages_fallbackLanguage from "./baseMessages/en";
+import { getMessages } from "./baseMessages";
+import type { KcContext } from "../KcContext";
+import { fallbackLanguageTag } from "keycloakify/bin/shared/constants";
 
 export type KcContextLike = {
     locale?: {
         currentLanguageTag: string;
         supported: { languageTag: string; url: string; label: string }[];
     };
+    "x-keycloakify": {
+        realmMessageBundleUserProfile: Record<string, string> | undefined;
+        realmMessageBundleTermsText: string | undefined;
+    };
 };
 
 assert<KcContext extends KcContextLike ? true : false>();
 
-export type MessageKey = keyof typeof fallbackMessages | keyof (typeof keycloakifyExtraMessages)[typeof fallbackLanguageTag];
+export type MessageKey = keyof typeof messages_fallbackLanguage;
 
 export type GenericI18n<MessageKey extends string> = {
     /**
@@ -31,7 +31,7 @@ export type GenericI18n<MessageKey extends string> = {
      * Redirect to this url to change the language.
      * After reload currentLanguageTag === newLanguageTag
      */
-    getChangeLocalUrl: (newLanguageTag: string) => string;
+    getChangeLocaleUrl: (newLanguageTag: string) => string;
     /**
      * e.g. "en" => "English", "fr" => "Français", ...
      *
@@ -53,180 +53,275 @@ export type GenericI18n<MessageKey extends string> = {
      */
     msgStr: (key: MessageKey, ...args: (string | undefined)[]) => string;
     /**
+     * This is meant to be used when the key argument is variable, something that might have been configured by the user
+     * in the Keycloak admin for example.
+     *
      * Examples assuming currentLanguageTag === "en"
-     * advancedMsg("${access-denied} foo bar") === <span>${msgStr("access-denied")} foo bar<span> === <span>Access denied foo bar</span>
+     * {
+     *   en: {
+     *     "access-denied": "Access denied",
+     *     "foo": "Foo {0} {1}",
+     *     "bar": "Bar {0}"
+     *   }
+     * }
+     *
+     * advancedMsg("${access-denied} foo bar") === <span>{msgStr("access-denied")} foo bar<span> === <span>Access denied foo bar</span>
      * advancedMsg("${access-denied}") === advancedMsg("access-denied") === msg("access-denied") === <span>Access denied</span>
      * advancedMsg("${not-a-message-key}") === advancedMsg(not-a-message-key") === <span>not-a-message-key</span>
+     * advancedMsg("${bar}", "<strong>c</strong>")
+     *    === <span>{msgStr("bar", "<strong>XXX</strong>")}<span>
+     *    === <span>Bar &lt;strong&gt;XXX&lt;/strong&gt;</span> (The html in the arg is partially escaped for security reasons, it might be untrusted)
+     * advancedMsg("${foo} xx ${bar}", "a", "b", "c")
+     *    === <span>{msgStr("foo", "a", "b")} xx {msgStr("bar")}<span>
+     *    === <span>Foo a b xx Bar {0}</span> (The substitution are only applied in the first message)
      */
     advancedMsg: (key: string, ...args: (string | undefined)[]) => JSX.Element;
     /**
-     * Examples assuming currentLanguageTag === "en"
-     * advancedMsg("${access-denied} foo bar") === msg("access-denied") + " foo bar" === "Access denied foo bar"
-     * advancedMsg("${not-a-message-key}") === advancedMsg(not-a-message-key") === "not-a-message-key"
+     * See advancedMsg() but instead of returning a JSX.Element it returns a string.
      */
     advancedMsgStr: (key: string, ...args: (string | undefined)[]) => string;
-};
 
-export type I18n = GenericI18n<MessageKey>;
+    /**
+     * Initially the messages are in english (fallback language).
+     * The translations in the current language are being fetched dynamically.
+     * This property is true while the translations are being fetched.
+     */
+    isFetchingTranslations: boolean;
+};
 
-export function createUseI18n<ExtraMessageKey extends string = never>(extraMessages: {
+export function createGetI18n<ExtraMessageKey extends string = never>(messageBundle: {
     [languageTag: string]: { [key in ExtraMessageKey]: string };
 }) {
-    function useI18n(params: { kcContext: KcContextLike }): GenericI18n<MessageKey | ExtraMessageKey> | null {
-        const { kcContext } = params;
+    type I18n = GenericI18n<MessageKey | ExtraMessageKey>;
 
-        const [i18n, setI18n] = useState<GenericI18n<ExtraMessageKey | MessageKey> | undefined>(undefined);
+    type Result = { i18n: I18n; prI18n_currentLanguage: Promise<I18n> | undefined };
+
+    const cachedResultByKcContext = new WeakMap<KcContextLike, Result>();
+
+    function getI18n(params: { kcContext: KcContextLike }): Result {
+        const { kcContext } = params;
 
-        const refHasStartedFetching = useRef(false);
+        use_cache: {
+            const cachedResult = cachedResultByKcContext.get(kcContext);
 
-        useEffect(() => {
-            if (refHasStartedFetching.current) {
-                return;
+            if (cachedResult === undefined) {
+                break use_cache;
             }
 
-            refHasStartedFetching.current = true;
-
-            (async () => {
-                const { currentLanguageTag = fallbackLanguageTag } = kcContext.locale ?? {};
-
-                setI18n({
-                    ...createI18nTranslationFunctions({
-                        "fallbackMessages": {
-                            ...fallbackMessages,
-                            ...(keycloakifyExtraMessages[fallbackLanguageTag] ?? {}),
-                            ...(extraMessages[fallbackLanguageTag] ?? {})
-                        } as any,
-                        "messages": {
-                            ...(await getMessages(currentLanguageTag)),
-                            ...((keycloakifyExtraMessages as any)[currentLanguageTag] ?? {}),
-                            ...(extraMessages[currentLanguageTag] ?? {})
-                        } as any
-                    }),
-                    currentLanguageTag,
-                    "getChangeLocalUrl": newLanguageTag => {
-                        const { locale } = kcContext;
-
-                        assert(locale !== undefined, "Internationalization not enabled");
-
-                        const targetSupportedLocale = locale.supported.find(({ languageTag }) => languageTag === newLanguageTag);
-
-                        assert(targetSupportedLocale !== undefined, `${newLanguageTag} need to be enabled in Keycloak admin`);
-
-                        return targetSupportedLocale.url;
-                    },
-                    "labelBySupportedLanguageTag": Object.fromEntries(
-                        (kcContext.locale?.supported ?? []).map(({ languageTag, label }) => [languageTag, label])
-                    )
-                });
-            })();
-        }, []);
+            return cachedResult;
+        }
+
+        const partialI18n: Pick<I18n, "currentLanguageTag" | "getChangeLocaleUrl" | "labelBySupportedLanguageTag"> = {
+            currentLanguageTag: kcContext.locale?.currentLanguageTag ?? fallbackLanguageTag,
+            getChangeLocaleUrl: newLanguageTag => {
+                const { locale } = kcContext;
+
+                assert(locale !== undefined, "Internationalization not enabled");
+
+                const targetSupportedLocale = locale.supported.find(({ languageTag }) => languageTag === newLanguageTag);
+
+                assert(targetSupportedLocale !== undefined, `${newLanguageTag} need to be enabled in Keycloak admin`);
+
+                return targetSupportedLocale.url;
+            },
+            labelBySupportedLanguageTag: Object.fromEntries((kcContext.locale?.supported ?? []).map(({ languageTag, label }) => [languageTag, label]))
+        };
 
-        return i18n ?? null;
+        const { createI18nTranslationFunctions } = createI18nTranslationFunctionsFactory<MessageKey, ExtraMessageKey>({
+            messages_fallbackLanguage,
+            messageBundle_fallbackLanguage: messageBundle[fallbackLanguageTag],
+            messageBundle_currentLanguage: messageBundle[partialI18n.currentLanguageTag],
+            realmMessageBundleUserProfile: kcContext["x-keycloakify"].realmMessageBundleUserProfile,
+            realmMessageBundleTermsText: kcContext["x-keycloakify"].realmMessageBundleTermsText
+        });
+
+        const isCurrentLanguageFallbackLanguage = partialI18n.currentLanguageTag === fallbackLanguageTag;
+
+        const result: Result = {
+            i18n: {
+                ...partialI18n,
+                ...createI18nTranslationFunctions({
+                    messages_currentLanguage: isCurrentLanguageFallbackLanguage ? messages_fallbackLanguage : undefined
+                }),
+                isFetchingTranslations: !isCurrentLanguageFallbackLanguage
+            },
+            prI18n_currentLanguage: isCurrentLanguageFallbackLanguage
+                ? undefined
+                : (async () => {
+                      const messages_currentLanguage = await getMessages(partialI18n.currentLanguageTag);
+
+                      const i18n_currentLanguage: I18n = {
+                          ...partialI18n,
+                          ...createI18nTranslationFunctions({ messages_currentLanguage }),
+                          isFetchingTranslations: false
+                      };
+
+                      // NOTE: This promise.resolve is just because without it we TypeScript
+                      // gives a Variable 'result' is used before being assigned. error
+                      await Promise.resolve().then(() => {
+                          result.i18n = i18n_currentLanguage;
+                          result.prI18n_currentLanguage = undefined;
+                      });
+
+                      return i18n_currentLanguage;
+                  })()
+        };
+
+        cachedResultByKcContext.set(kcContext, result);
+
+        return result;
     }
 
-    return { useI18n };
+    return { getI18n };
 }
 
-function createI18nTranslationFunctions<MessageKey extends string>(params: {
-    fallbackMessages: Record<MessageKey, string>;
-    messages: Record<MessageKey, string>;
-}): Pick<GenericI18n<MessageKey>, "msg" | "msgStr" | "advancedMsg" | "advancedMsgStr"> {
-    const { fallbackMessages, messages } = params;
+function createI18nTranslationFunctionsFactory<MessageKey extends string, ExtraMessageKey extends string>(params: {
+    messages_fallbackLanguage: Record<MessageKey, string>;
+    messageBundle_fallbackLanguage: Record<ExtraMessageKey, string> | undefined;
+    messageBundle_currentLanguage: Partial<Record<ExtraMessageKey, string>> | undefined;
+    realmMessageBundleUserProfile: Record<string, string> | undefined;
+    realmMessageBundleTermsText: string | undefined;
+}) {
+    const { messageBundle_currentLanguage, realmMessageBundleUserProfile, realmMessageBundleTermsText } = params;
 
-    function resolveMsg(props: { key: string; args: (string | undefined)[]; doRenderMarkdown: boolean }): string | JSX.Element | undefined {
-        const { key, args, doRenderMarkdown } = props;
+    const messages_fallbackLanguage = {
+        ...params.messages_fallbackLanguage,
+        ...params.messageBundle_fallbackLanguage
+    };
 
-        const messageOrUndefined: string | undefined = (messages as any)[key] ?? (fallbackMessages as any)[key];
+    function createI18nTranslationFunctions(params: {
+        messages_currentLanguage: Partial<Record<MessageKey, string>> | undefined;
+    }): Pick<GenericI18n<MessageKey | ExtraMessageKey>, "msg" | "msgStr" | "advancedMsg" | "advancedMsgStr"> {
+        const messages_currentLanguage = {
+            ...params.messages_currentLanguage,
+            ...messageBundle_currentLanguage
+        };
 
-        if (messageOrUndefined === undefined) {
-            return undefined;
-        }
+        function resolveMsg(props: { key: string; args: (string | undefined)[]; doRenderAsHtml: boolean }): string | JSX.Element | undefined {
+            const { key, args, doRenderAsHtml } = props;
+
+            const messageOrUndefined: string | undefined = (() => {
+                const messageOrUndefined = (messages_currentLanguage as any)[key] ?? (messages_fallbackLanguage as any)[key];
 
-        const message = messageOrUndefined;
+                if (key === "termsText" && realmMessageBundleTermsText !== undefined) {
+                    return realmMessageBundleTermsText;
+                }
 
-        const messageWithArgsInjectedIfAny = (() => {
-            const startIndex = message
-                .match(/{[0-9]+}/g)
-                ?.map(g => g.match(/{([0-9]+)}/)![1])
-                .map(indexStr => parseInt(indexStr))
-                .sort((a, b) => a - b)[0];
+                return messageOrUndefined;
+            })();
 
-            if (startIndex === undefined) {
-                // No {0} in message (no arguments expected)
-                return message;
+            if (messageOrUndefined === undefined) {
+                return undefined;
             }
 
-            let messageWithArgsInjected = message;
+            const message = messageOrUndefined;
+
+            const messageWithArgsInjectedIfAny = (() => {
+                const startIndex = message
+                    .match(/{[0-9]+}/g)
+                    ?.map(g => g.match(/{([0-9]+)}/)![1])
+                    .map(indexStr => parseInt(indexStr))
+                    .sort((a, b) => a - b)[0];
 
-            args.forEach((arg, i) => {
-                if (arg === undefined) {
-                    return;
+                if (startIndex === undefined) {
+                    // No {0} in message (no arguments expected)
+                    return message;
                 }
 
-                messageWithArgsInjected = messageWithArgsInjected.replace(new RegExp(`\\{${i + startIndex}\\}`, "g"), arg);
-            });
+                let messageWithArgsInjected = message;
 
-            return messageWithArgsInjected;
-        })();
+                args.forEach((arg, i) => {
+                    if (arg === undefined) {
+                        return;
+                    }
 
-        return doRenderMarkdown ? (
-            <Markdown allowDangerousHtml renderers={{ "paragraph": "span" }}>
-                {messageWithArgsInjectedIfAny}
-            </Markdown>
-        ) : (
-            messageWithArgsInjectedIfAny
-        );
-    }
+                    messageWithArgsInjected = messageWithArgsInjected.replace(
+                        new RegExp(`\\{${i + startIndex}\\}`, "g"),
+                        arg.replace(/</g, "&lt;").replace(/>/g, "&gt;")
+                    );
+                });
 
-    function resolveMsgAdvanced(props: { key: string; args: (string | undefined)[]; doRenderMarkdown: boolean }): JSX.Element | string {
-        const { key, args, doRenderMarkdown } = props;
+                return messageWithArgsInjected;
+            })();
 
-        const match = key.match(/^\$\{([^{]+)\}$/);
+            return doRenderAsHtml ? (
+                <span
+                    // NOTE: The message is trusted. The arguments are not but are escaped.
+                    dangerouslySetInnerHTML={{
+                        __html: messageWithArgsInjectedIfAny
+                    }}
+                />
+            ) : (
+                messageWithArgsInjectedIfAny
+            );
+        }
 
-        const keyUnwrappedFromCurlyBraces = match === null ? key : match[1];
+        function resolveMsgAdvanced(props: { key: string; args: (string | undefined)[]; doRenderAsHtml: boolean }): JSX.Element | string {
+            const { key, args, doRenderAsHtml } = props;
 
-        const out = resolveMsg({
-            "key": keyUnwrappedFromCurlyBraces,
-            args,
-            doRenderMarkdown
-        });
+            user_profile: {
+                if (realmMessageBundleUserProfile === undefined) {
+                    break user_profile;
+                }
 
-        return (out !== undefined ? out : doRenderMarkdown ? <span>{keyUnwrappedFromCurlyBraces}</span> : keyUnwrappedFromCurlyBraces) as any;
-    }
+                const resolvedMessage = realmMessageBundleUserProfile[key] ?? realmMessageBundleUserProfile["${" + key + "}"];
 
-    return {
-        "msgStr": (key, ...args) => resolveMsg({ key, args, "doRenderMarkdown": false }) as string,
-        "msg": (key, ...args) => resolveMsg({ key, args, "doRenderMarkdown": true }) as JSX.Element,
-        "advancedMsg": (key, ...args) => resolveMsgAdvanced({ key, args, "doRenderMarkdown": true }) as JSX.Element,
-        "advancedMsgStr": (key, ...args) => resolveMsgAdvanced({ key, args, "doRenderMarkdown": false }) as string
-    };
-}
+                if (resolvedMessage === undefined) {
+                    break user_profile;
+                }
+
+                return doRenderAsHtml ? (
+                    <span
+                        // NOTE: The message is trusted. The arguments are not but are escaped.
+                        dangerouslySetInnerHTML={{
+                            __html: resolvedMessage
+                        }}
+                    />
+                ) : (
+                    resolvedMessage
+                );
+            }
 
-const keycloakifyExtraMessages = {
-    "en": {
-        "shouldBeEqual": "{0} should be equal to {1}",
-        "shouldBeDifferent": "{0} should be different to {1}",
-        "shouldMatchPattern": "Pattern should match: `/{0}/`",
-        "mustBeAnInteger": "Must be an integer",
-        "notAValidOption": "Not a valid option",
-        "selectAnOption": "Select an option",
-        "remove": "Remove",
-        "addValue": "Add value"
-    },
-    "fr": {
-        /* spell-checker: disable */
-        "shouldBeEqual": "{0} doit être égal à {1}",
-        "shouldBeDifferent": "{0} doit être différent de {1}",
-        "shouldMatchPattern": "Dois respecter le schéma: `/{0}/`",
-        "mustBeAnInteger": "Doit être un nombre entier",
-        "notAValidOption": "N'est pas une option valide",
-
-        "logoutConfirmTitle": "Déconnexion",
-        "logoutConfirmHeader": "Êtes-vous sûr(e) de vouloir vous déconnecter ?",
-        "doLogout": "Se déconnecter",
-        "selectAnOption": "Sélectionner une option",
-        "remove": "Supprimer",
-        "addValue": "Ajouter une valeur"
-        /* spell-checker: enable */
+            if (!/\$\{[^}]+\}/.test(key)) {
+                const resolvedMessage = resolveMsg({ key, args, doRenderAsHtml });
+
+                if (resolvedMessage === undefined) {
+                    return doRenderAsHtml ? <span dangerouslySetInnerHTML={{ __html: key }} /> : key;
+                }
+
+                return resolvedMessage;
+            }
+
+            let isFirstMatch = true;
+
+            const resolvedComplexMessage = key.replace(/\$\{([^}]+)\}/g, (...[, key_i]) => {
+                const replaceBy = resolveMsg({ key: key_i, args: isFirstMatch ? args : [], doRenderAsHtml: false }) ?? key_i;
+
+                isFirstMatch = false;
+
+                return replaceBy;
+            });
+
+            return doRenderAsHtml ? <span dangerouslySetInnerHTML={{ __html: resolvedComplexMessage }} /> : resolvedComplexMessage;
+        }
+
+        return {
+            msgStr: (key, ...args) => resolveMsg({ key, args, doRenderAsHtml: false }) as string,
+            msg: (key, ...args) => resolveMsg({ key, args, doRenderAsHtml: true }) as JSX.Element,
+            advancedMsg: (key, ...args) =>
+                resolveMsgAdvanced({
+                    key,
+                    args,
+                    doRenderAsHtml: true
+                }) as JSX.Element,
+            advancedMsgStr: (key, ...args) =>
+                resolveMsgAdvanced({
+                    key,
+                    args,
+                    doRenderAsHtml: false
+                }) as string
+        };
     }
-};
+
+    return { createI18nTranslationFunctions };
+}

package/src/login/i18n/index.ts

@@ -1 +1,4 @@
-export type { I18n } from "./i18n";
+import type { GenericI18n, MessageKey, KcContextLike } from "./i18n";
+export type { MessageKey, KcContextLike };
+export type I18n = GenericI18n<MessageKey>;
+export { createUseI18n } from "./useI18n";