@intlayer/docs 9.4.4 → 9.5.0

package/docs/es/migration_from_i18next_to_intlayer.md

@@ -32,7 +32,6 @@ author: aymericzip
 En lugar de cargar archivos JSON masivos en tus páginas, carga solo el contenido necesario. Intlayer ayuda a **reducir el tamaño de tu bundle y tus páginas hasta en un 50 %**.
 
 </Accordion>
-
 <Accordion header="Mantenibilidad">
 
 Establecer un alcance al contenido de tu aplicación **facilita el mantenimiento** para aplicaciones a gran escala. Puedes duplicar o eliminar una carpeta de función completa sin la carga mental de revisar todo el código de tu contenido. Además, Intlayer está **completamente tipado** para asegurar la precisión de tu contenido.
@@ -40,25 +39,21 @@ Establecer un alcance al contenido de tu aplicación **facilita el mantenimiento
 Intlayer es también la solución con el **desarrollo más activo** en el ecosistema i18n — los problemas se solucionan rápidamente, nuevos adaptadores de framework se añaden regularmente y la API principal se refina continuamente basándose en retroalimentación real de producción.
 
 </Accordion>
-
 <Accordion header="Agente de IA">
 
 Colocalizar el contenido **reduce el contexto necesario** para los Grandes Modelos de Lenguaje (LLM). Intlayer también incluye una suite de herramientas, como un **CLI** para probar traducciones faltantes, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/mcp_server.md)** y **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/agent_skills.md)**, para que la experiencia del desarrollador (DX) sea aún más fluida para los agentes de IA.
 
 </Accordion>
-
 <Accordion header="Automatización">
 
 Usa la automatización para traducir en tu flujo de CI/CD utilizando el LLM de tu elección al costo de tu proveedor de IA. Intlayer también ofrece un **compilador** para automatizar la extracción de contenido, así como una [plataforma web](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_CMS.md) para ayudar a **traducir en segundo plano**.
 
 </Accordion>
-
 <Accordion header="Rendimiento">
 
 Conectar archivos JSON masivos a los componentes puede llevar a problemas de rendimiento y reactividad. Intlayer optimiza la carga de tu contenido en tiempo de compilación.
 
 </Accordion>
-
 <Accordion header="Escalabilidad con no-desarrolladores">
 
 Más que una simple solución de i18n, Intlayer proporciona un **[editor visual](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md)** autohospedado y un **[CMS completo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_CMS.md)** para ayudarte a gestionar tu contenido multilingüe en **tiempo real**, haciendo la colaboración con traductores, redactores y otros miembros del equipo fluida. El contenido se puede almacenar local y/o remotamente.
@@ -66,8 +61,6 @@ Más que una simple solución de i18n, Intlayer proporciona un **[editor visual]
 </Accordion>
 </AccordionGroup>
 
----
-
 ## Estrategias de migración
 
 Existen dos estrategias complementarias para migrar de `i18next` a Intlayer:
@@ -78,20 +71,15 @@ Existen dos estrategias complementarias para migrar de `i18next` a Intlayer:
 
 Esta guía cubre primero la **Estrategia 1** (adaptador de compatibilidad de fácil uso), y luego revisa la migración completa opcional.
 
----
-
 ## Tabla de Contenidos
 
 <TOC/>
 
----
-
 ## Migración rápida
 
 Los siguientes pasos son el mínimo requerido para que tu aplicación `i18next` existente funcione sobre Intlayer sin cambios en el código.
 
 <Steps>
-
 <Step number={1} title="Instalar Dependencias">
 
 Instala los paquetes principales de Intlayer y el adaptador de compatibilidad:
@@ -135,7 +123,6 @@ bun add intlayer @intlayer/i18next @intlayer/sync-json-plugin
 > Puedes mantener `i18next` instalado — el adaptador de compatibilidad lo usa como `devDependency` / `peerDependency` para los tipos de TypeScript.
 
 </Step>
-
 <Step number={2} title="Configurar Intlayer">
 
 El comando `intlayer init` crea un archivo inicial `intlayer.config.ts`. Actualízalo para que coincida con tus idiomas (locales) existentes y apunta el plugin `syncJSON` a tus archivos de mensajes:
@@ -170,7 +157,6 @@ export default config;
 > **`source`** asigna un idioma a su ruta de archivo JSON. **`location`** le indica al observador de Intlayer qué carpeta monitorear en busca de cambios. La opción `format: 'i18next'` asegura que los marcadores de posición como `{{name}}` se analicen correctamente.
 
 </Step>
-
 <Step number={3} title="Actualizar los alias del Bundler (Opcional)">
 
 Si estás usando un empaquetador (Vite, Webpack, esbuild), puedes inyectar un alias de módulo para que `import ... from 'i18next'` se resuelva automáticamente a `@intlayer/i18next`. Esto elimina la necesidad de cambiar manualmente cualquier importación en tu base de código.
@@ -194,14 +180,11 @@ export default defineConfig({
 
 Eso es todo para la migración rápida. Tu aplicación ahora funciona sobre Intlayer mientras mantiene intactas todas las importaciones y APIs de `i18next`.
 
----
-
 ## Migración completa
 
 Los pasos a continuación son opcionales y pueden hacerse incrementalmente. Desbloquean todas las funcionalidades de Intlayer: editor visual, CMS, archivos de contenido tipados, automatización de traducción con IA y más.
 
 <Steps>
-
 <Step number={4} title="Renombrar importaciones explícitamente (opcional)" isOptional={true}>
 
 Si prefieres hacer la dependencia explícita en tus archivos fuente, o si no usas un plugin de bundler para alias de importación, puedes renombrar las importaciones manualmente:
@@ -215,7 +198,6 @@ Si prefieres hacer la dependencia explícita en tus archivos fuente, o si no usa
 Estos son **reemplazos directos** — no se requieren cambios en las firmas de llamada, argumentos o tipos de retorno.
 
 </Step>
-
 <Step number={5} title="Activar la Automatización de Traducción con IA" isOptional={true}>
 
 Una vez que Intlayer esté configurado, utiliza su CLI para llenar automáticamente las traducciones faltantes:
@@ -277,8 +259,6 @@ export default config;
 
 </Steps>
 
----
-
 ## Qué puedes eliminar tras la migración
 
 Una vez que el adaptador de compatibilidad esté en su lugar, el siguiente código repetitivo de `i18next` se puede eliminar:
@@ -291,8 +271,6 @@ Una vez que el adaptador de compatibilidad esté en su lugar, el siguiente códi
 
 Cuando estés listo para ir más allá, Intlayer **descubre automáticamente todos los archivos `.content.ts` y `.content.json` en cualquier lugar de tu código base** (por defecto, en cualquier lugar dentro de `./src`). Puedes colocar un archivo `my-component.content.ts` directamente junto a tu lógica y Intlayer lo tomará al momento de compilación sin configuración adicional — sin importaciones, sin registro, sin necesidad de un archivo índice centralizado. Esto hace que la co-localización de traducciones sea completamente fluida.
 
----
-
 ## Configurar TypeScript
 
 Intlayer usa el aumento de módulos para ofrecer autocompletado completo de TypeScript para tus claves de traducción. Asegúrate de que tu `tsconfig.json` incluya los tipos generados automáticamente:
@@ -307,8 +285,6 @@ Intlayer usa el aumento de módulos para ofrecer autocompletado completo de Type
 }
 ```
 
----
-
 ## Configuración de Git
 
 Añade el directorio generado por Intlayer a tu `.gitignore`:
@@ -318,8 +294,6 @@ Añade el directorio generado por Intlayer a tu `.gitignore`:
 .intlayer
 ```
 
----
-
 ## Profundizar Más
 
 - **Editor Visual** — Gestiona las traducciones visualmente en tu navegador: [Editor Visual de Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md)

package/docs/es/migration_from_next-i18next_to_intlayer.md

@@ -35,7 +35,6 @@ author: aymericzip
 En lugar de cargar archivos JSON masivos en tus páginas, carga solo el contenido necesario. Intlayer ayuda a **reducir el tamaño de tu bundle y tus páginas hasta en un 50 %**.
 
 </Accordion>
-
 <Accordion header="Mantenibilidad">
 
 Establecer un alcance al contenido de tu aplicación **facilita el mantenimiento** para aplicaciones a gran escala. Puedes duplicar o eliminar una carpeta de función completa sin la carga mental de revisar todo el código de tu contenido. Además, Intlayer está **completamente tipado** para asegurar la precisión de tu contenido.
@@ -43,25 +42,21 @@ Establecer un alcance al contenido de tu aplicación **facilita el mantenimiento
 Intlayer es también la solución con el **desarrollo más activo** en el ecosistema i18n — los problemas se solucionan rápidamente, nuevos adaptadores de framework se añaden regularmente y la API principal se refina continuamente basándose en retroalimentación real de producción.
 
 </Accordion>
-
 <Accordion header="Agente de IA">
 
 Colocalizar el contenido **reduce el contexto necesario** para los Grandes Modelos de Lenguaje (LLM). Intlayer también incluye una suite de herramientas, como un **CLI** para probar traducciones faltantes, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/mcp_server.md)** y **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/agent_skills.md)**, para que la experiencia del desarrollador (DX) sea aún más fluida para los agentes de IA.
 
 </Accordion>
-
 <Accordion header="Automatización">
 
 Usa la automatización para traducir en tu flujo de CI/CD utilizando el LLM de tu elección al costo de tu proveedor de IA. Intlayer también ofrece un **compilador** para automatizar la extracción de contenido, así como una [plataforma web](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_CMS.md) para ayudar a **traducir en segundo plano**.
 
 </Accordion>
-
 <Accordion header="Rendimiento">
 
 Conectar archivos JSON masivos a los componentes puede llevar a problemas de rendimiento y reactividad. Intlayer optimiza la carga de tu contenido en tiempo de compilación.
 
 </Accordion>
-
 <Accordion header="Escalabilidad con no-desarrolladores">
 
 Más que una simple solución de i18n, Intlayer proporciona un **[editor visual](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md)** autohospedado y un **[CMS completo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_CMS.md)** para ayudarte a gestionar tu contenido multilingüe en **tiempo real**, haciendo la colaboración con traductores, redactores y otros miembros del equipo fluida. El contenido se puede almacenar local y/o remotamente.
@@ -69,8 +64,6 @@ Más que una simple solución de i18n, Intlayer proporciona un **[editor visual]
 </Accordion>
 </AccordionGroup>
 
----
-
 ## Estrategias de migración
 
 Dado que `next-i18next` envuelve a `react-i18next` e `i18next` internamente, existen dos estrategias complementarias para migrar hacia Intlayer:
@@ -81,20 +74,15 @@ Dado que `next-i18next` envuelve a `react-i18next` e `i18next` internamente, exi
 
 Esta guía cubre primero la **Estrategia 1** (adaptador de compatibilidad de fácil uso), y luego revisa la migración completa opcional.
 
----
-
 ## Tabla de Contenidos
 
 <TOC/>
 
----
-
 ## Migración rápida
 
 Los siguientes pasos son el mínimo requerido para que tu aplicación Next.js Pages Router existente funcione sobre Intlayer con cero cambios de código en tus páginas y componentes.
 
 <Steps>
-
 <Step number={1} title="Instalar Dependencias">
 
 Instala los paquetes principales de Intlayer y los adaptadores de compatibilidad:
@@ -138,7 +126,6 @@ bun add intlayer next-intlayer react-intlayer @intlayer/next-i18next @intlayer/r
 > Puedes mantener de manera segura `next-i18next`, `react-i18next`, e `i18next` instalados durante la migración, aunque los eliminarás una vez configurados los alias.
 
 </Step>
-
 <Step number={2} title="Configurar Intlayer">
 
 El comando `intlayer init` crea un archivo inicial `intlayer.config.ts`. Actualízalo para que coincida con tus idiomas existentes y apunta el plugin `syncJSON` a tus archivos de mensajes de `next-i18next` (usualmente en `public/locales`):
@@ -173,7 +160,6 @@ export default config;
 > **`source`** asigna un idioma y un espacio de nombres (`key`) a la ruta de su archivo JSON. **`location`** le indica al observador de Intlayer qué carpeta monitorear. La opción `format: 'i18next'` asegura que los marcadores de posición se analicen correctamente para `next-i18next`.
 
 </Step>
-
 <Step number={3} title="Actualizar la Configuración de Next.js">
 
 Envuelve tu archivo existente `next.config.ts` (o `.js`) con `createNextI18nPlugin` de `@intlayer/next-i18next/plugin`. Este envoltorio compone `withIntlayer` **e** inyecta los alias `next-i18next` / `react-i18next` / `i18next` → `@intlayer/*`, de modo que tus llamadas a `import { useTranslation } from 'next-i18next'` se redirijan transparentemente en tiempo de compilación. No se necesitan cambios en los archivos fuente.
@@ -217,14 +203,11 @@ Eso es todo para la migración rápida. Tu aplicación Next.js ahora funciona so
 > tAbout("counter.label"); // ✓ tipado
 > ```
 
----
-
 ## Migración completa
 
 Los pasos a continuación son opcionales y pueden hacerse incrementalmente. Desbloquean todas las funcionalidades de Intlayer: editor visual, CMS, archivos de contenido tipados, automatización de traducción con IA y más.
 
 <Steps>
-
 <Step number={4} title="Renombrar importaciones explícitamente (opcional)" isOptional={true}>
 
 El plugin de Intlayer ya maneja los alias a nivel del empaquetador. Si prefieres hacer la dependencia explícita en tus archivos fuente, puedes renombrar las importaciones manualmente:
@@ -239,7 +222,6 @@ El plugin de Intlayer ya maneja los alias a nivel del empaquetador. Si prefieres
 Estos son **reemplazos directos** — no se requieren cambios en las firmas de llamada, argumentos o tipos de retorno.
 
 </Step>
-
 <Step number={5} title="Activar la Automatización de Traducción con IA" isOptional={true}>
 
 Una vez que Intlayer esté configurado, utiliza su CLI para llenar automáticamente las traducciones faltantes:
@@ -301,8 +283,6 @@ export default config;
 
 </Steps>
 
----
-
 ## Qué puedes eliminar tras la migración
 
 Una vez que el adaptador de compatibilidad esté en su lugar, el siguiente código repetitivo de `next-i18next` se puede eliminar:
@@ -315,8 +295,6 @@ Una vez que el adaptador de compatibilidad esté en su lugar, el siguiente códi
 
 Cuando estés listo para ir más allá, Intlayer **descubre automáticamente todos los archivos `.content.ts` y `.content.json` en cualquier lugar de tu código base** (por defecto, en cualquier lugar dentro de `./src`). Puedes colocar un archivo `my-component.content.ts` directamente junto a tu `MyComponent.tsx` y Intlayer lo tomará al momento de compilación sin configuración adicional — sin importaciones, sin registro, sin necesidad de un archivo índice centralizado. Esto hace que la co-localización de traducciones sea completamente fluida con las páginas y componentes.
 
----
-
 ## Configurar TypeScript
 
 Intlayer usa el aumento de módulos para ofrecer autocompletado completo de TypeScript para tus claves de traducción. Asegúrate de que tu `tsconfig.json` incluya los tipos generados automáticamente:
@@ -331,8 +309,6 @@ Intlayer usa el aumento de módulos para ofrecer autocompletado completo de Type
 }
 ```
 
----
-
 ## Configuración de Git
 
 Añade el directorio generado por Intlayer a tu `.gitignore`:
@@ -342,8 +318,6 @@ Añade el directorio generado por Intlayer a tu `.gitignore`:
 .intlayer
 ```
 
----
-
 ## Profundizar Más
 
 - **Editor Visual** — Gestiona las traducciones visualmente en tu navegador: [Editor Visual de Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md)

package/docs/es/migration_from_next-intl_to_intlayer.md

@@ -33,7 +33,6 @@ author: aymericzip
 En lugar de cargar archivos JSON masivos en tus páginas, carga solo el contenido necesario. Intlayer ayuda a **reducir el tamaño de tu bundle y tus páginas hasta en un 50 %**.
 
 </Accordion>
-
 <Accordion header="Mantenibilidad">
 
 Establecer un alcance al contenido de tu aplicación **facilita el mantenimiento** para aplicaciones a gran escala. Puedes duplicar o eliminar una carpeta de función completa sin la carga mental de revisar todo el código de tu contenido. Además, Intlayer está **completamente tipado** para asegurar la precisión de tu contenido.
@@ -41,25 +40,21 @@ Establecer un alcance al contenido de tu aplicación **facilita el mantenimiento
 Intlayer es también la solución con el **desarrollo más activo** en el ecosistema i18n — los problemas se solucionan rápidamente, nuevos adaptadores de framework se añaden regularmente y la API principal se refina continuamente basándose en retroalimentación real de producción.
 
 </Accordion>
-
 <Accordion header="Agente de IA">
 
 Colocalizar el contenido **reduce el contexto necesario** para los Grandes Modelos de Lenguaje (LLM). Intlayer también incluye una suite de herramientas, como un **CLI** para probar traducciones faltantes, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/mcp_server.md)** y **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/agent_skills.md)**, para que la experiencia del desarrollador (DX) sea aún más fluida para los agentes de IA.
 
 </Accordion>
-
 <Accordion header="Automatización">
 
 Usa la automatización para traducir en tu flujo de CI/CD utilizando el LLM de tu elección al costo de tu proveedor de IA. Intlayer también ofrece un **compilador** para automatizar la extracción de contenido, así como una [plataforma web](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_CMS.md) para ayudar a **traducir en segundo plano**.
 
 </Accordion>
-
 <Accordion header="Rendimiento">
 
 Conectar archivos JSON masivos a los componentes puede llevar a problemas de rendimiento y reactividad. Intlayer optimiza la carga de tu contenido en tiempo de compilación.
 
 </Accordion>
-
 <Accordion header="Escalabilidad con no-desarrolladores">
 
 Más que una simple solución de i18n, Intlayer proporciona un **[editor visual](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md)** autohospedado y un **[CMS completo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_CMS.md)** para ayudarte a gestionar tu contenido multilingüe en **tiempo real**, haciendo la colaboración con traductores, redactores y otros miembros del equipo fluida. El contenido se puede almacenar local y/o remotamente.
@@ -67,8 +62,6 @@ Más que una simple solución de i18n, Intlayer proporciona un **[editor visual]
 </Accordion>
 </AccordionGroup>
 
----
-
 ## Estrategia de migración
 
 El enfoque recomendado para las aplicaciones existentes es el **adaptador de compatibilidad**: instala `@intlayer/next-intl`, que expone **exactamente la misma API** que `next-intl` pero delega todo el trabajo de traducción a Intlayer.
@@ -77,20 +70,15 @@ Mantienes tus `useTranslations`, `getTranslations`, `NextIntlClientProvider` exi
 
 Con el tiempo puedes, opcionalmente, migrar archivos individuales al formato `.content.ts` más rico de Intlayer para desbloquear el editor visual, el CMS y el alcance de contenido por componente — pero este paso es enteramente opcional y puede realizarse de forma gradual.
 
----
-
 ## Tabla de Contenidos
 
 <TOC/>
 
----
-
 ## Migración rápida
 
 Los siguientes pasos son el mínimo requerido para que tu aplicación `next-intl` existente funcione sobre Intlayer con cero cambios en el código.
 
 <Steps>
-
 <Step number={1} title="Instalar Dependencias">
 
 Instala los paquetes principales de Intlayer y el adaptador de compatibilidad `@intlayer/next-intl`:
@@ -134,7 +122,6 @@ bun add intlayer next-intlayer @intlayer/next-intl @intlayer/sync-json-plugin
 > Conserva instalado `next-intl` — sigue siendo necesario para el **enrutamiento URL** (`createNavigation`, `createMiddleware`, `Link`, `redirect`, `usePathname`, `useRouter`). El adaptador de compatibilidad **no** reemplaza la capa de enrutamiento.
 
 </Step>
-
 <Step number={2} title="Configurar Intlayer">
 
 El comando `intlayer init` crea un archivo inicial `intlayer.config.ts`. Actualízalo para que coincida con tus idiomas existentes y apunta el plugin `syncJSON` a tus archivos de mensajes:
@@ -171,7 +158,6 @@ export default config;
 > Para obtener una lista completa de opciones de configuración, consulta la [documentación de configuración](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/configuration.md).
 
 </Step>
-
 <Step number={3} title="Añadir el Plugin de Intlayer a Next.js">
 
 Envuelve tu configuración existente de Next.js con `createNextIntlPlugin` desde `@intlayer/next-intl/plugin`. Este envoltorio compone `withIntlayer` **e** inyecta los alias `next-intl` → `@intlayer/next-intl` por ti:
@@ -212,14 +198,11 @@ Eso es todo para la migración rápida. Tu aplicación ahora funciona sobre Intl
 > t("counter.label"); // ✓ tipado
 > ```
 
----
-
 ## Migración completa
 
 Los pasos a continuación son opcionales y pueden hacerse incrementalmente. Desbloquean todas las funcionalidades de Intlayer: editor visual, CMS, archivos de contenido tipados, automatización de traducción con IA y más.
 
 <Steps>
-
 <Step number={4} title="Renombrar importaciones explícitamente (opcional)" isOptional={true}>
 
 El contenedor `createNextIntlPlugin()` ya maneja el alias de `next-intl` → `@intlayer/next-intl` a nivel del empaquetador. Si prefieres hacer la dependencia explícita en tus archivos de origen (y usar el plugin `withIntlayer` regular en su lugar), puedes renombrar las importaciones manualmente:
@@ -246,7 +229,6 @@ El contenedor `createNextIntlPlugin()` ya maneja el alias de `next-intl` → `@i
 > De manera alternativa, puedes usar `defineRouting` de `@intlayer/next-intl/routing` que combina la configuración de idiomas de tu `intlayer.config.ts` automáticamente.
 
 </Step>
-
 <Step number={5} title="Activar la Automatización de Traducción con IA" isOptional={true}>
 
 Una vez que Intlayer esté configurado, puedes usar su CLI para llenar automáticamente las traducciones faltantes utilizando el LLM de tu elección:
@@ -308,8 +290,6 @@ export default config;
 
 </Steps>
 
----
-
 ## Qué puedes eliminar tras la migración
 
 Una vez que `@intlayer/next-intl` esté en su lugar, el siguiente código repetitivo de `next-intl` se puede eliminar:
@@ -322,8 +302,6 @@ Una vez que `@intlayer/next-intl` esté en su lugar, el siguiente código repeti
 
 Cuando estés listo para ir más allá, Intlayer **descubre automáticamente todos los archivos `.content.ts` y `.content.json` en cualquier lugar de tu código base** (por defecto, en cualquier lugar dentro de `./src`). Puedes colocar un archivo `about.content.ts` directamente junto a tu `about/page.tsx` e Intlayer lo tomará al momento de compilación sin configuración adicional — sin importaciones, sin registro, sin necesidad de un archivo índice centralizado. Esto hace que la co-localización de traducciones sea completamente fluida con las páginas y componentes.
 
----
-
 ## Configurar TypeScript
 
 Intlayer usa el aumento de módulos para ofrecer autocompletado completo de TypeScript para tus claves de traducción. Asegúrate de que tu `tsconfig.json` incluya los tipos generados automáticamente:
@@ -338,8 +316,6 @@ Intlayer usa el aumento de módulos para ofrecer autocompletado completo de Type
 }
 ```
 
----
-
 ## Configuración de Git
 
 Añade el directorio generado por Intlayer a tu `.gitignore`:
@@ -349,8 +325,6 @@ Añade el directorio generado por Intlayer a tu `.gitignore`:
 .intlayer
 ```
 
----
-
 ## Profundizar Más
 
 - **Editor Visual** — Gestiona las traducciones visualmente en tu navegador: [Editor Visual de Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md)

package/docs/es/migration_from_nuxtjs_i18n_to_intlayer.md

@@ -34,7 +34,6 @@ author: aymericzip
 En lugar de cargar archivos JSON masivos en tus páginas, carga solo el contenido necesario. Intlayer ayuda a **reducir el tamaño de tu bundle y tus páginas hasta en un 50 %**.
 
 </Accordion>
-
 <Accordion header="Mantenibilidad">
 
 Establecer un alcance al contenido de tu aplicación **facilita el mantenimiento** para aplicaciones a gran escala. Puedes duplicar o eliminar una carpeta de función completa sin la carga mental de revisar todo el código de tu contenido. Además, Intlayer está **completamente tipado** para asegurar la precisión de tu contenido.
@@ -42,25 +41,21 @@ Establecer un alcance al contenido de tu aplicación **facilita el mantenimiento
 Intlayer es también la solución con el **desarrollo más activo** en el ecosistema i18n — los problemas se solucionan rápidamente, nuevos adaptadores de framework se añaden regularmente y la API principal se refina continuamente basándose en retroalimentación real de producción.
 
 </Accordion>
-
 <Accordion header="Agente de IA">
 
 Colocalizar el contenido **reduce el contexto necesario** para los Grandes Modelos de Lenguaje (LLM). Intlayer también incluye una suite de herramientas, como un **CLI** para probar traducciones faltantes, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/mcp_server.md)** y **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/agent_skills.md)**, para que la experiencia del desarrollador (DX) sea aún más fluida para los agentes de IA.
 
 </Accordion>
-
 <Accordion header="Automatización">
 
 Usa la automatización para traducir en tu flujo de CI/CD utilizando el LLM de tu elección al costo de tu proveedor de IA. Intlayer también ofrece un **compilador** para automatizar la extracción de contenido, así como una [plataforma web](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_CMS.md) para ayudar a **traducir en segundo plano**.
 
 </Accordion>
-
 <Accordion header="Rendimiento">
 
 Conectar archivos JSON masivos a los componentes puede llevar a problemas de rendimiento y reactividad. Intlayer optimiza la carga de tu contenido en tiempo de compilación.
 
 </Accordion>
-
 <Accordion header="Escalabilidad con no-desarrolladores">
 
 Más que una simple solución de i18n, Intlayer proporciona un **[editor visual](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md)** autohospedado y un **[CMS completo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_CMS.md)** para ayudarte a gestionar tu contenido multilingüe en **tiempo real**, haciendo la colaboración con traductores, redactores y otros miembros del equipo fluida. El contenido se puede almacenar local y/o remotamente.
@@ -68,8 +63,6 @@ Más que una simple solución de i18n, Intlayer proporciona un **[editor visual]
 </Accordion>
 </AccordionGroup>
 
----
-
 ## Estrategias de migración
 
 Dado que `@nuxtjs/i18n` está impulsado internamente por `vue-i18n`, existen dos estrategias complementarias para migrar hacia Intlayer:
@@ -80,20 +73,15 @@ Dado que `@nuxtjs/i18n` está impulsado internamente por `vue-i18n`, existen dos
 
 Esta guía cubre primero la **Estrategia 1** (adaptador de compatibilidad de fácil uso), y luego revisa la migración completa opcional.
 
----
-
 ## Tabla de Contenidos
 
 <TOC/>
 
----
-
 ## Migración rápida
 
 Los siguientes pasos son el mínimo requerido para que tu aplicación Nuxt existente funcione sobre Intlayer con cero cambios en el código de tus componentes.
 
 <Steps>
-
 <Step number={1} title="Instalar Dependencias">
 
 Instala los paquetes principales de Intlayer y el adaptador de compatibilidad:
@@ -137,7 +125,6 @@ bun add intlayer vue-intlayer nuxt-intlayer @intlayer/vue-i18n @intlayer/sync-js
 > Puedes mantener de forma segura `@nuxtjs/i18n` instalado durante la migración, aunque en breve lo eliminarás de tu configuración de Nuxt.
 
 </Step>
-
 <Step number={2} title="Configurar Intlayer">
 
 El comando `intlayer init` crea un archivo inicial `intlayer.config.ts`. Actualízalo para que coincida con tus idiomas existentes y apunta el plugin `syncJSON` a tus archivos de mensajes:
@@ -172,7 +159,6 @@ export default config;
 > **`source`** asigna un idioma a su ruta de archivo JSON. **`location`** le indica al observador de Intlayer qué carpeta monitorear en busca de cambios. La opción `format: 'icu'` asegura que los marcadores de posición se analicen correctamente para `vue-i18n`.
 
 </Step>
-
 <Step number={3} title="Actualizar la Configuración de Nuxt">
 
 Reemplaza el módulo `@nuxtjs/i18n` por `nuxt-intlayer` en tu `nuxt.config.ts`. El plugin de Intlayer inyecta automáticamente los alias de módulo, lo que significa que tus llamadas a `import { useI18n } from 'vue-i18n'` se redirigen transparentemente a `@intlayer/vue-i18n`.
@@ -192,14 +178,11 @@ export default defineNuxtConfig({
 
 Eso es todo para la migración rápida. Tu aplicación Nuxt ahora funciona sobre Intlayer mientras mantiene intactas todas las llamadas a `$t` y `useI18n()`.
 
----
-
 ## Migración completa
 
 Los pasos a continuación son opcionales y pueden hacerse incrementalmente. Desbloquean todas las funcionalidades de Intlayer: editor visual, CMS, archivos de contenido tipados, automatización de traducción con IA y más.
 
 <Steps>
-
 <Step number={4} title="Renombrar importaciones explícitamente (opcional)" isOptional={true}>
 
 Los plugins de Intlayer ya manejan los alias a nivel del empaquetador. Si prefieres hacer la dependencia explícita en tus archivos de origen, puedes renombrar las importaciones manualmente:
@@ -211,7 +194,6 @@ Los plugins de Intlayer ya manejan los alias a nivel del empaquetador. Si prefie
 Estos son **reemplazos directos** — no se requieren cambios en las firmas de llamada, argumentos o tipos de retorno.
 
 </Step>
-
 <Step number={5} title="Activar la Automatización de Traducción con IA" isOptional={true}>
 
 Una vez que Intlayer esté configurado, utiliza su CLI para llenar automáticamente las traducciones faltantes:
@@ -273,8 +255,6 @@ export default config;
 
 </Steps>
 
----
-
 ## Qué puedes eliminar tras la migración
 
 Una vez que el adaptador de compatibilidad esté en su lugar, el siguiente código repetitivo se puede eliminar:
@@ -287,8 +267,6 @@ Una vez que el adaptador de compatibilidad esté en su lugar, el siguiente códi
 
 Cuando estés listo para ir más allá, Intlayer **descubre automáticamente todos los archivos `.content.ts` y `.content.json` en cualquier lugar de tu código base** (por defecto, en cualquier lugar dentro de `./src`). Puedes colocar un archivo `my-component.content.ts` directamente junto a tu `MyComponent.vue` e Intlayer lo tomará al momento de compilación sin configuración adicional — sin importaciones, sin registro, sin necesidad de un archivo índice centralizado. Esto hace que la co-localización de traducciones con páginas y componentes sea completamente fluida.
 
----
-
 ## Configurar TypeScript
 
 Intlayer usa el aumento de módulos para ofrecer autocompletado completo de TypeScript para tus claves de traducción. Asegúrate de que tu `tsconfig.json` incluya los tipos generados automáticamente:
@@ -303,8 +281,6 @@ Intlayer usa el aumento de módulos para ofrecer autocompletado completo de Type
 }
 ```
 
----
-
 ## Configuración de Git
 
 Añade el directorio generado por Intlayer a tu `.gitignore`:
@@ -314,8 +290,6 @@ Añade el directorio generado por Intlayer a tu `.gitignore`:
 .intlayer
 ```
 
----
-
 ## Profundizar Más
 
 - **Editor Visual** — Gestiona las traducciones visualmente en tu navegador: [Editor Visual de Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md)