@hook-sdk/template 0.18.0 → 0.19.0

package/dist/index.js

@@ -74,6 +74,17 @@ var DeepLinksSchema = z.object({
   passwordReset: z.string().startsWith("/").optional(),
   emailVerify: z.string().startsWith("/").optional()
 }).strict();
+var I18nConfigSchema = z.object({
+  defaultLocale: z.string().min(2),
+  supportedLocales: z.array(z.string().min(2)).min(1),
+  resources: z.record(z.string(), z.record(z.string(), z.string()))
+}).strict().refine((v) => v.supportedLocales.includes(v.defaultLocale), {
+  message: "i18n.defaultLocale must be a member of i18n.supportedLocales",
+  path: ["defaultLocale"]
+});
+var InstallPromptSchema = z.object({
+  position: z.enum(["pre-auth", "post-paywall"]).optional()
+}).strict();
 var AppConfigSchema = z.object({
   slug: z.string().regex(/^[a-z0-9-]+$/),
   name: z.string().min(1),
@@ -87,12 +98,18 @@ var AppConfigSchema = z.object({
   persistedKeys: z.array(PersistedKeySchema),
   onboarding: OnboardingSchema.optional(),
   deepLinks: DeepLinksSchema.optional(),
+  i18n: I18nConfigSchema.optional(),
   features_enabled: z.array(z.string()).optional(),
+  install_prompt: InstallPromptSchema.optional(),
   // Build-time injected theme metadata (e.g. icon_url for InstallSplash).
   // Apps don't author this directly; deploy workflows fill it from
   // env-resolved bundle host. Permissive shape so apps/workflows can
   // extend without re-bumping the template schema.
-  theme: z.object({}).passthrough().optional()
+  theme: z.object({}).passthrough().optional(),
+  // G133 — per-tenant public app-data keys allowlist. Optional; default
+  // backfill em migration 0044 = canonical 6. Apps com keys próprias
+  // declaram aqui pra evitar 402 spam pós-signup no SubscriptionGate.
+  publicKeys: z.array(z.string().regex(SnakeKeyRE)).optional()
 }).strict();
 function parseAppConfig(input) {
   const r = AppConfigSchema.safeParse(input);
@@ -196,7 +213,16 @@ var MAP = {
   pix_expired: "QR Code do PIX expirou. Gere um novo.",
   pix_not_paid_yet: "PIX ainda n\xE3o foi pago. Aguardando confirma\xE7\xE3o."
 };
-function asaasErrorMessage(code) {
+function asaasErrorMessage(code, description) {
+  if (description) {
+    const lower = description.toLowerCase();
+    if (lower.includes("cep")) {
+      return "Nosso processador de pagamentos n\xE3o reconheceu esse CEP \u2014 a base deles pode estar desatualizada. Tente outro CEP.";
+    }
+    if (lower.includes("telefone") || lower.includes("contato com ddd")) {
+      return "Telefone inv\xE1lido. Confira o n\xFAmero com DDD e tente novamente.";
+    }
+  }
   return MAP[code] ?? "Ocorreu um erro inesperado. Tente novamente em instantes.";
 }
 
@@ -325,7 +351,9 @@ function usePaywallState() {
     (code, fallbackMessage) => ({
       code,
       message: fallbackMessage,
-      userMessage: useDefaultMessages ? asaasErrorMessage(code) : fallbackMessage
+      // fallbackMessage carries Asaas's PT-BR description ("O CEP informado é inválido.")
+      // that distinguishes invalid_holderInfo sub-cases (CEP vs phone vs name).
+      userMessage: useDefaultMessages ? asaasErrorMessage(code, fallbackMessage) : fallbackMessage
     }),
     [useDefaultMessages]
   );
@@ -1800,9 +1828,9 @@ var bannerStyle = {
 
 // src/components/InstallGate/InstallGate.tsx
 import { Fragment as Fragment3, jsx as jsx16, jsxs as jsxs10 } from "react/jsx-runtime";
-function InstallGate({ children }) {
+function InstallGate({ children, position }) {
   const { slug, features_enabled } = useTemplateConfig();
-  const enabled = features_enabled.includes("install_prompt");
+  const enabled = features_enabled.includes("pwa-install");
   const installState = useInstallPrompt(slug);
   const shouldBlock = enabled && shouldBlockInstall(installState);
   const trackedRef = useRef2(null);
@@ -1817,9 +1845,10 @@ function InstallGate({ children }) {
       platform: installState.platform,
       browser: installState.iosBrowser ?? installState.androidBrowser ?? null,
       in_app_app: installState.inAppApp,
-      variant: installState.variant
+      variant: installState.variant,
+      ...position !== void 0 ? { position } : {}
     });
-  }, [shouldBlock, slug, installState.variant, installState.platform, installState.iosBrowser, installState.androidBrowser, installState.inAppApp]);
+  }, [shouldBlock, slug, installState.variant, installState.platform, installState.iosBrowser, installState.androidBrowser, installState.inAppApp, position]);
   if (!enabled) return /* @__PURE__ */ jsx16(Fragment3, { children });
   if (installState.isInstalled) return /* @__PURE__ */ jsx16(Fragment3, { children });
   if (installState.variant === "desktop") {
@@ -1942,10 +1971,47 @@ var ErrorBoundary = class extends Component {
   }
 };
 
+// src/i18n/I18nProvider.tsx
+import { useEffect as useEffect7 } from "react";
+import i18n from "i18next";
+import { I18nextProvider, initReactI18next } from "react-i18next";
+import { usePersistedState } from "@hook-sdk/sdk";
+import { jsx as jsx19 } from "react/jsx-runtime";
+function ensureInitialized(defaultLocale, supportedLocales, resources, initialLocale) {
+  if (i18n.isInitialized) return;
+  i18n.use(initReactI18next).init({
+    resources: Object.fromEntries(
+      supportedLocales.map((l) => [l, { translation: resources[l] ?? {} }])
+    ),
+    lng: initialLocale,
+    fallbackLng: defaultLocale,
+    interpolation: { escapeValue: false },
+    // useTranslation suspends by default until i18next is "ready". Inline
+    // resources are sync, so suspending creates a guaranteed empty render
+    // tick — confusing in apps and breaks tests that don't use Suspense.
+    react: { useSuspense: false }
+  });
+}
+function I18nProvider({
+  defaultLocale,
+  supportedLocales,
+  resources,
+  children
+}) {
+  const [userLocale] = usePersistedState("user-locale", defaultLocale);
+  ensureInitialized(defaultLocale, supportedLocales, resources, userLocale);
+  useEffect7(() => {
+    if (i18n.isInitialized && i18n.language !== userLocale) {
+      i18n.changeLanguage(userLocale);
+    }
+  }, [userLocale]);
+  return /* @__PURE__ */ jsx19(I18nextProvider, { i18n, children });
+}
+
 // src/internal/PaymentReturnHandler.tsx
-import { useCallback as useCallback3, useEffect as useEffect7, useRef as useRef4, useState as useState5 } from "react";
+import { useCallback as useCallback3, useEffect as useEffect8, useRef as useRef4, useState as useState5 } from "react";
 import { useHook as useHook5 } from "@hook-sdk/sdk";
-import { Fragment as Fragment5, jsx as jsx19, jsxs as jsxs13 } from "react/jsx-runtime";
+import { Fragment as Fragment5, jsx as jsx20, jsxs as jsxs13 } from "react/jsx-runtime";
 var BACKOFF_MS = [2e3, 5e3, 1e4, 2e4, 4e4];
 var MAX_CYCLES = 3;
 var SUPPORT_MAILTO = "mailto:suporte@usehook.net?subject=Pagamento%20pendente";
@@ -1991,7 +2057,7 @@ function PaymentReturnHandler({ children }) {
     };
     void tick();
   }, []);
-  useEffect7(() => {
+  useEffect8(() => {
     if (typeof window === "undefined") return;
     const url = new URL(window.location.href);
     if (url.searchParams.get("paymentReturn") !== "1") return;
@@ -2008,19 +2074,19 @@ function PaymentReturnHandler({ children }) {
     window.location.href = cleanUrl.toString();
   }, []);
   if (state === "confirming") {
-    return /* @__PURE__ */ jsx19("div", { role: "status", "aria-live": "polite", style: overlayStyle2, children: "Confirmando pagamento\u2026" });
+    return /* @__PURE__ */ jsx20("div", { role: "status", "aria-live": "polite", style: overlayStyle2, children: "Confirmando pagamento\u2026" });
   }
   if (state === "waiting") {
-    return /* @__PURE__ */ jsx19("div", { role: "status", "aria-live": "polite", style: overlayStyle2, children: /* @__PURE__ */ jsxs13("div", { style: { maxWidth: 320, textAlign: "center", lineHeight: 1.5 }, children: [
-      /* @__PURE__ */ jsx19("div", { style: { marginBottom: 16 }, children: "Pagamento aceito. Estamos confirmando com o banco \u2014 pode levar alguns minutos." }),
-      /* @__PURE__ */ jsx19("button", { type: "button", onClick: runPoll, style: buttonStyle, children: "Atualizar" })
+    return /* @__PURE__ */ jsx20("div", { role: "status", "aria-live": "polite", style: overlayStyle2, children: /* @__PURE__ */ jsxs13("div", { style: { maxWidth: 320, textAlign: "center", lineHeight: 1.5 }, children: [
+      /* @__PURE__ */ jsx20("div", { style: { marginBottom: 16 }, children: "Pagamento aceito. Estamos confirmando com o banco \u2014 pode levar alguns minutos." }),
+      /* @__PURE__ */ jsx20("button", { type: "button", onClick: runPoll, style: buttonStyle, children: "Atualizar" })
     ] }) });
   }
   if (state === "timeout") {
-    return /* @__PURE__ */ jsx19("div", { role: "alert", "aria-live": "assertive", style: overlayStyle2, children: /* @__PURE__ */ jsxs13("div", { style: { maxWidth: 360, textAlign: "center", lineHeight: 1.5 }, children: [
-      /* @__PURE__ */ jsx19("div", { style: { marginBottom: 16 }, children: "Ainda n\xE3o conseguimos confirmar seu pagamento com o banco. Voc\xEA pode tentar de novo, voltar pro app, ou falar com a gente." }),
+    return /* @__PURE__ */ jsx20("div", { role: "alert", "aria-live": "assertive", style: overlayStyle2, children: /* @__PURE__ */ jsxs13("div", { style: { maxWidth: 360, textAlign: "center", lineHeight: 1.5 }, children: [
+      /* @__PURE__ */ jsx20("div", { style: { marginBottom: 16 }, children: "Ainda n\xE3o conseguimos confirmar seu pagamento com o banco. Voc\xEA pode tentar de novo, voltar pro app, ou falar com a gente." }),
       /* @__PURE__ */ jsxs13("div", { style: { display: "flex", flexDirection: "column", gap: 8 }, children: [
-        /* @__PURE__ */ jsx19(
+        /* @__PURE__ */ jsx20(
           "button",
           {
             type: "button",
@@ -2033,7 +2099,7 @@ function PaymentReturnHandler({ children }) {
             children: "Tentar de novo"
           }
         ),
-        /* @__PURE__ */ jsx19(
+        /* @__PURE__ */ jsx20(
           "button",
           {
             type: "button",
@@ -2043,7 +2109,7 @@ function PaymentReturnHandler({ children }) {
             children: "Voltar pro app"
           }
         ),
-        /* @__PURE__ */ jsx19(
+        /* @__PURE__ */ jsx20(
           "a",
           {
             href: SUPPORT_MAILTO,
@@ -2055,7 +2121,7 @@ function PaymentReturnHandler({ children }) {
       ] })
     ] }) });
   }
-  return /* @__PURE__ */ jsx19(Fragment5, { children });
+  return /* @__PURE__ */ jsx20(Fragment5, { children });
 }
 var overlayStyle2 = {
   position: "fixed",
@@ -2094,7 +2160,7 @@ var linkStyle = {
 };
 
 // src/AppRoot.tsx
-import { Fragment as Fragment6, jsx as jsx20, jsxs as jsxs14 } from "react/jsx-runtime";
+import { Fragment as Fragment6, jsx as jsx21, jsxs as jsxs14 } from "react/jsx-runtime";
 function buildLegacyConfigShim(config) {
   const paywall = config.paywall;
   const isFree = paywall.mode === "free";
@@ -2171,28 +2237,43 @@ function AppRoot(props) {
   const Router = testRouter === "memory" ? MemoryRouter : BrowserRouter;
   const basename = `/app/${config.slug}`;
   const routerProps = testRouter === "memory" ? { basename, initialEntries: testInitialEntries } : { basename };
-  return /* @__PURE__ */ jsx20(ErrorBoundary, { children: /* @__PURE__ */ jsx20(AppConfigProvider, { config, children: /* @__PURE__ */ jsx20(TemplateConfigProvider, { config: legacyShim, children: /* @__PURE__ */ jsx20(ThemeProvider, { children: /* @__PURE__ */ jsx20(PersistenceRegistry, { config: config.persistedKeys, children: /* @__PURE__ */ jsxs14(Router, { ...routerProps, children: [
-    /* @__PURE__ */ jsx20(DeepLinkHandler, { deepLinks: config.deepLinks }),
-    /* @__PURE__ */ jsx20(SessionExpiredBanner, {}),
-    /* @__PURE__ */ jsx20(InstallGate, { children: /* @__PURE__ */ jsx20(
-      AuthGated,
-      {
-        config,
-        Login,
-        Signup,
-        Forgot,
-        Reset,
-        EmailVerify,
-        Paywall,
-        Onboarding,
-        PreAuthFlow,
-        children: /* @__PURE__ */ jsxs14(SubscriptionGate, { Paywall: Paywall ?? FallbackPaywall, children: [
-          children,
-          /* @__PURE__ */ jsx20(PushPrompt, {})
-        ] })
-      }
-    ) })
-  ] }) }) }) }) }) });
+  const position = config.install_prompt?.position ?? "post-paywall";
+  const subscriptionGated = /* @__PURE__ */ jsx21(SubscriptionGate, { Paywall: Paywall ?? FallbackPaywall, children: position === "post-paywall" ? /* @__PURE__ */ jsxs14(InstallGate, { position: "post-paywall", children: [
+    children,
+    /* @__PURE__ */ jsx21(PushPrompt, {})
+  ] }) : /* @__PURE__ */ jsxs14(Fragment6, { children: [
+    children,
+    /* @__PURE__ */ jsx21(PushPrompt, {})
+  ] }) });
+  const authGated = /* @__PURE__ */ jsx21(
+    AuthGated,
+    {
+      config,
+      Login,
+      Signup,
+      Forgot,
+      Reset,
+      EmailVerify,
+      Paywall,
+      Onboarding,
+      PreAuthFlow,
+      children: subscriptionGated
+    }
+  );
+  const routedTree = /* @__PURE__ */ jsxs14(Router, { ...routerProps, children: [
+    /* @__PURE__ */ jsx21(DeepLinkHandler, { deepLinks: config.deepLinks }),
+    /* @__PURE__ */ jsx21(SessionExpiredBanner, {}),
+    position === "pre-auth" ? /* @__PURE__ */ jsx21(InstallGate, { position: "pre-auth", children: authGated }) : authGated
+  ] });
+  return /* @__PURE__ */ jsx21(ErrorBoundary, { children: /* @__PURE__ */ jsx21(AppConfigProvider, { config, children: /* @__PURE__ */ jsx21(TemplateConfigProvider, { config: legacyShim, children: /* @__PURE__ */ jsx21(ThemeProvider, { children: /* @__PURE__ */ jsx21(PersistenceRegistry, { config: config.persistedKeys, children: config.i18n ? /* @__PURE__ */ jsx21(
+    I18nProvider,
+    {
+      defaultLocale: config.i18n.defaultLocale,
+      supportedLocales: config.i18n.supportedLocales,
+      resources: config.i18n.resources,
+      children: routedTree
+    }
+  ) : routedTree }) }) }) }) });
 }
 function AuthGated({
   children,
@@ -2209,31 +2290,31 @@ function AuthGated({
   if (authStatus !== "authenticated") {
     if (config.onboarding?.trigger === "pre_signup_custom" && PreAuthFlow) {
       return /* @__PURE__ */ jsxs14(Routes, { children: [
-        /* @__PURE__ */ jsx20(Route, { path: "/signin", element: /* @__PURE__ */ jsx20(Login, {}) }),
-        /* @__PURE__ */ jsx20(Route, { path: "/signup", element: /* @__PURE__ */ jsx20(Signup, {}) }),
-        /* @__PURE__ */ jsx20(Route, { path: "/forgot", element: /* @__PURE__ */ jsx20(Forgot, {}) }),
-        /* @__PURE__ */ jsx20(Route, { path: "/reset", element: /* @__PURE__ */ jsx20(Reset, {}) }),
-        EmailVerify ? /* @__PURE__ */ jsx20(Route, { path: "/verify", element: /* @__PURE__ */ jsx20(EmailVerify, {}) }) : null,
-        /* @__PURE__ */ jsx20(Route, { path: "/*", element: /* @__PURE__ */ jsx20(PreAuthFlow, {}) })
+        /* @__PURE__ */ jsx21(Route, { path: "/signin", element: /* @__PURE__ */ jsx21(Login, {}) }),
+        /* @__PURE__ */ jsx21(Route, { path: "/signup", element: /* @__PURE__ */ jsx21(Signup, {}) }),
+        /* @__PURE__ */ jsx21(Route, { path: "/forgot", element: /* @__PURE__ */ jsx21(Forgot, {}) }),
+        /* @__PURE__ */ jsx21(Route, { path: "/reset", element: /* @__PURE__ */ jsx21(Reset, {}) }),
+        EmailVerify ? /* @__PURE__ */ jsx21(Route, { path: "/verify", element: /* @__PURE__ */ jsx21(EmailVerify, {}) }) : null,
+        /* @__PURE__ */ jsx21(Route, { path: "/*", element: /* @__PURE__ */ jsx21(PreAuthFlow, {}) })
       ] });
     }
     return /* @__PURE__ */ jsxs14(Routes, { children: [
-      /* @__PURE__ */ jsx20(Route, { path: "/", element: /* @__PURE__ */ jsx20(Login, {}) }),
-      /* @__PURE__ */ jsx20(Route, { path: "/signup", element: /* @__PURE__ */ jsx20(Signup, {}) }),
-      /* @__PURE__ */ jsx20(Route, { path: "/forgot", element: /* @__PURE__ */ jsx20(Forgot, {}) }),
-      /* @__PURE__ */ jsx20(Route, { path: "/reset", element: /* @__PURE__ */ jsx20(Reset, {}) }),
-      EmailVerify ? /* @__PURE__ */ jsx20(Route, { path: "/verify", element: /* @__PURE__ */ jsx20(EmailVerify, {}) }) : null,
-      /* @__PURE__ */ jsx20(Route, { path: "*", element: /* @__PURE__ */ jsx20(Navigate, { to: "/", replace: true }) })
+      /* @__PURE__ */ jsx21(Route, { path: "/", element: /* @__PURE__ */ jsx21(Login, {}) }),
+      /* @__PURE__ */ jsx21(Route, { path: "/signup", element: /* @__PURE__ */ jsx21(Signup, {}) }),
+      /* @__PURE__ */ jsx21(Route, { path: "/forgot", element: /* @__PURE__ */ jsx21(Forgot, {}) }),
+      /* @__PURE__ */ jsx21(Route, { path: "/reset", element: /* @__PURE__ */ jsx21(Reset, {}) }),
+      EmailVerify ? /* @__PURE__ */ jsx21(Route, { path: "/verify", element: /* @__PURE__ */ jsx21(EmailVerify, {}) }) : null,
+      /* @__PURE__ */ jsx21(Route, { path: "*", element: /* @__PURE__ */ jsx21(Navigate, { to: "/", replace: true }) })
     ] });
   }
-  return /* @__PURE__ */ jsx20(Fragment6, { children });
+  return /* @__PURE__ */ jsx21(Fragment6, { children });
 }
 function FallbackPaywall() {
   return null;
 }
 
 // src/hooks/usePush.ts
-import { useCallback as useCallback4, useEffect as useEffect8, useState as useState6 } from "react";
+import { useCallback as useCallback4, useEffect as useEffect9, useState as useState6 } from "react";
 import { useHook as useHook7 } from "@hook-sdk/sdk";
 var DISMISS_STORAGE_KEY = "push:dismissed-until";
 var DISMISS_TTL_MS2 = 7 * 24 * 60 * 60 * 1e3;
@@ -2280,7 +2361,7 @@ function deriveState(push) {
 function usePush() {
   const { push } = useHook7();
   const [state, setState] = useState6(() => deriveState(push));
-  useEffect8(() => {
+  useEffect9(() => {
     setState(deriveState(push));
   }, [push]);
   const subscribe = useCallback4(async () => {
@@ -2317,7 +2398,7 @@ function usePush() {
 }
 
 // src/components/PushPrompt.tsx
-import { jsx as jsx21, jsxs as jsxs15 } from "react/jsx-runtime";
+import { jsx as jsx22, jsxs as jsxs15 } from "react/jsx-runtime";
 function platformRecoveryCopy(texts) {
   if (typeof navigator === "undefined") return null;
   const ua = navigator.userAgent || "";
@@ -2341,27 +2422,27 @@ function PushPrompt2({ texts, onSubscribed, onDeclined, onInstallRequested, clas
   if (state.kind === "subscribed" || state.kind === "dismissed") return null;
   if (state.kind === "ios_needs_install") {
     return /* @__PURE__ */ jsxs15("div", { className, role: "region", "aria-label": texts.iosInstallTitle, children: [
-      /* @__PURE__ */ jsx21("h3", { children: texts.iosInstallTitle }),
-      /* @__PURE__ */ jsx21("p", { children: texts.iosInstallBody }),
-      onInstallRequested && texts.iosInstallCta && /* @__PURE__ */ jsx21("button", { onClick: onInstallRequested, children: texts.iosInstallCta })
+      /* @__PURE__ */ jsx22("h3", { children: texts.iosInstallTitle }),
+      /* @__PURE__ */ jsx22("p", { children: texts.iosInstallBody }),
+      onInstallRequested && texts.iosInstallCta && /* @__PURE__ */ jsx22("button", { onClick: onInstallRequested, children: texts.iosInstallCta })
     ] });
   }
   if (state.kind === "denied") {
     const recovery = platformRecoveryCopy(texts);
     return /* @__PURE__ */ jsxs15("div", { className, role: "region", "aria-label": texts.deniedTitle, children: [
-      /* @__PURE__ */ jsx21("h3", { children: texts.deniedTitle }),
-      /* @__PURE__ */ jsx21("p", { children: texts.deniedBody }),
-      recovery && /* @__PURE__ */ jsx21("p", { "data-testid": "denied-recovery", children: recovery })
+      /* @__PURE__ */ jsx22("h3", { children: texts.deniedTitle }),
+      /* @__PURE__ */ jsx22("p", { children: texts.deniedBody }),
+      recovery && /* @__PURE__ */ jsx22("p", { "data-testid": "denied-recovery", children: recovery })
     ] });
   }
   if (state.kind === "unsupported") {
-    return /* @__PURE__ */ jsx21("div", { className, role: "region", children: /* @__PURE__ */ jsx21("p", { children: texts.unsupportedBody }) });
+    return /* @__PURE__ */ jsx22("div", { className, role: "region", children: /* @__PURE__ */ jsx22("p", { children: texts.unsupportedBody }) });
   }
   if (state.kind === "error") {
-    return /* @__PURE__ */ jsx21("div", { className, role: "region", "aria-label": "error", children: /* @__PURE__ */ jsx21("p", { children: state.message }) });
+    return /* @__PURE__ */ jsx22("div", { className, role: "region", "aria-label": "error", children: /* @__PURE__ */ jsx22("p", { children: state.message }) });
   }
   return /* @__PURE__ */ jsxs15("div", { className, role: "region", children: [
-    /* @__PURE__ */ jsx21(
+    /* @__PURE__ */ jsx22(
       "button",
       {
         type: "button",
@@ -2375,23 +2456,49 @@ function PushPrompt2({ texts, onSubscribed, onDeclined, onInstallRequested, clas
         children: texts.cta
       }
     ),
-    onDeclined && /* @__PURE__ */ jsx21("button", { type: "button", onClick: onDeclined, children: texts.declineCta })
+    onDeclined && /* @__PURE__ */ jsx22("button", { type: "button", onClick: onDeclined, children: texts.declineCta })
+  ] });
+}
+
+// src/components/LanguageSwitcher.tsx
+import { usePersistedState as usePersistedState2 } from "@hook-sdk/sdk";
+import { jsx as jsx23, jsxs as jsxs16 } from "react/jsx-runtime";
+function LanguageSwitcher({ id, className, label = "Language" }) {
+  const config = useAppConfig();
+  const i18nConfig = config.i18n;
+  const [userLocale, setUserLocale] = usePersistedState2(
+    "user-locale",
+    i18nConfig?.defaultLocale ?? "en-US"
+  );
+  if (!i18nConfig) return null;
+  return /* @__PURE__ */ jsxs16("label", { className, children: [
+    label ? /* @__PURE__ */ jsx23("span", { children: label }) : null,
+    /* @__PURE__ */ jsx23(
+      "select",
+      {
+        id,
+        value: userLocale,
+        onChange: (e) => setUserLocale(e.target.value),
+        "data-testid": "language-switcher",
+        children: i18nConfig.supportedLocales.map((loc) => /* @__PURE__ */ jsx23("option", { value: loc, children: loc }, loc))
+      }
+    )
   ] });
 }
 
 // src/defaults/LoadingState.tsx
-import { jsx as jsx22 } from "react/jsx-runtime";
+import { jsx as jsx24 } from "react/jsx-runtime";
 function LoadingState({ message }) {
-  return /* @__PURE__ */ jsx22("div", { role: "status", "aria-live": "polite", style: { padding: 24, textAlign: "center" }, children: /* @__PURE__ */ jsx22("span", { children: message ?? "Carregando..." }) });
+  return /* @__PURE__ */ jsx24("div", { role: "status", "aria-live": "polite", style: { padding: 24, textAlign: "center" }, children: /* @__PURE__ */ jsx24("span", { children: message ?? "Carregando..." }) });
 }
 
 // src/defaults/EmptyState.tsx
-import { jsx as jsx23, jsxs as jsxs16 } from "react/jsx-runtime";
+import { jsx as jsx25, jsxs as jsxs17 } from "react/jsx-runtime";
 function EmptyState({ title, description, action }) {
-  return /* @__PURE__ */ jsxs16("div", { role: "status", style: { padding: 32, textAlign: "center" }, children: [
-    /* @__PURE__ */ jsx23("h2", { style: { marginBottom: 8 }, children: title }),
-    description && /* @__PURE__ */ jsx23("p", { style: { opacity: 0.7 }, children: description }),
-    action && /* @__PURE__ */ jsx23("div", { style: { marginTop: 16 }, children: action })
+  return /* @__PURE__ */ jsxs17("div", { role: "status", style: { padding: 32, textAlign: "center" }, children: [
+    /* @__PURE__ */ jsx25("h2", { style: { marginBottom: 8 }, children: title }),
+    description && /* @__PURE__ */ jsx25("p", { style: { opacity: 0.7 }, children: description }),
+    action && /* @__PURE__ */ jsx25("div", { style: { marginTop: 16 }, children: action })
   ] });
 }
 
@@ -2608,7 +2715,7 @@ function useForgotForm() {
 }
 
 // src/hooks/useResetForm.ts
-import { useCallback as useCallback8, useEffect as useEffect9, useMemo as useMemo7, useState as useState10 } from "react";
+import { useCallback as useCallback8, useEffect as useEffect10, useMemo as useMemo7, useState as useState10 } from "react";
 import { useHook as useHook11 } from "@hook-sdk/sdk";
 var MIN_PASSWORD3 = 12;
 function useResetForm() {
@@ -2622,7 +2729,7 @@ function useResetForm() {
   const [touchedPassword, setTouchedPassword] = useState10(false);
   const [touchedConfirm, setTouchedConfirm] = useState10(false);
   const [formSubmitAttempted, setFormSubmitAttempted] = useState10(false);
-  useEffect9(() => {
+  useEffect10(() => {
     if (typeof window === "undefined") return;
     const params = new URLSearchParams(window.location.search);
     const t = params.get("token");
@@ -2716,12 +2823,12 @@ function discountPercent(anchorCents, realCents) {
 }
 
 // src/hooks/useAuthPrimitives.ts
-import { useEffect as useEffect10 } from "react";
+import { useEffect as useEffect11 } from "react";
 import { useHook as useHook13 } from "@hook-sdk/sdk";
 var warned = false;
 function useAuthPrimitives() {
   const { auth } = useHook13();
-  useEffect10(() => {
+  useEffect11(() => {
     if (!warned && process.env.NODE_ENV !== "production") {
       warned = true;
       console.warn(
@@ -2766,7 +2873,7 @@ function useSubscription() {
 }
 
 // src/hooks/useReminders.ts
-import { useCallback as useCallback9, useEffect as useEffect11, useState as useState11 } from "react";
+import { useCallback as useCallback9, useEffect as useEffect12, useState as useState11 } from "react";
 import { useHook as useHook16 } from "@hook-sdk/sdk";
 function useReminders() {
   const { push } = useHook16();
@@ -2782,7 +2889,7 @@ function useReminders() {
       setLoading(false);
     }
   }, [r]);
-  useEffect11(() => {
+  useEffect12(() => {
     void reload();
   }, [reload]);
   const setReminder = useCallback9(async (input) => {
@@ -2821,20 +2928,20 @@ function useToast() {
 
 // src/RouteBoundary.tsx
 import { Routes as Routes2, Route as Route2 } from "react-router-dom";
-import { jsx as jsx24, jsxs as jsxs17 } from "react/jsx-runtime";
+import { jsx as jsx26, jsxs as jsxs18 } from "react/jsx-runtime";
 function RouteBoundary({ children }) {
-  return /* @__PURE__ */ jsxs17(Routes2, { children: [
+  return /* @__PURE__ */ jsxs18(Routes2, { children: [
     children,
-    /* @__PURE__ */ jsx24(Route2, { path: "*", element: /* @__PURE__ */ jsx24(DefaultNotFound, {}) })
+    /* @__PURE__ */ jsx26(Route2, { path: "*", element: /* @__PURE__ */ jsx26(DefaultNotFound, {}) })
   ] });
 }
 function DefaultNotFound() {
-  return /* @__PURE__ */ jsx24("div", { role: "alert", children: "P\xE1gina n\xE3o encontrada" });
+  return /* @__PURE__ */ jsx26("div", { role: "alert", children: "P\xE1gina n\xE3o encontrada" });
 }
 
 // src/PreAuthShell.tsx
 import { BrowserRouter as BrowserRouter2, MemoryRouter as MemoryRouter2, Routes as Routes3 } from "react-router-dom";
-import { jsx as jsx25 } from "react/jsx-runtime";
+import { jsx as jsx27 } from "react/jsx-runtime";
 function PreAuthShell({
   basename,
   testRouter,
@@ -2842,14 +2949,14 @@ function PreAuthShell({
   children
 }) {
   if (testRouter === "memory") {
-    return /* @__PURE__ */ jsx25(MemoryRouter2, { basename, initialEntries: testInitialEntries, children: /* @__PURE__ */ jsx25(Routes3, { children }) });
+    return /* @__PURE__ */ jsx27(MemoryRouter2, { basename, initialEntries: testInitialEntries, children: /* @__PURE__ */ jsx27(Routes3, { children }) });
   }
-  return /* @__PURE__ */ jsx25(BrowserRouter2, { basename, children: /* @__PURE__ */ jsx25(Routes3, { children }) });
+  return /* @__PURE__ */ jsx27(BrowserRouter2, { basename, children: /* @__PURE__ */ jsx27(Routes3, { children }) });
 }
 
 // src/OnboardingFlow.tsx
-import { useCallback as useCallback11, useEffect as useEffect12, useMemo as useMemo8, useRef as useRef5 } from "react";
-import { usePersistedState, useHook as useHook17 } from "@hook-sdk/sdk";
+import { useCallback as useCallback11, useEffect as useEffect13, useMemo as useMemo8, useRef as useRef5 } from "react";
+import { usePersistedState as usePersistedState3, useHook as useHook17 } from "@hook-sdk/sdk";
 
 // src/hooks/useOnboardingStep.ts
 import { createContext as createContext3, useContext as useContext4 } from "react";
@@ -2865,7 +2972,7 @@ function useOnboardingStep() {
 }
 
 // src/OnboardingFlow.tsx
-import { jsx as jsx26 } from "react/jsx-runtime";
+import { jsx as jsx28 } from "react/jsx-runtime";
 var isFilled = (v) => v != null && v !== "";
 var CURRENT_STEP_FIELD = "currentStep";
 function readPersistedStepIdx(draft) {
@@ -2878,7 +2985,7 @@ function OnboardingFlow({
   onComplete,
   persistKey
 }) {
-  const [draft, setDraft, status] = usePersistedState(persistKey, {});
+  const [draft, setDraft, status] = usePersistedState3(persistKey, {});
   const draftRef = useRef5(draft);
   draftRef.current = draft;
   const idx = readPersistedStepIdx(draft);
@@ -2903,7 +3010,7 @@ function OnboardingFlow({
   const step = steps[clampedIdx];
   const hookCtx = useHook17();
   const track2 = typeof hookCtx.track === "function" ? hookCtx.track : void 0;
-  useEffect12(() => {
+  useEffect13(() => {
     if (status.loading) return;
     if (!step) return;
     if (!track2) return;
@@ -2955,7 +3062,7 @@ function OnboardingFlow({
       `[hook-template] OnboardingFlow: missing screen component for step '${step.id}' (expected key '${step.screen}' in screens prop)`
     );
   }
-  return /* @__PURE__ */ jsx26(OnboardingStepContext.Provider, { value: ctx, children: /* @__PURE__ */ jsx26(Screen, {}) });
+  return /* @__PURE__ */ jsx28(OnboardingStepContext.Provider, { value: ctx, children: /* @__PURE__ */ jsx28(Screen, {}) });
 }
 
 // src/hooks/useFeature.ts
@@ -2970,8 +3077,10 @@ export {
   DeepLinkHandler,
   EmptyState,
   ErrorBoundary,
+  I18nProvider,
   InstallGate,
   InstallSplash,
+  LanguageSwitcher,
   LoadingState,
   OnboardingFlow,
   PaymentReturnHandler,