@intlayer/docs 9.0.0-canary.4 → 9.0.0-canary.6

package/docs/pt/compat/index.md

@@ -0,0 +1,51 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Adaptadores de Compatibilidade Intlayer"
+description: "Migre sua solução i18n existente para Intlayer sem atrito usando adaptadores de compatibilidade."
+keywords:
+  - compat
+  - migration
+  - internationalization
+  - i18n
+  - Intlayer
+slugs:
+  - doc
+  - compatibility
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Adaptadores de Compatibilidade Intlayer
+
+Migrar uma aplicação grande para uma nova biblioteca de internacionalização pode ser intimidante. Para facilitar essa transição, Intlayer fornece **adaptadores de compatibilidade** para as bibliotecas i18n mais populares do ecossistema.
+
+Esses pacotes de adaptadores expõem a **mesma API pública exata** das suas bibliotecas i18n existentes, mas delegam todo o trabalho de tradução para Intlayer em tempo de execução.
+
+## Como funciona
+
+Quando você usa um compat adapter, não precisa reescrever as importações da sua aplicação ou mudar como você usa seus hooks e componentes de tradução. Em vez disso, os plugins bundler do Intlayer fazem automaticamente um alias das suas importações existentes para os pacotes compat do Intlayer.
+
+Por exemplo, um desenvolvedor substitui `import { useTranslation } from 'react-i18next'` por `import { useTranslation } from '@intlayer/react-i18next'` (feito automaticamente via plugin bundler), e a aplicação continua funcionando com traduções agora servidas a partir dos dicionários do Intlayer. As chaves também são tipadas contra seus dicionários do Intlayer!
+
+## Adaptadores Compat Disponíveis
+
+Escolha sua biblioteca existente abaixo para ver como migrar perfeitamente:
+
+- [Vue I18n](./vue-i18n.md)
+- [Transloco](./transloco.md)
+- [React Intl](./react-intl.md)
+- [Svelte I18n](./svelte-i18n.md)
+- [React i18next](./react-i18next.md)
+- [Polyglot.js](./polyglot.md)
+- [NuxtJS I18n](./nuxtjs-i18n.md)
+- [NGX Translate](./ngx-translate.md)
+- [Next Translate](./next-translate.md)
+- [Next Intl](./next-intl.md)
+- [Next i18next](./next-i18next.md)
+- [i18next](./i18next.md)
+- [Lingui](./lingui.md)
+- [I18n-js](./i18n-js.md)

package/docs/pt/compat/lingui.md

@@ -0,0 +1,44 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrar do Lingui para Intlayer"
+description: "Aprenda como migrar sua aplicação do Lingui para Intlayer usando o adaptador de compatibilidade."
+keywords:
+  - lingui
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - lingui
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Migrar do Lingui para Intlayer
+
+Se seu projeto atualmente depende da compilação baseada em macros do Lingui, a transição para Intlayer permite que você mantenha seus poderosos fluxos de trabalho de macros enquanto os respalda nativamente com a estratégia de compilação JSON do Intlayer.
+
+## O que fazer
+
+Para começar, inicialize o Intlayer no seu projeto:
+
+```bash
+npx intlayer init
+```
+
+Isso cria seu `intlayer.config.ts`. Certifique-se de manter `@lingui/babel-plugin-lingui-macro` / `@lingui/swc-plugin` na sua etapa de build para executar _antes_ do compilador Intlayer. Em seguida, use o alias do plugin bundler para rotear `@lingui/core` e `@lingui/react` para `@intlayer/lingui`.
+
+## O que acontece nos bastidores
+
+Lingui utiliza macros (como `` t`Hello ${name}` `` e `<Trans>`) que são compiladas em chamadas de tempo de execução como `i18n._(id, values)`.
+
+Nos bastidores:
+
+- **Macros:** Elas são compiladas precisamente como antes, garantindo nenhuma interrupção na sua sintaxe de origem.
+- **Tradução em tempo de execução:** O `i18n._()` com alias utiliza dicionários Intlayer. IDs explicitamente nomeados e IDs hash são totalmente mapeados usando plugins de sincronização `.po` do Intlayer para agregar e remover chaves com segurança.
+- **Capacidades ICU:** O suporte para pluralização, seleção e variantes ICU permanece robusto devido ao parser ICU unificado do Intlayer, garantindo resultados de renderização idênticos.

package/docs/pt/compat/next-i18next.md

@@ -0,0 +1,57 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrar de next-i18next para Intlayer"
+description: "Aprenda como migrar sua aplicação Next.js de next-i18next para Intlayer usando o adaptador de compatibilidade."
+keywords:
+  - next-i18next
+  - nextjs
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - next-i18next
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Migrar de next-i18next para Intlayer
+
+Para um tutorial completo e detalhado passo a passo, consulte nosso [Guia de Migração next-i18next](../migration_from_next-i18next_to_intlayer.md).
+
+O Intlayer manipula todas as implementações do Next.js Pages Router e App Router de forma transparente. Usar o adapter permite que você migre sua implementação de `next-i18next` sem reescrever nenhum código.
+
+## O que fazer
+
+Para começar, execute:
+
+```bash
+npx intlayer init
+```
+
+Isso cria o arquivo de configuração necessário do Intlayer. Para integrar o Intlayer nos bastidores, atualize seu `next.config.ts`:
+
+```typescript fileName="next.config.ts"
+import type { NextConfig } from "next";
+import { createNextI18nPlugin } from "@intlayer/next-i18next/plugin";
+
+const withIntlayer = createNextI18nPlugin();
+
+const nextConfig: NextConfig = {};
+
+export default withIntlayer(nextConfig);
+```
+
+## O que faz sob o capô
+
+O `createNextI18nPlugin` compõe o comportamento nativo do Next.js junto com o plugin central `next-intlayer`, injetando todos os aliases Webpack/Turbopack necessários para `next-i18next`, `react-i18next`, e `i18next`.
+
+Sob o capô:
+
+- **`serverSideTranslations` & `appWithTranslation`:** Agora funcionam como wrappers para os loaders internos do Intlayer, contornando a injeção estática de grandes JSONs.
+- **Client hooks:** Delega imediatamente para `@intlayer/react-i18next` mantendo todas as funcionalidades de formatação, plurais e namespaces aninhados.

package/docs/pt/compat/next-intl.md

@@ -0,0 +1,59 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrar de next-intl para Intlayer"
+description: "Aprenda como migrar sua aplicação Next.js de next-intl para Intlayer usando o adaptador de compatibilidade."
+keywords:
+  - next-intl
+  - nextjs
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - next-intl
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Migrar de next-intl para Intlayer
+
+Para um tutorial completo e detalhado passo a passo, consulte nosso [Guia de Migração next-intl](../migration_from_next-intl_to_intlayer.md).
+
+Migrar de `next-intl` para Intlayer permite que você mantenha seu roteamento de aplicação e sintaxe completamente intactos.
+
+## O que fazer
+
+Execute o seguinte comando no seu repositório:
+
+```bash
+npx intlayer init
+```
+
+Isso criará um `intlayer.config.ts`. No seu `next.config.ts`, use o wrapper do plugin para injetar perfeitamente os aliases `next-intl` em direção a `@intlayer/next-intl`.
+
+```typescript fileName="next.config.ts"
+import type { NextConfig } from "next";
+import { createNextIntlPlugin } from "@intlayer/next-intl/plugin";
+
+const withIntlayer = createNextIntlPlugin();
+
+const nextConfig: NextConfig = {};
+
+export default withIntlayer(nextConfig);
+```
+
+## O que faz nos bastidores
+
+O wrapper do bundler substitui traduções, mas **mantém os recursos de `next-intl/navigation` intactos** (p.ex. `Link`, `redirect`, `usePathname`).
+
+Nos bastidores:
+
+- **ICU runtime:** Plurais (`=0`, `one`, `other`), select/selectordinal, argumentos `#` e argumentos formatados (`{ts, date, long}`) funcionam corretamente usando o resolver compartilhado `resolveMessage(..., 'icu')`.
+- **`useTranslations()` & `getTranslations()`:** As chamadas de escopo simples extraem o primeiro segmento de chave como o identificador de dicionário correto. Namespaces aninhados se dividem graciosamente em caminhos de dicionário e prefixos.
+- **Rich formatting:** Tanto `t.rich()` quanto `t.markup()` são totalmente implementados nativamente, convertendo nós semelhantes a HTML em chunks React renderizados.
+- **`useFormatter`:** `relativeTime`, `list`, `dateTimeRange` e formatos nomeados da configuração fazem ponte para os formatadores nativos `Intl` principais.

package/docs/pt/compat/next-translate.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrar do Next Translate para Intlayer"
+description: "Aprenda como migrar sua aplicação Next.js do next-translate para Intlayer usando o adaptador de compatibilidade."
+keywords:
+  - next-translate
+  - nextjs
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - next-translate
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Migrar do Next Translate para o Intlayer
+
+Migrar de `next-translate` para Intlayer é uma substituição praticamente imediata que mantém sua sintaxe e tags existentes.
+
+## O que fazer
+
+Initialize Intlayer in your project:
+
+```bash
+npx intlayer init
+```
+
+O CLI irá scaffolding sua configuração. Você pode então aplicar o plugin Intlayer no seu `next.config.ts`, que injeta aliases de subpath em build-time mapeando `next-translate/useTranslation` para `@intlayer/next-translate`.
+
+## O que faz nos bastidores
+
+`next-translate` fornece hooks como `useTranslation('ns')`, `t('ns:key.path')`, e o componente `<Trans>`.
+
+Nos bastidores:
+
+- **Interpolação & Plurais:** Depende fortemente do comportamento do adaptador `react-i18next`. Tratados dinamicamente são placeholders `{{var}}` e pluralização mapeada a partir de sufixos como `key_0`, `key_one`, e `key_other`.
+- **Componente `<Trans>`:** Diretamente suportado para análise de tags semelhantes a HTML juntamente com uma prop `components` baseada em array.
+- **Namespaces:** Alias de subpath garante que sua `useTranslation` referencia os namespaces corretos do dicionário interno sem modificação manual.

package/docs/pt/compat/ngx-translate.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrar do NGX-Translate para Intlayer"
+description: "Aprenda como migrar sua aplicação Angular do ngx-translate para Intlayer usando o adaptador de compatibilidade."
+keywords:
+  - ngx-translate
+  - angular
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - ngx-translate
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Migrar de NGX-Translate para Intlayer
+
+Migrar sua aplicação Angular de `ngx-translate` para Intlayer é fácil com o compat adapter, permitindo que você evite a necessidade de reescrever todos os seus templates.
+
+## O que fazer
+
+Comece executando:
+
+```bash
+npx intlayer init
+```
+
+Isso configura o `intlayer.config.ts`. Substitua suas configurações `TranslateModule.forRoot()` e aliases de importação apropriadamente para apontar para `@intlayer/ngx-translate`.
+
+## O que faz por trás dos bastidores
+
+`ngx-translate` uses `TranslateService` (`instant`, `get`, `stream`) alongside the `{{ 'KEY' | translate:params }}` pipe and the `[translate]` directive.
+
+Por trás dos bastidores:
+
+- **Services:** `TranslateService` wraps `getIntlayer` and a locale observable, providing exactly the same methods.
+- **Pipes & Directives:** Re-implemented to resolve against Intlayer dictionaries directly.
+- **Loaders:** `TranslateHttpLoader` setups are converted to warning stubs because Intlayer inherently resolves and bundles your dictionaries at build time (or through standard dynamic imports), completely eliminating the need for HTTP loaders.

package/docs/pt/compat/nuxtjs-i18n.md

@@ -0,0 +1,46 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrar do NuxtJS I18n para Intlayer"
+description: "Aprenda como migrar sua aplicação Nuxt.js de @nuxtjs/i18n para Intlayer usando o adaptador de compatibilidade."
+keywords:
+  - nuxtjs-i18n
+  - nuxt
+  - vue
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - nuxtjs-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Migrar do NuxtJS I18n para Intlayer
+
+Migrar sua aplicação Nuxt de `@nuxtjs/i18n` para Intlayer é um processo perfeito usando o módulo adaptador Nuxt.
+
+## O que fazer
+
+Para inicializar o projeto, execute:
+
+```bash
+npx intlayer init
+```
+
+Isso irá configurar `intlayer.config.ts`. Depois, adicione o módulo Intlayer Nuxt (por exemplo, `@intlayer/nuxt-i18n`) no array de módulos do seu `nuxt.config.ts`. Isso aplica automaticamente a configuração de compatibilidade para sua aplicação.
+
+## O que faz internamente
+
+`@nuxtjs/i18n` envolve `vue-i18n` enquanto fornece composables de roteamento específicos do Nuxt (`useLocalePath`, `useSwitchLocalePath`, `<NuxtLinkLocale>`).
+
+Internamente:
+
+- **Translations:** Depende nativamente da camada de compatibilidade `@intlayer/vue-i18n` para todas as tarefas de tradução de strings (suportando completamente formatos `vue-i18n`, plurais por pipe e reatividade).
+- **Routing:** Espelha os composables de roteamento usando os helpers de URL localizadas do Intlayer.
+- **Configuration:** Lê `availableLocales` e configurações padrão diretamente do seu `intlayer.config.ts` para coordenar páginas Nuxt automaticamente.

package/docs/pt/compat/polyglot.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrar do Polyglot.js para o Intlayer"
+description: "Aprenda como migrar do Polyglot.js para o Intlayer usando o adaptador de compatibilidade."
+keywords:
+  - polyglot
+  - airbnb
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - polyglot
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Migrar do Polyglot.js para Intlayer
+
+Se está a utilizar o Polyglot.js da Airbnb, migrar para Intlayer é extremamente simples usando a camada de compatibilidade.
+
+## O que fazer
+
+Simplesmente execute o comando de inicialização em seu projeto:
+
+```bash
+npx intlayer init
+```
+
+Isso gera `intlayer.config.ts`. Você pode então utilizar o alias do plugin bundler para redirecionar transparentemente as importações do Polyglot para `@intlayer/polyglot`.
+
+## O que faz por trás dos panos
+
+A sintaxe do Polyglot.js normalmente depende de `polyglot.t('key', {name})` com interpolações `%{name}` e plurais `smart_count` separados por `"singular |||| plural"`.
+
+Por trás dos panos:
+
+- **Interpolation:** A camada de compatibilidade manipula placeholders `%{var}` nativamente.
+- **Plurals:** A string é dividida em `||||` e avaliada contra `Intl.PluralRules` nativo de acordo com a locale ativa, espelhando a ordem de bucket própria do Polyglot por locale.
+- **Dictionaries:** Você evita a necessidade de fornecer enormes configurações JSON para `new Polyglot()` – Intlayer manipula os dictionaries dinamicamente e os prune automaticamente.

package/docs/pt/compat/react-i18next.md

@@ -0,0 +1,58 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrar de react-i18next para Intlayer"
+description: "Aprenda como migrar sua aplicação React de react-i18next para Intlayer usando o adaptador de compatibilidade."
+keywords:
+  - react-i18next
+  - i18next
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - react-i18next
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Migrar de react-i18next para Intlayer
+
+Para um tutorial completo e detalhado passo a passo, consulte nosso completo [Guia de Migração react-i18next](../migration_from_react-i18next_to_intlayer.md).
+
+Usar o adaptador de compatibilidade do Intlayer permite que você migre de `react-i18next` sem qualquer alteração nos seus imports de código-fonte.
+
+## O que fazer
+
+Para inicializar o projeto, execute:
+
+```bash
+npx intlayer init
+```
+
+Durante a inicialização, o Intlayer instalará `@intlayer/react-i18next` e criará `intlayer.config.ts`. No seu bundler (como Vite), aplique o plugin do Intlayer:
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import { reactI18nextVitePlugin } from "@intlayer/react-i18next/plugin";
+
+export default defineConfig({
+  plugins: [react(), reactI18nextVitePlugin()],
+});
+```
+
+## O que faz sob o capô
+
+O `reactI18nextVitePlugin` envolve o plugin central `vite-intlayer` e injeta aliases de resolução para `react-i18next` e `i18next`, redirecionando-os para `@intlayer/react-i18next` e `@intlayer/i18next`.
+
+Sob o capô:
+
+- **`useTranslation` & `withTranslation`:** Reescritos para usar os hooks nativos do Intlayer, dando-lhe preenchimento automático de TypeScript para suas chaves de dicionário. Oferece suporte contínuo a namespaces (por exemplo, `t('namespace:key')`).
+- **Plurais & Contexto:** Manipula a pluralização baseada em sufixo do i18next (`key_one`, `key_other`) usando `Intl.PluralRules` nativo e sufixos de contexto (`key_male`).
+- **Componente `<Trans>`:** Re-implementado para suportar a prop `components`, formas de objeto e array, e tags numeradas `<1>...</1>` mapeadas diretamente para seus nós React.
+- **Instância `i18n`:** Resolve chaves diretamente do Intlayer sem buscar grandes arquivos JSON, resultando em tamanhos de bundle significativamente menores.

package/docs/pt/compat/react-intl.md

@@ -0,0 +1,55 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrar de React Intl para Intlayer"
+description: "Aprenda como migrar sua aplicação React de react-intl para Intlayer usando o adaptador de compatibilidade."
+keywords:
+  - react-intl
+  - formatjs
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - react-intl
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Migrar do React Intl para Intlayer
+
+Se sua aplicação React usa `react-intl` (FormatJS), a transição para Intlayer é muito fácil. Nossa camada de compatibilidade lida perfeitamente com ICU MessageFormat e todos os componentes `Formatted*` existentes.
+
+## O que fazer
+
+Comece executando o comando de inicialização em seu projeto:
+
+```bash
+npx intlayer init
+```
+
+Em seguida, configure o plugin Intlayer Vite ou Next.js em sua configuração. Este plugin injeta aliases em tempo de construção para redirecionar as importações de `react-intl` para `@intlayer/react-intl`.
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import reactIntlVitePlugin from "@intlayer/react-intl/plugin";
+
+export default defineConfig({
+  plugins: [react(), reactIntlVitePlugin()],
+});
+```
+
+## O que faz sob o capô
+
+O plugin bundler cria um alias de `react-intl` para `@intlayer/react-intl`. Em vez de analisar manualmente arquivos JSON grandes e envolver seu app em um `IntlProvider`, o plugin Intlayer extrai estaticamente chaves e usa dicionários Intlayer em tempo de execução.
+
+Sob o capô:
+
+- **ICU MessageFormat:** Intlayer usa o resolver `resolveMessage(..., 'icu')` que suporta totalmente pluralização ICU, seleção, formatação de data/número e tags de rich text nativamente.
+- **Method & JSX callers:** `intl.formatMessage({ id: 'a.b' })` e `<FormattedMessage id="a.b">` são identificados pelos plugins compilador Intlayer (`@intlayer/babel` / `@intlayer/swc`), convertendo chaves pontilhadas planas para que o primeiro segmento se resolva corretamente para a chave do dicionário Intlayer.
+- **Formatters:** `<FormattedNumber>`, `<FormattedDate>`, etc., fazem ponte para o `core/formatters` nativo usando `Intl`.

package/docs/pt/compat/svelte-i18n.md

@@ -0,0 +1,47 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrar de Svelte I18n para Intlayer"
+description: "Aprenda como migrar sua aplicação Svelte de svelte-i18n para Intlayer usando o adaptador de compatibilidade."
+keywords:
+  - svelte-i18n
+  - svelte
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - svelte-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Inicializar histórico"
+author: aymericzip
+---
+
+# Migrar de Svelte I18n para Intlayer
+
+Mover sua aplicação Svelte de `svelte-i18n` para Intlayer leva apenas um momento usando o adaptador de compatibilidade.
+
+## O que fazer
+
+Simplesmente execute o comando de inicialização no seu projeto:
+
+```bash
+npx intlayer init
+```
+
+Isso gera `intlayer.config.ts`. Certifique-se de que seus plugins SvelteKit / Vite estão envolvidos com o plugin de alias do Intlayer para mapear perfeitamente `svelte-i18n` para `@intlayer/svelte-i18n`.
+
+## O que acontece nos bastidores
+
+Svelte-i18n depende de stores intensamente usadas (`$_`, `$t`, `$format`, etc.) e ICU MessageFormat.
+
+Nos bastidores:
+
+- **Stores:** Intlayer faz proxy dos stores do `svelte-i18n`. `$_` torna-se uma derived store da locale atual retornando um resolver do Intlayer.
+- **Keys:** Suas chaves planas (ex. `$_('home.title')`) são avaliadas de forma que o primeiro segmento de caminho represente o dicionário do Intlayer.
+- **ICU Syntax:** Totalmente gerenciada pelo resolver ICU compartilhado (análise equivalente ao `intl-messageformat`).
+- **Formatters:** As chamadas `$date`, `$time`, `$number` redirecionam com segurança para os formatadores core nativos do Intlayer.
+- **Babel/SWC Analysis:** O analisador do Intlayer lê os callers de store do Svelte (`$_`) dentro de seus arquivos fonte `.svelte` antes da compilação para construir automaticamente os chunks de dicionário relevantes.

package/docs/pt/compat/transloco.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrar do Transloco para Intlayer"
+description: "Aprenda como migrar sua aplicação Angular do Transloco para Intlayer usando o adaptador de compatibilidade."
+keywords:
+  - transloco
+  - angular
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - transloco
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Migrar de Transloco para Intlayer
+
+Se sua aplicação Angular atualmente usa `@jsverse/transloco`, você pode migrar para Intlayer usando nosso adaptador de compatibilidade. Esta transição permite que você mantenha sua sintaxe de template existente enquanto utiliza a poderosa estrutura de dicionário do Intlayer.
+
+## O que fazer
+
+Execute simplesmente o comando de inicialização no seu projeto:
+
+```bash
+npx intlayer init
+```
+
+Isso vai gerar a configuração necessária `intlayer.config.ts`. Você então vai substituir seus imports Transloco com módulos `@intlayer/transloco` ou depender dos aliases de build.
+
+## O que faz sob o capô
+
+Transloco usa scopes e um `TranslocoService` (`translate`, `selectTranslate`), juntamente com diretivas estruturais (`*transloco="let t"`) e pipes (`| transloco`).
+
+Sob o capô:
+
+- **Scopes:** Mapeiam naturalmente para chaves de dicionário do Intlayer, fornecendo uma ótima história de pruning para otimização de bundle.
+- **Service & Directives:** O adaptador Angular do Intlayer substitui perfeitamente os provedores, permitindo que seus pipes e diretivas de template existentes resolvam strings contra dicionários do Intlayer.
+- **Build time parsing:** O analisador TypeScript reconhece chamadas `instant/get`, e fallback pruning garante correção mesmo quando o uso do template não é estaticamente rastreável.

package/docs/pt/compat/vue-i18n.md

@@ -0,0 +1,58 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrar de Vue I18n para Intlayer"
+description: "Aprenda como migrar sua aplicação Vue de vue-i18n para Intlayer usando o adaptador de compatibilidade."
+keywords:
+  - vue-i18n
+  - vue
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - vue-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Migrar de Vue I18n para Intlayer
+
+Se sua aplicação Vue atualmente usa `vue-i18n`, você pode migrar para Intlayer sem reescrever seus componentes ou traduzir hooks. Intlayer fornece um adaptador de compatibilidade que espelha perfeitamente a API do `vue-i18n` enquanto aproveita os poderosos recursos do Intlayer por trás dos panos.
+
+## O que fazer
+
+Para começar, basta executar o comando de inicialização no seu projeto:
+
+```bash
+npx intlayer init
+```
+
+Durante a inicialização, o Intlayer configurará seu arquivo de configuração (`intlayer.config.ts`) e preparará seu projeto para migração. Você só precisará adicionar o plugin Intlayer à sua configuração do Vite para fazer um alias automático das importações `vue-i18n`.
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import vue from "@vitejs/plugin-vue";
+import vueI18nVitePlugin from "@intlayer/vue-i18n/plugin";
+
+export default defineConfig({
+  plugins: [vue(), vueI18nVitePlugin()],
+});
+```
+
+## O que faz por baixo
+
+O `vueI18nVitePlugin` injeta um alias de módulo no seu bundler. Qualquer import de `vue-i18n` no seu codebase será redirecionado transparentemente para `@intlayer/vue-i18n`.
+
+**Por baixo, o adapter manipula a sintaxe complexa do `vue-i18n` nativamente:**
+
+- **Interpolação & Plurais:** Resolve interpolações `{name}` e de lista `{0}`. Plurais com pipe (`"car | cars"`) são convertidos em nós de enumeração/plural do Intlayer baseados em semântica posicional.
+- **Formatos:** Funções como `d()` e `n()` envolvem `Intl` por baixo, honrando os `datetimeFormats` e `numberFormats` definidos nas suas opções.
+- **Estado Global & Local:** `global.locale` é mapeado para um `WritableComputedRef` apoiado pelo cliente Intlayer, então a reatividade funciona exatamente como esperado (ex: `locale.value = 'fr'`).
+- **Diretivas:** A diretiva `v-t` é registrada e funciona normalmente.
+
+Sua aplicação continua renderizando exatamente como antes, mas o conteúdo é alimentado pelos seus dicionários Intlayer, oferecendo segurança de tipo, melhor otimização de bundle e integração CMS contínua.