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

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.

package/docs/es/compat/polyglot.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrar de Polyglot.js a Intlayer"
+description: "Aprende cómo migrar desde Polyglot.js a Intlayer usando el adaptador de compatibilidad."
+keywords:
+  - polyglot
+  - airbnb
+  - intlayer
+  - migración
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - polyglot
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Inicializar historial"
+author: aymericzip
+---
+
+# Migrar de Polyglot.js a Intlayer
+
+Si estás usando Polyglot.js de Airbnb, migrar a Intlayer es extremadamente fácil usando la capa de compatibilidad.
+
+## Qué hacer
+
+Simplemente ejecuta el comando de inicialización en tu proyecto:
+
+```bash
+npx intlayer init
+```
+
+Esto genera `intlayer.config.ts`. Luego puedes utilizar el alias del plugin del empaquetador para redireccionara transparentemente importaciones de Polyglot a `@intlayer/polyglot`.
+
+## Qué hace bajo el capó
+
+La sintaxis de Polyglot.js típicamente se basa en `polyglot.t('key', {name})` con interpolaciones `%{name}` y plurales `smart_count` separados por `"singular |||| plural"`.
+
+Bajo el capó:
+
+- **Interpolación:** La capa de compatibilidad maneja placeholders `%{var}` nativamente.
+- **Plurales:** La cadena se divide en `||||` y se evalúa contra `Intl.PluralRules` nativo según el locale activo, reflejando el propio orden de bucket de Polyglot por locale.
+- **Diccionarios:** Evitas la necesidad de proporcionar enormes configuraciones de JSON a `new Polyglot()` – Intlayer maneja los diccionarios dinámicamente y los poda automáticamente.

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

@@ -0,0 +1,58 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrar de react-i18next a Intlayer"
+description: "Aprende cómo migrar tu aplicación React desde react-i18next a Intlayer usando el adaptador de compatibilidad."
+keywords:
+  - react-i18next
+  - i18next
+  - intlayer
+  - migración
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - react-i18next
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Inicializar historial"
+author: aymericzip
+---
+
+# Migrar de react-i18next a Intlayer
+
+Para un tutorial completo y detallado paso a paso, por favor consulta nuestra [Guía Completa de Migración de react-i18next](../migration_from_react-i18next_to_intlayer.md).
+
+Usar el adaptador de compatibilidad de Intlayer te permite migrar desde `react-i18next` sin ningún cambio en las importaciones de tu código fuente.
+
+## Qué hacer
+
+Para inicializar el proyecto, ejecuta:
+
+```bash
+npx intlayer init
+```
+
+Durante la inicialización, Intlayer instalará `@intlayer/react-i18next` y creará `intlayer.config.ts`. En tu empaquetador (como Vite), aplica el plugin de Intlayer:
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import { reactI18nextVitePlugin } from "@intlayer/react-i18next/plugin";
+
+export default defineConfig({
+  plugins: [react(), reactI18nextVitePlugin()],
+});
+```
+
+## Qué hace bajo el capó
+
+El `reactI18nextVitePlugin` envuelve el plugin principal `vite-intlayer` e inyecta alias de resolución para `react-i18next` e `i18next`, redireccionándolos a `@intlayer/react-i18next` y `@intlayer/i18next`.
+
+Bajo el capó:
+
+- **`useTranslation` y `withTranslation`:** Reescritos para usar hooks nativos de Intlayer, dándote finalización automática de TypeScript para tus claves de diccionario. Soporta sin problemas namespaces (p. ej. `t('namespace:key')`).
+- **Plurales y contexto:** Maneja la pluralización basada en sufijos de i18next (`key_one`, `key_other`) usando `Intl.PluralRules` nativo y sufijos de contexto (`key_male`).
+- **Componente `<Trans>`:** Reimplementado para soportar la prop `components`, formularios de objeto y array, y etiquetas numeradas `<1>...</1>` directamente mapeadas a tus nodos React.
+- **Instancia de `i18n`:** Resuelve claves directamente desde Intlayer sin buscar archivos JSON grandes, resultando en tamaños de bundle significativamente menores.

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

@@ -0,0 +1,55 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrar de React Intl a Intlayer"
+description: "Aprende cómo migrar tu aplicación React desde react-intl a Intlayer usando el adaptador de compatibilidad."
+keywords:
+  - react-intl
+  - formatjs
+  - intlayer
+  - migración
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - react-intl
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Inicializar historial"
+author: aymericzip
+---
+
+# Migrar de React Intl a Intlayer
+
+Si tu aplicación React usa `react-intl` (FormatJS), hacer la transición a Intlayer es muy fácil. Nuestra capa de compatibilidad maneja sin problemas ICU MessageFormat y todos los componentes `Formatted*` existentes.
+
+## Qué hacer
+
+Comienza ejecutando el comando de inicialización en tu proyecto:
+
+```bash
+npx intlayer init
+```
+
+Luego, configura el plugin de Vite o Next.js de Intlayer en tu configuración. Este plugin inyecta aliases en tiempo de compilación para redireccionara importaciones de `react-intl` a `@intlayer/react-intl`.
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import reactIntlVitePlugin from "@intlayer/react-intl/plugin";
+
+export default defineConfig({
+  plugins: [react(), reactIntlVitePlugin()],
+});
+```
+
+## Qué hace bajo el capó
+
+El plugin del empaquetador asigna `react-intl` a `@intlayer/react-intl`. En lugar de analizar manualmente grandes archivos JSON y envolver tu aplicación en un `IntlProvider`, el plugin de Intlayer extrae estáticamente claves y usa diccionarios de Intlayer en tiempo de ejecución.
+
+Bajo el capó:
+
+- **ICU MessageFormat:** Intlayer utiliza el resolvedor `resolveMessage(..., 'icu')` que soporta completamente pluralización ICU, selección, formateo de fechas/números y etiquetas de texto rico nativamente.
+- **Llamadores de método y JSX:** `intl.formatMessage({ id: 'a.b' })` y `<FormattedMessage id="a.b">` son identificados por los plugins del compilador de Intlayer (`@intlayer/babel` / `@intlayer/swc`), convirtiendo claves con puntos planos para que el primer segmento se resuelva correctamente a la clave del diccionario de Intlayer.
+- **Formateadores:** `<FormattedNumber>`, `<FormattedDate>`, etc., se puenten a los `core/formatters` nativos usando `Intl`.

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

@@ -0,0 +1,47 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrar de Svelte I18n a Intlayer"
+description: "Aprende cómo migrar tu aplicación Svelte desde svelte-i18n a Intlayer usando el adaptador de compatibilidad."
+keywords:
+  - svelte-i18n
+  - svelte
+  - intlayer
+  - migración
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - svelte-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Inicializar historial"
+author: aymericzip
+---
+
+# Migrar de Svelte I18n a Intlayer
+
+Mover tu aplicación Svelte desde `svelte-i18n` a Intlayer toma solo un momento usando el adaptador de compatibilidad.
+
+## Qué hacer
+
+Simplemente ejecuta el comando de inicialización en tu proyecto:
+
+```bash
+npx intlayer init
+```
+
+Esto genera `intlayer.config.ts`. Asegúrate de que tus plugins de SvelteKit / Vite estén envueltos con el plugin de alias de Intlayer para mapear sin problemas `svelte-i18n` a `@intlayer/svelte-i18n`.
+
+## Qué hace bajo el capó
+
+Svelte-i18n se basa en stores muy utilizados (`$_`, `$t`, `$format`, etc.) e ICU MessageFormat.
+
+Bajo el capó:
+
+- **Stores:** Intlayer proxies los stores de `svelte-i18n`. `$_` se convierte en un store derivado del locale actual que devuelve un resolvedor de Intlayer.
+- **Claves:** Tus claves planas (p. ej. `$_('home.title')`) se evalúan de modo que el primer segmento de ruta representa el diccionario de Intlayer.
+- **Sintaxis ICU:** Completamente manejada por el resolvedor ICU compartido (análisis equivalente de `intl-messageformat`).
+- **Formateadores:** Las llamadas `$date`, `$time`, `$number` se redireccionan de forma segura a los formateadores de núcleo nativos de Intlayer.
+- **Análisis Babel/SWC:** El analizador de Intlayer lee los llamadores de stores de Svelte (`$_`) dentro de tus archivos fuente `.svelte` antes de la compilación para construir automáticamente los fragmentos de diccionario relevantes.

package/docs/es/compat/transloco.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrar de Transloco a Intlayer"
+description: "Aprende cómo migrar tu aplicación Angular desde Transloco a Intlayer usando el adaptador de compatibilidad."
+keywords:
+  - transloco
+  - angular
+  - intlayer
+  - migración
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - transloco
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Inicializar historial"
+author: aymericzip
+---
+
+# Migrar de Transloco a Intlayer
+
+Si tu aplicación Angular actualmente usa `@jsverse/transloco`, puedes migrar a Intlayer usando nuestro adaptador de compatibilidad. Esta transición te permite mantener tu sintaxis de plantilla existente mientras utilizas la poderosa estructura de diccionarios de Intlayer.
+
+## Qué hacer
+
+Simplemente ejecuta el comando de inicialización en tu proyecto:
+
+```bash
+npx intlayer init
+```
+
+Esto generará la configuración necesaria de `intlayer.config.ts`. Entonces reemplazarás tus importaciones de Transloco con módulos de `@intlayer/transloco` o confiarás en los aliases de compilación.
+
+## Qué hace bajo el capó
+
+Transloco utiliza scopes y un `TranslocoService` (`translate`, `selectTranslate`), junto con directivas estructurales (`*transloco="let t"`) y pipes (`| transloco`).
+
+Bajo el capó:
+
+- **Scopes:** Se asignan naturalmente a claves de diccionarios de Intlayer, proporcionando una gran historia de poda para optimización de bundle.
+- **Servicio y directivas:** El adaptador de Angular de Intlayer reemplaza sin problemas los proveedores, permitiendo que tus pipes y directivas de plantilla existentes resuelvan cadenas contra diccionarios de Intlayer.
+- **Análisis en tiempo de compilación:** El analizador de TypeScript reconoce llamadas `instant/get`, y la poda de fallback asegura correctitud incluso cuando el uso de plantilla no es estáticamente rastreable.

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

@@ -0,0 +1,58 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrar de Vue I18n a Intlayer"
+description: "Aprende cómo migrar tu aplicación Vue desde vue-i18n a Intlayer usando el adaptador de compatibilidad."
+keywords:
+  - vue-i18n
+  - vue
+  - intlayer
+  - migración
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - vue-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Inicializar historial"
+author: aymericzip
+---
+
+# Migrar de Vue I18n a Intlayer
+
+Si tu aplicación Vue actualmente usa `vue-i18n`, puedes migrar a Intlayer sin reescribir tus componentes ni tus hooks de traducción. Intlayer proporciona un adaptador de compatibilidad que refleja perfectamente la API de `vue-i18n` mientras aprovecha las poderosas características de Intlayer bajo el capó.
+
+## Qué hacer
+
+Para comenzar, simplemente ejecuta el comando de inicialización en tu proyecto:
+
+```bash
+npx intlayer init
+```
+
+Durante la inicialización, Intlayer configurará tu archivo de configuración (`intlayer.config.ts`) y preparará tu proyecto para la migración. Solo necesitarás agregar el plugin de Intlayer a tu configuración de Vite para asignar automáticamente las importaciones de `vue-i18n`.
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import vue from "@vitejs/plugin-vue";
+import vueI18nVitePlugin from "@intlayer/vue-i18n/plugin";
+
+export default defineConfig({
+  plugins: [vue(), vueI18nVitePlugin()],
+});
+```
+
+## Qué hace bajo el capó
+
+El `vueI18nVitePlugin` inyecta un alias de módulo en tu empaquetador. Cualquier importación de `vue-i18n` en tu base de código será transparentemente redireccionada a `@intlayer/vue-i18n`.
+
+**Bajo el capó, el adaptador maneja la sintaxis compleja de `vue-i18n` nativamente:**
+
+- **Interpolación y plurales:** Resuelve interpolaciones `{name}` y lista `{0}`. Los plurales de tubería (`"car | cars"`) se convierten en nodos de enumeración/plural de Intlayer basados en semántica posicional.
+- **Formatos:** Funciones como `d()` y `n()` envuelven `Intl` bajo el capó, honrando los `datetimeFormats` y `numberFormats` definidos en tus opciones.
+- **Estado global y local:** `global.locale` se asigna a una `WritableComputedRef` respaldada por el cliente de Intlayer, por lo que la reactividad se comporta exactamente como se esperaba (p. ej. `locale.value = 'fr'`).
+- **Directivas:** La directiva `v-t` se registra y funciona normalmente.
+
+Tu aplicación continúa renderizando exactamente como antes, pero el contenido está impulsado por tus diccionarios de Intlayer, dándote seguridad de tipos, mejor optimización de bundle e integración perfecta de CMS.

package/docs/es/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-03-12
+updatedAt: 2026-06-23
 title: Intlayer Compiler | Extracción Automática de Contenido para i18n
 description: Automatiza tu proceso de internacionalización con el Intlayer Compiler. Extrae contenido directamente de tus componentes para una i18n más rápida y eficiente en Vite, Next.js y más.
 keywords:
@@ -60,6 +60,8 @@ Como alternativa, para automatizar tu proceso i18n mientras mantienes el control
 
 ## Uso
 
+> The quickest way to wire the compiler in is the interactive setup: run `npx intlayer init --interactive` and select **Compiler**. On Vite there is nothing to configure — the compiler is plugged in directly through the `intlayerCompiler()` plugin. On Next.js the command scaffolds the `babel.config.js` shown below. The non-interactive `intlayer init` leaves the compiler setup untouched.
+
 <Tabs>
  <Tab value='vite'>
 
@@ -79,12 +81,15 @@ Actualiza tu `vite.config.ts` para incluir el plugin `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayer, intlayerCompiler } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayer(),
-    intlayerCompiler(), // Añade el plugin del compilador
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```

package/docs/es/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-05-12
+updatedAt: 2026-06-23
 title: Configuración (Configuration)
 description: Aprenda a configure Intlayer para su aplicación. Entienda los diversos ajustes y opciones disponibles para personalizar Intlayer según sus necesidades.
 keywords:
@@ -14,6 +14,12 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.0.0
+    date: 2026-06-24
+    changes: "Add `enableProxy` option to the routing configuration"
+  - version: 8.10.0
+    date: 2026-06-17
+    changes: "Añadida la opción `format` a la configuración del diccionario"
   - version: 8.9.4
     date: 2026-05-12
     changes: "Añadir soporte para el proveedor LM Studio"
@@ -135,6 +141,7 @@ Intlayer acepta los formatos de archivo de configuración JSON, JS, MJS y TS:
 ````typescript fileName="intlayer.config.ts" codeFormat="typescript"
 import { Locales, type IntlayerConfig } from "intlayer";
 import { nextjsRewrite } from "intlayer/routing";
+import { syncJSON } from "@intlayer/sync-json-plugin";
 import { z } from "zod";
 
 /**
@@ -586,9 +593,37 @@ const config: IntlayerConfig = {
   },
 
   /**
-   * Configuración de complementos (plugins).
+   * Configuración del diccionario.
    */
-  plugins: [],
+  dictionary: {
+    /**
+     * Controla cómo se importan los diccionarios.
+     * - "static": Importado estáticamente en el momento de compilación.
+     * - "dynamic": Importado dinámicamente usando Suspense.
+     * - "fetch": Obtenido dinámicamente a través de la API de sincronización en vivo.
+     */
+    importMode: "static",
+
+    /**
+     * El formato de mensaje predeterminado para todos los diccionarios del proyecto.
+     * - 'intlayer': Formato intlayer nativo (predeterminado).
+     * - 'icu': Formato de mensaje ICU.
+     * - 'i18next': Formato i18next.
+     * - 'vue-i18n': Formato Vue I18n.
+     * - 'po': Formato GNU Gettext PO.
+     */
+    format: "icu",
+  },
+
+  /**
+   * Configuración de plugins.
+   */
+  plugins: [
+    syncJSON({
+      format: "icu",
+      source: ({ locale }) => `./messages/${locale}.json`,
+    }),
+  ],
 };
 
 export default config;
@@ -852,6 +887,21 @@ Ajustes relacionados con el procesamiento de contenido dentro de la aplicación
 
 ---
 
+### Configuración del Sistema
+
+Configuración relacionada con rutas internas y resultados de salida de Intlayer. Estas configuraciones son típicamente internas y normalmente no deberían necesitar ser modificadas por el usuario.
+
+| Field                     | Description                                                                                          | Type     | Default                           | Example              | Note                                                                      |
+| ------------------------- | ---------------------------------------------------------------------------------------------------- | -------- | --------------------------------- | -------------------- | ------------------------------------------------------------------------- |
+| `baseDir`                 | El directorio base del proyecto.                                                                     | `string` | `process.cwd()`                   | `'/path/to/project'` | Se utiliza para resolver todos los directorios relacionados con Intlayer. |
+| `dictionariesDir`         | La ruta del directorio para almacenar diccionarios de localización.                                  | `string` | `'.intlayer/dictionary'`          |                      |                                                                           |
+| `moduleAugmentationDir`   | Directorio para aumento de módulos, permitiendo mejores sugerencias del IDE y verificación de tipos. | `string` | `'.intlayer/types'`               | `'intlayer-types'`   | Asegúrate de incluir esto en `tsconfig.json`.                             |
+| `unmergedDictionariesDir` | El directorio para almacenar diccionarios sin fusionar.                                              | `string` | `'.intlayer/unmerged_dictionary'` |                      |                                                                           |
+| `typesDir`                | El directorio para almacenar tipos de diccionarios.                                                  | `string` | `'.intlayer/types'`               |                      |                                                                           |
+| `mainDir`                 | El directorio donde se almacenan los archivos principales de la aplicación.                          | `string` | `'.intlayer/main'`                |                      |                                                                           |
+| `configDir`               | El directorio donde se almacenan los archivos de configuración.                                      | `string` | `'.intlayer/config'`              |                      |                                                                           |
+| `cacheDir`                | El directorio donde se almacenan los archivos de caché.                                              | `string` | `'.intlayer/cache'`               |                      |                                                                           |
+
 ### Configuración del Diccionario (Dictionary Configuration)
 
 Parámetros que controlan las operaciones de diccionarios, incluido el comportamiento de relleno automático y la generación de contenido.
@@ -864,6 +914,7 @@ Parámetros que controlan las operaciones de diccionarios, incluido el comportam
 | `contentAutoTransformation` | Transforma automáticamente cadenas de contenido en nodos tipados (markdown, HTML o inserción).                                                                        | `boolean` &#124; <br/> `{ markdown?: boolean; html?: boolean; insertion?: boolean }`                            | `false`        | `true`                                                                                      | • Markdown : `### Title` → `md('### Title')`.<br/>• HTML : `<div>Title</div>` → `html('<div>Title</div>')`.<br/>• Inserción : `Hello {{name}}` → `insert('Hello {{name}}')`.                                                                                                                                                                                                                                                               |
 | `location`                  | Indica dónde se almacenan los archivos de diccionario y cómo se sincronizan con el CMS.                                                                               | `'local'` &#124; <br/> `'remote'` &#124; <br/> `'hybrid'` &#124; <br/> `'plugin'` &#124; <br/> `string`         | `'local'`      | `'hybrid'`                                                                                  | • `'local'` : solo se gestiona localmente.<br/>• `'remote'` : solo se gestiona de forma remota (CMS).<br/>• `'hybrid'` : se gestiona tanto local como remotamente.<br/>• `'plugin'` o cadena personalizada: gestionado por un plugin o fuente personalizada.                                                                                                                                                                               |
 | `importMode`                | Controla cómo se importan los diccionarios.                                                                                                                           | `'static'` &#124; <br/> `'dynamic'` &#124; <br/> `'fetch'`                                                      | `'static'`     | `'dynamic'`                                                                                 | • `'static'`: importado estáticamente.<br/>• `'dynamic'`: importado dinámicamente mediante Suspense.<br/>• `'fetch'`: recuperado vía live sync API; recurre a `'dynamic'` si falla.<br/>• Depende de los plugins `@intlayer/babel` y `@intlayer/swc`.<br/>• Las claves deben declararse estáticamente.<br/>• Se ignora si `optimize` está desactivado.<br/>• No afecta a `getIntlayer`, `getDictionary`, etc.                              |
+| `format`                    | El formato de mensaje predeterminado para todos los diccionarios del proyecto.                                                                                        | `'intlayer'` &#124; <br/> `'icu'` &#124; <br/> `'i18next'` &#124; <br/> `'vue-i18n'` &#124; <br/> `'po'`        | `'intlayer'`   | `'icu'`                                                                                     | • `'intlayer'`: Formato intlayer nativo.<br/>• `'icu'`: Formato de mensaje ICU.<br/>• `'i18next'`: Formato i18next.<br/>• `'vue-i18n'`: Formato Vue I18n.<br/>• `'po'`: Formato GNU Gettext PO.                                                                                                                                                                                                                                            |
 | `priority`                  | Prioridad del diccionario. Los valores más altos ganan sobre los más bajos al resolver conflictos entre diccionarios.                                                 | `number`                                                                                                        | `undefined`    | `1`                                                                                         |                                                                                                                                                                                                                                                                                                                                                                                                                                            |
 | `live`                      | Depreciado - use `importMode: 'fetch'` en su lugar. Indicaba si el contenido del diccionario se recuperaba dinámicamente a través de la API live sync.                | `boolean`                                                                                                       | `undefined`    |                                                                                             | Renombrado a `importMode: 'fetch'` en v8.0.0.                                                                                                                                                                                                                                                                                                                                                                                              |
 | `schema`                    | Generado automáticamente por Intlayer para la validación del esquema JSON.                                                                                            | `'https://intlayer.org/schema.json'`                                                                            | auto-generado  |                                                                                             | No editar manualmente.                                                                                                                                                                                                                                                                                                                                                                                                                     |
@@ -959,22 +1010,6 @@ Las opciones de compilación se aplican a los complementos `@intlayer/babel` y `
 
 ---
 
-### Configuración del Sistema (System Configuration)
-
-Estos ajustes son para casos de uso avanzados y configuración interna de Intlayer.
-
-| Campo                     | Descripción                                         | Tipo     | Predeterminado                    | Ejemplo | Nota |
-| ------------------------- | --------------------------------------------------- | -------- | --------------------------------- | ------- | ---- |
-| `dictionariesDir`         | Directorio de diccionarios compilados.              | `string` | `'.intlayer/dictionary'`          |         |      |
-| `moduleAugmentationDir`   | Directorio de aumento de módulos TypeScript.        | `string` | `'.intlayer/types'`               |         |      |
-| `unmergedDictionariesDir` | Directorio de diccionarios no fusionados.           | `string` | `'.intlayer/unmerged_dictionary'` |         |      |
-| `typesDir`                | Directorio de tipos generados.                      | `string` | `'.intlayer/types'`               |         |      |
-| `mainDir`                 | Directorio del archivo principal de Intlayer.       | `string` | `'.intlayer/main'`                |         |      |
-| `configDir`               | Directorio de archivos de configuración compilados. | `string` | `'.intlayer/config'`              |         |      |
-| `cacheDir`                | Directorio de archivos de caché.                    | `string` | `'.intlayer/cache'`               |         |      |
-
----
-
 ### Configuración del Compilador (Compiler Configuration)
 
 Ajustes que controlan el compilador de Intlayer, que extrae diccionarios directamente de sus componentes.

package/docs/es/custom_domains.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-02
-updatedAt: 2026-04-02
+updatedAt: 2026-06-23
 title: Dominios personalizados
 description: Aprenda a configurar el enrutamiento por locales basado en dominios en Intlayer para servir diferentes locales desde nombres de host dedicados.
 keywords:
@@ -172,10 +172,16 @@ El complemento Vite `intlayerProxy` aplica la misma lógica durante el desarroll
 
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
-  plugins: [intlayerProxy()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```