@intlayer/docs 8.1.6 → 8.1.8

package/docs/pt/component_i18n.md

@@ -78,7 +78,7 @@ JSON também é suportado se você preferir arquivos de configuração.
 
 ## 2) Recupere seu conteúdo
 
-### Caso A — Aplicação React (Vite/SPA)
+### Caso A. Aplicação React (Vite/SPA)
 
 Abordagem padrão: use `useIntlayer` para recuperar pelo key. Isso mantém os componentes enxutos e tipados.
 
@@ -129,7 +129,7 @@ export function ComponentWithDictionary() {
 }
 ```
 
-### Caso B — Next.js (App Router)
+### Caso B. Next.js (App Router)
 
 Prefira componentes de servidor para segurança dos dados e desempenho. Use `useIntlayer` de `next-intlayer/server` em arquivos de servidor, e `useIntlayer` de `next-intlayer` em componentes cliente.
 

package/docs/pt/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-02-12
+updatedAt: 2026-02-25
 title: Configuração
 description: Aprenda como configurar o Intlayer para sua aplicação. Entenda as várias configurações e opções disponíveis para personalizar o Intlayer conforme suas necessidades.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.1.7
+    date: 2026-02-25
+    changes: Atualizar opções do compilador
   - version: 8.0.6
     date: 2026-02-12
     changes: Add support for Open Router, Alibaba, Amazon, Google Vertex Bedrock, Fireworks, Groq, Hugging Face, and Together.ai providers
@@ -437,6 +440,17 @@ const config: IntlayerConfig = {
      * Output directory for the optimized dictionaries.
      */
     outputDir: "compiler",
+
+    /**
+     * Dictionary key prefix
+     */
+    dictionaryKeyPrefix: "", // Remove base prefix
+
+    /**
+     * Indicates if the components should be saved after being transformed.
+     * That way, the compiler can be run only once to transform the app, and then it can be removed.
+     */
+    saveComponents: false,
   },
 
   /**
@@ -982,6 +996,13 @@ As opções de build se aplicam aos plugins `@intlayer/babel` e `@intlayer/swc`.
   - _Nota_: O modo live usará a API de sincronização ao vivo para buscar os dicionários. Se a chamada da API falhar, os dicionários serão importados dinamicamente no modo "dynamic".
   - _Nota_: Esta opção não impactará as funções `getIntlayer`, `getDictionary`, `useDictionary`, `useDictionaryAsync` e `useDictionaryDynamic`.
 
+- **outputFormat**:
+  - _Tipo_: `'esm' | 'cjs'`
+  - _Padrão_: `'esm'`
+  - _Descrição_: Controla o formato de saída dos dicionários.
+  - _Exemplo_: `'cjs'`
+  - _Nota_: O formato de saída dos dicionários.
+
 - **traversePattern**:
   - _Tipo_: `string[]`
   - _Padrão_: `['**\/*.{js,ts,mjs,cjs,jsx,tsx}', '!**\/node_modules/**']`
@@ -990,3 +1011,49 @@ As opções de build se aplicam aos plugins `@intlayer/babel` e `@intlayer/swc`.
   - _Nota_: Use isso para limitar a otimização aos arquivos de código relevantes e melhorar o desempenho da compilação.
   - _Nota_: Esta opção será ignorada se `optimize` estiver desativado.
   - _Nota_: Use padrão glob.
+
+---
+
+### Configuração do Compilador
+
+Configurações que controlan o compilador Intlayer, que extrai dicionários diretamente de seus componentes.
+
+#### Propriedades
+
+- **enabled**:
+  - _Tipo_: `boolean | 'build-only'`
+  - _Padrão_: `true`
+  - _Descrição_: Indica se o compilador deve ser habilitado para extrair os dicionários.
+  - _Exemplo_: `'build-only'`
+  - _Nota_: Definir como `'build-only'` pulará o compilador durante o modo de desenvolvimento para acelerar os tempos de inicialização. Ele será executado apenas em comandos de build.
+
+- **dictionaryKeyPrefix**:
+  - _Tipo_: `string`
+  - _Padrão_: `'comp-'`
+  - _Descrição_: Prefixo para as chaves de dicionário extraídas.
+  - _Exemplo_: `'my-key-'`
+  - _Nota_: Quando os dicionários são extraídos, a chave é gerada com base no nome do arquivo. Este prefixo é adicionado à chave gerada para evitar conflitos.
+
+- **saveComponents**:
+  - _Tipo_: `boolean`
+  - _Padrão_: `false`
+  - _Descrição_: Indica se os componentes devem ser salvos após serem transformados.
+  - _Nota_: Se verdadeiro, o compilador substituirá os arquivos originais pelos arquivos transformados. Dessa forma, o compilador pode ser executado apenas uma vez para transformar o app e depois pode ser removido.
+
+- **transformPattern**:
+  - _Tipo_: `string | string[]`
+  - _Padrão_: `['**/*.{ts,tsx,jsx,js,cjs,mjs,svelte,vue}', '!**/node_modules/**']`
+  - _Descrição_: Padrões que definem quais arquivos devem ser percorridos durante a otimização.
+  - _Exemplo_: `['src/**/*.{ts,tsx}', '!**/node_modules/**']`
+  - _Nota_: Use isso para limitar a otimização aos arquivos de código relevantes e melhorar o desempenho da construção.
+
+- **excludePattern**:
+  - _Tipo_: `string | string[]`
+  - _Padrão_: `['**/node_modules/**']`
+  - _Descrição_: Padrões que definem quais arquivos devem ser excluídos durante a otimização.
+  - _Exemplo_: `['**/node_modules/**', '!**/node_modules/react/**']`
+
+- **outputDir**:
+  - _Tipo_: `string`
+  - _Padrão_: `'compiler'`
+  - _Descrição_: O diretório onde os dicionários extraídos serão armazenados, relativo ao caminho base do seu projeto.

package/docs/pt/dictionary/content_file.md

@@ -493,7 +493,7 @@ Indica a localização do dicionário e controla como ele sincroniza com o CMS:
 
 - `'local'`: O dicionário é gerenciado apenas localmente. Ele não será enviado para o CMS remoto. Use isso para conteúdo que deve permanecer em sua base de código.
 - `'remote'`: O dicionário é gerenciado apenas remotamente. Uma vez enviado para o CMS, ele será desvinculado do arquivo local. No momento do carregamento do conteúdo, o dicionário remoto será obtido do CMS. Um arquivo `.content` com localização `remote` será ignorado após o envio inicial.
-- `'hybrid'`: O dicionário é gerenciado tanto localmente quanto remotamente. Uma vez enviado para o CMS, ele permanecerá sincronizado—alterações do arquivo local são enviadas para o CMS, e alterações remotas podem ser recuperadas no arquivo local.
+- `'hybrid'`: O dicionário é gerenciado tanto localmente quanto remotamente. Uma vez enviado para o CMS, ele permanecerá sincronizado, alterações do arquivo local são enviadas para o CMS, e alterações remotas podem ser recuperadas no arquivo local.
 - `string` (ex.: `'plugin'`): O dicionário é gerenciado por um plugin ou uma fonte personalizada. Quando você tentar enviá-lo, o sistema perguntará o que fazer.
 
 **Exemplo:**

package/docs/pt/index.md

@@ -66,7 +66,7 @@ Entenda como as traduções são geradas, armazenadas e utilizadas em sua aplica
 - **[Enumeração](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/enumeration.md)**  
   Gerencie facilmente conjuntos repetidos ou fixos de dados em vários idiomas.
 
-- **[Condição](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/conditional.md)**  
+- **[Condição](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/condition.md)**  
   Aprenda a usar lógica condicional no Intlayer para criar conteúdo dinâmico.
 
 - **[Inserção](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/insertion.md)**  
@@ -79,7 +79,7 @@ Veja como buscar conteúdo dinamicamente com lógica personalizada para correspo
 - **[Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/markdown.md)**  
   Aprenda a usar Markdown no Intlayer para criar conteúdo rico.
 
-- **[Incorporação de arquivos](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/file_embeddings.md)**  
+- **[Incorporação de arquivos](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/file.md)**  
   Descubra como incorporar arquivos externos no Intlayer para usá-los no editor de conteúdo.
 
 - **[Aninhamento](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/nesting.md)**  

package/docs/pt/intlayer_CMS.md

@@ -447,7 +447,7 @@ Exemplo usando Vite:
 
 O servidor Live Sync envolve sua aplicação e aplica automaticamente o conteúdo atualizado assim que ele chega.
 
-Para receber notificações de alterações do CMS, o servidor Live Sync mantém uma conexão SSE com o backend. Quando o conteúdo muda no CMS, o backend encaminha a atualização para o servidor Live Sync, que grava os novos dicionários. Sua aplicação refletirá a atualização na próxima navegação ou recarregamento do navegador — sem necessidade de reconstrução.
+Para receber notificações de alterações do CMS, o servidor Live Sync mantém uma conexão SSE com o backend. Quando o conteúdo muda no CMS, o backend encaminha a atualização para o servidor Live Sync, que grava os novos dicionários. Sua aplicação refletirá a atualização na próxima navegação ou recarregamento do navegador, sem necessidade de reconstrução.
 
 Fluxograma (CMS/Backend -> Servidor Live Sync -> Servidor de Aplicação -> Frontend):
 

package/docs/pt/intlayer_with_adonisjs.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-08-23
 updatedAt: 2025-12-30
-title: AdonisJS i18n - Como traduzir sua aplicação AdonisJS – guia 2026
+title: AdonisJS i18n - Como traduzir uma aplicação AdonisJS em 2026
 description: Descubra como tornar o seu backend AdonisJS multilíngue. Siga a documentação para internacionalizar (i18n) e traduzir.
 keywords:
   - Internacionalização

package/docs/pt/intlayer_with_analog.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-04-18
 updatedAt: 2025-12-30
-title: Analog i18n - Como traduzir sua aplicação Analog – guia 2026
+title: Analog i18n - Como traduzir uma aplicação Analog em 2026
 description: Descubra como tornar sua aplicação Analog multilíngue. Siga a documentação para internacionalizar (i18n) e traduzi-la.
 keywords:
   - Internacionalização

package/docs/pt/intlayer_with_angular.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-04-18
 updatedAt: 2025-12-30
-title: Angular i18n - Como traduzir seu app Angular – guia 2026
+title: Angular i18n - Como traduzir um app Angular em 2026
 description: Descubra como tornar seu site Angular multilíngue. Siga a documentação para internacionalizar (i18n) e traduzi-lo.
 keywords:
   - Internacionalização

package/docs/pt/intlayer_with_astro.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-03-07
 updatedAt: 2025-12-30
-title: Astro i18n - Como traduzir sua aplicação Astro – guia 2026
+title: Astro i18n - Como traduzir uma aplicação Astro em 2026
 description: Aprenda como adicionar internacionalização (i18n) ao seu site Astro usando Intlayer. Siga este guia para tornar seu site multilíngue.
 keywords:
   - Internacionalização

package/docs/pt/intlayer_with_create_react_app.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-08-11
 updatedAt: 2025-12-30
-title: Create React App i18n - Como traduzir sua aplicação React – guia 2026
+title: Create React App i18n - Como traduzir uma aplicação React em 2026
 description: Descubra como tornar seu site Create React App (CRA) multilíngue. Siga a documentação para internacionalizar (i18n) e traduzi-lo.
 keywords:
   - Internacionalização

package/docs/pt/intlayer_with_express.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-08-11
 updatedAt: 2025-12-30
-title: Express i18n - Como traduzir sua aplicação Express – guia 2026
+title: Express i18n - Como traduzir uma aplicação Express em 2026
 description: Descubra como tornar seu backend Express multilíngue. Siga a documentação para internacionalizar (i18n) e traduzi-lo.
 keywords:
   - Internacionalização

package/docs/pt/intlayer_with_fastify.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-12-30
 updatedAt: 2025-12-30
-title: Fastify i18n - Como traduzir sua aplicação Fastify – guia 2026
+title: Fastify i18n - Como traduzir uma aplicação Fastify em 2026
 description: Descubra como tornar seu backend Fastify multilíngue. Siga a documentação para internacionalizar (i18n) e traduzir.
 keywords:
   - Internacionalização

package/docs/pt/intlayer_with_hono.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-08-23
 updatedAt: 2025-12-30
-title: i18n Hono - Como traduzir sua aplicação Hono – guia 2026
+title: i18n Hono - Como traduzir uma aplicação Hono em 2026
 description: Descubra como tornar seu back-end Hono multilíngue. Siga a documentação para internacionalizar (i18n) e traduzi-lo.
 keywords:
   - Internacionalização

package/docs/pt/intlayer_with_lynx+react.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-03-09
 updatedAt: 2025-12-30
-title: Lynx e React i18n - Como traduzir sua aplicação Lynx – guia 2026
+title: Lynx + React i18n - Como traduzir uma aplicação Lynx em 2026
 description: Descubra como tornar seu aplicativo móvel Lynx e React multilíngue. Siga a documentação para internacionalizar (i18n) e traduzi-lo.
 keywords:
   - Internacionalização

package/docs/pt/intlayer_with_nestjs.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-09-09
 updatedAt: 2025-12-30
-title: NestJS i18n - Como traduzir sua aplicação NestJS – guia 2026
+title: NestJS i18n - Como traduzir uma aplicação NestJS em 2026
 description: Descubra como tornar seu backend NestJS multilíngue. Siga a documentação para internacionalizar (i18n) e traduzir.
 keywords:
   - Internacionalização

package/docs/pt/intlayer_with_next-i18next.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-10-05
 updatedAt: 2025-10-05
-title: Next.js e next-i18next i18n - Como traduzir sua aplicação Next.js – guia 2026
+title: next-i18next - Como traduzir um app Next.js (i18n) em 2026
 description: Um guia prático e pronto para produção para internacionalizar um app Next.js 15 App Router com i18next/next-i18next e aprimorá-lo com Intlayer.
 keywords:
   - Internacionalização
@@ -37,7 +37,7 @@ applicationTemplate: https://github.com/aymericzip/intlayer-next-i18next-templat
 - Integração Intlayer para automatizar fluxos de trabalho de tradução (testes, preenchimento por IA, sincronização JSON)
 
 > Nota: next-i18next é construído sobre o i18next. Este guia utiliza as primitivas do i18next compatíveis com o next-i18next no App Router, mantendo a arquitetura simples e pronta para produção.
-> Para uma comparação mais ampla, veja [next-i18next vs next-i18next vs Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/blog/pt/next-i18next_vs_next-i18next_vs_intlayer.md).
+> Para uma comparação mais ampla, veja [next-i18next vs next-intl vs Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/blog/pt/next-i18next_vs_next-intl_vs_intlayer.md).
 
 ---
 

package/docs/pt/intlayer_with_next-intl.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-10-05
 updatedAt: 2025-10-05
-title: Next.js e next-intl i18n - Como traduzir sua aplicação Next.js – guia 2026
+title: next-intl - Como traduzir um app Next.js (i18n) em 2026
 description: Descubra como tornar seu site Next.js 15 App Router multilíngue. Siga a documentação para internacionalizar (i18n) e traduzir.
 keywords:
   - Internacionalização

package/docs/pt/intlayer_with_nextjs_14.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-12-06
 updatedAt: 2025-06-29
-title: Next.js i18n - Como traduzir sua aplicação Next.js 14 – guia 2026
+title: Next.js i18n - Como traduzir uma aplicação Next.js 14 em 2026
 description: Descubra como tornar seu site Next.js 14 App Router multilíngue. Siga a documentação para internacionalizar (i18n) e traduzi-lo.
 keywords:
   - Internacionalização

package/docs/pt/intlayer_with_nextjs_15.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-12-06
 updatedAt: 2025-12-30
-title: Next.js i18n - Como traduzir sua aplicação Next.js 15 – guia 2026
+title: Next.js i18n - Como traduzir uma aplicação Next.js 15 em 2026
 description: Descubra como tornar seu site Next.js 15 multilíngue. Siga a documentação para internacionalizar (i18n) e traduzir.
 keywords:
   - Internacionalização

package/docs/pt/intlayer_with_nextjs_16.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-12-06
 updatedAt: 2025-12-30
-title: Next.js i18n - Como traduzir sua aplicação Next.js 16 – guia 2026
+title: Next.js i18n - Como traduzir uma aplicação Next.js 16 em 2026
 description: Descubra como tornar seu site Next.js 16 multilíngue. Siga a documentação para internacionalizar (i18n) e traduzir.
 keywords:
   - Internacionalização
@@ -708,6 +708,8 @@ const ServerComponentExample = () => {
 
 > Para saber mais sobre o hook `useIntlayer`, consulte a [documentação](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/next-intlayer/useIntlayer.md).
 
+> Se a sua aplicação já existe, você pode usar o [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/compiler.md) em conjunto com o [comando extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/extract.md) para converter milhares de componentes em um segundo.
+
 ### (Opcional) Passo 7: Configurar Proxy para Detecção de Localidade
 
 Configure o proxy para detectar a localidade preferida do usuário: