@proulr/rosetta 0.1.2

package/src/locales/pt-BR/common.json

@@ -0,0 +1,28 @@
+{
+  "common.active": "Ativo",
+  "common.app": "App",
+  "common.attention": "Atenção",
+  "common.cancel": "Cancelar",
+  "common.chat": "Chat",
+  "common.chats": "Chats",
+  "common.confirm": "Confirmar",
+  "common.error": "Erro",
+  "common.flashes": "Flashes",
+  "common.general": "Geral",
+  "common.huntConnectDiscover": "Caçar · Conectar · Descobrir",
+  "common.id": "ID",
+  "common.media": "Mídia",
+  "common.notifications": "Notificações",
+  "common.ops": "Ops",
+  "common.options": "Opções",
+  "common.privacy": "Privacidade",
+  "common.save": "Salvar",
+  "common.saved": "Salvo",
+  "common.security": "Segurança",
+  "common.social": "Social",
+  "common.soon": "Em breve",
+  "common.support": "Suporte",
+  "common.tagline": "Proulr — Caçar · Conectar · Descobrir",
+  "common.tryAgain": "Tente novamente.",
+  "common.version": "Versão"
+}

package/src/locales/pt-BR/discover.json

@@ -0,0 +1,33 @@
+{
+  "discover.browse.defaultLabel": "Região selecionada",
+  "discover.browse.subtitle": "Escolher região para caçar",
+  "discover.empty.creators": "Nenhum criador por perto agora.",
+  "discover.empty.default": "Ninguém por perto ainda.",
+  "discover.empty.online": "Ninguém online por perto agora.",
+  "discover.empty.position": "Ninguém com posição \"{position}\" por perto. Atualize ou mude o filtro.",
+  "discover.empty.title": "Ninguém por perto",
+  "discover.endRegion.body": "Você viu os perfis mais próximos. Ative o Caçar para explorar outras cidades sem mudar sua localização real.",
+  "discover.endRegion.cta": "Caçar em outra região",
+  "discover.endRegion.title": "Acabou a região por aqui",
+  "discover.filter.all": "Todos",
+  "discover.filter.creators": "Criadores",
+  "discover.filter.online": "Online Agora",
+  "discover.filter.position": "Posição",
+  "discover.hideDistance.body": "Enquanto essa opção estiver ativa, você não verá o grid de pessoas próximas.",
+  "discover.hideDistance.openSettings": "Abrir configurações",
+  "discover.hideDistance.title": "Você ocultou sua distância",
+  "discover.hunt.activeBody": "Você está vendo quem está em {region}. Ninguém de lá te vê — sua localização real não mudou.",
+  "discover.hunt.activeTitle": "Modo Caçar ativo",
+  "discover.hunt.changeRegion": "Mudar região",
+  "discover.hunt.otherRegion": "outra região",
+  "discover.hunt.useMyLocation": "Usar minha localização",
+  "discover.position.ativo": "Ativo",
+  "discover.position.passivo": "Passivo",
+  "discover.position.preferNot": "Prefiro não dizer",
+  "discover.position.versatil": "Versátil",
+  "discover.position.versatilAtivo": "Versátil-ativo",
+  "discover.position.versatilPassivo": "Versátil-passivo",
+  "discover.subtitle.huntingIn": "Caçando em {label}",
+  "discover.subtitle.huntingOther": "Caçando em outra região",
+  "discover.subtitle.nearby": "Encontros por proximidade"
+}

package/src/locales/pt-BR/flash.json

@@ -0,0 +1,16 @@
+{
+  "flash.deprecated.subtitle": "Migrado para o chat-bff",
+  "flash.deprecated.title": "Flashes",
+  "flash.msg.chat": "quer conversar",
+  "flash.msg.eyes": "está de olho em você",
+  "flash.msg.fire": "achou você quente",
+  "flash.msg.flash": "te enviou um Flash",
+  "flash.msg.heart": "curtiu você",
+  "flash.msg.wave": "mandou um oi",
+  "flash.reaction.chat": "Conversar",
+  "flash.reaction.eyes": "Interesse",
+  "flash.reaction.fire": "Quente",
+  "flash.reaction.flash": "Flash",
+  "flash.reaction.heart": "Curti",
+  "flash.reaction.wave": "Oi"
+}

package/src/locales/pt-BR/hybrid.json

@@ -0,0 +1,10 @@
+{
+  "report.harassment": "Assédio",
+  "report.harassment.hint": "Ameaças, humilhação ou comportamento abusivo",
+  "report.illegal": "Conteúdo ilegal",
+  "report.illegal.hint": "Material ilegal ou que viola a lei",
+  "report.other": "Outro",
+  "report.other.hint": "Outro motivo — descreva no resumo",
+  "report.spam": "Spam",
+  "report.spam.hint": "Propaganda, links suspeitos ou mensagens repetidas"
+}

package/src/locales/pt-BR/profile.json

@@ -0,0 +1,65 @@
+{
+  "profile.albums.subtitle": "Coleções privadas de fotos e vídeos",
+  "profile.albums.title": "Meus álbuns",
+  "profile.completion.banner": "Complete seu perfil para aparecer mais",
+  "profile.completion.cta": "Completar perfil",
+  "profile.completion.gateLater": "Fazer depois e começar a usar",
+  "profile.completion.gateNow": "Completar agora",
+  "profile.completion.gateTitle": "Complete seu perfil para ter mais alcance",
+  "profile.completion.reminderBody": "Perfis completos aparecem mais no Caçar e recebem mais Flashes.",
+  "profile.completion.reminderTitle": "Complete seu perfil",
+  "profile.handle.invalidFormat": "O @ deve ter 3–30 caracteres (letras minúsculas, números e _).",
+  "profile.handle.rateLimited": "Você só pode trocar o @ a cada 30 dias.",
+  "profile.handle.reserved": "Esse @ é reservado e não pode ser usado.",
+  "profile.handle.taken": "Esse @ já está em uso por outra pessoa.",
+  "profile.onboarding.corpo.interstitial": "Vamos falar sobre relacionamento.",
+  "profile.onboarding.corpo.subtitle": "Altura, peso, etnia, porte e pelos.",
+  "profile.onboarding.corpo.title": "Seu corpo",
+  "profile.onboarding.fotos.interstitial": "Em seguida, conte o que você procura.",
+  "profile.onboarding.fotos.subtitle": "Adicione suas fotos. A primeira é a principal.",
+  "profile.onboarding.fotos.title": "Mostre quem você é",
+  "profile.onboarding.identidade.interstitial": "Agora vamos adicionar suas fotos.",
+  "profile.onboarding.identidade.subtitle": "Escolha seu nome e seu @.",
+  "profile.onboarding.identidade.title": "Como podemos te chamar?",
+  "profile.onboarding.interesses.interstitial": "Agora algumas informações de saúde.",
+  "profile.onboarding.interesses.subtitle": "Interesses, tags e comunidades.",
+  "profile.onboarding.interesses.title": "Interesses",
+  "profile.onboarding.link_viagem.interstitial": "Tudo pronto para começar a usar o Proulr!",
+  "profile.onboarding.link_viagem.subtitle": "Seu link externo e seus planos de viagem.",
+  "profile.onboarding.link_viagem.title": "Link e viagem",
+  "profile.onboarding.preferencias.interstitial": "Pronto! Vamos deixar seu perfil mais completo.",
+  "profile.onboarding.preferencias.subtitle": "Gênero, em busca de e posição.",
+  "profile.onboarding.preferencias.title": "O que você procura?",
+  "profile.onboarding.redes.interstitial": "Por último, link e modo viagem.",
+  "profile.onboarding.redes.subtitle": "Conecte seus perfis nas redes.",
+  "profile.onboarding.redes.title": "Redes sociais",
+  "profile.onboarding.relacionamento.interstitial": "Conte sobre seus interesses.",
+  "profile.onboarding.relacionamento.subtitle": "Status, parceria e onde gosta de se encontrar.",
+  "profile.onboarding.relacionamento.title": "Relacionamento",
+  "profile.onboarding.saude.interstitial": "Vamos adicionar suas redes sociais.",
+  "profile.onboarding.saude.subtitle": "HIV, precauções, vacinas e práticas.",
+  "profile.onboarding.saude.title": "Saúde",
+  "profile.onboarding.sobre.interstitial": "Agora algumas informações sobre o seu corpo.",
+  "profile.onboarding.sobre.subtitle": "Uma bio curta, o que você faz e onde mora.",
+  "profile.onboarding.sobre.title": "Sobre você",
+  "profile.photo.add": "Adicionar foto",
+  "profile.photo.addPromptBody": "Perfis com foto recebem muito mais Flashes.",
+  "profile.photo.addPromptTitle": "Que tal uma foto?",
+  "profile.photo.continueWithout": "Continuar sem foto",
+  "profile.photo.huntTitle": "Foto do Caçar",
+  "profile.photo.vibesTitle": "Foto do Vibes",
+  "profile.ui.customVibesHint": "O resto do perfil continua o mesmo nos dois modos.",
+  "profile.ui.customVibesToggle": "Usar foto e nome diferentes no Vibes",
+  "profile.ui.editTitle": "Editar perfil",
+  "profile.ui.handleLabel": "SEU @",
+  "profile.ui.modeHunt": "Modo Caçar",
+  "profile.ui.modeVibes": "Modo Vibes",
+  "profile.ui.myProfile": "Meu perfil",
+  "profile.ui.nameLabel": "SEU NOME",
+  "profile.ui.photosHint": "A primeira foto é a principal do seu perfil.",
+  "profile.ui.photosTitle": "Fotos",
+  "profile.ui.save": "Salvar perfil",
+  "profile.ui.vibesName": "NOME NO VIBES",
+  "profile.ui.vibesPhoto": "FOTO NO VIBES",
+  "profile.ui.vibesPhotoHint": "Aparece ao lado do seu @ nos posts do Vibes."
+}

package/src/locales/pt-BR/shell.json

@@ -0,0 +1,201 @@
+{
+  "settings.appPreferences.subtitle": "Geral, chat, fotos e notificações",
+  "settings.appPreferences.title": "Preferências do app",
+  "settings.chat.noAutocomplete": "Sem sugestão automática",
+  "settings.chat.returnKeySends": "Tecla Retorno envia mensagem",
+  "settings.chat.savedPhrases": "Frases frequentes",
+  "settings.distanceUnits.title": "Unidades de distância",
+  "settings.language.navSubtitle": "Como exibir textos do app",
+  "settings.language.navTitle": "Idioma",
+  "settings.language.optionEn": "English",
+  "settings.language.optionPtBr": "Português (Brasil)",
+  "settings.language.optionSystem": "Sistema",
+  "settings.language.subtitle": "Textos do app",
+  "settings.language.title": "Idioma",
+  "settings.media.keepAwake": "Manter tela ligada",
+  "settings.media.uploadQuality": "Qualidade de upload",
+  "settings.notifications.adjustments": "Sons, vibração e categorias",
+  "settings.notifications.disablePush": "Desativar push",
+  "settings.notifications.navTitle": "Ajustes de notificações",
+  "settings.section.chat": "Bate-papo",
+  "settings.section.general": "Geral",
+  "settings.section.media": "Mídia e tela",
+  "settings.section.notifications": "Notificações",
+  "shell.about.build": "Build",
+  "shell.about.followIg": "Seguir no Instagram",
+  "shell.about.followX": "Seguir no X",
+  "shell.about.guidelines": "Diretrizes do perfil",
+  "shell.about.section.app": "App",
+  "shell.about.section.social": "Social",
+  "shell.about.section.terms": "Termos e políticas",
+  "shell.about.title": "Sobre",
+  "shell.consent.ads": "Publicidade personalizada",
+  "shell.consent.ads.hint": "Quando ativarmos ads, respeitaremos esta escolha",
+  "shell.consent.analytics": "Análise de uso",
+  "shell.consent.analytics.hint": "Ajuda a melhorar estabilidade e performance",
+  "shell.consent.banner": "Controle como o Proulr usa dados para anúncios e métricas. Não exibimos anúncios de terceiros no MVP, mas você pode ajustar preferências antecipadamente.",
+  "shell.consent.subtitle": "Preferências de privacidade e anúncios",
+  "shell.consent.title": "Central de consentimento",
+  "shell.deactivate.banner": "Precisa de ajuda antes de sair? Nossa equipe pode orientar sobre privacidade, bloqueios e recuperação de conta.",
+  "shell.deactivate.contactSupport": "Contatar suporte",
+  "shell.deactivate.contactSupport.hint": "Ajuda com conta, bloqueios e segurança",
+  "shell.deactivate.deleteAccount": "Excluir conta",
+  "shell.deactivate.deleteAccount.hint": "Desativa a conta e inicia a remoção dos dados",
+  "shell.deactivate.signOutDevice": "Sair deste aparelho",
+  "shell.deactivate.signOutDevice.hint": "Encerra apenas a sessão local",
+  "shell.deactivate.signOutNow": "Sair agora",
+  "shell.deactivate.subtitle": "Suporte, sair ou excluir",
+  "shell.deactivate.title": "Desativar conta",
+  "shell.dnd.clear": "Cancelar adiamento",
+  "shell.dnd.quietHours": "Horas de silêncio",
+  "shell.dnd.quietHours.hint": "Usa horário padrão 22:00–08:00",
+  "shell.dnd.quietHoursToggle": "Ativar horas de silêncio",
+  "shell.dnd.snooze": "Adiar",
+  "shell.dnd.snooze1h": "1 hora",
+  "shell.dnd.snooze8h": "8 horas",
+  "shell.dnd.subtitle": "Adiar ou silenciar por horário",
+  "shell.dnd.title": "Não perturbe",
+  "shell.dnd.untilTomorrow": "Até amanhã",
+  "shell.drawer.boost": "Boost",
+  "shell.drawer.communities": "Comunidades",
+  "shell.drawer.editProfile": "Editar perfil",
+  "shell.drawer.events": "Eventos",
+  "shell.drawer.hunt": "Caçar",
+  "shell.drawer.incognito": "Modo incógnito",
+  "shell.drawer.lists": "Listas",
+  "shell.drawer.menu": "Menu",
+  "shell.drawer.myAlbums": "Meus álbuns",
+  "shell.drawer.myProfile": "Meu perfil",
+  "shell.drawer.premium": "Premium",
+  "shell.drawer.rightNow": "Right Now",
+  "shell.drawer.safety": "Centro de segurança",
+  "shell.drawer.saved": "Itens salvos",
+  "shell.drawer.signOut": "Encerrar sessão",
+  "shell.language.en": "English",
+  "shell.language.en.hint": "App text in English",
+  "shell.language.ptBr": "Português (Brasil)",
+  "shell.language.ptBr.hint": "Textos em português do Brasil",
+  "shell.language.subtitle": "Idioma dos textos do app",
+  "shell.language.system": "Sistema",
+  "shell.language.system.hint": "Segue o idioma do aparelho",
+  "shell.language.title": "Idioma",
+  "shell.notif.appSounds": "Sons no app",
+  "shell.notif.appVibrations": "Vibrações no app",
+  "shell.notif.disablePush": "Desativar push global",
+  "shell.notif.dnd.subtitle": "Adiar ou silenciar por horário",
+  "shell.notif.inApp": "No app",
+  "shell.notif.inAppAlerts": "Alertas dentro do app",
+  "shell.notif.inAppAlerts.hint": "Toasts e banners enquanto o app está aberto",
+  "shell.notif.openSystem": "Abrir ajustes do sistema",
+  "shell.notif.openSystem.hint": "Permissão e canais de notificação do aparelho",
+  "shell.notif.pushProulr": "Push do Proulr",
+  "shell.notif.schedules": "Horários",
+  "shell.notif.subtitle": "Alertas push, sons e vibrações",
+  "shell.notif.systemMgmt": "Gestão do sistema",
+  "shell.notif.title": "Notificações",
+  "shell.prefs.distanceUnits": "Unidades de distância",
+  "shell.prefs.distanceUnits.hint": "Métrico, imperial ou sistema",
+  "shell.prefs.keepAwake": "Manter tela ligada",
+  "shell.prefs.noAutocorrect": "Desativar autocorreção",
+  "shell.prefs.notif.hint": "Push, sons e vibrações",
+  "shell.prefs.returnKeySends": "Enter envia mensagem",
+  "shell.prefs.savedPhrases": "Frases salvas",
+  "shell.prefs.savedPhrases.hint": "Atalhos no composer do chat",
+  "shell.prefs.subtitle": "Unidades, idioma, chat e mídia",
+  "shell.prefs.title": "Preferências",
+  "shell.prefs.uploadQuality": "Qualidade do upload",
+  "shell.privacy.appLock": "Bloqueio de início",
+  "shell.privacy.appLock.hint": "PIN ou biometria ao abrir o app",
+  "shell.privacy.disablePersonalization": "Desabilitar recomendações personalizadas",
+  "shell.privacy.discover": "Descobrir",
+  "shell.privacy.discreetIcon": "Ícone discreto",
+  "shell.privacy.discreetIcon.hint": "Alternar ícone na tela inicial",
+  "shell.privacy.dnd.subtitle": "Silenciar por horário ou adiar",
+  "shell.privacy.hideAge": "Ocultar idade",
+  "shell.privacy.hideDistance": "Ocultar distância",
+  "shell.privacy.hideDistance.hint": "Você some do grid e deixa de ver pessoas próximas",
+  "shell.privacy.hideFromDiscover": "Ocultar perfil da grade Global",
+  "shell.privacy.hideFromDiscover.hint": "Você deixa de aparecer no Descobrir",
+  "shell.privacy.hidePosition": "Ocultar posição",
+  "shell.privacy.hidePreview": "Ocultar prévia nas notificações",
+  "shell.privacy.hidePreview.hint": "Mostra alerta sem conteúdo da mensagem",
+  "shell.privacy.hideReadReceipts": "Ocultar confirmações de leitura",
+  "shell.privacy.hideTribes": "Ocultar tribos",
+  "shell.privacy.limitData": "Limitar dados",
+  "shell.privacy.limitPersonal": "Limitar detalhes pessoais",
+  "shell.privacy.notifAlerts": "Notificações e alertas",
+  "shell.privacy.sensitive": "Conteúdo sensível",
+  "shell.privacy.sensitiveFilter": "Filtro de conteúdo sensível",
+  "shell.privacy.sensitiveFilter.hint": "Oculta mídia explícita nas grades",
+  "shell.privacy.showHealth": "Mostrar status de saúde",
+  "shell.privacy.subtitle": "Controle o que outros veem e recebem",
+  "shell.privacy.title": "Privacidade",
+  "shell.privacy.travelIndicator": "Indicador de viagem",
+  "shell.privacy.visibility": "Visibilidade",
+  "shell.quality.adaptive": "Adaptativa",
+  "shell.quality.maximum": "Máxima",
+  "shell.quality.thumbnail": "Miniatura",
+  "shell.safety.blockReport.subtitle": "Como bloquear e reportar alguém",
+  "shell.safety.blockReport.title": "Bloqueio e denúncias",
+  "shell.safety.community.subtitle": "Regras de convivência no Proulr",
+  "shell.safety.communityGuidelines": "Diretrizes da comunidade",
+  "shell.safety.consent.subtitle": "Respeito e limites nas conversas",
+  "shell.safety.consent.title": "Consentimento",
+  "shell.safety.dataAccess.subtitle": "Exportação e privacidade (LGPD)",
+  "shell.safety.dataAccess.title": "Acessar seus dados",
+  "shell.safety.getHelp": "Obter ajuda",
+  "shell.safety.getHelp.hint": "Fale com o suporte",
+  "shell.safety.location.subtitle": "Como usamos sua posição",
+  "shell.safety.location.title": "Localização",
+  "shell.safety.meeting.subtitle": "Dicas para se encontrar com mais tranquilidade",
+  "shell.safety.meeting.title": "Segurança em encontros",
+  "shell.safety.privacySettings.subtitle": "Controle o que outros veem",
+  "shell.safety.privacySettings.title": "Configurações de privacidade",
+  "shell.safety.quickHelp": "Ajuda rápida",
+  "shell.safety.scams.subtitle": "Como identificar perfis suspeitos",
+  "shell.safety.scams.title": "Golpes e assédio",
+  "shell.safety.section.privacy": "Privacidade",
+  "shell.safety.section.safety": "Segurança",
+  "shell.safety.subtitle": "Guias, ajuda e privacidade",
+  "shell.safety.title": "Central de segurança",
+  "shell.settings.aboutProulr": "Sobre o Proulr",
+  "shell.settings.appIcon": "Ícone do app",
+  "shell.settings.appLock": "Bloqueio do app",
+  "shell.settings.blockedHidden": "Bloqueados e ocultos",
+  "shell.settings.deactivate": "Desativar conta",
+  "shell.settings.device": "Dispositivo",
+  "shell.settings.dnd": "Não perturbe",
+  "shell.settings.downloadData": "Baixar dados",
+  "shell.settings.editProfile": "Editar perfil",
+  "shell.settings.editProfile.subtitle": "Atualize suas informações",
+  "shell.settings.email": "E-mail",
+  "shell.settings.muted": "Silenciados",
+  "shell.settings.preferences": "Preferências",
+  "shell.settings.privacy": "Privacidade",
+  "shell.settings.privacyPolicy": "Política de Privacidade",
+  "shell.settings.push.message": "Ative para receber Flashes e mensagens na bandeja.",
+  "shell.settings.push.title": "Notificações push",
+  "shell.settings.safetyCenter": "Central de segurança",
+  "shell.settings.section.account": "Conta",
+  "shell.settings.sessions": "Sessões",
+  "shell.settings.signOut": "Sair",
+  "shell.settings.subscriptions": "Assinaturas",
+  "shell.settings.subscriptions.subtitle": "Planos e benefícios",
+  "shell.settings.support": "Suporte",
+  "shell.settings.terms": "Termos de Serviço",
+  "shell.settings.title": "Configurações",
+  "shell.settings.version": "Versão",
+  "shell.soon.feature": "{label} estará disponível em breve.",
+  "shell.tab.chat": "Chat",
+  "shell.tab.discover": "Caçar",
+  "shell.tab.vibes": "Vibes",
+  "shell.units.distance": "Distância",
+  "shell.units.imperial": "Imperial",
+  "shell.units.imperial.hint": "Milhas e pés",
+  "shell.units.metric": "Métrico",
+  "shell.units.metric.hint": "Quilômetros e centímetros",
+  "shell.units.subtitle": "Como exibir distâncias no app",
+  "shell.units.system": "Sistema",
+  "shell.units.system.hint": "Segue o idioma do aparelho",
+  "shell.units.title": "Unidades"
+}

package/src/locales/pt-BR/social.json

@@ -0,0 +1,12 @@
+{
+  "social.fab.photos": "Fotos",
+  "social.fab.publish": "Publicar",
+  "social.fab.story": "Story",
+  "social.feed.fab": "Criar no Feed",
+  "social.feed.subtitle": "Publicações da comunidade",
+  "social.feed.title": "Feed",
+  "social.saved.title": "Itens salvos",
+  "social.vibes.fab": "Criar no Vibes",
+  "social.vibes.subtitle": "O que a comunidade está dizendo",
+  "social.vibes.title": "Vibes"
+}

package/src/resolve-locale.ts

@@ -0,0 +1,85 @@
+import {
+  DEFAULT_PROULR_LOCALE,
+  PROULR_LOCALES,
+  type ProulrLocale,
+  type ProulrLocalePref,
+} from './locale-types';
+
+const PROULR_LOCALE_SET: ReadonlySet<string> = new Set(PROULR_LOCALES);
+
+export function isProulrLocale(value: string | undefined | null): value is ProulrLocale {
+  return typeof value === 'string' && PROULR_LOCALE_SET.has(value);
+}
+
+export function isProulrLocalePref(value: string | undefined | null): value is ProulrLocalePref {
+  return value === 'system' || isProulrLocale(value);
+}
+
+/** Resolve from BFF/screen query (`locale` preferred, then `app_locale`). */
+export function resolveLocaleFromQuery(
+  query: Record<string, string> | undefined | null,
+): ProulrLocale {
+  if (!query) return DEFAULT_PROULR_LOCALE;
+  if (isProulrLocale(query.locale)) return query.locale;
+  if (isProulrLocale(query.app_locale)) return query.app_locale;
+  return DEFAULT_PROULR_LOCALE;
+}
+
+export function resolveLocaleFromPref(
+  pref: ProulrLocalePref,
+  systemLocale: ProulrLocale,
+): ProulrLocale {
+  if (pref === 'system') return systemLocale;
+  return pref;
+}
+
+/**
+ * Map BCP-47 / language tag from the device to a supported Proulr locale.
+ * Exact match first, then language-prefix match against `PROULR_LOCALES`.
+ */
+export function resolveLocaleFromSystemTag(languageTag: string | undefined | null): ProulrLocale {
+  const tag = (languageTag ?? 'pt-br').toLowerCase();
+
+  for (const locale of PROULR_LOCALES) {
+    if (locale.toLowerCase() === tag) return locale;
+  }
+
+  let best: ProulrLocale | null = null;
+  let bestScore = -1;
+  for (const locale of PROULR_LOCALES) {
+    const lower = locale.toLowerCase();
+    const primary = lower.split('-')[0] ?? lower;
+    if (tag === primary || tag.startsWith(`${primary}-`) || lower.startsWith(`${tag}-`)) {
+      const score = lower.length;
+      if (score > bestScore) {
+        best = locale;
+        bestScore = score;
+      }
+    }
+  }
+
+  return best ?? DEFAULT_PROULR_LOCALE;
+}
+
+/**
+ * Pick the best supported locale from a list of BCP-47 tags
+ * (device locales, `navigator.languages`, Accept-Language, …).
+ */
+export function resolveLocaleFromSystemTags(
+  languageTags: Array<string | undefined | null>,
+): ProulrLocale {
+  const tags = languageTags
+    .map((tag) => (typeof tag === 'string' ? tag.trim() : ''))
+    .filter(Boolean);
+
+  for (const tag of tags) {
+    const resolved = resolveLocaleFromSystemTag(tag);
+    // Accept non-default when the tag clearly matched a supported locale.
+    if (resolved !== DEFAULT_PROULR_LOCALE || tag.toLowerCase().startsWith('pt')) {
+      return resolved;
+    }
+  }
+
+  if (tags[0]) return resolveLocaleFromSystemTag(tags[0]);
+  return DEFAULT_PROULR_LOCALE;
+}

package/src/translate.ts

@@ -0,0 +1,18 @@
+import { getMessage, type ProulrMessageKey } from './catalog';
+import { DEFAULT_PROULR_LOCALE, type ProulrLocale } from './locale-types';
+
+export function t(key: ProulrMessageKey, locale: ProulrLocale = DEFAULT_PROULR_LOCALE): string {
+  return getMessage(key, locale);
+}
+
+export function tFormat(
+  key: ProulrMessageKey,
+  locale: ProulrLocale,
+  vars: Record<string, string | number>,
+): string {
+  let out = t(key, locale);
+  for (const [name, value] of Object.entries(vars)) {
+    out = out.split(`{${name}}`).join(String(value));
+  }
+  return out;
+}