@intlayer/docs 8.12.5-canary.0 → 9.0.0-canary.11

package/docs/es/cli/doc-review.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2026-06-17
 title: Revisar Documento
 description: Aprende cómo revisar archivos de documentación para calidad, consistencia y completitud en diferentes locales.
 keywords:
@@ -15,6 +15,10 @@ slugs:
   - concept
   - cli
   - doc-review
+history:
+  - version: 9.0.0
+    date: 2026-06-17
+    changes: "Añadir opción --log"
 author: aymericzip
 ---
 
@@ -55,8 +59,110 @@ Para la mayoría de los casos de uso,
 
 ## Argumentos:
 
-El comando `doc review` acepta los mismos argumentos que `doc translate`, permitiéndote revisar archivos de documentación específicos y aplicar controles de calidad.
+**Opciones de lista de archivos:**
 
-Si activaste una de las opciones de git, el comando solo revisará la parte de los archivos que están siendo modificados. El script procesará el archivo dividiéndolo en fragmentos y revisará cada fragmento. Si no hay cambios en el fragmento, el script lo omitirá para acelerar el proceso de revisión y limitar el costo de la API del proveedor de IA.
+- **`--doc-pattern [docPattern...]`**: Patrones glob para coincidir con archivos de documentación a revisar.
 
-Para una lista completa de argumentos, consulta la documentación del comando [Translate Document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/doc-translate.md).
+  > Ejemplo: `npx intlayer doc review --doc-pattern "docs/**/*.md" "src/**/*.mdx"`
+
+- **`--excluded-glob-pattern [excludedGlobPattern...]`**: Patrones glob para excluir archivos de la revisión.
+
+  > Ejemplo: `npx intlayer doc review --excluded-glob-pattern "docs/internal/**"`
+
+- **`--skip-if-modified-before [skipIfModifiedBefore]`**: Omitir el archivo si ha sido modificado antes del tiempo dado.
+  - Puede ser un tiempo absoluto como "2025-12-05" (string o Date)
+  - Puede ser un tiempo relativo en ms `1 * 60 * 60 * 1000` (1 hora)
+  - Esta opción verifica la hora de actualización del archivo usando el método `fs.stat`. Por lo tanto, podría verse afectada por Git u otras herramientas que modifiquen el archivo.
+
+  > Ejemplo: `npx intlayer doc review --skip-if-modified-before "2025-12-05"`
+
+- **`--skip-if-modified-after [skipIfModifiedAfter]`**: Omitir el archivo si ha sido modificado dentro del tiempo dado.
+  - Puede ser un tiempo absoluto como "2025-12-05" (string o Date)
+  - Puede ser un tiempo relativo en ms `1 * 60 * 60 * 1000` (1 hora)
+  - Esta opción verifica la hora de actualización del archivo usando el método `fs.stat`. Por lo tanto, podría verse afectada por Git u otras herramientas que modifiquen el archivo.
+
+  > Ejemplo: `npx intlayer doc review --skip-if-modified-after "2025-12-05"`
+
+- **`--skip-if-exists`**: Omitir el archivo si ya existe.
+
+  > Ejemplo: `npx intlayer doc review --skip-if-exists`
+
+**Opciones de modo de revisión:**
+
+- **`--log`**: Modo de solo registro. No traduce con IA; en su lugar, registra los bloques que necesitan atención (con números de línea y contenido) para los locales base y destino, para ayudar a otro agente a generar las traducciones.
+
+  > Ejemplo: `npx intlayer doc review --log`
+
+**Opciones de salida de entrada:**
+
+- **`--locales [locales...]`**: Locales de destino para revisar la documentación.
+
+  > Ejemplo: `npx intlayer doc review --locales fr es de`
+
+- **`--base-locale [baseLocale]`**: Locale de origen (documento base) contra el cual comparar.
+
+  > Ejemplo: `npx intlayer doc review --base-locale en`
+
+**Opciones de procesamiento de archivos:**
+
+- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**: Número de archivos a procesar simultáneamente para la revisión.
+
+  > Ejemplo: `npx intlayer doc review --nb-simultaneous-file-processed 5`
+
+**Opciones de IA:**
+
+- **`--model [model]`**: El modelo de IA a usar para la revisión (por ejemplo, `gpt-3.5-turbo`).
+- **`--provider [provider]`**: El proveedor de IA a usar para la revisión.
+- **`--temperature [temperature]`**: Configuración de temperatura para el modelo de IA.
+- **`--api-key [apiKey]`**: Proporciona tu propia clave API para el servicio de IA.
+- **`--application-context [applicationContext]`**: Proporciona contexto adicional para la revisión de IA.
+- **`--data-serialization [dataSerialization]`**: El formato de serialización de datos a utilizar para las funciones de IA de Intlayer. Opciones: `json` (estándar, confiable), `toon` (menos tokens, menos consistente).
+- **`--custom-prompt [prompt]`**: Personaliza el prompt base utilizado para la revisión. (Nota: Para la mayoría de los casos, se recomienda usar la opción `--custom-instructions` en su lugar, ya que proporciona un mejor control.)
+
+  > Ejemplo: `npx intlayer doc review --model deepseek-chat --provider deepseek --temperature 0.5 --api-key sk-1234567890 --application-context "Mi aplicación es una tienda de gatos"`
+
+**Opciones de variables de entorno:**
+
+- **`--env`**: Especifica el entorno (por ejemplo, `development`, `production`).
+- **`--env-file [envFile]`**: Proporciona un archivo de entorno personalizado para cargar variables.
+- **`--base-dir`**: Especifica el directorio base para el proyecto.
+- **`--no-cache`**: Desactiva la caché.
+
+  > Ejemplo: `npx intlayer doc review --base-dir ./docs --env-file .env.production.local`
+
+**Opciones de registro:**
+
+- **`--verbose`**: Habilita el registro detallado para depuración. (por defecto es true usando CLI)
+
+  > Ejemplo: `npx intlayer doc review --verbose`
+
+**Opciones de instrucciones personalizadas:**
+
+- **`--custom-instructions [customInstructions]`**: Instrucciones personalizadas añadidas al prompt. Útil para aplicar reglas específicas respecto al formato, traducción de URLs, etc.
+
+  > Ejemplo: `npx intlayer doc review --custom-instructions "Evitar traducir URLs y mantener el formato markdown"`
+
+  > Ejemplo: `npx intlayer doc review --custom-instructions "$(cat ./instructions.md)"`
+
+**Opciones de Git:**
+
+- **`--git-diff`**: Ejecutar solo en archivos que incluyan cambios desde la base (por defecto `origin/main`) hasta la rama actual (por defecto: `HEAD`).
+- **`--git-diff-base`**: Especificar la referencia base para git diff (por defecto `origin/main`).
+- **`--git-diff-current`**: Especificar la referencia actual para git diff (por defecto: `HEAD`).
+- **`--uncommitted`**: Incluir cambios no confirmados.
+- **`--unpushed`**: Incluir cambios no enviados.
+- **`--untracked`**: Incluir archivos no rastreados.
+
+  > Ejemplo: `npx intlayer doc review --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Ejemplo: `npx intlayer doc review --uncommitted --unpushed --untracked`
+
+> Tenga en cuenta que la ruta del archivo de salida se determinará reemplazando los siguientes patrones:
+>
+> - `/{{baseLocale}}/` por `/{{locale}}/` (Unix)
+> - `\{{baseLocale}}\` por `\{{locale}}\` (Windows)
+> - `_{{baseLocale}}.` por `_{{locale}}.`
+> - `{{baseLocale}}_` por `{{locale}}_`
+> - `.{{baseLocaleName}}.` por `.{{localeName}}.`
+>
+> Si no se encuentra el patrón, el archivo de salida añadirá `.{{locale}}` a la extensión del archivo. `./my/file.md` se revisará y actualizará a `./my/file.fr.md` para el locale francés.

package/docs/es/cli/fill.md

@@ -47,6 +47,14 @@ Puntos clave:
 - Preserva las traducciones existentes al no sobrescribirlas.
 - Procesa archivos, fragmentos y locales en paralelo usando un sistema de cola para aumentar la velocidad.
 
+## Puntos clave:
+
+- Divide archivos JSON grandes en chunks para mantenerse dentro de los límites de la ventana de contexto del modelo de IA.
+- Reintenta la traducción si el formato de salida es incorrecto.
+- Incorpora contexto específico de la aplicación y del archivo para una precisión de traducción mejorada.
+- Preserva las traducciones existentes sin sobrescribirlas.
+- Procesa archivos, chunks y locales en paralelo usando un sistema de cola para aumentar la velocidad.
+
 ## Alias:
 
 - `npx intlayer dictionaries fill`

package/docs/es/cli/index.md

@@ -17,7 +17,7 @@ slugs:
   - concept
   - cli
 history:
-  - version: 8.13.0
+  - version: 9.0.0
     date: 2026-06-11
     changes: "Agregar comando scan"
   - version: 8.6.4

package/docs/es/cli/login.md

@@ -78,42 +78,6 @@ bun x intlayer login --cms-url https://intlayer.org
 
 ### Opciones de configuración
 
-También puedes usar opciones de configuración comunes:
-
-- `--env-file <path>`: Ruta al archivo de entorno
-- `-e, --env <env>`: Entorno de ejecución
-- `--base-dir <dir>`: Directorio base del proyecto
-- `--verbose`: Habilitar salida detallada (por defecto: true)
-- `--prefix <prefix>`: Prefijo para los logs
-
-## Cómo funciona
-
-1. **Inicio de servidor local**: El comando inicia un servidor HTTP local en un puerto aleatorio para recibir las credenciales desde el CMS
-
-Especifica la URL del CMS de Intlayer al que conectarse para la autenticación.
-
-- **Tipo**: `string`
-- **Por defecto**: El valor configurado en `intlayer.config.*` o `https://intlayer.org`
-- **Ejemplo**:
-
-```bash packageManager="npm"
-npx intlayer login --cms-url https://intlayer.org
-```
-
-```bash packageManager="yarn"
-yarn intlayer login --cms-url https://intlayer.org
-```
-
-```bash packageManager="pnpm"
-pnpm intlayer login --cms-url https://intlayer.org
-```
-
-```bash packageManager="bun"
-bun x intlayer login --cms-url https://intlayer.org
-```
-
-### Opciones de configuración
-
 También puedes usar las opciones de configuración comunes:
 
 - `--env-file <path>`: Ruta al archivo de entorno

package/docs/es/cli/scan.md

@@ -18,7 +18,7 @@ slugs:
   - cli
   - scan
 history:
-  - version: 8.13.0
+  - version: 9.0.0
     date: 2026-06-11
     changes: "Agregar comando scan"
 author: aymericzip

package/docs/es/compat/i18n-js.md

@@ -0,0 +1,44 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrar de i18n-js a Intlayer"
+description: "Aprende cómo migrar tu aplicación desde i18n-js a Intlayer usando el adaptador de compatibilidad."
+keywords:
+  - i18n-js
+  - intlayer
+  - migración
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - i18n-js
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Inicializar historial"
+author: aymericzip
+---
+
+# Migrar de i18n-js a Intlayer
+
+Hacer la transición desde la biblioteca `i18n-js` a Intlayer es una migración altamente optimizada diseñada para descargar grandes configuraciones de traducciones en el sistema de resolución de archivos estructurados de Intlayer.
+
+## Qué hacer
+
+Ejecuta el siguiente comando de configuración en tu repositorio:
+
+```bash
+npx intlayer init
+```
+
+Con `intlayer.config.ts` preparado, puedes agregar el alias de Intlayer a tu configuración del empaquetador para que cualquier importación de `i18n-js` apunte al paquete de compatibilidad `@intlayer/i18n-js`.
+
+## Qué hace bajo el capó
+
+`i18n-js` accede a namespaces a través de expresiones como `i18n.t('scope.key', {name})` junto con fallbacks de locale y mapeos de plurales específicos.
+
+Bajo el capó:
+
+- **Interpolación:** El adaptador de compatibilidad analiza fácilmente mapeos `%{name}` en tu valor de diccionario de runtime objetivo.
+- **Pluralización:** Reemplaza subclaves `one/other` y las asigna contra los poderosos mecanismos de plurales subyacentes de Intlayer (`Intl.PluralRules`), abstrayendo mapeos manuales.
+- **Locales:** En lugar de cargar cargas de idioma monolíticas en el bootstrap, los diccionarios se sirven de manera óptima según la configuración de contexto actual a través de la configuración nativa de Intlayer.

package/docs/es/compat/i18next.md

@@ -0,0 +1,59 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrar de i18next a Intlayer"
+description: "Aprende cómo migrar tu aplicación JavaScript/TypeScript vanilla desde i18next a Intlayer usando el adaptador de compatibilidad."
+keywords:
+  - i18next
+  - vanilla
+  - javascript
+  - typescript
+  - intlayer
+  - migración
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - i18next
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Inicializar historial"
+author: aymericzip
+---
+
+# Migrar de i18next a Intlayer
+
+Para un tutorial detallado paso a paso, por favor consulta nuestro [Guía Completa de Migración de i18next](../migration_from_i18next_to_intlayer.md).
+
+Intlayer replica perfectamente las características de runtime principales de `i18next`. Al utilizar el paquete de compatibilidad, tus aplicaciones Vanilla o módulos internos pueden continuar aprovechando la sintaxis familiar.
+
+## Qué hacer
+
+Para comenzar, inicializa Intlayer en tu proyecto:
+
+```bash
+npx intlayer init
+```
+
+Si estás usando Vite, incluye el plugin de Intlayer para enrutar importaciones a `@intlayer/i18next`:
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { i18nextVitePlugin } from "@intlayer/i18next/plugin";
+
+export default defineConfig({
+  plugins: [i18nextVitePlugin()],
+});
+```
+
+## Qué hace bajo el capó
+
+El `i18nextVitePlugin` asigna importaciones de `i18next` a `@intlayer/i18next`, evitando la inflación del bundle de las inclusiones de archivos JSON.
+
+Bajo el capó:
+
+- **Configuración de instancia:** `createInstance` analiza correctamente y aplica fallbacks de namespace mientras aprovecha el pipeline de compilación de Intlayer para la recuperación de diccionarios.
+- **Interpolación:** Soporte nativo para reemplazos de `{{name}}` y anidamiento `$t(key)` recursivamente.
+- **Contexto y plurales:** Identifica y resuelve formatos de sufijo como `key_male` y `key_one`/`key_other` evaluando contra `Intl.PluralRules` estándar.
+- **Objetos de retorno:** El modo `returnObjects: true` extrae de forma segura árboles de diccionarios de Intlayer.

package/docs/es/compat/index.md

@@ -0,0 +1,51 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Adaptadores de Compatibilidad de Intlayer"
+description: "Migra tu solución i18n existente a Intlayer sin fricciones usando adaptadores de compatibilidad."
+keywords:
+  - compat
+  - migración
+  - internacionalización
+  - i18n
+  - Intlayer
+slugs:
+  - doc
+  - compatibility
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Inicializar historial"
+author: aymericzip
+---
+
+# Adaptadores de Compatibilidad de Intlayer
+
+Migrar una aplicación grande a una nueva biblioteca de internacionalización puede ser desalentador. Para facilitar esta transición, Intlayer proporciona **adaptadores de compatibilidad** para las bibliotecas i18n más populares del ecosistema.
+
+Estos paquetes adaptadores exponen la **misma API pública exacta** que tus bibliotecas i18n existentes, pero delegan todo el trabajo de traducción a Intlayer en tiempo de ejecución.
+
+## Cómo funciona
+
+Cuando usas un adaptador de compatibilidad, no necesitas reescribir las importaciones de tu aplicación ni cambiar cómo usas tus hooks de traducción y componentes. En su lugar, los plugins del empaquetador de Intlayer identifican automáticamente tus importaciones existentes con los paquetes de compatibilidad de Intlayer.
+
+Por ejemplo, un desarrollador reemplaza `import { useTranslation } from 'react-i18next'` con `import { useTranslation } from '@intlayer/react-i18next'` (hecho automáticamente mediante el plugin del empaquetador), y la aplicación continúa funcionando con traducciones servidas ahora desde diccionarios de Intlayer. ¡Las claves también se escriben contra tus diccionarios de Intlayer!
+
+## Adaptadores de Compatibilidad Disponibles
+
+Elige tu biblioteca existente a continuación para ver cómo migrar sin problemas:
+
+- [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/es/compat/lingui.md

@@ -0,0 +1,44 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrar de Lingui a Intlayer"
+description: "Aprende cómo migrar tu aplicación desde Lingui a Intlayer usando el adaptador de compatibilidad."
+keywords:
+  - lingui
+  - intlayer
+  - migración
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - lingui
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Inicializar historial"
+author: aymericzip
+---
+
+# Migrar de Lingui a Intlayer
+
+Si tu proyecto actualmente se basa en la compilación basada en macros de Lingui, hacer la transición a Intlayer te permite mantener tus potentes flujos de trabajo de macros mientras los respalda nativamente con la estrategia de compilación JSON de Intlayer.
+
+## Qué hacer
+
+Para comenzar, inicializa Intlayer en tu proyecto:
+
+```bash
+npx intlayer init
+```
+
+Esto crea tu `intlayer.config.ts`. Asegúrate de retener `@lingui/babel-plugin-lingui-macro` / `@lingui/swc-plugin` en tu paso de compilación para ejecutarse _antes_ del compilador de Intlayer. Luego, utiliza el alias del plugin del empaquetador para enrutar `@lingui/core` y `@lingui/react` a `@intlayer/lingui`.
+
+## Qué hace bajo el capó
+
+Lingui utiliza macros (como `` t`Hello ${name}` `` y `<Trans>`) que se compilan en llamadas de runtime como `i18n._(id, values)`.
+
+Bajo el capó:
+
+- **Macros:** Se compilan exactamente como lo hacían antes, asegurando sin perturbación en tu sintaxis fuente.
+- **Traducción de runtime:** El `i18n._()` asignado utiliza diccionarios de Intlayer. Tanto los IDs nombrados explícitamente como los IDs con hash se asignan completamente utilizando los plugins de sincronización `.po` de Intlayer para agregar y podar claves de forma segura.
+- **Capacidades ICU:** El soporte para pluralización, selección y variantes ICU sigue siendo robusto debido al analizador ICU unificado de Intlayer, asegurando salidas de renderizado idénticas.

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

@@ -0,0 +1,57 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrar de next-i18next a Intlayer"
+description: "Aprende cómo migrar tu aplicación Next.js desde next-i18next a Intlayer usando el adaptador de compatibilidad."
+keywords:
+  - next-i18next
+  - nextjs
+  - intlayer
+  - migración
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - next-i18next
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Inicializar historial"
+author: aymericzip
+---
+
+# Migrar de next-i18next a Intlayer
+
+Para un tutorial completo y detallado paso a paso, por favor consulta nuestra [Guía Completa de Migración de next-i18next](../migration_from_next-i18next_to_intlayer.md).
+
+Intlayer maneja todas las implementaciones de Pages Router y App Router de Next.js de forma transparente. Usar el adaptador te permite migrar tu implementación de `next-i18next` sin reescritura de código.
+
+## Qué hacer
+
+Para comenzar, ejecuta:
+
+```bash
+npx intlayer init
+```
+
+Esto crea el archivo de configuración requerido de Intlayer. Para cambiar a Intlayer tras bastidores, actualiza tu `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);
+```
+
+## Qué hace bajo el capó
+
+El `createNextI18nPlugin` compone el comportamiento nativo de Next.js junto con el plugin principal `next-intlayer`, inyectando todos los alias requeridos de Webpack/Turbopack para `next-i18next`, `react-i18next` e `i18next`.
+
+Bajo el capó:
+
+- **`serverSideTranslations` y `appWithTranslation`:** Ahora funcionan como envoltorios para los cargadores internos de Intlayer, evitando la inyección estática de JSON grande.
+- **Hooks del cliente:** Delegan inmediatamente a `@intlayer/react-i18next` reteniendo todas las características de formateo, plurales y namespace anidados.

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

@@ -0,0 +1,61 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrar de next-intl a Intlayer"
+description: "Aprende cómo migrar tu aplicación Next.js desde next-intl a Intlayer usando el adaptador de compatibilidad."
+keywords:
+  - next-intl
+  - nextjs
+  - intlayer
+  - migración
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - next-intl
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Inicializar historial"
+author: aymericzip
+---
+
+# Migrar de next-intl a Intlayer
+
+Para un tutorial completo y detallado paso a paso, por favor consulta nuestra [Guía Completa de Migración de next-intl](../migration_from_next-intl_to_intlayer.md).
+
+Migrar de `next-intl` a Intlayer te permite mantener tu enrutamiento y sintaxis de aplicación completamente sin perturbaciones.
+
+## Qué hacer
+
+Ejecuta el siguiente comando en tu repositorio:
+
+```bash
+npx intlayer init
+```
+
+Esto creará un `intlayer.config.ts`. En tu `next.config.ts`, usa el wrapper del plugin para inyectar sin problemas los aliases de `next-intl` hacia `@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);
+```
+
+## Qué hace bajo el capó
+
+El wrapper del plugin `@intlayer/next-intl` proporciona alias automáticos que redireccionan todas las importaciones de `next-intl` a `@intlayer/next-intl` durante la compilación.
+
+Bajo el capó:
+
+- **Routing:** El enrutamiento dinámico basado en locale basado en segmentos de `[locale]` continúa funcionando exactamente como lo hacía con `next-intl`, pero ahora las traducciones se sirven desde diccionarios de Intlayer.
+- **`useTranslations`:** Se reimplementa para devolver una función tipada que se vincula automáticamente a tus diccionarios de Intlayer.
+- **`getTranslations`:** En funciones del servidor, obtiene acceso tipado a contenido de Intlayer sin hacer solicitudes de red.
+- **Middleware:** Intlayer proporciona un middleware de routing automático que reconoce locales y gestiona redirecciones.
+
+Tu aplicación mantiene la misma estructura y sintaxis, pero ahora con el poder de Intlayer dirigiendo las traducciones.

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

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrar de Next Translate a Intlayer"
+description: "Aprende cómo migrar tu aplicación Next.js desde next-translate a Intlayer usando el adaptador de compatibilidad."
+keywords:
+  - next-translate
+  - nextjs
+  - intlayer
+  - migración
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - next-translate
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Inicializar historial"
+author: aymericzip
+---
+
+# Migrar de Next Translate a Intlayer
+
+Migrar de `next-translate` a Intlayer es un reemplazo casi directo que retiene tu sintaxis y etiquetas existentes.
+
+## Qué hacer
+
+Inicializa Intlayer en tu proyecto:
+
+```bash
+npx intlayer init
+```
+
+El CLI generará tu configuración. Luego, puedes aplicar el plugin de Intlayer en tu `next.config.ts`, el cual inyecta aliases de subpaths en tiempo de compilación mapeando `next-translate/useTranslation` a `@intlayer/next-translate`.
+
+## Qué hace bajo el capó
+
+`next-translate` proporciona hooks como `useTranslation('ns')`, `t('ns:key.path')`, y el componente `<Trans>`.
+
+Bajo el capó:
+
+- **Interpolación y plurales:** Se basa estrechamente en el comportamiento del adaptador `react-i18next`. Se manejan dinámicamente son los placeholders `{{var}}` y la pluralización mapeada desde sufijos como `key_0`, `key_one` y `key_other`.
+- **Componente `<Trans>`:** Directamente soportado para análisis de etiquetas tipo HTML junto con una prop `components` basada en arrays.
+- **Namespaces:** Los aliases de subpaths aseguran que tus referencias de `useTranslation` apunten a los namespaces de diccionarios internos correctos sin modificación manual.

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

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrar de NGX-Translate a Intlayer"
+description: "Aprende cómo migrar tu aplicación Angular desde ngx-translate a Intlayer usando el adaptador de compatibilidad."
+keywords:
+  - ngx-translate
+  - angular
+  - intlayer
+  - migración
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - ngx-translate
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Inicializar historial"
+author: aymericzip
+---
+
+# Migrar de NGX-Translate a Intlayer
+
+Migrar tu aplicación Angular desde `ngx-translate` a Intlayer es fácil con el adaptador de compatibilidad, permitiéndote evitar la necesidad de reescribir todas tus plantillas.
+
+## Qué hacer
+
+Comienza ejecutando:
+
+```bash
+npx intlayer init
+```
+
+Esto configura `intlayer.config.ts`. Reemplaza tus configuraciones `TranslateModule.forRoot()` e importa alias apropiadamente para apuntar a `@intlayer/ngx-translate`.
+
+## Qué hace bajo el capó
+
+`ngx-translate` utiliza `TranslateService` (`instant`, `get`, `stream`) junto con el pipe `{{ 'KEY' | translate:params }}` y la directiva `[translate]`.
+
+Bajo el capó:
+
+- **Servicios:** `TranslateService` envuelve `getIntlayer` y un observable de locale, proporcionando exactamente los mismos métodos.
+- **Pipes y directivas:** Reimplementados para resolver directamente contra diccionarios de Intlayer.
+- **Cargadores:** Las configuraciones de `TranslateHttpLoader` se convierten en stubs de advertencia porque Intlayer inherentemente resuelve y agrupa tus diccionarios en tiempo de compilación (o a través de importaciones dinámicas estándar), eliminando completamente la necesidad de cargadores HTTP.

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

@@ -0,0 +1,46 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrar de NuxtJS I18n a Intlayer"
+description: "Aprende cómo migrar tu aplicación Nuxt desde @nuxtjs/i18n a Intlayer usando el módulo adaptador de compatibilidad."
+keywords:
+  - nuxtjs-i18n
+  - nuxt
+  - vue
+  - intlayer
+  - migración
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - nuxtjs-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Inicializar historial"
+author: aymericzip
+---
+
+# Migrar de NuxtJS I18n a Intlayer
+
+Migrar tu aplicación Nuxt desde `@nuxtjs/i18n` a Intlayer es un proceso sin problemas usando el módulo adaptador de Nuxt.
+
+## Qué hacer
+
+Para inicializar el proyecto, ejecuta:
+
+```bash
+npx intlayer init
+```
+
+Esto configurará `intlayer.config.ts`. Luego, agrega el módulo Nuxt de Intlayer (p. ej. `@intlayer/nuxt-i18n`) en el array de módulos de tu `nuxt.config.ts`. Esto aplica automáticamente la configuración de compatibilidad para tu aplicación.
+
+## Qué hace bajo el capó
+
+`@nuxtjs/i18n` envuelve `vue-i18n` mientras proporciona composables de enrutamiento específicos de Nuxt (`useLocalePath`, `useSwitchLocalePath`, `<NuxtLinkLocale>`).
+
+Bajo el capó:
+
+- **Traducciones:** Se basa nativamente en la capa de compatibilidad `@intlayer/vue-i18n` para todas las tareas de traducción de cadenas (soportando completamente formatos de `vue-i18n`, plurales de tubería y reactividad).
+- **Enrutamiento:** Refleja los composables de enrutamiento utilizando los helpers de URL localizadas de Intlayer.
+- **Configuración:** Lee los `availableLocales` y la configuración predeterminada directamente desde tu `intlayer.config.ts` para coordinar páginas de Nuxt automáticamente.