@intlayer/docs 9.4.0-canary.0 → 9.4.0

package/docs/en-GB/self_hosting.md

@@ -21,12 +21,16 @@ author: aymericzip
 
 Intlayer can run entirely on your own infrastructure. No Intlayer Cloud account required. A single command boots a production-ready stack:
 
+One command installs everything:
+
 ```sh
 curl -fsSL https://intlayer.org/install.sh | sh
 ```
 
 The installer downloads a `docker-compose.yml` and a `.env`, auto-generates the required secrets, and starts all containers with `docker compose up -d`.
 
+The only external dependency is **MongoDB**: the backend connects to a MongoDB **Atlas** cluster, which you provide. Everything else runs inside the container.
+
 ## Table of Contents
 
 <TOC/>
@@ -60,40 +64,82 @@ Chromium (used for Puppeteer screenshot generation) is bundled inside the backen
 - Ports `3000`, `3100`, `8025`, `9000`, and `9001` available on the host.
 - A Linux or macOS host (or WSL2 on Windows).
 
+Everything else — Bun, Redis, MinIO, Chromium — ships inside the image.
+
 ---
 
 ## Quick start
 
-Pull and run the published image, supplying your MongoDB Atlas credentials and secrets:
+### 1. Run the installer
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+It verifies Docker is installed and running, writes `./intlayer.env` with `BETTER_AUTH_SECRET` and `S3_SECRET_ACCESS_KEY` already generated, and pulls the image. It does not start the container — the backend cannot boot without your database credentials.
+
+Re-running the installer is safe: an existing `intlayer.env` is never overwritten, so it doubles as the upgrade path.
+
+### 2. Fill in your credentials
+
+Open `intlayer.env` and complete the values marked `TODO`:
+
+```sh fileName="intlayer.env"
+DB_ID=<atlas-user>
+DB_MDP=<atlas-password>
+DB_CLUSTER=<cluster>.xxxxx.mongodb.net
+RESEND_API_KEY=<your-resend-key>
+```
+
+The file also carries commented-out blocks for the optional features — [SMTP mailer](#global-mailer), `OPENAI_API_KEY`, and the OAuth providers. Uncomment what you need.
+
+> The file is read by `docker run --env-file`, which does not strip quotes and treats everything after `=` as the value. Write bare values, and keep comments on their own lines.
+
+### 3. Start the container
+
+This is the command the installer prints when it finishes:
 
 ```sh
 docker run -d --name intlayer \
+  --restart unless-stopped \
   -p 3000:3000 \
   -p 3100:3100 \
   -p 9000:9000 \
   -p 9001:9001 \
   -v intlayer-data:/data \
-  -e DB_ID="<atlas-user>" \
-  -e DB_MDP="<atlas-password>" \
-  -e DB_CLUSTER="<cluster>.xxxxx.mongodb.net" \
-  -e BETTER_AUTH_SECRET="$(openssl rand -hex 32)" \
-  -e S3_SECRET_ACCESS_KEY="$(openssl rand -hex 16)" \
-  -e RESEND_API_KEY="<your-resend-key>" \
-  aymericzip/intlayer-selfhost
+  --env-file ./intlayer.env \
+  ghcr.io/aymericzip/intlayer-selfhost:latest
 ```
 
-Then open **http://localhost:3000**.
+Then open **http://localhost:3000**. First boot initialises the datastores, so give it a minute.
 
 > The dashboard is served on `localhost`. See [Limitations](#limitations) — custom domains are not supported by the published image.
 
----
+### Installer settings
 
-## Quick start
+The installer reads a few environment variables. Because it is piped into `sh`, pass them to the shell rather than to `curl`:
 
 ```sh
-curl -fsSL https://intlayer.org/install.sh | sh
+curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer.env sh
 ```
 
+| Variable                  | Default                                       | Description                     |
+| ------------------------- | --------------------------------------------- | ------------------------------- |
+| `INTLAYER_IMAGE`          | `ghcr.io/aymericzip/intlayer-selfhost:latest` | Image to pull                   |
+| `INTLAYER_ENV_FILE`       | `./intlayer.env`                              | Where to write the env file     |
+| `INTLAYER_CONTAINER_NAME` | `intlayer`                                    | Container name                  |
+| `INTLAYER_DATA_VOLUME`    | `intlayer-data`                               | Named volume mounted at `/data` |
+| `INTLAYER_APP_PORT`       | `3000`                                        | Host port for the dashboard     |
+| `INTLAYER_API_PORT`       | `3100`                                        | Host port for the API           |
+| `INTLAYER_S3_PORT`        | `9000`                                        | Host port for the MinIO S3 API  |
+| `INTLAYER_CONSOLE_PORT`   | `9001`                                        | Host port for the MinIO console |
+
+> The four port variables only change the **host** side of the mapping printed in the `docker run` command. The published image has `http://localhost:3000`, `http://localhost:3100` and `http://localhost:9000` compiled into the dashboard bundle at build time, so remapping them leaves the browser pointing at the old ports. Keep the defaults unless you are building your own image — see [Limitations](#limitations).
+
+---
+
+## Quick start
+
 What the installer does:
 
 1. Checks that `docker` and `docker compose` are present.
@@ -117,8 +163,6 @@ After the stack is up, open **http://localhost:3000** and create your first acco
 | **minio**   | `minio/minio`                        | `9000` (S3), `9001` (console)  | S3-compatible object storage for avatars and screenshots |
 | **mailpit** | `axllent/mailpit`                    | `1025` (SMTP), `8025` (web UI) | Local transactional email sink                           |
 
-Internal ports (mongo, redis) are not exposed to the host by default.
-
 > MinIO port `9000` must be reachable by the browser because uploaded assets (avatars, screenshots) are loaded directly from `S3_PUBLIC_URL=http://localhost:9000/intlayer`.
 
 ---
@@ -174,8 +218,6 @@ Internal ports (mongo, redis) are not exposed to the host by default.
 | `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | LinkedIn OAuth login                                        |
 | `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Atlassian OAuth login                                       |
 
----
-
 ### Global mailer
 
 By default, all transactional emails are sent through Resend using `RESEND_API_KEY`. Self-hosted deployments can instead route **every** email — including non-organisation emails such as password resets and magic links — through a global mailer configured with environment variables.
@@ -261,16 +303,8 @@ const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
 
 ## Upgrading
 
-Re-running the installer on an existing deployment performs a rolling upgrade:
-
-```sh
-curl -fsSL https://intlayer.org/install.sh | sh
-```
-
 This pulls the latest images and restarts containers with `docker compose pull && docker compose up -d`. Existing volumes (`mongo-data`, `redis-data`, `minio-data`) are preserved — no data loss.
 
-To upgrade manually from inside the `./intlayer/` directory:
-
 ```sh
 docker compose pull
 docker compose up -d
@@ -334,15 +368,12 @@ docker compose logs mongo
 docker compose logs redis
 ```
 
+Look for `MongoDB connection error` near the top of the log.
+
 ### Dashboard cannot reach the API
 
 Verify that `VITE_BACKEND_URL` matches the URL where the backend is reachable from the **browser** (not the Docker network). If you changed the backend port or added a reverse proxy, rebuild the dashboard image:
 
-```sh
-docker compose build app
-docker compose up -d app
-```
-
 ### MinIO bucket missing
 
 If the `minio-init` one-shot service didn't run (or ran before MinIO was ready), create the bucket manually:

package/docs/es/analytics.md

@@ -123,17 +123,6 @@ export default config;
 
 Desinstalar `@intlayer/analytics` tiene el mismo efecto que `enabled: false`. Consulta la [referencia de configuración](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/configuration.md) para ver la lista completa de campos.
 
-## Soporte de frameworks
-
-Analytics está integrado en el `IntlayerProvider` compartido de `react-intlayer`, por lo que está disponible hoy en cualquier lugar donde se use ese proveedor:
-
-| Framework                                                | Estado                                                                                              |
-| -------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
-| React                                                    | ✅ Disponible                                                                                       |
-| Next.js (`next-intlayer`)                                | ✅ Disponible (a través de `react-intlayer`)                                                        |
-| React Native / Expo (`react-native-intlayer`)            | ✅ Disponible (a través de `react-intlayer`)                                                        |
-| Vue, Svelte, Angular, Solid, Preact, Lit, Astro, Vanilla | 🚧 Planeado — mismo cliente, enlaces a nivel de proveedor siguiendo el modelo de `@intlayer/editor` |
-
 ## Uso
 
 ### Seguimiento automático a nivel de proveedor
@@ -177,6 +166,34 @@ const CTAButton = () => {
 
 ### Resolución de una variante en el lado del cliente
 
+  </Tab>
+</Tabs>
+
+Los pesos son opcionales — pasa uno por variante para sesgar la división, por ejemplo `useExperiment("homepage-hero", ["default", "black_friday"], [9, 1])`.
+
+El hijo entonces lee la [Variant](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dynamic_dictionaries/variants.md) del diccionario que coincide:
+
+```tsx fileName="HeroBanner.tsx"
+import { useIntlayer } from "react-intlayer";
+
+export const HeroBanner = ({ variant }: { variant: string }) => {
+  const { headline, cta } = useIntlayer("hero-banner", { variant });
+
+  return (
+    <section>
+      <h1>{headline}</h1>
+      <a>{cta}</a>
+    </section>
+  );
+};
+```
+
+> Leer la variante en un **componente hijo** es lo que hace que esto funcione fuera de React: en Vue, Svelte, Solid y Angular, el selector pasado a `useIntlayer` se captura cuando el componente se configura, por lo que la lectura debe ocurrir en un componente que solo se monta una vez que se conoce la variante.
+
+Si el experimento cubre una página completa en lugar de un único diccionario, eleva la variante al proveedor en su lugar — consulta [Ambient variant](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dynamic_dictionaries/variants.md#ambient-variant). Cada `useIntlayer` debajo se resuelve contra él sin cambios en el sitio de llamada.
+
+Si necesitas la asignación sin procesar fuera de un componente, accede al cliente directamente:
+
 ```tsx fileName="useHeroVariant.ts" codeFormat="tsx"
 import { getGlobalAnalyticsClient } from "@intlayer/analytics/client";
 
@@ -187,6 +204,8 @@ const variant = client?.getVariant("homepage-hero", [
 ]);
 ```
 
+> `getVariant` solo asigna — no registra la exposición. Prefiere `useExperiment()`, de lo contrario la tasa de conversión no tiene denominador.
+
 ## Privacidad y rendimiento
 
 - **Anónimo por diseño**: las sesiones se identifican mediante una ID rotatoria; el backend solo almacena un **hash SHA-256** de esa ID — nunca la ID en crudo, nunca una dirección IP.
@@ -236,6 +255,8 @@ const cms = createIntlayerCMS();
 const { data: audience } = await analyticsEndpoint(cms).getAudience(30);
 ```
 
+> **Solo en el servidor.** `createIntlayerCMS()` se autentica con `clientId` + `clientSecret`, y el secreto nunca está disponible en el navegador — este fragmento emitiría solicitudes no autenticadas si se ejecutara allí. Mantenlo en un controlador de rutas, una acción del servidor o un script.
+
 ## Enlaces útiles
 
 - [Diccionarios Dinámicos - Colecciones y Variantes](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dynamic_dictionaries/index.md)

package/docs/es/benchmark/tanstack.md

@@ -194,6 +194,8 @@ La idea detrás de `Wuchale` es interesante pero todavía no es una solución vi
 
 `Tolgee` aborda muchos de los problemas mencionados anteriormente. Me resultó más difícil empezar con ella que con otras herramientas con enfoques similares. No proporciona seguridad de tipos, lo que también dificulta mucho detectar claves faltantes en tiempo de compilación (build time). Tuve que envolver las API de Tolgee con las mías propias para añadir la detección de claves faltantes.
 
+El package es bastante pesado (~11.1kb, lo que es más de 2× `react-intlayer`).
+
 En TanStack Start también tuve problemas de reactividad: al cambiar de idioma, tuve que forzar el renderizado del proveedor y suscribirme a eventos de cambio de idioma para que la carga en otro idioma se comportara correctamente.
 
 **(use-intl)** (`use-intl@4.9.1`):
@@ -208,6 +210,8 @@ En TanStack Start evitas las trampas específicas de Next.js (`setRequestLocale`
 
 Aun así, comparte las mismas desventajas principales que los stacks basados en `t('a.b.c')`: las optimizaciones son posibles pero consumen mucho tiempo, y los proyectos grandes corren el riesgo de caer en malas prácticas (namespaces + carga dinámica + tipos).
 
+El package es especialmente pesado (~17.3kb, que es aproximadamente 3.5× `react-intlayer`).
+
 Los formatos de los mensajes también divergen: `use-intl` usa ICU MessageFormat, mientras que `i18next` usa su propio formato, lo que complica las herramientas o las migraciones si se mezclan.
 
 **(Lingui)** (`@lingui/core@5.3.0`):
@@ -218,6 +222,8 @@ A menudo se elogia a `Lingui`. Personalmente, encontré el flujo de trabajo en t
 
 `react-intl` es una implementación de alto rendimiento del equipo de Format.js. La DX sigue siendo verbosa: `const intl = useIntl()` + `intl.formatMessage({ id: "xx.xx" })` añade complejidad, trabajo extra de JavaScript y vincula la instancia global de i18n a muchos nodos en el árbol de React.
 
+El package también es pesado (~14.4kb, lo que es aproximadamente 3× `react-intlayer`).
+
 ### 4 - Recomendaciones
 
 Este benchmark de TanStack Start no tiene un equivalente directo a `next-translate` (plugin de Next.js + `getStaticProps`). Para los equipos que realmente quieren una API `t()` con un ecosistema maduro, `react-i18next` y `use-intl` siguen siendo opciones "razonables", pero prepárate para invertir mucho tiempo optimizando para evitar fugas.

package/docs/es/cli/ci.md

@@ -128,6 +128,8 @@ bun x intlayer ci fill --verbose --mode complete
 
 ### Usar en pipelines CI/CD
 
+Ejecutar `intlayer init` genera dos flujos de trabajo de GitHub Actions listos para usar (ver [GitHub Actions generados](#scaffolded-github-actions) abajo). El ejemplo aquí muestra la configuración equivalente usando el comando `ci` para un monorepo, donde las credenciales se inyectan por proyecto desde `INTLAYER_PROJECT_CREDENTIALS`.
+
 En tu configuración CI/CD (por ejemplo, GitHub Actions, GitLab CI), establece `INTLAYER_PROJECT_CREDENTIALS` como secreto:
 
 ```yaml

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

@@ -91,7 +91,19 @@ Para la mayoría de los casos de uso,
 
 - **`--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`
+- Insert missing paragraphs, lists, tables, code blocks, and images
+- Correct spelling, grammar, punctuation, and Markdown errors
+- Preserve code blocks while translating comments to Spanish
+- Maintain byte-for-byte identical correct content
+- Transform documentation links appropriately (`/en/` → `/es/`)
+- Handle translation lists with proper `{{locale}}` ordering
+- Respect front-matter and code element metadata
+
+> Ejemplo: `npx intlayer doc review --mode report`
+
+> Ejemplo: `npx intlayer doc review --log`
+
+Sea cual sea el modo, la ejecución finaliza con un resumen que enumera los documentos que están alineados con su documento base y los que aún tienen bloques para editar.
 
 **Opciones de salida de entrada:**
 

package/docs/es/cli/fill.md

@@ -39,14 +39,6 @@ bun x intlayer fill
 
 Este comando analiza tus archivos de declaración de contenido en busca de posibles problemas como traducciones faltantes, inconsistencias estructurales o incompatibilidades de tipo. Si encuentra algún problema, **intlayer fill** propondrá o aplicará actualizaciones para mantener tus diccionarios consistentes y completos.
 
-Puntos clave:
-
-- Divide archivos JSON grandes en fragmentos 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 mejorar la precisión de la traducción.
-- 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.

package/docs/es/cli/index.md

@@ -127,6 +127,8 @@ Para ver cómo configurar los locales disponibles u otros parámetros, consulte
 
 - **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/login.md)** - Autenticarse con el CMS de Intlayer y obtener credenciales de acceso
 
+> `intlayer login` emite una **clave de acceso** (`clientId` / `clientSecret`) que utiliza cada comando con credenciales. El secreto es una credencial del lado del servidor y nunca llega a tu paquete cliente — consulta [Keeping the access key safe](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/login.md#keeping-the-access-key-safe).
+
 ### Comandos principales
 
 - **[Build de diccionarios](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/build.md)** - Construya sus diccionarios a partir de archivos de declaración de contenido

package/docs/es/cli/list_projects.md

@@ -52,8 +52,6 @@ Este comando busca y lista todos los proyectos de Intlayer encontrando directori
 
   > Ejemplo: `npx intlayer projects list --base-dir /path/to/workspace`
 
-  > Ejemplo: `npx intlayer projects list --base-dir /path/to/workspace`
-
 - **`--git-root`**: Buscar desde el directorio raíz de git en lugar del directorio base. Esto es útil para encontrar todos los proyectos de Intlayer en un monorepo o repositorio git.
 
   > Ejemplo: `npx intlayer projects list --git-root`

package/docs/es/cli/login.md

@@ -118,6 +118,34 @@ INTLAYER_CLIENT_SECRET=your_client_secret
 }
 ```
 
+## Mantener la clave de acceso segura
+
+`intlayer login` emite una **clave de acceso**: un par `clientId` / `clientSecret` que cada comando autenticado (`push`, `pull`, `fill`, `configuration push`, `live`, …) utiliza para autenticarse.
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+  },
+};
+
+export default config;
+```
+
+> **`clientSecret` es una credencial del lado del servidor.** Otorga acceso completo a la API con alcance de proyecto — lectura y escritura de tus diccionarios, tu proyecto y tu organización. Mantenlo en `.env` (ignorado por git) o en tu almacén de secretos de CI, y nunca lo incluyas en línea en el archivo de configuración.
+
+Intlayer lo impone en lugar de solo documentarlo:
+
+- `clientSecret` es **eliminado de la configuración que tu bundler incluye**, por lo que no puede llegar a un bundle del navegador sin importar qué integración de framework utilices. Solo se lee del lado del servidor, en tiempo de ejecución, desde el entorno.
+- `clientId` es diferente: es la **clave pública** del proyecto, segura para distribuir, y utilizada por [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/analytics.md#how-events-are-authenticated) para obtener un token de corta duración, solo para ingesta.
+
+Comentar `clientId` es suficiente para desactivar cada comportamiento autenticado — obtención remota de diccionarios, acceso a CMS, análisis — incluso cuando las variables de entorno aún están definidas.
+
+Para pipelines de CI, prefiere el [`comando ci`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/ci.md), que inyecta las credenciales durante la duración de una única ejecución en lugar de persistirlas.
+
 ## Configuración manual
 
 Si el navegador no se abre automáticamente, puedes visitar manualmente la URL que se muestra en el terminal.
@@ -210,8 +238,6 @@ Después de completar el inicio de sesión:
    - [`npx intlayer push`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/push.md) - Enviar diccionarios al CMS
    - [`npx intlayer pull`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/pull.md) - Extraer diccionarios del CMS
 
-- [`npx intlayer fill`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/fill.md) - Rellenar traducciones faltantes
-
 ## Véase también
 
 - [Documentación del CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/index.md)

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

@@ -57,5 +57,3 @@ Bajo el capó:
 - **`useTranslations`:** Se reimplementa para devolver una función tipada que se vincula automáticamente a tus diccionarios de Intlayer.
 - **`getTranslations`:** En funciones del servidor, obtiene acceso tipado a contenido de Intlayer sin hacer solicitudes de red.
 - **Middleware:** Intlayer proporciona un middleware de routing automático que reconoce locales y gestiona redirecciones.
-
-Tu aplicación mantiene la misma estructura y sintaxis, pero ahora con el poder de Intlayer dirigiendo las traducciones.

package/docs/es/compiler.md

@@ -40,6 +40,12 @@ El **Intlayer Compiler** es una herramienta poderosa diseñada para automatizar
 
 ## ¿Por qué usar el Intlayer Compiler?
 
+- **Automatización**: Elimina la necesidad de copiar y pegar manualmente contenido en diccionarios.
+
+- **Speed**: Extracción de contenido optimizada asegurando que tu proceso de construcción siga siendo rápido.
+
+- **Developer Experience**: Mantén las declaraciones de contenido justo donde se usan, mejorando la mantenibilidad.
+
 - **Automatización**: Elimina el copiado manual de contenido en los diccionarios.
 - **Velocidad**: Extracción de contenido optimizada que asegura que tu proceso de build siga siendo rápido.
 - **Experiencia del desarrollador**: Mantén las declaraciones de contenido justo donde se usan, mejorando la mantenibilidad.
@@ -54,6 +60,8 @@ Si bien el compilador ofrece una excelente experiencia de "funciona sin más", t
 - **Ambigüedad heurística**: El compilador debe adivinar qué es contenido orientado al usuario frente a la lógica de la aplicación (por ejemplo, `className="active"`, códigos de estado, IDs de productos). En bases de código complejas, esto puede llevar a falsos positivos o cadenas omitidas que requieren anotaciones manuales y excepciones.
 - **Extracción solo estática**: La extracción basada en compilador se basa en análisis estático. Las cadenas que solo existen en runtime (códigos de error de API, campos CMS, etc.) no pueden ser descubiertas o traducidas por el compilador solo, por lo que aún necesitas una estrategia i18n de tiempo de ejecución complementaria.
 
+- **Extracción solo estática**: La extracción basada en compilador se basa en análisis estático. Las cadenas que solo existen en tiempo de ejecución (códigos de error de API, campos de CMS, etc.) no pueden ser descubiertas ni traducidas por el compilador solo, por lo que aún necesitas una estrategia complementaria de i18n en tiempo de ejecución.
+
 Para una comparación arquitectónica más profunda, consulta el artículo del blog [Compiler vs. Declarative i18n](https://github.com/aymericzip/intlayer/blob/main/docs/blog/es/compiler_vs_declarative_i18n.md).
 
 Como alternativa, para automatizar tu proceso i18n mientras mantienes el control total de tu contenido, Intlayer también proporciona un comando de auto-extracción `intlayer extract` (consulta la [documentación CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/extract.md)), o el comando `Intlayer: extract content to Dictionary` de la extensión Intlayer VS Code (consulta la [documentación de la extensión VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/vs_code_extension.md)).
@@ -94,12 +102,18 @@ export default defineConfig({
 });
 ```
 
+> El plugin `intlayerCompiler()` independiente sigue siendo exportado para configuraciones avanzadas. Registrarlo junto con `intlayer()` es seguro — el compilador se deduplica a sí mismo y se ejecuta solo una vez.
+
 See complete tutorial: [Intlayer Compiler with Vite+React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_vite+react_compiler.md)
 
 #### Soporte de Framework
 
 El plugin de Vite detecta y maneja automáticamente diferentes tipos de archivos:
 
+- **React / JSX / TSX**: Manejado nativamente.
+
+- **Vue**: Requiere `@intlayer/vue-compiler`.
+
 - **React / JSX / TSX**: Manejado de forma nativa.
 - **Vue**: Requiere `@intlayer/vue-compiler`.
 - **Svelte**: Requiere `@intlayer/svelte-compiler`.

package/docs/es/component_i18n.md

@@ -174,6 +174,8 @@ Consejo: Para metadatos de página y SEO, también puedes obtener contenido con
 - Tree-shaking: Solo se incluye el contenido usado por el componente, manteniendo cargas pequeñas en aplicaciones grandes.
 - DX y herramientas: Middleware incorporado, asistentes de SEO y traducciones opcionales mediante Editor Visual/IA agilizan el trabajo diario.
 
+Consulta las comparaciones y patrones en el resumen enfocado en Next.js: https://intlayer.org/blog/next-i18next-vs-next-intl-vs-intlayer
+
 ## Guías y referencias relacionadas
 
 - Configuración React (Vite): https://intlayer.org/doc/environment/vite-and-react
@@ -181,3 +183,5 @@ Consejo: Para metadatos de página y SEO, también puedes obtener contenido con
 - TanStack Start: https://intlayer.org/doc/environment/tanstack-start
 - Configuración Next.js: https://intlayer.org/doc/environment/nextjs
 - Por qué Intlayer vs. next-intl vs. next-i18next - https://intlayer.org/blog/next-i18next-vs-next-intl-vs-intlayer
+
+Estas páginas incluyen configuración completa, proveedores, enrutamiento y helpers de SEO.

package/docs/es/configuration.md

@@ -739,8 +739,6 @@ Define los ajustes relacionados con el editor integrado, incluido el puerto del
 | `liveSyncPort`               | Puerto del servidor de sincronización en vivo (live sync).                                                                                                                           | `number`                          | `4000`                              | `4000`                                                                                          |                                                                                                                                                                                                                                                                  |
 | `liveSyncURL`                | URL del servidor de sincronización en vivo (live sync).                                                                                                                              | `string`                          | `'http://localhost:{liveSyncPort}'` | `'https://example.com'`                                                                         | Apunta a localhost de forma predeterminada; puede cambiarse a un servidor remoto de Live Sync.                                                                                                                                                                   |
 
----
-
 ### Configuración de Analíticas (Analytics Configuration)
 
 Define los ajustes relacionados con las analíticas de Intlayer: la recopilación de qué contenido se muestra realmente a los usuarios (vistas de página, exposiciones de contenido) y el soporte de pruebas A/B sobre el contenido.
@@ -989,6 +987,13 @@ Configuración relacionada con rutas internas y resultados de salida de Intlayer
 
 ### Configuración del Diccionario (Dictionary Configuration)
 
+Configuración que controla las operaciones del diccionario, incluido el comportamiento de auto-relleno y la generación de contenido.
+
+Esta configuración de diccionario sirve dos propósitos principales:
+
+1. **Valores por defecto**: Define valores por defecto al crear archivos de declaración de contenido
+2. **Comportamiento de fallback**: Proporciona valores de fallback cuando campos específicos no están definidos, permitiéndote definir el comportamiento de operación del diccionario globalmente
+
 Parámetros que controlan las operaciones de diccionarios, incluido el comportamiento de relleno automático y la generación de contenido.
 
 | Campo                       | Descripción                                                                                                                                                           | Tipo                                                                                                            | Predeterminado | Ejemplo                                                                                     | Nota                                                                                                                                                                                                                                                                                                                                                                                                                                       |
@@ -1030,8 +1035,6 @@ Parámetros para personalizar la salida de registros (logs) de Intlayer.
 | `mode`   | Indica el modo del registrador. | `'default'` &#124; <br/> `'verbose'` &#124; <br/> `'disabled'` | `'default'`     | `'verbose'`             | • `'verbose'`: registra más información para depuración.<br/>• `'disabled'`: desactiva completamente el registrador. |
 | `prefix` | El prefijo del registrador.     | `string`                                                       | `'[intlayer] '` | `'[my custom prefix] '` |                                                                                                                      |
 
----
-
 ### Configuración de IA (AI Configuration)
 
 Ajustes que controlan las funciones de IA de Intlayer, incluidos el proveedor, el modelo y la clave API.
@@ -1071,8 +1074,6 @@ Intlayer admite múltiples proveedores de IA para una flexibilidad máxima. Los
 | `baseURL`            | La URL base para la API de IA.                                                                                                           | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                             | Ninguno        | `'https://api.openai.com/v1'` <br/> `'http://localhost:5000'` | Puede apuntar a un endpoint de API de IA local o personalizado.                                                                                                                                |
 | `dataSerialization`  | Formato de serialización de datos para las funciones de IA.                                                                              | `'json'` &#124; <br/> `'toon'`                                                                                                                                                                                                                                                                                                                                                                                                                       | `undefined`    | `'toon'`                                                      | • `'json'`: estándar, fiable; usa más tokens.<br/>• `'toon'`: menos tokens, menos consistente.<br/>• Se pasan parámetros adicionales al modelo como contexto (esfuerzo de razonamiento, etc.). |
 
----
-
 ### Configuración de Compilación (Build Configuration)
 
 Parámetros que controlan cómo Intlayer optimiza y construye la internacionalización de su aplicación.
@@ -1110,8 +1111,6 @@ Ajustes que controlan el compilador de Intlayer, que extrae diccionarios directa
 | `noMetadata`          | Si es `true`, el compilador omite los metadatos del diccionario (clave, envoltorio de contenido) de la salida.                                                                                                                                                                                                         | `boolean`                                                                                                       | `false`        | `false` → `{"key":"mi-clave","content":{"key":"valor"}}` <br/> `true` → `{"key":"valor"}`                                                                | • Útil para salidas JSON i18next o ICU MessageFormat.<br/>• Funciona bien con el plugin `loadJSON`.                                                                                                                                                                                                                                    |
 | `dictionaryKeyPrefix` | Prefijo de clave de diccionario                                                                                                                                                                                                                                                                                        | `string`                                                                                                        | `''`           |                                                                                                                                                          | Agregue un prefijo opcional para las llaves de los diccionarios extraídos                                                                                                                                                                                                                                                              |
 
----
-
 ### Esquemas Personalizados (Custom Schemas)
 
 | Campo     | Descripción                                                                       | Tipo                        |

package/docs/es/custom_domains.md

@@ -138,6 +138,38 @@ getMultilingualUrls("/about", { currentDomain: "intlayer.org" });
 
 Estas URL absolutas están listas para usarse en etiquetas `<link rel="alternate" hreflang="...">` para SEO.
 
+## Inferencia de Tipos
+
+`routing.domains` se serializa en la augmentación de módulo generada, por lo que
+`getLocalizedUrl` y `getLocalizedPath` reducen su tipo de retorno a la URL exacta
+que una locale enrutada por dominio resuelve — incluyendo la supresión de prefijo.
+
+```ts
+// routing: { mode: 'prefix-no-default', domains: { en: 'intlayer.org', zh: 'intlayer.zh' } }
+
+getLocalizedUrl("/about", "zh");
+//     ^? "https://intlayer.zh/about" | "/about"
+
+getLocalizedPath("/about", "zh");
+//     ^? "/about"   (nunca un origen, y sin prefijo /zh/)
+```
+
+El tipo de URL es la **unión** de los dos valores que la función puede retornar: la
+URL absoluta en el dominio de la locale, y la relativa que retorna cuando la
+página que se está renderizando ya vive en ese dominio. `getLocalizedPath` no tiene tal
+ambigüedad - nunca emite un origen - así que permanece como un literal único.
+
+Las locales que comparten un dominio mantienen su prefijo normal en el tipo también:
+
+```ts
+getLocalizedUrl("/about", "fr");
+//     ^? "https://intlayer.org/fr/about" | "/fr/about"
+```
+
+> Regenera los tipos (`npx intlayer build`, o cualquier ejecución del servidor de desarrollo) después de
+> cambiar `routing.domains` - la reducción proviene del
+> `__RoutingRegistry` generado, no del archivo de configuración mismo.
+
 ## Comportamiento del Proxy
 
 ### Next.js
@@ -170,6 +202,8 @@ GET intlayer.zh/about
 
 El complemento Vite `intlayerProxy` aplica la misma lógica durante el desarrollo:
 
+> Desde Intlayer v9, `intlayerProxy()` está incluido directamente en el plugin `intlayer()` y habilitado por defecto a través de la opción `routing.enableProxy` (`true` por defecto). Registrarlo por separado como se muestra a continuación ahora es opcional — se mantiene por compatibilidad hacia atrás y para configuraciones que necesitan controlar el orden de los plugins. Establece `routing.enableProxy: false` para optar por no participar. Consulta las [notas de la versión v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/releases/v9.md).
+
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
 import { intlayer } from "vite-intlayer";

package/docs/es/custom_url_rewrites.md

@@ -248,7 +248,7 @@ Para asegurarse de que la barra de direcciones del navegador siempre refleje la
 
 <Tabs group='framework'>
   <Tab label="Next.js" value="nextjs">
-  
+
     ```tsx
     'use client';
 
@@ -263,7 +263,7 @@ Para asegurarse de que la barra de direcciones del navegador siempre refleje la
   </Tab>
 
   <Tab label="React Router" value="reactrouter">
-  
+
     ```tsx
     'use client';
 
@@ -279,7 +279,7 @@ Para asegurarse de que la barra de direcciones del navegador siempre refleje la
   </Tab>
 
   <Tab label="Vue" value="vue">
-  
+
     ```vue
     <script setup>
     import { useRewriteURL } from "vue-intlayer";
@@ -291,7 +291,7 @@ Para asegurarse de que la barra de direcciones del navegador siempre refleje la
 
   </Tab>
   <Tab label="Solid" value="solid">
-  
+
     ```tsx
     import { useRewriteURL } from "solid-intlayer";
 
@@ -303,7 +303,7 @@ Para asegurarse de que la barra de direcciones del navegador siempre refleje la
 
   </Tab>
   <Tab label="Svelte" value="svelte">
-  
+
     ```svelte
     <script>
     import { useRewriteURL } from "svelte-intlayer";
@@ -340,6 +340,8 @@ export function middleware(request: NextRequest) {
 
 Para SolidJS, Vue y Svelte, el plugin de Vite `intlayerProxy` gestiona las reescrituras durante el desarrollo.
 
+> Desde Intlayer v9, `intlayerProxy()` está integrado directamente en el plugin `intlayer()` y habilitado por defecto a través de la opción `routing.enableProxy` (`true` por defecto). Registrarlo por separado como se muestra a continuación es ahora opcional — se mantiene para compatibilidad hacia atrás y para configuraciones que necesitan controlar el orden de los plugins. Establece `routing.enableProxy: false` para desactivarlo. Consulta las [notas de la versión v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/releases/v9.md).
+
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
 import { intlayer } from "vite-intlayer";