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

package/docs/es/benchmark/solid.md

@@ -118,6 +118,28 @@ Comparamos **quatro estrategias de carga**:
 - **Scoped static**: Mantiene el código organizado (separación lógica) sin solicitudes de red adicionales complejas.
 - **Scoped dynamic**: El mejor enfoque para el _code splitting_ y el rendimiento. Minimiza la memoria cargando solo lo que la vista actual y el idioma activo necesitan.
 
+### Lo que medí:
+
+Ejecuté la misma aplicación multilingüe en un navegador real para cada stack, luego anoté lo que realmente aparecía en la red y cuánto tiempo tomaba. Los tamaños se reportan **después de la compresión web normal**, porque eso es más cercano a lo que la gente descarga que los recuentos de código fuente sin procesar.
+
+- **Tamaño de la biblioteca de internacionalización**: Después de agrupar, tree-shaking y minificación, el tamaño de la biblioteca i18n es el tamaño del código de providers + hooks/primitives en un componente vacío. No incluye la carga de archivos de traducción. Responde qué tan costosa es la biblioteca antes de que tu contenido entre en juego.
+
+- **JavaScript por página**: Para cada ruta de benchmark, cuánto script descarga el navegador en esa visita, promediado en las páginas de la suite (y en idiomas donde el informe los agrupa). Las páginas pesadas son páginas lentas.
+
+- **Fuga de otros idiomas**: Es el contenido de la misma página pero en otro idioma que se cargaría por error en la página auditada. Este contenido es innecesario y debe evitarse. (por ejemplo, contenido de la página `/fr/about` en el bundle de la página `/en/about`)
+
+- **Fuga de otras rutas**: La misma idea para **otras pantallas** en la aplicación: si su contenido viene junto cuando solo abriste una página. (por ejemplo, contenido de la página `/en/about` en el bundle de la página `/en/contact`). Una puntuación alta sugiere un splitting débil o bundles demasiado amplios.
+
+- **Tamaño promedio del bundle de componentes**: Las piezas comunes de la interfaz de usuario se miden **una a la vez** en lugar de esconderse dentro de un número de aplicación gigante. Muestra si la internacionalización infla silenciosamente los componentes cotidianos. Por ejemplo, si tu componente se vuelve a renderizar, cargará todos esos datos de la memoria. Adjuntar un JSON gigante a cualquier componente es como conectar un gran almacén de datos no utilizados que ralentizará el rendimiento de tus componentes.
+
+- **Responsividad del cambio de idioma**: Cambio el idioma usando el control de la aplicación y mido cuánto tiempo tarda hasta que la página se haya cambiado claramente, lo que un visitante notaría, no un micro-paso de laboratorio.
+
+- **Trabajo de renderización después de un cambio de idioma**: Un seguimiento más estrecho: cuánto esfuerzo requirió la interfaz para repintarse con el nuevo idioma una vez que el cambio está en vuelo. Útil cuando el tiempo "sentido" y el costo del framework divergen.
+
+- **Tiempo de carga inicial de la página**: Desde la navegación hasta que el navegador considera la página completamente cargada para los escenarios que probé. Bueno para comparar inicios en frío.
+
+- **Tiempo de hidratación**: Cuando la aplicación lo expone, cuánto tiempo pasa el cliente transformando HTML del servidor en algo que realmente puedas hacer clic. Un guion en las tablas significa que esa implementación no proporcionó una figura de hidratación confiable en este benchmark.
+
 ## Estrellas de GitHub
 
 Las estrellas de GitHub son un fuerte indicador de la popularidad de un proyecto, la confianza de la comunidad y la relevancia a largo plazo. Si bien no son una medida directa de la calidad técnica, reflejan cuántos desarrolladores encuentran útil el proyecto, siguen su progreso y es probable que lo adopten. Para estimar el valor de un proyecto, las estrellas ayudan a comparar la tracción entre alternativas y brindan información sobre el crecimiento del ecosistema.

package/docs/es/benchmark/svelte.md

@@ -116,6 +116,28 @@ Comparamos **quatro estrategias de carga**:
 - **Scoped static**: Mantiene el código organizado (separación lógica) sin solicitudes de red adicionales complejas.
 - **Scoped dynamic**: El mejor enfoque para el _code splitting_ y el rendimiento. Minimiza la memoria cargando solo lo que la vista actual y el idioma activo necesitan.
 
+### Lo que medí:
+
+Ejecuté la misma aplicación multilingüe en un navegador real para cada stack, luego anoté lo que realmente apareció en la red y cuánto tiempo tomó. Los tamaños se reportan **después de la compresión web normal**, porque eso es más cercano a lo que las personas descargan que los recuentos de código fuente sin procesar.
+
+- **Tamaño de la biblioteca de internacionalización**: Después del bundling, tree-shaking y minificación, el tamaño de la biblioteca i18n es el tamaño del código de providers + stores en un componente vacío. No incluye la carga de archivos de traducción. Responde qué tan costosa es la biblioteca antes de que tu contenido entre en juego.
+
+- **JavaScript por página**: Para cada ruta de benchmark, cuánto script descarga el navegador en esa visita, promediado en todas las páginas de la suite (y en locales donde el reporte las agrupa). Las páginas pesadas son páginas lentas.
+
+- **Fuga de otros idiomas**: Es el contenido de la misma página pero en otro idioma que se cargaría por error en la página auditada. Este contenido es innecesario y debe evitarse. (p. ej., contenido de la página `/fr/about` en el bundle de la página `/en/about`)
+
+- **Fuga de otras rutas**: La misma idea para **otras pantallas** en la aplicación: si su contenido se lleva cuando solo abriste una página. (p. ej., contenido de la página `/en/about` en el bundle de la página `/en/contact`). Una puntuación alta sugiere splitting débil o bundles demasiado amplios.
+
+- **Tamaño promedio del bundle de componentes**: Las piezas comunes de la interfaz de usuario se miden **una a la vez** en lugar de ocultarse dentro de un número de aplicación gigante. Muestra si la internacionalización infla silenciosamente los componentes cotidianos. Por ejemplo, si tu componente se reenderiza, cargará todos esos datos de la memoria. Adjuntar un JSON gigante a cualquier componente es como conectar un almacén grande de datos no utilizados que ralentizará el rendimiento de tus componentes.
+
+- **Capacidad de respuesta del cambio de idioma**: Cambio el idioma usando el control de la aplicación y mido cuánto tarda hasta que la página se haya cambiado claramente, lo que un visitante notaría, no un micro-paso de laboratorio.
+
+- **Trabajo de renderizado después de un cambio de idioma**: Un seguimiento más estrecho: cuánto esfuerzo tomó la interfaz para repintarse en el nuevo idioma una vez que el cambio está en vuelo. Útil cuando el tiempo "sentido" y el costo del framework divergen.
+
+- **Tiempo de carga inicial de la página**: Desde la navegación hasta que el navegador considere la página completamente cargada para los escenarios que probé. Bueno para comparar arranques en frío.
+
+- **Tiempo de hidratación**: Cuando la aplicación la expone, cuánto tiempo gasta el cliente convirtiendo HTML del servidor en algo que puedas hacer clic. Un guión en las tablas significa que esa implementación no proporcionó una cifra de hidratación confiable en este benchmark.
+
 ## Estrellas de GitHub
 
 Las estrellas de GitHub son un fuerte indicador de la popularidad de un proyecto, la confianza de la comunidad y la relevancia a largo plazo. Si bien no son una medida directa de la calidad técnica, reflejan cuántos desarrolladores encuentran útil el proyecto, siguen su progreso y es probable que lo adopten. Para estimar el valor de un proyecto, las estrellas ayudan a comparar la tracción entre alternativas y brindan información sobre el crecimiento del ecosistema.

package/docs/es/benchmark/tanstack.md

@@ -124,6 +124,28 @@ Comparamos **cuatro estrategias de carga**:
 - **Scoped static**: Mantiene el código organizado (separación lógica) sin peticiones de red adicionales complejas.
 - **Scoped dynamic**: El mejor enfoque para el _code splitting_ y el rendimiento. Minimiza el uso de memoria cargando solo lo que la vista actual y el idioma activo necesitan.
 
+### Qué medí:
+
+Ejecuté la misma aplicación multilingüe en un navegador real para cada stack, luego anoté lo que realmente aparecía en la red y cuánto tiempo tardaba. Los tamaños se informan **después de la compresión web normal**, porque es más cercano a lo que las personas descargan que los recuentos de fuentes sin procesar.
+
+- **Tamaño de la biblioteca de internacionalización**: Después de agrupar, agitar árboles y minificar, el tamaño de la biblioteca i18n es el tamaño de los proveedores (p. ej. `NextIntlClientProvider`) + código de hooks (p. ej. `useTranslations`) en un componente vacío. No incluye la carga de archivos de traducción. Responde cuán costosa es la biblioteca antes de que tu contenido entre en juego.
+
+- **JavaScript por página**: Para cada ruta de punto de referencia, cuánto script descarga el navegador en esa visita, promediado en las páginas del conjunto (y en locales donde el informe los agrupa). Las páginas pesadas son páginas lentas.
+
+- **Fuga de otros idiomas**: Es el contenido de la misma página pero en otro idioma que se cargaría por error en la página auditada. Este contenido es innecesario y debe evitarse. (p. ej. contenido de página `/fr/about` en paquete de página `/en/about`)
+
+- **Fuga de otras rutas**: La misma idea para **otras pantallas** en la aplicación: si su contenido viene junto cuando solo abriste una página. (p. ej. contenido de página `/en/about` en paquete de página `/en/contact`). Una puntuación alta sugiere un divisor débil o paquetes demasiado amplios.
+
+- **Tamaño promedio del paquete de componentes**: Las piezas comunes de la interfaz se miden **una a la vez** en lugar de ocultarse dentro de un número de aplicación gigante. Muestra si la internacionalización infla silenciosamente los componentes cotidianos. Por ejemplo, si tu componente se redibuja, cargará todos esos datos de la memoria. Adjuntar un JSON gigante a cualquier componente es como conectar un gran almacén de datos no utilizados que ralentizará el rendimiento de tus componentes.
+
+- **Capacidad de respuesta del cambio de idioma**: Cambio el idioma usando el control de la aplicación y mido cuánto tiempo tarda hasta que la página se haya cambiado claramente, lo que un visitante notaría, no un micro-paso de laboratorio.
+
+- **Trabajo de renderizado después de un cambio de idioma**: Un seguimiento más estrecho: cuánto esfuerzo tomó la interfaz para repintarse para el nuevo idioma una vez que el cambio está en vuelo. Útil cuando el tiempo "percibido" y el costo del framework divergen.
+
+- **Tiempo de carga inicial de la página**: Desde la navegación hasta que el navegador considera la página completamente cargada para los escenarios que probé. Bueno para comparar inicios en frío.
+
+- **Tiempo de hidratación**: Cuando la aplicación lo expone, cuánto tiempo pasa el cliente convirtiendo HTML del servidor en algo en lo que realmente puedas hacer clic. Un guión en las tablas significa que esa implementación no proporcionó una cifra de hidratación confiable en este punto de referencia.
+
 ## Estrellas de GitHub
 
 Las estrellas de GitHub son un fuerte indicador de la popularidad de un proyecto, la confianza de la comunidad y la relevancia a largo plazo. Si bien no son una medida directa de la calidad técnica, reflejan cuántos desarrolladores encuentran útil el proyecto, siguen su progreso y es probable que lo adopten. Para estimar el valor de un proyecto, las estrellas ayudan a comparar la tracción entre alternativas y brindan información sobre el crecimiento del ecosistema.

package/docs/es/cli/ci.md

@@ -140,6 +140,28 @@ steps:
     run: npx intlayer ci fill
 ```
 
+## Acciones de GitHub generadas automáticamente
+
+Cuando ejecutas `intlayer init`, Intlayer detecta tu gestor de paquetes (npm, yarn, pnpm, o bun) y genera automáticamente dos flujos de trabajo de GitHub Actions en `.github/workflows/`, con comandos que coinciden con ese gestor de paquetes:
+
+- **`intlayer-fill.yml`** — En cada pull request, construye los diccionarios y ejecuta `intlayer fill --git-diff --mode complete` para generar traducciones faltantes en los diccionarios modificados, luego confirma el resultado en la rama del PR.
+- **`intlayer-test.yml`** — En cada pull request, construye los diccionarios y ejecuta `intlayer test`, fallando la verificación cuando faltan traducciones en las locales requeridas.
+
+Los archivos de flujo de trabajo existentes nunca se sobrescriben. Para omitir la generación automática por completo, ejecuta:
+
+```bash
+npx intlayer init --no-github-actions
+```
+
+### Proporcionar acceso a IA al flujo de trabajo de relleno
+
+El `intlayer-fill.yml` generado requiere acceso a IA. Hay dos opciones disponibles (configuradas en el bloque `env` del flujo de trabajo):
+
+1. **Tu propia clave de proveedor de IA** — Agrega un secreto `AI_API_KEY` en la configuración de tu repositorio (Settings → Secrets and variables → Actions). El flujo de trabajo la reenvía a través de `--provider`, `--model` y `--api-key`.
+2. **Claves de acceso a Intlayer CMS** — Agrega los secretos `INTLAYER_CLIENT_ID` e `INTLAYER_CLIENT_SECRET` e intégralos en la sección `editor` de tu `intlayer.config`. Las claves de acceso a CMS otorgan acceso a IA a través del backend de Intlayer.
+
+El flujo de trabajo `intlayer-test.yml` no requiere acceso a IA.
+
 ## Manejo de errores
 
 - Si `INTLAYER_PROJECT_CREDENTIALS` no está establecida, el comando saldrá con un error.

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.