@intlayer/docs 9.4.4 → 9.5.0

package/docs/pl/self_hosting.md

@@ -35,8 +35,6 @@ Jedyną zewnętrzną zależnością jest **MongoDB**: backend łączy się z kla
 
 <TOC/>
 
----
-
 ## Architektura
 
 ```
@@ -56,8 +54,6 @@ Jedyną zewnętrzną zależnością jest **MongoDB**: backend łączy się z kla
 
 Chromium (używany do generowania zrzutów ekranu przez Puppeteer) jest dołączony do obrazu backendu — nie jest potrzebny oddzielny kontener.
 
----
-
 ## Wymagania wstępne
 
 - **Docker** ≥ 24 i **Docker Compose** ≥ v2. Jeśli którykolwiek z nich jest brakujący, instalator wyświetli link do instalacji i zakończy działanie.
@@ -66,8 +62,6 @@ Chromium (używany do generowania zrzutów ekranu przez Puppeteer) jest dołącz
 
 Wszystko inne — Bun, Redis, MinIO, Chromium — jest dołączone do obrazu.
 
----
-
 ## Szybki start
 
 ### 1. Uruchom instalator
@@ -136,8 +130,6 @@ curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer
 
 > Cztery zmienne portów zmieniają tylko **stronę hosta** mapowania wydrukowanego w poleceniu `docker run`. Opublikowany obraz ma `http://localhost:3000`, `http://localhost:3100` i `http://localhost:9000` skompilowane w bundle'u dashboardu w czasie kompilacji, dlatego zmapowanie ich na nowo powoduje, że przeglądarka wskazuje na stare porty. Zachowaj wartości domyślne, chyba że budujesz swój własny obraz — zobacz [Ograniczenia](#limitations).
 
----
-
 ## Szybki start
 
 Co robi instalator:
@@ -150,8 +142,6 @@ Co robi instalator:
 
 Po uruchomieniu stosu, otwórz **http://localhost:3000** i utwórz swoje pierwsze konto.
 
----
-
 ## Usługi
 
 | Usługa        | Obraz                                 | Port(y) hosta                            | Cel                                                               |
@@ -165,8 +155,6 @@ Po uruchomieniu stosu, otwórz **http://localhost:3000** i utwórz swoje pierwsz
 
 > Port MinIO `9000` musi być osiągalny przez przeglądarkę, ponieważ przesłane zasoby (awatary, zrzuty ekranu) są ładowane bezpośrednio z `S3_PUBLIC_URL=http://localhost:9000/intlayer`.
 
----
-
 ## Zmienne środowiskowe
 
 ### Wymagane
@@ -236,8 +224,6 @@ Ustaw `MAIL_PROVIDER`, aby go aktywować. Jeśli nie jest ustawiony, używany je
 
 > Priorytet: własny dostawca poczty organizacji (skonfigurowany z pulpitu **Organizacji**) ma priorytet nad globalnym dostawcą poczty, który z kolei ma priorytet nad domyślnym kluczem Resend.
 
----
-
 ## Łączenie Twojego projektu Intlayer
 
 Po uruchomieniu stosu, skieruj swój projekt na samodzielnie hostowany backend i pulpit nawigacyjny zamiast na `intlayer.org`.
@@ -299,8 +285,6 @@ const cms = createIntlayerCMS({
 const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
 ```
 
----
-
 ## Aktualizacja
 
 Spowoduje to pobranie najnowszych obrazów i ponowne uruchomienie kontenerów za pomocą `docker compose pull && docker compose up -d`. Istniejące woluminy (`mongo-data`, `redis-data`, `minio-data`) zostaną zachowane — brak utraty danych.
@@ -310,8 +294,6 @@ docker compose pull
 docker compose up -d
 ```
 
----
-
 ## Kopia zapasowa i przywracanie
 
 Wszystkie trwałe dane znajdują się w trzech nazwach woluminów Docker.
@@ -346,16 +328,12 @@ docker run --rm \
 # Powtórz dla redis-data i minio-data
 ```
 
----
-
 ## Ograniczenia
 
 - **MongoDB musi być zewnętrzna (Atlas).** Backend łączy się tylko przez `mongodb+srv://` (zbudowany z `DB_ID` / `DB_MDP` / `DB_CLUSTER`), więc zwykły `mongodb://host:27017` — w tym wbudowany `mongod` kontenera — nie może być używany. Zapewnij klaster MongoDB Atlas.
 - **Brak niestandardowej domeny.** Wszystkie adresy URL `VITE_*` dostępne w przeglądarce są wbudowywane w aplikację w czasie kompilacji, a opublikowany obraz zawiera wartości `localhost`. Dostęp do dashboardu musi być realizowany pod adresem `http://localhost:3000`; udostępnienie go w domenie publicznej wymagałoby przebudowania obrazu z docelowymi adresami URL wbakowanymi w kod i nie jest obsługiwane out of the box.
 - **Email wymaga działającego mailera.** Konfiguracja przy pierwszym uruchomieniu wymusza weryfikację email, więc musi być skonfigurowany `RESEND_API_KEY` lub [globalny mailer SMTP](#global-mailer) (`MAIL_PROVIDER=smtp` + `MAIL_SMTP_*`). Po zalogowaniu się pierwszego administratora każda organizacja może również skonfigurować swój własny mailer SMTP lub Resend z dashboardu.
 
----
-
 ## Rozwiązywanie problemów
 
 ### Backend w pętli awarii przy pierwszym uruchomieniu
@@ -382,8 +360,6 @@ Jeśli jednorazowa usługa `minio-init` nie uruchomiła się (lub uruchomiła si
 docker compose run --rm minio-init
 ```
 
----
-
 ## Przydatne linki
 
 - [Dokumentacja Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_CMS.md)

package/docs/pl/testing.md

@@ -27,16 +27,12 @@ author: aymericzip
 
 Ten przewodnik pokazuje, jak automatycznie weryfikować kompletność słowników, wykrywać brakujące tłumaczenia przed wdrożeniem oraz testować zlokalizowany interfejs użytkownika w Twojej aplikacji.
 
----
-
 ## Co możesz testować
 
 - **Brakujące tłumaczenia**: przerwij CI, jeśli w którymkolwiek słowniku brakuje wymaganych lokalizacji.
 - **Renderowanie zlokalizowanego UI**: renderuj komponenty z określonym dostawcą lokalizacji i sprawdzaj widoczny tekst/atrybuty.
 - **Audyt w czasie budowania**: uruchom szybki audyt lokalnie za pomocą CLI.
 
----
-
 ## Szybki start: audyt przez CLI
 
 Uruchom audyt z katalogu głównego projektu:
@@ -68,8 +64,6 @@ Przydatne flagi:
 
 Uwaga: CLI generuje szczegółowy raport, ale nie zwraca kodu błędu przy niepowodzeniach. Aby zabezpieczyć CI, dodaj test jednostkowy (poniżej), który sprawdza brak brakujących wymaganych lokalizacji.
 
----
-
 ## Test programowy (Vitest/Jest)
 
 Użyj API Intlayer CLI, aby sprawdzić, czy nie brakuje tłumaczeń dla wymaganych lokalizacji.
@@ -117,8 +111,6 @@ Jak to działa:
   - `missingLocales`: zbiór wszystkich brakujących lokalizacji.
   - `missingRequiredLocales`: podzbiór ograniczony do `requiredLocales` (lub wszystkich lokalizacji, jeśli `requiredLocales` nie jest ustawione).
 
----
-
 ## Testowanie lokalizowanego UI (React / Next.js)
 
 Renderuj komponenty w ramach providera Intlayer i sprawdzaj widoczną zawartość.
@@ -165,8 +157,6 @@ Wskazówki:
 - Gdy potrzebujesz surowych wartości tekstowych dla atrybutów (np. `aria-label`), uzyskaj dostęp do pola `.value` zwracanego przez `useIntlayer` w React.
 - Przechowuj słowniki razem z komponentami, aby ułatwić testy jednostkowe i sprzątanie.
 
----
-
 ## Continuous Integration
 
 Dodaj test, który przerwie budowanie, gdy braknie wymaganych tłumaczeń.
@@ -216,8 +206,6 @@ pnpm intlayer content test --verbose
 bun x intlayer content test --verbose
 ```
 
----
-
 ## Rozwiązywanie problemów
 
 - Upewnij się, że Twoja konfiguracja Intlayer definiuje `locales` oraz (opcjonalnie) `requiredLocales`.

package/docs/pt/analytics.md

@@ -35,8 +35,6 @@ O `@intlayer/analytics` é um pacote complementar opcional que informa **qual co
 
 <TOC/>
 
----
-
 ## O que ele rastreia
 
 O `@intlayer/analytics` agrupa três tipos de eventos anônimos:

package/docs/pt/bundle_optimization.md

@@ -133,8 +133,6 @@ Durante o `next build`, o `withIntlayer` analisa seus fontes, reescreve os dicio
 
 > Purge e minificação são executados apenas no `next build` — o pipeline de otimização fica desligado durante o `next dev`.
 
-> Eles também são desativados quando chamadores de adaptadores de compatibilidade estão configurados (`swcExtraCallers`, definidos pelos pacotes de compatibilidade como `@intlayer/next-intl` ou `@intlayer/react-i18next`): esses pontos de chamada são invisíveis para o analisador de uso, então o purge removeria campos que o código ainda lê. A reescrita de imports permanece ativa.
-
 **Versões anteriores (antes da 9.2.1)** exigiam `@intlayer/babel` e um `babel.config.js` declarando `intlayerPurgeBabelPlugin` e `intlayerMinifyBabelPlugin`. Esse arquivo não é mais necessário e pode ser excluído.
 
  </Tab>

package/docs/pt/cli/index.md

@@ -70,14 +70,10 @@ author: aymericzip
 
 # CLI Intlayer - Todos os comandos do CLI Intlayer para o seu site multilíngue
 
----
-
 ## Índice
 
 <TOC/>
 
----
-
 ## Instalar Pacote
 
 Instale os pacotes necessários utilizando o npm:

package/docs/pt/cli/login.md

@@ -20,8 +20,6 @@ author: aymericzip
 
 # Comando de Login do Intlayer CLI
 
----
-
 ## Descrição
 
 O comando `login` do Intlayer CLI permite que você se autentique no Intlayer CMS. Este comando abre automaticamente o seu navegador padrão para concluir o processo de autenticação e receber as credenciais necessárias (Client ID e Client Secret) para usar os serviços do Intlayer.

package/docs/pt/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-03-12
+updatedAt: 2026-09-08
 title: Intlayer Compiler | Extração Automática de Conteúdo para i18n
 description: Automatize seu processo de internacionalização com o Intlayer Compiler. Extraia conteúdo diretamente dos seus componentes para uma i18n mais rápida e eficiente em Vite, Next.js e mais.
 keywords:
@@ -68,7 +68,7 @@ Como alternativa, para automatizar seu processo i18n mantendo controle total sob
 
 ## Uso
 
-> A forma mais rápida de integrar o compiler é através da configuração interativa: execute `npx intlayer init --interactive` e selecione **Compiler**. No Vite não há nada para configurar — o compiler é conectado diretamente através do plugin principal `intlayer()` (é ativado automaticamente uma vez que `compiler.enabled` está definido e um caminho `compiler.output` é configurado). No Next.js o comando gera o `babel.config.js` mostrado abaixo. O `intlayer init` não-interativo deixa a configuração do compiler intocada.
+> A forma mais rápida de integrar o compilador é a configuração interativa: execute `npx intlayer init --interactive` e selecione **Compiler**. No Next.js e Vite, ele é ativado automaticamente assim que `compiler.enabled` estiver definido e um caminho `compiler.output` for configurado.
 
 <Tabs>
  <Tab value='vite'>
@@ -92,19 +92,13 @@ import { defineConfig } from "vite";
 import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
-  plugins: [
-    intlayer({
-      proxy: {
-        ignore: (req) => req.url?.startsWith("/api"),
-      },
-    }),
-  ],
+  plugins: [intlayer()],
 });
 ```
 
 > O plugin `intlayerCompiler()` independente ainda é exportado para configurações avançadas. Registrá-lo junto com `intlayer()` é seguro — o compilador se deduplica e é executado apenas uma vez.
 
-See complete tutorial: [Intlayer Compiler with Vite+React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_with_vite+react_compiler.md)
+See complete tutorial: [Translate Vite and React with Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_with_vite+react.md)
 
 #### Suporte a Frameworks
 
@@ -131,7 +125,33 @@ npm install @intlayer/svelte-compiler
  </Tab>
  <Tab value='nextjs'>
 
-### Next.js (Babel)
+### Next.js
+
+No Next.js o compilador é executado como um bundler loader, `next-intlayer/extractor-loader`. O `withIntlayer` o registra para você **tanto** no Turbopack quanto no webpack, não há `babel.config.js` para escrever.
+
+#### Instalação
+
+```bash
+npm install @intlayer/babel
+```
+
+#### Configuração
+
+Nada a configurar. Desde que seu `next.config.ts` passe pelo `withIntlayer`, instalar `@intlayer/babel` é suficiente para que o loader seja registrado:
+
+```ts fileName="next.config.ts"
+import { withIntlayer } from "next-intlayer/server";
+
+export default withIntlayer({});
+```
+
+O loader roda em arquivos `.tsx` e `.jsx`, antes do `next-swc-loader`, lendo assim seu JSX original. O conteúdo declarado em seus componentes é extraído para arquivos `.content` e compilado no `.intlayer` conforme o arquivo é compilado.
+
+</Tab>
+
+ <Tab value="Babel">
+
+### Babel
 
 Para Next.js ou outras aplicações baseadas em Webpack que usam Babel, você pode configurar o compilador usando o plugin `@intlayer/babel`.
 
@@ -166,8 +186,6 @@ module.exports = {
 
 Esta configuração garante que o conteúdo declarado em seus componentes seja automaticamente extraído e usado para gerar dicionários durante o processo de build.
 
-See complete tutorial: [Intlayer Compiler with Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_with_nextjs_compiler.md)
-
  </Tab>
 </Tabs>
 

package/docs/pt/configuration.md

@@ -122,14 +122,10 @@ author: aymericzip
 
 Os arquivos de configuração do Intlayer permitem que você personalize vários aspetos do plugin, como internacionalização, middleware e gestão de conteúdo. Este documento fornece uma descrição detalhada de cada propriedade na configuração.
 
----
-
 ## Índice
 
 <TOC/>
 
----
-
 ## Suporte de Ficheiros de Configuração
 
 O Intlayer aceita os formatos de ficheiro de configuração JSON, JS, MJS e TS:
@@ -143,8 +139,6 @@ O Intlayer aceita os formatos de ficheiro de configuração JSON, JS, MJS e TS:
 - `intlayer.config.mjs`
 - `.intlayerrc`
 
----
-
 ## Exemplo de Ficheiro de Configuração
 
 ````typescript fileName="intlayer.config.ts" codeFormat="typescript"
@@ -698,14 +692,10 @@ const config: IntlayerConfig = {
 export default config;
 ````
 
----
-
 ## Referência de Configuração
 
 As secções seguintes descrevem as várias definições de configuração disponíveis para o Intlayer.
 
----
-
 ### Configuração de Internacionalização
 
 Define as definições relacionadas com a internacionalização, incluindo os idiomas disponíveis e o idioma padrão para a aplicação.
@@ -717,8 +707,6 @@ Define as definições relacionadas com a internacionalização, incluindo os id
 | `strictMode`      | Garante implementações robustas de conteúdos internacionalizados usando TypeScript. | `string`   | `'inclusive'`       |                      | • Se `"strict"`: a função `t` exige que cada idioma declarado esteja definido - lança um erro se faltar algum ou se não estiver declarado.<br/>• Se `"inclusive"`: avisa sobre idiomas em falta mas aceita idiomas existentes não declarados.<br/>• Se `"loose"`: aceita qualquer idioma existente. |
 | `defaultLocale`   | O idioma padrão usado como fallback se o idioma solicitado não for encontrado.      | `string`   | `Locales.ENGLISH`   | `'en'`               | Usado para determinar o idioma quando nenhum é especificado no URL, cookie ou cabeçalho.                                                                                                                                                                                                            |
 
----
-
 ### Configuração do Editor
 
 Define as definições para o editor visual integrado, incluindo a porta do servidor e o estado de ativação.
@@ -750,8 +738,6 @@ Os analytics são de exclusão (opt-out): estão ativados por predefinição e c
 | `flushInterval` | Milissegundos entre os envios automáticos em lote para o backend.                            | `number`  | `20000` | `10000` |                                                                                                                                                                                                   |
 | `sampleRate`    | Fração de sessões a registar, de `0` (nenhuma) a `1` (todas).                                | `number`  | `1`     | `0.5`   | A amostragem é determinística por sessão, pelo que uma sessão registada reporta todos os seus eventos (sem funis parciais).                                                                       |
 
----
-
 ### Configuração de Roteamento
 
 Definições que controlam o comportamento do roteamento, incluindo estrutura de URL, armazenamento de idiomas e gestão de middleware.
@@ -953,8 +939,6 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
----
-
 ### Configuração de Conteúdo
 
 Definições relacionadas à forma como o conteúdo é gerido dentro da aplicação, incluindo nomes de diretórios, extensões de ficheiro e configurações derivadas.
@@ -968,8 +952,6 @@ Definições relacionadas à forma como o conteúdo é gerido dentro da aplicaç
 | `excludedPath`   | Diretórios excluídos da análise de conteúdo.                                                                         | `string[]` | `['**/node_modules/**', '**/dist/**', '**/build/**', '**/.intlayer/**', '**/.next/**', '**/.nuxt/**', '**/.expo/**', '**/.vercel/**', '**/.turbo/**', '**/.tanstack/**']` |                                                                                                                                                                                       | Ainda não utilizado; planeado para implementação futura.                                                                                         |
 | `formatCommand`  | Comando para formatar ficheiros de conteúdo quando o Intlayer os escreve localmente.                                 | `string`   | `undefined`                                                                                                                                                               | `'npx prettier --write "{{file}}" --log-level silent'` (Prettier), `'npx biome format "{{file}}" --write --log-level none'` (Biome), `'npx eslint --fix "{{file}}" --quiet'` (ESLint) | • `{{file}}` é substituído pelo caminho do ficheiro.<br/>• Se não definido, o Intlayer deteta automaticamente (testa prettier, biome, eslint).   |
 
----
-
 ### Configuração do Sistema
 
 Configurações relacionadas a caminhos internos e resultados de saída do Intlayer. Essas configurações são tipicamente internas e não devem precisar ser modificadas pelo usuário.
@@ -1024,8 +1006,6 @@ dictionary: {
 };
 ```
 
----
-
 ### Configuração do Logger
 
 Definições para personalizar a saída de logs do Intlayer.
@@ -1096,8 +1076,6 @@ As opções de build aplicam-se aos plugins `@intlayer/babel` e `@intlayer/swc`.
 | `outputFormat`        | Controla o formato de saída dos dicionários.                                                                                       | `('esm' &#124; 'cjs')[]`         | `['esm', 'cjs']`                                                                                                                                                                  | `['cjs']`                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
 | `traversePattern`     | Padrões que definem quais ficheiros percorrer durante a otimização.                                                                | `string[]`                       | `['**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}', '!**/node_modules/**', '!**/dist/**', '!**/.intlayer/**', '!**/*.config.*', '!**/*.test.*', '!**/*.spec.*', '!**/*.stories.*']` | `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']` | • Limite a otimização a ficheiros relevantes para melhorar o desempenho da build.<br/>• Ignorado se `optimize` estiver desativado.<br/>• Utiliza padrões glob.                                                                                                                                                                                                                                                                                                                                                                                                                                    |
 
----
-
 ### Configuração do Compilador
 
 Configurações que controlam o compilador do Intlayer, que extrai dicionários diretamente das suas componentes.
@@ -1116,8 +1094,6 @@ Configurações que controlam o compilador do Intlayer, que extrai dicionários
 | --------- | --------------------------------------------------------------------------- | --------------------------- |
 | `schemas` | Permite definir esquemas Zod para validar a estrutura dos seus dicionários. | `Record<string, ZodSchema>` |
 
----
-
 ### Plugins
 
 | Campo     | Descrição                              | Tipo               |
@@ -1133,25 +1109,21 @@ Configurações que controlam o compilador do Intlayer, que extrai dicionários
 Na raiz do seu projeto, ao lado do `package.json`. O Intlayer também aceita `intlayer.config.js`, `intlayer.config.mjs`, `intlayer.config.cjs` e JSON, adaptando-se a qualquer sistema de módulos que seu projeto utilize.
 
 </Question>
-
 <Question title="Quanto a i18n adiciona ao tamanho do bundle?">
 
 Muito menos do que uma configuração baseada em namespaces, porque uma página nunca baixa um catálogo que não renderiza. O markup renderizado no servidor resolve seu conteúdo no próprio servidor, e o compilador em tempo de build substitui as chamadas `useIntlayer` pelas entradas exatas que o componente utiliza, descartando chaves e idiomas não utilizados. Os [dicionários dinâmicos](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dynamic_dictionaries/index.md) dividem o restante por locale. Comparado às alternativas habituais, o Intlayer reduz o tamanho do bundle e da página em até 50%. Consulte [otimização de bundle](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/bundle_optimization.md) e o [benchmark](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/benchmark/index.md).
 
 </Question>
-
 <Question title="Posso migrar do i18next, next-intl ou react-i18next sem reescrever meus componentes?">
 
 Sim, e existem dois caminhos. Você pode migrar o conteúdo progressivamente com o [guia de migração do i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/migration_from_i18next_to_intlayer.md) ou o [guia de migração do next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/migration_from_next-intl_to_intlayer.md). Ou você pode manter sua API atual integralmente: os [adaptadores de compatibilidade (compat adapters)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/compat/index.md) expõem exatamente a mesma interface de `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` e `Lingui`, porém alimentados pelos dicionários do Intlayer, permitindo que apenas os imports mudem enquanto o código dos componentes permanece idêntico.
 
 </Question>
-
 <Question title="Posso manter meus arquivos de tradução JSON existentes?">
 
 Sim. O [plugin sync JSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/plugins/sync-json.md) mantém seus arquivos `/messages/{locale}/{namespace}.json` como fonte de verdade e gera dicionários Intlayer a partir deles, em ambas as direções. O [plugin sync PO](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/plugins/sync-po.md) faz o mesmo para catálogos gettext, e os [arquivos por locale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/per_locale_file.md) permitem dividir o conteúdo por idioma em vez de agrupar todos os locales em um único arquivo.
 
 </Question>
-
 <Question title="Preciso mover meu conteúdo chave por chave?">
 
 Não. Execute `npx intlayer extract` e o Intlayer lê seus arquivos fonte, extrai as strings voltadas para o usuário e escreve um arquivo `.content` ao lado de cada um, para que você revise um diff em vez de copiar strings para um catálogo uma a uma. Consulte o [comando extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/extract.md).
@@ -1159,7 +1131,6 @@ Não. Execute `npx intlayer extract` e o Intlayer lê seus arquivos fonte, extra
 Para um fluxo de trabalho totalmente automatizado, o [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/compiler.md) faz o mesmo em tempo de build em código JSX, TSX, Vue e Svelte, gerando os dicionários a cada alteração para que não haja necessidade de manter chaves manualmente. Como opera por análise estática, strings criadas exclusivamente em tempo de execução ficam fora de alcance, necessitando de algumas anotações para diferenciar texto do usuário de lógica interna da aplicação.
 
 </Question>
-
 <Question title="Quais ferramentas de editor e agentes de IA estão disponíveis?">
 
 Cinco ferramentas, todas opcionais:
@@ -1171,49 +1142,41 @@ Cinco ferramentas, todas opcionais:
 - **[Plugin ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/eslint.md)**: a regra `no-raw-text` identifica strings hardcoded, com regras adicionais para chaves estáticas e conteúdo não utilizado.
 
 </Question>
-
 <Question title="Como adiciono um novo idioma à minha aplicação?">
 
 Adicione o locale em `internationalization.locales` e depois execute `npx intlayer fill` para traduzir o conteúdo existente para ele. Os tipos gerados são atualizados imediatamente, de forma que qualquer arquivo de conteúdo que ainda não tenha o novo locale resultará em erro de tipagem em vez de recorrer silenciosamente a um fallback.
 
 </Question>
-
 <Question title="Como removo o prefixo de locale das minhas URLs?">
 
 Configure `routing.mode`. O padrão `"prefix-no-default"` produz `/about` para o idioma padrão e `/pt/about` para os demais. `"prefix-all"` adiciona o prefixo a todos os idiomas. `"no-prefix"` retira o locale do caminho por completo, resolvendo-o a partir de cookies, cabeçalhos ou domínios. `"search-params"` o coloca como parâmetro de consulta (`/about?locale=pt`).
 
 </Question>
-
 <Question title="Posso servir cada idioma em seu próprio domínio?">
 
 Sim. `routing.domains` mapeia cada locale para um hostname específico, por exemplo `{ pt: 'exemplo.com.br', en: 'exemplo.com' }`. O domínio identifica o idioma ativo, dispensando prefixos no caminho, e `getLocalizedUrl` gera URLs absolutas no domínio correto.
 
 </Question>
-
 <Question title="Como o idioma do usuário é detectado?">
 
 Por meio de `routing.storage`, que enumera as fontes a consultar em ordem: tipicamente a URL, depois cookies, depois o cabeçalho `Accept-Language`. A preferência escolhida ativamente pelo usuário é persistida para prevalecer nas visitas subsequentes.
 
 </Question>
-
 <Question title="O que faz routing.enableProxy?">
 
 Controla o proxy de roteamento de locales, o middleware responsável por resolver prefixos e redirecionamentos. Se não for definido, o proxy roda normalmente, mas servidores de desenvolvimento e preview ignoram o locale persistido como fonte de redirecionamento (evitando que você seja jogado para um idioma indesejado enquanto testa); em produção ele se comporta como `true`. Defina como `false` se preferir gerenciar o roteamento de locales manualmente.
 
 </Question>
-
 <Question title="Qual a diferença entre os modos de importação static, dynamic e fetch?">
 
 `"static"`, o padrão, importa dicionários estaticamente para que sejam empacotados e lidos de forma síncrona. `"dynamic"` os importa via Suspense, de forma que um locale seja baixado somente quando um componente o renderiza, ideal para conjuntos extensos de texto. `"fetch"` os obtém pela API de live sync, recorrendo a `"dynamic"` em caso de falha. Consulte [otimização de bundle](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/bundle_optimization.md) e [dicionários dinâmicos](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dynamic_dictionaries/index.md).
 
 </Question>
-
 <Question title="Onde configuro o provedor de IA e a chave de API para tradução automática?">
 
 Tanto no arquivo de configuração quanto na linha de comando com `--provider`, `--model` e `--api-key`. A chave permanece sua: as chamadas de tradução saem da sua máquina ou do seu executor de CI direto para a API do provedor escolhido, sem intermediários. Consulte o [comando fill](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/fill.md).
 
 </Question>
-
 <Question title="Preciso reiniciar o servidor de desenvolvimento após alterar a configuração?">
 
 Normalmente não. O observador do Intlayer monitora o próprio `intlayer.config.ts`: ao salvar, ele recarrega a configuração e reconstrói os dicionários, detectando novos locales ou alterações de roteamento exatamente como alterações de conteúdo. No entanto, certas partes da configuração podem ser armazenadas em cache pelo sistema; se notar inconsistências, reiniciar o servidor da aplicação é uma boa solução.

package/docs/pt/dictionary/html.md

@@ -122,8 +122,6 @@ const myContent = html(
 
 Ao usar o método `.use()` em um nó HTML, os componentes que você fornecer serão verificados em relação à definição fornecida na função `html()` (se disponível).
 
----
-
 ## Renderização de HTML
 
 A renderização pode ser feita automaticamente pelo sistema de conteúdo do Intlayer ou manualmente usando ferramentas especializadas.
@@ -477,8 +475,6 @@ Você pode configurar a renderização de HTML globalmente para toda a sua aplic
   </Tab>
 </Tabs>
 
----
-
 ### Renderização Manual e Ferramentas Avançadas
 
 Se precisar renderizar strings HTML brutas ou tiver mais controlo sobre o mapeamento de componentes, use as seguintes ferramentas.
@@ -651,8 +647,6 @@ Se precisar renderizar strings HTML brutas ou tiver mais controlo sobre o mapeam
   </Tab>
 </Tabs>
 
----
-
 ## Referência de Opções
 
 Essas opções podem ser passadas para `HTMLProvider`, `HTMLRenderer`, `useHTMLRenderer` e `renderHTML`.

package/docs/pt/dictionary/markdown.md

@@ -1171,8 +1171,6 @@ export class MyComponent {
   </Tab>
 </Tabs>
 
----
-
 ## Renderização no Lado do Servidor (SSR) e Hidratação
 
 Em comparação com outros analisadores de Markdown, como remark / rehype, o Intlayer Markdown é livre de dependências e roda tanto no cliente quanto no servidor.

package/docs/pt/how_works_intlayer.md

@@ -268,25 +268,21 @@ O pacote `@intlayer/backend` exporta tipos de backend e eventualmente oferecerá
 Em tempo de build. O plugin do empacotador (bundler) ou o comando `npx intlayer build` analisa seus arquivos `.content.ts`, compila-os em dicionários na pasta `.intlayer` e gera os tipos TypeScript correspondentes. Em tempo de execução, seus componentes apenas leem o resultado pronto, sem processamento ou leituras de arquivos no caminho das requisições.
 
 </Question>
-
 <Question title="Quanto a i18n adiciona ao tamanho do bundle?">
 
 Muito menos do que uma configuração baseada em namespaces, porque uma página nunca baixa um catálogo que não renderiza. O markup renderizado no servidor resolve seu conteúdo no próprio servidor, e o compilador em tempo de build substitui as chamadas `useIntlayer` pelas entradas exatas que o componente utiliza, descartando chaves e idiomas não utilizados. Os [dicionários dinâmicos](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dynamic_dictionaries/index.md) dividem o restante por locale. Comparado às alternativas habituais, o Intlayer reduz o tamanho do bundle e da página em até 50%. Consulte [otimização de bundle](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/bundle_optimization.md) e o [benchmark](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/benchmark/index.md).
 
 </Question>
-
 <Question title="Posso migrar do i18next, next-intl ou react-i18next sem reescrever meus componentes?">
 
 Sim, e existem dois caminhos. Você pode migrar o conteúdo progressivamente com o [guia de migração do i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/migration_from_i18next_to_intlayer.md) ou o [guia de migração do next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/migration_from_next-intl_to_intlayer.md). Ou você pode manter sua API atual integralmente: os [adaptadores de compatibilidade (compat adapters)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/compat/index.md) expõem exatamente a mesma interface de `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` e `Lingui`, porém alimentados pelos dicionários do Intlayer, permitindo que apenas os imports mudem enquanto o código dos componentes permanece idêntico.
 
 </Question>
-
 <Question title="Posso manter meus arquivos de tradução JSON existentes?">
 
 Sim. O [plugin sync JSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/plugins/sync-json.md) mantém seus arquivos `/messages/{locale}/{namespace}.json` como fonte de verdade e gera dicionários Intlayer a partir deles, em ambas as direções. O [plugin sync PO](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/plugins/sync-po.md) faz o mesmo para catálogos gettext, e os [arquivos por locale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/per_locale_file.md) permitem dividir o conteúdo por idioma em vez de agrupar todos os locales em um único arquivo.
 
 </Question>
-
 <Question title="Preciso mover meu conteúdo chave por chave?">
 
 Não. Execute `npx intlayer extract` e o Intlayer lê seus arquivos fonte, extrai as strings voltadas para o usuário e escreve um arquivo `.content` ao lado de cada um, para que você revise um diff em vez de copiar strings para um catálogo uma a uma. Consulte o [comando extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/extract.md).
@@ -294,7 +290,6 @@ Não. Execute `npx intlayer extract` e o Intlayer lê seus arquivos fonte, extra
 Para um fluxo de trabalho totalmente automatizado, o [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/compiler.md) faz o mesmo em tempo de build em código JSX, TSX, Vue e Svelte, gerando os dicionários a cada alteração para que não haja necessidade de manter chaves manualmente. Como opera por análise estática, strings criadas exclusivamente em tempo de execução ficam fora de alcance, necessitando de algumas anotações para diferenciar texto do usuário de lógica interna da aplicação.
 
 </Question>
-
 <Question title="Quais ferramentas de editor e agentes de IA estão disponíveis?">
 
 Cinco ferramentas, todas opcionais:
@@ -306,43 +301,36 @@ Cinco ferramentas, todas opcionais:
 - **[Plugin ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/eslint.md)**: a regra `no-raw-text` identifica strings hardcoded, com regras adicionais para chaves estáticas e conteúdo não utilizado.
 
 </Question>
-
 <Question title="O que é a pasta .intlayer e devo incluí-la no commit?">
 
 Ela contém a saída gerada: os dicionários compilados e as definições de tipo TypeScript geradas. Como é um artefato derivado dos seus arquivos de conteúdo, ela deve ser incluída no `.gitignore` e recompilada na sua etapa de build, exatamente como uma pasta `dist`.
 
 </Question>
-
 <Question title="Como o locale ativo é determinado?">
 
 A partir das fontes listadas em `routing.storage`, em ordem: o prefixo da URL quando `routing.mode` o utiliza, depois cookies, depois o cabeçalho `Accept-Language`, recorrendo por fim ao locale padrão. A escolha feita explicitamente pelo usuário é persistida para que permaneça na próxima visita. Consulte a [referência de configuração](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/configuration.md).
 
 </Question>
-
 <Question title="Qual a diferença entre dicionários locais e remotos?">
 
 Um dicionário local é declarado diretamente na sua base de código e compilado com sua aplicação. Um dicionário remoto é gerenciado no [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_CMS.md) e resolvido em tempo de execução, permitindo alterações sem um novo deploy. Ambos são consumidos através dos mesmos hooks, e o conteúdo remoto faz fallback para a declaração local caso esteja indisponível.
 
 </Question>
-
 <Question title="O Intlayer funciona sem TypeScript?">
 
 Sim. Os arquivos de conteúdo podem ser escritos em TypeScript, JavaScript, ESM, CommonJS ou JSON. O TypeScript é o que habilita as tipagens automáticas e o autocompletar completo no editor, tornando-o a configuração recomendada, mas não é obrigatório.
 
 </Question>
-
 <Question title="Como a renderização no servidor e no cliente compartilham o mesmo conteúdo?">
 
 O servidor resolve o conteúdo dos componentes renderizados no servidor diretamente, evitando enviar qualquer dicionário ao cliente para aquele trecho de HTML. Componentes cliente leem os mesmos dicionários através do provider, que recebe o locale resolvido pelo servidor, garantindo que a primeira renderização do cliente corresponda ao HTML do servidor sem oscilação visual de idioma.
 
 </Question>
-
 <Question title="Como o Intlayer evita inconsistências de hidratação (hydration mismatch) em relação ao locale?">
 
 O locale é resolvido uma única vez no servidor e repassado ao provider, em vez de ser recalculado no navegador. Como o cliente inicia com o mesmo locale com o qual o servidor renderizou, a árvore de nós coincide perfeitamente, eliminando as falhas comuns em soluções com detecção no lado do cliente.
 
 </Question>
-
 <Question title="Preciso recompilar a aplicação quando adiciono uma tradução?">
 
 Em desenvolvimento, não: o plugin observa seus arquivos de conteúdo e recompila os dicionários afetados ao salvar. Em produção, os dicionários fazem parte do build compilado, a menos que o conteúdo seja remoto - nesse caso, o [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_CMS.md) e a [sincronização ao vivo (live sync)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/live.md) aplicam as mudanças sem necessidade de novo deploy.