Configuração de i18n no Next.js (nextjs-i18n-setup)

O que Configuração de i18n no Next.js (nextjs-i18n-setup) faz?

Inicializa e organiza next-intl em um projeto Next.js existente que usa App Router, empregando next/root-params moderno, o segmento dinâmico app/[locale]/ e Next.js 16+ (proxy.ts) / Next.js <=15 (middleware.ts).

[!TIP] Boilerplate e Modelos: Consulte references/templates.md para modelos de código prontos para uso ao criar arquivos. Execução Rápida: Delegue a verificação a um subagente leve (Model: 'flash').

---

1. Regras e Requisitos Arquiteturais

1. Contrato de Metadados: Garanta que docs/project.json contenha:

   "dictionaries_dir": "messages",
   "dictionary_file_pattern": "[locale].json"
   

2. Interceptador de Versão do Next.js:
   • Next.js 16+: Use proxy.ts (ou src/proxy.ts). Migre e remova qualquer middleware.ts legado.
   • Next.js <=15: Use middleware.ts (ou src/middleware.ts).
3. Root Params Moderno: Use next/root-params (await rootParams.locale()) em i18n/request.ts. O uso de requestLocale e setRequestLocale() é proibido.
4. Navegação: Exporte Link, redirect, usePathname, useRouter de i18n/navigation.ts (TypeScript puro, sem JSX).
5. Geração Estática: O layout raiz app/[locale]/layout.tsx DEVE exportar generateStaticParams() retornando { locale } para todos os locales suportados.

---

2. Checklist de Configuração

• Etapa 0: Auditoria: Verifique docs/project.json (supported_languages) e a versão do Next.js em package.json.
• Etapa 1: Instalação: Execute <pkg_mgr> add next-intl (ex.: pnpm add next-intl).
• Etapa 2: Metadados de Configuração: Garanta dictionaries_dir: "messages" em docs/project.json.
• Etapa 3: Roteamento: Crie i18n/routing.ts usando defineRouting (veja modelos).
• Etapa 4: Manipulador de Requisições: Crie i18n/request.ts usando next/root-params (veja modelos).
• Etapa 5: Helpers de Navegação: Crie i18n/navigation.ts (veja modelos).
• Etapa 6: Plugin do Next.js: Envolva next.config.ts com createNextIntlPlugin() (veja modelos).
• Etapa 7: Interceptador: Crie proxy.ts (Next 16+) ou middleware.ts (Next <=15) com seletor de filtro de assets (veja modelos).
• Etapa 8: Dicionários Iniciais: Garanta que messages/[locale].json exista para todos os locales suportados com as chaves base correspondentes.
• Etapa 9: Migrar Layout e Rotas: Mova as rotas de nível superior para app/[locale]/. Configure dir, lang, generateStaticParams e <NextIntlClientProvider> dinâmicos (veja modelos).
• Etapa 10: Aumento de Tipos: Declare AppConfig.Messages em global.d.ts (veja modelos).
• Etapa 11: Importações de Navegação: Atualize links internos em componentes existentes para usar @/i18n/navigation.
• Etapa 12: Verificação: Execute o script de verificação e a build:

  pwsh .agents/skills/nextjs-i18n-setup/scripts/verify-setup.ps1 -Quiet
  pnpm run build
  

---

3. Modelo de Relatório de Execução da Configuração

## 🌐 Relatório de Execução da Configuração de i18n no Next.js

| Etapa / Componente   | Arquivo(s) Alvo              | Status                          | Observações                  |
| :------------------- | :--------------------------- | :------------------------------ | :--------------------------- |
| **Pacote**           | `package.json` (`next-intl`) | `[IMPLEMENTADO]` / `[NÃO TOCADO]` | Runtime instalado            |
| **Config. Projeto**  | `docs/project.json`          | `[IMPLEMENTADO]` / `[NÃO TOCADO]` | Diretório de mensagens config.|
| **Roteamento**       | `i18n/routing.ts`            | `[IMPLEMENTADO]` / `[NÃO TOCADO]` | Locales e padrão             |
| **Requisição**       | `i18n/request.ts`            | `[IMPLEMENTADO]` / `[NÃO TOCADO]` | next/root-params             |
| **Navegação**        | `i18n/navigation.ts`         | `[IMPLEMENTADO]` / `[NÃO TOCADO]` | Helpers TypeScript puros     |
| **Plugin**           | `next.config.ts`             | `[IMPLEMENTADO]` / `[NÃO TOCADO]` | Envolto com withNextIntl     |
| **Interceptador**    | `proxy.ts` / `middleware.ts` | `[IMPLEMENTADO]` / `[NÃO TOCADO]` | Seletor de rotas             |
| **Dicionários**      | `messages/[locale].json`     | `[IMPLEMENTADO]` / `[NÃO TOCADO]` | Dicionários iniciais         |
| **Layout**           | `app/[locale]/layout.tsx`    | `[IMPLEMENTADO]` / `[NÃO TOCADO]` | Parâmetros estáticos & provider|
| **Tipos**            | `global.d.ts`                | `[IMPLEMENTADO]` / `[NÃO TOCADO]` | Aumento AppConfig            |
| **Verificação**      | `verify-setup.ps1` & build   | `[APROVADO]`                     | Build limpa                  |