@worldcoin/idkit 2.3.0 → 2.4.1

package/build/index.js

@@ -1,8 +1,12 @@
 import {
   QRCode_default,
   __,
-  idkit_default
-} from "./chunk-3HCETHXP.js";
+  getCurrentLanguage,
+  getLocalizationConfig,
+  getSupportedLanguages,
+  idkit_default,
+  setLocalizationConfig
+} from "./chunk-PWFTYFSZ.js";
 
 // src/hooks/useIDKit.ts
 import { useEffect } from "react";
@@ -30,13 +34,13 @@ import { useEffect as useEffect2, useState } from "react";
 var useMedia = () => {
   const getInitialState = () => {
     if (typeof window !== "undefined") {
-      return window.matchMedia("(max-width: 768px)").matches ? "mobile" : "desktop";
+      return window.matchMedia("(max-width: 1024px)").matches ? "mobile" : "desktop";
     }
     return "desktop";
   };
   const [media, setMedia] = useState(getInitialState());
   useEffect2(() => {
-    const mql = window.matchMedia("(max-width: 768px)");
+    const mql = window.matchMedia("(max-width: 1024px)");
     const handleChange = (mql2) => setMedia(mql2.matches ? "mobile" : "desktop");
     handleChange(mql);
     mql.addEventListener("change", handleChange);
@@ -1314,6 +1318,9 @@ input[type='number']::-webkit-inner-spin-button,
   .md\\:mt-2 {
     margin-top: 8px;
   }
+  .md\\:block {
+    display: block;
+  }
   .md\\:hidden {
     display: none;
   }
@@ -1340,6 +1347,14 @@ input[type='number']::-webkit-inner-spin-button,
     padding: 16px;
   }
 }
+@media (min-width: 1280px) {
+  .xl\\:block {
+    display: block;
+  }
+  .xl\\:hidden {
+    display: none;
+  }
+}
 `;
 
 // src/components/Styles.tsx
@@ -1504,25 +1519,36 @@ var WarningIcon_default = WarningIcon;
 // src/components/IDKitWidget/States/ErrorState.tsx
 import { jsx as jsx6, jsxs as jsxs3 } from "react/jsx-runtime";
 var getParams = ({ retryFlow, errorState }) => ({ retryFlow, errorState });
-var ERROR_TITLES = {
-  [AppErrorCodes.GenericError]: __("Something went wrong"),
-  [AppErrorCodes.FailedByHostApp]: __("Verification Declined"),
-  [AppErrorCodes.VerificationRejected]: __("Request cancelled")
+var getErrorTitle = (code) => {
+  switch (code) {
+    case AppErrorCodes.GenericError:
+      return __("Something went wrong");
+    case AppErrorCodes.FailedByHostApp:
+      return __("Verification Declined");
+    case AppErrorCodes.VerificationRejected:
+      return __("Request cancelled");
+    default:
+      return __("Something went wrong");
+  }
 };
-var ERROR_MESSAGES = {
-  [AppErrorCodes.ConnectionFailed]: __("Connection to your wallet failed. Please try again."),
-  [AppErrorCodes.VerificationRejected]: __("You\u2019ve cancelled the request in World App."),
-  [AppErrorCodes.MaxVerificationsReached]: __(
-    "You have already verified the maximum number of times for this action."
-  ),
-  [AppErrorCodes.CredentialUnavailable]: __("It seems you do not have the verification level required by this app."),
-  [AppErrorCodes.InvalidNetwork]: __(
-    "Invalid network. If you are the app owner, visit docs.world.org/test for details."
-  ),
-  [AppErrorCodes.InclusionProofPending]: __(
-    "Your identity is still being registered. Please wait a few minutes and try again."
-  ),
-  [AppErrorCodes.GenericError]: __("We couldn't complete your request. Please try again.")
+var getErrorMessage = (code) => {
+  switch (code) {
+    case AppErrorCodes.ConnectionFailed:
+      return __("Connection to your wallet failed. Please try again.");
+    case AppErrorCodes.VerificationRejected:
+      return __("You've cancelled the request in World App.");
+    case AppErrorCodes.MaxVerificationsReached:
+      return __("You've already verified the maximum number of times for this action.");
+    case AppErrorCodes.CredentialUnavailable:
+      return __("It seems you don't have the verification level required by this app.");
+    case AppErrorCodes.InvalidNetwork:
+      return __("Invalid network. If you are the app owner, visit docs.world.org/test for details.");
+    case AppErrorCodes.InclusionProofPending:
+      return __("Your identity is still being registered. Please wait a few minutes and try again.");
+    case AppErrorCodes.GenericError:
+    default:
+      return __("We couldn't complete your request. Please try again.");
+  }
 };
 var ErrorState = (props) => {
   const { retryFlow, errorState } = idkit_default(getParams);
@@ -1535,8 +1561,8 @@ var ErrorState = (props) => {
   return /* @__PURE__ */ jsxs3("div", { className: "space-y-8", children: [
     /* @__PURE__ */ jsx6("div", { className: clsx_default("flex items-center justify-center", show_modal ? "-mt-5" : ""), children: errorState?.code == AppErrorCodes.VerificationRejected ? /* @__PURE__ */ jsx6(WarningIcon_default, { className: "w-24" }) : /* @__PURE__ */ jsx6(ErrorIcon_default, { className: "w-24" }) }),
     /* @__PURE__ */ jsxs3("div", { children: [
-      /* @__PURE__ */ jsx6("p", { className: "text-center text-2xl font-semibold text-gray-900 dark:text-white", children: (errorState?.code && ERROR_TITLES[errorState.code]) ?? ERROR_TITLES[AppErrorCodes.GenericError] }),
-      /* @__PURE__ */ jsx6("p", { className: "mx-auto mt-2 max-w-[224px] text-center text-657080", children: (errorState?.code && ERROR_MESSAGES[errorState.code]) ?? ERROR_MESSAGES[AppErrorCodes.GenericError] })
+      /* @__PURE__ */ jsx6("p", { className: "text-center text-2xl font-semibold text-gray-900 dark:text-white", children: errorState?.code ? getErrorTitle(errorState.code) : getErrorTitle(AppErrorCodes.GenericError) }),
+      /* @__PURE__ */ jsx6("p", { className: "mx-auto mt-2 max-w-[224px] text-center text-657080", children: errorState?.code ? getErrorMessage(errorState.code) : getErrorMessage(AppErrorCodes.GenericError) })
     ] }),
     /* @__PURE__ */ jsx6("div", { className: "flex justify-center", children: /* @__PURE__ */ jsx6(
       "button",
@@ -1748,15 +1774,22 @@ var QRState = ({ qrData, showQR, setShowQR }) => {
     setTimeout(() => setCopiedLink(false), 2e3);
   }, [qrData]);
   return /* @__PURE__ */ jsxs7(Fragment, { children: [
-    /* @__PURE__ */ jsxs7("div", { className: clsx_default("md:hidden", { "mb-10 space-y-4": !showQR }), children: [
+    /* @__PURE__ */ jsx11("div", { className: "md:hidden", children: /* @__PURE__ */ jsxs7(
+      "a",
+      {
+        href: qrData ?? "",
+        className: "flex w-full items-center space-x-2 rounded-2xl border border-transparent p-4 font-medium shadow-sm bg-0d151d text-white dark:bg-white dark:text-0d151d",
+        children: [
+          /* @__PURE__ */ jsx11(WorldcoinIcon_default, { className: "size-5" }),
+          /* @__PURE__ */ jsx11("span", { className: "flex-1 text-center", children: __("Open World App") })
+        ]
+      }
+    ) }),
+    /* @__PURE__ */ jsxs7("div", { className: clsx_default("hidden md:block xl:hidden", { "mb-10 space-y-4": !showQR }), children: [
       /* @__PURE__ */ jsxs7(
-        motion.a,
+        "a",
         {
           href: qrData ?? "",
-          whileTap: { scale: 0.95 },
-          whileHover: { scale: 1.05 },
-          transition: { layout: { duration: 0.15 } },
-          layoutId: media == "desktop" ? void 0 : "worldid-button",
           className: clsx_default(
             "flex w-full items-center space-x-2 rounded-2xl border border-transparent p-4 font-medium shadow-sm",
             "bg-0d151d text-white dark:bg-white dark:text-0d151d",
@@ -1764,20 +1797,12 @@ var QRState = ({ qrData, showQR, setShowQR }) => {
           ),
           children: [
             /* @__PURE__ */ jsx11(WorldcoinIcon_default, { className: "size-5" }),
-            /* @__PURE__ */ jsx11(
-              motion.span,
-              {
-                className: "flex-1 text-center",
-                transition: { layout: { duration: 0.15 } },
-                layoutId: media == "desktop" ? void 0 : "worldid-text",
-                children: __("Open World App")
-              }
-            )
+            /* @__PURE__ */ jsx11("span", { className: "flex-1 text-center", children: __("Open World App") })
           ]
         }
       ),
-      /* @__PURE__ */ jsxs7("div", { className: clsx_default("mb-3", { "space-y-4": !showQR, hidden: media === "mobile" }), children: [
-        /* @__PURE__ */ jsxs7("div", { className: clsx_default("flex items-center space-x-4 ", { hidden: showQR }), children: [
+      /* @__PURE__ */ jsxs7("div", { className: clsx_default("mb-3 space-y-4", { hidden: showQR }), children: [
+        /* @__PURE__ */ jsxs7("div", { className: "flex items-center space-x-4", children: [
           /* @__PURE__ */ jsx11("hr", { className: "flex-1" }),
           /* @__PURE__ */ jsx11("span", { className: "text-xs font-medium text-9ba3ae", children: "or" }),
           /* @__PURE__ */ jsx11("hr", { className: "flex-1" })
@@ -1787,12 +1812,61 @@ var QRState = ({ qrData, showQR, setShowQR }) => {
           {
             className: "w-full rounded-2xl border border-ebecef p-4 text-lg font-medium text-3c424b",
             onClick: () => setShowQR((state) => !state),
-            children: showQR ? __("Hide QR Code") : __("Display QR Code")
+            children: __("Display QR Code")
           }
         )
       ] })
     ] }),
-    (media == "desktop" || showQR) && /* @__PURE__ */ jsxs7(Fragment, { children: [
+    showQR && /* @__PURE__ */ jsxs7("div", { className: "hidden md:block xl:hidden", children: [
+      /* @__PURE__ */ jsx11("div", { className: "mb-4", children: /* @__PURE__ */ jsx11(
+        motion.button,
+        {
+          className: "w-full rounded-2xl border border-ebecef p-4 text-lg font-medium text-3c424b",
+          onClick: () => setShowQR(false),
+          children: __("Hide QR Code")
+        }
+      ) }),
+      /* @__PURE__ */ jsx11("div", { className: "relative inline-flex items-center justify-center rounded-2xl border border-f1f5f8 p-3 dark:border-f1f5f8/10", children: /* @__PURE__ */ jsx11("div", { className: "text-29343f dark:text-white", children: qrData ? (
+        // eslint-disable-next-line jsx-a11y/click-events-have-key-events, jsx-a11y/no-static-element-interactions
+        /* @__PURE__ */ jsx11("div", { onClick: copyLink, className: "cursor-pointer", children: /* @__PURE__ */ jsx11(QRCode_default, { data: qrData, size: 200 }) })
+      ) : /* @__PURE__ */ jsx11("div", { className: "flex size-[200px] items-center justify-center", children: /* @__PURE__ */ jsx11(QRPlaceholderIcon_default, { className: "size-[200px] animate-pulse" }) }) }) }),
+      /* @__PURE__ */ jsx11(AnimatePresence, { children: copiedLink && /* @__PURE__ */ jsx11(
+        motion.div,
+        {
+          className: "text-sm text-9eafc0 text-center",
+          initial: "hidden",
+          animate: "visible",
+          exit: "exit",
+          variants: {
+            hidden: { opacity: 0, height: 0, marginTop: 0 },
+            visible: {
+              opacity: 1,
+              height: "auto",
+              marginTop: 8,
+              transition: {
+                duration: 0.25,
+                opacity: { delay: 0.05, duration: 0.2 },
+                ease: "easeInOut"
+              }
+            },
+            exit: {
+              opacity: 0,
+              height: 0,
+              marginTop: 0,
+              transition: {
+                duration: 0.4,
+                delay: 0.1,
+                opacity: { duration: 0.25, delay: 0 },
+                ease: "easeInOut"
+              }
+            }
+          },
+          children: /* @__PURE__ */ jsx11("span", { className: "rounded-lg border border-f1f5f8 px-2 py-1 text-sm", children: __("QR Code copied") })
+        },
+        "copied"
+      ) })
+    ] }),
+    /* @__PURE__ */ jsxs7("div", { className: "hidden xl:block", children: [
       /* @__PURE__ */ jsx11(AnimatePresence, { children: copiedLink && /* @__PURE__ */ jsx11(
         motion.div,
         {
@@ -1971,7 +2045,8 @@ var WorldIDState = (props) => {
         /* @__PURE__ */ jsxs9("div", { className: clsx_default(!show_modal ? "hidden" : ""), children: [
           /* @__PURE__ */ jsx13("div", { className: "mb-4 flex items-center justify-center", children: /* @__PURE__ */ jsx13("div", { className: "flex size-14 items-center justify-center rounded-full border-[1.2px] border-solid border-[#EBECEF]", children: /* @__PURE__ */ jsx13(WorldcoinIcon_default, { className: "size-8 text-0d151d dark:text-white" }) }) }),
           /* @__PURE__ */ jsx13("p", { className: "text-2xl font-semibold text-gray-900 dark:text-white", children: __("Connect your World ID") }),
-          /* @__PURE__ */ jsx13("p", { className: clsx_default("mt-3 text-657080 dark:text-9eafc0 md:mt-2", { hidden: media === "mobile" }), children: __("Use phone camera to scan the QR code") })
+          /* @__PURE__ */ jsx13("p", { className: clsx_default("mt-3 text-657080 dark:text-9eafc0 md:mt-2", { hidden: media === "mobile" }), children: __("Use phone camera to scan the QR code") }),
+          /* @__PURE__ */ jsx13("p", { className: clsx_default("mt-3 text-657080 dark:text-9eafc0 md:mt-2", { hidden: media !== "mobile" }), children: __("You will be redirected to the app, please return to this page once you're done") })
         ] }),
         /* @__PURE__ */ jsxs9("div", { className: "relative w-full", children: [
           verificationState === VerificationState.WaitingForApp && /* @__PURE__ */ jsxs9("div", { className: "absolute inset-0 flex flex-col items-center justify-center space-y-6", children: [
@@ -2029,10 +2104,16 @@ var IDKitWidget = ({
   show_modal = true,
   container_id,
   disable_default_modal_behavior = false,
+  language,
   ...config
 }) => {
   const media = useMedia_default();
   const { isOpen, onOpenChange, stage, setStage, setOptions, setErrorState } = idkit_default(getParams2, shallow2);
+  useEffect7(() => {
+    if (language) {
+      setLocalizationConfig({ language });
+    }
+  }, [language]);
   useEffect7(() => {
     if (config.action === "") {
       throw new Error(__("Action cannot be an empty string."));
@@ -2050,7 +2131,7 @@ var IDKitWidget = ({
       case "HOST_APP_VERIFICATION" /* HOST_APP_VERIFICATION */:
         return /* @__PURE__ */ jsx15(HostAppVerificationState_default, {});
       default:
-        throw new Error(__("Invalid IDKitStage :stage.", { stage }));
+        throw new Error(__("Invalid IDKitStage :stage.", { s: String(stage) }));
     }
   }, [stage, show_modal]);
   const widgetContent = /* @__PURE__ */ jsxs11(ShadowHost, { mode: "open", id: "idkit-widget", children: [
@@ -2194,6 +2275,10 @@ export {
   IDKitWidget_default as IDKitWidget,
   VerificationLevel2 as VerificationLevel,
   VerificationState3 as VerificationState,
+  getCurrentLanguage,
+  getLocalizationConfig,
+  getSupportedLanguages,
+  setLocalizationConfig,
   solidityEncode,
   useIDKit_default as useIDKit,
   useSession,

package/build/internal.cjs

@@ -33,25 +33,165 @@ __export(internal_exports, {
   ConfigSource: () => ConfigSource,
   QRCode: () => QRCode_default,
   __: () => __,
+  getCurrentLanguage: () => getCurrentLanguage,
+  getLocalizationConfig: () => getLocalizationConfig,
+  getSupportedLanguages: () => getSupportedLanguages,
+  setLocalizationConfig: () => setLocalizationConfig,
   useIDKitStore: () => idkit_default
 });
 module.exports = __toCommonJS(internal_exports);
 
+// src/lang/translations/en.ts
+var en = {
+  "All set!": "All set!",
+  "Your World ID is now connected": "Your World ID is now connected",
+  "Transmitting verification to host app. Please wait...": "Transmitting verification to host app. Please wait...",
+  "Something went wrong": "Something went wrong",
+  "Verification Declined": "Verification Declined",
+  "Request cancelled": "Request cancelled",
+  "Connection to your wallet failed. Please try again.": "Connection to your wallet failed. Please try again.",
+  "You've cancelled the request in World App.": "You've cancelled the request in World App.",
+  "You have already verified the maximum number of times for this action.": "You have already verified the maximum number of times for this action.",
+  "It seems you do not have the verification level required by this app.": "It seems you do not have the verification level required by this app.",
+  "Invalid network. If you are the app owner, visit docs.world.org/test for details.": "Invalid network. If you are the app owner, visit docs.world.org/test for details.",
+  "Your identity is still being registered. Please wait a few minutes and try again.": "Your identity is still being registered. Please wait a few minutes and try again.",
+  "We couldn't complete your request. Please try again.": "We couldn't complete your request. Please try again.",
+  "Try Again": "Try Again",
+  "Open World App": "Open World App",
+  "Hide QR Code": "Hide QR Code",
+  "Display QR Code": "Display QR Code",
+  "QR Code copied": "QR Code copied",
+  "Connect your World ID": "Connect your World ID",
+  "Use phone camera to scan the QR code": "Use phone camera to scan the QR code",
+  "Connecting...": "Connecting...",
+  "Please continue in app": "Please continue in app",
+  "You will be redirected to the app, please return to this page once you're done": "You will be redirected to the app, please return to this page once you're done",
+  "Action cannot be an empty string.": "Action cannot be an empty string.",
+  "Invalid IDKitStage :stage.": "Invalid IDKitStage :stage.",
+  "Terms & Privacy": "Terms & Privacy"
+};
+
+// src/lang/translations/es.ts
+var es = {
+  "All set!": "\xA1Todo listo!",
+  "Your World ID is now connected": "Tu World ID ahora est\xE1 conectado",
+  "Transmitting verification to host app. Please wait...": "Transmitiendo verificaci\xF3n a la aplicaci\xF3n host. Por favor espera...",
+  "Something went wrong": "Algo sali\xF3 mal",
+  "Verification Declined": "Verificaci\xF3n rechazada",
+  "Request cancelled": "Solicitud cancelada",
+  "Connection to your wallet failed. Please try again.": "La conexi\xF3n a tu billetera fall\xF3. Por favor intenta de nuevo.",
+  "You've cancelled the request in World App.": "Has cancelado la solicitud en World App.",
+  "You have already verified the maximum number of times for this action.": "Ya has verificado el n\xFAmero m\xE1ximo de veces para esta acci\xF3n.",
+  "It seems you do not have the verification level required by this app.": "Parece que no tienes el nivel de verificaci\xF3n requerido por esta aplicaci\xF3n.",
+  "Invalid network. If you are the app owner, visit docs.world.org/test for details.": "Red inv\xE1lida. Si eres el propietario de la aplicaci\xF3n, visita docs.world.org/test para m\xE1s detalles.",
+  "Your identity is still being registered. Please wait a few minutes and try again.": "Tu identidad a\xFAn se est\xE1 registrando. Por favor espera unos minutos e intenta de nuevo.",
+  "We couldn't complete your request. Please try again.": "No pudimos completar tu solicitud. Por favor intenta de nuevo.",
+  "Try Again": "Intentar de nuevo",
+  "Open World App": "Abrir World App",
+  "Hide QR Code": "Ocultar c\xF3digo QR",
+  "Display QR Code": "Mostrar c\xF3digo QR",
+  "QR Code copied": "C\xF3digo QR copiado",
+  "Connect your World ID": "Conecta tu World ID",
+  "Use phone camera to scan the QR code": "Usa la c\xE1mara del tel\xE9fono para escanear el c\xF3digo QR",
+  "Connecting...": "Conectando...",
+  "Please continue in app": "Por favor contin\xFAa en la aplicaci\xF3n",
+  "You will be redirected to the app, please return to this page once you're done": "Ser\xE1s redirigido a la aplicaci\xF3n, por favor regresa a esta p\xE1gina una vez que hayas terminado",
+  "Action cannot be an empty string.": "La acci\xF3n no puede ser una cadena vac\xEDa.",
+  "Invalid IDKitStage :stage.": "IDKitStage inv\xE1lido :stage.",
+  "Terms & Privacy": "T\xE9rminos y privacidad"
+};
+
+// src/lang/translations/th.ts
+var th = {
+  "All set!": "\u0E40\u0E23\u0E35\u0E22\u0E1A\u0E23\u0E49\u0E2D\u0E22!",
+  "Your World ID is now connected": "World ID \u0E02\u0E2D\u0E07\u0E04\u0E38\u0E13\u0E40\u0E0A\u0E37\u0E48\u0E2D\u0E21\u0E15\u0E48\u0E2D\u0E41\u0E25\u0E49\u0E27",
+  "Transmitting verification to host app. Please wait...": "\u0E01\u0E33\u0E25\u0E31\u0E07\u0E2A\u0E48\u0E07\u0E01\u0E32\u0E23\u0E22\u0E37\u0E19\u0E22\u0E31\u0E19\u0E44\u0E1B\u0E22\u0E31\u0E07\u0E41\u0E2D\u0E1B\u0E42\u0E2E\u0E2A\u0E15\u0E4C \u0E01\u0E23\u0E38\u0E13\u0E32\u0E23\u0E2D\u0E2A\u0E31\u0E01\u0E04\u0E23\u0E39\u0E48...",
+  "Something went wrong": "\u0E40\u0E01\u0E34\u0E14\u0E02\u0E49\u0E2D\u0E1C\u0E34\u0E14\u0E1E\u0E25\u0E32\u0E14",
+  "Verification Declined": "\u0E01\u0E32\u0E23\u0E22\u0E37\u0E19\u0E22\u0E31\u0E19\u0E16\u0E39\u0E01\u0E1B\u0E0F\u0E34\u0E40\u0E2A\u0E18",
+  "Request cancelled": "\u0E04\u0E33\u0E02\u0E2D\u0E16\u0E39\u0E01\u0E22\u0E01\u0E40\u0E25\u0E34\u0E01",
+  "Connection to your wallet failed. Please try again.": "\u0E01\u0E32\u0E23\u0E40\u0E0A\u0E37\u0E48\u0E2D\u0E21\u0E15\u0E48\u0E2D\u0E01\u0E31\u0E1A\u0E01\u0E23\u0E30\u0E40\u0E1B\u0E4B\u0E32\u0E40\u0E07\u0E34\u0E19\u0E02\u0E2D\u0E07\u0E04\u0E38\u0E13\u0E25\u0E49\u0E21\u0E40\u0E2B\u0E25\u0E27 \u0E01\u0E23\u0E38\u0E13\u0E32\u0E25\u0E2D\u0E07\u0E2D\u0E35\u0E01\u0E04\u0E23\u0E31\u0E49\u0E07",
+  "You've cancelled the request in World App.": "\u0E04\u0E38\u0E13\u0E44\u0E14\u0E49\u0E22\u0E01\u0E40\u0E25\u0E34\u0E01\u0E04\u0E33\u0E02\u0E2D\u0E43\u0E19 World App",
+  "You have already verified the maximum number of times for this action.": "\u0E04\u0E38\u0E13\u0E44\u0E14\u0E49\u0E22\u0E37\u0E19\u0E22\u0E31\u0E19\u0E04\u0E23\u0E1A\u0E08\u0E33\u0E19\u0E27\u0E19\u0E04\u0E23\u0E31\u0E49\u0E07\u0E2A\u0E39\u0E07\u0E2A\u0E38\u0E14\u0E2A\u0E33\u0E2B\u0E23\u0E31\u0E1A\u0E01\u0E32\u0E23\u0E14\u0E33\u0E40\u0E19\u0E34\u0E19\u0E01\u0E32\u0E23\u0E19\u0E35\u0E49\u0E41\u0E25\u0E49\u0E27",
+  "It seems you do not have the verification level required by this app.": "\u0E14\u0E39\u0E40\u0E2B\u0E21\u0E37\u0E2D\u0E19\u0E27\u0E48\u0E32\u0E04\u0E38\u0E13\u0E44\u0E21\u0E48\u0E21\u0E35\u0E23\u0E30\u0E14\u0E31\u0E1A\u0E01\u0E32\u0E23\u0E22\u0E37\u0E19\u0E22\u0E31\u0E19\u0E17\u0E35\u0E48\u0E41\u0E2D\u0E1B\u0E19\u0E35\u0E49\u0E15\u0E49\u0E2D\u0E07\u0E01\u0E32\u0E23",
+  "Invalid network. If you are the app owner, visit docs.world.org/test for details.": "\u0E40\u0E04\u0E23\u0E37\u0E2D\u0E02\u0E48\u0E32\u0E22\u0E44\u0E21\u0E48\u0E16\u0E39\u0E01\u0E15\u0E49\u0E2D\u0E07 \u0E2B\u0E32\u0E01\u0E04\u0E38\u0E13\u0E40\u0E1B\u0E47\u0E19\u0E40\u0E08\u0E49\u0E32\u0E02\u0E2D\u0E07\u0E41\u0E2D\u0E1B \u0E42\u0E1B\u0E23\u0E14\u0E44\u0E1B\u0E17\u0E35\u0E48 docs.world.org/test \u0E2A\u0E33\u0E2B\u0E23\u0E31\u0E1A\u0E23\u0E32\u0E22\u0E25\u0E30\u0E40\u0E2D\u0E35\u0E22\u0E14",
+  "Your identity is still being registered. Please wait a few minutes and try again.": "\u0E15\u0E31\u0E27\u0E15\u0E19\u0E02\u0E2D\u0E07\u0E04\u0E38\u0E13\u0E22\u0E31\u0E07\u0E2D\u0E22\u0E39\u0E48\u0E23\u0E30\u0E2B\u0E27\u0E48\u0E32\u0E07\u0E01\u0E32\u0E23\u0E25\u0E07\u0E17\u0E30\u0E40\u0E1A\u0E35\u0E22\u0E19 \u0E01\u0E23\u0E38\u0E13\u0E32\u0E23\u0E2D\u0E2A\u0E31\u0E01\u0E04\u0E23\u0E39\u0E48\u0E41\u0E25\u0E49\u0E27\u0E25\u0E2D\u0E07\u0E2D\u0E35\u0E01\u0E04\u0E23\u0E31\u0E49\u0E07",
+  "We couldn't complete your request. Please try again.": "\u0E40\u0E23\u0E32\u0E44\u0E21\u0E48\u0E2A\u0E32\u0E21\u0E32\u0E23\u0E16\u0E14\u0E33\u0E40\u0E19\u0E34\u0E19\u0E01\u0E32\u0E23\u0E15\u0E32\u0E21\u0E04\u0E33\u0E02\u0E2D\u0E02\u0E2D\u0E07\u0E04\u0E38\u0E13\u0E44\u0E14\u0E49 \u0E01\u0E23\u0E38\u0E13\u0E32\u0E25\u0E2D\u0E07\u0E2D\u0E35\u0E01\u0E04\u0E23\u0E31\u0E49\u0E07",
+  "Try Again": "\u0E25\u0E2D\u0E07\u0E2D\u0E35\u0E01\u0E04\u0E23\u0E31\u0E49\u0E07",
+  "Open World App": "\u0E40\u0E1B\u0E34\u0E14 World App",
+  "Hide QR Code": "\u0E0B\u0E48\u0E2D\u0E19 QR Code",
+  "Display QR Code": "\u0E41\u0E2A\u0E14\u0E07 QR Code",
+  "QR Code copied": "\u0E04\u0E31\u0E14\u0E25\u0E2D\u0E01 QR Code \u0E41\u0E25\u0E49\u0E27",
+  "Connect your World ID": "\u0E40\u0E0A\u0E37\u0E48\u0E2D\u0E21\u0E15\u0E48\u0E2D World ID \u0E02\u0E2D\u0E07\u0E04\u0E38\u0E13",
+  "Use phone camera to scan the QR code": "\u0E43\u0E0A\u0E49\u0E01\u0E25\u0E49\u0E2D\u0E07\u0E42\u0E17\u0E23\u0E28\u0E31\u0E1E\u0E17\u0E4C\u0E40\u0E1E\u0E37\u0E48\u0E2D\u0E2A\u0E41\u0E01\u0E19 QR code",
+  "Connecting...": "\u0E01\u0E33\u0E25\u0E31\u0E07\u0E40\u0E0A\u0E37\u0E48\u0E2D\u0E21\u0E15\u0E48\u0E2D...",
+  "Please continue in app": "\u0E01\u0E23\u0E38\u0E13\u0E32\u0E14\u0E33\u0E40\u0E19\u0E34\u0E19\u0E01\u0E32\u0E23\u0E15\u0E48\u0E2D\u0E43\u0E19\u0E41\u0E2D\u0E1B",
+  "You will be redirected to the app, please return to this page once you're done": "\u0E04\u0E38\u0E13\u0E08\u0E30\u0E16\u0E39\u0E01\u0E19\u0E33\u0E44\u0E1B\u0E22\u0E31\u0E07\u0E41\u0E2D\u0E1B \u0E01\u0E23\u0E38\u0E13\u0E32\u0E01\u0E25\u0E31\u0E1A\u0E21\u0E32\u0E17\u0E35\u0E48\u0E2B\u0E19\u0E49\u0E32\u0E19\u0E35\u0E49\u0E40\u0E21\u0E37\u0E48\u0E2D\u0E40\u0E2A\u0E23\u0E47\u0E08\u0E41\u0E25\u0E49\u0E27",
+  "Action cannot be an empty string.": "\u0E01\u0E32\u0E23\u0E14\u0E33\u0E40\u0E19\u0E34\u0E19\u0E01\u0E32\u0E23\u0E44\u0E21\u0E48\u0E2A\u0E32\u0E21\u0E32\u0E23\u0E16\u0E40\u0E1B\u0E47\u0E19\u0E02\u0E49\u0E2D\u0E04\u0E27\u0E32\u0E21\u0E27\u0E48\u0E32\u0E07\u0E44\u0E14\u0E49",
+  "Invalid IDKitStage :stage.": "IDKitStage \u0E44\u0E21\u0E48\u0E16\u0E39\u0E01\u0E15\u0E49\u0E2D\u0E07 :stage.",
+  "Terms & Privacy": "\u0E02\u0E49\u0E2D\u0E01\u0E33\u0E2B\u0E19\u0E14\u0E41\u0E25\u0E30\u0E04\u0E27\u0E32\u0E21\u0E40\u0E1B\u0E47\u0E19\u0E2A\u0E48\u0E27\u0E19\u0E15\u0E31\u0E27"
+};
+
+// src/lang/translations/index.ts
+var translations = {
+  en,
+  es,
+  th
+};
+
+// src/lang/localization.ts
+var currentConfig = {};
+var setLocalizationConfig = (config) => {
+  currentConfig = config;
+};
+var getLocalizationConfig = () => currentConfig;
+var detectBrowserLanguage = () => {
+  for (const lang of navigator.languages) {
+    const [language] = lang.split("-");
+    const normalizedLang = language.toLowerCase();
+    if (normalizedLang in translations) {
+      return normalizedLang;
+    }
+  }
+  return void 0;
+};
+var getCurrentLanguage = () => {
+  const config = getLocalizationConfig();
+  if (config.language && config.language in translations) {
+    return config.language;
+  }
+  const browserLang = detectBrowserLanguage();
+  if (browserLang) {
+    return browserLang;
+  }
+  return "en";
+};
+var getTranslations = () => {
+  const currentLang = getCurrentLanguage();
+  return translations[currentLang];
+};
+var getSupportedLanguages = () => {
+  return Object.keys(translations);
+};
+
 // src/lang/index.ts
-var translations = {};
 var getLang = () => {
-  if (!navigator?.languages) return;
-  const supportedLang = navigator.languages.find((l) => translations[l] != void 0) ?? "";
-  return translations[supportedLang];
+  return getTranslations();
 };
 var replaceParams = (str, params) => {
-  let replaced = str;
-  for (const [key, value] of Object.entries(params ?? {})) replaced = str.replace(`:${key}`, value);
-  return replaced;
+  if (!params) return str;
+  let result = str;
+  for (const [key, value] of Object.entries(params)) {
+    result = result.replace(`:${key}`, value);
+  }
+  return result;
 };
-function __(str, params) {
-  if (typeof navigator === "undefined") return str;
-  return replaceParams(getLang()?.[str] ?? str, params);
+function __(str, ...args) {
+  const [params] = args;
+  if (typeof navigator === "undefined" && typeof window === "undefined") {
+    return replaceParams(str, params);
+  }
+  const translated = getLang()?.[str] ?? str;
+  return replaceParams(translated, params);
 }
 
 // src/components/QRCode.tsx
@@ -265,5 +405,9 @@ var ConfigSource = /* @__PURE__ */ ((ConfigSource2) => {
   ConfigSource,
   QRCode,
   __,
+  getCurrentLanguage,
+  getLocalizationConfig,
+  getSupportedLanguages,
+  setLocalizationConfig,
   useIDKitStore
 });

package/build/internal.d.cts

@@ -1,17 +1,32 @@
 import * as react from 'react';
 import * as zustand_traditional from 'zustand/traditional';
 import * as zustand_vanilla from 'zustand/vanilla';
-import { I as IDKITStage, a as ConfigSource, b as CallbackFn, C as Config } from './config-BRFx4nLT.cjs';
+import { I as IDKITStage, c as ConfigSource, d as CallbackFn, C as Config } from './config-SH5TbLYj.cjs';
+export { S as SupportedLanguage, a as getCurrentLanguage, g as getLocalizationConfig, b as getSupportedLanguages, s as setLocalizationConfig } from './config-SH5TbLYj.cjs';
 import { IDKitConfig, ISuccessResult, IErrorState } from '@worldcoin/idkit-core';
 
-type CleanWord<T> = T extends `${string}${' ' | ',' | '!' | '?' | '.' | '`'}${string}` ? never : T extends '' ? never : T;
-type ExtractPlaceholders<S extends string> = S extends `${string}:${infer Placeholder}` ? Placeholder extends `${infer Word}${' ' | ',' | '!' | '?' | '.' | '`'}${infer Rest}` ? CleanWord<Word> | ExtractPlaceholders<Rest> : never : never;
-type NoPlaceholder<S extends string> = S extends `${string}:${string}` ? never : S;
-type PlaceholderValues<S extends string> = {
-    [K in ExtractPlaceholders<S>]: string;
+/**
+ * ## Adding Translations
+ * To add a new language:
+ * 1. Create a new translation file in `src/lang/translations/[lang].ts`
+ * 2. Implement all translation strings in the new file
+ * 3. Add the language to the `translations` index
+ * 4. Update the `SupportedLanguage` type in `src/lang/types.ts`
+ */
+/**
+ * Translation function with type-safe parameter support
+ *
+ * Examples:
+ * - __('Hello world')                                    // No parameters needed
+ * - __('Invalid IDKitStage :stage.', { stage: 'init' }) // Parameter required
+ */
+type HasPlaceholder<T extends string> = T extends `${string}:${string}` ? true : false;
+type GetPlaceholderName<T extends string> = T extends `:${infer Name}${infer Rest}` ? Name extends `${infer Word}${' ' | ',' | ':' | '!' | '?' | '.'}${string}` ? Word : Name : never;
+type GetAllPlaceholders<T extends string> = T extends `${infer Before}:${infer After}` ? GetAllPlaceholders<After> | GetPlaceholderName<`:${After}`> : never;
+type TranslationParams<T extends string> = GetAllPlaceholders<T> extends never ? never : {
+    [K in GetAllPlaceholders<T>]: string;
 };
-declare function __<S extends `${string}:${string}`>(str: S, params: PlaceholderValues<S>): string;
-declare function __<S extends string>(str: NoPlaceholder<S>): string;
+declare function __<T extends string>(str: T, ...args: HasPlaceholder<T> extends true ? [params: TranslationParams<T>] : []): string;
 
 type Props = {
     data: string;

package/build/internal.d.ts

@@ -1,17 +1,32 @@
 import * as react from 'react';
 import * as zustand_traditional from 'zustand/traditional';
 import * as zustand_vanilla from 'zustand/vanilla';
-import { I as IDKITStage, a as ConfigSource, b as CallbackFn, C as Config } from './config-BRFx4nLT.js';
+import { I as IDKITStage, c as ConfigSource, d as CallbackFn, C as Config } from './config-SH5TbLYj.js';
+export { S as SupportedLanguage, a as getCurrentLanguage, g as getLocalizationConfig, b as getSupportedLanguages, s as setLocalizationConfig } from './config-SH5TbLYj.js';
 import { IDKitConfig, ISuccessResult, IErrorState } from '@worldcoin/idkit-core';
 
-type CleanWord<T> = T extends `${string}${' ' | ',' | '!' | '?' | '.' | '`'}${string}` ? never : T extends '' ? never : T;
-type ExtractPlaceholders<S extends string> = S extends `${string}:${infer Placeholder}` ? Placeholder extends `${infer Word}${' ' | ',' | '!' | '?' | '.' | '`'}${infer Rest}` ? CleanWord<Word> | ExtractPlaceholders<Rest> : never : never;
-type NoPlaceholder<S extends string> = S extends `${string}:${string}` ? never : S;
-type PlaceholderValues<S extends string> = {
-    [K in ExtractPlaceholders<S>]: string;
+/**
+ * ## Adding Translations
+ * To add a new language:
+ * 1. Create a new translation file in `src/lang/translations/[lang].ts`
+ * 2. Implement all translation strings in the new file
+ * 3. Add the language to the `translations` index
+ * 4. Update the `SupportedLanguage` type in `src/lang/types.ts`
+ */
+/**
+ * Translation function with type-safe parameter support
+ *
+ * Examples:
+ * - __('Hello world')                                    // No parameters needed
+ * - __('Invalid IDKitStage :stage.', { stage: 'init' }) // Parameter required
+ */
+type HasPlaceholder<T extends string> = T extends `${string}:${string}` ? true : false;
+type GetPlaceholderName<T extends string> = T extends `:${infer Name}${infer Rest}` ? Name extends `${infer Word}${' ' | ',' | ':' | '!' | '?' | '.'}${string}` ? Word : Name : never;
+type GetAllPlaceholders<T extends string> = T extends `${infer Before}:${infer After}` ? GetAllPlaceholders<After> | GetPlaceholderName<`:${After}`> : never;
+type TranslationParams<T extends string> = GetAllPlaceholders<T> extends never ? never : {
+    [K in GetAllPlaceholders<T>]: string;
 };
-declare function __<S extends `${string}:${string}`>(str: S, params: PlaceholderValues<S>): string;
-declare function __<S extends string>(str: NoPlaceholder<S>): string;
+declare function __<T extends string>(str: T, ...args: HasPlaceholder<T> extends true ? [params: TranslationParams<T>] : []): string;
 
 type Props = {
     data: string;

package/build/internal.js

@@ -2,11 +2,19 @@ import {
   ConfigSource,
   QRCode_default,
   __,
-  idkit_default
-} from "./chunk-3HCETHXP.js";
+  getCurrentLanguage,
+  getLocalizationConfig,
+  getSupportedLanguages,
+  idkit_default,
+  setLocalizationConfig
+} from "./chunk-PWFTYFSZ.js";
 export {
   ConfigSource,
   QRCode_default as QRCode,
   __,
+  getCurrentLanguage,
+  getLocalizationConfig,
+  getSupportedLanguages,
+  setLocalizationConfig,
   idkit_default as useIDKitStore
 };

package/package.json

@@ -37,6 +37,9 @@
     "tsup": "^8.1.0",
     "typescript": "^5.5.3"
   },
+  "overrides": {
+    "rollup": "^4.22.4"
+  },
   "engines": {
     "node": ">=12.4"
   },
@@ -103,7 +106,7 @@
       ]
     }
   },
-  "version": "2.3.0",
+  "version": "2.4.1",
   "scripts": {
     "build": "npm run build:css && tsup",
     "build:css": "npx tailwindcss -i ./src/styles/styles.css -o ./build/index.css --minify",

package/src/index.ts

@@ -6,9 +6,22 @@ import { verifyCloudProof } from '@worldcoin/idkit-core/backend'
 import type { IVerifyResponse } from '@worldcoin/idkit-core/backend'
 import type { ISuccessResult, IErrorState } from '@worldcoin/idkit-core'
 import { VerificationLevel, VerificationState } from '@worldcoin/idkit-core'
+import { setLocalizationConfig, getLocalizationConfig, getCurrentLanguage, getSupportedLanguages } from '@/lang'
+import type { SupportedLanguage } from '@/lang'
 
-export { IDKitWidget, useIDKit, solidityEncode, verifyCloudProof, VerificationLevel, VerificationState }
-export type { ISuccessResult, IErrorState, IVerifyResponse, Config, WidgetProps }
+export { 
+	IDKitWidget, 
+	useIDKit, 
+	solidityEncode, 
+	verifyCloudProof, 
+	VerificationLevel, 
+	VerificationState,
+	setLocalizationConfig,
+	getLocalizationConfig,
+	getCurrentLanguage,
+	getSupportedLanguages,
+}
+export type { ISuccessResult, IErrorState, IVerifyResponse, Config, WidgetProps, SupportedLanguage }
 
 // Session API
 export { useSession } from '@/hooks/useSession'