@intlayer/docs 9.4.0 → 9.4.2

package/docs/pt/dictionary/content_file.md

@@ -364,15 +364,15 @@ Transforma o dicionário em um dicionário por localidade onde cada campo declar
 
 **Exemplo:**
 
-```json
+```jsonc
 // Dicionário por idioma
 {
   "key": "about-page",
   "locale": "en",
   "content": {
     "title": "About Us", // Isto se torna um nó de tradução para 'en'
-    "description": "Learn more about our company"
-  }
+    "description": "Learn more about our company",
+  },
 }
 ```
 
@@ -441,7 +441,7 @@ Instruções para preenchimento automático do conteúdo do dicionário a partir
 
 **Exemplos:**
 
-```json
+```jsonc
 // Ativa para todas as localidades
 {
   "autoFill": true

package/docs/pt/dictionary/html.md

@@ -346,7 +346,24 @@ Você pode configurar a renderização de HTML globalmente para toda a sua aplic
     </HTMLProvider>
     ```
 
-> Importar seu renderer HTML dinamicamente é uma boa forma de reduzir o tamanho do bundle da sua aplicação.
+    Você também pode usar o seu próprio renderizador de HTML:
+
+    ```svelte fileName="App.svelte"
+    <script lang="ts">
+      import { HTMLProvider } from "svelte-intlayer/html";
+    </script>
+
+    <HTMLProvider
+      renderHTML={async (html) => {
+        const { renderHTML } = await import('svelte-intlayer/html');
+        return renderHTML(html);
+      }}
+    >
+      <slot />
+    </HTMLProvider>
+    ```
+
+    > Importar dinamicamente o seu renderizador de HTML é uma boa maneira de reduzir o tamanho do bundle da sua aplicação.
 
   </Tab>
   <Tab label="Preact" value="preact">

package/docs/pt/dictionary/markdown.md

@@ -51,6 +51,7 @@ Você pode declarar conteúdo Markdown usando a função `md` ou simplesmente co
 
 <Tabs>
   <Tab label=".content.md" value=".content.md">
+
     A partir da versão `8.10.0`, você pode declarar conteúdo Markdown diretamente em arquivos `.content.md`. O Intlayer detectará e processará automaticamente o conteúdo Markdown.
 
     ```md fileName="markdown-file.en.content.md"
@@ -96,6 +97,7 @@ Você pode declarar conteúdo Markdown usando a função `md` ou simplesmente co
     ```
 
   </Tab>
+
   <Tab label="Arquivos Externos" value="external-files">
     Importe arquivos `.md` diretamente usando a função `file`.
 
@@ -129,6 +131,7 @@ Você pode declarar conteúdo Markdown usando a função `md` ou simplesmente co
     ```
 
   </Tab>
+
 </Tabs>
 
 ## Renderizando Markdown

package/docs/pt/dictionary/plurial.md

@@ -35,9 +35,12 @@ To use plural content in Angular components, retrieve it via the `useIntlayer` h
 
 ## Quando usar `plural` vs `enu`
 
-To use plural content inside a React component, retrieve it via the `useIntlayer` hook and call it with a count. The active locale and the count are combined to pick the matching CLDR category.
+| Caso de uso                                                               | Helper   |
+| ------------------------------------------------------------------------- | -------- |
+| Formas plurais gramaticais sensíveis ao locale (uma maçã / duas maçãs)    | `plural` |
+| Intervalos numéricos personalizados (`<5`, `>=10`) ou categorias não-CLDR | `enu`    |
 
-To use plural content in Next.js Client Components, retrieve it via the `useIntlayer` hook and call it with a count. Here's an example:
+Se você visa apenas o inglês (que tem apenas `one` / `other`), ambos funcionam. Para qualquer idioma com distinções `few` / `many` / `two`, prefira `plural`.
 
 ## Configurando Conteúdo Plural
 

package/docs/pt/how_works_intlayer.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-12
-updatedAt: 2025-06-29
+updatedAt: 2026-08-30
 title: Como o Intlayer funciona
 description: Aprenda como o Intlayer opera internamente. Compreenda a arquitetura e os componentes que tornam o Intlayer poderoso.
 keywords:
@@ -258,3 +258,95 @@ O pacote `@intlayer/backend` exporta tipos de backend e eventualmente oferecerá
 ## Converse com nossa documentação inteligente
 
 - [Faça suas perguntas à nossa documentação inteligente](https://intlayer.org/doc/chat)
+
+## Perguntas Frequentes
+
+<FAQ>
+
+<Question title="Quando os dicionários são gerados, em tempo de build ou em tempo de execução?">
+
+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).
+
+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:
+
+- **[Extensão VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/vs_code_extension.md)**: navegue de uma chave `useIntlayer` diretamente para o arquivo de conteúdo que a declara, extraia conteúdo de um componente e execute build, fill, test, push e pull pela paleta de comandos ou pela aba dedicada do Intlayer.
+- **[Servidor LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/lsp.md)**: a mesma inteligência em qualquer editor compatível com LSP, com ir para definição, localizar referências, pré-visualizações de valores traduzidos ao passar o mouse, autocompletar e alertas para chaves não declaradas. Também resolve chamadas de `i18next`, `react-i18next`, `next-intl` e `use-intl`, facilitando a migração.
+- **[Servidor MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/mcp_server.md)**: expõe a documentação e a CLI do Intlayer para Cursor, VS Code, Claude Desktop, Claude Code e ChatGPT, permitindo que os assistentes respondam com base na documentação atualizada e executem comandos como `intlayer fill`.
+- **[Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/agent_skills.md)**: habilidades focadas como `intlayer-config`, `intlayer-cli` e `intlayer-content`, além de uma por framework, ensinando ao agente suas regras de roteamento e tipos de nós.
+- **[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.
+
+</Question>
+
+</FAQ>

package/docs/pt/interest_of_intlayer.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-14
-updatedAt: 2026-05-31
+updatedAt: 2026-08-30
 title: Interesse do Intlayer
 description: Descubra os benefícios e vantagens de usar o Intlayer em seus projetos. Entenda por que o Intlayer se destaca entre outros frameworks.
 keywords:
@@ -39,7 +39,6 @@ author: aymericzip
 Comparado às soluções principais como `next-intl` ou `i18next`, o Intlayer é uma solução que vem com otimizações integradas, tais como:
 
 <AccordionGroup>
-
 <Accordion header="Tamanho do bundle">
 
 Em vez de carregar arquivos JSON massivos em suas páginas, carregue apenas o conteúdo estritamente necessário. O Intlayer ajuda a **reduzir o tamanho do seu bundle e de suas páginas em até 50%**.
@@ -291,4 +290,100 @@ As estrelas no GitHub são um forte indicador da popularidade de um projeto, da
 
 Utilizando `intlayer`, você pode declarar seu conteúdo no formato de sua biblioteca i18n favorita, e o intlayer gerará seus namespaces no local de sua escolha (exemplo: `/messages/{{locale}}/{{namespace}}.json`).
 
-Se você quiser continuar usando a API da sua biblioteca i18n atual, o `intlayer` também fornece **adaptadores de compatibilidade (compat adapters)**: pacotes que expõem exatamente a mesma API que `react-i18next`, `next-intl`, `react-intl`, `vue-i18n` e outras, mas servidos pelos dicionários do Intlayer. Isso permite migrar progressivamente sem reescrever seu código. Consulte a [documentação dos adaptadores de compatibilidade](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/compat/index.md).
+Se você quiser continuar usando a API da sua biblioteca i18n atual, o `intlayer` também fornece **adaptadores de compatibilidade (compat adapters)**: pacotes que expõem exatamente a mesma API que `react-i18next`, `next-intl`, `react-intl`, `vue-i18n` e outras, mas servidos pelos dicionários do Intlayer. Isso permite migrar progressivamente sem reescrever seu código. Consulte a [documentação dos adaptadores de compatibilidade](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/compat/index.md).
+
+## Perguntas Frequentes
+
+<FAQ>
+
+<Question title="Quais são as diferentes soluções disponíveis para internacionalizar um aplicativo JavaScript?">
+
+Três gerações coexistem no ecossistema:
+
+- **Bibliotecas de catálogo em tempo de execução**: `i18next`, `react-i18next`, `next-i18next`, `vue-i18n`, `ngx-translate`, `svelte-i18n`. Namespaces JSON carregados em runtime. Maduras, agnósticas de framework, não tipadas e enviadas por inteiro para a página.
+- **Bibliotecas de mensagens em tempo de compilação**: `Lingui`, `Paraglide`, e `next-intl` ou `react-intl` com etapa de extração. Melhor comportamento de bundle e tipagem parcial, ainda mantendo catálogos centralizados.
+- **Bibliotecas com camada de conteúdo (Content layer)**: `Intlayer`. O conteúdo é declarado e compilado por componente, de modo que tipagem, tree-shaking, ferramentas de edição e tradução por IA se originam das mesmas declaraçõ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).
+
+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:
+
+- **[Extensão VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/vs_code_extension.md)**: navegue de uma chave `useIntlayer` diretamente para o arquivo de conteúdo que a declara, extraia conteúdo de um componente e execute build, fill, test, push e pull pela paleta de comandos ou pela aba dedicada do Intlayer.
+- **[Servidor LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/lsp.md)**: a mesma inteligência em qualquer editor compatível com LSP, com ir para definição, localizar referências, pré-visualizações de valores traduzidos ao passar o mouse, autocompletar e alertas para chaves não declaradas. Também resolve chamadas de `i18next`, `react-i18next`, `next-intl` e `use-intl`, facilitando a migração.
+- **[Servidor MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/mcp_server.md)**: expõe a documentação e a CLI do Intlayer para Cursor, VS Code, Claude Desktop, Claude Code e ChatGPT, permitindo que os assistentes respondam com base na documentação atualizada e executem comandos como `intlayer fill`.
+- **[Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/agent_skills.md)**: habilidades focadas como `intlayer-config`, `intlayer-cli` e `intlayer-content`, além de uma por framework, ensinando ao agente suas regras de roteamento e tipos de nós.
+- **[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 o Intlayer se diferencia do next-intl?">
+
+O `next-intl` é uma camada de mensagens para Next.js: você mantém arquivos de mensagens JSON por locale e os lê via `useTranslations`. O Intlayer é uma camada de conteúdo completa: as declarações vivem ao lado do componente, são tipadas a partir da própria declaração e são compiladas por componente para que a página envie apenas o que renderiza. O Intlayer também cobre o que o `next-intl` delega a você: tradução por IA, editor visual, CMS e verificação de traduções faltantes no CI. Se você preferir manter a API do `next-intl`, o [adaptador de compatibilidade](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/compat/index.md) a atende usando dicionários do Intlayer.
+
+</Question>
+
+<Question title="Como o Intlayer se diferencia do i18next e react-i18next?">
+
+O `i18next` resolve chaves baseadas em strings contra namespaces em tempo de execução, o que significa que uma chave renomeada ou digitada com erro falha silenciosamente, e todo namespace acessado por uma página é baixado por completo. O Intlayer resolve o conteúdo em tempo de build com base em tipos gerados, fazendo com que uma chave incorreta gere erro de compilação, e apenas as entradas que um componente renderiza alcancem o bundle. O `i18next` tem um ecossistema de plugins mais antigo e maior histórico; o Intlayer entrega tipagem rígida, otimização de bundle e ferramentas avançadas de edição e automação. Consulte 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 [adaptador de compatibilidade](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/compat/index.md).
+
+</Question>
+
+<Question title="O Intlayer é mais rápido ou mais leve do que as alternativas?">
+
+Em tamanho de bundle e de página, sim: evitar carregar catálogos que a página não renderiza reduz o tamanho do bundle e da página em até 50% em comparação com abordagens baseadas em namespaces. O [benchmark](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/benchmark/index.md) publica a metodologia e os números aferidos por framework, incluindo [Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/benchmark/nextjs.md), [TanStack Start](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/benchmark/tanstack.md), [Vue](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/benchmark/vue.md) e [Svelte](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/benchmark/svelte.md), para que você possa reproduzi-los diretamente.
+
+</Question>
+
+<Question title="Vale a pena migrar uma aplicação existente?">
+
+Depende do seu gargalo atual. Se a dor envolve tamanho de bundle, traduções ausentes que passam despercebidas para produção ou tradutores dependentes de desenvolvedores para qualquer ajuste, a migração compensa rapidamente. Se seus catálogos são pequenos e estáveis, o ganho relativo é menor. De qualquer forma, a migração não precisa ser uma reescrita: os [adaptadores de compatibilidade](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/compat/index.md) preservam sua API atual, e o [plugin sync JSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/plugins/sync-json.md) mantém seus arquivos JSON existentes como fonte de verdade enquanto as duas abordagens coexistem.
+
+</Question>
+
+<Question title="O que o Intlayer oferece que outras bibliotecas de i18n não oferecem?">
+
+[Conteúdo em Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/markdown.md), [conteúdo obtido de fonte externa](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/content_file.md), carregamento de arquivos locais, [atualizações de conteúdo ao vivo (live sync)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/live.md), um [editor visual](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_visual_editor.md), um [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_CMS.md), um [compilador](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/compiler.md) que extrai conteúdo de componentes existentes, [variantes de conteúdo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dynamic_dictionaries/variants.md) para testes A/B, [analytics](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/analytics.md) de exposição de conteúdo, um [servidor MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/mcp_server.md), [LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/lsp.md) e [skills para agentes de IA](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/agent_skills.md).
+
+</Question>
+
+<Question title="Posso usar o Intlayer apenas como gerenciador de traduções e manter minha biblioteca atual?">
+
+Sim. O Intlayer pode gerar seus namespaces no formato e local esperados pela sua biblioteca atual, por exemplo `/messages/{locale}/{namespace}.json`, garantindo tradução por IA, editor visual e verificações no CI enquanto o código da sua aplicação continua consumindo a biblioteca de i18n legada.
+
+</Question>
+
+<Question title="O Intlayer é gratuito e de código aberto?">
+
+Sim, sob a licença Apache 2.0, uso comercial incluído. O CMS hospedado é um serviço opcional pago que também pode ser [auto hospedado](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/self_hosting.md).
+
+</Question>
+
+</FAQ>

package/docs/pt/intlayer_CMS.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-08-23
-updatedAt: 2026-07-08
+updatedAt: 2026-08-30
 title: Intlayer CMS | Externalize seu conteúdo no Intlayer CMS
 description: Externalize seu conteúdo no Intlayer CMS para delegar a gestão do seu conteúdo para sua equipe.
 keywords:
@@ -436,3 +436,95 @@ Se encontrar problemas com o CMS, verifique o seguinte:
 - Certifique-se de que a configuração do projeto foi enviada para o Intlayer CMS.
 
 - O editor visual usa um iframe para exibir seu website. Certifique-se de que a Política de Segurança de Conteúdo (CSP) do seu website permite o URL do CMS como `frame-ancestors` ('https://app.intlayer.org' por padrão). Verifique o console do editor para qualquer erro.
+
+## Perguntas Frequentes
+
+<FAQ>
+
+<Question title="Qual é a diferença entre o Intlayer CMS e o editor visual?">
+
+O [editor visual](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_visual_editor.md) edita dicionários locais e grava as modificações de volta na sua base de código, exigindo que a aplicação seja recompilada e passe pelo fluxo normal de revisão e deploy. O CMS gerencia dicionários remotos: as alterações não tocam o código-fonte e o site em produção as incorpora sem necessidade de nova implantação. Frequentemente as equipes usam ambos: o editor visual para conteúdos pertencentes aos desenvolvedores e o CMS para textos que o time de marketing altera com frequência semanal.
+
+</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).
+
+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:
+
+- **[Extensão VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/vs_code_extension.md)**: navegue de uma chave `useIntlayer` diretamente para o arquivo de conteúdo que a declara, extraia conteúdo de um componente e execute build, fill, test, push e pull pela paleta de comandos ou pela aba dedicada do Intlayer.
+- **[Servidor LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/lsp.md)**: a mesma inteligência em qualquer editor compatível com LSP, com ir para definição, localizar referências, pré-visualizações de valores traduzidos ao passar o mouse, autocompletar e alertas para chaves não declaradas. Também resolve chamadas de `i18next`, `react-i18next`, `next-intl` e `use-intl`, facilitando a migração.
+- **[Servidor MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/mcp_server.md)**: expõe a documentação e a CLI do Intlayer para Cursor, VS Code, Claude Desktop, Claude Code e ChatGPT, permitindo que os assistentes respondam com base na documentação atualizada e executem comandos como `intlayer fill`.
+- **[Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/agent_skills.md)**: habilidades focadas como `intlayer-config`, `intlayer-cli` e `intlayer-content`, além de uma por framework, ensinando ao agente suas regras de roteamento e tipos de nós.
+- **[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="Qual conteúdo deve ser movido para o CMS?">
+
+Conteúdos que mudam com frequência e não dependem do ciclo de lançamento do código: textos de landing pages, termos de preços, avisos promocionais, tudo o que o time de marketing gerencia. Textos estruturais da interface, como rótulos de botões e mensagens de validação de formulários, funcionam melhor como dicionários locais mantidos no repositório junto aos componentes que os utilizam.
+
+</Question>
+
+<Question title="O que acontece se o CMS estiver inacessível?">
+
+A aplicação recorre automaticamente à declaração local do dicionário compilada no build. Assim, uma falha de conexão ou indisponibilidade temporária degrada graciosamente para o conteúdo embutido na aplicação em vez de renderizar uma página em branco. Por essa razão, manter uma declaração local de fallback para todo dicionário remoto é uma excelente prática.
+
+</Question>
+
+<Question title="Posso auto-hospedar o CMS?">
+
+Sim. O CMS pode rodar integralmente na sua própria infraestrutura com Docker Compose, sendo a solução ideal quando os dados não podem sair da sua rede corporativa. Consulte o [guia de auto-hospedagem do Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/self_hosting.md).
+
+</Question>
+
+<Question title="Editores de conteúdo precisam de um desenvolvedor para publicar alterações?">
+
+Não. Essa é a principal vantagem dos dicionários remotos: um editor altera o texto no painel do CMS e o site reflete a mudança, com o [live sync](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/live.md) aplicando a atualização em tempo de execução sem esperar por uma nova compilação.
+
+</Question>
+
+<Question title="Posso automatizar o CMS via scripts em vez de usar a interface web?">
+
+Sim. O SDK `@intlayer/api` expõe os mesmos endpoints que a interface web utiliza, permitindo listar projetos, inspecionar dicionários e enviar atualizações através de scripts ou esteiras de CI/CD.
+
+</Question>
+
+<Question title="O CMS oferece suporte a testes A/B em traduções?">
+
+Sim. Dicionários remotos suportam [variantes de conteúdo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dynamic_dictionaries/variants.md), e o módulo de [analytics](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/analytics.md) reporta métricas de exposição de cada variante, permitindo testar empiricamente qual redação converte melhor.
+
+</Question>
+
+<Question title="O CMS é gratuito?">
+
+A biblioteca Intlayer, a CLI, o compilador e o editor visual são gratuitos e de código aberto sob a licença Apache 2.0. O CMS em nuvem hospedado é um serviço pago opcional que também pode ser [auto hospedado](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/self_hosting.md) sem custo de licença.
+
+</Question>
+
+</FAQ>

package/docs/pt/intlayer_visual_editor.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-06-29
+updatedAt: 2026-08-30
 title: Editor Visual Intlayer | Edite seu conteúdo usando um editor visual
 description: Descubra como usar o Editor Intlayer para gerenciar seu site multilíngue. Siga os passos nesta documentação online para configurar seu projeto em poucos minutos.
 keywords:
@@ -210,4 +210,90 @@ Se você encontrar problemas com o editor visual, verifique o seguinte:
   - Campos obrigatórios:
     - A URL da aplicação deve corresponder à que você configurou no editor (`applicationURL`).
 
-- O editor visual usa um iframe para exibir seu site. Certifique-se de que a Política de Segurança de Conteúdo (CSP) do seu site permita a URL do CMS como `frame-ancestors` ('http://localhost:8000' por padrão). Verifique o console do editor para quaisquer erros.
+- O editor visual usa um iframe para exibir seu site. Certifique-se de que a Política de Segurança de Conteúdo (CSP) do seu site permita a URL do CMS como `frame-ancestors` (`http://localhost:8000` por padrão). Verifique o console do editor para quaisquer erros.
+
+## Perguntas Frequentes
+
+<FAQ>
+
+<Question title="Qual é a diferença entre o editor visual e o CMS?">
+
+O editor visual edita dicionários locais e grava as modificações de volta na sua base de código, integrando-se ao seu processo habitual de revisão por commits e deploy. O [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_CMS.md) edita dicionários remotos, cujas alterações entram em vigor no site em produção sem necessidade de deploy. O editor é ideal para conteúdos pertencentes a desenvolvedores; o CMS atende perfeitamente ao time de marketing.
+
+</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).
+
+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:
+
+- **[Extensão VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/vs_code_extension.md)**: navegue de uma chave `useIntlayer` diretamente para o arquivo de conteúdo que a declara, extraia conteúdo de um componente e execute build, fill, test, push e pull pela paleta de comandos ou pela aba dedicada do Intlayer.
+- **[Servidor LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/lsp.md)**: a mesma inteligência em qualquer editor compatível com LSP, com ir para definição, localizar referências, pré-visualizações de valores traduzidos ao passar o mouse, autocompletar e alertas para chaves não declaradas. Também resolve chamadas de `i18next`, `react-i18next`, `next-intl` e `use-intl`, facilitando a migração.
+- **[Servidor MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/mcp_server.md)**: expõe a documentação e a CLI do Intlayer para Cursor, VS Code, Claude Desktop, Claude Code e ChatGPT, permitindo que os assistentes respondam com base na documentação atualizada e executem comandos como `intlayer fill`.
+- **[Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/agent_skills.md)**: habilidades focadas como `intlayer-config`, `intlayer-cli` e `intlayer-content`, além de uma por framework, ensinando ao agente suas regras de roteamento e tipos de nós.
+- **[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="Onde roda o editor visual?">
+
+Na sua própria infraestrutura. Ele carrega a aplicação em um iframe e comunica-se com um servidor local do editor, de modo que seu conteúdo nunca deixa o seu ambiente. Isso viabiliza o uso em projetos confidenciais ou corporativos que não podem enviar dados para serviços de terceiros.
+
+</Question>
+
+<Question title="Os editores precisam saber programar?">
+
+Não. Eles abrem a interface, clicam em qualquer texto na tela e editam diretamente no contexto da página. O editor identifica qual entrada de dicionário corresponde àquele texto e salva as mudanças no arquivo `.content` apropriado, dispensando tradutores de encontrar arquivos ou manipular chaves de código.
+
+</Question>
+
+<Question title="Editar pelo editor visual modifica meus arquivos de código-fonte?">
+
+Sim, esse é exatamente o objetivo. A alteração é gravada no arquivo de declaração de conteúdo no repositório, surgindo como um diff normal do Git para você revisar e commitar, enquanto a aplicação recompila para refletir o novo texto.
+
+</Question>
+
+<Question title="O editor exibe uma página em branco ou recusa carregar meu site. O que devo verificar?">
+
+O editor carrega a aplicação em um iframe; por isso, a Política de Segurança de Conteúdo (CSP) da sua aplicação deve permitir a origem do editor na diretiva `frame-ancestors` (`http://localhost:8000` por padrão). Verifique também se a URL definida em `applicationURL` nas configurações do editor coincide exatamente com o endereço em que sua aplicação está sendo servida. O console do navegador indicará eventuais bloqueios.
+
+</Question>
+
+<Question title="Posso usar o editor visual em produção?">
+
+Ele foi projetado primariamente para ambientes locais de desenvolvimento e staging, onde um reload ou rebuild é aceitável. Para editar conteúdo diretamente em produção sem intervenção de deploy, utilize o [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_CMS.md) e seus dicionários remotos.
+
+</Question>
+
+<Question title="O editor visual é gratuito?">
+
+Sim. O editor visual faz parte do projeto de código aberto sob a licença Apache 2.0, com uso comercial incluído. Apenas o [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_CMS.md) hospedado em nuvem é um serviço pago opcional, que também pode ser [auto hospedado](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/self_hosting.md).
+
+</Question>
+
+</FAQ>